@beyondwork/docx-react-component 1.0.37 → 1.0.39

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

@@ -1,4 +1,7 @@
-import type { WordReviewEditorChromePreset } from "../../api/public-types";
+import type {
+  EditorRole,
+  WordReviewEditorChromePreset,
+} from "../../api/public-types";
 import type { SelectionToolKind } from "./selection-tool-types";
 
 export type ChromeSurface = "top-toolbar" | "selection-tool";
@@ -6,6 +9,7 @@ export type ChromeDensity = "compact";
 export type ToolbarChromePlacement = "inline" | "overflow" | "hidden";
 
 export type ToolbarChromeItemId =
+  // Universal formatting + history
   | "history"
   | "text-style-selectors"
   | "inline-formatting"
@@ -24,7 +28,27 @@ export type ToolbarChromeItemId =
   | "workspace-mode"
   | "zoom"
   | "health"
-  | "export";
+  | "export"
+  // R1: role-scoped action region entries
+  | "editor-scope-posture-menu"
+  | "review-sidebar-tracked-changes"
+  | "review-sidebar-comments"
+  | "review-queue-prev"
+  | "review-queue-next"
+  | "review-queue-counts"
+  | "review-queue-active-label"
+  | "review-accept"
+  | "review-reject"
+  | "review-accept-all"
+  | "review-reject-all"
+  | "review-markup-mode"
+  | "workflow-prev"
+  | "workflow-next"
+  | "workflow-mark-complete"
+  | "workflow-claim"
+  | "workflow-skip"
+  | "workflow-mark-blocked"
+  | "workflow-jump-to-scope";
 
 export interface ChromeRegistryEntryBase {
   id: string;
@@ -42,12 +66,33 @@ export interface ToolbarChromeRegistryEntry extends ChromeRegistryEntryBase {
   id: ToolbarChromeItemId;
   surfaces: ["top-toolbar"];
   presets: ReadonlyArray<WordReviewEditorChromePreset>;
+  /**
+   * Roles in which this entry appears.  Empty = appears in every role.
+   * R1 uses this to filter the inline action set down to the per-role
+   * matrix described in the chrome-phase plan.
+   */
+  roles: ReadonlyArray<EditorRole>;
   fullPlacement: Exclude<ToolbarChromePlacement, "hidden">;
   compactPlacement: ToolbarChromePlacement;
-  runtimeBehavior: "always" | "formatting" | "structure" | "comment";
+  runtimeBehavior: "always" | "formatting" | "structure" | "comment" | "sidebar-panel";
   scopeBehavior?: "default" | "scoped-only" | "hidden-when-scoped";
+  /**
+   * Optional per-role placement override.  When a role overrides the
+   * placement (for instance, "text-style-selectors" is `inline` in editor
+   * but `overflow` in review/workflow), list the role-specific placement
+   * here.  Missing roles inherit `fullPlacement` / `compactPlacement`.
+   */
+  rolePlacement?: Partial<
+    Record<EditorRole, Exclude<ToolbarChromePlacement, "hidden">>
+  >;
 }
 
+const ALL_ROLES: ReadonlyArray<EditorRole> = ["editor", "review", "workflow"];
+const EDITOR_ONLY: ReadonlyArray<EditorRole> = ["editor"];
+const REVIEW_ONLY: ReadonlyArray<EditorRole> = ["review"];
+const WORKFLOW_ONLY: ReadonlyArray<EditorRole> = ["workflow"];
+const EDITOR_AND_REVIEW: ReadonlyArray<EditorRole> = ["editor", "review"];
+
 export const SELECTION_TOOL_REGISTRY: ReadonlyArray<SelectionToolRegistryEntry> = [
   { id: "suggestion-review", surfaces: ["selection-tool"], group: "review", precedence: 10 },
   { id: "comment-thread", surfaces: ["selection-tool"], group: "review", precedence: 20 },
@@ -62,7 +107,8 @@ export const TOOLBAR_CHROME_REGISTRY: ReadonlyArray<ToolbarChromeRegistryEntry>
     id: "history",
     surfaces: ["top-toolbar"],
     group: "history",
-    presets: ["simple", "advanced", "review"],
+    presets: ["simple", "advanced", "review", "workflow"],
+    roles: ALL_ROLES,
     fullPlacement: "inline",
     compactPlacement: "inline",
     runtimeBehavior: "always",
@@ -71,61 +117,94 @@ export const TOOLBAR_CHROME_REGISTRY: ReadonlyArray<ToolbarChromeRegistryEntry>
     id: "text-style-selectors",
     surfaces: ["top-toolbar"],
     group: "text",
-    presets: ["advanced"],
+    presets: ["advanced", "workflow"],
+    roles: ALL_ROLES,
     fullPlacement: "inline",
     compactPlacement: "overflow",
     runtimeBehavior: "formatting",
+    rolePlacement: {
+      editor: "inline",
+      review: "overflow",
+      workflow: "overflow",
+    },
   },
   {
     id: "inline-formatting",
     surfaces: ["top-toolbar"],
     group: "text",
-    presets: ["simple", "advanced", "review"],
+    presets: ["simple", "advanced", "review", "workflow"],
+    roles: ALL_ROLES,
     fullPlacement: "inline",
     compactPlacement: "inline",
     runtimeBehavior: "formatting",
+    rolePlacement: {
+      editor: "inline",
+      review: "overflow",
+      workflow: "overflow",
+    },
   },
   {
     id: "text-colors",
     surfaces: ["top-toolbar"],
     group: "text",
     presets: ["simple", "advanced"],
+    roles: EDITOR_AND_REVIEW,
     fullPlacement: "inline",
     compactPlacement: "inline",
     runtimeBehavior: "formatting",
+    rolePlacement: {
+      editor: "inline",
+      review: "overflow",
+    },
   },
   {
     id: "paragraph-alignment",
     surfaces: ["top-toolbar"],
     group: "paragraph",
     presets: ["simple", "advanced"],
+    roles: EDITOR_AND_REVIEW,
     fullPlacement: "inline",
     compactPlacement: "inline",
     runtimeBehavior: "formatting",
+    rolePlacement: {
+      editor: "inline",
+      review: "overflow",
+    },
   },
   {
     id: "list-actions",
     surfaces: ["top-toolbar"],
     group: "paragraph",
     presets: ["simple", "advanced"],
+    roles: EDITOR_AND_REVIEW,
     fullPlacement: "inline",
     compactPlacement: "overflow",
     runtimeBehavior: "formatting",
+    rolePlacement: {
+      editor: "inline",
+      review: "overflow",
+    },
   },
   {
     id: "indentation",
     surfaces: ["top-toolbar"],
     group: "paragraph",
     presets: ["simple", "advanced"],
+    roles: EDITOR_AND_REVIEW,
     fullPlacement: "inline",
     compactPlacement: "overflow",
     runtimeBehavior: "formatting",
+    rolePlacement: {
+      editor: "inline",
+      review: "overflow",
+    },
   },
   {
     id: "list-continuation",
     surfaces: ["top-toolbar"],
     group: "paragraph",
     presets: ["simple", "advanced"],
+    roles: EDITOR_ONLY,
     fullPlacement: "inline",
     compactPlacement: "overflow",
     runtimeBehavior: "formatting",
@@ -135,6 +214,7 @@ export const TOOLBAR_CHROME_REGISTRY: ReadonlyArray<ToolbarChromeRegistryEntry>
     surfaces: ["top-toolbar"],
     group: "document",
     presets: ["simple", "advanced"],
+    roles: EDITOR_ONLY,
     fullPlacement: "inline",
     compactPlacement: "overflow",
     runtimeBehavior: "structure",
@@ -145,6 +225,7 @@ export const TOOLBAR_CHROME_REGISTRY: ReadonlyArray<ToolbarChromeRegistryEntry>
     surfaces: ["top-toolbar"],
     group: "document",
     presets: ["advanced"],
+    roles: EDITOR_ONLY,
     fullPlacement: "inline",
     compactPlacement: "overflow",
     runtimeBehavior: "structure",
@@ -154,7 +235,8 @@ export const TOOLBAR_CHROME_REGISTRY: ReadonlyArray<ToolbarChromeRegistryEntry>
     id: "scope-status",
     surfaces: ["top-toolbar"],
     group: "scope",
-    presets: ["simple", "advanced", "review"],
+    presets: ["simple", "advanced", "review", "workflow"],
+    roles: ALL_ROLES,
     fullPlacement: "inline",
     compactPlacement: "inline",
     runtimeBehavior: "always",
@@ -164,7 +246,8 @@ export const TOOLBAR_CHROME_REGISTRY: ReadonlyArray<ToolbarChromeRegistryEntry>
     id: "story-breadcrumb",
     surfaces: ["top-toolbar"],
     group: "scope",
-    presets: ["simple", "advanced", "review"],
+    presets: ["simple", "advanced", "review", "workflow"],
+    roles: ALL_ROLES,
     fullPlacement: "inline",
     compactPlacement: "inline",
     runtimeBehavior: "always",
@@ -173,7 +256,8 @@ export const TOOLBAR_CHROME_REGISTRY: ReadonlyArray<ToolbarChromeRegistryEntry>
     id: "sidebar-toggle",
     surfaces: ["top-toolbar"],
     group: "review",
-    presets: ["simple", "advanced", "review"],
+    presets: ["simple", "advanced", "review", "workflow"],
+    roles: ALL_ROLES,
     fullPlacement: "inline",
     compactPlacement: "inline",
     runtimeBehavior: "always",
@@ -182,7 +266,11 @@ export const TOOLBAR_CHROME_REGISTRY: ReadonlyArray<ToolbarChromeRegistryEntry>
     id: "comment",
     surfaces: ["top-toolbar"],
     group: "review",
-    presets: ["simple", "advanced", "review"],
+    presets: ["simple", "advanced", "review", "workflow"],
+    // Visible in every role, but editor/review roles render it inside the
+    // role action region (see ROLE_ACTION_SETS) and the right cluster
+    // suppresses it via `isChromeItemOwnedByRoleRegion` to avoid duplication.
+    roles: ALL_ROLES,
     fullPlacement: "inline",
     compactPlacement: "inline",
     runtimeBehavior: "comment",
@@ -191,7 +279,9 @@ export const TOOLBAR_CHROME_REGISTRY: ReadonlyArray<ToolbarChromeRegistryEntry>
     id: "tracked-changes-toggle",
     surfaces: ["top-toolbar"],
     group: "review",
-    presets: ["advanced", "review"],
+    presets: ["simple", "advanced", "review", "workflow"],
+    // Same ownership rule as `comment` — editor/review role regions own it.
+    roles: ALL_ROLES,
     fullPlacement: "inline",
     compactPlacement: "inline",
     runtimeBehavior: "always",
@@ -200,7 +290,8 @@ export const TOOLBAR_CHROME_REGISTRY: ReadonlyArray<ToolbarChromeRegistryEntry>
     id: "workspace-mode",
     surfaces: ["top-toolbar"],
     group: "view",
-    presets: ["simple", "advanced", "review"],
+    presets: ["simple", "advanced", "review", "workflow"],
+    roles: ALL_ROLES,
     fullPlacement: "inline",
     compactPlacement: "inline",
     runtimeBehavior: "always",
@@ -209,7 +300,8 @@ export const TOOLBAR_CHROME_REGISTRY: ReadonlyArray<ToolbarChromeRegistryEntry>
     id: "zoom",
     surfaces: ["top-toolbar"],
     group: "view",
-    presets: ["simple", "advanced", "review"],
+    presets: ["simple", "advanced", "review", "workflow"],
+    roles: ALL_ROLES,
     fullPlacement: "inline",
     compactPlacement: "inline",
     runtimeBehavior: "always",
@@ -218,7 +310,8 @@ export const TOOLBAR_CHROME_REGISTRY: ReadonlyArray<ToolbarChromeRegistryEntry>
     id: "health",
     surfaces: ["top-toolbar"],
     group: "status",
-    presets: ["simple", "advanced", "review"],
+    presets: ["simple", "advanced", "review", "workflow"],
+    roles: ALL_ROLES,
     fullPlacement: "inline",
     compactPlacement: "inline",
     runtimeBehavior: "always",
@@ -227,9 +320,211 @@ export const TOOLBAR_CHROME_REGISTRY: ReadonlyArray<ToolbarChromeRegistryEntry>
     id: "export",
     surfaces: ["top-toolbar"],
     group: "status",
-    presets: ["simple", "advanced", "review"],
+    presets: ["simple", "advanced", "review", "workflow"],
+    roles: ALL_ROLES,
+    fullPlacement: "inline",
+    compactPlacement: "inline",
+    runtimeBehavior: "always",
+  },
+
+  // ───── R1: Workflow-role scope posture menu ───────────────────────────
+  {
+    id: "editor-scope-posture-menu",
+    surfaces: ["top-toolbar"],
+    group: "scope",
+    presets: ["advanced", "review", "workflow"],
+    // Scoping/tagging is a workflow-primary action; moved from editor role.
+    roles: WORKFLOW_ONLY,
+    fullPlacement: "inline",
+    compactPlacement: "overflow",
+    runtimeBehavior: "always",
+  },
+
+  // ───── R1: Review-role sidebar panel toggles (optional, host-provided) ─
+  {
+    id: "review-sidebar-tracked-changes",
+    surfaces: ["top-toolbar"],
+    group: "review-sidebar",
+    presets: ["review"],
+    roles: REVIEW_ONLY,
+    fullPlacement: "inline",
+    compactPlacement: "inline",
+    // Hidden unless the host provides the sidebar panel callback via
+    // hasSidebarPanelAccess in ResolveScopedChromePolicyInput.
+    runtimeBehavior: "sidebar-panel",
+  },
+  {
+    id: "review-sidebar-comments",
+    surfaces: ["top-toolbar"],
+    group: "review-sidebar",
+    presets: ["review"],
+    roles: REVIEW_ONLY,
+    fullPlacement: "inline",
+    compactPlacement: "inline",
+    runtimeBehavior: "sidebar-panel",
+  },
+
+  // ───── R1: Review-role primaries ──────────────────────────────────────
+  {
+    id: "review-queue-prev",
+    surfaces: ["top-toolbar"],
+    group: "review-queue",
+    presets: ["review", "workflow"],
+    roles: REVIEW_ONLY,
+    fullPlacement: "inline",
+    compactPlacement: "inline",
+    runtimeBehavior: "always",
+  },
+  {
+    id: "review-queue-next",
+    surfaces: ["top-toolbar"],
+    group: "review-queue",
+    presets: ["review", "workflow"],
+    roles: REVIEW_ONLY,
+    fullPlacement: "inline",
+    compactPlacement: "inline",
+    runtimeBehavior: "always",
+  },
+  {
+    id: "review-queue-counts",
+    surfaces: ["top-toolbar"],
+    group: "review-queue",
+    presets: ["review"],
+    roles: REVIEW_ONLY,
+    fullPlacement: "inline",
+    compactPlacement: "overflow",
+    runtimeBehavior: "always",
+  },
+  {
+    id: "review-queue-active-label",
+    surfaces: ["top-toolbar"],
+    group: "review-queue",
+    presets: ["review"],
+    roles: REVIEW_ONLY,
+    fullPlacement: "inline",
+    compactPlacement: "overflow",
+    runtimeBehavior: "always",
+  },
+  {
+    id: "review-accept",
+    surfaces: ["top-toolbar"],
+    group: "review-action",
+    presets: ["review"],
+    roles: REVIEW_ONLY,
     fullPlacement: "inline",
     compactPlacement: "inline",
     runtimeBehavior: "always",
   },
+  {
+    id: "review-reject",
+    surfaces: ["top-toolbar"],
+    group: "review-action",
+    presets: ["review"],
+    roles: REVIEW_ONLY,
+    fullPlacement: "inline",
+    compactPlacement: "inline",
+    runtimeBehavior: "always",
+  },
+  {
+    id: "review-accept-all",
+    surfaces: ["top-toolbar"],
+    group: "review-action",
+    presets: ["review"],
+    roles: REVIEW_ONLY,
+    fullPlacement: "inline",
+    compactPlacement: "overflow",
+    runtimeBehavior: "always",
+  },
+  {
+    id: "review-reject-all",
+    surfaces: ["top-toolbar"],
+    group: "review-action",
+    presets: ["review"],
+    roles: REVIEW_ONLY,
+    fullPlacement: "inline",
+    compactPlacement: "overflow",
+    runtimeBehavior: "always",
+  },
+  {
+    id: "review-markup-mode",
+    surfaces: ["top-toolbar"],
+    group: "review-action",
+    presets: ["review"],
+    roles: REVIEW_ONLY,
+    fullPlacement: "inline",
+    compactPlacement: "inline",
+    runtimeBehavior: "always",
+  },
+
+  // ───── R1: Workflow-role primaries ────────────────────────────────────
+  {
+    id: "workflow-prev",
+    surfaces: ["top-toolbar"],
+    group: "workflow-queue",
+    presets: ["workflow"],
+    roles: WORKFLOW_ONLY,
+    fullPlacement: "inline",
+    compactPlacement: "inline",
+    runtimeBehavior: "always",
+  },
+  {
+    id: "workflow-next",
+    surfaces: ["top-toolbar"],
+    group: "workflow-queue",
+    presets: ["workflow"],
+    roles: WORKFLOW_ONLY,
+    fullPlacement: "inline",
+    compactPlacement: "inline",
+    runtimeBehavior: "always",
+  },
+  {
+    id: "workflow-mark-complete",
+    surfaces: ["top-toolbar"],
+    group: "workflow-action",
+    presets: ["workflow"],
+    roles: WORKFLOW_ONLY,
+    fullPlacement: "inline",
+    compactPlacement: "inline",
+    runtimeBehavior: "always",
+  },
+  {
+    id: "workflow-claim",
+    surfaces: ["top-toolbar"],
+    group: "workflow-action",
+    presets: ["workflow"],
+    roles: WORKFLOW_ONLY,
+    fullPlacement: "inline",
+    compactPlacement: "inline",
+    runtimeBehavior: "always",
+  },
+  {
+    id: "workflow-skip",
+    surfaces: ["top-toolbar"],
+    group: "workflow-action",
+    presets: ["workflow"],
+    roles: WORKFLOW_ONLY,
+    fullPlacement: "inline",
+    compactPlacement: "overflow",
+    runtimeBehavior: "always",
+  },
+  {
+    id: "workflow-mark-blocked",
+    surfaces: ["top-toolbar"],
+    group: "workflow-action",
+    presets: ["workflow"],
+    roles: WORKFLOW_ONLY,
+    fullPlacement: "inline",
+    compactPlacement: "overflow",
+    runtimeBehavior: "always",
+  },
+  {
+    id: "workflow-jump-to-scope",
+    surfaces: ["top-toolbar"],
+    group: "workflow-action",
+    presets: ["workflow"],
+    roles: WORKFLOW_ONLY,
+    fullPlacement: "inline",
+    compactPlacement: "overflow",
+    runtimeBehavior: "always",
+  },
 ];

package/src/ui/headless/scoped-chrome-policy.ts

@@ -1,5 +1,6 @@
 import type {
   ActiveListContext,
+  EditorRole,
   InteractionGuardSnapshot,
   WorkflowScopeSnapshot,
   WordReviewEditorChromePreset,
@@ -10,6 +11,7 @@ import {
   type ToolbarChromeItemId,
   type ToolbarChromePlacement,
 } from "./chrome-registry";
+import { ROLE_ACTION_SETS } from "../../ui-tailwind/chrome/role-action-sets";
 import type { SelectionToolKind } from "./selection-tool-types";
 
 export interface ToolbarChromeItemPolicy {
@@ -36,6 +38,20 @@ export interface ResolveScopedChromePolicyInput {
   interactionGuardSnapshot?: InteractionGuardSnapshot;
   workflowScopeSnapshot?: WorkflowScopeSnapshot | null;
   activeListContext?: ActiveListContext | null;
+  /**
+   * Active chrome role (spec §6.4).  When supplied, the policy filters
+   * registry entries whose `roles` array excludes the active role.  When
+   * omitted, the preset filter alone drives visibility (back-compat for
+   * callers that haven't adopted the role model yet).
+   */
+  role?: EditorRole;
+  /**
+   * Whether the host has wired sidebar-panel callbacks
+   * (`onReviewSidebarTrackedChanges` / `onReviewSidebarComments`).
+   * Defaults to `false` — sidebar panel buttons are hidden unless the host
+   * explicitly opts in (typically the harness).
+   */
+  hasSidebarPanelAccess?: boolean;
 }
 
 export function resolveScopedChromePolicy(
@@ -62,6 +78,13 @@ export function resolveScopedChromePolicy(
     TOOLBAR_CHROME_REGISTRY.map((entry) => {
       let visible = entry.presets.includes(input.preset);
 
+      // Role filter — apply only when the caller supplied a role so existing
+      // host apps that haven't adopted the role model keep the pre-R1
+      // behavior (preset + capability only).
+      if (visible && input.role !== undefined) {
+        visible = entry.roles.includes(input.role);
+      }
+
       if (visible) {
         switch (entry.runtimeBehavior) {
           case "formatting":
@@ -73,6 +96,9 @@ export function resolveScopedChromePolicy(
           case "comment":
             visible = canAddComment;
             break;
+          case "sidebar-panel":
+            visible = Boolean(input.hasSidebarPanelAccess);
+            break;
           default:
             visible = true;
             break;
@@ -93,8 +119,12 @@ export function resolveScopedChromePolicy(
         visible = !hasScopedContext;
       }
 
+      // Resolve placement: when the entry overrides placement for the
+      // active role, that wins over the preset-density default.
+      const fullPlacement =
+        (input.role && entry.rolePlacement?.[input.role]) ?? entry.fullPlacement;
       const placement = visible
-        ? (input.compactMode ? entry.compactPlacement : entry.fullPlacement)
+        ? (input.compactMode ? entry.compactPlacement : fullPlacement)
         : "hidden";
       const enabled =
         visible &&
@@ -133,6 +163,24 @@ export function isToolbarChromeItemVisible(
   return policy.toolbar[itemId]?.visible ?? false;
 }
 
+/**
+ * Returns true when the given chrome item is owned by the active role's
+ * inline role-action region (i.e. it appears in `ROLE_ACTION_SETS[role]`).
+ * The right-cluster render path uses this to suppress its own copy so we
+ * don't render the same button twice.
+ *
+ * When `role` is undefined (legacy host, no role model adopted) this
+ * returns `false` — the right cluster keeps ownership per the pre-R1
+ * layout.
+ */
+export function isChromeItemOwnedByRoleRegion(
+  itemId: ToolbarChromeItemId,
+  role: EditorRole | undefined,
+): boolean {
+  if (!role) return false;
+  return ROLE_ACTION_SETS[role].includes(itemId);
+}
+
 export function getToolbarChromePlacement(
   policy: ScopedChromePolicy,
   itemId: ToolbarChromeItemId,

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

@@ -59,6 +59,16 @@ export interface FormattingInlineSelectionToolModel extends BaseSelectionToolMod
   italicActive: boolean;
   underlineActive: boolean;
   canAddComment: boolean;
+  /**
+   * One-click "apply" color for the text-color affordance.  R2.5 plumbs
+   * the current `formattingState.textColor` (or the user's most recent
+   * pick) here so the mini-toolbar reflects the active color instead of
+   * a hardcoded blue.  Consumers fall back to a fixed default when
+   * absent.
+   */
+  textColorDefault?: string;
+  /** Matching one-click highlight color.  See `textColorDefault`. */
+  highlightColorDefault?: string;
 }
 
 export interface SuggestionReviewSelectionToolModel extends BaseSelectionToolModel {

package/src/ui-tailwind/chrome/chrome-preset-model.ts

@@ -7,12 +7,15 @@ import type {
 
 export function resolveChromePreset(
   chromePreset: WordReviewEditorProps["chromePreset"],
-  _reviewMode: WordReviewEditorProps["reviewMode"] = "review",
+  reviewMode: WordReviewEditorProps["reviewMode"] = "review",
 ): WordReviewEditorChromePreset {
   if (chromePreset) {
     return chromePreset;
   }
-  return "advanced";
+  // When the host does not set an explicit preset, pick one from the
+  // review-mode signal so review sessions get the review strip inline
+  // with the toolbar (rather than the density default "advanced").
+  return reviewMode === "review" ? "review" : "advanced";
 }
 
 export function resolveChromePresetOptions(
@@ -40,6 +43,14 @@ export function resolveChromePresetOptions(
       showSectionTagAction: true,
       showReviewRail: true,
     },
+    workflow: {
+      // Workflow role consolidates prev/next + mark-section into the top
+      // toolbar via the role-action region, so the separate queue bar
+      // strip is suppressed.
+      showReviewQueueBar: false,
+      showSectionTagAction: false,
+      showReviewRail: true,
+    },
   };
 
   return {
@@ -95,6 +106,16 @@ export function resolveChromeVisibilityForPreset(input: {
       statusBar: true,
       reviewRail: options.showReviewRail,
     },
+    workflow: {
+      toolbar: true,
+      alerts: true,
+      selectionOverlay: true,
+      contextToolbars: true,
+      contextAnalytics: true,
+      pageChrome: true,
+      statusBar: true,
+      reviewRail: options.showReviewRail,
+    },
   };
 
   return {

package/src/ui-tailwind/chrome/review-queue-bar.tsx

@@ -1,15 +1,15 @@
 import React from "react";
 
-import { BookmarkPlus, ChevronLeft, ChevronRight, MessageSquareText, Rows3 } from "lucide-react";
+import { ChevronLeft, ChevronRight, MessageSquareText, Rows3 } from "lucide-react";
 
 import type { ReviewQueueSnapshot } from "../../api/public-types";
 import { preserveEditorSelectionMouseDown } from "../../ui/headless/preserve-editor-selection";
 
+/** @deprecated Use the role action region (TwRoleActionRegion) for queue navigation. */
 export interface TwReviewQueueBarProps {
   queue: ReviewQueueSnapshot;
   onPrevious?: () => void;
   onNext?: () => void;
-  onMarkSection?: () => void;
 }
 
 const buttonClass =
@@ -47,18 +47,6 @@ export function TwReviewQueueBar(props: TwReviewQueueBarProps) {
           Next
           <ChevronRight className="h-3.5 w-3.5" />
         </button>
-        {props.onMarkSection ? (
-          <button
-            type="button"
-            aria-label="Mark section for review"
-            className={buttonClass}
-            onMouseDown={preserveEditorSelectionMouseDown}
-            onClick={props.onMarkSection}
-          >
-            <BookmarkPlus className="h-3.5 w-3.5" />
-            Mark section
-          </button>
-        ) : null}
         <div className="ml-auto flex flex-wrap items-center gap-2 text-xs text-secondary">
           <span className="inline-flex items-center gap-1 rounded-full bg-canvas px-2.5 py-1 font-medium text-primary">
             <MessageSquareText className="h-3.5 w-3.5 text-comment" />