storybook 9.1.0-alpha.3 → 9.1.0-alpha.4

package/dist/csf/index.d.ts

@@ -1,4 +1,12 @@
-import { Renderer as Renderer$1, ProjectAnnotations as ProjectAnnotations$1, NormalizedProjectAnnotations, ComponentAnnotations as ComponentAnnotations$1, Args as Args$1, NormalizedComponentAnnotations, StoryAnnotations as StoryAnnotations$1, NormalizedStoryAnnotations } from 'storybook/internal/types';
+import { StorybookTypes, Renderer as Renderer$1, ProjectAnnotations as ProjectAnnotations$1, NormalizedProjectAnnotations, Args as Args$1, ComponentAnnotations as ComponentAnnotations$1, StoryAnnotations as StoryAnnotations$1, ComposedStoryFn } from 'storybook/internal/types';
+import { ActionsTypes } from 'storybook/actions/preview';
+import { BackgroundTypes } from 'storybook/backgrounds/preview';
+import { HighlightTypes } from 'storybook/highlight/preview';
+import { MeasureTypes } from 'storybook/measure/preview';
+import { OutlineTypes } from 'storybook/outline/preview';
+import { TestTypes } from 'storybook/test/preview';
+import { ViewportTypes } from 'storybook/viewport/preview';
+import { AddonTypes as AddonTypes$1, StoryContext as StoryContext$1 } from 'storybook/internal/csf';
 
 declare global {
 	interface SymbolConstructor {
@@ -289,6 +297,9 @@ type SBOtherType = SBBaseType & {
 };
 type SBType = SBScalarType | SBEnumType | SBArrayType | SBObjectType | SBIntersectionType | SBUnionType | SBOtherType;
 
+type CoreTypes = StorybookTypes & ActionsTypes & BackgroundTypes & HighlightTypes & MeasureTypes & OutlineTypes & TestTypes & ViewportTypes;
+declare function getCoreAnnotations(): any[];
+
 type StoryId = string;
 type ComponentId = string;
 type ComponentTitle = string;
@@ -438,7 +449,11 @@ interface GlobalTypes {
 interface StrictGlobalTypes {
     [name: string]: StrictInputType;
 }
-interface Renderer {
+interface AddonTypes {
+    parameters?: Record<string, any>;
+    globals?: Record<string, any>;
+}
+interface Renderer extends AddonTypes {
     /** What is the type of the `component` annotation in this renderer? */
     component: any;
     /** What does the story function return in this renderer? */
@@ -447,6 +462,8 @@ interface Renderer {
     canvasElement: any;
     mount(): Promise<Canvas>;
     T?: unknown;
+    args: unknown;
+    csf4: boolean;
 }
 /** @deprecated - Use `Renderer` */
 type AnyFramework = Renderer;
@@ -524,7 +541,7 @@ interface BaseAnnotations<TRenderer extends Renderer = Renderer, TArgs = Args> {
      *
      * @see [Parameters](https://storybook.js.org/docs/writing-stories/parameters)
      */
-    parameters?: Parameters;
+    parameters?: Parameters & (TRenderer['csf4'] extends true ? CoreTypes['parameters'] & TRenderer['parameters'] : unknown);
     /**
      * Dynamic data that are provided (and possibly updated by) Storybook and its addons.
      *
@@ -589,7 +606,7 @@ interface ProjectAnnotations<TRenderer extends Renderer = Renderer, TArgs = Args
      *   reverse order of initialization.
      */
     beforeAll?: BeforeAll;
-    initialGlobals?: Globals;
+    initialGlobals?: Globals & (TRenderer['csf4'] extends true ? CoreTypes['globals'] & TRenderer['globals'] : unknown);
     globalTypes?: GlobalTypes;
     applyDecorators?: DecoratorApplicator<TRenderer, Args>;
     runStep?: StepRunner<TRenderer, TArgs>;
@@ -657,7 +674,7 @@ interface ComponentAnnotations<TRenderer extends Renderer = Renderer, TArgs = Ar
     /** Function that is executed after the story is rendered. */
     play?: PlayFunction<TRenderer, TArgs>;
     /** Override the globals values for all stories in this component */
-    globals?: Globals;
+    globals?: Globals & (TRenderer['csf4'] extends true ? CoreTypes['globals'] & TRenderer['globals'] : unknown);
 }
 type StoryAnnotations<TRenderer extends Renderer = Renderer, TArgs = Args, TRequiredArgs = Partial<TArgs>> = BaseAnnotations<TRenderer, TArgs> & {
     /** Override the display name in the UI (CSF v3) */
@@ -667,7 +684,7 @@ type StoryAnnotations<TRenderer extends Renderer = Renderer, TArgs = Args, TRequ
     /** Function that is executed after the story is rendered. */
     play?: PlayFunction<TRenderer, TArgs>;
     /** Override the globals values for this story */
-    globals?: Globals;
+    globals?: Globals & (TRenderer['csf4'] extends true ? CoreTypes['globals'] & TRenderer['globals'] : unknown);
     /** @deprecated */
     story?: Omit<StoryAnnotations<TRenderer, TArgs>, 'story'>;
 } & ({} extends TRequiredArgs ? {
@@ -695,24 +712,48 @@ declare const includeConditionalArg: (argType: InputType, args: Args, globals: G
 
 interface Preview<TRenderer extends Renderer$1 = Renderer$1> {
     readonly _tag: 'Preview';
-    input: ProjectAnnotations$1<TRenderer>;
+    input: ProjectAnnotations$1<TRenderer> & {
+        addons?: PreviewAddon<never>[];
+    };
     composed: NormalizedProjectAnnotations<TRenderer>;
-    meta(input: ComponentAnnotations$1<TRenderer>): Meta<TRenderer>;
-}
+    meta<TArgs extends Args$1, TInput extends ComponentAnnotations$1<TRenderer & {
+        args: TArgs;
+    }, TArgs>>(input: TInput): Meta<TRenderer & {
+        args: TArgs;
+    }, TInput>;
+}
+type InferTypes<T extends PreviewAddon<never>[]> = T extends PreviewAddon<infer C>[] ? C & {
+    csf4: true;
+} : never;
+declare function definePreview<TRenderer extends Renderer$1, Addons extends PreviewAddon<never>[]>(input: ProjectAnnotations$1<TRenderer> & {
+    addons?: Addons;
+}): Preview<TRenderer & InferTypes<Addons>>;
+interface PreviewAddon<in TExtraContext extends AddonTypes$1 = AddonTypes$1> extends ProjectAnnotations$1<Renderer$1> {
+}
+declare function definePreviewAddon<TExtraContext extends AddonTypes$1 = AddonTypes$1>(preview: ProjectAnnotations$1<Renderer$1>): PreviewAddon<TExtraContext>;
 declare function isPreview(input: unknown): input is Preview<Renderer$1>;
-interface Meta<TRenderer extends Renderer$1, TArgs extends Args$1 = Args$1> {
+interface Meta<TRenderer extends Renderer$1, TInput extends ComponentAnnotations$1<TRenderer, TRenderer['args']> = ComponentAnnotations$1<TRenderer, TRenderer['args']>> {
     readonly _tag: 'Meta';
-    input: ComponentAnnotations$1<TRenderer, TArgs>;
-    composed: NormalizedComponentAnnotations<TRenderer>;
+    input: TInput;
     preview: Preview<TRenderer>;
-    story(input: StoryAnnotations$1<TRenderer, TArgs>): Story<TRenderer, TArgs>;
+    story(input?: () => TRenderer['storyResult']): Story<TRenderer, {
+        render: () => TRenderer['storyResult'];
+    }>;
+    story<TInput extends StoryAnnotations$1<TRenderer, TRenderer['args']>>(input?: TInput): Story<TRenderer, TInput>;
 }
 declare function isMeta(input: unknown): input is Meta<Renderer$1>;
-interface Story<TRenderer extends Renderer$1, TArgs extends Args$1 = Args$1> {
+interface Story<TRenderer extends Renderer$1, TInput extends StoryAnnotations$1<TRenderer, TRenderer['args']> = StoryAnnotations$1<TRenderer, TRenderer['args']>> {
     readonly _tag: 'Story';
-    input: StoryAnnotations$1<TRenderer, TArgs>;
-    composed: NormalizedStoryAnnotations<TRenderer>;
-    meta: Meta<TRenderer, TArgs>;
+    input: TInput;
+    composed: Pick<ComposedStoryFn<TRenderer>, 'argTypes' | 'parameters' | 'id' | 'tags' | 'globals'> & {
+        args: TRenderer['args'];
+        name: string;
+    };
+    meta: Meta<TRenderer>;
+    __compose: () => ComposedStoryFn<TRenderer>;
+    play: TInput['play'];
+    run: (context?: Partial<StoryContext$1<TRenderer, Partial<TRenderer['args']>>>) => Promise<void>;
+    extend<TInput extends StoryAnnotations$1<TRenderer, TRenderer['args']>>(input: TInput): Story<TRenderer, TInput>;
 }
 declare function isStory<TRenderer extends Renderer$1>(input: unknown): input is Story<TRenderer>;
 
@@ -745,4 +786,4 @@ declare const parseKind: (kind: string, { rootSeparator, groupSeparator }: Separ
 /** Combine a set of project / meta / story tags, removing duplicates and handling negations. */
 declare const combineTags: (...tags: string[]) => string[];
 
-export { type AfterEach, type AnnotatedStoryFn, type AnyFramework, type ArgTypes, type ArgTypesEnhancer, type Args, type ArgsEnhancer, type ArgsFromMeta, type ArgsStoryFn, type BaseAnnotations, type BeforeAll, type BeforeEach, type Canvas, type CleanupCallback, type ComponentAnnotations, type ComponentId, type ComponentTitle, type Conditional, type DecoratorApplicator, type DecoratorFunction, type GlobalTypes, type Globals, type IncludeExcludeOptions, type InputType, type LegacyAnnotatedStoryFn, type LegacyStoryAnnotationsOrFn, type LegacyStoryFn, type LoaderFunction, type Meta, type Parameters, type PartialStoryFn, type PlayFunction, type PlayFunctionContext, type Preview, type ProjectAnnotations, type Renderer, type SBArrayType, type SBEnumType, type SBIntersectionType, type SBObjectType, type SBOtherType, type SBScalarType, type SBType, type SBUnionType, type SeparatorOptions, type StepFunction, type StepLabel, type StepRunner, type Story, type StoryAnnotations, type StoryAnnotationsOrFn, type StoryContext, type StoryContextForEnhancers, type StoryContextForLoaders, type StoryContextUpdate, type StoryFn, type StoryId, type StoryIdentifier, type StoryKind, type StoryName, type StrictArgTypes, type StrictArgs, type StrictGlobalTypes, type StrictInputType, type StrictParameters, type Tag, type ViewMode, combineTags, includeConditionalArg, isExportStory, isMeta, isPreview, isStory, parseKind, sanitize, storyNameFromExport, toId };
+export { type AddonTypes, type AfterEach, type AnnotatedStoryFn, type AnyFramework, type ArgTypes, type ArgTypesEnhancer, type Args, type ArgsEnhancer, type ArgsFromMeta, type ArgsStoryFn, type BaseAnnotations, type BeforeAll, type BeforeEach, type Canvas, type CleanupCallback, type ComponentAnnotations, type ComponentId, type ComponentTitle, type Conditional, type CoreTypes, type DecoratorApplicator, type DecoratorFunction, type GlobalTypes, type Globals, type IncludeExcludeOptions, type InferTypes, type InputType, type LegacyAnnotatedStoryFn, type LegacyStoryAnnotationsOrFn, type LegacyStoryFn, type LoaderFunction, type Meta, type Parameters, type PartialStoryFn, type PlayFunction, type PlayFunctionContext, type Preview, type PreviewAddon, type ProjectAnnotations, type Renderer, type SBArrayType, type SBEnumType, type SBIntersectionType, type SBObjectType, type SBOtherType, type SBScalarType, type SBType, type SBUnionType, type SeparatorOptions, type StepFunction, type StepLabel, type StepRunner, type Story, type StoryAnnotations, type StoryAnnotationsOrFn, type StoryContext, type StoryContextForEnhancers, type StoryContextForLoaders, type StoryContextUpdate, type StoryFn, type StoryId, type StoryIdentifier, type StoryKind, type StoryName, type StrictArgTypes, type StrictArgs, type StrictGlobalTypes, type StrictInputType, type StrictParameters, type Tag, type ViewMode, combineTags, definePreview, definePreviewAddon, getCoreAnnotations, includeConditionalArg, isExportStory, isMeta, isPreview, isStory, parseKind, sanitize, storyNameFromExport, toId };