postext 0.3.16 → 0.3.17

package/dist/pipeline/placement.js

@@ -18,7 +18,7 @@ export function createPageWithColumns(pageIndex, resolved, contentArea, pageWidt
 export function currentColumn(doc, cursor) {
     return doc.pages[cursor.pageIndex].columns[cursor.columnIndex];
 }
-export function advanceToNextColumn(doc, cursor, resolved, contentArea, pageWidthPx, pageHeightPx) {
+export function advanceToNextColumn(doc, cursor, resolved, contentArea, pageWidthPx, pageHeightPx, onNewPage) {
     const page = doc.pages[cursor.pageIndex];
     if (cursor.columnIndex < page.columns.length - 1) {
         cursor.columnIndex++;
@@ -29,20 +29,25 @@ export function advanceToNextColumn(doc, cursor, resolved, contentArea, pageWidt
         doc.pages.push(newPage);
         cursor.pageIndex = newPage.index;
         cursor.columnIndex = 0;
+        // Let the caller reserve float bands at the top/bottom of the freshly
+        // opened page before any content flows into it. Only the content-flow
+        // advances pass this hook — parity / force-blank pages never receive
+        // floats because `enforcePageParity` calls this without `onNewPage`.
+        onNewPage?.(newPage);
     }
 }
 /** 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
  *  emitting a blank leading page when a `:::pagebreak` directive lands
  *  before any content. */
-export function advanceToNextPageBoundary(doc, cursor, resolved, contentArea, pageWidthPx, pageHeightPx) {
+export function advanceToNextPageBoundary(doc, cursor, resolved, contentArea, pageWidthPx, pageHeightPx, onNewPage) {
     const curPage = doc.pages[cursor.pageIndex];
     const curPageEmpty = curPage.columns.every((c) => c.blocks.length === 0);
     if (curPageEmpty)
         return;
     const startPageIndex = cursor.pageIndex;
     do {
-        advanceToNextColumn(doc, cursor, resolved, contentArea, pageWidthPx, pageHeightPx);
+        advanceToNextColumn(doc, cursor, resolved, contentArea, pageWidthPx, pageHeightPx, onNewPage);
     } while (cursor.pageIndex === startPageIndex);
 }
 /** After a forced page break, make sure the page we're sitting on has the
@@ -95,6 +100,36 @@ export function enforcePageParity(doc, cursor, resolved, contentArea, pageWidthP
         } while (cursor.pageIndex === startPageIndex);
     }
 }
+/**
+ * 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.
+ *
+ * `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 function placeResourceBlock(block, groupHeight, spacingBefore, cursor, doc, resolved, contentArea, pageWidthPx, pageHeightPx) {
+    let col = currentColumn(doc, cursor);
+    const isFirstInColumn = col.blocks.length === 0;
+    const effectiveSpacing = isFirstInColumn ? 0 : spacingBefore;
+    const available = col.availableHeight - effectiveSpacing;
+    // Advance to the next column/page when the group does not fit and the current
+    // column already holds content. A group taller than a full column is placed
+    // anyway (no mid-split for v1) once it lands in an empty column.
+    if (groupHeight > available && col.blocks.length > 0) {
+        advanceToNextColumn(doc, cursor, resolved, contentArea, pageWidthPx, pageHeightPx);
+        col = currentColumn(doc, cursor);
+    }
+    const consumeSpacing = col.blocks.length === 0 ? 0 : spacingBefore;
+    if (consumeSpacing > 0)
+        col.availableHeight -= consumeSpacing;
+    placeBlockInColumn(block, groupHeight, col, cursor);
+    return groupHeight;
+}
 export function placeBlockInColumn(block, blockHeight, col, cursor) {
     const y = col.bbox.y + (col.bbox.height - col.availableHeight);
     block.bbox = createBoundingBox(col.bbox.x, y, col.bbox.width, blockHeight);

package/dist/pipeline/placement.js.map

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

package/dist/pipeline/resourceLayout.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Resource block layout (issue #49 §7 — Measurement).
+ *
+ * Turns a `Resource` + its computed number into a measured, placement-ready
+ * {@link ResolvedResourceBlock}. The result is fully self-contained so the
+ * canvas / PDF renderers can draw it synchronously without touching the parser
+ * or numbering pipeline again.
+ *
+ * Layout rules for v1 (kept intentionally simple — see the issue plan):
+ *  - bitmap / svg: scale to the column width, preserving aspect ratio. The
+ *    height follows from the intrinsic dimensions; svgs without intrinsic
+ *    dimensions fall back to a 4:3 box at column width.
+ *  - table: equal column split; each cell measured via the shared rich-text
+ *    measurer; row height = max cell height (rowspans distribute across rows).
+ *  - caption: measured via the rich-text measurer with the caption font, with
+ *    the type's caption prefix + number prepended. Inline `:ref` spans resolve
+ *    to their computed label and are tagged so renderers can colour / link them.
+ *
+ * Resource + caption are measured as one group; `totalHeight` is what goes to
+ * placement (resources paginate atomically — no mid-split for v1).
+ */
+import type { InlineSpan } from '../parse';
+import type { Resource, ResourceType } from '../types';
+import type { ResolvedConfig, ResolvedResourceBlock } from '../vdt';
+import type { ResourceNumberingMap } from './resourceNumbering';
+export interface ResourceLayoutInput {
+    resource: Resource;
+    resourceType: ResourceType | undefined;
+    number: string;
+    resolved: ResolvedConfig;
+    /** Available column width in px. */
+    columnWidth: number;
+    /** Full numbering map — lets inline `:ref`s inside the caption resolve. */
+    resourceNumbering: ResourceNumberingMap;
+    resourceTypes: ResourceType[];
+    resources: Resource[];
+}
+/** Build a label for an inline `:ref` to a resource, honouring its `style` and
+ *  optional override `text`. Mirrors the caption-prefix conventions. */
+export declare function resolveRefLabel(ref: NonNullable<InlineSpan['ref']>, resourceNumbering: ResourceNumberingMap, resourceTypes: ResourceType[], resources: Resource[]): string;
+/** Resolve inline `:ref` spans to their computed label, keeping the `ref`
+ *  metadata so the rich-text measurer treats each label as one atomic,
+ *  non-breaking token and tags the produced segment with `refResourceId`. */
+export declare function resolveRefSpans(spans: InlineSpan[], resourceNumbering: ResourceNumberingMap, resourceTypes: ResourceType[], resources: Resource[], refStyle?: {
+    bold: boolean;
+    italic: boolean;
+}): InlineSpan[];
+/**
+ * Measure a resource block (image / svg / table) plus its caption into a
+ * placement-ready {@link ResolvedResourceBlock}. Returns the block and its
+ * combined height (figure body + gap + caption) — the value placement uses to
+ * decide whether the group fits the remaining column space.
+ */
+export declare function layoutResourceBlock(input: ResourceLayoutInput): {
+    block: ResolvedResourceBlock;
+    totalHeight: number;
+};
+//# sourceMappingURL=resourceLayout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resourceLayout.d.ts","sourceRoot":"","sources":["../../src/pipeline/resourceLayout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EAIb,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EAItB,MAAM,QAAQ,CAAC;AAMhB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAMhE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,QAAQ,CAAC;IACnB,YAAY,EAAE,YAAY,GAAG,SAAS,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,cAAc,CAAC;IACzB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,iBAAiB,EAAE,oBAAoB,CAAC;IACxC,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED;wEACwE;AACxE,wBAAgB,eAAe,CAC7B,GAAG,EAAE,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EACnC,iBAAiB,EAAE,oBAAoB,EACvC,aAAa,EAAE,YAAY,EAAE,EAC7B,SAAS,EAAE,QAAQ,EAAE,GACpB,MAAM,CAcR;AAWD;;6EAE6E;AAC7E,wBAAgB,eAAe,CAC7B,KAAK,EAAE,UAAU,EAAE,EACnB,iBAAiB,EAAE,oBAAoB,EACvC,aAAa,EAAE,YAAY,EAAE,EAC7B,SAAS,EAAE,QAAQ,EAAE,EACrB,QAAQ,CAAC,EAAE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC5C,UAAU,EAAE,CAcd;AA+LD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,GAAG;IAC/D,KAAK,EAAE,qBAAqB,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB,CA2KA"}

package/dist/pipeline/resourceLayout.js

@@ -0,0 +1,338 @@
+/**
+ * Resource block layout (issue #49 §7 — Measurement).
+ *
+ * Turns a `Resource` + its computed number into a measured, placement-ready
+ * {@link ResolvedResourceBlock}. The result is fully self-contained so the
+ * canvas / PDF renderers can draw it synchronously without touching the parser
+ * or numbering pipeline again.
+ *
+ * Layout rules for v1 (kept intentionally simple — see the issue plan):
+ *  - bitmap / svg: scale to the column width, preserving aspect ratio. The
+ *    height follows from the intrinsic dimensions; svgs without intrinsic
+ *    dimensions fall back to a 4:3 box at column width.
+ *  - table: equal column split; each cell measured via the shared rich-text
+ *    measurer; row height = max cell height (rowspans distribute across rows).
+ *  - caption: measured via the rich-text measurer with the caption font, with
+ *    the type's caption prefix + number prepended. Inline `:ref` spans resolve
+ *    to their computed label and are tagged so renderers can colour / link them.
+ *
+ * Resource + caption are measured as one group; `totalHeight` is what goes to
+ * placement (resources paginate atomically — no mid-split for v1).
+ */
+import { createBoundingBox } from '../vdt';
+import { measureRichBlock, buildFontString } from '../measure';
+import { dimensionToPx } from '../units';
+import { extractInlineRefs, injectRefSpans, parseInlineFormatting } from '../parse/inlineFormatting';
+import { resolveBodyStyle } from './styles';
+/** Non-breaking space used to glue a resolved `:ref` label into a single
+ *  atomic text token, so a post-measurement pass can tag it reliably. */
+const NBSP = ' ';
+/** Build a label for an inline `:ref` to a resource, honouring its `style` and
+ *  optional override `text`. Mirrors the caption-prefix conventions. */
+export function resolveRefLabel(ref, resourceNumbering, resourceTypes, resources) {
+    if (ref.text !== undefined && ref.text.length > 0)
+        return ref.text;
+    const entry = resourceNumbering[ref.resourceId];
+    const number = entry?.number ?? '?';
+    if (ref.style === 'number')
+        return number;
+    const resource = resources.find((r) => r.id === ref.resourceId);
+    const type = resource ? resourceTypes.find((t) => t.id === resource.typeId) : undefined;
+    if (ref.style === 'full') {
+        const name = type?.name ?? type?.shortLabel ?? '';
+        return name ? `${name}${NBSP}${number}` : number;
+    }
+    // default: short label + number (e.g. "Fig. 1.7")
+    const short = type?.shortLabel ?? type?.name ?? '';
+    return short ? `${short}${NBSP}${number}` : number;
+}
+/** Parse caption / table-cell content into inline spans, recognising the same
+ *  inline `:ref{…}` microformat as body text so references inside captions and
+ *  cells resolve to their computed labels (the cell/caption is self-contained,
+ *  so source offsets are irrelevant here). */
+function parseRefAwareSpans(content) {
+    const { cleaned, refs } = extractInlineRefs(content, 0);
+    return injectRefSpans(parseInlineFormatting(cleaned), refs);
+}
+/** Resolve inline `:ref` spans to their computed label, keeping the `ref`
+ *  metadata so the rich-text measurer treats each label as one atomic,
+ *  non-breaking token and tags the produced segment with `refResourceId`. */
+export function resolveRefSpans(spans, resourceNumbering, resourceTypes, resources, refStyle) {
+    if (!spans.some((s) => s.ref))
+        return spans;
+    return spans.map((span) => {
+        if (!span.ref)
+            return span;
+        return {
+            ...span,
+            text: resolveRefLabel(span.ref, resourceNumbering, resourceTypes, resources),
+            // Reference labels carry their own emphasis (bold/italic) so the measurer
+            // selects the matching font; colour is applied by renderers via
+            // `refResourceId`.
+            bold: refStyle?.bold ?? span.bold,
+            italic: refStyle?.italic ?? span.italic,
+        };
+    });
+}
+/** Offset every line's bbox / baseline by `dy` (block-relative → block-relative
+ *  shifted). Returns new line objects (FP-first). */
+function shiftLines(lines, dx, dy) {
+    return lines.map((line) => ({
+        ...line,
+        bbox: createBoundingBox(line.bbox.x + dx, line.bbox.y + dy, line.bbox.width, line.bbox.height),
+        baseline: line.baseline + dy,
+    }));
+}
+/** Compute the displayed (column-fitted, aspect-preserved) size of a bitmap. */
+function fitWidth(intrinsicW, intrinsicH, columnWidth) {
+    if (intrinsicW <= 0 || intrinsicH <= 0) {
+        // No intrinsic dims — default to a 4:3 box at column width.
+        return { width: columnWidth, height: columnWidth * 0.75 };
+    }
+    const width = Math.min(intrinsicW, columnWidth);
+    const height = (intrinsicH / intrinsicW) * width;
+    return { width, height };
+}
+/** Lay out an HTML-table resource: equal column split, per-cell rich-text
+ *  measurement, row height = max measured cell height. Rowspans reserve their
+ *  primary cell's full vertical extent. */
+function layoutTable(model, columnWidth, style, resourceNumbering, resourceTypes, resources, refStyle) {
+    const { body, header, borderColor, borderWidthPx, cellPaddingPx } = style;
+    const rowCount = model.rows.length;
+    const colCount = rowCount > 0 ? Math.max(...model.rows.map((r) => r.length)) : 0;
+    const colWidth = colCount > 0 ? columnWidth / colCount : columnWidth;
+    const columnEdges = [];
+    for (let c = 0; c <= colCount; c++)
+        columnEdges.push(c * colWidth);
+    const measured = [];
+    const rowMinHeight = new Array(rowCount).fill(body.lineHeightPx);
+    for (let r = 0; r < rowCount; r++) {
+        const row = model.rows[r];
+        for (let c = 0; c < row.length; c++) {
+            const cell = row[c];
+            if (cell.hiddenBy)
+                continue;
+            const colSpan = Math.max(1, cell.colSpan ?? 1);
+            const rowSpan = Math.max(1, cell.rowSpan ?? 1);
+            const isHeader = cell.isHeader ?? r < (model.headerRowCount ?? 0);
+            const set = isHeader ? header : body;
+            const cellWidth = colSpan * colWidth - cellPaddingPx * 2;
+            const spans = resolveRefSpans(parseRefAwareSpans(cell.content), resourceNumbering, resourceTypes, resources, refStyle);
+            const m = measureRichBlock(spans, set.fontString, set.boldFontString, set.italicFontString, set.boldItalicFontString, Math.max(1, cellWidth), set.lineHeightPx, { textAlign: cell.align === 'center' ? 'center' : cell.align === 'right' ? 'left' : 'left' });
+            const contentHeight = Math.max(set.lineHeightPx, m.totalHeight) + cellPaddingPx * 2;
+            measured.push({
+                row: r,
+                col: c,
+                colSpan,
+                rowSpan,
+                isHeader,
+                align: cell.align ?? 'left',
+                verticalAlign: cell.verticalAlign ?? 'top',
+                lines: m.lines,
+                contentHeight,
+            });
+            // Single-row cells drive their row's minimum height directly.
+            if (rowSpan === 1) {
+                rowMinHeight[r] = Math.max(rowMinHeight[r], contentHeight);
+            }
+        }
+    }
+    // Distribute rowspan cells: ensure the spanned rows together fit the content.
+    for (const m of measured) {
+        if (m.rowSpan <= 1)
+            continue;
+        let spannedHeight = 0;
+        for (let r = m.row; r < m.row + m.rowSpan && r < rowCount; r++) {
+            spannedHeight += rowMinHeight[r];
+        }
+        if (m.contentHeight > spannedHeight) {
+            const lastRow = Math.min(m.row + m.rowSpan - 1, rowCount - 1);
+            rowMinHeight[lastRow] = rowMinHeight[lastRow] + (m.contentHeight - spannedHeight);
+        }
+    }
+    const rowEdges = [0];
+    for (let r = 0; r < rowCount; r++)
+        rowEdges.push(rowEdges[r] + rowMinHeight[r]);
+    const tableHeight = rowEdges[rowCount] ?? 0;
+    const cells = measured.map((m) => {
+        const x0 = columnEdges[m.col] ?? 0;
+        const x1 = columnEdges[Math.min(m.col + m.colSpan, colCount)] ?? columnWidth;
+        const y0 = rowEdges[m.row] ?? 0;
+        const y1 = rowEdges[Math.min(m.row + m.rowSpan, rowCount)] ?? tableHeight;
+        const rect = createBoundingBox(x0, y0, x1 - x0, y1 - y0);
+        // Place lines inside the cell with padding; horizontal alignment is applied
+        // by the renderer via the cell rect + align flag.
+        const placed = shiftLines(m.lines, x0 + cellPaddingPx, y0 + cellPaddingPx);
+        return {
+            row: m.row,
+            col: m.col,
+            colSpan: m.colSpan,
+            rowSpan: m.rowSpan,
+            isHeader: m.isHeader,
+            align: m.align,
+            verticalAlign: m.verticalAlign,
+            rect,
+            lines: placed,
+        };
+    });
+    const layout = {
+        fontString: body.fontString,
+        boldFontString: body.boldFontString,
+        italicFontString: body.italicFontString,
+        boldItalicFontString: body.boldItalicFontString,
+        color: body.color,
+        headerFontString: header.fontString,
+        headerBoldFontString: header.boldFontString,
+        headerItalicFontString: header.italicFontString,
+        headerBoldItalicFontString: header.boldItalicFontString,
+        headerColor: header.color,
+        borderColor,
+        borderWidthPx,
+        headerBackground: style.headerBackground,
+        bodyBackground: style.bodyBackground,
+        cells,
+        columnEdges,
+        rowEdges,
+    };
+    return { layout, height: tableHeight };
+}
+/**
+ * Measure a resource block (image / svg / table) plus its caption into a
+ * placement-ready {@link ResolvedResourceBlock}. Returns the block and its
+ * combined height (figure body + gap + caption) — the value placement uses to
+ * decide whether the group fits the remaining column space.
+ */
+export function layoutResourceBlock(input) {
+    const { resource, resourceType, number, resolved, columnWidth, resourceNumbering, resourceTypes, resources, } = input;
+    const bodyStyle = resolveBodyStyle(resolved);
+    const dpi = resolved.page.dpi;
+    // Normal / bold weights reused for table + caption font sets.
+    const normalWeight = resolved.bodyText.fontWeight.toString();
+    const boldWeight = resolved.bodyText.boldFontWeight.toString();
+    // Line-height ratio of the body text — applied to any custom table/caption
+    // font size so a resized run keeps a proportional leading (and reproduces the
+    // previous heights exactly when the size is left at the body default).
+    const lineHeightRatio = bodyStyle.lineHeightPx / bodyStyle.fontSizePx;
+    // Inline `:ref` emphasis (bold/italic), applied to refs in captions + cells.
+    const refStyle = { bold: resolved.bodyText.referenceBold, italic: resolved.bodyText.referenceItalic };
+    // --- Figure body -------------------------------------------------------
+    let bodyWidth = columnWidth;
+    let bodyHeight = 0;
+    let table;
+    let fileId;
+    let format;
+    if (resource.kind === 'bitmap' && resource.bitmap) {
+        fileId = resource.bitmap.fileId;
+        format = resource.bitmap.format;
+        const fit = fitWidth(resource.bitmap.width, resource.bitmap.height, columnWidth);
+        bodyWidth = fit.width;
+        bodyHeight = fit.height;
+    }
+    else if (resource.kind === 'svg' && resource.svg) {
+        fileId = resource.svg.fileId;
+        // SVGs are vector: fill the column width and derive height from the
+        // intrinsic aspect ratio (viewBox / width:height). Fall back to a 4:3 box
+        // only when no intrinsic size was captured.
+        const iw = resource.svg.width ?? 0;
+        const ih = resource.svg.height ?? 0;
+        bodyWidth = columnWidth;
+        bodyHeight = iw > 0 && ih > 0 ? columnWidth * (ih / iw) : columnWidth * 0.75;
+    }
+    else if (resource.kind === 'table' && resource.table) {
+        const ts = resolved.tableStyle;
+        const bodyFontPx = dimensionToPx(ts.bodyFontSize, dpi);
+        const headerFontPx = dimensionToPx(ts.headerFontSize, dpi);
+        // Header weight/slant: the header's base run is bold (and/or italic) by
+        // default; inline markup still toggles relative to that base, mirroring the
+        // blockquote/heading italic-flip convention.
+        const hWeight = ts.headerBold ? boldWeight : normalWeight;
+        const hBase = ts.headerItalic ? 'italic' : 'normal';
+        const hFlip = ts.headerItalic ? 'normal' : 'italic';
+        const style = {
+            body: {
+                fontString: buildFontString(ts.bodyFontFamily, bodyFontPx, normalWeight),
+                boldFontString: buildFontString(ts.bodyFontFamily, bodyFontPx, boldWeight),
+                italicFontString: buildFontString(ts.bodyFontFamily, bodyFontPx, normalWeight, 'italic'),
+                boldItalicFontString: buildFontString(ts.bodyFontFamily, bodyFontPx, boldWeight, 'italic'),
+                color: ts.bodyColor.hex,
+                lineHeightPx: bodyFontPx * lineHeightRatio,
+            },
+            header: {
+                fontString: buildFontString(ts.headerFontFamily, headerFontPx, hWeight, hBase),
+                boldFontString: buildFontString(ts.headerFontFamily, headerFontPx, boldWeight, hBase),
+                italicFontString: buildFontString(ts.headerFontFamily, headerFontPx, hWeight, hFlip),
+                boldItalicFontString: buildFontString(ts.headerFontFamily, headerFontPx, boldWeight, hFlip),
+                color: ts.headerColor.hex,
+                lineHeightPx: headerFontPx * lineHeightRatio,
+            },
+            borderColor: ts.borderColor.hex,
+            borderWidthPx: ts.borders ? Math.max(1, Math.round(dimensionToPx(ts.borderWidth, dpi))) : 0,
+            cellPaddingPx: dimensionToPx(ts.cellPadding, dpi, bodyFontPx),
+            headerBackground: ts.headerBackgroundEnabled ? ts.headerBackground.hex : undefined,
+            bodyBackground: ts.bodyBackgroundEnabled ? ts.bodyBackground.hex : undefined,
+        };
+        const { layout, height } = layoutTable(resource.table.model, columnWidth, style, resourceNumbering, resourceTypes, resources, refStyle);
+        table = layout;
+        bodyWidth = columnWidth;
+        bodyHeight = height;
+    }
+    const bodyRect = createBoundingBox(0, 0, bodyWidth, bodyHeight);
+    // --- Caption -----------------------------------------------------------
+    const cs = resolved.captionStyle;
+    const captionFontPx = dimensionToPx(cs.fontSize, dpi);
+    const captionLineHeightPx = captionFontPx * lineHeightRatio;
+    const captionGapPx = dimensionToPx(cs.gap, dpi, captionFontPx);
+    // Caption font set (label + description share one typeface/size; weight and
+    // slant vary per span).
+    const captionFontString = buildFontString(cs.fontFamily, captionFontPx, normalWeight);
+    const captionBoldFontString = buildFontString(cs.fontFamily, captionFontPx, boldWeight);
+    const captionItalicFontString = buildFontString(cs.fontFamily, captionFontPx, normalWeight, 'italic');
+    const captionBoldItalicFontString = buildFontString(cs.fontFamily, captionFontPx, boldWeight, 'italic');
+    const captionPrefix = resourceType?.captionPrefix ?? '';
+    // Inline `:ref` labels render in the configured reference colour (defaults to
+    // the emphasis/bold colour).
+    const linkColor = resolved.bodyText.referenceColor.hex;
+    let captionLines = [];
+    const captionText = resource.caption ?? '';
+    const hasCaption = captionText.trim().length > 0 || captionPrefix.length > 0;
+    if (hasCaption) {
+        // Prefix span: "<captionPrefix> <number>. " (non-breaking inside the label).
+        const prefixText = captionPrefix.length > 0
+            ? `${captionPrefix}${NBSP}${number}.${number ? ' ' : ''}`
+            : '';
+        const resolvedSpans = resolveRefSpans(parseRefAwareSpans(captionText), resourceNumbering, resourceTypes, resources, refStyle);
+        // Description spans pick up the configured slant on top of their own markup.
+        const descSpans = cs.descriptionItalic
+            ? resolvedSpans.map((s) => ({ ...s, italic: s.italic || true }))
+            : resolvedSpans;
+        const allSpans = prefixText.length > 0
+            ? [{ text: prefixText, bold: cs.labelBold, italic: cs.labelItalic, captionLabel: true }, ...descSpans]
+            : descSpans;
+        const measured = measureRichBlock(allSpans, captionFontString, captionBoldFontString, captionItalicFontString, captionBoldItalicFontString, Math.max(1, columnWidth), captionLineHeightPx, { textAlign: cs.align });
+        captionLines = shiftLines(measured.lines, 0, bodyHeight + captionGapPx);
+    }
+    const captionHeight = captionLines.length > 0
+        ? captionLines.length * captionLineHeightPx + captionGapPx
+        : 0;
+    const totalHeight = bodyHeight + captionHeight;
+    const block = {
+        resource,
+        kind: resource.kind,
+        number,
+        captionPrefix,
+        bodyRect,
+        fileId,
+        format,
+        captionLines,
+        captionFontString,
+        captionBoldFontString,
+        captionItalicFontString,
+        captionBoldItalicFontString,
+        captionColor: cs.color.hex,
+        captionLabelColor: cs.labelColor.hex,
+        linkColor,
+        table,
+    };
+    return { block, totalHeight };
+}
+//# sourceMappingURL=resourceLayout.js.map

package/dist/pipeline/resourceLayout.js.map

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

package/dist/pipeline/resourceNumbering.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Resource numbering pipeline (issue #49 §3).
+ *
+ * Assigns a rendered number string (e.g. `"1.7"`) to every resource referenced
+ * in the document. Numbering follows **order of first reference** in reading
+ * order — a resource is numbered the first time it is encountered, whether via
+ * a `::resource{…}` block embed or an inline `:ref{…}`. Inserting a new
+ * reference earlier in the document therefore auto-renumbers the rest.
+ *
+ * The renderer is shared with heading numbering through
+ * {@link renderCounterTemplate}; only the template syntax differs. Resource
+ * templates use `{n}` for the per-type counter and `{h1}`..`{h6}` for the
+ * heading numbers in effect at the point of first reference.
+ */
+import type { ContentBlock } from '../parse';
+import type { Resource, ResourceType } from '../types';
+/** Heading counters (1-indexed by level) in effect at a given point in the
+ *  document. `h1`..`h6` carry the running heading number for each level. */
+export interface HeadingContext {
+    h1: number;
+    h2: number;
+    h3: number;
+    h4: number;
+    h5: number;
+    h6: number;
+}
+export interface ResourceNumberEntry {
+    /** The rendered number string (e.g. `"1.7"`). */
+    number: string;
+    /** The `ResourceType.id` this number was computed for. */
+    typeId: string;
+    /** The heading counters in effect at the point of first reference. */
+    heading: HeadingContext;
+}
+/** Maps each referenced `Resource.id` to its computed numbering entry. */
+export type ResourceNumberingMap = Record<string, ResourceNumberEntry>;
+/** Walk `blocks` and produce, for each block index, the heading counters in
+ *  effect at that block. A heading at index `i` is reflected in
+ *  `result[i]` (i.e. the heading counts itself). Mirrors the counter logic in
+ *  `computeHeadingNumbers` but exposes the raw per-level values rather than the
+ *  rendered prefix. */
+export declare function computeHeadingContext(blocks: ContentBlock[]): HeadingContext[];
+/**
+ * Compute the numbering map for every resource referenced in `blocks`.
+ *
+ * @param blocks          parsed content blocks in reading order
+ * @param resourceTypes   user-defined resource types (drives template + reset)
+ * @param resources       known resources (maps `resourceId → typeId`)
+ * @param headingContext  per-block heading counters (see
+ *                        {@link computeHeadingContext}); must align with
+ *                        `blocks` by index
+ */
+export declare function computeResourceNumbering(blocks: ContentBlock[], resourceTypes: ResourceType[], resources: Resource[], headingContext: HeadingContext[]): ResourceNumberingMap;
+//# sourceMappingURL=resourceNumbering.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resourceNumbering.d.ts","sourceRoot":"","sources":["../../src/pipeline/resourceNumbering.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAyB,MAAM,UAAU,CAAC;AAQ9E;4EAC4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,0EAA0E;AAC1E,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAsBvE;;;;uBAIuB;AACvB,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,cAAc,EAAE,CAoB9E;AAoGD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,YAAY,EAAE,EACtB,aAAa,EAAE,YAAY,EAAE,EAC7B,SAAS,EAAE,QAAQ,EAAE,EACrB,cAAc,EAAE,cAAc,EAAE,GAC/B,oBAAoB,CAwEtB"}