@storybook/addon-toolbars

@storybook/addon-toolbars is a deprecated migration package that exists solely to provide error messages directing users away from this obsolete addon. The functionality was consolidated into Storybook's core package in version 9.0 and above.

Package Information

• Package Name: @storybook/addon-toolbars
• Package Type: npm
• Language: TypeScript
• Installation: npm install @storybook/addon-toolbars (not recommended)
• Status: Deprecated - Migration package only

Core Imports

Any import will result in an error being thrown:

import '@storybook/addon-toolbars';

CommonJS:

require('@storybook/addon-toolbars');

All import patterns will throw the same migration error.

Basic Usage

This package should not be used. Any attempt to import or use this package will result in an error:

// This will throw an error
import '@storybook/addon-toolbars';

// Error message:
// "Your Storybook project is referring to package @storybook/addon-toolbars, 
// which no longer exists in Storybook 9.0 and above. Please refer to the 
// Storybook 9 migration guide for instructions on how to fix this issue: 
// https://storybook.js.org/docs/9/migration-guide#package-structure-changes"

Migration Information

For users who encounter this package:

1. Remove the dependency: Remove @storybook/addon-toolbars from your package.json
2. Follow migration guide: Visit https://storybook.js.org/docs/9/migration-guide#package-structure-changes
3. Use core functionality: Toolbar functionality is now built into Storybook core

Capabilities

Error Throwing Mechanism

The package's sole functionality is to throw informative migration errors when imported.

/**
 * Error thrown by all entry points to direct users to migration guide
 * @throws Error with migration instructions
 */
declare function throwMigrationError(): never;

All entry points (main, preview, manager, register) execute this error mechanism.

Entry Points

The package defines multiple entry points, all of which throw the same migration error:

// Main entry point - throws migration error
import '@storybook/addon-toolbars';

// Preview entry point - throws migration error  
import '@storybook/addon-toolbars/preview';

// Manager entry point - throws migration error
import '@storybook/addon-toolbars/manager';

// Register entry point (alias for manager) - throws migration error
import '@storybook/addon-toolbars/register';

Types

/**
 * Standard Error thrown by all entry points with migration message
 * Note: This is a standard JavaScript Error, not a custom exported type
 */
type ThrownError = Error & {
  message: "Your Storybook project is referring to package @storybook/addon-toolbars, which no longer exists in Storybook 9.0 and above. Please refer to the Storybook 9 migration guide for instructions on how to fix this issue: https://storybook.js.org/docs/9/migration-guide#package-structure-changes";
}

Package Structure

The package exports are defined in package.json with the following entry points:

• Main export (.): Points to dist/index.js (main), dist/index.mjs (import), dist/index.d.ts (types)
• Preview export (./preview): Points to dist/preview.js (require), dist/preview.mjs (import), dist/preview.d.ts (types)
• Manager export (./manager): Points to dist/manager.js
• Register export (./register): Alias for ./manager pointing to dist/manager.js

All source files (src/index.ts, src/preview.tsx, src/manager.tsx) import src/error.ts which throws the migration error.

Important Notes

• No functional API: This package provides no working functionality
• Migration tool only: Exists purely to help users transition away from the deprecated addon
• Storybook 9+ compatibility: Toolbar functionality is now part of Storybook core
• Error on all imports: Every possible import path results in the same helpful error message
• Build system intact: Package maintains proper TypeScript build configuration despite having no functional code