@beyondwork/docx-react-component 1.0.132 → 1.0.134

package/dist/index.js

@@ -4,7 +4,7 @@ import {
   createSearchPlugin,
   performSearch,
   searchPluginKey
-} from "./chunk-CDEZGLQ3.js";
+} from "./chunk-VA24T4EB.js";
 import {
   CODE_METADATA_TABLE,
   KNOWN_DIAGNOSTIC_CODES,
@@ -26,7 +26,7 @@ import {
   splitListParagraph,
   toggleBulletedList,
   toggleNumberedList
-} from "./chunk-43JAPM2F.js";
+} from "./chunk-EBSI6VQX.js";
 import {
   applyParagraphStyleToDocument
 } from "./chunk-6EXNNAO6.js";
@@ -37,7 +37,7 @@ import {
   setSectionPageNumberingAtSectionIndex,
   updateSectionLayoutAtSectionIndex
 } from "./chunk-M6XR534O.js";
-import "./chunk-ZDYGRO2Z.js";
+import "./chunk-RP76USJE.js";
 import {
   createRuntimeCollabSync,
   createRuntimeCommandAppliedBridge
@@ -45,7 +45,7 @@ import {
 import {
   insertPageBreak,
   insertTable
-} from "./chunk-SZ6BJA4Q.js";
+} from "./chunk-REFHJ2FN.js";
 import {
   getFormattingStateFromRenderSnapshot
 } from "./chunk-Y4XZCMCS.js";
@@ -53,13 +53,13 @@ import {
   insertImage,
   repositionFloatingImage,
   resizeImage
-} from "./chunk-UFPBYJMA.js";
-import "./chunk-N5FTU4HZ.js";
+} from "./chunk-INLRCC4N.js";
+import "./chunk-MQ5GAJ54.js";
 import {
   getTableStructureContext,
   tableStructureActionHandleForTarget
-} from "./chunk-6TLZ6CMP.js";
-import "./chunk-C5LXKR54.js";
+} from "./chunk-WDDFU2N2.js";
+import "./chunk-QTRJLKR2.js";
 import {
   MOUNTED_SURFACE_VIEWPORT_BLOCK_THRESHOLD,
   OverlayAnchorBridgeProvider,
@@ -83,14 +83,15 @@ import {
   resolveScopedChromePolicy,
   resolveScrollTopForAnchor,
   resolveSelectionToolRegistry,
+  sanitizeNumberingPictureBulletSrc,
   shouldRenderAbsoluteFloatingImageInPageOverlay,
   shouldRenderSelectionToolKind,
   shouldUseMountedSurfaceViewportCulling,
   useLayoutFacetRenderSignal
-} from "./chunk-QUTVR72L.js";
+} from "./chunk-3YR47WTD.js";
 import {
   createInertGeometryFacet
-} from "./chunk-UP2KDOYE.js";
+} from "./chunk-74R5B2EZ.js";
 import {
   composeSeriesColor,
   computeStructuralHash,
@@ -104,12 +105,12 @@ import {
   resolveColor,
   tryReadLaycacheEnvelope,
   writeEnvelopeToOpcPackage
-} from "./chunk-YUHNDEV5.js";
+} from "./chunk-ESEEWELA.js";
 import {
   findTextMatches,
   parseCanonicalFragmentFromWordML,
   searchDocument
-} from "./chunk-XYTWOJII.js";
+} from "./chunk-IJD6D7HU.js";
 import {
   clearLocalCursorState,
   getCursorColorForUser,
@@ -119,7 +120,7 @@ import {
 import {
   resolveChromePreset,
   resolveChromeVisibilityForPreset
-} from "./chunk-W2I47J2Q.js";
+} from "./chunk-NJFKPDNG.js";
 import {
   CAPABILITY_BY_ID,
   ISSUE_METADATA_ID,
@@ -141,7 +142,7 @@ import {
   sanitizeMarkdown,
   sha256Hex,
   startPerfProbe
-} from "./chunk-LPLJZJT2.js";
+} from "./chunk-O4EDZR44.js";
 import "./chunk-OVLZQ6FZ.js";
 import "./chunk-QIO6V46H.js";
 import {
@@ -149,7 +150,7 @@ import {
   getStoryBlocks,
   replaceStoryBlocks,
   stableChartId
-} from "./chunk-U3UMKA7B.js";
+} from "./chunk-XBQFDBXE.js";
 import "./chunk-SYQWQ6FE.js";
 import {
   createDefaultCanonicalDocument,
@@ -160,14 +161,14 @@ import {
   SessionNotOpenError,
   SessionNotWiredError,
   isReopenBarrier
-} from "./chunk-ALWXYGXP.js";
+} from "./chunk-V2JF42SI.js";
 import {
   createHmacSigner,
   createHmacVerifier,
   loadDocxSessionSync,
   signWorkflowPayloadXml,
   verifyWorkflowPayloadXml
-} from "./chunk-JVTDBX67.js";
+} from "./chunk-EFEW7BTT.js";
 import {
   EDITOR_SESSION_STATE_VERSION,
   assertEditorSessionState,
@@ -176,8 +177,8 @@ import {
   editorSessionStateFromPersistedSnapshot,
   persistedSnapshotFromEditorSessionState,
   validateEditorSessionState
-} from "./chunk-4HGFJ6Z2.js";
-import "./chunk-RBWJHRNP.js";
+} from "./chunk-PZIEOEJZ.js";
+import "./chunk-T66OS7MN.js";
 import {
   decodePersistedSourcePackageBytes,
   hasValidPersistedSourcePackageDigest
@@ -189,7 +190,7 @@ import {
   collectEditableTargetRefs,
   createHeaderFooterStoryKey,
   createNoteStoryKey
-} from "./chunk-RYMMKOFI.js";
+} from "./chunk-5KTJKTNE.js";
 import {
   readOpcPackage
 } from "./chunk-WUDSNHWF.js";
@@ -327,6 +328,9 @@ function applyListAwareTextCommand(context, command, deps) {
       if (!paragraphContext.atParagraphStart || !context.localSnapshot.selection.isCollapsed) {
         return null;
       }
+      if (shouldRouteListBoundaryJoinThroughTextCommand(context, paragraphContext)) {
+        return null;
+      }
       const result = backspaceAtListStart(
         context.localDocument,
         paragraphContext.paragraphIndex,
@@ -367,6 +371,39 @@ function listCommandTargetOptions(context, paragraphContext) {
   }
   return { editableTargets: [paragraphContext.paragraph.editableTarget] };
 }
+function shouldRouteListBoundaryJoinThroughTextCommand(context, paragraphContext) {
+  const currentNumbering = paragraphContext.paragraph.numbering;
+  const currentTarget = paragraphContext.paragraph.editableTarget;
+  if (context.activeStory.kind !== "main" || !currentNumbering || currentNumbering.level > 0 || currentTarget?.listAddress?.operationScope !== "list-text") {
+    return false;
+  }
+  const paragraphs = collectSurfaceParagraphs(context.localSnapshot.surface?.blocks ?? []);
+  const previous = paragraphs[paragraphContext.paragraphIndex - 1];
+  const previousNumbering = previous?.numbering;
+  return Boolean(
+    previousNumbering && previousNumbering.numberingInstanceId === currentNumbering.numberingInstanceId && previousNumbering.level === currentNumbering.level
+  );
+}
+function collectSurfaceParagraphs(blocks, output = []) {
+  for (const block of blocks) {
+    if (block.kind === "paragraph") {
+      output.push(block);
+      continue;
+    }
+    if (block.kind === "table") {
+      for (const row of block.rows) {
+        for (const cell of row.cells) {
+          collectSurfaceParagraphs(cell.content, output);
+        }
+      }
+      continue;
+    }
+    if (block.kind === "sdt_block") {
+      collectSurfaceParagraphs(block.children, output);
+    }
+  }
+  return output;
+}
 function createListMutationResult(result, selection, deps) {
   return {
     changed: result.affectedParagraphIndexes.length > 0,
@@ -403,13 +440,23 @@ function dispatchTextCommand(runtime, command, deps) {
   }
   switch (command.type) {
     case "insert-text":
-      runtime.applyActiveStoryTextCommand({ type: "text.insert", text: command.text });
+      runtime.applyActiveStoryTextCommand({
+        type: "text.insert",
+        text: command.text,
+        ...mountedListTextTarget(context, deps)
+      });
       return;
     case "delete-backward":
-      runtime.applyActiveStoryTextCommand({ type: "text.delete-backward" });
+      runtime.applyActiveStoryTextCommand({
+        type: "text.delete-backward",
+        ...mountedListTextTarget(context, deps)
+      });
       return;
     case "delete-forward":
-      runtime.applyActiveStoryTextCommand({ type: "text.delete-forward" });
+      runtime.applyActiveStoryTextCommand({
+        type: "text.delete-forward",
+        ...mountedListTextTarget(context, deps)
+      });
       return;
     case "insert-tab":
       runtime.applyActiveStoryTextCommand({ type: "text.insert-tab" });
@@ -418,13 +465,30 @@ function dispatchTextCommand(runtime, command, deps) {
       runtime.applyActiveStoryTextCommand({ type: "text.outdent-tab" });
       return;
     case "insert-hard-break":
-      runtime.applyActiveStoryTextCommand({ type: "text.insert-hard-break" });
+      runtime.applyActiveStoryTextCommand({
+        type: "text.insert-hard-break",
+        ...mountedListTextTarget(context, deps)
+      });
       return;
     case "split-paragraph":
-      runtime.applyActiveStoryTextCommand({ type: "paragraph.split" });
+      runtime.applyActiveStoryTextCommand({
+        type: "paragraph.split",
+        ...mountedListTextTarget(context, deps)
+      });
       return;
   }
 }
+function mountedListTextTarget(context, deps) {
+  const selectionTarget = context.localSnapshot.selection.editableTarget;
+  if (selectionTarget?.listAddress?.operationScope === "list-text") {
+    return { editableTarget: selectionTarget };
+  }
+  const paragraphTarget = deps.resolveActiveParagraphContext(context.localSnapshot)?.paragraph.editableTarget;
+  if (paragraphTarget?.listAddress?.operationScope === "list-text") {
+    return { editableTarget: paragraphTarget };
+  }
+  return {};
+}
 function getMountedTextCommandName(command) {
   switch (command.type) {
     case "insert-text":
@@ -5333,7 +5397,7 @@ var editorSchema = new Schema({
         if (typeof numberingMarkerStartTwips === "number") {
           attrs["data-numbering-marker-start-twips"] = String(numberingMarkerStartTwips);
         }
-        const _numberingMarkerWidthTwips = node.attrs.numberingMarkerWidth;
+        const _numberingMarkerWidthTwips = node.attrs.numberingMarkerWidth ?? node.attrs.indentHanging;
         if (typeof _numberingMarkerWidthTwips === "number" && _numberingMarkerWidthTwips > 0) {
           attrs["data-numbering-marker-width-twips"] = String(
             _numberingMarkerWidthTwips
@@ -5349,7 +5413,9 @@ var editorSchema = new Schema({
         const numberingMarkerWidth = node.attrs.numberingMarkerWidth;
         const numberingMarkerStart = node.attrs.numberingMarkerStart;
         const numberingMarkerJustification = node.attrs.numberingMarkerJustification;
-        const numberingPicBulletSrc = node.attrs.numberingPicBulletSrc;
+        const numberingPicBulletSrc = sanitizeNumberingPictureBulletSrc(
+          node.attrs.numberingPicBulletSrc
+        );
         const children = [];
         if (pageBreak) {
           attrs["data-page-break-before"] = "true";
@@ -5405,6 +5471,7 @@ var editorSchema = new Schema({
             {
               class: baseClasses.join(" "),
               contenteditable: "false",
+              "data-numbering-marker": "true",
               "data-numbering-prefix": numberingPicBulletSrc ? "" : numberingPrefix ?? "",
               ...typeof numberingLevel === "number" ? { "data-numbering-level": String(numberingLevel) } : {},
               ...numberingSuffix ? { "data-numbering-suffix": numberingSuffix } : {},
@@ -5776,13 +5843,17 @@ var editorSchema = new Schema({
       },
       toDOM(node) {
         const refreshStatus = node.attrs.refreshStatus;
+        const fieldTarget = node.attrs.fieldTarget;
         const statusClass = refreshStatus === "current" ? "text-blue-700 bg-blue-50 border-blue-200" : refreshStatus === "unresolvable" ? "text-amber-800 bg-amber-50 border-amber-200" : "text-slate-700 bg-slate-50 border-slate-200";
         return [
           "span",
           {
             class: `inline-flex items-center gap-1 mx-0.5 px-1.5 py-0.5 rounded text-xs border ${statusClass}`,
             "data-node-type": "field_ref_atom",
+            "data-generated-field": "true",
             "data-field-family": node.attrs.fieldFamily,
+            ...fieldTarget ? { "data-field-target": fieldTarget } : {},
+            "data-field-refresh-status": refreshStatus,
             title: node.attrs.instruction
           },
           node.attrs.label || "Field"
@@ -6463,8 +6534,39 @@ function buildPositionMap(surface) {
     }
     return lastStoryRestorableEntry(entries)?.pmEnd ?? 1;
   };
+  const runtimeToPmWithBias = (runtimePos, bias) => {
+    if (bias > 0) return runtimeToPm(runtimePos);
+    const firstEditable = entries.find(isStoryRuntimeRestorableEntry);
+    if (runtimePos <= 0) {
+      return firstEditable?.pmStart ?? 1;
+    }
+    if (runtimePos >= runtimeStorySize) {
+      return lastStoryRestorableEntry(entries)?.pmEnd ?? pmDocSize - 1;
+    }
+    let previous = null;
+    for (const entry of entries) {
+      if (!isStoryRuntimeRestorableEntry(entry)) {
+        continue;
+      }
+      if (entry.runtimeStart === entry.runtimeEnd && runtimePos === entry.runtimeStart) {
+        return previous?.pmEnd ?? entry.pmStart;
+      }
+      if (runtimePos > entry.runtimeStart && runtimePos <= entry.runtimeEnd) {
+        return entry.pmStart + (runtimePos - entry.runtimeStart);
+      }
+      if (runtimePos <= entry.runtimeStart) {
+        if (runtimePos === entry.runtimeStart && previous) {
+          return previous.pmEnd;
+        }
+        return nearestRuntimeGapPm(runtimePos, previous, entry);
+      }
+      previous = entry;
+    }
+    return lastStoryRestorableEntry(entries)?.pmEnd ?? 1;
+  };
   return {
     runtimeToPm,
+    runtimeToPmWithBias,
     runtimeToPmWithContext(input) {
       const targetEntry = input.editableTarget ? findRestorableEntryForTarget(entries, input.editableTarget, input.runtimePos) : void 0;
       if (targetEntry) {
@@ -7274,7 +7376,7 @@ function buildParagraph(block, previousParagraph, nextParagraph, mediaPreviews,
       numberingPicBulletSrc: (() => {
         const mediaId = block.resolvedNumbering?.picBulletMediaId;
         if (!mediaId) return null;
-        return mediaPreviews[mediaId]?.src ?? null;
+        return sanitizeNumberingPictureBulletSrc(mediaPreviews[mediaId]?.src);
       })(),
       shadingFill: block.shading?.fill ?? cascade?.shading?.fill ?? null,
       borderTop: block.borders?.top ?? cascadeBorders?.top ?? null,
@@ -7824,9 +7926,9 @@ function resolveDropSelectionFromCoordinates(view, event) {
   if (selection.eq(view.state.selection)) return;
   view.dispatch(view.state.tr.setSelection(selection));
 }
-function applyPasteSegmentsToCallbacks(segments, callbacks) {
+function applyPasteSegmentsToCallbacks(segments, callbacks, context) {
   if (callbacks.onPastePlainTextFragment && callbacks.shouldPastePlainTextAsFragment?.() !== false && segments.some((seg) => seg.kind === "split") && segments.some((seg) => seg.kind === "text" && seg.value.length > 0)) {
-    callbacks.onPastePlainTextFragment(createPlainTextFragmentFromSegments(segments));
+    callbacks.onPastePlainTextFragment(createPlainTextFragmentFromSegments(segments), context);
     return;
   }
   for (const seg of segments) {
@@ -7896,6 +7998,34 @@ function applyContextMenuEvent(callbacks, event) {
     return false;
   }
 }
+function elementFromEventTarget(target) {
+  if (!target) return null;
+  const maybeElement = target;
+  if (typeof maybeElement.closest === "function") return maybeElement;
+  const maybeNode = target;
+  return maybeNode.parentElement ?? null;
+}
+function applyNumberingMarkerClick(view, event) {
+  const targetElement = elementFromEventTarget(event.target);
+  const marker = targetElement?.closest('[data-numbering-marker="true"]');
+  if (!marker) return false;
+  const paragraph = marker.closest('p[data-numbered="true"]');
+  if (!paragraph) return false;
+  const content = paragraph.querySelector(".pm-paragraph-content");
+  if (!content) return false;
+  let contentStart;
+  try {
+    contentStart = view.posAtDOM(content, 0);
+  } catch {
+    return false;
+  }
+  const docSize = view.state.doc.content.size;
+  const boundedStart = Math.max(0, Math.min(contentStart, docSize));
+  const selection = TextSelection2.near(view.state.doc.resolve(boundedStart), 1);
+  event.preventDefault();
+  view.dispatch(view.state.tr.setSelection(selection).scrollIntoView());
+  return true;
+}
 var bridgeKey = new PluginKey("command-bridge");
 function createSelectionSyncPlugin(callbacks) {
   return new Plugin({
@@ -8033,6 +8163,9 @@ function createCommandBridgePlugins(callbacks, options) {
         // behavior (back-compat).
         contextmenu(_view, event) {
           return applyContextMenuEvent(callbacks, event);
+        },
+        click(view, event) {
+          return applyNumberingMarkerClick(view, event);
         }
       },
       handleTextInput(_view, _from, _to, text) {
@@ -8059,10 +8192,12 @@ function createCommandBridgePlugins(callbacks, options) {
       // through to Tier A so the user isn't left with a silent no-op.
       handlePaste(_view, event) {
         if (isComposing) return true;
-        if (!isPmEditTargetEditable(_view.state, callbacks.getPositionMap())) {
+        const positionMap = callbacks.getPositionMap();
+        if (!isPmEditTargetEditable(_view.state, positionMap)) {
           callbacks.onBlockedInput?.("paste", NON_EDITABLE_INPUT_MESSAGE);
           return true;
         }
+        const editableTarget = resolveCurrentEditableTarget(_view.state, positionMap);
         const clipboard = event.clipboardData;
         if (!clipboard) {
           callbacks.onBlockedInput?.("paste", "Clipboard data was not available.");
@@ -8084,7 +8219,11 @@ function createCommandBridgePlugins(callbacks, options) {
           if (wordml) {
             const parsed = options.pasteFragmentParser.parseWordML(wordml);
             if (parsed.ok && parsed.fragment.blocks.length > 0) {
-              callbacks.onPasteFragment({ fragment: parsed.fragment, source: "wordml" });
+              callbacks.onPasteFragment({
+                fragment: parsed.fragment,
+                source: "wordml",
+                ...editableTarget ? { editableTarget } : {}
+              });
               return true;
             }
           }
@@ -8094,7 +8233,11 @@ function createCommandBridgePlugins(callbacks, options) {
           if (htmlPayload && htmlPayload.trim().length > 0) {
             const parsed = options.pasteFragmentParser.parseHtml(htmlPayload);
             if (parsed.ok && parsed.fragment.blocks.length > 0) {
-              callbacks.onPasteFragment({ fragment: parsed.fragment, source: "html" });
+              callbacks.onPasteFragment({
+                fragment: parsed.fragment,
+                source: "html",
+                ...editableTarget ? { editableTarget } : {}
+              });
               return true;
             }
           }
@@ -8108,7 +8251,11 @@ function createCommandBridgePlugins(callbacks, options) {
           return true;
         }
         const segments = extractPlainTextSegments(plain);
-        applyPasteSegmentsToCallbacks(segments, callbacks);
+        applyPasteSegmentsToCallbacks(
+          segments,
+          callbacks,
+          editableTarget ? { editableTarget } : void 0
+        );
         callbacks.onPasteApplied?.({
           segmentCount: segments.length,
           charCount: totalTextCharCount(segments),
@@ -8169,7 +8316,11 @@ function createCommandBridgePlugins(callbacks, options) {
           return true;
         }
         const segments = extractPlainTextSegments(plain);
-        applyPasteSegmentsToCallbacks(segments, callbacks);
+        applyPasteSegmentsToCallbacks(
+          segments,
+          callbacks,
+          editableTarget ? { editableTarget } : void 0
+        );
         callbacks.onPasteApplied?.({
           segmentCount: segments.length,
           charCount: totalTextCharCount(segments),
@@ -8476,9 +8627,10 @@ function buildAnchorPmRange(anchor, positionMap) {
     return null;
   }
   if (anchor.kind === "range") {
+    const mapBoundary = (runtimePos, bias) => positionMap.runtimeToPmWithBias ? positionMap.runtimeToPmWithBias(runtimePos, bias) : positionMap.runtimeToPm(runtimePos);
     return {
-      from: positionMap.runtimeToPm(anchor.from),
-      to: positionMap.runtimeToPm(anchor.to),
+      from: mapBoundary(anchor.from, anchor.assoc?.start ?? 1),
+      to: mapBoundary(anchor.to, anchor.assoc?.end ?? -1),
       allowInline: true
     };
   }
@@ -9721,13 +9873,10 @@ function createSurfaceDecorationKey(input) {
 
 // src/ui-tailwind/editor-surface/pm-page-body-patch.ts
 function resolvePmPageBodyPatchPlan(input) {
-  if (input.patchPlan.addedPages.length > 0 || input.patchPlan.removedPages.length > 0) {
-    return {
-      status: "fallback",
-      reason: "page-membership-change",
-      pageIds: [...input.patchPlan.addedPages, ...input.patchPlan.removedPages]
-    };
-  }
+  const membershipChangedPageIds = [
+    ...input.patchPlan.addedPages,
+    ...input.patchPlan.removedPages
+  ];
   if (input.currentDoc.childCount !== input.previousSurface.blocks.length || input.nextDoc.childCount !== input.nextSurface.blocks.length) {
     return {
       status: "fallback",
@@ -9780,17 +9929,53 @@ function resolvePmPageBodyPatchPlan(input) {
         pageIds: [pageId]
       };
     }
+    if (nestedSpan.status === "nested") {
+      rawSpans.push(nestedSpan.span);
+      continue;
+    }
+    const topLevelSpans = resolveTopLevelFragmentPatchSpans({
+      pageId,
+      changedFragmentIds: entry.fragmentChanges,
+      previousSurface: input.previousSurface,
+      nextSurface: input.nextSurface,
+      previousRange,
+      nextRange
+    });
     rawSpans.push(
-      nestedSpan.status === "nested" ? nestedSpan.span : {
-        pageIds: [pageId],
-        fromBlockIndex: previousRange.first,
-        toBlockIndex: previousRange.last + 1,
-        nextFromBlockIndex: nextRange.first,
-        nextToBlockIndex: nextRange.last + 1
-      }
+      ...topLevelSpans ?? [
+        {
+          pageIds: [pageId],
+          fromBlockIndex: previousRange.first,
+          toBlockIndex: previousRange.last + 1,
+          nextFromBlockIndex: nextRange.first,
+          nextToBlockIndex: nextRange.last + 1
+        }
+      ]
     );
   }
+  if (membershipChangedPageIds.length > 0 && !input.currentDoc.eq(input.nextDoc)) {
+    const membershipSpan = resolveTopLevelMembershipPatchSpan({
+      pageIds: membershipChangedPageIds,
+      previousSurface: input.previousSurface,
+      nextSurface: input.nextSurface
+    });
+    if (!membershipSpan) {
+      return {
+        status: "fallback",
+        reason: "page-membership-change",
+        pageIds: membershipChangedPageIds
+      };
+    }
+    rawSpans.push(membershipSpan);
+  }
   if (rawSpans.length === 0) {
+    if (membershipChangedPageIds.length > 0 && !input.currentDoc.eq(input.nextDoc)) {
+      return {
+        status: "fallback",
+        reason: "page-membership-change",
+        pageIds: membershipChangedPageIds
+      };
+    }
     return {
       status: "fallback",
       reason: "no-body-fragment-changes",
@@ -9859,17 +10044,17 @@ function resolveNestedPatchSpan(input) {
     (id) => findNestedBlockSpanById(input.nextSurface.blocks, input.nextDoc, id)
   );
   if (previousLocated.some((span) => !span) || nextLocated.some((span) => !span)) {
-    return { status: "fallback", reason: "nested-span-unavailable" };
+    return { status: "top-level" };
   }
-  if (previousLocated.some((span) => span?.insideVerticalMergeContinuation) || nextLocated.some((span) => span?.insideVerticalMergeContinuation)) {
-    return { status: "fallback", reason: "split-row-continuation" };
+  if (previousLocated.some(isUnpatchableVerticalMergeContinuationSpan) || nextLocated.some(isUnpatchableVerticalMergeContinuationSpan)) {
+    return { status: "top-level" };
   }
   const previousSpans = previousLocated;
   const nextSpans = nextLocated;
   const previousKinds = new Set(previousSpans.map((span) => span.block.kind));
   const nextKinds = new Set(nextSpans.map((span) => span.block.kind));
   if (previousKinds.size !== nextKinds.size || [...previousKinds].some((kind) => !nextKinds.has(kind))) {
-    return { status: "fallback", reason: "nested-span-unavailable" };
+    return { status: "top-level" };
   }
   return {
     status: "nested",
@@ -9887,6 +10072,104 @@ function resolveNestedPatchSpan(input) {
     }
   };
 }
+function isUnpatchableVerticalMergeContinuationSpan(span) {
+  return Boolean(
+    span?.insideVerticalMergeContinuation && span.fromPm >= span.toPm
+  );
+}
+function resolveTopLevelMembershipPatchSpan(input) {
+  const previousBlocks = input.previousSurface.blocks;
+  const nextBlocks = input.nextSurface.blocks;
+  let prefix = 0;
+  while (prefix < previousBlocks.length && prefix < nextBlocks.length && sameTopLevelBlockIdentity(previousBlocks[prefix], nextBlocks[prefix])) {
+    prefix += 1;
+  }
+  let suffix = 0;
+  while (suffix < previousBlocks.length - prefix && suffix < nextBlocks.length - prefix && sameTopLevelBlockIdentity(
+    previousBlocks[previousBlocks.length - 1 - suffix],
+    nextBlocks[nextBlocks.length - 1 - suffix]
+  )) {
+    suffix += 1;
+  }
+  let fromBlockIndex = prefix;
+  let toBlockIndex = previousBlocks.length - suffix;
+  let nextFromBlockIndex = prefix;
+  let nextToBlockIndex = nextBlocks.length - suffix;
+  if (fromBlockIndex === toBlockIndex && nextFromBlockIndex === nextToBlockIndex) {
+    if (previousBlocks.length === 0 && nextBlocks.length === 0) return null;
+    fromBlockIndex = 0;
+    toBlockIndex = previousBlocks.length;
+    nextFromBlockIndex = 0;
+    nextToBlockIndex = nextBlocks.length;
+  }
+  return {
+    pageIds: [...input.pageIds],
+    fromBlockIndex,
+    toBlockIndex,
+    nextFromBlockIndex,
+    nextToBlockIndex,
+    replacedBlockCount: Math.max(
+      toBlockIndex - fromBlockIndex,
+      nextToBlockIndex - nextFromBlockIndex
+    )
+  };
+}
+function sameTopLevelBlockIdentity(left, right) {
+  return Boolean(left && right && left.blockId === right.blockId && left.kind === right.kind);
+}
+function resolveTopLevelFragmentPatchSpans(input) {
+  const changedIds = uniqueStableFragmentIds(input.changedFragmentIds);
+  if (changedIds.length !== input.changedFragmentIds.length || changedIds.length === 0) {
+    return null;
+  }
+  const spans = [];
+  for (const blockId of changedIds) {
+    const previousIndex = findTopLevelBlockIndexById(
+      input.previousSurface.blocks,
+      input.previousRange,
+      blockId
+    );
+    const nextIndex = findTopLevelBlockIndexById(
+      input.nextSurface.blocks,
+      input.nextRange,
+      blockId
+    );
+    if (previousIndex === null || nextIndex === null) {
+      return null;
+    }
+    const previousBlock = input.previousSurface.blocks[previousIndex];
+    const nextBlock = input.nextSurface.blocks[nextIndex];
+    if (!previousBlock || !nextBlock || previousBlock.kind !== nextBlock.kind) {
+      return null;
+    }
+    spans.push({
+      pageIds: [input.pageId],
+      fromBlockIndex: previousIndex,
+      toBlockIndex: previousIndex + 1,
+      nextFromBlockIndex: nextIndex,
+      nextToBlockIndex: nextIndex + 1,
+      replacedBlockCount: 1
+    });
+  }
+  return spans;
+}
+function uniqueStableFragmentIds(ids) {
+  const result = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const id of ids) {
+    if (id === "<added>" || id === "<removed>") continue;
+    if (seen.has(id)) continue;
+    seen.add(id);
+    result.push(id);
+  }
+  return result;
+}
+function findTopLevelBlockIndexById(blocks, range, blockId) {
+  for (let index = range.first; index <= range.last; index += 1) {
+    if (blocks[index]?.blockId === blockId) return index;
+  }
+  return null;
+}
 function findNestedBlockSpanById(blocks, doc, blockId) {
   return findBlockSpanByIdInContainer({
     blocks,
@@ -9901,6 +10184,7 @@ function findBlockSpanByIdInContainer(input) {
   let cursor = input.contentStartPm;
   for (let blockIndex = 0; blockIndex < input.blocks.length; blockIndex += 1) {
     const block = input.blocks[blockIndex];
+    if (blockIndex >= input.containerNode.childCount) return null;
     const childNode = input.containerNode.child(blockIndex);
     const fromPm = cursor;
     const toPm = fromPm + childNode.nodeSize;
@@ -9940,10 +10224,12 @@ function findBlockSpanByIdInTable(input) {
   let rowCursor = input.tableStartPm + 1;
   for (let rowIndex = 0; rowIndex < input.table.rows.length; rowIndex += 1) {
     const row = input.table.rows[rowIndex];
+    if (rowIndex >= input.tableNode.childCount) return null;
     const rowNode = input.tableNode.child(rowIndex);
     let cellCursor = rowCursor + 1;
     for (let cellIndex = 0; cellIndex < row.cells.length; cellIndex += 1) {
       const cell = row.cells[cellIndex];
+      if (cellIndex >= rowNode.childCount) return null;
       const cellNode = rowNode.child(cellIndex);
       const found = findBlockSpanByIdInContainer({
         blocks: cell.content,
@@ -13518,8 +13804,17 @@ function pageIdsFromRenderFrame(frame) {
   return frame.pages.map((page) => page.page.pageId);
 }
 function resolvePageBodyPatchForMountedState(input) {
-  if (!input.previousSurface || !input.previousFrame || !input.nextFrame || input.previousPlugins !== input.plugins) {
-    return { status: "fallback" };
+  if (!input.previousSurface) {
+    return { status: "fallback", reason: "previous-surface-missing" };
+  }
+  if (!input.previousFrame) {
+    return { status: "fallback", reason: "previous-frame-missing" };
+  }
+  if (!input.nextFrame) {
+    return { status: "fallback", reason: "next-frame-missing" };
+  }
+  if (input.previousPlugins !== input.plugins) {
+    return { status: "fallback", reason: "plugin-set-changed" };
   }
   const patchPlan = createPagePatchPlan(input.previousFrame, input.nextFrame, void 0, {
     mountedPageIds: pageIdsFromRenderFrame(input.previousFrame),
@@ -13720,8 +14015,12 @@ var TwProseMirrorSurface = forwardRef(function TwProseMirrorSurface2(props, ref)
     onPasteFragment: (meta) => {
       props.onPasteFragment?.(meta);
     },
-    onPastePlainTextFragment: (fragment) => {
-      props.onPasteFragment?.({ fragment, source: "plain-text" });
+    onPastePlainTextFragment: (fragment, context) => {
+      props.onPasteFragment?.({
+        fragment,
+        source: "plain-text",
+        ...context?.editableTarget ? { editableTarget: context.editableTarget } : {}
+      });
     },
     shouldPastePlainTextAsFragment: () => snapshotRef.current.documentMode !== "suggesting",
     onPasteImage: (meta) => {
@@ -13863,7 +14162,7 @@ var TwProseMirrorSurface = forwardRef(function TwProseMirrorSurface2(props, ref)
       onBlockedInput: (command, message) => callbacksRef.current?.onBlockedInput?.(command, message),
       onPasteApplied: (meta) => callbacksRef.current?.onPasteApplied?.(meta),
       onPasteFragment: (meta) => callbacksRef.current?.onPasteFragment?.(meta),
-      onPastePlainTextFragment: (fragment) => callbacksRef.current?.onPastePlainTextFragment?.(fragment),
+      onPastePlainTextFragment: (fragment, context) => callbacksRef.current?.onPastePlainTextFragment?.(fragment, context),
       shouldPastePlainTextAsFragment: () => callbacksRef.current?.shouldPastePlainTextAsFragment?.() ?? true,
       onPasteImage: (meta) => callbacksRef.current?.onPasteImage?.(meta),
       onDropFragment: (meta) => callbacksRef.current?.onDropFragment?.(meta),
@@ -14065,6 +14364,7 @@ var TwProseMirrorSurface = forwardRef(function TwProseMirrorSurface2(props, ref)
   useEffect4(() => {
     if (!mountRef.current || !surface) return;
     if (viewRef.current && documentBuildKeyRef.current === documentBuildKey) {
+      incrementInvalidationCounter("pm.rebuild.skip.documentBuildKey");
       pendingRebuildScrollAnchorRef.current = null;
       return;
     }
@@ -14073,6 +14373,7 @@ var TwProseMirrorSurface = forwardRef(function TwProseMirrorSurface2(props, ref)
       positionMapRef.current = buildPositionMap(surface);
       documentBuildKeyRef.current = documentBuildKey;
       applyDecorationProps(viewRef.current, positionMapRef.current);
+      incrementInvalidationCounter("pm.rebuild.skip.equivalentAck");
       equivalentAckLedgerRef.current.delete(snapshot.revisionToken);
       localEquivalentOpsRef.current = [];
       pendingRebuildScrollAnchorRef.current = null;
@@ -15639,6 +15940,15 @@ function deriveShellPinnedSurfaces(chromePreset, chromeOptions) {
 import { Fragment as Fragment4, jsx as jsx16, jsxs as jsxs14 } from "react/jsx-runtime";
 var EMU_PER_CSS_PX = 9525;
 var nextObjectDragSessionId = 0;
+function preferListTextEditableTarget(primary, fallback) {
+  if (primary?.listAddress?.operationScope === "list-text") {
+    return primary;
+  }
+  if (fallback?.listAddress?.operationScope === "list-text") {
+    return fallback;
+  }
+  return primary ?? fallback;
+}
 function createMountedObjectDragSession(runtime, input) {
   nextObjectDragSessionId += 1;
   const sessionId = `object-drag-${nextObjectDragSessionId}`;
@@ -17911,7 +18221,10 @@ var WordReviewEditor = forwardRef3(
       // auto-bracketing in insertFragment + our explicit startAction around
       // the delete, so the undo history sees a single atomic action.
       onDropFragment: (meta) => {
-        const dropEditableTarget = meta.editableTarget ?? activeRuntime.getRenderSnapshot().selection.editableTarget;
+        const dropEditableTarget = preferListTextEditableTarget(
+          meta.editableTarget,
+          activeRuntime.getRenderSnapshot().selection.editableTarget
+        );
         if (meta.effect === "move" && meta.sourceRange) {
           activeRuntime.startAction("drag-move");
           try {
@@ -17922,7 +18235,10 @@ var WordReviewEditor = forwardRef3(
               assoc: { start: -1, end: 1 }
             });
             const currentEditableTarget = activeRuntime.getRenderSnapshot().selection.editableTarget;
-            const editableTarget = currentEditableTarget?.targetKey === dropEditableTarget?.targetKey ? currentEditableTarget : dropEditableTarget;
+            const editableTarget = preferListTextEditableTarget(
+              currentEditableTarget?.targetKey === dropEditableTarget?.targetKey ? currentEditableTarget : void 0,
+              dropEditableTarget
+            );
             activeRuntime.insertFragment(
               meta.fragment,
               void 0,
@@ -17961,7 +18277,10 @@ var WordReviewEditor = forwardRef3(
       // insertFragment auto-bracket (R.5.a Phase 2) makes the paste a
       // single-undo action.
       onPasteFragment: (meta) => {
-        const editableTarget = activeRuntime.getRenderSnapshot().selection.editableTarget;
+        const editableTarget = preferListTextEditableTarget(
+          meta.editableTarget,
+          activeRuntime.getRenderSnapshot().selection.editableTarget
+        );
         activeRuntime.insertFragment(
           meta.fragment,
           void 0,
@@ -18314,6 +18633,12 @@ var WordReviewEditor = forwardRef3(
         onDeleteTable: commands.onDeleteTable,
         onMergeCells: commands.onMergeCells,
         onSplitCell: commands.onSplitCell,
+        onUpdateFields: () => {
+          activeRuntime.updateFields();
+        },
+        onUpdateTableOfContents: () => {
+          activeRuntime.updateTableOfContents();
+        },
         onAskAgentForSelection: () => {
           const { selection } = snapshot;
           onEventRef.current?.({