@beyondwork/docx-react-component 1.0.103 → 1.0.104

package/src/runtime/prerender/graph-canonicalize.ts

@@ -1,6 +1,7 @@
 import type {
   RuntimeBlockFragment,
   RuntimePageAnchor,
+  RuntimePageFrame,
   RuntimePageGraph,
   RuntimePageNode,
   RuntimePageRegion,
@@ -54,6 +55,9 @@ export function canonicalizeGraph(graph: RuntimePageGraph): RuntimePageGraph {
     ...page,
     pageId: rewriteId(page.pageId),
     regions: rewriteRegions(page.regions, rewriteId),
+    ...(page.frame === undefined
+      ? {}
+      : { frame: rewriteFrame(page.frame, rewriteId) }),
     lineBoxes: page.lineBoxes.map((line) => ({
       ...line,
       fragmentId: rewriteId(line.fragmentId),
@@ -86,6 +90,32 @@ export function canonicalizeGraph(graph: RuntimePageGraph): RuntimePageGraph {
   };
 }
 
+function rewriteFrame(
+  frame: RuntimePageFrame,
+  rewriteId: (id: string) => string,
+): RuntimePageFrame {
+  return {
+    ...frame,
+    pageId: rewriteId(frame.pageId),
+    regions: {
+      ...frame.regions,
+      body: rewriteRegion(frame.regions.body, rewriteId),
+      ...(frame.regions.header
+        ? { header: rewriteRegion(frame.regions.header, rewriteId) }
+        : {}),
+      ...(frame.regions.footer
+        ? { footer: rewriteRegion(frame.regions.footer, rewriteId) }
+        : {}),
+      ...(frame.regions.columns
+        ? { columns: frame.regions.columns.map((region) => rewriteRegion(region, rewriteId)) }
+        : {}),
+      ...(frame.regions.footnotes
+        ? { footnotes: frame.regions.footnotes.map((region) => rewriteRegion(region, rewriteId)) }
+        : {}),
+    },
+  };
+}
+
 function rewriteRegions(
   regions: RuntimePageRegions,
   rewriteId: (id: string) => string,

package/src/runtime/surface-projection.ts

@@ -6,6 +6,7 @@ import type {
   SurfaceDrawingAnchor,
   SurfaceInlineSegment,
   SurfacePictureEffects,
+  SurfacePreserveOnlyObjectSizing,
   SurfaceTableCellSnapshot,
   SurfaceTableRowSnapshot,
   SurfaceTextMark,
@@ -38,6 +39,7 @@ import type {
   TextMark,
   DrawingFrameNode,
   PictureContent,
+  PreserveOnlyObjectSizing,
   ShapeContent,
   VmlShapeNode,
   WordArtNode,
@@ -1549,6 +1551,9 @@ function appendInlineSegments(
           ...(c.line ? { line: c.line } : {}),
           ...(c.isTextBox ? { isTextBox: true } : {}),
           ...(c.textBoxBody ? { textBoxBody: c.textBoxBody } : {}),
+          ...(c.preserveOnlyObject
+            ? { preserveOnlyObject: surfacePreserveOnlyObject(c.preserveOnlyObject) }
+            : {}),
           ...(txbxText ? { txbxText } : {}),
           ...(txbxTextSegment?.marks && txbxTextSegment.marks.length > 0
             ? { txbxMarks: txbxTextSegment.marks }
@@ -1568,6 +1573,7 @@ function appendInlineSegments(
           {
             previewMediaId: c.previewMediaId,
             parsedChartId,
+            anchor: surfaceAnchorFromGeometry(node.anchor),
           },
         );
       }
@@ -1578,7 +1584,10 @@ function appendInlineSegments(
           start,
           "SmartArt diagram",
           `DrawingFrame smartart_preview (${node.anchor.wrapMode}).`,
-          { previewMediaId: c.previewMediaId },
+          {
+            previewMediaId: c.previewMediaId,
+            anchor: surfaceAnchorFromGeometry(node.anchor),
+          },
         );
       }
       return appendComplexPreviewSegment(
@@ -1587,6 +1596,7 @@ function appendInlineSegments(
         start,
         "Drawing frame",
         `DrawingFrame ${c.type} (${node.anchor.wrapMode}).`,
+        { anchor: surfaceAnchorFromGeometry(node.anchor) },
       );
     }
     case "symbol":
@@ -2109,12 +2119,19 @@ function extractTxbxFirstTextSegment(
 
 function appendComplexPreviewSegment(
   paragraph: ParagraphAccumulator,
-  node: { rawXml: string },
+  node: { rawXml: string; preserveOnlyObject?: PreserveOnlyObjectSizing },
   start: number,
   label: string,
   detail: string,
-  extras: { previewMediaId?: string; parsedChartId?: string } = {},
+  extras: {
+    previewMediaId?: string;
+    parsedChartId?: string;
+    anchor?: SurfaceDrawingAnchor;
+  } = {},
 ): { nextCursor: number; lockedFragmentIds: string[] } {
+  const preserveOnlyObject = node.preserveOnlyObject
+    ? surfacePreserveOnlyObject(node.preserveOnlyObject)
+    : undefined;
   paragraph.segments.push({
     segmentId: `${paragraph.blockId}-segment-${paragraph.segments.length}`,
     kind: "opaque_inline",
@@ -2126,11 +2143,34 @@ function appendComplexPreviewSegment(
     detail,
     ...(extras.previewMediaId ? { previewMediaId: extras.previewMediaId } : {}),
     ...(extras.parsedChartId ? { parsedChartId: extras.parsedChartId } : {}),
+    ...(preserveOnlyObject ? { preserveOnlyObject } : {}),
+    ...(extras.anchor ? { anchor: extras.anchor } : {}),
     state: "locked-preserve-only",
   });
   return { nextCursor: start + 1, lockedFragmentIds: [] };
 }
 
+function surfacePreserveOnlyObject(
+  object: PreserveOnlyObjectSizing,
+): SurfacePreserveOnlyObjectSizing {
+  return {
+    ...(object.sourceId ? { sourceId: object.sourceId } : {}),
+    display: object.display,
+    ...(object.extentEmu
+      ? {
+          extentEmu: {
+            widthEmu: object.extentEmu.widthEmu,
+            heightEmu: object.extentEmu.heightEmu,
+          },
+        }
+      : {}),
+    fallbackHint: object.fallbackHint,
+    ...(object.relationshipIds && object.relationshipIds.length > 0
+      ? { relationshipIds: [...object.relationshipIds] }
+      : {}),
+  };
+}
+
 function appendTextBoxSegment(
   paragraph: ParagraphAccumulator,
   start: number,

package/src/runtime/workflow/coordinator.ts

@@ -62,6 +62,7 @@ import type {
   WorkflowMetadataDefinition,
   WorkflowMetadataEntry,
   WorkflowMetadataSnapshot,
+  WorkflowEventOrigin,
   WorkflowOverlay,
   WorkflowScope,
   WorkflowScopeGuardPolicy,
@@ -100,10 +101,8 @@ import {
 } from "./visibility-policy.ts";
 import { type WorkflowMarkupModePolicy } from "./markup-mode-policy.ts";
 
-/** Shape of origin metadata attached to commands. The runtime has a
- * richer `CommandOrigin` type; we only pass it through, so we keep an
- * open shape here to avoid coupling. */
-type CoordinatorCommandOrigin = { readonly source: string; readonly at?: string };
+/** Shape of origin metadata attached to workflow commands/events. */
+type CoordinatorCommandOrigin = WorkflowEventOrigin;
 
 /** Document-mutation commands the coordinator emits through `deps.dispatch`. */
 type CoordinatorDispatchedCommand =
@@ -157,10 +156,17 @@ export interface WorkflowEmittableEvent {
   readonly type:
     | "workflow_overlay_changed"
     | "workflow_active_work_item_changed"
-    | "workflow_metadata_changed";
+    | "workflow_metadata_changed"
+    | "workflow_shared_state_changed"
+    | "workflow_visibility_policy_changed"
+    | "workflow_markup_mode_policy_changed";
   readonly documentId: string;
   readonly snapshot?: WorkflowScopeSnapshot | WorkflowMetadataSnapshot | null;
   readonly activeWorkItemId?: string | null;
+  readonly state?: SharedWorkflowState | null;
+  readonly kind?: OverlayKind;
+  readonly policy?: OverlayVisibilityPolicy | WorkflowMarkupModePolicy | null;
+  readonly origin?: CoordinatorCommandOrigin;
 }
 
 export interface PerfCounters {
@@ -276,7 +282,10 @@ export interface WorkflowCoordinator {
    * seam) so UI surfaces re-fire when policy changes mid-session. */
   subscribeMarkupModePolicy(listener: () => void): () => void;
   /* --- collab shared state --- */
-  setSharedWorkflowState(state: SharedWorkflowState | null): void;
+  setSharedWorkflowState(
+    state: SharedWorkflowState | null,
+    origin?: CoordinatorCommandOrigin,
+  ): void;
   /* --- snapshots (cached) --- */
   getInteractionGuardSnapshot(): InteractionGuardSnapshot;
   getWorkflowScopeSnapshot(): WorkflowScopeSnapshot | null;
@@ -1133,12 +1142,21 @@ export function createWorkflowCoordinator(deps: CoordinatorDeps): WorkflowCoordi
     return overlayStore.getMetadataSnapshot();
   }
 
-  function setSharedWorkflowState(state: SharedWorkflowState | null): void {
+  function setSharedWorkflowState(
+    state: SharedWorkflowState | null,
+    origin: CoordinatorCommandOrigin = { source: "api", at: clock() },
+  ): void {
     const prior = overlayStore.getSharedWorkflowState();
     if (state === prior) return;
     overlayStore.replaceSharedWorkflowState(state);
     cachedInteractionGuardSnapshot = undefined;
     cachedWorkflowScopeSnapshot = undefined;
+    deps.emitEvent({
+      type: "workflow_shared_state_changed",
+      documentId: deps.getState().documentId,
+      state,
+      origin,
+    });
   }
 
   function setScopeChromeVisibility(state: ScopeChromeVisibilityState): void {
@@ -1161,13 +1179,13 @@ export function createWorkflowCoordinator(deps: CoordinatorDeps): WorkflowCoordi
 
   function setVisibilityPolicy(policy: OverlayVisibilityPolicy): boolean {
     const changed = overlayStore.replaceVisibilityPolicy(policy.kind, policy);
-    if (changed) emitVisibilityPolicyChanged();
+    if (changed) emitVisibilityPolicyChanged(policy.kind, policy);
     return changed;
   }
 
   function clearVisibilityPolicy(kind: OverlayKind): boolean {
     const changed = overlayStore.replaceVisibilityPolicy(kind, null);
-    if (changed) emitVisibilityPolicyChanged();
+    if (changed) emitVisibilityPolicyChanged(kind, null);
     return changed;
   }
 
@@ -1175,7 +1193,10 @@ export function createWorkflowCoordinator(deps: CoordinatorDeps): WorkflowCoordi
     policies: readonly OverlayVisibilityPolicy[],
   ): boolean {
     const changed = overlayStore.replaceVisibilityPolicies(policies);
-    if (changed) emitVisibilityPolicyChanged();
+    if (changed) emitVisibilityPolicyChanged(undefined, undefined, {
+      source: "runtime",
+      at: clock(),
+    });
     return changed;
   }
 
@@ -1195,6 +1216,12 @@ export function createWorkflowCoordinator(deps: CoordinatorDeps): WorkflowCoordi
     const changed = overlayStore.replaceMarkupModePolicy(policy);
     if (changed) {
       overlayStore.notifyMarkupModePolicyChanged();
+      deps.emitEvent({
+        type: "workflow_markup_mode_policy_changed",
+        documentId: deps.getState().documentId,
+        policy,
+        origin: { source: "api", at: clock() },
+      });
       if (deps.telemetryBus.isEnabled("scope")) {
         deps.telemetryBus.emit({
           channel: "scope",
@@ -1211,11 +1238,22 @@ export function createWorkflowCoordinator(deps: CoordinatorDeps): WorkflowCoordi
     return overlayStore.subscribeMarkupModePolicy(listener);
   }
 
-  function emitVisibilityPolicyChanged(): void {
+  function emitVisibilityPolicyChanged(
+    kind?: OverlayKind,
+    policy?: OverlayVisibilityPolicy | null,
+    origin: CoordinatorCommandOrigin = { source: "api", at: clock() },
+  ): void {
     // Notify direct subscribers first — L10 X3's ui.overlays.subscribeVisibility
     // chains onto this signal so UI surfaces re-fire when an authoring tool
     // mutates policy mid-session.
     overlayStore.notifyVisibilityPolicyChanged();
+    deps.emitEvent({
+      type: "workflow_visibility_policy_changed",
+      documentId: deps.getState().documentId,
+      ...(kind !== undefined ? { kind } : {}),
+      ...(policy !== undefined ? { policy } : {}),
+      origin,
+    });
     if (!deps.telemetryBus.isEnabled("scope")) return;
     deps.telemetryBus.emit({
       channel: "scope",
@@ -1301,12 +1339,14 @@ export function createWorkflowCoordinator(deps: CoordinatorDeps): WorkflowCoordi
           type: "workflow_overlay_changed",
           documentId,
           snapshot,
+          origin: command.origin,
         });
         if (command.overlay.activeWorkItemId !== undefined) {
           deps.emitEvent({
             type: "workflow_active_work_item_changed",
             documentId,
             activeWorkItemId: command.overlay.activeWorkItemId ?? null,
+            origin: command.origin,
           });
         }
         return warningDelta;
@@ -1323,6 +1363,7 @@ export function createWorkflowCoordinator(deps: CoordinatorDeps): WorkflowCoordi
           type: "workflow_active_work_item_changed",
           documentId,
           activeWorkItemId: null,
+          origin: command.origin,
         });
         deps.emitEvent({
           type: "workflow_overlay_changed",
@@ -1334,6 +1375,7 @@ export function createWorkflowCoordinator(deps: CoordinatorDeps): WorkflowCoordi
             candidates: [],
             blockedReasons: [],
           },
+          origin: command.origin,
         });
         return warningDelta;
       }
@@ -1343,6 +1385,7 @@ export function createWorkflowCoordinator(deps: CoordinatorDeps): WorkflowCoordi
           type: "workflow_metadata_changed",
           documentId,
           snapshot: overlayStore.getMetadataSnapshot(),
+          origin: command.origin,
         });
         return null;
       }
@@ -1352,6 +1395,7 @@ export function createWorkflowCoordinator(deps: CoordinatorDeps): WorkflowCoordi
           type: "workflow_metadata_changed",
           documentId,
           snapshot: overlayStore.getMetadataSnapshot(),
+          origin: command.origin,
         });
         return null;
       }
@@ -1361,6 +1405,7 @@ export function createWorkflowCoordinator(deps: CoordinatorDeps): WorkflowCoordi
           type: "workflow_metadata_changed",
           documentId,
           snapshot: overlayStore.getMetadataSnapshot(),
+          origin: command.origin,
         });
         return null;
       }
@@ -1370,6 +1415,7 @@ export function createWorkflowCoordinator(deps: CoordinatorDeps): WorkflowCoordi
           type: "workflow_metadata_changed",
           documentId,
           snapshot: overlayStore.getMetadataSnapshot(),
+          origin: command.origin,
         });
         return null;
       }

package/src/ui-tailwind/chrome-overlay/tw-page-stack-overlay-layer.tsx

@@ -839,6 +839,7 @@ export const TwPageStackOverlayLayer: React.FC<TwPageStackOverlayLayerProps> = (
         null,
       );
       if (geometryRects !== null) {
+        incrementInvalidationCounter("overlay.page.geometry.hit");
         setRectsIfChanged(reconcilePaperRectsWithFlow(geometryRects, pageCount));
         return;
       }
@@ -854,6 +855,7 @@ export const TwPageStackOverlayLayer: React.FC<TwPageStackOverlayLayerProps> = (
     // above via `geometryFacet` or the UI-API resolver. Lines below
     // fire only before the first render frame.
     if (origin) {
+      incrementInvalidationCounter("overlay.page.dom.degraded");
       const widgets = measureWidgetsViaBoundingRect(scrollRoot, origin, {
         pageCount,
         visiblePageIndexRange: null,
@@ -870,6 +872,7 @@ export const TwPageStackOverlayLayer: React.FC<TwPageStackOverlayLayerProps> = (
       });
       setRectsIfChanged(reconcilePaperRectsWithFlow(domRects, pageCount));
     } else {
+      incrementInvalidationCounter("overlay.page.dom.degraded");
       const widgets = measureWidgetsViaOffsetChain(scrollRoot, {
         pageCount,
         visiblePageIndexRange: null,