postext 1.36.0 → 1.38.0

package/dist/pipeline/build.js

@@ -4,12 +4,13 @@ import { dimensionToPx } from '../units';
 import { createVDTDocument, createVDTBlock, createBoundingBox, createVDTColumn, pageIsMirrored, pageIsVertical, flowRectToPage, } from '../vdt';
 import { figureLabels } from './buildMeasurement';
 import { contourOnPage } from '../contour';
+import { figureLabelWarnings, layOutFigureLabels, stampFigureLabelRects } from '../composed/labels';
 import { anchorBox } from '../design/layout';
 import { parseMarkdownMemo, spaceDirectiveLines } from '../parse';
 import { buildPageLabels, computeHeadingNumbering, parseNumberFormat, } from '../numbering';
 import { extractFrontmatter, normalizeMetadata } from '../frontmatter';
 import { collectConfigWarnings } from '../configWarnings';
-import { initHyphenator } from '../measure';
+import { initHyphenator, measureRichBlock } from '../measure';
 import { setHyphenationRules } from '../hyphenate';
 import { citedNames } from '../citations/names';
 import { getCjkLineBreak, setCjkLineBreak } from '../measure/cjkClasses';
@@ -37,9 +38,12 @@ import { applyStatementNumbering, numberStatements, outlineLookup } from './stat
 import { SPAN_EMBED_STYLE_ID, isPageSpanStrip, spanEmbedStyle, wrapPageSpanEmbeds } from './spanEmbeds';
 import { flowColumnsStyles, isFlowColumnsStyle, wrapFlowColumns } from './flowColumns';
 import { FRAME_STYLE_ID, frameBoxStyle, wrapComposedPages } from '../composed/wrap';
-import { resolvePageTemplate } from '../composed/templates';
+import { continueInPage, resolvePageTemplate } from '../composed/templates';
 import { layoutComposedSpread } from '../composed/spread';
-import { composedPageAt, frameStyleOf, planComposedPages } from './composedLayout';
+import { assignJumpReceivers, assignReceivers, continuationTarget, MAX_CONTINUATION_PAGES } from '../composed/continuation';
+import { frameElementId } from '../composed/ids';
+import { nextFrameOf } from '../composed/geometry';
+import { composedPageAt, frameStyleOf, layoutComposedPage, planComposedPages } from './composedLayout';
 import { configKeyOf, layoutComposedPageMemo } from '../composed/pageMemo';
 import { anchorOutline, computeOutline, hasIndexDirective, hasTocDirective, headingNumberingOptions, headingTemplatesOf, outlineFromDoc, sameOutline } from './outline';
 import { expandTocDirectives } from './toc';
@@ -51,6 +55,7 @@ import { chooseParagraphSplit } from './orphanWidow';
 import { layoutComicPage, comicPageLayoutWarnings } from '../comics/layoutPage';
 import { comicStripExtent, comicStripOffset, comicStripPlacement, comicStripWidth, layoutComicStrip } from '../comics/strip';
 import { isComicSpread, layoutComicSpread } from '../comics/spread';
+import { comicTextPanelsSupported, layoutComicTextFrames, planComicTextPanels, wrapComicTextPanels } from '../comics/textPanels';
 import { applyStyleAttrs, computePageMetrics, flowPageMirrored, pageMirrored, sheetRectToFlow, isMarkerBlock, nextNonMarkerBlock, spaceLinesAfter, prevNonMarkerBlock, rollbackTrailingBlocks, } from './buildHelpers';
 import { measureContentBlock } from './measureContentBlock';
 import { containerStyle, paragraphStyleIdOf, planParagraphContainers } from './paragraphContainers';
@@ -75,7 +80,7 @@ import { chapterNumberCounter, leadingBoldText } from './placeholders';
 import { proposeBalanceLines, GRID_LINE_LEVERS, collectColumnGaps, firstDivergentColumn, gapLinesIn, boxRoomIn, boxLeverKeys, pageSegments, MAX_BALANCING_PASSES, MAX_BALANCING_PASSES_PER_DOCUMENT, balanceKey, candidateKey, flexFigureKey, flexFloatKey } from './columnBalancing';
 import { applyBandCap, uncapBand, columnBottom, bandCapLines, bandTop, bareBandTop, resolveBandCapsGen, drainPasses, resolveTrailingCapsGen, bandCapLinesAroundZone, bandLinePitch, capRetryLimit, } from './bandCaps';
 import { raggedLooseLines } from './raggedLines';
-import { cjkLooseLineWarnings, raggedLineWarnings, collectContentWarnings, designTruncationWarnings, dropCapWarnings, floatShrinkWarnings, joiningLetterSpacingWarnings, locateContentWarnings, wordOverflowWarnings } from './contentWarnings';
+import { cjkLooseLineWarnings, raggedLineWarnings, collectContentWarnings, designTruncationWarnings, dropCapWarnings, floatShrinkWarnings, joiningLetterSpacingWarnings, pictureBelowPrintSizeWarnings, locateContentWarnings, wordOverflowWarnings } from './contentWarnings';
 import { dropCapSinkAfter } from './dropCap';
 import { mostlyJoiningScript } from '../measure/joining';
 import { composesAsCjk } from '../measure/cjkCompose';
@@ -279,6 +284,8 @@ function placeDocumentPass(content, config, cache, options, hints) {
     // their own `resolution` from here on (#631); under the default policy
     // the content is untouched.
     const stampedResources = content.resources && withBitmapResolutions(content.resources, resolved.layout.bitmapResolution);
+    /** The resources as given: whose print size is the author's (#901). */
+    const givenResources = content.resources;
     if (stampedResources && stampedResources !== content.resources)
         content = { ...content, resources: stampedResources };
     // Tracking rungs a loose paragraph may climb: none, then 5‰ steps up to
@@ -493,7 +500,10 @@ function placeDocumentPass(content, config, cache, options, hints) {
     // in a frame is a group of its box.
     const templateSource = { pageTemplates: resolved.pageTemplates, calloutStyles: resolved.calloutStyles };
     const composedWrap = wrapComposedPages(numberedBlocks, templateSource);
-    const flowGroups = resolved.layout.flowColumns ? wrapFlowColumns(composedWrap.blocks) : { blocks: composedWrap.blocks, wrapped: false };
+    // A comic page's text panels (#885): each panel's Markdown in a story
+    // box of the same kind, set in the panel's frame (below).
+    const comicText = wrapComicTextPanels(composedWrap.blocks, comicTextPanelsSupported(resolved));
+    const flowGroups = resolved.layout.flowColumns ? wrapFlowColumns(comicText.blocks) : { blocks: comicText.blocks, wrapped: false };
     const spanEmbeds = wrapPageSpanEmbeds(flowGroups.blocks, content.resources ?? [], effectiveResourceTypes(config, content.resources ?? []));
     // Code listings (#624): each in a box of the code style, which the
     // callout machinery places and splits.
@@ -536,7 +546,7 @@ function placeDocumentPass(content, config, cache, options, hints) {
     for (const b of contentBlocks) {
         const labels = b.resourceId !== undefined && !figureLabelsById.has(b.resourceId) ? figureLabels(b, bodyOffset) : undefined;
         if (labels)
-            figureLabelsById.set(b.resourceId, labels);
+            figureLabelsById.set(b.resourceId, { labels, parsed: b.figure.labels });
     }
     // Resolve styles
     const bodyStyle = resolveBodyStyle(resolved);
@@ -548,7 +558,7 @@ function placeDocumentPass(content, config, cache, options, hints) {
         ...(spanEmbeds.wrapped ? [spanEmbedStyle(bodyStyle.lineHeightPx, resolved.layout.inlineResourceGap !== 'above')] : []),
         ...(codeBoxes.wrapped ? [codeBoxStyle(resolved)] : []),
         // The frameless box of a composed page's story (#855).
-        ...(composedWrap.wrapped ? [frameBoxStyle(Math.max(resolved.bodyText.avoidOrphans ? resolved.bodyText.orphanMinLines : 1, resolved.bodyText.avoidWidows ? resolved.bodyText.widowMinLines : 1))] : []),
+        ...(composedWrap.wrapped || comicText.wrapped ? [frameBoxStyle(Math.max(resolved.bodyText.avoidOrphans ? resolved.bodyText.orphanMinLines : 1, resolved.bodyText.avoidWidows ? resolved.bodyText.widowMinLines : 1))] : []),
         // The boxes of main-flow groups: sub-columns a body line apart in the
         // text column, a gutter apart across the page.
         ...(flowGroups.wrapped
@@ -560,7 +570,7 @@ function placeDocumentPass(content, config, cache, options, hints) {
         : resolved.calloutStyles;
     // A box nested in another looks its style up in the configuration it is
     // laid out with: the listings' box among them.
-    const calloutResolved = codeBoxes.wrapped || flowGroups.wrapped || composedWrap.wrapped ? { ...resolved, calloutStyles } : resolved;
+    const calloutResolved = codeBoxes.wrapped || flowGroups.wrapped || composedWrap.wrapped || comicText.wrapped ? { ...resolved, calloutStyles } : resolved;
     const blockquoteStyle = resolveBlockquoteStyle(resolved);
     const listLevelIndentsPx = computeLevelIndentsPx(resolved, bodyStyle.fontSizePx);
     const orderedMetrics = computeOrderedListRunMetrics(contentBlocks, resolved, bodyStyle.fontSizePx);
@@ -596,10 +606,12 @@ function placeDocumentPass(content, config, cache, options, hints) {
     // story holds does not float. A reference in a frame to a picture set
     // elsewhere floats from the page's end, to the pages after it.
     const composedPlans = planComposedPages(contentBlocks, calloutPlan, templateSource);
-    if (composedPlans.size > 0) {
+    // A comic page's text panels (#885) likewise.
+    const comicTextPlans = comicText.wrapped ? planComicTextPanels(contentBlocks, calloutPlan) : new Map();
+    if (composedPlans.size > 0 || comicTextPlans.size > 0) {
         for (let k = floatPlan.length - 1; k >= 0; k--) {
             const f = floatPlan[k];
-            const page = composedPageAt(composedPlans, f.firstBlockIdx);
+            const page = composedPageAt(composedPlans, f.firstBlockIdx) ?? composedPageAt(comicTextPlans, f.firstBlockIdx);
             if (!page)
                 continue;
             const raw = contentBlocks[f.firstBlockIdx];
@@ -1257,7 +1269,11 @@ function placeDocumentPass(content, config, cache, options, hints) {
         const { block: rb, totalHeight } = laid;
         const id = slice && slice.startRow > 0 ? `float-${resourceId}-cont-${slice.startRow}` : `float-${resourceId}`;
         const blk = createVDTBlock(id, 'resource', bodyStyle.fontString, bodyStyle.color, bodyStyle.textAlign);
-        const labels = figureLabelsById.get(resourceId);
+        // A floated figure's labels, laid out on its picture as set (#860).
+        const figure = figureLabelsById.get(resourceId);
+        const labels = figure
+            ? layOutFigureLabels(figure.labels, figure.parsed, rb, { resolved, resourceNumbering, resourceTypes, resources, ...(cache ? { cache } : {}) })
+            : undefined;
         blk.resourceBlock = labels ? { ...rb, labels } : rb;
         blk.dirty = false;
         blk.snappedToGrid = false;
@@ -4000,6 +4016,18 @@ function placeDocumentPass(content, config, cache, options, hints) {
         withStripPlaceholder(blk, stripGeometry(idx, raw.comic, width, contentArea.height - 2 * floatGapPx, pageIsVertical(doc.pages[cursor.pageIndex])));
         return blk;
     };
+    /** The room a heading's design takes in a box or a frame (#906): as in
+     *  a column (see the heading placement below), against the heading's
+     *  box; a `span: 'page'` heading is laid out at the box's width too. */
+    const boxHeadingDesign = (raw, blockIdx, lines, pref, headingNumber, width) => {
+        const lvl = headingLevels.forBlock(raw);
+        if (!lvl?.advancedDesign.enabled)
+            return undefined;
+        const { titleText, marked } = defaultOpenerTitle(lines, pref, raw.titleBreaks, raw.text.length, lvl.numberSeparator);
+        const info = { titleText, ...(marked !== undefined ? { titleMarked: marked } : {}), formattedNumber: pref, numericValue: headingNumber, locale: resolvedLocale(resolved), ...(resolved.numerals ? { numerals: resolved.numerals } : {}), chapterNumber: chapterNumberByBlock[blockIdx] ?? '', attrs: raw.attrs };
+        const design = measureHeadingDesign(lvl, info, width, resolved.page.dpi, doc.metadata, cursor.pageIndex, undefined, undefined, resourceById);
+        return Math.max(design.height, design.textFloor);
+    };
     /** What the box typesetter (`frameLayout.ts`) reads of this pass. */
     const framePass = {
         contentBlocks,
@@ -4013,6 +4041,7 @@ function placeDocumentPass(content, config, cache, options, hints) {
             : measureCtx),
         stripBlock: calloutStripBlock,
         columnHeight: () => contentArea.height,
+        headingDesign: (raw, blockIdx, heading, width) => boxHeadingDesign(raw, blockIdx, heading.lines, heading.numberPrefix, heading.headingNumber, width),
     };
     const makeCalloutLayouter = (startIdx, plan, style) => makeCalloutLayouterIn(framePass, startIdx, plan, style);
     /** Whether a page swaps its mirrored margins (a verso of a left-bound
@@ -5932,6 +5961,19 @@ function placeDocumentPass(content, config, cache, options, hints) {
             return false;
         },
     };
+    /** Every frame of the composed pages laid so far, by id: a story that
+     *  jumps to a later page (#917) links its pieces across pages. */
+    const frameAt = new Map();
+    /** The planned composed pages by their fence's `id` (#917): where a
+     *  `'page:<id>'` continuation lands. */
+    const fenceById = new Map();
+    for (const pl of composedPlans.values()) {
+        const id = contentBlocks[pl.startIdx]?.composedPage?.attrs.id;
+        if (id !== undefined && id !== '' && !fenceById.has(id))
+            fenceById.set(id, pl);
+    }
+    /** Stories waiting for the later page fence they jump to, by its id. */
+    const jumps = new Map();
     /** Set the composed page `planned` on a fresh page (#855), or a spread
      *  template on the two facing pages from the next verso (#861). */
     const placeComposedPage = (planned, fence) => {
@@ -5967,10 +6009,10 @@ function placeDocumentPass(content, config, cache, options, hints) {
         });
         const placed = [];
         let laid;
-        const sheet = resolvePageTemplate(templateSource, fence.template, { spread: true });
-        if (sheet?.spread) {
-            // A spread opens on a verso, a parity blank before it when needed,
-            // as a comic spread does; the recto after it takes the other half.
+        /** Lay a spread template over the next verso and the recto after it
+         *  (`breakToEvenPage` opens the verso, a parity blank before it when
+         *  needed, as a comic spread does). */
+        const laySpread = (sheet, extra) => {
             breakToEvenPage();
             const verso = doc.pages[cursor.pageIndex];
             verso.columns = [createVDTColumn(0, verso.contentArea)];
@@ -5982,50 +6024,262 @@ function placeDocumentPass(content, config, cache, options, hints) {
             recto.columns = [createVDTColumn(0, recto.contentArea)];
             cursor.columnIndex = 0;
             // The sheet is laid in the pages' flow: the left page first, or the
-            // right one where the flow is mirrored (right to left).
+            // right one where the flow is mirrored (right to left) or turned (a
+            // vertical page, #926: the flow's y runs from the sheet's right edge
+            // to its left, and the right page comes first along it).
             const versoIsLeft = resolved.page.binding !== 'right';
-            const flowMirrored = pageIsMirrored(verso);
+            const vertical = pageIsVertical(verso);
+            const flowMirrored = pageIsMirrored(verso) || vertical;
             const left = versoIsLeft ? verso : recto;
             const right = versoIsLeft ? recto : verso;
+            const frames = designFramesOn(verso);
             const out = layoutComposedSpread({
                 ...common(flowMirrored ? right : left, { id: sheet.id, spread: true }),
+                ...extra,
                 template: sheet,
                 first: flowMirrored ? right : left,
                 second: flowMirrored ? left : right,
                 firstSide: flowMirrored ? 'right' : 'left',
-                trim: pageMetrics.physical.trimBox,
-                bleed: pageMetrics.physical.bleedBox,
+                trim: frames.page,
+                bleed: frames.bleed,
+                ...(vertical ? { axis: 'y' } : {}),
             });
+            return { sides: out.sides, warnings: out.warnings, laid: out.laid, continuations: out.continuations };
+        };
+        /** The template `id` for the current page's side, and the boxes its
+         *  `area` reads. */
+        const singleOn = (page, id) => {
+            page.columns = [createVDTColumn(0, page.contentArea)];
+            // The physical side: a recto has an odd folio (in either binding).
+            const parity = (page.index + pageIndexOffset) % 2 === 0 ? 'recto' : 'verso';
+            const template = resolvePageTemplate(templateSource, id, { parity });
+            const frames = designFramesOn(page);
+            const area = template.area === 'trim' ? frames.page : template.area === 'bleed' ? frames.bleed : page.contentArea;
+            return { parity, template, areas: { area, page: frames.page, bleed: frames.bleed } };
+        };
+        let continuations;
+        // Stories that jump to this page (#917): they go on in the frames its
+        // own content leaves empty; those that find none go on after it.
+        const incoming = fence.attrs.id !== undefined ? jumps.get(fence.attrs.id) ?? [] : [];
+        if (fence.attrs.id !== undefined)
+            jumps.delete(fence.attrs.id);
+        let jumpReceivers = new Map();
+        let jumpLeft = [];
+        const receive = (template) => {
+            if (incoming.length === 0)
+                return {};
+            const names = new Set(template.frames.map((f) => f.name));
+            const prev = new Map();
+            for (const f of template.frames) {
+                const n = nextFrameOf(f);
+                if (n && names.has(n) && !prev.has(n))
+                    prev.set(n, f.name);
+            }
+            const headOf = (n) => {
+                const seen = new Set([n]);
+                let at = n;
+                for (let q = prev.get(at); q !== undefined && !seen.has(q); q = prev.get(at)) {
+                    seen.add(q);
+                    at = q;
+                }
+                return at;
+            };
+            const assigned = assignJumpReceivers(template, incoming, (n) => planned.stories.has(headOf(n)));
+            jumpReceivers = assigned.receivers;
+            jumpLeft = assigned.left;
+            return {
+                stories: new Map([...planned.stories, ...[...jumpReceivers].map(([n, c]) => [n, c.story])]),
+                continuing: { receivers: jumpReceivers, generation: 0, collapse: false, last: false, jump: true },
+            };
+        };
+        const sheet = resolvePageTemplate(templateSource, fence.template, { spread: true });
+        if (sheet?.spread) {
+            const out = laySpread(sheet, receive(sheet));
             placed.push(...out.sides);
             composedNotes.push(...out.warnings);
             laid = out.laid;
+            continuations = out.continuations;
         }
         else {
             const page = doc.pages[cursor.pageIndex];
-            page.columns = [createVDTColumn(0, page.contentArea)];
-            // The physical side: a recto has an odd folio (in either binding).
-            const parity = (page.index + pageIndexOffset) % 2 === 0 ? 'recto' : 'verso';
-            const template = resolvePageTemplate(templateSource, fence.template, { parity });
-            const frames = designFramesOn(page);
-            const area = template.area === 'trim' ? frames.page : template.area === 'bleed' ? frames.bleed : page.contentArea;
+            const { parity, template, areas } = singleOn(page, fence.template);
+            const extra = receive(template);
             // Kept by what it reads (#857): a page met again is not set again.
-            // A spread is laid out afresh each time (its two sides are one sheet).
-            const out = layoutComposedPageMemo({
-                ...common(page, { id: template.id, spread: false, parity }),
-                page,
-                template,
-                areas: { area, page: frames.page, bleed: frames.bleed },
-            }, composedMemo);
+            // A spread is laid out afresh each time (its two sides are one sheet),
+            // and so is a page a story jumps to.
+            const args = { ...common(page, { id: template.id, spread: false, parity }), page, template, areas };
+            const out = extra.continuing ? layoutComposedPage({ ...args, ...extra }) : layoutComposedPageMemo(args, composedMemo);
             placed.push({ page, composed: out.composed, blocks: out.blocks });
             composedNotes.push(...out.warnings);
             laid = out.laid;
+            continuations = out.continuations;
         }
-        for (const { page, composed, blocks } of placed) {
-            page.composed = composed;
-            const floats = (page.floats ??= []);
-            for (const b of blocks) {
-                floats.push(b);
-                doc.blocks.push(b);
+        // A jumping story that found no free frame here goes on after it.
+        if (jumpLeft.length > 0)
+            continuations = [...(continuations ?? []), ...jumpLeft.map((c) => ({ ...c, rule: 'next-page', template: placed[0].composed.template, collapsed: false }))];
+        const commit = (list) => {
+            for (const { page, composed, blocks } of list) {
+                page.composed = composed;
+                const floats = (page.floats ??= []);
+                for (const b of blocks) {
+                    floats.push(b);
+                    doc.blocks.push(b);
+                }
+            }
+        };
+        commit(placed);
+        // Content that goes on on pages added after this one (#859): one page
+        // (or spread) per template it goes on to, generation after generation,
+        // each laid afresh after the pages before it. The added pages are
+        // ordinary pages (numbered, with running heads, sides kept).
+        const indexFrames = (list) => {
+            for (const s of list)
+                for (const f of s.composed.frames)
+                    if (!f.facingBlocks)
+                        frameAt.set(f.id, { page: s.page, frame: f });
+        };
+        indexFrames(placed);
+        /** The sending frame of `c` points to the frame `to` that took it, and
+         *  its page's log says where it went. */
+        const link = (c, to) => {
+            const src = frameAt.get(c.fromFrameId);
+            const dst = frameAt.get(to);
+            if (!src || !dst)
+                return;
+            src.frame.continuesTo = to;
+            const log = src.page.composed.log;
+            let at = log.length;
+            for (let i = log.length - 1; i >= 0; i--) {
+                if (log[i].frame === c.frame) {
+                    at = i + 1;
+                    break;
+                }
+            }
+            log.splice(at, 0, { frame: c.frame, kind: 'continued', toPage: dst.page.index, toFrame: to });
+        };
+        for (const [name, c] of jumpReceivers)
+            link(c, frameElementId(fence.fenceIndex, name));
+        /** Stories that jump to a later page fence (#917) wait for it; one
+         *  whose fence is not after this page goes on on the next page, and
+         *  says so. */
+        const route = (list) => {
+            const out = [];
+            for (const c of list) {
+                const target = continueInPage(c.rule);
+                if (!target) {
+                    out.push(c);
+                    continue;
+                }
+                const to = fenceById.get(target.page);
+                if (to && to.startIdx > planned.endIdx) {
+                    const waiting = jumps.get(target.page) ?? [];
+                    waiting.push(c);
+                    jumps.set(target.page, waiting);
+                    continue;
+                }
+                const from = frameAt.get(c.fromFrameId);
+                composedNotes.push({
+                    kind: 'continueTargetMissing',
+                    template: c.template,
+                    frame: c.frame,
+                    fenceIndex: fence.fenceIndex,
+                    target: target.page,
+                    configPath: resolvePageTemplate(templateSource, c.template)?.frames.find((f) => f.name === c.frame)?.configPath ?? '',
+                    ...(to ? { before: true } : {}),
+                    ...(from?.frame.sourceStart !== undefined ? { sourceStart: from.frame.sourceStart, sourceEnd: from.frame.sourceEnd } : {}),
+                    ...(from ? { pageIndex: from.page.index } : {}),
+                });
+                out.push({ ...c, rule: 'next-page' });
+            }
+            return out;
+        };
+        const overflowTemplateOf = (id) => resolvePageTemplate(templateSource, id)?.overflowTemplate;
+        const firstPage = placed[0]?.page.index ?? cursor.pageIndex;
+        let pending = route(continuations ?? []);
+        for (let generation = 1; pending.length > 0; generation++) {
+            const last = generation >= MAX_CONTINUATION_PAGES;
+            let queue = pending;
+            pending = [];
+            while (queue.length > 0) {
+                const target = continuationTarget(queue[0], overflowTemplateOf);
+                const same = (c) => {
+                    const t = continuationTarget(c, overflowTemplateOf);
+                    return t.template === target.template && t.collapse === target.collapse;
+                };
+                const batch = queue.filter(same);
+                queue = queue.filter((c) => !same(c));
+                const spreadSheetT = resolvePageTemplate(templateSource, target.template, { spread: true });
+                // A template with no frames takes nothing.
+                if (!spreadSheetT || spreadSheetT.frames.length === 0)
+                    continue;
+                // A fresh page after the last one laid.
+                const start = cursor.pageIndex;
+                do {
+                    advanceToNextColumn(doc, cursor, geomResolved, contentArea, pageWidthPx, pageHeightPx);
+                } while (cursor.pageIndex === start);
+                cursor.columnIndex = 0;
+                const storiesOf = (receivers) => new Map([...receivers].map(([name, c]) => [name, c.story]));
+                let sides;
+                let notes;
+                let more;
+                let receivers;
+                let laidTemplate;
+                if (spreadSheetT.spread) {
+                    const assigned = assignReceivers(spreadSheetT, batch);
+                    receivers = assigned.receivers;
+                    queue = [...assigned.left, ...queue];
+                    laidTemplate = spreadSheetT;
+                    const out = laySpread(spreadSheetT, { stories: storiesOf(receivers), continuing: { receivers, generation, collapse: target.collapse, last } });
+                    sides = out.sides;
+                    notes = out.warnings;
+                    more = out.continuations;
+                }
+                else {
+                    const page = doc.pages[cursor.pageIndex];
+                    const { parity, template, areas } = singleOn(page, target.template);
+                    const assigned = assignReceivers(template, batch);
+                    receivers = assigned.receivers;
+                    queue = [...assigned.left, ...queue];
+                    laidTemplate = template;
+                    const out = layoutComposedPage({
+                        ...common(page, { id: template.id, spread: false, parity }),
+                        page,
+                        template,
+                        areas,
+                        stories: storiesOf(receivers),
+                        continuing: { receivers, generation, collapse: target.collapse, last },
+                    });
+                    sides = [{ page, composed: out.composed, blocks: out.blocks }];
+                    notes = out.warnings;
+                    more = out.continuations;
+                }
+                for (const s of sides)
+                    s.composed.continuationOf = firstPage;
+                // On the last page allowed, a frame whose content would still go on
+                // says so (it is cut at its foot).
+                if (last) {
+                    const chained = new Set();
+                    const nextOf = (n) => {
+                        const f = laidTemplate.frames.find((x) => x.name === n);
+                        return f ? nextFrameOf(f) : undefined;
+                    };
+                    for (const name of receivers.keys()) {
+                        for (let n = name; n !== undefined && !chained.has(n); n = nextOf(n))
+                            chained.add(n);
+                    }
+                    notes = notes.map((w) => (w.kind === 'frameOverflow' && chained.has(w.frame)
+                        ? { kind: 'frameContinuationLimit', template: w.template, frame: w.frame, fenceIndex: w.fenceIndex, pages: generation, overflowMm: w.overflowMm, configPath: w.configPath, ...(w.sourceStart !== undefined ? { sourceStart: w.sourceStart, sourceEnd: w.sourceEnd } : {}), ...(w.pageIndex !== undefined ? { pageIndex: w.pageIndex } : {}) }
+                        : w));
+                }
+                commit(sides);
+                indexFrames(sides);
+                composedNotes.push(...notes);
+                // Each frame that sent content on points to the frame that took it,
+                // and its page's log says where it went.
+                for (const c of receivers.values())
+                    link(c, frameElementId(fence.fenceIndex, c.slot, generation));
+                if (more)
+                    pending.push(...route(more));
             }
         }
         for (const [head, story] of planned.stories) {
@@ -6037,6 +6291,39 @@ function placeDocumentPass(content, config, cache, options, hints) {
         pendingComposedBreak = 'page';
         flushPendingNumberingAtBoundary();
     };
+    /**
+     * The text panels of a comic page (#885): each story set in its panel's
+     * frame (`layoutComicTextFrames`), its blocks floats of the page; the
+     * stories laid are done for the main loop.
+     */
+    const placeComicText = (page, comic, plan) => {
+        const frameless = calloutStyles.find((st) => st.id === FRAME_STYLE_ID);
+        const out = layoutComicTextFrames({
+            pass: framePass,
+            resolved,
+            page,
+            comic,
+            plan,
+            styleOf: (frame) => frameStyleOf((frame.style ? resolved.calloutStyles.find((st) => st.id === frame.style) : undefined) ?? frameless, frame),
+            dpi,
+            emPx: bodyStyle.fontSizePx,
+            bodyOffset,
+            mirrored: mirroredOf(page),
+            pushGapPx: wrapGapPx(resolved.layout.wrap?.gap, dpi, bodyStyle.fontSizePx, floatGapPx),
+            locale: resolvedLocale(resolved),
+        });
+        const floats = (page.floats ??= []);
+        for (const b of out.blocks) {
+            floats.push(b);
+            doc.blocks.push(b);
+        }
+        for (const [key, story] of plan.stories) {
+            if (!out.laid.has(key))
+                continue;
+            for (let i = story.startIdx; i <= story.plan.endIdx; i++)
+                composedLaid.add(i);
+        }
+    };
     /** The first block of the document that sets something: a heading there
      *  opens the document's first page (`openerPages`, #749). */
     const firstFlowBlockIdx = contentBlocks.findIndex((b) => !isMarkerBlock(b) && b.type !== 'directive');
@@ -6321,6 +6608,9 @@ function placeDocumentPass(content, config, cache, options, hints) {
                         sourceOffset: bodyOffset,
                         mirrorMargins: pageMirrored(resolved, page.index, pageIndexOffset, true),
                     });
+                    const textPlan = comicTextPlans.get(blockIdx);
+                    if (textPlan)
+                        placeComicText(page, page.comic, textPlan);
                 }
                 pendingComicBreak = true;
                 flushPendingNumberingAtBoundary();
@@ -8277,6 +8567,9 @@ function placeDocumentPass(content, config, cache, options, hints) {
         page.pageLabel = info.label;
         page.pageNumberFormat = info.format;
     }
+    // Continuation marks with a page number (#917): the page the rest goes
+    // on on, or comes from, now that pages are numbered.
+    fillPageMarks(doc.pages);
     const restarts = pageNumberSegments
         .filter((s, i) => i > 0 && s.startAt !== undefined && s.startPageIndex < doc.pages.length)
         .map((s) => s.startPageIndex);
@@ -8312,6 +8605,8 @@ function placeDocumentPass(content, config, cache, options, hints) {
     // reverse of their visual order.
     if (doc.pages.some((p) => pageIsMirrored(p)))
         orientLinesToFrames(doc);
+    // Figure labels (#860): where each one is painted, for the source map.
+    stampFigureLabelRects(doc);
     doc.converged = true;
     doc.iterationCount = 1;
     if (joiningLetterSpacing.size > 0)
@@ -8323,8 +8618,13 @@ function placeDocumentPass(content, config, cache, options, hints) {
         const b = contentBlocks[idx];
         return b ? { start: b.sourceStart + bodyOffset, end: b.sourceEnd + bodyOffset } : undefined;
     });
-    if (shrunk.length > 0)
-        floatShrinkWarningsByDoc.set(doc, shrunk);
+    // Pictures whose column holds them under half their print size (#901).
+    const belowPrint = pictureBelowPrintSizeWarnings(doc, givenResources, (idx) => {
+        const b = contentBlocks[idx];
+        return b ? { start: b.sourceStart + bodyOffset, end: b.sourceEnd + bodyOffset } : undefined;
+    });
+    if (shrunk.length > 0 || belowPrint.length > 0)
+        floatShrinkWarningsByDoc.set(doc, [...shrunk, ...belowPrint]);
     if (textWrapNotes.length > 0 || columnsNotes.length > 0)
         textWrapWarningsByDoc.set(doc, [...textWrapNotes, ...columnsNotes]);
     // Composed pages (#855): frames whose content does not fit.
@@ -8410,6 +8710,9 @@ export function* buildDocumentGen(content, config, cache, options) {
     loose.push(...afterTextWarnings(doc), ...(unplacedByDoc.get(doc) ?? []));
     // Design texts cut to fit their width (#628).
     loose.push(...designTruncationWarnings(doc));
+    // Figure labels at anchors their picture lacks, anchors left without a
+    // word in this locale (#860).
+    loose.push(...figureLabelWarnings(doc, (b) => (b.sourceStart !== undefined && b.sourceEnd !== undefined ? { start: b.sourceStart, end: b.sourceEnd } : undefined)));
     // Comic panels whose cell cannot hold their picture's safe area (#556).
     for (const page of doc.pages) {
         if (page.comic)
@@ -8460,7 +8763,8 @@ const indexWarnings = new WeakMap();
 const joiningSpacingWarnings = new WeakMap();
 /** The `dropCap` warnings of the last pass, per document (#623). */
 const dropCapWarningsByDoc = new WeakMap();
-/** The `floatShrunk` warnings of a build (#626), found by its last pass. */
+/** The `floatShrunk` (#626) and `pictureBelowPrintSize` (#901) warnings
+ *  of a build, found by its last pass. */
 const floatShrinkWarningsByDoc = new WeakMap();
 /** The `textWrap` warnings of a build (#627) and its `columnsTooNarrow`
  *  ones (#634), found by its last pass. */
@@ -8494,6 +8798,49 @@ function afterTextWarnings(doc) {
     }
     return out;
 }
+/**
+ * Write the page numbers into the continuation marks of composed pages'
+ * frames (#917, `VDTDesignTextBlock.pageMark`): `{page}` becomes the label
+ * of the page the frame's rest goes on on (`continuesTo`) or comes from
+ * (`continuedFrom`). The mark was laid out with a guess of the number; its
+ * lines are measured again with the true one and keep their alignment.
+ */
+function fillPageMarks(pages) {
+    const frames = new Map();
+    for (const p of pages)
+        for (const f of p.composed?.frames ?? [])
+            if (!f.facingBlocks)
+                frames.set(f.id, p);
+    for (const p of pages) {
+        for (const f of p.composed?.frames ?? []) {
+            for (const id of f.blockIds) {
+                const box = p.floats?.find((b) => b.id === id);
+                for (const d of box?.designOverlay?.blocks ?? []) {
+                    if (d.kind !== 'text' || !d.pageMark)
+                        continue;
+                    const other = d.pageMark.page === 'to' ? f.continuesTo : f.continuedFrom;
+                    const at = other !== undefined ? frames.get(other) : undefined;
+                    if (!at)
+                        continue;
+                    const label = at.pageLabel ?? String(at.pageNumberValue ?? at.index + 1);
+                    const text = d.pageMark.text.split('{page}').join(label);
+                    const lh = d.lines.length > 0 ? d.bbox.height / d.lines.length : d.bbox.height;
+                    const first = d.lines[0];
+                    const slack0 = first ? d.bbox.width - first.width : 0;
+                    const align = !first || first.xOffset < 0.5 ? 'left' : Math.abs(first.xOffset - slack0) < 0.5 ? 'right' : 'center';
+                    const base = first ? first.baselineY - d.bbox.y : lh * 0.8;
+                    const { lines } = measureRichBlock([{ text, bold: false, italic: false }], d.fontString, d.fontString, d.fontString, d.fontString, d.bbox.width, lh, { textAlign: 'left' });
+                    if (lines.length === 0)
+                        continue;
+                    d.lines = lines.map((ln, i) => {
+                        const slack = Math.max(0, d.bbox.width - ln.bbox.width);
+                        return { text: ln.text, xOffset: align === 'right' ? slack : align === 'center' ? slack / 2 : 0, baselineY: d.bbox.y + base + i * lh, width: ln.bbox.width };
+                    });
+                }
+            }
+        }
+    }
+}
 /** `doc` with the page of each of its index marks (`doc.indexMarks`). */
 function withIndexMarks(doc, content) {
     const { content: body, contentOffset } = extractFrontmatter(content.markdown);