postext 1.14.0 → 1.15.0

package/dist/__tests__/arabic/harakat.test.js

@@ -0,0 +1,167 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { buildDocument } from '../../pipeline';
+import { annotateArabicMarks, hasArabicMarks, lineWordInks, markInkOverhang } from '../../arabicMarks';
+import { columnClipRect } from '../../columnClip';
+// Issue #376: Arabic vowel marks live in the leading. Lines that carry them
+// record how far their ink reaches (`VDTLine.markInk`), the column clip takes
+// it in, and a paragraph whose marks meet the next line is reported.
+/** Ink metrics the stub measurer gives (`null`: none, as a measurer
+ *  without `actualBoundingBox*`). */
+let inkMetrics = null;
+class StubCtx {
+    font = '';
+    measureText(s) {
+        const width = s.length * 7;
+        if (!inkMetrics)
+            return { width };
+        const size = Number(/(\d*\.?\d+)px/.exec(this.font)?.[1] ?? 16);
+        const ink = inkMetrics(s, size);
+        return { width, actualBoundingBoxAscent: ink.ascent, actualBoundingBoxDescent: ink.descent, actualBoundingBoxLeft: 0, actualBoundingBoxRight: width };
+    }
+}
+globalThis.OffscreenCanvas = class {
+    getContext() {
+        return new StubCtx();
+    }
+};
+beforeEach(() => {
+    inkMetrics = null;
+});
+const pt = (value) => ({ value, unit: 'pt' });
+// Fully vocalised words (fatḥa, kasra, shadda, sukūn, dagger alef), with a
+// Latin marker word in each paragraph so lines can be told apart.
+const VOCALISED = 'بِسْمِ اللَّهِ الرَّحْمَٰنِ الرَّحِيمِ';
+const BARE = 'بسم الله الرحمن الرحيم';
+const para = (words, marker) => `${marker} ${Array.from({ length: 8 }, () => words).join(' ')}`;
+function config(lineHeight, extra = {}) {
+    return {
+        locale: 'ar',
+        page: { width: pt(300), height: pt(400), margins: { top: pt(30), bottom: pt(30), left: pt(30), right: pt(30) } },
+        layout: { layoutType: 'single' },
+        bodyText: { fontFamily: 'Amiri', fontSize: pt(12), lineHeight: { value: lineHeight, unit: 'em' } },
+        ...extra,
+    };
+}
+const kinds = (doc) => (doc.contentWarnings ?? []).filter((w) => w.kind === 'arabicMarksExceedLeading');
+const allLines = (doc) => doc.blocks.flatMap((b) => b.lines);
+describe('Arabic vowel marks — detection', () => {
+    it('knows the ḥarakāt, the dagger alef and the Qurʾānic marks, and not the letters', () => {
+        for (const mark of ['َ', 'ُ', 'ِ', 'ّ', 'ْ', 'ً', 'ٰ', 'ۖ', 'ؐ']) {
+            expect(hasArabicMarks(`ب${mark}`)).toBe(true);
+        }
+        // Hamza and madda letters, tatweel, the end-of-āya sign and Latin are not marks.
+        for (const text of ['أ إ آ ؤ ئ ء', 'ـــ', '۝', BARE, 'alpha 123'])
+            expect(hasArabicMarks(text)).toBe(false);
+    });
+});
+describe('Arabic vowel marks — leading check', () => {
+    it('reports a vocalised paragraph set solid, once, on the lower line', () => {
+        const doc = buildDocument({ markdown: [para(VOCALISED, 'ALPHA'), para(VOCALISED, 'BETA')].join('\n\n') }, config(1.2));
+        const warnings = kinds(doc);
+        expect(warnings.length).toBeGreaterThanOrEqual(1);
+        const w = warnings[0];
+        if (w.kind !== 'arabicMarksExceedLeading')
+            throw new Error('kind');
+        expect(w.lineHeightEm).toBeCloseTo(1.2, 2);
+        expect(w.neededEm).toBeGreaterThan(1.2);
+        expect(w.pageIndex).toBe(0);
+        expect(w.sourceStart).toBeDefined();
+        // One per paragraph at most.
+        const starts = warnings.map((x) => x.sourceStart);
+        expect(new Set(starts).size).toBe(starts.length);
+    });
+    it('says nothing with the leading a vocalised text wants', () => {
+        const doc = buildDocument({ markdown: [para(VOCALISED, 'ALPHA'), para(VOCALISED, 'BETA')].join('\n\n') }, config(2));
+        expect(kinds(doc)).toEqual([]);
+        // The marked lines still carry their ink.
+        expect(allLines(doc).filter((l) => l.markInk).length).toBeGreaterThan(0);
+    });
+    it('leaves unvocalised Arabic and Latin text alone', () => {
+        const bare = buildDocument({ markdown: [para(BARE, 'ALPHA'), para(BARE, 'BETA')].join('\n\n') }, config(1.2));
+        expect(kinds(bare)).toEqual([]);
+        expect(allLines(bare).some((l) => l.markInk)).toBe(false);
+        const latin = buildDocument({ markdown: 'Alpha beta gamma delta. '.repeat(40) }, { ...config(1.2), locale: 'en' });
+        expect(latin.contentWarnings).toBeUndefined();
+        expect(allLines(latin).some((l) => 'markInk' in l)).toBe(false);
+    });
+    it('reads the glyphs’ ink when the measurer gives it', () => {
+        // Marks 1.6 em above the baseline: even 2 em of leading is too little
+        // over a line hanging 0.6 em.
+        inkMetrics = (text, size) => (hasArabicMarks(text) ? { ascent: 1.6 * size, descent: 0.6 * size } : { ascent: 0.7 * size, descent: 0.2 * size });
+        const doc = buildDocument({ markdown: [para(VOCALISED, 'ALPHA'), para(VOCALISED, 'BETA')].join('\n\n') }, config(2));
+        const w = kinds(doc)[0];
+        expect(w).toBeDefined();
+        if (w?.kind !== 'arabicMarksExceedLeading')
+            throw new Error('kind');
+        expect(w.neededEm).toBeCloseTo(2.2, 2);
+        const marked = allLines(doc).find((l) => l.markInk);
+        expect(marked.markInk.above / marked.markInk.below).toBeCloseTo(1.6 / 0.6, 3);
+    });
+});
+/** A line of words at given x, `width` each, on `baseline`. */
+function line(baseline, words, width = 40) {
+    const segments = words.flatMap((w, i) => [
+        ...(i > 0 ? [{ kind: 'space', text: ' ', width: w.x - (words[i - 1].x + width) }] : []),
+        { kind: 'text', text: w.text, width },
+    ]);
+    const x = words[0].x;
+    return {
+        text: words.map((w) => w.text).join(' '),
+        bbox: { x, y: baseline - 12, width: words[words.length - 1].x + width - x, height: 16 },
+        baseline,
+        hyphenated: false,
+        segments,
+        isLastLine: true,
+    };
+}
+function docOf(lines, col = {}) {
+    const block = {
+        id: 'b', type: 'paragraph', bbox: { x: 0, y: 0, width: 400, height: 100 }, lines,
+        pageIndex: 0, columnIndex: 0, fontString: '400 16px Amiri', textAlign: 'left',
+    };
+    const column = { bbox: { x: 0, y: 0, width: 400, height: 100 }, blocks: [block], ...col };
+    return { blocks: [block], pages: [{ columns: [column] }] };
+}
+describe('Arabic vowel marks — word by word', () => {
+    it('compares only words that stand over each other', () => {
+        // Every word: 1.2 em up with a mark, 0.6 em down; 1.5 em pitch.
+        inkMetrics = (text, size) => (hasArabicMarks(text) ? { ascent: 1.2 * size, descent: 0.6 * size } : { ascent: 0.7 * size, descent: 0.3 * size });
+        const upper = line(20, [{ x: 0, text: 'بِسْمِ' }]);
+        const apart = line(44, [{ x: 200, text: 'اللَّهِ' }]);
+        expect(annotateArabicMarks(docOf([upper, apart]))).toEqual([]);
+        const over = line(44, [{ x: 20, text: 'اللَّهِ' }]);
+        const found = annotateArabicMarks(docOf([line(20, [{ x: 0, text: 'بِسْمِ' }]), over]));
+        expect(found).toHaveLength(1);
+        expect(found[0]).toMatchObject({ kind: 'arabicMarksExceedLeading', lineHeightEm: 1.5, neededEm: 1.8 });
+    });
+    it('follows the line’s flow order', () => {
+        const l = line(20, [{ x: 0, text: 'alpha' }, { x: 50, text: 'بِسْمِ' }]);
+        l.order = [2, 1, 0];
+        const block = { bbox: { x: 0, y: 0, width: 400, height: 20 }, fontString: '400 16px Amiri', textAlign: 'left' };
+        const words = lineWordInks(l, block);
+        // The Arabic word is painted first now, at the line's start.
+        expect(words.map((w) => w.x0)).toEqual([50, 0]);
+        expect(words.map((w) => w.marked)).toEqual([false, true]);
+    });
+});
+describe('Arabic vowel marks — column clip', () => {
+    it('grows the clip over the marks of the first line and under those of the last', () => {
+        const first = line(14, [{ x: 0, text: 'بِسْمِ' }]);
+        const last = line(96, [{ x: 0, text: 'الرَّحِيمِ' }]);
+        first.markInk = { above: 20, below: 6 };
+        last.markInk = { above: 20, below: 10 };
+        const doc = docOf([first, last]);
+        const col = doc.pages[0].columns[0];
+        expect(markInkOverhang(col.blocks, 0, 100)).toEqual([6, 6]);
+        const clip = columnClipRect(col, 96, false);
+        expect(clip.y).toBeCloseTo(-6);
+        expect(clip.height).toBeCloseTo(112);
+    });
+    it('keeps the clip of a column without marks', () => {
+        const doc = docOf([line(14, [{ x: 0, text: 'alpha' }]), line(96, [{ x: 0, text: 'beta' }])]);
+        const clip = columnClipRect(doc.pages[0].columns[0], 96, false);
+        expect(clip.y).toBe(0);
+        expect(clip.height).toBe(100);
+    });
+});
+//# sourceMappingURL=harakat.test.js.map

package/dist/__tests__/arabic/harakat.test.js.map

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

package/dist/__tests__/arabic/ornateBrackets.test.d.ts

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

package/dist/__tests__/arabic/ornateBrackets.test.d.ts.map

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

package/dist/__tests__/arabic/ornateBrackets.test.js

@@ -0,0 +1,71 @@
+import { describe, it, expect } from 'vitest';
+import { buildDocument } from '../../pipeline';
+import { mirroredChar, resolveParagraph } from '../../bidi';
+// #401: the ornate parentheses of Qurʾān quotations, ﴿ (U+FD3F, opening
+// since Unicode 14) and ﴾ (U+FD3E, closing), are not mirrored and are not
+// paired brackets (they are not in BidiBrackets.txt): rules N1/N2 resolve
+// them like any neutral. Their glyphs are drawn for right-to-left text,
+// ﴿ to stand on the right of the words it opens.
+//
+// In a left-to-right paragraph a quotation typed ﴿…﴾ between Latin words
+// has its brackets at the paragraph's level (N2: Latin on one side, Arabic
+// on the other), so ﴿ stands on the left with its right-hand shape and the
+// pair reads reversed. Browsers do the same, since it is what UAX #9 says.
+// The quotation set as a right-to-left isolate, `:rtl[﴿…﴾]`, puts both
+// brackets inside its run, ﴿ on the right.
+class StubCtx {
+    font = '';
+    measureText(s) {
+        return { width: s.length * 7 };
+    }
+}
+globalThis.OffscreenCanvas = class {
+    getContext() {
+        return new StubCtx();
+    }
+};
+const pt = (value) => ({ value, unit: 'pt' });
+const config = {
+    locale: 'en',
+    page: { width: pt(400), height: pt(300), margins: { top: pt(20), bottom: pt(20), left: pt(20), right: pt(20) } },
+    layout: { layoutType: 'single' },
+    bodyText: { firstLineIndent: pt(0), textAlign: 'left' },
+};
+const OPEN = '﴿';
+const CLOSE = '﴾';
+/** The line's characters as painted, left to right: segments in `order`,
+ *  a right-to-left segment's characters reversed. */
+function painted(line) {
+    const segs = line.segments;
+    return (line.order ?? segs.map((_, i) => i))
+        .map((i) => segs[i])
+        .map((s) => (s.rtl ? Array.from(s.text).reverse().map(mirroredChar).join('') : s.text))
+        .join('');
+}
+describe('#401: ornate Qurʾān parentheses', () => {
+    it('are neutrals that are never mirrored', () => {
+        expect(mirroredChar(OPEN)).toBe(OPEN);
+        expect(mirroredChar(CLOSE)).toBe(CLOSE);
+        // In a right-to-left paragraph ﴿ comes first and stands on the right.
+        const rtl = resolveParagraph(`${OPEN}بسم الله${CLOSE}`, 'rtl');
+        expect(rtl.levels[0]).toBe(1);
+        expect(rtl.levels[rtl.levels.length - 1]).toBe(1);
+    });
+    it('in a left-to-right paragraph, resolve to its level beside a Latin word (UAX #9 N2)', () => {
+        const doc = buildDocument({ markdown: `See ${OPEN}بسم الله${CLOSE} here` }, config);
+        const line = doc.blocks[0].lines[0];
+        const out = painted(line);
+        // ﴿ on the left of the Arabic run, ﴾ on its right: the pair reads
+        // reversed, as in a browser.
+        expect(out.indexOf(OPEN)).toBeLessThan(out.indexOf(CLOSE));
+    });
+    it('set as a right-to-left isolate, stand ﴿ on the right', () => {
+        const doc = buildDocument({ markdown: `See :rtl[${OPEN}بسم الله${CLOSE}] here` }, config);
+        const line = doc.blocks[0].lines[0];
+        const out = painted(line);
+        expect(out.indexOf(CLOSE)).toBeLessThan(out.indexOf(OPEN));
+        expect(out.startsWith('See ')).toBe(true);
+        expect(out.endsWith(' here')).toBe(true);
+    });
+});
+//# sourceMappingURL=ornateBrackets.test.js.map

package/dist/__tests__/arabic/ornateBrackets.test.js.map

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

package/dist/__tests__/arabic/tashkil.test.d.ts

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

package/dist/__tests__/arabic/tashkil.test.d.ts.map

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

package/dist/__tests__/arabic/tashkil.test.js

@@ -0,0 +1,106 @@
+import { describe, it, expect } from 'vitest';
+import { buildDocument } from '../../pipeline';
+import { collectConfigWarnings } from '../../configWarnings';
+import { stripConfigDefaults } from '../../defaults';
+import { resolveBodyTextConfig } from '../../defaults/bodyText';
+import { parseMarkdown } from '../../parse';
+import { stripBlockTashkil, stripTashkil, tashkilFor } from '../../pipeline/tashkil';
+// Issue #376: `bodyText.tashkil` takes the Arabic vowel marks out of the text
+// the layout sets, the source map kept right.
+class StubCtx {
+    font = '';
+    measureText(s) {
+        return { width: s.length * 7 };
+    }
+}
+globalThis.OffscreenCanvas = class {
+    getContext() {
+        return new StubCtx();
+    }
+};
+const pt = (value) => ({ value, unit: 'pt' });
+// بِسْمِ اللَّهِ / هٰذا (dagger alef) / مُحَمَّدٌ (shadda + tanwīn) / أُمّ, إِلى,
+// آمَنَ with the hamza and madda letters; ۚ a Qurʾānic pause mark.
+const VOCALISED = 'بِسْمِ اللَّهِ هٰذا مُحَمَّدٌ أُمّ إِلى آمَنَ ۚ';
+describe('stripTashkil', () => {
+    it("takes every vowel and Qurʾānic mark out under 'strip'", () => {
+        expect(stripTashkil(VOCALISED, 'strip')).toBe('بسم الله هذا محمد أم إلى آمن ');
+    });
+    it("keeps the shadda under 'strip-vowels'", () => {
+        expect(stripTashkil(VOCALISED, 'strip-vowels')).toBe('بسم اللّه هذا محمّد أمّ إلى آمن ');
+    });
+    it('leaves one space where a lone mark stood between two words', () => {
+        expect(stripTashkil('آمَنَ ۚ قال', 'strip')).toBe('آمن قال');
+        expect(stripTashkil('ۚ قال', 'strip')).toBe('قال');
+    });
+    it('keeps hamza and madda written as combining marks, and Latin text', () => {
+        // ا + U+0654 hamza above, ا + U+0655 hamza below, ا + U+0653 madda.
+        expect(stripTashkil('أَ إِ آ Café', 'strip')).toBe('أ إ آ Café');
+    });
+});
+describe('stripBlockTashkil', () => {
+    const md = '# ALPHA بِسْمِ\n\nBETA *اللَّهِ* [مُحَمَّدٌ](https://x.test) GAMMA';
+    const blocks = parseMarkdown(md);
+    it('keeps text, spans and source map in step', () => {
+        for (const block of blocks) {
+            const out = stripBlockTashkil(block, 'strip');
+            expect(out.spans.map((s) => s.text).join('')).toBe(out.text);
+            expect(out.sourceMap.length).toBe(out.text.length);
+            // Each character left maps to the same character of the source.
+            for (let i = 0; i < out.text.length; i++)
+                expect(md[out.sourceMap[i]]).toBe(out.text[i]);
+        }
+    });
+    it('moves link ranges with their text', () => {
+        const para = stripBlockTashkil(blocks[1], 'strip');
+        const link = para.spans.find((s) => s.links);
+        const l = link.links[0];
+        expect(link.text.slice(l.start, l.end)).toBe('محمد');
+    });
+    it('returns the same blocks when nothing changes', () => {
+        expect(tashkilFor(blocks, 'keep')).toBe(blocks);
+        expect(tashkilFor(blocks, undefined)).toBe(blocks);
+        const bare = parseMarkdown("Alpha بسم");
+        expect(tashkilFor(bare, 'strip')).toBe(bare);
+        // Memoised: the outline and the layout get the same array.
+        expect(tashkilFor(blocks, 'strip')).toBe(tashkilFor(blocks, 'strip'));
+    });
+});
+describe('bodyText.tashkil — config and layout', () => {
+    const config = (tashkil) => ({
+        locale: 'ar',
+        page: { width: pt(300), height: pt(400), margins: { top: pt(30), bottom: pt(30), left: pt(30), right: pt(30) } },
+        layout: { layoutType: 'single' },
+        bodyText: { fontFamily: 'Amiri', ...(tashkil ? { tashkil } : {}) },
+    });
+    it('resolves, keeping the default absent, and warns about an unknown value', () => {
+        expect('tashkil' in resolveBodyTextConfig(undefined, 'ar')).toBe(false);
+        expect('tashkil' in resolveBodyTextConfig({ tashkil: 'keep' }, 'ar')).toBe(false);
+        expect(resolveBodyTextConfig({ tashkil: 'strip-vowels' }, 'ar').tashkil).toBe('strip-vowels');
+        expect(stripConfigDefaults({ bodyText: { tashkil: 'keep' } }).bodyText).toBeUndefined();
+        expect(stripConfigDefaults({ bodyText: { tashkil: 'strip' } }).bodyText).toEqual({ tashkil: 'strip' });
+        const bad = { bodyText: { tashkil: 'none' } };
+        expect(collectConfigWarnings(bad)).toContainEqual({ kind: 'unknownConfigValue', path: 'bodyText.tashkil', value: 'none', used: 'keep' });
+    });
+    it('sets the text, the headings and the contents without the marks', () => {
+        const md = `:::toc\n:::\n\n# ALPHA بِسْمِ\n\nBETA ${VOCALISED} GAMMA`;
+        const kept = buildDocument({ markdown: md }, config());
+        const stripped = buildDocument({ markdown: md }, config('strip'));
+        const text = (doc) => doc.blocks.flatMap((b) => b.lines.map((l) => l.text)).join('\n');
+        expect(text(kept)).toContain('بِسْمِ');
+        expect(text(stripped)).not.toMatch(/[ً-ْٰ]/);
+        expect(text(stripped)).toContain('ALPHA بسم');
+        expect(text(stripped)).toContain('هذا محمد');
+        // No marks left, so nothing for the leading check either.
+        expect(stripped.blocks.some((b) => b.lines.some((l) => l.markInk))).toBe(false);
+    });
+    it('maps every line back to its source range', () => {
+        const md = `BETA ${VOCALISED} GAMMA`;
+        const doc = buildDocument({ markdown: md }, config('strip'));
+        const lines = doc.blocks.flatMap((b) => b.lines);
+        expect(lines[0].sourceStart).toBe(0);
+        const last = lines[lines.length - 1];
+        expect(md.slice(0, last.sourceEnd)).toMatch(/GAMMA$/);
+    });
+});
+//# sourceMappingURL=tashkil.test.js.map

package/dist/__tests__/arabic/tashkil.test.js.map

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

package/dist/__tests__/arabicLocale.test.d.ts

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

package/dist/__tests__/arabicLocale.test.d.ts.map

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