@project-ava-supernova/core 0.2.71

package/dist/tools/authoring/frontmatter.js

@@ -0,0 +1,203 @@
+/**
+ * Front-matter + directive pre-pass for the authoring engine.
+ *
+ * Markdown can't express document metadata, callouts, page breaks, or
+ * footnotes, so we layer a deliberately small extended syntax on top (the
+ * pandoc/MyST playbook) and strip it here BEFORE `marked` sees the body:
+ *
+ *   ---                         YAML-lite front-matter (flat keys + one inline
+ *   title: Q3 Proposal            map for `brand`). No js-yaml dependency.
+ *   style: proposal
+ *   ---
+ *
+ *   :::callout{type=warning title="Heads up"}   fenced directive → a callout
+ *   Payment due in **30 days**.                  block (inner is real markdown)
+ *   :::
+ *
+ *   :::pagebreak                                 a hard page break
+ *
+ *   [^1]: A footnote definition.                 collected → DocMeta.footnotes
+ *
+ * Everything else is plain markdown handled by md-parse.ts. These helpers are
+ * pure string/structure transforms with no marked dependency, so they're
+ * trivially unit-testable.
+ */
+// ── Front-matter ─────────────────────────────────────────────────────────────
+/** Strip a leading `---\n…\n---` block and parse it into DocMeta. Returns the
+ *  remaining body untouched when there's no front-matter. */
+export function parseFrontMatter(raw) {
+    // The BOM in this pattern is deliberate: frontmatter files genuinely begin
+    // with one and the parser has to match it to find the opening ---.
+    // eslint-disable-next-line no-irregular-whitespace
+    const m = /^?---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*\r?\n?/.exec(raw);
+    if (!m)
+        return { meta: {}, body: stripBom(raw) };
+    return { meta: parseYamlLite(m[1]), body: raw.slice(m[0].length) };
+}
+function stripBom(s) {
+    return s.charCodeAt(0) === 0xfeff ? s.slice(1) : s;
+}
+function parseYamlLite(src) {
+    const meta = {};
+    for (const rawLine of src.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith('#'))
+            continue;
+        const idx = line.indexOf(':');
+        if (idx === -1)
+            continue;
+        const key = line.slice(0, idx).trim().toLowerCase();
+        const val = line.slice(idx + 1).trim();
+        switch (key) {
+            case 'title':
+                meta.title = unquote(val);
+                break;
+            case 'subtitle':
+                meta.subtitle = unquote(val);
+                break;
+            case 'author':
+                meta.author = unquote(val);
+                break;
+            case 'date':
+                meta.date = unquote(val);
+                break;
+            case 'style':
+            case 'styleprofile':
+                meta.styleProfile = unquote(val);
+                break;
+            case 'toc':
+                meta.toc = parseBool(val);
+                break;
+            case 'brand': {
+                const b = parseBrand(val);
+                if (b)
+                    meta.brand = b;
+                break;
+            }
+        }
+    }
+    return meta;
+}
+function unquote(v) {
+    if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) {
+        return v.slice(1, -1);
+    }
+    return v;
+}
+function parseBool(v) {
+    return /^(true|yes|on|1)$/i.test(v.trim());
+}
+function stripHash(v) {
+    return v.replace(/^#/, '').trim();
+}
+/** `brand: { headingColor: "0F766E", font: Georgia }` → BrandTokens. A bare
+ *  word (`brand: ava`) means "use the defaults" and yields nothing. */
+function parseBrand(val) {
+    if (!val.startsWith('{'))
+        return undefined;
+    const inner = val.replace(/^\{/, '').replace(/\}$/, '').trim();
+    if (!inner)
+        return undefined;
+    const out = {};
+    for (const pair of inner.split(',')) {
+        const i = pair.indexOf(':');
+        if (i === -1)
+            continue;
+        const k = pair.slice(0, i).trim().toLowerCase();
+        const v = unquote(pair.slice(i + 1).trim());
+        if (k === 'font')
+            out.font = v;
+        else if (k === 'headingcolor')
+            out.headingColor = stripHash(v);
+        else if (k === 'bodycolor')
+            out.bodyColor = stripHash(v);
+        else if (k === 'subtitlecolor')
+            out.subtitleColor = stripHash(v);
+    }
+    return Object.keys(out).length ? out : undefined;
+}
+// ── Footnote definitions ─────────────────────────────────────────────────────
+/** Pull `[^id]: text` definition lines out of the body into a map; references
+ *  `[^id]` are left in place for the inline parser. */
+export function extractFootnoteDefs(body) {
+    const defs = {};
+    const kept = [];
+    const re = /^\[\^([^\]]+)\]:[ \t]?(.*)$/;
+    for (const line of body.split(/\r?\n/)) {
+        const m = re.exec(line);
+        if (m)
+            defs[m[1]] = m[2];
+        else
+            kept.push(line);
+    }
+    return { body: kept.join('\n'), defs };
+}
+/** Split a body into directive segments and plain-markdown runs. Callout fences
+ *  (`:::callout{…}` or `:::warning` … `:::`) and `:::pagebreak` become their own
+ *  segments; everything between is markdown for the lexer. */
+export function splitDirectives(body) {
+    const lines = body.split(/\r?\n/);
+    const segments = [];
+    let buffer = [];
+    const flush = () => {
+        if (buffer.length) {
+            const text = buffer.join('\n');
+            if (text.trim())
+                segments.push({ kind: 'markdown', text });
+            buffer = [];
+        }
+    };
+    for (let i = 0; i < lines.length; i++) {
+        const open = /^:::+\s*([A-Za-z][\w-]*)\s*(.*)$/.exec(lines[i].trim());
+        if (open) {
+            const name = open[1].toLowerCase();
+            if (name === 'pagebreak') {
+                flush();
+                segments.push({ kind: 'pagebreak' });
+                continue;
+            }
+            if (name === 'callout' || isVariantWord(name)) {
+                flush();
+                const attrs = parseAttrs(open[2]);
+                const variant = name === 'callout'
+                    ? normalizeVariant(attrs.type)
+                    : normalizeVariant(name);
+                const inner = [];
+                i++;
+                while (i < lines.length && !/^:::+\s*$/.test(lines[i].trim())) {
+                    inner.push(lines[i]);
+                    i++;
+                }
+                segments.push({ kind: 'callout', variant, title: attrs.title, body: inner.join('\n') });
+                continue;
+            }
+        }
+        buffer.push(lines[i]);
+    }
+    flush();
+    return segments;
+}
+/** Parse `{type=warning title="Heads up"}` (or bare `type=warning`) into a map. */
+function parseAttrs(s) {
+    const out = {};
+    const inner = s.trim().replace(/^\{/, '').replace(/\}$/, '');
+    const re = /([A-Za-z][\w-]*)=("([^"]*)"|'([^']*)'|\S+)/g;
+    let m;
+    while ((m = re.exec(inner))) {
+        out[m[1].toLowerCase()] = m[3] ?? m[4] ?? m[2];
+    }
+    return out;
+}
+const VARIANTS = ['note', 'tip', 'warning', 'important', 'quote'];
+function isVariantWord(w) {
+    return VARIANTS.includes(w) || w === 'info' || w === 'caution' || w === 'danger';
+}
+function normalizeVariant(w) {
+    const v = (w ?? '').toLowerCase();
+    if (v === 'info')
+        return 'note';
+    if (v === 'caution' || v === 'danger')
+        return 'warning';
+    return VARIANTS.includes(v) ? v : 'note';
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/tools/authoring/frontmatter.js.map

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

package/dist/tools/authoring/image-size.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Minimal image dimension + type sniffer (PNG / JPEG / GIF / BMP).
+ *
+ * The docx `ImageRun` needs an explicit type and pixel transformation, and we
+ * want to preserve aspect ratio when only a target width is given — so we read
+ * the intrinsic size straight from the file header. No image library needed
+ * (pngjs is a core dep but this covers JPEG/GIF/BMP too, and avoids decoding the
+ * whole bitmap just to read two numbers).
+ */
+export type ImageType = 'png' | 'jpg' | 'gif' | 'bmp';
+export interface ImageSize {
+    width: number;
+    height: number;
+    type: ImageType;
+}
+export declare function getImageSize(buf: Buffer): ImageSize | null;
+//# sourceMappingURL=image-size.d.ts.map

package/dist/tools/authoring/image-size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-size.d.ts","sourceRoot":"","sources":["../../../src/tools/authoring/image-size.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;CACjB;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAoC1D"}

package/dist/tools/authoring/image-size.js

@@ -0,0 +1,47 @@
+/**
+ * Minimal image dimension + type sniffer (PNG / JPEG / GIF / BMP).
+ *
+ * The docx `ImageRun` needs an explicit type and pixel transformation, and we
+ * want to preserve aspect ratio when only a target width is given — so we read
+ * the intrinsic size straight from the file header. No image library needed
+ * (pngjs is a core dep but this covers JPEG/GIF/BMP too, and avoids decoding the
+ * whole bitmap just to read two numbers).
+ */
+export function getImageSize(buf) {
+    if (buf.length < 24)
+        return null;
+    // PNG: 89 50 4E 47 0D 0A 1A 0A, IHDR width/height as big-endian uint32.
+    if (buf[0] === 0x89 && buf[1] === 0x50 && buf[2] === 0x4e && buf[3] === 0x47) {
+        return { width: buf.readUInt32BE(16), height: buf.readUInt32BE(20), type: 'png' };
+    }
+    // GIF: "GIF8", width/height little-endian uint16.
+    if (buf[0] === 0x47 && buf[1] === 0x49 && buf[2] === 0x46 && buf[3] === 0x38) {
+        return { width: buf.readUInt16LE(6), height: buf.readUInt16LE(8), type: 'gif' };
+    }
+    // BMP: "BM", width/height little-endian int32 at 18/22.
+    if (buf[0] === 0x42 && buf[1] === 0x4d) {
+        return { width: buf.readInt32LE(18), height: Math.abs(buf.readInt32LE(22)), type: 'bmp' };
+    }
+    // JPEG: FF D8, scan for a Start-Of-Frame marker.
+    if (buf[0] === 0xff && buf[1] === 0xd8) {
+        let off = 2;
+        while (off + 9 < buf.length) {
+            if (buf[off] !== 0xff) {
+                off++;
+                continue;
+            }
+            const marker = buf[off + 1];
+            // SOF0..SOF15 carry the frame size, excluding DHT(C4)/JPG(C8)/DAC(CC).
+            if (marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc) {
+                return { height: buf.readUInt16BE(off + 5), width: buf.readUInt16BE(off + 7), type: 'jpg' };
+            }
+            // Skip this segment by its length field.
+            const len = buf.readUInt16BE(off + 2);
+            if (len < 2)
+                break;
+            off += 2 + len;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=image-size.js.map

package/dist/tools/authoring/image-size.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-size.js","sourceRoot":"","sources":["../../../src/tools/authoring/image-size.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,IAAI,GAAG,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,IAAI,CAAC;IAEjC,wEAAwE;IACxE,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7E,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACpF,CAAC;IAED,kDAAkD;IAClD,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7E,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAClF,CAAC;IAED,wDAAwD;IACxD,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACvC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC5F,CAAC;IAED,iDAAiD;IACjD,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACvC,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;YAC5B,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;gBAAC,GAAG,EAAE,CAAC;gBAAC,SAAS;YAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;YAC5B,uEAAuE;YACvE,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBAC9F,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YAC9F,CAAC;YACD,yCAAyC;YACzC,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;YACtC,IAAI,GAAG,GAAG,CAAC;gBAAE,MAAM;YACnB,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/tools/authoring/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Authoring engine — public surface.
+ *
+ * Markdown(-extended) is the canonical, editable source; this module parses it
+ * to a rich DocModel and renders that model to .docx / .pdf / normalized .md.
+ * The heavy renderers (docx/pdfkit) are optional peers, loaded via callbacks so
+ * the engine has no hard dependency on them — parsing always works, only the
+ * `build` step needs the peer for that format.
+ */
+import type { DocModel } from './doc-model.js';
+export type RenderTarget = 'docx' | 'pdf' | 'md';
+export interface RenderOptions {
+    /** Loads the `docx` peer (required for target 'docx'). */
+    loadDocx?: () => Promise<unknown>;
+    /** Loads the `pdfkit` peer (required for target 'pdf'). */
+    loadPdf?: () => Promise<unknown>;
+    /** Base directory for resolving relative image paths. */
+    baseDir?: string;
+}
+/**
+ * Render a parsed model to one of the supported targets. Returns a Buffer for
+ * docx/pdf and a string for md. Throws a clear, actionable error when the peer
+ * for the requested binary format isn't available.
+ */
+export declare function renderDocument(model: DocModel, target: RenderTarget, opts?: RenderOptions): Promise<Buffer | string>;
+/** Parse extended Markdown straight to a rendered target in one call. */
+export declare function renderMarkdownSource(source: string, target: RenderTarget, opts?: RenderOptions): Promise<Buffer | string>;
+export { parseMarkdown } from './md-parse.js';
+export { renderMarkdown } from './render-md.js';
+export { renderDocx } from './render-docx.js';
+export { renderPdf } from './render-pdf.js';
+export { legacyToDocModel } from './doc-model.js';
+export type { DocModel, DocMeta, Block, Inline, ListItem, Align, CalloutVariant, BrandTokens, } from './doc-model.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/authoring/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/authoring/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAM/C,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAa9H;AAED,yEAAyE;AACzE,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAEnI;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EACV,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,GAC/E,MAAM,gBAAgB,CAAC"}

package/dist/tools/authoring/index.js

@@ -0,0 +1,44 @@
+/**
+ * Authoring engine — public surface.
+ *
+ * Markdown(-extended) is the canonical, editable source; this module parses it
+ * to a rich DocModel and renders that model to .docx / .pdf / normalized .md.
+ * The heavy renderers (docx/pdfkit) are optional peers, loaded via callbacks so
+ * the engine has no hard dependency on them — parsing always works, only the
+ * `build` step needs the peer for that format.
+ */
+import { parseMarkdown } from './md-parse.js';
+import { renderMarkdown } from './render-md.js';
+import { renderDocx } from './render-docx.js';
+import { renderPdf } from './render-pdf.js';
+/**
+ * Render a parsed model to one of the supported targets. Returns a Buffer for
+ * docx/pdf and a string for md. Throws a clear, actionable error when the peer
+ * for the requested binary format isn't available.
+ */
+export async function renderDocument(model, target, opts = {}) {
+    switch (target) {
+        case 'md':
+            return renderMarkdown(model);
+        case 'docx':
+            if (!opts.loadDocx)
+                throw new Error('docx rendering requires the docx package. Install it with: npm install docx');
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return renderDocx(model, { loadDocx: opts.loadDocx, baseDir: opts.baseDir });
+        case 'pdf':
+            if (!opts.loadPdf)
+                throw new Error('pdf rendering requires the pdfkit package. Install it with: npm install pdfkit');
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            return renderPdf(model, { loadPdf: opts.loadPdf, baseDir: opts.baseDir });
+    }
+}
+/** Parse extended Markdown straight to a rendered target in one call. */
+export async function renderMarkdownSource(source, target, opts = {}) {
+    return renderDocument(parseMarkdown(source), target, opts);
+}
+export { parseMarkdown } from './md-parse.js';
+export { renderMarkdown } from './render-md.js';
+export { renderDocx } from './render-docx.js';
+export { renderPdf } from './render-pdf.js';
+export { legacyToDocModel } from './doc-model.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/authoring/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/authoring/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAa5C;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAAe,EAAE,MAAoB,EAAE,OAAsB,EAAE;IAClG,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,IAAI;YACP,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,MAAM;YACT,IAAI,CAAC,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;YACnH,8DAA8D;YAC9D,OAAO,UAAU,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAA8B,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACrG,KAAK,KAAK;YACR,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAC;YACrH,8DAA8D;YAC9D,OAAO,SAAS,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAA6B,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACpG,CAAC;AACH,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAAc,EAAE,MAAoB,EAAE,OAAsB,EAAE;IACvG,OAAO,cAAc,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/tools/authoring/md-parse.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Markdown(-extended) → DocModel.
+ *
+ * The single entry point is `parseMarkdown(raw)`. It runs the front-matter /
+ * directive / footnote pre-pass (frontmatter.ts), then maps a `marked` token
+ * stream onto the rich Block/Inline model (doc-model.ts). marked is a hard core
+ * dependency, so parsing always works on every surface; only the renderers need
+ * the optional docx/pdfkit peers.
+ *
+ * marked's tokens carry nested `tokens` arrays at every level (a heading's
+ * inline runs, a list item's children), which is exactly what the model needs —
+ * so the mapping is a structural walk, not a re-parse.
+ */
+import type { Inline, DocModel } from './doc-model.js';
+export declare function parseMarkdown(raw: string): DocModel;
+/** Parse a short markdown string to inlines (footnote definitions, etc.). */
+export declare function parseInlineString(src: string): Inline[];
+//# sourceMappingURL=md-parse.d.ts.map

package/dist/tools/authoring/md-parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"md-parse.d.ts","sourceRoot":"","sources":["../../../src/tools/authoring/md-parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAS,MAAM,EAAY,QAAQ,EAAyB,MAAM,gBAAgB,CAAC;AAK/F,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAoCnD;AA+ID,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAKvD"}

package/dist/tools/authoring/md-parse.js

@@ -0,0 +1,262 @@
+/**
+ * Markdown(-extended) → DocModel.
+ *
+ * The single entry point is `parseMarkdown(raw)`. It runs the front-matter /
+ * directive / footnote pre-pass (frontmatter.ts), then maps a `marked` token
+ * stream onto the rich Block/Inline model (doc-model.ts). marked is a hard core
+ * dependency, so parsing always works on every surface; only the renderers need
+ * the optional docx/pdfkit peers.
+ *
+ * marked's tokens carry nested `tokens` arrays at every level (a heading's
+ * inline runs, a list item's children), which is exactly what the model needs —
+ * so the mapping is a structural walk, not a re-parse.
+ */
+import { marked } from 'marked';
+import { parseFrontMatter, extractFootnoteDefs, splitDirectives } from './frontmatter.js';
+/* eslint-disable @typescript-eslint/no-explicit-any */
+export function parseMarkdown(raw) {
+    const { meta, body } = parseFrontMatter(raw);
+    const { body: noFootnotes, defs } = extractFootnoteDefs(body);
+    const blocks = [];
+    for (const seg of splitDirectives(noFootnotes)) {
+        if (seg.kind === 'pagebreak') {
+            blocks.push({ type: 'pagebreak' });
+        }
+        else if (seg.kind === 'callout') {
+            blocks.push({
+                type: 'callout',
+                variant: seg.variant ?? 'note',
+                title: seg.title,
+                blocks: parseBlocks(seg.body ?? ''),
+            });
+        }
+        else if (seg.text) {
+            blocks.push(...parseBlocks(seg.text));
+        }
+    }
+    // Footnote definitions: parse each definition string as inline markdown.
+    if (Object.keys(defs).length) {
+        meta.footnotes = {};
+        for (const [id, text] of Object.entries(defs)) {
+            meta.footnotes[id] = parseInlineString(text);
+        }
+    }
+    // Lift a leading H1 into the title when front-matter didn't set one, so a
+    // plain markdown doc still gets a proper cover/title.
+    if (!meta.title && blocks[0]?.type === 'heading' && blocks[0].level === 1) {
+        meta.title = inlinePlain(blocks[0].inlines);
+        blocks.shift();
+    }
+    return { meta, blocks };
+}
+// ── Block mapping ────────────────────────────────────────────────────────────
+function parseBlocks(src) {
+    const tokens = marked.lexer(src);
+    const out = [];
+    for (const t of tokens) {
+        const block = blockFromToken(t);
+        if (block)
+            out.push(...(Array.isArray(block) ? block : [block]));
+    }
+    return out;
+}
+function blockFromToken(t) {
+    switch (t.type) {
+        case 'heading':
+            return { type: 'heading', level: clampLevel(t.depth), inlines: inlinesFrom(t.tokens) };
+        case 'paragraph': {
+            // Standalone image → image block (with optional {width=N}).
+            const img = asStandaloneImage(t.tokens);
+            if (img)
+                return img;
+            // [[toc]] / [toc] marker → table of contents.
+            if (isTocMarker(t.text))
+                return { type: 'toc' };
+            return { type: 'paragraph', inlines: inlinesFrom(t.tokens) };
+        }
+        case 'list':
+            return {
+                type: 'list',
+                ordered: !!t.ordered,
+                items: (t.items ?? []).map(mapListItem),
+            };
+        case 'table':
+            return {
+                type: 'table',
+                headers: (t.header ?? []).map((c) => inlinesFrom(c.tokens)),
+                rows: (t.rows ?? []).map((row) => row.map((c) => inlinesFrom(c.tokens))),
+                align: (t.align ?? []).map((a) => a ?? 'left'),
+            };
+        case 'blockquote': {
+            const variant = leadingCalloutVariant(t.text);
+            const inner = parseBlocks(stripBlockquoteMarkers(t.raw ?? t.text ?? ''));
+            // A blockquote whose first line is `[!NOTE]`-style becomes a callout.
+            return variant
+                ? { type: 'callout', variant, blocks: inner }
+                : { type: 'blockquote', blocks: inner };
+        }
+        case 'code':
+            return { type: 'code', lang: t.lang || undefined, text: t.text ?? '' };
+        case 'hr':
+            return { type: 'hr' };
+        case 'space':
+        case 'html':
+            return null;
+        default:
+            // Fallback: render any unknown block as a paragraph of its raw text.
+            if (t.tokens)
+                return { type: 'paragraph', inlines: inlinesFrom(t.tokens) };
+            if (t.text)
+                return { type: 'paragraph', inlines: [{ type: 'text', text: t.text }] };
+            return null;
+    }
+}
+function mapListItem(item) {
+    const inlines = [];
+    const children = [];
+    for (const child of (item.tokens ?? [])) {
+        if (child.type === 'text') {
+            // The item's own text line — may carry nested inline tokens.
+            inlines.push(...(child.tokens ? inlinesFrom(child.tokens) : splitText(child.text ?? '')));
+        }
+        else {
+            const block = blockFromToken(child);
+            if (block)
+                children.push(...(Array.isArray(block) ? block : [block]));
+        }
+    }
+    return children.length ? { inlines, children } : { inlines };
+}
+// ── Inline mapping ───────────────────────────────────────────────────────────
+function inlinesFrom(tokens) {
+    const out = [];
+    for (const t of tokens ?? []) {
+        switch (t.type) {
+            case 'text':
+            case 'escape':
+                out.push(...(t.tokens ? inlinesFrom(t.tokens) : splitText(t.text ?? '')));
+                break;
+            case 'strong':
+                out.push({ type: 'strong', inlines: inlinesFrom(t.tokens) });
+                break;
+            case 'em':
+                out.push({ type: 'em', inlines: inlinesFrom(t.tokens) });
+                break;
+            case 'del':
+                // No strikethrough in the model — keep the inner content.
+                out.push(...inlinesFrom(t.tokens));
+                break;
+            case 'codespan':
+                out.push({ type: 'code', text: t.text ?? '' });
+                break;
+            case 'link':
+                out.push({ type: 'link', href: t.href ?? '', inlines: t.tokens ? inlinesFrom(t.tokens) : splitText(t.text ?? '') });
+                break;
+            case 'image':
+                // Inline image → fall back to its alt text (block images are hoisted).
+                if (t.text)
+                    out.push({ type: 'text', text: t.text });
+                break;
+            case 'br':
+                out.push({ type: 'break' });
+                break;
+            case 'html':
+                break;
+            default:
+                if (t.text)
+                    out.push({ type: 'text', text: t.text });
+        }
+    }
+    return out;
+}
+/** Split a raw text string on footnote references `[^id]`. */
+function splitText(text) {
+    if (!text.includes('[^'))
+        return text ? [{ type: 'text', text }] : [];
+    const out = [];
+    const re = /\[\^([^\]]+)\]/g;
+    let last = 0;
+    let m;
+    while ((m = re.exec(text))) {
+        if (m.index > last)
+            out.push({ type: 'text', text: text.slice(last, m.index) });
+        out.push({ type: 'footnoteRef', id: m[1] });
+        last = m.index + m[0].length;
+    }
+    if (last < text.length)
+        out.push({ type: 'text', text: text.slice(last) });
+    return out;
+}
+/** Parse a short markdown string to inlines (footnote definitions, etc.). */
+export function parseInlineString(src) {
+    const tokens = marked.lexer(src.trim());
+    const first = tokens[0];
+    if (first?.type === 'paragraph')
+        return inlinesFrom(first.tokens);
+    return splitText(src.trim());
+}
+// ── Small helpers ────────────────────────────────────────────────────────────
+function clampLevel(depth) {
+    if (depth <= 1)
+        return 1;
+    if (depth >= 4)
+        return 4;
+    return depth;
+}
+function asStandaloneImage(tokens) {
+    if (!tokens || tokens.length === 0)
+        return null;
+    const first = tokens[0];
+    if (first.type !== 'image')
+        return null;
+    // Any trailing tokens must be empty/whitespace or a {width=N} attribute.
+    let width;
+    for (const t of tokens.slice(1)) {
+        const text = (t.text ?? t.raw ?? '').trim();
+        if (!text)
+            continue;
+        const w = /^\{[^}]*\bwidth=(\d+)[^}]*\}$/.exec(text);
+        if (w) {
+            width = Number(w[1]);
+            continue;
+        }
+        return null; // real trailing content → not a standalone image
+    }
+    return { type: 'image', src: first.href ?? '', alt: first.text || undefined, width };
+}
+function isTocMarker(text) {
+    return /^\[\[?toc\]?\]$/i.test((text ?? '').trim());
+}
+function inlinePlain(inlines) {
+    return inlines.map(n => {
+        if (n.type === 'text' || n.type === 'code')
+            return n.text;
+        if (n.type === 'strong' || n.type === 'em' || n.type === 'link')
+            return inlinePlain(n.inlines);
+        return '';
+    }).join('');
+}
+/** GitHub-style `> [!WARNING]` alerts inside a blockquote → callout variant. */
+function leadingCalloutVariant(text) {
+    const m = /^\s*\[!(\w+)\]/.exec(text ?? '');
+    if (!m)
+        return null;
+    const v = m[1].toLowerCase();
+    if (v === 'note')
+        return 'note';
+    if (v === 'tip')
+        return 'tip';
+    if (v === 'warning' || v === 'caution')
+        return 'warning';
+    if (v === 'important')
+        return 'important';
+    return null;
+}
+function stripBlockquoteMarkers(raw) {
+    return raw
+        .split(/\r?\n/)
+        .map(l => l.replace(/^\s*>\s?/, ''))
+        .filter(l => !/^\s*\[!\w+\]\s*$/.test(l)) // drop the [!NOTE] marker line
+        .join('\n');
+}
+//# sourceMappingURL=md-parse.js.map