superdoc 2.18.0-next.9 → 2.18.1-next.1

package/dist/chunks/{create-super-doc-ui-qTSa0PbD.es.js → create-super-doc-ui-C_NS0Kbv.es.js}

@@ -510,363 +510,206 @@ var decodeLayoutStoryDataset = (raw) => {
 `${DOM_CLASS_NAMES.BLOCK_SDT}${DATA_ATTRS.SDT_ID}`;
 `${DATA_ATTRS.DRAGGABLE}`;
 //#endregion
-//#region ../layout-engine/contracts/src/direction-context.ts
+//#region src/public/ui/equality.ts
 /**
-* Read a paragraph's inline base direction from its attributes.
+* Shallow equality used by the controller to suppress redundant slice
+* notifications. v2-native, dependency-free.
+*/
+/**
+* Returns `true` when `a` and `b` are the same reference, or are objects with
+* the same own-enumerable keys and `Object.is`-equal values one level deep.
+* Arrays compare by index. Primitives compare with `Object.is`.
+*/
+function shallowEqual(a, b) {
+	if (Object.is(a, b)) return true;
+	if (typeof a !== "object" || a === null || typeof b !== "object" || b === null) return false;
+	if (Array.isArray(a) !== Array.isArray(b)) return false;
+	const aKeys = Object.keys(a);
+	const bKeys = Object.keys(b);
+	if (aKeys.length !== bKeys.length) return false;
+	for (const key of aKeys) {
+		if (!Object.prototype.hasOwnProperty.call(b, key)) return false;
+		if (!Object.is(a[key], b[key])) return false;
+	}
+	return true;
+}
+//#endregion
+//#region src/public/ui/format-painter-helpers.js
+/**
+* Maps SDRunProps field names to InlineRunPatch field names.
+* SDRunProps (read-side) and InlineRunPatch (write-side) use different keys
+* for the same properties; direct assignment between them is forbidden.
 *
-* Prefers the resolved {@link ParagraphDirectionContext} (SD-2776) when
-* present. Falls back to `paragraphProperties.rightToLeft` for PM-node /
-* editor paths that store direction on the raw OOXML properties rather
-* than the typed direction context.
+* @param {Record<string, unknown>} props - SDRunProps object from doc.getNodeById
+* @returns {Record<string, unknown>} InlineRunPatch ready for doc.format.apply
+*/
+function sdRunPropsToInlineRunPatch(props) {
+	if (!props || typeof props !== "object") return {};
+	const patch = {};
+	if (props.fonts) patch.rFonts = {
+		ascii: props.fonts.ascii,
+		hAnsi: props.fonts.hAnsi,
+		eastAsia: props.fonts.eastAsia,
+		cs: props.fonts.cs,
+		asciiTheme: props.fonts.asciiTheme,
+		hAnsiTheme: props.fonts.hAnsiTheme,
+		eastAsiaTheme: props.fonts.eastAsiaTheme,
+		csTheme: props.fonts.csTheme,
+		hint: props.fonts.hint
+	};
+	if (props.fontFamily != null) patch.fontFamily = props.fontFamily;
+	if (props.lang) patch.lang = {
+		val: props.lang.val,
+		eastAsia: props.lang.eastAsia,
+		bidi: props.lang.bidi
+	};
+	if (props.fontSize != null) patch.fontSize = props.fontSize;
+	if (props.fontSizeCs != null) patch.fontSizeCs = props.fontSizeCs;
+	const color = projectColorRefToInlineColor(props.color);
+	if (color != null) patch.color = color;
+	if (props.highlight != null) patch.highlight = props.highlight;
+	const shading = projectShadingToInlinePatch(props.shading);
+	if (shading) patch.shading = shading;
+	if (props.cs != null) patch.cs = props.cs;
+	if (props.rtl != null) patch.rtl = props.rtl;
+	if (props.bold != null) patch.bold = props.bold;
+	if (props.boldCs != null) patch.bCs = props.boldCs;
+	if (props.italic != null) patch.italic = props.italic;
+	if (props.italicCs != null) patch.iCs = props.italicCs;
+	const underline = projectUnderlineToInlinePatch(props.underline);
+	if (underline !== void 0) patch.underline = underline;
+	if (props.strikethrough != null) patch.strike = props.strikethrough;
+	if (props.doubleStrikethrough != null) patch.dstrike = props.doubleStrikethrough;
+	if (props.caps != null) patch.caps = props.caps;
+	if (props.smallCaps != null) patch.smallCaps = props.smallCaps;
+	if (props.outline != null) patch.outline = props.outline;
+	if (props.shadow != null) patch.shadow = props.shadow;
+	if (props.emboss != null) patch.emboss = props.emboss;
+	if (props.imprint != null) patch.imprint = props.imprint;
+	if (props.verticalAlign != null) patch.vertAlign = props.verticalAlign;
+	if (props.characterSpacing != null) patch.letterSpacing = props.characterSpacing;
+	if (props.characterScale != null) patch.charScale = props.characterScale;
+	if (props.kern != null) patch.kerning = props.kern;
+	if (props.baselineShift != null) patch.position = props.baselineShift;
+	if (props.fitTextWidth != null) patch.fitText = { val: props.fitTextWidth };
+	if (props.vanish != null) patch.vanish = props.vanish;
+	if (props.webHidden != null) patch.webHidden = props.webHidden;
+	if (props.specVanish != null) patch.specVanish = props.specVanish;
+	const border = projectBorderToInlinePatch(props.border);
+	if (border) patch.border = border;
+	return patch;
+}
+function projectColorRefToInlineColor(color) {
+	if (!color) return void 0;
+	if (typeof color === "string") return color;
+	if (color.model === "rgb") return color.value;
+	if (color.model === "auto") return "auto";
+}
+function projectUnderlineToInlinePatch(underline) {
+	if (underline == null) return void 0;
+	const patch = {};
+	if (underline.style != null) patch.style = underline.style;
+	if (underline.color?.model === "rgb") patch.color = underline.color.value;
+	if (underline.color?.model === "theme") patch.themeColor = underline.color.theme;
+	return Object.keys(patch).length > 0 ? patch : true;
+}
+function projectShadingToInlinePatch(shading) {
+	if (!shading) return void 0;
+	const patch = {};
+	const fill = projectColorRefToInlineColor(shading.fill);
+	if (fill != null) patch.fill = fill;
+	const color = projectColorRefToInlineColor(shading.color);
+	if (color != null) patch.color = color;
+	if (shading.pattern != null) patch.val = shading.pattern;
+	return Object.keys(patch).length > 0 ? patch : void 0;
+}
+function projectBorderToInlinePatch(border) {
+	if (!border) return void 0;
+	const patch = {};
+	if (border.style != null) patch.val = border.style;
+	if (border.width != null) patch.sz = border.width;
+	if (border.space != null) patch.space = border.space;
+	const color = projectColorRefToInlineColor(border.color);
+	if (color != null) patch.color = color;
+	return Object.keys(patch).length > 0 ? patch : void 0;
+}
+/**
+* Serializes a selection to a stable string key used to detect whether
+* the target selection is the same as the source (skip apply in that case).
 *
-* Consumers should call this instead of inspecting attrs ad hoc so the
-* direction source check stays in one place.
+* Falls back to the plain text target when the host has not populated an
+* explicit `selectionTarget` yet.
+*
+* @param {{ selectionTarget?: unknown; target?: unknown } | null | undefined} selection
+* @returns {string}
 */
-function getParagraphInlineDirection(attrs) {
-	const fromContext = attrs?.directionContext?.inlineDirection;
-	if (fromContext != null) return fromContext;
-	const ppRtl = attrs?.paragraphProperties?.rightToLeft;
-	if (ppRtl === true) return "rtl";
-	if (ppRtl === false) return "ltr";
+function selectionKey(selection) {
+	const target = selection?.selectionTarget ?? selection?.target;
+	if (!selection || !target) return "";
+	try {
+		return JSON.stringify(target);
+	} catch {
+		return String(target);
+	}
 }
 //#endregion
-//#region ../layout-engine/contracts/src/drawing-taxonomy.ts
+//#region src/helpers/v2-review-mutation-impact.js
 /**
-* Frozen canonical diagnostic codes for drawing rendering.
+* Classify the tracked-change identities carried by a v2 mutation event.
 *
-* New extractor/adapter diagnostics MUST use these exact strings. Family-
-* specific codes are required — do not collapse everything to
-* `render.unsupported-inline-ooxml` (plan §4).
+* Receipt entities are the durable invalidation contract between the document
+* kernel and derived review UI. Direct receipts carry entity refs; mutation
+* plans carry the same identities through `trackedChanges` and per-step ids.
 */
-var DRAWING_DIAGNOSTIC_CODES = {
-	/** External image relationship (`r:link` / `TargetMode="External"`). Not fetched. */
-	externalImageDeferred: "render.media.external-image-deferred",
-	/** Drawing references a relationship id that does not exist on the owner part. */
-	missingRelationship: "render.drawing.missing-relationship",
-	/** Relationship resolves but the target media part bytes are missing/empty. */
-	missingMediaPart: "render.media.missing-part",
-	/** Relationship exists but is not an image relationship type. */
-	unsupportedRelationshipType: "render.drawing.unsupported-relationship-type",
-	/** Media MIME is not in the supported allowlist. */
-	unsupportedMime: "render.media.unsupported-mime",
-	/** Media part exceeds the host byte-size policy before bytes are materialized. */
-	imageTooLarge: "render.media.image-too-large",
-	/** SVG content rejected by the SVG safety policy. */
-	unsafeSvg: "render.media.unsafe-svg",
-	/** Metafile / TIFF (EMF, WMF, TIFF) with no approved conversion path. */
-	unsupportedFormat: "render.media.unsupported-format",
-	/** OLE / ActiveX / embedded package object. */
-	embeddedObjectNotSupported: "render.embedded-object-not-supported",
-	/** SmartArt / diagram / unknown external graphic-data object. */
-	unsupportedObject: "render.drawing.unsupported-object",
-	/** VML structure outside any supported image-like subset. */
-	vmlUnsupported: "render.drawing.vml-unsupported",
-	/** VML image-like content that could not be promoted to a supported image. */
-	vmlImageUnsupported: "render.drawing.vml-image-unsupported",
-	/** Custom geometry command the extractor does not implement (e.g. `arcTo`). */
-	unsupportedGeometryCommand: "render.drawing.unsupported-geometry-command",
-	/** Anchor fields required for honest placement are unsupported. */
-	anchorUnsupported: "render.drawing.anchor-unsupported",
-	/** Wrap fields required for honest placement are unsupported. */
-	wrapUnsupported: "render.drawing.wrap-unsupported",
-	/** `mc:AlternateContent` had no supported choice and no usable fallback. */
-	altContentNoSupportedChoice: "render.drawing.altcontent-no-supported-choice",
-	/** A child of an otherwise-supported group is unsupported. */
-	groupChildUnsupported: "render.drawing.group-child-unsupported"
-};
-DRAWING_DIAGNOSTIC_CODES.missingRelationship, DRAWING_DIAGNOSTIC_CODES.unsupportedRelationshipType, DRAWING_DIAGNOSTIC_CODES.unsupportedRelationshipType, DRAWING_DIAGNOSTIC_CODES.imageTooLarge, DRAWING_DIAGNOSTIC_CODES.missingMediaPart, DRAWING_DIAGNOSTIC_CODES.unsupportedObject, DRAWING_DIAGNOSTIC_CODES.vmlUnsupported;
+function getV2TrackedChangeMutationImpact(event) {
+	if (event?.type !== "mutation:committed") return null;
+	const payload = event.origin === "history" ? event.result : event.receipt;
+	if (!payload || typeof payload !== "object") return null;
+	const upsertIds = /* @__PURE__ */ new Set();
+	const removedIds = /* @__PURE__ */ new Set();
+	/** @type {Array<{ from: string, to: string }>} */
+	const remappedPairs = [];
+	const collectEntity = (entry, into) => {
+		if (entry?.kind !== "entity" || entry.entityType !== "trackedChange") return;
+		if (typeof entry.entityId === "string" && entry.entityId.length > 0) into.add(entry.entityId);
+	};
+	const readEntityId = (entry) => {
+		if (entry?.kind !== "entity" || entry.entityType !== "trackedChange") return null;
+		return typeof entry.entityId === "string" && entry.entityId.length > 0 ? entry.entityId : null;
+	};
+	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) {
+		const fromId = readEntityId(mapping?.from);
+		const toId = readEntityId(mapping?.to);
+		if (fromId) removedIds.add(fromId);
+		if (toId) upsertIds.add(toId);
+		if (fromId && toId && fromId !== toId) remappedPairs.push({
+			from: fromId,
+			to: toId
+		});
+	}
+	for (const id of removedIds) upsertIds.delete(id);
+	const allResolved = readAllResolvedFact(event, payload);
+	if (upsertIds.size === 0 && removedIds.size === 0 && !allResolved) return null;
+	return {
+		upsertIds,
+		removedIds,
+		remappedPairs,
+		reconcileMode: "targeted",
+		...allResolved ? { allResolved } : {}
+	};
+}
 /**
-* The frozen drawing support taxonomy.
-*
-* Invariants (enforced by `drawing-taxonomy.test.ts`):
-* - every `supported` family has a real contract target (`!== 'none'`);
-* - every `DrawingBlock`-targeted family declares a `drawingKind`;
-* - every `fail-closed` family declares a canonical `diagnostic`;
-* - every canonical diagnostic code is referenced by at least one fail-closed
-*   family;
-* - `deferred` families make no support claim (`contract: 'none'`, no
-*   diagnostic).
-*/
-var DRAWING_SUPPORT_TAXONOMY = {
-	inlineBitmap: {
-		family: "inlineBitmap",
-		support: "supported",
-		description: "wp:inline pic:pic with internal media and browser-safe MIME (PNG/JPEG; WebP/SVG once the host media resolver lands).",
-		contract: "ImageRun"
-	},
-	anchoredBitmap: {
-		family: "anchoredBitmap",
-		support: "supported",
-		description: "wp:anchor bitmap with anchor/wrap expressible by ImageAnchor/ImageWrap. Never silently inlined.",
-		contract: "ImageBlock"
-	},
-	imageChildInGroup: {
-		family: "imageChildInGroup",
-		support: "supported",
-		description: "Bitmap child of a supported DrawingML group/drawing wrapper. Supported only when the parent is.",
-		contract: "ImageDrawing"
-	},
-	vectorShape: {
-		family: "vectorShape",
-		support: "supported",
-		description: "Block/floating DrawingML preset/custom shape with the supported geometry/style subset.",
-		contract: "DrawingBlock",
-		drawingKind: "vectorShape"
-	},
-	shapeGroup: {
-		family: "shapeGroup",
-		support: "supported",
-		description: "DrawingML group whose rendered children are supported vector/image children.",
-		contract: "DrawingBlock",
-		drawingKind: "shapeGroup"
-	},
-	chart: {
-		family: "chart",
-		support: "supported",
-		description: "DrawingML chart projected into a ChartDrawing with parsed cached chart XML data. Complete Word chart fidelity remains deferred to chartFidelity.",
-		contract: "DrawingBlock",
-		drawingKind: "chart"
-	},
-	alternateContent: {
-		family: "alternateContent",
-		support: "supported",
-		description: "mc:AlternateContent traversal/select policy. Selected Choice/Fallback maps to its family contract; unselected branches preserved for save/reopen.",
-		contract: "selected-choice"
-	},
-	externalImage: {
-		family: "externalImage",
-		support: "fail-closed",
-		description: "External image relationship (r:link / TargetMode=\"External\"). Not fetched.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.externalImageDeferred
-	},
-	missingRelationship: {
-		family: "missingRelationship",
-		support: "fail-closed",
-		description: "Drawing references a relationship id absent from the owner part .rels.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.missingRelationship
-	},
-	missingMediaPart: {
-		family: "missingMediaPart",
-		support: "fail-closed",
-		description: "Relationship resolves but the target media part bytes are missing or empty.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.missingMediaPart
-	},
-	wrongRelationshipType: {
-		family: "wrongRelationshipType",
-		support: "fail-closed",
-		description: "Relationship exists but is not an image relationship type.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.unsupportedRelationshipType
-	},
-	unsupportedMime: {
-		family: "unsupportedMime",
-		support: "fail-closed",
-		description: "Media MIME outside the supported allowlist (incl. GIF/BMP/ICO).",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.unsupportedMime
-	},
-	oversizedMediaPart: {
-		family: "oversizedMediaPart",
-		support: "fail-closed",
-		description: "Media part exceeds the host byte-size policy before bytes are materialized.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.imageTooLarge
-	},
-	unsafeSvg: {
-		family: "unsafeSvg",
-		support: "fail-closed",
-		description: "SVG content rejected by the SVG safety policy.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.unsafeSvg
-	},
-	metafileOrTiff: {
-		family: "metafileOrTiff",
-		support: "fail-closed",
-		description: "EMF/WMF/TIFF and other non-browser-native formats with no approved conversion path.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.unsupportedFormat
-	},
-	embeddedObject: {
-		family: "embeddedObject",
-		support: "fail-closed",
-		description: "OLE / ActiveX / embedded package object.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.embeddedObjectNotSupported
-	},
-	smartArtOrDiagram: {
-		family: "smartArtOrDiagram",
-		support: "fail-closed",
-		description: "SmartArt / diagram / unknown external graphic-data object.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.unsupportedObject
-	},
-	vml: {
-		family: "vml",
-		support: "fail-closed",
-		description: "VML structure outside any supported image-like subset (default fail-closed policy).",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.vmlUnsupported
-	},
-	vmlImageLike: {
-		family: "vmlImageLike",
-		support: "fail-closed",
-		description: "Simple VML image references (v:imagedata) / watermark image metadata. Fail-closed unless a later change promotes a named subset with deterministic fixtures and exact oracles.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.vmlImageUnsupported
-	},
-	unsupportedGeometryCommand: {
-		family: "unsupportedGeometryCommand",
-		support: "fail-closed",
-		description: "Custom geometry command the extractor does not implement, e.g. arcTo.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.unsupportedGeometryCommand
-	},
-	unsupportedAnchorFields: {
-		family: "unsupportedAnchorFields",
-		support: "fail-closed",
-		description: "Anchor fields required for honest placement are unsupported (char-relative, alignment modes, etc.).",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.anchorUnsupported
-	},
-	unsupportedWrapFields: {
-		family: "unsupportedWrapFields",
-		support: "fail-closed",
-		description: "Wrap fields required for honest placement are unsupported (arbitrary wrap polygons, etc.).",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.wrapUnsupported
-	},
-	alternateContentNoSupportedChoice: {
-		family: "alternateContentNoSupportedChoice",
-		support: "fail-closed",
-		description: "mc:AlternateContent with no supported choice and no usable fallback.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.altContentNoSupportedChoice
-	},
-	groupChildUnsupported: {
-		family: "groupChildUnsupported",
-		support: "fail-closed",
-		description: "Unsupported child inside an otherwise-supported group. Supported siblings are not dropped.",
-		contract: "none",
-		diagnostic: DRAWING_DIAGNOSTIC_CODES.groupChildUnsupported
-	},
-	objectEditing: {
-		family: "objectEditing",
-		support: "deferred",
-		description: "Editing/mutation of anchored/vector objects.",
-		contract: "none"
-	},
-	customWrapPolygon: {
-		family: "customWrapPolygon",
-		support: "deferred",
-		description: "Full Word-compatible text wrapping for arbitrary custom wrap polygons.",
-		contract: "none"
-	},
-	chartFidelity: {
-		family: "chartFidelity",
-		support: "deferred",
-		description: "Complete chart fidelity (a dedicated chart effort owns the parsed subset).",
-		contract: "none"
-	},
-	vmlFidelity: {
-		family: "vmlFidelity",
-		support: "deferred",
-		description: "Complete VML fidelity.",
-		contract: "none"
-	},
-	decorativeAccessibilityUi: {
-		family: "decorativeAccessibilityUi",
-		support: "deferred",
-		description: "Full accessibility UI for decorative image semantics beyond preserving source data.",
-		contract: "none"
-	}
-};
-Object.keys(DRAWING_SUPPORT_TAXONOMY);
-Object.freeze([
-	"multiple-sections",
-	"furniture-page-tokens",
-	"non-balanceable-multi-column-sections",
-	"body-anchored-objects",
-	"non-flowing-page-relative-body-anchors",
-	"footnotes",
-	"page-references",
-	"cross-references",
-	"keep-constraints",
-	"tables",
-	"furniture-anchored-objects"
-]);
-var INCREMENTAL_DEPENDENCY_CERTIFICATE_CLASSES = Object.freeze([
-	"checkpoint-geometry",
-	"section-numbering",
-	"font-style-inputs",
-	"notes",
-	"furniture",
-	"flowing-anchors",
-	"non-flowing-page-anchors",
-	"convergence",
-	"source-topology"
-]);
-new Set(INCREMENTAL_DEPENDENCY_CERTIFICATE_CLASSES);
-//#endregion
-//#region src/helpers/v2-review-mutation-impact.js
-/**
-* 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. 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;
-	const payload = event.origin === "history" ? event.result : event.receipt;
-	if (!payload || typeof payload !== "object") return null;
-	const upsertIds = /* @__PURE__ */ new Set();
-	const removedIds = /* @__PURE__ */ new Set();
-	/** @type {Array<{ from: string, to: string }>} */
-	const remappedPairs = [];
-	const collectEntity = (entry, into) => {
-		if (entry?.kind !== "entity" || entry.entityType !== "trackedChange") return;
-		if (typeof entry.entityId === "string" && entry.entityId.length > 0) into.add(entry.entityId);
-	};
-	const readEntityId = (entry) => {
-		if (entry?.kind !== "entity" || entry.entityType !== "trackedChange") return null;
-		return typeof entry.entityId === "string" && entry.entityId.length > 0 ? entry.entityId : null;
-	};
-	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) {
-		const fromId = readEntityId(mapping?.from);
-		const toId = readEntityId(mapping?.to);
-		if (fromId) removedIds.add(fromId);
-		if (toId) upsertIds.add(toId);
-		if (fromId && toId && fromId !== toId) remappedPairs.push({
-			from: fromId,
-			to: toId
-		});
-	}
-	for (const id of removedIds) upsertIds.delete(id);
-	const allResolved = readAllResolvedFact(event, payload);
-	if (upsertIds.size === 0 && removedIds.size === 0 && !allResolved) return null;
-	return {
-		upsertIds,
-		removedIds,
-		remappedPairs,
-		reconcileMode: "targeted",
-		...allResolved ? { allResolved } : {}
-	};
-}
-/**
-* Comment ids retired by a committed v2 mutation.
+* Comment ids retired by a committed v2 mutation.
 *
 * AIDEV-NOTE: History commits put invalidated comment ids on `result`; cut and
 * other command receipts use `receipt`. Same origin split as
@@ -903,6 +746,56 @@ function readAllResolvedFact(event, receipt) {
 	return fact;
 }
 //#endregion
+//#region src/helpers/v2-typing-mutation-event.js
+/**
+* Command kinds whose committed mutations belong to the sustained typing
+* cadence class (insert / replace / plain paste / Backspace / Delete).
+*
+* The SuperDoc shell debounces per-keystroke review-row hydration for these
+* kinds instead of refreshing comments + tracked changes on every commit —
+* hydrating immediately per keystroke was a measured worker-read storm during
+* typing and backspace bursts. The `text.*` aliases cover integrations that
+* forward Document API style command ids rather than editable-input kinds.
+*/
+var V2_TYPING_COMMAND_KINDS = /* @__PURE__ */ new Set([
+	"insert-text",
+	"replace-text",
+	"plain-text-paste",
+	"delete-backward",
+	"delete-forward",
+	"text.insert",
+	"text.replace",
+	"text.pastePlain",
+	"text.deleteBackward",
+	"text.deleteForward",
+	"structural.enter",
+	"structural:enter-split-paragraph",
+	"structural:enter-insert-paragraph-before",
+	"structural:enter-insert-paragraph-after",
+	"structural:shift-enter-line-break",
+	"structural:backspace-boundary-merge-with-previous",
+	"structural:delete-boundary-merge-with-next",
+	"backspace:boundary-merge-with-previous",
+	"backspace:list-remove",
+	"backspace:list-outdent"
+]);
+/**
+* True when a forwarded v2 host event is a committed editable-input mutation
+* of the sustained-typing class, i.e. review-row hydration for it should be
+* debounced rather than fired immediately.
+*
+* Events without a forwarded `editableCommandKind` (programmatic Document API
+* mutations, history commits, unclassified structural commands) return false
+* so they keep hydrating immediately.
+*
+* @param {{ type?: string, origin?: string, editableCommandKind?: string } | null | undefined} event
+* @returns {boolean}
+*/
+var isV2EditableTextMutationEvent = (event) => {
+	if (event?.type !== "mutation:committed" || event.origin !== "command") return false;
+	return V2_TYPING_COMMAND_KINDS.has(event.editableCommandKind);
+};
+//#endregion
 //#region src/public/ui/reasons.ts
 /**
 * Stable public reason taxonomy for the v2-native `superdoc/ui` controller.
@@ -1433,600 +1326,714 @@ var COMMAND_CATALOG = [
 		normalizePayload: normalizeColorPayload
 	},
 	{
-		id: "link",
-		family: "links",
+		id: "link",
+		family: "links",
+		disposition: "routed",
+		mutates: true,
+		docRoute: "hyperlinks.wrap",
+		activeMark: "link",
+		link: { kind: "link" }
+	},
+	{
+		id: "text-align",
+		family: "paragraph",
+		disposition: "routed",
+		mutates: true,
+		docRoute: "format.paragraph.setAlignment",
+		blockParagraph: { kind: "alignment" },
+		normalizePayload: normalizeAlignmentPayload
+	},
+	{
+		id: "line-height",
+		family: "paragraph",
+		disposition: "routed",
+		mutates: true,
+		docRoute: "format.paragraph.setSpacing",
+		blockParagraph: { kind: "spacing-line" },
+		normalizePayload: normalizeLineHeightPayload
+	},
+	{
+		id: "linked-style",
+		family: "paragraph",
+		disposition: "routed",
+		mutates: true,
+		docRoute: "styles.paragraph.setStyle",
+		blockParagraph: { kind: "style" },
+		normalizePayload: normalizeStyleIdPayload
+	},
+	{
+		id: "bullet-list",
+		family: "lists",
+		disposition: "routed",
+		mutates: true,
+		docRoute: "lists.apply",
+		list: {
+			mode: "toggle-seed",
+			seed: "bullet"
+		}
+	},
+	{
+		id: "numbered-list",
+		family: "lists",
+		disposition: "routed",
+		mutates: true,
+		docRoute: "lists.apply",
+		list: {
+			mode: "toggle-seed",
+			seed: "ordered"
+		}
+	},
+	{
+		id: "indent-increase",
+		family: "lists/indent",
+		disposition: "routed",
+		mutates: true,
+		docRoute: "lists.indent",
+		list: { mode: "indent" }
+	},
+	{
+		id: "indent-decrease",
+		family: "lists/indent",
+		disposition: "routed",
+		mutates: true,
+		docRoute: "lists.outdent",
+		list: { mode: "outdent" }
+	},
+	{
+		id: "direction-ltr",
+		family: "direction",
+		disposition: "routed",
+		mutates: true,
+		docRoute: "format.paragraph.setDirection",
+		blockParagraph: {
+			kind: "direction",
+			fixedValue: "ltr"
+		}
+	},
+	{
+		id: "direction-rtl",
+		family: "direction",
+		disposition: "routed",
+		mutates: true,
+		docRoute: "format.paragraph.setDirection",
+		blockParagraph: {
+			kind: "direction",
+			fixedValue: "rtl"
+		}
+	},
+	{
+		id: "clear-formatting",
+		family: "formatting",
+		disposition: "routed",
+		mutates: true,
+		docRoute: "format.apply",
+		inline: {
+			key: "*",
+			kind: "clear"
+		}
+	},
+	{
+		id: "image",
+		family: "media",
+		disposition: "routed",
+		mutates: true,
+		docRoute: "create.image",
+		create: { kind: "image" }
+	},
+	{
+		id: "table-of-contents-insert",
+		family: "TOC",
+		disposition: "routed",
+		mutates: true,
+		docRoute: "create.tableOfContents",
+		create: { kind: "toc" }
+	},
+	{
+		id: "table-insert",
+		family: "tables",
+		disposition: "routed",
+		mutates: true,
+		docRoute: "create.table",
+		create: { kind: "table" }
+	},
+	{
+		id: "table-add-row-before",
+		family: "tables",
+		disposition: "routed",
+		mutates: true,
+		docRoute: "tables.insertRow",
+		table: {
+			action: "insert-row-before",
+			op: "insertRow"
+		},
+		reason: TABLE_CONTEXT
+	},
+	{
+		id: "table-add-row-after",
+		family: "tables",
+		disposition: "routed",
+		mutates: true,
+		docRoute: "tables.insertRow",
+		table: {
+			action: "insert-row-after",
+			op: "insertRow"
+		},
+		reason: TABLE_CONTEXT
+	},
+	{
+		id: "table-delete-row",
+		family: "tables",
+		disposition: "routed",
+		mutates: true,
+		docRoute: "tables.deleteRow",
+		table: {
+			action: "delete-row",
+			op: "deleteRow"
+		},
+		reason: TABLE_CONTEXT
+	},
+	{
+		id: "table-add-column-before",
+		family: "tables",
+		disposition: "routed",
+		mutates: true,
+		docRoute: "tables.insertColumn",
+		table: {
+			action: "insert-column-before",
+			op: "insertColumn"
+		},
+		reason: TABLE_CONTEXT
+	},
+	{
+		id: "table-add-column-after",
+		family: "tables",
+		disposition: "routed",
+		mutates: true,
+		docRoute: "tables.insertColumn",
+		table: {
+			action: "insert-column-after",
+			op: "insertColumn"
+		},
+		reason: TABLE_CONTEXT
+	},
+	{
+		id: "table-delete-column",
+		family: "tables",
 		disposition: "routed",
 		mutates: true,
-		docRoute: "hyperlinks.wrap",
-		activeMark: "link",
-		link: { kind: "link" }
+		docRoute: "tables.deleteColumn",
+		table: {
+			action: "delete-column",
+			op: "deleteColumn"
+		},
+		reason: TABLE_CONTEXT
 	},
 	{
-		id: "text-align",
-		family: "paragraph",
+		id: "table-delete",
+		family: "tables",
 		disposition: "routed",
 		mutates: true,
-		docRoute: "format.paragraph.setAlignment",
-		blockParagraph: { kind: "alignment" },
-		normalizePayload: normalizeAlignmentPayload
+		docRoute: "tables.delete",
+		table: {
+			action: "delete-table",
+			op: "delete"
+		},
+		reason: TABLE_CONTEXT
 	},
 	{
-		id: "line-height",
-		family: "paragraph",
+		id: "table-merge-cells",
+		family: "tables",
 		disposition: "routed",
 		mutates: true,
-		docRoute: "format.paragraph.setSpacing",
-		blockParagraph: { kind: "spacing-line" },
-		normalizePayload: normalizeLineHeightPayload
+		docRoute: "tables.mergeCells",
+		table: {
+			action: "merge-cells",
+			op: "mergeCells"
+		},
+		reason: TABLE_CONTEXT
 	},
 	{
-		id: "linked-style",
-		family: "paragraph",
+		id: "table-split-cell",
+		family: "tables",
 		disposition: "routed",
 		mutates: true,
-		docRoute: "styles.paragraph.setStyle",
-		blockParagraph: { kind: "style" },
-		normalizePayload: normalizeStyleIdPayload
+		docRoute: "tables.splitCell",
+		table: {
+			action: "split-cell",
+			op: "splitCell",
+			requiresCell: true
+		},
+		reason: TABLE_CONTEXT
 	},
 	{
-		id: "bullet-list",
-		family: "lists",
+		id: "table-remove-borders",
+		family: "tables",
 		disposition: "routed",
 		mutates: true,
-		docRoute: "lists.apply",
-		list: {
-			mode: "toggle-seed",
-			seed: "bullet"
-		}
+		docRoute: "tables.setBorders",
+		table: {
+			action: "remove-borders",
+			op: "setBorders"
+		},
+		reason: TABLE_CONTEXT
 	},
 	{
-		id: "numbered-list",
-		family: "lists",
+		id: "ruler",
+		family: "UI chrome",
 		disposition: "routed",
-		mutates: true,
-		docRoute: "lists.apply",
-		list: {
-			mode: "toggle-seed",
-			seed: "ordered"
-		}
+		mutates: false,
+		instanceRoute: "toggleRuler",
+		valueFrom: "ruler"
 	},
 	{
-		id: "indent-increase",
-		family: "lists/indent",
+		id: "formatting-marks",
+		family: "UI chrome",
 		disposition: "routed",
-		mutates: true,
-		docRoute: "lists.indent",
-		list: { mode: "indent" }
+		mutates: false,
+		instanceRoute: "toggleFormattingMarks",
+		valueFrom: "formattingMarks"
 	},
 	{
-		id: "indent-decrease",
-		family: "lists/indent",
+		id: "copy-format",
+		family: "formatting",
 		disposition: "routed",
+		mutates: false
+	},
+	{
+		id: "table-fix",
+		family: "tables",
+		disposition: "unsupported",
 		mutates: true,
-		docRoute: "lists.outdent",
-		list: { mode: "outdent" }
+		reason: UNSUPPORTED
+	}
+];
+var CATALOG_BY_ID = new Map(COMMAND_CATALOG.map((descriptor) => [descriptor.id, descriptor]));
+/** All built-in command ids known to the controller (routed + deferred + unsupported). */
+var ALL_BUILT_IN_COMMAND_IDS = COMMAND_CATALOG.map((d) => d.id);
+/** Resolve a command descriptor by id, or `null` when the id is unknown. */
+function getCommandDescriptor(id) {
+	return CATALOG_BY_ID.get(id) ?? null;
+}
+//#endregion
+//#region src/public/ui/entity-at.ts
+function parseCommaSeparatedIds(value) {
+	return value.split(",").map((id) => id.trim()).filter(Boolean);
+}
+/**
+* Collect every public-id candidate a painted run can carry for a tracked
+* change, deduped, in priority order: the canonical
+* `data-track-change-preferred-target-id` first (when the painter stamps one),
+* then the `data-track-change-ids` list, then the singular
+* `data-track-change-id`. The caller validates these against the live
+* tracked-changes slice and keeps whichever is the public id, so it does not
+* matter which attribute carries it — an imported/raw alias on one attribute
+* never hides the public id on another (a union, not a prefer-one-attribute).
+*/
+function getTrackChangeIds(node) {
+	const out = [];
+	const add = (id) => {
+		if (id && !out.includes(id)) out.push(id);
+	};
+	add(node.getAttribute("data-track-change-preferred-target-id"));
+	const list = node.getAttribute("data-track-change-ids");
+	if (list) for (const id of parseCommaSeparatedIds(list)) add(id);
+	add(node.getAttribute("data-track-change-id"));
+	return out;
+}
+/**
+* Read painted entities off `el` and every ancestor up to the document root, or
+* up to and INCLUDING `stopAt` when given. Innermost-first ordering: a tracked
+* change inside a comment highlight returns `[{ trackedChange }, { comment }]`,
+* matching what a switch on `hits[0]` expects when picking the most specific
+* entity.
+*
+* `stopAt` bounds the walk to the visible host: its own attributes are read, but
+* the walk never climbs into an app wrapper ABOVE it, so wrapper data-* cannot
+* leak into the hits. Omitting it keeps the original walk-to-document-root.
+*
+* Returns `[]` for null / non-Element starts. Uses duck-typed `getAttribute`
+* access so it works under any DOM implementation (happy-dom, jsdom, real
+* browser) without an `instanceof` check that could fail across realms.
+*/
+function collectEntityHitsFromChain(start, stopAt) {
+	if (!start || typeof start.getAttribute !== "function") return [];
+	const hits = [];
+	const seen = /* @__PURE__ */ new Set();
+	let pendingStory = [];
+	let nearestStoryKey = null;
+	let nearestLayoutStory = null;
+	let el = start;
+	while (el) {
+		const node = el;
+		nearestStoryKey ??= node.getAttribute("data-story-key");
+		const trackChangeIds = getTrackChangeIds(node);
+		const storyKey = trackChangeIds.length > 0 ? node.getAttribute("data-story-key") : null;
+		for (const trackChangeId of trackChangeIds) {
+			const key = `trackedChange:${trackChangeId}`;
+			if (!seen.has(key)) {
+				seen.add(key);
+				const hit = {
+					type: "trackedChange",
+					id: trackChangeId
+				};
+				if (storyKey) hit.storyKey = storyKey;
+				hits.push(hit);
+				pendingStory.push(hit);
+			}
+		}
+		const layoutStory = node.getAttribute("data-layout-story");
+		nearestLayoutStory ??= layoutStory;
+		if (layoutStory && pendingStory.length > 0) {
+			for (const hit of pendingStory) hit.story = layoutStory;
+			pendingStory = [];
+		}
+		const citationId = node.getAttribute("data-citation-id");
+		if (citationId) {
+			const key = `citation:${citationId}`;
+			if (!seen.has(key)) {
+				seen.add(key);
+				hits.push({
+					type: "citation",
+					id: citationId
+				});
+			}
+		}
+		const commentIds = node.getAttribute("data-comment-ids");
+		if (commentIds) for (const id of parseCommaSeparatedIds(commentIds)) {
+			const key = `comment:${id}`;
+			if (!seen.has(key)) {
+				seen.add(key);
+				hits.push({
+					type: "comment",
+					id
+				});
+			}
+		}
+		const sdtType = node.getAttribute("data-sdt-type");
+		const sdtId = node.getAttribute("data-sdt-id");
+		if (sdtId && sdtType === "structuredContent") {
+			const key = `contentControl:${sdtId}`;
+			if (!seen.has(key)) {
+				seen.add(key);
+				const scopeAttr = node.getAttribute("data-sdt-scope");
+				const tag = node.getAttribute("data-sdt-tag");
+				const hit = {
+					type: "contentControl",
+					id: sdtId
+				};
+				if (nearestStoryKey) hit.storyKey = nearestStoryKey;
+				if (nearestLayoutStory) hit.story = nearestLayoutStory;
+				else pendingStory.push(hit);
+				if (scopeAttr === "block" || scopeAttr === "inline") hit.scope = scopeAttr;
+				if (tag) hit.tag = tag;
+				hits.push(hit);
+			}
+		}
+		if (stopAt && el === stopAt) break;
+		el = el.parentElement;
+	}
+	return hits;
+}
+//#endregion
+//#region ../layout-engine/contracts/src/direction-context.ts
+/**
+* Read a paragraph's inline base direction from its attributes.
+*
+* Prefers the resolved {@link ParagraphDirectionContext} (SD-2776) when
+* present. Falls back to `paragraphProperties.rightToLeft` for PM-node /
+* editor paths that store direction on the raw OOXML properties rather
+* than the typed direction context.
+*
+* Consumers should call this instead of inspecting attrs ad hoc so the
+* direction source check stays in one place.
+*/
+function getParagraphInlineDirection(attrs) {
+	const fromContext = attrs?.directionContext?.inlineDirection;
+	if (fromContext != null) return fromContext;
+	const ppRtl = attrs?.paragraphProperties?.rightToLeft;
+	if (ppRtl === true) return "rtl";
+	if (ppRtl === false) return "ltr";
+}
+//#endregion
+//#region ../layout-engine/contracts/src/drawing-taxonomy.ts
+/**
+* Frozen canonical diagnostic codes for drawing rendering.
+*
+* New extractor/adapter diagnostics MUST use these exact strings. Family-
+* specific codes are required — do not collapse everything to
+* `render.unsupported-inline-ooxml` (plan §4).
+*/
+var DRAWING_DIAGNOSTIC_CODES = {
+	/** External image relationship (`r:link` / `TargetMode="External"`). Not fetched. */
+	externalImageDeferred: "render.media.external-image-deferred",
+	/** Drawing references a relationship id that does not exist on the owner part. */
+	missingRelationship: "render.drawing.missing-relationship",
+	/** Relationship resolves but the target media part bytes are missing/empty. */
+	missingMediaPart: "render.media.missing-part",
+	/** Relationship exists but is not an image relationship type. */
+	unsupportedRelationshipType: "render.drawing.unsupported-relationship-type",
+	/** Media MIME is not in the supported allowlist. */
+	unsupportedMime: "render.media.unsupported-mime",
+	/** Media part exceeds the host byte-size policy before bytes are materialized. */
+	imageTooLarge: "render.media.image-too-large",
+	/** SVG content rejected by the SVG safety policy. */
+	unsafeSvg: "render.media.unsafe-svg",
+	/** Metafile / TIFF (EMF, WMF, TIFF) with no approved conversion path. */
+	unsupportedFormat: "render.media.unsupported-format",
+	/** OLE / ActiveX / embedded package object. */
+	embeddedObjectNotSupported: "render.embedded-object-not-supported",
+	/** SmartArt / diagram / unknown external graphic-data object. */
+	unsupportedObject: "render.drawing.unsupported-object",
+	/** VML structure outside any supported image-like subset. */
+	vmlUnsupported: "render.drawing.vml-unsupported",
+	/** VML image-like content that could not be promoted to a supported image. */
+	vmlImageUnsupported: "render.drawing.vml-image-unsupported",
+	/** Custom geometry command the extractor does not implement (e.g. `arcTo`). */
+	unsupportedGeometryCommand: "render.drawing.unsupported-geometry-command",
+	/** Anchor fields required for honest placement are unsupported. */
+	anchorUnsupported: "render.drawing.anchor-unsupported",
+	/** Wrap fields required for honest placement are unsupported. */
+	wrapUnsupported: "render.drawing.wrap-unsupported",
+	/** `mc:AlternateContent` had no supported choice and no usable fallback. */
+	altContentNoSupportedChoice: "render.drawing.altcontent-no-supported-choice",
+	/** A child of an otherwise-supported group is unsupported. */
+	groupChildUnsupported: "render.drawing.group-child-unsupported"
+};
+DRAWING_DIAGNOSTIC_CODES.missingRelationship, DRAWING_DIAGNOSTIC_CODES.unsupportedRelationshipType, DRAWING_DIAGNOSTIC_CODES.unsupportedRelationshipType, DRAWING_DIAGNOSTIC_CODES.imageTooLarge, DRAWING_DIAGNOSTIC_CODES.missingMediaPart, DRAWING_DIAGNOSTIC_CODES.unsupportedObject, DRAWING_DIAGNOSTIC_CODES.vmlUnsupported;
+/**
+* The frozen drawing support taxonomy.
+*
+* Invariants (enforced by `drawing-taxonomy.test.ts`):
+* - every `supported` family has a real contract target (`!== 'none'`);
+* - every `DrawingBlock`-targeted family declares a `drawingKind`;
+* - every `fail-closed` family declares a canonical `diagnostic`;
+* - every canonical diagnostic code is referenced by at least one fail-closed
+*   family;
+* - `deferred` families make no support claim (`contract: 'none'`, no
+*   diagnostic).
+*/
+var DRAWING_SUPPORT_TAXONOMY = {
+	inlineBitmap: {
+		family: "inlineBitmap",
+		support: "supported",
+		description: "wp:inline pic:pic with internal media and browser-safe MIME (PNG/JPEG; WebP/SVG once the host media resolver lands).",
+		contract: "ImageRun"
 	},
-	{
-		id: "direction-ltr",
-		family: "direction",
-		disposition: "routed",
-		mutates: true,
-		docRoute: "format.paragraph.setDirection",
-		blockParagraph: {
-			kind: "direction",
-			fixedValue: "ltr"
-		}
+	anchoredBitmap: {
+		family: "anchoredBitmap",
+		support: "supported",
+		description: "wp:anchor bitmap with anchor/wrap expressible by ImageAnchor/ImageWrap. Never silently inlined.",
+		contract: "ImageBlock"
 	},
-	{
-		id: "direction-rtl",
-		family: "direction",
-		disposition: "routed",
-		mutates: true,
-		docRoute: "format.paragraph.setDirection",
-		blockParagraph: {
-			kind: "direction",
-			fixedValue: "rtl"
-		}
+	imageChildInGroup: {
+		family: "imageChildInGroup",
+		support: "supported",
+		description: "Bitmap child of a supported DrawingML group/drawing wrapper. Supported only when the parent is.",
+		contract: "ImageDrawing"
 	},
-	{
-		id: "clear-formatting",
-		family: "formatting",
-		disposition: "routed",
-		mutates: true,
-		docRoute: "format.apply",
-		inline: {
-			key: "*",
-			kind: "clear"
-		}
+	vectorShape: {
+		family: "vectorShape",
+		support: "supported",
+		description: "Block/floating DrawingML preset/custom shape with the supported geometry/style subset.",
+		contract: "DrawingBlock",
+		drawingKind: "vectorShape"
 	},
-	{
-		id: "image",
-		family: "media",
-		disposition: "routed",
-		mutates: true,
-		docRoute: "create.image",
-		create: { kind: "image" }
+	shapeGroup: {
+		family: "shapeGroup",
+		support: "supported",
+		description: "DrawingML group whose rendered children are supported vector/image children.",
+		contract: "DrawingBlock",
+		drawingKind: "shapeGroup"
 	},
-	{
-		id: "table-of-contents-insert",
-		family: "TOC",
-		disposition: "routed",
-		mutates: true,
-		docRoute: "create.tableOfContents",
-		create: { kind: "toc" }
+	chart: {
+		family: "chart",
+		support: "supported",
+		description: "DrawingML chart projected into a ChartDrawing with parsed cached chart XML data. Complete Word chart fidelity remains deferred to chartFidelity.",
+		contract: "DrawingBlock",
+		drawingKind: "chart"
 	},
-	{
-		id: "table-insert",
-		family: "tables",
-		disposition: "routed",
-		mutates: true,
-		docRoute: "create.table",
-		create: { kind: "table" }
+	alternateContent: {
+		family: "alternateContent",
+		support: "supported",
+		description: "mc:AlternateContent traversal/select policy. Selected Choice/Fallback maps to its family contract; unselected branches preserved for save/reopen.",
+		contract: "selected-choice"
 	},
-	{
-		id: "table-add-row-before",
-		family: "tables",
-		disposition: "routed",
-		mutates: true,
-		docRoute: "tables.insertRow",
-		table: {
-			action: "insert-row-before",
-			op: "insertRow"
-		},
-		reason: TABLE_CONTEXT
+	externalImage: {
+		family: "externalImage",
+		support: "fail-closed",
+		description: "External image relationship (r:link / TargetMode=\"External\"). Not fetched.",
+		contract: "none",
+		diagnostic: DRAWING_DIAGNOSTIC_CODES.externalImageDeferred
 	},
-	{
-		id: "table-add-row-after",
-		family: "tables",
-		disposition: "routed",
-		mutates: true,
-		docRoute: "tables.insertRow",
-		table: {
-			action: "insert-row-after",
-			op: "insertRow"
-		},
-		reason: TABLE_CONTEXT
+	missingRelationship: {
+		family: "missingRelationship",
+		support: "fail-closed",
+		description: "Drawing references a relationship id absent from the owner part .rels.",
+		contract: "none",
+		diagnostic: DRAWING_DIAGNOSTIC_CODES.missingRelationship
 	},
-	{
-		id: "table-delete-row",
-		family: "tables",
-		disposition: "routed",
-		mutates: true,
-		docRoute: "tables.deleteRow",
-		table: {
-			action: "delete-row",
-			op: "deleteRow"
-		},
-		reason: TABLE_CONTEXT
+	missingMediaPart: {
+		family: "missingMediaPart",
+		support: "fail-closed",
+		description: "Relationship resolves but the target media part bytes are missing or empty.",
+		contract: "none",
+		diagnostic: DRAWING_DIAGNOSTIC_CODES.missingMediaPart
 	},
-	{
-		id: "table-add-column-before",
-		family: "tables",
-		disposition: "routed",
-		mutates: true,
-		docRoute: "tables.insertColumn",
-		table: {
-			action: "insert-column-before",
-			op: "insertColumn"
-		},
-		reason: TABLE_CONTEXT
+	wrongRelationshipType: {
+		family: "wrongRelationshipType",
+		support: "fail-closed",
+		description: "Relationship exists but is not an image relationship type.",
+		contract: "none",
+		diagnostic: DRAWING_DIAGNOSTIC_CODES.unsupportedRelationshipType
 	},
-	{
-		id: "table-add-column-after",
-		family: "tables",
-		disposition: "routed",
-		mutates: true,
-		docRoute: "tables.insertColumn",
-		table: {
-			action: "insert-column-after",
-			op: "insertColumn"
-		},
-		reason: TABLE_CONTEXT
+	unsupportedMime: {
+		family: "unsupportedMime",
+		support: "fail-closed",
+		description: "Media MIME outside the supported allowlist (incl. GIF/BMP/ICO).",
+		contract: "none",
+		diagnostic: DRAWING_DIAGNOSTIC_CODES.unsupportedMime
 	},
-	{
-		id: "table-delete-column",
-		family: "tables",
-		disposition: "routed",
-		mutates: true,
-		docRoute: "tables.deleteColumn",
-		table: {
-			action: "delete-column",
-			op: "deleteColumn"
-		},
-		reason: TABLE_CONTEXT
+	oversizedMediaPart: {
+		family: "oversizedMediaPart",
+		support: "fail-closed",
+		description: "Media part exceeds the host byte-size policy before bytes are materialized.",
+		contract: "none",
+		diagnostic: DRAWING_DIAGNOSTIC_CODES.imageTooLarge
 	},
-	{
-		id: "table-delete",
-		family: "tables",
-		disposition: "routed",
-		mutates: true,
-		docRoute: "tables.delete",
-		table: {
-			action: "delete-table",
-			op: "delete"
-		},
-		reason: TABLE_CONTEXT
+	unsafeSvg: {
+		family: "unsafeSvg",
+		support: "fail-closed",
+		description: "SVG content rejected by the SVG safety policy.",
+		contract: "none",
+		diagnostic: DRAWING_DIAGNOSTIC_CODES.unsafeSvg
 	},
-	{
-		id: "table-merge-cells",
-		family: "tables",
-		disposition: "routed",
-		mutates: true,
-		docRoute: "tables.mergeCells",
-		table: {
-			action: "merge-cells",
-			op: "mergeCells"
-		},
-		reason: TABLE_CONTEXT
+	metafileOrTiff: {
+		family: "metafileOrTiff",
+		support: "fail-closed",
+		description: "EMF/WMF/TIFF and other non-browser-native formats with no approved conversion path.",
+		contract: "none",
+		diagnostic: DRAWING_DIAGNOSTIC_CODES.unsupportedFormat
 	},
-	{
-		id: "table-split-cell",
-		family: "tables",
-		disposition: "routed",
-		mutates: true,
-		docRoute: "tables.splitCell",
-		table: {
-			action: "split-cell",
-			op: "splitCell",
-			requiresCell: true
-		},
-		reason: TABLE_CONTEXT
+	embeddedObject: {
+		family: "embeddedObject",
+		support: "fail-closed",
+		description: "OLE / ActiveX / embedded package object.",
+		contract: "none",
+		diagnostic: DRAWING_DIAGNOSTIC_CODES.embeddedObjectNotSupported
 	},
-	{
-		id: "table-remove-borders",
-		family: "tables",
-		disposition: "routed",
-		mutates: true,
-		docRoute: "tables.setBorders",
-		table: {
-			action: "remove-borders",
-			op: "setBorders"
-		},
-		reason: TABLE_CONTEXT
+	smartArtOrDiagram: {
+		family: "smartArtOrDiagram",
+		support: "fail-closed",
+		description: "SmartArt / diagram / unknown external graphic-data object.",
+		contract: "none",
+		diagnostic: DRAWING_DIAGNOSTIC_CODES.unsupportedObject
 	},
-	{
-		id: "ruler",
-		family: "UI chrome",
-		disposition: "routed",
-		mutates: false,
-		instanceRoute: "toggleRuler",
-		valueFrom: "ruler"
+	vml: {
+		family: "vml",
+		support: "fail-closed",
+		description: "VML structure outside any supported image-like subset (default fail-closed policy).",
+		contract: "none",
+		diagnostic: DRAWING_DIAGNOSTIC_CODES.vmlUnsupported
 	},
-	{
-		id: "formatting-marks",
-		family: "UI chrome",
-		disposition: "routed",
-		mutates: false,
-		instanceRoute: "toggleFormattingMarks",
-		valueFrom: "formattingMarks"
+	vmlImageLike: {
+		family: "vmlImageLike",
+		support: "fail-closed",
+		description: "Simple VML image references (v:imagedata) / watermark image metadata. Fail-closed unless a later change promotes a named subset with deterministic fixtures and exact oracles.",
+		contract: "none",
+		diagnostic: DRAWING_DIAGNOSTIC_CODES.vmlImageUnsupported
 	},
-	{
-		id: "copy-format",
-		family: "formatting",
-		disposition: "routed",
-		mutates: false
+	unsupportedGeometryCommand: {
+		family: "unsupportedGeometryCommand",
+		support: "fail-closed",
+		description: "Custom geometry command the extractor does not implement, e.g. arcTo.",
+		contract: "none",
+		diagnostic: DRAWING_DIAGNOSTIC_CODES.unsupportedGeometryCommand
 	},
-	{
-		id: "table-fix",
-		family: "tables",
-		disposition: "unsupported",
-		mutates: true,
-		reason: UNSUPPORTED
-	}
-];
-var CATALOG_BY_ID = new Map(COMMAND_CATALOG.map((descriptor) => [descriptor.id, descriptor]));
-/** All built-in command ids known to the controller (routed + deferred + unsupported). */
-var ALL_BUILT_IN_COMMAND_IDS = COMMAND_CATALOG.map((d) => d.id);
-/** Resolve a command descriptor by id, or `null` when the id is unknown. */
-function getCommandDescriptor(id) {
-	return CATALOG_BY_ID.get(id) ?? null;
-}
-//#endregion
-//#region src/public/ui/equality.ts
-/**
-* Shallow equality used by the controller to suppress redundant slice
-* notifications. v2-native, dependency-free.
-*/
-/**
-* Returns `true` when `a` and `b` are the same reference, or are objects with
-* the same own-enumerable keys and `Object.is`-equal values one level deep.
-* Arrays compare by index. Primitives compare with `Object.is`.
-*/
-function shallowEqual(a, b) {
-	if (Object.is(a, b)) return true;
-	if (typeof a !== "object" || a === null || typeof b !== "object" || b === null) return false;
-	if (Array.isArray(a) !== Array.isArray(b)) return false;
-	const aKeys = Object.keys(a);
-	const bKeys = Object.keys(b);
-	if (aKeys.length !== bKeys.length) return false;
-	for (const key of aKeys) {
-		if (!Object.prototype.hasOwnProperty.call(b, key)) return false;
-		if (!Object.is(a[key], b[key])) return false;
-	}
-	return true;
-}
-//#endregion
-//#region src/public/ui/format-painter-helpers.js
-/**
-* Maps SDRunProps field names to InlineRunPatch field names.
-* SDRunProps (read-side) and InlineRunPatch (write-side) use different keys
-* for the same properties; direct assignment between them is forbidden.
-*
-* @param {Record<string, unknown>} props - SDRunProps object from doc.getNodeById
-* @returns {Record<string, unknown>} InlineRunPatch ready for doc.format.apply
-*/
-function sdRunPropsToInlineRunPatch(props) {
-	if (!props || typeof props !== "object") return {};
-	const patch = {};
-	if (props.fonts) patch.rFonts = {
-		ascii: props.fonts.ascii,
-		hAnsi: props.fonts.hAnsi,
-		eastAsia: props.fonts.eastAsia,
-		cs: props.fonts.cs,
-		asciiTheme: props.fonts.asciiTheme,
-		hAnsiTheme: props.fonts.hAnsiTheme,
-		eastAsiaTheme: props.fonts.eastAsiaTheme,
-		csTheme: props.fonts.csTheme,
-		hint: props.fonts.hint
-	};
-	if (props.fontFamily != null) patch.fontFamily = props.fontFamily;
-	if (props.lang) patch.lang = {
-		val: props.lang.val,
-		eastAsia: props.lang.eastAsia,
-		bidi: props.lang.bidi
-	};
-	if (props.fontSize != null) patch.fontSize = props.fontSize;
-	if (props.fontSizeCs != null) patch.fontSizeCs = props.fontSizeCs;
-	const color = projectColorRefToInlineColor(props.color);
-	if (color != null) patch.color = color;
-	if (props.highlight != null) patch.highlight = props.highlight;
-	const shading = projectShadingToInlinePatch(props.shading);
-	if (shading) patch.shading = shading;
-	if (props.cs != null) patch.cs = props.cs;
-	if (props.rtl != null) patch.rtl = props.rtl;
-	if (props.bold != null) patch.bold = props.bold;
-	if (props.boldCs != null) patch.bCs = props.boldCs;
-	if (props.italic != null) patch.italic = props.italic;
-	if (props.italicCs != null) patch.iCs = props.italicCs;
-	const underline = projectUnderlineToInlinePatch(props.underline);
-	if (underline !== void 0) patch.underline = underline;
-	if (props.strikethrough != null) patch.strike = props.strikethrough;
-	if (props.doubleStrikethrough != null) patch.dstrike = props.doubleStrikethrough;
-	if (props.caps != null) patch.caps = props.caps;
-	if (props.smallCaps != null) patch.smallCaps = props.smallCaps;
-	if (props.outline != null) patch.outline = props.outline;
-	if (props.shadow != null) patch.shadow = props.shadow;
-	if (props.emboss != null) patch.emboss = props.emboss;
-	if (props.imprint != null) patch.imprint = props.imprint;
-	if (props.verticalAlign != null) patch.vertAlign = props.verticalAlign;
-	if (props.characterSpacing != null) patch.letterSpacing = props.characterSpacing;
-	if (props.characterScale != null) patch.charScale = props.characterScale;
-	if (props.kern != null) patch.kerning = props.kern;
-	if (props.baselineShift != null) patch.position = props.baselineShift;
-	if (props.fitTextWidth != null) patch.fitText = { val: props.fitTextWidth };
-	if (props.vanish != null) patch.vanish = props.vanish;
-	if (props.webHidden != null) patch.webHidden = props.webHidden;
-	if (props.specVanish != null) patch.specVanish = props.specVanish;
-	const border = projectBorderToInlinePatch(props.border);
-	if (border) patch.border = border;
-	return patch;
-}
-function projectColorRefToInlineColor(color) {
-	if (!color) return void 0;
-	if (typeof color === "string") return color;
-	if (color.model === "rgb") return color.value;
-	if (color.model === "auto") return "auto";
-}
-function projectUnderlineToInlinePatch(underline) {
-	if (underline == null) return void 0;
-	const patch = {};
-	if (underline.style != null) patch.style = underline.style;
-	if (underline.color?.model === "rgb") patch.color = underline.color.value;
-	if (underline.color?.model === "theme") patch.themeColor = underline.color.theme;
-	return Object.keys(patch).length > 0 ? patch : true;
-}
-function projectShadingToInlinePatch(shading) {
-	if (!shading) return void 0;
-	const patch = {};
-	const fill = projectColorRefToInlineColor(shading.fill);
-	if (fill != null) patch.fill = fill;
-	const color = projectColorRefToInlineColor(shading.color);
-	if (color != null) patch.color = color;
-	if (shading.pattern != null) patch.val = shading.pattern;
-	return Object.keys(patch).length > 0 ? patch : void 0;
-}
-function projectBorderToInlinePatch(border) {
-	if (!border) return void 0;
-	const patch = {};
-	if (border.style != null) patch.val = border.style;
-	if (border.width != null) patch.sz = border.width;
-	if (border.space != null) patch.space = border.space;
-	const color = projectColorRefToInlineColor(border.color);
-	if (color != null) patch.color = color;
-	return Object.keys(patch).length > 0 ? patch : void 0;
-}
-/**
-* Serializes a selection to a stable string key used to detect whether
-* the target selection is the same as the source (skip apply in that case).
-*
-* Falls back to the plain text target when the host has not populated an
-* explicit `selectionTarget` yet.
-*
-* @param {{ selectionTarget?: unknown; target?: unknown } | null | undefined} selection
-* @returns {string}
-*/
-function selectionKey(selection) {
-	const target = selection?.selectionTarget ?? selection?.target;
-	if (!selection || !target) return "";
-	try {
-		return JSON.stringify(target);
-	} catch {
-		return String(target);
+	unsupportedAnchorFields: {
+		family: "unsupportedAnchorFields",
+		support: "fail-closed",
+		description: "Anchor fields required for honest placement are unsupported (char-relative, alignment modes, etc.).",
+		contract: "none",
+		diagnostic: DRAWING_DIAGNOSTIC_CODES.anchorUnsupported
+	},
+	unsupportedWrapFields: {
+		family: "unsupportedWrapFields",
+		support: "fail-closed",
+		description: "Wrap fields required for honest placement are unsupported (arbitrary wrap polygons, etc.).",
+		contract: "none",
+		diagnostic: DRAWING_DIAGNOSTIC_CODES.wrapUnsupported
+	},
+	alternateContentNoSupportedChoice: {
+		family: "alternateContentNoSupportedChoice",
+		support: "fail-closed",
+		description: "mc:AlternateContent with no supported choice and no usable fallback.",
+		contract: "none",
+		diagnostic: DRAWING_DIAGNOSTIC_CODES.altContentNoSupportedChoice
+	},
+	groupChildUnsupported: {
+		family: "groupChildUnsupported",
+		support: "fail-closed",
+		description: "Unsupported child inside an otherwise-supported group. Supported siblings are not dropped.",
+		contract: "none",
+		diagnostic: DRAWING_DIAGNOSTIC_CODES.groupChildUnsupported
+	},
+	objectEditing: {
+		family: "objectEditing",
+		support: "deferred",
+		description: "Editing/mutation of anchored/vector objects.",
+		contract: "none"
+	},
+	customWrapPolygon: {
+		family: "customWrapPolygon",
+		support: "deferred",
+		description: "Full Word-compatible text wrapping for arbitrary custom wrap polygons.",
+		contract: "none"
+	},
+	chartFidelity: {
+		family: "chartFidelity",
+		support: "deferred",
+		description: "Complete chart fidelity (a dedicated chart effort owns the parsed subset).",
+		contract: "none"
+	},
+	vmlFidelity: {
+		family: "vmlFidelity",
+		support: "deferred",
+		description: "Complete VML fidelity.",
+		contract: "none"
+	},
+	decorativeAccessibilityUi: {
+		family: "decorativeAccessibilityUi",
+		support: "deferred",
+		description: "Full accessibility UI for decorative image semantics beyond preserving source data.",
+		contract: "none"
 	}
-}
-//#endregion
-//#region src/helpers/v2-typing-mutation-event.js
-/**
-* Command kinds whose committed mutations belong to the sustained typing
-* cadence class (insert / replace / plain paste / Backspace / Delete).
-*
-* The SuperDoc shell debounces per-keystroke review-row hydration for these
-* kinds instead of refreshing comments + tracked changes on every commit —
-* hydrating immediately per keystroke was a measured worker-read storm during
-* typing and backspace bursts. The `text.*` aliases cover integrations that
-* forward Document API style command ids rather than editable-input kinds.
-*/
-var V2_TYPING_COMMAND_KINDS = /* @__PURE__ */ new Set([
-	"insert-text",
-	"replace-text",
-	"plain-text-paste",
-	"delete-backward",
-	"delete-forward",
-	"text.insert",
-	"text.replace",
-	"text.pastePlain",
-	"text.deleteBackward",
-	"text.deleteForward",
-	"structural.enter",
-	"structural:enter-split-paragraph",
-	"structural:enter-insert-paragraph-before",
-	"structural:enter-insert-paragraph-after",
-	"structural:shift-enter-line-break",
-	"structural:backspace-boundary-merge-with-previous",
-	"structural:delete-boundary-merge-with-next",
-	"backspace:boundary-merge-with-previous",
-	"backspace:list-remove",
-	"backspace:list-outdent"
-]);
-/**
-* True when a forwarded v2 host event is a committed editable-input mutation
-* of the sustained-typing class, i.e. review-row hydration for it should be
-* debounced rather than fired immediately.
-*
-* Events without a forwarded `editableCommandKind` (programmatic Document API
-* mutations, history commits, unclassified structural commands) return false
-* so they keep hydrating immediately.
-*
-* @param {{ type?: string, origin?: string, editableCommandKind?: string } | null | undefined} event
-* @returns {boolean}
-*/
-var isV2EditableTextMutationEvent = (event) => {
-	if (event?.type !== "mutation:committed" || event.origin !== "command") return false;
-	return V2_TYPING_COMMAND_KINDS.has(event.editableCommandKind);
 };
-//#endregion
-//#region src/public/ui/entity-at.ts
-function parseCommaSeparatedIds(value) {
-	return value.split(",").map((id) => id.trim()).filter(Boolean);
-}
-/**
-* Collect every public-id candidate a painted run can carry for a tracked
-* change, deduped, in priority order: the canonical
-* `data-track-change-preferred-target-id` first (when the painter stamps one),
-* then the `data-track-change-ids` list, then the singular
-* `data-track-change-id`. The caller validates these against the live
-* tracked-changes slice and keeps whichever is the public id, so it does not
-* matter which attribute carries it — an imported/raw alias on one attribute
-* never hides the public id on another (a union, not a prefer-one-attribute).
-*/
-function getTrackChangeIds(node) {
-	const out = [];
-	const add = (id) => {
-		if (id && !out.includes(id)) out.push(id);
-	};
-	add(node.getAttribute("data-track-change-preferred-target-id"));
-	const list = node.getAttribute("data-track-change-ids");
-	if (list) for (const id of parseCommaSeparatedIds(list)) add(id);
-	add(node.getAttribute("data-track-change-id"));
-	return out;
-}
-/**
-* Read painted entities off `el` and every ancestor up to the document root, or
-* up to and INCLUDING `stopAt` when given. Innermost-first ordering: a tracked
-* change inside a comment highlight returns `[{ trackedChange }, { comment }]`,
-* matching what a switch on `hits[0]` expects when picking the most specific
-* entity.
-*
-* `stopAt` bounds the walk to the visible host: its own attributes are read, but
-* the walk never climbs into an app wrapper ABOVE it, so wrapper data-* cannot
-* leak into the hits. Omitting it keeps the original walk-to-document-root.
-*
-* Returns `[]` for null / non-Element starts. Uses duck-typed `getAttribute`
-* access so it works under any DOM implementation (happy-dom, jsdom, real
-* browser) without an `instanceof` check that could fail across realms.
-*/
-function collectEntityHitsFromChain(start, stopAt) {
-	if (!start || typeof start.getAttribute !== "function") return [];
-	const hits = [];
-	const seen = /* @__PURE__ */ new Set();
-	let pendingStory = [];
-	let el = start;
-	while (el) {
-		const node = el;
-		const trackChangeIds = getTrackChangeIds(node);
-		const storyKey = trackChangeIds.length > 0 ? node.getAttribute("data-story-key") : null;
-		for (const trackChangeId of trackChangeIds) {
-			const key = `trackedChange:${trackChangeId}`;
-			if (!seen.has(key)) {
-				seen.add(key);
-				const hit = {
-					type: "trackedChange",
-					id: trackChangeId
-				};
-				if (storyKey) hit.storyKey = storyKey;
-				hits.push(hit);
-				pendingStory.push(hit);
-			}
-		}
-		const layoutStory = node.getAttribute("data-layout-story");
-		if (layoutStory && pendingStory.length > 0) {
-			for (const hit of pendingStory) hit.story = layoutStory;
-			pendingStory = [];
-		}
-		const citationId = node.getAttribute("data-citation-id");
-		if (citationId) {
-			const key = `citation:${citationId}`;
-			if (!seen.has(key)) {
-				seen.add(key);
-				hits.push({
-					type: "citation",
-					id: citationId
-				});
-			}
-		}
-		const commentIds = node.getAttribute("data-comment-ids");
-		if (commentIds) for (const id of parseCommaSeparatedIds(commentIds)) {
-			const key = `comment:${id}`;
-			if (!seen.has(key)) {
-				seen.add(key);
-				hits.push({
-					type: "comment",
-					id
-				});
-			}
-		}
-		const sdtType = node.getAttribute("data-sdt-type");
-		const sdtId = node.getAttribute("data-sdt-id");
-		if (sdtId && sdtType === "structuredContent") {
-			const key = `contentControl:${sdtId}`;
-			if (!seen.has(key)) {
-				seen.add(key);
-				const scopeAttr = node.getAttribute("data-sdt-scope");
-				const tag = node.getAttribute("data-sdt-tag");
-				const hit = {
-					type: "contentControl",
-					id: sdtId
-				};
-				if (scopeAttr === "block" || scopeAttr === "inline") hit.scope = scopeAttr;
-				if (tag) hit.tag = tag;
-				hits.push(hit);
-			}
-		}
-		if (stopAt && el === stopAt) break;
-		el = el.parentElement;
-	}
-	return hits;
-}
+Object.keys(DRAWING_SUPPORT_TAXONOMY);
+Object.freeze([
+	"multiple-sections",
+	"furniture-page-tokens",
+	"non-balanceable-multi-column-sections",
+	"body-anchored-objects",
+	"non-flowing-page-relative-body-anchors",
+	"footnotes",
+	"page-references",
+	"cross-references",
+	"keep-constraints",
+	"tables",
+	"furniture-anchored-objects"
+]);
+var INCREMENTAL_DEPENDENCY_CERTIFICATE_CLASSES = Object.freeze([
+	"checkpoint-geometry",
+	"section-numbering",
+	"font-style-inputs",
+	"notes",
+	"furniture",
+	"flowing-anchors",
+	"non-flowing-page-anchors",
+	"convergence",
+	"source-topology"
+]);
+new Set(INCREMENTAL_DEPENDENCY_CERTIFICATE_CLASSES);
 //#endregion
 //#region ../document-api/src/format/inline-run-patch.ts
 var schemaBooleanOrNull = () => ({ oneOf: [{ type: "boolean" }, { type: "null" }] });
@@ -2295,6 +2302,19 @@ INLINE_PROPERTY_REGISTRY.filter((entry) => entry.storage === "mark").map((entry)
 * `false` when the surface is unavailable (view mode, a pre-ready editor, or a
 * host that has not exposed a Document API facade) rather than throwing.
 */
+var firstPartyCommandMutations = /* @__PURE__ */ new WeakMap();
+var firstPartyCommandExecutors = /* @__PURE__ */ new WeakMap();
+function registerFirstPartyCommandMutation(superdoc, host, mutation) {
+	let hosts = firstPartyCommandMutations.get(superdoc);
+	if (!hosts) {
+		hosts = /* @__PURE__ */ new WeakMap();
+		firstPartyCommandMutations.set(superdoc, hosts);
+	}
+	hosts.set(host, mutation);
+}
+function executeFirstPartyCommandAsync(ui, id, payload) {
+	return firstPartyCommandExecutors.get(ui)?.(id, payload) ?? ui.commands.executeAsync(id, payload);
+}
 function uiBenchNowMs() {
 	return typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
 }
@@ -2686,6 +2706,11 @@ function layoutStoryDatasetToStoryLocator(raw) {
 			storyType: "headerFooterPart",
 			refId: decoded.id
 		} : void 0;
+		case "textbox": return decoded.id ? {
+			kind: "story",
+			storyType: "textbox",
+			textboxId: decoded.id
+		} : void 0;
 		default: return;
 	}
 }
@@ -3915,6 +3940,7 @@ function createSuperDocUI(options) {
 		keyboardSelecting: false
 	};
 	let painterCaptureEpoch = 0;
+	let painterCommandDoc = null;
 	const painterModeListeners = /* @__PURE__ */ new Set();
 	let frozenProjectedValues = {};
 	let frozenProjectedValuesKey = "";
@@ -3964,8 +3990,10 @@ function createSuperDocUI(options) {
 		},
 		contextAt
 	};
+	let firstPartyCommandDoc;
 	/** Read the live browser Document API facade (or null). */
 	const getDoc = () => {
+		if (firstPartyCommandDoc !== void 0) return firstPartyCommandDoc;
 		const doc = getEditor()?.doc;
 		return doc && typeof doc === "object" ? doc : null;
 	};
@@ -3996,6 +4024,25 @@ function createSuperDocUI(options) {
 		const host = getEditor()?.host;
 		return host && typeof host === "object" ? host : null;
 	};
+	const createFirstPartyCommandDoc = () => {
+		const editor = getEditor();
+		const doc = editor?.doc;
+		if (editor?.editorVersion !== 2) return doc;
+		const host = getHost();
+		const mutation = host ? firstPartyCommandMutations.get(superdoc)?.get(host) : null;
+		if (!doc || !host || !mutation) return null;
+		const wrap = (source, prefix) => new Proxy(source, { get(target, key, receiver) {
+			const value = Reflect.get(target, key, receiver);
+			if (typeof key !== "string") return value;
+			const memberPath = prefix ? `${prefix}.${key}` : key;
+			if (typeof value === "function" && mutation.supports(memberPath)) return (...args) => {
+				if (getEditor() !== editor || getHost() !== host || editor.doc !== doc) return false;
+				return mutation.run(memberPath, args);
+			};
+			return value && (typeof value === "object" || typeof value === "function") ? wrap(value, memberPath) : value;
+		} });
+		return wrap(doc, "");
+	};
 	const resolveActiveHeaderFooterSlot = (story) => {
 		if (story.storyType !== "headerFooterPart" || typeof story.refId !== "string") return null;
 		const editor = getEditor();
@@ -7994,7 +8041,10 @@ function createSuperDocUI(options) {
 	function executeListToggleCommand(kind, payload) {
 		const lists = getEditCommands()?.lists;
 		const apply = lists?.apply;
-		if (typeof apply !== "function") return false;
+		const host = getHost();
+		const firstPartyMutation = firstPartyCommandDoc !== void 0 && getEditor()?.editorVersion === 2 && host ? firstPartyCommandMutations.get(superdoc)?.get(host) : null;
+		if (firstPartyCommandDoc !== void 0 && getEditor()?.editorVersion === 2 && !firstPartyMutation) return false;
+		if (!firstPartyMutation && typeof apply !== "function") return false;
 		const { behavior, preset, continuity } = typeof payload === "string" ? presetFromToolbarStyleKey(payload) : payload && typeof payload === "object" ? payload : {};
 		const input = {
 			kind,
@@ -8003,7 +8053,7 @@ function createSuperDocUI(options) {
 		if (preset !== void 0) input.preset = preset;
 		if (continuity !== void 0) input.continuity = continuity;
 		try {
-			return settleCommandExecution(apply.call(lists, input));
+			return settleCommandExecution(firstPartyMutation ? firstPartyMutation.runListApply(input) : apply.call(lists, input));
 		} catch {
 			return false;
 		}
@@ -8625,6 +8675,9 @@ function createSuperDocUI(options) {
 		const doc = getDoc();
 		const linksApi = doc?.hyperlinks;
 		if (!linksApi) return false;
+		const hyperlinkHost = getHost();
+		const hyperlinkHandles = typeof hyperlinkHost?.getHandles === "function" ? hyperlinkHost.getHandles() : null;
+		const trustedLinksApi = firstPartyCommandDoc ? (hyperlinkHandles?.editing)?.hyperlinks : linksApi;
 		const record = readLinkPayloadRecord(payload);
 		const href = readLinkPayloadHref(payload);
 		const payloadTarget = readLinkPayloadTarget(payload);
@@ -8648,7 +8701,7 @@ function createSuperDocUI(options) {
 			}
 		}
 		if (existing && href === null) {
-			const remove = linksApi.remove;
+			const remove = trustedLinksApi?.remove;
 			if (typeof remove !== "function") return false;
 			try {
 				return callEditorMutation("hyperlinks.remove", remove, {
@@ -8660,7 +8713,7 @@ function createSuperDocUI(options) {
 			}
 		}
 		if ((existing || requestedHyperlinkTarget) && typeof href === "string" && href.trim() !== "") {
-			const patch = linksApi.patch;
+			const patch = trustedLinksApi?.patch;
 			const updateTarget = linksApi.updateTarget;
 			if (!(!hasRequestedHyperlinkTarget && existing && typeof patch === "function") && !(hasRequestedHyperlinkTarget && typeof updateTarget === "function")) return false;
 			const shouldReplaceText = typeof text === "string" && text !== (hasRequestedHyperlinkTarget ? currentText : existing?.text ?? currentText);
@@ -8750,7 +8803,7 @@ function createSuperDocUI(options) {
 		}
 		if (typeof href === "string" && href.trim() !== "") {
 			const normalizedHref = href.trim();
-			const wrap = linksApi.wrap;
+			const wrap = trustedLinksApi?.wrap;
 			const textTargets = textAddressesFromTarget(payloadTarget);
 			const wrapTargets = textTargets.length > 0 ? textTargets : selectionTextAddresses(state.selection);
 			if (wrapTargets.length > 0) {
@@ -8764,7 +8817,7 @@ function createSuperDocUI(options) {
 					return false;
 				}
 			}
-			const insert = linksApi.insert;
+			const insert = trustedLinksApi?.insert;
 			const text = readLinkPayloadText(payload, normalizedHref);
 			if (typeof insert !== "function" || text.trim() === "") return false;
 			const target = collapsedTextAddressFromTarget(payloadTarget) ?? collapsedTextAddressFromSelection(state.selection);
@@ -8835,8 +8888,13 @@ function createSuperDocUI(options) {
 			if (typeof record.alt === "string") input.alt = record.alt;
 			if (typeof record.title === "string") input.title = record.title;
 			if (record.size && typeof record.size === "object") input.size = record.size;
+			const imageHost = getHost();
+			const imageHandles = typeof imageHost?.getHandles === "function" ? imageHost.getHandles() : null;
+			const trustedImageCommands = firstPartyCommandDoc ? (imageHandles?.editing)?.images : null;
+			const create = firstPartyCommandDoc ? trustedImageCommands?.create : op;
+			if (typeof create !== "function") return false;
 			try {
-				return callEditorMutation(descriptor.docRoute, op, input);
+				return callEditorMutation(descriptor.docRoute, create, input);
 			} catch {
 				return false;
 			}
@@ -8850,6 +8908,13 @@ function createSuperDocUI(options) {
 			return false;
 		}
 	};
+	const tableInsertionCommands = () => {
+		if (firstPartyCommandDoc === null) return null;
+		const host = getHost();
+		if (!host) return null;
+		if (firstPartyCommandDoc !== void 0) return ((typeof host.getHandles === "function" ? host.getHandles() : null)?.editing)?.tables ?? null;
+		return typeof host.getCodeTableEditingCommands === "function" ? host.getCodeTableEditingCommands() : null;
+	};
 	/**
 	* Route a table cell-context command (`tables.*`) against the live table
 	* context resolved from the shared facade. Fails closed (`false`) when the
@@ -8866,16 +8931,14 @@ function createSuperDocUI(options) {
 		if (!input) return false;
 		try {
 			if (spec.action === "insert-row-before" || spec.action === "insert-row-after") {
-				const host = getHost();
-				const tableCommands = ((typeof host?.getHandles === "function" ? host.getHandles() : null)?.editing)?.tables;
+				const tableCommands = tableInsertionCommands();
 				if (typeof tableCommands?.insertRow !== "function") return false;
 				const options = editorMutationOptionsForRoute(descriptor.docRoute);
 				if (options && options.success === false) return options;
 				return options ? tableCommands.insertRow(input, options) : tableCommands.insertRow(input);
 			}
 			if (spec.action === "insert-column-before" || spec.action === "insert-column-after") {
-				const host = getHost();
-				const tableCommands = ((typeof host?.getHandles === "function" ? host.getHandles() : null)?.editing)?.tables;
+				const tableCommands = tableInsertionCommands();
 				if (typeof tableCommands?.insertColumn !== "function") return false;
 				const options = editorMutationOptionsForRoute(descriptor.docRoute);
 				if (options && options.success === false) return options;
@@ -8974,9 +9037,10 @@ function createSuperDocUI(options) {
 			let releaseScheduledMutation = null;
 			try {
 				const commandEditor = getEditor();
+				const commandDocSource = commandEditor?.doc;
 				const commandMode = readDocumentMode();
 				const mutate = () => {
-					if (getEditor() !== commandEditor || getDoc() !== doc || readDocumentMode() !== commandMode) return false;
+					if (getEditor() !== commandEditor || commandEditor?.doc !== commandDocSource || readDocumentMode() !== commandMode) return false;
 					return callInlineFormatMutation(route, op, input);
 				};
 				const selectionSignature = selectionInlineValueSignature(state.selection) ?? selectionKey(state.selection);
@@ -9026,12 +9090,14 @@ function createSuperDocUI(options) {
 			return false;
 		}
 	};
-	const executeCommand = (id, payload, context) => {
+	const runCommand = (id, payload, context, firstParty) => {
 		const actionId = beginInteraction(superdoc, "command:started", () => ({
 			commandId: id,
 			selection: state.selection
 		}));
 		let result;
+		const previousCommandDoc = firstPartyCommandDoc;
+		firstPartyCommandDoc = firstParty && !customCommands.has(id) ? createFirstPartyCommandDoc() : void 0;
 		try {
 			result = executeCommandInternal(id, payload, context);
 		} catch (error) {
@@ -9041,6 +9107,8 @@ function createSuperDocUI(options) {
 				outcome: "threw"
 			}));
 			throw error;
+		} finally {
+			firstPartyCommandDoc = previousCommandDoc;
 		}
 		const settled = (value) => recordInteraction(superdoc, "command:settled", () => ({
 			actionId,
@@ -9054,8 +9122,10 @@ function createSuperDocUI(options) {
 		} catch {}
 		return result;
 	};
+	const executeCommand = (id, payload, context) => runCommand(id, payload, context, false);
 	const exitFormatPainter = () => {
 		painterCaptureEpoch += 1;
+		painterCommandDoc = null;
 		painter = {
 			mode: "idle",
 			snapshot: null,
@@ -9068,6 +9138,7 @@ function createSuperDocUI(options) {
 		recompute();
 	};
 	const executeCopyFormat = async () => {
+		const commandDoc = firstPartyCommandDoc ?? null;
 		const visibleActiveMarksAtClick = [
 			"bold",
 			"italic",
@@ -9110,6 +9181,7 @@ function createSuperDocUI(options) {
 			sourceSelectionKey: selectionKey(captureSlice),
 			lastClickAt: now
 		};
+		painterCommandDoc = commandDoc;
 		for (const cb of painterModeListeners) cb(painter.mode);
 		recompute();
 		return true;
@@ -9293,7 +9365,7 @@ function createSuperDocUI(options) {
 			if (painter.mode === "armed") exitFormatPainter();
 			return;
 		}
-		const doc = getDoc();
+		const doc = painterCommandDoc ?? getDoc();
 		if (!doc) return;
 		const targetSelection = selectionSliceFromInfo(selection, "ready");
 		const { lockModesById } = computeActiveContentControlLockModes(doc.contentControls, targetSelection);
@@ -9398,18 +9470,20 @@ function createSuperDocUI(options) {
 		if (painter.mode === "armed") exitFormatPainter();
 		recompute();
 	};
-	const executeCommandAsync = (id, payload, context) => {
+	const runCommandAsync = (id, payload, context, firstParty) => {
 		const prepared = prepareCommandSelectionAsync(id, payload);
 		const settlement = prepared ? prepared.then(() => {
-			executeCommand(id, payload, context);
+			runCommand(id, payload, context, firstParty);
 			return lastCommandSettlement;
 		}) : (() => {
-			executeCommand(id, payload, context);
+			runCommand(id, payload, context, firstParty);
 			return lastCommandSettlement;
 		})();
 		if (getCommandDescriptor(id)?.inline?.kind === "toggle") lastInlineToggleCommandSettlement = settlement;
 		return settlement;
 	};
+	const executeCommandAsync = (id, payload, context) => runCommandAsync(id, payload, context, false);
+	const executeFirstPartyCommandAsync = (id, payload) => runCommandAsync(id, payload, void 0, true);
 	const makeCommandHandle = (id) => ({
 		id,
 		getState: () => state.toolbar.commands[id] ?? computeCommandState(id, getDoc(), state.selection, projectSelectionInlineValues(state.selection)),
@@ -10246,6 +10320,14 @@ function createSuperDocUI(options) {
 			kind,
 			scope: isAllTarget ? "all" : "id"
 		}, tcApi)) return false;
+		if (firstPartyCommandDoc) {
+			const host = getHost();
+			const decide = (safeCall(typeof host?.getHandles === "function" ? () => host.getHandles() : void 0, null)?.trackChanges)?.decide;
+			return typeof decide === "function" ? decide({
+				decision: kind,
+				target
+			}) : false;
+		}
 		const legacyName = isAllTarget ? `${kind}All` : kind;
 		const op = !isRangeTarget && !isMultiIdTarget && !story && tcApi && typeof tcApi[legacyName] === "function" ? tcApi[legacyName] : null;
 		const decide = tcApi && typeof tcApi.decide === "function" ? tcApi.decide : null;
@@ -10549,10 +10631,18 @@ function createSuperDocUI(options) {
 		const hits = [];
 		for (const hit of rawHits) {
 			if (hit.type !== "trackedChange") {
-				const key = `${hit.type}:${hit.id}`;
+				const layoutStory = hit.type === "contentControl" ? layoutStoryDatasetToStoryLocator(hit.story) : void 0;
+				const story = hit.type === "contentControl" ? isTextboxStory(layoutStory) ? layoutStory : storyKeyToStoryLocator(hit.storyKey) ?? layoutStory : void 0;
+				const key = `${hit.type}:${hit.id}:${JSON.stringify(story ?? null)}`;
 				if (seen.has(key)) continue;
 				seen.add(key);
-				hits.push(hit);
+				if (hit.type === "contentControl") {
+					const { storyKey: _storyKey, story: _paintedStory, ...publicHit } = hit;
+					hits.push(story ? {
+						...publicHit,
+						story
+					} : publicHit);
+				} else hits.push(hit);
 				continue;
 			}
 			const story = storyKeyToStoryLocator(hit.storyKey) ?? layoutStoryDatasetToStoryLocator(hit.story);
@@ -11522,6 +11612,7 @@ function createSuperDocUI(options) {
 		listeners.clear();
 		searchListeners.clear();
 		painterCaptureEpoch += 1;
+		painterCommandDoc = null;
 		painterModeListeners.clear();
 		searchRequestGeneration += 1;
 		customCommands.clear();
@@ -11591,6 +11682,7 @@ function createSuperDocUI(options) {
 		destroy
 	};
 	controllerRef = controller;
+	firstPartyCommandExecutors.set(controller, executeFirstPartyCommandAsync);
 	return controller;
 }
 /**
@@ -11756,4 +11848,4 @@ function commandIsActive(descriptor, selection) {
 	return descriptor.activeMark ? selection.activeMarks.includes(descriptor.activeMark) : false;
 }
 //#endregion
-export { getV2TrackedChangeMutationImpact as a, createInteractionHistory as c, applyV2CommentInvalidationFromMutation as i, recordInteraction as l, shallowEqual as n, DOM_CLASS_NAMES as o, BUILT_IN_COMMAND_IDS as r, closeInteractionHistory as s, createSuperDocUI as t };
+export { applyV2CommentInvalidationFromMutation as a, DOM_CLASS_NAMES as c, recordInteraction as d, BUILT_IN_COMMAND_IDS as i, closeInteractionHistory as l, executeFirstPartyCommandAsync as n, getV2TrackedChangeMutationImpact as o, registerFirstPartyCommandMutation as r, shallowEqual as s, createSuperDocUI as t, createInteractionHistory as u };