@beyondwork/docx-react-component 1.0.87 → 1.0.89

package/src/ui/WordReviewEditor.tsx

@@ -54,6 +54,7 @@ import type {
   SurfaceInlineSegment,
   TableOp,
   CanonicalDocumentFragment,
+  CanonicalDocumentEnvelope,
   TableOpResult,
   PublicTableEvent,
   PublicTableRenderPlan,
@@ -136,6 +137,7 @@ import { findTextMatchesForRuntime, searchRuntimeDocument } from "../shell/searc
 import {
   type TwProseMirrorSurfaceRef,
 } from "../ui-tailwind/editor-surface/tw-prosemirror-surface";
+import { TwInlineFindBar } from "../ui-tailwind/chrome/tw-inline-find-bar";
 import type { MediaPreviewDescriptor } from "../ui-tailwind/editor-surface/pm-state-from-snapshot";
 import {
   incrementInvalidationCounter,
@@ -1062,13 +1064,17 @@ export const WordReviewEditor = forwardRef<WordReviewEditorRef, WordReviewEditor
     } = props;
 
     const [activeRailTab, setActiveRailTab] = useState<ReviewRailTab>("comments");
+    const [inlineFindOpen, setInlineFindOpen] = useState(false);
+    const [inlineFindQuery, setInlineFindQuery] = useState("");
+    const [inlineFindResults, setInlineFindResults] = useState<readonly SearchResultSnapshot[]>([]);
+    const [inlineFindActiveIndex, setInlineFindActiveIndex] = useState(0);
     const [localMarkupDisplay, setLocalMarkupDisplay] =
       useState<WorkflowMarkupMode | null>(() => suggestionsEnabled ? "all" : null);
     const [activeRevisionId, setActiveRevisionId] = useState<string | undefined>();
     const [suppressedSuggestionRevisionId, setSuppressedSuggestionRevisionId] = useState<string | null>(null);
     const [selectionToolbarAnchor, setSelectionToolbarAnchor] = useState<SelectionToolbarAnchor | null>(null);
     const [selectionToolbarDismissedKey, setSelectionToolbarDismissedKey] = useState<string | null>(null);
-    const [selectionToolbarFocusWithin, setSelectionToolbarFocusWithin] = useState(false);
+    const [, setSelectionToolbarFocusWithin] = useState(false);
     const [hostAnnotationOverlayState, setHostAnnotationOverlayState] =
       useState<HostAnnotationOverlay | null>(null);
     const [activeReviewQueueItemId, setActiveReviewQueueItemId] = useState<string | null>(null);
@@ -2536,6 +2542,17 @@ export const WordReviewEditor = forwardRef<WordReviewEditorRef, WordReviewEditor
       !capabilities.canAddComment && !snapshot.selection.isCollapsed
         ? "Select text within one paragraph to add a DOCX comment."
         : undefined;
+    const selectionWorkflowPosture = resolveSelectionWorkflowPosture(
+      snapshot,
+      viewState,
+      workflowScopeSnapshot,
+      interactionGuardSnapshot,
+    );
+    const effectiveInteractionGuardSnapshot = createSelectionScopedInteractionGuardSnapshot(
+      interactionGuardSnapshot,
+      selectionWorkflowPosture,
+      workflowScopeSnapshot,
+    );
     const activeImageContext = useMemo(
       () =>
         buildActiveImageContext({
@@ -2584,16 +2601,117 @@ export const WordReviewEditor = forwardRef<WordReviewEditorRef, WordReviewEditor
         ),
       [canonicalDocument, snapshot],
     );
+    const navigateInlineFindResult = useCallback(
+      (results: readonly SearchResultSnapshot[], index: number) => {
+        const result = results[index];
+        if (!result) return;
+        applyRuntimeSelection(
+          activeRuntime,
+          createSelectionFromAnchor(result.anchor, result.storyTarget),
+        );
+      },
+      [activeRuntime],
+    );
+    const refreshInlineFindResults = useCallback(
+      (query: string, requestedIndex = 0) => {
+        const normalizedQuery = query.trim();
+        if (!normalizedQuery) {
+          surfaceRef.current?.clearSearch();
+          setInlineFindResults([]);
+          setInlineFindActiveIndex(0);
+          return;
+        }
+        const results = searchRuntimeDocument(
+          activeRuntime,
+          surfaceRef.current,
+          normalizedQuery,
+          { limit: 500 },
+        );
+        const nextIndex =
+          results.length > 0 ? wrapSearchResultIndex(requestedIndex, results.length) : 0;
+        setInlineFindResults(results);
+        setInlineFindActiveIndex(nextIndex);
+        navigateInlineFindResult(results, nextIndex);
+      },
+      [activeRuntime, navigateInlineFindResult],
+    );
+    const handleOpenInlineFind = useCallback(() => {
+      setInlineFindOpen(true);
+      if (inlineFindQuery.trim()) {
+        refreshInlineFindResults(inlineFindQuery, inlineFindActiveIndex);
+      }
+    }, [inlineFindActiveIndex, inlineFindQuery, refreshInlineFindResults]);
+    const handleCloseInlineFind = useCallback(() => {
+      setInlineFindOpen(false);
+      surfaceRef.current?.clearSearch();
+    }, []);
+    const handleInlineFindQueryChange = useCallback(
+      (query: string) => {
+        setInlineFindQuery(query);
+        refreshInlineFindResults(query, 0);
+      },
+      [refreshInlineFindResults],
+    );
+    const handleInlineFindNext = useCallback(() => {
+      if (inlineFindResults.length === 0) {
+        refreshInlineFindResults(inlineFindQuery, 0);
+        return;
+      }
+      const nextIndex = wrapSearchResultIndex(
+        inlineFindActiveIndex + 1,
+        inlineFindResults.length,
+      );
+      setInlineFindActiveIndex(nextIndex);
+      navigateInlineFindResult(inlineFindResults, nextIndex);
+    }, [
+      inlineFindActiveIndex,
+      inlineFindQuery,
+      inlineFindResults,
+      navigateInlineFindResult,
+      refreshInlineFindResults,
+    ]);
+    const handleInlineFindPrevious = useCallback(() => {
+      if (inlineFindResults.length === 0) {
+        refreshInlineFindResults(inlineFindQuery, 0);
+        return;
+      }
+      const nextIndex = wrapSearchResultIndex(
+        inlineFindActiveIndex - 1,
+        inlineFindResults.length,
+      );
+      setInlineFindActiveIndex(nextIndex);
+      navigateInlineFindResult(inlineFindResults, nextIndex);
+    }, [
+      inlineFindActiveIndex,
+      inlineFindQuery,
+      inlineFindResults,
+      navigateInlineFindResult,
+      refreshInlineFindResults,
+    ]);
     const suggestionsSnapshot = activeRuntime.getSuggestionsSnapshot();
+    const caretCommentPoint =
+      snapshot.selection.isCollapsed && snapshot.selection.activeRange.kind === "range"
+        ? snapshot.selection.activeRange.from
+        : null;
+    const caretCommentThread =
+      caretCommentPoint !== null
+        ? snapshot.comments.threads.find((thread) => {
+            if (thread.status !== "open" || thread.anchor.kind !== "range") {
+              return false;
+            }
+            return caretCommentPoint >= thread.anchor.from && caretCommentPoint <= thread.anchor.to;
+          })
+        : undefined;
     const activeCommentThread =
-      snapshot.comments.activeCommentId
+      (snapshot.comments.activeCommentId
         ? snapshot.comments.threads.find((thread) => thread.commentId === snapshot.comments.activeCommentId)
-        : undefined;
+        : undefined) ?? caretCommentThread;
+    const effectiveActiveCommentId = snapshot.comments.activeCommentId ?? activeCommentThread?.commentId;
     const scopedChromePolicy = resolveScopedChromePolicy({
       preset: effectiveChromePreset,
       compactMode: false,
       capabilities,
-      interactionGuardSnapshot,
+      interactionGuardSnapshot: effectiveInteractionGuardSnapshot,
       workflowScopeSnapshot,
       activeListContext: viewState.activeListContext,
     });
@@ -2605,7 +2723,7 @@ export const WordReviewEditor = forwardRef<WordReviewEditorRef, WordReviewEditor
       styleCatalog,
       formattingState,
       workflowScopeSnapshot,
-      interactionGuardSnapshot,
+      interactionGuardSnapshot: effectiveInteractionGuardSnapshot,
       addCommentDisabledReason,
     });
     const suggestionCard = buildSuggestionCardModel({
@@ -2614,7 +2732,7 @@ export const WordReviewEditor = forwardRef<WordReviewEditorRef, WordReviewEditor
       viewState,
       capabilities,
       workflowScopeSnapshot,
-      interactionGuardSnapshot,
+      interactionGuardSnapshot: effectiveInteractionGuardSnapshot,
       activeRevisionId,
       suppressedSuggestionRevisionId,
       addCommentDisabledReason,
@@ -2659,11 +2777,11 @@ export const WordReviewEditor = forwardRef<WordReviewEditorRef, WordReviewEditor
         styleCatalog,
         formattingState,
         workflowScopeSnapshot,
-        interactionGuardSnapshot,
+        interactionGuardSnapshot: effectiveInteractionGuardSnapshot,
         workflowMarkupSnapshot: workflowMarkupSnapshot ?? undefined,
         suggestionsSnapshot,
         activeRevisionId,
-        activeCommentId: snapshot.comments.activeCommentId,
+        activeCommentId: effectiveActiveCommentId,
         activeCommentThread,
         activeTableContext,
         activeImageContext,
@@ -2682,19 +2800,14 @@ export const WordReviewEditor = forwardRef<WordReviewEditorRef, WordReviewEditor
           snapshot.selection,
           viewState.activeStory,
           activeRevisionId,
-          snapshot.comments.activeCommentId,
+          effectiveActiveCommentId,
         ),
-      [activeRevisionId, snapshot.comments.activeCommentId, snapshot.selection, viewState.activeStory],
+      [activeRevisionId, effectiveActiveCommentId, snapshot.selection, viewState.activeStory],
     );
     const shouldRenderSelectionChrome = Boolean(
       activeSelectionTool &&
       selectionToolbarSelectionKey &&
-      selectionToolbarDismissedKey !== selectionToolbarSelectionKey &&
-      (
-        viewState.isFocused ||
-        selectionToolbarFocusWithin ||
-        activeSelectionTool.kind === "structure-context"
-      ),
+      selectionToolbarDismissedKey !== selectionToolbarSelectionKey,
     );
     const accessibilityInstructionsId = `${documentId}-accessibility-instructions`;
     const accessibilityStatusId = `${documentId}-accessibility-status`;
@@ -2978,16 +3091,20 @@ export const WordReviewEditor = forwardRef<WordReviewEditorRef, WordReviewEditor
         // not, the event falls through to the browser (Ctrl+F opens
         // Find, Ctrl+Plus zooms, etc.) — matching the legacy behavior.
         let handled = false;
-        if (shortcut.shortcut === "find" && onFindRequested) {
-          // selectionText is intentionally empty — hosts that need the
-          // selected text already receive it via the selection_changed
-          // event + canonicalDocument they have via onEvent listeners.
-          // The range is the load-bearing field so host Find panels can
-          // scope their search to the selection or pre-populate from it.
-          onFindRequested({
-            selectionText: "",
-            selectionRange: snapshot.selection,
-          });
+        if (shortcut.shortcut === "find") {
+          if (onFindRequested) {
+            // selectionText is intentionally empty — hosts that need the
+            // selected text already receive it via the selection_changed
+            // event + canonicalDocument they have via onEvent listeners.
+            // The range is the load-bearing field so host Find panels can
+            // scope their search to the selection or pre-populate from it.
+            onFindRequested({
+              selectionText: "",
+              selectionRange: snapshot.selection,
+            });
+          } else {
+            handleOpenInlineFind();
+          }
           handled = true;
         } else if (shortcut.shortcut === "print" && onPrintRequested) {
           onPrintRequested();
@@ -3373,6 +3490,54 @@ export const WordReviewEditor = forwardRef<WordReviewEditorRef, WordReviewEditor
           type: "set-cell-background",
           color,
         }),
+      onToggleRowHeader: () => {
+        if (!activeTableContext?.operations.setRowIsHeader.enabled) return;
+        applyRuntimeTableStructureOperation(activeRuntime, surfaceRef.current ?? null, {
+          type: "set-row-is-header",
+          rowIndex: activeTableContext.currentCell.rowIndex,
+          value: !activeTableContext.currentCell.isHeader,
+        });
+      },
+      onToggleRowCantSplit: () => {
+        if (!activeTableContext?.operations.setRowCantSplit.enabled) return;
+        applyRuntimeTableStructureOperation(activeRuntime, surfaceRef.current ?? null, {
+          type: "set-row-cant-split",
+          rowIndex: activeTableContext.currentCell.rowIndex,
+          value: !readTableRowCantSplit(
+            canonicalDocument,
+            activeTableContext.tableBlockIndex,
+            activeTableContext.currentCell.rowIndex,
+          ),
+        });
+      },
+      onDistributeColumnsEvenly: () =>
+        applyRuntimeTableStructureOperation(activeRuntime, surfaceRef.current ?? null, {
+          type: "distribute-columns-evenly",
+        }),
+      onSetTableAlignment: (alignment) =>
+        applyRuntimeTableStructureOperation(activeRuntime, surfaceRef.current ?? null, {
+          type: "set-table-alignment",
+          alignment,
+        }),
+      onSetCellVerticalAlign: (align) =>
+        applyRuntimeTableStructureOperation(activeRuntime, surfaceRef.current ?? null, {
+          type: "set-cell-vertical-align",
+          locator: { kind: "anchor" },
+          align,
+        }),
+      onSetColumnWidth: (columnIndex, twips) =>
+        applyRuntimeTableStructureOperation(activeRuntime, surfaceRef.current ?? null, {
+          type: "set-column-width",
+          columnIndex,
+          twips,
+        }),
+      onSetRowHeight: (rowIndex, twips, rule) =>
+        applyRuntimeTableStructureOperation(activeRuntime, surfaceRef.current ?? null, {
+          type: "set-row-height",
+          rowIndex,
+          twips,
+          rule,
+        }),
       onSetImageLayout: (mediaId, dimensions) =>
         applyRuntimeImageResize(activeRuntime, mediaId, dimensions),
       onSetImageFrame: (mediaId, offsets) =>
@@ -3508,7 +3673,7 @@ export const WordReviewEditor = forwardRef<WordReviewEditorRef, WordReviewEditor
         onAddComment: commands.onAddComment,
         onFindRequested: onFindRequested
           ? () => onFindRequested({ selectionText: "", selectionRange: snapshot.selection })
-          : undefined,
+          : handleOpenInlineFind,
         onReplaceRequested: onReplaceRequested
           ? () => onReplaceRequested({ selectionText: "", selectionRange: snapshot.selection })
           : undefined,
@@ -3534,6 +3699,7 @@ export const WordReviewEditor = forwardRef<WordReviewEditorRef, WordReviewEditor
       activeRuntime,
       commands,
       editorActionHost,
+      handleOpenInlineFind,
       onFindRequested,
       onGoToRequested,
       onPrintRequested,
@@ -3662,7 +3828,7 @@ export const WordReviewEditor = forwardRef<WordReviewEditorRef, WordReviewEditor
         layoutFacet={activeRuntime.layout}
         geometryFacet={activeRuntime.geometry}
         workflowFacet={activeRuntime.workflow}
-        interactionGuardSnapshot={interactionGuardSnapshot}
+        interactionGuardSnapshot={effectiveInteractionGuardSnapshot}
         chromePreset={effectiveChromePreset}
         chromeOptions={chromeOptions}
         density={density}
@@ -3688,6 +3854,7 @@ export const WordReviewEditor = forwardRef<WordReviewEditorRef, WordReviewEditor
         currentScopeContextAnalytics={currentScopeContextAnalytics}
         activeSelectionTool={shouldRenderSelectionChrome ? activeSelectionTool : null}
         selectionToolAnchor={shouldRenderSelectionChrome ? selectionToolbarAnchor : null}
+        tableContext={activeTableContext}
         onAddCommentFromSelection={addSelectionToolbarComment}
         onAddCommentFromSuggestion={addSelectionToolbarComment}
         onAcceptSuggestion={activeSelectionTool?.kind === "suggestion-review"
@@ -3703,6 +3870,20 @@ export const WordReviewEditor = forwardRef<WordReviewEditorRef, WordReviewEditor
         onSelectionToolbarFocusCapture={handleSelectionToolbarFocusCapture}
         onSelectionToolbarBlurCapture={handleSelectionToolbarBlurCapture}
         selectionToolbarRef={selectionToolbarElementRef}
+        onOpenInlineFind={handleOpenInlineFind}
+        inlineFindBar={
+          inlineFindOpen ? (
+            <TwInlineFindBar
+              query={inlineFindQuery}
+              activeIndex={inlineFindActiveIndex}
+              resultCount={inlineFindResults.length}
+              onQueryChange={handleInlineFindQueryChange}
+              onPrevious={handleInlineFindPrevious}
+              onNext={handleInlineFindNext}
+              onClose={handleCloseInlineFind}
+            />
+          ) : null
+        }
         commands={commands}
         document={documentElement}
         onReviewSidebarTrackedChanges={onReviewSidebarTrackedChanges}
@@ -4070,6 +4251,23 @@ function openStoryForPage(
   runtime.openStory(target);
 }
 
+function wrapSearchResultIndex(index: number, resultCount: number): number {
+  if (resultCount <= 0) return 0;
+  return ((index % resultCount) + resultCount) % resultCount;
+}
+
+function readTableRowCantSplit(
+  document: CanonicalDocumentEnvelope,
+  tableBlockIndex: number,
+  rowIndex: number,
+): boolean {
+  const root = document.content;
+  if (!root || root.type !== "doc") return false;
+  const block = root.children[tableBlockIndex];
+  if (!block || block.type !== "table") return false;
+  return block.rows[rowIndex]?.cantSplit === true;
+}
+
 function applyRegionAttributes(shell: HTMLElement): void {
   const toolbar = shell.querySelector<HTMLElement>("header");
   if (toolbar) {
@@ -5013,6 +5211,46 @@ function createSelectionToolbarWorkflowBadge(
   }
 }
 
+function createSelectionScopedInteractionGuardSnapshot(
+  base: InteractionGuardSnapshot,
+  posture: {
+    mode: "edit" | "suggest" | "comment" | "view" | "blocked";
+    disabledReason?: string;
+  },
+  workflowScopeSnapshot?: WorkflowScopeSnapshot | null,
+): InteractionGuardSnapshot {
+  if (posture.mode === "edit") {
+    return base;
+  }
+
+  const targetAccess =
+    posture.mode === "suggest"
+      ? "suggest"
+      : posture.mode === "comment"
+        ? "comment-only"
+        : posture.mode === "view"
+          ? "view-only"
+          : "blocked";
+  const blockedReasons =
+    posture.mode === "blocked" && posture.disabledReason
+      ? [{
+          code: "outside_workflow_scope" as const,
+          message: posture.disabledReason,
+          ...(workflowScopeSnapshot?.activeWorkItemId
+            ? { workItemId: workflowScopeSnapshot.activeWorkItemId }
+            : {}),
+        }]
+      : base.blockedReasons;
+
+  return {
+    ...base,
+    effectiveMode: posture.mode,
+    targetAccess,
+    ...(posture.disabledReason ? { disabledReason: posture.disabledReason } : {}),
+    blockedReasons,
+  };
+}
+
 function resolveSelectionWorkflowPosture(
   snapshot: RuntimeRenderSnapshot,
   viewState: ReturnType<WordReviewEditorRuntime["getViewState"]>,
@@ -5093,6 +5331,17 @@ function resolveSelectionWorkflowPosture(
         return activeRange.from >= scopeFrom && activeRange.to <= scopeTo;
       })
     : null;
+  const activeWorkItem = workflowScopeSnapshot?.activeWorkItem;
+  const activeWorkItemHasScopes = Boolean(
+    activeWorkItem &&
+      workflowScopeSnapshot?.scopes.some((scope) => scope.workItemId === activeWorkItem.workItemId),
+  );
+  if (activeRange && activeWorkItem && activeWorkItemHasScopes && !matchingScope) {
+    return {
+      mode: "blocked",
+      disabledReason: `Unavailable here. "${activeWorkItem.title}" only applies inside its assigned scope.`,
+    };
+  }
 
   if (matchingScope?.mode === "suggest") {
     return {

package/src/ui/editor-command-bag.ts

@@ -63,6 +63,17 @@ export interface EditorCommandBag {
   onMergeCells?(): void;
   onSplitCell?(): void;
   onSetCellBackground?(color: string): void;
+  onToggleRowHeader?(): void;
+  onToggleRowCantSplit?(): void;
+  onDistributeColumnsEvenly?(): void;
+  onSetTableAlignment?(alignment: "left" | "center" | "right"): void;
+  onSetCellVerticalAlign?(align: "top" | "center" | "bottom"): void;
+  onSetColumnWidth?(columnIndex: number, twips: number): void;
+  onSetRowHeight?(
+    rowIndex: number,
+    twips: number,
+    rule: "auto" | "atLeast" | "exact",
+  ): void;
   onSetImageLayout?(
     mediaId: string,
     dimensions: { widthEmu: number; heightEmu: number },

package/src/ui/editor-shell-view.tsx

@@ -11,6 +11,7 @@ import type {
   RuntimeContextAnalyticsSnapshot,
   RuntimeRenderSnapshot,
   StyleCatalogSnapshot,
+  TableStructureContextSnapshot,
   WordReviewEditorChromeOptions,
   WordReviewEditorChromePreset,
   WordReviewEditorChromeVisibility,
@@ -90,6 +91,8 @@ export interface EditorShellViewProps {
     import("../ui-tailwind/chrome/tw-workspace-chrome-host.tsx").TwWorkspaceChromeHostController
   >;
   commandPaletteDisabled?: boolean;
+  inlineFindBar?: ReactNode;
+  onOpenInlineFind?: () => void;
   /** P9g — live collab session for the `"collab"` chrome preset's top nav. */
   collabSession?: import("../runtime/collab-session.ts").CollabSession;
   collabTransportStatus?: import("../api/awareness-identity-types.ts").TransportStatus;
@@ -106,6 +109,7 @@ export interface EditorShellViewProps {
   currentScopeContextAnalytics?: RuntimeContextAnalyticsSnapshot | null;
   activeSelectionTool?: ActiveSelectionToolModel | null;
   selectionToolAnchor?: SelectionToolAnchor | null;
+  tableContext?: TableStructureContextSnapshot | null;
   documentNavigation?: DocumentNavigationSnapshot;
   commands: EditorCommandBag;
   shellHeader?: ReactNode;
@@ -185,6 +189,7 @@ export function EditorShellView(props: EditorShellViewProps) {
     onShellKeyDownCapture,
     document,
     commands,
+    inlineFindBar,
     ...workspaceProps
   } = props;
 
@@ -230,6 +235,11 @@ export function EditorShellView(props: EditorShellViewProps) {
         document={document}
         {...workspaceProps}
       />
+      {inlineFindBar ? (
+        <div className="pointer-events-none absolute right-6 top-16 z-50">
+          {inlineFindBar}
+        </div>
+      ) : null}
     </div>
   );
 }

package/src/ui/headless/chrome-registry.ts

@@ -170,7 +170,7 @@ export const TOOLBAR_CHROME_REGISTRY: ReadonlyArray<ToolbarChromeRegistryEntry>
     id: "text-style-selectors",
     surfaces: ["top-toolbar"],
     group: "text",
-    presets: ["advanced", "workflow"],
+    presets: ["advanced", "review", "workflow"],
     roles: ALL_ROLES,
     fullPlacement: "inline",
     compactPlacement: "overflow",
@@ -200,7 +200,7 @@ export const TOOLBAR_CHROME_REGISTRY: ReadonlyArray<ToolbarChromeRegistryEntry>
     id: "text-colors",
     surfaces: ["top-toolbar"],
     group: "text",
-    presets: ["simple", "advanced"],
+    presets: ["simple", "advanced", "review"],
     roles: EDITOR_AND_REVIEW,
     fullPlacement: "inline",
     compactPlacement: "inline",
@@ -214,7 +214,7 @@ export const TOOLBAR_CHROME_REGISTRY: ReadonlyArray<ToolbarChromeRegistryEntry>
     id: "paragraph-alignment",
     surfaces: ["top-toolbar"],
     group: "paragraph",
-    presets: ["simple", "advanced"],
+    presets: ["simple", "advanced", "review"],
     roles: EDITOR_AND_REVIEW,
     fullPlacement: "inline",
     compactPlacement: "inline",
@@ -266,7 +266,7 @@ export const TOOLBAR_CHROME_REGISTRY: ReadonlyArray<ToolbarChromeRegistryEntry>
     id: "insert-actions",
     surfaces: ["top-toolbar"],
     group: "document",
-    presets: ["simple", "advanced"],
+    presets: ["simple", "advanced", "review"],
     roles: EDITOR_ONLY,
     fullPlacement: "inline",
     compactPlacement: "overflow",
@@ -333,8 +333,8 @@ export const TOOLBAR_CHROME_REGISTRY: ReadonlyArray<ToolbarChromeRegistryEntry>
     surfaces: ["top-toolbar"],
     group: "review",
     presets: ["simple", "advanced", "review", "workflow"],
-    // Same ownership rule as `comment` — editor/review role regions own it.
-    roles: ALL_ROLES,
+    // Recording changes is review-authoring, not workflow/edit chrome.
+    roles: REVIEW_ONLY,
     fullPlacement: "inline",
     compactPlacement: "inline",
     runtimeBehavior: "always",

package/src/ui/headless/role-action-sets.ts

@@ -18,26 +18,20 @@ import type { ToolbarChromeItemId } from "./chrome-registry";
 /**
  * Ordered role-action ids.  Each array covers the *role-primary* actions
  * only — the general left cluster (history, formatting, style selectors)
- * and right cluster (tracked-changes, workspace mode, zoom, health,
- * export) stay in the base `TwToolbar` layout regardless of role.
+ * and right cluster (workspace mode, zoom, health, export) stay in the
+ * base `TwToolbar` layout regardless of role.
  */
 export const ROLE_ACTION_SETS: Record<
   EditorRole,
   ReadonlyArray<ToolbarChromeItemId>
 > = {
-  editor: [
-    // Comment + inline tracked-changes toggle are the two review-layer
-    // actions relevant to authoring.  They live in the role region rather
-    // than the right cluster so the right cluster stays view-focused.
-    "comment",
-    "tracked-changes-toggle",
-  ],
+  editor: [],
   review: [
     // Optional sidebar panel shortcuts — visible only when the host provides
     // hasSidebarPanelAccess (e.g. the harness).  Hidden in base runtime.
     "review-sidebar-tracked-changes",
     "review-sidebar-comments",
-    // Inline review actions shared with editor role.
+    // Inline review actions.
     "comment",
     "tracked-changes-toggle",
     // Queue navigation + counts, collapsed from the old TwReviewQueueBar.

package/src/ui/headless/selection-tool-resolver.ts

@@ -705,6 +705,17 @@ export function resolveSelectionWorkflowPosture(
         return activeRange.from >= scopeFrom && activeRange.to <= scopeTo;
       })
     : null;
+  const activeWorkItem = workflowScopeSnapshot?.activeWorkItem;
+  const activeWorkItemHasScopes = Boolean(
+    activeWorkItem &&
+      workflowScopeSnapshot?.scopes.some((scope) => scope.workItemId === activeWorkItem.workItemId),
+  );
+  if (activeRange && activeWorkItem && activeWorkItemHasScopes && !matchingScope) {
+    return {
+      mode: "blocked",
+      disabledReason: `Unavailable here. "${activeWorkItem.title}" only applies inside its assigned scope.`,
+    };
+  }
 
   if (matchingScope?.mode === "suggest") {
     return {

package/src/ui-tailwind/chrome/editor-action-registry.ts

@@ -599,7 +599,7 @@ export const EDITOR_ACTION_REGISTRY: readonly EditorAction[] = [
   mkImportant({
     id: "find",
     label: "Find…",
-    description: "Host search panel is not wired.",
+    description: "Find text in this document.",
     shortcut: ["Mod", "F"],
     group: "misc",
     targetKinds: [],

package/src/ui-tailwind/chrome/tw-context-band.tsx

@@ -14,12 +14,12 @@
  * children are whatever the mode owner decides to render inside:
  *   - review mode  → review prev/next + accept/reject + markup selector
  *   - workflow mode → scope prev/next + claim/skip/complete
- *   - edit mode    → (filled in by Phase D — paragraph style + compact
- *                     formatting cluster)
+ *   - edit mode    → no band unless a future pass adds real contextual
+ *                     authoring content; toolbar owns direct formatting
  *   - more mode    → diagnostics links + command search affordance
  *
- * Phase B.3 moves the band OUT of the toolbar so the workspace row is:
- *   [ toolbar left cluster ] · [ context band ] · [ toolbar right cluster ]
+ * Phase B.3 moves the band OUT of the toolbar so it sits below the shell
+ * header and above the toolbar when it has meaningful content.
  *
  * Perf discipline (CLAUDE.md §Performance Invariants):
  *   - Pure presentational component; no DOM reads, no runtime calls.
@@ -66,9 +66,9 @@ const DEFAULT_EYEBROW: Record<EditorChromeMode, string> = {
 /**
  * Accent tint classes per mode.  Review and workflow get a quiet
  * `color.accent.soft` tint so the band visually differs from the
- * neutral toolbar clusters flanking it; edit mode stays neutral per
- * DESIGN-EDITOR.md §3 ("Edit mode receives chrome to normal density,
- * no review emphasis").
+ * neutral toolbar clusters flanking it; edit mode stays neutral for
+ * compatibility with the composition model even though the workspace does
+ * not mount an empty editor band.
  *
  * "more" mode stays neutral (`bg-chrome`) because the More posture
  * opens diagnostics / compatibility drawers — the emphasis belongs on