postext 0.3.19 → 0.3.21

package/dist/pipeline/parts.js

@@ -0,0 +1,230 @@
+/**
+ * Pre-pass and derived typography for `:::part{number="…" title="…"}`
+ * containers. Like the other container plans, part ranges are resolved up
+ * front per content-block index (the placement loop rewinds `blockIdx` on
+ * keep-with-next rollbacks and replays the markers in between).
+ */
+import { dimensionsEqual } from '../defaults/shared';
+import { resolveBodyStyle, resolveBlockquoteStyle } from './styles';
+import { computeLevelIndentsPx, computeOrderedLevelIndentsPx, computeOrderedListRunMetrics, } from './lists';
+export function planParts(contentBlocks) {
+    const byStart = new Map();
+    const byEnd = new Map();
+    const byBlock = new Array(contentBlocks.length);
+    let open;
+    for (let i = 0; i < contentBlocks.length; i++) {
+        const b = contentBlocks[i];
+        if (b.type === 'containerStart' && b.containerName === 'part' && b.containerId !== undefined) {
+            if (open) {
+                open.depth++;
+                continue;
+            }
+            const attrs = b.containerAttrs ?? {};
+            const part = {
+                startIdx: i,
+                endIdx: -1,
+                containerId: b.containerId,
+                number: (attrs.number ?? '').trim(),
+                title: (attrs.title ?? '').trim(),
+            };
+            open = { part, depth: 0 };
+            continue;
+        }
+        if (b.type === 'containerEnd' && b.containerName === 'part') {
+            if (!open)
+                continue;
+            if (open.depth > 0) {
+                open.depth--;
+                continue;
+            }
+            open.part.endIdx = i;
+            byStart.set(open.part.startIdx, open.part);
+            byEnd.set(i, open.part);
+            open = undefined;
+            continue;
+        }
+        if (open)
+            byBlock[i] = open.part;
+    }
+    return { byStart, byEnd, byBlock };
+}
+const ROMAN_RE = /^M{0,4}(CM|CD|D?C{0,3})(XC|XL|L?X{0,3})(IX|IV|V?I{0,3})$/i;
+const ROMAN_VALUES = {
+    M: 1000, D: 500, C: 100, L: 50, X: 10, V: 5, I: 1,
+};
+/** Numeric value of a part number written as a decimal (`'3'`) or a roman
+ *  numeral (`'III'`, `'iv'`), so `{numberDecimal}` / `{numberRoman}` work
+ *  whichever way the author wrote it. `undefined` for anything else. */
+export function parsePartNumber(raw) {
+    const s = raw.trim();
+    if (s.length === 0)
+        return undefined;
+    if (/^\d+$/.test(s)) {
+        const n = Number(s);
+        return Number.isSafeInteger(n) ? n : undefined;
+    }
+    if (!ROMAN_RE.test(s))
+        return undefined;
+    const u = s.toUpperCase();
+    let total = 0;
+    for (let i = 0; i < u.length; i++) {
+        const v = ROMAN_VALUES[u[i]];
+        const next = i + 1 < u.length ? ROMAN_VALUES[u[i + 1]] : 0;
+        total += v < next ? -v : v;
+    }
+    return total;
+}
+const eqStrict = (a, b) => a === b;
+const eqDim = (a, b) => a !== undefined && b !== undefined && dimensionsEqual(a, b);
+const eqColor = (a, b) => a !== undefined && b !== undefined && a.hex === b.hex;
+const UNORDERED_FIELDS = [
+    { key: 'fontFamily', levelKey: 'fontFamily', eq: eqStrict },
+    { key: 'color', levelKey: 'color', eq: eqColor },
+    { key: 'fontWeight', levelKey: 'fontWeight', eq: eqStrict },
+    { key: 'italic', levelKey: 'italic', eq: eqStrict },
+    { key: 'bulletChar', levelKey: 'bulletChar', eq: eqStrict },
+    { key: 'bulletFontSize', levelKey: 'fontSize', eq: eqDim },
+    { key: 'gap', eq: eqDim },
+    { key: 'indent', levelKey: 'indent', eq: eqDim },
+    { key: 'bulletVerticalOffset', levelKey: 'verticalOffset', eq: eqDim },
+    { key: 'marginTop', eq: eqDim },
+    { key: 'marginBottom', eq: eqDim },
+    { key: 'itemSpacing', eq: eqDim },
+    { key: 'hangingIndent', eq: eqStrict },
+    { key: 'taskCheckboxChar', eq: eqStrict },
+    { key: 'taskCheckedChar', eq: eqStrict },
+    { key: 'taskCompletedStrikethrough', eq: eqStrict },
+    { key: 'taskCompletedColor', eq: eqColor },
+];
+const ORDERED_FIELDS = [
+    {
+        key: 'fontFamily', levelKey: 'fontFamily', eq: eqStrict,
+        dependents: [{ key: 'separatorFontFamily', levelKey: 'separatorFontFamily' }],
+    },
+    {
+        key: 'color', levelKey: 'color', eq: eqColor,
+        dependents: [{ key: 'separatorColor', levelKey: 'separatorColor' }],
+    },
+    {
+        key: 'fontWeight', levelKey: 'fontWeight', eq: eqStrict,
+        dependents: [{ key: 'separatorFontWeight', levelKey: 'separatorFontWeight' }],
+    },
+    {
+        key: 'italic', levelKey: 'italic', eq: eqStrict,
+        dependents: [{ key: 'separatorItalic', levelKey: 'separatorItalic' }],
+    },
+    { key: 'numberFormat', levelKey: 'numberFormat', eq: eqStrict },
+    { key: 'separator', levelKey: 'separator', eq: eqStrict },
+    { key: 'numberFontSize', levelKey: 'fontSize', eq: eqDim },
+    { key: 'gap', eq: eqDim },
+    { key: 'indent', levelKey: 'indent', eq: eqDim },
+    { key: 'numberVerticalOffset', levelKey: 'verticalOffset', eq: eqDim },
+    { key: 'marginTop', eq: eqDim },
+    { key: 'marginBottom', eq: eqDim },
+    { key: 'itemSpacing', eq: eqDim },
+    { key: 'hangingIndent', eq: eqStrict },
+    { key: 'separatorFontFamily', levelKey: 'separatorFontFamily', eq: eqStrict, inheritsFrom: 'fontFamily' },
+    { key: 'separatorFontWeight', levelKey: 'separatorFontWeight', eq: eqStrict, inheritsFrom: 'fontWeight' },
+    { key: 'separatorItalic', levelKey: 'separatorItalic', eq: eqStrict, inheritsFrom: 'italic' },
+    { key: 'separatorColor', levelKey: 'separatorColor', eq: eqColor, inheritsFrom: 'color' },
+    { key: 'separatorGap', levelKey: 'separatorGap', eq: eqDim },
+];
+/**
+ * Apply a partial list config on top of a resolved one. A list-wide value
+ * propagates to every level (and dependent field) whose current value still
+ * equals the value it was resolved from — a level with its own value keeps
+ * it (the same heuristic the callout overrides use). Entries in `levels`
+ * then apply directly to their level.
+ */
+function applyListOverrides(base, override, specs) {
+    if (!override)
+        return base;
+    const ov = override;
+    const out = { ...base };
+    const levels = base.levels.map((l) => ({ ...l }));
+    const setField = (target, spec, onLevel, value) => {
+        const key = onLevel ? spec.levelKey : spec.key;
+        const prev = target[key];
+        target[key] = value;
+        for (const dep of spec.dependents ?? []) {
+            const depKey = onLevel ? dep.levelKey : dep.key;
+            if (spec.eq(target[depKey], prev))
+                target[depKey] = value;
+        }
+    };
+    for (const spec of specs) {
+        const value = ov[spec.key];
+        if (value === undefined)
+            continue;
+        const prevGeneral = out[spec.key];
+        setField(out, spec, false, value);
+        if (!spec.levelKey)
+            continue;
+        for (const l of levels) {
+            const current = l[spec.levelKey];
+            const inherited = spec.eq(current, prevGeneral) ||
+                (spec.inheritsFrom !== undefined && spec.eq(current, l[spec.inheritsFrom]));
+            if (inherited)
+                setField(l, spec, true, value);
+        }
+    }
+    const levelOverrides = ov.levels ?? [];
+    for (const lo of levelOverrides) {
+        const target = levels.find((l) => l.level === lo.level);
+        if (!target)
+            continue;
+        for (const spec of specs) {
+            if (!spec.levelKey)
+                continue;
+            const value = lo[spec.levelKey];
+            if (value !== undefined)
+                setField(target, spec, true, value);
+        }
+    }
+    out.levels = levels;
+    return out;
+}
+/** Shallow copy of `resolved` whose `bodyText` and list configs carry the
+ *  `parts.bodyStyle` overrides, so the body/list resolvers yield the part
+ *  typography without any part-specific branches (the callout approach).
+ *  Ordered-list numbers are set bold in `numberColor`; bullets take
+ *  `bulletColor`. Level-specific values only follow an override when they
+ *  still equal the general value they were resolved from. The
+ *  `bodyStyle.unorderedLists` / `orderedLists` partials apply last. */
+export function derivePartResolvedConfig(resolved) {
+    const { bodyStyle } = resolved.parts;
+    const bold = resolved.bodyText.boldFontWeight;
+    const unorderedLists = applyListOverrides(applyListOverrides(resolved.unorderedLists, { color: bodyStyle.bulletColor }, UNORDERED_FIELDS), bodyStyle.unorderedLists, UNORDERED_FIELDS);
+    const orderedLists = applyListOverrides(applyListOverrides(resolved.orderedLists, { color: bodyStyle.numberColor, fontWeight: bold }, ORDERED_FIELDS), bodyStyle.orderedLists, ORDERED_FIELDS);
+    return {
+        ...resolved,
+        bodyText: {
+            ...resolved.bodyText,
+            fontFamily: bodyStyle.fontFamily,
+            fontSize: bodyStyle.fontSize,
+            lineHeight: bodyStyle.lineHeight,
+            color: bodyStyle.color,
+            textAlign: bodyStyle.textAlign,
+        },
+        unorderedLists,
+        orderedLists,
+    };
+}
+/** Measurement context for the blocks inside a part: the derived config
+ *  plus the body / blockquote styles, list indents and ordered-list number
+ *  widths recomputed from it. */
+export function derivePartMeasureContext(ctx) {
+    const resolved = derivePartResolvedConfig(ctx.resolved);
+    const bodyStyle = resolveBodyStyle(resolved);
+    const orderedMetrics = computeOrderedListRunMetrics([...ctx.contentBlocks], resolved, bodyStyle.fontSizePx);
+    return {
+        ...ctx,
+        resolved,
+        bodyStyle,
+        blockquoteStyle: resolveBlockquoteStyle(resolved),
+        listLevelIndentsPx: computeLevelIndentsPx(resolved, bodyStyle.fontSizePx),
+        orderedMetrics,
+        orderedLevelIndentsPx: computeOrderedLevelIndentsPx(resolved, bodyStyle.fontSizePx, orderedMetrics.maxWidthByDepth),
+    };
+}
+//# sourceMappingURL=parts.js.map

package/dist/pipeline/parts.js.map

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

package/dist/pipeline/placeholders.d.ts

@@ -18,12 +18,30 @@ export interface PlaceholderContext {
     metadata: DocumentMetadata;
     /** Chapter title per page index (most recent H1 at or before each page). */
     chapterTitleByPageIndex: string[];
+    /** Heading attributes of the current chapter's H1 per page index (see
+     *  `computeChapterAttrs`). Backs `{attr.<key>}` in header/footer slots. A
+     *  missing entry or key resolves to `''`. */
+    chapterAttrsByPageIndex?: Record<string, string>[];
+    /** Current part title / number per page index (see `computePartValues`).
+     *  Back `{partTitle}` / `{partNumber}`; a missing entry resolves to `''`. */
+    partTitleByPageIndex?: string[];
+    partNumberByPageIndex?: string[];
+    /** Current chapter number per page index (see `computeChapterNumbers`).
+     *  Backs `{chapterNumber}` in header/footer slots. */
+    chapterNumberByPageIndex?: string[];
 }
 export interface PlaceholderResult {
     text: string;
     unknownPlaceholders: string[];
     missingMetadata: string[];
 }
+/** Placeholder grammar: `name` or `name.key` — the dotted form is reserved
+ *  for namespaced lookups such as `{attr.author}` (heading attributes). */
+export declare const PLACEHOLDER_NAME_RE: RegExp;
+/** Namespace of the heading-attribute placeholders (`{attr.<key>}`). */
+export declare const ATTR_PLACEHOLDER_PREFIX = "attr.";
+/** When `name` is an `attr.<key>` placeholder, returns `<key>`. */
+export declare function attrPlaceholderKey(name: string): string | undefined;
 /**
  * Precompute chapter titles (most recent H1 text) for each page index by
  * walking blocks once. Returns an array where `result[pageIndex]` is the plain
@@ -43,9 +61,36 @@ export declare function computeChapterTitles(blocks: VDTBlock[], totalPages: num
  * `{chapterNumber}` in heading-context slots resolves to the current chapter.
  */
 export declare function computeChapterNumbers(blocks: VDTBlock[], totalPages: number, pages?: ChapterTitlePageInfo[]): string[];
+/**
+ * Precompute the heading attributes (`# Title {key="value"}`) of the most
+ * recent H1 per page. Backs `{attr.<key>}` in header/footer slots; pages
+ * before the first H1 get an empty record.
+ */
+export declare function computeChapterAttrs(blocks: VDTBlock[], totalPages: number, pages?: ChapterTitlePageInfo[]): Record<string, string>[];
+/** The page fields `computePartValues` reads. */
+export interface PartPageInfo extends ChapterTitlePageInfo {
+    partInfo?: {
+        number: string;
+        title: string;
+    };
+}
+/**
+ * Precompute the current part title and number per page index. A page with
+ * `partInfo` (a `:::part` divider page) starts a new part that runs until
+ * the next one; pages before the first part get `''`. Blank parity pages
+ * immediately preceding a part page belong to the upcoming part (they exist
+ * only to push it onto the right parity); a `blankForForce` page stops the
+ * walk — it belongs to the previous part, the same rule as chapters.
+ */
+export declare function computePartValues(pages: readonly PartPageInfo[]): {
+    partTitleByPageIndex: string[];
+    partNumberByPageIndex: string[];
+};
 /**
  * Resolve placeholder templates. Grammar:
- *   - `{name}` with name matching `[a-zA-Z][a-zA-Z0-9]*` is a placeholder.
+ *   - `{name}` with name matching `[a-zA-Z][a-zA-Z0-9]*` is a placeholder;
+ *   - `{name.key}` is a namespaced placeholder — `{attr.<key>}` reads the
+ *     current chapter's heading attributes (missing → `''`, no warning);
  *   - `{{` and `}}` are literal braces.
  */
 export declare function resolvePlaceholders(template: string, ctx: PlaceholderContext): PlaceholderResult;

package/dist/pipeline/placeholders.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"placeholders.d.ts","sourceRoot":"","sources":["../../src/pipeline/placeholders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEhD;;;;;;;oEAOoE;AACpE,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,4EAA4E;IAC5E,uBAAuB,EAAE,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAcD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,QAAQ,EAAE,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,oBAAoB,EAAE,GAC7B,MAAM,EAAE,CAEV;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,QAAQ,EAAE,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,oBAAoB,EAAE,GAC7B,MAAM,EAAE,CAEV;AAoED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,kBAAkB,GACtB,iBAAiB,CAgDnB;AAuBD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBlE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3D"}
+{"version":3,"file":"placeholders.d.ts","sourceRoot":"","sources":["../../src/pipeline/placeholders.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEhD;;;;;;;oEAOoE;AACpE,MAAM,WAAW,oBAAoB;IACnC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,4EAA4E;IAC5E,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAClC;;iDAE6C;IAC7C,uBAAuB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IACnD;iFAC6E;IAC7E,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC;0DACsD;IACtD,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAiBD;2EAC2E;AAC3E,eAAO,MAAM,mBAAmB,QAAyD,CAAC;AAE1F,wEAAwE;AACxE,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAE/C,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAInE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,QAAQ,EAAE,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,oBAAoB,EAAE,GAC7B,MAAM,EAAE,CAEV;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,QAAQ,EAAE,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,oBAAoB,EAAE,GAC7B,MAAM,EAAE,CAmBV;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,QAAQ,EAAE,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,oBAAoB,EAAE,GAC7B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAE1B;AA6DD,iDAAiD;AACjD,MAAM,WAAW,YAAa,SAAQ,oBAAoB;IACxD,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,YAAY,EAAE,GAC7B;IAAE,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAAC,qBAAqB,EAAE,MAAM,EAAE,CAAA;CAAE,CAqBrE;AAWD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,kBAAkB,GACtB,iBAAiB,CAsDnB;AA6BD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBlE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3D"}

package/dist/pipeline/placeholders.js

@@ -1,3 +1,4 @@
+import { TITLE_BREAK_RE } from '../parse/inlineFormatting';
 const PLACEHOLDER_NAMES = new Set([
     'pageNumber',
     'totalPages',
@@ -6,8 +7,23 @@ const PLACEHOLDER_NAMES = new Set([
     'author',
     'publishDate',
     'chapterTitle',
+    'chapterNumber',
+    'partTitle',
+    'partNumber',
 ]);
 const METADATA_PLACEHOLDERS = new Set(['title', 'subtitle', 'author', 'publishDate']);
+/** Placeholder grammar: `name` or `name.key` — the dotted form is reserved
+ *  for namespaced lookups such as `{attr.author}` (heading attributes). */
+export const PLACEHOLDER_NAME_RE = /^[a-zA-Z][a-zA-Z0-9]*(?:\.[a-zA-Z_][a-zA-Z0-9_-]*)?$/;
+/** Namespace of the heading-attribute placeholders (`{attr.<key>}`). */
+export const ATTR_PLACEHOLDER_PREFIX = 'attr.';
+/** When `name` is an `attr.<key>` placeholder, returns `<key>`. */
+export function attrPlaceholderKey(name) {
+    if (!name.startsWith(ATTR_PLACEHOLDER_PREFIX))
+        return undefined;
+    const key = name.slice(ATTR_PLACEHOLDER_PREFIX.length);
+    return key.length > 0 ? key : undefined;
+}
 /**
  * Precompute chapter titles (most recent H1 text) for each page index by
  * walking blocks once. Returns an array where `result[pageIndex]` is the plain
@@ -21,7 +37,7 @@ const METADATA_PLACEHOLDERS = new Set(['title', 'subtitle', 'author', 'publishDa
  * in its header, not the previous chapter's.
  */
 export function computeChapterTitles(blocks, totalPages, pages) {
-    return computeChapterValues(blocks, totalPages, pages, plainTextOfBlock);
+    return computeChapterValues(blocks, totalPages, pages, plainTextOfBlock, '');
 }
 /**
  * Precompute chapter numbers (most recent H1 `numberPrefix`) per page. Mirrors
@@ -29,14 +45,35 @@ export function computeChapterTitles(blocks, totalPages, pages) {
  * `{chapterNumber}` in heading-context slots resolves to the current chapter.
  */
 export function computeChapterNumbers(blocks, totalPages, pages) {
-    return computeChapterValues(blocks, totalPages, pages, (b) => b.numberPrefix ?? '');
+    // Without a level-1 numbering template the prefix is empty; fall back to
+    // the chapter's ordinal so `{chapterNumber}` still counts chapters.
+    let ordinal = 0;
+    let lastContentIndex;
+    return computeChapterValues(blocks, totalPages, pages, (b) => {
+        // A heading split across columns yields several blocks with the same
+        // content index; count the chapter once.
+        if (b.contentIndex === undefined || b.contentIndex !== lastContentIndex)
+            ordinal++;
+        lastContentIndex = b.contentIndex;
+        const prefix = b.numberPrefix?.trim() ?? '';
+        return prefix.length > 0 ? prefix : String(ordinal);
+    }, '');
+}
+/**
+ * Precompute the heading attributes (`# Title {key="value"}`) of the most
+ * recent H1 per page. Backs `{attr.<key>}` in header/footer slots; pages
+ * before the first H1 get an empty record.
+ */
+export function computeChapterAttrs(blocks, totalPages, pages) {
+    return computeChapterValues(blocks, totalPages, pages, (b) => b.attrs ?? {}, {});
 }
-/** Shared walker behind `computeChapterTitles` / `computeChapterNumbers`:
- *  tracks the most recent H1's extracted value per page. */
-function computeChapterValues(blocks, totalPages, pages, extract) {
-    const out = new Array(totalPages).fill('');
+/** Shared walker behind `computeChapterTitles` / `computeChapterNumbers` /
+ *  `computeChapterAttrs`: tracks the most recent H1's extracted value per
+ *  page, starting from `empty` before the first H1. */
+function computeChapterValues(blocks, totalPages, pages, extract, empty) {
+    const out = new Array(totalPages).fill(empty);
     const byPage = new Map();
-    let current = '';
+    let current = empty;
     // Walk blocks in page/column order. The VDT `doc.blocks` array is already
     // insertion-ordered by placement, so pages are in increasing index.
     let lastPageIndex = -1;
@@ -87,6 +124,37 @@ function computeChapterValues(blocks, totalPages, pages, extract) {
     }
     return out;
 }
+/**
+ * Precompute the current part title and number per page index. A page with
+ * `partInfo` (a `:::part` divider page) starts a new part that runs until
+ * the next one; pages before the first part get `''`. Blank parity pages
+ * immediately preceding a part page belong to the upcoming part (they exist
+ * only to push it onto the right parity); a `blankForForce` page stops the
+ * walk — it belongs to the previous part, the same rule as chapters.
+ */
+export function computePartValues(pages) {
+    const partTitleByPageIndex = new Array(pages.length).fill('');
+    const partNumberByPageIndex = new Array(pages.length).fill('');
+    let title = '';
+    let number = '';
+    for (let p = 0; p < pages.length; p++) {
+        const info = pages[p].partInfo;
+        if (info) {
+            title = info.title.replace(TITLE_BREAK_RE, ' ');
+            number = info.number;
+            for (let q = p - 1; q >= 0; q--) {
+                const prev = pages[q];
+                if (prev.blankForForce || !prev.blankForParity)
+                    break;
+                partTitleByPageIndex[q] = title;
+                partNumberByPageIndex[q] = number;
+            }
+        }
+        partTitleByPageIndex[p] = title;
+        partNumberByPageIndex[p] = number;
+    }
+    return { partTitleByPageIndex, partNumberByPageIndex };
+}
 function plainTextOfBlock(block) {
     // Strip any numbering prefix that was prepended during build.
     const lines = block.lines.map((l) => l.text).join(' ');
@@ -97,7 +165,9 @@ function plainTextOfBlock(block) {
 }
 /**
  * Resolve placeholder templates. Grammar:
- *   - `{name}` with name matching `[a-zA-Z][a-zA-Z0-9]*` is a placeholder.
+ *   - `{name}` with name matching `[a-zA-Z][a-zA-Z0-9]*` is a placeholder;
+ *   - `{name.key}` is a namespaced placeholder — `{attr.<key>}` reads the
+ *     current chapter's heading attributes (missing → `''`, no warning);
  *   - `{{` and `}}` are literal braces.
  */
 export function resolvePlaceholders(template, ctx) {
@@ -126,11 +196,17 @@ export function resolvePlaceholders(template, ctx) {
                 continue;
             }
             const name = template.slice(i + 1, end);
-            if (!/^[a-zA-Z][a-zA-Z0-9]*$/.test(name)) {
+            if (!PLACEHOLDER_NAME_RE.test(name)) {
                 out += template.slice(i, end + 1);
                 i = end + 1;
                 continue;
             }
+            const attrKey = attrPlaceholderKey(name);
+            if (attrKey !== undefined) {
+                out += ctx.chapterAttrsByPageIndex?.[ctx.page.index]?.[attrKey] ?? '';
+                i = end + 1;
+                continue;
+            }
             if (!PLACEHOLDER_NAMES.has(name)) {
                 unknown.push(name);
                 i = end + 1;
@@ -165,6 +241,12 @@ function resolveName(name, ctx) {
             return typeof ctx.metadata.publishDate === 'string' ? ctx.metadata.publishDate : '';
         case 'chapterTitle':
             return ctx.chapterTitleByPageIndex[ctx.page.index] ?? '';
+        case 'partTitle':
+            return ctx.partTitleByPageIndex?.[ctx.page.index] ?? '';
+        case 'partNumber':
+            return ctx.partNumberByPageIndex?.[ctx.page.index] ?? '';
+        case 'chapterNumber':
+            return ctx.chapterNumberByPageIndex?.[ctx.page.index] ?? '';
         default:
             return '';
     }
@@ -191,7 +273,7 @@ export function collectPlaceholderNames(template) {
             if (end === -1)
                 break;
             const name = template.slice(i + 1, end);
-            if (/^[a-zA-Z][a-zA-Z0-9]*$/.test(name))
+            if (PLACEHOLDER_NAME_RE.test(name))
                 names.add(name);
             i = end + 1;
             continue;
@@ -201,7 +283,7 @@ export function collectPlaceholderNames(template) {
     return [...names];
 }
 export function isKnownPlaceholder(name) {
-    return PLACEHOLDER_NAMES.has(name);
+    return PLACEHOLDER_NAMES.has(name) || attrPlaceholderKey(name) !== undefined;
 }
 export function isMetadataPlaceholder(name) {
     return METADATA_PLACEHOLDERS.has(name);

package/dist/pipeline/placeholders.js.map

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

package/dist/pipeline/placement.d.ts

@@ -1,12 +1,63 @@
 import { type BoundingBox, type ResolvedConfig, type VDTDocument, type VDTBlock, type VDTLine, type VDTPage, type VDTColumn } from '../vdt';
 import type { HeadingBreakParity } from '../types';
+import { type PageMetrics } from './buildHelpers';
 export interface PlacementCursor {
     pageIndex: number;
     columnIndex: number;
 }
 export declare function resetLinePositions(lines: VDTLine[], lineHeightPx: number): VDTLine[];
 export declare function createPageWithColumns(pageIndex: number, resolved: ResolvedConfig, contentArea: BoundingBox, pageWidthPx: number, pageHeightPx: number): VDTPage;
+/** Turn a freshly opened (empty) page into a part-divider page: a single
+ *  body column inset from the trim box by `parts.margins` (mirrored on even
+ *  pages when `parts.margins.mirror` is on), `page.contentArea` set to that
+ *  area, `partInfo` stamped and the role fixed to `'part'`. The opener
+ *  design is laid out later by `buildHeadersAndFooters` against the full
+ *  trim box and never reserves body space. */
+export declare function createPartPage(page: VDTPage, metrics: Pick<PageMetrics, 'trimBox' | 'pageWidthPx'>, resolved: ResolvedConfig, info: {
+    number: string;
+    title: string;
+    titleSourceStart?: number;
+    titleSourceEnd?: number;
+}): VDTPage;
 export declare function currentColumn(doc: VDTDocument, cursor: PlacementCursor): VDTColumn;
+/** Whether any column of the page — text or span — holds a placed block.
+ *  Floats live outside the columns and do not count. */
+export declare function pageHasContent(page: VDTPage): boolean;
+/** Text columns of `band` in reading order (span columns excluded). */
+export declare function bandColumns(page: VDTPage, band: number): VDTColumn[];
+/** Band the cursor's column belongs to (`0` for the plain single-band page). */
+export declare function currentBand(page: VDTPage, cursor: PlacementCursor): number;
+/** True when every column of the band has consumed the same height (within
+ *  0.5px) — the page top, right after an opener heading (which reserves its
+ *  band in every column), right after another span block, or right after a
+ *  top float band. Used height = `bbox.height − availableHeight`. */
+export declare function isBandLevel(cols: readonly VDTColumn[]): boolean;
+/** Lowest used bottom (absolute y) across the band's columns — where a
+ *  full-width block can start without covering placed content. */
+export declare function bandUsedBottom(cols: readonly VDTColumn[]): number;
+/**
+ * Close the band formed by `cols` at `cutY`, insert a full-width span column
+ * holding `block` right below the cut, and open a fresh band of text columns
+ * under it. The band's columns are clamped to `cutY` — a column whose top
+ * already sits at the cut becomes zero-height — and keep only the slack
+ * between their used bottom and the cut in `availableHeight` (zero when the
+ * band is level on the grid; whole lines when a band cap cut the band with
+ * its last column short, so column balancing can still fill them). The span
+ * column is `{ kind: 'span', band }` at `contentArea.x / width`, `needPx`
+ * tall (the block plus its spacing, already rounded to the grid by the
+ * caller); `block` is placed inside it at `spacingBefore` below the cut with
+ * height `blockHeight` (default: the rest of the band), so `block.pageIndex`
+ * / `columnIndex` address the span column.
+ *
+ * The new text columns (`band + 1`) copy each closed column's x / width and
+ * keep its original bottom (so a bottom float band reserved on one column
+ * still constrains its successor). A column with no room left (bottom
+ * within 0.5px of the new band's top) is not created; when none is, the
+ * cursor stays on the span column — which is full — so the next placement
+ * advances to a new page. Otherwise the cursor moves to the first new
+ * column. Returns the span column.
+ */
+export declare function closeBandAndInsertSpan(page: VDTPage, cols: readonly VDTColumn[], cutY: number, block: VDTBlock, needPx: number, cursor: PlacementCursor, spacingBefore?: number, blockHeight?: number): VDTColumn;
 export declare function advanceToNextColumn(doc: VDTDocument, cursor: PlacementCursor, resolved: ResolvedConfig, contentArea: BoundingBox, pageWidthPx: number, pageHeightPx: number, onNewPage?: (page: VDTPage) => void): void;
 /** Advance `cursor` forward until it points to the first column of a new
  *  page. No-op when the current page is empty (nothing placed yet) — avoids
@@ -26,17 +77,20 @@ export declare function advanceToNextPageBoundary(doc: VDTDocument, cursor: Plac
  *  whether the natural next page already matched the requested parity. */
 export declare function enforcePageParity(doc: VDTDocument, cursor: PlacementCursor, resolved: ResolvedConfig, contentArea: BoundingBox, pageWidthPx: number, pageHeightPx: number, parity: HeadingBreakParity): void;
 /**
- * Place a resource block (image / svg / table + caption) keeping it together as
- * one atomic unit (issue #49 §7 — Placement). Resources never split mid-content
- * for v1: if the group's combined height fits the remaining column space it is
- * placed there; otherwise the cursor advances to the next column/page (without
- * emitting a leading blank page when the current column is empty), and the
- * resource is force-placed there even when it exceeds a single column's height.
+ * Place an atomic block — a resource group (image / svg / table + caption,
+ * issue #49 §7) or a callout frame — keeping it together as one unit. Atomic
+ * blocks never split mid-content for v1: if the group's combined height fits
+ * the remaining column space it is placed there; otherwise the cursor advances
+ * to the next column/page (without emitting a leading blank page when the
+ * current column is empty), and the block is force-placed there even when it
+ * exceeds a single column's height.
  *
  * `spacingBefore` is consumed from the target column's available height before
  * placement (collapsed against the previous block's bottom margin by the
  * caller). Returns the height actually reserved for the block.
  */
-export declare function placeResourceBlock(block: VDTBlock, groupHeight: number, spacingBefore: number, cursor: PlacementCursor, doc: VDTDocument, resolved: ResolvedConfig, contentArea: BoundingBox, pageWidthPx: number, pageHeightPx: number): number;
+export declare function placeAtomicBlock(block: VDTBlock, groupHeight: number, spacingBefore: number, cursor: PlacementCursor, doc: VDTDocument, resolved: ResolvedConfig, contentArea: BoundingBox, pageWidthPx: number, pageHeightPx: number): number;
+/** @deprecated Use {@link placeAtomicBlock}. */
+export declare const placeResourceBlock: typeof placeAtomicBlock;
 export declare function placeBlockInColumn(block: VDTBlock, blockHeight: number, col: VDTColumn, cursor: PlacementCursor): void;
 //# sourceMappingURL=placement.d.ts.map