@beyondwork/docx-react-component 1.0.105 → 1.0.108

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

@@ -6,15 +6,19 @@ import type {
   EditorError,
   EditorRole,
   FormattingStateSnapshot,
+  GeometryFacet,
   InteractionGuardSnapshot,
   ReviewQueueSnapshot,
   RuntimeContextAnalyticsSnapshot,
   RuntimeRenderSnapshot,
+  CollabSession,
   StyleCatalogSnapshot,
   TableStructureContextSnapshot,
+  WordReviewEditorLayoutFacet,
   WordReviewEditorChromeOptions,
   WordReviewEditorChromePreset,
   WordReviewEditorChromeVisibility,
+  WorkflowFacet,
   WorkflowScopeSnapshot,
   WorkspaceMode,
   ZoomLevel,
@@ -30,6 +34,10 @@ import type { ReviewRailTab } from "../ui-tailwind/review/tw-review-rail.tsx";
 import { TwReviewWorkspace } from "../ui-tailwind/tw-review-workspace.tsx";
 import type { EditorViewStateSnapshot } from "../api/public-types.ts";
 import type { MediaPreviewDescriptor } from "../ui-tailwind/editor-surface/pm-state-from-snapshot.ts";
+import type {
+  UiObjectDragSession,
+  UiObjectDragStartInput,
+} from "../api/v3/ui/_types.ts";
 
 export interface EditorShellViewProps {
   shellRef: React.RefObject<HTMLDivElement | null>;
@@ -64,7 +72,7 @@ export interface EditorShellViewProps {
    * ChromeOverlay (scope rail, workflow dock, etc.) can render over the
    * document column and the review rail's Workflow tab can read segments.
    */
-  layoutFacet?: import("../runtime/layout/index.ts").WordReviewEditorLayoutFacet;
+  layoutFacet?: WordReviewEditorLayoutFacet;
   /**
    * Layer-05 geometry facet (`runtime.geometry`). Passed through to
    * `TwReviewWorkspace` which forwards it to the chrome overlay
@@ -73,7 +81,7 @@ export interface EditorShellViewProps {
    * `layoutFacet.getRenderFrame` / `.getRenderZoom` in refactor/05
    * cross-lane-coord §8.4.
    */
-  geometryFacet?: import("../runtime/geometry/index.ts").GeometryFacet;
+  geometryFacet?: GeometryFacet;
   /**
    * Layer-06 workflow facet — canonical source of scope rail segments +
    * scope card models. Passed through to `TwReviewWorkspace` which
@@ -81,7 +89,7 @@ export interface EditorShellViewProps {
    * Slice 4 made this the owning seam; the layout facet no longer
    * exposes rail/card data.
    */
-  workflowFacet?: import("../runtime/workflow/rail/types.ts").WorkflowFacet;
+  workflowFacet?: WorkflowFacet;
   interactionGuardSnapshot?: InteractionGuardSnapshot;
   chromePreset?: WordReviewEditorChromePreset;
   chromeOptions?: Partial<WordReviewEditorChromeOptions>;
@@ -94,7 +102,7 @@ export interface EditorShellViewProps {
   inlineFindBar?: ReactNode;
   onOpenInlineFind?: () => void;
   /** P9g — live collab session for the `"collab"` chrome preset's top nav. */
-  collabSession?: import("../runtime/collab-session.ts").CollabSession;
+  collabSession?: CollabSession;
   collabTransportStatus?: import("../api/awareness-identity-types.ts").TransportStatus;
   collabActorId?: string;
   collabSendBaseline?: {
@@ -168,6 +176,8 @@ export interface EditorShellViewProps {
   }) => void;
   /** N6 — deselects the currently grabbed object; wired to runtime.deselectObject(). */
   onDeselectObject?: () => void;
+  /** Object handle drag lifecycle; routed through the mounted UI API seam. */
+  onBeginObjectDrag?: (input: UiObjectDragStartInput) => UiObjectDragSession;
   mediaPreviews?: Record<string, MediaPreviewDescriptor>;
   onActivateFloatingImage?: (payload: {
     mediaId: string;

package/src/ui/editor-surface-controller.tsx

@@ -4,10 +4,12 @@ import type {
   DocumentNavigationSnapshot,
   EditorStoryTarget,
   EditorUser,
+  GeometryFacet,
   RuntimeRenderSnapshot,
   SearchOptions,
   SearchResultSnapshot,
   SelectionSnapshot,
+  WordReviewEditorLayoutFacet,
   WorkflowBlockedCommandReason,
   WorkflowCandidateRange,
   WorkflowLockedZone,
@@ -33,7 +35,7 @@ export interface EditorSurfaceControllerProps {
   documentNavigation: DocumentNavigationSnapshot;
   reviewMode: "editing" | "review";
   markupDisplay: MarkupDisplay;
-  showUnsupportedObjectPreviews?: boolean;
+  unsupportedObjectPreviewsVisible?: boolean;
   activeRevisionId?: string;
   activeSelectionToolKind?: ActiveSelectionToolModel["kind"] | null;
   showTrackedChanges?: boolean;
@@ -113,12 +115,12 @@ export interface EditorSurfaceControllerProps {
   dispatchRuntimeCommand?: (
     command: import("../ui-tailwind/editor-surface/fast-text-edit-lane.ts").LaneRuntimeCommand,
   ) => import("../api/public-types.ts").TextCommandAck;
-  layoutFacet?: import("../runtime/layout/index.ts").WordReviewEditorLayoutFacet;
+  layoutFacet?: WordReviewEditorLayoutFacet;
   /**
    * Geometry facet forwarded to `TwProseMirrorSurface` for page-break
    * decoration build path (refactor/05 cross-lane-coord §8.4).
    */
-  geometryFacet?: import("../runtime/geometry/index.ts").GeometryFacet;
+  geometryFacet?: GeometryFacet;
   pageChromeHeaderBandPx?: number;
   pageChromeFooterBandPx?: number;
   pageChromeInterGapPx?: number;

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

@@ -376,8 +376,7 @@ export function buildStructureContextSelectionToolModel(
     ),
   );
   const isTableTextRangeContext =
-    input.activeTableContext?.selectionKind === "text" &&
-    !input.snapshot.selection.isCollapsed;
+    input.activeTableContext?.selectionKind === "text";
   if (isTableTextRangeContext) {
     return null;
   }

package/src/ui/presence-overlay-lane.ts

@@ -0,0 +1,130 @@
+import {
+  getRemoteCursorStates,
+  type RemoteCursorState,
+} from "../api/v3/runtime/collab.ts";
+import type {
+  GeometryRect,
+  UiListener,
+  UiOverlayLaneKind,
+  UiOverlayLaneSnapshot,
+  UiOverlayLaneStatus,
+  UiUnsubscribe,
+} from "../api/v3/ui/_types.ts";
+
+type AwarenessChangeListener = () => void;
+
+export interface PresenceAwarenessSource {
+  readonly clientID: number;
+  getStates(): Map<number, Record<string, unknown>>;
+  on(event: "change", listener: AwarenessChangeListener): void;
+  off(event: "change", listener: AwarenessChangeListener): void;
+}
+
+export type PresenceCursorProjection =
+  | { readonly status: "resolved"; readonly rects: readonly GeometryRect[]; readonly reason?: string }
+  | { readonly status: "requires-rehydration" | "unavailable"; readonly rects?: undefined; readonly reason?: string };
+
+export interface PresenceOverlayLaneSourceOptions {
+  readonly awareness: PresenceAwarenessSource;
+  readonly localClientId?: number;
+  readonly getRevision?: () => number;
+  readonly projectCursor?: (cursor: RemoteCursorState) => PresenceCursorProjection;
+}
+
+export interface PresenceOverlayLaneSource {
+  getLane(kind: UiOverlayLaneKind): UiOverlayLaneSnapshot;
+  subscribeLane(
+    kind: UiOverlayLaneKind,
+    listener: UiListener<UiOverlayLaneSnapshot>,
+  ): UiUnsubscribe;
+}
+
+function unavailable(kind: UiOverlayLaneKind, reason: string): UiOverlayLaneSnapshot {
+  return Object.freeze({
+    kind,
+    status: "unavailable",
+    entries: Object.freeze([]),
+    revision: 0,
+    source: "unavailable",
+    reason,
+  } as const);
+}
+
+function coerceLaneStatus(
+  current: UiOverlayLaneStatus,
+  next: UiOverlayLaneStatus,
+): UiOverlayLaneStatus {
+  if (current === "unavailable" || next === "unavailable") return "unavailable";
+  if (current === "requires-rehydration" || next === "requires-rehydration") {
+    return "requires-rehydration";
+  }
+  return "resolved";
+}
+
+export function createPresenceOverlayLaneSource(
+  options: PresenceOverlayLaneSourceOptions,
+): PresenceOverlayLaneSource {
+  const localClientId = options.localClientId ?? options.awareness.clientID;
+
+  function readPresenceLane(): UiOverlayLaneSnapshot {
+    const cursors = getRemoteCursorStates(
+      options.awareness as Parameters<typeof getRemoteCursorStates>[0],
+      localClientId,
+    );
+    let laneStatus: UiOverlayLaneStatus = "resolved";
+    const entries = cursors.map((cursor) => {
+      const projection = options.projectCursor?.(cursor) ?? {
+        status: "requires-rehydration" as const,
+        reason: "presence cursor geometry projection is not wired",
+      };
+      laneStatus = coerceLaneStatus(laneStatus, projection.status);
+      return {
+        id: `presence:${cursor.userId}`,
+        status: projection.status,
+        ...(projection.rects ? { rects: projection.rects } : {}),
+        ...(projection.reason ? { reason: projection.reason } : {}),
+        data: {
+          kind: "remote-cursor",
+          userId: cursor.userId,
+          displayName: cursor.displayName,
+          color: cursor.color,
+          anchor: cursor.anchor,
+          head: cursor.head,
+          storyTarget: cursor.storyTarget,
+        },
+      };
+    });
+
+    return {
+      kind: "presence",
+      status: entries.length === 0 ? "resolved" : laneStatus,
+      entries,
+      revision: options.getRevision?.() ?? 0,
+      source: "awareness",
+    };
+  }
+
+  return {
+    getLane(kind: UiOverlayLaneKind): UiOverlayLaneSnapshot {
+      if (kind !== "presence") {
+        return unavailable(kind, "presence lane source only handles kind='presence'");
+      }
+      return readPresenceLane();
+    },
+    subscribeLane(
+      kind: UiOverlayLaneKind,
+      listener: UiListener<UiOverlayLaneSnapshot>,
+    ): UiUnsubscribe {
+      if (kind !== "presence") {
+        throw new Error(`presence lane source only handles kind='presence'; got "${kind}"`);
+      }
+      const onChange = (): void => {
+        listener(readPresenceLane());
+      };
+      options.awareness.on("change", onChange);
+      return () => {
+        options.awareness.off("change", onChange);
+      };
+    },
+  };
+}

package/src/ui/ui-controller-factory.ts

@@ -54,11 +54,14 @@ import type {
   ChromePosture,
   GeometryRect,
   OverlayAnchorQuery,
+  PageResidencySnapshot,
   UiOverlayLaneKind,
   UiOverlayLaneSnapshot,
   UiController,
   UiControllerFactory,
   UiListener,
+  UiObjectDragSession,
+  UiObjectDragStartInput,
   UiUnsubscribe,
   ViewportState,
 } from "../api/v3/ui/_types.ts";
@@ -113,6 +116,13 @@ export interface ShellUiControllerDeps {
    * dpr / container-resize. Returns unsubscribe.
    */
   readonly subscribeViewport?: (listener: UiListener<ViewportState>) => UiUnsubscribe;
+  /** PE2 page-residency policy read. */
+  readonly getPageResidency?: (pageIndex: number) => PageResidencySnapshot;
+  /** PE2 page-residency subscription channel. */
+  readonly subscribePageResidency?: (
+    pageIndex: number,
+    listener: UiListener<PageResidencySnapshot>,
+  ) => UiUnsubscribe;
   /**
    * Overlay invalidation stream — fires when geometry invalidation overlaps
    * an attached overlay query (U7). Typically delegated to the render
@@ -128,6 +138,10 @@ export interface ShellUiControllerDeps {
     kind: UiOverlayLaneKind,
     listener: UiListener<UiOverlayLaneSnapshot>,
   ) => UiUnsubscribe;
+  /** Mounted object-handle drag lifecycle. */
+  readonly beginObjectDrag?: (
+    input: UiObjectDragStartInput,
+  ) => UiObjectDragSession;
 }
 
 /**
@@ -154,9 +168,12 @@ export function makeShellUiControllerFactory(
       ...(deps.subscribeChrome ? { subscribeChrome: deps.subscribeChrome } : {}),
       ...(deps.getViewport ? { getViewport: deps.getViewport } : {}),
       ...(deps.subscribeViewport ? { subscribeViewport: deps.subscribeViewport } : {}),
+      ...(deps.getPageResidency ? { getPageResidency: deps.getPageResidency } : {}),
+      ...(deps.subscribePageResidency ? { subscribePageResidency: deps.subscribePageResidency } : {}),
       ...(deps.subscribeOverlays ? { subscribeOverlays: deps.subscribeOverlays } : {}),
       ...(deps.getOverlayLane ? { getOverlayLane: deps.getOverlayLane } : {}),
       ...(deps.subscribeOverlayLane ? { subscribeOverlayLane: deps.subscribeOverlayLane } : {}),
+      ...(deps.beginObjectDrag ? { beginObjectDrag: deps.beginObjectDrag } : {}),
     };
     return controller;
   };

package/src/ui-tailwind/chrome/build-context-menu-entries.ts

@@ -20,6 +20,8 @@ export interface BuildContextMenuInput {
   readonly targetKinds: readonly TargetKind[];
   readonly mode: EditorChromeMode;
   readonly host: EditorActionHostCallbacks;
+  /** Explicit operator/debug opt-in for opaque preservation diagnostics. */
+  readonly debugMode?: boolean;
   /**
    * Called when an action's row is selected.  Typically closes the menu
    * and returns focus to the editor selection.
@@ -49,6 +51,7 @@ export function buildContextMenuEntries(
   const dispatchCtx: EditorActionDispatchContext = {
     composition: { mode: input.mode },
     host: input.host,
+    debugMode: input.debugMode === true,
     dismiss: input.dismiss,
   };
 
@@ -61,7 +64,7 @@ export function buildContextMenuEntries(
       targetKind,
       input.mode,
       input.host,
-      { includeDisabled: true },
+      { includeDisabled: true, debugMode: input.debugMode === true },
     );
     for (const { action, disabled } of resolved) {
       if (seenActionIds.has(action.id)) continue;
@@ -77,6 +80,7 @@ export function buildContextMenuEntries(
         id: action.id,
         label: action.label,
         group: action.group,
+        ...(action.description ? { description: action.description } : {}),
         ...(action.shortcut ? { shortcut: [...action.shortcut] } : {}),
         ...(disabled ? { disabled: true } : {}),
         onSelect: () => action.run(dispatchCtx),

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

@@ -45,6 +45,7 @@ export type TargetKind =
   | "comment-anchor"      // caret at a comment-anchored range
   | "suggestion"          // caret at a tracked-change suggestion
   | "opaque-block"        // preserved-for-export placeholder
+  | "template-slot"       // SDT/content-control template slot
   | "scope-anchor";       // caret inside a workflow scope
 
 /**
@@ -55,6 +56,7 @@ export type TargetKind =
 export interface EditorActionDispatchContext {
   readonly composition: { readonly mode: EditorChromeMode };
   readonly host: EditorActionHostCallbacks;
+  readonly debugMode?: boolean;
   /** Close the menu / palette after dispatching, if applicable. */
   readonly dismiss: () => void;
 }
@@ -132,6 +134,9 @@ export interface EditorActionHostCallbacks {
 
   // Object operations (object target — read-only info by DESIGN-EDITOR.md §6.10)
   readonly onOpenObjectInfo?: () => void;
+  readonly onOpenPreservedContentInfo?: () => void;
+  readonly onOpenTemplateSlotInfo?: () => void;
+  readonly onOpenTrustDetails?: () => void;
 
   // Hyperlink operations (hyperlink target)
   readonly onEditHyperlink?: () => void;
@@ -142,6 +147,7 @@ export interface EditorActionHostCallbacks {
   readonly onJumpToScopeInRail?: () => void;
   readonly onOpenScopeCard?: () => void;
   readonly onMarkScopeResolved?: () => void;
+  readonly onAskAgentForSelection?: () => void;
 }
 
 export interface EditorAction {
@@ -157,6 +163,8 @@ export interface EditorAction {
    * Empty / undefined means "always in scope of its target".
    */
   readonly modes?: ReadonlySet<EditorChromeMode>;
+  /** Debug/operator-only rows never render in default product chrome. */
+  readonly debugOnly?: boolean;
   /**
    * Optional availability predicate.  Return `false` to hide the row;
    * `true` to show; `"disabled"` to show as a non-interactive disabled
@@ -186,6 +194,7 @@ function mk<K extends keyof EditorActionHostCallbacks>(opts: {
   group: ContextMenuGroupId;
   targetKinds: readonly TargetKind[];
   modes?: readonly EditorChromeMode[];
+  debugOnly?: boolean;
   callback: K;
   /** Optional extra predicate run after the callback-presence check. */
   when?: (ctx: EditorActionDispatchContext) => boolean | "disabled";
@@ -198,7 +207,9 @@ function mk<K extends keyof EditorActionHostCallbacks>(opts: {
     group: opts.group,
     targetKinds: new Set(opts.targetKinds),
     ...(opts.modes ? { modes: new Set(opts.modes) } : {}),
+    ...(opts.debugOnly ? { debugOnly: opts.debugOnly } : {}),
     when: (ctx) => {
+      if (opts.debugOnly && ctx.debugMode !== true) return false;
       if (typeof ctx.host[opts.callback] !== "function") return false;
       if (opts.when) return opts.when(ctx);
       return true;
@@ -232,6 +243,7 @@ function mkArg<A, K extends keyof EditorActionHostCallbacks>(opts: {
   group: ContextMenuGroupId;
   targetKinds: readonly TargetKind[];
   modes?: readonly EditorChromeMode[];
+  debugOnly?: boolean;
   callback: K;
   payload: A;
   when?: (ctx: EditorActionDispatchContext) => boolean | "disabled";
@@ -244,7 +256,9 @@ function mkArg<A, K extends keyof EditorActionHostCallbacks>(opts: {
     group: opts.group,
     targetKinds: new Set(opts.targetKinds),
     ...(opts.modes ? { modes: new Set(opts.modes) } : {}),
+    ...(opts.debugOnly ? { debugOnly: opts.debugOnly } : {}),
     when: (ctx) => {
+      if (opts.debugOnly && ctx.debugMode !== true) return false;
       if (typeof ctx.host[opts.callback] !== "function") return false;
       if (opts.when) return opts.when(ctx);
       return true;
@@ -325,6 +339,7 @@ export const EDITOR_ACTION_REGISTRY: readonly EditorAction[] = [
       "suggestion",
       "comment-anchor",
       "opaque-block",
+      "template-slot",
       "scope-anchor",
     ],
     callback: "onCut",
@@ -357,6 +372,7 @@ export const EDITOR_ACTION_REGISTRY: readonly EditorAction[] = [
       "hyperlink",
       "suggestion",
       "comment-anchor",
+      "template-slot",
       "scope-anchor",
     ],
     callback: "onPaste",
@@ -402,6 +418,22 @@ export const EDITOR_ACTION_REGISTRY: readonly EditorAction[] = [
     callback: "onSetParagraphStyle",
     payload: "Normal",
   }),
+  mkArg<string, "onSetParagraphStyle">({
+    id: "style-title",
+    label: "Title",
+    group: "formatting",
+    targetKinds: ["plain-text", "table-cell"],
+    callback: "onSetParagraphStyle",
+    payload: "Title",
+  }),
+  mkArg<string, "onSetParagraphStyle">({
+    id: "style-quote",
+    label: "Quote",
+    group: "formatting",
+    targetKinds: ["plain-text", "table-cell"],
+    callback: "onSetParagraphStyle",
+    payload: "Quote",
+  }),
   mkArg<string, "onSetParagraphStyle">({
     id: "style-heading-1",
     label: "Heading 1",
@@ -570,6 +602,33 @@ export const EDITOR_ACTION_REGISTRY: readonly EditorAction[] = [
     callback: "onInsertSectionBreak",
     payload: "nextPage",
   }),
+  mkArg<ProductSectionBreakType, "onInsertSectionBreak">({
+    id: "insert-section-break-continuous",
+    label: "Insert continuous section break",
+    description: "Start a new section on the same page.",
+    group: "misc",
+    targetKinds: ["plain-text", "table-cell"],
+    callback: "onInsertSectionBreak",
+    payload: "continuous",
+  }),
+  mkArg<ProductSectionBreakType, "onInsertSectionBreak">({
+    id: "insert-section-break-even-page",
+    label: "Insert even-page section break",
+    description: "Start the new section on the next even page.",
+    group: "misc",
+    targetKinds: ["plain-text", "table-cell"],
+    callback: "onInsertSectionBreak",
+    payload: "evenPage",
+  }),
+  mkArg<ProductSectionBreakType, "onInsertSectionBreak">({
+    id: "insert-section-break-odd-page",
+    label: "Insert odd-page section break",
+    description: "Start the new section on the next odd page.",
+    group: "misc",
+    targetKinds: ["plain-text", "table-cell"],
+    callback: "onInsertSectionBreak",
+    payload: "oddPage",
+  }),
   mkImportant({
     id: "insert-image",
     label: "Insert image…",
@@ -608,7 +667,7 @@ export const EDITOR_ACTION_REGISTRY: readonly EditorAction[] = [
   mkImportant({
     id: "replace",
     label: "Replace…",
-    description: "Host replace panel is not wired.",
+    description: "Find text and replace the active match.",
     shortcut: ["Ctrl", "H"],
     group: "misc",
     targetKinds: [],
@@ -617,7 +676,7 @@ export const EDITOR_ACTION_REGISTRY: readonly EditorAction[] = [
   mkImportant({
     id: "go-to",
     label: "Go to…",
-    description: "Host navigation panel is not wired.",
+    description: "Jump to pages, headings, comments, changes, or scopes.",
     shortcut: ["Ctrl", "G"],
     group: "misc",
     targetKinds: [],
@@ -626,7 +685,7 @@ export const EDITOR_ACTION_REGISTRY: readonly EditorAction[] = [
   mkImportant({
     id: "print",
     label: "Print…",
-    description: "Host print/export flow is not wired.",
+    description: "Open the print or export flow.",
     shortcut: ["Mod", "P"],
     group: "misc",
     targetKinds: [],
@@ -798,6 +857,32 @@ export const EDITOR_ACTION_REGISTRY: readonly EditorAction[] = [
     targetKinds: ["object"],
     callback: "onOpenObjectInfo",
   }),
+  mk({
+    id: "preserved-content-info",
+    label: "Preservation details",
+    description: "Show why this content is preserved and whether export remains safe.",
+    group: "misc",
+    targetKinds: ["object", "opaque-block"],
+    debugOnly: true,
+    callback: "onOpenPreservedContentInfo",
+  }),
+  mkImportant({
+    id: "template-slot-info",
+    label: "Template slot details",
+    description: "Show requirements, placeholder state, and scope targeting for this template slot.",
+    group: "misc",
+    targetKinds: ["template-slot"],
+    callback: "onOpenTemplateSlotInfo",
+  }),
+  mk({
+    id: "trust-details",
+    label: "Trust details",
+    description: "Open the health view for compatibility, preservation, and evidence status.",
+    group: "misc",
+    targetKinds: ["object", "opaque-block", "template-slot"],
+    debugOnly: true,
+    callback: "onOpenTrustDetails",
+  }),
 
   // -------- Hyperlink --------
   mk({
@@ -848,6 +933,15 @@ export const EDITOR_ACTION_REGISTRY: readonly EditorAction[] = [
     // Workflow-only — review posture inspects, doesn't mutate scope state.
     modes: ["workflow"],
   }),
+  mkImportant({
+    id: "ask-agent-selection",
+    label: "Ask agent about selection",
+    description: "Send this selection or scope to the host agent workflow.",
+    group: "misc",
+    targetKinds: ["plain-text", "table-cell", "scope-anchor", "template-slot"],
+    callback: "onAskAgentForSelection",
+    modes: ["review", "workflow"],
+  }),
 ];
 
 /**
@@ -861,6 +955,11 @@ export interface ResolvedEditorAction {
   readonly disabled: boolean;
 }
 
+export interface ResolveActionsForTargetOptions {
+  includeDisabled?: boolean;
+  debugMode?: boolean;
+}
+
 /**
  * Query the registry for every action whose target set includes `kind`
  * and whose mode filter (if any) matches the current composition mode.
@@ -881,17 +980,18 @@ export function resolveActionsForTarget(
   kind: TargetKind,
   mode: EditorChromeMode,
   host: EditorActionHostCallbacks,
-  options: { includeDisabled: true },
+  options: ResolveActionsForTargetOptions & { includeDisabled: true },
 ): readonly ResolvedEditorAction[];
 export function resolveActionsForTarget(
   kind: TargetKind,
   mode: EditorChromeMode,
   host: EditorActionHostCallbacks,
-  options?: { includeDisabled?: boolean },
+  options?: ResolveActionsForTargetOptions,
 ): readonly EditorAction[] | readonly ResolvedEditorAction[] {
   const ctx: EditorActionDispatchContext = {
     composition: { mode },
     host,
+    debugMode: options?.debugMode === true,
     dismiss: () => {},
   };
   const resolved: ResolvedEditorAction[] = [];

package/src/ui-tailwind/chrome/editor-actions-to-palette.ts

@@ -138,10 +138,14 @@ function paletteGroupForAction(action: EditorAction): ProductPaletteGroupId {
     case "jump-to-comment-in-rail":
     case "scope-jump-in-rail":
     case "scope-open-card":
+    case "template-slot-info":
       return "navigation";
     case "scope-mark-resolved":
+    case "ask-agent-selection":
       return "mode";
     case "object-info":
+    case "preserved-content-info":
+    case "trust-details":
     case "print":
       return "diagnostics";
     default:
@@ -152,6 +156,8 @@ function paletteGroupForAction(action: EditorAction): ProductPaletteGroupId {
 export interface BuildPaletteGroupsInput {
   readonly mode: EditorChromeMode;
   readonly host: EditorActionHostCallbacks;
+  /** Explicit operator/debug opt-in for opaque preservation diagnostics. */
+  readonly debugMode?: boolean;
   /** Called by every command's onInvoke — typically closes the palette. */
   readonly dismiss: () => void;
 }
@@ -162,6 +168,7 @@ export function buildPaletteGroupsFromRegistry(
   const ctx: EditorActionDispatchContext = {
     composition: { mode: input.mode },
     host: input.host,
+    debugMode: input.debugMode === true,
     dismiss: input.dismiss,
   };