postext 0.3.35 → 0.3.37

package/dist/pipeline/toc.js

@@ -0,0 +1,249 @@
+/**
+ * `:::toc` — the table of contents. The directive expands, before layout,
+ * into ordinary content blocks (one per listed heading, one per part
+ * divider) that flow through the column machinery like paragraphs: they
+ * break across columns and pages, snap to the grid and map clicks back to
+ * the directive line. Measurement is special: an entry is its title (with
+ * a right-aligned number in a column of its own), a leader and the page
+ * label on its last line, and an optional subtitle line (the chapter
+ * authors) under it; a part row is an empty block of a fixed height whose
+ * design `buildHeadersAndFooters` lays out from `toc.parts.design`.
+ */
+import { dimensionToPx } from '../units';
+import { buildFontString, measureRichBlock, measureTextWidth } from '../measure';
+import { stampSourceRanges } from './buildHelpers';
+/** The content blocks with every `:::toc` directive replaced by the blocks
+ *  of the contents it prints. Without an outline (no directive) the input
+ *  is returned as is. */
+export function expandTocDirectives(blocks, outline, resolved) {
+    if (!outline || !blocks.some((b) => b.type === 'directive' && b.directiveName === 'toc')) {
+        return blocks;
+    }
+    const out = [];
+    for (const b of blocks) {
+        if (b.type !== 'directive' || b.directiveName !== 'toc') {
+            out.push(b);
+            continue;
+        }
+        out.push(...tocBlocksFor(b, outline, resolved));
+    }
+    return out;
+}
+function tocBlocksFor(directive, outline, resolved) {
+    const toc = resolved.toc;
+    const listedLevels = new Set(toc.levels.map((l) => l.level));
+    const out = [];
+    const base = { sourceStart: directive.sourceStart, sourceEnd: directive.sourceEnd };
+    for (const entry of outline) {
+        if (!entry.listed)
+            continue;
+        if (entry.kind === 'part') {
+            if (!toc.parts.enabled)
+                continue;
+            const info = {
+                kind: 'part', level: 0, number: entry.number, numbered: entry.numbered, title: entry.title,
+                ...(entry.pageLabel !== undefined ? { pageLabel: entry.pageLabel } : {}),
+                ...(entry.palette ? { palette: entry.palette } : {}),
+            };
+            out.push({ ...base, type: 'paragraph', text: '', spans: [], sourceMap: [], toc: info });
+            continue;
+        }
+        if (!listedLevels.has(entry.level))
+            continue;
+        const text = entry.title;
+        const spans = entry.spans && entry.spans.length > 0
+            ? entry.spans.map((s) => ({ text: s.text, bold: s.bold, italic: s.italic }))
+            : [{ text, bold: false, italic: false }];
+        const subtitle = toc.subtitle.enabled ? entry.attrs?.[toc.subtitle.attr]?.trim() : undefined;
+        const info = {
+            kind: 'entry', level: entry.level, number: entry.number, numbered: entry.numbered,
+            ...(entry.pageLabel !== undefined ? { pageLabel: entry.pageLabel } : {}),
+            ...(subtitle ? { subtitle } : {}),
+        };
+        // Every character maps to the directive line, so a click on the
+        // contents lands on `:::toc`.
+        out.push({ ...base, type: 'paragraph', text, spans, sourceMap: new Array(text.length).fill(directive.sourceStart), toc: info });
+    }
+    return out;
+}
+function lineHeightPxOf(lineHeight, fontSizePx, dpi) {
+    if (lineHeight.unit === 'em' || lineHeight.unit === 'rem')
+        return fontSizePx * lineHeight.value;
+    return dimensionToPx(lineHeight, dpi, fontSizePx);
+}
+function segmentsOf(line) {
+    if (line.segments && line.segments.length > 0)
+        return line.segments;
+    const segs = [{ kind: 'text', text: line.text, width: line.bbox.width }];
+    line.segments = segs;
+    return segs;
+}
+/** Measure one block of an expanded `:::toc` (see the module header). */
+export function measureTocBlock(rawBlock, columnWidth, ctx) {
+    const info = rawBlock.toc;
+    const { resolved, bodyOffset } = ctx;
+    const toc = resolved.toc;
+    const dpi = resolved.page.dpi;
+    const bodyFontSizePx = dimensionToPx(resolved.bodyText.fontSize, dpi);
+    const body = resolved.bodyText;
+    if (info.kind === 'part') {
+        const rowH = dimensionToPx(toc.parts.height, dpi, bodyFontSizePx);
+        const style = {
+            fontString: buildFontString(body.fontFamily, bodyFontSizePx, body.fontWeight.toString()),
+            fontSizePx: bodyFontSizePx,
+            lineHeightPx: rowH,
+            color: body.color.hex,
+            textAlign: 'left',
+            hyphenate: false,
+            marginTopPx: dimensionToPx(toc.parts.marginTop, dpi, bodyFontSizePx),
+            marginBottomPx: dimensionToPx(toc.parts.marginBottom, dpi, bodyFontSizePx),
+            firstLineIndentPx: 0,
+            hangingIndent: false,
+        };
+        const line = {
+            text: '', bbox: { x: 0, y: 0, width: columnWidth, height: rowH }, baseline: rowH * 0.7,
+            hyphenated: false, segments: [], isLastLine: true,
+        };
+        const measured = { lines: [line], totalHeight: rowH };
+        const { prefixLen, absoluteSourceMap } = stampSourceRanges(measured, rawBlock, rawBlock, bodyOffset);
+        return {
+            kind: { style, vdtType: 'paragraph', contentBlock: rawBlock, bulletXOffsetInColumn: 0, strikethroughText: false },
+            contentBlock: rawBlock,
+            measured,
+            prefixLen,
+            absoluteSourceMap,
+        };
+    }
+    // --- Entry -----------------------------------------------------------
+    const level = toc.levels.find((l) => l.level === info.level) ?? toc.levels[0];
+    const entry = info.numbered ? level : { ...level, ...toc.unnumbered };
+    const fontSizePx = dimensionToPx(entry.fontSize, dpi);
+    const lineHeightPx = lineHeightPxOf(entry.lineHeight, fontSizePx, dpi);
+    const weight = entry.fontWeight.toString();
+    const boldWeight = Math.max(entry.fontWeight, body.boldFontWeight).toString();
+    const upright = entry.italic ? 'italic' : 'normal';
+    const flipped = entry.italic ? 'normal' : 'italic';
+    const fontString = buildFontString(entry.fontFamily, fontSizePx, weight, upright);
+    const boldFontString = buildFontString(entry.fontFamily, fontSizePx, boldWeight, upright);
+    const italicFontString = buildFontString(entry.fontFamily, fontSizePx, weight, flipped);
+    const boldItalicFontString = buildFontString(entry.fontFamily, fontSizePx, boldWeight, flipped);
+    const color = entry.color.hex;
+    const style = {
+        fontString, boldFontString, italicFontString, boldItalicFontString,
+        fontSizePx, lineHeightPx, color, boldColor: color, italicColor: color,
+        textAlign: 'left', hyphenate: false,
+        marginTopPx: dimensionToPx(entry.marginTop, dpi, fontSizePx),
+        marginBottomPx: dimensionToPx(entry.marginBottom, dpi, fontSizePx),
+        firstLineIndentPx: 0, hangingIndent: false,
+    };
+    // Number column (numbered entries): the title starts after it.
+    const indentPx = dimensionToPx(entry.indent, dpi, fontSizePx);
+    const hasNumber = info.numbered && info.number.length > 0;
+    const numberWidthPx = hasNumber ? dimensionToPx(entry.numberWidth, dpi, fontSizePx) : 0;
+    const numberGapPx = hasNumber ? dimensionToPx(entry.numberGap, dpi, fontSizePx) : 0;
+    const textX = indentPx + numberWidthPx + numberGapPx;
+    const availableW = Math.max(1, columnWidth - textX);
+    let listBullet;
+    let bulletXOffsetInColumn = 0;
+    if (hasNumber) {
+        const numberFontSizePx = dimensionToPx(entry.numberFontSize, dpi);
+        const numberFont = buildFontString(entry.numberFontFamily, numberFontSizePx, entry.numberFontWeight.toString());
+        const numberW = measureTextWidth(info.number, numberFont);
+        listBullet = {
+            indentPx, bulletText: info.number, bulletFontString: numberFont, bulletColor: entry.numberColor.hex,
+            bulletWidthPx: numberWidthPx, gapPx: numberGapPx, hangingIndent: true, itemSpacingPx: 0,
+            textFontSizePx: fontSizePx, verticalOffsetPx: 0,
+        };
+        bulletXOffsetInColumn = indentPx + Math.max(0, numberWidthPx - numberW);
+    }
+    // Page label + leader on the last title line.
+    const label = info.pageLabel ?? '';
+    const pn = toc.pageNumber;
+    const labelFontSizePx = dimensionToPx(pn.fontSize, dpi);
+    const labelFont = buildFontString(pn.fontFamily, labelFontSizePx, pn.fontWeight.toString(), pn.italic ? 'italic' : 'normal');
+    const labelColor = pn.color.hex;
+    const reservePx = label.length > 0 ? dimensionToPx(pn.width, dpi, fontSizePx) : 0;
+    const gapPx = label.length > 0 ? dimensionToPx(toc.leader.gap, dpi, fontSizePx) : 0;
+    const labelW = label.length > 0 ? measureTextWidth(label, labelFont) : 0;
+    const measureTitle = (maxW) => measureRichBlock(rawBlock.spans, fontString, boldFontString, italicFontString, boldItalicFontString, maxW, lineHeightPx, { textAlign: 'left', hyphenate: false });
+    let measured = measureTitle(availableW);
+    if (measured.lines.length === 0)
+        return null;
+    const lastOf = (lines) => lines[lines.length - 1];
+    if (label.length > 0 && lastOf(measured.lines).bbox.width + gapPx + reservePx > availableW + 0.01) {
+        // The label does not fit beside the last line: narrow the measure so
+        // the title leaves it room (every line, so wrapped lines stay level).
+        const narrowed = measureTitle(Math.max(1, availableW - gapPx - reservePx));
+        if (narrowed.lines.length > 0)
+            measured = narrowed;
+    }
+    const lines = measured.lines;
+    if (label.length > 0) {
+        const last = lastOf(lines);
+        const segs = segmentsOf(last);
+        const contentW = segs.reduce((s, seg) => s + seg.width, 0);
+        const leaderStart = contentW + gapPx;
+        const leaderEnd = availableW - reservePx;
+        let x = contentW;
+        const pushSpace = (w) => { if (w > 0) {
+            segs.push({ kind: 'space', text: ' ', width: w });
+            x += w;
+        } };
+        if (toc.leader.enabled && toc.leader.char.length > 0 && leaderEnd - leaderStart > 0) {
+            const unit = measureTextWidth(toc.leader.char, labelFont);
+            const n = unit > 0 ? Math.floor((leaderEnd - leaderStart) / unit) : 0;
+            if (n > 0) {
+                const dots = toc.leader.char.repeat(n);
+                const dotsW = measureTextWidth(dots, labelFont);
+                pushSpace(leaderEnd - dotsW - x);
+                segs.push({ kind: 'text', text: dots, width: dotsW, fontString: labelFont, color: labelColor });
+                x += dotsW;
+            }
+        }
+        pushSpace(availableW - labelW - x);
+        segs.push({ kind: 'text', text: label, width: labelW, fontString: labelFont, color: labelColor });
+        last.text = `${last.text} ${label}`;
+        last.bbox.width = availableW;
+    }
+    // Subtitle line(s) under the title (the chapter authors).
+    if (info.subtitle) {
+        const sub = toc.subtitle;
+        const subSizePx = dimensionToPx(sub.fontSize, dpi);
+        const subFont = buildFontString(sub.fontFamily, subSizePx, sub.fontWeight.toString(), sub.italic ? 'italic' : 'normal');
+        const subIndentPx = dimensionToPx(sub.indent, dpi, fontSizePx);
+        const subMeasured = measureRichBlock([{ text: info.subtitle, bold: false, italic: false }], subFont, subFont, subFont, subFont, Math.max(1, availableW - subIndentPx), lineHeightPx, { textAlign: 'left', hyphenate: false });
+        for (const line of subMeasured.lines) {
+            for (const seg of segmentsOf(line)) {
+                if (seg.kind === 'space')
+                    continue;
+                seg.fontString = subFont;
+                seg.color = sub.color.hex;
+            }
+            line.bbox.x += subIndentPx;
+            line.isLastLine = true;
+            lines.push(line);
+        }
+    }
+    for (const line of lines)
+        line.bbox.x += textX;
+    // Uniform line pitch: the placement loop re-seats every line at the
+    // block's line height (`resetLinePositions`).
+    const total = lines.length * lineHeightPx;
+    const finalMeasured = { lines, totalHeight: total };
+    const { prefixLen, absoluteSourceMap } = stampSourceRanges(finalMeasured, rawBlock, rawBlock, bodyOffset);
+    return {
+        kind: {
+            style,
+            vdtType: hasNumber ? 'listItem' : 'paragraph',
+            contentBlock: rawBlock,
+            ...(listBullet ? { listBullet, listDepth: 1, listKind: 'ordered' } : {}),
+            bulletXOffsetInColumn,
+            strikethroughText: false,
+        },
+        contentBlock: rawBlock,
+        measured: finalMeasured,
+        prefixLen,
+        absoluteSourceMap,
+    };
+}
+//# sourceMappingURL=toc.js.map

package/dist/pipeline/toc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toc.js","sourceRoot":"","sources":["../../src/pipeline/toc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAKjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;yBAEyB;AACzB,MAAM,UAAU,mBAAmB,CACjC,MAA+B,EAC/B,OAA4C,EAC5C,QAAwB;IAExB,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,aAAa,KAAK,KAAK,CAAC,EAAE,CAAC;QACzF,OAAO,MAAwB,CAAC;IAClC,CAAC;IACD,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,aAAa,KAAK,KAAK,EAAE,CAAC;YAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAAC,SAAS;QAAC,CAAC;QACnF,GAAG,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,YAAY,CAAC,SAAuB,EAAE,OAAgC,EAAE,QAAwB;IACvG,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC;IACzB,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7D,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,EAAE,WAAW,EAAE,SAAS,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS,EAAE,CAAC;IACpF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,SAAS;QAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO;gBAAE,SAAS;YACjC,MAAM,IAAI,GAAiB;gBACzB,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK;gBAC1F,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxE,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrD,CAAC;YACF,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;YACxF,SAAS;QACX,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC;YAAE,SAAS;QAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC;QACzB,MAAM,KAAK,GAAiB,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YAC/D,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YAC5E,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC7F,MAAM,IAAI,GAAiB;YACzB,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACjF,GAAG,CAAC,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClC,CAAC;QACF,gEAAgE;QAChE,8BAA8B;QAC9B,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,KAAK,CAAS,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1I,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,cAAc,CAAC,UAA2C,EAAE,UAAkB,EAAE,GAAW;IAClG,IAAI,UAAU,CAAC,IAAI,KAAK,IAAI,IAAI,UAAU,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC;IAChG,OAAO,aAAa,CAAC,UAAiD,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;AAC3F,CAAC;AAED,SAAS,UAAU,CAAC,IAAa;IAC/B,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,QAAQ,CAAC;IACpE,MAAM,IAAI,GAAqB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3F,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACrB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,eAAe,CAC7B,QAAsB,EACtB,WAAmB,EACnB,GAAwB;IAExB,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAI,CAAC;IAC3B,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC;IACrC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC;IACzB,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC;IAC9B,MAAM,cAAc,GAAG,aAAa,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACtE,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAE/B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC;QAClE,MAAM,KAAK,GAAe;YACxB,UAAU,EAAE,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;YACxF,UAAU,EAAE,cAAc;YAC1B,YAAY,EAAE,IAAI;YAClB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG;YACrB,SAAS,EAAE,MAAM;YACjB,SAAS,EAAE,KAAK;YAChB,WAAW,EAAE,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,cAAc,CAAC;YACpE,cAAc,EAAE,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,cAAc,CAAC;YAC1E,iBAAiB,EAAE,CAAC;YACpB,aAAa,EAAE,KAAK;SACrB,CAAC;QACF,MAAM,IAAI,GAAY;YACpB,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,GAAG,GAAG;YACtF,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI;SAClD,CAAC;QACF,MAAM,QAAQ,GAAG,EAAE,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;QACtD,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QACrG,OAAO;YACL,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,qBAAqB,EAAE,CAAC,EAAE,iBAAiB,EAAE,KAAK,EAAE;YACjH,YAAY,EAAE,QAAQ;YACtB,QAAQ;YACR,SAAS;YACT,iBAAiB;SAClB,CAAC;IACJ,CAAC;IAED,wEAAwE;IACxE,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;IAC/E,MAAM,KAAK,GAAgC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;IACnG,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,cAAc,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC9E,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IACnD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IACnD,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAClF,MAAM,cAAc,GAAG,eAAe,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAC1F,MAAM,gBAAgB,GAAG,eAAe,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACxF,MAAM,oBAAoB,GAAG,eAAe,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAChG,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC;IAC9B,MAAM,KAAK,GAAe;QACxB,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,oBAAoB;QAClE,UAAU,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK;QACrE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK;QACnC,WAAW,EAAE,aAAa,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,UAAU,CAAC;QAC5D,cAAc,EAAE,aAAa,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,UAAU,CAAC;QAClE,iBAAiB,EAAE,CAAC,EAAE,aAAa,EAAE,KAAK;KAC3C,CAAC;IAEF,+DAA+D;IAC/D,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1D,MAAM,aAAa,GAAG,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpF,MAAM,KAAK,GAAG,QAAQ,GAAG,aAAa,GAAG,WAAW,CAAC;IACrD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,KAAK,CAAC,CAAC;IACpD,IAAI,UAAuC,CAAC;IAC5C,IAAI,qBAAqB,GAAG,CAAC,CAAC;IAC9B,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,gBAAgB,GAAG,aAAa,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QAClE,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,CAAC;QAChH,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAC1D,UAAU,GAAG;YACX,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,CAAC,GAAG;YACnG,aAAa,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;YACvF,cAAc,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC;SAChD,CAAC;QACF,qBAAqB,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC;IAC1E,CAAC;IAED,8CAA8C;IAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC;IACnC,MAAM,EAAE,GAAG,GAAG,CAAC,UAAU,CAAC;IAC1B,MAAM,eAAe,GAAG,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,eAAe,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC7H,MAAM,UAAU,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC;IAChC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpF,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEzE,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,gBAAgB,CACrD,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,gBAAgB,EAAE,oBAAoB,EAClF,IAAI,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAC5D,CAAC;IACF,IAAI,QAAQ,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IACxC,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,MAAM,GAAG,CAAC,KAAgB,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;IAC9D,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,GAAG,SAAS,GAAG,UAAU,GAAG,IAAI,EAAE,CAAC;QAClG,qEAAqE;QACrE,sEAAsE;QACtE,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC;QAC3E,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,QAAQ,GAAG,QAAQ,CAAC;IACrD,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC7B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3D,MAAM,WAAW,GAAG,QAAQ,GAAG,KAAK,CAAC;QACrC,MAAM,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;QACzC,IAAI,CAAC,GAAG,QAAQ,CAAC;QACjB,MAAM,SAAS,GAAG,CAAC,CAAS,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YAAC,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC,CAAC,CAAC,CAAC;QAC/G,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,GAAG,WAAW,GAAG,CAAC,EAAE,CAAC;YACpF,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC1D,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACV,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACvC,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBAChD,SAAS,CAAC,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC;gBACjC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;gBAChG,CAAC,IAAI,KAAK,CAAC;YACb,CAAC;QACH,CAAC;QACD,SAAS,CAAC,UAAU,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QAClG,IAAI,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,0DAA0D;IAC1D,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC;QACzB,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACxH,MAAM,WAAW,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;QAC/D,MAAM,WAAW,GAAG,gBAAgB,CAClC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EACzF,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC,EAAE,YAAY,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAC7F,CAAC;QACF,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;YACrC,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnC,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO;oBAAE,SAAS;gBACnC,GAAG,CAAC,UAAU,GAAG,OAAO,CAAC;gBACzB,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;YAC5B,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,WAAW,CAAC;YAC3B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC;IAC/C,oEAAoE;IACpE,8CAA8C;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,YAAY,CAAC;IAC1C,MAAM,aAAa,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IACpD,MAAM,EAAE,SAAS,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,CAAC,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC1G,OAAO;QACL,IAAI,EAAE;YACJ,KAAK;YACL,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW;YAC7C,YAAY,EAAE,QAAQ;YACtB,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjF,qBAAqB;YACrB,iBAAiB,EAAE,KAAK;SACzB;QACD,YAAY,EAAE,QAAQ;QACtB,QAAQ,EAAE,aAAa;QACvB,SAAS;QACT,iBAAiB;KAClB,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -202,6 +202,47 @@ export interface PostextContent {
      *  book chapter laid out on its own continues the numbering of the
      *  chapters before it. Omit for a self-contained document. */
     continuation?: LayoutContinuation;
+    /** The book's outline — every heading and part the `:::toc` directive
+     *  lists, with the page label each one landed on. A chapter laid out on
+     *  its own gets the whole book's outline from its host; when absent, the
+     *  engine derives it from the document itself, laying it out again until
+     *  the page labels the contents print no longer change. */
+    outline?: OutlineEntry[];
+}
+/** One line of a book's outline: a heading of a listed level, or a part
+ *  divider. Produced from the parsed markdown (page labels unknown) or from
+ *  a laid-out document (page labels known); consumed by `:::toc`. */
+export interface OutlineEntry {
+    kind: 'heading' | 'part';
+    /** Heading level (1–6); `0` for a part. */
+    level: number;
+    /** Title as plain text (forced title breaks flattened to spaces). */
+    title: string;
+    /** Inline runs of the title (bold / italic), so a title set in italics
+     *  keeps its emphasis in the contents. Absent for a part. */
+    spans?: {
+        text: string;
+        bold: boolean;
+        italic: boolean;
+    }[];
+    /** Printed number: the level's `numberingTemplate` output, else the
+     *  chapter ordinal for a level-1 heading; the part's `number` as written.
+     *  Empty for an unnumbered heading. */
+    number: string;
+    /** False for a heading whose style has `numbered: false`. */
+    numbered: boolean;
+    /** Id of the heading style (`{style="…"}`), when the heading has one. */
+    styleId?: string;
+    /** Heading attributes (`{author="…"}`), for the contents' subtitle line. */
+    attrs?: Record<string, string>;
+    /** Palette overrides of a part (`palette="band=#…"`), so its row in the
+     *  contents takes the part's colours. */
+    palette?: Record<string, string>;
+    /** Label of the page the entry starts on; absent until laid out. */
+    pageLabel?: string;
+    /** Whether the entry appears in the contents (a heading style's `toc`
+     *  or a `{toc="false"}` attribute may exclude it). */
+    listed: boolean;
 }
 /** Heading counters (1-indexed by level) in effect at a point in a document. */
 export interface HeadingCounters {
@@ -419,7 +460,7 @@ export interface ResolvedLayoutConfig {
         lineWidth: Dimension;
     };
 }
-export type TextAlign = 'left' | 'justify' | 'center';
+export type TextAlign = 'left' | 'justify' | 'center' | 'right';
 export type HyphenationLocale = 'en-us' | 'es' | 'fr' | 'de' | 'it' | 'pt' | 'ca' | 'nl';
 export interface HyphenationConfig {
     enabled?: boolean;
@@ -749,8 +790,11 @@ export interface ParagraphStyleConfig {
     lineHeight?: Dimension;
     /** Defaults to the body text colour. */
     color?: ColorValue;
-    /** Defaults to the body alignment (`center` is not available here). */
-    textAlign?: 'left' | 'justify';
+    /** Defaults to the body alignment. `'center'` and `'right'` set every
+     *  line ragged from the other side (a dedication, a signature block). */
+    textAlign?: TextAlign;
+    /** Colour of bold runs. Defaults to `bodyText.boldColor`. */
+    boldColor?: ColorValue;
     /** Hyphenate when justified. Defaults to the body hyphenation setting. */
     hyphenation?: boolean;
     /** Defaults to the body first-line indent. Ignored when
@@ -775,7 +819,8 @@ export interface ResolvedParagraphStyleConfig {
     fontSize: Dimension;
     lineHeight: Dimension;
     color: ColorValue;
-    textAlign: 'left' | 'justify';
+    textAlign: TextAlign;
+    boldColor?: ColorValue;
     hyphenation: boolean;
     firstLineIndent: Dimension;
     hangingIndent: Dimension;
@@ -1632,6 +1677,9 @@ export interface DesignTextElement {
     /** When true, break long words at syllable boundaries while wrapping.
      *  Uses the document's active hyphenation locale. */
     hyphenate?: boolean;
+    /** Letter-case transform applied to the resolved text (a part title set
+     *  in capitals in the contents). Default `'none'`. */
+    textTransform?: 'none' | 'uppercase';
     box?: ElementBoxStyle;
 }
 export interface DesignRuleElement {
@@ -1654,7 +1702,22 @@ export interface DesignBoxElement {
     placement: ElementPlacement;
     style: ElementBoxStyle;
 }
-export type DesignElement = DesignTextElement | DesignRuleElement | DesignBoxElement;
+/** An image drawn from a resource (a bitmap or SVG `Resource`, e.g. a
+ *  publisher logo on a title page). Sized by `placement.size`: with one of
+ *  `width` / `height` left `'auto'` the other follows the image's aspect
+ *  ratio; with both set the image is fitted inside the box, centred. A
+ *  missing resource draws nothing. */
+export interface DesignImageElement {
+    kind: 'image';
+    id: string;
+    parity?: PageParity;
+    /** Page roles this element renders on. Default `'all'`. */
+    pages?: PageRoleFilter;
+    placement: ElementPlacement;
+    /** `Resource.id` of a bitmap or SVG resource. */
+    resourceId: string;
+}
+export type DesignElement = DesignTextElement | DesignRuleElement | DesignBoxElement | DesignImageElement;
 export interface DesignSlot {
     /** Array order = paint order: first = back, last = front. */
     elements: DesignElement[];
@@ -1675,7 +1738,10 @@ export interface ResolvedDesignRuleElement extends Omit<DesignRuleElement, 'pari
 export interface ResolvedDesignBoxElement extends Omit<DesignBoxElement, 'parity'> {
     parity: PageParity;
 }
-export type ResolvedDesignElement = ResolvedDesignTextElement | ResolvedDesignRuleElement | ResolvedDesignBoxElement;
+export interface ResolvedDesignImageElement extends Omit<DesignImageElement, 'parity'> {
+    parity: PageParity;
+}
+export type ResolvedDesignElement = ResolvedDesignTextElement | ResolvedDesignRuleElement | ResolvedDesignBoxElement | ResolvedDesignImageElement;
 export interface ResolvedDesignSlot {
     elements: ResolvedDesignElement[];
 }
@@ -1800,6 +1866,201 @@ export interface ResolvedPartsConfig {
     versoDesign: ResolvedDesignSlot;
     bodyStyle: ResolvedPartsBodyStyleConfig;
 }
+/** Typography of the body blocks in a section opened by a styled heading.
+ *  Same shape as a part's body style. */
+export type SectionBodyStyleConfig = PartsBodyStyleConfig;
+export type ResolvedSectionBodyStyleConfig = ResolvedPartsBodyStyleConfig;
+export interface HeadingStyleConfig extends Omit<HeadingLevelConfig, 'level' | 'numberingTemplate'> {
+    /** Identifier referenced from `{style="…"}` on a heading line. */
+    id: string;
+    /** Human-readable name (editor UI only). Defaults to {@link id}. */
+    name?: string;
+    /** Whether the heading counts: advances the level's counter and the
+     *  chapter ordinal (`{chapterNumber}`), and is numbered in the contents.
+     *  `false` for a preface, an authors list, an index. Default `true`. */
+    numbered?: boolean;
+    /** Whether the heading is listed by `:::toc`. Default `true`; a heading
+     *  may override it with `{toc="false"}` / `{toc="true"}`. */
+    toc?: boolean;
+    /** Running heads of the section's pages, replacing the document's
+     *  `header` / `footer` there (element `pages` / `parity` filters still
+     *  apply). Unset = the document's own. */
+    header?: HeaderFooterSlot;
+    footer?: HeaderFooterSlot;
+    /** Body area of the section's pages. Each side inherits the page margin
+     *  when unset. Takes effect on the pages the section opens, so pair it
+     *  with `breakBefore`. */
+    margins?: PageMargins;
+    /** Column layout of the section's pages (a single wide column for a
+     *  preface set in a two-column book). Inherits `layout` when unset. */
+    layout?: LayoutConfig;
+    /** Typography of the body blocks in the section. */
+    bodyStyle?: SectionBodyStyleConfig;
+    /** Palette overrides (palette id → hex) applied to the design slots of
+     *  the section's pages, like a part's `palette` attribute. */
+    palette?: Record<string, string>;
+}
+/** The level fields a heading style may override, resolved. */
+export type ResolvedHeadingStyleOverrides = Partial<Omit<ResolvedHeadingLevelConfig, 'level' | 'numberingTemplate'>>;
+export interface ResolvedHeadingStyleConfig {
+    id: string;
+    name: string;
+    numbered: boolean;
+    toc: boolean;
+    /** Level fields the style sets; merged over the heading's level config. */
+    overrides: ResolvedHeadingStyleOverrides;
+    header?: ResolvedDesignSlot;
+    footer?: ResolvedDesignSlot;
+    margins?: Required<PageMargins>;
+    layout?: ResolvedLayoutConfig;
+    bodyStyle?: ResolvedSectionBodyStyleConfig;
+    palette: Record<string, string>;
+}
+/** Typography of one kind of contents entry. Every field inherits the body
+ *  text (or the `toc`-wide value) when unset. */
+export interface TocEntryStyleConfig {
+    fontFamily?: string;
+    fontSize?: Dimension;
+    /** Leading of the entry's lines (title and subtitle alike). Defaults to
+     *  the body line height so the contents sit on the baseline grid. */
+    lineHeight?: Dimension;
+    fontWeight?: number;
+    italic?: boolean;
+    color?: ColorValue;
+    /** Left indent of the whole entry. Default `0`. */
+    indent?: Dimension;
+    /** Width of the number column: the title starts after it plus
+     *  `numberGap`; numbers are right-aligned in it. Default `2em`. */
+    numberWidth?: Dimension;
+    /** Gap between the number column and the title. Default `0.5em`. */
+    numberGap?: Dimension;
+    numberFontFamily?: string;
+    numberFontSize?: Dimension;
+    numberFontWeight?: number;
+    numberColor?: ColorValue;
+    /** Space above / below the entry (subtitle included). Default `0`. */
+    marginTop?: Dimension;
+    marginBottom?: Dimension;
+}
+export interface TocLevelConfig extends TocEntryStyleConfig {
+    /** Heading level (1–6). */
+    level: number;
+}
+export interface TocConfig {
+    /** Heading levels listed, each with its entry typography. Default: level
+     *  1 only. */
+    levels?: TocLevelConfig[];
+    /** Entry typography of headings whose style has `numbered: false`
+     *  (a preface). They print no number and start flush at the level's
+     *  `indent`. Inherits the level's style. */
+    unnumbered?: TocEntryStyleConfig;
+    /** The page number at the right edge of an entry. */
+    pageNumber?: {
+        fontFamily?: string;
+        fontSize?: Dimension;
+        fontWeight?: number;
+        italic?: boolean;
+        color?: ColorValue;
+        /** Width reserved for the number at the right edge. Default `2em`. */
+        width?: Dimension;
+    };
+    /** Leader between the title and the page number. */
+    leader?: {
+        /** Default `true`. */
+        enabled?: boolean;
+        /** Repeated across the gap, right-aligned so dots line up. Default `'.'`;
+         *  `'. '` spaces them out. */
+        char?: string;
+        /** Minimum gap between the title and the leader / page number. Default
+         *  `0.5em`. */
+        gap?: Dimension;
+    };
+    /** A second line under the entry taken from a heading attribute — the
+     *  chapter authors (`{author="…"}`). Absent when unset. */
+    subtitle?: {
+        /** Attribute name, e.g. `'author'`. Default `'author'`. */
+        attr?: string;
+        /** Default `false`. */
+        enabled?: boolean;
+        fontFamily?: string;
+        fontSize?: Dimension;
+        fontWeight?: number;
+        italic?: boolean;
+        color?: ColorValue;
+        /** Extra indent beyond the title's. Default `0`. */
+        indent?: Dimension;
+    };
+    /** Part dividers get a row of their own. */
+    parts?: {
+        /** Default `true`. */
+        enabled?: boolean;
+        /** Row design; its container is the row (column width × `height`).
+         *  Placeholders: `{number}`, `{numberRoman}`…, `{titleText}` and
+         *  `{pageNumber}` (the part page's label). Palette-linked colours take
+         *  the part's own palette. When empty, `{number} {titleText}` and the
+         *  page number are set in the level-1 entry typography. */
+        design?: DesignSlot;
+        /** Row height. Default: two body lines. */
+        height?: Dimension;
+        marginTop?: Dimension;
+        marginBottom?: Dimension;
+    };
+}
+export interface ResolvedTocEntryStyleConfig {
+    fontFamily: string;
+    fontSize: Dimension;
+    lineHeight: Dimension;
+    fontWeight: number;
+    italic: boolean;
+    color: ColorValue;
+    indent: Dimension;
+    numberWidth: Dimension;
+    numberGap: Dimension;
+    numberFontFamily: string;
+    numberFontSize: Dimension;
+    numberFontWeight: number;
+    numberColor: ColorValue;
+    marginTop: Dimension;
+    marginBottom: Dimension;
+}
+export interface ResolvedTocLevelConfig extends ResolvedTocEntryStyleConfig {
+    level: number;
+}
+export interface ResolvedTocConfig {
+    levels: ResolvedTocLevelConfig[];
+    /** Overrides applied on top of the level's entry style for unnumbered headings. */
+    unnumbered: Partial<ResolvedTocEntryStyleConfig>;
+    pageNumber: {
+        fontFamily: string;
+        fontSize: Dimension;
+        fontWeight: number;
+        italic: boolean;
+        color: ColorValue;
+        width: Dimension;
+    };
+    leader: {
+        enabled: boolean;
+        char: string;
+        gap: Dimension;
+    };
+    subtitle: {
+        enabled: boolean;
+        attr: string;
+        fontFamily: string;
+        fontSize: Dimension;
+        fontWeight: number;
+        italic: boolean;
+        color: ColorValue;
+        indent: Dimension;
+    };
+    parts: {
+        enabled: boolean;
+        design: ResolvedDesignSlot;
+        height: Dimension;
+        marginTop: Dimension;
+        marginBottom: Dimension;
+    };
+}
 export interface PostextConfig {
     page?: PageConfig;
     layout?: LayoutConfig;
@@ -1819,6 +2080,12 @@ export interface PostextConfig {
     /** Part dividers (`:::part` containers): page breaks, body area,
      *  opener design and body typography. */
     parts?: PartsConfig;
+    /** Named heading styles applied with `# Title {style="…"}`: a front
+     *  matter chapter, an unnumbered appendix, a preface with its own running
+     *  heads and page geometry. */
+    headingStyles?: HeadingStyleConfig[];
+    /** The table of contents a `:::toc` directive prints. */
+    toc?: TocConfig;
     unorderedLists?: UnorderedListsConfig;
     orderedLists?: OrderedListsConfig;
     math?: MathConfig;