superdoc 2.25.0-next.2 → 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.2",
+	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.2",
+	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/comments/comments.types.d.ts

@@ -216,6 +216,8 @@ export interface CommentsListQuery {
  */
 export interface CommentDomain {
     address: CommentAddress;
+    /** Canonical comment id alias returned by native runtimes. */
+    commentId?: string;
     /** See {@link CommentInfo.externalId}. */
     externalId?: string;
     /** See {@link CommentInfo.metadata}. */

package/dist/document-api/src/content-controls/content-controls.types.d.ts

@@ -1,7 +1,7 @@
 import { BlockNodeAddress, NodeKind } from '../types/base.js';
 import { SelectionTarget } from '../types/address.js';
 import { SDFragment } from '../types/fragment.js';
-import { ReceiptFailure, ReceiptInsert } from '../types/receipt.js';
+import { ReceiptFailure, ReceiptInsert, ReceiptSuccess } from '../types/receipt.js';
 import { StoryLocator } from '../types/story.types.js';
 /**
  * Semantic SDT subtype derived from `w:sdtPr` children.
@@ -154,11 +154,13 @@ export interface ContentControlInfo {
     /** Authoritative structural emptiness when the adapter can determine it. */
     isEmpty?: boolean;
 }
-export interface ContentControlMutationSuccess {
+export interface ContentControlMutationSuccess extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     contentControl: ContentControlTarget;
     updatedRef?: ContentControlTarget;
+    /** Identity of the block created by an adjacent-content insertion. */
+    createdBlockId?: string;
     affectedStories?: StoryLocator[];
     trackedChangeRefs?: ReceiptInsert[];
 }

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/hyperlinks/hyperlinks.types.d.ts

@@ -1,7 +1,7 @@
 import { BlockNodeAddress, InlineNodeAddress } from '../types/base.js';
 import { TextAddress } from '../types/address.js';
 import { DiscoveryOutput } from '../types/discovery.js';
-import { ReceiptFailure } from '../types/receipt.js';
+import { ReceiptFailure, ReceiptSuccess } from '../types/receipt.js';
 /** Narrowed inline address for hyperlink targets. */
 export type HyperlinkTarget = InlineNodeAddress & {
     nodeType: 'hyperlink';
@@ -74,10 +74,17 @@ export interface HyperlinkInfo {
     properties: HyperlinkReadProperties;
     text?: string;
 }
-export interface HyperlinkMutationSuccess {
+export interface HyperlinkMutationSuccess extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     hyperlink: HyperlinkTarget;
+    /** Legacy native identifier for the mutated hyperlink, null after removal. */
+    hyperlinkNodeId?: string | null;
+    /** Package parts created or modified by the mutation. */
+    partsCreated?: readonly string[];
+    partsModified?: readonly string[];
+    /** Relationship identity created for an external destination, when present. */
+    createdRId?: string;
 }
 export interface HyperlinkMutationFailure {
     success: false;

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

@@ -1,5 +1,5 @@
 import { BlockNodeAddress } from '../types/index.js';
-import { ReceiptInsert } from '../types/receipt.js';
+import { ReceiptInsert, ReceiptSuccess } from '../types/receipt.js';
 import { StoryLocator } from '../types/story.types.js';
 import { ContentControlTarget } from '../content-controls/content-controls.types.js';
 import { ImageProperties, ImageWrapType, ImageWrapSide, ImageMarginOffset, ImageSize, ImageCropInfo } from '../types/media.types.js';
@@ -186,7 +186,7 @@ export interface SetZOrderInput {
     imageId: string;
     zOrder: ImageZOrderInput;
 }
-export interface CreateImageSuccessResult {
+export interface CreateImageSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     image: ImageAddress;
@@ -206,7 +206,7 @@ export interface ImagesListResult {
     total: number;
     items: ImageSummary[];
 }
-export interface ImagesMutationSuccessResult {
+export interface ImagesMutationSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     image: ImageAddress;

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/lists/lists.types.d.ts

@@ -1,4 +1,4 @@
-import { AffectedRefRemapping, BlockNodeType, ReceiptFailure, ReceiptInsert, StoryLocator, TextAddress, TextRangeShift } from '../types/index.js';
+import { AffectedRefRemapping, BlockNodeType, ReceiptFailure, ReceiptInsert, ReceiptSuccess, StoryLocator, TextAddress, TextRangeShift } from '../types/index.js';
 import { DiscoveryOutput } from '../types/discovery.js';
 export type ListItemAddress = {
     kind: 'block';
@@ -356,14 +356,14 @@ export interface ListsCaptureTemplateSuccessResult {
     template: ListTemplate;
 }
 export type ListsCaptureTemplateResult = ListsCaptureTemplateSuccessResult | ListsFailureResult;
-export interface ListsInsertSuccessResult {
+export interface ListsInsertSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     item: ListItemAddress;
     insertionPoint: TextAddress;
     trackedChangeRefs?: ReceiptInsert[];
 }
-export interface ListsMutateItemSuccessResult {
+export interface ListsMutateItemSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     item: ListItemAddress;
@@ -375,38 +375,38 @@ export interface ListsMutateItemSuccessResult {
     txId?: string;
     changed?: boolean;
 }
-export interface ListsCreateSuccessResult {
+export interface ListsCreateSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     listId: string;
     item: ListItemAddress;
 }
-export interface ListsJoinSuccessResult {
+export interface ListsJoinSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     listId: string;
 }
-export interface ListsSeparateSuccessResult {
+export interface ListsSeparateSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     listId: string;
     numId: number;
 }
-export interface ListsMergeSuccessResult {
+export interface ListsMergeSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     listId: string;
     absorbedCount: number;
     removedEmptyBlocks: number;
 }
-export interface ListsSplitSuccessResult {
+export interface ListsSplitSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     listId: string;
     numId: number;
     restartedAt: number | null;
 }
-export interface ListsDetachSuccessResult {
+export interface ListsDetachSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     paragraph: {
@@ -415,7 +415,7 @@ export interface ListsDetachSuccessResult {
         nodeId: string;
     };
 }
-export interface ListsConvertToTextSuccessResult {
+export interface ListsConvertToTextSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     paragraph: {
@@ -447,7 +447,7 @@ export type ListsMergeResult = ListsMergeSuccessResult | ListsFailureResult;
 export type ListsSplitResult = ListsSplitSuccessResult | ListsFailureResult;
 export type ListsDetachResult = ListsDetachSuccessResult | ListsFailureResult;
 export type ListsConvertToTextResult = ListsConvertToTextSuccessResult | ListsFailureResult;
-export interface ListsDeleteSuccessResult {
+export interface ListsDeleteSuccessResult extends ReceiptSuccess {
     success: true;
     appliedChangeMode?: 'direct' | 'tracked';
     /** Number of list items removed. */

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/document-api/src/receipt-bridge.d.ts

@@ -8,6 +8,9 @@ export interface MutationReceiptBridgeContext {
 }
 interface CanonicalSuccessMetadata {
     appliedChangeMode?: ReceiptSuccess['appliedChangeMode'];
+    changed?: ReceiptSuccess['changed'];
+    trackedChangeRefs?: ReceiptSuccess['trackedChangeRefs'];
+    trackedChangeCount?: ReceiptSuccess['trackedChangeCount'];
     id?: ReceiptSuccess['id'];
     inserted?: ReceiptSuccess['inserted'];
     updated?: ReceiptSuccess['updated'];

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

@@ -144,7 +144,7 @@ export interface BlocksSplitInput {
     /** Include deleted tracked text in the offset ruler. Defaults to `visible`. */
     coordinateSpace?: 'visible' | 'tracked';
 }
-export interface BlocksSplitSuccessResult {
+export interface BlocksSplitSuccessResult extends Omit<ReceiptSuccess, 'inserted'> {
     success: true;
     appliedChangeMode?: ReceiptSuccess['appliedChangeMode'];
     /** Address of the new paragraph created by the split (the tail). */
@@ -173,7 +173,7 @@ export interface BlocksMergeInput {
     /** Paragraph immediately after `first` in the same story. */
     second: BlockNodeAddress;
 }
-export interface BlocksMergeSuccessResult {
+export interface BlocksMergeSuccessResult extends Omit<ReceiptSuccess, 'removed'> {
     success: true;
     appliedChangeMode?: ReceiptSuccess['appliedChangeMode'];
     /** Address of the paragraph that was removed (the second paragraph). */

package/dist/document-api/src/types/mutation-plan.types.d.ts

@@ -5,7 +5,7 @@ import { InsertStylePolicy, StylePolicy } from './style-policy.types.js';
 import { InlineRunPatch } from '../format/inline-run-patch.js';
 import { SDFragment } from './fragment.js';
 import { Placement, NestingPolicy } from './placement.js';
-import { AffectedRef } from './receipt.js';
+import { AffectedRef, ReceiptSuccess } from './receipt.js';
 import { ChangeMode } from '../write/write.js';
 import { StoryLocator } from './story.types.js';
 export type SelectWhere = {
@@ -241,7 +241,7 @@ export type StepOutcome = {
     trackedChangeIds?: string[];
     data: StepOutcomeData;
 };
-export type PlanReceipt = {
+export type PlanReceipt = ReceiptSuccess & {
     success: true;
     /** Effective mode when every committed step used the same mode. */
     appliedChangeMode?: ChangeMode;

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

@@ -110,6 +110,12 @@ export interface ReceiptEffects {
 }
 export type ReceiptSuccess = {
     success: true;
+    /** Whether a successful request changed the document; false represents a no-op commit. */
+    changed?: boolean;
+    /** Tracked changes authored by this mutation. */
+    trackedChangeRefs?: ReceiptInsert[];
+    /** Number of tracked changes authored by this mutation. */
+    trackedChangeCount?: number;
     /**
      * Mode in which this call's document content was committed. An edit folded
      * into the author's existing insertion is tracked; auxiliary style and
@@ -202,6 +208,12 @@ export type TextMutationResolution = {
 };
 export type TextMutationReceipt = (ReceiptSuccess & {
     resolution: TextMutationResolution;
+    /** Per-edit tracked-change results for atomic multi-edit mutations. */
+    trackedChangeOutcomes?: {
+        editIndex: number;
+        trackedChangeCount: number;
+        trackedChangeRefs: ReceiptInsert[];
+    }[];
 }) | (ReceiptFailureResult & {
     resolution: TextMutationResolution;
 });

package/dist/document-api/src/types/sd-contract.d.ts

@@ -32,6 +32,9 @@ export interface SDMutationReceipt {
         before: string;
         after: string;
     };
+    changed?: ReceiptSuccess['changed'];
+    trackedChangeRefs?: ReceiptSuccess['trackedChangeRefs'];
+    trackedChangeCount?: ReceiptSuccess['trackedChangeCount'];
     id?: ReceiptSuccess['id'];
     inserted?: ReceiptSuccess['inserted'];
     updated?: ReceiptSuccess['updated'];

package/dist/document-api/src/types/track-changes.types.d.ts

@@ -351,9 +351,17 @@ export interface TrackChangeStructuralDescriptor {
 export type TrackChangeTarget = {
     kind: 'text';
     address: TrackedChangeAddress;
+    /** Resolved text geometry when available. */
+    segments?: TextTarget['segments'];
+    /** Story containing the resolved geometry. */
+    story?: TextTarget['story'];
 } | {
     kind: 'replacement';
     address: TrackedChangeAddress;
+    /** Resolved text geometry when available. */
+    segments?: TextTarget['segments'];
+    /** Story containing the resolved geometry. */
+    story?: TextTarget['story'];
 } | {
     kind: 'formatting';
     address: TrackedChangeAddress;

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';