@docx-editor.dev/core 2.1.2 → 2.2.0

package/dist/semantic-paint-BBNaqr1s.d.ts

@@ -0,0 +1,133 @@
+import { C as ContentControlBoundaryRecord, S as SemanticLayout } from './semantic-records-BC4bIKKL.js';
+import { V as ValidatedImageBytesHandle, R as RenderableImageMime } from './image-resources-C_YnqPhn.js';
+
+/** Host port for safe blob URLs — only called for {@link ImageResourceState.kind} `ready`. */
+interface PaintImageUrlPort {
+    create(handle: ValidatedImageBytesHandle, mime: RenderableImageMime): string;
+    revoke(url: string): void;
+}
+/** Localized refusal labels; adapters supply i18n-backed implementations. */
+interface DrawingPaintStrings {
+    readonly unsupportedFormat: (format: string) => string;
+    readonly nonPictureGraphic: (kind: string) => string;
+    readonly missingResource: string;
+    readonly externalResource: string;
+    readonly invalidResource: string;
+    readonly contentMismatch: string;
+    readonly decodeFailed: string;
+    readonly resourceLimit: string;
+    readonly pendingResource: string;
+}
+
+/**
+ * When a field's result is drawn on its grey block, following Word's own View option.
+ *
+ * `when-selected` is Word's default and the reason the option exists at all: a document dense
+ * with cross-references turns largely grey under `always`, and under `never` a reader cannot
+ * tell computed text from typed text at all.
+ */
+type FieldShadingMode = 'never' | 'when-selected' | 'always';
+/** Word's default: shaded only while the caret is inside the field. */
+declare const DEFAULT_FIELD_SHADING: FieldShadingMode;
+/**
+ * How a layout is painted into DOM. Every field is optional.
+ *
+ * The painted pages ARE the editable surface, so everything here is presentation-only — nothing
+ * set through these options is ever serialised back into the document.
+ */
+interface PaintOptions {
+    /** Points to CSS pixels. 96/72 renders a point as a CSS point at 100% zoom. */
+    readonly scale?: number;
+    /** Generated paragraphs that paint as non-editable navigation surfaces. */
+    readonly readOnlyParagraphIds?: ReadonlySet<string>;
+    /**
+     * Empty-TOC begin paragraphs that paint subtle identifiable furniture. Paint-only — never
+     * serialised into the document.
+     */
+    readonly emptyTocPlaceholderIds?: ReadonlySet<string>;
+    /** Marks painted pages as presentational, so assistive tech reads the editable projection. */
+    readonly ariaHidden?: boolean;
+    /**
+     * Page indices to build in detail (task 9.4).
+     *
+     * Omitted means all of them. A page left out keeps its size and position but no content,
+     * so the document's height and page count are unchanged and scrolling to it reveals it
+     * instead of reflowing everything underneath.
+     */
+    readonly materialize?: ReadonlySet<number>;
+    /**
+     * Family-alias lookup for fonts the host registered on behalf of THIS document (see
+     * {@link PaintContext.fontAlias}). Painted runs emit the alias ahead of the declared
+     * family, so a file can never shadow a family name the host page uses.
+     */
+    readonly fontAlias?: (family: string) => string | undefined;
+    /** See {@link PaintContext.defaultFontFamily}. */
+    readonly defaultFontFamily?: string;
+    /** See {@link PaintContext.fieldShading}. */
+    readonly fieldShading?: FieldShadingMode;
+    /** See {@link PaintContext.shadeFormFields}. */
+    readonly shadeFormFields?: boolean;
+    /**
+     * Relationship id of the header/footer story currently open for editing.
+     *
+     * When set, the matching `[data-docx-hf]` container is editable and every body
+     * `.docx-page-content` box is inert; all other furniture stays read-only.
+     */
+    readonly activeHeaderFooterRId?: string;
+    /**
+     * Sheet that hosts the active visual occurrence of a shared furniture part.
+     *
+     * Required with {@link activeHeaderFooterRId} so only one painted copy receives
+     * `data-docx-hf-active` / the engine caret when the same rId appears on many pages.
+     */
+    readonly activeHeaderFooterPageIndex?: number;
+    /**
+     * On-demand content-control boundary chrome (show-all and/or caret-entry).
+     *
+     * Furniture only — never contributes layout records or changes page geometry. Omitted or
+     * empty means no control chrome is painted. Folded into the paint-reuse key so a toggle
+     * rebuilds furniture without a layout pass.
+     */
+    readonly contentControlChrome?: {
+        readonly showAll?: boolean;
+        /** Control ids whose boundaries are visible because the caret is inside them. */
+        readonly activeIds?: ReadonlySet<string>;
+        /**
+         * Control ids whose boundaries are visible because the pointer is over them.
+         * Used for TOC hover chrome without projecting a persistent caret-active state.
+         *
+         * Deliberately OUTSIDE the paint-reuse key: hover must never rebuild a page. The
+         * surface toggles `data-hover` / `data-boundary-visible` on the painted chrome it
+         * already has, and this set only tells a page that rebuilds for some OTHER reason
+         * which of its controls is currently under the pointer.
+         */
+        readonly hoverIds?: ReadonlySet<string>;
+        /**
+         * Control ids whose boundary furniture is painted by something else.
+         *
+         * An empty TOC paints its own placeholder box on the begin paragraph, so drawing the
+         * control boundary as well left two rounded rectangles (of different heights) plus a
+         * label chip stacked over one empty region.
+         */
+        readonly suppressedIds?: ReadonlySet<string>;
+        /** Checkbox control ids whose canonical `w14:checked` state is on. */
+        readonly checkedIds?: ReadonlySet<string>;
+        /** Non-SDT structured regions that intentionally reuse content-control chrome. */
+        readonly additionalBoundaries?: readonly ContentControlBoundaryRecord[];
+        /** Control ids that represent TOC regions (hover-only chrome; never caret-sticky). */
+        readonly tocControlIds?: ReadonlySet<string>;
+    };
+    readonly drawingStrings?: DrawingPaintStrings;
+    readonly imageUrlPort?: PaintImageUrlPort;
+}
+
+/**
+ * Paint a whole layout into a container, reusing the pages that did not change.
+ *
+ * The DOM is built with `createElement` and `textContent` only — no file-derived string is
+ * ever parsed as markup — and stray children (nothing this module painted) are removed, so
+ * the container's content is always exactly the painted pages.
+ */
+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 };

package/dist/semantic-paint-DdGGra4m.d.cts

@@ -0,0 +1,133 @@
+import { C as ContentControlBoundaryRecord, S as SemanticLayout } from './semantic-records-DC6V1U3T.cjs';
+import { V as ValidatedImageBytesHandle, R as RenderableImageMime } from './image-resources-DwpNnTg3.cjs';
+
+/** Host port for safe blob URLs — only called for {@link ImageResourceState.kind} `ready`. */
+interface PaintImageUrlPort {
+    create(handle: ValidatedImageBytesHandle, mime: RenderableImageMime): string;
+    revoke(url: string): void;
+}
+/** Localized refusal labels; adapters supply i18n-backed implementations. */
+interface DrawingPaintStrings {
+    readonly unsupportedFormat: (format: string) => string;
+    readonly nonPictureGraphic: (kind: string) => string;
+    readonly missingResource: string;
+    readonly externalResource: string;
+    readonly invalidResource: string;
+    readonly contentMismatch: string;
+    readonly decodeFailed: string;
+    readonly resourceLimit: string;
+    readonly pendingResource: string;
+}
+
+/**
+ * When a field's result is drawn on its grey block, following Word's own View option.
+ *
+ * `when-selected` is Word's default and the reason the option exists at all: a document dense
+ * with cross-references turns largely grey under `always`, and under `never` a reader cannot
+ * tell computed text from typed text at all.
+ */
+type FieldShadingMode = 'never' | 'when-selected' | 'always';
+/** Word's default: shaded only while the caret is inside the field. */
+declare const DEFAULT_FIELD_SHADING: FieldShadingMode;
+/**
+ * How a layout is painted into DOM. Every field is optional.
+ *
+ * The painted pages ARE the editable surface, so everything here is presentation-only — nothing
+ * set through these options is ever serialised back into the document.
+ */
+interface PaintOptions {
+    /** Points to CSS pixels. 96/72 renders a point as a CSS point at 100% zoom. */
+    readonly scale?: number;
+    /** Generated paragraphs that paint as non-editable navigation surfaces. */
+    readonly readOnlyParagraphIds?: ReadonlySet<string>;
+    /**
+     * Empty-TOC begin paragraphs that paint subtle identifiable furniture. Paint-only — never
+     * serialised into the document.
+     */
+    readonly emptyTocPlaceholderIds?: ReadonlySet<string>;
+    /** Marks painted pages as presentational, so assistive tech reads the editable projection. */
+    readonly ariaHidden?: boolean;
+    /**
+     * Page indices to build in detail (task 9.4).
+     *
+     * Omitted means all of them. A page left out keeps its size and position but no content,
+     * so the document's height and page count are unchanged and scrolling to it reveals it
+     * instead of reflowing everything underneath.
+     */
+    readonly materialize?: ReadonlySet<number>;
+    /**
+     * Family-alias lookup for fonts the host registered on behalf of THIS document (see
+     * {@link PaintContext.fontAlias}). Painted runs emit the alias ahead of the declared
+     * family, so a file can never shadow a family name the host page uses.
+     */
+    readonly fontAlias?: (family: string) => string | undefined;
+    /** See {@link PaintContext.defaultFontFamily}. */
+    readonly defaultFontFamily?: string;
+    /** See {@link PaintContext.fieldShading}. */
+    readonly fieldShading?: FieldShadingMode;
+    /** See {@link PaintContext.shadeFormFields}. */
+    readonly shadeFormFields?: boolean;
+    /**
+     * Relationship id of the header/footer story currently open for editing.
+     *
+     * When set, the matching `[data-docx-hf]` container is editable and every body
+     * `.docx-page-content` box is inert; all other furniture stays read-only.
+     */
+    readonly activeHeaderFooterRId?: string;
+    /**
+     * Sheet that hosts the active visual occurrence of a shared furniture part.
+     *
+     * Required with {@link activeHeaderFooterRId} so only one painted copy receives
+     * `data-docx-hf-active` / the engine caret when the same rId appears on many pages.
+     */
+    readonly activeHeaderFooterPageIndex?: number;
+    /**
+     * On-demand content-control boundary chrome (show-all and/or caret-entry).
+     *
+     * Furniture only — never contributes layout records or changes page geometry. Omitted or
+     * empty means no control chrome is painted. Folded into the paint-reuse key so a toggle
+     * rebuilds furniture without a layout pass.
+     */
+    readonly contentControlChrome?: {
+        readonly showAll?: boolean;
+        /** Control ids whose boundaries are visible because the caret is inside them. */
+        readonly activeIds?: ReadonlySet<string>;
+        /**
+         * Control ids whose boundaries are visible because the pointer is over them.
+         * Used for TOC hover chrome without projecting a persistent caret-active state.
+         *
+         * Deliberately OUTSIDE the paint-reuse key: hover must never rebuild a page. The
+         * surface toggles `data-hover` / `data-boundary-visible` on the painted chrome it
+         * already has, and this set only tells a page that rebuilds for some OTHER reason
+         * which of its controls is currently under the pointer.
+         */
+        readonly hoverIds?: ReadonlySet<string>;
+        /**
+         * Control ids whose boundary furniture is painted by something else.
+         *
+         * An empty TOC paints its own placeholder box on the begin paragraph, so drawing the
+         * control boundary as well left two rounded rectangles (of different heights) plus a
+         * label chip stacked over one empty region.
+         */
+        readonly suppressedIds?: ReadonlySet<string>;
+        /** Checkbox control ids whose canonical `w14:checked` state is on. */
+        readonly checkedIds?: ReadonlySet<string>;
+        /** Non-SDT structured regions that intentionally reuse content-control chrome. */
+        readonly additionalBoundaries?: readonly ContentControlBoundaryRecord[];
+        /** Control ids that represent TOC regions (hover-only chrome; never caret-sticky). */
+        readonly tocControlIds?: ReadonlySet<string>;
+    };
+    readonly drawingStrings?: DrawingPaintStrings;
+    readonly imageUrlPort?: PaintImageUrlPort;
+}
+
+/**
+ * Paint a whole layout into a container, reusing the pages that did not change.
+ *
+ * The DOM is built with `createElement` and `textContent` only — no file-derived string is
+ * ever parsed as markup — and stray children (nothing this module painted) are removed, so
+ * the container's content is always exactly the painted pages.
+ */
+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 };

package/dist/{semantic-records-zTC0_1zi.d.ts → semantic-records-BC4bIKKL.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-DWLCllG7.js';
 import { O as OoxmlNode, o as OoxmlDrawingNode, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.js';
-import { I as ImageResourceState } from './image-resources-C_YnqPhn.js';
 import { a as RevisionAttribution } from './revision-projection-DHAkcD_L.js';
+import { I as ImageResourceState } from './image-resources-C_YnqPhn.js';
 
 /** Whether a paragraph must start a new page (`w:pageBreakBefore`). */
 declare function paragraphBreaksBefore(props: readonly OoxmlProperty[]): boolean;
@@ -562,42 +562,26 @@ interface AnchoredDrawingRecord extends Omit<InlineDrawingRecord, 'kind' | 'base
 }
 
 /**
- * Page-field evaluation context for furniture projection.
+ * What a piece says about the FIELD result it came from, for Word's shading.
  *
- * `pageNumber` is the displayed PAGE value after section `w:pgNumType/@w:start` (1-based).
- * `pageCount` is document NUMPAGES. `sectionPageCount` is SECTIONPAGES for the attached
- * section. `format` is the authored `w:pgNumType/@w:fmt` applied only to PAGE.
+ * Carried from layout rather than decided at paint time because only the walk knows an atom was
+ * a field at all — by paint the result is just text. Whether the shading is actually drawn is a
+ * view decision made downstream, so this states the fact and nothing about the appearance.
  */
-interface FieldPageContext {
-    readonly pageNumber: number;
-    readonly pageCount: number;
-    /** SECTIONPAGES; defaults to `pageCount` when omitted (single-section callers). */
-    readonly sectionPageCount?: number;
-    /** Authored ST_NumberFormat for PAGE; absent → decimal. */
-    readonly format?: string;
+interface FieldAtomMarker {
+    /**
+     * A legacy form field: `w:fldChar/w:ffData` (FORMTEXT, FORMCHECKBOX, FORMDROPDOWN).
+     *
+     * Word shades these on a different rule from ordinary fields — always, unless the document
+     * turns it off — because they mark the blanks somebody is meant to fill in.
+     */
+    readonly formField: boolean;
 }
 /** 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;
-/**
- * Format a displayed PAGE value through the shared ST_NumberFormat resolver.
- *
- * Unknown / script-specific formats fall back to decimal (same convention as list markers).
- * `none` / `bullet` are meaningless for page numbers and also fall back to decimal so a
- * hostile fmt cannot blank the furniture.
- */
-declare function formatPageNumber(value: number, format: string | undefined): string;
 
 /** Test-only mutable counters; omitted by production call sites. Not package-public. */
 interface TableBorderGridResolveWork {
@@ -908,11 +892,23 @@ interface StyleSpanRecord {
      * could disagree with what was painted, and the card would point at the wrong text.
      */
     readonly revisions?: readonly RevisionAttribution[];
+    /**
+     * Present when this span is a field's displayed RESULT, for the shading Word draws under one.
+     *
+     * `projected` cannot answer this: it is also set for note marks and inline drawings, so it
+     * says "layout owns these glyphs" rather than "this is a field". Word shades legacy form
+     * fields on a different rule from ordinary ones, which is why the marker distinguishes them.
+     *
+     * States the FACT, never the appearance — whether shading is drawn is a view decision, made
+     * downstream from a host option and the document's own `w:doNotShadeFormData`. Deciding it
+     * here would put the caret into layout's cache key and repaginate on every arrow press.
+     */
+    readonly fieldAtom?: FieldAtomMarker;
     /**
      * Live PAGE/NUMPAGES/SECTIONPAGES projection (layout-time evaluated text).
      *
-     * Not model-editable until typed fields land: paint treats these as atomic furniture and
-     * selection mapping refuses them the way it refuses markers.
+     * Computed substitutions are not model-editable: paint treats these as atomic furniture
+     * and selection mapping refuses them the way it refuses markers.
      */
     readonly projected?: boolean;
     /**
@@ -1502,4 +1498,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_TWIPS as E, type FieldPageContext as F, EMPTY_TAB_STOPS as G, type HyperlinkProjector 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, type SpanLinkRecord as a8, TAB_LEADER_GLYPH as a9, nextTabDestination as aA, paragraphBorderExtentPt as aB, paragraphBorderStrokeWidthPt as aC, paragraphBorders as aD, paragraphBordersFingerprint as aE, paragraphBreaksBefore as aF, paragraphContextualSpacing as aG, paragraphFragmentsOf as aH, paragraphFragmentsOfBlocks as aI, paragraphLineSpacing as aJ, paragraphSpacing as aK, paragraphTabStops as aL, readBorderSide as aM, readCellBorders as aN, readTableBorders as aO, resolveBorderConflict as aP, resolveRunStyle as aQ, resolveTableCellBorderGrid as aR, runStylesEqual as aS, tabAdvanceWidth as aT, tabStopsFingerprint as aU, unionLayoutBoxes as aV, withDefaultTabInterval as aW, type TabAlignment as aa, type TabDestination as ab, type TabLeader as ac, type TabStop as ad, type TableBorderSideName as ae, type TableBorderStrokeRecord as af, type TableFragmentRecord as ag, type VerticalAlign as ah, appliedSpaceBefore as ai, applyLineSpacing as aj, baselineShiftPtOf as ak, borderExtentPt as al, borderWeight as am, bottomBorderExtentPt as an, cascadedParagraphBorders as ao, cascadedTabStops as ap, collapsedSpaceBefore as aq, contentControlsOfLayout as ar, defaultTabIntervalFromSettings as as, displayText as at, effectiveContentControlLock as au, formatPageNumber as av, fragmentsOfParagraph as aw, lineAtPosition as ax, linesOf as ay, measureDisplayText 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 CellBorderBox as p, type TableBorderBox as q, AUTO_PARAGRAPH_SPACING_PT as r, type BorderGridGeometry as s, type ContentControlGeometryFragment as t, type ContentControlLevel as u, type ContentControlLock as v, type ContentControlMappedType as w, DEFAULT_PAGE_GEOMETRY as x, DEFAULT_RUN_STYLE as y, DEFAULT_TAB_INTERVAL_PT as z };
+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 };

package/dist/{semantic-records-COVFW5aS.d.cts → semantic-records-DC6V1U3T.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-UOXlRUqQ.cjs';
 import { O as OoxmlNode, o as OoxmlDrawingNode, a as OoxmlElement } from './ooxml-tree-BU0e3DVi.cjs';
-import { I as ImageResourceState } from './image-resources-DwpNnTg3.cjs';
 import { a as RevisionAttribution } from './revision-projection-72ZApe-g.cjs';
+import { I as ImageResourceState } from './image-resources-DwpNnTg3.cjs';
 
 /** Whether a paragraph must start a new page (`w:pageBreakBefore`). */
 declare function paragraphBreaksBefore(props: readonly OoxmlProperty[]): boolean;
@@ -562,42 +562,26 @@ interface AnchoredDrawingRecord extends Omit<InlineDrawingRecord, 'kind' | 'base
 }
 
 /**
- * Page-field evaluation context for furniture projection.
+ * What a piece says about the FIELD result it came from, for Word's shading.
  *
- * `pageNumber` is the displayed PAGE value after section `w:pgNumType/@w:start` (1-based).
- * `pageCount` is document NUMPAGES. `sectionPageCount` is SECTIONPAGES for the attached
- * section. `format` is the authored `w:pgNumType/@w:fmt` applied only to PAGE.
+ * Carried from layout rather than decided at paint time because only the walk knows an atom was
+ * a field at all — by paint the result is just text. Whether the shading is actually drawn is a
+ * view decision made downstream, so this states the fact and nothing about the appearance.
  */
-interface FieldPageContext {
-    readonly pageNumber: number;
-    readonly pageCount: number;
-    /** SECTIONPAGES; defaults to `pageCount` when omitted (single-section callers). */
-    readonly sectionPageCount?: number;
-    /** Authored ST_NumberFormat for PAGE; absent → decimal. */
-    readonly format?: string;
+interface FieldAtomMarker {
+    /**
+     * A legacy form field: `w:fldChar/w:ffData` (FORMTEXT, FORMCHECKBOX, FORMDROPDOWN).
+     *
+     * Word shades these on a different rule from ordinary fields — always, unless the document
+     * turns it off — because they mark the blanks somebody is meant to fill in.
+     */
+    readonly formField: boolean;
 }
 /** 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;
-/**
- * Format a displayed PAGE value through the shared ST_NumberFormat resolver.
- *
- * Unknown / script-specific formats fall back to decimal (same convention as list markers).
- * `none` / `bullet` are meaningless for page numbers and also fall back to decimal so a
- * hostile fmt cannot blank the furniture.
- */
-declare function formatPageNumber(value: number, format: string | undefined): string;
 
 /** Test-only mutable counters; omitted by production call sites. Not package-public. */
 interface TableBorderGridResolveWork {
@@ -908,11 +892,23 @@ interface StyleSpanRecord {
      * could disagree with what was painted, and the card would point at the wrong text.
      */
     readonly revisions?: readonly RevisionAttribution[];
+    /**
+     * Present when this span is a field's displayed RESULT, for the shading Word draws under one.
+     *
+     * `projected` cannot answer this: it is also set for note marks and inline drawings, so it
+     * says "layout owns these glyphs" rather than "this is a field". Word shades legacy form
+     * fields on a different rule from ordinary ones, which is why the marker distinguishes them.
+     *
+     * States the FACT, never the appearance — whether shading is drawn is a view decision, made
+     * downstream from a host option and the document's own `w:doNotShadeFormData`. Deciding it
+     * here would put the caret into layout's cache key and repaginate on every arrow press.
+     */
+    readonly fieldAtom?: FieldAtomMarker;
     /**
      * Live PAGE/NUMPAGES/SECTIONPAGES projection (layout-time evaluated text).
      *
-     * Not model-editable until typed fields land: paint treats these as atomic furniture and
-     * selection mapping refuses them the way it refuses markers.
+     * Computed substitutions are not model-editable: paint treats these as atomic furniture
+     * and selection mapping refuses them the way it refuses markers.
      */
     readonly projected?: boolean;
     /**
@@ -1502,4 +1498,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_TWIPS as E, type FieldPageContext as F, EMPTY_TAB_STOPS as G, type HyperlinkProjector 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, type SpanLinkRecord as a8, TAB_LEADER_GLYPH as a9, nextTabDestination as aA, paragraphBorderExtentPt as aB, paragraphBorderStrokeWidthPt as aC, paragraphBorders as aD, paragraphBordersFingerprint as aE, paragraphBreaksBefore as aF, paragraphContextualSpacing as aG, paragraphFragmentsOf as aH, paragraphFragmentsOfBlocks as aI, paragraphLineSpacing as aJ, paragraphSpacing as aK, paragraphTabStops as aL, readBorderSide as aM, readCellBorders as aN, readTableBorders as aO, resolveBorderConflict as aP, resolveRunStyle as aQ, resolveTableCellBorderGrid as aR, runStylesEqual as aS, tabAdvanceWidth as aT, tabStopsFingerprint as aU, unionLayoutBoxes as aV, withDefaultTabInterval as aW, type TabAlignment as aa, type TabDestination as ab, type TabLeader as ac, type TabStop as ad, type TableBorderSideName as ae, type TableBorderStrokeRecord as af, type TableFragmentRecord as ag, type VerticalAlign as ah, appliedSpaceBefore as ai, applyLineSpacing as aj, baselineShiftPtOf as ak, borderExtentPt as al, borderWeight as am, bottomBorderExtentPt as an, cascadedParagraphBorders as ao, cascadedTabStops as ap, collapsedSpaceBefore as aq, contentControlsOfLayout as ar, defaultTabIntervalFromSettings as as, displayText as at, effectiveContentControlLock as au, formatPageNumber as av, fragmentsOfParagraph as aw, lineAtPosition as ax, linesOf as ay, measureDisplayText 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 CellBorderBox as p, type TableBorderBox as q, AUTO_PARAGRAPH_SPACING_PT as r, type BorderGridGeometry as s, type ContentControlGeometryFragment as t, type ContentControlLevel as u, type ContentControlLock as v, type ContentControlMappedType as w, DEFAULT_PAGE_GEOMETRY as x, DEFAULT_RUN_STYLE as y, DEFAULT_TAB_INTERVAL_PT as z };
+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 };

package/dist/{shaped-measurer-CZXL-a6v.d.ts → shaped-measurer-ChSWkuAT.d.ts}

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

package/dist/{shaped-measurer-AFnFxoot.d.cts → shaped-measurer-SIqZp-Ty.d.cts}

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