@stll/folio-core 0.14.1 → 0.15.1

package/dist/layout-painter/anchoredImagePosition.d.ts

@@ -1,5 +1,4 @@
 import { ImageRun } from "../layout-engine/types.js";
-
 //#region src/layout-painter/anchoredImagePosition.d.ts
 type PageGeometry = {
   pageWidth: number;

package/dist/layout-painter/borderStroke.d.ts

@@ -1,5 +1,4 @@
 import { BorderStyle, ParagraphBorders } from "../layout-engine/types.js";
-
 //#region src/layout-painter/borderStroke.d.ts
 type CssBorderStroke = {
   color: string;

package/dist/layout-painter/imageLayout.d.ts

@@ -2,7 +2,6 @@ import { FlowBlock, Measure } from "../layout-engine/types.js";
 import { BlockLookup } from "./index.js";
 import { WrapType } from "../docx/wrapTypes.js";
 import { ImageAttrs } from "../prosemirror/schema/nodes.js";
-
 //#region src/layout-painter/imageLayout.d.ts
 /**
  * Anchored wrap-type targets — the OOXML wrap types except `inline`.
@@ -18,9 +17,13 @@ type AnchorWrapType = Exclude<WrapType, "inline">;
  */
 type ImageLayoutTarget = AnchorWrapType | "squareLeft" | "squareRight" | "inline";
 declare const LAYOUT_IMAGE_CLASSES: {
-  /** Inline image rendered inside `.layout-line`. */readonly runImage: "layout-run-image"; /** Block (centered, topAndBottom) image. */
-  readonly blockImage: "layout-block-image"; /** Anchored image rendered in the page-level floating layer. */
-  readonly pageFloatingImage: "layout-page-floating-image"; /** Anchored image rendered inside a table cell's floating layer. */
+  /** Inline image rendered inside `.layout-line`. */
+  readonly runImage: "layout-run-image";
+  /** Block (centered, topAndBottom) image. */
+  readonly blockImage: "layout-block-image";
+  /** Anchored image rendered in the page-level floating layer. */
+  readonly pageFloatingImage: "layout-page-floating-image";
+  /** Anchored image rendered inside a table cell's floating layer. */
   readonly cellFloatingImage: "layout-cell-floating-image";
   readonly pageContent: "layout-page-content";
   readonly paragraph: "layout-paragraph";
@@ -67,9 +70,13 @@ declare function deriveLayoutChoice(wrapType: WrapType, cssFloat?: ImageAttrs["c
  */
 type ImageLayoutIconHint = "inline" | "squareLeft" | "squareRight" | "behind" | "inFront";
 type ImageLayoutOptionDef = {
-  /** Choice value — what gets dispatched on click. */choice: ImageLayoutTarget; /** i18n key under `imageWrap.menu.*`. */
-  i18nLabelKey: string; /** i18n key under `imageWrap.menuDesc.*`. */
-  i18nDescKey: string; /** Hint for the framework's icon registry. */
+  /** Choice value — what gets dispatched on click. */
+  choice: ImageLayoutTarget;
+  /** i18n key under `imageWrap.menu.*`. */
+  i18nLabelKey: string;
+  /** i18n key under `imageWrap.menuDesc.*`. */
+  i18nDescKey: string;
+  /** Hint for the framework's icon registry. */
   iconHint: ImageLayoutIconHint;
 };
 /** Mirrors Word's Wrap Text menu — five directional options. */

package/dist/layout-painter/index.d.ts

@@ -9,7 +9,6 @@ import { renderLine, renderParagraphFragment, sliceRunsForLine } from "./renderP
 import { TABLE_CLASS_NAMES, renderTableFragment } from "./renderTable.js";
 import { TEXTBOX_CLASS_NAMES, renderTextBoxFragment } from "./renderTextBox.js";
 import { createDefaultRegistry } from "./registry/modules.js";
-
 //#region src/layout-painter/index.d.ts
 /**
  * Block lookup entry for painter
@@ -27,10 +26,15 @@ type BlockLookup = Map<string, BlockLookupEntry>;
  * Painter options
  */
 type PainterOptions = {
-  /** Document to create elements in */document?: Document; /** Gap between pages in pixels */
-  pageGap?: number; /** Show page shadows */
-  showShadow?: boolean; /** Background color for pages */
-  pageBackground?: string; /** Container background color */
+  /** Document to create elements in */
+  document?: Document;
+  /** Gap between pages in pixels */
+  pageGap?: number;
+  /** Show page shadows */
+  showShadow?: boolean;
+  /** Background color for pages */
+  pageBackground?: string;
+  /** Container background color */
   containerBackground?: string;
   /**
    * Optional custom feature registry. Defaults to `createDefaultRegistry()`.

package/dist/layout-painter/registry/modules/image.d.ts

@@ -1,5 +1,4 @@
 import { FeatureModule } from "../types.js";
-
 //#region src/layout-painter/registry/modules/image.d.ts
 declare const imageModule: FeatureModule<"image">;
 //#endregion

package/dist/layout-painter/registry/modules/paragraph.d.ts

@@ -1,5 +1,4 @@
 import { FeatureModule } from "../types.js";
-
 //#region src/layout-painter/registry/modules/paragraph.d.ts
 declare const paragraphModule: FeatureModule<"paragraph">;
 //#endregion

package/dist/layout-painter/registry/modules/table.d.ts

@@ -1,5 +1,4 @@
 import { FeatureModule } from "../types.js";
-
 //#region src/layout-painter/registry/modules/table.d.ts
 declare const tableModule: FeatureModule<"table">;
 //#endregion

package/dist/layout-painter/registry/modules/textBox.d.ts

@@ -1,5 +1,4 @@
 import { FeatureModule } from "../types.js";
-
 //#region src/layout-painter/registry/modules/textBox.d.ts
 declare const textBoxModule: FeatureModule<"textBox">;
 //#endregion

package/dist/layout-painter/registry/modules.d.ts

@@ -1,5 +1,4 @@
 import { FeatureRegistry } from "./registry.js";
-
 //#region src/layout-painter/registry/modules.d.ts
 declare function createDefaultRegistry(): FeatureRegistry;
 //#endregion

package/dist/layout-painter/registry/registry.d.ts

@@ -1,6 +1,5 @@
 import { Fragment } from "../../layout-engine/types.js";
 import { FeatureDispatchInput, FeatureFallback, FeatureModule } from "./types.js";
-
 //#region src/layout-painter/registry/registry.d.ts
 type FeatureRegistry = {
   register: <TKind extends Fragment["kind"]>(mod: FeatureModule<TKind>) => void;

package/dist/layout-painter/registry/types.d.ts

@@ -1,6 +1,5 @@
 import { FlowBlock, Fragment, ImageBlock, ImageMeasure, Measure, ParagraphBlock, ParagraphMeasure, TableBlock, TableMeasure, TextBoxBlock, TextBoxMeasure } from "../../layout-engine/types.js";
 import { RenderContext } from "../renderUtils.js";
-
 //#region src/layout-painter/registry/types.d.ts
 /**
  * Resolve the concrete Fragment subtype for a given kind discriminator.

package/dist/layout-painter/renderFragment.d.ts

@@ -1,6 +1,5 @@
 import { Fragment } from "../layout-engine/types.js";
 import { RenderContext } from "./renderUtils.js";
-
 //#region src/layout-painter/renderFragment.d.ts
 /**
  * CSS class names for fragment elements
@@ -17,7 +16,8 @@ declare const FRAGMENT_CLASS_NAMES: {
  * Options for rendering fragments
  */
 type RenderFragmentOptions = {
-  /** Document to create elements in */document?: Document;
+  /** Document to create elements in */
+  document?: Document;
 };
 /**
  * Render a fragment to DOM

package/dist/layout-painter/renderImage.d.ts

@@ -1,6 +1,5 @@
 import { ImageBlock, ImageFragment, ImageMeasure } from "../layout-engine/types.js";
 import { RenderContext } from "./renderUtils.js";
-
 //#region src/layout-painter/renderImage.d.ts
 /**
  * CSS class names for image elements

package/dist/layout-painter/renderPage.d.ts

@@ -3,7 +3,6 @@ import { FootnoteContent, HeaderFooterContent, ImageRun, Page, isFloatingImageRu
 import { RenderContext, emuToPixels } from "./renderUtils.js";
 import { AnchoredImagePosition, PageGeometry } from "./anchoredImagePosition.js";
 import { BlockLookup } from "./index.js";
-
 //#region src/layout-painter/renderPage.d.ts
 /**
  * Page-level floating image that has been extracted from paragraphs.
@@ -19,17 +18,25 @@ type PageFloatingImage = {
    * Opacity in [0, 1] from `<a:alphaModFix amt>`. Undefined / 1 means fully
    * opaque. eigenpal #424 (opacity render pipeline).
    */
-  opacity?: number; /** Which side: 'left' for left margin, 'right' for right margin */
-  side: "left" | "right"; /** X position relative to content area (0 = left edge of content) */
-  x: number; /** Y position relative to content area (0 = top of content) */
-  y: number; /** Wrap distances */
+  opacity?: number;
+  /** Which side: 'left' for left margin, 'right' for right margin */
+  side: "left" | "right";
+  /** X position relative to content area (0 = left edge of content) */
+  x: number;
+  /** Y position relative to content area (0 = top of content) */
+  y: number;
+  /** Wrap distances */
   distTop: number;
   distBottom: number;
   distLeft: number;
-  distRight: number; /** ProseMirror start position for click-to-select */
-  pmStart?: number; /** ProseMirror end position */
-  pmEnd?: number; /** OOXML wrapText: which side(s) TEXT flows on */
-  wrapText?: "bothSides" | "left" | "right" | "largest"; /** Wrap type (square, tight, through, topAndBottom, behind, inFront) */
+  distRight: number;
+  /** ProseMirror start position for click-to-select */
+  pmStart?: number;
+  /** ProseMirror end position */
+  pmEnd?: number;
+  /** OOXML wrapText: which side(s) TEXT flows on */
+  wrapText?: "bothSides" | "left" | "right" | "largest";
+  /** Wrap type (square, tight, through, topAndBottom, behind, inFront) */
   wrapType?: string;
   /**
    * Whether this image creates a text-wrap exclusion zone (line widths shrink
@@ -50,13 +57,7 @@ type FloatingTableBandOptions = {
   distLeft: number;
   distRight: number;
 };
-declare const floatingTableReservesBand: ({
-  contentX,
-  tableWidth,
-  contentWidth,
-  distLeft,
-  distRight
-}: FloatingTableBandOptions) => boolean;
+declare const floatingTableReservesBand: ({ contentX, tableWidth, contentWidth, distLeft, distRight }: FloatingTableBandOptions) => boolean;
 /**
  * CSS class names for page elements
  */
@@ -71,36 +72,62 @@ declare const getDefaultPageFontFamily: () => string;
  * A single footnote item ready for rendering at page bottom.
  */
 type FootnoteRenderItem = {
-  /** Stable story id used by editable-note surfaces. */noteId?: number; /** Display number (e.g. "1", "2") */
-  displayNumber: string; /** Plain text content */
-  text?: string; /** Pre-measured structured footnote content. */
+  /** Stable story id used by editable-note surfaces. */
+  noteId?: number;
+  /** Display number (e.g. "1", "2") */
+  displayNumber: string;
+  /** Plain text content */
+  text?: string;
+  /** Pre-measured structured footnote content. */
   content?: Pick<FootnoteContent, "blocks" | "measures" | "height">;
 };
 /**
  * Options for rendering a page
  */
 type RenderPageOptions = {
-  /** Document to create elements in (default: window.document) */document?: Document; /** Bookmark name -> 1-indexed page, for resolving PAGEREF fields at paint. */
-  bookmarkPages?: ReadonlyMap<string, number>; /** Bookmark name -> paragraph text, for resolving REF fields at paint. */
-  bookmarkText?: ReadonlyMap<string, string>; /** Field run `pmStart` -> precomputed SEQ value, for resolving SEQ fields. */
-  seqValues?: ReadonlyMap<number, number>; /** Section index -> page count in that section, for SECTIONPAGES fields. */
-  sectionPageCounts?: ReadonlyMap<number, number>; /** Custom page class name */
-  pageClassName?: string; /** Show page borders (for debugging) */
-  showBorders?: boolean; /** Background color for pages */
-  backgroundColor?: string; /** Drop shadow on pages */
-  showShadow?: boolean; /** Show the effective body-content boundary for each page. */
-  showMarginGuides?: boolean; /** CSS color used for margin guides. */
-  marginGuideColor?: string; /** Header content to render (used for all pages, or pages 2+ when titlePg is set). */
-  headerContent?: HeaderFooterContent; /** Footer content to render (used for all pages, or pages 2+ when titlePg is set). */
-  footerContent?: HeaderFooterContent; /** Header content by part relationship id, used for section-scoped rendering. */
-  headerContentByRId?: ReadonlyMap<string, HeaderFooterContent>; /** Footer content by part relationship id, used for section-scoped rendering. */
-  footerContentByRId?: ReadonlyMap<string, HeaderFooterContent>; /** Header content for the first page only (when titlePg is set). */
-  firstPageHeaderContent?: HeaderFooterContent; /** Footer content for the first page only (when titlePg is set). */
-  firstPageFooterContent?: HeaderFooterContent; /** Whether different first page headers/footers are enabled (w:titlePg). */
-  titlePg?: boolean; /** Distance from page top to header content. */
-  headerDistance?: number; /** Distance from page bottom to footer content. */
-  footerDistance?: number; /** Block lookup for rendering actual content. */
-  blockLookup?: BlockLookup; /** OOXML page borders from section properties. */
+  /** Document to create elements in (default: window.document) */
+  document?: Document;
+  /** Bookmark name -> 1-indexed page, for resolving PAGEREF fields at paint. */
+  bookmarkPages?: ReadonlyMap<string, number>;
+  /** Bookmark name -> paragraph text, for resolving REF fields at paint. */
+  bookmarkText?: ReadonlyMap<string, string>;
+  /** Field run `pmStart` -> precomputed SEQ value, for resolving SEQ fields. */
+  seqValues?: ReadonlyMap<number, number>;
+  /** Section index -> page count in that section, for SECTIONPAGES fields. */
+  sectionPageCounts?: ReadonlyMap<number, number>;
+  /** Custom page class name */
+  pageClassName?: string;
+  /** Show page borders (for debugging) */
+  showBorders?: boolean;
+  /** Background color for pages */
+  backgroundColor?: string;
+  /** Drop shadow on pages */
+  showShadow?: boolean;
+  /** Show the effective body-content boundary for each page. */
+  showMarginGuides?: boolean;
+  /** CSS color used for margin guides. */
+  marginGuideColor?: string;
+  /** Header content to render (used for all pages, or pages 2+ when titlePg is set). */
+  headerContent?: HeaderFooterContent;
+  /** Footer content to render (used for all pages, or pages 2+ when titlePg is set). */
+  footerContent?: HeaderFooterContent;
+  /** Header content by part relationship id, used for section-scoped rendering. */
+  headerContentByRId?: ReadonlyMap<string, HeaderFooterContent>;
+  /** Footer content by part relationship id, used for section-scoped rendering. */
+  footerContentByRId?: ReadonlyMap<string, HeaderFooterContent>;
+  /** Header content for the first page only (when titlePg is set). */
+  firstPageHeaderContent?: HeaderFooterContent;
+  /** Footer content for the first page only (when titlePg is set). */
+  firstPageFooterContent?: HeaderFooterContent;
+  /** Whether different first page headers/footers are enabled (w:titlePg). */
+  titlePg?: boolean;
+  /** Distance from page top to header content. */
+  headerDistance?: number;
+  /** Distance from page bottom to footer content. */
+  footerDistance?: number;
+  /** Block lookup for rendering actual content. */
+  blockLookup?: BlockLookup;
+  /** OOXML page borders from section properties. */
   pageBorders?: {
     top?: document_d_exports.BorderSpec;
     bottom?: document_d_exports.BorderSpec;
@@ -109,8 +136,10 @@ type RenderPageOptions = {
     display?: "allPages" | "firstPage" | "notFirstPage";
     offsetFrom?: "page" | "text";
     zOrder?: "front" | "back";
-  }; /** Theme for resolving border colors. */
-  theme?: document_d_exports.Theme | null; /** Footnotes to render at the bottom of this page. */
+  };
+  /** Theme for resolving border colors. */
+  theme?: document_d_exports.Theme | null;
+  /** Footnotes to render at the bottom of this page. */
   footnoteArea?: FootnoteRenderItem[];
   /**
    * Document watermark to paint behind page content. Applies to every

package/dist/layout-painter/renderParagraph.d.ts

@@ -1,6 +1,5 @@
 import { MeasuredLine, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphMeasure, Run, TabStop } from "../layout-engine/types.js";
 import { RenderContext } from "./renderUtils.js";
-
 //#region src/layout-painter/renderParagraph.d.ts
 /**
  * CSS class names for paragraph rendering
@@ -18,10 +17,15 @@ declare const PARAGRAPH_CLASS_NAMES: {
  * Options for rendering a paragraph
  */
 type RenderParagraphOptions = {
-  /** Document to create elements in */document?: Document; /** Fragment's Y position relative to content area (for per-line margin calculation) */
-  fragmentContentY?: number; /** Borders from the previous adjacent paragraph (for border grouping) */
-  prevBorders?: ParagraphBorders; /** Borders from the next adjacent paragraph (for border grouping) */
-  nextBorders?: ParagraphBorders; /** Inline image runs already rendered for this paragraph block */
+  /** Document to create elements in */
+  document?: Document;
+  /** Fragment's Y position relative to content area (for per-line margin calculation) */
+  fragmentContentY?: number;
+  /** Borders from the previous adjacent paragraph (for border grouping) */
+  prevBorders?: ParagraphBorders;
+  /** Borders from the next adjacent paragraph (for border grouping) */
+  nextBorders?: ParagraphBorders;
+  /** Inline image runs already rendered for this paragraph block */
   renderedInlineImageKeys?: Set<string>;
 };
 /**
@@ -46,18 +50,28 @@ declare function splitTextRunsByEastAsia(runs: Run[]): Run[];
  * Options for rendering a line with justify support
  */
 type RenderLineOptions = {
-  /** Available width for the line (content area width minus indentation) */availableWidth: number; /** Whether this is the last line of the paragraph */
-  isLastLine: boolean; /** Whether this is the first line of the paragraph */
-  isFirstLine: boolean; /** Whether the paragraph ends with a line break */
-  paragraphEndsWithLineBreak: boolean; /** Tab stops from paragraph attributes */
-  tabStops?: TabStop[]; /** Render context for field substitution */
-  context?: RenderContext; /** Left indent in pixels */
-  leftIndentPx?: number; /** First line indent in pixels (positive) or hanging indent (negative) */
-  firstLineIndentPx?: number; /** Line-specific floating image margins (calculated per-line based on Y overlap) */
+  /** Available width for the line (content area width minus indentation) */
+  availableWidth: number;
+  /** Whether this is the last line of the paragraph */
+  isLastLine: boolean;
+  /** Whether this is the first line of the paragraph */
+  isFirstLine: boolean;
+  /** Whether the paragraph ends with a line break */
+  paragraphEndsWithLineBreak: boolean;
+  /** Tab stops from paragraph attributes */
+  tabStops?: TabStop[];
+  /** Render context for field substitution */
+  context?: RenderContext;
+  /** Left indent in pixels */
+  leftIndentPx?: number;
+  /** First line indent in pixels (positive) or hanging indent (negative) */
+  firstLineIndentPx?: number;
+  /** Line-specific floating image margins (calculated per-line based on Y overlap) */
   floatingMargins?: {
     leftMargin: number;
     rightMargin: number;
-  }; /** Track inline image runs already rendered in this paragraph fragment to prevent duplicates */
+  };
+  /** Track inline image runs already rendered in this paragraph fragment to prevent duplicates */
   renderedInlineImageKeys?: Set<string>;
   /**
    * Rightmost x where inline content may render, in content-area coords. Used

package/dist/layout-painter/renderParagraph.js

@@ -1054,7 +1054,8 @@ function renderLine(block, line, alignment, doc, options) {
 	lineEl.style.whiteSpace = "pre";
 	lineEl.style.overflow = "visible";
 	let tabContext;
-	const measureText = createTextMeasurer(doc);
+	const hasScaledTextRun = runsForLine.some((run) => (isTextRun(run) || isFieldRun(run) || isMathRun(run)) && run.horizontalScale !== void 0 && run.horizontalScale !== 100);
+	const measureText = hasTabRuns || hasScaledTextRun ? createTextMeasurer(doc) : void 0;
 	if (hasTabRuns) {
 		const explicitStops = options?.tabStops?.map(convertTabStopToCalc);
 		const leftIndentTwips = options?.leftIndentPx ? Math.round(options.leftIndentPx * 15) : 0;
@@ -1073,7 +1074,7 @@ function renderLine(block, line, alignment, doc, options) {
 	} else currentX = leftIndentPx;
 	for (let i = 0; i < runsForLine.length; i++) {
 		const run = runsForLine[i];
-		if (isTabRun(run) && tabContext) {
+		if (isTabRun(run) && tabContext && measureText) {
 			const followingWidth = measureFollowingContentWidth(runsForLine, i, measureText, options?.context);
 			const decimalIndex = getTextAfterTab(runsForLine, i, options?.context).indexOf(".");
 			const decimalPrefixWidth = decimalIndex !== -1 ? measureDecimalPrefixWidth(runsForLine, i, decimalIndex, measureText, options?.context) : 0;
@@ -1131,6 +1132,7 @@ function renderLine(block, line, alignment, doc, options) {
 			const runEl = renderLineTextRun(run);
 			lineEl.append(runEl);
 			if (isCollapsedLineEdgeSpaceRun(run)) continue;
+			if (!measureText) continue;
 			const fontSize = run.fontSize || 11;
 			const fontFamily = run.fontFamily || "Calibri";
 			const measuredWidth = measureText(run.allCaps ? run.text.toLocaleUpperCase() : run.text, fontSize, fontFamily, {
@@ -1155,6 +1157,7 @@ function renderLine(block, line, alignment, doc, options) {
 		} else if (isFieldRun(run) && options?.context) {
 			const runEl = renderFieldRun(run, doc, options.context);
 			lineEl.append(runEl);
+			if (!measureText) continue;
 			const fieldText = resolveFieldText(run, options.context);
 			const fontSize = run.fontSize || 11;
 			const fontFamily = run.fontFamily || "Calibri";
@@ -1164,6 +1167,7 @@ function renderLine(block, line, alignment, doc, options) {
 		} else if (isMathRun(run)) {
 			const runEl = renderMathRun(run, doc);
 			lineEl.append(runEl);
+			if (!measureText) continue;
 			const measuredWidth = measureText(run.plainText, run.fontSize ?? 11, run.fontFamily ?? "Cambria Math", runMeasureStyle(run));
 			reserveScaledAdvance(runEl, measuredWidth, run.horizontalScale);
 			currentX += measuredWidth * ((run.horizontalScale ?? 100) / 100);

package/dist/layout-painter/renderTable.d.ts

@@ -1,7 +1,6 @@
 import { TableBlock, TableFragment, TableMeasure } from "../layout-engine/types.js";
 import { RenderContext } from "./renderUtils.js";
 import { PageGeometry } from "./anchoredImagePosition.js";
-
 //#region src/layout-painter/renderTable.d.ts
 /**
  * CSS class names for table elements

package/dist/layout-painter/renderTextBox.d.ts

@@ -1,6 +1,5 @@
 import { TableBlock, TableMeasure, TextBoxBlock, TextBoxFragment, TextBoxMeasure } from "../layout-engine/types.js";
 import { RenderContext } from "./renderUtils.js";
-
 //#region src/layout-painter/renderTextBox.d.ts
 /**
  * CSS class names for text box elements

package/dist/layout-painter/renderUtils.d.ts

@@ -1,5 +1,4 @@
 import { ImageRun, isFloatingImageRun, isTextWrappingFloatingImageRun } from "../layout-engine/types.js";
-
 //#region src/layout-painter/renderUtils.d.ts
 /**
  * Horizontal alignment for an image alone on a line. An anchored image
@@ -15,14 +14,23 @@ declare function resolveImageLineAlign(imageRun: ImageRun, paragraphAlignment: "
  * Context passed to fragment renderers
  */
 type RenderContext = {
-  /** Current page number (1-indexed) */pageNumber: number; /** Total number of pages */
-  totalPages: number; /** Which section is being rendered */
-  section: "body" | "header" | "footer"; /** Bookmark name -> 1-indexed page, for resolving PAGEREF fields. */
-  bookmarkPages?: ReadonlyMap<string, number>; /** Bookmark name -> paragraph text, for resolving REF fields. */
-  bookmarkText?: ReadonlyMap<string, string>; /** Field run `pmStart` -> precomputed SEQ value, for resolving SEQ fields. */
-  seqValues?: ReadonlyMap<number, number>; /** Pages in this page's section, for resolving SECTIONPAGES fields. */
-  sectionPages?: number; /** Content width in pixels (page width minus margins) - used for justify */
-  contentWidth?: number; /** When true, floating images render in-flow instead of being skipped (for table cells) */
+  /** Current page number (1-indexed) */
+  pageNumber: number;
+  /** Total number of pages */
+  totalPages: number;
+  /** Which section is being rendered */
+  section: "body" | "header" | "footer";
+  /** Bookmark name -> 1-indexed page, for resolving PAGEREF fields. */
+  bookmarkPages?: ReadonlyMap<string, number>;
+  /** Bookmark name -> paragraph text, for resolving REF fields. */
+  bookmarkText?: ReadonlyMap<string, string>;
+  /** Field run `pmStart` -> precomputed SEQ value, for resolving SEQ fields. */
+  seqValues?: ReadonlyMap<number, number>;
+  /** Pages in this page's section, for resolving SECTIONPAGES fields. */
+  sectionPages?: number;
+  /** Content width in pixels (page width minus margins) - used for justify */
+  contentWidth?: number;
+  /** When true, floating images render in-flow instead of being skipped (for table cells) */
   insideTableCell?: boolean;
   /**
    * How the renderer should position its outer element. The body lays

package/dist/layout-painter/renderWatermark.d.ts

@@ -1,9 +1,9 @@
 import { document_d_exports } from "../types/document.js";
 import { Page } from "../layout-engine/types.js";
-
 //#region src/layout-painter/renderWatermark.d.ts
 type RenderWatermarkOptions = {
-  /** Resolved image src for picture watermarks (`data:` / `blob:` only). */imageSrc?: string;
+  /** Resolved image src for picture watermarks (`data:` / `blob:` only). */
+  imageSrc?: string;
 };
 /**
  * Build the watermark overlay element for a page. Returns `null` when

package/dist/layout-painter/sdtBoundary.d.ts

@@ -1,6 +1,5 @@
 import { SdtGroup } from "../layout-engine/types.js";
 import { Node } from "prosemirror-model";
-
 //#region src/layout-painter/sdtBoundary.d.ts
 declare function applySdtDataAttrs(el: HTMLElement, sdtGroups: readonly SdtGroup[] | undefined): void;
 /**

package/dist/managers/AutoSaveManager.d.ts

@@ -1,25 +1,36 @@
 import { document_d_exports } from "../types/document.js";
 import { Subscribable } from "./Subscribable.js";
-
 //#region src/managers/AutoSaveManager.d.ts
 /** Auto-save status. */
 type AutoSaveStatus = "idle" | "saving" | "saved" | "error";
 /** Configuration for {@link AutoSaveManager}. */
 type AutoSaveManagerOptions = {
-  /** Storage key for localStorage (default: 'docx-editor-autosave'). */storageKey?: string; /** Save interval in milliseconds (default: 30000 - 30 seconds). */
-  interval?: number; /** Maximum age of auto-save before it is considered stale (default: 24 hours). */
-  maxAge?: number; /** Whether to save on document change with debounce (default: true). */
-  saveOnChange?: boolean; /** Debounce delay for saveOnChange in milliseconds (default: 2000). */
-  debounceDelay?: number; /** Callback when save succeeds. */
-  onSave?: (timestamp: Date) => void; /** Callback when save fails. */
-  onError?: (error: Error) => void; /** Callback when recovery data is found. */
+  /** Storage key for localStorage (default: 'docx-editor-autosave'). */
+  storageKey?: string;
+  /** Save interval in milliseconds (default: 30000 - 30 seconds). */
+  interval?: number;
+  /** Maximum age of auto-save before it is considered stale (default: 24 hours). */
+  maxAge?: number;
+  /** Whether to save on document change with debounce (default: true). */
+  saveOnChange?: boolean;
+  /** Debounce delay for saveOnChange in milliseconds (default: 2000). */
+  debounceDelay?: number;
+  /** Callback when save succeeds. */
+  onSave?: (timestamp: Date) => void;
+  /** Callback when save fails. */
+  onError?: (error: Error) => void;
+  /** Callback when recovery data is found. */
   onRecoveryAvailable?: (savedDocument: SavedDocumentData) => void;
 };
 /** Saved document data structure. */
 type SavedDocumentData = {
-  /** The document. */document: document_d_exports.Document; /** When the document was saved (ISO string). */
-  savedAt: string; /** Version for format compatibility. */
-  version: number; /** Optional document identifier. */
+  /** The document. */
+  document: document_d_exports.Document;
+  /** When the document was saved (ISO string). */
+  savedAt: string;
+  /** Version for format compatibility. */
+  version: number;
+  /** Optional document identifier. */
   documentId?: string;
 };
 /** AutoSaveManager snapshot for UI consumption. */

package/dist/managers/ClipboardManager.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../types/document.js";
-
 //#region src/managers/ClipboardManager.d.ts
 /** Selection data for clipboard operations. */
 type ClipboardSelection = {

package/dist/managers/ContextMenuManager.d.ts

@@ -1,26 +1,23 @@
 import { Subscribable } from "./Subscribable.js";
 import { ContextMenuAnchor, ContextMenuSnapshot } from "./types.js";
 import { EditorState } from "prosemirror-state";
-
 //#region src/managers/ContextMenuManager.d.ts
 type OpenContextMenuOptions = {
-  /** Live editor state, or null when the editor view is not mounted. */state: EditorState | null;
+  /** Live editor state, or null when the editor view is not mounted. */
+  state: EditorState | null;
   /**
    * For the PagedEditor child callback path, which already knows from a
    * layout-overlay selection whether the user highlighted text. When omitted,
    * `hasSelection` is derived from the ProseMirror selection.
    */
-  hasSelectionOverride?: boolean | undefined; /** Whether the cursor sits inside a tracked change (detected by the adapter). */
+  hasSelectionOverride?: boolean | undefined;
+  /** Whether the cursor sits inside a tracked change (detected by the adapter). */
   cursorInTrackedChange: boolean;
 };
 declare class ContextMenuManager extends Subscribable<ContextMenuSnapshot> {
   constructor();
   /** Open the menu at `anchor`, deriving menu flags from the editor state. */
-  openMenu(anchor: ContextMenuAnchor, {
-    state,
-    hasSelectionOverride,
-    cursorInTrackedChange
-  }: OpenContextMenuOptions): void;
+  openMenu(anchor: ContextMenuAnchor, { state, hasSelectionOverride, cursorInTrackedChange }: OpenContextMenuOptions): void;
   /** Close the menu. */
   closeMenu(): void;
 }