@mudah-cli/ui 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -3,4 +3,4 @@ export { Output, type OutputEvent, type OutputMode, type OutputOptions } from '.
 export { renderMarkdown, type RenderMarkdownOptions } from './markdown.js';
 export { renderPanel, type RenderPanelOptions } from './panel.js';
 export { renderTable, type RenderTableOptions, type TableColumn } from './table.js';
-export { resolveTheme, sleekDark, sleekLight, themes, type Theme, type ThemeColors } from './theme.js';
+export { detectTheme, resolveTheme, sleekDark, sleekLight, themes, type DetectThemeOptions, type Theme, type ThemeColors, } from './theme.js';

package/dist/index.js

@@ -3,5 +3,5 @@ export { Output } from './output.js';
 export { renderMarkdown } from './markdown.js';
 export { renderPanel } from './panel.js';
 export { renderTable } from './table.js';
-export { resolveTheme, sleekDark, sleekLight, themes } from './theme.js';
+export { detectTheme, resolveTheme, sleekDark, sleekLight, themes, } from './theme.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,OAAO,EACL,IAAI,EACJ,GAAG,EACH,MAAM,EACN,KAAK,EACL,OAAO,EACP,SAAS,EACT,SAAS,EACT,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAyD,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,cAAc,EAA8B,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,WAAW,EAA2B,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,WAAW,EAA6C,MAAM,YAAY,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAgC,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,GAAG,EACH,MAAM,EACN,KAAK,EACL,OAAO,EACP,SAAS,EACT,SAAS,EACT,aAAa,GACd,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAyD,MAAM,aAAa,CAAC;AAC5F,OAAO,EAAE,cAAc,EAA8B,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,WAAW,EAA2B,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,WAAW,EAA6C,MAAM,YAAY,CAAC;AACpF,OAAO,EACL,WAAW,EACX,YAAY,EACZ,SAAS,EACT,UAAU,EACV,MAAM,GAIP,MAAM,YAAY,CAAC"}

package/dist/theme.d.ts

@@ -1,3 +1,4 @@
+import { type OscWriter, type ThemeQueryInput } from '@mudah-cli/terminal';
 export interface ThemeColors {
     /** Primary brand accent (headings, highlights). */
     accent: string;
@@ -20,6 +21,32 @@ export declare const sleekLight: Theme;
 export declare const themes: Record<string, Theme>;
 /**
  * Resolve a theme by name. `'auto'` falls back to dark mode (the safe
- * default for CLI tools); a runtime OSC 10 query can refine this in v0.2.
+ * default for CLI tools) — use `detectTheme()` when you want the terminal's
+ * real colors to decide.
  */
 export declare function resolveTheme(name: string | undefined): Theme;
+export interface DetectThemeOptions {
+    /**
+     * Theme name. Only `'auto'` triggers a terminal query — an explicit name
+     * (and `undefined`) resolve synchronously, keeping cold start untouched.
+     */
+    name?: string;
+    /**
+     * Skip the query entirely (non-interactive runs, tests). Defaults to
+     * `process.stdin.isTTY`.
+     */
+    allowQuery?: boolean;
+    /** How long to wait for the terminal's answer. */
+    timeoutMs?: number;
+    /** Stream the query is written to (default `process.stdout`). */
+    stdout?: OscWriter;
+    /** Stream the answer is read from (default `process.stdin`). */
+    stdin?: ThemeQueryInput;
+}
+/**
+ * Resolve the theme, asking the terminal for its colors when the manifest
+ * asks for `'auto'`. Every other name resolves synchronously, and any run
+ * that can't answer (no TTY, timeout, silent terminal) falls back to dark.
+ * Never throws.
+ */
+export declare function detectTheme(options?: DetectThemeOptions): Promise<Theme>;

package/dist/theme.js

@@ -1,3 +1,4 @@
+import { queryTerminalTheme } from '@mudah-cli/terminal';
 export const sleekDark = {
     name: 'sleek-dark',
     mode: 'dark',
@@ -35,11 +36,39 @@ export const themes = {
 };
 /**
  * Resolve a theme by name. `'auto'` falls back to dark mode (the safe
- * default for CLI tools); a runtime OSC 10 query can refine this in v0.2.
+ * default for CLI tools) — use `detectTheme()` when you want the terminal's
+ * real colors to decide.
  */
 export function resolveTheme(name) {
     if (name === undefined || name === 'auto')
         return sleekDark;
     return themes[name] ?? sleekDark;
 }
+/**
+ * Resolve the theme, asking the terminal for its colors when the manifest
+ * asks for `'auto'`. Every other name resolves synchronously, and any run
+ * that can't answer (no TTY, timeout, silent terminal) falls back to dark.
+ * Never throws.
+ */
+export async function detectTheme(options = {}) {
+    const name = options.name;
+    if (name !== 'auto')
+        return resolveTheme(name);
+    const allowQuery = options.allowQuery ?? process.stdin.isTTY === true;
+    if (!allowQuery)
+        return sleekDark;
+    try {
+        const result = await queryTerminalTheme({
+            timeoutMs: options.timeoutMs,
+            stdout: options.stdout,
+            stdin: options.stdin,
+        });
+        if (!result.ok)
+            return sleekDark;
+        return result.theme === 'light' ? sleekLight : sleekDark;
+    }
+    catch {
+        return sleekDark;
+    }
+}
 //# sourceMappingURL=theme.js.map

package/dist/theme.js.map

@@ -1 +1 @@
-{"version":3,"file":"theme.js","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAmBA,MAAM,CAAC,MAAM,SAAS,GAAU;IAC9B,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE;QACN,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,SAAS;QACpB,IAAI,EAAE,SAAS;KAChB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAU;IAC/B,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,OAAO;IACb,MAAM,EAAE;QACN,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,SAAS;QACpB,IAAI,EAAE,SAAS;KAChB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAA0B;IAC3C,KAAK,EAAE,SAAS;IAChB,YAAY,EAAE,SAAS;IACvB,aAAa,EAAE,UAAU;CAC1B,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,IAAwB;IACnD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IAC5D,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;AACnC,CAAC"}
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAwC,MAAM,qBAAqB,CAAC;AAqB/F,MAAM,CAAC,MAAM,SAAS,GAAU;IAC9B,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE;QACN,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,SAAS;QACpB,IAAI,EAAE,SAAS;KAChB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAU;IAC/B,IAAI,EAAE,aAAa;IACnB,IAAI,EAAE,OAAO;IACb,MAAM,EAAE;QACN,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,SAAS;QAClB,KAAK,EAAE,SAAS;QAChB,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,SAAS;QACpB,IAAI,EAAE,SAAS;KAChB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAA0B;IAC3C,KAAK,EAAE,SAAS;IAChB,YAAY,EAAE,SAAS;IACvB,aAAa,EAAE,UAAU;CAC1B,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAwB;IACnD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,SAAS,CAAC;IAC5D,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;AACnC,CAAC;AAqBD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAO,GAAuB,EAAE;IAChE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;IAE/C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC;IACtE,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAElC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC;YACtC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,KAAK,EAAE,OAAO,CAAC,KAAK;SACrB,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,CAAC,EAAE;YAAE,OAAO,SAAS,CAAC;QACjC,OAAO,MAAM,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mudah-cli/ui",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Terminal design system: tokens, themes, output primitives, tables, panels, and markdown rendering.",
   "type": "module",
   "license": "MIT",
@@ -18,7 +18,7 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@mudah-cli/terminal": "^0.2.0"
+    "@mudah-cli/terminal": "^0.3.0"
   },
   "publishConfig": {
     "access": "public"