@superdoc/mcp 1.5.0-next.8 → 1.6.0-next.1

package/dist/index.js

@@ -31443,7 +31443,7 @@ var init_host = __esm(() => {
 });
 
 // ../../packages/sdk/langs/node/src/runtime/sdk-version.generated.ts
-var SDK_VERSION = "2.18.0-next.8";
+var SDK_VERSION = "2.19.0-next.1";
 
 // ../../packages/sdk/langs/node/src/runtime/embedded-platform.ts
 import { accessSync, chmodSync, constants, existsSync, statSync } from "node:fs";
@@ -179119,10 +179119,15 @@ function buildSDRenderCommitEnvelope(state, prepared, result, context = {}, opti
   const ownerContentEffects = source.sourceKind === "textboxAtomReplacement" ? textboxOwnerContentEffects(state, prepared, result.storiesChanged ?? []) : [];
   if (!ownerContentEffects)
     return broad("multi-story");
+  const checkboxRevisionOnlyEffects = source.sourceKind === "contentControlCheckbox" ? checkboxRevisionOnlyTextboxEffects(state, prepared, op, result.storiesChanged ?? []) : [];
+  if (!checkboxRevisionOnlyEffects)
+    return broad("multi-story");
   const ownerContentStoryIds = new Set(ownerContentEffects.map((effect) => effect.storyId));
+  const checkboxRevisionOnlyStoryIds = new Set(checkboxRevisionOnlyEffects.map((effect) => effect.storyId));
   const storyEffects = exactStoryEffectsForPrimary(op.on.storyId, prepared.resolvedTargets.stories, result.storiesChanged ?? [], [
-    ...(result.auxiliaryStoryEffects ?? []).filter((effect) => !ownerContentStoryIds.has(effect.storyId)),
-    ...ownerContentEffects
+    ...(result.auxiliaryStoryEffects ?? []).filter((effect) => !ownerContentStoryIds.has(effect.storyId) && !checkboxRevisionOnlyStoryIds.has(effect.storyId)),
+    ...ownerContentEffects,
+    ...checkboxRevisionOnlyEffects
   ]);
   if (!storyEffects)
     return broad("multi-story");
@@ -179164,7 +179169,7 @@ function buildSDRenderCommitEnvelope(state, prepared, result, context = {}, opti
   }
   const trackedDecisionRefDelta = source.sourceKind === "trackedChangeDecide" ? captureTrackedDecisionRefDelta(prepared, op.on.storyId) : null;
   const committedPatchGroup = result.forwardPatchGroup ?? prepared.localApplyBundle;
-  const localizedPatch = resolveLocalizedParagraphPatch(committedPatchGroup, prepared, source, {
+  const localizedPatch = resolveLocalizedParagraphPatch(state, committedPatchGroup, prepared, source, {
     ...partDelta.previousRevision ? { originPartRevision: partDelta.previousRevision } : {},
     originStoryRevision: storyDelta.previousRevision
   });
@@ -179224,7 +179229,7 @@ function buildSDRenderCommitEnvelope(state, prepared, result, context = {}, opti
   }
   const exhaustedInsertionProved = proveExhaustedTrackedInsertionForRender(prepared, context.originParagraphXml, postParagraphXml);
   const trackedDecisionInvalidatedChangeIds = trackedDecisionRefDelta?.kind === "invalidated" ? trackedDecisionRefDelta.changeIds : trackedTextResolutionProved ? trackedTextResolution.changeIds : null;
-  const ownerByteDelta = postBytes.byteLength - (op.on.paragraphByteEnd - op.on.paragraphByteStart);
+  const ownerByteDelta = localizedPatch.ownerByteDelta ?? postBytes.byteLength - (op.on.paragraphByteEnd - op.on.paragraphByteStart);
   const currentOwnerByteStart = ownerByteRange.byteStart;
   const currentOwnerByteEnd = ownerByteRange.byteEnd + ownerByteDelta;
   if (postBytes.byteLength > MAX_NARROW_SLICE_BYTES) {
@@ -179249,7 +179254,9 @@ function buildSDRenderCommitEnvelope(state, prepared, result, context = {}, opti
     changeMode: prepared.source.changeMode,
     coordinateSpace: prepared.source.on.coordinateSpace ?? "visible"
   } : null;
-  const sliceDependencyReason = source.annotation ? classifyAnnotationSliceDependency(context.originParagraphXml, postParagraphXml, source.annotation.commentId, source.annotation.operation) : source.sourceKind === "textboxAtomReplacement" ? classifyTextboxAtomSliceDependency(prepared, postParagraphXml, context.originParagraphXml, trackedAnnotations) : trackedDecisionRefDelta ? classifyTrackedDecisionSliceDependency(postParagraphXml, context.originParagraphXml, trackedDecisionRefDelta.kind) : classifyUnprovedSliceDependency(postParagraphXml, trackedAnnotations, context.originParagraphXml, {
+  if (source.sourceKind === "contentControlCheckbox" && !checkboxStateChangeIsLocal(prepared, context.originOwnerXml, postCommitXml, context.originParagraphXml, postParagraphXml))
+    return broad("global-dependency-change");
+  const sliceDependencyReason = source.annotation ? classifyAnnotationSliceDependency(context.originParagraphXml, postParagraphXml, source.annotation.commentId, source.annotation.operation) : source.sourceKind === "contentControlCheckbox" ? null : source.sourceKind === "textboxAtomReplacement" ? classifyTextboxAtomSliceDependency(prepared, postParagraphXml, context.originParagraphXml, trackedAnnotations) : trackedDecisionRefDelta ? classifyTrackedDecisionSliceDependency(postParagraphXml, context.originParagraphXml, trackedDecisionRefDelta.kind) : classifyUnprovedSliceDependency(postParagraphXml, trackedAnnotations, context.originParagraphXml, {
     allowTrackedWrapperDelta: source.sourceKind === "trackedChangeDecide",
     trackedCarrierRefinementProved,
     trackedTextResolutionProved,
@@ -181053,6 +181060,27 @@ function textboxOwnerContentEffects(state, prepared, storyDeltas) {
     nextRevision: delta.nextRevision
   }];
 }
+function checkboxRevisionOnlyTextboxEffects(state, prepared, source, storyDeltas) {
+  if (prepared.source.kind !== "storySurfaceRewrite" || prepared.source.operationId !== "content-control-checkbox-state" || !prepared.source.checkboxState)
+    return null;
+  const effects2 = [];
+  for (const storyDelta of storyDeltas) {
+    if (storyDelta.storyId === source.on.storyId)
+      continue;
+    const textbox = state.textboxRegistry.byStoryId.get(storyDelta.storyId);
+    if (!textbox || textbox.ownerPartUri !== source.on.partUri)
+      return null;
+    effects2.push({
+      storyId: storyDelta.storyId,
+      kind: "revision-only",
+      previousContentRange: [...textbox.contentRange],
+      currentContentRange: [...textbox.contentRange],
+      previousRevision: storyDelta.previousRevision,
+      nextRevision: storyDelta.nextRevision
+    });
+  }
+  return effects2;
+}
 function resolveAnnotationRenderSource(state, prepared, options) {
   const op = prepared.source;
   if (op.kind !== "insertComment" && op.kind !== "commentReply")
@@ -181217,6 +181245,10 @@ function resolveNarrowTextRenderSource(state, prepared, options) {
     const on = prepared.backendExtensions.storySurface?.exactParagraphRenderRange;
     return on ? { sourceKind: "storyFormatMutation", changeMode: "direct", on } : null;
   }
+  if (prepared.source.kind === "storySurfaceRewrite" && prepared.source.checkboxState) {
+    const on = prepared.backendExtensions.storySurface?.exactParagraphRenderRange;
+    return on ? { sourceKind: "contentControlCheckbox", changeMode: "direct", on } : null;
+  }
   if (prepared.source.kind !== "trackedChangeDecide")
     return null;
   const scope = resolveTrackedDecisionParagraphScope(prepared);
@@ -181278,10 +181310,30 @@ function resolveTrackedDecisionParagraphScopeFromGroup(prepared, patchGroup) {
     blockId: scope.blockIds[0]
   };
 }
-function resolveLocalizedParagraphPatch(patchGroup, prepared, source, revisions) {
+function resolveLocalizedParagraphPatch(state, patchGroup, prepared, source, revisions) {
   const partEntry = patchGroup.perPart[source.on.partUri];
   if (!partEntry || partEntry.kind !== "modify")
     return null;
+  if (source.sourceKind === "contentControlCheckbox") {
+    if (partEntry.patches.length === 0)
+      return null;
+    let ownerByteDelta = 0;
+    for (const patch2 of partEntry.patches) {
+      const delta2 = patchByteDelta(patch2);
+      if (delta2 == null)
+        return null;
+      ownerByteDelta += delta2;
+    }
+    const postEntry = state.paragraphIndexes.get(source.on.storyId)?.byParaId(source.on.startBlockId);
+    if (!postEntry || postEntry.partUri !== source.on.partUri)
+      return null;
+    return {
+      postStart: postEntry.byteStart,
+      postEnd: postEntry.byteEnd,
+      ownerByteDelta,
+      ...revisions
+    };
+  }
   if (source.sourceKind === "textboxAtomReplacement" || source.annotation) {
     const window2 = { startByte: source.on.paragraphByteStart, endByte: source.on.paragraphByteEnd };
     let delta2 = 0;
@@ -181418,6 +181470,8 @@ function storySurfaceFamilyMatchesSource(family, sourceKind) {
     return family === "storyTrackedDecide";
   if (sourceKind === "formatRunRange" || sourceKind === "storyFormatMutation")
     return family === "storyFormat";
+  if (sourceKind === "contentControlCheckbox")
+    return family === "storyBlocks";
   return family === "storyText";
 }
 function hasOnlyTrackedChangeRefDelta(prepared) {
@@ -181852,6 +181906,62 @@ function classifyDeferrableSliceDependency(reason, xml, originXml, auxiliaryStor
   }
   return classes;
 }
+function checkboxStateChangeIsLocal(prepared, originOwnerXml, postOwnerXml, originParagraphXml, postParagraphXml) {
+  const state = prepared.source.kind === "storySurfaceRewrite" ? prepared.source.checkboxState : undefined;
+  if (!state || originOwnerXml == null || originParagraphXml == null)
+    return false;
+  if (!isolateCheckboxControl(originParagraphXml, state.controlId) || !isolateCheckboxControl(postParagraphXml, state.controlId))
+    return false;
+  const origin = isolateCheckboxControl(originOwnerXml, state.controlId);
+  const post = isolateCheckboxControl(postOwnerXml, state.controlId);
+  if (!origin || !post || origin.before !== post.before || origin.after !== post.after)
+    return false;
+  const before = normalizeCheckboxControlXml(origin.control);
+  const after = normalizeCheckboxControlXml(post.control);
+  if (!before || !after)
+    return false;
+  return before.checked !== state.checked && after.checked === state.checked && before.normalized === after.normalized;
+}
+function isolateCheckboxControl(ownerXml, controlId) {
+  const parsed = collectXmlElementRanges(ownerXml);
+  const matching = parsed.ranges.filter((range) => range.tag.localName === "sdt").filter((range) => parsed.ranges.some((candidate2) => candidate2.start > range.start && candidate2.end < range.end && candidate2.tag.localName === "id" && candidate2.tag.attributes.some((attribute) => attribute.localName === "val" && attribute.value === controlId))).sort((left, right) => left.end - left.start - (right.end - right.start));
+  const control2 = matching[0];
+  if (!control2)
+    return null;
+  return {
+    before: ownerXml.slice(0, control2.start),
+    control: ownerXml.slice(control2.start, control2.end),
+    after: ownerXml.slice(control2.end)
+  };
+}
+function normalizeCheckboxControlXml(controlXml) {
+  const checked = [...controlXml.matchAll(/<w14:checked\b[^>]*\bw14:val="([01])"[^>]*\/>/g)];
+  if (checked.length !== 1)
+    return null;
+  const content = /<w:sdtContent\b[^>]*>([\s\S]*?)<\/w:sdtContent>/.exec(controlXml);
+  if (!content)
+    return null;
+  const text = [...content[1].matchAll(/<w:t\b[^>]*>([\s\S]*?)<\/w:t>/g)];
+  if (text.length !== 1 || !text[0][1])
+    return null;
+  const checkedState = canonicalCheckboxSymbolStateTag(controlXml, "checkedState");
+  const uncheckedState = canonicalCheckboxSymbolStateTag(controlXml, "uncheckedState");
+  if (!checkedState || !uncheckedState)
+    return null;
+  const normalized = controlXml.replace(checked[0][0], "<w14:checked/>").replace(checkedState.raw, checkedState.normalized).replace(uncheckedState.raw, uncheckedState.normalized).replace(text[0][0], "<w:t>CHECKBOX_GLYPH</w:t>");
+  return { checked: checked[0][1] === "1", normalized };
+}
+function canonicalCheckboxSymbolStateTag(controlXml, localName2) {
+  const matches = [...controlXml.matchAll(new RegExp(`<w14:${localName2}\\b[^>]*\\/>`, "g"))];
+  if (matches.length !== 1)
+    return null;
+  const raw = matches[0][0];
+  const value = /\bw14:val="([^"]+)"/.exec(raw)?.[1];
+  const font = /\bw14:font="([^"]+)"/.exec(raw)?.[1] ?? "";
+  if (!value)
+    return null;
+  return { raw, normalized: `<w14:${localName2} w14:val="${value}" w14:font="${font}"/>` };
+}
 function classifyUnprovedSliceDependency(xml, trackedAnnotations, originXml, options = {}) {
   if (originXml == null)
     return "origin-slice-unavailable";
@@ -222948,6 +223058,7 @@ function runStorySurfaceRewriteCommit(input) {
     return rejected11(input.txId, "unsupported-context");
   }
   const headerFooterUpdate = prepareHeaderFooterUpdate(input.state, op, effectivePerPart);
+  const exactParagraphRenderRange = contentControlRewrite ? resolveExactCheckboxParagraphRenderRange(input.state, op, contentControlRewrite) : null;
   const storySurface = {
     family,
     ...contentControlRewrite ? { contentControlRewrite } : {},
@@ -222960,6 +223071,7 @@ function runStorySurfaceRewriteCommit(input) {
       ...contentControlRewrite.leadingBlockIds
     ])] : [...new Set(op.targetBlockIds)],
     atomCarrierContract: SD_DEFAULT_ATOM_CARRIER_CONTRACT,
+    ...exactParagraphRenderRange ? { exactParagraphRenderRange } : {},
     ...headerFooterSlotMaterialization ? { headerFooterSlotMaterialization } : {},
     ...headerFooterPartCreation ? { headerFooterPartCreation } : {},
     ...headerFooterUpdate ? { headerFooterUpdate } : {},
@@ -223388,11 +223500,46 @@ function bytesEqual9(left, right) {
   }
   return true;
 }
+function resolveExactCheckboxParagraphRenderRange(state, op, rewrite) {
+  if (!op.checkboxState || op.changeMode === "tracked" || op.storyPartOwnership.length !== 1)
+    return null;
+  if (rewrite.removedBlockIds.length || rewrite.addedBlockIds.length || rewrite.trailingXmlChanged)
+    return null;
+  const touched = [...new Set([...rewrite.contentBlockIds, ...rewrite.leadingBlockIds])];
+  const targetBlockId = op.targetBlockIds.length === 1 ? op.targetBlockIds[0] : touched.length === 1 ? touched[0] : null;
+  if (!targetBlockId || !rewrite.contentBlockIds.includes(targetBlockId))
+    return null;
+  if (touched.some((blockId) => blockId !== targetBlockId))
+    return null;
+  const owner = op.storyPartOwnership[0];
+  const index = getStoryParagraphIndexFromState(state, owner.storyId);
+  if (!index || index.duplicateParaIds.has(targetBlockId))
+    return null;
+  const entry = index.byParaId(targetBlockId);
+  if (!entry || entry.storyId !== owner.storyId || entry.partUri !== owner.partUri)
+    return null;
+  return {
+    storyId: entry.storyId,
+    storyRevision: entry.storyRevision,
+    partUri: entry.partUri,
+    partRevision: entry.partRevision,
+    startByte: entry.byteStart,
+    endByte: entry.byteEnd,
+    paragraphByteStart: entry.byteStart,
+    paragraphByteEnd: entry.byteEnd,
+    startBlockId: entry.blockId,
+    endBlockId: entry.blockId,
+    startOffset: 0,
+    endOffset: entry.textLength,
+    sourceAddress: { blockId: entry.blockId, range: { start: 0, end: entry.textLength } }
+  };
+}
 function rejected11(txId, reason) {
   return { txId, status: "rejected", rejectedReason: reason };
 }
 var DOCUMENT_PART_URI3 = "/word/document.xml", DOCUMENT_RELS_PART_URI5 = "/word/_rels/document.xml.rels", CONTENT_TYPES_PART_URI6 = "/[Content_Types].xml", HEADER_REL = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/header", FOOTER_REL = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/footer", HEADER_CT = "application/vnd.openxmlformats-officedocument.wordprocessingml.header+xml", FOOTER_CT = "application/vnd.openxmlformats-officedocument.wordprocessingml.footer+xml", TD58;
 var init_compile_story_surface_rewrite = __esm(() => {
+  init_sd_document_state();
   init_source_backed_main_overlay();
   init_content_types();
   init_sha256_sync();
@@ -275843,6 +275990,13 @@ var init_source = __esm(() => {
     };
   }));
   V2_ONLY_ADAPTER_METHODS = Object.freeze([
+    {
+      method: "createDocumentApi(host.adapter).contentControls.deleteCheckboxSelection",
+      stability: "internal",
+      workerWired: true,
+      relatedV1Operation: "contentControls.delete",
+      rationale: "Atomic keyboard deletion of a mixed text and checkbox selection, preserving wrapper locks and undo."
+    },
     {
       method: "createDocumentApi(host.adapter).fields.contextAtPosition",
       stability: "internal",
@@ -278151,6 +278305,7 @@ function commitKernelStorySurfacePatch(input) {
     operationId: input.txIdPrefix,
     family: storySurface.family,
     ...storySurface.contentControlRewrite ? { contentControlRewrite: true } : {},
+    ...storySurface.checkboxState ? { checkboxState: storySurface.checkboxState } : {},
     storyLocal: prepared.storyLocal,
     ...storySurface.changeMode ? { changeMode: storySurface.changeMode } : {},
     storyIds: prepared.storyIds,
@@ -279143,6 +279298,7 @@ function commitWholePartUpdates(context, txIdPrefix, updates, options = {}) {
     txIdPrefix,
     perPart,
     storyIds: options.storyIds,
+    signalLanesToRebuild: options.signalLanesToRebuild,
     semanticStyleDependencies,
     expectedRevision: normalizedRevision,
     ...storySurface ? { storySurface } : {},
@@ -286089,8 +286245,15 @@ var FONT_FAMILY_FALLBACKS, DEFAULT_GENERIC_FALLBACK = "sans-serif", INHERITED_FO
   let current = "";
   let inQuote = false;
   let quoteChar = null;
+  let escaped = false;
   for (const char of str) {
-    if (!inQuote && (char === '"' || char === "'")) {
+    if (escaped) {
+      current += char;
+      escaped = false;
+    } else if (char === "\\") {
+      current += char;
+      escaped = true;
+    } else if (!inQuote && (char === '"' || char === "'")) {
       inQuote = true;
       quoteChar = char;
       current += char;
@@ -286109,7 +286272,7 @@ var FONT_FAMILY_FALLBACKS, DEFAULT_GENERIC_FALLBACK = "sans-serif", INHERITED_FO
   if (current.trim())
     parts.push(current.trim());
   return parts;
-};
+}, CSS_GENERIC_FAMILIES;
 var init_font_utils = __esm(() => {
   FONT_FAMILY_FALLBACKS = Object.freeze({
     swiss: "Arial, sans-serif",
@@ -286149,6 +286312,21 @@ var init_font_utils = __esm(() => {
     "dejavu sans mono",
     "source code pro"
   ]);
+  CSS_GENERIC_FAMILIES = new Set([
+    "serif",
+    "sans-serif",
+    "monospace",
+    "cursive",
+    "fantasy",
+    "system-ui",
+    "ui-serif",
+    "ui-sans-serif",
+    "ui-monospace",
+    "ui-rounded",
+    "emoji",
+    "math",
+    "fangsong"
+  ]);
 });
 
 // ../../../v2/node_modules/.pnpm/@superdoc+style-engine@file+..+public+packages+layout-engine+style-engine/node_modules/@superdoc/style-engine/src/normalize/run-attrs.ts
@@ -336162,6 +336340,19 @@ var init_tracked_move = __esm(() => {
 });
 
 // ../../../v2/document-api-v2-adapter/dist/content-controls/adapter.js
+function resolveSingleParagraphTextRange(target) {
+  if (target.kind !== "selection" || target.start.kind !== "text" || target.end.kind !== "text")
+    return null;
+  if (target.start.blockId !== target.end.blockId)
+    return null;
+  const story = target.story ?? target.start.story ?? target.end.story;
+  return {
+    blockId: target.start.blockId,
+    start: Math.min(target.start.offset, target.end.offset),
+    end: Math.max(target.start.offset, target.end.offset),
+    ...story ? { story } : {}
+  };
+}
 function bytesProveNoContentControlCarrier(bytes) {
   if (bytes.includes(0))
     return false;
@@ -336703,6 +336894,145 @@ class V2ContentControlsAdapter {
   delete(input, options) {
     return this.mutateControl(input.target, input, options, () => "", "content-control-delete", guardSdtWrapperUnlocked);
   }
+  deleteCheckboxSelection(input, options) {
+    if ((options?.changeMode ?? "direct") !== "direct") {
+      return {
+        success: false,
+        failure: {
+          code: "CAPABILITY_UNAVAILABLE",
+          message: "Deleting a selection that crosses a checkbox content control is not supported in tracked mode."
+        }
+      };
+    }
+    const range = resolveSingleParagraphTextRange(input.target);
+    if (!range) {
+      return {
+        success: false,
+        failure: {
+          code: "INVALID_CONTEXT",
+          message: "Checkbox selection deletion requires a same-paragraph text range."
+        }
+      };
+    }
+    if (range.story?.storyType && range.story.storyType !== "body") {
+      return {
+        success: false,
+        failure: { code: "CAPABILITY_UNAVAILABLE", message: SECONDARY_STORY_MUTATION_MESSAGE }
+      };
+    }
+    const loaded = this.load();
+    const requestedIds = [...new Set(input.controlIds)];
+    if (requestedIds.length === 0) {
+      return {
+        success: false,
+        failure: { code: "INVALID_INPUT", message: "Checkbox selection deletion requires at least one control." }
+      };
+    }
+    const byId = new Map(loaded.controls.map((control2) => [control2.id, control2]));
+    const controls = [];
+    for (const id of requestedIds) {
+      const control2 = byId.get(id);
+      const controlRange = control2?.info.selectionTarget ? resolveSingleParagraphTextRange(control2.info.selectionTarget) : null;
+      if (!control2 || !controlRange || control2.info.controlType !== "checkbox" || controlRange.blockId !== range.blockId || controlRange.start < range.start || controlRange.end > range.end) {
+        return {
+          success: false,
+          failure: { code: "INVALID_CONTEXT", message: "The selected range no longer fully contains this checkbox." }
+        };
+      }
+      try {
+        guardSdtWrapperUnlocked(control2);
+      } catch (error48) {
+        return {
+          success: false,
+          failure: {
+            code: "LOCK_VIOLATION",
+            message: error48 instanceof Error ? error48.message : String(error48)
+          }
+        };
+      }
+      controls.push({ control: control2, start: controlRange.start, end: controlRange.end });
+    }
+    const selectedWidth = controls.reduce((width, control2) => width + (control2.end - control2.start), 0);
+    if (selectedWidth <= 0 || range.end - selectedWidth < range.start) {
+      return {
+        success: false,
+        failure: { code: "INVALID_CONTEXT", message: "The checkbox selection has an invalid text extent." }
+      };
+    }
+    const validation = this.context.validateMutation({
+      expectedRevision: expectedRevisionFrom(input, options) === undefined ? undefined : String(expectedRevisionFrom(input, options))
+    });
+    if (validation)
+      return { success: false, failure: validation };
+    let capturedTxIds = [];
+    try {
+      this.context.captureCommittedHistory((txIds) => {
+        capturedTxIds = txIds;
+        for (const { control: control2 } of [...controls].sort((left, right) => right.start - left.start)) {
+          const deleted = this.delete({ target: control2.target }, { changeMode: "direct" });
+          if (!deleted.success) {
+            throw new CheckboxSelectionDeleteError(deleted.failure);
+          }
+        }
+        const remainingEnd = range.end - selectedWidth;
+        if (remainingEnd > range.start) {
+          const textDeleted = new V2SelectionMutationAdapter(this.context).execute({
+            kind: "replace",
+            target: {
+              kind: "selection",
+              story: input.target.story,
+              start: {
+                kind: "text",
+                story: input.target.story,
+                blockId: range.blockId,
+                offset: range.start
+              },
+              end: {
+                kind: "text",
+                story: input.target.story,
+                blockId: range.blockId,
+                offset: remainingEnd
+              }
+            },
+            text: ""
+          }, { changeMode: "direct" });
+          if (!textDeleted.success) {
+            throw new CheckboxSelectionDeleteError(textDeleted.failure);
+          }
+        }
+      });
+    } catch (error48) {
+      rollbackCapturedHistory(this.context, capturedTxIds);
+      if (error48 instanceof CheckboxSelectionDeleteError) {
+        return { success: false, failure: error48.failure };
+      }
+      return {
+        success: false,
+        failure: {
+          code: "INTERNAL_ERROR",
+          message: error48 instanceof Error ? error48.message : String(error48)
+        }
+      };
+    }
+    const published = publishCapturedHistory(this.context, capturedTxIds, "content-control-checkbox-selection-delete");
+    if (!published) {
+      return {
+        success: false,
+        failure: { code: "INTERNAL_ERROR", message: "Checkbox selection deletion committed no history entry." }
+      };
+    }
+    const result = {
+      success: true,
+      txId: published.txId,
+      affectedStories: projectAffectedStories(published.storiesChanged ?? [], this.context.session, published.partsChanged, input.target.story ?? { kind: "story", storyType: "body" }),
+      ...published.invalidatedRefs?.length ? { invalidatedRefs: projectAffectedRefs2(published.invalidatedRefs) } : {},
+      ...published.textRangeShifts?.length ? { textRangeShifts: projectTextRangeShifts(published.textRangeShifts, this.context.session, input.target.story) } : {}
+    };
+    const renderCommit = getSDRenderCommitEnvelope(published);
+    if (renderCommit)
+      attachSDRenderCommitEnvelope(result, renderCommit);
+    return result;
+  }
   copy(input, options) {
     this.validateTrackedControlMutation(input, options);
     const loaded = this.load();
@@ -337388,7 +337718,7 @@ class V2ContentControlsAdapter {
     this.validateTrackedControlMutation(input, options);
     throw operationError("CAPABILITY_UNAVAILABLE", "This content-control change has no supported Word-compatible tracked representation.");
   }
-  mutateControl(target, input, options, transform2, prefix = "content-control-mutate", validate) {
+  mutateControl(target, input, options, transform2, prefix = "content-control-mutate", validate, commitOverrides) {
     const loaded = this.load();
     const tracked = options?.changeMode === "tracked";
     const storyAware = prefix === "content-control-pr" || prefix === "content-control-unwrap" || prefix === "content-control-delete";
@@ -337428,10 +337758,13 @@ class V2ContentControlsAdapter {
       createdRefs = prepared.wordIds.map((entityId) => ({ kind: "trackedChange", entityId, storyId: control2.storyId }));
     }
     const nextXml = replaceRange3(part.xml, control2.start, control2.end, replacement);
+    const explicitStorySurface = commitOverrides?.storySurface;
+    const storySurface = explicitStorySurface?.checkboxState ? { ...explicitStorySurface, targetBlockIds: contentControlTextBlockIds(control2.info) } : explicitStorySurface;
     return this.commitDocument(nextXml, prefix, input, options, control2.target, {
+      ...commitOverrides,
       partUri: part.partUri,
-      storySurface: { family: "storyBlocks", contentControlRewrite: true, targetBlockIds: [] },
-      preserveRenderCommit: this.context.isCollaborativeSession(),
+      storySurface: storySurface ?? { family: "storyBlocks", contentControlRewrite: true, targetBlockIds: [] },
+      preserveRenderCommit: commitOverrides?.preserveRenderCommit ?? this.context.isCollaborativeSession(),
       createdRefs
     });
   }
@@ -337551,13 +337884,22 @@ class V2ContentControlsAdapter {
     return this.mutateControl(target, input, options, (control2) => {
       const pr = upsertCheckbox(control2.prXml, { checked });
       const symbol2 = checked ? control2.info.properties.checkedSymbol ?? DEFAULT_CHECKED : control2.info.properties.uncheckedSymbol ?? DEFAULT_UNCHECKED;
-      const nextContent = buildContentXml(symbolToText(symbol2.char), control2.info.kind, createParaIdAllocator(this.context));
+      const nextGlyph = symbolToText(symbol2.char);
+      const nextContent = replaceCheckboxGlyphContent(control2, nextGlyph) ?? buildContentXml(nextGlyph, control2.info.kind, createParaIdAllocator(this.context));
       return replaceSdtPrXml(replaceSdtContentXml(control2, nextContent), pr);
     }, "content-control-checkbox-state", (control2) => {
       if (control2.info.controlType !== "checkbox") {
         throw operationError("INVALID_TARGET", "contentControls.checkbox.setState requires control type checkbox.");
       }
       guardContentUnlocked(control2);
+    }, {
+      storySurface: {
+        family: "storyBlocks",
+        contentControlRewrite: true,
+        checkboxState: { controlId: target.nodeId, checked }
+      },
+      preserveRenderCommit: true,
+      signalLanesToRebuild: ["paragraphIndex", "noteAnchorRefs"]
     });
   }
   requireProtectedControl(control2, loaded) {
@@ -337738,6 +338080,7 @@ class V2ContentControlsAdapter {
       extraPerPart: commitOptions.extraPerPart,
       semanticStyleDependencies: commitOptions.semanticStyleDependencies,
       storySurface: commitOptions.storySurface,
+      signalLanesToRebuild: commitOptions.signalLanesToRebuild,
       storyIds: commitOptions.storySurface?.contentControlRewrite ? this.load().parts.filter((part) => part.partUri === partUri).map((part) => part.storyId) : undefined,
       createdRefs: commitOptions.createdRefs
     });
@@ -338899,6 +339242,13 @@ function replaceSdtContentXml(control2, contentXml) {
     return control2.xml;
   return `${control2.xml.slice(0, contentRange.openEnd)}${contentXml}${control2.xml.slice(contentRange.closeStart)}`;
 }
+function replaceCheckboxGlyphContent(control2, glyph) {
+  const textNodes = collectXmlElementRanges(control2.contentXml).ranges.filter((range) => range.tag.localName === "t" && !range.tag.isSelfClosing);
+  if (textNodes.length !== 1)
+    return null;
+  const text4 = textNodes[0];
+  return `${control2.contentXml.slice(0, text4.openEnd)}${xmlEscapeText(glyph)}${control2.contentXml.slice(text4.closeStart)}`;
+}
 function unwrapSdtXml(sdtXml) {
   const contentRange = findDirectSdtChildRange(sdtXml, "sdtContent");
   return contentRange ? sdtXml.slice(contentRange.openEnd, contentRange.closeStart) : "";
@@ -339798,7 +340148,7 @@ function replaceTextRangeInParagraph2(paragraphXml, start, end, replacement) {
   }
   return paragraphXml;
 }
-var DEFAULT_CHECKED, DEFAULT_UNCHECKED, SECONDARY_STORY_MUTATION_MESSAGE = "Content control mutations outside the document body are not supported by this adapter.", UNMODELED_TYPE_TAGS, TYPE_TAGS, COOPERATIVE_PARSE_SLICE_PARAGRAPHS = 128, COOPERATIVE_PARSE_SLICE_CONTROLS = 16, RAW_ATTRIBUTE_PATTERN, COPIED_PROPERTY_REVISIONS;
+var CheckboxSelectionDeleteError, DEFAULT_CHECKED, DEFAULT_UNCHECKED, SECONDARY_STORY_MUTATION_MESSAGE = "Content control mutations outside the document body are not supported by this adapter.", UNMODELED_TYPE_TAGS, TYPE_TAGS, COOPERATIVE_PARSE_SLICE_PARAGRAPHS = 128, COOPERATIVE_PARSE_SLICE_CONTROLS = 16, RAW_ATTRIBUTE_PATTERN, COPIED_PROPERTY_REVISIONS;
 var init_adapter10 = __esm(() => {
   init_sd_document_session_internal();
   init_src6();
@@ -339814,6 +340164,9 @@ var init_adapter10 = __esm(() => {
   init_tracked_structural_wrapper();
   init_mutation_guard();
   init_adapter9();
+  init_composite();
+  init_stories();
+  init_text_range_shifts();
   init_rich_fragment_apply();
   init_receipt_entities();
   init_xml_rewrite();
@@ -339823,6 +340176,12 @@ var init_adapter10 = __esm(() => {
   init_tracked_content();
   init_native_ownership_visibility();
   init_tracked_move();
+  CheckboxSelectionDeleteError = class CheckboxSelectionDeleteError extends Error {
+    constructor(failure5) {
+      super(failure5.message);
+      this.failure = failure5;
+    }
+  };
   DEFAULT_CHECKED = { font: "MS Gothic", char: "2612" };
   DEFAULT_UNCHECKED = { font: "MS Gothic", char: "2610" };
   UNMODELED_TYPE_TAGS = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superdoc/mcp",
-  "version": "1.5.0-next.8",
+  "version": "1.6.0-next.1",
   "description": "Model Context Protocol server for SuperDoc, giving an AI agent tools to read and edit .docx files.",
   "type": "module",
   "license": "AGPL-3.0",
@@ -24,13 +24,13 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
-    "@superdoc/sdk": "2.18.0-next.8",
+    "@superdoc/sdk": "2.19.0-next.1",
     "debug": "^4.4.3",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "superdoc": "2.21.0-next.6",
-    "@superdoc/docx-engine": "0.20.0-next.6",
+    "superdoc": "2.22.0-next.1",
+    "@superdoc/docx-engine": "0.21.0-next.1",
     "@superdoc/document-api": "0.1.0-alpha.0",
     "@types/bun": "^1.3.8",
     "@types/node": "22.19.2",