[agentHits]

Зачем

@stepperize/react рисует пошаговые мастера панели. Форк отставал на четыре мажорные версии: 4.0.1 против 8.0.1. Мастеров три:

• онбординг нового пользователя (components/dashboard/onboarding/onboarding-wizard.tsx);
• генератор шаблонов через ИИ (components/dashboard/project/ai/template-generator.tsx);
• экран подписки облачной версии (components/dashboard/settings/servers/welcome-stripe/welcome-subscription.tsx).

Что изменилось

• @stepperize/react 4.0.1 → 8.0.1 в apps/dokploy/package.json и bun.lock. Версия остаётся точной, потому что пакет в списке удерживаемых в CLAUDE.md.
• Код трёх мастеров переписан под API v8, по официальным руководствам миграции:
  • defineStepper(a, b, c) → defineStepper([a, b, c]);
  • Scoped убран. В v8 его место занял Provider, но во всех трёх файлах экземпляр мастера создаётся вне обёртки и внутри никто не вызывает useStepper, так что обёртка ничего не делала. Заменена фрагментом;
  • stepper.switch → stepper.match. В v8 он требует обработчик для каждого шага, все шаги уже описаны;
  • stepper.all → stepper.steps, stepper.current.index → stepper.index;
  • useStepper(initialStep) → useStepper({ defaultStep }). Это касается возврата онбординга на сохранённый шаг.
• next, prev и goTo теперь возвращают Promise. Режим linear по умолчанию выключен, поэтому онбординг на self-hosted по-прежнему перепрыгивает скрытые шаги «Pick a plan» и «Connect server».

Проверки

Linux, Bun 1.4.4, Node 26.13.0:

• bun install, bun audit --audit-level=moderate, biome check по трём файлам, bun run server:build и bun run typecheck проходят. Typecheck — главная проверка: старые вызовы в v8 не компилируются.
• Unit-тесты: 6128 прошли, 1 упал (backup-files под нагрузкой; так же падает на базовой ветке).

Что проверить вручную на dev

• Онбординг: шаги переключаются вперёд и назад, кнопки «Skip» работают.
• AI Assistant в проекте: шаги «Describe your needs → Choose a Variant → Review», счётчик «Step N of 3», кнопки Back и Next.

🤖 Generated with Claude Code