@gtkx/storybook 0.0.1

package/dist/actions-panel.d.ts

@@ -0,0 +1,7 @@
+import type { ReactNode } from "react";
+import type { ActionStore } from "./actions.js";
+declare const ActionsPanel: ({ store }: {
+    store: ActionStore;
+}) => ReactNode;
+export { ActionsPanel };
+//# sourceMappingURL=actions-panel.d.ts.map

package/dist/actions-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions-panel.d.ts","sourceRoot":"","sources":["../src/actions-panel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,QAAA,MAAM,YAAY,GAAI,WAAW;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,KAAG,SAsBzD,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/actions-panel.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { markupEscapeText } from "@gtkx/gi/glib";
+import { AdwActionRow, AdwPreferencesGroup } from "@gtkx/jsx/adw";
+import { GtkButton } from "@gtkx/jsx/gtk";
+import { useSyncExternalStore } from "react";
+const ActionsPanel = ({ store }) => {
+    const entries = useSyncExternalStore(store.subscribe, store.getSnapshot);
+    return (_jsx(AdwPreferencesGroup, { title: "Actions", description: entries.length === 0 ? "Interact with the story to record events." : "", headerSuffix: _jsx(GtkButton, { label: "Clear actions", sensitive: entries.length > 0, onClicked: store.clear }), children: entries.toReversed().map((entry) => (_jsx(AdwActionRow, { name: `storybook-action-${String(entry.id)}`, title: markupEscapeText(entry.name, -1), subtitle: markupEscapeText(entry.error ?? entry.args.join(", "), -1), subtitleSelectable: true, subtitleLines: 3, cssClasses: entry.error === undefined ? [] : ["error"] }, entry.id))) }));
+};
+export { ActionsPanel };
+//# sourceMappingURL=actions-panel.js.map

package/dist/actions-panel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions-panel.js","sourceRoot":"","sources":["../src/actions-panel.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAG7C,MAAM,YAAY,GAAG,CAAC,EAAE,KAAK,EAA0B,EAAa,EAAE;IAClE,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAEzE,OAAO,CACH,KAAC,mBAAmB,IAChB,KAAK,EAAC,SAAS,EACf,WAAW,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,2CAA2C,CAAC,CAAC,CAAC,EAAE,EACpF,YAAY,EAAE,KAAC,SAAS,IAAC,KAAK,EAAC,eAAe,EAAC,SAAS,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,KAAK,GAAI,YAEvG,OAAO,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CACjC,KAAC,YAAY,IAET,IAAI,EAAE,oBAAoB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAC5C,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EACvC,QAAQ,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EACpE,kBAAkB,QAClB,aAAa,EAAE,CAAC,EAChB,UAAU,EAAE,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IANjD,KAAK,CAAC,EAAE,CAOf,CACL,CAAC,GACgB,CACzB,CAAC;AACN,CAAC,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,CAAC","sourcesContent":["import type { ReactNode } from \"react\";\nimport { markupEscapeText } from \"@gtkx/gi/glib\";\nimport { AdwActionRow, AdwPreferencesGroup } from \"@gtkx/jsx/adw\";\nimport { GtkButton } from \"@gtkx/jsx/gtk\";\nimport { useSyncExternalStore } from \"react\";\nimport type { ActionStore } from \"./actions.js\";\n\nconst ActionsPanel = ({ store }: { store: ActionStore }): ReactNode => {\n    const entries = useSyncExternalStore(store.subscribe, store.getSnapshot);\n\n    return (\n        <AdwPreferencesGroup\n            title=\"Actions\"\n            description={entries.length === 0 ? \"Interact with the story to record events.\" : \"\"}\n            headerSuffix={<GtkButton label=\"Clear actions\" sensitive={entries.length > 0} onClicked={store.clear} />}\n        >\n            {entries.toReversed().map((entry) => (\n                <AdwActionRow\n                    key={entry.id}\n                    name={`storybook-action-${String(entry.id)}`}\n                    title={markupEscapeText(entry.name, -1)}\n                    subtitle={markupEscapeText(entry.error ?? entry.args.join(\", \"), -1)}\n                    subtitleSelectable\n                    subtitleLines={3}\n                    cssClasses={entry.error === undefined ? [] : [\"error\"]}\n                />\n            ))}\n        </AdwPreferencesGroup>\n    );\n};\n\nexport { ActionsPanel };\n"]}

package/dist/actions.d.ts

@@ -0,0 +1,35 @@
+import type { Args, ArgTypes } from "./types.js";
+type ActionEntry = {
+    id: number;
+    name: string;
+    args: string[];
+    timestamp: number;
+    error?: string;
+};
+/** A named story callback whose arguments can be recorded by the native explorer. */
+type ActionCallback = (...args: unknown[]) => void;
+/**
+ * Creates a named action for a story's callback arguments.
+ * The explorer records bounded argument summaries; calls outside its action scope have no effect.
+ *
+ * @param name Nonempty label displayed in the Actions panel.
+ * @returns A callback to supply in story args.
+ * @throws If the name is empty or contains only whitespace.
+ */
+declare const action: (name: string) => ActionCallback;
+declare class ActionStore {
+    private entries;
+    private readonly listeners;
+    private nextId;
+    private readonly limit;
+    getSnapshot: () => ActionEntry[];
+    subscribe: (listener: () => void) => (() => void);
+    clear: () => void;
+    constructor(limit?: number);
+    private publish;
+    record(name: string, args: unknown[], error?: Error): void;
+}
+declare const bindActions: (args: Args, argTypes: ArgTypes, store: ActionStore, onError?: (error: Error) => void) => Args;
+export { action, ActionStore, bindActions };
+export type { ActionCallback };
+//# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEjD,KAAK,WAAW,GAAG;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,qFAAqF;AACrF,KAAK,cAAc,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;AA6CnD;;;;;;;GAOG;AACH,QAAA,MAAM,MAAM,GAAI,MAAM,MAAM,KAAG,cAW9B,CAAC;AAEF,cAAM,WAAW;IACb,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,WAAW,QAAO,WAAW,EAAE,CAAiB;IAEhD,SAAS,GAAI,UAAU,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAM9C;IAEF,KAAK,QAAO,IAAI,CAEd;gBAEU,KAAK,GAAE,MAA8B;IAQjD,OAAO,CAAC,OAAO;IAQf,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;CAU7D;AAmFD,QAAA,MAAM,WAAW,GACb,MAAM,IAAI,EACV,UAAU,QAAQ,EAClB,OAAO,WAAW,EAClB,UAAU,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,KACjC,IAiBF,CAAC;AAEF,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AAC5C,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/actions.js

@@ -0,0 +1,161 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+import { inspect } from "node:util";
+const actionNames = new WeakMap();
+const actionScope = new AsyncLocalStorage();
+const DEFAULT_HISTORY_LIMIT = 100;
+const MAX_ARGUMENT_LENGTH = 400;
+const objectLabel = (value) => {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        return undefined;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype === null || typeof prototype !== "object" || prototype === Object.prototype) {
+        return undefined;
+    }
+    const constructor = Object.getOwnPropertyDescriptor(prototype, "constructor")?.value;
+    return typeof constructor === "function" ? `[${constructor.name}]` : "[Object]";
+};
+const formatArgument = (value) => {
+    try {
+        const label = objectLabel(value);
+        if (label !== undefined) {
+            return label;
+        }
+        return inspect(value, {
+            depth: 1,
+            maxArrayLength: 5,
+            maxStringLength: 120,
+            customInspect: false,
+            getters: false,
+            breakLength: Infinity,
+        }).slice(0, MAX_ARGUMENT_LENGTH);
+    }
+    catch {
+        return "[Unreadable value]";
+    }
+};
+/**
+ * Creates a named action for a story's callback arguments.
+ * The explorer records bounded argument summaries; calls outside its action scope have no effect.
+ *
+ * @param name Nonempty label displayed in the Actions panel.
+ * @returns A callback to supply in story args.
+ * @throws If the name is empty or contains only whitespace.
+ */
+const action = (name) => {
+    if (name.trim().length === 0) {
+        throw new TypeError("An action needs a name");
+    }
+    const callback = (...args) => {
+        actionScope.getStore()?.record(name, args);
+    };
+    actionNames.set(callback, name);
+    return callback;
+};
+class ActionStore {
+    entries = [];
+    listeners = new Set();
+    nextId = 0;
+    limit;
+    getSnapshot = () => this.entries;
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    };
+    clear = () => {
+        this.publish([]);
+    };
+    constructor(limit = DEFAULT_HISTORY_LIMIT) {
+        if (!Number.isSafeInteger(limit) || limit < 1) {
+            throw new RangeError("Action history needs a positive integer limit");
+        }
+        this.limit = limit;
+    }
+    publish(entries) {
+        this.entries = entries;
+        for (const listener of this.listeners) {
+            listener();
+        }
+    }
+    record(name, args, error) {
+        const entry = {
+            id: this.nextId++,
+            name,
+            args: args.slice(0, 8).map((value) => formatArgument(value)),
+            timestamp: Date.now(),
+            ...(error !== undefined && { error: error.message.slice(0, MAX_ARGUMENT_LENGTH) }),
+        };
+        this.publish([...this.entries, entry].slice(-this.limit));
+    }
+}
+const settleCallback = async (result, succeed, fail) => {
+    try {
+        const value = await result;
+        succeed();
+        return value;
+    }
+    catch (error) {
+        fail(error);
+        return undefined;
+    }
+};
+const bindCallback = (store, options) => (...values) => {
+    const succeed = () => {
+        store.record(options.name, values);
+    };
+    const fail = (cause) => {
+        const error = cause instanceof Error ? cause : new Error(String(cause));
+        store.record(options.name, values, error);
+        if (options.onError === undefined) {
+            throw error;
+        }
+        options.onError(error);
+    };
+    try {
+        const result = actionScope.run(store, () => options.callback?.(...values));
+        if (result instanceof Promise) {
+            return settleCallback(result, succeed, fail);
+        }
+        succeed();
+        return result;
+    }
+    catch (error) {
+        fail(error);
+        return;
+    }
+};
+const actionName = (value, configuredName) => {
+    if (typeof configuredName === "string") {
+        return configuredName;
+    }
+    return typeof value === "function" ? actionNames.get(value) : undefined;
+};
+const isOriginalCallback = (value) => typeof value === "function" && !actionNames.has(value);
+const callbackOptions = (value, name, onError) => {
+    if (name === undefined) {
+        return undefined;
+    }
+    return {
+        name,
+        ...(isOriginalCallback(value) && { callback: value }),
+        ...(onError !== undefined && { onError }),
+    };
+};
+const bindActions = (args, argTypes, store, onError) => {
+    const bound = { ...args };
+    const names = new Set([...Object.keys(args), ...Object.keys(argTypes)]);
+    for (const argument of names) {
+        const value = args[argument];
+        const name = actionName(value, argTypes[argument]?.action);
+        const options = callbackOptions(value, name, onError);
+        if (options === undefined) {
+            continue;
+        }
+        bound[argument] = bindCallback(store, options);
+    }
+    return bound;
+};
+export { action, ActionStore, bindActions };
+//# sourceMappingURL=actions.js.map

package/dist/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"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","sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\nimport { inspect } from \"node:util\";\nimport type { Args, ArgTypes } from \"./types.js\";\n\ntype ActionEntry = {\n    id: number;\n    name: string;\n    args: string[];\n    timestamp: number;\n    error?: string;\n};\n\n/** A named story callback whose arguments can be recorded by the native explorer. */\ntype ActionCallback = (...args: unknown[]) => void;\ntype EventCallback = (...args: unknown[]) => unknown;\n\nconst actionNames: WeakMap<object, string> = new WeakMap();\nconst actionScope: AsyncLocalStorage<ActionStore> = new AsyncLocalStorage();\nconst DEFAULT_HISTORY_LIMIT = 100;\nconst MAX_ARGUMENT_LENGTH = 400;\n\nconst objectLabel = (value: unknown): string | undefined => {\n    if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n        return undefined;\n    }\n\n    const prototype: unknown = Object.getPrototypeOf(value);\n\n    if (prototype === null || typeof prototype !== \"object\" || prototype === Object.prototype) {\n        return undefined;\n    }\n\n    const constructor: unknown = Object.getOwnPropertyDescriptor(prototype, \"constructor\")?.value;\n\n    return typeof constructor === \"function\" ? `[${constructor.name}]` : \"[Object]\";\n};\n\nconst formatArgument = (value: unknown): string => {\n    try {\n        const label = objectLabel(value);\n\n        if (label !== undefined) {\n            return label;\n        }\n\n        return inspect(value, {\n            depth: 1,\n            maxArrayLength: 5,\n            maxStringLength: 120,\n            customInspect: false,\n            getters: false,\n            breakLength: Infinity,\n        }).slice(0, MAX_ARGUMENT_LENGTH);\n    } catch {\n        return \"[Unreadable value]\";\n    }\n};\n\n/**\n * Creates a named action for a story's callback arguments.\n * The explorer records bounded argument summaries; calls outside its action scope have no effect.\n *\n * @param name Nonempty label displayed in the Actions panel.\n * @returns A callback to supply in story args.\n * @throws If the name is empty or contains only whitespace.\n */\nconst action = (name: string): ActionCallback => {\n    if (name.trim().length === 0) {\n        throw new TypeError(\"An action needs a name\");\n    }\n\n    const callback: ActionCallback = (...args) => {\n        actionScope.getStore()?.record(name, args);\n    };\n    actionNames.set(callback, name);\n\n    return callback;\n};\n\nclass ActionStore {\n    private entries: ActionEntry[] = [];\n    private readonly listeners: Set<() => void> = new Set();\n    private nextId = 0;\n    private readonly limit: number;\n\n    getSnapshot = (): ActionEntry[] => this.entries;\n\n    subscribe = (listener: () => void): (() => void) => {\n        this.listeners.add(listener);\n\n        return () => {\n            this.listeners.delete(listener);\n        };\n    };\n\n    clear = (): void => {\n        this.publish([]);\n    };\n\n    constructor(limit: number = DEFAULT_HISTORY_LIMIT) {\n        if (!Number.isSafeInteger(limit) || limit < 1) {\n            throw new RangeError(\"Action history needs a positive integer limit\");\n        }\n\n        this.limit = limit;\n    }\n\n    private publish(entries: ActionEntry[]): void {\n        this.entries = entries;\n\n        for (const listener of this.listeners) {\n            listener();\n        }\n    }\n\n    record(name: string, args: unknown[], error?: Error): void {\n        const entry: ActionEntry = {\n            id: this.nextId++,\n            name,\n            args: args.slice(0, 8).map((value) => formatArgument(value)),\n            timestamp: Date.now(),\n            ...(error !== undefined && { error: error.message.slice(0, MAX_ARGUMENT_LENGTH) }),\n        };\n        this.publish([...this.entries, entry].slice(-this.limit));\n    }\n}\n\ntype CallbackOptions = { callback?: EventCallback; name: string; onError?: (error: Error) => void };\n\nconst settleCallback = async (\n    result: Promise<unknown>,\n    succeed: () => void,\n    fail: (cause: unknown) => void,\n): Promise<unknown> => {\n    try {\n        const value = await result;\n        succeed();\n\n        return value;\n    } catch (error) {\n        fail(error);\n\n        return undefined;\n    }\n};\n\nconst bindCallback = (\n    store: ActionStore,\n    options: CallbackOptions,\n): EventCallback => (...values) => {\n    const succeed = (): void => {\n        store.record(options.name, values);\n    };\n    const fail = (cause: unknown): void => {\n        const error = cause instanceof Error ? cause : new Error(String(cause));\n        store.record(options.name, values, error);\n\n        if (options.onError === undefined) {\n            throw error;\n        }\n\n        options.onError(error);\n    };\n\n    try {\n        const result = actionScope.run(store, () => options.callback?.(...values));\n\n        if (result instanceof Promise) {\n            return settleCallback(result, succeed, fail);\n        }\n\n        succeed();\n\n        return result;\n    } catch (error) {\n        fail(error);\n\n        return;\n    }\n};\n\nconst actionName = (value: unknown, configuredName: unknown): string | undefined => {\n    if (typeof configuredName === \"string\") {\n        return configuredName;\n    }\n\n    return typeof value === \"function\" ? actionNames.get(value) : undefined;\n};\n\nconst isOriginalCallback = (value: unknown): value is EventCallback =>\n    typeof value === \"function\" && !actionNames.has(value);\n\nconst callbackOptions = (\n    value: unknown,\n    name: string | undefined,\n    onError: ((error: Error) => void) | undefined,\n): CallbackOptions | undefined => {\n    if (name === undefined) {\n        return undefined;\n    }\n\n    return {\n        name,\n        ...(isOriginalCallback(value) && { callback: value }),\n        ...(onError !== undefined && { onError }),\n    };\n};\n\nconst bindActions = (\n    args: Args,\n    argTypes: ArgTypes,\n    store: ActionStore,\n    onError?: (error: Error) => void,\n): Args => {\n    const bound = { ...args };\n    const names = new Set([...Object.keys(args), ...Object.keys(argTypes)]);\n\n    for (const argument of names) {\n        const value = args[argument];\n        const name = actionName(value, argTypes[argument]?.action);\n        const options = callbackOptions(value, name, onError);\n\n        if (options === undefined) {\n            continue;\n        }\n\n        bound[argument] = bindCallback(store, options);\n    }\n\n    return bound;\n};\n\nexport { action, ActionStore, bindActions };\nexport type { ActionCallback };\n"]}

package/dist/catalog.d.ts

@@ -0,0 +1,71 @@
+import type { ArgTypes, ComposedStory, Preview } from "./types.js";
+/** A lazily loaded CSF module discovered in a Storybook project. */
+type StorySource = {
+    /** Stable module identifier used for caching and error reporting. */
+    id: string;
+    /** Fallback story group title when the module does not declare one. */
+    title: string;
+    /** Imports the module and resolves to its CSF exports. */
+    load: () => Promise<unknown>;
+};
+/** A composed story and the metadata used to display it in the explorer. */
+type StoryEntry = {
+    /** Storybook identifier used to preserve the selected story across updates. */
+    id: string;
+    /** Component group title declared by the module or derived from its source. */
+    title: string;
+    /** Display name declared by the story or derived from its export name. */
+    name: string;
+    /** Name of the CSF export that defines this story. */
+    exportName: string;
+    /** Identifier of the module containing this story. */
+    source: string;
+    /** Renderable story with its metadata, decorators, and default args composed. */
+    story: ComposedStory;
+    /** Resolved arg types with explicitly configured explorer controls. */
+    controls: ArgTypes;
+};
+/** A source loading or composition failure displayed alongside healthy stories. */
+type StoryLoadError = {
+    /** Identifier of the failed source, or Storybook for a session failure. */
+    source: string;
+    /** Normalized error raised while loading or composing the source. */
+    error: Error;
+};
+/** Current explorer contents and loading state exposed to subscribers. */
+type StoryCatalogSnapshot = {
+    /** Successfully composed stories with duplicate identifiers excluded. */
+    stories: StoryEntry[];
+    /** Failures encountered during the latest load or reported by the session. */
+    errors: StoryLoadError[];
+    /** Whether the catalog is waiting for the latest source load to finish. */
+    isLoading: boolean;
+};
+/** Loads CSF modules and publishes subscribable explorer snapshots. */
+declare class StoryCatalog {
+    private snapshot;
+    private readonly listeners;
+    private readonly loadFailures;
+    private cache;
+    private sessionError;
+    private revision;
+    /** Returns the current snapshot, retaining its identity until the next update. */
+    getSnapshot: () => StoryCatalogSnapshot;
+    /** Registers a snapshot listener and returns a function that unsubscribes it. */
+    subscribe: (listener: () => void) => (() => void);
+    private publish;
+    /**
+     * Replaces the catalog with stories composed from the supplied sources and preview.
+     * Only the latest load publishes results; unchanged module identities reuse composed stories.
+     * Rejects with an AggregateError after publishing healthy stories when any source fails.
+     */
+    load(sources: StorySource[], preview?: Preview): Promise<void>;
+    /**
+     * Replaces the current session failure while preserving source errors and superseding pending loads.
+     * Ignores aggregate failures already published by this catalog's load operation.
+     */
+    reportError(cause: unknown): void;
+}
+export { StoryCatalog };
+export type { StoryCatalogSnapshot, StoryEntry, StoryLoadError, StorySource };
+//# sourceMappingURL=catalog.d.ts.map

package/dist/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAiB,aAAa,EAAE,OAAO,EAAoB,MAAM,YAAY,CAAC;AAI1G,oEAAoE;AACpE,KAAK,WAAW,GAAG;IACf,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAChC,CAAC;AAEF,4EAA4E;AAC5E,KAAK,UAAU,GAAG;IACd,+EAA+E;IAC/E,EAAE,EAAE,MAAM,CAAC;IACX,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,KAAK,EAAE,aAAa,CAAC;IACrB,uEAAuE;IACvE,QAAQ,EAAE,QAAQ,CAAC;CACtB,CAAC;AAEF,mFAAmF;AACnF,KAAK,cAAc,GAAG;IAClB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,KAAK,EAAE,KAAK,CAAC;CAChB,CAAC;AAEF,0EAA0E;AAC1E,KAAK,oBAAoB,GAAG;IACxB,yEAAyE;IACzE,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,8EAA8E;IAC9E,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,2EAA2E;IAC3E,SAAS,EAAE,OAAO,CAAC;CACtB,CAAC;AA0IF,uEAAuE;AACvE,cAAM,YAAY;IACd,OAAO,CAAC,QAAQ,CAAuE;IACvF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAC9D,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,QAAQ,CAAK;IAErB,kFAAkF;IAClF,WAAW,QAAO,oBAAoB,CAAkB;IAExD,iFAAiF;IACjF,SAAS,GAAI,UAAU,MAAM,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAM9C;IAEF,OAAO,CAAC,OAAO;IAQf;;;;OAIG;IACG,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,OAAO,GAAE,OAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBnF;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;CAcpC;AAED,OAAO,EAAE,YAAY,EAAE,CAAC;AACxB,YAAY,EAAE,oBAAoB,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC"}

package/dist/catalog.js

@@ -0,0 +1,158 @@
+import { composeStories } from "./compose.js";
+import { storyNameFromExport } from "./upstream.js";
+const EMPTY_PREVIEW = {};
+const normalizeError = (cause) => cause instanceof Error ? cause : new Error(String(cause));
+const isObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const explicitControls = (resolved, story, meta, preview) => {
+    const controls = {};
+    for (const [argument, annotation] of Object.entries(resolved)) {
+        const control = story?.argTypes?.[argument]?.control ??
+            meta.argTypes?.[argument]?.control ?? preview.argTypes?.[argument]?.control;
+        if (control === undefined) {
+            continue;
+        }
+        controls[argument] = { ...annotation, control: control === false ? false : annotation?.control ?? control };
+    }
+    return controls;
+};
+const displayName = (story, exportName) => {
+    const name = story?.name;
+    if (name === undefined) {
+        return storyNameFromExport(exportName);
+    }
+    if (typeof name !== "string") {
+        throw new TypeError("Expected a story display name");
+    }
+    return name;
+};
+const composeSource = (source, module, preview) => {
+    if (!isObject(module) || !isObject(module.default)) {
+        throw new TypeError(`Expected CSF3 component metadata in ${source.id}`);
+    }
+    const title = module.default.title ?? source.title;
+    if (typeof title !== "string" || title.trim().length === 0) {
+        throw new TypeError(`Expected a story title in ${source.id}`);
+    }
+    const annotations = {
+        ...module,
+        default: { ...module.default, title },
+    };
+    const stories = composeStories(annotations, preview);
+    return Object.entries(stories).map(([exportName, story]) => ({
+        id: story.id,
+        title,
+        name: displayName(annotations[exportName], exportName),
+        exportName,
+        source: source.id,
+        story,
+        controls: explicitControls(story.argTypes, annotations[exportName], annotations.default, preview),
+    }));
+};
+const withoutDuplicateIds = (entries, errors) => {
+    const counts = new Map();
+    for (const entry of entries) {
+        counts.set(entry.id, (counts.get(entry.id) ?? 0) + 1);
+    }
+    return entries.filter((entry) => {
+        if (counts.get(entry.id) === 1) {
+            return true;
+        }
+        errors.push({ source: entry.source, error: new Error(`Duplicate story ID: ${entry.id}`) });
+        return false;
+    });
+};
+const collectSources = (loaded) => {
+    const cache = new Map();
+    const entries = [];
+    const errors = [];
+    for (const result of loaded) {
+        if ("error" in result) {
+            errors.push(result);
+        }
+        else {
+            cache.set(result.source.id, result.cached);
+            entries.push(...result.cached.entries);
+        }
+    }
+    return { cache, stories: withoutDuplicateIds(entries, errors), errors };
+};
+const createSourceCache = () => new Map();
+const loadSource = async (source, preview, getCache) => {
+    try {
+        const module = await source.load();
+        const previous = getCache().get(source.id);
+        const cached = previous !== undefined && previous.module === module &&
+            previous.title === source.title && previous.preview === preview
+            ? previous
+            : { module, title: source.title, preview, entries: composeSource(source, module, preview) };
+        return { source, cached };
+    }
+    catch (error) {
+        return { source: source.id, error: normalizeError(error) };
+    }
+};
+/** Loads CSF modules and publishes subscribable explorer snapshots. */
+class StoryCatalog {
+    snapshot = { stories: [], errors: [], isLoading: false };
+    listeners = new Set();
+    loadFailures = new WeakSet();
+    cache = createSourceCache();
+    sessionError;
+    revision = 0;
+    /** Returns the current snapshot, retaining its identity until the next update. */
+    getSnapshot = () => this.snapshot;
+    /** Registers a snapshot listener and returns a function that unsubscribes it. */
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    };
+    publish(snapshot) {
+        this.snapshot = snapshot;
+        for (const listener of this.listeners) {
+            listener();
+        }
+    }
+    /**
+     * Replaces the catalog with stories composed from the supplied sources and preview.
+     * Only the latest load publishes results; unchanged module identities reuse composed stories.
+     * Rejects with an AggregateError after publishing healthy stories when any source fails.
+     */
+    async load(sources, preview = EMPTY_PREVIEW) {
+        const revision = ++this.revision;
+        this.publish({ ...this.snapshot, isLoading: true });
+        const loaded = await Promise.all(sources.map((source) => loadSource(source, preview, () => this.cache)));
+        if (revision !== this.revision) {
+            return;
+        }
+        const { cache, stories, errors } = collectSources(loaded);
+        this.cache = cache;
+        this.sessionError = undefined;
+        this.publish({ stories, errors, isLoading: false });
+        if (errors.length > 0) {
+            const failure = new AggregateError(errors.map(({ error }) => error), "Some stories could not be loaded");
+            this.loadFailures.add(failure);
+            throw failure;
+        }
+    }
+    /**
+     * Replaces the current session failure while preserving source errors and superseding pending loads.
+     * Ignores aggregate failures already published by this catalog's load operation.
+     */
+    reportError(cause) {
+        if (cause instanceof Error && this.loadFailures.has(cause)) {
+            return;
+        }
+        this.revision++;
+        const errors = this.snapshot.errors.filter((entry) => entry !== this.sessionError);
+        this.sessionError = { source: "Storybook", error: normalizeError(cause) };
+        this.publish({
+            ...this.snapshot,
+            isLoading: false,
+            errors: [...errors, this.sessionError],
+        });
+    }
+}
+export { StoryCatalog };
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Args, ArgTypes, ComponentMeta, ComposedStory, Preview, StoryAnnotations } from \"./types.js\";\nimport { composeStories } from \"./compose.js\";\nimport { storyNameFromExport } from \"./upstream.js\";\n\n/** A lazily loaded CSF module discovered in a Storybook project. */\ntype StorySource = {\n    /** Stable module identifier used for caching and error reporting. */\n    id: string;\n    /** Fallback story group title when the module does not declare one. */\n    title: string;\n    /** Imports the module and resolves to its CSF exports. */\n    load: () => Promise<unknown>;\n};\n\n/** A composed story and the metadata used to display it in the explorer. */\ntype StoryEntry = {\n    /** Storybook identifier used to preserve the selected story across updates. */\n    id: string;\n    /** Component group title declared by the module or derived from its source. */\n    title: string;\n    /** Display name declared by the story or derived from its export name. */\n    name: string;\n    /** Name of the CSF export that defines this story. */\n    exportName: string;\n    /** Identifier of the module containing this story. */\n    source: string;\n    /** Renderable story with its metadata, decorators, and default args composed. */\n    story: ComposedStory;\n    /** Resolved arg types with explicitly configured explorer controls. */\n    controls: ArgTypes;\n};\n\n/** A source loading or composition failure displayed alongside healthy stories. */\ntype StoryLoadError = {\n    /** Identifier of the failed source, or Storybook for a session failure. */\n    source: string;\n    /** Normalized error raised while loading or composing the source. */\n    error: Error;\n};\n\n/** Current explorer contents and loading state exposed to subscribers. */\ntype StoryCatalogSnapshot = {\n    /** Successfully composed stories with duplicate identifiers excluded. */\n    stories: StoryEntry[];\n    /** Failures encountered during the latest load or reported by the session. */\n    errors: StoryLoadError[];\n    /** Whether the catalog is waiting for the latest source load to finish. */\n    isLoading: boolean;\n};\n\ntype CachedStories = {\n    module: unknown;\n    title: string;\n    preview: Preview;\n    entries: StoryEntry[];\n};\n\ntype LoadedSource = StoryLoadError | { source: StorySource; cached: CachedStories };\n\nconst EMPTY_PREVIEW: Preview = {};\n\nconst normalizeError = (cause: unknown): Error => cause instanceof Error ? cause : new Error(String(cause));\n\nconst isObject = (value: unknown): value is Record<string, unknown> =>\n    value !== null && typeof value === \"object\" && !Array.isArray(value);\n\nconst explicitControls = (\n    resolved: ArgTypes,\n    story: StoryAnnotations<Args> | undefined,\n    meta: ComponentMeta<Args>,\n    preview: Preview,\n): ArgTypes => {\n    const controls: ArgTypes = {};\n\n    for (const [argument, annotation] of Object.entries(resolved)) {\n        const control = story?.argTypes?.[argument]?.control ??\n            meta.argTypes?.[argument]?.control ?? preview.argTypes?.[argument]?.control;\n\n        if (control === undefined) {\n            continue;\n        }\n\n        controls[argument] = { ...annotation, control: control === false ? false : annotation?.control ?? control };\n    }\n\n    return controls;\n};\n\nconst displayName = (story: StoryAnnotations<Args> | undefined, exportName: string): string => {\n    const name = story?.name;\n\n    if (name === undefined) {\n        return storyNameFromExport(exportName);\n    }\n\n    if (typeof name !== \"string\") {\n        throw new TypeError(\"Expected a story display name\");\n    }\n\n    return name;\n};\n\nconst composeSource = (source: StorySource, module: unknown, preview: Preview): StoryEntry[] => {\n    if (!isObject(module) || !isObject(module.default)) {\n        throw new TypeError(`Expected CSF3 component metadata in ${source.id}`);\n    }\n\n    const title = module.default.title ?? source.title;\n\n    if (typeof title !== \"string\" || title.trim().length === 0) {\n        throw new TypeError(`Expected a story title in ${source.id}`);\n    }\n\n    const annotations = {\n        ...module,\n        default: { ...module.default, title },\n    } as Record<string, StoryAnnotations<Args>> & { default: ComponentMeta<Args> };\n    const stories = composeStories(annotations, preview);\n\n    return Object.entries(stories).map(([exportName, story]) => ({\n        id: story.id,\n        title,\n        name: displayName(annotations[exportName], exportName),\n        exportName,\n        source: source.id,\n        story,\n        controls: explicitControls(story.argTypes, annotations[exportName], annotations.default, preview),\n    }));\n};\n\nconst withoutDuplicateIds = (entries: StoryEntry[], errors: StoryLoadError[]): StoryEntry[] => {\n    const counts: Map<string, number> = new Map();\n\n    for (const entry of entries) {\n        counts.set(entry.id, (counts.get(entry.id) ?? 0) + 1);\n    }\n\n    return entries.filter((entry) => {\n        if (counts.get(entry.id) === 1) {\n            return true;\n        }\n\n        errors.push({ source: entry.source, error: new Error(`Duplicate story ID: ${entry.id}`) });\n\n        return false;\n    });\n};\n\nconst collectSources = (loaded: LoadedSource[]) => {\n    const cache: Map<string, CachedStories> = new Map();\n    const entries: StoryEntry[] = [];\n    const errors: StoryLoadError[] = [];\n\n    for (const result of loaded) {\n        if (\"error\" in result) {\n            errors.push(result);\n        } else {\n            cache.set(result.source.id, result.cached);\n            entries.push(...result.cached.entries);\n        }\n    }\n\n    return { cache, stories: withoutDuplicateIds(entries, errors), errors };\n};\n\nconst createSourceCache = (): Map<string, CachedStories> => new Map();\n\nconst loadSource = async (\n    source: StorySource,\n    preview: Preview,\n    getCache: () => Map<string, CachedStories>,\n): Promise<LoadedSource> => {\n    try {\n        const module = await source.load();\n        const previous = getCache().get(source.id);\n        const cached = previous !== undefined && previous.module === module &&\n            previous.title === source.title && previous.preview === preview\n            ? previous\n            : { module, title: source.title, preview, entries: composeSource(source, module, preview) };\n\n        return { source, cached };\n    } catch (error) {\n        return { source: source.id, error: normalizeError(error) };\n    }\n};\n\n/** Loads CSF modules and publishes subscribable explorer snapshots. */\nclass StoryCatalog {\n    private snapshot: StoryCatalogSnapshot = { stories: [], errors: [], isLoading: false };\n    private readonly listeners: Set<() => void> = new Set();\n    private readonly loadFailures: WeakSet<Error> = new WeakSet();\n    private cache = createSourceCache();\n    private sessionError: StoryLoadError | undefined;\n    private revision = 0;\n\n    /** Returns the current snapshot, retaining its identity until the next update. */\n    getSnapshot = (): StoryCatalogSnapshot => this.snapshot;\n\n    /** Registers a snapshot listener and returns a function that unsubscribes it. */\n    subscribe = (listener: () => void): (() => void) => {\n        this.listeners.add(listener);\n\n        return () => {\n            this.listeners.delete(listener);\n        };\n    };\n\n    private publish(snapshot: StoryCatalogSnapshot): void {\n        this.snapshot = snapshot;\n\n        for (const listener of this.listeners) {\n            listener();\n        }\n    }\n\n    /**\n     * Replaces the catalog with stories composed from the supplied sources and preview.\n     * Only the latest load publishes results; unchanged module identities reuse composed stories.\n     * Rejects with an AggregateError after publishing healthy stories when any source fails.\n     */\n    async load(sources: StorySource[], preview: Preview = EMPTY_PREVIEW): Promise<void> {\n        const revision = ++this.revision;\n        this.publish({ ...this.snapshot, isLoading: true });\n        const loaded = await Promise.all(sources.map((source) => loadSource(source, preview, () => this.cache)));\n\n        if (revision !== this.revision) {\n            return;\n        }\n\n        const { cache, stories, errors } = collectSources(loaded);\n        this.cache = cache;\n        this.sessionError = undefined;\n        this.publish({ stories, errors, isLoading: false });\n\n        if (errors.length > 0) {\n            const failure = new AggregateError(errors.map(({ error }) => error), \"Some stories could not be loaded\");\n            this.loadFailures.add(failure);\n            throw failure;\n        }\n    }\n\n    /**\n     * Replaces the current session failure while preserving source errors and superseding pending loads.\n     * Ignores aggregate failures already published by this catalog's load operation.\n     */\n    reportError(cause: unknown): void {\n        if (cause instanceof Error && this.loadFailures.has(cause)) {\n            return;\n        }\n\n        this.revision++;\n        const errors = this.snapshot.errors.filter((entry) => entry !== this.sessionError);\n        this.sessionError = { source: \"Storybook\", error: normalizeError(cause) };\n        this.publish({\n            ...this.snapshot,\n            isLoading: false,\n            errors: [...errors, this.sessionError],\n        });\n    }\n}\n\nexport { StoryCatalog };\nexport type { StoryCatalogSnapshot, StoryEntry, StoryLoadError, StorySource };\n"]}

package/dist/compose.d.ts

@@ -0,0 +1,27 @@
+import type { ComponentMeta, ComposedStories, ComposedStory, Preview, StoryAnnotations, StoryModule } from "./types.js";
+/**
+ * Composes a CSF3 story into a native React component with resolved defaults and decorators.
+ * Compose outside render to preserve component identity. Rendering props override the composed args.
+ * This function does not create an application, window, or Storybook preview lifecycle.
+ *
+ * @param story The named story's annotations.
+ * @param meta The module's default component metadata.
+ * @param preview Shared project annotations, scoped to this composition.
+ * @param exportName Export name used for the story identifier and default display name.
+ * @returns A renderable component exposing its composed annotations.
+ * @throws If an annotation is not an object or no component or render function is available.
+ */
+declare const composeStory: <TArgs extends object>(story: StoryAnnotations<NoInfer<TArgs>>, meta: ComponentMeta<TArgs>, preview?: Preview, exportName?: string) => ComposedStory<TArgs>;
+/**
+ * Composes the selected CSF3 exports of a module into native React components.
+ * The default export supplies metadata; its includeStories and excludeStories select named exports.
+ * Returned keys retain the original export names.
+ *
+ * @param stories A story module containing default metadata and named story objects.
+ * @param preview Shared project annotations, scoped to the returned compositions.
+ * @returns Composed components keyed by the selected export names.
+ * @throws If metadata or a selected export is invalid, or a selected story has no renderer.
+ */
+declare const composeStories: <TModule extends StoryModule>(stories: TModule, preview?: Preview) => ComposedStories<TModule>;
+export { composeStory, composeStories };
+//# sourceMappingURL=compose.d.ts.map

package/dist/compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../src/compose.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAER,aAAa,EACb,eAAe,EACf,aAAa,EACb,OAAO,EACP,gBAAgB,EAChB,WAAW,EACd,MAAM,YAAY,CAAC;AASpB;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,YAAY,GAAI,KAAK,SAAS,MAAM,EACtC,OAAO,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EACvC,MAAM,aAAa,CAAC,KAAK,CAAC,EAC1B,UAAS,OAAY,EACrB,aAAa,MAAM,KACpB,aAAa,CAAC,KAAK,CAkBrB,CAAC;AAEF;;;;;;;;;GASG;AACH,QAAA,MAAM,cAAc,GAAI,OAAO,SAAS,WAAW,EAC/C,SAAS,OAAO,EAChB,UAAS,OAAY,KACtB,eAAe,CAAC,OAAO,CAuBzB,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/compose.js

@@ -0,0 +1,67 @@
+import { createElement } from "react";
+import { composeStoryAnnotations, isExportStory } from "./upstream.js";
+const requireObject = (value) => {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new TypeError("Expected a CSF3 annotation object");
+    }
+};
+/**
+ * Composes a CSF3 story into a native React component with resolved defaults and decorators.
+ * Compose outside render to preserve component identity. Rendering props override the composed args.
+ * This function does not create an application, window, or Storybook preview lifecycle.
+ *
+ * @param story The named story's annotations.
+ * @param meta The module's default component metadata.
+ * @param preview Shared project annotations, scoped to this composition.
+ * @param exportName Export name used for the story identifier and default display name.
+ * @returns A renderable component exposing its composed annotations.
+ * @throws If an annotation is not an object or no component or render function is available.
+ */
+const composeStory = (story, meta, preview = {}, exportName) => {
+    requireObject(story);
+    requireObject(meta);
+    requireObject(preview);
+    if (!story.render && !meta.render && !preview.render && !meta.component) {
+        throw new TypeError("A story needs a component or render function");
+    }
+    return composeStoryAnnotations(story, { ...meta }, preview, {
+        render: (args) => {
+            if (!meta.component) {
+                throw new TypeError("A story needs a component or render function");
+            }
+            return createElement(meta.component, args);
+        },
+    }, exportName);
+};
+/**
+ * Composes the selected CSF3 exports of a module into native React components.
+ * The default export supplies metadata; its includeStories and excludeStories select named exports.
+ * Returned keys retain the original export names.
+ *
+ * @param stories A story module containing default metadata and named story objects.
+ * @param preview Shared project annotations, scoped to the returned compositions.
+ * @returns Composed components keyed by the selected export names.
+ * @throws If metadata or a selected export is invalid, or a selected story has no renderer.
+ */
+const composeStories = (stories, preview = {}) => {
+    requireObject(stories);
+    requireObject(stories.default);
+    requireObject(preview);
+    const meta = stories.default;
+    const composed = {};
+    for (const [exportName, story] of Object.entries(stories)) {
+        if (exportName === "default" || exportName === "__namedExportsOrder" || !isExportStory(exportName, meta)) {
+            continue;
+        }
+        requireObject(story);
+        Object.defineProperty(composed, exportName, {
+            value: composeStory(story, meta, preview, exportName),
+            enumerable: true,
+            configurable: true,
+            writable: true,
+        });
+    }
+    return composed;
+};
+export { composeStory, composeStories };
+//# sourceMappingURL=compose.js.map

package/dist/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../src/compose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAUtC,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEvE,MAAM,aAAa,GAAG,CAAC,KAAc,EAAQ,EAAE;IAC3C,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,SAAS,CAAC,mCAAmC,CAAC,CAAC;IAC7D,CAAC;AACL,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,YAAY,GAAG,CACjB,KAAuC,EACvC,IAA0B,EAC1B,UAAmB,EAAE,EACrB,UAAmB,EACC,EAAE;IACtB,aAAa,CAAC,KAAK,CAAC,CAAC;IACrB,aAAa,CAAC,IAAI,CAAC,CAAC;IACpB,aAAa,CAAC,OAAO,CAAC,CAAC;IAEvB,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACtE,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,uBAAuB,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,OAAO,EAAE;QACxD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACb,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBAClB,MAAM,IAAI,SAAS,CAAC,8CAA8C,CAAC,CAAC;YACxE,CAAC;YAED,OAAO,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC/C,CAAC;KACJ,EAAE,UAAU,CAAC,CAAC;AACnB,CAAC,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,cAAc,GAAG,CACnB,OAAgB,EAChB,UAAmB,EAAE,EACG,EAAE;IAC1B,aAAa,CAAC,OAAO,CAAC,CAAC;IACvB,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,aAAa,CAAC,OAAO,CAAC,CAAC;IAEvB,MAAM,IAAI,GAAG,OAAO,CAAC,OAA8B,CAAC;IACpD,MAAM,QAAQ,GAAsC,EAAE,CAAC;IAEvD,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACxD,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,qBAAqB,IAAI,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC;YACvG,SAAS;QACb,CAAC;QAED,aAAa,CAAC,KAAK,CAAC,CAAC;QACrB,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,UAAU,EAAE;YACxC,KAAK,EAAE,YAAY,CAAC,KAA+B,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,CAAC;YAC/E,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,IAAI;YAClB,QAAQ,EAAE,IAAI;SACjB,CAAC,CAAC;IACP,CAAC;IAED,OAAO,QAAoC,CAAC;AAChD,CAAC,CAAC;AAEF,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC","sourcesContent":["import { createElement } from \"react\";\nimport type {\n    Args,\n    ComponentMeta,\n    ComposedStories,\n    ComposedStory,\n    Preview,\n    StoryAnnotations,\n    StoryModule,\n} from \"./types.js\";\nimport { composeStoryAnnotations, isExportStory } from \"./upstream.js\";\n\nconst requireObject = (value: unknown): void => {\n    if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n        throw new TypeError(\"Expected a CSF3 annotation object\");\n    }\n};\n\n/**\n * Composes a CSF3 story into a native React component with resolved defaults and decorators.\n * Compose outside render to preserve component identity. Rendering props override the composed args.\n * This function does not create an application, window, or Storybook preview lifecycle.\n *\n * @param story The named story's annotations.\n * @param meta The module's default component metadata.\n * @param preview Shared project annotations, scoped to this composition.\n * @param exportName Export name used for the story identifier and default display name.\n * @returns A renderable component exposing its composed annotations.\n * @throws If an annotation is not an object or no component or render function is available.\n */\nconst composeStory = <TArgs extends object>(\n    story: StoryAnnotations<NoInfer<TArgs>>,\n    meta: ComponentMeta<TArgs>,\n    preview: Preview = {},\n    exportName?: string,\n): ComposedStory<TArgs> => {\n    requireObject(story);\n    requireObject(meta);\n    requireObject(preview);\n\n    if (!story.render && !meta.render && !preview.render && !meta.component) {\n        throw new TypeError(\"A story needs a component or render function\");\n    }\n\n    return composeStoryAnnotations(story, { ...meta }, preview, {\n        render: (args) => {\n            if (!meta.component) {\n                throw new TypeError(\"A story needs a component or render function\");\n            }\n\n            return createElement(meta.component, args);\n        },\n    }, exportName);\n};\n\n/**\n * Composes the selected CSF3 exports of a module into native React components.\n * The default export supplies metadata; its includeStories and excludeStories select named exports.\n * Returned keys retain the original export names.\n *\n * @param stories A story module containing default metadata and named story objects.\n * @param preview Shared project annotations, scoped to the returned compositions.\n * @returns Composed components keyed by the selected export names.\n * @throws If metadata or a selected export is invalid, or a selected story has no renderer.\n */\nconst composeStories = <TModule extends StoryModule>(\n    stories: TModule,\n    preview: Preview = {},\n): ComposedStories<TModule> => {\n    requireObject(stories);\n    requireObject(stories.default);\n    requireObject(preview);\n\n    const meta = stories.default as ComponentMeta<Args>;\n    const composed: Partial<ComposedStories<TModule>> = {};\n\n    for (const [exportName, story] of Object.entries(stories)) {\n        if (exportName === \"default\" || exportName === \"__namedExportsOrder\" || !isExportStory(exportName, meta)) {\n            continue;\n        }\n\n        requireObject(story);\n        Object.defineProperty(composed, exportName, {\n            value: composeStory(story as StoryAnnotations<Args>, meta, preview, exportName),\n            enumerable: true,\n            configurable: true,\n            writable: true,\n        });\n    }\n\n    return composed as ComposedStories<TModule>;\n};\n\nexport { composeStory, composeStories };\n"]}