forgebook 0.0.0-stage → 0.1.0

package/dist/src/vite/pages.js

@@ -0,0 +1,171 @@
+/**
+ * The two pages a catalogue is made of, as the plugin generates them from its configuration: their HTML, the
+ * entries that mount the shell and the frame, the configuration the pages read, and the source of the project's own
+ * stories. Pure: a resolved configuration in, text out.
+ *
+ * @remarks
+ * An app writes no page: the shell's entry mounts the shell with the configuration's data, its sources and the
+ * framework's code writer; the frame's mounts the framework's frame with the sources and the previews. The sources
+ * are imported by specifier (each exports `source`), the project's own stories through a generated source, the
+ * previews and the logo by path, so their code is bundled as any import is.
+ *
+ * @module
+ */
+import { join } from "node:path";
+import { PLAY_TOOLS_PACKAGES } from "./configFile.js";
+/** The pages, by their file name. */
+export const PAGE_FILES = ["index.html", "frame.html"];
+/** The module the pages read the configuration's data from. */
+export const CONFIG_MODULE = "virtual:forgebook/config";
+/**
+ * The entries the pages load, by page: file names in the configuration's folder, never written to disk. Named as
+ * files rather than virtual modules because the build names a page's chunk and its style sheet after its entry, and a
+ * virtual module's id cannot be part of a file name.
+ */
+export const PAGE_ENTRIES = {
+    "index.html": ".forgebook-shell.ts",
+    "frame.html": ".forgebook-frame.ts"
+};
+/** 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 project's own stories' source id. */
+export const OWN_SOURCE_ID = "stories";
+/**
+ * Text set in HTML: its `<`, `>`, `&` and quotes escaped.
+ *
+ * @param text - the text.
+ */
+const escaped = (text) => text.replace(/[&<>"]/g, (character) => `&#${character.charCodeAt(0)};`);
+/**
+ * A page's HTML: its title, the frame's head tags, the root the entry mounts in.
+ *
+ * @param page - the page.
+ * @param config - the configuration.
+ */
+export const pageHtml = (page, config) => [
+    "<!doctype html>",
+    '<html lang="en">',
+    "  <head>",
+    '    <meta charset="utf-8" />',
+    '    <meta name="viewport" content="width=device-width, initial-scale=1" />',
+    `    <title>${escaped(page === "index.html" ? config.title : "Story")}</title>`,
+    ...(page === "frame.html" && config.head !== "" ? [config.head] : []),
+    "  </head>",
+    "  <body>",
+    '    <div id="root"></div>',
+    `    <script type="module" src="/${PAGE_ENTRIES[page]}"></script>`,
+    "  </body>",
+    "</html>",
+    ""
+].join("\n");
+/**
+ * The configuration's data, as the pages' module exports it.
+ *
+ * @param config - the configuration.
+ */
+export const configModule = (config) => {
+    const data = {
+        title: config.title,
+        heights: config.heights,
+        switches: config.switches,
+        languages: config.languages,
+        lists: config.lists
+    };
+    return `export default ${JSON.stringify(data)};`;
+};
+/**
+ * The imports of the sources, and the list they make: the project's own stories first, then each package's.
+ *
+ * @param config - the configuration.
+ */
+const sourcesCode = (config) => {
+    const own = config.stories.length > 0 ? [`./${STORIES_SOURCE_FILE}`] : [];
+    const specifiers = [...own.map((file) => join(config.dir, file.slice(2))), ...config.sources];
+    return {
+        imports: specifiers.map((specifier, index) => `import { source as source${index} } from ${JSON.stringify(specifier)};`),
+        list: `[${specifiers.map((_specifier, index) => `source${index}`).join(", ")}]`
+    };
+};
+/**
+ * The shell's entry: the shell mounted with the configuration's data, the logo, the sources and the code writer.
+ *
+ * @param config - the configuration.
+ */
+export const shellEntry = (config) => {
+    const sources = sourcesCode(config);
+    return [
+        'import { mountShell } from "forgebook/shell";',
+        `import { codeOf } from ${JSON.stringify(config.framework.pages.code)};`,
+        `import config from ${JSON.stringify(CONFIG_MODULE)};`,
+        ...(config.logo === undefined ? [] : [`import logo from ${JSON.stringify(`${config.logo}?url`)};`]),
+        ...sources.imports,
+        'const root = document.getElementById("root");',
+        "if (root !== null)",
+        "  mountShell(root, {",
+        "    title: config.title,",
+        ...(config.logo === undefined ? [] : ["    logo,"]),
+        ...(config.heights === undefined ? [] : ["    heights: config.heights,"]),
+        `    sources: ${sources.list},`,
+        '    frameUrl: "frame.html",',
+        "    languages: config.languages,",
+        ...(config.switches === undefined ? [] : ["    switches: config.switches,"]),
+        "    lists: config.lists,",
+        "    codeOf",
+        "  });",
+        ""
+    ].join("\n");
+};
+/**
+ * The frame's loader of the play tools: Testing Library's `within` and `userEvent`, imported on the first play, so a
+ * catalogue whose stories have no play never loads them.
+ */
+const playToolsLoader = () => {
+    const imports = PLAY_TOOLS_PACKAGES.map((name) => `import(${JSON.stringify(name)})`).join(", ");
+    return [
+        "    playTools: async () => {",
+        `      const [dom, events] = await Promise.all([${imports}]);`,
+        "      return { within: dom.within, userEvent: events.userEvent };",
+        "    },"
+    ].join("\n");
+};
+/**
+ * The frame's entry: the framework's frame mounted with the sources, the configuration's data and the previews.
+ *
+ * @param config - the configuration.
+ */
+export const frameEntry = (config) => {
+    const sources = sourcesCode(config);
+    return [
+        `import { mountFrame } from ${JSON.stringify(config.framework.pages.frame)};`,
+        `import config from ${JSON.stringify(CONFIG_MODULE)};`,
+        ...sources.imports,
+        ...config.previews.map((file, index) => `import * as preview${index} from ${JSON.stringify(file)};`),
+        'const root = document.getElementById("root");',
+        "if (root !== null)",
+        "  void mountFrame(root, {",
+        `    sources: ${sources.list},`,
+        "    languages: config.languages,",
+        ...(config.switches === undefined ? [] : ["    switches: config.switches,"]),
+        "    lists: config.lists,",
+        ...(config.hasPlayTools ? [playToolsLoader()] : []),
+        `    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.
+ *
+ * @param config - the configuration.
+ */
+export const storiesSourceModule = (config) => [
+    ...config.stories.map((pattern, index) => `import files${index} from ${JSON.stringify(`./${pattern.replace(/^\.\//, "")}?forgebook-files`)};`),
+    "export const source = {",
+    `  id: ${JSON.stringify(OWN_SOURCE_ID)},`,
+    `  name: ${JSON.stringify(config.title)},`,
+    `  files: [${config.stories.map((_pattern, index) => `files${index}`).join(", ")}],`,
+    "  sheets: { required: [], theme: [], restyled: [] }",
+    "};",
+    ""
+].join("\n");
+//# sourceMappingURL=pages.js.map

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

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

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

@@ -0,0 +1,30 @@
+import { type ResolvedConfig } from "./configFile.ts";
+/**
+ * Resolves a package as Node would from the catalogue's folder: its file's real path, or none when it is not there.
+ *
+ * @param name - the package or one of its subpaths.
+ */
+export type Resolve = (name: string) => string | undefined;
+/**
+ * The packages to pre-bundle for a catalogue.
+ *
+ * @param config - the catalogue's configuration.
+ * @param resolve - resolves a package from the catalogue's folder.
+ * @param resolveOwn - resolves a package from the core's own folder.
+ */
+export declare const prebundled: (config: ResolvedConfig, resolve: Resolve, resolveOwn: Resolve) => string[];
+/**
+ * The story files Vite scans for what their components import, before the first page opens: the project's own
+ * patterns, and each source's, read from its module's `?forgebook-files` imports (relative to the module). A source
+ * the project cannot resolve, or read, adds none.
+ *
+ * @remarks
+ * Without the sources' files, a package a source's stories import (`storybook/test`, a component's own dependency) is
+ * found only when a page imports it, and the page reloads once.
+ *
+ * @param config - the catalogue's configuration.
+ * @param resolve - resolves a source's module from the catalogue's folder.
+ * @param readText - reads a file's text; none when it cannot.
+ */
+export declare const scannedEntries: (config: ResolvedConfig, resolve: Resolve, readText: (file: string) => string | undefined) => string[];
+//# sourceMappingURL=prebundled.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prebundled.d.ts","sourceRoot":"","sources":["../../../src/vite/prebundled.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAmB3E;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAK3D;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,cAAc,EAAE,SAAS,OAAO,EAAE,YAAY,OAAO,KAAG,MAAM,EAiBhG,CAAC;AAKF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GACzB,QAAQ,cAAc,EACtB,SAAS,OAAO,EAChB,UAAU,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,KAC7C,MAAM,EAUR,CAAC"}

package/dist/src/vite/prebundled.js

@@ -0,0 +1,81 @@
+/**
+ * The packages Vite pre-bundles, and the story files it scans, before the catalogue's first page opens, so the pages
+ * never reload while they load.
+ *
+ * @remarks
+ * Vite finds what to pre-bundle by scanning the app's HTML and entries on disk; a catalogue's pages and their entries
+ * are generated (`pages.ts`), so without this list Vite discovers each package as a page imports it, pre-bundles it
+ * then, and reloads the page, more than once on a first start. The list is the shell's and the frame's packages (the
+ * shell is React), the framework's, Testing Library's when the project installs it, and Forgebook's own modules when
+ * they come from an installed package (a linked one is source, which Vite does not pre-bundle). A package the project
+ * cannot resolve is left out, since Vite fails on one it cannot find. Pure: a resolver in, names out.
+ *
+ * @module
+ */
+import { dirname, join } from "node:path";
+import { PLAY_TOOLS_PACKAGES } from "./configFile.js";
+/** What the shell and the frame import in the browser from the project's packages (React is a peer of the core). */
+const CORE_BROWSER_DEPENDENCIES = [
+    "react",
+    "react/jsx-runtime",
+    "react/jsx-dev-runtime",
+    "react-dom/client"
+];
+/**
+ * What the frame imports in the browser from the core's own dependencies: named through the core, as
+ * `forgebook > axe-core`, since a project need not be able to resolve them itself.
+ */
+const CORE_OWN_DEPENDENCIES = ["axe-core"];
+/** Forgebook's modules the generated pages import, besides the framework's. */
+const PAGE_MODULES = ["forgebook/shell"];
+/** Whether a resolved file comes from an installed package rather than a linked one. */
+const isInstalled = (file) => file.split(/[\\/]/).includes("node_modules");
+/**
+ * The packages to pre-bundle for a catalogue.
+ *
+ * @param config - the catalogue's configuration.
+ * @param resolve - resolves a package from the catalogue's folder.
+ * @param resolveOwn - resolves a package from the core's own folder.
+ */
+export const prebundled = (config, resolve, resolveOwn) => {
+    const pageModules = [...PAGE_MODULES, config.framework.pages.frame, config.framework.pages.code];
+    const candidates = [
+        ...CORE_BROWSER_DEPENDENCIES,
+        ...(config.framework.browserDependencies ?? []),
+        ...(config.hasPlayTools ? PLAY_TOOLS_PACKAGES : [])
+    ];
+    const installedPages = pageModules.filter((name) => {
+        const file = resolve(name);
+        return file !== undefined && isInstalled(file);
+    });
+    const own = CORE_OWN_DEPENDENCIES.filter((name) => resolveOwn(name) !== undefined).map((name) => `forgebook > ${name}`);
+    return [
+        ...new Set([...candidates.filter((name) => resolve(name) !== undefined), ...own, ...installedPages])
+    ];
+};
+/** A `?forgebook-files` import of a source module: its pattern, before the query. */
+const FILES_IMPORT = /["']([^"']+)\?forgebook-files["']/g;
+/**
+ * The story files Vite scans for what their components import, before the first page opens: the project's own
+ * patterns, and each source's, read from its module's `?forgebook-files` imports (relative to the module). A source
+ * the project cannot resolve, or read, adds none.
+ *
+ * @remarks
+ * Without the sources' files, a package a source's stories import (`storybook/test`, a component's own dependency) is
+ * found only when a page imports it, and the page reloads once.
+ *
+ * @param config - the catalogue's configuration.
+ * @param resolve - resolves a source's module from the catalogue's folder.
+ * @param readText - reads a file's text; none when it cannot.
+ */
+export const scannedEntries = (config, resolve, readText) => {
+    const fromSources = config.sources.flatMap((specifier) => {
+        const file = resolve(specifier);
+        const text = file === undefined ? undefined : readText(file);
+        if (file === undefined || text === undefined)
+            return [];
+        return [...text.matchAll(FILES_IMPORT)].flatMap((match) => match[1] === undefined ? [] : [join(dirname(file), match[1]).split("\\").join("/")]);
+    });
+    return [...config.stories, ...fromSources];
+};
+//# sourceMappingURL=prebundled.js.map

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

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

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

@@ -0,0 +1,28 @@
+/**
+ * The code a story shows in the catalogue's Code card: each story's `render` as written in its file, read with Vite's
+ * parser, never run.
+ *
+ * @remarks
+ * A story without a `render` draws the meta's component with its args: the shell writes that JSX itself from the args
+ * of the moment, so only the stories with a `render` need their text. A `render` written elsewhere (a helper the
+ * story points to) shows as the name it is given, which is what the file says.
+ *
+ * @module
+ */
+/**
+ * Removes from every line past the first the indentation of the line the code starts on, so a `render` reads as if
+ * written at the left edge.
+ *
+ * @param text - the code.
+ * @param indent - the indentation of the line the code starts on, in characters.
+ */
+export declare const dedented: (text: string, indent: number) => string;
+/**
+ * Each story's `render` text in a story file.
+ *
+ * @param file - the file's path, for the parser (its extension decides TypeScript and JSX) and the messages.
+ * @param text - the file's source.
+ * @returns the texts by export name, or a message saying why the file cannot be read.
+ */
+export declare const storyCode: (file: string, text: string) => Readonly<Record<string, string>> | string;
+//# sourceMappingURL=storyCode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storyCode.d.ts","sourceRoot":"","sources":["../../../src/vite/storyCode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA0BH;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,EAAE,QAAQ,MAAM,KAAG,MAIvD,CAAC;AAmBF;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,KAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAczF,CAAC"}

package/dist/src/vite/storyCode.js

@@ -0,0 +1,80 @@
+/**
+ * The code a story shows in the catalogue's Code card: each story's `render` as written in its file, read with Vite's
+ * parser, never run.
+ *
+ * @remarks
+ * A story without a `render` draws the meta's component with its args: the shell writes that JSX itself from the args
+ * of the moment, so only the stories with a `render` need their text. A `render` written elsewhere (a helper the
+ * story points to) shows as the name it is given, which is what the file says.
+ *
+ * @module
+ */
+import { parseSync } from "vite";
+/** An expression without the TypeScript wrappers around it (`satisfies`, `as`, parentheses). */
+const unwrapped = (expression) => {
+    if (expression.type === "TSSatisfiesExpression" ||
+        expression.type === "TSAsExpression" ||
+        expression.type === "ParenthesizedExpression") {
+        return unwrapped(expression.expression);
+    }
+    return expression;
+};
+/** The `render` property of a story object, when it has one. */
+const renderOf = (object) => object.properties.find((property) => property.type === "Property" &&
+    !property.computed &&
+    property.key.type === "Identifier" &&
+    property.key.name === "render");
+/**
+ * Removes from every line past the first the indentation of the line the code starts on, so a `render` reads as if
+ * written at the left edge.
+ *
+ * @param text - the code.
+ * @param indent - the indentation of the line the code starts on, in characters.
+ */
+export const dedented = (text, indent) => {
+    const [first = "", ...rest] = text.split("\n");
+    const trimmed = rest.map((line) => line.slice(Math.min(indent, line.length - line.trimStart().length)));
+    return [first, ...trimmed].join("\n");
+};
+/** The indentation of the line a position is on. */
+const indentAt = (text, position) => {
+    const lineStart = text.lastIndexOf("\n", position - 1) + 1;
+    const line = text.slice(lineStart, position);
+    return line.length - line.trimStart().length;
+};
+/** A story's `render` text, when the declaration is a story object with one. */
+const renderText = (declarator, text) => {
+    if (declarator.init === null || declarator.init === undefined)
+        return undefined;
+    const init = unwrapped(declarator.init);
+    const render = init.type === "ObjectExpression" ? renderOf(init) : undefined;
+    if (render?.type !== "Property")
+        return undefined;
+    const { start, end } = render.value;
+    return dedented(text.slice(start, end), indentAt(text, start));
+};
+/**
+ * Each story's `render` text in a story file.
+ *
+ * @param file - the file's path, for the parser (its extension decides TypeScript and JSX) and the messages.
+ * @param text - the file's source.
+ * @returns the texts by export name, or a message saying why the file cannot be read.
+ */
+export const storyCode = (file, text) => {
+    const { program, errors } = parseSync(file, text);
+    const [error] = errors;
+    if (error !== undefined)
+        return `${file} does not parse: ${error.message}`;
+    const code = {};
+    for (const statement of program.body) {
+        if (statement.type !== "ExportNamedDeclaration" || statement.declaration?.type !== "VariableDeclaration")
+            continue;
+        for (const declarator of statement.declaration.declarations) {
+            const render = renderText(declarator, text);
+            if (declarator.id.type === "Identifier" && render !== undefined)
+                code[declarator.id.name] = render;
+        }
+    }
+    return code;
+};
+//# sourceMappingURL=storyCode.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storyCode.js","sourceRoot":"","sources":["../../../src/vite/storyCode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAe,SAAS,EAAE,MAAM,MAAM,CAAC;AAE9C,gGAAgG;AAChG,MAAM,SAAS,GAAG,CAAC,UAA6B,EAAqB,EAAE;IACrE,IACE,UAAU,CAAC,IAAI,KAAK,uBAAuB;QAC3C,UAAU,CAAC,IAAI,KAAK,gBAAgB;QACpC,UAAU,CAAC,IAAI,KAAK,yBAAyB,EAC7C,CAAC;QACD,OAAO,SAAS,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AAEF,gEAAgE;AAChE,MAAM,QAAQ,GAAG,CAAC,MAA+B,EAA2B,EAAE,CAC5E,MAAM,CAAC,UAAU,CAAC,IAAI,CACpB,CAAC,QAAQ,EAAE,EAAE,CACX,QAAQ,CAAC,IAAI,KAAK,UAAU;IAC5B,CAAC,QAAQ,CAAC,QAAQ;IAClB,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,YAAY;IAClC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,QAAQ,CACjC,CAAC;AAEJ;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,MAAc,EAAU,EAAE;IAC/D,MAAM,CAAC,KAAK,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxG,OAAO,CAAC,KAAK,EAAE,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC,CAAC;AAEF,oDAAoD;AACpD,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,QAAgB,EAAU,EAAE;IAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC7C,OAAO,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC;AAC/C,CAAC,CAAC;AAEF,gFAAgF;AAChF,MAAM,UAAU,GAAG,CAAC,UAAqC,EAAE,IAAY,EAAsB,EAAE;IAC7F,IAAI,UAAU,CAAC,IAAI,KAAK,IAAI,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAChF,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,KAAK,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,IAAI,MAAM,EAAE,IAAI,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IAClD,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC;IACpC,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AACjE,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,IAAY,EAA6C,EAAE;IACjG,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;IACvB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,GAAG,IAAI,oBAAoB,KAAK,CAAC,OAAO,EAAE,CAAC;IAC3E,MAAM,IAAI,GAA2B,EAAE,CAAC;IACxC,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACrC,IAAI,SAAS,CAAC,IAAI,KAAK,wBAAwB,IAAI,SAAS,CAAC,WAAW,EAAE,IAAI,KAAK,qBAAqB;YACtG,SAAS;QACX,KAAK,MAAM,UAAU,IAAI,SAAS,CAAC,WAAW,CAAC,YAAY,EAAE,CAAC;YAC5D,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAC5C,IAAI,UAAU,CAAC,EAAE,CAAC,IAAI,KAAK,YAAY,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;QACrG,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * The story files patterns match, as paths relative to `root` starting with `./` or `../`, sorted.
+ *
+ * @param root - the folder the patterns are relative to: the declaring module's.
+ * @param patterns - the patterns (`../src/**\/*.stories.tsx`).
+ */
+export declare const storyFileKeys: (root: string, patterns: readonly string[]) => string[];
+/**
+ * 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).
+ * @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;
+//# sourceMappingURL=storyFilesModule.d.ts.map

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

@@ -0,0 +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"}

package/dist/src/vite/storyFilesModule.js

@@ -0,0 +1,64 @@
+/**
+ * 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.
+ *
+ * @remarks
+ * One module per pattern, instead of an import per file: in development the browser fetched every index module one by
+ * one, a few hundred requests per frame (D-438). The keys are the files' paths relative to the declaring module
+ * (`../src/x.stories.tsx`), the same keys `storyFileKeys` gives the tests that read the files from the disk.
+ *
+ * @module
+ */
+import { globSync, readFileSync } from "node:fs";
+import { join, relative, resolve } from "node:path";
+import { autoTitle, patternBase } from "./autoTitle.js";
+import { indexStoryFile } from "./indexStoryFile.js";
+/**
+ * The story files patterns match, as paths relative to `root` starting with `./` or `../`, sorted.
+ *
+ * @param root - the folder the patterns are relative to: the declaring module's.
+ * @param patterns - the patterns (`../src/**\/*.stories.tsx`).
+ */
+export const storyFileKeys = (root, patterns) => patterns
+    .flatMap((pattern) => globSync(pattern, { cwd: root }))
+    .map((file) => {
+    const path = relative(root, join(root, file)).split("\\").join("/");
+    return path.startsWith(".") ? path : `./${path}`;
+})
+    .sort();
+/** 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")}}`;
+/**
+ * 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).
+ * @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;
+    }
+    // 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}`);
+    return [
+        "export default {",
+        `index: ${JSON.stringify(index)},`,
+        `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)`)}`,
+        "};"
+    ].join("\n");
+};
+//# sourceMappingURL=storyFilesModule.js.map

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

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

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

@@ -0,0 +1,34 @@
+/**
+ * A story file's meta, read from its source with the TypeScript compiler's parser: the value of one of its fields, the
+ * component it names and the module it imports that component from.
+ *
+ * @remarks
+ * CSF is the same whatever framework a story is written for, so the plugin, `forgebook-docs` and every framework's
+ * docs extractor read the meta through this module. Pure: a parsed file in, nodes or a specifier out.
+ *
+ * @module
+ */
+import ts from "typescript-6";
+/**
+ * The value the meta writes for one of its fields.
+ *
+ * @param source - the story file, parsed.
+ * @param name - the field's name.
+ */
+export declare const metaField: (source: ts.SourceFile, name: string) => ts.Expression | undefined;
+/**
+ * The meta's `component` identifier in a story file, when it names one.
+ *
+ * @param source - the story file, parsed.
+ */
+export declare const metaComponent: (source: ts.SourceFile) => ts.Expression | undefined;
+/**
+ * The module a story file imports its meta's component from (`./Button`), read from the file alone: no program, so
+ * it answers at once, where the docs need the package's program.
+ *
+ * @param storyFile - the story file's path, for the parser.
+ * @param text - the story file's text.
+ * @returns the import's module specifier, or none when the meta names no imported component.
+ */
+export declare const componentImport: (storyFile: string, text: string) => string | undefined;
+//# sourceMappingURL=storyMeta.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storyMeta.d.ts","sourceRoot":"","sources":["../../../src/vite/storyMeta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,MAAM,cAAc,CAAC;AAuB9B;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,MAAM,KAAG,EAAE,CAAC,UAAU,GAAG,SAK/E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,EAAE,CAAC,UAAU,KAAG,EAAE,CAAC,UAAU,GAAG,SACtC,CAAC;AAEjC;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,WAAW,MAAM,EAAE,MAAM,MAAM,KAAG,MAAM,GAAG,SAgB1E,CAAC"}

package/dist/src/vite/storyMeta.js

@@ -0,0 +1,74 @@
+/**
+ * A story file's meta, read from its source with the TypeScript compiler's parser: the value of one of its fields, the
+ * component it names and the module it imports that component from.
+ *
+ * @remarks
+ * CSF is the same whatever framework a story is written for, so the plugin, `forgebook-docs` and every framework's
+ * docs extractor read the meta through this module. Pure: a parsed file in, nodes or a specifier out.
+ *
+ * @module
+ */
+import ts from "typescript-6";
+/**
+ * The meta's object literal in a story file: its default export, without `satisfies`, `as` and parentheses.
+ *
+ * @param source - the story file, parsed.
+ */
+const metaObject = (source) => {
+    for (const statement of source.statements) {
+        if (!ts.isExportAssignment(statement) || statement.isExportEquals)
+            continue;
+        let expression = statement.expression;
+        while (ts.isSatisfiesExpression(expression) ||
+            ts.isAsExpression(expression) ||
+            ts.isParenthesizedExpression(expression)) {
+            expression = expression.expression;
+        }
+        return ts.isObjectLiteralExpression(expression) ? expression : undefined;
+    }
+    return undefined;
+};
+/**
+ * The value the meta writes for one of its fields.
+ *
+ * @param source - the story file, parsed.
+ * @param name - the field's name.
+ */
+export const metaField = (source, name) => {
+    const property = metaObject(source)?.properties.find((candidate) => ts.isPropertyAssignment(candidate) && candidate.name.getText(source) === name);
+    return property !== undefined && ts.isPropertyAssignment(property) ? property.initializer : undefined;
+};
+/**
+ * The meta's `component` identifier in a story file, when it names one.
+ *
+ * @param source - the story file, parsed.
+ */
+export const metaComponent = (source) => metaField(source, "component");
+/**
+ * The module a story file imports its meta's component from (`./Button`), read from the file alone: no program, so
+ * it answers at once, where the docs need the package's program.
+ *
+ * @param storyFile - the story file's path, for the parser.
+ * @param text - the story file's text.
+ * @returns the import's module specifier, or none when the meta names no imported component.
+ */
+export const componentImport = (storyFile, text) => {
+    const source = ts.createSourceFile(storyFile, text, ts.ScriptTarget.Latest, true);
+    const expression = metaComponent(source);
+    if (expression === undefined || !ts.isIdentifier(expression))
+        return undefined;
+    const name = expression.text;
+    for (const statement of source.statements) {
+        if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier))
+            continue;
+        const clause = statement.importClause;
+        const bindings = clause?.namedBindings;
+        const isNamed = bindings !== undefined &&
+            ts.isNamedImports(bindings) &&
+            bindings.elements.some((element) => element.name.text === name);
+        if (clause?.name?.text === name || isNamed)
+            return statement.moduleSpecifier.text;
+    }
+    return undefined;
+};
+//# sourceMappingURL=storyMeta.js.map

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

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