storybook 9.0.0-alpha.5 → 9.0.0-alpha.7

package/dist/test/preview.js

@@ -14344,9 +14344,8 @@ function JT(e) {
   o(d, "mockCall");
   let p = t.name;
   t.getMockName = () => p || "vi.fn()", t.mockName = (b) => (p = b, t), t.mockClear = () => (l.reset(), n = [], a = [], i = [], t), t.mockReset =
-  () => (t.mockClear(), r = /* @__PURE__ */ o(() => {
-  }, "implementation"), u = [], t), t.mockRestore = () => (t.mockReset(), l.restore(), r = void 0, t), t.getMockImplementation = () => r, t.
-  mockImplementation = (b) => (r = b, l.willCall(d), t), t.mockImplementationOnce = (b) => (u.push(b), t);
+  () => (t.mockClear(), r = void 0, u = [], t), t.mockRestore = () => (t.mockReset(), l.restore(), t), t.getMockImplementation = () => c ? r :
+  u.at(0) || r, t.mockImplementation = (b) => (r = b, l.willCall(d), t), t.mockImplementationOnce = (b) => (u.push(b), t);
   function h(b, w) {
     let C = r;
     r = b, l.willCall(d), c = !0;
@@ -14430,8 +14429,8 @@ var nO = /* @__PURE__ */ o(({ parameters: e }) => {
 }, "traverseArgs"), oO = /* @__PURE__ */ o(({ initialArgs: e }) => {
   ql(e);
 }, "nameSpiesAndWrapActionsInSpies"), aO = /* @__PURE__ */ o(async (e) => {
-  globalThis.HTMLElement && e.canvasElement instanceof globalThis.HTMLElement && (e.canvas = zi(e.canvasElement)), globalThis.window && (e.userEvent =
-  tO({ userEvent: za.setup() }, { intercept: !0 }).userEvent);
+  globalThis.HTMLElement && e.canvasElement instanceof globalThis.HTMLElement && (e.canvas = zi(e.canvasElement)), globalThis.window?.navigator?.
+  clipboard && (e.userEvent = tO({ userEvent: za.setup() }, { intercept: !0 }).userEvent);
 }, "enhanceContext"), kF = /* @__PURE__ */ o(() => rO({
   loaders: [nO, oO, aO]
 }), "default");

package/dist/test/spy.cjs

@@ -1,19 +1,19 @@
 "use strict";
-var x = Object.defineProperty;
+var v = Object.defineProperty;
 var _ = Object.getOwnPropertyDescriptor;
 var N = Object.getOwnPropertyNames;
 var K = Object.prototype.hasOwnProperty;
-var n = (t, e) => x(t, "name", { value: e, configurable: !0 });
+var n = (t, e) => v(t, "name", { value: e, configurable: !0 });
 var U = (t, e) => {
   for (var r in e)
-    x(t, r, { get: e[r], enumerable: !0 });
+    v(t, r, { get: e[r], enumerable: !0 });
 }, W = (t, e, r, l) => {
   if (e && typeof e == "object" || typeof e == "function")
     for (let o of N(e))
-      !K.call(t, o) && o !== r && x(t, o, { get: () => e[o], enumerable: !(l = _(e, o)) || l.enumerable });
+      !K.call(t, o) && o !== r && v(t, o, { get: () => e[o], enumerable: !(l = _(e, o)) || l.enumerable });
   return t;
 };
-var Y = (t) => W(x({}, "__esModule", { value: !0 }), t);
+var Y = (t) => W(v({}, "__esModule", { value: !0 }), t);
 
 // src/test/spy.ts
 var oe = {};
@@ -52,10 +52,10 @@ function M(t, e, r) {
   Object.defineProperty(t, e, { value: r });
 }
 n(M, "l");
-var v = Symbol.for("tinyspy:spy"), q = /* @__PURE__ */ new Set(), z = /* @__PURE__ */ n((t) => {
+var x = Symbol.for("tinyspy:spy"), q = /* @__PURE__ */ new Set(), z = /* @__PURE__ */ n((t) => {
   t.called = !1, t.callCount = 0, t.calls = [], t.results = [], t.resolves = [], t.next = [];
-}, "P"), B = /* @__PURE__ */ n((t) => (w(t, v, { value: { reset: /* @__PURE__ */ n(() => z(t[v]), "reset") } }), t[v]), "K"), h = /* @__PURE__ */ n(
-(t) => t[v] || B(t), "T");
+}, "P"), B = /* @__PURE__ */ n((t) => (w(t, x, { value: { reset: /* @__PURE__ */ n(() => z(t[x]), "reset") } }), t[x]), "K"), h = /* @__PURE__ */ n(
+(t) => t[x] || B(t), "T");
 function G(t) {
   O(
     g("function", t) || g("undefined", t),
@@ -130,7 +130,7 @@ function R(t, e, r) {
   r || (r = i);
   let s = G(r);
   o === "value" && j(s, i);
-  let u = s[v];
+  let u = s[x];
   return M(u, "restore", I), M(u, "getOriginal", () => m ? i() : i), M(u, "willCall", (k) => (u.impl = k, s)), f(
     m ? () => (j(s, r), s) : s
   ), q.add(s), s;
@@ -183,9 +183,8 @@ function D(t) {
   n(i, "mockCall");
   let f = e.name;
   e.getMockName = () => f || "vi.fn()", e.mockName = (s) => (f = s, e), e.mockClear = () => (c.reset(), l = [], o = [], p = [], e), e.mockReset =
-  () => (e.mockClear(), r = /* @__PURE__ */ n(() => {
-  }, "implementation"), a = [], e), e.mockRestore = () => (e.mockReset(), c.restore(), r = void 0, e), e.getMockImplementation = () => r, e.
-  mockImplementation = (s) => (r = s, c.willCall(i), e), e.mockImplementationOnce = (s) => (a.push(s), e);
+  () => (e.mockClear(), r = void 0, a = [], e), e.mockRestore = () => (e.mockReset(), c.restore(), e), e.getMockImplementation = () => m ? r :
+  a.at(0) || r, e.mockImplementation = (s) => (r = s, c.willCall(i), e), e.mockImplementationOnce = (s) => (a.push(s), e);
   function I(s, u) {
     let k = r;
     r = s, c.willCall(i), m = !0;

package/dist/test/spy.js

@@ -2,11 +2,11 @@ var F = Object.defineProperty;
 var n = (t, e) => F(t, "name", { value: e, configurable: !0 });
 
 // ../node_modules/tinyspy/dist/index.js
-function x(t, e) {
+function v(t, e) {
   if (!t)
     throw new Error(e);
 }
-n(x, "d");
+n(v, "d");
 function g(t, e) {
   return typeof e === t;
 }
@@ -28,7 +28,7 @@ var T = Symbol.for("tinyspy:spy"), _ = /* @__PURE__ */ new Set(), N = /* @__PURE
 }, "P"), K = /* @__PURE__ */ n((t) => (b(t, T, { value: { reset: /* @__PURE__ */ n(() => N(t[T]), "reset") } }), t[T]), "K"), h = /* @__PURE__ */ n(
 (t) => t[T] || K(t), "T");
 function U(t) {
-  x(
+  v(
     g("function", t) || g("undefined", t),
     "cannot spy on a non-function value"
   );
@@ -65,10 +65,10 @@ var S = /* @__PURE__ */ n((t, e) => Object.getOwnPropertyDescriptor(t, e), "k"),
   e != null && typeof e == "function" && e.prototype != null && Object.setPrototypeOf(t.prototype, e.prototype);
 }, "O");
 function w(t, e, r) {
-  x(
+  v(
     !g("undefined", t),
     "spyOn could not find an object to spy upon"
-  ), x(
+  ), v(
     g("object", t) || g("function", t),
     "cannot spyOn on a primitive value"
   );
@@ -83,7 +83,7 @@ function w(t, e, r) {
       return [e.setter, "set"];
     throw new Error("specify getter or setter to spy on");
   })(), p = S(t, l), c = Object.getPrototypeOf(t), y = c && S(c, l), a = p || y;
-  x(
+  v(
     a || l in t,
     `${String(l)} does not exist`
   );
@@ -109,7 +109,7 @@ function w(t, e, r) {
 n(w, "C");
 
 // ../node_modules/@vitest/spy/dist/index.js
-var v = /* @__PURE__ */ new Set();
+var x = /* @__PURE__ */ new Set();
 function W(t) {
   return typeof t == "function" && "_isMockFunction" in t && t._isMockFunction;
 }
@@ -154,9 +154,8 @@ function E(t) {
   n(i, "mockCall");
   let f = e.name;
   e.getMockName = () => f || "vi.fn()", e.mockName = (o) => (f = o, e), e.mockClear = () => (c.reset(), l = [], s = [], p = [], e), e.mockReset =
-  () => (e.mockClear(), r = /* @__PURE__ */ n(() => {
-  }, "implementation"), a = [], e), e.mockRestore = () => (e.mockReset(), c.restore(), r = void 0, e), e.getMockImplementation = () => r, e.
-  mockImplementation = (o) => (r = o, c.willCall(i), e), e.mockImplementationOnce = (o) => (a.push(o), e);
+  () => (e.mockClear(), r = void 0, a = [], e), e.mockRestore = () => (e.mockReset(), c.restore(), e), e.getMockImplementation = () => m ? r :
+  a.at(0) || r, e.mockImplementation = (o) => (r = o, c.willCall(i), e), e.mockImplementationOnce = (o) => (a.push(o), e);
   function O(o, u) {
     let k = r;
     r = o, c.willCall(i), m = !0;
@@ -172,7 +171,7 @@ function E(t) {
   e.mockRejectedValue = (o) => e.mockImplementation(() => Promise.reject(o)), e.mockRejectedValueOnce = (o) => e.mockImplementationOnce(() => Promise.
   reject(o)), Object.defineProperty(e, "mock", {
     get: /* @__PURE__ */ n(() => y, "get")
-  }), c.willCall(i), v.add(e), e;
+  }), c.willCall(i), x.add(e), e;
 }
 n(E, "enhanceSpy");
 function R(t) {
@@ -212,15 +211,15 @@ function V(t) {
 }
 n(V, "listenWhenCalled");
 function X() {
-  v.forEach((t) => t.mockClear());
+  x.forEach((t) => t.mockClear());
 }
 n(X, "clearAllMocks");
 function Z() {
-  v.forEach((t) => t.mockReset());
+  x.forEach((t) => t.mockReset());
 }
 n(Z, "resetAllMocks");
 function ee() {
-  v.forEach((t) => t.mockRestore());
+  x.forEach((t) => t.mockRestore());
 }
 n(ee, "restoreAllMocks");
 function te(t, e = {}) {
@@ -232,7 +231,7 @@ export {
   Q as fn,
   W as isMockFunction,
   te as mocked,
-  v as mocks,
+  x as mocks,
   H as onMockCall,
   Z as resetAllMocks,
   ee as restoreAllMocks,

package/dist/types/index.d.ts

@@ -1632,19 +1632,8 @@ interface API_Versions$1 {
     next?: API_Version;
     current?: API_Version;
 }
-type API_StatusValue = 'pending' | 'success' | 'error' | 'warn' | 'unknown';
-interface API_StatusObject {
-    status: API_StatusValue;
-    title: string;
-    description: string;
-    data?: any;
-    onClick?: () => void;
-    sidebarContextMenu?: boolean;
-}
-type API_StatusState = Record<StoryId, Record<string, API_StatusObject>>;
-type API_StatusUpdate = Record<StoryId, API_StatusObject | null>;
 type API_FilterFunction = (item: API_PreparedIndexEntry & {
-    status: Record<string, API_StatusObject | null>;
+    statuses: StatusByTypeId;
 }) => boolean;
 
 interface SetStoriesStory {
@@ -2538,4 +2527,273 @@ type SupportedFrameworks = 'angular' | 'ember' | 'experimental-nextjs-vite' | 'h
 
 type SupportedRenderers = 'react' | 'react-native' | 'vue3' | 'angular' | 'ember' | 'preact' | 'svelte' | 'qwik' | 'html' | 'web-components' | 'server' | 'solid' | 'nuxt';
 
-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_StatusObject, type API_StatusState, type API_StatusUpdate, type API_StatusValue, 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 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 TypescriptOptions, type V3CompatIndexEntry, type VersionCheck, type ViewMode, type WebRenderer };
+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>;
+type StatusesByStoryIdAndTypeId = Record<StoryId, StatusByTypeId>;
+interface Status {
+    value: StatusValue;
+    typeId: StatusTypeId;
+    storyId: StoryId;
+    title: string;
+    description: string;
+    data?: any;
+    sidebarContextMenu?: boolean;
+}
+type StatusStore = {
+    getAll: () => StatusesByStoryIdAndTypeId;
+    set: (statuses: Status[]) => void;
+    onAllStatusChange: (listener: (statuses: StatusesByStoryIdAndTypeId, previousStatuses: StatusesByStoryIdAndTypeId) => void) => () => void;
+    onSelect: (listener: (selectedStatuses: Status[]) => void) => () => void;
+    unset: (storyIds?: StoryId[]) => void;
+};
+type StatusStoreByTypeId = StatusStore & {
+    typeId: StatusTypeId;
+};
+type UseStatusStore = <T = StatusesByStoryIdAndTypeId>(selector?: (statuses: StatusesByStoryIdAndTypeId) => T) => T;
+
+type TestProviderState = 'test-provider-state:pending' | 'test-provider-state:running' | 'test-provider-state:succeeded' | 'test-provider-state:crashed';
+type TestProviderId = string;
+type TestProviderStateByProviderId = Record<TestProviderId, TestProviderState>;
+type BaseTestProviderStore = {
+    /**
+     * Notifies all listeners that settings have changed for test providers. The Storybook UI will
+     * highlight the test providers to tell the user that settings has changed.
+     */
+    settingsChanged: () => void;
+    /**
+     * Subscribe to clicks on the "Run All" button, that is supposed to trigger all test providers to
+     * run. Your test provider should do the "main thing" when this happens, similar to when the user
+     * triggers your test provider specifically.
+     *
+     * @example
+     *
+     * ```typescript
+     * // Subscribe to run-all events
+     * const unsubscribe = myTestProviderStore.onRunAll(() => {
+     *   await runAllMyTests();
+     * });
+     * ```
+     */
+    onRunAll: (listener: () => void) => () => void;
+    /**
+     * Subscribe to clicks on the "Clear All" button, that is supposed to clear all state from test
+     * providers. Storybook already clears all statuses, but if your test provider has more
+     * non-status-based state, you can use this to clear that here.
+     *
+     * @remarks
+     * The purpose of this is _not_ to clear your test provider's settings, only the test results.
+     * @example
+     *
+     * ```typescript
+     * // Subscribe to clear-all events
+     * const unsubscribe = myTestProviderStore.onClearAll(() => {
+     *   clearMyTestResults();
+     * });
+     *
+     * // Later, when no longer needed
+     * unsubscribe();
+     * ```
+     */
+    onClearAll: (listener: () => void) => () => void;
+};
+/**
+ * Represents a store for a specific test provider, identified by its unique ID. This store provides
+ * methods to manage the state of an individual test provider, including getting and setting its
+ * state, running operations with automatic state management, and accessing its unique identifier.
+ *
+ * Each test provider has its own instance of this store, allowing for independent state management
+ * across different test providers in the application.
+ *
+ * @example
+ *
+ * ```typescript
+ * // Get a store for a specific test provider
+ * const grammarStore = getTestProviderStoreById('addon-grammar');
+ *
+ * // Check the current state
+ * if (grammarStore.getState() === 'test-provider-state:pending') {
+ *   console.log('Grammar tests are ready to run');
+ * }
+ *
+ * // Run tests with automatic state management
+ * grammarStore.runWithState(async () => {
+ *   await runGrammarTests();
+ * });
+ * ```
+ *
+ * @see {@link TestProviderState} for possible state values
+ * @see {@link BaseTestProviderStore} for methods inherited from the base store
+ */
+type TestProviderStoreById = BaseTestProviderStore & {
+    /**
+     * Gets the current state of this specific test provider
+     *
+     * The state represents the current execution status of the test provider, which can be one of the
+     * following:
+     *
+     * - 'test-provider-state:pending': Tests have not been run yet
+     * - 'test-provider-state:running': Tests are currently running
+     * - 'test-provider-state:succeeded': Tests completed successfully
+     * - 'test-provider-state:crashed': Running tests failed or encountered an error
+     *
+     * Storybook UI will use this state to determine what to show in the UI.
+     *
+     * @remarks
+     * The 'test-provider-state:crashed' is meant to signify that the test run as a whole failed to
+     * execute for some reason. It should _not_ be set just because a number of tests failed, use
+     * statuses and the status store for that. See {@link TestStatusStore} for managing individual test
+     * statuses.
+     * @example
+     *
+     * ```typescript
+     * // Get the current state of a specific test provider
+     * const state = testProviderStore.getState();
+     *
+     * // Conditionally render UI based on the state
+     * const TestStatus = () => {
+     *   const state = testProviderStore.getState();
+     *
+     *   if (state === 'test-provider-state:running') {
+     *     return <Spinner />;
+     *   } else if (state === 'test-provider-state:succeeded') {
+     *     return <SuccessIcon />;
+     *   } else if (state === 'test-provider-state:crashed') {
+     *     return <ErrorIcon />;
+     *   }
+     *
+     *   return <PendingIcon />;
+     * };
+     * ```
+     */
+    getState: () => TestProviderState;
+    /**
+     * Sets the state of this specific test provider
+     *
+     * This method allows you to manually update the execution state of the test provider. It's
+     * typically used when you need to reflect the current status of test execution in the UI or when
+     * you want to programmatically control the test provider's state.
+     *
+     * Common use cases include:
+     *
+     * - Setting to 'running' when tests start
+     * - Setting to 'succeeded' when tests complete successfully
+     * - Setting to 'crashed' when tests fail or encounter errors
+     * - Setting to 'pending' to reset the state
+     *
+     * The state represents the current execution status of the test provider, which can be one of the
+     * following:
+     *
+     * - 'test-provider-state:pending': Tests have not been run yet
+     * - 'test-provider-state:running': Tests are currently running
+     * - 'test-provider-state:succeeded': Tests completed successfully
+     * - 'test-provider-state:crashed': Running tests failed or encountered an error
+     *
+     * Storybook UI will use this state to determine what to show in the UI.
+     *
+     * @remarks
+     * The 'test-provider-state:crashed' is meant to signify that the test run as a whole failed to
+     * execute for some reason. It should _not_ be set just because a number of tests failed, use
+     * statuses and the status store for that. See {@link TestStatusStore} for managing individual test
+     * statuses.
+     *
+     * For most use cases, consider using {@link runWithState} instead, which provides automatic state
+     * management and error handling during test execution.
+     * @example
+     *
+     * ```typescript
+     * // Update the state when tests start running
+     * const startTests = async () => {
+     *   testProviderStore.setState('test-provider-state:running');
+     *   ... run tests ...
+     * };
+     * ```
+     */
+    setState: (state: TestProviderState) => void;
+    /**
+     * Runs a callback and automatically updates the test provider's state with running, succeeded or
+     * crashed, depending on the end result.
+     *
+     * - Immediately changes the state to 'running'
+     * - If the callback returns/resolves, change the state to 'succeeded'.
+     * - If the callback throws an error/rejects, change the state to 'crashed'.
+     *
+     * This approach helps prevent state inconsistencies that might occur if exceptions are thrown
+     * during test execution.
+     *
+     * @example
+     *
+     * ```typescript
+     * // Run tests with automatic state management
+     * const runTests = () => {
+     *   testProviderStore.runWithState(async () => {
+     *     // The state is automatically set to 'running' before this callback
+     *
+     *     // Run tests here...
+     *     const results = await executeTests();
+     *   });
+     * };
+     * ```
+     */
+    runWithState: (callback: () => void | Promise<void>) => Promise<void>;
+    /** The unique identifier for this test provider */
+    testProviderId: TestProviderId;
+};
+/**
+ * React OR preview hook for accessing the state of _all_ test providers. This hook will only
+ * trigger a re-render when the state changes. It is recommended to pass the optional selector, to
+ * get more fine-grained control of re-renders.
+ *
+ * @example
+ *
+ * ```typescript
+ * const TestStatus = () => {
+ *   const state = useTestProviderStore((state) => state['my-test-provider']);
+ * };
+ * ```
+ */
+type UseTestProviderStore = <T = TestProviderStateByProviderId>(
+/**
+ * Optional selector function to extract or transform specific parts of the state
+ *
+ * @example
+ *
+ * ```typescript
+ * // Use the entire state
+ * const allProviderStates = useTestProviderStore();
+ *
+ * // Get state for a specific provider
+ * const myProviderState = useTestProviderStore((state) => state['my-test-provider']);
+ *
+ * // Get a count of providers in each state
+ * const statusCounts = useTestProviderStore((state) => {
+ *   const counts = {
+ *     pending: 0,
+ *     running: 0,
+ *     succeeded: 0,
+ *     crashed: 0,
+ *   };
+ *
+ *   Object.values(state).forEach((status) => {
+ *     if (status === 'test-provider-state:pending') counts.pending++;
+ *     else if (status === 'test-provider-state:running') counts.running++;
+ *     else if (status === 'test-provider-state:succeeded') counts.succeeded++;
+ *     else if (status === 'test-provider-state:crashed') counts.crashed++;
+ *   });
+ *
+ *   return counts;
+ * });
+ *
+ * // Check if all tests have completed
+ * const allTestsCompleted = useTestProviderStore((state) => {
+ *   return Object.values(state).every(
+ *     (status) =>
+ *       status === 'test-provider-state:succeeded' ||
+ *       status === 'test-provider-state:crashed'
+ *   );
+ * });
+ * ```
+ */
+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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "storybook",
-  "version": "9.0.0-alpha.5",
+  "version": "9.0.0-alpha.7",
   "description": "Storybook framework-agnostic API",
   "keywords": [
     "storybook"
@@ -22,6 +22,10 @@
   "sideEffects": false,
   "type": "module",
   "imports": {
+    "#manager-status-store": {
+      "storybook": "./src/manager/status-store.mock.ts",
+      "default": "./src/manager/status-store.ts"
+    },
     "#utils": {
       "storybook": "./template/stories/utils.mock.ts",
       "default": "./template/stories/utils.ts"
@@ -441,18 +445,15 @@
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/user-event": "^14.6.1",
     "@types/uuid": "^9.0.1",
-    "@vitest/expect": "2.0.5",
-    "@vitest/spy": "2.0.5",
+    "@vitest/expect": "3.0.9",
+    "@vitest/spy": "3.0.9",
     "better-opn": "^3.0.2",
-    "browser-assert": "^1.2.1",
     "esbuild": "^0.18.0 || ^0.19.0 || ^0.20.0 || ^0.21.0 || ^0.22.0 || ^0.23.0 || ^0.24.0 || ^0.25.0",
     "esbuild-register": "^3.5.0",
     "jsdoc-type-pratt-parser": "^4.0.0",
     "polished": "^4.2.2",
-    "process": "^0.11.10",
     "recast": "^0.23.5",
     "semver": "^7.6.2",
-    "util": "^0.12.5",
     "uuid": "^9.0.0",
     "ws": "^8.18.0"
   },
@@ -479,7 +480,7 @@
     "@radix-ui/react-scroll-area": "1.2.0-rc.7",
     "@radix-ui/react-slot": "^1.0.2",
     "@storybook/docs-mdx": "4.0.0-next.1",
-    "@storybook/icons": "^1.3.2",
+    "@storybook/icons": "^1.4.0",
     "@tanstack/react-virtual": "^3.3.0",
     "@testing-library/react": "^14.0.0",
     "@types/cross-spawn": "^6.0.2",
@@ -498,7 +499,7 @@
     "@types/react-transition-group": "^4",
     "@types/semver": "^7.5.8",
     "@types/ws": "^8",
-    "@vitest/utils": "^2.1.1",
+    "@vitest/utils": "^3.0.9",
     "@yarnpkg/esbuild-plugin-pnp": "^3.0.0-rc.10",
     "@yarnpkg/fslib": "2.10.3",
     "@yarnpkg/libzip": "2.3.0",
@@ -526,7 +527,6 @@
     "ejs": "^3.1.10",
     "es-toolkit": "^1.22.0",
     "esbuild": "^0.18.0 || ^0.19.0 || ^0.20.0 || ^0.21.0 || ^0.22.0 || ^0.23.0 || ^0.24.0 || ^0.25.0",
-    "esbuild-plugin-alias": "^0.2.1",
     "execa": "^8.0.1",
     "fd-package-json": "^1.2.0",
     "fetch-retry": "^6.0.0",