mirror of
https://github.com/gromlab-ru/svg-sprites.git
synced 2026-07-22 04:40:17 +03:00
- добавлены синхронные английские и русские инструкции для агентов - расширена сборка документов из Markdown-фрагментов - артефакты перенесены в игнорируемый release output - обновлены README и проверки скиллов
2.8 KiB
2.8 KiB
Инспекция проекта
До изменений установи фактический контракт проекта:
- Прочитай корневой
package.json, lock-файл и workspace-конфигурацию; определи framework, bundler и существующие команды. - Найди
svg-sprite.config.ts,svg-sprites.config.ts, командыsvg-spritesи импорты generated-компонентов. - Для React определи Vite или Webpack 5 по scripts и конфигу. Для Next.js отдельно определи App/Pages Router и сборщик реальных
dev/buildкоманд. - Проверь существующие
predev,prebuild,pretypecheckи агрегирующие scripts. Не перезаписывай их. - Для нового спрайта выбери целевой каталог, не навязывая конкретный слой или архитектуру приложения.
- Проверь TypeScript и alias-настройки. Для package subpath exports нужен TypeScript 5+ с
moduleResolution: 'bundler','node16'или'nodenext'.
Все пути современного конфига считаются относительно каталога, содержащего svg-sprite.config.ts:
inputFolderпо умолчанию равен./icons;inputFilesсодержит дополнительные относительные пути к отдельным SVG и объединяется сinputFolder;- одинаковый абсолютный файл дедуплицируется, но разные файлы с одинаковым basename иконки вызывают ошибку;
- сканирование
inputFolderплоское: читаются только непосредственные файлы с окончанием.svg, вложенные каталоги не обходятся; - отсутствующая явно заданная
inputFolderявляется ошибкой; - если
inputFolderне задана,./iconsотсутствует, аinputFilesнепустой, генерация работает только поinputFiles; - пустой итоговый набор, отсутствующий файл или путь не к
.svgявляется ошибкой.
Не копируй общий SVG в несколько папок: добавь его относительный путь в inputFiles каждого нужного спрайта. Если требуется рекурсивная структура, перечисли файлы явно или измени структуру источников; генератор не выполняет recursive scan.