postext 0.3.16 → 0.3.18

package/dist/pipeline/config.d.ts

@@ -1,6 +1,9 @@
-import type { PostextConfig } from '../types';
+import type { PostextConfig, ResolvedHeadingLevelConfig } from '../types';
 import { type BoundingBox, type ResolvedConfig } from '../vdt';
 export declare function resolveAllConfig(rawConfig?: PostextConfig): ResolvedConfig;
+/** Index heading-level configs by level so per-block lookups in the
+ *  placement loop are O(1) instead of a linear `.find()`. */
+export declare function buildHeadingLevelMap(resolved: ResolvedConfig): Map<number, ResolvedHeadingLevelConfig>;
 export declare function computeBaselineGrid(resolved: ResolvedConfig): number;
 export declare function computeColumnBboxes(contentArea: BoundingBox, resolved: ResolvedConfig): BoundingBox[];
 //# sourceMappingURL=config.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/pipeline/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAc9C,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,QAAQ,CAAC;AAElF,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,aAAa,GAAG,cAAc,CAe1E;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAUpE;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,cAAc,GACvB,WAAW,EAAE,CAyBf"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/pipeline/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAiB1E,OAAO,EAAqB,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,QAAQ,CAAC;AAElF,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,aAAa,GAAG,cAAc,CAkB1E;AAED;6DAC6D;AAC7D,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,cAAc,GACvB,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAIzC;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAUpE;AAED,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,cAAc,GACvB,WAAW,EAAE,CAyBf"}

package/dist/pipeline/config.js

@@ -1,4 +1,4 @@
-import { resolvePageConfig, resolveLayoutConfig, resolveBodyTextConfig, resolveHeadingsConfig, resolveUnorderedListsConfig, resolveOrderedListsConfig, resolveMathConfig, resolveHeaderFooterConfig, applyPaletteToConfig, applyPaletteToResolvedConfig, } from '../defaults';
+import { resolvePageConfig, resolveLayoutConfig, resolveBodyTextConfig, resolveHeadingsConfig, resolveTableStyleConfig, resolveCaptionStyleConfig, resolveDiagramStyleConfig, resolveUnorderedListsConfig, resolveOrderedListsConfig, resolveMathConfig, resolveHeaderFooterConfig, applyPaletteToConfig, applyPaletteToResolvedConfig, } from '../defaults';
 import { dimensionToPx } from '../units';
 import { createBoundingBox } from '../vdt';
 export function resolveAllConfig(rawConfig) {
@@ -9,6 +9,9 @@ export function resolveAllConfig(rawConfig) {
         layout: resolveLayoutConfig(config?.layout),
         bodyText,
         headings: resolveHeadingsConfig(config?.headings),
+        tableStyle: resolveTableStyleConfig(config?.tableStyle, bodyText),
+        captionStyle: resolveCaptionStyleConfig(config?.captionStyle, bodyText),
+        diagramStyle: resolveDiagramStyleConfig(config?.diagramStyle),
         unorderedLists: resolveUnorderedListsConfig(config?.unorderedLists, bodyText),
         orderedLists: resolveOrderedListsConfig(config?.orderedLists, bodyText),
         math: resolveMathConfig(config?.math),
@@ -17,6 +20,14 @@ export function resolveAllConfig(rawConfig) {
     };
     return applyPaletteToResolvedConfig(resolved, rawConfig?.colorPalette);
 }
+/** Index heading-level configs by level so per-block lookups in the
+ *  placement loop are O(1) instead of a linear `.find()`. */
+export function buildHeadingLevelMap(resolved) {
+    const map = new Map();
+    for (const lvl of resolved.headings.levels)
+        map.set(lvl.level, lvl);
+    return map;
+}
 export function computeBaselineGrid(resolved) {
     const dpi = resolved.page.dpi;
     const bodyFontSizePx = dimensionToPx(resolved.bodyText.fontSize, dpi);

package/dist/pipeline/config.js.map

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

package/dist/pipeline/floatPlacement.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Float planning (issue #49 §7 — Placement, revised model).
+ *
+ * In the revised model a resource is *incorporated by reference*: the first
+ * time it is mentioned (an inline `:ref` or a `::resource` directive, whichever
+ * comes first in reading order) the engine floats it to a band at the top or
+ * bottom of the page near that reference. The author never places it twice and
+ * the running text flows past the reference uninterrupted.
+ *
+ * This module is the pure planning half: it resolves each resource's placement
+ * and produces the ordered list of floats with the content-block index of their
+ * first reference. The geometry (reserving page bands, positioning the float
+ * blocks, deferring overflow to the next page) lives in the build pipeline,
+ * which owns the VDT and measurement context.
+ */
+import type { ContentBlock } from '../parse';
+import type { Resource, ResourceType, ResourceFloatPosition, ResourceFloatSpan } from '../types';
+/** Resolved placement for a resource: never `undefined` fields. */
+export interface ResolvedPlacement {
+    position: ResourceFloatPosition;
+    span: ResourceFloatSpan;
+}
+/** A planned float: the resource, its resolved placement, and the index of the
+ *  content block where it is first referenced (its anchor). */
+export interface PlannedFloat {
+    resourceId: string;
+    firstBlockIdx: number;
+    position: 'top' | 'bottom';
+    span: ResourceFloatSpan;
+}
+/** Resolve a resource's placement: own `placement` → its type's
+ *  `defaultPlacement` → the built-in default (`top` / `column`). */
+export declare function resolveResourcePlacement(resource: Resource, type: ResourceType | undefined): ResolvedPlacement;
+/**
+ * Walk the parsed blocks in reading order and produce the floats to place, in
+ * first-reference order. A resource is floated when its resolved position is
+ * `'top'` or `'bottom'`; `'here'` resources are left for inline `::resource`
+ * placement and are not returned here. Resources with an unknown id or type are
+ * skipped (the warnings phase surfaces those).
+ */
+export declare function computeFloatPlan(blocks: ContentBlock[], resources: Resource[], resourceTypes: ResourceType[]): PlannedFloat[];
+/** The set of resource ids that float (so the build loop can skip their inline
+ *  `::resource` placement). Derived from a {@link computeFloatPlan} result. */
+export declare function floatedResourceIds(plan: PlannedFloat[]): Set<string>;
+//# sourceMappingURL=floatPlacement.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"floatPlacement.d.ts","sourceRoot":"","sources":["../../src/pipeline/floatPlacement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAElB,mEAAmE;AACnE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED;+DAC+D;AAC/D,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC3B,IAAI,EAAE,iBAAiB,CAAC;CACzB;AAED;oEACoE;AACpE,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,YAAY,GAAG,SAAS,GAC7B,iBAAiB,CAKnB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,YAAY,EAAE,EACtB,SAAS,EAAE,QAAQ,EAAE,EACrB,aAAa,EAAE,YAAY,EAAE,GAC5B,YAAY,EAAE,CA6BhB;AAED;+EAC+E;AAC/E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAEpE"}

package/dist/pipeline/floatPlacement.js

@@ -0,0 +1,68 @@
+/**
+ * Float planning (issue #49 §7 — Placement, revised model).
+ *
+ * In the revised model a resource is *incorporated by reference*: the first
+ * time it is mentioned (an inline `:ref` or a `::resource` directive, whichever
+ * comes first in reading order) the engine floats it to a band at the top or
+ * bottom of the page near that reference. The author never places it twice and
+ * the running text flows past the reference uninterrupted.
+ *
+ * This module is the pure planning half: it resolves each resource's placement
+ * and produces the ordered list of floats with the content-block index of their
+ * first reference. The geometry (reserving page bands, positioning the float
+ * blocks, deferring overflow to the next page) lives in the build pipeline,
+ * which owns the VDT and measurement context.
+ */
+/** Resolve a resource's placement: own `placement` → its type's
+ *  `defaultPlacement` → the built-in default (`top` / `column`). */
+export function resolveResourcePlacement(resource, type) {
+    const position = resource.placement?.position ?? type?.defaultPlacement?.position ?? 'top';
+    const span = resource.placement?.span ?? type?.defaultPlacement?.span ?? 'column';
+    return { position, span };
+}
+/**
+ * Walk the parsed blocks in reading order and produce the floats to place, in
+ * first-reference order. A resource is floated when its resolved position is
+ * `'top'` or `'bottom'`; `'here'` resources are left for inline `::resource`
+ * placement and are not returned here. Resources with an unknown id or type are
+ * skipped (the warnings phase surfaces those).
+ */
+export function computeFloatPlan(blocks, resources, resourceTypes) {
+    const resourceById = new Map();
+    for (const r of resources)
+        resourceById.set(r.id, r);
+    const typeById = new Map();
+    for (const t of resourceTypes)
+        typeById.set(t.id, t);
+    const plan = [];
+    const seen = new Set();
+    const record = (resourceId, blockIdx) => {
+        if (seen.has(resourceId))
+            return;
+        seen.add(resourceId);
+        const resource = resourceById.get(resourceId);
+        if (!resource)
+            return;
+        const type = typeById.get(resource.typeId);
+        const { position, span } = resolveResourcePlacement(resource, type);
+        if (position === 'here')
+            return;
+        plan.push({ resourceId, firstBlockIdx: blockIdx, position, span });
+    };
+    for (let i = 0; i < blocks.length; i++) {
+        const b = blocks[i];
+        if (b.type === 'resourceBlock' && b.resourceId)
+            record(b.resourceId, i);
+        for (const span of b.spans) {
+            if (span.ref?.resourceId)
+                record(span.ref.resourceId, i);
+        }
+    }
+    return plan;
+}
+/** The set of resource ids that float (so the build loop can skip their inline
+ *  `::resource` placement). Derived from a {@link computeFloatPlan} result. */
+export function floatedResourceIds(plan) {
+    return new Set(plan.map((f) => f.resourceId));
+}
+//# sourceMappingURL=floatPlacement.js.map

package/dist/pipeline/floatPlacement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"floatPlacement.js","sourceRoot":"","sources":["../../src/pipeline/floatPlacement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAyBH;oEACoE;AACpE,MAAM,UAAU,wBAAwB,CACtC,QAAkB,EAClB,IAA8B;IAE9B,MAAM,QAAQ,GACZ,QAAQ,CAAC,SAAS,EAAE,QAAQ,IAAI,IAAI,EAAE,gBAAgB,EAAE,QAAQ,IAAI,KAAK,CAAC;IAC5E,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,EAAE,IAAI,IAAI,IAAI,EAAE,gBAAgB,EAAE,IAAI,IAAI,QAAQ,CAAC;IAClF,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAsB,EACtB,SAAqB,EACrB,aAA6B;IAE7B,MAAM,YAAY,GAAG,IAAI,GAAG,EAAoB,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,SAAS;QAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;IACjD,KAAK,MAAM,CAAC,IAAI,aAAa;QAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAErD,MAAM,IAAI,GAAmB,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,MAAM,MAAM,GAAG,CAAC,UAAkB,EAAE,QAAgB,EAAE,EAAE;QACtD,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,OAAO;QACjC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACrB,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAC3C,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,wBAAwB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACpE,IAAI,QAAQ,KAAK,MAAM;YAAE,OAAO;QAChC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC;IAEF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QACrB,IAAI,CAAC,CAAC,IAAI,KAAK,eAAe,IAAI,CAAC,CAAC,UAAU;YAAE,MAAM,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QACxE,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,GAAG,EAAE,UAAU;gBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;+EAC+E;AAC/E,MAAM,UAAU,kBAAkB,CAAC,IAAoB;IACrD,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;AAChD,CAAC"}

package/dist/pipeline/headerFooter.d.ts

@@ -1,11 +1,27 @@
-import { type VDTDocument } from '../vdt';
+import type { DocumentMetadata, ResolvedDesignSlot, ResolvedHeadingLevelConfig } from '../types';
+import { type VDTDocument, type VDTDesignSlot } from '../vdt';
+import type { DesignPlaceholderContext } from '../design/placeholders';
+/** Measure the natural bottom of a heading's advanced-design slot when laid
+ *  out against a container of the given `width` with unbounded height.
+ *  Returns 0 if the level has no advanced design or the slot is empty. Used
+ *  during body layout to enlarge a heading block's reserved height so
+ *  subsequent blocks sit below the actual bottom of the design content
+ *  rather than below the natural text bottom. Applies to both in-column
+ *  headings (overlay in block bbox) and page-spanning openers (width is the
+ *  full content area; passed in by the caller). */
+export declare function measureHeadingAdvancedDesignHeight(level: ResolvedHeadingLevelConfig, heading: {
+    titleText: string;
+    formattedNumber: string;
+    chapterNumber: string;
+}, width: number, dpi: number, metadata: DocumentMetadata, pageIndex: number): number;
+export declare function layoutSlotToVdt(slot: ResolvedDesignSlot, container: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}, pageIndex: number, placeholders: DesignPlaceholderContext, dpi: number): VDTDesignSlot | undefined;
 /**
- * After body placement finishes, attach header/footer slots (with their
- * rendered text/rule blocks) to every page of the document.
- *
- * Headers and footers are rendered inside the existing page margins — they
- * do not consume body space. Header elements stack upward from the body's
- * top edge; footer elements stack downward from the body's bottom edge.
+ * After body placement finishes, attach header/footer slots to every page.
  */
 export declare function buildHeadersAndFooters(doc: VDTDocument): void;
 //# sourceMappingURL=headerFooter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"headerFooter.d.ts","sourceRoot":"","sources":["../../src/pipeline/headerFooter.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,KAAK,WAAW,EAMjB,MAAM,QAAQ,CAAC;AAsJhB;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAqC7D"}
+{"version":3,"file":"headerFooter.d.ts","sourceRoot":"","sources":["../../src/pipeline/headerFooter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAA6B,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAC5H,OAAO,EAGL,KAAK,WAAW,EAChB,KAAK,aAAa,EAMnB,MAAM,QAAQ,CAAC;AAWhB,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AA0GvE;;;;;;;mDAOmD;AACnD,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,0BAA0B,EACjC,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,EAC9E,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,MAAM,GAChB,MAAM,CAsBR;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,kBAAkB,EACxB,SAAS,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAClE,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,wBAAwB,EACtC,GAAG,EAAE,MAAM,GACV,aAAa,GAAG,SAAS,CAQ3B;AAsED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAmH7D"}

package/dist/pipeline/headerFooter.js

@@ -1,134 +1,294 @@
 import { createBoundingBox, } from '../vdt';
-import { dimensionToPx } from '../units';
-import { buildFontString, measureTextWidth } from '../measure';
-import { computeChapterTitles, resolvePlaceholders } from './placeholders';
+import { computeChapterTitles, computeChapterNumbers } from './placeholders';
 import { computePageMetrics } from './buildHelpers';
-function pageMatchesParity(pageIndex, parity) {
-    if (parity === 'all')
-        return true;
-    // Convention: use page-number parity (page 1 = odd).
-    const pageNumber = pageIndex + 1;
-    const isOdd = pageNumber % 2 === 1;
-    return parity === 'odd' ? isOdd : !isOdd;
-}
-function elementHeightPx(el, dpi) {
-    if (el.kind === 'text') {
-        const fontSizePx = dimensionToPx(el.fontSize, dpi);
-        // Approximate line height as 1.2 × font size.
-        return fontSizePx * 1.2;
-    }
-    return dimensionToPx(el.thickness, dpi);
+import { buildHeadingLevelMap } from './config';
+import { layoutDesignSlot, } from '../design/layout';
+/** Slots live in the page margin area between the body edge and the page
+ *  edge. Header slot container: from `top-margin` edge down to body top.
+ *  Footer slot container: from body bottom down to `bottom-margin` edge.
+ *
+ *  We use a larger container (the full page vertical extent of the margin
+ *  area) so that anchors like `bottom-center` / `bottom-right` for headers
+ *  and `top-*` for footers align with the body edge (the body-facing side
+ *  of the margin area) rather than the outer page edge.
+ *
+ *  This matches the legacy semantics: `marginFromBody` was "distance from
+ *  body edge" — the migration translates that to an offset of the same
+ *  magnitude from the body-facing edge. */
+function headerContainerBbox(contentArea, _pageHeight) {
+    // Header: spans from top of page to body top.
+    return { x: contentArea.x, y: 0, width: contentArea.width, height: contentArea.y };
 }
-function filterElementsByParity(slot, pageIndex) {
-    return slot.elements.filter((el) => pageMatchesParity(pageIndex, el.parity));
+function footerContainerBbox(contentArea, pageHeight) {
+    const bodyBottom = contentArea.y + contentArea.height;
+    return {
+        x: contentArea.x,
+        y: bodyBottom,
+        width: contentArea.width,
+        height: Math.max(0, pageHeight - bodyBottom),
+    };
 }
-function xForAlign(align, contentX, contentWidth, elementWidth, edgeInsetPx) {
+function textAlignOffsetX(align, contentWidth, lineWidth) {
     if (align === 'left')
-        return contentX + edgeInsetPx;
+        return 0;
     if (align === 'right')
-        return contentX + contentWidth - elementWidth - edgeInsetPx;
-    return contentX + (contentWidth - elementWidth) / 2;
+        return Math.max(0, contentWidth - lineWidth);
+    return Math.max(0, (contentWidth - lineWidth) / 2);
+}
+function primitiveToBlock(prim) {
+    if (prim.kind === 'text')
+        return textPrimitiveToBlock(prim);
+    if (prim.kind === 'rule')
+        return rulePrimitiveToBlock(prim);
+    return boxPrimitiveToBlock(prim);
 }
-function buildTextBlock(el, resolvedText, contentX, contentWidth, elementTop, dpi) {
-    const fontSizePx = dimensionToPx(el.fontSize, dpi);
-    const weight = el.fontWeight === 400 ? 'normal' : String(el.fontWeight);
-    const style = el.italic ? 'italic' : 'normal';
-    const fontString = buildFontString(el.fontFamily, fontSizePx, weight, style);
-    const textWidth = measureTextWidth(resolvedText, fontString);
-    const blockHeight = fontSizePx * 1.2;
-    const edgeInsetPx = dimensionToPx(el.marginFromEdge, dpi);
-    const x = xForAlign(el.align, contentX, contentWidth, textWidth, edgeInsetPx);
-    // Baseline at ~0.8 of the block height, matching body text convention.
-    const baseline = elementTop + blockHeight * 0.8;
+function textPrimitiveToBlock(prim) {
+    const totalContentHeight = prim.lines.reduce((s, l) => Math.max(s, l.topY + l.height), 0);
+    const vOffset = prim.verticalAlign === 'top' ? 0
+        : prim.verticalAlign === 'bottom' ? Math.max(0, prim.contentHeight - totalContentHeight)
+            : Math.max(0, (prim.contentHeight - totalContentHeight) / 2);
+    const lines = prim.lines.map((l) => ({
+        text: l.text,
+        xOffset: prim.contentX + textAlignOffsetX(prim.align, prim.contentWidth, l.width),
+        baselineY: prim.y + prim.contentY + vOffset + l.baselineY,
+        width: l.width,
+    }));
     return {
         kind: 'text',
-        bbox: createBoundingBox(x, elementTop, textWidth, blockHeight),
-        text: resolvedText,
-        align: el.align,
-        fontString,
-        color: el.color.hex,
-        baseline,
+        bbox: createBoundingBox(prim.x, prim.y, prim.width, prim.height),
+        fontString: prim.fontString,
+        color: prim.color,
+        lines,
+        box: prim.box
+            ? {
+                backgroundColor: prim.box.backgroundColor,
+                borderColor: prim.box.borderColor,
+                borderWidthPx: prim.box.borderWidthPx,
+                borderRadiusPx: prim.box.borderRadiusPx,
+            }
+            : undefined,
+        clip: prim.needsClip,
     };
 }
-function buildRuleBlock(el, contentX, contentWidth, elementTop, dpi) {
-    const thicknessPx = dimensionToPx(el.thickness, dpi);
-    const widthPx = el.width === 'full' ? contentWidth : dimensionToPx(el.width, dpi);
-    // `marginFromEdge` only meaningful for non-full rules — a full-width rule
-    // already spans the content, so the inset would just crop it asymmetrically.
-    const edgeInsetPx = el.width === 'full' ? 0 : dimensionToPx(el.marginFromEdge, dpi);
-    const x = xForAlign(el.align, contentX, contentWidth, widthPx, edgeInsetPx);
+function rulePrimitiveToBlock(prim) {
     return {
         kind: 'rule',
-        bbox: createBoundingBox(x, elementTop, widthPx, thicknessPx),
-        color: el.color.hex,
-        thicknessPx,
+        bbox: createBoundingBox(prim.x, prim.y, prim.width, prim.height),
+        color: prim.color,
+        thicknessPx: prim.thicknessPx,
+        direction: prim.direction,
     };
 }
-/**
- * Layout elements for one slot on one page.
- *
- * Each element's `marginFromBody` is an absolute distance between its
- * body-facing edge and the body edge — elements are independent and never
- * push each other. Two elements with the same `marginFromBody` will overlap;
- * that's on the author to avoid.
- */
-function layoutSlot(slot, pageIndex, contentX, contentWidth, anchor, anchorY, metadata, allPages, chapterTitleByPageIndex, dpi) {
-    const elements = filterElementsByParity(slot, pageIndex);
-    if (elements.length === 0)
-        return undefined;
-    const page = allPages[pageIndex];
-    const ctx = {
-        page,
-        allPages,
+function boxPrimitiveToBlock(prim) {
+    return {
+        kind: 'box',
+        bbox: createBoundingBox(prim.x, prim.y, prim.width, prim.height),
+        box: {
+            backgroundColor: prim.box.backgroundColor,
+            borderColor: prim.box.borderColor,
+            borderWidthPx: prim.box.borderWidthPx,
+            borderRadiusPx: prim.box.borderRadiusPx,
+        },
+    };
+}
+/** Measure the natural bottom of a heading's advanced-design slot when laid
+ *  out against a container of the given `width` with unbounded height.
+ *  Returns 0 if the level has no advanced design or the slot is empty. Used
+ *  during body layout to enlarge a heading block's reserved height so
+ *  subsequent blocks sit below the actual bottom of the design content
+ *  rather than below the natural text bottom. Applies to both in-column
+ *  headings (overlay in block bbox) and page-spanning openers (width is the
+ *  full content area; passed in by the caller). */
+export function measureHeadingAdvancedDesignHeight(level, heading, width, dpi, metadata, pageIndex) {
+    if (!level.advancedDesign.enabled)
+        return 0;
+    if (level.advancedDesign.slot.elements.length === 0)
+        return 0;
+    const stubPage = { index: pageIndex, pageLabel: '1' };
+    const placeholders = {
+        kind: 'heading',
+        page: stubPage,
+        allPages: [stubPage],
         metadata,
-        chapterTitleByPageIndex,
+        chapterTitleByPageIndex: [],
+        heading,
     };
-    const blocks = [];
-    let minY = anchorY;
-    let maxBottom = anchorY;
-    for (const el of elements) {
-        const height = elementHeightPx(el, dpi);
-        const marginPx = dimensionToPx(el.marginFromBody, dpi);
-        // For a header (anchor='bottom' at body top): element's bottom edge sits
-        // `marginPx` above the body. For a footer (anchor='top' at body bottom):
-        // element's top edge sits `marginPx` below the body.
-        const elementTop = anchor === 'bottom' ? anchorY - marginPx - height : anchorY + marginPx;
-        if (el.kind === 'text') {
-            const { text } = resolvePlaceholders(el.content, ctx);
-            if (text.length > 0) {
-                blocks.push(buildTextBlock(el, text, contentX, contentWidth, elementTop, dpi));
-            }
-        }
-        else {
-            blocks.push(buildRuleBlock(el, contentX, contentWidth, elementTop, dpi));
-        }
-        minY = Math.min(minY, elementTop);
-        maxBottom = Math.max(maxBottom, elementTop + height);
+    const result = layoutDesignSlot(level.advancedDesign.slot, { container: { x: 0, y: 0, width, height: 1e6 }, dpi, placeholders }, pageIndex);
+    let bottom = 0;
+    for (const prim of result.primitives) {
+        bottom = Math.max(bottom, prim.y + prim.height);
     }
-    if (blocks.length === 0)
+    return bottom;
+}
+export function layoutSlotToVdt(slot, container, pageIndex, placeholders, dpi) {
+    const result = layoutDesignSlot(slot, { container, dpi, placeholders }, pageIndex);
+    if (result.primitives.length === 0)
         return undefined;
-    const slotBbox = createBoundingBox(contentX, minY, contentWidth, maxBottom - minY);
-    return { bbox: slotBbox, blocks };
+    const blocks = result.primitives.map(primitiveToBlock);
+    return {
+        bbox: createBoundingBox(container.x, container.y, container.width, container.height),
+        blocks,
+    };
+}
+/** Container bbox for a page-spanning heading opener band: occupies the
+ *  vertical band the heading block reserved in its column, extended
+ *  horizontally across the full content area (both columns) — but NOT beyond
+ *  the page margins. */
+function openerContainerBbox(block, contentArea) {
+    return { x: contentArea.x, y: block.bbox.y, width: contentArea.width, height: block.bbox.height };
+}
+/** Find the first heading block on `page` that belongs to a level with
+ *  `span === 'page'`. Returns the block and info needed to resolve
+ *  placeholders in the design slot. Triggers regardless of whether
+ *  `advancedDesign.enabled` is true — when false, the pipeline synthesises
+ *  a default slot from the heading level typography. */
+function findOpenerHeading(page, headingLevelByNumber) {
+    for (const col of page.columns) {
+        for (const block of col.blocks) {
+            if (block.type !== 'heading' || !block.headingLevel)
+                continue;
+            const lvl = headingLevelByNumber.get(block.headingLevel);
+            if (!lvl)
+                continue;
+            if (lvl.span !== 'page')
+                continue;
+            const full = block.lines
+                .map((ln) => (ln.segments ?? []).map((s) => s.text).join(''))
+                .join(' ');
+            const pref = block.numberPrefix ?? '';
+            const title = pref && full.startsWith(`${pref} `) ? full.slice(pref.length + 1) : full;
+            return { block, level: block.headingLevel, titleText: title, numberPrefix: pref };
+        }
+    }
+    return undefined;
+}
+/** Build a synthesised default design slot for a `span: 'page'` heading when
+ *  the user has not configured an `advancedDesign.slot`. Renders as a single
+ *  text element, anchored to fill the full-page-width container, using the
+ *  heading level's resolved typography. Emits `{formattedNumber} {titleText}`
+ *  when the heading carries a numberPrefix, otherwise `{titleText}`. */
+function synthesiseDefaultOpenerSlot(level, hasNumberPrefix) {
+    const content = hasNumberPrefix ? '{formattedNumber} {titleText}' : '{titleText}';
+    const textEl = {
+        kind: 'text',
+        id: 'defaultHeadingOpener',
+        parity: 'all',
+        placement: {
+            anchor: { to: 'container', edge: 'top-left' },
+            offset: { x: { value: 0, unit: 'pt' }, y: { value: 0, unit: 'pt' } },
+            size: { width: 'fill', height: 'fill' },
+        },
+        content,
+        fontFamily: level.fontFamily,
+        fontSize: level.fontSize,
+        fontWeight: level.fontWeight,
+        italic: level.italic,
+        color: level.color,
+        align: 'left',
+        verticalAlign: 'middle',
+        lineHeight: level.lineHeight.unit === 'em' ? level.lineHeight.value : 1.2,
+        overflow: 'wrap',
+        hyphenate: true,
+    };
+    return { elements: [textEl] };
 }
 /**
- * After body placement finishes, attach header/footer slots (with their
- * rendered text/rule blocks) to every page of the document.
- *
- * Headers and footers are rendered inside the existing page margins — they
- * do not consume body space. Header elements stack upward from the body's
- * top edge; footer elements stack downward from the body's bottom edge.
+ * After body placement finishes, attach header/footer slots to every page.
  */
 export function buildHeadersAndFooters(doc) {
     const resolved = doc.config;
     const dpi = resolved.page.dpi;
     const { contentArea } = computePageMetrics(resolved);
     const chapterTitleByPageIndex = computeChapterTitles(doc.blocks, doc.pages.length, doc.pages);
+    const chapterNumberByPageIndex = computeChapterNumbers(doc.blocks, doc.pages.length, doc.pages);
+    const headingLevelByNumber = buildHeadingLevelMap(resolved);
     for (const page of doc.pages) {
         if (resolved.header.elements.length > 0) {
-            page.header = layoutSlot(resolved.header, page.index, contentArea.x, contentArea.width, 'bottom', contentArea.y, doc.metadata, doc.pages, chapterTitleByPageIndex, dpi);
+            const placeholders = {
+                kind: 'header',
+                page,
+                allPages: doc.pages,
+                metadata: doc.metadata,
+                chapterTitleByPageIndex,
+            };
+            page.header = layoutSlotToVdt(resolved.header, headerContainerBbox(contentArea, page.height), page.index, placeholders, dpi);
+        }
+        const opener = findOpenerHeading(page, headingLevelByNumber);
+        if (opener) {
+            const level = headingLevelByNumber.get(opener.level);
+            if (level) {
+                const slot = level.advancedDesign.enabled && level.advancedDesign.slot.elements.length > 0
+                    ? level.advancedDesign.slot
+                    : synthesiseDefaultOpenerSlot(level, opener.numberPrefix.length > 0);
+                const placeholders = {
+                    kind: 'heading',
+                    page,
+                    allPages: doc.pages,
+                    metadata: doc.metadata,
+                    chapterTitleByPageIndex,
+                    heading: {
+                        titleText: opener.titleText,
+                        formattedNumber: opener.numberPrefix,
+                        chapterNumber: chapterNumberByPageIndex[page.index] ?? '',
+                    },
+                };
+                page.openerBand = layoutSlotToVdt(slot, openerContainerBbox(opener.block, contentArea), page.index, placeholders, dpi);
+                if (page.openerBand) {
+                    opener.block.hidden = true;
+                }
+            }
+        }
+        // In-column heading advanced-design overlays: any heading whose level
+        // has `advancedDesign.enabled` and a non-empty slot gets its default
+        // text rendering replaced with a design overlay laid out inside the
+        // block's bbox. `span: 'page'` headings are handled via `openerBand`
+        // above (and are already `hidden`), so they're skipped here.
+        for (const col of page.columns) {
+            for (const block of col.blocks) {
+                if (block.hidden)
+                    continue;
+                if (block.type !== 'heading' || !block.headingLevel)
+                    continue;
+                const lvl = headingLevelByNumber.get(block.headingLevel);
+                if (!lvl)
+                    continue;
+                if (lvl.span === 'page')
+                    continue;
+                if (!lvl.advancedDesign.enabled)
+                    continue;
+                if (lvl.advancedDesign.slot.elements.length === 0)
+                    continue;
+                const full = block.lines
+                    .map((ln) => (ln.segments ?? []).map((s) => s.text).join(''))
+                    .join(' ');
+                const pref = block.numberPrefix ?? '';
+                const title = pref && full.startsWith(`${pref} `) ? full.slice(pref.length + 1) : full;
+                const placeholders = {
+                    kind: 'heading',
+                    page,
+                    allPages: doc.pages,
+                    metadata: doc.metadata,
+                    chapterTitleByPageIndex,
+                    heading: {
+                        titleText: title,
+                        formattedNumber: pref,
+                        chapterNumber: chapterNumberByPageIndex[page.index] ?? '',
+                    },
+                };
+                const overlay = layoutSlotToVdt(lvl.advancedDesign.slot, { x: block.bbox.x, y: block.bbox.y, width: block.bbox.width, height: block.bbox.height }, page.index, placeholders, dpi);
+                if (overlay)
+                    block.designOverlay = overlay;
+            }
         }
         if (resolved.footer.elements.length > 0) {
-            page.footer = layoutSlot(resolved.footer, page.index, contentArea.x, contentArea.width, 'top', contentArea.y + contentArea.height, doc.metadata, doc.pages, chapterTitleByPageIndex, dpi);
+            const placeholders = {
+                kind: 'footer',
+                page,
+                allPages: doc.pages,
+                metadata: doc.metadata,
+                chapterTitleByPageIndex,
+            };
+            page.footer = layoutSlotToVdt(resolved.footer, footerContainerBbox(contentArea, page.height), page.index, placeholders, dpi);
         }
     }
 }