@silo-code/sdk 0.51.0 → 0.52.0

package/dist/index.d.ts

@@ -6,9 +6,9 @@
  *
  * **What's here:** the types-first extension contract (see `types.ts`) plus a
  * small set of blessed runtime helpers (`Tooltip`, the modal design-system
- * kit, `useFocusGroup`, `useServiceState`, `DND_MIME`, `PathDeniedError`,
- * `NetworkError`). The SDK peer-depends on React 19; changes to the runtime
- * helpers can be breaking even when the types are unchanged.
+ * kit, `useFocusGroup`, `usePanelEntryFocus`, `useServiceState`, `DND_MIME`,
+ * `PathDeniedError`, `NetworkError`). The SDK peer-depends on React 19; changes
+ * to the runtime helpers can be breaking even when the types are unchanged.
  *
  * This is also the entry point the API-reference generator (TypeDoc) reads, so
  * the published reference is exactly this surface — no more, no less.
@@ -84,5 +84,8 @@ export { useServiceState } from "./use-service-state.js";
 export type { ReactiveService } from "./use-service-state.js";
 export { useFocusGroup, focusGroupNextIndex } from "./use-focus-group.js";
 export type { FocusGroup, FocusGroupOptions, FocusGroupContainerProps, FocusGroupItemProps, FocusGroupOrientation, FocusGroupNavQuery, } from "./use-focus-group.js";
+export { usePanelEntryFocus } from "./use-panel-entry-focus.js";
+export type { PanelEntryFocusTarget } from "./use-panel-entry-focus.js";
 export { setActiveInlineEditCancel, yieldEscapeToInlineEdit, } from "./inline-edit-controller.js";
+export { retryFocus } from "./use-panel-entry-focus.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -6,9 +6,9 @@
  *
  * **What's here:** the types-first extension contract (see `types.ts`) plus a
  * small set of blessed runtime helpers (`Tooltip`, the modal design-system
- * kit, `useFocusGroup`, `useServiceState`, `DND_MIME`, `PathDeniedError`,
- * `NetworkError`). The SDK peer-depends on React 19; changes to the runtime
- * helpers can be breaking even when the types are unchanged.
+ * kit, `useFocusGroup`, `usePanelEntryFocus`, `useServiceState`, `DND_MIME`,
+ * `PathDeniedError`, `NetworkError`). The SDK peer-depends on React 19; changes
+ * to the runtime helpers can be breaking even when the types are unchanged.
  *
  * This is also the entry point the API-reference generator (TypeDoc) reads, so
  * the published reference is exactly this surface — no more, no less.
@@ -61,8 +61,15 @@ export { useServiceState } from "./use-service-state.js";
 // `focusGroupNextIndex` helper is the pure roving-index core for widgets that
 // can't use the focus-driven hook (e.g. menus driven by a document listener).
 export { useFocusGroup, focusGroupNextIndex } from "./use-focus-group.js";
-// Host/InlineEdit coordination for InlineEdit's two-stage Escape (RFC 0016).
+// Entry focus for a dock panel (RFC 0049): both entry signals + the
+// `isActive`-guarded frame retry that wins dockview's focus shuffle, in one
+// call. The one sanctioned way for panel content to take focus on entry.
+export { usePanelEntryFocus } from "./use-panel-entry-focus.js";
+// Host/InlineEdit coordination for InlineEdit's two-stage Escape (RFC 0016),
+// and the raw focus retry behind `usePanelEntryFocus` for the non-React
+// callers that can't use the hook (RFC 0049).
 // @internal — host-only plumbing, not part of the documented reference;
 // extension authors never call these directly.
 export { setActiveInlineEditCancel, yieldEscapeToInlineEdit, } from "./inline-edit-controller.js";
+export { retryFocus } from "./use-panel-entry-focus.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA2JH,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAiChD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AA8BlE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAyBzC,sEAAsE;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAkCjD,8EAA8E;AAC9E,8EAA8E;AAC9E,6DAA6D;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,yEAAyE;AACzE,iFAAiF;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,4EAA4E;AAC5E,qDAAqD;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,4DAA4D;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,wEAAwE;AACxE,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,8EAA8E;AAC9E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAUvE,6EAA6E;AAC7E,wEAAwE;AACxE,+CAA+C;AAC/C,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA2JH,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAiChD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AA8BlE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAyBzC,sEAAsE;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAkCjD,8EAA8E;AAC9E,8EAA8E;AAC9E,6DAA6D;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,yEAAyE;AACzE,iFAAiF;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,4EAA4E;AAC5E,qDAAqD;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,4DAA4D;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,wEAAwE;AACxE,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,8EAA8E;AAC9E,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAUvE,oEAAoE;AACpE,4EAA4E;AAC5E,yEAAyE;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,6EAA6E;AAC7E,wEAAwE;AACxE,8CAA8C;AAC9C,wEAAwE;AACxE,+CAA+C;AAC/C,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/types.d.ts

@@ -85,6 +85,37 @@ export interface DockPanelApi {
     onDidActiveChange(listener: (event: {
         readonly isActive: boolean;
     }) => void): Disposable;
+    /**
+     * Subscribe to the user asking, by gesture, for keyboard focus in this
+     * panel — fired on every click of its tab, including one that leaves
+     * {@link DockPanelApi.isActive | isActive} unchanged because the tab was
+     * already active.
+     *
+     * That already-active case is why the event exists: it has no other signal.
+     * {@link DockPanelApi.onDidActiveChange | onDidActiveChange} only fires on a
+     * real transition, so clicking back into an already-active tab from
+     * elsewhere (a side panel, the status bar) is otherwise silent even though
+     * the user's intent — "put keyboard focus here" — is identical to a genuine
+     * activation. A panel that drives its own entry focus from
+     * `onDidActiveChange` should drive it from this event too, guarded on
+     * `isActive`, so both paths land focus the same way.
+     *
+     * The name is the intent, but today exactly one gesture carries it:
+     *
+     * - **Fires** on a primary click of this panel's tab, whether or not the
+     *   panel was already the active one.
+     * - **Does not fire** for activation from anywhere else —
+     *   {@link DockPanelApi.setActive | setActive}, a keybinding, a command or
+     *   command-palette jump, or the host restoring a saved layout. Those change
+     *   which panel is active, so they surface as `onDidActiveChange` instead;
+     *   none of them reaches this event.
+     * - **Does not fire** for a click inside the panel's own content (focus
+     *   there is yours to manage), the tab's close button, or a middle-click
+     *   close.
+     *
+     * Returns a {@link Disposable} that cancels the subscription.
+     */
+    onDidRequestFocus(listener: () => void): Disposable;
     /**
      * `true` while this panel is visible — its tab is the selected one in its
      * group. Distinct from {@link DockPanelApi.isActive | isActive}: with split

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/use-panel-entry-focus.d.ts

@@ -0,0 +1,122 @@
+import type { DockPanelApi } from "./types.js";
+/**
+ * Repeatedly call `focus()` on successive animation frames until `isFocused()`
+ * returns true, `stillWanted()` returns false, or `cap` frames have elapsed.
+ *
+ * `stillWanted` is **required**, and must express "this panel is still the one
+ * that should hold focus" — normally `() => api.isActive`, or the center
+ * dock's focus-intent token (`focusGen`). It is deliberately not optional: a
+ * retry loop without it keeps grabbing focus for its entire frame budget no
+ * matter what else happened meanwhile. That matters most on *mount*, because
+ * re-entering a workspace re-mounts its panels — so an unguarded mount-time
+ * grab in a background tab yanks focus away from the tab the user actually
+ * left active. And because DOM focus landing inside a dockview panel makes
+ * dockview mark that panel's group active
+ * (`contentContainer.onDidFocus → doSetGroupActive`), stealing focus silently
+ * changes the visible active tab too. That was symptom 1 in ADR 0034.
+ *
+ * Panel content should reach for {@link usePanelEntryFocus} instead, which
+ * supplies the guard and both entry subscriptions for you. This raw form is
+ * host/`core.*` plumbing for the non-React callers that can't.
+ *
+ * @internal
+ */
+export declare function retryFocus(focus: () => void, isFocused: () => boolean, stillWanted: () => boolean, cap?: number): void;
+/**
+ * The content {@link usePanelEntryFocus} drives — how to focus it, how to tell
+ * whether it already has focus, and optionally how to release it.
+ *
+ * All three are called through a latest-ref, so inline closures over props or
+ * state are always current; you never need to memoize them.
+ *
+ * @category Core Types
+ * @public
+ */
+export interface PanelEntryFocusTarget {
+    /**
+     * Imperatively focus the panel's content — e.g. `() => inputRef.current?.focus()`
+     * or `() => editor.focus()`. Safe to make a no-op while the content isn't
+     * ready to take focus; the retry simply expires.
+     */
+    focus: () => void;
+    /**
+     * Whether the content holds DOM keyboard focus **right now**, so the retry
+     * can stop as soon as it lands instead of burning the whole frame budget.
+     *
+     * Read the live `document.activeElement` — e.g.
+     * `() => document.activeElement === inputRef.current`. Don't trust a
+     * library's own tracker flag (Monaco's `hasTextFocus()`, say): those go
+     * stale-true when a blur is dropped during dockview's show/hide shuffle,
+     * which stops the retry believing focus landed when it didn't.
+     */
+    isFocused: () => boolean;
+    /**
+     * Release the content's focus when the panel's tab is deactivated. Only
+     * needed for content that tracks its own focus state internally — a Monaco
+     * editor or an xterm terminal is kept alive (hidden) while its tab is
+     * inactive, and if its tracker stays stuck believing it has focus it will
+     * steal keystrokes meant for the tab you switched to. A plain input needs
+     * nothing here.
+     */
+    blur?: () => void;
+}
+/**
+ * Land keyboard focus in a dock panel's content whenever the user enters the
+ * panel, winning dockview's focus shuffle — and, symmetrically, release it when
+ * the panel's tab is deactivated.
+ *
+ * A panel that puts the cursor somewhere on entry (a chat composer, a search
+ * box, an editor) needs three things that are easy to get individually wrong,
+ * and this hook is all three in one call:
+ *
+ * 1. **Both entry signals.** {@link DockPanelApi.onDidActiveChange} covers real
+ *    activations. {@link DockPanelApi.onDidRequestFocus} covers a click on a
+ *    tab that was *already* active — dockview treats that as a complete no-op
+ *    and fires no active-change event, even though it is the commonest way a
+ *    user asks for the cursor back (they were typing in a side panel, clicked
+ *    the status bar, then clicked your tab).
+ * 2. **A guard.** Focus is only ever taken while the panel is the active one.
+ *    Mount is not "the user just created this panel" — re-entering a workspace
+ *    re-mounts every panel in its dock — and DOM focus landing in a panel makes
+ *    dockview activate its group, so an unguarded grab silently changes the
+ *    visible tab (ADR 0034).
+ * 3. **A retry.** A single `focus()` loses dockview's shuffle, and rich content
+ *    only accepts focus once its internal textarea is laid out. The hook
+ *    retries across frames until focus lands, standing down if the panel stops
+ *    being active or focus moves into an open context menu.
+ *
+ * ```tsx
+ * function AcmeChatPanel({ api }: DockPanelProps) {
+ *   const input = useRef<HTMLTextAreaElement | null>(null);
+ *
+ *   usePanelEntryFocus(api, {
+ *     focus: () => input.current?.focus(),
+ *     isFocused: () => document.activeElement === input.current,
+ *   });
+ *
+ *   return <textarea ref={input} />;
+ * }
+ * ```
+ *
+ * The returned function runs the same guarded retry on demand, for content that
+ * becomes focusable at a moment that is neither a mount nor an activation — a
+ * session finishing its connect, an editor finishing its own mount. It is
+ * referentially stable, so it is safe in a dependency array:
+ *
+ * ```tsx
+ * const focusComposer = usePanelEntryFocus(api, { focus, isFocused });
+ *
+ * useEffect(() => {
+ *   if (ready) focusComposer();
+ * }, [ready, focusComposer]);
+ * ```
+ *
+ * @param api - The surrounding panel's api ({@link DockPanelProps.api}).
+ * @param target - How to focus, test, and release the panel's content.
+ * @returns A stable callback that runs the guarded focus retry on demand.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export declare function usePanelEntryFocus(api: DockPanelApi, target: PanelEntryFocusTarget): () => void;
+//# sourceMappingURL=use-panel-entry-focus.d.ts.map

package/dist/use-panel-entry-focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-panel-entry-focus.d.ts","sourceRoot":"","sources":["../src/use-panel-entry-focus.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAoC5C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,IAAI,EACjB,SAAS,EAAE,MAAM,OAAO,EACxB,WAAW,EAAE,MAAM,OAAO,EAC1B,GAAG,SAAc,GAChB,IAAI,CAoCN;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB;;;;;;;;;OASG;IACH,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,qBAAqB,GAC5B,MAAM,IAAI,CAkCZ"}

package/dist/use-panel-entry-focus.js

@@ -0,0 +1,186 @@
+import { useCallback, useEffect, useRef } from "react";
+// Entry focus for a dock panel — landing the caret in the panel's content when
+// the user enters it.
+//
+// A freshly-mounted or newly-activated dock panel does NOT reliably inherit DOM
+// focus: dockview runs its own focus shuffle when panels mount/activate, and
+// rich content (Monaco, xterm) only accepts focus once its internal textarea
+// has been laid out with non-zero dimensions. A single `focus()` call loses
+// these races, which is why a panel would otherwise need a second click before
+// you can type. We retry across animation frames until the target actually
+// reports focus, the panel is no longer the one we wanted to focus, or we hit a
+// frame cap (~330ms) so we never loop forever when focus legitimately can't be
+// grabbed (panel hidden, content disabled, etc.).
+const DEFAULT_CAP = 20;
+// Every menu implementation whose open state must suppress the retry: Silo's
+// own menus (`ctx.ui.showMenu`, which renders `[data-silo-menu]` with
+// `role="menu"`), a third-party menu that follows the same ARIA role, and
+// Monaco's context menu (`.context-view` / `.monaco-menu`).
+const MENU_SELECTOR = '[data-silo-menu], [role="menu"], .context-view, .monaco-menu';
+/**
+ * Whether focus currently sits inside an open floating menu. Monaco renders its
+ * context menu into a shadow root, where `document.activeElement` resolves only
+ * to the open `shadow-root-host` and the menu nodes hang off its `shadowRoot` —
+ * hence the shadow peek, not just a light-DOM `closest`.
+ */
+function focusInMenu(active) {
+    if (!active)
+        return false;
+    if (active.closest(MENU_SELECTOR))
+        return true;
+    return active.shadowRoot?.querySelector(MENU_SELECTOR) != null;
+}
+/**
+ * Repeatedly call `focus()` on successive animation frames until `isFocused()`
+ * returns true, `stillWanted()` returns false, or `cap` frames have elapsed.
+ *
+ * `stillWanted` is **required**, and must express "this panel is still the one
+ * that should hold focus" — normally `() => api.isActive`, or the center
+ * dock's focus-intent token (`focusGen`). It is deliberately not optional: a
+ * retry loop without it keeps grabbing focus for its entire frame budget no
+ * matter what else happened meanwhile. That matters most on *mount*, because
+ * re-entering a workspace re-mounts its panels — so an unguarded mount-time
+ * grab in a background tab yanks focus away from the tab the user actually
+ * left active. And because DOM focus landing inside a dockview panel makes
+ * dockview mark that panel's group active
+ * (`contentContainer.onDidFocus → doSetGroupActive`), stealing focus silently
+ * changes the visible active tab too. That was symptom 1 in ADR 0034.
+ *
+ * Panel content should reach for {@link usePanelEntryFocus} instead, which
+ * supplies the guard and both entry subscriptions for you. This raw form is
+ * host/`core.*` plumbing for the non-React callers that can't.
+ *
+ * @internal
+ */
+export function retryFocus(focus, isFocused, stillWanted, cap = DEFAULT_CAP) {
+    let attempts = 0;
+    let landed = false;
+    const tick = () => {
+        // Bail before touching focus if we're no longer wanted — a newer focus
+        // intent superseded us (e.g. the user kept pressing the region-cycle chord).
+        // Checked here, not just after the grab below, so a stale retry can't yank
+        // focus back from the area the user actually moved to.
+        if (!stillWanted())
+            return;
+        attempts += 1;
+        if (isFocused()) {
+            landed = true;
+        }
+        else {
+            // Before focus first lands, grab aggressively each frame — Monaco/xterm
+            // only accept focus once their textarea is laid out, so early calls lose.
+            // After it has landed, only re-grab if focus fell to NOTHING (<body>/null):
+            // dockview's show/hide shuffle can bounce focus off the just-focused
+            // content a frame or two later (the "keystrokes dropped after a switch"
+            // symptom). We watch the full frame budget to catch that — but never yank
+            // focus away from another real element the user may have moved to.
+            const active = document.activeElement;
+            // Focus legitimately moved into an open context menu — don't yank it
+            // back, or the menu's focus-out dismiss fires and it flashes shut.
+            // Right-clicking an *inactive* panel activates it, which starts this
+            // retry; without the guard the per-frame `focus()` steals focus from the
+            // just-opened menu (the focused case never starts the retry, which is why
+            // the bug only shows when the panel was unfocused). End the loop: the
+            // menu's owner restores content focus itself once the menu closes.
+            if (focusInMenu(active))
+                return;
+            const lostToNothing = active === null || active === document.body;
+            if (!landed || lostToNothing)
+                focus();
+        }
+        if (attempts >= cap || !stillWanted())
+            return;
+        requestAnimationFrame(tick);
+    };
+    requestAnimationFrame(tick);
+}
+/**
+ * Land keyboard focus in a dock panel's content whenever the user enters the
+ * panel, winning dockview's focus shuffle — and, symmetrically, release it when
+ * the panel's tab is deactivated.
+ *
+ * A panel that puts the cursor somewhere on entry (a chat composer, a search
+ * box, an editor) needs three things that are easy to get individually wrong,
+ * and this hook is all three in one call:
+ *
+ * 1. **Both entry signals.** {@link DockPanelApi.onDidActiveChange} covers real
+ *    activations. {@link DockPanelApi.onDidRequestFocus} covers a click on a
+ *    tab that was *already* active — dockview treats that as a complete no-op
+ *    and fires no active-change event, even though it is the commonest way a
+ *    user asks for the cursor back (they were typing in a side panel, clicked
+ *    the status bar, then clicked your tab).
+ * 2. **A guard.** Focus is only ever taken while the panel is the active one.
+ *    Mount is not "the user just created this panel" — re-entering a workspace
+ *    re-mounts every panel in its dock — and DOM focus landing in a panel makes
+ *    dockview activate its group, so an unguarded grab silently changes the
+ *    visible tab (ADR 0034).
+ * 3. **A retry.** A single `focus()` loses dockview's shuffle, and rich content
+ *    only accepts focus once its internal textarea is laid out. The hook
+ *    retries across frames until focus lands, standing down if the panel stops
+ *    being active or focus moves into an open context menu.
+ *
+ * ```tsx
+ * function AcmeChatPanel({ api }: DockPanelProps) {
+ *   const input = useRef<HTMLTextAreaElement | null>(null);
+ *
+ *   usePanelEntryFocus(api, {
+ *     focus: () => input.current?.focus(),
+ *     isFocused: () => document.activeElement === input.current,
+ *   });
+ *
+ *   return <textarea ref={input} />;
+ * }
+ * ```
+ *
+ * The returned function runs the same guarded retry on demand, for content that
+ * becomes focusable at a moment that is neither a mount nor an activation — a
+ * session finishing its connect, an editor finishing its own mount. It is
+ * referentially stable, so it is safe in a dependency array:
+ *
+ * ```tsx
+ * const focusComposer = usePanelEntryFocus(api, { focus, isFocused });
+ *
+ * useEffect(() => {
+ *   if (ready) focusComposer();
+ * }, [ready, focusComposer]);
+ * ```
+ *
+ * @param api - The surrounding panel's api ({@link DockPanelProps.api}).
+ * @param target - How to focus, test, and release the panel's content.
+ * @returns A stable callback that runs the guarded focus retry on demand.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export function usePanelEntryFocus(api, target) {
+    // Read the callbacks through a ref rather than closing over them: the
+    // subscription effect depends on `api` alone (re-subscribing every render
+    // would be worse), so a captured `target` would freeze at its first render
+    // and an author's inline `() => { if (enabled) … }` would go stale.
+    const latest = useRef(target);
+    useEffect(() => {
+        latest.current = target;
+    });
+    const focusNow = useCallback(() => {
+        if (!api.isActive)
+            return;
+        retryFocus(() => latest.current.focus(), () => latest.current.isFocused(), () => api.isActive);
+    }, [api]);
+    useEffect(() => {
+        const subActive = api.onDidActiveChange(() => {
+            if (api.isActive)
+                focusNow();
+            else
+                latest.current.blur?.();
+        });
+        // `focusNow` guards on `isActive` itself: a Focus Request says only that
+        // the user asked, never that this panel became active.
+        const subRequest = api.onDidRequestFocus(focusNow);
+        return () => {
+            subActive.dispose();
+            subRequest.dispose();
+        };
+    }, [api, focusNow]);
+    return focusNow;
+}
+//# sourceMappingURL=use-panel-entry-focus.js.map

package/dist/use-panel-entry-focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-panel-entry-focus.js","sourceRoot":"","sources":["../src/use-panel-entry-focus.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@silo-code/sdk",
-  "version": "0.51.0",
+  "version": "0.52.0",
   "description": "The public, types-first SDK for building Silo extensions — the only surface third-party extensions import.",
   "license": "MIT",
   "author": "Dave Weaver",
@@ -36,10 +36,10 @@
     "react": "^19.1.0",
     "react-dom": "^19.1.0"
   },
-  "dependencies": {},
   "devDependencies": {
     "@types/react": "^19.1.8",
     "@types/react-dom": "^19.1.0",
+    "jsdom": "^29.1.1",
     "typescript": "~5.8.3",
     "vitest": "^4.1.7"
   },

package/src/index.ts

@@ -6,9 +6,9 @@
  *
  * **What's here:** the types-first extension contract (see `types.ts`) plus a
  * small set of blessed runtime helpers (`Tooltip`, the modal design-system
- * kit, `useFocusGroup`, `useServiceState`, `DND_MIME`, `PathDeniedError`,
- * `NetworkError`). The SDK peer-depends on React 19; changes to the runtime
- * helpers can be breaking even when the types are unchanged.
+ * kit, `useFocusGroup`, `usePanelEntryFocus`, `useServiceState`, `DND_MIME`,
+ * `PathDeniedError`, `NetworkError`). The SDK peer-depends on React 19; changes
+ * to the runtime helpers can be breaking even when the types are unchanged.
  *
  * This is also the entry point the API-reference generator (TypeDoc) reads, so
  * the published reference is exactly this surface — no more, no less.
@@ -356,10 +356,19 @@ export type {
   FocusGroupNavQuery,
 } from "./use-focus-group";
 
-// Host/InlineEdit coordination for InlineEdit's two-stage Escape (RFC 0016).
+// Entry focus for a dock panel (RFC 0049): both entry signals + the
+// `isActive`-guarded frame retry that wins dockview's focus shuffle, in one
+// call. The one sanctioned way for panel content to take focus on entry.
+export { usePanelEntryFocus } from "./use-panel-entry-focus";
+export type { PanelEntryFocusTarget } from "./use-panel-entry-focus";
+
+// Host/InlineEdit coordination for InlineEdit's two-stage Escape (RFC 0016),
+// and the raw focus retry behind `usePanelEntryFocus` for the non-React
+// callers that can't use the hook (RFC 0049).
 // @internal — host-only plumbing, not part of the documented reference;
 // extension authors never call these directly.
 export {
   setActiveInlineEditCancel,
   yieldEscapeToInlineEdit,
 } from "./inline-edit-controller";
+export { retryFocus } from "./use-panel-entry-focus";

package/src/types.ts

@@ -90,6 +90,37 @@ export interface DockPanelApi {
   onDidActiveChange(
     listener: (event: { readonly isActive: boolean }) => void,
   ): Disposable;
+  /**
+   * Subscribe to the user asking, by gesture, for keyboard focus in this
+   * panel — fired on every click of its tab, including one that leaves
+   * {@link DockPanelApi.isActive | isActive} unchanged because the tab was
+   * already active.
+   *
+   * That already-active case is why the event exists: it has no other signal.
+   * {@link DockPanelApi.onDidActiveChange | onDidActiveChange} only fires on a
+   * real transition, so clicking back into an already-active tab from
+   * elsewhere (a side panel, the status bar) is otherwise silent even though
+   * the user's intent — "put keyboard focus here" — is identical to a genuine
+   * activation. A panel that drives its own entry focus from
+   * `onDidActiveChange` should drive it from this event too, guarded on
+   * `isActive`, so both paths land focus the same way.
+   *
+   * The name is the intent, but today exactly one gesture carries it:
+   *
+   * - **Fires** on a primary click of this panel's tab, whether or not the
+   *   panel was already the active one.
+   * - **Does not fire** for activation from anywhere else —
+   *   {@link DockPanelApi.setActive | setActive}, a keybinding, a command or
+   *   command-palette jump, or the host restoring a saved layout. Those change
+   *   which panel is active, so they surface as `onDidActiveChange` instead;
+   *   none of them reaches this event.
+   * - **Does not fire** for a click inside the panel's own content (focus
+   *   there is yours to manage), the tab's close button, or a middle-click
+   *   close.
+   *
+   * Returns a {@link Disposable} that cancels the subscription.
+   */
+  onDidRequestFocus(listener: () => void): Disposable;
   /**
    * `true` while this panel is visible — its tab is the selected one in its
    * group. Distinct from {@link DockPanelApi.isActive | isActive}: with split

package/src/use-panel-entry-focus.test.ts

@@ -0,0 +1,244 @@
+/**
+ * @vitest-environment jsdom
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { retryFocus } from "./use-panel-entry-focus";
+
+// The retry is the whole substance of `usePanelEntryFocus` — the hook around it
+// is two subscriptions and a guard. Per the repo testing guide we drive the
+// logic directly rather than rendering React: `requestAnimationFrame` is
+// replaced with a hand-pumped queue so every frame is deterministic. This file
+// opts into jsdom (the SDK's suite is node by default) because the retry reads
+// the live `document.activeElement` to decide whether focus fell to nothing or
+// moved somewhere it must not be yanked back from.
+describe("retryFocus", () => {
+  let queue: FrameRequestCallback[] = [];
+  let origRaf: typeof globalThis.requestAnimationFrame;
+
+  beforeEach(() => {
+    queue = [];
+    origRaf = globalThis.requestAnimationFrame;
+    globalThis.requestAnimationFrame = ((cb: FrameRequestCallback) =>
+      queue.push(cb)) as typeof globalThis.requestAnimationFrame;
+    document.body.innerHTML = "";
+  });
+  afterEach(() => {
+    globalThis.requestAnimationFrame = origRaf;
+  });
+
+  /** Run exactly one scheduled frame (ticks queued during it run on the next flush). */
+  function flushFrame() {
+    const due = queue;
+    queue = [];
+    for (const cb of due) cb(0);
+  }
+
+  it("stops re-grabbing focus once it is no longer wanted (the region-cycle race)", () => {
+    const focus = vi.fn();
+    let wanted = true;
+    // Never reports focused, so without the guard it would grab every frame.
+    retryFocus(
+      focus,
+      () => false,
+      () => wanted,
+    );
+
+    flushFrame(); // wanted → grabs once
+    expect(focus).toHaveBeenCalledTimes(1);
+
+    wanted = false; // a newer focus intent superseded us
+    flushFrame(); // must bail BEFORE grabbing
+    flushFrame();
+    expect(focus).toHaveBeenCalledTimes(1);
+  });
+
+  it("re-grabs each frame until focus lands, then stops grabbing", () => {
+    const focus = vi.fn();
+    let focused = false;
+    retryFocus(
+      focus,
+      () => focused,
+      () => true,
+    );
+
+    flushFrame(); // not focused → grab
+    flushFrame(); // still not focused → grab
+    expect(focus).toHaveBeenCalledTimes(2);
+
+    focused = true;
+    flushFrame(); // landed → no further grab
+    expect(focus).toHaveBeenCalledTimes(2);
+  });
+
+  // Regression guard for symptom 1 (ADR 0034): a panel that merely re-mounts
+  // in the background — which happens to every panel of a workspace whose dock
+  // becomes visible again — must not grab focus from the tab the user actually
+  // left active. `stillWanted` is required precisely so a mount-time caller
+  // can't silently omit it and grab unconditionally.
+  it("never grabs on mount when the panel is not the active tab", () => {
+    const focus = vi.fn();
+    let isActive = false; // this panel re-mounted in the background
+    retryFocus(
+      focus,
+      () => false, // never reports focused → would grab every frame if unguarded
+      () => isActive,
+    );
+
+    flushFrame();
+    flushFrame();
+    expect(focus).not.toHaveBeenCalled();
+
+    // …and it stays bailed even if the panel becomes active later: the loop
+    // ended, so activation focus is the active tab's own concern, not a
+    // stale mount-time retry's.
+    isActive = true;
+    flushFrame();
+    expect(focus).not.toHaveBeenCalled();
+  });
+
+  it("never grabs when superseded before the first frame", () => {
+    const focus = vi.fn();
+    retryFocus(
+      focus,
+      () => false,
+      () => false,
+    );
+    flushFrame();
+    expect(focus).not.toHaveBeenCalled();
+  });
+
+  it("gives up after the frame cap so it never loops forever", () => {
+    const focus = vi.fn();
+    retryFocus(
+      focus,
+      () => false, // focus can never land (panel hidden, content disabled, …)
+      () => true,
+      3,
+    );
+
+    for (let i = 0; i < 10; i++) flushFrame();
+    expect(focus).toHaveBeenCalledTimes(3);
+    expect(queue).toHaveLength(0);
+  });
+
+  it("re-grabs after landing only when focus fell to nothing", () => {
+    const focus = vi.fn();
+    let focused = true; // landed on the first frame
+    retryFocus(
+      focus,
+      () => focused,
+      () => true,
+    );
+
+    flushFrame(); // landed → no grab
+    expect(focus).not.toHaveBeenCalled();
+
+    // dockview's show/hide shuffle bounced focus off the content onto nothing.
+    focused = false;
+    flushFrame();
+    expect(focus).toHaveBeenCalledTimes(1);
+  });
+
+  it("does not yank focus back from another real element after it landed", () => {
+    const other = document.createElement("input");
+    document.body.append(other);
+    other.focus();
+
+    const focus = vi.fn();
+    let focused = true;
+    retryFocus(
+      focus,
+      () => focused,
+      () => true,
+    );
+
+    flushFrame(); // landed
+    focused = false; // the user moved on to `other` — not "lost to nothing"
+    flushFrame();
+    flushFrame();
+    expect(focus).not.toHaveBeenCalled();
+  });
+
+  describe("open menus", () => {
+    /** Focus a menu-like element and run one frame of a never-landing retry. */
+    function grabsWhileFocusedIn(menu: HTMLElement): boolean {
+      document.body.append(menu);
+      menu.tabIndex = -1;
+      menu.focus();
+      const focus = vi.fn();
+      retryFocus(
+        focus,
+        () => false,
+        () => true,
+      );
+      flushFrame();
+      return focus.mock.calls.length > 0;
+    }
+
+    // Right-clicking an *inactive* panel activates it, which starts the retry;
+    // without this guard the per-frame `focus()` steals focus from the menu
+    // that same click just opened and the menu flashes shut.
+    it("stands down for a Silo menu (ctx.ui.showMenu)", () => {
+      const menu = document.createElement("div");
+      menu.setAttribute("data-silo-menu", "tree-1");
+      menu.setAttribute("role", "menu");
+      expect(grabsWhileFocusedIn(menu)).toBe(false);
+    });
+
+    it("stands down for a Monaco context menu", () => {
+      const menu = document.createElement("div");
+      menu.className = "context-view";
+      expect(grabsWhileFocusedIn(menu)).toBe(false);
+    });
+
+    // Monaco renders its context menu into a shadow root, so from the light DOM
+    // `document.activeElement` is only the host element — the menu nodes live
+    // one level down, which is why a plain `closest` isn't enough.
+    it("stands down for a menu inside a shadow root", () => {
+      const host = document.createElement("div");
+      document.body.append(host);
+      const shadow = host.attachShadow({ mode: "open" });
+      const menu = document.createElement("div");
+      menu.className = "monaco-menu";
+      shadow.append(menu);
+      host.tabIndex = -1;
+      host.focus();
+
+      const focus = vi.fn();
+      retryFocus(
+        focus,
+        () => false,
+        () => true,
+      );
+      flushFrame();
+      expect(focus).not.toHaveBeenCalled();
+    });
+
+    it("ends the loop rather than resuming once the menu closes", () => {
+      const menu = document.createElement("div");
+      menu.setAttribute("data-silo-menu", "tree-1");
+      menu.tabIndex = -1;
+      document.body.append(menu);
+      menu.focus();
+
+      const focus = vi.fn();
+      retryFocus(
+        focus,
+        () => false,
+        () => true,
+      );
+      flushFrame(); // bails
+      expect(queue).toHaveLength(0);
+
+      // Nothing rescheduled: the menu's owner restores content focus itself.
+      menu.remove();
+      flushFrame();
+      expect(focus).not.toHaveBeenCalled();
+    });
+
+    it("still grabs when focus is merely on the body, not a menu", () => {
+      const plain = document.createElement("div");
+      expect(grabsWhileFocusedIn(plain)).toBe(true);
+    });
+  });
+});

package/src/use-panel-entry-focus.ts

@@ -0,0 +1,237 @@
+import { useCallback, useEffect, useRef } from "react";
+import type { DockPanelApi } from "./types";
+
+// Entry focus for a dock panel — landing the caret in the panel's content when
+// the user enters it.
+//
+// A freshly-mounted or newly-activated dock panel does NOT reliably inherit DOM
+// focus: dockview runs its own focus shuffle when panels mount/activate, and
+// rich content (Monaco, xterm) only accepts focus once its internal textarea
+// has been laid out with non-zero dimensions. A single `focus()` call loses
+// these races, which is why a panel would otherwise need a second click before
+// you can type. We retry across animation frames until the target actually
+// reports focus, the panel is no longer the one we wanted to focus, or we hit a
+// frame cap (~330ms) so we never loop forever when focus legitimately can't be
+// grabbed (panel hidden, content disabled, etc.).
+
+const DEFAULT_CAP = 20;
+
+// Every menu implementation whose open state must suppress the retry: Silo's
+// own menus (`ctx.ui.showMenu`, which renders `[data-silo-menu]` with
+// `role="menu"`), a third-party menu that follows the same ARIA role, and
+// Monaco's context menu (`.context-view` / `.monaco-menu`).
+const MENU_SELECTOR =
+  '[data-silo-menu], [role="menu"], .context-view, .monaco-menu';
+
+/**
+ * Whether focus currently sits inside an open floating menu. Monaco renders its
+ * context menu into a shadow root, where `document.activeElement` resolves only
+ * to the open `shadow-root-host` and the menu nodes hang off its `shadowRoot` —
+ * hence the shadow peek, not just a light-DOM `closest`.
+ */
+function focusInMenu(active: Element | null): boolean {
+  if (!active) return false;
+  if (active.closest(MENU_SELECTOR)) return true;
+  return active.shadowRoot?.querySelector(MENU_SELECTOR) != null;
+}
+
+/**
+ * Repeatedly call `focus()` on successive animation frames until `isFocused()`
+ * returns true, `stillWanted()` returns false, or `cap` frames have elapsed.
+ *
+ * `stillWanted` is **required**, and must express "this panel is still the one
+ * that should hold focus" — normally `() => api.isActive`, or the center
+ * dock's focus-intent token (`focusGen`). It is deliberately not optional: a
+ * retry loop without it keeps grabbing focus for its entire frame budget no
+ * matter what else happened meanwhile. That matters most on *mount*, because
+ * re-entering a workspace re-mounts its panels — so an unguarded mount-time
+ * grab in a background tab yanks focus away from the tab the user actually
+ * left active. And because DOM focus landing inside a dockview panel makes
+ * dockview mark that panel's group active
+ * (`contentContainer.onDidFocus → doSetGroupActive`), stealing focus silently
+ * changes the visible active tab too. That was symptom 1 in ADR 0034.
+ *
+ * Panel content should reach for {@link usePanelEntryFocus} instead, which
+ * supplies the guard and both entry subscriptions for you. This raw form is
+ * host/`core.*` plumbing for the non-React callers that can't.
+ *
+ * @internal
+ */
+export function retryFocus(
+  focus: () => void,
+  isFocused: () => boolean,
+  stillWanted: () => boolean,
+  cap = DEFAULT_CAP,
+): void {
+  let attempts = 0;
+  let landed = false;
+  const tick = () => {
+    // Bail before touching focus if we're no longer wanted — a newer focus
+    // intent superseded us (e.g. the user kept pressing the region-cycle chord).
+    // Checked here, not just after the grab below, so a stale retry can't yank
+    // focus back from the area the user actually moved to.
+    if (!stillWanted()) return;
+    attempts += 1;
+    if (isFocused()) {
+      landed = true;
+    } else {
+      // Before focus first lands, grab aggressively each frame — Monaco/xterm
+      // only accept focus once their textarea is laid out, so early calls lose.
+      // After it has landed, only re-grab if focus fell to NOTHING (<body>/null):
+      // dockview's show/hide shuffle can bounce focus off the just-focused
+      // content a frame or two later (the "keystrokes dropped after a switch"
+      // symptom). We watch the full frame budget to catch that — but never yank
+      // focus away from another real element the user may have moved to.
+      const active = document.activeElement;
+      // Focus legitimately moved into an open context menu — don't yank it
+      // back, or the menu's focus-out dismiss fires and it flashes shut.
+      // Right-clicking an *inactive* panel activates it, which starts this
+      // retry; without the guard the per-frame `focus()` steals focus from the
+      // just-opened menu (the focused case never starts the retry, which is why
+      // the bug only shows when the panel was unfocused). End the loop: the
+      // menu's owner restores content focus itself once the menu closes.
+      if (focusInMenu(active)) return;
+      const lostToNothing = active === null || active === document.body;
+      if (!landed || lostToNothing) focus();
+    }
+    if (attempts >= cap || !stillWanted()) return;
+    requestAnimationFrame(tick);
+  };
+  requestAnimationFrame(tick);
+}
+
+/**
+ * The content {@link usePanelEntryFocus} drives — how to focus it, how to tell
+ * whether it already has focus, and optionally how to release it.
+ *
+ * All three are called through a latest-ref, so inline closures over props or
+ * state are always current; you never need to memoize them.
+ *
+ * @category Core Types
+ * @public
+ */
+export interface PanelEntryFocusTarget {
+  /**
+   * Imperatively focus the panel's content — e.g. `() => inputRef.current?.focus()`
+   * or `() => editor.focus()`. Safe to make a no-op while the content isn't
+   * ready to take focus; the retry simply expires.
+   */
+  focus: () => void;
+  /**
+   * Whether the content holds DOM keyboard focus **right now**, so the retry
+   * can stop as soon as it lands instead of burning the whole frame budget.
+   *
+   * Read the live `document.activeElement` — e.g.
+   * `() => document.activeElement === inputRef.current`. Don't trust a
+   * library's own tracker flag (Monaco's `hasTextFocus()`, say): those go
+   * stale-true when a blur is dropped during dockview's show/hide shuffle,
+   * which stops the retry believing focus landed when it didn't.
+   */
+  isFocused: () => boolean;
+  /**
+   * Release the content's focus when the panel's tab is deactivated. Only
+   * needed for content that tracks its own focus state internally — a Monaco
+   * editor or an xterm terminal is kept alive (hidden) while its tab is
+   * inactive, and if its tracker stays stuck believing it has focus it will
+   * steal keystrokes meant for the tab you switched to. A plain input needs
+   * nothing here.
+   */
+  blur?: () => void;
+}
+
+/**
+ * Land keyboard focus in a dock panel's content whenever the user enters the
+ * panel, winning dockview's focus shuffle — and, symmetrically, release it when
+ * the panel's tab is deactivated.
+ *
+ * A panel that puts the cursor somewhere on entry (a chat composer, a search
+ * box, an editor) needs three things that are easy to get individually wrong,
+ * and this hook is all three in one call:
+ *
+ * 1. **Both entry signals.** {@link DockPanelApi.onDidActiveChange} covers real
+ *    activations. {@link DockPanelApi.onDidRequestFocus} covers a click on a
+ *    tab that was *already* active — dockview treats that as a complete no-op
+ *    and fires no active-change event, even though it is the commonest way a
+ *    user asks for the cursor back (they were typing in a side panel, clicked
+ *    the status bar, then clicked your tab).
+ * 2. **A guard.** Focus is only ever taken while the panel is the active one.
+ *    Mount is not "the user just created this panel" — re-entering a workspace
+ *    re-mounts every panel in its dock — and DOM focus landing in a panel makes
+ *    dockview activate its group, so an unguarded grab silently changes the
+ *    visible tab (ADR 0034).
+ * 3. **A retry.** A single `focus()` loses dockview's shuffle, and rich content
+ *    only accepts focus once its internal textarea is laid out. The hook
+ *    retries across frames until focus lands, standing down if the panel stops
+ *    being active or focus moves into an open context menu.
+ *
+ * ```tsx
+ * function AcmeChatPanel({ api }: DockPanelProps) {
+ *   const input = useRef<HTMLTextAreaElement | null>(null);
+ *
+ *   usePanelEntryFocus(api, {
+ *     focus: () => input.current?.focus(),
+ *     isFocused: () => document.activeElement === input.current,
+ *   });
+ *
+ *   return <textarea ref={input} />;
+ * }
+ * ```
+ *
+ * The returned function runs the same guarded retry on demand, for content that
+ * becomes focusable at a moment that is neither a mount nor an activation — a
+ * session finishing its connect, an editor finishing its own mount. It is
+ * referentially stable, so it is safe in a dependency array:
+ *
+ * ```tsx
+ * const focusComposer = usePanelEntryFocus(api, { focus, isFocused });
+ *
+ * useEffect(() => {
+ *   if (ready) focusComposer();
+ * }, [ready, focusComposer]);
+ * ```
+ *
+ * @param api - The surrounding panel's api ({@link DockPanelProps.api}).
+ * @param target - How to focus, test, and release the panel's content.
+ * @returns A stable callback that runs the guarded focus retry on demand.
+ *
+ * @category Consumer Services
+ * @public
+ */
+export function usePanelEntryFocus(
+  api: DockPanelApi,
+  target: PanelEntryFocusTarget,
+): () => void {
+  // Read the callbacks through a ref rather than closing over them: the
+  // subscription effect depends on `api` alone (re-subscribing every render
+  // would be worse), so a captured `target` would freeze at its first render
+  // and an author's inline `() => { if (enabled) … }` would go stale.
+  const latest = useRef(target);
+  useEffect(() => {
+    latest.current = target;
+  });
+
+  const focusNow = useCallback(() => {
+    if (!api.isActive) return;
+    retryFocus(
+      () => latest.current.focus(),
+      () => latest.current.isFocused(),
+      () => api.isActive,
+    );
+  }, [api]);
+
+  useEffect(() => {
+    const subActive = api.onDidActiveChange(() => {
+      if (api.isActive) focusNow();
+      else latest.current.blur?.();
+    });
+    // `focusNow` guards on `isActive` itself: a Focus Request says only that
+    // the user asked, never that this panel became active.
+    const subRequest = api.onDidRequestFocus(focusNow);
+    return () => {
+      subActive.dispose();
+      subRequest.dispose();
+    };
+  }, [api, focusNow]);
+
+  return focusNow;
+}