@beyondwork/docx-react-component 1.0.132 → 1.0.133

package/dist/{chunk-RBWJHRNP.js → chunk-T66OS7MN.js}

@@ -6,7 +6,7 @@ import {
   createHeaderFooterStoryKey,
   createNoteStoryKey,
   sha256TextHex
-} from "./chunk-RYMMKOFI.js";
+} from "./chunk-5KTJKTNE.js";
 import {
   SCOPE_MARKER_BOOKMARK_PREFIX,
   buildGrabBagSourceChildFromParsed,
@@ -1147,7 +1147,7 @@ function readNumPicBullet(node, numPicBulletId, context, xmlPath) {
         const rEmbed = blip?.attributes["r:embed"] ?? blip?.attributes.embed;
         if (rEmbed) {
           const rel = context.relationships.find((r) => r.id === rEmbed);
-          if (rel) {
+          if (isEmbeddedImageRelationship(rel)) {
             const packagePartName = normalizePartPath(
               resolveRelationshipTarget(context.partPath ?? "/word/numbering.xml", rel)
             );
@@ -1165,7 +1165,7 @@ function readNumPicBullet(node, numPicBulletId, context, xmlPath) {
       const rId = imagedata?.attributes["r:id"] ?? imagedata?.attributes.id;
       if (rId && context?.relationships && context.relationships.length > 0) {
         const rel = context.relationships.find((r) => r.id === rId);
-        if (rel) {
+        if (isEmbeddedImageRelationship(rel)) {
           const packagePartName = normalizePartPath(
             resolveRelationshipTarget(context.partPath ?? "/word/numbering.xml", rel)
           );
@@ -1190,6 +1190,11 @@ function readNumPicBullet(node, numPicBulletId, context, xmlPath) {
     ...mediaId !== void 0 ? { mediaId } : {}
   };
 }
+function isEmbeddedImageRelationship(relationship) {
+  return Boolean(
+    relationship && relationship.targetMode === "internal" && relationship.type.endsWith("/image")
+  );
+}
 function toCanonicalAbstractNumberingId(value) {
   return value.startsWith("abstract-num:") ? value : `abstract-num:${value}`;
 }

package/dist/{chunk-ALWXYGXP.js → chunk-V2JF42SI.js}

@@ -1,10 +1,10 @@
 import {
   loadDocxSessionAsync
-} from "./chunk-JVTDBX67.js";
+} from "./chunk-EFEW7BTT.js";
 import {
   buildCompatibilityReport,
   createLoadScheduler
-} from "./chunk-4HGFJ6Z2.js";
+} from "./chunk-PZIEOEJZ.js";
 import {
   decodePersistedSourcePackageBytes,
   hasValidPersistedSourcePackageDigest,

package/dist/{chunk-6TLZ6CMP.js → chunk-WDDFU2N2.js}

@@ -3,12 +3,12 @@ import {
   createNoopStructuralMutation,
   findTableCellParagraphSelection,
   findTopLevelParagraphSelectionNearBlock
-} from "./chunk-C5LXKR54.js";
+} from "./chunk-QTRJLKR2.js";
 import {
   collectEditableTargetRefs,
   collectStoryBlockContexts,
   createHeaderFooterStoryKey
-} from "./chunk-RYMMKOFI.js";
+} from "./chunk-5KTJKTNE.js";
 import {
   createDetachedAnchor,
   createNodeAnchor,

package/dist/{chunk-U3UMKA7B.js → chunk-XBQFDBXE.js}

@@ -4,7 +4,7 @@ import {
   MAIN_STORY_KEY,
   collectCanonicalFieldRegionIdentities,
   collectEditableTargetRefs
-} from "./chunk-RYMMKOFI.js";
+} from "./chunk-5KTJKTNE.js";
 import {
   describeOpaqueFragment,
   describeStructuredWrapperBlock,

package/dist/{chunk-CDEZGLQ3.js → chunk-ZFCZ7XXH.js}

@@ -1,6 +1,6 @@
 import {
   buildSearchPattern
-} from "./chunk-LPLJZJT2.js";
+} from "./chunk-CVSD3UNK.js";
 
 // src/ui-tailwind/editor-surface/search-plugin.ts
 import { Plugin, PluginKey } from "prosemirror-state";

package/dist/core/commands/formatting-commands.d.cts

@@ -1,6 +1,6 @@
 import 'prosemirror-state';
 import 'prosemirror-model';
-export { g4 as Alignment, g5 as FormattingMutationResult, g6 as FormattingOperation, g7 as TextMarkClearTarget, g8 as TextMarkRangeOperation, g9 as applyFormattingOperationToDocument, ga as applyIndentation, gb as applyTextMarkOperationToDocumentRange, gc as getFormattingStateFromRenderSnapshot, gd as isMarkActive, ge as makeSetAlignment, gf as makeSetFontFamily, gg as makeSetFontSize, gh as makeSetHighlight, gi as makeSetTextColor, gj as makeToggleAllCaps, gk as makeToggleBold, gl as makeToggleItalic, gm as makeToggleSmallCaps, gn as makeToggleStrikethrough, go as makeToggleSubscript, gp as makeToggleSuperscript, gq as makeToggleUnderline } from '../../public-types-KBS6JnOs.cjs';
+export { gc as Alignment, gd as FormattingMutationResult, ge as FormattingOperation, gf as TextMarkClearTarget, gg as TextMarkRangeOperation, gh as applyFormattingOperationToDocument, gi as applyIndentation, gj as applyTextMarkOperationToDocumentRange, gk as getFormattingStateFromRenderSnapshot, gl as isMarkActive, gm as makeSetAlignment, gn as makeSetFontFamily, go as makeSetFontSize, gp as makeSetHighlight, gq as makeSetTextColor, gr as makeToggleAllCaps, gs as makeToggleBold, gt as makeToggleItalic, gu as makeToggleSmallCaps, gv as makeToggleStrikethrough, gw as makeToggleSubscript, gx as makeToggleSuperscript, gy as makeToggleUnderline } from '../../public-types-S8gTYwKo.cjs';
 import '../../canonical-document-CfZIc-fC.cjs';
 import 'react';
 import 'yjs';

package/dist/core/commands/formatting-commands.d.ts

@@ -1,6 +1,6 @@
 import 'prosemirror-state';
 import 'prosemirror-model';
-export { g4 as Alignment, g5 as FormattingMutationResult, g6 as FormattingOperation, g7 as TextMarkClearTarget, g8 as TextMarkRangeOperation, g9 as applyFormattingOperationToDocument, ga as applyIndentation, gb as applyTextMarkOperationToDocumentRange, gc as getFormattingStateFromRenderSnapshot, gd as isMarkActive, ge as makeSetAlignment, gf as makeSetFontFamily, gg as makeSetFontSize, gh as makeSetHighlight, gi as makeSetTextColor, gj as makeToggleAllCaps, gk as makeToggleBold, gl as makeToggleItalic, gm as makeToggleSmallCaps, gn as makeToggleStrikethrough, go as makeToggleSubscript, gp as makeToggleSuperscript, gq as makeToggleUnderline } from '../../public-types-Cjs8glST.js';
+export { gc as Alignment, gd as FormattingMutationResult, ge as FormattingOperation, gf as TextMarkClearTarget, gg as TextMarkRangeOperation, gh as applyFormattingOperationToDocument, gi as applyIndentation, gj as applyTextMarkOperationToDocumentRange, gk as getFormattingStateFromRenderSnapshot, gl as isMarkActive, gm as makeSetAlignment, gn as makeSetFontFamily, go as makeSetFontSize, gp as makeSetHighlight, gq as makeSetTextColor, gr as makeToggleAllCaps, gs as makeToggleBold, gt as makeToggleItalic, gu as makeToggleSmallCaps, gv as makeToggleStrikethrough, gw as makeToggleSubscript, gx as makeToggleSuperscript, gy as makeToggleUnderline } from '../../public-types-B5lOUIrP.js';
 import '../../canonical-document-CfZIc-fC.js';
 import 'react';
 import 'yjs';

package/dist/core/commands/image-commands.cjs

@@ -2402,7 +2402,20 @@ function sourceJoinHash(refs) {
   if (sourceIds.length === 0) return void 0;
   return hashText(sourceIds.join("\0"));
 }
+var numberingCatalogHashCache = /* @__PURE__ */ new WeakMap();
+var numberingTargetHashCache = /* @__PURE__ */ new WeakMap();
 function createNumberingCatalogRevisionHash(doc) {
+  const numbering = doc.numbering;
+  if (numbering !== void 0) {
+    const cached = numberingCatalogHashCache.get(numbering);
+    if (cached !== void 0) return cached;
+    const fresh = computeNumberingCatalogRevisionHash(doc);
+    numberingCatalogHashCache.set(numbering, fresh);
+    return fresh;
+  }
+  return computeNumberingCatalogRevisionHash(doc);
+}
+function computeNumberingCatalogRevisionHash(doc) {
   const catalog = doc.numbering ?? { abstractDefinitions: {}, instances: {} };
   const abstractDefinitions = catalog.abstractDefinitions ?? {};
   const instances = catalog.instances ?? {};
@@ -2453,8 +2466,27 @@ function createNumberingCatalogRevisionHash(doc) {
   }));
 }
 function createNumberingTargetRevisionHash(doc) {
+  const numbering = doc.numbering;
+  const styles = doc.styles;
+  if (numbering !== void 0 && styles !== void 0) {
+    let inner = numberingTargetHashCache.get(numbering);
+    if (inner === void 0) {
+      inner = /* @__PURE__ */ new WeakMap();
+      numberingTargetHashCache.set(numbering, inner);
+    }
+    const cached = inner.get(styles);
+    if (cached !== void 0) return cached;
+    const fresh = computeNumberingTargetRevisionHash(doc);
+    inner.set(styles, fresh);
+    return fresh;
+  }
+  return computeNumberingTargetRevisionHash(doc);
+}
+function computeNumberingTargetRevisionHash(doc) {
   const paragraphStyles = doc.styles?.paragraphs ?? {};
   return hashText(JSON.stringify({
+    // Reuses the memoized catalog hash on the hot path so a typing edit
+    // pays for the catalog hash at most once across both helpers.
     numberingCatalogHash: createNumberingCatalogRevisionHash(doc),
     paragraphStyleNumbering: Object.keys(paragraphStyles).sort().map((styleId) => {
       const style = paragraphStyles[styleId];

package/dist/core/commands/image-commands.d.cts

@@ -1,4 +1,4 @@
-import { C as CanonicalDocumentEnvelope, S as SelectionSnapshot, g as TransactionMapping } from '../../public-types-KBS6JnOs.cjs';
+import { C as CanonicalDocumentEnvelope, e as SelectionSnapshot, i as TransactionMapping } from '../../public-types-S8gTYwKo.cjs';
 import 'react';
 import 'yjs';
 import 'y-protocols/awareness';

package/dist/core/commands/image-commands.d.ts

@@ -1,4 +1,4 @@
-import { C as CanonicalDocumentEnvelope, S as SelectionSnapshot, g as TransactionMapping } from '../../public-types-Cjs8glST.js';
+import { C as CanonicalDocumentEnvelope, e as SelectionSnapshot, i as TransactionMapping } from '../../public-types-B5lOUIrP.js';
 import 'react';
 import 'yjs';
 import 'y-protocols/awareness';

package/dist/core/commands/image-commands.js

@@ -2,13 +2,13 @@ import {
   insertImage,
   repositionFloatingImage,
   resizeImage
-} from "../../chunk-UFPBYJMA.js";
-import "../../chunk-N5FTU4HZ.js";
-import "../../chunk-C5LXKR54.js";
+} from "../../chunk-INLRCC4N.js";
+import "../../chunk-MQ5GAJ54.js";
+import "../../chunk-QTRJLKR2.js";
 import "../../chunk-QIO6V46H.js";
-import "../../chunk-U3UMKA7B.js";
+import "../../chunk-XBQFDBXE.js";
 import "../../chunk-OYGMRRR7.js";
-import "../../chunk-RYMMKOFI.js";
+import "../../chunk-5KTJKTNE.js";
 import "../../chunk-UFVDIR2C.js";
 import "../../chunk-PGGPPZ65.js";
 import "../../chunk-DNXYUIIS.js";

package/dist/core/commands/section-layout-commands.d.cts

@@ -1,4 +1,4 @@
-import { h as SelectionSnapshot, M as MarginPresetDefinition, i as PageFormatDefinition, R as RuntimeRenderSnapshot } from '../../public-types-KBS6JnOs.cjs';
+import { j as SelectionSnapshot, M as MarginPresetDefinition, k as PageFormatDefinition, R as RuntimeRenderSnapshot } from '../../public-types-S8gTYwKo.cjs';
 import { C as CanonicalDocument, P as PageSize, a as PageMargins, b as ColumnProperties, c as PageNumbering } from '../../canonical-document-CfZIc-fC.cjs';
 import 'react';
 import 'yjs';

package/dist/core/commands/section-layout-commands.d.ts

@@ -1,4 +1,4 @@
-import { h as SelectionSnapshot, M as MarginPresetDefinition, i as PageFormatDefinition, R as RuntimeRenderSnapshot } from '../../public-types-Cjs8glST.js';
+import { j as SelectionSnapshot, M as MarginPresetDefinition, k as PageFormatDefinition, R as RuntimeRenderSnapshot } from '../../public-types-B5lOUIrP.js';
 import { C as CanonicalDocument, P as PageSize, a as PageMargins, b as ColumnProperties, c as PageNumbering } from '../../canonical-document-CfZIc-fC.js';
 import 'react';
 import 'yjs';

package/dist/core/commands/style-commands.d.cts

@@ -1,4 +1,4 @@
-import { P as PersistedEditorSnapshot, R as RuntimeRenderSnapshot } from '../../public-types-KBS6JnOs.cjs';
+import { P as PersistedEditorSnapshot, R as RuntimeRenderSnapshot } from '../../public-types-S8gTYwKo.cjs';
 import 'react';
 import 'yjs';
 import 'y-protocols/awareness';

package/dist/core/commands/style-commands.d.ts

@@ -1,4 +1,4 @@
-import { P as PersistedEditorSnapshot, R as RuntimeRenderSnapshot } from '../../public-types-Cjs8glST.js';
+import { P as PersistedEditorSnapshot, R as RuntimeRenderSnapshot } from '../../public-types-B5lOUIrP.js';
 import 'react';
 import 'yjs';
 import 'y-protocols/awareness';

package/dist/core/commands/table-structure-commands.cjs

@@ -1807,7 +1807,20 @@ function sourceJoinHash(refs) {
   if (sourceIds.length === 0) return void 0;
   return hashText(sourceIds.join("\0"));
 }
+var numberingCatalogHashCache = /* @__PURE__ */ new WeakMap();
+var numberingTargetHashCache = /* @__PURE__ */ new WeakMap();
 function createNumberingCatalogRevisionHash(doc) {
+  const numbering = doc.numbering;
+  if (numbering !== void 0) {
+    const cached = numberingCatalogHashCache.get(numbering);
+    if (cached !== void 0) return cached;
+    const fresh = computeNumberingCatalogRevisionHash(doc);
+    numberingCatalogHashCache.set(numbering, fresh);
+    return fresh;
+  }
+  return computeNumberingCatalogRevisionHash(doc);
+}
+function computeNumberingCatalogRevisionHash(doc) {
   const catalog = doc.numbering ?? { abstractDefinitions: {}, instances: {} };
   const abstractDefinitions = catalog.abstractDefinitions ?? {};
   const instances = catalog.instances ?? {};
@@ -1858,8 +1871,27 @@ function createNumberingCatalogRevisionHash(doc) {
   }));
 }
 function createNumberingTargetRevisionHash(doc) {
+  const numbering = doc.numbering;
+  const styles = doc.styles;
+  if (numbering !== void 0 && styles !== void 0) {
+    let inner = numberingTargetHashCache.get(numbering);
+    if (inner === void 0) {
+      inner = /* @__PURE__ */ new WeakMap();
+      numberingTargetHashCache.set(numbering, inner);
+    }
+    const cached = inner.get(styles);
+    if (cached !== void 0) return cached;
+    const fresh = computeNumberingTargetRevisionHash(doc);
+    inner.set(styles, fresh);
+    return fresh;
+  }
+  return computeNumberingTargetRevisionHash(doc);
+}
+function computeNumberingTargetRevisionHash(doc) {
   const paragraphStyles = doc.styles?.paragraphs ?? {};
   return hashText(JSON.stringify({
+    // Reuses the memoized catalog hash on the hot path so a typing edit
+    // pays for the catalog hash at most once across both helpers.
     numberingCatalogHash: createNumberingCatalogRevisionHash(doc),
     paragraphStyleNumbering: Object.keys(paragraphStyles).sort().map((styleId) => {
       const style = paragraphStyles[styleId];

package/dist/core/commands/table-structure-commands.d.cts

@@ -1,4 +1,4 @@
-export { gr as CellLocator, gs as TableStructureOperation, gt as applyTableStructureOperation, gu as applyTableStructureOperationForEditableTarget, gv as getTableStructureContext, gw as removeCellFromRow, gx as removeTableRowPure, gy as tableStructureActionHandleForTarget } from '../../public-types-KBS6JnOs.cjs';
+export { gz as CellLocator, gA as TableStructureOperation, gB as applyTableStructureOperation, gC as applyTableStructureOperationForEditableTarget, gD as getTableStructureContext, gE as removeCellFromRow, gF as removeTableRowPure, gG as tableStructureActionHandleForTarget } from '../../public-types-S8gTYwKo.cjs';
 import '../../canonical-document-CfZIc-fC.cjs';
 import 'react';
 import 'yjs';

package/dist/core/commands/table-structure-commands.d.ts

@@ -1,4 +1,4 @@
-export { gr as CellLocator, gs as TableStructureOperation, gt as applyTableStructureOperation, gu as applyTableStructureOperationForEditableTarget, gv as getTableStructureContext, gw as removeCellFromRow, gx as removeTableRowPure, gy as tableStructureActionHandleForTarget } from '../../public-types-Cjs8glST.js';
+export { gz as CellLocator, gA as TableStructureOperation, gB as applyTableStructureOperation, gC as applyTableStructureOperationForEditableTarget, gD as getTableStructureContext, gE as removeCellFromRow, gF as removeTableRowPure, gG as tableStructureActionHandleForTarget } from '../../public-types-B5lOUIrP.js';
 import '../../canonical-document-CfZIc-fC.js';
 import 'react';
 import 'yjs';

package/dist/core/commands/table-structure-commands.js

@@ -5,11 +5,11 @@ import {
   removeCellFromRow,
   removeTableRowPure,
   tableStructureActionHandleForTarget
-} from "../../chunk-6TLZ6CMP.js";
-import "../../chunk-C5LXKR54.js";
-import "../../chunk-U3UMKA7B.js";
+} from "../../chunk-WDDFU2N2.js";
+import "../../chunk-QTRJLKR2.js";
+import "../../chunk-XBQFDBXE.js";
 import "../../chunk-OYGMRRR7.js";
-import "../../chunk-RYMMKOFI.js";
+import "../../chunk-5KTJKTNE.js";
 import "../../chunk-UFVDIR2C.js";
 import "../../chunk-PGGPPZ65.js";
 import "../../chunk-DNXYUIIS.js";

package/dist/core/commands/text-commands.cjs

@@ -2477,7 +2477,20 @@ function sourceJoinHash(refs) {
   if (sourceIds.length === 0) return void 0;
   return hashText(sourceIds.join("\0"));
 }
+var numberingCatalogHashCache = /* @__PURE__ */ new WeakMap();
+var numberingTargetHashCache = /* @__PURE__ */ new WeakMap();
 function createNumberingCatalogRevisionHash(doc) {
+  const numbering = doc.numbering;
+  if (numbering !== void 0) {
+    const cached = numberingCatalogHashCache.get(numbering);
+    if (cached !== void 0) return cached;
+    const fresh = computeNumberingCatalogRevisionHash(doc);
+    numberingCatalogHashCache.set(numbering, fresh);
+    return fresh;
+  }
+  return computeNumberingCatalogRevisionHash(doc);
+}
+function computeNumberingCatalogRevisionHash(doc) {
   const catalog = doc.numbering ?? { abstractDefinitions: {}, instances: {} };
   const abstractDefinitions = catalog.abstractDefinitions ?? {};
   const instances = catalog.instances ?? {};
@@ -2528,8 +2541,27 @@ function createNumberingCatalogRevisionHash(doc) {
   }));
 }
 function createNumberingTargetRevisionHash(doc) {
+  const numbering = doc.numbering;
+  const styles = doc.styles;
+  if (numbering !== void 0 && styles !== void 0) {
+    let inner = numberingTargetHashCache.get(numbering);
+    if (inner === void 0) {
+      inner = /* @__PURE__ */ new WeakMap();
+      numberingTargetHashCache.set(numbering, inner);
+    }
+    const cached = inner.get(styles);
+    if (cached !== void 0) return cached;
+    const fresh = computeNumberingTargetRevisionHash(doc);
+    inner.set(styles, fresh);
+    return fresh;
+  }
+  return computeNumberingTargetRevisionHash(doc);
+}
+function computeNumberingTargetRevisionHash(doc) {
   const paragraphStyles = doc.styles?.paragraphs ?? {};
   return hashText(JSON.stringify({
+    // Reuses the memoized catalog hash on the hot path so a typing edit
+    // pays for the catalog hash at most once across both helpers.
     numberingCatalogHash: createNumberingCatalogRevisionHash(doc),
     paragraphStyleNumbering: Object.keys(paragraphStyles).sort().map((styleId) => {
       const style = paragraphStyles[styleId];
@@ -7884,7 +7916,38 @@ var TextTransactionError = class extends Error {
     this.code = code;
   }
 };
+function isUsableScopeSurface(surface, document) {
+  if (surface.viewportBlockRanges !== null) return false;
+  const root = document.content;
+  if (!root || root.type !== "doc" || !Array.isArray(root.children)) {
+    return false;
+  }
+  return surface.blocks.length === root.children.length;
+}
+function createScopeSurfaceCache(document, selection, precomputedSurface, telemetry) {
+  let cached;
+  if (precomputedSurface && isUsableScopeSurface(precomputedSurface, document)) {
+    cached = precomputedSurface;
+    telemetry?.onPrecomputedSurfaceHit?.();
+  }
+  return {
+    get() {
+      if (cached) return cached;
+      telemetry?.onScopeSurfaceBuild?.();
+      cached = createEditorSurfaceSnapshot(document, selection, void 0, {
+        editableTargetsByBlockPath: NO_EDITABLE_TARGETS_INDEX
+      });
+      return cached;
+    }
+  };
+}
 function applyTextTransaction(document, selection, intent, options) {
+  const scopeSurfaceCache = createScopeSurfaceCache(
+    document,
+    selection,
+    options.precomputedSurface,
+    options.surfaceTelemetry
+  );
   if (options.textTarget) {
     if (options.textTarget.kind === "hyperlink-display") {
       const targetedHyperlinkResult = tryApplyHyperlinkDisplayTransaction(
@@ -7920,7 +7983,8 @@ function applyTextTransaction(document, selection, intent, options) {
       document,
       selection,
       intent,
-      options
+      options,
+      scopeSurfaceCache
     );
     if (targetedTableResult) {
       return targetedTableResult;
@@ -7934,7 +7998,8 @@ function applyTextTransaction(document, selection, intent, options) {
     const tableStructureRefusal = resolveTargetlessTableStructureInsertRefusal(
       document,
       selection,
-      intent
+      intent,
+      scopeSurfaceCache
     );
     if (tableStructureRefusal) {
       throw new TextTransactionError("unsupported_content", tableStructureRefusal);
@@ -7944,7 +8009,8 @@ function applyTextTransaction(document, selection, intent, options) {
     document,
     selection,
     intent,
-    options
+    options,
+    scopeSurfaceCache
   );
   if (topLevelParagraphResult) {
     return topLevelParagraphResult;
@@ -7953,7 +8019,8 @@ function applyTextTransaction(document, selection, intent, options) {
     document,
     selection,
     intent,
-    options
+    options,
+    scopeSurfaceCache
   );
   if (sdtScopedResult) {
     return sdtScopedResult;
@@ -7962,7 +8029,8 @@ function applyTextTransaction(document, selection, intent, options) {
     document,
     selection,
     intent,
-    options
+    options,
+    scopeSurfaceCache
   );
   if (tableScopedResult) {
     return tableScopedResult;
@@ -8015,9 +8083,9 @@ function applyLinearTextTransaction(document, selection, intent, options) {
     storyText: createPlainText(nextStory)
   };
 }
-function tryApplyTableParagraphTransaction(document, selection, intent, options) {
+function tryApplyTableParagraphTransaction(document, selection, intent, options, scopeSurfaceCache) {
   const tableTarget = options.textTarget?.kind === "table-paragraph" ? options.textTarget : void 0;
-  const scope = resolveTableParagraphScope(document, selection, tableTarget);
+  const scope = resolveTableParagraphScope(document, selection, tableTarget, scopeSurfaceCache);
   if (!scope) {
     return null;
   }
@@ -8140,7 +8208,11 @@ function tryApplyTargetedTextLeafTransaction(document, selection, intent, option
   };
 }
 function tryApplyHyperlinkDisplayTransaction(document, selection, intent, options) {
-  const scope = resolveTargetedHyperlinkDisplayScope(document, selection, options.textTarget);
+  const scope = resolveTargetedHyperlinkDisplayScope(
+    document,
+    selection,
+    options.textTarget
+  );
   if (!scope) {
     return null;
   }
@@ -8198,8 +8270,8 @@ function tryApplyHyperlinkDisplayTransaction(document, selection, intent, option
     storyText: localResult.storyText
   };
 }
-function tryApplyTopLevelSdtParagraphTransaction(document, selection, intent, options) {
-  const scope = resolveTopLevelSdtParagraphScope(document, selection);
+function tryApplyTopLevelSdtParagraphTransaction(document, selection, intent, options, scopeSurfaceCache) {
+  const scope = resolveTopLevelSdtParagraphScope(document, selection, scopeSurfaceCache);
   if (!scope) {
     return null;
   }
@@ -8251,8 +8323,8 @@ function tryApplyTopLevelSdtParagraphTransaction(document, selection, intent, op
     storyText: localResult.storyText
   };
 }
-function tryApplyTopLevelParagraphTransaction(document, selection, intent, options) {
-  const scope = resolveTopLevelParagraphScope(document, selection);
+function tryApplyTopLevelParagraphTransaction(document, selection, intent, options, scopeSurfaceCache) {
+  const scope = resolveTopLevelParagraphScope(document, selection, scopeSurfaceCache);
   if (!scope) {
     return null;
   }
@@ -8362,17 +8434,15 @@ function resolveTargetedHyperlinkDisplayScope(document, selection, target) {
     replace: resolved.replace
   };
 }
-function resolveTableParagraphScope(document, selection, target) {
+function resolveTableParagraphScope(document, selection, target, scopeSurfaceCache) {
   if (target) {
-    return resolveTargetedTableParagraphScope(document, selection, target);
+    return resolveTargetedTableParagraphScope(document, selection, target, scopeSurfaceCache);
   }
   const root = document.content;
   if (!root || root.type !== "doc" || !Array.isArray(root.children)) {
     return null;
   }
-  const surface = createEditorSurfaceSnapshot(document, selection, void 0, {
-    editableTargetsByBlockPath: NO_EDITABLE_TARGETS_INDEX
-  });
+  const surface = scopeSurfaceCache.get();
   const selectionFrom = Math.min(selection.anchor, selection.head);
   const selectionTo = Math.max(selection.anchor, selection.head);
   for (let blockIndex = 0; blockIndex < root.children.length; blockIndex += 1) {
@@ -8477,7 +8547,7 @@ function resolveTableParagraphScope(document, selection, target) {
   }
   return null;
 }
-function resolveTargetlessTableStructureInsertRefusal(document, selection, intent) {
+function resolveTargetlessTableStructureInsertRefusal(document, selection, intent, scopeSurfaceCache) {
   if (!isCollapsedInsertIntent(intent, selection)) {
     return null;
   }
@@ -8485,9 +8555,7 @@ function resolveTargetlessTableStructureInsertRefusal(document, selection, inten
   if (!root || root.type !== "doc" || !Array.isArray(root.children)) {
     return null;
   }
-  const surface = createEditorSurfaceSnapshot(document, selection, void 0, {
-    editableTargetsByBlockPath: NO_EDITABLE_TARGETS_INDEX
-  });
+  const surface = scopeSurfaceCache.get();
   if (!selectionTouchesTableStructureBoundary(surface.blocks, selection.anchor)) {
     return null;
   }
@@ -8501,7 +8569,7 @@ function isCollapsedInsertIntent(intent, selection) {
   const rangeTo = intent.range ? Math.max(intent.range.from, intent.range.to) : Math.max(selection.anchor, selection.head);
   return rangeFrom === rangeTo;
 }
-function resolveTargetedTableParagraphScope(document, selection, target) {
+function resolveTargetedTableParagraphScope(document, selection, target, scopeSurfaceCache) {
   const root = document.content;
   if (!root || root.type !== "doc" || !Array.isArray(root.children)) {
     return null;
@@ -8514,7 +8582,8 @@ function resolveTargetedTableParagraphScope(document, selection, target) {
       root,
       document,
       selection,
-      target
+      target,
+      scopeSurfaceCache
     );
     if (targetScope) {
       return targetScope;
@@ -8537,9 +8606,7 @@ function resolveTargetedTableParagraphScope(document, selection, target) {
   if (cell.verticalMerge === "continue") {
     return "unsupported";
   }
-  const surface = createEditorSurfaceSnapshot(document, selection, void 0, {
-    editableTargetsByBlockPath: NO_EDITABLE_TARGETS_INDEX
-  });
+  const surface = scopeSurfaceCache.get();
   const surfaceBlock = surface.blocks[target.tableBlockIndex];
   const surfaceRow = surfaceBlock?.kind === "table" ? surfaceBlock.rows[target.rowIndex] : void 0;
   const surfaceCell = surfaceRow?.cells[target.cellIndex];
@@ -8603,16 +8670,14 @@ function resolveTargetedTableParagraphScope(document, selection, target) {
     }
   };
 }
-function resolveTargetedTableParagraphScopeByPath(root, document, selection, target) {
+function resolveTargetedTableParagraphScopeByPath(root, document, selection, target, scopeSurfaceCache) {
   if (!target.blockPath) return null;
   const tokens = parseCanonicalBlockPath(target.blockPath);
   if (!tokens) return null;
   const resolved = resolveBlockPathInCanonicalBlocks(root.children, tokens, 0);
   if (!resolved || resolved.block.type !== "paragraph") return null;
   if (resolved.hasVerticalMergeContinuation) return null;
-  const surface = createEditorSurfaceSnapshot(document, selection, void 0, {
-    editableTargetsByBlockPath: NO_EDITABLE_TARGETS_INDEX
-  });
+  const surface = scopeSurfaceCache.get();
   const surfaceResolved = resolveBlockPathInSurfaceBlocks(surface.blocks, tokens, 0);
   if (!surfaceResolved || surfaceResolved.kind !== "paragraph") return null;
   if (surfaceResolved.hasVerticalMergeContinuation) return null;
@@ -9067,14 +9132,12 @@ function resolveBlockPathInSurfaceBlocks(blocks, tokens, tokenIndex, hasVertical
     hasVerticalMergeContinuation || cell.verticalMerge === "continue"
   );
 }
-function resolveTopLevelParagraphScope(document, selection) {
+function resolveTopLevelParagraphScope(document, selection, scopeSurfaceCache) {
   const root = document.content;
   if (!root || root.type !== "doc" || !Array.isArray(root.children)) {
     return null;
   }
-  const surface = createEditorSurfaceSnapshot(document, selection, void 0, {
-    editableTargetsByBlockPath: NO_EDITABLE_TARGETS_INDEX
-  });
+  const surface = scopeSurfaceCache.get();
   const selectionFrom = Math.min(selection.anchor, selection.head);
   const selectionTo = Math.max(selection.anchor, selection.head);
   for (let blockIndex = 0; blockIndex < root.children.length; blockIndex += 1) {
@@ -9103,14 +9166,12 @@ function resolveTopLevelParagraphScope(document, selection) {
   }
   return null;
 }
-function resolveTopLevelSdtParagraphScope(document, selection) {
+function resolveTopLevelSdtParagraphScope(document, selection, scopeSurfaceCache) {
   const root = document.content;
   if (!root || root.type !== "doc" || !Array.isArray(root.children)) {
     return null;
   }
-  const surface = createEditorSurfaceSnapshot(document, selection, void 0, {
-    editableTargetsByBlockPath: NO_EDITABLE_TARGETS_INDEX
-  });
+  const surface = scopeSurfaceCache.get();
   const selectionFrom = Math.min(selection.anchor, selection.head);
   const selectionTo = Math.max(selection.anchor, selection.head);
   for (let blockIndex = 0; blockIndex < root.children.length; blockIndex += 1) {

package/dist/core/commands/text-commands.d.cts

@@ -1,4 +1,4 @@
-import { T as TextTransactionTextTarget, C as CanonicalDocumentEnvelope, S as SelectionSnapshot, d as TextTransactionResult, e as StructuralMutationResult, I as InsertTableOptions, f as TextFormattingDirective, g as TransactionMapping } from '../../public-types-KBS6JnOs.cjs';
+import { T as TextTransactionTextTarget, d as EditorSurfaceSnapshot, S as ScopeSurfaceTelemetry, C as CanonicalDocumentEnvelope, e as SelectionSnapshot, f as TextTransactionResult, g as StructuralMutationResult, I as InsertTableOptions, h as TextFormattingDirective, i as TransactionMapping } from '../../public-types-S8gTYwKo.cjs';
 import 'react';
 import 'yjs';
 import 'y-protocols/awareness';
@@ -12,6 +12,17 @@ interface TextCommandContext {
     textTarget?: TextTransactionTextTarget;
     rejectTargetlessTableStructureInsert?: boolean;
     preserveNumberingOnSplit?: boolean;
+    /**
+     * Optional pre-built scope surface for the current document/selection.
+     * Threaded from `CommandExecutionContext.renderSnapshot.surface` by the
+     * runtime so the canonical text-transaction layer reuses the runtime's
+     * cached surface on the typing hot path. The L02 layer keeps full
+     * functional correctness when this is omitted.
+     */
+    precomputedSurface?: EditorSurfaceSnapshot;
+    /** Optional perf-counter callbacks so the runtime can observe whether the
+     *  precomputed surface was reused or a fresh one had to be built. */
+    surfaceTelemetry?: ScopeSurfaceTelemetry;
 }
 declare function insertText(document: CanonicalDocumentEnvelope, selection: SelectionSnapshot, text: string, context: TextCommandContext, formatting?: TextFormattingDirective): TextTransactionResult;
 declare function deleteSelectionOrBackward(document: CanonicalDocumentEnvelope, selection: SelectionSnapshot, context: TextCommandContext): TextTransactionResult;