@allternit/gizzi-code 1.0.0 → 1.0.1

package/src/hooks/useKeybinding.ts

@@ -1,226 +1,85 @@
 /**
- * @fileoverview Keybinding hook for gizzi-code integration
- * @module hooks/useKeybinding
- *
- * Provides a React hook for registering keyboard shortcuts and key combinations.
- * Supports modifier keys (Ctrl, Alt, Shift, Meta) and automatic cleanup on unmount.
+ * useKeybinding hook
+ * Registers keyboard shortcuts
  */
 
-import { useEffect, useCallback, useRef } from 'react';
-
-/**
- * Key combination configuration
- * @interface KeybindingConfig
- */
-export interface KeybindingConfig {
-  /** The main key (e.g., 'c', 'Enter', 'Escape') */
-  readonly key: string;
-  /** Require Ctrl key to be pressed */
-  readonly ctrl?: boolean;
-  /** Require Alt/Option key to be pressed */
-  readonly alt?: boolean;
-  /** Require Shift key to be pressed */
-  readonly shift?: boolean;
-  /** Require Meta/Command key to be pressed */
-  readonly meta?: boolean;
-  /** Prevent default browser behavior */
-  readonly preventDefault?: boolean;
-  /** Stop event propagation */
-  readonly stopPropagation?: boolean;
-}
-
-/**
- * Mutable version for internal parsing
- * @interface MutableKeybindingConfig
- */
-interface MutableKeybindingConfig {
-  key: string;
-  ctrl?: boolean;
-  alt?: boolean;
-  shift?: boolean;
-  meta?: boolean;
-  preventDefault?: boolean;
-  stopPropagation?: boolean;
-}
-
-/**
- * Normalized key combination string for comparison
- * @param {KeybindingConfig} config - Keybinding configuration
- * @returns {string} Normalized key combination string
- */
-function normalizeKeyCombo(config: KeybindingConfig): string {
-  const parts: string[] = [];
-  if (config.ctrl) parts.push('ctrl');
-  if (config.alt) parts.push('alt');
-  if (config.shift) parts.push('shift');
-  if (config.meta) parts.push('meta');
-  parts.push(config.key.toLowerCase());
-  return parts.join('+');
+import { useEffect, useCallback } from 'react'
+import { useInput } from 'ink'
+
+export type KeyHandler = (input: string, key: Key) => void
+
+export interface 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
 }
 
-/**
- * Parses a keybinding string into a config object
- *
- * @param {string} keybinding - Keybinding string (e.g., "Ctrl+C", "Escape", "Ctrl+Shift+A")
- * @returns {KeybindingConfig} Parsed keybinding configuration
- * @example
- * ```typescript
- * parseKeybinding("Ctrl+C"); // { key: 'c', ctrl: true }
- * parseKeybinding("Escape"); // { key: 'escape' }
- * parseKeybinding("Ctrl+Shift+A"); // { key: 'a', ctrl: true, shift: true }
- * ```
- */
-export function parseKeybinding(keybinding: string): KeybindingConfig {
-  const parts = keybinding.split('+').map((p) => p.trim().toLowerCase());
-
-  const config: MutableKeybindingConfig = {
-    key: '',
-    ctrl: false,
-    alt: false,
-    shift: false,
-    meta: false,
-  };
-
-  for (const part of parts) {
-    switch (part) {
-      case 'ctrl':
-      case 'control':
-        config.ctrl = true;
-        break;
-      case 'alt':
-      case 'option':
-        config.alt = true;
-        break;
-      case 'shift':
-        config.shift = true;
-        break;
-      case 'meta':
-      case 'cmd':
-      case 'command':
-      case 'win':
-      case 'windows':
-        config.meta = true;
-        break;
-      default:
-        config.key = part;
-        break;
+export function useKeybinding(key: string, handler: () => void, deps: React.DependencyList = []): void {
+  const memoizedHandler = useCallback(handler, deps)
+
+  useInput((input, keyEvent) => {
+    const keyMatch = key.toLowerCase()
+    
+    if (keyMatch === 'ctrl+c' && keyEvent.ctrl && input === 'c') {
+      memoizedHandler()
+    } else if (keyMatch === 'ctrl+d' && keyEvent.ctrl && input === 'd') {
+      memoizedHandler()
+    } else if (keyMatch === 'ctrl+z' && keyEvent.ctrl && input === 'z') {
+      memoizedHandler()
+    } else if (keyMatch === 'escape' && keyEvent.escape) {
+      memoizedHandler()
+    } else if (keyMatch === 'return' && keyEvent.return) {
+      memoizedHandler()
+    } else if (keyMatch === 'tab' && keyEvent.tab) {
+      memoizedHandler()
+    } else if (keyMatch === 'up' && keyEvent.upArrow) {
+      memoizedHandler()
+    } else if (keyMatch === 'down' && keyEvent.downArrow) {
+      memoizedHandler()
+    } else if (keyMatch === 'left' && keyEvent.leftArrow) {
+      memoizedHandler()
+    } else if (keyMatch === 'right' && keyEvent.rightArrow) {
+      memoizedHandler()
+    } else if (keyMatch === input.toLowerCase()) {
+      memoizedHandler()
     }
-  }
-
-  return config;
+  })
 }
 
-/**
- * Key event handler type
- * @typedef {Function} KeyHandler
- */
-export type KeyHandler = (event: KeyboardEvent) => void | boolean;
-
-/**
- * React hook for registering keyboard shortcuts
- *
- * Registers a keyboard shortcut that triggers the provided handler when pressed.
- * Automatically cleans up the event listener when the component unmounts or
- * when the keybinding changes.
- *
- * @param {string | KeybindingConfig} key - Key combination (e.g., "Ctrl+C") or config object
- * @param {KeyHandler} handler - Function to call when keybinding is triggered
- * @param {boolean} [enabled=true] - Whether the keybinding is active
- * @example
- * ```typescript
- * // Using string keybinding
- * useKeybinding('Ctrl+C', () => {
- *   console.log('Copy!');
- * });
- *
- * // Using config object
- * useKeybinding({ key: 'k', ctrl: true }, (e) => {
- *   e.preventDefault();
- *   console.log('Ctrl+K pressed');
- * });
- *
- * // With conditional enabling
- * useKeybinding('Escape', handleClose, isModalOpen);
- * ```
- */
-export function useKeybinding(
-  key: string | KeybindingConfig,
-  handler: KeyHandler,
-  enabled: boolean = true
-): void {
-  const config = typeof key === 'string' ? parseKeybinding(key) : key;
-  const expectedCombo = normalizeKeyCombo(config);
-  const handlerRef = useRef<KeyHandler>(handler);
-
-  // Keep handler reference up to date without re-registering
+export function useGlobalKeybinding(key: string, handler: () => void): void {
   useEffect(() => {
-    handlerRef.current = handler;
-  }, [handler]);
-
-  const handleKeyDown = useCallback(
-    (event: KeyboardEvent) => {
-      // Check if this key event matches our expected combination
-      const actualCombo = normalizeKeyCombo({
-        key: event.key,
-        ctrl: event.ctrlKey,
-        alt: event.altKey,
-        shift: event.shiftKey,
-        meta: event.metaKey,
-      });
-
-      if (actualCombo === expectedCombo) {
-        if (config.preventDefault) {
-          event.preventDefault();
-        }
-        if (config.stopPropagation) {
-          event.stopPropagation();
-        }
-
-        const result = handlerRef.current(event);
-        // Allow handler to prevent default by returning false
-        if (result === false) {
-          event.preventDefault();
-        }
+    const keyHandler = (str: string, keyEvent: { ctrl: boolean; name: string }) => {
+      const keyMatch = key.toLowerCase()
+      
+      if (keyMatch === 'ctrl+c' && keyEvent.ctrl && keyEvent.name === 'c') {
+        handler()
+      } else if (keyMatch === 'escape' && keyEvent.name === 'escape') {
+        handler()
+      } else if (keyMatch === keyEvent.name) {
+        handler()
       }
-    },
-    [config, expectedCombo]
-  );
-
-  useEffect(() => {
-    if (!enabled || typeof window === 'undefined') {
-      return;
     }
 
-    window.addEventListener('keydown', handleKeyDown);
+    process.stdin.on('keypress', keyHandler)
 
     return () => {
-      window.removeEventListener('keydown', handleKeyDown);
-    };
-  }, [enabled, handleKeyDown]);
+      process.stdin.off('keypress', keyHandler)
+    }
+  }, [key, handler])
 }
 
-/**
- * Hook for registering multiple keybindings at once
- *
- * @param {Array<[string | KeybindingConfig, KeyHandler]>} bindings - Array of [keybinding, handler] tuples
- * @param {boolean} [enabled=true] - Whether all keybindings are active
- * @example
- * ```typescript
- * useKeybindings([
- *   ['Ctrl+C', handleCopy],
- *   ['Ctrl+V', handlePaste],
- *   ['Escape', handleClose],
- * ]);
- * ```
- */
-export function useKeybindings(
-  bindings: Array<[string | KeybindingConfig, KeyHandler]>,
-  enabled: boolean = true
-): void {
-  bindings.forEach(([key, handler]) => {
-    useKeybinding(key, handler, enabled);
-  });
+export default {
+  useKeybinding,
+  useGlobalKeybinding,
 }
-
-// Default export
-export default useKeybinding;

package/src/hooks/useTerminalSize.ts

@@ -1,117 +1,49 @@
 /**
- * @fileoverview Terminal size hook for gizzi-code integration
- * @module hooks/useTerminalSize
- *
- * Provides a React hook to track terminal dimensions with resize event handling.
- * Returns the current terminal width and height, defaulting to standard terminal
- * dimensions when not in a browser environment.
+ * useTerminalSize hook
+ * Tracks terminal dimensions
  */
 
-import { useState, useEffect, useCallback } from 'react';
+import { useState, useEffect } from 'react'
 
-/**
- * Terminal size state interface
- * @interface TerminalSize
- */
 export interface TerminalSize {
-  /** Current terminal width in columns */
-  readonly width: number;
-  /** Current terminal height in rows */
-  readonly height: number;
-}
-
-/**
- * Default terminal dimensions (80x24 is standard terminal size)
- * @constant {TerminalSize}
- */
-const DEFAULT_TERMINAL_SIZE: TerminalSize = {
-  width: 80,
-  height: 24,
-};
-
-/**
- * Gets the current terminal size from the window object
- * Falls back to default dimensions if window is not available
- *
- * @returns {TerminalSize} Current terminal dimensions
- */
-function getTerminalSize(): TerminalSize {
-  if (typeof window === 'undefined') {
-    return DEFAULT_TERMINAL_SIZE;
-  }
-
-  // Estimate columns/rows based on window size and average character dimensions
-  // This is an approximation - actual terminal emulators may vary
-  const avgCharWidth = 8; // pixels per character (approximate)
-  const avgLineHeight = 16; // pixels per line (approximate)
-
-  const width = Math.max(20, Math.floor(window.innerWidth / avgCharWidth));
-  const height = Math.max(5, Math.floor(window.innerHeight / avgLineHeight));
-
-  return { width, height };
+  width: number
+  height: number
 }
 
-/**
- * React hook for tracking terminal size
- *
- * Returns the current terminal dimensions and automatically updates
- * when the window is resized. Uses debouncing to prevent excessive
- * re-renders during resize operations.
- *
- * @returns {TerminalSize} Current terminal width and height
- * @example
- * ```typescript
- * function MyComponent() {
- *   const { width, height } = useTerminalSize();
- *
- *   return (
- *     <div>
- *       Terminal: {width}×{height}
- *     </div>
- *   );
- * }
- * ```
- */
 export function useTerminalSize(): TerminalSize {
-  const [size, setSize] = useState<TerminalSize>(getTerminalSize);
-
-  const handleResize = useCallback(() => {
-    setSize(getTerminalSize());
-  }, []);
+  const [size, setSize] = useState<TerminalSize>({
+    width: process.stdout.columns || 80,
+    height: process.stdout.rows || 24,
+  })
 
   useEffect(() => {
-    // Check if window is available (SSR safety)
-    if (typeof window === 'undefined') {
-      return;
+    const handleResize = () => {
+      setSize({
+        width: process.stdout.columns || 80,
+        height: process.stdout.rows || 24,
+      })
     }
 
-    // Debounced resize handler
-    let resizeTimeout: ReturnType<typeof setTimeout> | null = null;
-
-    const debouncedHandleResize = (): void => {
-      if (resizeTimeout) {
-        clearTimeout(resizeTimeout);
-      }
-      resizeTimeout = setTimeout(handleResize, 100);
-    };
+    process.stdout.on('resize', handleResize)
 
-    // Set initial size
-    handleResize();
+    return () => {
+      process.stdout.off('resize', handleResize)
+    }
+  }, [])
 
-    // Add resize listener
-    window.addEventListener('resize', debouncedHandleResize);
+  return size
+}
 
-    // Cleanup
-    return () => {
-      window.removeEventListener('resize', debouncedHandleResize);
-      if (resizeTimeout) {
-        clearTimeout(resizeTimeout);
-      }
-    };
-  }, [handleResize]);
+export function useTerminalWidth(): number {
+  return useTerminalSize().width
+}
 
-  return size;
+export function useTerminalHeight(): number {
+  return useTerminalSize().height
 }
 
-// Default export for convenient importing
-export default useTerminalSize;
+export default {
+  useTerminalSize,
+  useTerminalWidth,
+  useTerminalHeight,
+}

package/src/hooks.ts

@@ -0,0 +1,37 @@
+/**
+ * Hooks System
+ */
+
+export interface HookContext {
+  event: string
+  data: unknown
+}
+
+export type HookCallback = (ctx: HookContext) => void | Promise<void>
+
+const hooks: Map<string, HookCallback[]> = new Map()
+
+export function registerHook(event: string, callback: HookCallback): () => void {
+  if (!hooks.has(event)) {
+    hooks.set(event, [])
+  }
+  hooks.get(event)!.push(callback)
+  return () => {
+    const callbacks = hooks.get(event)
+    if (callbacks) {
+      const index = callbacks.indexOf(callback)
+      if (index >= 0) callbacks.splice(index, 1)
+    }
+  }
+}
+
+export async function executeHooks(event: string, data: unknown): Promise<void> {
+  const callbacks = hooks.get(event) || []
+  for (const callback of callbacks) {
+    await callback({ event, data })
+  }
+}
+
+export function hasWorktreeCreateHook(): boolean {
+  return hooks.has('worktree:create')
+}

package/src/ink.ts

@@ -0,0 +1,204 @@
+/**
+ * Ink CLI rendering utilities
+ * React-based CLI UI components
+ */
+
+import type { ReactNode } from 'react'
+
+// Re-export from ink
+export {
+  render,
+  Box,
+  Text,
+  useInput,
+  useApp,
+  useStdout,
+  useStdin,
+  Spacer,
+  Newline,
+  Static,
+  Transform,
+  measureElement,
+  useFocus,
+  useFocusManager,
+} from 'ink'
+
+export type { BoxProps, TextProps, RenderOptions } from 'ink'
+
+// Key handling types
+export interface Key {
+  name?: string
+  ctrl?: boolean
+  shift?: boolean
+  meta?: boolean
+  sequence?: string
+}
+
+// String width calculation (for text wrapping)
+export function stringWidth(str: string): number {
+  // Strip ANSI codes and count visible characters
+  const withoutAnsi = str.replace(/\u001b\[[0-9;]*m/g, '')
+  // Approximate width (for proper implementation, use string-width package)
+  return [...withoutAnsi].length
+}
+
+// Terminal size hook
+export interface TerminalSize {
+  width: number
+  height: number
+}
+
+export function useTerminalSize(): TerminalSize {
+  // Default fallback
+  return {
+    width: process.stdout.columns || 80,
+    height: process.stdout.rows || 24,
+  }
+}
+
+// Color utilities
+export type InkColor =
+  | 'black'
+  | 'red'
+  | 'green'
+  | 'yellow'
+  | 'blue'
+  | 'magenta'
+  | 'cyan'
+  | 'white'
+  | 'gray'
+  | 'grey'
+  | 'redBright'
+  | 'greenBright'
+  | 'yellowBright'
+  | 'blueBright'
+  | 'magentaBright'
+  | 'cyanBright'
+  | 'whiteBright'
+  | string
+  | number
+  | undefined
+
+// Common key codes
+export const KeyCodes = {
+  RETURN: '\r',
+  ENTER: '\n',
+  TAB: '\t',
+  ESC: '\u001b',
+  BACKSPACE: '\u007f',
+  CTRL_C: '\u0003',
+  CTRL_D: '\u0004',
+  CTRL_Z: '\u001a',
+  UP: '\u001b[A',
+  DOWN: '\u001b[B',
+  RIGHT: '\u001b[C',
+  LEFT: '\u001b[D',
+} as const
+
+// Spinner states
+export type SpinnerType =
+  | 'dots'
+  | 'dots2'
+  | 'dots3'
+  | 'dots4'
+  | 'dots5'
+  | 'dots6'
+  | 'dots7'
+  | 'dots8'
+  | 'dots9'
+  | 'dots10'
+  | 'dots11'
+  | 'dots12'
+  | 'line'
+  | 'line2'
+  | 'pipe'
+  | 'star'
+  | 'star2'
+  | 'flip'
+  | 'hamburger'
+  | 'growVertical'
+  | 'growHorizontal'
+  | 'balloon'
+  | 'balloon2'
+  | 'noise'
+  | 'bounce'
+  | 'boxBounce'
+  | 'boxBounce2'
+  | 'triangle'
+  | 'arc'
+  | 'circle'
+  | 'squareCorners'
+  | 'circleQuarters'
+  | 'circleHalves'
+  | 'squish'
+  | 'toggle'
+  | 'toggle2'
+  | 'toggle3'
+  | 'toggle4'
+  | 'toggle5'
+  | 'toggle6'
+  | 'toggle7'
+  | 'toggle8'
+  | 'toggle9'
+  | 'toggle10'
+  | 'toggle11'
+  | 'toggle12'
+  | 'toggle13'
+
+export const SPINNER_FRAMES: Record<SpinnerType, string[]> = {
+  dots: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'],
+  dots2: ['⣾', '⣽', '⣻', '⢿', '⡿', '⣟', '⣯', '⣷'],
+  dots3: ['⠋', '⠙', '⠚', '⠞', '⠖', '⠦', '⠴', '⠲', '⠳', '⠓'],
+  dots4: ['⠄', '⠆', '⠇', '⠋', '⠙', '⠸', '⠰', '⠠', '⠰', '⠸', '⠙', '⠋', '⠇', '⠆'],
+  dots5: ['⠋', '⠙', '⠚', '⠒', '⠂', '⠂', '⠒', '⠲', '⠴', '⠦', '⠖', '⠒', '⠐', '⠐', '⠒', '⠓', '⠋'],
+  dots6: ['⠁', '⠉', '⠙', '⠚', '⠒', '⠂', '⠂', '⠒', '⠲', '⠴', '⠤', '⠄', '⠄', '⠤', '⠴', '⠲', '⠒', '⠂', '⠂', '⠒', '⠚', '⠙', '⠉', '⠁'],
+  dots7: ['⠈', '⠉', '⠋', '⠓', '⠒', '⠐', '⠐', '⠒', '⠖', '⠦', '⠤', '⠠', '⠠', '⠤', '⠦', '⠖', '⠒', '⠐', '⠐', '⠒', '⠓', '⠋', '⠉', '⠈'],
+  dots8: ['⠁', '⠁', '⠉', '⠙', '⠚', '⠒', '⠂', '⠂', '⠒', '⠲', '⠴', '⠤', '⠄', '⠄', '⠤', '⠠', '⠠', '⠤', '⠦', '⠖', '⠒', '⠐', '⠐', '⠒', '⠓', '⠋', '⠉', '⠈', '⠈'],
+  dots9: ['⢹', '⢺', '⢼', '⣸', '⣇', '⡧', '⡗', '⡏'],
+  dots10: ['⢄', '⢂', '⢁', '⡁', '⡈', '⡐', '⡠'],
+  dots11: ['⠁', '⠂', '⠄', '⡀', '⢀', '⠠', '⠐', '⠈'],
+  dots12: ['⢀⠀', '⡀⠀', '⠄⠀', '⢂⠀', '⡂⠀', '⠅⠀', '⢃⠀', '⡃⠀', '⠍⠀', '⢋⠀', '⡋⠀', '⠍⠁', '⢋⠁', '⡋⠁', '⠍⠉', '⢋⠉', '⡋⠉', '⠍⠙', '⢋⠙', '⡋⠙', '⠍⠚', '⢋⠚', '⡋⠚', '⠍⠒', '⢋⠒', '⡋⠒', '⠍⠂', '⢋⠂', '⡋⠂', '⠍⡀', '⢋⡀', '⡋⡀', '⠍⡄', '⢋⡄', '⡋⡄', '⠍⡆', '⢋⡆', '⡋⡆', '⠍⡇', '⢋⡇', '⡋⡇', '⠍⡏', '⢋⡏', '⡋⡏', '⠍⡹', '⢋⡹', '⡋⡹', '⠍⢹', '⢋⢹', '⡋⢹', '⠍⣸', '⢋⣸', '⡋⣸', '⠍⣴', '⢋⣴', '⡋⣴', '⠍⣦', '⢋⣦', '⡋⣦', '⠍⣇', '⢋⣇', '⡋⣇', '⠍⡧', '⢋⡧', '⡋⡧', '⠍⡗', '⢋⡗', '⡋⡗', '⠍⡏'],
+  line: ['-', '\\', '|', '/'],
+  line2: ['⠂', '-', '–', '—', '–', '-'],
+  pipe: ['┤', '┘', '┴', '└', '├', '┌', '┬', '┐'],
+  star: ['✶', '✸', '✹', '✺', '✹', '✷'],
+  star2: ['+', 'x', '*'],
+  flip: ['_', '_', '_', '-', '`', '`', "'", '´', '-', '_', '_', '_'],
+  hamburger: ['☱', '☲', '☴'],
+  growVertical: ['▁', '▃', '▄', '▅', '▆', '▇', '▆', '▅', '▄', '▃'],
+  growHorizontal: ['▏', '▎', '▍', '▌', '▋', '▊', '▉', '▊', '▋', '▌', '▍', '▎'],
+  balloon: ['.', 'o', 'O', '@', '*'],
+  balloon2: ['.', 'o', 'O', '°', 'O', 'o', '.'],
+  noise: ['▓', '▒', '░'],
+  bounce: ['⠁', '⠂', '⠄', '⠂'],
+  boxBounce: ['▖', '▘', '▝', '▗'],
+  boxBounce2: ['▌', '▀', '▐', '▄'],
+  triangle: ['◢', '◣', '◤', '◥'],
+  arc: ['◜', '◠', '◝', '◞', '◡', '◟'],
+  circle: ['◡', '⊙', '◠'],
+  squareCorners: ['◰', '◳', '◲', '◱'],
+  circleQuarters: ['◴', '◷', '◶', '◵'],
+  circleHalves: ['◐', '◓', '◑', '◒'],
+  squish: ['╫', '╪'],
+  toggle: ['⊶', '⊷'],
+  toggle2: ['▫', '▪'],
+  toggle3: ['□', '■'],
+  toggle4: ['■', '□', '▪', '▫'],
+  toggle5: ['▮', '▯'],
+  toggle6: ['ဝ', '၀'],
+  toggle7: ['⦾', '⦿'],
+  toggle8: ['◍', '◌'],
+  toggle9: ['◉', '◎'],
+  toggle10: ['㊂', '㊀', '㊁'],
+  toggle11: ['⬇', '⬆'],
+  toggle12: ['▹', '▿', '◃'],
+  toggle13: ['▁', '▂', '▃', '▄', '▅', '▆', '▇', '█', '▉', '▊', '▋', '▌', '▍', '▎', '▏', '▎', '▍', '▌', '▋', '▊', '▉', '█', '▇', '▆', '▅', '▄', '▃', '▂', '▁'],
+}
+
+// Default export
+export default {
+  stringWidth,
+  useTerminalSize,
+  KeyCodes,
+  SPINNER_FRAMES,
+}