gloomberb 0.9.1 → 0.9.3

package/src/renderers/electrobun/shared/protocol.ts

@@ -14,6 +14,7 @@ export interface ElectrobunBackendInit {
   desktopThemePreview: DesktopThemePreviewState;
   pluginState: Record<string, Record<string, unknown>>;
   capabilityManifests: CapabilityManifest[];
+  desktopPlatform: string;
   windowKind: "main" | "detached";
   paneId?: string;
 }

package/src/renderers/electrobun/view/app-services.ts

@@ -7,7 +7,7 @@ import type { AppServices } from "../../../core/app-services";
 import type { AppConfig } from "../../../types/config";
 import { newsProvider } from "../../../capabilities";
 import { debugLog } from "../../../utils/debug-log";
-import { measurePerf } from "../../../utils/perf-marks";
+import { measurePerf, measurePerfAsync } from "../../../utils/perf-marks";
 import { getRendererBuiltinPlugins } from "../../../plugins/catalog-ui";
 import { createRemoteAssetDataClient } from "./remote/asset-data-client";
 import { RemotePersistence } from "./remote/persistence";
@@ -47,10 +47,11 @@ export function createAppServices({ config }: { config: AppConfig }): AppService
   }));
 
   const plugins = getRendererBuiltinPlugins();
+  const pluginReadyPromises: Promise<void>[] = [];
   for (const plugin of plugins) {
-    measurePerf("startup.services.register-plugin", () => {
-      void pluginRegistry.register(plugin);
-    }, { pluginId: plugin.id });
+    pluginReadyPromises.push(measurePerfAsync("startup.services.register-plugin", () => (
+      pluginRegistry.register(plugin)
+    ), { pluginId: plugin.id }));
   }
   measurePerf("startup.services.news-start", () => {
     newsService.start();
@@ -65,6 +66,7 @@ export function createAppServices({ config }: { config: AppConfig }): AppService
     marketData,
     pluginRegistry,
     newsService,
+    ready: Promise.all(pluginReadyPromises).then(() => {}),
     destroy() {
       setSharedMarketDataCoordinator(null);
       setSharedNewsService(null);

package/src/renderers/electrobun/view/host/ascii-text.ts

@@ -0,0 +1,50 @@
+import { renderAsciiText, type AsciiFontName } from "../../../../ui/ascii-font";
+
+const WEB_GLOOMBERB_WORDMARK = [
+  "  ____ _                       _               _     ",
+  " / ___| | ___   ___  _ __ ___ | |__   ___ _ __| |__  ",
+  "| |  _| |/ _ \\ / _ \\| '_ ` _ \\| '_ \\ / _ \\ '__| '_ \\ ",
+  "| |_| | | (_) | (_) | | | | | | |_) |  __/ |  | |_) |",
+  " \\____|_|\\___/ \\___/|_| |_| |_|_.__/ \\___|_|  |_.__/ ",
+];
+
+type WebWordmarkVariant = "legacy" | "compat" | null;
+
+function currentDesktopPlatform(): string {
+  const navigatorLike = (globalThis as {
+    navigator?: {
+      platform?: string;
+      userAgent?: string;
+      userAgentData?: { platform?: string };
+    };
+  }).navigator;
+  return [
+    navigatorLike?.userAgentData?.platform,
+    navigatorLike?.platform,
+    navigatorLike?.userAgent,
+  ].filter(Boolean).join(" ");
+}
+
+function isMacDesktopPlatform(desktopPlatform?: string): boolean {
+  const raw = desktopPlatform?.trim() || currentDesktopPlatform();
+  return /(darwin|mac|iphone|ipad|ipod)/i.test(raw);
+}
+
+export function webAsciiTextWordmarkVariant(
+  text: string,
+  font: AsciiFontName = "tiny",
+  desktopPlatform?: string,
+): WebWordmarkVariant {
+  if (font !== "wordmark" || text.trim().toLowerCase() !== "gloomberb") return null;
+  return isMacDesktopPlatform(desktopPlatform) ? "legacy" : "compat";
+}
+
+export function webAsciiTextLines(
+  text: string,
+  font: AsciiFontName = "tiny",
+  desktopPlatform?: string,
+): string[] {
+  return webAsciiTextWordmarkVariant(text, font, desktopPlatform) === "compat"
+    ? WEB_GLOOMBERB_WORDMARK
+    : renderAsciiText(text, font);
+}

package/src/renderers/electrobun/view/host/text.test.ts

@@ -0,0 +1,22 @@
+import { describe, expect, test } from "bun:test";
+import { renderAsciiText } from "../../../../ui/ascii-font";
+import { webAsciiTextLines, webAsciiTextWordmarkVariant } from "./ascii-text";
+
+describe("desktop web ASCII text", () => {
+  test("keeps the legacy Gloomberb wordmark on macOS", () => {
+    expect(webAsciiTextWordmarkVariant("Gloomberb", "wordmark", "darwin")).toBe("legacy");
+    expect(webAsciiTextWordmarkVariant("Gloomberb", "wordmark", "MacIntel")).toBe("legacy");
+    expect(webAsciiTextLines("Gloomberb", "wordmark", "darwin")).toEqual(
+      renderAsciiText("Gloomberb", "wordmark"),
+    );
+  });
+
+  test("uses the web-safe Gloomberb wordmark off macOS", () => {
+    const lines = webAsciiTextLines("Gloomberb", "wordmark", "win32");
+
+    expect(webAsciiTextWordmarkVariant("Gloomberb", "wordmark", "win32")).toBe("compat");
+    expect(lines).toHaveLength(5);
+    expect(lines[0]).toContain("____");
+    expect(lines).not.toEqual(renderAsciiText("Gloomberb", "wordmark"));
+  });
+});

package/src/renderers/electrobun/view/host/text.tsx

@@ -7,21 +7,17 @@ import {
   type StyledTextChunk,
   type TextProps,
 } from "../../../../ui/host";
-import { renderAsciiText } from "../../../../ui/ascii-font";
 import { WEB_CELL_WIDTH } from "../input-host";
+import { webAsciiTextLines, webAsciiTextWordmarkVariant } from "./ascii-text";
 import { hasDirectMouseHandler, mouseHandlers } from "./mouse";
 import { cleanDomProps, commonStyle, textStyle } from "./style";
 
-const WEB_GLOOMBERB_WORDMARK = [
-  "  ____ _                       _               _     ",
-  " / ___| | ___   ___  _ __ ___ | |__   ___ _ __| |__  ",
-  "| |  _| |/ _ \\ / _ \\| '_ ` _ \\| '_ \\ / _ \\ '__| '_ \\ ",
-  "| |_| | | (_) | (_) | | | | | | |_) |  __/ |  | |_) |",
-  " \\____|_|\\___/ \\___/|_| |_| |_|_.__/ \\___|_|  |_.__/ ",
-];
-
 const WEB_WORDMARK_CHAR_WIDTH_PX = Math.max(10, WEB_CELL_WIDTH);
 
+interface WebAsciiTextProps extends AsciiTextProps {
+  desktopPlatform?: string;
+}
+
 function isStyledTextContent(value: unknown): value is { chunks: StyledTextChunk[] } {
   return value instanceof StyledText
     || (!!value && typeof value === "object" && Array.isArray((value as { chunks?: unknown }).chunks));
@@ -100,16 +96,17 @@ export function WebAsciiText({
   bg,
   backgroundColor,
   selectable = false,
+  desktopPlatform,
   ...props
-}: AsciiTextProps) {
-  const isWordmark = font === "wordmark";
-  const lines = isWordmark && text.trim().toLowerCase() === "gloomberb"
-    ? WEB_GLOOMBERB_WORDMARK
-    : renderAsciiText(text, font);
+}: WebAsciiTextProps) {
+  const wordmarkVariant = webAsciiTextWordmarkVariant(text, font, desktopPlatform);
+  const isCompatWordmark = wordmarkVariant === "compat";
+  const isLegacyWordmark = wordmarkVariant === "legacy";
+  const lines = webAsciiTextLines(text, font, desktopPlatform);
   const resolvedColor = color ?? fg;
   const resolvedBackground = bg ?? backgroundColor;
-  const lineHeightPx = isWordmark ? 16 : 12;
-  const wordmarkWidthPx = isWordmark
+  const lineHeightPx = isCompatWordmark ? 16 : 12;
+  const wordmarkWidthPx = isCompatWordmark
     ? Math.max(...lines.map((line) => line.length)) * WEB_WORDMARK_CHAR_WIDTH_PX
     : undefined;
   return (
@@ -118,15 +115,16 @@ export function WebAsciiText({
       data-gloom-role={(props["data-gloom-role"] as string | undefined) ?? "ascii-text"}
       style={{
         ...commonStyle({ ...props, fg: resolvedColor, bg: resolvedBackground }),
-        display: "block",
+        display: isLegacyWordmark ? "flex" : "block",
+        flexDirection: isLegacyWordmark ? "column" : undefined,
         flexShrink: 0,
         ...(wordmarkWidthPx != null && props.width == null
           ? { width: `${wordmarkWidthPx}px`, minWidth: `${wordmarkWidthPx}px` }
           : {}),
         color: resolvedColor,
         backgroundColor: resolvedBackground,
-        fontFamily: isWordmark ? "\"Cascadia Mono\", Consolas, \"Courier New\", monospace" : undefined,
-        fontSize: isWordmark ? "16px" : undefined,
+        fontFamily: isCompatWordmark ? "\"Cascadia Mono\", Consolas, \"Courier New\", monospace" : undefined,
+        fontSize: isCompatWordmark ? "16px" : undefined,
         fontVariantLigatures: "none",
         lineHeight: `${lineHeightPx}px`,
         whiteSpace: "pre",
@@ -135,7 +133,13 @@ export function WebAsciiText({
         ...(props.style as CSSProperties | undefined),
       }}
     >
-      {lines.join("\n")}
+      {isLegacyWordmark
+        ? lines.map((line, index) => (
+          <span key={index} style={{ display: "block", height: "12px", lineHeight: "12px" }}>
+            {line}
+          </span>
+        ))
+        : lines.join("\n")}
     </div>
   );
 }

package/src/renderers/electrobun/view/main.tsx

@@ -19,7 +19,7 @@ import { DesktopFatalScreen, ElectrobunErrorBoundary } from "./fatal-screen";
 import { WebInputHostProvider } from "./input-host";
 import { webNativeRenderer } from "./native-renderer";
 import { WebToastHostProvider } from "./toast-host";
-import { webRendererHost, webUiHost } from "./ui-host";
+import { createWebUiHost, webRendererHost } from "./ui-host";
 import { createApplicationMenuBridge } from "./application-menu-bridge";
 import { createDesktopWindowBridge } from "./desktop/window/bridge";
 import { prepareDetachedSnapshot } from "./desktop/window/snapshot";
@@ -88,6 +88,7 @@ async function boot() {
   const config = desktopSnapshot?.config ?? init.config;
   const desktopWindowBridge = createDesktopWindowBridge(init.windowKind, init.paneId);
   const desktopApplicationMenuBridge = createApplicationMenuBridge();
+  const webUiHost = createWebUiHost(init.desktopPlatform);
   measurePerfAsync("startup.electrobun.root-render", async () => {
     root.render(
       <ElectrobunErrorBoundary>

package/src/renderers/electrobun/view/styles.css

@@ -32,15 +32,9 @@ button, [data-gloom-interactive="true"] { cursor: pointer; }
 [data-gloom-role="app-header"][data-titlebar-overlay="true"],
 .electrobun-webkit-app-region-drag {
   cursor: default;
-  -webkit-app-region: drag;
-  app-region: drag;
   -webkit-user-select: none;
   user-select: none;
 }
-.electrobun-webkit-app-region-no-drag {
-  -webkit-app-region: no-drag;
-  app-region: no-drag;
-}
 [data-titlebar-overlay="true"] {
   min-height: __TITLEBAR_OVERLAY_HEIGHT_PX__px;
   max-height: __TITLEBAR_OVERLAY_HEIGHT_PX__px;
@@ -55,15 +49,22 @@ button, [data-gloom-interactive="true"] { cursor: pointer; }
 [data-titlebar-overlay="true"] a,
 [data-titlebar-overlay="true"] .electrobun-webkit-app-region-no-drag,
 [data-titlebar-overlay="true"] [data-gloom-interactive="true"] {
-  -webkit-app-region: no-drag;
-  app-region: no-drag;
+  cursor: pointer;
 }
 [data-gloom-role="window-controls"] {
   height: 100%;
   color: var(--gloom-header-text, #f2f2f2);
 }
 [data-gloom-role="window-control"] {
+  appearance: none;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  border: 0;
+  padding: 0;
+  background: transparent;
   color: color-mix(in srgb, var(--gloom-header-text, #f2f2f2) 86%, transparent);
+  cursor: pointer;
   transition: background-color 90ms linear, color 90ms linear;
 }
 [data-gloom-role="window-control"] svg {

package/src/renderers/electrobun/view/ui-host.tsx

@@ -31,92 +31,117 @@ function currentDesktopPlatform(): string {
   const navigatorWithUserAgentData = navigator as Navigator & {
     userAgentData?: { platform?: string };
   };
-  return navigatorWithUserAgentData.userAgentData?.platform ?? navigator.platform ?? "";
+  return [
+    navigatorWithUserAgentData.userAgentData?.platform,
+    navigator.platform,
+    navigator.userAgent,
+  ].filter((value): value is string => Boolean(value)).join(" ");
 }
 
 const DESKTOP_PLATFORM = currentDesktopPlatform();
-const USES_WINDOWS_CONTROLS = /win/i.test(DESKTOP_PLATFORM);
+const USES_WINDOWS_CONTROLS = !/(darwin|ipad|iphone|linux|mac)/i.test(DESKTOP_PLATFORM);
+const NON_WINDOWS_DESKTOP_PLATFORMS = /^(darwin|linux|freebsd|openbsd|aix|sunos)$/i;
 
-export const webUiHost: UiHost = {
-  kind: "desktop-web",
-  capabilities: {
-    nativePaneChrome: true,
-    titleBarOverlay: true,
-    precisePointer: true,
-    fractionalViewport: true,
-    cellWidthPx: WEB_CELL_WIDTH,
-    cellHeightPx: WEB_CELL_HEIGHT,
-    pixelRatio: Math.min(window.devicePixelRatio || 1, 2),
-    canvasCharts: true,
-    nativeContextMenu: NATIVE_CONTEXT_MENU_SUPPORTED,
-    windowControls: USES_WINDOWS_CONTROLS ? "windows" : undefined,
-  },
-  Box: WebBox,
-  Text: WebText,
-  Span: WebSpan,
-  Strong: WebStrong,
-  Underline: WebUnderline,
-  ScrollBox: WebScrollBox,
-  Input: WebInput,
-  Textarea: WebTextarea,
-  Button: WebButton,
-  TextField: WebTextField,
-  MessageComposer: WebMessageComposer,
-  ListView: WebListView,
-  SegmentedControl: WebSegmentedControl,
-  DialogFrame: WebDialogFrame,
-  PageStackView: WebPageStackView,
-  DataTable: WebDataTable,
-  Tabs: WebTabs,
-  ChartSurface: WebChartSurface,
-  ImageSurface: ({ children, src, alt = "", objectFit = "contain", ...props }) => {
-    const imageSrc = typeof src === "string" ? src.trim() : "";
-    const [failed, setFailed] = useState(false);
-    useEffect(() => setFailed(false), [imageSrc]);
-    const baseStyle = commonStyle(props);
-    return (
-      <div
+function usesWindowsWindowControls(desktopPlatform?: string): boolean {
+  const platform = desktopPlatform?.trim();
+  if (!platform) {
+    return USES_WINDOWS_CONTROLS;
+  }
+  if (/^win/i.test(platform)) {
+    return true;
+  }
+  if (NON_WINDOWS_DESKTOP_PLATFORMS.test(platform)) {
+    return false;
+  }
+  return USES_WINDOWS_CONTROLS;
+}
+
+export function createWebUiHost(desktopPlatform?: string): UiHost {
+  const usesWindowsControls = usesWindowsWindowControls(desktopPlatform);
+
+  return {
+    kind: "desktop-web",
+    capabilities: {
+      nativePaneChrome: true,
+      titleBarOverlay: true,
+      precisePointer: true,
+      fractionalViewport: true,
+      cellWidthPx: WEB_CELL_WIDTH,
+      cellHeightPx: WEB_CELL_HEIGHT,
+      pixelRatio: Math.min(window.devicePixelRatio || 1, 2),
+      canvasCharts: true,
+      nativeContextMenu: NATIVE_CONTEXT_MENU_SUPPORTED,
+      windowControls: usesWindowsControls ? "windows" : undefined,
+    },
+    Box: WebBox,
+    Text: WebText,
+    Span: WebSpan,
+    Strong: WebStrong,
+    Underline: WebUnderline,
+    ScrollBox: WebScrollBox,
+    Input: WebInput,
+    Textarea: WebTextarea,
+    Button: WebButton,
+    TextField: WebTextField,
+    MessageComposer: WebMessageComposer,
+    ListView: WebListView,
+    SegmentedControl: WebSegmentedControl,
+    DialogFrame: WebDialogFrame,
+    PageStackView: WebPageStackView,
+    DataTable: WebDataTable,
+    Tabs: WebTabs,
+    ChartSurface: WebChartSurface,
+    ImageSurface: ({ children, src, alt = "", objectFit = "contain", ...props }) => {
+      const imageSrc = typeof src === "string" ? src.trim() : "";
+      const [failed, setFailed] = useState(false);
+      useEffect(() => setFailed(false), [imageSrc]);
+      const baseStyle = commonStyle(props);
+      return (
+        <div
+          {...cleanDomProps(props)}
+          style={{
+            ...baseStyle,
+            overflow: baseStyle.overflow ?? "hidden",
+            ...(props.style as CSSProperties | undefined),
+          }}
+        >
+          {imageSrc && !failed ? (
+            <img
+              src={imageSrc}
+              alt={alt}
+              draggable={false}
+              onError={() => setFailed(true)}
+              style={{
+                width: "100%",
+                height: "100%",
+                display: "block",
+                objectFit,
+              }}
+            />
+          ) : children as ReactNode}
+        </div>
+      );
+    },
+    SpinnerMark: ({ color, ...props }) => (
+      <span
         {...cleanDomProps(props)}
+        aria-hidden="true"
         style={{
-          ...baseStyle,
-          overflow: baseStyle.overflow ?? "hidden",
+          color,
+          display: "inline-block",
+          width: "1ch",
+          animation: "gloom-spin 0.9s steps(8) infinite",
           ...(props.style as CSSProperties | undefined),
         }}
       >
-        {imageSrc && !failed ? (
-          <img
-            src={imageSrc}
-            alt={alt}
-            draggable={false}
-            onError={() => setFailed(true)}
-            style={{
-              width: "100%",
-              height: "100%",
-              display: "block",
-              objectFit,
-            }}
-          />
-        ) : children as ReactNode}
-      </div>
-    );
-  },
-  SpinnerMark: ({ color, ...props }) => (
-    <span
-      {...cleanDomProps(props)}
-      aria-hidden="true"
-      style={{
-        color,
-        display: "inline-block",
-        width: "1ch",
-        animation: "gloom-spin 0.9s steps(8) infinite",
-        ...(props.style as CSSProperties | undefined),
-      }}
-    >
-      *
-    </span>
-  ),
-  AsciiText: WebAsciiText,
-};
+        *
+      </span>
+    ),
+    AsciiText: (props) => <WebAsciiText {...props} desktopPlatform={desktopPlatform} />,
+  };
+}
+
+export const webUiHost: UiHost = createWebUiHost();
 
 export const webRendererHost: RendererHost = {
   supportsNativeDesktopNotifications: true,

package/src/renderers/opentui/start.tsx

@@ -16,18 +16,26 @@ import { ToastHostProvider } from "../../ui/toast";
 import { colors } from "../../theme/colors";
 import { startMainThreadMonitor } from "../../utils/main-thread-monitor";
 import { measurePerfAsync } from "../../utils/perf-marks";
+import type { CliLaunchRequest } from "../../types/plugin";
 
-export async function startOpenTuiApp(): Promise<void> {
+export interface StartOpenTuiAppOptions {
+  externalPlugins?: Awaited<ReturnType<typeof loadExternalPlugins>>;
+  cliArgs?: string[];
+  skipCliDispatch?: boolean;
+  cliLaunchRequest?: CliLaunchRequest | null;
+}
+
+export async function startOpenTuiApp(options: StartOpenTuiAppOptions = {}): Promise<void> {
   setConfigStoreHost(nodeConfigStoreHost);
   debugLog.interceptConsole();
 
   const appLog = debugLog.createLogger("app");
   appLog.info("Gloomberb starting");
 
-  const cliArgs = process.argv.slice(2);
-  const externalPlugins = await measurePerfAsync("startup.opentui.load-external-plugins", () => loadExternalPlugins());
-  let cliLaunchRequest = null;
-  if (cliArgs.length > 0) {
+  const cliArgs = options.cliArgs ?? process.argv.slice(2);
+  const externalPlugins = options.externalPlugins ?? await measurePerfAsync("startup.opentui.load-external-plugins", () => loadExternalPlugins());
+  let cliLaunchRequest = options.cliLaunchRequest ?? null;
+  if (!options.skipCliDispatch && cliArgs.length > 0) {
     const dispatchResult = await dispatchCli(cliArgs, { externalPlugins });
     if (dispatchResult.kind === "handled") return;
     if (dispatchResult.kind === "launch-ui") {

package/src/state/app/input-capture.ts

@@ -0,0 +1,12 @@
+import { useEffect } from "react";
+import { useAppDispatch } from "./context";
+
+export function useAppInputCapture(captured: boolean) {
+  const dispatch = useAppDispatch();
+
+  useEffect(() => {
+    if (!captured) return;
+    dispatch({ type: "SET_INPUT_CAPTURED", captured: true });
+    return () => dispatch({ type: "SET_INPUT_CAPTURED", captured: false });
+  }, [captured, dispatch]);
+}

package/src/types/plugin.ts

@@ -4,6 +4,8 @@ import type { PluginEvents } from "../plugins/event-bus";
 import type { PluginLogger } from "../utils/debug-log";
 import type { BrokerAdapter } from "./broker";
 import type { PluginCapability } from "../capabilities";
+import type { CliGlobalOptions } from "../cli/options";
+import type { CliResult, CliResultRenderOptions } from "../cli/result";
 import type { ContextMenuContext, ContextMenuItem } from "./context-menu";
 import type {
   AppConfig,
@@ -245,6 +247,8 @@ export type CliDispatchResult =
 export interface CliCommandContext {
   initConfigData(): Promise<import("../cli/types").ConfigContext>;
   initMarketData(): Promise<import("../cli/types").MarketContext>;
+  initServices(): Promise<import("../cli/types").CliServicesContext>;
+  cliOptions: CliGlobalOptions;
   plugins: GloomPlugin[];
   fail(message: string, details?: string): never;
   closeAndFail(
@@ -259,6 +263,10 @@ export interface CliCommandContext {
     renderStat: typeof import("../utils/cli-output").renderStat;
     renderTable: typeof import("../utils/cli-output").renderTable;
   };
+  printResult<T, Row extends Record<string, unknown> = Record<string, unknown>>(
+    result: CliResult<T>,
+    options?: CliResultRenderOptions<T, Row>,
+  ): void;
   log: PluginLogger;
 }
 
@@ -270,6 +278,25 @@ export interface CliCommandDef {
   execute(args: string[], ctx: CliCommandContext): void | CliDispatchResult | Promise<void | CliDispatchResult>;
 }
 
+export interface PluginCliCommandDescriptor {
+  name: string;
+  aliases?: string[];
+  summary: string;
+  inputShape?: string;
+  outputShape?: string;
+  examples?: string[];
+  sideEffectLevel?: "none" | "local-write" | "network-write" | "external-trade" | "external-side-effect";
+  requirements?: string[];
+  batch?: boolean;
+  formats?: Array<"text" | "json" | "csv" | "ndjson">;
+  safety?: string[];
+  execute?: CliCommandDef["execute"];
+}
+
+export interface PluginCliDescriptor {
+  commands?: PluginCliCommandDescriptor[];
+}
+
 export interface CommandDef {
   id: string;
   label: string;
@@ -489,6 +516,7 @@ export interface GloomPlugin {
   toggleable?: boolean;
   order?: number;
   cliCommands?: CliCommandDef[];
+  cli?: PluginCliDescriptor;
 
   setup?(ctx: GloomPluginContext): void | Promise<void>;
   dispose?(): void;

package/src/utils/cli-output.ts

@@ -8,11 +8,17 @@ export interface CliTableColumn {
 }
 
 const ANSI_PATTERN = /\x1b\[[0-9;]*m/g;
+let colorEnabledOverride: boolean | null = null;
 
 function colorEnabled(): boolean {
+  if (colorEnabledOverride != null) return colorEnabledOverride;
   return !!process.stdout.isTTY && process.env.NO_COLOR !== "1" && process.env.TERM !== "dumb";
 }
 
+export function setCliColorEnabledOverride(value: boolean | null): void {
+  colorEnabledOverride = value;
+}
+
 function applyAnsi(text: string, code: string): string {
   if (!colorEnabled()) return text;
   return `\x1b[${code}m${text}\x1b[0m`;

package/src/utils/search-focus-navigation.ts

@@ -0,0 +1,24 @@
+import { isPlainKeyboardEvent, type KeyboardModifierEventLike } from "./keyboard";
+
+export interface SearchFocusNavigationEvent extends KeyboardModifierEventLike {
+  sequence?: string;
+  preventDefault?: () => void;
+  stopPropagation?: () => void;
+}
+
+export function isPlainArrowDown(event: SearchFocusNavigationEvent): boolean {
+  if (!isPlainKeyboardEvent(event)) return false;
+  const name = event.name?.toLowerCase();
+  return name === "down" || event.sequence === "\u001b[B" || event.sequence === "\u001bOB";
+}
+
+export function isPlainArrowUp(event: SearchFocusNavigationEvent): boolean {
+  if (!isPlainKeyboardEvent(event)) return false;
+  const name = event.name?.toLowerCase();
+  return name === "up" || event.sequence === "\u001b[A" || event.sequence === "\u001bOA";
+}
+
+export function stopSearchFocusNavigation(event: SearchFocusNavigationEvent): void {
+  event.preventDefault?.();
+  event.stopPropagation?.();
+}

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = "0.9.1";
+export const VERSION = "0.9.3";