forgebook 0.1.3 → 0.1.4

package/dist/src/viewWords.d.ts

@@ -0,0 +1,26 @@
+/**
+ * A view written the short way, as words (`dark it 360`), turned into the address's form (`theme=dark&lang=it&width=360`),
+ * for `forgebook check`, `forgebook shot` and their MCP tools.
+ *
+ * @remarks
+ * A word is a value of exactly one of the catalogue's switches, or a number, the story's width. The words are
+ * separated by spaces or `+` (a comma would split the option into several views). A view that already holds `=` is the
+ * address's form and is kept as it is. A word no switch has, or one two switches share, is refused with what to write
+ * instead. Pure.
+ *
+ * @module
+ */
+import type { ViewSwitch } from "./switches.ts";
+/**
+ * A view in the address's form.
+ *
+ * @param text - the view: the address's form, or words.
+ * @param switches - the catalogue's switches.
+ * @returns the address's form, or why a word cannot be read.
+ */
+export declare const viewQuery: (text: string, switches: readonly ViewSwitch[]) => {
+    readonly query: string;
+} | {
+    readonly error: string;
+};
+//# sourceMappingURL=viewWords.d.ts.map

package/dist/src/viewWords.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewWords.d.ts","sourceRoot":"","sources":["../../src/viewWords.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GACpB,MAAM,MAAM,EACZ,UAAU,SAAS,UAAU,EAAE,KAC9B;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAkBvD,CAAC"}

package/dist/src/viewWords.js

@@ -0,0 +1,29 @@
+/**
+ * A view in the address's form.
+ *
+ * @param text - the view: the address's form, or words.
+ * @param switches - the catalogue's switches.
+ * @returns the address's form, or why a word cannot be read.
+ */
+export const viewQuery = (text, switches) => {
+    if (text.includes("="))
+        return { query: text };
+    const parts = [];
+    for (const word of text.split(/[\s+]+/).filter((each) => each !== "")) {
+        if (/^\d+$/.test(word)) {
+            parts.push(`width=${word}`);
+            continue;
+        }
+        const owners = switches.filter((each) => each.values.some((value) => value.value === word));
+        const [owner] = owners;
+        if (owner === undefined)
+            return { error: `No switch has the value "${word}"` };
+        if (owners.length > 1)
+            return {
+                error: `"${word}" is a value of ${owners.map((each) => each.id).join(" and ")}: write ${owner.id}=${word}`
+            };
+        parts.push(`${owner.id}=${word}`);
+    }
+    return { query: parts.join("&") };
+};
+//# sourceMappingURL=viewWords.js.map

package/dist/src/viewWords.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewWords.js","sourceRoot":"","sources":["../../src/viewWords.ts"],"names":[],"mappings":"AAcA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,IAAY,EACZ,QAA+B,EAC0B,EAAE;IAC3D,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,CAAC;QACtE,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;YAC5B,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC;QAC5F,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;QACvB,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,KAAK,EAAE,4BAA4B,IAAI,GAAG,EAAE,CAAC;QAC/E,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;YACnB,OAAO;gBACL,KAAK,EAAE,IAAI,IAAI,mBAAmB,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,KAAK,CAAC,EAAE,IAAI,IAAI,EAAE;aAC3G,CAAC;QACJ,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AACpC,CAAC,CAAC"}

package/dist/src/vite/adapter.d.ts

@@ -59,12 +59,21 @@ export type FrameworkAdapter = {
     /** The Vite plugins the framework needs in a catalogue (React's Fast Refresh); none by default. */
     readonly vitePlugins?: () => Promise<readonly PluginOption[]>;
 };
+/** Reads the component a file exports (`forgebook new`): the export named, or the file's only component. */
+export type ExtractFileComponent = (file: string, exportName?: string) => StoryComponentResult;
+/** A framework's docs module, as the plugin and the commands load it. */
+export type DocsModule = {
+    /** Reads a story file's component. */
+    readonly extractStoryComponent: ExtractStoryComponent;
+    /** Reads a component a file exports; none in a framework package that does not offer it yet. */
+    readonly extractFileComponent?: ExtractFileComponent;
+    /** The module a story file imports its types from (`@forgebook/react`); none when not given. */
+    readonly storyTypesModule?: string;
+};
 /**
- * Whether a loaded module is a docs module: it exports an `extractStoryComponent` function.
+ * Whether a module is a framework's docs module.
  *
  * @param module - the module, as `import()` gave it.
  */
-export declare const isDocsModule: (module: unknown) => module is {
-    readonly extractStoryComponent: ExtractStoryComponent;
-};
+export declare const isDocsModule: (module: unknown) => module is DocsModule;
 //# sourceMappingURL=adapter.d.ts.map

package/dist/src/vite/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/vite/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEzC,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE1E,wEAAwE;AACxE,MAAM,MAAM,cAAc,GAAG;IAC3B,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;AAEF,uHAAuH;AACvH,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GAAG,MAAM,CAAC;AAEhG;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,oBAAoB,CAAC;AAEhF,0CAA0C;AAC1C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8GAA8G;IAC9G,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE;QACd,oFAAoF;QACpF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,8FAA8F;QAC9F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC;IACF;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjD,mGAAmG;IACnG,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;CAC/D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GACvB,QAAQ,OAAO,KACd,MAAM,IAAI;IAAE,QAAQ,CAAC,qBAAqB,EAAE,qBAAqB,CAAA;CAIhB,CAAC"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/vite/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAEzC,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE1E,wEAAwE;AACxE,MAAM,MAAM,cAAc,GAAG;IAC3B,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;AAEF,uHAAuH;AACvH,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GAAG,MAAM,CAAC;AAEhG;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,oBAAoB,CAAC;AAEhF,0CAA0C;AAC1C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8GAA8G;IAC9G,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE;QACd,oFAAoF;QACpF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,8FAA8F;QAC9F,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC;IACF;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjD,mGAAmG;IACnG,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;CAC/D,CAAC;AAEF,4GAA4G;AAC5G,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,KAAK,oBAAoB,CAAC;AAE/F,yEAAyE;AACzE,MAAM,MAAM,UAAU,GAAG;IACvB,sCAAsC;IACtC,QAAQ,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;IACtD,gGAAgG;IAChG,QAAQ,CAAC,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IACrD,gGAAgG;IAChG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,OAAO,KAAG,MAAM,IAAI,UAMyB,CAAC"}

package/dist/src/vite/adapter.js

@@ -11,12 +11,14 @@
  * @module
  */
 /**
- * Whether a loaded module is a docs module: it exports an `extractStoryComponent` function.
+ * Whether a module is a framework's docs module.
  *
  * @param module - the module, as `import()` gave it.
  */
 export const isDocsModule = (module) => typeof module === "object" &&
     module !== null &&
     "extractStoryComponent" in module &&
-    typeof module.extractStoryComponent === "function";
+    typeof module.extractStoryComponent === "function" &&
+    (!("extractFileComponent" in module) || typeof module.extractFileComponent === "function") &&
+    (!("storyTypesModule" in module) || typeof module.storyTypesModule === "string");
 //# sourceMappingURL=adapter.js.map

package/dist/src/vite/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/vite/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAuDH;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,MAAe,EACsD,EAAE,CACvE,OAAO,MAAM,KAAK,QAAQ;IAC1B,MAAM,KAAK,IAAI;IACf,uBAAuB,IAAI,MAAM;IACjC,OAAO,MAAM,CAAC,qBAAqB,KAAK,UAAU,CAAC"}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/vite/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAoEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAe,EAAwB,EAAE,CACpE,OAAO,MAAM,KAAK,QAAQ;IAC1B,MAAM,KAAK,IAAI;IACf,uBAAuB,IAAI,MAAM;IACjC,OAAO,MAAM,CAAC,qBAAqB,KAAK,UAAU;IAClD,CAAC,CAAC,CAAC,sBAAsB,IAAI,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,oBAAoB,KAAK,UAAU,CAAC;IAC1F,CAAC,CAAC,CAAC,kBAAkB,IAAI,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,gBAAgB,KAAK,QAAQ,CAAC,CAAC"}

package/dist/src/vite/agent.types.d.ts

@@ -10,6 +10,7 @@
  * @module
  */
 import type { ComponentDocs } from "../componentDocs.ts";
+import type { LiveError } from "../liveErrors.ts";
 /** The version of the documents' shape. */
 export type AgentSchema = 1;
 /** Where a story opens, in the view the answer describes. */
@@ -33,9 +34,22 @@ export type AgentStory = {
     readonly tags: readonly string[];
     /** Whether it is listed nowhere (`!dev`), opened only by its address. */
     readonly isUnlisted: boolean;
+    /** The height its scene declares (`parameters.height`), in CSS px, when it declares one. */
+    readonly height?: number;
     /** Where it opens. */
     readonly links: StoryLinks;
 };
+/** A component whose stories use another ("Used in"). */
+export type AgentUsingComponent = {
+    /** Its id, as `AgentComponent.id`. */
+    readonly id: string;
+    /** Its title. */
+    readonly title: string;
+    /** Whether one of its stories renders the component itself, not only through another component. */
+    readonly isDirect: boolean;
+    /** The ids of its stories that use the component. */
+    readonly stories: readonly string[];
+};
 /** A component (a story file) and its stories. */
 export type AgentComponent = {
     /** `<source>:<title>` in kebab case. */
@@ -48,6 +62,11 @@ export type AgentComponent = {
     readonly file: string;
     /** Its stories: the listed ones in the catalogue's order, then the unlisted ones. */
     readonly stories: readonly AgentStory[];
+    /**
+     * The other components of its source whose stories use it, direct users first; only when asked for (it reads the
+     * package's import graph) and the catalogue offers it.
+     */
+    readonly usedIn?: readonly AgentUsingComponent[];
 };
 /** A source of stories: a package's, or the project's own. */
 export type AgentSource = {
@@ -75,8 +94,8 @@ export type StoryDocument = {
     readonly schema: AgentSchema;
     /** The story, with its links in the view asked for. */
     readonly story: AgentStory;
-    /** Its component's id and title. */
-    readonly component: Pick<AgentComponent, "id" | "title" | "source" | "file">;
+    /** Its component's id and title, and its "Used in" when the catalogue offers it. */
+    readonly component: Pick<AgentComponent, "id" | "title" | "source" | "file" | "usedIn">;
     /**
      * The component's docs as the props panel reads them (its props, their types, defaults and TSDoc); none when the
      * story file names no component, or its docs could not be read (the reason is then in `problems`).
@@ -87,4 +106,15 @@ export type StoryDocument = {
     /** What went wrong while reading it: its module failing to load, its docs failing to be read. */
     readonly problems: readonly string[];
 };
+/** What the open frames reported while someone edited, and the story index's problems. */
+export type ErrorsDocument = {
+    /** The shape's version. */
+    readonly schema: AgentSchema;
+    /** The errors after the number asked for, oldest first: render errors and failed plays. */
+    readonly errors: readonly LiveError[];
+    /** The number of the last error so far: ask for the errors since it next time. */
+    readonly last: number;
+    /** The story index's problems now (a broken story file, a title taken twice). */
+    readonly problems: readonly string[];
+};
 //# sourceMappingURL=agent.types.d.ts.map

package/dist/src/vite/agent.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.types.d.ts","sourceRoot":"","sources":["../../../src/vite/agent.types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,2CAA2C;AAC3C,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC;AAE5B,6DAA6D;AAC7D,MAAM,MAAM,UAAU,GAAG;IACvB,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,UAAU,GAAG;IACvB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,sBAAsB;IACtB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B,CAAC;AAEF,kDAAkD;AAClD,MAAM,MAAM,cAAc,GAAG;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;CACzC,CAAC;AAEF,8DAA8D;AAC9D,MAAM,MAAM,WAAW,GAAG;IACxB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,uEAAuE;AACvE,MAAM,MAAM,eAAe,GAAG;IAC5B,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,kEAAkE;IAClE,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAC;IAC/C,yGAAyG;IACzG,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC,CAAC;AAEF,mFAAmF;AACnF,MAAM,MAAM,aAAa,GAAG;IAC1B,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC;IAC7E;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IACzC,wGAAwG;IACxG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,iGAAiG;IACjG,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC,CAAC"}
+{"version":3,"file":"agent.types.d.ts","sourceRoot":"","sources":["../../../src/vite/agent.types.ts"],"names":[],"mappings":"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"}

package/dist/src/vite/agentApi.d.ts

@@ -7,7 +7,8 @@
  */
 import { type LoadedPreview } from "../frame/storyModule.ts";
 import { type StoryLocation, type StoryTree } from "../storyTree.ts";
-import type { StoriesDocument, StoryDocument, StoryLinks } from "./agent.types.ts";
+import type { UsageIndex } from "../usedIn.ts";
+import type { ErrorsDocument, StoriesDocument, StoryDocument, StoryLinks } from "./agent.types.ts";
 /** Where the catalogue is served, for the links: its page and its frame page. */
 export type CataloguePages = {
     /** The catalogue's page (`http://localhost:5173/`). */
@@ -30,8 +31,9 @@ export declare const storyLinks: (pages: CataloguePages, id: string, view: strin
  * @param tree - its story tree.
  * @param pages - where it is served, for the links.
  * @param view - the view the links open in; empty for the default view.
+ * @param usage - each source's "Used in", by source id, when asked for.
  */
-export declare const storiesDocument: (title: string, tree: StoryTree, pages: CataloguePages, view: string) => StoriesDocument;
+export declare const storiesDocument: (title: string, tree: StoryTree, pages: CataloguePages, view: string, usage?: ReadonlyMap<string, UsageIndex>) => StoriesDocument;
 /**
  * A value as JSON keeps it: functions, symbols, `undefined` and cycles dropped, so a story's args can be printed
  * whatever a story passes (an `fn()` spy, a React element is an object and stays as its JSON).
@@ -63,8 +65,12 @@ export type LoadedStoryParts = {
  * @param parts - its module and its docs, as the dev server loaded them.
  * @param pages - where the catalogue is served, for the links.
  * @param view - the view the links open in; empty for the default view.
+ * @param usage - the tree and the story's source's "Used in", when the catalogue offers it.
  */
-export declare const storyDocument: (location: StoryLocation, parts: LoadedStoryParts, pages: CataloguePages, view: string) => StoryDocument;
+export declare const storyDocument: (location: StoryLocation, parts: LoadedStoryParts, pages: CataloguePages, view: string, usage?: {
+    readonly tree: StoryTree;
+    readonly index: UsageIndex;
+}) => StoryDocument;
 /** Which part of the catalogue a list keeps. */
 export type StoriesFilter = {
     /** A source's id; every source when none. */
@@ -79,6 +85,12 @@ export type StoriesFilter = {
  * @param filter - the source and the text to keep.
  */
 export declare const filteredStories: (document: StoriesDocument, filter: StoriesFilter) => StoriesDocument;
+/**
+ * Whether a value is the errors document, as a client receives it over HTTP.
+ *
+ * @param value - the answer's body.
+ */
+export declare const isErrorsDocument: (value: unknown) => value is ErrorsDocument;
 /**
  * Whether a value is the stories document, as a client receives it over HTTP.
  *

package/dist/src/vite/agentApi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentApi.d.ts","sourceRoot":"","sources":["../../../src/vite/agentApi.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,KAAK,aAAa,EAAyB,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAe,KAAK,aAAa,EAAE,KAAK,SAAS,EAAkB,MAAM,iBAAiB,CAAC;AAElG,OAAO,KAAK,EAGV,eAAe,EACf,aAAa,EACb,UAAU,EACX,MAAM,kBAAkB,CAAC;AAE1B,iFAAiF;AACjF,MAAM,MAAM,cAAc,GAAG;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,cAAc,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,KAAG,UAG3E,CAAC;AAqCH;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,MAAM,EACb,MAAM,SAAS,EACf,OAAO,cAAc,EACrB,MAAM,MAAM,KACX,eAYD,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,OAW1C,CAAC;AAMF,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;CAClC,CAAC;AAcF;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,GACxB,UAAU,aAAa,EACvB,OAAO,gBAAgB,EACvB,OAAO,cAAc,EACrB,MAAM,MAAM,KACX,aA0BF,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,sFAAsF;IACtF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,eAAe,EAAE,QAAQ,aAAa,KAAG,eAUlF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,eAI1B,CAAC;AAEnC;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,aACgD,CAAC"}
+{"version":3,"file":"agentApi.d.ts","sourceRoot":"","sources":["../../../src/vite/agentApi.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,KAAK,aAAa,EAAyB,MAAM,yBAAyB,CAAC;AAEpF,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,SAAS,EAEf,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,KAAK,EAIV,cAAc,EACd,eAAe,EACf,aAAa,EACb,UAAU,EACX,MAAM,kBAAkB,CAAC;AAE1B,iFAAiF;AACjF,MAAM,MAAM,cAAc,GAAG;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,cAAc,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,KAAG,UAG3E,CAAC;AAkEH;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,MAAM,EACb,MAAM,SAAS,EACf,OAAO,cAAc,EACrB,MAAM,MAAM,EACZ,QAAQ,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,KACtC,eAoBD,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,OAW1C,CAAC;AAMF,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;CAClC,CAAC;AAcF;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,GACxB,UAAU,aAAa,EACvB,OAAO,gBAAgB,EACvB,OAAO,cAAc,EACrB,MAAM,MAAM,EACZ,QAAQ;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,KAC/D,aAgCF,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,sFAAsF;IACtF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,eAAe,EAAE,QAAQ,aAAa,KAAG,eAUlF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,cAkB5B,CAAC;AAEhC;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,eAI1B,CAAC;AAEnC;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,aACgD,CAAC"}

package/dist/src/vite/agentApi.js

@@ -7,7 +7,8 @@
  */
 import { isComponentDocs } from "../componentDocs.js";
 import { NO_PREVIEW, readStory } from "../frame/storyModule.js";
-import { componentId } from "../storyTree.js";
+import { isLiveErrorReport } from "../liveErrors.js";
+import { componentId, findComponent } from "../storyTree.js";
 import { frameAddressOf, storyAddressOf } from "../viewState.js";
 /**
  * A story's links in a view.
@@ -28,10 +29,29 @@ const agentStory = (story, isUnlisted, pages, view) => ({
     description: story.description,
     tags: story.tags,
     isUnlisted,
+    ...(story.height === undefined ? {} : { height: story.height }),
     links: storyLinks(pages, story.id, view)
 });
-/** A component of the tree as the documents give it, its listed stories first. */
-const agentComponent = (location, pages, view) => {
+/**
+ * A component's "Used in" as the documents give it: the users the tree still has, by their ids and their stories' ids.
+ *
+ * @param tree - the story tree.
+ * @param sourceId - the component's source.
+ * @param usage - the source's usage.
+ * @param title - the component's title.
+ */
+const agentUsers = (tree, sourceId, usage, title) => (usage[title] ?? []).flatMap((user) => {
+    const id = componentId(sourceId, user.title);
+    const found = findComponent(tree, id)?.component;
+    if (found === undefined)
+        return [];
+    const stories = [...found.stories, ...found.unlisted]
+        .filter((story) => user.stories.includes(story.exportName))
+        .map((story) => story.id);
+    return [{ id, title: user.title, isDirect: user.isDirect, stories }];
+});
+/** A component of the tree as the documents give it, its listed stories first, its "Used in" when given. */
+const agentComponent = (location, pages, view, usage) => {
     const { source, component } = location;
     return {
         id: componentId(source.id, component.title),
@@ -41,7 +61,10 @@ const agentComponent = (location, pages, view) => {
         stories: [
             ...component.stories.map((story) => agentStory(story, false, pages, view)),
             ...component.unlisted.map((story) => agentStory(story, true, pages, view))
-        ]
+        ],
+        ...(usage === undefined
+            ? {}
+            : { usedIn: agentUsers(usage.tree, source.id, usage.index, component.title) })
     };
 };
 /**
@@ -51,12 +74,16 @@ const agentComponent = (location, pages, view) => {
  * @param tree - its story tree.
  * @param pages - where it is served, for the links.
  * @param view - the view the links open in; empty for the default view.
+ * @param usage - each source's "Used in", by source id, when asked for.
  */
-export const storiesDocument = (title, tree, pages, view) => ({
+export const storiesDocument = (title, tree, pages, view, usage) => ({
     schema: 1,
     title,
     sources: tree.sources.map((source) => ({ id: source.id, name: source.name })),
-    components: tree.sources.flatMap((source) => source.families.flatMap((family) => family.groups.flatMap((group) => group.components.map((component) => agentComponent({ source, family, group, component }, pages, view))))),
+    components: tree.sources.flatMap((source) => source.families.flatMap((family) => family.groups.flatMap((group) => group.components.map((component) => {
+        const index = usage?.get(source.id);
+        return agentComponent({ source, family, group, component }, pages, view, index === undefined ? undefined : { tree, index });
+    })))),
     problems: tree.problems
 });
 /**
@@ -99,9 +126,10 @@ const docsOf = (loaded) => {
  * @param parts - its module and its docs, as the dev server loaded them.
  * @param pages - where the catalogue is served, for the links.
  * @param view - the view the links open in; empty for the default view.
+ * @param usage - the tree and the story's source's "Used in", when the catalogue offers it.
  */
-export const storyDocument = (location, parts, pages, view) => {
-    const component = agentComponent(location, pages, view);
+export const storyDocument = (location, parts, pages, view, usage) => {
+    const component = agentComponent(location, pages, view, usage);
     const story = component.stories.find((each) => each.id === location.story.id) ??
         agentStory(location.story, false, pages, view);
     const problems = [];
@@ -124,7 +152,13 @@ export const storyDocument = (location, parts, pages, view) => {
     return {
         schema: 1,
         story,
-        component: { id: component.id, title: component.title, source: component.source, file: component.file },
+        component: {
+            id: component.id,
+            title: component.title,
+            source: component.source,
+            file: component.file,
+            ...(component.usedIn === undefined ? {} : { usedIn: component.usedIn })
+        },
         docs,
         args,
         problems
@@ -144,6 +178,26 @@ export const filteredStories = (document, filter) => {
             (text === undefined || component.title.toLowerCase().includes(text)))
     };
 };
+/**
+ * Whether a value is the errors document, as a client receives it over HTTP.
+ *
+ * @param value - the answer's body.
+ */
+export const isErrorsDocument = (value) => typeof value === "object" &&
+    value !== null &&
+    "schema" in value &&
+    value.schema === 1 &&
+    "errors" in value &&
+    Array.isArray(value.errors) &&
+    value.errors.every((error) => isLiveErrorReport(error) &&
+        "n" in error &&
+        typeof error.n === "number" &&
+        "at" in error &&
+        typeof error.at === "string") &&
+    "last" in value &&
+    typeof value.last === "number" &&
+    "problems" in value &&
+    Array.isArray(value.problems);
 /**
  * Whether a value is the stories document, as a client receives it over HTTP.
  *

package/dist/src/vite/agentApi.js.map

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

package/dist/src/vite/agentRoutes.d.ts

@@ -12,6 +12,7 @@
  */
 import type { IncomingMessage, ServerResponse } from "node:http";
 import type { ViteDevServer } from "vite";
+import type { LiveErrors } from "../liveErrors.ts";
 import type { ResolvedConfig } from "./configFile.ts";
 /** The path the answers live under. */
 export declare const AGENT_API = "/__forgebook/api/";
@@ -30,16 +31,20 @@ export declare const ROOT_HEADER = "forgebook-root";
  * @param load - loads a module on the server (the dev server's `ssrLoadModule`).
  * @param config - the catalogue's configuration.
  * @param route - the path under `AGENT_API` (`stories`, `story`).
- * @param params - the query: `id` for a story, `view` for the links.
+ * @param params - the query: `id` for a story, `view` for the links, `usedIn=true` for the list's "Used in" (a
+ *   story's comes with it when the catalogue offers it).
  * @param origin - where the catalogue is served (`http://localhost:5173`), for the links.
+ * @param live - the errors the open frames reported, on a dev server a browser uses; none for a server of the
+ *   command's own, which no frame reports to.
  */
-export declare const agentAnswer: (load: (id: string) => Promise<unknown>, config: ResolvedConfig, route: string, params: URLSearchParams, origin: string) => Promise<AgentAnswer>;
+export declare const agentAnswer: (load: (id: string) => Promise<unknown>, config: ResolvedConfig, route: string, params: URLSearchParams, origin: string, live?: LiveErrors) => Promise<AgentAnswer>;
 /**
  * The middleware that answers under `AGENT_API`, for a catalogue's dev server.
  *
  * @param server - the dev server, which loads the modules.
  * @param config - the catalogue's configuration.
+ * @param live - the errors the open frames report.
  * @returns a Connect middleware: it answers its own paths and passes every other request on.
  */
-export declare const agentMiddleware: (server: ViteDevServer, config: ResolvedConfig) => (request: IncomingMessage, response: ServerResponse, next: (error?: unknown) => void) => void;
+export declare const agentMiddleware: (server: ViteDevServer, config: ResolvedConfig, live: LiveErrors) => (request: IncomingMessage, response: ServerResponse, next: (error?: unknown) => void) => void;
 //# sourceMappingURL=agentRoutes.d.ts.map

package/dist/src/vite/agentRoutes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentRoutes.d.ts","sourceRoot":"","sources":["../../../src/vite/agentRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAM1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtD,uCAAuC;AACvC,eAAO,MAAM,SAAS,sBAAsB,CAAC;AAuC7C,oDAAoD;AACpD,MAAM,MAAM,WAAW,GAAG;IACxB,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,gHAAgH;AAChH,eAAO,MAAM,WAAW,mBAAmB,CAAC;AAE5C;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EACtC,QAAQ,cAAc,EACtB,OAAO,MAAM,EACb,QAAQ,eAAe,EACvB,QAAQ,MAAM,KACb,OAAO,CAAC,WAAW,CAwBrB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GACzB,QAAQ,aAAa,EAAE,QAAQ,cAAc,MAC7C,SAAS,eAAe,EAAE,UAAU,cAAc,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,KAAG,IAetF,CAAC"}
+{"version":3,"file":"agentRoutes.d.ts","sourceRoot":"","sources":["../../../src/vite/agentRoutes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtD,uCAAuC;AACvC,eAAO,MAAM,SAAS,sBAAsB,CAAC;AAuD7C,oDAAoD;AACpD,MAAM,MAAM,WAAW,GAAG;IACxB,6FAA6F;IAC7F,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,gHAAgH;AAChH,eAAO,MAAM,WAAW,mBAAmB,CAAC;AA0E5C;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EACtC,QAAQ,cAAc,EACtB,OAAO,MAAM,EACb,QAAQ,eAAe,EACvB,QAAQ,MAAM,EACd,OAAO,UAAU,KAChB,OAAO,CAAC,WAAW,CAkBrB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GACzB,QAAQ,aAAa,EAAE,QAAQ,cAAc,EAAE,MAAM,UAAU,MAC/D,SAAS,eAAe,EAAE,UAAU,cAAc,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,KAAG,IAoBtF,CAAC"}

package/dist/src/vite/agentRoutes.js

@@ -2,6 +2,7 @@ import { join } from "node:path";
 import { mergedPreviews, readPreview } from "../frame/storyModule.js";
 import { sourceFiles } from "../sourceFiles.js";
 import { findStory, storyTree } from "../storyTree.js";
+import { sourceUsage } from "../usedIn.js";
 import { storiesDocument, storyDocument } from "./agentApi.js";
 import { AGENT_SOURCES_FILE } from "./pages.js";
 /** The path the answers live under. */
@@ -31,40 +32,99 @@ const settled = async (load) => {
         return { error: error instanceof Error ? error.message : String(error) };
     }
 };
+/**
+ * Each source's "Used in", by source id; a source whose usage cannot be read is left out.
+ *
+ * @param sources - the sources.
+ */
+const usageBySource = async (sources) => {
+    const answers = await Promise.all(sources.map(async (source) => [source.id, await sourceUsage(source)]));
+    return new Map(answers.flatMap(([id, index]) => (typeof index === "string" ? [] : [[id, index]])));
+};
 /** The header that names the catalogue's folder, so a client knows the server it found serves its catalogue. */
 export const ROOT_HEADER = "forgebook-root";
+/**
+ * The errors the open frames reported after the number asked for, and the index's problems.
+ *
+ * @param context - what the routes read.
+ * @param live - the errors, when frames report to this server.
+ */
+const errorsAnswer = (context, live) => {
+    const since = Number(context.params.get("since") ?? "0");
+    const body = {
+        schema: 1,
+        errors: live?.since(Number.isFinite(since) ? since : 0) ?? [],
+        last: live?.last() ?? 0,
+        problems: context.tree.problems
+    };
+    return { status: 200, body };
+};
+/**
+ * The stories, with each component's "Used in" when asked for and offered.
+ *
+ * @param context - what the routes read.
+ */
+const storiesAnswer = async (context) => {
+    const { config, params, tree, pages, view, loaded } = context;
+    const usage = config.lists.usedIn !== false && params.get("usedIn") === "true"
+        ? await usageBySource(loaded.sources)
+        : undefined;
+    return { status: 200, body: storiesDocument(config.title, tree, pages, view, usage) };
+};
+/**
+ * One story in detail, its component's "Used in" when offered.
+ *
+ * @param context - what the routes read.
+ */
+const storyAnswer = async (context) => {
+    const { config, params, tree, pages, view, loaded } = context;
+    const id = params.get("id") ?? "";
+    const location = findStory(tree, id);
+    const source = loaded.sources.find((each) => each.id === location?.source.id);
+    if (location === undefined || source === undefined)
+        return { status: 404, body: { error: `No story "${id}"` } };
+    const files = sourceFiles(source);
+    const file = location.component.file;
+    const parts = {
+        module: await settled(files.stories[file]),
+        docs: await settled(files.docs[file]),
+        preview: loaded.preview
+    };
+    const index = config.lists.usedIn === false ? undefined : await sourceUsage(source);
+    // a usage that cannot be read leaves "Used in" out, never the story
+    const usage = index === undefined || typeof index === "string" ? undefined : { tree, index };
+    return { status: 200, body: storyDocument(location, parts, pages, view, usage) };
+};
 /**
  * Answers one of the API's paths.
  *
  * @param load - loads a module on the server (the dev server's `ssrLoadModule`).
  * @param config - the catalogue's configuration.
  * @param route - the path under `AGENT_API` (`stories`, `story`).
- * @param params - the query: `id` for a story, `view` for the links.
+ * @param params - the query: `id` for a story, `view` for the links, `usedIn=true` for the list's "Used in" (a
+ *   story's comes with it when the catalogue offers it).
  * @param origin - where the catalogue is served (`http://localhost:5173`), for the links.
+ * @param live - the errors the open frames reported, on a dev server a browser uses; none for a server of the
+ *   command's own, which no frame reports to.
  */
-export const agentAnswer = async (load, config, route, params, origin) => {
-    const view = params.get("view") ?? "";
-    const pages = { page: `${origin}/`, frame: `${origin}/frame.html` };
+export const agentAnswer = async (load, config, route, params, origin, live) => {
     try {
         const loaded = agentModuleOf(await load(join(config.dir, AGENT_SOURCES_FILE)));
-        const tree = storyTree(loaded.sources);
-        if (route === "stories")
-            return { status: 200, body: storiesDocument(config.title, tree, pages, view) };
-        if (route !== "story")
-            return { status: 404, body: { error: `No answer at ${AGENT_API}${route}` } };
-        const id = params.get("id") ?? "";
-        const location = findStory(tree, id);
-        const source = loaded.sources.find((each) => each.id === location?.source.id);
-        if (location === undefined || source === undefined)
-            return { status: 404, body: { error: `No story "${id}"` } };
-        const files = sourceFiles(source);
-        const file = location.component.file;
-        const parts = {
-            module: await settled(files.stories[file]),
-            docs: await settled(files.docs[file]),
-            preview: loaded.preview
+        const context = {
+            loaded,
+            tree: storyTree(loaded.sources),
+            config,
+            params,
+            pages: { page: `${origin}/`, frame: `${origin}/frame.html` },
+            view: params.get("view") ?? ""
         };
-        return { status: 200, body: storyDocument(location, parts, pages, view) };
+        if (route === "errors")
+            return errorsAnswer(context, live);
+        if (route === "stories")
+            return await storiesAnswer(context);
+        if (route === "story")
+            return await storyAnswer(context);
+        return { status: 404, body: { error: `No answer at ${AGENT_API}${route}` } };
     }
     catch (error) {
         return { status: 500, body: { error: error instanceof Error ? error.message : String(error) } };
@@ -75,16 +135,17 @@ export const agentAnswer = async (load, config, route, params, origin) => {
  *
  * @param server - the dev server, which loads the modules.
  * @param config - the catalogue's configuration.
+ * @param live - the errors the open frames report.
  * @returns a Connect middleware: it answers its own paths and passes every other request on.
  */
-export const agentMiddleware = (server, config) => (request, response, next) => {
+export const agentMiddleware = (server, config, live) => (request, response, next) => {
     const url = new URL(request.url ?? "/", `http://${request.headers.host ?? "localhost"}`);
     if (!url.pathname.startsWith(AGENT_API)) {
         next();
         return;
     }
     const route = url.pathname.slice(AGENT_API.length);
-    void agentAnswer((id) => server.ssrLoadModule(id), config, route, url.searchParams, url.origin).then(({ status, body }) => {
+    void agentAnswer((id) => server.ssrLoadModule(id), config, route, url.searchParams, url.origin, live).then(({ status, body }) => {
         response.statusCode = status;
         response.setHeader("Content-Type", "application/json");
         response.setHeader(ROOT_HEADER, config.dir);