@docx-editor.dev/core 2.26.0 → 2.28.0

package/dist/layout.d.ts

@@ -1,20 +1,35 @@
-import { n as NumberingLevel, o as NumberingIndex, S as SemanticLayout, p as LayoutBox, D as DrawingPoint, q as DrawingInsets, a as StyleSpanRecord, I as InlineDrawingRecord, M as ModelRange, r as TableBorderSide, s as TableFloatXSpec, t as TableFloatYSpec, P as ParagraphFragmentRecord, B as BlockFragmentRecord, A as AnchoredDrawingRecord, u as PageRecord, v as ResolvedListItem, w as RefFieldContext, T as TextMeasurer, x as InlineDrawingLayoutContext, y as CellBorderBox, z as TableCellStyleFormatting, E as TableFloatPosition, G as TableBorderBox, H as StyleCascadeTable, L as LineRecord, J as NoteAreaRecord, K as HeaderFooterStoryRecord, O as NoteStoryRecord, C as ContentControlBoundaryRecord$1, Q as ContentControlLock, h as FixedPointRoundingMode, U as FixedPoint, V as VersionedShapingLibrary, f as TextShaper, W as FontByteValidator, m as ShapedRun, X as SourceRange, Y as HyperlinkProjector, Z as FieldLinkProjector, _ as StoryPageFieldNeeds, $ as HyperlinkFieldSpec, a0 as SpanLinkRecord, b as SectionPageBorders, a1 as PageBorderFrameRecord, a2 as ParagraphBorderStrokeRecord, a3 as StrikeoutStrokePt } from './semantic-records-COqi8pjP.js';
-export { a4 as AUTO_PARAGRAPH_SPACING_PT, a5 as AbstractNumDefinition, a6 as AnchoredDrawingLayoutFallback, a7 as BidiEmbeddingLevels, a8 as BorderGridGeometry, a9 as CascadedParagraphFormatting, aa as CjkTypographySettings, ab as ContentControlGeometryFragment, ac as ContentControlLevel, ad as ContentControlMappedType, ae as DEFAULT_RUN_STYLE, af as DEFAULT_TAB_INTERVAL_PT, ag as DEFAULT_TAB_INTERVAL_TWIPS, ah as DeclaredFontSubstitution, ai as DrawingClipFallback, aj as DrawingGeometry, ak as DrawingGroupPictureRecord, al as EMPTY_NUMBERING_INDEX, am as EMPTY_TAB_STOPS, an as EquationFractionGeometry, ao as EquationGeometry, ap as EquationNaryGeometry, aq as EquationRadicalGeometry, ar as EquationRowGeometry, as as EquationScriptGeometry, at as EquationSpanRecord, au as EquationTextGeometry, av as FieldAtomMarker, aw as FontFingerprintInputs, i as FontRequest, ax as FontResolutionError, ay as FontResolutionErrorCode, az as FontResourceDefinition, aA as FontResourceInstrumentation, F as FontResourceSnapshot, aB as FontResourceSnapshotOptions, aC as FontSlot, l as FontSubstitution, aD as FontValidationResult, aE as GlyphOutline, aF as HARD_MAX_AGGREGATE_FONT_BYTES, aG as HARD_MAX_FONT_BYTES, aH as HARD_MAX_FONT_SOURCES, aI as LevelOverride, aJ as LineSpacingRule, aK as ListMarkerAlign, k as ListMarkerPictureRecord, aL as ListMarkerRecord, aM as ListSuffix, aN as MAX_BORDER_SPACE_PT, aO as MAX_BORDER_WIDTH_PT, aP as MAX_LVL_OVERRIDES, aQ as MAX_NUMBERING_DEFINITIONS, aR as MAX_PARAGRAPH_SPACING_PT, aS as MAX_SHAPING_CONTEXT, aT as MAX_STYLE_DEFINITIONS, aU as MAX_TABLE_BORDER_STROKES, aV as MAX_TAB_POSITION_TWIPS, aW as MAX_TAB_STOPS, N as NormalizationPolicy, aX as NumDefinition, aY as NumberingLevelIndent, aZ as NumberingPictureBullet, a_ as PAGE_BORDER_SIDES, a$ as PARAGRAPH_BORDER_SIDES, b0 as PageBorderDisplay, b1 as PageBorderOffsetFrom, b2 as PageBorderSide, b3 as PageBorderStrokeRecord, b4 as PageBorderZOrder, b5 as PageRefCalibrationCell, b6 as PageRefFieldProjection, b7 as ParagraphAutoSpacingContext, b8 as ParagraphBorderEdge, b9 as ParagraphBorderSide, ba as ParagraphBorders, bb as ParagraphBottomBorderRecord, bc as ParagraphIndent, bd as ParagraphLayoutInputs, be as ParagraphLineSpacing, bf as ParagraphSpacing, bg as RefFieldSpec, bh as RefNoteParts, bi as ResolvedCellBorders, g as ResolvedFont, bj as ResolvedPictureBullet, R as ResolvedRunStyle, bk as ResolvedTabStops, bl as ResolvedTableBorderEdge, bm as ResolvedTableBorderEdgeSegment, bn as ResolvedUnderline, bo as SINGLE_LINE_SPACING, bp as ScriptItem, bq as SemanticArtifactRootStoryKind, br as SemanticArtifactStoryKind, bs as SemanticCommentArtifactRecord, bt as SemanticReviewArtifactOccurrence, bu as SemanticReviewArtifactOccurrenceGeometry, bv as SemanticReviewArtifactPosition, j as SemanticReviewArtifactRecord, bw as SemanticReviewArtifactSource, bx as SemanticTrackedChangeArtifactRecord, by as ShapeInput, bz as ShapedCluster, bA as ShapedFontSpan, bB as ShapedGlyph, bC as ShapedRunComparatorInputs, bD as ShapedVerticalMetrics, bE as ShapingContext, bF as ShapingEnvironment, bG as ShapingEnvironmentFingerprintInputs, e as ShapingEnvironmentInput, bH as StyleDefinition, bI as TAB_LEADER_GLYPH, bJ as TabAlignment, bK as TabDestination, bL as TabLeader, bM as TabStop, bN as TableBorderSideName, bO as TableBorderStrokeRecord, d as TableCellFragmentRecord, bP as TableFragmentRecord, c as TableRowFragmentRecord, bQ as TextDirection, bR as TextboxStoryFallbackReason, bS as TextboxStoryLayout, bT as UnsupportedScriptError, bU as VerticalAlign, bV as appliedSpaceBefore, bW as applyLineSpacing, bX as baselineShiftPtOf, bY as borderExtentPt, bZ as borderWeight, b_ as bottomBorderExtentPt, b$ as boundedStructuralFontValidator, c0 as buildNumberingIndex, c1 as buildStyleCascadeTable, c2 as cascadeParagraphFormatting, c3 as cascadeRunProperties, c4 as cascadedBottomBorder, c5 as cascadedParagraphBorders, c6 as cascadedTabStops, c7 as collapsedSpaceBefore, c8 as createFontResourceSnapshot, c9 as createShapedRun, ca as createShapingEnvironment, cb as defaultTabIntervalFromSettings, cc as displayText, cd as fixedPoint, ce as fontRequestKey, cf as glyphSizeFactorOf, cg as isValidStyleId, ch as itemizeScriptFontSlots, ci as layoutEquation, cj as measureDisplayText, ck as mergeListIndent, cl as nextTabDestination, cm as pageBordersFingerprint, cn as paragraphBorderExtentPt, co as paragraphBorderStrokeWidthPt, cp as paragraphBorders, cq as paragraphBordersFingerprint, cr as paragraphBreaksBefore, cs as paragraphContextualSpacing, ct as paragraphLineSpacing, cu as paragraphSpacing, cv as paragraphTabStops, cw as parsePageBorders, cx as parseRefInstruction, cy as readBorderSide, cz as readCellBorders, cA as readNumPr, cB as readTableBorders, cC as resolveBorderConflict, cD as resolveNumberingLevel, cE as resolveParagraphLayoutInputs, cF as resolveRunStyle, cG as resolveStoryListItems, cH as resolveStoryRefFields, cI as resolveTableCellBorderGrid, cJ as runStylesEqual, cK as shapedRunComparatorInputs, cL as shapingEnvironmentFingerprint, cM as shapingEnvironmentFingerprintInputs, cN as styleForFontSlot, cO as tabAdvanceWidth, cP as tabStopsFingerprint, cQ as walkStoryParagraphs, cR as withDefaultTabInterval, cS as withNumberingStyleLinks, cT as withResolvedListItems } from './semantic-records-COqi8pjP.js';
-export { C as CacheLookup, b as CacheMiss, c as CacheProvenance, e as LayoutEnvironmentShapedMeasurerOptions, f as LayoutFontConfiguration, g as LayoutFontSource, h as LayoutFontSubstitution, i as LayoutShapingConfigurationError, j as LayoutShapingEnvironment, L as LayoutShapingInstrumentation, a as LayoutShapingOptions, O as OperationSnapshot, k as OperationSnapshotField, l as OperationSnapshotGuard, P as PreparedLayoutFontConfiguration, R as ResolvedCache, m as ResourceDependencyProvenance, S as ShapedMeasurerOptions, n as captureOperationSnapshot, o as createLayoutShapedMeasurer, p as createLayoutShaping, q as createShapedMeasurer, d as disposeLayoutShaping, r as guardOperationSnapshot, s as layoutFontConfigurationFingerprint, t as prepareLayoutFontConfiguration } from './layout-shaping-DWitwY73.js';
-import { aC as ImpactClass, N as OoxmlNode, X as OoxmlProperty, Z as OoxmlElement, O as OoxmlPart, W as TreeDocOp, Q as OoxmlPackage, b6 as ContentControlKind, b7 as ContentControlLevel, b9 as ContentControlLock$1, b3 as ContentControlDataBinding, a as ReviewItem } from './types-barrel-BO73JqHG.js';
-export { a_ as CommentAnchor, a$ as CommentPosition, C as CommentRecord, aV as CommentThreadState, aH as DrawingAccessibility, aj as DrawingHorizontalReferenceFrame, aI as DrawingImageEffects, aJ as DrawingTransform, ak as DrawingVerticalReferenceFrame, aa as ImageWrapTarget, c as ReviewCommentItem, d as ReviewCustomItem, R as ReviewModelInput, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind, a8 as SourceCrop, aG as TableBorderStyle, dx as VectorShapeComponent, aK as VectorShapeProjection, cp as W15_NAMESPACE_URI, dy as activeReviewItem, cT as firstReviewRange, dn as reviewItemKey, dz as reviewItemPositionRank, dp as reviewItemRanges, dA as reviewItemsAt, dB as reviewThreadRootOf } from './types-barrel-BO73JqHG.js';
-import { D as DocumentProperties, H as HeadlessDocumentView, r as relationshipTargetIn } from './headless-document-view-R9bzzepb.js';
-import { c as RevisionAttribution, a as RevisionDisplayMode, b as RevisionAuthorFilter } from './revision-projection-DfWxdBqA.js';
-export { D as DEFAULT_REVISION_DISPLAY_MODE, d as RevisionFilter, e as RevisionKind, f as formatRevisionOf, m as markRevisionRemovesMark, p as paragraphMarkFormatRevisionOf, g as paragraphMarkRevisionOf, h as paragraphMarkRevisionsOf, r as revisionAuthorFilter, i as revisionsAreDeletion, j as revisionsVisible, s as shownMarkRevision } from './revision-projection-DfWxdBqA.js';
-import { b as ResolvedFootnoteProperties, R as ResolvedEndnoteProperties } from './note-properties-CmfvOJsi.js';
-import { b as TreeModelChange, N as NoteKind, az as noteTypeOf } from './tree-package-fragment-YPyYC1aD.js';
-import { P as PageGeometry, a as SectionColumns } from './semantic-cell-selection-Dy_BmmpL.js';
-export { C as CellSelection, D as DEFAULT_PAGE_GEOMETRY, b as DEFAULT_SECTION_PROPERTIES, c as DEFAULT_VERTICAL_WEIGHT, d as DocumentSection, e as DocumentSectionsEnumeration, f as DrawingOverlayFrame, H as HitPoint, g as HitTestOptions, M as MAX_DOCUMENT_SECTIONS, h as PlacedCell, i as SectionBreakType, j as SectionColumnDefinition, k as SectionMargins, l as SectionPageNumbering, S as SectionProperties, m as SemanticHit, n as SemanticHitDrawing, T as TableCellAddress, o as TableCellContext, p as caretBoxOnLine, q as cellSelectionBetween, r as cellSelectionRects, s as cellSelectionText, t as contentControlAtPoint, u as enumerateDocumentSections, v as enumerateDocumentSectionsBounded, w as findDrawingOverlayFrameInLayout, x as geometryOfSection, y as hitTestPage, z as hitTestSheet, A as isFurniturePoint, B as lineEndOffset, E as pageAtY, F as paragraphSectionNode, G as paragraphsInCells, I as parsePageNumbering, J as parseSectionProperties, K as projectedSectionSourceIndexes, L as readSectionProperties, N as spanOffsetX, O as spansInCells, Q as tableContextAt } from './semantic-cell-selection-Dy_BmmpL.js';
-export { M as MAX_SDT_NESTING, c as collectFlowBlocks, a as commentBodyText, b as commentInitials, j as contentControlContentChildren, i as isContentControl, f as isContentControlContent, p as paragraphOrderOfPart } from './review-paragraph-order-Dc8Q6tfM.js';
-import { S as SemanticPosition, b as SelectionRect, a as SemanticSelection } from './semantic-interaction-CvFAj0GR.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 deletedTextBoundaries, k as hitTestSemantic, m as moveCaret, p as paragraphTextFromLayout, s as spansInSelection } from './semantic-interaction-CvFAj0GR.js';
-import './image-resources-DfagDguq.js';
-import './omml-equation-CZ6IG2ja.js';
+/**
+ * `@docx-editor.dev/core/layout` — DOM-free pagination, shaping, and hit testing.
+ *
+ * Text is measured through an injected `TextMeasurer` and shaped through an injected
+ * `TextShaper`, so the same code paginates in a browser and on a server. Points everywhere;
+ * twips convert at property-read boundaries.
+ *
+ * Incremental by construction: per-block cache keys and flow checkpoints mean a pass that
+ * changes nothing returns the previous pages by identity.
+ *
+ * @packageDocumentation
+ * @public
+ */
+import { s as NumberingLevel, t as NumberingIndex, S as SemanticLayout, b as LayoutBox, D as DrawingPoint, u as DrawingInsets, e as StyleSpanRecord, I as InlineDrawingRecord, M as ModelRange, v as TableBorderSide, w as TableFloatXSpec, x as TableFloatYSpec, P as ParagraphFragmentRecord, B as BlockFragmentRecord, A as AnchoredDrawingRecord, a as PageRecord, y as ResolvedListItem, z as RefFieldContext, T as TextMeasurer, E as InlineDrawingLayoutContext, G as CellBorderBox, J as TableBorderBox, K as TableCellStyleFormatting, O as TableFloatPosition, Q as StyleCascadeTable, C as ContentControlBoundaryRecord$1, m as FixedPointRoundingMode, U as FixedPoint, V as VersionedShapingLibrary, j as TextShaper, W as FontByteValidator, r as ShapedRun, L as LineRecord, X as SourceRange, Y as HyperlinkProjector, Z as FieldLinkProjector, _ as StoryPageFieldNeeds, $ as HyperlinkFieldSpec, a0 as SpanLinkRecord, f as SectionPageBorders, a1 as PageBorderFrameRecord, a2 as ParagraphBorderStrokeRecord, a3 as StrikeoutStrokePt } from './semantic-records-4B3WwFAi.js';
+export { a4 as AUTO_PARAGRAPH_SPACING_PT, a5 as AbstractNumDefinition, a6 as AnchoredDrawingLayoutFallback, a7 as BidiEmbeddingLevels, a8 as BorderGridGeometry, a9 as CascadedParagraphFormatting, aa as CjkTypographySettings, ab as ContentControlGeometryFragment, ac as ContentControlLevel, d as ContentControlLock, ad as ContentControlMappedType, ae as DEFAULT_RUN_STYLE, af as DEFAULT_TAB_INTERVAL_PT, ag as DEFAULT_TAB_INTERVAL_TWIPS, ah as DeclaredFontSubstitution, ai as DrawingClipFallback, aj as DrawingGeometry, ak as DrawingGroupPictureRecord, al as EMPTY_NUMBERING_INDEX, am as EMPTY_TAB_STOPS, an as EquationFractionGeometry, ao as EquationGeometry, ap as EquationNaryGeometry, aq as EquationRadicalGeometry, ar as EquationRowGeometry, as as EquationScriptGeometry, at as EquationSpanRecord, au as EquationTextGeometry, av as FieldAtomMarker, aw as FontFingerprintInputs, n as FontRequest, ax as FontResolutionError, ay as FontResolutionErrorCode, az as FontResourceDefinition, aA as FontResourceInstrumentation, F as FontResourceSnapshot, aB as FontResourceSnapshotOptions, aC as FontSlot, q as FontSubstitution, aD as FontValidationResult, aE as GlyphOutline, aF as GroupTextboxStoryRecord, aG as HARD_MAX_AGGREGATE_FONT_BYTES, aH as HARD_MAX_FONT_BYTES, aI as HARD_MAX_FONT_SOURCES, H as HeaderFooterStoryRecord, aJ as LevelOverride, aK as LineSpacingRule, aL as ListMarkerAlign, p as ListMarkerPictureRecord, aM as ListMarkerRecord, aN as ListSuffix, aO as MAX_BORDER_SPACE_PT, aP as MAX_BORDER_WIDTH_PT, aQ as MAX_LVL_OVERRIDES, aR as MAX_NUMBERING_DEFINITIONS, aS as MAX_PARAGRAPH_SPACING_PT, aT as MAX_SHAPING_CONTEXT, aU as MAX_STYLE_DEFINITIONS, aV as MAX_TABLE_BORDER_STROKES, aW as MAX_TAB_POSITION_TWIPS, aX as MAX_TAB_STOPS, l as NormalizationPolicy, N as NoteAreaRecord, c as NoteStoryRecord, aY as NumDefinition, aZ as NumberingLevelIndent, a_ as NumberingPictureBullet, a$ as PAGE_BORDER_SIDES, b0 as PARAGRAPH_BORDER_SIDES, b1 as PageBorderDisplay, b2 as PageBorderOffsetFrom, b3 as PageBorderSide, b4 as PageBorderStrokeRecord, b5 as PageBorderZOrder, b6 as PageRefCalibrationCell, b7 as PageRefFieldProjection, b8 as ParagraphAutoSpacingContext, b9 as ParagraphBorderEdge, ba as ParagraphBorderSide, bb as ParagraphBorders, bc as ParagraphBottomBorderRecord, bd as ParagraphIndent, be as ParagraphLayoutInputs, bf as ParagraphLineSpacing, bg as ParagraphSpacing, bh as RefFieldSpec, bi as RefNoteParts, bj as ResolvedCellBorders, k as ResolvedFont, bk as ResolvedPictureBullet, R as ResolvedRunStyle, bl as ResolvedTabStops, bm as ResolvedTableBorderEdge, bn as ResolvedTableBorderEdgeSegment, bo as ResolvedUnderline, bp as SINGLE_LINE_SPACING, bq as ScriptItem, br as SemanticArtifactRootStoryKind, bs as SemanticArtifactStoryKind, bt as SemanticCommentArtifactRecord, bu as SemanticReviewArtifactOccurrence, bv as SemanticReviewArtifactOccurrenceGeometry, bw as SemanticReviewArtifactPosition, o as SemanticReviewArtifactRecord, bx as SemanticReviewArtifactSource, by as SemanticTrackedChangeArtifactRecord, bz as ShapeInput, bA as ShapedCluster, bB as ShapedFontSpan, bC as ShapedGlyph, bD as ShapedRunComparatorInputs, bE as ShapedVerticalMetrics, bF as ShapingContext, bG as ShapingEnvironment, bH as ShapingEnvironmentFingerprintInputs, i as ShapingEnvironmentInput, bI as StyleDefinition, bJ as TAB_LEADER_GLYPH, bK as TabAlignment, bL as TabDestination, bM as TabLeader, bN as TabStop, bO as TableBorderSideName, bP as TableBorderStrokeRecord, h as TableCellFragmentRecord, bQ as TableFragmentRecord, g as TableRowFragmentRecord, bR as TextDirection, bS as TextboxStoryFallbackReason, bT as TextboxStoryLayout, bU as UnsupportedScriptError, bV as VerticalAlign, bW as appliedSpaceBefore, bX as applyLineSpacing, bY as baselineShiftPtOf, bZ as borderExtentPt, b_ as borderWeight, b$ as bottomBorderExtentPt, c0 as boundedStructuralFontValidator, c1 as buildNumberingIndex, c2 as buildStyleCascadeTable, c3 as cascadeParagraphFormatting, c4 as cascadeRunProperties, c5 as cascadedBottomBorder, c6 as cascadedParagraphBorders, c7 as cascadedTabStops, c8 as collapsedSpaceBefore, c9 as createFontResourceSnapshot, ca as createShapedRun, cb as createShapingEnvironment, cc as defaultTabIntervalFromSettings, cd as displayText, ce as fixedPoint, cf as fontRequestKey, cg as glyphSizeFactorOf, ch as isValidStyleId, ci as itemizeScriptFontSlots, cj as layoutEquation, ck as measureDisplayText, cl as mergeListIndent, cm as nextTabDestination, cn as pageBordersFingerprint, co as paragraphBorderExtentPt, cp as paragraphBorderStrokeWidthPt, cq as paragraphBorders, cr as paragraphBordersFingerprint, cs as paragraphBreaksBefore, ct as paragraphContextualSpacing, cu as paragraphLineSpacing, cv as paragraphSpacing, cw as paragraphTabStops, cx as parsePageBorders, cy as parseRefInstruction, cz as readBorderSide, cA as readCellBorders, cB as readNumPr, cC as readTableBorders, cD as resolveBorderConflict, cE as resolveNumberingLevel, cF as resolveParagraphLayoutInputs, cG as resolveRunStyle, cH as resolveStoryListItems, cI as resolveStoryRefFields, cJ as resolveTableCellBorderGrid, cK as runStylesEqual, cL as shapedRunComparatorInputs, cM as shapingEnvironmentFingerprint, cN as shapingEnvironmentFingerprintInputs, cO as styleForFontSlot, cP as tabAdvanceWidth, cQ as tabStopsFingerprint, cR as withDefaultTabInterval, cS as withNumberingStyleLinks, cT as withResolvedListItems } from './semantic-records-4B3WwFAi.js';
+export { C as CacheLookup, b as CacheMiss, c as CacheProvenance, e as LayoutEnvironmentShapedMeasurerOptions, f as LayoutFontConfiguration, g as LayoutFontSource, h as LayoutFontSubstitution, i as LayoutShapingConfigurationError, j as LayoutShapingEnvironment, L as LayoutShapingInstrumentation, a as LayoutShapingOptions, O as OperationSnapshot, k as OperationSnapshotField, l as OperationSnapshotGuard, P as PreparedLayoutFontConfiguration, R as ResolvedCache, m as ResourceDependencyProvenance, S as ShapedMeasurerOptions, n as captureOperationSnapshot, o as createLayoutShapedMeasurer, p as createLayoutShaping, q as createShapedMeasurer, d as disposeLayoutShaping, r as guardOperationSnapshot, s as layoutFontConfigurationFingerprint, t as prepareLayoutFontConfiguration } from './layout-shaping-BEyuiQOk.js';
+import { a as SemanticStoryKind, S as SemanticRootStoryKind, b as SemanticStoryVisit, T as TextboxOwnerRecord } from './semantic-record-queries-CBlZqZNa.js';
+export { c as SemanticDrawingLayer, d as SemanticDrawingVisit, e as StoryDrawingContext, f as StoryDrawingHost, g as StoryParagraphFragmentContext, h as contentControlsOfLayout, i as effectiveContentControlLock, j as forEachSemanticDrawing, k as forEachSemanticStory, l as forEachStoryParagraphFragment, m as fragmentsOfParagraph, n as lineAtPosition, o as linesOf, p as paragraphFragmentsOf, q as paragraphFragmentsOfBlocks, u as unionLayoutBoxes } from './semantic-record-queries-CBlZqZNa.js';
+import { ak as ImpactClass, N as OoxmlNode, X as OoxmlProperty, Z as OoxmlElement, O as OoxmlPart, W as TreeDocOp, Q as OoxmlPackage, b9 as ContentControlKind, ba as ContentControlLevel, bc as ContentControlLock, b6 as ContentControlDataBinding, a as ReviewItem } from './types-barrel-D3xCgQX6.js';
+export { b1 as CommentAnchor, b2 as CommentPosition, C as CommentRecord, aY as CommentThreadState, aK as DrawingAccessibility, aw as DrawingHorizontalReferenceFrame, aL as DrawingImageEffects, aM as DrawingTransform, ax as DrawingVerticalReferenceFrame, an as ImageWrapTarget, c as ReviewCommentItem, d as ReviewCustomItem, R as ReviewModelInput, e as ReviewPosition, f as ReviewRange, b as ReviewRevisionItem, g as ReviewRevisionKind, al as SourceCrop, aJ as TableBorderStyle, dB as VectorShapeComponent, aN as VectorShapeProjection, cs as W15_NAMESPACE_URI, dC as activeReviewItem, cW as firstReviewRange, ds as reviewItemKey, dD as reviewItemPositionRank, dt as reviewItemRanges, dE as reviewItemsAt, dF as reviewThreadRootOf } from './types-barrel-D3xCgQX6.js';
+import { D as DocumentProperties, H as HeadlessDocumentView, r as relationshipTargetIn } from './headless-document-view-qH331moE.js';
+import { o as RevisionAttribution, b as RevisionDisplayMode, c as RevisionAuthorFilter } from './revision-projection-DZ4kKVev.js';
+export { p as DEFAULT_REVISION_DISPLAY_MODE, q as RevisionFilter, s as RevisionKind, t as formatRevisionOf, u as markRevisionRemovesMark, v as paragraphMarkFormatRevisionOf, w as paragraphMarkRevisionOf, x as paragraphMarkRevisionsOf, y as revisionAuthorFilter, z as revisionsAreDeletion, A as revisionsVisible, B as shownMarkRevision } from './revision-projection-DZ4kKVev.js';
+import { b as ResolvedFootnoteProperties, R as ResolvedEndnoteProperties } from './note-properties-4Y9o6Gyk.js';
+import { e as TreeModelChange, N as NoteKind, aA as noteTypeOf, k as FieldResultsMode } from './tree-package-fragment-BeeKxDw8.js';
+import { P as PageGeometry, a as SectionColumns } from './semantic-cell-selection-D9D1KSXq.js';
+export { C as CellSelection, D as DEFAULT_PAGE_GEOMETRY, b as DEFAULT_SECTION_PROPERTIES, c as DEFAULT_VERTICAL_WEIGHT, d as DocumentSection, e as DocumentSectionsEnumeration, f as DrawingOverlayFrame, H as HitPoint, g as HitTestOptions, M as MAX_DOCUMENT_SECTIONS, h as PlacedCell, i as SectionBreakType, j as SectionColumnDefinition, k as SectionMargins, l as SectionPageNumbering, S as SectionProperties, m as SemanticHit, n as SemanticHitDrawing, T as TableCellAddress, o as TableCellContext, p as caretBoxOnLine, q as cellSelectionBetween, r as cellSelectionRects, s as cellSelectionText, t as contentControlAtPoint, u as enumerateDocumentSections, v as enumerateDocumentSectionsBounded, w as findDrawingOverlayFrameInLayout, x as geometryOfSection, y as hitTestPage, z as hitTestSheet, A as isFurniturePoint, B as lineEndOffset, E as pageAtY, F as paragraphSectionNode, G as paragraphsInCells, I as parsePageNumbering, J as parseSectionProperties, K as projectedSectionSourceIndexes, L as readSectionProperties, N as spanOffsetX, O as spansInCells, Q as tableContextAt } from './semantic-cell-selection-D9D1KSXq.js';
+export { M as MAX_SDT_NESTING, c as collectFlowBlocks, a as commentBodyText, b as commentInitials, j as contentControlContentChildren, i as isContentControl, f as isContentControlContent, p as paragraphOrderOfPart } from './review-paragraph-order-DT-n6ouC.js';
+import { S as SemanticPosition, b as SelectionRect, a as SemanticSelection, C as CaretGeometry } from './semantic-interaction-CIC-PooQ.js';
+export { c as CaretAtOptions, M as MoveCaretOptions, N as NavigationCommand, d as caretAt, e as caretStops, f as caretStopsForBlocks, g as compositionAnchor, h as contentControlsInLayout, i as deletedTextBoundaries, m as moveCaret, p as paragraphTextFromLayout, s as spansInSelection } from './semantic-interaction-CIC-PooQ.js';
+import './image-resources-BN-hUgCn.js';
+import './omml-equation-CuzBL5DD.js';
 import './editor-scope-OHPwVQ5l.js';
 
 /**
@@ -169,8 +184,8 @@ interface PendingPositionedTableTokens {
 /**
  * What the BODY flow knows about page numbering while it MEASURES a page-field placeholder.
  *
- * Carried instead of a bare boolean because the placeholder and the value it is replaced by
- * have to agree about whether the picture applies at all, and only the section knows that.
+ * The section's `w:pgNumType/@w:fmt` binds a PAGE field with no `\#` picture and no `\*`
+ * number format. A field that states either renders through it on every section.
  */
 interface BodyPageFieldContext {
     /** The section's `w:pgNumType/@w:fmt`; absent when the section authors none. */
@@ -209,6 +224,67 @@ interface FieldPageContext {
  */
 declare function formatPageNumber(value: number, format: string | undefined): string;
 
+type WrapTextSide = 'bothSides' | 'left' | 'right' | 'largest';
+interface WrapExclusionInput {
+    readonly mode: 'square' | 'tight' | 'through' | 'topAndBottom';
+    readonly contentBounds: LayoutBox;
+    readonly polygon: readonly DrawingPoint[] | null;
+    readonly clipPolygon: readonly DrawingPoint[] | null;
+    readonly wrapDistances: DrawingInsets;
+    readonly effectInsets: DrawingInsets;
+    readonly textSide: WrapTextSide;
+    readonly contentLeft: number;
+    readonly contentRight: number;
+}
+
+/** Paint layer relative to body text — not the OOXML wrap element. */
+type DrawingPaintLayer = 'behind' | 'inFront';
+/** The header or footer object a furniture exclusion zone comes from. */
+interface FurnitureZoneSource {
+    readonly partName: string;
+    readonly kind: 'drawing' | 'table';
+    readonly nodeId: string;
+}
+interface ExclusionZone {
+    /** Objects outside body drawing flow publish their exclusion directly instead of synthesizing it. */
+    readonly sourceKind?: 'table' | 'frame' | 'furniture';
+    /**
+     * Placed by an earlier section on the sheet a `continuous` section continues on. Its anchor
+     * is not in the continued section, so the zone reaches every line and column there.
+     */
+    readonly earlierSection?: boolean;
+    /**
+     * The header or footer object a `furniture` zone comes from. Node ids are unique only within
+     * one part, so a furniture zone is identified by its part, its kind, and its node together
+     * (see {@link exclusionZoneIdentity}), never by a composed id string.
+     */
+    readonly furnitureSource?: FurnitureZoneSource;
+    readonly drawingNodeId: string;
+    readonly anchorParagraphId: string;
+    /** UTF-16 model offset of the anchor atom — exclusions apply at/after this point in the paragraph. */
+    readonly anchorModelStart: number;
+    /**
+     * The band's vertical position is resolved against the page or a margin, not against the
+     * anchor's own flow position, so it cannot move when the text beside it reflows.
+     *
+     * Such a band excludes every line it crosses on its page, including lines that PRECEDE the
+     * anchor — a picture pinned to the top of the margin wraps the paragraphs above its anchor
+     * exactly as it wraps the ones below. Flow-relative bands (`paragraph`, `line`) stay
+     * forward-only: reaching back would move the anchor that positions them.
+     */
+    readonly pageFramedBand?: boolean;
+    readonly sourceOrder: number;
+    readonly paintLayer: DrawingPaintLayer;
+    readonly relativeHeight: number;
+    readonly allowOverlap: boolean;
+    /** Owning column index in a multi-column section — 0 for single-column and HF stories. */
+    readonly columnIndex: number;
+    /** Resolved top edge in page-content coordinates after overlap displacement. */
+    readonly y: number;
+    readonly verticalBand: LayoutBox;
+    readonly input: WrapExclusionInput;
+}
+
 type AutonumFieldKind = 'AUTONUM' | 'AUTONUMLGL' | 'AUTONUMOUT';
 /** One recognized AUTONUM-family instruction: the kind and its supported switches. */
 interface AutonumFieldSpec {
@@ -377,12 +453,14 @@ interface ParagraphLayoutCacheOptions {
      * Entries retained before the least recently used are dropped.
      *
      * The default has to exceed a realistic document, or a full pass evicts exactly what the
-     * next one needs and the cache costs more than it saves.
+     * next one needs and the cache costs more than it saves. Unset, an estimated byte budget
+     * bounds the cache instead, because one cached break can be a hundred times another.
      */
     readonly maxEntries?: number;
     /** Keep placed breaks for later revisions. Default true; false bounds one-shot exporters. */
     readonly retainAcrossPasses?: boolean;
 }
+
 /**
  * A bounded least-recently-used cache with generation-scoped retention.
  *
@@ -390,10 +468,10 @@ interface ParagraphLayoutCacheOptions {
  * contains — every keystroke mints a new key for the paragraph being typed in — and an
  * unbounded cache would hold every intermediate state of the session.
  *
- * The bound never evicts the CURRENT working set: entries stamped by this generation's
- * retain or touched since it began are skipped, and the map grows past `maxEntries` when a
- * document is larger than the configured cap — evicting live entries made every full pass
- * on a 500-page document re-measure the whole document.
+ * The bound never evicts the CURRENT working set: entries named by this generation's
+ * retain or touched since it began are skipped, and the cache grows past its soft budget
+ * when a document is larger than it — evicting live entries made every full pass on a
+ * 500-page document re-measure the whole document.
  */
 declare function createParagraphLayoutCache<T>(options?: ParagraphLayoutCacheOptions): ParagraphLayoutCache<T>;
 
@@ -412,50 +490,6 @@ interface FieldCodeRange {
 }
 type FieldCodeRanges = ReadonlyMap<string, readonly FieldCodeRange[]>;
 
-type WrapTextSide = 'bothSides' | 'left' | 'right' | 'largest';
-interface WrapExclusionInput {
-    readonly mode: 'square' | 'tight' | 'through' | 'topAndBottom';
-    readonly contentBounds: LayoutBox;
-    readonly polygon: readonly DrawingPoint[] | null;
-    readonly clipPolygon: readonly DrawingPoint[] | null;
-    readonly wrapDistances: DrawingInsets;
-    readonly effectInsets: DrawingInsets;
-    readonly textSide: WrapTextSide;
-    readonly contentLeft: number;
-    readonly contentRight: number;
-}
-
-/** Paint layer relative to body text — not the OOXML wrap element. */
-type DrawingPaintLayer = 'behind' | 'inFront';
-interface ExclusionZone {
-    /** Objects outside body drawing flow publish their exclusion directly instead of synthesizing it. */
-    readonly sourceKind?: 'table' | 'frame' | 'furniture';
-    readonly drawingNodeId: string;
-    readonly anchorParagraphId: string;
-    /** UTF-16 model offset of the anchor atom — exclusions apply at/after this point in the paragraph. */
-    readonly anchorModelStart: number;
-    /**
-     * The band's vertical position is resolved against the page or a margin, not against the
-     * anchor's own flow position, so it cannot move when the text beside it reflows.
-     *
-     * Such a band excludes every line it crosses on its page, including lines that PRECEDE the
-     * anchor — a picture pinned to the top of the margin wraps the paragraphs above its anchor
-     * exactly as it wraps the ones below. Flow-relative bands (`paragraph`, `line`) stay
-     * forward-only: reaching back would move the anchor that positions them.
-     */
-    readonly pageFramedBand?: boolean;
-    readonly sourceOrder: number;
-    readonly paintLayer: DrawingPaintLayer;
-    readonly relativeHeight: number;
-    readonly allowOverlap: boolean;
-    /** Owning column index in a multi-column section — 0 for single-column and HF stories. */
-    readonly columnIndex: number;
-    /** Resolved top edge in page-content coordinates after overlap displacement. */
-    readonly y: number;
-    readonly verticalBand: LayoutBox;
-    readonly input: WrapExclusionInput;
-}
-
 interface PendingLine {
     readonly spans: StyleSpanRecord[];
     readonly drawings: InlineDrawingRecord[];
@@ -495,6 +529,11 @@ interface PendingLine {
     deletedRanges?: readonly ModelRange[];
     /** Vertical gap inserted before this line to clear a drawing exclusion band. */
     exclusionSkipBefore?: number;
+    /**
+     * The line follows a text wrapping break that clears floating objects (`w:br w:clear`).
+     * Placement keeps its skip even on a line before the paragraph's first anchor.
+     */
+    breakClearance?: true;
     /** Clearance inherited by an empty anchor paragraph from other drawing bands. */
     anchorClearanceBefore?: number;
     /**
@@ -693,6 +732,8 @@ interface SectionStackSpan {
 /** Orchestrator state for multi-section incremental layout. */
 interface MultiSectionLayoutState {
     structureKey: string;
+    /** Each section's part of {@link structureKey}, so an added section keeps the others. */
+    sectionKeys: readonly string[];
     sections: LayoutSession[];
     spans: SectionStackSpan[];
     previousRemapped: readonly PageRecord[];
@@ -802,6 +843,9 @@ interface LayoutSession {
  */
 declare function createLayoutSession(): LayoutSession;
 
+/** Collect story paragraphs, preserving table depth limits across immutable row reuse. */
+declare function walkStoryParagraphs(blocks: readonly OoxmlElement[], maxTableDepth?: number): OoxmlElement[];
+
 /**
  * Horizontal marker box inside the first-line indent slot.
  *
@@ -846,7 +890,7 @@ type PreferredWidthType = 'dxa' | 'pct' | 'auto' | 'nil';
  */
 interface PreferredWidth {
     readonly type: PreferredWidthType;
-    /** POINTS for `dxa`, PERCENT (0–100) for `pct`, 0 for `auto`/`nil`. */
+    /** POINTS for `dxa`, PERCENT for `pct` (0–100, or up to 655.34 for a table), 0 otherwise. */
     readonly value: number;
 }
 /** The frozen "no preferred width" value — what a table or cell that declares none resolves to. */
@@ -937,8 +981,8 @@ interface AutofitFieldContext {
  * remaining width and ignore the indent. `outerRuleOffsetPt` then moves the grid inward by
  * half the outer side rule where the table puts that rule's outer edge on the aligned edge.
  * For a supported mode-14 fixed table, that offset instead aligns the first cell's content.
- * A verified legacy content-aligned table instead aligns the leading cell's content edge
- * with the text column, without changing its indent.
+ * A legacy content-aligned table instead puts the content edge of its leading or trailing
+ * cell on the aligned edge of the text column; its indent still applies from the leading edge.
  */
 declare function tableOriginX(structure: SemanticTableStructure, containerWidthPt: number): number;
 
@@ -982,6 +1026,8 @@ type TableAlignment = 'left' | 'center' | 'right';
  * and would otherwise be a loop bound an attacker controls.
  */
 interface SemanticTableCell {
+    readonly revisionShading?: 'inserted' | 'deleted' | 'merged' | 'split';
+    readonly revisionShadingAuthor?: string;
     readonly id: string;
     /** Derived content-edge geometry for a verified legacy percentage-width parent table. */
     readonly legacyContentAlignment?: true;
@@ -1009,6 +1055,8 @@ interface SemanticTableCell {
     readonly margins: CellMarginsPt;
     /** Three-state authored `tcBorders` (omitted / none / edge). */
     readonly borders: CellBorderBox;
+    /** The row's `w:tblPrEx` table borders, which replace the table's own for this cell. */
+    readonly rowTableBorders?: TableBorderBox;
     /** Resolved incident edges used for content clearance, preserving authored border provenance. */
     readonly contentBorders?: CellBorderBox;
     /** The resolved cell (including a vertical merge) ends at the authored table bottom. */
@@ -1082,6 +1130,9 @@ interface SemanticTableStructure {
     readonly rows: readonly SemanticTableRow[];
     /** Verified pre-2013 percentage-width inline table; derived, never serialized. */
     readonly legacyContentAlignment?: true;
+    /** A legacy content-aligned table whose outer trailing edge, not its content, meets the
+     * trailing text edge: a top-level table in a text box. Derived, never serialized. */
+    readonly legacyTrailingOuterEdge?: true;
     /**
      * Derived, never serialized: how far the grid moves from the aligned table edge, in points.
      * A supported mode-14 fixed table shifts by its leading cell margin in the other direction.
@@ -1132,180 +1183,9 @@ declare function readTableStructure(table: OoxmlNode, contentWidthPt: number, de
 /** Which revisions the view resolves away; only the proposed result performs the join. */
 displayMode?: RevisionDisplayMode, authorFilter?: RevisionAuthorFilter, compatibilityMode?: number, 
 /** Widens autofit columns to their content minimums; layout passes its measurer. */
-autofit?: TableAutofitContext): SemanticTableStructure | null;
-
-/**
- * Depth-first paragraph fragments of one page, in reading order.
- *
- * Table interiors flatten through rows and cells; header-repeat rows are skipped unless
- * asked for, so interaction sees each caret stop exactly once while paint sees everything.
- */
-declare function paragraphFragmentsOf(page: PageRecord, includeHeaderRepeats?: boolean): ParagraphFragmentRecord[];
-declare function paragraphFragmentsOfBlocks(blocks: readonly BlockFragmentRecord[], includeHeaderRepeats?: boolean): ParagraphFragmentRecord[];
-/** Every line in a layout, in reading order — the order caret navigation walks. */
-declare function linesOf(layout: SemanticLayout): LineRecord[];
-/** The fragment-plus-anchored-drawings shape every laid-out story shares. */
-interface StoryDrawingHost {
-    /** Root story fragments in their published reading order. */
-    readonly fragments: readonly BlockFragmentRecord[];
-    /** Story-level positioned drawings, when that story supports anchors. */
-    readonly anchoredDrawings?: readonly AnchoredDrawingRecord[];
-}
-/** Root story kinds published directly from one page record. @public */
-type SemanticRootStoryKind = 'body' | 'header' | 'footer' | 'footnote' | 'endnote' | 'note-separator';
-/** Story containing a visited semantic record. @public */
-type SemanticStoryKind = SemanticRootStoryKind | 'textbox';
-/**
- * One root story in the engine's complete published page/story order.
- *
- * The story discriminant preserves the precise published host type so exporters can consume
- * furniture and note metadata without casting or searching the page graph a second time.
- * @public
- */
-type SemanticStoryVisit = {
-    readonly page: PageRecord;
-    readonly story: 'body';
-    readonly host: PageRecord;
-    /** Absolute story bounds; body records are relative to the page content box. */
-    readonly box: LayoutBox;
-    /** Absolute origin to add to story-relative fragment and drawing coordinates. */
-    readonly origin: Readonly<{
-        x: number;
-        y: number;
-    }>;
-    readonly noteScopeId: null;
-    readonly noteAreaKind: null;
-} | {
-    readonly page: PageRecord;
-    readonly story: 'header' | 'footer';
-    readonly host: HeaderFooterStoryRecord;
-    readonly box: LayoutBox;
-    readonly origin: Readonly<{
-        x: number;
-        y: number;
-    }>;
-    readonly noteScopeId: null;
-    readonly noteAreaKind: null;
-} | {
-    readonly page: PageRecord;
-    readonly story: 'footnote' | 'endnote';
-    readonly host: NoteStoryRecord;
-    readonly box: LayoutBox;
-    readonly origin: Readonly<{
-        x: number;
-        y: number;
-    }>;
-    readonly noteScopeId: string;
-    readonly noteAreaKind: NoteAreaRecord['kind'];
-} | {
-    readonly page: PageRecord;
-    readonly story: 'note-separator';
-    readonly host: NonNullable<NoteAreaRecord['separator']>;
-    readonly box: LayoutBox;
-    readonly origin: Readonly<{
-        x: number;
-        y: number;
-    }>;
-    readonly noteScopeId: null;
-    readonly noteAreaKind: NoteAreaRecord['kind'];
-};
-/** Visit every root story in a semantic layout, preserving page/story order. @public */
-declare function forEachSemanticStory(layout: SemanticLayout, visit: (story: SemanticStoryVisit) => void): void;
-/** Location of one paragraph fragment within a recursively painted story graph. @public */
-interface StoryParagraphFragmentContext {
-    /** Absolute origin of the immediate story containing this record. */
-    readonly storyOrigin: Readonly<{
-        x: number;
-        y: number;
-    }>;
-    /** Zero for the supplied story; increments for every textbox boundary. */
-    readonly textboxDepth: number;
-    /** Drawing whose textbox directly owns this fragment, or null for the root story. */
-    readonly textboxOwner: TextboxOwnerRecord | null;
-    /** Root-to-leaf owning drawings, empty for the supplied story. */
-    readonly textboxPath: readonly TextboxOwnerRecord[];
-}
-/** A drawing that owns a text-box story: anchored, or inline on a line. @public */
-type TextboxOwnerRecord = InlineDrawingRecord | AnchoredDrawingRecord;
-/** Location of one drawing within a recursively painted story graph. @public */
-interface StoryDrawingContext extends StoryParagraphFragmentContext {
-    /** Enclosing paragraph for an inline drawing; null for a story-level anchor. */
-    readonly paragraph: ParagraphFragmentRecord | null;
-    /** Enclosing line for an inline drawing; null for a story-level anchor. */
-    readonly line: LineRecord | null;
-}
-type RootDrawingOrigin = (drawing: AnchoredDrawingRecord) => Readonly<{
-    x: number;
-    y: number;
-}>;
-/** Drawing layer relative to its owning story's text. @public */
-type SemanticDrawingLayer = 'behind-text' | 'inline' | 'in-front-of-text';
-/**
- * One drawing in bounded graph-enumeration order with exporter-grade provenance.
- *
- * Enumeration is deliberately not paint order: story anchors (and nested textboxes) are visited
- * before inline line drawings. Renderers use `paintLayer` plus record geometry to compose layers.
- * @public
- */
-interface SemanticDrawingVisit extends StoryDrawingContext {
-    /** Physical page carrying this drawing occurrence. */
-    readonly page: PageRecord;
-    /** Immediate story classification; `textbox` after textbox descent. */
-    readonly story: SemanticStoryKind;
-    /** Root story from which textbox descent began. */
-    readonly rootStory: SemanticRootStoryKind;
-    /** Note scope for drawings in note stories; null elsewhere. */
-    readonly noteScopeId: string | null;
-    /** Owning note-area kind for note/separator drawings; null elsewhere. */
-    readonly noteAreaKind: NoteAreaRecord['kind'] | null;
-    /** Precise root host and absolute origin for story-relative geometry. */
-    readonly root: SemanticStoryVisit;
-    /** Absolute origin of this drawing's extent in page-stack coordinates. */
-    readonly drawingOrigin: Readonly<{
-        x: number;
-        y: number;
-    }>;
-    /** Absolute painted bounds, including effects and clipping. */
-    readonly absolutePaintBounds: LayoutBox;
-    /** Absolute pointer/hit bounds. */
-    readonly absoluteHitBounds: LayoutBox;
-    /** Layer relative to text in the immediate owning story. */
-    readonly paintLayer: SemanticDrawingLayer;
-    /** Published drawing record; inline visits also carry paragraph and line. */
-    readonly drawing: InlineDrawingRecord | AnchoredDrawingRecord;
-}
-/** Visit every drawing through the canonical root-story and recursive textbox walks. @public */
-declare function forEachSemanticDrawing(layout: SemanticLayout, visit: (drawing: SemanticDrawingVisit) => void): void;
-/**
- * Visit every paragraph fragment one story paints — its own (table interiors flattened,
- * header repeats included) and the fragments inside each anchored drawing's text-box story,
- * recursively.
- *
- * The fragment sibling of {@link forEachStoryDrawing}, sharing its depth bound, for
- * consumers that read per-paragraph published fields (list markers) rather than drawings.
- * The furniture list-marker token walks with this; a fragment it misses leaves a reused
- * page showing a stale marker.
- */
-declare function forEachStoryParagraphFragment(story: StoryDrawingHost, visit: (fragment: ParagraphFragmentRecord, context: StoryParagraphFragmentContext) => void, rootOrigin?: Readonly<{
-    x: number;
-    y: number;
-}>, rootDrawingOrigin?: RootDrawingOrigin): void;
-/** Every fragment belonging to one paragraph, in order, across page boundaries. */
-declare function fragmentsOfParagraph(layout: SemanticLayout, paragraphId: string): ParagraphFragmentRecord[];
-/** The line containing a model position, or null when the position is not laid out. */
-declare function lineAtPosition(layout: SemanticLayout, paragraphId: string, offset: number, 
-/** Lines to test, when the caller already knows which ones can carry the paragraph. */
-candidates?: Iterable<LineRecord>): LineRecord | null;
-/** Every content-control boundary on a layout, preferring the layout-level list. */
-declare function contentControlsOfLayout(layout: SemanticLayout): readonly ContentControlBoundaryRecord$1[];
-/**
- * Axis-aligned union of boxes, or null when the list is empty.
- *
- * Used when a control's content spans several fragments or spans on one page.
- */
-declare function unionLayoutBoxes(boxes: readonly LayoutBox[]): LayoutBox | null;
-/** Collapse raw + ancestor locks into one `ST_Lock` vocabulary value. */
-declare function effectiveContentControlLock(locks: readonly ContentControlLock[]): ContentControlLock;
+autofit?: TableAutofitContext, 
+/** The table is a top-level table of a text box story. */
+textBox?: boolean): SemanticTableStructure | null;
 
 /** Paragraph ids in document order, deduplicated across fragments. */
 declare function documentOrder(layout: SemanticLayout): string[];
@@ -1414,6 +1294,33 @@ declare function wordBoundary(text: string, offset: number, direction: -1 | 1, s
  */
 declare function positionPastDeletion(layout: SemanticLayout, position: SemanticPosition): SemanticPosition;
 
+/**
+ * The caret position nearest a point, in PAGE-CONTENT coordinates.
+ *
+ * Never returns null for a point inside the document: a click in the margin, past the end of
+ * a line, or below the last line still has an obvious intended caret, and refusing to answer
+ * would make those clicks do nothing.
+ *
+ * The rules live in `semantic-hit-test.ts`, which answers with the cell address and the
+ * on-glyphs flag a pointer controller needs too; this keeps the geometry-only shape for
+ * callers that want nothing else.
+ */
+declare function hitTestSemantic(layout: SemanticLayout, point: {
+    readonly x: number;
+    readonly y: number;
+    readonly pageIndex?: number;
+}): CaretGeometry | null;
+/**
+ * Innermost content-control boundary at a page-content point, or null outside every control.
+ *
+ * Prefers the deepest nesting depth when nested boundaries share geometry.
+ */
+declare function contentControlAtSemantic(layout: SemanticLayout, point: {
+    readonly x: number;
+    readonly y: number;
+    readonly pageIndex?: number;
+}): ContentControlBoundaryRecord$1 | null;
+
 /**
  * Rewrite private-use symbol-font codepoints to their Unicode equivalents.
  *
@@ -2148,6 +2055,11 @@ interface LayoutNoteStoryOptions {
     readonly numberingIndex?: NumberingIndex;
     readonly defaultTabStopPt?: number;
     readonly compatibilityMode?: number;
+    /**
+     * The active line-grid pitch of the section that owns the note, in points. Note lines snap
+     * to it like body lines do; absent means no grid.
+     */
+    readonly lineGridPitchPt?: number;
     readonly displayMode?: RevisionDisplayMode;
     readonly revisionAuthorFilter?: RevisionAuthorFilter;
     /**
@@ -2312,6 +2224,8 @@ interface NotesLayoutInput {
     readonly styleCascade?: StyleCascadeTable;
     /** `numbering.xml`, so a `w:numPr` paragraph inside a note resolves a marker. */
     readonly numberingIndex?: NumberingIndex;
+    /** Per-section active line-grid pitch in points; note lines snap to their section's grid. */
+    readonly lineGridPitchBySection?: readonly (number | undefined)[];
     readonly defaultTabStopPt?: number;
     readonly compatibilityMode?: number;
     readonly displayMode?: RevisionDisplayMode;
@@ -2674,6 +2588,14 @@ interface SemanticLayoutOptions {
     readonly projectFieldLink?: FieldLinkProjector;
     /** Field-code inspection projection. @internal */
     readonly showFieldCodes?: boolean;
+    /**
+     * How the pass addresses saved field results (DATE, MERGEFIELD, HYPERLINK display text, see
+     * `FieldResultsMode`). `atomic` (the default) lays every field out as one model unit.
+     * `editable` lays a saved result out as ordinary text at the offsets the store's editable
+     * mode addresses, so a caret, a hit, and a selection inside it land on its characters. The
+     * mode is folded into every cache key.
+     */
+    readonly fieldResults?: FieldResultsMode;
     /** @internal */
     readonly fieldCodeRanges?: FieldCodeRanges;
     /** @internal Word TOC character-style suppression. */
@@ -2730,6 +2652,12 @@ interface SemanticLayoutOptions {
      * cached rows do not stack under the empty placeholder.
      */
     readonly emptyTocSuppressedResultParagraphIds?: ReadonlySet<string>;
+    /**
+     * Lay out only the first `bodyBlockLimit` body blocks. A large open lays out a growing
+     * prefix in separate tasks, each pass resuming from the last, so the page stays
+     * responsive; the final pass has no limit. @internal
+     */
+    readonly bodyBlockLimit?: number;
 }
 
 /**
@@ -3025,9 +2953,9 @@ interface ContentControlBoundaryRecord {
     readonly level: ContentControlLevel;
     /** 0 for a top-level control; the nesting depth otherwise. */
     readonly depth: number;
-    readonly lock: ContentControlLock$1;
+    readonly lock: ContentControlLock;
     /** The lock in force here, including every lock an enclosing control imposes. */
-    readonly effectiveLock: ContentControlLock$1;
+    readonly effectiveLock: ContentControlLock;
     readonly showingPlaceholder: boolean;
     readonly temporary: boolean;
     readonly tag?: string;
@@ -3219,5 +3147,5 @@ declare function tabLeaderPattern(startPt: number, widthPt: number, advancePt: n
  */
 declare function noteSeparatorRuleBox(span: StyleSpanRecord, line: LineRecord, stroke?: StrikeoutStrokePt): LayoutBox;
 
-export { AUTO_PREFERRED_WIDTH, AnchoredDrawingRecord, BlockFragmentRecord, CELL_PAD, COMPOUND_BORDER_MIN_GAP_PT, COMPOUND_BORDER_MIN_STROKE_PT, CellBorderBox, ContentControlBoundaryRecord$1 as ContentControlBoundaryRecord, ContentControlLock, DEFAULT_CANVAS_FONT_STACK, DEFAULT_CELL_MARGINS, DrawingInsets, DrawingPoint, FieldLinkProjector, FixedPoint, FixedPointRoundingMode, FontByteValidator, GRAPHEME_SEGMENTER_LOCALE, HARFBUZZ_SHAPING_LIBRARY, HarfBuzzShapingError, HeaderFooterStoryRecord, HyperlinkFieldSpec, HyperlinkProjector, InlineDrawingRecord, LayoutBox, LineRecord, MAX_EACH_PAGE_MARK_CANDIDATES, MAX_LVL_TEXT_LENGTH, MAX_MARKER_TEXT_LENGTH, MAX_NOTES_LAID_OUT, MAX_NOTE_FRAGMENTS, MAX_NOTE_OVERFLOW_PAGES, MAX_NOTE_REFLOW_ATTEMPTS, MAX_STYLE_BASED_ON_DEPTH, MAX_TABLE_COLUMNS, MAX_TABLE_NESTING, MAX_TABLE_ROW_FRAGMENTS, MAX_TABLE_ROW_HEIGHT_PT, NoteAreaRecord, NoteStoryRecord, NumberingIndex, NumberingLevel, PageBorderFrameRecord, PageGeometry, PageRecord, ParagraphBorderStrokeRecord, ParagraphFragmentRecord, RefFieldContext, ResolvedListItem, ReviewItem, RevisionAttribution, RevisionAuthorFilter, RevisionDisplayMode, SectionColumns, SectionPageBorders, SelectionRect, SemanticLayout, SemanticPosition, SemanticSelection, ShapedRun, SourceRange, SpanLinkRecord, StrikeoutStrokePt, StyleCascadeTable, StyleSpanRecord, TableBorderBox, TableBorderSide, TableCellStyleFormatting, TablePaginationError, TextMeasurer, TextShaper, VersionedShapingLibrary, WORD_SEGMENTER_LOCALE, anchorLineY, attachNotesToLayout, boundedFallbackWordSegments, buildPageRefIndex, clampListValue, computeDoubleBorderMetricsPt, computeFootnoteReserves, contentControlBoundaries, contentControlHoldingParagraph, contentControlRecordsInPart, contentControlsOfLayout, createBoundedFallbackWordBoundary, createDefaultWordBoundary, createDocumentFurnitureSource, createDocumentLinkProjectors, createDocumentNotesInput, createDocumentStyleDependencies, createFieldLinkRegistry, createFixedMeasurer, createHarfBuzzTextShaper, createIntlWordBoundary, createLayoutScheduler, createLayoutSession, createListCounterState, createParagraphLayoutCache, defaultNoteSeparatorRuleStyle, deriveNoteDisplayMarks, deriveNoteDisplayMarksResolved, documentOrder, documentRelationshipTargetIn, effectiveBorderSide, effectiveContentControlLock, emptyTocPlaceholderParagraphIds, emptyTocSuppressedResultParagraphIds, everyStoryOrder, expandLvlText, exportSourceRangeOf, filterRefsOnPage, findSeparatorNote, forEachSemanticDrawing, forEachSemanticSpan, forEachSemanticStory, forEachStoryParagraphFragment, formatDecimal, formatDecimalZero, formatLowerLetter, formatLowerRoman, formatNumFmt, formatPageNumber, formatUpperLetter, formatUpperRoman, fragmentOwnsAtomOffset, fragmentsOfParagraph, graphemeBoundaryEpoch, graphemeCount, graphemeOffsetToUtf16, harfBuzzFontValidator, initializeHarfBuzz, intlGraphemeBoundary, isCanvasMeasurementAvailable, isCumulativeGeometryTrustedFromLineOrigin, isGeometryTrustedCaretOffset, isHarfBuzzInitialized, isIntlSegmenterAvailable, isIntlWordSegmenterAvailable, isMarkerOnlySeparatorNote, isWholeGraphemeHorizontalBoundary, keyedRangeRects, layoutHeaderFooterStory, layoutNoteById, layoutNoteSeparator, layoutNoteStory, layoutSemanticDocument, lineAtPosition, lineSegments, linesOf, listMarkerBox, mapSymbolPuaText, normalNotesOf, noteDisplayMarkMap, noteLineIdPrefix, noteMarkKey, noteSeparatorAreaBox, noteSeparatorRuleBox, noteStoryBlocks, pageBorderFrame, pageRefPageNumbersFromLayout, pagesToMaterialize, paragraphFragmentsOf, paragraphFragmentsOfBlocks, paragraphLayoutKey, paragraphMarkDeleted, paragraphShading, paragraphShadingBox, parseAutonumInstruction, planRefFieldResultRefresh, positionPastDeletion, projectedNoteMarkText, provisionalNoteMarks, readTableStructure, resetGraphemeBoundary, resolveDefaultSurfaceMeasurer, resolveDefaultWordBoundary, resolveOoxmlShadingFill, resolveStrictHexFill, reviewAnchorIndex, reviewItemGeometry, revisionRemovesParagraph, roundFontUnitToFixedPoint, runBorderStrokesForLine, segmentGraphemes, segmentWords, selectionRects, semanticHorizontalBoundaries, setGraphemeBoundary, setHarfBuzzWasmUrl, sha256FontBytes, shadingFillFromElement, shapedHorizontalBoundaries, storyBlocks, syntheticSeparatorBox, tabLeaderPattern, tableOriginX, tocFieldChromeParagraphIds, tryCreateCanvasMeasurer, unionLayoutBoxes, utf16OffsetToGrapheme, vectorShapeInkClip, wordBoundary, wordSegmentsToGraphemeRecords };
-export type { AutofitFieldContext, AutonumFieldKind, AutonumFieldSpec, CanvasMeasurerOptions, CanvasTextContext, CanvasTextMetrics, CellMarginsPt, CellVerticalAlign, CompoundBorderMetrics, ContentControlFragmentRecord, CreateDocumentFurnitureSourceOptions, CreateDocumentNotesInputOptions, DocumentFurnitureSource, DocumentLinkProjectors, DocumentStyleDependencies, FieldLinkRegistry, GraphemeBoundary, GraphemeSegment, GraphemeWordSegmentRecord, HarfBuzzFaceCacheEvent, HarfBuzzOutlineCacheEvent, HarfBuzzShapeCacheEvent, HarfBuzzShapingErrorCode, HarfBuzzTextShaper, HarfBuzzTextShaperInstrumentation, HarfBuzzTextShaperOptions, HeaderFooterVariantName, KeyedRange, LayoutCacheStats, LayoutScheduler, LayoutSchedulerOptions, LayoutScope, LayoutSession, LayoutSessionStats, LineSegment, ListCounterAdvance, ListCounterState, MaterializationInput, NoteDisplayMark, NoteLayoutFallbackReason, NoteMarkContext, NotePaginationFallbackReason, NoteReferenceSite, NoteSeparatorLayout, NoteSeparatorRuleStyle, NoteStoryDrawings, NoteStoryLayout, NotesAttachResult, NotesLayoutInput, PageFurniture, PageRefIndex, ParagraphKeyInputs, ParagraphLayoutCache, ParagraphLayoutCacheOptions, PreferredWidth, PreferredWidthType, RefFieldRefreshOptions, RegisteredFieldLink, ResolvedSurfaceMeasurer, ReviewParagraphAnchor, SemanticDrawingLayer, SemanticDrawingVisit, SemanticLayoutOptions, SemanticRootStoryKind, SemanticSpanVisit, SemanticStoryKind, SemanticStoryVisit, SemanticTableCell, SemanticTableRow, SemanticTableStructure, StoryDrawingContext, StoryDrawingHost, StoryParagraphFragmentContext, StoryProjectionDependencies, TableAlignment, TableAutofitContext, TablePaginationErrorCode, TableRowHeight, TableRowHeightRule, TextboxOwnerRecord, ViewportWindow, WordBoundary, WordBoundaryResolverDeps, WordSegment };
+export { AUTO_PREFERRED_WIDTH, AnchoredDrawingRecord, BlockFragmentRecord, CELL_PAD, COMPOUND_BORDER_MIN_GAP_PT, COMPOUND_BORDER_MIN_STROKE_PT, CaretGeometry, CellBorderBox, ContentControlBoundaryRecord$1 as ContentControlBoundaryRecord, DEFAULT_CANVAS_FONT_STACK, DEFAULT_CELL_MARGINS, DrawingInsets, DrawingPoint, FieldLinkProjector, FixedPoint, FixedPointRoundingMode, FontByteValidator, GRAPHEME_SEGMENTER_LOCALE, HARFBUZZ_SHAPING_LIBRARY, HarfBuzzShapingError, HyperlinkFieldSpec, HyperlinkProjector, InlineDrawingRecord, LayoutBox, LineRecord, MAX_EACH_PAGE_MARK_CANDIDATES, MAX_LVL_TEXT_LENGTH, MAX_MARKER_TEXT_LENGTH, MAX_NOTES_LAID_OUT, MAX_NOTE_FRAGMENTS, MAX_NOTE_OVERFLOW_PAGES, MAX_NOTE_REFLOW_ATTEMPTS, MAX_STYLE_BASED_ON_DEPTH, MAX_TABLE_COLUMNS, MAX_TABLE_NESTING, MAX_TABLE_ROW_FRAGMENTS, MAX_TABLE_ROW_HEIGHT_PT, NumberingIndex, NumberingLevel, PageBorderFrameRecord, PageGeometry, PageRecord, ParagraphBorderStrokeRecord, ParagraphFragmentRecord, RefFieldContext, ResolvedListItem, ReviewItem, RevisionAttribution, RevisionAuthorFilter, RevisionDisplayMode, SectionColumns, SectionPageBorders, SelectionRect, SemanticLayout, SemanticPosition, SemanticRootStoryKind, SemanticSelection, SemanticStoryKind, SemanticStoryVisit, ShapedRun, SourceRange, SpanLinkRecord, StrikeoutStrokePt, StyleCascadeTable, StyleSpanRecord, TableBorderBox, TableBorderSide, TableCellStyleFormatting, TablePaginationError, TextMeasurer, TextShaper, TextboxOwnerRecord, VersionedShapingLibrary, WORD_SEGMENTER_LOCALE, anchorLineY, attachNotesToLayout, boundedFallbackWordSegments, buildPageRefIndex, clampListValue, computeDoubleBorderMetricsPt, computeFootnoteReserves, contentControlAtSemantic, contentControlBoundaries, contentControlHoldingParagraph, contentControlRecordsInPart, createBoundedFallbackWordBoundary, createDefaultWordBoundary, createDocumentFurnitureSource, createDocumentLinkProjectors, createDocumentNotesInput, createDocumentStyleDependencies, createFieldLinkRegistry, createFixedMeasurer, createHarfBuzzTextShaper, createIntlWordBoundary, createLayoutScheduler, createLayoutSession, createListCounterState, createParagraphLayoutCache, defaultNoteSeparatorRuleStyle, deriveNoteDisplayMarks, deriveNoteDisplayMarksResolved, documentOrder, documentRelationshipTargetIn, effectiveBorderSide, emptyTocPlaceholderParagraphIds, emptyTocSuppressedResultParagraphIds, everyStoryOrder, expandLvlText, exportSourceRangeOf, filterRefsOnPage, findSeparatorNote, forEachSemanticSpan, formatDecimal, formatDecimalZero, formatLowerLetter, formatLowerRoman, formatNumFmt, formatPageNumber, formatUpperLetter, formatUpperRoman, fragmentOwnsAtomOffset, graphemeBoundaryEpoch, graphemeCount, graphemeOffsetToUtf16, harfBuzzFontValidator, hitTestSemantic, initializeHarfBuzz, intlGraphemeBoundary, isCanvasMeasurementAvailable, isCumulativeGeometryTrustedFromLineOrigin, isGeometryTrustedCaretOffset, isHarfBuzzInitialized, isIntlSegmenterAvailable, isIntlWordSegmenterAvailable, isMarkerOnlySeparatorNote, isWholeGraphemeHorizontalBoundary, keyedRangeRects, layoutHeaderFooterStory, layoutNoteById, layoutNoteSeparator, layoutNoteStory, layoutSemanticDocument, lineSegments, listMarkerBox, mapSymbolPuaText, normalNotesOf, noteDisplayMarkMap, noteLineIdPrefix, noteMarkKey, noteSeparatorAreaBox, noteSeparatorRuleBox, noteStoryBlocks, pageBorderFrame, pageRefPageNumbersFromLayout, pagesToMaterialize, paragraphLayoutKey, paragraphMarkDeleted, paragraphShading, paragraphShadingBox, parseAutonumInstruction, planRefFieldResultRefresh, positionPastDeletion, projectedNoteMarkText, provisionalNoteMarks, readTableStructure, resetGraphemeBoundary, resolveDefaultSurfaceMeasurer, resolveDefaultWordBoundary, resolveOoxmlShadingFill, resolveStrictHexFill, reviewAnchorIndex, reviewItemGeometry, revisionRemovesParagraph, roundFontUnitToFixedPoint, runBorderStrokesForLine, segmentGraphemes, segmentWords, selectionRects, semanticHorizontalBoundaries, setGraphemeBoundary, setHarfBuzzWasmUrl, sha256FontBytes, shadingFillFromElement, shapedHorizontalBoundaries, storyBlocks, syntheticSeparatorBox, tabLeaderPattern, tableOriginX, tocFieldChromeParagraphIds, tryCreateCanvasMeasurer, utf16OffsetToGrapheme, vectorShapeInkClip, walkStoryParagraphs, wordBoundary, wordSegmentsToGraphemeRecords };
+export type { AutofitFieldContext, AutonumFieldKind, AutonumFieldSpec, CanvasMeasurerOptions, CanvasTextContext, CanvasTextMetrics, CellMarginsPt, CellVerticalAlign, CompoundBorderMetrics, ContentControlFragmentRecord, CreateDocumentFurnitureSourceOptions, CreateDocumentNotesInputOptions, DocumentFurnitureSource, DocumentLinkProjectors, DocumentStyleDependencies, FieldLinkRegistry, GraphemeBoundary, GraphemeSegment, GraphemeWordSegmentRecord, HarfBuzzFaceCacheEvent, HarfBuzzOutlineCacheEvent, HarfBuzzShapeCacheEvent, HarfBuzzShapingErrorCode, HarfBuzzTextShaper, HarfBuzzTextShaperInstrumentation, HarfBuzzTextShaperOptions, HeaderFooterVariantName, KeyedRange, LayoutCacheStats, LayoutScheduler, LayoutSchedulerOptions, LayoutScope, LayoutSession, LayoutSessionStats, LineSegment, ListCounterAdvance, ListCounterState, MaterializationInput, NoteDisplayMark, NoteLayoutFallbackReason, NoteMarkContext, NotePaginationFallbackReason, NoteReferenceSite, NoteSeparatorLayout, NoteSeparatorRuleStyle, NoteStoryDrawings, NoteStoryLayout, NotesAttachResult, NotesLayoutInput, PageFurniture, PageRefIndex, ParagraphKeyInputs, ParagraphLayoutCache, ParagraphLayoutCacheOptions, PreferredWidth, PreferredWidthType, RefFieldRefreshOptions, RegisteredFieldLink, ResolvedSurfaceMeasurer, ReviewParagraphAnchor, SemanticLayoutOptions, SemanticSpanVisit, SemanticTableCell, SemanticTableRow, SemanticTableStructure, StoryProjectionDependencies, TableAlignment, TableAutofitContext, TablePaginationErrorCode, TableRowHeight, TableRowHeightRule, ViewportWindow, WordBoundary, WordBoundaryResolverDeps, WordSegment };