postext 1.35.1 → 1.37.0

package/dist/__tests__/composed/contrast.test.js

@@ -0,0 +1,124 @@
+import { describe, expect, it } from 'vitest';
+import { buildDocument } from '../../pipeline/build';
+import { createMeasurementCache } from '../../measure';
+import { contrastDocument, contrastPairs } from '../../contrast';
+class StubCtx {
+    font = '';
+    measureText(s) {
+        return { width: s.length * 7 };
+    }
+}
+globalThis.OffscreenCanvas = class {
+    getContext() {
+        return new StubCtx();
+    }
+};
+import { PAGE8_CONFIG, PAGE8_RESOURCES, page8Fixture } from './fixtures/page8';
+// The contrast check on a composed page (#908): frame text is read on what
+// is painted under it, in the page's paint order — the frame's own box, the
+// template's decoration (boxes and pictures), then the paper.
+const mm = (value) => ({ value, unit: 'mm' });
+const pt = (value) => ({ value, unit: 'pt' });
+const hex = (h) => ({ hex: h, model: 'hex' });
+const BLUE = '#005a8c';
+const GREEN = '#2e6417';
+const NAVY = '#102a43';
+/** The p. 8 stand-in's template with three tabs of white lettering: on a
+ *  blue and a green box of the decoration, on bare paper, and in a frame
+ *  that paints its own navy box over a white decoration box. */
+function tabsConfig(extra = {}) {
+    const base = PAGE8_CONFIG.pageTemplates[0];
+    const tab = (name, x, style = 'pestana', layer = 1) => ({
+        name, style, layer, width: mm(50), ...(extra.rotate ? { rotate: extra.rotate } : {}),
+        placement: { anchor: { to: 'page', edge: 'top-left' }, offset: { x: mm(x), y: mm(8) } },
+    });
+    const band = (id, x, color) => ({
+        kind: 'box', id, placement: { anchor: { to: 'page', edge: 'top-left' }, offset: { x: mm(x), y: mm(6) }, size: { width: mm(54), height: mm(14) } }, style: { backgroundColor: hex(color) },
+    });
+    const decoration = base.decoration.elements
+        // Keep the white card; drop the full-bleed picture (and the theme name
+        // set on it) so the paper is what lies under the bare tab.
+        .filter((e) => !['fondo', 'tema'].includes(e.id));
+    return {
+        ...PAGE8_CONFIG,
+        locale: 'es',
+        calloutStyles: [
+            ...(PAGE8_CONFIG.calloutStyles ?? []),
+            // Frameless lettering: no fill of its own, white text.
+            { id: 'pestana', backgroundEnabled: false, border: { enabled: false }, padding: { top: mm(1), right: mm(2), bottom: mm(1), left: mm(2) }, body: { color: hex('#ffffff'), fontSize: pt(11), lineHeight: pt(14) } },
+            { id: 'pestana-propia', backgroundEnabled: true, background: hex(NAVY), border: { enabled: false }, body: { color: hex('#ffffff'), fontSize: pt(11), lineHeight: pt(14) } },
+        ],
+        pageTemplates: [{
+                ...base,
+                decoration: { elements: [...decoration, band('azul', 8, BLUE), band('verde', 68, GREEN), band('blanca', 188, '#ffffff')] },
+                frames: [...(base.frames ?? []), tab('t-azul', 10), tab('t-verde', 70), tab('t-papel', 130), tab('t-propia', 190, 'pestana-propia')],
+            }],
+    };
+}
+const MARKDOWN = `::::page{template="tema-cajas" tema="Retos del planeta"}
+# El dinero y la vida de cada día
+
+Cada familia necesita alimentos, ropa y una casa.
+
+:::frame{slot="t-azul"}
+Pestaña azul
+:::
+
+:::frame{slot="t-verde"}
+Pestaña verde
+:::
+
+:::frame{slot="t-papel"}
+Pestaña suelta
+:::
+
+:::frame{slot="t-propia"}
+Pestaña propia
+:::
+::::
+`;
+function build(config) {
+    return buildDocument({ markdown: MARKDOWN, resources: PAGE8_RESOURCES }, config, createMeasurementCache());
+}
+describe('contrast of frame text over template decoration (#908)', () => {
+    it('reads white tab lettering on the decoration box under it, not on the paper', () => {
+        const doc = build(tabsConfig());
+        const pairs = contrastPairs(doc).filter((p) => p.color === '#ffffff');
+        const ground = (text) => pairs.find((p) => p.text.startsWith(text))?.background;
+        expect(ground('Pestaña azul')).toBe(BLUE);
+        expect(ground('Pestaña verde')).toBe(GREEN);
+        // Nothing under this one but the paper: white on white, as before.
+        expect(ground('Pestaña suelta')).toBe('#ffffff');
+        // A frame that paints its own box reads on it, whatever lies beneath.
+        expect(ground('Pestaña propia')).toBe(NAVY);
+        const low = contrastDocument(doc).filter((i) => i.kind === 'lowContrast');
+        expect(low.map((i) => i.text)).toEqual(['Pestaña suelta']);
+        expect(low[0]).toMatchObject({ color: '#ffffff', background: '#ffffff' });
+    });
+    it('follows a turned frame onto the sheet before it reads the ground', () => {
+        const doc = build(tabsConfig({ rotate: 4 }));
+        const pairs = contrastPairs(doc).filter((p) => p.color === '#ffffff');
+        expect(pairs.find((p) => p.text.startsWith('Pestaña azul'))?.background).toBe(BLUE);
+        expect(pairs.find((p) => p.text.startsWith('Pestaña verde'))?.background).toBe(GREEN);
+    });
+    it('reads the decoration’s own text on the decoration under it', () => {
+        const config = tabsConfig();
+        const tpl = config.pageTemplates[0];
+        const elements = [...tpl.decoration.elements, {
+                kind: 'text', id: 'sello', content: 'Sello', fontSize: pt(9), color: hex('#ffffff'),
+                placement: { anchor: { to: 'page', edge: 'top-left' }, offset: { x: mm(70), y: mm(15) } },
+            }];
+        const doc = build({ ...config, pageTemplates: [{ ...tpl, decoration: { elements } }] });
+        expect(contrastPairs(doc).find((p) => p.text === 'Sello')?.background).toBe(GREEN);
+    });
+    it('leaves the p. 8 stand-in with no low-contrast frame text', () => {
+        for (const locale of ['es', 'en']) {
+            const doc = buildDocument({ markdown: page8Fixture(locale).markdown, resources: PAGE8_RESOURCES }, { ...PAGE8_CONFIG, locale }, createMeasurementCache());
+            // The white theme name stands on the full-bleed picture: skipped, as
+            // any text over a picture is.
+            expect(contrastPairs(doc).some((p) => p.text.startsWith(locale === 'es' ? 'Retos' : 'Planet'))).toBe(false);
+            expect(contrastDocument(doc).filter((i) => i.kind === 'lowContrast')).toEqual([]);
+        }
+    });
+});
+//# sourceMappingURL=contrast.test.js.map

package/dist/__tests__/composed/contrast.test.js.map

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

package/dist/__tests__/composed/corpus.test.js

@@ -22,9 +22,15 @@ describe('corpus (#854)', () => {
             }
         })
         : [];
+    // The composed-page recipes (#875–#879) write page fences on purpose; every other text
+    // must read as it did before the syntax existed.
+    const COMPOSED = /^::::+\s*page\s*\{/m;
     it.runIf(files.length > 0)('no Cookbook text reads as a composed page', () => {
         for (const f of files) {
-            const { blocks } = parseMarkdownWithIssues(extractFrontmatter(readFileSync(f, 'utf8')).content);
+            const text = readFileSync(f, 'utf8');
+            if (COMPOSED.test(text))
+                continue;
+            const { blocks } = parseMarkdownWithIssues(extractFrontmatter(text).content);
             const hit = blocks.find((b) => b.composedPage || b.slot || b.figure || b.containerName === 'frame');
             expect(hit, f).toBeUndefined();
         }

package/dist/__tests__/composed/corpus.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"corpus.test.js","sourceRoot":"","sources":["../../../src/__tests__/composed/corpus.test.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,cAAc;AACd;;;oEAGoE;AACpE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC;QAC5B,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YAChC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC;gBACH,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;YAC5F,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC;QACF,CAAC,CAAC,EAAE,CAAC;IACP,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,2CAA2C,EAAE,GAAG,EAAE;QAC3E,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,EAAE,MAAM,EAAE,GAAG,uBAAuB,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YAChG,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,aAAa,KAAK,OAAO,CAAC,CAAC;YACpG,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACjC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"corpus.test.js","sourceRoot":"","sources":["../../../src/__tests__/composed/corpus.test.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,cAAc;AACd;;;oEAGoE;AACpE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC;QAC5B,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YAChC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC1B,IAAI,CAAC;gBACH,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;YAC5F,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC;QACF,CAAC,CAAC,EAAE,CAAC;IACP,uFAAuF;IACvF,iDAAiD;IACjD,MAAM,QAAQ,GAAG,qBAAqB,CAAC;IACvC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,2CAA2C,EAAE,GAAG,EAAE;QAC3E,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YACrC,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,SAAS;YAClC,MAAM,EAAE,MAAM,EAAE,GAAG,uBAAuB,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC;YAC7E,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,aAAa,KAAK,OAAO,CAAC,CAAC;YACpG,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACjC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/composed/fit.test.d.ts

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

package/dist/__tests__/composed/fit.test.d.ts.map

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

package/dist/__tests__/composed/fit.test.js

@@ -0,0 +1,408 @@
+import { describe, it, expect } from 'vitest';
+import { buildDocument } from '../../pipeline/build';
+import { createMeasurementCache } from '../../measure';
+import { formatWarning } from '../../pipeline/contentWarnings';
+import { describeFitStep, describeFrameOverflowProposal, describeReflowEvent } from '../../composed/reflowLog';
+import { frameBounds, frameContentRect, frameMatrix } from '../../composed/paint';
+import { clearComposedPageMemo, composedPageMemoStats, setComposedPageMemo } from '../../composed/pageMemo';
+import { elementsForSource, sourceAt } from '../../composed/sourceMap';
+import { page8Fixture } from './fixtures/page8';
+// Deterministic text measurement stub (no DOM in the node test env): seven
+// px per character, whatever the face.
+class StubCtx {
+    font = '';
+    measureText(s) {
+        return { width: s.length * 7 };
+    }
+}
+globalThis.OffscreenCanvas = class {
+    getContext() {
+        return new StubCtx();
+    }
+};
+const mm = (value) => ({ value, unit: 'mm' });
+const DPI = 300;
+const MM = DPI / 25.4;
+const toMm = (v) => v / MM;
+/** The stand-in (#855) with its frames patched, its Markdown changed, and
+ *  other templates added after its own. */
+function standIn(opts = {}) {
+    const { markdown, config, resources } = page8Fixture(opts.locale ?? 'es');
+    const base = config.pageTemplates[0];
+    const patch = opts.frames ?? {};
+    const tpl = {
+        ...base,
+        frames: base.frames.map((f) => (patch[f.name] ? { ...f, ...patch[f.name] } : f)),
+        ...(opts.groups ? { groups: opts.groups } : {}),
+    };
+    return { markdown: (opts.markdown ?? ((m) => m))(markdown), config: { ...config, pageTemplates: [tpl, ...(opts.more ?? [])] }, resources };
+}
+const build = (f) => buildDocument({ markdown: f.markdown, resources: f.resources }, f.config, createMeasurementCache());
+const page0 = (doc) => doc.pages.find((p) => p.composed);
+const frameOf = (doc, name) => page0(doc).composed.frames.find((f) => f.name === name);
+const overflowsOf = (doc) => (doc.contentWarnings ?? []).filter((w) => w.kind === 'frameOverflow');
+const eventsOf = (doc, frame) => page0(doc).composed.log.filter((e) => !frame || e.frame === frame).map((e) => `${e.frame} ${e.kind}`);
+/** `n` more paragraphs at the head of the first box (`dinero`). */
+const moreMoney = (n, word = 'Más dinero') => (md) => md.replace(/(:::frame\{slot="dinero"[^\n]*\n)/, `$1${Array.from({ length: n }, (_, i) => `${word} ${i} `.repeat(30).trim()).join('\n\n')}\n\n`);
+/** `k` more words at the head of the first box (one short paragraph). */
+const moreWords = (k) => (md) => md.replace(/(:::frame\{slot="dinero"[^\n]*\n)/, `$1${'Más dinero '.repeat(k).trim()}\n\n`);
+/** The first box's photo set inside the box (its story) instead of in a
+ *  frame of its own. */
+const photoInBox = (md) => md.replace('slot="dinero-fotos"', 'slot="dinero"');
+describe('the reflow ladder on the page-8 stand-in (#858)', () => {
+    it('1. free space: a fixed height grows to its maxHeight, and the ladder stops there', () => {
+        const fixed = { height: mm(36), minHeight: undefined };
+        const capped = build(standIn({ frames: { dinero: fixed }, markdown: moreMoney(3) }));
+        // Without a maximum the height is the template's: the text shrinks.
+        expect(frameOf(capped, 'dinero').rect.height).toBeCloseTo(36 * MM, 3);
+        expect(frameOf(capped, 'dinero').scale).toBeLessThan(1);
+        const free = build(standIn({ frames: { dinero: { ...fixed, maxHeight: mm(90) } }, markdown: moreMoney(3) }));
+        const d = frameOf(free, 'dinero');
+        expect(toMm(d.rect.height)).toBeGreaterThan(36.5);
+        expect(toMm(d.rect.height)).toBeLessThanOrEqual(90);
+        expect(d.scale).toBe(1);
+        expect(d.overflowPx).toBe(0);
+        expect(eventsOf(free, 'dinero')).toEqual(['dinero grew']);
+        expect(eventsOf(free)).toContain('gasto moved');
+        expect(overflowsOf(free)).toEqual([]);
+    });
+    it('2. push siblings: a longer box moves the boxes below; nothing is scaled', () => {
+        const doc = build(standIn({ markdown: moreMoney(3) }));
+        expect(eventsOf(doc).some((e) => /imageScaled|textScaled/.test(e))).toBe(false);
+        expect(eventsOf(doc)).toContain('gasto moved');
+        for (const f of page0(doc).composed.frames)
+            expect(f.scale).toBe(1);
+        expect(overflowsOf(doc)).toEqual([]);
+    });
+    it('3. pictures: the box’s photo is set smaller, the largest 2.5 % step that fits, within imageMinScale', () => {
+        const atNatural = build(standIn({ markdown: photoInBox }));
+        const natural = frameOf(atNatural, 'dinero').rect.height;
+        // The box 4 mm shorter than its text and photo need.
+        const height = mm(Math.floor(toMm(natural)) - 4);
+        const doc = build(standIn({ frames: { dinero: { height, minHeight: undefined } }, markdown: photoInBox }));
+        const d = frameOf(doc, 'dinero');
+        expect(d.overflowPx).toBe(0);
+        expect(d.scale).toBe(1);
+        expect(d.imageScale).toBeGreaterThanOrEqual(0.8);
+        expect(d.imageScale).toBeLessThan(1);
+        expect(Math.round(((1 - d.imageScale) / 0.025) * 1e6) % 1e6).toBe(0);
+        expect(page0(doc).composed.log).toContainEqual({ frame: 'dinero', kind: 'imageScaled', scale: d.imageScale });
+        // One step larger does not fit: the box would overflow at imageMinScale + 2.5 %.
+        const larger = build(standIn({ frames: { dinero: { height, minHeight: undefined, fit: { imageMinScale: d.imageScale + 0.025, shrinkText: false } } }, markdown: photoInBox }));
+        expect(frameOf(larger, 'dinero').overflowPx).toBeGreaterThan(0);
+        // With scaleImages off, the text shrinks instead.
+        const off = build(standIn({ frames: { dinero: { height, minHeight: undefined, fit: { scaleImages: false } } }, markdown: photoInBox }));
+        expect(frameOf(off, 'dinero').imageScale).toBeUndefined();
+        expect(frameOf(off, 'dinero').scale).toBeLessThan(1);
+    });
+    it('4. redistribute: a sibling above its minimum gives space back, down to its minimum', () => {
+        const gasto = { height: mm(62), minHeight: mm(40) };
+        const doc = build(standIn({ frames: { gasto }, markdown: moreMoney(6) }));
+        expect(overflowsOf(doc)).toEqual([]);
+        expect(toMm(frameOf(doc, 'gasto').rect.height)).toBeLessThan(62);
+        expect(toMm(frameOf(doc, 'gasto').rect.height)).toBeGreaterThanOrEqual(40 - 1e-6);
+        expect(frameOf(doc, 'ahorro').scale).toBe(1);
+        expect(eventsOf(doc, 'gasto')).toContain('gasto resized');
+        // Without the step (a fixed height of 62 with nothing under it), ahorro
+        // would not fit: the same text with the minimum at the height does not.
+        const rigid = build(standIn({ frames: { gasto: { height: mm(62), minHeight: mm(62) } }, markdown: moreMoney(6) }));
+        expect(frameOf(rigid, 'ahorro').scale < 1 || frameOf(rigid, 'ahorro').overflowPx > 0).toBe(true);
+    });
+    it('5. shrink text: down to fit.minScale in 2.5 % steps, the largest that fits; shrinkText: false turns it off', () => {
+        const fixed = { height: mm(36), minHeight: undefined };
+        const doc = build(standIn({ frames: { dinero: fixed }, markdown: moreWords(40) }));
+        const d = frameOf(doc, 'dinero');
+        expect(d.overflowPx).toBe(0);
+        expect(d.scale).toBeLessThan(1);
+        expect(d.scale).toBeGreaterThanOrEqual(0.9);
+        expect(Math.round(((1 - d.scale) / 0.025) * 1e6) % 1e6).toBe(0);
+        expect(page0(doc).composed.log).toContainEqual({ frame: 'dinero', kind: 'textScaled', scale: d.scale });
+        // Laid out larger and painted at the scale: the matrix maps its content box onto its box.
+        expect(frameContentRect(d).width).toBeCloseTo(d.rect.width / d.scale, 6);
+        expect(frameBounds(d).x).toBeCloseTo(d.rect.x, 6);
+        expect(frameBounds(d).y).toBeCloseTo(d.rect.y, 6);
+        expect(frameBounds(d).width).toBeCloseTo(d.rect.width, 6);
+        expect(frameBounds(d).height).toBeCloseTo(d.rect.height, 6);
+        expect(frameMatrix(d)).toEqual([d.scale, 0, 0, d.scale, d.rect.x * (1 - d.scale), d.rect.y * (1 - d.scale)]);
+        // The box keeps its drawn padding: the text stays clear of the photos
+        // set over the box's right 62 mm, whatever the scale.
+        const blocks = d.blockIds.map((id) => page0(doc).floats.find((b) => b.id === id));
+        const rightOnSheet = Math.max(...blocks.flatMap((b) => b.lines.filter((l) => l.text.length > 0).map((l) => d.rect.x + (l.bbox.x + l.bbox.width - d.rect.x) * d.scale)));
+        // (A line's box may carry its trailing space: about one stub character.)
+        expect(rightOnSheet).toBeLessThanOrEqual(d.rect.x + d.rect.width - 62 * MM + 8 * d.scale);
+        expect(rightOnSheet).toBeGreaterThan(d.rect.x + d.rect.width - 62 * MM - 10 * MM);
+        // One step larger overflows.
+        if (d.scale < 0.975) {
+            const larger = build(standIn({ frames: { dinero: { ...fixed, fit: { minScale: d.scale + 0.025 } } }, markdown: moreWords(40) }));
+            expect(frameOf(larger, 'dinero').overflowPx).toBeGreaterThan(0);
+        }
+        const off = build(standIn({ frames: { dinero: { ...fixed, fit: { shrinkText: false } } }, markdown: moreWords(40) }));
+        expect(frameOf(off, 'dinero').scale).toBe(1);
+        expect(frameOf(off, 'dinero').overflowPx).toBeGreaterThan(0);
+        expect(overflowsOf(off)[0].stepsTried).not.toContain('shrinkText');
+    });
+    it('6. continuation: a frame that continues on another page is cut there, at full size, and warns no more (#859)', () => {
+        const doc = build(standIn({ frames: { dinero: { height: mm(36), minHeight: undefined, overflow: { continueIn: 'next-page' } } }, markdown: moreMoney(4) }));
+        expect(overflowsOf(doc)).toEqual([]);
+        const d = frameOf(doc, 'dinero');
+        expect(d.overflowPx).toBe(0);
+        expect(d.scale).toBe(1);
+        expect(d.continuesTo).toBe('cp0:dinero~1');
+        expect(eventsOf(doc, 'dinero')).toEqual(['dinero continued']);
+        expect(doc.pages.filter((p) => p.composed).length).toBeGreaterThan(1);
+    });
+});
+describe('frameOverflow: the steps tried and the proposals (#858)', () => {
+    const tooLong = { frames: { dinero: { height: mm(36), minHeight: undefined } }, markdown: moreMoney(4) };
+    const proposal = (w, kind) => w.proposals.find((p) => p.kind === kind);
+    for (const locale of ['es', 'en']) {
+        it(`${locale}: names page, template, frame and locale, the steps tried and the final scale`, () => {
+            const doc = build(standIn({ ...tooLong, locale, markdown: moreMoney(4, locale === 'es' ? 'Más dinero' : 'More money') }));
+            const ws = overflowsOf(doc);
+            expect(ws).toHaveLength(1);
+            const w = ws[0];
+            expect(w).toMatchObject({ kind: 'frameOverflow', template: 'tema-cajas', frame: 'dinero', fenceIndex: 0, pageIndex: 0, locale, scale: 0.9, configPath: '/pageTemplates/0/frames/2' });
+            expect(w.stepsTried).toEqual(['free', 'push', 'redistribute', 'shrinkText']);
+            expect(w.overflowMm).toBeCloseTo(toMm(frameOf(doc, 'dinero').overflowPx), 1);
+            expect(w.sourceStart).toBeGreaterThan(0);
+            const text = formatWarning(w);
+            expect(text).toContain(`Frame "dinero" of template "tema-cajas" (${locale})`);
+            expect(text).toContain('text down to 90 %');
+            expect(text).toContain('to fit:');
+            expect(page0(doc).composed.log.slice(-2)).toEqual([{ frame: 'dinero', kind: 'textScaled', scale: 0.9 }, { frame: 'dinero', kind: 'overflow', toMm: w.overflowMm }]);
+        });
+    }
+    it('allowShrink: the largest text scale that fits, worked out on the page', () => {
+        const w = overflowsOf(build(standIn(tooLong)))[0];
+        const p = proposal(w, 'allowShrink');
+        expect(p.path).toBe('/pageTemplates/0/frames/2/fit/minScale');
+        expect(p.value).toBeLessThan(0.9);
+        const fitted = build(standIn({ ...tooLong, frames: { dinero: { ...tooLong.frames.dinero, fit: { minScale: p.value } } } }));
+        expect(overflowsOf(fitted)).toEqual([]);
+        expect(frameOf(fitted, 'dinero').scale).toBe(p.value);
+        const short = build(standIn({ ...tooLong, frames: { dinero: { ...tooLong.frames.dinero, fit: { minScale: p.value + 0.025 } } } }));
+        expect(overflowsOf(short)).toHaveLength(1);
+        // With shrinkText off, the proposal turns it on as well.
+        const off = overflowsOf(build(standIn({ ...tooLong, frames: { dinero: { ...tooLong.frames.dinero, fit: { shrinkText: false } } } })))[0];
+        expect(proposal(off, 'allowShrink').also).toEqual([{ path: '/pageTemplates/0/frames/2/fit/shrinkText', value: true }]);
+    });
+    it('raiseMax: the frame’s height plus the shortfall, in whole millimetres, and it fits', () => {
+        const w = overflowsOf(build(standIn(tooLong)))[0];
+        const p = proposal(w, 'raiseMax');
+        expect(p.path).toBe('/pageTemplates/0/frames/2/maxHeight');
+        expect(p.value.unit).toBe('mm');
+        expect(Number.isInteger(p.value.value)).toBe(true);
+        expect(p.value.value).toBe(Math.ceil(36 + w.overflowMm - 0.05));
+        const fitted = build(standIn({ ...tooLong, frames: { dinero: { ...tooLong.frames.dinero, maxHeight: p.value } } }));
+        expect(overflowsOf(fitted)).toEqual([]);
+    });
+    it('lowerMin: a sibling at its minimum with less content gives the shortfall; fits once applied', () => {
+        // An own-box stack: the three boxes share 140 mm; gasto stands at its 62 mm minimum.
+        const groups = [{ name: 'cajas', kind: 'stack', frames: ['dinero', 'gasto', 'ahorro'], gap: mm(12), placement: { anchor: { to: '#texto', edge: 'below' }, offset: { y: mm(9) }, size: { width: mm(186), height: mm(150) } } }];
+        const opts = { groups, frames: { dinero: { minHeight: mm(36) }, gasto: { minHeight: mm(62) }, ahorro: { minHeight: mm(30), fit: { shrinkText: false } } }, markdown: moreMoney(2) };
+        const w = overflowsOf(build(standIn(opts))).find((x) => x.frame === 'dinero' || x.frame === 'ahorro');
+        expect(w).toBeDefined();
+        const p = proposal(w, 'lowerMin');
+        expect(p).toMatchObject({ frame: 'gasto', path: '/pageTemplates/0/frames/4/minHeight' });
+        expect(p.value.value).toBeLessThan(62);
+        const fitted = build(standIn({ ...opts, frames: { ...opts.frames, gasto: { minHeight: p.value } } }));
+        expect(overflowsOf(fitted).filter((x) => x.frame === w.frame)).toEqual([]);
+    });
+    it('useTemplate: another template of the book with a frame of that name where it fits', () => {
+        const roomy = {
+            id: 'tema-amplio',
+            frames: [
+                { name: 'titulo', takes: 'h1' },
+                { name: 'texto', flow: true, placement: { anchor: { to: '#titulo', edge: 'below' } } },
+                { name: 'dinero', placement: { anchor: { to: '#texto', edge: 'below' } } },
+            ],
+        };
+        const tight = { id: 'otra', frames: [{ name: 'dinero', height: mm(10) }] };
+        const w = overflowsOf(build(standIn({ ...tooLong, more: [tight, roomy] })))[0];
+        expect(proposal(w, 'useTemplate')).toMatchObject({ kind: 'useTemplate', value: 'tema-amplio' });
+        const at = proposal(w, 'useTemplate');
+        const md = standIn(tooLong).markdown;
+        expect(md.slice(at.sourceStart, at.sourceEnd)).toBe('tema-cajas');
+    });
+    it('shortenText: about the characters of the lines that do not fit; cutting them makes it fit', () => {
+        const f = standIn(tooLong);
+        const w = overflowsOf(build(f))[0];
+        const p = proposal(w, 'shortenText');
+        expect(p.value).toBeGreaterThan(0);
+        expect(p.sourceStart).toBe(w.sourceStart);
+        // The same box with that many characters cut from the end of its added text.
+        const added = Array.from({ length: 4 }, (_, i) => `Más dinero ${i} `.repeat(30).trim()).join('\n\n');
+        const cut = added.slice(0, added.length - p.value).trim();
+        const after = build(standIn({ ...tooLong, markdown: (md) => md.replace(/(:::frame\{slot="dinero"[^\n]*\n)/, `$1${cut}\n\n`) }));
+        expect(overflowsOf(after)).toEqual([]);
+    });
+    it('continueNextPage: overflow.continueIn of the frame', () => {
+        const w = overflowsOf(build(standIn(tooLong)))[0];
+        expect(proposal(w, 'continueNextPage')).toEqual({ kind: 'continueNextPage', path: '/pageTemplates/0/frames/2/overflow/continueIn', value: 'next-page' });
+    });
+    it('words every step and proposal', () => {
+        expect(describeFitStep('shrinkText', { scale: 0.9 })).toBe('text down to 90 %');
+        expect(describeFitStep('scaleImages', { imageScale: 0.825 })).toBe('pictures down to 82.5 %');
+        expect(describeFitStep('free')).toBe('free space');
+        expect(describeReflowEvent({ frame: 'a', kind: 'textScaled', scale: 0.925 })).toBe('a: text at 92.5 %');
+        expect(describeReflowEvent({ frame: 'a', kind: 'imageScaled', scale: 0.8 })).toBe('a: picture at 80 %');
+        expect(describeFitStep('redistribute')).toBe('the other frames of its group down to their minimum');
+        expect(describeFitStep('continue')).toContain('another page');
+        expect(describeFrameOverflowProposal({ kind: 'allowShrink', path: '/x', value: 0.85 })).toBe('let its text shrink to 85 % (fit.minScale: 0.85)');
+        expect(describeFrameOverflowProposal({ kind: 'raiseMax', path: '/x', value: mm(64) })).toBe('raise maxHeight to 64 mm');
+        expect(describeFrameOverflowProposal({ kind: 'lowerMin', path: '/x', value: mm(40), frame: 'gasto' })).toBe('lower the minHeight of "gasto" to 40 mm');
+        expect(describeFrameOverflowProposal({ kind: 'continueNextPage', path: '/x', value: 'next-page' })).toBe('continue on the next page (overflow.continueIn: "next-page")');
+        expect(describeFrameOverflowProposal({ kind: 'useTemplate', value: 'b' })).toBe('set the page with template "b"');
+        expect(describeFrameOverflowProposal({ kind: 'shortenText', value: 120 })).toBe('cut about 120 characters');
+    });
+});
+describe('the ladder is deterministic and stays on its page (#858)', () => {
+    it('the same input gives the same VDT, scales included', () => {
+        const f = standIn({ frames: { dinero: { height: mm(36), minHeight: undefined } }, markdown: moreWords(40) });
+        const a = build(f);
+        const b = build(f);
+        expect(frameOf(a, 'dinero').scale).toBeLessThan(1);
+        expect(JSON.stringify(b.pages)).toBe(JSON.stringify(a.pages));
+        expect(JSON.stringify(b.contentWarnings)).toBe(JSON.stringify(a.contentWarnings));
+    });
+    it('frames that overflow are taken in template order', () => {
+        // Two frames that both overflow: the warnings follow the template.
+        const t = {
+            id: 'two',
+            frames: [
+                { name: 'b', height: mm(10), width: mm(60), placement: { anchor: { to: 'container', edge: 'top-right' } } },
+                { name: 'a', height: mm(10), width: mm(60), placement: { anchor: { to: 'container', edge: 'top-left' } } },
+            ],
+        };
+        const long = 'word '.repeat(300);
+        const md = `::::page{template="two"}\n:::frame{slot="a"}\n${long}\n:::\n\n:::frame{slot="b"}\n${long}\n:::\n::::`;
+        const doc = buildDocument({ markdown: md }, { page: { width: mm(200), height: mm(260), margins: { top: mm(20), bottom: mm(20), left: mm(20), right: mm(20) } }, pageTemplates: [t] }, createMeasurementCache());
+        expect(overflowsOf(doc).map((w) => w.frame)).toEqual(['b', 'a']);
+    });
+    it('what one composed page scales leaves the next one as it was', () => {
+        const one = standIn({ frames: { dinero: { height: mm(36), minHeight: undefined } } });
+        const page = one.markdown;
+        const longer = moreWords(40)(page);
+        const twice = (first) => ({ ...one, markdown: `${first}\n\n${page}` });
+        const before = build(twice(page));
+        const after = build(twice(longer));
+        const pages = (d) => d.pages.filter((p) => p.composed);
+        expect(pages(before)).toHaveLength(2);
+        expect(pages(after)).toHaveLength(2);
+        expect(pages(after)[0].composed.frames.find((f) => f.name === 'dinero').scale).toBeLessThan(1);
+        const boxes = (p) => p.composed.frames.map((f) => ({ name: f.name, rect: f.rect, scale: f.scale, imageScale: f.imageScale, overflowPx: f.overflowPx }));
+        expect(boxes(pages(after)[1])).toEqual(boxes(pages(before)[1]));
+        expect(pages(after)[1].composed.log).toEqual(pages(before)[1].composed.log);
+    });
+});
+describe('slot warnings carry their location (#858)', () => {
+    it('slotUnknown names the flow frame that takes the content; both have page, frame and source range', () => {
+        const t = { id: 't', frames: [{ name: 'a', flow: true }, { name: 'b' }, { name: 'c' }] };
+        const md = `# Intro\n\n${'Some text. '.repeat(400)}\n\n::::page{template="t"}\nflow\n\n:::frame{slot="nope"}\nStray.\n:::\n\n:::frame{slot="b"}\nB.\n:::\n::::\n`;
+        const doc = buildDocument({ markdown: md }, { page: { width: mm(200), height: mm(260), margins: { top: mm(20), bottom: mm(20), left: mm(20), right: mm(20) } }, pageTemplates: [t] }, createMeasurementCache());
+        const composed = doc.pages.find((p) => p.composed);
+        expect(composed.index).toBeGreaterThan(0);
+        const unknown = doc.contentWarnings.find((w) => w.kind === 'slotUnknown');
+        expect(unknown).toMatchObject({ kind: 'slotUnknown', slot: 'nope', frame: 'a', template: 't', pageIndex: composed.index });
+        expect(md.slice(unknown.sourceStart, unknown.sourceEnd)).toBe('nope');
+        const empty = doc.contentWarnings.find((w) => w.kind === 'slotEmpty');
+        expect(empty).toMatchObject({ kind: 'slotEmpty', frame: 'c', template: 't', pageIndex: composed.index });
+        expect(md.slice(empty.sourceStart, empty.sourceEnd)).toMatch(/^::::page\{template="t"\}/);
+        expect(formatWarning(unknown)).toContain('the flow frame "a"');
+    });
+});
+describe('the ladder with spreads, the page memo and the source map (#858)', () => {
+    const PAGE = {
+        page: { width: mm(200), height: mm(260), margins: { top: mm(20), bottom: mm(20), left: mm(20), right: mm(20) } },
+        headings: { balancing: { enabled: false }, levels: [{ level: 1, breakBefore: { enabled: false } }] },
+    };
+    const W = 200 * MM;
+    const buildWith = (md, templates) => buildDocument({ markdown: md }, { ...PAGE, pageTemplates: templates }, createMeasurementCache());
+    const words = (n, w = 'word') => Array.from({ length: n }, (_, i) => `${w}${i}`).join(' ');
+    it('a spread: the gutter cut narrows a frame, the ladder shrinks its text; a frame of the second page is scaled on its own sheet', () => {
+        const t = {
+            id: 'sp', spread: true, gutter: mm(20),
+            frames: [
+                // Centred on the spine: cut at the band's edge, on the first page.
+                { name: 'cut', height: mm(40), placement: { anchor: { to: 'container', edge: 'top-left' } } },
+                { name: 'right', width: mm(60), height: mm(30), placement: { anchor: { to: 'container', edge: 'bottom-right' } } },
+            ],
+        };
+        const md = (cut, right) => `::::page{template="sp" spread}\n:::frame{slot="cut"}\n${words(cut, 'cut')}\n:::\n\n:::frame{slot="right"}\n${words(right, 'right')}\n:::\n::::\n`;
+        const doc = buildWith(md(400, 94), [t]);
+        const [verso, recto] = doc.pages.filter((p) => p.composed?.spread);
+        const cut = verso.composed.frames.find((f) => f.name === 'cut' && f.blockIds.length > 0);
+        expect(verso.composed.log.find((e) => e.frame === 'cut' && e.cause === 'gutter')).toMatchObject({ kind: 'resized' });
+        expect(cut.scale).toBeLessThan(1);
+        expect(cut.overflowPx).toBe(0);
+        expect(frameBounds(cut).x + frameBounds(cut).width).toBeLessThanOrEqual(W - 10 * MM + 1e-6);
+        expect(verso.composed.log).toContainEqual({ frame: 'cut', kind: 'textScaled', scale: cut.scale });
+        const right = recto.composed.frames.find((f) => f.name === 'right');
+        expect(right.scale).toBeLessThan(1);
+        expect(right.overflowPx).toBe(0);
+        const b = frameBounds(right);
+        expect(b.x).toBeGreaterThan(0);
+        expect(b.x + b.width).toBeLessThanOrEqual(W + 1e-6);
+        // Its blocks are on its own page, laid out in its larger content box.
+        const content = frameContentRect(right);
+        for (const id of right.blockIds) {
+            const blk = recto.floats.find((x) => x.id === id);
+            expect(blk.pageIndex).toBe(recto.index);
+            expect(blk.bbox.x).toBeGreaterThanOrEqual(content.x - 0.5);
+            expect(blk.bbox.x + blk.bbox.width).toBeLessThanOrEqual(content.x + content.width + 0.5);
+        }
+    });
+    it('the page memo keys the ladder: a reused page with scaled frames and a warning is the page laid out afresh', () => {
+        const f = standIn({ frames: { dinero: { height: mm(36), minHeight: undefined }, gasto: { height: mm(30), minHeight: undefined } }, markdown: moreWords(40) });
+        const md = `${f.markdown}\n${f.markdown.replace('tema="Retos del planeta"', 'tema="Otro"')}`;
+        const shape = (doc) => JSON.stringify({ pages: doc.pages, blocks: doc.blocks, warnings: doc.contentWarnings ?? [] }, (k, v) => (k === 'layoutKey' ? undefined : v));
+        const run = (text) => buildDocument({ markdown: text, resources: f.resources }, f.config, createMeasurementCache());
+        setComposedPageMemo(false);
+        let expected;
+        try {
+            expected = shape(run(md));
+        }
+        finally {
+            setComposedPageMemo(true);
+        }
+        clearComposedPageMemo();
+        // Laid out first where every offset is elsewhere, then met again.
+        run(`Una línea antes.\n\n:::pagebreak\n\nOtra línea.\n\n${md}`);
+        const before = composedPageMemoStats().hits;
+        const doc = run(md);
+        expect(composedPageMemoStats().hits).toBeGreaterThan(before);
+        expect(shape(doc)).toBe(expected);
+        const pages = doc.pages.filter((p) => p.composed);
+        expect(pages[0].composed.frames.find((x) => x.name === 'dinero').scale).toBeLessThan(1);
+        const w = overflowsOf(doc).find((x) => x.frame === 'gasto');
+        expect(w.proposals.find((p) => p.kind === 'shortenText').sourceStart).toBe(w.sourceStart);
+        expect(md.slice(w.sourceStart, w.sourceStart + 3)).toBe(md.slice(frameOf(doc, 'gasto').sourceStart, frameOf(doc, 'gasto').sourceStart + 3));
+        clearComposedPageMemo();
+    });
+    it('the source map reads a scaled frame where it is painted', () => {
+        const doc = build(standIn({ frames: { dinero: { height: mm(36), minHeight: undefined } }, markdown: moreWords(40) }));
+        const page = page0(doc);
+        const d = frameOf(doc, 'dinero');
+        expect(d.scale).toBeLessThan(1);
+        const para = d.blockIds.map((id) => page.floats.find((b) => b.id === id)).find((b) => b.type === 'paragraph' && b.lines.length > 1);
+        const line = para.lines[para.lines.length - 1];
+        // Where the line is painted: its laid box scaled about the frame's top-left.
+        const painted = { x: d.rect.x + (line.bbox.x + 10 - d.rect.x) * d.scale, y: d.rect.y + (line.bbox.y + line.bbox.height / 2 - d.rect.y) * d.scale };
+        const hit = sourceAt(doc, page.index, painted.x, painted.y);
+        const lineHit = hit.find((e) => e.level === 'line');
+        expect(lineHit).toBeDefined();
+        expect(lineHit.rect.x).toBeLessThanOrEqual(painted.x);
+        expect(lineHit.rect.x + lineHit.rect.width).toBeGreaterThanOrEqual(painted.x);
+        expect(lineHit.rect.y).toBeLessThanOrEqual(painted.y);
+        expect(lineHit.rect.y + lineHit.rect.height).toBeGreaterThanOrEqual(painted.y);
+        expect(lineHit.rect.height).toBeCloseTo(line.bbox.height * d.scale, 6);
+        expect(hit.find((e) => e.level === 'frame').id).toBe(d.id);
+        // The same line found from its Markdown has the same box.
+        const found = elementsForSource(doc, lineHit.source.kind === 'markdown' ? lineHit.source.start : 0, lineHit.source.kind === 'markdown' ? lineHit.source.start : 0).find((m) => m.element.id === lineHit.id);
+        expect(found.element.rect).toEqual(lineHit.rect);
+        // Under the painted box, nothing of the frame's content: the frame's foot is its rect's.
+        const below = sourceAt(doc, page.index, d.rect.x + 20, d.rect.y + d.rect.height + 2);
+        expect(below.find((e) => e.id === d.id)).toBeUndefined();
+    });
+});
+//# sourceMappingURL=fit.test.js.map