Files
easy-png-tools/docs/plan-migrate-remaining.md
T

14 KiB
Raw Blame History

План: дожать перевод инструментов в preview и переезд ветки old/

Статус: переведено всё простое, осталось 23 спец-случая. Основа — plan-composite-params.md (Фазы 1–5). Текущее состояние: 101 инструмент из 125 переведены в registry-new (включая ранее переведённые 40; из оставшихся 85 перенесены 62 простых), старый UI уже живёт на (old)/-маршрутах, линтер-изоляция old↔preview на месте (плагин isolation/no-mixed-imports). Здесь — что сделать, чтобы:

  1. в preview был весь каталог инструментов (плюс закрыты известные долги);
  2. физически перенести старую ветку в папки old/ (шаг 37 основного плана);
  3. после переезда провести детальную проверку в реальных условиях и собрать отзывы пользователей (правки поверх — отдельными задачами).

Порядок: перевод остатка → починить известные долги → переезд в 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 (ENOENT src/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).

Особые случаи (требуют достройки фундамента, не просто перевод)

  1. watermark-image-png — нужна overlay-механика: второе изображение-знак (getOverlay/store), которое загружается на странице инструмента и применяется поверх. В новом preview это единственный непереведённый инструмент с источником-картинкой помимо основного входа. Учесть связь с overlay-store (упомянут в plan-redesign.md).
  2. 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.
  3. Output/формат (compress-png, reduce-to-size-png, png-to-bmp; пересекается с convert-png-to-jpg/webp) — по backlog.md №7 формат переезжает в кнопку Download, а не в отдельный инструмент. Перед переводом решить: переводим как инструменты с quality-параметром или дожидаемся достройки download-формата.
  4. 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).

Шаги перевода остатка (порядок)

  1. Простые пачкивыполнено: 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.
  2. Особые случаи — отдельным переговоренным решением (overlay для watermark-image, text-source/вердикты — через toText/runFromText в executor, output-формат, списки для mix/sort). Это единственный реальный объём для дожатия каталога.
  3. После категории — schema.layout для сгруппированных инструментов (шаг 32-33 паттерн) и ручная проверка в /preview.

Переезд в old/ (шаг 37 основного плана)

Скоп-сдвиг: «Scoped-пути двигаются вместе с папками» — обновляется eslint.config.js (isolation-паттерны и design-tokens glob), не код правила.

  1. Что переезжает: 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)/ остаётся как есть (уже отделено).
  2. Обновить конфиг плагина isolation/no-mixed-imports: старые glob-ы lib/registry/**… заменить на lib/old/** (+ lib/old/components/** и т.п.), «новое» и «общее» не меняются. Проверить, что правило по-прежнему разделяет (тест фолс-позитивов: временный импорт old↔new ловится).
  3. Импорты внутри старого кода — относительные пути остаются рабочими (папки двигаются целиком); поправить только то, что ссылалось на $lib/... в другом стиле. Старые тесты (registry.test.ts и др.) переезжают вместе с исходниками и продолжают проходить.
  4. Гейты переезда: svelte-check 0 errors, pnpm --dir web test зелёный, prettier --check . чистый, lint:all = задокументированный остаток, обе ветки открываются (старая /, новая /preview).

Проверка и сбор отзывов после переезда

  1. Регресс-чеклист по каталогу — пройти все инструменты в /preview: дефолты совпадают со старыми, валидация/клампы поведения не меняют, результат эквивалентен старому UI (сверить на одинаковых входах).
  2. Тяжёлые кейсы руками: генераторы, маски, font-style/plate/gradient на всем наборе, watermark-image (после overlay), text-source, output-формат.
  3. Сбор фидбека — отдельные задачи на каждый найденный фикс; чеклист зафиксировать в этом документе по мере находок (или ссылкой на tasks).
  4. Сверка каталога с tools-map.md (покрытие/дедупликация convert-png-to-jpg/webp), при необходимости — обновить cards/мета.
  5. Решение об удалении старого — после завершения ревью и фидбека, отдельным шагом: тогда чистятся 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.
  • Новый инструмент проверяется руками в /preview end-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ч по фазам

Оценки ориентировочные; особые случаи — с ревью решения, объём финальных правок по фидбеку не предсказуем.