storybook 10.2.0-alpha.1 → 10.2.0-alpha.11

package/dist/preview-api/index.d.ts

@@ -1,7 +1,6 @@
 import { Channel } from 'storybook/internal/channels';
 import * as storybook_internal_types from 'storybook/internal/types';
 import { Args, Renderer, StoryContext, DecoratorApplicator, StoryId, Addon_StoryWrapper, PreparedStory, Globals, GlobalTypes, StoryIndex, StoryName, ComponentTitle, IndexEntry, Path, StoryAnnotationsOrFn, NormalizedComponentAnnotations, NormalizedStoryAnnotations, ModuleExports, CSFFile, NormalizedProjectAnnotations, ModuleExport, PreparedMeta, ProjectAnnotations, StepRunner, ComposedStoryFn, Store_CSFExports, ComposeStoryFn, LegacyStoryAnnotationsOrFn, ComponentAnnotations, NamedOrDefaultProjectAnnotations, ModuleImportFn, StoryContextForEnhancers, Parameters, StrictArgTypes, ArgTypesEnhancer, LegacyStoryFn, DecoratorFunction, PartialStoryFn, StoryContextUpdate, NormalizedStoriesSpecifier, Addon_StorySortParameterV7, DocsContextProps, ResolvedModuleExportType, ResolvedModuleExportFromType, StoryRenderOptions, RenderContextCallbacks, RenderToCanvas, ViewMode } from 'storybook/internal/types';
-import * as storybook_internal_csf from 'storybook/internal/csf';
 import { Story, Meta, CleanupCallback, StoryContext as StoryContext$1, Args as Args$1 } from 'storybook/internal/csf';
 import { RequestData, ArgTypesRequestPayload } from 'storybook/internal/core-events';
 
@@ -416,7 +415,7 @@ declare function createPlaywrightTest<TFixture extends {
 }>(baseTest: TFixture): TFixture;
 
 declare function getCsfFactoryAnnotations<TRenderer extends Renderer = Renderer, TArgs extends Args = Args>(story: LegacyStoryAnnotationsOrFn<TRenderer> | Story<Renderer>, meta?: ComponentAnnotations<TRenderer, TArgs> | Meta<Renderer>, projectAnnotations?: ProjectAnnotations<TRenderer>): {
-    story: storybook_internal_csf.StoryAnnotations<Renderer, unknown>;
+    story: storybook_internal_types.StoryAnnotations<Renderer, unknown>;
     meta: ComponentAnnotations<Renderer, unknown>;
     preview: storybook_internal_types.NormalizedProjectAnnotations<Renderer>;
 } | {
@@ -478,10 +477,10 @@ declare class StoryStore<TRenderer extends Renderer> {
     getStoryContext(story: PreparedStory<TRenderer>, { forceInitialArgs }?: {
         forceInitialArgs?: boolean | undefined;
     }): {
-        args: storybook_internal_csf.Args;
-        initialGlobals: storybook_internal_csf.Globals;
-        globalTypes: (storybook_internal_csf.GlobalTypes & storybook_internal_csf.StrictGlobalTypes) | undefined;
-        userGlobals: storybook_internal_csf.Globals;
+        args: storybook_internal_types.Args;
+        initialGlobals: storybook_internal_types.Globals;
+        globalTypes: (storybook_internal_types.GlobalTypes & storybook_internal_types.StrictGlobalTypes) | undefined;
+        userGlobals: storybook_internal_types.Globals;
         reporting: ReporterAPI;
         globals: {
             [x: string]: any;
@@ -493,31 +492,31 @@ declare class StoryStore<TRenderer extends Renderer> {
         subcomponents?: Record<string, (TRenderer & {
             T: any;
         })["component"]> | undefined;
-        parameters: storybook_internal_csf.Parameters;
-        initialArgs: storybook_internal_csf.Args;
-        argTypes: storybook_internal_csf.StrictArgTypes<storybook_internal_csf.Args>;
-        componentId: storybook_internal_csf.ComponentId;
-        title: storybook_internal_csf.ComponentTitle;
-        kind: storybook_internal_csf.ComponentTitle;
+        parameters: storybook_internal_types.Parameters;
+        initialArgs: storybook_internal_types.Args;
+        argTypes: storybook_internal_types.StrictArgTypes<storybook_internal_types.Args>;
+        componentId: storybook_internal_types.ComponentId;
+        title: storybook_internal_types.ComponentTitle;
+        kind: storybook_internal_types.ComponentTitle;
         id: StoryId;
-        name: storybook_internal_csf.StoryName;
-        story: storybook_internal_csf.StoryName;
-        tags: storybook_internal_csf.Tag[];
+        name: storybook_internal_types.StoryName;
+        story: storybook_internal_types.StoryName;
+        tags: storybook_internal_types.Tag[];
         moduleExport: storybook_internal_types.ModuleExport;
-        originalStoryFn: storybook_internal_csf.ArgsStoryFn<TRenderer>;
-        undecoratedStoryFn: storybook_internal_csf.LegacyStoryFn<TRenderer>;
-        unboundStoryFn: storybook_internal_csf.LegacyStoryFn<TRenderer>;
-        applyLoaders: (context: storybook_internal_csf.StoryContext<TRenderer, storybook_internal_csf.Args>) => Promise<Record<string, any>>;
-        applyBeforeEach: (context: storybook_internal_csf.StoryContext<TRenderer, storybook_internal_csf.Args>) => Promise<CleanupCallback[]>;
-        applyAfterEach: (context: storybook_internal_csf.StoryContext<TRenderer, storybook_internal_csf.Args>) => Promise<void>;
-        playFunction?: ((context: storybook_internal_csf.StoryContext<TRenderer, storybook_internal_csf.Args>) => Promise<void> | void) | undefined;
-        runStep: storybook_internal_csf.StepRunner<TRenderer>;
-        mount: (context: storybook_internal_csf.StoryContext<TRenderer, storybook_internal_csf.Args>) => () => Promise<storybook_internal_csf.Canvas>;
+        originalStoryFn: storybook_internal_types.ArgsStoryFn<TRenderer>;
+        undecoratedStoryFn: storybook_internal_types.LegacyStoryFn<TRenderer>;
+        unboundStoryFn: storybook_internal_types.LegacyStoryFn<TRenderer>;
+        applyLoaders: (context: storybook_internal_types.StoryContext<TRenderer, storybook_internal_types.Args>) => Promise<Record<string, any>>;
+        applyBeforeEach: (context: storybook_internal_types.StoryContext<TRenderer, storybook_internal_types.Args>) => Promise<CleanupCallback[]>;
+        applyAfterEach: (context: storybook_internal_types.StoryContext<TRenderer, storybook_internal_types.Args>) => Promise<void>;
+        playFunction?: ((context: storybook_internal_types.StoryContext<TRenderer, storybook_internal_types.Args>) => Promise<void> | void) | undefined;
+        runStep: storybook_internal_types.StepRunner<TRenderer>;
+        mount: (context: storybook_internal_types.StoryContext<TRenderer, storybook_internal_types.Args>) => () => Promise<storybook_internal_types.Canvas>;
         testingLibraryRender?: (...args: never[]) => unknown;
         renderToCanvas?: storybook_internal_types.RenderToCanvas<TRenderer> | undefined;
         usesMount: boolean;
-        storyGlobals: storybook_internal_csf.Globals;
-    } & Pick<storybook_internal_csf.StoryContextForLoaders<Renderer, storybook_internal_csf.Args>, "allArgs" | "argsByTarget" | "unmappedArgs">;
+        storyGlobals: storybook_internal_types.Globals;
+    } & Pick<storybook_internal_types.StoryContextForLoaders<Renderer, storybook_internal_types.Args>, "allArgs" | "argsByTarget" | "unmappedArgs">;
     addCleanupCallbacks(story: PreparedStory<TRenderer>, ...callbacks: CleanupCallback[]): void;
     cleanupStory(story: PreparedStory<TRenderer>): Promise<void>;
     extract(options?: {
@@ -533,7 +532,7 @@ declare class StoryStore<TRenderer extends Renderer> {
 declare const combineParameters: (...parameterSets: (Parameters | undefined)[]) => Parameters;
 
 type PropDescriptor = string[] | RegExp;
-declare const filterArgTypes: (argTypes: StrictArgTypes, include?: PropDescriptor, exclude?: PropDescriptor) => Partial<StrictArgTypes<storybook_internal_csf.Args>>;
+declare const filterArgTypes: (argTypes: StrictArgTypes, include?: PropDescriptor, exclude?: PropDescriptor) => Partial<StrictArgTypes<storybook_internal_types.Args>>;
 
 declare const inferControls: ArgTypesEnhancer<Renderer>;
 
@@ -583,10 +582,10 @@ declare class DocsContext<TRenderer extends Renderer> implements DocsContextProp
     getStoryContext: (story: PreparedStory<TRenderer>) => {
         loaded: {};
         viewMode: string;
-        args: storybook_internal_csf.Args;
-        initialGlobals: storybook_internal_csf.Globals;
-        globalTypes: (storybook_internal_csf.GlobalTypes & storybook_internal_csf.StrictGlobalTypes) | undefined;
-        userGlobals: storybook_internal_csf.Globals;
+        args: storybook_internal_types.Args;
+        initialGlobals: storybook_internal_types.Globals;
+        globalTypes: (storybook_internal_types.GlobalTypes & storybook_internal_types.StrictGlobalTypes) | undefined;
+        userGlobals: storybook_internal_types.Globals;
         reporting: ReporterAPI;
         globals: {
             [x: string]: any;
@@ -598,30 +597,30 @@ declare class DocsContext<TRenderer extends Renderer> implements DocsContextProp
         subcomponents?: Record<string, (TRenderer & {
             T: any;
         })["component"]> | undefined;
-        parameters: storybook_internal_csf.Parameters;
-        initialArgs: storybook_internal_csf.Args;
-        argTypes: storybook_internal_csf.StrictArgTypes<storybook_internal_csf.Args>;
-        componentId: storybook_internal_csf.ComponentId;
-        title: storybook_internal_csf.ComponentTitle;
-        kind: storybook_internal_csf.ComponentTitle;
+        parameters: storybook_internal_types.Parameters;
+        initialArgs: storybook_internal_types.Args;
+        argTypes: storybook_internal_types.StrictArgTypes<storybook_internal_types.Args>;
+        componentId: storybook_internal_types.ComponentId;
+        title: storybook_internal_types.ComponentTitle;
+        kind: storybook_internal_types.ComponentTitle;
         id: StoryId;
         name: StoryName;
         story: StoryName;
-        tags: storybook_internal_csf.Tag[];
+        tags: storybook_internal_types.Tag[];
         moduleExport: ModuleExport;
-        originalStoryFn: storybook_internal_csf.ArgsStoryFn<TRenderer>;
-        undecoratedStoryFn: storybook_internal_csf.LegacyStoryFn<TRenderer>;
-        unboundStoryFn: storybook_internal_csf.LegacyStoryFn<TRenderer>;
-        applyLoaders: (context: storybook_internal_csf.StoryContext<TRenderer, storybook_internal_csf.Args>) => Promise<Record<string, any>>;
-        applyBeforeEach: (context: storybook_internal_csf.StoryContext<TRenderer, storybook_internal_csf.Args>) => Promise<storybook_internal_csf.CleanupCallback[]>;
-        applyAfterEach: (context: storybook_internal_csf.StoryContext<TRenderer, storybook_internal_csf.Args>) => Promise<void>;
-        playFunction?: ((context: storybook_internal_csf.StoryContext<TRenderer, storybook_internal_csf.Args>) => Promise<void> | void) | undefined;
-        runStep: storybook_internal_csf.StepRunner<TRenderer>;
-        mount: (context: storybook_internal_csf.StoryContext<TRenderer, storybook_internal_csf.Args>) => () => Promise<storybook_internal_csf.Canvas>;
+        originalStoryFn: storybook_internal_types.ArgsStoryFn<TRenderer>;
+        undecoratedStoryFn: storybook_internal_types.LegacyStoryFn<TRenderer>;
+        unboundStoryFn: storybook_internal_types.LegacyStoryFn<TRenderer>;
+        applyLoaders: (context: storybook_internal_types.StoryContext<TRenderer, storybook_internal_types.Args>) => Promise<Record<string, any>>;
+        applyBeforeEach: (context: storybook_internal_types.StoryContext<TRenderer, storybook_internal_types.Args>) => Promise<storybook_internal_types.CleanupCallback[]>;
+        applyAfterEach: (context: storybook_internal_types.StoryContext<TRenderer, storybook_internal_types.Args>) => Promise<void>;
+        playFunction?: ((context: storybook_internal_types.StoryContext<TRenderer, storybook_internal_types.Args>) => Promise<void> | void) | undefined;
+        runStep: storybook_internal_types.StepRunner<TRenderer>;
+        mount: (context: storybook_internal_types.StoryContext<TRenderer, storybook_internal_types.Args>) => () => Promise<storybook_internal_types.Canvas>;
         testingLibraryRender?: (...args: never[]) => unknown;
         renderToCanvas?: storybook_internal_types.RenderToCanvas<TRenderer> | undefined;
         usesMount: boolean;
-        storyGlobals: storybook_internal_csf.Globals;
+        storyGlobals: storybook_internal_types.Globals;
         allArgs: any;
         argsByTarget: any;
         unmappedArgs: any;
@@ -843,7 +842,7 @@ declare class Preview<TRenderer extends Renderer> {
     }): {
         args: Args;
         initialGlobals: Globals;
-        globalTypes: (storybook_internal_csf.GlobalTypes & storybook_internal_csf.StrictGlobalTypes) | undefined;
+        globalTypes: (storybook_internal_types.GlobalTypes & storybook_internal_types.StrictGlobalTypes) | undefined;
         userGlobals: Globals;
         reporting: ReporterAPI;
         globals: {
@@ -856,34 +855,34 @@ declare class Preview<TRenderer extends Renderer> {
         subcomponents?: Record<string, (TRenderer & {
             T: any;
         })["component"]> | undefined;
-        parameters: storybook_internal_csf.Parameters;
+        parameters: storybook_internal_types.Parameters;
         initialArgs: Args;
-        argTypes: storybook_internal_csf.StrictArgTypes<Args>;
-        componentId: storybook_internal_csf.ComponentId;
-        title: storybook_internal_csf.ComponentTitle;
-        kind: storybook_internal_csf.ComponentTitle;
+        argTypes: storybook_internal_types.StrictArgTypes<Args>;
+        componentId: storybook_internal_types.ComponentId;
+        title: storybook_internal_types.ComponentTitle;
+        kind: storybook_internal_types.ComponentTitle;
         id: StoryId;
-        name: storybook_internal_csf.StoryName;
-        story: storybook_internal_csf.StoryName;
-        tags: storybook_internal_csf.Tag[];
+        name: storybook_internal_types.StoryName;
+        story: storybook_internal_types.StoryName;
+        tags: storybook_internal_types.Tag[];
         moduleExport: storybook_internal_types.ModuleExport;
-        originalStoryFn: storybook_internal_csf.ArgsStoryFn<TRenderer>;
-        undecoratedStoryFn: storybook_internal_csf.LegacyStoryFn<TRenderer>;
-        unboundStoryFn: storybook_internal_csf.LegacyStoryFn<TRenderer>;
-        applyLoaders: (context: storybook_internal_csf.StoryContext<TRenderer, Args>) => Promise<Record<string, any>>;
-        applyBeforeEach: (context: storybook_internal_csf.StoryContext<TRenderer, Args>) => Promise<CleanupCallback[]>;
-        applyAfterEach: (context: storybook_internal_csf.StoryContext<TRenderer, Args>) => Promise<void>;
-        playFunction?: ((context: storybook_internal_csf.StoryContext<TRenderer, Args>) => Promise<void> | void) | undefined;
-        runStep: storybook_internal_csf.StepRunner<TRenderer>;
-        mount: (context: storybook_internal_csf.StoryContext<TRenderer, Args>) => () => Promise<storybook_internal_csf.Canvas>;
+        originalStoryFn: storybook_internal_types.ArgsStoryFn<TRenderer>;
+        undecoratedStoryFn: storybook_internal_types.LegacyStoryFn<TRenderer>;
+        unboundStoryFn: storybook_internal_types.LegacyStoryFn<TRenderer>;
+        applyLoaders: (context: storybook_internal_types.StoryContext<TRenderer, Args>) => Promise<Record<string, any>>;
+        applyBeforeEach: (context: storybook_internal_types.StoryContext<TRenderer, Args>) => Promise<CleanupCallback[]>;
+        applyAfterEach: (context: storybook_internal_types.StoryContext<TRenderer, Args>) => Promise<void>;
+        playFunction?: ((context: storybook_internal_types.StoryContext<TRenderer, Args>) => Promise<void> | void) | undefined;
+        runStep: storybook_internal_types.StepRunner<TRenderer>;
+        mount: (context: storybook_internal_types.StoryContext<TRenderer, Args>) => () => Promise<storybook_internal_types.Canvas>;
         testingLibraryRender?: (...args: never[]) => unknown;
         renderToCanvas?: RenderToCanvas<TRenderer> | undefined;
         usesMount: boolean;
         storyGlobals: Globals;
-    } & Pick<storybook_internal_csf.StoryContextForLoaders<Renderer, Args>, "allArgs" | "argsByTarget" | "unmappedArgs">;
+    } & Pick<storybook_internal_types.StoryContextForLoaders<Renderer, Args>, "allArgs" | "argsByTarget" | "unmappedArgs">;
     extract(options?: {
         includeDocsOnly: boolean;
-    }): Promise<Record<string, storybook_internal_csf.StoryContextForEnhancers<TRenderer, Args>>>;
+    }): Promise<Record<string, storybook_internal_types.StoryContextForEnhancers<TRenderer, Args>>>;
     renderPreviewEntryError(reason: string, err: Error): void;
 }
 

package/dist/preview-api/index.js

@@ -48,23 +48,23 @@ import {
   useStoryContext,
   userOrAutoTitle,
   userOrAutoTitleFromSpecifier
-} from "../_browser-chunks/chunk-SS2NHR7W.js";
+} from "../_browser-chunks/chunk-RBABWY22.js";
 import {
   pauseAnimations,
   waitForAnimations
-} from "../_browser-chunks/chunk-IPA5A322.js";
-import "../_browser-chunks/chunk-3OXGAGBE.js";
+} from "../_browser-chunks/chunk-MEXTPDJG.js";
+import "../_browser-chunks/chunk-XLJZ7AOP.js";
 import {
   combineParameters
-} from "../_browser-chunks/chunk-VYJQ7RU5.js";
-import "../_browser-chunks/chunk-3IAH5M2U.js";
-import "../_browser-chunks/chunk-QKODTO7K.js";
-import "../_browser-chunks/chunk-AS2HQEYC.js";
-import "../_browser-chunks/chunk-YKE5S47A.js";
-import "../_browser-chunks/chunk-AIOS4NGK.js";
-import "../_browser-chunks/chunk-GFLS4VP3.js";
-import "../_browser-chunks/chunk-WJYERY3R.js";
-import "../_browser-chunks/chunk-JP7NCOJX.js";
+} from "../_browser-chunks/chunk-G4M6MXF4.js";
+import "../_browser-chunks/chunk-IYCKG66Y.js";
+import "../_browser-chunks/chunk-NZMVUW5T.js";
+import "../_browser-chunks/chunk-IWQGIXJS.js";
+import "../_browser-chunks/chunk-V2VKKSMQ.js";
+import "../_browser-chunks/chunk-SWJP5COI.js";
+import "../_browser-chunks/chunk-LCHBOIHN.js";
+import "../_browser-chunks/chunk-ZCFV7BZB.js";
+import "../_browser-chunks/chunk-3LY4VQVK.js";
 import "../_browser-chunks/chunk-A242L54C.js";
 export {
   DocsContext,

package/dist/preview-errors.d.ts

@@ -570,6 +570,25 @@ declare abstract class StorybookError extends Error {
     /** Overrides the default `Error.name` property in the format: SB_<CATEGORY>_<CODE>. */
     get name(): string;
     set name(name: string);
+    /**
+     * A collection of sub errors which relate to a parent error.
+     *
+     * Sub-errors are used to represent multiple related errors that occurred together. When a
+     * StorybookError with sub-errors is sent to telemetry, both the parent error and each sub-error
+     * are sent as separate telemetry events. This allows for better error tracking and debugging.
+     *
+     * @example
+     *
+     * ```ts
+     * const error1 = new SomeError();
+     * const error2 = new AnotherError();
+     * const parentError = new ParentError({
+     *   // ... other props
+     *   subErrors: [error1, error2],
+     * });
+     * ```
+     */
+    subErrors: StorybookError[];
     constructor(props: {
         category: string;
         code: number;
@@ -577,6 +596,11 @@ declare abstract class StorybookError extends Error {
         documentation?: boolean | string | string[];
         isHandledError?: boolean;
         name: string;
+        /**
+         * Optional array of sub-errors that are related to this error. When this error is sent to
+         * telemetry, each sub-error will be sent as a separate event.
+         */
+        subErrors?: StorybookError[];
     });
     /** Generates the error message along with additional documentation link (if applicable). */
     static getFullMessage({ documentation, code, category, message, }: ConstructorParameters<typeof StorybookError>[0]): string;

package/dist/preview-errors.js

@@ -20,9 +20,9 @@ import {
   StoryStoreAccessedBeforeInitializationError,
   UnknownArgTypesError,
   UnsupportedViewportDimensionError
-} from "./_browser-chunks/chunk-2XZMBGTA.js";
-import "./_browser-chunks/chunk-FQ7SLVLR.js";
-import "./_browser-chunks/chunk-JP7NCOJX.js";
+} from "./_browser-chunks/chunk-POMIZRJL.js";
+import "./_browser-chunks/chunk-JVRDBUUP.js";
+import "./_browser-chunks/chunk-3LY4VQVK.js";
 import "./_browser-chunks/chunk-A242L54C.js";
 export {
   CalledExtractOnStoreError,

package/dist/router/index.js

@@ -1,19 +1,19 @@
 import {
   require_main
-} from "../_browser-chunks/chunk-3OXGAGBE.js";
+} from "../_browser-chunks/chunk-XLJZ7AOP.js";
 import {
   isEqual
-} from "../_browser-chunks/chunk-3IAH5M2U.js";
-import "../_browser-chunks/chunk-QKODTO7K.js";
+} from "../_browser-chunks/chunk-IYCKG66Y.js";
+import "../_browser-chunks/chunk-NZMVUW5T.js";
 import {
   isPlainObject
-} from "../_browser-chunks/chunk-GFLS4VP3.js";
+} from "../_browser-chunks/chunk-LCHBOIHN.js";
 import {
   require_memoizerific
-} from "../_browser-chunks/chunk-WJYERY3R.js";
+} from "../_browser-chunks/chunk-ZCFV7BZB.js";
 import {
   dedent
-} from "../_browser-chunks/chunk-JP7NCOJX.js";
+} from "../_browser-chunks/chunk-3LY4VQVK.js";
 import {
   __toESM
 } from "../_browser-chunks/chunk-A242L54C.js";
@@ -102,13 +102,13 @@ var splitPathRegex = /\/([^/]+)\/(?:(.*)_)?([^/]+)?/, parsePath = (0, import_mem
 import React3, { useCallback as useCallback3 } from "react";
 import { global } from "@storybook/global";
 
-// ../node_modules/react-router-dom/dist/index.js
+// ../../node_modules/react-router-dom/dist/index.js
 import * as React2 from "react";
 
-// ../node_modules/react-router/dist/index.js
+// ../../node_modules/react-router/dist/index.js
 import * as React from "react";
 
-// ../node_modules/@remix-run/router/dist/router.js
+// ../../node_modules/@remix-run/router/dist/router.js
 function _extends() {
   return _extends = Object.assign ? Object.assign.bind() : function(target) {
     for (var i = 1; i < arguments.length; i++) {
@@ -358,7 +358,7 @@ function isRouteErrorResponse(error) {
 var validMutationMethodsArr = ["post", "put", "patch", "delete"], validMutationMethods = new Set(validMutationMethodsArr), validRequestMethodsArr = ["get", ...validMutationMethodsArr], validRequestMethods = new Set(validRequestMethodsArr);
 var UNSAFE_DEFERRED_SYMBOL = Symbol("deferred");
 
-// ../node_modules/react-router/dist/index.js
+// ../../node_modules/react-router/dist/index.js
 function _extends2() {
   return _extends2 = Object.assign ? Object.assign.bind() : function(target) {
     for (var i = 1; i < arguments.length; i++) {
@@ -607,7 +607,7 @@ var AwaitRenderStatus = (function(AwaitRenderStatus2) {
 })(AwaitRenderStatus || {}), neverSettledPromise = new Promise(() => {
 });
 
-// ../node_modules/react-router-dom/dist/index.js
+// ../../node_modules/react-router-dom/dist/index.js
 function _extends3() {
   return _extends3 = Object.assign ? Object.assign.bind() : function(target) {
     for (var i = 1; i < arguments.length; i++) {

package/dist/server-errors.d.ts

@@ -570,6 +570,25 @@ declare abstract class StorybookError extends Error {
     /** Overrides the default `Error.name` property in the format: SB_<CATEGORY>_<CODE>. */
     get name(): string;
     set name(name: string);
+    /**
+     * A collection of sub errors which relate to a parent error.
+     *
+     * Sub-errors are used to represent multiple related errors that occurred together. When a
+     * StorybookError with sub-errors is sent to telemetry, both the parent error and each sub-error
+     * are sent as separate telemetry events. This allows for better error tracking and debugging.
+     *
+     * @example
+     *
+     * ```ts
+     * const error1 = new SomeError();
+     * const error2 = new AnotherError();
+     * const parentError = new ParentError({
+     *   // ... other props
+     *   subErrors: [error1, error2],
+     * });
+     * ```
+     */
+    subErrors: StorybookError[];
     constructor(props: {
         category: string;
         code: number;
@@ -577,6 +596,11 @@ declare abstract class StorybookError extends Error {
         documentation?: boolean | string | string[];
         isHandledError?: boolean;
         name: string;
+        /**
+         * Optional array of sub-errors that are related to this error. When this error is sent to
+         * telemetry, each sub-error will be sent as a separate event.
+         */
+        subErrors?: StorybookError[];
     });
     /** Generates the error message along with additional documentation link (if applicable). */
     static getFullMessage({ documentation, code, category, message, }: ConstructorParameters<typeof StorybookError>[0]): string;
@@ -787,12 +811,44 @@ declare class AddonVitestPostinstallPrerequisiteCheckError extends StorybookErro
         reasons: string[];
     });
 }
+declare class AddonVitestPostinstallFailedAddonA11yError extends StorybookError {
+    data: {
+        error: unknown | Error;
+    };
+    constructor(data: {
+        error: unknown | Error;
+    });
+}
+declare class AddonVitestPostinstallExistingSetupFileError extends StorybookError {
+    data: {
+        filePath: string;
+    };
+    constructor(data: {
+        filePath: string;
+    });
+}
+declare class AddonVitestPostinstallWorkspaceUpdateError extends StorybookError {
+    data: {
+        filePath: string;
+    };
+    constructor(data: {
+        filePath: string;
+    });
+}
+declare class AddonVitestPostinstallConfigUpdateError extends StorybookError {
+    data: {
+        filePath: string;
+    };
+    constructor(data: {
+        filePath: string;
+    });
+}
 declare class AddonVitestPostinstallError extends StorybookError {
     data: {
-        errors: string[];
+        errors: StorybookError[];
     };
     constructor(data: {
-        errors: string[];
+        errors: StorybookError[];
     });
 }
 declare class UpgradeStorybookToLowerVersionError extends StorybookError {
@@ -853,4 +909,4 @@ declare class AutomigrateError extends StorybookError {
     });
 }
 
-export { AddonVitestPostinstallError, AddonVitestPostinstallPrerequisiteCheckError, AngularLegacyBuildOptionsError, AutomigrateError, Category, CommonJsConfigNotSupportedError, ConflictingStaticDirConfigError, CouldNotEvaluateFrameworkError, CriticalPresetLoadError, FindPackageVersionsError, GenerateNewProjectOnInitError, GoogleFontsDownloadError, GoogleFontsLoadingError, IncompatiblePostCssConfigError, InvalidFrameworkNameError, InvalidStoriesEntryError, MainFileEvaluationError, MainFileMissingError, MissingAngularJsonError, MissingBuilderError, MissingFrameworkFieldError, NoMatchingExportError, NoStatsForViteDevError, NxProjectDetectedError, SavingGlobalSettingsFileError, StatusTypeIdMismatchError, SvelteViteWithSvelteKitError, UpgradeStorybookToLowerVersionError, UpgradeStorybookUnknownCurrentVersionError, WebpackCompilationError, WebpackInvocationError, WebpackMissingStatsError };
+export { AddonVitestPostinstallConfigUpdateError, AddonVitestPostinstallError, AddonVitestPostinstallExistingSetupFileError, AddonVitestPostinstallFailedAddonA11yError, AddonVitestPostinstallPrerequisiteCheckError, AddonVitestPostinstallWorkspaceUpdateError, AngularLegacyBuildOptionsError, AutomigrateError, Category, CommonJsConfigNotSupportedError, ConflictingStaticDirConfigError, CouldNotEvaluateFrameworkError, CriticalPresetLoadError, FindPackageVersionsError, GenerateNewProjectOnInitError, GoogleFontsDownloadError, GoogleFontsLoadingError, IncompatiblePostCssConfigError, InvalidFrameworkNameError, InvalidStoriesEntryError, MainFileEvaluationError, MainFileMissingError, MissingAngularJsonError, MissingBuilderError, MissingFrameworkFieldError, NoMatchingExportError, NoStatsForViteDevError, NxProjectDetectedError, SavingGlobalSettingsFileError, StatusTypeIdMismatchError, StorybookError, SvelteViteWithSvelteKitError, UpgradeStorybookToLowerVersionError, UpgradeStorybookUnknownCurrentVersionError, WebpackCompilationError, WebpackInvocationError, WebpackMissingStatsError };

package/dist/server-errors.js

@@ -1,17 +1,21 @@
-import CJS_COMPAT_NODE_URL_2297kyafub from 'node:url';
-import CJS_COMPAT_NODE_PATH_2297kyafub from 'node:path';
-import CJS_COMPAT_NODE_MODULE_2297kyafub from "node:module";
+import CJS_COMPAT_NODE_URL_aucdos01fk5 from 'node:url';
+import CJS_COMPAT_NODE_PATH_aucdos01fk5 from 'node:path';
+import CJS_COMPAT_NODE_MODULE_aucdos01fk5 from "node:module";
 
-var __filename = CJS_COMPAT_NODE_URL_2297kyafub.fileURLToPath(import.meta.url);
-var __dirname = CJS_COMPAT_NODE_PATH_2297kyafub.dirname(__filename);
-var require = CJS_COMPAT_NODE_MODULE_2297kyafub.createRequire(import.meta.url);
+var __filename = CJS_COMPAT_NODE_URL_aucdos01fk5.fileURLToPath(import.meta.url);
+var __dirname = CJS_COMPAT_NODE_PATH_aucdos01fk5.dirname(__filename);
+var require = CJS_COMPAT_NODE_MODULE_aucdos01fk5.createRequire(import.meta.url);
 
 // ------------------------------------------------------------
 // end of CJS compatibility banner, injected by Storybook's esbuild configuration
 // ------------------------------------------------------------
 import {
+  AddonVitestPostinstallConfigUpdateError,
   AddonVitestPostinstallError,
+  AddonVitestPostinstallExistingSetupFileError,
+  AddonVitestPostinstallFailedAddonA11yError,
   AddonVitestPostinstallPrerequisiteCheckError,
+  AddonVitestPostinstallWorkspaceUpdateError,
   AngularLegacyBuildOptionsError,
   AutomigrateError,
   Category,
@@ -42,14 +46,20 @@ import {
   WebpackCompilationError,
   WebpackInvocationError,
   WebpackMissingStatsError
-} from "./_node-chunks/chunk-ET4VMMZG.js";
-import "./_node-chunks/chunk-ZI2RAI3I.js";
-import "./_node-chunks/chunk-AJUO2ZU3.js";
-import "./_node-chunks/chunk-GYZQMMTN.js";
-import "./_node-chunks/chunk-5NWCBUGD.js";
+} from "./_node-chunks/chunk-TOMGRF4A.js";
+import {
+  StorybookError
+} from "./_node-chunks/chunk-2DZGIXSN.js";
+import "./_node-chunks/chunk-URWJMVZI.js";
+import "./_node-chunks/chunk-WQ4WQYSZ.js";
+import "./_node-chunks/chunk-FWVZUHZX.js";
 export {
+  AddonVitestPostinstallConfigUpdateError,
   AddonVitestPostinstallError,
+  AddonVitestPostinstallExistingSetupFileError,
+  AddonVitestPostinstallFailedAddonA11yError,
   AddonVitestPostinstallPrerequisiteCheckError,
+  AddonVitestPostinstallWorkspaceUpdateError,
   AngularLegacyBuildOptionsError,
   AutomigrateError,
   Category,
@@ -74,6 +84,7 @@ export {
   NxProjectDetectedError,
   SavingGlobalSettingsFileError,
   StatusTypeIdMismatchError,
+  StorybookError,
   SvelteViteWithSvelteKitError,
   UpgradeStorybookToLowerVersionError,
   UpgradeStorybookUnknownCurrentVersionError,

package/dist/telemetry/index.d.ts

@@ -32,7 +32,7 @@ declare const monorepoConfigs: {
 };
 type MonorepoType = keyof typeof monorepoConfigs | 'Workspaces' | undefined;
 
-type EventType = 'boot' | 'add' | 'dev' | 'build' | 'index' | 'upgrade' | 'multi-upgrade' | 'init' | 'init-step' | 'scaffolded-empty' | 'browser' | 'canceled' | 'error' | 'error-metadata' | 'version-update' | 'core-config' | 'remove' | 'save-story' | 'create-new-story-file' | 'create-new-story-file-search' | 'open-in-editor' | 'testing-module-watch-mode' | 'testing-module-completed-report' | 'testing-module-crash-report' | 'addon-test' | 'test-run' | 'addon-onboarding' | 'onboarding-survey' | 'onboarding-checklist' | 'mocking' | 'automigrate' | 'migrate' | 'preview-first-load' | 'doctor';
+type EventType = 'boot' | 'add' | 'dev' | 'build' | 'index' | 'upgrade' | 'multi-upgrade' | 'init' | 'init-step' | 'scaffolded-empty' | 'browser' | 'canceled' | 'error' | 'error-metadata' | 'version-update' | 'core-config' | 'remove' | 'save-story' | 'create-new-story-file' | 'create-new-story-file-search' | 'open-in-editor' | 'testing-module-watch-mode' | 'testing-module-completed-report' | 'testing-module-crash-report' | 'addon-test' | 'test-run' | 'addon-onboarding' | 'onboarding-survey' | 'onboarding-checklist-muted' | 'onboarding-checklist-status' | 'mocking' | 'automigrate' | 'migrate' | 'preview-first-load' | 'doctor';
 interface Dependency {
     version: string | undefined;
     versionSpecifier?: string;
@@ -166,7 +166,14 @@ interface UpgradeSummary {
     eventId?: string;
     sessionId?: string;
 }
-declare const getPrecedingUpgrade: (events?: any) => Promise<UpgradeSummary | undefined>;
+interface CacheEntry {
+    timestamp: number;
+    body: TelemetryEvent;
+}
+declare const getLastEvents: () => Promise<Record<EventType, CacheEntry>>;
+declare const getPrecedingUpgrade: (events?: Partial<Record<EventType, CacheEntry>> | undefined) => Promise<UpgradeSummary | undefined>;
+
+declare const getSessionId: () => Promise<string>;
 
 declare const addToGlobalContext: (key: string, value: any) => void;
 
@@ -174,4 +181,4 @@ declare const addToGlobalContext: (key: string, value: any) => void;
 declare const isExampleStoryId: (storyId: string) => boolean;
 declare const telemetry: (eventType: EventType, payload?: Payload, options?: Partial<Options>) => Promise<void>;
 
-export { type Context, type Dependency, ErrorCollector, type EventType, type IErrorWithStdErrAndStdOut, type InitPayload, type Options, type Payload, type StorybookAddon, type StorybookMetadata, type TelemetryData, type TelemetryEvent, addToGlobalContext, cleanPaths, computeStorybookMetadata, getPrecedingUpgrade, getStorybookMetadata, isExampleStoryId, metaFrameworks, oneWayHash, removeAnsiEscapeCodes, sanitizeAddonName, sanitizeError, telemetry };
+export { type CacheEntry, type Context, type Dependency, ErrorCollector, type EventType, type IErrorWithStdErrAndStdOut, type InitPayload, type Options, type Payload, type StorybookAddon, type StorybookMetadata, type TelemetryData, type TelemetryEvent, addToGlobalContext, cleanPaths, computeStorybookMetadata, getLastEvents, getPrecedingUpgrade, getSessionId, getStorybookMetadata, isExampleStoryId, metaFrameworks, oneWayHash, removeAnsiEscapeCodes, sanitizeAddonName, sanitizeError, telemetry };

package/dist/telemetry/index.js

@@ -1,10 +1,10 @@
-import CJS_COMPAT_NODE_URL_2297kyafub from 'node:url';
-import CJS_COMPAT_NODE_PATH_2297kyafub from 'node:path';
-import CJS_COMPAT_NODE_MODULE_2297kyafub from "node:module";
+import CJS_COMPAT_NODE_URL_aucdos01fk5 from 'node:url';
+import CJS_COMPAT_NODE_PATH_aucdos01fk5 from 'node:path';
+import CJS_COMPAT_NODE_MODULE_aucdos01fk5 from "node:module";
 
-var __filename = CJS_COMPAT_NODE_URL_2297kyafub.fileURLToPath(import.meta.url);
-var __dirname = CJS_COMPAT_NODE_PATH_2297kyafub.dirname(__filename);
-var require = CJS_COMPAT_NODE_MODULE_2297kyafub.createRequire(import.meta.url);
+var __filename = CJS_COMPAT_NODE_URL_aucdos01fk5.fileURLToPath(import.meta.url);
+var __dirname = CJS_COMPAT_NODE_PATH_aucdos01fk5.dirname(__filename);
+var require = CJS_COMPAT_NODE_MODULE_aucdos01fk5.createRequire(import.meta.url);
 
 // ------------------------------------------------------------
 // end of CJS compatibility banner, injected by Storybook's esbuild configuration
@@ -14,6 +14,9 @@ import {
   addToGlobalContext,
   cleanPaths,
   computeStorybookMetadata,
+  getLastEvents,
+  getPrecedingUpgrade,
+  getSessionId,
   getStorybookMetadata,
   isExampleStoryId,
   metaFrameworks,
@@ -22,31 +25,30 @@ import {
   sanitizeAddonName,
   sanitizeError,
   telemetry
-} from "../_node-chunks/chunk-F7377GT2.js";
-import "../_node-chunks/chunk-NEENMS4J.js";
-import "../_node-chunks/chunk-CLNMK7MP.js";
-import "../_node-chunks/chunk-COQ27OZ3.js";
-import "../_node-chunks/chunk-KMTK5W6O.js";
-import "../_node-chunks/chunk-4BQMSZKI.js";
-import {
-  getPrecedingUpgrade
-} from "../_node-chunks/chunk-VR5LMO3F.js";
-import "../_node-chunks/chunk-VFTNRF5X.js";
-import "../_node-chunks/chunk-4EZYJUAC.js";
-import "../_node-chunks/chunk-SR5ZYD7K.js";
-import "../_node-chunks/chunk-TP6ICLTL.js";
-import "../_node-chunks/chunk-PGFQADZC.js";
-import "../_node-chunks/chunk-FTR6MHOX.js";
-import "../_node-chunks/chunk-MC2R4DSD.js";
-import "../_node-chunks/chunk-AJUO2ZU3.js";
-import "../_node-chunks/chunk-GYZQMMTN.js";
-import "../_node-chunks/chunk-5NWCBUGD.js";
+} from "../_node-chunks/chunk-WHIAK7AH.js";
+import "../_node-chunks/chunk-KX7OAVXY.js";
+import "../_node-chunks/chunk-HXFHXVEW.js";
+import "../_node-chunks/chunk-2CGMTALY.js";
+import "../_node-chunks/chunk-TFY6QV57.js";
+import "../_node-chunks/chunk-5L22ATN3.js";
+import "../_node-chunks/chunk-KAIK7772.js";
+import "../_node-chunks/chunk-CMQYFTBQ.js";
+import "../_node-chunks/chunk-L22DGLKT.js";
+import "../_node-chunks/chunk-RJY225Z5.js";
+import "../_node-chunks/chunk-MAQAZSXK.js";
+import "../_node-chunks/chunk-KU4SWNDM.js";
+import "../_node-chunks/chunk-P663SP7U.js";
+import "../_node-chunks/chunk-URWJMVZI.js";
+import "../_node-chunks/chunk-WQ4WQYSZ.js";
+import "../_node-chunks/chunk-FWVZUHZX.js";
 export {
   ErrorCollector,
   addToGlobalContext,
   cleanPaths,
   computeStorybookMetadata,
+  getLastEvents,
   getPrecedingUpgrade,
+  getSessionId,
   getStorybookMetadata,
   isExampleStoryId,
   metaFrameworks,