postext 1.4.2 → 1.5.0

package/dist/__tests__/design/boxBorderInside.test.js

@@ -0,0 +1,102 @@
+import { describe, it, expect } from 'vitest';
+import { renderHeaderFooterSlot } from '../../canvas-backend/headerFooter';
+/** A 2D context that records the rectangle and path calls. */
+function recordingCtx() {
+    const calls = [];
+    const state = { fillStyle: '', strokeStyle: '', lineWidth: 1 };
+    const stack = [];
+    const rec = (op) => function (...args) {
+        calls.push({ op, args, lineWidth: this.lineWidth, fill: this.fillStyle, stroke: this.strokeStyle });
+    };
+    const ctx = {
+        ...state,
+        save() { stack.push({ fillStyle: this.fillStyle, strokeStyle: this.strokeStyle, lineWidth: this.lineWidth }); },
+        restore() { Object.assign(this, stack.pop()); },
+        beginPath: rec('beginPath'),
+        moveTo: rec('moveTo'),
+        lineTo: rec('lineTo'),
+        arcTo: rec('arcTo'),
+        closePath: rec('closePath'),
+        fill: rec('fill'),
+        stroke: rec('stroke'),
+        fillRect: rec('fillRect'),
+        strokeRect: rec('strokeRect'),
+        rect: rec('rect'),
+        clip: rec('clip'),
+    };
+    return { ctx: ctx, calls };
+}
+const boxSlot = (box) => ({
+    bbox: { x: 0, y: 0, width: 400, height: 400 },
+    blocks: [{
+            kind: 'box',
+            bbox: { x: 10, y: 20, width: 100, height: 50 },
+            box: { borderWidthPx: 0, borderRadiusPx: 0, ...box },
+        }],
+});
+describe('design box borders on canvas (EF-131)', () => {
+    it('strokes a square frame inside the box: its outer edge on the box edge', () => {
+        const { ctx, calls } = recordingCtx();
+        renderHeaderFooterSlot(ctx, boxSlot({ backgroundColor: '#eeeeee', borderColor: '#ff2d9b', borderWidthPx: 4 }));
+        // The fill covers the whole box, under the border.
+        expect(calls.find((c) => c.op === 'fillRect')?.args).toEqual([10, 20, 100, 50]);
+        const stroke = calls.find((c) => c.op === 'strokeRect');
+        expect(stroke.lineWidth).toBe(4);
+        // Centred 2 px inside each edge, so the stroke spans x 10…110, y 20…70.
+        expect(stroke.args).toEqual([12, 22, 96, 46]);
+    });
+    /** The subpaths traced for the last fill in the border colour. */
+    const borderRing = (calls, color) => {
+        const fillAt = calls.map((c) => c.op === 'fill' && c.fill === color).lastIndexOf(true);
+        expect(fillAt).toBeGreaterThan(0);
+        const path = calls.slice(calls.slice(0, fillAt).map((c) => c.op).lastIndexOf('beginPath'), fillAt);
+        const starts = path.flatMap((c) => (c.op === 'moveTo' ? [c.args] : []));
+        const arcs = path.filter((c) => c.op === 'arcTo').map((c) => c.args[4]);
+        return { fill: calls[fillAt], starts, arcs };
+    };
+    it('fills a rounded frame as the ring CSS draws: outer radius on the box edge, inner radius less the width', () => {
+        const { ctx, calls } = recordingCtx();
+        renderHeaderFooterSlot(ctx, boxSlot({ borderColor: '#ff2d9b', borderWidthPx: 4, borderRadiusPx: 10 }));
+        expect(calls.some((c) => c.op === 'stroke')).toBe(false);
+        const ring = borderRing(calls, '#ff2d9b');
+        expect(ring.fill.args).toEqual(['evenodd']);
+        // The box's outline from its top edge past the radius (10), then the
+        // inner edge 4 px in, its radius 6.
+        expect(ring.starts).toEqual([[10 + 10, 20], [14 + 6, 24]]);
+        expect(ring.arcs).toEqual([10, 10, 10, 10, 6, 6, 6, 6]);
+    });
+    it('keeps the outer corner round when the radius is under half the border width', () => {
+        // 2.5 pt of radius, 6 pt of border: a stroke centred inside the box
+        // would run on a square path and paint a square corner past the fill.
+        const { ctx, calls } = recordingCtx();
+        renderHeaderFooterSlot(ctx, boxSlot({ backgroundColor: '#eeeeee', borderColor: '#ff2d9b', borderWidthPx: 8, borderRadiusPx: 3.33 }));
+        expect(calls.some((c) => c.op === 'stroke')).toBe(false);
+        const ring = borderRing(calls, '#ff2d9b');
+        expect(ring.starts).toEqual([[10 + 3.33, 20], [18, 28]]);
+        // Rounded outside, square inside (3.33 − 8 < 0), as in HTML.
+        expect(ring.arcs).toEqual([3.33, 3.33, 3.33, 3.33, 0, 0, 0, 0]);
+    });
+    it('fills the whole rounded box when the border leaves no inside', () => {
+        const { ctx, calls } = recordingCtx();
+        renderHeaderFooterSlot(ctx, boxSlot({ borderColor: '#ff2d9b', borderWidthPx: 30, borderRadiusPx: 10 }));
+        expect(calls.some((c) => c.op === 'stroke')).toBe(false);
+        expect(borderRing(calls, '#ff2d9b').starts).toEqual([[20, 20]]);
+    });
+    it('fills a box whose border is wider than it is with the border colour', () => {
+        const { ctx, calls } = recordingCtx();
+        renderHeaderFooterSlot(ctx, {
+            bbox: { x: 0, y: 0, width: 100, height: 100 },
+            blocks: [{ kind: 'box', bbox: { x: 0, y: 0, width: 3, height: 40 }, box: { borderColor: '#ff2d9b', borderWidthPx: 4, borderRadiusPx: 0 } }],
+        });
+        expect(calls.some((c) => c.op === 'strokeRect')).toBe(false);
+        const fill = calls.find((c) => c.op === 'fillRect');
+        expect(fill.args).toEqual([0, 0, 3, 40]);
+        expect(fill.fill).toBe('#ff2d9b');
+    });
+    it('leaves a box without a border as it was', () => {
+        const { ctx, calls } = recordingCtx();
+        renderHeaderFooterSlot(ctx, boxSlot({ backgroundColor: '#eeeeee' }));
+        expect(calls.map((c) => c.op)).toEqual(['fillRect']);
+    });
+});
+//# sourceMappingURL=boxBorderInside.test.js.map

package/dist/__tests__/design/boxBorderInside.test.js.map

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

package/dist/__tests__/design/designLineHeight.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=designLineHeight.test.d.ts.map

package/dist/__tests__/design/designLineHeight.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"designLineHeight.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/design/designLineHeight.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/design/designLineHeight.test.js

@@ -0,0 +1,108 @@
+import { describe, it, expect } from 'vitest';
+import { measureHeadingAdvancedDesignHeight } from '../../pipeline/headerFooter';
+import { resolveHeadingsConfig } from '../../defaults/headings';
+import { resolveDesignSlot } from '../../defaults/headerFooter';
+import { layoutDesignSlot } from '../../design/layout';
+import { buildDocument } from '../../pipeline';
+// EF-56: a design text's `lineHeight` written as a Dimension (as every
+// other leading in the config is) made the opener measurement NaN, and the
+// whole opener reservation was dropped without a word. A Dimension is now
+// accepted: `em` / `rem` are the multiplier, an absolute length sets the
+// distance between baselines. Nothing yields NaN.
+class StubCtx {
+    font = '';
+    measureText(s) {
+        return { width: s.length * 7 };
+    }
+}
+globalThis.OffscreenCanvas = class {
+    getContext() {
+        return new StubCtx();
+    }
+};
+const DPI = 72; // 1pt = 1px
+const pt = (value) => ({ value, unit: 'pt' });
+const heading = { titleText: 'Line one\nLine two\nLine three', formattedNumber: '', chapterNumber: '' };
+const titleWith = (lineHeight) => ({
+    kind: 'text', id: 'title', content: '{titleText}', fontSize: pt(20), overflow: 'wrap',
+    placement: { anchor: { to: 'container', edge: 'top-left' } },
+    lineHeight,
+});
+const measure = (lineHeight, minHeight) => {
+    const level = resolveHeadingsConfig({
+        levels: [{ level: 1, advancedDesign: { enabled: true, slot: { elements: [titleWith(lineHeight)] }, ...(minHeight ? { minHeight } : {}) } }],
+    }).levels.find((l) => l.level === 1);
+    return measureHeadingAdvancedDesignHeight(level, heading, 320, DPI, {}, 0);
+};
+describe('EF-56: design text lineHeight as a Dimension', () => {
+    it('a number is the multiplier of the font size (unchanged)', () => {
+        expect(measure(1.5)).toBeCloseTo(3 * 30, 5);
+        expect(measure(undefined)).toBeCloseTo(3 * 24, 5);
+    });
+    it('an absolute length is the distance between baselines', () => {
+        expect(measure({ value: 15.5, unit: 'pt' })).toBeCloseTo(3 * 15.5, 5);
+        expect(measure({ value: 10, unit: 'mm' })).toBeCloseTo(3 * (10 / 25.4) * 72, 5);
+    });
+    it('em / rem are the multiplier', () => {
+        expect(measure({ value: 1.5, unit: 'em' })).toBeCloseTo(3 * 30, 5);
+        expect(measure({ value: 1.25, unit: 'rem' })).toBeCloseTo(3 * 25, 5);
+    });
+    it('an unusable value falls back to the default leading, never NaN', () => {
+        // A numeric string (a hand-written JSON config) is the number it spells.
+        expect(measure('1.4')).toBeCloseTo(3 * 28, 5);
+        for (const bad of ['tall', null, -2, 0, Number.NaN, { value: 'x', unit: 'pt' }, { unit: 'pt' }, { value: 2, unit: 'furlong' }]) {
+            const h = measure(bad);
+            expect(Number.isFinite(h)).toBe(true);
+            expect(h).toBeCloseTo(3 * 24, 5);
+        }
+    });
+    it('keeps the opener minHeight whatever the leading', () => {
+        expect(measure({ value: 15.5, unit: 'pt' }, pt(200))).toBe(200);
+    });
+    it('an element another malformed value leaves without a finite box reserves nothing, and minHeight holds', () => {
+        const broken = { ...titleWith(1.2), fontSize: { value: 'big', unit: 'pt' } };
+        const level = resolveHeadingsConfig({
+            levels: [{ level: 1, advancedDesign: { enabled: true, minHeight: pt(50), slot: { elements: [broken] } } }],
+        }).levels.find((l) => l.level === 1);
+        expect(measureHeadingAdvancedDesignHeight(level, heading, 320, DPI, {}, 0)).toBe(50);
+    });
+    it('the resolved element keeps a multiplier in lineHeight and an absolute length in lineHeightLength', () => {
+        const slot = resolveDesignSlot({ elements: [titleWith({ value: 1.5, unit: 'em' }), { ...titleWith({ value: 15.5, unit: 'pt' }), id: 'abs' }] });
+        const [em, abs] = slot.elements;
+        expect(em.lineHeight).toBe(1.5);
+        expect(em.lineHeightLength).toBeUndefined();
+        // The equivalent multiplier, for editors; the length wins at layout.
+        expect(abs.lineHeight).toBeCloseTo(15.5 / 20, 5);
+        expect(abs.lineHeightLength).toEqual({ value: 15.5, unit: 'pt' });
+    });
+    it('lays the lines out at the absolute leading', () => {
+        const slot = resolveDesignSlot({ elements: [titleWith({ value: 15.5, unit: 'pt' })] }, 'header');
+        const page = { index: 0, pageLabel: '1' };
+        const out = layoutDesignSlot(slot, {
+            container: { x: 0, y: 0, width: 320, height: 400 }, dpi: DPI,
+            placeholders: { kind: 'heading', page, allPages: [page], metadata: {}, chapterTitleByPageIndex: [], heading },
+        }, 0);
+        const text = out.primitives.find((p) => p.kind === 'text');
+        const baselines = text.lines.map((l) => l.baselineY);
+        expect(baselines[1] - baselines[0]).toBeCloseTo(15.5, 5);
+        expect(baselines[2] - baselines[1]).toBeCloseTo(15.5, 5);
+    });
+    it('an H1 opener with a Dimension leading keeps its reservation in a built document', () => {
+        const cfg = {
+            page: { dpi: DPI, width: pt(360), height: pt(480), margins: { top: pt(18), bottom: pt(18), left: pt(18), right: pt(18) } },
+            headings: { levels: [{
+                        level: 1, span: 'page', breakBefore: { enabled: true, parity: 'any' },
+                        advancedDesign: { enabled: true, minHeight: pt(120), slot: { elements: [titleWith({ value: 15.5, unit: 'pt' })] } },
+                    }] },
+        };
+        const doc = buildDocument({ markdown: '# Opening\n\nBody text after the opener.' }, cfg);
+        const page = doc.pages[0];
+        expect(page.openerBand).toBeDefined();
+        const title = page.openerBand.blocks.find((b) => b.kind === 'text');
+        expect(title).toBeDefined();
+        const body = page.columns.flatMap((c) => c.blocks).find((b) => b.type === 'paragraph');
+        // The body starts below the reserved band (minHeight 120 from the content top at 18).
+        expect(body.bbox.y).toBeGreaterThanOrEqual(18 + 120 - 0.01);
+    });
+});
+//# sourceMappingURL=designLineHeight.test.js.map

package/dist/__tests__/design/designLineHeight.test.js.map

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

package/dist/__tests__/design/designText.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=designText.test.d.ts.map

package/dist/__tests__/design/designText.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"designText.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/design/designText.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/design/designText.test.js

@@ -0,0 +1,331 @@
+import { describe, it, expect } from 'vitest';
+import { layoutDesignSlot } from '../../design/layout';
+import { resolveDesignSlot } from '../../defaults/headerFooter';
+import { layoutSlotToVdt } from '../../pipeline/headerFooter';
+import { buildDocument } from '../../pipeline';
+// Deterministic text measurement stub (no DOM in the node test env): every
+// character is 7px wide whatever the font, so widths read as char counts.
+class StubCtx {
+    font = '';
+    measureText(s) {
+        return { width: s.length * 7 };
+    }
+}
+globalThis.OffscreenCanvas = class {
+    getContext() {
+        return new StubCtx();
+    }
+};
+const DPI = 72; // 1pt = 1px keeps the arithmetic readable.
+const pt = (value) => ({ value, unit: 'pt' });
+const container = { x: 0, y: 0, width: 300, height: 200 };
+const stubPage = { index: 0, pageLabel: '1' };
+const placeholders = {
+    kind: 'header',
+    page: stubPage,
+    allPages: [stubPage],
+    metadata: {},
+    chapterTitleByPageIndex: [],
+};
+const text = (content, extra = {}) => ({
+    kind: 'text',
+    id: 't',
+    content,
+    fontSize: pt(10),
+    placement: { anchor: { to: 'container', edge: 'top-left' }, size: { width: pt(200) } },
+    ...extra,
+});
+const layoutOne = (el) => layoutDesignSlot(resolveDesignSlot({ elements: [el] }), { container, dpi: DPI, placeholders }, 0).primitives[0];
+const linesOf = (p) => p.lines.map((l) => l.text);
+describe('design text line breaks (EF-01)', () => {
+    // The two characters `\` `n`, as an attribute value carries them.
+    const ADDRESS = 'Firma X\\nStrasse 1\\n10115 Berlin';
+    it('the `\\n` escape starts a new line in a plain wrapping text', () => {
+        const p = layoutOne(text(ADDRESS, { overflow: 'wrap' }));
+        expect(linesOf(p)).toEqual(['Firma X', 'Strasse 1', '10115 Berlin']);
+        expect(p.height).toBeCloseTo(3 * 10 * 1.2, 5);
+    });
+    it('a line break starts a new line in the single-line overflow modes too', () => {
+        // Default overflow (`ellipsis-end`): each line is truncated on its own.
+        const narrow = { anchor: { to: 'container', edge: 'top-left' }, size: { width: pt(56) } };
+        const p = layoutOne(text(ADDRESS, { placement: narrow }));
+        // Cut at the word boundary, with no space before the ellipsis (EF-76).
+        expect(linesOf(p)).toEqual(['Firma X', 'Strasse…', '10115…']);
+        const clipped = layoutOne(text('One\nTwo words', { overflow: 'clip', placement: narrow }));
+        expect(linesOf(clipped)).toEqual(['One', 'Two words']);
+        expect(clipped.needsClip).toBe(true);
+        expect(clipped.lines[1].topY).toBeCloseTo(12, 5);
+    });
+    it('a text element that leaves fontSize out gets the documented 8pt (EF-54)', () => {
+        const el = { kind: 'text', id: 't', content: 'Folio', placement: { anchor: { to: 'container', edge: 'top-left' } } };
+        const p = layoutOne(el);
+        expect(p.fontSizePx).toBe(8);
+        expect(p.fontString).toBe('8px EB Garamond');
+        expect(p.height).toBeCloseTo(8 * 1.2, 5);
+    });
+    it('a text without line breaks is laid out as before', () => {
+        const p = layoutOne(text('A running head'));
+        expect(linesOf(p)).toEqual(['A running head']);
+        expect(p.lines[0].runs).toBeUndefined();
+    });
+    it('a heading attribute with `\\n` prints one line per part in an opener', () => {
+        const config = {
+            page: { width: pt(400), height: pt(600), dpi: 72, margins: { top: pt(40), bottom: pt(40), left: pt(40), right: pt(40) } },
+            header: { elements: [] },
+            footer: { elements: [] },
+            headings: {
+                levels: [{
+                        level: 1,
+                        span: 'page',
+                        breakBefore: { enabled: true, parity: 'any' },
+                        advancedDesign: {
+                            enabled: true,
+                            slot: { elements: [text('{attr.to}', { id: 'to', overflow: 'wrap' })] },
+                        },
+                    }],
+            },
+        };
+        const doc = buildDocument({ markdown: '# Letter {to="Firma X\\nStrasse 1\\n10115 Berlin"}\n\nDear Sirs.' }, config);
+        const band = doc.pages[0].openerBand;
+        const block = band.blocks.find((b) => b.kind === 'text');
+        expect(block.lines.map((l) => l.text)).toEqual(['Firma X', 'Strasse 1', '10115 Berlin']);
+    });
+    it('a `\\\\` title break splits an opener title in the default overflow mode too', () => {
+        const config = {
+            page: { width: pt(400), height: pt(600), dpi: 72, margins: { top: pt(40), bottom: pt(40), left: pt(40), right: pt(40) } },
+            header: { elements: [] },
+            footer: { elements: [] },
+            headings: {
+                levels: [{
+                        level: 1, span: 'page', breakBefore: { enabled: true, parity: 'any' },
+                        advancedDesign: { enabled: true, slot: { elements: [text('{titleText}', { id: 'ttl' })] } },
+                    }],
+            },
+        };
+        const doc = buildDocument({ markdown: '# Concepts of health \\\\ Community health\n\nText.' }, config);
+        const block = doc.pages[0].openerBand.blocks.find((b) => b.kind === 'text');
+        expect(block.lines.map((l) => l.text)).toEqual(['Concepts of health', 'Community health']);
+    });
+    // The escape belongs to what the author writes in the design: the
+    // element's own content and heading attribute values. Document text
+    // that merely contains the two characters (a code span in a title, a
+    // frontmatter value) is printed as written.
+    const escapesConfig = (titleExtra = {}) => ({
+        page: { width: pt(500), height: pt(600), dpi: 72, margins: { top: pt(40), bottom: pt(40), left: pt(40), right: pt(40) } },
+        layout: { layoutType: 'single' },
+        header: {
+            elements: [
+                text('{chapterTitle}', { id: 'rh', overflow: 'wrap', placement: { anchor: { to: 'container', edge: 'bottom-left' }, size: { width: pt(400) } } }),
+                text('{title}', { id: 'book', overflow: 'wrap', placement: { anchor: { to: 'container', edge: 'top-left' }, size: { width: pt(400) } } }),
+            ],
+        },
+        footer: { elements: [] },
+        headings: {
+            levels: [{
+                    level: 1, span: 'page', breakBefore: { enabled: true, parity: 'any' },
+                    advancedDesign: { enabled: true, slot: { elements: [text('{titleText}', { id: 'ttl', overflow: 'wrap', placement: { anchor: { to: 'container', edge: 'top-left' }, size: { width: pt(400) } }, ...titleExtra })] } },
+                }],
+        },
+    });
+    const ESCAPES_MD = '---\ntitle: Notes on \\n escapes\n---\n\n# Escapes: `\\n` and `\\t`\n\n' + 'Body text. '.repeat(400);
+    const headerTexts = (doc) => doc.pages
+        .flatMap((p) => p.header?.blocks ?? [])
+        .filter((b) => b.kind === 'text')
+        .map((b) => b.lines.map((l) => l.text));
+    it('document text holding the characters `\\n` stays on one line in running heads and openers', () => {
+        const doc = buildDocument({ markdown: ESCAPES_MD }, escapesConfig());
+        const opener = doc.pages[0].openerBand.blocks.find((b) => b.kind === 'text');
+        expect(opener.lines.map((l) => l.text)).toEqual(['Escapes: \\n and \\t']);
+        const heads = headerTexts(doc);
+        expect(heads).toContainEqual(['Escapes: \\n and \\t']);
+        expect(heads).toContainEqual(['Notes on \\n escapes']);
+        expect(heads.every((lines) => lines.length === 1)).toBe(true);
+    });
+    it('the paragraph path (indent, drop cap) leaves document text as written too', () => {
+        const indented = buildDocument({ markdown: ESCAPES_MD }, escapesConfig({ paragraphIndent: pt(12) }));
+        const a = indented.pages[0].openerBand.blocks.find((b) => b.kind === 'text');
+        expect(a.lines.map((l) => l.text)).toEqual(['Escapes: \\n and \\t']);
+        const capped = buildDocument({ markdown: ESCAPES_MD }, escapesConfig({ dropCap: { lines: 1 } }));
+        const main = capped.pages[0].openerBand.blocks.filter((b) => b.kind === 'text');
+        expect(main.map((b) => b.lines.map((l) => l.text).join('|'))).toContain('scapes: \\n and \\t');
+    });
+    it('the escape still applies to the content template and, in headers, to the chapter attribute', () => {
+        const upper = layoutOne(text('Line one\\nline two', { overflow: 'wrap', textTransform: 'uppercase' }));
+        expect(linesOf(upper)).toEqual(['LINE ONE', 'LINE TWO']);
+        const config = {
+            page: { width: pt(400), height: pt(600), dpi: 72, margins: { top: pt(40), bottom: pt(40), left: pt(40), right: pt(40) } },
+            header: { elements: [text('{attr.to}', { id: 'to', overflow: 'wrap', placement: { anchor: { to: 'container', edge: 'bottom-left' }, size: { width: pt(300) } } })] },
+            footer: { elements: [] },
+        };
+        const doc = buildDocument({ markdown: '# Letter {to="Firma X\\nStrasse 1"}\n\n' + 'Dear Sirs. '.repeat(300) }, config);
+        const lines = doc.pages.flatMap((p) => p.header?.blocks ?? []).filter((b) => b.kind === 'text').map((b) => b.lines.map((l) => l.text));
+        expect(lines).toContainEqual(['Firma X', 'Strasse 1']);
+    });
+    it('inline marks in a heading attribute become runs in the opener', () => {
+        const config = {
+            page: { width: pt(400), height: pt(600), dpi: 72, margins: { top: pt(40), bottom: pt(40), left: pt(40), right: pt(40) } },
+            header: { elements: [] },
+            footer: { elements: [] },
+            headings: {
+                levels: [{
+                        level: 1, span: 'page', breakBefore: { enabled: true, parity: 'any' },
+                        advancedDesign: { enabled: true, slot: { elements: [text('{attr.authors}', { id: 'authors', inlineMarks: true, overflow: 'wrap' })] } },
+                    }],
+            },
+        };
+        const doc = buildDocument({ markdown: '# Snow {authors="Ana Ruiz^1^, Luis Gil^2^"}\n\nText.' }, config);
+        const block = doc.pages[0].openerBand.blocks.find((b) => b.kind === 'text');
+        expect(block.lines[0].text).toBe('Ana Ruiz1, Luis Gil2');
+        expect(block.lines[0].runs.filter((r) => r.baselineShift !== undefined).map((r) => r.text)).toEqual(['1', '2']);
+        // The source range still maps back to the attribute, without a
+        // per-character map (the markers are gone from the printed text).
+        expect(block.sourceStart).toBeDefined();
+        expect(block.sourceMap).toBeUndefined();
+    });
+    it('keeps the per-character source map when inline marks leave the mapped value as it is', () => {
+        const config = (content) => ({
+            page: { width: pt(400), height: pt(600), dpi: 72, margins: { top: pt(40), bottom: pt(40), left: pt(40), right: pt(40) } },
+            header: { elements: [] },
+            footer: { elements: [] },
+            headings: {
+                levels: [{
+                        level: 1, span: 'page', breakBefore: { enabled: true, parity: 'any' },
+                        advancedDesign: { enabled: true, slot: { elements: [text(content, { id: 'ttl', inlineMarks: true, overflow: 'wrap' })] } },
+                    }],
+            },
+        });
+        const titleOf = (markdown, content) => buildDocument({ markdown }, config(content)).pages[0].openerBand.blocks.find((b) => b.kind === 'text');
+        // A title with no markers, with the option on.
+        const plain = titleOf('# Snow cover\n\nText.', '{titleText}');
+        expect(plain.sourceText).toBe('Snow cover');
+        expect(plain.sourceMap).toEqual([...'Snow cover'].map((_, i) => 2 + i));
+        // Marks around the placeholder style the value but keep its characters.
+        const bold = titleOf('# Snow cover\n\nText.', '**{titleText}**');
+        expect(bold.lines[0].runs[0].fontString).toMatch(/^700 /);
+        expect(bold.sourceMap).toHaveLength('Snow cover'.length);
+        // A title's own marks are gone from `{titleText}` already, and its map
+        // skips them. (A value whose markers the element drops keeps only its
+        // range: see the attribute test above.)
+        const marked = titleOf('# E = mc^2^\n\nText.', '{titleText}');
+        expect(marked.lines[0].text).toBe('E = mc2');
+        expect(marked.sourceMap).toEqual([2, 3, 4, 5, 6, 7, 9]);
+    });
+});
+describe('inline marks in design text (EF-25)', () => {
+    it('leaves markers literal unless inlineMarks is on', () => {
+        const p = layoutOne(text('**Bold** and ^1^'));
+        expect(linesOf(p)).toEqual(['**Bold** and ^1^']);
+        expect(p.lines[0].runs).toBeUndefined();
+    });
+    it('sets superscripts smaller and raised, in runs painted one after another', () => {
+        const p = layoutOne(text('Ana Ruiz^1^, Luis Gil^2^', { inlineMarks: true }));
+        expect(linesOf(p)).toEqual(['Ana Ruiz1, Luis Gil2']);
+        const runs = p.lines[0].runs;
+        expect(runs.map((r) => r.text)).toEqual(['Ana Ruiz', '1', ', Luis Gil', '2']);
+        expect(runs[0].fontString).toBe(p.fontString);
+        expect(runs[0].baselineShift).toBeUndefined();
+        // The script size and shift of the body text: 0.583 and 0.333 of 10px.
+        expect(runs[1].fontString).toMatch(/^5\.8\d*px /);
+        expect(runs[1].baselineShift).toBeCloseTo(-3.33, 2);
+        expect(p.lines[0].width).toBeCloseTo(runs.reduce((s, r) => s + r.width, 0), 5);
+    });
+    it('sets bold at weight 700 and flips the slant of italic runs', () => {
+        const bold = layoutOne(text('A **strong** word', { inlineMarks: true }));
+        expect(bold.lines[0].runs.map((r) => r.text)).toEqual(['A ', 'strong', ' word']);
+        expect(bold.lines[0].runs[1].fontString).toMatch(/^700 10px /);
+        // An italic element: `*…*` sets roman, as emphasis inside italic does.
+        const italic = layoutOne(text('In *Don Quijote* now', { inlineMarks: true, italic: true }));
+        const runs = italic.lines[0].runs;
+        expect(runs[0].fontString).toMatch(/^italic /);
+        expect(runs[1].text).toBe('Don Quijote');
+        expect(runs[1].fontString).not.toMatch(/italic/);
+        // A heavier element keeps its weight in bold runs.
+        const heavy = layoutOne(text('**x**', { inlineMarks: true, fontWeight: 900 }));
+        expect(heavy.lines[0].runs[0].fontString).toMatch(/^900 10px /);
+    });
+    it('wraps marked text by words, carrying the runs across lines', () => {
+        const p = layoutOne(text('aaa **bbb** ccc', {
+            inlineMarks: true,
+            overflow: 'wrap',
+            placement: { anchor: { to: 'container', edge: 'top-left' }, size: { width: pt(60) } },
+        }));
+        expect(linesOf(p)).toEqual(['aaa bbb', 'ccc']);
+        expect(p.lines[0].runs.map((r) => r.text)).toEqual(['aaa ', 'bbb']);
+        expect(p.lines[1].runs.map((r) => r.text)).toEqual(['ccc']);
+        expect(p.lines[1].topY).toBeCloseTo(12, 5);
+    });
+    it('keeps the drop cap and paragraph indents on marked text', () => {
+        const p = layoutDesignSlot(resolveDesignSlot({
+            elements: [text('Once **upon** a time\\nThe *end* came', {
+                    inlineMarks: true,
+                    overflow: 'wrap',
+                    dropCap: { lines: 1, gap: pt(0) },
+                    paragraphIndent: pt(14),
+                    placement: { anchor: { to: 'container', edge: 'top-left' }, size: { width: pt(300) } },
+                })],
+        }), { container, dpi: DPI, placeholders }, 0).primitives;
+        const [main, cap] = p;
+        expect(cap.lines[0].text).toBe('O');
+        expect(main.lines.map((l) => l.text)).toEqual(['nce upon a time', 'The end came']);
+        expect(main.lines[0].runs.map((r) => r.text)).toEqual(['nce ', 'upon', ' a time']);
+        expect(main.lines[0].xOffset).toBeGreaterThan(0); // beside the cap
+        expect(main.lines[1].xOffset).toBe(14); // the second paragraph's indent
+        expect(main.lines[1].runs.map((r) => r.text)).toEqual(['The ', 'end', ' came']);
+    });
+    it('breaks an overlong marked word by character when it cannot wrap at a space', () => {
+        const p = layoutOne(text('**abcdefghij**', {
+            inlineMarks: true,
+            overflow: 'wrap',
+            placement: { anchor: { to: 'container', edge: 'top-left' }, size: { width: pt(30) } },
+        }));
+        expect(linesOf(p)).toEqual(['abcd', 'efgh', 'ij']);
+        expect(p.lines.every((l) => l.runs.length === 1 && l.runs[0].fontString.startsWith('700 '))).toBe(true);
+    });
+    it('truncates marked text with an ellipsis in the style of the last visible run', () => {
+        const p = layoutOne(text('**abcdefgh**', {
+            inlineMarks: true,
+            placement: { anchor: { to: 'container', edge: 'top-left' }, size: { width: pt(40) } },
+        }));
+        expect(linesOf(p)).toEqual(['abcd…']);
+        const runs = p.lines[0].runs;
+        expect(runs).toHaveLength(1);
+        expect(runs[0].fontString).toMatch(/^700 /);
+    });
+    it('reads marks in placeholder values too', () => {
+        const heading = {
+            ...placeholders,
+            kind: 'heading',
+            heading: { titleText: 'T', formattedNumber: '', chapterNumber: '', attrs: { authors: 'Ana^1^' } },
+        };
+        const el = text('{attr.authors}', { inlineMarks: true });
+        const p = layoutDesignSlot(resolveDesignSlot({ elements: [el] }), { container, dpi: DPI, placeholders: heading }, 0)
+            .primitives[0];
+        expect(p.lines[0].runs.map((r) => r.text)).toEqual(['Ana', '1']);
+    });
+    it('carries the runs to the VDT block, which keeps the plain line text', () => {
+        const slot = layoutSlotToVdt(resolveDesignSlot({ elements: [text('H~2~O', { inlineMarks: true })] }), container, 0, placeholders, DPI);
+        const block = slot.blocks[0];
+        expect(block.lines[0].text).toBe('H2O');
+        expect(block.lines[0].runs.map((r) => [r.text, r.baselineShift !== undefined && r.baselineShift > 0])).toEqual([
+            ['H', false],
+            ['2', true],
+            ['O', false],
+        ]);
+    });
+});
+describe('text stroke (EF-25)', () => {
+    it('resolves the outline to px and the text colour by default', () => {
+        const el = text('1863', { stroke: { width: pt(1.5), hollow: true }, color: { hex: '#123456', model: 'hex' } });
+        const p = layoutOne(el);
+        expect(p.stroke).toEqual({ widthPx: 1.5, color: '#123456', hollow: true });
+        const slot = layoutSlotToVdt(resolveDesignSlot({ elements: [el] }), container, 0, placeholders, DPI);
+        expect(slot.blocks[0].stroke).toEqual({ widthPx: 1.5, color: '#123456', hollow: true });
+    });
+    it('draws no outline for a zero width and follows a part palette override', () => {
+        expect(layoutOne(text('x', { stroke: { width: pt(0) } })).stroke).toBeUndefined();
+        const el = text('x', { stroke: { width: pt(1), color: { hex: '#000000', model: 'hex', paletteId: 'band' } } });
+        const recoloured = layoutDesignSlot(resolveDesignSlot({ elements: [el] }), { container, dpi: DPI, placeholders: { ...placeholders, partPaletteByPageIndex: [{ band: '#ff0000' }] } }, 0).primitives[0];
+        expect(recoloured.stroke).toEqual({ widthPx: 1, color: '#ff0000' });
+    });
+});
+//# sourceMappingURL=designText.test.js.map