superdoc 2.7.0-next.1 → 2.7.0-next.10

package/dist/chunks/{create-super-doc-ui-DCjm-_Xo.es.js → create-super-doc-ui-BTNVc3UD.es.js}

@@ -438,9 +438,8 @@ Object.freeze([
 * Classify the tracked-change identities carried by a v2 mutation event.
 *
 * Receipt entities are the durable invalidation contract between the document
-* kernel and derived review UI. Consumers apply removals/remaps locally; the
-* next committed window supplies surviving or restored rows. History follows
-* the same bounded path and never enumerates invisible review identities.
+* kernel and derived review UI. Direct receipts carry entity refs; mutation
+* plans carry the same identities through `trackedChanges` and per-step ids.
 */
 function getV2TrackedChangeMutationImpact(event) {
 	if (event?.type !== "mutation:committed") return null;
@@ -461,6 +460,11 @@ function getV2TrackedChangeMutationImpact(event) {
 	if (Array.isArray(payload.inserted)) payload.inserted.forEach((entry) => collectEntity(entry, upsertIds));
 	if (Array.isArray(payload.updated)) payload.updated.forEach((entry) => collectEntity(entry, upsertIds));
 	if (Array.isArray(payload.trackedChangeRefs)) payload.trackedChangeRefs.forEach((entry) => collectEntity(entry, upsertIds));
+	if (Array.isArray(payload.trackedChanges)) payload.trackedChanges.forEach((entry) => collectEntity(entry, upsertIds));
+	if (Array.isArray(payload.steps)) for (const step of payload.steps) {
+		if (!Array.isArray(step?.trackedChangeIds)) continue;
+		for (const id of step.trackedChangeIds) if (typeof id === "string" && id.length > 0) upsertIds.add(id);
+	}
 	if (Array.isArray(payload.removed)) payload.removed.forEach((entry) => collectEntity(entry, removedIds));
 	if (Array.isArray(payload.invalidatedRefs)) payload.invalidatedRefs.forEach((entry) => collectEntity(entry, removedIds));
 	if (Array.isArray(payload.remappedRefs)) for (const mapping of payload.remappedRefs) {

package/dist/chunks/{create-super-doc-ui-CwCvqMOa.cjs → create-super-doc-ui-C44xPZxz.cjs}

@@ -438,9 +438,8 @@ Object.freeze([
 * Classify the tracked-change identities carried by a v2 mutation event.
 *
 * Receipt entities are the durable invalidation contract between the document
-* kernel and derived review UI. Consumers apply removals/remaps locally; the
-* next committed window supplies surviving or restored rows. History follows
-* the same bounded path and never enumerates invisible review identities.
+* kernel and derived review UI. Direct receipts carry entity refs; mutation
+* plans carry the same identities through `trackedChanges` and per-step ids.
 */
 function getV2TrackedChangeMutationImpact(event) {
 	if (event?.type !== "mutation:committed") return null;
@@ -461,6 +460,11 @@ function getV2TrackedChangeMutationImpact(event) {
 	if (Array.isArray(payload.inserted)) payload.inserted.forEach((entry) => collectEntity(entry, upsertIds));
 	if (Array.isArray(payload.updated)) payload.updated.forEach((entry) => collectEntity(entry, upsertIds));
 	if (Array.isArray(payload.trackedChangeRefs)) payload.trackedChangeRefs.forEach((entry) => collectEntity(entry, upsertIds));
+	if (Array.isArray(payload.trackedChanges)) payload.trackedChanges.forEach((entry) => collectEntity(entry, upsertIds));
+	if (Array.isArray(payload.steps)) for (const step of payload.steps) {
+		if (!Array.isArray(step?.trackedChangeIds)) continue;
+		for (const id of step.trackedChangeIds) if (typeof id === "string" && id.length > 0) upsertIds.add(id);
+	}
 	if (Array.isArray(payload.removed)) payload.removed.forEach((entry) => collectEntity(entry, removedIds));
 	if (Array.isArray(payload.invalidatedRefs)) payload.invalidatedRefs.forEach((entry) => collectEntity(entry, removedIds));
 	if (Array.isArray(payload.remappedRefs)) for (const mapping of payload.remappedRefs) {

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

package/dist/collaboration-upgrade-engine.es.js

@@ -18,7 +18,7 @@ var COLLABORATION_UPGRADE_ENGINE_MINIMUM_NODE_MAJOR = 20;
 var PRIVATE_ENGINE_INFO = getCollaborationUpgradeEngineInfo$1();
 var ENGINE_INFO = Object.freeze({
 	...PRIVATE_ENGINE_INFO,
-	superdocVersion: "2.7.0-next.1",
+	superdocVersion: "2.7.0-next.10",
 	roomSchemaVersion: Object.freeze({ ...PRIVATE_ENGINE_INFO.roomSchemaVersion }),
 	supportedBundleVersions: SUPPORTED_COLLABORATION_UPGRADE_BUNDLE_VERSIONS,
 	supportedV1ReaderContractVersions: SUPPORTED_V1_READER_CONTRACT_VERSIONS

package/dist/document-api/src/content-projection/validation.d.ts

@@ -0,0 +1,3 @@
+import { SDProjectionReadInput } from '../types/content-projection.js';
+export declare function validateProjectionReadInput(input: unknown, operationName: string, allowedFields: ReadonlySet<string>): asserts input is SDProjectionReadInput;
+export declare function validateOptionalBoolean(value: unknown, field: string, operationName: string): void;

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" | "get" | "insert" | "info" | "format.apply" | "blocks.split" | "blocks.merge" | "blocks.move" | "lists.getState" | "lists.apply" | "lists.continue" | "lists.restart" | "lists.remove" | "format.paragraph.setMarkRunProps" | "tables.moveRow" | "format.bold" | "format.strike" | "format.color" | "format.italic" | "format.rtl" | "format.cs" | "format.shading" | "format.fontFamily" | "format.lang" | "format.fontSize" | "format.fontSizeCs" | "format.highlight" | "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.position" | "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" | "getNode" | "getNodeById" | "getText" | "getMarkdown" | "getHtml" | "markdownToFragment" | "htmlToFragment" | "extract" | "clearContent" | "formatRange" | "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" | "selection.current" | "mutations.preview" | "mutations.apply" | "plan.execute" | "capabilities.get" | "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" | "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" | "get" | "insert" | "info" | "format.apply" | "blocks.split" | "blocks.merge" | "blocks.move" | "lists.getState" | "lists.apply" | "lists.continue" | "lists.restart" | "lists.remove" | "format.paragraph.setMarkRunProps" | "tables.moveRow" | "format.bold" | "format.strike" | "format.color" | "format.italic" | "format.rtl" | "format.cs" | "format.shading" | "format.fontFamily" | "format.lang" | "format.fontSize" | "format.fontSizeCs" | "format.highlight" | "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.position" | "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" | "getNode" | "getNodeById" | "getText" | "getMarkdown" | "getHtml" | "projectMarkdown" | "projectHtml" | "markdownToFragment" | "htmlToFragment" | "extract" | "clearContent" | "formatRange" | "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" | "selection.current" | "mutations.preview" | "mutations.apply" | "plan.execute" | "capabilities.get" | "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" | "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

@@ -3481,6 +3481,28 @@ export declare const OPERATION_DEFINITIONS: {
         readonly intentGroup: "get_content";
         readonly intentAction: "html";
     };
+    readonly projectMarkdown: {
+        readonly memberPath: "projectMarkdown";
+        readonly description: "Project document content as Markdown with review, scope, diagnostics, and provenance metadata.";
+        readonly expectedResult: "Returns a Promise resolving to a detailed Markdown content projection result.";
+        readonly requiresDocumentContext: true;
+        readonly metadata: CommandStaticMetadata;
+        readonly referenceDocPath: "project-markdown.mdx";
+        readonly referenceGroup: "core";
+        readonly intentGroup: "get_content";
+        readonly intentAction: "markdown_projection";
+    };
+    readonly projectHtml: {
+        readonly memberPath: "projectHtml";
+        readonly description: "Project document content as HTML with review, scope, diagnostics, and provenance metadata.";
+        readonly expectedResult: "Returns a Promise resolving to a detailed HTML content projection result.";
+        readonly requiresDocumentContext: true;
+        readonly metadata: CommandStaticMetadata;
+        readonly referenceDocPath: "project-html.mdx";
+        readonly referenceGroup: "core";
+        readonly intentGroup: "get_content";
+        readonly intentAction: "html_projection";
+    };
     readonly markdownToFragment: {
         readonly memberPath: "markdownToFragment";
         readonly description: "Convert a Markdown string into an SDM/1 structural fragment.";

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

@@ -11,6 +11,7 @@ import { GetNodeByIdInput } from '../get-node/get-node.js';
 import { GetTextInput } from '../get-text/get-text.js';
 import { GetMarkdownInput } from '../get-markdown/get-markdown.js';
 import { GetHtmlInput } from '../get-html/get-html.js';
+import { ProjectHtmlInput, ProjectMarkdownInput, SDContentProjectionResult } from '../types/content-projection.js';
 import { MarkdownToFragmentInput } from '../markdown-to-fragment/markdown-to-fragment.js';
 import { HtmlToFragmentInput } from '../html-to-fragment/html-to-fragment.js';
 import { InfoInput } from '../info/info.js';
@@ -103,6 +104,16 @@ export interface OperationRegistry extends FormatInlineAliasOperationRegistry {
         options: never;
         output: string;
     };
+    projectMarkdown: {
+        input: ProjectMarkdownInput;
+        options: never;
+        output: Promise<SDContentProjectionResult<'markdown'>>;
+    };
+    projectHtml: {
+        input: ProjectHtmlInput;
+        options: never;
+        output: Promise<SDContentProjectionResult<'html'>>;
+    };
     markdownToFragment: {
         input: MarkdownToFragmentInput;
         options: never;

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

@@ -1,10 +1,10 @@
-import { StoryLocator } from '../types/story.types.js';
-export interface GetHtmlInput {
-    /** Restrict the read to a specific story. Omit for body (backward compatible). */
-    in?: StoryLocator;
+import { SDProjectionReadInput } from '../types/content-projection.js';
+export interface GetHtmlInput extends SDProjectionReadInput {
     /**
-     * Convert SuperDoc's internal flat-list representation to proper nested
-     * `<ol>`/`<ul>` HTML. Defaults to `true`.
+     * Accepted for compatibility and ignored by V2. V2 always emits canonical
+     * nested semantic lists.
+     *
+     * @deprecated replaceWith=canonical nested V2 output compat-indefinitely=existing callers may keep passing the option
      */
     unflattenLists?: boolean;
 }

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

@@ -1,7 +1,5 @@
-import { StoryLocator } from '../types/story.types.js';
-export interface GetMarkdownInput {
-    /** Restrict the read to a specific story. Omit for body (backward compatible). */
-    in?: StoryLocator;
+import { SDProjectionReadInput } from '../types/content-projection.js';
+export interface GetMarkdownInput extends SDProjectionReadInput {
 }
 /**
  * Engine-specific adapter that the getMarkdown API delegates to.

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

@@ -12,6 +12,9 @@ import { SDDocument } from './types/fragment.js';
 import { GetTextAdapter, GetTextInput } from './get-text/get-text.js';
 import { GetMarkdownAdapter, GetMarkdownInput } from './get-markdown/get-markdown.js';
 import { GetHtmlAdapter, GetHtmlInput } from './get-html/get-html.js';
+import { ProjectHtmlAdapter } from './project-html/project-html.js';
+import { ProjectMarkdownAdapter } from './project-markdown/project-markdown.js';
+import { ProjectHtmlInput, ProjectMarkdownInput, SDContentProjectionResult } from './types/content-projection.js';
 import { MarkdownToFragmentAdapter, MarkdownToFragmentInput } from './markdown-to-fragment/markdown-to-fragment.js';
 import { HtmlToFragmentAdapter, HtmlToFragmentInput } from './html-to-fragment/html-to-fragment.js';
 import { SDHtmlToFragmentResult, SDMarkdownToFragmentResult } from './types/sd-contract.js';
@@ -79,6 +82,10 @@ export type { MarkdownToFragmentInput, MarkdownToFragmentAdapter, } from './mark
 export { executeMarkdownToFragment } from './markdown-to-fragment/markdown-to-fragment.js';
 export type { HtmlToFragmentInput, HtmlToFragmentAdapter } from './html-to-fragment/html-to-fragment.js';
 export { executeHtmlToFragment } from './html-to-fragment/html-to-fragment.js';
+export type { ProjectHtmlAdapter } from './project-html/project-html.js';
+export { executeProjectHtml } from './project-html/project-html.js';
+export type { ProjectMarkdownAdapter } from './project-markdown/project-markdown.js';
+export { executeProjectMarkdown } from './project-markdown/project-markdown.js';
 export type { HistoryState, HistoryActionResult, HistoryNoopReason, SDHistoryStatus, SDHistoryCollaborationMeta, } from './history/history.types.js';
 export { executeTrackChangesGet, executeTrackChangesList, executeTrackChangesDecide, } from './track-changes/track-changes.js';
 export { createPlanApi, type PlanApi, type PlanExecuteInput, type PlanExecuteEntry, type PlanExecuteEntryExpect, type PlanExecuteResult, type PlanEntryReceipt, type PlanEntryReceiptStatus, type PlanExecuteFailure, type PlanCaptureRefMarker, type PlanProjectTextOffsetMarker, } from './plan/plan.js';
@@ -287,6 +294,8 @@ export interface DocumentApi {
      * Return the full document content as an HTML string.
      */
     getHtml(input: GetHtmlInput): string;
+    projectHtml(input: ProjectHtmlInput): Promise<SDContentProjectionResult<'html'>>;
+    projectMarkdown(input: ProjectMarkdownInput): Promise<SDContentProjectionResult<'markdown'>>;
     /**
      * Convert a Markdown string into an SDM/1 structural fragment.
      */
@@ -509,6 +518,8 @@ export interface DocumentApiAdapters {
     getText: GetTextAdapter;
     getMarkdown: GetMarkdownAdapter;
     getHtml: GetHtmlAdapter;
+    projectHtml?: ProjectHtmlAdapter;
+    projectMarkdown?: ProjectMarkdownAdapter;
     markdownToFragment: MarkdownToFragmentAdapter;
     htmlToFragment?: HtmlToFragmentAdapter;
     info: InfoAdapter;

package/dist/document-api/src/project-html/project-html.d.ts

@@ -0,0 +1,5 @@
+import { ProjectHtmlInput, SDContentProjectionResult } from '../types/content-projection.js';
+export interface ProjectHtmlAdapter {
+    projectHtml(input: ProjectHtmlInput): Promise<SDContentProjectionResult<'html'>>;
+}
+export declare function executeProjectHtml(adapter: ProjectHtmlAdapter | undefined, input: ProjectHtmlInput): Promise<SDContentProjectionResult<'html'>>;

package/dist/document-api/src/project-markdown/project-markdown.d.ts

@@ -0,0 +1,5 @@
+import { ProjectMarkdownInput, SDContentProjectionResult } from '../types/content-projection.js';
+export interface ProjectMarkdownAdapter {
+    projectMarkdown(input: ProjectMarkdownInput): Promise<SDContentProjectionResult<'markdown'>>;
+}
+export declare function executeProjectMarkdown(adapter: ProjectMarkdownAdapter | undefined, input: ProjectMarkdownInput): Promise<SDContentProjectionResult<'markdown'>>;

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

@@ -108,8 +108,11 @@ export interface ScrollIntoViewInput {
     target: TextAddress | TextTarget | EntityAddress;
     /** Alignment within the viewport. Defaults to `'center'`. */
     block?: 'start' | 'center' | 'end' | 'nearest';
-    /** Scroll behavior. Defaults to `'smooth'`. */
-    behavior?: 'auto' | 'smooth';
+    /**
+     * Scroll behavior. Defaults to `'smooth'`. `'auto'` follows the computed
+     * CSS `scroll-behavior`; `'instant'` always moves without animation.
+     */
+    behavior?: 'auto' | 'instant' | 'smooth';
 }
 /**
  * Result of `ui.viewport.scrollIntoView`. `success: false` when the

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

@@ -2,18 +2,23 @@ import { MutationOptions } from '../types/mutation-plan.types.js';
 import { SelectionTarget, TargetLocator } from '../types/address.js';
 import { SDMutationReceipt } from '../types/sd-contract.js';
 import { SDReplaceInput } from '../types/structural-input.js';
-import { StoryLocator } from '../types/story.types.js';
+import { BodyStoryLocator, StoryLocator } from '../types/story.types.js';
 import { BlockNodeAddress } from '../types/base.js';
 import { NestingPolicy } from '../types/placement.js';
 import { SelectionMutationAdapter } from '../selection-mutation.js';
 import { WriteAdapter } from '../write/write.js';
-/** Text replacement input: uses SelectionTarget / ref. */
-export type TextReplaceInput = TargetLocator & {
+/** Text replacement input: uses SelectionTarget / ref, or the complete main body. */
+export type TextReplaceInput = (TargetLocator & {
     target?: SelectionTarget;
     ref?: string;
     text: string;
     /** Target a specific document story (body, header, footer, footnote, endnote). */
     in?: StoryLocator;
+}) | {
+    target: BodyStoryLocator;
+    text: string;
+    ref?: never;
+    in?: never;
 };
 /** HTML or Markdown replacement input for conversion and structured application. */
 export type RichContentReplaceInput = {
@@ -23,6 +28,13 @@ export type RichContentReplaceInput = {
     ref?: string;
     in?: StoryLocator;
     nestingPolicy?: NestingPolicy;
+} | {
+    value: string;
+    type: 'html' | 'markdown';
+    target: BodyStoryLocator;
+    ref?: never;
+    in?: never;
+    nestingPolicy?: never;
 };
 /**
  * Input payload for the `doc.replace` operation.

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

@@ -50,6 +50,8 @@ export type TextTarget = {
     segments: [TextSegment, ...TextSegment[]];
     /** Story containing this text target. Omit for body (backward compatible). */
     story?: StoryLocator;
+    /** Coordinate space for segment offsets. Omitted means `visible`. */
+    coordinateSpace?: TextCoordinateSpace;
 };
 /**
  * Block node types valid as `nodeEdge` selection anchors.

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

@@ -0,0 +1,126 @@
+import { BlockNodeAddress, BlockNodeType } from './base.js';
+import { Range, SelectionTarget, TextTarget } from './address.js';
+import { StoryLocator } from './story.types.js';
+import { SDDiagnostic } from './sd-contract.js';
+export declare const SD_PROJECTION_FORMATS: readonly ["html", "markdown"];
+export type SDProjectionFormat = (typeof SD_PROJECTION_FORMATS)[number];
+export declare const SD_PROJECTION_REVIEW_MODES: readonly ["final", "original", "redline"];
+export type SDProjectionReviewMode = (typeof SD_PROJECTION_REVIEW_MODES)[number];
+export declare const SD_PROJECTION_STATUSES: readonly ["success", "warning", "failed"];
+export type SDProjectionStatus = (typeof SD_PROJECTION_STATUSES)[number];
+export declare const SD_PROJECTION_DIAGNOSTIC_CODES: readonly ["projection-normalized-construct", "projection-downgraded-construct", "projection-unsupported-construct", "projection-placeholder-emitted", "projection-annotation-omitted", "projection-numbering-unresolved", "projection-source-coverage-incomplete", "projection-scope-unsupported", "projection-limit-exceeded", "projection-revision-changed", "projection-malformed-source"];
+export type SDProjectionDiagnosticCode = (typeof SD_PROJECTION_DIAGNOSTIC_CODES)[number];
+export declare const SD_PROJECTION_CONSTRUCTS: readonly ["document", "source", "text", "paragraph", "emptyParagraph", "softBreak", "lineBreak", "heading", "bold", "italic", "underline", "strike", "hyperlink", "list", "listLabel", "table", "tableHeader", "tableRow", "tableCell", "colSpan", "rowSpan", "horizontalRule", "inlineCode", "codeBlock", "image", "field", "contentControl", "math", "drawing", "embeddedObject", "sectionBreak", "pageBreak", "columnBreak", "trackedChange", "comment", "scope", "placeholder"];
+export type SDProjectionConstruct = (typeof SD_PROJECTION_CONSTRUCTS)[number];
+export declare const SD_PROJECTION_DISPOSITIONS: readonly ["preserved", "normalized", "downgraded", "placeholder", "omitted", "rejected"];
+export type SDProjectionDisposition = (typeof SD_PROJECTION_DISPOSITIONS)[number];
+export type SDProjectionScope = BlockNodeAddress | SelectionTarget;
+export interface SDProjectionReadInput {
+    in?: StoryLocator;
+    reviewMode?: SDProjectionReviewMode;
+    scope?: SDProjectionScope;
+}
+export interface ProjectHtmlInput extends SDProjectionReadInput {
+    includeSourceMap?: boolean;
+}
+export interface ProjectMarkdownInput extends SDProjectionReadInput {
+    includeSourceMap?: boolean;
+}
+export type SDResolvedProjectionScope = {
+    kind: 'story';
+} | {
+    kind: 'block';
+    target: BlockNodeAddress;
+} | {
+    kind: 'range';
+    target: SelectionTarget & {
+        coordinateSpace: 'tracked';
+    };
+};
+export type SDProjectionBlockMapEntry = {
+    nodeType: BlockNodeType;
+    output: Range;
+    parentBlockId?: string;
+    changeIds?: string[];
+    commentIds?: string[];
+} & ({
+    identity: 'public';
+    blockId: string;
+} | {
+    identity: 'unavailable';
+    identityUnavailableReason: 'positionDerivedFallback';
+    blockId?: never;
+});
+export type SDProjectionDiagnostic = Omit<SDDiagnostic, 'code' | 'construct' | 'disposition' | 'lossy' | 'source'> & {
+    code: SDProjectionDiagnosticCode;
+    construct: SDProjectionConstruct;
+    disposition: SDProjectionDisposition;
+    lossy: boolean;
+    source: {
+        story: StoryLocator;
+        blockId?: string;
+        range?: Range;
+        coordinateSpace?: 'tracked';
+        changeIds?: string[];
+        commentIds?: string[];
+    };
+    output?: {
+        format: SDProjectionFormat;
+        range?: Range;
+    };
+};
+export interface SDProjectionSourceMap {
+    version: 'sd-projection-source-map/1';
+    outputCoordinateSpace: 'utf16';
+    sourceCoordinateSpace: 'tracked';
+    entries: SDProjectionSourceMapEntry[];
+}
+export type SDProjectionSourceMapEntry = {
+    kind: 'text';
+    output: Range;
+    source: TextTarget & {
+        coordinateSpace: 'tracked';
+    };
+    blockId: string;
+    changeIds?: string[];
+    commentIds?: string[];
+} | ({
+    kind: 'synthetic';
+    output: Range;
+    role: 'listLabel' | 'placeholder';
+    changeIds?: string[];
+    commentIds?: string[];
+} & ({
+    identity: 'public';
+    blockId: string;
+} | {
+    identity: 'unavailable';
+    identityUnavailableReason: 'positionDerivedFallback';
+    blockId?: never;
+}));
+export interface SDProjectionAnnotation {
+    kind: 'trackedChange' | 'comment';
+    id: string;
+    blockIds: string[];
+    sourceTarget?: TextTarget;
+    outputRanges: Range[];
+    status: 'emitted' | 'partiallyEmitted' | 'omitted';
+    omittedReason?: 'reviewMode' | 'unsupported';
+    side?: 'inserted' | 'deleted' | 'source' | 'destination' | 'formatting';
+}
+export interface SDContentProjectionResult<TFormat extends SDProjectionFormat = SDProjectionFormat> {
+    format: TFormat;
+    content: string;
+    status: SDProjectionStatus;
+    reviewMode: SDProjectionReviewMode;
+    evaluatedRevision: string;
+    story: StoryLocator;
+    scope: SDResolvedProjectionScope;
+    lossy: boolean;
+    diagnostics: SDProjectionDiagnostic[];
+    blocks: SDProjectionBlockMapEntry[];
+    annotations: SDProjectionAnnotation[];
+    sourceMap?: SDProjectionSourceMap;
+}
+export declare function deriveSDProjectionStatus(diagnostics: readonly Pick<SDProjectionDiagnostic, 'severity' | 'lossy'>[]): SDProjectionStatus;
+export declare function validateSDProjectionSourceMap(sourceMap: SDProjectionSourceMap, contentLength: number): boolean;

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

@@ -29,3 +29,4 @@ export * from './adapter-result.js';
 export * from './structural-input.js';
 export * from './story.types.js';
 export * from './clipboard.js';
+export * from './content-projection.js';

package/dist/document-api/src/types/mutation-plan.types.d.ts

@@ -5,6 +5,7 @@ import { InsertStylePolicy, StylePolicy } from './style-policy.types.js';
 import { InlineRunPatch } from '../format/inline-run-patch.js';
 import { SDFragment } from './fragment.js';
 import { Placement, NestingPolicy } from './placement.js';
+import { AffectedRef } from './receipt.js';
 import { ChangeMode } from '../write/write.js';
 import { StoryLocator } from './story.types.js';
 export type SelectWhere = {
@@ -229,6 +230,8 @@ export type PlanReceipt = {
     };
     steps: StepOutcome[];
     trackedChanges?: TrackedChangeAddress[];
+    /** Caller-held refs that no longer resolve after the plan. */
+    invalidatedRefs?: AffectedRef[];
     timing: {
         totalMs: number;
     };

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

@@ -1,13 +1,14 @@
 import { BlockNodeAddress } from './base.js';
 import { SelectionTarget, TextAddress } from './address.js';
 import { ReceiptEffects, ReceiptSuccess, TextMutationRange } from './receipt.js';
+import { BodyStoryLocator } from './story.types.js';
 export type SDErrorCode = 'INVALID_PAYLOAD' | 'INVALID_TARGET' | 'TARGET_NOT_FOUND' | 'ADDRESS_STALE' | 'PRECONDITION_FAILED' | 'REVISION_MISMATCH' | 'INVALID_CONTEXT' | 'INVALID_NESTING' | 'INVALID_PLACEMENT' | 'DUPLICATE_ID' | 'CAPABILITY_UNSUPPORTED' | 'RAW_MODE_REQUIRED' | 'PRESERVE_ONLY_VIOLATION' | 'NO_OP' | 'UNSUPPORTED_ENVIRONMENT' | 'INTERNAL_ERROR';
 export interface SDError {
     code: SDErrorCode;
     message: string;
     path?: Array<string | number>;
     /** The target that caused the error, when available. */
-    target?: BlockNodeAddress | TextAddress | SelectionTarget;
+    target?: BlockNodeAddress | TextAddress | SelectionTarget | BodyStoryLocator;
     details?: Record<string, unknown>;
 }
 /**
@@ -15,8 +16,9 @@ export interface SDError {
  *
  * - `TextAddress` (`kind: 'text'`): text-level insert/replace with block-relative offsets.
  * - `BlockNodeAddress` (`kind: 'block'`): structural insert/replace targeting a whole block.
+ * - `BodyStoryLocator` (`kind: 'story'`): explicit complete-main-body replacement.
  */
-export type MutationResolutionTarget = TextAddress | BlockNodeAddress;
+export type MutationResolutionTarget = TextAddress | BlockNodeAddress | BodyStoryLocator;
 export interface SDMutationReceipt {
     success: boolean;
     failure?: SDError;

package/dist/document-api/src/types/structural-input.d.ts

@@ -2,7 +2,7 @@ import { BlockNodeAddress } from './base.js';
 import { SelectionTarget } from './address.js';
 import { SDFragment } from './fragment.js';
 import { Placement, NestingPolicy } from './placement.js';
-import { StoryLocator } from './story.types.js';
+import { BodyStoryLocator, StoryLocator } from './story.types.js';
 /** Structural shape for the insert operation. */
 export interface SDInsertInput {
     /** Optional insertion target. When omitted, inserts at the end of the document. */
@@ -27,14 +27,29 @@ type StructuralReplaceLocator = {
     ref: string;
     /** Target to replace. BlockNodeAddress replaces the entire block; SelectionTarget replaces a contiguous selection. */
     target?: undefined;
+} | {
+    /** Replace the complete main body while preserving the destination DOCX package. */
+    target: BodyStoryLocator;
+    ref?: undefined;
 };
-/** Structural shape for the replace operation. */
-export type SDReplaceInput = StructuralReplaceLocator & {
+type StructuralReplaceContent = {
     /** Structural content to replace with. */
     content: SDFragment;
+};
+/** Structural shape for the replace operation. */
+export type SDReplaceInput = (Exclude<StructuralReplaceLocator, {
+    target: BodyStoryLocator;
+}> & StructuralReplaceContent & {
     /** Target a specific document story (body, header, footer, footnote, endnote). */
     in?: StoryLocator;
     /** Nesting policy. Defaults to { tables: 'forbid' }. */
     nestingPolicy?: NestingPolicy;
+}) | {
+    /** Replace the complete main body while preserving the destination DOCX package. */
+    target: BodyStoryLocator;
+    content: SDFragment;
+    ref?: never;
+    in?: never;
+    nestingPolicy?: never;
 };
 export {};

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

@@ -3,6 +3,8 @@ import { PageStyles } from './styles.js';
 import { PositionValidationOptions, PositionValidationSummary } from './pm-position-validation.js';
 import { DomPainterInput, PageDecorationProvider, PaintSnapshot, PositionMapping, FlowMode } from './renderer.js';
 import { DomPainterPersistentPageInput } from './persistent-page-surface.js';
+export { createWebFlowPainter, ensureWebFlowStyles, WEB_FLOW_CLASS_NAMES } from './web-flow/index.js';
+export type { WebFlowAppliedPaint, WebFlowDomBinding, WebFlowPaintCommand, WebFlowPaintItem, WebFlowPaintSnapshot, WebFlowPaintTransaction, WebFlowPainterHandle, WebFlowPainterOptions, WebFlowPaintWorkSummary, WebFlowStableDomKey, } from './web-flow/index.js';
 export { DOM_CLASS_NAMES } from './constants.js';
 export type { DomClassName } from './constants.js';
 export { ensureDocumentSurfaceStyles } from './styles.js';

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

@@ -0,0 +1,3 @@
+export { createWebFlowPainter } from './painter.js';
+export { ensureWebFlowStyles, WEB_FLOW_CLASS_NAMES } from './styles.js';
+export type { WebFlowAppliedPaint, WebFlowDomBinding, WebFlowPaintCommand, WebFlowPaintItem, WebFlowPaintSnapshot, WebFlowPaintTransaction, WebFlowPainterHandle, WebFlowPainterOptions, WebFlowPaintWorkSummary, WebFlowStableDomKey, } from './types.js';

package/dist/layout-engine/painters/dom/src/web-flow/painter.d.ts

@@ -0,0 +1,2 @@
+import { WebFlowPainterHandle, WebFlowPainterOptions } from './types.js';
+export declare function createWebFlowPainter(mount: HTMLElement, options?: WebFlowPainterOptions): WebFlowPainterHandle;

package/dist/layout-engine/painters/dom/src/web-flow/render.d.ts

@@ -0,0 +1,8 @@
+import { FlowBlock } from '../../../../contracts/src/index.js';
+import { WebFlowPaintItem, WebFlowPainterOptions } from './types.js';
+export declare function doesWebFlowBlockProduceDom(block: FlowBlock): boolean;
+export declare function renderWebFlowItem(item: WebFlowPaintItem, doc: Document, options: WebFlowPainterOptions): HTMLElement | null;
+/** Identity-only signature for deciding whether a retained node needs dataset rebasing. */
+export declare function webFlowItemIdentityFingerprint(item: WebFlowPaintItem): string;
+/** Rebase canonical identity datasets without replacing an unchanged retained node. */
+export declare function rebaseWebFlowItemNode(node: HTMLElement, previous: WebFlowPaintItem, next: WebFlowPaintItem): () => void;

package/dist/layout-engine/painters/dom/src/web-flow/styles.d.ts

@@ -0,0 +1,10 @@
+export declare const WEB_FLOW_CLASS_NAMES: {
+    readonly root: "superdoc-web-flow";
+    readonly block: "superdoc-web-flow-block";
+    readonly paragraph: "superdoc-web-flow-paragraph";
+    readonly run: "superdoc-web-flow-run";
+    readonly listMarker: "superdoc-web-flow-list-marker";
+    readonly table: "superdoc-web-flow-table";
+    readonly diagnostic: "superdoc-web-flow-diagnostic";
+};
+export declare function ensureWebFlowStyles(doc: Document): void;