setup-use-import-maps — правило для Claude Code
Правило setup-use-import-maps требует подключать Three.js через import map с модулями и точной версией, а не старым тегом <script src> с CDN.
MIT ★ 4 719 обновлён 2026-10-24
.claude/rules/setup-use-import-maps.mdЧто делает setup-use-import-maps
Правило про то, как Three.js попадает на страницу. Вместо тега <script src> с CDN-ссылкой на three.min.js нужен блок <script type="importmap">: в нём three ведёт на three.module.js, а префикс three/addons/ — на каталог examples/jsm/. Дальше код живёт в <script type="module">, и OrbitControls приходит из three/addons/controls/OrbitControls.js.
Что не так со старым паттерном: глобальная THREE засоряет пространство имён, сборщик не выкидывает неиспользуемый код, версии конфликтуют, разрешение модулей ломается. Лечится одной картой с точной версией, в примерах это [email protected].
Для WebGPU в правиле отдельная карта: three указывает на three.webgpu.js, появляется псевдоним three/tsl для three.tsl.js, three/addons/ остаётся на месте. Если проект уже грузит глобальный THREE из r128, подключение придётся переписать целиком — иначе конфликт версий никуда не денется.
Какие задачи решает
- перевести проект с глобального
THREEна ES-модули - зафиксировать версию Three.js в одном месте
- подключить
OrbitControlsбез копирования файлов изexamples/jsm/ - понять, почему сборщик не выкидывает неиспользуемый код
- собрать карту импортов под WebGPU-рендер
Примеры запросов агенту
- Перепиши подключение Three.js на import map:
threeизthree.module.js, аддоны изexamples/jsm/. - Замени тег
<script src>сthree.min.jsна<script type="importmap">и модульные импорты. - Добавь в карту импортов
three/tslдля WebGPU-сборки.
Как установить setup-use-import-maps
Вручную: положить файлы
.claude/rules/setup-use-import-maps.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/setup-use-import-maps.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/setup-use-import-maps.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/setup-use-import-maps.mdВручную: положить файлы
.clinerules/setup-use-import-maps.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о setup-use-import-maps
Как установить setup-use-import-maps в Claude Code?
Файл правила кладут по пути .claude/rules/setup-use-import-maps.md. Внутри markdown с примерами плохого и хорошего подключения, отдельных команд установки нет.
Что делает setup-use-import-maps?
Заменяет устаревшее подключение Three.js тегом <script src> на import map с модулями и фиксированной версией.
Чем плох старый CDN-паттерн?
Такой тег создаёт глобальную THREE, мешает tree shaking и ломает разрешение модулей. При двух версиях на странице начинаются конфликты.
Исходный текст
setup-use-import-maps.md · MIT
# setup-use-import-maps
**Use Import Maps instead of old CDN script tags.**
## Why It Matters
The old CDN pattern (`<script src="...three.min.js">`) is outdated and causes:
- Module resolution issues
- No tree shaking
- Global namespace pollution
- Version conflicts
## Bad Example
```html
<!-- WRONG - Outdated pattern (DO NOT USE) -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/three.js/r128/three.min.js"></script>
<script>
// THREE is global, no modules
const scene = new THREE.Scene();
</script>
```
## Good Example
```html
<!-- CORRECT - Modern Import Maps pattern -->
<script type="importmap">
{
"imports": {
"three": "https://cdn.jsdelivr.net/npm/[email protected]/build/three.module.js",
"three/addons/": "https://cdn.jsdelivr.net/npm/[email protected]/examples/jsm/"
}
}
</script>
<script type="module">
import * as THREE from 'three';
import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
const scene = new THREE.Scene();
</script>
```
## WebGPU Import Map
```html
<script type="importmap">
{
"imports": {
"three": "https://cdn.jsdelivr.net/npm/[email protected]/build/three.webgpu.js",
"three/tsl": "https://cdn.jsdelivr.net/npm/[email protected]/build/three.tsl.js",
"three/addons/": "https://cdn.jsdelivr.net/npm/[email protected]/examples/jsm/"
}
}
</script>
```
## References
- [Three.js Installation Guide](https://threejs.org/manual/#en/installation)
- [MDN Import Maps](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script/type/importmap)
© zebbern · MIT · zebbern/claude-code-guide