@docx-editor.dev/core 2.4.1 → 2.6.0

package/dist/layout.d.ts

@@ -1,38 +1,25 @@
-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 { V as VersionedShapingLibrary, T as TextShaper, F as FontByteValidator, a as FixedPointRoundingMode, b as FixedPoint, c as TextDirection, S as ShapedRun } from './shaped-measurer-l4o5ITJ0.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-l4o5ITJ0.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-CdQvpUj1.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-CdQvpUj1.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 { O as OoxmlProperty, C as ContentControlKind, n as ContentControlLevel, o as ContentControlLock, p as ContentControlDataBinding, I as ImpactClass } from './tree-op-types-D0fTNBVW.js';
+export { m as TableBorderStyle } from './tree-op-types-D0fTNBVW.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';
+import { R as ResolvedFootnoteProperties, a as ResolvedEndnoteProperties } from './review-reads-HDvoQXK2.js';
+export { p as paragraphOrderOfPart } from './review-reads-HDvoQXK2.js';
+import { D as DocumentProperties, T as TreeModelChange } from './tree-store-CIKASRHk.js';
+import { R as RevisionDisplayMode } from './revision-projection-UKqvPa4-.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-UKqvPa4-.js';
+import { a as SectionColumns } from './semantic-cell-selection-B5vfPz4Q.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-B5vfPz4Q.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';
+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-D4ZBdUXa.js';
+import { S as SemanticPosition, b as SelectionRect, a as SemanticSelection } from './semantic-interaction-lvpzZRpA.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-lvpzZRpA.js';
+import './image-resources-Cl5_cNi9.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;
-}
-
 /**
  * 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`.
  *
@@ -744,6 +761,21 @@ declare function computeDoubleBorderMetricsPt(widthPt: number): CompoundBorderMe
  */
 declare function wordBoundary(text: string, offset: number, direction: -1 | 1): number;
 
+/**
+ * Where an INSERT aimed at this position actually lands: past any deletion it sits inside.
+ *
+ * The caret may rest anywhere in struck text — Word's rule, and the tracked lane's
+ * (`tree-op-tracked.ts`): all-markup shows the words, so the reader can put the caret
+ * between two of them. What may NOT happen is new content landing inside the `w:del`,
+ * where it would serialize as `w:t` under a wrapper that requires `w:delText` and be taken
+ * down by an accept of someone else's deletion. A deletion stays contiguous, so the words
+ * go after it — the order a replacement reads in.
+ *
+ * RANGE endpoints are not this function's business: a drag may legitimately cover deleted
+ * text, so callers adjust only collapsed insertion points.
+ */
+declare function positionPastDeletion(layout: SemanticLayout, position: SemanticPosition): SemanticPosition;
+
 /**
  * The exact HarfBuzz build this engine shapes against.
  *
@@ -763,7 +795,7 @@ declare function isHarfBuzzInitialized(): boolean;
  * count, glyph count and outline size are all attacker-influenced, and an unbounded shape call is
  * a denial-of-service vector rather than a rendering bug.
  */
-type HarfBuzzShapingErrorCode = 'notInitialized' | 'fontOverLimit' | 'malformedFont' | 'textOverLimit' | 'codepointsOverLimit' | 'glyphOverLimit' | 'outlineOverLimit' | 'shapedRunOverLimit' | 'unsupportedVariationAxes' | 'unsupportedFallback' | 'unsupportedColorFont' | 'unsupportedNormalization' | 'invalidBidiLevel' | 'shapingLibraryMismatch' | 'disposed';
+type HarfBuzzShapingErrorCode = 'notInitialized' | 'wasmUnavailable' | 'unsupportedRuntime' | 'fontOverLimit' | 'malformedFont' | 'textOverLimit' | 'codepointsOverLimit' | 'glyphOverLimit' | 'outlineOverLimit' | 'shapedRunOverLimit' | 'unsupportedVariationAxes' | 'unsupportedFallback' | 'unsupportedColorFont' | 'unsupportedNormalization' | 'invalidBidiLevel' | 'shapingLibraryMismatch' | 'disposed';
 /**
  * A shaping call that was refused, carrying the limit it exceeded where there was one.
  *
@@ -780,6 +812,7 @@ declare class HarfBuzzShapingError extends Error {
         readonly limit?: number;
         readonly actual?: number;
         readonly diagnostic?: string;
+        readonly cause?: unknown;
     });
 }
 /**
@@ -855,6 +888,38 @@ declare const roundFontUnitToFixedPoint: (fontUnits: number, denominator: number
  */
 declare const createHarfBuzzTextShaper: (options?: HarfBuzzTextShaperOptions) => HarfBuzzTextShaper;
 
+/**
+ * Point the text shaper at an externally hosted copy of `harfbuzz.wasm`.
+ *
+ * Needed only under bundlers that do not emit `new URL(..., import.meta.url)`
+ * assets. esbuild and Bun are the common ones, and so is any build that inlines
+ * dynamic imports, such as a library bundle. There, the build succeeds and the
+ * shaper fails at runtime with an `EditorFontError` whose code is
+ * `wasmUnavailable`; this function is the fix. Webpack, Turbopack and Vite emit
+ * the binary on their own, and passing a URL there simply overrides theirs.
+ *
+ * ```ts
+ * import { setHarfBuzzWasmUrl } from '@docx-editor.dev/core/layout';
+ * setHarfBuzzWasmUrl('/static/harfbuzz.wasm');
+ * ```
+ *
+ * Pass a URL your application controls. It is fetched and instantiated as
+ * WebAssembly, so never derive it from user input, a query parameter, or remote
+ * configuration. Serving it cross-origin needs that origin in your `connect-src`
+ * CSP directive, and WebAssembly needs `wasm-unsafe-eval` in `script-src` either
+ * way.
+ *
+ * Call it before the first editor is created. The runtime reads the location once
+ * and caches the result, so a call afterwards warns and does nothing: fix the
+ * call site and reload. The file to serve is exported as
+ * `@docx-editor.dev/core/harfbuzz.wasm`, and it must be the copy from the
+ * installed package version, because the runtime refuses a version mismatch at
+ * load rather than shaping with unverified metrics.
+ *
+ * @public
+ */
+declare function setHarfBuzzWasmUrl(url: string | URL): void;
+
 /**
  * UAX #9 embedding levels, one per UTF-16 code unit, plus the paragraph ranges they were resolved
  * within.
@@ -1220,6 +1285,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 +1407,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 +1552,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 +1562,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 +1793,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 +2058,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 +2487,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 +2519,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, positionPastDeletion, projectedNoteMarkText, provisionalNoteMarks, readNumPr, readTableStructure, resetGraphemeBoundary, resolveDefaultSurfaceMeasurer, resolveDefaultWordBoundary, resolveNumberingLevel, resolveOoxmlShadingFill, resolveParagraphLayoutInputs, resolveStoryListItems, resolveStrictHexFill, revisionRemovesParagraph, roundFontUnitToFixedPoint, segmentGraphemes, segmentWords, selectionRects, semanticHorizontalBoundaries, setGraphemeBoundary, setHarfBuzzWasmUrl, 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,Ed as caretAt,tc as caretBoxOnLine,Cd as caretStops,Dd as caretStopsForBlocks,wb as cascadeParagraphFormatting,yb as cascadeRunProperties,xb as cascadedBottomBorder,na as cascadedParagraphBorders,Fa as cascadedTabStops,Md as cellSelectionBetween,Pd as cellSelectionRects,Qd as cellSelectionText,Oa as clampListValue,sa as collapsedSpaceBefore,Kd as compositionAnchor,aa as computeDoubleBorderMetricsPt,jd as computeFootnoteReserves,qc as contentControlAtPoint,Gd as contentControlAtSemantic,ud as contentControlBoundaries,Hd as contentControlsInLayout,X as contentControlsOfLayout,I as createBoundedFallbackWordBoundary,J as createDefaultWordBoundary,nd as createFixedMeasurer,m as createHarfBuzzTextShaper,G as createIntlWordBoundary,xd as createLayoutScheduler,md as createLayoutSession,Zb as createListCounterState,ob as createParagraphLayoutCache,vd 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,Fd as hitTestSemantic,pc as hitTestSheet,h as initializeHarfBuzz,r as intlGraphemeBoundary,rd 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,zd 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,Jd 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,wd 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,Id as paragraphTextFromLayout,Nd as paragraphsInCells,Jc as parsePageNumbering,Kc as parseSectionProperties,Ad as positionPastDeletion,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,td 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,yd 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,Od as spansInCells,Ld as spansInSelection,Cb as storyBlocks,bd as syntheticSeparatorBox,Ka as tabAdvanceWidth,La as tabStopsFingerprint,Rd as tableContextAt,Sb as tableOriginX,Dc as tocFieldChromeParagraphIds,sd as tryCreateCanvasMeasurer,Y as unionLayoutBoxes,x as utf16OffsetToGrapheme,bc as walkStoryParagraphs,Ha as withDefaultTabInterval,$b as withNumberingStyleLinks,dc as withResolvedListItems,Bd as wordBoundary,M as wordSegmentsToGraphemeRecords}from'./chunk-OPKOTVQQ.js';export{a as setHarfBuzzWasmUrl}from'./chunk-WU7PUTVA.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-SMRD66T5.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-R75OLPL6.js';

package/dist/node-module-shim-TTKTT66I.js

@@ -0,0 +1 @@
+function n(){let e=globalThis.process;if(typeof e?.getBuiltinModule=="function")return e.getBuiltinModule("module")}function u(e){let i=n();if(!i)throw new Error("createRequire is unavailable: this build reaches Node's `module` through process.getBuiltinModule, which needs Node 20.16+ or 22.3+.");return i.createRequire(e)}export{u as createRequire};

package/dist/output.cjs

@@ -1 +1 @@
-'use strict';var chunkYTYKNA6X_cjs=require('./chunk-YTYKNA6X.cjs');require('./chunk-DQ5HGUWG.cjs'),require('./chunk-BS554B6D.cjs'),require('./chunk-MHDO6HLI.cjs'),require('./chunk-EQO762XH.cjs');Object.defineProperty(exports,"DEFAULT_FIELD_SHADING",{enumerable:true,get:function(){return chunkYTYKNA6X_cjs.d}});Object.defineProperty(exports,"paintSelectionOverlay",{enumerable:true,get:function(){return chunkYTYKNA6X_cjs.f}});Object.defineProperty(exports,"paintSemanticLayout",{enumerable:true,get:function(){return chunkYTYKNA6X_cjs.e}});
+'use strict';var chunkF7Z6PWAZ_cjs=require('./chunk-F7Z6PWAZ.cjs');require('./chunk-DGUHCJPF.cjs'),require('./chunk-IJ4V3LGV.cjs'),require('./chunk-SFMAIFEN.cjs'),require('./chunk-DY3QVCWC.cjs');Object.defineProperty(exports,"DEFAULT_FIELD_SHADING",{enumerable:true,get:function(){return chunkF7Z6PWAZ_cjs.h}});Object.defineProperty(exports,"paintSelectionOverlay",{enumerable:true,get:function(){return chunkF7Z6PWAZ_cjs.j}});Object.defineProperty(exports,"paintSemanticLayout",{enumerable:true,get:function(){return chunkF7Z6PWAZ_cjs.i}});

package/dist/output.d.cts

@@ -1,10 +1,11 @@
-export { D as DEFAULT_FIELD_SHADING, F as FieldShadingMode, P as PaintOptions, p as paintSemanticLayout } from './semantic-paint-BYjE0Xbl.cjs';
-import { S as SemanticLayout } from './semantic-records-DSD8WENa.cjs';
-import './image-resources-DXvPZvXD.cjs';
-import './tree-op-types-EZXbR8bW.cjs';
+import { R as ReviewAuthorInfo } from './semantic-paint-IjbL-4CT.cjs';
+export { D as DEFAULT_FIELD_SHADING, F as FieldShadingMode, P as PaintOptions, a as RevisionAuthorAssignments, b as RevisionAuthorStyle, c as RevisionStyles, p as paintSemanticLayout } from './semantic-paint-IjbL-4CT.cjs';
+import { S as SemanticLayout } from './semantic-records-DEOs3_tE.cjs';
+import './image-resources-BaHz4QAd.cjs';
+import './tree-op-types-CUCwPWjT.cjs';
 import './ooxml-tree-BU0e3DVi.cjs';
 import './ooxml-package-CR5us6ad.cjs';
-import './revision-projection-72ZApe-g.cjs';
+import './revision-projection-WzlQGBJx.cjs';
 
 /** A rectangle in page-content coordinates, on a named page. */
 interface OverlayRect {
@@ -21,6 +22,19 @@ interface OverlayRect {
      * sheets over the pages just to vary a colour.
      */
     readonly className?: string;
+    /**
+     * WHOSE band this is, as CSS hooks on the rectangle: `data-review-author`, `data-review-author-slot`, and
+     * `--doc-review-author-current` set to the colour that author resolves to.
+     *
+     * The same three the review card carries, and deliberately so — a host restyling one
+     * reviewer writes one selector that reaches both the card and the text it annotates. The
+     * band's DEFAULT colour does not change with the author (Word keeps every comment yellow);
+     * this only makes the author reachable from CSS.
+     *
+     * The SAME resolved author `getReviewAuthors` hands back, rather than a shape of this
+     * layer's own: one person is one object everywhere the review surface describes them.
+     */
+    readonly reviewAuthor?: ReviewAuthorInfo;
 }
 /**
  * How the selection overlay draws its rectangles over the painted pages.
@@ -58,4 +72,4 @@ interface SelectionOverlayOptions {
  */
 declare function paintSelectionOverlay(layer: HTMLElement, layout: SemanticLayout, rects: readonly OverlayRect[], options: SelectionOverlayOptions): void;
 
-export { type OverlayRect, type SelectionOverlayOptions, paintSelectionOverlay };
+export { type OverlayRect, ReviewAuthorInfo, type SelectionOverlayOptions, paintSelectionOverlay };

package/dist/output.d.ts

@@ -1,10 +1,11 @@
-export { D as DEFAULT_FIELD_SHADING, F as FieldShadingMode, P as PaintOptions, p as paintSemanticLayout } from './semantic-paint-BedBxkyY.js';
-import { S as SemanticLayout } from './semantic-records-CR5hTqMK.js';
-import './image-resources-BG9DLyW7.js';
-import './tree-op-types-8a6xyRCN.js';
+import { R as ReviewAuthorInfo } from './semantic-paint-BBPL3u5w.js';
+export { D as DEFAULT_FIELD_SHADING, F as FieldShadingMode, P as PaintOptions, a as RevisionAuthorAssignments, b as RevisionAuthorStyle, c as RevisionStyles, p as paintSemanticLayout } from './semantic-paint-BBPL3u5w.js';
+import { S as SemanticLayout } from './semantic-records-CdQvpUj1.js';
+import './image-resources-Cl5_cNi9.js';
+import './tree-op-types-D0fTNBVW.js';
 import './ooxml-tree-BU0e3DVi.js';
 import './ooxml-package-D_CtywTW.js';
-import './revision-projection-DHAkcD_L.js';
+import './revision-projection-UKqvPa4-.js';
 
 /** A rectangle in page-content coordinates, on a named page. */
 interface OverlayRect {
@@ -21,6 +22,19 @@ interface OverlayRect {
      * sheets over the pages just to vary a colour.
      */
     readonly className?: string;
+    /**
+     * WHOSE band this is, as CSS hooks on the rectangle: `data-review-author`, `data-review-author-slot`, and
+     * `--doc-review-author-current` set to the colour that author resolves to.
+     *
+     * The same three the review card carries, and deliberately so — a host restyling one
+     * reviewer writes one selector that reaches both the card and the text it annotates. The
+     * band's DEFAULT colour does not change with the author (Word keeps every comment yellow);
+     * this only makes the author reachable from CSS.
+     *
+     * The SAME resolved author `getReviewAuthors` hands back, rather than a shape of this
+     * layer's own: one person is one object everywhere the review surface describes them.
+     */
+    readonly reviewAuthor?: ReviewAuthorInfo;
 }
 /**
  * How the selection overlay draws its rectangles over the painted pages.
@@ -58,4 +72,4 @@ interface SelectionOverlayOptions {
  */
 declare function paintSelectionOverlay(layer: HTMLElement, layout: SemanticLayout, rects: readonly OverlayRect[], options: SelectionOverlayOptions): void;
 
-export { type OverlayRect, type SelectionOverlayOptions, paintSelectionOverlay };
+export { type OverlayRect, ReviewAuthorInfo, type SelectionOverlayOptions, paintSelectionOverlay };

package/dist/output.js

@@ -1 +1 @@
-export{d as DEFAULT_FIELD_SHADING,f as paintSelectionOverlay,e as paintSemanticLayout}from'./chunk-F6WNPYOM.js';import'./chunk-SG7OH2EK.js';import'./chunk-4WWEDTTE.js';import'./chunk-33F6TRXO.js';import'./chunk-TCX3PVWR.js';
+export{h as DEFAULT_FIELD_SHADING,j as paintSelectionOverlay,i as paintSemanticLayout}from'./chunk-WAVN7MAT.js';import'./chunk-OPKOTVQQ.js';import'./chunk-WU7PUTVA.js';import'./chunk-UVIUNAQ6.js';import'./chunk-SMRD66T5.js';import'./chunk-R75OLPL6.js';

package/dist/{review-reads-CxgN62yp.d.cts → review-reads-Dr0CpW6u.d.cts}

@@ -1,6 +1,6 @@
 import { e as OoxmlPart, O as OoxmlNode, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.cjs';
 import { O as OoxmlPackage } from './ooxml-package-CR5us6ad.cjs';
-import { R as RevisionAddress } from './tree-op-types-EZXbR8bW.cjs';
+import { R as RevisionAddress } from './tree-op-types-CUCwPWjT.cjs';
 
 /** `w:pos` — where a section's footnotes are laid out. */
 type FootnotePosition = 'pageBottom' | 'beneathText' | 'sectEnd' | 'docEnd';
@@ -196,12 +196,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 +369,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.

package/dist/{review-reads-CQmU9Lcl.d.ts → review-reads-HDvoQXK2.d.ts}

@@ -1,6 +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';
+import { R as RevisionAddress } from './tree-op-types-D0fTNBVW.js';
 
 /** `w:pos` — where a section's footnotes are laid out. */
 type FootnotePosition = 'pageBottom' | 'beneathText' | 'sectEnd' | 'docEnd';
@@ -196,12 +196,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 +369,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.