@storybook/preview-api 8.0.0-alpha.7 → 8.0.0-alpha.9

package/dist/index.d.ts

@@ -1,9 +1,6 @@
 import { Channel } from '@storybook/channels';
 import * as _storybook_types from '@storybook/types';
-import { Renderer, Args, StoryContext, StoryId, DecoratorApplicator, Addon_StoryWrapper, StoryName, ComponentTitle, StoryIndex, IndexEntry, Path, PreparedStory, Globals, GlobalTypes, LegacyStoryAnnotationsOrFn, NormalizedComponentAnnotations, NormalizedStoryAnnotations, ModuleExports, CSFFile, NormalizedProjectAnnotations, ModuleExport, PreparedMeta, ProjectAnnotations, StepRunner, ComponentAnnotations, ComposedStoryFn, Store_CSFExports, ComposeStoryFn, ModuleImportFn, StoryContextForLoaders, StoryContextForEnhancers, Parameters, StoryIndexV3, API_PreparedStoryIndex, BoundStory, StrictArgTypes, ArgTypesEnhancer, LegacyStoryFn, DecoratorFunction, PartialStoryFn, StoryContextUpdate, NormalizedStoriesSpecifier, Addon_StorySortParameterV7, StoryRenderOptions, ViewMode, RenderToCanvas, RenderContextCallbacks, DocsContextProps, ResolvedModuleExportType, ResolvedModuleExportFromType, ComponentId, LoaderFunction, ArgTypes, ArgsEnhancer, ArgsStoryFn } from '@storybook/types';
-import { SynchronousPromise } from 'synchronous-promise';
-import * as qs$1 from 'qs';
-import qs__default from 'qs';
+import { Renderer, Args, StoryContext, StoryId, DecoratorApplicator, Addon_StoryWrapper, StoryIndex, IndexEntry, Path, StoryName, ComponentTitle, PreparedStory, Globals, GlobalTypes, LegacyStoryAnnotationsOrFn, NormalizedComponentAnnotations, NormalizedStoryAnnotations, ModuleExports, CSFFile, NormalizedProjectAnnotations, ModuleExport, PreparedMeta, ProjectAnnotations, StepRunner, ComponentAnnotations, ComposedStoryFn, Store_CSFExports, ComposeStoryFn, ModuleImportFn, StoryContextForLoaders, StoryContextForEnhancers, Parameters, StoryIndexV3, BoundStory, StrictArgTypes, ArgTypesEnhancer, LegacyStoryFn, DecoratorFunction, PartialStoryFn, StoryContextUpdate, NormalizedStoriesSpecifier, Addon_StorySortParameterV7, StoryRenderOptions, ViewMode, RenderToCanvas, RenderContextCallbacks, DocsContextProps, ResolvedModuleExportType, ResolvedModuleExportFromType } from '@storybook/types';
 
 declare class AddonStore {
     constructor();
@@ -365,15 +362,14 @@ declare class StoryStore<TRenderer extends Renderer> {
     processCSFFileWithCache: typeof processCSFFile;
     prepareMetaWithCache: typeof prepareMeta;
     prepareStoryWithCache: typeof prepareStory;
-    initializationPromise: SynchronousPromise<void>;
+    initializationPromise: Promise<void>;
     resolveInitializationPromise: () => void;
     constructor();
     setProjectAnnotations(projectAnnotations: ProjectAnnotations<TRenderer>): void;
-    initialize({ storyIndex, importFn, cache, }: {
+    initialize({ storyIndex, importFn, }: {
         storyIndex?: StoryIndex;
         importFn: ModuleImportFn;
-        cache?: boolean;
-    }): Promise<void>;
+    }): void;
     onStoriesChanged({ importFn, storyIndex, }: {
         importFn?: ModuleImportFn;
         storyIndex?: StoryIndex;
@@ -416,7 +412,6 @@ declare class StoryStore<TRenderer extends Renderer> {
         stories: Record<string, StoryContextForEnhancers<TRenderer, _storybook_types.Args>>;
     };
     getStoriesJsonData: () => StoryIndexV3;
-    getSetIndexPayload(): API_PreparedStoryIndex;
     raw(): BoundStory<TRenderer>[];
     fromId(storyId: StoryId): BoundStory<TRenderer> | null;
 }
@@ -639,7 +634,7 @@ declare class Preview<TRenderer extends Renderer> {
     setInitialGlobals(): Promise<void>;
     emitGlobals(): void;
     getStoryIndexFromServer(): Promise<StoryIndex>;
-    initializeWithStoryIndex(storyIndex: StoryIndex): PromiseLike<void>;
+    initializeWithStoryIndex(storyIndex: StoryIndex): void;
     onGetProjectAnnotationsChanged({ getProjectAnnotations, }: {
         getProjectAnnotations: () => MaybePromise<ProjectAnnotations<TRenderer>>;
     }): Promise<void>;
@@ -719,7 +714,7 @@ declare class PreviewWithSelection<TFramework extends Renderer> extends Preview<
     constructor(selectionStore: SelectionStore, view: View<TFramework['canvasElement']>);
     setupListeners(): void;
     setInitialGlobals(): Promise<void>;
-    initializeWithStoryIndex(storyIndex: StoryIndex): PromiseLike<void>;
+    initializeWithStoryIndex(storyIndex: StoryIndex): Promise<void>;
     selectSpecifiedStory(): Promise<void>;
     onGetProjectAnnotationsChanged({ getProjectAnnotations, }: {
         getProjectAnnotations: () => MaybePromise<ProjectAnnotations<TFramework>>;
@@ -775,168 +770,7 @@ declare class PreviewWeb<TFramework extends Renderer> extends PreviewWithSelecti
     constructor();
 }
 
-declare class UrlStore implements SelectionStore {
-    selectionSpecifier: SelectionSpecifier | null;
-    selection?: Selection;
-    constructor();
-    setSelection(selection: Selection): void;
-    setQueryParams(queryParams: qs__default.ParsedQs): void;
-}
-
-declare enum Mode {
-    'MAIN' = "MAIN",
-    'NOPREVIEW' = "NOPREVIEW",
-    'PREPARING_STORY' = "PREPARING_STORY",
-    'PREPARING_DOCS' = "PREPARING_DOCS",
-    'ERROR' = "ERROR"
-}
-declare const layoutClassMap: {
-    readonly centered: "sb-main-centered";
-    readonly fullscreen: "sb-main-fullscreen";
-    readonly padded: "sb-main-padded";
-};
-type Layout = keyof typeof layoutClassMap | 'none';
-declare class WebView implements View<HTMLElement> {
-    private currentLayoutClass?;
-    private testing;
-    private preparingTimeout?;
-    constructor();
-    prepareForStory(story: PreparedStory<any>): HTMLElement;
-    storyRoot(): HTMLElement;
-    prepareForDocs(): HTMLElement;
-    docsRoot(): HTMLElement;
-    applyLayout(layout?: Layout): void;
-    checkIfLayoutExists(layout: keyof typeof layoutClassMap): void;
-    showMode(mode: Mode): void;
-    showErrorDisplay({ message, stack }: {
-        message?: string | undefined;
-        stack?: string | undefined;
-    }): void;
-    showNoPreview(): void;
-    showPreparingStory({ immediate }?: {
-        immediate?: boolean | undefined;
-    }): void;
-    showPreparingDocs({ immediate }?: {
-        immediate?: boolean | undefined;
-    }): void;
-    showMain(): void;
-    showDocs(): void;
-    showStory(): void;
-    showStoryDuringRender(): void;
-}
-
 declare function simulateDOMContentLoaded(): void;
 declare function simulatePageLoad($container: any): void;
 
-declare class StoryStoreFacade<TRenderer extends Renderer> {
-    projectAnnotations: NormalizedProjectAnnotations<TRenderer>;
-    entries: Record<StoryId, IndexEntry & {
-        componentId?: ComponentId;
-    }>;
-    csfExports: Record<Path, ModuleExports>;
-    constructor();
-    importFn(path: Path): Promise<ModuleExports>;
-    getStoryIndex(store: StoryStore<TRenderer>): {
-        v: number;
-        entries: Record<string, IndexEntry>;
-    };
-    clearFilenameExports(fileName: Path): void;
-    addStoriesFromExports(fileName: Path, fileExports: ModuleExports): void;
-}
-
-declare const addDecorator: (decorator: DecoratorFunction<Renderer>) => void;
-declare const addParameters: (parameters: Parameters) => void;
-declare const addLoader: (loader: LoaderFunction<Renderer>) => void;
-declare const addArgs: (args: Args) => void;
-declare const addArgTypes: (argTypes: ArgTypes) => void;
-declare const addArgsEnhancer: (enhancer: ArgsEnhancer<Renderer>) => void;
-declare const addArgTypesEnhancer: (enhancer: ArgTypesEnhancer<Renderer>) => void;
-declare const addStepRunner: (stepRunner: StepRunner) => void;
-declare const setGlobalRender: (render: StoryStoreFacade<any>['projectAnnotations']['render']) => void;
-declare class ClientApi<TRenderer extends Renderer> {
-    facade: StoryStoreFacade<TRenderer>;
-    storyStore?: StoryStore<TRenderer>;
-    onImportFnChanged?: ({ importFn }: {
-        importFn: ModuleImportFn;
-    }) => void;
-    constructor({ storyStore }?: {
-        storyStore?: StoryStore<TRenderer>;
-    });
-    importFn(path: Path): Promise<ModuleExports>;
-    getStoryIndex(): {
-        v: number;
-        entries: Record<string, _storybook_types.IndexEntry>;
-    };
-    addDecorator: (decorator: DecoratorFunction<TRenderer>) => void;
-    addParameters: ({ globals, globalTypes, ...parameters }: Parameters & {
-        globals?: Globals | undefined;
-        globalTypes?: GlobalTypes | undefined;
-    }) => void;
-    addStepRunner: (stepRunner: StepRunner<TRenderer>) => void;
-    addLoader: (loader: LoaderFunction<TRenderer>) => void;
-    addArgs: (args: Args) => void;
-    addArgTypes: (argTypes: ArgTypes) => void;
-    addArgsEnhancer: (enhancer: ArgsEnhancer<TRenderer>) => void;
-    addArgTypesEnhancer: (enhancer: ArgTypesEnhancer<TRenderer>) => void;
-    _addedExports: Record<string, ModuleExports>;
-    _loadAddedExports(): void;
-    raw: () => _storybook_types.BoundStory<TRenderer>[] | undefined;
-    get _storyStore(): StoryStore<TRenderer> | undefined;
-}
-
-declare const getQueryParams: () => qs$1.ParsedQs;
-declare const getQueryParam: (key: string) => string | string[] | qs$1.ParsedQs | qs$1.ParsedQs[] | undefined;
-
-interface CoreClient_RendererImplementation<TRenderer extends Renderer> {
-    /**
-     * A function that applies decorators to a story.
-     * @template TRenderer The type of renderer used by the Storybook client API.
-     * @type {ProjectAnnotations<TRenderer>['applyDecorators']}
-     */
-    decorateStory?: ProjectAnnotations<TRenderer>['applyDecorators'];
-    /**
-     * A function that renders a story with args.
-     * @template TRenderer The type of renderer used by the Storybook client API.
-     * @type {ArgsStoryFn<TRenderer>}
-     */
-    render?: ArgsStoryFn<TRenderer>;
-}
-interface CoreClient_ClientAPIFacade {
-    /**
-     * The old way of retrieving the list of stories at runtime.
-     * @deprecated This method is deprecated and will be removed in a future version.
-     */
-    raw: (...args: any[]) => never;
-}
-interface CoreClient_StartReturnValue<TRenderer extends Renderer> {
-    /**
-     * Forces a re-render of all stories in the Storybook preview.
-     * This function emits the `FORCE_RE_RENDER` event to the Storybook channel.
-     * @deprecated This method is deprecated and will be removed in a future version.
-     * @returns {void}
-     */
-    forceReRender: () => void;
-    /**
-     * The old way of setting up storybook with runtime configuration.
-     * @deprecated This method is deprecated and will be removed in a future version.
-     * @returns {void}
-     */
-    configure: any;
-    /**
-     * @deprecated This property is deprecated and will be removed in a future version.
-     * @type {ClientApi<TRenderer> | CoreClient_ClientAPIFacade}
-     */
-    clientApi: ClientApi<TRenderer> | CoreClient_ClientAPIFacade;
-}
-/**
- * Initializes the Storybook preview API.
- * @template TRenderer The type of renderer used by the Storybook client API.
- * @param {ProjectAnnotations<TRenderer>['renderToCanvas']} renderToCanvas A function that renders a story to a canvas.
- * @param {CoreClient_RendererImplementation<TRenderer>} [options] Optional configuration options for the renderer implementation.
- * @param {ProjectAnnotations<TRenderer>['applyDecorators']} [options.decorateStory] A function that applies decorators to a story.
- * @param {ArgsStoryFn<TRenderer>} [options.render] A function that renders a story with arguments.
- * @returns {CoreClient_StartReturnValue<TRenderer>} An object containing functions and objects related to the Storybook preview API.
- */
-declare function start<TRenderer extends Renderer>(renderToCanvas: ProjectAnnotations<TRenderer>['renderToCanvas'], { decorateStory, render }?: CoreClient_RendererImplementation<TRenderer>): CoreClient_StartReturnValue<TRenderer>;
-
-export { ClientApi, DocsContext, HooksContext, Preview, PreviewWeb, PreviewWithSelection, PropDescriptor, SelectionStore, StoryStore, UrlStore, View, WebView, addArgTypes, addArgTypesEnhancer, addArgs, addArgsEnhancer, addDecorator, addLoader, addParameters, addStepRunner, addons, applyHooks, combineArgs, combineParameters, composeConfigs, composeStepRunners, composeStories, composeStory, decorateStory, defaultDecorateStory, filterArgTypes, getQueryParam, getQueryParams, inferControls, makeDecorator, mockChannel, normalizeStory, prepareMeta, prepareStory, sanitizeStoryContextUpdate, setGlobalRender, setProjectAnnotations, simulateDOMContentLoaded, simulatePageLoad, sortStoriesV7, start, useArgs, useCallback, useChannel, useEffect, useGlobals, useMemo, useParameter, useReducer, useRef, useState, useStoryContext, userOrAutoTitle, userOrAutoTitleFromSpecifier };
+export { DocsContext, HooksContext, Preview, PreviewWeb, PropDescriptor, StoryStore, addons, applyHooks, combineArgs, combineParameters, composeConfigs, composeStepRunners, composeStories, composeStory, decorateStory, defaultDecorateStory, filterArgTypes, inferControls, makeDecorator, mockChannel, normalizeStory, prepareMeta, prepareStory, sanitizeStoryContextUpdate, setProjectAnnotations, simulateDOMContentLoaded, simulatePageLoad, sortStoriesV7, useArgs, useCallback, useChannel, useEffect, useGlobals, useMemo, useParameter, useReducer, useRef, useState, useStoryContext, userOrAutoTitle, userOrAutoTitleFromSpecifier };