Skip to content

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

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 показал, что обновление требует миграции конфигов и зависимостей, а не только поднятия версий.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions