@ferax564/noma-cli 0.11.0

package/dist/renderer-site.d.ts

@@ -0,0 +1,11 @@
+import type { Node } from "./ast.js";
+import type { LoadedChapter } from "./book.js";
+export interface SiteRenderOptions {
+    themeCss?: string;
+    title?: string;
+    allowEscapeHatches?: boolean;
+    math?: "katex" | "none";
+    externalAssets?: boolean;
+}
+export declare function renderSite(manifest: Record<string, unknown>, chapters: LoadedChapter[], outDir: string, options?: SiteRenderOptions): void;
+export type { LoadedChapter, Node };

package/dist/renderer-site.js

@@ -0,0 +1,175 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { walk } from "./ast.js";
+import { escapeAttr, escapeHtml, inlineToHtml } from "./inline.js";
+import { renderHtml } from "./renderer-html.js";
+export function renderSite(manifest, chapters, outDir, options = {}) {
+    const absOut = resolve(outDir);
+    mkdirSync(absOut, { recursive: true });
+    const themeCss = options.themeCss ?? "";
+    const hasTheme = themeCss.length > 0;
+    if (hasTheme) {
+        const assetsDir = join(absOut, "_assets");
+        mkdirSync(assetsDir, { recursive: true });
+        writeFileSync(join(assetsDir, "theme.css"), themeCss, "utf8");
+    }
+    const idMap = buildIdMap(chapters);
+    const bookTitle = options.title ||
+        (typeof manifest.title === "string" ? manifest.title : undefined) ||
+        "Noma Book";
+    for (const ch of chapters) {
+        const prefix = pagePrefix(ch.slug);
+        const html = renderHtml(ch.doc, {
+            standalone: true,
+            ...(hasTheme ? { stylesheetHref: `${prefix}${THEME_HREF}` } : { themeCss: "" }),
+            title: chapterTitle(ch) || bookTitle,
+            allowEscapeHatches: options.allowEscapeHatches !== false,
+            externalAssets: options.externalAssets !== false,
+            ...(options.math ? { math: options.math } : {}),
+        });
+        const rewritten = rewriteWikilinks(html, ch.slug, idMap, prefix);
+        const withNav = injectNav(rewritten, chapters, ch.slug, bookTitle, prefix);
+        const target = join(absOut, `${ch.slug}.html`);
+        mkdirSync(dirname(target), { recursive: true });
+        writeFileSync(target, withNav, "utf8");
+    }
+    const indexHtml = renderIndex(bookTitle, manifest, chapters, hasTheme, idMap);
+    writeFileSync(join(absOut, "index.html"), indexHtml, "utf8");
+}
+function pagePrefix(slug) {
+    if (!slug)
+        return "";
+    const depth = (slug.match(/\//g) ?? []).length;
+    return "../".repeat(depth);
+}
+function chapterTitle(ch) {
+    const root = ch.doc.children.find((n) => n.type === "section" && n.level === 1);
+    return root?.title;
+}
+function buildIdMap(chapters) {
+    const map = new Map();
+    for (const ch of chapters) {
+        for (const node of walk(ch.doc)) {
+            if (node.id) {
+                map.set(node.id, { chapterSlug: ch.slug, anchor: node.id });
+            }
+            if (node.aliases) {
+                for (const a of node.aliases) {
+                    if (!map.has(a))
+                        map.set(a, { chapterSlug: ch.slug, anchor: a });
+                }
+            }
+        }
+    }
+    return map;
+}
+const THEME_HREF = "_assets/theme.css";
+const WIKILINK_HREF_RE = /<a\s+class="noma-ref"\s+href="#([^"]+)">([^<]+)<\/a>/g;
+function rewriteWikilinks(html, currentSlug, idMap, prefix) {
+    return html.replace(WIKILINK_HREF_RE, (match, id, label) => {
+        const loc = idMap.get(id);
+        if (!loc || loc.chapterSlug === currentSlug)
+            return match;
+        return `<a class="noma-ref noma-xchapter" href="${escapeAttr(prefix + loc.chapterSlug)}.html#${escapeAttr(loc.anchor)}">${label}</a>`;
+    });
+}
+function injectNav(html, chapters, currentSlug, bookTitle, prefix) {
+    const nav = buildNav(chapters, currentSlug, bookTitle, prefix);
+    return html.replace(/<main class="noma-doc">/, `${nav}\n<main class="noma-doc">`);
+}
+function buildNav(chapters, currentSlug, bookTitle, prefix) {
+    const items = chapters
+        .map((c) => {
+        const isCurrent = c.slug === currentSlug;
+        const label = chapterTitle(c) ?? c.slug;
+        return isCurrent
+            ? `<li class="noma-nav-current"><span>${escapeHtml(label)}</span></li>`
+            : `<li><a href="${escapeAttr(prefix + c.slug)}.html">${escapeHtml(label)}</a></li>`;
+    })
+        .join("");
+    const homeMarkup = currentSlug === null
+        ? `<span class="noma-site-home noma-nav-current">${escapeHtml(bookTitle)}</span>`
+        : `<a class="noma-site-home" href="${escapeAttr(prefix)}index.html">${escapeHtml(bookTitle)}</a>`;
+    return `<nav class="noma-site-nav" aria-label="Chapters">
+${homeMarkup}
+<ol>${items}</ol>
+</nav>`;
+}
+function renderIndex(bookTitle, manifest, chapters, hasTheme, idMap) {
+    const author = typeof manifest.author === "string" ? manifest.author : undefined;
+    const nav = buildNav(chapters, null, bookTitle, "");
+    const items = chapters
+        .map((c) => {
+        const label = chapterTitle(c) ?? c.slug;
+        const raw = chapterSummaryRaw(c.doc);
+        const descHtml = raw ? renderCardDescription(raw, idMap) : "";
+        return `<li>
+        <a class="noma-site-chapter" href="${escapeAttr(c.slug)}.html">
+          <span class="noma-site-chapter-title">${escapeHtml(label)}</span>
+          ${descHtml ? `<span class="noma-site-chapter-summary">${descHtml}</span>` : ""}
+        </a>
+      </li>`;
+    })
+        .join("\n");
+    const themeLink = hasTheme
+        ? `<link rel="stylesheet" href="${THEME_HREF}" />`
+        : "";
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<meta name="generator" content="noma" />
+<title>${escapeHtml(bookTitle)}</title>
+${themeLink}
+</head>
+<body>
+${nav}
+<main class="noma-doc noma-site-index">
+<header class="noma-site-header">
+  <h1>${escapeHtml(bookTitle)}</h1>
+  ${author ? `<p class="noma-site-author">${escapeHtml(author)}</p>` : ""}
+</header>
+<ol class="noma-site-toc">
+${items}
+</ol>
+</main>
+</body>
+</html>`;
+}
+function chapterSummaryRaw(doc) {
+    for (const node of walk(doc)) {
+        if (node.type === "directive" && (node.name === "summary" || node.name === "abstract")) {
+            const body = (node.body ?? "").trim();
+            if (body)
+                return body;
+        }
+        if (node.type === "paragraph") {
+            const body = node.content.trim();
+            if (body)
+                return body;
+        }
+    }
+    return undefined;
+}
+const SENTENCE_END_RE = /([.!?])(?=\s|$)/;
+function firstSentence(s) {
+    const collapsed = s.replace(/\s+/g, " ").trim();
+    const m = collapsed.match(SENTENCE_END_RE);
+    if (m && m.index !== undefined) {
+        return collapsed.slice(0, m.index + 1);
+    }
+    return collapsed.length > 200 ? collapsed.slice(0, 197) + "…" : collapsed;
+}
+const CARD_REF_RE = /<a class="noma-ref" href="#([^"]+)">([^<]+)<\/a>/g;
+function renderCardDescription(raw, idMap) {
+    const sentence = firstSentence(raw);
+    const html = inlineToHtml(sentence);
+    return html.replace(CARD_REF_RE, (_m, id, label) => {
+        const loc = idMap.get(id);
+        if (!loc)
+            return label;
+        return `<a class="noma-ref noma-xchapter" href="${escapeAttr(loc.chapterSlug)}.html#${escapeAttr(loc.anchor)}">${label}</a>`;
+    });
+}
+//# sourceMappingURL=renderer-site.js.map

package/dist/renderer-site.js.map

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

package/dist/validator.d.ts

@@ -0,0 +1,24 @@
+import type { Diagnostic, DocumentNode } from "./ast.js";
+export interface ValidateOptions {
+    /**
+     * Disable claim-without-evidence warnings entirely (default: enabled).
+     * Per-block opt-out: add the `noverify` flag attribute to the claim.
+     */
+    requireEvidenceForClaims?: boolean;
+    /**
+     * Reference time for `stale-citation` checks. Defaults to `new Date()`.
+     * Tests pass a fixed clock for determinism.
+     */
+    now?: Date;
+    /** Citations older than this many days are flagged stale. Default: 365. */
+    staleCitationDays?: number;
+    /**
+     * Rule codes to drop from the result. Diagnostics whose `code` matches an
+     * entry are filtered out and do not affect exit status. Mirrors the per-block
+     * `noverify` flag at file level. Used by `noma check --ignore-rule X`.
+     */
+    ignoreRules?: string[];
+}
+export declare const KNOWN_PROFILES: string[];
+export declare function validate(doc: DocumentNode, options?: ValidateOptions): Diagnostic[];
+export declare function formatDiagnostics(diagnostics: Diagnostic[], filename?: string): string;