@beyondwork/docx-react-component 1.0.67 → 1.0.70

package/src/ui-tailwind/editor-surface/pm-page-break-decorations.ts

@@ -24,7 +24,7 @@
  */
 
 import { Decoration } from "prosemirror-view";
-import type { RuntimePageGraph } from "../../runtime/layout/page-graph.ts";
+import type { RuntimePageGraph } from "../../api/public-types.ts";
 import { resolvePageFieldDisplayText } from "../../runtime/layout/resolve-page-fields.ts";
 
 export const PAGE_CHROME_DEFAULTS = {

package/src/ui-tailwind/editor-surface/pm-schema.ts

@@ -16,7 +16,7 @@ import {
   EMU_PER_PX,
   ROTATION_UNITS_PER_DEGREE,
   SRCRECT_UNITS_PER_PERCENT,
-} from "../../runtime/units.ts";
+} from "../../api/public-types.ts";
 
 const HEX_COLOR_RE = /^[0-9A-Fa-f]{3,8}$/;
 const SAFE_FONT_RE = /^[A-Za-z0-9 ,\-'"]+$/;

package/src/ui-tailwind/editor-surface/pm-state-from-snapshot.ts

@@ -12,7 +12,7 @@ import type {
 import { shouldRenderAbsoluteFloatingImageInPageOverlay } from "../page-stack/floating-image-overlay-model.ts";
 import { editorSchema } from "./pm-schema";
 import { buildPositionMap, type PositionMap } from "./pm-position-map";
-import { chartModelStore } from "../../runtime/chart/chart-model-store.ts";
+import { getChartModel } from "../../api/v3/runtime/chart.ts";
 
 export interface PMStateResult {
   state: EditorState;
@@ -783,7 +783,7 @@ function buildOpaqueInlineOrComplexAtom(
     let widthPx: number | null = null;
     let heightPx: number | null = null;
     if (parsedChartId) {
-      const entry = chartModelStore.get(parsedChartId);
+      const entry = getChartModel(parsedChartId);
       if (entry) {
         widthPx = entry.widthPx;
         heightPx = entry.heightPx;
@@ -857,7 +857,7 @@ function buildOpaqueBlock(
 ): PMNode {
   // Viewport-culled placeholder: emit a single paragraph with ZWSP text so
   // PM position math matches the original block span.
-  // See docs/plans/lane-2-render-performance.md Task 2.2.3.
+  // See CLAUDE.md (lane status table) Task 2.2.3.
   const placeholderSize = block.placeholderSize ?? null;
   if (placeholderSize !== null) {
     const targetSize = placeholderSize as number;

package/src/ui-tailwind/editor-surface/predicted-tag-preflight.ts

@@ -2,7 +2,7 @@ import type {
   EditorSurfaceSnapshot,
   SurfaceBlockSnapshot,
 } from "../../api/public-types.ts";
-import type { ScopeTagRegistry } from "../../runtime/scope-tag-registry.ts";
+import type { ScopeTagRegistry } from "../../api/public-types.ts";
 
 /**
  * Pre-flight check the FastTextEditLane consults before applying a predicted

package/src/ui-tailwind/editor-surface/remote-cursor-plugin.ts

@@ -5,12 +5,12 @@ import type { EditorView } from "prosemirror-view";
 import type { Awareness } from "y-protocols/awareness";
 
 import type { EditorStoryTarget } from "../../api/public-types";
-import { storyTargetsEqual } from "../../core/selection/mapping";
+import { storyTargetsEqual } from "../../api/public-types";
 import type { PositionMap } from "./pm-position-map";
 import {
   getRemoteCursorStates,
   type RemoteCursorState,
-} from "../../runtime/collab/remote-cursor-awareness";
+} from "../../api/v3/runtime/collab";
 
 /**
  * Remote `cursor.color` comes straight off Yjs Awareness — another peer

package/src/ui-tailwind/editor-surface/scroll-anchor.ts

@@ -8,11 +8,18 @@
  * boundary in page mode.
  *
  * The anchor is keyed on `data-block-id` rather than pixel offset so
- * it survives arbitrary height changes across the toggle.  Each helper
- * does a single DOM read or a single `scrollTop` write — no mutation
- * observers, no rAF loops — so the inverted-PM contract is preserved.
+ * it survives arbitrary height changes across the toggle.
+ *
+ * Refactor/05 Slice 3b (2026-04-22) rewires these helpers to read block
+ * rects through `GeometryFacet.getBlock(blockId)` in the steady-state
+ * (warm) path. The DOM-measurement path is preserved as the cold-open
+ * seam for the window before the render kernel has emitted its first
+ * frame — per architecture 05 Slice 3 exit criteria, a single narrow
+ * DOM fallback branch is permitted here.
  */
 
+import type { GeometryFacet } from "../../api/public-types.ts";
+
 export interface ScrollAnchor {
   /** `data-block-id` of the topmost block straddling or below scrollTop. */
   blockId: string;
@@ -24,24 +31,79 @@ export interface ScrollAnchor {
   offsetWithinBlock: number;
 }
 
+export interface FindScrollAnchorOptions {
+  /**
+   * Geometry facet — when provided and its `getBlock(blockId)` resolves,
+   * the anchor is computed from the kernel's frame coordinates instead
+   * of the DOM. The DOM path runs only on cold-open (no kernel frame
+   * yet) or when explicitly requested via `prepaintFallback: true`.
+   */
+  geometryFacet?: GeometryFacet;
+  /**
+   * Opt-in DOM fallback for callers that want to force the pre-paint
+   * path (e.g. a mode toggle that fires before the first render frame
+   * of the destination mode). When `false` (default) and a
+   * `geometryFacet` is provided, the helper tries the facet first and
+   * only falls through to DOM when no block resolves.
+   */
+  prepaintFallback?: boolean;
+}
+
 /**
  * Find the scroll anchor for `root` — the scroll container whose
- * `scrollTop` / `getBoundingClientRect` we will read.
+ * `scrollTop` defines the viewport origin for the anchor.
+ *
+ * Resolution order:
+ *   1. `geometryFacet` provided + `prepaintFallback !== true`: walk
+ *      block ids from the DOM in document order, query the facet's
+ *      `getBlock` for each, pick the first whose rect's bottom is
+ *      >= the scroll-root-relative viewport top (rects are frame-local
+ *      pixels). The root's scroll offset supplies the viewport-top.
+ *   2. Otherwise: the legacy DOM path via `getBoundingClientRect` —
+ *      this is the cold-open fallback architecture 05 Slice 3 exit
+ *      criteria explicitly keep.
  *
  * Returns `null` when the root has no `[data-block-id]` descendants or
  * when the root itself has zero height (e.g. disconnected during the
  * toggle).
  */
-export function findScrollAnchor(root: HTMLElement | null): ScrollAnchor | null {
+export function findScrollAnchor(
+  root: HTMLElement | null,
+  options?: FindScrollAnchorOptions,
+): ScrollAnchor | null {
   if (!root) return null;
   const blocks = root.querySelectorAll<HTMLElement>("[data-block-id]");
   if (blocks.length === 0) return null;
+
+  // Slice 3b warm path — read block rects from the kernel frame.
+  // `viewportTopFramePx` is "what frame-local y-coordinate is currently
+  // visible at the top of the scroll-root viewport?" For the overlay's
+  // wiring (overlay root = frame root), that's simply `scrollTop`.
+  if (options?.geometryFacet && !options.prepaintFallback) {
+    const viewportTopFramePx = root.scrollTop;
+    for (const block of blocks) {
+      const blockId = block.getAttribute("data-block-id");
+      if (!blockId) continue;
+      const geometry = options.geometryFacet.getBlock(blockId);
+      if (!geometry || geometry.rects.length === 0) continue;
+      const rect = geometry.rects[0]!;
+      const blockTop = rect.topPx;
+      const blockBottom = rect.topPx + rect.heightPx;
+      if (blockBottom < viewportTopFramePx) continue;
+      return {
+        blockId,
+        offsetWithinBlock: viewportTopFramePx - blockTop,
+      };
+    }
+    // No block matched via the facet — fall through to the DOM path so
+    // cold-open (pre-first-frame) callers still produce an anchor.
+  }
+
+  // Cold-open / pre-paint fallback — the single permitted DOM-origin
+  // branch under `src/ui-tailwind/editor-surface/scroll-anchor.ts` per
+  // the Slice-3 plan.
   const rootRect = root.getBoundingClientRect();
   const rootTop = rootRect.top;
-  // Walk blocks in document order; pick the first one whose bottom is
-  // >= the scroll root's top edge.  That's the topmost block at least
-  // partially visible (or the one just below when the viewport sits in
-  // a gap between blocks).
   for (const block of blocks) {
     const rect = block.getBoundingClientRect();
     if (rect.bottom < rootTop) continue;
@@ -60,14 +122,34 @@ export function findScrollAnchor(root: HTMLElement | null): ScrollAnchor | null
  * `root` and adjusting `scrollTop` so the block's leading edge sits at
  * the same offset relative to the viewport.
  *
+ * When a `geometryFacet` is supplied and resolves the block, the
+ * translation runs on kernel-frame coordinates (no DOM measurement).
+ * Otherwise the DOM path is used as the cold-open fallback.
+ *
  * Graceful no-op when the anchor's block no longer exists (deletion
  * mid-toggle, doc swap) or when the new root is empty.
  */
 export function restoreScrollAnchor(
   root: HTMLElement | null,
   anchor: ScrollAnchor | null,
+  options?: FindScrollAnchorOptions,
 ): void {
   if (!root || !anchor) return;
+
+  if (options?.geometryFacet && !options.prepaintFallback) {
+    const geometry = options.geometryFacet.getBlock(anchor.blockId);
+    if (geometry && geometry.rects.length > 0) {
+      const rect = geometry.rects[0]!;
+      // We want, post-restore, the frame-local y of the block's top to
+      // land at `scrollTop + offsetWithinBlock`-below-viewport-top.
+      // Equivalently, set scrollTop so that the block's top is
+      // `offsetWithinBlock` above it.
+      root.scrollTop = rect.topPx - anchor.offsetWithinBlock;
+      return;
+    }
+    // No block match through facet; fall through to DOM path.
+  }
+
   const selector = `[data-block-id="${cssEscape(anchor.blockId)}"]`;
   const block = root.querySelector<HTMLElement>(selector);
   if (!block) return;

package/src/ui-tailwind/editor-surface/shape-renderer.ts

@@ -17,7 +17,7 @@
  * fill; `noLine: true` → `stroke: "none"`.
  */
 
-import { EMU_PER_PX, ROTATION_UNITS_PER_DEGREE } from "../../runtime/units";
+import { EMU_PER_PX, ROTATION_UNITS_PER_DEGREE } from "../../api/public-types";
 
 const SUPPORTED_GEOMETRIES = new Set(["rect", "ellipse", "roundRect"]);
 

package/src/ui-tailwind/editor-surface/surface-layer.ts

@@ -1,6 +1,6 @@
 /**
  * R.4 SurfaceLayer — named shell for the outermost input surface layer.
- * See `docs/plans/lane-1-editing-foundation.md` §R.4.
+ * See `CLAUDE.md (lane status table)` §R.4.
  *
  * Analogous to LibreOffice `SwWrtShell`. Owns: keyboard resolution, paste/drop
  * routing decisions, composition state. Does NOT own: PM view construction,

package/src/ui-tailwind/editor-surface/tw-opaque-block.tsx

@@ -18,7 +18,7 @@ export function TwOpaqueBlock(props: TwOpaqueBlockProps) {
   const selected = selectionTouchesRange(selection, block.from, block.to);
 
   return (
-    <div className="group relative">
+    <div className="group relative" data-block-kind="opaque">
       <div className="absolute -left-10 top-1 flex flex-col items-end gap-0 select-none w-8 text-right">
         <div className="flex items-center gap-0.5">
           <span className="text-[10px] text-tertiary/60 font-medium">Lock</span>

package/src/ui-tailwind/editor-surface/tw-page-block-view.helpers.ts

@@ -4,7 +4,7 @@ import type {
   SurfaceBlockSnapshot,
   SurfaceTextMark,
 } from "../../api/public-types.ts";
-import type { CanonicalRunFormatting } from "../../model/canonical-document.ts";
+import type { CanonicalRunFormatting } from "../../api/public-types.ts";
 
 // ---------------------------------------------------------------------------
 // Pure helpers shared by `tw-page-block-view` (body) and `tw-region-block-
@@ -122,15 +122,32 @@ export function buildParagraphStyle(
     style.minHeight = `${lineSpacing / 20}pt`;
   }
 
-  // Indentation
+  // Indentation — ECMA-376 §17.9.6: numbering-level pPr/ind overrides
+  // direct paragraph ind, which overrides style-chain ind. Mirror the PM
+  // path resolver at pm-state-from-snapshot.ts:453-456 so this static
+  // render path (pages 2+, non-PM) composes the same marker-lane +
+  // hanging-indent geometry as PM (page 1). Without the resolvedNumbering
+  // fallback, CCEP numbered paragraphs whose indent lives only on the
+  // numbering level (e.g. "X.1" lane openers) get paddingLeft=undefined
+  // while the marker span still applies marginLeft: -markerWidth —
+  // marker slides off the body frame.
+  const numberingInd = block.resolvedNumbering?.geometry.indentation;
   const indentLeft =
-    block.indentation?.left ?? block.resolvedParagraphFormatting?.indentation?.left;
+    numberingInd?.left ??
+    block.indentation?.left ??
+    block.resolvedParagraphFormatting?.indentation?.left;
   const indentRight =
-    block.indentation?.right ?? block.resolvedParagraphFormatting?.indentation?.right;
+    numberingInd?.right ??
+    block.indentation?.right ??
+    block.resolvedParagraphFormatting?.indentation?.right;
   const indentFirstLine =
-    block.indentation?.firstLine ?? block.resolvedParagraphFormatting?.indentation?.firstLine;
+    numberingInd?.firstLine ??
+    block.indentation?.firstLine ??
+    block.resolvedParagraphFormatting?.indentation?.firstLine;
   const indentHanging =
-    block.indentation?.hanging ?? block.resolvedParagraphFormatting?.indentation?.hanging;
+    numberingInd?.hanging ??
+    block.indentation?.hanging ??
+    block.resolvedParagraphFormatting?.indentation?.hanging;
 
   if (indentLeft) style.paddingLeft = `${indentLeft / 20}pt`;
   if (indentRight) style.paddingRight = `${indentRight / 20}pt`;

package/src/ui-tailwind/editor-surface/tw-prosemirror-surface.tsx

@@ -11,6 +11,7 @@ import { EditorView } from "prosemirror-view";
 
 import type {
   DocumentNavigationSnapshot,
+  EditorStoryTarget,
   EditorUser,
   RuntimeRenderSnapshot,
   SearchOptions,
@@ -22,17 +23,23 @@ import type {
   WorkflowMetadataMarkup,
   WorkflowScope,
 } from "../../api/public-types";
-import type { CanonicalDocumentEnvelope } from "../../core/state/editor-state.ts";
-import { searchDocument } from "../../runtime/document-search.ts";
-import {
-  getTableSelectionDescriptor,
-  type TableSelectionDescriptor,
-} from "../../runtime/table-commands.ts";
+import type { CanonicalDocumentEnvelope } from "../../api/public-types.ts";
+// §4.8 · refactor/11 — search + table descriptor access moved to the
+// Runtime API v3 seam (`runtime.search.searchDocument` +
+// `runtime.table.getSelectionDescriptor`, both shipped in react-refactor
+// `eb98ae06`). The PM surface receives them as host-supplied callbacks
+// instead of importing from `src/runtime/**` directly. `TableSelectionDescriptor`
+// is re-exported from the v3 table family so consumers don't peek into
+// `src/runtime/table-commands.ts` for the type either.
+import { type TableSelectionDescriptor } from "../../api/v3/runtime/table.ts";
 import {
   createCommentDecorationModel,
   type MarkupDisplay,
 } from "../../ui/headless/comment-decoration-model";
-import { createRevisionDecorationModel } from "../../ui/headless/revision-decoration-model";
+import {
+  createRevisionDecorationModel,
+  type RevisionDisplayFlags,
+} from "../../ui/headless/revision-decoration-model";
 import {
   createPMSelectionFromSnapshot,
   createPMStateFromSnapshot,
@@ -45,7 +52,7 @@ import {
 import { buildDecorations } from "./pm-decorations";
 import { buildPageBreakDecorations } from "./pm-page-break-decorations";
 import { DecorationSet } from "prosemirror-view";
-import type { WordReviewEditorLayoutFacet } from "../../runtime/layout";
+import type { WordReviewEditorLayoutFacet } from "../../api/public-types.ts";
 import { buildPagePreviewMaps } from "../../runtime/layout/resolve-page-previews";
 import { createContextualInteractionPlugin } from "./pm-contextual-ui";
 import {
@@ -58,7 +65,7 @@ import { buildPositionMap, type PositionMap } from "./pm-position-map";
 import { createLocalEditSessionState } from "./local-edit-session-state";
 import { createFastTextEditLane } from "./fast-text-edit-lane";
 import { createPredictedTxGate } from "./predicted-tx-gate";
-import { createScopeTagRegistry } from "../../runtime/scope-tag-registry";
+import { createScopeTagRegistry } from "../../runtime/workflow/scope-tag-registry";
 import { hasBailIfCrossedTagInRange } from "./predicted-tag-preflight";
 import {
   clearSearch as clearSearchPlugin,
@@ -89,11 +96,13 @@ import type { MediaPreviewDescriptor } from "./pm-state-from-snapshot";
  * between adjacent blocks.
  */
 function buildPageBreakDecorationsFromProps(
-  facet: WordReviewEditorLayoutFacet | undefined,
+  geometryFacet:
+    | import("../../runtime/geometry/index.ts").GeometryFacet
+    | undefined,
   isMainStory: boolean,
   positionMap: PositionMap,
   posture: "canvas" | "page",
-  canonicalDocument: import("../../core/state/editor-state.ts").CanonicalDocumentEnvelope,
+  canonicalDocument: CanonicalDocumentEnvelope,
   dimensions: {
     headerBandPx?: number;
     footerBandPx?: number;
@@ -101,9 +110,8 @@ function buildPageBreakDecorationsFromProps(
   } = {},
   surfaceBlocks?: readonly import("../../api/public-types.ts").SurfaceBlockSnapshot[],
 ): ReturnType<typeof buildPageBreakDecorations> {
-  if (!facet || !isMainStory) return [];
-  if (typeof facet.getRenderFrame !== "function") return [];
-  const frame = facet.getRenderFrame();
+  if (!geometryFacet || !isMainStory) return [];
+  const frame = geometryFacet.getRenderFrame();
   if (!frame || frame.pages.length < 2) return [];
   const fakeGraph = {
     revision: frame.revision,
@@ -226,6 +234,37 @@ export interface TwProseMirrorSurfaceProps {
   onUndo?: () => void;
   onRedo?: () => void;
   onBlockedInput?: (command: "paste" | "drop", message: string) => void;
+  /**
+   * refactor/11 Slice 5 — host-supplied adapter for rich clipboard
+   * parsing (WordML + HTML).  Forwarded to `createCommandBridgePlugins`
+   * so the PM bridge no longer reaches into `src/io/paste/**`.  When
+   * omitted, rich paste falls through to plain-text (identical to
+   * pre-Slice-5 behavior when `onPasteFragment` was not wired).
+   */
+  pasteFragmentParser?: import("./pm-command-bridge.ts").PasteFragmentParserAdapter;
+  /**
+   * §4.8 — host-supplied compound-search callback. Threaded from
+   * `api.runtime.search.searchDocument` at the WordReviewEditor mount;
+   * tests / headless callers that exercise search supply their own
+   * closure. Replaces the pre-slice direct import from
+   * `src/runtime/document-search.ts`.
+   */
+  runtimeSearchDocument?: (
+    document: CanonicalDocumentEnvelope,
+    selection: SelectionSnapshot,
+    activeStory: EditorStoryTarget,
+    navigation: DocumentNavigationSnapshot,
+    query: string,
+    options?: SearchOptions,
+  ) => SearchResultSnapshot[];
+  /**
+   * §4.8 — host-supplied table-selection descriptor reader. Threaded
+   * from `api.runtime.table.getSelectionDescriptor`; callers without a
+   * live runtime (test harnesses) pass the helper directly.
+   */
+  runtimeGetTableSelectionDescriptor?: (
+    state: import("prosemirror-state").EditorState,
+  ) => TableSelectionDescriptor | null;
   onPasteApplied?: (meta: {
     segmentCount: number;
     charCount: number;
@@ -252,13 +291,21 @@ export interface TwProseMirrorSurfaceProps {
     command: import("./fast-text-edit-lane").LaneRuntimeCommand,
   ) => import("../../api/public-types").TextCommandAck;
   /**
-   * Optional layout facet. When supplied and the active story is `main`,
-   * the surface injects widget decorations at every page boundary.  The
-   * widget DOM renders full inter-page chrome (page-N footer band +
-   * visible gap + page-N+1 header band) INLINE, so chrome stays aligned
-   * with PM content without any absolute overlay.
+   * Optional layout facet. Retained as a legacy pass-through; no longer
+   * read by this surface after the refactor/05 cross-lane-coord §8.4
+   * migration. Parents should pass `geometryFacet` instead for the
+   * page-break decoration build path.
    */
   layoutFacet?: WordReviewEditorLayoutFacet;
+  /**
+   * Geometry facet (`runtime.geometry`). When supplied and the active
+   * story is `main`, the surface injects widget decorations at every
+   * page boundary. Migrated from `layoutFacet` in the Slice-6 UI
+   * migration pass — geometry is the canonical source of
+   * render-frame access; layout-facet's `getRenderFrame` is being
+   * deleted.
+   */
+  geometryFacet?: import("../../runtime/geometry/index.ts").GeometryFacet;
   /** Height in px of each page's header band. Default 32. */
   pageChromeHeaderBandPx?: number;
   /** Height in px of each page's footer band. Default 32. */
@@ -276,6 +323,28 @@ export interface TwProseMirrorSurfaceProps {
    */
   onOpenHeaderStoryForPage?: (pageIndex: number) => void;
   onOpenFooterStoryForPage?: (pageIndex: number) => void;
+  /**
+   * Phase D.1 — right-click composition hook.
+   *
+   * When wired, the surface forwards `contextmenu` DOM events to this
+   * callback with the event coordinates + target; the PM command
+   * bridge suppresses the browser-native menu so the host can mount
+   * `TwContextMenu` at the returned coordinates.
+   *
+   * Hosts typically wire this to
+   * `chromeControllerRef.current?.handleContextMenuRequest(event)` —
+   * the workspace's `TwWorkspaceChromeHost` (Phase C.γ.3) owns the
+   * menu state + portal mount.
+   *
+   * When NOT wired, the bridge leaves the native menu alone so
+   * integrators that haven't opted in retain browser-default
+   * behavior (back-compat).
+   */
+  onContextMenuRequested?: (event: {
+    clientX: number;
+    clientY: number;
+    target: EventTarget | null;
+  }) => void;
 }
 
 export interface TwProseMirrorSurfaceRef {
@@ -296,6 +365,32 @@ export const TwProseMirrorSurface = forwardRef<
     onBlur,
   } = props;
   const surface = snapshot.surface;
+
+  // §4.3 — Track B integration. Pre-compute offset → revisionDisplay flags
+  // from the live surface-segment stream once per surface update; the
+  // decoration builder reads from L03's authoritative flags when an entry
+  // is present, otherwise falls through to the review-store side channel.
+  // Keyed by `segment.from` — L03 segments the plain text at revision
+  // boundaries, so `rev.from` aligns with a segment start whenever the
+  // segment carries `revisionDisplay`.
+  const revisionDisplayByOffset = useMemo<
+    ReadonlyMap<number, RevisionDisplayFlags> | undefined
+  >(() => {
+    if (!surface) return undefined;
+    let map: Map<number, RevisionDisplayFlags> | undefined;
+    for (const block of surface.blocks) {
+      if (block.kind !== "paragraph") continue;
+      for (const segment of block.segments) {
+        if (segment.kind !== "text") continue;
+        const flags = segment.revisionDisplay;
+        if (!flags) continue;
+        if (!map) map = new Map();
+        map.set(segment.from, flags);
+      }
+    }
+    return map;
+  }, [surface]);
+
   const mediaPreviewKey = useMemo(
     () =>
       Object.entries(props.mediaPreviews ?? {})
@@ -377,6 +472,12 @@ export const TwProseMirrorSurface = forwardRef<
     },
     getPositionMap: () => positionMapRef.current,
     isSelectionSyncSuppressed: () => suppressSelectionEchoRef.current,
+    // Phase D.1 — forward contextmenu events to the host-supplied
+    // chrome controller.  Delegates through a ref-indirect so handler
+    // identity stays stable for the lifetime of the PM plugin.
+    onContextMenuRequested: (event) => {
+      props.onContextMenuRequested?.(event);
+    },
   };
 
   // Comment/revision decoration models
@@ -505,6 +606,10 @@ export const TwProseMirrorSurface = forwardRef<
       onCompositionChange: (composing) => {
         sessionRef.current?.setComposing(composing);
       },
+    }, {
+      ...(props.pasteFragmentParser
+        ? { pasteFragmentParser: props.pasteFragmentParser }
+        : {}),
     });
 
     return [
@@ -545,9 +650,10 @@ export const TwProseMirrorSurface = forwardRef<
         props.activeWorkflowWorkItemId,
         props.activeWorkflowScopeIds,
         props.workflowMetadata,
+        revisionDisplayByOffset,
       );
       const pageBreakDecos = buildPageBreakDecorationsFromProps(
-        props.layoutFacet,
+        props.geometryFacet,
         snapshot.activeStory.kind === "main",
         positionMap,
         props.isPageWorkspace ? "page" : "canvas",
@@ -585,6 +691,7 @@ export const TwProseMirrorSurface = forwardRef<
       props.workflowMetadata,
       props.workflowCandidates,
       props.workflowScopes,
+      revisionDisplayByOffset,
       revisionModel,
       showTrackedChanges,
       suggestionsEnabled,
@@ -744,6 +851,7 @@ export const TwProseMirrorSurface = forwardRef<
       props.activeWorkflowWorkItemId,
       props.activeWorkflowScopeIds,
       props.workflowMetadata,
+      revisionDisplayByOffset,
     );
     recordPerfSample("pm.rebuild");
     incrementInvalidationCounter("pm.laneA.rebuilds");
@@ -897,7 +1005,8 @@ export const TwProseMirrorSurface = forwardRef<
         if (!view) {
           return null;
         }
-        return getTableSelectionDescriptor(view.state);
+        if (!props.runtimeGetTableSelectionDescriptor) return null;
+        return props.runtimeGetTableSelectionDescriptor(view.state);
       },
     }),
     [
@@ -956,8 +1065,9 @@ export const TwProseMirrorSurface = forwardRef<
       );
     }
 
+    if (!props.runtimeSearchDocument) return [];
     return filterHiddenDeletionSearchResults(
-      searchDocument(
+      props.runtimeSearchDocument(
         props.canonicalDocument,
         snapshot.selection,
         snapshot.activeStory,

package/src/ui-tailwind/editor-surface/tw-table-node-view.tsx

@@ -10,7 +10,7 @@
 
 import type { Node as PMNode } from "prosemirror-model";
 import type { NodeViewConstructor, ViewMutationRecord } from "prosemirror-view";
-import { PERCENTAGE_PARTS } from "../../runtime/units.ts";
+import { PERCENTAGE_PARTS } from "../../api/public-types.ts";
 
 // R2c: band class styles live in ./tw-table-bands.module.css. Consumers import
 // that stylesheet through their build pipeline (same pattern as editor-theme.css).

package/src/ui-tailwind/index.ts

@@ -51,11 +51,6 @@ export { TwStatusBar } from "./status/tw-status-bar";
 // Chrome
 export { TwAlertBanner } from "./chrome/tw-alert-banner";
 export { TwSelectionToolbar } from "./chrome/tw-selection-toolbar";
-export {
-  TwModeDock,
-  type TwModeDockAction,
-  type TwModeDockProps,
-} from "./chrome/tw-mode-dock";
 export {
   TwPasteDropToast,
   type TwPasteDropToastProps,

package/src/ui-tailwind/overlay-anchor-bridge-context.tsx

@@ -0,0 +1,33 @@
+/**
+ * OverlayAnchorBridgeContext — React context for publishing the shell's
+ * overlay-anchor bridge to deep presentation hooks without prop
+ * drilling.
+ *
+ * Pairs with `src/shell/overlay-anchor-bridge.ts` (bridge type) and
+ * `src/ui/ui-controller-factory.ts` (factory that reads the bridge).
+ * See DS-C1 in the close list / designsystem.md §8.8.1 "Selection
+ * toolbar" row.
+ *
+ * Only hooks that *write* to the bridge — publishing a current
+ * selection-anchor resolver — need this context. Readers go through
+ * `useUiApi().overlays.getAnchor(...)`; the bridge is a shell-private
+ * implementation detail of how that read resolves for
+ * `kind: "selection"`.
+ *
+ * Returns `null` when no bridge provider is mounted (headless path or
+ * pre-provider render) — writers skip publication silently, and
+ * `ui.overlays.getAnchor({ kind: "selection" })` honors U4 by returning
+ * `null` at the API layer.
+ */
+
+import { createContext, useContext } from "react";
+
+import type { ShellOverlayAnchorBridge } from "../shell/overlay-anchor-bridge.ts";
+
+const OverlayAnchorBridgeContext = createContext<ShellOverlayAnchorBridge | null>(null);
+
+export const OverlayAnchorBridgeProvider = OverlayAnchorBridgeContext.Provider;
+
+export function useOverlayAnchorBridge(): ShellOverlayAnchorBridge | null {
+  return useContext(OverlayAnchorBridgeContext);
+}