@beyondwork/docx-react-component 1.0.104 → 1.0.105

package/src/model/layout/page-graph-types.ts

@@ -107,6 +107,7 @@ export interface RuntimeLayoutDivergence {
   message: string;
   regionKinds?: RuntimePageRegion["kind"][];
   fragmentIds?: string[];
+  objectIds?: string[];
 }
 
 export interface RuntimePageFrame {
@@ -117,10 +118,90 @@ export interface RuntimePageFrame {
   displayPageNumber: number;
   physicalBoundsTwips: RuntimeTwipsRect;
   regions: RuntimeResolvedRegions;
+  pageLocalStories: RuntimePageLocalStoryInstance[];
   divergenceIds: string[];
   signature: string;
 }
 
+export interface RuntimePageLocalStoryInstance {
+  instanceId: string;
+  storyKey: string;
+  pageId: string;
+  kind: "header" | "footer";
+  variant: "default" | "first" | "even" | "odd";
+  relationshipId: string;
+  sectionIndex?: number;
+  resolvedFields: RuntimeResolvedStoryField[];
+  anchoredObjects: RuntimeStoryAnchoredObject[];
+  measuredFrameHeightTwips: number;
+  signature: string;
+}
+
+export interface RuntimeResolvedStoryField {
+  fieldId: string;
+  family: string;
+  displayText: string;
+}
+
+export interface RuntimeStoryAnchoredObject {
+  objectId: string;
+  sourceType:
+    | "image"
+    | "drawing-frame"
+    | "chart-preview"
+    | "smartart-preview"
+    | "shape"
+    | "wordart"
+    | "vml-shape"
+    | "ole-embed"
+    | "opaque-inline";
+  display: "inline" | "floating" | "unknown";
+  extentTwips?: {
+    widthTwips: number;
+    heightTwips: number;
+  };
+  relationshipIds?: readonly string[];
+  preserveOnly: boolean;
+  divergenceIds: string[];
+}
+
+export type RuntimeLayoutContinuationCursor =
+  | RuntimeParagraphContinuationCursor
+  | RuntimeTableContinuationCursor;
+
+export interface RuntimeParagraphContinuationCursor {
+  kind: "paragraph";
+  sequenceIndex: number;
+  sliceCount: number;
+  lineRange: {
+    from: number;
+    to: number;
+    totalLines: number;
+  };
+  continuesFromPreviousPage: boolean;
+  continuesToNextPage: boolean;
+}
+
+export interface RuntimeTableContinuationCursor {
+  kind: "table";
+  sequenceIndex: number;
+  sliceCount: number;
+  rowRange: {
+    from: number;
+    to: number;
+    totalRows: number;
+  };
+  continuesFromPreviousPage: boolean;
+  continuesToNextPage: boolean;
+  repeatedHeaderRowIndexes: readonly number[];
+  verticalMergeCarry: readonly RuntimeTableVerticalMergeCarry[];
+}
+
+export interface RuntimeTableVerticalMergeCarry {
+  columnIndex: number;
+  restartRowIndex: number;
+}
+
 // ---------------------------------------------------------------------------
 // Fragment types
 // ---------------------------------------------------------------------------
@@ -176,6 +257,14 @@ export interface RuntimeBlockFragment {
     to: number;
     totalRows: number;
   };
+  /**
+   * PE2 Slice 3 — typed continuation cursor for fragments that render a
+   * logical block over multiple page/column frames. Existing slice fields
+   * remain for compatibility; this cursor makes repeated-header,
+   * line/row-range, and vertical-merge carry explicit for debug/render
+   * consumers without reading DOM or canonical tables again.
+   */
+  continuation?: RuntimeLayoutContinuationCursor;
   /**
    * Slice 5 — opaque style-chain ref derived from the block's `styleId`.
    * Used by `analyzeStylesChange` to bound invalidation to the first page

package/src/model/layout/runtime-page-graph-types.ts

@@ -14,6 +14,10 @@
  * layer (`src/runtime/layout/page-graph.ts`).
  */
 
+import type {
+  FooterDocument,
+  HeaderDocument,
+} from "../canonical-document.ts";
 import type {
   RuntimeBlockFragment,
   RuntimeLayoutDivergence,
@@ -115,4 +119,13 @@ export interface BuildPageGraphInput {
    * `page-${revision}-${index}` pageId in advance.
    */
   noteAllocationsByPageIndex?: ReadonlyMap<number, RuntimeNoteAllocation[]>;
+  /**
+   * Optional canonical header/footer parts. When present, `buildPageGraph`
+   * resolves page-instance fields inside page-local header/footer story
+   * records without making render/UI consumers re-walk subparts.
+   */
+  subParts?: {
+    headers?: ReadonlyArray<HeaderDocument>;
+    footers?: ReadonlyArray<FooterDocument>;
+  };
 }

package/src/runtime/event-refresh-hints.ts

@@ -26,7 +26,6 @@ export function describeEventImpact(
     case "workflow_overlay_changed":
     case "workflow_active_work_item_changed":
     case "workflow_shared_state_changed":
-    case "workflow_visibility_policy_changed":
     case "workflow_markup_mode_policy_changed":
       return {
         invalidate: [
@@ -40,9 +39,27 @@ export function describeEventImpact(
         staleTargets: ["anchors"],
         changeKinds: ["workflow"],
       };
+    case "workflow_visibility_policy_changed":
+      return {
+        invalidate: [
+          "workflowScope",
+          "workflowMarkup",
+          "reviewWork",
+          "chunks",
+          "contextAnalytics",
+        ],
+        staleTargets: ["none"],
+        changeKinds: ["workflow"],
+      };
     case "workflow_metadata_changed":
       return {
-        invalidate: ["workflowMarkup", "render", "locations", "reviewWork", "chunks"],
+        invalidate: [
+          "workflowMarkup",
+          "locations",
+          "reviewWork",
+          "chunks",
+          "contextAnalytics",
+        ],
         staleTargets: ["anchors"],
         changeKinds: ["workflow"],
       };
@@ -50,10 +67,6 @@ export function describeEventImpact(
     case "change_accepted":
     case "change_rejected":
     case "suggestion_authored":
-    case "suggestion_updated":
-    case "comment_added":
-    case "comment_resolved":
-    case "comments_changed":
       return {
         invalidate: [
           "render",
@@ -72,6 +85,20 @@ export function describeEventImpact(
         staleTargets: ["search_results", "anchors"],
         changeKinds: ["content", "review", "structure"],
       };
+    case "suggestion_updated":
+      return {
+        invalidate: ["trackedChanges", "reviewWork", "chunks", "contextAnalytics"],
+        staleTargets: ["none"],
+        changeKinds: ["review"],
+      };
+    case "comment_added":
+    case "comment_resolved":
+    case "comments_changed":
+      return {
+        invalidate: ["comments", "reviewWork", "chunks", "contextAnalytics"],
+        staleTargets: ["none"],
+        changeKinds: ["review"],
+      };
     case "warning_added":
     case "warning_cleared":
     case "error":

package/src/runtime/geometry/geometry-facet.ts

@@ -259,7 +259,15 @@ export function createGeometryFacet(
     getGeometryCoverage() {
       const kernel = input.renderKernel?.();
       if (!kernel) return createUnavailableGeometryCoverage();
-      return summarizeGeometryCoverageFromFrame(kernel.getRenderFrame());
+      const frame = kernel.getRenderFrame();
+      const canonicalDocument = input.getCanonicalDocument?.() ?? null;
+      if (canonicalDocument) {
+        return (
+          projectGeometryIndexFromFrame(frame, { canonicalDocument })?.coverage ??
+          createUnavailableGeometryCoverage()
+        );
+      }
+      return summarizeGeometryCoverageFromFrame(frame);
     },
 
     hitTest(point) {