termui 0.1.0 → 0.1.2

package/dist/components.js

@@ -0,0 +1,130 @@
+import {
+  Alert,
+  AspectRatio,
+  Badge,
+  Banner,
+  BigText,
+  Box,
+  Breadcrumb,
+  Card,
+  Center,
+  Checkbox,
+  CheckboxGroup,
+  Code,
+  Columns,
+  Confirm,
+  Definition,
+  Dialog,
+  Digits,
+  Divider,
+  Drawer,
+  Form,
+  FormField,
+  Gradient,
+  Grid,
+  Heading,
+  KeyValue,
+  Link,
+  List,
+  Menu,
+  Modal,
+  MultiSelect,
+  NumberInput,
+  Pagination,
+  Panel,
+  PasswordInput,
+  Popover,
+  ProgressBar,
+  ProgressCircle,
+  RadioGroup,
+  ScrollView,
+  SearchInput,
+  Select,
+  Sidebar,
+  Skeleton,
+  Spacer,
+  Spinner,
+  Stack,
+  StatusMessage,
+  Table,
+  Tabs,
+  Tag,
+  TagInput,
+  Text,
+  TextArea,
+  TextInput,
+  Toast,
+  Toggle,
+  Tooltip,
+  Tree,
+  VirtualList,
+  Wizard,
+  gradientText,
+  useFormContext
+} from "./chunk-B2VO7M2O.js";
+import "./chunk-ZZKFZA2U.js";
+export {
+  Alert,
+  AspectRatio,
+  Badge,
+  Banner,
+  BigText,
+  Box,
+  Breadcrumb,
+  Card,
+  Center,
+  Checkbox,
+  CheckboxGroup,
+  Code,
+  Columns,
+  Confirm,
+  Definition,
+  Dialog,
+  Digits,
+  Divider,
+  Drawer,
+  Form,
+  FormField,
+  Gradient,
+  Grid,
+  Heading,
+  KeyValue,
+  Link,
+  List,
+  Menu,
+  Modal,
+  MultiSelect,
+  NumberInput,
+  Pagination,
+  Panel,
+  PasswordInput,
+  Popover,
+  ProgressBar,
+  ProgressCircle,
+  RadioGroup,
+  ScrollView,
+  SearchInput,
+  Select,
+  Sidebar,
+  Skeleton,
+  Spacer,
+  Spinner,
+  Stack,
+  StatusMessage,
+  Table,
+  Tabs,
+  Tag,
+  TagInput,
+  Text,
+  TextArea,
+  TextInput,
+  Toast,
+  Toggle,
+  Tooltip,
+  Tree,
+  VirtualList,
+  Wizard,
+  gradientText,
+  useFormContext
+};
+//# sourceMappingURL=components.js.map

package/dist/components.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/core.d.ts

@@ -0,0 +1,144 @@
+import { e as Theme } from './hooks-YADffFjU.js';
+export { A as AsyncState, B as BorderTokens, C as ColorDepth, a as ColorTokens, I as InputHandler, K as Key, b as KeyBinding, M as MouseButton, c as MouseEvent, S as SpacingTokens, T as TerminalCapabilities, d as TerminalSize, f as ThemeProvider, g as TypographyTokens, h as createTheme, i as detectCapabilities, j as getCapabilities, r as refreshCapabilities, u as useAnimation, k as useAsync, l as useClipboard, m as useFocus, n as useFocusManager, o as useInput, p as useInterval, q as useKeymap, s as useMouse, t as useResize, v as useTerminal, w as useTheme, x as useThemeUpdater } from './hooks-YADffFjU.js';
+import 'react/jsx-runtime';
+import 'react';
+
+/**
+ * ANSI escape code utilities for terminal output.
+ * Covers: colors, styles, cursor movement, screen control.
+ */
+declare const reset = '\u001B[0m';
+declare const bold = '\u001B[1m';
+declare const dim = '\u001B[2m';
+declare const italic = '\u001B[3m';
+declare const underline = '\u001B[4m';
+declare const blink = '\u001B[5m';
+declare const inverse = '\u001B[7m';
+declare const hidden = '\u001B[8m';
+declare const strikethrough = '\u001B[9m';
+declare const fg: {
+  readonly black: '\u001B[30m';
+  readonly red: '\u001B[31m';
+  readonly green: '\u001B[32m';
+  readonly yellow: '\u001B[33m';
+  readonly blue: '\u001B[34m';
+  readonly magenta: '\u001B[35m';
+  readonly cyan: '\u001B[36m';
+  readonly white: '\u001B[37m';
+  readonly default: '\u001B[39m';
+  readonly brightBlack: '\u001B[90m';
+  readonly brightRed: '\u001B[91m';
+  readonly brightGreen: '\u001B[92m';
+  readonly brightYellow: '\u001B[93m';
+  readonly brightBlue: '\u001B[94m';
+  readonly brightMagenta: '\u001B[95m';
+  readonly brightCyan: '\u001B[96m';
+  readonly brightWhite: '\u001B[97m';
+};
+declare const bg: {
+  readonly black: '\u001B[40m';
+  readonly red: '\u001B[41m';
+  readonly green: '\u001B[42m';
+  readonly yellow: '\u001B[43m';
+  readonly blue: '\u001B[44m';
+  readonly magenta: '\u001B[45m';
+  readonly cyan: '\u001B[46m';
+  readonly white: '\u001B[47m';
+  readonly default: '\u001B[49m';
+  readonly brightBlack: '\u001B[100m';
+  readonly brightRed: '\u001B[101m';
+  readonly brightGreen: '\u001B[102m';
+  readonly brightYellow: '\u001B[103m';
+  readonly brightBlue: '\u001B[104m';
+  readonly brightMagenta: '\u001B[105m';
+  readonly brightCyan: '\u001B[106m';
+  readonly brightWhite: '\u001B[107m';
+};
+/** 256-color foreground: \x1b[38;5;<n>m */
+declare function fg256(n: number): string;
+/** 256-color background: \x1b[48;5;<n>m */
+declare function bg256(n: number): string;
+/** True-color (24-bit) foreground: \x1b[38;2;<r>;<g>;<b>m */
+declare function fgRgb(r: number, g: number, b: number): string;
+/** True-color (24-bit) background: \x1b[48;2;<r>;<g>;<b>m */
+declare function bgRgb(r: number, g: number, b: number): string;
+/** Parse a hex color string (#RRGGBB or #RGB) into {r,g,b} */
+declare function parseHex(hex: string): {
+  r: number;
+  g: number;
+  b: number;
+};
+/** Apply true-color foreground from a hex string */
+declare function fgHex(hex: string): string;
+/** Apply true-color background from a hex string */
+declare function bgHex(hex: string): string;
+declare const cursor: {
+  readonly up: (n?: number) => string;
+  readonly down: (n?: number) => string;
+  readonly forward: (n?: number) => string;
+  readonly back: (n?: number) => string;
+  readonly nextLine: (n?: number) => string;
+  readonly prevLine: (n?: number) => string;
+  readonly column: (n?: number) => string;
+  readonly position: (row: number, col: number) => string;
+  readonly hide: '\u001B[?25l';
+  readonly show: '\u001B[?25h';
+  readonly save: '\u001B[s';
+  readonly restore: '\u001B[u';
+};
+declare const screen: {
+  readonly clear: '\u001B[2J';
+  readonly clearToEnd: '\u001B[0J';
+  readonly clearToStart: '\u001B[1J';
+  readonly clearLine: '\u001B[2K';
+  readonly clearLineToEnd: '\u001B[0K';
+  readonly clearLineToStart: '\u001B[1K';
+  readonly alternateBuffer: '\u001B[?1049h';
+  readonly mainBuffer: '\u001B[?1049l';
+};
+declare const osc: {
+  /** OSC 8 — hyperlink: \x1b]8;;url\x1b\\ text \x1b]8;;\x1b\\ */
+  readonly hyperlink: (url: string, text: string) => string;
+  /** OSC 52 — clipboard write (base64-encoded) */
+  readonly clipboardWrite: (data: string) => string;
+  /** OSC 0 — set window title */
+  readonly setTitle: (title: string) => string;
+};
+/** Wrap text with a style and reset */
+declare function style$1(code: string, text: string): string;
+declare function stripAnsi(str: string): string;
+/** Measure visible width of a string (strips ANSI first) */
+declare function visibleWidth(str: string): number;
+
+/**
+ * Chainable style builder for ANSI-styled strings.
+ *
+ * Usage:
+ *   style('Hello').bold().fg('#FF0000').build()
+ *   style('World').dim().underline().build()
+ */
+declare class StyleBuilder {
+  private _text;
+  private _codes;
+  constructor(text: string);
+  bold(): this;
+  dim(): this;
+  italic(): this;
+  underline(): this;
+  strikethrough(): this;
+  fg(color: string): this;
+  bg(color: string): this;
+  /** Build the final ANSI-styled string */
+  build(): string;
+  toString(): string;
+}
+/** Entry point: style('text').bold().fg('#fff').build() */
+declare function style(text: string): StyleBuilder;
+
+declare const defaultTheme: Theme;
+
+declare const draculaTheme: Theme;
+
+declare const nordTheme: Theme;
+
+export { StyleBuilder, Theme, style$1 as ansiStyle, bg, bg256, bgHex, bgRgb, blink, bold, cursor, defaultTheme, dim, draculaTheme, fg, fg256, fgHex, fgRgb, hidden, inverse, italic, nordTheme, osc, parseHex, reset, screen, strikethrough, stripAnsi, style, underline, visibleWidth };

package/dist/core.js

@@ -0,0 +1,99 @@
+import {
+  StyleBuilder,
+  ThemeProvider,
+  bg,
+  bg256,
+  bgHex,
+  bgRgb,
+  blink,
+  bold,
+  createTheme,
+  cursor,
+  defaultTheme,
+  detectCapabilities,
+  dim,
+  draculaTheme,
+  fg,
+  fg256,
+  fgHex,
+  fgRgb,
+  getCapabilities,
+  hidden,
+  inverse,
+  italic,
+  nordTheme,
+  osc,
+  parseHex,
+  refreshCapabilities,
+  reset,
+  screen,
+  strikethrough,
+  stripAnsi,
+  style,
+  style2,
+  underline,
+  useAnimation,
+  useAsync,
+  useClipboard,
+  useFocus,
+  useFocusManager,
+  useInput,
+  useInterval,
+  useKeymap,
+  useMouse,
+  useResize,
+  useTerminal,
+  useTheme,
+  useThemeUpdater,
+  visibleWidth
+} from "./chunk-ZZKFZA2U.js";
+export {
+  StyleBuilder,
+  ThemeProvider,
+  style as ansiStyle,
+  bg,
+  bg256,
+  bgHex,
+  bgRgb,
+  blink,
+  bold,
+  createTheme,
+  cursor,
+  defaultTheme,
+  detectCapabilities,
+  dim,
+  draculaTheme,
+  fg,
+  fg256,
+  fgHex,
+  fgRgb,
+  getCapabilities,
+  hidden,
+  inverse,
+  italic,
+  nordTheme,
+  osc,
+  parseHex,
+  refreshCapabilities,
+  reset,
+  screen,
+  strikethrough,
+  stripAnsi,
+  style2 as style,
+  underline,
+  useAnimation,
+  useAsync,
+  useClipboard,
+  useFocus,
+  useFocusManager,
+  useInput,
+  useInterval,
+  useKeymap,
+  useMouse,
+  useResize,
+  useTerminal,
+  useTheme,
+  useThemeUpdater,
+  visibleWidth
+};
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/hooks-YADffFjU.d.ts

@@ -0,0 +1,237 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+/**
+ * Terminal capability detection.
+ * Detects: color depth, unicode support, mouse support, true-color.
+ */
+type ColorDepth = 1 | 4 | 8 | 24;
+interface TerminalCapabilities {
+  colorDepth: ColorDepth;
+  supportsUnicode: boolean;
+  supportsTrueColor: boolean;
+  supports256Color: boolean;
+  supportsMouse: boolean;
+  columns: number;
+  rows: number;
+  isTTY: boolean;
+}
+/** Detect current terminal capabilities from process environment */
+declare function detectCapabilities(): TerminalCapabilities;
+declare function getCapabilities(): TerminalCapabilities;
+/** Force re-detect capabilities (useful after SIGWINCH) */
+declare function refreshCapabilities(): TerminalCapabilities;
+
+/**
+ * Design token types for TermUI theming.
+ * All theme objects must conform to this shape.
+ */
+interface ColorTokens {
+  primary: string;
+  primaryForeground: string;
+  secondary: string;
+  secondaryForeground: string;
+  accent: string;
+  accentForeground: string;
+  success: string;
+  successForeground: string;
+  warning: string;
+  warningForeground: string;
+  error: string;
+  errorForeground: string;
+  info: string;
+  infoForeground: string;
+  background: string;
+  foreground: string;
+  muted: string;
+  mutedForeground: string;
+  border: string;
+  focusRing: string;
+  selection: string;
+  selectionForeground: string;
+}
+interface SpacingTokens {
+  0: number;
+  1: number;
+  2: number;
+  3: number;
+  4: number;
+  6: number;
+  8: number;
+}
+interface TypographyTokens {
+  bold: boolean;
+  sm: string;
+  base: string;
+  lg: string;
+  xl: string;
+}
+interface BorderTokens {
+  style: 'single' | 'double' | 'round' | 'bold' | 'singleDouble' | 'doubleSingle' | 'classic';
+  color: string;
+  focusColor: string;
+}
+interface Theme {
+  name: string;
+  colors: ColorTokens;
+  spacing: SpacingTokens;
+  typography: TypographyTokens;
+  border: BorderTokens;
+}
+
+interface ThemeProviderProps {
+  theme?: Theme;
+  children: ReactNode;
+}
+declare function ThemeProvider({
+  theme,
+  children,
+}: ThemeProviderProps): react_jsx_runtime.JSX.Element;
+declare function useTheme(): Theme;
+declare function useThemeUpdater(): (theme: Theme) => void;
+/** Create a custom theme by merging with the default theme */
+declare function createTheme(
+  overrides: Partial<Theme> & {
+    name: string;
+  }
+): Theme;
+
+type Key = {
+  upArrow: boolean;
+  downArrow: boolean;
+  leftArrow: boolean;
+  rightArrow: boolean;
+  pageDown: boolean;
+  pageUp: boolean;
+  return: boolean;
+  escape: boolean;
+  ctrl: boolean;
+  shift: boolean;
+  tab: boolean;
+  backspace: boolean;
+  delete: boolean;
+  meta: boolean;
+};
+type InputHandler = (input: string, key: Key) => void;
+/** Keyboard input hook — delegates to Ink's useInput */
+declare function useInput(
+  handler: InputHandler,
+  options?: {
+    isActive?: boolean;
+  }
+): void;
+
+/** Single component focus state — delegates to Ink's useFocus */
+declare function useFocus(options?: {
+  autoFocus?: boolean;
+  isActive?: boolean;
+  id?: string;
+}): {
+  isFocused: boolean;
+  focus: (id: string) => void;
+};
+
+/** Global programmatic focus control — delegates to Ink's useFocusManager */
+declare function useFocusManager(): {
+  enableFocus: () => void;
+  disableFocus: () => void;
+  focusNext: () => void;
+  focusPrevious: () => void;
+  focus: (id: string) => void;
+};
+
+/** Returns current terminal capabilities, updates on resize */
+declare function useTerminal(): TerminalCapabilities;
+
+/**
+ * Frame-based animation hook at configurable fps.
+ * Returns the current frame index (increments every tick).
+ */
+declare function useAnimation(fps?: number): number;
+
+/**
+ * React-safe setInterval hook with automatic cleanup.
+ * The callback is always fresh (via ref) so stale closure is not an issue.
+ */
+declare function useInterval(callback: () => void, delay: number | null): void;
+
+/**
+ * OSC 52 clipboard hook.
+ * write() sends data to the terminal's clipboard via OSC 52.
+ * Note: read() is not universally supported; returns null on unsupported terminals.
+ */
+declare function useClipboard(): {
+  write: (text: string) => void;
+};
+
+type KeyBinding = {
+  key?: string;
+  ctrl?: boolean;
+  shift?: boolean;
+  meta?: boolean;
+  action: () => void;
+};
+/**
+ * Declarative keybinding registration with conflict detection.
+ * Pass an array of KeyBinding objects; the hook handles matching and invocation.
+ */
+declare function useKeymap(bindings: KeyBinding[], isActive?: boolean): void;
+
+type MouseButton = 'left' | 'middle' | 'right' | 'scrollUp' | 'scrollDown';
+interface MouseEvent {
+  type: 'press' | 'release' | 'move';
+  button: MouseButton;
+  x: number;
+  y: number;
+  ctrl: boolean;
+  shift: boolean;
+  meta: boolean;
+}
+type MouseHandler = (event: MouseEvent) => void;
+/**
+ * Mouse events hook (click, scroll, drag).
+ * Requires terminal to support xterm mouse protocol.
+ * Enables mouse tracking on mount, disables on unmount.
+ */
+declare function useMouse(handler: MouseHandler): void;
+
+interface TerminalSize {
+  columns: number;
+  rows: number;
+}
+/** Returns terminal dimensions, updates on resize with debounce */
+declare function useResize(debounceMs?: number): TerminalSize;
+
+type AsyncState<T> =
+  | {
+      status: 'idle';
+      data: null;
+      error: null;
+    }
+  | {
+      status: 'loading';
+      data: null;
+      error: null;
+    }
+  | {
+      status: 'success';
+      data: T;
+      error: null;
+    }
+  | {
+      status: 'error';
+      data: null;
+      error: Error;
+    };
+/**
+ * Async data loading hook with loading/error/data states.
+ * Automatically cancels stale requests.
+ */
+declare function useAsync<T>(
+  asyncFn: () => Promise<T>,
+  deps?: unknown[]
+): AsyncState<T> & {
+  refetch: () => void;
+};
+
+export { type AsyncState as A, type BorderTokens as B, type ColorDepth as C, type InputHandler as I, type Key as K, type MouseButton as M, type SpacingTokens as S, type TerminalCapabilities as T, type ColorTokens as a, type KeyBinding as b, type MouseEvent as c, type TerminalSize as d, type Theme as e, ThemeProvider as f, type TypographyTokens as g, createTheme as h, detectCapabilities as i, getCapabilities as j, useAsync as k, useClipboard as l, useFocus as m, useFocusManager as n, useInput as o, useInterval as p, useKeymap as q, refreshCapabilities as r, useMouse as s, useResize as t, useAnimation as u, useTerminal as v, useTheme as w, useThemeUpdater as x };

package/dist/hooks.d.ts

@@ -0,0 +1,3 @@
+export { A as AsyncState, I as InputHandler, K as Key, b as KeyBinding, M as MouseButton, c as MouseEvent, d as TerminalSize, u as useAnimation, k as useAsync, l as useClipboard, m as useFocus, n as useFocusManager, o as useInput, p as useInterval, q as useKeymap, s as useMouse, t as useResize, v as useTerminal, w as useTheme } from './hooks-YADffFjU.js';
+import 'react/jsx-runtime';
+import 'react';

package/dist/hooks.js

@@ -0,0 +1,29 @@
+import {
+  useAnimation,
+  useAsync,
+  useClipboard,
+  useFocus,
+  useFocusManager,
+  useInput,
+  useInterval,
+  useKeymap,
+  useMouse,
+  useResize,
+  useTerminal,
+  useTheme
+} from "./chunk-ZZKFZA2U.js";
+export {
+  useAnimation,
+  useAsync,
+  useClipboard,
+  useFocus,
+  useFocusManager,
+  useInput,
+  useInterval,
+  useKeymap,
+  useMouse,
+  useResize,
+  useTerminal,
+  useTheme
+};
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { StyleBuilder, ansiStyle, bg, bg256, bgHex, bgRgb, blink, bold, cursor, defaultTheme, dim, draculaTheme, fg, fg256, fgHex, fgRgb, hidden, inverse, italic, nordTheme, osc, parseHex, reset, screen, strikethrough, stripAnsi, style, underline, visibleWidth } from './core.js';
+export { A as AsyncState, B as BorderTokens, C as ColorDepth, a as ColorTokens, I as InputHandler, K as Key, b as KeyBinding, M as MouseButton, c as MouseEvent, S as SpacingTokens, T as TerminalCapabilities, d as TerminalSize, e as Theme, f as ThemeProvider, g as TypographyTokens, h as createTheme, i as detectCapabilities, j as getCapabilities, r as refreshCapabilities, u as useAnimation, k as useAsync, l as useClipboard, m as useFocus, n as useFocusManager, o as useInput, p as useInterval, q as useKeymap, s as useMouse, t as useResize, v as useTerminal, w as useTheme, x as useThemeUpdater } from './hooks-YADffFjU.js';
+export { Alert, AlertProps, AlertVariant, AspectRatio, AspectRatioProps, Badge, BadgeProps, BadgeVariant, Banner, BannerProps, BannerVariant, BigText, BigTextFont, BigTextProps, BorderVariant, Box, BoxProps, Breadcrumb, BreadcrumbItem, BreadcrumbProps, Card, CardProps, Center, CenterProps, Checkbox, CheckboxGroup, CheckboxGroupOption, CheckboxGroupProps, CheckboxProps, Code, CodeProps, Column, Columns, ColumnsProps, Confirm, ConfirmProps, Definition, DefinitionItem, DefinitionProps, Dialog, DialogProps, DigitSize, Digits, DigitsProps, Divider, DividerProps, Drawer, DrawerEdge, DrawerProps, Form, FormField, FormFieldDefinition, FormFieldProps, FormProps, Gradient, GradientChar, GradientProps, Grid, GridProps, Heading, HeadingLevel, HeadingProps, KeyValue, KeyValueItem, KeyValueProps, Link, LinkProps, List, ListItem, ListProps, Menu, MenuItem, MenuProps, Modal, ModalProps, MultiSelect, MultiSelectOption, MultiSelectProps, NumberInput, NumberInputProps, Pagination, PaginationProps, Panel, PanelProps, PasswordInput, PasswordInputProps, Popover, PopoverProps, ProgressBar, ProgressBarProps, ProgressCircle, ProgressCircleProps, ProgressCircleSize, RadioGroup, RadioGroupProps, RadioOption, ScrollView, ScrollViewProps, SearchInput, SearchInputProps, Select, SelectOption, SelectProps, Sidebar, SidebarItem, SidebarProps, Skeleton, SkeletonProps, Spacer, SpacerProps, Spinner, SpinnerProps, SpinnerStyle, Stack, StackProps, StatusMessage, StatusMessageProps, StatusVariant, Tab, Table, TableProps, Tabs, TabsProps, Tag, TagInput, TagInputProps, TagProps, TagVariant, Text, TextArea, TextAreaProps, TextInput, TextInputProps, TextProps, Toast, ToastProps, ToastVariant, Toggle, ToggleProps, Tooltip, TooltipProps, Tree, TreeNode, TreeProps, VirtualList, VirtualListProps, Wizard, WizardProps, WizardStep, gradientText, useFormContext } from './components.js';
+import 'react/jsx-runtime';
+import 'react';
+import 'ink';