@beyondwork/docx-react-component 1.0.132 → 1.0.134

package/dist/{chunk-UFPBYJMA.js → chunk-INLRCC4N.js}

@@ -1,10 +1,10 @@
 import {
   TextTransactionError
-} from "./chunk-N5FTU4HZ.js";
+} from "./chunk-MQ5GAJ54.js";
 import {
   replaceParagraphScope,
   resolveParagraphScope
-} from "./chunk-C5LXKR54.js";
+} from "./chunk-QTRJLKR2.js";
 import {
   cloneParagraphProperties,
   cloneStoryUnit,

package/dist/{chunk-N5FTU4HZ.js → chunk-MQ5GAJ54.js}

@@ -10,7 +10,7 @@ import {
 import {
   NO_EDITABLE_TARGETS_INDEX,
   createEditorSurfaceSnapshot
-} from "./chunk-U3UMKA7B.js";
+} from "./chunk-XBQFDBXE.js";
 import {
   createSelectionSnapshot
 } from "./chunk-OYGMRRR7.js";
@@ -24,7 +24,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(
@@ -60,7 +91,8 @@ function applyTextTransaction(document, selection, intent, options) {
       document,
       selection,
       intent,
-      options
+      options,
+      scopeSurfaceCache
     );
     if (targetedTableResult) {
       return targetedTableResult;
@@ -74,7 +106,8 @@ function applyTextTransaction(document, selection, intent, options) {
     const tableStructureRefusal = resolveTargetlessTableStructureInsertRefusal(
       document,
       selection,
-      intent
+      intent,
+      scopeSurfaceCache
     );
     if (tableStructureRefusal) {
       throw new TextTransactionError("unsupported_content", tableStructureRefusal);
@@ -84,7 +117,8 @@ function applyTextTransaction(document, selection, intent, options) {
     document,
     selection,
     intent,
-    options
+    options,
+    scopeSurfaceCache
   );
   if (topLevelParagraphResult) {
     return topLevelParagraphResult;
@@ -93,7 +127,8 @@ function applyTextTransaction(document, selection, intent, options) {
     document,
     selection,
     intent,
-    options
+    options,
+    scopeSurfaceCache
   );
   if (sdtScopedResult) {
     return sdtScopedResult;
@@ -102,7 +137,8 @@ function applyTextTransaction(document, selection, intent, options) {
     document,
     selection,
     intent,
-    options
+    options,
+    scopeSurfaceCache
   );
   if (tableScopedResult) {
     return tableScopedResult;
@@ -155,9 +191,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;
   }
@@ -280,7 +316,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;
   }
@@ -338,8 +378,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;
   }
@@ -391,8 +431,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;
   }
@@ -502,17 +542,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) {
@@ -617,7 +655,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;
   }
@@ -625,9 +663,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;
   }
@@ -641,7 +677,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;
@@ -654,7 +690,8 @@ function resolveTargetedTableParagraphScope(document, selection, target) {
       root,
       document,
       selection,
-      target
+      target,
+      scopeSurfaceCache
     );
     if (targetScope) {
       return targetScope;
@@ -677,9 +714,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];
@@ -743,16 +778,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;
@@ -1207,14 +1240,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) {
@@ -1243,14 +1274,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/{chunk-W2I47J2Q.js → chunk-NJFKPDNG.js}

@@ -1,6 +1,6 @@
 import {
   collectEditableTargetRefs
-} from "./chunk-RYMMKOFI.js";
+} from "./chunk-5KTJKTNE.js";
 
 // src/api/v3/_ux-response.ts
 function emitUxResponse(runtime, res) {
@@ -2110,6 +2110,218 @@ function createScopeFamily(ctx) {
   };
 }
 
+// src/api/v3/ui/lists.ts
+var SUPPORTED_COMMANDS = [
+  "toggle-numbered",
+  "toggle-bulleted",
+  "indent",
+  "outdent",
+  "restart-numbering",
+  "continue-numbering"
+];
+var UNSUPPORTED_COMMANDS = [
+  "create",
+  "attach",
+  "detach",
+  "join",
+  "separate",
+  "split",
+  "set-value",
+  "apply-template",
+  "capture-template",
+  "apply-preset",
+  "set-level-numbering",
+  "set-level-bullet",
+  "set-level-picture-bullet",
+  "set-level-alignment",
+  "set-level-indents",
+  "set-level-trailing-character",
+  "set-level-marker-font",
+  "set-level-text",
+  "set-level-start",
+  "set-level-layout",
+  "convert-to-text",
+  "paste-fragment",
+  "drop-fragment"
+];
+function createListsFamily(ctx) {
+  return {
+    list(filter) {
+      const rows = collectListReadbacks(ctx);
+      const filtered = filter?.storyKey === void 0 ? rows : rows.filter((row) => row.storyKey === filter.storyKey);
+      if (typeof filter?.limit === "number") {
+        return filtered.slice(0, Math.max(0, filter.limit));
+      }
+      return filtered;
+    },
+    get(target) {
+      return findReadback(collectListReadbacks(ctx), target);
+    },
+    previewCommand(target) {
+      const row = findReadback(collectListReadbacks(ctx), target);
+      if (!row) {
+        return {
+          command: target.command,
+          supported: false,
+          blockers: [
+            {
+              command: target.command,
+              enabled: false,
+              reason: "list-target-not-found",
+              ownerLayer: "L10"
+            }
+          ]
+        };
+      }
+      const command = row.commandSupport.find((candidate) => candidate.command === target.command);
+      const blocker = command && !command.enabled ? [command] : [];
+      return {
+        command: target.command,
+        supported: Boolean(command?.enabled),
+        target: row,
+        blockers: blocker,
+        canJoin: row.canJoin,
+        canContinuePrevious: row.canContinuePrevious
+      };
+    }
+  };
+}
+function collectListReadbacks(ctx) {
+  const surface = ctx.handle.getRenderSnapshot().surface;
+  if (!surface) return [];
+  const paragraphs = [];
+  collectParagraphs(surface.blocks, paragraphs);
+  for (const secondary of surface.secondaryStories) {
+    collectParagraphs(secondary.blocks, paragraphs);
+  }
+  const rows = [];
+  for (let index = 0; index < paragraphs.length; index += 1) {
+    const entry = paragraphs[index];
+    if (!entry) continue;
+    const row = rowForParagraph(entry.block, paragraphs, index);
+    if (row) rows.push(row);
+  }
+  return rows;
+}
+function collectParagraphs(blocks, out) {
+  for (const block of blocks) {
+    switch (block.kind) {
+      case "paragraph":
+        out.push({ block });
+        break;
+      case "table":
+        for (const row of block.rows) {
+          for (const cell of row.cells) {
+            collectParagraphs(cell.content, out);
+          }
+        }
+        break;
+      case "sdt_block":
+        collectParagraphs(block.children, out);
+        break;
+      default:
+        break;
+    }
+  }
+}
+function rowForParagraph(block, paragraphs, paragraphIndex) {
+  const target = block.editableTarget;
+  const listAddress = target?.listAddress;
+  const numbering = block.numbering;
+  if (!target || !listAddress || !numbering || !block.resolvedNumbering) return null;
+  const listKind = inferListKind(block.resolvedNumbering);
+  const previousParagraph = paragraphs[paragraphIndex - 1]?.block;
+  const canJoin = Boolean(
+    previousParagraph?.numbering && previousParagraph.numbering.numberingInstanceId !== numbering.numberingInstanceId && inferListKind(previousParagraph.resolvedNumbering) === listKind
+  );
+  const canContinuePrevious = paragraphs.slice(0, paragraphIndex).some(
+    ({ block: previous }) => Boolean(
+      previous.numbering && previous.numbering.numberingInstanceId !== numbering.numberingInstanceId && inferListKind(previous.resolvedNumbering) === listKind
+    )
+  );
+  const actionHandle = `list-action:${listAddress.addressKey}`;
+  const blockers = target.posture.blockers;
+  const commandSupport = commandAvailability({
+    actionHandle,
+    blockers,
+    canContinuePrevious
+  });
+  return {
+    source: "surface-render-snapshot",
+    targetKey: target.targetKey,
+    actionHandle,
+    kind: target.kind,
+    storyKey: target.storyKey,
+    blockPath: target.blockPath,
+    leafPath: target.leafPath,
+    addressKey: listAddress.addressKey,
+    hierarchyPath: [numbering.level],
+    numberingInstanceId: numbering.numberingInstanceId,
+    level: numbering.level,
+    listKind,
+    ...block.resolvedNumbering.text !== void 0 ? { markerText: block.resolvedNumbering.text } : {},
+    ...block.resolvedNumbering.suffix !== void 0 ? { suffix: block.resolvedNumbering.suffix } : {},
+    requestedFormat: block.resolvedNumbering.formatPosture?.requestedFormat ?? block.resolvedNumbering.format,
+    renderedFormat: block.resolvedNumbering.formatPosture?.renderedFormat ?? block.resolvedNumbering.format,
+    ...block.resolvedNumbering.formatPosture ? { formatPosture: block.resolvedNumbering.formatPosture } : {},
+    ...block.resolvedNumbering.markerTextPosture ? { markerTextPosture: block.resolvedNumbering.markerTextPosture } : {},
+    ...block.resolvedNumbering.pictureBulletPosture ? { pictureBulletPosture: block.resolvedNumbering.pictureBulletPosture } : {},
+    authoredTextRange: { from: block.from, to: block.to },
+    editability: target.editability,
+    blockers,
+    supportedCommands: SUPPORTED_COMMANDS,
+    unsupportedCommands: UNSUPPORTED_COMMANDS,
+    commandSupport,
+    canJoin,
+    canContinuePrevious,
+    staleDiscriminators: {
+      paragraphTextHash: target.staleCheck.paragraphTextHash,
+      paragraphTextLength: target.staleCheck.paragraphTextLength,
+      inlineCount: target.staleCheck.inlineCount,
+      listAddressStaleHash: listAddress.resolver?.staleHash
+    },
+    geometry: block.resolvedNumbering.geometry,
+    ...!block.resolvedNumbering.geometry.markerLane ? { geometryUnavailableReason: "marker-geometry-unavailable" } : {}
+  };
+}
+function commandAvailability(input) {
+  const out = [];
+  for (const command of SUPPORTED_COMMANDS) {
+    const blockedReason = input.blockers[0];
+    const continueBlocked = command === "continue-numbering" && !input.canContinuePrevious;
+    out.push({
+      command,
+      enabled: !blockedReason && !continueBlocked,
+      ...!blockedReason && !continueBlocked ? { actionHandle: input.actionHandle } : {},
+      ...blockedReason ? { reason: blockedReason, ownerLayer: "L07" } : {},
+      ...continueBlocked ? { reason: "list-continue-target-missing", ownerLayer: "L07" } : {}
+    });
+  }
+  for (const command of UNSUPPORTED_COMMANDS) {
+    out.push({
+      command,
+      enabled: false,
+      reason: "list-command-unsupported",
+      ownerLayer: "L07"
+    });
+  }
+  return out;
+}
+function findReadback(rows, target) {
+  const addressKey = target.addressKey ?? addressKeyFromActionHandle(target.actionHandle);
+  return rows.find(
+    (row) => target.targetKey !== void 0 && row.targetKey === target.targetKey || addressKey !== void 0 && row.addressKey === addressKey || target.actionHandle !== void 0 && row.actionHandle === target.actionHandle
+  ) ?? null;
+}
+function addressKeyFromActionHandle(actionHandle) {
+  const prefix = "list-action:";
+  return actionHandle?.startsWith(prefix) ? actionHandle.slice(prefix.length) : void 0;
+}
+function inferListKind(resolved) {
+  if (!resolved) return "numbered";
+  return resolved.format === "bullet" || resolved.picBulletId !== void 0 || resolved.pictureBulletPosture !== void 0 ? "bulleted" : "numbered";
+}
+
 // src/api/v3/ui/_create.ts
 function createUiApi(handle, factory) {
   const ctx = createUiApiContext(handle);
@@ -2124,7 +2336,8 @@ function createUiApi(handle, factory) {
     overlays: createOverlaysFamily(ctx),
     chrome: createChromeFamily(ctx),
     debug: createDebugFamily(ctx),
-    scope: createScopeFamily(ctx)
+    scope: createScopeFamily(ctx),
+    lists: createListsFamily(ctx)
   };
   Object.freeze(api.session);
   Object.freeze(api.surface);
@@ -2133,6 +2346,7 @@ function createUiApi(handle, factory) {
   Object.freeze(api.chrome);
   Object.freeze(api.debug);
   Object.freeze(api.scope);
+  Object.freeze(api.lists);
   return Object.freeze(api);
 }