superdoc 2.12.0-next.8 → 2.12.0

package/dist/layout-engine/contracts/src/column-layout.d.ts

@@ -15,6 +15,21 @@ export type ColumnGeometry = {
 };
 export type NormalizedColumnLayout = ColumnLayout & {
     width: number;
+    /**
+     * The content-area width the layout was normalized against, in px.
+     *
+     * Only RTL geometry reads it, and it exists because `width` above is the WIDEST column, not the
+     * strip: explicit widths are deliberately not scaled to fill the content area (Word renders an
+     * authored 2880tw column as 2880tw and leaves the slack), so a strip of explicit columns can be
+     * narrower — or wider — than the area it sits in. Mirroring such a strip about its own span would
+     * keep it pinned to the LEFT margin and only swap the columns inside it, which is not what Word
+     * does: the first column belongs against the RIGHT margin and the slack falls on the left.
+     *
+     * Optional because `getColumnGeometry` also accepts hand-built layouts (column balancing assembles
+     * one directly). When absent, RTL mirrors about the strip's own span, which is exact whenever the
+     * columns fill the area — always true in equal mode.
+     */
+    contentWidth?: number;
 };
 export declare function widthsEqual(a?: number[], b?: number[]): boolean;
 /**
@@ -61,7 +76,49 @@ export declare function getColumnX(geometry: ColumnGeometry[], index: number, or
 export declare function getColumnGapAfter(geometry: ColumnGeometry[], index: number): number;
 /** Absolute x of each separator line (only columns that draw one), as `originX + content-relative`. */
 export declare function getColumnSeparatorPositions(geometry: ColumnGeometry[], originX?: number): number[];
-/** Index of the column containing absolute `x` (clicks in a gap map to the preceding column). */
+/**
+ * Index of the column whose OWN span contains absolute `x`, or `null` when `x` lies in no column at
+ * all — a gutter, the page margins, or something that is not column flow in the first place.
+ *
+ * This is the strict counterpart to `getColumnAtX` below, and the two exist because paint-time and
+ * hit-testing want opposite answers. A click has to select something, so `getColumnAtX` clamps and
+ * hands a gap to its neighbouring column. Asking "is there content in a later column" must not
+ * clamp: `page.items` carries page-anchored objects, and a full-width watermark belongs to no
+ * column, so answering with one makes it evidence for chrome Word does not draw.
+ *
+ * Direction-agnostic by construction. It tests containment in each column's own span instead of
+ * comparing against a boundary, so it does not care whether `x` ascends or descends with the index,
+ * and — unlike an edge test — it is not fooled by a fragment WIDER than its column. An over-wide
+ * table is placed at its column's left edge and overflows rightward in both directions, so its
+ * origin still identifies its column while its trailing edge does not.
+ *
+ * Spans are half-open — `[x, x + width)` — so that adjacent columns authored with no gutter at all
+ * (`w:space="0"`) do not both claim the boundary they share. That boundary is exactly where the
+ * later column's own content is placed, and an inclusive upper bound would hand it to the earlier
+ * column instead. Columns are scanned in fill order and the first containing span wins, which
+ * after that only matters for an overfull explicit strip whose columns genuinely overlap.
+ */
+export declare function findColumnContaining(geometry: ColumnGeometry[], x: number, originX?: number): number | null;
+/**
+ * Index of the column containing absolute `x` (clicks in a gap map to the preceding column).
+ *
+ * The walk is direction-aware and cannot assume ascending `x`: in an RTL section column 0 sits on
+ * the right, so `x` DESCENDS with the index. The mirrored branch keeps the same rule the LTR branch
+ * states — a point in a gap belongs to the column that precedes it in FILL order — which is what
+ * makes a drag that crosses the gutter keep extending from the column it is leaving instead of
+ * jumping. Direction is read off the geometry rather than taken as an argument, so every existing
+ * caller keeps working unchanged.
+ *
+ * Both branches test a HALF-OPEN span, so this agrees with `findColumnContaining` on every boundary
+ * the two can both answer. The LTR branch gets that from `cx >= col.x`: a point on a shared edge is
+ * the later column's, because that is where the later column's content begins. The mirrored branch
+ * has to say the same thing from the other side — the shared edge is the EARLIER fill column's left
+ * edge there — which is `cx < col.x + col.width`, exclusive. An inclusive bound handed that point to
+ * the later column, contradicting the half-open span the geometry places content in, and it also
+ * pulled in the point one pixel-width past a column's trailing edge, which is gutter and belongs to
+ * the preceding column. With `w:space="0"` the two coincide and every column boundary in an RTL
+ * section resolved one column too far.
+ */
 export declare function getColumnAtX(geometry: ColumnGeometry[], x: number, originX?: number): number;
 /** Structural equality of two column layouts, including per-column `gaps`. */
 export declare function columnLayoutsEqual(a?: ColumnLayout, b?: ColumnLayout): boolean;

package/dist/layout-engine/contracts/src/graphic-placement.d.ts

@@ -1,3 +1,4 @@
+import { BaseDirection } from './direction-context.js';
 /** ECMA-376 Part 1 §20.4.3.4 (`ST_RelFromH`). */
 export declare const ANCHOR_H_RELATIVE_VALUES: readonly ["margin", "page", "column", "character", "leftMargin", "rightMargin", "insideMargin", "outsideMargin"];
 /** ECMA-376 Part 1 §20.4.3.5 (`ST_RelFromV`). */
@@ -52,6 +53,8 @@ export type ColumnLayoutForAnchor = {
     count: number;
     widths?: number[];
     gaps?: number[];
+    direction?: BaseDirection;
+    contentWidth?: number;
 };
 /**
  * Inputs for resolving the paint Y of an anchored image, drawing, or floating table.

package/dist/layout-engine/contracts/src/index.d.ts

@@ -2,7 +2,7 @@ import { TabStop } from './engines/tabs.js';
 import { PageNumberChapterSeparator, PageNumberFieldFormat, PageNumberFormat } from './page-number-formatting.js';
 import { TrackedChangeSemanticColorKey } from './semantic-colors.js';
 import { AnchorAlignH, AnchorAlignV, AnchorHRelative, AnchorVRelative } from './graphic-placement.js';
-import { ParagraphDirectionContext, RunBidiContext, RunScriptContext, TableDirectionContext } from './direction-context.js';
+import { BaseDirection, ParagraphDirectionContext, RunBidiContext, RunScriptContext, TableDirectionContext } from './direction-context.js';
 import { LayoutSourceIdentity } from './layout-identity.js';
 export { computeTabStops, layoutWithTabs, calculateTabWidth } from './engines/tabs.js';
 export type { TabStop };
@@ -23,7 +23,7 @@ export { LAYOUT_BOUNDARY_SCHEMA, bodyStoryLocator, namedStoryLocator, computeLay
 export type { LayoutBlockRef, LayoutFragmentId, LayoutPartialRowIdentity, LayoutSourceIdentity, LayoutStoryKind, LayoutStoryLocator, } from './layout-identity.js';
 export { LAYOUT_SEGMENT_GEOMETRY_SCHEMA } from './segment-geometry.js';
 export type { NeutralTextDirection, NeutralSegmentGeometry, NeutralLineGeometryFlags, NeutralLineGeometry, NeutralGeometryDiagnostic, NeutralFragmentGeometry, NeutralSegmentGeometryReadback, } from './segment-geometry.js';
-export { cloneColumnLayout, columnLayoutsEqual, columnRenderLayoutsEqual, getColumnAtX, getColumnGapAfter, getColumnGeometry, getColumnSeparatorPositions, getColumnWidth, getColumnX, normalizeColumnLayout, resolveColumnCount, resolveColumnLayout, resolveColumnMode, widthsEqual, } from './column-layout.js';
+export { cloneColumnLayout, columnLayoutsEqual, columnRenderLayoutsEqual, findColumnContaining, getColumnAtX, getColumnGapAfter, getColumnGeometry, getColumnSeparatorPositions, getColumnWidth, getColumnX, normalizeColumnLayout, resolveColumnCount, resolveColumnLayout, resolveColumnMode, widthsEqual, } from './column-layout.js';
 export type { ColumnGeometry, NormalizedColumnLayout } from './column-layout.js';
 export { authorFromTrackedChangeMeta, authorIdentityKey, composeAuthorColorResolver, fallbackAuthorColor, stampTrackedChangeColors, } from './author-colors.js';
 export type { AuthorColorsConfig, TrackChangeAuthorColorResolver } from './author-colors.js';
@@ -2094,6 +2094,20 @@ export type ColumnLayout = {
      * mode uses the scalar `gap`. When absent, consumers fall back to the uniform `gap`. (SD-2629)
      */
     gaps?: number[];
+    /**
+     * Section page direction, from `w:sectPr/w:bidi`. Decides which side the FIRST column sits on:
+     * `'ltr'` (default) fills left to right, `'rtl'` fills right to left, matching Word.
+     *
+     * Per ECMA-376 §17.6.1 a section's `w:bidi` governs section-level chrome — page numbers, gutters
+     * and columns — and is independent of the paragraph inline direction (§17.3.1.6). It is carried
+     * here, on the column layout itself, because `getColumnGeometry` is the single source every
+     * column consumer reads for positioning (fill, hit testing, separators, balancing, floating
+     * anchors, footnotes); threading the axis alongside the widths keeps those consumers from having
+     * to re-derive it, and keeps them from disagreeing.
+     *
+     * Absent means `'ltr'`. Every existing producer therefore keeps its current geometry unchanged.
+     */
+    direction?: BaseDirection;
 };
 /**
  * A vertical region of a page that shares a single column configuration.
@@ -2836,7 +2850,7 @@ export declare const extractHeaderFooterSpace: (margins?: PageMargins | null) =>
 };
 export type { ResolvedLayout, ResolvedPage, ResolvedPaintItem, ResolvedGroupItem, ResolvedFragmentItem, ResolvedParagraphContent, ResolvedTextLineItem, ResolvedDropCapItem, ResolvedListMarkerItem, ResolvedTableItem, ResolvedImageItem, ResolvedDrawingItem, ResolvedHeaderFooterPage, ResolvedHeaderFooterLayout, } from './resolved-layout.js';
 export { isResolvedTableItem, isResolvedImageItem, isResolvedDrawingItem } from './resolved-layout.js';
-export { expandRunsForInlineNewlines, isEmptyInlineSdtPlaceholderRun, isEmptySdtPlaceholderRun, sliceRunsForLine, usesPositionedTextGeometry, } from './run-helpers.js';
+export { expandRunsForInlineNewlines, isBodyNoteReferenceRun, isNoteLabelRun, isNumberedNoteMarkerRun, isEmptyInlineSdtPlaceholderRun, isEmptySdtPlaceholderRun, NOTE_LABEL_MARKER_ATTR, NOTE_REFERENCE_MARKER_ATTR, sliceRunsForLine, usesPositionedTextGeometry, } from './run-helpers.js';
 export { INLINE_OBJECT_REPLACEMENT_CHARACTER, flattenParagraphVisibleText, mapVisibleRangeToRunSlices, type ParagraphVisibleRunSlice, } from './paragraph-visible-text.js';
 export { inlineBoxStyleSignature, isFiniteNonNegativeInteger, normalizeInlineBoxLogicalSides, type InlineBoxLogicalSides, type ResolvedInlineBoxLogicalSides, } from './inline-box.js';
 export { INCREMENTAL_DEPENDENCY_CERTIFICATE_CLASSES, PAGE_CHECKPOINT_DEPENDENCY_CLASSES, areValidPageCheckpointDependencyClasses, isValidIncrementalDependencyOwnerVersion, isValidNonFlowingPageRelativeAnchorDependencyProof, isValidPageCheckpointDependencyCertificate, type IncrementalDependencyCertificateClass, type IncrementalDependencyOwnerVersion, type NonFlowingPageRelativeAnchorDependencyProof, type PageCheckpointDependencyCertificate, type PageCheckpointDependencyClass, } from './incremental-dependency.js';

package/dist/layout-engine/contracts/src/run-helpers.d.ts

@@ -1,4 +1,12 @@
 import { FlowBlock, Line, Run, TextRun } from './index.js';
+export declare const NOTE_REFERENCE_MARKER_ATTR = "data-v2-note-ref";
+export declare const NOTE_LABEL_MARKER_ATTR = "data-v2-note-label";
+/** Body note markers paint text but occupy one source-coordinate unit. */
+export declare function isBodyNoteReferenceRun(run: Run): boolean;
+/** Synthetic note-band or appended-endnote label keyed to its source note. */
+export declare function isNoteLabelRun(run: Run): boolean;
+/** Numbered marker text whose measurement identity can use digit capabilities. */
+export declare function isNumberedNoteMarkerRun(run: Run): boolean;
 export declare function isEmptySdtPlaceholderRun(run: Run): run is TextRun & {
     visualPlaceholder: 'emptyInlineSdt' | 'emptyBlockSdt';
 };

package/dist/layout-engine/layout-bridge/src/cache.d.ts

@@ -1,4 +1,5 @@
 import { FlowBlock } from '../../contracts/src/index.js';
+import { FontMeasureCapabilities } from '../../../shared/font-system/src/index.js';
 /**
  * Generates a cache key hash from a block's content, incorporating text,
  * formatting, and embedded block data.
@@ -23,7 +24,7 @@ import { FlowBlock } from '../../contracts/src/index.js';
  * content component of that key, so adopting a previous measure on hash
  * equality is exactly as sound as a cache hit.
  */
-export declare const hashMeasureContent: (block: FlowBlock) => string;
+export declare const hashMeasureContent: (block: FlowBlock, capabilities?: FontMeasureCapabilities) => string;
 /**
  * Cache statistics with LRU eviction tracking
  */
@@ -80,12 +81,12 @@ export declare class MeasureCache<T> {
      * @param height - The height dimension for cache key
      * @returns The cached value or undefined
      */
-    get(block: FlowBlock | null | undefined, width: number, height: number, fontSignature?: string): T | undefined;
+    get(block: FlowBlock | null | undefined, width: number, height: number, fontSignature?: string, capabilities?: FontMeasureCapabilities): T | undefined;
     /**
      * Compose the complete content, constraint, and font key once for a cache
      * read followed by an insertion in the same measurement transaction.
      */
-    prepareKey(block: FlowBlock | null | undefined, width: number, height: number, fontSignature?: string): PreparedMeasureCacheKey | undefined;
+    prepareKey(block: FlowBlock | null | undefined, width: number, height: number, fontSignature?: string, capabilities?: FontMeasureCapabilities): PreparedMeasureCacheKey | undefined;
     getPrepared(key: PreparedMeasureCacheKey | undefined): T | undefined;
     /**
      * Store a measure in the cache for the given block and dimensions.
@@ -96,7 +97,7 @@ export declare class MeasureCache<T> {
      * @param height - The height dimension for cache key
      * @param value - The value to cache
      */
-    set(block: FlowBlock | null | undefined, width: number, height: number, value: T, fontSignature?: string): void;
+    set(block: FlowBlock | null | undefined, width: number, height: number, value: T, fontSignature?: string, capabilities?: FontMeasureCapabilities): void;
     setPrepared(key: PreparedMeasureCacheKey | undefined, blockId: string | undefined, value: T): void;
     /**
      * Invalidates cached measurements for specific block IDs.

package/dist/layout-engine/layout-bridge/src/incrementalLayout.d.ts

@@ -1,5 +1,5 @@
 import { NonFlowingPageRelativeAnchorDependencyProof, PageCheckpointDependencyClass, FlowBlock, Layout, LayoutBlockResumeCheckpoint, Measure, Page, HeaderFooterLayout, ColumnLayout } from '../../contracts/src/index.js';
-import { FontMeasureContext } from '../../../shared/font-system/src/index.js';
+import { FontMeasureCapabilities, FontMeasureContext } from '../../../shared/font-system/src/index.js';
 import { LayoutOptions, HeaderFooterConstraints, LayoutExecutionCheckpoint } from '../../layout-engine/src/index.js';
 import { computeDirtyRegions } from './diff.js';
 import { MeasureCache } from './cache.js';
@@ -534,10 +534,13 @@ export declare function incrementalLayout(previousBlocks: FlowBlock[], _previous
 }, previousMeasures?: Measure[] | null, fontRuntime?: {
     fontContext?: FontMeasureContext;
     previousFontSignature?: string;
+    fontCapabilities?: FontMeasureCapabilities;
 }, warmStart?: {
     footnoteReserveSeed?: FootnoteReserveSeed | null;
     /** Host proved the authoritative note projection bundle was retained exactly. */
     noteMeasurePlaneRetainedExact?: true;
+    /** Host proved this seed is an exact, geometry-equivalent subset of the current note plane. */
+    noteMeasurePlaneRetainedSubset?: true;
     /** Extra note/decorative planes paired with the retained note bundle. */
     retainedFootnoteExtras?: {
         blocks: FlowBlock[];

package/dist/layout-engine/layout-bridge/src/note-marker-measure-key.d.ts

@@ -0,0 +1,3 @@
+import { TextRun } from '../../contracts/src/index.js';
+import { FontMeasureCapabilities } from '../../../shared/font-system/src/index.js';
+export declare function noteMarkerMeasureKey(run: TextRun, capabilities?: FontMeasureCapabilities): string;

package/dist/layout-engine/layout-engine/src/column-balancing.d.ts

@@ -1,10 +1,4 @@
-/**
- * Column Balancing Module
- *
- * Implements Word-compatible column balancing for section boundaries.
- * Column balancing distributes content evenly across columns at section end,
- * matching Microsoft Word's behavior.
- */
+import { BaseDirection } from '../../contracts/src/index.js';
 /**
  * Configuration for column balancing behavior.
  */
@@ -199,6 +193,16 @@ export interface SectionColumnLayout {
      */
     gaps?: number[];
     equalWidth?: boolean;
+    /**
+     * Section page direction (`w:sectPr/w:bidi`) and the content width it was normalized against.
+     *
+     * Declared here — and not left to the structural subset above — because balancing REBUILDS the
+     * geometry and then overwrites every fragment's `x` from it. A balanced page that dropped these
+     * would be laid out left-to-right while every earlier page of the same RTL section was laid out
+     * right-to-left, so the last page of a two-column Hebrew section would visibly flip.
+     */
+    direction?: BaseDirection;
+    contentWidth?: number;
 }
 export interface BalanceSectionOnPageArgs {
     /** All fragments on the target page. Only those belonging to sectionIndex are balanced (mutated in place). */

package/dist/layout-engine/layout-engine/src/layout-paragraph.d.ts

@@ -1,7 +1,7 @@
 import { FloatingObjectManager } from './floating-objects.js';
 import { PageState } from './paginator.js';
 import { FootnotePageFlow } from './footnote-page-flow.js';
-import { PageMargins, ParagraphBlock, ParagraphMeasure, ImageBlock, ImageMeasure, DrawingBlock, DrawingMeasure, ParagraphLineRegion } from '../../contracts/src/index.js';
+import { PageMargins, ParagraphBlock, ParagraphMeasure, ImageBlock, ImageMeasure, DrawingBlock, DrawingMeasure, ParagraphLineRegion, ColumnLayoutForAnchor } from '../../contracts/src/index.js';
 import { AnchoredTable } from './anchors.js';
 /**
  * SD-2656: ordered footnote anchor entry. The body slicer reads the candidate
@@ -102,11 +102,7 @@ export type ParagraphAnchorsContext = {
     columnWidth: number;
     pageWidth: number;
     pageMargins: PageMargins;
-    columns: {
-        width: number;
-        gap: number;
-        count: number;
-    };
+    columns: ColumnLayoutForAnchor;
     placedAnchoredIds: Set<string>;
 };
 export declare function layoutParagraphBlock(ctx: ParagraphLayoutContext, anchors?: ParagraphAnchorsContext): void;

package/dist/layout-engine/painters/dom/src/derived-run-text-plane.d.ts

@@ -0,0 +1,9 @@
+import { FlowBlock, Run } from '../../../contracts/src/index.js';
+export type DerivedRunTextPlane = {
+    generation: number;
+    revision: string;
+    valuesByDataAttribute: ReadonlyMap<string, ReadonlyMap<string, string>>;
+};
+export declare function validateDerivedRunTextPlane(plane: DerivedRunTextPlane | null | undefined, generation: number): void;
+export declare function resolveDerivedRunText(run: Run, plane: DerivedRunTextPlane | null | undefined): string | undefined;
+export declare function blockUsesDerivedRunTextPlane(block: FlowBlock | undefined, plane: DerivedRunTextPlane | null | undefined): boolean;

package/dist/layout-engine/painters/dom/src/index.d.ts

@@ -15,6 +15,7 @@ export type { RulerDefinition, RulerConfig, RulerConfigPx, RulerTick, CreateRule
 export type { PaintSnapshot, PaintSnapshotAnnotationEntity, PaintSnapshotStructuredContentBlockEntity, PaintSnapshotStructuredContentInlineEntity, PaintSnapshotImageEntity, PaintSnapshotEntities, } from './renderer.js';
 export type { DomPainterInput, PositionMapping } from './renderer.js';
 export type { DomPainterPersistentPacketSource, DomPainterPersistentPageInput, DomPainterPersistentScaffold, DomPainterPersistentScaffoldPage, } from './persistent-page-surface.js';
+export type { DerivedRunTextPlane } from './derived-run-text-plane.js';
 export type { PaintWorkSummary } from './page-content.js';
 export type { RenderedLineInfo } from './runs/index.js';
 export { sanitizeUrl, linkMetrics, applyRunDataAttributes } from './runs/index.js';

package/dist/layout-engine/painters/dom/src/page-content.d.ts

@@ -3,6 +3,7 @@ import { FragmentRenderContext, PositionMapping } from './renderer.js';
 import { SdtBoundaryOptions } from './sdt/container.js';
 import { BetweenBorderInfo } from './paragraph/borders/index.js';
 import { PageStyles } from './styles.js';
+import { DerivedRunTextPlane } from './derived-run-text-plane.js';
 export type FragmentDomState = {
     key: string;
     signature: string;
@@ -116,7 +117,7 @@ export declare function createEmptyPaintWorkSummary(): PaintWorkSummary;
  * attribute-for-attribute — that exactness is the proof, never normalize it
  * away at the pass level (only the §7.7 unit tests use the normalized form).
  */
-export declare function persistentPageVersionKey(page: ResolvedPage, totalPages: number, sectionPageCount: number): string | null;
+export declare function persistentPageVersionKey(page: ResolvedPage, totalPages: number, sectionPageCount: number, derivedRunTextPlane?: DerivedRunTextPlane | null): string | null;
 /**
  * The class state `renderPage`/`patchPage` consume, made explicit. The
  * DomPainter builds one per call (values like `totalPages`, `layoutEpoch`,
@@ -130,6 +131,7 @@ export interface PageContentContext {
     totalPages: number;
     currentMapping: PositionMapping | null;
     changedBlocks: ReadonlySet<string>;
+    derivedRunTextPlane?: DerivedRunTextPlane | null;
     /** Record the smallest newly painted subtree for transaction finalization. */
     recordChangedRoot?(root: HTMLElement): void;
     sdtLabelsRendered: Set<string>;

package/dist/layout-engine/painters/dom/src/persistent-page-surface.d.ts

@@ -1,4 +1,5 @@
 import { DocumentBackground, ResolvedPage } from '../../../contracts/src/index.js';
+import { DerivedRunTextPlane } from './derived-run-text-plane.js';
 import { PageContentContext, PageDomState, PaintWorkSummary } from './page-content.js';
 /**
  * One exact page band of the committed scaffold (numbers-only,
@@ -69,6 +70,7 @@ export type DomPainterPersistentPageInput = {
     packetsByPageIndex: DomPainterPersistentPacketSource;
     sectionPageCounts?: Readonly<Record<string, number>>;
     documentBackground?: DocumentBackground | null;
+    derivedRunTextPlane?: DerivedRunTextPlane | null;
     captureSnapshot?: boolean;
 };
 /** Shell registry entry: the persistent page root and its geometry/style reuse key. */

package/dist/layout-engine/painters/dom/src/renderer.d.ts

@@ -1,6 +1,7 @@
 import { FlowMode, Fragment, PageMargins, PageNumberChapterSeparator, PageNumberFormat, SourceAnchor, ResolvedLayout, ResolvedPage, ResolvedPaintItem, LayoutSourceIdentity, LayoutStoryLocator } from '../../../contracts/src/index.js';
 import { PaintWorkSummary } from './page-content.js';
 import { DomPainterPersistentPageInput } from './persistent-page-surface.js';
+import { DerivedRunTextPlane } from './derived-run-text-plane.js';
 import { PageStyles } from './styles.js';
 import { PaintSnapshotStructuredContentBlockEntity, PaintSnapshotStructuredContentInlineEntity } from './sdt/snapshot.js';
 import { PositionValidationOptions, PositionValidationSummary } from './pm-position-validation.js';
@@ -143,6 +144,7 @@ export type FragmentRenderContext = {
      * `totalPages` / `sectionPageCount`. Absent/`true` = exact (default).
      */
     pageCountFieldsExact?: boolean;
+    derivedRunTextPlane?: DerivedRunTextPlane | null;
 };
 export type PaintSnapshotLineStyle = {
     paddingLeftPx?: number;
@@ -239,21 +241,6 @@ type PersistentPagePainterTransaction = {
     readFragmentFailures(): readonly PainterFragmentFailure[];
     readChangedRoots(): readonly HTMLElement[];
 };
-/**
- * DOM-based document painter that renders layout fragments to HTML elements.
- * One paint entry per mode (painter plan P7): the persistent shell/content
- * reconcile owns paginated flow, while `paint()` owns semantic flow.
- *
- * @class DomPainter
- *
- * @remarks
- * The DomPainter is responsible for:
- * - Rendering layout fragments (paragraphs, lists, images, tables, drawings) to DOM elements
- * - Managing page-level DOM structure and styling
- * - Handling headers and footers via PageDecorationProvider
- * - Incremental re-rendering when only specific blocks change
- * - Hyperlink rendering with security sanitization and accessibility
- */
 export declare class DomPainter {
     private readonly options;
     private mount;
@@ -305,6 +292,7 @@ export declare class DomPainter {
      * `dispose()` so a stale window value can never leak across modes/mounts.
      */
     private persistentDocumentBackground;
+    private persistentDerivedRunTextPlane;
     private paintWork;
     /**
      * P5 §4.6 (review fix): per-page attribution arrays are opt-in. Counters
@@ -419,7 +407,12 @@ export declare class DomPainter {
      */
     private recordPageWork;
     private renderColumnSeparators;
-    private getColumnSeparatorPositions;
+    /**
+     * The resolved column geometry this region's separators are drawn from, or null when the region
+     * draws none. Returns the geometry rather than bare x positions because the gate needs to know
+     * WHICH column each separator follows, not only where it sits.
+     */
+    private resolveSeparatorColumnGeometry;
     private renderDecorationsForPage;
     /**
      * Check if a fragment is vertically anchored to the page.

package/dist/public/ui-react.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-CBFGggZ2.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-BWWWNPP8.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let react = require("react");
 //#region src/public/ui/react.ts
@@ -118,6 +118,22 @@ var EMPTY_SELECTION = {
 function useSuperDocSelection() {
 	return useSuperDocSlice((ui) => ui.selection, EMPTY_SELECTION);
 }
+/** Subscribe to the current Search session. */
+function useSuperDocSearch() {
+	return useSuperDocSlice((ui) => ui.search, {
+		query: "",
+		total: 0,
+		activeIndex: -1,
+		open: false,
+		available: false,
+		caseSensitive: false,
+		includeTrackedDeletions: false,
+		includeDeletedText: false,
+		regex: false,
+		canReplace: false,
+		canReplaceAll: false
+	});
+}
 /** Subscribe to the comments slice. */
 function useSuperDocComments() {
 	return useSuperDocSlice((ui) => ui.comments, {
@@ -238,6 +254,7 @@ exports.useSuperDocDocument = useSuperDocDocument;
 exports.useSuperDocFontOptions = useSuperDocFontOptions;
 exports.useSuperDocFontSizeOptions = useSuperDocFontSizeOptions;
 exports.useSuperDocHost = useSuperDocHost;
+exports.useSuperDocSearch = useSuperDocSearch;
 exports.useSuperDocSelection = useSuperDocSelection;
 exports.useSuperDocSlice = useSuperDocSlice;
 exports.useSuperDocToolbar = useSuperDocToolbar;

package/dist/public/ui-react.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-C-AuEM9F.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-FnwgTkUv.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 //#region src/public/ui/react.ts
@@ -117,6 +117,22 @@ var EMPTY_SELECTION = {
 function useSuperDocSelection() {
 	return useSuperDocSlice((ui) => ui.selection, EMPTY_SELECTION);
 }
+/** Subscribe to the current Search session. */
+function useSuperDocSearch() {
+	return useSuperDocSlice((ui) => ui.search, {
+		query: "",
+		total: 0,
+		activeIndex: -1,
+		open: false,
+		available: false,
+		caseSensitive: false,
+		includeTrackedDeletions: false,
+		includeDeletedText: false,
+		regex: false,
+		canReplace: false,
+		canReplaceAll: false
+	});
+}
 /** Subscribe to the comments slice. */
 function useSuperDocComments() {
 	return useSuperDocSlice((ui) => ui.comments, {
@@ -228,4 +244,4 @@ function useSuperDocZoom() {
 	});
 }
 //#endregion
-export { SuperDocUIProvider, useSetSuperDoc, useSuperDocCommand, useSuperDocComments, useSuperDocContentControls, useSuperDocDocument, useSuperDocFontOptions, useSuperDocFontSizeOptions, useSuperDocHost, useSuperDocSelection, useSuperDocSlice, useSuperDocToolbar, useSuperDocTrackChanges, useSuperDocUI, useSuperDocZoom };
+export { SuperDocUIProvider, useSetSuperDoc, useSuperDocCommand, useSuperDocComments, useSuperDocContentControls, useSuperDocDocument, useSuperDocFontOptions, useSuperDocFontSizeOptions, useSuperDocHost, useSuperDocSearch, useSuperDocSelection, useSuperDocSlice, useSuperDocToolbar, useSuperDocTrackChanges, useSuperDocUI, useSuperDocZoom };

package/dist/public/ui-vue.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-CBFGggZ2.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-BWWWNPP8.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let vue = require("vue");
 //#region src/public/ui/vue.ts
@@ -189,6 +189,22 @@ var EMPTY_SELECTION = {
 function useSuperDocSelection() {
 	return useSuperDocSlice((ui) => ui.selection, EMPTY_SELECTION);
 }
+/** Subscribe to the current Search session. */
+function useSuperDocSearch() {
+	return useSuperDocSlice((ui) => ui.search, {
+		query: "",
+		total: 0,
+		activeIndex: -1,
+		open: false,
+		available: false,
+		caseSensitive: false,
+		includeTrackedDeletions: false,
+		includeDeletedText: false,
+		regex: false,
+		canReplace: false,
+		canReplaceAll: false
+	});
+}
 /** Subscribe to the comments slice. */
 function useSuperDocComments() {
 	return useSuperDocSlice((ui) => ui.comments, {
@@ -310,6 +326,7 @@ exports.useSuperDocDocument = useSuperDocDocument;
 exports.useSuperDocFontOptions = useSuperDocFontOptions;
 exports.useSuperDocFontSizeOptions = useSuperDocFontSizeOptions;
 exports.useSuperDocHost = useSuperDocHost;
+exports.useSuperDocSearch = useSuperDocSearch;
 exports.useSuperDocSelection = useSuperDocSelection;
 exports.useSuperDocSlice = useSuperDocSlice;
 exports.useSuperDocToolbar = useSuperDocToolbar;

package/dist/public/ui-vue.es.js

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-C-AuEM9F.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-FnwgTkUv.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { computed, inject, onScopeDispose, provide, shallowRef, toRaw, toValue, watch } from "vue";
 //#region src/public/ui/vue.ts
@@ -188,6 +188,22 @@ var EMPTY_SELECTION = {
 function useSuperDocSelection() {
 	return useSuperDocSlice((ui) => ui.selection, EMPTY_SELECTION);
 }
+/** Subscribe to the current Search session. */
+function useSuperDocSearch() {
+	return useSuperDocSlice((ui) => ui.search, {
+		query: "",
+		total: 0,
+		activeIndex: -1,
+		open: false,
+		available: false,
+		caseSensitive: false,
+		includeTrackedDeletions: false,
+		includeDeletedText: false,
+		regex: false,
+		canReplace: false,
+		canReplaceAll: false
+	});
+}
 /** Subscribe to the comments slice. */
 function useSuperDocComments() {
 	return useSuperDocSlice((ui) => ui.comments, {
@@ -299,4 +315,4 @@ function useSuperDocZoom() {
 	});
 }
 //#endregion
-export { provideSuperDocUI, useClearSuperDoc, useSetSuperDoc, useSuperDocCommand, useSuperDocComments, useSuperDocContentControls, useSuperDocDocument, useSuperDocFontOptions, useSuperDocFontSizeOptions, useSuperDocHost, useSuperDocSelection, useSuperDocSlice, useSuperDocToolbar, useSuperDocTrackChanges, useSuperDocUI, useSuperDocZoom };
+export { provideSuperDocUI, useClearSuperDoc, useSetSuperDoc, useSuperDocCommand, useSuperDocComments, useSuperDocContentControls, useSuperDocDocument, useSuperDocFontOptions, useSuperDocFontSizeOptions, useSuperDocHost, useSuperDocSearch, useSuperDocSelection, useSuperDocSlice, useSuperDocToolbar, useSuperDocTrackChanges, useSuperDocUI, useSuperDocZoom };

package/dist/public/ui.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-CBFGggZ2.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-BWWWNPP8.cjs");
 exports.BUILT_IN_COMMAND_IDS = require_create_super_doc_ui.BUILT_IN_COMMAND_IDS;
 exports.createSuperDocUI = require_create_super_doc_ui.createSuperDocUI;
 exports.shallowEqual = require_create_super_doc_ui.shallowEqual;

package/dist/public/ui.es.js

@@ -1,2 +1,2 @@
-import { n as shallowEqual, r as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-C-AuEM9F.es.js";
+import { n as shallowEqual, r as BUILT_IN_COMMAND_IDS, t as createSuperDocUI } from "../chunks/create-super-doc-ui-FnwgTkUv.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };

package/dist/shared/font-system/src/index.d.ts

@@ -15,7 +15,7 @@
  */
 export type { FontLoadStatus, FontFaceSource, FontFaceDescriptor, RegisteredFace, RegisterFaceResult, FontLoadResult, FontLoadSummary, FontFaceRequest, FontFaceLoadResult, FontAssetUrlContext, FontAssetUrlResolver, RequiredFace, } from './types.js';
 export { SETTLED_STATUSES, isSettled } from './types.js';
-export type { FontResolution, FontResolutionReason, FaceKey, HasFace, FontMeasureContext, ResolvePhysicalFamily, ResolveNaturalLineMultiplier, } from './resolver.js';
+export type { FontResolution, FontResolutionReason, FaceKey, HasFace, FontMeasureCapabilities, FontMeasureContext, FontMeasureFace, ResolvePhysicalFamily, ResolveNaturalLineMultiplier, } from './resolver.js';
 export { FontResolver, createFontResolver, insertFontFamilyBeforeGeneric } from './resolver.js';
 export { resolveFontFamily, resolvePhysicalFamily, resolvePrimaryPhysicalFamily, resolvePhysicalFamilies, resolveFace, DEFAULT_FONT_MEASURE_CONTEXT, } from './resolver.js';
 export { getFontConfigVersion, bumpFontConfigVersion, __resetFontConfigVersion } from './epoch.js';

package/dist/shared/font-system/src/resolver.d.ts

@@ -212,6 +212,17 @@ export interface FontMeasureContext {
     resolveNaturalLineMultiplier?: ResolveNaturalLineMultiplier;
     fontSignature: string;
 }
+/** Font face inputs whose measured digit advances can affect layout reuse. */
+export interface FontMeasureFace {
+    family: string;
+    sizePx: number;
+    weight: FaceKey['weight'];
+    style: FaceKey['style'];
+}
+/** Immutable, invocation-scoped facts established by the active measurement surface. */
+export interface FontMeasureCapabilities {
+    hasTabularDigits(face: FontMeasureFace): boolean;
+}
 /**
  * The global-resolver / empty-signature context. The behavior-preserving default for outer entry
  * points and non-document callers (tests, the global measure path). Frozen so a stray