@cudoment/cudoc 0.5.0 → 0.7.0

package/dist/node/local-target.js

@@ -9,6 +9,7 @@ import fs from "node:fs";
 import path from "node:path";
 import { safePath } from "./storage.js";
 import { candidateFiles } from "./roots.js";
+import { EXTERNAL_URL, decodeComponent } from "./references.js";
 /** `safePath`, but a path escaping its root is a non-match rather than a throw. */
 const containedPath = (root, relative) => {
     try {
@@ -19,7 +20,7 @@ const containedPath = (root, relative) => {
     }
 };
 /** A fragment, a scheme or a protocol-relative URL: nothing on this disk. */
-export const externalUrl = (url) => /^(?:#|[a-z][\w+.-]*:|\/\/)/i.test(url);
+export const externalUrl = (url) => url.startsWith("#") || EXTERNAL_URL.test(url);
 /**
  * Whether a root-relative URL falls under one of the configured external
  * prefixes. `/sdk` covers `/sdk` and `/sdk/…`, not `/sdk-tools`.
@@ -49,7 +50,7 @@ export function resolveLocalTarget(url, documentSourcePath, roots) {
     if (externalUrl(url) || isExternalPath(url, roots.externalPaths))
         return { kind: "external", url };
     const [, pathname, suffix] = url.match(/^([^?#]*)(.*)$/);
-    const decoded = decodeURIComponent(pathname);
+    const decoded = decodeComponent(pathname);
     const relative = path.posix.normalize(decoded.startsWith("/")
         ? decoded.slice(1)
         : path.posix.join(path.posix.dirname(documentSourcePath), decoded));
@@ -78,4 +79,55 @@ export function resolveLocalTarget(url, documentSourcePath, roots) {
     }
     return { kind: "missing", relative, suffix };
 }
+/**
+ * The candidates of a `srcset`, read as the HTML standard reads them: a URL
+ * runs to the next white space, so a comma inside it, as in a data URL,
+ * belongs to it, and commas the URL ends with are separators; the descriptors
+ * run to the next comma outside parentheses. Empty candidates, left by a
+ * stray comma, are skipped as browsers skip them.
+ */
+export const parseSrcSet = (value) => {
+    const candidates = [];
+    // ASCII white space only: a no-break or ideographic space is part of a URL.
+    const space = (character) => character === " " ||
+        character === "\t" ||
+        character === "\n" ||
+        character === "\f" ||
+        character === "\r";
+    let index = 0;
+    while (index < value.length) {
+        while (index < value.length &&
+            (space(value[index]) || value[index] === ","))
+            index++;
+        const start = index;
+        while (index < value.length && !space(value[index]))
+            index++;
+        let url = value.slice(start, index);
+        let descriptor = "";
+        if (url.endsWith(","))
+            url = url.replace(/,+$/, "");
+        else {
+            const from = index;
+            let inParens = false;
+            while (index < value.length) {
+                const character = value[index];
+                if (character === "(")
+                    inParens = true;
+                else if (character === ")")
+                    inParens = false;
+                else if (character === "," && !inParens)
+                    break;
+                index++;
+            }
+            descriptor = value
+                .slice(from, index)
+                .split(/[\t\n\f\r ]+/)
+                .filter(Boolean)
+                .join(" ");
+        }
+        if (url)
+            candidates.push({ url, descriptor });
+    }
+    return candidates;
+};
 //# sourceMappingURL=local-target.js.map

package/dist/node/local-target.js.map

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

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

@@ -21,7 +21,42 @@ export type PrepareEmbedsOptions = {
      */
     previous?: PreparedEmbeds;
 };
-/** Run after collection and before the host build. No asynchronous compiler is needed at render time. */
+/**
+ * Run after collection and before the host build. No asynchronous compiler is
+ * needed at render time.
+ *
+ * Every block is resolved before anything is written, so one pass names every
+ * embed that cannot be prepared, each with its document and block number: a
+ * single failure as an error whose `cause` is the resolver's, and several as
+ * one `AggregateError` whose message lists them. Nothing is written when any
+ * block fails.
+ */
 export declare function prepareEmbeds(library: Library, outDir?: string, options?: PrepareEmbedsOptions): Promise<PreparedEmbeds>;
+/**
+ * Reads the prepared embeds a host compiles a page with, checked against the
+ * page's own source and against the library they were prepared from.
+ *
+ * A host asks once per page, or once per block, so the two files are parsed
+ * once and kept while neither changes on disk; publishing replaces both, so a
+ * new collection is read on the next call. The result is shared between
+ * calls: a caller copies a block before putting it in its own tree.
+ */
 export declare function readPreparedEmbeds(outDir: string, documentId: string, source: string): PreparedEmbeds;
+/** The embedding document a host is compiling, as `expandPreparedEmbeds` needs it. */
+export type PreparedTarget = {
+    /** Where the library and its `embeds.json` were published. */
+    outDir: string;
+    documentId: string;
+    /** The document's source as collected, which the preparation must match. */
+    source: string;
+};
+/**
+ * Replaces every `cudoc-embed` fence in `tree` with its prepared block, in
+ * document order, the way a host build does. The tree is modified in place
+ * and returned. `target` is read when the first fence is met, so a document
+ * with no embeds needs no library at all; a function defers the work of
+ * finding it until then. `onBlock` sees each block's copy before it is
+ * spliced in.
+ */
+export declare function expandPreparedEmbeds(tree: Root, target: PreparedTarget | (() => PreparedTarget), onBlock?: (block: Root, documentId: string) => void): Root;
 //# sourceMappingURL=prepare-embeds.d.ts.map

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

@@ -1 +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;IAC5B;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CACvC,CAAA;AACD,eAAO,MAAM,QAAQ,GAAI,YAAY,MAAM,EAAE,OAAO,MAAM,EAAE,OAAO,MAAM,WAChC,CAAA;AAEzC,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAA;CAC1B,CAAA;AAyBD,yGAAyG;AACzG,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,MAAM,SAAqB,EAC3B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,cAAc,CAAC,CA4DzB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,cAAc,CAuBhB"}
+{"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;IAC5B;;;;OAIG;IACH,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CACvC,CAAA;AACD,eAAO,MAAM,QAAQ,GAAI,YAAY,MAAM,EAAE,OAAO,MAAM,EAAE,OAAO,MAAM,WAChC,CAAA;AAEzC,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAA;CAC1B,CAAA;AAyBD;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,MAAM,SAAqB,EAC3B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,cAAc,CAAC,CAwFzB;AAeD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,cAAc,CA6BhB;AAED,sFAAsF;AACtF,MAAM,MAAM,cAAc,GAAG;IAC3B,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,cAAc,GAAG,CAAC,MAAM,cAAc,CAAC,EAC/C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,GAClD,IAAI,CA8BN"}

package/dist/node/prepare-embeds.js

@@ -19,7 +19,16 @@ const reusableBlocks = (library, previous) => {
         return undefined;
     return previous;
 };
-/** Run after collection and before the host build. No asynchronous compiler is needed at render time. */
+/**
+ * Run after collection and before the host build. No asynchronous compiler is
+ * needed at render time.
+ *
+ * Every block is resolved before anything is written, so one pass names every
+ * embed that cannot be prepared, each with its document and block number: a
+ * single failure as an error whose `cause` is the resolver's, and several as
+ * one `AggregateError` whose message lists them. Nothing is written when any
+ * block fails.
+ */
 export async function prepareEmbeds(library, outDir = ".cudoc/documents", options = {}) {
     const { resolveEmbedAsync, parseEmbedBlock } = await import("./resolve-embed.js");
     const prepared = {
@@ -32,6 +41,7 @@ export async function prepareEmbeds(library, outDir = ".cudoc/documents", option
     const previous = reusableBlocks(library, options.previous);
     const hashes = new Map(library.documents.map((document) => [document.id, document.source.hash]));
     const unchanged = (id) => previous !== undefined && previous.sourceHashes[id] === hashes.get(id);
+    const failures = [];
     for (const document of library.documents) {
         prepared.sourceHashes[document.id] = document.source.hash;
         let index = 0;
@@ -50,7 +60,17 @@ export async function prepareEmbeds(library, outDir = ".cudoc/documents", option
                     prepared.dependencies[key] = dependencies;
                     return;
                 }
-                const result = await resolveEmbedAsync(library, parseEmbedBlock(node.value, document.id, number), { documentId: document.id, prefix: `embed-${number}` });
+                let result;
+                try {
+                    result = await resolveEmbedAsync(library, parseEmbedBlock(node.value, document.id, number), { documentId: document.id, prefix: `embed-${number}` });
+                }
+                catch (error) {
+                    failures.push({
+                        block: `${document.sourcePath}, embed ${number}`,
+                        error,
+                    });
+                    return;
+                }
                 prepared.blocks[key] = result;
                 prepared.dependencies[key] = Array.isArray(result.data?.cudocDependencies)
                     ? result.data.cudocDependencies
@@ -61,6 +81,17 @@ export async function prepareEmbeds(library, outDir = ".cudoc/documents", option
         };
         await collect(document.tree);
     }
+    // The resolver names what is missing; the block that asked for it is named
+    // here, where the document and the block number are known.
+    const reason = (error) => (error instanceof Error ? error.message : String(error)).replace(/^cudoc: /, "");
+    if (failures.length === 1) {
+        const [{ block, error }] = failures;
+        throw new Error(`cudoc: ${block}: ${reason(error)}`, { cause: error });
+    }
+    if (failures.length > 1)
+        throw new AggregateError(failures.map((failure) => failure.error), `cudoc: ${failures.length} embeds could not be prepared:\n${failures
+            .map(({ block, error }) => `  ${block}: ${reason(error)}`)
+            .join("\n")}`);
     const temporary = path.join(outDir, `embeds.${process.pid}.tmp`);
     try {
         fs.writeFileSync(temporary, JSON.stringify(prepared));
@@ -71,12 +102,38 @@ export async function prepareEmbeds(library, outDir = ".cudoc/documents", option
     }
     return prepared;
 }
+const readFiles = new Map();
+/** What identifies a file's content without reading it: its inode, size and time. */
+const stampOf = (file) => {
+    const stat = fs.statSync(file);
+    return `${stat.ino}:${stat.size}:${stat.mtimeMs}`;
+};
+/**
+ * Reads the prepared embeds a host compiles a page with, checked against the
+ * page's own source and against the library they were prepared from.
+ *
+ * A host asks once per page, or once per block, so the two files are parsed
+ * once and kept while neither changes on disk; publishing replaces both, so a
+ * new collection is read on the next call. The result is shared between
+ * calls: a caller copies a block before putting it in its own tree.
+ */
 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"));
+    const manifestFile = path.join(outDir, "manifest.json");
+    const key = path.resolve(outDir);
+    const stamp = `${stampOf(file)}|${stampOf(manifestFile)}`;
+    let files = readFiles.get(key);
+    if (!files || files.stamp !== stamp) {
+        files = {
+            stamp,
+            prepared: JSON.parse(fs.readFileSync(file, "utf8")),
+            manifest: JSON.parse(fs.readFileSync(manifestFile, "utf8")),
+        };
+        readFiles.set(key, files);
+    }
+    const { prepared: result, manifest } = files;
     if (result.schemaVersion !== 2 ||
         result.configuration !== manifest.configuration ||
         result.sourceHashes[documentId] !== hash(source) ||
@@ -84,4 +141,37 @@ export function readPreparedEmbeds(outDir, documentId, source) {
         throw new Error(`cudoc: stale prepared embeds for ${documentId}; recollect documents`);
     return result;
 }
+/**
+ * Replaces every `cudoc-embed` fence in `tree` with its prepared block, in
+ * document order, the way a host build does. The tree is modified in place
+ * and returned. `target` is read when the first fence is met, so a document
+ * with no embeds needs no library at all; a function defers the work of
+ * finding it until then. `onBlock` sees each block's copy before it is
+ * spliced in.
+ */
+export function expandPreparedEmbeds(tree, target, onBlock) {
+    let resolved;
+    let prepared;
+    let index = 0;
+    const expand = (node) => {
+        if (!node.children)
+            return;
+        node.children = node.children.flatMap((child) => {
+            if (child.type !== "code" || child.lang !== "cudoc-embed") {
+                expand(child);
+                return [child];
+            }
+            resolved ??= typeof target === "function" ? target() : target;
+            prepared ??= readPreparedEmbeds(resolved.outDir, resolved.documentId, resolved.source);
+            const block = prepared.blocks[embedKey(resolved.documentId, child.value, ++index)];
+            if (!block)
+                throw new Error(`cudoc: prepared embed missing in ${resolved.documentId}; recollect documents`);
+            const copy = structuredClone(block);
+            onBlock?.(copy, resolved.documentId);
+            return copy.children;
+        });
+    };
+    expand(tree);
+    return tree;
+}
 //# sourceMappingURL=prepare-embeds.js.map

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

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

package/dist/node/references.d.ts

@@ -0,0 +1,39 @@
+/**
+ * How a reference is read, shared by the embed resolver, the reference checker
+ * and local link resolution, so that the checker's verdict and the build's
+ * never disagree about the same text. Not a package entry point.
+ */
+import type { DocumentNode } from "../document.js";
+import type { Library, StoredDocument } from "./library.js";
+/** A URL with a scheme, or protocol-relative: nothing in the library. */
+export declare const EXTERNAL_URL: RegExp;
+/**
+ * A URL component with its percent-escapes decoded, or as written when it
+ * holds a `%` that is not an escape. A link like `100%.md` is then looked up
+ * as it stands and reported as missing, with its document, instead of ending
+ * the whole run with a bare `URIError`.
+ */
+export declare const decodeComponent: (value: string) => string;
+/** Every id a node declares: its own, and each element's in raw HTML. */
+export declare const idsInNode: (node: DocumentNode) => string[];
+type DocumentIndex = {
+    size: number;
+    byId: Map<string, StoredDocument>;
+    /**
+     * By `/sourcePath`, `/id` and `/id/`, the forms a rebased link can take,
+     * and an index document also by its directory: always as `/` or `/guide/`,
+     * and as `/guide` where no other document claims that path.
+     */
+    byPath: Map<string, StoredDocument>;
+};
+/**
+ * The library's documents by id and by path, built once per document list.
+ * A stored library is never modified after collection, so resolving every
+ * block of a large library looks each document up in constant time instead
+ * of scanning the list at every reference.
+ */
+export declare const documentIndex: (library: Library) => DocumentIndex;
+/** Every id a stored tree declares, read once per tree. */
+export declare const declaredIds: (tree: object) => readonly string[];
+export {};
+//# sourceMappingURL=references.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../src/node/references.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE3D,yEAAyE;AACzE,eAAO,MAAM,YAAY,QAA8B,CAAA;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,KAAG,MAM/C,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,SAAS,GAAI,MAAM,YAAY,KAAG,MAAM,EAcpD,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACjC;;;;OAIG;IACH,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;CACpC,CAAA;AAGD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,OAAO,KAAG,aAiChD,CAAA;AAID,2DAA2D;AAC3D,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,SAAS,MAAM,EAWzD,CAAA"}

package/dist/node/references.js

@@ -0,0 +1,101 @@
+/**
+ * How a reference is read, shared by the embed resolver, the reference checker
+ * and local link resolution, so that the checker's verdict and the build's
+ * never disagree about the same text. Not a package entry point.
+ */
+import { fromHtml } from "hast-util-from-html";
+/** A URL with a scheme, or protocol-relative: nothing in the library. */
+export const EXTERNAL_URL = /^(?:[a-z][\w+.-]*:|\/\/)/i;
+/**
+ * A URL component with its percent-escapes decoded, or as written when it
+ * holds a `%` that is not an escape. A link like `100%.md` is then looked up
+ * as it stands and reported as missing, with its document, instead of ending
+ * the whole run with a bare `URIError`.
+ */
+export const decodeComponent = (value) => {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        return value;
+    }
+};
+/** Every id a node declares: its own, and each element's in raw HTML. */
+export const idsInNode = (node) => {
+    const ids = [];
+    const id = node.data?.hProperties?.id;
+    if (typeof id === "string")
+        ids.push(id);
+    if (node.type === "html" && node.value) {
+        const tree = fromHtml(node.value, { fragment: true });
+        const walk = (value) => {
+            if (value.type === "element" && typeof value.properties.id === "string")
+                ids.push(value.properties.id);
+            if ("children" in value)
+                value.children.forEach(walk);
+        };
+        walk(tree);
+    }
+    return ids;
+};
+const indexes = new WeakMap();
+/**
+ * The library's documents by id and by path, built once per document list.
+ * A stored library is never modified after collection, so resolving every
+ * block of a large library looks each document up in constant time instead
+ * of scanning the list at every reference.
+ */
+export const documentIndex = (library) => {
+    const cached = indexes.get(library.documents);
+    if (cached && cached.size === library.documents.length)
+        return cached;
+    const index = {
+        size: library.documents.length,
+        byId: new Map(),
+        byPath: new Map(),
+    };
+    for (const document of library.documents) {
+        if (!index.byId.has(document.id))
+            index.byId.set(document.id, document);
+        for (const key of [
+            `/${document.sourcePath}`,
+            `/${document.id}`,
+            `/${document.id}/`,
+        ])
+            if (!index.byPath.has(key))
+                index.byPath.set(key, document);
+    }
+    // A directory names its index document: spelled with the trailing slash
+    // always, even beside a document of the directory's own name, which keeps
+    // the spelling without one.
+    for (const document of library.documents) {
+        const directory = document.id.match(/^(?:(.*)\/)?index$/);
+        if (!directory)
+            continue;
+        if (!directory[1]) {
+            index.byPath.set("/", document);
+            continue;
+        }
+        index.byPath.set(`/${directory[1]}/`, document);
+        if (!index.byPath.has(`/${directory[1]}`))
+            index.byPath.set(`/${directory[1]}`, document);
+    }
+    indexes.set(library.documents, index);
+    return index;
+};
+const declared = new WeakMap();
+/** Every id a stored tree declares, read once per tree. */
+export const declaredIds = (tree) => {
+    const cached = declared.get(tree);
+    if (cached)
+        return cached;
+    const ids = [];
+    const walk = (node) => {
+        ids.push(...idsInNode(node));
+        node.children?.forEach(walk);
+    };
+    walk(tree);
+    declared.set(tree, ids);
+    return ids;
+};
+//# sourceMappingURL=references.js.map

package/dist/node/references.js.map

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

package/dist/node/replace.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Replacement rules applied to an embedded section, shared by the resolver,
+ * which copies the result, and the checker, which inspects it.
+ *
+ * A rule list rewrites the section's original Markdown, not its tree, and the
+ * rewritten text is compiled again with the document's own options, so the
+ * copy is what the source would have been had it been written that way.
+ */
+import type { Root } from "mdast";
+import type { Library, StoredDocument } from "./library.js";
+import type { Replacement } from "./resolve-embed.js";
+/**
+ * One section's Markdown as it reads on its own, or the whole document's
+ * without an anchor. A heading in a list item starts its range at or after
+ * the item's marks, and the lines after it carry the indentation the parser
+ * took off them as the item's content; both are taken off here too, so the
+ * text compiles to the section that was collected.
+ */
+export declare function sectionText(document: StoredDocument, anchor: string | undefined, includeChildren?: boolean): string;
+/**
+ * Why a section's Markdown cannot be rewritten, or `undefined`.
+ *
+ * A rule rewrites the section's text as it reads on its own, which is
+ * compiled again. A heading inside another block leaves some of that block
+ * in the text where nothing takes it off: a quote's `>` stays on the lines
+ * after the heading, a footnote's indentation stays on its lines, and the
+ * last section of a component or a `:::` container runs into the line that
+ * closes it. Any of those is refused, since compiled again it would be
+ * another structure; a list item's marks and indentation are taken off by
+ * `sectionText`. Decided from the collected tree and the source alone, so
+ * the build and `cudoc check` agree whichever compiler each has.
+ */
+export declare function unreplaceableSection(document: StoredDocument, anchor: string | undefined, includeChildren?: boolean): string | undefined;
+export declare function replaceSource(source: string, rules: Replacement[], documentId: string): string;
+/**
+ * One section's Markdown with the rules applied, followed by the definitions
+ * it depends on from outside its range, unchanged. `offset` is where the
+ * section starts in the source, for an error that has to point there.
+ */
+export declare function replacedSectionSource(document: StoredDocument, anchor: string | undefined, rules: Replacement[], includeChildren?: boolean): {
+    source: string;
+    offset: number;
+};
+/**
+ * Compiles a section's rewritten Markdown with the library's compiler and
+ * options, as the build does. A library of a host the standalone compiler
+ * cannot stand in for needs that host's compiler, and without it this throws,
+ * because a copy compiled otherwise would lose the host's own syntax.
+ *
+ * `standalone` is for a caller that inspects the copy rather than ships it:
+ * without the host compiler it compiles with the standalone one and the same
+ * options, which reads embed fences, components and tables as the host does.
+ * Syntax only the host's own parser knows is lost or refused there: a
+ * VitePress `::: tip` container stays text, and MDX with Docusaurus's
+ * `{#id}` or an HTML comment does not compile, which the caller has to allow.
+ */
+export declare function compileReplacedSection(library: Library, document: StoredDocument, replaced: {
+    source: string;
+    offset: number;
+}, { standalone }?: {
+    standalone?: boolean;
+}): Root;
+/** The tree an embed copies from one section: rewritten when there are rules. */
+export declare function transformedSection(document: StoredDocument, anchor: string | undefined, tree: Root, rules: Replacement[], library: Library, includeChildren?: boolean): Root;
+//# sourceMappingURL=replace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replace.d.ts","sourceRoot":"","sources":["../../src/node/replace.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAIjC,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AA8GrD;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,eAAe,UAAO,GACrB,MAAM,CAmBR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,eAAe,UAAO,GACrB,MAAM,GAAG,SAAS,CAiCpB;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,WAAW,EAAE,EACpB,UAAU,EAAE,MAAM,GACjB,MAAM,CAaR;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,WAAW,EAAE,EACpB,eAAe,UAAO,GACrB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAiDpC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC5C,EAAE,UAAkB,EAAE,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GACpD,IAAI,CA4BN;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,WAAW,EAAE,EACpB,OAAO,EAAE,OAAO,EAChB,eAAe,UAAO,GACrB,IAAI,CAON"}