@heroiclands/package-build 22.21.0 → 22.23.0

package/engine/content-captions.mjs

@@ -1,181 +0,0 @@
-/*
- * SPDX-License-Identifier: GPL-3.0-or-later
- */
-
-import MarkdownIt from "markdown-it";
-import footnotePlugin from "markdown-it-footnote";
-import deflistPlugin from "markdown-it-deflist";
-
-import { slugify } from "./content-slug.mjs";
-import { parseExtensionAttributes } from "./extension-attributes.mjs";
-
-const parser = new MarkdownIt({ html: true }).use(footnotePlugin).use(deflistPlugin);
-const OPEN = /^:::caption\s+(\{[^}\n]*\})\s*$/;
-const CAPTION_LINE = /^:::caption\b/;
-const CLOSE = /^:::\s*$/;
-
-/** A caption's automatically determined kind. */
-export const CAPTION_NAMES = Object.freeze({
-    code: "Code",
-    table: "Table",
-    figure: "Figure",
-    prose: "Prose",
-});
-
-/** Number a sequence of captions with counters shared across documents. */
-export function numberCaptions(captions, counts) {
-    return captions.map((caption) => {
-        const number = (counts[caption.kind] ?? 0) + 1;
-        counts[caption.kind] = number;
-        return { ...caption, number, label: `${CAPTION_NAMES[caption.kind]} ${number}` };
-    });
-}
-
-/**
- * Read caption directives and the Markdown block immediately after each one.
- * SQL fences are expanded before this pass, so their output is a table.
- *
- * @param {string} source - A note body with expanded tables.
- * @returns {{captions: Array<{id: string, text: string, kind: string, number: number,
- *   label: string, line: number, blockStart: number, blockEnd: number,
- *   directiveEnd: number}>, errors: Array<{line: number, column: number, message: string}>}}
- */
-export function scanCaptions(source) {
-    const lines = String(source ?? "").split("\n");
-    const captions = [];
-    const errors = [];
-    const counts = { code: 0, table: 0, figure: 0, prose: 0 };
-    const ids = new Set();
-    const headingIds = [];
-    let codeFence = null;
-
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        const fence = /^ {0,3}(`{3,}|~{3,})/.exec(line);
-        if (codeFence) {
-            if (fence && fence[1][0] === codeFence[0] && fence[1].length >= codeFence.length)
-                codeFence = null;
-            continue;
-        }
-        if (fence) {
-            codeFence = fence[1];
-            continue;
-        }
-        const heading = /^\s*#{1,6}\s+.+?\{#([^}]+)\}\s*$/.exec(line);
-        if (heading) headingIds.push({ id: slugify(heading[1].trim()), line: i + 1 });
-        if (!CAPTION_LINE.test(line)) continue;
-        const open = OPEN.exec(line);
-        if (!open) {
-            errors.push({ line: i + 1, column: 1, message: "caption needs {#anchor} attributes" });
-            continue;
-        }
-        const attributes = parseExtensionAttributes(open[1].slice(1, -1));
-        if (
-            attributes.problems.length ||
-            !attributes.id ||
-            attributes.classes.length ||
-            Object.keys(attributes.values).length
-        ) {
-            errors.push({
-                line: i + 1,
-                column: 1,
-                message: attributes.problems[0] ?? "caption accepts only {#anchor}",
-            });
-            continue;
-        }
-        const id = attributes.id;
-        const start = i;
-        let close = i + 1;
-        while (close < lines.length && !CLOSE.test(lines[close])) close++;
-        if (close === lines.length) {
-            errors.push({ line: start + 1, column: 1, message: "caption needs a closing :::" });
-            continue;
-        }
-        const caption = lines
-            .slice(i + 1, close)
-            .join("\n")
-            .trim();
-        if (!caption) errors.push({ line: start + 1, column: 1, message: "caption text is empty" });
-        if (ids.has(slugify(id)))
-            errors.push({ line: start + 1, column: 1, message: `duplicate caption id "${id}"` });
-        ids.add(slugify(id));
-
-        let next = close + 1;
-        while (next < lines.length && !lines[next].trim()) next++;
-        if (next === lines.length || CAPTION_LINE.test(lines[next])) {
-            errors.push({ line: start + 1, column: 1, message: "caption needs a following block" });
-            i = close;
-            continue;
-        }
-        const tokens = parser.parse(lines.slice(next).join("\n"), {});
-        const first = tokens.find((token) => token.level === 0 && token.map);
-        if (!first) {
-            errors.push({ line: start + 1, column: 1, message: "caption needs a following block" });
-            i = close;
-            continue;
-        }
-        const blockEnd = next + first.map[1];
-        const block = lines.slice(next, blockEnd).join("\n");
-        const kind =
-            first.type === "table_open" ? "table"
-            : first.type === "fence" && /^\s*sql\b/i.test(first.info ?? "") ? "table"
-            : first.type === "fence" || first.type === "code_block" ? "code"
-            : /^(?:!\[|!\[\[|<figure\b|<img\b)/.test(block.trim()) ? "figure"
-            : "prose";
-        const number = ++counts[kind];
-        captions.push({
-            id,
-            text: caption,
-            kind,
-            number,
-            label: `${CAPTION_NAMES[kind]} ${number}`,
-            line: start + 1,
-            blockStart: next,
-            blockEnd,
-            directiveEnd: close + 1,
-        });
-        i = close;
-    }
-    for (const heading of headingIds) {
-        if (ids.has(heading.id))
-            errors.push({
-                line: heading.line,
-                column: 1,
-                message: `heading and caption declare the same anchor "${heading.id}"`,
-            });
-    }
-    return { captions, errors };
-}
-
-/** Render captioned blocks as HTML, leaving other Markdown untouched. */
-export function renderCaptionBlocks(source, renderMarkdown = parser.render.bind(parser), numbers) {
-    const { captions, errors } = scanCaptions(source);
-    if (errors.length) return { markdown: source, errors };
-    const byId = numbers ? new Map(numbers.map((entry) => [entry.id, entry])) : new Map();
-    const lines = String(source ?? "").split("\n");
-    const output = [];
-    let cursor = 0;
-    const escape = (value) =>
-        String(value)
-            .replace(/&/g, "&amp;")
-            .replace(/</g, "&lt;")
-            .replace(/>/g, "&gt;")
-            .replace(/"/g, "&quot;");
-    for (const caption of captions) {
-        output.push(...lines.slice(cursor, caption.line - 1));
-        const numbered = byId.get(caption.id) ?? caption;
-        let html = renderMarkdown(lines.slice(caption.blockStart, caption.blockEnd).join("\n"));
-        if (caption.kind === "figure")
-            html = html.replace(/<figcaption\b[^>]*>[\s\S]*?<\/figcaption>/i, "");
-        const captionHtml = parser.renderInline(caption.text);
-        output.push(
-            `<div id="${escape(slugify(caption.id))}" class="content-caption content-caption-${caption.kind}">`,
-            html.trim(),
-            `<p class="content-caption-label">${escape(numbered.label)}: ${captionHtml}</p>`,
-            "</div>",
-        );
-        cursor = caption.blockEnd;
-    }
-    output.push(...lines.slice(cursor));
-    return { markdown: output.join("\n"), errors: [] };
-}

package/engine/content-secrets.mjs

@@ -1,112 +0,0 @@
-/*
- * SPDX-License-Identifier: GPL-3.0-or-later
- */
-
-import crypto from "node:crypto";
-import markdownit from "markdown-it";
-import footnotePlugin from "markdown-it-footnote";
-import deflistPlugin from "markdown-it-deflist";
-
-const webMarkdown = markdownit({ html: true }).use(footnotePlugin).use(deflistPlugin);
-
-/**
- * Render whole-line `:::secret` blocks for one publishing surface.
- * The source line of each syntax error is relative to the supplied body.
- *
- * @param {string} source - Markdown containing secret blocks.
- * @param {"foundry"|"web"|"book"} target - Publishing surface.
- * @param {(markdown: string) => string} [renderMarkdown] - Foundry's configured renderer.
- * @returns {{markdown: string, errors: Array<{line: number, column: number, message: string}>}}
- */
-export function renderSecretBlocks(
-    source,
-    target,
-    renderMarkdown = webMarkdown.render.bind(webMarkdown),
-) {
-    const lines = String(source ?? "").split("\n");
-    const result = [];
-    const errors = [];
-    let opening = -1;
-    let body = [];
-    let codeFence = null;
-
-    for (let index = 0; index < lines.length; index++) {
-        const line = lines[index];
-        const fence = line.match(/^ {0,3}(`{3,}|~{3,})/);
-        if (codeFence) {
-            if (fence && fence[1][0] === codeFence[0] && fence[1].length >= codeFence.length) {
-                codeFence = null;
-            }
-            if (opening >= 0) body.push(line);
-            else result.push(line);
-            continue;
-        }
-        if (fence) {
-            codeFence = fence[1];
-            if (opening >= 0) body.push(line);
-            else result.push(line);
-            continue;
-        }
-        if (/^:::secret[ \t]*$/.test(line)) {
-            if (opening >= 0) {
-                errors.push({
-                    line: index + 1,
-                    column: 1,
-                    message: "nested secret blocks are not supported",
-                });
-                body.push(line);
-            } else {
-                opening = index;
-                body = [];
-            }
-            continue;
-        }
-        if (/^:::[ \t]*$/.test(line)) {
-            if (opening < 0) {
-                errors.push({
-                    line: index + 1,
-                    column: 1,
-                    message: "secret block has no opening :::secret line",
-                });
-                result.push(line);
-                continue;
-            }
-            const inner = body.join("\n").trim();
-            if (target === "book") {
-                result.push("", "**GM note**", "", inner, "");
-            } else {
-                const html = renderMarkdown(inner).trim();
-                if (target === "foundry") {
-                    const id = crypto
-                        .createHash("sha256")
-                        .update(`${opening}:${inner}`)
-                        .digest("hex")
-                        .slice(0, 12);
-                    result.push(
-                        "",
-                        `<section class="secret" id="secret-${id}">`,
-                        html,
-                        "</section>",
-                        "",
-                    );
-                } else {
-                    result.push("", "<details><summary>Spoiler</summary>", html, "</details>", "");
-                }
-            }
-            opening = -1;
-            body = [];
-            continue;
-        }
-        if (opening >= 0) body.push(line);
-        else result.push(line);
-    }
-    if (opening >= 0) {
-        errors.push({
-            line: opening + 1,
-            column: 1,
-            message: "secret block needs a closing ::: line",
-        });
-        result.push(":::secret", ...body);
-    }
-    return { markdown: result.join("\n"), errors };
-}

package/types/engine/content-admonitions.d.mts

@@ -1,24 +0,0 @@
-/** Find inline info and warning blocks without interpreting code examples. */
-export function scanAdmonitions(source: any): {
-    blocks: {
-        end: number;
-        body: string;
-        start: number;
-        kind: string;
-        id: string;
-    }[];
-    errors: {
-        line: number;
-        column: number;
-        message: string;
-    }[];
-};
-/** Render info and warning blocks as styled, labelled HTML. */
-export function renderAdmonitions(source: any, renderMarkdown?: (src: string, env?: import("markdown-it").Env) => string): {
-    markdown: any;
-    errors: {
-        line: number;
-        column: number;
-        message: string;
-    }[];
-};

package/types/engine/content-captions.d.mts

@@ -1,45 +0,0 @@
-/** Number a sequence of captions with counters shared across documents. */
-export function numberCaptions(captions: any, counts: any): any;
-/**
- * Read caption directives and the Markdown block immediately after each one.
- * SQL fences are expanded before this pass, so their output is a table.
- *
- * @param {string} source - A note body with expanded tables.
- * @returns {{captions: Array<{id: string, text: string, kind: string, number: number,
- *   label: string, line: number, blockStart: number, blockEnd: number,
- *   directiveEnd: number}>, errors: Array<{line: number, column: number, message: string}>}}
- */
-export function scanCaptions(source: string): {
-    captions: Array<{
-        id: string;
-        text: string;
-        kind: string;
-        number: number;
-        label: string;
-        line: number;
-        blockStart: number;
-        blockEnd: number;
-        directiveEnd: number;
-    }>;
-    errors: Array<{
-        line: number;
-        column: number;
-        message: string;
-    }>;
-};
-/** Render captioned blocks as HTML, leaving other Markdown untouched. */
-export function renderCaptionBlocks(source: any, renderMarkdown: ((src: string, env?: import("markdown-it").Env) => string) | undefined, numbers: any): {
-    markdown: any;
-    errors: {
-        line: number;
-        column: number;
-        message: string;
-    }[];
-};
-/** A caption's automatically determined kind. */
-export const CAPTION_NAMES: Readonly<{
-    code: "Code";
-    table: "Table";
-    figure: "Figure";
-    prose: "Prose";
-}>;

package/types/engine/content-secrets.d.mts

@@ -1,17 +0,0 @@
-/**
- * Render whole-line `:::secret` blocks for one publishing surface.
- * The source line of each syntax error is relative to the supplied body.
- *
- * @param {string} source - Markdown containing secret blocks.
- * @param {"foundry"|"web"|"book"} target - Publishing surface.
- * @param {(markdown: string) => string} [renderMarkdown] - Foundry's configured renderer.
- * @returns {{markdown: string, errors: Array<{line: number, column: number, message: string}>}}
- */
-export function renderSecretBlocks(source: string, target: "foundry" | "web" | "book", renderMarkdown?: (markdown: string) => string): {
-    markdown: string;
-    errors: Array<{
-        line: number;
-        column: number;
-        message: string;
-    }>;
-};