@stll/folio-core 0.61.0 → 0.63.0

package/dist/layout-engine/types.d.ts

@@ -1,5 +1,8 @@
 import { OutlineStyleAttr } from "../types/documentEnumValues.js";
+import { DocumentFontFacts } from "../fonts/documentFontFacts.js";
+import { NoteStoryKey } from "../types/editor-story.js";
 import { CssBorderStyle } from "../utils/borderCss.js";
+import { AutomaticTextSpacingPolicy } from "./measure/measureTypes.js";
 import { ImagePosition, ImageWrap, InlineWrapper, NumberFormat, OutlineLevel, ParagraphNumberingOverride, PreviewDescriptor, SdtProperties, SdtType, SectionStart, ShapeTextBody, TableCellFormatting, TableWidthType, UnderlineStyle, VerticalAlign } from "@stll/docx-core/model";
 declare namespace types_d_exports {
   export { BlockId, BorderStyle, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, MathRun, Measure, MeasuredLine, NOTE_SEPARATOR_RULE_THICKNESS, NOTE_SEPARATOR_WIDTH_FRACTION, NoteAreaLayout, NoteSeparatorKind, NoteSeparatorRule, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxGradientFill, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isListNumPr, isTextWrappingFloatingImageRun, resolveTableCellPadding, resolveTableWidthPx, stripFlowBlockPmAnchors, tableColumnsArePinned };
@@ -8,13 +11,16 @@ declare namespace types_d_exports {
  * Unique identifier for a block in the document.
  * Format: typically `${index}-${type}` or just the block index.
  */
-type BlockId = string | number;
+export type BlockId = string | number;
 /**
  * Common run formatting properties applied to text runs.
  */
-type RunFormatting = {
+export type RunFormatting = {
+  automaticTextSpacing?: AutomaticTextSpacingPolicy;
   /** Embedded families owned by this editor, never ambient process state. */
   embeddedFontFamilyMap?: ReadonlyMap<string, string>;
+  /** Authored font-table facts owned by this document. */
+  documentFontFacts?: DocumentFontFacts;
   bold?: boolean;
   italic?: boolean;
   /**
@@ -39,6 +45,10 @@ type RunFormatting = {
   fontFamily?: string;
   /** OOXML `w:altName` fallback for `fontFamily`, used only when the primary face is absent. */
   alternateFontFamily?: string;
+  /** Resolved `w:hAnsi` face for non-ASCII western text and unhinted punctuation. */
+  hAnsiFontFamily?: string;
+  /** OOXML `w:altName` fallback for `hAnsiFontFamily`. */
+  hAnsiAlternateFontFamily?: string;
   /**
    * Resolved East-Asian font (`w:eastAsia` / `eastAsiaTheme`). CJK code points
    * in this run measure and paint with this font; non-CJK keeps `fontFamily`
@@ -162,11 +172,11 @@ type RunFormatting = {
   /** Groups a suggestion's runs for accept/reject and scroll-to. */
   suggestionId?: string;
 };
-type ListMarkerFormatting = Pick<RunFormatting, "embeddedFontFamilyMap" | "fontFamily" | "alternateFontFamily" | "eastAsiaFontFamily" | "eastAsiaAlternateFontFamily" | "complexScriptFontFamily" | "complexScriptAlternateFontFamily" | "fontSize" | "complexScriptFontSize" | "bold" | "complexScriptBold" | "italic" | "complexScriptItalic" | "rtl" | "forceComplexScript" | "color">;
+export type ListMarkerFormatting = Pick<RunFormatting, "embeddedFontFamilyMap" | "documentFontFacts" | "fontFamily" | "alternateFontFamily" | "hAnsiFontFamily" | "hAnsiAlternateFontFamily" | "eastAsiaFontFamily" | "eastAsiaAlternateFontFamily" | "complexScriptFontFamily" | "complexScriptAlternateFontFamily" | "fontSize" | "complexScriptFontSize" | "bold" | "complexScriptBold" | "italic" | "complexScriptItalic" | "rtl" | "forceComplexScript" | "color">;
 /**
  * Hyperlink information for a run.
  */
-type HyperlinkInfo = {
+export type HyperlinkInfo = {
   href: string;
   tooltip?: string;
   /**
@@ -181,7 +191,7 @@ type HyperlinkInfo = {
 /**
  * A text run within a paragraph.
  */
-type TextRun = RunFormatting & {
+export type TextRun = RunFormatting & {
   kind: "text";
   text: string;
   /** Hyperlink information if this run is a link. */
@@ -203,7 +213,7 @@ type TextRun = RunFormatting & {
 /**
  * A tab character run.
  */
-type TabRun = RunFormatting & {
+export type TabRun = RunFormatting & {
   kind: "tab";
   width?: number;
   pmStart?: number;
@@ -212,7 +222,7 @@ type TabRun = RunFormatting & {
 /**
  * Position data for floating/anchored images.
  */
-type ImageRunPosition = {
+export type ImageRunPosition = {
   horizontal?: {
     relativeTo?: NonNullable<ImagePosition["horizontal"]["relativeTo"]>;
     posOffset?: number;
@@ -227,7 +237,7 @@ type ImageRunPosition = {
 /**
  * An inline image run.
  */
-type ImageRun = {
+export type ImageRun = {
   kind: "image";
   src: string;
   /** Set instead of `src` for a drawing with no image data; see {@link ImageBlock.preview}. */
@@ -294,13 +304,13 @@ type ImageRun = {
 /**
  * A line break run.
  */
-type LineBreakRun = {
+export type LineBreakRun = {
   kind: "lineBreak";
   pmStart?: number;
   pmEnd?: number;
 };
 /** Zero-width cached page boundary inside a paragraph. */
-type RenderedPageBreakRun = RunFormatting & {
+export type RenderedPageBreakRun = RunFormatting & {
   kind: "renderedPageBreak";
   pmStart?: number;
   pmEnd?: number;
@@ -308,7 +318,7 @@ type RenderedPageBreakRun = RunFormatting & {
 /**
  * A field run (PAGE, NUMPAGES, etc.) that gets substituted at render time.
  */
-type FieldRun = RunFormatting & {
+export type FieldRun = RunFormatting & {
   kind: "field";
   /** Coarse render category, kept for cache keys and caret-width fast paths. */
   fieldType: "PAGE" | "NUMPAGES" | "DATE" | "TIME" | "OTHER";
@@ -331,7 +341,7 @@ type FieldRun = RunFormatting & {
  * markup changes; it is never modified on save (round-trip happens via
  * the document model, not the layout layer).
  */
-type MathRun = RunFormatting & {
+export type MathRun = RunFormatting & {
   kind: "math";
   /** `inline` = `<m:oMath>`, `block` = `<m:oMathPara>`. */
   display: "inline" | "block";
@@ -345,11 +355,11 @@ type MathRun = RunFormatting & {
 /**
  * Union of all run types.
  */
-type Run = TextRun | TabRun | ImageRun | LineBreakRun | RenderedPageBreakRun | FieldRun | MathRun;
+export type Run = TextRun | TabRun | ImageRun | LineBreakRun | RenderedPageBreakRun | FieldRun | MathRun;
 /**
  * Paragraph spacing configuration.
  */
-type ParagraphSpacing = {
+export type ParagraphSpacing = {
   before?: number;
   after?: number;
   line?: number;
@@ -359,7 +369,7 @@ type ParagraphSpacing = {
 /**
  * Paragraph indentation configuration.
  */
-type ParagraphIndent = {
+export type ParagraphIndent = {
   left?: number;
   right?: number;
   firstLine?: number;
@@ -368,11 +378,11 @@ type ParagraphIndent = {
 /**
  * Tab stop alignment types
  */
-type TabAlignment = "start" | "end" | "center" | "decimal" | "bar" | "clear";
+export type TabAlignment = "start" | "end" | "center" | "decimal" | "bar" | "clear";
 /**
  * Tab stop definition
  */
-type TabStop = {
+export type TabStop = {
   /** Tab alignment mode */
   val: TabAlignment;
   /** Position in twips from left margin */
@@ -383,7 +393,7 @@ type TabStop = {
 /**
  * Border specification for paragraphs.
  */
-type BorderStyle = {
+export type BorderStyle = {
   style?: CssBorderStyle;
   width?: number;
   color?: string;
@@ -392,7 +402,7 @@ type BorderStyle = {
 /**
  * Paragraph borders.
  */
-type ParagraphBorders = {
+export type ParagraphBorders = {
   top?: BorderStyle;
   bottom?: BorderStyle;
   left?: BorderStyle;
@@ -413,12 +423,13 @@ type ParagraphBorders = {
  * used to hold byte-identical copies under different names, and an equality
  * that drifts is how a list silently renumbers.
  */
-declare const isListNumPr: (value: ParagraphNumberingOverride | null | undefined) => value is ParagraphNumberingOverride;
+export declare const isListNumPr: (value: ParagraphNumberingOverride | null | undefined) => value is ParagraphNumberingOverride;
 /**
  * Paragraph block attributes.
  */
-type ParagraphAttrs = {
+export type ParagraphAttrs = {
   embeddedFontFamilyMap?: ReadonlyMap<string, string>;
+  documentFontFacts?: DocumentFontFacts;
   alignment?: "left" | "center" | "right" | "justify";
   /** Document-generation policy for justified line fitting. */
   justificationCompatibility?: {
@@ -426,8 +437,11 @@ type ParagraphAttrs = {
   };
   /** East Asian first/last-character restrictions (`w:kinsoku`). */
   kinsoku?: boolean;
+  autoSpaceDE?: boolean;
+  autoSpaceDN?: boolean;
   /** Hanging punctuation (`w:overflowPunct`); defaults to enabled when omitted. */
   overflowPunctuation?: boolean;
+  defaultEastAsiaFontFamily?: string;
   /** Exempt this paragraph from document automatic hyphenation. */
   suppressAutoHyphens?: boolean;
   /** Document-wide automatic hyphenation controls retained for line layout. */
@@ -568,7 +582,7 @@ type ParagraphAttrs = {
 /**
  * A paragraph block containing runs.
  */
-type ParagraphBlock = {
+export type ParagraphBlock = {
   kind: "paragraph";
   id: BlockId;
   /** Stable Word `w14:paraId` / PM `paraId`, when available. */
@@ -598,7 +612,7 @@ type ParagraphBlock = {
 /**
  * Cell border specification for rendering.
  */
-type CellBorderSpec = {
+export type CellBorderSpec = {
   width?: number;
   color?: string;
   style?: CssBorderStyle;
@@ -606,7 +620,7 @@ type CellBorderSpec = {
 /**
  * Cell borders (all four sides).
  */
-type CellBorders = {
+export type CellBorders = {
   top?: CellBorderSpec;
   bottom?: CellBorderSpec;
   left?: CellBorderSpec;
@@ -617,7 +631,7 @@ type CellBorders = {
 /**
  * A table cell with content.
  */
-type TableCell = {
+export type TableCell = {
   id: BlockId;
   blocks: FlowBlock[];
   colSpan?: number;
@@ -643,11 +657,11 @@ type TableCell = {
 };
 type TableCellPadding = NonNullable<TableCell["padding"]>;
 /** Resolve authored cell margins against the TableNormal defaults. */
-declare const resolveTableCellPadding: (cell: Pick<TableCell, "padding"> | undefined) => TableCellPadding;
+export declare const resolveTableCellPadding: (cell: Pick<TableCell, "padding"> | undefined) => TableCellPadding;
 /**
  * A table row containing cells.
  */
-type TableRow = {
+export type TableRow = {
   id: BlockId;
   cells: TableCell[];
   gridBefore?: number;
@@ -666,7 +680,7 @@ type TableRow = {
 /**
  * Floating table positioning info (pixel values).
  */
-type FloatingTablePosition = {
+export type FloatingTablePosition = {
   horzAnchor?: "margin" | "page" | "text";
   vertAnchor?: "margin" | "page" | "text";
   tblpX?: number;
@@ -681,7 +695,7 @@ type FloatingTablePosition = {
 /**
  * A table block containing rows.
  */
-type TableBlock = {
+export type TableBlock = {
   kind: "table";
   id: BlockId;
   rows: TableRow[];
@@ -729,7 +743,7 @@ type TableBlock = {
 /**
  * An anchored/floating image block.
  */
-type ImageBlock = {
+export type ImageBlock = {
   kind: "image";
   id: BlockId;
   src: string;
@@ -782,7 +796,7 @@ type ImageBlock = {
 /**
  * Section break block defining page layout changes.
  */
-type SectionBreakBlock = {
+export type SectionBreakBlock = {
   kind: "sectionBreak";
   id: BlockId;
   /**
@@ -806,7 +820,7 @@ type SectionBreakBlock = {
   documentGridLinePitchTwips?: number;
 };
 /** Normalized section page-number policy. An omitted OOXML start continues numbering. */
-type SectionPageNumbering = {
+export type SectionPageNumbering = {
   type: "continue";
   format?: NumberFormat;
 } | {
@@ -814,7 +828,7 @@ type SectionPageNumbering = {
   start: number;
   format?: NumberFormat;
 };
-type PageHeaderFooterRefs = {
+export type PageHeaderFooterRefs = {
   titlePg?: boolean;
   evenAndOddHeaders?: boolean;
   headerDefault?: string;
@@ -827,7 +841,7 @@ type PageHeaderFooterRefs = {
 /**
  * Explicit page break block.
  */
-type PageBreakBlock = {
+export type PageBreakBlock = {
   kind: "pageBreak";
   id: BlockId;
   /** Revision metadata when the structural boundary is newly authored. */
@@ -843,28 +857,28 @@ type PageBreakBlock = {
 /**
  * Column break block.
  */
-type ColumnBreakBlock = {
+export type ColumnBreakBlock = {
   kind: "columnBreak";
   id: BlockId;
   pmStart?: number;
   pmEnd?: number;
 };
 /** Default internal margins for text boxes (OOXML defaults in pixels) */
-declare const DEFAULT_TEXTBOX_MARGINS: {
+export declare const DEFAULT_TEXTBOX_MARGINS: {
   top: number;
   bottom: number;
   left: number;
   right: number;
 };
 /** Default text box width in pixels when no width is specified */
-declare const DEFAULT_TEXTBOX_WIDTH = 200;
+export declare const DEFAULT_TEXTBOX_WIDTH = 200;
 /**
  * A linear DrawingML gradient fill with its colors resolved (ECMA-376
  * §20.1.8.33, §20.1.8.41). It runs along `angle`, in degrees clockwise from
  * the positive x axis; when `scaled`, that angle is stated in the unit square
  * and stretched with the box.
  */
-type TextBoxGradientFill = {
+export type TextBoxGradientFill = {
   angle: number;
   scaled: boolean;
   /** Stops in ascending order; `offset` runs 0 to 1. */
@@ -876,7 +890,7 @@ type TextBoxGradientFill = {
 /**
  * Text box block — positioned container with block content.
  */
-type TextBoxBlock = {
+export type TextBoxBlock = {
   kind: "textBox";
   id: BlockId;
   /** Width in pixels */
@@ -955,7 +969,7 @@ type TextBoxBlock = {
  * `id` is a per-document, monotonically assigned identifier so nested SDTs
  * stay disambiguated even when alias/tag/sdtId collide.
  */
-type SdtGroup = {
+export type SdtGroup = {
   /** Folio-local identifier (stable within one toFlowBlocks call). */
   id: string;
   /**
@@ -994,11 +1008,11 @@ type SdtGroup = {
 /**
  * Union of all flow block types (input to layout engine).
  */
-type FlowBlock = ParagraphBlock | TableBlock | ImageBlock | TextBoxBlock | SectionBreakBlock | PageBreakBlock | ColumnBreakBlock;
+export type FlowBlock = ParagraphBlock | TableBlock | ImageBlock | TextBoxBlock | SectionBreakBlock | PageBreakBlock | ColumnBreakBlock;
 /**
  * A measured line within a paragraph.
  */
-type MeasuredLine = {
+export type MeasuredLine = {
   /** Starting run index (inclusive). */
   fromRun: number;
   /** Starting character index within fromRun. */
@@ -1040,7 +1054,7 @@ type MeasuredLine = {
 /**
  * Measurement result for a paragraph block.
  */
-type ParagraphMeasure = {
+export type ParagraphMeasure = {
   kind: "paragraph";
   lines: MeasuredLine[];
   totalHeight: number;
@@ -1048,7 +1062,7 @@ type ParagraphMeasure = {
 /**
  * Measurement result for an image block.
  */
-type ImageMeasure = {
+export type ImageMeasure = {
   kind: "image";
   width: number;
   height: number;
@@ -1062,7 +1076,7 @@ type ImageMeasure = {
 /**
  * Measurement result for a table cell.
  */
-type TableCellMeasure = {
+export type TableCellMeasure = {
   blocks: Measure[];
   width: number;
   height: number;
@@ -1072,14 +1086,14 @@ type TableCellMeasure = {
 /**
  * Measurement result for a table row.
  */
-type TableRowMeasure = {
+export type TableRowMeasure = {
   cells: TableCellMeasure[];
   height: number;
 };
 /**
  * Measurement result for a table block.
  */
-type TableMeasure = {
+export type TableMeasure = {
   kind: "table";
   rows: TableRowMeasure[];
   columnWidths: number[];
@@ -1092,25 +1106,25 @@ type TableMeasure = {
 /**
  * Measurement result for section break (no visual size).
  */
-type SectionBreakMeasure = {
+export type SectionBreakMeasure = {
   kind: "sectionBreak";
 };
 /**
  * Measurement result for page break (no visual size).
  */
-type PageBreakMeasure = {
+export type PageBreakMeasure = {
   kind: "pageBreak";
 };
 /**
  * Measurement result for column break (no visual size).
  */
-type ColumnBreakMeasure = {
+export type ColumnBreakMeasure = {
   kind: "columnBreak";
 };
 /**
  * Measurement result for a text box block.
  */
-type TextBoxMeasure = {
+export type TextBoxMeasure = {
   kind: "textBox";
   width: number;
   height: number;
@@ -1120,11 +1134,11 @@ type TextBoxMeasure = {
 /**
  * Union of all measurement types.
  */
-type Measure = ParagraphMeasure | ImageMeasure | TableMeasure | TextBoxMeasure | SectionBreakMeasure | PageBreakMeasure | ColumnBreakMeasure;
+export type Measure = ParagraphMeasure | ImageMeasure | TableMeasure | TextBoxMeasure | SectionBreakMeasure | PageBreakMeasure | ColumnBreakMeasure;
 /**
  * Base fragment properties common to all fragment types.
  */
-type FragmentBase = {
+export type FragmentBase = {
   /** Block ID this fragment belongs to. */
   blockId: BlockId;
   /** X position on page (relative to page left). */
@@ -1148,8 +1162,13 @@ type FragmentBase = {
  * A paragraph fragment positioned on a page.
  * May span only part of the paragraph's lines if split across pages.
  */
-type ParagraphFragment = FragmentBase & {
+export type ParagraphFragment = FragmentBase & {
   kind: "paragraph";
+  /** Paper/gap clip bounds captured from the section active when this fragment was placed. */
+  inlinePictureViewport?: {
+    left: number;
+    right: number;
+  };
   /** Structural PM carrier that must not make an otherwise blank page visible. */
   paginationRole?: "empty-carrier";
   /** First line index (inclusive) from the measure. */
@@ -1167,7 +1186,7 @@ type ParagraphFragment = FragmentBase & {
  * A table fragment positioned on a page.
  * May span only part of the table's rows if split across pages.
  */
-type TableFragment = FragmentBase & {
+export type TableFragment = FragmentBase & {
   kind: "table";
   /** First row index (inclusive). */
   fromRow: number;
@@ -1197,7 +1216,7 @@ type TableFragment = FragmentBase & {
 /**
  * An image fragment positioned on a page.
  */
-type ImageFragment = FragmentBase & {
+export type ImageFragment = FragmentBase & {
   kind: "image";
   /** Height of the image. */
   height: number;
@@ -1209,7 +1228,7 @@ type ImageFragment = FragmentBase & {
 /**
  * A text box fragment positioned on a page.
  */
-type TextBoxFragment = FragmentBase & {
+export type TextBoxFragment = FragmentBase & {
   kind: "textBox";
   /** Height of the text box. */
   height: number;
@@ -1219,11 +1238,11 @@ type TextBoxFragment = FragmentBase & {
 /**
  * Union of all fragment types.
  */
-type Fragment = ParagraphFragment | TableFragment | ImageFragment | TextBoxFragment;
+export type Fragment = ParagraphFragment | TableFragment | ImageFragment | TextBoxFragment;
 /**
  * Page margin configuration.
  */
-type PageMargins = {
+export type PageMargins = {
   top: number;
   right: number;
   bottom: number;
@@ -1236,7 +1255,7 @@ type PageMargins = {
 /**
  * A rendered page containing positioned fragments.
  */
-type Page = {
+export type Page = {
   /** Physical page number (1-indexed), used for navigation and page counts. */
   number: number;
   /** Authored page number shown by PAGE fields. */
@@ -1268,6 +1287,8 @@ type Page = {
   headerFooterRefs?: PageHeaderFooterRefs;
   /** Footnote IDs that appear on this page (for rendering). */
   footnoteIds?: number[];
+  /** Endnote IDs whose content fragments appear on this page. */
+  endnoteIds?: number[];
   /** Height reserved for the footnote area at page bottom (pixels). */
   footnoteReservedHeight?: number;
   /**
@@ -1282,7 +1303,7 @@ type Page = {
  * One separator rule of a flowed note area: the top-left corner of a
  * `NOTE_SEPARATOR_RULE_THICKNESS`-high rule and its width, in page pixels.
  */
-type NoteSeparatorRule = {
+export type NoteSeparatorRule = {
   x: number;
   y: number;
   width: number;
@@ -1290,7 +1311,7 @@ type NoteSeparatorRule = {
 /**
  * Column layout configuration.
  */
-type ColumnLayout = {
+export type ColumnLayout = {
   count: number;
   gap: number;
   equalWidth?: boolean;
@@ -1304,14 +1325,14 @@ type ColumnLayout = {
 /**
  * Header/footer layout for a specific type.
  */
-type HeaderFooterLayout = {
+export type HeaderFooterLayout = {
   height: number;
   fragments: Fragment[];
 };
 /**
  * Final layout output ready for rendering/painting.
  */
-type Layout = {
+export type Layout = {
   /** Default page size for the document. */
   pageSize: {
     w: number;
@@ -1331,11 +1352,11 @@ type Layout = {
 /**
  * Header/footer content heights by variant type.
  */
-type HeaderFooterContentHeights = Partial<Record<"default" | "first" | "even" | "odd", number>>;
+export type HeaderFooterContentHeights = Partial<Record<"default" | "first" | "even" | "odd", number>>;
 /**
  * Pre-calculated footnote content for layout and rendering.
  */
-type FootnoteContent = {
+export type FootnoteContent = {
   /** Footnote ID. */
   id: number;
   /** Display number (e.g. 1, 2, 3). */
@@ -1350,7 +1371,7 @@ type FootnoteContent = {
 /**
  * Options for the layout engine.
  */
-type LayoutOptions = {
+export type LayoutOptions = {
   /** Initial page size. */
   pageSize: {
     w: number;
@@ -1386,6 +1407,8 @@ type LayoutOptions = {
   sectionVerticalAlignments?: readonly (VerticalAlign | undefined)[];
   /** Column configuration. */
   columns?: ColumnLayout;
+  /** Column balancing policy after applying document compatibility settings. */
+  columnBalancing?: "balanced" | "natural";
   /** Gap between rendered pages (for UI). */
   pageGap?: number;
   /** Default line height multiplier. */
@@ -1423,23 +1446,23 @@ type LayoutOptions = {
   noteAreas?: NoteAreaLayout;
 };
 /** Which separator story a flowed note-area block renders. */
-type NoteSeparatorKind = "separator" | "continuationSeparator";
+export type NoteSeparatorKind = "separator" | "continuationSeparator";
 /**
  * Note areas laid out in the body flow (ECMA-376 §17.11): endnotes collected
  * at the end of the document or of a section. Their blocks sit in the body's
  * block list; this names the ones the paginator treats specially.
  */
-type NoteAreaLayout = {
+export type NoteAreaLayout = {
   /**
    * Separator-story paragraphs that carry a `w:separator` mark, keyed by block
    * id. A rule is drawn across the first line of each of their fragments.
    */
   separatorBlockIds: ReadonlyMap<string, NoteSeparatorKind>;
   /**
-   * Note content blocks. A page opened while one of them is laid out
+   * Note identities keyed by content block. A page opened while one is laid out
    * continues the area, so it starts with the continuation separator.
    */
-  contentBlockIds: ReadonlySet<string>;
+  noteStoryByBlockId: ReadonlyMap<string, NoteStoryKey>;
   /** The `w:continuationSeparator` story's first paragraph, already measured. */
   continuationSeparator?: {
     block: ParagraphBlock;
@@ -1449,7 +1472,7 @@ type NoteAreaLayout = {
 /**
  * Result of hit-testing a click position.
  */
-type HitTestResult = {
+export type HitTestResult = {
   /** Page index (0-based). */
   pageIndex: number;
   /** Fragment that was hit, if any. */
@@ -1462,7 +1485,7 @@ type HitTestResult = {
 /**
  * Position within the document model.
  */
-type DocumentPosition = {
+export type DocumentPosition = {
   /** Block index. */
   blockIndex: number;
   /** Run index within the block (for paragraphs). */
@@ -1477,7 +1500,7 @@ type DocumentPosition = {
  * Used by the paginator when reserving space and by the painter when laying
  * out the stack at the bottom of the page.
  */
-declare const FOOTNOTE_SEPARATOR_HEIGHT = 12;
+export declare const FOOTNOTE_SEPARATOR_HEIGHT = 12;
 /**
  * Extra bottom margin applied to every rendered footnote entry, in CSS pixels.
  *
@@ -1486,22 +1509,22 @@ declare const FOOTNOTE_SEPARATOR_HEIGHT = 12;
  * Keep the wrapper margin at zero to avoid adding whitespace that is not
  * present in the source DOCX.
  */
-declare const FOOTNOTE_ENTRY_MARGIN_BOTTOM = 0;
+export declare const FOOTNOTE_ENTRY_MARGIN_BOTTOM = 0;
 /** Thickness of a note separator rule, in the footnote band and in flowed endnotes. */
-declare const NOTE_SEPARATOR_RULE_THICKNESS = 0.5;
+export declare const NOTE_SEPARATOR_RULE_THICKNESS = 0.5;
 /** Width of a `w:separator` rule as a fraction of its column. */
-declare const NOTE_SEPARATOR_WIDTH_FRACTION = 0.33;
+export declare const NOTE_SEPARATOR_WIDTH_FRACTION = 0.33;
 /**
  * Line height used when a footnote entry has no measured line height yet.
  * Conservative fallback so a missing measure does not collapse the entry.
  */
-declare const FOOTNOTE_FALLBACK_LINE_HEIGHT = 13;
+export declare const FOOTNOTE_FALLBACK_LINE_HEIGHT = 13;
 /**
  * Header / footer content prepared by the bridge for the painter. Lives here
  * because both layers reference the shape; the painter must not import it from
  * the bridge and the bridge must not import it from the painter.
  */
-type HeaderFooterContent = {
+export type HeaderFooterContent = {
   /** Flow blocks for the header/footer content. */
   blocks: FlowBlock[];
   /** Measurements for the blocks. */
@@ -1545,7 +1568,7 @@ type HeaderFooterContent = {
  * Pure predicate over `ImageRun` — no DOM, no measurement state. Lives here
  * so the bridge can call it without importing from the painter.
  */
-declare const isFloatingImageRun: (run: ImageRun) => boolean;
+export declare const isFloatingImageRun: (run: ImageRun) => boolean;
 /**
  * `true` when a floating image should also shrink surrounding line widths.
  * `behind` / `inFront` (wrapNone) and `topAndBottom` do not — text either
@@ -1554,27 +1577,27 @@ declare const isFloatingImageRun: (run: ImageRun) => boolean;
  * `displayMode === "float"` path is treated as wrapping when a CSS float
  * direction is set.
  */
-declare const isTextWrappingFloatingImageRun: (run: ImageRun) => boolean;
-type TextBoxFlowAttrs = Pick<TextBoxBlock, "displayMode" | "wrapType">;
+export declare const isTextWrappingFloatingImageRun: (run: ImageRun) => boolean;
+export type TextBoxFlowAttrs = Pick<TextBoxBlock, "displayMode" | "wrapType">;
 /**
  * `true` when the text box is anchored outside normal block flow — either
  * via the `float` display mode or via an OOXML floating wrap type (which
  * includes `topAndBottom`; see {@link floatingTextBoxReservesBand}).
  */
-declare function isFloatingTextBoxBlock(block: TextBoxFlowAttrs): boolean;
+export declare function isFloatingTextBoxBlock(block: TextBoxFlowAttrs): boolean;
 /**
  * `true` when a floating text box should also reduce surrounding text
  * line widths. Excludes wrapNone (`behind`/`inFront`) and `topAndBottom`
  * which are positioned floats but do not carve a horizontal exclusion.
  */
-declare function floatingTextBoxWrapsText(block: TextBoxFlowAttrs): boolean;
+export declare function floatingTextBoxWrapsText(block: TextBoxFlowAttrs): boolean;
 /**
  * `true` when a floating text box reserves a full-width vertical band rather
  * than a side exclusion. `topAndBottom` boxes break the text above and below
  * the box (no text beside it), so surrounding lines flow past the band.
  * Ported from eigenpal #694.
  */
-declare function floatingTextBoxReservesBand(block: TextBoxFlowAttrs): boolean;
+export declare function floatingTextBoxReservesBand(block: TextBoxFlowAttrs): boolean;
 /**
  * A table's columns are pinned when the layout engine cannot widen a column to
  * fit content that overflows it: either the layout is explicitly fixed
@@ -1588,20 +1611,20 @@ declare function floatingTextBoxReservesBand(block: TextBoxFlowAttrs): boolean;
  * instead, so there `w:noWrap` genuinely keeps content on one line. Measurement
  * and the painter both consult this so their line count and `white-space` agree.
  */
-declare function tableColumnsArePinned(table: TableBlock): boolean;
+export declare function tableColumnsArePinned(table: TableBlock): boolean;
 /**
  * Resolve a `w:tblW`/`w:tcW` pair to pixels. The single reader: measurement and
  * the footnote layout bridge both go through it so a table cannot be pinned in
  * one and autofitted in the other.
  */
-declare function resolveTableWidthPx(width: number | undefined, widthType: TableWidthType | undefined, containerWidth: number): number | undefined;
+export declare function resolveTableWidthPx(width: number | undefined, widthType: TableWidthType | undefined, containerWidth: number): number | undefined;
 /** Return the leading visual offset for a row with omitted grid columns. */
-declare const getTableRowLeadingWidth: (row: TableRow, columnWidths: readonly number[]) => number;
+export declare const getTableRowLeadingWidth: (row: TableRow, columnWidths: readonly number[]) => number;
 /**
  * A copy of a block with every ProseMirror anchor removed. A note story's
  * blocks carry positions in the note's own document; painted beside the body
  * they must not resolve a click, a selection or a caret into the body.
  */
-declare function stripFlowBlockPmAnchors(block: FlowBlock): FlowBlock;
+export declare function stripFlowBlockPmAnchors(block: FlowBlock): FlowBlock;
 //#endregion
-export { BlockId, BorderStyle, CellBorderSpec, CellBorders, ColumnBreakBlock, ColumnBreakMeasure, ColumnLayout, DEFAULT_TEXTBOX_MARGINS, DEFAULT_TEXTBOX_WIDTH, DocumentPosition, FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FieldRun, FloatingTablePosition, FlowBlock, FootnoteContent, Fragment, FragmentBase, HeaderFooterContent, HeaderFooterContentHeights, HeaderFooterLayout, HitTestResult, HyperlinkInfo, ImageBlock, ImageFragment, ImageMeasure, ImageRun, ImageRunPosition, Layout, LayoutOptions, LineBreakRun, ListMarkerFormatting, MathRun, Measure, MeasuredLine, NOTE_SEPARATOR_RULE_THICKNESS, NOTE_SEPARATOR_WIDTH_FRACTION, NoteAreaLayout, NoteSeparatorKind, NoteSeparatorRule, Page, PageBreakBlock, PageBreakMeasure, PageHeaderFooterRefs, PageMargins, ParagraphAttrs, ParagraphBlock, ParagraphBorders, ParagraphFragment, ParagraphIndent, ParagraphMeasure, ParagraphSpacing, RenderedPageBreakRun, Run, RunFormatting, SdtGroup, SectionBreakBlock, SectionBreakMeasure, SectionPageNumbering, TabAlignment, TabRun, TabStop, TableBlock, TableCell, TableCellMeasure, TableFragment, TableMeasure, TableRow, TableRowMeasure, TextBoxBlock, TextBoxFlowAttrs, TextBoxFragment, TextBoxGradientFill, TextBoxMeasure, TextRun, floatingTextBoxReservesBand, floatingTextBoxWrapsText, getTableRowLeadingWidth, isFloatingImageRun, isFloatingTextBoxBlock, isListNumPr, isTextWrappingFloatingImageRun, resolveTableCellPadding, resolveTableWidthPx, stripFlowBlockPmAnchors, tableColumnsArePinned, types_d_exports };
+export { types_d_exports };