postext 0.3.19 → 0.3.20

package/dist/pipeline/paragraphContainers.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Pre-pass for `:::paragraphs{style="…"}` containers. The placement loop
+ * rewinds `blockIdx` on keep-with-next rollbacks and replays the blocks in
+ * between (marker blocks included), so container state is resolved up front
+ * per content-block index instead of being pushed/popped inside the loop.
+ */
+import type { ContentBlock } from '../parse';
+import type { ResolvedConfig } from '../vdt';
+import { type BlockStyle } from './styles';
+export interface ParagraphContainer {
+    /** `containerId` of the start/end marker pair. */
+    id: number;
+    /** Style for every paragraph in the container. */
+    style: BlockStyle;
+    /** Style for the container's last paragraph: the container's
+     *  `marginBottom` is baked into its `marginBottomPx` so the grid snap that
+     *  closes the container guarantees the margin (grid wins, margin is a
+     *  minimum — the same convention snapped headings follow). */
+    tailStyle: BlockStyle;
+    /** Applied on entry through pending spacing. */
+    marginTopPx: number;
+    /** Fallback for containers whose last block is not a paragraph. */
+    marginBottomPx: number;
+}
+export interface ParagraphContainerPlan {
+    /** Container id → entry, for `paragraphs` containers with a known style. */
+    byId: Map<number, ParagraphContainer>;
+    /** Content-block index → innermost enclosing paragraph container. */
+    byBlock: Array<ParagraphContainer | undefined>;
+}
+export declare function planParagraphContainers(contentBlocks: readonly ContentBlock[], resolved: ResolvedConfig): ParagraphContainerPlan;
+//# sourceMappingURL=paragraphContainers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paragraphContainers.d.ts","sourceRoot":"","sources":["../../src/pipeline/paragraphContainers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAyB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAElE,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,KAAK,EAAE,UAAU,CAAC;IAClB;;;kEAG8D;IAC9D,SAAS,EAAE,UAAU,CAAC;IACtB,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,4EAA4E;IAC5E,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACtC,qEAAqE;IACrE,OAAO,EAAE,KAAK,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAC;CAChD;AAED,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,SAAS,YAAY,EAAE,EACtC,QAAQ,EAAE,cAAc,GACvB,sBAAsB,CAiDxB"}

package/dist/pipeline/paragraphContainers.js

@@ -0,0 +1,61 @@
+/**
+ * Pre-pass for `:::paragraphs{style="…"}` containers. The placement loop
+ * rewinds `blockIdx` on keep-with-next rollbacks and replays the blocks in
+ * between (marker blocks included), so container state is resolved up front
+ * per content-block index instead of being pushed/popped inside the loop.
+ */
+import { dimensionToPx } from '../units';
+import { resolveParagraphStyle } from './styles';
+export function planParagraphContainers(contentBlocks, resolved) {
+    const byId = new Map();
+    const byBlock = new Array(contentBlocks.length);
+    const dpi = resolved.page.dpi;
+    // Every open container occupies one slot, undefined for non-`paragraphs`
+    // containers and for unknown style ids (those render as plain body text —
+    // the build has no warnings channel; the editor's warnings phase can flag
+    // them).
+    const open = [];
+    const cache = new Map();
+    for (let i = 0; i < contentBlocks.length; i++) {
+        const b = contentBlocks[i];
+        if (b.type === 'containerStart') {
+            let entry;
+            const styleId = b.containerAttrs?.style;
+            if (b.containerName === 'paragraphs' && styleId !== undefined && b.containerId !== undefined) {
+                let base = cache.get(styleId);
+                if (!base) {
+                    const cfg = resolved.paragraphStyles.find((s) => s.id === styleId);
+                    if (cfg) {
+                        const style = resolveParagraphStyle(cfg, resolved);
+                        const marginBottomPx = dimensionToPx(cfg.marginBottom, dpi, style.fontSizePx);
+                        base = {
+                            style,
+                            tailStyle: { ...style, marginBottomPx: Math.max(style.marginBottomPx, marginBottomPx) },
+                            marginTopPx: dimensionToPx(cfg.marginTop, dpi, style.fontSizePx),
+                            marginBottomPx,
+                        };
+                        cache.set(styleId, base);
+                    }
+                }
+                if (base) {
+                    entry = { id: b.containerId, ...base };
+                    byId.set(b.containerId, entry);
+                }
+            }
+            open.push(entry);
+            continue;
+        }
+        if (b.type === 'containerEnd') {
+            open.pop();
+            continue;
+        }
+        for (let j = open.length - 1; j >= 0; j--) {
+            if (open[j]) {
+                byBlock[i] = open[j];
+                break;
+            }
+        }
+    }
+    return { byId, byBlock };
+}
+//# sourceMappingURL=paragraphContainers.js.map

package/dist/pipeline/paragraphContainers.js.map

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

package/dist/pipeline/parts.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 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 type { ContentBlock } from '../parse';
+import type { ResolvedConfig } from '../vdt';
+import type { BlockMeasureContext } from './measureContentBlock';
+export interface PlannedPart {
+    /** Content-block index of the `containerStart` marker. */
+    startIdx: number;
+    /** Content-block index of the matching `containerEnd` marker. */
+    endIdx: number;
+    containerId: number;
+    /** `number` attribute as written (`'I'`, `'2'`, …); `''` when absent. */
+    number: string;
+    /** `title` attribute; `''` when absent. */
+    title: string;
+}
+export interface PartPlan {
+    /** Start-marker index → part. */
+    byStart: Map<number, PlannedPart>;
+    /** End-marker index → part. */
+    byEnd: Map<number, PlannedPart>;
+    /** Content-block index → enclosing part (markers excluded). A part nested
+     *  inside another part is flattened into the outer one. */
+    byBlock: Array<PlannedPart | undefined>;
+}
+export declare function planParts(contentBlocks: readonly ContentBlock[]): PartPlan;
+/** 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 declare function parsePartNumber(raw: string): number | undefined;
+/** 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 declare function derivePartResolvedConfig(resolved: ResolvedConfig): ResolvedConfig;
+/** 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 declare function derivePartMeasureContext(ctx: BlockMeasureContext): BlockMeasureContext;
+//# sourceMappingURL=parts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parts.d.ts","sourceRoot":"","sources":["../../src/pipeline/parts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAQ7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,iCAAiC;IACjC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAClC,+BAA+B;IAC/B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAChC;+DAC2D;IAC3D,OAAO,EAAE,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC,CAAC;CACzC;AAED,wBAAgB,SAAS,CAAC,aAAa,EAAE,SAAS,YAAY,EAAE,GAAG,QAAQ,CAgC1E;AAOD;;wEAEwE;AACxE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAgB/D;AAmID;;;;;;uEAMuE;AACvE,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc,CA0BjF;AAED;;iCAEiC;AACjC,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,mBAAmB,GAAG,mBAAmB,CAqBtF"}

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"}