@stll/folio-core 0.14.1 → 0.15.1

package/dist/layout-bridge/convert/headerFooterLayout.d.ts

@@ -3,7 +3,6 @@ import { FlowBlock, HeaderFooterContent, ImageRun, ImageRunPosition, Measure, Pa
 import { ToFlowBlocksOptions } from "./toFlowBlocks.js";
 import { MeasureBlocksFn } from "./footnoteLayout.js";
 import { Node } from "prosemirror-model";
-
 //#region src/layout-bridge/convert/headerFooterLayout.d.ts
 type HeaderFooterMetrics = {
   section: "header" | "footer";
@@ -34,7 +33,8 @@ declare function calculateHeaderFooterMarginPushBounds(blocks: FlowBlock[], meas
 type ConvertHeaderFooterOptions = {
   styles?: document_d_exports.StyleDefinitions | null;
   theme?: document_d_exports.Theme | null;
-  measureBlocks: MeasureBlocksFn; /** Document-wide `w:defaultTabStop` in twips — forwarded to toFlowBlocks. */
+  measureBlocks: MeasureBlocksFn;
+  /** Document-wide `w:defaultTabStop` in twips — forwarded to toFlowBlocks. */
   defaultTabStopTwips?: number;
   lineBreakRules?: ToFlowBlocksOptions["lineBreakRules"];
   justificationCompatibility?: ToFlowBlocksOptions["justificationCompatibility"];

package/dist/layout-bridge/convert/paragraphFrames.d.ts

@@ -1,5 +1,4 @@
 import { BlockId, FlowBlock } from "../../layout-engine/types.js";
-
 //#region src/layout-bridge/convert/paragraphFrames.d.ts
 type BlockIdFactory = () => BlockId;
 declare function groupParagraphFrames(blocks: FlowBlock[], nextBlockId: BlockIdFactory): FlowBlock[];

package/dist/layout-bridge/convert/templatePreviewFlow.d.ts

@@ -1,15 +1,18 @@
 import { TemplatePreviewValue } from "../../prosemirror/plugins/templatePreviewValues.js";
 import { FlowBlock } from "../../layout-engine/types.js";
-
 //#region src/layout-bridge/convert/templatePreviewFlow.d.ts
 /** One marker→value substitution, in PM doc positions. */
 type TemplatePreviewFlowEntry = {
-  /** Inclusive PM doc position of the marker start. */from: number; /** Exclusive PM doc position of the marker end. */
-  to: number; /** The typed value displayed in place of the marker. */
+  /** Inclusive PM doc position of the marker start. */
+  from: number;
+  /** Exclusive PM doc position of the marker end. */
+  to: number;
+  /** The typed value displayed in place of the marker. */
   value: TemplatePreviewValue;
 };
 type TemplatePreviewFlowOptions = {
-  entries: readonly TemplatePreviewFlowEntry[]; /** `highlighted` marks substituted runs for the accent-chip CSS. */
+  entries: readonly TemplatePreviewFlowEntry[];
+  /** `highlighted` marks substituted runs for the accent-chip CSS. */
   mode: "highlighted" | "plain";
 };
 /**
@@ -17,10 +20,7 @@ type TemplatePreviewFlowOptions = {
  * flow blocks (recursing into table cells and text boxes). Returns the input
  * array unchanged when there is nothing to substitute.
  */
-declare function applyTemplatePreviewToBlocks(blocks: FlowBlock[], {
-  entries,
-  mode
-}: TemplatePreviewFlowOptions): FlowBlock[];
+declare function applyTemplatePreviewToBlocks(blocks: FlowBlock[], { entries, mode }: TemplatePreviewFlowOptions): FlowBlock[];
 /**
  * PM range covering every substitution that differs between two preview
  * states (changed, added, or removed entries), or `null` when the

package/dist/layout-bridge/convert/toFlowBlocks.d.ts

@@ -1,18 +1,24 @@
 import { document_d_exports } from "../../types/document.js";
 import { BorderStyle, FlowBlock, ParagraphAttrs } from "../../layout-engine/types.js";
 import { Node } from "prosemirror-model";
-
 //#region src/layout-bridge/convert/toFlowBlocks.d.ts
 /**
  * Options for the conversion.
  */
 type ToFlowBlocksOptions = {
-  /** Default font family. */defaultFont?: string; /** Default font size in points. */
-  defaultSize?: number; /** Theme for resolving theme colors. */
-  theme?: document_d_exports.Theme | null; /** Page content height in pixels (pageHeight - marginTop - marginBottom). Images taller than this are scaled down to fit. */
-  pageContentHeight?: number; /** Shared list counters for nested containers. */
-  listCounters?: Map<number, number[]>; /** Latest concrete counters by abstract numbering definition. */
-  listAbstractCounters?: Map<number, number[]>; /** Shared startOverride state for nested containers. */
+  /** Default font family. */
+  defaultFont?: string;
+  /** Default font size in points. */
+  defaultSize?: number;
+  /** Theme for resolving theme colors. */
+  theme?: document_d_exports.Theme | null;
+  /** Page content height in pixels (pageHeight - marginTop - marginBottom). Images taller than this are scaled down to fit. */
+  pageContentHeight?: number;
+  /** Shared list counters for nested containers. */
+  listCounters?: Map<number, number[]>;
+  /** Latest concrete counters by abstract numbering definition. */
+  listAbstractCounters?: Map<number, number[]>;
+  /** Shared startOverride state for nested containers. */
   listSeenNumIds?: Set<string>;
   /**
    * Parallel counter state for the "original" (pre-revision) document, used to
@@ -22,8 +28,10 @@ type ToFlowBlocksOptions = {
    * item continues the counter of the inserted item before it (a, b → c, d, e
    * instead of a, b and a, b, c). Normal items advance both streams.
    */
-  originalListCounters?: Map<number, number[]>; /** Latest concrete original-stream counters by abstract numbering definition. */
-  originalListAbstractCounters?: Map<number, number[]>; /** Original-stream startOverride state. */
+  originalListCounters?: Map<number, number[]>;
+  /** Latest concrete original-stream counters by abstract numbering definition. */
+  originalListAbstractCounters?: Map<number, number[]>;
+  /** Original-stream startOverride state. */
   originalListSeenNumIds?: Set<string>;
   /**
    * Document-wide `w:defaultTabStop` (§17.6.13) in twips. Stamped onto
@@ -31,7 +39,8 @@ type ToFlowBlocksOptions = {
    * tab-stop math) can read it without taking a `Document` reference.
    * Defaults to the OOXML 720-twip value when absent.
    */
-  defaultTabStopTwips?: number; /** Document-wide custom Word line-breaking settings. */
+  defaultTabStopTwips?: number;
+  /** Document-wide custom Word line-breaking settings. */
   lineBreakRules?: {
     noLineBreaksBefore?: {
       language?: string;
@@ -42,9 +51,12 @@ type ToFlowBlocksOptions = {
       characters: string;
     };
     useLegacyEthiopicAmharicRules?: boolean;
-  }; /** Document-generation policy for justified line fitting. */
-  justificationCompatibility?: NonNullable<ParagraphAttrs["justificationCompatibility"]>; /** Document-wide automatic hyphenation policy. */
-  automaticHyphenation?: NonNullable<ParagraphAttrs["automaticHyphenation"]>; /** Line pitch for the final body section, whose properties live outside the PM body. */
+  };
+  /** Document-generation policy for justified line fitting. */
+  justificationCompatibility?: NonNullable<ParagraphAttrs["justificationCompatibility"]>;
+  /** Document-wide automatic hyphenation policy. */
+  automaticHyphenation?: NonNullable<ParagraphAttrs["automaticHyphenation"]>;
+  /** Line pitch for the final body section, whose properties live outside the PM body. */
   finalSectionDocumentGridLinePitchTwips?: number;
 };
 declare function formatCounter(value: number, format: document_d_exports.NumberFormat | undefined): string;

package/dist/layout-bridge/convert/wrapEditorViewAsSurface.d.ts

@@ -1,9 +1,10 @@
 import { EditorState, Transaction } from "prosemirror-state";
 import { EditorView } from "prosemirror-view";
-
 //#region src/layout-bridge/convert/wrapEditorViewAsSurface.d.ts
 type Surface = {
-  /** Identity tag — `"body"` for the body PM, `"hf"` for any HF PM. */kind: "body" | "hf"; /** rId of the source HF part; `null` for the body surface. */
+  /** Identity tag — `"body"` for the body PM, `"hf"` for any HF PM. */
+  kind: "body" | "hf";
+  /** rId of the source HF part; `null` for the body surface. */
   rId: string | null;
   getState: () => EditorState | null;
   getView: () => EditorView | null;

package/dist/layout-bridge/dom/findHfPmSpans.d.ts

@@ -23,7 +23,8 @@ declare function findHfPmAnchor(container: ParentNode, kind: HfSlotKind, rId: st
  * should hug so the renderer can pick `left` vs `right`.
  */
 type HfCaretSpanHit = {
-  element: HTMLElement; /** Which edge of the span's getBoundingClientRect to anchor the caret to. */
+  element: HTMLElement;
+  /** Which edge of the span's getBoundingClientRect to anchor the caret to. */
   edge: "left" | "right";
 };
 declare function findHfCaretSpan(container: ParentNode, kind: HfSlotKind, rId: string, pos: number): HfCaretSpanHit | null;

package/dist/layout-bridge/dom/noteStoryDom.d.ts

@@ -1,5 +1,4 @@
 import { NoteStoryKey } from "../../controller/noteEditorManager.js";
-
 //#region src/layout-bridge/dom/noteStoryDom.d.ts
 declare const findNoteStoryForTarget: (target: unknown) => NoteStoryKey | null;
 //#endregion

package/dist/layout-bridge/engine/clickToPosition.d.ts

@@ -1,13 +1,15 @@
 import { ParagraphBlock, ParagraphMeasure } from "../../layout-engine/types.js";
 import { FragmentHit, TableCellHit } from "./hitTest.js";
-
 //#region src/layout-bridge/engine/clickToPosition.d.ts
 /**
  * Result of click-to-position mapping.
  */
 type PositionResult = {
-  /** ProseMirror document position. */pmPosition: number; /** Character offset within the line (for debugging). */
-  charOffset: number; /** Line index within the paragraph. */
+  /** ProseMirror document position. */
+  pmPosition: number;
+  /** Character offset within the line (for debugging). */
+  charOffset: number;
+  /** Line index within the paragraph. */
   lineIndex: number;
 };
 /**

package/dist/layout-bridge/engine/hitTest.d.ts

@@ -1,5 +1,4 @@
 import { FlowBlock, Fragment, Layout, Measure, Page, ParagraphBlock, ParagraphMeasure, TableBlock, TableFragment, TableMeasure } from "../../layout-engine/types.js";
-
 //#region src/layout-bridge/engine/hitTest.d.ts
 /**
  * A 2D point in page coordinate space.
@@ -12,34 +11,53 @@ type Point = {
  * Result of hit-testing to find which page contains a point.
  */
 type PageHit = {
-  /** Index of the page (0-based). */pageIndex: number; /** The page that was hit. */
-  page: Page; /** Y position relative to the page top. */
+  /** Index of the page (0-based). */
+  pageIndex: number;
+  /** The page that was hit. */
+  page: Page;
+  /** Y position relative to the page top. */
   pageY: number;
 };
 /**
  * Result of hit-testing to find which fragment contains a point.
  */
 type FragmentHit = {
-  /** The fragment that was hit. */fragment: Fragment; /** The corresponding flow block. */
-  block: FlowBlock; /** The corresponding measurement. */
-  measure: Measure; /** Page index (0-based). */
-  pageIndex: number; /** Y position relative to the fragment top. */
-  localY: number; /** X position relative to the fragment left. */
+  /** The fragment that was hit. */
+  fragment: Fragment;
+  /** The corresponding flow block. */
+  block: FlowBlock;
+  /** The corresponding measurement. */
+  measure: Measure;
+  /** Page index (0-based). */
+  pageIndex: number;
+  /** Y position relative to the fragment top. */
+  localY: number;
+  /** X position relative to the fragment left. */
   localX: number;
 };
 /**
  * Result of hit-testing a table to find the cell.
  */
 type TableCellHit = {
-  /** The table fragment. */fragment: TableFragment; /** The table block. */
-  block: TableBlock; /** The table measure. */
-  measure: TableMeasure; /** Page index (0-based). */
-  pageIndex: number; /** Row index (0-based). */
-  rowIndex: number; /** Column index (0-based). */
-  colIndex: number; /** Paragraph block within the cell (first one). */
-  cellBlock?: ParagraphBlock; /** Paragraph measure within the cell. */
-  cellMeasure?: ParagraphMeasure; /** X position relative to cell content area. */
-  cellLocalX: number; /** Y position relative to cell content area. */
+  /** The table fragment. */
+  fragment: TableFragment;
+  /** The table block. */
+  block: TableBlock;
+  /** The table measure. */
+  measure: TableMeasure;
+  /** Page index (0-based). */
+  pageIndex: number;
+  /** Row index (0-based). */
+  rowIndex: number;
+  /** Column index (0-based). */
+  colIndex: number;
+  /** Paragraph block within the cell (first one). */
+  cellBlock?: ParagraphBlock;
+  /** Paragraph measure within the cell. */
+  cellMeasure?: ParagraphMeasure;
+  /** X position relative to cell content area. */
+  cellLocalX: number;
+  /** Y position relative to cell content area. */
   cellLocalY: number;
 };
 /**
@@ -93,8 +111,11 @@ declare function hitTestTableCell(pageHit: PageHit, blocks: FlowBlock[], measure
  * Combined result of all hit testing.
  */
 type HitTestResult = {
-  /** Page that was hit. */pageHit: PageHit | null; /** Fragment that was hit (if any). */
-  fragmentHit: FragmentHit | null; /** Table cell that was hit (if fragment is a table). */
+  /** Page that was hit. */
+  pageHit: PageHit | null;
+  /** Fragment that was hit (if any). */
+  fragmentHit: FragmentHit | null;
+  /** Table cell that was hit (if fragment is a table). */
   tableCellHit: TableCellHit | null;
 };
 /**

package/dist/layout-bridge/engine/selectionRects.d.ts

@@ -1,23 +1,31 @@
 import { FlowBlock, Layout, Measure } from "../../layout-engine/types.js";
-
 //#region src/layout-bridge/engine/selectionRects.d.ts
 /**
  * A rectangle representing part of a selection.
  */
 type SelectionRect = {
-  /** X coordinate in container space. */x: number; /** Y coordinate in container space. */
-  y: number; /** Width of the rectangle. */
-  width: number; /** Height of the rectangle (typically line height). */
-  height: number; /** Page index (0-based). */
+  /** X coordinate in container space. */
+  x: number;
+  /** Y coordinate in container space. */
+  y: number;
+  /** Width of the rectangle. */
+  width: number;
+  /** Height of the rectangle (typically line height). */
+  height: number;
+  /** Page index (0-based). */
   pageIndex: number;
 };
 /**
  * Caret position for collapsed selection.
  */
 type CaretPosition = {
-  /** X coordinate in container space. */x: number; /** Y coordinate in container space. */
-  y: number; /** Height of the caret (line height). */
-  height: number; /** Page index (0-based). */
+  /** X coordinate in container space. */
+  x: number;
+  /** Y coordinate in container space. */
+  y: number;
+  /** Height of the caret (line height). */
+  height: number;
+  /** Page index (0-based). */
   pageIndex: number;
 };
 /**

package/dist/layout-bridge/engine/tableWidthUtils.d.ts

@@ -1,5 +1,4 @@
 import { document_d_exports } from "../../types/document.js";
-
 //#region src/layout-bridge/engine/tableWidthUtils.d.ts
 declare function resolveTableWidthPx(width: number | undefined, widthType: document_d_exports.TableWidthType | undefined, containerWidth: number): number | undefined;
 declare function normalizeTableColumnWidths(widths: number[], columnCount: number, targetWidth: number): number[];

package/dist/layout-bridge/headerFooterLayout.d.ts

@@ -1,5 +1,4 @@
 import { EditorView } from "prosemirror-view";
-
 //#region src/layout-bridge/headerFooterLayout.d.ts
 /**
  * Drop the cached HF host + span lists. Hosts/painters call this after

package/dist/layout-bridge/sectionColumns.d.ts

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { ColumnLayout } from "../layout-engine/types.js";
-
 //#region src/layout-bridge/sectionColumns.d.ts
 /**
  * Extract column layout from section properties.

package/dist/layout-bridge/tableInsertHover.d.ts

@@ -17,17 +17,21 @@
 declare const TABLE_INSERT_EDGE_PROXIMITY = 30;
 declare const TABLE_INSERT_HIDE_DELAY_MS = 200;
 type TableInsertHoverHit = {
-  type: "row" | "column"; /** Client-coordinate anchor for the button. Caller converts to its UI frame. */
+  type: "row" | "column";
+  /** Client-coordinate anchor for the button. Caller converts to its UI frame. */
   clientX: number;
-  clientY: number; /** PM position of the cell the button targets. */
+  clientY: number;
+  /** PM position of the cell the button targets. */
   cellPmPos: number;
 };
 type TableInsertHoverInput = {
   mouseX: number;
   mouseY: number;
-  pagesContainer: HTMLElement; /** Element under the cursor at the time of the event (e.target). */
+  pagesContainer: HTMLElement;
+  /** Element under the cursor at the time of the event (e.target). */
   target: HTMLElement;
-  hfEditMode: "header" | "footer" | null; /** Override edge proximity in pixels (defaults to TABLE_INSERT_EDGE_PROXIMITY). */
+  hfEditMode: "header" | "footer" | null;
+  /** Override edge proximity in pixels (defaults to TABLE_INSERT_EDGE_PROXIMITY). */
   edgeProximity?: number;
 };
 /**

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

@@ -1,6 +1,5 @@
 import { document_d_exports } from "../types/document.js";
 import { PageHeaderFooterRefs } from "./types.js";
-
 //#region src/layout-engine/headerFooterRefs.d.ts
 declare const resolveSectionHeaderFooterRefs: (documentModel: document_d_exports.Document | null | undefined) => PageHeaderFooterRefs[] | undefined;
 //#endregion

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

@@ -4,7 +4,6 @@ import { KeepNextChain, calculateChainHeight, computeKeepNextChains, getMidChain
 import { resolveSectionHeaderFooterRefs } from "./headerFooterRefs.js";
 import { BreakDecision, SectionState, applyPendingToActive, createInitialSectionState, getEffectiveColumns, getEffectiveMargins, getEffectivePageSize, scheduleSectionBreak } from "./section-breaks.js";
 import { assertExhaustiveFlowBlock, findPageIndexContainingPmPos } from "./pmPageIndex.js";
-
 //#region src/layout-engine/index.d.ts
 type SectionLayoutConfig = {
   pageSize: {

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

@@ -1,5 +1,4 @@
 import { ParagraphAttrs } from "./types.js";
-
 //#region src/layout-engine/justificationCompatibility.d.ts
 declare function resolveJustificationCompatibility(compatibilityMode: number | undefined): NonNullable<ParagraphAttrs["justificationCompatibility"]> | undefined;
 //#endregion

package/dist/layout-engine/keep-together.d.ts

@@ -1,5 +1,4 @@
 import { FlowBlock, Measure } from "./types.js";
-
 //#region src/layout-engine/keep-together.d.ts
 /**
  * A chain of paragraphs that Word keeps with following content. This includes
@@ -7,9 +6,13 @@ import { FlowBlock, Measure } from "./types.js";
  * be stranded at the bottom of a page.
  */
 type KeepNextChain = {
-  /** Index of the first paragraph in the chain. */startIndex: number; /** Index of the last keepNext or pass-through empty member. */
-  endIndex: number; /** All keepNext and pass-through empty paragraph indices in the chain. */
-  memberIndices: number[]; /** Index of the anchor paragraph (first non-keepNext after chain), or -1 if none. */
+  /** Index of the first paragraph in the chain. */
+  startIndex: number;
+  /** Index of the last keepNext or pass-through empty member. */
+  endIndex: number;
+  /** All keepNext and pass-through empty paragraph indices in the chain. */
+  memberIndices: number[];
+  /** Index of the anchor paragraph (first non-keepNext after chain), or -1 if none. */
   anchorIndex: number;
 };
 /**

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

@@ -1,5 +1,4 @@
 import { FlowBlock } from "./types.js";
-
 //#region src/layout-engine/layoutInstrumentation.d.ts
 type LayoutRunReason = "font-ready" | "initial" | "layout-input" | "manual" | "transaction";
 type LayoutPhase = "flow-blocks" | "header-footer" | "initial-fonts" | "layout-document" | "measure-blocks" | "render-pages";

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

@@ -1,5 +1,4 @@
 import { MeasuredLine } from "./types.js";
-
 //#region src/layout-engine/lineFlow.d.ts
 declare function measuredLineAdvance(line: MeasuredLine): number;
 declare function measuredLineRangeHeight(lines: readonly MeasuredLine[], fromLine: number, toLine: number): number;

package/dist/layout-engine/measure/cache.d.ts

@@ -1,5 +1,4 @@
 import { ParagraphBlock, ParagraphMeasure } from "../types.js";
-
 //#region src/layout-engine/measure/cache.d.ts
 /**
  * Get cached text width or return undefined

package/dist/layout-engine/measure/effectiveLineBreakPolicy.d.ts

@@ -1,6 +1,5 @@
 import { ParagraphAttrs, TextRun } from "../types.js";
 import { LineBreakPolicy } from "./lineBreakProvider.js";
-
 //#region src/layout-engine/measure/effectiveLineBreakPolicy.d.ts
 type EffectiveAutomaticHyphenation = Readonly<{
   type: "disabled";
@@ -10,8 +9,11 @@ type EffectiveAutomaticHyphenation = Readonly<{
   hyphenationZoneTwips: number;
 }>;
 type EffectiveLineBreakPolicy = Readonly<{
-  /** Exact provider inputs; omitted OOXML values stay omitted for custom providers. */provider: Readonly<LineBreakPolicy>; /** `w:overflowPunct` defaults to enabled when omitted. */
-  hangingPunctuation: boolean; /** Effective document and paragraph automatic-hyphenation state. */
+  /** Exact provider inputs; omitted OOXML values stay omitted for custom providers. */
+  provider: Readonly<LineBreakPolicy>;
+  /** `w:overflowPunct` defaults to enabled when omitted. */
+  hangingPunctuation: boolean;
+  /** Effective document and paragraph automatic-hyphenation state. */
   automaticHyphenation: EffectiveAutomaticHyphenation;
 }>;
 type ResolveEffectiveLineBreakPolicyOptions = {
@@ -19,10 +21,7 @@ type ResolveEffectiveLineBreakPolicyOptions = {
   run: TextRun;
 };
 /** Resolve all authored line-breaking inputs used while measuring one text run. */
-declare const resolveEffectiveLineBreakPolicy: ({
-  attrs,
-  run
-}: ResolveEffectiveLineBreakPolicyOptions) => EffectiveLineBreakPolicy;
+declare const resolveEffectiveLineBreakPolicy: ({ attrs, run }: ResolveEffectiveLineBreakPolicyOptions) => EffectiveLineBreakPolicy;
 /** Cache fragments for every paragraph attribute consumed by the resolver. */
 declare const lineBreakPolicyCacheParts: (attrs: ParagraphAttrs) => readonly string[];
 //#endregion

package/dist/layout-engine/measure/floatingTablePosition.d.ts

@@ -1,5 +1,4 @@
 import { FloatingTablePosition, TableBlock } from "../types.js";
-
 //#region src/layout-engine/measure/floatingTablePosition.d.ts
 /**
  * X of the table's left edge relative to the content-box left edge, px.

package/dist/layout-engine/measure/floatingZones.d.ts

@@ -16,8 +16,11 @@ type WrapTextDirection = "bothSides" | "left" | "right" | "largest";
  * `rectsToFloatingZones` to derive per-line wrap margins.
  */
 type FloatingExclusionRect = {
-  /** Which side the object is on for simple one-sided wrapping. */side: "left" | "right"; /** X position relative to the content area. */
-  x: number; /** Y position relative to the content area. */
+  /** Which side the object is on for simple one-sided wrapping. */
+  side: "left" | "right";
+  /** X position relative to the content area. */
+  x: number;
+  /** Y position relative to the content area. */
   y: number;
   width: number;
   height: number;
@@ -34,10 +37,15 @@ type FloatingExclusionRect = {
  * correct widths.
  */
 type FloatingImageZone = {
-  /** Left margin reduction (pixels from left edge). */leftMargin: number; /** Right margin reduction (pixels from right edge). */
-  rightMargin: number; /** Top Y coordinate of the exclusion zone. */
-  topY: number; /** Bottom Y coordinate of the exclusion zone. */
-  bottomY: number; /** Optional split segments for centered both-sides wrapping. */
+  /** Left margin reduction (pixels from left edge). */
+  leftMargin: number;
+  /** Right margin reduction (pixels from right edge). */
+  rightMargin: number;
+  /** Top Y coordinate of the exclusion zone. */
+  topY: number;
+  /** Bottom Y coordinate of the exclusion zone. */
+  bottomY: number;
+  /** Optional split segments for centered both-sides wrapping. */
   segments?: FloatingLineSegmentZone[];
   /**
    * Full-width vertical band (OOXML `topAndBottom` wrap): no text fits beside

package/dist/layout-engine/measure/font-metrics.worker.d.ts

@@ -1,5 +1,4 @@
 import { MeasureWorkerRequest, MeasureWorkerResponse } from "./measureWorkerProtocol.js";
-
 //#region src/layout-engine/measure/font-metrics.worker.d.ts
 /**
  * Test-only: reset the cached OffscreenCanvas context. Used by unit

package/dist/layout-engine/measure/lineBreakProvider.d.ts

@@ -8,18 +8,29 @@
  * OOXML line-edge restrictions that are available in the flow model.
  */
 type LineBreakPolicy = {
-  /** BCP-47 language tag resolved from `w:lang` for this run. */locale?: string; /** Apply East Asian first/last-character restrictions (`w:kinsoku`). */
-  kinsoku?: boolean; /** Document replacement list: characters that may not begin a line. */
-  noLineBreaksBefore?: ReadonlySet<string>; /** Document replacement list: characters that may not end a line. */
-  noLineBreaksAfter?: ReadonlySet<string>; /** Use the legacy Ethiopic/Amharic compatibility behavior. */
-  useLegacyEthiopicAmharicRules?: boolean; /** Keep words made entirely of capital letters unhyphenated. */
-  doNotHyphenateCaps?: boolean; /** The run renders with the DOCX all-caps transform. */
+  /** BCP-47 language tag resolved from `w:lang` for this run. */
+  locale?: string;
+  /** Apply East Asian first/last-character restrictions (`w:kinsoku`). */
+  kinsoku?: boolean;
+  /** Document replacement list: characters that may not begin a line. */
+  noLineBreaksBefore?: ReadonlySet<string>;
+  /** Document replacement list: characters that may not end a line. */
+  noLineBreaksAfter?: ReadonlySet<string>;
+  /** Use the legacy Ethiopic/Amharic compatibility behavior. */
+  useLegacyEthiopicAmharicRules?: boolean;
+  /** Keep words made entirely of capital letters unhyphenated. */
+  doNotHyphenateCaps?: boolean;
+  /** The run renders with the DOCX all-caps transform. */
   renderedAllCaps?: boolean;
 };
 type LineBreakProvider = {
-  /** Legal soft-wrap offsets, in ascending UTF-16 order. */findBreaks: (text: string, policy?: LineBreakPolicy) => number[]; /** Grapheme-safe emergency-wrap offsets, in ascending UTF-16 order. */
-  findGraphemeBreaks: (text: string, policy?: LineBreakPolicy) => number[]; /** Dictionary-based discretionary hyphen offsets, in ascending UTF-16 order. */
-  findHyphenationBreaks?: (text: string, policy?: LineBreakPolicy) => number[]; /** Whether a trailing grapheme may overhang the line edge. */
+  /** Legal soft-wrap offsets, in ascending UTF-16 order. */
+  findBreaks: (text: string, policy?: LineBreakPolicy) => number[];
+  /** Grapheme-safe emergency-wrap offsets, in ascending UTF-16 order. */
+  findGraphemeBreaks: (text: string, policy?: LineBreakPolicy) => number[];
+  /** Dictionary-based discretionary hyphen offsets, in ascending UTF-16 order. */
+  findHyphenationBreaks?: (text: string, policy?: LineBreakPolicy) => number[];
+  /** Whether a trailing grapheme may overhang the line edge. */
   isHangingPunctuation?: (text: string, policy?: LineBreakPolicy) => boolean;
 };
 declare const MAX_HYPHENATION_WORD_LENGTH = 256;

package/dist/layout-engine/measure/lineBreaks.d.ts

@@ -1,5 +1,4 @@
 import { LineBreakPolicy } from "./lineBreakProvider.js";
-
 //#region src/layout-engine/measure/lineBreaks.d.ts
 /**
  * Indices in `text` where a line may end. Latin text breaks after

package/dist/layout-engine/measure/listMarkerWidth.d.ts

@@ -1,5 +1,4 @@
 import { ParagraphBlock } from "../types.js";
-
 //#region src/layout-engine/measure/listMarkerWidth.d.ts
 /**
  * OOXML default `w:defaultTabStop` (§17.6.13) when settings.xml omits it.

package/dist/layout-engine/measure/measureBlocks.d.ts

@@ -1,5 +1,6 @@
 import { FlowBlock, Measure, TableBlock, TableMeasure, TextBoxBlock, TextBoxMeasure } from "../types.js";
 import { FloatingImageZone } from "./floatingZones.js";
+import "./measureParagraph.js";
 //#region src/layout-engine/measure/measureBlocks.d.ts
 declare function measureTableBlock(tableBlock: TableBlock, contentWidth: number, fieldValues?: ReadonlyMap<number, string>): TableMeasure;
 type BandPageGeometry = {

package/dist/layout-engine/measure/measureContainer.d.ts

@@ -1,5 +1,4 @@
 import { MeasureProvider } from "./measureProvider.js";
-
 //#region src/layout-engine/measure/measureContainer.d.ts
 /**
  * Get or create a canvas 2D context for text measurement

package/dist/layout-engine/measure/measureHelpers.d.ts

@@ -1,6 +1,5 @@
 import { RunFormatting } from "../types.js";
 import { FontStyle } from "./measureTypes.js";
-
 //#region src/layout-engine/measure/measureHelpers.d.ts
 declare const DEFAULT_FONT_SIZE = 11;
 declare const DEFAULT_FONT_FAMILY = "Calibri";

package/dist/layout-engine/measure/measureParagraph.d.ts

@@ -1,13 +1,14 @@
 import { ParagraphBlock, ParagraphMeasure, TextRun } from "../types.js";
 import { FloatingImageZone } from "./floatingZones.js";
 import { clampFloatingWrapMargins } from "./clampFloatingWrapMargins.js";
-
 //#region src/layout-engine/measure/measureParagraph.d.ts
 /**
  * Options for paragraph measurement
  */
 type MeasureParagraphOptions = {
-  /** Floating image exclusion zones that affect line widths */floatingZones?: FloatingImageZone[]; /** Y offset of this paragraph relative to the exclusion zones (default: 0) */
+  /** Floating image exclusion zones that affect line widths */
+  floatingZones?: FloatingImageZone[];
+  /** Y offset of this paragraph relative to the exclusion zones (default: 0) */
   paragraphYOffset?: number;
   /** Field run `pmStart` -> resolved display text, so a field measures at its
    *  painted width instead of the cached fallback. */