@beyondwork/docx-react-component 1.0.134 → 1.0.135

package/dist/{chunk-EBSI6VQX.js → chunk-GIFXKIM5.js}

@@ -22,7 +22,7 @@ import {
   insertText,
   outdentParagraphAtSelection,
   splitParagraph
-} from "./chunk-REFHJ2FN.js";
+} from "./chunk-2BNXARVO.js";
 import {
   applyFormattingOperationToDocument,
   applyTextMarkOperationToDocumentRange,
@@ -32,23 +32,23 @@ import {
   insertImage,
   repositionFloatingImage,
   resizeImage
-} from "./chunk-INLRCC4N.js";
+} from "./chunk-4CIHTMCH.js";
 import {
   applyTextTransaction
-} from "./chunk-MQ5GAJ54.js";
+} from "./chunk-BJXSMPHD.js";
 import {
   applyTableStructureOperationForEditableTarget,
   removeCellFromRow,
   removeTableRowPure
-} from "./chunk-WDDFU2N2.js";
+} from "./chunk-UR2LW63N.js";
 import {
   resolveParagraphScope
-} from "./chunk-QTRJLKR2.js";
+} from "./chunk-TSNK4ECL.js";
 import {
   buildGeometryDebugEntry,
   collectLineBoxesForRegion,
   createGeometryFacet
-} from "./chunk-74R5B2EZ.js";
+} from "./chunk-H4HI6RUE.js";
 import {
   AI_ACTION_POLICIES,
   allocateNumberingInstance,
@@ -83,7 +83,7 @@ import {
   sameScopeParagraphPath,
   serializeFragmentToWordML,
   setStartOverride
-} from "./chunk-IJD6D7HU.js";
+} from "./chunk-5CCYF333.js";
 import {
   ISSUE_METADATA_ID,
   LAYOUT_ENGINE_VERSION,
@@ -121,7 +121,7 @@ import {
   setWorkspaceMode,
   setZoomLevel,
   snapCommentAnchorAwayFromTable
-} from "./chunk-O4EDZR44.js";
+} from "./chunk-P7XDEVS6.js";
 import {
   countLogicalPositions,
   createPlainText,
@@ -141,7 +141,7 @@ import {
   replaceStoryBlocks,
   resolvePageFieldDisplayText,
   storyTargetKey
-} from "./chunk-XBQFDBXE.js";
+} from "./chunk-EZFF6GKF.js";
 import {
   createCommentSidebarProjection,
   createCommentStoreFromRuntimeComments
@@ -12800,6 +12800,36 @@ function createDocumentRuntime(options) {
   let viewportBlockRanges = null;
   let viewportRangesKey = serializeViewportRanges(viewportBlockRanges);
   let viewportBlocksPerPageEstimate = null;
+  let fullSurfaceWarmupScheduled = false;
+  let fullSurfaceWarmupCompleted = false;
+  function scheduleFullSurfaceWarmupAfterCull() {
+    if (fullSurfaceWarmupScheduled || fullSurfaceWarmupCompleted) return;
+    fullSurfaceWarmupScheduled = true;
+    perfCounters.increment("surface.fullSurfaceWarmup.scheduled");
+    runOnIdle(() => {
+      fullSurfaceWarmupScheduled = false;
+      if (cachedFullSurface) {
+        perfCounters.increment("surface.fullSurfaceWarmup.alreadyCached");
+        fullSurfaceWarmupCompleted = true;
+        return;
+      }
+      const t0 = performance.now();
+      try {
+        getCachedFullSurface(state.document, activeStory);
+        fullSurfaceWarmupCompleted = true;
+        perfCounters.increment("surface.fullSurfaceWarmup.committed");
+      } catch (error) {
+        perfCounters.increment("surface.fullSurfaceWarmup.failed");
+        fullSurfaceWarmupCompleted = false;
+        void error;
+      } finally {
+        perfCounters.increment(
+          "surface.fullSurfaceWarmup.us",
+          Math.round((performance.now() - t0) * 1e3)
+        );
+      }
+    });
+  }
   const getRuntimeForLayoutFacet = () => {
     if (!runtimeRef) {
       throw new Error("Document runtime viewport methods are not initialized");
@@ -12992,6 +13022,15 @@ function createDocumentRuntime(options) {
   let cachedSurface;
   let cachedFullSurface;
   const editableTargetBlockCache = createEditableTargetBlockCache();
+  let paragraphCascadeCache = /* @__PURE__ */ new WeakMap();
+  let paragraphCascadeCacheStylesRef = null;
+  function ensureParagraphCascadeCacheForStyles(nextStyles) {
+    if (paragraphCascadeCacheStylesRef !== nextStyles) {
+      paragraphCascadeCache = /* @__PURE__ */ new WeakMap();
+      paragraphCascadeCacheStylesRef = nextStyles;
+    }
+    return paragraphCascadeCache;
+  }
   let cachedEditableTargetMap = null;
   function getEditableTargetsByBlockPath(document) {
     if (cachedEditableTargetMap !== null && cachedEditableTargetMap.document === document) {
@@ -13045,6 +13084,7 @@ function createDocumentRuntime(options) {
     const snapshot = createEditorSurfaceSnapshot(document, state.selection, nextActiveStory, {
       viewportBlockRanges: null,
       editableTargetsByBlockPath: getEditableTargetsByBlockPath(document),
+      paragraphCascadeCache: ensureParagraphCascadeCacheForStyles(document.styles),
       ...effectiveMarkupModeProvider ? { getEffectiveMarkupMode: effectiveMarkupModeProvider } : {}
     });
     recordPerfSample("snapshot.surface");
@@ -13085,6 +13125,7 @@ function createDocumentRuntime(options) {
         activeStoryKey,
         surfaceViewportRanges
       ),
+      paragraphCascadeCache: ensureParagraphCascadeCacheForStyles(document.styles),
       ...effectiveMarkupModeProvider ? { getEffectiveMarkupMode: effectiveMarkupModeProvider } : {}
     });
     recordPerfSample("snapshot.surface");
@@ -13296,7 +13337,17 @@ function createDocumentRuntime(options) {
     }
   }
   function tryPatchNestedLocalTextSurface(previousSurface, editFrom, editTo, insertedText) {
-    const shiftBudget = estimateLocalTextPatchShiftBudget(previousSurface.blocks, 0);
+    const containerIndex = previousSurface.blocks.findIndex(
+      (block) => editFrom >= block.from && editTo <= block.to
+    );
+    if (containerIndex < 0) {
+      perfCounters.increment("surface.localText.patchMiss");
+      return null;
+    }
+    const shiftBudget = estimateLocalTextPatchShiftBudget(
+      previousSurface.blocks,
+      containerIndex + 1
+    );
     perfCounters.increment("surface.localText.shiftedBlocks", shiftBudget.shiftedBlocks);
     perfCounters.increment("surface.localText.shiftedNodes", shiftBudget.shiftedNodes);
     if (!shiftBudget.withinBudget) {
@@ -13376,19 +13427,9 @@ function createDocumentRuntime(options) {
     for (let index = startIndex; index < blocks.length; index += 1) {
       const shiftedBlockNodes = countSurfaceShiftNodesUpTo(
         blocks[index],
-        Math.min(
-          policy.maxShiftedNodesPerBlock,
-          policy.maxShiftedSurfaceNodes - shiftedNodes
-        ) + 1
+        policy.maxShiftedSurfaceNodes - shiftedNodes + 1
       );
       shiftedNodes += shiftedBlockNodes;
-      if (shiftedBlockNodes > policy.maxShiftedNodesPerBlock) {
-        return {
-          shiftedBlocks,
-          shiftedNodes,
-          withinBudget: false
-        };
-      }
       if (shiftedNodes > policy.maxShiftedSurfaceNodes) {
         return {
           shiftedBlocks,
@@ -14060,6 +14101,9 @@ function createDocumentRuntime(options) {
         viewportBlockRangesOverride: firstSurfaceViewportBlockRanges
       }) : getCachedSurface(state.document, activeStory)
     );
+    if (firstSurfaceViewportBlockRanges) {
+      scheduleFullSurfaceWarmupAfterCull();
+    }
     const snapshot = {
       documentId: state.documentId,
       sessionId: state.sessionId,
@@ -14173,6 +14217,9 @@ function createDocumentRuntime(options) {
           activeStoryKey,
           viewportBlockRanges
         ),
+        paragraphCascadeCache: ensureParagraphCascadeCacheForStyles(
+          state.document.styles
+        ),
         ...effectiveMarkupModeProvider ? { getEffectiveMarkupMode: effectiveMarkupModeProvider } : {}
       }
     );
@@ -17445,10 +17492,11 @@ function createDocumentRuntime(options) {
       document: state.document,
       editableTarget,
       selection,
+      storyTarget: activeStory,
       targetResolution,
       timestamp
     });
-    if (selectedListItemDelete && activeStory.kind === "main" && context.documentMode !== "suggesting") {
+    if (selectedListItemDelete && context.documentMode !== "suggesting") {
       const replacementCommand = {
         type: "document.replace",
         document: selectedListItemDelete.document,
@@ -17713,6 +17761,9 @@ function createDocumentRuntime(options) {
     });
   }
   function scheduleIdleContextAnalytics(callback) {
+    runOnIdle(callback);
+  }
+  function runOnIdle(callback) {
     const requestIdle = globalThis.requestIdleCallback;
     if (typeof requestIdle === "function") {
       requestIdle(callback, { timeout: 250 });
@@ -20353,7 +20404,7 @@ function isTopLevelMainStoryBlockPath(blockPath) {
   return typeof blockPath === "string" && /^main\/block\[\d+\]$/u.test(blockPath);
 }
 function createSelectedListItemDeleteReplacement(input) {
-  const { command, document, editableTarget, selection, targetResolution, timestamp } = input;
+  const { command, document, editableTarget, selection, storyTarget, targetResolution, timestamp } = input;
   if (command.type !== "text.delete-backward" && command.type !== "text.delete-forward") {
     return null;
   }
@@ -20365,20 +20416,19 @@ function createSelectedListItemDeleteReplacement(input) {
   if (selectionFrom !== targetResolution.range.from || selectionTo !== targetResolution.range.to) {
     return null;
   }
-  const root = document.content;
-  const replacement = removeNumberedParagraphAtMainStoryPath(root.children, editableTarget.blockPath);
+  const storyBlocks = getStoryBlocks(document, storyTarget);
+  const replacement = removeNumberedParagraphAtStoryPath(storyBlocks, editableTarget.blockPath, storyTarget);
   if (!replacement) {
     return null;
   }
-  const nextDocument = {
+  const nextDocument = replaceStoryBlocks({
     ...document,
-    updatedAt: timestamp,
-    content: {
-      ...root,
-      children: replacement.blocks
-    }
-  };
-  const nextStorySize = parseTextStory(nextDocument.content).size;
+    updatedAt: timestamp
+  }, storyTarget, replacement.blocks);
+  const nextStorySize = parseTextStory({
+    type: "doc",
+    children: [...getStoryBlocks(nextDocument, storyTarget)]
+  }).size;
   const nextAnchor = Math.min(selectionFrom, nextStorySize);
   return {
     document: nextDocument,
@@ -20395,8 +20445,8 @@ function createSelectedListItemDeleteReplacement(input) {
     }
   };
 }
-function removeNumberedParagraphAtMainStoryPath(blocks, blockPath) {
-  const tokens = parseMainStoryBlockPathTokens(blockPath);
+function removeNumberedParagraphAtStoryPath(blocks, blockPath, storyTarget) {
+  const tokens = parseStoryBlockPathTokens(blockPath, storyTarget);
   if (!tokens) return null;
   return removeNumberedParagraphFromBlocks(blocks, tokens);
 }
@@ -20442,6 +20492,52 @@ function removeNumberedParagraphFromBlocks(blocks, tokens) {
       ]
     };
   }
+  if (block.type === "paragraph" && next?.kind === "inline") {
+    const updatedParagraph = removeNumberedParagraphFromTextBoxInline(block, rest);
+    if (!updatedParagraph) return null;
+    return {
+      blocks: [
+        ...blocks.slice(0, token.index),
+        updatedParagraph,
+        ...blocks.slice(token.index + 1)
+      ]
+    };
+  }
+  return null;
+}
+function removeNumberedParagraphFromTextBoxInline(paragraph, tokens) {
+  const [inlineToken, textBoxToken, ...childTokens] = tokens;
+  if (inlineToken?.kind !== "inline" || textBoxToken?.kind !== "txbx" || childTokens[0]?.kind !== "block") {
+    return null;
+  }
+  const inline = paragraph.children[inlineToken.index];
+  if (!inline) return null;
+  const updatedInline = removeNumberedParagraphFromInlineTextBox(inline, childTokens);
+  if (!updatedInline) return null;
+  return {
+    ...paragraph,
+    children: [
+      ...paragraph.children.slice(0, inlineToken.index),
+      updatedInline,
+      ...paragraph.children.slice(inlineToken.index + 1)
+    ]
+  };
+}
+function removeNumberedParagraphFromInlineTextBox(inline, tokens) {
+  if (inline.type === "shape" && inline.txbxBlocks) {
+    const updatedBlocks = removeNumberedParagraphFromBlocks(inline.txbxBlocks, tokens);
+    return updatedBlocks ? { ...inline, txbxBlocks: updatedBlocks.blocks } : null;
+  }
+  if (inline.type === "drawing_frame" && inline.content.type === "shape" && inline.content.txbxBlocks) {
+    const updatedBlocks = removeNumberedParagraphFromBlocks(inline.content.txbxBlocks, tokens);
+    return updatedBlocks ? {
+      ...inline,
+      content: {
+        ...inline.content,
+        txbxBlocks: updatedBlocks.blocks
+      }
+    } : null;
+  }
   return null;
 }
 function removeNumberedParagraphFromTable(table, tokens) {
@@ -20482,15 +20578,29 @@ function createSelectedListItemDeleteReplayCommand(input) {
     target: editableTarget,
     activeStoryKey: canonicalEditableTargetStoryKey(storyTarget)
   });
+  const resolvedEditableTarget = targetResolution.kind === "accepted" ? editableTarget : storyTarget.kind !== "main" && blockPathBelongsToStoryTarget(editableTarget.blockPath, storyTarget) ? resolveEditableCommandTarget({
+    document,
+    target: editableTarget,
+    activeStoryKey: canonicalEditableTargetStoryKey(storyTarget),
+    commandFamilies: ["text-leaf"]
+  }) : null;
+  const selectedRange = {
+    from: Math.min(selection.anchor, selection.head),
+    to: Math.max(selection.anchor, selection.head)
+  };
   const replacement = createSelectedListItemDeleteReplacement({
     command,
     document,
-    editableTarget,
+    editableTarget: resolvedEditableTarget && resolvedEditableTarget.kind === "accepted" ? resolvedEditableTarget.target : editableTarget,
     selection,
-    targetResolution,
+    storyTarget,
+    targetResolution: resolvedEditableTarget && resolvedEditableTarget.kind === "accepted" ? {
+      kind: "accepted",
+      range: selectedRange
+    } : targetResolution,
     timestamp
   });
-  if (!replacement || storyTarget.kind !== "main") {
+  if (!replacement) {
     return null;
   }
   return {
@@ -20502,22 +20612,49 @@ function createSelectedListItemDeleteReplayCommand(input) {
     origin: command.origin
   };
 }
-function parseMainStoryBlockPathTokens(blockPath) {
-  const parts = blockPath?.split("/") ?? [];
-  if (parts[0] !== "main" || parts.length < 2) {
+function parseStoryBlockPathTokens(blockPath, storyTarget) {
+  if (!blockPath) {
+    return null;
+  }
+  const firstTokenMatch = /\/(?:block|row|cell)\[\d+\]/u.exec(blockPath);
+  if (!firstTokenMatch?.index) {
     return null;
   }
+  const storyPrefix = blockPath.slice(0, firstTokenMatch.index);
+  if (!blockPathBelongsToStoryTarget(storyPrefix, storyTarget)) {
+    return null;
+  }
+  const parts = blockPath.slice(firstTokenMatch.index + 1).split("/");
   const tokens = [];
-  for (const part of parts.slice(1)) {
-    const match = /^(block|row|cell)\[(\d+)\]$/u.exec(part);
+  for (const part of parts) {
+    if (part === "txbx") {
+      tokens.push({ kind: "txbx" });
+      continue;
+    }
+    const match = /^(block|row|cell|inline)\[(\d+)\]$/u.exec(part);
     if (!match) return null;
+    const kind = match[1];
     tokens.push({
-      kind: match[1],
+      kind,
       index: Number.parseInt(match[2], 10)
     });
   }
   return tokens;
 }
+function blockPathBelongsToStoryTarget(storyPrefix, storyTarget) {
+  switch (storyTarget.kind) {
+    case "main":
+      return storyPrefix === "main" || storyPrefix.startsWith("main/");
+    case "header":
+      return storyPrefix.startsWith("header:");
+    case "footer":
+      return storyPrefix.startsWith("footer:");
+    case "footnote":
+      return storyPrefix === `footnote:${storyTarget.noteId}` || storyPrefix.startsWith(`footnote:${storyTarget.noteId}/`);
+    case "endnote":
+      return storyPrefix === `endnote:${storyTarget.noteId}` || storyPrefix.startsWith(`endnote:${storyTarget.noteId}/`);
+  }
+}
 function toInternalSelectionSnapshot(selection) {
   return {
     anchor: selection.anchor,

package/dist/{chunk-74R5B2EZ.js → chunk-H4HI6RUE.js}

@@ -1,7 +1,7 @@
 import {
   PAGE_STACK_GAP_PX,
   resolveDefaultZoom
-} from "./chunk-O4EDZR44.js";
+} from "./chunk-P7XDEVS6.js";
 import {
   MAIN_STORY_KEY,
   collectCanonicalLayoutInputs,

package/dist/{chunk-7Y6JCIK3.js → chunk-HWMPNLEF.js}

@@ -8,7 +8,7 @@ import {
   getRevisionRangeState,
   selectionTouchesRange,
   shouldHideInCleanMode
-} from "./chunk-3YR47WTD.js";
+} from "./chunk-FGJTOFZY.js";
 
 // src/ui-tailwind/editor-surface/tw-editor-surface.tsx
 import { useMemo } from "react";

package/dist/{chunk-VA24T4EB.js → chunk-NEMOQ4QR.js}

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

package/dist/{chunk-O4EDZR44.js → chunk-P7XDEVS6.js}

@@ -20,7 +20,7 @@ import {
   resolveSectionVariants,
   sectionSupportsStoryTarget,
   storyTargetKey
-} from "./chunk-XBQFDBXE.js";
+} from "./chunk-EZFF6GKF.js";
 import {
   createSelectionSnapshot
 } from "./chunk-OYGMRRR7.js";
@@ -8998,6 +8998,8 @@ function buildSearchPattern(query, options = {}) {
 function findSearchMatches(text, query, options = {}) {
   const pattern = buildSearchPattern(query, options);
   if (!pattern) return [];
+  const limit = normalizeSearchLimit(options.limit);
+  if (limit === 0) return [];
   const results = [];
   let match;
   pattern.lastIndex = 0;
@@ -9008,12 +9010,21 @@ function findSearchMatches(text, query, options = {}) {
       text: match[0],
       index: results.length
     });
+    if (results.length >= limit) {
+      break;
+    }
     if (match[0].length === 0) {
       pattern.lastIndex += 1;
     }
   }
   return results;
 }
+function normalizeSearchLimit(limit) {
+  if (limit === void 0 || !Number.isFinite(limit)) {
+    return Number.POSITIVE_INFINITY;
+  }
+  return Math.max(0, Math.floor(limit));
+}
 function createSearchExcerpt(text, from, to, radius = 24) {
   const safeFrom = Math.max(0, Math.min(from, text.length));
   const safeTo = Math.max(safeFrom, Math.min(to, text.length));

package/dist/{chunk-QTRJLKR2.js → chunk-TSNK4ECL.js}

@@ -1,7 +1,7 @@
 import {
   NO_EDITABLE_TARGETS_INDEX,
   createEditorSurfaceSnapshot
-} from "./chunk-XBQFDBXE.js";
+} from "./chunk-EZFF6GKF.js";
 import {
   createSelectionSnapshot
 } from "./chunk-OYGMRRR7.js";

package/dist/{chunk-WDDFU2N2.js → chunk-UR2LW63N.js}

@@ -3,7 +3,7 @@ import {
   createNoopStructuralMutation,
   findTableCellParagraphSelection,
   findTopLevelParagraphSelectionNearBlock
-} from "./chunk-QTRJLKR2.js";
+} from "./chunk-TSNK4ECL.js";
 import {
   collectEditableTargetRefs,
   collectStoryBlockContexts,

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

@@ -1,6 +1,6 @@
 import 'prosemirror-state';
 import 'prosemirror-model';
-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-BR1SYK2F.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-D31xKNGc.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 { 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-DXNZVKrS.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-DqYt8GdP.js';
 import '../../canonical-document-CfZIc-fC.js';
 import 'react';
 import 'yjs';

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

@@ -5315,10 +5315,16 @@ var FormattingContextImpl = class {
   // surface-projection calls `resolveParagraphCascade` on the same
   // paragraph via `resolveParagraph` + numbering resolve + marker-rPr;
   // each of those re-walked the style catalog before.
-  paragraphCascadeCache = /* @__PURE__ */ new WeakMap();
+  //
+  // Defaults to a per-context instance, but the runtime can supply a
+  // persistent `WeakMap` via `FormattingContextOptions.paragraphCascadeCache`
+  // so unchanged paragraphs don't re-cascade on every keystroke. See the
+  // contract on the option for invalidation semantics.
+  paragraphCascadeCache;
   constructor(doc, opts) {
     this.doc = doc;
     this.opts = opts;
+    this.paragraphCascadeCache = opts.paragraphCascadeCache ?? /* @__PURE__ */ new WeakMap();
     const canonicalTheme = doc.subParts?.canonicalTheme;
     this.theme = opts.themeResolver ?? (canonicalTheme ? new ThemeColorResolver(canonicalTheme) : void 0);
     this.numbering = opts.numberingPrefixResolver ?? createNumberingPrefixResolver(doc.numbering);
@@ -5803,7 +5809,8 @@ function createEditorSurfaceSnapshot(document, _selection, activeStory = { kind:
   const formattingContext = createFormattingContext(document, {
     ...options.revisionMarkupMode ? { revisionMarkupMode: options.revisionMarkupMode } : {},
     ...options.getEffectiveMarkupMode ? { getEffectiveMarkupMode: options.getEffectiveMarkupMode } : {},
-    ...options.authorColorPalette ? { authorColorPalette: options.authorColorPalette } : {}
+    ...options.authorColorPalette ? { authorColorPalette: options.authorColorPalette } : {},
+    ...options.paragraphCascadeCache ? { paragraphCascadeCache: options.paragraphCascadeCache } : {}
   });
   const editableTargetsByBlockPath = options.editableTargetsByBlockPath ?? indexEditableTargetsByBlockPath(document);
   const layoutIdentitiesByBlockPath = options.layoutIdentitiesByBlockPath;

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

@@ -1,4 +1,4 @@
-import { C as CanonicalDocumentEnvelope, e as SelectionSnapshot, i as TransactionMapping } from '../../public-types-BR1SYK2F.cjs';
+import { C as CanonicalDocumentEnvelope, e as SelectionSnapshot, i as TransactionMapping } from '../../public-types-D31xKNGc.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, e as SelectionSnapshot, i as TransactionMapping } from '../../public-types-DXNZVKrS.js';
+import { C as CanonicalDocumentEnvelope, e as SelectionSnapshot, i as TransactionMapping } from '../../public-types-DqYt8GdP.js';
 import 'react';
 import 'yjs';
 import 'y-protocols/awareness';

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

@@ -2,11 +2,11 @@ import {
   insertImage,
   repositionFloatingImage,
   resizeImage
-} from "../../chunk-INLRCC4N.js";
-import "../../chunk-MQ5GAJ54.js";
-import "../../chunk-QTRJLKR2.js";
+} from "../../chunk-4CIHTMCH.js";
+import "../../chunk-BJXSMPHD.js";
+import "../../chunk-TSNK4ECL.js";
 import "../../chunk-QIO6V46H.js";
-import "../../chunk-XBQFDBXE.js";
+import "../../chunk-EZFF6GKF.js";
 import "../../chunk-OYGMRRR7.js";
 import "../../chunk-5KTJKTNE.js";
 import "../../chunk-UFVDIR2C.js";

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

@@ -1,4 +1,4 @@
-import { j as SelectionSnapshot, M as MarginPresetDefinition, k as PageFormatDefinition, R as RuntimeRenderSnapshot } from '../../public-types-BR1SYK2F.cjs';
+import { j as SelectionSnapshot, M as MarginPresetDefinition, k as PageFormatDefinition, R as RuntimeRenderSnapshot } from '../../public-types-D31xKNGc.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 { j as SelectionSnapshot, M as MarginPresetDefinition, k as PageFormatDefinition, R as RuntimeRenderSnapshot } from '../../public-types-DXNZVKrS.js';
+import { j as SelectionSnapshot, M as MarginPresetDefinition, k as PageFormatDefinition, R as RuntimeRenderSnapshot } from '../../public-types-DqYt8GdP.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-BR1SYK2F.cjs';
+import { P as PersistedEditorSnapshot, R as RuntimeRenderSnapshot } from '../../public-types-D31xKNGc.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-DXNZVKrS.js';
+import { P as PersistedEditorSnapshot, R as RuntimeRenderSnapshot } from '../../public-types-DqYt8GdP.js';
 import 'react';
 import 'yjs';
 import 'y-protocols/awareness';

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

@@ -4880,10 +4880,16 @@ var FormattingContextImpl = class {
   // surface-projection calls `resolveParagraphCascade` on the same
   // paragraph via `resolveParagraph` + numbering resolve + marker-rPr;
   // each of those re-walked the style catalog before.
-  paragraphCascadeCache = /* @__PURE__ */ new WeakMap();
+  //
+  // Defaults to a per-context instance, but the runtime can supply a
+  // persistent `WeakMap` via `FormattingContextOptions.paragraphCascadeCache`
+  // so unchanged paragraphs don't re-cascade on every keystroke. See the
+  // contract on the option for invalidation semantics.
+  paragraphCascadeCache;
   constructor(doc, opts) {
     this.doc = doc;
     this.opts = opts;
+    this.paragraphCascadeCache = opts.paragraphCascadeCache ?? /* @__PURE__ */ new WeakMap();
     const canonicalTheme = doc.subParts?.canonicalTheme;
     this.theme = opts.themeResolver ?? (canonicalTheme ? new ThemeColorResolver(canonicalTheme) : void 0);
     this.numbering = opts.numberingPrefixResolver ?? createNumberingPrefixResolver(doc.numbering);
@@ -5367,7 +5373,8 @@ function createEditorSurfaceSnapshot(document, _selection, activeStory = { kind:
   const formattingContext = createFormattingContext(document, {
     ...options.revisionMarkupMode ? { revisionMarkupMode: options.revisionMarkupMode } : {},
     ...options.getEffectiveMarkupMode ? { getEffectiveMarkupMode: options.getEffectiveMarkupMode } : {},
-    ...options.authorColorPalette ? { authorColorPalette: options.authorColorPalette } : {}
+    ...options.authorColorPalette ? { authorColorPalette: options.authorColorPalette } : {},
+    ...options.paragraphCascadeCache ? { paragraphCascadeCache: options.paragraphCascadeCache } : {}
   });
   const editableTargetsByBlockPath = options.editableTargetsByBlockPath ?? indexEditableTargetsByBlockPath(document);
   const layoutIdentitiesByBlockPath = options.layoutIdentitiesByBlockPath;

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

@@ -1,4 +1,4 @@
-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-BR1SYK2F.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-D31xKNGc.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 { 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-DXNZVKrS.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-DqYt8GdP.js';
 import '../../canonical-document-CfZIc-fC.js';
 import 'react';
 import 'yjs';