superdoc 2.24.0-next.9 → 2.25.0-next.1

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

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

@@ -1,7 +1,7 @@
 import { CommandCatalog, CommandStaticMetadata, OperationId } from './types.js';
 export declare const COMMAND_CATALOG: CommandCatalog;
 /** Operation IDs whose catalog entry has `mutates: true`. */
-export declare const MUTATING_OPERATION_IDS: ("replace" | "find" | "delete" | "selection.extractOoxml" | "selection.current" | "selection.releaseSnapshot" | "insert" | "info" | "projectHtml" | "projectMarkdown" | "capabilities.check" | "format.apply" | "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.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.";
@@ -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/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/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/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;

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

@@ -0,0 +1,160 @@
+import { ReceiptFailure } from '../types/receipt.js';
+import { SDHighlightColor } from '../types/sd-props.js';
+import { StylesParagraphPatch, StylesRunPatch, StylesStateMap } from './apply.js';
+/**
+ * Run properties of a named style.
+ *
+ * A superset of {@link StylesRunPatch}: the four properties Word forbids in
+ * `w:docDefaults` and allows on a `w:style` are reachable here and nowhere
+ * else. `rtl` in particular is the property that makes a run right-to-left, so
+ * without it no right-to-left style could be authored through this API.
+ */
+export interface StyleRunPatch extends StylesRunPatch {
+    /** `w:cs` — treat the run as complex-script. */
+    cs?: boolean;
+    /** `w:rtl` — right-to-left run. */
+    rtl?: boolean;
+    /** `w:oMath` — the run is part of an equation. */
+    oMath?: boolean;
+    /** `w:highlight` — one of the closed `ST_HighlightColor` tokens. */
+    highlight?: SDHighlightColor;
+}
+/** What to do when a style with this `id`, or this `name`, already exists. */
+export type StyleConflictPolicy = 'fail' | 'replace';
+interface StylesCreateCommon {
+    /** `w:styleId`. Named `id` to match {@link StyleCatalogItem.id} on read. */
+    id: string;
+    /** `w:name`. */
+    name: string;
+    /** `w:basedOn`. `null` states "based on nothing" explicitly. */
+    basedOn?: string | null;
+    /** `w:aliases`, one entry per alias. */
+    aliases?: string[];
+    /** `w:uiPriority`. Named `priority` to match the catalogue on read. */
+    priority?: number | null;
+    /** `w:qFormat` — offer the style in Word's quick gallery. */
+    qFormat?: boolean;
+    /** `w:hidden`. */
+    hidden?: boolean;
+    /** `w:semiHidden`. */
+    semiHidden?: boolean;
+    /** `w:unhideWhenUsed`. */
+    unhideWhenUsed?: boolean;
+    /** `w:locked`. */
+    locked?: boolean;
+    /**
+     * `w:customStyle`. Defaults to `true`, which is what a style authored
+     * through this API is. Setting it `false` on a style whose name is not a
+     * built-in makes Word treat the name as one and re-label or hide the style.
+     */
+    custom?: boolean;
+    /** Defaults to `'fail'`. */
+    conflictPolicy?: StyleConflictPolicy;
+}
+export interface StylesCreateParagraphInput extends StylesCreateCommon {
+    type: 'paragraph';
+    /** `w:next`. May name the style being created. */
+    next?: string | null;
+    /** `w:style/w:pPr`. */
+    paragraph?: StylesParagraphPatch;
+    /** `w:style/w:rPr`. */
+    run?: StyleRunPatch;
+}
+export interface StylesCreateCharacterInput extends StylesCreateCommon {
+    type: 'character';
+    /** A character style has no following-paragraph style. */
+    next?: never;
+    /** A character style has no paragraph properties. */
+    paragraph?: never;
+    /** `w:style/w:rPr`. */
+    run?: StyleRunPatch;
+}
+export type StylesCreateInput = StylesCreateParagraphInput | StylesCreateCharacterInput;
+export interface StylesCreateOptions {
+    dryRun?: boolean;
+    expectedRevision?: string;
+}
+export interface NormalizedStylesCreateOptions {
+    dryRun: boolean;
+    expectedRevision: string | undefined;
+}
+export interface StylesCreateResolution {
+    scope: 'style';
+    id: string;
+    type: 'paragraph' | 'character';
+    xmlPart: string;
+    /**
+     * Literal, not `string`: `styles.apply` pins its two paths in the published
+     * schema and exports them as constants for the adapter to bind to. Without
+     * the narrowing an adapter could report the more specific
+     * `w:styles/w:style[@w:styleId='X']`, type-check, and then fail the schema.
+     */
+    xmlPath: typeof STYLE_XML_PATH;
+}
+/** The `w:style` element path. Predicate-free, like `XML_PATH_BY_CHANNEL`. */
+export declare const STYLE_XML_PATH = "w:styles/w:style";
+/**
+ * Per-channel state, unlike {@link StylesApplyReceipt}'s flat map.
+ *
+ * `styles.apply` can be flat because `resolution.channel` says which channel
+ * the map describes. One `w:style` carries both at once, and `snapToGrid`,
+ * `shading` and `borders` exist on both — `borders` with genuinely different
+ * shapes (`w:bdr`, one border, against `w:pBdr`, six edges). Folded together
+ * they would be indistinguishable.
+ */
+export interface StyleChannelState {
+    paragraph: StylesStateMap | null;
+    run: StylesStateMap | null;
+}
+export interface StylesCreateReceiptSuccess {
+    success: true;
+    /** `false` when the definition already matched the input. */
+    changed: boolean;
+    /**
+     * `false` when an existing style was redefined under `conflictPolicy:
+     * 'replace'`. `created: true` implies `changed: true`. Under `dryRun` it
+     * describes what the call would have done.
+     *
+     * `ReceiptSuccess.inserted` / `updated` are deliberately not used: they take
+     * `EntityAddress`, and a style definition is not addressable as a document
+     * entity.
+     */
+    created: boolean;
+    resolution: StylesCreateResolution;
+    dryRun: boolean;
+    /** `null` when the style did not exist. */
+    before: StyleChannelState | null;
+    after: StyleChannelState;
+}
+export interface StylesCreateReceiptFailure {
+    success: false;
+    failure: ReceiptFailure;
+}
+export type StylesCreateReceipt = StylesCreateReceiptSuccess | StylesCreateReceiptFailure;
+export interface StylesCreateAdapter {
+    create(input: StylesCreateInput, options: NormalizedStylesCreateOptions): StylesCreateReceipt;
+}
+export interface StylesCreateApi {
+    create(input: StylesCreateInput, options?: StylesCreateOptions): StylesCreateReceipt;
+}
+/**
+ * Validates the shape of `styles.create` input.
+ *
+ * Deliberately shallow on identifiers: `id` is checked for "non-empty string"
+ * and nothing more, exactly as `styles.paragraph.setStyleRef` checks the same
+ * field. `w:styleId` is an `ST_String`, real documents carry ids with spaces,
+ * and a stricter rule here would mean `setStyleRef` could apply a style that
+ * `styles.create` cannot express.
+ */
+export declare function validateStylesCreateInput(input: unknown): asserts input is StylesCreateInput;
+export declare function validateStylesCreateOptions(options: unknown): void;
+/**
+ * Executes `styles.create` using the provided adapter.
+ *
+ * Fails closed when the host engine has no `create` hook, the same way
+ * `executeStylesGetCatalog` does for its optional catalogue hook — input is
+ * validated first, so a malformed call is reported as malformed rather than as
+ * an unavailable capability.
+ */
+export declare function executeStylesCreate(adapter: Partial<StylesCreateAdapter> | null | undefined, input: StylesCreateInput, options?: StylesCreateOptions): StylesCreateReceipt;
+export {};

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

@@ -3,12 +3,16 @@
  *
  * Public surface only: internal validation/schema helpers are not exposed.
  */
-export type { ValueSchema, StylesChannel, MergeStrategy, PropertyDefinition } from './registry.js';
-export { PROPERTY_REGISTRY, ALLOWED_KEYS_BY_CHANNEL, EXCLUDED_KEYS, XML_PATH_BY_CHANNEL, getPropertyDefinition, ST_VERTICAL_ALIGN_RUN, ST_EM, ST_TEXT_ALIGNMENT, ST_TEXT_DIRECTION, ST_TEXTBOX_TIGHT_WRAP, ST_TEXT_TRANSFORM, ST_JUSTIFICATION, } from './registry.js';
+export type { ValueSchema, StylesChannel, StylesScope, MergeStrategy, PropertyDefinition } from './registry.js';
+export { PROPERTY_REGISTRY, ALLOWED_KEYS_BY_CHANNEL, EXCLUDED_KEYS, STYLE_EXCLUDED_KEYS, EXCLUDED_KEYS_BY_SCOPE, SCOPE_LABEL, XML_PATH_BY_CHANNEL, getPropertyDefinition, ST_VERTICAL_ALIGN_RUN, ST_EM, ST_TEXT_ALIGNMENT, ST_TEXT_DIRECTION, ST_TEXTBOX_TIGHT_WRAP, ST_TEXT_TRANSFORM, ST_JUSTIFICATION, } from './registry.js';
 export { toJsonSchema, buildPatchSchema, buildStateSchema } from './schema.js';
 export type { StylesBooleanState, StylesNumberState, StylesEnumState, StylesObjectState, StylesArrayState, StylesRunPatch, StylesParagraphPatch, StylesTargetResolution, StylesApplyRunInput, StylesApplyParagraphInput, StylesApplyInput, StylesApplyOptions, StylesStateMap, StylesApplyReceiptSuccess, StylesApplyReceiptFailure, StylesApplyReceipt, StylesAdapter, NormalizedStylesApplyOptions, StylesApi, } from './apply.js';
 export { executeStylesApply } from './apply.js';
-export type { StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogDiagnosticSeverity, StyleSourcePartStatus, StyleCatalogUsageStatus, StyleCatalogPreviewStatus, StyleCatalogViewStatus, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, StylesGetCatalogAdapter, } from './catalog.js';
+export type { StyleRunPatch, StyleConflictPolicy, StyleChannelState, StylesCreateParagraphInput, StylesCreateCharacterInput, StylesCreateInput, StylesCreateOptions, NormalizedStylesCreateOptions, StylesCreateResolution, StylesCreateReceiptSuccess, StylesCreateReceiptFailure, StylesCreateReceipt, StylesCreateAdapter, StylesCreateApi, } from './create.js';
+export { STYLE_XML_PATH, executeStylesCreate, validateStylesCreateInput, validateStylesCreateOptions, } from './create.js';
+export type { StyleCatalogView, StyleCatalogItemType, StyleCatalogFilterType, StyleProvenance, StyleCatalogDiagnosticSeverity, StyleSourcePartStatus, StyleCatalogUsageStatus, StyleCatalogPreviewStatus, StyleCatalogViewStatus, StyleCatalogItemVisibility, StyleCatalogItemUsage, StyleCatalogItemPreview, StyleCatalogPreviewFontSource, StyleCatalogPreviewColorSource, StyleCatalogPreviewSources, StyleCatalogItem, StyleCatalogDefaults, StyleCatalogDiagnostic, StyleCatalogSourceStatus, StylesGetCatalogInput, StylesGetCatalogResult, StylesGetCatalogAdapter, } from './catalog.js';
 export { STYLE_CATALOG_VIEWS, STYLE_CATALOG_FILTER_TYPES, executeStylesGetCatalog, validateStylesGetCatalogInput, } from './catalog.js';
+export type { StylesGetThemeInput, StylesThemeSourceStatus, StylesGetThemeResult, StylesGetThemeAdapter, } from './theme.js';
+export { executeStylesGetTheme, validateStylesGetThemeInput } from './theme.js';
 export type { PatchKeyClassification } from './validation.js';
-export { validateValue, classifyPatchKey } from './validation.js';
+export { validateValue, classifyPatchKey, validatePatchObject } from './validation.js';

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

@@ -1,4 +1,4 @@
-import { ST_UNDERLINE_VALUES } from '../inline-semantics/token-sets.js';
+import { ST_HIGHLIGHT_VALUES, ST_UNDERLINE_VALUES } from '../inline-semantics/token-sets.js';
 export declare const ST_VERTICAL_ALIGN_RUN: readonly ["superscript", "subscript", "baseline"];
 export declare const ST_EM: readonly ["none", "dot", "comma", "circle", "sesame"];
 export declare const ST_TEXT_ALIGNMENT: readonly ["top", "center", "baseline", "bottom", "auto"];
@@ -6,7 +6,7 @@ export declare const ST_TEXT_DIRECTION: readonly ["lrTb", "tbRl", "btLr", "lrTbV
 export declare const ST_TEXTBOX_TIGHT_WRAP: readonly ["none", "allLines", "firstAndLastLine", "firstLineOnly", "lastLineOnly"];
 export declare const ST_TEXT_TRANSFORM: readonly ["uppercase", "none"];
 export declare const ST_JUSTIFICATION: readonly ["left", "center", "right", "justify", "distribute"];
-export { ST_UNDERLINE_VALUES };
+export { ST_HIGHLIGHT_VALUES, ST_UNDERLINE_VALUES };
 /** Recursive schema AST describing the shape of a property value. */
 export type ValueSchema = {
     kind: 'boolean';
@@ -41,3 +41,35 @@ export declare const ALLOWED_KEYS_BY_CHANNEL: Record<StylesChannel, Set<string>>
 export declare function getPropertyDefinition(key: string, channel: StylesChannel): PropertyDefinition | undefined;
 export declare const EXCLUDED_KEYS: Record<StylesChannel, Map<string, string>>;
 export declare const XML_PATH_BY_CHANNEL: Record<StylesChannel, string>;
+/**
+ * Where in `word/styles.xml` a patch is being written.
+ *
+ * The exclusion list is a property of the *destination*, not of the property:
+ * `w:rtl` is disallowed in `w:docDefaults` and perfectly legal on a named
+ * `w:style`. Before this split, `EXCLUDED_KEYS` was the docDefaults list and
+ * the only list, so every caller inherited a restriction that only one of
+ * them was subject to.
+ *
+ * `docDefaults` is unchanged and remains what `styles.apply` uses.
+ */
+export type StylesScope = 'docDefaults' | 'style';
+/**
+ * Keys excluded from a named `w:style`.
+ *
+ * Narrower than the docDefaults list on the run channel by exactly the four
+ * properties the style model reads back off a `w:style` (see the registry
+ * entries). `w:rPrChange` stays out because it is a revision-tracking wrapper
+ * around document content, and `w:rStyle` because the style model does not
+ * carry it on `StyleDefinition.runProperties`.
+ *
+ * The paragraph channel is unchanged: every key it excludes — `w:cnfStyle`,
+ * `w:divId`, `w:pPrChange`, `w:pStyle`, `w:pPr/w:rPr`, `w:sectPr` — is as
+ * out of place inside `w:style/w:pPr` as it is inside docDefaults. Run
+ * properties on a style live in `w:style/w:rPr`, which is the `run` channel
+ * here, not in `w:pPr/w:rPr`.
+ */
+export declare const STYLE_EXCLUDED_KEYS: Record<StylesChannel, Map<string, string>>;
+/** Exclusion lists by destination. Defaults everywhere are `docDefaults`. */
+export declare const EXCLUDED_KEYS_BY_SCOPE: Record<StylesScope, Record<StylesChannel, Map<string, string>>>;
+/** Human-readable destination, for validation messages. */
+export declare const SCOPE_LABEL: Record<StylesScope, string>;

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

@@ -1,9 +1,28 @@
-import { ValueSchema, StylesChannel } from './registry.js';
+import { ValueSchema, StylesChannel, StylesScope } from './registry.js';
 type JsonSchema = Record<string, unknown>;
 /** Converts a ValueSchema AST node to a JSON Schema object. */
 export declare function toJsonSchema(schema: ValueSchema): JsonSchema;
-/** Builds a JSON Schema for the patch object of a given channel. */
-export declare function buildPatchSchema(channel: StylesChannel): JsonSchema;
-/** Builds a JSON Schema for the before/after state map covering all registry keys. */
-export declare function buildStateSchema(): JsonSchema;
+/**
+ * Builds a JSON Schema for the patch object of a given channel and scope.
+ *
+ * The scope filter is what keeps the published `styles.apply` schema honest:
+ * the registry now carries run properties that only a named style accepts, and
+ * a schema that advertised them on `docDefaults` would describe an input the
+ * validator rejects.
+ */
+export declare function buildPatchSchema(channel: StylesChannel, scope?: StylesScope): JsonSchema;
+/**
+ * Builds a JSON Schema for the before/after state map of a given scope.
+ *
+ * Scoped for the same reason `buildPatchSchema` is: a receipt cannot report
+ * state for a property the scope does not accept, and advertising one both
+ * misleads a contract-driven caller and loosens receipt validation, since these
+ * objects carry `additionalProperties: false`.
+ *
+ * `channel` narrows it further, for a receipt that reports the two channels
+ * separately. Omitted, both fold into one map — correct only where something
+ * else in the receipt says which channel it describes, as `styles.apply`'s
+ * `resolution.channel` does.
+ */
+export declare function buildStateSchema(scope?: StylesScope, channel?: StylesChannel): JsonSchema;
 export {};

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

@@ -0,0 +1,32 @@
+import { SDTheme } from '../types/sd-styles.js';
+import { StyleCatalogDiagnostic, StyleSourcePartStatus } from './catalog.js';
+/** `styles.getTheme` takes no options. */
+export type StylesGetThemeInput = Record<string, never>;
+/**
+ * Status of the package parts the theme is read from. A `missing` or
+ * `malformed` theme part still yields a theme: the default Office theme,
+ * labeled `source: 'fallback'`.
+ */
+export interface StylesThemeSourceStatus {
+    theme: StyleSourcePartStatus;
+    /** `word/settings.xml`, which carries `w:clrSchemeMapping`. */
+    settings: StyleSourcePartStatus;
+}
+export interface StylesGetThemeResult {
+    /** Always present. `source` says whether it is the document's own theme or the Office fallback. */
+    theme: SDTheme & {
+        source: 'document' | 'fallback';
+    };
+    sourceStatus: StylesThemeSourceStatus;
+    diagnostics: StyleCatalogDiagnostic[];
+}
+export interface StylesGetThemeAdapter {
+    getTheme(input?: StylesGetThemeInput): StylesGetThemeResult;
+}
+/** Validates `styles.getTheme` input. `undefined` and `{}` are the only valid calls. */
+export declare function validateStylesGetThemeInput(input?: StylesGetThemeInput): void;
+/**
+ * Executes `styles.getTheme` using the provided adapter.
+ * Validates input, then delegates to the adapter.
+ */
+export declare function executeStylesGetTheme(adapter: Partial<StylesGetThemeAdapter> | null | undefined, input?: StylesGetThemeInput): StylesGetThemeResult;