Skip to content

Обновить зависимости Storybook #617

@Amiditin

Description

@Amiditin

С чем связан запрос на фичу?

Storybook-окружение Hyperion нужно актуализировать до текущего поддерживаемого стека и сделать воспроизводимым из чистого окружения, управляемого репозиторием.

На момент диагностики 2026-06-17 целевой стек:

  • Node.js 26.3.0
  • Storybook 10.4.6

Цель задачи — не закрепиться на Node.js 22 и не чинить один локальный запуск, а привести design-стенды к актуальному Storybook/Node.js-контуру.

Расскажите как вы это себе видите

  • Обновить Storybook-окружение design-стендов Hyperion: ui/design, ui-parts/design, ui-admin/design.
  • Обновить связанные пакеты Storybook: @storybook/react, @storybook/react-webpack5, @storybook/addon-links, @storybook/addon-webpack5-compiler-swc, @storybook/addon-styling-webpack, @chromatic-com/storybook.
  • Заменить устаревший MDX-контур @storybook/blocks / @storybook/addon-essentials на актуальный @storybook/addon-docs там, где пакеты реально поставляют .mdx stories.
  • Согласовать пакеты, которые поставляют stories/MDX в общий design-стенд, чтобы не получить смешанный граф Storybook 8/10.
  • Убрать глобальный rewrite импортов через NormalModuleReplacementPlugin(/\.js$/), потому что он переписывает внешние package exports; для локальных .js -> .ts/.tsx ESM-импортов использовать нормальный webpack resolve.
  • Закрыть PnP-несовместимости зависимостей штатно, без расчёта на локальный кэш. Подтверждённый пример: swiper/React-контур.
  • Сохранить исходную цель задачи: добавить примеры интерактивных тестов для нескольких компонентов, если это остаётся применимо после обновления Storybook.

Критерии готовности выполнения задачи

  • yarn install --immutable проходит на актуальной Node.js.
  • yarn workspace @atls-ui-parts/design build проходит.
  • yarn workspace @atls-ui/design build проходит.
  • yarn workspace @atls-ui-admin/design build проходит.
  • Storybook можно поднять из чистого окружения без локального кэша и частных обходов.
  • Для PR, затрагивающих frontend stories, можно приложить воспроизводимый медиапруф с явной командой запуска Storybook.
  • Тесты проходят.

Материалы

  • https://storybook.js.org/blog/storybook-9/
  • Диагностический прогон на Node.js 26.3.0 и Storybook 10.4.6 показал, что обновление требует миграции конфигов и зависимостей, а не только поднятия версий.

Metadata

Metadata

Assignees

Labels

No fields configured for Feature.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions