forgebook 0.0.0-stage → 0.1.2

package/dist/src/vite/docsProgram.js

@@ -0,0 +1,144 @@
+/**
+ * The TypeScript programs the extractor reads: one per `tsconfig.json`, created on TypeScript 6's compiler API and
+ * kept until a source file changes (`markSourcesChanged`), then renewed on the next read, reusing what did not change.
+ *
+ * @remarks
+ * The repo type-checks with TypeScript 7, whose native compiler has no JavaScript API; TypeScript 6 (the version
+ * typescript-eslint uses too) reads the same configurations.
+ *
+ * @module
+ */
+import { dirname } from "node:path";
+import ts from "typescript-6";
+/** The last program of each configuration, reused by the next read. */
+const programs = new Map();
+/**
+ * The configurations whose program may hold an edited file: renewed on their next read. A program read again without
+ * a change answers at once, its type checker kept; renewing it on every read cost seconds a read.
+ */
+const outdated = new Set();
+/** Marks every program as maybe holding an edited file: each is renewed on its next read. */
+export const markSourcesChanged = () => {
+    for (const configPath of programs.keys())
+        outdated.add(configPath);
+};
+/**
+ * What a story file is read with when no `tsconfig.json` holds it (a JavaScript project, a `.jsx` story in a project
+ * that does not allow JavaScript): its imports resolved as Vite resolves them, JavaScript and JSX allowed.
+ */
+const FALLBACK_OPTIONS = {
+    allowJs: true,
+    jsx: ts.JsxEmit.ReactJSX,
+    module: ts.ModuleKind.ESNext,
+    moduleResolution: ts.ModuleResolutionKind.Bundler,
+    target: ts.ScriptTarget.ES2022,
+    skipLibCheck: true,
+    noEmit: true
+};
+/**
+ * A program from its root files, the one kept under the same key reused while no source changed.
+ *
+ * @param key - the program's key: its configuration file, or the story file a program of its own is made for.
+ * @param rootNames - its root files.
+ * @param options - its compiler options.
+ */
+const keptProgram = (key, rootNames, options) => {
+    const oldProgram = programs.get(key);
+    if (oldProgram !== undefined && !outdated.has(key))
+        return oldProgram;
+    outdated.delete(key);
+    const program = ts.createProgram({
+        rootNames,
+        options,
+        ...(oldProgram === undefined ? {} : { oldProgram })
+    });
+    programs.set(key, program);
+    return program;
+};
+/**
+ * A program of the story file alone, from which its imports reach the component: for a file no configuration holds.
+ *
+ * @param file - the story file.
+ * @param options - the options of the configuration above it, when there is one; JavaScript is allowed on top.
+ */
+const fileProgram = (file, options) => {
+    const program = keptProgram(`${file}#own`, [file], { ...options, allowJs: true, noEmit: true });
+    return { program, checker: program.getTypeChecker() };
+};
+/**
+ * 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 const programFor = (file) => {
+    const configPath = ts.findConfigFile(dirname(file), ts.sys.fileExists, "tsconfig.json");
+    if (configPath === undefined)
+        return fileProgram(file, FALLBACK_OPTIONS);
+    const parsed = ts.getParsedCommandLineOfConfigFile(configPath, {}, {
+        ...ts.sys,
+        onUnRecoverableConfigFileDiagnostic: () => undefined
+    });
+    if (parsed === undefined)
+        return `${configPath} could not be read`;
+    const program = keptProgram(configPath, parsed.fileNames, parsed.options);
+    if (program.getSourceFile(file) === undefined)
+        return fileProgram(file, parsed.options);
+    return { program, checker: program.getTypeChecker() };
+};
+/**
+ * The first paragraph of a symbol's TSDoc.
+ *
+ * @param symbol - a declared symbol.
+ * @param checker - the program's type checker.
+ */
+export const summaryOf = (symbol, checker) => (ts.displayPartsToString(symbol.getDocumentationComment(checker)).split(/\n\s*\n/)[0] ?? "")
+    .replace(/\s+/g, " ")
+    .trim();
+/**
+ * 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 const moduleSummaryOf = (sourceFile) => {
+    const text = sourceFile.getFullText();
+    const [range] = ts.getLeadingCommentRanges(text, 0) ?? [];
+    if (range === undefined)
+        return "";
+    const comment = text.slice(range.pos, range.end);
+    if (!comment.startsWith("/**") || !comment.includes("@module"))
+        return "";
+    const lines = comment
+        .replace(/^\/\*\*/, "")
+        .replace(/\*\/$/, "")
+        .split("\n")
+        .map((line) => line.replace(/^\s*\* ?/, "").trimEnd());
+    const start = lines.findIndex((line) => line !== "");
+    const paragraph = [];
+    for (const line of lines.slice(Math.max(start, 0))) {
+        if (line === "" || line.startsWith("@"))
+            break;
+        paragraph.push(line);
+    }
+    return paragraph.join(" ").replace(/\s+/g, " ").trim();
+};
+/**
+ * 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 const tagOf = (symbol, checker, name) => {
+    const tag = symbol.getJsDocTags(checker).find((candidate) => candidate.name === name);
+    if (tag === undefined)
+        return undefined;
+    return ts
+        .displayPartsToString(tag.text)
+        .trim()
+        .replace(/^`(.*)`$/, "$1");
+};
+//# sourceMappingURL=docsProgram.js.map

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

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=docsWorker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docsWorker.d.ts","sourceRoot":"","sources":["../../../src/vite/docsWorker.ts"],"names":[],"mappings":""}

package/dist/src/vite/docsWorker.js

@@ -0,0 +1,68 @@
+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;
+};
+/**
+ * The worker thread that reads the story files' component docs: TypeScript's program for a package takes seconds to
+ * build, and built on the dev server's own thread it held every other answer (a frame, a documentation file) until
+ * it was done.
+ *
+ * @remarks
+ * Started by `docsExtractor.ts` with the framework's docs module (`adapter.ts`), which it loads once; it keeps the
+ * programs of `docsProgram.ts` between requests, so only a package's first
+ * read builds one, and a changed source file (`{ kind: "changed" }`) renews them on their next read. A request is `{ id, storyFile }`, the answer `{ id, result }`, `extractStoryComponent`'s result as
+ * it is (plain data); a warm-up is a request whose answer nobody reads.
+ *
+ * @module
+ */
+import { parentPort, workerData } from "node:worker_threads";
+import { isDocsModule } from "./adapter.js";
+import { markSourcesChanged } from "./docsProgram.js";
+/** Whether the worker's data names a docs module. */
+const isWorkerData = (value) => typeof value === "object" &&
+    value !== null &&
+    "docsModule" in value &&
+    typeof value.docsModule === "string";
+/** The framework's extractor, or why it could not be loaded: every request is then answered with that. */
+const loadExtractor = async () => {
+    if (!isWorkerData(workerData))
+        return "The docs' worker was started without a docs module";
+    try {
+        const module = await import(__rewriteRelativeImportExtension(workerData.docsModule));
+        if (isDocsModule(module))
+            return module.extractStoryComponent;
+        return `${workerData.docsModule} exports no extractStoryComponent`;
+    }
+    catch (error) {
+        return `${workerData.docsModule} could not be loaded: ${error instanceof Error ? error.message : String(error)}`;
+    }
+};
+/** The framework's extractor, loaded once, before the first answer. */
+const extractor = loadExtractor();
+/** The extractor's result, or why it threw: a throw would end the worker and every request waiting on it. */
+const extracted = async (storyFile) => {
+    const extract = await extractor;
+    if (typeof extract === "string")
+        return extract;
+    try {
+        return extract(storyFile);
+    }
+    catch (error) {
+        return `${storyFile}: the docs could not be read: ${error instanceof Error ? error.message : String(error)}`;
+    }
+};
+parentPort?.on("message", (request) => {
+    if (request.kind === "changed") {
+        markSourcesChanged();
+        return;
+    }
+    void extracted(request.storyFile).then((result) => {
+        const response = { id: request.id, result };
+        parentPort?.postMessage(response);
+    });
+});
+//# sourceMappingURL=docsWorker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docsWorker.js","sourceRoot":"","sources":["../../../src/vite/docsWorker.ts"],"names":[],"mappings":";;;;;;;;AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAA8B,YAAY,EAAE,MAAM,cAAc,CAAC;AAExE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,qDAAqD;AACrD,MAAM,YAAY,GAAG,CAAC,KAAc,EAA2B,EAAE,CAC/D,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACd,YAAY,IAAI,KAAK;IACrB,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,CAAC;AAEvC,0GAA0G;AAC1G,MAAM,aAAa,GAAG,KAAK,IAA6C,EAAE;IACxE,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC;QAAE,OAAO,oDAAoD,CAAC;IAC3F,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,MAAM,MAAM,kCAAC,UAAU,CAAC,UAAU,EAAC,CAAC;QAC5D,IAAI,YAAY,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC,qBAAqB,CAAC;QAC9D,OAAO,GAAG,UAAU,CAAC,UAAU,mCAAmC,CAAC;IACrE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,UAAU,CAAC,UAAU,yBAAyB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACnH,CAAC;AACH,CAAC,CAAC;AAEF,uEAAuE;AACvE,MAAM,SAAS,GAAG,aAAa,EAAE,CAAC;AAElC,6GAA6G;AAC7G,MAAM,SAAS,GAAG,KAAK,EAAE,SAAiB,EAAmC,EAAE;IAC7E,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC;IAChC,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,SAAS,iCAAiC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAC/G,CAAC;AACH,CAAC,CAAC;AAEF,UAAU,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,OAAoB,EAAQ,EAAE;IACvD,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,kBAAkB,EAAE,CAAC;QACrB,OAAO;IACT,CAAC;IACD,KAAK,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;QAChD,MAAM,QAAQ,GAAiB,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC;QAC1D,UAAU,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * The rewrite that shows interaction states without the pointer or the keyboard: every user-action pseudo-class also
+ * matches inside an element that forces it.
+ *
+ * @remarks
+ * `:hover` becomes `:is(:hover, [data-forgebook-force~="hover"], [data-forgebook-force~="hover"] *)`, and so on for
+ * `:active`, `:focus`, `:focus-visible` and `:focus-within`, at every depth (inside `:is()`, `:not()`, `:has()`). The
+ * real state still works, the specificity stays the same (an attribute weighs what a pseudo-class does), and the
+ * library's CSS carries nothing for the catalogue: the rewrite runs only in the catalogue's build, as a Lightning CSS
+ * visitor. A story forces a state with `parameters.forceState` (on its root) or `data-forgebook-force` on a
+ * part.
+ *
+ * @module
+ */
+import type { CustomAtRules, Selector, Visitor } from "lightningcss";
+/** The attribute that forces states on an element and everything inside it. */
+export declare const FORCE_ATTRIBUTE = "data-forgebook-force";
+/**
+ * One selector with every forceable pseudo-class matching its forced form too.
+ *
+ * @param selector - a selector, as Lightning CSS parses it.
+ * @returns the rewritten selector; the same components when it holds no forceable state.
+ */
+export declare const forcedSelector: (selector: Selector) => Selector;
+/** The Lightning CSS visitor that applies the rewrite to every style sheet the catalogue builds. */
+export declare const FORCED_STATES_VISITOR: Visitor<CustomAtRules>;
+//# sourceMappingURL=forcedStates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"forcedStates.d.ts","sourceRoot":"","sources":["../../../src/vite/forcedStates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAqB,OAAO,EAAE,MAAM,cAAc,CAAC;AAExF,+EAA+E;AAC/E,eAAO,MAAM,eAAe,yBAAyB,CAAC;AAwCtD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,QAAQ,KAAG,QAKjD,CAAC;AAEJ,oGAAoG;AACpG,eAAO,MAAM,qBAAqB,EAAE,OAAO,CAAC,aAAa,CAAgC,CAAC"}

package/dist/src/vite/forcedStates.js

@@ -0,0 +1,60 @@
+/**
+ * The rewrite that shows interaction states without the pointer or the keyboard: every user-action pseudo-class also
+ * matches inside an element that forces it.
+ *
+ * @remarks
+ * `:hover` becomes `:is(:hover, [data-forgebook-force~="hover"], [data-forgebook-force~="hover"] *)`, and so on for
+ * `:active`, `:focus`, `:focus-visible` and `:focus-within`, at every depth (inside `:is()`, `:not()`, `:has()`). The
+ * real state still works, the specificity stays the same (an attribute weighs what a pseudo-class does), and the
+ * library's CSS carries nothing for the catalogue: the rewrite runs only in the catalogue's build, as a Lightning CSS
+ * visitor. A story forces a state with `parameters.forceState` (on its root) or `data-forgebook-force` on a
+ * part.
+ *
+ * @module
+ */
+/** The attribute that forces states on an element and everything inside it. */
+export const FORCE_ATTRIBUTE = "data-forgebook-force";
+/** The pseudo-classes the rewrite reaches. */
+const FORCEABLE = ["hover", "active", "focus", "focus-visible", "focus-within"];
+/** Whether a pseudo-class kind is one the catalogue forces. */
+const isForceable = (kind) => FORCEABLE.some((state) => state === kind);
+/** `[data-forgebook-force~="<state>"]`. */
+const forcingAttribute = (state) => ({
+    type: "attribute",
+    name: FORCE_ATTRIBUTE,
+    operation: { operator: "includes", value: state }
+});
+/** `:is(:<state>, [force~=state], [force~=state] *)`: the state, real or forced. */
+const realOrForced = (state) => ({
+    type: "pseudo-class",
+    kind: "is",
+    selectors: [
+        [{ type: "pseudo-class", kind: state }],
+        [forcingAttribute(state)],
+        [forcingAttribute(state), { type: "combinator", value: "descendant" }, { type: "universal" }]
+    ]
+});
+/** A pseudo-class that holds other selectors, rewritten inside. */
+const withNested = (component) => {
+    if (component.type !== "pseudo-class")
+        return component;
+    if (component.kind === "is" ||
+        component.kind === "where" ||
+        component.kind === "not" ||
+        component.kind === "has") {
+        return { ...component, selectors: component.selectors.map(forcedSelector) };
+    }
+    return component;
+};
+/**
+ * One selector with every forceable pseudo-class matching its forced form too.
+ *
+ * @param selector - a selector, as Lightning CSS parses it.
+ * @returns the rewritten selector; the same components when it holds no forceable state.
+ */
+export const forcedSelector = (selector) => selector.map((component) => component.type === "pseudo-class" && isForceable(component.kind)
+    ? realOrForced(component.kind)
+    : withNested(component));
+/** The Lightning CSS visitor that applies the rewrite to every style sheet the catalogue builds. */
+export const FORCED_STATES_VISITOR = { Selector: forcedSelector };
+//# sourceMappingURL=forcedStates.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"forcedStates.js","sourceRoot":"","sources":["../../../src/vite/forcedStates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAEtD,8CAA8C;AAC9C,MAAM,SAAS,GAA2B,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;AAExG,+DAA+D;AAC/D,MAAM,WAAW,GAAG,CAAC,IAAY,EAAuB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;AAErG,2CAA2C;AAC3C,MAAM,gBAAgB,GAAG,CAAC,KAAkB,EAAqB,EAAE,CAAC,CAAC;IACnE,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,eAAe;IACrB,SAAS,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE;CAClD,CAAC,CAAC;AAEH,oFAAoF;AACpF,MAAM,YAAY,GAAG,CAAC,KAAkB,EAAqB,EAAE,CAAC,CAAC;IAC/D,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,IAAI;IACV,SAAS,EAAE;QACT,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACvC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;KAC9F;CACF,CAAC,CAAC;AAEH,mEAAmE;AACnE,MAAM,UAAU,GAAG,CAAC,SAA4B,EAAqB,EAAE;IACrE,IAAI,SAAS,CAAC,IAAI,KAAK,cAAc;QAAE,OAAO,SAAS,CAAC;IACxD,IACE,SAAS,CAAC,IAAI,KAAK,IAAI;QACvB,SAAS,CAAC,IAAI,KAAK,OAAO;QAC1B,SAAS,CAAC,IAAI,KAAK,KAAK;QACxB,SAAS,CAAC,IAAI,KAAK,KAAK,EACxB,CAAC;QACD,OAAO,EAAE,GAAG,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,CAAC;IAC9E,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAkB,EAAY,EAAE,CAC7D,QAAQ,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CACzB,SAAS,CAAC,IAAI,KAAK,cAAc,IAAI,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC;IAC9D,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC;IAC9B,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAC1B,CAAC;AAEJ,oGAAoG;AACpG,MAAM,CAAC,MAAM,qBAAqB,GAA2B,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC"}

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

@@ -0,0 +1,28 @@
+import type { Plugin } from "vite";
+import type { FrameworkAdapter } from "./adapter.ts";
+import { type ResolvedConfig } from "./configFile.ts";
+/** The plugin's options. */
+export type ForgebookPluginOptions = {
+    /**
+     * A catalogue's configuration already read (the `forgebook` command passes it). Without it, the plugin reads the
+     * `forgebook.config.ts` in Vite's root when there is one, and then makes the catalogue's two pages.
+     */
+    readonly config?: ResolvedConfig;
+    /**
+     * The framework the stories are written for, where there is no configuration: a package's own test page of the
+     * frame, which the plugin only indexes and documents (`react()` of `@forgebook/react/vite`).
+     */
+    readonly framework?: FrameworkAdapter;
+    /** Folders outside the app the dev server watches for new story files, beside the configuration's `watch`. */
+    readonly watch?: readonly string[];
+};
+/**
+ * The catalogue's Vite plugin: the story index, the docs, the code and the Markdown of the stories, the forced-states
+ * rewrite of every style sheet and, with a configuration, the catalogue's two pages.
+ *
+ * @param options - the configuration (read from Vite's root when not given), or the framework alone, and the folders
+ * to watch.
+ * @returns the plugin, for the app's `plugins`.
+ */
+export declare const forgebookPlugin: (options?: ForgebookPluginOptions) => Plugin;
+//# sourceMappingURL=forgebookPlugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"forgebookPlugin.d.ts","sourceRoot":"","sources":["../../../src/vite/forgebookPlugin.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,MAAM,EAA6B,MAAM,MAAM,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGrD,OAAO,EAAmD,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAwEvG,4BAA4B;AAC5B,MAAM,MAAM,sBAAsB,GAAG;IACnC;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IACtC,8GAA8G;IAC9G,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,CAAC;AA+KF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAAI,UAAS,sBAA2B,KAAG,MAqJtE,CAAC"}