forgebook 0.3.2 → 0.4.0

package/dist/src/jsxCode.d.ts

@@ -1,22 +1,9 @@
-/**
- * The JSX of a story drawn from its args: the component with the values the story and the props panel set, as a
- * developer would write it, for the Code card. The code writer of every framework written in JSX (React, Preact,
- * Solid): each one's `./code` module hands it to the shell.
- *
- * @remarks
- * A text is an attribute in quotes (in braces when it holds a quote), a number or `null` in braces, `true` the bare
- * name, `false` in braces, a named value by its name (`icon={IconFolder}`), a list as an array literal
- * (`options={["weekly", "monthly"]}`); `children` goes between the tags. Only the values that cross from the frame are
- * known (texts, numbers, booleans, `null`, lists of texts and numbers, named values): a function or an element the
- * story passes is left out. Pure.
- *
- * @module
- */
 import type { StoryCodeWriter } from "./frame/renderer.ts";
 /**
  * A component's JSX with these args.
  *
  * @param component - the component's name (`IconTile`).
  * @param args - the values, in the order they are written.
+ * @param written - the args the story file writes as code, each as written; after the values in the order.
  */
 export declare const jsxCode: StoryCodeWriter;

package/dist/src/jsxCode.js

@@ -1,3 +1,18 @@
+/**
+ * The JSX of a story drawn from its args: the component with the values the story and the props panel set, as a
+ * developer would write it, for the Code card. The code writer of every framework written in JSX (React, Preact,
+ * Solid): each one's `./code` module hands it to the shell.
+ *
+ * @remarks
+ * A text is an attribute in quotes (in braces when it holds a quote), a number or `null` in braces, `true` the bare
+ * name, `false` in braces, a named value by its name (`icon={IconFolder}`), a list or an object as a literal
+ * (`options={["weekly", "monthly"]}`); `children` goes between the tags. Only plain data and named values cross from
+ * the frame: a function, an element or other code the story file writes comes as written (`written`), in braces
+ * (`onClick={fn()}`), an element between the tags as it is, and is written over its value. Pure.
+ *
+ * @module
+ */
+import { argExpression } from "./argExpression.js";
 import { isNamedArg } from "./messages.js";
 /** One attribute as JSX writes it. */
 const attribute = (name, value) => {
@@ -8,29 +23,50 @@ const attribute = (name, value) => {
     // a named value is written by its name, as the source's module exports it (`icon={IconFolder}`)
     if (isNamedArg(value))
         return `${name}={${value.named}}`;
-    // a multiple choice's values, as the source writes a list
-    if (Array.isArray(value))
-        return `${name}={[${value.map((item) => JSON.stringify(item)).join(", ")}]}`;
-    return `${name}={${String(value)}}`;
+    // a list or an object, as the source writes one; `null`, a number and `false` read as themselves
+    const expression = argExpression(value, {
+        text: (text) => JSON.stringify(text),
+        named: (named) => named.named
+    });
+    return `${name}={${expression}}`;
 };
 /** The longest line the attributes stay on one line for, in characters. */
 const ONE_LINE = 80;
+/** Code that spans lines, its lines past the first indented by one level, for a place one level in. */
+const indented = (text) => text.replace(/\n/g, "\n  ");
+/** What goes between the tags, when something does: written code (an element as it is), else the value as text. */
+const childrenOf = (args, written) => {
+    const code = written["children"];
+    if (code !== undefined)
+        return code.startsWith("<") ? code : `{${code}}`;
+    const { children } = args;
+    return children === undefined || children === null || children === false ? undefined : String(children);
+};
 /**
  * A component's JSX with these args.
  *
  * @param component - the component's name (`IconTile`).
  * @param args - the values, in the order they are written.
+ * @param written - the args the story file writes as code, each as written; after the values in the order.
  */
-export const jsxCode = (component, args) => {
-    const { children, ...rest } = args;
-    const attributes = Object.entries(rest).map(([name, value]) => attribute(name, value));
-    const inner = children === undefined || children === null || children === false ? undefined : String(children);
+export const jsxCode = (component, args, written = {}) => {
+    const names = [...new Set([...Object.keys(args), ...Object.keys(written)])].filter((name) => name !== "children");
+    const attributes = names.flatMap((name) => {
+        const code = written[name];
+        if (code !== undefined)
+            return [`${name}={${code}}`];
+        const value = args[name];
+        return value === undefined ? [] : [attribute(name, value)];
+    });
+    const inner = childrenOf(args, written);
     const oneLine = [component, ...attributes].join(" ");
-    const isOneLine = oneLine.length + 2 <= ONE_LINE;
+    const isOneLine = oneLine.length + 2 <= ONE_LINE && !oneLine.includes("\n");
     const opening = isOneLine
         ? `<${oneLine}`
-        : `<${component}\n${attributes.map((text) => `  ${text}`).join("\n")}\n`;
+        : `<${component}\n${attributes.map((text) => `  ${indented(text)}`).join("\n")}\n`;
     if (inner === undefined)
         return `${opening}${isOneLine ? " " : ""}/>`;
+    if (inner.includes("\n"))
+        return `${opening}>\n  ${indented(inner)}\n</${component}>`;
     return `${opening}>${inner}</${component}>`;
 };

package/dist/src/liveErrors.d.ts

@@ -6,8 +6,9 @@
  * @remarks
  * A frame sends them over Vite's own connection to the dev server (`import.meta.hot`), so a build has none and nothing
  * is sent outside development. Only frames open in a browser report: a command that opens none (`forgebook check`)
- * reports its own problems. Each error is numbered, so a client asks only for those after the last it read. Pure apart
- * from the ring's own state.
+ * reports its own problems. Each error is numbered, so a client asks only for those after the last it read. A story's
+ * error comes with its stack, which the server maps (`vite/stackLines.ts`): it keeps the place, and answers the frame
+ * with the stack mapped, so the frame shows the lines as written. Pure apart from the ring's own state.
  *
  * @module
  */
@@ -25,9 +26,19 @@ export type LiveErrorReport = {
     readonly view: string;
     /** What went wrong. */
     readonly message: string;
+    /** The error's stack as the browser wrote it, in the lines of the code it ran: the dev server maps it. */
+    readonly stack?: string;
+};
+/** An error as the dev server keeps it, before its number: the place its stack maps to instead of the stack. */
+export type KeptErrorReport = Omit<LiveErrorReport, "stack"> & {
+    /**
+     * Where it was thrown, as `file:line:column` in the file as written, relative to the project: the first place of
+     * its stack outside `node_modules`. None when the frame sent no stack or none of it could be mapped.
+     */
+    readonly place?: string;
 };
 /** An error as the dev server keeps it: numbered, with when it came. */
-export type LiveError = LiveErrorReport & {
+export type LiveError = KeptErrorReport & {
     /** Its number, counted from 1 since the server started. */
     readonly n: number;
     /** When it came, in ISO 8601. */
@@ -36,7 +47,7 @@ export type LiveError = LiveErrorReport & {
 /** The errors kept, and how to add and read them. */
 export type LiveErrors = {
     /** Keeps a frame's error, the oldest let go past the limit. */
-    readonly add: (report: LiveErrorReport, at: Date) => LiveError;
+    readonly add: (report: KeptErrorReport, at: Date) => LiveError;
     /** The errors after a number, oldest first; every one kept for 0. */
     readonly since: (n: number) => LiveError[];
     /** The number of the last error, 0 before any. */
@@ -48,6 +59,21 @@ export type LiveErrors = {
  * @param value - what came over the connection.
  */
 export declare const isLiveErrorReport: (value: unknown) => value is LiveErrorReport;
+/** The event the dev server answers a frame's stack under, mapped to the lines of the files as written. */
+export declare const MAPPED_STACK_EVENT = "forgebook:mapped-stack";
+/** A stack the dev server mapped, for the frame that sent it. */
+export type MappedStackAnswer = {
+    /** The stack as the frame sent it. */
+    readonly sent: string;
+    /** The stack mapped. */
+    readonly stack: string;
+};
+/**
+ * Whether the dev server's message is a mapped stack.
+ *
+ * @param value - what came over the connection.
+ */
+export declare const isMappedStackAnswer: (value: unknown) => value is MappedStackAnswer;
 /**
  * A ring of the last errors.
  *

package/dist/src/liveErrors.js

@@ -6,8 +6,9 @@
  * @remarks
  * A frame sends them over Vite's own connection to the dev server (`import.meta.hot`), so a build has none and nothing
  * is sent outside development. Only frames open in a browser report: a command that opens none (`forgebook check`)
- * reports its own problems. Each error is numbered, so a client asks only for those after the last it read. Pure apart
- * from the ring's own state.
+ * reports its own problems. Each error is numbered, so a client asks only for those after the last it read. A story's
+ * error comes with its stack, which the server maps (`vite/stackLines.ts`): it keeps the place, and answers the frame
+ * with the stack mapped, so the frame shows the lines as written. Pure apart from the ring's own state.
  *
  * @module
  */
@@ -27,7 +28,21 @@ export const isLiveErrorReport = (value) => typeof value === "object" &&
     "view" in value &&
     typeof value.view === "string" &&
     "message" in value &&
-    typeof value.message === "string";
+    typeof value.message === "string" &&
+    (!("stack" in value) || typeof value.stack === "string");
+/** The event the dev server answers a frame's stack under, mapped to the lines of the files as written. */
+export const MAPPED_STACK_EVENT = "forgebook:mapped-stack";
+/**
+ * Whether the dev server's message is a mapped stack.
+ *
+ * @param value - what came over the connection.
+ */
+export const isMappedStackAnswer = (value) => typeof value === "object" &&
+    value !== null &&
+    "sent" in value &&
+    typeof value.sent === "string" &&
+    "stack" in value &&
+    typeof value.stack === "string";
 /**
  * A ring of the last errors.
  *

package/dist/src/messages.d.ts

@@ -7,24 +7,38 @@
  * failed. The shell asks the frame to
  * replay, sends the props panel's values, names the events to record, and runs, holds, speeds up or restarts the
  * story clock. Every message is checked on arrival
- * (`isFrameMessage`, `isShellMessage`): a page may receive messages from anything it embeds or is embedded in.
+ * (`isFrameMessage`, `frame/shellMessageCheck.ts`): a page may receive messages from anything it embeds or is embedded in.
  *
  * @module
  */
 import type { StoryControlsSetting } from "@forgebook/story-format/source";
 import { type Violation } from "./a11y.ts";
 import { type PanelArgTypes } from "./argTypes.ts";
-import { type Matrix } from "./matrix.ts";
+import type { Matrix } from "./matrix.ts";
 import { type PlayTrace } from "./playTrace.ts";
 import type { JsonValue } from "./plugin.ts";
-import { type ClockState } from "./storyClock.ts";
+import type { ClockState } from "./storyClock.ts";
 import { type FixedView } from "./storyGlobals.ts";
-import { type LiveView, type MeasureTool } from "./viewState.ts";
+import type { LiveView, MeasureTool } from "./viewState.ts";
 /**
- * An arg the props panel can show and set: what crosses between the documents as is. A list of texts or numbers is a
- * multiple choice's (`check`, `multi-select`); a date is a number of ms since the Unix epoch, as Storybook's.
+ * An arg the props panel can show and set: what crosses between the documents as is. Plain JSON, so a link can hold it:
+ * a list and an object nest (`valueShape.ts` says what a prop's look like); a date is a number of ms since the Unix
+ * epoch, as Storybook's. Two objects mean more than their fields: a `NamedArg`, and at the top of the args an `UnsetArg`.
  */
-export type ArgValue = string | number | boolean | null | readonly (string | number)[] | NamedArg;
+export type ArgValue = string | number | boolean | null | readonly ArgValue[] | ArgObject;
+/** An object among the args: named fields. */
+export type ArgObject = {
+    /** Each field's value. */
+    readonly [name: string]: ArgValue;
+};
+/**
+ * A prop the panel leaves without a value, over what the story's own args give it: the story receives `undefined`, which
+ * neither an empty text nor the panel holding nothing says (the panel holding nothing gives the story's own value).
+ */
+export type UnsetArg = {
+    /** The mark: a name no prop's own object holds. */
+    readonly forgebookUnset: true;
+};
 /**
  * A value the panel names instead of sending it: one of the source's `namedValues` (an icon component), which cannot
  * cross between the documents; the frame looks the name up in its own copy of the source.
@@ -110,6 +124,16 @@ export type FrameMessage = {
     readonly storyId: string;
     /** What went wrong. */
     readonly message: string;
+} | {
+    /**
+     * The colour scheme the frame's document draws in: the browser paints an opaque canvas behind a document whose
+     * scheme differs from its frame element's, so the shell gives the element the same one (`canvasScheme.ts`).
+     */
+    readonly type: "forgebook:scheme";
+    /** The story's id. */
+    readonly storyId: string;
+    /** The scheme. */
+    readonly scheme: "light" | "dark";
 } | {
     /** The story could not be shown. */
     readonly type: "forgebook:error";
@@ -138,6 +162,8 @@ export type FrameMessage = {
     /** The tab the note is for; none for the plugin's first. */
     readonly tab: string | null;
 };
+/** What the Interactions tab asks of a play: to run again, to step through from the start, to do its next action, to run on. */
+export type PlayStepCommand = "again" | "start" | "next" | "continue";
 /** From the shell to a frame. */
 export type ShellMessage = {
     /** Replay the story, as it declares. */
@@ -164,7 +190,10 @@ export type ShellMessage = {
     readonly matrix: Matrix | null;
 } | {
     /** Mount the story again, so its play function runs again. */
-    readonly type: "forgebook:play-again";
+    /** Runs the play again on a fresh mount, or steps through it. */
+    readonly type: "forgebook:play-step";
+    /** What to do. */
+    readonly command: PlayStepCommand;
 } | {
     /** Run the accessibility check on the story as it is now. */
     readonly type: "forgebook:check";
@@ -187,6 +216,46 @@ export type ShellMessage = {
     /** The switches' values, the backdrop and the text size. */
     readonly view: LiveView;
 };
+/**
+ * Whether a value is a list among the args.
+ *
+ * @param value - an arg's value.
+ */
+export declare const isArgList: (value: ArgValue) => value is readonly ArgValue[];
+/**
+ * Whether a value is an object among the args (a named value is one too).
+ *
+ * @param value - an arg's value.
+ */
+export declare const isArgObject: (value: ArgValue) => value is ArgObject;
+/**
+ * A `Date`, as the address and the messages write it: JSON has none, and the story must receive one. `frame/panelValues.ts`
+ * reads it both ways.
+ */
+export type DateArg = {
+    /** The moment, as `Date.toISOString` writes it. */
+    readonly forgebookDate: string;
+};
+/**
+ * Whether a value is a `Date` as the panel writes it.
+ *
+ * @param value - an arg's value.
+ */
+export declare const isDateArg: (value: unknown) => value is DateArg;
+/** The value that says a prop has none, as the address and the messages write it. */
+export declare const UNSET_ARG: UnsetArg;
+/**
+ * Whether a value is the panel's "no value".
+ *
+ * @param value - an arg's value.
+ */
+export declare const isUnsetArg: (value: unknown) => value is UnsetArg;
+/**
+ * Whether a value is one the panel can show.
+ *
+ * @param value - any value.
+ */
+export declare const isArgValue: (value: unknown) => value is ArgValue;
 /** Whether a value is a set of args the panel can show. */
 export declare const isPanelArgs: (value: unknown) => value is PanelArgs;
 /**
@@ -207,25 +276,6 @@ export declare const isNamedArg: (value: unknown) => value is NamedArg;
  * @param value - the message's data.
  */
 export declare const isFrameMessage: (value: unknown) => value is FrameMessage;
-/**
- * Whether a received message is one the shell sends.
- *
- * @param value - the message's data.
- */
-export declare const isShellMessage: (value: unknown) => value is ShellMessage;
-/**
- * An event's argument written short for the call log.
- *
- * @param value - anything a callback received.
- */
-export declare const previewValue: (value: unknown) => string;
-/**
- * An argument's content for the log, when it is an object or a list: JSON, two spaces deep, a function as `ƒ`, an
- * object met again as `[circular]`, cut past `DETAIL_LENGTH`; `null` for anything else (a text, a number, an event).
- *
- * @param value - anything a callback received.
- */
-export declare const detailOf: (value: unknown) => string | null;
 /**
  * The panel's values written in an address (`args`): JSON, the only form that keeps `"12"` and `12` apart.
  *

package/dist/src/messages.js

@@ -7,27 +7,68 @@
  * failed. The shell asks the frame to
  * replay, sends the props panel's values, names the events to record, and runs, holds, speeds up or restarts the
  * story clock. Every message is checked on arrival
- * (`isFrameMessage`, `isShellMessage`): a page may receive messages from anything it embeds or is embedded in.
+ * (`isFrameMessage`, `frame/shellMessageCheck.ts`): a page may receive messages from anything it embeds or is embedded in.
  *
  * @module
  */
 import { isViolation } from "./a11y.js";
 import { isPanelArgTypes } from "./argTypes.js";
-import { isMatrix } from "./matrix.js";
 import { isPlayTrace } from "./playTrace.js";
-import { isClockRate } from "./storyClock.js";
 import { isFixedView } from "./storyGlobals.js";
-import { MEASURE_TOOLS } from "./viewState.js";
 /** Whether a value is a plain object. */
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+/** The deepest a value nests: a link's `[[[…` must not run the reader out of stack. */
+const MOST_DEPTH = 16;
+/** The names a value never holds: a component that merges it would write on every object of the page. */
+const PROTOTYPE_NAMES = ["__proto__", "constructor", "prototype"];
+/** Whether a value, this deep, is one the panel can show. */
+const isArgValueAt = (value, depth) => {
+    if (value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean")
+        return true;
+    if (depth >= MOST_DEPTH)
+        return false;
+    if (Array.isArray(value))
+        return value.every((item) => isArgValueAt(item, depth + 1));
+    return (isRecord(value) &&
+        Object.entries(value).every(([name, item]) => !PROTOTYPE_NAMES.includes(name) && isArgValueAt(item, depth + 1)));
+};
+/**
+ * Whether a value is a list among the args.
+ *
+ * @param value - an arg's value.
+ */
+export const isArgList = (value) => Array.isArray(value);
+/**
+ * Whether a value is an object among the args (a named value is one too).
+ *
+ * @param value - an arg's value.
+ */
+export const isArgObject = (value) => isRecord(value);
+/**
+ * Whether a value is a `Date` as the panel writes it.
+ *
+ * @param value - an arg's value.
+ */
+export const isDateArg = (value) => isRecord(value) &&
+    typeof value["forgebookDate"] === "string" &&
+    Object.keys(value).length === 1 &&
+    !Number.isNaN(Date.parse(value["forgebookDate"]));
+/** The value that says a prop has none, as the address and the messages write it. */
+export const UNSET_ARG = { forgebookUnset: true };
+/**
+ * Whether a value is the panel's "no value".
+ *
+ * @param value - an arg's value.
+ */
+export const isUnsetArg = (value) => isRecord(value) && value["forgebookUnset"] === true && Object.keys(value).length === 1;
+/**
+ * Whether a value is one the panel can show.
+ *
+ * @param value - any value.
+ */
+export const isArgValue = (value) => isArgValueAt(value, 0);
 /** Whether a value is a set of args the panel can show. */
-export const isPanelArgs = (value) => isRecord(value) &&
-    Object.values(value).every((arg) => arg === null ||
-        typeof arg === "string" ||
-        typeof arg === "number" ||
-        typeof arg === "boolean" ||
-        isChoiceList(arg) ||
-        isNamedArg(arg));
+export const isPanelArgs = (value) => isRecord(value) && Object.values(value).every(isArgValue);
 /**
  * Whether a value is a multiple choice's values: a list of texts and numbers.
  *
@@ -39,15 +80,10 @@ export const isChoiceList = (value) => Array.isArray(value) && value.every((item
  *
  * @param value - any value.
  */
-export const isNamedArg = (value) => isRecord(value) && typeof value["of"] === "string" && typeof value["named"] === "string";
-/** Whether a value is the view's live part. */
-const isLiveView = (value) => isRecord(value) &&
-    isRecord(value["switches"]) &&
-    Object.values(value["switches"]).every((switchValue) => typeof switchValue === "string") &&
-    typeof value["backdrop"] === "string" &&
-    typeof value["text"] === "number";
-/** Whether a value is a story clock's state. */
-const isClockState = (value) => isRecord(value) && typeof value["isRunning"] === "boolean" && isClockRate(value["rate"]);
+export const isNamedArg = (value) => isRecord(value) &&
+    typeof value["of"] === "string" &&
+    typeof value["named"] === "string" &&
+    Object.keys(value).length === 2;
 /** Whether a value is a list of strings. */
 const isStringList = (value) => Array.isArray(value) && value.every((item) => typeof item === "string");
 /** Whether a value is a controls setting: every prop, or the listed ones. */
@@ -92,6 +128,8 @@ export const isFrameMessage = (value) => {
             return typeof value["height"] === "number";
         case "forgebook:spills":
             return typeof value["count"] === "number";
+        case "forgebook:scheme":
+            return value["scheme"] === "light" || value["scheme"] === "dark";
         case "forgebook:call":
             return (typeof value["name"] === "string" &&
                 isStringList(value["values"]) &&
@@ -113,86 +151,6 @@ export const isFrameMessage = (value) => {
             return false;
     }
 };
-/**
- * Whether a received message is one the shell sends.
- *
- * @param value - the message's data.
- */
-export const isShellMessage = (value) => {
-    if (!isRecord(value))
-        return false;
-    if (value["type"] === "forgebook:replay" ||
-        value["type"] === "forgebook:check" ||
-        value["type"] === "forgebook:play-again" ||
-        value["type"] === "forgebook:clock-restart") {
-        return true;
-    }
-    if (value["type"] === "forgebook:args")
-        return isPanelArgs(value["args"]);
-    if (value["type"] === "forgebook:view")
-        return isLiveView(value["view"]);
-    if (value["type"] === "forgebook:clock")
-        return isClockState(value["state"]);
-    if (value["type"] === "forgebook:spills")
-        return typeof value["isOn"] === "boolean";
-    if (value["type"] === "forgebook:tools") {
-        const tools = value["tools"];
-        return Array.isArray(tools) && tools.every((tool) => MEASURE_TOOLS.some((known) => known === tool));
-    }
-    if (value["type"] === "forgebook:matrix")
-        return value["matrix"] === null || isMatrix(value["matrix"]);
-    return value["type"] === "forgebook:events" && isStringList(value["names"]);
-};
-/**
- * An event's argument written short for the call log.
- *
- * @param value - anything a callback received.
- */
-export const previewValue = (value) => {
-    if (typeof value === "string")
-        return JSON.stringify(value.length > 60 ? `${value.slice(0, 60)}…` : value);
-    if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint")
-        return String(value);
-    if (value === null || value === undefined)
-        return String(value);
-    if (typeof value === "function")
-        return "ƒ";
-    if (typeof Event !== "undefined" && value instanceof Event)
-        return value.constructor.name;
-    if (isRecord(value) && "nativeEvent" in value)
-        return "SyntheticEvent";
-    return Array.isArray(value) ? `[…${value.length}]` : "{…}";
-};
-/** The most characters an argument's content keeps in the log. */
-const DETAIL_LENGTH = 2000;
-/**
- * An argument's content for the log, when it is an object or a list: JSON, two spaces deep, a function as `ƒ`, an
- * object met again as `[circular]`, cut past `DETAIL_LENGTH`; `null` for anything else (a text, a number, an event).
- *
- * @param value - anything a callback received.
- */
-export const detailOf = (value) => {
-    if (typeof value !== "object" || value === null)
-        return null;
-    if (typeof Event !== "undefined" && value instanceof Event)
-        return null;
-    if ("nativeEvent" in value)
-        return null;
-    const seen = new WeakSet();
-    const text = JSON.stringify(value, (_key, inner) => {
-        if (typeof inner === "function")
-            return "ƒ";
-        if (typeof inner === "bigint")
-            return `${inner}n`;
-        if (typeof inner === "object" && inner !== null) {
-            if (seen.has(inner))
-                return "[circular]";
-            seen.add(inner);
-        }
-        return inner;
-    }, 2);
-    return text.length > DETAIL_LENGTH ? `${text.slice(0, DETAIL_LENGTH)}…` : text;
-};
 /**
  * The panel's values written in an address (`args`): JSON, the only form that keeps `"12"` and `12` apart.
  *

package/dist/src/namedValues.d.ts

@@ -1,6 +1,6 @@
 /**
- * The values a source names for the props panel (`StorySource.namedValues`): a story's own value found by name for
- * the panel to show, and a name the panel sent turned back into the value for the story.
+ * The values a source names for the props panel (`StorySource.namedValues`), looked up by name; `frame/panelValues.ts`
+ * finds a story's own value among them and turns a name back into its value.
  *
  * @remarks
  * A component or a function cannot cross between the shell and a frame; its name can, and each side holds the same
@@ -9,7 +9,6 @@
  * @module
  */
 import type { StorySource } from "@forgebook/story-format/source";
-import { type NamedArg, type PanelArgs } from "./messages.ts";
 /** A source's named values: by the type as the props write it, then by name. */
 export type NamedValues = NonNullable<StorySource["namedValues"]>;
 /**
@@ -23,26 +22,3 @@ export type NamedValues = NonNullable<StorySource["namedValues"]>;
  * @returns the value; none when the source does not name it.
  */
 export declare const namedValueOf: (namedValues: NamedValues, of: string, named: string) => unknown;
-/**
- * The name of a value among the named ones, when it is one of them.
- *
- * @param value - a story's own arg.
- * @param namedValues - the source's named values.
- */
-export declare const nameOf: (value: unknown, namedValues: NamedValues) => NamedArg | undefined;
-/**
- * A story's own args as the panel can show them: texts, numbers, booleans, `null` and lists of texts and numbers (a
- * multiple choice's) as they are, a named value by its name; anything else is left out.
- *
- * @param args - the story's args.
- * @param namedValues - the source's named values; none by default.
- */
-export declare const panelArgsOf: (args: Readonly<Record<string, unknown>>, namedValues?: NamedValues) => PanelArgs;
-/**
- * The panel's values as the story takes them: a name turned back into its value; a name the source no longer offers
- * is left out, so the story keeps its own.
- *
- * @param args - the panel's values.
- * @param namedValues - the source's named values; none by default.
- */
-export declare const storyArgsOf: (args: PanelArgs, namedValues?: NamedValues) => Readonly<Record<string, unknown>>;

package/dist/src/namedValues.js

@@ -1,4 +1,3 @@
-import { isChoiceList, isNamedArg } from "./messages.js";
 /**
  * Whether a record holds a key itself, not through its prototype: `{}`'s `constructor` is `Object`, whose own
  * `constructor` is `Function`.
@@ -23,49 +22,3 @@ export const namedValueOf = (namedValues, of, named) => {
     const values = namedValues[of];
     return values !== undefined && hasOwn(values, named) ? values[named] : undefined;
 };
-/**
- * The name of a value among the named ones, when it is one of them.
- *
- * @param value - a story's own arg.
- * @param namedValues - the source's named values.
- */
-export const nameOf = (value, namedValues) => {
-    for (const [of, values] of Object.entries(namedValues)) {
-        for (const [named, known] of Object.entries(values)) {
-            if (known === value)
-                return { of, named };
-        }
-    }
-    return undefined;
-};
-/**
- * A story's own args as the panel can show them: texts, numbers, booleans, `null` and lists of texts and numbers (a
- * multiple choice's) as they are, a named value by its name; anything else is left out.
- *
- * @param args - the story's args.
- * @param namedValues - the source's named values; none by default.
- */
-export const panelArgsOf = (args, namedValues = {}) => Object.fromEntries(Object.entries(args).flatMap(([name, value]) => {
-    if (value === null ||
-        typeof value === "string" ||
-        typeof value === "number" ||
-        typeof value === "boolean" ||
-        isChoiceList(value)) {
-        return [[name, value]];
-    }
-    const named = nameOf(value, namedValues);
-    return named === undefined ? [] : [[name, named]];
-}));
-/**
- * The panel's values as the story takes them: a name turned back into its value; a name the source no longer offers
- * is left out, so the story keeps its own.
- *
- * @param args - the panel's values.
- * @param namedValues - the source's named values; none by default.
- */
-export const storyArgsOf = (args, namedValues = {}) => Object.fromEntries(Object.entries(args).flatMap(([name, value]) => {
-    if (!isNamedArg(value))
-        return [[name, value]];
-    const known = namedValueOf(namedValues, value.of, value.named);
-    return known === undefined ? [] : [[name, known]];
-}));

package/dist/src/pageConfig.d.ts

@@ -16,6 +16,8 @@ export type PageConfig = {
     readonly heights: string | undefined;
     /** The switches, the presets' and the catalogue's merged. */
     readonly switches: readonly ViewSwitch[] | undefined;
+    /** The catalogue's own story patterns, for a dev server's home with no story to say where it looks; none in a build. */
+    readonly storyGlobs?: readonly string[];
     /** The languages, the presets' and the catalogue's merged. */
     readonly languages: readonly StoryLanguage[];
     /** The lists (widths, backgrounds, story groups, texts…), the presets' and the catalogue's merged. */