@cudoment/cudoc 0.1.0 → 0.3.0

package/dist/node/library.js

@@ -0,0 +1,163 @@
+import fs from "node:fs";
+import path from "node:path";
+import { compileDocument } from "../markdown.js";
+import { collectSections } from "../sections.js";
+import { findHeadingByAnchorId, findSectionEnd, } from "../internal/core/query/sections.js";
+import { buildExportedAst, resolveExportAstOptions } from "./export-ast.js";
+import { validateAstContract } from "../internal/core/ast/validate.js";
+import { hash, posix, safePath, sourceFiles, publishDirectory, writeJson, } from "./storage.js";
+/** Collect async framework compilers before publishing or resolving any embeds. */
+export async function buildDocumentsAsync(options) {
+    const { compiler, ...rest } = options;
+    const compiled = new Map();
+    for (const filePath of sourceFiles(options.sourceRoot)) {
+        const source = fs.readFileSync(filePath, "utf8");
+        const id = posix(path.relative(options.sourceRoot, filePath)).replace(/\.mdx?$/i, "");
+        const format = path.extname(filePath).toLowerCase() === ".mdx" ? "mdx" : "md";
+        compiled.set(id, {
+            source,
+            result: await compiler(source, {
+                id,
+                filePath,
+                options: { ...rest, format },
+            }),
+        });
+    }
+    const library = buildDocuments({
+        ...rest,
+        compiler(source, context) {
+            const cached = compiled.get(context.id);
+            if (!cached || cached.source !== source)
+                throw new Error(`cudoc: source changed during collection: ${context.id}`);
+            return cached.result;
+        },
+    });
+    delete library.compiler;
+    library.asyncCompiler = compiler;
+    return library;
+}
+export function snapshotSource(text, tree, format) {
+    const sections = {};
+    for (const section of collectSections(tree)) {
+        const nodes = section.tree.children;
+        const location = findHeadingByAnchorId(tree, section.anchorId);
+        const siblings = location.parent.children;
+        const endIndex = findSectionEnd(location.parent, location.index, section.heading.depth);
+        const start = section.heading.position?.start.offset;
+        const end = siblings[endIndex]?.position?.start.offset ??
+            location.parent.position?.end.offset ??
+            text.length;
+        const ownEnd = siblings
+            .slice(location.index + 1, endIndex)
+            .find((n) => n.type === "heading")?.position?.start.offset ?? end;
+        if (start === undefined || end === undefined)
+            continue;
+        const dependencies = nodes
+            .filter((n) => ["definition", "footnoteDefinition"].includes(n.type) && n.position)
+            .map((n) => [n.position.start.offset, n.position.end.offset]);
+        sections[section.anchorId] = { start, end, ownEnd, dependencies };
+    }
+    return { text, hash: hash(text), format, sections };
+}
+export function buildDocuments({ sourceRoot, outDir = ".cudoc/documents", compiler, compilerId, routeBase = "/", routeSuffix = "", routes = {}, ...options }) {
+    if (options.host &&
+        !["markdown", "html", "next"].includes(options.host) &&
+        !compiler)
+        throw new Error(`cudoc: ${options.host} collection requires its host compiler`);
+    if (compiler && !compilerId)
+        throw new Error("cudoc: compilerId is required with a custom compiler");
+    const documents = [];
+    const ids = new Set();
+    for (const filePath of sourceFiles(sourceRoot)) {
+        const sourcePath = posix(path.relative(sourceRoot, filePath));
+        const id = sourcePath.replace(/\.mdx?$/i, "");
+        if (ids.has(id.toLowerCase()))
+            throw new Error(`cudoc: duplicate document output: ${sourcePath}`);
+        ids.add(id.toLowerCase());
+        const text = fs.readFileSync(filePath, "utf8");
+        const format = path.extname(filePath).toLowerCase() === ".mdx" ? "mdx" : "md";
+        const config = { ...options, format };
+        const compiled = compiler
+            ? compiler(text, { id, filePath, options: config })
+            : compileDocument(text, config);
+        for (const diagnostic of compiled.diagnostics)
+            process.stderr.write(`${sourcePath}:${diagnostic.position?.start.line ?? 1}: ${diagnostic.code}: ${diagnostic.message}\n`);
+        const source = snapshotSource(text, compiled.tree, format);
+        const tree = buildExportedAst(compiled.tree, resolveExportAstOptions());
+        documents.push({
+            id,
+            sourcePath,
+            route: routes[id] ?? `${routeBase.replace(/\/$/, "")}/${id}${routeSuffix}`,
+            tree,
+            source,
+            frontmatter: compiled.frontmatter,
+        });
+    }
+    const configuration = hash(JSON.stringify({
+        options,
+        routeBase,
+        routeSuffix,
+        routes,
+        compilerId: compilerId ?? "cudoc-markdown-v1",
+    }));
+    const urls = new Set();
+    for (const document of documents) {
+        if (!document.route.startsWith("/") ||
+            document.route.startsWith("//") ||
+            /[?#]/.test(document.route))
+            throw new Error(`cudoc: document route must be a root-relative pathname: ${document.route}`);
+        if (urls.has(document.route))
+            throw new Error(`cudoc: duplicate document route: ${document.route}`);
+        urls.add(document.route);
+    }
+    const library = {
+        documents,
+        options,
+        configuration,
+        compiler,
+        sourceRoot: path.resolve(sourceRoot),
+    };
+    publishDirectory(sourceRoot, outDir, (staging) => {
+        for (const doc of documents) {
+            writeJson(safePath(staging, `documents/${doc.id}.json`), doc.tree);
+            writeJson(safePath(staging, `sources/${doc.id}.json`), doc.source);
+        }
+        writeJson(path.join(staging, "manifest.json"), {
+            schemaVersion: 1,
+            configuration,
+            options,
+            compilerId,
+            documents: documents.map(({ tree, source, ...doc }) => ({
+                ...doc,
+                hash: source.hash,
+                astHash: hash(JSON.stringify(tree)),
+                snapshotHash: hash(JSON.stringify(source)),
+            })),
+        });
+    });
+    return library;
+}
+export function loadLibrary(outDir = ".cudoc/documents", compiler, sourceRoot) {
+    const manifest = JSON.parse(fs.readFileSync(path.join(outDir, "manifest.json"), "utf8"));
+    if (manifest.schemaVersion !== 1 || !Array.isArray(manifest.documents))
+        throw new Error("cudoc: incompatible document manifest; rebuild documents");
+    const documents = manifest.documents.map((entry) => {
+        const tree = JSON.parse(fs.readFileSync(safePath(outDir, `documents/${entry.id}.json`), "utf8"));
+        const source = JSON.parse(fs.readFileSync(safePath(outDir, `sources/${entry.id}.json`), "utf8"));
+        validateAstContract(tree, { requireVersion: true });
+        if (source.hash !== entry.hash ||
+            hash(source.text) !== entry.hash ||
+            hash(JSON.stringify(tree)) !== entry.astHash ||
+            hash(JSON.stringify(source)) !== entry.snapshotHash)
+            throw new Error(`cudoc: stored document hash mismatch: ${entry.id}`);
+        return { ...entry, tree, source };
+    });
+    return {
+        documents,
+        options: manifest.options,
+        configuration: manifest.configuration,
+        compiler,
+        sourceRoot: sourceRoot ? path.resolve(sourceRoot) : undefined,
+    };
+}
+//# sourceMappingURL=library.js.map

package/dist/node/library.js.map

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

package/dist/node/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/node/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,eAAO,MAAM,mBAAmB,SAAS,CAAA;AACzC,eAAO,MAAM,mBAAmB,eAAe,CAAA;AAC/C,eAAO,MAAM,kBAAkB,UAAW,CAAA;AAE1C,MAAM,MAAM,WAAW,GAAG;IACxB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,GAAG;IACrE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CACxB,CAAA;AAED,eAAO,MAAM,kBAAkB,GAC7B,UAAS,WAAgB,KACxB,mBAoBF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAChC,gBAAgB,MAAM,EACtB,SAAS,mBAAmB,KAC3B,MAAM,GAAG,IAoBX,CAAA;AAED,2EAA2E;AAC3E,eAAO,MAAM,aAAa,GACxB,gBAAgB,MAAM,EACtB,SAAS,mBAAmB,KAC3B,MAAM,GAAG,IAMX,CAAA"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/node/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,eAAO,MAAM,mBAAmB,SAAS,CAAA;AACzC,eAAO,MAAM,mBAAmB,eAAe,CAAA;AAC/C,eAAO,MAAM,kBAAkB,UAAkB,CAAA;AAEjD,MAAM,MAAM,WAAW,GAAG;IACxB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,GAAG;IACrE,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CACxB,CAAA;AAED,eAAO,MAAM,kBAAkB,GAC7B,UAAS,WAAgB,KACxB,mBAoBF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAChC,gBAAgB,MAAM,EACtB,SAAS,mBAAmB,KAC3B,MAAM,GAAG,IAoBX,CAAA;AAED,2EAA2E;AAC3E,eAAO,MAAM,aAAa,GACxB,gBAAgB,MAAM,EACtB,SAAS,mBAAmB,KAC3B,MAAM,GAAG,IAMX,CAAA"}

package/dist/node/paths.js

@@ -7,7 +7,7 @@
 import path from "node:path";
 export const DEFAULT_SOURCE_ROOT = "docs";
 export const DEFAULT_OUTPUT_ROOT = ".cudoc/ast";
-export const DEFAULT_EXTENSIONS = [".mdx"];
+export const DEFAULT_EXTENSIONS = [".md", ".mdx"];
 export const resolvePathOptions = (options = {}) => {
     const extensions = options.extensions ?? DEFAULT_EXTENSIONS;
     if (!Array.isArray(extensions) ||

package/dist/node/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/node/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAA;AACzC,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAA;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAM,CAAC,CAAA;AAiB1C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,UAAuB,EAAE,EACJ,EAAE;IACvB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,kBAAkB,CAAA;IAC3D,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QAC1B,UAAU,CAAC,MAAM,KAAK,CAAC;QACvB,CAAC,UAAU,CAAC,KAAK,CACf,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAC9D,EACD,CAAC;QACD,MAAM,IAAI,SAAS,CACjB,mEAAmE,CACpE,CAAA;IACH,CAAC;IAED,OAAO;QACL,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,mBAAmB;QACrD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,mBAAmB;QAC7C,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAC1D,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAA;AACH,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,cAAsB,EACtB,OAA4B,EACb,EAAE;IACjB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;IAChE,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,CAAA;IAChE,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC,CAAA;IAChE,MAAM,iBAAiB,GACrB,cAAc,KAAK,EAAE;QACrB,cAAc,KAAK,IAAI;QACvB,cAAc,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1C,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAA;IAEjC,IAAI,iBAAiB;QAAE,OAAO,IAAI,CAAA;IAClC,IACE,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE,CAAC,EACxE,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,IAAI,OAAO,CAAC,CAAA;AACrD,CAAC,CAAA;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,cAAsB,EACtB,OAA4B,EACb,EAAE;IACjB,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;IACzE,IAAI,CAAC,kBAAkB;QAAE,OAAO,IAAI,CAAA;IAEpC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;AACnE,CAAC,CAAA"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/node/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAA;AACzC,MAAM,CAAC,MAAM,mBAAmB,GAAG,YAAY,CAAA;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;AAiBjD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,UAAuB,EAAE,EACJ,EAAE;IACvB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,kBAAkB,CAAA;IAC3D,IACE,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;QAC1B,UAAU,CAAC,MAAM,KAAK,CAAC;QACvB,CAAC,UAAU,CAAC,KAAK,CACf,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAC9D,EACD,CAAC;QACD,MAAM,IAAI,SAAS,CACjB,mEAAmE,CACpE,CAAA;IACH,CAAC;IAED,OAAO;QACL,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,mBAAmB;QACrD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,mBAAmB;QAC7C,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QAC1D,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAA;AACH,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,cAAsB,EACtB,OAA4B,EACb,EAAE;IACjB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;IAChE,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,cAAc,CAAC,CAAA;IAChE,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC,CAAA;IAChE,MAAM,iBAAiB,GACrB,cAAc,KAAK,EAAE;QACrB,cAAc,KAAK,IAAI;QACvB,cAAc,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;QAC1C,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CAAA;IAEjC,IAAI,iBAAiB;QAAE,OAAO,IAAI,CAAA;IAClC,IACE,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,WAAW,EAAE,CAAC,EACxE,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,IAAI,OAAO,CAAC,CAAA;AACrD,CAAC,CAAA;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,cAAsB,EACtB,OAA4B,EACb,EAAE;IACjB,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAA;IACzE,IAAI,CAAC,kBAAkB;QAAE,OAAO,IAAI,CAAA;IAEpC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAA;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAA;AACnE,CAAC,CAAA"}

package/dist/node/prepare-embeds.d.ts

@@ -0,0 +1,13 @@
+import type { Root } from "mdast";
+import type { Library } from "./library.js";
+export type PreparedEmbeds = {
+    schemaVersion: 1;
+    configuration: string;
+    sourceHashes: Record<string, string>;
+    blocks: Record<string, Root>;
+};
+export declare const embedKey: (documentId: string, value: string, index: number) => string;
+/** Run after collection and before the host build. No asynchronous compiler is needed at render time. */
+export declare function prepareEmbeds(library: Library, outDir?: string): Promise<PreparedEmbeds>;
+export declare function readPreparedEmbeds(outDir: string, documentId: string, source: string): PreparedEmbeds;
+//# sourceMappingURL=prepare-embeds.d.ts.map

package/dist/node/prepare-embeds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-embeds.d.ts","sourceRoot":"","sources":["../../src/node/prepare-embeds.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAEjC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAG3C,MAAM,MAAM,cAAc,GAAG;IAC3B,aAAa,EAAE,CAAC,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;IACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;CAC7B,CAAA;AACD,eAAO,MAAM,QAAQ,GAAI,YAAY,MAAM,EAAE,OAAO,MAAM,EAAE,OAAO,MAAM,WAChC,CAAA;AAEzC,yGAAyG;AACzG,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,MAAM,SAAqB,GAC1B,OAAO,CAAC,cAAc,CAAC,CAiCzB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,cAAc,CAuBhB"}

package/dist/node/prepare-embeds.js

@@ -0,0 +1,54 @@
+import fs from "node:fs";
+import path from "node:path";
+import { hash } from "./storage.js";
+export const embedKey = (documentId, value, index) => `${documentId}:${index}:${hash(value)}`;
+/** Run after collection and before the host build. No asynchronous compiler is needed at render time. */
+export async function prepareEmbeds(library, outDir = ".cudoc/documents") {
+    const { resolveEmbedAsync, parseEmbedSpec } = await import("./resolve-embed.js");
+    const prepared = {
+        schemaVersion: 1,
+        configuration: library.configuration,
+        sourceHashes: {},
+        blocks: {},
+    };
+    for (const document of library.documents) {
+        prepared.sourceHashes[document.id] = document.source.hash;
+        let index = 0;
+        const collect = async (node) => {
+            if (node.type === "code" && node.lang === "cudoc-embed") {
+                const number = ++index;
+                prepared.blocks[embedKey(document.id, node.value, number)] =
+                    await resolveEmbedAsync(library, parseEmbedSpec(node.value), {
+                        documentId: document.id,
+                        prefix: `embed-${number}`,
+                    });
+            }
+            for (const child of node.children ?? [])
+                await collect(child);
+        };
+        await collect(document.tree);
+    }
+    const temporary = path.join(outDir, `embeds.${process.pid}.tmp`);
+    try {
+        fs.writeFileSync(temporary, JSON.stringify(prepared));
+        fs.renameSync(temporary, path.join(outDir, "embeds.json"));
+    }
+    finally {
+        fs.rmSync(temporary, { force: true });
+    }
+    return prepared;
+}
+export function readPreparedEmbeds(outDir, documentId, source) {
+    const file = path.join(outDir, "embeds.json");
+    if (!fs.existsSync(file))
+        throw new Error("cudoc: prepared embeds not found; collect documents and run prepareEmbeds before building the host");
+    const result = JSON.parse(fs.readFileSync(file, "utf8"));
+    const manifest = JSON.parse(fs.readFileSync(path.join(outDir, "manifest.json"), "utf8"));
+    if (result.schemaVersion !== 1 ||
+        result.configuration !== manifest.configuration ||
+        result.sourceHashes[documentId] !== hash(source) ||
+        manifest.documents.some((doc) => result.sourceHashes[doc.id] !== doc.hash))
+        throw new Error(`cudoc: stale prepared embeds for ${documentId}; recollect documents`);
+    return result;
+}
+//# sourceMappingURL=prepare-embeds.js.map

package/dist/node/prepare-embeds.js.map

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

package/dist/node/resolve-embed.d.ts

@@ -0,0 +1,33 @@
+import type { Root } from "mdast";
+import { type SectionSelection } from "../sections.js";
+import type { Library, StoredDocument } from "./library.js";
+export type Replacement = {
+    find: string;
+    replace: string;
+    regex?: boolean;
+    flags?: string;
+};
+export type EmbedSpec = {
+    sources: string[];
+    select?: SectionSelection;
+    render?: "section" | {
+        type: "table";
+        columns?: ("title" | "link" | "summary")[];
+    };
+    replace?: Replacement[];
+};
+export type EmbedContext = {
+    documentId: string;
+    prefix?: string;
+};
+export declare function parseEmbedSpec(value: string): EmbedSpec;
+export declare function resolveDocumentReference(library: Library, reference: string, from: string): {
+    document: StoredDocument;
+    anchor?: string;
+};
+/** Resolve a configured embed from immutable persisted documents. */
+export declare function resolveEmbed(library: Library, input: EmbedSpec, context: EmbedContext): Root;
+export declare function resolveDocumentEmbeds(library: Library, documentId: string): Root;
+export declare const resolveEmbedAsync: (library: Library, spec: EmbedSpec, context: EmbedContext) => Promise<Root>;
+export declare const resolveDocumentEmbedsAsync: (library: Library, documentId: string) => Promise<Root>;
+//# sourceMappingURL=resolve-embed.d.ts.map

package/dist/node/resolve-embed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-embed.d.ts","sourceRoot":"","sources":["../../src/node/resolve-embed.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAGjC,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAGvE,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE3D,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AACD,MAAM,MAAM,SAAS,GAAG;IACtB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,MAAM,CAAC,EACL,SAAS,GAAG;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,EAAE,CAAA;KAAE,CAAA;IAC3E,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;CACxB,CAAA;AACD,MAAM,MAAM,YAAY,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAElE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CA2DvD;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX;IAAE,QAAQ,EAAE,cAAc,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAwB/C;AAwLD,qEAAqE;AACrE,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,YAAY,GACpB,IAAI,CA8HN;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,GACjB,IAAI,CAmBN;AAmDD,eAAO,MAAM,iBAAiB,GAC5B,SAAS,OAAO,EAChB,MAAM,SAAS,EACf,SAAS,YAAY,KACpB,OAAO,CAAC,IAAI,CAGZ,CAAA;AACH,eAAO,MAAM,0BAA0B,GACrC,SAAS,OAAO,EAChB,YAAY,MAAM,KACjB,OAAO,CAAC,IAAI,CAGZ,CAAA"}