postext 1.8.6 → 1.9.1

package/dist/pipeline/build.js

@@ -7,8 +7,12 @@ import { buildPageLabels, computeHeadingNumbering, parseNumberFormat, } from '..
 import { extractFrontmatter, normalizeMetadata } from '../frontmatter';
 import { collectConfigWarnings } from '../configWarnings';
 import { initHyphenator } from '../measure';
+import { getCjkLineBreak, setCjkLineBreak } from '../measure/cjkClasses';
+import { cjkCompositionOf, getCjkComposition, setCjkComposition } from '../measure/cjkPunctuation';
+import { getMeasureRegion, getMeasureUprightDigits, getMeasureWritingMode, setMeasureUprightDigits, setMeasureWritingMode } from '../measure/vertical';
+import { stampCentralBaselines } from './verticalMetrics';
 import { resolveAllConfig, computeBaselineGrid, resolvedLocale } from './config';
-import { createHeadingLevelResolver, deriveSectionGeometryConfig, deriveSectionMeasureContext, headingIsHidden, headingIsNumbered, headingMarksFor, headingStyleOf, planHeadingSections, } from './headingStyles';
+import { createHeadingLevelResolver, deriveSectionGeometryConfig, sectionWritingMode, deriveSectionMeasureContext, headingIsHidden, headingIsNumbered, headingMarksFor, headingStyleOf, planHeadingSections, } from './headingStyles';
 import { computeOutline, hasIndexDirective, hasTocDirective, headingNumberingOptions, headingTemplatesOf, outlineFromDoc, sameOutline } from './outline';
 import { expandTocDirectives } from './toc';
 import { expandIndexDirectives, locateIndexMarks } from './indexDirective';
@@ -16,7 +20,7 @@ import { resolveBodyStyle, resolveBlockquoteStyle, resolveParagraphStyle } from
 import { computeLevelIndentsPx, computeOrderedLevelIndentsPx, computeOrderedListRunMetrics, listBulletPosition, listItemGapPx, listItemSpacingPx, } from './lists';
 import { resetLinePositions, createPageWithColumns, currentColumn, advanceToNextColumn, advanceToNextPageBoundary, enforcePageParity, placeBlockInColumn, placeAtomicBlock, createPartPage, pageHasContent, sideColumnOf, sideColumns, sideUsedBottom, pageIsOccupied, bandColumns, currentBand, isBandLevel, bandUsedBottom, closeBandAndInsertSpan, pageLayoutOf, } from './placement';
 import { chooseParagraphSplit } from './orphanWidow';
-import { applyStyleAttrs, computePageMetrics, isMarkerBlock, nextNonMarkerBlock, spaceLinesAfter, prevNonMarkerBlock, rollbackTrailingBlocks, } from './buildHelpers';
+import { applyStyleAttrs, computePageMetrics, pageMirrored, sheetRectToFlow, isMarkerBlock, nextNonMarkerBlock, spaceLinesAfter, prevNonMarkerBlock, rollbackTrailingBlocks, } from './buildHelpers';
 import { measureContentBlock } from './measureContentBlock';
 import { planParagraphContainers } from './paragraphContainers';
 import { appendChapterEndNotes, footnoteIdsOfLines, footnoteParagraphStyle, noteContentBlock, numberFootnotes, splitFootnoteDefinitions, withFootnoteStyle, } from './footnotes';
@@ -34,7 +38,9 @@ import { chapterNumberCounter, leadingBoldText } from './placeholders';
 import { proposeBalanceLines, collectColumnGaps, firstDivergentColumn, gapLinesIn, boxRoomIn, boxLeverKeys, pageSegments, MAX_BALANCING_PASSES, MAX_BALANCING_PASSES_PER_DOCUMENT, balanceKey } from './columnBalancing';
 import { applyBandCap, uncapBand, columnBottom, bandCapLines, bandTop, bareBandTop, resolveBandCapsGen, drainPasses, resolveTrailingCapsGen, bandCapLinesAroundZone, } from './bandCaps';
 import { raggedLooseLines } from './raggedLines';
-import { collectContentWarnings, locateContentWarnings } from './contentWarnings';
+import { cjkLooseLineWarnings, collectContentWarnings, locateContentWarnings } from './contentWarnings';
+import { annotateDocument } from '../cjkMarks';
+import { withBookTitleBrackets } from './annotations';
 /** Tolerance for "does this block fit" checks against a column's free
  *  height, absorbing floating-point drift between grid multiples. */
 const FIT_EPS = 0.01;
@@ -109,7 +115,9 @@ function measureLooseParagraph(rawBlock, blockIdx, columnWidth, ctx, styleOverri
     const optimum = measureContentBlock(rawBlock, blockIdx, columnWidth, ctx, { styleOverride, looseness: 0 });
     const looseness = optimum ? target - optimum.measured.lines.length : extraLines;
     const maxWordSpacing = ctx.resolved.bodyText.maxWordSpacing + 1e-9;
-    const withinLimit = (lines) => lines.every((l) => l.isLastLine || l.justifiedSpaceRatio === undefined || l.justifiedSpaceRatio <= maxWordSpacing);
+    // A CJK line spread past its tracking cap (`cjkLoose`) is past the
+    // limit too.
+    const withinLimit = (lines) => lines.every((l) => l.isLastLine || ((l.justifiedSpaceRatio === undefined || l.justifiedSpaceRatio <= maxWordSpacing) && !l.cjkLoose));
     for (const tracking of trackingLadder) {
         const loose = measureContentBlock(rawBlock, blockIdx, columnWidth, ctx, {
             styleOverride,
@@ -138,6 +146,26 @@ function measureLooseParagraph(rawBlock, blockIdx, columnWidth, ctx, styleOverri
  * @internal Exposed for tests only; use `buildDocument`.
  */
 export function buildDocumentPass(content, config, cache, options, hints = {}) {
+    // A pass sets the CJK line-break level, the CJK composition and the
+    // writing mode text is measured in for its own measuring; what the caller had in force is put
+    // back when it ends, also when it throws (a cancelled build), so text
+    // measured outside a build reads as it did before it.
+    const lineBreak = getCjkLineBreak();
+    const composition = getCjkComposition();
+    const writingMode = getMeasureWritingMode();
+    const region = getMeasureRegion();
+    const uprightDigits = getMeasureUprightDigits();
+    try {
+        return placeDocumentPass(content, config, cache, options, hints);
+    }
+    finally {
+        setCjkLineBreak(lineBreak);
+        setCjkComposition(composition);
+        setMeasureWritingMode(writingMode, region);
+        setMeasureUprightDigits(uprightDigits);
+    }
+}
+function placeDocumentPass(content, config, cache, options, hints) {
     const { balanceExtraPx, balanceLooseness, balanceLooseBudget, bandCaps, captionUnder } = hints;
     const captionUnderProposals = new Set();
     /** Side columns whose foot a figure's side caption has cut, by the figure. */
@@ -170,6 +198,18 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
     // syllable even in ragged text. Left unset, a build would hyphenate with
     // whichever dictionary the previous one (or the default, en-us) chose.
     initHyphenator(resolved.bodyText.hyphenation.locale);
+    // CJK text breaks at the document's level wherever it is measured (body,
+    // captions, cells, notes, boxes), as it hyphenates in its language.
+    setCjkLineBreak(resolved.cjk.lineBreak);
+    // And is composed with the document's punctuation widths, hanging and
+    // Han–Latin space (along the line in either writing mode), in its
+    // language.
+    setCjkComposition(cjkCompositionOf(resolved.cjk, resolved.page.dpi, resolvedLocale(resolved)));
+    // Characters of a vertical flow that stand in a cell advance by it (half
+    // an em for the mainland interpunct).
+    setMeasureWritingMode(resolved.layout.writingMode, resolved.cjk.region);
+    // Short numbers set in one upright cell (`cjk.uprightDigits`).
+    setMeasureUprightDigits(resolved.cjk.uprightDigits);
     // Compute baseline grid
     const baselineGrid = computeBaselineGrid(resolved);
     // Create document
@@ -201,9 +241,21 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
     // styled section with its own margins / layout — the section's.
     let contentArea = pageMetrics.contentArea;
     let geomResolved = resolved;
-    // Page/bleed frames for design elements anchored to `'page'` / `'bleed'`.
-    const designFrames = { page: pageMetrics.trimBox, bleed: pageMetrics.bleedBox };
+    // Page/bleed frames for design elements anchored to `'page'` / `'bleed'`,
+    // in the frame of the page's flow: the sheet's, or on a vertical page
+    // (`page.flow`) the flow frame, where "the top of the page" is the
+    // sheet's right edge.
+    const physicalFrames = { page: pageMetrics.physical.trimBox, bleed: pageMetrics.physical.bleedBox };
+    const verticalFrames = {
+        page: sheetRectToFlow(pageMetrics.physical.trimBox, pageWidthPx),
+        bleed: sheetRectToFlow(pageMetrics.physical.bleedBox, pageWidthPx),
+        upright: true,
+    };
+    const designFramesOn = (page) => (page?.flow ? verticalFrames : physicalFrames);
     doc.trimOffset = trimOffset;
+    // A right-bound book (`page.binding`): hosts show its spreads mirrored.
+    if (resolved.page.binding === 'right')
+        doc.binding = 'right';
     // Create first page
     const firstPage = createPageWithColumns(0, resolved, contentArea, pageWidthPx, pageHeightPx, pageIndexOffset);
     doc.pages.push(firstPage);
@@ -289,7 +341,11 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
     // chapter already numbered (`continuation.resourceNumbers`) was placed
     // there: here it is only referred to, never floated again.
     const incorporated = new Set(Object.keys(continuation?.resourceNumbers ?? {}));
-    const floatPlan = computeFloatPlan(contentBlocks, resources, resourceTypes, incorporated);
+    // A resource first referred to in a vertical flow stands upright: a turn
+    // it asks for is not applied there. Decided per block, by the writing
+    // mode of the styled section the reference sits in (a horizontal
+    // appendix of a vertical book turns its figures as asked).
+    const floatPlan = computeFloatPlan(contentBlocks, resources, resourceTypes, incorporated, (blockIdx) => sectionWritingMode(sectionPlan, resolved, blockIdx) === 'vertical-rl');
     const floatedIds = floatedResourceIds(floatPlan, incorporated, resources, resourceTypes);
     const floatsByFirstBlock = new Map();
     for (const f of floatPlan) {
@@ -554,7 +610,7 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
             }
         }
     };
-    const rotationKey = (rotated) => rotated ? `:${rotated.direction}${rotated.length.toFixed(2)}` : '';
+    const rotationKey = (rotated) => rotated ? `:${rotated.direction}${rotated.length.toFixed(2)}${rotated.upright ? 'u' : ''}` : '';
     const asideKey = (a) => (a ? `:aside${a.dx.toFixed(1)}x${a.width.toFixed(1)}${a.alignBottom ? 'b' : 't'}${(a.offsetY ?? 0).toFixed(1)}` : '');
     const layoutFloat = (resourceId, width, slice, rotated, aside) => {
         const resource = resourceById.get(resourceId);
@@ -570,16 +626,26 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
             resourceTypes,
             resources,
             ...(slice ? { slice } : {}),
-            ...(rotated ? { rotate: rotated.direction, rotatedLength: rotated.length } : {}),
+            ...(rotated ? (rotated.upright ? { upright: { maxLength: rotated.length } } : { rotate: rotated.direction, rotatedLength: rotated.length }) : {}),
             ...(aside ? { captionAside: aside } : {}),
         });
     };
     /** The rotation of a pending float on a band whose columns keep `avail`
      *  px: the upright frame is as long as the grid multiple within that
      *  room, less the float gap, so the band it takes is `avail` at most. */
-    const rotationFor = (f, avail) => f.rotate
-        ? { direction: f.rotate, length: Math.max(1, Math.floor((avail + 0.01) / baselineGrid) * baselineGrid - floatGapPx) }
-        : undefined;
+    const rotationFor = (f, avail, page) => page?.flow
+        ? uprightOn(page)
+        : f.rotate
+            ? { direction: f.rotate, length: Math.max(1, Math.floor((avail + 0.01) / baselineGrid) * baselineGrid - floatGapPx) }
+            : undefined;
+    /** A resource on a vertical page stands upright: its frame at most as
+     *  wide as the page's flow is tall (the content area's width on the
+     *  sheet), the float gap kept. */
+    const uprightOn = (page) => ({
+        direction: 'ccw',
+        length: Math.max(1, Math.floor((page.contentArea.height + 0.01) / baselineGrid) * baselineGrid - floatGapPx),
+        upright: true,
+    });
     /** Row count of a table resource (0 for anything else). */
     const tableRowCount = (resourceId) => resourceById.get(resourceId)?.table?.model.rows.length ?? 0;
     /** What a table resource does when taller than the page — its own
@@ -660,7 +726,9 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
      *  when the resource id is unknown. Caller offsets it to its final `y`. */
     const buildFloatBlock = (resourceId, x, width, slice, rotated, 
     /** A rotated block sits flush to the band's right edge (the spine of a
-     *  verso page) instead of its left. */
+     *  verso page) instead of its left; a number is the share of the room
+     *  left over set before it (an upright block of a vertical page, set
+     *  per `placement.align` along its tier). */
     flushEnd = false, aside, 
     /** The page is a verso of mirrored margins (a floated box's `'outer'`
      *  corner icon hangs on the left there). */
@@ -688,7 +756,8 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
             // top-left lands at the bottom-left of the block, for a clockwise one
             // at its top-right (see `resourceBlockToPage`).
             const used = Math.min(rb.rotation.height, width);
-            const left = x + (flushEnd ? Math.max(0, width - used) : 0);
+            const share = typeof flushEnd === 'number' ? flushEnd : flushEnd ? 1 : 0;
+            const left = x + (share > 0 ? Math.max(0, width - used) * share : 0);
             rb.rotation.originX = rb.rotation.direction === 'ccw' ? left : left + used;
             rb.rotation.originY = rb.rotation.direction === 'ccw' ? totalHeight : 0;
         }
@@ -698,8 +767,9 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
         return { block: blk, height: totalHeight };
     };
     /** Whether a rotated float on `page` sits flush to the band's right edge:
-     *  with mirrored margins the spine of a verso (even-numbered) page. */
-    const rotatedFlushEnd = (page) => !!resolved.page.margins.mirror && (page.index + pageIndexOffset) % 2 === 1;
+     *  with mirrored margins the spine of a page whose spine is on its right
+     *  (a verso of a left-bound book, a recto of a right-bound one). */
+    const rotatedFlushEnd = (page) => pageMirrored(resolved, page.index, pageIndexOffset);
     /** Float bands reserved per column in this pass (the fresh-page flush
      *  sends single-column floats to the least reserved column). */
     const floatReserved = new Map();
@@ -846,8 +916,9 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
         const alignK = f.align === 'center' ? 0.5 : f.align === 'right' ? 1 : 0;
         const xLeft = slotX + (slotWidth - width) * alignK;
         const slice = sliceOf(f);
-        // A side float never turns: it stacks upright in the side column.
-        const rotated = side ? undefined : rotationFor(f, Math.min(...targetCols.map((c) => c.availableHeight)));
+        // A side float never turns: it stacks upright in the side column (on a
+        // vertical page it is counter-rotated to stand upright there too).
+        const rotated = side && !page.flow ? undefined : rotationFor(f, Math.min(...targetCols.map((c) => c.availableHeight)), page);
         // The caption beside the figure, in the band's side column.
         let aside;
         let sideCol;
@@ -983,7 +1054,7 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
                 if (cutBy !== undefined)
                     captionUnderProposals.add(cutBy);
             }
-            const built = buildFloatBlock(f.resourceId, xLeft, width, slice);
+            const built = buildFloatBlock(f.resourceId, xLeft, width, slice, rotated);
             if (!built)
                 return 'skip';
             first.availableHeight = Math.max(0, first.availableHeight - need);
@@ -1057,13 +1128,13 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
                     return 'defer';
                 if (tableOverflow(f.resourceId) !== 'split')
                     return 'defer';
-                const split = splitTableFloat(f, width, position, targetCols, page.contentArea, c.availableHeight - (hasBand ? minTextPx : 0), 'strict');
+                const split = splitTableFloat(f, width, position, targetCols, page.contentArea, c.availableHeight - (hasBand ? minTextPx : 0), 'strict', rotated);
                 if (!split || split === 'none' || split === 'skip')
                     return 'defer';
                 slice = split.slice;
                 rest = split.rest;
                 cut = true;
-                const m = measureFloat(f.resourceId, width, slice);
+                const m = measureFloat(f.resourceId, width, slice, rotated);
                 if (!m)
                     return 'skip';
                 measure = m;
@@ -1093,7 +1164,10 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
         if (rest) {
             rest = { ...rest, notBefore: { pageIndex: page.index, columnIndex: targetCols[targetCols.length - 1].index } };
         }
-        const built = buildFloatBlock(f.resourceId, xLeft, width, slice, rotated, rotated ? rotatedFlushEnd(page) : false, aside, mirroredOf(page));
+        // An upright figure of a vertical page stands at the head of its tier
+        // (`placement.align`: `left` the top, `center`, `right` the foot).
+        const flush = rotated?.upright ? (f.align === 'center' ? 0.5 : f.align === 'right' ? 1 : 0) : rotated ? rotatedFlushEnd(page) : false;
+        const built = buildFloatBlock(f.resourceId, xLeft, width, slice, rotated, flush, aside, mirroredOf(page));
         if (!built)
             return 'skip';
         // The caption beside the figure takes its band of the side column: a
@@ -1797,6 +1871,7 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
         currentSection = style;
         geomResolved = style ? deriveSectionGeometryConfig(resolved, style) : resolved;
         contentArea = geomResolved === resolved ? pageMetrics.contentArea : computePageMetrics(geomResolved).contentArea;
+        setMeasureWritingMode(geomResolved.layout.writingMode);
         // A page still empty takes the geometry right away — the document (or
         // a chapter laid out on its own) opening with a styled heading.
         const page = doc.pages[cursor.pageIndex];
@@ -1827,7 +1902,7 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
             // a resource keeps the printed text, whose `:ref` label the source
             // does not hold.
             if (headingLevels.forBlock(raw)?.textTransform === 'uppercase' && !raw.spans.some((s) => s.ref)) {
-                blk.sourceTitle = flattenTitleBreaks(raw.text);
+                blk.sourceTitle = flattenTitleBreaks(withBookTitleBrackets(raw.text, raw.spans, resolved.cjk).text);
             }
         }
         if (raw.footnoteNote !== undefined)
@@ -2015,7 +2090,7 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
         const side = sideColumnOf(page, currentBand(page, cursor));
         if (!side || side.bbox.height <= 0.5)
             return;
-        const boxes = headingDesignBoxes(design.lvl, design.info, blk.bbox, resolved.page.dpi, doc.metadata, cursor.pageIndex, designFrames, resourceById);
+        const boxes = headingDesignBoxes(design.lvl, design.info, blk.bbox, resolved.page.dpi, doc.metadata, cursor.pageIndex, designFramesOn(page), resourceById);
         const top = side.bbox.y;
         const foot = side.bbox.y + side.bbox.height;
         const left = side.bbox.x;
@@ -2428,9 +2503,11 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
         };
         return { children, childBase: startIdx + 1, realAt, end: { child: children.length, line: 0 }, layoutRange, groups };
     };
-    /** Whether a page is a verso of mirrored margins (an `'outer'` corner
-     *  icon hangs on the left there). */
-    const mirroredOf = (page) => resolved.page.margins.mirror === true && (page.index + pageIndexOffset + 1) % 2 === 0;
+    /** Whether a page swaps its mirrored margins (a verso of a left-bound
+     *  book, a recto of a right-bound one: an `'outer'` corner icon hangs on
+     *  the left there). A vertical page has no outer side: a box's outer
+     *  corner stays where the style puts it. */
+    const mirroredOf = (page) => !page.flow && pageMirrored(resolved, page.index, pageIndexOffset);
     /** Where a block's paint ends: its last line's foot (a list tail's box
      *  bakes its bottom margin in and may reach past a cut with every line
      *  inside it), else its box's. */
@@ -2694,7 +2771,9 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
                 }
                 const width = page.contentArea.width;
                 const slice = sliceOf(f);
-                const measure = measureFloat(f.resourceId, width, slice);
+                // On a vertical page the figure stands upright.
+                const upright = page.flow ? uprightOn(page) : undefined;
+                const measure = measureFloat(f.resourceId, width, slice, upright);
                 if (!measure) {
                     i++;
                     continue;
@@ -2707,7 +2786,7 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
                     i++;
                     continue;
                 }
-                const built = buildFloatBlock(f.resourceId, page.contentArea.x, width, slice);
+                const built = buildFloatBlock(f.resourceId, page.contentArea.x, width, slice, upright);
                 if (!built) {
                     i++;
                     continue;
@@ -3052,8 +3131,8 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
         const snapUp = (page, v) => page.contentArea.y + Math.ceil((v - page.contentArea.y - 0.01) / baselineGrid) * baselineGrid;
         /** The box laid out for `page` and the zone it takes there. */
         const zoneOn = (page) => {
-            const ref = anchor.to === 'page' ? designFrames.page
-                : anchor.to === 'bleed' ? designFrames.bleed
+            const ref = anchor.to === 'page' ? designFramesOn(page).page
+                : anchor.to === 'bleed' ? designFramesOn(page).bleed
                     : page.contentArea;
             const band = cursor.pageIndex === page.index ? currentBand(page, cursor) : 0;
             const cols = bandColumns(page, band).filter((c) => c.bbox.height > 0.5);
@@ -3667,9 +3746,9 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
             }
             else if (name === 'numbering') {
                 const change = {};
-                // Any spelling of a format (`roman-lower`, `arabic`, `i`…); an
-                // unknown one keeps the current format.
-                const fmt = parseNumberFormat(attrs.format);
+                // Any spelling of a format (`roman-lower`, `arabic`, `i`…, `一` in
+                // the document's script); an unknown one keeps the current format.
+                const fmt = parseNumberFormat(attrs.format, resolvedLocale(resolved));
                 if (fmt)
                     change.format = fmt;
                 if (attrs.startAt !== undefined) {
@@ -3901,9 +3980,15 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
         const measureWidth = rawBlock.type === 'heading' && opensDefaultOpener(rawBlock)
             ? doc.pages[cursor.pageIndex].contentArea.width
             : col.bbox.width;
+        // A resource on a vertical page stands upright, its frame at most as
+        // wide as the flow is tall (less the float gap it keeps).
+        const blockPage = doc.pages[cursor.pageIndex];
+        const upright = blockPage.flow && rawBlock.type === 'resourceBlock'
+            ? { uprightMaxLength: uprightOn(blockPage).length }
+            : {};
         let measuredBlock = tryLoose
             ? measureLooseParagraph(rawBlock, blockIdx, col.bbox.width, blockMeasureCtx, styleOverride, looseLines, trackingLadder, looseOutcome)
-            : measureContentBlock(rawBlock, blockIdx, measureWidth, blockMeasureCtx, { styleOverride });
+            : measureContentBlock(rawBlock, blockIdx, measureWidth, blockMeasureCtx, { styleOverride, ...upright });
         // Screen pages (`layout.fitFiguresToPage`): an inline figure a little
         // too tall for the room left in its column — under an opener band, say
         // — is set smaller to stay with its text rather than leave the rest of
@@ -3945,7 +4030,7 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
         /** Tracking the block's lines are set with; a paragraph moved whole into
          *  a column of another width is measured again, and may change it. */
         let { letterSpacingPx } = measuredBlock;
-        const { vdtType, headingLevel, numberPrefix, headingNumber, listBullet, listDepth, listKind, bulletXOffsetInColumn, strikethroughText } = kind;
+        const { vdtType, headingLevel, numberPrefix, numberSeparator, headingNumber, listBullet, listDepth, listKind, bulletXOffsetInColumn, strikethroughText } = kind;
         // A structural heading (`hidden`) is placed like any heading — its
         // break, keep-with-next and grid snap apply — but with no line height
         // and no margins: it takes no room, and renderers skip it.
@@ -4032,6 +4117,10 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
                 blk.separatorFontString = listBullet.separatorFontString;
                 blk.separatorColor = listBullet.separatorColor;
                 blk.separatorX = blk.bulletOffsetX + (listBullet.separatorOffsetPx ?? 0);
+                if (listBullet.prefixText !== undefined) {
+                    blk.prefixText = listBullet.prefixText;
+                    blk.prefixX = blk.bulletOffsetX + (listBullet.prefixOffsetPx ?? 0);
+                }
             }
             if (strikethroughText)
                 blk.strikethroughText = true;
@@ -4118,14 +4207,15 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
             ...extra,
         });
         // "Keep with next" for colon-introduced lists: a paragraph ending in `:`
-        // followed directly by a list acts as a lead-in title — the colon-bearing
+        // (or the full-width `：` of Chinese text and its presentation forms `︰`
+        // `﹕`, #211) followed directly by a list acts as a lead-in title — the colon-bearing
         // line must share a column with the first list item. Only checked for the
         // original, unsplit paragraph (partIndex === 0) on the iteration that is
         // about to place it.
         const endsWithColon = vdtType === 'paragraph'
             && resolved.bodyText.keepColonWithList
             && nextIsListItem
-            && /:\s*$/.test(contentBlock.text);
+            && /[:：︰﹕]\s*$/.test(contentBlock.text);
         while (remainingLines.length > 0) {
             enterBand(blockIdx, partIndex);
             const curCol = currentColumn(doc, cursor);
@@ -4311,13 +4401,13 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
                     const pref = numberPrefix ?? '';
                     // The lines joined back into the title (EF-162), as the design is
                     // painted (`buildHeadersAndFooters`).
-                    const title = headingTitleText(remainingLines, pref, rawBlock.titleBreaks, rawBlock.text.length);
+                    const title = headingTitleText(remainingLines, pref, rawBlock.titleBreaks, rawBlock.text.length, lvl.numberSeparator);
                     // Span-page openers lay out across the full content area (both
                     // columns); in-column headings use just the column width.
                     const pageArea = doc.pages[cursor.pageIndex].contentArea;
                     const measureWidth = lvl.span === 'page' ? pageArea.width : curCol.bbox.width;
                     const info = { titleText: title, formattedNumber: pref, numericValue: headingNumber, locale: resolvedLocale(resolved), chapterNumber: chapterNumberByBlock[blockIdx] ?? '', attrs: rawBlock.attrs };
-                    const design = measureHeadingDesign(lvl, info, measureWidth, resolved.page.dpi, doc.metadata, cursor.pageIndex, designFrames, {
+                    const design = measureHeadingDesign(lvl, info, measureWidth, resolved.page.dpi, doc.metadata, cursor.pageIndex, designFramesOn(doc.pages[cursor.pageIndex]), {
                         x: lvl.span === 'page' ? pageArea.x : curCol.bbox.x,
                         y: curCol.bbox.y + (curCol.bbox.height - curCol.availableHeight) + spacingBefore,
                     }, resourceById);
@@ -4335,7 +4425,7 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
                     // line whose spaces shrink, a forced break, a run it prints plain):
                     // the band holds every line it paints (EF-100).
                     if (opensDefaultOpener(rawBlock)) {
-                        const painted = measureDefaultOpenerHeight(lvl, resolved.headings.textAlign, defaultOpenerTitle(remainingLines, pref, rawBlock.titleBreaks, rawBlock.text.length), pref, pageArea.width, resolved.page.dpi, doc.metadata, cursor.pageIndex);
+                        const painted = measureDefaultOpenerHeight(lvl, resolved.headings.textAlign, defaultOpenerTitle(remainingLines, pref, rawBlock.titleBreaks, rawBlock.text.length, lvl.numberSeparator), pref, pageArea.width, resolved.page.dpi, doc.metadata, cursor.pageIndex);
                         if (painted > effectiveRemainHeight)
                             effectiveRemainHeight = painted;
                     }
@@ -4391,8 +4481,11 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
                         blk.contentIndex = blockIdx;
                         stampBlockExtras(blk, rawBlock);
                         blk.headingLevel = headingLevel;
-                        if (numberPrefix)
+                        if (numberPrefix) {
                             blk.numberPrefix = numberPrefix;
+                            if (numberSeparator !== undefined)
+                                blk.numberSeparator = numberSeparator;
+                        }
                         blk.lines = resetLinePositions(splitLines, style.lineHeightPx);
                         blk.dirty = false;
                         blk.snappedToGrid = false;
@@ -4590,8 +4683,11 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
                 stampBlockExtras(blk, rawBlock);
                 if (partIndex === 0) {
                     blk.headingLevel = headingLevel;
-                    if (numberPrefix)
+                    if (numberPrefix) {
                         blk.numberPrefix = numberPrefix;
+                        if (numberSeparator !== undefined)
+                            blk.numberSeparator = numberSeparator;
+                    }
                     if (headingNumber !== undefined)
                         blk.headingNumber = headingNumber;
                 }
@@ -4854,8 +4950,11 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
                     stampBlockExtras(blk, rawBlock);
                     if (partIndex === 0) {
                         blk.headingLevel = headingLevel;
-                        if (numberPrefix)
+                        if (numberPrefix) {
                             blk.numberPrefix = numberPrefix;
+                            if (numberSeparator !== undefined)
+                                blk.numberSeparator = numberSeparator;
+                        }
                         if (headingNumber !== undefined)
                             blk.headingNumber = headingNumber;
                     }
@@ -4957,8 +5056,11 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
             // `{chapterNumber}` from `numberPrefix`, as the measure did (EF-59).
             if (partIndex === 0) {
                 blk.headingLevel = headingLevel;
-                if (numberPrefix)
+                if (numberPrefix) {
                     blk.numberPrefix = numberPrefix;
+                    if (numberSeparator !== undefined)
+                        blk.numberSeparator = numberSeparator;
+                }
                 if (headingNumber !== undefined)
                     blk.headingNumber = headingNumber;
             }
@@ -5108,6 +5210,9 @@ export function buildDocumentPass(content, config, cache, options, hints = {}) {
             return text.length > 0 ? { styleId, text } : undefined;
         },
     });
+    // Vertical pages: the axis each font's upright characters turn about.
+    if (doc.pages.some((p) => p.flow))
+        stampCentralBaselines(doc);
     doc.converged = true;
     doc.iterationCount = 1;
     return { doc, forcedBreakPages, bandCapProposals, spanPlacedInBand, bandCapsApplied, looseOutcome, captionUnderProposals };
@@ -5163,8 +5268,14 @@ export function* buildDocumentGen(content, config, cache, options) {
     // once, located on the pages of the finished layout. Kept apart from
     // `doc.warnings`, whose entries keep their postext 1.4 shape.
     const found = [...collectContentWarnings(content.markdown, config, content.resources ?? []), ...(indexWarnings.get(doc) ?? [])];
-    if (found.length > 0)
-        doc.contentWarnings = locateContentWarnings(doc, found);
+    const located = found.length > 0 ? locateContentWarnings(doc, found) : [];
+    // Justified CJK lines the composer could not fill within its tracking cap.
+    const loose = cjkLooseLineWarnings(doc);
+    // Chinese marks placed where the lines are painted (#193), and the
+    // paragraphs whose leading is too tight for their marks or readings.
+    const annotations = annotateDocument(doc, doc.config?.cjk);
+    if (located.length > 0 || loose.length > 0 || annotations.length > 0)
+        doc.contentWarnings = [...located, ...loose, ...annotations];
     // Config values the build replaced (an unknown number format, a font
     // stack, a side column no column width can take): walked once per build,
     // not per pass — they belong to no page.