numux 2.16.2 → 2.17.1

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 import type { Color } from './utils/color';
+import type { ThemePref } from './utils/theme';
 export interface NumuxProcessConfig<K extends string = string> {
     /** Shell command to run. Supports `$dep.group` references from dependency capture groups */
     command: string;
@@ -122,6 +123,12 @@ export interface NumuxConfig<K extends string = string> {
     noWatch?: boolean;
     /** Directory to write per-process log files */
     logDir?: string;
+    /**
+     * TUI color theme. `'auto'` detects the terminal background via OSC 11 (falling back
+     * to `COLORFGBG` then dark). `'light'`/`'dark'` skip detection.
+     * @default 'auto'
+     */
+    theme?: ThemePref;
     processes: Record<K, NumuxProcessConfig<K> | NumuxScriptPattern<K> | string | true>;
 }
 export type SortOrder = 'config' | 'alphabetical' | 'topological' | 'status';
@@ -138,6 +145,7 @@ export interface ResolvedNumuxConfig {
     killOthersOnFail?: boolean;
     noWatch?: boolean;
     logDir?: string;
+    theme?: ThemePref;
     processes: Record<string, ResolvedProcessConfig>;
 }
 export type ProcessStatus = 'pending' | 'starting' | 'ready' | 'running' | 'stopping' | 'stopped' | 'finished' | 'failed' | 'skipped';

package/dist/utils/color.d.ts

@@ -34,7 +34,7 @@ export declare const ANSI_RESET = "\u001B[0m";
 export declare function stripAnsi(str: string): string;
 /** Pick a deterministic color from the default palette based on the process name */
 export declare function colorFromName(name: string): Color;
-/** Build a map of process names to ANSI color codes, using explicit config colors or a default palette. */
-export declare function buildProcessColorMap(names: string[], config: ResolvedNumuxConfig): Map<string, string>;
+/** Build a map of process names to ANSI color codes, using explicit config colors or a palette. */
+export declare function buildProcessColorMap(names: string[], config: ResolvedNumuxConfig, palette?: readonly string[]): Map<string, string>;
 /** Build a map of process names to hex color strings (for StyledText rendering). */
-export declare function buildProcessHexColorMap(names: string[], config: ResolvedNumuxConfig): Map<string, string>;
+export declare function buildProcessHexColorMap(names: string[], config: ResolvedNumuxConfig, palette?: readonly string[]): Map<string, string>;

package/dist/utils/theme.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Light/dark theme resolution. Detects terminal background via OSC 11
+ * query, falling back to COLORFGBG env var, then to dark. Explicit
+ * user config (`theme: 'light' | 'dark'`) skips detection entirely.
+ */
+export type ThemeMode = 'light' | 'dark';
+export type ThemePref = ThemeMode | 'auto';
+export interface StatusColors {
+    ready: string;
+    failed: string;
+    stopped: string;
+    finished: string;
+    skipped: string;
+}
+export interface Theme {
+    mode: ThemeMode;
+    statusBarBg: string;
+    statusBarText: string;
+    helpBackdropBg: string;
+    helpBoxBg: string;
+    helpBorder: string;
+    helpText: string;
+    sidebarBg: string;
+    sidebarBorder: string;
+    tabSelectedBg: string;
+    tabSelectedText: string;
+    tabText: string;
+    tabDescriptionText: string;
+    tabSelectedDescriptionText: string;
+    scrollTrackBg: string;
+    scrollThumbBg: string;
+    searchCurrentBg: string;
+    searchMatchBg: string;
+    palette: readonly string[];
+    status: StatusColors;
+    inputWaiting: string;
+    errorIndicator: string;
+    searchMatchTab: string;
+    iconDefault: string;
+}
+export declare const DARK_THEME: Theme;
+export declare const LIGHT_THEME: Theme;
+export declare function themeFor(mode: ThemeMode): Theme;
+/** WCAG relative luminance (0–1). */
+export declare function relativeLuminance(r: number, g: number, b: number): number;
+export declare function isLightRgb(r: number, g: number, b: number): boolean;
+/**
+ * Parse OSC 11 response body. Accepts `rgb:RRRR/GGGG/BBBB` (4 hex digits,
+ * xterm/Ghostty/kitty/alacritty/iTerm2) or 2-digit short form. Returns null
+ * on malformed input.
+ */
+export declare function parseOSC11Response(data: string): {
+    r: number;
+    g: number;
+    b: number;
+} | null;
+/**
+ * Parse COLORFGBG env var (e.g. `"15;0"` = white fg on black bg = dark).
+ * Convention: bg index ≥7 is light, otherwise dark. iTerm2 sometimes sets
+ * the middle field to `default`; we read the last segment as the bg.
+ */
+export declare function parseColorFgBg(value: string | undefined): ThemeMode | null;
+/**
+ * Query the terminal's background color via OSC 11. Resolves to `null` on
+ * non-TTY, timeout, or unparseable response. Runs synchronously-ish in under
+ * `timeoutMs` (default 100ms). Must be called before any renderer takes
+ * over stdin.
+ */
+export declare function queryOSC11(timeoutMs?: number): Promise<ThemeMode | null>;
+export declare function detectThemeMode(timeoutMs?: number): Promise<ThemeMode | null>;
+/**
+ * Resolve final theme. Explicit `'light'`/`'dark'` skips detection;
+ * `'auto'` (or undefined) runs detection, falling back to dark.
+ */
+export declare function resolveTheme(pref?: ThemePref | undefined): Promise<Theme>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "numux",
-  "version": "2.16.2",
+  "version": "2.17.1",
   "description": "Terminal multiplexer with dependency orchestration",
   "type": "module",
   "license": "MIT",
@@ -45,8 +45,8 @@
     "dist/"
   ],
   "dependencies": {
-    "@opentui/core": "^0.1.88",
-    "ghostty-opentui": "^1.4.7"
+    "@opentui/core": "^0.4.1",
+    "ghostty-opentui": "^1.5.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.4",
@@ -54,8 +54,5 @@
     "@commitlint/config-conventional": "^20.4.2",
     "@types/bun": "^1.3.9",
     "marked-man": "^2.1.0"
-  },
-  "patchedDependencies": {
-    "ghostty-opentui@1.4.7": "patches/ghostty-opentui@1.4.7.patch"
   }
 }