postext 1.53.0 → 1.54.0

package/dist/music/engine.js

@@ -0,0 +1,309 @@
+import { flattenVerovioSvg, itemsToSvg } from './flatten.js';
+import { measureTextWidth } from '../measure/canvas.js';
+import { buildFontString } from '../measure/font.js';
+let toolkit = null;
+let initPromise = null;
+const initListeners = new Set();
+let warnedWithoutEngine = false;
+export function isMusicReady() {
+    return toolkit !== null;
+}
+export function onMusicReady(fn) {
+    if (toolkit !== null) {
+        fn();
+        return () => { };
+    }
+    initListeners.add(fn);
+    return () => { initListeners.delete(fn); };
+}
+/**
+ * Load Verovio and start the score engraver. Await it before laying out a
+ * document with scores on the main thread (the layout worker calls it
+ * itself): until it resolves, every score is set as a grey placeholder box.
+ * Idempotent; a failed start can be retried.
+ */
+export async function initMusicEngine() {
+    if (toolkit !== null)
+        return;
+    if (initPromise)
+        return initPromise;
+    initPromise = (async () => {
+        try {
+            const [{ default: createVerovioModule }, { VerovioToolkit }] = await Promise.all([
+                import('verovio/wasm-hum'),
+                import('verovio/esm'),
+            ]);
+            const module = await createVerovioModule();
+            toolkit = new VerovioToolkit(module);
+        }
+        catch (err) {
+            initPromise = null;
+            const reason = err instanceof Error ? err.message : String(err);
+            throw new Error(`[postext] the music engine failed to start: ${reason}`, { cause: err });
+        }
+        for (const fn of initListeners)
+            fn();
+        initListeners.clear();
+    })();
+    return initPromise;
+}
+/** Called when the layout sets a score with no engine running. Warns once,
+ *  and only when nobody asked for the engine. */
+export function noteMusicWithoutEngine() {
+    if (toolkit !== null || initPromise !== null || warnedWithoutEngine)
+        return;
+    warnedWithoutEngine = true;
+    console.warn('[postext] This document contains music scores, but the music engine is not running, so every score is laid out as a grey placeholder box. '
+        + 'Call `await initMusicEngine()` before `buildDocument` (the layout worker does it for you).');
+}
+// ---------------------------------------------------------------------------
+// LRU cache
+// ---------------------------------------------------------------------------
+const MAX_CACHE = 512;
+const cache = new Map();
+function cacheKey(source, format, widthPx, o) {
+    return [
+        format, widthPx.toFixed(2), o.staffSizePx.toFixed(3), o.font, o.textFont ?? '', o.spacing,
+        o.barNumbers, o.systemSpacing, source,
+    ].join('|');
+}
+export function clearMusicCache() {
+    cache.clear();
+}
+// ---------------------------------------------------------------------------
+// Rendering
+// ---------------------------------------------------------------------------
+/** Verovio's staff height at scale 100, in px: 4 staff spaces of 18 px. */
+const STAFF_PX_AT_100 = 72;
+/** The value of the first ABC header line `field:` (`T:` title, `C:`
+ *  composer), read line by line. */
+function abcField(source, field) {
+    for (const line of source.split('\n')) {
+        if (line.startsWith(`${field}:`)) {
+            const value = line.slice(field.length + 1).trim();
+            if (value)
+                return value;
+        }
+    }
+    return undefined;
+}
+/** The text of the first element whose opening tag starts with one of
+ *  `openings` (`<work-title`, `<creator type="composer"`), found with plain
+ *  string scans. */
+function elementText(source, openings) {
+    const lower = source.toLowerCase();
+    for (const opening of openings) {
+        const at = lower.indexOf(opening);
+        if (at < 0)
+            continue;
+        const next = source[at + opening.length];
+        if (next !== '>' && next !== ' ' && next !== '\t' && next !== '\n')
+            continue;
+        const open = source.indexOf('>', at);
+        const close = open < 0 ? -1 : source.indexOf('<', open + 1);
+        if (close < 0)
+            continue;
+        const text = source.slice(open + 1, close).trim();
+        if (text)
+            return text;
+    }
+    return undefined;
+}
+function readMetadata(source, format) {
+    if (format === 'abc')
+        return { title: abcField(source, 'T'), composer: abcField(source, 'C') };
+    return {
+        title: elementText(source, ['<work-title', '<movement-title', '<title']),
+        composer: elementText(source, ['<creator type="composer"', '<persname role="composer"', '<composer']),
+    };
+}
+function verovioOptions(widthPx, o, leftMarginPx = 0) {
+    // Engrave at scale 100 on a page as wide as the measure at that scale; the
+    // slices are then scaled to the measure exactly (Verovio's scale is an
+    // integer percentage, too coarse for a staff size in px).
+    const toScale100 = STAFF_PX_AT_100 / o.staffSizePx;
+    return {
+        scale: 100,
+        pageWidth: Math.max(100, Math.round(widthPx * toScale100)),
+        // Room for a brace or bracket left of the staves (see `renderScore`).
+        pageMarginLeft: Math.round(leftMarginPx * toScale100),
+        // One system per page: each page is one breakable slice of the score.
+        pageHeight: 100,
+        adjustPageHeight: true,
+        breaks: 'auto',
+        header: 'none',
+        footer: 'none',
+        pageMarginTop: 0,
+        pageMarginBottom: 0,
+        pageMarginRight: 0,
+        spacingSystem: o.systemSpacing,
+        spacingLinear: 0.25 * o.spacing,
+        spacingNonLinear: 0.6,
+        mnumInterval: o.barNumbers === 'every' ? 1 : 0,
+        // Room between the words of a lyric line: at the engraver's default
+        // (1.2) the words of a narrow measure touch ("nigh,sha-").
+        lyricWordSpace: 2.5,
+        font: o.font,
+        svgViewBox: true,
+        svgRemoveXlink: true,
+        smuflTextFont: 'none',
+    };
+}
+const COORD_RUN_RE = /[MLCQST]([^A-Za-z]*)/g;
+/** The leftmost x a system paints at (its paths' points; text is never
+ *  left of the staves). */
+function itemsMinX(items) {
+    let min = Infinity;
+    for (const it of items) {
+        if (it.type !== 'path')
+            continue;
+        for (const m of it.d.matchAll(COORD_RUN_RE)) {
+            const nums = m[1].trim().split(/[\s,]+/).filter(Boolean).map(Number);
+            for (let k = 0; k < nums.length; k += 2)
+                if (nums[k] < min)
+                    min = nums[k];
+        }
+    }
+    return Number.isFinite(min) ? min : 0;
+}
+/** The face Verovio measures words in when it spaces the notes. */
+const ENGRAVER_TEXT_FONT = 'Times New Roman';
+/**
+ * A word of several runs (a chord symbol and its raised figure) as one item
+ * per run, each at its size and baseline, laid side by side by their widths
+ * in `textFont` (about half an em per character where nothing measures).
+ */
+function layOutRuns(items, textFont) {
+    if (!items.some((it) => it.type === 'text' && it.runs))
+        return items;
+    const widthOf = (text, size, bold, italic) => {
+        try {
+            const w = measureTextWidth(text, buildFontString(textFont, size, bold ? 'bold' : 'normal', italic ? 'italic' : 'normal'));
+            if (w > 0)
+                return w;
+        }
+        catch {
+            // No measuring context: the estimate below.
+        }
+        return text.length * size * 0.5;
+    };
+    const out = [];
+    for (const it of items) {
+        if (it.type !== 'text' || !it.runs) {
+            out.push(it);
+            continue;
+        }
+        const widths = it.runs.map((r) => r.dx + widthOf(r.text, r.sizePx, r.bold ?? it.bold, r.italic ?? it.italic));
+        const total = widths.reduce((a, b) => a + b, 0);
+        let x = it.anchor === 'middle' ? it.x - total / 2 : it.anchor === 'end' ? it.x - total : it.x;
+        it.runs.forEach((r, i) => {
+            x += r.dx;
+            out.push({ type: 'text', x, y: it.y + r.rise, text: r.text, sizePx: r.sizePx, bold: r.bold ?? it.bold, italic: r.italic ?? it.italic });
+            x += widths[i] - r.dx;
+        });
+    }
+    return out;
+}
+/**
+ * Words set in `textFont` at the room the engraver gave them: it spaces
+ * lyrics and directions by its own (Times) metrics, so a wider face would
+ * run one syllable into the next. A word wider in `textFont` than in Times
+ * is set that much smaller. Without a measuring context (a bare Node
+ * process) the words are left as they are.
+ */
+function fitWords(items, textFont) {
+    if (textFont === ENGRAVER_TEXT_FONT)
+        return items;
+    try {
+        return items.map((it) => {
+            if (it.type !== 'text')
+                return it;
+            const weight = it.bold ? 'bold' : 'normal';
+            const style = it.italic ? 'italic' : 'normal';
+            const planned = measureTextWidth(it.text, buildFontString(ENGRAVER_TEXT_FONT, 100, weight, style));
+            const actual = measureTextWidth(it.text, buildFontString(textFont, 100, weight, style));
+            if (!(planned > 0) || !(actual > planned * 1.01))
+                return it;
+            return { ...it, sizePx: it.sizePx * (planned / actual) };
+        });
+    }
+    catch {
+        return items;
+    }
+}
+const DEFAULT_TEXT_FONT = 'Times New Roman, serif';
+function toSystem(svg, o, widthPx) {
+    const flat = flattenVerovioSvg(svg, widthPx, o.barNumbers === 'none' ? { skipClasses: ['mNum'] } : undefined);
+    if (!flat)
+        return null;
+    const textFont = o.textFont || DEFAULT_TEXT_FONT;
+    const items = fitWords(layOutRuns(flat.items, textFont), textFont);
+    return {
+        widthPx,
+        heightPx: flat.heightPx,
+        items,
+        // Every backend paints the same words: HTML, PDF and EPUB from this SVG.
+        svg: itemsToSvg(items, widthPx, flat.heightPx, 'currentColor', textFont),
+        textFont,
+    };
+}
+/**
+ * Engrave a score at a measure `widthPx` wide. Returns one slice per system;
+ * an empty list (with `error`) when the source does not load or the engine
+ * is not running.
+ */
+export function renderScore(source, format, widthPx, options) {
+    const key = cacheKey(source, format, widthPx, options);
+    const hit = cache.get(key);
+    if (hit) {
+        cache.delete(key);
+        cache.set(key, hit);
+        return hit;
+    }
+    const meta = readMetadata(source, format);
+    if (toolkit === null) {
+        noteMusicWithoutEngine();
+        return { systems: [], error: 'music engine not running', ...meta };
+    }
+    const engrave = (leftMarginPx) => {
+        toolkit.setOptions(verovioOptions(widthPx, options, leftMarginPx));
+        if (!toolkit.loadData(source))
+            return null;
+        // Bar numbers need numbered measures: ABC and Humdrum import theirs
+        // without `@n`. Numbered in order, and read again as MEI.
+        if (options.barNumbers !== 'none') {
+            const mei = toolkit.getMEI();
+            if (/<measure\b(?![^>]*\bn=)/.test(mei)) {
+                let n = 0;
+                if (!toolkit.loadData(mei.replace(/<measure\b(?![^>]*\bn=)/g, () => `<measure n="${++n}"`)))
+                    return null;
+            }
+        }
+        const systems = [];
+        const pages = toolkit.getPageCount();
+        for (let p = 1; p <= pages; p++) {
+            const slice = toSystem(toolkit.renderToSVG(p), options, widthPx);
+            if (slice)
+                systems.push(slice);
+        }
+        return systems;
+    };
+    let systems = engrave(0);
+    // A brace or bracket joining staves stands left of them, past the
+    // measure's edge: engraved again with a left margin that takes it, the
+    // staves indented as far.
+    const overhang = systems ? -Math.min(0, ...systems.map((s) => itemsMinX(s.items))) : 0;
+    if (systems && overhang > 0.5)
+        systems = engrave(Math.ceil(overhang + 1));
+    const result = systems
+        ? { systems, ...meta }
+        : { systems: [], error: toolkit.getLog().trim() || `the ${format} source did not load`, ...meta };
+    cache.set(key, result);
+    if (cache.size > MAX_CACHE) {
+        const first = cache.keys().next().value;
+        if (first !== undefined)
+            cache.delete(first);
+    }
+    return result;
+}
+//# sourceMappingURL=engine.js.map

package/dist/music/engine.js.map

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

package/dist/music/flatten.d.ts

@@ -0,0 +1,21 @@
+import type { ScoreItem } from './types.js';
+/**
+ * Flatten a Verovio page SVG into items in px of a slice `widthPx` wide.
+ * Returns the items and the slice height, or null when the markup is not
+ * Verovio's.
+ */
+export declare function flattenVerovioSvg(svg: string, widthPx: number, 
+/** Groups left out by class (`mNum`: bar numbers). */
+options?: {
+    skipClasses?: readonly string[];
+}): {
+    items: ScoreItem[];
+    heightPx: number;
+} | null;
+/**
+ * Plain SVG for a flattened system: paths and text, `currentColor` ink, the
+ * text in `textFont`. HTML inlines it; the PDF backend draws it with its SVG
+ * vector subset.
+ */
+export declare function itemsToSvg(items: readonly ScoreItem[], widthPx: number, heightPx: number, color: string, textFont: string): string;
+//# sourceMappingURL=flatten.d.ts.map

package/dist/music/flatten.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.d.ts","sourceRoot":"","sources":["../../src/music/flatten.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAwI5C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM;AACf,sDAAsD;AACtD,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAC5C;IAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA8IjD;AAQD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYlI"}

package/dist/music/flatten.js

@@ -0,0 +1,302 @@
+// Flatten one Verovio system (SVG) into painted items: filled or stroked
+// paths with every transform baked in, and text runs, all in px of the
+// slice. Canvas paints the items; HTML and PDF take the plain SVG written
+// back from them (`itemsToSvg`), which needs no stylesheet, no `<use>` and
+// no nested viewport.
+//
+// Verovio's markup is well-formed and regular — glyphs in `<defs>` drawn by
+// `<use>`, staff lines as stroked paths, stems and bar lines as rects, beams
+// as polygons, dots as ellipses, words as `<text>`/`<tspan>` — so a small
+// tag scanner does.
+import { multiply, parseSvgTransform, scale as scaleMatrix, transformPath, } from '../math/pathTransform.js';
+const ATTR_RE = /([\w:-]+)\s*=\s*"([^"]*)"/g;
+function decode(s) {
+    return s
+        .replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"').replace(/&apos;/g, "'")
+        .replace(/&#x([0-9a-f]+);/gi, (_, h) => String.fromCodePoint(parseInt(h, 16)))
+        .replace(/&#(\d+);/g, (_, d) => String.fromCodePoint(Number(d)))
+        .replace(/&amp;/g, '&');
+}
+function parse(svg) {
+    const root = { name: '#root', attrs: {}, children: [], text: '' };
+    const stack = [root];
+    let i = 0;
+    while (i < svg.length) {
+        const lt = svg.indexOf('<', i);
+        const top = stack[stack.length - 1];
+        if (lt < 0)
+            break;
+        if (lt > i)
+            top.text += decode(svg.slice(i, lt));
+        if (svg.startsWith('<!--', lt)) {
+            const end = svg.indexOf('-->', lt);
+            i = end < 0 ? svg.length : end + 3;
+            continue;
+        }
+        const gt = svg.indexOf('>', lt);
+        if (gt < 0)
+            break;
+        const tag = svg.slice(lt + 1, gt);
+        i = gt + 1;
+        if (tag.startsWith('?') || tag.startsWith('!'))
+            continue;
+        if (tag.startsWith('/')) {
+            if (stack.length > 1)
+                stack.pop();
+            continue;
+        }
+        const selfClosing = tag.endsWith('/');
+        const body = selfClosing ? tag.slice(0, -1) : tag;
+        const sp = body.search(/\s/);
+        const name = (sp < 0 ? body : body.slice(0, sp)).replace(/^.*:/, '');
+        const attrs = {};
+        for (const m of body.matchAll(ATTR_RE))
+            attrs[m[1].replace(/^xlink:/, '')] = decode(m[2]);
+        const el = { name, attrs, children: [], text: '' };
+        top.children.push(el);
+        if (!selfClosing)
+            stack.push(el);
+    }
+    return root.children.find((c) => c.name === 'svg') ?? null;
+}
+function num(v, fallback = 0) {
+    if (v === undefined)
+        return fallback;
+    const n = parseFloat(v);
+    return Number.isFinite(n) ? n : fallback;
+}
+function rectPath(x, y, w, h) {
+    return `M${x} ${y}L${x + w} ${y}L${x + w} ${y + h}L${x} ${y + h}Z`;
+}
+/** An ellipse as four cubic Béziers (κ = 0.5523). */
+function ellipsePath(cx, cy, rx, ry) {
+    const k = 0.5522847498;
+    const ox = rx * k;
+    const oy = ry * k;
+    return `M${cx - rx} ${cy}`
+        + `C${cx - rx} ${cy - oy} ${cx - ox} ${cy - ry} ${cx} ${cy - ry}`
+        + `C${cx + ox} ${cy - ry} ${cx + rx} ${cy - oy} ${cx + rx} ${cy}`
+        + `C${cx + rx} ${cy + oy} ${cx + ox} ${cy + ry} ${cx} ${cy + ry}`
+        + `C${cx - ox} ${cy + ry} ${cx - rx} ${cy + oy} ${cx - rx} ${cy}Z`;
+}
+function pointsPath(points) {
+    const n = points.trim().split(/[\s,]+/).map(Number);
+    let d = '';
+    for (let k = 0; k + 1 < n.length; k += 2)
+        d += `${k === 0 ? 'M' : 'L'}${n[k]} ${n[k + 1]}`;
+    return d ? `${d}Z` : '';
+}
+/** Mean scale of a matrix: what a stroke width or font size is multiplied by. */
+function lengthScale(m) {
+    return Math.sqrt(Math.abs(m[0] * m[3] - m[1] * m[2]));
+}
+/** A path of straight segments only: a line, never a filled shape. */
+const LINE_ONLY_RE = /^[\sMLHVmlhv\d.,eE+-]*$/;
+const BOLD_CLASSES = new Set(['ending', 'fing', 'reh', 'tempo']);
+const ITALIC_CLASSES = new Set(['dir', 'dynam', 'mNum']);
+/** The words of a `<text>`, one run per `<tspan>` that holds any, with the
+ *  size, style and baseline shift each is set at: a figure raised or
+ *  lowered beside a chord symbol (V₇, the figures of a figured bass) is a
+ *  smaller run with a `dy` of its own. */
+function leafRuns(el, inherited, at) {
+    const size = el.attrs['font-size'] !== undefined ? num(el.attrs['font-size'], inherited) : inherited;
+    const dx = num(el.attrs.dx);
+    at.rise += num(el.attrs.dy);
+    const own = el.text.replace(/\s+/g, ' ');
+    const out = [];
+    if (own.trim())
+        out.push({ text: own.trim(), size, style: el.attrs['font-style'], weight: el.attrs['font-weight'], rise: at.rise, dx });
+    let first = out.length === 0;
+    for (const c of el.children) {
+        if (c.name !== 'tspan')
+            continue;
+        for (const r of leafRuns(c, size, at)) {
+            out.push({ ...r, style: r.style ?? el.attrs['font-style'], weight: r.weight ?? el.attrs['font-weight'], dx: r.dx + (first ? dx : 0) });
+            first = false;
+        }
+    }
+    return out;
+}
+/**
+ * Flatten a Verovio page SVG into items in px of a slice `widthPx` wide.
+ * Returns the items and the slice height, or null when the markup is not
+ * Verovio's.
+ */
+export function flattenVerovioSvg(svg, widthPx, 
+/** Groups left out by class (`mNum`: bar numbers). */
+options) {
+    const skip = new Set(options?.skipClasses ?? []);
+    const root = parse(svg);
+    if (!root)
+        return null;
+    const inner = root.children.find((c) => c.name === 'svg') ?? root;
+    const vb = (inner.attrs.viewBox ?? '').trim().split(/[\s,]+/).map(Number);
+    if (vb.length !== 4 || !(vb[2] > 0) || !(vb[3] > 0))
+        return null;
+    const s = widthPx / vb[2];
+    const base = multiply(scaleMatrix(s, s), [1, 0, 0, 1, -vb[0], -vb[1]]);
+    const heightPx = vb[3] * s;
+    const defs = new Map();
+    const collectDefs = (el) => {
+        for (const c of el.children) {
+            if (c.name === 'defs') {
+                for (const d of c.children)
+                    if (d.attrs.id)
+                        defs.set(d.attrs.id, d);
+            }
+            else {
+                collectDefs(c);
+            }
+        }
+    };
+    collectDefs(root);
+    const items = [];
+    const pushPath = (d, ctx, el) => {
+        if (!d)
+            return;
+        const fillAttr = el.attrs.fill;
+        const sw = el.attrs['stroke-width'] !== undefined ? num(el.attrs['stroke-width']) : ctx.strokeWidth;
+        const path = transformPath(d, ctx.matrix);
+        const stroked = sw !== undefined && sw > 0;
+        const filled = fillAttr !== 'none';
+        // Verovio strokes staff lines, ledger lines and bar lines with the
+        // stylesheet's `stroke: currentColor`; their `fill` is left to the
+        // default black, which on a path of straight lines paints nothing. Slurs
+        // and ties are curves both filled and stroked.
+        if (filled && !(stroked && el.name === 'path' && LINE_ONLY_RE.test(d))) {
+            items.push({ type: 'path', d: path, fill: true });
+        }
+        if (stroked) {
+            items.push({
+                type: 'path',
+                d: path,
+                fill: false,
+                strokeWidth: sw * lengthScale(ctx.matrix),
+                ...(el.attrs['stroke-linecap'] ? { lineCap: el.attrs['stroke-linecap'] } : {}),
+            });
+        }
+    };
+    const walk = (el, parent) => {
+        if (el.name === 'defs' || el.name === 'style' || el.name === 'desc' || el.name === 'title')
+            return;
+        let matrix = parent.matrix;
+        if (el.attrs.transform)
+            matrix = multiply(matrix, parseSvgTransform(el.attrs.transform));
+        const classes = (el.attrs.class ?? '').split(/\s+/);
+        if (classes.some((c) => skip.has(c)))
+            return;
+        const ctx = {
+            matrix,
+            bold: parent.bold || classes.some((c) => BOLD_CLASSES.has(c)),
+            italic: parent.italic || classes.some((c) => ITALIC_CLASSES.has(c)),
+            strokeWidth: el.attrs['stroke-width'] !== undefined ? num(el.attrs['stroke-width']) : parent.strokeWidth,
+        };
+        switch (el.name) {
+            case 'svg':
+                if (el !== inner && el !== root) {
+                    // A nested viewport (Verovio uses none inside a system; skip safely).
+                    return;
+                }
+                break;
+            case 'g':
+                break;
+            case 'use': {
+                const ref = defs.get((el.attrs.href ?? '').replace(/^#/, ''));
+                if (!ref)
+                    return;
+                const m = multiply(ctx.matrix, [1, 0, 0, 1, num(el.attrs.x), num(el.attrs.y)]);
+                walk(ref, { ...ctx, matrix: m });
+                return;
+            }
+            case 'path':
+                pushPath(el.attrs.d ?? '', ctx, el);
+                return;
+            case 'rect':
+                pushPath(rectPath(num(el.attrs.x), num(el.attrs.y), num(el.attrs.width), num(el.attrs.height)), ctx, el);
+                return;
+            case 'polygon':
+                pushPath(pointsPath(el.attrs.points ?? ''), ctx, el);
+                return;
+            case 'polyline': {
+                const d = pointsPath(el.attrs.points ?? '').replace(/Z$/, '');
+                pushPath(d, { ...ctx, strokeWidth: ctx.strokeWidth ?? 1 }, { ...el, attrs: { ...el.attrs, fill: 'none' } });
+                return;
+            }
+            case 'ellipse':
+            case 'circle': {
+                const rx = num(el.attrs.rx ?? el.attrs.r);
+                const ry = num(el.attrs.ry ?? el.attrs.r);
+                pushPath(ellipsePath(num(el.attrs.cx), num(el.attrs.cy), rx, ry), ctx, el);
+                return;
+            }
+            case 'text': {
+                const runs = leafRuns(el, num(el.attrs['font-size'], 0), { rise: 0 }).filter((r) => r.size > 0);
+                const text = runs.map((r) => r.text).join('');
+                const size = runs[0]?.size ?? 0;
+                if (!text || !(size > 0))
+                    return;
+                const [x, y] = [num(el.attrs.x), num(el.attrs.y)];
+                const m = ctx.matrix;
+                const k = lengthScale(m);
+                const anchor = el.attrs['text-anchor'];
+                // Runs of one size on one baseline read as one word; others keep
+                // their sizes and shifts, laid side by side when the engine can
+                // measure them (`layOutRuns`).
+                const plain = runs.every((r) => r.size === size && r.rise === 0 && r.dx === 0);
+                items.push({
+                    type: 'text',
+                    x: m[0] * x + m[2] * y + m[4],
+                    y: m[1] * x + m[3] * y + m[5],
+                    text,
+                    sizePx: size * k,
+                    bold: ctx.bold || runs.some((r) => r.weight === 'bold'),
+                    italic: ctx.italic || runs.some((r) => r.style === 'italic'),
+                    ...(anchor === 'middle' || anchor === 'end' ? { anchor } : {}),
+                    ...(plain ? {} : {
+                        runs: runs.map((r) => ({
+                            text: r.text,
+                            sizePx: r.size * k,
+                            rise: r.rise * k,
+                            dx: r.dx * k,
+                            ...(r.weight === 'bold' ? { bold: true } : {}),
+                            ...(r.style === 'italic' ? { italic: true } : {}),
+                        })),
+                    }),
+                });
+                return;
+            }
+            default:
+                break;
+        }
+        for (const c of el.children)
+            walk(c, ctx);
+    };
+    const start = { matrix: base, bold: false, italic: false, strokeWidth: undefined };
+    for (const c of inner.children)
+        walk(c, start);
+    return { items, heightPx };
+}
+function esc(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+const r2 = (n) => String(Math.round(n * 100) / 100);
+/**
+ * Plain SVG for a flattened system: paths and text, `currentColor` ink, the
+ * text in `textFont`. HTML inlines it; the PDF backend draws it with its SVG
+ * vector subset.
+ */
+export function itemsToSvg(items, widthPx, heightPx, color, textFont) {
+    const out = [];
+    for (const it of items) {
+        if (it.type === 'path') {
+            out.push(it.fill
+                ? `<path d="${it.d}" fill="${color}"/>`
+                : `<path d="${it.d}" fill="none" stroke="${color}" stroke-width="${r2(it.strokeWidth ?? 1)}"${it.lineCap ? ` stroke-linecap="${it.lineCap}"` : ''}/>`);
+        }
+        else {
+            out.push(`<text x="${r2(it.x)}" y="${r2(it.y)}" font-size="${r2(it.sizePx)}"${it.bold ? ' font-weight="bold"' : ''}${it.italic ? ' font-style="italic"' : ''}${it.anchor ? ` text-anchor="${it.anchor}"` : ''} fill="${color}">${esc(it.text)}</text>`);
+        }
+    }
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${r2(widthPx)}" height="${r2(heightPx)}" viewBox="0 0 ${r2(widthPx)} ${r2(heightPx)}" font-family="${esc(textFont)}">${out.join('')}</svg>`;
+}
+//# sourceMappingURL=flatten.js.map