@stll/folio-core 0.15.0 → 0.15.2

package/dist/fields/bookmarkPages.d.ts

@@ -1,5 +1,4 @@
 import { FlowBlock, Page } from "../layout-engine/types.js";
-
 //#region src/fields/bookmarkPages.d.ts
 /**
  * Map each bookmark name to the 1-indexed page its anchoring paragraph lands on,

package/dist/fields/bookmarkText.d.ts

@@ -1,5 +1,4 @@
 import { FlowBlock } from "../layout-engine/types.js";
-
 //#region src/fields/bookmarkText.d.ts
 type BookmarkTextInputs = {
   fieldValues?: ReadonlyMap<number, string>;

package/dist/fields/evaluateField.d.ts

@@ -1,10 +1,12 @@
 import { ParsedFieldInstruction } from "../docx/fieldParser.js";
 import { FieldContext } from "./fieldContext.js";
-
 //#region src/fields/evaluateField.d.ts
 type EvaluateFieldOptions = {
-  /** Shown for unsupported field types and unresolved references. */fallback?: string; /** Run identity (`pmStart`) used to look up a precomputed SEQ value. */
-  instanceId?: number; /** Locked fields preserve their cached result instead of recalculating. */
+  /** Shown for unsupported field types and unresolved references. */
+  fallback?: string;
+  /** Run identity (`pmStart`) used to look up a precomputed SEQ value. */
+  instanceId?: number;
+  /** Locked fields preserve their cached result instead of recalculating. */
   locked?: boolean;
 };
 /**

package/dist/fields/fieldContext.d.ts

@@ -7,14 +7,20 @@
  * layout so a field paints the same value its width was measured against.
  */
 type FieldContext = {
-  /** 1-indexed page the field is on (PAGE). */pageNumber: number; /** Total pages in the document (NUMPAGES). */
+  /** 1-indexed page the field is on (PAGE). */
+  pageNumber: number;
+  /** Total pages in the document (NUMPAGES). */
   totalPages: number;
   /** Pages in the field's current section (SECTIONPAGES); omit until the
    *  per-section page counts are available, in which case the field falls back. */
-  sectionPages?: number; /** Bookmark name -> 1-indexed page it lands on (PAGEREF). */
-  bookmarkPages: ReadonlyMap<string, number>; /** Bookmark name -> resolved display text (REF). */
-  bookmarkText: ReadonlyMap<string, string>; /** Field instance id (the run's `pmStart`) -> precomputed SEQ value. */
-  seqValues: ReadonlyMap<number, number>; /** Clock for DATE/TIME-family fields; passed in so evaluation stays pure. */
+  sectionPages?: number;
+  /** Bookmark name -> 1-indexed page it lands on (PAGEREF). */
+  bookmarkPages: ReadonlyMap<string, number>;
+  /** Bookmark name -> resolved display text (REF). */
+  bookmarkText: ReadonlyMap<string, string>;
+  /** Field instance id (the run's `pmStart`) -> precomputed SEQ value. */
+  seqValues: ReadonlyMap<number, number>;
+  /** Clock for DATE/TIME-family fields; passed in so evaluation stays pure. */
   now: Date;
 };
 //#endregion

package/dist/fields/resolveFieldValues.d.ts

@@ -1,18 +1,19 @@
 import { FlowBlock, Page } from "../layout-engine/types.js";
-
 //#region src/fields/resolveFieldValues.d.ts
 /** Layout-derived inputs shared by every field, regardless of its position. */
 type SharedFieldInputs = {
   totalPages: number;
   bookmarkPages: ReadonlyMap<string, number>;
   bookmarkText: ReadonlyMap<string, string>;
-  seqValues: ReadonlyMap<number, number>; /** Section index -> page count, for SECTIONPAGES. */
+  seqValues: ReadonlyMap<number, number>;
+  /** Section index -> page count, for SECTIONPAGES. */
   sectionPageCounts: ReadonlyMap<number, number>;
   now: Date;
 };
 type HeaderFooterFieldInputs = Pick<SharedFieldInputs, "bookmarkPages" | "bookmarkText" | "seqValues" | "sectionPageCounts">;
 type ResolvedFieldValues = {
-  /** Field run `pmStart` -> resolved display text. */values: Map<number, string>;
+  /** Field run `pmStart` -> resolved display text. */
+  values: Map<number, string>;
   /**
    * True when at least one field resolved to a string that differs from the
    * text it was measured at (`fallback || "1"`), i.e. a re-measure would change

package/dist/fields/sectionPageCounts.d.ts

@@ -1,5 +1,4 @@
 import { Page } from "../layout-engine/types.js";
-
 //#region src/fields/sectionPageCounts.d.ts
 /**
  * Count how many pages belong to each section (by `Page.sectionIndex`, defaulting

package/dist/fields/seqValues.d.ts

@@ -1,5 +1,4 @@
 import { FlowBlock } from "../layout-engine/types.js";
-
 //#region src/fields/seqValues.d.ts
 /**
  * Assign each SEQ field instance its sequence number in document order, keyed by

package/dist/fonts/embeddedFontTable.d.ts

@@ -20,8 +20,11 @@
  */
 /** A single embedded face referenced from a `w:embed*` element. */
 type EmbeddedFontFaceRef = {
-  /** Relationship id (`r:id`) resolved via `word/_rels/fontTable.xml.rels`. */relId: string; /** Obfuscation key GUID (`w:fontKey`), e.g. `{XXXXXXXX-...}`. */
-  fontKey?: string; /** Whether the embedded face is subsetted (`w:subsetted`). */
+  /** Relationship id (`r:id`) resolved via `word/_rels/fontTable.xml.rels`. */
+  relId: string;
+  /** Obfuscation key GUID (`w:fontKey`), e.g. `{XXXXXXXX-...}`. */
+  fontKey?: string;
+  /** Whether the embedded face is subsetted (`w:subsetted`). */
   subsetted?: boolean;
 };
 /** One `<w:font>` entry with whichever of the four embed faces it declares. */

package/dist/fonts/embeddedFonts.d.ts

@@ -31,17 +31,25 @@ type EmbeddedFont = {
    * {@link buildEmbeddedFontFamilyMap}) to resolve document runs, which
    * still reference the font by its original DOCX name, to this family.
    */
-  family: string; /** Original Word font name (`w:font w:name`), before scoping. */
-  originalFamily: string; /** CSS `font-style` the face maps to (`embed*Italic` → `italic`). */
-  style: "normal" | "italic"; /** CSS `font-weight` the face maps to (`embedBold*` → `700`). */
-  weight: 400 | 700; /** De-obfuscated OpenType/TrueType bytes (backed by a fresh, non-shared buffer). */
-  bytes: Uint8Array<ArrayBuffer>; /** Whether the source face was subsetted (`w:subsetted`). */
+  family: string;
+  /** Original Word font name (`w:font w:name`), before scoping. */
+  originalFamily: string;
+  /** CSS `font-style` the face maps to (`embed*Italic` → `italic`). */
+  style: "normal" | "italic";
+  /** CSS `font-weight` the face maps to (`embedBold*` → `700`). */
+  weight: 400 | 700;
+  /** De-obfuscated OpenType/TrueType bytes (backed by a fresh, non-shared buffer). */
+  bytes: Uint8Array<ArrayBuffer>;
+  /** Whether the source face was subsetted (`w:subsetted`). */
   subsetted: boolean;
 };
 /** Already-unzipped package parts the pure extractor needs. */
 type EmbeddedFontParts = {
-  /** Raw `word/fontTable.xml`. */fontTableXml: string | null | undefined; /** Raw `word/_rels/fontTable.xml.rels`. */
-  fontTableRelsXml: string | null | undefined; /** Unzipped font binaries keyed by package path (e.g. `word/fonts/font1.odttf`). */
+  /** Raw `word/fontTable.xml`. */
+  fontTableXml: string | null | undefined;
+  /** Raw `word/_rels/fontTable.xml.rels`. */
+  fontTableRelsXml: string | null | undefined;
+  /** Unzipped font binaries keyed by package path (e.g. `word/fonts/font1.odttf`). */
   fonts: ReadonlyMap<string, ArrayBuffer>;
 };
 /**

package/dist/index.d.ts

@@ -5,6 +5,7 @@ import { ApplyFolioDocumentOperationsOptions, FOLIO_DOCUMENT_OPERATION_BATCH_MOD
 import { createFolioAIEditSnapshot, hashFolioAIBlockText, normalizeFolioAIBlockText } from "./ai-edits/snapshot.js";
 import { DeriveBlockIdInput, FolioBlockId, deriveBlockId, getFolioParaIdFromBlockId, isFolioBlockId, isSequentialFolioBlockId } from "./types/block-id.js";
 import { WordDiffSegment, diffWordSegments } from "./ai-edits/word-diff.js";
+import "./ai-edits/index.js";
 import { AIBarStatus, AIChatMode, AICitation, AICitationSource, AIGenerateInput, AISuggestion, AISuggestionApplyMode, AISuggestionPreset, AISuggestionSeverity, AISuggestionStatus, DEFAULT_AI_SUGGESTION_PRESETS } from "./ai-suggestions/types.js";
 import { ApplyResult, applySuggestions } from "./ai-suggestions/apply.js";
 import { ResolvedAnchor, isSuggestionStale, resolveSuggestionAnchor } from "./ai-suggestions/conflict.js";

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

@@ -1,5 +1,4 @@
 import { EditorState } from "prosemirror-state";
-
 //#region src/layout-bridge/cellSelectionHighlight.d.ts
 /**
  * Apply the `.layout-table-cell-selected` class to painted layout cells

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

@@ -1,13 +1,13 @@
 import { document_d_exports } from "../../types/document.js";
 import { FOOTNOTE_ENTRY_MARGIN_BOTTOM, FOOTNOTE_FALLBACK_LINE_HEIGHT, FOOTNOTE_SEPARATOR_HEIGHT, FlowBlock, FootnoteContent, Measure, Page } from "../../layout-engine/types.js";
 import { ToFlowBlocksOptions } from "./toFlowBlocks.js";
-
 //#region src/layout-bridge/convert/footnoteLayout.d.ts
 type MeasureBlocksFn = (blocks: FlowBlock[], contentWidth: number) => Measure[];
 type ConvertFootnoteOptions = {
   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"];
@@ -48,7 +48,9 @@ type NumberableNote = {
  */
 declare function computeNoteDisplayNumbers(notes: readonly NumberableNote[], refNoteIds: readonly number[]): Map<number, number>;
 type NoteDisplayNumberMaps = {
-  /** footnote `w:id` → sequential display number */footnoteNumbers?: ReadonlyMap<number, number>; /** endnote `w:id` → sequential display number */
+  /** footnote `w:id` → sequential display number */
+  footnoteNumbers?: ReadonlyMap<number, number>;
+  /** endnote `w:id` → sequential display number */
   endnoteNumbers?: ReadonlyMap<number, number>;
 };
 /**

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