@beyondwork/docx-react-component 1.0.121 → 1.0.123

package/dist/runtime/document-runtime.cjs

@@ -4885,6 +4885,28 @@ function collectEditableTargetRefs(doc, cache) {
   collectReviewEditableTargets(doc, targets);
   return targets;
 }
+function collectEditableTargetRefsForStoryBlockRanges(doc, storyKey2, ranges, cache) {
+  const targets = [];
+  const context = collectStoryBlockContexts(doc).find((entry) => entry.storyKey === storyKey2);
+  if (!context) return targets;
+  const normalized = normalizeEditableTargetRanges(ranges, context.blocks.length);
+  for (const range of normalized) {
+    collectEditableTargetsInBlocks(
+      context.blocks.slice(range.start, range.end),
+      {
+        storyKey: context.storyKey,
+        basePath: context.basePath,
+        insideSdt: false,
+        insideTextBox: false,
+        tableDepth: 0
+      },
+      targets,
+      cache,
+      range.start
+    );
+  }
+  return targets;
+}
 function createEditableTargetBlockCache() {
   const map = /* @__PURE__ */ new WeakMap();
   return {
@@ -4920,12 +4942,13 @@ function buildBlockCacheSignature(context, blockIndex) {
     owner?.targetKey ?? ""
   ].join("|");
 }
-function collectEditableTargetsInBlocks(blocks, context, targets, cache) {
+function collectEditableTargetsInBlocks(blocks, context, targets, cache, blockIndexOffset = 0) {
   for (let blockIndex = 0; blockIndex < blocks.length; blockIndex += 1) {
     const block = blocks[blockIndex];
     if (!block) continue;
-    const blockPath = `${context.basePath}/block[${blockIndex}]`;
-    const signature = cache !== void 0 ? buildBlockCacheSignature(context, blockIndex) : "";
+    const absoluteBlockIndex = blockIndex + blockIndexOffset;
+    const blockPath = `${context.basePath}/block[${absoluteBlockIndex}]`;
+    const signature = cache !== void 0 ? buildBlockCacheSignature(context, absoluteBlockIndex) : "";
     if (cache !== void 0) {
       const cached = cache.get(block);
       if (cached !== void 0 && cached.blockPath === blockPath && cached.signature === signature) {
@@ -5109,6 +5132,22 @@ function collectEditableTargetsInTable(table, tablePath, context, targets, cache
     }
   }
 }
+function normalizeEditableTargetRanges(ranges, blockCount) {
+  const normalized = [];
+  const sortedRanges = [...ranges].sort((left, right) => left.start - right.start || left.end - right.end);
+  for (const range of sortedRanges) {
+    const start = Math.max(0, Math.min(blockCount, Math.floor(range.start)));
+    const end = Math.max(start, Math.min(blockCount, Math.ceil(range.end)));
+    if (start === end) continue;
+    const previous = normalized[normalized.length - 1];
+    if (previous && start <= previous.end) {
+      previous.end = Math.max(previous.end, end);
+    } else {
+      normalized.push({ start, end });
+    }
+  }
+  return normalized;
+}
 function findVerticalMergeOwner(owners, gridColumnStart2, gridSpan) {
   return owners.find(
     (owner) => owner.gridColumnStart === gridColumnStart2 && owner.gridSpan === gridSpan
@@ -11061,6 +11100,8 @@ function createSurfaceBlock(block, document2, cursor, counters, formattingContex
     formattingContext,
     promoteSecondaryStoryTextBoxes,
     cullBuild,
+    editableTargetsByBlockPath,
+    blockPath,
     blockPath !== void 0 ? editableTargetsByBlockPath.get(blockPath) : void 0
   );
 }
@@ -11467,7 +11508,7 @@ function getRecursableSdtBlockedReasonCode(block) {
   ].filter(Boolean).join(" ").toLowerCase();
   return searchText.includes("table of contents") || /\btoc\b/u.test(searchText) ? "workflow_preserve_only" : null;
 }
-function createParagraphBlock(paragraphIndex, paragraph, document2, start, formattingContext, promoteSecondaryStoryTextBoxes, cullBuild = false, editableTarget) {
+function createParagraphBlock(paragraphIndex, paragraph, document2, start, formattingContext, promoteSecondaryStoryTextBoxes, cullBuild = false, editableTargetsByBlockPath = EMPTY_EDITABLE_TARGETS_BY_BLOCK_PATH, blockPath, editableTarget) {
   const themeResolver = formattingContext.theme;
   const effectiveNumbering = formattingContext.resolveEffectiveParagraphNumbering(paragraph);
   let resolvedNumbering = null;
@@ -11532,6 +11573,8 @@ function createParagraphBlock(paragraphIndex, paragraph, document2, start, forma
       document2,
       cursor,
       promoteSecondaryStoryTextBoxes,
+      blockPath !== void 0 ? `${blockPath}/inline[${childIndex}]` : void 0,
+      editableTargetsByBlockPath,
       void 0,
       cullBuild,
       themeResolver,
@@ -11588,7 +11631,7 @@ function isVisibleTocResultInline(node) {
       return false;
   }
 }
-function appendInlineSegments(paragraph, node, document2, start, promoteSecondaryStoryTextBoxes, hyperlinkHref, cullBuild = false, themeResolver, formattingContext) {
+function appendInlineSegments(paragraph, node, document2, start, promoteSecondaryStoryTextBoxes, inlinePath, editableTargetsByBlockPath = EMPTY_EDITABLE_TARGETS_BY_BLOCK_PATH, hyperlinkHref, cullBuild = false, themeResolver, formattingContext) {
   switch (node.type) {
     case "text": {
       const cloned = node.marks ? cloneMarks2(node.marks) : { marks: [] };
@@ -11641,13 +11684,16 @@ function appendInlineSegments(paragraph, node, document2, start, promoteSecondar
       return { nextCursor: start + 1, lockedFragmentIds: [] };
     case "hyperlink": {
       let cursor = start;
-      for (const child of node.children) {
+      for (let childIndex = 0; childIndex < node.children.length; childIndex += 1) {
+        const child = node.children[childIndex];
         const result = appendInlineSegments(
           paragraph,
           child,
           document2,
           cursor,
           promoteSecondaryStoryTextBoxes,
+          inlinePath !== void 0 ? `${inlinePath}/child[${childIndex}]` : void 0,
+          editableTargetsByBlockPath,
           node.href,
           cullBuild,
           themeResolver,
@@ -11706,6 +11752,33 @@ function appendInlineSegments(paragraph, node, document2, start, promoteSecondar
       if (isMicrosoftSensitivityLabelShape(node)) {
         return { nextCursor: start + 1, lockedFragmentIds: [] };
       }
+      if (node.isTextBox && node.txbxBlocks !== void 0) {
+        const txbxTextSegment = extractTxbxFirstTextSegment(node.txbxBlocks);
+        const txbxText = txbxTextSegment?.text ?? node.text;
+        const txbxBody = surfaceTextBoxBodyFromShape(
+          node,
+          void 0,
+          inlinePath,
+          editableTargetsByBlockPath
+        );
+        paragraph.segments.push({
+          segmentId: `${paragraph.blockId}-segment-${paragraph.segments.length}`,
+          kind: "shape",
+          from: start,
+          to: start + 1,
+          label: "Text box",
+          detail: createShapeDetail(node),
+          ...node.geometry !== void 0 ? { geometry: node.geometry } : {},
+          isTextBox: true,
+          ...node.textBoxBody ? { textBoxBody: node.textBoxBody } : {},
+          ...node.preserveOnlyObject ? { preserveOnlyObject: surfacePreserveOnlyObject(node.preserveOnlyObject) } : {},
+          ...txbxText ? { txbxText } : {},
+          ...txbxBody ? { txbxBody } : {},
+          ...txbxTextSegment?.marks && txbxTextSegment.marks.length > 0 ? { txbxMarks: txbxTextSegment.marks } : {},
+          ...txbxTextSegment?.markAttrs ? { txbxMarkAttrs: txbxTextSegment.markAttrs } : {}
+        });
+        return { nextCursor: start + 1, lockedFragmentIds: [] };
+      }
       if (promoteSecondaryStoryTextBoxes && node.isTextBox && node.text) {
         return appendTextBoxSegment(
           paragraph,
@@ -11765,7 +11838,7 @@ function appendInlineSegments(paragraph, node, document2, start, promoteSecondar
         const anchor = surfaceAnchorFromGeometry(node.anchor);
         const txbxTextSegment = c.isTextBox ? extractTxbxFirstTextSegment(c.txbxBlocks) : void 0;
         const txbxText = txbxTextSegment?.text ?? (c.isTextBox ? c.text : void 0);
-        const txbxBody = c.isTextBox ? surfaceTextBoxBodyFromShape(c, node.sourceRef) : void 0;
+        const txbxBody = c.isTextBox ? surfaceTextBoxBodyFromShape(c, node.sourceRef, inlinePath, editableTargetsByBlockPath) : void 0;
         const surfaceFill = c.fill;
         paragraph.segments.push({
           segmentId: `${paragraph.blockId}-segment-${paragraph.segments.length}`,
@@ -11942,13 +12015,16 @@ function appendInlineSegments(paragraph, node, document2, start, promoteSecondar
         const refHyperlinkHref = (node.fieldFamily === "REF" || node.fieldFamily === "PAGEREF" || node.fieldFamily === "NOTEREF") && node.switches?.hyperlink === true && node.fieldTarget ? `#${node.fieldTarget}` : void 0;
         let cursor = start;
         const lockedIds = [];
-        for (const child of node.children) {
+        for (let childIndex = 0; childIndex < node.children.length; childIndex += 1) {
+          const child = node.children[childIndex];
           const result = appendInlineSegments(
             paragraph,
             child,
             document2,
             cursor,
             promoteSecondaryStoryTextBoxes,
+            inlinePath !== void 0 ? `${inlinePath}/child[${childIndex}]` : void 0,
+            editableTargetsByBlockPath,
             refHyperlinkHref ?? hyperlinkHref,
             cullBuild,
             themeResolver,
@@ -12195,7 +12271,7 @@ function extractTxbxFirstTextSegment(blocks) {
   }
   return void 0;
 }
-function surfaceTextBoxBodyFromShape(shape, sourceRef) {
+function surfaceTextBoxBodyFromShape(shape, sourceRef, inlinePath, editableTargetsByBlockPath = EMPTY_EDITABLE_TARGETS_BY_BLOCK_PATH) {
   if (!shape.isTextBox && shape.txbxContentXml === void 0 && shape.txbxBlocks === void 0) {
     return void 0;
   }
@@ -12221,9 +12297,12 @@ function surfaceTextBoxBodyFromShape(shape, sourceRef) {
       (run, inlineIndex) => surfaceTextBoxRunFromLegacyRun(run, inlineIndex)
     ) ?? [];
     const text = runs.map((run) => run.text ?? "").join("");
+    const blockPath = inlinePath !== void 0 ? `${inlinePath}/txbx/block[${blockIndex}]` : void 0;
+    const editableTarget = blockPath !== void 0 ? editableTargetsByBlockPath.get(blockPath) : void 0;
     return [{
       ...block.sourceRef !== void 0 ? { sourceRef: block.sourceRef } : {},
       blockIndex,
+      ...editableTarget !== void 0 ? { editableTarget } : {},
       text,
       textLength: Array.from(text).length,
       ...block.borders !== void 0 ? { borders: block.borders } : {},
@@ -12919,6 +12998,7 @@ function applyLinearTextTransaction(document2, selection, intent, options) {
       metadata: {
         affectsComments: true,
         affectsRevisions: true,
+        ...createLocalTextPatchMetadata(story.units, unitFrom, unitTo, insertionUnits),
         ...containsParagraphBoundaryChange(story, normalizedRange, insertionUnits) ? { invalidatesStructures: true } : {}
       }
     },
@@ -12986,6 +13066,21 @@ function tryApplyTableParagraphTransaction(document2, selection, intent, options
     storyText: localResult.storyText
   };
 }
+function createLocalTextPatchMetadata(units, unitFrom, unitTo, insertionUnits) {
+  if (!insertionUnits.every((unit) => unit.kind === "text")) {
+    return {};
+  }
+  for (let index = unitFrom; index < unitTo; index += 1) {
+    if (units[index]?.kind !== "text") {
+      return {};
+    }
+  }
+  return {
+    localTextPatch: {
+      insertedText: insertionUnits.map((unit) => unit.kind === "text" ? unit.value : "").join("")
+    }
+  };
+}
 function tryApplyTargetedTextLeafTransaction(document2, selection, intent, options) {
   const scope = resolveTargetedTextLeafScope(document2, selection, options.textTarget);
   if (!scope) {
@@ -19703,8 +19798,8 @@ function isNodeSelectableSegment(segment) {
 }
 
 // src/runtime/edit-ops/index.ts
-function validateResult(result) {
-  const maxOffset = result.storyText.length;
+function validateResult(result, context) {
+  const maxOffset = getPostMutationMaxOffset(result, context);
   const options = result.selection.activeRange.kind === "node" ? {
     isValidNodeTarget: createSurfaceNodeSelectionProbe(
       createEditorSurfaceSnapshot(result.document, result.selection)
@@ -19721,24 +19816,34 @@ function validateResult(result) {
   }
   return { ...result, selection: validated };
 }
+function getPostMutationMaxOffset(result, context) {
+  if (typeof context.activeStorySize !== "number" || context.textTarget?.kind === "text-leaf") {
+    return result.storyText.length;
+  }
+  let storySize = context.activeStorySize;
+  for (const step of result.mapping.steps) {
+    storySize += step.insertSize - Math.max(0, step.to - step.from);
+  }
+  return Math.max(result.storyText.length, storySize);
+}
 var editLayer = {
   applyTextInsert(doc, selection, text, context, formatting) {
-    return validateResult(insertText(doc, selection, text, context, formatting));
+    return validateResult(insertText(doc, selection, text, context, formatting), context);
   },
   applyDeleteBackward(doc, selection, context) {
-    return validateResult(deleteSelectionOrBackward(doc, selection, context));
+    return validateResult(deleteSelectionOrBackward(doc, selection, context), context);
   },
   applyDeleteForward(doc, selection, context) {
-    return validateResult(deleteSelectionOrForward(doc, selection, context));
+    return validateResult(deleteSelectionOrForward(doc, selection, context), context);
   },
   applyInsertTab(doc, selection, context) {
-    return validateResult(insertTab(doc, selection, context));
+    return validateResult(insertTab(doc, selection, context), context);
   },
   applyInsertHardBreak(doc, selection, context) {
-    return validateResult(insertHardBreak(doc, selection, context));
+    return validateResult(insertHardBreak(doc, selection, context), context);
   },
   applySplitParagraph(doc, selection, context) {
-    return validateResult(splitParagraph(doc, selection, context));
+    return validateResult(splitParagraph(doc, selection, context), context);
   }
 };
 
@@ -36068,7 +36173,7 @@ function deriveScopeEditableTargetEvidence(document2, scope, entry, options = {}
     facts.push(projectWorkflowBlockerFact(fact));
     factsByTargetKey.set(fact.targetKey, facts);
   }
-  const entries = collectEditableTargetRefs(document2).map((target) => {
+  const entries = collectEditableTargetRefs(document2, options.editableTargetCache).map((target) => {
     const relation = relationForTarget(target, scope, entry);
     if (!relation) return null;
     const workflowBlockers = Object.freeze(
@@ -37047,7 +37152,8 @@ function composeEvidence(inputs) {
     scope,
     entry,
     {
-      ...inputs.editableTargetBlockerFacts ? { workflowBlockerFacts: inputs.editableTargetBlockerFacts } : {}
+      ...inputs.editableTargetBlockerFacts ? { workflowBlockerFacts: inputs.editableTargetBlockerFacts } : {},
+      ...inputs.editableTargetCache ? { editableTargetCache: inputs.editableTargetCache } : {}
     }
   ) : void 0;
   const contentControls = deriveScopeContentControlEvidence(document2, selfRange);
@@ -37136,7 +37242,8 @@ function compileScopeBundle(scope, inputs) {
     ...inputs.layout ? { layout: inputs.layout } : {},
     ...inputs.adjacentGeometry ? { adjacentGeometry: inputs.adjacentGeometry } : {},
     ...inputs.tableCellTextRange ? { tableCellTextRange: inputs.tableCellTextRange } : {},
-    ...inputs.editableTargetBlockerFacts ? { editableTargetBlockerFacts: inputs.editableTargetBlockerFacts } : {}
+    ...inputs.editableTargetBlockerFacts ? { editableTargetBlockerFacts: inputs.editableTargetBlockerFacts } : {},
+    ...inputs.editableTargetCache ? { editableTargetCache: inputs.editableTargetCache } : {}
   });
   return {
     scope,
@@ -38372,7 +38479,7 @@ function createScopeCompilerService(runtime) {
       const interactionGuard = runtime.getInteractionGuardSnapshot?.();
       const activeStory = runtime.getActiveStory?.();
       const editableTargetBlockerFacts = deriveWorkflowEditableTargetBlockerFacts({
-        targets: collectEditableTargetRefs(document2),
+        targets: collectEditableTargetRefs(document2, runtime.getEditableTargetCache?.()),
         ...interactionGuard ? { guard: interactionGuard } : {},
         ...runtime.getProtectionSnapshot ? { protectionSnapshot: runtime.getProtectionSnapshot() } : {},
         ...activeStory ? { activeStoryKey: storyKeyForEditableTarget(activeStory) } : {}
@@ -38383,6 +38490,7 @@ function createScopeCompilerService(runtime) {
           runtime.getRenderSnapshot?.()
         )
       }) : void 0;
+      const editableTargetCache = runtime.getEditableTargetCache?.();
       return compileScopeBundleById(scopeId, {
         document: document2,
         ...overlay ? { overlay } : {},
@@ -38392,7 +38500,8 @@ function createScopeCompilerService(runtime) {
         editableTargetBlockerFacts,
         ...runtime.geometry ? { geometry: runtime.geometry } : {},
         ...layout ? { layout } : {},
-        tableCellTextRange
+        tableCellTextRange,
+        ...editableTargetCache ? { editableTargetCache } : {}
       });
     },
     buildReplacementScope(targetHandle, input) {
@@ -42145,6 +42254,7 @@ function buildPageGraph(inputOrPages, sectionsArg, storiesArg) {
       regions,
       divergences: frameDivergences,
       subParts: input.subParts,
+      anchors: input.anchors,
       pageFieldCounts
     });
     const divergences = builtFrame.divergences;
@@ -42311,6 +42421,7 @@ function buildPageFrame(input) {
     stories: input.stories,
     regions,
     subParts: input.subParts,
+    anchors: input.anchors,
     pageFieldCounts: input.pageFieldCounts
   });
   const divergences = [...input.divergences, ...pageLocalStoryResult.divergences];
@@ -42348,6 +42459,7 @@ function buildPageLocalStoryInstances(input) {
       input.stories.header,
       input.regions.header,
       findHeaderFooterPart(input.subParts?.headers, input.stories.header),
+      input.anchors,
       input.pageFieldCounts
     );
     instances.push(built.instance);
@@ -42364,6 +42476,7 @@ function buildPageLocalStoryInstances(input) {
       input.stories.footer,
       input.regions.footer,
       findHeaderFooterPart(input.subParts?.footers, input.stories.footer),
+      input.anchors,
       input.pageFieldCounts
     );
     instances.push(built.instance);
@@ -42371,7 +42484,7 @@ function buildPageLocalStoryInstances(input) {
   }
   return { instances, divergences };
 }
-function buildPageLocalStoryInstance(frameId, pageId, pageIndex, sectionIndex, displayPageNumber, layout, target, region, source, pageFieldCounts) {
+function buildPageLocalStoryInstance(frameId, pageId, pageIndex, sectionIndex, displayPageNumber, layout, target, region, source, anchors, pageFieldCounts) {
   const measuredFrameHeightTwips = region?.heightTwips ?? 0;
   const sectionPart = target.sectionIndex === void 0 ? "section-unknown" : `section-${target.sectionIndex}`;
   const instanceId = `${frameId}:${target.kind}:${target.variant}:${target.relationshipId}`;
@@ -42392,7 +42505,9 @@ function buildPageLocalStoryInstance(frameId, pageId, pageIndex, sectionIndex, d
     kind: target.kind,
     variant: target.variant,
     relationshipId: target.relationshipId,
-    region
+    region,
+    storyBasePath: `${target.kind}:${source.partPath ?? `word/${target.kind}${target.relationshipId}.xml`}`,
+    anchorsByInlinePath: buildAnchorsByInlinePath(anchors)
   }) : { objects: [], divergences: [] };
   const signature = buildPageLocalStorySignature({
     kind: target.kind,
@@ -42446,6 +42561,23 @@ function buildPageLocalStorySignature(input) {
         object.anchorRectTwips?.yTwips ?? "",
         object.anchorRectTwips?.widthTwips ?? "",
         object.anchorRectTwips?.heightTwips ?? "",
+        object.textBoxBody?.bodyKey ?? "",
+        object.textBoxBody?.status ?? "",
+        object.textBoxBody?.unavailableReason ?? "",
+        object.textBoxBody?.contentRectTwips?.xTwips ?? "",
+        object.textBoxBody?.contentRectTwips?.yTwips ?? "",
+        object.textBoxBody?.contentRectTwips?.widthTwips ?? "",
+        object.textBoxBody?.contentRectTwips?.heightTwips ?? "",
+        object.textBoxBody?.paragraphs.map(
+          (paragraph) => [
+            paragraph.paragraphKey,
+            paragraph.rectTwips?.xTwips ?? "",
+            paragraph.rectTwips?.yTwips ?? "",
+            paragraph.rectTwips?.widthTwips ?? "",
+            paragraph.rectTwips?.heightTwips ?? "",
+            paragraph.unavailableReason ?? ""
+          ].join("/")
+        ).join(",") ?? "",
         object.relationshipIds?.join(",") ?? "",
         object.mediaIds?.join(",") ?? "",
         object.wrapMode ?? "",
@@ -42590,6 +42722,10 @@ function truncatePageLocalStoryPreview(text) {
   if (text.length <= MAX_PAGE_LOCAL_STORY_PREVIEW_CHARS) return text;
   return `${text.slice(0, MAX_PAGE_LOCAL_STORY_PREVIEW_CHARS - 1).trimEnd()}\u2026`;
 }
+function buildAnchorsByInlinePath(anchors) {
+  if (!anchors || anchors.length === 0) return void 0;
+  return new Map(anchors.map((anchor) => [anchor.inlinePath, anchor]));
+}
 function collectStoryAnchoredObjects(blocks, context) {
   const objects = [];
   const divergences = [];
@@ -42633,26 +42769,45 @@ function collectStoryAnchoredObjects(blocks, context) {
     });
     ordinal += 1;
   };
-  const visitBlock = (block) => {
+  const visitBlocks = (blocksToVisit, basePath) => {
+    for (let blockIndex = 0; blockIndex < blocksToVisit.length; blockIndex += 1) {
+      const block = blocksToVisit[blockIndex];
+      if (!block) continue;
+      visitBlock(block, `${basePath}/block[${blockIndex}]`);
+    }
+  };
+  const visitBlock = (block, blockPath) => {
     switch (block.type) {
       case "paragraph":
-        for (const child of block.children) visitInline(child);
+        visitInlines(block.children, blockPath, `${blockPath}/inline`);
         break;
       case "table":
-        for (const row2 of block.rows) {
-          for (const cell of row2.cells) {
-            for (const child of cell.children) visitBlock(child);
+        for (let rowIndex = 0; rowIndex < block.rows.length; rowIndex += 1) {
+          const row2 = block.rows[rowIndex];
+          if (!row2) continue;
+          for (let cellIndex = 0; cellIndex < row2.cells.length; cellIndex += 1) {
+            const cell = row2.cells[cellIndex];
+            if (!cell) continue;
+            visitBlocks(cell.children, `${blockPath}/row[${rowIndex}]/cell[${cellIndex}]`);
           }
         }
         break;
       case "sdt":
-        for (const child of block.children) visitBlock(child);
+      case "custom_xml":
+        visitBlocks(block.children, blockPath);
         break;
       default:
         break;
     }
   };
-  const visitInline = (inline) => {
+  const visitInlines = (inlines, blockPath, basePath) => {
+    for (let inlineIndex = 0; inlineIndex < inlines.length; inlineIndex += 1) {
+      const inline = inlines[inlineIndex];
+      if (!inline) continue;
+      visitInline(inline, blockPath, `${basePath}[${inlineIndex}]`);
+    }
+  };
+  const visitInline = (inline, blockPath, inlinePath) => {
     switch (inline.type) {
       case "image": {
         pushObject({
@@ -42673,17 +42828,27 @@ function collectStoryAnchoredObjects(blocks, context) {
           inline.anchor.extent.widthEmu,
           inline.anchor.extent.heightEmu
         );
+        const anchorRectTwips = resolveObjectAnchorRectTwips(
+          context.region,
+          extentTwips,
+          inline.anchor.positionH,
+          inline.anchor.positionV
+        );
+        const canonicalAnchor = context.anchorsByInlinePath?.get(inlinePath);
+        const textBoxBody = buildDrawingFrameTextBoxBodyFacts(
+          inline,
+          canonicalAnchor,
+          inlinePath,
+          display,
+          anchorRectTwips
+        );
         pushObject({
           objectId: getDrawingFrameObjectId(inline, context.storyKey, ordinal),
           sourceType: "drawing-frame",
           display,
           extentTwips,
-          anchorRectTwips: resolveObjectAnchorRectTwips(
-            context.region,
-            extentTwips,
-            inline.anchor.positionH,
-            inline.anchor.positionV
-          ),
+          anchorRectTwips,
+          ...textBoxBody ? { textBoxBody } : {},
           ...relationshipIds.length > 0 ? { relationshipIds } : {},
           ...inline.content.type === "picture" && inline.content.mediaId ? { mediaIds: [inline.content.mediaId] } : {},
           preserveOnly: Boolean(preserveHint),
@@ -42691,7 +42856,7 @@ function collectStoryAnchoredObjects(blocks, context) {
           wrapMode: inline.anchor.wrapMode
         });
         if (inline.content.type === "shape") {
-          for (const child of inline.content.txbxBlocks ?? []) visitBlock(child);
+          visitBlocks(inline.content.txbxBlocks ?? [], `${inlinePath}/txbx`);
         }
         break;
       }
@@ -42718,10 +42883,11 @@ function collectStoryAnchoredObjects(blocks, context) {
           } : {},
           ...preserveHint?.relationshipIds ? { relationshipIds: [...preserveHint.relationshipIds] } : {},
           preserveOnly: Boolean(preserveHint),
-          ...preserveHint ? { preserveHint } : {}
+          ...preserveHint ? { preserveHint } : {},
+          ...inline.type === "vml_shape" && inline.text ? { textBoxBody: buildUnsupportedVmlTextBoxFacts(inline, inlinePath) } : {}
         });
         if (inline.type === "shape") {
-          for (const child of inline.txbxBlocks ?? []) visitBlock(child);
+          visitBlocks(inline.txbxBlocks ?? [], `${inlinePath}/txbx`);
         }
         break;
       }
@@ -42743,16 +42909,16 @@ function collectStoryAnchoredObjects(blocks, context) {
         });
         break;
       case "field":
-        for (const child of inline.children) visitInline(child);
+        visitInlines(inline.children, blockPath, `${inlinePath}/child`);
         break;
       case "hyperlink":
-        for (const child of inline.children) visitInline(child);
+        visitInlines(inline.children, blockPath, `${inlinePath}/child`);
         break;
       default:
         break;
     }
   };
-  for (const block of blocks) visitBlock(block);
+  visitBlocks(blocks, context.storyBasePath);
   return { objects, divergences };
 }
 function getDrawingFramePreserveHint(inline) {
@@ -42760,6 +42926,170 @@ function getDrawingFramePreserveHint(inline) {
   if (content.type === "picture") return void 0;
   return content.preserveOnlyObject;
 }
+function buildDrawingFrameTextBoxBodyFacts(inline, canonicalAnchor, inlinePath, display, anchorRectTwips) {
+  if (inline.content.type !== "shape") return void 0;
+  const content = inline.content;
+  const canonicalBody = canonicalAnchor?.textBoxBody;
+  const hasTextBoxContent = Boolean(
+    canonicalBody || content.isTextBox || content.textBoxBody || content.txbxBlocks?.length
+  );
+  if (!hasTextBoxContent) return void 0;
+  if (!canonicalBody) {
+    return unavailableTextBoxBodyFacts(
+      `${canonicalAnchor?.objectKey ?? inlinePath}:txbx`,
+      "unmodeled-txbx-blocks",
+      content.textBoxBody,
+      content.txbxBlocks?.length ?? 0,
+      countParagraphBlocks(content.txbxBlocks ?? []),
+      0
+    );
+  }
+  if (display !== "floating") {
+    return unavailableTextBoxBodyFactsFromCanonical(canonicalBody, "inline-textbox");
+  }
+  if (!anchorRectTwips) {
+    return unavailableTextBoxBodyFactsFromCanonical(canonicalBody, "missing-anchor-rect");
+  }
+  if (canonicalBody.status !== "modeled") {
+    return unavailableTextBoxBodyFactsFromCanonical(
+      canonicalBody,
+      normalizeTextBoxBodyUnavailableReason(canonicalBody.unavailableReason)
+    );
+  }
+  const bodyInsetsTwips = textBoxInsetsTwips(canonicalBody.bodyProperties);
+  if (!bodyInsetsTwips) {
+    return unavailableTextBoxBodyFactsFromCanonical(canonicalBody, "missing-body-insets");
+  }
+  const contentRectTwips = rect(
+    anchorRectTwips.xTwips + bodyInsetsTwips.leftTwips,
+    anchorRectTwips.yTwips + bodyInsetsTwips.topTwips,
+    Math.max(0, anchorRectTwips.widthTwips - bodyInsetsTwips.leftTwips - bodyInsetsTwips.rightTwips),
+    Math.max(0, anchorRectTwips.heightTwips - bodyInsetsTwips.topTwips - bodyInsetsTwips.bottomTwips)
+  );
+  return {
+    bodyKey: canonicalBody.bodyKey,
+    status: "modeled",
+    ...canonicalBody.bodyProperties ? { bodyProperties: { ...canonicalBody.bodyProperties } } : {},
+    bodyInsetsTwips,
+    contentRectTwips,
+    blockCount: canonicalBody.blockCount,
+    paragraphCount: canonicalBody.paragraphCount,
+    unsupportedBlockCount: canonicalBody.unsupportedBlockCount,
+    paragraphs: buildTextBoxParagraphFacts(canonicalBody, contentRectTwips)
+  };
+}
+function unavailableTextBoxBodyFactsFromCanonical(body, reason) {
+  return {
+    bodyKey: body.bodyKey,
+    status: body.status === "preserve-only" ? "preserve-only" : "unavailable",
+    unavailableReason: reason,
+    ...body.bodyProperties ? { bodyProperties: { ...body.bodyProperties } } : {},
+    blockCount: body.blockCount,
+    paragraphCount: body.paragraphCount,
+    unsupportedBlockCount: body.unsupportedBlockCount,
+    paragraphs: body.paragraphs.map((paragraph) => ({
+      paragraphKey: paragraph.paragraphKey,
+      blockPath: paragraph.blockPath,
+      blockIndex: paragraph.blockIndex,
+      unavailableReason: reason,
+      ...paragraph.styleId !== void 0 ? { styleId: paragraph.styleId } : {},
+      ...paragraph.alignment !== void 0 ? { alignment: paragraph.alignment } : {},
+      textLength: paragraph.textLength,
+      runCount: paragraph.runCount
+    }))
+  };
+}
+function unavailableTextBoxBodyFacts(bodyKey, reason, bodyProperties, blockCount, paragraphCount, unsupportedBlockCount) {
+  return {
+    bodyKey,
+    status: "unavailable",
+    unavailableReason: reason,
+    ...bodyProperties ? { bodyProperties: { ...bodyProperties } } : {},
+    blockCount,
+    paragraphCount,
+    unsupportedBlockCount,
+    paragraphs: []
+  };
+}
+function buildUnsupportedVmlTextBoxFacts(inline, inlinePath) {
+  const hasText = Boolean(inline.text?.length);
+  return {
+    bodyKey: `${inline.preserveOnlyObject?.sourceId ?? inlinePath}:vml-textbox`,
+    status: "unavailable",
+    unavailableReason: "unsupported-vml-textbox",
+    blockCount: hasText ? 1 : 0,
+    paragraphCount: hasText ? 1 : 0,
+    unsupportedBlockCount: hasText ? 1 : 0,
+    paragraphs: []
+  };
+}
+function buildTextBoxParagraphFacts(body, contentRectTwips) {
+  const paragraphCount = body.paragraphs.length;
+  if (paragraphCount === 0) return [];
+  const baseHeight = Math.floor(contentRectTwips.heightTwips / paragraphCount);
+  return body.paragraphs.map((paragraph, index) => {
+    const yTwips = contentRectTwips.yTwips + baseHeight * index;
+    const heightTwips = index === paragraphCount - 1 ? Math.max(0, contentRectTwips.yTwips + contentRectTwips.heightTwips - yTwips) : Math.max(0, baseHeight);
+    return {
+      paragraphKey: paragraph.paragraphKey,
+      blockPath: paragraph.blockPath,
+      blockIndex: paragraph.blockIndex,
+      rectTwips: rect(
+        contentRectTwips.xTwips,
+        yTwips,
+        contentRectTwips.widthTwips,
+        heightTwips
+      ),
+      ...paragraph.styleId !== void 0 ? { styleId: paragraph.styleId } : {},
+      ...paragraph.alignment !== void 0 ? { alignment: paragraph.alignment } : {},
+      textLength: paragraph.textLength,
+      runCount: paragraph.runCount
+    };
+  });
+}
+function textBoxInsetsTwips(bodyProperties) {
+  if (!bodyProperties || bodyProperties.insetLeftEmu === void 0 || bodyProperties.insetTopEmu === void 0 || bodyProperties.insetRightEmu === void 0 || bodyProperties.insetBottomEmu === void 0) {
+    return void 0;
+  }
+  return {
+    leftTwips: Math.max(0, Math.round(bodyProperties.insetLeftEmu / EMUS_PER_TWIP2)),
+    topTwips: Math.max(0, Math.round(bodyProperties.insetTopEmu / EMUS_PER_TWIP2)),
+    rightTwips: Math.max(0, Math.round(bodyProperties.insetRightEmu / EMUS_PER_TWIP2)),
+    bottomTwips: Math.max(0, Math.round(bodyProperties.insetBottomEmu / EMUS_PER_TWIP2))
+  };
+}
+function normalizeTextBoxBodyUnavailableReason(reason) {
+  switch (reason) {
+    case "txbx-blocks-unavailable":
+    case "empty-body":
+    case "unsupported-content":
+      return reason;
+    default:
+      return "unmodeled-txbx-blocks";
+  }
+}
+function countParagraphBlocks(blocks) {
+  let count = 0;
+  const visit = (block) => {
+    if (block.type === "paragraph") {
+      count += 1;
+      return;
+    }
+    if (block.type === "table") {
+      for (const row2 of block.rows) {
+        for (const cell of row2.cells) {
+          for (const child of cell.children) visit(child);
+        }
+      }
+      return;
+    }
+    if (block.type === "sdt" || block.type === "custom_xml") {
+      for (const child of block.children) visit(child);
+    }
+  };
+  for (const block of blocks) visit(block);
+  return count;
+}
 function collectDrawingRelationshipIds(inline) {
   const content = inline.content;
   if (content.type === "picture") return [content.blipRef];
@@ -43088,12 +43418,34 @@ function freezePageFrame(frame) {
   for (const story of frame.pageLocalStories) {
     Object.freeze(story.resolvedFields);
     Object.freeze(story.previewParts);
+    for (const object of story.anchoredObjects) {
+      freezeStoryAnchoredObject(object);
+    }
     Object.freeze(story.anchoredObjects);
     Object.freeze(story);
   }
   Object.freeze(frame.pageLocalStories);
   Object.freeze(frame);
 }
+function freezeStoryAnchoredObject(object) {
+  if (object.extentTwips) Object.freeze(object.extentTwips);
+  if (object.anchorRectTwips) Object.freeze(object.anchorRectTwips);
+  if (object.relationshipIds) Object.freeze(object.relationshipIds);
+  if (object.mediaIds) Object.freeze(object.mediaIds);
+  if (object.textBoxBody) {
+    if (object.textBoxBody.bodyProperties) Object.freeze(object.textBoxBody.bodyProperties);
+    if (object.textBoxBody.bodyInsetsTwips) Object.freeze(object.textBoxBody.bodyInsetsTwips);
+    if (object.textBoxBody.contentRectTwips) Object.freeze(object.textBoxBody.contentRectTwips);
+    for (const paragraph of object.textBoxBody.paragraphs) {
+      if (paragraph.rectTwips) Object.freeze(paragraph.rectTwips);
+      Object.freeze(paragraph);
+    }
+    Object.freeze(object.textBoxBody.paragraphs);
+    Object.freeze(object.textBoxBody);
+  }
+  Object.freeze(object.divergenceIds);
+  Object.freeze(object);
+}
 function normalizePageLocalStoryFieldsForPages(pages) {
   const pageFieldCounts = buildPageFieldCounts(pages);
   return pages.map((page) => {
@@ -44776,7 +45128,8 @@ function createLayoutEngine(options = {}) {
       fragmentsByPageIndex,
       lineBoxesByPageIndex,
       noteAllocationsByPageIndex: pageStack.noteAllocationsByPageIndex,
-      subParts: document2.subParts
+      subParts: document2.subParts,
+      anchors: layoutInputs.anchors
     });
     const graph = applyViewportWindowMaterialization(
       measuredGraph,
@@ -44911,7 +45264,8 @@ function createLayoutEngine(options = {}) {
       fragmentsByPageIndex: freshFragmentsByPageIndex,
       lineBoxesByPageIndex: freshLineBoxesByPageIndex,
       noteAllocationsByPageIndex: freshResult.noteAllocationsByPageIndex,
-      subParts: document2.subParts
+      subParts: document2.subParts,
+      anchors: layoutInputs.anchors
     });
     const freshNodes = freshGraph.pages;
     const splicedGraph = spliceGraph(priorGraph, freshNodes, firstDirty, convergedTailStart);
@@ -48637,12 +48991,37 @@ function toPublicStoryAnchoredObject(object) {
       }
     } : {},
     ...object.anchorRectTwips ? { anchorRectTwips: toPublicTwipsRect(object.anchorRectTwips) } : {},
+    ...object.textBoxBody ? { textBoxBody: toPublicTextBoxBodyFacts(object.textBoxBody) } : {},
     ...object.relationshipIds ? { relationshipIds: [...object.relationshipIds] } : {},
     ...object.mediaIds ? { mediaIds: [...object.mediaIds] } : {},
     preserveOnly: object.preserveOnly,
     divergenceIds: [...object.divergenceIds]
   };
 }
+function toPublicTextBoxBodyFacts(textBoxBody) {
+  return {
+    bodyKey: textBoxBody.bodyKey,
+    status: textBoxBody.status,
+    ...textBoxBody.unavailableReason !== void 0 ? { unavailableReason: textBoxBody.unavailableReason } : {},
+    ...textBoxBody.bodyProperties ? { bodyProperties: { ...textBoxBody.bodyProperties } } : {},
+    ...textBoxBody.bodyInsetsTwips ? { bodyInsetsTwips: { ...textBoxBody.bodyInsetsTwips } } : {},
+    ...textBoxBody.contentRectTwips ? { contentRectTwips: toPublicTwipsRect(textBoxBody.contentRectTwips) } : {},
+    blockCount: textBoxBody.blockCount,
+    paragraphCount: textBoxBody.paragraphCount,
+    unsupportedBlockCount: textBoxBody.unsupportedBlockCount,
+    paragraphs: textBoxBody.paragraphs.map((paragraph) => ({
+      paragraphKey: paragraph.paragraphKey,
+      blockPath: paragraph.blockPath,
+      blockIndex: paragraph.blockIndex,
+      ...paragraph.rectTwips ? { rectTwips: toPublicTwipsRect(paragraph.rectTwips) } : {},
+      ...paragraph.unavailableReason !== void 0 ? { unavailableReason: paragraph.unavailableReason } : {},
+      ...paragraph.styleId !== void 0 ? { styleId: paragraph.styleId } : {},
+      ...paragraph.alignment !== void 0 ? { alignment: paragraph.alignment } : {},
+      textLength: paragraph.textLength,
+      runCount: paragraph.runCount
+    }))
+  };
+}
 function toPublicLayoutDivergence(divergence) {
   return {
     divergenceId: divergence.divergenceId,
@@ -51696,7 +52075,7 @@ function resolveEditableTextTarget(input) {
       "Editable target ref does not belong to the active story."
     );
   }
-  const currentTargets = collectEditableTargetRefs(input.document);
+  const currentTargets = collectEditableTargetRefs(input.document, input.editableTargetCache);
   const current = currentTargets.find(
     (candidate) => candidate.targetKey === input.target.targetKey
   );
@@ -51805,7 +52184,7 @@ function resolveEditableCommandTarget(input) {
       `Editable target kind "${input.target.kind}" is not supported by this command.`
     );
   }
-  const currentTargets = collectEditableTargetRefs(input.document);
+  const currentTargets = collectEditableTargetRefs(input.document, input.editableTargetCache);
   const current = currentTargets.find(
     (candidate) => candidate.targetKey === input.target?.targetKey
   );
@@ -51880,7 +52259,13 @@ function rejectCommand(code, message) {
   };
 }
 function sameResolvedTarget2(left, right) {
-  return left.kind === right.kind && left.storyKey === right.storyKey && left.blockPath === right.blockPath && left.leafPath === right.leafPath && left.commandFamily === right.commandFamily && left.editability === right.editability && left.staleCheck.paragraphTextHash === right.staleCheck.paragraphTextHash && left.staleCheck.paragraphTextLength === right.staleCheck.paragraphTextLength && left.staleCheck.inlineCount === right.staleCheck.inlineCount && left.staleCheck.targetHash === right.staleCheck.targetHash && left.staleCheck.targetTextLength === right.staleCheck.targetTextLength && left.staleCheck.childCount === right.staleCheck.childCount && left.staleCheck.blockType === right.staleCheck.blockType && left.staleCheck.wordParaId === right.staleCheck.wordParaId && left.staleCheck.wordTextId === right.staleCheck.wordTextId && jsonStable(left.staleCheck.sourceRef) === jsonStable(right.staleCheck.sourceRef) && jsonStable(left.sourceRef) === jsonStable(right.sourceRef) && jsonStable(left.table) === jsonStable(right.table) && jsonStable(left.editableOwner) === jsonStable(right.editableOwner);
+  return left.kind === right.kind && left.storyKey === right.storyKey && left.blockPath === right.blockPath && left.leafPath === right.leafPath && left.commandFamily === right.commandFamily && left.editability === right.editability && sameTextTargetStaleCheck(left, right) && left.staleCheck.inlineCount === right.staleCheck.inlineCount && left.staleCheck.targetHash === right.staleCheck.targetHash && left.staleCheck.targetTextLength === right.staleCheck.targetTextLength && left.staleCheck.childCount === right.staleCheck.childCount && left.staleCheck.blockType === right.staleCheck.blockType && left.staleCheck.wordParaId === right.staleCheck.wordParaId && left.staleCheck.wordTextId === right.staleCheck.wordTextId && jsonStable(left.staleCheck.sourceRef) === jsonStable(right.staleCheck.sourceRef) && jsonStable(left.sourceRef) === jsonStable(right.sourceRef) && jsonStable(left.table) === jsonStable(right.table) && jsonStable(left.editableOwner) === jsonStable(right.editableOwner);
+}
+function sameTextTargetStaleCheck(left, right) {
+  if (left.staleCheck.paragraphTextHash === right.staleCheck.paragraphTextHash && left.staleCheck.paragraphTextLength === right.staleCheck.paragraphTextLength) {
+    return true;
+  }
+  return left.commandFamily === "text-leaf" && left.staleCheck.paragraphTextLength !== void 0 && right.staleCheck.paragraphTextLength !== void 0 && left.staleCheck.paragraphTextLength !== right.staleCheck.paragraphTextLength;
 }
 function locateTargetRange(document2, surface, target) {
   if (target.kind === "hyperlink-text") {
@@ -52199,7 +52584,7 @@ function resolveEditableTableStructureTarget(input) {
       `Editable target is not editable${input.target.posture.blockers.length > 0 ? `: ${input.target.posture.blockers.join(", ")}` : "."}`
     );
   }
-  const current = collectEditableTargetRefs(input.document).find(
+  const current = collectEditableTargetRefs(input.document, input.editableTargetCache).find(
     (candidate) => candidate.targetKey === input.target?.targetKey
   );
   if (!current) {
@@ -52319,6 +52704,26 @@ function sortJson(value) {
 }
 
 // src/runtime/document-runtime.ts
+var CANONICAL_BLOCK_REFS_SYMBOL2 = /* @__PURE__ */ Symbol.for("wre.canonical-block-refs");
+function getLocalTextPatchMetadata(mapping) {
+  const metadata = mapping.metadata?.localTextPatch;
+  if (!metadata || typeof metadata !== "object") {
+    return null;
+  }
+  const insertedText = metadata.insertedText;
+  return typeof insertedText === "string" ? { insertedText } : null;
+}
+function getSurfaceCanonicalBlockRefs(snapshot) {
+  return snapshot[CANONICAL_BLOCK_REFS_SYMBOL2];
+}
+function attachSurfaceCanonicalBlockRefs(snapshot, refs) {
+  Object.defineProperty(snapshot, CANONICAL_BLOCK_REFS_SYMBOL2, {
+    value: refs,
+    enumerable: false,
+    configurable: true,
+    writable: false
+  });
+}
 function normalizeViewportRanges(ranges) {
   const cleaned = ranges.filter((r) => Number.isFinite(r.start) && Number.isFinite(r.end) && r.end > r.start).map((r) => ({ start: r.start, end: r.end }));
   if (cleaned.length === 0) return Object.freeze([]);
@@ -52682,6 +53087,22 @@ function createDocumentRuntime(options) {
     cachedEditableTargetMap = { document: document2, map: byBlockPath };
     return byBlockPath;
   }
+  function getEditableTargetsByBlockPathForRanges(document2, storyKey2, ranges) {
+    if (ranges === null) return getEditableTargetsByBlockPath(document2);
+    perfCounters.increment("runtime.editableTargets.boundedBuilds");
+    const targets = collectEditableTargetRefsForStoryBlockRanges(
+      document2,
+      storyKey2,
+      ranges,
+      editableTargetBlockCache
+    );
+    if (targets.length === 0) return /* @__PURE__ */ new Map();
+    const byBlockPath = /* @__PURE__ */ new Map();
+    for (const target of targets) {
+      byBlockPath.set(target.blockPath, target);
+    }
+    return byBlockPath;
+  }
   function invalidateEditableTargetMap() {
     cachedEditableTargetMap = null;
   }
@@ -52732,7 +53153,7 @@ function createDocumentRuntime(options) {
     }
     const snapshot = createEditorSurfaceSnapshot(document2, state.selection, nextActiveStory, {
       viewportBlockRanges: surfaceViewportRanges,
-      editableTargetsByBlockPath: getEditableTargetsByBlockPath(document2),
+      editableTargetsByBlockPath: options2.editableTargetsByBlockPathOverride ?? getEditableTargetsByBlockPath(document2),
       ...effectiveMarkupModeProvider ? { getEffectiveMarkupMode: effectiveMarkupModeProvider } : {}
     });
     recordPerfSample("snapshot.surface");
@@ -52795,6 +53216,180 @@ function createDocumentRuntime(options) {
     }
     return -1;
   }
+  function cachePatchedLocalTextSurface(surface) {
+    const activeStoryKey = storyTargetKey(activeStory);
+    const rangesKey = serializeViewportRanges(surface.viewportBlockRanges);
+    cachedSurface = {
+      content: state.document.content,
+      subParts: state.document.subParts,
+      styles: state.document.styles,
+      numbering: state.document.numbering,
+      media: state.document.media,
+      preservation: state.document.preservation,
+      review: state.document.review,
+      effectiveMarkupModeProvider,
+      activeStoryKey,
+      viewportRangesKey: rangesKey,
+      snapshot: surface
+    };
+    if (surface.viewportBlockRanges === null) {
+      cachedFullSurface = {
+        content: state.document.content,
+        subParts: state.document.subParts,
+        styles: state.document.styles,
+        numbering: state.document.numbering,
+        media: state.document.media,
+        preservation: state.document.preservation,
+        review: state.document.review,
+        effectiveMarkupModeProvider,
+        activeStoryKey,
+        snapshot: surface
+      };
+    }
+    cachedSurfaceFingerprint = `${activeStoryKey}|${rangesKey}|${String(state.selection.anchor)}:${String(state.selection.head)}`;
+  }
+  function tryPatchLocalTextSurface(previousSurface, mapping) {
+    const tTotal0 = performance.now();
+    try {
+      if (!previousSurface || activeStory.kind !== "main") {
+        perfCounters.increment("surface.localText.patchMiss");
+        return null;
+      }
+      const patch = getLocalTextPatchMetadata(mapping);
+      if (!patch || mapping.steps.length !== 1) {
+        perfCounters.increment("surface.localText.patchMiss");
+        return null;
+      }
+      const step = mapping.steps[0];
+      if (patch.insertedText.length !== step.insertSize) {
+        perfCounters.increment("surface.localText.patchMiss");
+        return null;
+      }
+      const editFrom = step.from;
+      const editTo = step.to;
+      if (editTo < editFrom || editFrom < 0) {
+        perfCounters.increment("surface.localText.patchMiss");
+        return null;
+      }
+      const blockIndex = previousSurface.blocks.findIndex(
+        (block2) => block2.kind === "paragraph" && editFrom >= block2.from && editTo <= block2.to
+      );
+      if (blockIndex < 0) {
+        perfCounters.increment("surface.localText.patchMiss");
+        return null;
+      }
+      const block = previousSurface.blocks[blockIndex];
+      if (block.kind !== "paragraph") {
+        perfCounters.increment("surface.localText.patchMiss");
+        return null;
+      }
+      const segmentIndex = block.segments.findIndex(
+        (segment2) => segment2.kind === "text" && editFrom >= segment2.from && editTo <= segment2.to
+      );
+      if (segmentIndex < 0) {
+        perfCounters.increment("surface.localText.patchMiss");
+        return null;
+      }
+      const segment = block.segments[segmentIndex];
+      if (segment.kind !== "text") {
+        perfCounters.increment("surface.localText.patchMiss");
+        return null;
+      }
+      if (segment.text.length !== segment.to - segment.from) {
+        perfCounters.increment("surface.localText.patchMiss");
+        return null;
+      }
+      const localFrom = editFrom - segment.from;
+      const localTo = editTo - segment.from;
+      const delta = patch.insertedText.length - (editTo - editFrom);
+      const nextText = segment.text.slice(0, localFrom) + patch.insertedText + segment.text.slice(localTo);
+      const nextSegments = block.segments.map((candidate, index) => {
+        if (index < segmentIndex) return candidate;
+        if (index === segmentIndex) {
+          return {
+            ...segment,
+            text: nextText,
+            to: segment.to + delta
+          };
+        }
+        return shiftSurfaceInlineSegment(candidate, delta);
+      });
+      const nextBlock = {
+        ...block,
+        to: block.to + delta,
+        segments: nextSegments
+      };
+      const nextBlocks = previousSurface.blocks.map((candidate, index) => {
+        if (index < blockIndex) return candidate;
+        if (index === blockIndex) return nextBlock;
+        return shiftSurfaceBlock(candidate, delta);
+      });
+      const nextPlainText = previousSurface.plainText.slice(0, editFrom) + patch.insertedText + previousSurface.plainText.slice(editTo);
+      const nextSurface = {
+        ...previousSurface,
+        storySize: previousSurface.storySize + delta,
+        plainText: nextPlainText,
+        blocks: nextBlocks
+      };
+      const refs = getSurfaceCanonicalBlockRefs(previousSurface);
+      if (refs) {
+        const nextRefs = [...refs];
+        nextRefs[blockIndex] = state.document.content.children[blockIndex] ?? null;
+        attachSurfaceCanonicalBlockRefs(nextSurface, nextRefs);
+      }
+      perfCounters.increment("surface.localText.patchHit");
+      perfCounters.increment("surface.localText.patchDelta", delta);
+      return nextSurface;
+    } finally {
+      perfCounters.increment("surface.localText.total.us", Math.round((performance.now() - tTotal0) * 1e3));
+    }
+  }
+  function shiftSurfaceInlineSegment(segment, delta) {
+    if (delta === 0) return segment;
+    return {
+      ...segment,
+      from: segment.from + delta,
+      to: segment.to + delta
+    };
+  }
+  function shiftSurfaceBlock(block, delta) {
+    if (delta === 0) return block;
+    switch (block.kind) {
+      case "paragraph":
+        return {
+          ...block,
+          from: block.from + delta,
+          to: block.to + delta,
+          segments: block.segments.map((segment) => shiftSurfaceInlineSegment(segment, delta))
+        };
+      case "table":
+        return {
+          ...block,
+          from: block.from + delta,
+          to: block.to + delta,
+          rows: block.rows.map((row2) => ({
+            ...row2,
+            cells: row2.cells.map((cell) => ({
+              ...cell,
+              content: cell.content.map((child) => shiftSurfaceBlock(child, delta))
+            }))
+          }))
+        };
+      case "sdt_block":
+        return {
+          ...block,
+          from: block.from + delta,
+          to: block.to + delta,
+          children: block.children.map((child) => shiftSurfaceBlock(child, delta))
+        };
+      case "opaque_block":
+        return {
+          ...block,
+          from: block.from + delta,
+          to: block.to + delta
+        };
+    }
+  }
   function enrichCulledPlaceholdersWithHeights(snapshot) {
     let heights;
     try {
@@ -53680,7 +54275,8 @@ function createDocumentRuntime(options) {
       document: document2,
       target: command.editableTarget,
       activeStoryKey: canonicalEditableTargetStoryKey(storyTarget),
-      selectionDescriptor: command.selectionDescriptor
+      selectionDescriptor: command.selectionDescriptor,
+      editableTargetCache: editableTargetBlockCache
     });
     if (resolution.kind === "rejected") {
       emit({
@@ -53743,7 +54339,8 @@ function createDocumentRuntime(options) {
       document: document2,
       surface,
       target,
-      activeStoryKey: canonicalEditableTargetStoryKey(storyTarget)
+      activeStoryKey: canonicalEditableTargetStoryKey(storyTarget),
+      editableTargetCache: editableTargetBlockCache
     });
     if (resolution.kind === "rejected") {
       emit({
@@ -53773,7 +54370,8 @@ function createDocumentRuntime(options) {
       document: document2,
       surface,
       target: command.editableTarget,
-      activeStoryKey: canonicalEditableTargetStoryKey(storyTarget)
+      activeStoryKey: canonicalEditableTargetStoryKey(storyTarget),
+      editableTargetCache: editableTargetBlockCache
     });
     if (resolution.kind === "rejected") {
       emit({
@@ -53801,7 +54399,8 @@ function createDocumentRuntime(options) {
       activeStoryKey: canonicalEditableTargetStoryKey(storyTarget),
       commandFamilies: command.type === "field.refresh" || command.type === "toc.refresh" ? ["field"] : ["link-bookmark"],
       targetKinds: targetKindsForModeledCommand(command.type),
-      allowGeneratedPosture: true
+      allowGeneratedPosture: true,
+      editableTargetCache: editableTargetBlockCache
     });
     if (resolution.kind === "rejected") {
       emit({
@@ -53843,7 +54442,8 @@ function createDocumentRuntime(options) {
         baseState.selection.head,
         storyTarget,
         getFullPageGraph(),
-        command.options
+        command.options,
+        command.editableTarget
       );
       if (!refreshed2.changed) return null;
       cachedFieldSnapshotEntry = null;
@@ -53885,6 +54485,9 @@ function createDocumentRuntime(options) {
     );
   }
   const runtime = {
+    getEditableTargetCache() {
+      return editableTargetBlockCache;
+    },
     subscribe(listener) {
       listeners.add(listener);
       return () => {
@@ -56088,6 +56691,12 @@ function createDocumentRuntime(options) {
     }
     return !effects.commentAdded && !effects.commentResolved && !effects.commentReopened && !effects.commentReplyAdded && !effects.commentBodyEdited && !effects.changeAccepted && !effects.changeRejected && !effects.revisionAuthored && !effects.commandBlocked;
   }
+  function canSkipOverlaySyncForLocalText(transaction) {
+    if (transaction.mapping.steps.length !== 1) return false;
+    if (transaction.mapping.metadata?.invalidatesStructures) return false;
+    if (transaction.mapping.metadata?.scopeTagTouches) return false;
+    return getLocalTextPatchMetadata(transaction.mapping) !== null;
+  }
   function applyTransactionToState(transaction, options2 = {}) {
     const effects = transaction.effects;
     const selectionUnchanged = transaction.nextState.selection === state.selection;
@@ -56109,9 +56718,28 @@ function createDocumentRuntime(options) {
     state = finalizeState(transaction.nextState, transaction.markDirty, clock());
     perfCounters.increment("commit.finalizeState.us", Math.round((performance.now() - tFinalize0) * 1e3));
     storySelections.set(storyTargetKey(activeStory), state.selection);
+    const tClassify0 = performance.now();
+    const useLocalTextCommitSnapshot = options2.allowLocalTextFastPath === true && shouldUseLocalTextCommitSnapshot(
+      previous,
+      state,
+      transaction,
+      transaction.effects
+    );
+    perfCounters.increment("commit.refreshClassify.us", Math.round((performance.now() - tClassify0) * 1e3));
     const tOverlay0 = performance.now();
-    overlayStore.replaceOverlay(overlayStore.getOverlay(), state.document);
-    const detachedWorkflowScopeWarnings = syncDetachedWorkflowScopeWarningsInState();
+    const skipOverlaySync = useLocalTextCommitSnapshot && canSkipOverlaySyncForLocalText(transaction);
+    const detachedWorkflowScopeWarnings = skipOverlaySync ? { added: [], cleared: [] } : (() => {
+      const tReplace0 = performance.now();
+      overlayStore.replaceOverlay(overlayStore.getOverlay(), state.document);
+      perfCounters.increment("commit.overlaySync.replaceOverlay.us", Math.round((performance.now() - tReplace0) * 1e3));
+      const tWarnings0 = performance.now();
+      const result = syncDetachedWorkflowScopeWarningsInState();
+      perfCounters.increment("commit.overlaySync.detachedWarnings.us", Math.round((performance.now() - tWarnings0) * 1e3));
+      return result;
+    })();
+    if (skipOverlaySync) {
+      perfCounters.increment("commit.overlaySync.skipped");
+    }
     perfCounters.increment("commit.overlaySync.us", Math.round((performance.now() - tOverlay0) * 1e3));
     const tInvalidate0 = performance.now();
     if (transaction.markDirty && transaction.mapping.steps.length > 0) {
@@ -56145,22 +56773,34 @@ function createDocumentRuntime(options) {
         ...detachedWorkflowScopeWarnings.cleared
       ]
     };
-    const tClassify0 = performance.now();
-    const useLocalTextCommitSnapshot = options2.allowLocalTextFastPath === true && shouldUseLocalTextCommitSnapshot(
-      previous,
-      state,
-      transaction,
-      notifyEffects
-    );
-    perfCounters.increment("commit.refreshClassify.us", Math.round((performance.now() - tClassify0) * 1e3));
     if (!useLocalTextCommitSnapshot && transaction.markDirty && previous.document !== state.document) {
       applyViewportRanges(getSelectionCorridorViewportRanges(cachedRenderSnapshot.surface));
     }
     const tValidation0 = performance.now();
-    const surfaceForValidation = useLocalTextCommitSnapshot ? getCachedSurface(state.document, activeStory, {
-      viewportBlockRangesOverride: getSelectionCorridorViewportRanges(cachedRenderSnapshot.surface),
-      enrichCulledPlaceholders: false
-    }) : getCachedSurface(state.document, activeStory);
+    const patchedLocalTextSurface = useLocalTextCommitSnapshot ? tryPatchLocalTextSurface(cachedRenderSnapshot.surface, transaction.mapping) : null;
+    if (patchedLocalTextSurface) {
+      cachePatchedLocalTextSurface(patchedLocalTextSurface);
+      perfCounters.increment("commit.localTextValidation.storySizeOnly");
+    }
+    const localTextViewportRanges = useLocalTextCommitSnapshot && !patchedLocalTextSurface ? getSelectionCorridorViewportRanges(cachedRenderSnapshot.surface) : void 0;
+    const localTextEditableTargetsByBlockPath = useLocalTextCommitSnapshot && !patchedLocalTextSurface ? getEditableTargetsByBlockPathForRanges(
+      state.document,
+      storyTargetKey(activeStory),
+      localTextViewportRanges ?? null
+    ) : void 0;
+    const surfaceForValidation = patchedLocalTextSurface ? patchedLocalTextSurface : useLocalTextCommitSnapshot ? (() => {
+      const tSurface0 = performance.now();
+      try {
+        perfCounters.increment("surface.localText.fullProjectionFallback");
+        return getCachedSurface(state.document, activeStory, {
+          viewportBlockRangesOverride: localTextViewportRanges,
+          enrichCulledPlaceholders: false,
+          editableTargetsByBlockPathOverride: localTextEditableTargetsByBlockPath
+        });
+      } finally {
+        perfCounters.increment("surface.localText.fullProjection.us", Math.round((performance.now() - tSurface0) * 1e3));
+      }
+    })() : getCachedSurface(state.document, activeStory);
     const validationOptions = state.selection.activeRange.kind === "node" ? {
       isValidNodeTarget: createSurfaceNodeSelectionProbe(surfaceForValidation)
     } : void 0;
@@ -56427,7 +57067,8 @@ function createDocumentRuntime(options) {
       selection,
       surface: cachedRenderSnapshot.surface?.blocks ?? [],
       target: editableTarget,
-      activeStoryKey: canonicalEditableTargetStoryKey(activeStory)
+      activeStoryKey: canonicalEditableTargetStoryKey(activeStory),
+      editableTargetCache: editableTargetBlockCache
     }) : null;
     if (targetResolution?.kind === "rejected") {
       const blockedReason = targetResolution.blockedReason;
@@ -56479,6 +57120,7 @@ function createDocumentRuntime(options) {
       documentMode: textOptions.documentModeOverride ?? workflowCoordinator.getEffectiveDocumentMode(selection),
       defaultAuthorId: defaultAuthorId ?? void 0,
       renderSnapshot: cachedRenderSnapshot,
+      activeStorySize: cachedRenderSnapshot.surface?.storySize,
       textTarget,
       rejectTargetlessTableStructureInsert: true
     };
@@ -57893,15 +58535,12 @@ function flattenInlineDisplayText(children) {
     }
   }).join("");
 }
-function refreshDocumentFields(document2, selectionHead, activeStory, pageGraph, options) {
+function refreshDocumentFields(document2, selectionHead, activeStory, pageGraph, options, target) {
   const supportedOnly = options?.supportedOnly ?? true;
   const bookmarkMap = buildBookmarkNameMap(document2);
   const paragraphs = collectParagraphContexts(document2.content.children);
-  const activePageIndex = resolveActivePageIndexFromPageGraph(
-    pageGraph,
-    selectionHead,
-    activeStory
-  );
+  void selectionHead;
+  void activeStory;
   let updatedCount = 0;
   let changed = false;
   let changedFrom;
@@ -57911,19 +58550,27 @@ function refreshDocumentFields(document2, selectionHead, activeStory, pageGraph,
     let storyChangedFrom;
     let storyChangedTo;
     const refreshed = refreshBlocksWithCursor(blocks, (field, range) => {
+      if (target !== void 0 && !fieldMatchesRefreshTarget(field, target)) {
+        return field;
+      }
       if (!field.fieldFamily || !isSupportedFieldFamily(field.fieldFamily)) {
         return field;
       }
       if (supportedOnly && field.fieldFamily === "TOC") {
         return field;
       }
+      const fieldPageIndex = resolveActivePageIndexFromPageGraph(
+        pageGraph,
+        range.from,
+        storyTarget
+      );
       const display = resolveSupportedFieldDisplay(
         field,
         document2,
         bookmarkMap,
         paragraphs,
         pageGraph,
-        activePageIndex,
+        fieldPageIndex,
         storyTarget
       );
       if (!display) {
@@ -58073,6 +58720,34 @@ function refreshDocumentFields(document2, selectionHead, activeStory, pageGraph,
     ...protectionSelection ? { protectionSelection } : {}
   };
 }
+function fieldMatchesRefreshTarget(field, target) {
+  if (target.kind !== "field-result-text" && target.kind !== "field-region-refresh") {
+    return false;
+  }
+  const targetField = target.field;
+  if (targetField?.canonicalFieldId !== void 0) {
+    return field.canonicalFieldId === targetField.canonicalFieldId;
+  }
+  const resultText = flattenInlineDisplayText(field.children);
+  const fieldResultHash = sha256TextHex(`${field.instruction}\0${resultText}`);
+  if (target.kind === "field-result-text" && target.staleCheck.targetHash !== void 0) {
+    return target.staleCheck.targetHash === fieldResultHash;
+  }
+  if (targetField?.fieldFamily !== void 0 && targetField.fieldFamily !== field.fieldFamily) {
+    return false;
+  }
+  if (targetField?.fieldTarget !== void 0 && targetField.fieldTarget !== field.fieldTarget) {
+    return false;
+  }
+  if (target.staleCheck.sourceRef !== void 0 || target.sourceRef !== void 0) {
+    return sourceRefsEqual(target.staleCheck.sourceRef ?? target.sourceRef, field.sourceRef);
+  }
+  return false;
+}
+function sourceRefsEqual(left, right) {
+  if (left === void 0 || right === void 0) return false;
+  return left.sourceId === right.sourceId && left.partPath === right.partPath && left.storyKind === right.storyKind && left.element === right.element && left.xmlPath === right.xmlPath && left.tableCellPath === right.tableCellPath && left.tableDepth === right.tableDepth && left.ordinal === right.ordinal && left.startOffset === right.startOffset && left.endOffset === right.endOffset;
+}
 function refreshDocumentTableOfContents(document2, selectionHead, activeStory, options, resolveDisplayPageNumber, navigationSnapshot) {
   const selectedRegion = selectTocRegion(document2.fieldRegistry?.tocRegions, options?.tocId);
   const refreshMode = options?.mode ?? "regenerate";