superdoc 2.25.0-next.3 → 2.25.0-next.4

package/dist/chunks/{create-super-doc-ui-D8ss5E0J.cjs → create-super-doc-ui-C-oN_R2a.cjs}

@@ -3970,6 +3970,7 @@ Object.keys(DRAWING_SUPPORT_TAXONOMY);
 Object.freeze([
 	"multiple-sections",
 	"furniture-page-tokens",
+	"body-page-number-tokens",
 	"non-balanceable-multi-column-sections",
 	"body-anchored-objects",
 	"non-flowing-page-relative-body-anchors",
@@ -7833,7 +7834,16 @@ function createSuperDocUI(options) {
 	* query surfaces only DIRECT run properties, so inherited fonts have no
 	* projected value; the layout has already resolved them for painting.
 	*/
+	const appliedSelectionPresentation = (selection) => {
+		const host = getHost(), read = host?.readAppliedSelectionPresentation;
+		if (typeof read !== "function") return null;
+		const value = safeCall(() => read.call(host), null);
+		const info = normalizeSelectionInfo(value?.selection);
+		return value && info && selectionSignature(selectionSliceFromInfo(info, "ready")) === selectionSignature(selection) ? value : null;
+	};
 	const resolveEffectiveInlineValuesFromLayout = (selection) => {
+		const applied = appliedSelectionPresentation(selection);
+		if (applied) return applied.inlineStyle ?? {};
 		const host = getHost();
 		const blockIds = new Set(selectionBlockIds(selection));
 		if (blockIds.size === 0) return {};
@@ -7951,6 +7961,8 @@ function createSuperDocUI(options) {
 	* `{ style: 'single' }`) when active, never a bare `true` — check presence.
 	*/
 	const resolveEffectiveMarkValuesFromLayout = (selection) => {
+		const applied = appliedSelectionPresentation(selection);
+		if (applied) return applied.inlineStyle ?? {};
 		const host = getHost();
 		const blockIds = new Set(selectionBlockIds(selection));
 		if (blockIds.size === 0) return {};
@@ -8786,6 +8798,11 @@ function createSuperDocUI(options) {
 	};
 	/** Read effective paragraph alignments from the mounted, style-resolved layout. */
 	const readEffectiveParagraphAlignments = (selection, blockIds) => {
+		const applied = appliedSelectionPresentation(selection);
+		if (applied) return new Map(blockIds.flatMap((id) => {
+			const alignment = normalizeParagraphAlignment(applied.paragraphAlignments?.[id]);
+			return alignment ? [[id, alignment]] : [];
+		}));
 		const host = getHost();
 		const readByIds = host?.readMountedProjectionBlocksByIds;
 		if (typeof readByIds !== "function") return null;
@@ -11284,6 +11301,8 @@ function createSuperDocUI(options) {
 		return Boolean(readLinkPayloadTarget(payload) || isLooseObject(record.hyperlinkTarget) || isLooseObject(record.textTarget));
 	};
 	const commandSelectionIsReady = (id, descriptor, payload) => {
+		const foreground = foregroundMutationState();
+		if (foreground && (foreground.active > 0 || foreground.pending > 0)) return false;
 		if (state.selection.status !== "ready") return false;
 		if (trackDecisionCommand(id)?.scope === "id") return true;
 		if (!descriptor || descriptor.disposition !== "routed") return true;

package/dist/chunks/{create-super-doc-ui-3habU4hL.es.js → create-super-doc-ui-D5waZHl3.es.js}

@@ -3969,6 +3969,7 @@ Object.keys(DRAWING_SUPPORT_TAXONOMY);
 Object.freeze([
 	"multiple-sections",
 	"furniture-page-tokens",
+	"body-page-number-tokens",
 	"non-balanceable-multi-column-sections",
 	"body-anchored-objects",
 	"non-flowing-page-relative-body-anchors",
@@ -7832,7 +7833,16 @@ function createSuperDocUI(options) {
 	* query surfaces only DIRECT run properties, so inherited fonts have no
 	* projected value; the layout has already resolved them for painting.
 	*/
+	const appliedSelectionPresentation = (selection) => {
+		const host = getHost(), read = host?.readAppliedSelectionPresentation;
+		if (typeof read !== "function") return null;
+		const value = safeCall(() => read.call(host), null);
+		const info = normalizeSelectionInfo(value?.selection);
+		return value && info && selectionSignature(selectionSliceFromInfo(info, "ready")) === selectionSignature(selection) ? value : null;
+	};
 	const resolveEffectiveInlineValuesFromLayout = (selection) => {
+		const applied = appliedSelectionPresentation(selection);
+		if (applied) return applied.inlineStyle ?? {};
 		const host = getHost();
 		const blockIds = new Set(selectionBlockIds(selection));
 		if (blockIds.size === 0) return {};
@@ -7950,6 +7960,8 @@ function createSuperDocUI(options) {
 	* `{ style: 'single' }`) when active, never a bare `true` — check presence.
 	*/
 	const resolveEffectiveMarkValuesFromLayout = (selection) => {
+		const applied = appliedSelectionPresentation(selection);
+		if (applied) return applied.inlineStyle ?? {};
 		const host = getHost();
 		const blockIds = new Set(selectionBlockIds(selection));
 		if (blockIds.size === 0) return {};
@@ -8785,6 +8797,11 @@ function createSuperDocUI(options) {
 	};
 	/** Read effective paragraph alignments from the mounted, style-resolved layout. */
 	const readEffectiveParagraphAlignments = (selection, blockIds) => {
+		const applied = appliedSelectionPresentation(selection);
+		if (applied) return new Map(blockIds.flatMap((id) => {
+			const alignment = normalizeParagraphAlignment(applied.paragraphAlignments?.[id]);
+			return alignment ? [[id, alignment]] : [];
+		}));
 		const host = getHost();
 		const readByIds = host?.readMountedProjectionBlocksByIds;
 		if (typeof readByIds !== "function") return null;
@@ -11283,6 +11300,8 @@ function createSuperDocUI(options) {
 		return Boolean(readLinkPayloadTarget(payload) || isLooseObject(record.hyperlinkTarget) || isLooseObject(record.textTarget));
 	};
 	const commandSelectionIsReady = (id, descriptor, payload) => {
+		const foreground = foregroundMutationState();
+		if (foreground && (foreground.active > 0 || foreground.pending > 0)) return false;
 		if (state.selection.status !== "ready") return false;
 		if (trackDecisionCommand(id)?.scope === "id") return true;
 		if (!descriptor || descriptor.disposition !== "routed") return true;

package/dist/collaboration-upgrade-engine.cjs

@@ -19,7 +19,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = (0, _superdoc_docx_engine_collaboration_upgrade_engine.getCollaborationUpgradeEngineInfo)();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.25.0-next.3",
+	superdocVersion: "2.25.0-next.4",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/collaboration-upgrade-engine.es.js

@@ -18,7 +18,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.25.0-next.3",
+	superdocVersion: "2.25.0-next.4",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/contract/operation-definitions.d.ts

@@ -3369,7 +3369,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'protection.setEditingRestriction': {
         readonly memberPath: "protection.setEditingRestriction";
-        readonly description: "Enable Word-style editing restriction on the document. Only readOnly mode is supported in v1.";
+        readonly description: "Author a Word readOnly, comments, trackedChanges, or forms restriction. Inspect runtimeEnforced in the returned state: V2 currently enforces readOnly; the other modes are saved for Word and are not enforced in SuperDoc.";
         readonly expectedResult: "Returns a ProtectionMutationResult with the updated protection state on success.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;

package/dist/document-api/src/index.d.ts

@@ -132,6 +132,7 @@ export type { AnchoredMetadataApi, AnchoredMetadataAdapter } from './metadata/an
 export type { ProtectionApi, ProtectionAdapter } from './protection/protection.js';
 export * from './protection/protection.types.js';
 export type { PermissionRangesApi, PermissionRangesAdapter } from './permission-ranges/permission-ranges.js';
+export { listPermissionRangeEditors, resolvePermissionRangeEditor } from './permission-ranges/permission-ranges.js';
 export type * from './permission-ranges/permission-ranges.types.js';
 export type { FootnotesApi, FootnotesAdapter } from './footnotes/footnotes.js';
 export type { ClipboardApi, ClipboardAdapter } from './clipboard/clipboard.js';

package/dist/document-api/src/permission-ranges/permission-ranges.d.ts

@@ -1,5 +1,13 @@
 import { MutationOptions } from '../write/write.js';
-import { PermissionRangesListInput, PermissionRangesListResult, PermissionRangesGetInput, PermissionRangeInfo, PermissionRangesCreateInput, PermissionRangesRemoveInput, PermissionRangesUpdatePrincipalInput, PermissionRangeMutationResult, PermissionRangeRemoveResult } from './permission-ranges.types.js';
+import { PermissionRangesListInput, PermissionRangesListResult, PermissionRangesGetInput, PermissionRangeInfo, PermissionRangesCreateInput, PermissionRangesRemoveInput, PermissionRangesUpdatePrincipalInput, PermissionRangeMutationResult, PermissionRangeRemoveResult, PermissionRangeEditor, PermissionRangeEditorResolution } from './permission-ranges.types.js';
+/**
+ * Resolve a host ID or imported Word email against an explicitly supplied roster.
+ * Word receives the email when available; opaque IDs remain host-specific.
+ * Duplicate IDs/emails are ambiguous. This does not authenticate a user.
+ */
+export declare function resolvePermissionRangeEditor(editors: readonly PermissionRangeEditor[], id: string): PermissionRangeEditorResolution;
+/** Enumerate the host roster for an editor picker, including ambiguous entries. */
+export declare function listPermissionRangeEditors(editors: readonly PermissionRangeEditor[]): PermissionRangeEditorResolution[];
 export interface PermissionRangesApi {
     list(input?: PermissionRangesListInput): PermissionRangesListResult;
     get(input: PermissionRangesGetInput): PermissionRangeInfo;

package/dist/document-api/src/permission-ranges/permission-ranges.types.d.ts

@@ -9,6 +9,23 @@ export type PermissionRangePrincipal = {
     kind: 'editor';
     id: string;
 };
+/** Trusted host roster entry. Names are display labels, never permission identities. */
+export interface PermissionRangeEditor {
+    id?: string | null;
+    email?: string | null;
+    name?: string | null;
+}
+export type PermissionRangeEditorResolution = {
+    status: 'resolved';
+    id: string;
+    editor: PermissionRangeEditor;
+    principal: Extract<PermissionRangePrincipal, {
+        kind: 'editor';
+    }>;
+} | {
+    status: 'unknown' | 'ambiguous';
+    id: string;
+};
 export type PermissionRangeKind = 'inline' | 'block';
 export interface PermissionRangeInfo {
     id: string;

package/dist/document-api/src/protection/protection.types.d.ts

@@ -33,8 +33,8 @@ export declare const DEFAULT_PROTECTION_STATE: DocumentProtectionState;
 export type ProtectionGetInput = Record<string, never> | undefined;
 /** Input for `protection.setEditingRestriction`. */
 export interface SetEditingRestrictionInput {
-    /** Only `'readOnly'` is accepted in v1. */
-    mode: 'readOnly';
+    /** Word restriction to author. Inspect `runtimeEnforced` before relying on engine enforcement. */
+    mode: Exclude<EditingRestrictionMode, 'none'>;
     /** Whether to restrict formatting changes. Defaults to false. */
     formattingRestricted?: boolean;
 }

package/dist/layout-engine/contracts/src/incremental-dependency.d.ts

@@ -5,8 +5,8 @@
  * every retained dependency that required the checkpoint; consumers reject
  * empty, duplicate, or unknown lists instead of trusting a generic boolean.
  */
-export type PageCheckpointDependencyClass = 'multiple-sections' | 'furniture-page-tokens' | 'non-balanceable-multi-column-sections' | 'body-anchored-objects' | 'non-flowing-page-relative-body-anchors' | 'footnotes' | 'page-references' | 'cross-references' | 'keep-constraints' | 'tables' | 'furniture-anchored-objects';
-export declare const PAGE_CHECKPOINT_DEPENDENCY_CLASSES: readonly ["multiple-sections", "furniture-page-tokens", "non-balanceable-multi-column-sections", "body-anchored-objects", "non-flowing-page-relative-body-anchors", "footnotes", "page-references", "cross-references", "keep-constraints", "tables", "furniture-anchored-objects"];
+export type PageCheckpointDependencyClass = 'multiple-sections' | 'furniture-page-tokens' | 'body-page-number-tokens' | 'non-balanceable-multi-column-sections' | 'body-anchored-objects' | 'non-flowing-page-relative-body-anchors' | 'footnotes' | 'page-references' | 'cross-references' | 'keep-constraints' | 'tables' | 'furniture-anchored-objects';
+export declare const PAGE_CHECKPOINT_DEPENDENCY_CLASSES: readonly ["multiple-sections", "furniture-page-tokens", "body-page-number-tokens", "non-balanceable-multi-column-sections", "body-anchored-objects", "non-flowing-page-relative-body-anchors", "footnotes", "page-references", "cross-references", "keep-constraints", "tables", "furniture-anchored-objects"];
 /**
  * Exact retained-generation proof for page/margin-relative body anchors that
  * cannot influence paragraph flow (`wrap=None`). The host builds this once

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

@@ -2899,6 +2899,8 @@ export type LayoutBlockResumeCheckpoint = {
         columns: ColumnLayout;
     }[];
     activeConstraintIndex: number;
+    /** Exact active configuration, including single-column state omitted from Page.columns. */
+    activeColumns?: ColumnLayout;
     footnoteDemandThisPage: number;
     footnoteRefsThisPage: number;
     footnoteAnchorsThisPage: readonly {
@@ -2935,6 +2937,8 @@ export type Layout = {
     layoutEpoch?: number;
     /** Exact paragraph-boundary resume sidecar; never inferred from painted geometry. */
     blockResumeCheckpoints?: ReadonlyMap<BlockId, LayoutBlockResumeCheckpoint>;
+    /** Engine-authored column state at physical page creation, including count=1 configurations. */
+    pageStartColumns?: ReadonlyMap<number, ColumnLayout>;
 };
 export type WrapTextMode = 'bothSides' | 'left' | 'right' | 'largest';
 export type WrapExclusion = {

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

@@ -44,36 +44,15 @@ export interface FontMetricsCacheConfig {
  */
 export declare class FontMetricsCache {
     private cache;
-    private canvas;
     private ctx;
+    private fontGeneration;
     /**
      * Creates a new FontMetricsCache instance.
      * Initializes the canvas context for measurements.
      */
     constructor();
-    /**
-     * Initializes the canvas and context for font measurements.
-     *
-     * Creates an offscreen 1x1 canvas with 2D rendering context optimized for
-     * text measurement. The canvas is never attached to the DOM and is purely
-     * used for the canvas.measureText() API.
-     *
-     * Performance considerations:
-     * - Canvas is created once and reused for all measurements
-     * - Size is minimal (1x1) as we only need measureText(), not rendering
-     * - willReadFrequently hint optimizes for frequent measureText() calls
-     *
-     * Failure modes:
-     * - Not in browser environment (SSR): Sets ctx to null, cache will be disabled
-     * - Canvas creation fails: Catches error, sets ctx to null, measurements fall back to defaults
-     *
-     * Side effects:
-     * - Creates this.canvas and this.ctx properties
-     * - On failure, cache becomes read-only (getMetrics returns undefined for unmeasured fonts)
-     *
-     * @private
-     */
     private initializeCanvas;
+    private ensureFontGeneration;
     /**
      * Pre-warms the cache by measuring all characters for the specified fonts.
      *

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

@@ -378,13 +378,14 @@ export type IncrementalPaginationProof = IncrementalPaginationProofBase & ({
      * mid-section checkpoint cannot seed. False is admissible only
      * together with `balanceableSectionsBoundaryBlockId`, the last
      * page-bearing block at or before the final balanceable section end.
-     * The bridge requires a document-start replay, includes that section
-     * finalizer, and refuses convergence until a stable page strictly
-     * after the retained boundary. Anything else takes the canonical full
-     * layout.
+     * The bridge replays from document start unless the separately proved
+     * unchanged balanced prefix precedes a complete single-column seed
+     * strictly after the boundary. Convergence remains fenced after it.
      */
     multiColumnSectionsProvedNonBalanceable: boolean;
     balanceableSectionsBoundaryBlockId?: string;
+    /** The unchanged balanced sections precede every dirty owner; the bridge re-verifies the seeded checkpoint. */
+    balanceableSectionsRetainedPrefix?: true;
     /** Last vertically aligned section page; validated before reuse. */
     vAlignSectionsBoundaryBlockId?: string;
     /** Replay page zero through the aligned boundary before convergence. */
@@ -617,6 +618,12 @@ export declare function __test_only_splicedCheckpointStats(map: ReadonlyMap<stri
     sourceCount: number;
     maximumTransformTreeDepth: number;
 } | null;
+export type LayoutPageGeometry = Pick<Page, 'size' | 'margins' | 'sectionIndex'>;
+/** Internal live identity readback; every fragment remains visible to ownership validation. */
+export declare function readLayoutPageFragmentBlockIds(pages: Page[], pageIndex: number): IterableIterator<string>;
+/** Read canonical page boxes without materializing retained PM or fragment transforms. */
+export declare function readLayoutPageGeometry(pages: Page[], pageIndex: number): LayoutPageGeometry;
+export declare function __test_only_pageSequenceMaterializationCount(pages: Page[]): number;
 export declare function __test_only_lazyPageTransformStats(pages: Page[]): {
     segmentCount: number;
     maximumLedgerCount: number;

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

@@ -12,9 +12,9 @@ export { findWordBoundaries, findParagraphBoundaries } from './text-boundaries.j
 export type { BoundaryRange } from './text-boundaries.js';
 export { buildSectionAwareHeaderFooterLayoutKey, buildSectionContentWidth, buildEffectiveHeaderFooterRefsBySection, collectReferencedHeaderFooterRIds, buildSectionAwareHeaderFooterMeasurementGroups, } from './sectionAwareHeaderFooter.js';
 export type { HeaderFooterSectionKind, HeaderFooterRefs, SectionAwareHeaderFooterMeasurementGroup, } from './sectionAwareHeaderFooter.js';
-export { clearIncrementalModuleState, incrementalLayout, measureCache, normalizeMargin } from './incrementalLayout.js';
+export { clearIncrementalModuleState, incrementalLayout, measureCache, normalizeMargin, readLayoutPageGeometry, readLayoutPageFragmentBlockIds, } from './incrementalLayout.js';
 export { hashMeasureContent } from './cache.js';
-export type { HeaderFooterLayoutResult, HeaderFooterGeometrySeed, IncrementalLayoutBridgeTiming, IncrementalLayoutResult, IncrementalLayoutExecutionControl, IncrementalLayoutContinuation, IncrementalMeasureReuseProof, IncrementalLayoutReuseOptions, IncrementalLayoutReuseSummary, IncrementalSectionPageNumberTransform, IncrementalLayoutTailAdoption, IncrementalLayoutTailDisposition, IncrementalPaginationProof, LayoutPositionTransform, FootnoteReserveSeed, } from './incrementalLayout.js';
+export type { HeaderFooterLayoutResult, HeaderFooterGeometrySeed, IncrementalLayoutBridgeTiming, IncrementalLayoutResult, IncrementalLayoutExecutionControl, IncrementalLayoutContinuation, IncrementalMeasureReuseProof, IncrementalLayoutReuseOptions, IncrementalLayoutReuseSummary, IncrementalSectionPageNumberTransform, IncrementalLayoutTailAdoption, IncrementalLayoutTailDisposition, IncrementalPaginationProof, LayoutPositionTransform, LayoutPageGeometry, FootnoteReserveSeed, } from './incrementalLayout.js';
 export { collectFootnoteLedgers, getPreferredReserveCandidates, getPreferredReserveTrialTargets, isMandatoryOnlyFootnotePage, scoreFootnoteWindow, summarizeFootnoteWindow, } from './footnote-scorer.js';
 export type { FootnotePreferredReserveCandidate, FootnoteWindowScoreInput, FootnoteWindowScoreReason, FootnoteWindowScoreResult, FootnoteWindowStats, } from './footnote-scorer.js';
 export { computeDisplayPageNumber } from '../../layout-engine/src/index.js';

package/dist/layout-engine/layout-bridge/src/measurement-environment.d.ts

@@ -0,0 +1,12 @@
+/** Native Canvas2D allocation shared by the secondary layout measurers. */
+export type LayoutMeasurementContext = CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D;
+type UnavailablePolicy = 'require-native' | 'headless-approximation';
+export declare function getLayoutMeasurementFontGeneration(): number;
+/** Invalidates secondary caches when a face changes behind an unchanged CSS font string. */
+export declare function invalidateLayoutMeasurementFonts(): void;
+export declare function createLayoutMeasurementContext(options?: {
+    context?: LayoutMeasurementContext;
+    ownerDocument?: Document;
+    unavailable?: UnavailablePolicy;
+}): LayoutMeasurementContext | null;
+export {};

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

@@ -18,6 +18,6 @@ export declare function cloneLiveCrossReferenceFieldBlocks<T extends FlowBlock>(
  * graph. This happens before measurement, so changed result text participates
  * in line wrapping and pagination without creating a second document mutation.
  */
-export declare function resolveLiveCrossReferences(bodyBlocks: FlowBlock[]): void;
+export declare function resolveLiveCrossReferences(bodyBlocks: FlowBlock[]): boolean;
 /** Build the page-aware STYLEREF resolver used by repeated headers/footers. */
 export declare function buildPageStyleReferenceResolver(bodyBlocks: readonly FlowBlock[], layout: Layout): PageStyleReferenceResolver;

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

@@ -133,3 +133,7 @@ export type DomPainterHandle = {
  * `mode-ownership.test.ts` battery pins the surface deleted.
  */
 export declare const createDomPainter: (options: DomPainterOptions) => DomPainterHandle;
+export { resolveRunTypographyStyles, resolveRunDecorationStyles } from './runs/text-style-facts.js';
+export { resolveTrackedChangeDecorationFacts, getTrackedChangeLayers, resolveTrackedChangesConfig, } from './runs/tracked-changes.js';
+export { buildLinkRenderData } from './runs/links.js';
+export { INLINE_TRACKED_CHANGE_DEFAULTS } from './styles.js';

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

@@ -2,6 +2,8 @@ import { Run, TextRun } from '../../../../contracts/src/index.js';
 import { FragmentRenderContext } from '../renderer.js';
 import { BROWSER_DEFAULT_FONT_SIZE } from '../styles.js';
 import { RunRenderContext, TrackedChangesRenderConfig } from './types.js';
+import { ResolvePhysicalFont } from './text-style-facts.js';
+export { underlineThicknessPx } from './text-style-facts.js';
 export type CheckboxGlyphs = {
     checked: string;
     unchecked: string;
@@ -10,23 +12,6 @@ export type CheckboxGlyphs = {
 export declare const checkboxGlyphs: (run: TextRun) => CheckboxGlyphs | null;
 /** Stamps the authored states needed to reflect an accepted checkbox toggle. */
 export declare const applyCheckboxGlyphMetadata: (element: HTMLElement, run: TextRun) => CheckboxGlyphs | null;
-/**
- * Underline thickness in px, scaled to font size. Shared by text runs
- * (`text-decoration-thickness`) and tab underlines (border width) so a run's
- * underline renders as a single uniform weight across text and tab characters,
- * matching Word, on any display density (SD-3330). The divisor approximates the
- * font's natural underline weight (≈ what `text-decoration-thickness: auto`
- * produces) while staying deterministic across platforms.
- *
- * Rounded to an integer px because CSS borders snap to integer device pixels
- * while `text-decoration-thickness` keeps fractional values; using an integer
- * makes the tab border and the text underline rasterize to the same line weight.
- */
-export declare const underlineThicknessPx: (fontSize: number) => number;
-type ResolvePhysicalFont = (cssFontFamily: string, face: {
-    weight: '400' | '700';
-    style: 'normal' | 'italic';
-}) => string;
 export declare const applyRunTypographyStyles: (element: HTMLElement, run: TextRun, resolvePhysical?: ResolvePhysicalFont) => void;
 /**
  * Applies run styling properties to a DOM element.

package/dist/layout-engine/painters/dom/src/runs/text-style-facts.d.ts

@@ -0,0 +1,9 @@
+import { TextRun } from '../../../../contracts/src/index.js';
+export type ResolvePhysicalFont = (family: string, face: {
+    weight: '400' | '700';
+    style: 'normal' | 'italic';
+}) => string;
+/** The same paint-ready typography is consumed by the DOM painter and worker sinks. */
+export declare function resolveRunTypographyStyles(run: TextRun, resolvePhysical?: ResolvePhysicalFont): Record<string, string>;
+export declare const underlineThicknessPx: (fontSize: number) => number;
+export declare function resolveRunDecorationStyles(run: TextRun): Record<string, string>;

package/dist/layout-engine/painters/dom/src/runs/tracked-changes.d.ts

@@ -21,17 +21,9 @@ export declare const resolveTrackedChangeVisualColor: (layer: TrackedChangeMeta)
  * `colorWithAlpha` can safely extend (named/non-hex visual colors still set
  * border/text but never fabricate a derived background).
  */
+export declare const resolveTrackedChangeColorVariables: (layer: TrackedChangeMeta) => Record<string, string>;
 export declare const applyTrackedChangeColorVariables: (elem: HTMLElement, layer: TrackedChangeMeta) => void;
 export declare const TRACK_CHANGE_MODIFIER_CLASS: Record<TrackedChangeKind, Record<TrackedChangesMode, string | undefined>>;
-/**
- * Stamps the semantic class + datasets for a tracked-change layer. Shared by
- * inline, row-level, and cell-level paint paths so the dataset/class vocabulary
- * stays identical. Only fields that are present are stamped; this never reads
- * or writes the author `color` dataset. The semantic datasets are namespaced
- * (`data-track-change-semantic-*`, `-type`, `-subtype`, `-target-kind`,
- * `-semantic-anchor-scope`) so they never collide with the existing author/
- * structural datasets even when row + cell metadata coexist.
- */
 export declare const applySemanticTrackedChangeMetadata: (elem: HTMLElement, meta: TrackedChangeMeta) => void;
 type TrackedChangeCarrier = Partial<Pick<TextRun, 'trackedChange' | 'trackedChanges'>>;
 type TrackedChangeDecoratable = Run | TrackedChangeCarrier;
@@ -86,5 +78,10 @@ export declare const applyRowTrackedChangeToCell: (elem: HTMLElement, meta: Trac
  * @param config - Tracked-changes mode/enabled (same source inline runs use).
  */
 export declare const applyCellTrackedChangeToCell: (elem: HTMLElement, meta: TrackedChangeMeta, config: TrackedChangesRenderConfig) => void;
+export declare const resolveTrackedChangeDecorationFacts: (run: TrackedChangeDecoratable, config: TrackedChangesRenderConfig) => {
+    classes: string[];
+    style: Record<string, string>;
+    attributes: Record<string, string>;
+};
 export declare const applyTrackedChangeDecorations: (elem: HTMLElement, run: TrackedChangeDecoratable, config: TrackedChangesRenderConfig) => void;
 export {};

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

@@ -31,6 +31,27 @@ export declare const fragmentStyles: Partial<CSSStyleDeclaration>;
  * element itself gets z-index for layering within the line (e.g. above tab leaders).
  */
 export declare const lineStyles: (lineHeight: number) => Partial<CSSStyleDeclaration>;
+/** Default inline tracking paint values shared with non-DOM drawing consumers. */
+export declare const INLINE_TRACKED_CHANGE_DEFAULTS: {
+    readonly insert: {
+        readonly border: "#1f6feb";
+        readonly background: "#1f6feb22";
+        readonly borderWidth: 1;
+        readonly strikeWidth: 0;
+    };
+    readonly delete: {
+        readonly border: "#cb0e47";
+        readonly background: "#cb0e4722";
+        readonly borderWidth: 1;
+        readonly strikeWidth: 2;
+    };
+    readonly format: {
+        readonly border: "gold";
+        readonly background: "transparent";
+        readonly borderWidth: 2;
+        readonly strikeWidth: 0;
+    };
+};
 /** One document-scoped stylesheet the paint surface requires: head marker attribute + CSS payload. */
 export type SurfaceStylePreflightEntry = {
     markerAttribute: string;

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-D8ss5E0J.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-C-oN_R2a.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let react = require("react");
 //#region src/public/ui/react.ts

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

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-3habU4hL.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-D5waZHl3.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

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-D8ss5E0J.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-C-oN_R2a.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let superdoc_entry_vue = require("vue");
 //#region src/public/ui/vue.ts

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

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-3habU4hL.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-D5waZHl3.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

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-D8ss5E0J.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-C-oN_R2a.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 { a as BUILT_IN_COMMAND_IDS, t as createSuperDocUI, u as shallowEqual } from "../chunks/create-super-doc-ui-3habU4hL.es.js";
+import { a as BUILT_IN_COMMAND_IDS, t as createSuperDocUI, u as shallowEqual } from "../chunks/create-super-doc-ui-D5waZHl3.es.js";
 export { BUILT_IN_COMMAND_IDS, createSuperDocUI, shallowEqual };

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

@@ -75,7 +75,9 @@ export declare class FontRegistry {
      * constructor: the family is recorded as `unloaded` and will resolve to
      * `fallback_used` when awaited.
      */
-    register(descriptor: FontFaceDescriptor): RegisterFaceResult;
+    register(descriptor: FontFaceDescriptor, options?: {
+        preserveDescriptors?: boolean;
+    }): RegisterFaceResult;
     /** True if this registry created a managed face for the family. */
     isManaged(family: string): boolean;
     /**
@@ -126,6 +128,8 @@ export declare class FontRegistry {
      * Distinct from {@link isAvailable}, which asks whether a face is LOADED right now.
      */
     hasFace(family: string, weight: '400' | '700', style: 'normal' | 'italic'): boolean;
+    /** Face facts captured without retaining this registry or consulting later load state. */
+    snapshotFaces(): Pick<FontRegistry, 'hasFace' | 'getFaceStatus'>;
     /**
      * Synchronous availability check: is a real face for this family loaded and
      * usable in the set *right now*? Used by the gate's late-load handler to detect

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

@@ -124,6 +124,8 @@ export declare class FontResolver {
      * fonts must not leak into the next). Bumps {@link version} only if something was actually cleared.
      */
     reset(): void;
+    /** Immutable resolution owner for geometry retained with an already displayed scene. */
+    snapshot(): Pick<FontResolver, 'resolvePhysicalFamilyForFace' | 'signature'>;
     /** Monotonic version; bumps on every mapping change. A lightweight "did it change" signal. */
     get version(): number;
     /**