mirror of
https://github.com/gromlab-ru/svg-sprites.git
synced 2026-07-22 04:40:17 +03:00
- добавлены синхронные английские и русские инструкции для агентов - расширена сборка документов из Markdown-фрагментов - артефакты перенесены в игнорируемый release output - обновлены README и проверки скиллов
2.1 KiB
2.1 KiB
Выбор режима
Выбери ровно один поддерживаемый mode key:
| Проект | Mode key |
|---|---|
| React + Vite | react@vite |
| React + Webpack 5 | react@webpack |
| Next.js App Router + Turbopack | next@app/turbopack |
| Next.js App Router + Webpack 5 | next@app/webpack |
| Next.js Pages Router + Turbopack | next@pages/turbopack |
| Next.js Pages Router + Webpack 5 | next@pages/webpack |
| Старый общий конфиг | legacy |
Не используй неполные react, next@app, next@pages, будущий standalone или mode другого сборщика. CLI всегда требует mode и ровно один путь к каталогу конфигурации:
npx --yes @gromlab/svg-sprites@latest --mode <mode-key> <sprite-directory>
Не передавай несколько путей, glob или путь к самому файлу конфигурации. Для нескольких современных спрайтов создай отдельную команду для каждого каталога.
Определяй legacy по контракту, а не по количеству спрайтов:
svg-sprites.config.tsв переданном корне с верхнеуровневымиoutputи непустым массивомspritesявляется legacy-конфигурацией даже при одном элементе;- каждый legacy-элемент использует
name,inputи необязательныйformat: 'stack' | 'symbol'; полеmodeустарело; - локальный
svg-sprite.config.tsв каталоге одного спрайта сname,description,inputFolder,inputFiles,transformиgeneratedNoticeотносится к React/Next API даже если таких спрайтов в приложении много.
Не мигрируй legacy-конфигурацию без явного запроса. Не смешивай defineLegacyConfig и поля output/sprites с defineReactSpriteConfig или defineNextSpriteConfig.