superdoc 2.24.0-next.8 → 2.24.0

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.24.0-next.8",
+	superdocVersion: "2.24.0",
 	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.24.0-next.8",
+	superdocVersion: "2.24.0",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

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

@@ -101,11 +101,13 @@ export interface AuthorityEntryDomain {
 }
 export interface AuthoritiesMutationSuccess {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     authorities: AuthoritiesAddress;
 }
 export type AuthoritiesMutationResult = AuthoritiesMutationSuccess | AdapterMutationFailure;
 export interface AuthorityEntryMutationSuccess {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     entry: AuthorityEntryAddress;
 }
 export type AuthorityEntryMutationResult = AuthorityEntryMutationSuccess | AdapterMutationFailure;

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

@@ -82,6 +82,7 @@ export interface BookmarkDomain {
 }
 export interface BookmarkMutationSuccess {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     bookmark: BookmarkAddress;
 }
 export type BookmarkMutationResult = BookmarkMutationSuccess | AdapterMutationFailure;

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

@@ -51,6 +51,7 @@ export interface CaptionDomain {
 }
 export interface CaptionMutationSuccess {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     caption: CaptionAddress;
 }
 export type CaptionMutationResult = CaptionMutationSuccess | AdapterMutationFailure;

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

@@ -144,6 +144,7 @@ export interface BibliographyInfo {
 }
 export interface CitationMutationSuccess {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     citation: CitationAddress;
 }
 export type CitationMutationResult = CitationMutationSuccess | AdapterMutationFailure;
@@ -154,6 +155,7 @@ export interface CitationSourceMutationSuccess {
 export type CitationSourceMutationResult = CitationSourceMutationSuccess | AdapterMutationFailure;
 export interface BibliographyMutationSuccess {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     bibliography: BibliographyAddress;
 }
 export type BibliographyMutationResult = BibliographyMutationSuccess | AdapterMutationFailure;

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

@@ -156,6 +156,7 @@ export interface ContentControlInfo {
 }
 export interface ContentControlMutationSuccess {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     contentControl: ContentControlTarget;
     updatedRef?: ContentControlTarget;
     affectedStories?: StoryLocator[];

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

@@ -40,6 +40,15 @@ export declare const OPERATION_DEFINITIONS: {
         readonly referenceDocPath: "styles/apply.mdx";
         readonly referenceGroup: "styles";
     };
+    readonly 'styles.create': {
+        readonly memberPath: "styles.create";
+        readonly description: "Define or redefine a named paragraph or character style in the Style Definitions part. Replaces the definition rather than merging into it, and decides conflicts on both styleId and name, because Word keys its Styles gallery on the name. Linked style pairs and table/numbering styles are out of scope.";
+        readonly expectedResult: "Returns a StylesCreateReceipt reporting whether the style was created or redefined, with per-channel before/after state for the paragraph and run properties.";
+        readonly requiresDocumentContext: true;
+        readonly metadata: CommandStaticMetadata;
+        readonly referenceDocPath: "styles/create.mdx";
+        readonly referenceGroup: "styles";
+    };
     readonly 'styles.getCatalog': {
         readonly memberPath: "styles.getCatalog";
         readonly description: "List the available styles as a normalized catalogue with stable IDs, display names, type, visibility, priority, provenance, and source diagnostics. Supports view (quickGallery/recommended/currentDocument/all/inUse), type filtering, hidden/latent inclusion, usage rollups, and UI-safe preview tokens. Distinct from DocumentInfo.styles, which is a usage summary.";
@@ -49,6 +58,15 @@ export declare const OPERATION_DEFINITIONS: {
         readonly referenceDocPath: "styles/get-catalog.mdx";
         readonly referenceGroup: "styles";
     };
+    readonly 'styles.getTheme': {
+        readonly memberPath: "styles.getTheme";
+        readonly description: "Read the document theme: its 12 theme colors, major and minor fonts, and the color mapping from settings.xml. A missing or malformed theme part returns the default Office theme labeled source 'fallback', with part status and diagnostics. Same theme as doc.get().theme, without the rest of the document.";
+        readonly expectedResult: "Returns a StylesGetThemeResult with the theme (always present, labeled document or fallback), the theme and settings part status, and diagnostics.";
+        readonly requiresDocumentContext: true;
+        readonly metadata: CommandStaticMetadata;
+        readonly referenceDocPath: "styles/get-theme.mdx";
+        readonly referenceGroup: "styles";
+    };
     readonly 'templates.apply': {
         readonly memberPath: "templates.apply";
         readonly description: "Apply detected DOCX template/substrate (styles, numbering, settings, theme, font table, web settings, headers/footers, section defaults) from a source package onto the current document, preserving body content. Scopes are auto-detected from source package evidence.";
@@ -3590,9 +3608,6 @@ export declare const OPERATION_DEFINITIONS: {
     readonly "format.border": OperationDefinitionEntry & {
         memberPath: "format.border";
     };
-    readonly "format.fitText": OperationDefinitionEntry & {
-        memberPath: "format.fitText";
-    };
     readonly "format.dstrike": OperationDefinitionEntry & {
         memberPath: "format.dstrike";
     };
@@ -3620,6 +3635,9 @@ export declare const OPERATION_DEFINITIONS: {
     readonly "format.kerning": OperationDefinitionEntry & {
         memberPath: "format.kerning";
     };
+    readonly "format.fitText": OperationDefinitionEntry & {
+        memberPath: "format.fitText";
+    };
     readonly "format.rStyle": OperationDefinitionEntry & {
         memberPath: "format.rStyle";
     };
@@ -3650,7 +3668,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.";
+        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 requiresDocumentContext: true;
         readonly metadata: CommandStaticMetadata;
         readonly referenceDocPath: "get.mdx";

package/dist/document-api/src/cross-refs/cross-refs.types.d.ts

@@ -62,6 +62,7 @@ export interface CrossRefDomain {
 }
 export interface CrossRefMutationSuccess {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     crossRef: CrossRefAddress;
 }
 export type CrossRefMutationResult = CrossRefMutationSuccess | AdapterMutationFailure;

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

@@ -84,6 +84,7 @@ export interface FieldDomain {
 }
 export interface FieldMutationSuccess {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     field: FieldAddress;
 }
 export type FieldMutationResult = FieldMutationSuccess | AdapterMutationFailure;

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

@@ -94,11 +94,13 @@ export interface FootnoteDomain {
 }
 export interface FootnoteMutationSuccess {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     footnote: FootnoteAddress;
 }
 export type FootnoteMutationResult = FootnoteMutationSuccess | AdapterMutationFailure;
 export interface FootnoteConfigSuccess {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
 }
 export type FootnoteConfigResult = FootnoteConfigSuccess | AdapterMutationFailure;
 export type FootnotesListResult = DiscoveryOutput<FootnoteDomain>;

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

@@ -14,6 +14,7 @@ export interface GetAdapter {
  *
  * @param adapter - Engine-specific get adapter.
  * @param input - Canonical get input object.
- * @returns An SDDocument with body content projected into SDM/1 canonical shapes.
+ * @returns An SDDocument with body content projected into SDM/1 canonical shapes,
+ *   plus the document's authored styles, theme, docDefaults and diagnostics.
  */
 export declare function executeGet(adapter: GetAdapter, input: SDGetInput): SDDocument;

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

@@ -76,6 +76,7 @@ export interface HyperlinkInfo {
 }
 export interface HyperlinkMutationSuccess {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     hyperlink: HyperlinkTarget;
 }
 export interface HyperlinkMutationFailure {

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

@@ -188,6 +188,7 @@ export interface SetZOrderInput {
 }
 export interface CreateImageSuccessResult {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     image: ImageAddress;
     trackedChangeRefs?: ReceiptInsert[];
     /** Commit id for the insertion, including its alt text when that was set in the same call. */
@@ -207,6 +208,7 @@ export interface ImagesListResult {
 }
 export interface ImagesMutationSuccessResult {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     image: ImageAddress;
     trackedChangeRefs?: ReceiptInsert[];
 }

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

@@ -113,11 +113,13 @@ export interface IndexEntryDomain {
 }
 export interface IndexMutationSuccess {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     index: IndexAddress;
 }
 export type IndexMutationResult = IndexMutationSuccess | AdapterMutationFailure;
 export interface IndexEntryMutationSuccess {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     entry: IndexEntryAddress;
 }
 export type IndexEntryMutationResult = IndexEntryMutationSuccess | AdapterMutationFailure;

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

@@ -4,7 +4,7 @@ import { DeleteInput } from './delete/delete.js';
 import { FindAdapter } from './find/find.js';
 import { SDFindInput, SDFindResult, SDGetInput, SDNodeResult } from './types/sd-envelope.js';
 import { FormatApi, FormatRangeInput } from './format/format.js';
-import { StylesAdapter, StylesApi } from './styles/index.js';
+import { StylesAdapter, StylesApi, StylesCreateAdapter, StylesCreateApi } from './styles/index.js';
 import { TemplatesAdapter, TemplatesApi } from './templates/index.js';
 import { GetNodeAdapter, GetNodeByIdInput } from './get-node/get-node.js';
 import { GetAdapter } from './get/get.js';
@@ -112,8 +112,10 @@ export type { FormatInlineAliasApi, FormatInlineAliasInput, FormatBoldInput, For
 export type { InlineRunPatch, InlineRunPatchKey, InlinePropertyStorage, InlinePropertyType, InlinePropertyCarrier, InlinePropertyRegistryEntry, UnderlinePatch, ShadingPatch, BorderPatch, FitTextPatch, LangPatch, RFontsPatch, EastAsianLayoutPatch, StylisticSetPatch, } from './format/inline-run-patch.js';
 export { INLINE_PROPERTY_REGISTRY, INLINE_PROPERTY_KEY_SET, INLINE_PROPERTY_BY_KEY, INLINE_PROPERTY_KEYS_BY_STORAGE, validateInlineRunPatch, buildInlineRunPatchSchema, } from './format/inline-run-patch.js';
 export { PROPERTY_REGISTRY, EXCLUDED_KEYS, ALLOWED_KEYS_BY_CHANNEL, getPropertyDefinition, toJsonSchema, buildPatchSchema, buildStateSchema, } from './styles/index.js';
-export type { ValueSchema, MergeStrategy, PropertyDefinition, StylesAdapter, StylesApplyInput, StylesApplyRunInput, StylesApplyParagraphInput, StylesApplyOptions, StylesApplyReceipt, StylesBooleanState, StylesNumberState, StylesEnumState, StylesObjectState, StylesArrayState, StylesStateMap, StylesChannel, StylesRunPatch, StylesParagraphPatch, StylesTargetResolution, StylesApplyReceiptSuccess, StylesApplyReceiptFailure, NormalizedStylesApplyOptions, StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogDiagnosticSeverity, StyleSourcePartStatus, StyleCatalogUsageStatus, StyleCatalogPreviewStatus, StyleCatalogViewStatus, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, StylesGetCatalogAdapter, } from './styles/index.js';
-export { STYLE_CATALOG_VIEWS, STYLE_CATALOG_FILTER_TYPES, executeStylesGetCatalog, validateStylesGetCatalogInput, } from './styles/index.js';
+export type { ValueSchema, MergeStrategy, PropertyDefinition, StylesAdapter, StylesApplyInput, StylesApplyRunInput, StylesApplyParagraphInput, StylesApplyOptions, StylesApplyReceipt, StylesBooleanState, StylesNumberState, StylesEnumState, StylesObjectState, StylesArrayState, StylesStateMap, StylesChannel, StylesRunPatch, StylesParagraphPatch, StylesTargetResolution, StylesApplyReceiptSuccess, StylesApplyReceiptFailure, NormalizedStylesApplyOptions, StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogDiagnosticSeverity, StyleSourcePartStatus, StyleCatalogUsageStatus, StyleCatalogPreviewStatus, StyleCatalogViewStatus, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogPreviewFontSource, StyleCatalogPreviewColorSource, StyleCatalogPreviewSources, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, StylesGetCatalogAdapter, StylesGetThemeInput, StylesThemeSourceStatus, StylesGetThemeResult, StylesGetThemeAdapter, } from './styles/index.js';
+export { STYLE_CATALOG_VIEWS, STYLE_CATALOG_FILTER_TYPES, executeStylesGetCatalog, validateStylesGetCatalogInput, executeStylesGetTheme, validateStylesGetThemeInput, } from './styles/index.js';
+export type { StylesScope, StyleRunPatch, StyleConflictPolicy, StyleChannelState, StylesCreateAdapter, StylesCreateApi, StylesCreateInput, StylesCreateParagraphInput, StylesCreateCharacterInput, StylesCreateOptions, NormalizedStylesCreateOptions, StylesCreateResolution, StylesCreateReceipt, StylesCreateReceiptSuccess, StylesCreateReceiptFailure, } from './styles/index.js';
+export { STYLE_EXCLUDED_KEYS, EXCLUDED_KEYS_BY_SCOPE, SCOPE_LABEL, STYLE_XML_PATH, executeStylesCreate, validateStylesCreateInput, validateStylesCreateOptions, validatePatchObject, } from './styles/index.js';
 export type { TemplatesAdapter, TemplatesApi, TemplatesApplyInput, TemplatesApplyOptions, TemplatesApplySource, TemplatesApplySourcePath, TemplatesApplySourceBase64, TemplateBodyPolicy, TemplateScope, NormalizedTemplatesApplyOptions, TemplateScopeReport, TemplateSkipReason, TemplateScopeSkip, TemplateUnsupportedItem, TemplateChangeKind, TemplateChangedPart, TemplateIdMapping, TemplateApplyWarning, TemplatesApplySourceInfo, TemplatesApplyReceiptSuccess, TemplatesApplyFailureCode, TemplatesApplyReceiptFailure, TemplatesApplyReceipt, } from './templates/index.js';
 export { executeTemplatesApply } from './templates/index.js';
 export type { CreateAdapter, CreateApi } from './create/create.js';
@@ -280,7 +282,8 @@ export interface DocumentApiSurface {
     /**
      * Read the full document as an SDDocument structure.
      * @param input - Get input with optional read options.
-     * @returns An SDDocument with body content projected into SDM/1 canonical shapes.
+     * @returns An SDDocument with body content projected into SDM/1 canonical shapes,
+     *   plus the document's authored styles, theme, docDefaults and diagnostics.
      */
     get(input: SDGetInput): SDDocument;
     /**
@@ -373,7 +376,7 @@ export interface DocumentApiSurface {
     /**
      * Stylesheet operations (docDefaults, style definitions, paragraph style references).
      */
-    styles: StylesApi & {
+    styles: StylesApi & StylesCreateApi & {
         paragraph: ParagraphStylesApi;
     };
     /**
@@ -560,7 +563,7 @@ export interface DocumentApiAdapters {
     comments: CommentsAdapter;
     write: WriteAdapter;
     selectionMutation: SelectionMutationAdapter;
-    styles: StylesAdapter;
+    styles: StylesAdapter & Partial<StylesCreateAdapter>;
     templates: TemplatesAdapter;
     trackChanges: TrackChangesAdapter;
     create: CreateAdapter;

package/dist/document-api/src/inline-semantics/token-sets.d.ts

@@ -32,3 +32,14 @@ export declare const ST_THEME_COLOR_VALUES: readonly ["dark1", "light1", "dark2"
 export type StThemeColorValue = (typeof ST_THEME_COLOR_VALUES)[number];
 /** Runtime set for O(1) ST_ThemeColor validation. */
 export declare const ST_THEME_COLOR_VALUE_SET: ReadonlySet<string>;
+/**
+ * Accepted `w:val` values for `w:highlight`. A closed enumeration, unlike a
+ * colour value: anything outside it produces a document Word offers to repair.
+ *
+ * No `StHighlightValue` alias beside it, unlike the sets above:
+ * {@link SDHighlightColor} in `types/sd-props.ts` is already derived from this
+ * list, and a second name for one union is a second thing to keep in step.
+ */
+export declare const ST_HIGHLIGHT_VALUES: readonly ["black", "blue", "cyan", "green", "magenta", "red", "yellow", "white", "darkBlue", "darkCyan", "darkGreen", "darkMagenta", "darkRed", "darkYellow", "darkGray", "lightGray", "none"];
+/** Runtime set for O(1) ST_HighlightColor validation. */
+export declare const ST_HIGHLIGHT_VALUE_SET: ReadonlySet<string>;

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

@@ -358,12 +358,14 @@ export interface ListsCaptureTemplateSuccessResult {
 export type ListsCaptureTemplateResult = ListsCaptureTemplateSuccessResult | ListsFailureResult;
 export interface ListsInsertSuccessResult {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     item: ListItemAddress;
     insertionPoint: TextAddress;
     trackedChangeRefs?: ReceiptInsert[];
 }
 export interface ListsMutateItemSuccessResult {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     item: ListItemAddress;
     /** Tracked changes authored by this mutation when `changeMode` is tracked. */
     trackedChangeRefs?: ReceiptInsert[];
@@ -375,32 +377,38 @@ export interface ListsMutateItemSuccessResult {
 }
 export interface ListsCreateSuccessResult {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     listId: string;
     item: ListItemAddress;
 }
 export interface ListsJoinSuccessResult {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     listId: string;
 }
 export interface ListsSeparateSuccessResult {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     listId: string;
     numId: number;
 }
 export interface ListsMergeSuccessResult {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     listId: string;
     absorbedCount: number;
     removedEmptyBlocks: number;
 }
 export interface ListsSplitSuccessResult {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     listId: string;
     numId: number;
     restartedAt: number | null;
 }
 export interface ListsDetachSuccessResult {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     paragraph: {
         kind: 'block';
         nodeType: 'paragraph';
@@ -409,6 +417,7 @@ export interface ListsDetachSuccessResult {
 }
 export interface ListsConvertToTextSuccessResult {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     paragraph: {
         kind: 'block';
         nodeType: 'paragraph';
@@ -440,6 +449,7 @@ export type ListsDetachResult = ListsDetachSuccessResult | ListsFailureResult;
 export type ListsConvertToTextResult = ListsConvertToTextSuccessResult | ListsFailureResult;
 export interface ListsDeleteSuccessResult {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     /** Number of list items removed. */
     deletedCount: number;
 }

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

@@ -1,6 +1,7 @@
 import { BlockNodeAddress } from '../types/base.js';
 import { ReceiptFailure, ReceiptInsert } from '../types/receipt.js';
 import { SDRunProps } from '../types/sd-props.js';
+import { ChangeMode } from '../write/write.js';
 export type ParagraphBlockType = 'paragraph' | 'heading' | 'listItem';
 export type ParagraphTarget = BlockNodeAddress & {
     nodeType: ParagraphBlockType;
@@ -12,6 +13,8 @@ export interface ParagraphMutationSuccess {
     success: true;
     target: ParagraphTarget;
     resolution: MutationResolution;
+    /** Mode applied to committed paragraph content; omitted when no content was committed. */
+    appliedChangeMode?: ChangeMode;
     /** Logical tracked-change entities created or revised by this mutation. */
     trackedChangeRefs?: ReceiptInsert[];
 }

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

@@ -7,6 +7,7 @@ export interface MutationReceiptBridgeContext {
     conversion?: SDMutationConversionReport;
 }
 interface CanonicalSuccessMetadata {
+    appliedChangeMode?: ReceiptSuccess['appliedChangeMode'];
     id?: ReceiptSuccess['id'];
     inserted?: ReceiptSuccess['inserted'];
     updated?: ReceiptSuccess['updated'];

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

@@ -1,4 +1,4 @@
-import { BlockNodeAddress, ReceiptFailure } from '../types/index.js';
+import { BlockNodeAddress, ChangeMode, ReceiptFailure } from '../types/index.js';
 import { DiscoveryOutput } from '../types/discovery.js';
 export type SectionAddress = {
     kind: 'section';
@@ -112,6 +112,8 @@ export type SectionsListResult = DiscoveryOutput<SectionDomain>;
 export interface SectionMutationSuccessResult {
     success: true;
     section: SectionAddress;
+    /** Committed review-aware content mode; omitted for dry runs, no-ops and non-reviewable settings. */
+    appliedChangeMode?: ChangeMode;
 }
 export interface SectionMutationFailureResult {
     success: false;
@@ -128,6 +130,7 @@ export interface DocumentMutationSuccessResult {
 export type DocumentMutationResult = DocumentMutationSuccessResult | SectionMutationFailureResult;
 export interface CreateSectionBreakSuccessResult {
     success: true;
+    appliedChangeMode?: 'direct' | 'tracked';
     section: SectionAddress;
     /**
      * Present only when the break is represented as a dedicated paragraph.

package/dist/document-api/src/styles/apply.d.ts

@@ -1,6 +1,7 @@
 import { ReceiptFailure } from '../types/receipt.js';
 import { StylesChannel } from './registry.js';
 import { StylesGetCatalogInput, StylesGetCatalogResult } from './catalog.js';
+import { StylesGetThemeInput, StylesGetThemeResult } from './theme.js';
 /** Tri-state for OOXML boolean style properties. */
 export type StylesBooleanState = 'on' | 'off' | 'inherit';
 export type StylesNumberState = number | 'inherit';
@@ -123,6 +124,8 @@ export interface StylesAdapter {
     apply(input: StylesApplyInput, options: NormalizedStylesApplyOptions): StylesApplyReceipt;
     /** Read the normalized style catalogue. See `styles/catalog.ts`. */
     getCatalog?(input?: StylesGetCatalogInput): StylesGetCatalogResult;
+    /** Read the document theme. See `styles/theme.ts`. */
+    getTheme?(input?: StylesGetThemeInput): StylesGetThemeResult;
 }
 export interface NormalizedStylesApplyOptions {
     dryRun: boolean;
@@ -134,6 +137,8 @@ export interface StylesApi {
     apply(input: StylesApplyInput, options?: StylesApplyOptions): StylesApplyReceipt;
     /** Read the normalized style catalogue for discovery and quick-gallery UI. */
     getCatalog(input?: StylesGetCatalogInput): StylesGetCatalogResult;
+    /** Read the document theme: colors, fonts and color mapping. */
+    getTheme(input?: StylesGetThemeInput): StylesGetThemeResult;
 }
 /**
  * Executes `styles.apply` using the provided adapter.

package/dist/document-api/src/styles/catalog.d.ts

@@ -1,22 +1,4 @@
-/**
- * `styles.getCatalog`: read-only style catalogue projection.
- *
- * The catalogue is the stable, normalized, editor-neutral view of the styles
- * available in a document. It is the SDK / CLI / MCP / custom-UI integration
- * point for style discovery, and the source the built-in toolbar and the
- * future Styles pane consume.
- *
- * This module owns only the public contract types, input validation, and the
- * execution entry point. The runtime projection is produced by the v2 adapter
- * (which compiles a Word style model from package parts and calls the shared
- * style-model projector); the raw style-engine shapes never reach this public
- * surface.
- *
- * `DocumentInfo.styles` is a usage summary and intentionally stays separate
- * from this available-style catalogue.
- *
- * Engine-agnostic: no ProseMirror, Yjs, or converter imports.
- */
+import { SDThemeColorName, SDThemeFontRef } from '../types/sd-props.js';
 /** Catalogue view selector. `inUse` lists styles referenced by document content. */
 export type StyleCatalogView = 'quickGallery' | 'recommended' | 'currentDocument' | 'all' | 'inUse';
 /** Normalized style kind. `linked` is a deduplicated paragraph/character pair. */
@@ -60,10 +42,47 @@ export interface StyleCatalogItemUsage {
     tableCount?: number;
     numberingCount?: number;
 }
+/**
+ * Where a preview font came from. `theme` names the theme font slot it was
+ * resolved from; `fallback: true` means the document has no usable theme and
+ * the value is the default Office theme's.
+ */
+export type StyleCatalogPreviewFontSource = {
+    origin: 'literal';
+} | {
+    origin: 'theme';
+    themeFont: SDThemeFontRef;
+    fallback?: true;
+};
+/**
+ * Where a preview color came from. `theme` names the theme color and the
+ * tint/shade bytes (0-255) applied to it, as in `SDColorRef`.
+ */
+export type StyleCatalogPreviewColorSource = {
+    origin: 'literal';
+} | {
+    origin: 'theme';
+    themeColor: SDThemeColorName;
+    tint?: number;
+    shade?: number;
+    fallback?: true;
+}
+/** The document sets no color (Word's automatic color); the value is the black text renders with. */
+ | {
+    origin: 'default';
+};
+/** Origin of the theme-capable preview tokens. A token without a source is absent from `css`. */
+export interface StyleCatalogPreviewSources {
+    fontFamily?: StyleCatalogPreviewFontSource;
+    color?: StyleCatalogPreviewColorSource;
+}
 /** Optional resolved preview tokens. Present when `includePreview` is requested. */
 export interface StyleCatalogItemPreview {
     available: boolean;
+    /** UI-safe CSS tokens. Theme fonts and colors are already resolved. */
     css?: Record<string, string | number>;
+    /** Whether `css.fontFamily` and `css.color` came from the theme or were set directly. */
+    sources?: StyleCatalogPreviewSources;
     unsupportedReason?: string;
 }
 /** One normalized style. Linked paragraph/character pairs are deduplicated. */
@@ -108,6 +127,8 @@ export interface StyleCatalogDiagnostic {
 export interface StyleCatalogSourceStatus {
     styles: StyleSourcePartStatus;
     settings: StyleSourcePartStatus;
+    /** The theme part that theme-backed preview fonts and colors resolve against. */
+    theme?: StyleSourcePartStatus;
     usage: StyleCatalogUsageStatus;
     preview: StyleCatalogPreviewStatus;
     view: StyleCatalogViewStatus;