@yadsh/dsh-qa-surface 0.5.0 → 0.6.0

package/lib/documents/markdown/directives.js

@@ -0,0 +1,135 @@
+/**
+ * Controlled document directives (§36).
+ *
+ * Markdown stays the canonical source, so the few structures Markdown cannot
+ * express — a page break, a callout — are written as fences the orchestrator
+ * rewrites into the target backend's own representation before the renderer
+ * sees the text:
+ *
+ * ```md
+ * :::pagebreak
+ * :::
+ *
+ * :::note
+ * Important information.
+ * :::
+ * ```
+ *
+ * Anything else is refused rather than passed through: an unknown `:::`
+ * directive would otherwise reach pandoc as literal text, and raw markup
+ * (HTML, LaTeX, Typst escapes) is only accepted when a deployment explicitly
+ * opts in with `documents.create.allowRawMarkup`.
+ */
+import { DocumentError } from "../errors.js";
+const DIRECTIVE_OPEN = /^[ \t]*:::[ \t]*([A-Za-z][A-Za-z0-9_-]*)[ \t]*$/u;
+const DIRECTIVE_CLOSE = /^[ \t]*:::[ \t]*$/u;
+const KNOWN_DIRECTIVES = new Set(["pagebreak", "note", "warning", "info"]);
+const PAGEBREAK_OPENXML = '```{=openxml}\n<w:p><w:r><w:br w:type="page"/></w:r></w:p>\n```';
+const RAW_MARKUP_PATTERNS = [
+    {
+        pattern: /<\s*(?:script|style|iframe|object|embed|applet|form|link|meta|base)\b/iu,
+        label: "HTML element",
+    },
+    { pattern: /<\?|<!ENTITY/iu, label: "processing instruction" },
+    {
+        pattern: /\\(?:input|include|write18|directlua|usepackage)\s*[{[]/iu,
+        label: "LaTeX command",
+    },
+    { pattern: /#(?:import|include|read)\s*[( "]/iu, label: "Typst command" },
+    { pattern: /\{\{|\{%/u, label: "template placeholder" },
+];
+function assertNoRawMarkup(markdown, allowRawMarkup) {
+    if (allowRawMarkup)
+        return;
+    for (const { pattern, label } of RAW_MARKUP_PATTERNS) {
+        if (pattern.test(markdown)) {
+            throw new DocumentError("INVALID_INPUT", `the content carries raw markup (${label}); raw markup is disabled in this deployment`, { details: { kind: label } });
+        }
+    }
+}
+function renderPageBreak(backend) {
+    if (backend === "typst")
+        return "#pagebreak()";
+    // Pandoc's openxml raw block is understood for DOCX output; for the PDF path
+    // the document is rendered through DOCX first, so the same spelling applies.
+    return PAGEBREAK_OPENXML;
+}
+function renderNote(kind, body, backend) {
+    const label = kind === "note" ? "Note" : kind === "warning" ? "Warning" : "Info";
+    const text = body.trim();
+    const header = backend === "typst" ? `*${label}.* ` : `> **${label}.** `;
+    if (text === "")
+        return header.trimEnd();
+    if (backend === "typst") {
+        return header + text.replace(/\n{2,}/gu, "\n\n");
+    }
+    return header + text.split(/\r?\n/u).join("\n> ");
+}
+/**
+ * Rewrite directives for one backend. Line-oriented on purpose: a fence that
+ * appears inside a code block is content, not a directive.
+ */
+export function applyDirectives(markdown, options) {
+    assertNoRawMarkup(markdown, options.allowRawMarkup);
+    const lines = markdown.split(/\r?\n/u);
+    const output = [];
+    let index = 0;
+    while (index < lines.length) {
+        const line = lines[index] ?? "";
+        const fence = /^[ \t]*(`{3,}|~{3,})/u.exec(line);
+        if (fence !== null) {
+            const marker = fence[1] ?? "```";
+            output.push(line);
+            index += 1;
+            while (index < lines.length) {
+                const inner = lines[index] ?? "";
+                output.push(inner);
+                index += 1;
+                if (inner.trimStart().startsWith(marker))
+                    break;
+            }
+            continue;
+        }
+        const directive = DIRECTIVE_OPEN.exec(line);
+        if (directive === null) {
+            output.push(line);
+            index += 1;
+            continue;
+        }
+        const rawName = (directive[1] ?? "").toLowerCase();
+        const directiveName = rawName === "page-break" ? "pagebreak" : rawName;
+        const openedAt = index + 1;
+        if (!KNOWN_DIRECTIVES.has(directiveName)) {
+            throw new DocumentError("INVALID_INPUT", `unsupported document directive ":::${rawName}" (supported: pagebreak, note, warning, info)`, { details: { directive: rawName, line: openedAt } });
+        }
+        index += 1;
+        const body = [];
+        let closed = false;
+        while (index < lines.length) {
+            const inner = lines[index] ?? "";
+            if (DIRECTIVE_CLOSE.test(inner)) {
+                closed = true;
+                index += 1;
+                break;
+            }
+            if (DIRECTIVE_OPEN.test(inner)) {
+                throw new DocumentError("INVALID_INPUT", `document directive ":::${directiveName}" on line ${openedAt} contains a nested directive`, { details: { directive: directiveName, line: openedAt } });
+            }
+            body.push(inner);
+            index += 1;
+        }
+        if (directiveName === "pagebreak") {
+            if (body.some((entry) => entry.trim() !== "")) {
+                throw new DocumentError("INVALID_INPUT", `":::pagebreak" on line ${openedAt} takes no body`, { details: { directive: directiveName, line: openedAt } });
+            }
+            output.push(renderPageBreak(options.backend));
+            continue;
+        }
+        if (!closed) {
+            throw new DocumentError("INVALID_INPUT", `document directive ":::${directiveName}" opened on line ${openedAt} is never closed`, { details: { directive: directiveName, line: openedAt } });
+        }
+        output.push(renderNote(directiveName, body.join("\n"), options.backend));
+    }
+    return { markdown: output.join("\n"), warnings: [] };
+}
+//# sourceMappingURL=directives.js.map

package/lib/documents/markdown/directives.js.map

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

package/lib/documents/markdown/frontmatter.js

@@ -0,0 +1,35 @@
+/**
+ * Front-matter handling (§35).
+ *
+ * A generated document may carry a leading `---` block with scalar metadata.
+ * Only scalars are read: the block feeds document properties and the manifest,
+ * never a nested configuration surface, so there is nothing here an author
+ * could use to reach a backend option.
+ */
+const FRONT_MATTER_PATTERN = /^\uFEFF?---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/u;
+function unquote(value) {
+    const trimmed = value.trim();
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"') && trimmed.length >= 2) ||
+        (trimmed.startsWith("'") && trimmed.endsWith("'") && trimmed.length >= 2)) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+}
+/** Split leading front matter from the body. Malformed lines are ignored. */
+export function parseFrontMatter(markdown) {
+    const match = FRONT_MATTER_PATTERN.exec(markdown);
+    if (match === null)
+        return { attributes: {}, body: markdown };
+    const attributes = {};
+    for (const line of (match[1] ?? "").split(/\r?\n/u)) {
+        const separator = line.indexOf(":");
+        if (separator <= 0)
+            continue;
+        const key = line.slice(0, separator).trim().toLowerCase();
+        if (key === "" || key.startsWith("-"))
+            continue;
+        attributes[key] = unquote(line.slice(separator + 1));
+    }
+    return { attributes, body: markdown.slice(match[0].length) };
+}
+//# sourceMappingURL=frontmatter.js.map

package/lib/documents/markdown/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../../src/documents/markdown/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,oBAAoB,GACxB,4DAA4D,CAAC;AAE/D,SAAS,OAAO,CAAC,KAAa;IAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IACE,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QACzE,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,EACzE,CAAC;QACD,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IAC9D,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;QACpD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,SAAS,IAAI,CAAC;YAAE,SAAS;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC1D,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAChD,UAAU,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;AAC/D,CAAC"}

package/lib/documents/markdown/normalize.js

@@ -0,0 +1,113 @@
+/**
+ * Markdown normalization for extracted documents (§16).
+ *
+ * The layer is deliberately conservative: it removes artifacts a converter
+ * reliably produces (platform line endings, non-breaking spaces, page-number
+ * lines, a running head repeated on every page) and never touches meaning.
+ * Guessing missing content is explicitly out of scope, and an LLM pass is not
+ * part of this stage at all — a document is never sent to a model to make its
+ * Markdown nicer.
+ */
+const PAGE_NUMBER_LINE = /^[ \t]*(?:[-–—|]\s*)?(?:page|стр\.?|страница)?\s*\d{1,4}\s*(?:[-–—|])?[ \t]*$/iu;
+const BULLET_SUBSTITUTES = /^([ \t]*)[•▪◦‣·]([ \t]+)/u;
+const RUNNING_HEAD_MAX_CHARS = 80;
+const RUNNING_HEAD_MIN_REPEATS = 3;
+function collapseBlankRuns(lines) {
+    const output = [];
+    let blanks = 0;
+    for (const line of lines) {
+        if (line.trim() === "") {
+            blanks += 1;
+            if (blanks > 1)
+                continue;
+            output.push("");
+            continue;
+        }
+        blanks = 0;
+        output.push(line);
+    }
+    while (output.length > 0 && output[output.length - 1] === "")
+        output.pop();
+    return output;
+}
+function stripRunningHeads(lines) {
+    const counts = new Map();
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed === "" || trimmed.length > RUNNING_HEAD_MAX_CHARS)
+            continue;
+        if (trimmed.startsWith("#") ||
+            trimmed.startsWith("|") ||
+            trimmed.startsWith(">"))
+            continue;
+        counts.set(trimmed, (counts.get(trimmed) ?? 0) + 1);
+    }
+    const repeated = new Set([...counts.entries()]
+        .filter(([, count]) => count >= RUNNING_HEAD_MIN_REPEATS)
+        .map(([line]) => line));
+    if (repeated.size === 0)
+        return [...lines];
+    return lines.filter((line) => {
+        const trimmed = line.trim();
+        if (trimmed === "" || trimmed.length > RUNNING_HEAD_MAX_CHARS)
+            return true;
+        return !repeated.has(trimmed);
+    });
+}
+/** Normalize extracted Markdown; returns the text and what was changed. */
+export function normalizeExtractedMarkdown(markdown, options = {}) {
+    const warnings = [];
+    let text = markdown
+        .replace(/^\uFEFF/u, "")
+        .replace(/\r\n?/gu, "\n")
+        .replace(/\u00A0/gu, " ")
+        .replace(/[\u200B-\u200D\u2060]/gu, "");
+    const rawLines = text.split("\n");
+    let lines = rawLines.map((line) => line.replace(/\s+$/u, ""));
+    const bulletFix = lines.map((line) => line.replace(BULLET_SUBSTITUTES, "$1- "));
+    if (bulletFix.some((line, index) => line !== lines[index])) {
+        lines = bulletFix;
+    }
+    const beforeHeadStrip = lines.length;
+    if (options.stripRunningHeads ?? true) {
+        lines = stripRunningHeads(lines);
+        if (lines.length < beforeHeadStrip) {
+            warnings.push({
+                code: "TABLE_EXTRACTION_DEGRADED",
+                message: "lines repeated across pages were removed as running heads or footers",
+                details: { removed: beforeHeadStrip - lines.length },
+            });
+        }
+    }
+    if (options.stripPageNumbers ?? true) {
+        const filtered = lines.filter((line, index) => !(PAGE_NUMBER_LINE.test(line) &&
+            (lines[index - 1] ?? "").trim() === "" &&
+            (lines[index + 1] ?? "").trim() === ""));
+        if (filtered.length < lines.length) {
+            warnings.push({
+                code: "TABLE_EXTRACTION_DEGRADED",
+                message: "standalone page-number lines were removed",
+                details: { removed: lines.length - filtered.length },
+            });
+        }
+        lines = filtered;
+    }
+    lines = collapseBlankRuns(lines);
+    text = `${lines.join("\n")}\n`;
+    return { markdown: text, warnings };
+}
+/** Count Markdown structure for `document_inspect` on Markdown inputs. */
+export function markdownStructure(markdown) {
+    const headings = markdown
+        .split("\n")
+        .filter((line) => /^#{1,6}\s+\S/u.test(line)).length;
+    return {
+        headings,
+        images: (markdown.match(/!\[[^\]]*\]\([^)]*\)/gu) ?? []).length,
+        tables: markdown
+            .split(/\n{2,}/u)
+            .filter((block) => /^\|.*\|$/mu.test(block) && /\|\s*-{2,}/u.test(block))
+            .length,
+    };
+}
+//# sourceMappingURL=normalize.js.map

package/lib/documents/markdown/normalize.js.map

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

package/lib/documents/orchestrator/assets.js

@@ -0,0 +1,243 @@
+/**
+ * Asset preparation and reference auditing (§17.1).
+ *
+ * Assets reach a document two ways: the caller names a file in the workspace,
+ * or it inlines bytes as a data URI. Both are copied into the bundle's
+ * `assets/` directory under a name the pipeline chooses, so the rendered
+ * document never depends on a path outside the artifact, and the Markdown
+ * references are rewritten to match.
+ *
+ * Before a renderer runs, every image reference in the source is accounted
+ * for: a missing local file, a reference that leaves the assets directory, or
+ * a remote URL (which the renderer would fetch from the network) is an error,
+ * not a silent drop.
+ */
+import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { DocumentError, asDocumentError } from "../errors.js";
+import { assertBytesWithinBudget } from "../security/limits.js";
+import { assertRelativeAssetReference, resolveInsideRoot, sanitizeFilename, } from "../security/paths.js";
+import { describeBytes, isAllowedAssetMimeType, mimeTypeForFilename, mimeTypeOfBytes, } from "../security/file-types.js";
+import { allowedInputRoots } from "./scope.js";
+const DATA_URI = /^data:([A-Za-z0-9.+/-]+);base64,([\s\S]*)$/u;
+const EXTENSION_BY_MIME = {
+    "image/png": "png",
+    "image/jpeg": "jpg",
+    "image/gif": "gif",
+    "image/webp": "webp",
+    "image/bmp": "bmp",
+    "image/tiff": "tif",
+};
+function extensionFor(mediaType, fallbackName) {
+    const mapped = EXTENSION_BY_MIME[mediaType];
+    if (mapped !== undefined)
+        return mapped;
+    const fromName = fallbackName === undefined ? undefined : path.extname(fallbackName);
+    return fromName === undefined || fromName === "" ? "bin" : fromName.slice(1);
+}
+function decodeBase64(payload, id) {
+    const compact = payload.replace(/\s+/gu, "");
+    try {
+        const buffer = Buffer.from(compact, "base64");
+        if (buffer.length === 0)
+            throw new Error("empty payload");
+        return buffer;
+    }
+    catch (error) {
+        throw new DocumentError("INVALID_ASSET", `asset "${id}" is not valid base64`, {
+            cause: error,
+            details: { asset: id },
+        });
+    }
+}
+export async function prepareAssets(assets, options) {
+    if (assets === undefined || assets.length === 0) {
+        return { assets: [], warnings: [] };
+    }
+    await mkdir(options.assetsDir, { recursive: true });
+    const seenIds = new Set();
+    const prepared = [];
+    const warnings = [];
+    const maxBytes = options.config.limits.maxAssetBytes;
+    for (const asset of assets) {
+        const id = asset.id?.trim() ?? "";
+        if (id === "") {
+            throw new DocumentError("INVALID_ASSET", "every asset needs a non-empty id");
+        }
+        if (seenIds.has(id)) {
+            throw new DocumentError("INVALID_ASSET", `asset id "${id}" is used twice`, {
+                details: { asset: id },
+            });
+        }
+        seenIds.add(id);
+        if ((asset.path === undefined) === (asset.dataRef === undefined)) {
+            throw new DocumentError("INVALID_ASSET", `asset "${id}" must carry exactly one of path or dataRef`, { details: { asset: id } });
+        }
+        let bytes;
+        let references = [];
+        if (asset.path !== undefined) {
+            const declared = asset.path.trim();
+            let resolved;
+            for (const root of allowedInputRoots(options.config, options.scope)) {
+                try {
+                    resolved = await resolveInsideRoot(root, declared, `asset "${id}"`);
+                    break;
+                }
+                catch (error) {
+                    if (error instanceof DocumentError &&
+                        error.code === "PATH_NOT_ALLOWED")
+                        continue;
+                    throw error;
+                }
+            }
+            if (resolved === undefined) {
+                throw new DocumentError("PATH_NOT_ALLOWED", `asset "${id}" is outside the session workspace and configured document roots`, { details: { asset: id } });
+            }
+            const details = await stat(resolved).catch(() => undefined);
+            if (details === undefined || !details.isFile()) {
+                throw new DocumentError("INVALID_ASSET", `asset "${id}" does not exist`, {
+                    details: { asset: id },
+                });
+            }
+            assertBytesWithinBudget(details.size, maxBytes, `asset "${id}"`);
+            bytes = await readFile(resolved).catch((error) => {
+                throw asDocumentError(error, "INVALID_ASSET", id);
+            });
+            // Both separators: a source authored on one platform may spell the path
+            // the other way, and the rewrite has to catch it either way.
+            references = [declared, resolved, resolved.replace(/\\/gu, "/")];
+        }
+        else {
+            const match = DATA_URI.exec((asset.dataRef ?? "").trim());
+            if (match === null) {
+                throw new DocumentError("INVALID_ASSET", `asset "${id}" must be a base64 data URI`, { details: { asset: id } });
+            }
+            bytes = decodeBase64(match[2] ?? "", id);
+            assertBytesWithinBudget(bytes.length, maxBytes, `asset "${id}"`);
+            if (asset.mimeType === undefined) {
+                const declaredMime = match[1] ?? "";
+                if (declaredMime.startsWith("image/")) {
+                    warnings.push({
+                        code: "METADATA_PARTIALLY_EXTRACTED",
+                        message: `asset "${id}" carries no mimeType; the data URI's type was used`,
+                        details: { asset: id },
+                    });
+                }
+            }
+        }
+        assertBytesWithinBudget(bytes.length, maxBytes, `asset "${id}"`);
+        const declaredMime = asset.mimeType?.trim();
+        const dataUriMime = asset.dataRef === undefined
+            ? undefined
+            : DATA_URI.exec(asset.dataRef.trim())?.[1];
+        const mediaType = (declaredMime === undefined || declaredMime === ""
+            ? undefined
+            : declaredMime) ??
+            (dataUriMime === undefined || dataUriMime === ""
+                ? undefined
+                : dataUriMime) ??
+            mimeTypeOfBytes(bytes) ??
+            (asset.filename === undefined
+                ? undefined
+                : mimeTypeForFilename(asset.filename)) ??
+            "";
+        if (mediaType === "") {
+            throw new DocumentError("INVALID_ASSET", `asset "${id}" has no recognizable media type`, { details: { asset: id, bytes: describeBytes(bytes) } });
+        }
+        if (!isAllowedAssetMimeType(mediaType, options.config.limits.allowedAssetMimeTypes)) {
+            throw new DocumentError("INVALID_ASSET", `asset "${id}" has media type ${mediaType}, which this deployment does not accept`, { details: { asset: id, mediaType } });
+        }
+        const fileName = sanitizeFilename(asset.filename ??
+            (asset.path === undefined ? id : path.basename(asset.path)), id, `.${extensionFor(mediaType, asset.filename)}`);
+        await writeFile(path.join(options.assetsDir, fileName), bytes);
+        // Two spellings reach the stored file: the declared path (rewritten to the
+        // stored name) and the asset id, so a source that references
+        // `assets/<id>.<ext>` lands on the same file as one that references the
+        // final name.
+        const idReference = `assets/${id}${path.extname(fileName)}`;
+        if (!references.includes(idReference))
+            references.push(idReference);
+        prepared.push({ id, fileName, mediaType, bytes: bytes.length, references });
+    }
+    return { assets: prepared, warnings };
+}
+const IMAGE_REFERENCE = /!\[[^\]]*\]\(\s*([^)\s]+)(?:\s+"[^"]*")?\s*\)/gu;
+function normalizeReference(value) {
+    return value.trim().replace(/\\/gu, "/").replace(/^\.\//u, "");
+}
+/** Any spelling of a provided asset's location, mapped to its stored name. */
+function referenceIndex(assets, roots) {
+    const index = new Map();
+    const remember = (raw, fileName) => {
+        const candidates = [normalizeReference(raw)];
+        for (const root of roots) {
+            candidates.push(normalizeReference(path.isAbsolute(raw) ? path.resolve(raw) : path.resolve(root, raw)));
+        }
+        for (const candidate of candidates) {
+            if (candidate !== "" && !index.has(candidate))
+                index.set(candidate, fileName);
+        }
+    };
+    for (const asset of assets) {
+        for (const reference of asset.references)
+            remember(reference, asset.fileName);
+    }
+    return index;
+}
+/**
+ * Rewrite the image references that point at a provided asset to the bundle's
+ * own `assets/<name>`, keeping every other reference untouched. Matching is
+ * whole-reference (never a substring) and resolves relative spellings against
+ * the workspace, so an absolute path and a workspace-relative path to the same
+ * file both land on the same asset.
+ */
+export function rewriteAssetReferences(markdown, assets, options) {
+    if (assets.length === 0)
+        return markdown;
+    const index = referenceIndex(assets, options.roots);
+    return markdown.replace(IMAGE_REFERENCE, (full, reference) => {
+        const direct = index.get(normalizeReference(reference));
+        if (direct !== undefined)
+            return full.replace(reference, `assets/${direct}`);
+        for (const root of options.roots) {
+            const resolved = index.get(normalizeReference(path.resolve(root, reference)));
+            if (resolved !== undefined)
+                return full.replace(reference, `assets/${resolved}`);
+        }
+        return full;
+    });
+}
+/**
+ * Verify every image reference in the Markdown before a renderer can act on
+ * it: local files must exist inside the assets directory, and remote URLs are
+ * refused because the renderer would fetch them (§26.5).
+ */
+export async function auditAssetReferences(markdown, options) {
+    const warnings = [];
+    const prepared = new Set(options.assets.map((asset) => asset.fileName));
+    for (const match of markdown.matchAll(IMAGE_REFERENCE)) {
+        const rawReference = match[1] ?? "";
+        // A scheme with an authority is a remote fetch; an absolute path (which on
+        // Windows starts with a drive letter and therefore looks like a scheme) is
+        // not, and is caught by the containment check below.
+        if (/^[A-Za-z][A-Za-z0-9+.-]*:\/\//u.test(rawReference) ||
+            rawReference.startsWith("//")) {
+            throw new DocumentError("INVALID_ASSET", `the source references the remote image "${rawReference}"; remote images are never fetched — add it through assets instead`, { details: { reference: rawReference } });
+        }
+        const reference = assertRelativeAssetReference(rawReference.replace(/^\.\//u, ""));
+        const fileName = path.basename(reference);
+        const target = path.resolve(options.assetsDir, reference);
+        const insideAssets = path.relative(options.assetsDir, target).split(path.sep)[0] !== "..";
+        if (!insideAssets) {
+            throw new DocumentError("INVALID_ASSET", `the source references "${rawReference}", which leaves the assets directory`, { details: { reference: rawReference } });
+        }
+        if (prepared.has(fileName))
+            continue;
+        const details = await stat(target).catch(() => undefined);
+        if (details?.isFile() === true)
+            continue;
+        throw new DocumentError("INVALID_ASSET", `the source references "${rawReference}", but no such asset was provided`, { details: { reference: rawReference } });
+    }
+    return warnings;
+}
+//# sourceMappingURL=assets.js.map

package/lib/documents/orchestrator/assets.js.map

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