superdoc 2.25.0-next.1 → 2.25.0-next.11

package/dist/document-api/src/contract/command-catalog.d.ts

@@ -1,7 +1,7 @@
 import { CommandCatalog, CommandStaticMetadata, OperationId } from './types.js';
 export declare const COMMAND_CATALOG: CommandCatalog;
 /** Operation IDs whose catalog entry has `mutates: true`. */
-export declare const MUTATING_OPERATION_IDS: ("replace" | "find" | "delete" | "selection.extractOoxml" | "selection.current" | "selection.releaseSnapshot" | "insert" | "info" | "projectHtml" | "projectMarkdown" | "capabilities.check" | "format.apply" | "styles.getCatalog" | "blocks.split" | "blocks.merge" | "blocks.move" | "lists.getState" | "lists.apply" | "lists.continue" | "lists.restart" | "lists.remove" | "format.paragraph.setMarkRunProps" | "tables.moveRow" | "tables.moveColumn" | "format.bold" | "format.strike" | "format.color" | "format.position" | "format.rtl" | "format.cs" | "format.shading" | "format.fontFamily" | "format.lang" | "format.fontSize" | "format.fontSizeCs" | "format.highlight" | "format.italic" | "format.underline" | "format.caps" | "format.smallCaps" | "format.outline" | "format.shadow" | "format.emboss" | "format.imprint" | "format.vanish" | "format.webHidden" | "format.specVanish" | "format.border" | "format.dstrike" | "format.vertAlign" | "format.bCs" | "format.iCs" | "format.snapToGrid" | "format.oMath" | "format.letterSpacing" | "format.charScale" | "format.kerning" | "format.fitText" | "format.rStyle" | "format.rFonts" | "format.eastAsianLayout" | "format.em" | "format.ligatures" | "format.numForm" | "format.numSpacing" | "format.stylisticSets" | "format.contextualAlternates" | "get" | "getNode" | "getNodeById" | "getText" | "getMarkdown" | "getHtml" | "markdownToFragment" | "htmlToFragment" | "extract" | "clearContent" | "formatRange" | "blocks.findText" | "blocks.list" | "blocks.delete" | "blocks.deleteRange" | "styles.apply" | "styles.create" | "styles.getTheme" | "templates.apply" | "create.paragraph" | "create.heading" | "create.sectionBreak" | "sections.list" | "sections.get" | "sections.setBreakType" | "sections.setPageMargins" | "sections.setHeaderFooterMargins" | "sections.setPageSetup" | "sections.setColumns" | "sections.setLineNumbering" | "sections.setPageNumbering" | "sections.setTitlePage" | "sections.setOddEvenHeadersFooters" | "sections.setVerticalAlign" | "sections.setSectionDirection" | "sections.setHeaderFooterRef" | "sections.clearHeaderFooterRef" | "sections.setLinkToPrevious" | "sections.setPageBorders" | "sections.clearPageBorders" | "styles.paragraph.setStyle" | "styles.paragraph.setStyleRef" | "styles.paragraph.clearStyle" | "format.paragraph.resetDirectFormatting" | "format.paragraph.setAlignment" | "format.paragraph.clearAlignment" | "format.paragraph.setIndentation" | "format.paragraph.clearIndentation" | "format.paragraph.setSpacing" | "format.paragraph.clearSpacing" | "format.paragraph.setKeepOptions" | "format.paragraph.setOutlineLevel" | "format.paragraph.setFlowOptions" | "format.paragraph.setTabStop" | "format.paragraph.clearTabStop" | "format.paragraph.clearAllTabStops" | "format.paragraph.setBorder" | "format.paragraph.clearBorder" | "format.paragraph.setShading" | "format.paragraph.clearShading" | "format.paragraph.setDirection" | "format.paragraph.clearDirection" | "format.paragraph.setNumbering" | "lists.list" | "lists.get" | "lists.insert" | "lists.create" | "lists.attach" | "lists.detach" | "lists.delete" | "lists.indent" | "lists.outdent" | "lists.join" | "lists.canJoin" | "lists.separate" | "lists.merge" | "lists.split" | "lists.setLevel" | "lists.setValue" | "lists.continuePrevious" | "lists.canContinuePrevious" | "lists.setLevelRestart" | "lists.convertToText" | "lists.applyTemplate" | "lists.applyPreset" | "lists.setType" | "lists.captureTemplate" | "lists.setLevelNumbering" | "lists.setLevelBullet" | "lists.setLevelPictureBullet" | "lists.setLevelAlignment" | "lists.setLevelIndents" | "lists.setLevelTrailingCharacter" | "lists.setLevelMarkerFont" | "lists.clearLevelOverrides" | "lists.getStyle" | "lists.applyStyle" | "lists.restartAt" | "lists.setLevelNumberStyle" | "lists.setLevelText" | "lists.setLevelStart" | "lists.setLevelLayout" | "comments.create" | "comments.patch" | "comments.delete" | "comments.get" | "comments.list" | "trackChanges.list" | "trackChanges.get" | "trackChanges.decide" | "query.match" | "ranges.resolve" | "mutations.preview" | "mutations.apply" | "plan.execute" | "capabilities.get" | "capabilities.resolve" | "create.table" | "tables.convertFromText" | "tables.delete" | "tables.clearContents" | "tables.move" | "tables.split" | "tables.convertToText" | "tables.setLayout" | "tables.insertRow" | "tables.deleteRow" | "tables.setRowHeight" | "tables.distributeRows" | "tables.setRowOptions" | "tables.insertColumn" | "tables.deleteColumn" | "tables.setColumnWidth" | "tables.distributeColumns" | "tables.insertCell" | "tables.deleteCell" | "tables.mergeCells" | "tables.unmergeCells" | "tables.splitCell" | "tables.setCellProperties" | "tables.setCellText" | "tables.sort" | "tables.setAltText" | "tables.setStyle" | "tables.clearStyle" | "tables.setStyleOption" | "tables.setBorder" | "tables.clearBorder" | "tables.applyBorderPreset" | "tables.setShading" | "tables.clearShading" | "tables.setTablePadding" | "tables.setCellPadding" | "tables.setCellSpacing" | "tables.clearCellSpacing" | "tables.applyStyle" | "tables.setBorders" | "tables.setTableOptions" | "tables.applyPreset" | "tables.get" | "tables.getCells" | "tables.getProperties" | "tables.getStyles" | "tables.setDefaultStyle" | "tables.clearDefaultStyle" | "create.tableOfContents" | "toc.list" | "toc.get" | "toc.configure" | "toc.update" | "toc.remove" | "toc.markEntry" | "toc.unmarkEntry" | "toc.listEntries" | "toc.getEntry" | "toc.editEntry" | "history.get" | "history.undo" | "history.redo" | "create.image" | "images.list" | "images.get" | "images.delete" | "images.move" | "images.convertToInline" | "images.convertToFloating" | "images.setSize" | "images.setWrapType" | "images.setWrapSide" | "images.setWrapDistances" | "images.setPosition" | "images.setAnchorOptions" | "images.setZOrder" | "images.scale" | "images.setLockAspectRatio" | "images.rotate" | "images.flip" | "images.crop" | "images.resetCrop" | "images.replaceSource" | "images.setAltText" | "images.setDecorative" | "images.setName" | "images.setHyperlink" | "images.insertCaption" | "images.updateCaption" | "images.removeCaption" | "hyperlinks.list" | "hyperlinks.get" | "hyperlinks.wrap" | "hyperlinks.insert" | "hyperlinks.patch" | "hyperlinks.remove" | "headerFooters.list" | "headerFooters.get" | "headerFooters.resolve" | "headerFooters.refs.set" | "headerFooters.refs.clear" | "headerFooters.refs.setLinkedToPrevious" | "headerFooters.parts.list" | "headerFooters.parts.create" | "headerFooters.parts.delete" | "headerFooters.pageNumbers.get" | "headerFooters.pageNumbers.insert" | "headerFooters.pageNumbers.set" | "headerFooters.pageNumbers.remove" | "watermarks.apply" | "watermarks.list" | "watermarks.insert" | "watermarks.replace" | "watermarks.remove" | "create.contentControl" | "contentControls.list" | "contentControls.get" | "contentControls.listInRange" | "contentControls.selectByTag" | "contentControls.selectByTitle" | "contentControls.listChildren" | "contentControls.getParent" | "contentControls.wrap" | "contentControls.unwrap" | "contentControls.delete" | "contentControls.copy" | "contentControls.move" | "contentControls.patch" | "contentControls.setLockMode" | "contentControls.setType" | "contentControls.getContent" | "contentControls.replaceContent" | "contentControls.clearContent" | "contentControls.appendContent" | "contentControls.prependContent" | "contentControls.insertBefore" | "contentControls.insertAfter" | "contentControls.getBinding" | "contentControls.setBinding" | "contentControls.clearBinding" | "contentControls.getRawProperties" | "contentControls.patchRawProperties" | "contentControls.validateWordCompatibility" | "contentControls.normalizeWordCompatibility" | "contentControls.normalizeTagPayload" | "contentControls.text.setMultiline" | "contentControls.text.setValue" | "contentControls.text.clearValue" | "contentControls.date.setValue" | "contentControls.date.clearValue" | "contentControls.date.setDisplayFormat" | "contentControls.date.setDisplayLocale" | "contentControls.date.setStorageFormat" | "contentControls.date.setCalendar" | "contentControls.checkbox.getState" | "contentControls.checkbox.setState" | "contentControls.checkbox.toggle" | "contentControls.checkbox.setSymbolPair" | "contentControls.choiceList.getItems" | "contentControls.choiceList.setItems" | "contentControls.choiceList.setSelected" | "contentControls.repeatingSection.listItems" | "contentControls.repeatingSection.insertItemBefore" | "contentControls.repeatingSection.insertItemAfter" | "contentControls.repeatingSection.cloneItem" | "contentControls.repeatingSection.deleteItem" | "contentControls.repeatingSection.setAllowInsertDelete" | "contentControls.group.wrap" | "contentControls.group.ungroup" | "bookmarks.list" | "bookmarks.get" | "bookmarks.insert" | "bookmarks.rename" | "bookmarks.remove" | "footnotes.list" | "footnotes.get" | "footnotes.insert" | "footnotes.update" | "footnotes.remove" | "footnotes.configure" | "clipboard.parse" | "clipboard.insert" | "clipboard.serializeSelection" | "crossRefs.list" | "crossRefs.get" | "crossRefs.insert" | "crossRefs.rebuild" | "crossRefs.remove" | "index.list" | "index.get" | "index.insert" | "index.configure" | "index.rebuild" | "index.remove" | "index.entries.list" | "index.entries.get" | "index.entries.insert" | "index.entries.update" | "index.entries.remove" | "captions.list" | "captions.get" | "captions.insert" | "captions.update" | "captions.remove" | "captions.configure" | "fields.list" | "fields.get" | "fields.insert" | "fields.rebuild" | "fields.remove" | "citations.list" | "citations.get" | "citations.insert" | "citations.update" | "citations.remove" | "citations.sources.list" | "citations.sources.get" | "citations.sources.insert" | "citations.sources.update" | "citations.sources.remove" | "citations.bibliography.get" | "citations.bibliography.insert" | "citations.bibliography.rebuild" | "citations.bibliography.configure" | "citations.bibliography.remove" | "authorities.list" | "authorities.get" | "authorities.insert" | "authorities.configure" | "authorities.rebuild" | "authorities.remove" | "authorities.entries.list" | "authorities.entries.get" | "authorities.entries.insert" | "authorities.entries.update" | "authorities.entries.remove" | "diff.capture" | "diff.compare" | "diff.apply" | "export.toDocx" | "protection.get" | "protection.setEditingRestriction" | "protection.clearEditingRestriction" | "permissionRanges.list" | "permissionRanges.get" | "permissionRanges.create" | "permissionRanges.remove" | "permissionRanges.updatePrincipal" | "customXml.parts.list" | "customXml.parts.get" | "customXml.parts.create" | "customXml.parts.patch" | "customXml.parts.remove" | "metadata.attach" | "metadata.list" | "metadata.get" | "metadata.update" | "metadata.remove" | "metadata.resolve")[];
+export declare const MUTATING_OPERATION_IDS: ("replace" | "find" | "delete" | "selection.extractOoxml" | "selection.current" | "selection.releaseSnapshot" | "insert" | "info" | "projectHtml" | "projectMarkdown" | "capabilities.check" | "format.apply" | "comments.patch" | "trackChanges.decide" | "styles.getCatalog" | "blocks.split" | "blocks.merge" | "blocks.move" | "lists.getState" | "lists.apply" | "lists.continue" | "lists.restart" | "lists.remove" | "format.paragraph.setMarkRunProps" | "tables.moveRow" | "tables.moveColumn" | "format.bold" | "format.strike" | "format.color" | "format.position" | "format.rtl" | "format.cs" | "format.shading" | "format.fontFamily" | "format.lang" | "format.fontSize" | "format.fontSizeCs" | "format.highlight" | "format.italic" | "format.underline" | "format.caps" | "format.smallCaps" | "format.outline" | "format.shadow" | "format.emboss" | "format.imprint" | "format.vanish" | "format.webHidden" | "format.specVanish" | "format.border" | "format.dstrike" | "format.vertAlign" | "format.bCs" | "format.iCs" | "format.snapToGrid" | "format.oMath" | "format.letterSpacing" | "format.charScale" | "format.kerning" | "format.fitText" | "format.rStyle" | "format.rFonts" | "format.eastAsianLayout" | "format.em" | "format.ligatures" | "format.numForm" | "format.numSpacing" | "format.stylisticSets" | "format.contextualAlternates" | "get" | "getNode" | "getNodeById" | "getText" | "getMarkdown" | "getHtml" | "markdownToFragment" | "htmlToFragment" | "extract" | "clearContent" | "formatRange" | "blocks.findText" | "blocks.list" | "blocks.delete" | "blocks.deleteRange" | "styles.apply" | "styles.create" | "styles.getTheme" | "templates.apply" | "create.paragraph" | "create.heading" | "create.sectionBreak" | "sections.list" | "sections.get" | "sections.setBreakType" | "sections.setPageMargins" | "sections.setHeaderFooterMargins" | "sections.setPageSetup" | "sections.setColumns" | "sections.setLineNumbering" | "sections.setPageNumbering" | "sections.setTitlePage" | "sections.setOddEvenHeadersFooters" | "sections.setVerticalAlign" | "sections.setSectionDirection" | "sections.setHeaderFooterRef" | "sections.clearHeaderFooterRef" | "sections.setLinkToPrevious" | "sections.setPageBorders" | "sections.clearPageBorders" | "styles.paragraph.setStyle" | "styles.paragraph.setStyleRef" | "styles.paragraph.clearStyle" | "format.paragraph.resetDirectFormatting" | "format.paragraph.setAlignment" | "format.paragraph.clearAlignment" | "format.paragraph.setIndentation" | "format.paragraph.clearIndentation" | "format.paragraph.setSpacing" | "format.paragraph.clearSpacing" | "format.paragraph.setKeepOptions" | "format.paragraph.setOutlineLevel" | "format.paragraph.setFlowOptions" | "format.paragraph.setTabStop" | "format.paragraph.clearTabStop" | "format.paragraph.clearAllTabStops" | "format.paragraph.setBorder" | "format.paragraph.clearBorder" | "format.paragraph.setShading" | "format.paragraph.clearShading" | "format.paragraph.setDirection" | "format.paragraph.clearDirection" | "format.paragraph.setNumbering" | "lists.list" | "lists.get" | "lists.insert" | "lists.create" | "lists.attach" | "lists.detach" | "lists.delete" | "lists.indent" | "lists.outdent" | "lists.join" | "lists.canJoin" | "lists.separate" | "lists.merge" | "lists.split" | "lists.setLevel" | "lists.setValue" | "lists.continuePrevious" | "lists.canContinuePrevious" | "lists.setLevelRestart" | "lists.convertToText" | "lists.applyTemplate" | "lists.applyPreset" | "lists.setType" | "lists.captureTemplate" | "lists.setLevelNumbering" | "lists.setLevelBullet" | "lists.setLevelPictureBullet" | "lists.setLevelAlignment" | "lists.setLevelIndents" | "lists.setLevelTrailingCharacter" | "lists.setLevelMarkerFont" | "lists.clearLevelOverrides" | "lists.getStyle" | "lists.applyStyle" | "lists.restartAt" | "lists.setLevelNumberStyle" | "lists.setLevelText" | "lists.setLevelStart" | "lists.setLevelLayout" | "comments.create" | "comments.delete" | "comments.get" | "comments.list" | "trackChanges.list" | "trackChanges.get" | "query.match" | "ranges.resolve" | "mutations.preview" | "mutations.apply" | "plan.execute" | "capabilities.get" | "capabilities.resolve" | "create.table" | "tables.convertFromText" | "tables.delete" | "tables.clearContents" | "tables.move" | "tables.split" | "tables.convertToText" | "tables.setLayout" | "tables.insertRow" | "tables.deleteRow" | "tables.setRowHeight" | "tables.distributeRows" | "tables.setRowOptions" | "tables.insertColumn" | "tables.deleteColumn" | "tables.setColumnWidth" | "tables.distributeColumns" | "tables.insertCell" | "tables.deleteCell" | "tables.mergeCells" | "tables.unmergeCells" | "tables.splitCell" | "tables.setCellProperties" | "tables.setCellText" | "tables.sort" | "tables.setAltText" | "tables.setStyle" | "tables.clearStyle" | "tables.setStyleOption" | "tables.setBorder" | "tables.clearBorder" | "tables.applyBorderPreset" | "tables.setShading" | "tables.clearShading" | "tables.setTablePadding" | "tables.setCellPadding" | "tables.setCellSpacing" | "tables.clearCellSpacing" | "tables.applyStyle" | "tables.setBorders" | "tables.setTableOptions" | "tables.applyPreset" | "tables.get" | "tables.getCells" | "tables.getProperties" | "tables.getStyles" | "tables.setDefaultStyle" | "tables.clearDefaultStyle" | "create.tableOfContents" | "toc.list" | "toc.get" | "toc.configure" | "toc.update" | "toc.remove" | "toc.markEntry" | "toc.unmarkEntry" | "toc.listEntries" | "toc.getEntry" | "toc.editEntry" | "history.get" | "history.undo" | "history.redo" | "create.image" | "images.list" | "images.get" | "images.delete" | "images.move" | "images.convertToInline" | "images.convertToFloating" | "images.setSize" | "images.setWrapType" | "images.setWrapSide" | "images.setWrapDistances" | "images.setPosition" | "images.setAnchorOptions" | "images.setZOrder" | "images.scale" | "images.setLockAspectRatio" | "images.rotate" | "images.flip" | "images.crop" | "images.resetCrop" | "images.replaceSource" | "images.setAltText" | "images.setDecorative" | "images.setName" | "images.setHyperlink" | "images.insertCaption" | "images.updateCaption" | "images.removeCaption" | "hyperlinks.list" | "hyperlinks.get" | "hyperlinks.wrap" | "hyperlinks.insert" | "hyperlinks.patch" | "hyperlinks.remove" | "headerFooters.list" | "headerFooters.get" | "headerFooters.resolve" | "headerFooters.refs.set" | "headerFooters.refs.clear" | "headerFooters.refs.setLinkedToPrevious" | "headerFooters.parts.list" | "headerFooters.parts.create" | "headerFooters.parts.delete" | "headerFooters.pageNumbers.get" | "headerFooters.pageNumbers.insert" | "headerFooters.pageNumbers.set" | "headerFooters.pageNumbers.remove" | "watermarks.apply" | "watermarks.list" | "watermarks.insert" | "watermarks.replace" | "watermarks.remove" | "create.contentControl" | "contentControls.list" | "contentControls.get" | "contentControls.listInRange" | "contentControls.selectByTag" | "contentControls.selectByTitle" | "contentControls.listChildren" | "contentControls.getParent" | "contentControls.wrap" | "contentControls.unwrap" | "contentControls.delete" | "contentControls.copy" | "contentControls.move" | "contentControls.patch" | "contentControls.setLockMode" | "contentControls.setType" | "contentControls.getContent" | "contentControls.replaceContent" | "contentControls.clearContent" | "contentControls.appendContent" | "contentControls.prependContent" | "contentControls.insertBefore" | "contentControls.insertAfter" | "contentControls.getBinding" | "contentControls.setBinding" | "contentControls.clearBinding" | "contentControls.getRawProperties" | "contentControls.patchRawProperties" | "contentControls.validateWordCompatibility" | "contentControls.normalizeWordCompatibility" | "contentControls.normalizeTagPayload" | "contentControls.text.setMultiline" | "contentControls.text.setValue" | "contentControls.text.clearValue" | "contentControls.date.setValue" | "contentControls.date.clearValue" | "contentControls.date.setDisplayFormat" | "contentControls.date.setDisplayLocale" | "contentControls.date.setStorageFormat" | "contentControls.date.setCalendar" | "contentControls.checkbox.getState" | "contentControls.checkbox.setState" | "contentControls.checkbox.toggle" | "contentControls.checkbox.setSymbolPair" | "contentControls.choiceList.getItems" | "contentControls.choiceList.setItems" | "contentControls.choiceList.setSelected" | "contentControls.repeatingSection.listItems" | "contentControls.repeatingSection.insertItemBefore" | "contentControls.repeatingSection.insertItemAfter" | "contentControls.repeatingSection.cloneItem" | "contentControls.repeatingSection.deleteItem" | "contentControls.repeatingSection.setAllowInsertDelete" | "contentControls.group.wrap" | "contentControls.group.ungroup" | "bookmarks.list" | "bookmarks.get" | "bookmarks.insert" | "bookmarks.rename" | "bookmarks.remove" | "footnotes.list" | "footnotes.get" | "footnotes.insert" | "footnotes.update" | "footnotes.remove" | "footnotes.configure" | "clipboard.parse" | "clipboard.insert" | "clipboard.serializeSelection" | "crossRefs.list" | "crossRefs.get" | "crossRefs.insert" | "crossRefs.rebuild" | "crossRefs.remove" | "index.list" | "index.get" | "index.insert" | "index.configure" | "index.rebuild" | "index.remove" | "index.entries.list" | "index.entries.get" | "index.entries.insert" | "index.entries.update" | "index.entries.remove" | "captions.list" | "captions.get" | "captions.insert" | "captions.update" | "captions.remove" | "captions.configure" | "fields.list" | "fields.get" | "fields.insert" | "fields.rebuild" | "fields.remove" | "citations.list" | "citations.get" | "citations.insert" | "citations.update" | "citations.remove" | "citations.sources.list" | "citations.sources.get" | "citations.sources.insert" | "citations.sources.update" | "citations.sources.remove" | "citations.bibliography.get" | "citations.bibliography.insert" | "citations.bibliography.rebuild" | "citations.bibliography.configure" | "citations.bibliography.remove" | "authorities.list" | "authorities.get" | "authorities.insert" | "authorities.configure" | "authorities.rebuild" | "authorities.remove" | "authorities.entries.list" | "authorities.entries.get" | "authorities.entries.insert" | "authorities.entries.update" | "authorities.entries.remove" | "diff.capture" | "diff.compare" | "diff.apply" | "export.toDocx" | "protection.get" | "protection.setEditingRestriction" | "protection.clearEditingRestriction" | "permissionRanges.list" | "permissionRanges.get" | "permissionRanges.create" | "permissionRanges.remove" | "permissionRanges.updatePrincipal" | "customXml.parts.list" | "customXml.parts.get" | "customXml.parts.create" | "customXml.parts.patch" | "customXml.parts.remove" | "metadata.attach" | "metadata.list" | "metadata.get" | "metadata.update" | "metadata.remove" | "metadata.resolve")[];
 /** Maps each operation to its human-readable description. */
 export declare const OPERATION_DESCRIPTION_MAP: Record<OperationId, string>;
 /** Maps each operation to whether it requires an open document to execute. */

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

@@ -165,8 +165,9 @@ export interface SelectionInfo {
     selectionTarget?: SelectionTarget | null;
     /**
      * V2 browser cell context with inclusive, zero-based logical bounds.
-     * Whole-cell selections clear text targets. Character selections preserve
-     * their targets and include the containing cells, including endpoint cells.
+     * Whole-cell selections clear text targets; explicit whole-table handle selections
+     * retain resolved formatting targets. Character selections preserve their targets
+     * and include the containing cells, including endpoint cells.
      * Exact cell IDs and spans describe merged or nonrectangular selections;
      * only rectangular whole-cell metadata can become a table-cells target.
      */

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

@@ -1,11 +1,11 @@
 import { BlockNodeAddress, BlockNodeType } from './base.js';
-import { TextAddress, TrackedChangeAddress, SelectionTarget, DeleteBehavior } from './address.js';
+import { TextAddress, TextTarget, TrackedChangeAddress, SelectionTarget, DeleteBehavior } from './address.js';
 import { TextSelector, NodeSelector } from './query.js';
 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 = {
@@ -138,13 +138,37 @@ export type StructuralReplaceStep = {
         nestingPolicy?: NestingPolicy;
     };
 };
+/** Explicit review edits. Targets use the starting revision; relocations precede decisions. */
+export type CommentRelocateStep = {
+    id: string;
+    op: 'comments.patch';
+    args: {
+        commentId: string;
+        target: TextAddress | SelectionTarget;
+    };
+};
+export type TrackChangesDecideStep = {
+    id: string;
+    op: 'trackChanges.decide';
+    args: {
+        decision: 'accept' | 'reject';
+        target: {
+            kind: 'id';
+            id: string;
+        } | {
+            kind: 'ids';
+            ids: string[];
+        };
+    };
+};
+export type ReviewMutationStep = CommentRelocateStep | TrackChangesDecideStep;
 export type DomainStep = {
     id: string;
     op: string;
     where: StepWhere;
     args: Record<string, unknown>;
 };
-export type MutationStep = TextRewriteStep | TextInsertStep | TextDeleteStep | StyleApplyStep | StructuralInsertStep | StructuralReplaceStep | AssertStep | DomainStep;
+export type MutationStep = TextRewriteStep | TextInsertStep | TextDeleteStep | StyleApplyStep | StructuralInsertStep | StructuralReplaceStep | AssertStep | DomainStep | ReviewMutationStep;
 export type { ChangeMode } from '../write/write.js';
 export type MutationsApplyInput = {
     /** Target story for the mutation plan. Omit for body (backward compatible). */
@@ -230,7 +254,16 @@ export type StructuralStepData = {
     domain: 'structural';
     insertedBlockIds?: string[];
 };
-export type StepOutcomeData = TextStepData | AssertStepData | DomainStepData | TableStepData | StructuralStepData;
+export type ReviewStepData = {
+    domain: 'review';
+    commentIds?: string[];
+    commentTargets?: {
+        commentId: string;
+        target: TextTarget;
+    }[];
+    decidedTrackedChangeIds?: string[];
+};
+export type StepOutcomeData = ReviewStepData | TextStepData | AssertStepData | DomainStepData | TableStepData | StructuralStepData;
 export type StepOutcome = {
     stepId: string;
     /** Effective mode when all committed requests in this step used the same mode. */
@@ -241,7 +274,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;
@@ -279,6 +312,13 @@ export type StepPreview = {
     spanResolutions?: SpanStepResolution[];
     selectionResolutions?: SelectionStepResolution[];
     style?: unknown;
+    review?: {
+        commentId?: string;
+        target?: TextAddress | SelectionTarget;
+        mappedTarget?: TextTarget;
+        trackedChangeIds?: string[];
+        decision?: 'accept' | 'reject';
+    };
 };
 export type MutationsPreviewOutput = {
     evaluatedRevision: string;

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,15 +12,15 @@ 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';
 export type { DisplayPageInfo, HeaderFooterConstraints } from '../../layout-engine/src/index.js';
 export { clearRemeasureTextCaches, remeasureParagraph } from './remeasure.js';
-export { findCharacterAtX, measureCharacterX } from './text-measurement.js';
+export { findCharacterAtX, measureCharacterX, measureInlineImageCaretTextBox, getRunFontString, } from './text-measurement.js';
 export { sliceRunsForLine } from '../../contracts/src/index.js';
 export { clickToPositionDom, findPageElement } from './dom-mapping.js';
 export { isListItem, getWordLayoutConfig, calculateTextStartIndent, extractParagraphIndent } from './list-indent-utils.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;