@zakmandhro/bunti 0.1.4 → 0.2.0

package/src/colors.ts

@@ -1,255 +0,0 @@
-/**
- * Bunti Semantic & Palette Color System
- */
-
-import type { RGB } from './state';
-
-export interface Gradient {
-  colors: RGB[];
-  direction: 'vertical' | 'horizontal';
-  steps: number;
-}
-
-export const PALETTE = {
-  // Greyscale
-  slate: '235',
-  ash: '240',
-  gray: '244',
-  silver: '247',
-  white: '255',
-  black: '0',
-
-  // Deep Blues & Space
-  midnight: '17',
-  ocean: '24',
-  sky: '33',
-  'bunti-blue': '38',
-  'deep-navy': '17',
-  nebula: '61',
-  plasma: '165',
-
-  // Semantic
-  success: '40',
-  warning: '214',
-  error: '196',
-  info: '39',
-
-  // Accents
-  gold: '220',
-  rose: '211',
-  mint: '121',
-} as const;
-
-const RGB_REGISTRY: Record<string, RGB> = {
-  black: { r: 0, g: 0, b: 0 },
-  red: { r: 200, g: 50, b: 50 },
-  green: { r: 50, g: 200, b: 50 },
-  yellow: { r: 200, g: 200, b: 50 },
-  blue: { r: 50, g: 50, b: 200 },
-  magenta: { r: 200, g: 50, b: 200 },
-  cyan: { r: 50, g: 200, b: 200 },
-  white: { r: 255, g: 255, b: 255 },
-  gray: { r: 128, g: 128, b: 128 },
-  // Greyscale
-  slate: { r: 40, g: 44, b: 52 },
-  ash: { r: 75, g: 82, b: 99 },
-  silver: { r: 188, g: 192, b: 204 },
-  // Deep Blues & Space
-  midnight: { r: 15, g: 15, b: 35 },
-  ocean: { r: 20, g: 40, b: 80 },
-  sky: { r: 0, g: 135, b: 255 },
-  'bunti-blue': { r: 59, g: 188, b: 225 },
-  'deep-navy': { r: 0, g: 51, b: 102 },
-  nebula: { r: 95, g: 95, b: 175 },
-  plasma: { r: 201, g: 0, b: 255 },
-  // Semantic
-  success: { r: 0, g: 215, b: 0 },
-  warning: { r: 255, g: 175, b: 0 },
-  error: { r: 215, g: 0, b: 0 },
-  info: { r: 0, g: 175, b: 255 },
-  // Accents
-  gold: { r: 255, g: 215, b: 0 },
-  rose: { r: 255, g: 175, b: 175 },
-  mint: { r: 175, g: 255, b: 175 },
-};
-
-// Map standard names to ANSI-256 for basic compat
-const NAME_TO_ANSI: Record<string, string> = {
-  red: '160',
-  green: '40',
-  yellow: '220',
-  blue: '33',
-  magenta: '165',
-  cyan: '39',
-  white: '255',
-  black: '0',
-  gray: '244',
-};
-
-export type PaletteColor = keyof typeof PALETTE;
-
-/**
- * Parses a hex color string (#RRGGBB or #RGB) to an RGB object.
- */
-export function hexToRGB(hex: string): RGB {
-  const h = hex.replace('#', '');
-  if (h.length === 3) {
-    return {
-      r: parseInt(h[0]! + h[0]!, 16),
-      g: parseInt(h[1]! + h[1]!, 16),
-      b: parseInt(h[2]! + h[2]!, 16),
-    };
-  }
-  return {
-    r: parseInt(h.substring(0, 2), 16),
-    g: parseInt(h.substring(2, 4), 16),
-    b: parseInt(h.substring(4, 6), 16),
-  };
-}
-
-/**
- * Resolves a palette name, color code, or RGB object to a string for ANSI.
- */
-export function resolveColor(
-  color: PaletteColor | string | number | RGB,
-): string | number {
-  if (typeof color === 'object' && 'r' in color) {
-    return `2;${color.r};${color.g};${color.b}`;
-  }
-  if (typeof color === 'string') {
-    if (color.startsWith('#')) {
-      const rgb = hexToRGB(color);
-      return `2;${rgb.r};${rgb.g};${rgb.b}`;
-    }
-    return (PALETTE as any)[color] || NAME_TO_ANSI[color] || color;
-  }
-  return color;
-}
-
-/**
- * Creates a multi-stop gradient (array of RGB objects) between multiple colors.
- */
-export function createGradient(
-  arg1: (string | number | RGB)[] | string | number | RGB,
-  arg2?: string | number | RGB | number,
-  arg3?: number,
-): RGB[] {
-  let colors: (string | number | RGB)[] = [];
-  let steps = 5;
-
-  if (Array.isArray(arg1)) {
-    colors = arg1;
-    steps = typeof arg2 === 'number' ? arg2 : 5;
-  } else if (arg1 && arg2) {
-    colors = [arg1, arg2 as any];
-    steps = typeof arg3 === 'number' ? arg3 : 5;
-  }
-
-  if (colors.length === 0) return [];
-  if (colors.length === 1)
-    return Array(steps).fill(resolveColorToRGB(colors[0]));
-  if (steps <= 1) return [resolveColorToRGB(colors[0])];
-
-  const result: RGB[] = [];
-  const rgbColors = colors.map(resolveColorToRGB);
-
-  for (let i = 0; i < steps; i++) {
-    const globalT = i / (steps - 1);
-    const segmentCount = rgbColors.length - 1;
-    const segmentIdx = Math.min(
-      Math.floor(globalT * segmentCount),
-      segmentCount - 1,
-    );
-
-    const start = rgbColors[segmentIdx];
-    const end = rgbColors[segmentIdx + 1];
-    const t = globalT * segmentCount - segmentIdx;
-
-    result.push({
-      r: Math.round(start!.r + (end!.r - start!.r) * t),
-      g: Math.round(start!.g + (end!.g - start!.g) * t),
-      b: Math.round(start!.b + (end!.b - start!.b) * t),
-    });
-  }
-
-  return result;
-}
-
-/**
- * Helper to resolve any color type to an RGB object.
- */
-function resolveColorToRGB(color: any): RGB {
-  if (typeof color === 'object' && 'r' in color) return color;
-  if (typeof color === 'string' && color.startsWith('#'))
-    return hexToRGB(color);
-
-  // 1. Check registry
-  if (typeof color === 'string' && RGB_REGISTRY[color])
-    return RGB_REGISTRY[color];
-
-  // 2. Check Palette
-  const paletteValue = (PALETTE as any)[color];
-  if (paletteValue) {
-    // If palette value is a name, look it up in registry
-    const registered = RGB_REGISTRY[color];
-    if (registered) return registered;
-  }
-
-  // Fallback
-  return { r: 128, g: 128, b: 128 };
-}
-
-/**
- * Adjusts the brightness of a color.
- */
-export function adjustBrightness(color: any, amount: number): RGB {
-  const rgb = resolveColorToRGB(color);
-  const factor = 1 + amount / 100;
-  return {
-    r: Math.max(0, Math.min(255, Math.round(rgb.r * factor))),
-    g: Math.max(0, Math.min(255, Math.round(rgb.g * factor))),
-    b: Math.max(0, Math.min(255, Math.round(rgb.b * factor))),
-  };
-}
-
-/**
- * Returns a function that darkens a color and can be used as a style wrapper.
- */
-export function darken(color: any, amount: number = 20) {
-  const adjusted = adjustBrightness(color, -amount);
-  return (text: string) => fg(adjusted, text);
-}
-
-/**
- * Returns a function that lightens a color and can be used as a style wrapper.
- */
-export function lighten(color: any, amount: number = 20) {
-  const adjusted = adjustBrightness(color, amount);
-  return (text: string) => fg(adjusted, text);
-}
-
-/**
- * Returns an RGB object for TrueColor rendering.
- */
-export function rgb(r: number, g: number, b: number) {
-  return { r, g, b };
-}
-
-/**
- * Returns an ANSI escape sequence for a color.
- */
-export function fg(color: any, text: string): string {
-  const code = resolveColor(color);
-  const codeStr = String(code);
-  const prefix =
-    typeof color === 'object' || codeStr.startsWith('2;') ? '38' : '38;5';
-  return `\x1b[${prefix};${codeStr}m${text}\x1b[0m`;
-}
-
-export function bg(color: any, text: string): string {
-  const code = resolveColor(color);
-  const codeStr = String(code);
-  const prefix =
-    typeof color === 'object' || codeStr.startsWith('2;') ? '48' : '48;5';
-  return `\x1b[${prefix};${codeStr}m${text}\x1b[0m`;
-}

package/src/components/Button.ts

@@ -1,104 +0,0 @@
-import type { BuntiContext } from '../dsl';
-import type { StyleOptions } from '../layout';
-
-export interface ButtonProps extends StyleOptions {
-  id: string;
-  label: string;
-  icon?: string;
-  variant?: 'primary' | 'secondary' | 'danger';
-  onClick?: () => void;
-}
-
-/**
- * Tactical Button Component
- * Fully reactive to keyboard focus and action events.
- */
-export function Button(ctx: BuntiContext, props: ButtonProps) {
-  const {
-    box,
-    color,
-    focusable,
-    state,
-    offsetX,
-    offsetY,
-    mouseX,
-    mouseY,
-    isMouseDown,
-  } = ctx;
-
-  // 1. Register in the global focus loop (for TAB navigation)
-  const isSelected = focusable(props.id);
-
-  // 2. Resolve final dimensions to perform Mouse Hit-Testing
-  const finalLabel = props.icon ? `${props.icon} ${props.label}` : props.label;
-  const w = props.width || Math.max(12, finalLabel.length + 4);
-  const h = props.height || 3;
-
-  const resolvedW = typeof w === 'number' ? w : ctx.width;
-  const absX =
-    props.width === '100%'
-      ? offsetX
-      : offsetX + Math.max(0, Math.floor((ctx.width - resolvedW) / 2));
-  const absY = offsetY + ctx.cursorY;
-
-  const isHovered =
-    mouseX >= absX &&
-    mouseX < absX + resolvedW &&
-    mouseY >= absY &&
-    mouseY < absY + (h as number);
-
-  // 3. Resolve Theme & State
-  let bg: any = 254; // Near white
-  let fg: any = 'black';
-  let borderCol: any = { r: 217, g: 216, b: 213 };
-
-  if (props.variant === 'primary') {
-    bg = 'black';
-    fg = 'white';
-    borderCol = 'black';
-  } else if (props.variant === 'danger') {
-    bg = 'error';
-    borderCol = color.lighten('error', 20);
-    fg = 'white';
-  }
-
-  // Active Interactive State
-  const isActive = isSelected || isHovered;
-
-  if (isActive) {
-    if (props.variant === 'primary') {
-      bg = 'ash'; // Hover state for primary
-    } else {
-      borderCol = 'black';
-      if (isMouseDown && isHovered) {
-        bg = color.darken(bg, 5); // Pressed state
-      }
-    }
-  }
-
-  // 4. Handle Interaction
-  const wasClicked = isHovered && isMouseDown && state.mouseButton === 0;
-  const wasActivated =
-    isSelected && (state.lastKey === 'enter' || state.lastKey === ' ');
-
-  if (wasClicked || wasActivated) {
-    if (props.onClick) props.onClick();
-  }
-
-  // 5. Render the Primitive
-  return box(
-    {
-      width: w,
-      height: h,
-      border: props.variant === 'primary' ? 'none' : props.border || 'rounded',
-      borderColor: borderCol,
-      bgColor: bg,
-      align: props.align || 'center',
-      valign: props.valign || 'middle',
-      padding: props.padding || [0, 1],
-    },
-    ({ text }) => {
-      text(color.fg(fg, isActive ? color.bold(finalLabel) : finalLabel));
-    },
-  );
-}

package/src/components/Card.ts

@@ -1,53 +0,0 @@
-import type { BuntiContext, DSLBoxOptions } from '../dsl';
-
-export interface CardProps extends DSLBoxOptions {
-  title?: string;
-  theme?: 'default' | 'accent' | 'danger';
-}
-
-/**
- * Tactical Card Component
- * A structural container with an integrated header.
- */
-export function Card(
-  ctx: BuntiContext,
-  props: CardProps,
-  callback: (sub: BuntiContext) => void,
-) {
-  const { box, color } = ctx;
-
-  const neutralGray = { r: 217, g: 216, b: 213 };
-  let borderColor: any = neutralGray;
-  let titleColor: any = neutralGray;
-
-  if (props.theme === 'accent') {
-    titleColor = 'black';
-    // Border remains neutral gray
-  } else if (props.theme === 'danger') {
-    borderColor = 'error';
-    titleColor = 'error';
-  }
-
-  return box(
-    {
-      x: props.x,
-      y: props.y,
-      anchor: props.anchor,
-      width: props.width || '100%',
-      height: props.height,
-      minHeight: props.minHeight,
-      border: props.border || 'frame',
-      borderColor: props.borderColor || borderColor,
-      padding: props.padding || [1, 2],
-      bgColor: props.bgColor,
-    },
-    (sub) => {
-      if (props.title) {
-        sub.text(
-          color.fg(titleColor, color.bold(`${props.title.toUpperCase()}\n\n`)),
-        );
-      }
-      callback(sub);
-    },
-  );
-}

package/src/components/Header.ts

@@ -1,65 +0,0 @@
-import type { BuntiContext } from '../dsl';
-import { box as engineBox } from '../layout';
-
-export interface HeaderProps {
-  title: string;
-  leftIcon?: string;
-  rightLabel?: string;
-  theme?: 'light' | 'dark';
-}
-
-/**
- * Enterprise Tactical Header
- * A full-width, high-signal branding bar.
- */
-export function Header(ctx: BuntiContext, props: HeaderProps) {
-  const { box, color, width, joinHorizontal } = ctx;
-
-  // Resolve Theme Colors
-  const isLight = props.theme !== 'dark';
-  const bg = isLight ? 'white' : 'midnight';
-  const fg = isLight ? 236 : 'silver';
-
-  // Master Background Box
-  box(
-    {
-      anchor: 'top',
-      width: '100%',
-      height: 1,
-      bgColor: bg,
-      border: 'none',
-      padding: [0, 2],
-    },
-    ({ text }) => {
-      // 1. Left: Branding
-      const leftStr = props.leftIcon ? color.fg('plasma', props.leftIcon) : '';
-      const leftNode = engineBox(leftStr, {
-        width: 12,
-        align: 'left',
-        border: 'none',
-        padding: [0, 0],
-      });
-
-      // 2. Center: Title
-      const midStr = color.fg(fg, color.bold(props.title));
-      const midNode = engineBox(midStr, {
-        width: width - 28,
-        align: 'center',
-        border: 'none',
-        padding: [0, 0],
-      });
-
-      // 3. Right: Telemetry / Exit
-      const rightStr = props.rightLabel ? color.dim(props.rightLabel) : '';
-      const rightNode = engineBox(rightStr, {
-        width: 12,
-        align: 'right',
-        border: 'none',
-        padding: [0, 0],
-      });
-
-      // Join and push to render pipeline
-      text(joinHorizontal(leftNode, midNode, rightNode));
-    },
-  );
-}

package/src/components/Input.ts

@@ -1,124 +0,0 @@
-import type { BuntiContext } from '../dsl';
-import type { StyleOptions } from '../layout';
-
-export interface InputProps extends StyleOptions {
-  id: string;
-  label?: string;
-  placeholder?: string;
-  value?: string;
-  type?: 'text' | 'password';
-  onChange?: (value: string) => void;
-}
-
-/**
- * Tactical Input Component
- * Managed state HOC with cursor simulation, keyboard interception, and mouse focus.
- */
-export function Input(ctx: BuntiContext, props: InputProps) {
-  const {
-    box,
-    color,
-    focusable,
-    state,
-    useState,
-    offsetX,
-    offsetY,
-    mouseX,
-    mouseY,
-    isMouseDown,
-  } = ctx;
-
-  // 1. Mouse Hit-Testing
-  const _finalLabelLen = props.label ? props.label.length + 1 : 0;
-  const w = props.width || 40;
-  const h = props.height || 3;
-
-  // Calculate absolute coordinates based on parent offsets and current flow cursor
-  // Assuming 100% width, x offset is just parent's offsetX.
-  const absX = offsetX;
-  const absY = offsetY + ctx.cursorY;
-
-  const isHovered =
-    mouseX >= absX &&
-    mouseX < absX + (w as number) &&
-    mouseY >= absY &&
-    mouseY < absY + (h as number);
-
-  // If clicked, force focus state
-  if (isHovered && isMouseDown && state.mouseButton === 0) {
-    state.focusedId = props.id;
-  }
-
-  // 2. Register in the global focus loop
-  const isSelected = focusable(props.id);
-
-  // 3. Manage internal state
-  const [value, setValue] = useState(props.id, props.value || '');
-
-  // 4. Handle Keyboard Interaction (only when focused)
-  if (isSelected && state.lastKey) {
-    const key = state.lastKey;
-
-    if (key === 'backspace') {
-      if (value.length > 0) {
-        const newValue = value.slice(0, -1);
-        setValue(newValue);
-        if (props.onChange) props.onChange(newValue);
-      }
-    } else if (
-      key === 'enter' ||
-      key === 'tab' ||
-      key === 'escape' ||
-      key === 'up' ||
-      key === 'down' ||
-      key === 'left' ||
-      key === 'right'
-    ) {
-      // System keys: ignore
-    } else if (key.length === 1) {
-      // Standard character input
-      const newValue = value + key;
-      setValue(newValue);
-      if (props.onChange) props.onChange(newValue);
-    }
-  }
-
-  // 5. Resolve Theme
-  const neutralGray = { r: 217, g: 216, b: 213 };
-  const borderCol = isSelected ? 'black' : isHovered ? 'ash' : neutralGray;
-  const _bgColor = { r: 255, g: 255, b: 255 };
-  const textColor = 'black';
-
-  // 6. Render
-  return box(
-    {
-      width: w,
-      height: h,
-      border: 'rounded',
-      borderColor: borderCol,
-      padding: [0, 1],
-      align: 'left',
-      valign: 'middle',
-    },
-    ({ text }) => {
-      // Label
-      if (props.label) {
-        text(color.dim(`${props.label} `));
-      }
-
-      // Value Display with simulated cursor
-      if (value.length === 0 && props.placeholder) {
-        text(color.dim(props.placeholder));
-      } else {
-        const displayValue =
-          props.type === 'password' ? '*'.repeat(value.length) : value;
-        text(color.fg(textColor, displayValue));
-      }
-
-      // Cursor (blinking)
-      if (isSelected && ctx.flicker(0.8)) {
-        text(color.black('█'));
-      }
-    },
-  );
-}

package/src/components/index.ts

@@ -1,4 +0,0 @@
-export * from './Button';
-export * from './Card';
-export * from './Header';
-export * from './Input';

package/src/data/glyphs.ts

@@ -1,30 +0,0 @@
-/**
- * Bunti Curated Glyph Registry (Nerd Font v3)
- */
-export const GLYPHS: Record<string, string> = {
-  // Languages & Tech
-  js: '\u{E781}', // nf-dev-javascript
-  ts: '\u{E628}', // nf-dev-typescript
-  python: '\u{E73C}', // nf-dev-python
-  rust: '\u{E7A8}', // nf-dev-rust
-  go: '\u{E627}', // nf-dev-go
-  node: '\u{E718}', // nf-dev-nodejs
-  bun: '\u{E22F}', // nf-seti-terminal (best proxy)
-
-  // Git & Source
-  git: '\u{F02A2}', // nf-md-git
-  branch: '\u{E725}', // nf-oct-git_branch
-  commit: '\u{E729}', // nf-oct-git_commit
-  pull: '\u{E728}', // nf-oct-git_pull_request
-  merge: '\u{E727}', // nf-oct-git_merge
-
-  // System & UI
-  folder: '\u{F07B}', // nf-fa-folder
-  file: '\u{F15B}', // nf-fa-file
-  lock: '\u{F023}', // nf-fa-lock
-  search: '\u{F002}', // nf-fa-search
-  settings: '\u{F013}', // nf-fa-cog
-  terminal: '\u{F489}', // nf-oct-terminal
-  heart: '\u{F004}', // nf-fa-heart
-  star: '\u{F005}', // nf-fa-star
-};

package/src/detect.ts

@@ -1,60 +0,0 @@
-/**
- * Bunti Terminal Capability Detection
- */
-
-export interface TerminalCapabilities {
-  nerdFont: boolean;
-  glyphProtocol: boolean;
-  unicode: boolean;
-  color: boolean;
-}
-
-/**
- * Detects terminal capabilities using environment variables and
- * modern protocol handshakes.
- */
-export async function detectCapabilities(): Promise<TerminalCapabilities> {
-  const caps: TerminalCapabilities = {
-    nerdFont: false,
-    glyphProtocol: false,
-    unicode: true,
-    color: true,
-  };
-
-  // 1. Environment Variable Heuristics
-  const term = process.env.TERM_PROGRAM || '';
-  const termEmulator = process.env.TERMINAL_EMULATOR || '';
-  const nerdEnv =
-    process.env.NERD_FONTS || process.env.NERD_FONT || process.env.BUNTI_NF;
-
-  // Optimistic list of terminals known to support modern fonts
-  const modernTerms = [
-    'Ghostty',
-    'WezTerm',
-    'iTerm.app',
-    'WarpTerminal',
-    'Apple_Terminal',
-    'vscode',
-    'Hyper',
-    'Rio',
-    'Term7',
-  ];
-
-  if (nerdEnv === '1' || nerdEnv === 'true' || nerdEnv === 'yes') {
-    caps.nerdFont = true;
-  } else if (modernTerms.includes(term) || modernTerms.includes(termEmulator)) {
-    caps.nerdFont = true;
-  } else if (process.env.LC_TERMINAL === 'iTerm2') {
-    caps.nerdFont = true;
-  }
-
-  // 2. Glyph Protocol Handshake (Ghostty 1.3+, Rio, WezTerm)
-  // We send the Support Query and wait briefly for a response.
-  // Note: This is an optimistic check for now, can be expanded to
-  // a full async TTY listener if needed.
-  if (term === 'Ghostty') {
-    caps.glyphProtocol = true;
-  }
-
-  return caps;
-}