forgebook 0.0.0-stage → 0.1.2

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

@@ -0,0 +1,72 @@
+/**
+ * A catalogue's configuration, as `forgebook.config.ts` writes it (`export default defineConfig({ … })`), and a
+ * library's preset, as its package ships it (`definePreset`).
+ *
+ * @remarks
+ * The configuration is read on Node, by the Vite plugin and the `forgebook` command: data only, plus the framework's
+ * adapter. What runs in the frames (decorators, providers, a setup) is the preview's (`forgebook.preview.ts`), named
+ * here by its path. A preset is the same data a library gives every catalogue that shows it (its switches, its
+ * languages, its preview); the catalogue's own configuration wins over its presets' (O2).
+ *
+ * @module
+ */
+import type { StoryLanguage } from "@forgebook/story-format/source";
+import type { CatalogueLists } from "../catalogue.ts";
+import type { ViewSwitch } from "../switches.ts";
+import type { FrameworkAdapter } from "./adapter.ts";
+/** What a library's preset gives a catalogue. */
+export type ForgebookPreset = CatalogueLists & {
+    /** The preset's name, in a problem's message (`acme-ui`). */
+    readonly name: string;
+    /** The switches it declares, before the catalogue's. */
+    readonly switches?: readonly ViewSwitch[];
+    /** The languages its stories can be drawn in, before the catalogue's. */
+    readonly languages?: readonly StoryLanguage[];
+    /** The absolute path of its preview module (decorators, parameters, a setup), under the catalogue's. */
+    readonly preview?: string;
+    /** Tags for every frame's `<head>`, before the catalogue's. */
+    readonly head?: string;
+};
+/** A catalogue's configuration: the lists of `CatalogueLists` (widths, backgrounds, story groups…) besides these. */
+export type ForgebookConfig = CatalogueLists & {
+    /** The framework its stories are written for (`react()` of `@forgebook/react/vite`). */
+    readonly framework: FrameworkAdapter;
+    /** Its name, in the page's title and the sidebar. */
+    readonly title: string;
+    /** Its logo: a square image, by path from the configuration's folder; Forgebook's own mark by default. */
+    readonly logo?: string;
+    /** The stories' measured heights, the file `forgebook-heights` writes, served from the public folder; none by default. */
+    readonly heights?: string;
+    /**
+     * The project's own story files, as globs from the configuration's folder (`["src/**\/*.stories.tsx"]`): one source
+     * named after the catalogue. Give `stories` or `sources`, or both.
+     */
+    readonly stories?: readonly string[];
+    /** The packages' story sources, as module specifiers exporting a `source` (`["@acme/ui/stories"]`). */
+    readonly sources?: readonly string[];
+    /** The switches of the toolbar and the View menu; the theme and the contrast when neither it nor a preset declares any. */
+    readonly switches?: readonly ViewSwitch[];
+    /** The languages its stories can be drawn in; none turns the Language row off. */
+    readonly languages?: readonly StoryLanguage[];
+    /** Its preview's path from the configuration's folder; `forgebook.preview.ts` (or `.tsx`) beside it when there. */
+    readonly preview?: string;
+    /** Tags for every frame's `<head>` (a font's link); none by default. */
+    readonly head?: string;
+    /** Folders outside the configuration's whose new story files the dev server watches (each source's `src`). */
+    readonly watch?: readonly string[];
+    /** The libraries' presets, in order; the configuration's own values win over theirs. */
+    readonly presets?: readonly ForgebookPreset[];
+};
+/**
+ * A catalogue's configuration, typed: what `forgebook.config.ts` exports by default.
+ *
+ * @param config - the configuration.
+ */
+export declare const defineConfig: (config: ForgebookConfig) => ForgebookConfig;
+/**
+ * A library's preset, typed: what its package's `./forgebook` export returns.
+ *
+ * @param preset - the preset.
+ */
+export declare const definePreset: (preset: ForgebookPreset) => ForgebookPreset;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/vite/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,iDAAiD;AACjD,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG;IAC7C,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC1C,yEAAyE;IACzE,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC9C,wGAAwG;IACxG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,qHAAqH;AACrH,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG;IAC7C,wFAAwF;IACxF,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0GAA0G;IAC1G,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,0HAA0H;IAC1H,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,uGAAuG;IACvG,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,2HAA2H;IAC3H,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC1C,kFAAkF;IAClF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC9C,mHAAmH;IACnH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,8GAA8G;IAC9G,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,wFAAwF;IACxF,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CAC/C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,eAAe,KAAG,eAAyB,CAAC;AAEjF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,QAAQ,eAAe,KAAG,eAAyB,CAAC"}

package/dist/src/vite/config.js

@@ -0,0 +1,25 @@
+/**
+ * A catalogue's configuration, as `forgebook.config.ts` writes it (`export default defineConfig({ … })`), and a
+ * library's preset, as its package ships it (`definePreset`).
+ *
+ * @remarks
+ * The configuration is read on Node, by the Vite plugin and the `forgebook` command: data only, plus the framework's
+ * adapter. What runs in the frames (decorators, providers, a setup) is the preview's (`forgebook.preview.ts`), named
+ * here by its path. A preset is the same data a library gives every catalogue that shows it (its switches, its
+ * languages, its preview); the catalogue's own configuration wins over its presets' (O2).
+ *
+ * @module
+ */
+/**
+ * A catalogue's configuration, typed: what `forgebook.config.ts` exports by default.
+ *
+ * @param config - the configuration.
+ */
+export const defineConfig = (config) => config;
+/**
+ * A library's preset, typed: what its package's `./forgebook` export returns.
+ *
+ * @param preset - the preset.
+ */
+export const definePreset = (preset) => preset;
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/vite/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAqDH;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAuB,EAAmB,EAAE,CAAC,MAAM,CAAC;AAEjF;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAuB,EAAmB,EAAE,CAAC,MAAM,CAAC"}

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

@@ -0,0 +1,76 @@
+import type { StoryLanguage } from "@forgebook/story-format/source";
+import type { CatalogueLists } from "../catalogue.ts";
+import { type ViewSwitch } from "../switches.ts";
+import type { FrameworkAdapter } from "./adapter.ts";
+import type { ForgebookConfig } from "./config.ts";
+/** The names a configuration file may have, in the order they are looked for. */
+export declare const CONFIG_FILES: string[];
+/** A configuration ready for the pages: its folder, its presets merged, its paths absolute. */
+export type ResolvedConfig = {
+    /** The folder the configuration file is in: Vite's root. */
+    readonly dir: string;
+    /** The framework. */
+    readonly framework: FrameworkAdapter;
+    /** The catalogue's name. */
+    readonly title: string;
+    /** The logo's absolute path; none for Forgebook's own mark. */
+    readonly logo: string | undefined;
+    /** The heights file's address, relative to the pages. */
+    readonly heights: string | undefined;
+    /** The project's own story globs, from the configuration's folder. */
+    readonly stories: readonly string[];
+    /** The sources' module specifiers. */
+    readonly sources: readonly string[];
+    /** The switches, the presets' and the catalogue's merged; none when neither declares any. */
+    readonly switches: readonly ViewSwitch[] | undefined;
+    /** The languages, the presets' and the catalogue's merged. */
+    readonly languages: readonly StoryLanguage[];
+    /** The previews' absolute paths, the presets' first, the catalogue's last. */
+    readonly previews: readonly string[];
+    /** The tags for every frame's `<head>`. */
+    readonly head: string;
+    /** The folders the dev server watches for new story files, absolute. */
+    readonly watch: readonly string[];
+    /** The lists (widths, backgrounds, story groups…), the presets' and the catalogue's merged. */
+    readonly lists: CatalogueLists;
+    /** Whether the project installs Testing Library, whose `canvas` and `userEvent` every play then receives. */
+    readonly hasPlayTools: boolean;
+};
+/** The packages of the play tools: both installed, or the plays get neither. */
+export declare const PLAY_TOOLS_PACKAGES: readonly ["@testing-library/dom", "@testing-library/user-event"];
+/**
+ * Resolves packages as Node does from a folder: a package's (or subpath's) file, or none when it is not there.
+ *
+ * @param dir - the folder, the configuration's.
+ */
+export declare const packageResolver: (dir: string) => (name: string) => string | undefined;
+/**
+ * The configuration file in a folder, when there is one.
+ *
+ * @param dir - the folder.
+ */
+export declare const findConfigFile: (dir: string) => string | undefined;
+/**
+ * The lists of the presets and the catalogue, in that order, merged: a single value (a width range, the grid's step)
+ * the last that gives one; the backgrounds, the story groups and the texts entry by entry, a later one replacing an
+ * earlier one with the same id or name; the tabs turned off and the rules turned off by any.
+ *
+ * @param all - the presets' lists, then the catalogue's.
+ */
+export declare const mergedLists: (all: readonly CatalogueLists[]) => CatalogueLists;
+/**
+ * A configuration with its presets merged and its paths made absolute.
+ *
+ * @param config - the configuration.
+ * @param dir - the folder of its file.
+ * @throws when the merged switches cannot be used.
+ */
+export declare const resolveConfig: (config: ForgebookConfig, dir: string) => ResolvedConfig;
+/**
+ * Loads a configuration file and resolves it.
+ *
+ * @param file - the file's absolute path.
+ * @throws when the file does not load, or exports no usable configuration.
+ */
+export declare const loadConfigFile: (file: string) => Promise<ResolvedConfig>;
+//# sourceMappingURL=configFile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configFile.d.ts","sourceRoot":"","sources":["../../../src/vite/configFile.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEpE,OAAO,KAAK,EAAE,cAAc,EAAc,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,iFAAiF;AACjF,eAAO,MAAM,YAAY,UAAyE,CAAC;AAKnG,+FAA+F;AAC/F,MAAM,MAAM,cAAc,GAAG;IAC3B,4DAA4D;IAC5D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,qBAAqB;IACrB,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,sCAAsC;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,6FAA6F;IAC7F,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,CAAC;IACrD,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IAC7C,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wEAAwE;IACxE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,+FAA+F;IAC/F,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,6GAA6G;IAC7G,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,kEAAmE,CAAC;AAEpG;;;;GAIG;AACH,eAAO,MAAM,eAAe,GACzB,KAAK,MAAM,MACX,MAAM,MAAM,KAAG,MAAM,GAAG,SAOxB,CAAC;AAYJ;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAC2B,CAAC;AAelF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,KAAK,SAAS,cAAc,EAAE,KAAG,cAiC5D,CAAC;AA2BF;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,eAAe,EAAE,KAAK,MAAM,KAAG,cAgCpE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,cAAc,CAMzE,CAAC"}

package/dist/src/vite/configFile.js

@@ -0,0 +1,190 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+/**
+ * A catalogue's configuration file read: found in its folder, loaded, checked, and merged with its presets, as the
+ * plugin and the `forgebook` command use it.
+ *
+ * @remarks
+ * Node loads the file with its types stripped (`forgebook.config.ts`, `.mts` or `.js`). A preset's switches,
+ * languages and head come before the catalogue's, and a switch or language the catalogue declares with the same id
+ * replaces the preset's; its preview sits under the catalogue's. Every problem is named with the file it comes from.
+ *
+ * @module
+ */
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, isAbsolute, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { switchesProblem } from "../switches.js";
+/** The names a configuration file may have, in the order they are looked for. */
+export const CONFIG_FILES = ["forgebook.config.ts", "forgebook.config.mts", "forgebook.config.js"];
+/** The names a preview may have beside the configuration, in the order they are looked for. */
+const PREVIEW_FILES = ["forgebook.preview.ts", "forgebook.preview.tsx", "forgebook.preview.js"];
+/** The packages of the play tools: both installed, or the plays get neither. */
+export const PLAY_TOOLS_PACKAGES = ["@testing-library/dom", "@testing-library/user-event"];
+/**
+ * Resolves packages as Node does from a folder: a package's (or subpath's) file, or none when it is not there.
+ *
+ * @param dir - the folder, the configuration's.
+ */
+export const packageResolver = (dir) => (name) => {
+    const require = createRequire(resolve(dir, "package.json"));
+    try {
+        return require.resolve(name);
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * Whether the project in a folder installs the play tools' packages, found as Node finds them from there.
+ *
+ * @param dir - the configuration's folder.
+ */
+const hasPlayToolsIn = (dir) => {
+    const resolvePackage = packageResolver(dir);
+    return PLAY_TOOLS_PACKAGES.every((name) => resolvePackage(name) !== undefined);
+};
+/**
+ * The configuration file in a folder, when there is one.
+ *
+ * @param dir - the folder.
+ */
+export const findConfigFile = (dir) => CONFIG_FILES.map((name) => resolve(dir, name)).find((file) => existsSync(file));
+/**
+ * Entries by id, a later one replacing an earlier one with the same id in its place.
+ *
+ * @param lists - the lists, in order.
+ */
+const mergedById = (lists) => {
+    const merged = new Map();
+    for (const list of lists)
+        for (const entry of list ?? [])
+            merged.set(entry.id, entry);
+    return [...merged.values()];
+};
+/**
+ * The lists of the presets and the catalogue, in that order, merged: a single value (a width range, the grid's step)
+ * the last that gives one; the backgrounds, the story groups and the texts entry by entry, a later one replacing an
+ * earlier one with the same id or name; the tabs turned off and the rules turned off by any.
+ *
+ * @param all - the presets' lists, then the catalogue's.
+ */
+export const mergedLists = (all) => {
+    const tabs = {};
+    const strings = {};
+    let merged = {};
+    for (const lists of all) {
+        Object.assign(tabs, lists.tabs);
+        Object.assign(strings, lists.strings);
+        merged = {
+            ...merged,
+            ...(lists.id === undefined ? {} : { id: lists.id }),
+            ...(lists.widths === undefined ? {} : { widths: lists.widths }),
+            ...(lists.widthRange === undefined ? {} : { widthRange: lists.widthRange }),
+            ...(lists.zooms === undefined ? {} : { zooms: lists.zooms }),
+            ...(lists.textSizes === undefined ? {} : { textSizes: lists.textSizes }),
+            ...(lists.gridStep === undefined ? {} : { gridStep: lists.gridStep })
+        };
+    }
+    const builtIn = all.findLast((lists) => lists.backgrounds?.builtIn !== undefined)?.backgrounds?.builtIn;
+    const tags = all.findLast((lists) => lists.a11y?.tags !== undefined)?.a11y?.tags;
+    return {
+        ...merged,
+        backgrounds: {
+            ...(builtIn === undefined ? {} : { builtIn }),
+            custom: mergedById(all.map((lists) => lists.backgrounds?.custom))
+        },
+        storyGroups: mergedById(all.map((lists) => lists.storyGroups)),
+        tabs,
+        a11y: {
+            ...(tags === undefined ? {} : { tags }),
+            disabledRules: [...new Set(all.flatMap((lists) => lists.a11y?.disabledRules ?? []))]
+        },
+        strings
+    };
+};
+/**
+ * Why a loaded configuration cannot be used, or none.
+ *
+ * @param config - what the file exports by default.
+ */
+const configProblem = (config) => {
+    if (typeof config !== "object" || config === null)
+        return "it exports no configuration (`export default defineConfig({ … })`)";
+    if (!("framework" in config) || typeof config.framework !== "object" || config.framework === null)
+        return "it names no framework (`framework: react()`)";
+    if (!("title" in config) || typeof config.title !== "string")
+        return "it names no title";
+    const hasStories = "stories" in config && Array.isArray(config.stories) && config.stories.length > 0;
+    const hasSources = "sources" in config && Array.isArray(config.sources) && config.sources.length > 0;
+    if (!hasStories && !hasSources)
+        return 'it names no stories (`stories: ["src/**/*.stories.tsx"]`) and no sources';
+    return undefined;
+};
+/**
+ * Whether a loaded configuration is one: checked by `configProblem`.
+ *
+ * @param config - what the file exports by default.
+ */
+const isConfig = (config) => configProblem(config) === undefined;
+/**
+ * A configuration with its presets merged and its paths made absolute.
+ *
+ * @param config - the configuration.
+ * @param dir - the folder of its file.
+ * @throws when the merged switches cannot be used.
+ */
+export const resolveConfig = (config, dir) => {
+    const presets = config.presets ?? [];
+    const absolute = (path) => (isAbsolute(path) ? path : resolve(dir, path));
+    const declared = [...presets.map((preset) => preset.switches), config.switches];
+    const switches = declared.some((list) => list !== undefined) ? mergedById(declared) : undefined;
+    const problem = switches === undefined ? undefined : switchesProblem(switches);
+    if (problem !== undefined)
+        throw new Error(`${resolve(dir, "forgebook.config")}: ${problem}`);
+    const ownPreview = config.preview === undefined
+        ? PREVIEW_FILES.map((name) => resolve(dir, name)).find((file) => existsSync(file))
+        : absolute(config.preview);
+    return {
+        dir,
+        framework: config.framework,
+        title: config.title,
+        logo: config.logo === undefined ? undefined : absolute(config.logo),
+        heights: config.heights,
+        stories: config.stories ?? [],
+        sources: config.sources ?? [],
+        switches,
+        languages: mergedById([...presets.map((preset) => preset.languages), config.languages]),
+        previews: [
+            ...presets.flatMap((preset) => (preset.preview === undefined ? [] : [preset.preview])),
+            ...(ownPreview === undefined ? [] : [ownPreview])
+        ],
+        head: [...presets.map((preset) => preset.head ?? ""), config.head ?? ""]
+            .filter((tags) => tags !== "")
+            .join("\n"),
+        watch: (config.watch ?? []).map(absolute),
+        lists: mergedLists([...presets, config]),
+        hasPlayTools: hasPlayToolsIn(dir)
+    };
+};
+/**
+ * Loads a configuration file and resolves it.
+ *
+ * @param file - the file's absolute path.
+ * @throws when the file does not load, or exports no usable configuration.
+ */
+export const loadConfigFile = async (file) => {
+    const module = await import(__rewriteRelativeImportExtension(pathToFileURL(file).href));
+    const config = typeof module === "object" && module !== null && "default" in module ? module.default : undefined;
+    if (!isConfig(config))
+        throw new Error(`${file}: ${configProblem(config) ?? "it cannot be read"}`);
+    return resolveConfig(config, dirname(file));
+};
+//# sourceMappingURL=configFile.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configFile.js","sourceRoot":"","sources":["../../../src/vite/configFile.ts"],"names":[],"mappings":";;;;;;;;AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAKzC,OAAO,EAAE,eAAe,EAAmB,MAAM,gBAAgB,CAAC;AAIlE,iFAAiF;AACjF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,qBAAqB,EAAE,sBAAsB,EAAE,qBAAqB,CAAC,CAAC;AAEnG,+FAA+F;AAC/F,MAAM,aAAa,GAAG,CAAC,sBAAsB,EAAE,uBAAuB,EAAE,sBAAsB,CAAC,CAAC;AAkChG,gFAAgF;AAChF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,sBAAsB,EAAE,6BAA6B,CAAU,CAAC;AAEpG;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAC1B,CAAC,GAAW,EAAE,EAAE,CAChB,CAAC,IAAY,EAAsB,EAAE;IACnC,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,CAAC;IAC5D,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAEJ;;;;GAIG;AACH,MAAM,cAAc,GAAG,CAAC,GAAW,EAAW,EAAE;IAC9C,MAAM,cAAc,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAC5C,OAAO,mBAAmB,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,SAAS,CAAC,CAAC;AACjF,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAW,EAAsB,EAAE,CAChE,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;AAElF;;;;GAIG;AACH,MAAM,UAAU,GAAG,CACjB,KAAiD,EACvC,EAAE;IACZ,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,KAAK,MAAM,KAAK,IAAI,IAAI,IAAI,EAAE;YAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACtF,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AAC9B,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAA8B,EAAkB,EAAE;IAC5E,MAAM,IAAI,GAAuC,EAAE,CAAC;IACpD,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,MAAM,GAAmB,EAAE,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;QACxB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,GAAG;YACP,GAAG,MAAM;YACT,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;YACnD,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;YAC/D,GAAG,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;YAC3E,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;YAC5D,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;YACxE,GAAG,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC;SACtE,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,OAAO,KAAK,SAAS,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC;IACxG,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC;IACjF,OAAO;QACL,GAAG,MAAM;QACT,WAAW,EAAE;YACX,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;YAC7C,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;SAClE;QACD,WAAW,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC9D,IAAI;QACJ,IAAI,EAAE;YACJ,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;YACvC,aAAa,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;SACrF;QACD,OAAO;KACR,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,aAAa,GAAG,CAAC,MAAe,EAAsB,EAAE;IAC5D,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI;QAC/C,OAAO,oEAAoE,CAAC;IAC9E,IAAI,CAAC,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI;QAC/F,OAAO,8CAA8C,CAAC;IACxD,IAAI,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,mBAAmB,CAAC;IACzF,MAAM,UAAU,GAAG,SAAS,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IACrG,MAAM,UAAU,GAAG,SAAS,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;IACrG,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU;QAC5B,OAAO,0EAA0E,CAAC;IACpF,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,QAAQ,GAAG,CAAC,MAAe,EAA6B,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC;AAErG;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAuB,EAAE,GAAW,EAAkB,EAAE;IACpF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1F,MAAM,QAAQ,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChF,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChG,MAAM,OAAO,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC/E,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,kBAAkB,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;IAC9F,MAAM,UAAU,GACd,MAAM,CAAC,OAAO,KAAK,SAAS;QAC1B,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAClF,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC/B,OAAO;QACL,GAAG;QACH,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;QACnE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;QAC7B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;QAC7B,QAAQ;QACR,SAAS,EAAE,UAAU,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACvF,QAAQ,EAAE;YACR,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;YACtF,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;SAClD;QACD,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;aACrE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC;aAC7B,IAAI,CAAC,IAAI,CAAC;QACb,KAAK,EAAE,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzC,KAAK,EAAE,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC;QACxC,YAAY,EAAE,cAAc,CAAC,GAAG,CAAC;KAClC,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,IAAY,EAA2B,EAAE;IAC5E,MAAM,MAAM,GAAY,MAAM,MAAM,kCAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAC,CAAC;IAC/D,MAAM,MAAM,GACV,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,SAAS,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACpG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,KAAK,aAAa,CAAC,MAAM,CAAC,IAAI,mBAAmB,EAAE,CAAC,CAAC;IACnG,OAAO,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAC9C,CAAC,CAAC"}

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

@@ -0,0 +1,46 @@
+import type { StoryComponentResult } from "./adapter.ts";
+/** What the extractor answers for a story file: its component's docs, none, or why it cannot be read. */
+export type DocsResult = StoryComponentResult;
+/** A message to the worker: a story file's docs to read, or the news that a source file changed. */
+export type DocsRequest = {
+    /** Read a story file's docs. */
+    readonly kind: "extract";
+    /** The request's number, repeated in its answer. */
+    readonly id: number;
+    /** The story file's absolute path. */
+    readonly storyFile: string;
+} | {
+    /** A source file changed: the programs are renewed on their next read. */
+    readonly kind: "changed";
+};
+/** The worker's answer to a request. */
+export type DocsResponse = {
+    /** The request's number. */
+    readonly id: number;
+    /** The extractor's result. */
+    readonly result: DocsResult;
+};
+/** The docs, read off the dev server's thread. */
+export type DocsExtractor = {
+    /** The component docs of a story file. */
+    readonly extract: (storyFile: string) => Promise<DocsResult>;
+    /** Builds the program that holds a story file, ahead of its first read. */
+    readonly warm: (storyFile: string) => void;
+    /** Tells the worker a source file changed, so the next read sees it. */
+    readonly changed: () => void;
+    /** Ends the worker; a later request starts a new one. */
+    readonly close: () => Promise<void>;
+};
+/** What the worker is started with: the framework's docs module, which it loads before its first answer. */
+export type DocsWorkerData = {
+    /** The URL of the module exporting the framework's `extractStoryComponent`. */
+    readonly docsModule: string;
+};
+/**
+ * A docs extractor with its worker, started on its first request.
+ *
+ * @param docsModule - the URL of the framework's docs module (`FrameworkAdapter.docsModule`).
+ * @returns the extractor.
+ */
+export declare const createDocsExtractor: (docsModule: string) => DocsExtractor;
+//# sourceMappingURL=docsExtractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docsExtractor.d.ts","sourceRoot":"","sources":["../../../src/vite/docsExtractor.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD,yGAAyG;AACzG,MAAM,MAAM,UAAU,GAAG,oBAAoB,CAAC;AAE9C,oGAAoG;AACpG,MAAM,MAAM,WAAW,GACnB;IACE,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,GACD;IACE,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;CAC1B,CAAC;AAEN,wCAAwC;AACxC,MAAM,MAAM,YAAY,GAAG;IACzB,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;CAC7B,CAAC;AAEF,kDAAkD;AAClD,MAAM,MAAM,aAAa,GAAG;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7D,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC,CAAC;AAQF,4GAA4G;AAC5G,MAAM,MAAM,cAAc,GAAG;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,YAAY,MAAM,KAAG,aAuDxD,CAAC"}

package/dist/src/vite/docsExtractor.js

@@ -0,0 +1,88 @@
+/**
+ * The story files' component docs, read in a worker thread (`docsWorker.ts`) so the dev server keeps answering while
+ * a package's TypeScript program is built.
+ *
+ * @remarks
+ * One worker per plugin, started on the first request and kept: its programs make every later read quick, until a
+ * source file changes (`changed`, which the dev server's watcher sends). Requests
+ * are answered in order; a warm-up (`warm`) builds a package's program before a page asks for it, one at a time and
+ * only while the worker has nothing else to do, so a page's request waits behind one warm-up at most, never behind
+ * them all. The worker never keeps the process alive (`unref`), and `close` ends it when the build or the server
+ * ends.
+ *
+ * @module
+ */
+import { extname } from "node:path";
+import { Worker } from "node:worker_threads";
+/**
+ * The worker's module, beside this one and with its extension: `.ts` in the sources, whose types Node strips, `.js`
+ * once built for npm, where Node strips none.
+ */
+const WORKER_URL = new URL(`./docsWorker${extname(import.meta.url)}`, import.meta.url);
+/**
+ * A docs extractor with its worker, started on its first request.
+ *
+ * @param docsModule - the URL of the framework's docs module (`FrameworkAdapter.docsModule`).
+ * @returns the extractor.
+ */
+export const createDocsExtractor = (docsModule) => {
+    let worker;
+    let nextId = 0;
+    // every request sent and not answered yet, a warm-up's answer included (none reads it)
+    const pending = new Map();
+    // the warm-ups not sent yet: one goes out only when nothing is pending
+    const warmUps = [];
+    const started = () => {
+        if (worker !== undefined)
+            return worker;
+        const workerData = { docsModule };
+        const created = new Worker(WORKER_URL, { workerData });
+        created.unref();
+        created.on("message", (response) => {
+            pending.get(response.id)?.(response.result);
+            pending.delete(response.id);
+            sendWarmUp();
+        });
+        // a worker that dies answers every request still waiting with why, and the next request starts a new one
+        created.on("error", (error) => {
+            for (const resolve of pending.values())
+                resolve(`The docs' worker stopped: ${error.message}`);
+            pending.clear();
+            worker = undefined;
+        });
+        worker = created;
+        return created;
+    };
+    const send = (storyFile, resolve) => {
+        const id = nextId++;
+        pending.set(id, resolve);
+        const request = { kind: "extract", id, storyFile };
+        started().postMessage(request);
+    };
+    const sendWarmUp = () => {
+        if (pending.size > 0)
+            return;
+        const storyFile = warmUps.shift();
+        if (storyFile !== undefined)
+            send(storyFile, () => undefined);
+    };
+    return {
+        extract: (storyFile) => new Promise((resolve) => send(storyFile, resolve)),
+        warm: (storyFile) => {
+            warmUps.push(storyFile);
+            sendWarmUp();
+        },
+        changed: () => {
+            // a worker not started yet has no program to renew
+            const request = { kind: "changed" };
+            worker?.postMessage(request);
+        },
+        close: async () => {
+            const running = worker;
+            worker = undefined;
+            warmUps.length = 0;
+            await running?.terminate();
+        }
+    };
+};
+//# sourceMappingURL=docsExtractor.js.map

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

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

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

@@ -0,0 +1,42 @@
+import ts from "typescript-6";
+/** A program and its type checker. */
+export type DocsProgram = {
+    /** The program. */
+    readonly program: ts.Program;
+    /** Its type checker. */
+    readonly checker: ts.TypeChecker;
+};
+/** Marks every program as maybe holding an edited file: each is renewed on its next read. */
+export declare const markSourcesChanged: () => void;
+/**
+ * The program that holds a file: the one of the nearest `tsconfig.json` up its folders, or, when none holds it, a
+ * program of the file alone (`FALLBACK_OPTIONS`, or the configuration's with JavaScript allowed).
+ *
+ * @param file - an absolute path to a source file.
+ * @returns the program, or a message when the configuration above it cannot be read.
+ */
+export declare const programFor: (file: string) => DocsProgram | string;
+/**
+ * The first paragraph of a symbol's TSDoc.
+ *
+ * @param symbol - a declared symbol.
+ * @param checker - the program's type checker.
+ */
+export declare const summaryOf: (symbol: ts.Symbol, checker: ts.TypeChecker) => string;
+/**
+ * The first paragraph of a file's leading comment, its `@module` TSDoc: what the file holds, in a sentence. A
+ * component's own TSDoc is often a bare name ("A button."); its file's comment says what it is and does.
+ *
+ * @param sourceFile - the file.
+ * @returns the paragraph on one line, or an empty text when the file does not open with a `@module` comment.
+ */
+export declare const moduleSummaryOf: (sourceFile: ts.SourceFile) => string;
+/**
+ * A TSDoc tag's text, without the backticks it is often written in.
+ *
+ * @param symbol - a declared symbol.
+ * @param checker - the program's type checker.
+ * @param name - the tag (`defaultValue`).
+ */
+export declare const tagOf: (symbol: ts.Symbol, checker: ts.TypeChecker, name: string) => string | undefined;
+//# sourceMappingURL=docsProgram.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docsProgram.d.ts","sourceRoot":"","sources":["../../../src/vite/docsProgram.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,MAAM,cAAc,CAAC;AAE9B,sCAAsC;AACtC,MAAM,MAAM,WAAW,GAAG;IACxB,mBAAmB;IACnB,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC;IAC7B,wBAAwB;IACxB,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC;CAClC,CAAC;AAWF,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,QAAO,IAErC,CAAC;AA+CF;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,MAAM,KAAG,WAAW,GAAG,MAevD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,WAAW,KAAG,MAG5D,CAAC;AAEZ;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,YAAY,EAAE,CAAC,UAAU,KAAG,MAkB3D,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,GAAI,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,WAAW,EAAE,MAAM,MAAM,KAAG,MAAM,GAAG,SAOzF,CAAC"}