storybook 9.0.0-alpha.10 → 9.0.0-alpha.12

package/dist/telemetry/index.d.ts

@@ -32,7 +32,7 @@ declare const monorepoConfigs: {
 };
 type MonorepoType = keyof typeof monorepoConfigs | 'Workspaces' | undefined;
 
-type EventType = 'boot' | 'dev' | 'build' | 'index' | 'upgrade' | 'init' | 'scaffolded-empty' | 'browser' | 'canceled' | 'error' | 'error-metadata' | 'version-update' | 'core-config' | 'remove' | 'save-story' | 'create-new-story-file' | 'create-new-story-file-search' | 'testing-module-watch-mode' | 'testing-module-completed-report' | 'testing-module-crash-report';
+type EventType = 'boot' | 'dev' | 'build' | 'index' | 'upgrade' | 'init' | 'scaffolded-empty' | 'browser' | 'canceled' | 'error' | 'error-metadata' | 'version-update' | 'core-config' | 'remove' | 'save-story' | 'create-new-story-file' | 'create-new-story-file-search' | 'testing-module-watch-mode' | 'testing-module-completed-report' | 'testing-module-crash-report' | 'addon-test';
 interface Dependency {
     version: string | undefined;
     versionSpecifier?: string;

package/dist/types/index.cjs

@@ -1,27 +1,26 @@
 "use strict";
 var d = Object.defineProperty;
 var y = Object.getOwnPropertyDescriptor;
-var i = Object.getOwnPropertyNames;
-var s = Object.prototype.hasOwnProperty;
-var A = (t, e) => {
+var s = Object.getOwnPropertyNames;
+var i = Object.prototype.hasOwnProperty;
+var A = (r, e) => {
   for (var n in e)
-    d(t, n, { get: e[n], enumerable: !0 });
-}, T = (t, e, n, a) => {
+    d(r, n, { get: e[n], enumerable: !0 });
+}, T = (r, e, n, a) => {
   if (e && typeof e == "object" || typeof e == "function")
-    for (let o of i(e))
-      !s.call(t, o) && o !== n && d(t, o, { get: () => e[o], enumerable: !(a = y(e, o)) || a.enumerable });
-  return t;
+    for (let o of s(e))
+      !i.call(r, o) && o !== n && d(r, o, { get: () => e[o], enumerable: !(a = y(e, o)) || a.enumerable });
+  return r;
 };
-var _ = (t) => T(d({}, "__esModule", { value: !0 }), t);
+var _ = (r) => T(d({}, "__esModule", { value: !0 }), r);
 
 // src/types/index.ts
-var m = {};
-A(m, {
+var S = {};
+A(S, {
   Addon_TypesEnum: () => p
 });
-module.exports = _(m);
+module.exports = _(S);
 
 // src/types/modules/addons.ts
-var p = /* @__PURE__ */ ((r) => (r.TAB = "tab", r.PANEL = "panel", r.TOOL = "tool", r.TOOLEXTRA = "toolextra", r.PREVIEW = "preview", r.experimental_PAGE =
-"page", r.experimental_SIDEBAR_BOTTOM = "sidebar-bottom", r.experimental_SIDEBAR_TOP = "sidebar-top", r.experimental_TEST_PROVIDER = "test-p\
-rovider", r))(p || {});
+var p = /* @__PURE__ */ ((t) => (t.TAB = "tab", t.PANEL = "panel", t.TOOL = "tool", t.TOOLEXTRA = "toolextra", t.PREVIEW = "preview", t.experimental_PAGE =
+"page", t.experimental_TEST_PROVIDER = "test-provider", t))(p || {});

package/dist/types/index.d.ts

@@ -885,7 +885,7 @@ interface ChannelEvent {
     from: string;
     args: any[];
 }
-interface Listener {
+interface Listener$1 {
     (...args: any[]): void;
 }
 interface ChannelArgsSingle {
@@ -906,17 +906,17 @@ declare class Channel {
     constructor(input: ChannelArgsMulti);
     constructor(input: ChannelArgsSingle);
     get hasTransport(): boolean;
-    addListener(eventName: string, listener: Listener): void;
+    addListener(eventName: string, listener: Listener$1): void;
     emit(eventName: string, ...args: any): void;
     last(eventName: string): any;
     eventNames(): string[];
     listenerCount(eventName: string): number;
-    listeners(eventName: string): Listener[] | undefined;
-    once(eventName: string, listener: Listener): void;
+    listeners(eventName: string): Listener$1[] | undefined;
+    once(eventName: string, listener: Listener$1): void;
     removeAllListeners(eventName?: string): void;
-    removeListener(eventName: string, listener: Listener): void;
-    on(eventName: string, listener: Listener): void;
-    off(eventName: string, listener: Listener): void;
+    removeListener(eventName: string, listener: Listener$1): void;
+    on(eventName: string, listener: Listener$1): void;
+    off(eventName: string, listener: Listener$1): void;
     private handleEvent;
     private onceListener;
 }
@@ -1298,13 +1298,6 @@ type CoreCommon_StorybookRefs = Record<string, {
 type DocsOptions = {
     /** What should we call the generated docs entries? */
     defaultName?: string;
-    /**
-     * Should we generate a docs entry per CSF file? Set to 'tag' (the default) to generate an entry
-     * for every CSF file with the 'autodocs' tag.
-     *
-     * @deprecated Use `tags: ['autodocs']` in `.storybook/preview.js` instead
-     */
-    autodocs?: boolean | 'tag';
     /** Only show doc entries in the side bar (usually set with the `--docs` CLI flag) */
     docsMode?: boolean;
 };
@@ -1711,8 +1704,6 @@ interface API_ProviderData<API> {
 }
 interface API_Provider<API> {
     channel?: Channel;
-    /** @deprecated Will be removed in 8.0, please use channel instead */
-    serverChannel?: Channel;
     renderPreview?: API_IframeRenderer;
     handleAPI(api: API): void;
     getConfig(): {
@@ -1751,8 +1742,6 @@ interface API_Layout {
     panelPosition: API_PanelPositions;
     showTabs: boolean;
     showToolbar: boolean;
-    /** @deprecated, will be removed in 8.0 - this API no longer works */
-    isToolshown?: boolean;
 }
 interface API_UI {
     name?: string;
@@ -1777,14 +1766,6 @@ interface OnClickOptions {
     /** Function to dismiss the notification. */
     onDismiss: () => void;
 }
-/**
- * @deprecated Use ReactNode for the icon instead.
- * @see https://github.com/storybookjs/storybook/blob/next/MIGRATION.md#icons-is-deprecated
- */
-interface DeprecatedIconType {
-    name: string;
-    color?: string;
-}
 interface API_Notification {
     id: string;
     content: {
@@ -1793,7 +1774,7 @@ interface API_Notification {
     };
     duration?: number;
     link?: string;
-    icon?: React.ReactNode | DeprecatedIconType;
+    icon?: React.ReactNode;
     onClear?: (options: OnClearOptions) => void;
     onClick?: (options: OnClickOptions) => void;
 }
@@ -1827,7 +1808,7 @@ type API_Refs = Record<string, API_ComposedRef>;
 type API_RefId = string;
 type API_RefUrl = string;
 
-type Addon_Types = Exclude<Addon_TypesEnum, Addon_TypesEnum.experimental_PAGE | Addon_TypesEnum.experimental_SIDEBAR_BOTTOM | Addon_TypesEnum.experimental_TEST_PROVIDER | Addon_TypesEnum.experimental_SIDEBAR_TOP>;
+type Addon_Types = Exclude<Addon_TypesEnum, Addon_TypesEnum.experimental_PAGE | Addon_TypesEnum.experimental_TEST_PROVIDER>;
 interface Addon_ArgType<TArg = unknown> extends InputType {
     defaultValue?: TArg;
 }
@@ -2018,7 +1999,6 @@ interface Addon_BaseMeta<ComponentType> {
      *
      * Used by addons for automatic prop table generation and display of other component metadata.
      *
-     * @deprecated
      * @example
      *
      * ```ts
@@ -2044,7 +2024,7 @@ type BaseStory<TArgs, StoryFnReturnType> = Addon_BaseStoryFn<TArgs, StoryFnRetur
 interface Addon_RenderOptions {
     active: boolean;
 }
-type Addon_Type = Addon_BaseType | Addon_PageType | Addon_WrapperType | Addon_SidebarBottomType | Addon_SidebarTopType | Addon_TestProviderType<Addon_TestProviderState>;
+type Addon_Type = Addon_BaseType | Addon_PageType | Addon_WrapperType | Addon_TestProviderType<Addon_TestProviderState>;
 interface Addon_BaseType {
     /**
      * The title of the addon. This can be a simple string, but it can also be a
@@ -2060,7 +2040,7 @@ interface Addon_BaseType {
      * Addon_TypesEnum.PANEL;
      * ```
      */
-    type: Exclude<Addon_Types, Addon_TypesEnum.PREVIEW | Addon_TypesEnum.experimental_PAGE | Addon_TypesEnum.experimental_SIDEBAR_BOTTOM | Addon_TypesEnum.experimental_SIDEBAR_TOP | Addon_TypesEnum.experimental_TEST_PROVIDER>;
+    type: Exclude<Addon_Types, Addon_TypesEnum.PREVIEW | Addon_TypesEnum.experimental_PAGE | Addon_TypesEnum.experimental_TEST_PROVIDER>;
     /**
      * The unique id of the addon.
      *
@@ -2147,22 +2127,6 @@ interface Addon_WrapperType {
         storyId: StoryId;
     }>>;
 }
-/** @deprecated This doesn't do anything anymore and will be removed in Storybook 9.0. */
-interface Addon_SidebarBottomType {
-    type: Addon_TypesEnum.experimental_SIDEBAR_BOTTOM;
-    /** The unique id of the tool. */
-    id: string;
-    /** A React.FunctionComponent. */
-    render: FC;
-}
-/** @deprecated This will be removed in Storybook 9.0. */
-interface Addon_SidebarTopType {
-    type: Addon_TypesEnum.experimental_SIDEBAR_TOP;
-    /** The unique id of the tool. */
-    id: string;
-    /** A React.FunctionComponent. */
-    render: FC;
-}
 interface Addon_TestProviderType<Details extends {
     [key: string]: any;
 } = NonNullable<unknown>> {
@@ -2197,12 +2161,10 @@ type Addon_TestProviderState<Details extends {
         message?: string;
     };
 };
-type Addon_TypeBaseNames = Exclude<Addon_TypesEnum, Addon_TypesEnum.PREVIEW | Addon_TypesEnum.experimental_PAGE | Addon_TypesEnum.experimental_SIDEBAR_BOTTOM | Addon_TypesEnum.experimental_SIDEBAR_TOP | Addon_TypesEnum.experimental_TEST_PROVIDER>;
+type Addon_TypeBaseNames = Exclude<Addon_TypesEnum, Addon_TypesEnum.PREVIEW | Addon_TypesEnum.experimental_PAGE | Addon_TypesEnum.experimental_TEST_PROVIDER>;
 interface Addon_TypesMapping extends Record<Addon_TypeBaseNames, Addon_BaseType> {
     [Addon_TypesEnum.PREVIEW]: Addon_WrapperType;
     [Addon_TypesEnum.experimental_PAGE]: Addon_PageType;
-    [Addon_TypesEnum.experimental_SIDEBAR_BOTTOM]: Addon_SidebarBottomType;
-    [Addon_TypesEnum.experimental_SIDEBAR_TOP]: Addon_SidebarTopType;
     [Addon_TypesEnum.experimental_TEST_PROVIDER]: Addon_TestProviderType<Addon_TestProviderState>;
 }
 type Addon_Loader<API> = (api: API) => void;
@@ -2252,18 +2214,6 @@ declare enum Addon_TypesEnum {
      * @unstable
      */
     experimental_PAGE = "page",
-    /**
-     * This adds items in the bottom of the sidebar.
-     *
-     * @deprecated This doesn't do anything anymore and will be removed in Storybook 9.0.
-     */
-    experimental_SIDEBAR_BOTTOM = "sidebar-bottom",
-    /**
-     * This adds items in the top of the sidebar.
-     *
-     * @deprecated This will be removed in Storybook 9.0.
-     */
-    experimental_SIDEBAR_TOP = "sidebar-top",
     /** This adds items to the Testing Module in the sidebar. */
     experimental_TEST_PROVIDER = "test-provider"
 }
@@ -2304,7 +2254,6 @@ interface ProjectAnnotations<TRenderer extends Renderer> extends ProjectAnnotati
         unmount: () => void;
     };
     renderToCanvas?: RenderToCanvas<TRenderer>;
-    renderToDOM?: RenderToCanvas<TRenderer>;
 }
 type NamedExportsOrDefault<TExport> = TExport | {
     default: TExport;
@@ -2519,10 +2468,250 @@ interface ComposeStoryFn<TRenderer extends Renderer$1 = Renderer$1, TArgs extend
     (storyAnnotations: AnnotatedStoryFn<TRenderer, TArgs> | StoryAnnotations<TRenderer, TArgs>, componentAnnotations: ComponentAnnotations<TRenderer, TArgs>, projectAnnotations: ProjectAnnotations$1<TRenderer>, exportsName?: string): ComposedStoryFn;
 }
 
-type SupportedFrameworks = 'angular' | 'ember' | 'experimental-nextjs-vite' | 'html-vite' | 'html-webpack5' | 'nextjs' | 'preact-vite' | 'preact-webpack5' | 'react-native-web-vite' | 'react-vite' | 'react-webpack5' | 'server-webpack5' | 'svelte-vite' | 'svelte-webpack5' | 'sveltekit' | 'vue3-vite' | 'vue3-webpack5' | 'web-components-vite' | 'web-components-webpack5' | 'qwik' | 'solid' | 'nuxt' | 'react-rsbuild' | 'vue3-rsbuild';
+type SupportedFrameworks = 'angular' | 'ember' | 'html-vite' | 'html-webpack5' | 'nextjs' | 'nextjs-vite' | 'preact-vite' | 'react-native-web-vite' | 'react-vite' | 'react-webpack5' | 'server-webpack5' | 'svelte-vite' | 'svelte-webpack5' | 'sveltekit' | 'vue3-vite' | 'web-components-vite' | 'web-components-webpack5' | 'qwik' | 'solid' | 'nuxt' | 'react-rsbuild' | 'vue3-rsbuild';
 
 type SupportedRenderers = 'react' | 'react-native' | 'vue3' | 'angular' | 'ember' | 'preact' | 'svelte' | 'qwik' | 'html' | 'web-components' | 'server' | 'solid' | 'nuxt';
 
+type EnvironmentType = (typeof UniversalStore.Environment)[keyof typeof UniversalStore.Environment];
+type StatusType = (typeof UniversalStore.Status)[keyof typeof UniversalStore.Status];
+type StateUpdater<TState> = (prevState: TState) => TState;
+type Actor = {
+    id: string;
+    type: (typeof UniversalStore.ActorType)[keyof typeof UniversalStore.ActorType];
+    environment: EnvironmentType;
+};
+type EventInfo = {
+    actor: Actor;
+    forwardingActor?: Actor;
+};
+type Listener<TEvent> = (event: TEvent, eventInfo: EventInfo) => void;
+type BaseEvent = {
+    type: string;
+    payload?: any;
+};
+interface SetStateEvent<TState> extends BaseEvent {
+    type: typeof UniversalStore.InternalEventType.SET_STATE;
+    payload: {
+        state: TState;
+        previousState: TState;
+    };
+}
+interface ExistingStateRequestEvent extends BaseEvent {
+    type: typeof UniversalStore.InternalEventType.EXISTING_STATE_REQUEST;
+    payload: never;
+}
+interface ExistingStateResponseEvent<TState> extends BaseEvent {
+    type: typeof UniversalStore.InternalEventType.EXISTING_STATE_RESPONSE;
+    payload: TState;
+}
+interface LeaderCreatedEvent extends BaseEvent {
+    type: typeof UniversalStore.InternalEventType.LEADER_CREATED;
+    payload: never;
+}
+interface FollowerCreatedEvent extends BaseEvent {
+    type: typeof UniversalStore.InternalEventType.FOLLOWER_CREATED;
+    payload: never;
+}
+type InternalEvent<TState> = SetStateEvent<TState> | ExistingStateRequestEvent | ExistingStateResponseEvent<TState> | FollowerCreatedEvent | LeaderCreatedEvent;
+type Event<TState, TEvent extends BaseEvent> = TEvent | InternalEvent<TState>;
+type ChannelLike = Pick<Channel$1, 'on' | 'off' | 'emit'>;
+type StoreOptions<TState> = {
+    id: string;
+    leader?: boolean;
+    initialState?: TState;
+    debug?: boolean;
+};
+type EnvironmentOverrides = {
+    channel: ChannelLike;
+    environment: EnvironmentType;
+};
+
+/**
+ * A universal store implementation that synchronizes state across different environments using a
+ * channel-based communication.
+ *
+ * The store follows a leader-follower pattern where:
+ *
+ * - Leader: The main store instance that owns and manages the state
+ * - Follower: Store instances that mirror the leader's state
+ *
+ * Features:
+ *
+ * - State synchronization across environments
+ * - Event-based communication
+ * - Type-safe state and custom events
+ * - Subscription system for state changes and custom events
+ *
+ * @remarks
+ * - The store must be created using the static `create()` method, not the constructor
+ * - Follower stores will automatically sync with their leader's state. If they have initial state, it
+ *   will be replaced immediately when it has synced with the leader.
+ *
+ * @example
+ *
+ * ```typescript
+ * interface MyState {
+ *   count: number;
+ * }
+ * interface MyCustomEvent {
+ *   type: 'INCREMENT';
+ *   payload: number;
+ * }
+ *
+ * // Create a leader store
+ * const leaderStore = UniversalStore.create<MyState, MyCustomEvent>({
+ *   id: 'my-store',
+ *   leader: true,
+ *   initialState: { count: 0 },
+ * });
+ *
+ * // Create a follower store
+ * const followerStore = UniversalStore.create<MyState, MyCustomEvent>({
+ *   id: 'my-store',
+ *   leader: false,
+ * });
+ * ```
+ *
+ * @template State - The type of state managed by the store
+ * @template CustomEvent - Custom events that can be sent through the store. Must have a `type`
+ *   string and optional `payload`
+ * @throws {Error} If constructed directly instead of using `create()`
+ * @throws {Error} If created without setting a channel first
+ * @throws {Error} If a follower is created with initial state
+ * @throws {Error} If a follower cannot find its leader within 1 second
+ */
+declare class UniversalStore<State, CustomEvent extends {
+    type: string;
+    payload?: any;
+} = {
+    type: string;
+    payload?: any;
+}> {
+    /**
+     * Defines the possible actor types in the store system
+     *
+     * @readonly
+     */
+    static readonly ActorType: {
+        readonly LEADER: "LEADER";
+        readonly FOLLOWER: "FOLLOWER";
+    };
+    /**
+     * Defines the possible environments the store can run in
+     *
+     * @readonly
+     */
+    static readonly Environment: {
+        readonly SERVER: "SERVER";
+        readonly MANAGER: "MANAGER";
+        readonly PREVIEW: "PREVIEW";
+        readonly UNKNOWN: "UNKNOWN";
+        readonly MOCK: "MOCK";
+    };
+    /**
+     * Internal event types used for store synchronization
+     *
+     * @readonly
+     */
+    static readonly InternalEventType: {
+        readonly EXISTING_STATE_REQUEST: "__EXISTING_STATE_REQUEST";
+        readonly EXISTING_STATE_RESPONSE: "__EXISTING_STATE_RESPONSE";
+        readonly SET_STATE: "__SET_STATE";
+        readonly LEADER_CREATED: "__LEADER_CREATED";
+        readonly FOLLOWER_CREATED: "__FOLLOWER_CREATED";
+    };
+    static readonly Status: {
+        readonly UNPREPARED: "UNPREPARED";
+        readonly SYNCING: "SYNCING";
+        readonly READY: "READY";
+        readonly ERROR: "ERROR";
+    };
+    protected static isInternalConstructing: boolean;
+    /**
+     * The preparation construct is used to keep track of all store's preparation state the promise is
+     * resolved when the store is prepared with the static __prepare() method which will also change
+     * the state from PENDING to RESOLVED
+     */
+    private static preparation;
+    private static setupPreparationPromise;
+    /** Enable debug logs for this store */
+    debugging: boolean;
+    /** The actor object representing the store instance with a unique ID and a type */
+    get actor(): Actor;
+    /**
+     * The current state of the store, that signals both if the store is prepared by Storybook and
+     * also - in the case of a follower - if the state has been synced with the leader's state.
+     */
+    get status(): StatusType;
+    /**
+     * A promise that resolves when the store is fully ready. A leader will be ready when the store
+     * has been prepared by Storybook, which is almost instantly.
+     *
+     * A follower will be ready when the state has been synced with the leader's state, within a few
+     * hundred milliseconds.
+     */
+    untilReady(): Promise<[{
+        channel: ChannelLike;
+        environment: EnvironmentType;
+    }, void | undefined]>;
+    /**
+     * The syncing construct is used to keep track of if the instance's state has been synced with the
+     * other instances. A leader will immediately have the promise resolved. A follower will initially
+     * be in a PENDING state, and resolve the the leader has sent the existing state, or reject if no
+     * leader has responded before the timeout.
+     */
+    private syncing?;
+    private channelEventName;
+    private state;
+    private channel?;
+    private environment?;
+    private listeners;
+    private id;
+    private actorId;
+    private actorType;
+    protected constructor(options: StoreOptions<State>, environmentOverrides?: EnvironmentOverrides);
+    /** Creates a new instance of UniversalStore */
+    static create<State = any, CustomEvent extends {
+        type: string;
+        payload?: any;
+    } = {
+        type: string;
+        payload?: any;
+    }>(options: StoreOptions<State>): UniversalStore<State, CustomEvent>;
+    /** Gets the current state */
+    getState: () => State;
+    /**
+     * Updates the store's state
+     *
+     * Either a new state or a state updater function can be passed to the method.
+     */
+    setState(updater: State | StateUpdater<State>): void;
+    /**
+     * Subscribes to store events
+     *
+     * @returns A function to unsubscribe
+     */
+    subscribe: {
+        (listener: Listener<Event<State, CustomEvent>>): () => void;
+        <EventType extends Event<State, CustomEvent>['type']>(eventType: EventType, listener: Listener<Extract<Event<State, CustomEvent>, {
+            type: EventType;
+        }>>): () => void;
+    };
+    /**
+     * Subscribes to state changes
+     *
+     * @returns Unsubscribe function
+     */
+    onStateChange(listener: (state: State, previousState: State, eventInfo: EventInfo) => void): () => void;
+    /** Sends a custom event to the other stores */
+    send: (event: CustomEvent) => void;
+    private emitToChannel;
+    private prepareThis;
+    private emitToListeners;
+    private handleChannelEvents;
+    private debug;
+}
+
 type StatusValue = 'status-value:pending' | 'status-value:success' | 'status-value:error' | 'status-value:warning' | 'status-value:unknown';
 type StatusTypeId = string;
 type StatusByTypeId = Record<StatusTypeId, Status>;
@@ -2792,4 +2981,56 @@ type UseTestProviderStore = <T = TestProviderStateByProviderId>(
  */
 selector?: (state: TestProviderStateByProviderId) => T) => T;
 
-export { type API_ActiveTabsType, type API_BaseEntry, type API_ComponentEntry, type API_ComposedRef, type API_ComposedRefUpdate, type API_DocsEntry, type API_FilterFunction, type API_GroupEntry, type API_HashEntry, type API_IframeRenderer, type API_IndexHash, type API_Layout, type API_LeafEntry, type API_LoadedRefData, type API_MatchOptions, type API_Notification, type API_OptionsData, type API_PanelPositions, type API_PreparedIndexEntry, type API_PreparedStoryIndex, type API_Provider, type API_ProviderData, type API_RefId, type API_RefUrl, type API_Refs, type API_ReleaseNotes, type API_RenderOptions, type API_RootEntry, type API_RouteOptions, type API_SetRefData, type API_Settings, type API_SidebarOptions, type API_StateMerger, type API_StoryEntry, type API_StoryMapper, type API_UI, type API_UIOptions, type API_UnknownEntries, type API_Version, type API_Versions$1 as API_Versions, type API_ViewMode, type Addon_AddStoryArgs, type Addon_Annotations, type Addon_ArgType, type Addon_ArgsStoryFn, type Addon_BaseAnnotations, type Addon_BaseDecorators, type Addon_BaseMeta, type Addon_BaseStoryFn, type Addon_BaseStoryObject, type Addon_BaseType, type Addon_ClientApiAddon, type Addon_ClientApiAddons, type Addon_ClientApiReturnFn, type Addon_ClientStoryApi, type Addon_Collection, type Addon_Comparator, type Addon_Config, type Addon_DecoratorFunction, type Addon_Elements, type Addon_LegacyStoryFn, type Addon_LoadFn, type Addon_Loadable, type Addon_Loader, type Addon_LoaderFunction, type Addon_Loaders, type Addon_MakeDecoratorResult, type Addon_OptionsParameter, type Addon_OptionsParameterV7, type Addon_PageType, type Addon_PartialStoryFn, type Addon_RenderOptions, type Addon_RequireContext, type Addon_SidebarBottomType, type Addon_SidebarTopType, type Addon_StoryApi, type Addon_StoryContext, type Addon_StoryContextUpdate, type Addon_StoryFn, type Addon_StorySortComparator, type Addon_StorySortComparatorV7, type Addon_StorySortMethod, type Addon_StorySortObjectParameter, type Addon_StorySortParameter, type Addon_StorySortParameterV7, type Addon_StoryWrapper, type Addon_TestProviderState, type Addon_TestProviderType, type Addon_ToolbarConfig, type Addon_Type, type Addon_Types, Addon_TypesEnum, type Addon_TypesMapping, type Addon_WrapperSettings, type Addon_WrapperType, type Addons_ArgTypes, type BaseIndexEntry, type BaseIndexInput, type BaseStory, type BoundStory, type Builder, type BuilderName, type BuilderOptions, type BuilderResult, type BuilderStats, type Builder_EnvsRaw, type Builder_Unpromise, type Builder_WithRequiredProperty, type CLIBaseOptions, type CLIOptions, type CSFFile, type CompatibleString, type ComposeStoryFn, type ComposedStoryFn, type CoreCommon_AddonEntry, type CoreCommon_AddonInfo, type CoreCommon_OptionsEntry, type CoreCommon_ResolvedAddonPreset, type CoreCommon_ResolvedAddonVirtual, type CoreCommon_StorybookInfo, type CoreConfig, type DocsContextProps, type DocsIndexEntry, type DocsIndexInput, type DocsOptions, type DocsPreparedPayload, type DocsRenderFunction, type Entry, type GlobalsUpdatedPayload, type IndexEntry, type IndexEntryLegacy, type IndexInput, type IndexInputStats, type IndexedCSFFile, type IndexedStory, type Indexer, type IndexerOptions, type LoadOptions, type LoadedPreset, type Middleware, type ModuleExport, type ModuleExports, type ModuleImportFn, type NamedOrDefaultProjectAnnotations, type NormalizedComponentAnnotations, type NormalizedProjectAnnotations, type NormalizedStoriesSpecifier, type NormalizedStoryAnnotations, type Options, type PackageJson, type PartialArgsStoryFn, type Path, type PreparedMeta, type PreparedStory, type Preset, type PresetConfig, type PresetProperty, type PresetPropertyFn, type PresetValue, type Presets, type PreviewAnnotation, type ProjectAnnotations, type Ref, type RenderContext, type RenderContextCallbacks, type RenderToCanvas, type Renderer, type RendererName, type ResolvedModuleExport, type ResolvedModuleExportFromType, type ResolvedModuleExportType, type SetGlobalsPayload, type SetStoriesPayload, type SetStoriesStory, type SetStoriesStoryData, type Stats, type Status, type StatusByTypeId, type StatusStore, type StatusStoreByTypeId, type StatusTypeId, type StatusValue, type StatusesByStoryIdAndTypeId, type Store_CSFExports, type StoriesEntry, type StoriesSpecifier, type StoriesWithPartialProps, type StoryIndex, type StoryIndexEntry, type StoryIndexInput, type StoryIndexV2, type StoryIndexV3, type StoryPreparedPayload, type StoryRenderOptions, type StorybookConfig, type StorybookConfigOptions, type StorybookConfigRaw, type StorybookInternalParameters, type StorybookParameters, type SupportedFrameworks, type SupportedRenderers, type TagOptions, type TagsOptions, type TeardownRenderToCanvas, type TestBuildConfig, type TestBuildFlags, type TestProviderId, type TestProviderState, type TestProviderStoreById, type TypescriptOptions, type UseStatusStore, type UseTestProviderStore, type V3CompatIndexEntry, type VersionCheck, type ViewMode, type WebRenderer };
+/**
+ * A mock universal store that can be used when testing code that relies on a universal store. It
+ * functions exactly like a normal universal store, with a few exceptions:
+ *
+ * - It is fully isolated, meaning that it doesn't interact with any channel, and it is always a
+ *   leader.
+ *
+ * If the second testUtils argument is provided, all the public methods are spied on, so they can be
+ * asserted.
+ *
+ * When a mock store is re-used across tests (eg. in stories), you manually need to reset the state
+ * after each test.
+ *
+ * @example
+ *
+ * ```ts
+ * import * as testUtils from 'storybook/test'; // in stories
+ * import { vi as testUtils } from 'vitest'; // ... or in Vitest tests
+ *
+ * const initialState = { ... };
+ * const store = new MockUniversalStore({ initialState }, testUtils);
+ *
+ * export default {
+ *   title: 'My story',
+ *   beforeEach: () => {
+ *     return () => {
+ *       store.setState(initialState);
+ *     };
+ *   }
+ * }
+ * ```
+ */
+declare class MockUniversalStore<State, CustomEvent extends {
+    type: string;
+    payload?: any;
+} = {
+    type: string;
+    payload?: any;
+}> extends UniversalStore<State, CustomEvent> {
+    private testUtils;
+    constructor(options: StoreOptions<State>, testUtils?: any);
+    /** Create a mock universal store. This is just an alias for the constructor */
+    static create<State = any, CustomEvent extends {
+        type: string;
+        payload?: any;
+    } = {
+        type: string;
+        payload?: any;
+    }>(options: StoreOptions<State>, testUtils?: any): MockUniversalStore<State, CustomEvent>;
+    unsubscribeAll(): void;
+}
+
+export { type API_ActiveTabsType, type API_BaseEntry, type API_ComponentEntry, type API_ComposedRef, type API_ComposedRefUpdate, type API_DocsEntry, type API_FilterFunction, type API_GroupEntry, type API_HashEntry, type API_IframeRenderer, type API_IndexHash, type API_Layout, type API_LeafEntry, type API_LoadedRefData, type API_MatchOptions, type API_Notification, type API_OptionsData, type API_PanelPositions, type API_PreparedIndexEntry, type API_PreparedStoryIndex, type API_Provider, type API_ProviderData, type API_RefId, type API_RefUrl, type API_Refs, type API_ReleaseNotes, type API_RenderOptions, type API_RootEntry, type API_RouteOptions, type API_SetRefData, type API_Settings, type API_SidebarOptions, type API_StateMerger, type API_StoryEntry, type API_StoryMapper, type API_UI, type API_UIOptions, type API_UnknownEntries, type API_Version, type API_Versions$1 as API_Versions, type API_ViewMode, type Actor, type Addon_AddStoryArgs, type Addon_Annotations, type Addon_ArgType, type Addon_ArgsStoryFn, type Addon_BaseAnnotations, type Addon_BaseDecorators, type Addon_BaseMeta, type Addon_BaseStoryFn, type Addon_BaseStoryObject, type Addon_BaseType, type Addon_ClientApiAddon, type Addon_ClientApiAddons, type Addon_ClientApiReturnFn, type Addon_ClientStoryApi, type Addon_Collection, type Addon_Comparator, type Addon_Config, type Addon_DecoratorFunction, type Addon_Elements, type Addon_LegacyStoryFn, type Addon_LoadFn, type Addon_Loadable, type Addon_Loader, type Addon_LoaderFunction, type Addon_Loaders, type Addon_MakeDecoratorResult, type Addon_OptionsParameter, type Addon_OptionsParameterV7, type Addon_PageType, type Addon_PartialStoryFn, type Addon_RenderOptions, type Addon_RequireContext, type Addon_StoryApi, type Addon_StoryContext, type Addon_StoryContextUpdate, type Addon_StoryFn, type Addon_StorySortComparator, type Addon_StorySortComparatorV7, type Addon_StorySortMethod, type Addon_StorySortObjectParameter, type Addon_StorySortParameter, type Addon_StorySortParameterV7, type Addon_StoryWrapper, type Addon_TestProviderState, type Addon_TestProviderType, type Addon_ToolbarConfig, type Addon_Type, type Addon_Types, Addon_TypesEnum, type Addon_TypesMapping, type Addon_WrapperSettings, type Addon_WrapperType, type Addons_ArgTypes, type BaseIndexEntry, type BaseIndexInput, type BaseStory, type BoundStory, type Builder, type BuilderName, type BuilderOptions, type BuilderResult, type BuilderStats, type Builder_EnvsRaw, type Builder_Unpromise, type Builder_WithRequiredProperty, type CLIBaseOptions, type CLIOptions, type CSFFile, type CompatibleString, type ComposeStoryFn, type ComposedStoryFn, type CoreCommon_AddonEntry, type CoreCommon_AddonInfo, type CoreCommon_OptionsEntry, type CoreCommon_ResolvedAddonPreset, type CoreCommon_ResolvedAddonVirtual, type CoreCommon_StorybookInfo, type CoreConfig, type DocsContextProps, type DocsIndexEntry, type DocsIndexInput, type DocsOptions, type DocsPreparedPayload, type DocsRenderFunction, type Entry, type Event, type EventInfo, type GlobalsUpdatedPayload, type IndexEntry, type IndexEntryLegacy, type IndexInput, type IndexInputStats, type IndexedCSFFile, type IndexedStory, type Indexer, type IndexerOptions, type LoadOptions, type LoadedPreset, type Middleware, MockUniversalStore, type ModuleExport, type ModuleExports, type ModuleImportFn, type NamedOrDefaultProjectAnnotations, type NormalizedComponentAnnotations, type NormalizedProjectAnnotations, type NormalizedStoriesSpecifier, type NormalizedStoryAnnotations, type Options, type PackageJson, type PartialArgsStoryFn, type Path, type PreparedMeta, type PreparedStory, type Preset, type PresetConfig, type PresetProperty, type PresetPropertyFn, type PresetValue, type Presets, type PreviewAnnotation, type ProjectAnnotations, type Ref, type RenderContext, type RenderContextCallbacks, type RenderToCanvas, type Renderer, type RendererName, type ResolvedModuleExport, type ResolvedModuleExportFromType, type ResolvedModuleExportType, type SetGlobalsPayload, type SetStoriesPayload, type SetStoriesStory, type SetStoriesStoryData, type Stats, type Status, type StatusByTypeId, type StatusStore, type StatusStoreByTypeId, type StatusTypeId, type StatusValue, type StatusesByStoryIdAndTypeId, type StoreOptions, type Store_CSFExports, type StoriesEntry, type StoriesSpecifier, type StoriesWithPartialProps, type StoryIndex, type StoryIndexEntry, type StoryIndexInput, type StoryIndexV2, type StoryIndexV3, type StoryPreparedPayload, type StoryRenderOptions, type StorybookConfig, type StorybookConfigOptions, type StorybookConfigRaw, type StorybookInternalParameters, type StorybookParameters, type SupportedFrameworks, type SupportedRenderers, type TagOptions, type TagsOptions, type TeardownRenderToCanvas, type TestBuildConfig, type TestBuildFlags, type TestProviderId, type TestProviderState, type TestProviderStateByProviderId, type TestProviderStoreById, type TypescriptOptions, UniversalStore, type UseStatusStore, type UseTestProviderStore, type V3CompatIndexEntry, type VersionCheck, type ViewMode, type WebRenderer };

package/dist/types/index.js

@@ -1,7 +1,6 @@
 // src/types/modules/addons.ts
 var r = /* @__PURE__ */ ((e) => (e.TAB = "tab", e.PANEL = "panel", e.TOOL = "tool", e.TOOLEXTRA = "toolextra", e.PREVIEW = "preview", e.experimental_PAGE =
-"page", e.experimental_SIDEBAR_BOTTOM = "sidebar-bottom", e.experimental_SIDEBAR_TOP = "sidebar-top", e.experimental_TEST_PROVIDER = "test-p\
-rovider", e))(r || {});
+"page", e.experimental_TEST_PROVIDER = "test-provider", e))(r || {});
 export {
   r as Addon_TypesEnum
 };

package/dist/viewport/preview.d.ts

@@ -19,7 +19,6 @@ interface ProjectAnnotations<TRenderer extends Renderer> extends ProjectAnnotati
         unmount: () => void;
     };
     renderToCanvas?: RenderToCanvas<TRenderer>;
-    renderToDOM?: RenderToCanvas<TRenderer>;
 }
 declare type RenderContext<TRenderer extends Renderer = Renderer> = StoryIdentifier & {
     showMain: () => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "storybook",
-  "version": "9.0.0-alpha.10",
+  "version": "9.0.0-alpha.12",
   "description": "Storybook framework-agnostic API",
   "keywords": [
     "storybook"
@@ -22,9 +22,9 @@
   "sideEffects": false,
   "type": "module",
   "imports": {
-    "#manager-status-store": {
-      "storybook": "./src/manager/status-store.mock.ts",
-      "default": "./src/manager/status-store.ts"
+    "#manager-stores": {
+      "storybook": "./src/manager/manager-stores.mock.ts",
+      "default": "./src/manager/manager-stores.ts"
     },
     "#utils": {
       "storybook": "./template/stories/utils.mock.ts",
@@ -117,6 +117,19 @@
       "types": "./dist/actions/decorator.d.ts",
       "import": "./dist/actions/decorator.js"
     },
+    "./internal/component-testing": {
+      "types": "./dist/component-testing/index.d.ts",
+      "import": "./dist/component-testing/index.js",
+      "require": "./dist/component-testing/index.cjs"
+    },
+    "./internal/component-testing/preview": {
+      "types": "./dist/component-testing/preview.d.ts",
+      "import": "./dist/component-testing/preview.js",
+      "require": "./dist/component-testing/preview.cjs"
+    },
+    "./internal/component-testing/manager": {
+      "import": "./dist/component-testing/manager.js"
+    },
     "./internal/viewport": {
       "types": "./dist/viewport/index.d.ts",
       "import": "./dist/viewport/index.js",
@@ -370,6 +383,12 @@
       "actions/decorator": [
         "./dist/actions/decorator.d.ts"
       ],
+      "internal/component-testing": [
+        "./dist/component-testing/index.d.ts"
+      ],
+      "internal/component-testing/preview": [
+        "./dist/component-testing/preview.d.ts"
+      ],
       "internal/viewport": [
         "./dist/viewport/index.d.ts"
       ],
@@ -525,6 +544,7 @@
     "@babel/preset-react": "^7.26.3",
     "@babel/traverse": "^7.26.9",
     "@babel/types": "^7.26.8",
+    "@devtools-ds/object-inspector": "^1.1.2",
     "@discoveryjs/json-ext": "^0.5.3",
     "@emotion/cache": "^11.14.0",
     "@emotion/is-prop-valid": "^1.3.1",
@@ -633,6 +653,7 @@
     "slash": "^5.0.0",
     "source-map": "^0.7.4",
     "store2": "^2.14.2",
+    "strip-ansi": "^7.1.0",
     "strip-json-comments": "^5.0.1",
     "telejson": "^7.2.0",
     "tiny-invariant": "^1.3.1",