@cudoment/cudoc 0.3.0 → 0.5.0

package/dist/node/check.js

@@ -0,0 +1,543 @@
+/**
+ * Whole-library reference checking.
+ *
+ * The build deliberately stops at the first unresolvable reference, because a
+ * site with a broken link should not ship. That makes it a poor way to find out
+ * what is wrong: an author fixes one link, rebuilds, and learns about the next.
+ * This walks every document instead and returns everything at once.
+ *
+ * It resolves through the same code the build uses, so a reference this reports
+ * as fine is one the build can resolve.
+ */
+import { DEFAULT_TABLE_COLUMNS, buildEmbedRow, extractCell, parseEmbedSpec, } from "./resolve-embed.js";
+import { collectSections } from "../sections.js";
+import { isExternalPath, resolveLocalTarget, } from "./local-target.js";
+import { resolveRoots } from "./roots.js";
+/** A heading id that a slugger disambiguated, such as `overview-1`. */
+const SUFFIXED = /-\d+$/;
+const walkNodes = (node, visit) => {
+    visit(node);
+    node.children?.forEach((child) => walkNodes(child, visit));
+};
+/**
+ * Every anchor a document offers, and whether the author wrote it.
+ *
+ * Both halves matter. The ids answer whether a link resolves; the origin
+ * answers whether it will keep resolving, because a generated id depends on how
+ * many same-named headings precede it.
+ */
+export function collectAnchors(tree) {
+    const anchors = [];
+    walkNodes(tree, (node) => {
+        if (node.type !== "heading")
+            return;
+        const id = node.data?.hProperties?.id;
+        if (typeof id === "string" && id)
+            anchors.push({ id, explicit: node.data?.cudoc?.explicitId === true });
+    });
+    return anchors;
+}
+/**
+ * Where a reference sits in the original Markdown.
+ *
+ * Collection strips positions from the stored tree on purpose: a persisted AST
+ * should not carry coordinates that go stale the moment the file is edited. The
+ * source snapshot is still here, so the first occurrence of the reference text
+ * gives an author somewhere real to jump to. A reference repeated in one
+ * document reports the first one; fixing it means fixing both anyway.
+ */
+/**
+ * The forms a reference might take in the original Markdown.
+ *
+ * The tree holds what the host compiler produced, and hosts rewrite link
+ * destinations: Nextra drops the extension, VitePress rewrites it to `.html`
+ * and prefixes `./`. The author wrote `reference.md#limit`, so searching the
+ * source for the compiled form finds nothing. These are tried in turn.
+ */
+const sourceForms = (reference) => {
+    const [pathname, anchor] = reference.split("#");
+    if (!pathname)
+        return [reference];
+    const bare = pathname.replace(/^\.\//, "").replace(/\.(?:mdx?|html?)$/i, "");
+    const suffix = anchor === undefined ? "" : `#${anchor}`;
+    return [
+        ...new Set([
+            reference,
+            `${bare}.md${suffix}`,
+            `${bare}.mdx${suffix}`,
+            `${bare}${suffix}`,
+        ]),
+    ];
+};
+const locate = (text, reference, skip = 0) => {
+    // A reference is often a prefix of a longer one on an earlier line, as
+    // `guide.md#limit` is of `guide.md#limits`. Prefer an occurrence that ends
+    // where a Markdown destination ends, and fall back to a plain search.
+    const ends = new Set([")", "]", '"', "'", " ", "\t", "\n", ""]);
+    let at = -1;
+    let remaining = skip;
+    for (let i = text.indexOf(reference); i >= 0; i = text.indexOf(reference, i + 1))
+        if (ends.has(text[i + reference.length] ?? "")) {
+            if (remaining-- > 0)
+                continue;
+            at = i;
+            break;
+        }
+    if (at < 0)
+        at = text.indexOf(reference);
+    if (at < 0)
+        return undefined;
+    const before = text.slice(0, at);
+    const line = before.split("\n").length;
+    const column = at - (before.lastIndexOf("\n") + 1) + 1;
+    const offset = at;
+    return {
+        start: { line, column, offset },
+        end: {
+            line,
+            column: column + reference.length,
+            offset: offset + reference.length,
+        },
+    };
+};
+/**
+ * Components in a tree that no portable renderer can turn into HTML.
+ *
+ * `documentToHast` renders an unknown `mdx*` or directive node only when the
+ * caller supplies an explicit HTML callback for it, and throws otherwise. A
+ * component sitting in a document is the author's business, because the host
+ * that owns it renders it. A component sitting in a section that an embed
+ * copies is different: the copy lands in another document, and standalone HTML
+ * export then has to render a name it was never given.
+ *
+ * `mdxjsEsm` and `yaml` are excluded because the renderer drops them rather
+ * than failing.
+ */
+const unportableComponents = (tree) => {
+    const names = new Set();
+    walkNodes(tree, (node) => {
+        if (node.type === "mdxjsEsm" || node.type === "yaml")
+            return;
+        if (!node.type.startsWith("mdx") && !node.type.endsWith("Directive"))
+            return;
+        names.add(node.name ? `<${node.name}>` : node.type);
+    });
+    return [...names];
+};
+/** The visible text of a heading, used to spot an anchor that failed to parse. */
+const headingText = (node) => {
+    let text = "";
+    walkNodes(node, (child) => {
+        if (child.type === "text" && typeof child.value === "string")
+            text += child.value;
+    });
+    return text;
+};
+/** The line each `cudoc-embed` fence opens on, in source order. */
+const embedFenceLines = (text) => {
+    const lines = [];
+    text.split("\n").forEach((line, index) => {
+        if (/^\s*(?:`{3,}|~{3,})cudoc-embed\s*$/.test(line))
+            lines.push(index + 1);
+    });
+    return lines;
+};
+/**
+ * Whether a rule finds anything, asked the way the resolver asks it.
+ *
+ * Rules run in order and each sees the previous one's output, so a later rule
+ * can legitimately depend on an earlier substitution. Testing them against the
+ * untouched slice would report those as unmatched.
+ */
+const matchedRules = (slice, rules) => {
+    const matched = [];
+    let value = slice;
+    rules.forEach((rule, index) => {
+        try {
+            if (rule.regex) {
+                const pattern = new RegExp(rule.find, rule.flags ?? "g");
+                matched[index] = pattern.test(value);
+                value = value.replace(new RegExp(rule.find, rule.flags ?? "g"), rule.replace);
+            }
+            else {
+                matched[index] = value.includes(rule.find);
+                value = value.split(rule.find).join(rule.replace);
+            }
+        }
+        catch {
+            // An unusable pattern is the resolver's error to raise, not a miss.
+            matched[index] = true;
+        }
+    });
+    return matched;
+};
+export function checkReferences(library, options = {}) {
+    const roots = options.roots !== undefined || options.sourceRoot !== undefined
+        ? resolveRoots(options)
+        : library.roots;
+    const targetRoots = {
+        assetDirs: options.assetDirs,
+        withoutBase: options.withoutBase,
+        externalPaths: options.externalPaths,
+    };
+    const ignore = new Set(options.ignore ?? []);
+    const issues = [];
+    let checkedReferences = 0;
+    // Where a copied component can render at all: an MDX host compiles the
+    // spliced nodes with its own component mapping, a Markdown host cannot.
+    const mdxHost = ["next", "docusaurus", "nextra"].includes(library.options.host ?? "");
+    const anchorsById = new Map(library.documents.map((doc) => [doc.id, collectAnchors(doc.tree)]));
+    const byId = new Map(library.documents.map((doc) => [doc.id, doc]));
+    const report = (doc, 
+    /** A `position` given here wins; otherwise it is recovered from the source. */
+    issue, 
+    /** Which occurrence of the reference to point at. A duplicate wants the later one. */
+    skip = 0) => {
+        if (ignore.has(issue.code))
+            return;
+        issues.push({
+            ...issue,
+            documentId: doc.id,
+            sourcePath: doc.sourcePath,
+            position: issue.position ??
+                sourceForms(issue.reference).reduce((found, form) => found ?? locate(doc.source?.text ?? "", form, skip), undefined),
+        });
+    };
+    /** Resolves `other.md#anchor` or a bare `#anchor` against the library. */
+    const checkDocumentLink = (doc, url) => {
+        const [pathname, anchor] = url.split("#");
+        let target = doc;
+        if (pathname) {
+            const found = resolveDocument(doc, pathname);
+            if (!found)
+                return false; // not a document link; the asset pass handles it
+            target = found;
+        }
+        if (!anchor)
+            return true;
+        const anchors = anchorsById.get(target.id) ?? [];
+        const match = anchors.find((entry) => entry.id === anchor);
+        if (!match) {
+            report(doc, {
+                code: "missing-anchor",
+                severity: "error",
+                message: `${target.id} has no anchor #${anchor}`,
+                reference: url,
+                available: anchors.map((entry) => entry.id),
+            });
+            return true;
+        }
+        if (!match.explicit && SUFFIXED.test(match.id))
+            report(doc, {
+                code: "unstable-anchor-link",
+                severity: "warning",
+                message: `#${anchor} in ${target.id} is generated from a repeated heading; inserting another one above it moves this link to a different section. Give the target heading an explicit anchor.`,
+                reference: url,
+            });
+        return true;
+    };
+    /**
+     * The document a link names, if it names one in this library.
+     *
+     * Hosts do not agree on how a link looks once compiled. Docusaurus and
+     * Next.js leave `reference.md`, Nextra drops the extension, and VitePress
+     * rewrites it to the deployed `./reference.html`. All three mean the same
+     * document, so any of those endings resolves to the same id. A relative
+     * path resolves in the library's coordinates, so it can reach another root
+     * exactly when the bases mirror the directories; a root-relative one names
+     * a library path directly, and then once more with the deployment base
+     * removed, the way the exporter looks a route up.
+     */
+    const resolveDocument = (doc, pathname) => {
+        if (/^(?:[a-z][\w+.-]*:|\/\/)/i.test(pathname))
+            return undefined;
+        const decoded = decodeURIComponent(pathname);
+        const toId = (value) => normalize(value).replace(/\.(?:mdx?|html?)$/i, "");
+        if (!decoded.startsWith("/"))
+            return byId.get(toId(posixJoin(dirname(doc.sourcePath), decoded)));
+        const direct = byId.get(toId(decoded.slice(1)));
+        if (direct || !options.withoutBase)
+            return direct;
+        return byId.get(toId(options.withoutBase(decoded).replace(/^\//, "")));
+    };
+    for (const doc of library.documents) {
+        // Anchors the document declares, before anything references them.
+        const seen = new Set();
+        const counts = new Map();
+        walkNodes(doc.tree, (node) => {
+            if (node.type !== "heading")
+                return;
+            const id = node.data?.hProperties?.id;
+            if (typeof id === "string" && id) {
+                const before = counts.get(id) ?? 0;
+                if (before)
+                    report(doc, {
+                        code: "duplicate-anchor",
+                        severity: "error",
+                        message: `duplicate heading anchor #${id}`,
+                        reference: `#${id}`,
+                    }, before);
+                counts.set(id, before + 1);
+                seen.add(id);
+            }
+            // An anchor marker with no id never becomes an anchor. It stays in the
+            // heading text instead, and silently joins the generated slug.
+            const text = headingText(node);
+            const empty = text.match(/\((#)\)|\{(#)\}/);
+            if (empty)
+                report(doc, {
+                    code: "empty-anchor",
+                    severity: "error",
+                    message: `empty anchor marker left in the heading text: "${text.trim()}"`,
+                    reference: empty[0],
+                });
+        });
+        walkNodes(doc.tree, (node) => {
+            const url = node.type === "link" || node.type === "image" ? node.url : undefined;
+            if (typeof url !== "string" || !url)
+                return;
+            // A heading permalink is machinery the host inserted, not something an
+            // author wrote. VitePress and Eleventy add one per heading, and counting
+            // them would report every generated anchor as an unstable link.
+            if (node.data?.cudoc?.kind === "permalink")
+                return;
+            checkedReferences++;
+            if (/^(?:[a-z][\w+.-]*:|\/\/)/i.test(url))
+                return; // external
+            // Another application's path on the same host: nothing here to check.
+            if (isExternalPath(url, options.externalPaths))
+                return;
+            if (node.type === "link" && checkDocumentLink(doc, url))
+                return;
+            if (url.startsWith("#"))
+                return; // handled above as a same-document anchor
+            if (!roots)
+                return;
+            const target = resolveLocalTarget(url, doc.sourcePath, {
+                ...targetRoots,
+                roots,
+            });
+            if (target.kind === "missing")
+                report(doc, {
+                    code: node.type === "image" ? "missing-asset" : "missing-document",
+                    severity: "error",
+                    message: node.type === "image"
+                        ? `no file for image ${url}; check the collection roots and assetDirs`
+                        : `no document or file for ${url}`,
+                    reference: url,
+                });
+        });
+        // Fence lines are read from the source because collection strips positions,
+        // and they are what turns a YAML error's own coordinate into a file one.
+        const fences = embedFenceLines(doc.source?.text ?? "");
+        let blockNumber = 0;
+        walkNodes(doc.tree, (node) => {
+            if (node.type !== "code" || node.lang !== "cudoc-embed")
+                return;
+            const fence = fences[blockNumber++];
+            let spec;
+            try {
+                spec = parseEmbedSpec(node.value ?? "");
+            }
+            catch (error) {
+                // The YAML parser counts from the start of the block; an author counts
+                // from the start of the file. Add the fence so both agree.
+                const at = error.linePos?.[0];
+                const line = fence === undefined ? undefined : fence + (at?.line ?? 0);
+                report(doc, {
+                    code: "invalid-embed-spec",
+                    severity: "error",
+                    // The parser's own "at line 3, column 24" is dropped: it counts from
+                    // the block, and the position below already says the same thing in
+                    // the file's own coordinates.
+                    message: error.message
+                        .replace(/^cudoc: /, "")
+                        .split("\n")[0]
+                        .replace(/\s*at line \d+, column \d+:?\s*$/, "")
+                        .trim(),
+                    reference: `embed block ${blockNumber}`,
+                    position: line === undefined
+                        ? undefined
+                        : {
+                            start: { line, column: at?.col ?? 1 },
+                            end: { line, column: at?.col ?? 1 },
+                        },
+                });
+                return;
+            }
+            for (const reference of spec.sources ?? []) {
+                checkedReferences++;
+                const [pathname, anchor] = String(reference).split("#");
+                const target = pathname
+                    ? resolveDocument(doc, pathname)
+                    : byId.get(doc.id);
+                if (!target) {
+                    report(doc, {
+                        code: "missing-embed-source",
+                        severity: "error",
+                        message: `embed source ${reference} does not name a collected document`,
+                        reference: String(reference),
+                    });
+                    continue;
+                }
+                const anchors = anchorsById.get(target.id) ?? [];
+                if (anchor && !anchors.some((entry) => entry.id === anchor)) {
+                    report(doc, {
+                        code: "missing-embed-anchor",
+                        severity: "error",
+                        message: `${target.id} has no section #${anchor} to embed`,
+                        reference: String(reference),
+                        available: anchors.map((entry) => entry.id),
+                    });
+                    continue;
+                }
+                // The same selection the resolver will apply, so what is inspected is
+                // what would actually be copied. `select.anchors` can name a section
+                // that does not exist, which `collectSections` rejects; the build hits
+                // the same error, so it is reported rather than swallowed.
+                const selection = anchor ? { anchors: [anchor] } : spec.select;
+                let copied;
+                try {
+                    copied = selection
+                        ? collectSections(target.tree, selection)
+                        : [{ anchorId: undefined, tree: target.tree }];
+                }
+                catch (error) {
+                    report(doc, {
+                        code: "missing-embed-anchor",
+                        severity: "error",
+                        message: `${target.id}: ${error.message.replace(/^cudoc: /, "")}`,
+                        reference: String(reference),
+                        available: anchors.map((entry) => entry.id),
+                    });
+                    continue;
+                }
+                // Replacement runs on the original Markdown, not the tree, so the
+                // slices are recomputed the way `transformedSection` cuts them. A rule
+                // that matches no slice changed nothing, and the embed silently shows
+                // the source's own wording in a place written to expect otherwise.
+                const rules = spec.replace ?? [];
+                if (rules.length && target.source) {
+                    const matched = rules.map(() => false);
+                    for (const section of copied) {
+                        const range = section.anchorId
+                            ? target.source.sections[section.anchorId]
+                            : undefined;
+                        const slice = range
+                            ? target.source.text.slice(range.start, spec.select?.includeChildren === false
+                                ? (range.ownEnd ?? range.end)
+                                : range.end)
+                            : target.source.text;
+                        matchedRules(slice, rules).forEach((hit, index) => {
+                            if (hit)
+                                matched[index] = true;
+                        });
+                    }
+                    rules.forEach((rule, index) => {
+                        if (matched[index])
+                            return;
+                        report(doc, {
+                            code: "unmatched-embed-replacement",
+                            severity: "warning",
+                            message: `replacement ${index + 1} found no "${rule.find}" in what this embed copies from ${target.id}, so nothing was changed. The source may have been reworded${rule.regex ? "" : "; literal rules are case-sensitive"}.`,
+                            reference: rule.find,
+                        });
+                    });
+                }
+                // A table carries extracted text and nothing else, so whatever else
+                // the body holds never travels. What can go wrong is a column that
+                // finds nothing in a row: the resolver renders an empty cell, and the
+                // author would only notice by reading the page.
+                if (typeof spec.render === "object" && spec.render?.type === "table") {
+                    const columns = spec.render.columns ?? DEFAULT_TABLE_COLUMNS;
+                    for (const section of copied) {
+                        const row = buildEmbedRow(target, section.anchorId, section.tree);
+                        columns.forEach((column, index) => {
+                            // A shorthand column is best effort: `summary` of a section
+                            // that opens with a table is legitimately blank. A column
+                            // written as a mapping states what every row must have.
+                            if (typeof column === "string")
+                                return;
+                            let problem;
+                            try {
+                                problem = extractCell(library, column, row, {
+                                    documentId: doc.id,
+                                }).problem;
+                            }
+                            catch (error) {
+                                // An extractor the configuration does not register is a
+                                // setting problem, reported once per column like a bad key.
+                                report(doc, {
+                                    code: "invalid-embed-spec",
+                                    severity: "error",
+                                    message: error.message.replace(/^cudoc: /, ""),
+                                    reference: String(reference),
+                                });
+                                return;
+                            }
+                            if (!problem)
+                                return;
+                            const header = typeof column === "string"
+                                ? column
+                                : (column.header ??
+                                    (typeof column.value === "string" ? column.value : ""));
+                            report(doc, {
+                                code: "empty-embed-cell",
+                                severity: "warning",
+                                message: `column ${index + 1}${header ? ` "${header}"` : ""} is empty for the row from ${row.document.id}${row.section.anchorId ? `#${row.section.anchorId}` : ""}: ${problem}`,
+                                reference: String(reference),
+                            });
+                        });
+                    }
+                    continue;
+                }
+                const names = [
+                    ...new Set(copied.flatMap((section) => unportableComponents(section.tree))),
+                ];
+                if (names.length)
+                    report(doc, {
+                        code: "unportable-embed-component",
+                        severity: "warning",
+                        message: mdxHost
+                            ? `this embed copies ${names.join(", ")} out of ${target.id}. The host renders them where the copy is spliced in, but standalone HTML export has no renderer for them and fails. Keep embedded sections to Markdown, or pass a renderer for each name.`
+                            : `this embed copies ${names.join(", ")} out of ${target.id}. Neither this host nor standalone HTML export can render them. Keep embedded sections to Markdown, or pass a renderer for each name.`,
+                        reference: String(reference),
+                    });
+                // A component the source file imports for itself does not travel
+                // with the copy: the export drops the import, and the embedding
+                // document has no binding for the name unless it imports it too.
+                const orphaned = names
+                    .map((name) => name.replace(/^<|>$/g, "").split(".")[0])
+                    .filter((name) => target.imports?.includes(name) && !doc.imports?.includes(name));
+                if (orphaned.length)
+                    report(doc, {
+                        code: "imported-embed-component",
+                        severity: "error",
+                        message: `this embed copies ${orphaned.map((name) => `<${name}>`).join(", ")} out of ${target.id}, which imports ${orphaned.length === 1 ? "it" : "them"} in its own file. ${doc.id} has no such import, so the spliced copy cannot render ${orphaned.length === 1 ? "it" : "them"}. Provide the component through the host's shared components, import it in ${doc.id} as well, or move it out of the embedded section.`,
+                        reference: String(reference),
+                    });
+            }
+        });
+    }
+    return { issues, documentCount: library.documents.length, checkedReferences };
+}
+// Posix path helpers, kept local so this module stays usable without importing
+// the whole node path surface into a browser-safe boundary by accident.
+const dirname = (value) => {
+    const at = value.lastIndexOf("/");
+    return at <= 0 ? "." : value.slice(0, at);
+};
+const posixJoin = (base, value) => base === "." ? value : `${base}/${value}`;
+const normalize = (value) => {
+    const out = [];
+    for (const part of value.split("/")) {
+        if (!part || part === ".")
+            continue;
+        if (part === "..")
+            out.pop();
+        else
+            out.push(part);
+    }
+    return out.join("/");
+};
+//# sourceMappingURL=check.js.map

package/dist/node/check.js.map

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

package/dist/node/cli.js

@@ -5,24 +5,70 @@ import { pathToFileURL } from "node:url";
 import { buildDocuments, buildDocumentsAsync } from "./library.js";
 import { prepareEmbeds } from "./prepare-embeds.js";
 import { generateDataset } from "./dataset.js";
+import { checkReferences } from "./check.js";
+import { formatCheckResult } from "./report.js";
+import { watchDocuments } from "./watch.js";
+const USAGE = "Usage: cudoc <collect|check|dataset> --config config.mjs [--watch] [--format text|json] [--strict]";
 try {
-    const [command, ...args] = process.argv.slice(2);
-    if (!["collect", "dataset"].includes(command) ||
-        args.length !== 2 ||
-        args[0] !== "--config")
-        throw new Error("Usage: cudoc <collect|dataset> --config config.mjs");
-    const config = args[1].endsWith(".json")
-        ? JSON.parse(fs.readFileSync(args[1], "utf8"))
-        : (await import(pathToFileURL(path.resolve(args[1])).href)).default;
-    if (command === "dataset")
-        console.log(JSON.stringify(generateDataset(config)));
-    else {
+    const argv = process.argv.slice(2);
+    const [command] = argv;
+    const flags = new Set(argv.filter((value) => value.startsWith("--")));
+    const configIndex = argv.indexOf("--config");
+    if (!["collect", "check", "dataset"].includes(command) ||
+        configIndex === -1 ||
+        !argv[configIndex + 1])
+        throw new Error(USAGE);
+    const configPath = argv[configIndex + 1];
+    const config = configPath.endsWith(".json")
+        ? JSON.parse(fs.readFileSync(configPath, "utf8"))
+        : (await import(pathToFileURL(path.resolve(configPath)).href)).default;
+    const collect = async () => {
         const library = config.compiler
             ? await buildDocumentsAsync({
                 ...config,
                 compiler: async (...parameters) => config.compiler(...parameters),
             })
             : buildDocuments(config);
+        return library;
+    };
+    if (command === "dataset")
+        console.log(JSON.stringify(generateDataset(config)));
+    else if (command === "check") {
+        // Checking reads the same collection the build does, so it sees exactly
+        // what the site will render. It writes nothing.
+        const result = checkReferences(await collect(), config.check ?? {});
+        const json = argv[argv.indexOf("--format") + 1] === "json";
+        console.log(json ? JSON.stringify(result, null, 2) : formatCheckResult(result));
+        const blocking = result.issues.filter((issue) => issue.severity === "error" || flags.has("--strict"));
+        if (blocking.length)
+            process.exitCode = 1;
+    }
+    else if (flags.has("--watch")) {
+        // The first pass starts from whatever the output directory holds, and
+        // every pass reports what it compiled; a failed pass is a message and the
+        // last good output stays in place.
+        const watcher = watchDocuments(config, {
+            onPass: ({ documentCount, compiled, reused, blocks, reusedBlocks, outDir, elapsed, }) => console.log(JSON.stringify({
+                documentCount,
+                compiled,
+                reused,
+                blocks,
+                reusedBlocks,
+                outDir,
+                elapsed,
+            })),
+            onError: (error) => console.error(error),
+        });
+        const stop = () => {
+            watcher.close();
+            process.exit(0);
+        };
+        process.on("SIGINT", stop);
+        process.on("SIGTERM", stop);
+        await watcher.ready;
+    }
+    else {
+        const library = await collect();
         await prepareEmbeds(library, config.outDir);
         console.log(JSON.stringify({
             documentCount: library.documents.length,