@zakmandhro/bunti 0.1.4 → 0.2.0

package/dist/state.d.ts

@@ -0,0 +1,226 @@
+/**
+ * Bunti Functional Screen State & Initialization
+ */
+import { type ColorTier, type TerminalProfile } from './detect';
+import type { HeldKeyTracker, InputTokenizer, KeyEvent, TerminalResponse } from './input';
+import type { Theme, ThemeColor } from './theme';
+/** 24-bit color triplet; each channel is 0-255. */
+export interface RGB {
+    r: number;
+    g: number;
+    b: number;
+}
+/**
+ * One terminal cell in the screen buffers. Drawing calls (blit/rect/setCell)
+ * take Partial<Cell> as their style argument.
+ */
+export interface Cell {
+    /** The glyph in this cell ('' marks a wide-glyph tail). */
+    char: string;
+    /** Foreground color: palette name, hex, ANSI-256 code, RGB, or theme token. */
+    fg?: string | number | RGB | ThemeColor;
+    /** Background color: palette name, hex, ANSI-256 code, RGB, or theme token. */
+    bg?: string | number | RGB | ThemeColor;
+    /** SGR bold. */
+    bold?: boolean;
+    /** Resolved fg ANSI code (set by setCell; do not set directly). */
+    fgCode?: string | number;
+    /** Resolved bg ANSI code (set by setCell; do not set directly). */
+    bgCode?: string | number;
+    /** Cell is a wide-glyph tail or transparent; the differ skips it. */
+    skip?: boolean;
+    /** Bypasses automatic emoji-to-Nerd-Font replacement. */
+    raw?: boolean;
+    /** SGR italic. */
+    italic?: boolean;
+    /** SGR underline. */
+    underline?: boolean;
+    /** SGR dim (faint). */
+    dim?: boolean;
+    /** SGR strikethrough. */
+    strike?: boolean;
+}
+/** A named clickable region registered via ctx.hitbox() (absolute cells). */
+export interface Hitbox {
+    id: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * The mutable per-screen state behind a render() session: double buffers,
+ * input queues, focus/hover bookkeeping, and component state. Exposed as
+ * `ctx.state` for advanced use; most apps only need the BuntiContext API.
+ */
+export interface ScreenState {
+    /** Terminal width in cells. */
+    width: number;
+    /** Terminal height in rows. */
+    height: number;
+    /** What is currently on the terminal (updated by flush). */
+    frontBuffer: Cell[];
+    /** The frame being drawn; diffed against frontBuffer on flush. */
+    backBuffer: Cell[];
+    /** Mouse column (0-based). */
+    mouseX: number;
+    /** Mouse row (0-based). */
+    mouseY: number;
+    /** Raw SGR button code of the most recent mouse event. */
+    mouseButton: number;
+    /** True while the left mouse button is held down. */
+    isMouseDown: boolean;
+    /** Terminal focus (drives the 5fps unfocused throttle). */
+    hasFocus: boolean;
+    /** First non-modified key name of the current frame (back-compat). */
+    lastKey?: string;
+    /** KeyEvents accumulated between frames; drained each tick into keys. */
+    keyQueue: KeyEvent[];
+    /** This frame's KeyEvents (drained from keyQueue by the render loop). */
+    keys: KeyEvent[];
+    /** Terminal probe replies (cursor position, DA1/DA2, DECRQM, DCS).
+     *  Consumers drain this array; it never feeds the key queue. */
+    terminalResponses: TerminalResponse[];
+    /** Press-origin of the click emitted this frame (undefined otherwise). */
+    clickX?: number;
+    clickY?: number;
+    /** Press-origin of an in-flight left-button press (click emits here). */
+    mouseDownX?: number;
+    mouseDownY?: number;
+    /** Hover state per hitbox id as of its last evaluation. */
+    hoverStates: Map<string, boolean>;
+    /** Hitbox ids whose hover turned on this frame. */
+    hoverEntered: Set<string>;
+    /** Hitbox ids whose hover turned off this frame. */
+    hoverLeft: Set<string>;
+    /** Lazily created by applyInputToState. */
+    inputTokenizer?: InputTokenizer;
+    /** Lazily created by the input dispatch; injectable for tests. */
+    heldKeys?: HeldKeyTracker;
+    /** Id of the currently focused focusable, if any. */
+    focusedId?: string;
+    /** Tab-cycle registration order (rebuilt each frame). */
+    focusableIds: string[];
+    /** Clickable regions registered this frame via ctx.hitbox(). */
+    hitboxes: Map<string, Hitbox>;
+    /** Backing store for useState/useAsync and motion/animation clocks. */
+    componentState: Map<string, any>;
+    /** Positional counter for keyless hooks (reset each frame). */
+    hookCounter?: number;
+    /** Epoch ms when render() started (ctx.elapsedTime = now - startTime). */
+    startTime: number;
+    /** Timestamp of the previous render tick (loop() owns this). */
+    lastFrameAt?: number;
+    /** Render tick counter (loop() owns this; exposed as ctx.frame). */
+    frameCount?: number;
+    /** Ms since the previous tick, clamped to 100 (exposed as ctx.dt). */
+    dt?: number;
+    /** SGR run-tracking across flushes (differ internals). */
+    lastFg?: any;
+    lastBg?: any;
+    lastBold?: boolean;
+    lastItalic?: boolean;
+    lastUnderline?: boolean;
+    lastDim?: boolean;
+    lastStrike?: boolean;
+    /** Last OSC 22 mouse-cursor shape emitted ('pointer' over hitboxes). */
+    pointerShape?: 'default' | 'pointer';
+    /** Forces the next flush to clear and repaint everything. */
+    needsFullRedraw?: boolean;
+    /** Optional screen identifier. */
+    id?: string;
+    /** The options render() was called with. */
+    options: ScreenOptions;
+    /** Stops the active render loop (what ctx.requestStop() calls). */
+    requestStop?: () => void;
+    /** True once the loop has been stopped. */
+    isStopped?: boolean;
+    /** True once the terminal has been restored (teardown ran). */
+    isRestored?: boolean;
+    /** True while a resize is settling (frames are skipped). */
+    isResizing?: boolean;
+    /** Epoch ms when the current resize debounce window ends. */
+    resizeSettlesAt?: number;
+    /** Active semantic theme (swapped live via ctx.setTheme). */
+    theme?: Theme;
+    /** Env-detected terminal profile (detected once per createScreenState). */
+    terminal?: TerminalProfile;
+    /**
+     * Effective synchronized-output flag for this screen. False only when the
+     * terminal was positively identified as lacking mode 2026 support;
+     * unknown terminals keep the sync wrap (harmlessly ignored when
+     * unsupported) to preserve pre-detection behavior.
+     */
+    syncOutput?: boolean;
+}
+/**
+ * Options for render(). Interactive apps typically want
+ * `{ keyboard: true, mouse: true, alternateBuffer: true, hideCursor: true }`.
+ */
+export interface ScreenOptions {
+    /** Target frames per second (default 60; throttles to 5 when unfocused). */
+    fps?: number;
+    /** Enables SGR mouse tracking (hover/click/wheel, ctx.hitbox). */
+    mouse?: boolean;
+    /** Enables terminal focus-in/out tracking (drives the fps throttle). */
+    focus?: boolean;
+    /**
+     * Enables keyboard input (raw-mode stdin -> ctx.lastKey / ctx.keys).
+     * Requires a real TTY: piped stdin is ignored.
+     */
+    keyboard?: boolean;
+    /** Renders on the alternate screen buffer and restores the shell on exit. */
+    alternateBuffer?: boolean;
+    /** Hides the terminal cursor while rendering (restored on exit). */
+    hideCursor?: boolean;
+    /** Forces the icon tier: true = Nerd Font glyphs, false = ASCII fallbacks. */
+    nerdFont?: boolean;
+    /** How long a resize must settle before repainting (default 1ms). */
+    resizeDebounceMs?: number;
+    /** Bare-ESC disambiguation window for the input tokenizer (default 30ms). */
+    escTimeoutMs?: number;
+    /** Held-key expiry window for ctx.isKeyHeld (default 150ms). */
+    holdWindowMs?: number;
+    /** Default text color for cells without an explicit fg. */
+    defaultFg?: string | number | RGB | ThemeColor;
+    /** Semantic theme exposed as ctx.theme (defaults to darkTheme). */
+    theme?: Theme;
+    /** Forces the color capability tier (otherwise detected from env). */
+    colorTier?: ColorTier;
+    /**
+     * Called when the render callback throws during a frame.
+     * Return `'continue'` to keep the loop alive (app-level error boundary);
+     * any other return tears the screen down, restores the terminal, and
+     * rejects the promise returned by render()/loop() with the error.
+     */
+    onError?: (err: unknown) => void | 'continue';
+}
+/**
+ * Creates a fresh ScreenState based on the terminal dimensions and options.
+ */
+export declare function createScreenState(options?: ScreenOptions): ScreenState;
+/**
+ * Resizes the front/back buffers to match the new terminal size.
+ */
+export declare function resizeScreen(state: ScreenState): void;
+/**
+ * Clears the back buffer to the base wallpaper or a given cell style.
+ */
+export declare function clearBackBuffer(state: ScreenState): void;
+/** Raw ANSI escape sequences used by the renderer (advanced use). */
+export declare const ANSI: {
+    reset: string;
+    clear: string;
+    home: string;
+    alternateBuffer: string;
+    mainBuffer: string;
+    hideCursor: string;
+    showCursor: string;
+    mouseEnable: string;
+    mouseDisable: string;
+    focusEnable: string;
+    focusDisable: string;
+    syncStart: string;
+    syncEnd: string;
+};
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

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

package/dist/state.js

@@ -0,0 +1,130 @@
+/**
+ * Bunti Functional Screen State & Initialization
+ */
+import { identifyTerminal, setColorTier, } from './detect';
+/**
+ * Creates a fresh ScreenState based on the terminal dimensions and options.
+ */
+export function createScreenState(options = {}) {
+    if (options.colorTier !== undefined)
+        setColorTier(options.colorTier);
+    const terminal = identifyTerminal();
+    const width = process.stdout.columns || 80;
+    const height = process.stdout.rows || 24;
+    const size = width * height;
+    const state = {
+        width,
+        height,
+        frontBuffer: Array.from({ length: size }, () => ({
+            char: '',
+            fg: undefined,
+            bg: undefined,
+            fgCode: undefined,
+            bgCode: undefined,
+            skip: false,
+        })),
+        backBuffer: Array.from({ length: size }, () => ({
+            char: ' ',
+            fg: undefined,
+            bg: undefined,
+            fgCode: undefined,
+            bgCode: undefined,
+            skip: false,
+        })),
+        mouseX: 0,
+        mouseY: 0,
+        mouseButton: 0,
+        isMouseDown: false,
+        hasFocus: true,
+        keyQueue: [],
+        keys: [],
+        terminalResponses: [],
+        hoverStates: new Map(),
+        hoverEntered: new Set(),
+        hoverLeft: new Set(),
+        focusableIds: [],
+        hitboxes: new Map(),
+        componentState: new Map(),
+        startTime: Date.now(),
+        options,
+        theme: options.theme,
+        terminal,
+        // Judgment call: unknown terminals keep today's always-sync behavior
+        // (mode 2026 is ignored when unsupported); only positively identified
+        // non-supporting terminals skip the wrap.
+        syncOutput: terminal.app === 'unknown' ? true : terminal.syncOutput,
+    };
+    return state;
+}
+/**
+ * Resizes the front/back buffers to match the new terminal size.
+ */
+export function resizeScreen(state) {
+    const width = process.stdout.columns || 80;
+    const height = process.stdout.rows || 24;
+    const size = width * height;
+    state.width = width;
+    state.height = height;
+    state.frontBuffer = Array.from({ length: size }, () => ({
+        char: '',
+        fg: undefined,
+        bg: undefined,
+        fgCode: undefined,
+        bgCode: undefined,
+        skip: false,
+    }));
+    state.backBuffer = Array.from({ length: size }, () => ({
+        char: ' ',
+        fg: undefined,
+        bg: undefined,
+        fgCode: undefined,
+        bgCode: undefined,
+        skip: false,
+    }));
+    state.lastFg = undefined;
+    state.lastBg = undefined;
+    state.lastBold = false;
+    state.lastItalic = false;
+    state.lastUnderline = false;
+    state.lastDim = false;
+    state.lastStrike = false;
+    state.needsFullRedraw = true;
+    state.isResizing = true;
+    state.resizeSettlesAt = Date.now() + (state.options.resizeDebounceMs ?? 1);
+}
+/**
+ * Clears the back buffer to the base wallpaper or a given cell style.
+ */
+export function clearBackBuffer(state) {
+    for (let i = 0; i < state.backBuffer.length; i++) {
+        const cell = state.backBuffer[i];
+        cell.char = ' ';
+        cell.fg = undefined;
+        cell.bg = undefined;
+        cell.fgCode = undefined;
+        cell.bgCode = undefined;
+        cell.bold = false;
+        cell.italic = false;
+        cell.underline = false;
+        cell.dim = false;
+        cell.strike = false;
+        cell.skip = false;
+    }
+}
+/** Raw ANSI escape sequences used by the renderer (advanced use). */
+export const ANSI = {
+    reset: '\x1b[0m',
+    clear: '\x1b[2J',
+    home: '\x1b[H',
+    alternateBuffer: '\x1b[?1049h',
+    mainBuffer: '\x1b[?1049l',
+    hideCursor: '\x1b[?25l',
+    showCursor: '\x1b[?25h',
+    mouseEnable: '\x1b[?1003h\x1b[?1006h',
+    mouseDisable: '\x1b[?1003l\x1b[?1006l',
+    focusEnable: '\x1b[?1004h',
+    focusDisable: '\x1b[?1004l',
+    syncStart: '\x1b[?2026h',
+    syncEnd: '\x1b[?2026l',
+};
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

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

package/dist/theme.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Bunti Semantic Theme System
+ *
+ * Themes are sets of semantic color tokens (background, primary, danger, ...)
+ * rather than hardcoded colors. Every token is a ThemeColor: callable as an
+ * fg-styler (`theme.primary('text')` returns an ANSI-colored string) AND
+ * usable as plain color data anywhere a color is accepted (bgColor,
+ * borderColor, wallpaper, gradient stops) via its `.rgb` / `.hex` payload.
+ *
+ * `createTheme(partial)` fills missing tokens by derivation so sparse inputs
+ * (e.g. a converted VS Code theme with only a handful of colors) still
+ * produce a coherent theme.
+ */
+import { type ColorValue } from './colors';
+import type { RGB } from './state';
+export type ThemeMode = 'dark' | 'light';
+/** Any value accepted as a theme token: name, hex, ANSI code, RGB, ThemeColor. */
+export type ThemeColorInput = ColorValue;
+/**
+ * A semantic theme color. Callable as a foreground styler —
+ * `theme.primary('Mission Control')` returns an fg-styled ANSI string — and
+ * carries `.rgb` / `.hex` so it is accepted anywhere a color value goes.
+ */
+export type ThemeColor = ((text: string | number) => string) & {
+    /** Resolved 24-bit color value. */
+    readonly rgb: RGB;
+    /** Resolved #rrggbb hex string. */
+    readonly hex: string;
+};
+/** The semantic token names every Theme carries. */
+export declare const THEME_TOKENS: readonly ["background", "surface", "surfaceRaised", "foreground", "muted", "primary", "onPrimary", "accent", "border", "focus", "selection", "success", "warning", "danger", "info"];
+export type ThemeToken = (typeof THEME_TOKENS)[number];
+/**
+ * A complete semantic theme. Build one with `createTheme()`, or import a
+ * preset from '@zakmandhro/bunti/themes' (dracula, tokyoNight, nord, ...).
+ */
+export interface Theme {
+    /** Display name (e.g. 'dracula'). */
+    name: string;
+    /** 'dark' or 'light' — components use it for mode-aware hover shifts. */
+    mode: ThemeMode;
+    /** App/screen background (wallpaper). */
+    background: ThemeColor;
+    /** Panel/card background, one step above `background`. */
+    surface: ThemeColor;
+    /** Elevated surface (modals, popovers), one step above `surface`. */
+    surfaceRaised: ThemeColor;
+    /** Default body text color. */
+    foreground: ThemeColor;
+    /** De-emphasized text (labels, hints, disabled). */
+    muted: ThemeColor;
+    /** Brand/action color (primary buttons, highlights). */
+    primary: ThemeColor;
+    /** Text rendered on top of `primary` fills. */
+    onPrimary: ThemeColor;
+    /** Secondary flourish color (links, icons, titles). */
+    accent: ThemeColor;
+    /** Default box/card border color. */
+    border: ThemeColor;
+    /** Focus ring / active-element color. */
+    focus: ThemeColor;
+    /** Selected-row/selection background wash. */
+    selection: ThemeColor;
+    /** Positive status. */
+    success: ThemeColor;
+    /** Cautionary status. */
+    warning: ThemeColor;
+    /** Destructive/error status. */
+    danger: ThemeColor;
+    /** Neutral-informational status. */
+    info: ThemeColor;
+    /** Optional named gradient stop lists (e.g. for wallpapers). */
+    gradients?: Record<string, (string | RGB)[]>;
+}
+/**
+ * Sparse theme spec: any subset of tokens; the rest are derived by
+ * `createTheme()`.
+ */
+export type ThemeInput = Partial<Record<ThemeToken, ThemeColorInput>> & {
+    name?: string;
+    mode?: ThemeMode;
+    gradients?: Record<string, (string | RGB)[]>;
+};
+/**
+ * Creates a ThemeColor from any color value: a function that fg-styles text,
+ * branded and carrying `.rgb` + `.hex`. ThemeColor inputs pass through
+ * unchanged.
+ */
+export declare function themeColor(input: ThemeColorInput): ThemeColor;
+/**
+ * Returns true when the value is a complete Theme (all tokens are branded
+ * ThemeColors), as opposed to a sparse ThemeInput.
+ */
+export declare function isTheme(value: unknown): value is Theme;
+/**
+ * Builds a complete Theme from a sparse spec. Missing tokens are derived:
+ *
+ * - mode: from background luminance when a background is given, else 'dark'.
+ * - background: #0f0f23 (dark) / #f4f5f9 (light).
+ * - surface / surfaceRaised: background shifted 8% / 16% toward white in
+ *   dark mode, toward black in light mode.
+ * - foreground: WCAG auto-contrast vs background, softened 8% toward it.
+ * - muted: foreground mixed 45% toward background.
+ * - primary: bunti-blue #3bbce1 (dark) / #0d7ea6 (light).
+ * - onPrimary: WCAG auto-contrast (pure black/white) vs primary.
+ * - accent: primary shifted 25% toward white (dark) / black (light).
+ * - border: foreground mixed 70% toward background.
+ * - focus: primary.
+ * - selection: primary mixed 70% toward background.
+ * - success/warning/danger/info: PALETTE-derived defaults per mode.
+ */
+export declare function createTheme(input?: ThemeInput): Theme;
+/**
+ * Normalizes a Theme | ThemeInput. Full Themes pass through. Sparse inputs
+ * overlay `base` when given (used by `ctx.themed`), otherwise they are
+ * completed by `createTheme` derivation (used by `ctx.setTheme`).
+ */
+export declare function resolveTheme(input: Theme | ThemeInput, base?: Theme): Theme;
+/**
+ * Built-in dark theme, derived from Bunti's PALETTE aesthetic
+ * (midnight / silver / bunti-blue / plasma).
+ */
+export declare const darkTheme: Theme;
+/**
+ * Built-in light theme: the PALETTE aesthetic re-balanced for light
+ * backgrounds (deepened primary/semantic colors for WCAG contrast).
+ */
+export declare const lightTheme: Theme;
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,KAAK,UAAU,EAShB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAEnC,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzC,kFAAkF;AAClF,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC;AAEzC;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,KAAK,MAAM,CAAC,GAAG;IAC7D,mCAAmC;IACnC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,mCAAmC;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,YAAY,sLAgBf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,IAAI,EAAE,SAAS,CAAC;IAChB,yCAAyC;IACzC,UAAU,EAAE,UAAU,CAAC;IACvB,0DAA0D;IAC1D,OAAO,EAAE,UAAU,CAAC;IACpB,qEAAqE;IACrE,aAAa,EAAE,UAAU,CAAC;IAC1B,+BAA+B;IAC/B,UAAU,EAAE,UAAU,CAAC;IACvB,oDAAoD;IACpD,KAAK,EAAE,UAAU,CAAC;IAClB,wDAAwD;IACxD,OAAO,EAAE,UAAU,CAAC;IACpB,+CAA+C;IAC/C,SAAS,EAAE,UAAU,CAAC;IACtB,uDAAuD;IACvD,MAAM,EAAE,UAAU,CAAC;IACnB,qCAAqC;IACrC,MAAM,EAAE,UAAU,CAAC;IACnB,yCAAyC;IACzC,KAAK,EAAE,UAAU,CAAC;IAClB,8CAA8C;IAC9C,SAAS,EAAE,UAAU,CAAC;IACtB,uBAAuB;IACvB,OAAO,EAAE,UAAU,CAAC;IACpB,yBAAyB;IACzB,OAAO,EAAE,UAAU,CAAC;IACpB,gCAAgC;IAChC,MAAM,EAAE,UAAU,CAAC;IACnB,oCAAoC;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;CAC9C;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,GAAG;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;CAC9C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CAW7D;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAOtD;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,WAAW,CAAC,KAAK,GAAE,UAAe,GAAG,KAAK,CAkEzD;AASD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,UAAU,EAAE,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,CAK3E;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,KAOtB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,KAOvB,CAAC"}

package/dist/theme.js

@@ -0,0 +1,167 @@
+/**
+ * Bunti Semantic Theme System
+ *
+ * Themes are sets of semantic color tokens (background, primary, danger, ...)
+ * rather than hardcoded colors. Every token is a ThemeColor: callable as an
+ * fg-styler (`theme.primary('text')` returns an ANSI-colored string) AND
+ * usable as plain color data anywhere a color is accepted (bgColor,
+ * borderColor, wallpaper, gradient stops) via its `.rgb` / `.hex` payload.
+ *
+ * `createTheme(partial)` fills missing tokens by derivation so sparse inputs
+ * (e.g. a converted VS Code theme with only a handful of colors) still
+ * produce a coherent theme.
+ */
+import { contrastText, fade, fg, isThemeColor, relativeLuminance, resolveColorToRGB, rgbToHex, THEME_COLOR, } from './colors';
+/** The semantic token names every Theme carries. */
+export const THEME_TOKENS = [
+    'background',
+    'surface',
+    'surfaceRaised',
+    'foreground',
+    'muted',
+    'primary',
+    'onPrimary',
+    'accent',
+    'border',
+    'focus',
+    'selection',
+    'success',
+    'warning',
+    'danger',
+    'info',
+];
+/**
+ * Creates a ThemeColor from any color value: a function that fg-styles text,
+ * branded and carrying `.rgb` + `.hex`. ThemeColor inputs pass through
+ * unchanged.
+ */
+export function themeColor(input) {
+    if (isThemeColor(input))
+        return input;
+    const rgb = Object.freeze(resolveColorToRGB(input));
+    const color = ((text) => fg(rgb, String(text)));
+    Object.defineProperties(color, {
+        rgb: { value: rgb, enumerable: true },
+        hex: { value: rgbToHex(rgb), enumerable: true },
+        [THEME_COLOR]: { value: true },
+    });
+    return color;
+}
+/**
+ * Returns true when the value is a complete Theme (all tokens are branded
+ * ThemeColors), as opposed to a sparse ThemeInput.
+ */
+export function isTheme(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const candidate = value;
+    return (typeof candidate.name === 'string' &&
+        THEME_TOKENS.every((token) => isThemeColor(candidate[token])));
+}
+const WHITE = { r: 255, g: 255, b: 255 };
+const BLACK = { r: 0, g: 0, b: 0 };
+/**
+ * Builds a complete Theme from a sparse spec. Missing tokens are derived:
+ *
+ * - mode: from background luminance when a background is given, else 'dark'.
+ * - background: #0f0f23 (dark) / #f4f5f9 (light).
+ * - surface / surfaceRaised: background shifted 8% / 16% toward white in
+ *   dark mode, toward black in light mode.
+ * - foreground: WCAG auto-contrast vs background, softened 8% toward it.
+ * - muted: foreground mixed 45% toward background.
+ * - primary: bunti-blue #3bbce1 (dark) / #0d7ea6 (light).
+ * - onPrimary: WCAG auto-contrast (pure black/white) vs primary.
+ * - accent: primary shifted 25% toward white (dark) / black (light).
+ * - border: foreground mixed 70% toward background.
+ * - focus: primary.
+ * - selection: primary mixed 70% toward background.
+ * - success/warning/danger/info: PALETTE-derived defaults per mode.
+ */
+export function createTheme(input = {}) {
+    const mode = input.mode ??
+        (input.background !== undefined
+            ? relativeLuminance(resolveColorToRGB(input.background)) > 0.5
+                ? 'light'
+                : 'dark'
+            : 'dark');
+    const dark = mode === 'dark';
+    const lift = dark ? WHITE : BLACK;
+    const shift = (base, amount) => fade(base, lift, amount);
+    const background = themeColor(input.background ??
+        (dark ? { r: 15, g: 15, b: 35 } : { r: 244, g: 245, b: 249 }));
+    const foreground = themeColor(input.foreground ??
+        fade(contrastText(background.rgb), background.rgb, 0.08));
+    const primary = themeColor(input.primary ??
+        (dark ? { r: 59, g: 188, b: 225 } : { r: 13, g: 126, b: 166 }));
+    const theme = {
+        name: input.name ?? `custom-${mode}`,
+        mode,
+        background,
+        surface: themeColor(input.surface ?? shift(background.rgb, 0.08)),
+        surfaceRaised: themeColor(input.surfaceRaised ?? shift(background.rgb, 0.16)),
+        foreground,
+        muted: themeColor(input.muted ?? fade(foreground.rgb, background.rgb, 0.45)),
+        primary,
+        onPrimary: themeColor(input.onPrimary ?? contrastText(primary.rgb)),
+        accent: themeColor(input.accent ?? shift(primary.rgb, 0.25)),
+        border: themeColor(input.border ?? fade(foreground.rgb, background.rgb, 0.7)),
+        focus: themeColor(input.focus ?? primary.rgb),
+        selection: themeColor(input.selection ?? fade(primary.rgb, background.rgb, 0.7)),
+        success: themeColor(input.success ??
+            (dark ? { r: 0, g: 215, b: 0 } : { r: 15, g: 157, b: 60 })),
+        warning: themeColor(input.warning ??
+            (dark ? { r: 255, g: 175, b: 0 } : { r: 178, g: 107, b: 0 })),
+        danger: themeColor(input.danger ??
+            (dark ? { r: 215, g: 0, b: 0 } : { r: 198, g: 40, b: 40 })),
+        info: themeColor(input.info ??
+            (dark ? { r: 0, g: 175, b: 255 } : { r: 11, g: 120, b: 194 })),
+    };
+    if (input.gradients)
+        theme.gradients = input.gradients;
+    return theme;
+}
+function themeToInput(theme) {
+    const input = { name: theme.name, mode: theme.mode };
+    for (const token of THEME_TOKENS)
+        input[token] = theme[token];
+    if (theme.gradients)
+        input.gradients = theme.gradients;
+    return input;
+}
+/**
+ * Normalizes a Theme | ThemeInput. Full Themes pass through. Sparse inputs
+ * overlay `base` when given (used by `ctx.themed`), otherwise they are
+ * completed by `createTheme` derivation (used by `ctx.setTheme`).
+ */
+export function resolveTheme(input, base) {
+    if (isTheme(input))
+        return input;
+    return base
+        ? createTheme({ ...themeToInput(base), ...input })
+        : createTheme(input);
+}
+/**
+ * Built-in dark theme, derived from Bunti's PALETTE aesthetic
+ * (midnight / silver / bunti-blue / plasma).
+ */
+export const darkTheme = createTheme({
+    name: 'bunti-dark',
+    mode: 'dark',
+    background: 'midnight',
+    foreground: 'silver',
+    primary: 'bunti-blue',
+    accent: 'plasma',
+});
+/**
+ * Built-in light theme: the PALETTE aesthetic re-balanced for light
+ * backgrounds (deepened primary/semantic colors for WCAG contrast).
+ */
+export const lightTheme = createTheme({
+    name: 'bunti-light',
+    mode: 'light',
+    background: '#f4f5f9',
+    foreground: '#23283b',
+    primary: '#0d7ea6',
+    accent: '#8a2bd8',
+});
+//# sourceMappingURL=theme.js.map