@zakmandhro/bunti 0.1.4 → 0.2.0

package/dist/demos/showcase.ts

@@ -0,0 +1,224 @@
+import { Box } from '../components/index.js';
+import {
+  ICON_MAP,
+  joinHorizontal,
+  box as renderBox,
+  splitRect,
+  truncate,
+} from '../index.js';
+import { demo } from './demo-layout';
+
+const PALETTE = [
+  'bunti-blue',
+  'sky',
+  'plasma',
+  'rose',
+  'gold',
+  'mint',
+  'success',
+  'warning',
+  'error',
+];
+
+const BORDERS = ['default', 'rounded', 'double', 'dashed', 'frame'] as const;
+
+demo('SHOWCASE', (ctx, bounds) => {
+  const { color, gradient, icon } = ctx;
+  const width = Math.min(bounds.w - 4, 104);
+  const shell = bounds.place({
+    y: 0,
+    width,
+    height: Math.min(bounds.h, 27),
+  });
+  const [left, right] = splitRect(shell, {
+    direction: 'horizontal',
+    constraints: ['44%', '1fr'],
+    gap: 2,
+  });
+  const [palette, layout] = splitRect(left!, {
+    direction: 'vertical',
+    constraints: [11, '1fr'],
+    gap: 1,
+  });
+  const [frames, textLab, iconLab] = splitRect(right!, {
+    direction: 'vertical',
+    constraints: [8, 9, '1fr'],
+    gap: 1,
+  });
+
+  Box(
+    ctx,
+    {
+      x: palette?.x,
+      y: palette?.y,
+      width: palette?.width,
+      height: palette?.height,
+      border: 'rounded',
+      borderColor: 'bunti-blue',
+      padding: [1, 2],
+    },
+    ({ text }) => {
+      text(color.fg('bunti-blue', color.bold('COLOR SYSTEM\n')));
+      for (const [index, name] of PALETTE.entries()) {
+        if (index > 0 && index % 3 === 0) text('\n');
+        text(color.dim(name.padEnd(12)));
+        text(color.fg(name, '████'));
+        text('  ');
+      }
+    },
+  );
+
+  Box(
+    ctx,
+    {
+      x: layout?.x,
+      y: layout?.y,
+      width: layout?.width,
+      height: layout?.height,
+      border: 'rounded',
+      borderColor: 'mint',
+      padding: [1, 2],
+    },
+    ({ text }) => {
+      text(color.fg('mint', color.bold('RECT LAYOUT\n\n')));
+      text(color.dim('splitRect: fixed + percent + fill tracks\n\n'));
+
+      const tracks = splitRect(
+        { x: 0, y: 0, width: Math.max(1, (layout?.width ?? 8) - 6), height: 3 },
+        {
+          direction: 'horizontal',
+          constraints: [8, '35%', '1fr'],
+          gap: 1,
+        },
+      );
+
+      const blocks = tracks.map((track, index) =>
+        renderBox(
+          color.fg(
+            'white',
+            index === 0 ? '8 cols' : index === 1 ? '35%' : 'fill',
+          ),
+          {
+            width: track.width,
+            height: track.height,
+            border: 'none',
+            bgColor: index === 0 ? 'ocean' : index === 1 ? 'nebula' : 'plasma',
+            align: 'center',
+            valign: 'middle',
+          },
+        ),
+      );
+      text(joinHorizontal(...blocks));
+      text('\n\n');
+      text(color.dim('Content stays inside the assigned Rect.'));
+    },
+  );
+
+  Box(
+    ctx,
+    {
+      x: frames?.x,
+      y: frames?.y,
+      width: frames?.width,
+      height: frames?.height,
+      border: 'rounded',
+      borderColor: 'plasma',
+      padding: [1, 2],
+    },
+    ({ text }) => {
+      text(color.fg('plasma', color.bold('BORDERS + DEPTH\n\n')));
+      const cells = splitRect(
+        { x: 0, y: 3, width: Math.max(1, (frames?.width ?? 8) - 6), height: 3 },
+        {
+          direction: 'horizontal',
+          constraints: BORDERS.map(() => '1fr'),
+          gap: 1,
+        },
+      );
+
+      const blocks = BORDERS.map((border, index) => {
+        const cell = cells[index]!;
+        return renderBox(
+          color.fg('silver', truncate(border, Math.max(1, cell.width - 2))),
+          {
+            width: cell.width,
+            height: cell.height,
+            border,
+            borderColor: index % 2 === 0 ? 'silver' : 'gold',
+            align: 'center',
+            valign: 'middle',
+          },
+        );
+      });
+      text(joinHorizontal(...blocks));
+    },
+  );
+
+  Box(
+    ctx,
+    {
+      x: textLab?.x,
+      y: textLab?.y,
+      width: textLab?.width,
+      height: textLab?.height,
+      border: 'rounded',
+      borderColor: 'gold',
+      padding: [1, 2],
+    },
+    ({ text, box }) => {
+      text(color.fg('gold', color.bold('TEXT + GRADIENTS\n\n')));
+      const bar = gradient({
+        colors: ['sky', 'plasma', 'rose', 'gold', 'mint'],
+        direction: 'horizontal',
+        steps: Math.max(1, (textLab?.width ?? 8) - 6),
+      });
+      box(
+        {
+          width: '100%',
+          height: 1,
+          border: 'none',
+          bgColor: bar,
+        },
+        () => {},
+      );
+      text('\n');
+      text(
+        color.fg(
+          'silver',
+          'Wrapped text respects ANSI colors and terminal width without escape damage.',
+        ),
+      );
+    },
+  );
+
+  Box(
+    ctx,
+    {
+      x: iconLab?.x,
+      y: iconLab?.y,
+      width: iconLab?.width,
+      height: iconLab?.height,
+      border: 'rounded',
+      borderColor: 'silver',
+      padding: [1, 2],
+    },
+    ({ text, table }) => {
+      text(color.fg('silver', color.bold('ICONS + TABLES\n\n')));
+      const rows = Object.keys(ICON_MAP)
+        .slice(0, 12)
+        .reduce<string[][]>((acc, name, index) => {
+          const row = Math.floor(index / 3);
+          acc[row] ??= [];
+          acc[row]!.push(`${icon(name)} ${color.dim(name)}`);
+          return acc;
+        }, []);
+
+      table(rows, {
+        width: Math.max(1, (iconLab?.width ?? 8) - 6),
+        border: 'none',
+        padding: [0, 1],
+        columns: [{ align: 'left' }, { align: 'left' }, { align: 'left' }],
+      });
+    },
+  );
+});

package/dist/detect.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Bunti Terminal Capability Detection
+ *
+ * Env-first and synchronous: `identifyTerminal()` is a pure function from an
+ * environment map to a `TerminalProfile` (app, version, multiplexer,
+ * truecolor, sync-output support, Nerd Font policy). No escape-sequence
+ * probes are sent; async handshakes are deliberately deferred.
+ */
+/** Legacy capability shape (kept for back-compat; see TerminalProfile). */
+export interface TerminalCapabilities {
+    nerdFont: boolean;
+    glyphProtocol: boolean;
+    unicode: boolean;
+    color: boolean;
+}
+/** Terminal emulators Bunti identifies from environment variables. */
+export type TerminalApp = 'ghostty' | 'kitty' | 'wezterm' | 'iterm2' | 'alacritty' | 'vscode' | 'apple-terminal' | 'warp' | 'unknown';
+/**
+ * Nerd Font availability policy:
+ * - 'yes': the terminal embeds Nerd Font symbols (Ghostty >= 1.2).
+ * - 'assumed-yes': power-user terminals whose users overwhelmingly install
+ *   patched fonts (kitty, WezTerm, iTerm2, Warp, Alacritty).
+ * - 'assumed-no': stock fonts, no embedded symbols (VS Code, Apple Terminal,
+ *   unknown terminals) — Bunti falls back to the ASCII icon tier.
+ * - 'no': explicitly disabled via BUNTI_NF/NERD_FONTS.
+ */
+export type NerdFontPolicy = 'yes' | 'no' | 'assumed-yes' | 'assumed-no';
+/**
+ * Everything Bunti knows about the hosting terminal, derived purely from
+ * environment variables. Exposed as `ctx.terminal` (detected once per
+ * render()).
+ */
+export interface TerminalProfile {
+    /** Identified terminal emulator ('unknown' when no signal matches). */
+    app: TerminalApp;
+    /** TERM_PROGRAM_VERSION / LC_TERMINAL_VERSION when available. */
+    version?: string;
+    /** Terminal multiplexer sitting between Bunti and the emulator. */
+    multiplexer?: 'tmux' | 'screen';
+    /** 24-bit color support (mirrors detectColorTier() === 'truecolor'). */
+    truecolor: boolean;
+    /** Known support for synchronized output (DEC private mode 2026). */
+    syncOutput: boolean;
+    /** Nerd Font glyph policy for the icon engine. */
+    nerdFont: NerdFontPolicy;
+    /** 'override' when BUNTI_NF/NERD_FONTS forced the nerdFont field. */
+    source: 'override' | 'env';
+}
+type Env = Record<string, string | undefined>;
+/**
+ * Color capability tiers, from full 24-bit RGB down to no color at all.
+ * `resolveColor()` quantizes RGB values to the active tier automatically.
+ */
+export type ColorTier = 'truecolor' | '256' | '16' | 'mono';
+/**
+ * Pure env-to-profile detection (defaults to process.env). Never mutates the
+ * environment and sends no escape sequences, so it is safe to call anywhere.
+ *
+ * Detection order:
+ * 1. BUNTI_NF/NERD_FONTS/NERD_FONT force the nerdFont field on or off
+ *    (source: 'override'); app identification still runs.
+ * 2. TMUX/screen are recorded as `multiplexer`; app identification then
+ *    relies on variables that pass through the multiplexer.
+ * 3. App signals, in order: Ghostty (GHOSTTY_RESOURCES_DIR, lowercase
+ *    TERM_PROGRAM=ghostty, TERM=xterm-ghostty), kitty (KITTY_WINDOW_ID,
+ *    TERM=xterm-kitty), WezTerm (WEZTERM_PANE, TERM_PROGRAM), iTerm2
+ *    (TERM_PROGRAM=iTerm.app, LC_TERMINAL=iTerm2), Alacritty
+ *    (ALACRITTY_WINDOW_ID, TERM=alacritty), VS Code, Apple Terminal, Warp.
+ */
+export declare function identifyTerminal(env?: Env): TerminalProfile;
+/**
+ * Pure tier detection from an environment map (defaults to process.env).
+ *
+ * Rules, in order:
+ * 1. NO_COLOR set to a non-empty value -> 'mono' (https://no-color.org spec).
+ * 2. TERM=dumb -> 'mono'.
+ * 3. COLORTERM=truecolor|24bit -> 'truecolor'.
+ * 4. An identified truecolor-capable app (ghostty, kitty, wezterm, iterm2,
+ *    alacritty, vscode, warp) -> 'truecolor'. This also catches TERM values
+ *    like xterm-kitty that the legacy TERM families would misclassify.
+ * 5. Known truecolor TERM_PROGRAM, or a truecolor/direct TERM -> 'truecolor'.
+ * 6. TERM containing "256color" -> '256'.
+ * 7. Legacy TERM families (xterm, screen, vt100, linux, ...) -> '16'.
+ * 8. Otherwise -> 'truecolor' (optimistic: modern terminals rarely set hints).
+ */
+export declare function detectColorTier(env?: Env): ColorTier;
+/**
+ * Returns the active color tier. Detection runs lazily on first call and is
+ * cached; `setColorTier()` overrides it (used by ScreenOptions.colorTier and
+ * tests).
+ */
+export declare function colorTier(): ColorTier;
+/**
+ * Forces a color tier (pass undefined to clear the override and re-detect
+ * lazily on the next `colorTier()` call).
+ */
+export declare function setColorTier(tier?: ColorTier): void;
+/**
+ * Back-compat wrapper over `identifyTerminal()` returning the legacy
+ * TerminalCapabilities shape. Prefer `identifyTerminal()` / `ctx.terminal`.
+ */
+export declare function detectCapabilities(env?: Env): Promise<TerminalCapabilities>;
+export {};
+//# sourceMappingURL=detect.d.ts.map

package/dist/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,2EAA2E;AAC3E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,sEAAsE;AACtE,MAAM,MAAM,WAAW,GACnB,SAAS,GACT,OAAO,GACP,SAAS,GACT,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,gBAAgB,GAChB,MAAM,GACN,SAAS,CAAC;AAEd;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,IAAI,GAAG,aAAa,GAAG,YAAY,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,GAAG,EAAE,WAAW,CAAC;IACjB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAChC,wEAAwE;IACxE,SAAS,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,UAAU,EAAE,OAAO,CAAC;IACpB,kDAAkD;IAClD,QAAQ,EAAE,cAAc,CAAC;IACzB,qEAAqE;IACrE,MAAM,EAAE,UAAU,GAAG,KAAK,CAAC;CAC5B;AAED,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAE9C;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;AAwH5D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,GAAE,GAAwB,GAC5B,eAAe,CAcjB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,GAAwB,GAAG,SAAS,CAwBxE;AAKD;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,SAAS,CAIrC;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,CAAC,EAAE,SAAS,QAG5C;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,GAAE,GAAwB,GAC5B,OAAO,CAAC,oBAAoB,CAAC,CAQ/B"}

package/dist/detect.js

@@ -0,0 +1,227 @@
+/**
+ * Bunti Terminal Capability Detection
+ *
+ * Env-first and synchronous: `identifyTerminal()` is a pure function from an
+ * environment map to a `TerminalProfile` (app, version, multiplexer,
+ * truecolor, sync-output support, Nerd Font policy). No escape-sequence
+ * probes are sent; async handshakes are deliberately deferred.
+ */
+/**
+ * TERM_PROGRAM values known to render 24-bit color but NOT part of the
+ * TerminalApp union (those are covered by app identification).
+ */
+const EXTRA_TRUECOLOR_PROGRAMS = ['Hyper', 'Rio', 'Term7'];
+/** Apps with known 24-bit color support (all identified apps but Apple Terminal). */
+const TRUECOLOR_APPS = [
+    'ghostty',
+    'kitty',
+    'wezterm',
+    'iterm2',
+    'alacritty',
+    'vscode',
+    'warp',
+];
+/** Apps with known synchronized-output (mode 2026) support. */
+const SYNC_OUTPUT_APPS = [
+    'ghostty',
+    'kitty',
+    'wezterm',
+    'iterm2',
+    'alacritty',
+    'warp',
+];
+/** Nerd Font policy per identified app (see NerdFontPolicy). */
+const NERD_FONT_POLICY = {
+    ghostty: 'yes', // embeds Symbols Nerd Font since 1.2
+    kitty: 'assumed-yes',
+    wezterm: 'assumed-yes',
+    iterm2: 'assumed-yes',
+    warp: 'assumed-yes',
+    alacritty: 'assumed-yes',
+    vscode: 'assumed-no',
+    'apple-terminal': 'assumed-no',
+    unknown: 'assumed-no',
+};
+/** The TERM_PROGRAM value each app announces (when it sets one at all). */
+const TERM_PROGRAM_BY_APP = {
+    ghostty: 'ghostty', // lowercase — Ghostty never capitalizes it
+    wezterm: 'WezTerm',
+    iterm2: 'iTerm.app',
+    vscode: 'vscode',
+    'apple-terminal': 'Apple_Terminal',
+    warp: 'WarpTerminal',
+};
+/**
+ * Identifies the terminal app, version, and multiplexer from env vars.
+ * App-specific variables (GHOSTTY_RESOURCES_DIR, KITTY_WINDOW_ID, ...) are
+ * checked alongside TERM_PROGRAM because they survive tmux/screen, whose
+ * inner TERM rewrites would otherwise mask the outer emulator.
+ */
+function detectApp(env) {
+    const term = env.TERM || '';
+    const termProgram = env.TERM_PROGRAM || '';
+    const multiplexer = env.TMUX
+        ? 'tmux'
+        : term.startsWith('tmux')
+            ? 'tmux'
+            : env.STY || term.startsWith('screen')
+                ? 'screen'
+                : undefined;
+    let app = 'unknown';
+    if (env.GHOSTTY_RESOURCES_DIR ||
+        termProgram === 'ghostty' ||
+        term === 'xterm-ghostty') {
+        app = 'ghostty';
+    }
+    else if (env.KITTY_WINDOW_ID || term === 'xterm-kitty') {
+        app = 'kitty';
+    }
+    else if (env.WEZTERM_PANE || termProgram === 'WezTerm') {
+        app = 'wezterm';
+    }
+    else if (termProgram === 'iTerm.app' || env.LC_TERMINAL === 'iTerm2') {
+        app = 'iterm2';
+    }
+    else if (env.ALACRITTY_WINDOW_ID || term === 'alacritty') {
+        app = 'alacritty';
+    }
+    else if (termProgram === 'vscode') {
+        app = 'vscode';
+    }
+    else if (termProgram === 'Apple_Terminal') {
+        app = 'apple-terminal';
+    }
+    else if (termProgram === 'WarpTerminal') {
+        app = 'warp';
+    }
+    let version;
+    if (termProgram !== '' && termProgram === TERM_PROGRAM_BY_APP[app]) {
+        version = env.TERM_PROGRAM_VERSION || undefined;
+    }
+    else if (app === 'iterm2' && env.LC_TERMINAL === 'iTerm2') {
+        version = env.LC_TERMINAL_VERSION || undefined;
+    }
+    return { app, version, multiplexer };
+}
+/**
+ * Parses the BUNTI_NF / NERD_FONTS / NERD_FONT override variables.
+ * Returns 'yes'/'no' when forced, undefined when unset or unrecognized.
+ */
+function nerdFontOverride(env) {
+    const value = env.NERD_FONTS || env.NERD_FONT || env.BUNTI_NF;
+    if (value === '1' || value === 'true' || value === 'yes')
+        return 'yes';
+    if (value === '0' || value === 'false' || value === 'no')
+        return 'no';
+    return undefined;
+}
+/**
+ * Pure env-to-profile detection (defaults to process.env). Never mutates the
+ * environment and sends no escape sequences, so it is safe to call anywhere.
+ *
+ * Detection order:
+ * 1. BUNTI_NF/NERD_FONTS/NERD_FONT force the nerdFont field on or off
+ *    (source: 'override'); app identification still runs.
+ * 2. TMUX/screen are recorded as `multiplexer`; app identification then
+ *    relies on variables that pass through the multiplexer.
+ * 3. App signals, in order: Ghostty (GHOSTTY_RESOURCES_DIR, lowercase
+ *    TERM_PROGRAM=ghostty, TERM=xterm-ghostty), kitty (KITTY_WINDOW_ID,
+ *    TERM=xterm-kitty), WezTerm (WEZTERM_PANE, TERM_PROGRAM), iTerm2
+ *    (TERM_PROGRAM=iTerm.app, LC_TERMINAL=iTerm2), Alacritty
+ *    (ALACRITTY_WINDOW_ID, TERM=alacritty), VS Code, Apple Terminal, Warp.
+ */
+export function identifyTerminal(env = process.env) {
+    const { app, version, multiplexer } = detectApp(env);
+    const override = nerdFontOverride(env);
+    const profile = {
+        app,
+        truecolor: detectColorTier(env) === 'truecolor',
+        syncOutput: SYNC_OUTPUT_APPS.includes(app),
+        nerdFont: override ?? NERD_FONT_POLICY[app],
+        source: override !== undefined ? 'override' : 'env',
+    };
+    if (version !== undefined)
+        profile.version = version;
+    if (multiplexer !== undefined)
+        profile.multiplexer = multiplexer;
+    return profile;
+}
+/**
+ * Pure tier detection from an environment map (defaults to process.env).
+ *
+ * Rules, in order:
+ * 1. NO_COLOR set to a non-empty value -> 'mono' (https://no-color.org spec).
+ * 2. TERM=dumb -> 'mono'.
+ * 3. COLORTERM=truecolor|24bit -> 'truecolor'.
+ * 4. An identified truecolor-capable app (ghostty, kitty, wezterm, iterm2,
+ *    alacritty, vscode, warp) -> 'truecolor'. This also catches TERM values
+ *    like xterm-kitty that the legacy TERM families would misclassify.
+ * 5. Known truecolor TERM_PROGRAM, or a truecolor/direct TERM -> 'truecolor'.
+ * 6. TERM containing "256color" -> '256'.
+ * 7. Legacy TERM families (xterm, screen, vt100, linux, ...) -> '16'.
+ * 8. Otherwise -> 'truecolor' (optimistic: modern terminals rarely set hints).
+ */
+export function detectColorTier(env = process.env) {
+    if (env.NO_COLOR !== undefined && env.NO_COLOR !== '')
+        return 'mono';
+    const term = env.TERM || '';
+    if (term === 'dumb')
+        return 'mono';
+    const colorterm = (env.COLORTERM || '').toLowerCase();
+    if (colorterm === 'truecolor' || colorterm === '24bit')
+        return 'truecolor';
+    const { app } = detectApp(env);
+    if (TRUECOLOR_APPS.includes(app))
+        return 'truecolor';
+    if (EXTRA_TRUECOLOR_PROGRAMS.includes(env.TERM_PROGRAM || '')) {
+        return 'truecolor';
+    }
+    if (term.includes('truecolor') ||
+        term.includes('24bit') ||
+        term.includes('direct')) {
+        return 'truecolor';
+    }
+    if (term.includes('256color'))
+        return '256';
+    if (/^(xterm|screen|tmux|vt(1|2)\d\d|rxvt|linux|ansi|cygwin)/.test(term)) {
+        return '16';
+    }
+    return 'truecolor';
+}
+let tierOverride;
+let detectedTier;
+/**
+ * Returns the active color tier. Detection runs lazily on first call and is
+ * cached; `setColorTier()` overrides it (used by ScreenOptions.colorTier and
+ * tests).
+ */
+export function colorTier() {
+    if (tierOverride !== undefined)
+        return tierOverride;
+    if (detectedTier === undefined)
+        detectedTier = detectColorTier();
+    return detectedTier;
+}
+/**
+ * Forces a color tier (pass undefined to clear the override and re-detect
+ * lazily on the next `colorTier()` call).
+ */
+export function setColorTier(tier) {
+    tierOverride = tier;
+    if (tier === undefined)
+        detectedTier = undefined;
+}
+/**
+ * Back-compat wrapper over `identifyTerminal()` returning the legacy
+ * TerminalCapabilities shape. Prefer `identifyTerminal()` / `ctx.terminal`.
+ */
+export async function detectCapabilities(env = process.env) {
+    const profile = identifyTerminal(env);
+    return {
+        nerdFont: profile.nerdFont === 'yes' || profile.nerdFont === 'assumed-yes',
+        glyphProtocol: profile.app === 'ghostty',
+        unicode: true,
+        color: detectColorTier(env) !== 'mono',
+    };
+}
+//# sourceMappingURL=detect.js.map

package/dist/detect.js.map

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

package/dist/diagnostics.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Bunti Dev Diagnostics
+ *
+ * Non-fatal "you probably meant" hints that teach the API while you build.
+ * Hints are buffered (deduplicated) and flushed ONCE to stderr when the
+ * process exits — never mid-frame, so a warning can never tear an active
+ * render. All hints are suppressed when NODE_ENV=production or
+ * BUNTI_NO_HINTS=1.
+ *
+ * The icon engine's unknown-name warnings flow through the same buffer via
+ * registerHintFlusher(), so a session produces at most one hint block.
+ */
+import type { Rect } from './geometry';
+import type { ScreenOptions } from './state';
+/** Lazily produces extra hint lines at flush time (used by the icon engine). */
+type HintFlusher = () => string[];
+/** True when dev hints are disabled (NODE_ENV=production or BUNTI_NO_HINTS=1). */
+export declare function hintsSuppressed(): boolean;
+/**
+ * Buffers a one-line dev hint (deduplicated by message). Never writes to
+ * the terminal directly — everything drains on process exit.
+ */
+export declare function recordHint(message: string): void;
+/**
+ * Registers a lazy hint-line producer drained at flush time. Lets modules
+ * with their own buffers (icons) share the single exit flush.
+ */
+export declare function registerHintFlusher(flusher: HintFlusher): void;
+/** Renders and clears every buffered hint; '' when there are none. */
+export declare function drainHints(): string;
+/** Exit-hook target: writes all buffered hints to stderr, once. */
+export declare function flushHints(): void;
+/** Capped two-row Levenshtein; returns cap+1 as soon as it can bail out. */
+export declare function editDistance(a: string, b: string, cap: number): number;
+/**
+ * Best "did you mean" candidate for a name: exact match wins, then
+ * prefix relationships, then capped edit distance (cap scales with
+ * length). Returns undefined when nothing is close enough.
+ */
+export declare function nearestMatch(target: string, candidates: Iterable<string>): string | undefined;
+/**
+ * Called on reads of ctx.lastKey / ctx.keys / keyPressed / isKeyHeld:
+ * hints once when neither keyboard nor mouse input was enabled, so the
+ * app can never receive what it is polling for.
+ */
+export declare function hintInputReadWithoutKeyboard(options: ScreenOptions): void;
+/**
+ * Called by the render loop: keyboard input only works on a real TTY —
+ * piped stdin (CI, `echo | bun app.ts`, agent harnesses) is ignored.
+ */
+export declare function hintKeyboardStdinNotTTY(keyboardRequested: boolean, stdinIsTTY: boolean): void;
+/**
+ * Marks a frame boundary for keyless-hook tracking: compares the two most
+ * recent completed frames and hints once when the positional hook count
+ * shrank or a slot changed type (useState <-> useAsync) — the signature of
+ * conditionally-called keyless hooks returning another call's state.
+ */
+export declare function beginHookFrame(state: object): void;
+/** Records one keyless hook call (positional index + hook kind). */
+export declare function recordKeylessHook(state: object, index: number, kind: 'useState' | 'useAsync'): void;
+/**
+ * Cheap per-frame heuristic run by flushFlow: top-level boxes paint
+ * directly to the screen buffer, so two intersecting rects mean one box
+ * painted over another with nothing controlling the stacking. Hints once,
+ * then stops checking. O(n²) over at most 50 rects per frame.
+ */
+export declare function hintOverlappingBoxes(rects: Rect[] | undefined): void;
+/** @internal Test hook: currently buffered hint messages. */
+export declare function __bufferedHints(): string[];
+/** @internal Test hook: clears buffered hints and one-shot latches. */
+export declare function __resetHints(): void;
+export {};
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,gFAAgF;AAChF,KAAK,WAAW,GAAG,MAAM,MAAM,EAAE,CAAC;AAMlC,kFAAkF;AAClF,wBAAgB,eAAe,IAAI,OAAO,CAIzC;AASD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAIhD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAG9D;AAED,sEAAsE;AACtE,wBAAgB,UAAU,IAAI,MAAM,CAOnC;AAED,mEAAmE;AACnE,wBAAgB,UAAU,IAAI,IAAI,CAIjC;AAID,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAiBtE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,GAC3B,MAAM,GAAG,SAAS,CAqBpB;AAID;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAKzE;AAID;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,iBAAiB,EAAE,OAAO,EAC1B,UAAU,EAAE,OAAO,GAClB,IAAI,CAMN;AAgBD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAsBlD;AAED,oEAAoE;AACpE,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,UAAU,GAAG,UAAU,GAC5B,IAAI,CAKN;AAQD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,SAAS,GAAG,IAAI,CAwBpE;AAID,6DAA6D;AAC7D,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED,uEAAuE;AACvE,wBAAgB,YAAY,IAAI,IAAI,CAGnC"}