superdoc 2.30.0-next.4 → 2.30.0-next.9

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.30.0-next.4",
+	superdocVersion: "2.30.0-next.9",
 	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.30.0-next.4",
+	superdocVersion: "2.30.0-next.9",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/comments/comment-create-attribution.d.ts

@@ -1,2 +1,6 @@
 import { CommentCreateAttributionInput } from './comments.types.js';
 export declare function normalizeCommentCreateAttribution(input: CommentCreateAttributionInput): CommentCreateAttributionInput | null;
+export declare function normalizeCommentIdentity(value: unknown): {
+    providerId: string;
+    userId: string;
+} | null;

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

@@ -9,6 +9,10 @@ export type CommentMetadataValue = string | number | boolean | null | readonly C
 export type CommentMetadata = Readonly<Record<string, CommentMetadataValue>>;
 /** Optional caller-owned identity and authorship for a newly-created comment. */
 export interface CommentCreateAttributionInput {
+    authorIdentity?: {
+        providerId: string;
+        userId: string;
+    } | null;
     /**
      * Durable document-scoped integration id, distinct from the Word-compatible
      * `commentId` returned by the operation. Must be unique when provided and no

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: ("insert" | "replace" | "find" | "delete" | "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" | "changes.list" | "changes.get" | "changes.resolve" | "changes.actors" | "changes.snapshot" | "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: ("insert" | "replace" | "find" | "delete" | "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" | "format.paragraph.applyBatch" | "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.listPresets" | "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" | "changes.list" | "changes.get" | "changes.resolve" | "changes.actors" | "changes.snapshot" | "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

@@ -28,7 +28,7 @@ export interface IntentGroupMeta {
      */
     inputExamples?: Record<string, unknown>[];
 }
-export declare const V1_RUNTIME_UNAVAILABLE_OPERATION_IDS: readonly ["selection.releaseSnapshot", "blocks.split", "blocks.merge", "blocks.move", "lists.getState", "lists.apply", "lists.continue", "lists.restart", "lists.remove", "format.paragraph.setMarkRunProps", "tables.moveRow", "tables.moveColumn"];
+export declare const V1_RUNTIME_UNAVAILABLE_OPERATION_IDS: readonly ["format.paragraph.applyBatch", "selection.releaseSnapshot", "blocks.split", "blocks.merge", "blocks.move", "lists.getState", "lists.apply", "lists.continue", "lists.restart", "lists.remove", "format.paragraph.setMarkRunProps", "tables.moveRow", "tables.moveColumn"];
 export declare const INTENT_GROUP_META: Record<string, IntentGroupMeta>;
 export declare const OPERATION_DEFINITIONS: {
     readonly 'format.readSelection': {
@@ -319,6 +319,15 @@ export declare const OPERATION_DEFINITIONS: {
         readonly referenceDocPath: "format/paragraph/reset-direct-formatting.mdx";
         readonly referenceGroup: "format.paragraph";
     };
+    readonly 'format.paragraph.applyBatch': {
+        readonly memberPath: "format.paragraph.applyBatch";
+        readonly description: "Apply an explicit ordered paragraph action program target-major to 1..1000 unique existing targets in one story, atomically. Accepts 1..1000 closed actions, at most 32000 expanded writer calls and 1048576 JSON bytes, cumulative across batches in an atomic plan. Uses existing writer validation; omitted groups are preserved. No nested plans, per-action targets/options or dry run. Expected revision is consumed once at batch start; live freshness is checked again before publication. Shared sessions support direct identity-preserving writes only.";
+        readonly expectedResult: "Resolves to ParagraphBatchMutationResult with resolution.targets, applied mode and tracked refs when committed, or indexed failure details. An all-no-op batch succeeds without revision, publication or history. Standalone commits once; inside an atomic plan shares its one preparation, publication and Undo/Redo unit.";
+        readonly requiresDocumentContext: true;
+        readonly metadata: CommandStaticMetadata;
+        readonly referenceDocPath: "format/paragraph/apply-batch.mdx";
+        readonly referenceGroup: "format.paragraph";
+    };
     readonly 'format.paragraph.setAlignment': {
         readonly memberPath: "format.paragraph.setAlignment";
         readonly description: "Set visual paragraph alignment on a paragraph-like block. For RTL paragraphs, left/right are translated to Word-compatible stored justification values.";
@@ -1610,12 +1619,21 @@ export declare const OPERATION_DEFINITIONS: {
     readonly 'tables.applyPreset': {
         readonly memberPath: "tables.applyPreset";
         readonly description: string;
-        readonly expectedResult: "Returns a TableMutationResult receipt.";
+        readonly expectedResult: "Returns a TableMutationResult receipt. Read tables.getProperties to see the installed Word style ID, which can differ from the Word default when the document already customizes that style.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "tables/apply-preset.mdx";
         readonly referenceGroup: "tables";
     };
+    readonly 'tables.listPresets': {
+        readonly memberPath: "tables.listPresets";
+        readonly description: string;
+        readonly expectedResult: "Returns a TablesListPresetsOutput page with items (id, name, source, group, accent, appearance), the exact filtered total, the page offset, and nextOffset (null when no more matches remain).";
+        readonly requiresDocumentContext: true;
+        readonly metadata: CommandStaticMetadata;
+        readonly referenceDocPath: "tables/list-presets.mdx";
+        readonly referenceGroup: "tables";
+    };
     readonly 'tables.get': {
         readonly memberPath: "tables.get";
         readonly description: "Retrieve table structure and dimensions by locator.";
@@ -1636,8 +1654,8 @@ export declare const OPERATION_DEFINITIONS: {
     };
     readonly 'tables.getProperties': {
         readonly memberPath: "tables.getProperties";
-        readonly description: "Retrieve layout and style properties of a table.";
-        readonly expectedResult: "Returns a TablesGetPropertiesOutput with direct table layout and style state, including style options, borders, default cell margins, and cell spacing when explicitly set.";
+        readonly description: "Retrieve layout, style, and authored row and grid column dimensions of a table.";
+        readonly expectedResult: "Returns a TablesGetPropertiesOutput with direct table layout and style state and optional indexed rows and columns. Row heightPt and grid widthPt are authored points, not rendered sizes. Unspecified dimensions and unstored heightRule are omitted; explicit zero and auto are retained. Existing style options, borders, default cell margins, and cell spacing are included when explicitly set.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "tables/get-properties.mdx";
@@ -3767,7 +3785,7 @@ export declare const OPERATION_DEFINITIONS: {
     readonly get: {
         readonly memberPath: "get";
         readonly description: "Read the full document as an SDDocument structure.";
-        readonly expectedResult: "Returns an SDDocument with body content projected into SDM/1 canonical shapes, plus the document's authored styles, theme (labeled document or fallback), docDefaults, and diagnostics for missing or unreadable style parts.";
+        readonly expectedResult: "Returns an SDDocument with body content projected into SDM/1 canonical shapes, plus the document's authored styles, theme (labeled document or fallback), docDefaults, and diagnostics for missing or unreadable style parts. Paragraph indent *Chars values remain hundredths of a character; numeric distances remain points. Read-model fields do not expand operation-specific authoring support.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "get.mdx";
@@ -3786,7 +3804,7 @@ export declare const OPERATION_DEFINITIONS: {
     readonly getNode: {
         readonly memberPath: "getNode";
         readonly description: "Retrieve a single node by target position.";
-        readonly expectedResult: "Returns an SDNodeResult envelope with the projected SDM/1 node and canonical address.";
+        readonly expectedResult: "Returns an SDNodeResult envelope with the projected SDM/1 node and canonical address. Paragraph indent *Chars values remain hundredths of a character; numeric distances remain points. Paragraph setters and fragment materialization retain their operation-specific property limits.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "get-node.mdx";
@@ -3795,7 +3813,7 @@ export declare const OPERATION_DEFINITIONS: {
     readonly getNodeById: {
         readonly memberPath: "getNodeById";
         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 expectedResult: "Returns an SDNodeResult envelope with the projected SDM/1 node and canonical address. Paragraph indent *Chars values remain hundredths of a character; numeric distances remain points. Paragraph setters and fragment materialization retain their operation-specific property limits.";
         readonly requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "get-node-by-id.mdx";

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

@@ -20,7 +20,7 @@ export type OperationRegistry = {
     [Id in OperationId]: ResolveMemberPath<DocumentApiSurface, (typeof OPERATION_DEFINITIONS)[Id]['memberPath']> extends infer Method ? {
         input: MethodInput<Method>;
         options: MethodOptions<Method>;
-        output: Id extends 'mutations.preview' | 'mutations.apply' | 'plan.execute' ? Awaited<MethodReturn<Method>> : MethodReturn<Method>;
+        output: Id extends 'mutations.preview' | 'mutations.apply' | 'plan.execute' | 'format.paragraph.applyBatch' ? Awaited<MethodReturn<Method>> : MethodReturn<Method>;
     } : never;
 };
 type MethodInvokeRequest<T extends OperationId> = OperationRegistry[T]['options'] extends never ? {
@@ -47,7 +47,7 @@ type AttributedInvokeRequest<T extends OperationId> = T extends 'insert' ? {
 /** Typed invoke request narrowed by `operationId` and supported content shape. */
 export type InvokeRequest<T extends OperationId> = MethodInvokeRequest<T> | AttributedInvokeRequest<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 InvokeResult<T extends OperationId> = T extends 'mutations.preview' | 'mutations.apply' | 'format.paragraph.applyBatch' ? 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>;

package/dist/document-api/src/contract/schemas.d.ts

@@ -1,5 +1,11 @@
 import { OperationId } from './types.js';
-type JsonSchema = Record<string, unknown>;
+type JsonSchema = {
+    [key: string]: unknown;
+    properties?: Record<string, JsonSchema>;
+    required?: readonly string[];
+    anyOf?: JsonSchema[];
+    oneOf?: JsonSchema[];
+};
 /** JSON Schema descriptors for a single operation's input, output, and result variants. */
 export interface OperationSchemaSet {
     /** Schema describing the operation's accepted input payload. */

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

@@ -43,6 +43,7 @@ import { HistoryAdapter, HistoryApi } from './history/history.js';
 import { ChangesAdapter, ChangesApi } from './changes/changes.js';
 import { DiffAdapter, DiffApi } from './diff/diff.js';
 import { ExportAdapter, ExportApi } from './export/export.js';
+import { TablesListPresetsInput, TablesListPresetsOutput } from './tables/table-style-presets.js';
 import { ParagraphsAdapter, ParagraphFormatApi, ParagraphStylesApi } from './paragraphs/paragraphs.js';
 import { SectionsAdapter, SectionsApi } from './sections/sections.js';
 import { HeaderFootersAdapter, HeaderFootersApi } from './header-footers/header-footers.js';
@@ -105,6 +106,7 @@ export type { HistoryState, HistoryActionResult, HistoryNoopReason, SDHistorySta
 export { executeTrackChangesGet, executeTrackChangesList, executeTrackChangesDecide, } from './track-changes/track-changes.js';
 export { createPlanApi, type PlanApi, type PlanExecuteInput, type PlanExecuteEntry, type PlanExecuteEntryExpect, type PlanExecuteResult, type PlanEntryReceipt, type PlanEntryReceiptStatus, type PlanExecuteFailure, type PlanCaptureRefMarker, type PlanProjectTextOffsetMarker, } from './plan/plan.js';
 export type { DiffSnapshot, DiffPayload, DiffPartChange, DiffApplyResult, DiffCompareInput, DiffApplyInput, DiffApplyOptions, DiffApplyOperationReceipt, DiffApplyReviewItem, DiffApplyEligibility, DiffApplyModeEligibility, DiffApplyEligibilityBlocker, DiffApplyEligibilityBlockerCode, } from './diff/diff.types.js';
+export * from './tables/table-style-presets.js';
 export type { GetAdapter } from './get/get.js';
 export type { FindAdapter, FindOptions } from './find/find.js';
 export type { GetNodeAdapter, GetNodeByIdInput } from './get-node/get-node.js';
@@ -170,6 +172,8 @@ export type * from './citations/citations.types.js';
 export type * from './authorities/authorities.types.js';
 export type { ListsAdapter } from './lists/lists.js';
 export type { SectionsAdapter } from './sections/sections.js';
+export { validateParagraphsApplyBatchInput, PARAGRAPH_BATCH_OPERATION_IDS, PARAGRAPH_BATCH_MAX_TARGETS, PARAGRAPH_BATCH_MAX_OPERATIONS, PARAGRAPH_BATCH_MAX_EXPANDED_WRITES, PARAGRAPH_BATCH_MAX_PAYLOAD_BYTES, } from './paragraphs/paragraphs.js';
+export type { ParagraphsApplyBatchInput, ParagraphBatchOperation, ParagraphBatchMutationResult, } from './paragraphs/paragraphs.js';
 export type { ParagraphsAdapter, ParagraphFormatApi, ParagraphStylesApi } from './paragraphs/paragraphs.js';
 export type { ParagraphTarget, ParagraphBlockType, ParagraphMutationResult, ParagraphMutationSuccess, ParagraphMutationFailure, MutationResolution, ParagraphAlignment, TabStopAlignment, TabStopLeader, BorderSide, ClearBorderSide, LineRule, ParagraphsSetStyleInput, ParagraphSemanticStyleRole, ParagraphsSetStyleRefInput, ParagraphsClearStyleInput, ParagraphsResetDirectFormattingInput, ParagraphsSetAlignmentInput, ParagraphsClearAlignmentInput, ParagraphsSetIndentationInput, ParagraphsClearIndentationInput, ParagraphsSetSpacingInput, ParagraphsClearSpacingInput, ParagraphsSetKeepOptionsInput, ParagraphsSetOutlineLevelInput, ParagraphsSetFlowOptionsInput, ParagraphsSetTabStopInput, ParagraphsClearTabStopInput, ParagraphsClearAllTabStopsInput, ParagraphsSetBorderInput, ParagraphsClearBorderInput, ParagraphsSetShadingInput, ParagraphsClearShadingInput, ParagraphsSetMarkRunPropsInput, ParagraphsSetDirectionInput, ParagraphsClearDirectionInput, ParagraphsSetNumberingInput, ParagraphDirection, AlignmentPolicy, } from './paragraphs/paragraphs.js';
 export { PARAGRAPH_ALIGNMENTS, TAB_STOP_ALIGNMENTS, TAB_STOP_LEADERS, BORDER_SIDES, CLEAR_BORDER_SIDES, LINE_RULES, PARAGRAPH_DIRECTIONS, ALIGNMENT_POLICIES, } from './paragraphs/paragraphs.js';
@@ -238,6 +242,7 @@ export interface TablesApi {
     setBorders(input: TablesSetBordersInput, options?: MutationOptions): TableMutationResult;
     setTableOptions(input: TablesSetTableOptionsInput, options?: MutationOptions): TableMutationResult;
     applyPreset(input: TablesApplyPresetInput, options?: MutationOptions): TableMutationResult;
+    listPresets(input?: TablesListPresetsInput): TablesListPresetsOutput;
     get(input: TablesGetInput): TablesGetOutput;
     getCells(input: TablesGetCellsInput): TablesGetCellsOutput;
     getProperties(input: TablesGetPropertiesInput): TablesGetPropertiesOutput;
@@ -245,7 +250,7 @@ export interface TablesApi {
     setDefaultStyle(input: TablesSetDefaultStyleInput, options?: MutationOptions): DocumentMutationResult;
     clearDefaultStyle(input?: TablesClearDefaultStyleInput, options?: MutationOptions): DocumentMutationResult;
 }
-export type TablesAdapter = Omit<TablesApi, 'moveRow' | 'moveColumn'> & {
+export type TablesAdapter = Omit<TablesApi, 'moveRow' | 'moveColumn' | 'listPresets'> & {
     moveRow?: TablesApi['moveRow'];
     moveColumn?: TablesApi['moveColumn'];
 };
@@ -635,3 +640,4 @@ export interface DocumentApiAdapters {
     metadata?: AnchoredMetadataAdapter;
 }
 export declare function createDocumentApi(adapters: DocumentApiAdapters): DocumentApi;
+export { normalizeCommentIdentity } from './comments/comment-create-attribution.js';

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

@@ -1,8 +1,9 @@
 import { MutationOptions } from '../write/write.js';
-import { ParagraphMutationResult, ParagraphsSetStyleInput, ParagraphsSetStyleRefInput, ParagraphsClearStyleInput, ParagraphsResetDirectFormattingInput, ParagraphsSetAlignmentInput, ParagraphsClearAlignmentInput, ParagraphsSetIndentationInput, ParagraphsClearIndentationInput, ParagraphsSetSpacingInput, ParagraphsClearSpacingInput, ParagraphsSetKeepOptionsInput, ParagraphsSetOutlineLevelInput, ParagraphsSetFlowOptionsInput, ParagraphsSetTabStopInput, ParagraphsClearTabStopInput, ParagraphsClearAllTabStopsInput, ParagraphsSetBorderInput, ParagraphsClearBorderInput, ParagraphsSetShadingInput, ParagraphsClearShadingInput, ParagraphsSetMarkRunPropsInput, ParagraphsSetDirectionInput, ParagraphsClearDirectionInput, ParagraphsSetNumberingInput } from './paragraphs.types.js';
-export type { ParagraphTarget, ParagraphBlockType, ParagraphMutationResult, ParagraphMutationSuccess, ParagraphMutationFailure, MutationResolution, ParagraphAlignment, TabStopAlignment, TabStopLeader, BorderSide, ClearBorderSide, LineRule, ParagraphsSetStyleInput, ParagraphSemanticStyleRole, ParagraphsSetStyleRefInput, ParagraphsClearStyleInput, ParagraphsResetDirectFormattingInput, ParagraphsSetAlignmentInput, ParagraphsClearAlignmentInput, ParagraphsSetIndentationInput, ParagraphsClearIndentationInput, ParagraphsSetSpacingInput, ParagraphsClearSpacingInput, ParagraphsSetKeepOptionsInput, ParagraphsSetOutlineLevelInput, ParagraphsSetFlowOptionsInput, ParagraphsSetTabStopInput, ParagraphsClearTabStopInput, ParagraphsClearAllTabStopsInput, ParagraphsSetBorderInput, ParagraphsClearBorderInput, ParagraphsSetShadingInput, ParagraphsClearShadingInput, ParagraphsSetMarkRunPropsInput, ParagraphsSetDirectionInput, ParagraphsClearDirectionInput, ParagraphsSetNumberingInput, ParagraphDirection, AlignmentPolicy, } from './paragraphs.types.js';
-export { PARAGRAPH_ALIGNMENTS, TAB_STOP_ALIGNMENTS, TAB_STOP_LEADERS, BORDER_SIDES, CLEAR_BORDER_SIDES, LINE_RULES, PARAGRAPH_DIRECTIONS, ALIGNMENT_POLICIES, } from './paragraphs.types.js';
+import { ParagraphsApplyBatchInput, ParagraphBatchMutationResult, ParagraphMutationResult, ParagraphsSetStyleInput, ParagraphsSetStyleRefInput, ParagraphsClearStyleInput, ParagraphsResetDirectFormattingInput, ParagraphsSetAlignmentInput, ParagraphsClearAlignmentInput, ParagraphsSetIndentationInput, ParagraphsClearIndentationInput, ParagraphsSetSpacingInput, ParagraphsClearSpacingInput, ParagraphsSetKeepOptionsInput, ParagraphsSetOutlineLevelInput, ParagraphsSetFlowOptionsInput, ParagraphsSetTabStopInput, ParagraphsClearTabStopInput, ParagraphsClearAllTabStopsInput, ParagraphsSetBorderInput, ParagraphsClearBorderInput, ParagraphsSetShadingInput, ParagraphsClearShadingInput, ParagraphsSetMarkRunPropsInput, ParagraphsSetDirectionInput, ParagraphsClearDirectionInput, ParagraphsSetNumberingInput } from './paragraphs.types.js';
+export type { ParagraphTarget, ParagraphsApplyBatchInput, ParagraphBatchOperation, ParagraphBatchMutationResult, ParagraphBlockType, ParagraphMutationResult, ParagraphMutationSuccess, ParagraphMutationFailure, MutationResolution, ParagraphAlignment, TabStopAlignment, TabStopLeader, BorderSide, ClearBorderSide, LineRule, ParagraphsSetStyleInput, ParagraphSemanticStyleRole, ParagraphsSetStyleRefInput, ParagraphsClearStyleInput, ParagraphsResetDirectFormattingInput, ParagraphsSetAlignmentInput, ParagraphsClearAlignmentInput, ParagraphsSetIndentationInput, ParagraphsClearIndentationInput, ParagraphsSetSpacingInput, ParagraphsClearSpacingInput, ParagraphsSetKeepOptionsInput, ParagraphsSetOutlineLevelInput, ParagraphsSetFlowOptionsInput, ParagraphsSetTabStopInput, ParagraphsClearTabStopInput, ParagraphsClearAllTabStopsInput, ParagraphsSetBorderInput, ParagraphsClearBorderInput, ParagraphsSetShadingInput, ParagraphsClearShadingInput, ParagraphsSetMarkRunPropsInput, ParagraphsSetDirectionInput, ParagraphsClearDirectionInput, ParagraphsSetNumberingInput, ParagraphDirection, AlignmentPolicy, } from './paragraphs.types.js';
+export { PARAGRAPH_BATCH_MAX_TARGETS, PARAGRAPH_BATCH_MAX_OPERATIONS, PARAGRAPH_BATCH_MAX_EXPANDED_WRITES, PARAGRAPH_BATCH_MAX_PAYLOAD_BYTES, PARAGRAPH_ALIGNMENTS, TAB_STOP_ALIGNMENTS, TAB_STOP_LEADERS, BORDER_SIDES, CLEAR_BORDER_SIDES, LINE_RULES, PARAGRAPH_DIRECTIONS, ALIGNMENT_POLICIES, } from './paragraphs.types.js';
 export interface ParagraphsAdapter {
+    applyBatch?(input: ParagraphsApplyBatchInput, options?: MutationOptions): Promise<ParagraphBatchMutationResult>;
     setStyle(input: ParagraphsSetStyleInput, options?: MutationOptions): ParagraphMutationResult;
     setStyleRef(input: ParagraphsSetStyleRefInput, options?: MutationOptions): ParagraphMutationResult;
     clearStyle(input: ParagraphsClearStyleInput, options?: MutationOptions): ParagraphMutationResult;
@@ -30,6 +31,7 @@ export interface ParagraphsAdapter {
 }
 /** Public API surface for `format.paragraph.*`: direct paragraph formatting. */
 export interface ParagraphFormatApi {
+    applyBatch(input: ParagraphsApplyBatchInput, options?: MutationOptions): Promise<ParagraphBatchMutationResult>;
     resetDirectFormatting(input: ParagraphsResetDirectFormattingInput, options?: MutationOptions): ParagraphMutationResult;
     setAlignment(input: ParagraphsSetAlignmentInput, options?: MutationOptions): ParagraphMutationResult;
     clearAlignment(input: ParagraphsClearAlignmentInput, options?: MutationOptions): ParagraphMutationResult;
@@ -82,3 +84,6 @@ export declare function executeParagraphsSetMarkRunProps(adapter: ParagraphsAdap
 export declare function executeParagraphsSetDirection(adapter: ParagraphsAdapter, input: ParagraphsSetDirectionInput, options?: MutationOptions): ParagraphMutationResult;
 export declare function executeParagraphsClearDirection(adapter: ParagraphsAdapter, input: ParagraphsClearDirectionInput, options?: MutationOptions): ParagraphMutationResult;
 export declare function executeParagraphsSetNumbering(adapter: ParagraphsAdapter, input: ParagraphsSetNumberingInput, options?: MutationOptions): ParagraphMutationResult;
+export declare const PARAGRAPH_BATCH_OPERATION_IDS: ("format.paragraph.setMarkRunProps" | "styles.paragraph.setStyleRef" | "styles.paragraph.clearStyle" | "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.clearAllTabStops" | "format.paragraph.setBorder" | "format.paragraph.clearBorder" | "format.paragraph.setShading" | "format.paragraph.clearShading" | "format.paragraph.setDirection" | "format.paragraph.clearDirection")[];
+export declare function validateParagraphsApplyBatchInput(input: unknown): asserts input is ParagraphsApplyBatchInput;
+export declare function executeParagraphsApplyBatch(adapter: ParagraphsAdapter, input: ParagraphsApplyBatchInput, options?: MutationOptions): Promise<ParagraphBatchMutationResult>;

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

@@ -113,9 +113,9 @@ export interface ParagraphsClearSpacingInput {
 /** paragraphs.setKeepOptions */
 export interface ParagraphsSetKeepOptionsInput {
     target: ParagraphTarget;
-    keepNext?: boolean;
-    keepLines?: boolean;
-    widowControl?: boolean;
+    keepNext?: boolean | null;
+    keepLines?: boolean | null;
+    widowControl?: boolean | null;
 }
 /** paragraphs.setOutlineLevel */
 export interface ParagraphsSetOutlineLevelInput {
@@ -125,8 +125,8 @@ export interface ParagraphsSetOutlineLevelInput {
 /** paragraphs.setFlowOptions */
 export interface ParagraphsSetFlowOptionsInput {
     target: ParagraphTarget;
-    contextualSpacing?: boolean;
-    pageBreakBefore?: boolean;
+    contextualSpacing?: boolean | null;
+    pageBreakBefore?: boolean | null;
     suppressAutoHyphens?: boolean;
     /** `w:autoSpaceDE` — auto-space between East-Asian and Latin text. */
     autoSpaceDE?: boolean;
@@ -223,3 +223,47 @@ export interface ParagraphsSetNumberingInput {
     /** Numbering level (`w:ilvl`), 0-8. Defaults to 0 when omitted. */
     level?: number;
 }
+export interface ParagraphBatchInputs {
+    'styles.paragraph.setStyleRef': ParagraphsSetStyleRefInput;
+    'styles.paragraph.clearStyle': ParagraphsClearStyleInput;
+    'format.paragraph.setAlignment': ParagraphsSetAlignmentInput;
+    'format.paragraph.clearAlignment': ParagraphsClearAlignmentInput;
+    'format.paragraph.setSpacing': ParagraphsSetSpacingInput;
+    'format.paragraph.clearSpacing': ParagraphsClearSpacingInput;
+    'format.paragraph.setIndentation': ParagraphsSetIndentationInput;
+    'format.paragraph.clearIndentation': ParagraphsClearIndentationInput;
+    'format.paragraph.setKeepOptions': ParagraphsSetKeepOptionsInput;
+    'format.paragraph.setFlowOptions': ParagraphsSetFlowOptionsInput;
+    'format.paragraph.setOutlineLevel': ParagraphsSetOutlineLevelInput;
+    'format.paragraph.setBorder': ParagraphsSetBorderInput;
+    'format.paragraph.clearBorder': ParagraphsClearBorderInput;
+    'format.paragraph.setShading': ParagraphsSetShadingInput;
+    'format.paragraph.clearShading': ParagraphsClearShadingInput;
+    'format.paragraph.setTabStop': ParagraphsSetTabStopInput;
+    'format.paragraph.clearAllTabStops': ParagraphsClearAllTabStopsInput;
+    'format.paragraph.setDirection': ParagraphsSetDirectionInput;
+    'format.paragraph.clearDirection': ParagraphsClearDirectionInput;
+    'format.paragraph.setMarkRunProps': ParagraphsSetMarkRunPropsInput;
+}
+export type ParagraphBatchOperation = {
+    [Id in keyof ParagraphBatchInputs]: {
+        operationId: Id;
+        input: keyof Omit<ParagraphBatchInputs[Id], 'target'> extends never ? Record<string, never> : Omit<ParagraphBatchInputs[Id], 'target'>;
+    };
+}[keyof ParagraphBatchInputs];
+export interface ParagraphsApplyBatchInput {
+    targets: ParagraphTarget[];
+    operations: ParagraphBatchOperation[];
+}
+export type ParagraphBatchMutationResult = {
+    success: true;
+    resolution: {
+        targets: ParagraphTarget[];
+    };
+    appliedChangeMode?: ChangeMode;
+    trackedChangeRefs?: ReceiptInsert[];
+} | ParagraphMutationFailure;
+export declare const PARAGRAPH_BATCH_MAX_TARGETS = 1000;
+export declare const PARAGRAPH_BATCH_MAX_OPERATIONS = 1000;
+export declare const PARAGRAPH_BATCH_MAX_EXPANDED_WRITES = 32000;
+export declare const PARAGRAPH_BATCH_MAX_PAYLOAD_BYTES = 1048576;

package/dist/document-api/src/tables/data/table-preset-appearance.generated.d.ts

@@ -0,0 +1,2 @@
+import { TablePresetAppearance } from '../table-style-presets.js';
+export declare const WORD_TABLE_PRESET_APPEARANCE: Readonly<Record<string, TablePresetAppearance>>;

package/dist/document-api/src/tables/table-style-presets.d.ts

@@ -0,0 +1,73 @@
+export type TablePresetSource = 'word' | 'superdoc';
+export type TablePresetGroup = 'plain' | 'grid' | 'list' | 'convenience';
+export type TablePresetAccent = 1 | 2 | 3 | 4 | 5 | 6;
+export type SuperDocTablePresetId = 'grid' | 'minimal' | 'striped' | 'accent';
+type WordFamilySlug = 'grid-table' | 'list-table';
+type WordDesignedPresetId = `word.${WordFamilySlug}-${'1-light' | '2' | '3' | '4' | '5-dark' | '6-colorful' | '7-colorful'}` | `word.${WordFamilySlug}-${'1-light' | '2' | '3' | '4' | '5-dark' | '6-colorful' | '7-colorful'}-accent-${TablePresetAccent}`;
+export type WordPlainTablePresetId = 'word.table-grid' | 'word.grid-table-light' | `word.plain-table-${1 | 2 | 3 | 4 | 5}`;
+export type WordTablePresetId = WordPlainTablePresetId | WordDesignedPresetId;
+export type TablePresetId = SuperDocTablePresetId | WordTablePresetId;
+export interface TablePresetColor {
+    themeColor?: string;
+    rgb?: string;
+    tint?: string;
+    shade?: string;
+}
+export interface TablePresetAppearance {
+    baseFill?: TablePresetColor;
+    header: {
+        treatment: Array<'shading' | 'bold' | 'borders'>;
+        fill?: TablePresetColor;
+        textColor?: TablePresetColor;
+    };
+    bandedRows: {
+        effect: 'none' | 'shading' | 'borders' | 'shadingAndBorders';
+        fill?: TablePresetColor;
+        borderColor?: TablePresetColor;
+    };
+    borders: {
+        layout: 'none' | 'horizontal' | 'outer' | 'outerAndHorizontal' | 'grid';
+        color?: TablePresetColor;
+    };
+}
+export interface TablePresetInfo {
+    id: TablePresetId;
+    name: string;
+    source: TablePresetSource;
+    group: TablePresetGroup;
+    accent: TablePresetAccent | null;
+    appearance: TablePresetAppearance | null;
+}
+export interface WordTablePresetDefinition extends TablePresetInfo {
+    id: WordTablePresetId;
+    source: 'word';
+    wordStyleName: string;
+    wordStyleId: string;
+}
+export declare const SUPERDOC_TABLE_PRESET_IDS: readonly ["grid", "minimal", "striped", "accent"];
+export declare const WORD_ACCENT_DISPLAY_SEPARATOR = " - ";
+export declare const WORD_TABLE_PRESETS: readonly WordTablePresetDefinition[];
+export declare const SUPERDOC_TABLE_PRESETS: readonly TablePresetInfo[];
+export declare const TABLE_PRESET_CATALOGUE: readonly TablePresetInfo[];
+export declare const TABLE_PRESET_IDS: readonly TablePresetId[];
+export declare function isWordTablePresetId(value: unknown): value is WordTablePresetId;
+export declare function isSuperDocTablePresetId(value: unknown): value is SuperDocTablePresetId;
+export declare function isTablePresetId(value: unknown): value is TablePresetId;
+export declare function getWordTablePreset(id: string): WordTablePresetDefinition | null;
+export declare const TABLE_PRESET_LIST_DEFAULT_LIMIT = 25;
+export declare const TABLE_PRESET_LIST_MAX_LIMIT = 25;
+export interface TablesListPresetsInput {
+    source?: TablePresetSource;
+    group?: TablePresetGroup;
+    query?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface TablesListPresetsOutput {
+    items: TablePresetInfo[];
+    total: number;
+    offset: number;
+    nextOffset: number | null;
+}
+export declare function listTablePresets(input?: TablesListPresetsInput): TablesListPresetsOutput;
+export {};

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

@@ -1,5 +1,6 @@
 import { MutationOptions } from '../write/write.js';
-import { TablesApplyStyleInput, TablesSetBordersInput, TablesSetCellPaddingInput, TablesSetLayoutInput, TablesSetTableOptionsInput, TablesSortInput } from '../types/table-operations.types.js';
+import { TablesListPresetsInput, TablesListPresetsOutput } from './table-style-presets.js';
+import { TablesApplyPresetInput, TablesApplyStyleInput, TablesSetBordersInput, TablesSetCellPaddingInput, TablesSetLayoutInput, TablesSetTableOptionsInput, TablesSortInput } from '../types/table-operations.types.js';
 type RowLocatorInput = {
     target?: unknown;
     nodeId?: unknown;
@@ -81,4 +82,6 @@ export declare function executeTablesSetTableOptions<TResult>(operationName: str
  * any-of side requirement (and the adapter never authors an empty `w:tcMar`).
  */
 export declare function executeTablesSetCellPadding<TResult>(operationName: string, adapter: (input: TablesSetCellPaddingInput, options?: MutationOptions) => TResult, input: TablesSetCellPaddingInput, options?: MutationOptions): TResult;
+export declare function executeTablesListPresets(input: TablesListPresetsInput | undefined): TablesListPresetsOutput;
+export declare function executeTablesApplyPreset<TResult>(adapter: (input: TablesApplyPresetInput, options?: MutationOptions) => TResult, input: TablesApplyPresetInput, options?: MutationOptions): TResult;
 export {};

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

@@ -125,6 +125,12 @@ export interface SDParagraphProps {
         firstLine?: number;
         /** Hanging indent in points. */
         hanging?: number;
+        leftChars?: number;
+        rightChars?: number;
+        startChars?: number;
+        endChars?: number;
+        firstLineChars?: number;
+        hangingChars?: number;
     };
     spacing?: {
         /** Space before in points. */
@@ -139,6 +145,7 @@ export interface SDParagraphProps {
         line?: number;
         lineRule?: 'auto' | 'multiple' | 'exact' | 'atLeast';
     };
+    contextualSpacing?: boolean;
     keepWithNext?: boolean;
     keepLines?: boolean;
     pageBreakBefore?: boolean;

package/dist/document-api/src/types/table-operations.types.d.ts

@@ -1,3 +1,4 @@
+import { TablePresetId } from '../tables/table-style-presets.js';
 import { BlockNodeAddress, TableAddress, TableCellAddress, TableOrCellAddress, TableOrRowAddress, TableRowAddress } from './base.js';
 import { ReceiptFailure, ReceiptInsert } from './receipt.js';
 /**
@@ -483,24 +484,11 @@ export interface TablesSetTableOptionsInput extends TableLocator {
     /** Non-negative number, or `null` to clear. */
     cellSpacingPt?: number | null;
 }
-/**
- * Named visual presets for tables. Each preset composes borders, shading,
- * and conditional-format flags into a polished look.
- *
- * - `grid` — 0.5pt black borders all around, no shading.
- * - `minimal` — no outer borders, hairline grey separators between rows.
- * - `striped` — banded rows on, 0.5pt grey borders all around.
- * - `accent` — header row filled with `accentColor` (default `1F3864`),
- *   thick accent bottom under the header.
- */
-export type TablePresetName = 'grid' | 'minimal' | 'striped' | 'accent';
+export type TablePresetName = TablePresetId;
 export interface TablesApplyPresetInput extends TableLocator {
     preset: TablePresetName;
-    /**
-     * Optional accent color (hex; same format as `setShading.color`).
-     * Used by presets that need an accent (`accent`). Ignored otherwise.
-     */
     accentColor?: string;
+    styleOptions?: TableStyleOptionsPatch;
 }
 export type BorderEdge = 'top' | 'bottom' | 'left' | 'right' | 'insideH' | 'insideV' | 'diagonalDown' | 'diagonalUp';
 export interface TablesSetBorderInput {
@@ -620,6 +608,15 @@ export type TablesGetPropertiesInput = TableLocator;
 export interface TablesGetPropertiesOutput {
     nodeId: string;
     address: TableAddress;
+    rows?: Array<{
+        rowIndex: number;
+        heightPt?: number;
+        heightRule?: 'atLeast' | 'exact' | 'auto';
+    }>;
+    columns?: Array<{
+        columnIndex: number;
+        widthPt?: number;
+    }>;
     styleId?: string;
     alignment?: TableAlignment;
     direction?: TableDirection;

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

@@ -10,6 +10,7 @@ export type { BaseDirection, WritingMode, SectionDirectionContext, TableDirectio
 export { getParagraphInlineDirection, getTableVisualDirection } from './direction-context.js';
 export { OOXML_PCT_DIVISOR, resolveTableWidthAttr, type TableWidthAttr, type TableColumnSpec, } from './engines/tables.js';
 export { effectiveTableCellSpacing } from './table-cell-spacing.js';
+export { isTableCellVectorOverlay } from './table-cell-vector-overlay.js';
 export { createHeaderFooterResolutionIndex, selectHeaderFooterVariantForPage, resolveEffectiveHeaderFooterRef, type HeaderFooterResolutionIndex, type HeaderFooterKind, type HeaderFooterVariant, type HeaderFooterSectionRefs, type HeaderFooterResolutionSection, type HeaderFooterVariantSelectionInput, type HeaderFooterEffectiveRefInput, type HeaderFooterEffectiveRefResult, } from './header-footer-resolution.js';
 export { rescaleColumnWidths } from './table-column-rescale.js';
 export { getCellSpacingPx } from './cell-spacing.js';

package/dist/layout-engine/contracts/src/table-cell-vector-overlay.d.ts

@@ -0,0 +1,2 @@
+import { FlowBlock } from './index.js';
+export declare function isTableCellVectorOverlay(block: FlowBlock): boolean;

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

@@ -147,3 +147,5 @@ export { resolveTrackedChangeDecorationFacts, syncTrackedDeletionBand, getTracke
 export { buildLinkRenderData } from './runs/links.js';
 export { INLINE_TRACKED_CHANGE_DEFAULTS } from './styles.js';
 export { resolveDecorationFragmentPosition } from './decoration-geometry.js';
+export { createChartElement } from './chart-renderer.js';
+export { convertOmmlToMathml } from './features/math/omml-to-mathml.js';

package/dist/public/ui-react.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui--kQBNTyt.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-FH5GSHph.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let react = require("react");
 let use_sync_external_store_shim = require("use-sync-external-store/shim");

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

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-CbEDXtpm.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-Cq8trPVC.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 import { useSyncExternalStore } from "use-sync-external-store/shim";

package/dist/public/ui-vue.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_create_super_doc_ui = require("../chunks/create-super-doc-ui--kQBNTyt.cjs");
+const require_create_super_doc_ui = require("../chunks/create-super-doc-ui-FH5GSHph.cjs");
 const require_slice_source = require("../chunks/slice-source-CFaqq0Vo.cjs");
 let superdoc_entry_vue = require("vue");
 //#region src/public/ui/vue.ts

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

@@ -1,4 +1,4 @@
-import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-CbEDXtpm.es.js";
+import { t as createSuperDocUI } from "../chunks/create-super-doc-ui-Cq8trPVC.es.js";
 import { t as toSliceSource } from "../chunks/slice-source-gfOhG2MW.es.js";
 import { computed, inject, onScopeDispose, provide, shallowRef, toRaw, toValue, watch } from "vue";
 //#region src/public/ui/vue.ts