@docx-editor.dev/core 2.4.1 → 2.6.0

package/dist/{semantic-paint-BYjE0Xbl.d.cts → semantic-paint-IjbL-4CT.d.cts}

@@ -1,5 +1,98 @@
-import { C as ContentControlBoundaryRecord, S as SemanticLayout } from './semantic-records-DSD8WENa.cjs';
-import { V as ValidatedImageBytesHandle, R as RenderableImageMime } from './image-resources-DXvPZvXD.cjs';
+import { C as ContentControlBoundaryRecord, S as SemanticLayout } from './semantic-records-DEOs3_tE.cjs';
+import { V as ValidatedImageBytesHandle, R as RenderableImageMime } from './image-resources-BaHz4QAd.cjs';
+
+/**
+ * Everything a host can say about ONE author's presentation. Every field is optional and
+ * every field is presentation-only — nothing here is ever serialised into the document.
+ *
+ * Deliberately about the PAINTED DOCUMENT (which only the painter can style) plus the
+ * author's identity data. Review-card DESIGN is not configured here: the review chrome
+ * follows `color` as its accent automatically, and everything further is composition —
+ * a custom card reading this style through the review surface's `useReviewAuthor`, or
+ * CSS on the cards' `data-review-author`/`data-review-author-slot` hooks.
+ *
+ * @public
+ */
+interface RevisionAuthorStyle {
+    /**
+     * Ink and decoration colour of this author's changes in the document — and the accent
+     * the review chrome keys on (avatar disc, card variable, marker).
+     */
+    color?: string;
+    /** Background wash behind this author's changes in the document. */
+    background?: string;
+    /**
+     * Class names added to every painted span of this author's changes, for styling the
+     * typed fields do not cover. Keep the rules metric-safe (outlines, shadows, accents):
+     * the engine measures the text it paints, and a class that resizes glyphs drifts the
+     * page from its layout.
+     */
+    spanClassName?: string;
+    /** Avatar image for this author; the packaged card renders it in place of initials. */
+    avatarUrl?: string;
+}
+/**
+ * Per-author style assignments.
+ *
+ * Keys match `w:author` exactly; a value is a CSS colour or a full
+ * {@link RevisionAuthorStyle}. `others` says what authors WITHOUT an entry take: the
+ * `--doc-review-author-N` ramp by default, or `'kind'` to leave them on the kind colours —
+ * which is how "highlight these reviewers, leave everyone else green and red" is said.
+ *
+ * @public
+ */
+interface RevisionAuthorAssignments {
+    /** Authors without an entry: the ramp (default), or the `'kind'` colours. */
+    readonly others?: 'kind' | 'author';
+    readonly authors: Readonly<Record<string, string | RevisionAuthorStyle>>;
+}
+/**
+ * How painted tracked changes are coloured.
+ *
+ * - `'author'` (the DEFAULT) — every change takes its author's colour from the
+ *   `--doc-review-author-N` ramp, assigned by order of first appearance in the document.
+ *   Word's own default, and the reason it is this engine's: a paragraph three people
+ *   edited has to read as three people. Restyle a slot under `.docx-editor` to change the
+ *   ramp.
+ * - `'kind'` — insertions and deletions take the two kind colours
+ *   (`--doc-revision-insertion` / `--doc-revision-deletion`), so "added" and "removed" are
+ *   what a reader tells apart at a glance, whoever proposed them.
+ * - {@link RevisionAuthorAssignments} — style the named authors; `others` decides whether
+ *   the rest take the ramp (the default) or the kind colours.
+ *
+ * Presentation only: nothing here is ever serialised into the document.
+ *
+ * @public
+ */
+type RevisionStyles = 'kind' | 'author' | RevisionAuthorAssignments;
+/**
+ * One document author, resolved: who, which ramp slot, and what they draw in.
+ *
+ * @public
+ */
+interface ReviewAuthorInfo {
+    /** The `w:author` string, exactly as the file carries it. */
+    readonly author: string;
+    /**
+     * Rank by order of first appearance — an UNBOUNDED index, not a ramp slot.
+     *
+     * The ramp defines {@link REVIEW_AUTHOR_SLOTS} colours and every DOM hook wraps into it,
+     * so the ninth author ranks 8 here and carries `data-review-author-slot="0"`. Building a
+     * selector from this value needs the same wrap: `slot % 8`.
+     */
+    readonly slot: number;
+    /**
+     * The colour this author is DRAWN IN by the review chrome — their declared colour, or
+     * their ramp slot's token.
+     *
+     * Not necessarily what the document paints. `'kind'`, and `others: 'kind'` for an author
+     * with no declaration, colour the painted text by insertion/deletion instead, while the
+     * cards keep the per-author accent this reports.
+     */
+    readonly color: string;
+    /** The host-supplied style, normalised; absent when the author rides the ramp. */
+    readonly style?: RevisionAuthorStyle;
+}
 
 /** Host port for safe blob URLs — only called for {@link ImageResourceState.kind} `ready`. */
 interface PaintImageUrlPort {
@@ -67,6 +160,12 @@ interface PaintOptions {
     readonly fieldShading?: FieldShadingMode;
     /** See {@link PaintContext.shadeFormFields}. */
     readonly shadeFormFields?: boolean;
+    /**
+     * How tracked changes are coloured: by AUTHOR through the `--doc-review-author-N`
+     * ramp (the default, as in Word), by kind, or by author with host-pinned colours.
+     * See {@link RevisionStyles}.
+     */
+    readonly revisionStyles?: RevisionStyles;
     /**
      * Relationship id of the header/footer story currently open for editing.
      *
@@ -116,6 +215,15 @@ interface PaintOptions {
         readonly additionalBoundaries?: readonly ContentControlBoundaryRecord[];
         /** Control ids that represent TOC regions (hover-only chrome; never caret-sticky). */
         readonly tocControlIds?: ReadonlySet<string>;
+        /**
+         * No control may be written right now — viewing mode, or a protected document.
+         *
+         * The widget is a `<button>` the ENGINE paints, and a click on it commits a tree op, so
+         * an enabled-looking checkbox on a read-only document is not a cosmetic lie: it is the
+         * write itself. Disabling it here also stops the pointer lane, which already skips a
+         * widget carrying `data-disabled-reason`.
+         */
+        readonly readOnly?: boolean;
     };
     readonly drawingStrings?: DrawingPaintStrings;
     readonly imageUrlPort?: PaintImageUrlPort;
@@ -130,4 +238,4 @@ interface PaintOptions {
  */
 declare function paintSemanticLayout(container: HTMLElement, layout: SemanticLayout, options?: PaintOptions): void;
 
-export { DEFAULT_FIELD_SHADING as D, type FieldShadingMode as F, type PaintOptions as P, type DrawingPaintStrings as a, paintSemanticLayout as p };
+export { DEFAULT_FIELD_SHADING as D, type FieldShadingMode as F, type PaintOptions as P, type ReviewAuthorInfo as R, type RevisionAuthorAssignments as a, type RevisionAuthorStyle as b, type RevisionStyles as c, type DrawingPaintStrings as d, paintSemanticLayout as p };

package/dist/{semantic-records-CR5hTqMK.d.ts → semantic-records-CdQvpUj1.d.ts}

@@ -1,7 +1,7 @@
-import { O as OoxmlProperty, j as DrawingAccessibility, S as SourceCrop, k as DrawingTransform, V as VectorShapeProjection, f as DrawingHorizontalReferenceFrame, g as DrawingVerticalReferenceFrame, b as ImageWrapTarget, D as DrawingProjection, l as TableBorderStyle } from './tree-op-types-8a6xyRCN.js';
+import { O as OoxmlProperty, k as DrawingAccessibility, S as SourceCrop, l as DrawingTransform, V as VectorShapeProjection, f as DrawingHorizontalReferenceFrame, g as DrawingVerticalReferenceFrame, b as ImageWrapTarget, D as DrawingProjection, m as TableBorderStyle } from './tree-op-types-D0fTNBVW.js';
 import { O as OoxmlNode, o as OoxmlDrawingNode, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.js';
-import { a as RevisionAttribution } from './revision-projection-DHAkcD_L.js';
-import { I as ImageResourceState } from './image-resources-BG9DLyW7.js';
+import { I as ImageResourceState } from './image-resources-Cl5_cNi9.js';
+import { a as RevisionAttribution } from './revision-projection-UKqvPa4-.js';
 
 /** Whether a paragraph must start a new page (`w:pageBreakBefore`). */
 declare function paragraphBreaksBefore(props: readonly OoxmlProperty[]): boolean;
@@ -429,6 +429,21 @@ declare function runStylesEqual(a: ResolvedRunStyle, b: ResolvedRunStyle): boole
  */
 declare function baselineShiftPtOf(style: ResolvedRunStyle): number;
 
+type AllowlistedPageField = 'PAGE' | 'NUMPAGES' | 'SECTIONPAGES';
+/**
+ * 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;
+}
+
 interface DrawingPoint {
     readonly x: number;
     readonly y: number;
@@ -561,6 +576,21 @@ interface AnchoredDrawingRecord extends Omit<InlineDrawingRecord, 'kind' | 'base
     readonly textboxStory?: TextboxStoryLayout;
 }
 
+/**
+ * One parsed `HYPERLINK` instruction: the raw, unsanitized pieces.
+ *
+ * `target` and `anchor` are verbatim from the instruction — the projector at the trust
+ * boundary decides what, if anything, they become in a DOM sink.
+ */
+interface HyperlinkFieldSpec {
+    /** The target as authored (first quoted or bare non-switch token), or null. */
+    readonly target: string | null;
+    /** `\l` — a bookmark name in this document, or null. */
+    readonly anchor: string | null;
+    /** `\o` — the hover tooltip, or null. */
+    readonly tooltip: string | null;
+}
+
 /**
  * What a piece says about the FIELD result it came from, for Word's shading.
  *
@@ -576,12 +606,40 @@ interface FieldAtomMarker {
      * turns it off — because they mark the blanks somebody is meant to fill in.
      */
     readonly formField: boolean;
+    /**
+     * A BODY PAGE / NUMPAGES / SECTIONPAGES atom whose value depends on pagination.
+     *
+     * The paragraph walk cannot know which page the field lands on — layout runs before the page
+     * count — so it paints a placeholder and records the field's kind here. Document finalize
+     * (`substituteBodyPageFields`) reads this marker and substitutes the real value per page.
+     * Absent in headers/footers, which evaluate live through their own per-page projector.
+     */
+    readonly pageField?: {
+        readonly kind: AllowlistedPageField;
+    };
 }
 /** A half-open model-offset range, in the paragraph's own UTF-16 offset space. */
 interface ModelRange {
     readonly start: number;
     readonly end: number;
 }
+/**
+ * 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;
+/**
+ * How layout turns a parsed HYPERLINK field instruction into the sanitized record spans carry.
+ *
+ * Injected for the same reason as {@link HyperlinkProjector}: the spec's raw target must cross
+ * the surface's ONE href trust boundary, and layout owns no sanitization policy. `null` means
+ * no link — the cached result still paints as plain text, which is the right degradation.
+ */
+type FieldLinkProjector = (spec: HyperlinkFieldSpec) => SpanLinkRecord | null;
 
 /** Test-only mutable counters; omitted by production call sites. Not package-public. */
 interface TableBorderGridResolveWork {
@@ -1073,15 +1131,47 @@ interface ParagraphFragmentRecord {
      */
     readonly shadingBox?: LayoutBox;
     /**
-     * The revision on this paragraph's own MARK (`w:pPr/w:rPr/w:ins|w:del`), absent when there
-     * is none.
+     * The revisions on this paragraph's own MARK (`w:pPr/w:rPr/w:ins|w:del`), absent when there
+     * are none.
      *
-     * Carried on the fragment rather than on a span because it decorates no characters: the
+     * Carried on the fragment rather than on a span because they decorate no characters: the
      * pilcrow was inserted or deleted, which is how a split or a merge is recorded. Only the
-     * FINAL fragment carries it — the mark lives at the end of the paragraph, so a paragraph
+     * FINAL fragment carries them — the mark lives at the end of the paragraph, so a paragraph
      * split across pages must not draw two of them.
+     *
+     * A LIST because one mark can hold two decisions at once — an insertion by one author and
+     * a deletion of that insertion by the next. Published only in `all-markup`: the other two
+     * display modes answer what the document WOULD be, and a resolved view draws no
+     * attribution.
+     *
+     * Those two modes are ATTRIBUTION-resolved, not STRUCTURE-resolved. Taking a deleted mark
+     * in `proposed` merges the paragraph into the next one, and taking an inserted mark in
+     * `original` un-splits it, but `revision-visibility.ts` does that only for a paragraph that
+     * renders no text. So a resolved view still shows the break — it just no longer draws a
+     * coloured pilcrow beside it. The merge is the fix for that; suppressing the glyph is not,
+     * and must not be read as it.
+     */
+    readonly markRevisions?: readonly RevisionAttribution[];
+    /**
+     * The one decision a single-field reader sees, absent when there are none.
+     *
+     * Derived from {@link markRevisions} at publish time, never authored beside it, so the two
+     * cannot disagree: a deletion when the mark carries one, because that is where the pair
+     * lands once every decision is taken, and it is the face paint draws for the same reason.
+     *
+     * @deprecated Shows one of the decisions a mark can carry. Read {@link markRevisions}.
      */
     readonly markRevision?: RevisionAttribution;
+    /**
+     * The tracked FORMAT change on this paragraph's mark (`w:pPr/w:rPr/w:rPrChange`), absent
+     * when there is none. Final fragment only, and `all-markup` only, like the decisions above.
+     *
+     * Published without a glyph of its own on purpose. Word draws no pilcrow for a mark whose
+     * only change is its own formatting — the decision belongs to the review pane, which lists
+     * it either way. What was missing was GEOMETRY: with nothing on the fragment, a card had
+     * no place on the page to point at.
+     */
+    readonly markFormatRevision?: RevisionAttribution;
     /**
      * List marker painted in the hanging-indent slot of the FIRST fragment only.
      *
@@ -1400,6 +1490,14 @@ interface PageRecord {
         readonly sectionPageCount: number;
         readonly format?: string;
     };
+    /**
+     * `true` when this page's body flow (or a body table) carries a PAGE/NUMPAGES/SECTIONPAGES
+     * placeholder that document finalize must substitute. Set when the page is assembled, so it
+     * rides the record through incremental reuse. `false` lets `finalizePageFieldProjection` skip
+     * the substitution walk; `undefined` (a page built by a path that does not stamp it) still
+     * walks, which is safe.
+     */
+    readonly hasBodyPageFields?: boolean;
     /**
      * Content-control boundaries whose geometry intersects this page.
      *
@@ -1498,4 +1596,4 @@ 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;
 
-export { type ParagraphBorderStrokeRecord as $, type AnchoredDrawingRecord as A, type BlockFragmentRecord as B, type ContentControlBoundaryRecord as C, type DrawingPoint as D, DEFAULT_TAB_INTERVAL_PT as E, DEFAULT_TAB_INTERVAL_TWIPS as F, EMPTY_TAB_STOPS as G, type FieldAtomMarker as H, type InlineDrawingRecord as I, type HeaderFooterStoryRecord as J, type LineSpacingRule as K, type LineRecord as L, type ModelRange as M, type ListMarkerRecord as N, MAX_BORDER_SPACE_PT as O, type PageGeometry as P, MAX_BORDER_WIDTH_PT as Q, type ResolvedRunStyle as R, type SemanticLayout as S, type TextMeasurer as T, MAX_PARAGRAPH_SPACING_PT as U, MAX_TABLE_BORDER_STROKES as V, MAX_TAB_POSITION_TWIPS as W, MAX_TAB_STOPS as X, PARAGRAPH_BORDER_SIDES as Y, type ParagraphAutoSpacingContext as Z, type ParagraphBorderSide as _, type StyleSpanRecord as a, type ParagraphBottomBorderRecord as a0, type ParagraphIndent as a1, type ResolvedCellBorders as a2, type ResolvedTableBorderEdge as a3, type ResolvedTableBorderEdgeSegment as a4, type ResolvedUnderline as a5, SINGLE_LINE_SPACING as a6, type SourceRange as a7, TAB_LEADER_GLYPH as a8, type TabAlignment as a9, paragraphBorderStrokeWidthPt as aA, paragraphBorders as aB, paragraphBordersFingerprint as aC, paragraphBreaksBefore as aD, paragraphContextualSpacing as aE, paragraphFragmentsOf as aF, paragraphFragmentsOfBlocks as aG, paragraphLineSpacing as aH, paragraphSpacing as aI, paragraphTabStops as aJ, readBorderSide as aK, readCellBorders as aL, readTableBorders as aM, resolveBorderConflict as aN, resolveRunStyle as aO, resolveTableCellBorderGrid as aP, runStylesEqual as aQ, tabAdvanceWidth as aR, tabStopsFingerprint as aS, unionLayoutBoxes as aT, withDefaultTabInterval as aU, type TabDestination as aa, type TabLeader as ab, type TabStop as ac, type TableBorderSideName as ad, type TableBorderStrokeRecord as ae, type TableFragmentRecord as af, type VerticalAlign as ag, appliedSpaceBefore as ah, applyLineSpacing as ai, baselineShiftPtOf as aj, borderExtentPt as ak, borderWeight as al, bottomBorderExtentPt as am, cascadedParagraphBorders as an, cascadedTabStops as ao, collapsedSpaceBefore as ap, contentControlsOfLayout as aq, defaultTabIntervalFromSettings as ar, displayText as as, effectiveContentControlLock as at, fragmentsOfParagraph as au, lineAtPosition as av, linesOf as aw, measureDisplayText as ax, nextTabDestination as ay, paragraphBorderExtentPt as az, type TableRowFragmentRecord as b, type TableCellFragmentRecord as c, type SpanLinkRecord as d, type LayoutBox as e, type DrawingInsets as f, type ThemeFonts as g, type ParagraphSpacing as h, type ParagraphLineSpacing as i, type ParagraphBorderEdge as j, type ParagraphBorders as k, type ResolvedTabStops as l, type TableBorderSide as m, type InlineDrawingLayoutContext as n, type PageRecord as o, type ParagraphFragmentRecord as p, type CellBorderBox as q, type TableBorderBox as r, AUTO_PARAGRAPH_SPACING_PT as s, type BorderGridGeometry as t, type ContentControlGeometryFragment as u, type ContentControlLevel as v, type ContentControlLock as w, type ContentControlMappedType as x, DEFAULT_PAGE_GEOMETRY as y, DEFAULT_RUN_STYLE as z };
+export { PARAGRAPH_BORDER_SIDES as $, type AnchoredDrawingRecord as A, type BlockFragmentRecord as B, type ContentControlBoundaryRecord as C, type DrawingPoint as D, DEFAULT_TAB_INTERVAL_PT as E, type FieldLinkProjector as F, DEFAULT_TAB_INTERVAL_TWIPS as G, type HyperlinkProjector as H, type InlineDrawingRecord as I, EMPTY_TAB_STOPS as J, type FieldAtomMarker as K, type LineRecord as L, type ModelRange as M, type HeaderFooterStoryRecord as N, type HyperlinkFieldSpec as O, type PageGeometry as P, type LineSpacingRule as Q, type ResolvedRunStyle as R, type SemanticLayout as S, type TextMeasurer as T, type ListMarkerRecord as U, MAX_BORDER_SPACE_PT as V, MAX_BORDER_WIDTH_PT as W, MAX_PARAGRAPH_SPACING_PT as X, MAX_TABLE_BORDER_STROKES as Y, MAX_TAB_POSITION_TWIPS as Z, MAX_TAB_STOPS as _, type StyleSpanRecord as a, type ParagraphAutoSpacingContext as a0, type ParagraphBorderSide as a1, type ParagraphBorderStrokeRecord as a2, type ParagraphBottomBorderRecord as a3, type ParagraphIndent as a4, type ResolvedCellBorders as a5, type ResolvedTableBorderEdge as a6, type ResolvedTableBorderEdgeSegment as a7, type ResolvedUnderline as a8, SINGLE_LINE_SPACING as a9, linesOf as aA, measureDisplayText as aB, nextTabDestination as aC, paragraphBorderExtentPt as aD, paragraphBorderStrokeWidthPt as aE, paragraphBorders as aF, paragraphBordersFingerprint as aG, paragraphBreaksBefore as aH, paragraphContextualSpacing as aI, paragraphFragmentsOf as aJ, paragraphFragmentsOfBlocks as aK, paragraphLineSpacing as aL, paragraphSpacing as aM, paragraphTabStops as aN, readBorderSide as aO, readCellBorders as aP, readTableBorders as aQ, resolveBorderConflict as aR, resolveRunStyle as aS, resolveTableCellBorderGrid as aT, runStylesEqual as aU, tabAdvanceWidth as aV, tabStopsFingerprint as aW, unionLayoutBoxes as aX, withDefaultTabInterval as aY, type SourceRange as aa, type SpanLinkRecord as ab, TAB_LEADER_GLYPH as ac, type TabAlignment as ad, type TabDestination as ae, type TabLeader as af, type TabStop as ag, type TableBorderSideName as ah, type TableBorderStrokeRecord as ai, type TableFragmentRecord as aj, type VerticalAlign as ak, appliedSpaceBefore as al, applyLineSpacing as am, baselineShiftPtOf as an, borderExtentPt as ao, borderWeight as ap, bottomBorderExtentPt as aq, cascadedParagraphBorders as ar, cascadedTabStops as as, collapsedSpaceBefore as at, contentControlsOfLayout as au, defaultTabIntervalFromSettings as av, displayText as aw, effectiveContentControlLock as ax, fragmentsOfParagraph as ay, lineAtPosition as az, type TableRowFragmentRecord as b, type TableCellFragmentRecord as c, type LayoutBox as d, type DrawingInsets as e, type ThemeFonts as f, type ParagraphSpacing as g, type ParagraphLineSpacing as h, type ParagraphBorderEdge as i, type ParagraphBorders as j, type ResolvedTabStops as k, type TableBorderSide as l, type InlineDrawingLayoutContext as m, type PageRecord as n, type ParagraphFragmentRecord as o, type StoryPageFieldNeeds as p, type CellBorderBox as q, type TableBorderBox as r, AUTO_PARAGRAPH_SPACING_PT as s, type BorderGridGeometry as t, type ContentControlGeometryFragment as u, type ContentControlLevel as v, type ContentControlLock as w, type ContentControlMappedType as x, DEFAULT_PAGE_GEOMETRY as y, DEFAULT_RUN_STYLE as z };

package/dist/{semantic-records-DSD8WENa.d.cts → semantic-records-DEOs3_tE.d.cts}

@@ -1,7 +1,7 @@
-import { O as OoxmlProperty, j as DrawingAccessibility, S as SourceCrop, k as DrawingTransform, V as VectorShapeProjection, f as DrawingHorizontalReferenceFrame, g as DrawingVerticalReferenceFrame, b as ImageWrapTarget, D as DrawingProjection, l as TableBorderStyle } from './tree-op-types-EZXbR8bW.cjs';
+import { O as OoxmlProperty, k as DrawingAccessibility, S as SourceCrop, l as DrawingTransform, V as VectorShapeProjection, f as DrawingHorizontalReferenceFrame, g as DrawingVerticalReferenceFrame, b as ImageWrapTarget, D as DrawingProjection, m as TableBorderStyle } from './tree-op-types-CUCwPWjT.cjs';
 import { O as OoxmlNode, o as OoxmlDrawingNode, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.cjs';
-import { a as RevisionAttribution } from './revision-projection-72ZApe-g.cjs';
-import { I as ImageResourceState } from './image-resources-DXvPZvXD.cjs';
+import { I as ImageResourceState } from './image-resources-BaHz4QAd.cjs';
+import { a as RevisionAttribution } from './revision-projection-WzlQGBJx.cjs';
 
 /** Whether a paragraph must start a new page (`w:pageBreakBefore`). */
 declare function paragraphBreaksBefore(props: readonly OoxmlProperty[]): boolean;
@@ -429,6 +429,21 @@ declare function runStylesEqual(a: ResolvedRunStyle, b: ResolvedRunStyle): boole
  */
 declare function baselineShiftPtOf(style: ResolvedRunStyle): number;
 
+type AllowlistedPageField = 'PAGE' | 'NUMPAGES' | 'SECTIONPAGES';
+/**
+ * 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;
+}
+
 interface DrawingPoint {
     readonly x: number;
     readonly y: number;
@@ -561,6 +576,21 @@ interface AnchoredDrawingRecord extends Omit<InlineDrawingRecord, 'kind' | 'base
     readonly textboxStory?: TextboxStoryLayout;
 }
 
+/**
+ * One parsed `HYPERLINK` instruction: the raw, unsanitized pieces.
+ *
+ * `target` and `anchor` are verbatim from the instruction — the projector at the trust
+ * boundary decides what, if anything, they become in a DOM sink.
+ */
+interface HyperlinkFieldSpec {
+    /** The target as authored (first quoted or bare non-switch token), or null. */
+    readonly target: string | null;
+    /** `\l` — a bookmark name in this document, or null. */
+    readonly anchor: string | null;
+    /** `\o` — the hover tooltip, or null. */
+    readonly tooltip: string | null;
+}
+
 /**
  * What a piece says about the FIELD result it came from, for Word's shading.
  *
@@ -576,12 +606,40 @@ interface FieldAtomMarker {
      * turns it off — because they mark the blanks somebody is meant to fill in.
      */
     readonly formField: boolean;
+    /**
+     * A BODY PAGE / NUMPAGES / SECTIONPAGES atom whose value depends on pagination.
+     *
+     * The paragraph walk cannot know which page the field lands on — layout runs before the page
+     * count — so it paints a placeholder and records the field's kind here. Document finalize
+     * (`substituteBodyPageFields`) reads this marker and substitutes the real value per page.
+     * Absent in headers/footers, which evaluate live through their own per-page projector.
+     */
+    readonly pageField?: {
+        readonly kind: AllowlistedPageField;
+    };
 }
 /** A half-open model-offset range, in the paragraph's own UTF-16 offset space. */
 interface ModelRange {
     readonly start: number;
     readonly end: number;
 }
+/**
+ * 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;
+/**
+ * How layout turns a parsed HYPERLINK field instruction into the sanitized record spans carry.
+ *
+ * Injected for the same reason as {@link HyperlinkProjector}: the spec's raw target must cross
+ * the surface's ONE href trust boundary, and layout owns no sanitization policy. `null` means
+ * no link — the cached result still paints as plain text, which is the right degradation.
+ */
+type FieldLinkProjector = (spec: HyperlinkFieldSpec) => SpanLinkRecord | null;
 
 /** Test-only mutable counters; omitted by production call sites. Not package-public. */
 interface TableBorderGridResolveWork {
@@ -1073,15 +1131,47 @@ interface ParagraphFragmentRecord {
      */
     readonly shadingBox?: LayoutBox;
     /**
-     * The revision on this paragraph's own MARK (`w:pPr/w:rPr/w:ins|w:del`), absent when there
-     * is none.
+     * The revisions on this paragraph's own MARK (`w:pPr/w:rPr/w:ins|w:del`), absent when there
+     * are none.
      *
-     * Carried on the fragment rather than on a span because it decorates no characters: the
+     * Carried on the fragment rather than on a span because they decorate no characters: the
      * pilcrow was inserted or deleted, which is how a split or a merge is recorded. Only the
-     * FINAL fragment carries it — the mark lives at the end of the paragraph, so a paragraph
+     * FINAL fragment carries them — the mark lives at the end of the paragraph, so a paragraph
      * split across pages must not draw two of them.
+     *
+     * A LIST because one mark can hold two decisions at once — an insertion by one author and
+     * a deletion of that insertion by the next. Published only in `all-markup`: the other two
+     * display modes answer what the document WOULD be, and a resolved view draws no
+     * attribution.
+     *
+     * Those two modes are ATTRIBUTION-resolved, not STRUCTURE-resolved. Taking a deleted mark
+     * in `proposed` merges the paragraph into the next one, and taking an inserted mark in
+     * `original` un-splits it, but `revision-visibility.ts` does that only for a paragraph that
+     * renders no text. So a resolved view still shows the break — it just no longer draws a
+     * coloured pilcrow beside it. The merge is the fix for that; suppressing the glyph is not,
+     * and must not be read as it.
+     */
+    readonly markRevisions?: readonly RevisionAttribution[];
+    /**
+     * The one decision a single-field reader sees, absent when there are none.
+     *
+     * Derived from {@link markRevisions} at publish time, never authored beside it, so the two
+     * cannot disagree: a deletion when the mark carries one, because that is where the pair
+     * lands once every decision is taken, and it is the face paint draws for the same reason.
+     *
+     * @deprecated Shows one of the decisions a mark can carry. Read {@link markRevisions}.
      */
     readonly markRevision?: RevisionAttribution;
+    /**
+     * The tracked FORMAT change on this paragraph's mark (`w:pPr/w:rPr/w:rPrChange`), absent
+     * when there is none. Final fragment only, and `all-markup` only, like the decisions above.
+     *
+     * Published without a glyph of its own on purpose. Word draws no pilcrow for a mark whose
+     * only change is its own formatting — the decision belongs to the review pane, which lists
+     * it either way. What was missing was GEOMETRY: with nothing on the fragment, a card had
+     * no place on the page to point at.
+     */
+    readonly markFormatRevision?: RevisionAttribution;
     /**
      * List marker painted in the hanging-indent slot of the FIRST fragment only.
      *
@@ -1400,6 +1490,14 @@ interface PageRecord {
         readonly sectionPageCount: number;
         readonly format?: string;
     };
+    /**
+     * `true` when this page's body flow (or a body table) carries a PAGE/NUMPAGES/SECTIONPAGES
+     * placeholder that document finalize must substitute. Set when the page is assembled, so it
+     * rides the record through incremental reuse. `false` lets `finalizePageFieldProjection` skip
+     * the substitution walk; `undefined` (a page built by a path that does not stamp it) still
+     * walks, which is safe.
+     */
+    readonly hasBodyPageFields?: boolean;
     /**
      * Content-control boundaries whose geometry intersects this page.
      *
@@ -1498,4 +1596,4 @@ 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;
 
-export { type ParagraphBorderStrokeRecord as $, type AnchoredDrawingRecord as A, type BlockFragmentRecord as B, type ContentControlBoundaryRecord as C, type DrawingPoint as D, DEFAULT_TAB_INTERVAL_PT as E, DEFAULT_TAB_INTERVAL_TWIPS as F, EMPTY_TAB_STOPS as G, type FieldAtomMarker as H, type InlineDrawingRecord as I, type HeaderFooterStoryRecord as J, type LineSpacingRule as K, type LineRecord as L, type ModelRange as M, type ListMarkerRecord as N, MAX_BORDER_SPACE_PT as O, type PageGeometry as P, MAX_BORDER_WIDTH_PT as Q, type ResolvedRunStyle as R, type SemanticLayout as S, type TextMeasurer as T, MAX_PARAGRAPH_SPACING_PT as U, MAX_TABLE_BORDER_STROKES as V, MAX_TAB_POSITION_TWIPS as W, MAX_TAB_STOPS as X, PARAGRAPH_BORDER_SIDES as Y, type ParagraphAutoSpacingContext as Z, type ParagraphBorderSide as _, type StyleSpanRecord as a, type ParagraphBottomBorderRecord as a0, type ParagraphIndent as a1, type ResolvedCellBorders as a2, type ResolvedTableBorderEdge as a3, type ResolvedTableBorderEdgeSegment as a4, type ResolvedUnderline as a5, SINGLE_LINE_SPACING as a6, type SourceRange as a7, TAB_LEADER_GLYPH as a8, type TabAlignment as a9, paragraphBorderStrokeWidthPt as aA, paragraphBorders as aB, paragraphBordersFingerprint as aC, paragraphBreaksBefore as aD, paragraphContextualSpacing as aE, paragraphFragmentsOf as aF, paragraphFragmentsOfBlocks as aG, paragraphLineSpacing as aH, paragraphSpacing as aI, paragraphTabStops as aJ, readBorderSide as aK, readCellBorders as aL, readTableBorders as aM, resolveBorderConflict as aN, resolveRunStyle as aO, resolveTableCellBorderGrid as aP, runStylesEqual as aQ, tabAdvanceWidth as aR, tabStopsFingerprint as aS, unionLayoutBoxes as aT, withDefaultTabInterval as aU, type TabDestination as aa, type TabLeader as ab, type TabStop as ac, type TableBorderSideName as ad, type TableBorderStrokeRecord as ae, type TableFragmentRecord as af, type VerticalAlign as ag, appliedSpaceBefore as ah, applyLineSpacing as ai, baselineShiftPtOf as aj, borderExtentPt as ak, borderWeight as al, bottomBorderExtentPt as am, cascadedParagraphBorders as an, cascadedTabStops as ao, collapsedSpaceBefore as ap, contentControlsOfLayout as aq, defaultTabIntervalFromSettings as ar, displayText as as, effectiveContentControlLock as at, fragmentsOfParagraph as au, lineAtPosition as av, linesOf as aw, measureDisplayText as ax, nextTabDestination as ay, paragraphBorderExtentPt as az, type TableRowFragmentRecord as b, type TableCellFragmentRecord as c, type SpanLinkRecord as d, type LayoutBox as e, type DrawingInsets as f, type ThemeFonts as g, type ParagraphSpacing as h, type ParagraphLineSpacing as i, type ParagraphBorderEdge as j, type ParagraphBorders as k, type ResolvedTabStops as l, type TableBorderSide as m, type InlineDrawingLayoutContext as n, type PageRecord as o, type ParagraphFragmentRecord as p, type CellBorderBox as q, type TableBorderBox as r, AUTO_PARAGRAPH_SPACING_PT as s, type BorderGridGeometry as t, type ContentControlGeometryFragment as u, type ContentControlLevel as v, type ContentControlLock as w, type ContentControlMappedType as x, DEFAULT_PAGE_GEOMETRY as y, DEFAULT_RUN_STYLE as z };
+export { PARAGRAPH_BORDER_SIDES as $, type AnchoredDrawingRecord as A, type BlockFragmentRecord as B, type ContentControlBoundaryRecord as C, type DrawingPoint as D, DEFAULT_TAB_INTERVAL_PT as E, type FieldLinkProjector as F, DEFAULT_TAB_INTERVAL_TWIPS as G, type HyperlinkProjector as H, type InlineDrawingRecord as I, EMPTY_TAB_STOPS as J, type FieldAtomMarker as K, type LineRecord as L, type ModelRange as M, type HeaderFooterStoryRecord as N, type HyperlinkFieldSpec as O, type PageGeometry as P, type LineSpacingRule as Q, type ResolvedRunStyle as R, type SemanticLayout as S, type TextMeasurer as T, type ListMarkerRecord as U, MAX_BORDER_SPACE_PT as V, MAX_BORDER_WIDTH_PT as W, MAX_PARAGRAPH_SPACING_PT as X, MAX_TABLE_BORDER_STROKES as Y, MAX_TAB_POSITION_TWIPS as Z, MAX_TAB_STOPS as _, type StyleSpanRecord as a, type ParagraphAutoSpacingContext as a0, type ParagraphBorderSide as a1, type ParagraphBorderStrokeRecord as a2, type ParagraphBottomBorderRecord as a3, type ParagraphIndent as a4, type ResolvedCellBorders as a5, type ResolvedTableBorderEdge as a6, type ResolvedTableBorderEdgeSegment as a7, type ResolvedUnderline as a8, SINGLE_LINE_SPACING as a9, linesOf as aA, measureDisplayText as aB, nextTabDestination as aC, paragraphBorderExtentPt as aD, paragraphBorderStrokeWidthPt as aE, paragraphBorders as aF, paragraphBordersFingerprint as aG, paragraphBreaksBefore as aH, paragraphContextualSpacing as aI, paragraphFragmentsOf as aJ, paragraphFragmentsOfBlocks as aK, paragraphLineSpacing as aL, paragraphSpacing as aM, paragraphTabStops as aN, readBorderSide as aO, readCellBorders as aP, readTableBorders as aQ, resolveBorderConflict as aR, resolveRunStyle as aS, resolveTableCellBorderGrid as aT, runStylesEqual as aU, tabAdvanceWidth as aV, tabStopsFingerprint as aW, unionLayoutBoxes as aX, withDefaultTabInterval as aY, type SourceRange as aa, type SpanLinkRecord as ab, TAB_LEADER_GLYPH as ac, type TabAlignment as ad, type TabDestination as ae, type TabLeader as af, type TabStop as ag, type TableBorderSideName as ah, type TableBorderStrokeRecord as ai, type TableFragmentRecord as aj, type VerticalAlign as ak, appliedSpaceBefore as al, applyLineSpacing as am, baselineShiftPtOf as an, borderExtentPt as ao, borderWeight as ap, bottomBorderExtentPt as aq, cascadedParagraphBorders as ar, cascadedTabStops as as, collapsedSpaceBefore as at, contentControlsOfLayout as au, defaultTabIntervalFromSettings as av, displayText as aw, effectiveContentControlLock as ax, fragmentsOfParagraph as ay, lineAtPosition as az, type TableRowFragmentRecord as b, type TableCellFragmentRecord as c, type LayoutBox as d, type DrawingInsets as e, type ThemeFonts as f, type ParagraphSpacing as g, type ParagraphLineSpacing as h, type ParagraphBorderEdge as i, type ParagraphBorders as j, type ResolvedTabStops as k, type TableBorderSide as l, type InlineDrawingLayoutContext as m, type PageRecord as n, type ParagraphFragmentRecord as o, type StoryPageFieldNeeds as p, type CellBorderBox as q, type TableBorderBox as r, AUTO_PARAGRAPH_SPACING_PT as s, type BorderGridGeometry as t, type ContentControlGeometryFragment as u, type ContentControlLevel as v, type ContentControlLock as w, type ContentControlMappedType as x, DEFAULT_PAGE_GEOMETRY as y, DEFAULT_RUN_STYLE as z };

package/dist/{shaped-measurer-CBOTJTV_.d.cts → shaped-measurer-C2SJAjV0.d.cts}

@@ -1,4 +1,4 @@
-import { R as ResolvedRunStyle, T as TextMeasurer } from './semantic-records-DSD8WENa.cjs';
+import { R as ResolvedRunStyle, T as TextMeasurer } from './semantic-records-DEOs3_tE.cjs';
 
 /**
  * A face, as something asks for it: family plus the two axes this engine admits.

package/dist/{shaped-measurer-BL8g4AcW.d.ts → shaped-measurer-l4o5ITJ0.d.ts}

@@ -1,4 +1,4 @@
-import { R as ResolvedRunStyle, T as TextMeasurer } from './semantic-records-CR5hTqMK.js';
+import { R as ResolvedRunStyle, T as TextMeasurer } from './semantic-records-CdQvpUj1.js';
 
 /**
  * A face, as something asks for it: family plus the two axes this engine admits.