superdoc 2.28.0-next.1 → 2.28.0-next.10

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.28.0-next.1",
+	superdocVersion: "2.28.0-next.10",
 	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.28.0-next.1",
+	superdocVersion: "2.28.0-next.10",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

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

@@ -3,6 +3,8 @@ import { SelectionTarget } from '../types/address.js';
 import { SDFragment } from '../types/fragment.js';
 import { ReceiptFailure, ReceiptInsert, ReceiptSuccess } from '../types/receipt.js';
 import { StoryLocator } from '../types/story.types.js';
+import { InlineRunPatch } from '../format/inline-run-patch.js';
+export declare const CONTENT_CONTROL_INLINE_FORMAT_KEYS: readonly ["fontFamily", "fontSize", "bold", "italic", "underline", "strike"];
 /**
  * Semantic SDT subtype derived from `w:sdtPr` children.
  *
@@ -196,9 +198,16 @@ type CreateContentControlPlacement = {
     at?: never;
 };
 type CreateContentControlPayload = {
+    kind: 'inline';
+    content: string;
+    inline?: Pick<InlineRunPatch, (typeof CONTENT_CONTROL_INLINE_FORMAT_KEYS)[number]>;
+    html?: never;
+    json?: never;
+} | {
     kind: NodeKind;
     /** Plain-text initial content. */
     content?: string;
+    inline?: never;
     html?: never;
     json?: never;
 } | {
@@ -207,12 +216,14 @@ type CreateContentControlPayload = {
     /** Initial block content authored from HTML. */
     html: string;
     json?: never;
+    inline?: never;
 } | {
     kind: Extract<NodeKind, 'block'>;
     content?: never;
     html?: never;
     /** Initial block content authored from an SDFragment-compatible value. */
     json: SDFragment | Record<string, unknown> | Array<Record<string, unknown>>;
+    inline?: never;
 };
 export type CreateContentControlInput = CreateContentControlCommonInput & CreateContentControlPlacement & CreateContentControlPayload;
 export interface ContentControlsListQuery extends ContentControlsPaginationOptions {

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" | "insert" | "info" | "selection.extractOoxml" | "selection.current" | "selection.releaseSnapshot" | "format.readSelection" | "projectHtml" | "projectMarkdown" | "capabilities.check" | "format.apply" | "comments.patch" | "trackChanges.decide" | "styles.getCatalog" | "blocks.delete" | "comments.create" | "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.cs" | "format.shading" | "format.rtl" | "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.fitText" | "format.dstrike" | "format.vertAlign" | "format.bCs" | "format.iCs" | "format.snapToGrid" | "format.oMath" | "format.letterSpacing" | "format.charScale" | "format.kerning" | "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.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.delete" | "comments.get" | "comments.list" | "trackChanges.list" | "trackChanges.get" | "query.match" | "ranges.resolve" | "mutations.beginTemporary" | "mutations.replaceTemporary" | "mutations.rollbackTemporary" | "mutations.commitTemporary" | "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" | "insert" | "info" | "selection.extractOoxml" | "selection.current" | "selection.releaseSnapshot" | "format.readSelection" | "projectHtml" | "projectMarkdown" | "capabilities.check" | "format.apply" | "comments.patch" | "trackChanges.decide" | "styles.getCatalog" | "blocks.delete" | "comments.create" | "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.cs" | "format.shading" | "format.rtl" | "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.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.delete" | "comments.get" | "comments.list" | "trackChanges.list" | "trackChanges.get" | "query.match" | "ranges.resolve" | "mutations.beginTemporary" | "mutations.replaceTemporary" | "mutations.rollbackTemporary" | "mutations.commitTemporary" | "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

@@ -473,7 +473,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'format.paragraph.setMarkRunProps': {
         readonly memberPath: "format.paragraph.setMarkRunProps";
-        readonly description: string;
+        readonly description: "Set the paragraph mark's run properties (w:pPr/w:rPr), e.g. the font size or specVanish carried by the paragraph-end mark.";
         readonly expectedResult: "Returns a ParagraphMutationResult; reports NO_OP if the encoded mark run properties already match.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -744,7 +744,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'lists.captureTemplate': {
         readonly memberPath: "lists.captureTemplate";
-        readonly description: "Advanced alias for lists.getStyle. Capture list formatting from the abstract definition only (does not merge lvlOverride formatting).";
+        readonly description: "Capture reusable effective list formatting, including full level overrides and Word defaults, without instance continuation checkpoints (startOverride).";
         readonly expectedResult: "Returns a ListsCaptureTemplateResult containing the captured template.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -834,8 +834,8 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'lists.applyStyle': {
         readonly memberPath: "lists.applyStyle";
-        readonly description: "Apply a reusable list style to the target list. Sequence-local: if the abstract definition is shared with other lists, it is cloned first to avoid affecting them.";
-        readonly expectedResult: "Returns a ListsMutateItemResult receipt; reports NO_OP if all levels already match.";
+        readonly description: "Apply a reusable list style to the target list. Sequence-local: preserves other sequences and levels. V2 returns CAPABILITY_UNAVAILABLE when existing numbering cannot be preserved.";
+        readonly expectedResult: "Returns a ListsMutateItemResult receipt with changed: false and no transaction when all levels already match.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "lists/apply-style.mdx";
@@ -852,8 +852,8 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'lists.setLevelNumberStyle': {
         readonly memberPath: "lists.setLevelNumberStyle";
-        readonly description: "Set the numbering style (e.g. decimal, lowerLetter, upperRoman) for a specific list level. Rejects \"bullet\": use setLevelBullet instead. Sequence-local: clones shared definitions.";
-        readonly expectedResult: "Returns a ListsMutateItemResult receipt; reports NO_OP if the value already matches.";
+        readonly description: "Set the numbering style (e.g. decimal, lowerLetter, upperRoman) for a specific list level. Rejects \"bullet\": use setLevelBullet instead. Sequence-local: preserves other sequences and levels. V2 returns CAPABILITY_UNAVAILABLE for numberInDash and inherited, mixed-counter, or nested-restart continuations whose numbering cannot be preserved.";
+        readonly expectedResult: "Returns a ListsMutateItemResult receipt with changed: false and no transaction when the effective value already matches.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "lists/set-level-number-style.mdx";
@@ -861,8 +861,8 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'lists.setLevelText': {
         readonly memberPath: "lists.setLevelText";
-        readonly description: "Set the level text pattern (e.g. \"%1.\", \"(%1)\") for a specific list level. Uses OOXML level-placeholder syntax. Sequence-local: clones shared definitions.";
-        readonly expectedResult: "Returns a ListsMutateItemResult receipt; reports NO_OP if the value already matches.";
+        readonly description: "Set the level text pattern (e.g. \"%1.\", \"(%1)\") for a specific list level. Uses OOXML level-placeholder syntax. Sequence-local: preserves other sequences and levels. V2 returns CAPABILITY_UNAVAILABLE when existing numbering cannot be preserved.";
+        readonly expectedResult: "Returns a ListsMutateItemResult receipt with changed: false and no transaction when the value already matches.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "lists/set-level-text.mdx";
@@ -870,8 +870,8 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'lists.setLevelStart': {
         readonly memberPath: "lists.setLevelStart";
-        readonly description: "Set the start value for a specific list level. Rejects bullet levels and non-positive values. Sequence-local: clones shared definitions.";
-        readonly expectedResult: "Returns a ListsMutateItemResult receipt; reports NO_OP if the value already matches.";
+        readonly description: "Set the start value for a specific list level. Rejects bullet levels and non-positive values. Sequence-local: preserves other sequences and levels. V2 returns CAPABILITY_UNAVAILABLE when existing numbering cannot be preserved.";
+        readonly expectedResult: "Returns a ListsMutateItemResult receipt with changed: false and no transaction when the value already matches.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "lists/set-level-start.mdx";
@@ -879,8 +879,8 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'lists.setLevelLayout': {
         readonly memberPath: "lists.setLevelLayout";
-        readonly description: "Set the layout properties (alignment, indentation, trailing character, tab stop) for a specific list level. Accepts partial updates: omitted fields are left unchanged. Sequence-local: clones shared definitions.";
-        readonly expectedResult: "Returns a ListsMutateItemResult receipt; reports NO_OP if all values already match.";
+        readonly description: "Set the layout properties (alignment, indentation, trailing character, tab stop) for a specific list level. Accepts partial updates: omitted fields are left unchanged. Sequence-local: preserves other sequences and levels. V2 returns CAPABILITY_UNAVAILABLE when existing numbering cannot be preserved.";
+        readonly expectedResult: "Returns a ListsMutateItemResult receipt with changed: false and no transaction when all values already match.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "lists/set-level-layout.mdx";
@@ -888,7 +888,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'lists.getState': {
         readonly memberPath: "lists.getState";
-        readonly description: string;
+        readonly description: "Read the numbering-aware list state for a paragraph (numId, ilvl, abstract reference, level format). Returns null when the target is not a list item.";
         readonly expectedResult: "Returns a ListsGetStateResult with `isListItem` plus numId/ilvl/abstract/numFmt metadata when present.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -897,7 +897,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'lists.apply': {
         readonly memberPath: "lists.apply";
-        readonly description: string;
+        readonly description: "Apply a numbering definition to a paragraph. When `/word/numbering.xml` is absent it is materialized atomically together with the package content-type override and document relationship. Seeds bullet or ordered single-level definitions when no `reuseNumId` is provided.";
         readonly expectedResult: "Returns a ListsMutateItemResult receipt with txId; partsChanged includes numbering / content-types / rels when first-list materialization fires.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -906,7 +906,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'lists.continue': {
         readonly memberPath: "lists.continue";
-        readonly description: string;
+        readonly description: "Continue from the previous compatible list item in the same story. Adopts the previous paragraph's numId+ilvl. Rejects with named reasons when no compatible previous item exists or when an intervening structural boundary blocks the continuation.";
         readonly expectedResult: "Returns a ListsMutateItemResult receipt with txId.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -915,7 +915,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'lists.restart': {
         readonly memberPath: "lists.restart";
-        readonly description: string;
+        readonly description: "Restart numbering at a list item. Creates a new `<w:num>` that references the existing `<w:abstractNumId>` with a `<w:lvlOverride><w:startOverride/></w:lvlOverride>`. Distant paragraphs sharing the old numId are intentionally untouched.";
         readonly expectedResult: "Returns a ListsMutateItemResult receipt with txId; partsChanged includes /word/numbering.xml.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -924,7 +924,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'lists.remove': {
         readonly memberPath: "lists.remove";
-        readonly description: string;
+        readonly description: "Strip the `<w:numPr>` from a list-item paragraph. The numbering definition in `/word/numbering.xml` is intentionally NOT modified; orphan cleanup is handled by the export-side stripper.";
         readonly expectedResult: "Returns a ListsMutateItemResult receipt with txId.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -1021,7 +1021,7 @@ export declare const OPERATION_DEFINITIONS: {
     readonly 'trackChanges.decide': {
         readonly memberPath: "trackChanges.decide";
         readonly description: "Accept or reject tracked changes by logical id, by several logical ids atomically, by selected text range, by logical anchor range ({ anchor, relativeStart, relativeEnd }), or every active change in the document. Range targets may include overlap / side selectors and may partially resolve a change, splitting surviving content into new fragments with stable ids. Legacy `{ id, range: { kind: \"partial\", ... } }` targets are promoted only when the active adapter supports `decide()`; legacy fallback adapters fail closed with `INVALID_INPUT`. `input.expectedRevision` is accepted as a compatibility alias for mutation options.";
-        readonly expectedResult: "Returns a Receipt. `removed` lists retired tracked-change ids; `inserted` lists successor fragment ids produced by partial range splits; `invalidatedRefs` lists every retired tracked-change ref plus cascade-deleted comment ids; `remappedRefs` carries surviving comment anchors moved by the decision; `affectedStories` lists touched stories; `textRangeShifts` reports per-story visible-text deltas; `txId` correlates with history. Failures: SPAN_FRAGMENTED when a range crosses an indivisible boundary, CAPABILITY_UNAVAILABLE for formatting / structural / move targets (not yet supported), TARGET_NOT_FOUND for retired ids or zero overlap, STALE_REVISION for stale expectedRevision, REVISION_MISMATCH for stale range coverage, NO_OP when { kind: 'all' } resolves an empty target set.";
+        readonly expectedResult: "Returns a Receipt. `removed` lists retired tracked-change ids; `inserted` lists successor fragment ids produced by partial range splits; `invalidatedRefs` lists every retired tracked-change ref plus cascade-deleted comment ids; `remappedRefs` carries surviving comment anchors moved by the decision; `affectedStories` lists touched stories; `textRangeShifts` reports per-story visible-text deltas; `txId` correlates with history. Formatting, structural and paired move changes are decided by id. Failures: SPAN_FRAGMENTED when a range crosses an indivisible boundary; CAPABILITY_UNAVAILABLE for unpaired move sides, ambiguous mirrored text-box revisions by id, mirrored text-box revisions targeted by range or replacement side, textbox-scoped or inherited header/footer bulk decisions, range targets over changes that are not text insertions or deletions, and permissionResolver denials of an id or range target; TARGET_NOT_FOUND for unknown ids or a range with no overlapping text revision (formatting-only changes are not range targets); NO_OP for an id already resolved by an id or bulk decision (an id retired by a range decision returns TARGET_NOT_FOUND); STALE_REVISION for stale expectedRevision; REVISION_MISMATCH for stale range coverage. { kind: 'all' } skips changes permissionResolver denies and succeeds with an empty receipt when nothing is decidable.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "track-changes/decide.mdx";
@@ -1060,7 +1060,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'selection.releaseSnapshot': {
         readonly memberPath: "selection.releaseSnapshot";
-        readonly description: string;
+        readonly description: "Release a retained exact-selection snapshot without changing document content or Undo history.";
         readonly expectedResult: "Returns released=true when a same-session handle was removed; otherwise false.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -1282,7 +1282,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'tables.moveRow': {
         readonly memberPath: "tables.moveRow";
-        readonly description: string;
+        readonly description: "Move a row to a new position within the same table.";
         readonly expectedResult: "Returns a TableMutationResult receipt; reports NO_OP if the row is already at the requested position.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -1346,7 +1346,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'tables.moveColumn': {
         readonly memberPath: "tables.moveColumn";
-        readonly description: string;
+        readonly description: "Move a column to a new position within the same table. Direct mode only; tables with vertical merges, nested tables, or irregular column coverage are rejected, and tracked (suggesting) mode is not supported yet.";
         readonly expectedResult: "Returns a TableMutationResult receipt; reports NO_OP if the column is already at the requested position.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -2054,8 +2054,8 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'hyperlinks.list': {
         readonly memberPath: "hyperlinks.list";
-        readonly description: "List all hyperlinks in the document, with optional filtering by href, anchor, or display text.";
-        readonly expectedResult: "Returns a HyperlinksListResult with an array of hyperlink discovery items and pagination metadata.";
+        readonly description: string;
+        readonly expectedResult: string;
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "hyperlinks/list.mdx";
@@ -2082,7 +2082,7 @@ export declare const OPERATION_DEFINITIONS: {
     readonly 'hyperlinks.insert': {
         readonly memberPath: "hyperlinks.insert";
         readonly description: "Insert new linked text at a target position.";
-        readonly expectedResult: "Returns a HyperlinkMutationResult with the created hyperlink address on success, or a failure code.";
+        readonly expectedResult: string;
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "hyperlinks/insert.mdx";
@@ -2189,7 +2189,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'headerFooters.pageNumbers.get': {
         readonly memberPath: "headerFooters.pageNumbers.get";
-        readonly description: string;
+        readonly description: "Read where a section shows page numbers, their alignment, the first-page choice, and the section's number style and start.";
         readonly expectedResult: "Returns the header and footer placements that show a PAGE field (empty when none), first-page visibility, the number format, and the start number or null when numbering continues.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -2198,7 +2198,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'headerFooters.pageNumbers.insert': {
         readonly memberPath: "headerFooters.pageNumbers.insert";
-        readonly description: string;
+        readonly description: "Atomically number a section's pages with a live PAGE field in its header or footer, with alignment, a first-page choice, and an optional number style and start.";
         readonly expectedResult: "Returns the numbered header/footer parts and whether the section uses a distinct first page; PRECONDITION_FAILED with reason page-number-exists when the target already shows a page number.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -2207,7 +2207,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'headerFooters.pageNumbers.set': {
         readonly memberPath: "headerFooters.pageNumbers.set";
-        readonly description: string;
+        readonly description: "Atomically add a section's page numbers or change them: move them between header and footer, realign them, show or hide them on the first page, and set the number style and start.";
         readonly expectedResult: "Returns the numbered header/footer parts and whether the section uses a distinct first page; PRECONDITION_FAILED with reason page-number-has-content when a moved or hidden number shares its paragraph with other text or fields.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -2216,7 +2216,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'headerFooters.pageNumbers.remove': {
         readonly memberPath: "headerFooters.pageNumbers.remove";
-        readonly description: string;
+        readonly description: "Atomically remove a section's PAGE fields from its header, footer, or both, keeping other header and footer content.";
         readonly expectedResult: "Returns the header/footer parts that lost a PAGE field; a paragraph left with only whitespace is removed. NO_OP when the section shows no page number.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -2225,7 +2225,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'watermarks.apply': {
         readonly memberPath: "watermarks.apply";
-        readonly description: string;
+        readonly description: "Atomically insert, replace, or remove selected watermarks in explicit scopes while preserving surrounding headers.";
         readonly expectedResult: "Returns the resulting watermarks, changed header slots, preserved boundaries, and evaluated revision.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -2234,7 +2234,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'watermarks.list': {
         readonly memberPath: "watermarks.list";
-        readonly description: string;
+        readonly description: "List Word-compatible text and picture watermarks and their effective header scopes.";
         readonly expectedResult: "Returns a paginated WatermarksListResult with stable watermark identities and Word placement settings.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -2243,7 +2243,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'watermarks.insert': {
         readonly memberPath: "watermarks.insert";
-        readonly description: string;
+        readonly description: "Insert a Word-compatible text or picture watermark into a header scope.";
         readonly expectedResult: "Returns the inserted watermark, including its stable identity and effective header scopes.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -2252,7 +2252,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'watermarks.replace': {
         readonly memberPath: "watermarks.replace";
-        readonly description: string;
+        readonly description: "Replace an existing watermark while retaining its stable identity and owner scope.";
         readonly expectedResult: "Returns the replaced watermark, or TARGET_NOT_FOUND when its identity is stale.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -2261,7 +2261,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'watermarks.remove': {
         readonly memberPath: "watermarks.remove";
-        readonly description: string;
+        readonly description: "Remove a watermark without removing unrelated header content.";
         readonly expectedResult: "Returns the removed watermark identity, or TARGET_NOT_FOUND when its identity is stale.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -2270,7 +2270,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'create.contentControl': {
         readonly memberPath: "create.contentControl";
-        readonly description: "Create a new content control (SDT) in the document, optionally seeded with plain text or structured block preset content.";
+        readonly description: "Create a new content control (SDT) in the document, optionally seeded with plain text or structured block preset content. Inline plain-text creation at a selection inherits the document run formatting at the caret or first selected character when inline is omitted; pending browser caret overrides are excluded. To include pending overrides, capture format.readSelection({ selection: \"current\" }) and pass its uniform values through inline. An explicit inline payload supplies fontFamily, fontSize, bold, italic, underline and strike values instead, with unspecified properties inheriting from the destination paragraph. It requires explicit content and commits formatting, content, tag and lockMode in one undoable operation. If inherited formatting cannot be resolved, creation returns CAPABILITY_UNAVAILABLE without changing the document or history; pass explicit inline values to bypass automatic inheritance.";
         readonly expectedResult: "Returns a ContentControlMutationResult with the created content control target.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -2828,7 +2828,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'footnotes.insert': {
         readonly memberPath: "footnotes.insert";
-        readonly description: "Insert a new footnote or endnote at a target location or the current selection. Structured `body` content is currently available on v2-backed sessions only; v1-backed sessions return `CAPABILITY_UNAVAILABLE` for those shapes.";
+        readonly description: "Insert a new footnote or endnote at a target location or the current selection.";
         readonly expectedResult: "Returns a FootnoteMutationResult indicating success with the footnote address or a failure.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -2837,7 +2837,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'footnotes.update': {
         readonly memberPath: "footnotes.update";
-        readonly description: "Update the content of an existing footnote or endnote. Structured `body` content is currently available on v2-backed sessions only; v1-backed sessions return `CAPABILITY_UNAVAILABLE` for those shapes.";
+        readonly description: "Update the content of an existing footnote or endnote.";
         readonly expectedResult: "Returns a FootnoteMutationResult indicating success with the updated footnote address or a failure.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -3107,7 +3107,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'fields.insert': {
         readonly memberPath: "fields.insert";
-        readonly description: "Insert a raw field code at a target location, optionally preserving cached result text. The current v1 runtime supports rebuild flows; `cachedResultText` / `updatePolicy: \"preserveCached\"` currently return `CAPABILITY_UNAVAILABLE`.";
+        readonly description: "Insert a raw field code at a target location, optionally preserving cached result text.";
         readonly expectedResult: "Returns a FieldMutationResult indicating success with the field address or a failure.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -3657,9 +3657,6 @@ export declare const OPERATION_DEFINITIONS: {
     readonly "format.border": OperationDefinitionEntry & {
         memberPath: "format.border";
     };
-    readonly "format.fitText": OperationDefinitionEntry & {
-        memberPath: "format.fitText";
-    };
     readonly "format.dstrike": OperationDefinitionEntry & {
         memberPath: "format.dstrike";
     };
@@ -3687,6 +3684,9 @@ export declare const OPERATION_DEFINITIONS: {
     readonly "format.kerning": OperationDefinitionEntry & {
         memberPath: "format.kerning";
     };
+    readonly "format.fitText": OperationDefinitionEntry & {
+        memberPath: "format.fitText";
+    };
     readonly "format.rStyle": OperationDefinitionEntry & {
         memberPath: "format.rStyle";
     };
@@ -3744,7 +3744,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly getNodeById: {
         readonly memberPath: "getNodeById";
-        readonly description: "Retrieve a single node by its unique ID.";
+        readonly description: "Resolve a block ID across the body, linked headers/footers, and supported textboxes, optionally restricted by story. Paragraphs at every table-cell depth and top-level body/header/footer tables are supported; notes, comments, glossary, and nested table containers are excluded.";
         readonly expectedResult: "Returns an SDNodeResult envelope with the projected SDM/1 node and canonical address.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -3948,7 +3948,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'blocks.split': {
         readonly memberPath: "blocks.split";
-        readonly description: string;
+        readonly description: "Split a paragraph at a visible-text offset, producing two paragraphs. Preserves unambiguous simple run properties around the cut. Rejects when the paragraph contains fields, content controls, drawings, equations, or unsupported tracked-change wrappers.";
         readonly expectedResult: "Returns a BlocksSplitResult; on success carries the new tail paragraph address, affectedStories, and (for engines that report them) story-absolute textRangeShifts and a txId for history correlation.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -3957,7 +3957,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'blocks.merge': {
         readonly memberPath: "blocks.merge";
-        readonly description: string;
+        readonly description: "Merge two adjacent paragraphs in the same story. The first paragraph keeps its pPr; the second paragraph is removed. Rejects when either paragraph carries a w:sectPr or when their numbering definitions differ.";
         readonly expectedResult: "Returns a BlocksMergeResult; on success carries the removed paragraph address plus affectedStories, textRangeShifts, and a txId.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
@@ -3966,7 +3966,7 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'blocks.move': {
         readonly memberPath: "blocks.move";
-        readonly description: string;
+        readonly description: "Move a paragraph within the same story to a new anchor paragraph (before or after). Cross-story and relationship-bearing moves reject with named reasons. Tracked-mode authoring emits paired `<w:moveFrom>` / `<w:moveTo>` review state with explicit move range marker identity; safe content (no comment/bookmark/permission anchors and no pre-existing tracked wrappers) is required for tracked authoring.";
         readonly expectedResult: "Returns a BlocksMoveResult; on success carries the moved paragraph address plus affectedStories and a txId. Tracked-mode results include `trackedChangeRefs` pointing at the paired move review entity.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;

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

@@ -47,6 +47,10 @@ type AttributedTextInvokeRequest<T extends OperationId> = T extends 'insert' ? {
 export type InvokeRequest<T extends OperationId> = MethodInvokeRequest<T> | AttributedTextInvokeRequest<T>;
 /** Typed invoke result narrowed by `operationId`. */
 export type InvokeResult<T extends OperationId> = T extends 'mutations.preview' | 'mutations.apply' ? Promise<OperationRegistry[T]['output']> : T extends 'plan.execute' ? OperationRegistry[T]['output'] | Promise<OperationRegistry[T]['output']> : OperationRegistry[T]['output'];
+export type OperationCall<T extends OperationId> = InvokeRequest<T> extends infer Request ? (Request extends unknown ? Omit<Request, 'operationId'> : never) : never;
+export type OperationInput<T extends OperationId> = InvokeRequest<T>['input'];
+export type OperationOptions<T extends OperationId> = Exclude<InvokeRequest<T>['options'], undefined>;
+export type OperationOutput<T extends OperationId> = Awaited<InvokeResult<T>>;
 /** Loose request for callers that resolve operation identity at runtime. */
 export type DynamicInvokeRequest = {
     operationId: OperationId;

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

@@ -1,10 +1,12 @@
-import { ExportToDocxInput, ExportToDocxResult, SDExportMode } from './export.types.js';
+import { DocxExportPolicies, ExportToDocxInput, ExportToDocxResult, SDExportMode } from './export.types.js';
 export interface ExportAdapter {
     toDocx(input: {
         mode: SDExportMode;
+        policies?: Required<DocxExportPolicies>;
     }): ExportToDocxResult;
 }
 export interface ExportApi {
     toDocx(input?: ExportToDocxInput): ExportToDocxResult;
 }
+export declare function resolveDocxExportPolicies(input?: ExportToDocxInput): Required<DocxExportPolicies>;
 export declare function executeExportToDocx(adapter: ExportAdapter | undefined, input?: ExportToDocxInput): ExportToDocxResult;

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

@@ -12,10 +12,18 @@ export declare const SD_EXPORT_MODES: readonly ["review-preserving", "final", "o
 export type SDExportMode = (typeof SD_EXPORT_MODES)[number];
 /** Default mode for modeful DOCX export. */
 export declare const DEFAULT_SD_EXPORT_MODE: SDExportMode;
+export declare const SD_COMMENT_EXPORT_POLICIES: readonly ["preserve", "resolve", "remove"];
+export declare const SD_CONTENT_CONTROL_EXPORT_POLICIES: readonly ["preserve", "flatten"];
+export interface DocxExportPolicies {
+    trackedChanges?: SDExportMode;
+    comments?: (typeof SD_COMMENT_EXPORT_POLICIES)[number];
+    contentControls?: (typeof SD_CONTENT_CONTROL_EXPORT_POLICIES)[number];
+}
 /** Input for `export.toDocx`. */
 export interface ExportToDocxInput {
     /** Tracked-change export mode. Defaults to `review-preserving`. */
     mode?: SDExportMode;
+    policies?: DocxExportPolicies;
 }
 /** Structured degradation report for an export. */
 export interface ExportToDocxReport {

package/dist/document-api/src/get-node/get-node.d.ts

@@ -1,11 +1,15 @@
-import { BlockNodeType, NodeAddress } from '../types/index.js';
+import { BlockNodeType, NodeAddress, StoryLocator } from '../types/index.js';
 import { SDNodeResult } from '../types/sd-envelope.js';
 /**
- * Input for resolving a block node by its unique ID.
+ * Input for resolving a block node by its ID without guessing its type.
+ * Resolves paragraphs (including table-cell paragraphs) in the body, linked
+ * header/footer parts, and supported textboxes, plus top-level body/header/footer tables.
+ * Notes, comments, glossary, and nested table containers are outside this resolver.
  */
 export interface GetNodeByIdInput {
     nodeId: string;
     nodeType?: BlockNodeType;
+    story?: StoryLocator;
 }
 /**
  * Engine-specific adapter that the getNode API delegates to.
@@ -16,7 +20,8 @@ export interface GetNodeAdapter {
      *
      * @param address - The node address to resolve.
      * @returns SDNodeResult with the projected node and its address.
-     * @throws When the address cannot be resolved.
+     * @throws When the address cannot be resolved, including AMBIGUOUS_TARGET
+     * when its node ID is duplicated within the addressed story.
      */
     getNode(address: NodeAddress): SDNodeResult;
     /**
@@ -24,7 +29,8 @@ export interface GetNodeAdapter {
      *
      * @param input - The node-id input payload.
      * @returns SDNodeResult with the projected node and its address.
-     * @throws When the node ID cannot be found.
+     * @throws TARGET_NOT_FOUND for no match, AMBIGUOUS_TARGET for duplicate IDs,
+     * or CAPABILITY_UNAVAILABLE for an unsupported story hint.
      */
     getNodeById(input: GetNodeByIdInput): SDNodeResult;
 }

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

@@ -2,6 +2,7 @@ import { BlockNodeAddress, InlineNodeAddress } from '../types/base.js';
 import { TextAddress } from '../types/address.js';
 import { DiscoveryOutput } from '../types/discovery.js';
 import { ReceiptFailure, ReceiptSuccess } from '../types/receipt.js';
+import { StoryLocator } from '../types/story.types.js';
 /** Narrowed inline address for hyperlink targets. */
 export type HyperlinkTarget = InlineNodeAddress & {
     nodeType: 'hyperlink';
@@ -93,6 +94,7 @@ export interface HyperlinkMutationFailure {
 export type HyperlinkMutationResult = HyperlinkMutationSuccess | HyperlinkMutationFailure;
 export type HyperlinksListResult = DiscoveryOutput<HyperlinkDomain>;
 export interface HyperlinksListQuery {
+    in?: StoryLocator;
     within?: BlockNodeAddress;
     hrefPattern?: string;
     anchor?: string;

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

@@ -75,6 +75,7 @@ export { executeHistoryGet, executeHistoryUndo, executeHistoryRedo } from './his
 export type { DiffAdapter, DiffApi } from './diff/diff.js';
 export * from './diff/diff.types.js';
 export type { ExportAdapter, ExportApi } from './export/export.js';
+export { resolveDocxExportPolicies } from './export/export.js';
 export * from './export/export.types.js';
 export type { SelectionMutationAdapter, SelectionMutationRequest, SelectionInsertRequest, } from './selection-mutation.js';
 export type { RangeAnchor, DocumentEdgeAnchor, PointAnchor, RefBoundaryAnchor, ResolveRangeInput, ResolveRangeOutput, RangeBlockPreview, RangePreview, RangeResolverAdapter, ScrollIntoViewInput, ScrollIntoViewOutput, } from './ranges/index.js';
@@ -185,7 +186,7 @@ export { isBlockNodeAddress } from './validation-primitives.js';
 export type { InsertInput, InsertContentType, TextInsertInput, PlainTextInsertInput, RichContentInsertInput, NativeOoxmlInsertInput, LegacyInsertInput, } from './insert/insert.js';
 export { isStructuralInsertInput } from './insert/insert.js';
 export type { ReplaceInput, TextReplaceInput, TextReplacementGranularity, RichContentReplaceInput, ReplaceMutationOptions, NativeOoxmlReplaceInput, SnapshotReplaceInput, ParagraphTextReplaceInput, } from './replace/replace.js';
-export { executeReplace, isStructuralReplaceInput, isRichContentReplaceInput } from './replace/replace.js';
+export { executeReplace, isStructuralReplaceInput, isRichContentReplaceInput, TEXT_REPLACEMENT_GRANULARITIES, isTextReplacementGranularity, isSingleParagraphVisibleTextSelection, } from './replace/replace.js';
 export { executeFind } from './find/find.js';
 export { validateDocumentFragment, validateSDFragment } from './validation/fragment-validator.js';
 export type { DeleteInput } from './delete/delete.js';