postext 1.4.1 → 1.5.0

package/dist/__tests__/pipeline/lineSourceEdges.test.js

@@ -0,0 +1,143 @@
+import { describe, it, expect } from 'vitest';
+import { buildDocument } from '../../pipeline';
+import { stampSourceRanges } from '../../pipeline/buildHelpers';
+import { computeSourceMap, parseMarkdown } from '../../parse';
+import { createBoundingBox } from '../../vdt';
+// Deterministic stub: every character, the space included, is 7 px wide;
+// bold ones 8 px.
+class StubCtx {
+    font = '';
+    measureText(s) {
+        return { width: s.length * (/bold|700/.test(this.font) ? 8 : 7) };
+    }
+}
+globalThis.OffscreenCanvas = class {
+    getContext() {
+        return new StubCtx();
+    }
+};
+const mm = (value) => ({ value, unit: 'mm' });
+function linesAt(markdown, width, textAlign = 'left', hyphenate = true) {
+    return buildDocument({ markdown }, {
+        page: { width: mm(width), height: mm(400), margins: { top: mm(5), bottom: mm(5), left: mm(5), right: mm(5) } },
+        layout: { layoutType: 'single' },
+        bodyText: { textAlign, firstLineIndent: mm(0), hyphenation: { enabled: hyphenate, ragged: hyphenate } },
+        header: { elements: [] },
+        footer: { elements: [] },
+    }).blocks.flatMap((b) => b.lines);
+}
+// EF-177: the dictionary puts a zero-width space after every slash of a word
+// it hyphenates. It must reach neither a line's text nor its segments, and
+// the lines' source offsets must follow the source.
+describe('web addresses and slashes in hyphenated text (EF-177)', () => {
+    const URL_MD = 'The timetable is posted at both slips and at https://aldercounty.example/nightferry today.';
+    const SLASH_MD = 'Each input/output channel and every read/write head reports its state to the controller/supervisor.';
+    for (const [name, md] of [['a web address', URL_MD], ['words joined by a slash', SLASH_MD], ['a web address, formatted', URL_MD.replace('posted', '**posted**')], ['words joined by a slash, formatted', SLASH_MD.replace('Each', '**Each**')]]) {
+        for (const textAlign of ['left', 'justify']) {
+            it(`keeps U+200B out of the lines and the offsets on the source (${name}, ${textAlign})`, () => {
+                for (let width = 30; width <= 80; width += 2) {
+                    const lines = linesAt(md, width, textAlign);
+                    let covered = '';
+                    for (const [i, line] of lines.entries()) {
+                        expect(line.text, `${width} mm`).not.toMatch(/​/);
+                        for (const seg of line.segments ?? [])
+                            expect(seg.text, `${width} mm`).not.toMatch(/​/);
+                        const src = md.slice(line.sourceStart, line.sourceEnd).replace(/\*\*/g, '');
+                        const printed = line.hyphenated && !line.hardHyphen ? line.text.replace(/-$/, '') : line.text;
+                        expect(src, `${width} mm, line ${i}`).toBe(printed.trimEnd());
+                        if (i > 0) {
+                            // Nothing but the space a break consumed lies between two lines.
+                            const gap = md.slice(lines[i - 1].sourceEnd, line.sourceStart);
+                            expect(gap === '' || gap === ' ', `${width} mm, line ${i}: ${JSON.stringify(gap)}`).toBe(true);
+                        }
+                        covered += src;
+                    }
+                    expect(covered.replace(/\s/g, '')).toBe(md.replace(/\*\*/g, '').replace(/\s/g, ''));
+                }
+            });
+        }
+    }
+    it('does not let a zero-width character the line holds, and the text lacks, move the offsets', () => {
+        // A measurer that leaves a U+200B in a line (as 1.4's rich path did
+        // after a slash) must not shift the offsets of that line or the next.
+        const text = 'see https://a.example/b now';
+        const block = {
+            type: 'paragraph',
+            text,
+            spans: [{ text, bold: false, italic: false }],
+            sourceStart: 0,
+            sourceEnd: text.length,
+            sourceMap: [...text].map((_, i) => i),
+        };
+        const line = (t, y) => ({ text: t, bbox: createBoundingBox(0, y, 10, 10), baseline: y + 8, hyphenated: false });
+        const measured = { lines: [line('see https://​a.example/', 0), line('b now', 10)], totalHeight: 20 };
+        measured.lines[0].hyphenated = true;
+        stampSourceRanges(measured, block, block, 0);
+        expect(text.slice(measured.lines[0].sourceStart, measured.lines[0].sourceEnd)).toBe('see https://a.example/');
+        expect(text.slice(measured.lines[1].sourceStart, measured.lines[1].sourceEnd)).toBe('b now');
+    });
+});
+// EF-178: a backslash escape (`\$`) prints one character. A line that opens
+// with it starts at the backslash, so no source character between two lines
+// belongs to neither.
+describe('a line that opens with an escaped character (EF-178)', () => {
+    const cases = [
+        'A car and driver pay \\$9, and a monthly pass costs \\$40.',
+        'A car and driver pay \\*9, and a monthly pass costs \\*40.',
+        'A car and *driver* pay \\$9, and a monthly pass costs \\$40 or \\_12 in \\~tildes\\~ and \\^carets\\^.',
+    ];
+    /** The source as printed: the escapes the body reads (`\$`, `\*`, `\_`,
+     *  `\^`, `\~`), emphasis markers dropped. */
+    const unescape = (s) => s.replace(/\\([$*_^~])|\*/g, (_, c) => c ?? '');
+    for (const md of cases) {
+        it(`covers the backslash: ${md.slice(0, 40)}…`, () => {
+            let openers = 0;
+            for (let width = 24; width <= 70; width += 1) {
+                for (const textAlign of ['left', 'justify']) {
+                    const lines = linesAt(md, width, textAlign, false);
+                    for (const [i, line] of lines.entries()) {
+                        const src = md.slice(line.sourceStart, line.sourceEnd);
+                        expect(unescape(src), `${width} mm, line ${i}`).toBe(line.text.trimEnd());
+                        if (i > 0) {
+                            const gap = md.slice(lines[i - 1].sourceEnd, line.sourceStart);
+                            expect(gap === '' || gap === ' ', `${width} mm, line ${i}: ${JSON.stringify(gap)}`).toBe(true);
+                            if (md[line.sourceStart] === '\\')
+                                openers++;
+                        }
+                    }
+                }
+            }
+            expect(openers).toBeGreaterThan(0);
+        });
+    }
+    it('keeps the per-character map on the escaped character (the Sandbox caret)', () => {
+        const [block] = parseMarkdown('pay \\$9');
+        expect(block.text).toBe('pay $9');
+        expect(block.sourceMap).toEqual([0, 1, 2, 3, 5, 6]);
+    });
+    it('starts at the second backslash when the first one is printed, and not at a literal one', () => {
+        // `\\*`: the body prints the first backslash and reads `\*` as an escape.
+        const md = 'Costs rise \\\\*40 and \\\\*50 in every quarter of the year while `a\\$b` stays literal.';
+        let seen = 0;
+        for (let width = 24; width <= 60; width += 1) {
+            const lines = linesAt(md, width, 'left', false);
+            for (const [i, line] of lines.entries()) {
+                if (i === 0)
+                    continue;
+                const gap = md.slice(lines[i - 1].sourceEnd, line.sourceStart);
+                expect(gap === '' || gap === ' ', `${width} mm, line ${i}: ${JSON.stringify(gap)}`).toBe(true);
+                if (line.text.startsWith('\\*')) {
+                    seen++;
+                    expect(md.slice(line.sourceStart, line.sourceStart + 3)).toBe('\\\\*');
+                }
+                if (line.text.startsWith('`') || line.text.startsWith('a\\$')) {
+                    expect(md[line.sourceStart]).not.toBe(' ');
+                }
+            }
+        }
+        expect(seen).toBeGreaterThan(0);
+        // A backslash in a code span is literal: the map is one to one there.
+        expect(computeSourceMap('`a\\$b`', 0, 6, 'a\\$b')).toEqual([1, 2, 3, 4]);
+    });
+});
+//# sourceMappingURL=lineSourceEdges.test.js.map

package/dist/__tests__/pipeline/lineSourceEdges.test.js.map

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

package/dist/__tests__/pipeline/lineSourceRanges.test.d.ts

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

package/dist/__tests__/pipeline/lineSourceRanges.test.d.ts.map

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

package/dist/__tests__/pipeline/lineSourceRanges.test.js

@@ -0,0 +1,96 @@
+import { describe, it, expect } from 'vitest';
+import { buildDocument } from '../../pipeline';
+// Deterministic text measurement stub (no DOM in the node test env): every
+// character, the space included, is 7 px wide.
+class StubCtx {
+    font = '';
+    measureText(s) {
+        return { width: s.length * 7 };
+    }
+}
+globalThis.OffscreenCanvas = class {
+    getContext() {
+        return new StubCtx();
+    }
+};
+/** A narrow single-column page, so paragraphs break often. */
+const config = {
+    page: { width: { value: 60, unit: 'mm' }, height: { value: 200, unit: 'mm' } },
+    layout: { layoutType: 'single' },
+    bodyText: { textAlign: 'left', hyphenation: { enabled: false } },
+};
+const linesOf = (markdown) => buildDocument({ markdown }, config).blocks.flatMap((b) => b.lines);
+// A line's source range is the text it prints. Where the break consumed a
+// space, the next line starts one character later; where it did not — between
+// two ideographs, inside a word cut for being wider than the line — it starts
+// right where the line ended, and no character is skipped.
+describe('line source ranges across breaks', () => {
+    it('stay contiguous across breaks between ideographs (plain path)', () => {
+        const md = '日本語の文章は単語の間に空白を入れずに書くので行はどの文字の間でも折り返すことができますがその位置を正しく記録しなければなりません。';
+        const lines = linesOf(md);
+        expect(lines.length).toBeGreaterThan(1);
+        for (let i = 1; i < lines.length; i++)
+            expect(lines[i].sourceStart).toBe(lines[i - 1].sourceEnd);
+        for (const line of lines)
+            expect(md.slice(line.sourceStart, line.sourceEnd)).toBe(line.text);
+    });
+    it('stay contiguous inside a word cut for being wider than the line', () => {
+        const word = 'Pneumonoultramicroscopicsilicovolcanoconiosis'.repeat(2);
+        const md = `A ${word} ends.`;
+        const lines = linesOf(md);
+        const cut = lines.filter((l) => /[a-z]$/i.test(l.text) && !l.isLastLine);
+        expect(cut.length).toBeGreaterThan(0);
+        const printed = lines.map((l) => md.slice(l.sourceStart, l.sourceEnd)).join('');
+        expect(printed.replace(/\s+/g, '')).toBe(md.replace(/\s+/g, ''));
+    });
+    it('skip the space a break consumes, as before', () => {
+        const md = 'The quick brown fox jumps over the lazy dog and keeps running across the field until night falls.';
+        const lines = linesOf(md);
+        expect(lines.length).toBeGreaterThan(2);
+        for (let i = 1; i < lines.length; i++) {
+            const end = lines[i - 1].sourceEnd;
+            expect(lines[i].sourceStart).toBe(end + 1);
+            expect(md[end]).toBe(' ');
+        }
+    });
+    it('keep a hard hyphen the line ends on (a formatted paragraph breaking at "chapter-relative")', () => {
+        const md = 'A **template** such as the one for chapter-relative numbers keeps chapter-relative numbering, and chapter-relative counters restart.';
+        for (const width of [44, 48, 52, 56, 60]) {
+            const doc = buildDocument({ markdown: md }, { ...config, page: { ...config.page, width: { value: width, unit: 'mm' } } });
+            const lines = doc.blocks.flatMap((b) => b.lines);
+            for (const line of lines) {
+                // The source range holds what the line prints, markup aside.
+                expect(md.slice(line.sourceStart, line.sourceEnd).replace(/\*\*/g, '')).toBe(line.text);
+            }
+        }
+    });
+    it('count an author soft hyphen inside a line, which the line does not print', () => {
+        const md = 'Protons react with water to give hydronium ions, so pH can be taken as the concen\u00ADtration of that latter chemical species, measured in moles per litre of solution.';
+        for (const width of [44, 50, 56, 62]) {
+            const doc = buildDocument({ markdown: md }, { ...config, page: { ...config.page, width: { value: width, unit: 'mm' } } });
+            for (const line of doc.blocks.flatMap((b) => b.lines)) {
+                expect(md.slice(line.sourceStart, line.sourceEnd).replace(/\u00AD/g, '')).toBe(line.text.trimEnd().replace(/-$/, ''));
+            }
+        }
+    });
+    it('count an author zero-width space the plain path does not print', () => {
+        // U+200B is a break opportunity: the plain path drops it from the line,
+        // the source keeps it. Justified text used to drift even before.
+        const md = 'The quick brown fox jumps\u200Bover the lazy dog and keeps running across the field until night falls.';
+        for (const textAlign of ['left', 'justify']) {
+            for (const width of [50, 60, 70]) {
+                const doc = buildDocument({ markdown: md }, {
+                    ...config,
+                    page: { ...config.page, width: { value: width, unit: 'mm' } },
+                    bodyText: { ...config.bodyText, textAlign },
+                });
+                const lines = doc.blocks.flatMap((b) => b.lines);
+                expect(lines.length).toBeGreaterThan(1);
+                for (const line of lines) {
+                    expect(md.slice(line.sourceStart, line.sourceEnd).replace(/\u200B/g, '')).toBe(line.text.replace(/\u200B/g, '').trimEnd());
+                }
+            }
+        }
+    });
+});
+//# sourceMappingURL=lineSourceRanges.test.js.map

package/dist/__tests__/pipeline/lineSourceRanges.test.js.map

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

package/dist/__tests__/pipeline/listTopSnap.test.d.ts

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

package/dist/__tests__/pipeline/listTopSnap.test.d.ts.map

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

package/dist/__tests__/pipeline/listTopSnap.test.js

@@ -0,0 +1,90 @@
+import { describe, it, expect } from 'vitest';
+import { buildDocument } from '../../pipeline/build';
+import { createMeasurementCache } from '../../measure';
+import { resolveUnorderedListsConfig, resolveOrderedListsConfig, resolveBodyTextConfig, stripUnorderedListsDefaults, stripOrderedListsDefaults } from '../../defaults';
+// Deterministic text measurement stub (no DOM in the node test env).
+class StubCtx {
+    font = '';
+    measureText(s) {
+        return { width: s.length * 7 };
+    }
+}
+globalThis.OffscreenCanvas = class {
+    getContext() {
+        return new StubCtx();
+    }
+};
+// The EF-103 repro (baseline-grid-book-page): a 13.4 pt leading, where the
+// default 1.5 em list margins are not a whole number of lines.
+const pt = (value) => ({ value, unit: 'pt' });
+const mm = (value) => ({ value, unit: 'mm' });
+const config = (snap) => ({
+    page: { width: mm(120), height: mm(160), margins: { top: mm(15), bottom: mm(15), left: mm(15), right: mm(15) } },
+    layout: { layoutType: 'single' },
+    bodyText: { fontSize: pt(10), lineHeight: pt(13.4), firstLineIndent: pt(0) },
+    ...(snap === undefined ? {} : { unorderedLists: { snapTopToGrid: snap }, orderedLists: { snapTopToGrid: snap } }),
+});
+const markdown = [
+    'A paragraph before the list, one line.',
+    '- first bullet',
+    '- second bullet',
+    'Text between the lists.',
+    '1. first number',
+    '2. second number',
+    'A paragraph after the lists.',
+].join('\n\n');
+/** Offset (in grid lines, 0 ≤ x < 1) of each list item's first line from
+ *  the baseline grid of its column. */
+const offsets = (doc) => doc.pages.flatMap((p) => p.columns.flatMap((c) => c.blocks
+    .filter((b) => b.type === 'listItem')
+    .map((b) => {
+    const off = ((b.lines[0].bbox.y - c.bbox.y) / doc.baselineGrid) % 1;
+    return Math.min(off, 1 - off) < 1e-4 ? 0 : off;
+})));
+describe('unorderedLists / orderedLists.snapTopToGrid (EF-103)', () => {
+    it('is off by default, and stripped when off', () => {
+        expect(resolveUnorderedListsConfig(undefined, resolveBodyTextConfig()).snapTopToGrid).toBe(false);
+        expect(resolveOrderedListsConfig(undefined, resolveBodyTextConfig()).snapTopToGrid).toBe(false);
+        expect(stripUnorderedListsDefaults({ snapTopToGrid: false })).toBeUndefined();
+        expect(stripOrderedListsDefaults({ snapTopToGrid: true })).toEqual({ snapTopToGrid: true });
+    });
+    it('by default a list sits off the grid until it ends (1.4 behaviour)', () => {
+        const doc = buildDocument({ markdown }, config(), createMeasurementCache());
+        expect(offsets(doc).some((o) => o > 0)).toBe(true);
+        const off = buildDocument({ markdown }, config(false), createMeasurementCache());
+        expect(off.blocks.map((b) => b.bbox.y)).toEqual(doc.blocks.map((b) => b.bbox.y));
+    });
+    it('on, every item of both lists sits on the grid, the margin above at least the one set', () => {
+        const plain = buildDocument({ markdown }, config(), createMeasurementCache());
+        const doc = buildDocument({ markdown }, config(true), createMeasurementCache());
+        expect(offsets(doc)).toEqual([0, 0, 0, 0]);
+        // Rounded up: each list's first item sits at or below where it did.
+        const firsts = (d) => d.blocks.filter((b) => b.type === 'listItem' && b.bulletText !== undefined && /first/.test(b.lines[0].text)).map((b) => b.bbox.y);
+        const before = firsts(plain);
+        const after = firsts(doc);
+        expect(after).toHaveLength(2);
+        after.forEach((y, i) => expect(y).toBeGreaterThanOrEqual(before[i] - 0.01));
+        // The text after each list is back on the grid either way.
+        const para = doc.blocks.find((b) => b.type === 'paragraph' && b.lines[0].text.startsWith('A paragraph after'));
+        const col = doc.pages[para.pageIndex].columns[para.columnIndex];
+        expect(((para.bbox.y - col.bbox.y) / doc.baselineGrid) % 1).toBeCloseTo(0, 4);
+    });
+    it('a heading style can turn it on for its section, through its body style lists', () => {
+        const styled = {
+            ...config(),
+            headingStyles: [{
+                    id: 'snapped',
+                    bodyStyle: { unorderedLists: { snapTopToGrid: true }, orderedLists: { snapTopToGrid: true } },
+                }],
+        };
+        const md = `# Plain\n\n${markdown}\n\n# Snapped {style="snapped"}\n\n${markdown}`;
+        const doc = buildDocument({ markdown: md }, styled, createMeasurementCache());
+        const all = offsets(doc);
+        expect(all).toHaveLength(8);
+        // The first section keeps the document's lists (off the grid); the
+        // styled one snaps both of its lists.
+        expect(all.slice(0, 4).some((o) => o > 0)).toBe(true);
+        expect(all.slice(4)).toEqual([0, 0, 0, 0]);
+    });
+});
+//# sourceMappingURL=listTopSnap.test.js.map

package/dist/__tests__/pipeline/listTopSnap.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listTopSnap.test.js","sourceRoot":"","sources":["../../../src/__tests__/pipeline/listTopSnap.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAIvK,qEAAqE;AACrE,MAAM,OAAO;IACX,IAAI,GAAG,EAAE,CAAC;IACV,WAAW,CAAC,CAAS;QACnB,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IACjC,CAAC;CACF;AACA,UAAsD,CAAC,eAAe,GAAG;IACxE,UAAU;QACR,OAAO,IAAI,OAAO,EAAE,CAAC;IACvB,CAAC;CACF,CAAC;AAEF,2EAA2E;AAC3E,+DAA+D;AAC/D,MAAM,EAAE,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAa,EAAE,CAAC,CAAC;AAC/D,MAAM,EAAE,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAa,EAAE,CAAC,CAAC;AAC/D,MAAM,MAAM,GAAG,CAAC,IAAc,EAAiB,EAAE,CAAC,CAAC;IACjD,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;IAChH,MAAM,EAAE,EAAE,UAAU,EAAE,QAAQ,EAAE;IAChC,QAAQ,EAAE,EAAE,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE;IAC5E,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,CAAC;CAClH,CAAC,CAAC;AACH,MAAM,QAAQ,GAAG;IACf,wCAAwC;IACxC,gBAAgB;IAChB,iBAAiB;IACjB,yBAAyB;IACzB,iBAAiB;IACjB,kBAAkB;IAClB,8BAA8B;CAC/B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAEf;uCACuC;AACvC,MAAM,OAAO,GAAG,CAAC,GAAgB,EAAY,EAAE,CAC7C,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM;KACvD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC;KACpC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;IACT,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACjD,CAAC,CAAC,CAAC,CAAC,CAAC;AAET,QAAQ,CAAC,sDAAsD,EAAE,GAAG,EAAE;IACpE,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,CAAC,2BAA2B,CAAC,SAAS,EAAE,qBAAqB,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClG,MAAM,CAAC,yBAAyB,CAAC,SAAS,EAAE,qBAAqB,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChG,MAAM,CAAC,2BAA2B,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAC9E,MAAM,CAAC,yBAAyB,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,sBAAsB,EAAE,CAAC,CAAC;QAC5E,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,sBAAsB,EAAE,CAAC,CAAC;QACjF,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sFAAsF,EAAE,GAAG,EAAE;QAC9F,MAAM,KAAK,GAAG,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,sBAAsB,EAAE,CAAC,CAAC;QAC9E,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,sBAAsB,EAAE,CAAC,CAAC;QAChF,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,oEAAoE;QACpE,MAAM,MAAM,GAAG,CAAC,CAAc,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtK,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC9B,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QAC7E,2DAA2D;QAC3D,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAE,CAAC;QACjH,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,SAAU,CAAE,CAAC,OAAO,CAAC,IAAI,CAAC,WAAY,CAAE,CAAC;QACpE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8EAA8E,EAAE,GAAG,EAAE;QACtF,MAAM,MAAM,GAAkB;YAC5B,GAAG,MAAM,EAAE;YACX,aAAa,EAAE,CAAC;oBACd,EAAE,EAAE,SAAS;oBACb,SAAS,EAAE,EAAE,cAAc,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,YAAY,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE;iBAC9F,CAAC;SACH,CAAC;QACF,MAAM,EAAE,GAAG,cAAc,QAAQ,sCAAsC,QAAQ,EAAE,CAAC;QAClF,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,sBAAsB,EAAE,CAAC,CAAC;QAC9E,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QACzB,MAAM,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC5B,mEAAmE;QACnE,sCAAsC;QACtC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/pipeline/looseParagraphLimit.test.d.ts

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

package/dist/__tests__/pipeline/looseParagraphLimit.test.d.ts.map

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

package/dist/__tests__/pipeline/looseParagraphLimit.test.js

@@ -0,0 +1,63 @@
+import { describe, it, expect } from 'vitest';
+import { buildDocumentPass } from '../../pipeline/build';
+// Deterministic text measurement stub (no DOM in the node test env).
+class StubCtx {
+    font = '';
+    measureText(s) {
+        return { width: s.length * 7 };
+    }
+}
+globalThis.OffscreenCanvas = class {
+    getContext() {
+        return new StubCtx();
+    }
+};
+const long = 'measurement comprehensive interpretation extraordinary circumstances considerable temperature approximately investigation particularly responsibility understanding communication international development environmental administration'.split(' ');
+const short = 'the of and a to in is was for on that with as by it'.split(' ');
+const text = (n, seed) => `${Array.from({ length: n }, (_, i) => ((i * 3 + seed) % 4 === 0 ? long[(i * 7 + seed) % long.length] : short[(i * 5 + seed) % short.length])).join(' ')}.`;
+const pt = (value) => ({ value, unit: 'pt' });
+const MAX_WS = 1.6;
+const config = (width, tightenRunts = true) => ({
+    page: { dpi: 96, width: pt(width), height: pt(2000), margins: { top: pt(20), bottom: pt(20), left: pt(20), right: pt(20) } },
+    layout: { layoutType: 'single' },
+    bodyText: { textAlign: 'justify', hyphenation: { enabled: true, locale: 'en-us' }, maxWordSpacing: MAX_WS, firstLineIndent: pt(0), tightenRunts },
+    headings: { levels: [] },
+});
+const paragraph = (blocks) => blocks.find((b) => b.type === 'paragraph');
+/** Word spacing of the lines that stay justified. */
+const justified = (b) => b.lines.filter((l) => !l.isLastLine && !l.ragged && l.justifiedSpaceRatio !== undefined).map((l) => l.justifiedSpaceRatio);
+/** The paragraph as placed, set by the runt fix, and asked to run a line
+ *  long by the column balancing (looseness hint on content block 0). */
+const settings = (markdown, width) => {
+    const natural = paragraph(buildDocumentPass({ markdown }, config(width, false)).doc.blocks);
+    const placed = paragraph(buildDocumentPass({ markdown }, config(width)).doc.blocks);
+    const pass = buildDocumentPass({ markdown }, config(width), undefined, undefined, { balanceLooseness: new Map([[0, 1]]) });
+    return { natural, placed, loose: paragraph(pass.doc.blocks), outcome: pass.looseOutcome.get(0) };
+};
+describe('the loose-paragraph lever keeps within maxWordSpacing (EF-129)', () => {
+    it('refuses a line past the limit on a paragraph the runt fix set a line shorter', () => {
+        const { natural, placed, loose, outcome } = settings(text(49, 187), 230);
+        // Non-vacuous: the runt fix set this paragraph a line shorter.
+        expect(placed.lines.length).toBe(natural.lines.length - 1);
+        if (typeof outcome === 'number') {
+            expect(loose.lines.length).toBe(placed.lines.length + 1);
+            for (const r of justified(loose))
+                expect(r).toBeLessThanOrEqual(MAX_WS + 1e-6);
+        }
+        else {
+            // No setting gained the line within the limit: the paragraph stays as
+            // placed.
+            expect(outcome).toBeNull();
+            expect(loose.lines.map((l) => l.text)).toEqual(placed.lines.map((l) => l.text));
+        }
+    });
+    it('still gains the line when a setting within the limit exists', () => {
+        const { natural, placed, loose, outcome } = settings(text(40, 140), 260);
+        expect(placed.lines.length).toBe(natural.lines.length - 1);
+        expect(typeof outcome).toBe('number');
+        expect(loose.lines.length).toBe(placed.lines.length + 1);
+        for (const r of justified(loose))
+            expect(r).toBeLessThanOrEqual(MAX_WS + 1e-6);
+    });
+});
+//# sourceMappingURL=looseParagraphLimit.test.js.map

package/dist/__tests__/pipeline/looseParagraphLimit.test.js.map

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

package/dist/__tests__/pipeline/nestedListSpacing.test.d.ts

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

package/dist/__tests__/pipeline/nestedListSpacing.test.d.ts.map

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

package/dist/__tests__/pipeline/nestedListSpacing.test.js

@@ -0,0 +1,62 @@
+import { describe, it, expect } from 'vitest';
+import { buildDocument } from '../../pipeline/build';
+import { createMeasurementCache } from '../../measure';
+// Deterministic text measurement stub (no DOM in the node test env).
+class StubCtx {
+    font = '';
+    measureText(s) {
+        return { width: s.length * 7 };
+    }
+}
+globalThis.OffscreenCanvas = class {
+    getContext() {
+        return new StubCtx();
+    }
+};
+// EF-165 (product-manual-warnings): at 72 dpi a point is a pixel.
+const pt = (value) => ({ value, unit: 'pt' });
+const mm = (value) => ({ value, unit: 'mm' });
+const config = (ordered, unordered) => ({
+    page: { width: mm(120), height: mm(150), dpi: 72, margins: { top: mm(10), bottom: mm(10), left: mm(10), right: mm(10) } },
+    layout: { layoutType: 'single' },
+    bodyText: { fontSize: pt(10), lineHeight: pt(12), firstLineIndent: pt(0) },
+    orderedLists: { itemSpacing: pt(ordered), marginTop: pt(0), marginBottom: pt(0) },
+    unorderedLists: { itemSpacing: pt(unordered), marginTop: pt(0), marginBottom: pt(0) },
+    headings: { balancing: { enabled: false } },
+});
+const items = (doc) => doc.blocks.filter((b) => b.type === 'listItem');
+const gaps = (doc) => {
+    const list = items(doc);
+    return list.slice(1).map((b, i) => +(b.bbox.y - (list[i].bbox.y + list[i].bbox.height)).toFixed(4));
+};
+const build = (md, cfg) => buildDocument({ markdown: md }, cfg, createMeasurementCache());
+describe('the item after a nested list (EF-165)', () => {
+    it('takes its own list\'s itemSpacing, not the nested list\'s', () => {
+        const md = '1. One\n2. Two\n   - nested a\n   - nested b\n3. Three\n4. Four';
+        // One→Two, Two→a, a→b, b→Three, Three→Four.
+        expect(gaps(build(md, config(6, 0)))).toEqual([6, 6, 0, 6, 6]);
+    });
+    it('works the other way round, and across two levels', () => {
+        const md = '- One\n  1. first\n     - deep\n  2. second\n- Two';
+        // One→first (unordered 2), first→deep (ordered 8), deep→second
+        // (ordered 8), second→Two (unordered 2).
+        expect(gaps(build(md, config(8, 2)))).toEqual([2, 8, 8, 2]);
+        const skip = '- One\n  1. first\n     - deep\n- Two';
+        // deep (depth 3) → Two (depth 1): Two's list.
+        expect(gaps(build(skip, config(8, 2)))).toEqual([2, 8, 2]);
+    });
+    it('leaves lists whose levels share one spacing as they were', () => {
+        const md = '1. One\n2. Two\n   - nested a\n   - nested b\n3. Three';
+        expect(gaps(build(md, config(5, 5)))).toEqual([5, 5, 5, 5]);
+    });
+    it('follows the same rule inside a callout', () => {
+        const md = ':::callout\n1. One\n2. Two\n   - nested a\n   - nested b\n3. Three\n:::';
+        const doc = build(md, {
+            ...config(6, 0),
+            calloutStyles: [{ id: 'note', lists: { itemSpacing: pt(4) } }],
+        });
+        // A box sets one spacing for both kinds of list.
+        expect(gaps(doc)).toEqual([4, 4, 4, 4]);
+    });
+});
+//# sourceMappingURL=nestedListSpacing.test.js.map

package/dist/__tests__/pipeline/nestedListSpacing.test.js.map

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

package/dist/__tests__/pipeline/openerColumnStarts.test.d.ts

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

package/dist/__tests__/pipeline/openerColumnStarts.test.d.ts.map

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