@cudoment/cudoc 0.4.0 → 0.5.0

package/dist/node/roots.js

@@ -0,0 +1,134 @@
+/**
+ * Where documents come from, and how a library path maps back to a file.
+ *
+ * A library has one coordinate system: the library path, which is a root's
+ * `base` followed by the file's path under that root. Document ids, links,
+ * embed sources and the checker all speak that system, so a project can
+ * collect `content/` under `docs` and `glossary/` under `terms` and have
+ * `/docs/guide` and `/terms/token` mean what they mean on the site. These
+ * helpers are the one place that knows which directory a library path lives
+ * in, so nothing else has to.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { posix, safePath } from "./storage.js";
+/** `/docs/` and `docs` are the same base; `..`, `?` and `#` never are one. */
+export function normalizeBase(base) {
+    if (base === undefined)
+        return "";
+    if (typeof base !== "string")
+        throw new Error("cudoc: a root base must be a string");
+    const value = base.replace(/\\/g, "/").replace(/^\/+|\/+$/g, "");
+    if (!value)
+        return "";
+    if (value.split("/").some((part) => !part || part === "." || part === "..") ||
+        /[?#]/.test(value))
+        throw new Error(`cudoc: invalid root base: ${base}`);
+    return value;
+}
+/**
+ * The roots a collection or a consumer was given. `sourceRoot` is the
+ * single-root shorthand for `roots: [{ dir: sourceRoot }]`; giving both is an
+ * error rather than a merge, because the two spell the same thing.
+ */
+export function resolveRoots(options) {
+    if (options.sourceRoot !== undefined && options.roots !== undefined)
+        throw new Error("cudoc: give either sourceRoot or roots, not both");
+    const given = options.roots ??
+        (options.sourceRoot === undefined ? [] : [{ dir: options.sourceRoot }]);
+    if (!Array.isArray(given) || !given.length)
+        throw new Error("cudoc: sourceRoot or a non-empty roots list is required");
+    const roots = given.map((root) => {
+        if (!root || typeof root !== "object" || typeof root.dir !== "string")
+            throw new Error("cudoc: each root needs a dir");
+        if (!root.dir)
+            throw new Error("cudoc: a root dir must not be empty");
+        return { dir: path.resolve(root.dir), base: normalizeBase(root.base) };
+    });
+    const dirs = new Set();
+    for (const root of roots) {
+        if (dirs.has(root.dir))
+            throw new Error(`cudoc: root directory listed twice: ${root.dir}`);
+        dirs.add(root.dir);
+    }
+    return roots;
+}
+/** A root's path for a file inside it, or undefined when the file is elsewhere. */
+const under = (dir, file) => {
+    const relative = path.relative(dir, file);
+    if (!relative ||
+        relative === ".." ||
+        relative.startsWith(`..${path.sep}`) ||
+        path.isAbsolute(relative))
+        return undefined;
+    return posix(relative);
+};
+/** `base/relative`, or just `relative` for a root at the top. */
+export const libraryPath = (root, relative) => root.base ? `${root.base}/${relative}` : relative;
+/**
+ * The library path of a file, from the innermost root that contains it.
+ *
+ * Nested root directories are allowed — a project may collect `docs/` and
+ * give `docs/api/` its own base — and the deeper one owns the file.
+ */
+export function libraryPathOf(roots, file) {
+    const absolute = path.resolve(file);
+    let best;
+    for (const root of roots) {
+        const relative = under(root.dir, absolute);
+        if (relative === undefined)
+            continue;
+        const depth = root.dir.split(path.sep).length;
+        if (!best || depth > best.depth)
+            best = { depth, value: libraryPath(root, relative) };
+    }
+    return best?.value;
+}
+/** The document id a file collects as: its library path without the extension. */
+export const documentIdOf = (roots, file) => libraryPathOf(roots, file)?.replace(/\.mdx?$/i, "");
+/** Whether `libraryPath` sits under the root's base. */
+const inBase = (root, target) => {
+    if (!root.base)
+        return target;
+    if (target === root.base)
+        return "";
+    return target.startsWith(`${root.base}/`)
+        ? target.slice(root.base.length + 1)
+        : undefined;
+};
+/**
+ * Every file a library path could name, most specific base first.
+ *
+ * Two roots may share a base, and one base may extend another, so the answer
+ * is a list: the caller that wants the file that exists checks each, and the
+ * caller that wants to know whether the path could exist at all takes the
+ * first. A path that would escape a root's directory is left out.
+ */
+export function candidateFiles(roots, target) {
+    return [...roots]
+        .map((root, order) => ({ root, order }))
+        .sort((a, b) => b.root.base.length - a.root.base.length || a.order - b.order)
+        .flatMap(({ root }) => {
+        const relative = inBase(root, target);
+        if (relative === undefined)
+            return [];
+        try {
+            return [safePath(root.dir, relative)];
+        }
+        catch {
+            return [];
+        }
+    });
+}
+/**
+ * The file a library path names, preferring one that exists.
+ *
+ * When none exists — the caller is about to compile a slice of a document
+ * that has since been deleted, say — the first candidate is returned so an
+ * error names a real location.
+ */
+export function sourceFileOf(roots, target) {
+    const candidates = candidateFiles(roots, target);
+    return candidates.find((file) => fs.existsSync(file)) ?? candidates[0];
+}
+//# sourceMappingURL=roots.js.map

package/dist/node/roots.js.map

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

package/dist/node/storage.d.ts

@@ -3,8 +3,26 @@ export declare const posix: (value: string) => string;
 export declare function contained(root: string, target: string): boolean;
 export declare function realPath(target: string): string;
 export declare function safePath(root: string, relative: string): string;
-export declare function sourceFiles(root: string, extensions?: string[]): string[];
+/**
+ * Every file under `root` with one of the extensions, sorted, as absolute
+ * paths. Dot entries and `node_modules` are always skipped; `exclude` is asked
+ * about each remaining entry's POSIX path relative to `root`, and a directory
+ * it excludes is not entered, so a symlink inside one is never seen.
+ */
+export declare function sourceFiles(root: string, extensions?: string[], options?: {
+    exclude?: (relative: string) => boolean;
+}): string[];
 export declare function writeJson(file: string, value: unknown): void;
-/** Only replace directories bearing our ownership marker. Never delete arbitrary output. */
-export declare function publishDirectory(inputRoot: string, outputRoot: string, build: (staging: string) => void): void;
+/**
+ * Only replace directories bearing our ownership marker. Never delete arbitrary output.
+ *
+ * `inputRoots` are the directories the build reads; the output may not sit
+ * inside or around any of them. A build callback may be synchronous or
+ * asynchronous. The return value of `build` is what decides: a thenable defers
+ * the commit until it settles and makes this function return a promise,
+ * anything else commits immediately and returns nothing. The overloads are a
+ * convenience; the runtime check is the authority.
+ */
+export declare function publishDirectory(inputRoots: string | string[], outputRoot: string, build: (staging: string) => void): void;
+export declare function publishDirectory(inputRoots: string | string[], outputRoot: string, build: (staging: string) => Promise<void>): Promise<void>;
 //# sourceMappingURL=storage.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/node/storage.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,IAAI,GAAI,OAAO,MAAM,WACuB,CAAA;AACzD,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,WAAoC,CAAA;AACvE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAQ/D;AACD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAI/C;AACD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ/D;AACD,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,UAAU,WAAkB,GAC3B,MAAM,EAAE,CAiBV;AACD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,QAGrD;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC/B,IAAI,CAkCN"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/node/storage.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,IAAI,GAAI,OAAO,MAAM,WACuB,CAAA;AACzD,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,WAAoC,CAAA;AACvE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAQ/D;AACD,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAI/C;AACD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAQ/D;AACD;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,UAAU,WAAkB,EAC5B,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAA;CAAO,GACxD,MAAM,EAAE,CAmBV;AACD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,QAGrD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,EAC7B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC/B,IAAI,CAAA;AACP,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,EAC7B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC,CAAA"}

package/dist/node/storage.js

@@ -23,7 +23,14 @@ export function safePath(root, relative) {
         throw new Error(`cudoc: path escapes document root: ${relative}`);
     return target;
 }
-export function sourceFiles(root, extensions = [".md", ".mdx"]) {
+/**
+ * Every file under `root` with one of the extensions, sorted, as absolute
+ * paths. Dot entries and `node_modules` are always skipped; `exclude` is asked
+ * about each remaining entry's POSIX path relative to `root`, and a directory
+ * it excludes is not entered, so a symlink inside one is never seen.
+ */
+export function sourceFiles(root, extensions = [".md", ".mdx"], options = {}) {
+    const base = path.resolve(root);
     const walk = (dir) => fs
         .readdirSync(dir, { withFileTypes: true })
         .sort((a, b) => a.name.localeCompare(b.name, "en"))
@@ -31,6 +38,8 @@ export function sourceFiles(root, extensions = [".md", ".mdx"]) {
         if (entry.name.startsWith(".") || entry.name === "node_modules")
             return [];
         const file = path.join(dir, entry.name);
+        if (options.exclude?.(posix(path.relative(base, file))))
+            return [];
         if (entry.isSymbolicLink())
             throw new Error(`cudoc: symlink in source tree: ${file}`);
         if (entry.isDirectory())
@@ -39,19 +48,21 @@ export function sourceFiles(root, extensions = [".md", ".mdx"]) {
             ? [file]
             : [];
     });
-    return walk(path.resolve(root));
+    return walk(base);
 }
 export function writeJson(file, value) {
     fs.mkdirSync(path.dirname(file), { recursive: true });
     fs.writeFileSync(file, JSON.stringify(value));
 }
-/** Only replace directories bearing our ownership marker. Never delete arbitrary output. */
-export function publishDirectory(inputRoot, outputRoot, build) {
+export function publishDirectory(inputRoots, outputRoot, build) {
     if (fs.existsSync(outputRoot) && fs.lstatSync(outputRoot).isSymbolicLink())
         throw new Error("cudoc: output directory must not be a symlink");
-    const input = realPath(inputRoot), output = realPath(outputRoot);
-    if (contained(input, output) || contained(output, input))
-        throw new Error("cudoc: input and output directories overlap");
+    const output = realPath(outputRoot);
+    for (const inputRoot of [inputRoots].flat()) {
+        const input = realPath(inputRoot);
+        if (contained(input, output) || contained(output, input))
+            throw new Error("cudoc: input and output directories overlap");
+    }
     fs.mkdirSync(path.dirname(output), { recursive: true });
     const owner = path.join(output, ".cudoc-output");
     if (fs.existsSync(output) &&
@@ -61,9 +72,7 @@ export function publishDirectory(inputRoot, outputRoot, build) {
     const fd = fs.openSync(lock, "wx");
     const staging = fs.mkdtempSync(`${output}.tmp-`);
     const backup = `${output}.previous-${crypto.randomUUID()}`;
-    try {
-        fs.writeFileSync(path.join(staging, ".cudoc-output"), "cudoc\n");
-        build(staging);
+    const commit = () => {
         if (fs.existsSync(output))
             fs.renameSync(output, backup);
         try {
@@ -75,11 +84,31 @@ export function publishDirectory(inputRoot, outputRoot, build) {
             throw error;
         }
         fs.rmSync(backup, { recursive: true, force: true });
-    }
-    finally {
+    };
+    const cleanup = () => {
         fs.rmSync(staging, { recursive: true, force: true });
         fs.closeSync(fd);
         fs.unlinkSync(lock);
+    };
+    let result;
+    try {
+        fs.writeFileSync(path.join(staging, ".cudoc-output"), "cudoc\n");
+        result = build(staging);
+    }
+    catch (error) {
+        cleanup();
+        throw error;
+    }
+    const pending = result;
+    if (typeof pending?.then !== "function") {
+        try {
+            commit();
+        }
+        finally {
+            cleanup();
+        }
+        return;
     }
+    return pending.then(commit).finally(cleanup);
 }
 //# sourceMappingURL=storage.js.map

package/dist/node/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/node/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,MAAM,MAAM,aAAa,CAAA;AAEhC,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,EAAE,CACpC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACzD,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACvE,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,MAAc;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC5C,OAAO,CACL,QAAQ,KAAK,EAAE;QACf,CAAC,QAAQ,KAAK,IAAI;YAChB,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;YACrC,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAC9B,CAAA;AACH,CAAC;AACD,MAAM,UAAU,QAAQ,CAAC,MAAc;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACrC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAA;IAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;AAC7E,CAAC;AACD,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,QAAgB;IACrD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC3C,IACE,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QAE7B,MAAM,IAAI,KAAK,CAAC,sCAAsC,QAAQ,EAAE,CAAC,CAAA;IACnE,OAAO,MAAM,CAAA;AACf,CAAC;AACD,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,UAAU,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC;IAE5B,MAAM,IAAI,GAAG,CAAC,GAAW,EAAY,EAAE,CACrC,EAAE;SACC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACzC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;SAClD,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACjB,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;YAC7D,OAAO,EAAE,CAAA;QACX,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;QACvC,IAAI,KAAK,CAAC,cAAc,EAAE;YACxB,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,EAAE,CAAC,CAAA;QAC3D,IAAI,KAAK,CAAC,WAAW,EAAE;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,CAAA;QAC1C,OAAO,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YAC1D,CAAC,CAAC,CAAC,IAAI,CAAC;YACR,CAAC,CAAC,EAAE,CAAA;IACR,CAAC,CAAC,CAAA;IACN,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAA;AACjC,CAAC;AACD,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAc;IACpD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACrD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;AAC/C,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,gBAAgB,CAC9B,SAAiB,EACjB,UAAkB,EAClB,KAAgC;IAEhC,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,cAAc,EAAE;QACxE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;IAClE,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,EAC/B,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAA;IAC/B,IAAI,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;IAChE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IAChD,IACE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QACrB,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,SAAS,CAAC;QAEvE,MAAM,IAAI,KAAK,CAAC,iDAAiD,MAAM,EAAE,CAAC,CAAA;IAC5E,MAAM,IAAI,GAAG,GAAG,MAAM,OAAO,CAAA;IAC7B,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IAClC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,CAAA;IAChD,MAAM,MAAM,GAAG,GAAG,MAAM,aAAa,MAAM,CAAC,UAAU,EAAE,EAAE,CAAA;IAC1D,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,SAAS,CAAC,CAAA;QAChE,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACxD,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YACxD,MAAM,KAAK,CAAA;QACb,CAAC;QACD,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACrD,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QACpD,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;QAChB,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IACrB,CAAC;AACH,CAAC"}
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/node/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,MAAM,MAAM,aAAa,CAAA;AAEhC,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,EAAE,CACpC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AACzD,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACvE,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,MAAc;IACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC5C,OAAO,CACL,QAAQ,KAAK,EAAE;QACf,CAAC,QAAQ,KAAK,IAAI;YAChB,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;YACrC,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAC9B,CAAA;AACH,CAAC;AACD,MAAM,UAAU,QAAQ,CAAC,MAAc;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;IACrC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAA;IAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA;AAC7E,CAAC;AACD,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,QAAgB;IACrD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC3C,IACE,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QAE7B,MAAM,IAAI,KAAK,CAAC,sCAAsC,QAAQ,EAAE,CAAC,CAAA;IACnE,OAAO,MAAM,CAAA;AACf,CAAC;AACD;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,UAAU,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,EAC5B,UAAuD,EAAE;IAEzD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/B,MAAM,IAAI,GAAG,CAAC,GAAW,EAAY,EAAE,CACrC,EAAE;SACC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACzC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;SAClD,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QACjB,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;YAC7D,OAAO,EAAE,CAAA;QACX,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;QACvC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;YAAE,OAAO,EAAE,CAAA;QAClE,IAAI,KAAK,CAAC,cAAc,EAAE;YACxB,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,EAAE,CAAC,CAAA;QAC3D,IAAI,KAAK,CAAC,WAAW,EAAE;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC,CAAA;QAC1C,OAAO,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;YAC1D,CAAC,CAAC,CAAC,IAAI,CAAC;YACR,CAAC,CAAC,EAAE,CAAA;IACR,CAAC,CAAC,CAAA;IACN,OAAO,IAAI,CAAC,IAAI,CAAC,CAAA;AACnB,CAAC;AACD,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,KAAc;IACpD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACrD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;AAC/C,CAAC;AAsBD,MAAM,UAAU,gBAAgB,CAC9B,UAA6B,EAC7B,UAAkB,EAClB,KAAgD;IAEhD,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,cAAc,EAAE;QACxE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;IAClE,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAA;IACnC,KAAK,MAAM,SAAS,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAA;QACjC,IAAI,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;IAClE,CAAC;IACD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IAChD,IACE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QACrB,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,SAAS,CAAC;QAEvE,MAAM,IAAI,KAAK,CAAC,iDAAiD,MAAM,EAAE,CAAC,CAAA;IAC5E,MAAM,IAAI,GAAG,GAAG,MAAM,OAAO,CAAA;IAC7B,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IAClC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,CAAA;IAChD,MAAM,MAAM,GAAG,GAAG,MAAM,aAAa,MAAM,CAAC,UAAU,EAAE,EAAE,CAAA;IAC1D,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QACxD,IAAI,CAAC;YACH,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,EAAE,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YACxD,MAAM,KAAK,CAAA;QACb,CAAC;QACD,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACrD,CAAC,CAAA;IACD,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QACpD,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAA;QAChB,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IACrB,CAAC,CAAA;IACD,IAAI,MAA4B,CAAA;IAChC,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,SAAS,CAAC,CAAA;QAChE,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAA;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,CAAA;QACT,MAAM,KAAK,CAAA;IACb,CAAC;IACD,MAAM,OAAO,GAAG,MAAmC,CAAA;IACnD,IAAI,OAAO,OAAO,EAAE,IAAI,KAAK,UAAU,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,EAAE,CAAA;QACV,CAAC;gBAAS,CAAC;YACT,OAAO,EAAE,CAAA;QACX,CAAC;QACD,OAAM;IACR,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;AAC9C,CAAC"}

package/dist/node/watch.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Collection that repeats as sources change.
+ *
+ * A pass is what the CLI's `collect` does once: build the library, then
+ * prepare the embeds. Here every pass after the first hands the previous
+ * library and the previous preparation back in, so only the documents whose
+ * text changed compile again and only the blocks that read a changed document
+ * resolve again. The watcher runs a pass when a file under any root changes,
+ * after a short quiet period, and keeps the last good result when a pass
+ * fails, so a half-typed document is an error message rather than a broken
+ * library.
+ */
+import type { CompiledDocument } from "../markdown.js";
+import { type BuildDocumentsOptions, type Library } from "./library.js";
+import { type PreparedEmbeds } from "./prepare-embeds.js";
+/**
+ * A collection configuration as a config file exports it: the build options,
+ * where the compiler may return its result synchronously or as a promise.
+ */
+export type CollectConfig = Omit<BuildDocumentsOptions, "compiler"> & {
+    compiler?: (...parameters: Parameters<NonNullable<BuildDocumentsOptions["compiler"]>>) => CompiledDocument | Promise<CompiledDocument>;
+};
+/** What one pass produced and how much of it was new. */
+export type CollectionPass = {
+    library: Library;
+    prepared: PreparedEmbeds;
+    documentCount: number;
+    /** Ids of the documents this pass compiled. Every document on a full pass. */
+    compiled: string[];
+    /** Documents taken from the previous library unchanged. */
+    reused: number;
+    /** Embed blocks in the library, and how many were taken from the previous preparation. */
+    blocks: number;
+    reusedBlocks: number;
+    outDir: string;
+    /** Wall-clock milliseconds the pass took. */
+    elapsed: number;
+};
+export type CollectionState = {
+    library?: Library;
+    prepared?: PreparedEmbeds;
+};
+/**
+ * The library and preparation already in `outDir`, when they load and are
+ * worth reusing, so a watcher's first pass compiles only what changed since
+ * the last run. Anything unreadable or incompatible means starting fresh.
+ */
+export declare function previousCollection(outDir?: string): CollectionState;
+/**
+ * One pass: collect, then prepare. With `previous`, an unchanged document is
+ * not compiled and an unaffected block is not resolved; the published files
+ * are complete either way.
+ */
+export declare function collectDocuments(config: CollectConfig, previous?: CollectionState): Promise<CollectionPass>;
+export type WatchOptions = {
+    /** Quiet time after the last change before a pass starts, in milliseconds. Default 150. */
+    debounce?: number;
+    /** The result of every pass, the first included. */
+    onPass?: (pass: CollectionPass) => void;
+    /** A failed pass. The watcher keeps the last good result and keeps running. */
+    onError?: (error: unknown) => void;
+    /**
+     * Whether the first pass may start from what `outDir` already holds.
+     * Default true.
+     */
+    reuseOutput?: boolean;
+};
+export type CollectionWatcher = {
+    /** Resolves when the first pass has finished, whether it succeeded or failed. */
+    ready: Promise<void>;
+    /** Stops watching. A pass in progress finishes. */
+    close(): void;
+};
+/**
+ * Collects once, then again whenever a `.md` or `.mdx` file under any root is
+ * created, changed, renamed or deleted. Changes that arrive while a pass runs
+ * start another pass when it finishes, so the output always reflects the
+ * latest files.
+ */
+export declare function watchDocuments(config: CollectConfig, options?: WatchOptions): CollectionWatcher;
+//# sourceMappingURL=watch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/node/watch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EAKL,KAAK,qBAAqB,EAC1B,KAAK,OAAO,EACb,MAAM,cAAc,CAAA;AACrB,OAAO,EAAiB,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAExE;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,qBAAqB,EAAE,UAAU,CAAC,GAAG;IACpE,QAAQ,CAAC,EAAE,CACT,GAAG,UAAU,EAAE,UAAU,CAAC,WAAW,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC,CAAC,KACtE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;CAClD,CAAA;AAED,yDAAyD;AACzD,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,cAAc,CAAA;IACxB,aAAa,EAAE,MAAM,CAAA;IACrB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAA;IACd,0FAA0F;IAC1F,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,cAAc,CAAA;CAC1B,CAAA;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,SAAqB,GAC1B,eAAe,CAkBjB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,aAAa,EACrB,QAAQ,GAAE,eAAoB,GAC7B,OAAO,CAAC,cAAc,CAAC,CA8BzB;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oDAAoD;IACpD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAA;IACvC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAClC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,iFAAiF;IACjF,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IACpB,mDAAmD;IACnD,KAAK,IAAI,IAAI,CAAA;CACd,CAAA;AAOD;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,YAAiB,GACzB,iBAAiB,CAoDnB"}

package/dist/node/watch.js

@@ -0,0 +1,140 @@
+/**
+ * Collection that repeats as sources change.
+ *
+ * A pass is what the CLI's `collect` does once: build the library, then
+ * prepare the embeds. Here every pass after the first hands the previous
+ * library and the previous preparation back in, so only the documents whose
+ * text changed compile again and only the blocks that read a changed document
+ * resolve again. The watcher runs a pass when a file under any root changes,
+ * after a short quiet period, and keeps the last good result when a pass
+ * fails, so a half-typed document is an error message rather than a broken
+ * library.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { buildDocuments, buildDocumentsAsync, loadLibrary, resolveRoots, } from "./library.js";
+import { prepareEmbeds } from "./prepare-embeds.js";
+/**
+ * The library and preparation already in `outDir`, when they load and are
+ * worth reusing, so a watcher's first pass compiles only what changed since
+ * the last run. Anything unreadable or incompatible means starting fresh.
+ */
+export function previousCollection(outDir = ".cudoc/documents") {
+    const state = {};
+    try {
+        if (fs.existsSync(path.join(outDir, "manifest.json")))
+            state.library = loadLibrary(outDir);
+    }
+    catch {
+        return {};
+    }
+    try {
+        const file = path.join(outDir, "embeds.json");
+        if (state.library && fs.existsSync(file)) {
+            const prepared = JSON.parse(fs.readFileSync(file, "utf8"));
+            if (prepared?.schemaVersion === 2)
+                state.prepared = prepared;
+        }
+    }
+    catch {
+        delete state.prepared;
+    }
+    return state;
+}
+/**
+ * One pass: collect, then prepare. With `previous`, an unchanged document is
+ * not compiled and an unaffected block is not resolved; the published files
+ * are complete either way.
+ */
+export async function collectDocuments(config, previous = {}) {
+    const started = Date.now();
+    const outDir = config.outDir ?? ".cudoc/documents";
+    const { compiler, ...rest } = config;
+    const options = { ...rest, previous: previous.library };
+    const library = compiler
+        ? await buildDocumentsAsync({
+            ...options,
+            compiler: async (...parameters) => compiler(...parameters),
+        })
+        : buildDocuments(options);
+    const prepared = await prepareEmbeds(library, outDir, {
+        previous: previous.prepared,
+    });
+    const keys = Object.keys(prepared.blocks);
+    return {
+        library,
+        prepared,
+        documentCount: library.documents.length,
+        compiled: library.incremental?.compiled ??
+            library.documents.map((document) => document.id),
+        reused: library.incremental?.reused.length ?? 0,
+        blocks: keys.length,
+        reusedBlocks: keys.filter((key) => previous.prepared?.blocks[key] === prepared.blocks[key]).length,
+        outDir,
+        elapsed: Date.now() - started,
+    };
+}
+/** Whether a changed path is one collection reads. */
+const isSource = (filename) => filename === null ||
+    /\.mdx?$/i.test(typeof filename === "string" ? filename : String(filename));
+/**
+ * Collects once, then again whenever a `.md` or `.mdx` file under any root is
+ * created, changed, renamed or deleted. Changes that arrive while a pass runs
+ * start another pass when it finishes, so the output always reflects the
+ * latest files.
+ */
+export function watchDocuments(config, options = {}) {
+    const debounce = options.debounce ?? 150;
+    const roots = resolveRoots(config);
+    let state = options.reuseOutput === false ? {} : previousCollection(config.outDir);
+    let running;
+    let pending = false;
+    let timer;
+    let closed = false;
+    const pass = async () => {
+        try {
+            const result = await collectDocuments(config, state);
+            state = { library: result.library, prepared: result.prepared };
+            options.onPass?.(result);
+        }
+        catch (error) {
+            options.onError?.(error);
+        }
+    };
+    const run = () => {
+        if (running) {
+            pending = true;
+            return running;
+        }
+        running = pass().then(async () => {
+            running = undefined;
+            if (pending && !closed) {
+                pending = false;
+                await run();
+            }
+        });
+        return running;
+    };
+    const schedule = (_event, filename) => {
+        if (closed || !isSource(filename))
+            return;
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(() => {
+            timer = undefined;
+            void run();
+        }, debounce);
+    };
+    const watchers = roots.map((root) => fs.watch(root.dir, { recursive: true }, schedule));
+    return {
+        ready: run(),
+        close() {
+            closed = true;
+            if (timer)
+                clearTimeout(timer);
+            for (const watcher of watchers)
+                watcher.close();
+        },
+    };
+}
+//# sourceMappingURL=watch.js.map

package/dist/node/watch.js.map

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

package/dist/paged.d.ts

@@ -0,0 +1,34 @@
+/**
+ * What the paginated output formats have to agree on.
+ *
+ * A PDF is printed by a browser and a `.docx` is assembled by a writer that
+ * never sees CSS, so the only thing keeping the two in step is a shared
+ * definition rather than two implementations that happen to match. This module
+ * is browser-safe and holds no I/O.
+ */
+import type { Position } from "unist";
+import type { DocumentNode } from "./document.js";
+/** The info string an author writes on a fence to force a page break. */
+export declare const PAGE_BREAK_FENCE = "cudoc-pagebreak";
+/** `data.cudoc.kind` on the node the fence normalizes to. */
+export declare const PAGE_BREAK_KIND = "pageBreak";
+/** The class the printed stylesheets key their `break-after` rule off. */
+export declare const PAGE_BREAK_CLASS = "cudoc-page-break";
+/**
+ * Whether a node is an authored page break.
+ *
+ * A writer must test this **before** any generic `thematicBreak` handling: the
+ * break is carried on a `thematicBreak` because that is a childless flow node
+ * which can never swallow content, so a handler that dispatches on `type` alone
+ * turns an authored page break into a horizontal rule.
+ */
+export declare const isPageBreak: (node: DocumentNode) => boolean;
+/**
+ * The node an authored break becomes.
+ *
+ * `hidden` gives it the user agent's `display: none`, so a host stylesheet
+ * cudoc does not own cannot give the empty element a margin on the primary
+ * site. The printed stylesheet turns it back on and breaks after it.
+ */
+export declare const pageBreakNode: (position?: Position) => DocumentNode;
+//# sourceMappingURL=paged.d.ts.map

package/dist/paged.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paged.d.ts","sourceRoot":"","sources":["../src/paged.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAEjD,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,oBAAoB,CAAA;AAEjD,6DAA6D;AAC7D,eAAO,MAAM,eAAe,cAAc,CAAA;AAE1C,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,qBAAqB,CAAA;AAElD;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,YAAY,KAAG,OACL,CAAA;AAE5C;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,WAAW,QAAQ,KAAG,YAYlD,CAAA"}

package/dist/paged.js

@@ -0,0 +1,44 @@
+/**
+ * What the paginated output formats have to agree on.
+ *
+ * A PDF is printed by a browser and a `.docx` is assembled by a writer that
+ * never sees CSS, so the only thing keeping the two in step is a shared
+ * definition rather than two implementations that happen to match. This module
+ * is browser-safe and holds no I/O.
+ */
+/** The info string an author writes on a fence to force a page break. */
+export const PAGE_BREAK_FENCE = "cudoc-pagebreak";
+/** `data.cudoc.kind` on the node the fence normalizes to. */
+export const PAGE_BREAK_KIND = "pageBreak";
+/** The class the printed stylesheets key their `break-after` rule off. */
+export const PAGE_BREAK_CLASS = "cudoc-page-break";
+/**
+ * Whether a node is an authored page break.
+ *
+ * A writer must test this **before** any generic `thematicBreak` handling: the
+ * break is carried on a `thematicBreak` because that is a childless flow node
+ * which can never swallow content, so a handler that dispatches on `type` alone
+ * turns an authored page break into a horizontal rule.
+ */
+export const isPageBreak = (node) => node.data?.cudoc?.kind === PAGE_BREAK_KIND;
+/**
+ * The node an authored break becomes.
+ *
+ * `hidden` gives it the user agent's `display: none`, so a host stylesheet
+ * cudoc does not own cannot give the empty element a margin on the primary
+ * site. The printed stylesheet turns it back on and breaks after it.
+ */
+export const pageBreakNode = (position) => ({
+    type: "thematicBreak",
+    ...(position ? { position } : {}),
+    data: {
+        hName: "div",
+        hProperties: {
+            className: [PAGE_BREAK_CLASS],
+            "data-cudoc-break": "page",
+            hidden: true,
+        },
+        cudoc: { kind: PAGE_BREAK_KIND },
+    },
+});
+//# sourceMappingURL=paged.js.map

package/dist/paged.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paged.js","sourceRoot":"","sources":["../src/paged.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,yEAAyE;AACzE,MAAM,CAAC,MAAM,gBAAgB,GAAG,iBAAiB,CAAA;AAEjD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAA;AAE1C,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAA;AAElD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAkB,EAAW,EAAE,CACzD,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,KAAK,eAAe,CAAA;AAE5C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAmB,EAAgB,EAAE,CAAC,CAAC;IACnE,IAAI,EAAE,eAAe;IACrB,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACjC,IAAI,EAAE;QACJ,KAAK,EAAE,KAAK;QACZ,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,gBAAgB,CAAC;YAC7B,kBAAkB,EAAE,MAAM;YAC1B,MAAM,EAAE,IAAI;SACb;QACD,KAAK,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE;KACjC;CACF,CAAC,CAAA"}