14 KiB
План: дожать перевод инструментов в preview и переезд ветки old/
Статус: переведено всё простое, осталось 23 спец-случая. Основа —
plan-composite-params.md(Фазы 1–5). Текущее состояние: 101 инструмент из 125 переведены вregistry-new(включая ранее переведённые 40; из оставшихся 85 перенесены 62 простых), старый UI уже живёт на(old)/-маршрутах, линтер-изоляция old↔preview на месте (плагинisolation/no-mixed-imports). Здесь — что сделать, чтобы:
- в preview был весь каталог инструментов (плюс закрыты известные долги);
- физически перенести старую ветку в папки
old/(шаг 37 основного плана);- после переезда провести детальную проверку в реальных условиях и собрать отзывы пользователей (правки поверх — отдельными задачами).
Порядок: перевод остатка → починить известные долги → переезд в
old/→ пользовательская проверка/фидбек → (позже, отдельным решением) удаление старого кода.
Текущая картина (факты)
registry.ts+registry/— 125 инструментов;registry-new/— 101; остаток — 23 спец-случая. (Ранний подсчёт «104» был занижен: извлечение суффиксом-pngтеряло каналыpng-to-hsl/…, текстовые вердиктыpng-infoи т.п. и обратные конвертерыpng-to-base64/….)- Preview (
/preview) показывает переведённые 101; старый UI работает на/-маршрутах (группа(old)/):+page,demo,list-tools,tools/[id]. Все «простые» инструменты переведены (color 18, filters 3, geometry 13, alpha 13, generate 8, analyze-маски 6, text 1). - Плагин
isolation/no-mixed-imports(web/eslint-plugins/isolation/) полностью разделяет ветки: старыйlib/registry.ts|/registry/**,lib/registry-helpers.ts,lib/categories.ts,lib/tools/**,lib/components/**(кромеkit/) vs новыйroutes/preview/**,lib/registry-new/**,lib/preview/**,lib/registry-schema.ts,lib/components/kit/**. Общее:core/,i18n/,theme,assets/, корневойlib. - Правило копий (из основного плана): файл, используемый
(old), не трогаем — делаем копию вlib/preview/(пример:lib/preview/tool-icons.ts). - Известные долги (предсуществующие, не создавались нами): ошибка
ToolCard.svelte:19:36(svelte-check), фейлpalette.test.ts(ENOENTsrc/app.css— из-за негоpnpm testкрасный при 607 passed), ~335 design-tokens ошибокlint:allв старых kit-компонентах, a11y-warning вColorField.svelte, пустой ruleset вToggle.svelte, неиспользуемые токены вpreview.css.
Скоуп перевода: осталось 23 особых случая
Все инструменты без специальных фич переведены (суммарно 62 простых из 85, плюс ранее переведённые 40). Остаток — 23 инструмента, требующих достройки фундамента preview. По категориям:
- alpha — 1:
watermark-image-png. - analyze — 6: text-вердикты
png-info,png-is-grayscale,png-file-size,png-is-transparent,png-orientation,verify-is-png. - generate — 2:
mix-colors-png,sort-colors-png(списки значений). - convert — 14: text-source-конвертеры
base64/data-uri/hex/bytes/rgb-values-to-png+ обратныеpng-to-base64/…; output/форматcompress-png,reduce-to-size-png,png-to-bmp;svg-to-png(text-source + DOM).
Особые случаи (требуют достройки фундамента, не просто перевод)
watermark-image-png— нужна overlay-механика: второе изображение-знак (getOverlay/store), которое загружается на странице инструмента и применяется поверх. В новом preview это единственный непереведённый инструмент с источником-картинкой помимо основного входа. Учесть связь сoverlay-store(упомянут вplan-redesign.md).- Text-source / text-вердикты (вход:
base64/data-uri/hex/bytes/ rgb-values-to-png,svg-to-png; выход-вердикт:png-to-base64/…, аналитическиеpng-info,png-is-grayscale,png-file-size,png-is-transparent,png-orientation,verify-is-png) — типToolEntryуже имеетtoText/textToText/runFromText, но executor превью их не вызывает (толькоrun/generate). Нужно решить, как подаётся текст-вход (текстовое поле/паста на странице инструмента) и как показывается результат для вердиктных инструментов (в конверсиях — не картинка, а текст/бейдж), и протащить эти поля через executor/UI. - Output/формат (
compress-png,reduce-to-size-png,png-to-bmp; пересекается сconvert-png-to-jpg/webp) — поbacklog.md№7 формат переезжает в кнопку Download, а не в отдельный инструмент. Перед переводом решить: переводим как инструменты с quality-параметром или дожидаемся достройки download-формата. mix-colors/sort-colors— нужен список значений (цвета/веса или источник). В схеме нет list-kind: либо новый kind, либо фиксированное число слотов, либо отложить до отдельной задачи про списки.
Известные долги перед переездом (завести tasks и закрыть)
По AGENTS.md техдолг «чинится только по заведённым tasks, не игнорируется»:
lint:all (~335 design-tokens в kit), неиспользуемые токены preview.css,
a11y ColorField, пустой ruleset Toggle. Плюс два, мешающих зелёной
проверке до/после переезда: svelte-check error ToolCard.svelte:19:36 и фейл
palette.test.ts (ENOENT src/app.css). После их закрытия целевое состояние
проверок перед переездом: pnpm --dir web exec svelte-check → 0 errors,
pnpm --dir web test → зелёный, pnpm --dir web lint:all → только задокумент.
ированный остаток (или 0).
Шаги перевода остатка (порядок)
- Простые пачки — выполнено: color (18) → filters (3) → geometry (13)
→ alpha (13/14, кроме watermark-image) → generate (8/10) → analyze-маски
(6/12) → text
watermark-tile-png. Каждая пачка после себя гнала гейты (eslint/svelte-check/тесты/prettier); в тестах только предсуществующий фейлpalette.test.ts. - Особые случаи — отдельным переговоренным решением (overlay для
watermark-image, text-source/вердикты — через
toText/runFromTextв executor, output-формат, списки для mix/sort). Это единственный реальный объём для дожатия каталога. - После категории —
schema.layoutдля сгруппированных инструментов (шаг 32-33 паттерн) и ручная проверка в/preview.
Переезд в old/ (шаг 37 основного плана)
Скоп-сдвиг: «Scoped-пути двигаются вместе с папками» — обновляется
eslint.config.js(isolation-паттерны и design-tokens glob), не код правила.
- Что переезжает:
lib/registry.ts,lib/registry/**,lib/registry-helpers.ts,lib/categories.ts,lib/tools/**,lib/components/**(кромеkit/) → папкиold/(напримерlib/old/registry …,lib/old/tools,lib/old/components) — то есть всё старое в одном поддереве.routes/(old)/остаётся как есть (уже отделено). - Обновить конфиг плагина
isolation/no-mixed-imports: старые glob-ыlib/registry/**…заменить наlib/old/**(+lib/old/components/**и т.п.), «новое» и «общее» не меняются. Проверить, что правило по-прежнему разделяет (тест фолс-позитивов: временный импорт old↔new ловится). - Импорты внутри старого кода — относительные пути остаются рабочими
(папки двигаются целиком); поправить только то, что ссылалось на
$lib/...в другом стиле. Старые тесты (registry.test.tsи др.) переезжают вместе с исходниками и продолжают проходить. - Гейты переезда:
svelte-check0 errors,pnpm --dir web testзелёный,prettier --check .чистый,lint:all= задокументированный остаток, обе ветки открываются (старая/, новая/preview).
Проверка и сбор отзывов после переезда
- Регресс-чеклист по каталогу — пройти все инструменты в
/preview: дефолты совпадают со старыми, валидация/клампы поведения не меняют, результат эквивалентен старому UI (сверить на одинаковых входах). - Тяжёлые кейсы руками: генераторы, маски, font-style/plate/gradient на всем наборе, watermark-image (после overlay), text-source, output-формат.
- Сбор фидбека — отдельные задачи на каждый найденный фикс; чеклист зафиксировать в этом документе по мере находок (или ссылкой на tasks).
- Сверка каталога с
tools-map.md(покрытие/дедупликацияconvert-png-to-jpg/webp), при необходимости — обновить cards/мета. - Решение об удалении старого — после завершения ревью и фидбека,
отдельным шагом: тогда чистятся
lib/old/**,routes/(old)/**,old.css,exports, изоляционный плагин (glob-ы больше не нужны) и открываются «правило копий»-дубли.
Как ревьюить каждый шаг (гайды)
- Диф на один инструмент (или фундамент без инструментов) < ~500 строк.
- Старый
params/run/defaultParams/sanitizeParamsне изменены; вregistry-newкопия логики +schema(дефолты равны старым). - Старый UI и старые тесты продолжают работать:
pnpm --dir web test,pnpm --dir web exec svelte-check. - Новый инструмент проверяется руками в
/previewend-to-end (применение + сброс дефолтов + смена значений). - После переезда каждый move-шаг гоняет 4 гейта (см. выше).
Оценка трудозатрат
| Часть | Сложность | Оценка |
|---|---|---|
| Простые инструменты (color/filters/geometry/alpha/generate/маски/text) | Низкая-Средняя | выполнено (62 шт) |
| Особые случаи (overlay/text-source/format/списки) | Средняя-Высокая | ~4-6ч + ревью решения |
| Долги (ToolCard, palette.test.ts, lint:all остаток) | Средняя | ~2-4ч |
Переезд в old/ + конфиг плагина + гейты |
Средняя-Низкая | ~2-4ч |
| Проверка/фидбек + правки | Зависит | ~3-6ч |
| Итого | ~11-20ч по фазам |
Оценки ориентировочные; особые случаи — с ревью решения, объём финальных правок по фидбеку не предсказуем.