@heroiclands/package-build 22.21.0 → 22.22.0

package/engine/content-admonitions.mjs

@@ -1,114 +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 { parseExtensionAttributes } from "./extension-attributes.mjs";
-
-const parser = new MarkdownIt({ html: true }).use(footnotePlugin).use(deflistPlugin);
-const OPEN = /^:::(info|warn)(?:\s+(.*))?\s*$/;
-const CLOSE = /^:::\s*$/;
-const STYLES = Object.freeze({
-    info: { label: "Info", icon: "ℹ", color: "#2f6f9f", background: "#eef6fb" },
-    warn: { label: "Warning", icon: "⚠", color: "#9a6700", background: "#fff5db" },
-});
-
-/** Find inline info and warning blocks without interpreting code examples. */
-export function scanAdmonitions(source) {
-    const lines = String(source ?? "").split("\n");
-    const blocks = [];
-    const errors = [];
-    let opening = null;
-    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 open = OPEN.exec(line);
-        if (open) {
-            if (opening) {
-                errors.push({
-                    line: i + 1,
-                    column: 1,
-                    message: "nested info and warning blocks are not supported",
-                });
-                continue;
-            }
-            const raw = open[2]?.trim() ?? "";
-            let id = "";
-            if (raw) {
-                if (!/^\{[^}\n]*\}$/.test(raw))
-                    errors.push({
-                        line: i + 1,
-                        column: 1,
-                        message: "block attributes need {#id} syntax",
-                    });
-                else {
-                    const attrs = parseExtensionAttributes(raw.slice(1, -1));
-                    id = attrs.id;
-                    for (const message of attrs.problems)
-                        errors.push({ line: i + 1, column: 1, message });
-                    if (attrs.classes.length || Object.keys(attrs.values).length)
-                        errors.push({
-                            line: i + 1,
-                            column: 1,
-                            message: "info and warn accept only an id",
-                        });
-                }
-            }
-            opening = { start: i, kind: open[1], id };
-            continue;
-        }
-        if (CLOSE.test(line) && opening) {
-            const body = lines
-                .slice(opening.start + 1, i)
-                .join("\n")
-                .trim();
-            if (!body)
-                errors.push({
-                    line: opening.start + 1,
-                    column: 1,
-                    message: `${opening.kind} block is empty`,
-                });
-            blocks.push({ ...opening, end: i, body });
-            opening = null;
-        }
-    }
-    if (opening)
-        errors.push({
-            line: opening.start + 1,
-            column: 1,
-            message: `${opening.kind} block needs a closing ::: line`,
-        });
-    return { blocks, errors };
-}
-
-/** Render info and warning blocks as styled, labelled HTML. */
-export function renderAdmonitions(source, renderMarkdown = parser.render.bind(parser)) {
-    const { blocks, errors } = scanAdmonitions(source);
-    if (errors.length) return { markdown: source, errors };
-    const lines = String(source ?? "").split("\n");
-    const output = [];
-    let cursor = 0;
-    for (const block of blocks) {
-        const style = STYLES[block.kind];
-        output.push(...lines.slice(cursor, block.start));
-        output.push(
-            `<aside${block.id ? ` id="${block.id}"` : ""} class="sohl-admonition sohl-admonition-${block.kind}" style="border-left: 3px solid ${style.color}; background: ${style.background}; padding: 0.5em 0.8em; margin: 0.75em 0;">`,
-            `<p><strong><span aria-hidden="true">${style.icon}</span> ${style.label}</strong></p>`,
-            renderMarkdown(block.body).trim(),
-            "</aside>",
-        );
-        cursor = block.end + 1;
-    }
-    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-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;
-    }>;
-};