@betteroffice/docx 0.0.4 → 0.2.0

package/dist/{content-C3sTRz-u.d.mts → content-CvEtPl0c.d.mts}

@@ -1,4 +1,4 @@
-import { C as ColorValue, y as ThemeColorSlot, a as ParagraphFormatting, b as TextFormatting, c as TableFormatting, d as TableRowFormatting, e as TableCellFormatting, B as BorderSpec, m as ShapeType, k as ShapeFill, l as ShapeOutline, D as ShapeTextBody$1, P as PresetGeometryPathCommand } from './formatting-BEkIBePP.mjs';
+import { C as ColorValue, y as ThemeColorSlot, a as ParagraphFormatting, b as TextFormatting, c as TableFormatting, d as TableRowFormatting, e as TableCellFormatting, B as BorderSpec, m as ShapeType, k as ShapeFill, l as ShapeOutline, D as ShapeTextBody$1, P as PresetGeometryPathCommand } from './formatting-7zKCTu5a.mjs';
 import { WrapType } from './docx/wrapTypes.mjs';
 
 interface ShapeFillPaint {
@@ -233,6 +233,14 @@ interface NumberingInstance {
 interface ListRendering {
     /** Computed marker text (e.g., "1.", "a)", "•") */
     marker: string;
+    /**
+     * Level indents the paragraph inherits when neither direct formatting nor
+     * the style chain sets its own; applied at layout time so the paragraph's
+     * authored properties stay authored.
+     */
+    indentLeft?: number;
+    indentFirstLine?: number;
+    hangingIndent?: boolean;
     /** List level (0-8) */
     level: number;
     /** Numbering ID */
@@ -317,7 +325,7 @@ interface TableCell {
     /** Tracked structural changes (cell insert/delete/merge) */
     structuralChange?: TableStructuralChangeInfo;
     /** Cell content (paragraphs, tables, etc.) */
-    content: (Paragraph | Table)[];
+    content: BlockContent[];
 }
 /**
  * Table row (`w:tr`) — an ordered list of `TableCell` plus row-level
@@ -355,6 +363,11 @@ interface Table {
     rows: TableRow[];
 }
 
+interface RawXml {
+    type: 'rawXml';
+    xml: string;
+}
+
 /**
  * Watermark — the MS Word "Design → Watermark" feature.
  *
@@ -369,8 +382,8 @@ interface Table {
  *   file, scaled, optionally "washed out" (lightened).
  *
  * We model the watermark as a dedicated field on the owning `HeaderFooter`
- * rather than as editable run content, so it stays out of the ProseMirror text
- * flow while still round-tripping through parse → render → serialize.
+ * rather than as editable run content, so it stays out of the text flow while
+ * still round-tripping through parse → render → serialize.
  */
 /**
  * Text watermark (e.g. "CONFIDENTIAL", "DRAFT").
@@ -471,6 +484,11 @@ interface HeaderFooter {
     hdrFtrType: HeaderFooterType;
     /** Content (paragraphs, tables, etc.) */
     content: BlockContent[];
+    /** Root bindings and attributes retained outside the standard boilerplate. */
+    customRootBindings?: {
+        name: string;
+        value: string;
+    }[];
     /**
      * Watermark stored on this header (MS Word "Design → Watermark"). Lives
      * here, not in `content`, so it stays out of the editable text flow while
@@ -540,16 +558,12 @@ interface Footnote {
      * and stays editable on round-trip.
      */
     content: BlockContent[];
-    /**
-     * Verbatim original XML of the entire `<w:footnote>` element, captured at
-     * parse time ONLY when the note body carries a block-level construct the
-     * model still can't represent — note-level bookmarks
-     * (`w:bookmarkStart`/`w:bookmarkEnd`) or `w:customXml`. Block-level `w:sdt`
-     * is NOT a trigger: it round-trips through the model as `BlockSdt`. When
-     * present the serializer re-emits these bytes instead of rebuilding from
-     * `content`, restoring pre-#646 fidelity for the unmodeled constructs.
-     * See `parseNoteBlockContent` / `serializeNote` for the gate (#646 F3).
-     */
+    /** Inherited root bindings required by foreign note content. */
+    customRootBindings?: {
+        name: string;
+        value: string;
+    }[];
+    /** Verbatim note XML for unmodeled bookmarks or custom XML. */
     verbatimXml?: string;
 }
 /**
@@ -567,7 +581,12 @@ interface Endnote {
      * on `Footnote.content`.
      */
     content: BlockContent[];
-    /** Verbatim original XML — see `Footnote.verbatimXml` (#646 F3). */
+    /** Inherited root bindings required by foreign note content. */
+    customRootBindings?: {
+        name: string;
+        value: string;
+    }[];
+    /** Verbatim note XML for unmodeled blocks. */
     verbatimXml?: string;
 }
 
@@ -809,7 +828,7 @@ interface SectionProperties {
 /**
  * Block-level content types
  */
-type BlockContent = Paragraph | Table | BlockSdt;
+type BlockContent = Paragraph | Table | BlockSdt | RawXml;
 /**
  * One section of the document — a `SectionProperties` plus the block
  * content (`Paragraph`s and `Table`s) that lives under those properties.
@@ -845,6 +864,11 @@ interface DocumentBody {
     sections?: Section[];
     /** Final section properties (from body's sectPr) */
     finalSectionProperties?: SectionProperties;
+    /** Root bindings and attributes retained outside the standard boilerplate. */
+    customRootBindings?: {
+        name: string;
+        value: string;
+    }[];
     /** Comments from comments.xml */
     comments?: Comment[];
     /** Stable reviewer palette metadata. Undefined = derive colors by author order. */
@@ -1212,9 +1236,9 @@ interface TrackedChangeInfo {
     date?: string;
 }
 /**
- * Tracked-change attribute triple as it appears on PM node attrs
+ * Tracked-change attribute triple as it appears on node attrs
  * (`paragraph.pPrIns`, `tableRow.trIns`, etc). Mirrors `TrackedChangeInfo`
- * but with a `null` date (PM attr defaults) and a `revisionId` name that
+ * but with a `null` date (attr defaults) and a `revisionId` name that
  * matches OOXML's `w:id` more idiomatically on the editor side.
  *
  * Round-trip pairs with `TrackedChangeInfo` via
@@ -1227,7 +1251,7 @@ interface RevisionInfo {
 }
 /**
  * Tracked-cell marker — the OOXML `<w:cellIns>` / `<w:cellDel>` /
- * `<w:cellMerge>` shape attached to a `TableCell` PM node and surfaced
+ * `<w:cellMerge>` shape attached to a `TableCell` node and surfaced
  * to the layout model and painter for visual rendering.
  *
  * `kind` matches the OOXML element name (ins / del / merge).
@@ -1475,6 +1499,18 @@ interface NoteRefMarkContent {
 interface SeparatorContent {
     type: 'separator' | 'continuationSeparator';
 }
+interface HorizontalRuleContent {
+    type: 'horizontalRule';
+    rule: {
+        width: number | null;
+        widthPercent: number | null;
+        height: number;
+        alignment: string;
+        noShade: boolean;
+        color: string;
+        xml: string;
+    };
+}
 /** Legacy `w:ffData` projected as inert form-control state. */
 interface FieldFormData {
     name?: string;
@@ -1561,7 +1597,7 @@ interface ChartContent {
 /**
  * All possible run content types
  */
-type RunContent = TextContent | TabContent | BreakContent | SymbolContent | NoteReferenceContent | NoteRefMarkContent | SeparatorContent | CommentReferenceContent | FieldCharContent | InstrTextContent | SoftHyphenContent | NoBreakHyphenContent | DrawingContent | ShapeContent | ChartContent;
+type RunContent = TextContent | TabContent | BreakContent | SymbolContent | NoteReferenceContent | NoteRefMarkContent | SeparatorContent | HorizontalRuleContent | CommentReferenceContent | FieldCharContent | InstrTextContent | SoftHyphenContent | NoBreakHyphenContent | DrawingContent | ShapeContent | ChartContent;
 /**
  * A run (`w:r`) — a contiguous span of inline content sharing one set of
  * character properties (bold, italic, font, color, etc.). Runs are the
@@ -1603,7 +1639,7 @@ interface Run {
  * this union carries a `type` discriminator so consumers can narrow at
  * runtime.
  */
-type ParagraphContent = Run | Hyperlink | BookmarkStart | BookmarkEnd | SimpleField | ComplexField | InlineSdt | CommentRangeStart | CommentRangeEnd | Insertion | Deletion | MoveFrom | MoveTo | MoveFromRangeStart | MoveFromRangeEnd | MoveToRangeStart | MoveToRangeEnd | MathEquation;
+type ParagraphContent = Run | Hyperlink | BookmarkStart | BookmarkEnd | SimpleField | ComplexField | InlineSdt | CommentRangeStart | CommentRangeEnd | Insertion | Deletion | MoveFrom | MoveTo | MoveFromRangeStart | MoveFromRangeEnd | MoveToRangeStart | MoveToRangeEnd | MathEquation | RawXml;
 /**
  * Paragraph (`w:p`) — the primary block-level container in a Word document.
  *
@@ -1918,6 +1954,8 @@ interface Image {
     padding?: ImagePadding;
     /** Source-image crop (fractional, OOXML `a:srcRect`). */
     crop?: ImageCrop;
+    /** Picture preset geometry; undefined means rect. */
+    shapeType?: string;
     /** Opacity in [0, 1] (OOXML `a:alphaModFix amt`). Undefined = fully opaque. */
     opacity?: number;
     /** Whether this is a decorative image */
@@ -1977,6 +2015,36 @@ interface ChartPoint {
     };
     label?: string;
 }
+/** Run properties from a `c:txPr`; unset fields inherit from the chart. */
+interface ChartTextProperties {
+    font?: string;
+    sizePt?: number;
+    bold?: boolean;
+    italic?: boolean;
+    color?: string;
+    spacingPt?: number;
+}
+/** One `c:dLbl`: an index plus the switches it overrides. */
+interface ChartPointLabel {
+    index?: number;
+    text?: string;
+    labels: ChartDataLabels;
+}
+/** A `c:dLbls`; every switch is optional so an unset one inherits. */
+interface ChartDataLabels {
+    delete?: boolean;
+    showValue?: boolean;
+    showCategoryName?: boolean;
+    showSeriesName?: boolean;
+    showPercent?: boolean;
+    showLegendKey?: boolean;
+    showBubbleSize?: boolean;
+    separator?: string;
+    position?: string;
+    numberFormat?: string;
+    text?: ChartTextProperties;
+    points?: ChartPointLabel[];
+}
 interface ChartSeries {
     name?: string;
     categories: string[];
@@ -1995,6 +2063,11 @@ interface ChartSeries {
         color?: string;
     };
     smooth?: boolean;
+    /** `c:xVal` of a scatter or bubble series. */
+    xValues?: number[];
+    /** `c:bubbleSize` of a bubble series. */
+    bubbleSizes?: number[];
+    dataLabels?: ChartDataLabels;
 }
 interface ChartAxis {
     id?: string;
@@ -2016,6 +2089,9 @@ interface ChartAxis {
     minorTickMark?: string;
     tickLabelPosition?: string;
     hidden?: boolean;
+    majorGridlines?: boolean;
+    minorGridlines?: boolean;
+    text?: ChartTextProperties;
 }
 /** One chart-family element inside `c:plotArea`. */
 interface ChartPlotGroup {
@@ -2029,10 +2105,27 @@ interface ChartPlotGroup {
     firstSliceAngle?: number;
     holeSize?: number;
     showDataLabels?: boolean;
+    /** `c:scatterStyle`. */
+    scatterStyle?: 'none' | 'line' | 'lineMarker' | 'marker' | 'smooth' | 'smoothMarker';
+    /** `c:radarStyle`. */
+    radarStyle?: 'standard' | 'marker' | 'filled';
+    /** `c:bubbleScale`, a percentage of the default bubble size. */
+    bubbleScale?: number;
+    /** `c:sizeRepresents`. */
+    sizeRepresents?: 'area' | 'w';
+    /** `c:wireframe` of a surface chart. */
+    wireframe?: boolean;
+    hiLowLines?: boolean;
+    upDownBars?: boolean;
+    /** `c:marker` of a line chart, which switches every series marker off. */
+    marker?: boolean;
+    dataLabels?: ChartDataLabels;
 }
 interface ChartLegend {
     position?: 'left' | 'right' | 'top' | 'bottom';
     visible?: boolean;
+    /** `c:txPr` on the legend; unset fields inherit from the chart. */
+    text?: ChartTextProperties;
 }
 interface Chart {
     type: 'chart';
@@ -2064,6 +2157,15 @@ interface Chart {
     decorative?: boolean;
     /** Stable z-order for anchored charts. Undefined = source order. */
     relativeHeight?: number;
+    /** `c:txPr` on `c:chartSpace`: the root of chart text inheritance. */
+    text?: ChartTextProperties;
+    /** `c:txPr` on `c:title`. */
+    titleText?: ChartTextProperties;
+    /**
+     * The `w:drawing` that places the chart, replayed verbatim on save. Absent
+     * on package-level entries, which no drawing owns.
+     */
+    drawingXml?: string;
 }
 
-export { type FooterReference as $, type AbstractNumbering as A, type BlockContent as B, type CellMarker as C, type DrawingScene as D, type EndnoteProperties as E, type FootnoteProperties as F, type CommentRangeEnd as G, type HeaderFooter as H, type CommentRangeStart as I, type CommentReferenceContent as J, type ComplexField as K, type ContentPosition as L, DEFAULT_WATERMARK_PRESETS as M, type NoteKind as N, type Deletion as O, type Paragraph as P, type DrawingContent as Q, type RevisionInfo as R, type SectionProperties as S, type DrawingSceneNode as T, type EndnotePosition as U, type Field as V, type Watermark as W, type FieldCharContent as X, type FieldFormData as Y, type FieldInlineContent as Z, type FieldType as _, type SdtControlState as a, type SymbolContent as a$, type FootnotePosition as a0, type HeaderFooterType as a1, type HeaderReference as a2, type Hyperlink as a3, type HyperlinkContent as a4, type Image as a5, type ImageCrop as a6, type ImageEffect as a7, type ImageHyperlink as a8, type ImagePadding as a9, type NumberingInstance as aA, type PageNumberingProperties as aB, type PageOrientation as aC, type ParagraphContent as aD, type ParagraphPropertyChange as aE, type PictureWatermark as aF, type PropertyChangeInfo as aG, type Run as aH, type RunContent as aI, type RunPropertyChange as aJ, type SdtCheckboxGlyph as aK, type SdtDataBinding as aL, type SdtDateState as aM, type SdtGalleryState as aN, type SdtType as aO, type Section as aP, type SectionStart as aQ, type SeparatorContent as aR, type Shape as aS, type ShapeContent as aT, type ShapeFillPaint as aU, type ShapeStrokePaint as aV, type ShapeTextBody as aW, type SimpleField as aX, type SoftHyphenContent as aY, type StructuredFieldContent as aZ, type StructuredFieldTree as a_, type ImagePosition as aa, type ImageRotationBounds as ab, type ImageSize as ac, type ImageTransform as ad, type ImageWrap as ae, type ImageWrapPoint as af, type InlineSdt as ag, type Insertion as ah, type InstrTextContent as ai, type LevelSuffix as aj, type LineNumberRestart as ak, type ListLevel as al, type ListRendering as am, type MathEquation as an, type MoveFrom as ao, type MoveFromRangeEnd as ap, type MoveFromRangeStart as aq, type MoveTo as ar, type MoveToRangeEnd as as, type MoveToRangeStart as at, type NoBreakHyphenContent as au, type NoteNumberRestart as av, type NoteRefMarkContent as aw, type NoteReferenceContent as ax, type NoteSeparatorReference as ay, type NumberFormat as az, type SdtProperties as b, type TabContent as b0, type Table as b1, type TableCell as b2, type TableCellPropertyChange as b3, type TablePropertyChange as b4, type TableRow as b5, type TableRowPropertyChange as b6, type TableStructuralChangeInfo as b7, type TextBox as b8, type TextContent as b9, type TextWatermark as ba, type TrackedChangeInfo as bb, type TrackedRunChange as bc, type VerticalAlign as bd, pictureWatermarkDisplayEmu as be, type ShapeEffect as c, type ShapeTextBodyProperties as d, type Chart as e, type Comment as f, type DocumentBody as g, type NumberingDefinitions as h, type Footnote as i, type Endnote as j, type BookmarkRange as k, type BlockSdt as l, type BookmarkEnd as m, type BookmarkStart as n, type BreakContent as o, type ChartAxis as p, type ChartContent as q, type ChartGrouping as r, type ChartLegend as s, type ChartPlotGroup as t, type ChartPoint as u, type ChartSeries as v, type ChartType as w, type Column as x, type CommentAnchorRange as y, type CommentAuthor as z };
+export { type FieldInlineContent as $, type AbstractNumbering as A, type BlockContent as B, type CellMarker as C, type DrawingScene as D, type EndnoteProperties as E, type FootnoteProperties as F, type CommentAnchorRange as G, type HeaderFooter as H, type CommentAuthor as I, type CommentRangeEnd as J, type CommentRangeStart as K, type CommentReferenceContent as L, type ComplexField as M, type NoteKind as N, type ContentPosition as O, type Paragraph as P, DEFAULT_WATERMARK_PRESETS as Q, type RevisionInfo as R, type SdtControlState as S, type Deletion as T, type DrawingContent as U, type DrawingSceneNode as V, type Watermark as W, type EndnotePosition as X, type Field as Y, type FieldCharContent as Z, type FieldFormData as _, type SdtProperties as a, type SoftHyphenContent as a$, type FieldType as a0, type FooterReference as a1, type FootnotePosition as a2, type HeaderFooterType as a3, type HeaderReference as a4, type HorizontalRuleContent as a5, type Hyperlink as a6, type HyperlinkContent as a7, type Image as a8, type ImageCrop as a9, type NoteReferenceContent as aA, type NoteSeparatorReference as aB, type NumberFormat as aC, type NumberingInstance as aD, type PageNumberingProperties as aE, type PageOrientation as aF, type ParagraphContent as aG, type ParagraphPropertyChange as aH, type PictureWatermark as aI, type PropertyChangeInfo as aJ, type Run as aK, type RunContent as aL, type RunPropertyChange as aM, type SdtCheckboxGlyph as aN, type SdtDataBinding as aO, type SdtDateState as aP, type SdtGalleryState as aQ, type SdtType as aR, type Section as aS, type SectionStart as aT, type SeparatorContent as aU, type Shape as aV, type ShapeContent as aW, type ShapeFillPaint as aX, type ShapeStrokePaint as aY, type ShapeTextBody as aZ, type SimpleField as a_, type ImageEffect as aa, type ImageHyperlink as ab, type ImagePadding as ac, type ImagePosition as ad, type ImageRotationBounds as ae, type ImageSize as af, type ImageTransform as ag, type ImageWrap as ah, type ImageWrapPoint as ai, type InlineSdt as aj, type Insertion as ak, type InstrTextContent as al, type LevelSuffix as am, type LineNumberRestart as an, type ListLevel as ao, type ListRendering as ap, type MathEquation as aq, type MoveFrom as ar, type MoveFromRangeEnd as as, type MoveFromRangeStart as at, type MoveTo as au, type MoveToRangeEnd as av, type MoveToRangeStart as aw, type NoBreakHyphenContent as ax, type NoteNumberRestart as ay, type NoteRefMarkContent as az, type ShapeEffect as b, type StructuredFieldContent as b0, type StructuredFieldTree as b1, type SymbolContent as b2, type TabContent as b3, type Table as b4, type TableCell as b5, type TableCellPropertyChange as b6, type TablePropertyChange as b7, type TableRow as b8, type TableRowPropertyChange as b9, type TableStructuralChangeInfo as ba, type TextBox as bb, type TextContent as bc, type TextWatermark as bd, type TrackedChangeInfo as be, type TrackedRunChange as bf, type VerticalAlign as bg, pictureWatermarkDisplayEmu as bh, type RawXml as bi, type ShapeTextBodyProperties as c, type Chart as d, type Comment as e, type SectionProperties as f, type DocumentBody as g, type NumberingDefinitions as h, type Footnote as i, type Endnote as j, type BookmarkRange as k, type BlockSdt as l, type BookmarkEnd as m, type BookmarkStart as n, type BreakContent as o, type ChartAxis as p, type ChartContent as q, type ChartDataLabels as r, type ChartGrouping as s, type ChartLegend as t, type ChartPlotGroup as u, type ChartPoint as v, type ChartPointLabel as w, type ChartSeries as x, type ChartType as y, type Column as z };

package/dist/core.d.mts

@@ -1,15 +1,15 @@
-export { a as attemptSelectiveSave, c as createDocx, p as parseDocx, r as repackDocx, u as updateMultipleFiles } from './selectiveSave-CVoajSKE.mjs';
+export { a as attemptSelectiveSave, c as createDocx, p as parseDocx, r as repackDocx, u as updateMultipleFiles } from './selectiveSave-CRh-_Y_C.mjs';
 import { Document } from './types/document.mjs';
 export { DocxPackage } from './types/document.mjs';
-import { g as DocumentBody, S as SectionProperties, b1 as Table } from './content-C3sTRz-u.mjs';
-export { B as BlockContent, m as BookmarkEnd, n as BookmarkStart, f as Comment, G as CommentRangeEnd, I as CommentRangeStart, O as Deletion, j as Endnote, V as Field, $ as FooterReference, i as Footnote, H as HeaderFooter, a2 as HeaderReference, a3 as Hyperlink, a5 as Image, ah as Insertion, al as ListLevel, ao as MoveFrom, ar as MoveTo, h as NumberingDefinitions, P as Paragraph, aD as ParagraphContent, aH as Run, aI as RunContent, aS as Shape, b2 as TableCell, b5 as TableRow, b8 as TextBox, b9 as TextContent, bb as TrackedChangeInfo, bc as TrackedRunChange } from './content-C3sTRz-u.mjs';
+import { g as DocumentBody, f as SectionProperties, b4 as Table } from './content-CvEtPl0c.mjs';
+export { B as BlockContent, m as BookmarkEnd, n as BookmarkStart, e as Comment, J as CommentRangeEnd, K as CommentRangeStart, T as Deletion, j as Endnote, Y as Field, a1 as FooterReference, i as Footnote, H as HeaderFooter, a4 as HeaderReference, a6 as Hyperlink, a8 as Image, ak as Insertion, ao as ListLevel, ar as MoveFrom, au as MoveTo, h as NumberingDefinitions, P as Paragraph, aG as ParagraphContent, aK as Run, aL as RunContent, aV as Shape, b5 as TableCell, b8 as TableRow, bb as TextBox, bc as TextContent, be as TrackedChangeInfo, bf as TrackedRunChange } from './content-CvEtPl0c.mjs';
 export { emuToPixels, emuToTwips, formatPx, halfPointsToPixels, pixelsToEmu, pixelsToTwips, pointsToPixels, twipsToEmu, twipsToPixels } from './utils/units.mjs';
-export { T as ThemeMatrixCell, b as blendColors, c as canRenderFont, a as colorsEqual, d as createRgbColor, e as createThemeColor, f as darkenColor, g as ensureHexPrefix, h as generateThemeTintShadeMatrix, i as getContrastingColor, j as getLoadedFonts, k as getThemeTintShadeHex, l as isBlack, m as isFontLoaded, n as isFontsLoading, o as isGoogleFontsEnabled, p as isWhite, q as lightenColor, r as loadFont, s as loadFontFromBuffer, t as loadFonts, u as onFontsLoaded, v as parseColorString, w as preloadCommonFonts, x as resolveColor, y as resolveHighlightColor, z as resolveHighlightToCss, A as resolveShadingColor, B as setGoogleFontsEnabled } from './fontLoader-CMH3bZ2Z.mjs';
+export { T as ThemeMatrixCell, b as blendColors, c as canRenderFont, a as colorsEqual, d as createRgbColor, e as createThemeColor, f as darkenColor, g as ensureHexPrefix, h as generateThemeTintShadeMatrix, i as getContrastingColor, j as getLoadedFonts, k as getThemeTintShadeHex, l as isBlack, m as isFontLoaded, n as isFontsLoading, o as isGoogleFontsEnabled, p as isWhite, q as lightenColor, r as loadFont, s as loadFontFromBuffer, t as loadFonts, u as onFontsLoaded, v as parseColorString, w as preloadCommonFonts, x as resolveColor, y as resolveHighlightColor, z as resolveHighlightToCss, A as resolveShadingColor, B as setGoogleFontsEnabled } from './fontLoader-b8eicJKV.mjs';
 export { D as DocxInput, t as toArrayBuffer } from './docxInput-DTbCa48g.mjs';
 export { EditorPluginCore, PanelConfig, PluginPanelProps, PositionCoordinates, RenderedDomContext } from './plugin-api/index.mjs';
-export { B as BlockExtent, F as FootnoteContent, a as Layout, L as LayoutBlock, P as Page, R as ResolvedLine, c as ResolvedSegment } from './types-C1rv3KM-.mjs';
-export { a as ParagraphFormatting, b as TextFormatting, f as Theme, x as ThemeColorScheme, z as ThemeFont, A as ThemeFontScheme } from './formatting-BEkIBePP.mjs';
-export { d as Relationship, a as Style, S as StyleDefinitions } from './styles-BK3Jecxs.mjs';
+export { B as BlockExtent, F as FootnoteContent, L as Layout, b as LayoutBlock, P as Page, R as ResolvedLine, c as ResolvedSegment } from './types-C4A8mWjU.mjs';
+export { a as ParagraphFormatting, b as TextFormatting, f as Theme, x as ThemeColorScheme, z as ThemeFont, A as ThemeFontScheme } from './formatting-7zKCTu5a.mjs';
+export { d as Relationship, a as Style, S as StyleDefinitions } from './styles-7e-mq3c-.mjs';
 import './docx/wrapTypes.mjs';
 
 /**
@@ -253,6 +253,6 @@ declare class ErrorManager extends Subscribable<ErrorManagerSnapshot> {
  * @packageDocumentation
  * @public
  */
-declare const VERSION = "0.0.2";
+declare const VERSION: string;
 
 export { type CellCoordinates, Document, DocumentBody, ErrorManager, type ErrorManagerSnapshot, type ErrorNotification, type ErrorSeverity, type PrintOptions, SectionProperties, Subscribable, TABLE_DATA_ATTRIBUTES, Table, TableSelectionManager, type TableSelectionSnapshot, VERSION, deleteTableFromDocument, findTableFromClick, formatPageRange, getDefaultPrintOptions, getTableFromDocument, isPrintSupported, openPrintWindow, parsePageRange, serializeDocumentBody, serializeDocument as serializeDocx, serializeSectionProperties, triggerPrint, updateTableInDocument };

package/dist/core.mjs

@@ -1 +1 @@
-export{i as attemptSelectiveSave,h as createDocx,a as parseDocx,f as repackDocx,c as serializeDocumentBody,b as serializeDocx,d as serializeSectionProperties,g as updateMultipleFiles}from'./chunk-NTSSE5QK.mjs';export{f as blendColors,r as colorsEqual,o as createRgbColor,n as createThemeColor,d as darkenColor,p as ensureHexPrefix,h as generateThemeTintShadeMatrix,c as getContrastingColor,g as getThemeTintShadeHex,k as isBlack,l as isWhite,e as lightenColor,m as parseColorString,a as resolveColor,i as resolveHighlightColor,q as resolveHighlightToCss,j as resolveShadingColor}from'./chunk-LTVVQMHB.mjs';export{b as emuToPixels,i as emuToTwips,q as formatPx,k as halfPointsToPixels,c as pixelsToEmu,h as pixelsToTwips,d as pointsToPixels,j as twipsToEmu,g as twipsToPixels}from'./chunk-CTBUQRYQ.mjs';export{n as canRenderFont,k as getLoadedFonts,g as isFontLoaded,j as isFontsLoading,i as isGoogleFontsEnabled,e as loadFont,o as loadFontFromBuffer,f as loadFonts,l as onFontsLoaded,v as preloadCommonFonts,h as setGoogleFontsEnabled,a as toArrayBuffer}from'./chunk-YTILOUAA.mjs';import'./chunk-6KDV6AIL.mjs';import'./chunk-NJHOPXZW.mjs';import'./chunk-B4IR6YP4.mjs';import'./chunk-T4EZMUXM.mjs';import {b as b$1}from'./chunk-TTRUPDAB.mjs';var ce={includeHeaders:true,includeFooters:true,includePageNumbers:true,pageRange:null,scale:1,printBackground:true,margins:"default"};function me(){return {...ce}}function de(){typeof window<"u"&&window.print();}var fe="@media print { body { margin: 0; padding: 0; } @page { margin: 0; } }";function ge(t="Document",r){if(typeof window>"u")return null;let e=window.open("","_blank");if(!e)return null;e.opener=null;let n=e.document;n.title=t;let o=n.createElement("style");o.textContent=fe,n.head.appendChild(o);let i=new DOMParser().parseFromString(r,"text/html");for(let l of Array.from(i.body.childNodes))n.body.appendChild(n.importNode(l,true));return e}function he(t,r){if(!t||!t.trim())return null;let e=t.trim();if(/^\d+$/.test(e)){let o=parseInt(e,10);return o>=1&&o<=r?{start:o,end:o}:null}let n=e.match(/^(\d+)-(\d+)$/);if(n){let o=parseInt(n[1],10),i=parseInt(n[2],10);if(o>=1&&i<=r&&o<=i)return {start:o,end:i}}return null}function Te(t,r){return t?t.start===t.end?`Page ${t.start}`:`Pages ${t.start}-${t.end}`:`All (${r} pages)`}function be(){return typeof window<"u"&&typeof window.print=="function"}var s=class{constructor(r){b$1(this,"listeners",new Set);b$1(this,"snapshot");b$1(this,"subscribe",r=>(this.listeners.add(r),()=>{this.listeners.delete(r);}));b$1(this,"getSnapshot",()=>this.snapshot);this.snapshot=r;}setSnapshot(r){this.snapshot=r,this.notify();}notify(){for(let r of this.listeners)r();}};var c={TABLE_INDEX:"data-table-index",ROW_INDEX:"data-row",COLUMN_INDEX:"data-col",TABLE_CELL:"data-table-cell"};function g(t,r){if(!(t instanceof Element))return null;let e=t;for(;e&&e!==r;){if(e.tagName==="TD"||e.tagName==="TH"){let n=e.getAttribute(c.ROW_INDEX),o=e.getAttribute(c.COLUMN_INDEX);if(n!==null&&o!==null){let i=e;for(;i&&i!==r;){if(i.tagName==="TABLE"){let l=i.getAttribute(c.TABLE_INDEX);if(l!==null)return {tableIndex:parseInt(l,10),rowIndex:parseInt(n,10),columnIndex:parseInt(o,10)};break}i=i.parentElement;}}break}e=e.parentElement;}return null}function h(t,r){if(!t.package?.document?.content)return null;let e=0;for(let n of t.package.document.content)if(n.type==="table"){if(e===r)return n;e++;}return null}function T(t,r,e){if(!t.package?.document?.content)return t;let n=0,o=t.package.document.content.map(i=>{if(i.type==="table"){if(n===r)return n++,e;n++;}return i});return {...t,package:{...t.package,document:{...t.package.document,content:o}}}}function b(t,r){if(!t.package?.document?.content)return t;let e=0,n=t.package.document.content.filter(o=>{if(o.type==="table"){let i=e===r;return e++,!i}return  true});return {...t,package:{...t.package,document:{...t.package.document,content:n}}}}var m=class extends s{constructor(){super({selectedCell:null});}selectCell(r){this.setSnapshot({selectedCell:r});}clearSelection(){this.setSnapshot({selectedCell:null});}isCellSelected(r,e,n){let{selectedCell:o}=this.getSnapshot();return o?o.tableIndex===r&&o.rowIndex===e&&o.columnIndex===n:false}getSelectedCell(){return this.getSnapshot().selectedCell}};var d=class extends s{constructor(){super({notifications:[]});b$1(this,"notifications",[]);b$1(this,"idCounter",0);b$1(this,"timers",new Set);}showError(e,n){return this.addNotification(e,"error",n)}showWarning(e,n){return this.addNotification(e,"warning",n)}showInfo(e,n){return this.addNotification(e,"info",n)}dismiss(e){this.notifications=this.notifications.map(o=>o.id===e?{...o,dismissed:true}:o),this.emitSnapshot();let n=setTimeout(()=>{this.timers.delete(n),this.notifications=this.notifications.filter(o=>o.id!==e),this.emitSnapshot();},300);this.timers.add(n);}clearAll(){this.notifications=[];for(let e of this.timers)clearTimeout(e);this.timers.clear(),this.emitSnapshot();}destroy(){for(let e of this.timers)clearTimeout(e);this.timers.clear(),this.notifications=[];}addNotification(e,n,o){let i=`error-${++this.idCounter}-${Date.now()}`,l={id:i,message:e,severity:n,details:o,timestamp:Date.now()};if(this.notifications=[...this.notifications,l],this.emitSnapshot(),n!=="error"){let f=setTimeout(()=>{this.timers.delete(f),this.dismiss(i);},5e3);this.timers.add(f);}return i}emitSnapshot(){this.setSnapshot({notifications:this.notifications});}};var Me="0.0.2";export{d as ErrorManager,s as Subscribable,c as TABLE_DATA_ATTRIBUTES,m as TableSelectionManager,Me as VERSION,b as deleteTableFromDocument,g as findTableFromClick,Te as formatPageRange,me as getDefaultPrintOptions,h as getTableFromDocument,be as isPrintSupported,ge as openPrintWindow,he as parsePageRange,de as triggerPrint,T as updateTableInDocument};
+export{i as attemptSelectiveSave,h as createDocx,a as parseDocx,f as repackDocx,c as serializeDocumentBody,b as serializeDocx,d as serializeSectionProperties,g as updateMultipleFiles}from'./chunk-AFMVSI4Z.mjs';export{f as blendColors,r as colorsEqual,o as createRgbColor,n as createThemeColor,d as darkenColor,p as ensureHexPrefix,h as generateThemeTintShadeMatrix,c as getContrastingColor,g as getThemeTintShadeHex,k as isBlack,l as isWhite,e as lightenColor,m as parseColorString,a as resolveColor,i as resolveHighlightColor,q as resolveHighlightToCss,j as resolveShadingColor}from'./chunk-LTVVQMHB.mjs';export{b as emuToPixels,i as emuToTwips,q as formatPx,k as halfPointsToPixels,c as pixelsToEmu,h as pixelsToTwips,d as pointsToPixels,j as twipsToEmu,g as twipsToPixels}from'./chunk-CTBUQRYQ.mjs';export{n as canRenderFont,k as getLoadedFonts,g as isFontLoaded,j as isFontsLoading,i as isGoogleFontsEnabled,e as loadFont,o as loadFontFromBuffer,f as loadFonts,l as onFontsLoaded,v as preloadCommonFonts,h as setGoogleFontsEnabled,a as toArrayBuffer}from'./chunk-JHJLG4I6.mjs';import'./chunk-6LQJAKOC.mjs';import'./chunk-HLDJMU3R.mjs';import'./chunk-ACGKK7IB.mjs';import'./chunk-5F6DLQZP.mjs';import {b as b$1}from'./chunk-TTRUPDAB.mjs';var g="0.2.0";var ct={includeHeaders:true,includeFooters:true,includePageNumbers:true,pageRange:null,scale:1,printBackground:true,margins:"default"};function ft(){return {...ct}}function gt(){typeof window<"u"&&window.print();}var yt="@media print { body { margin: 0; padding: 0; } @page { margin: 0; } }";function xt(e="Document",s){if(typeof window>"u")return null;let t=window.open("","_blank");if(!t)return null;t.opener=null;let i=t.document;i.title=e;let o=i.createElement("style");o.textContent=yt,i.head.appendChild(o);let n=new DOMParser().parseFromString(s,"text/html");for(let l of Array.from(n.body.childNodes))i.body.appendChild(i.importNode(l,true));return t}function ht(e,s){if(!e||!e.trim())return null;let t=e.trim();if(/^\d+$/.test(t)){let o=parseInt(t,10);return o>=1&&o<=s?{start:o,end:o}:null}let i=t.match(/^(\d+)-(\d+)$/);if(i){let o=parseInt(i[1],10),n=parseInt(i[2],10);if(o>=1&&n<=s&&o<=n)return {start:o,end:n}}return null}function bt(e,s){return e?e.start===e.end?`Page ${e.start}`:`Pages ${e.start}-${e.end}`:`All (${s} pages)`}function Tt(){return typeof window<"u"&&typeof window.print=="function"}var a=class{constructor(s){b$1(this,"listeners",new Set);b$1(this,"snapshot");b$1(this,"subscribe",s=>(this.listeners.add(s),()=>{this.listeners.delete(s);}));b$1(this,"getSnapshot",()=>this.snapshot);this.snapshot=s;}setSnapshot(s){this.snapshot=s,this.notify();}notify(){for(let s of this.listeners)s();}};var m={TABLE_INDEX:"data-table-index",ROW_INDEX:"data-row",COLUMN_INDEX:"data-col",TABLE_CELL:"data-table-cell"};function y(e,s){if(!(e instanceof Element))return null;let t=e;for(;t&&t!==s;){if(t.tagName==="TD"||t.tagName==="TH"){let i=t.getAttribute(m.ROW_INDEX),o=t.getAttribute(m.COLUMN_INDEX);if(i!==null&&o!==null){let n=t;for(;n&&n!==s;){if(n.tagName==="TABLE"){let l=n.getAttribute(m.TABLE_INDEX);if(l!==null)return {tableIndex:parseInt(l,10),rowIndex:parseInt(i,10),columnIndex:parseInt(o,10)};break}n=n.parentElement;}}break}t=t.parentElement;}return null}function x(e,s){if(!e.package?.document?.content)return null;let t=0;for(let i of e.package.document.content)if(i.type==="table"){if(t===s)return i;t++;}return null}function h(e,s,t){if(!e.package?.document?.content)return e;let i=0,o=e.package.document.content.map(n=>{if(n.type==="table"){if(i===s)return i++,t;i++;}return n});return {...e,package:{...e.package,document:{...e.package.document,content:o}}}}function b(e,s){if(!e.package?.document?.content)return e;let t=0,i=e.package.document.content.filter(o=>{if(o.type==="table"){let n=t===s;return t++,!n}return  true});return {...e,package:{...e.package,document:{...e.package.document,content:i}}}}var u=class extends a{constructor(){super({selectedCell:null});}selectCell(s){this.setSnapshot({selectedCell:s});}clearSelection(){this.setSnapshot({selectedCell:null});}isCellSelected(s,t,i){let{selectedCell:o}=this.getSnapshot();return o?o.tableIndex===s&&o.rowIndex===t&&o.columnIndex===i:false}getSelectedCell(){return this.getSnapshot().selectedCell}};var c=class extends a{constructor(){super({notifications:[]});b$1(this,"notifications",[]);b$1(this,"idCounter",0);b$1(this,"timers",new Set);}showError(t,i){return this.addNotification(t,"error",i)}showWarning(t,i){return this.addNotification(t,"warning",i)}showInfo(t,i){return this.addNotification(t,"info",i)}dismiss(t){this.notifications=this.notifications.map(o=>o.id===t?{...o,dismissed:true}:o),this.emitSnapshot();let i=setTimeout(()=>{this.timers.delete(i),this.notifications=this.notifications.filter(o=>o.id!==t),this.emitSnapshot();},300);this.timers.add(i);}clearAll(){this.notifications=[];for(let t of this.timers)clearTimeout(t);this.timers.clear(),this.emitSnapshot();}destroy(){for(let t of this.timers)clearTimeout(t);this.timers.clear(),this.notifications=[];}addNotification(t,i,o){let n=`error-${++this.idCounter}-${Date.now()}`,l={id:n,message:t,severity:i,details:o,timestamp:Date.now()};if(this.notifications=[...this.notifications,l],this.emitSnapshot(),i!=="error"){let f=setTimeout(()=>{this.timers.delete(f),this.dismiss(n);},5e3);this.timers.add(f);}return n}emitSnapshot(){this.setSnapshot({notifications:this.notifications});}};var Wt=g;export{c as ErrorManager,a as Subscribable,m as TABLE_DATA_ATTRIBUTES,u as TableSelectionManager,Wt as VERSION,b as deleteTableFromDocument,y as findTableFromClick,bt as formatPageRange,ft as getDefaultPrintOptions,x as getTableFromDocument,Tt as isPrintSupported,xt as openPrintWindow,ht as parsePageRange,gt as triggerPrint,h as updateTableInDocument};

package/dist/{displayListQueries-DLzpvJV6.d.mts → displayListQueries-DF8F6fMl.d.mts}

@@ -1,5 +1,5 @@
-import { I as ImagePrimitive, D as DisplayList } from './frameDelta-B2kC6XiP.mjs';
-import { R as RustDisplayListQueryEngine } from './rustDisplayList-B0M2eBkU.mjs';
+import { I as ImagePrimitive, D as DisplayList } from './frameDelta-pA4jrQ1G.mjs';
+import { R as RustDisplayListQueryEngine } from './rustDisplayList-BJqaN9tt.mjs';
 
 /**
  * Locate an image primitive in a built DisplayList by its document position.
@@ -8,14 +8,13 @@ import { R as RustDisplayListQueryEngine } from './rustDisplayList-B0M2eBkU.mjs'
  * rect to place its resize handles, and on the canvas path the painted DOM
  * image (`.layout-run-image`) is parked/hidden — its rect is unusable. The
  * display list carries every inline image as an `ImagePrimitive` stamped with
- * `docStart` (= the image atom's PM position, the same value the DOM path reads
+ * `docStart` (= the image atom's document position, the same value the DOM path reads
  * from `data-doc-start`), so the primitive found here is the geometry source
  * that replaces `imageInfo.element.getBoundingClientRect()`.
  *
  * Body primitives only: header/footer image primitives carry doc positions in a
- * different PM doc (the HF editor), so a body image pmPos must never match one.
+ * different doc (the HF editor), so a body image pmPos must never match one.
  *
- * @experimental part of the rust-canvas-engine change; shape may evolve.
  */
 
 type DisplayListImageRegion = 'body' | 'header' | 'footer';
@@ -23,15 +22,15 @@ interface LocatedImagePrimitive {
     primitive: ImagePrimitive;
     /** page the primitive paints on (page-local px are relative to this page) */
     pageIndex: number;
-    /** PM-document region containing the image. Undefined reads as body. */
+    /** Document region containing the image. Undefined reads as body. */
     region?: DisplayListImageRegion;
     /** Header/footer relationship id when `region` is not body. */
     rId?: string;
 }
 /**
  * First body image primitive whose `docStart` equals `pos`, or null. `pos` is
- * the image node's PM position (a NodeSelection's `from`, or the left edge of a
- * one-atom TextSelection).
+ * the image node's document position (a node selection's `from`, or the left
+ * edge of a one-atom text selection).
  */
 declare function findImagePrimitiveByDocPos(list: DisplayList, pos: number, region?: DisplayListImageRegion, rId?: string): LocatedImagePrimitive | null;
 /** Topmost positioned image under a page-local point, or null. */
@@ -49,67 +48,93 @@ declare function captureInlinePositionEmuFromDisplayList(queries: DisplayListQue
 } | undefined;
 
 /**
- * Synchronous query facade over a built DisplayList, backed by the Rust
+ * Synchronous query facade over one built DisplayList, backed by the Rust
  * hit-testing module (`crates/docx-layout/src/hit.rs`).
  *
- * This is the sole pointer/selection geometry source for the canvas
- * renderer (it replaced the deleted painted-DOM resolvers): geometry comes
- * from the immutable display list, never from DOM rects.
+ * This is the canvas renderer's only source of pointer and selection geometry:
+ * every rect comes from the immutable display list, never from DOM rects. A
+ * facade is created per display-list build, since the list never mutates in
+ * place, and it holds no state a caller has to keep in sync.
  *
- * Perf model: when the embedded wasm carries the session-handle exports, this
- * facade parses the display list into the Rust store exactly ONCE
- * (`openDisplayList` → handle) and routes every hit-test / range-rect query
- * through the by-handle exports — no per-query re-serialization or re-parse.
- * The handle is acquired LAZILY: at the first query that needs it, or when the
- * host calls `prime()` from idle time. Keystroke-driven facade replacement
- * therefore costs no serialization on the input path; superseded generations
- * chain their adoption donor so a deferred pickup still ships one page-delta
- * instead of a full re-open. When the session exports are absent (before the
- * integrator re-embeds the wasm) it falls back to the JSON-arg exports,
- * stringifying the list once and reusing the string for every query. Either
- * way the query RESULTS are byte-identical — the handle path is pure perf.
+ * **Two sources.** A resident editing engine queries its own display list
+ * directly and takes no display-list JSON at all. Otherwise the shared layout
+ * wasm answers, and the facade prefers a SESSION HANDLE: the list is parsed
+ * into the Rust store once (`openDisplayList`) and every later query goes by
+ * handle, with no per-query re-serialization. When the session exports are
+ * absent it stringifies the list once and reuses that string for the JSON-arg
+ * exports. The two paths run the same hit and range logic, so results are
+ * byte-identical and only the cost differs.
  *
- * Handle lifecycle: the handle is opened once per facade (per display-list
- * build) and released by `dispose()`. Callers that drop the facade without
- * disposing (e.g. a React `useMemo` replacement) are covered by a
- * `FinalizationRegistry` that closes the handle when the facade is collected;
- * the Rust store additionally caps live handles and evicts the oldest, so a
- * missed finalize can never grow memory unbounded.
+ * **Handle acquisition is lazy** — on the first query that needs one, or when
+ * a host calls `prime()` from idle time — so replacing the facade on every
+ * keystroke costs no serialization on the input path. A new facade also tries
+ * to ADOPT its predecessor's parsed list, shipping a page delta for the pages
+ * that changed instead of reopening the whole list; superseded generations
+ * chain their donor, so a deferred pickup still costs one delta. The donor's
+ * own later queries degrade to its JSON-arg path.
  *
- * Queries are synchronous; until the lazily-imported wasm module resolves they
- * return `null`/`[]`. In practice the module is already loaded by the time a
- * queries instance exists, because building the display list itself went
- * through the same module (`loadRustDisplayListQueryEngine` shares the promise
- * with `buildRustDisplayList`).
+ * **Handle release.** `dispose()` frees the handle immediately. A facade
+ * dropped without it — a `useMemo` replacement, say — is covered by a
+ * `FinalizationRegistry`, and the Rust store additionally caps live handles
+ * and evicts the oldest, so a missed finalize cannot grow memory without
+ * bound.
  *
- * @experimental part of the rust-canvas-engine change; shape may evolve.
+ * **Failure.** A wasm TRAP poisons the whole instance: a guard held across the
+ * query leaks and every later call into it fails, so the engine is marked dead,
+ * all queries stop, and `onDisplayListQuerySourceFailure` subscribers are told
+ * to rebuild the session. An ordinary error just falls back — a bad handle is
+ * dropped and the query retried over JSON.
+ *
+ * Queries are synchronous and return `null`/`[]` until the lazily imported
+ * wasm module resolves. In practice it is already loaded by the time a facade
+ * exists, because building the display list went through the same module.
  */
 
-/** Query surface implemented by the editing wasm over its resident list. */
+/**
+ * Query surface of an editing engine that already holds the display list.
+ * None of these take display-list JSON, so this source never opens a handle
+ * and never serializes anything.
+ */
 interface ResidentDisplayListQueryEngine {
     displayHitTestRegionsJson(pageIndex: number, x: number, y: number): string;
     displayVerticalMoveJson(position: number, direction: 'up' | 'down', goalX: number): string;
     displayRangeRectsJson(from: number, to: number): string;
-    displayRangeRectsRegionJson(region: 'body' | 'header' | 'footer', rId: string, from: number, to: number): string;
+    displayRangeRectsRegionJson(region: DisplayListHitRegion, partId: string, from: number, to: number): string;
 }
 /** which part of a page owns a hit — mirrors `HitRegion` in hit.rs */
-type DisplayListHitRegion = 'body' | 'header' | 'footer';
+type DisplayListHitRegion = 'body' | 'header' | 'footer' | 'footnote' | 'endnote';
+/**
+ * What a click at a hit point would act on — mirrors `HoverTarget` in hit.rs.
+ * `'text'` is the typeable area (a run's box, or the content box around it),
+ * which is what a pointer cursor keys off; `pos` cannot say, since it resolves
+ * everywhere on a page that carries text.
+ */
+type DisplayListHoverTarget = 'text' | 'image' | 'none';
 /**
  * Region-aware hit result. For `header`/`footer` the position refers to the
- * HF ProseMirror doc identified by `rId`, NOT the body doc — the caller must
- * route the selection to that HF editor, exactly like the DOM path scopes
- * clicks to `.layout-page-header|footer`.
+ * header/footer document identified by `rId`, and for `footnote`/`endnote` to
+ * the note story named by `noteId` — NOT the body document, so the caller must
+ * route the selection to that editor. `pos` is null when the point is inside
+ * the region but resolves to no position.
  */
 interface DisplayListRegionHit {
     region: DisplayListHitRegion;
     rId?: string;
+    /** note whose story a `footnote`/`endnote` position addresses */
+    noteId?: number;
     pos: number | null;
+    /** Absent from a wasm build predating it; read that as "not text". */
+    target?: DisplayListHoverTarget;
 }
+/**
+ * Result of an up/down caret move. `goalX` is the page-local x to feed back
+ * into the next move so a run of them holds one column.
+ */
 interface DisplayListVerticalMove {
     position: number;
     goalX: number;
 }
-/** one highlight rectangle of a PM range, page-local px */
+/** one highlight rectangle of a document range, page-local px */
 interface DisplayListRect {
     pageIndex: number;
     x: number;
@@ -174,23 +199,30 @@ interface DisplayListQueries {
     /** Visual line containing `pos`, or null. */
     visualLineAtPosition(pos: number): DisplayListVisualLine | null;
     /** Topmost image under a page-local point. Body by default. */
-    imageAtPoint(pageIndex: number, x: number, y: number, region?: DisplayListHitRegion, rId?: string): DisplayListImageGeometry | null;
+    imageAtPoint(pageIndex: number, x: number, y: number, region?: DisplayListImageRegion, rId?: string): DisplayListImageGeometry | null;
     /** Image whose atom starts at `pos`. Body by default. */
-    imageByPos(pos: number, region?: DisplayListHitRegion, rId?: string): DisplayListImageGeometry | null;
+    imageByPos(pos: number, region?: DisplayListImageRegion, rId?: string): DisplayListImageGeometry | null;
     /** region-aware point → doc position (page-local coordinates) */
     hitTestRegions(pageIndex: number, x: number, y: number): DisplayListRegionHit | null;
     verticalMove(position: number, direction: 'up' | 'down', goalX?: number): DisplayListVerticalMove | null;
-    /** body PM range → highlight rects */
+    /** body document range → highlight rects */
     rangeRects(from: number, to: number): DisplayListRect[];
     /**
-     * Header/footer PM range → highlight rects for the region's band. `region` is
-     * `'header' | 'footer'`; `rId` identifies the HF ProseMirror doc, and
+     * Header/footer document range → highlight rects for the region's band. `region` is
+     * `'header' | 'footer'`; `rId` identifies the HF doc, and
      * `from`/`to` are positions in THAT doc. The same HF doc paints on every page
      * carrying the part, so this returns one rect-set per such page (each tagged
      * with its `pageIndex`) — the caller picks the page it is editing. Returns
-     * `[]` until the region-aware exports are embedded (feature-detected).
+     * `[]` when the region-aware exports are absent, which is feature-detected.
      */
     hfRangeRects(region: 'header' | 'footer', rId: string, from: number, to: number): DisplayListRect[];
+    /**
+     * Note document range → highlight rects for that note's story. `from`/`to`
+     * are positions in the `fn:{noteId}` / `en:{noteId}` document, never the
+     * body's. A note paints on one page only, so every rect shares its
+     * `pageIndex`.
+     */
+    noteRangeRects(region: 'footnote' | 'endnote', noteId: number, from: number, to: number): DisplayListRect[];
     /**
      * Caret geometry for a collapsed HF selection — the HF twin of `caretRect`.
      * Resolves `[pos, pos+1)` in the HF doc (left edge is the caret), falling back
@@ -198,6 +230,11 @@ interface DisplayListQueries {
      * caret rect per page carrying the part; the caller picks the edited page.
      */
     hfCaretRects(region: 'header' | 'footer', rId: string, pos: number): DisplayListRect[];
+    /**
+     * Caret geometry for a collapsed selection in a note story — the note twin of
+     * `hfCaretRects`. A note paints on one page, so this returns at most one rect.
+     */
+    noteCaretRects(region: 'footnote' | 'endnote', noteId: number, pos: number): DisplayListRect[];
     /** Header/footer sidebar anchors, one per page carrying the part. */
     hfAnchorRects(region: 'header' | 'footer', rId: string, pos: number): DisplayListRect[];
     /**
@@ -248,4 +285,4 @@ declare function onDisplayListQuerySourceFailure(listener: (error: Error) => voi
  */
 declare function createDisplayListQueries(list: DisplayList, engine?: RustDisplayListQueryEngine | ResidentDisplayListQueryEngine, previous?: DisplayListQueries | null): DisplayListQueries;
 
-export { type DisplayListRect as D, type LocatedImagePrimitive as L, type ResidentDisplayListQueryEngine as R, type DisplayListQueries as a, type DisplayListRegionHit as b, type DisplayListHitRegion as c, type DisplayListImageGeometry as d, type DisplayListImageRegion as e, type DisplayListParagraphGeometry as f, type DisplayListQuerySourceState as g, type DisplayListVerticalMove as h, type DisplayListVisualLine as i, captureInlinePositionEmuFromDisplayList as j, createDisplayListQueries as k, findImagePrimitiveAtPoint as l, findImagePrimitiveByDocPos as m, isDisplayListQuerySourceDead as n, onDisplayListQuerySourceFailure as o };
+export { type DisplayListRect as D, type LocatedImagePrimitive as L, type ResidentDisplayListQueryEngine as R, type DisplayListQueries as a, type DisplayListRegionHit as b, type DisplayListHitRegion as c, type DisplayListHoverTarget as d, type DisplayListImageGeometry as e, type DisplayListImageRegion as f, type DisplayListParagraphGeometry as g, type DisplayListQuerySourceState as h, type DisplayListVerticalMove as i, type DisplayListVisualLine as j, captureInlinePositionEmuFromDisplayList as k, createDisplayListQueries as l, findImagePrimitiveAtPoint as m, findImagePrimitiveByDocPos as n, isDisplayListQuerySourceDead as o, onDisplayListQuerySourceFailure as p };