@beyondwork/docx-react-component 1.0.120 → 1.0.122

package/dist/index.js

@@ -4,7 +4,7 @@ import {
   createSearchPlugin,
   performSearch,
   searchPluginKey
-} from "./chunk-IQ2VJEF6.js";
+} from "./chunk-QNGJRZ2D.js";
 import {
   CODE_METADATA_TABLE,
   KNOWN_DIAGNOSTIC_CODES,
@@ -26,7 +26,7 @@ import {
   splitListParagraph,
   toggleBulletedList,
   toggleNumberedList
-} from "./chunk-KD5K5XIA.js";
+} from "./chunk-UHQOUTAX.js";
 import {
   applyParagraphStyleToDocument
 } from "./chunk-6EXNNAO6.js";
@@ -37,15 +37,15 @@ import {
   setSectionPageNumberingAtSectionIndex,
   updateSectionLayoutAtSectionIndex
 } from "./chunk-M6XR534O.js";
-import "./chunk-2ZWFQ74R.js";
+import "./chunk-OBCP6VTG.js";
 import {
   createRuntimeCollabSync,
   createRuntimeCommandAppliedBridge
-} from "./chunk-WDNEPRFW.js";
+} from "./chunk-ICX54W4U.js";
 import {
   insertPageBreak,
   insertTable
-} from "./chunk-FXGQM2JB.js";
+} from "./chunk-3OFSP2IX.js";
 import {
   getFormattingStateFromRenderSnapshot
 } from "./chunk-Y4XZCMCS.js";
@@ -53,13 +53,13 @@ import {
   insertImage,
   repositionFloatingImage,
   resizeImage
-} from "./chunk-5RNMPLXU.js";
-import "./chunk-U5BSQXF4.js";
+} from "./chunk-37SEJQ3G.js";
+import "./chunk-3OHVK2D6.js";
 import {
   getTableStructureContext,
   tableStructureActionHandleForTarget
-} from "./chunk-BBB4GSDB.js";
-import "./chunk-MUEN2WOG.js";
+} from "./chunk-XVFENXLK.js";
+import "./chunk-ZKSDVHGH.js";
 import {
   OverlayAnchorBridgeProvider,
   PAGE_CHROME_DEFAULTS,
@@ -84,7 +84,7 @@ import {
   resolveSelectionToolRegistry,
   shouldRenderAbsoluteFloatingImageInPageOverlay,
   shouldRenderSelectionToolKind
-} from "./chunk-KHZNNBTN.js";
+} from "./chunk-QFU7ZOAD.js";
 import {
   PREDICTED_LANE_COUNTERS,
   createInertGeometryFacet,
@@ -92,7 +92,7 @@ import {
   incrementInvalidationCounter,
   recordPerfSample,
   startPerfProbe
-} from "./chunk-WVZX4NYG.js";
+} from "./chunk-GZW2ERUO.js";
 import {
   composeSeriesColor,
   computeStructuralHash,
@@ -106,22 +106,22 @@ import {
   resolveColor,
   tryReadLaycacheEnvelope,
   writeEnvelopeToOpcPackage
-} from "./chunk-FIGWJ43K.js";
+} from "./chunk-IT2DK3A7.js";
 import {
   findTextMatches,
   parseCanonicalFragmentFromWordML,
   searchDocument
-} from "./chunk-MPYYBRVN.js";
+} from "./chunk-PCXTMEGY.js";
 import {
   clearLocalCursorState,
   getCursorColorForUser,
   getRemoteCursorStates,
   setLocalCursorState
-} from "./chunk-XC56YLIS.js";
+} from "./chunk-C2LWJ4CZ.js";
 import {
   resolveChromePreset,
   resolveChromeVisibilityForPreset
-} from "./chunk-VCL5MJMZ.js";
+} from "./chunk-GON2DNTE.js";
 import {
   CAPABILITY_BY_ID,
   ISSUE_METADATA_ID,
@@ -137,33 +137,33 @@ import {
   deriveCapabilities,
   sanitizeMarkdown,
   sha256Hex
-} from "./chunk-TMQGWF7R.js";
+} from "./chunk-G3B2OBCZ.js";
 import "./chunk-KFCQYZXR.js";
-import "./chunk-4ZNQFWFM.js";
+import "./chunk-QIO6V46H.js";
 import {
   createEditorSurfaceSnapshot,
   getStoryBlocks,
   replaceStoryBlocks,
   stableChartId
-} from "./chunk-AUQDC5BD.js";
-import "./chunk-VDIUVT46.js";
+} from "./chunk-3TUQCHYT.js";
+import "./chunk-CX42VC67.js";
 import {
   createDefaultCanonicalDocument,
   createSelectionSnapshot
-} from "./chunk-FLNQY74K.js";
+} from "./chunk-OYGMRRR7.js";
 import {
   DocxSession,
   SessionNotOpenError,
   SessionNotWiredError,
   isReopenBarrier
-} from "./chunk-BM5NSDII.js";
+} from "./chunk-S4ANOS2M.js";
 import {
   createHmacSigner,
   createHmacVerifier,
   loadDocxSessionSync,
   signWorkflowPayloadXml,
   verifyWorkflowPayloadXml
-} from "./chunk-KCHEAX4Z.js";
+} from "./chunk-EMDH4IQN.js";
 import {
   EDITOR_SESSION_STATE_VERSION,
   assertEditorSessionState,
@@ -172,8 +172,8 @@ import {
   editorSessionStateFromPersistedSnapshot,
   persistedSnapshotFromEditorSessionState,
   validateEditorSessionState
-} from "./chunk-327AIUXL.js";
-import "./chunk-NQZUGMLW.js";
+} from "./chunk-UWDWGQH5.js";
+import "./chunk-TMU7JMXX.js";
 import {
   decodePersistedSourcePackageBytes,
   hasValidPersistedSourcePackageDigest
@@ -185,7 +185,7 @@ import {
   collectEditableTargetRefs,
   createHeaderFooterStoryKey,
   createNoteStoryKey
-} from "./chunk-AQA7OZ2R.js";
+} from "./chunk-TFSXOIAI.js";
 import {
   readOpcPackage
 } from "./chunk-OL2UEHRP.js";
@@ -197,8 +197,9 @@ import {
 import "./chunk-UTL65BUI.js";
 import "./chunk-UFVDIR2C.js";
 import {
-  createCanonicalDocumentId
-} from "./chunk-4JNUMMM7.js";
+  createCanonicalDocumentId,
+  createPublicRangeAnchor
+} from "./chunk-PGGPPZ65.js";
 import {
   stableStringify
 } from "./chunk-DNXYUIIS.js";
@@ -1806,7 +1807,7 @@ function TwNavigationCommandBar(props) {
                 onClick: () => props.onGoToGroupChange(group.id),
                 className: [
                   "inline-flex h-7 items-center gap-1 rounded-md border px-2 text-[length:var(--text-xs)] font-medium transition-colors focus-visible:outline-none focus-visible:shadow-[var(--shadow-focus)]",
-                  selected ? "border-[var(--color-border-accent)] bg-[var(--color-accent-soft)] text-[var(--color-accent-primary)]" : "border-border bg-canvas text-secondary hover:bg-hover hover:text-primary"
+                  selected ? "border-[var(--color-border-accent)] bg-[var(--color-bg-elevated)] text-[var(--color-accent-primary)]" : "border-border bg-canvas text-secondary hover:bg-hover hover:text-primary"
                 ].join(" "),
                 children: [
                   /* @__PURE__ */ jsx(Target, { className: "h-3 w-3", "aria-hidden": "true" }),
@@ -6376,32 +6377,44 @@ function buildPositionMap(surface) {
   const protectedInlineEntries = [];
   const pmDocSize = walkBlocks(surface.blocks, 1, entries, protectedInlineEntries, { rootLevel: true });
   const runtimeStorySize = surface.storySize;
-  return {
-    runtimeToPm(runtimePos) {
-      const firstEditable = entries.find((entry) => entry.editable !== false);
-      if (runtimePos <= 0) {
-        return firstEditable?.pmStart ?? 1;
+  const runtimeToPm = (runtimePos) => {
+    const firstEditable = entries.find(isRuntimeRestorableEntry);
+    if (runtimePos <= 0) {
+      return firstEditable?.pmStart ?? 1;
+    }
+    if (runtimePos >= runtimeStorySize) {
+      return lastRestorableEntry(entries)?.pmEnd ?? pmDocSize - 1;
+    }
+    let previous = null;
+    for (const entry of entries) {
+      if (!isRuntimeRestorableEntry(entry)) {
+        continue;
       }
-      if (runtimePos >= runtimeStorySize) {
-        return lastEditableEntry(entries)?.pmEnd ?? pmDocSize - 1;
+      if (entry.runtimeStart === entry.runtimeEnd && runtimePos === entry.runtimeStart) {
+        return entry.pmStart;
       }
-      let previous = null;
-      for (const entry of entries) {
-        if (entry.editable === false) {
-          continue;
-        }
-        if (entry.runtimeStart === entry.runtimeEnd && runtimePos === entry.runtimeStart) {
-          return entry.pmStart;
-        }
-        if (runtimePos >= entry.runtimeStart && runtimePos < entry.runtimeEnd) {
-          return entry.pmStart + (runtimePos - entry.runtimeStart);
-        }
-        if (runtimePos < entry.runtimeStart) {
-          return nearestRuntimeGapPm(runtimePos, previous, entry);
-        }
-        previous = entry;
+      if (runtimePos >= entry.runtimeStart && runtimePos < entry.runtimeEnd) {
+        return entry.pmStart + (runtimePos - entry.runtimeStart);
       }
-      return lastEditableEntry(entries)?.pmEnd ?? 1;
+      if (runtimePos < entry.runtimeStart) {
+        return nearestRuntimeGapPm(runtimePos, previous, entry);
+      }
+      previous = entry;
+    }
+    return lastRestorableEntry(entries)?.pmEnd ?? 1;
+  };
+  return {
+    runtimeToPm,
+    runtimeToPmWithContext(input) {
+      const targetEntry = input.editableTarget ? findRestorableEntryForTarget(entries, input.editableTarget) : void 0;
+      if (targetEntry) {
+        return pmForRuntimeInTargetEntry(targetEntry, input.runtimePos, protectedInlineEntries);
+      }
+      const inertTargetEntry = input.editableTarget ? findInertEntryForTarget(entries, input.editableTarget) : void 0;
+      if (inertTargetEntry) {
+        return pmForRuntimeInTargetEntry(inertTargetEntry, input.runtimePos, protectedInlineEntries);
+      }
+      return runtimeToPm(input.runtimePos);
     },
     pmToRuntime(pmPos) {
       return resolvePmPosition(entries, protectedInlineEntries, pmDocSize, runtimeStorySize, pmPos).runtimePos;
@@ -6421,6 +6434,12 @@ function resolvePmPosition(entries, protectedInlineEntries, pmDocSize, runtimeSt
   if (protectedEntry) {
     return contextForEntry(protectedEntry, pmPos);
   }
+  const exactStartEntry = entries.find(
+    (entry) => pmPos === entry.pmStart && isRuntimeRestorableEntry(entry)
+  );
+  if (exactStartEntry) {
+    return contextForEntry(exactStartEntry, pmPos);
+  }
   if (pmPos <= 1) {
     const first = entries[0];
     if (first && pmPos >= first.pmStart && pmPos <= first.pmEnd) {
@@ -6465,11 +6484,15 @@ function resolvePmPosition(entries, protectedInlineEntries, pmDocSize, runtimeSt
 }
 function contextForEntry(entry, pmPos) {
   const pmDelta = Math.max(0, pmPos - entry.pmStart);
+  const runtimeStart = entry.dispatchRuntimeStart ?? entry.runtimeStart;
+  const runtimeEnd = entry.dispatchRuntimeEnd ?? entry.runtimeEnd;
+  const runtimeDelta = Math.min(pmDelta, Math.max(0, runtimeEnd - runtimeStart));
+  const editableTarget = entry.dispatchEditableTarget ?? entry.editableTarget;
   return {
-    runtimePos: entry.runtimeStart + pmDelta,
+    runtimePos: runtimeStart + runtimeDelta,
     editable: entry.editable !== false,
     textTarget: entry.editable === false ? void 0 : entry.textTarget,
-    editableTarget: entry.editable === false ? void 0 : entry.editableTarget
+    editableTarget: entry.editable === false ? void 0 : editableTarget
   };
 }
 function isEditablePmRange(entries, protectedInlineEntries, pmDocSize, runtimeStorySize, from, to) {
@@ -6489,7 +6512,22 @@ function isEditablePmRange(entries, protectedInlineEntries, pmDocSize, runtimeSt
   return true;
 }
 function protectedInlineEntryAtPm(protectedInlineEntries, pmPos) {
-  return protectedInlineEntries.find((entry) => pmPos >= entry.pmStart && pmPos < entry.pmEnd);
+  return protectedInlineEntries.find((entry) => pmPos > entry.pmStart && pmPos < entry.pmEnd);
+}
+function pmForRuntimeInTargetEntry(entry, runtimePos, protectedInlineEntries) {
+  const runtimeDelta = Math.max(
+    0,
+    Math.min(runtimePos - entry.runtimeStart, entry.runtimeEnd - entry.runtimeStart)
+  );
+  let pmPos = entry.pmStart + runtimeDelta;
+  for (const protectedEntry of protectedInlineEntries) {
+    if (protectedEntry.pmEnd <= entry.pmStart) continue;
+    if (protectedEntry.pmStart > entry.pmEnd) break;
+    if (pmPos > protectedEntry.pmStart && pmPos < protectedEntry.pmEnd) {
+      pmPos = Math.min(entry.pmEnd, protectedEntry.pmEnd);
+    }
+  }
+  return pmPos;
 }
 function pmRangeTouchesEntry(start, end, entry) {
   if (start === end) {
@@ -6505,10 +6543,13 @@ function nearestRuntimeGapPm(runtimePos, previous, next) {
   const distanceToNext = Math.abs(next.runtimeStart - runtimePos);
   return distanceToPrevious <= distanceToNext ? previous.pmEnd : next.pmStart;
 }
-function lastEditableEntry(entries) {
+function isRuntimeRestorableEntry(entry) {
+  return entry.editable !== false && entry.restorable !== false;
+}
+function lastRestorableEntry(entries) {
   for (let index = entries.length - 1; index >= 0; index -= 1) {
     const entry = entries[index];
-    if (entry.editable !== false) {
+    if (isRuntimeRestorableEntry(entry)) {
       return entry;
     }
   }
@@ -6546,7 +6587,7 @@ function walkBlocks(blocks, pmCursor, entries, protectedInlineEntries, context)
           pmEnd: pmContentStart + runtimeLength,
           editable,
           insideTable: context.insideTable === true || context.tableCell !== void 0,
-          editableTarget: editable ? block.editableTarget : void 0,
+          editableTarget: block.editableTarget,
           textTarget: editable && tableCell ? {
             kind: "table-paragraph",
             tableBlockIndex: tableCell.tableBlockIndex,
@@ -6652,6 +6693,33 @@ function hasEditableTargetInBlocks(blocks) {
   }
   return false;
 }
+function findInertEntryForTarget(entries, target) {
+  if (!isSyntheticLayoutContinuationTarget(target)) {
+    return void 0;
+  }
+  return entries.find((entry) => {
+    const candidate = entry.editableTarget;
+    return entry.editable === false && candidate?.targetKey === target.targetKey && candidate.storyKey === target.storyKey && candidate.blockPath === target.blockPath && candidate.leafPath === target.leafPath && candidate.kind === target.kind;
+  });
+}
+function findRestorableEntryForTarget(entries, target) {
+  if ("editableOwner" in target && target.editableOwner && isSyntheticLayoutContinuationTarget(target)) {
+    return findRestorableEntryForOwner(entries, target.editableOwner);
+  }
+  return entries.find((entry) => {
+    const candidate = entry.editableTarget;
+    return isRuntimeRestorableEntry(entry) && candidate?.targetKey === target.targetKey && candidate.storyKey === target.storyKey && candidate.blockPath === target.blockPath && candidate.leafPath === target.leafPath && candidate.kind === target.kind;
+  });
+}
+function findRestorableEntryForOwner(entries, owner) {
+  return entries.find((entry) => {
+    const candidate = entry.editableTarget;
+    return isRuntimeRestorableEntry(entry) && candidate?.targetKey === owner.targetKey && candidate.storyKey === owner.storyKey && candidate.blockPath === owner.blockPath && candidate.leafPath === owner.leafPath && candidate.kind === owner.kind && candidate.commandFamily === owner.commandFamily;
+  });
+}
+function isSyntheticLayoutContinuationTarget(target) {
+  return target.commandFamily === "text-leaf" && target.table?.operationScope === "text" && target.table.verticalMerge === "continue" && target.posture.blockers.includes("synthetic-layout-cell");
+}
 function tableCellFromEditableTarget(target) {
   if (target?.kind !== "table-cell-paragraph-text" && target?.kind !== "nested-table-cell-paragraph-text" && target?.kind !== "sdt-table-cell-paragraph-text") {
     return void 0;
@@ -6806,8 +6874,12 @@ function createPMStateFromSnapshot(surface, selection, plugins, mediaPreviews =
   return { state, positionMap };
 }
 function createPMSelectionFromSnapshot(doc, positionMap, selection) {
-  const pmAnchor = clamp(positionMap.runtimeToPm(selection.anchor), 1, positionMap.pmDocSize - 1);
-  const pmHead = clamp(positionMap.runtimeToPm(selection.head), 1, positionMap.pmDocSize - 1);
+  const mapRuntimeToPm = (runtimePos) => positionMap.runtimeToPmWithContext?.({
+    runtimePos,
+    ...selection.editableTarget ? { editableTarget: selection.editableTarget } : {}
+  }) ?? positionMap.runtimeToPm(runtimePos);
+  const pmAnchor = clamp(mapRuntimeToPm(selection.anchor), 1, positionMap.pmDocSize - 1);
+  const pmHead = clamp(mapRuntimeToPm(selection.head), 1, positionMap.pmDocSize - 1);
   try {
     if (selection.activeRange.kind === "node") {
       const pmNodePos = clamp(pmAnchor - 1, 0, positionMap.pmDocSize - 2);
@@ -7603,7 +7675,7 @@ function createSelectionSyncPlugin(callbacks) {
                 return;
               }
               callbacks.onSelectionChange(
-                createNodeSelectionSnapshot(context.runtimePos, 1)
+                createNodeSelectionSnapshot(context.runtimePos, 1, context.editableTarget)
               );
               return;
             }
@@ -7613,8 +7685,12 @@ function createSelectionSyncPlugin(callbacks) {
             if (anchorContext.editable === false || headContext.editable === false) {
               return;
             }
+            const editableTarget = resolveSelectionEditableTarget(
+              anchorContext.editableTarget,
+              headContext.editableTarget
+            );
             callbacks.onSelectionChange(
-              createSelectionSnapshot2(anchorContext.runtimePos, headContext.runtimePos)
+              createSelectionSnapshot2(anchorContext.runtimePos, headContext.runtimePos, editableTarget)
             );
           }
         }
@@ -7622,6 +7698,10 @@ function createSelectionSyncPlugin(callbacks) {
     }
   });
 }
+function resolveSelectionEditableTarget(anchorTarget, headTarget) {
+  if (!anchorTarget || !headTarget) return void 0;
+  return anchorTarget.targetKey === headTarget.targetKey ? anchorTarget : void 0;
+}
 function createCommandBridgePlugins(callbacks, options) {
   let isComposing = false;
   let pendingCompositionText = null;
@@ -8665,6 +8745,76 @@ function createLocalEditSessionState(options) {
   };
 }
 
+// src/ui-tailwind/editor-surface/predicted-position-map.ts
+function createPredictedPositionMap(canonical, pendingOps) {
+  if (pendingOps.length === 0) return canonical;
+  function opsBefore(runtimePos) {
+    let delta = 0;
+    for (const op of pendingOps) {
+      if (op.fromRuntime <= runtimePos) {
+        delta += opSizeDelta(op);
+      }
+    }
+    return delta;
+  }
+  return {
+    runtimeToPm(runtimePos) {
+      return canonical.runtimeToPm(runtimePos) + opsBefore(runtimePos);
+    },
+    pmToRuntime(pmPos) {
+      return this.pmToRuntimeWithContext(pmPos).runtimePos;
+    },
+    pmToRuntimeWithContext(pmPos) {
+      let adjusted = pmPos;
+      for (const op of pendingOps) {
+        const opPmStart = canonical.runtimeToPm(op.fromRuntime);
+        if (adjusted > opPmStart) {
+          adjusted -= opSizeDelta(op);
+        }
+      }
+      return canonical.pmToRuntimeWithContext(Math.max(1, adjusted));
+    },
+    ...canonical.isPmRangeEditable ? {
+      isPmRangeEditable(fromPm, toPm) {
+        const fromRuntime = this.pmToRuntimeWithContext(fromPm);
+        const toRuntime = this.pmToRuntimeWithContext(toPm);
+        if (fromRuntime.editable === false || toRuntime.editable === false) return false;
+        const canonicalFrom = canonical.runtimeToPm(fromRuntime.runtimePos);
+        const canonicalTo = canonical.runtimeToPm(toRuntime.runtimePos);
+        return canonical.isPmRangeEditable(canonicalFrom, canonicalTo);
+      }
+    } : {},
+    get pmDocSize() {
+      return canonical.pmDocSize + totalDelta(pendingOps);
+    },
+    get runtimeStorySize() {
+      return canonical.runtimeStorySize + totalDelta(pendingOps);
+    }
+  };
+}
+function totalDelta(pendingOps) {
+  let delta = 0;
+  for (const op of pendingOps) {
+    delta += opSizeDelta(op);
+  }
+  return delta;
+}
+function opSizeDelta(op) {
+  switch (op.intent.kind) {
+    case "text.insert":
+      return op.intent.text.length;
+    case "text.delete-backward":
+    case "text.delete-forward":
+      return -(op.toRuntime - op.fromRuntime);
+    case "paragraph.split":
+      return 2;
+    case "text.insert-hard-break":
+      return 1;
+    default:
+      return 0;
+  }
+}
+
 // src/ui-tailwind/editor-surface/predicted-tx-gate.ts
 import { Plugin as Plugin4, PluginKey as PluginKey3 } from "prosemirror-state";
 var PREDICTED_META_KEY = "bounded-local-first/predicted";
@@ -8732,6 +8882,15 @@ function createFastTextEditLane(options) {
       fromContext.editableTarget,
       toContext.editableTarget
     );
+    if (!editableTarget) {
+      return;
+    }
+    const predictedSelection = predictedSelectionForIntent(
+      intent,
+      fromRuntime,
+      toRuntime,
+      editableTarget
+    );
     const debugEntry = pushLaneDebug({
       opId,
       intent: intent.kind,
@@ -8802,6 +8961,7 @@ function createFastTextEditLane(options) {
             newRevisionToken: ack.newRevisionToken
           });
           incrementInvalidationCounter(PREDICTED_LANE_COUNTERS.equivalent);
+          publishLocalEquivalentEffects(ack, op, predictedSelection);
           options.onEquivalentAck(ack);
           return;
         case "adjusted":
@@ -8838,6 +8998,11 @@ function createFastTextEditLane(options) {
       options.suppressSelectionSync?.(false);
     }
   }
+  function publishLocalEquivalentEffects(ack, op, selection) {
+    if (getTextCommandRefreshClass(ack) !== "local-text-equivalent") return;
+    options.onLocalEquivalentOp?.(op);
+    options.onPredictedSelectionChange?.(selection);
+  }
   function restorePreImage(view, pre) {
     view.updateState(pre.preState);
   }
@@ -8873,6 +9038,35 @@ function createFastTextEditLane(options) {
     }
   };
 }
+function predictedSelectionForIntent(intent, fromRuntime, toRuntime, editableTarget) {
+  const from = Math.min(fromRuntime, toRuntime);
+  const to = Math.max(fromRuntime, toRuntime);
+  let anchor = from;
+  switch (intent.kind) {
+    case "text.insert":
+      anchor = from + intent.text.length;
+      break;
+    case "text.insert-hard-break":
+      anchor = from + 1;
+      break;
+    case "text.delete-backward":
+      anchor = from === to ? Math.max(0, from - 1) : from;
+      break;
+    case "text.delete-forward":
+      anchor = from;
+      break;
+    case "paragraph.split":
+      anchor = from;
+      break;
+  }
+  return {
+    anchor,
+    head: anchor,
+    isCollapsed: true,
+    activeRange: createPublicRangeAnchor(anchor, anchor),
+    editableTarget
+  };
+}
 function pushLaneDebug(entry) {
   if (typeof window === "undefined") return null;
   const buffer = window.__DOCX_LANE_DEBUG__;
@@ -12816,9 +13010,11 @@ var TwProseMirrorSurface = forwardRef(function TwProseMirrorSurface2(props, ref)
   const documentBuildKeyRef = useRef5(null);
   const decorationBuildKeyRef = useRef5(null);
   const suppressSelectionEchoRef = useRef5(false);
+  const lastSelectionTargetRef = useRef5(null);
   const sessionRef = useRef5(null);
   const laneRef = useRef5(null);
   const equivalentAckLedgerRef = useRef5(/* @__PURE__ */ new Map());
+  const localEquivalentOpsRef = useRef5([]);
   const pendingRebuildScrollAnchorRef = useRef5(null);
   const lastBuiltStoryRef = useRef5(null);
   const snapshotRef = useRef5(snapshot);
@@ -12828,6 +13024,11 @@ var TwProseMirrorSurface = forwardRef(function TwProseMirrorSurface2(props, ref)
     () => scopeTagRegistryFactoryProp ? scopeTagRegistryFactoryProp() : createScopeTagRegistry(),
     [scopeTagRegistryFactoryProp]
   );
+  const readPositionMap = useCallback2(() => {
+    const canonical = positionMapRef.current;
+    if (!canonical) return null;
+    return createPredictedPositionMap(canonical, localEquivalentOpsRef.current);
+  }, []);
   callbacksRef.current = {
     onInsertText: (text) => {
       pendingTypingProbeRef.current = startPerfProbe("typing");
@@ -12865,11 +13066,12 @@ var TwProseMirrorSurface = forwardRef(function TwProseMirrorSurface2(props, ref)
     },
     onSelectionChange: (sel) => {
       pendingSelectionProbeRef.current = startPerfProbe("selection");
+      lastSelectionTargetRef.current = sel.editableTarget ? { anchor: sel.anchor, head: sel.head, editableTarget: sel.editableTarget } : null;
       props.onSelectionChange?.(
         snapshot.activeStory.kind === "main" ? sel : { ...sel, storyTarget: snapshot.activeStory }
       );
     },
-    getPositionMap: () => positionMapRef.current,
+    getPositionMap: readPositionMap,
     isSelectionSyncSuppressed: () => suppressSelectionEchoRef.current,
     // Phase D.1 — forward contextmenu events to the host-supplied
     // chrome controller.  Delegates through a ref-indirect so handler
@@ -13028,7 +13230,7 @@ var TwProseMirrorSurface = forwardRef(function TwProseMirrorSurface2(props, ref)
       // returned by each plugin's `props.decorations`.
       createRuntimeDecorationPlugin()
     ];
-  }, [props.awareness, props.onCommentActivated, props.onRevisionActivated, props.onRevisionHovered]);
+  }, [props.awareness, props.onCommentActivated, props.onRevisionActivated, props.onRevisionHovered, readPositionMap]);
   const applyDecorationProps = useCallback2(
     (view, positionMap) => {
       const inputs = {
@@ -13092,6 +13294,7 @@ var TwProseMirrorSurface = forwardRef(function TwProseMirrorSurface2(props, ref)
     return () => {
       sessionRef.current = null;
       laneRef.current = null;
+      localEquivalentOpsRef.current = [];
     };
   }, []);
   useEffect4(() => {
@@ -13120,6 +13323,7 @@ var TwProseMirrorSurface = forwardRef(function TwProseMirrorSurface2(props, ref)
     if (!props.dispatchRuntimeCommand || !sessionRef.current) {
       laneRef.current = null;
       equivalentAckLedgerRef.current.clear();
+      localEquivalentOpsRef.current = [];
       pendingRebuildScrollAnchorRef.current = null;
       return;
     }
@@ -13127,7 +13331,7 @@ var TwProseMirrorSurface = forwardRef(function TwProseMirrorSurface2(props, ref)
     laneRef.current = createFastTextEditLane({
       session: sessionRef.current,
       getView: () => viewRef.current,
-      getPositionMap: () => positionMapRef.current,
+      getPositionMap: readPositionMap,
       dispatchRuntimeCommand: props.dispatchRuntimeCommand,
       probe: {
         markPredicted(opId) {
@@ -13157,6 +13361,12 @@ var TwProseMirrorSurface = forwardRef(function TwProseMirrorSurface2(props, ref)
           toRuntime
         );
       },
+      onLocalEquivalentOp: (op) => {
+        localEquivalentOpsRef.current = [...localEquivalentOpsRef.current, op];
+      },
+      onPredictedSelectionChange: (selection) => {
+        callbacksRef.current?.onSelectionChange(selection);
+      },
       onEquivalentAck: (ack) => {
         pendingRebuildScrollAnchorRef.current = null;
         if (ack.opId && ack.newRevisionToken && getTextCommandRefreshClass(ack) === "local-text-equivalent") {
@@ -13164,21 +13374,25 @@ var TwProseMirrorSurface = forwardRef(function TwProseMirrorSurface2(props, ref)
           return;
         }
         equivalentAckLedgerRef.current.clear();
+        localEquivalentOpsRef.current = [];
       },
       onAdjustedAck: (ack) => {
         equivalentAckLedgerRef.current.clear();
+        localEquivalentOpsRef.current = [];
         pendingRebuildScrollAnchorRef.current = getTextCommandRefreshClass(ack) === "surface-only" ? "bounded-same-story" : null;
       },
       onRejectedAck: () => {
         equivalentAckLedgerRef.current.clear();
+        localEquivalentOpsRef.current = [];
         pendingRebuildScrollAnchorRef.current = null;
       },
       onStructuralDivergence: () => {
         equivalentAckLedgerRef.current.clear();
+        localEquivalentOpsRef.current = [];
         pendingRebuildScrollAnchorRef.current = null;
       }
     });
-  }, [props.dispatchRuntimeCommand, scopeTagRegistry]);
+  }, [props.dispatchRuntimeCommand, readPositionMap, scopeTagRegistry]);
   useEffect4(() => {
     if (!mountRef.current || !surface) return;
     if (viewRef.current && documentBuildKeyRef.current === documentBuildKey) {
@@ -13191,6 +13405,7 @@ var TwProseMirrorSurface = forwardRef(function TwProseMirrorSurface2(props, ref)
       documentBuildKeyRef.current = documentBuildKey;
       applyDecorationProps(viewRef.current, positionMapRef.current);
       equivalentAckLedgerRef.current.delete(snapshot.revisionToken);
+      localEquivalentOpsRef.current = [];
       pendingRebuildScrollAnchorRef.current = null;
       lastBuiltStoryRef.current = snapshot.activeStory;
       if (pendingTypingProbeRef.current) {
@@ -13208,6 +13423,7 @@ var TwProseMirrorSurface = forwardRef(function TwProseMirrorSurface2(props, ref)
       props.isPageWorkspace
     );
     positionMapRef.current = positionMap;
+    localEquivalentOpsRef.current = [];
     recordPerfSample("pm.rebuild");
     incrementInvalidationCounter("pm.laneA.rebuilds");
     let appliedDecorationProps = false;
@@ -13298,10 +13514,14 @@ var TwProseMirrorSurface = forwardRef(function TwProseMirrorSurface2(props, ref)
     if (!view || !surface || !positionMap) {
       return;
     }
+    const selectionWithTarget = selectionWithLastMountedTarget(
+      snapshot.selection,
+      lastSelectionTargetRef.current
+    );
     const nextSelection = createPMSelectionFromSnapshot(
       view.state.doc,
       positionMap,
-      snapshot.selection
+      selectionWithTarget
     );
     if (view.state.selection.eq(nextSelection)) {
       return;
@@ -13584,6 +13804,18 @@ function createWorkflowMetadataSignature(metadata) {
     ].join(":")
   ).join("|");
 }
+function selectionWithLastMountedTarget(selection, lastSelectionTarget) {
+  if (selection.editableTarget) {
+    return selection;
+  }
+  if (lastSelectionTarget && selection.anchor === lastSelectionTarget.anchor && selection.head === lastSelectionTarget.head) {
+    return {
+      ...selection,
+      editableTarget: lastSelectionTarget.editableTarget
+    };
+  }
+  return selection;
+}
 function serializeAnchorSignature(anchor) {
   if (!anchor) {
     return "";
@@ -15385,7 +15617,7 @@ var WordReviewEditor = forwardRef3(
           undo: () => activeRuntime.undo(),
           redo: () => activeRuntime.redo(),
           replaceText: (text, target, formatting) => activeRuntime.replaceText(text, target, formatting),
-          insertFragment: (fragment, target) => activeRuntime.insertFragment(fragment, target),
+          insertFragment: (fragment, target, editContext) => activeRuntime.insertFragment(fragment, target, editContext),
           copy: (target) => activeRuntime.copy(target),
           cut: (target) => activeRuntime.cut(target),
           getClipboardBuffer: () => activeRuntime.getClipboardBuffer(),