postext 1.47.0 → 1.48.0

package/dist/__tests__/composed/fixtures/modules.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Modules (#1062): a topic page built from a page shell (a title and a
+ * modules group) and three module templates a series of books could share:
+ * a box with a tab and a photo beside its text (`caja`), a tree of three
+ * frames over a tinted ground (`arbol`), and a 2 × 2 photo grid with its own
+ * heading (`fotos`, a grid that repeats a photo and its caption). The words
+ * are written for this fixture, in Spanish and English (the Spanish box is
+ * longer, so it pushes the modules after it down); the pictures are the
+ * solid placeholders of `fixtures/page8`.
+ */
+import type { PostextConfig, Resource } from '../../../types';
+import type { PageTemplate } from '../../../composed/types';
+export declare const mm: (value: number) => {
+    value: number;
+    unit: "mm";
+};
+export declare const MODULE_RESOURCES: Resource[];
+/** The page shell: the title, then the modules one under another. */
+export declare const TOPIC_TEMPLATE: PageTemplate;
+/** A box with a tab over its text and a photo beside it. */
+export declare const BOX_MODULE: PageTemplate;
+/** A tree of three: a root over two branches, on a tinted ground. */
+export declare const TREE_MODULE: PageTemplate;
+/** A 2 × 2 photo grid under a heading of its own. */
+export declare const PHOTOS_MODULE: PageTemplate;
+export declare const MODULE_CONFIG: PostextConfig;
+/** The words of the topic page in each language. */
+export declare const TOPIC_WORDS: {
+    es: {
+        title: string;
+        tab: string;
+        box: string[];
+        tree: string[];
+        photos: string;
+        captions: string[];
+    };
+    en: {
+        title: string;
+        tab: string;
+        box: string[];
+        tree: string[];
+        photos: string;
+        captions: string[];
+    };
+};
+export type TopicLocale = keyof typeof TOPIC_WORDS;
+/** The box module's block. */
+export declare const boxModule: (lang: TopicLocale, attrs?: string) => string;
+/** The tree module's block. */
+export declare const treeModule: (lang: TopicLocale, attrs?: string) => string;
+/** The photo grid module's block: its heading, then one card per photo. */
+export declare const photosModule: (lang: TopicLocale, attrs?: string) => string;
+/** The topic page: a title and the three modules. */
+export declare const topicPage: (lang: TopicLocale, modules?: readonly string[]) => string;
+//# sourceMappingURL=modules.d.ts.map

package/dist/__tests__/composed/fixtures/modules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modules.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/composed/fixtures/modules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG5D,eAAO,MAAM,EAAE,GAAI,OAAO,MAAM;;;CAAqC,CAAC;AAMtE,eAAO,MAAM,gBAAgB,EAAE,QAAQ,EAAoB,CAAC;AAE5D,qEAAqE;AACrE,eAAO,MAAM,cAAc,EAAE,YAO5B,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,UAAU,EAAE,YAOxB,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,WAAW,EAAE,YAiBzB,CAAC;AAEF,qDAAqD;AACrD,eAAO,MAAM,aAAa,EAAE,YAS3B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,aAuB3B,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;CAwBvB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,WAAW,CAAC;AAEnD,8BAA8B;AAC9B,eAAO,MAAM,SAAS,GAAI,MAAM,WAAW,EAAE,cAAU,KAAG,MAGzD,CAAC;AAEF,+BAA+B;AAC/B,eAAO,MAAM,UAAU,GAAI,MAAM,WAAW,EAAE,cAAU,KAAG,MAG1D,CAAC;AAEF,2EAA2E;AAC3E,eAAO,MAAM,YAAY,GAAI,MAAM,WAAW,EAAE,cAAU,KAAG,MAI5D,CAAC;AAEF,qDAAqD;AACrD,eAAO,MAAM,SAAS,GAAI,MAAM,WAAW,EAAE,UAAS,SAAS,MAAM,EAA4D,KAAG,MAC1C,CAAC"}

package/dist/__tests__/composed/fixtures/modules.js

@@ -0,0 +1,123 @@
+import { PAGE8_RESOURCES, PAGE8_TYPES } from './page8';
+export const mm = (value) => ({ value, unit: 'mm' });
+const pt = (value) => ({ value, unit: 'pt' });
+const hex = (h) => ({ hex: h, model: 'hex' });
+const PICTURES = PAGE8_RESOURCES.filter((r) => r.id.startsWith('foto-')).map((r) => r.id);
+export const MODULE_RESOURCES = PAGE8_RESOURCES;
+/** The page shell: the title, then the modules one under another. */
+export const TOPIC_TEMPLATE = {
+    id: 'tema',
+    header: false,
+    frames: [
+        { name: 'titulo', takes: 'h1', placement: { anchor: { to: 'container', edge: 'top-left' } } },
+    ],
+    groups: [{ name: 'cuerpo', modules: true, gap: mm(8), placement: { anchor: { to: '#titulo', edge: 'below' }, offset: { y: mm(6) }, size: { width: 'fill', height: 'fill' } } }],
+};
+/** A box with a tab over its text and a photo beside it. */
+export const BOX_MODULE = {
+    id: 'caja',
+    role: 'module',
+    frames: [
+        { name: 'texto', style: 'recuadro', width: { percent: 64 }, placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(6.4) } } },
+        { name: 'foto', style: 'marco', width: mm(36), placement: { anchor: { to: '#texto', edge: 'right-of' }, offset: { x: mm(5) } } },
+    ],
+};
+/** A tree of three: a root over two branches, on a tinted ground. */
+export const TREE_MODULE = {
+    id: 'arbol',
+    role: 'module',
+    frames: [
+        { name: 'raiz', style: 'nodo', width: mm(56), placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: mm(4) } } },
+        { name: 'izq', style: 'nodo', width: mm(56), placement: { anchor: { to: '#raiz', edge: 'below' }, offset: { x: mm(-44), y: mm(10) } } },
+        { name: 'der', style: 'nodo', width: mm(56), placement: { anchor: { to: '#raiz', edge: 'below' }, offset: { x: mm(44), y: mm(10) } } },
+    ],
+    decoration: {
+        elements: [
+            { kind: 'box', id: 'suelo', placement: { anchor: { to: 'container', edge: 'top-left' }, size: { width: { to: 'container', edge: 'right' }, height: { to: 'container', edge: 'bottom' } } }, style: { backgroundColor: hex('#eef6ea'), borderRadius: mm(3) } },
+            { kind: 'rule', id: 'tronco', direction: 'vertical', color: hex('#3c6e47'), thickness: pt(1.5), placement: { anchor: { to: '#raiz', edge: 'below' }, offset: { x: mm(28) }, size: { height: mm(5) } } },
+            { kind: 'rule', id: 'rama', direction: 'horizontal', color: hex('#3c6e47'), thickness: pt(1.5), placement: { anchor: { to: '#raiz', edge: 'below' }, offset: { x: mm(-16), y: mm(5) }, size: { width: mm(88) } } },
+            { kind: 'rule', id: 'hacia-izq', direction: 'vertical', color: hex('#3c6e47'), thickness: pt(1.5), placement: { anchor: { to: '#izq', edge: 'above' }, offset: { x: mm(28) }, size: { height: mm(5) } } },
+            { kind: 'rule', id: 'hacia-der', direction: 'vertical', color: hex('#3c6e47'), thickness: pt(1.5), placement: { anchor: { to: '#der', edge: 'above' }, offset: { x: mm(28) }, size: { height: mm(5) } } },
+        ],
+    },
+};
+/** A 2 × 2 photo grid under a heading of its own. */
+export const PHOTOS_MODULE = {
+    id: 'fotos',
+    role: 'module',
+    frames: [
+        { name: 'cabecera', takes: 'h3', placement: { anchor: { to: 'container', edge: 'top-left' } } },
+        { name: 'foto', style: 'marco', placement: { anchor: { to: '#cabecera', edge: 'below' }, offset: { y: mm(3) } } },
+        { name: 'pie', style: 'pastilla', width: 'auto', layer: 2, overlap: 'allow', placement: { anchor: { to: '#foto', edge: 'bottom' }, offset: { y: mm(4) } } },
+    ],
+    groups: [{ name: 'rejilla', kind: 'grid', columns: 2, columnGap: mm(6), rowGap: mm(8), repeat: { frames: ['foto', 'pie'] }, placement: { anchor: { to: '#cabecera', edge: 'below' }, offset: { y: mm(3) }, size: { width: mm(120), height: 'fill' } } }],
+};
+export const MODULE_CONFIG = {
+    page: { sizePreset: 'custom', width: mm(210), height: mm(280), margins: { top: mm(18), bottom: mm(18), left: mm(16), right: mm(16), mirror: true } },
+    bodyText: { fontSize: pt(11), lineHeight: pt(15) },
+    headings: {
+        balancing: { enabled: false },
+        levels: [
+            { level: 1, fontSize: pt(20), lineHeight: pt(24), breakBefore: { enabled: false } },
+            { level: 3, fontSize: pt(13), lineHeight: pt(16) },
+        ],
+    },
+    resourceTypes: PAGE8_TYPES,
+    calloutStyles: [
+        {
+            id: 'recuadro', backgroundEnabled: true, background: hex('#d8ecf9'), border: { enabled: false }, borderRadius: mm(1.5),
+            padding: { top: mm(3), right: mm(4), bottom: mm(3.5), left: mm(4) },
+            label: { position: 'top-left', background: hex('#0885bf'), color: hex('#ffffff'), fontSize: pt(10), height: mm(6.4), paddingX: mm(2.5), offset: mm(6.4), inset: mm(0), rule: { enabled: false, color: hex('#0885bf') } },
+            body: { fontSize: pt(10.5), lineHeight: pt(15), firstLineIndent: mm(0) },
+        },
+        { id: 'marco', backgroundEnabled: true, background: hex('#ffffff'), border: { enabled: true, color: hex('#2a6f97'), width: pt(1.5) }, borderRadius: mm(2), padding: { top: mm(2), right: mm(2), bottom: mm(2), left: mm(2) } },
+        { id: 'pastilla', backgroundEnabled: true, background: hex('#f4a259'), border: { enabled: false }, borderRadius: mm(4), padding: { top: mm(1), right: mm(3), bottom: mm(1), left: mm(3) }, body: { fontSize: pt(9), lineHeight: pt(11), firstLineIndent: mm(0) } },
+        { id: 'nodo', backgroundEnabled: true, background: hex('#ffffff'), border: { enabled: true, color: hex('#3c6e47'), width: pt(1) }, borderRadius: mm(3), padding: { top: mm(2), right: mm(3), bottom: mm(2), left: mm(3) }, body: { fontSize: pt(10), lineHeight: pt(13), firstLineIndent: mm(0), textAlign: 'center' } },
+    ],
+    pageTemplates: [TOPIC_TEMPLATE, BOX_MODULE, TREE_MODULE, PHOTOS_MODULE],
+};
+/** The words of the topic page in each language. */
+export const TOPIC_WORDS = {
+    es: {
+        title: 'El río',
+        tab: '¿Sabías que…?',
+        box: [
+            'Un río nace en las montañas, donde la lluvia y la nieve se juntan en arroyos que bajan por las laderas.',
+            'Por el camino recibe el agua de otros ríos más pequeños, que llamamos afluentes, y su cauce se hace cada vez más ancho y más lento hasta que llega al mar o a un lago.',
+            'En sus orillas viven muchas plantas y animales que dependen de su agua limpia, y por eso conviene cuidarlo y no tirar nada a su corriente.',
+        ],
+        tree: ['El río', 'El agua que lleva', 'La vida en sus orillas'],
+        photos: 'Animales del río',
+        captions: ['La garza', 'La nutria', 'El sapo', 'La libélula'],
+    },
+    en: {
+        title: 'The river',
+        tab: 'Did you know?',
+        box: [
+            'A river begins in the mountains, where rain and snow gather into streams.',
+            'On its way it takes in smaller rivers and grows wider until it reaches the sea.',
+        ],
+        tree: ['The river', 'The water it carries', 'Life on its banks'],
+        photos: 'Animals of the river',
+        captions: ['The heron', 'The otter', 'The toad', 'The dragonfly'],
+    },
+};
+/** The box module's block. */
+export const boxModule = (lang, attrs = '') => {
+    const w = TOPIC_WORDS[lang];
+    return `:::module{template="caja"${attrs}}\n:::frame{slot="texto" label="${w.tab}"}\n${w.box.join('\n\n')}\n:::\n::resource{id="${PICTURES[0]}" slot="foto"}\n:::\n`;
+};
+/** The tree module's block. */
+export const treeModule = (lang, attrs = '') => {
+    const [root, left, right] = TOPIC_WORDS[lang].tree;
+    return `:::module{template="arbol"${attrs}}\n:::frame{slot="raiz"}\n${root}\n:::\n:::frame{slot="izq"}\n${left}\n:::\n:::frame{slot="der"}\n${right}\n:::\n:::\n`;
+};
+/** The photo grid module's block: its heading, then one card per photo. */
+export const photosModule = (lang, attrs = '') => {
+    const w = TOPIC_WORDS[lang];
+    const cards = w.captions.map((c, k) => `:::frame{slot="foto"}\n::resource{id="${PICTURES[k % PICTURES.length]}"}\n\n:::frame{slot="pie"}\n${c}\n:::\n:::\n`).join('\n');
+    return `:::module{template="fotos"${attrs}}\n### ${w.photos}\n\n${cards}:::\n`;
+};
+/** The topic page: a title and the three modules. */
+export const topicPage = (lang, modules = [boxModule(lang), treeModule(lang), photosModule(lang)]) => `::::page{template="tema"}\n# ${TOPIC_WORDS[lang].title}\n\n${modules.join('\n')}::::\n`;
+//# sourceMappingURL=modules.js.map

package/dist/__tests__/composed/fixtures/modules.js.map

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

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

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

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

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

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

@@ -0,0 +1,357 @@
+import { describe, it, expect } from 'vitest';
+import { buildDocument } from '../../pipeline/build';
+import { createMeasurementCache } from '../../measure';
+import { formatWarning } from '../../pipeline/contentWarnings';
+import { validatePageTemplates } from '../../composed/validate';
+import { resolvePageTemplate } from '../../composed/templates';
+import { expandRepeats, pageRepeats } from '../../composed/repeat';
+import { composedPages } from '../../composed/document';
+import { elementsForSource, findElement } from '../../composed/sourceMap';
+import { clearComposedPageMemo, composedPageMemoStats, setComposedPageMemo } from '../../composed/pageMemo';
+import { parseMarkdown } from '../../parse';
+import { flowRectToPage } from '../../vdt';
+import { CAPTIONS, GRID_CONFIG, GRID_RESOURCES, mm, PANEL_TEMPLATE, panelPage, PHOTO_TEMPLATE, photoItem, photoPage } from './fixtures/grid';
+// #1061 (DESIGN §12.6): a grid group that repeats a frame set lays one
+// instance of the set per content item, `<frame>[n]`, cell after cell.
+class StubCtx {
+    font = '';
+    measureText(s) {
+        return { width: s.length * 7 };
+    }
+}
+globalThis.OffscreenCanvas = class {
+    getContext() {
+        return new StubCtx();
+    }
+};
+const MM = 300 / 25.4;
+const build = (markdown, config = {}) => buildDocument({ markdown, resources: GRID_RESOURCES }, { ...GRID_CONFIG, ...config }, createMeasurementCache());
+const composedPagesOf = (doc) => doc.pages.filter((p) => p.composed);
+const frame = (page, name) => page.composed.frames.find((f) => f.name === name);
+const warningsOf = (doc, kind) => (doc.contentWarnings ?? []).filter((w) => w.kind === kind);
+const withTemplate = (t, more = []) => ({ pageTemplates: [t, ...more] });
+const withGrid = (t, patch) => ({ ...t, groups: [{ ...t.groups[0], ...patch }] });
+describe('a grid that repeats a frame set (#1061)', () => {
+    it('lays a 3 × 3 grid of photo cards, each caption pill on its photo\'s foot', () => {
+        const doc = build(photoPage('Animals of the river', CAPTIONS.en));
+        const [page] = composedPagesOf(doc);
+        expect(page).toBeDefined();
+        const names = page.composed.frames.map((f) => f.name);
+        expect(names).toEqual(['titulo', ...Array.from({ length: 9 }, (_, k) => [`foto[${k + 1}]`, `pie[${k + 1}]`]).flat()]);
+        const fotos = Array.from({ length: 9 }, (_, k) => frame(page, `foto[${k + 1}]`));
+        // Ids, items and the template's entry.
+        expect(fotos[1].id).toBe('cp0:foto[2]');
+        expect(fotos[1].repeat).toEqual({ frame: 'foto', item: 2 });
+        expect(fotos[1].configPath).toBe('/pageTemplates/0/frames/1');
+        expect(frame(page, 'pie[2]').configPath).toBe('/pageTemplates/0/frames/2');
+        // Three columns of one width, rows from the start side.
+        const area = page.contentArea;
+        const colW = (area.width - 2 * 6 * MM) / 3;
+        for (let k = 0; k < 9; k++) {
+            const f = fotos[k];
+            expect(f.rect.width).toBeCloseTo(colW, 3);
+            expect(f.rect.x).toBeCloseTo(area.x + (k % 3) * (colW + 6 * MM), 3);
+            if (k % 3 > 0)
+                expect(f.rect.y).toBeCloseTo(fotos[k - (k % 3)].rect.y, 6);
+        }
+        // A row is as tall as its tallest cell (stretch): the photos of a row
+        // are as tall as each other.
+        expect(fotos[0].rect.height).toBeCloseTo(fotos[1].rect.height, 6);
+        // Each pill hangs centred from its own photo's foot, 4 mm below it, and
+        // the next row starts past the pills (rowGap 10 mm).
+        for (let k = 0; k < 9; k++) {
+            const f = fotos[k];
+            const pie = frame(page, `pie[${k + 1}]`);
+            expect(pie.rect.x + pie.rect.width / 2).toBeCloseTo(f.rect.x + f.rect.width / 2, 3);
+            expect(pie.rect.y + pie.rect.height).toBeCloseTo(f.rect.y + f.rect.height + 4 * MM, 3);
+            expect(pie.blockIds.length).toBeGreaterThan(0);
+        }
+        const pie1 = frame(page, 'pie[1]');
+        expect(fotos[3].rect.y).toBeCloseTo(pie1.rect.y + pie1.rect.height + 10 * MM, 3);
+        // Each instance holds its own item: the n-th caption.
+        const text = (f) => f.blockIds.map((id) => doc.blocks.find((b) => b.id === id)).flatMap((b) => b?.lines.map((l) => l.text) ?? []).join(' ').trim();
+        expect(text(frame(page, 'pie[5]'))).toBe(CAPTIONS.en[4]);
+        expect(fotos[4].blockIds.some((id) => doc.blocks.find((b) => b.id === id)?.type === 'resource')).toBe(true);
+        expect(warningsOf(doc, 'frameOverflow')).toEqual([]);
+        expect(warningsOf(doc, 'slotEmpty')).toEqual([]);
+        expect(warningsOf(doc, 'slotUnknown')).toEqual([]);
+    });
+    it('adds a row for a tenth item', () => {
+        const doc = build(photoPage('Animals of the river', [...CAPTIONS.en, 'The salmon']));
+        const [page] = composedPagesOf(doc);
+        const f10 = frame(page, 'foto[10]');
+        const f7 = frame(page, 'foto[7]');
+        expect(f10.rect.x).toBeCloseTo(frame(page, 'foto[1]').rect.x, 6);
+        expect(f10.rect.y).toBeGreaterThan(f7.rect.y + f7.rect.height);
+    });
+    it('makes as many cards as each language has: 3 × 2 panels over photos, top-aligned', () => {
+        const es = ['Vive en la orilla y caza peces al acecho.', 'Anida en los taludes del río.', 'Nada de noche.', 'Canta en primavera junto al agua.', 'Pone sus huevos en el agua quieta.', 'Busca comida entre las piedras del fondo.'];
+        const en = ['It lives on the bank and waits for fish.', 'It nests in the river\'s banks.', 'It swims at night.', 'It sings by the water in spring.', 'It lays its eggs in still water.'];
+        const docEs = build(panelPage('El río', es), { locale: 'es' });
+        const docEn = build(panelPage('The river', en), { locale: 'en' });
+        const pageEs = composedPagesOf(docEs)[0];
+        const pageEn = composedPagesOf(docEn)[0];
+        expect(pageEs.composed.frames.filter((f) => f.repeat?.frame === 'panel')).toHaveLength(6);
+        expect(pageEn.composed.frames.filter((f) => f.repeat?.frame === 'panel')).toHaveLength(5);
+        // Same ids in both languages for the items they share.
+        expect(frame(pageEs, 'imagen[3]').id).toBe(frame(pageEn, 'imagen[3]').id);
+        for (const page of [pageEs, pageEn]) {
+            const panels = page.composed.frames.filter((f) => f.repeat?.frame === 'panel');
+            for (const p of panels) {
+                const img = frame(page, `imagen[${p.repeat.item}]`);
+                // The photo under its own panel, 2 mm below it.
+                expect(img.rect.y).toBeCloseTo(p.rect.y + p.rect.height + 2 * MM, 3);
+                expect(img.rect.x).toBeCloseTo(p.rect.x, 3);
+                // As wide as its cell: a `'fill'` width runs to the cell's edge.
+                expect(img.rect.width).toBeCloseTo(p.rect.width, 3);
+                expect(img.blockIds.some((id) => (page.floats ?? []).find((b) => b.id === id)?.type === 'resource')).toBe(true);
+            }
+            // `rowAlign: 'start'`: the panels of a row start at one height.
+            expect(panels[1].rect.y).toBeCloseTo(panels[0].rect.y, 6);
+        }
+        expect([...warningsOf(docEs, 'frameOverflow'), ...warningsOf(docEn, 'frameOverflow')]).toEqual([]);
+    });
+    it('sends the items past `max` to the flow, with repeatOverflow', () => {
+        const t = withGrid(PHOTO_TEMPLATE, { repeat: { frames: ['foto', 'pie'], max: 4 } });
+        const md = photoPage('Animals of the river', CAPTIONS.en.slice(0, 6));
+        const doc = build(md, withTemplate(t));
+        const page = composedPagesOf(doc)[0];
+        expect(page.composed.frames.filter((f) => f.repeat?.frame === 'foto').map((f) => f.repeat.item)).toEqual([1, 2, 3, 4]);
+        const over = warningsOf(doc, 'repeatOverflow');
+        expect(over.map((w) => w.item)).toEqual([5, 6]);
+        const w = over[0];
+        expect(w).toMatchObject({ template: 'fotos', group: 'fotos', frame: 'foto', max: 4, fenceIndex: 0 });
+        // It points at the item's `slot="foto"`.
+        const at = md.indexOf('slot="foto"', md.indexOf(CAPTIONS.en[3]));
+        expect(md.slice(w.sourceStart, w.sourceEnd)).toBe('foto');
+        expect(w.sourceStart).toBe(at + 'slot="'.length);
+        expect(formatWarning(w)).toContain('holds 4 items');
+        // Never lost: with no flow frame, the rest is set after the page.
+        const after = doc.pages.filter((p) => !p.composed).flatMap((p) => p.columns.flatMap((c) => c.blocks));
+        expect(after.some((b) => b.lines.some((l) => l.text.includes(CAPTIONS.en[4])))).toBe(true);
+    });
+    it('goes on by whole rows on a next page', () => {
+        const t = withGrid({ ...PHOTO_TEMPLATE, frames: PHOTO_TEMPLATE.frames.map((f) => (f.name === 'foto' ? { ...f, overflow: { continueIn: 'next-page' } } : f)) }, {
+            placement: { anchor: { to: '#titulo', edge: 'below' }, offset: { y: mm(6) }, size: { height: mm(120) } },
+        });
+        const doc = build(photoPage('Animals of the river', CAPTIONS.en), withTemplate(t));
+        const pages = composedPagesOf(doc);
+        expect(pages).toHaveLength(2);
+        const first = pages[0].composed.frames.filter((f) => f.repeat?.frame === 'foto').map((f) => f.repeat.item);
+        const second = pages[1].composed.frames.filter((f) => f.repeat?.frame === 'foto' && !f.collapsed).map((f) => f.repeat.item);
+        // Two rows fit 120 mm; the third goes on whole.
+        expect(first).toEqual([1, 2, 3, 4, 5, 6]);
+        expect(second).toEqual([7, 8, 9]);
+        expect(pages[1].composed.continuationOf).toBe(pages[0].index);
+        expect(frame(pages[1], 'foto[7]').id).toBe('cp0:foto[7]~1');
+        expect(frame(pages[1], 'pie[7]').id).toBe('cp0:pie[7]~1');
+        // The receiving page lays the grid alone: the title it anchors under
+        // takes no room there.
+        expect(frame(pages[1], 'titulo').collapsed).toBe(true);
+        expect(frame(pages[1], 'foto[7]').rect.y).toBeCloseTo(frame(pages[0], 'foto[1]').rect.y - frame(pages[0], 'titulo').rect.height, 3);
+        // Each item is whole on one page: its caption too.
+        const text = (p, f) => f.blockIds.map((id) => (p.floats ?? []).find((b) => b.id === id)).flatMap((b) => b?.lines.map((l) => l.text) ?? []).join(' ').trim();
+        expect(text(pages[1], frame(pages[1], 'pie[8]'))).toBe(CAPTIONS.en[7]);
+        expect(pages[0].composed.log.filter((e) => e.kind === 'continued').map((e) => e.frame)).toEqual(['foto[7]', 'pie[7]', 'foto[8]', 'pie[8]', 'foto[9]', 'pie[9]']);
+        expect(warningsOf(doc, 'frameOverflow')).toEqual([]);
+    });
+    it('takes the empty frames of an item that goes on with it', () => {
+        const t = withGrid({ ...PHOTO_TEMPLATE, frames: PHOTO_TEMPLATE.frames.map((f) => (f.name === 'foto' ? { ...f, overflow: { continueIn: 'next-page' } } : f)) }, {
+            placement: { anchor: { to: '#titulo', edge: 'below' }, offset: { y: mm(6) }, size: { height: mm(120) } },
+        });
+        const items = CAPTIONS.en.map((c, k) => (k === 7 ? ':::frame{slot="foto"}\n::resource{id="foto-gasto"}\n:::\n' : photoItem(k, c)));
+        const doc = build(`::::page{template="fotos"}\n# Animals of the river\n\n${items.join('\n')}::::\n`, withTemplate(t));
+        const pages = composedPagesOf(doc);
+        expect(pages).toHaveLength(2);
+        // Item 8 has no caption: its pill goes on with its photo, empty, and
+        // keeps its place under it.
+        const pie8 = frame(pages[1], 'pie[8]');
+        const foto8 = frame(pages[1], 'foto[8]');
+        expect(pie8.collapsed).toBeUndefined();
+        expect(pie8.rect.y + pie8.rect.height).toBeCloseTo(foto8.rect.y + foto8.rect.height + 4 * MM, 3);
+        expect(warningsOf(doc, 'slotEmpty')).toEqual([]);
+    });
+    it('clips the rows that do not fit when the grid cannot go on, and warns once', () => {
+        const t = withGrid(PHOTO_TEMPLATE, { placement: { anchor: { to: '#titulo', edge: 'below' }, offset: { y: mm(6) }, size: { height: mm(120) } } });
+        const doc = build(photoPage('Animals of the river', CAPTIONS.en), withTemplate(t));
+        expect(composedPagesOf(doc)).toHaveLength(1);
+        const page = composedPagesOf(doc)[0];
+        // Nothing runs past the grid's foot.
+        const titulo = frame(page, 'titulo');
+        const foot = titulo.rect.y + titulo.rect.height + 126 * MM;
+        for (const f of page.composed.frames)
+            if (f.repeat)
+                expect(f.rect.y + f.rect.height).toBeLessThanOrEqual(foot + 0.01);
+        // The rows that fit are whole; the third is cut.
+        expect(frame(page, 'foto[6]').overflowPx).toBe(0);
+        expect(frame(page, 'foto[7]').overflowPx).toBeGreaterThan(0);
+        // One warning, on the last instance cut.
+        const over = warningsOf(doc, 'frameOverflow');
+        expect(over.map((w) => w.frame)).toEqual(['pie[9]']);
+    });
+    it('anchors decoration to an instance: #foto[2]', () => {
+        const t = {
+            ...PHOTO_TEMPLATE,
+            decoration: { elements: [{ kind: 'rule', id: 'raya', direction: 'horizontal', color: { hex: '#2a6f97', model: 'hex' }, thickness: mm(0.8), placement: { anchor: { to: '#foto[2]', edge: 'above' }, offset: { y: mm(-1) }, size: { width: mm(20) } } }] },
+        };
+        const config = { ...GRID_CONFIG, ...withTemplate(t) };
+        expect(validatePageTemplates(config).filter((w) => w.kind === 'frameAnchorUnknown')).toEqual([]);
+        const doc = build(photoPage('Animals of the river', CAPTIONS.en), withTemplate(t));
+        const page = composedPagesOf(doc)[0];
+        const rule = page.composed.decoration.blocks.find((b) => b.elementId === 'raya');
+        expect(rule).toBeDefined();
+        const f2 = flowRectToPage(page, frame(page, 'foto[2]').rect);
+        expect(rule.bbox.x).toBeCloseTo(f2.x, 3);
+        expect(rule.bbox.y + rule.bbox.height).toBeLessThanOrEqual(f2.y + 0.01);
+        expect(rule.bbox.y + rule.bbox.height).toBeGreaterThan(f2.y - 2 * MM);
+    });
+    it('leaves out decoration anchored to an instance the page does not have', () => {
+        const t = {
+            ...PHOTO_TEMPLATE,
+            decoration: { elements: [{ kind: 'rule', id: 'raya', direction: 'horizontal', color: { hex: '#2a6f97', model: 'hex' }, thickness: mm(0.8), placement: { anchor: { to: '#foto[5]', edge: 'above' }, size: { width: mm(20) } } }] },
+        };
+        const doc = build(photoPage('Animals of the river', CAPTIONS.en.slice(0, 3)), withTemplate(t));
+        const page = composedPagesOf(doc)[0];
+        expect(page.composed.decoration?.blocks.find((b) => b.elementId === 'raya')).toBeUndefined();
+    });
+    it('keeps a page with a grid in the page memo, the same as laid afresh', () => {
+        const md = photoPage('Animals of the river', CAPTIONS.en.slice(0, 5));
+        setComposedPageMemo(true);
+        clearComposedPageMemo();
+        try {
+            const fresh = build(md);
+            const before = composedPageMemoStats();
+            const again = build(md);
+            expect(composedPageMemoStats().hits).toBeGreaterThan(before.hits);
+            const ids = (d) => composedPagesOf(d)[0].composed.frames.map((f) => `${f.id} ${f.rect.x.toFixed(3)} ${f.rect.y.toFixed(3)} ${f.blockIds.join(',')}`);
+            expect(ids(again)).toEqual(ids(fresh));
+            // The same as laid afresh, the memo off.
+            setComposedPageMemo(false);
+            expect(ids(build(md))).toEqual(ids(again));
+        }
+        finally {
+            clearComposedPageMemo();
+            setComposedPageMemo(true);
+        }
+    });
+    it('fills the cells from the start side of a right-to-left page', () => {
+        const doc = build(photoPage('حيوانات النهر', CAPTIONS.en.slice(0, 3)), { direction: 'rtl', locale: 'ar' });
+        const page = composedPagesOf(doc)[0];
+        const x = (n) => flowRectToPage(page, frame(page, n).rect).x;
+        expect(x('foto[1]')).toBeGreaterThan(x('foto[2]'));
+        expect(x('foto[2]')).toBeGreaterThan(x('foto[3]'));
+    });
+    it('maps each instance to its own Markdown and back', () => {
+        const md = photoPage('Animals of the river', CAPTIONS.en.slice(0, 4));
+        const doc = build(md);
+        const page = composedPagesOf(doc)[0];
+        const el = findElement(doc, 'cp0:pie[3]')?.element;
+        expect(el?.level).toBe('frame');
+        expect(el?.source).toEqual({ kind: 'config', path: '/pageTemplates/0/frames/2' });
+        const at = md.indexOf(CAPTIONS.en[2]);
+        const hits = elementsForSource(doc, at, at + CAPTIONS.en[2].length).map((h) => h.element.id);
+        expect(hits.some((id) => id.startsWith('cp0:pie[3]'))).toBe(true);
+        expect(hits.some((id) => id.startsWith('cp0:pie[2]'))).toBe(false);
+        // Its group is the grid.
+        const chain = findElement(doc, frame(page, 'pie[3]').blockIds[1]);
+        expect(chain).toBeDefined();
+        expect(frame(page, 'pie[3]').sourceStart).toBeLessThanOrEqual(at);
+        expect(frame(page, 'pie[3]').sourceEnd).toBeGreaterThanOrEqual(at + CAPTIONS.en[2].length);
+    });
+    it('lays the frames a grid lists as its cells when it repeats none', () => {
+        const t = {
+            id: 'cuatro',
+            header: false,
+            frames: ['a', 'b', 'c', 'd'].map((name) => ({ name, style: 'panel' })),
+            groups: [{ name: 'g', kind: 'grid', columns: 2, columnGap: mm(4), rowGap: mm(4), frames: ['a', 'b', 'c', 'd'] }],
+        };
+        const md = '::::page{template="cuatro"}\n' + ['a', 'b', 'c', 'd'].map((n) => `:::frame{slot="${n}"}\nBox ${n}.\n:::\n`).join('\n') + '::::\n';
+        const doc = build(md, withTemplate(t));
+        const page = composedPagesOf(doc)[0];
+        const [a, b, c, d] = ['a', 'b', 'c', 'd'].map((n) => frame(page, n));
+        expect(b.rect.y).toBeCloseTo(a.rect.y, 6);
+        expect(b.rect.x).toBeCloseTo(a.rect.x + a.rect.width + 4 * MM, 3);
+        expect(c.rect.x).toBeCloseTo(a.rect.x, 6);
+        expect(c.rect.y).toBeCloseTo(a.rect.y + a.rect.height + 4 * MM, 3);
+        expect(d.rect.y).toBeCloseTo(c.rect.y, 6);
+        expect(page.composed.frames.every((f) => f.repeat === undefined && !f.id.includes('['))).toBe(true);
+    });
+    it('threads an item\'s text through the frames of its own set', () => {
+        const t = {
+            id: 'fichas',
+            header: false,
+            frames: [
+                { name: 'ficha', style: 'panel', height: mm(14), next: 'mas' },
+                { name: 'mas', style: 'panel', optional: true, height: mm(30), placement: { anchor: { to: '#ficha', edge: 'below' }, offset: { y: mm(1) } } },
+            ],
+            groups: [{ name: 'g', kind: 'grid', columns: 2, columnGap: mm(4), rowGap: mm(4), repeat: { frames: ['ficha', 'mas'] } }],
+        };
+        const long = 'It lives on the bank and waits for fish to come by. '.repeat(4).trim();
+        const md = '::::page{template="fichas"}\n' + [long, 'Short.'].map((x) => `:::frame{slot="ficha"}\n${x}\n:::\n`).join('\n') + '::::\n';
+        const doc = build(md, withTemplate(t));
+        const page = composedPagesOf(doc)[0];
+        // Item 1 goes on in its own `mas`, item 2 fits its `ficha`.
+        expect(frame(page, 'mas[1]').continuedFrom).toBe('cp0:ficha[1]');
+        expect(frame(page, 'mas[1]').blockIds.length).toBeGreaterThan(0);
+        expect(warningsOf(doc, 'frameOverflow')).toEqual([]);
+        // Each item's text stays in its own story.
+        const text = (f) => f.blockIds.map((id) => doc.blocks.find((x) => x.id === id)).flatMap((x) => x?.lines.map((l) => l.text) ?? []).join(' ').trim();
+        expect(text(frame(page, 'mas[2]'))).toBe('');
+        expect(text(frame(page, 'mas[1]'))).not.toContain('Short');
+        expect(text(frame(page, 'ficha[2]'))).toContain('Short');
+    });
+    it('lays a template without grids as before', () => {
+        const t = { ...PHOTO_TEMPLATE, groups: [] };
+        const doc = build(`::::page{template="fotos"}\n# A\n\n${photoItem(0, 'One')}::::\n`, withTemplate(t));
+        const page = composedPagesOf(doc)[0];
+        expect(page.composed.frames.map((f) => f.id)).toEqual(['cp0:titulo', 'cp0:foto', 'cp0:pie']);
+        expect(page.composed.frames.every((f) => f.repeat === undefined)).toBe(true);
+    });
+});
+describe('grid configuration (#1061)', () => {
+    const base = (groups, frames = PHOTO_TEMPLATE.frames) => ({ ...GRID_CONFIG, pageTemplates: [{ ...PHOTO_TEMPLATE, frames, groups }] });
+    it('resolves a grid with its defaults', () => {
+        const t = resolvePageTemplate(base([{ name: 'g', kind: 'grid', gap: mm(3), repeat: { frames: ['foto', 'pie'] } }]), 'fotos');
+        expect(t.groups[0]).toMatchObject({ kind: 'grid', columns: 1, columnGap: mm(3), rowGap: mm(3), rowAlign: 'stretch', frames: ['foto', 'pie'], repeat: { frames: ['foto', 'pie'] } });
+        // Other groups resolve as they did.
+        const s = resolvePageTemplate(base([{ name: 's', kind: 'stack', frames: ['foto'] }]), 'fotos');
+        expect(Object.keys(s.groups[0]).sort()).toEqual(['align', 'configPath', 'fieldPaths', 'frames', 'gap', 'kind', 'name']);
+    });
+    it('warns about unknown repeated frames, a repeated frame in another group, and no columns', () => {
+        const config = base([
+            { name: 'otra', kind: 'stack', frames: ['titulo', 'foto'] },
+            { name: 'g', kind: 'grid', columns: 0, rowAlign: 'middle', repeat: { frames: ['foto', 'nada'], max: 0 } },
+        ]);
+        const ws = validatePageTemplates(config);
+        expect(ws).toContainEqual(expect.objectContaining({ kind: 'groupFrameUnknown', path: '/pageTemplates/0/groups/1/repeat/frames/1', value: 'nada' }));
+        expect(ws).toContainEqual(expect.objectContaining({ kind: 'groupFrameTwice', path: '/pageTemplates/0/groups/0/frames/1', value: 'foto' }));
+        expect(ws).toContainEqual(expect.objectContaining({ kind: 'unknownConfigValue', path: '/pageTemplates/0/groups/1/columns', value: '0' }));
+        expect(ws).toContainEqual(expect.objectContaining({ kind: 'unknownConfigValue', path: '/pageTemplates/0/groups/1/rowAlign', value: 'middle' }));
+        expect(ws).toContainEqual(expect.objectContaining({ kind: 'unknownConfigValue', path: '/pageTemplates/0/groups/1/repeat/max', value: '0' }));
+        // The repeat keeps its frame; the other group loses it.
+        const t = resolvePageTemplate(config, 'fotos');
+        expect(t.groups.find((g) => g.name === 'g').repeat).toEqual({ frames: ['foto'] });
+        expect(t.groups.find((g) => g.name === 'otra').frames).toEqual(['titulo']);
+        expect(t.groups.find((g) => g.name === 'g').columns).toBe(1);
+    });
+    it('expands the set per item, anchors among the set rewritten to the instance', () => {
+        const t = resolvePageTemplate(GRID_CONFIG, 'fotos');
+        const md = photoPage('T', ['a', 'b']);
+        const blocks = parseMarkdown(md);
+        const page = composedPages(blocks)[0];
+        const reps = pageRepeats(page, t);
+        expect(reps.items.map((i) => i.item)).toEqual([1, 2]);
+        expect([...reps.items[0].frames.keys()].sort()).toEqual(['foto', 'pie']);
+        const x = expandRepeats(t, new Map([['fotos', [1, 2]]]));
+        expect(x.frames.map((f) => f.name)).toEqual(['titulo', 'foto[1]', 'pie[1]', 'foto[2]', 'pie[2]']);
+        expect(x.frames.find((f) => f.name === 'pie[2]').placement.anchor.to).toBe('#foto[2]');
+        // The main frame keeps the template's drawing (to a frame outside the set).
+        expect(x.frames.find((f) => f.name === 'foto[2]').placement.anchor.to).toBe('#titulo');
+        expect(x.groups[0].items).toEqual([{ item: 1, frames: ['foto[1]', 'pie[1]'] }, { item: 2, frames: ['foto[2]', 'pie[2]'] }]);
+        // No grid: the same template.
+        const plain = resolvePageTemplate({ ...GRID_CONFIG, pageTemplates: [PANEL_TEMPLATE] }, 'paneles');
+        const none = { ...plain, groups: [] };
+        expect(expandRepeats(none, new Map())).toBe(none);
+    });
+});
+//# sourceMappingURL=grid.test.js.map