forgebook 0.0.0-stage → 0.1.0

package/dist/src/frame/storyModule.js

@@ -0,0 +1,205 @@
+/**
+ * A loaded story file read safely: the module is code the catalogue did not type-check against its own types, so
+ * every part the frame uses is checked before use.
+ *
+ * @remarks
+ * Objects, strings and lists are checked for their shape; a function's parameters cannot be checked at run time, so a
+ * function is taken with the signature CSF gives it (a render, a play function, a decorator). What a render and a
+ * decorator return is the framework's (`unknown` here); its renderer draws it. The meta's component is the framework's
+ * too: a function, or an object some frameworks make one of (React's `memo` and `forwardRef`), so the frame passes on
+ * whatever the meta names and the renderer reads it.
+ *
+ * A story is an object (CSF 3) or a function (CSF 2: the function is its render, its args and parameters are
+ * properties assigned to it). The meta may give the render and the play function every story without its own uses.
+ *
+ * @module
+ */
+import { controlsOfParameter, mergedArgTypes } from "../argTypes.js";
+/** Whether a value is a plain object. */
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+/**
+ * A story's fields: a CSF 3 story's object, or a CSF 2 story's function with the properties assigned to it.
+ *
+ * @param story - the named export.
+ */
+const storyFieldsOf = (story) => {
+    if (isRecord(story))
+        return story;
+    if (typeof story !== "function")
+        return undefined;
+    // a function story's properties are its own: `Primary.args = …` sets them on the function itself
+    const fields = { render: story };
+    for (const name of Object.keys(story))
+        fields[name] = Reflect.get(story, name);
+    return fields;
+};
+/** Whether a value can be called as a component, a render, a play function or a decorator. */
+const isFunction = (value) => typeof value === "function";
+/** An object's parameters, when it has some. */
+const parametersOf = (part) => {
+    const parameters = part["parameters"];
+    return isRecord(parameters) ? parameters : {};
+};
+/** The forced states a parameter lists. */
+const forcedStates = (value) => {
+    const states = Array.isArray(value) ? value : [value];
+    return states.filter((state) => state === "hover" ||
+        state === "active" ||
+        state === "focus" ||
+        state === "focus-visible" ||
+        state === "focus-within");
+};
+/** A replay parameter, when valid. */
+const replayMode = (value) => {
+    if (value === "remount")
+        return value;
+    if (isRecord(value) && typeof value["toggle"] === "string") {
+        const hold = value["hold"];
+        return typeof hold === "number" && hold > 0
+            ? { toggle: value["toggle"], hold }
+            : { toggle: value["toggle"] };
+    }
+    return undefined;
+};
+/** A clock parameter's start, when it names a valid instant. */
+const clockStartOf = (value) => {
+    if (!isRecord(value) || typeof value["start"] !== "string")
+        return undefined;
+    const start = Date.parse(value["start"]);
+    return Number.isNaN(start) ? undefined : start;
+};
+/** The decorators of a part. */
+const decoratorsOf = (part) => {
+    const decorators = part["decorators"];
+    return Array.isArray(decorators) ? decorators.filter((isFunction)) : [];
+};
+/**
+ * The functions a part writes under a name, one or a list (CSF's `loaders` and `beforeEach` take either).
+ *
+ * @param part - the meta, the story or the preview.
+ * @param name - the field.
+ */
+const functionsOf = (part, name) => {
+    const value = part[name];
+    const list = Array.isArray(value) ? value : [value];
+    return list.filter((isFunction));
+};
+/**
+ * A function the story names, or else the meta's.
+ *
+ * @param story - the story's fields.
+ * @param meta - the meta.
+ * @param name - the field (`render`, `play`).
+ */
+const ownOrMeta = (story, meta, name) => {
+    const own = story[name];
+    if (isFunction(own))
+        return own;
+    const fromMeta = meta[name];
+    return isFunction(fromMeta) ? fromMeta : undefined;
+};
+/**
+ * The meta and one story of a loaded module, merged.
+ *
+ * @param module - the module, as `import()` gave it.
+ * @param exportName - the story's named export.
+ * @param preview - the catalogue's preview: its parameters under the meta's and the story's, its loaders and set-ups
+ *   before theirs (its decorators are the renderer's to put outside); none by default.
+ * @returns what the frame renders, or why it cannot.
+ */
+export const readStory = (module, exportName, preview = NO_PREVIEW) => {
+    if (!isRecord(module))
+        return "The story file did not load as a module";
+    const meta = module["default"];
+    const story = storyFieldsOf(module[exportName]);
+    if (!isRecord(meta))
+        return "The story file has no meta (its default export)";
+    if (story === undefined)
+        return `The story file has no story "${exportName}"`;
+    const metaArgs = isRecord(meta["args"]) ? meta["args"] : {};
+    const storyArgs = isRecord(story["args"]) ? story["args"] : {};
+    const parameters = { ...preview.parameters, ...parametersOf(meta), ...parametersOf(story) };
+    const layout = parameters["layout"];
+    return {
+        component: meta["component"] ?? undefined,
+        args: { ...preview.args, ...metaArgs, ...storyArgs },
+        render: ownOrMeta(story, meta, "render"),
+        play: ownOrMeta(story, meta, "play"),
+        decorators: [...decoratorsOf(story), ...decoratorsOf(meta)],
+        loaders: [
+            ...preview.loaders,
+            ...functionsOf(meta, "loaders"),
+            ...functionsOf(story, "loaders")
+        ],
+        beforeEach: [
+            ...preview.beforeEach,
+            ...functionsOf(meta, "beforeEach"),
+            ...functionsOf(story, "beforeEach")
+        ],
+        forceState: forcedStates(parameters["forceState"]),
+        parameters,
+        replay: replayMode(parameters["replay"]),
+        controls: controlsOfParameter(parameters["controls"]),
+        argTypes: mergedArgTypes(mergedArgTypes(preview.argTypes, meta["argTypes"]), story["argTypes"]),
+        globals: {
+            ...(isRecord(meta["globals"]) ? meta["globals"] : {}),
+            ...(isRecord(story["globals"]) ? story["globals"] : {})
+        },
+        layout: layout === "centered" || layout === "fullscreen" ? layout : "padded",
+        clockStart: clockStartOf(parameters["clock"])
+    };
+};
+/** The preview of a catalogue that has none. */
+export const NO_PREVIEW = {
+    decorators: [],
+    loaders: [],
+    beforeEach: [],
+    args: {},
+    argTypes: {},
+    parameters: {},
+    setup: undefined
+};
+/**
+ * A catalogue's preview read safely, as a story file is: from the default export of its module, or the module itself.
+ *
+ * @param module - the preview's module, as `import()` gave it; none for a catalogue without one.
+ */
+export const readPreview = (module) => {
+    if (!isRecord(module))
+        return NO_PREVIEW;
+    const preview = isRecord(module["default"]) ? module["default"] : module;
+    const setup = preview["setup"];
+    return {
+        decorators: decoratorsOf(preview),
+        loaders: functionsOf(preview, "loaders"),
+        beforeEach: functionsOf(preview, "beforeEach"),
+        args: isRecord(preview["args"]) ? preview["args"] : {},
+        argTypes: isRecord(preview["argTypes"]) ? preview["argTypes"] : {},
+        parameters: parametersOf(preview),
+        setup: isFunction(setup) ? setup : undefined
+    };
+};
+/**
+ * Previews read one after another, as a catalogue's presets and its own: decorators of the later ones outside the
+ * earlier ones', parameters of the later ones over the earlier ones', every setup, loader and set-up in order.
+ *
+ * @param previews - the previews, the catalogue's own last.
+ */
+export const mergedPreviews = (previews) => {
+    const setups = previews.flatMap((preview) => (preview.setup === undefined ? [] : [preview.setup]));
+    return {
+        decorators: previews.flatMap((preview) => preview.decorators),
+        loaders: previews.flatMap((preview) => preview.loaders),
+        beforeEach: previews.flatMap((preview) => preview.beforeEach),
+        args: Object.assign({}, ...previews.map((preview) => preview.args)),
+        argTypes: previews.reduce((merged, preview) => mergedArgTypes(merged, preview.argTypes), {}),
+        parameters: Object.fromEntries(previews.flatMap((preview) => Object.entries(preview.parameters))),
+        setup: setups.length === 0
+            ? undefined
+            : async () => {
+                for (const setup of setups)
+                    await setup();
+            }
+    };
+};
+//# sourceMappingURL=storyModule.js.map

package/dist/src/frame/storyModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyModule.js","sourceRoot":"","sources":["../../../src/frame/storyModule.ts"],"names":[],"mappings":"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"}

package/dist/src/frame/storyRun.d.ts

@@ -0,0 +1,96 @@
+/**
+ * One story run in its frame, whatever framework draws it: the args (the story's, the panel's, the texts named by key,
+ * the recorded events), the play function, Replay, the matrix, the story clock a Live story reads (D-504) and the
+ * error shown in place of a story that throws.
+ *
+ * @remarks
+ * The framework only draws (`renderer.ts`); everything a story does over time is here, so each framework behaves the
+ * same. The play function runs once per mount, like a test, not on every change of the args, and reads the args of
+ * the moment it runs. Every mount runs the story's loaders and set-ups first (`storyHooks.ts`), after the cleanups of
+ * the mount before.
+ *
+ * @module
+ */
+import { type StoryTextTable } from "@forgebook/story-format/texts";
+import type { Matrix } from "../matrix.ts";
+import type { PanelArgs } from "../messages.ts";
+import type { PlayTrace } from "../playTrace.ts";
+import type { ClockState } from "../storyClock.ts";
+import type { FrameClock } from "./frameClock.ts";
+import { type PlayToolsLoader } from "./playStory.ts";
+import type { StoryDrawing, StoryIdentity, StoryRenderer } from "./renderer.ts";
+import type { LoadedStory } from "./storyModule.ts";
+/** What the shell can do to a running story. */
+export type StoryControls = {
+    /** Replays the story, as it declares. */
+    readonly replay: () => Promise<void>;
+    /** Sets the props panel's values over the story's own args. */
+    readonly setPanelArgs: (args: PanelArgs) => void;
+    /** Records the calls of these events. */
+    readonly setEvents: (names: readonly string[]) => void;
+    /** Draws the story once per value of the matrix's axes; none draws it alone. */
+    readonly setMatrix: (matrix: Matrix | undefined) => void;
+    /** Mounts the story again, so its play function runs again. */
+    readonly playAgain: () => void;
+    /** Sets whether the story clock runs, and how fast. */
+    readonly setClock: (state: ClockState) => void;
+    /**
+     * Brings the story clock back to its start and mounts the story again, so its own state starts over too and its
+     * play function runs again (D-629).
+     */
+    readonly restartClock: () => void;
+};
+/** What a story run needs. */
+export type StoryRunOptions = {
+    /** The element the story, its matrix or its error are drawn in. */
+    readonly container: HTMLElement;
+    /** The story. */
+    readonly story: LoadedStory;
+    /** Which story it is: its context's id, name and title. */
+    readonly identity: StoryIdentity;
+    /** Loads the play tools the project installed, for the first play; none without them. */
+    readonly playTools?: PlayToolsLoader;
+    /** The framework that draws it. */
+    readonly renderer: StoryRenderer;
+    /** The story clock the story reads: running from its start for a Live story, held otherwise. */
+    readonly clock: FrameClock;
+    /** The texts inside the stories in the shown language. */
+    readonly texts: StoryTextTable;
+    /** The catalogue's decorators, outside the story's own. */
+    readonly decorators: StoryDrawing["decorators"];
+    /** The values of the switches applied by code, by id. */
+    readonly globals: StoryDrawing["globals"];
+    /** The panel's values as the story takes them (a named value turned back into the value). */
+    readonly resolveArgs: (args: PanelArgs) => Readonly<Record<string, unknown>>;
+    /**
+     * Called once with the controls, when the story is first drawn and its play function is over (the frame's ready
+     * status waits for it, so no check reads a half-played story).
+     */
+    readonly onControlsReady: (controls: StoryControls) => void;
+    /** Called on every call of a recorded event, with its arguments. */
+    readonly onEvent: (name: string, values: readonly unknown[]) => void;
+    /** Called with the message when the story throws while it is drawn; the frame shows the error instead. */
+    readonly onError: (message: string) => void;
+    /** Called with the play function's trace after every change. */
+    readonly onTrace: (trace: PlayTrace) => void;
+};
+/** What the frame changes in a running story when the shell sends a new view: no new mount, the story keeps its state. */
+export type RunningStory = {
+    /** Takes the story away and runs its set-ups' cleanups: the frame's page is being left. */
+    readonly leave: () => void;
+    /**
+     * Draws the story in another language, or with other values of the switches applied by code (the language's
+     * provider reads its id among them).
+     *
+     * @param shown - the texts of the language now shown, and the switches' values.
+     */
+    readonly setShown: (shown: Pick<StoryDrawing, "texts" | "globals">) => void;
+};
+/**
+ * Runs a story in its container.
+ *
+ * @param options - the story, its framework, its clock, texts and language, and what to tell the shell.
+ * @returns what the frame can change while it runs.
+ */
+export declare const runStory: (options: StoryRunOptions) => RunningStory;
+//# sourceMappingURL=storyRun.d.ts.map

package/dist/src/frame/storyRun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyRun.d.ts","sourceRoot":"","sources":["../../../src/frame/storyRun.ts"],"names":[],"mappings":"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"}

package/dist/src/frame/storyRun.js

@@ -0,0 +1,318 @@
+/**
+ * One story run in its frame, whatever framework draws it: the args (the story's, the panel's, the texts named by key,
+ * the recorded events), the play function, Replay, the matrix, the story clock a Live story reads (D-504) and the
+ * error shown in place of a story that throws.
+ *
+ * @remarks
+ * The framework only draws (`renderer.ts`); everything a story does over time is here, so each framework behaves the
+ * same. The play function runs once per mount, like a test, not on every change of the args, and reads the args of
+ * the moment it runs. Every mount runs the story's loaders and set-ups first (`storyHooks.ts`), after the cleanups of
+ * the mount before.
+ *
+ * @module
+ */
+import { storyTextOf } from "@forgebook/story-format/texts";
+import { actionNames, mappedArgs } from "../argTypes.js";
+import { withStoryTexts } from "../storyTexts.js";
+import { matrixLayout } from "./matrixLayout.js";
+import { playStory } from "./playStory.js";
+import { animationsSettled } from "./settle.js";
+import { storyCanvas } from "./storyCanvas.js";
+import { prepareStory } from "./storyHooks.js";
+/**
+ * The error shown in place of a story that threw: its message and its stack.
+ *
+ * @param document - the frame's document.
+ * @param error - the error.
+ */
+const errorElement = (document, error) => {
+    const box = document.createElement("div");
+    box.className = "forgebook-frame-error";
+    box.setAttribute("role", "alert");
+    const message = document.createElement("p");
+    message.className = "forgebook-frame-error__message";
+    message.textContent = error.message;
+    box.append(message);
+    if (error.stack !== undefined) {
+        const stack = document.createElement("pre");
+        stack.className = "forgebook-frame-error__stack";
+        stack.textContent = error.stack;
+        box.append(stack);
+    }
+    return box;
+};
+/**
+ * Whether an arg is a handler the frame can wrap: a function, taken with the signature an event's handler has.
+ *
+ * @param value - the arg.
+ */
+const isHandler = (value) => typeof value === "function";
+/**
+ * Clears the calls of the spies among a story's args, as Storybook does before it draws a story: each mount's play
+ * counts its own calls.
+ *
+ * @param args - the story's args.
+ */
+const clearSpies = (args) => {
+    for (const value of Object.values(args)) {
+        const clear = typeof value === "function" ? Reflect.get(value, "mockClear") : undefined;
+        if (typeof clear === "function")
+            Reflect.apply(clear, value, []);
+    }
+};
+/** A story before its loaders ran, or after its set-ups were undone: nothing loaded, nothing to undo. */
+const NOT_PREPARED = { loaded: {}, cleanup: async () => undefined };
+/**
+ * Runs a story in its container.
+ *
+ * @param options - the story, its framework, its clock, texts and language, and what to tell the shell.
+ * @returns what the frame can change while it runs.
+ */
+export const runStory = (options) => {
+    const { container, story, renderer, clock } = options;
+    const document = container.ownerDocument;
+    const { decorators } = options;
+    let { texts, globals } = options;
+    let text = storyTextOf(texts);
+    let args = story.args;
+    let eventNames = [];
+    let matrix;
+    let mounted = [];
+    let shownError;
+    let mountCount = 0;
+    let hasPlayed = false;
+    let prepared = NOT_PREPARED;
+    // the story's actions are recorded whatever the shell names: a spy, an `argTypes` action
+    const actions = actionNames(story.args, story.argTypes);
+    // every recorded event reports its calls, then runs the story's own handler when it has one; the handler is
+    // wrapped, not replaced, so a spy stays one (`expect(args.onPress).toHaveBeenCalled()` reads its calls)
+    const recorded = () => Object.fromEntries([...new Set([...eventNames, ...actions])].map((name) => {
+        const own = args[name];
+        const report = (values) => options.onEvent(name, values);
+        if (!isHandler(own)) {
+            return [
+                name,
+                (...values) => {
+                    report(values);
+                    return undefined;
+                }
+            ];
+        }
+        return [
+            name,
+            new Proxy(own, {
+                apply: (target, thisArg, values) => {
+                    report(values);
+                    return Reflect.apply(target, thisArg, values);
+                }
+            })
+        ];
+    }));
+    // an arg written `storyText("key")` reaches the story as the text of the shown language
+    // an arg holding a key of its `mapping` reaches the story as the value the key stands for
+    const shownArgs = () => ({
+        ...withStoryTexts(mappedArgs(args, story.argTypes), text),
+        ...recorded()
+    });
+    const drawing = (values) => ({
+        identity: options.identity,
+        story,
+        args: { ...shownArgs(), ...values },
+        texts,
+        clock,
+        decorators,
+        globals,
+        loaded: prepared.loaded
+    });
+    const clearError = () => {
+        shownError?.remove();
+        shownError = undefined;
+        for (const child of container.children)
+            if (child instanceof HTMLElement)
+                child.hidden = false;
+    };
+    const showError = (error) => {
+        shownError?.remove();
+        for (const child of container.children)
+            if (child instanceof HTMLElement)
+                child.hidden = true;
+        shownError = errorElement(document, error);
+        container.append(shownError);
+        options.onError(error.message);
+    };
+    const unmountAll = () => {
+        for (const { story: each } of mounted)
+            each.unmount();
+        mounted = [];
+        clearError();
+        container.replaceChildren();
+    };
+    const controls = {
+        replay: async () => {
+            const mode = story.replay;
+            if (mode === undefined)
+                return;
+            if (mode === "remount") {
+                mountStory();
+                return;
+            }
+            // an exit and an entrance: the arg goes false, the exit plays to its end, it stays false for the hold, then it
+            // comes back
+            args = { ...args, [mode.toggle]: false };
+            redraw();
+            await animationsSettled(document);
+            if (mode.hold !== undefined)
+                await new Promise((resolve) => window.setTimeout(resolve, mode.hold));
+            args = { ...args, [mode.toggle]: true };
+            redraw();
+        },
+        setPanelArgs: (panelArgs) => {
+            args = { ...story.args, ...options.resolveArgs(panelArgs) };
+            redraw();
+        },
+        setEvents: (names) => {
+            eventNames = names;
+            redraw();
+        },
+        // the shell sends the matrix when the story is ready: the same one again must not mount the story anew (its play
+        // would run twice)
+        setMatrix: (next) => {
+            if (JSON.stringify(next) === JSON.stringify(matrix))
+                return;
+            matrix = next;
+            mountStory();
+        },
+        playAgain: () => mountStory(),
+        setClock: clock.setState,
+        restartClock: () => {
+            clock.restart();
+            mountStory();
+        }
+    };
+    // new args (the panel, Replay, the events) draw the story again: a value that made it throw can be changed back
+    const redraw = () => {
+        clearError();
+        for (const { story: each, values } of mounted)
+            each.update(drawing(values));
+    };
+    const mountMatrix = (axes) => {
+        const layout = matrixLayout(document, story, axes);
+        container.append(layout.element);
+        mounted = layout.cells.map((cell) => ({
+            story: renderer.mount(cell.canvas, drawing(cell.values), showError),
+            values: cell.values
+        }));
+    };
+    const mountAlone = () => {
+        const count = mountCount;
+        const canvas = storyCanvas(document, story);
+        container.append(canvas);
+        const alone = renderer.mount(canvas, drawing({}), showError);
+        mounted = [{ story: alone, values: {} }];
+        void alone.drawn.then(async () => {
+            // a later mount (Replay, the matrix) replaced this one before it was drawn: its play would drive a gone story
+            if (count !== mountCount)
+                return;
+            const tools = await playTools();
+            if (count !== mountCount || tools instanceof Error)
+                return;
+            // a failed play still ends the wait; its rejection reaches the page as an error the tests record
+            void playStory(story.play, {
+                ...options.identity,
+                args: shownArgs(),
+                canvasElement: canvas,
+                text,
+                clock,
+                globals,
+                loaded: prepared.loaded,
+                parameters: story.parameters
+            }, () => {
+                if (hasPlayed)
+                    return;
+                hasPlayed = true;
+                options.onControlsReady(controls);
+            }, options.onTrace, tools);
+        });
+    };
+    // the play tools the project installed, loaded for a story with a play; a failure to load them is shown as the
+    // story's error
+    const playTools = async () => {
+        if (story.play === undefined)
+            return undefined;
+        try {
+            return await options.playTools?.();
+        }
+        catch (error) {
+            const failure = error instanceof Error ? error : new Error(String(error));
+            showError(failure);
+            return failure;
+        }
+    };
+    // the set-ups of the mount before undone, then the story's loaders and set-ups: whether this mount is still the last
+    // one, and may draw
+    const prepareMount = async (count) => {
+        clearSpies(story.args);
+        // taken before waiting: a mount that starts meanwhile must not undo the same set-ups again
+        const previous = prepared;
+        prepared = NOT_PREPARED;
+        try {
+            await previous.cleanup();
+            const next = await prepareStory(story, {
+                ...options.identity,
+                args: shownArgs(),
+                text,
+                clock,
+                globals,
+                parameters: story.parameters
+            });
+            // a later mount started while this one loaded: its set-ups are undone, the later one draws
+            if (count !== mountCount) {
+                await next.cleanup();
+                return false;
+            }
+            prepared = next;
+            return true;
+        }
+        catch (error) {
+            if (count === mountCount)
+                showError(error instanceof Error ? error : new Error(String(error)));
+            return false;
+        }
+    };
+    // a new mount draws the story from scratch: its loaders and set-ups run again, its own state starts over and its
+    // play function runs again
+    const mountStory = () => {
+        unmountAll();
+        mountCount += 1;
+        void prepareMount(mountCount).then((isLast) => {
+            if (!isLast)
+                return;
+            // a framework may throw while it starts drawing, before its own error capture is in place: shown as any error
+            try {
+                if (matrix === undefined)
+                    mountAlone();
+                else
+                    mountMatrix(matrix);
+            }
+            catch (error) {
+                showError(error instanceof Error ? error : new Error(String(error)));
+            }
+        });
+    };
+    mountStory();
+    return {
+        leave: () => {
+            mountCount += 1;
+            unmountAll();
+            const previous = prepared;
+            prepared = NOT_PREPARED;
+            void previous.cleanup();
+        },
+        setShown: (shown) => {
+            ({ texts, globals } = shown);
+            text = storyTextOf(texts);
+            redraw();
+        }
+    };
+};
+//# sourceMappingURL=storyRun.js.map

package/dist/src/frame/storyRun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyRun.js","sourceRoot":"","sources":["../../../src/frame/storyRun.ts"],"names":[],"mappings":"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"}