postext 1.8.5 → 1.9.0

package/dist/__tests__/contentLocale.test.js

@@ -0,0 +1,167 @@
+import { describe, expect, it } from 'vitest';
+import { canonicalLocaleTag, matchContentLocale, sameContentLocale } from '../locale';
+import { pickChapterSpecs, pickLocaleOverrides, readBundle, resolveBundleConfigLocale, resolveBundleLocale } from '../bundle';
+// #198: a book in Traditional and Simplified Chinese (plus an English
+// translation) opened for a reader whose tag names a region, a script or
+// neither. The language subtag alone cannot tell the two editions apart.
+describe('canonicalLocaleTag', () => {
+    it('canonicalises case and separators, rejects malformed tags', () => {
+        expect(canonicalLocaleTag('zh-hant')).toBe('zh-Hant');
+        expect(canonicalLocaleTag('ZH-tw')).toBe('zh-TW');
+        expect(canonicalLocaleTag('pt_br')).toBe('pt-BR');
+        expect(canonicalLocaleTag(' es ')).toBe('es');
+        expect(canonicalLocaleTag('zh-hant-hk')).toBe('zh-Hant-HK');
+        expect(canonicalLocaleTag('e s')).toBeUndefined();
+        expect(canonicalLocaleTag('')).toBeUndefined();
+        expect(canonicalLocaleTag(undefined)).toBeUndefined();
+    });
+});
+describe('sameContentLocale', () => {
+    it('compares the script of Chinese tags, the language of the others', () => {
+        expect(sameContentLocale('zh-Hans', 'zh-Hant')).toBe(false);
+        expect(sameContentLocale('zh-TW', 'zh-Hant')).toBe(true);
+        expect(sameContentLocale('zh-HK', 'zh-Hant')).toBe(true);
+        expect(sameContentLocale('zh', 'zh-Hans')).toBe(true);
+        expect(sameContentLocale('zh-CN', 'zh-hans')).toBe(true);
+        expect(sameContentLocale('zh-TW', 'zh-Hans')).toBe(false);
+        expect(sameContentLocale('es-ES', 'es')).toBe(true);
+        expect(sameContentLocale('pt-BR', 'pt-PT')).toBe(true);
+        expect(sameContentLocale('en', 'es')).toBe(false);
+        expect(sameContentLocale('sr-Latn', 'sr')).toBe(false);
+    });
+});
+describe('matchContentLocale', () => {
+    const chinese = ['zh-Hans', 'zh-Hant', 'en'];
+    it('prefers the exact tag, then language + script, then the other script', () => {
+        expect(matchContentLocale(chinese, 'zh-hant')).toBe('zh-Hant');
+        expect(matchContentLocale(chinese, 'zh-TW')).toBe('zh-Hant');
+        expect(matchContentLocale(chinese, 'zh-HK')).toBe('zh-Hant');
+        expect(matchContentLocale(chinese, 'zh-Hant-TW')).toBe('zh-Hant');
+        expect(matchContentLocale(chinese, 'zh')).toBe('zh-Hans');
+        expect(matchContentLocale(chinese, 'zh-SG')).toBe('zh-Hans');
+        expect(matchContentLocale(chinese, 'es')).toBeUndefined();
+        expect(matchContentLocale(chinese, 'EN-us')).toBe('en');
+    });
+    it('falls back on the language in the other script, below every same-script tag', () => {
+        // A book keyed by bare `zh` (Simplified once maximised): a Taiwanese
+        // reader still reads Chinese, not the English next to it.
+        expect(matchContentLocale(['en', 'zh'], 'zh-TW')).toBe('zh');
+        expect(matchContentLocale(['en', 'zh'], 'zh-Hant')).toBe('zh');
+        expect(matchContentLocale(['zh-Hans', 'en'], 'zh-Hant')).toBe('zh-Hans');
+        expect(matchContentLocale(['zh-Hant', 'en'], 'zh-CN')).toBe('zh-Hant');
+        // The same script always wins, wherever it is listed.
+        expect(matchContentLocale(['zh', 'zh-Hant'], 'zh-HK')).toBe('zh-Hant');
+        expect(matchContentLocale(['zh-Hans', 'zh-Hant-HK'], 'zh-TW')).toBe('zh-Hant-HK');
+        expect(matchContentLocale(['sr-Latn', 'en'], 'sr')).toBe('sr-Latn');
+    });
+    it('keeps the old preferences of the other languages', () => {
+        // The bare base language before a regional sibling.
+        expect(matchContentLocale(['pt-BR', 'pt'], 'pt-AO')).toBe('pt');
+        expect(matchContentLocale(['es-MX', 'es'], 'es-AR')).toBe('es');
+        // The same region once maximised wins.
+        expect(matchContentLocale(['pt', 'pt-PT'], 'pt-PT')).toBe('pt-PT');
+        expect(matchContentLocale(['pt-PT', 'pt'], 'pt-BR')).toBe('pt');
+        // A regional sibling rather than nothing.
+        expect(matchContentLocale(['en-GB', 'es'], 'en-US')).toBe('en-GB');
+        // Ties keep the candidates' order.
+        expect(matchContentLocale(['es-MX', 'es-AR'], 'es-CL')).toBe('es-MX');
+    });
+});
+const chapterMap = (...locales) => Object.fromEntries(locales.map((l) => [l, [{ title: l, file: `chapters/${l}/01.md` }]]));
+const hlm = {
+    version: 2,
+    id: 'hlm',
+    name: 'Hong lou meng',
+    locale: 'zh-Hant',
+    locales: ['zh-Hant', 'zh-Hans', 'en'],
+    openLocale: 'zh-Hant',
+    chapters: chapterMap('zh-Hans', 'zh-Hant', 'en'),
+    localized: {
+        'zh-Hans': { config: { locale: 'zh-Hans' } },
+        en: { config: { locale: 'en' } },
+    },
+};
+describe('bundle locale resolution in a Chinese book (#198)', () => {
+    it('serves the edition in the script the tag names', () => {
+        const served = (l) => resolveBundleLocale(hlm, l);
+        expect(served('zh-Hant')).toBe('zh-Hant');
+        expect(served('zh-hant')).toBe('zh-Hant');
+        expect(served('zh-TW')).toBe('zh-Hant');
+        expect(served('zh-HK')).toBe('zh-Hant');
+        expect(served('zh')).toBe('zh-Hans');
+        expect(served('zh-CN')).toBe('zh-Hans');
+        expect(served('en-GB')).toBe('en');
+        // A language the book lacks: its own locale.
+        expect(served('es')).toBe('zh-Hant');
+        expect(pickChapterSpecs(hlm, 'zh-TW')[0].file).toBe('chapters/zh-Hant/01.md');
+        expect(resolveBundleConfigLocale(hlm, 'zh-SG')).toBe('zh-Hans');
+    });
+    it('rewords each edition with its own overrides', () => {
+        expect(pickLocaleOverrides(hlm, 'zh-TW')).toBeNull();
+        expect(pickLocaleOverrides(hlm, 'zh-CN')).toBe(hlm.localized['zh-Hans']);
+        expect(pickLocaleOverrides(hlm, 'en-US')).toBe(hlm.localized.en);
+        // Shared chapters: a Traditional reader never gets the Simplified wording.
+        const shared = { ...hlm, chapters: [{ title: '', file: 'a.md' }], localized: { 'zh-Hans': { config: {} } } };
+        expect(pickLocaleOverrides(shared, 'zh-TW')).toBeNull();
+        expect(pickLocaleOverrides(shared, 'zh')).toBe(shared.localized['zh-Hans']);
+        // Nor a Traditional edition served from a chapter map.
+        const mapped = { ...hlm, locale: 'en', chapters: chapterMap('en', 'zh-Hant'), localized: { 'zh-Hans': { config: {} } } };
+        expect(pickLocaleOverrides(mapped, 'zh-TW')).toBeNull();
+    });
+    it('serves a bundle keyed by bare `zh` to a Traditional reader (#198 review)', () => {
+        // develop served `zh` here; the script-aware matcher must not fall back
+        // on the manifest's own English.
+        const bare = { version: 2, id: 'bare', name: 'Bare', locale: 'en', chapters: chapterMap('en', 'zh') };
+        for (const wanted of ['zh-TW', 'zh-Hant', 'zh-HK', 'zh', 'zh-CN']) {
+            expect(resolveBundleLocale(bare, wanted)).toBe('zh');
+            expect(pickChapterSpecs(bare, wanted)[0].file).toBe('chapters/zh/01.md');
+        }
+        expect(resolveBundleLocale(bare, 'es')).toBe('en');
+        // With both scripts on offer the reader's own still wins.
+        expect(resolveBundleLocale({ ...bare, chapters: chapterMap('en', 'zh', 'zh-Hant') }, 'zh-TW')).toBe('zh-Hant');
+    });
+});
+describe('readBundle over a long book (#199)', () => {
+    const COUNT = 120;
+    const DELAY = 50;
+    const han = '此開卷第一回也作者自云因曾歷過一番夢幻之後故將真事隱去';
+    const specs = Array.from({ length: COUNT }, (_, i) => ({ title: `第${i + 1}回`, file: `chapters/zh-Hant/${String(i + 1).padStart(3, '0')}.md` }));
+    const manifest = {
+        version: 2, id: 'long', name: 'Long', locale: 'zh-Hant',
+        chapters: { 'zh-Hant': specs, 'zh-Hans': specs.map((s) => ({ ...s, file: s.file.replace('zh-Hant', 'zh-Hans') })) },
+    };
+    it('reads the chosen locale\'s chapters concurrently, in manifest order', async () => {
+        const read = [];
+        let inFlight = 0;
+        let peak = 0;
+        const readFile = async (path) => {
+            read.push(path);
+            inFlight++;
+            peak = Math.max(peak, inFlight);
+            // Later chapters answer sooner: order must come from the manifest.
+            const n = Number(/(\d+)\.md$/.exec(path)?.[1] ?? 0);
+            await new Promise((r) => setTimeout(r, DELAY - (n % 7) * 5));
+            inFlight--;
+            return new TextEncoder().encode(`# 第${n}回\n\n${han}`).buffer;
+        };
+        const t0 = Date.now();
+        const result = await readBundle(manifest, readFile, { locale: 'zh-TW' });
+        const elapsed = Date.now() - t0;
+        expect(result.locale).toBe('zh-Hant');
+        expect(result.chapters.map((c) => c.file)).toEqual(specs.map((s) => s.file));
+        expect(result.chapters[26].markdown.startsWith('# 第27回')).toBe(true);
+        expect(read.every((p) => p.includes('zh-Hant'))).toBe(true);
+        expect(peak).toBeGreaterThan(1);
+        expect(peak).toBeLessThanOrEqual(8);
+        expect(elapsed).toBeLessThan((COUNT * DELAY) / 4);
+    });
+    it('rejects when a chapter file is missing', async () => {
+        const readFile = async (path) => {
+            if (path.endsWith('060.md'))
+                throw new Error(`missing ${path}`);
+            return new TextEncoder().encode('# x').buffer;
+        };
+        await expect(readBundle(manifest, readFile, { locale: 'zh-Hant' })).rejects.toThrow(/060\.md/);
+    });
+});
+//# sourceMappingURL=contentLocale.test.js.map

package/dist/__tests__/contentLocale.test.js.map

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

package/dist/__tests__/defaults/cjk.test.d.ts

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

package/dist/__tests__/defaults/cjk.test.d.ts.map

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

package/dist/__tests__/defaults/cjk.test.js

@@ -0,0 +1,70 @@
+import { describe, it, expect } from 'vitest';
+import { resolveCjkConfig, stripCjkDefaults } from '../../defaults/cjk';
+import { cjkRegionOf } from '../../locale';
+import { stripConfigDefaults } from '../../defaults';
+import { resolveAllConfig } from '../../pipeline/config';
+describe('cjk config', () => {
+    it('reads the region from the locale', () => {
+        expect(cjkRegionOf('zh')).toBe('mainland');
+        expect(cjkRegionOf('zh-Hans')).toBe('mainland');
+        expect(cjkRegionOf('zh-CN')).toBe('mainland');
+        expect(cjkRegionOf('zh-SG')).toBe('mainland');
+        expect(cjkRegionOf('zh-Hans-CN')).toBe('mainland');
+        expect(cjkRegionOf('zh-Hant')).toBe('taiwan');
+        expect(cjkRegionOf('zh-TW')).toBe('taiwan');
+        expect(cjkRegionOf('zh-Hant-TW')).toBe('taiwan');
+        expect(cjkRegionOf('zh-HK')).toBe('hongkong');
+        expect(cjkRegionOf('zh-Hant-HK')).toBe('hongkong');
+        expect(cjkRegionOf('zh-MO')).toBe('hongkong');
+        expect(cjkRegionOf('zh-MY')).toBe('mainland');
+        expect(cjkRegionOf('zh-Hant-MY')).toBe('mainland');
+        expect(cjkRegionOf('zh_TW')).toBe('taiwan');
+        expect(cjkRegionOf('ja')).toBeUndefined();
+        expect(cjkRegionOf('es')).toBeUndefined();
+        expect(cjkRegionOf('not a tag!')).toBeUndefined();
+        expect(cjkRegionOf(undefined)).toBeUndefined();
+    });
+    it('resolves auto per region: gb on the mainland, basic in Taiwan and Hong Kong', () => {
+        expect(resolveCjkConfig(undefined, 'zh-Hans')).toMatchObject({ region: 'mainland', lineBreak: 'gb' });
+        expect(resolveCjkConfig(undefined, 'zh-TW')).toMatchObject({ region: 'taiwan', lineBreak: 'basic' });
+        expect(resolveCjkConfig(undefined, 'zh-HK')).toMatchObject({ region: 'hongkong', lineBreak: 'basic' });
+        expect(resolveCjkConfig(undefined, 'en')).toMatchObject({ region: 'mainland', lineBreak: 'gb' });
+        expect(resolveCjkConfig({ region: 'taiwan' }, 'zh-CN')).toMatchObject({ region: 'taiwan', lineBreak: 'basic' });
+        expect(resolveCjkConfig({ lineBreak: 'strict' }, 'zh-TW')).toMatchObject({ region: 'taiwan', lineBreak: 'strict' });
+        expect(resolveCjkConfig({ lineBreak: 'bogus', region: 'mars' }, 'zh-HK')).toMatchObject({ region: 'hongkong', lineBreak: 'basic' });
+    });
+    it('strips auto and keeps the rest', () => {
+        expect(stripCjkDefaults({ region: 'auto', lineBreak: 'auto' })).toBeUndefined();
+        expect(stripCjkDefaults({ region: 'auto', lineBreak: 'none' })).toEqual({ lineBreak: 'none' });
+        expect(stripConfigDefaults({ cjk: { region: 'auto' } }).cjk).toBeUndefined();
+        expect(stripConfigDefaults({ cjk: { region: 'hongkong' } }).cjk).toEqual({ region: 'hongkong' });
+        expect(stripCjkDefaults({
+            punctuationWidth: 'auto', compressAdjacent: 'auto', trimLineStart: 'auto', hangingPunctuation: 'none',
+            latinSpacing: { value: 0.25, unit: 'em' }, grid: { enabled: false, show: false },
+        })).toBeUndefined();
+        expect(stripCjkDefaults({ punctuationWidth: 'halfwidth', compressAdjacent: false, hangingPunctuation: 'allow', latinSpacing: { value: 0, unit: 'em' }, grid: { enabled: true, charsPerLine: 28 } }))
+            .toEqual({ punctuationWidth: 'halfwidth', compressAdjacent: false, hangingPunctuation: 'allow', latinSpacing: { value: 0, unit: 'em' }, grid: { enabled: true, charsPerLine: 28 } });
+    });
+    it('resolves the punctuation settings per region', () => {
+        expect(resolveCjkConfig(undefined, 'zh-CN')).toMatchObject({ punctuationWidth: 'kaiming', compressAdjacent: true, trimLineStart: true, hangingPunctuation: 'none' });
+        expect(resolveCjkConfig(undefined, 'zh-Hant-TW')).toMatchObject({ punctuationWidth: 'fullwidth', compressAdjacent: false, trimLineStart: false });
+        expect(resolveCjkConfig(undefined, 'zh-HK')).toMatchObject({ punctuationWidth: 'fullwidth', compressAdjacent: true, trimLineStart: true });
+        expect(resolveCjkConfig({ punctuationWidth: 'lineEndHalf', compressAdjacent: false, trimLineStart: 'auto' }, 'zh-HK'))
+            .toMatchObject({ punctuationWidth: 'lineEndHalf', compressAdjacent: false, trimLineStart: true });
+        expect(resolveCjkConfig({ punctuationWidth: 'odd', hangingPunctuation: 'sometimes' }, 'zh')).toMatchObject({ punctuationWidth: 'kaiming', hangingPunctuation: 'none' });
+        expect(resolveCjkConfig(undefined, 'zh').latinSpacing).toEqual({ value: 0.25, unit: 'em' });
+        expect(resolveCjkConfig({ latinSpacing: { value: -1, unit: 'em' } }, 'zh').latinSpacing).toEqual({ value: 0.25, unit: 'em' });
+        expect(resolveCjkConfig({ latinSpacing: { value: 2, unit: 'pt' } }, 'zh').latinSpacing).toEqual({ value: 2, unit: 'pt' });
+    });
+    it('resolves the grid only when it is on', () => {
+        expect(resolveCjkConfig(undefined, 'zh').grid).toEqual({ enabled: false, charsPerLine: 0, linesPerPage: 0, show: false });
+        expect(resolveCjkConfig({ grid: { charsPerLine: 28, show: true } }, 'zh').grid).toEqual({ enabled: false, charsPerLine: 0, linesPerPage: 0, show: false });
+        expect(resolveCjkConfig({ grid: { enabled: true, charsPerLine: 28.7, linesPerPage: '27', show: true } }, 'zh').grid)
+            .toEqual({ enabled: true, charsPerLine: 28, linesPerPage: 27, show: true });
+    });
+    it('is resolved with the document language', () => {
+        expect(resolveAllConfig({ locale: 'zh-Hant' }).cjk).toMatchObject({ region: 'taiwan', lineBreak: 'basic' });
+        expect(resolveAllConfig(undefined).cjk).toMatchObject({ region: 'mainland', lineBreak: 'gb' });
+    });
+});
+//# sourceMappingURL=cjk.test.js.map

package/dist/__tests__/defaults/cjk.test.js.map

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

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

@@ -102,5 +102,36 @@ describe('design text in HTML (EF-25)', () => {
         expect(html).toMatch(/>Ana<span style="font:[^"]*5\.8\d*px[^"]*;position:relative;top:-3\.33\dpx;">1<\/span> <span style="font:700 10px[^"]*;">bold<\/span>/);
         expect(html).toContain('-webkit-text-stroke:1px #aa0000;-webkit-text-fill-color:transparent;');
     });
+    it('turns the browser’s punctuation trimming off on the lines and runs holding CJK text only', () => {
+        // Each line (or run) was measured whole: 紅樓夢 without trimming, a
+        // Latin line or run with it.
+        const cjkConfig = {
+            ...config,
+            header: {
+                elements: [
+                    {
+                        kind: 'text', id: 'lines', content: '《紅樓夢》\n“end.”“Yes”', fontSize: pt(10), overflow: 'wrap',
+                        placement: { anchor: { to: 'container', edge: 'top-left' } },
+                    },
+                    {
+                        kind: 'text', id: 'runs', content: '**《紅樓夢》** “end.”“Yes”', fontSize: pt(10), inlineMarks: true, overflow: 'ellipsis-end',
+                        placement: { anchor: { to: 'container', edge: 'top-right' } },
+                    },
+                ],
+            },
+        };
+        const doc = buildDocument({ markdown: 'Body text.' }, cjkConfig);
+        const html = renderToHtmlIndexed(doc).pages[0].decorationHtml;
+        const decl = 'text-spacing-trim:space-all';
+        // Lines: the one holding CJK text turns it off, the Latin one not.
+        expect(html).toMatch(/white-space:pre;text-spacing-trim:space-all;[^"]*">《紅樓夢》<\/span>/);
+        expect(html).toContain('white-space:pre;">“end.”“Yes”</span>');
+        // Runs: the bold 《紅樓夢》 turns it off; the line box, and so the run
+        // after it, keep the browser's trimming.
+        expect(html).toMatch(/white-space:pre;"><span style="font:700 [^"]*;text-spacing-trim:space-all;[^"]*">《紅樓夢》<\/span> “end.”“Yes”<\/span>/);
+        // No block holds the declaration for all its lines.
+        for (const div of html.split('<div').slice(1))
+            expect(div.slice(0, div.indexOf('>'))).not.toContain(decl);
+    });
 });
 //# sourceMappingURL=designTextRender.test.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,126 @@
+import { describe, it, expect } from 'vitest';
+import { buildDocument } from '../../pipeline';
+import { renderToHtml } from '../../html-backend';
+// A picture a design draws (a chapter plate, a cover picture) carries its
+// resource's alternative text into the VDT and the HTML (#213); a
+// decorative one, or one whose resource has no text, stays decoration.
+class StubCtx {
+    font = '';
+    measureText(s) {
+        return { width: s.length * 7 };
+    }
+}
+globalThis.OffscreenCanvas = class {
+    getContext() {
+        return new StubCtx();
+    }
+};
+const pt = (value) => ({ value, unit: 'pt' });
+const picture = (id, extra = {}) => ({
+    id,
+    typeId: 'figure',
+    kind: 'bitmap',
+    createdAt: 0,
+    updatedAt: 0,
+    bitmap: { fileId: `${id}.png`, format: 'png', width: 400, height: 200 },
+    ...extra,
+});
+const resources = [
+    picture('log', { altText: '  A log on a riverbank ', caption: 'Not this caption.' }),
+    picture('wig', { caption: 'A **powdered** wig,\\\\ worn at court' }),
+    picture('bare'),
+];
+const plate = (extra = {}) => ({
+    kind: 'image',
+    id: 'plate',
+    resourceId: '{attr.art}',
+    placement: { anchor: { to: 'container', edge: 'top-left' }, size: { width: pt(100) } },
+    ...extra,
+});
+const title = {
+    kind: 'text', id: 'title', content: '{titleText}', fontSize: pt(20), overflow: 'wrap',
+    placement: { anchor: { to: 'container', edge: 'bottom-left' }, size: { width: 'fill' } },
+};
+const config = (elements, header = []) => ({
+    page: { dpi: 72, width: pt(400), height: pt(500), margins: { top: pt(40), bottom: pt(20), left: pt(20), right: pt(20) } },
+    layout: { layoutType: 'single' },
+    header: { elements: header },
+    footer: { elements: [] },
+    headings: { balancing: { enabled: false }, levels: [{ level: 1, breakBefore: { enabled: true, parity: 'any' } }] },
+    headingStyles: [{ id: 'opener', advancedDesign: { enabled: true, slot: { elements } } }],
+});
+const md = '# Chapter I {style="opener" art="log"}\n\nOne.\n\n# Chapter II {style="opener" art="wig"}\n\nTwo.\n\n# Chapter III {style="opener" art="bare"}\n\nThree.';
+/** The design image blocks of each chapter's heading, in order. */
+function plates(doc) {
+    return doc.blocks.filter((b) => b.type === 'heading').flatMap((b) => (b.designOverlay?.blocks ?? []).filter((d) => d.kind === 'image'));
+}
+const urls = { resourceImageUrl: (fileId) => `https://example.org/${fileId}` };
+describe('design images carry alternative text (#213)', () => {
+    it('takes the resource’s alt text, else its caption as plain text', () => {
+        const doc = buildDocument({ markdown: md, resources }, config([plate(), title]));
+        expect(plates(doc).map((p) => p.altText)).toEqual(['A log on a riverbank', 'A powdered wig, worn at court', undefined]);
+        // No text: no field at all.
+        expect('altText' in plates(doc)[2]).toBe(false);
+    });
+    it('gives a decorative picture none', () => {
+        const doc = buildDocument({ markdown: md, resources }, config([plate({ decorative: true }), title]));
+        expect(plates(doc).map((p) => p.altText)).toEqual([undefined, undefined, undefined]);
+    });
+    it('writes the text as the img alt in HTML, alt="" and role="presentation" otherwise', () => {
+        const doc = buildDocument({ markdown: md, resources }, config([plate(), title]));
+        const html = renderToHtml(doc, urls);
+        expect(html).toContain('<img src="https://example.org/log.png" alt="A log on a riverbank" style=');
+        expect(html).toContain('<img src="https://example.org/wig.png" alt="A powdered wig, worn at court" style=');
+        expect(html).toContain('<img src="https://example.org/bare.png" alt="" role="presentation" style=');
+        const decorative = renderToHtml(buildDocument({ markdown: md, resources }, config([plate({ decorative: true }), title])), urls);
+        expect(decorative).toContain('<img src="https://example.org/log.png" alt="" role="presentation" style=');
+        expect(decorative).not.toContain('riverbank');
+    });
+    it('escapes the text in HTML', () => {
+        const doc = buildDocument({ markdown: md, resources: [picture('log', { altText: 'A "log" & <river>' }), ...resources.slice(1)] }, config([plate(), title]));
+        expect(renderToHtml(doc, urls)).toContain('alt="A &quot;log&quot; &amp; &lt;river&gt;"');
+    });
+    it('keeps a running head’s or footer’s picture as furniture, as the tagged PDF does', () => {
+        // It repeats on every page: a screen reader would read it on each.
+        const logo = { ...plate(), placement: { anchor: { to: 'container', edge: 'top-left' }, size: { width: pt(40) } } };
+        const cfg = config([title], [logo]);
+        const doc = buildDocument({ markdown: md, resources }, { ...cfg, footer: { elements: [{ ...logo, id: 'foot' }] } });
+        const images = doc.pages.flatMap((p) => [p.header, p.footer].flatMap((slot) => (slot?.blocks ?? []).filter((b) => b.kind === 'image')));
+        expect(images).toHaveLength(6);
+        for (const img of images)
+            expect('altText' in img).toBe(false);
+        const html = renderToHtml(doc, urls);
+        expect(html).toContain('<img src="https://example.org/log.png" alt="" role="presentation" style=');
+        expect(html).not.toContain('riverbank');
+        expect(html).not.toContain('powdered');
+        // The same pictures in an opener keep their text.
+        expect(plates(buildDocument({ markdown: md, resources }, config([plate(), title], [logo]))).map((p) => p.altText))
+            .toEqual(['A log on a riverbank', 'A powdered wig, worn at court', undefined]);
+    });
+    it('reads a caption’s chips by their label and leaves no placeholder in the text', () => {
+        const captioned = (caption) => {
+            const doc = buildDocument({ markdown: '# Chapter I {style="opener" art="p"}\n\nOne.', resources: [picture('p', { caption })] }, config([plate(), title]));
+            return plates(doc)[0].altText;
+        };
+        expect(captioned('A :chip[tag]{style="x"} chip')).toBe('A tag chip');
+        expect(captioned('Key :swatch{color="#ff0000"} red')).toBe('Key red');
+        expect(captioned('See :ref{id="p" text="the plate"} again')).toBe('See the plate again');
+        expect(captioned('See :ref{id="p"}, again')).toBe('See , again');
+        // Captions are not parsed for maths: the dollar signs are printed, and
+        // read.
+        expect(captioned('Energy $E=mc^2$')).toBe('Energy $E=mc^2$');
+        // An ideographic space stays; runs of other spaces become one.
+        expect(captioned('第二回　賈夫人仙逝揚州城')).toBe('第二回　賈夫人仙逝揚州城');
+        for (const c of ['A :chip[tag]{style="x"} chip', 'Key :swatch{color="#ff0000"} red', 'See :ref{id="p"} again']) {
+            expect(captioned(c)).not.toMatch(/[\uE000-\uF8FF\uFFFC\u2063\u2064]/);
+        }
+    });
+    it('lays out and paints a document whose design pictures have no text as before', () => {
+        const plain = buildDocument({ markdown: md, resources: resources.map((r) => ({ ...r, altText: undefined, caption: undefined })) }, config([plate(), title]));
+        for (const p of plates(plain))
+            expect(Object.keys(p).sort()).toEqual(['bbox', 'fileId', 'imageKind', 'kind']);
+        // Without image URLs (placeholders) the HTML is what it was.
+        expect(renderToHtml(plain)).not.toContain('role="presentation"');
+    });
+});
+//# sourceMappingURL=imageAltText.test.js.map

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

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