@project-ava-supernova/core 0.2.71

package/dist/tools/authoring/render-pdf.js

@@ -0,0 +1,298 @@
+/**
+ * DocModel → .pdf.
+ *
+ * Walks the rich model with pdfkit (procedural, top-to-bottom). pdfkit is
+ * passed in via `loadPdf` (optional-peer pattern). PDF has no native footnotes
+ * or auto-TOC, so footnotes become an endnotes section and the TOC is a simple
+ * contents list (no page numbers in v1). Reuses the brand tokens + the existing
+ * `pdfTable` builder from document-styling.ts.
+ */
+import { readFile } from 'node:fs/promises';
+import { isAbsolute, resolve } from 'node:path';
+import { inlineToPlainText } from './doc-model.js';
+import { AVA_TITLE_SIZE_PDF, AVA_H1_SIZE_PDF, AVA_H2_SIZE_PDF, AVA_H3_SIZE_PDF, AVA_H4_SIZE_PDF, AVA_BODY_SIZE_PDF, AVA_SUBTITLE_SIZE_PDF, AVA_LINK_COLOR, CALLOUT_COLORS, resolveBrand, getStyleProfile, pdfTable, } from '../document-styling.js';
+const H_SIZE_PDF = [0, AVA_H1_SIZE_PDF, AVA_H2_SIZE_PDF, AVA_H3_SIZE_PDF, AVA_H4_SIZE_PDF];
+export async function renderPdf(model, opts) {
+    const pdfkit = await opts.loadPdf();
+    const PDFDocument = pdfkit.default || pdfkit;
+    const brand = resolveBrand(model.meta.brand);
+    const profile = getStyleProfile(model.meta.styleProfile);
+    const margins = {
+        top: profile.margins.top / 20, right: profile.margins.right / 20,
+        bottom: profile.margins.bottom / 20, left: profile.margins.left / 20,
+    };
+    const footnoteNumbers = new Map();
+    if (model.meta.footnotes) {
+        let n = 1;
+        for (const id of Object.keys(model.meta.footnotes))
+            footnoteNumbers.set(id, n++);
+    }
+    // Pre-load images (async) so the procedural walk stays synchronous.
+    const images = await loadImages(model.blocks, opts.baseDir);
+    return new Promise((resolvePromise) => {
+        const doc = new PDFDocument({ margins, size: 'A4', bufferPages: true });
+        const chunks = [];
+        doc.on('data', (c) => chunks.push(c));
+        doc.on('end', () => resolvePromise(Buffer.concat(chunks)));
+        const ctx = { doc, brand, footnoteNumbers, baseDir: opts.baseDir };
+        // Title / subtitle / meta.
+        if (model.meta.title) {
+            doc.font('Helvetica-Bold').fontSize(AVA_TITLE_SIZE_PDF).fillColor(`#${brand.headingColor}`).text(model.meta.title, { align: 'center' });
+            doc.moveDown(0.4);
+        }
+        if (model.meta.subtitle) {
+            doc.font('Helvetica-Oblique').fontSize(AVA_SUBTITLE_SIZE_PDF).fillColor(`#${brand.subtitleColor}`).text(model.meta.subtitle, { align: 'center' });
+            doc.moveDown(0.3);
+        }
+        const metaLine = [model.meta.author, model.meta.date].filter(Boolean).join('  ·  ');
+        if (metaLine && profile.metadataBlock) {
+            doc.font('Helvetica').fontSize(AVA_SUBTITLE_SIZE_PDF).fillColor(`#${brand.subtitleColor}`).text(metaLine, { align: 'center' });
+            doc.moveDown(0.8);
+        }
+        if (model.meta.toc)
+            renderToc(ctx, model.blocks);
+        for (const block of model.blocks)
+            renderBlock(block, ctx, images, 0);
+        renderFootnotes(ctx, model.meta.footnotes);
+        doc.end();
+    });
+}
+// ── Block rendering ──────────────────────────────────────────────────────────
+function renderBlock(block, ctx, images, indent) {
+    const { doc, brand } = ctx;
+    switch (block.type) {
+        case 'heading':
+            doc.moveDown(0.3);
+            pdfInline(ctx, block.inlines, { size: H_SIZE_PDF[block.level], color: brand.headingColor, bold: true, indent });
+            doc.moveDown(0.2);
+            break;
+        case 'paragraph':
+            pdfInline(ctx, block.inlines, { indent });
+            doc.moveDown(0.4);
+            break;
+        case 'list':
+            renderList(block.items, block.ordered, ctx, images, indent);
+            break;
+        case 'table':
+            doc.moveDown(0.2);
+            pdfTable(doc, {
+                headers: block.headers.map(h => inlineToPlainText(h)),
+                rows: block.rows.map(r => r.map(c => inlineToPlainText(c))),
+            });
+            doc.moveDown(0.4);
+            break;
+        case 'blockquote': {
+            const x0 = doc.page.margins.left + indent;
+            const yStart = doc.y;
+            for (const b of block.blocks)
+                renderBlock(b, ctx, images, indent + 18);
+            doc.save().strokeColor('#D0D0D0').lineWidth(2).moveTo(x0 + 4, yStart).lineTo(x0 + 4, doc.y - 4).stroke().restore();
+            break;
+        }
+        case 'callout':
+            renderCallout(block, ctx, images, indent);
+            break;
+        case 'image':
+            renderImage(block, ctx, images);
+            break;
+        case 'code':
+            doc.moveDown(0.2);
+            doc.font('Courier').fontSize(AVA_BODY_SIZE_PDF - 1).fillColor('#24292F')
+                .text(block.text, doc.page.margins.left + indent + 8, doc.y, { width: usableWidth(doc) - indent - 16 });
+            doc.moveDown(0.5);
+            break;
+        case 'pagebreak':
+            doc.addPage();
+            break;
+        case 'hr': {
+            doc.moveDown(0.3);
+            const y = doc.y;
+            doc.save().strokeColor('#D0D0D0').lineWidth(0.5).moveTo(doc.page.margins.left, y).lineTo(doc.page.width - doc.page.margins.right, y).stroke().restore();
+            doc.moveDown(0.5);
+            break;
+        }
+        case 'toc':
+            // Inline [[toc]] markers are handled by the front-matter flag; ignore here.
+            break;
+    }
+}
+function renderList(items, ordered, ctx, images, indent) {
+    const { doc } = ctx;
+    items.forEach((item, i) => {
+        const marker = ordered ? `${i + 1}.` : '•';
+        const x = doc.page.margins.left + indent + 16;
+        doc.font('Helvetica').fontSize(AVA_BODY_SIZE_PDF).fillColor('#666666').text(marker, x - 14, doc.y, { continued: false, width: 14 });
+        // Move cursor back up to render the item text beside the marker.
+        pdfInline(ctx, item.inlines, { indent: indent + 16 });
+        doc.moveDown(0.2);
+        if (item.children?.length) {
+            for (const child of item.children) {
+                if (child.type === 'list')
+                    renderList(child.items, child.ordered, ctx, images, indent + 18);
+                else
+                    renderBlock(child, ctx, images, indent + 18);
+            }
+        }
+    });
+    doc.moveDown(0.2);
+}
+function renderCallout(block, ctx, images, indent) {
+    const { doc } = ctx;
+    const pal = CALLOUT_COLORS[block.variant] ?? CALLOUT_COLORS.note;
+    const x0 = doc.page.margins.left + indent;
+    doc.moveDown(0.2);
+    const yStart = doc.y;
+    const label = block.title ?? pal.label;
+    if (label) {
+        doc.font('Helvetica-Bold').fontSize(AVA_BODY_SIZE_PDF).fillColor(`#${pal.bar}`).text(label, x0 + 12, doc.y);
+        doc.moveDown(0.1);
+    }
+    for (const b of block.blocks)
+        renderBlock(b, ctx, images, indent + 12);
+    // Accent bar down the left edge of the callout.
+    doc.save().strokeColor(`#${pal.bar}`).lineWidth(3).moveTo(x0 + 1.5, yStart).lineTo(x0 + 1.5, doc.y - 4).stroke().restore();
+    doc.moveDown(0.3);
+}
+function renderImage(block, ctx, images) {
+    const { doc } = ctx;
+    const data = images.get(block.src);
+    doc.moveDown(0.2);
+    if (data) {
+        const w = Math.min(block.width ?? 360, usableWidth(doc));
+        try {
+            doc.image(data, { width: w });
+        }
+        catch { /* skip bad image */ }
+    }
+    else {
+        doc.font('Helvetica-Oblique').fontSize(AVA_SUBTITLE_SIZE_PDF).fillColor('#999999').text(`[image: ${block.alt || block.src}]`);
+    }
+    doc.moveDown(0.4);
+}
+function renderToc(ctx, blocks) {
+    const { doc, brand } = ctx;
+    doc.font('Helvetica-Bold').fontSize(AVA_H1_SIZE_PDF).fillColor(`#${brand.headingColor}`).text('Contents');
+    doc.moveDown(0.3);
+    for (const b of blocks) {
+        if (b.type === 'heading') {
+            doc.font('Helvetica').fontSize(AVA_BODY_SIZE_PDF).fillColor(`#${brand.bodyColor}`)
+                .text(inlineToPlainText(b.inlines), { indent: (b.level - 1) * 14 });
+        }
+    }
+    doc.addPage();
+}
+function renderFootnotes(ctx, footnotes) {
+    const { doc, brand } = ctx;
+    if (!footnotes || !ctx.footnoteNumbers.size)
+        return;
+    doc.moveDown(0.5);
+    const y = doc.y;
+    doc.save().strokeColor('#D0D0D0').lineWidth(0.5).moveTo(doc.page.margins.left, y).lineTo(doc.page.margins.left + 160, y).stroke().restore();
+    doc.moveDown(0.3);
+    doc.font('Helvetica-Bold').fontSize(AVA_SUBTITLE_SIZE_PDF).fillColor(`#${brand.subtitleColor}`).text('Notes');
+    doc.moveDown(0.2);
+    for (const [id, inl] of Object.entries(footnotes)) {
+        const num = ctx.footnoteNumbers.get(id);
+        doc.font('Helvetica').fontSize(AVA_SUBTITLE_SIZE_PDF).fillColor(`#${brand.bodyColor}`).text(`${num}. ${inlineToPlainText(inl)}`);
+    }
+}
+function pdfInline(ctx, inlines, opts) {
+    const { doc } = ctx;
+    const segs = flattenInline(inlines, ctx);
+    if (!segs.length) {
+        doc.text('');
+        return;
+    }
+    const size = opts?.size ?? AVA_BODY_SIZE_PDF;
+    const baseColor = opts?.color ?? ctx.brand.bodyColor;
+    segs.forEach((s, i) => {
+        const last = i === segs.length - 1;
+        doc.font(s.code ? 'Courier' : pdfFont(!!opts?.bold || !!s.bold, !!s.italic))
+            .fontSize(s.foot ? size - 3 : size)
+            .fillColor(s.link ? `#${AVA_LINK_COLOR}` : `#${baseColor}`);
+        const o = { continued: !last };
+        if (opts?.indent != null && i === 0)
+            o.indent = opts.indent;
+        if (opts?.align && i === 0)
+            o.align = opts.align;
+        if (s.link) {
+            o.link = s.link;
+            o.underline = true;
+        }
+        else {
+            o.link = null;
+            o.underline = false;
+        }
+        doc.text(s.text, o);
+    });
+}
+function flattenInline(nodes, ctx, bold = false, italic = false, link, out = []) {
+    for (const n of nodes) {
+        switch (n.type) {
+            case 'text':
+                out.push({ text: n.text, bold, italic, link });
+                break;
+            case 'strong':
+                flattenInline(n.inlines, ctx, true, italic, link, out);
+                break;
+            case 'em':
+                flattenInline(n.inlines, ctx, bold, true, link, out);
+                break;
+            case 'code':
+                out.push({ text: n.text, code: true, bold, italic });
+                break;
+            case 'link':
+                flattenInline(n.inlines, ctx, bold, italic, n.href, out);
+                break;
+            case 'footnoteRef': {
+                const num = ctx.footnoteNumbers.get(n.id);
+                if (num != null)
+                    out.push({ text: `[${num}]`, foot: true, bold, italic });
+                break;
+            }
+            case 'break':
+                out.push({ text: '\n', bold, italic });
+                break;
+        }
+    }
+    return out;
+}
+// ── Helpers ──────────────────────────────────────────────────────────────────
+function pdfFont(bold, italic) {
+    if (bold && italic)
+        return 'Helvetica-BoldOblique';
+    if (bold)
+        return 'Helvetica-Bold';
+    if (italic)
+        return 'Helvetica-Oblique';
+    return 'Helvetica';
+}
+function usableWidth(doc) {
+    return doc.page.width - doc.page.margins.left - doc.page.margins.right;
+}
+async function loadImages(blocks, baseDir) {
+    const map = new Map();
+    const srcs = new Set();
+    const gather = (bs) => {
+        for (const b of bs) {
+            if (b.type === 'image')
+                srcs.add(b.src);
+            if (b.type === 'blockquote' || b.type === 'callout')
+                gather(b.blocks);
+            if (b.type === 'list')
+                for (const it of b.items)
+                    if (it.children)
+                        gather(it.children);
+        }
+    };
+    gather(blocks);
+    for (const src of srcs) {
+        try {
+            const path = isAbsolute(src) ? src : resolve(baseDir ?? process.cwd(), src);
+            map.set(src, await readFile(path));
+        }
+        catch { /* leave missing; renderImage shows a placeholder */ }
+    }
+    return map;
+}
+//# sourceMappingURL=render-pdf.js.map

package/dist/tools/authoring/render-pdf.js.map

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

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

@@ -0,0 +1,35 @@
+/**
+ * Markdown section addressing — locate, slice, and target sections by heading
+ * for surgical, non-destructive edits.
+ *
+ * A "section" runs from an ATX heading (`## Pricing`) to the next heading of the
+ * same-or-higher level (so editing an H2 includes its H3 subsections), or to end
+ * of file. These are pure string helpers: the document_author tool uses them to
+ * compute the exact old/new text for a `file_edit`, so editing a section never
+ * touches the rest of the document. Fenced code blocks are skipped so a `#`
+ * inside a code sample isn't mistaken for a heading.
+ */
+export interface Section {
+    level: number;
+    title: string;
+    /** 0-based index of the heading line. */
+    headingLine: number;
+    /** 0-based start (== headingLine). */
+    startLine: number;
+    /** 0-based exclusive end (next same-or-higher heading, or line count). */
+    endLine: number;
+}
+export declare function listSections(md: string): Section[];
+/** Resolve a section by heading text. Exact (case-insensitive) match wins; falls
+ *  back to a unique substring match. Returns `{ ambiguous: true }` when more than
+ *  one section matches, `null` when none do. */
+export declare function findSection(md: string, name: string): Section | {
+    ambiguous: true;
+} | null;
+/** The full text of a section, heading line included. */
+export declare function sectionText(md: string, s: Section): string;
+/** The heading line text exactly as it appears (e.g. `## Pricing`). */
+export declare function headingLineText(md: string, s: Section): string;
+/** A human-readable outline: indented heading list with 1-based positions. */
+export declare function formatOutline(md: string): string;
+//# sourceMappingURL=sections.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sections.d.ts","sourceRoot":"","sources":["../../../src/tools/authoring/sections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CACjB;AAKD,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,EAAE,CA0BlD;AAED;;gDAEgD;AAChD,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG;IAAE,SAAS,EAAE,IAAI,CAAA;CAAE,GAAG,IAAI,CAY1F;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,CAE1D;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,GAAG,MAAM,CAE9D;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAMhD"}

package/dist/tools/authoring/sections.js

@@ -0,0 +1,81 @@
+/**
+ * Markdown section addressing — locate, slice, and target sections by heading
+ * for surgical, non-destructive edits.
+ *
+ * A "section" runs from an ATX heading (`## Pricing`) to the next heading of the
+ * same-or-higher level (so editing an H2 includes its H3 subsections), or to end
+ * of file. These are pure string helpers: the document_author tool uses them to
+ * compute the exact old/new text for a `file_edit`, so editing a section never
+ * touches the rest of the document. Fenced code blocks are skipped so a `#`
+ * inside a code sample isn't mistaken for a heading.
+ */
+const HEADING_RE = /^(#{1,6})[ \t]+(.+?)[ \t]*#*$/;
+const FENCE_RE = /^(```|~~~)/;
+export function listSections(md) {
+    const lines = md.split(/\r?\n/);
+    const heads = [];
+    let fence = null;
+    for (let i = 0; i < lines.length; i++) {
+        const trimmed = lines[i].trim();
+        const fm = FENCE_RE.exec(trimmed);
+        if (fm) {
+            const marker = fm[1][0];
+            if (!fence)
+                fence = marker;
+            else if (trimmed.startsWith(fence))
+                fence = null;
+            continue;
+        }
+        if (fence)
+            continue;
+        const hm = HEADING_RE.exec(lines[i]);
+        if (hm)
+            heads.push({ level: hm[1].length, title: hm[2].trim(), line: i });
+    }
+    return heads.map((h, idx) => {
+        let end = lines.length;
+        for (let j = idx + 1; j < heads.length; j++) {
+            if (heads[j].level <= h.level) {
+                end = heads[j].line;
+                break;
+            }
+        }
+        return { level: h.level, title: h.title, headingLine: h.line, startLine: h.line, endLine: end };
+    });
+}
+/** Resolve a section by heading text. Exact (case-insensitive) match wins; falls
+ *  back to a unique substring match. Returns `{ ambiguous: true }` when more than
+ *  one section matches, `null` when none do. */
+export function findSection(md, name) {
+    const target = name.trim().toLowerCase();
+    const all = listSections(md);
+    const exact = all.filter(s => s.title.toLowerCase() === target);
+    if (exact.length === 1)
+        return exact[0];
+    if (exact.length > 1)
+        return { ambiguous: true };
+    const loose = all.filter(s => s.title.toLowerCase().includes(target));
+    if (loose.length === 1)
+        return loose[0];
+    if (loose.length > 1)
+        return { ambiguous: true };
+    return null;
+}
+/** The full text of a section, heading line included. */
+export function sectionText(md, s) {
+    return md.split(/\r?\n/).slice(s.startLine, s.endLine).join('\n');
+}
+/** The heading line text exactly as it appears (e.g. `## Pricing`). */
+export function headingLineText(md, s) {
+    return md.split(/\r?\n/)[s.headingLine] ?? '';
+}
+/** A human-readable outline: indented heading list with 1-based positions. */
+export function formatOutline(md) {
+    const sections = listSections(md);
+    if (sections.length === 0)
+        return '(no headings)';
+    return sections
+        .map(s => `${'  '.repeat(s.level - 1)}${'#'.repeat(s.level)} ${s.title}`)
+        .join('\n');
+}
+//# sourceMappingURL=sections.js.map

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

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

package/dist/tools/authoring/templates/builtins.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Built-in worked-exemplar templates.
+ *
+ * Each `body` is a complete, well-written document of its kind — real prose at
+ * the right length and tone, with `{{tokens}}` only where something must change.
+ * They double as a quality bar for Ava and as a teaching example for the writer.
+ * Stored as TS constants so they ship on every surface with no asset-copy step.
+ */
+import type { DocTemplate } from './template-model.js';
+export declare const BUILTIN_TEMPLATES: DocTemplate[];
+//# sourceMappingURL=builtins.d.ts.map

package/dist/tools/authoring/templates/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../../../src/tools/authoring/templates/builtins.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AA2dvD,eAAO,MAAM,iBAAiB,EAAE,WAAW,EAK1C,CAAC"}