@beyondwork/docx-react-component 1.0.124 → 1.0.125

package/dist/{chunk-MPH4ZQS4.js → chunk-QT3LX4FA.js}

@@ -11,7 +11,7 @@ import {
 } from "./chunk-M6XR534O.js";
 import {
   buildBookmarkNameMap
-} from "./chunk-NAMAWCXN.js";
+} from "./chunk-YD2JE54B.js";
 import {
   deleteSelectionOrBackward,
   deleteSelectionOrForward,
@@ -22,7 +22,7 @@ import {
   insertText,
   outdentParagraphAtSelection,
   splitParagraph
-} from "./chunk-BOHHIVQ2.js";
+} from "./chunk-4G3OS2H6.js";
 import {
   applyFormattingOperationToDocument,
   applyTextMarkOperationToDocumentRange,
@@ -32,18 +32,18 @@ import {
   insertImage,
   repositionFloatingImage,
   resizeImage
-} from "./chunk-RSYN6FTS.js";
+} from "./chunk-6F5QW44A.js";
 import {
   applyTextTransaction
-} from "./chunk-IR7QV2BX.js";
+} from "./chunk-KV435YXO.js";
 import {
   applyTableStructureOperationForEditableTarget,
   removeCellFromRow,
   removeTableRowPure
-} from "./chunk-LGWNN3L2.js";
+} from "./chunk-ZDOAUP3V.js";
 import {
   resolveParagraphScope
-} from "./chunk-KOHQFZMM.js";
+} from "./chunk-BYSRJ4FE.js";
 import {
   buildGeometryDebugEntry,
   collectLineBoxesForRegion,
@@ -51,7 +51,7 @@ import {
   createRenderKernel,
   incrementInvalidationCounter,
   recordPerfSample
-} from "./chunk-N4VIXI2Z.js";
+} from "./chunk-MWSBGJQO.js";
 import {
   AI_ACTION_POLICIES,
   buildFormattingDebugEntry,
@@ -74,7 +74,7 @@ import {
   resolveHeadingPath,
   resolveScope,
   serializeFragmentToWordML
-} from "./chunk-Q76XPPTA.js";
+} from "./chunk-OHTK7F3F.js";
 import {
   ISSUE_METADATA_ID,
   LAYOUT_ENGINE_VERSION,
@@ -109,7 +109,7 @@ import {
   setWorkspaceMode,
   setZoomLevel,
   snapCommentAnchorAwayFromTable
-} from "./chunk-ZRHLLPSJ.js";
+} from "./chunk-YHZHPXDB.js";
 import {
   countLogicalPositions,
   createPlainText,
@@ -128,7 +128,7 @@ import {
   replaceStoryBlocks,
   resolvePageFieldDisplayText,
   storyTargetKey
-} from "./chunk-H6IL5ABU.js";
+} from "./chunk-CXSYRB37.js";
 import {
   createCommentSidebarProjection,
   createCommentStoreFromRuntimeComments
@@ -152,12 +152,12 @@ import {
   persistedSnapshotFromEditorSessionState,
   remapRevisionStore,
   setRevisionStatus
-} from "./chunk-TY4DIJO3.js";
+} from "./chunk-ESJ2MES5.js";
 import {
   isSupportedFieldFamily,
   parseTocLevelRange,
   resolveRefFieldText
-} from "./chunk-A74Y5NE4.js";
+} from "./chunk-4YJVRIUB.js";
 import {
   collectEditableTargetRefs,
   collectEditableTargetRefsForStoryBlockRanges,
@@ -165,7 +165,7 @@ import {
   createEditableTargetBlockCache,
   createHeaderFooterStoryKey,
   sha256TextHex
-} from "./chunk-FNWKE74J.js";
+} from "./chunk-5DGKFNQT.js";
 import {
   setActiveSerializeTelemetryBus
 } from "./chunk-EB6M3GE6.js";
@@ -1602,7 +1602,7 @@ function validateResult(result, context) {
   return { ...result, selection: validated };
 }
 function getPostMutationMaxOffset(result, context) {
-  if (typeof context.activeStorySize !== "number" || context.textTarget?.kind === "text-leaf") {
+  if (typeof context.activeStorySize !== "number" || isTargetLocalTextLeaf(context.textTarget)) {
     return result.storyText.length;
   }
   let storySize = context.activeStorySize;
@@ -1611,6 +1611,9 @@ function getPostMutationMaxOffset(result, context) {
   }
   return Math.max(result.storyText.length, storySize);
 }
+function isTargetLocalTextLeaf(textTarget) {
+  return textTarget?.kind === "text-leaf" && textTarget.blockPath.includes("/txbx/");
+}
 var editLayer = {
   applyTextInsert(doc, selection, text, context, formatting) {
     return validateResult(insertText(doc, selection, text, context, formatting), context);
@@ -8731,6 +8734,16 @@ function createLayoutFacet(input) {
   function currentGraph() {
     return engine.getPageGraph(getQueryInput());
   }
+  function fullGraphForViewportIndependentReads() {
+    const query = getQueryInput();
+    if (!query.viewportPageWindow) {
+      return engine.getPageGraph(query);
+    }
+    return engine.getPageGraph({
+      document: query.document,
+      ...query.viewState ? { viewState: query.viewState } : {}
+    });
+  }
   function currentMapper() {
     return engine.getFragmentMapper(getQueryInput());
   }
@@ -8868,7 +8881,7 @@ function createLayoutFacet(input) {
       return graph.sections.map((section) => toPublicSectionNode(graph, section.index)).filter((node) => node !== null);
     },
     getPageForOffset(offset, story) {
-      const graph = currentGraph();
+      const graph = fullGraphForViewportIndependentReads();
       const page = findPageForOffsetAndStory(graph, offset, story);
       return page ? toPublicPageNode(page, graph) : null;
     },
@@ -9180,7 +9193,7 @@ function createLayoutFacet(input) {
       return null;
     },
     getBlockHeightsTwips() {
-      const graph = currentGraph();
+      const graph = fullGraphForViewportIndependentReads();
       if (blockHeightsCache.revision === graph.revision && blockHeightsCache.map) {
         return blockHeightsCache.map;
       }
@@ -11971,6 +11984,8 @@ function mapLocalSelectionOnRemoteReplay(selection, mapping) {
 
 // src/runtime/document-runtime.ts
 var CANONICAL_BLOCK_REFS_SYMBOL = /* @__PURE__ */ Symbol.for("wre.canonical-block-refs");
+var LOCAL_TEXT_PATCH_MAX_SHIFTED_SURFACE_NODES = 5e3;
+var LOCAL_TEXT_PATCH_MAX_SHIFTED_NODES_PER_BLOCK = 256;
 function getLocalTextPatchMetadata(mapping) {
   const metadata = mapping.metadata?.localTextPatch;
   if (!metadata || typeof metadata !== "object") {
@@ -12143,8 +12158,10 @@ function createDocumentRuntime(options) {
   void upgradeMeasurementProvider(layoutEngine, fontLoader);
   let renderKernelRef = null;
   let runtimeRef = null;
+  const normalizedInitialSurfaceViewportRanges = options.initialSurfaceViewportBlockRanges && options.initialSurfaceViewportBlockRanges.length > 0 ? normalizeViewportRanges(options.initialSurfaceViewportBlockRanges) : null;
+  let initialSurfaceViewportBlockRanges = normalizedInitialSurfaceViewportRanges && normalizedInitialSurfaceViewportRanges.length > 0 ? normalizedInitialSurfaceViewportRanges : null;
   let viewportBlockRanges = null;
-  let viewportRangesKey = serializeViewportRanges(null);
+  let viewportRangesKey = serializeViewportRanges(viewportBlockRanges);
   let viewportBlocksPerPageEstimate = null;
   const EDITING_CORRIDOR_BLOCK_RADIUS = 8;
   const getRuntimeForLayoutFacet = () => {
@@ -12384,10 +12401,11 @@ function createDocumentRuntime(options) {
   const cachedContextAnalyticsSnapshots = /* @__PURE__ */ new Map();
   let lastEmittedContextAnalyticsSnapshots;
   function getCachedFullSurface(document, nextActiveStory) {
-    const activeStoryKey = storyTargetKey(nextActiveStory);
-    if (cachedFullSurface && cachedFullSurface.content === document.content && cachedFullSurface.subParts === document.subParts && cachedFullSurface.styles === document.styles && cachedFullSurface.numbering === document.numbering && cachedFullSurface.media === document.media && cachedFullSurface.preservation === document.preservation && cachedFullSurface.review === document.review && cachedFullSurface.effectiveMarkupModeProvider === effectiveMarkupModeProvider && cachedFullSurface.activeStoryKey === activeStoryKey) {
-      return cachedFullSurface.snapshot;
+    const cached = getReusableCachedFullSurface(document, nextActiveStory);
+    if (cached) {
+      return cached;
     }
+    const activeStoryKey = storyTargetKey(nextActiveStory);
     const snapshot = createEditorSurfaceSnapshot(document, state.selection, nextActiveStory, {
       viewportBlockRanges: null,
       editableTargetsByBlockPath: getEditableTargetsByBlockPath(document),
@@ -12409,6 +12427,13 @@ function createDocumentRuntime(options) {
     };
     return snapshot;
   }
+  function getReusableCachedFullSurface(document, nextActiveStory) {
+    const activeStoryKey = storyTargetKey(nextActiveStory);
+    if (cachedFullSurface && cachedFullSurface.content === document.content && cachedFullSurface.subParts === document.subParts && cachedFullSurface.styles === document.styles && cachedFullSurface.numbering === document.numbering && cachedFullSurface.media === document.media && cachedFullSurface.preservation === document.preservation && cachedFullSurface.review === document.review && cachedFullSurface.effectiveMarkupModeProvider === effectiveMarkupModeProvider && cachedFullSurface.activeStoryKey === activeStoryKey) {
+      return cachedFullSurface.snapshot;
+    }
+    return void 0;
+  }
   function getCachedSurface(document, nextActiveStory, options2 = {}) {
     const activeStoryKey = storyTargetKey(nextActiveStory);
     const surfaceViewportRanges = "viewportBlockRangesOverride" in options2 ? options2.viewportBlockRangesOverride ?? null : viewportBlockRanges;
@@ -12419,12 +12444,20 @@ function createDocumentRuntime(options) {
     }
     const snapshot = createEditorSurfaceSnapshot(document, state.selection, nextActiveStory, {
       viewportBlockRanges: surfaceViewportRanges,
-      editableTargetsByBlockPath: options2.editableTargetsByBlockPathOverride ?? getEditableTargetsByBlockPath(document),
+      editableTargetsByBlockPath: options2.editableTargetsByBlockPathOverride ?? getEditableTargetsByBlockPathForRanges(
+        document,
+        activeStoryKey,
+        surfaceViewportRanges
+      ),
       ...effectiveMarkupModeProvider ? { getEffectiveMarkupMode: effectiveMarkupModeProvider } : {}
     });
     recordPerfSample("snapshot.surface");
     incrementInvalidationCounter("runtime.snapshot.surfaceMisses");
-    const enrichedSnapshot = options2.enrichCulledPlaceholders === false ? snapshot : enrichCulledPlaceholdersWithHeights(snapshot);
+    const enrichedSnapshot = options2.enrichCulledPlaceholders === false ? snapshot : enrichCulledPlaceholdersWithHeights(
+      snapshot,
+      document,
+      nextActiveStory
+    );
     if (surfaceViewportRanges === null) {
       cachedFullSurface = {
         content: document.content,
@@ -12482,7 +12515,7 @@ function createDocumentRuntime(options) {
     }
     return -1;
   }
-  function cachePatchedLocalTextSurface(surface) {
+  function cachePatchedLocalTextSurface(surface, fullSurfaceForCache) {
     const activeStoryKey = storyTargetKey(activeStory);
     const rangesKey = serializeViewportRanges(surface.viewportBlockRanges);
     cachedSurface = {
@@ -12498,7 +12531,8 @@ function createDocumentRuntime(options) {
       viewportRangesKey: rangesKey,
       snapshot: surface
     };
-    if (surface.viewportBlockRanges === null) {
+    const fullSurface = fullSurfaceForCache ?? (surface.viewportBlockRanges === null ? surface : void 0);
+    if (fullSurface) {
       cachedFullSurface = {
         content: state.document.content,
         subParts: state.document.subParts,
@@ -12509,11 +12543,15 @@ function createDocumentRuntime(options) {
         review: state.document.review,
         effectiveMarkupModeProvider,
         activeStoryKey,
-        snapshot: surface
+        snapshot: fullSurface
       };
     }
     cachedSurfaceFingerprint = `${activeStoryKey}|${rangesKey}|${String(state.selection.anchor)}:${String(state.selection.head)}`;
   }
+  function createLocalTextCorridorSurfaceFromFullSurface(fullSurface) {
+    const ranges = getSelectionCorridorViewportRanges(fullSurface);
+    return ranges ? createViewportCulledSurfaceFromFullSurface(fullSurface, ranges) : fullSurface;
+  }
   function tryPatchLocalTextSurface(previousSurface, mapping) {
     const tTotal0 = performance.now();
     try {
@@ -12549,6 +12587,13 @@ function createDocumentRuntime(options) {
         perfCounters.increment("surface.localText.patchMiss");
         return null;
       }
+      const shiftBudget = estimateLocalTextPatchShiftBudget(previousSurface.blocks, blockIndex + 1);
+      perfCounters.increment("surface.localText.shiftedBlocks", shiftBudget.shiftedBlocks);
+      perfCounters.increment("surface.localText.shiftedNodes", shiftBudget.shiftedNodes);
+      if (!shiftBudget.withinBudget) {
+        perfCounters.increment("surface.localText.patchBudgetFallback");
+        return null;
+      }
       const segmentIndex = block.segments.findIndex(
         (segment2) => segment2.kind === "text" && editFrom >= segment2.from && editTo <= segment2.to
       );
@@ -12656,7 +12701,83 @@ function createDocumentRuntime(options) {
         };
     }
   }
-  function enrichCulledPlaceholdersWithHeights(snapshot) {
+  function estimateLocalTextPatchShiftBudget(blocks, startIndex) {
+    const shiftedBlocks = Math.max(0, blocks.length - startIndex);
+    let shiftedNodes = 0;
+    for (let index = startIndex; index < blocks.length; index += 1) {
+      const shiftedBlockNodes = countSurfaceShiftNodesUpTo(
+        blocks[index],
+        Math.min(
+          LOCAL_TEXT_PATCH_MAX_SHIFTED_NODES_PER_BLOCK,
+          LOCAL_TEXT_PATCH_MAX_SHIFTED_SURFACE_NODES - shiftedNodes
+        ) + 1
+      );
+      shiftedNodes += shiftedBlockNodes;
+      if (shiftedBlockNodes > LOCAL_TEXT_PATCH_MAX_SHIFTED_NODES_PER_BLOCK) {
+        return {
+          shiftedBlocks,
+          shiftedNodes,
+          withinBudget: false
+        };
+      }
+      if (shiftedNodes > LOCAL_TEXT_PATCH_MAX_SHIFTED_SURFACE_NODES) {
+        return {
+          shiftedBlocks,
+          shiftedNodes,
+          withinBudget: false
+        };
+      }
+    }
+    return {
+      shiftedBlocks,
+      shiftedNodes,
+      withinBudget: true
+    };
+  }
+  function countSurfaceShiftNodesUpTo(block, limit) {
+    if (limit <= 0) {
+      return 1;
+    }
+    switch (block.kind) {
+      case "paragraph":
+        return 1 + block.segments.length;
+      case "opaque_block":
+        return 1;
+      case "sdt_block": {
+        let total = 1;
+        for (const child of block.children) {
+          total += countSurfaceShiftNodesUpTo(child, limit - total);
+          if (total > limit) {
+            return total;
+          }
+        }
+        return total;
+      }
+      case "table": {
+        let total = 1;
+        for (const row2 of block.rows) {
+          total += 1;
+          if (total > limit) {
+            return total;
+          }
+          for (const cell of row2.cells) {
+            total += 1;
+            if (total > limit) {
+              return total;
+            }
+            for (const child of cell.content) {
+              total += countSurfaceShiftNodesUpTo(child, limit - total);
+              if (total > limit) {
+                return total;
+              }
+            }
+          }
+        }
+        return total;
+      }
+    }
+  }
+  function enrichCulledPlaceholdersWithHeights(snapshot, document, nextActiveStory, fullSurfaceForPlaceholders) {
     let heights;
     try {
       heights = layoutFacet.getBlockHeightsTwips();
@@ -12664,17 +12785,19 @@ function createDocumentRuntime(options) {
       return snapshot;
     }
     if (heights.size === 0) return snapshot;
+    const fullSurface = fullSurfaceForPlaceholders ?? getReusableCachedFullSurface(document, nextActiveStory);
+    if (!fullSurface) return snapshot;
     let changed = false;
     const enrichedBlocks = snapshot.blocks.map((block) => {
       if (block.kind !== "opaque_block" || block.state !== "placeholder-culled") {
         return block;
       }
-      const realBlockIdFromOffset = resolveBlockIdFromRuntimeOffset(
-        layoutFacet,
-        block.from
+      const realBlock = resolveFullSurfaceBlockForPlaceholder(
+        fullSurface,
+        block
       );
-      if (!realBlockIdFromOffset) return block;
-      const heightTwips = heights.get(realBlockIdFromOffset);
+      if (!realBlock) return block;
+      const heightTwips = heights.get(realBlock.blockId);
       if (typeof heightTwips !== "number" || heightTwips <= 0) return block;
       changed = true;
       return { ...block, placeholderHeightTwips: heightTwips };
@@ -12682,13 +12805,20 @@ function createDocumentRuntime(options) {
     if (!changed) return snapshot;
     return { ...snapshot, blocks: enrichedBlocks };
   }
-  function resolveBlockIdFromRuntimeOffset(facet, runtimeOffset) {
-    try {
-      const frag = facet.getFragmentForOffset?.(runtimeOffset);
-      return frag?.blockId ?? null;
-    } catch {
-      return null;
+  function resolveFullSurfaceBlockForPlaceholder(fullSurface, placeholder) {
+    const index = parsePlaceholderCulledIndex(placeholder.blockId);
+    if (index !== null) {
+      return fullSurface.blocks[index] ?? null;
     }
+    return fullSurface.blocks.find(
+      (block) => block.from === placeholder.from && block.to === placeholder.to
+    ) ?? null;
+  }
+  function parsePlaceholderCulledIndex(blockId) {
+    const match = /^placeholder-culled-(\d+)$/.exec(blockId);
+    if (!match) return null;
+    const index = Number(match[1]);
+    return Number.isSafeInteger(index) ? index : null;
   }
   function getCachedFieldSnapshot(document) {
     const blockCount = document.content.children.length;
@@ -13253,7 +13383,14 @@ function createDocumentRuntime(options) {
       revisionToken: state.revisionToken
     });
     perfCounters.increment("refresh.all");
-    const surface = timeFacet("surface", () => getCachedSurface(state.document, activeStory));
+    const firstSurfaceViewportBlockRanges = initialSurfaceViewportBlockRanges;
+    initialSurfaceViewportBlockRanges = null;
+    const surface = timeFacet(
+      "surface",
+      () => firstSurfaceViewportBlockRanges ? getCachedSurface(state.document, activeStory, {
+        viewportBlockRangesOverride: firstSurfaceViewportBlockRanges
+      }) : getCachedSurface(state.document, activeStory)
+    );
     const snapshot = {
       documentId: state.documentId,
       sessionId: state.sessionId,
@@ -13351,8 +13488,10 @@ function createDocumentRuntime(options) {
     if (options2.forceProjection) {
       cachedFullSurface = void 0;
     }
-    const newSurface = viewportBlockRanges !== null && options2.forceProjection !== true ? createViewportCulledSurfaceFromFullSurface(
-      getCachedFullSurface(state.document, activeStory),
+    const reusableFullSurface = viewportBlockRanges !== null && options2.forceProjection !== true ? getReusableCachedFullSurface(state.document, activeStory) : void 0;
+    const derivedFromFull = viewportBlockRanges !== null && reusableFullSurface !== void 0;
+    const projectedSurface = derivedFromFull ? createViewportCulledSurfaceFromFullSurface(
+      reusableFullSurface,
       viewportBlockRanges
     ) : createEditorSurfaceSnapshot(
       state.document,
@@ -13360,11 +13499,21 @@ function createDocumentRuntime(options) {
       activeStory,
       {
         viewportBlockRanges,
-        editableTargetsByBlockPath: getEditableTargetsByBlockPath(state.document),
+        editableTargetsByBlockPath: getEditableTargetsByBlockPathForRanges(
+          state.document,
+          activeStoryKey,
+          viewportBlockRanges
+        ),
         ...effectiveMarkupModeProvider ? { getEffectiveMarkupMode: effectiveMarkupModeProvider } : {}
       }
     );
-    if (viewportBlockRanges !== null && options2.forceProjection !== true) {
+    const newSurface = viewportBlockRanges !== null ? enrichCulledPlaceholdersWithHeights(
+      projectedSurface,
+      state.document,
+      activeStory,
+      reusableFullSurface
+    ) : projectedSurface;
+    if (derivedFromFull) {
       perfCounters.increment("runtime.viewport.derivedSurfaceRefreshes");
     } else {
       recordPerfSample("snapshot.surface");
@@ -14435,12 +14584,86 @@ function createDocumentRuntime(options) {
       }
     },
     applyScopeReplacement(plan) {
+      const resolveEditableTargetHint = (hint) => {
+        if (!hint) return void 0;
+        const activeStoryKey = storyTargetKey(activeStory);
+        if (hint.storyKey !== activeStoryKey) return null;
+        const currentTargets = collectEditableTargetRefs(
+          state.document,
+          editableTargetBlockCache
+        );
+        const target = currentTargets.find(
+          (target2) => target2.storyKey === hint.storyKey && target2.blockPath === hint.blockPath && target2.commandFamily === "text-leaf"
+        );
+        if (!target) return null;
+        const fallbackTextTarget = {
+          kind: "text-leaf",
+          blockPath: target.blockPath,
+          paragraphStart: hint.semanticBlockRange.from,
+          paragraphEnd: hint.semanticBlockRange.to
+        };
+        const resolved = resolveEditableTextTarget({
+          document: state.document,
+          surface: cachedRenderSnapshot.surface?.blocks ?? [],
+          target,
+          activeStoryKey,
+          editableTargetCache: editableTargetBlockCache
+        });
+        if (resolved.kind === "rejected") {
+          return {
+            textTarget: fallbackTextTarget,
+            range: hint.semanticBlockRange
+          };
+        }
+        return {
+          target,
+          textTarget: resolved.textTarget ?? fallbackTextTarget,
+          range: resolved.range
+        };
+      };
+      const mapSemanticStepRangeToEditableTarget = (stepRange, hint, editableRange) => {
+        if (!hint || !editableRange) return stepRange;
+        const semanticFrom = hint.semanticBlockRange.from;
+        const semanticTo = hint.semanticBlockRange.to;
+        const localFrom = Math.max(0, stepRange.from - semanticFrom);
+        const localTo = Math.max(localFrom, stepRange.to - semanticFrom);
+        const semanticLength = Math.max(0, semanticTo - semanticFrom);
+        const editableLength = Math.max(0, editableRange.to - editableRange.from);
+        if (semanticLength === editableLength) {
+          return {
+            from: editableRange.from + localFrom,
+            to: editableRange.from + localTo
+          };
+        }
+        if (stepRange.from === semanticFrom && stepRange.to === semanticTo) {
+          return editableRange;
+        }
+        return stepRange;
+      };
       for (const step of plan.steps) {
         if (step.kind === "text-replace" && step.range && typeof step.text === "string") {
+          const editableTarget = resolveEditableTargetHint(step.editableTargetHint);
+          if (editableTarget === null) {
+            emit({
+              type: "command_blocked",
+              documentId: state.documentId,
+              command: "applyScopeReplacement",
+              reasons: [{
+                code: "unsupported_surface",
+                message: "Scope replacement editable target no longer resolves."
+              }]
+            });
+            continue;
+          }
+          const dispatchRange = mapSemanticStepRangeToEditableTarget(
+            step.range,
+            step.editableTargetHint,
+            editableTarget?.range
+          );
           const anchor = {
             kind: "range",
-            from: step.range.from,
-            to: step.range.to,
+            from: dispatchRange.from,
+            to: dispatchRange.to,
             assoc: { start: -1, end: 1 }
           };
           const timestamp = clock();
@@ -14449,6 +14672,8 @@ function createDocumentRuntime(options) {
               {
                 type: "text.insert",
                 text: step.text,
+                ...editableTarget?.target ? { editableTarget: editableTarget.target } : {},
+                ...editableTarget?.textTarget ? { textTarget: editableTarget.textTarget } : {},
                 ...step.formatting ? { formatting: step.formatting } : {},
                 origin: createOrigin("api", timestamp)
               },
@@ -14486,10 +14711,28 @@ function createDocumentRuntime(options) {
             emitError(toRuntimeError(error));
           }
         } else if (step.kind === "text-insert-tracked" && step.range && typeof step.text === "string") {
+          const editableTarget = resolveEditableTargetHint(step.editableTargetHint);
+          if (editableTarget === null) {
+            emit({
+              type: "command_blocked",
+              documentId: state.documentId,
+              command: "applyScopeReplacement",
+              reasons: [{
+                code: "unsupported_surface",
+                message: "Scope replacement editable target no longer resolves."
+              }]
+            });
+            continue;
+          }
+          const dispatchRange = mapSemanticStepRangeToEditableTarget(
+            step.range,
+            step.editableTargetHint,
+            editableTarget?.range
+          );
           const anchor = {
             kind: "range",
-            from: step.range.from,
-            to: step.range.to,
+            from: dispatchRange.from,
+            to: dispatchRange.to,
             assoc: { start: -1, end: 1 }
           };
           const timestamp = clock();
@@ -14498,6 +14741,8 @@ function createDocumentRuntime(options) {
               {
                 type: "text.insert",
                 text: step.text,
+                ...editableTarget?.target ? { editableTarget: editableTarget.target } : {},
+                ...editableTarget?.textTarget ? { textTarget: editableTarget.textTarget } : {},
                 ...step.formatting ? { formatting: step.formatting } : {},
                 origin: createOrigin("api", timestamp)
               },
@@ -14512,10 +14757,28 @@ function createDocumentRuntime(options) {
             emitError(toRuntimeError(error));
           }
         } else if (step.kind === "text-delete-tracked" && step.range && step.range.to > step.range.from) {
+          const editableTarget = resolveEditableTargetHint(step.editableTargetHint);
+          if (editableTarget === null) {
+            emit({
+              type: "command_blocked",
+              documentId: state.documentId,
+              command: "applyScopeReplacement",
+              reasons: [{
+                code: "unsupported_surface",
+                message: "Scope replacement editable target no longer resolves."
+              }]
+            });
+            continue;
+          }
+          const dispatchRange = mapSemanticStepRangeToEditableTarget(
+            step.range,
+            step.editableTargetHint,
+            editableTarget?.range
+          );
           const anchor = {
             kind: "range",
-            from: step.range.from,
-            to: step.range.to,
+            from: dispatchRange.from,
+            to: dispatchRange.to,
             assoc: { start: -1, end: 1 }
           };
           const timestamp = clock();
@@ -14523,6 +14786,8 @@ function createDocumentRuntime(options) {
             applyTextCommandInActiveStory(
               {
                 type: "text.delete-forward",
+                ...editableTarget?.target ? { editableTarget: editableTarget.target } : {},
+                ...editableTarget?.textTarget ? { textTarget: editableTarget.textTarget } : {},
                 origin: createOrigin("api", timestamp)
               },
               {
@@ -16043,9 +16308,13 @@ function createDocumentRuntime(options) {
       applyViewportRanges(getSelectionCorridorViewportRanges(cachedRenderSnapshot.surface));
     }
     const tValidation0 = performance.now();
-    const patchedLocalTextSurface = useLocalTextCommitSnapshot ? tryPatchLocalTextSurface(cachedRenderSnapshot.surface, transaction.mapping) : null;
+    const patchedFullLocalTextSurface = useLocalTextCommitSnapshot ? tryPatchLocalTextSurface(cachedRenderSnapshot.surface, transaction.mapping) : null;
+    const patchedLocalTextSurface = patchedFullLocalTextSurface ? createLocalTextCorridorSurfaceFromFullSurface(patchedFullLocalTextSurface) : null;
     if (patchedLocalTextSurface) {
-      cachePatchedLocalTextSurface(patchedLocalTextSurface);
+      cachePatchedLocalTextSurface(
+        patchedLocalTextSurface,
+        patchedFullLocalTextSurface ?? void 0
+      );
       perfCounters.increment("commit.localTextValidation.storySizeOnly");
     }
     const localTextViewportRanges = useLocalTextCommitSnapshot && !patchedLocalTextSurface ? getSelectionCorridorViewportRanges(cachedRenderSnapshot.surface) : void 0;
@@ -16085,7 +16354,8 @@ function createDocumentRuntime(options) {
     cachedRenderSnapshot = useLocalTextCommitSnapshot ? refreshLocalTextCommitSnapshot(surfaceForValidation, transaction.mapping) : refreshRenderSnapshot();
     perfCounters.increment("commit.refresh.us", Math.round((performance.now() - tRefresh0) * 1e3));
     const tNotify0 = performance.now();
-    deferNextContextAnalyticsEmit = useLocalTextCommitSnapshot;
+    const shouldDeferContextAnalyticsEmit = transaction.markDirty && transaction.mapping.steps.length > 0;
+    deferNextContextAnalyticsEmit = shouldDeferContextAnalyticsEmit;
     try {
       notify(previous, state, {
         ...transaction,

package/dist/{chunk-7PC6XUNO.js → chunk-TQDQU2E3.js}

@@ -1,10 +1,10 @@
 import {
   loadDocxSessionAsync
-} from "./chunk-4B74ETJI.js";
+} from "./chunk-V6XVZFFH.js";
 import {
   buildCompatibilityReport,
   createLoadScheduler
-} from "./chunk-TY4DIJO3.js";
+} from "./chunk-ESJ2MES5.js";
 import {
   decodePersistedSourcePackageBytes,
   hasValidPersistedSourcePackageDigest,