TL;DR

Storybook now supports a new, schema-driven service runtime via the Open Service API, enabling more flexible and powerful integrations with external tools and services.

New

• Open Service API: A new schema-driven service runtime is available, allowing for more robust integrations.
• Improved ArgsTable: The ArgsTable now provides better guidance when no arguments are present.
• React Boolean Props: Boolean props set to false are now correctly rendered in source code snippets.

Fixes Worth Knowing

• Windows users can now use non-Node package managers with Storybook.
• Storybook respects the BROWSER and BROWSER_ARGS environment variables when launching the browser.
• Fixed an issue preventing some Vue components from initializing correctly.
• Improved accessibility of the ActionBar in high contrast mode.

Before You Upgrade

If you are using the Vitest addon, ensure you are on Vitest version 3 or later.

TL;DR

Storybook now correctly handles component story format (CSF) exports with string literal names, resolving issues when developing with certain module bundlers.

Fixes Worth Knowing

• Windows users with non-Node package managers (like pnpm or yarn) will find command resolution is now more reliable.
• Component story format parsing is improved, fixing errors with specific export naming conventions.

TL;DR

Storybook now validates requests, improving stability and providing clearer error messages when invalid configurations are used.

Fixes Worth Knowing

• Improved error messaging for invalid Storybook configurations, making debugging easier.

Before You Upgrade

• Review your Storybook configuration to ensure it adheres to the latest schema for optimal performance.

TL;DR

Storybook now validates requests, improving stability and providing clearer error messages when invalid configurations are used.

Fixes Worth Knowing

• Resolved an issue where Storybook could crash with invalid addon configurations.
• Improved error messaging for configuration problems, making debugging easier.

TL;DR

Storybook now validates requests, improving stability and providing clearer error messages when invalid configurations are used.

Fixes Worth Knowing

• Resolved an issue where Storybook could crash with invalid addon configurations.
• Improved error messaging for invalid Storybook configurations (configuration files).

Package: storybook Release:

--- v9.1.19 (2024-02-29) ---

9.1.19

• Fix: Fixes crash when addon has invalid configuration
• Fix: Improve error message when config is invalid

Package: storybook Release:

--- v9.1.18 (2024-02-22) ---

9.1.18

• Fix: Fixes crash when addon has invalid configuration

Package: storybook Release:

--- v9.1.17 (2024-02-15) ---

9.1.17

• Fix: Fixes crash when addon has invalid configuration

TL;DR

Storybook now mocks the useRouter hook in Next.js (web framework), preventing issues when Storybook’s environment differs from a live Next.js app.

Fixes Worth Knowing

• Angular projects should now build correctly, resolving an error related to polyfills (compatibility layers).
• Addon Docs now correctly displays symbols in both the documentation page and the controls panel.
• Preview file transformations are more robust, preventing errors during story rendering.

TL;DR

Storybook’s CLI now prompts users to select React Native (RN) or React Native Web (RNW) during initialization, improving the setup experience for new projects.

Breaking

• Codemod Updates: Codemod migrations now handle addon essentials and CSF (Component Story Format) factories differently, and migrate meta.args to meta.input.args. This may require review of any custom codemods.

New

• Improved CLI Feature Selection: The CLI now offers a clearer prompt for selecting features during initialization, and correctly handles the --yes and --features flags.
• Vite Builder Fix: A fix resolves runtime and iframe 404 errors when using the Vite builder, ensuring stories load correctly on the first attempt.

Fixes Worth Knowing

• Angular Compatibility: Improved support for Angular projects, including compatibility with v19.2 even without @angular/animations installed.
• Panel Reactivity: Fixed an issue causing panels in the Storybook UI to not update reliably.
• Addon Test Improvements: Several fixes improve the reliability of the addon-test, including console errors and workspace configuration.

TL;DR

Storybook gains experimental support for Next.js SWC (Swift Compiler) and SvelteKit page/navigation mocking, potentially improving build and development speeds for those frameworks.

Breaking

• Vite + CommonJS: Support is being deprecated; projects using this combination should plan to migrate. (Configuration setting)

New

• Next.js SWC Support: (Fast compiler) Experimental support for using SWC with Next.js projects.
• SvelteKit Mocking: (Testing feature) Experimental support for mocking pages and navigation in SvelteKit stories.
• doctor CLI Command: (Troubleshooting tool) A new command to help diagnose common Storybook configuration issues.

Fixes Worth Knowing

• HMR with Webpack5: Fixed a circular dependency issue causing Hot Module Replacement (HMR) to fail.
• Svelte Decorators: Decorators in Svelte stories now run only once, resolving a performance issue.
• Manager API: Corrected a crash when setting status without an index.

Before You Upgrade

• If using Vite with CommonJS, begin planning a migration to ES modules.

TL;DR

Storybook now fully supports TypeScript 5.0, ensuring compatibility for projects upgrading to the latest TypeScript version.

Fixes Worth Knowing

• TypeScript 5.0 compatibility is restored, resolving issues for users upgrading their TypeScript versions. (TypeScript: a JavaScript extension)

TL;DR

Storybook now correctly handles docsMode for Angular projects and includes a security update to the json5 dependency.

Fixes Worth Knowing

• Angular: Resolved an issue with the docsMode option in the Angular builder.
• Angular: Corrected type definitions for webpackStatsJson when using the Angular builder (Webpack is a module bundler).
• Security: Updated the json5 dependency to address a security vulnerability.

TL;DR

Storybook now displays colors correctly after updating a dependency that fixes a bug with the colors.js library (a color manipulation tool).

Fixes Worth Knowing

• Color display issues in the Storybook UI are resolved.

TL;DR

Storybook now handles complex component structures and navigation more reliably, particularly when using component story format (CSF) and the addon-docs package, improving the developer experience for larger projects.

Fixes Worth Knowing

• Fixed a bug where addon-docs links could fail due to CORS errors.
• HMR (Hot Module Replacement) now works correctly for global decorators defined in main.js.
• Improved navigation in addon-docs when stories have a mix of leaf and non-leaf nodes.
• Scroll behavior in addon-docs has been improved during page navigation.

Before You Upgrade

If you’re using axe-storyshots, update your dependencies to use @wordpress/jest-puppeteer-axe directly. (Accessibility testing tool)