forgebook 0.1.2 → 0.1.4

package/dist/src/vite/mcpProtocol.js

@@ -0,0 +1,184 @@
+/**
+ * The part of the Model Context Protocol a stdio server with a few tools needs, written here instead of taking the
+ * protocol's SDK: one JSON-RPC message in, its answer out. Pure apart from the tools it calls.
+ *
+ * @remarks
+ * Two eras of the protocol are served, as the specification's backward-compatibility rules describe: the current
+ * stateless one (`2026-07-28`: each request carries its version in `params._meta`, `server/discover` answers what the
+ * server offers) and the handshake one most clients still speak (`2025-11-25` and before: `initialize`, then
+ * requests). An `initialize` puts the session in the handshake era; a request carrying the version in `_meta` is
+ * answered statelessly. The tools never change while the server runs, so their list is cacheable and public.
+ *
+ * @module
+ */
+/** The protocol's current version, stateless. */
+export const MODERN_VERSION = "2026-07-28";
+/** The handshake versions answered: the latest first, which a client asking for another is offered. */
+export const HANDSHAKE_VERSIONS = ["2025-11-25", "2025-06-18", "2025-03-26"];
+/** Every version served, for `server/discover` and for the error a client with another one gets. */
+export const SUPPORTED_VERSIONS = [MODERN_VERSION, ...HANDSHAKE_VERSIONS];
+/** The `_meta` keys of the current era. */
+const META = {
+    version: "io.modelcontextprotocol/protocolVersion",
+    capabilities: "io.modelcontextprotocol/clientCapabilities",
+    serverInfo: "io.modelcontextprotocol/serverInfo"
+};
+/** JSON-RPC's and the protocol's error codes this server answers with. */
+const ERRORS = {
+    parse: -32700,
+    invalidRequest: -32600,
+    methodNotFound: -32601,
+    invalidParams: -32602,
+    unsupportedVersion: -32022
+};
+/** How long a client may keep the tools' list, in ms: they never change while the server runs. */
+const TOOLS_TTL_MS = 300_000;
+/** A new session: no handshake yet. */
+export const NEW_SESSION = { handshakeVersion: undefined };
+/** Whether a value is a plain object. */
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+/** An error answer. */
+const failure = (id, code, message, data) => ({
+    jsonrpc: "2.0",
+    id,
+    error: data === undefined ? { code, message } : { code, message, data }
+});
+/** A result answer. */
+const success = (id, result) => ({
+    jsonrpc: "2.0",
+    id,
+    result
+});
+/** What the stateless era adds to every result: its type and who answered. */
+const modernResult = (server, result) => ({
+    resultType: "complete",
+    ...result,
+    // biome-ignore lint/style/useNamingConvention: the protocol names this field
+    _meta: { [META.serverInfo]: server.info }
+});
+/**
+ * Why a stateless request cannot be answered: its `_meta` lacks the version or the client's capabilities, or names a
+ * version not served.
+ *
+ * @returns the error answer, or none when the request is valid.
+ */
+const modernProblem = (id, meta) => {
+    const version = meta[META.version];
+    if (typeof version !== "string" || !isRecord(meta[META.capabilities]))
+        return failure(id, ERRORS.invalidParams, `A request needs ${META.version} and ${META.capabilities} in _meta`);
+    if (!SUPPORTED_VERSIONS.includes(version))
+        return failure(id, ERRORS.unsupportedVersion, "Unsupported protocol version", {
+            supported: SUPPORTED_VERSIONS,
+            requested: version
+        });
+    return undefined;
+};
+/** The tools' list as the protocol gives it. */
+const toolList = (server) => server.tools.map((tool) => ({
+    name: tool.name,
+    description: tool.description,
+    inputSchema: tool.inputSchema
+}));
+/** A tool's answer as the protocol gives it: its JSON as text and as structured content, then its pictures. */
+const toolResult = async (tool, args) => {
+    const { structured, isError, images = [] } = await tool.call(args);
+    return {
+        content: [
+            { type: "text", text: JSON.stringify(structured) },
+            ...images.map((image) => ({ type: "image", data: image.data, mimeType: image.mimeType }))
+        ],
+        structuredContent: structured,
+        isError
+    };
+};
+/** Answers a request in either era: the methods both share. */
+const answerRequest = async (server, id, method, params, isModern) => {
+    const finish = (result) => success(id, isModern ? modernResult(server, result) : result);
+    if (method === "tools/list")
+        return finish(isModern
+            ? { tools: toolList(server), ttlMs: TOOLS_TTL_MS, cacheScope: "public" }
+            : { tools: toolList(server) });
+    if (method === "tools/call") {
+        const name = params["name"];
+        const tool = server.tools.find((each) => each.name === name);
+        if (tool === undefined)
+            return failure(id, ERRORS.invalidParams, `Unknown tool: ${String(name)}`);
+        const args = params["arguments"];
+        return finish(await toolResult(tool, isRecord(args) ? args : {}));
+    }
+    if (method === "server/discover" && isModern)
+        return finish({
+            supportedVersions: SUPPORTED_VERSIONS,
+            capabilities: { tools: {} },
+            ...(server.instructions === undefined ? {} : { instructions: server.instructions }),
+            ttlMs: TOOLS_TTL_MS,
+            cacheScope: "public"
+        });
+    return failure(id, ERRORS.methodNotFound, `Method not found: ${method}`);
+};
+/** Reads one line as a JSON-RPC message. */
+const readMessage = (line) => {
+    let message;
+    try {
+        message = JSON.parse(line);
+    }
+    catch {
+        return { kind: "invalid", reply: failure(null, ERRORS.parse, "Parse error") };
+    }
+    if (!isRecord(message) || message["jsonrpc"] !== "2.0" || typeof message["method"] !== "string") {
+        const id = isRecord(message) ? (message["id"] ?? null) : null;
+        return { kind: "invalid", reply: failure(id, ERRORS.invalidRequest, "Invalid request") };
+    }
+    // a notification (no id) is never answered: `notifications/initialized`, a cancellation
+    if (!("id" in message))
+        return { kind: "notification" };
+    const params = message["params"];
+    return {
+        kind: "request",
+        id: message["id"],
+        method: message["method"],
+        params: isRecord(params) ? params : {}
+    };
+};
+/** Answers `initialize`: the version asked for when it is served, the latest handshake one otherwise. */
+const initialized = (server, id, params) => {
+    const asked = params["protocolVersion"];
+    const version = HANDSHAKE_VERSIONS.find((each) => each === asked) ?? HANDSHAKE_VERSIONS[0];
+    const result = {
+        protocolVersion: version,
+        capabilities: { tools: {} },
+        serverInfo: server.info,
+        ...(server.instructions === undefined ? {} : { instructions: server.instructions })
+    };
+    return { reply: JSON.stringify(success(id, result)), session: { handshakeVersion: version } };
+};
+/**
+ * Answers one message the client sent: a line of JSON-RPC.
+ *
+ * @param line - the message, one line of JSON.
+ * @param session - what the session remembers.
+ * @param server - who the server is and its tools.
+ * @returns the answer to write (none for a notification) and the session after the message.
+ */
+export const answerMcpMessage = async (line, session, server) => {
+    const read = readMessage(line);
+    if (read.kind === "notification")
+        return { reply: undefined, session };
+    if (read.kind === "invalid")
+        return { reply: JSON.stringify(read.reply), session };
+    const { id, method, params } = read;
+    if (method === "initialize")
+        return initialized(server, id, params);
+    const answer = async () => {
+        if (method === "ping")
+            return success(id, {});
+        const meta = params["_meta"];
+        if (isRecord(meta) && META.version in meta)
+            return modernProblem(id, meta) ?? (await answerRequest(server, id, method, params, true));
+        if (session.handshakeVersion !== undefined)
+            return answerRequest(server, id, method, params, false);
+        return failure(id, ERRORS.invalidParams, `A request needs ${META.version} in _meta, or an initialize first`);
+    };
+    return { reply: JSON.stringify(await answer()), session };
+};
+//# sourceMappingURL=mcpProtocol.js.map

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

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

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

@@ -13,6 +13,11 @@ export declare const CONFIG_MODULE = "virtual:forgebook/config";
 export declare const PAGE_ENTRIES: Readonly<Record<PageFile, string>>;
 /** The file name, in the configuration's folder, of the project's own stories' source (never written to disk). */
 export declare const STORIES_SOURCE_FILE = ".forgebook-stories.ts";
+/**
+ * The file name, in the configuration's folder, of the module the dev server loads to answer tools and agents: the
+ * sources and the previews, as the frame gets them (never written to disk).
+ */
+export declare const AGENT_SOURCES_FILE = ".forgebook-agent.ts";
 /** The project's own stories' source id. */
 export declare const OWN_SOURCE_ID = "stories";
 /**
@@ -40,6 +45,13 @@ export declare const shellEntry: (config: ResolvedConfig) => string;
  * @param config - the configuration.
  */
 export declare const frameEntry: (config: ResolvedConfig) => string;
+/**
+ * The module the dev server loads to answer tools and agents: the sources and the previews the frame mounts, as
+ * values (`sources`, `previews`), loaded on the server with the same imports the pages use.
+ *
+ * @param config - the configuration.
+ */
+export declare const agentSourcesModule: (config: ResolvedConfig) => string;
 /**
  * The source of the project's own stories: one `?forgebook-files` import per glob, named after the catalogue.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../../src/vite/pages.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE3E,qCAAqC;AACrC,eAAO,MAAM,UAAU,uCAAwC,CAAC;AAEhE,0BAA0B;AAC1B,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,+DAA+D;AAC/D,eAAO,MAAM,aAAa,6BAA6B,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAG3D,CAAC;AAEF,kHAAkH;AAClH,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAE3D,4CAA4C;AAC5C,eAAO,MAAM,aAAa,YAAY,CAAC;AAUvC;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,QAAQ,EAAE,QAAQ,cAAc,KAAG,MAgBpD,CAAC;AAEf;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,cAAc,KAAG,MASrD,CAAC;AAkBF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,cAAc,KAAG,MAuBnD,CAAC;AAgBF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,cAAc,KAAG,MAmBnD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,cAAc,KAAG,MAa/C,CAAC"}
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../../src/vite/pages.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE3E,qCAAqC;AACrC,eAAO,MAAM,UAAU,uCAAwC,CAAC;AAEhE,0BAA0B;AAC1B,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,+DAA+D;AAC/D,eAAO,MAAM,aAAa,6BAA6B,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAG3D,CAAC;AAEF,kHAAkH;AAClH,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,kBAAkB,wBAAwB,CAAC;AAExD,4CAA4C;AAC5C,eAAO,MAAM,aAAa,YAAY,CAAC;AAUvC;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,QAAQ,EAAE,QAAQ,cAAc,KAAG,MAgBpD,CAAC;AAEf;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,cAAc,KAAG,MASrD,CAAC;AAkBF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,cAAc,KAAG,MAuBnD,CAAC;AAgBF;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,cAAc,KAAG,MAmBnD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,cAAc,KAAG,MAS3D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,cAAc,KAAG,MAa/C,CAAC"}

package/dist/src/vite/pages.js

@@ -28,6 +28,11 @@ export const PAGE_ENTRIES = {
 };
 /** The file name, in the configuration's folder, of the project's own stories' source (never written to disk). */
 export const STORIES_SOURCE_FILE = ".forgebook-stories.ts";
+/**
+ * The file name, in the configuration's folder, of the module the dev server loads to answer tools and agents: the
+ * sources and the previews, as the frame gets them (never written to disk).
+ */
+export const AGENT_SOURCES_FILE = ".forgebook-agent.ts";
 /** The project's own stories' source id. */
 export const OWN_SOURCE_ID = "stories";
 /**
@@ -153,6 +158,22 @@ export const frameEntry = (config) => {
         ""
     ].join("\n");
 };
+/**
+ * The module the dev server loads to answer tools and agents: the sources and the previews the frame mounts, as
+ * values (`sources`, `previews`), loaded on the server with the same imports the pages use.
+ *
+ * @param config - the configuration.
+ */
+export const agentSourcesModule = (config) => {
+    const sources = sourcesCode(config);
+    return [
+        ...sources.imports,
+        ...config.previews.map((file, index) => `import * as preview${index} from ${JSON.stringify(file)};`),
+        `export const sources = ${sources.list};`,
+        `export const previews = [${config.previews.map((_file, index) => `preview${index}`).join(", ")}];`,
+        ""
+    ].join("\n");
+};
 /**
  * The source of the project's own stories: one `?forgebook-files` import per glob, named after the catalogue.
  *

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

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

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

@@ -1,3 +1,4 @@
+import type { StoryFileIndex } from "@forgebook/story-format/source";
 /**
  * The story files patterns match, as paths relative to `root` starting with `./` or `../`, sorted.
  *
@@ -5,13 +6,39 @@
  * @param patterns - the patterns (`../src/**\/*.stories.tsx`).
  */
 export declare const storyFileKeys: (root: string, patterns: readonly string[]) => string[];
+/**
+ * The id prefix of a group's "Used in" module: the pattern's folder and the pattern follow, as in a `?forgebook-files`
+ * module's id. The plugin answers it (`usageModule.ts`) only when a page asks.
+ */
+export declare const USAGE_PREFIX = "virtual:forgebook-usage:";
+/** Between the folder and the pattern in a usage module's id: no path or pattern holds it. */
+export declare const USAGE_SEPARATOR = "::";
+/** A story file a pattern matches, with its key and its index. */
+export type IndexedStoryFile = {
+    /** Its path relative to the declaring module (`../src/x.stories.tsx`). */
+    readonly key: string;
+    /** Its absolute path. */
+    readonly file: string;
+    /** Its index. */
+    readonly index: StoryFileIndex;
+};
+/**
+ * Every story file a pattern matches, indexed.
+ *
+ * @param root - the declaring module's folder.
+ * @param pattern - the pattern.
+ * @param watch - adds a file whose edit renews the module that read it.
+ * @throws when a story file cannot be indexed.
+ */
+export declare const indexedStoryFiles: (root: string, pattern: string, watch: (file: string) => void) => IndexedStoryFile[];
 /**
  * The code of the module for one pattern.
  *
  * @param root - the declaring module's folder.
  * @param pattern - the pattern before `?forgebook-files`.
  * @param watch - adds a file whose edit renews the module (each story file: its index is in the module).
+ * @param hasUsage - whether the group offers its "Used in" loader (the catalogue did not turn it off).
  * @returns the module's code, or a message saying which file cannot be indexed.
  */
-export declare const storyFilesModule: (root: string, pattern: string, watch: (file: string) => void) => string;
+export declare const storyFilesModule: (root: string, pattern: string, watch: (file: string) => void, hasUsage?: boolean) => string;
 //# sourceMappingURL=storyFilesModule.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"storyFilesModule.d.ts","sourceRoot":"","sources":["../../../src/vite/storyFilesModule.ts"],"names":[],"mappings":"AAmBA;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,EAAE,UAAU,SAAS,MAAM,EAAE,KAAG,MAAM,EAOrE,CAAC;AAMZ;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,EAAE,SAAS,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,KAAG,MA2B/F,CAAC"}
+{"version":3,"file":"storyFilesModule.d.ts","sourceRoot":"","sources":["../../../src/vite/storyFilesModule.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAKrE;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,EAAE,UAAU,SAAS,MAAM,EAAE,KAAG,MAAM,EAOrE,CAAC;AAEZ;;;GAGG;AACH,eAAO,MAAM,YAAY,6BAA6B,CAAC;AAEvD,8FAA8F;AAC9F,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC,kEAAkE;AAClE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iBAAiB;IACjB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,SAAS,MAAM,EACf,OAAO,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,KAC5B,gBAAgB,EAYf,CAAC;AAML;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,MAAM,EACZ,SAAS,MAAM,EACf,OAAO,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC7B,kBAAe,KACd,MAoBF,CAAC"}

package/dist/src/vite/storyFilesModule.js

@@ -1,6 +1,7 @@
 /**
  * The module that answers a `?forgebook-files` import: every story file a pattern matches, as one module with each
- * file's index (read from its source, never run) and the loaders of its module, its component's docs and its code.
+ * file's index (read from its source, never run), the loaders of its module, its component's docs and its code, and
+ * the group's "Used in" loader.
  *
  * @remarks
  * One module per pattern, instead of an import per file: in development the browser fetched every index module one by
@@ -26,6 +27,30 @@ export const storyFileKeys = (root, patterns) => patterns
     return path.startsWith(".") ? path : `./${path}`;
 })
     .sort();
+/**
+ * The id prefix of a group's "Used in" module: the pattern's folder and the pattern follow, as in a `?forgebook-files`
+ * module's id. The plugin answers it (`usageModule.ts`) only when a page asks.
+ */
+export const USAGE_PREFIX = "virtual:forgebook-usage:";
+/** Between the folder and the pattern in a usage module's id: no path or pattern holds it. */
+export const USAGE_SEPARATOR = "::";
+/**
+ * Every story file a pattern matches, indexed.
+ *
+ * @param root - the declaring module's folder.
+ * @param pattern - the pattern.
+ * @param watch - adds a file whose edit renews the module that read it.
+ * @throws when a story file cannot be indexed.
+ */
+export const indexedStoryFiles = (root, pattern, watch) => storyFileKeys(root, [pattern]).map((key) => {
+    const file = resolve(root, key);
+    watch(file);
+    const title = autoTitle(patternBase(pattern), key);
+    const index = indexStoryFile(file, readFileSync(file, "utf8"), title === undefined ? {} : { autoTitle: title });
+    if (typeof index === "string")
+        throw new Error(index);
+    return { key, file, index };
+});
 /** An object literal of a key per file, each value written by `value`. */
 const objectOf = (keys, value) => `{${keys.map((key) => `${JSON.stringify(key)}: ${value(key)}`).join(",\n")}}`;
 /**
@@ -34,20 +59,14 @@ const objectOf = (keys, value) => `{${keys.map((key) => `${JSON.stringify(key)}:
  * @param root - the declaring module's folder.
  * @param pattern - the pattern before `?forgebook-files`.
  * @param watch - adds a file whose edit renews the module (each story file: its index is in the module).
+ * @param hasUsage - whether the group offers its "Used in" loader (the catalogue did not turn it off).
  * @returns the module's code, or a message saying which file cannot be indexed.
  */
-export const storyFilesModule = (root, pattern, watch) => {
-    const keys = storyFileKeys(root, [pattern]);
-    const index = {};
-    for (const key of keys) {
-        const file = resolve(root, key);
-        watch(file);
-        const title = autoTitle(patternBase(pattern), key);
-        const entry = indexStoryFile(file, readFileSync(file, "utf8"), title === undefined ? {} : { autoTitle: title });
-        if (typeof entry === "string")
-            throw new Error(entry);
-        index[key] = entry;
-    }
+export const storyFilesModule = (root, pattern, watch, hasUsage = true) => {
+    const files = indexedStoryFiles(root, pattern, watch);
+    const keys = files.map((file) => file.key);
+    const index = Object.fromEntries(files.map((file) => [file.key, file.index]));
+    const usage = JSON.stringify(`${USAGE_PREFIX}${root}${USAGE_SEPARATOR}${pattern}`);
     // absolute paths: the module has no folder of its own; Vite serves them under /@fs/ in development
     const path = (key) => JSON.stringify(resolve(root, key));
     const query = (key, name) => JSON.stringify(`${resolve(root, key)}?${name}`);
@@ -57,7 +76,8 @@ export const storyFilesModule = (root, pattern, watch) => {
         `stories: ${objectOf(keys, (key) => `() => import(${path(key)})`)},`,
         `docs: ${objectOf(keys, (key) => `() => import(${query(key, "forgebook-docs")}).then((module) => module.default)`)},`,
         `code: ${objectOf(keys, (key) => `() => import(${query(key, "forgebook-code")}).then((module) => module.default)`)},`,
-        `pages: ${objectOf(keys, (key) => `() => import(${query(key, "forgebook-page")}).then((module) => module.default)`)}`,
+        `pages: ${objectOf(keys, (key) => `() => import(${query(key, "forgebook-page")}).then((module) => module.default)`)}${hasUsage ? "," : ""}`,
+        ...(hasUsage ? [`usage: () => import(${usage}).then((module) => module.default)`] : []),
         "};"
     ].join("\n");
 };

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

@@ -1 +1 @@
-{"version":3,"file":"storyFilesModule.js","sourceRoot":"","sources":["../../../src/vite/storyFilesModule.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"storyFilesModule.js","sourceRoot":"","sources":["../../../src/vite/storyFilesModule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAE,QAA2B,EAAY,EAAE,CACnF,QAAQ;KACL,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;KACtD,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;IACZ,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpE,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;AACnD,CAAC,CAAC;KACD,IAAI,EAAE,CAAC;AAEZ;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAEvD,8FAA8F;AAC9F,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC;AAYpC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAAY,EACZ,OAAe,EACf,KAA6B,EACT,EAAE,CACtB,aAAa,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,CAAC;IACZ,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,cAAc,CAC1B,IAAI,EACJ,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAC1B,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAChD,CAAC;IACF,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IACtD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC,CAAC,CAAC;AAEL,0EAA0E;AAC1E,MAAM,QAAQ,GAAG,CAAC,IAAuB,EAAE,KAA8B,EAAU,EAAE,CACnF,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;AAEhF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,IAAY,EACZ,OAAe,EACf,KAA6B,EAC7B,QAAQ,GAAG,IAAI,EACP,EAAE;IACV,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAmC,MAAM,CAAC,WAAW,CAC9D,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAC5C,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,YAAY,GAAG,IAAI,GAAG,eAAe,GAAG,OAAO,EAAE,CAAC,CAAC;IACnF,mGAAmG;IACnG,MAAM,IAAI,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACrG,OAAO;QACL,kBAAkB;QAClB,UAAU,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG;QAClC,YAAY,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG;QACpE,SAAS,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,KAAK,CAAC,GAAG,EAAE,gBAAgB,CAAC,oCAAoC,CAAC,GAAG;QACrH,SAAS,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,KAAK,CAAC,GAAG,EAAE,gBAAgB,CAAC,oCAAoC,CAAC,GAAG;QACrH,UAAU,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,KAAK,CAAC,GAAG,EAAE,gBAAgB,CAAC,oCAAoC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3I,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,uBAAuB,KAAK,oCAAoC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,IAAI;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC,CAAC"}

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

@@ -0,0 +1,45 @@
+/** A component, by the file that declares it and its name there. */
+export type ComponentRef = {
+    /** The declaring file's absolute path. */
+    readonly file: string;
+    /** Its name in that file (`default` for a default export). */
+    readonly name: string;
+};
+/** What one story renders. */
+export type StoryRenders = {
+    /** The story's export. */
+    readonly exportName: string;
+    /** The components its JSX names, or its meta's component when it has none; each once. */
+    readonly renders: readonly ComponentRef[];
+};
+/** One story file's facts. */
+export type StoryFileUsage = {
+    /** The story file's absolute path. */
+    readonly storyFile: string;
+    /** Its meta's component, when the meta names one the checker resolves. */
+    readonly component?: ComponentRef;
+    /** Its stories. */
+    readonly stories: readonly StoryRenders[];
+};
+/** What the worker answers for a group of story files. */
+export type UsageGraph = {
+    /** Each story file's facts, in the order asked; a file no program holds is left out. */
+    readonly files: readonly StoryFileUsage[];
+    /** Each module the rendered components reach, with the package's own modules it imports. */
+    readonly imports: Readonly<Record<string, readonly string[]>>;
+};
+/** A story file and the exports the index lists as its stories. */
+export type UsageRequestFile = {
+    /** The story file's absolute path. */
+    readonly storyFile: string;
+    /** Its stories' exports. */
+    readonly exports: readonly string[];
+};
+/**
+ * The facts of a group of story files: what each story renders, and the import graph the rendered components reach.
+ *
+ * @param requests - the story files and their stories' exports.
+ * @returns the facts, or why a story file's program could not be read.
+ */
+export declare const usageGraph: (requests: readonly UsageRequestFile[]) => UsageGraph | string;
+//# sourceMappingURL=usageGraph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usageGraph.d.ts","sourceRoot":"","sources":["../../../src/vite/usageGraph.ts"],"names":[],"mappings":"AAoBA,oEAAoE;AACpE,MAAM,MAAM,YAAY,GAAG;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,8BAA8B;AAC9B,MAAM,MAAM,YAAY,GAAG;IACzB,0BAA0B;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,yFAAyF;IACzF,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;CAC3C,CAAC;AAEF,8BAA8B;AAC9B,MAAM,MAAM,cAAc,GAAG;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC;IAClC,mBAAmB;IACnB,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;CAC3C,CAAC;AAEF,0DAA0D;AAC1D,MAAM,MAAM,UAAU,GAAG;IACvB,wFAAwF;IACxF,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;IAC1C,4FAA4F;IAC5F,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;CAC/D,CAAC;AAEF,mEAAmE;AACnE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4BAA4B;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;AA0PF;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,SAAS,gBAAgB,EAAE,KAAG,UAAU,GAAG,MAe/E,CAAC"}