superdoc 2.29.0-next.9 → 2.30.0-next.13

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

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

@@ -0,0 +1,26 @@
+import { ChangeRecord, ChangesActorsResult, ChangesGetInput, ChangesListInput, ChangesListResult, ChangesResolveInput, ChangesResolveResult, ChangesSnapshotInput, ChangesSnapshotResult } from './changes.types.js';
+export interface ChangesAdapter {
+    list(input: ChangesListInput): Promise<ChangesListResult>;
+    get(input: ChangesGetInput): Promise<ChangeRecord | null>;
+    resolve(input: ChangesResolveInput): Promise<ChangesResolveResult>;
+    actors(): Promise<ChangesActorsResult>;
+    snapshot(input: ChangesSnapshotInput): Promise<ChangesSnapshotResult>;
+}
+export interface ChangesApi {
+    list(input?: ChangesListInput): Promise<ChangesListResult>;
+    get(input: ChangesGetInput): Promise<ChangeRecord | null>;
+    resolve(input: ChangesResolveInput): Promise<ChangesResolveResult>;
+    actors(): Promise<ChangesActorsResult>;
+    snapshot(input?: ChangesSnapshotInput): Promise<ChangesSnapshotResult>;
+}
+export declare const CHANGES_LIST_LIMIT_MAX = 1000;
+export declare const CHANGES_WAIT_MS_MAX = 30000;
+export declare function validateChangesListInput(input: unknown): ChangesListInput;
+export declare function validateChangesGetInput(input: unknown): ChangesGetInput;
+export declare function validateChangesResolveInput(input: unknown): ChangesResolveInput;
+export declare function validateChangesSnapshotInput(input: unknown): ChangesSnapshotInput;
+export declare function executeChangesList(adapter: ChangesAdapter | undefined, input?: ChangesListInput): Promise<ChangesListResult>;
+export declare function executeChangesGet(adapter: ChangesAdapter | undefined, input: ChangesGetInput): Promise<ChangeRecord | null>;
+export declare function executeChangesResolve(adapter: ChangesAdapter | undefined, input: ChangesResolveInput): Promise<ChangesResolveResult>;
+export declare function executeChangesActors(adapter: ChangesAdapter | undefined): Promise<ChangesActorsResult>;
+export declare function executeChangesSnapshot(adapter: ChangesAdapter | undefined, input?: ChangesSnapshotInput): Promise<ChangesSnapshotResult>;

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

@@ -0,0 +1,156 @@
+import { StoryLocator } from '../types/story.types.js';
+export type ChangeCause = 'user' | 'api' | 'undo' | 'redo';
+export type ChangeProvenance = 'authored' | 'declared' | 'relayed' | 'unknown';
+export type ChangeOrigin = 'local' | 'remote';
+export type ChangeActorType = 'human' | 'code';
+export type ChangesIdentityState = 'configured' | 'missing';
+export type ChangeSidecarKind = 'comment' | 'trackedChange' | 'bookmark';
+export interface ChangeActor {
+    id: string | null;
+    name?: string;
+    email?: string;
+    claim?: string;
+}
+export interface ChangeTextRange {
+    start: number;
+    end: number;
+}
+export interface TextBlockChange {
+    kind: 'text';
+    story: StoryLocator;
+    blockId: string;
+    range: ChangeTextRange;
+    inserted: string;
+    deleted: string;
+}
+export interface FormatBlockChange {
+    kind: 'format';
+    story: StoryLocator;
+    blockId: string;
+    range: ChangeTextRange;
+    attributes: Record<string, unknown>;
+}
+export interface ParagraphBlockChange {
+    kind: 'paragraph';
+    story: StoryLocator;
+    blockId: string;
+    properties: Record<string, unknown>;
+}
+export interface SplitBlockChange {
+    kind: 'split';
+    story: StoryLocator;
+    blockId: string;
+    tailBlockId: string;
+    offset: number;
+}
+export interface MergeBlockChange {
+    kind: 'merge';
+    story: StoryLocator;
+    blockId: string;
+    mergedBlockId: string;
+}
+export interface MoveBlockChange {
+    kind: 'move';
+    story: StoryLocator;
+    blockId: string;
+    afterBlockId: string | null;
+}
+export interface CreateBlockChange {
+    kind: 'create';
+    story: StoryLocator;
+    blockId: string;
+    text: string;
+}
+export interface RemoveBlockChange {
+    kind: 'remove';
+    story: StoryLocator;
+    blockId: string;
+    text: string;
+}
+export interface TableBlockChange {
+    kind: 'table';
+    story: StoryLocator;
+    tableId: string;
+    detail: Record<string, unknown>;
+}
+export interface SidecarBlockChange {
+    kind: 'sidecar';
+    affects: ChangeSidecarKind;
+    ids: string[];
+}
+export type BlockChange = TextBlockChange | FormatBlockChange | ParagraphBlockChange | SplitBlockChange | MergeBlockChange | MoveBlockChange | CreateBlockChange | RemoveBlockChange | TableBlockChange | SidecarBlockChange;
+export interface ChangeRecordTimes {
+    declared: string | null;
+    observed: string;
+}
+export interface ChangeRecordSession {
+    id: string | null;
+    clientId: number;
+}
+export interface ChangeRecord {
+    id: string;
+    seq: number;
+    revision: string;
+    origin: ChangeOrigin;
+    actor: ChangeActor | null;
+    contributors?: ChangeActor[];
+    actorType: ChangeActorType | null;
+    cause: ChangeCause | null;
+    provenance: ChangeProvenance;
+    at: ChangeRecordTimes;
+    session: ChangeRecordSession;
+    changeTag?: string;
+    changes: BlockChange[];
+    update?: string;
+}
+export interface ChangesListInput {
+    after?: string;
+    limit?: number;
+    story?: StoryLocator;
+    blockId?: string;
+    actorId?: string;
+    includeUpdate?: boolean;
+    waitMs?: number;
+}
+export interface ChangesListResult {
+    items: ChangeRecord[];
+    cursor: string | null;
+    truncated: boolean;
+    identity: ChangesIdentityState;
+    collaboration: boolean;
+}
+export interface ChangesGetInput {
+    id: string;
+}
+export interface ChangesResolveInput {
+    blockId: string;
+    limit?: number;
+}
+export interface ChangesResolveResult {
+    blockId: string;
+    lineage: string[];
+    items: ChangeRecord[];
+}
+export interface ChangesActorBinding {
+    clientId: number;
+    actorId: string | null;
+    name?: string;
+    email?: string;
+    sessionId: string;
+    declaredAt: string;
+    claim?: string;
+}
+export interface ChangesActorsResult {
+    items: ChangesActorBinding[];
+}
+export interface ChangesSnapshotInput {
+    includeState?: boolean;
+}
+export interface ChangesSnapshotResult {
+    revision: string;
+    cursor: string | null;
+    lastChangeId: string | null;
+    stateVector: string;
+    state?: string;
+    at: string;
+}

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: ("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")[];
+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

@@ -1,5 +1,5 @@
 import { CommandStaticMetadata } from './metadata-types.js';
-export type ReferenceGroupKey = 'core' | 'blocks' | 'capabilities' | 'create' | 'sections' | 'format' | 'format.paragraph' | 'styles' | 'styles.paragraph' | 'templates' | 'lists' | 'comments' | 'trackChanges' | 'query' | 'mutations' | 'tables' | 'history' | 'toc' | 'images' | 'hyperlinks' | 'headerFooters' | 'watermarks' | 'contentControls' | 'bookmarks' | 'footnotes' | 'clipboard' | 'crossRefs' | 'index' | 'captions' | 'fields' | 'citations' | 'authorities' | 'ranges' | 'selection' | 'diff' | 'export' | 'protection' | 'permissionRanges' | 'customXml' | 'metadata';
+export type ReferenceGroupKey = 'core' | 'blocks' | 'capabilities' | 'create' | 'sections' | 'format' | 'format.paragraph' | 'styles' | 'styles.paragraph' | 'templates' | 'lists' | 'comments' | 'trackChanges' | 'query' | 'mutations' | 'tables' | 'history' | 'changes' | 'toc' | 'images' | 'hyperlinks' | 'headerFooters' | 'watermarks' | 'contentControls' | 'bookmarks' | 'footnotes' | 'clipboard' | 'crossRefs' | 'index' | 'captions' | 'fields' | 'citations' | 'authorities' | 'ranges' | 'selection' | 'diff' | 'export' | 'protection' | 'permissionRanges' | 'customXml' | 'metadata';
 export interface OperationDefinitionEntry {
     memberPath: string;
     description: string;
@@ -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";
@@ -1800,6 +1818,56 @@ export declare const OPERATION_DEFINITIONS: {
         readonly intentGroup: "edit";
         readonly intentAction: "redo";
     };
+    readonly 'changes.list': {
+        readonly memberPath: "changes.list";
+        readonly description: "List the change records this session retains, oldest first, with each change's actor, cause, provenance and affected blocks. Pass the returned cursor back as `after` to read only newer records; `waitMs` long-polls until at least one newer record exists.";
+        readonly expectedResult: "Returns a ChangesListResult with items (oldest to newest), a resume cursor, a truncated flag when records after `after` were evicted, the session identity state and whether the session is collaborative.";
+        readonly requiresDocumentContext: true;
+        readonly metadata: CommandStaticMetadata;
+        readonly referenceDocPath: "changes/list.mdx";
+        readonly referenceGroup: "changes";
+        readonly batchable: false;
+    };
+    readonly 'changes.get': {
+        readonly memberPath: "changes.get";
+        readonly description: "Get one retained change record by id.";
+        readonly expectedResult: "Returns the ChangeRecord with that id, or null when this session does not retain it.";
+        readonly requiresDocumentContext: true;
+        readonly metadata: CommandStaticMetadata;
+        readonly referenceDocPath: "changes/get.mdx";
+        readonly referenceGroup: "changes";
+        readonly batchable: false;
+    };
+    readonly 'changes.resolve': {
+        readonly memberPath: "changes.resolve";
+        readonly description: "List the retained change records that touched a block, following the blocks it was split from or merged with.";
+        readonly expectedResult: "Returns a ChangesResolveResult with the block id, its lineage (the block plus the blocks it was split from or merged with) and the matching records, oldest to newest.";
+        readonly requiresDocumentContext: true;
+        readonly metadata: CommandStaticMetadata;
+        readonly referenceDocPath: "changes/resolve.mdx";
+        readonly referenceGroup: "changes";
+        readonly batchable: false;
+    };
+    readonly 'changes.actors': {
+        readonly memberPath: "changes.actors";
+        readonly description: "List the identities that collaboration clients declared for this document. Identities and claims are declared by each client and are not verified by SuperDoc.";
+        readonly expectedResult: "Returns a ChangesActorsResult with one item per declared client binding: client id, actor id, optional name, email and claim, session id and declaration time.";
+        readonly requiresDocumentContext: true;
+        readonly metadata: CommandStaticMetadata;
+        readonly referenceDocPath: "changes/actors.mdx";
+        readonly referenceGroup: "changes";
+        readonly batchable: false;
+    };
+    readonly 'changes.snapshot': {
+        readonly memberPath: "changes.snapshot";
+        readonly description: "Capture the current revision, change cursor and collaboration state vector so a verifier can later replay or compare change records against this point.";
+        readonly expectedResult: "Returns a ChangesSnapshotResult with the revision, change cursor, last change id, base64 state vector, optional base64 full state and capture time.";
+        readonly requiresDocumentContext: true;
+        readonly metadata: CommandStaticMetadata;
+        readonly referenceDocPath: "changes/snapshot.mdx";
+        readonly referenceGroup: "changes";
+        readonly batchable: false;
+    };
     readonly 'create.image': {
         readonly memberPath: "create.image";
         readonly description: "Insert a new image at the target position.";
@@ -3717,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";
@@ -3736,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";
@@ -3745,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/create/create.d.ts

@@ -17,11 +17,7 @@ export interface CreateApi {
 export type CreateAdapter = CreateApi;
 export declare function normalizeCreateParagraphInput(input: CreateParagraphInput): CreateParagraphInput;
 export declare function executeCreateParagraph(adapter: CreateAdapter, input: CreateParagraphInput, options?: MutationOptions): CreateParagraphResult;
-export declare function normalizeCreateHeadingInput(input: CreateHeadingInput): CreateHeadingInput;
 export declare function executeCreateHeading(adapter: CreateAdapter, input: CreateHeadingInput, options?: MutationOptions): CreateHeadingResult;
-export declare function normalizeCreateTableInput(input: CreateTableInput): CreateTableInput;
 export declare function executeCreateTable(adapter: CreateAdapter, input: CreateTableInput, options?: MutationOptions): CreateTableResult;
-export declare function normalizeCreateSectionBreakInput(input: CreateSectionBreakInput): CreateSectionBreakInput;
 export declare function executeCreateSectionBreak(adapter: CreateAdapter, input: CreateSectionBreakInput, options?: MutationOptions): CreateSectionBreakResult;
-export declare function normalizeCreateTableOfContentsInput(input: CreateTableOfContentsInput): CreateTableOfContentsInput;
 export declare function executeCreateTableOfContents(adapter: CreateAdapter, input: CreateTableOfContentsInput, options?: MutationOptions): CreateTableOfContentsResult;

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

@@ -105,23 +105,23 @@ export interface DiffApplyResult {
     coverage: DiffCoverage;
     summary: DiffSummary;
     diagnostics: string[];
-    /** Style definitions applied directly; these changes remain when body revisions are rejected. */
+    /** Style policy used for this comparison. Tracked mode preserves unused proposal definitions after rejection. */
     styleChanges?: {
-        changeMode: 'direct';
+        changeMode: 'direct' | 'tracked';
         partUris: string[];
     };
 }
 /** Input for `diff.compare`. */
 export interface DiffCompareInput {
     targetSnapshot: DiffSnapshot;
-    /** Assess tracked eligibility with explicit consent to apply style definitions directly. */
-    styleChangeMode?: 'direct';
+    /** Directly adopt definitions, or review references to separate proposed styles. */
+    styleChangeMode?: 'direct' | 'tracked';
 }
 /** Input for `diff.apply`. */
 export interface DiffApplyInput {
     diff: DiffPayload;
-    /** Apply target style definitions directly, even when body changes are tracked. */
-    styleChangeMode?: 'direct';
+    /** Tracked styles require tracked application; direct styles persist after body rejection. */
+    styleChangeMode?: 'direct' | 'tracked';
 }
 /** How body content changes are applied. */
 export type DiffChangeMode = 'direct' | 'tracked';

package/dist/document-api/src/header-footers/header-footers.d.ts

@@ -1,6 +1,6 @@
 import { MutationOptions } from '../write/write.js';
 import { SectionMutationResult } from '../sections/sections.types.js';
-import { HeaderFooterKind, HeaderFooterVariant, HeaderFooterSlotAddress, HeaderFooterPartAddress, HeaderFooterSlotEntry, HeaderFooterResolveResult, HeaderFootersListQuery, HeaderFootersListResult, HeaderFootersGetInput, HeaderFootersResolveInput, HeaderFootersRefsSetInput, HeaderFootersRefsClearInput, HeaderFootersRefsSetLinkedToPreviousInput, HeaderFootersPartsListQuery, HeaderFootersPartsListResult, HeaderFootersPartsCreateInput, HeaderFootersPartsDeleteInput, HeaderFooterPartsMutationResult, HeaderFootersPageNumbersInsertInput, HeaderFooterPageNumbersInsertResult, HeaderFootersPageNumbersSetInput, HeaderFooterPageNumbersSetResult, HeaderFootersPageNumbersRemoveInput, HeaderFooterPageNumbersRemoveResult, HeaderFootersPageNumbersGetInput, HeaderFooterPageNumbersInfo } from './header-footers.types.js';
+import { HeaderFooterSlotAddress, HeaderFooterPartAddress, HeaderFooterSlotEntry, HeaderFooterResolveResult, HeaderFootersListQuery, HeaderFootersListResult, HeaderFootersGetInput, HeaderFootersResolveInput, HeaderFootersRefsSetInput, HeaderFootersRefsClearInput, HeaderFootersRefsSetLinkedToPreviousInput, HeaderFootersPartsListQuery, HeaderFootersPartsListResult, HeaderFootersPartsCreateInput, HeaderFootersPartsDeleteInput, HeaderFooterPartsMutationResult, HeaderFootersPageNumbersInsertInput, HeaderFooterPageNumbersInsertResult, HeaderFootersPageNumbersSetInput, HeaderFooterPageNumbersSetResult, HeaderFootersPageNumbersRemoveInput, HeaderFooterPageNumbersRemoveResult, HeaderFootersPageNumbersGetInput, HeaderFooterPageNumbersInfo } from './header-footers.types.js';
 export type { HeaderFooterKind, HeaderFooterVariant, HeaderFooterSlotAddress, HeaderFooterPartAddress, HeaderFooterSlotEntry, HeaderFooterResolveResult, HeaderFooterPartEntry, HeaderFootersListQuery, HeaderFootersListResult, HeaderFootersGetInput, HeaderFootersResolveInput, HeaderFootersRefsSetInput, HeaderFootersRefsClearInput, HeaderFootersRefsSetLinkedToPreviousInput, HeaderFootersPartsListQuery, HeaderFootersPartsListResult, HeaderFootersPartsCreateInput, HeaderFootersPartsDeleteInput, HeaderFooterPartsMutationResult, HeaderFooterRefsMutationResult, HeaderFooterRefsMutationSuccessResult, HeaderFooterRefsMutationFailureResult, HeaderFooterPartsMutationSuccessResult, HeaderFooterPartsMutationFailureResult, HeaderFooterPageNumberAlignment, HeaderFootersPageNumbersInsertInput, HeaderFooterPageNumbersInsertResult, HeaderFooterPageNumbersInsertSuccessResult, HeaderFooterPageNumbersInsertFailureResult, HeaderFootersPageNumbersNumberingInput, HeaderFootersPageNumbersSetInput, HeaderFooterPageNumbersSetResult, HeaderFootersPageNumbersRemoveInput, HeaderFooterPageNumbersRemoveResult, HeaderFooterPageNumbersRemoveSuccessResult, HeaderFootersPageNumbersGetInput, HeaderFooterPageNumberPlacement, HeaderFooterPageNumbersInfo, } from './header-footers.types.js';
 export interface HeaderFootersAdapter {
     list(query?: HeaderFootersListQuery): HeaderFootersListResult;
@@ -27,8 +27,6 @@ export interface HeaderFootersAdapter {
 export type HeaderFootersApi = Omit<HeaderFootersAdapter, 'pageNumbers'> & {
     pageNumbers: NonNullable<HeaderFootersAdapter['pageNumbers']>;
 };
-export declare function validateHeaderFooterKind(operationName: string, kind: unknown): asserts kind is HeaderFooterKind;
-export declare function validateHeaderFooterVariant(operationName: string, variant: unknown): asserts variant is HeaderFooterVariant;
 export declare function assertHeaderFooterSlotTarget(input: unknown, operationName: string): asserts input is {
     target: HeaderFooterSlotAddress;
 };