@beyondwork/docx-react-component 1.0.129 → 1.0.130

package/dist/api/v3.d.cts

@@ -1,5 +1,5 @@
-import { u as MockPayload, A as ApiStatus, U as UxIntent, v as RuntimeApiHandle, w as UiControllerFactory, x as ApiV3Ui } from '../public-types-B5CRoR6f.cjs';
-export { y as AgentMetadata, z as AiPe2EvidenceOptions, B as AiPe2GraphOracleReference, D as AiPe2OracleEvidence, F as AiPe2OracleEvidenceProvider, G as AiPe2OracleEvidenceProviderInput, H as AiPe2OracleVerdict, J as ApiV3, K as ApiV3FnMetadata, N as ApiV3UiChrome, O as ApiV3UiDebug, Q as ApiV3UiOverlays, V as ApiV3UiSession, W as ApiV3UiSurface, X as ApiV3UiViewport, Y as BroadcastsVia, Z as ChromeDebugMode, _ as ChromeDocumentMode, $ as ChromeHostPosture, a0 as ChromeMarkupDisplay, a1 as ChromePosture, a2 as ChromeReviewMode, a3 as ChromeSurface, a4 as ChromeSurfaceKind, a5 as CreateApiV3Opts, a6 as DebugAttachment, a7 as DebugSession, a8 as GeometryRect, a9 as LiveEvidence, aa as MockShape, ab as OverlayAnchorQuery, ac as PersistsTo, ad as ScrollTarget, ae as ScrollTargetBehavior, af as SelectionRangeInput, ag as SourceLayer, ah as StateClass, ai as SubscriptionShape, aj as UiBinding, ak as UiController, al as UiControllerKind, am as UiListener, an as UiUnsubscribe, ao as ViewportState, ap as createApiV3, aq as validateApiV3Metadata } from '../public-types-B5CRoR6f.cjs';
+import { u as MockPayload, A as ApiStatus, U as UxIntent, v as RuntimeApiHandle, w as UiControllerFactory, x as ApiV3Ui } from '../public-types-gvubspUI.cjs';
+export { y as AgentMetadata, z as AiPe2EvidenceOptions, B as AiPe2GraphOracleReference, D as AiPe2OracleEvidence, F as AiPe2OracleEvidenceProvider, G as AiPe2OracleEvidenceProviderInput, H as AiPe2OracleVerdict, J as ApiV3, K as ApiV3FnMetadata, N as ApiV3UiChrome, O as ApiV3UiDebug, Q as ApiV3UiOverlays, V as ApiV3UiSession, W as ApiV3UiSurface, X as ApiV3UiViewport, Y as BroadcastsVia, Z as ChromeDebugMode, _ as ChromeDocumentMode, $ as ChromeHostPosture, a0 as ChromeMarkupDisplay, a1 as ChromePosture, a2 as ChromeReviewMode, a3 as ChromeSurface, a4 as ChromeSurfaceKind, a5 as CreateApiV3Opts, a6 as DebugAttachment, a7 as DebugSession, a8 as GeometryRect, a9 as LiveEvidence, aa as MockShape, ab as OverlayAnchorQuery, ac as PersistsTo, ad as ScrollTarget, ae as ScrollTargetBehavior, af as SelectionRangeInput, ag as SourceLayer, ah as StateClass, ai as SubscriptionShape, aj as UiBinding, ak as UiController, al as UiControllerKind, am as UiListener, an as UiUnsubscribe, ao as ViewportState, ap as createApiV3, aq as validateApiV3Metadata } from '../public-types-gvubspUI.cjs';
 import 'react';
 import 'yjs';
 import 'y-protocols/awareness';

package/dist/api/v3.d.ts

@@ -1,5 +1,5 @@
-import { u as MockPayload, A as ApiStatus, U as UxIntent, v as RuntimeApiHandle, w as UiControllerFactory, x as ApiV3Ui } from '../public-types-p9b8rfy8.js';
-export { y as AgentMetadata, z as AiPe2EvidenceOptions, B as AiPe2GraphOracleReference, D as AiPe2OracleEvidence, F as AiPe2OracleEvidenceProvider, G as AiPe2OracleEvidenceProviderInput, H as AiPe2OracleVerdict, J as ApiV3, K as ApiV3FnMetadata, N as ApiV3UiChrome, O as ApiV3UiDebug, Q as ApiV3UiOverlays, V as ApiV3UiSession, W as ApiV3UiSurface, X as ApiV3UiViewport, Y as BroadcastsVia, Z as ChromeDebugMode, _ as ChromeDocumentMode, $ as ChromeHostPosture, a0 as ChromeMarkupDisplay, a1 as ChromePosture, a2 as ChromeReviewMode, a3 as ChromeSurface, a4 as ChromeSurfaceKind, a5 as CreateApiV3Opts, a6 as DebugAttachment, a7 as DebugSession, a8 as GeometryRect, a9 as LiveEvidence, aa as MockShape, ab as OverlayAnchorQuery, ac as PersistsTo, ad as ScrollTarget, ae as ScrollTargetBehavior, af as SelectionRangeInput, ag as SourceLayer, ah as StateClass, ai as SubscriptionShape, aj as UiBinding, ak as UiController, al as UiControllerKind, am as UiListener, an as UiUnsubscribe, ao as ViewportState, ap as createApiV3, aq as validateApiV3Metadata } from '../public-types-p9b8rfy8.js';
+import { u as MockPayload, A as ApiStatus, U as UxIntent, v as RuntimeApiHandle, w as UiControllerFactory, x as ApiV3Ui } from '../public-types-DyqnxxO9.js';
+export { y as AgentMetadata, z as AiPe2EvidenceOptions, B as AiPe2GraphOracleReference, D as AiPe2OracleEvidence, F as AiPe2OracleEvidenceProvider, G as AiPe2OracleEvidenceProviderInput, H as AiPe2OracleVerdict, J as ApiV3, K as ApiV3FnMetadata, N as ApiV3UiChrome, O as ApiV3UiDebug, Q as ApiV3UiOverlays, V as ApiV3UiSession, W as ApiV3UiSurface, X as ApiV3UiViewport, Y as BroadcastsVia, Z as ChromeDebugMode, _ as ChromeDocumentMode, $ as ChromeHostPosture, a0 as ChromeMarkupDisplay, a1 as ChromePosture, a2 as ChromeReviewMode, a3 as ChromeSurface, a4 as ChromeSurfaceKind, a5 as CreateApiV3Opts, a6 as DebugAttachment, a7 as DebugSession, a8 as GeometryRect, a9 as LiveEvidence, aa as MockShape, ab as OverlayAnchorQuery, ac as PersistsTo, ad as ScrollTarget, ae as ScrollTargetBehavior, af as SelectionRangeInput, ag as SourceLayer, ah as StateClass, ai as SubscriptionShape, aj as UiBinding, ak as UiController, al as UiControllerKind, am as UiListener, an as UiUnsubscribe, ao as ViewportState, ap as createApiV3, aq as validateApiV3Metadata } from '../public-types-DyqnxxO9.js';
 import 'react';
 import 'yjs';
 import 'y-protocols/awareness';

package/dist/api/v3.js

@@ -5,26 +5,26 @@ import {
   mockId,
   mockPayload,
   validateApiV3Metadata
-} from "../chunk-XQCAMKIQ.js";
-import "../chunk-SKPTKQHF.js";
+} from "../chunk-WZDKNF37.js";
+import "../chunk-7G5GR3VV.js";
 import "../chunk-C2LWJ4CZ.js";
 import {
   createUiApi,
   emitUxResponse
-} from "../chunk-YIYM4ZAP.js";
-import "../chunk-RMRTQGW3.js";
-import "../chunk-KFCQYZXR.js";
+} from "../chunk-CI2TD3T4.js";
+import "../chunk-THVM6EP5.js";
+import "../chunk-OVLZQ6FZ.js";
 import "../chunk-QIO6V46H.js";
-import "../chunk-HUIHBBAQ.js";
+import "../chunk-A3GSNB4G.js";
 import "../chunk-OYGMRRR7.js";
-import "../chunk-63FYIGCT.js";
-import "../chunk-XMHSGPLN.js";
-import "../chunk-JJGVE5J7.js";
-import "../chunk-Q3QYGKFE.js";
+import "../chunk-DGA7M77X.js";
+import "../chunk-VRKK2CSZ.js";
+import "../chunk-4YCWECLZ.js";
+import "../chunk-M7YRJX6V.js";
 import "../chunk-4BJ6K26R.js";
-import "../chunk-5DGKFNQT.js";
-import "../chunk-OL2UEHRP.js";
-import "../chunk-EB6M3GE6.js";
+import "../chunk-A66ZVUAT.js";
+import "../chunk-WUDSNHWF.js";
+import "../chunk-FM4K4XFJ.js";
 import "../chunk-IHE7YOAY.js";
 import "../chunk-MT37IIGN.js";
 import "../chunk-UTL65BUI.js";

package/dist/{chunk-OTQIW2TC.js → chunk-35RHOE6I.js}

@@ -3,17 +3,17 @@ import {
   PAGE_STACK_GAP_PX,
   defaultChromeReservations,
   resolveDefaultZoom
-} from "./chunk-RMRTQGW3.js";
+} from "./chunk-THVM6EP5.js";
 import {
   storyTargetKey
-} from "./chunk-HUIHBBAQ.js";
+} from "./chunk-A3GSNB4G.js";
 import {
   MAIN_STORY_KEY,
   collectCanonicalLayoutInputs,
   collectStoryBlockContexts,
   createHeaderFooterStoryKey,
   createNoteStoryKey
-} from "./chunk-5DGKFNQT.js";
+} from "./chunk-A66ZVUAT.js";
 import {
   MAIN_STORY_TARGET
 } from "./chunk-M2HUK3KF.js";
@@ -266,6 +266,76 @@ function diffRenderFrames(prev, next) {
   }
   return { addedPages, removedPages, unchangedPages, changedPages };
 }
+function createPagePatchPlan(prev, next, diff = diffRenderFrames(prev, next), options = {}) {
+  const prevByIndex = indexPagesByIndex(prev?.pages ?? []);
+  const nextByIndex = indexPagesByIndex(next.pages);
+  const addedPages = diff.addedPages.map(
+    (pageIndex) => pageIdForIndex(nextByIndex, pageIndex)
+  );
+  const removedPages = diff.removedPages.map(
+    (pageIndex) => pageIdForIndex(prevByIndex, pageIndex)
+  );
+  const unchangedPages = diff.unchangedPages.map(
+    (pageIndex) => pageIdForIndex(nextByIndex, pageIndex)
+  );
+  const changedPages = diff.changedPages.map(
+    (entry) => createPagePatchEntry(entry, pageIdForIndex(nextByIndex, entry.pageIndex), options)
+  );
+  return {
+    layoutRevision: options.layoutRevision ?? next.revision,
+    geometryRevision: options.geometryRevision ?? next.revision,
+    addedPages,
+    removedPages,
+    unchangedPages,
+    changedPages,
+    mountChanges: resolveMountChanges({
+      addedPages,
+      removedPages,
+      mountedPageIds: options.mountedPageIds,
+      requestedMountPageIds: options.requestedMountPageIds
+    })
+  };
+}
+function createPagePatchEntry(entry, pageId, options) {
+  const regionChanges = entry.regions.map((region) => region.kind);
+  const fragmentChanges = uniqueStrings(
+    entry.regions.flatMap((region) => region.changedBlockIds)
+  );
+  const overlayLaneChanges = !entry.pageFrameChanged && entry.regions.length === 0 ? ["chrome-reservations"] : [];
+  return {
+    pageId,
+    pageIndex: entry.pageIndex,
+    frameChanged: entry.pageFrameChanged === true,
+    regionChanges,
+    fragmentChanges,
+    lineBoxChanges: fragmentChanges,
+    overlayLaneChanges,
+    reason: options.reason ?? (overlayLaneChanges.length > 0 ? "overlay" : "layout")
+  };
+}
+function resolveMountChanges(input) {
+  if (!input.mountedPageIds || !input.requestedMountPageIds) {
+    return {
+      mountPageIds: input.addedPages,
+      unmountPageIds: input.removedPages
+    };
+  }
+  const mounted = new Set(input.mountedPageIds);
+  const requested = new Set(input.requestedMountPageIds);
+  return {
+    mountPageIds: input.requestedMountPageIds.filter((pageId) => !mounted.has(pageId)),
+    unmountPageIds: input.mountedPageIds.filter((pageId) => !requested.has(pageId))
+  };
+}
+function indexPagesByIndex(pages) {
+  return new Map(pages.map((page) => [page.page.pageIndex, page]));
+}
+function pageIdForIndex(pages, pageIndex) {
+  return pages.get(pageIndex)?.page.pageId ?? `page:${pageIndex}`;
+}
+function uniqueStrings(values) {
+  return [...new Set(values)];
+}
 function diffPage(prev, next, prevIndex, nextIndex) {
   const changed = [];
   const bodyChanges = diffRegion(prev.regions.body, next.regions.body, prevIndex, nextIndex);
@@ -486,10 +556,12 @@ function createRenderKernel(input) {
         emit({ kind: "frame_built", revision: frame.revision, reason: "full" });
         const diffT0 = typeof performance !== "undefined" ? performance.now() : 0;
         const diff = diffRenderFrames(lastEmittedFrame, frame);
+        const patchPlan = createPagePatchPlan(lastEmittedFrame, frame, diff);
+        recordPagePatchPlanTelemetry(patchPlan);
         if (diffT0 > 0) {
           recordPerfSample("render.frame_diff", performance.now() - diffT0);
         }
-        emit({ kind: "frame_diff", revision: frame.revision, diff });
+        emit({ kind: "frame_diff", revision: frame.revision, diff, patchPlan });
         lastEmittedFrame = frame;
       }
       return frame;
@@ -512,6 +584,35 @@ function createRenderKernel(input) {
     }
   };
 }
+function recordPagePatchPlanTelemetry(plan) {
+  incrementInvalidationCounter(
+    "pageRender.patch.addedPages",
+    plan.addedPages.length
+  );
+  incrementInvalidationCounter(
+    "pageRender.patch.removedPages",
+    plan.removedPages.length
+  );
+  incrementInvalidationCounter(
+    "pageRender.patch.unchangedPages",
+    plan.unchangedPages.length
+  );
+  incrementInvalidationCounter(
+    "pageRender.patch.changedFragments",
+    plan.changedPages.reduce(
+      (total, page) => total + page.fragmentChanges.length,
+      0
+    )
+  );
+  incrementInvalidationCounter(
+    "pageRender.patch.mountedPages",
+    plan.mountChanges.mountPageIds.length
+  );
+  incrementInvalidationCounter(
+    "pageRender.patch.unmountedPages",
+    plan.mountChanges.unmountPageIds.length
+  );
+}
 function buildPage(page, topPx, zoom, activeStory, facet) {
   const layout = page.layout;
   const widthPx = layout.pageWidth * zoom.pxPerTwip;

package/dist/{chunk-PGKUJZXV.js → chunk-3YCQM2RV.js}

@@ -2,7 +2,7 @@ import {
   incrementInvalidationCounter,
   recordPerfSample,
   resolvePageOverlayRectsFromGeometry
-} from "./chunk-OTQIW2TC.js";
+} from "./chunk-35RHOE6I.js";
 import {
   buildPageAnchorAttributes,
   buildPageAnchorSelector,
@@ -10,7 +10,7 @@ import {
   resolveChromePreset,
   resolveChromePresetOptions,
   resolveChromeVisibilityForPreset
-} from "./chunk-YIYM4ZAP.js";
+} from "./chunk-CI2TD3T4.js";
 import {
   DEFAULT_PAGE_ESTIMATE_PX_PER_TWIP,
   DEFAULT_PX_PER_TWIP,
@@ -20,19 +20,19 @@ import {
   findPageForOffset,
   getUsableColumnWidth,
   sanitizeMarkdown
-} from "./chunk-RMRTQGW3.js";
+} from "./chunk-THVM6EP5.js";
 import {
   createCanvasBackend
-} from "./chunk-KFCQYZXR.js";
+} from "./chunk-OVLZQ6FZ.js";
 import {
   storyTargetKey
-} from "./chunk-HUIHBBAQ.js";
+} from "./chunk-A3GSNB4G.js";
 import {
   EMU_PER_INCH,
   EMU_PER_PX,
   ROTATION_UNITS_PER_DEGREE,
   TWIPS_PER_PX
-} from "./chunk-5DGKFNQT.js";
+} from "./chunk-A66ZVUAT.js";
 import {
   createPublicNodeAnchor,
   createPublicRangeAnchor

package/dist/{chunk-JJGVE5J7.js → chunk-4YCWECLZ.js}

@@ -1,6 +1,6 @@
 import {
   classifyFieldInstruction
-} from "./chunk-Q3QYGKFE.js";
+} from "./chunk-M7YRJX6V.js";
 import {
   describeOpaqueFragment,
   describeStructuredWrapperBlock,

package/dist/{chunk-EZKJXIPH.js → chunk-6TBLDBCL.js}

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

package/dist/{chunk-SKPTKQHF.js → chunk-7G5GR3VV.js}

@@ -7,30 +7,31 @@ import {
   resolveSectionForStoryTarget,
   searchSecondaryStories,
   searchSurfaceBlocks
-} from "./chunk-RMRTQGW3.js";
+} from "./chunk-THVM6EP5.js";
 import {
   createEditorSurfaceSnapshot,
   createFormattingContext,
   resolveTableStyleResolution
-} from "./chunk-HUIHBBAQ.js";
+} from "./chunk-A3GSNB4G.js";
 import {
   createSelectionSnapshot
 } from "./chunk-OYGMRRR7.js";
 import {
   normalizeParsedTextDocument
-} from "./chunk-JJGVE5J7.js";
+} from "./chunk-4YCWECLZ.js";
 import {
   buildFieldRegistry,
   parseMainDocumentXml,
   parseTocLevelRange
-} from "./chunk-Q3QYGKFE.js";
+} from "./chunk-M7YRJX6V.js";
 import {
   collectEditableTargetRefs,
+  collectLayoutInputIdentities,
   validateEditableTargetRef
-} from "./chunk-5DGKFNQT.js";
+} from "./chunk-A66ZVUAT.js";
 import {
   serializeMainDocument
-} from "./chunk-EB6M3GE6.js";
+} from "./chunk-FM4K4XFJ.js";
 import {
   findOpaqueFragmentsIntersectingRange
 } from "./chunk-UFVDIR2C.js";
@@ -4056,6 +4057,19 @@ function paragraphHasBookmarkId(paragraph, bookmarkId) {
 function commandActionHandleForAddress(commandFamily, address) {
   return address ? `scope-command:${commandFamily}:${address.addressKey}` : void 0;
 }
+function layoutIdentityIndexes(document) {
+  const byTargetKey = /* @__PURE__ */ new Map();
+  const byStoryBlockPath = /* @__PURE__ */ new Map();
+  for (const identity of collectLayoutInputIdentities(document)) {
+    byStoryBlockPath.set(`${identity.storyKey}:${identity.blockPath}`, identity);
+    const targetKey = identity.editableTargetRef?.targetKey;
+    if (targetKey) byTargetKey.set(targetKey, identity);
+  }
+  return { byTargetKey, byStoryBlockPath };
+}
+function layoutIdentityForTarget(target, indexes) {
+  return indexes.byTargetKey.get(target.targetKey) ?? indexes.byStoryBlockPath.get(`${target.storyKey}:${target.blockPath}`);
+}
 function withCommandAction(evidence, target, canonicalAddress = target.canonicalAddress) {
   if (evidence.status !== "supported" || !canonicalAddress) return evidence;
   return {
@@ -4067,6 +4081,24 @@ function withCommandAction(evidence, target, canonicalAddress = target.canonical
 function commandAddressForTarget(target, scopeKind) {
   return scopeKind === "list-item" && target.listAddress !== void 0 ? target.listAddress : target.canonicalAddress;
 }
+function freezeCommandIntents(intents) {
+  return Object.freeze([...new Set(intents)]);
+}
+function relatedListActionHandlesForTarget(target, primaryAddress) {
+  if (target.commandFamily !== "text-leaf" || target.listAddress === void 0 || !LIST_TEXT_TARGET_KINDS2.has(target.kind) || target.listAddress.addressKey === primaryAddress?.addressKey) {
+    return void 0;
+  }
+  const actionHandle = commandActionHandleForAddress(target.commandFamily, target.listAddress);
+  if (!actionHandle) return void 0;
+  return Object.freeze([
+    {
+      actionHandle,
+      canonicalAddress: target.listAddress,
+      intents: freezeCommandIntents(["list-text-edit", "list-structure-action"]),
+      reason: "l07:list-address-target-supported"
+    }
+  ]);
+}
 function runtimeTextCommandEvidence(target, workflowBlockers) {
   const shapeIssues = validateEditableTargetRef(target);
   if (shapeIssues.length > 0) {
@@ -4166,13 +4198,16 @@ function runtimeCommandEvidence(target, workflowBlockers, textCommand, scopeKind
     };
   }
   if (target.commandFamily === "text-leaf") {
+    const canonicalAddress = commandAddressForTarget(target, scopeKind);
+    const relatedActionHandles = relatedListActionHandlesForTarget(target, canonicalAddress);
     return withCommandAction({
       status: textCommand.status,
       commandFamily: target.commandFamily,
       intents: commandIntentsForTarget(target, scopeKind),
       reason: textCommand.reason,
+      ...relatedActionHandles !== void 0 ? { relatedActionHandles } : {},
       ...textCommand.blockers ? { blockers: textCommand.blockers } : {}
-    }, target, commandAddressForTarget(target, scopeKind));
+    }, target, canonicalAddress);
   }
   if (target.commandFamily === "comment-revision") {
     const isOpen = target.review?.status === "open";
@@ -4497,19 +4532,21 @@ function commandIntentsForTarget(target, scopeKind) {
       if (target.kind === "hyperlink-text") {
         return Object.freeze(["text-leaf-edit", "hyperlink-display-text-edit"]);
       }
-      if (target.table?.operationScope === "text") {
-        return Object.freeze([
-          "text-leaf-edit",
-          "table-text-paste",
-          "table-text-drop",
-          "table-structured-fragment-paste",
-          "table-structured-fragment-drop"
-        ]);
-      }
-      if (scopeKind === "list-item" && LIST_TEXT_TARGET_KINDS2.has(target.kind)) {
-        return Object.freeze(["text-leaf-edit", "list-text-edit", "list-structure-action"]);
+      {
+        const intents = ["text-leaf-edit"];
+        if (target.table?.operationScope === "text") {
+          intents.push(
+            "table-text-paste",
+            "table-text-drop",
+            "table-structured-fragment-paste",
+            "table-structured-fragment-drop"
+          );
+        }
+        if ((scopeKind === "list-item" || target.listAddress !== void 0) && LIST_TEXT_TARGET_KINDS2.has(target.kind)) {
+          intents.push("list-text-edit", "list-structure-action");
+        }
+        return freezeCommandIntents(intents);
       }
-      return Object.freeze(["text-leaf-edit"]);
     case "field":
       return Object.freeze(
         target.field?.fieldFamily === "TOC" ? ["toc-refresh", "field-update"] : ["field-update"]
@@ -4656,7 +4693,7 @@ function readbackForTarget(document, target, runtimeTextCommand) {
     source: "canonical-text-leaf"
   };
 }
-function projectTarget(document, target, relation, workflowBlockers, scopeKind) {
+function projectTarget(document, target, relation, workflowBlockers, scopeKind, layoutIdentity) {
   const runtimeTextCommand = runtimeTextCommandEvidence(target, workflowBlockers);
   const readback = readbackForTarget(document, target, runtimeTextCommand);
   return {
@@ -4677,6 +4714,7 @@ function projectTarget(document, target, relation, workflowBlockers, scopeKind)
     ...target.table ? { table: target.table } : {},
     ...target.editableOwner ? { editableOwner: target.editableOwner } : {},
     ...target.canonicalAddress ? { canonicalAddress: target.canonicalAddress } : {},
+    ...layoutIdentity ? { layoutIdentity } : {},
     staleCheck: target.staleCheck,
     posture: target.posture,
     ...workflowBlockers.length > 0 ? { workflowBlockers: Object.freeze([...workflowBlockers]) } : {},
@@ -4692,7 +4730,7 @@ function deriveScopeEditableTargetEvidence(document, scope, entry, options = {})
     facts.push(projectWorkflowBlockerFact(fact));
     factsByTargetKey.set(fact.targetKey, facts);
   }
-  const entries = collectEditableTargetRefs(document, options.editableTargetCache).map((target) => {
+  const relatedTargets = collectEditableTargetRefs(document, options.editableTargetCache).map((target) => {
     const relation = relationForTarget(target, scope, entry);
     if (!relation) return null;
     const workflowBlockers = Object.freeze(
@@ -4700,8 +4738,19 @@ function deriveScopeEditableTargetEvidence(document, scope, entry, options = {})
         (left, right) => left.source.localeCompare(right.source) || left.blocker.localeCompare(right.blocker) || left.refusalId.localeCompare(right.refusalId)
       )
     );
-    return projectTarget(document, target, relation, workflowBlockers, scope.kind);
-  }).filter((target) => target !== null).sort((a, b) => a.targetKey.localeCompare(b.targetKey));
+    return { target, relation, workflowBlockers };
+  }).filter((target) => target !== null);
+  const layoutIndexes = relatedTargets.length > 0 ? layoutIdentityIndexes(document) : void 0;
+  const entries = relatedTargets.map(
+    ({ target, relation, workflowBlockers }) => projectTarget(
+      document,
+      target,
+      relation,
+      workflowBlockers,
+      scope.kind,
+      layoutIndexes ? layoutIdentityForTarget(target, layoutIndexes) : void 0
+    )
+  ).sort((a, b) => a.targetKey.localeCompare(b.targetKey));
   const blockers = /* @__PURE__ */ new Set();
   let supportedTextTargetCount = 0;
   for (const target of entries) {
@@ -4765,15 +4814,65 @@ function projectEntry2(entry) {
     ...entry.posture.preserveOnly ? { preserveOnly: true } : {}
   };
 }
+function familyKindFor(entry) {
+  return entry.objectKind ?? "unknown";
+}
+function familyStatusFor(entries) {
+  if (entries.some((entry) => entry.runtimeCommand.status === "supported")) {
+    return "supported";
+  }
+  if (entries.length > 0 && entries.every(
+    (entry) => entry.preserveOnly === true || entry.commandFamily === "preserve-only-refusal"
+  )) {
+    return "preserve-only";
+  }
+  return "blocked";
+}
+function summarizeFamily(objectKind, entries) {
+  const sortedEntries = [...entries].sort(
+    (left, right) => left.targetKey.localeCompare(right.targetKey)
+  );
+  const preserveOnly = sortedEntries.some((entry) => entry.preserveOnly === true);
+  return {
+    objectKind,
+    status: familyStatusFor(sortedEntries),
+    count: sortedEntries.length,
+    targetKeys: unique(sortedEntries.map((entry) => entry.targetKey)),
+    relations: unique(sortedEntries.map((entry) => entry.relation)),
+    commandFamilies: unique(sortedEntries.map((entry) => entry.commandFamily)),
+    runtimeIntents: unique(
+      sortedEntries.flatMap((entry) => [...entry.runtimeCommand.intents])
+    ),
+    blockers: unique(sortedEntries.flatMap((entry) => [...entry.blockers])),
+    ...preserveOnly ? { preserveOnly: true } : {}
+  };
+}
+function summarizeFamilies(entries) {
+  const byFamily = /* @__PURE__ */ new Map();
+  for (const entry of entries) {
+    const objectKind = familyKindFor(entry);
+    const bucket = byFamily.get(objectKind);
+    if (bucket) {
+      bucket.push(entry);
+      continue;
+    }
+    byFamily.set(objectKind, [entry]);
+  }
+  return Object.freeze(
+    [...byFamily.entries()].map(([objectKind, familyEntries]) => summarizeFamily(objectKind, familyEntries)).sort((left, right) => left.objectKind.localeCompare(right.objectKind))
+  );
+}
 function deriveScopeObjectEvidence(editableTargets) {
   const entries = Object.freeze(
     [...editableTargets?.entries ?? []].filter(isObjectTarget).map(projectEntry2).sort((left, right) => left.targetKey.localeCompare(right.targetKey))
   );
   const blockers = unique(entries.flatMap((entry) => [...entry.blockers]));
+  const families = summarizeFamilies(entries);
   return {
     status: entries.length > 0 ? "present" : "none",
     count: entries.length,
     blockers,
+    families,
     entries
   };
 }

package/dist/{chunk-HUIHBBAQ.js → chunk-A3GSNB4G.js}

@@ -4,7 +4,7 @@ import {
   MAIN_STORY_KEY,
   collectCanonicalFieldRegionIdentities,
   collectEditableTargetRefs
-} from "./chunk-5DGKFNQT.js";
+} from "./chunk-A66ZVUAT.js";
 import {
   describeOpaqueFragment,
   describeStructuredWrapperBlock,
@@ -3067,6 +3067,7 @@ function createEditorSurfaceSnapshot(document, _selection, activeStory = { kind:
     ...options.authorColorPalette ? { authorColorPalette: options.authorColorPalette } : {}
   });
   const editableTargetsByBlockPath = options.editableTargetsByBlockPath ?? indexEditableTargetsByBlockPath(document);
+  const layoutIdentitiesByBlockPath = options.layoutIdentitiesByBlockPath;
   const activeStoryBlockPathBase = getActiveStoryBlockPathBase(document, activeStory);
   chartModelStore.beginBuildPass(document);
   const unsupportedNumberingFormatsSeen = options.emitFormattingTelemetry ? /* @__PURE__ */ new Set() : null;
@@ -3090,6 +3091,7 @@ function createEditorSurfaceSnapshot(document, _selection, activeStory = { kind:
       activeStory.kind !== "main",
       !isInViewport,
       editableTargetsByBlockPath,
+      layoutIdentitiesByBlockPath,
       `${activeStoryBlockPathBase}/block[${index}]`
     );
     if (isInViewport) {
@@ -3156,7 +3158,7 @@ function isIndexInAnyRange(index, ranges) {
   }
   return false;
 }
-function createSurfaceBlock(block, document, cursor, counters, formattingContext, promoteSecondaryStoryTextBoxes, cullBuild = false, editableTargetsByBlockPath = EMPTY_EDITABLE_TARGETS_BY_BLOCK_PATH, blockPath) {
+function createSurfaceBlock(block, document, cursor, counters, formattingContext, promoteSecondaryStoryTextBoxes, cullBuild = false, editableTargetsByBlockPath = EMPTY_EDITABLE_TARGETS_BY_BLOCK_PATH, layoutIdentitiesByBlockPath, blockPath) {
   if (block.type === "opaque_block") {
     const fragment = getOpaqueFragment(document.preservation, block.fragmentId);
     const descriptor = fragment ? describeOpaqueFragment(fragment) : null;
@@ -3193,6 +3195,7 @@ function createSurfaceBlock(block, document, cursor, counters, formattingContext
       promoteSecondaryStoryTextBoxes,
       cullBuild,
       editableTargetsByBlockPath,
+      layoutIdentitiesByBlockPath,
       blockPath
     );
   }
@@ -3233,6 +3236,7 @@ function createSurfaceBlock(block, document, cursor, counters, formattingContext
       promoteSecondaryStoryTextBoxes,
       cullBuild,
       editableTargetsByBlockPath,
+      layoutIdentitiesByBlockPath,
       blockPath
     );
   }
@@ -3315,10 +3319,11 @@ function createSurfaceBlock(block, document, cursor, counters, formattingContext
     cullBuild,
     editableTargetsByBlockPath,
     blockPath,
-    blockPath !== void 0 ? editableTargetsByBlockPath.get(blockPath) : void 0
+    blockPath !== void 0 ? editableTargetsByBlockPath.get(blockPath) : void 0,
+    blockPath !== void 0 ? layoutIdentitiesByBlockPath?.get(blockPath) : void 0
   );
 }
-function createTableBlock(tableIndex, table, document, cursor, counters, formattingContext, promoteSecondaryStoryTextBoxes, cullBuild = false, editableTargetsByBlockPath = EMPTY_EDITABLE_TARGETS_BY_BLOCK_PATH, tablePath) {
+function createTableBlock(tableIndex, table, document, cursor, counters, formattingContext, promoteSecondaryStoryTextBoxes, cullBuild = false, editableTargetsByBlockPath = EMPTY_EDITABLE_TARGETS_BY_BLOCK_PATH, layoutIdentitiesByBlockPath, tablePath) {
   const lockedFragmentIds = [];
   let innerCursor = cursor;
   if (cullBuild) {
@@ -3335,6 +3340,7 @@ function createTableBlock(tableIndex, table, document, cursor, counters, formatt
             promoteSecondaryStoryTextBoxes,
             true,
             editableTargetsByBlockPath,
+            layoutIdentitiesByBlockPath,
             tablePath !== void 0 ? `${tablePath}/row[${rowIndex}]/cell[${cellIndex}]/block[${childIndex}]` : void 0
           );
           lockedFragmentIds.push(...result.lockedFragmentIds);
@@ -3350,6 +3356,7 @@ function createTableBlock(tableIndex, table, document, cursor, counters, formatt
         to: innerCursor,
         styleId: table.styleId,
         ...table.sourceRef !== void 0 ? { sourceRef: table.sourceRef } : {},
+        ...tablePath !== void 0 && layoutIdentitiesByBlockPath?.get(tablePath) !== void 0 ? { layoutIdentity: layoutIdentitiesByBlockPath.get(tablePath) } : {},
         gridColumns: table.gridColumns,
         rows: []
       },
@@ -3387,6 +3394,7 @@ function createTableBlock(tableIndex, table, document, cursor, counters, formatt
           promoteSecondaryStoryTextBoxes,
           cullBuild,
           editableTargetsByBlockPath,
+          layoutIdentitiesByBlockPath,
           tablePath !== void 0 ? `${tablePath}/row[${rowIndex}]/cell[${cellIndex}]/block[${childIndex}]` : void 0
         );
         cellContent.push(result.block);
@@ -3475,6 +3483,7 @@ function createTableBlock(tableIndex, table, document, cursor, counters, formatt
       to: innerCursor,
       styleId: table.styleId,
       ...table.sourceRef !== void 0 ? { sourceRef: table.sourceRef } : {},
+      ...tablePath !== void 0 && layoutIdentitiesByBlockPath?.get(tablePath) !== void 0 ? { layoutIdentity: layoutIdentitiesByBlockPath.get(tablePath) } : {},
       gridColumns: table.gridColumns,
       ...gridColumnsRelative ? { gridColumnsRelative } : {},
       ...resolvedTable.table?.alignment ? { alignment: resolvedTable.table.alignment } : {},
@@ -3662,7 +3671,7 @@ function resolveCellBorderStyles(borders, tableBorders, position) {
   if (left) result.borderLeft = left;
   return result;
 }
-function createSdtBlock(sdtIndex, block, document, cursor, counters, formattingContext, promoteSecondaryStoryTextBoxes, cullBuild = false, editableTargetsByBlockPath = EMPTY_EDITABLE_TARGETS_BY_BLOCK_PATH, sdtPath) {
+function createSdtBlock(sdtIndex, block, document, cursor, counters, formattingContext, promoteSecondaryStoryTextBoxes, cullBuild = false, editableTargetsByBlockPath = EMPTY_EDITABLE_TARGETS_BY_BLOCK_PATH, layoutIdentitiesByBlockPath, sdtPath) {
   const children = [];
   const lockedFragmentIds = [];
   let innerCursor = cursor;
@@ -3679,6 +3688,7 @@ function createSdtBlock(sdtIndex, block, document, cursor, counters, formattingC
       promoteSecondaryStoryTextBoxes,
       cullBuild,
       editableTargetsByBlockPath,
+      layoutIdentitiesByBlockPath,
       sdtPath !== void 0 ? `${sdtPath}/block[${childIndex}]` : void 0
     );
     children.push(result.block);
@@ -3721,7 +3731,7 @@ function getRecursableSdtBlockedReasonCode(block) {
   ].filter(Boolean).join(" ").toLowerCase();
   return searchText.includes("table of contents") || /\btoc\b/u.test(searchText) ? "workflow_preserve_only" : null;
 }
-function createParagraphBlock(paragraphIndex, paragraph, document, start, formattingContext, promoteSecondaryStoryTextBoxes, cullBuild = false, editableTargetsByBlockPath = EMPTY_EDITABLE_TARGETS_BY_BLOCK_PATH, blockPath, editableTarget) {
+function createParagraphBlock(paragraphIndex, paragraph, document, start, formattingContext, promoteSecondaryStoryTextBoxes, cullBuild = false, editableTargetsByBlockPath = EMPTY_EDITABLE_TARGETS_BY_BLOCK_PATH, blockPath, editableTarget, layoutIdentity) {
   const themeResolver = formattingContext.theme;
   const effectiveNumbering = formattingContext.resolveEffectiveParagraphNumbering(paragraph);
   let resolvedNumbering = null;
@@ -3744,6 +3754,7 @@ function createParagraphBlock(paragraphIndex, paragraph, document, start, format
     from: start,
     to: start,
     ...editableTarget !== void 0 ? { editableTarget } : {},
+    ...layoutIdentity !== void 0 ? { layoutIdentity } : {},
     ...paragraph.styleId ? { styleId: paragraph.styleId } : {},
     ...effectiveNumbering ? { numbering: effectiveNumbering } : {},
     ...resolvedNumbering ? {