@docx-editor.dev/core 2.4.0 → 2.5.0

package/dist/layout.d.ts

@@ -1,37 +1,24 @@
-import { V as VersionedShapingLibrary, T as TextShaper, F as FontByteValidator, a as FixedPointRoundingMode, b as FixedPoint, c as TextDirection, S as ShapedRun } from './shaped-measurer-BL8g4AcW.js';
-export { C as CacheLookup, d as CacheMiss, e as CacheProvenance, D as DeclaredFontSubstitution, f as FontFingerprintInputs, g as FontRequest, h as FontResolutionError, i as FontResolutionErrorCode, j as FontResourceDefinition, k as FontResourceInstrumentation, l as FontResourceSnapshot, m as FontResourceSnapshotOptions, n as FontSubstitution, o as FontValidationResult, G as GlyphOutline, H as HARD_MAX_AGGREGATE_FONT_BYTES, p as HARD_MAX_FONT_BYTES, q as HARD_MAX_FONT_SOURCES, L as LayoutShapingOptions, N as NormalizationPolicy, O as OperationSnapshot, r as OperationSnapshotField, s as OperationSnapshotGuard, R as ResolvedCache, t as ResolvedFont, u as ResourceDependencyProvenance, v as ShapeInput, w as ShapedCluster, x as ShapedFontSpan, y as ShapedGlyph, z as ShapedMeasurerOptions, A as ShapedRunComparatorInputs, B as ShapedVerticalMetrics, E as ShapingEnvironment, I as ShapingEnvironmentFingerprintInputs, J as ShapingEnvironmentInput, K as boundedStructuralFontValidator, M as captureOperationSnapshot, P as createFontResourceSnapshot, Q as createShapedMeasurer, U as createShapedRun, W as createShapingEnvironment, X as fixedPoint, Y as fontRequestKey, Z as guardOperationSnapshot, _ as sha256FontBytes, $ as shapedRunComparatorInputs, a0 as shapingEnvironmentFingerprint, a1 as shapingEnvironmentFingerprintInputs } from './shaped-measurer-BL8g4AcW.js';
-import { d as SpanLinkRecord, e as LayoutBox, D as DrawingPoint, f as DrawingInsets, a as StyleSpanRecord, I as InlineDrawingRecord, M as ModelRange, R as ResolvedRunStyle, g as ThemeFonts, h as ParagraphSpacing, i as ParagraphLineSpacing, j as ParagraphBorderEdge, k as ParagraphBorders, l as ResolvedTabStops, m as TableBorderSide, B as BlockFragmentRecord, n as InlineDrawingLayoutContext, T as TextMeasurer, S as SemanticLayout, o as PageRecord, p as ParagraphFragmentRecord, A as AnchoredDrawingRecord, P as PageGeometry, q as CellBorderBox, r as TableBorderBox } from './semantic-records-CR5hTqMK.js';
-export { s as AUTO_PARAGRAPH_SPACING_PT, t as BorderGridGeometry, C as ContentControlBoundaryRecord, u as ContentControlGeometryFragment, v as ContentControlLevel, w as ContentControlLock, x as ContentControlMappedType, y as DEFAULT_PAGE_GEOMETRY, z as DEFAULT_RUN_STYLE, E as DEFAULT_TAB_INTERVAL_PT, F as DEFAULT_TAB_INTERVAL_TWIPS, G as EMPTY_TAB_STOPS, H as FieldAtomMarker, J as HeaderFooterStoryRecord, L as LineRecord, K as LineSpacingRule, N as ListMarkerRecord, O as MAX_BORDER_SPACE_PT, Q as MAX_BORDER_WIDTH_PT, U as MAX_PARAGRAPH_SPACING_PT, V as MAX_TABLE_BORDER_STROKES, W as MAX_TAB_POSITION_TWIPS, X as MAX_TAB_STOPS, Y as PARAGRAPH_BORDER_SIDES, Z as ParagraphAutoSpacingContext, _ as ParagraphBorderSide, $ as ParagraphBorderStrokeRecord, a0 as ParagraphBottomBorderRecord, a1 as ParagraphIndent, a2 as ResolvedCellBorders, a3 as ResolvedTableBorderEdge, a4 as ResolvedTableBorderEdgeSegment, a5 as ResolvedUnderline, a6 as SINGLE_LINE_SPACING, a7 as SourceRange, a8 as TAB_LEADER_GLYPH, a9 as TabAlignment, aa as TabDestination, ab as TabLeader, ac as TabStop, ad as TableBorderSideName, ae as TableBorderStrokeRecord, c as TableCellFragmentRecord, af as TableFragmentRecord, b as TableRowFragmentRecord, ag as VerticalAlign, ah as appliedSpaceBefore, ai as applyLineSpacing, aj as baselineShiftPtOf, ak as borderExtentPt, al as borderWeight, am as bottomBorderExtentPt, an as cascadedParagraphBorders, ao as cascadedTabStops, ap as collapsedSpaceBefore, aq as contentControlsOfLayout, ar as defaultTabIntervalFromSettings, as as displayText, at as effectiveContentControlLock, au as fragmentsOfParagraph, av as lineAtPosition, aw as linesOf, ax as measureDisplayText, ay as nextTabDestination, az as paragraphBorderExtentPt, aA as paragraphBorderStrokeWidthPt, aB as paragraphBorders, aC as paragraphBordersFingerprint, aD as paragraphBreaksBefore, aE as paragraphContextualSpacing, aF as paragraphFragmentsOf, aG as paragraphFragmentsOfBlocks, aH as paragraphLineSpacing, aI as paragraphSpacing, aJ as paragraphTabStops, aK as readBorderSide, aL as readCellBorders, aM as readTableBorders, aN as resolveBorderConflict, aO as resolveRunStyle, aP as resolveTableCellBorderGrid, aQ as runStylesEqual, aR as tabAdvanceWidth, aS as tabStopsFingerprint, aT as unionLayoutBoxes, aU as withDefaultTabInterval } from './semantic-records-CR5hTqMK.js';
-import { O as OoxmlNode, a as OoxmlElement, e as OoxmlPart } from './ooxml-tree-BU0e3DVi.js';
-import { O as OoxmlProperty, C as ContentControlKind, n as ContentControlLevel, o as ContentControlLock, p as ContentControlDataBinding, I as ImpactClass } from './tree-op-types-8a6xyRCN.js';
-export { l as TableBorderStyle } from './tree-op-types-8a6xyRCN.js';
-import { N as NoteKind, n as noteTypeOf } from './note-nodes-BPSTVDMr.js';
-import { R as ResolvedFootnoteProperties, a as ResolvedEndnoteProperties } from './review-reads-CQmU9Lcl.js';
-export { p as paragraphOrderOfPart } from './review-reads-CQmU9Lcl.js';
-import { R as RevisionDisplayMode } from './revision-projection-DHAkcD_L.js';
-export { D as DEFAULT_REVISION_DISPLAY_MODE, a as RevisionAttribution, b as RevisionKind, f as formatRevisionOf, p as paragraphMarkRevisionOf, r as revisionsAreDeletion, c as revisionsVisible } from './revision-projection-DHAkcD_L.js';
-import { a as SectionColumns } from './semantic-cell-selection-DZtyMXkH.js';
-export { C as CellSelection, D as DEFAULT_SECTION_PROPERTIES, b as DEFAULT_VERTICAL_WEIGHT, c as DocumentSection, d as DocumentSectionsEnumeration, e as DrawingOverlayFrame, H as HitPoint, f as HitTestOptions, M as MAX_DOCUMENT_SECTIONS, P as PlacedCell, g as SectionBreakType, h as SectionColumnDefinition, i as SectionMargins, j as SectionPageNumbering, S as SectionProperties, k as SemanticHit, l as SemanticHitDrawing, T as TableCellAddress, m as TableCellContext, n as caretBoxOnLine, o as cellSelectionBetween, p as cellSelectionRects, q as cellSelectionText, r as contentControlAtPoint, s as enumerateDocumentSections, t as enumerateDocumentSectionsBounded, u as findDrawingOverlayFrameInLayout, v as geometryOfSection, w as hitTestPage, x as hitTestSheet, y as isFurniturePoint, z as lineEndOffset, A as pageAtY, B as paragraphSectionNode, E as paragraphsInCells, F as parsePageNumbering, G as parseSectionProperties, I as readSectionProperties, J as spanOffsetX, K as spansInCells, L as tableContextAt } from './semantic-cell-selection-DZtyMXkH.js';
-export { M as MAX_SDT_NESTING, c as collectFlowBlocks, a as contentControlContentChildren, i as isContentControl, b as isContentControlContent } from './content-control-walk-D06GijR0.js';
-export { h as CommentAnchor, i as CommentPosition, C as CommentRecord, j as CommentThreadState, c as ReviewCommentItem, d as ReviewCustomItem, a as ReviewItem, R as ReviewModelInput, k as ReviewParagraphAnchor, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind, W as W15_NAMESPACE_URI, l as activeReviewItem, m as commentBodyText, n as commentInitials, o as firstReviewRange, r as reviewAnchorIndex, p as reviewItemGeometry, q as reviewItemKey, s as reviewItemPositionRank, t as reviewItemRanges, u as reviewItemsAt, v as reviewThreadRootOf } from './review-support-DgXTIYBW.js';
-import { T as TreeModelChange } from './tree-store-BoM6eXaL.js';
-export { b as CaretAtOptions, C as CaretGeometry, K as KeyedRange, M as MoveCaretOptions, N as NavigationCommand, c as SelectionRect, S as SemanticPosition, a as SemanticSelection, d as caretAt, e as caretStops, f as caretStopsForBlocks, g as compositionAnchor, h as contentControlAtSemantic, i as contentControlsInLayout, j as documentOrder, k as hitTestSemantic, l as keyedRangeRects, m as moveCaret, p as paragraphTextFromLayout, s as selectionRects, n as spansInSelection } from './semantic-interaction-DrgbgKg6.js';
-import './image-resources-BG9DLyW7.js';
-import './ooxml-package-D_CtywTW.js';
-
-/**
- * Which allowlisted page fields a header/footer story actually contains.
- *
- * Drives layout reuse: no fields → one baseline; NUMPAGES only → one layout per page count;
- * SECTIONPAGES only → one layout per section page count; PAGE (alone or combined) → per
- * distinct evaluated values with a bounded cache. Counts both complex markers and
- * `w:fldSimple` (including an allowlisted page field nested inside a non-page simple field).
- */
-interface StoryPageFieldNeeds {
-    readonly hasPage: boolean;
-    readonly hasNumPages: boolean;
-    readonly hasSectionPages: boolean;
-}
+import { V as VersionedShapingLibrary, T as TextShaper, F as FontByteValidator, a as FixedPointRoundingMode, b as FixedPoint, c as TextDirection, S as ShapedRun } from './shaped-measurer-BT4FqYe9.js';
+export { C as CacheLookup, d as CacheMiss, e as CacheProvenance, D as DeclaredFontSubstitution, f as FontFingerprintInputs, g as FontRequest, h as FontResolutionError, i as FontResolutionErrorCode, j as FontResourceDefinition, k as FontResourceInstrumentation, l as FontResourceSnapshot, m as FontResourceSnapshotOptions, n as FontSubstitution, o as FontValidationResult, G as GlyphOutline, H as HARD_MAX_AGGREGATE_FONT_BYTES, p as HARD_MAX_FONT_BYTES, q as HARD_MAX_FONT_SOURCES, L as LayoutShapingOptions, N as NormalizationPolicy, O as OperationSnapshot, r as OperationSnapshotField, s as OperationSnapshotGuard, R as ResolvedCache, t as ResolvedFont, u as ResourceDependencyProvenance, v as ShapeInput, w as ShapedCluster, x as ShapedFontSpan, y as ShapedGlyph, z as ShapedMeasurerOptions, A as ShapedRunComparatorInputs, B as ShapedVerticalMetrics, E as ShapingEnvironment, I as ShapingEnvironmentFingerprintInputs, J as ShapingEnvironmentInput, K as boundedStructuralFontValidator, M as captureOperationSnapshot, P as createFontResourceSnapshot, Q as createShapedMeasurer, U as createShapedRun, W as createShapingEnvironment, X as fixedPoint, Y as fontRequestKey, Z as guardOperationSnapshot, _ as sha256FontBytes, $ as shapedRunComparatorInputs, a0 as shapingEnvironmentFingerprint, a1 as shapingEnvironmentFingerprintInputs } from './shaped-measurer-BT4FqYe9.js';
+import { d as LayoutBox, D as DrawingPoint, e as DrawingInsets, a as StyleSpanRecord, I as InlineDrawingRecord, M as ModelRange, R as ResolvedRunStyle, f as ThemeFonts, g as ParagraphSpacing, h as ParagraphLineSpacing, i as ParagraphBorderEdge, j as ParagraphBorders, k as ResolvedTabStops, l as TableBorderSide, S as SemanticLayout, B as BlockFragmentRecord, m as InlineDrawingLayoutContext, T as TextMeasurer, H as HyperlinkProjector, F as FieldLinkProjector, n as PageRecord, o as ParagraphFragmentRecord, p as StoryPageFieldNeeds, A as AnchoredDrawingRecord, P as PageGeometry, q as CellBorderBox, r as TableBorderBox } from './semantic-records-B-qbrnp2.js';
+export { s as AUTO_PARAGRAPH_SPACING_PT, t as BorderGridGeometry, C as ContentControlBoundaryRecord, u as ContentControlGeometryFragment, v as ContentControlLevel, w as ContentControlLock, x as ContentControlMappedType, y as DEFAULT_PAGE_GEOMETRY, z as DEFAULT_RUN_STYLE, E as DEFAULT_TAB_INTERVAL_PT, G as DEFAULT_TAB_INTERVAL_TWIPS, J as EMPTY_TAB_STOPS, K as FieldAtomMarker, N as HeaderFooterStoryRecord, O as HyperlinkFieldSpec, L as LineRecord, Q as LineSpacingRule, U as ListMarkerRecord, V as MAX_BORDER_SPACE_PT, W as MAX_BORDER_WIDTH_PT, X as MAX_PARAGRAPH_SPACING_PT, Y as MAX_TABLE_BORDER_STROKES, Z as MAX_TAB_POSITION_TWIPS, _ as MAX_TAB_STOPS, $ as PARAGRAPH_BORDER_SIDES, a0 as ParagraphAutoSpacingContext, a1 as ParagraphBorderSide, a2 as ParagraphBorderStrokeRecord, a3 as ParagraphBottomBorderRecord, a4 as ParagraphIndent, a5 as ResolvedCellBorders, a6 as ResolvedTableBorderEdge, a7 as ResolvedTableBorderEdgeSegment, a8 as ResolvedUnderline, a9 as SINGLE_LINE_SPACING, aa as SourceRange, ab as SpanLinkRecord, ac as TAB_LEADER_GLYPH, ad as TabAlignment, ae as TabDestination, af as TabLeader, ag as TabStop, ah as TableBorderSideName, ai as TableBorderStrokeRecord, c as TableCellFragmentRecord, aj as TableFragmentRecord, b as TableRowFragmentRecord, ak as VerticalAlign, al as appliedSpaceBefore, am as applyLineSpacing, an as baselineShiftPtOf, ao as borderExtentPt, ap as borderWeight, aq as bottomBorderExtentPt, ar as cascadedParagraphBorders, as as cascadedTabStops, at as collapsedSpaceBefore, au as contentControlsOfLayout, av as defaultTabIntervalFromSettings, aw as displayText, ax as effectiveContentControlLock, ay as fragmentsOfParagraph, az as lineAtPosition, aA as linesOf, aB as measureDisplayText, aC as nextTabDestination, aD as paragraphBorderExtentPt, aE as paragraphBorderStrokeWidthPt, aF as paragraphBorders, aG as paragraphBordersFingerprint, aH as paragraphBreaksBefore, aI as paragraphContextualSpacing, aJ as paragraphFragmentsOf, aK as paragraphFragmentsOfBlocks, aL as paragraphLineSpacing, aM as paragraphSpacing, aN as paragraphTabStops, aO as readBorderSide, aP as readCellBorders, aQ as readTableBorders, aR as resolveBorderConflict, aS as resolveRunStyle, aT as resolveTableCellBorderGrid, aU as runStylesEqual, aV as tabAdvanceWidth, aW as tabStopsFingerprint, aX as unionLayoutBoxes, aY as withDefaultTabInterval } from './semantic-records-B-qbrnp2.js';
+import { O as OoxmlNode, a as OoxmlElement, e as OoxmlPart } from './ooxml-tree-CG0odFyi.js';
+import { O as OoxmlProperty, C as ContentControlKind, n as ContentControlLevel, o as ContentControlLock, p as ContentControlDataBinding, I as ImpactClass } from './tree-op-types-CZw9QhWX.js';
+export { m as TableBorderStyle } from './tree-op-types-CZw9QhWX.js';
+import { N as NoteKind, n as noteTypeOf } from './note-nodes-CZQXU6Fg.js';
+import { R as ResolvedFootnoteProperties, a as ResolvedEndnoteProperties } from './note-properties-BS66XmcC.js';
+export { p as paragraphOrderOfPart } from './note-properties-BS66XmcC.js';
+import { D as DocumentProperties, T as TreeModelChange } from './tree-store-9TaX-L0V.js';
+import { R as RevisionDisplayMode } from './revision-projection-u4nT52xT.js';
+export { D as DEFAULT_REVISION_DISPLAY_MODE, a as RevisionAttribution, b as RevisionKind, f as formatRevisionOf, m as markRevisionRemovesMark, p as paragraphMarkFormatRevisionOf, c as paragraphMarkRevisionOf, d as paragraphMarkRevisionsOf, r as revisionsAreDeletion, e as revisionsVisible, s as shownMarkRevision } from './revision-projection-u4nT52xT.js';
+import { a as SectionColumns } from './semantic-cell-selection-Dc-_enhm.js';
+export { C as CellSelection, D as DEFAULT_SECTION_PROPERTIES, b as DEFAULT_VERTICAL_WEIGHT, c as DocumentSection, d as DocumentSectionsEnumeration, e as DrawingOverlayFrame, H as HitPoint, f as HitTestOptions, M as MAX_DOCUMENT_SECTIONS, P as PlacedCell, g as SectionBreakType, h as SectionColumnDefinition, i as SectionMargins, j as SectionPageNumbering, S as SectionProperties, k as SemanticHit, l as SemanticHitDrawing, T as TableCellAddress, m as TableCellContext, n as caretBoxOnLine, o as cellSelectionBetween, p as cellSelectionRects, q as cellSelectionText, r as contentControlAtPoint, s as enumerateDocumentSections, t as enumerateDocumentSectionsBounded, u as findDrawingOverlayFrameInLayout, v as geometryOfSection, w as hitTestPage, x as hitTestSheet, y as isFurniturePoint, z as lineEndOffset, A as pageAtY, B as paragraphSectionNode, E as paragraphsInCells, F as parsePageNumbering, G as parseSectionProperties, I as readSectionProperties, J as spanOffsetX, K as spansInCells, L as tableContextAt } from './semantic-cell-selection-Dc-_enhm.js';
+export { M as MAX_SDT_NESTING, c as collectFlowBlocks, a as contentControlContentChildren, i as isContentControl, b as isContentControlContent } from './content-control-walk-CQp8l6eS.js';
+export { h as CommentAnchor, i as CommentPosition, C as CommentRecord, j as CommentThreadState, c as ReviewCommentItem, d as ReviewCustomItem, a as ReviewItem, R as ReviewModelInput, k as ReviewParagraphAnchor, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind, W as W15_NAMESPACE_URI, l as activeReviewItem, m as anchorLineY, n as commentBodyText, o as commentInitials, p as firstReviewRange, r as reviewAnchorIndex, q as reviewItemGeometry, s as reviewItemKey, t as reviewItemPositionRank, u as reviewItemRanges, v as reviewItemsAt, w as reviewThreadRootOf } from './review-support-Bl9sN8cv.js';
+import { S as SemanticPosition, b as SelectionRect, a as SemanticSelection } from './semantic-interaction-CCVwyw2A.js';
+export { c as CaretAtOptions, C as CaretGeometry, M as MoveCaretOptions, N as NavigationCommand, d as caretAt, e as caretStops, f as caretStopsForBlocks, g as compositionAnchor, h as contentControlAtSemantic, i as contentControlsInLayout, j as hitTestSemantic, m as moveCaret, p as paragraphTextFromLayout, s as spansInSelection } from './semantic-interaction-CCVwyw2A.js';
+import './image-resources-e13t-pgy.js';
+import './ooxml-package-BrxTmTsZ.js';
 
 /**
  * Page-field evaluation context for furniture projection.
@@ -64,7 +51,13 @@ declare function formatPageNumber(value: number, format: string | undefined): st
  * — fail-open with an empty display (model atom preserved).
  */
 interface NoteMarkContext {
-    /** scopeId → formatted mark (or null when suppressed). */
+    /**
+     * scopeId → formatted mark (or null when suppressed).
+     *
+     * IMMUTABLE once the context is built. `noteMarksCacheToken` memoizes on the context object
+     * and that token reaches every paragraph's cache key, so a later `marks.set` would pin the
+     * whole document to a token for marks it no longer has.
+     */
     readonly marks: ReadonlyMap<string, string | null>;
     /**
      * When set, every automatic mark measures at least this string's width (eachPage
@@ -107,16 +100,6 @@ interface ProjectedNoteMark {
 /** Resolve display text for a noteReference / noteRef node under a mark context. */
 declare function projectedNoteMarkText(node: OoxmlNode, context: NoteMarkContext | undefined): ProjectedNoteMark | null;
 
-/**
- * How layout turns a typed `w:hyperlink` node into the sanitized record spans carry.
- *
- * Injected rather than computed here because resolving `r:id` needs the PACKAGE's
- * relationships and this module only ever sees one part's tree. `null` means the caller
- * declined to project — the runs still measure and paint, they simply carry no link, which is
- * the right degradation: text is never lost for want of a target.
- */
-type HyperlinkProjector = (link: OoxmlNode) => SpanLinkRecord | null;
-
 /** A fingerprint over one paragraph's layout inputs. */
 type ParagraphLayoutKey = string;
 /** Cache counters, for asserting that incremental layout is actually reusing work. */
@@ -481,6 +464,10 @@ declare function withResolvedListItems<T extends {
      * Host oracle for "is this font family really loaded". Supplied, a Symbol/Wingdings
      * bullet keeps the file's own private-use codepoint so the authored typeface draws it;
      * absent, it falls back to the Unicode equivalent rather than a tofu box.
+     *
+     * The resolve is memoized on this function's IDENTITY: a host whose answers change
+     * over time (a font finished loading) must supply a new closure at that point, or the
+     * memo will keep serving marker glyphs computed from the old answers.
      */
     readonly isFontAvailable?: (family: string) => boolean;
 }>(options: T, blocks: readonly OoxmlElement[]): T & {
@@ -736,6 +723,36 @@ interface CompoundBorderMetrics {
  */
 declare function computeDoubleBorderMetricsPt(widthPt: number): CompoundBorderMetrics;
 
+/** Paragraph ids in document order, deduplicated across fragments. */
+declare function documentOrder(layout: SemanticLayout): string[];
+
+/** The rectangles covering a selection, one per line it spans. */
+declare function selectionRects(layout: SemanticLayout, selection: SemanticSelection): SelectionRect[];
+/** A model range to highlight, and the key the caller knows it by. */
+interface KeyedRange {
+    readonly key: string;
+    readonly from: SemanticPosition;
+    readonly to: SemanticPosition;
+}
+/**
+ * Rectangles for MANY ranges in ONE pass over the lines.
+ *
+ * Not `selectionRects` in a loop. That walks every page, fragment and line per range, and a
+ * contract with two hundred comments would re-walk the whole document two hundred times on
+ * every layout — the highlight would cost more than the layout it decorates. One pass tests
+ * each line against every range instead, which is the same work a single selection does.
+ */
+declare function keyedRangeRects(layout: SemanticLayout, ranges: readonly KeyedRange[], 
+/**
+ * Pages to measure, or every page when absent.
+ *
+ * A band that is not on screen is not painted, so measuring it is pure cost — and it is
+ * cost paid per keystroke, because an edit republishes the layout. Bounding this to the
+ * materialized pages is what keeps typing in a heavily reviewed document as fast as
+ * typing in a clean one.
+ */
+pages?: ReadonlySet<number>): Map<string, SelectionRect[]>;
+
 /**
  * The next word boundary from `offset`, in `direction`.
  *
@@ -1220,6 +1237,15 @@ interface LayoutNoteStoryOptions {
     readonly cache?: ParagraphLayoutCache<readonly PendingLine[]>;
     readonly styleCascade?: StyleCascadeTable;
     readonly defaultTabStopPt?: number;
+    /**
+     * Same projector seams the BODY walk uses. Without them a `w:hyperlink` or a HYPERLINK
+     * field inside a note painted as plain text — measured, but carrying no link record for
+     * paint to anchor and navigation to activate.
+     */
+    readonly projectLink?: HyperlinkProjector;
+    readonly projectFieldLink?: FieldLinkProjector;
+    /** Document properties for a document-property field inside a note story. */
+    readonly documentProperties?: DocumentProperties;
     /** Derived display marks for noteRef projection inside the note body. */
     readonly noteMarks?: NoteMarkContext;
     /**
@@ -1333,6 +1359,15 @@ interface NotesLayoutInput {
     readonly cache?: ParagraphLayoutCache<readonly PendingLine[]>;
     readonly styleCascade?: StyleCascadeTable;
     readonly defaultTabStopPt?: number;
+    /**
+     * Link projector seams, same as the body walk's. Normally injected by `semantic-layout`
+     * from its own options, so a note's `w:hyperlink` / HYPERLINK field carries the same
+     * sanitized record a body one does instead of painting dead text.
+     */
+    readonly projectLink?: HyperlinkProjector;
+    readonly projectFieldLink?: FieldLinkProjector;
+    /** Document properties for a document-property field inside a note story. */
+    readonly documentProperties?: DocumentProperties;
     /**
      * Inline drawing support per notes part. Absent means note paragraphs flow without
      * drawing records, which is what a headless caller with no image port wants.
@@ -1469,7 +1504,7 @@ interface HeaderFooterStoryLayout {
  * on a constant. It sits at the tail because the parameters ahead of it are already
  * positional; new callers should keep passing `undefined` for what they do not set.
  */
-declare function layoutHeaderFooterStory(part: OoxmlPart, contentWidth: number, measurer: TextMeasurer, producer: string, cache?: ParagraphLayoutCache<readonly PendingLine[]>, styleCascade?: StyleCascadeTable, pageContext?: FieldPageContext, maxPageContextEntries?: number, defaultTabStopPt?: number, displayMode?: RevisionDisplayMode, inlineDrawingLayout?: InlineDrawingLayoutContext, drawingTokenForParagraph?: (paragraph: OoxmlNode) => string, drawingLayoutToken?: string, hfPageContext?: HeaderFooterPageContext): HeaderFooterStoryLayout;
+declare function layoutHeaderFooterStory(part: OoxmlPart, contentWidth: number, measurer: TextMeasurer, producer: string, cache?: ParagraphLayoutCache<readonly PendingLine[]>, styleCascade?: StyleCascadeTable, pageContext?: FieldPageContext, maxPageContextEntries?: number, defaultTabStopPt?: number, displayMode?: RevisionDisplayMode, inlineDrawingLayout?: InlineDrawingLayoutContext, drawingTokenForParagraph?: (paragraph: OoxmlNode) => string, drawingLayoutToken?: string, hfPageContext?: HeaderFooterPageContext, documentProperties?: DocumentProperties): HeaderFooterStoryLayout;
 
 /** The flow state as it stood immediately before one block was placed. */
 interface FlowCheckpoint {
@@ -1479,6 +1514,17 @@ interface FlowCheckpoint {
     readonly pageFragments: readonly BlockFragmentRecord[];
     /** Anchored drawings already collected for the open page. */
     readonly pendingAnchoredDrawings: readonly AnchoredDrawingRecord[];
+    /**
+     * Anchored drawings overlap resolution pushed onto the NEXT page, and how many times each
+     * drawing has been pushed.
+     *
+     * Flow state like the rest of this record, and carried for the same reason: a resume that
+     * started with an empty list dropped a drawing that the previous pass had deferred but not
+     * yet placed, and a convergence that did not compare them accepted a flow that still owed
+     * the next page a drawing as equal to one that owed it nothing.
+     */
+    readonly deferredAnchoredDrawings: readonly AnchoredDrawingRecord[];
+    readonly anchorPageDeferCounts: ReadonlyMap<string, number>;
     readonly cursorY: number;
     readonly lineCounter: number;
     /** Trailing paragraph spacing participating in adjacent-spacing collapse. */
@@ -1699,6 +1745,19 @@ interface SemanticLayoutOptions {
      * degradation a headless test or a furniture-only pass gets, and it is the safe one.
      */
     readonly projectLink?: HyperlinkProjector;
+    /**
+     * Turns a parsed HYPERLINK field instruction into the SANITIZED record its result carries.
+     *
+     * An option for the same reason as {@link projectLink}: the raw target must cross the
+     * surface's href trust boundary, which layout cannot see. Absent means the field's cached
+     * result still measures, breaks and paints — it simply is not clickable.
+     */
+    readonly projectFieldLink?: FieldLinkProjector;
+    /**
+     * The document's parsed metadata, for document-property fields (TITLE, AUTHOR, …). Read once
+     * by the surface and shared across body, table, note and header/footer flows.
+     */
+    readonly documentProperties?: DocumentProperties;
     /**
      * Footnote/endnote layout input. When present, body layout projects note marks and a
      * post-pass attaches note areas (with bounded reflow for pageBottom reservation).
@@ -1951,6 +2010,9 @@ declare function resolveDefaultSurfaceMeasurer(scale?: number, options?: CanvasM
 /**
  * The story's blocks — paragraphs and tables — in document order, flattening through
  * block-level content-control wrappers under the shared nesting budget.
+ *
+ * Repeated calls with the same part and display mode return the SAME array instance,
+ * shared by every caller — treat it as read-only; mutating it corrupts later callers.
  */
 declare function storyBlocks(part: OoxmlPart, displayMode?: RevisionDisplayMode): OoxmlElement[];
 /**
@@ -2377,10 +2439,12 @@ declare function readTableStructure(table: OoxmlNode, contentWidthPt: number, de
 displayMode?: RevisionDisplayMode): SemanticTableStructure | null;
 
 /**
- * `w:pPr/w:rPr/w:del` — the paragraph mark was deleted by a tracked revision.
+ * `w:pPr/w:rPr/w:del` or `w:moveFrom` — a tracked revision REMOVES the paragraph mark.
  *
- * Read from the paragraph-mark run properties only. A `w:del` anywhere else in the paragraph
- * deletes run content, which is a different statement entirely.
+ * Both say the break goes away once the decision is taken: a deletion outright, a `moveFrom`
+ * because the paragraph left this place for another. Read from the paragraph-mark run
+ * properties only. A `w:del` anywhere else in the paragraph deletes run content, which is a
+ * different statement entirely.
  */
 declare function paragraphMarkDeleted(paragraph: OoxmlNode): boolean;
 /**
@@ -2407,4 +2471,4 @@ declare class TablePaginationError extends Error {
     constructor(code: TablePaginationErrorCode, message: string);
 }
 
-export { AUTO_PREFERRED_WIDTH, type AbstractNumDefinition, type BidiEmbeddingLevels, BlockFragmentRecord, CELL_PAD, COMPOUND_BORDER_MIN_GAP_PT, COMPOUND_BORDER_MIN_STROKE_PT, type CanvasMeasurerOptions, type CanvasTextContext, type CanvasTextMetrics, type CascadedParagraphFormatting, CellBorderBox, type CellMarginsPt, type CellVerticalAlign, type CompoundBorderMetrics, type ContentControlFragmentRecord, DEFAULT_CANVAS_FONT_STACK, DEFAULT_CELL_MARGINS, EMPTY_NUMBERING_INDEX, FixedPoint, FixedPointRoundingMode, FontByteValidator, type FontSlot, GRAPHEME_SEGMENTER_LOCALE, type GraphemeBoundary, type GraphemeSegment, type GraphemeWordSegmentRecord, HARFBUZZ_SHAPING_LIBRARY, type HarfBuzzFaceCacheEvent, type HarfBuzzOutlineCacheEvent, type HarfBuzzShapeCacheEvent, HarfBuzzShapingError, type HarfBuzzShapingErrorCode, type HarfBuzzTextShaper, type HarfBuzzTextShaperInstrumentation, type HarfBuzzTextShaperOptions, type HeaderFooterVariantName, type HyperlinkProjector, LayoutBox, type LayoutCacheStats, type LayoutScheduler, type LayoutSchedulerOptions, type LayoutScope, type LayoutSession, type LayoutSessionStats, type LevelOverride, type ListCounterAdvance, type ListCounterState, type ListMarkerAlign, type ListSuffix, MAX_EACH_PAGE_MARK_CANDIDATES, MAX_LVL_OVERRIDES, MAX_LVL_TEXT_LENGTH, MAX_MARKER_TEXT_LENGTH, MAX_NOTES_LAID_OUT, MAX_NOTE_FRAGMENTS, MAX_NOTE_OVERFLOW_PAGES, MAX_NOTE_REFLOW_ATTEMPTS, MAX_NUMBERING_DEFINITIONS, MAX_STYLE_BASED_ON_DEPTH, MAX_STYLE_DEFINITIONS, MAX_TABLE_COLUMNS, MAX_TABLE_NESTING, MAX_TABLE_ROW_FRAGMENTS, MAX_TABLE_ROW_HEIGHT_PT, type MaterializationInput, type NoteDisplayMark, type NoteLayoutFallbackReason, type NoteMarkContext, type NotePaginationFallbackReason, type NoteReferenceSite, type NoteSeparatorLayout, type NoteSeparatorRuleStyle, type NoteStoryDrawings, type NoteStoryLayout, type NotesAttachResult, type NotesLayoutInput, type NumDefinition, type NumberingIndex, type NumberingLevel, type NumberingLevelIndent, type PageFurniture, PageGeometry, PageRecord, type PageRefIndex, ParagraphBorderEdge, ParagraphBorders, ParagraphFragmentRecord, type ParagraphKeyInputs, type ParagraphLayoutCache, type ParagraphLayoutCacheOptions, type ParagraphLayoutInputs, ParagraphLineSpacing, ParagraphSpacing, type PreferredWidth, type PreferredWidthType, type ResolvedListItem, ResolvedRunStyle, type ResolvedSurfaceMeasurer, ResolvedTabStops, RevisionDisplayMode, type ScriptItem, SectionColumns, SemanticLayout, type SemanticLayoutOptions, type SemanticTableCell, type SemanticTableRow, type SemanticTableStructure, ShapedRun, SpanLinkRecord, type StyleCascadeTable, type StyleDefinition, StyleSpanRecord, type TableAlignment, TableBorderBox, TableBorderSide, type TableCellStyleFormatting, TablePaginationError, type TablePaginationErrorCode, type TableRowHeight, type TableRowHeightRule, TextDirection, TextMeasurer, TextShaper, UnsupportedScriptError, VersionedShapingLibrary, type ViewportWindow, WORD_SEGMENTER_LOCALE, type WordBoundary, type WordBoundaryResolverDeps, type WordSegment, attachNotesToLayout, boundedFallbackWordSegments, buildNumberingIndex, buildPageRefIndex, buildStyleCascadeTable, cascadeParagraphFormatting, cascadeRunProperties, cascadedBottomBorder, clampListValue, computeDoubleBorderMetricsPt, computeFootnoteReserves, contentControlBoundaries, createBoundedFallbackWordBoundary, createDefaultWordBoundary, createFixedMeasurer, createHarfBuzzTextShaper, createIntlWordBoundary, createLayoutScheduler, createLayoutSession, createListCounterState, createParagraphLayoutCache, defaultNoteSeparatorRuleStyle, deriveNoteDisplayMarks, deriveNoteDisplayMarksResolved, effectiveBorderSide, emptyTocPlaceholderParagraphIds, emptyTocSuppressedResultParagraphIds, expandLvlText, filterRefsOnPage, findSeparatorNote, formatDecimal, formatDecimalZero, formatLowerLetter, formatLowerRoman, formatNumFmt, formatPageNumber, formatUpperLetter, formatUpperRoman, fragmentOwnsAtomOffset, graphemeBoundaryEpoch, graphemeCount, graphemeOffsetToUtf16, harfBuzzFontValidator, initializeHarfBuzz, intlGraphemeBoundary, isCanvasMeasurementAvailable, isCumulativeGeometryTrustedFromLineOrigin, isGeometryTrustedCaretOffset, isHarfBuzzInitialized, isIntlSegmenterAvailable, isIntlWordSegmenterAvailable, isMarkerOnlySeparatorNote, isValidStyleId, isWholeGraphemeHorizontalBoundary, itemizeScriptFontSlots, layoutHeaderFooterStory, layoutNoteById, layoutNoteSeparator, layoutNoteStory, layoutSemanticDocument, listMarkerBox, mergeListIndent, normalNotesOf, noteDisplayMarkMap, noteLineIdPrefix, noteMarkKey, noteSeparatorAreaBox, noteStoryBlocks, pagesToMaterialize, paragraphLayoutKey, paragraphMarkDeleted, paragraphShading, paragraphShadingBox, projectedNoteMarkText, provisionalNoteMarks, readNumPr, readTableStructure, resetGraphemeBoundary, resolveDefaultSurfaceMeasurer, resolveDefaultWordBoundary, resolveNumberingLevel, resolveOoxmlShadingFill, resolveParagraphLayoutInputs, resolveStoryListItems, resolveStrictHexFill, revisionRemovesParagraph, roundFontUnitToFixedPoint, segmentGraphemes, segmentWords, semanticHorizontalBoundaries, setGraphemeBoundary, shadingFillFromElement, shapedHorizontalBoundaries, storyBlocks, syntheticSeparatorBox, tableOriginX, tocFieldChromeParagraphIds, tryCreateCanvasMeasurer, utf16OffsetToGrapheme, walkStoryParagraphs, withNumberingStyleLinks, withResolvedListItems, wordBoundary, wordSegmentsToGraphemeRecords };
+export { AUTO_PREFERRED_WIDTH, type AbstractNumDefinition, type BidiEmbeddingLevels, BlockFragmentRecord, CELL_PAD, COMPOUND_BORDER_MIN_GAP_PT, COMPOUND_BORDER_MIN_STROKE_PT, type CanvasMeasurerOptions, type CanvasTextContext, type CanvasTextMetrics, type CascadedParagraphFormatting, CellBorderBox, type CellMarginsPt, type CellVerticalAlign, type CompoundBorderMetrics, type ContentControlFragmentRecord, DEFAULT_CANVAS_FONT_STACK, DEFAULT_CELL_MARGINS, EMPTY_NUMBERING_INDEX, FieldLinkProjector, FixedPoint, FixedPointRoundingMode, FontByteValidator, type FontSlot, GRAPHEME_SEGMENTER_LOCALE, type GraphemeBoundary, type GraphemeSegment, type GraphemeWordSegmentRecord, HARFBUZZ_SHAPING_LIBRARY, type HarfBuzzFaceCacheEvent, type HarfBuzzOutlineCacheEvent, type HarfBuzzShapeCacheEvent, HarfBuzzShapingError, type HarfBuzzShapingErrorCode, type HarfBuzzTextShaper, type HarfBuzzTextShaperInstrumentation, type HarfBuzzTextShaperOptions, type HeaderFooterVariantName, HyperlinkProjector, type KeyedRange, LayoutBox, type LayoutCacheStats, type LayoutScheduler, type LayoutSchedulerOptions, type LayoutScope, type LayoutSession, type LayoutSessionStats, type LevelOverride, type ListCounterAdvance, type ListCounterState, type ListMarkerAlign, type ListSuffix, MAX_EACH_PAGE_MARK_CANDIDATES, MAX_LVL_OVERRIDES, MAX_LVL_TEXT_LENGTH, MAX_MARKER_TEXT_LENGTH, MAX_NOTES_LAID_OUT, MAX_NOTE_FRAGMENTS, MAX_NOTE_OVERFLOW_PAGES, MAX_NOTE_REFLOW_ATTEMPTS, MAX_NUMBERING_DEFINITIONS, MAX_STYLE_BASED_ON_DEPTH, MAX_STYLE_DEFINITIONS, MAX_TABLE_COLUMNS, MAX_TABLE_NESTING, MAX_TABLE_ROW_FRAGMENTS, MAX_TABLE_ROW_HEIGHT_PT, type MaterializationInput, type NoteDisplayMark, type NoteLayoutFallbackReason, type NoteMarkContext, type NotePaginationFallbackReason, type NoteReferenceSite, type NoteSeparatorLayout, type NoteSeparatorRuleStyle, type NoteStoryDrawings, type NoteStoryLayout, type NotesAttachResult, type NotesLayoutInput, type NumDefinition, type NumberingIndex, type NumberingLevel, type NumberingLevelIndent, type PageFurniture, PageGeometry, PageRecord, type PageRefIndex, ParagraphBorderEdge, ParagraphBorders, ParagraphFragmentRecord, type ParagraphKeyInputs, type ParagraphLayoutCache, type ParagraphLayoutCacheOptions, type ParagraphLayoutInputs, ParagraphLineSpacing, ParagraphSpacing, type PreferredWidth, type PreferredWidthType, type ResolvedListItem, ResolvedRunStyle, type ResolvedSurfaceMeasurer, ResolvedTabStops, RevisionDisplayMode, type ScriptItem, SectionColumns, SelectionRect, SemanticLayout, type SemanticLayoutOptions, SemanticPosition, SemanticSelection, type SemanticTableCell, type SemanticTableRow, type SemanticTableStructure, ShapedRun, type StyleCascadeTable, type StyleDefinition, StyleSpanRecord, type TableAlignment, TableBorderBox, TableBorderSide, type TableCellStyleFormatting, TablePaginationError, type TablePaginationErrorCode, type TableRowHeight, type TableRowHeightRule, TextDirection, TextMeasurer, TextShaper, UnsupportedScriptError, VersionedShapingLibrary, type ViewportWindow, WORD_SEGMENTER_LOCALE, type WordBoundary, type WordBoundaryResolverDeps, type WordSegment, attachNotesToLayout, boundedFallbackWordSegments, buildNumberingIndex, buildPageRefIndex, buildStyleCascadeTable, cascadeParagraphFormatting, cascadeRunProperties, cascadedBottomBorder, clampListValue, computeDoubleBorderMetricsPt, computeFootnoteReserves, contentControlBoundaries, createBoundedFallbackWordBoundary, createDefaultWordBoundary, createFixedMeasurer, createHarfBuzzTextShaper, createIntlWordBoundary, createLayoutScheduler, createLayoutSession, createListCounterState, createParagraphLayoutCache, defaultNoteSeparatorRuleStyle, deriveNoteDisplayMarks, deriveNoteDisplayMarksResolved, documentOrder, effectiveBorderSide, emptyTocPlaceholderParagraphIds, emptyTocSuppressedResultParagraphIds, expandLvlText, filterRefsOnPage, findSeparatorNote, formatDecimal, formatDecimalZero, formatLowerLetter, formatLowerRoman, formatNumFmt, formatPageNumber, formatUpperLetter, formatUpperRoman, fragmentOwnsAtomOffset, graphemeBoundaryEpoch, graphemeCount, graphemeOffsetToUtf16, harfBuzzFontValidator, initializeHarfBuzz, intlGraphemeBoundary, isCanvasMeasurementAvailable, isCumulativeGeometryTrustedFromLineOrigin, isGeometryTrustedCaretOffset, isHarfBuzzInitialized, isIntlSegmenterAvailable, isIntlWordSegmenterAvailable, isMarkerOnlySeparatorNote, isValidStyleId, isWholeGraphemeHorizontalBoundary, itemizeScriptFontSlots, keyedRangeRects, layoutHeaderFooterStory, layoutNoteById, layoutNoteSeparator, layoutNoteStory, layoutSemanticDocument, listMarkerBox, mergeListIndent, normalNotesOf, noteDisplayMarkMap, noteLineIdPrefix, noteMarkKey, noteSeparatorAreaBox, noteStoryBlocks, pagesToMaterialize, paragraphLayoutKey, paragraphMarkDeleted, paragraphShading, paragraphShadingBox, projectedNoteMarkText, provisionalNoteMarks, readNumPr, readTableStructure, resetGraphemeBoundary, resolveDefaultSurfaceMeasurer, resolveDefaultWordBoundary, resolveNumberingLevel, resolveOoxmlShadingFill, resolveParagraphLayoutInputs, resolveStoryListItems, resolveStrictHexFill, revisionRemovesParagraph, roundFontUnitToFixedPoint, segmentGraphemes, segmentWords, selectionRects, semanticHorizontalBoundaries, setGraphemeBoundary, shadingFillFromElement, shapedHorizontalBoundaries, storyBlocks, syntheticSeparatorBox, tableOriginX, tocFieldChromeParagraphIds, tryCreateCanvasMeasurer, utf16OffsetToGrapheme, walkStoryParagraphs, withNumberingStyleLinks, withResolvedListItems, wordBoundary, wordSegmentsToGraphemeRecords };

package/dist/layout.js

@@ -1 +1 @@
-export{fa as AUTO_PARAGRAPH_SPACING_PT,Hb as AUTO_PREFERRED_WIDTH,Jb as CELL_PAD,$ as COMPOUND_BORDER_MIN_GAP_PT,_ as COMPOUND_BORDER_MIN_STROKE_PT,gd as DEFAULT_CANVAS_FONT_STACK,Lb as DEFAULT_CELL_MARGINS,Q as DEFAULT_PAGE_GEOMETRY,cb as DEFAULT_REVISION_DISPLAY_MODE,Ya as DEFAULT_RUN_STYLE,yc as DEFAULT_SECTION_PROPERTIES,Ca as DEFAULT_TAB_INTERVAL_PT,Ba as DEFAULT_TAB_INTERVAL_TWIPS,$b as DEFAULT_VERTICAL_WEIGHT,Sb as EMPTY_NUMBERING_INDEX,Ea as EMPTY_TAB_STOPS,p as GRAPHEME_SEGMENTER_LOCALE,g as HARFBUZZ_SHAPING_LIBRARY,j as HarfBuzzShapingError,ea as MAX_BORDER_SPACE_PT,da as MAX_BORDER_WIDTH_PT,xc as MAX_DOCUMENT_SECTIONS,Xc as MAX_EACH_PAGE_MARK_CANDIDATES,Pb as MAX_LVL_OVERRIDES,Na as MAX_LVL_TEXT_LENGTH,Ma as MAX_MARKER_TEXT_LENGTH,Jc as MAX_NOTES_LAID_OUT,Kc as MAX_NOTE_FRAGMENTS,Wc as MAX_NOTE_OVERFLOW_PAGES,Vc as MAX_NOTE_REFLOW_ATTEMPTS,Ob as MAX_NUMBERING_DEFINITIONS,ca as MAX_PARAGRAPH_SPACING_PT,ob as MAX_STYLE_BASED_ON_DEPTH,pb as MAX_STYLE_DEFINITIONS,zb as MAX_TABLE_BORDER_STROKES,Ib as MAX_TABLE_NESTING,pc as MAX_TABLE_ROW_FRAGMENTS,Kb as MAX_TABLE_ROW_HEIGHT_PT,Aa as MAX_TAB_POSITION_TWIPS,za as MAX_TAB_STOPS,ha as PARAGRAPH_BORDER_SIDES,P as ResolvedCache,ga as SINGLE_LINE_SPACING,Da as TAB_LEADER_GLYPH,qc as TablePaginationError,n as UnsupportedScriptError,E as WORD_SEGMENTER_LOCALE,ta as appliedSpaceBefore,ka as applyLineSpacing,ad as attachNotesToLayout,bb as baselineShiftPtOf,Gb as borderExtentPt,Db as borderWeight,qa as bottomBorderExtentPt,H as boundedFallbackWordSegments,Qb as buildNumberingIndex,Zc as buildPageRefIndex,rb as buildStyleCascadeTable,N as captureOperationSnapshot,rd as caretAt,ic as caretBoxOnLine,pd as caretStops,qd as caretStopsForBlocks,sb as cascadeParagraphFormatting,ub as cascadeRunProperties,tb as cascadedBottomBorder,na as cascadedParagraphBorders,Fa as cascadedTabStops,Cd as cellSelectionBetween,Fd as cellSelectionRects,Gd as cellSelectionText,Oa as clampListValue,sa as collapsedSpaceBefore,Ad as compositionAnchor,aa as computeDoubleBorderMetricsPt,$c as computeFootnoteReserves,fc as contentControlAtPoint,td as contentControlAtSemantic,kd as contentControlBoundaries,ud as contentControlsInLayout,X as contentControlsOfLayout,I as createBoundedFallbackWordBoundary,J as createDefaultWordBoundary,ed as createFixedMeasurer,m as createHarfBuzzTextShaper,G as createIntlWordBoundary,nd as createLayoutScheduler,dd as createLayoutSession,Tb as createListCounterState,kb as createParagraphLayoutCache,ld as createShapedMeasurer,e as createShapedRun,b as createShapingEnvironment,Qc as defaultNoteSeparatorRuleStyle,Ia as defaultTabIntervalFromSettings,Gc as deriveNoteDisplayMarks,Hc as deriveNoteDisplayMarksResolved,_a as displayText,xd as documentOrder,yb as effectiveBorderSide,Z as effectiveContentControlLock,vc as emptyTocPlaceholderParagraphIds,wc as emptyTocSuppressedResultParagraphIds,Dc as enumerateDocumentSections,Ec as enumerateDocumentSectionsBounded,Wa as expandLvlText,_c as filterRefsOnPage,jc as findDrawingOverlayFrameInLayout,Nc as findSeparatorNote,a as fixedPoint,Pa as formatDecimal,Qa as formatDecimalZero,Ua as formatLowerLetter,Sa as formatLowerRoman,Va as formatNumFmt,Xa as formatPageNumber,fb as formatRevisionOf,Ta as formatUpperLetter,Ra as formatUpperRoman,Yc as fragmentOwnsAtomOffset,V as fragmentsOfParagraph,Fc as geometryOfSection,s as graphemeBoundaryEpoch,w as graphemeCount,y as graphemeOffsetToUtf16,O as guardOperationSnapshot,k as harfBuzzFontValidator,cc as hitTestPage,sd as hitTestSemantic,ec as hitTestSheet,h as initializeHarfBuzz,r as intlGraphemeBoundary,hd as isCanvasMeasurementAvailable,C as isCumulativeGeometryTrustedFromLineOrigin,bc as isFurniturePoint,B as isGeometryTrustedCaretOffset,i as isHarfBuzzInitialized,q as isIntlSegmenterAvailable,F as isIntlWordSegmenterAvailable,Rc as isMarkerOnlySeparatorNote,qb as isValidStyleId,A as isWholeGraphemeHorizontalBoundary,o as itemizeScriptFontSlots,wd as keyedRangeRects,cd as layoutHeaderFooterStory,Pc as layoutNoteById,Sc as layoutNoteSeparator,Oc as layoutNoteStory,fd as layoutSemanticDocument,W as lineAtPosition,gc as lineEndOffset,T as linesOf,_b as listMarkerBox,$a as measureDisplayText,Wb as mergeListIndent,zd as moveCaret,Ja as nextTabDestination,Mc as normalNotesOf,Ic as noteDisplayMarkMap,Lc as noteLineIdPrefix,hb as noteMarkKey,Uc as noteSeparatorAreaBox,sc as noteStoryBlocks,ac as pageAtY,md as pagesToMaterialize,pa as paragraphBorderExtentPt,oa as paragraphBorderStrokeWidthPt,ma as paragraphBorders,ra as paragraphBordersFingerprint,ba as paragraphBreaksBefore,la as paragraphContextualSpacing,R as paragraphFragmentsOf,S as paragraphFragmentsOfBlocks,jb as paragraphLayoutKey,ja as paragraphLineSpacing,wb as paragraphMarkDeleted,eb as paragraphMarkRevisionOf,Bc as paragraphSectionNode,xa as paragraphShading,ya as paragraphShadingBox,ia as paragraphSpacing,Ga as paragraphTabStops,yd as paragraphTextFromLayout,Dd as paragraphsInCells,zc as parsePageNumbering,Ac as parseSectionProperties,ib as projectedNoteMarkText,bd as provisionalNoteMarks,Ab as readBorderSide,Cb as readCellBorders,Ub as readNumPr,Cc as readSectionProperties,Bb as readTableBorders,Nb as readTableStructure,v as resetGraphemeBoundary,Eb as resolveBorderConflict,jd as resolveDefaultSurfaceMeasurer,K as resolveDefaultWordBoundary,Rb as resolveNumberingLevel,va as resolveOoxmlShadingFill,vb as resolveParagraphLayoutInputs,Za as resolveRunStyle,Yb as resolveStoryListItems,ua as resolveStrictHexFill,Fb as resolveTableCellBorderGrid,xb as revisionRemovesParagraph,gb as revisionsAreDeletion,db as revisionsVisible,l as roundFontUnitToFixedPoint,ab as runStylesEqual,t as segmentGraphemes,L as segmentWords,vd as selectionRects,D as semanticHorizontalBoundaries,u as setGraphemeBoundary,wa as shadingFillFromElement,z as shapedHorizontalBoundaries,f as shapedRunComparatorInputs,d as shapingEnvironmentFingerprint,c as shapingEnvironmentFingerprintInputs,hc as spanOffsetX,Ed as spansInCells,Bd as spansInSelection,rc as storyBlocks,Tc as syntheticSeparatorBox,Ka as tabAdvanceWidth,La as tabStopsFingerprint,Hd as tableContextAt,Mb as tableOriginX,uc as tocFieldChromeParagraphIds,id as tryCreateCanvasMeasurer,Y as unionLayoutBoxes,x as utf16OffsetToGrapheme,Xb as walkStoryParagraphs,Ha as withDefaultTabInterval,Vb as withNumberingStyleLinks,Zb as withResolvedListItems,od as wordBoundary,M as wordSegmentsToGraphemeRecords}from'./chunk-SG7OH2EK.js';export{a as W15_NAMESPACE_URI,i as activeReviewItem,c as commentBodyText,d as commentInitials,f as firstReviewRange,k as reviewAnchorIndex,l as reviewItemGeometry,b as reviewItemKey,g as reviewItemPositionRank,e as reviewItemRanges,h as reviewItemsAt,j as reviewThreadRootOf}from'./chunk-4WWEDTTE.js';import'./chunk-33F6TRXO.js';export{d as FontResolutionError,c as HARD_MAX_AGGREGATE_FONT_BYTES,a as HARD_MAX_FONT_BYTES,b as HARD_MAX_FONT_SOURCES,Jb as MAX_SDT_NESTING,kf as MAX_TABLE_COLUMNS,j as boundedStructuralFontValidator,Ob as collectFlowBlocks,Nb as contentControlContentChildren,k as createFontResourceSnapshot,e as fontRequestKey,Kb as isContentControl,Lb as isContentControlContent,og as paragraphOrderOfPart,i as sha256FontBytes}from'./chunk-TCX3PVWR.js';
+export{fa as AUTO_PARAGRAPH_SPACING_PT,Nb as AUTO_PREFERRED_WIDTH,Pb as CELL_PAD,$ as COMPOUND_BORDER_MIN_GAP_PT,_ as COMPOUND_BORDER_MIN_STROKE_PT,pd as DEFAULT_CANVAS_FONT_STACK,Rb as DEFAULT_CELL_MARGINS,Q as DEFAULT_PAGE_GEOMETRY,cb as DEFAULT_REVISION_DISPLAY_MODE,Ya as DEFAULT_RUN_STYLE,Ic as DEFAULT_SECTION_PROPERTIES,Ca as DEFAULT_TAB_INTERVAL_PT,Ba as DEFAULT_TAB_INTERVAL_TWIPS,kc as DEFAULT_VERTICAL_WEIGHT,Yb as EMPTY_NUMBERING_INDEX,Ea as EMPTY_TAB_STOPS,p as GRAPHEME_SEGMENTER_LOCALE,g as HARFBUZZ_SHAPING_LIBRARY,j as HarfBuzzShapingError,ea as MAX_BORDER_SPACE_PT,da as MAX_BORDER_WIDTH_PT,Hc as MAX_DOCUMENT_SECTIONS,fd as MAX_EACH_PAGE_MARK_CANDIDATES,Vb as MAX_LVL_OVERRIDES,Na as MAX_LVL_TEXT_LENGTH,Ma as MAX_MARKER_TEXT_LENGTH,Tc as MAX_NOTES_LAID_OUT,Uc as MAX_NOTE_FRAGMENTS,ed as MAX_NOTE_OVERFLOW_PAGES,dd as MAX_NOTE_REFLOW_ATTEMPTS,Ub as MAX_NUMBERING_DEFINITIONS,ca as MAX_PARAGRAPH_SPACING_PT,sb as MAX_STYLE_BASED_ON_DEPTH,tb as MAX_STYLE_DEFINITIONS,Fb as MAX_TABLE_BORDER_STROKES,Ob as MAX_TABLE_NESTING,Ac as MAX_TABLE_ROW_FRAGMENTS,Qb as MAX_TABLE_ROW_HEIGHT_PT,Aa as MAX_TAB_POSITION_TWIPS,za as MAX_TAB_STOPS,ha as PARAGRAPH_BORDER_SIDES,P as ResolvedCache,ga as SINGLE_LINE_SPACING,Da as TAB_LEADER_GLYPH,Bc as TablePaginationError,n as UnsupportedScriptError,E as WORD_SEGMENTER_LOCALE,ta as appliedSpaceBefore,ka as applyLineSpacing,kd as attachNotesToLayout,bb as baselineShiftPtOf,Mb as borderExtentPt,Jb as borderWeight,qa as bottomBorderExtentPt,H as boundedFallbackWordSegments,Wb as buildNumberingIndex,hd as buildPageRefIndex,vb as buildStyleCascadeTable,N as captureOperationSnapshot,Cd as caretAt,tc as caretBoxOnLine,Ad as caretStops,Bd as caretStopsForBlocks,wb as cascadeParagraphFormatting,yb as cascadeRunProperties,xb as cascadedBottomBorder,na as cascadedParagraphBorders,Fa as cascadedTabStops,Kd as cellSelectionBetween,Nd as cellSelectionRects,Od as cellSelectionText,Oa as clampListValue,sa as collapsedSpaceBefore,Id as compositionAnchor,aa as computeDoubleBorderMetricsPt,jd as computeFootnoteReserves,qc as contentControlAtPoint,Ed as contentControlAtSemantic,td as contentControlBoundaries,Fd as contentControlsInLayout,X as contentControlsOfLayout,I as createBoundedFallbackWordBoundary,J as createDefaultWordBoundary,nd as createFixedMeasurer,m as createHarfBuzzTextShaper,G as createIntlWordBoundary,wd as createLayoutScheduler,md as createLayoutSession,Zb as createListCounterState,ob as createParagraphLayoutCache,ud as createShapedMeasurer,e as createShapedRun,b as createShapingEnvironment,_c as defaultNoteSeparatorRuleStyle,Ia as defaultTabIntervalFromSettings,Qc as deriveNoteDisplayMarks,Rc as deriveNoteDisplayMarksResolved,_a as displayText,fc as documentOrder,Eb as effectiveBorderSide,Z as effectiveContentControlLock,Ec as emptyTocPlaceholderParagraphIds,Fc as emptyTocSuppressedResultParagraphIds,Nc as enumerateDocumentSections,Oc as enumerateDocumentSectionsBounded,Wa as expandLvlText,id as filterRefsOnPage,uc as findDrawingOverlayFrameInLayout,Xc as findSeparatorNote,a as fixedPoint,Pa as formatDecimal,Qa as formatDecimalZero,Ua as formatLowerLetter,Sa as formatLowerRoman,Va as formatNumFmt,Xa as formatPageNumber,jb as formatRevisionOf,Ta as formatUpperLetter,Ra as formatUpperRoman,gd as fragmentOwnsAtomOffset,V as fragmentsOfParagraph,Pc as geometryOfSection,s as graphemeBoundaryEpoch,w as graphemeCount,y as graphemeOffsetToUtf16,O as guardOperationSnapshot,k as harfBuzzFontValidator,nc as hitTestPage,Dd as hitTestSemantic,pc as hitTestSheet,h as initializeHarfBuzz,r as intlGraphemeBoundary,qd as isCanvasMeasurementAvailable,C as isCumulativeGeometryTrustedFromLineOrigin,mc as isFurniturePoint,B as isGeometryTrustedCaretOffset,i as isHarfBuzzInitialized,q as isIntlSegmenterAvailable,F as isIntlWordSegmenterAvailable,$c as isMarkerOnlySeparatorNote,ub as isValidStyleId,A as isWholeGraphemeHorizontalBoundary,o as itemizeScriptFontSlots,yd as keyedRangeRects,Gc as layoutHeaderFooterStory,Zc as layoutNoteById,ad as layoutNoteSeparator,Yc as layoutNoteStory,od as layoutSemanticDocument,W as lineAtPosition,rc as lineEndOffset,T as linesOf,ec as listMarkerBox,hb as markRevisionRemovesMark,$a as measureDisplayText,ac as mergeListIndent,Hd as moveCaret,Ja as nextTabDestination,Wc as normalNotesOf,Sc as noteDisplayMarkMap,Vc as noteLineIdPrefix,lb as noteMarkKey,cd as noteSeparatorAreaBox,Db as noteStoryBlocks,lc as pageAtY,vd as pagesToMaterialize,pa as paragraphBorderExtentPt,oa as paragraphBorderStrokeWidthPt,ma as paragraphBorders,ra as paragraphBordersFingerprint,ba as paragraphBreaksBefore,la as paragraphContextualSpacing,R as paragraphFragmentsOf,S as paragraphFragmentsOfBlocks,nb as paragraphLayoutKey,ja as paragraphLineSpacing,Ab as paragraphMarkDeleted,fb as paragraphMarkFormatRevisionOf,ib as paragraphMarkRevisionOf,eb as paragraphMarkRevisionsOf,Lc as paragraphSectionNode,xa as paragraphShading,ya as paragraphShadingBox,ia as paragraphSpacing,Ga as paragraphTabStops,Gd as paragraphTextFromLayout,Ld as paragraphsInCells,Jc as parsePageNumbering,Kc as parseSectionProperties,mb as projectedNoteMarkText,ld as provisionalNoteMarks,Gb as readBorderSide,Ib as readCellBorders,_b as readNumPr,Mc as readSectionProperties,Hb as readTableBorders,Tb as readTableStructure,v as resetGraphemeBoundary,Kb as resolveBorderConflict,sd as resolveDefaultSurfaceMeasurer,K as resolveDefaultWordBoundary,Xb as resolveNumberingLevel,va as resolveOoxmlShadingFill,zb as resolveParagraphLayoutInputs,Za as resolveRunStyle,cc as resolveStoryListItems,ua as resolveStrictHexFill,Lb as resolveTableCellBorderGrid,Bb as revisionRemovesParagraph,kb as revisionsAreDeletion,db as revisionsVisible,l as roundFontUnitToFixedPoint,ab as runStylesEqual,t as segmentGraphemes,L as segmentWords,xd as selectionRects,D as semanticHorizontalBoundaries,u as setGraphemeBoundary,wa as shadingFillFromElement,z as shapedHorizontalBoundaries,f as shapedRunComparatorInputs,d as shapingEnvironmentFingerprint,c as shapingEnvironmentFingerprintInputs,gb as shownMarkRevision,sc as spanOffsetX,Md as spansInCells,Jd as spansInSelection,Cb as storyBlocks,bd as syntheticSeparatorBox,Ka as tabAdvanceWidth,La as tabStopsFingerprint,Pd as tableContextAt,Sb as tableOriginX,Dc as tocFieldChromeParagraphIds,rd as tryCreateCanvasMeasurer,Y as unionLayoutBoxes,x as utf16OffsetToGrapheme,bc as walkStoryParagraphs,Ha as withDefaultTabInterval,$b as withNumberingStyleLinks,dc as withResolvedListItems,zd as wordBoundary,M as wordSegmentsToGraphemeRecords}from'./chunk-T252F4US.js';export{a as W15_NAMESPACE_URI,i as activeReviewItem,k as anchorLineY,c as commentBodyText,d as commentInitials,f as firstReviewRange,l as reviewAnchorIndex,m as reviewItemGeometry,b as reviewItemKey,g as reviewItemPositionRank,e as reviewItemRanges,h as reviewItemsAt,j as reviewThreadRootOf}from'./chunk-UVIUNAQ6.js';import'./chunk-YTZIGUXT.js';export{d as FontResolutionError,c as HARD_MAX_AGGREGATE_FONT_BYTES,a as HARD_MAX_FONT_BYTES,b as HARD_MAX_FONT_SOURCES,Kb as MAX_SDT_NESTING,pf as MAX_TABLE_COLUMNS,j as boundedStructuralFontValidator,Pb as collectFlowBlocks,Ob as contentControlContentChildren,k as createFontResourceSnapshot,e as fontRequestKey,Lb as isContentControl,Mb as isContentControlContent,tg as paragraphOrderOfPart,i as sha256FontBytes}from'./chunk-LJIX4ZDF.js';

package/dist/{note-nodes-C6DLxlvj.d.cts → note-nodes-B2wWES2L.d.cts}

@@ -1,4 +1,4 @@
-import { O as OoxmlNode, f as OoxmlParagraphNode, g as OoxmlNoteNode, h as OoxmlContinuationSeparatorNode, i as OoxmlEndnotesNode, j as OoxmlFootnotesNode, k as OoxmlNoteRefNode, l as OoxmlNoteReferenceNode, m as OoxmlSeparatorNode } from './ooxml-tree-BU0e3DVi.cjs';
+import { O as OoxmlNode, f as OoxmlParagraphNode, g as OoxmlNoteNode, h as OoxmlContinuationSeparatorNode, i as OoxmlEndnotesNode, j as OoxmlFootnotesNode, k as OoxmlNoteRefNode, l as OoxmlNoteReferenceNode, m as OoxmlSeparatorNode } from './ooxml-tree-CG0odFyi.cjs';
 
 /** UTF-16 placeholder for one atomic note unit in `paragraphTextOf` / segments. */
 declare const NOTE_ATOM_CHAR = "\uFFFC";

package/dist/{note-nodes-BPSTVDMr.d.ts → note-nodes-CZQXU6Fg.d.ts}

@@ -1,4 +1,4 @@
-import { O as OoxmlNode, f as OoxmlParagraphNode, g as OoxmlNoteNode, h as OoxmlContinuationSeparatorNode, i as OoxmlEndnotesNode, j as OoxmlFootnotesNode, k as OoxmlNoteRefNode, l as OoxmlNoteReferenceNode, m as OoxmlSeparatorNode } from './ooxml-tree-BU0e3DVi.js';
+import { O as OoxmlNode, f as OoxmlParagraphNode, g as OoxmlNoteNode, h as OoxmlContinuationSeparatorNode, i as OoxmlEndnotesNode, j as OoxmlFootnotesNode, k as OoxmlNoteRefNode, l as OoxmlNoteReferenceNode, m as OoxmlSeparatorNode } from './ooxml-tree-CG0odFyi.js';
 
 /** UTF-16 placeholder for one atomic note unit in `paragraphTextOf` / segments. */
 declare const NOTE_ATOM_CHAR = "\uFFFC";

package/dist/{review-reads-CQmU9Lcl.d.ts → note-properties-BS66XmcC.d.ts}

@@ -1,70 +1,6 @@
-import { e as OoxmlPart, O as OoxmlNode, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.js';
-import { O as OoxmlPackage } from './ooxml-package-D_CtywTW.js';
-import { R as RevisionAddress } from './tree-op-types-8a6xyRCN.js';
-
-/** `w:pos` — where a section's footnotes are laid out. */
-type FootnotePosition = 'pageBottom' | 'beneathText' | 'sectEnd' | 'docEnd';
-/** `w:pos` for endnotes — only the two document-level placements are legal. */
-type EndnotePosition = 'sectEnd' | 'docEnd';
-/** `w:numRestart` — when note numbering starts over. `eachPage` needs the reference's page. */
-type NoteNumRestart = 'continuous' | 'eachSect' | 'eachPage';
-/** Authored subset — only keys present in the file appear. */
-interface AuthoredNoteProperties {
-    readonly pos?: string;
-    readonly numFmt?: string;
-    readonly numStart?: number;
-    readonly numRestart?: string;
-}
-/** Fully resolved footnote properties (defaults filled). */
-interface ResolvedFootnoteProperties {
-    readonly pos: FootnotePosition;
-    readonly numFmt: string;
-    readonly numStart: number;
-    readonly numRestart: NoteNumRestart;
-}
-/** Fully resolved endnote properties (defaults filled). */
-interface ResolvedEndnoteProperties {
-    readonly pos: EndnotePosition;
-    readonly numFmt: string;
-    readonly numStart: number;
-    readonly numRestart: NoteNumRestart;
-}
-/** Word's own footnote defaults, applied where a section declares no `w:footnotePr`. */
-declare const DEFAULT_FOOTNOTE_PROPERTIES: ResolvedFootnoteProperties;
-/**
- * Word-compatible defaults. ECMA-376 says omitted endnote `numFmt` is decimal;
- * MS-OE376 / MS-OI29500 document that Word’s default is `lowerRoman` instead.
- * Resolved (not authored) — unedited packages still invent nothing on save.
- */
-declare const DEFAULT_ENDNOTE_PROPERTIES: ResolvedEndnoteProperties;
-/** Parse authored CT_FtnProps / CT_EdnProps without inventing defaults. */
-declare function parseAuthoredNoteProperties(propsNode: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
-/** Authored footnotePr on a sectPr node. */
-declare function authoredFootnotePropertiesFromSectPr(sectPr: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
-/** Authored endnotePr on a sectPr node. */
-declare function authoredEndnotePropertiesFromSectPr(sectPr: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
-/** Locate settings.xml via the main document relationship when present. */
-declare function settingsPartOf(pkg: OoxmlPackage): OoxmlPart | null;
-/** Authored document-level footnotePr from settings. */
-declare function authoredDocumentFootnoteProperties(settings: OoxmlPart | null | undefined): AuthoredNoteProperties | undefined;
-/** Authored document-level endnotePr from settings. */
-declare function authoredDocumentEndnoteProperties(settings: OoxmlPart | null | undefined): AuthoredNoteProperties | undefined;
-/**
- * Resolve footnote properties: section → document → defaults.
- * Illegal position strings fall through to the next layer / default.
- */
-declare function resolveFootnoteProperties(section?: AuthoredNoteProperties, document?: AuthoredNoteProperties): ResolvedFootnoteProperties;
-/**
- * Resolve endnote properties: section → document → defaults.
- * `pageBottom` is never a legal endnote position — falls back.
- */
-declare function resolveEndnoteProperties(section?: AuthoredNoteProperties, document?: AuthoredNoteProperties): ResolvedEndnoteProperties;
-/** Validate an authored endnote position write — refuse `pageBottom`. */
-declare function isLegalEndnotePosition(pos: string): pos is EndnotePosition;
-/** Validate an authored footnote position write. */
-declare function isLegalFootnotePosition(pos: string): pos is FootnotePosition;
-/** Whether a file-supplied string is a legal `w:numRestart` value. Narrows the type. */
-declare function isLegalNumRestart(value: string): value is NoteNumRestart;
+import { a as OoxmlElement, e as OoxmlPart, O as OoxmlNode } from './ooxml-tree-CG0odFyi.js';
+import { R as RevisionAddress } from './tree-op-types-CZw9QhWX.js';
+import { O as OoxmlPackage } from './ooxml-package-BrxTmTsZ.js';
 
 /** The `w15` namespace: `commentsExtended.xml` — thread parent and resolved state. */
 declare const W15_NAMESPACE_URI = "http://schemas.microsoft.com/office/word/2012/wordml";
@@ -196,12 +132,34 @@ interface ReviewRevisionItem {
     /** The words a replacement removes. Empty for every other kind. */
     readonly replacedText: string;
     readonly revisionKind: ReviewRevisionKind;
+    /**
+     * WHICH decision a `paragraphMark` records, absent for every other kind.
+     *
+     * `EG_ParaRPrTrackChanges` is `ins? del? moveFrom? moveTo?`, and the four say opposite
+     * things about the same break: one proposes it, another proposes taking it away. Collapsing
+     * them into the single kind lost that, and a card then described a deleted break as an
+     * inserted one — the reverse of what Accept on that card does.
+     */
+    readonly markDirection?: 'insert' | 'delete' | 'moveFrom' | 'moveTo';
     readonly author: string;
     readonly date?: string;
     /** Text the revision covers, for the card summary. Empty for changes with no characters. */
     readonly text: string;
     /** Every site this decision touches, in document order. */
     readonly ranges: readonly ReviewRange[];
+    /**
+     * How deeply this change is NESTED inside other changes, 0 for an unenclosed one.
+     *
+     * Revisions nest for real, and OOXML has no other way to say what happened: `w:ins` wrapping
+     * `w:del` is content one reviewer added and another struck. Both stay pending, because each
+     * author has to be answered separately, so both are cards — over one identical range.
+     *
+     * A range therefore cannot say which change a position is "in", and this is what settles it.
+     * Word treats the innermost change as the operative one: the words are struck on the page
+     * because of the deletion, and accepting the change under them performs that deletion. So the
+     * deepest card wins the caret, and the one enclosing it stays listed and reachable.
+     */
+    readonly nesting: number;
     /**
      * How many leading `ranges` are the STRUCK half of a replacement.
      *
@@ -347,6 +305,8 @@ interface LinkableReviewItem {
     readonly parentRevisionId?: string;
     readonly replyIds?: readonly string[];
     readonly orphaned?: boolean;
+    /** How deeply a revision is nested; absent on the kinds that cannot nest. */
+    readonly nesting?: number;
 }
 /**
  * Attach each comment that answers a tracked change to the change it answers.
@@ -405,4 +365,68 @@ declare function reviewItemRanges(item: ReviewItem): readonly ReviewRange[];
 /** The range an item is anchored at — where its card belongs and how it sorts. */
 declare function firstReviewRange(item: ReviewItem): ReviewRange | null;
 
+/** `w:pos` — where a section's footnotes are laid out. */
+type FootnotePosition = 'pageBottom' | 'beneathText' | 'sectEnd' | 'docEnd';
+/** `w:pos` for endnotes — only the two document-level placements are legal. */
+type EndnotePosition = 'sectEnd' | 'docEnd';
+/** `w:numRestart` — when note numbering starts over. `eachPage` needs the reference's page. */
+type NoteNumRestart = 'continuous' | 'eachSect' | 'eachPage';
+/** Authored subset — only keys present in the file appear. */
+interface AuthoredNoteProperties {
+    readonly pos?: string;
+    readonly numFmt?: string;
+    readonly numStart?: number;
+    readonly numRestart?: string;
+}
+/** Fully resolved footnote properties (defaults filled). */
+interface ResolvedFootnoteProperties {
+    readonly pos: FootnotePosition;
+    readonly numFmt: string;
+    readonly numStart: number;
+    readonly numRestart: NoteNumRestart;
+}
+/** Fully resolved endnote properties (defaults filled). */
+interface ResolvedEndnoteProperties {
+    readonly pos: EndnotePosition;
+    readonly numFmt: string;
+    readonly numStart: number;
+    readonly numRestart: NoteNumRestart;
+}
+/** Word's own footnote defaults, applied where a section declares no `w:footnotePr`. */
+declare const DEFAULT_FOOTNOTE_PROPERTIES: ResolvedFootnoteProperties;
+/**
+ * Word-compatible defaults. ECMA-376 says omitted endnote `numFmt` is decimal;
+ * MS-OE376 / MS-OI29500 document that Word’s default is `lowerRoman` instead.
+ * Resolved (not authored) — unedited packages still invent nothing on save.
+ */
+declare const DEFAULT_ENDNOTE_PROPERTIES: ResolvedEndnoteProperties;
+/** Parse authored CT_FtnProps / CT_EdnProps without inventing defaults. */
+declare function parseAuthoredNoteProperties(propsNode: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
+/** Authored footnotePr on a sectPr node. */
+declare function authoredFootnotePropertiesFromSectPr(sectPr: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
+/** Authored endnotePr on a sectPr node. */
+declare function authoredEndnotePropertiesFromSectPr(sectPr: OoxmlNode | null | undefined): AuthoredNoteProperties | undefined;
+/** Locate settings.xml via the main document relationship when present. */
+declare function settingsPartOf(pkg: OoxmlPackage): OoxmlPart | null;
+/** Authored document-level footnotePr from settings. */
+declare function authoredDocumentFootnoteProperties(settings: OoxmlPart | null | undefined): AuthoredNoteProperties | undefined;
+/** Authored document-level endnotePr from settings. */
+declare function authoredDocumentEndnoteProperties(settings: OoxmlPart | null | undefined): AuthoredNoteProperties | undefined;
+/**
+ * Resolve footnote properties: section → document → defaults.
+ * Illegal position strings fall through to the next layer / default.
+ */
+declare function resolveFootnoteProperties(section?: AuthoredNoteProperties, document?: AuthoredNoteProperties): ResolvedFootnoteProperties;
+/**
+ * Resolve endnote properties: section → document → defaults.
+ * `pageBottom` is never a legal endnote position — falls back.
+ */
+declare function resolveEndnoteProperties(section?: AuthoredNoteProperties, document?: AuthoredNoteProperties): ResolvedEndnoteProperties;
+/** Validate an authored endnote position write — refuse `pageBottom`. */
+declare function isLegalEndnotePosition(pos: string): pos is EndnotePosition;
+/** Validate an authored footnote position write. */
+declare function isLegalFootnotePosition(pos: string): pos is FootnotePosition;
+/** Whether a file-supplied string is a legal `w:numRestart` value. Narrows the type. */
+declare function isLegalNumRestart(value: string): value is NoteNumRestart;
+
 export { type AuthoredNoteProperties as A, isLegalEndnotePosition as B, type CommentAnchor as C, DEFAULT_ENDNOTE_PROPERTIES as D, type EndnotePosition as E, type FootnotePosition as F, isLegalFootnotePosition as G, isLegalNumRestart as H, linkRevisionReplies as I, parseAuthoredNoteProperties as J, resolveEndnoteProperties as K, type LinkableReviewItem as L, resolveFootnoteProperties as M, type NoteNumRestart as N, reviewItemKey as O, reviewItemRanges as P, revisionItemsOf as Q, type ResolvedFootnoteProperties as R, settingsPartOf as S, threadStateOfPart as T, W15_NAMESPACE_URI as W, type ResolvedEndnoteProperties as a, type CommentPosition as b, type CommentRecord as c, type CommentThreadState as d, DEFAULT_FOOTNOTE_PROPERTIES as e, type ReviewCommentItem as f, type ReviewItem as g, type ReviewModelInput as h, type ReviewPosition as i, type ReviewRange as j, type ReviewRevisionItem as k, type ReviewRevisionKind as l, authoredDocumentEndnoteProperties as m, authoredDocumentFootnoteProperties as n, authoredEndnotePropertiesFromSectPr as o, paragraphOrderOfPart as p, authoredFootnotePropertiesFromSectPr as q, collectReviewItems as r, commentAnchorsOfStory as s, commentBodyText as t, commentInitials as u, commentItemsOf as v, commentsOfPart as w, deepParagraphOrderOfPart as x, firstReviewRange as y, hasAnyComment as z };