@cli-use/tui 0.1.0

package/dist/hooks/index.js

@@ -0,0 +1,280 @@
+/**
+ * @license MIT
+ * cli-use - React-based Terminal UI Framework
+ * Inspired by Ratatui (https://ratatui.rs)
+ */
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/hooks/useApp.ts
+import { useEffect, useState, useRef } from "react";
+var useApp = (options = {}) => {
+  const rendererRef = useRef(null);
+  const [size, setSize] = useState({ cols: 80, rows: 24 });
+  const [running, setRunning] = useState(false);
+  useEffect(() => {
+    const cleanupResize = () => {
+    };
+    setRunning(true);
+    return () => {
+      setRunning(false);
+      cleanupResize();
+    };
+  }, []);
+  const exit = () => {
+    if (rendererRef.current) {
+      setRunning(false);
+    }
+  };
+  return {
+    renderer: rendererRef.current,
+    size,
+    running,
+    exit
+  };
+};
+
+// src/hooks/useInput.ts
+import { useEffect as useEffect2, useCallback } from "react";
+var useInput = (callback, deps = []) => {
+  useEffect2(() => {
+    const readline = __require("readline");
+    const handler = (chunk, key) => {
+      if (!key) return;
+      callback({
+        key: key.name || "",
+        name: key.name || "",
+        ctrl: key.ctrl || false,
+        meta: key.meta || false,
+        shift: key.shift || false,
+        sequence: key.sequence || ""
+      });
+    };
+    process.stdin.setRawMode(true);
+    readline.emitKeypressEvents(process.stdin);
+    process.stdin.on("keypress", handler);
+    return () => {
+      process.stdin.off("keypress", handler);
+    };
+  }, [callback, ...deps]);
+};
+var useKey = (keyName, callback, deps = []) => {
+  const keys = Array.isArray(keyName) ? keyName : [keyName];
+  useInput(
+    useCallback(
+      ({ key, ctrl, meta }) => {
+        if (ctrl || meta) return;
+        if (keys.includes(key)) {
+          callback();
+        }
+      },
+      [callback, keys]
+    ),
+    deps
+  );
+};
+
+// src/hooks/useFocus.ts
+import { useState as useState2, useCallback as useCallback2, useRef as useRef2, useEffect as useEffect3 } from "react";
+var useFocus = (initialFocus = 0, itemCount) => {
+  const [focusedIndex, setFocusedIndex] = useState2(initialFocus);
+  const focusableRefs = useRef2(/* @__PURE__ */ new Map());
+  const focusNext = useCallback2(() => {
+    setFocusedIndex((current) => (current + 1) % itemCount);
+  }, [itemCount]);
+  const focusPrevious = useCallback2(() => {
+    setFocusedIndex((current) => (current - 1 + itemCount) % itemCount);
+  }, [itemCount]);
+  const setFocus = useCallback2((index) => {
+    if (index >= 0 && index < itemCount) {
+      setFocusedIndex(index);
+    }
+  }, [itemCount]);
+  const isFocused = useCallback2(
+    (index) => index === focusedIndex,
+    [focusedIndex]
+  );
+  useEffect3(() => {
+    const readline = __require("readline");
+    readline.emitKeypressEvents(process.stdin);
+    process.stdin.setRawMode(true);
+    const handleKeyPress = (_chunk, key) => {
+      if (key.name === "tab" || key.name === "right") {
+        focusNext();
+      } else if (key.name === "left") {
+        focusPrevious();
+      }
+    };
+    process.stdin.on("keypress", handleKeyPress);
+    return () => {
+      process.stdin.off("keypress", handleKeyPress);
+    };
+  }, [focusNext, focusPrevious]);
+  return {
+    focusedIndex,
+    focusNext,
+    focusPrevious,
+    setFocus,
+    isFocused
+  };
+};
+
+// src/hooks/useStdout.ts
+import { useCallback as useCallback3, useEffect as useEffect4, useState as useState3 } from "react";
+var useStdoutDimensions = () => {
+  const [dimensions, setDimensions] = useState3(() => ({
+    columns: process.stdout.columns || 80,
+    rows: process.stdout.rows || 24
+  }));
+  useEffect4(() => {
+    const handleResize = () => {
+      setDimensions({
+        columns: process.stdout.columns || 80,
+        rows: process.stdout.rows || 24
+      });
+    };
+    process.stdout.on("resize", handleResize);
+    return () => {
+      process.stdout.off("resize", handleResize);
+    };
+  }, []);
+  return dimensions;
+};
+var useStdout = () => {
+  const write = useCallback3((data) => {
+    process.stdout.write(data);
+  }, []);
+  return { write };
+};
+
+// src/hooks/useInterval.ts
+import { useEffect as useEffect5, useRef as useRef3 } from "react";
+var useInterval = (callback, delay) => {
+  const savedCallback = useRef3(callback);
+  useEffect5(() => {
+    savedCallback.current = callback;
+  }, [callback]);
+  useEffect5(() => {
+    if (delay === null) return;
+    const tick = () => savedCallback.current();
+    const id = setInterval(tick, delay);
+    return () => clearInterval(id);
+  }, [delay]);
+};
+var useTimeout = (callback, delay) => {
+  const savedCallback = useRef3(callback);
+  useEffect5(() => {
+    savedCallback.current = callback;
+  }, [callback]);
+  useEffect5(() => {
+    if (delay === null) return;
+    const tick = () => savedCallback.current();
+    const id = setTimeout(tick, delay);
+    return () => clearTimeout(id);
+  }, [delay]);
+};
+
+// src/hooks/useAppState.ts
+import { useState as useState4, useCallback as useCallback4 } from "react";
+var useAppState = (initialState = "idle") => {
+  const [state, setState] = useState4(initialState);
+  const [error, setError] = useState4(null);
+  const setLoading = useCallback4(() => {
+    setState("loading");
+    setError(null);
+  }, []);
+  const setSuccess = useCallback4(() => {
+    setState("success");
+    setError(null);
+  }, []);
+  const setErrorState = useCallback4((err) => {
+    setState("error");
+    setError(err);
+  }, []);
+  const setIdle = useCallback4(() => {
+    setState("idle");
+    setError(null);
+  }, []);
+  const isLoading = state === "loading";
+  const isSuccess = state === "success";
+  const isError = state === "error";
+  const isIdle = state === "idle";
+  return {
+    state,
+    error,
+    isLoading,
+    isSuccess,
+    isError,
+    isIdle,
+    setLoading,
+    setSuccess,
+    setError: setErrorState,
+    setIdle
+  };
+};
+
+// src/hooks/useList.ts
+import { useState as useState5, useCallback as useCallback5 } from "react";
+var useList = ({
+  initialItems = [],
+  initialIndex = 0,
+  loop = true
+} = {}) => {
+  const [items, setItems] = useState5(initialItems);
+  const [index, setIndex] = useState5(initialIndex);
+  const next = useCallback5(() => {
+    setIndex((current) => {
+      if (items.length === 0) return 0;
+      const nextIndex = current + 1;
+      if (nextIndex >= items.length) {
+        return loop ? 0 : items.length - 1;
+      }
+      return nextIndex;
+    });
+  }, [items.length, loop]);
+  const previous = useCallback5(() => {
+    setIndex((current) => {
+      if (items.length === 0) return 0;
+      const prevIndex = current - 1;
+      if (prevIndex < 0) {
+        return loop ? items.length - 1 : 0;
+      }
+      return prevIndex;
+    });
+  }, [items.length, loop]);
+  const select = useCallback5((item) => {
+    const newIndex = items.indexOf(item);
+    if (newIndex !== -1) {
+      setIndex(newIndex);
+    }
+  }, [items]);
+  const selectedIndex = index;
+  const selectedItem = items[index] ?? null;
+  return {
+    items,
+    setItems,
+    index: selectedIndex,
+    setIndex,
+    selectedItem,
+    next,
+    previous,
+    select
+  };
+};
+export {
+  useApp,
+  useAppState,
+  useFocus,
+  useInput,
+  useInterval,
+  useKey,
+  useList,
+  useStdout,
+  useStdoutDimensions,
+  useTimeout
+};
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useApp.ts","../../src/hooks/useInput.ts","../../src/hooks/useFocus.ts","../../src/hooks/useStdout.ts","../../src/hooks/useInterval.ts","../../src/hooks/useAppState.ts","../../src/hooks/useList.ts"],"sourcesContent":["import { Renderer } from '../renderer/index.js';\nimport { useEffect, useState, useRef } from 'react';\n\ninterface AppOptions {\n  fullscreen?: boolean;\n  alternateScreen?: boolean;\n  mouseCapture?: boolean;\n}\n\n/**\n * useApp - Hook for managing the application lifecycle\n */\nexport const useApp = (options: AppOptions = {}) => {\n  const rendererRef = useRef<Renderer | null>(null);\n  const [size, setSize] = useState({ cols: 80, rows: 24 });\n  const [running, setRunning] = useState(false);\n\n  useEffect(() => {\n    // Note: Renderer is not fully implemented yet, this is a skeleton\n    // const renderer = new Renderer();\n    // rendererRef.current = renderer;\n    //\n    // renderer.start();\n    //\n    // // Set initial size\n    // setSize(renderer.getSize());\n    //\n    // // Setup resize handler\n    // const cleanupResize = renderer.getTerminal().onResize((newSize) => {\n    //   setSize(newSize);\n    // });\n    //\n    // setRunning(true);\n\n    const cleanupResize = () => {\n      // Cleanup function\n    };\n\n    setRunning(true);\n\n    return () => {\n      setRunning(false);\n      cleanupResize();\n      // renderer.stop();\n    };\n  }, []);\n\n  const exit = () => {\n    if (rendererRef.current) {\n      // rendererRef.current.stop();\n      setRunning(false);\n    }\n  };\n\n  return {\n    renderer: rendererRef.current,\n    size,\n    running,\n    exit,\n  };\n};\n","import { useEffect, useCallback } from 'react';\n\ninterface InputEvent {\n  key: string;\n  name: string;\n  ctrl: boolean;\n  meta: boolean;\n  shift: boolean;\n  sequence: string;\n}\n\ninterface ReadlineKey {\n  name?: string;\n  ctrl?: boolean;\n  meta?: boolean;\n  shift?: boolean;\n  sequence?: string;\n}\n\ntype InputCallback = (input: InputEvent) => void;\n\n/**\n * useInput - Hook for capturing keyboard input\n */\nexport const useInput = (callback: InputCallback, deps: any[] = []) => {\n  useEffect(() => {\n    const readline = require('node:readline');\n\n    const handler = (chunk: Buffer, key: ReadlineKey) => {\n      if (!key) return;\n\n      callback({\n        key: key.name || '',\n        name: key.name || '',\n        ctrl: key.ctrl || false,\n        meta: key.meta || false,\n        shift: key.shift || false,\n        sequence: key.sequence || '',\n      });\n    };\n\n    process.stdin.setRawMode(true);\n    readline.emitKeypressEvents(process.stdin);\n\n    process.stdin.on('keypress', handler);\n\n    return () => {\n      process.stdin.off('keypress', handler);\n    };\n  }, [callback, ...deps]);\n};\n\n/**\n * useKey - Hook for capturing specific key presses\n */\nexport const useKey = (\n  keyName: string | string[],\n  callback: () => void,\n  deps: any[] = []\n) => {\n  const keys = Array.isArray(keyName) ? keyName : [keyName];\n\n  useInput(\n    useCallback(\n      ({ key, ctrl, meta }) => {\n        // Don't trigger if modifier keys are pressed (unless specified)\n        if (ctrl || meta) return;\n\n        if (keys.includes(key)) {\n          callback();\n        }\n      },\n      [callback, keys]\n    ),\n    deps\n  );\n};\n","import { useState, useCallback, useRef, useEffect } from 'react';\n\ninterface FocusableElement {\n  id: string;\n  index: number;\n}\n\ninterface KeyPressEvent {\n  name?: string;\n}\n\n/**\n * useFocus - Hook for managing focus state in forms and lists\n */\nexport const useFocus = (initialFocus = 0, itemCount: number) => {\n  const [focusedIndex, setFocusedIndex] = useState(initialFocus);\n  const focusableRefs = useRef<Map<number, HTMLElement>>(new Map());\n\n  const focusNext = useCallback(() => {\n    setFocusedIndex((current) => (current + 1) % itemCount);\n  }, [itemCount]);\n\n  const focusPrevious = useCallback(() => {\n    setFocusedIndex((current) => (current - 1 + itemCount) % itemCount);\n  }, [itemCount]);\n\n  const setFocus = useCallback((index: number) => {\n    if (index >= 0 && index < itemCount) {\n      setFocusedIndex(index);\n    }\n  }, [itemCount]);\n\n  const isFocused = useCallback(\n    (index: number) => index === focusedIndex,\n    [focusedIndex]\n  );\n\n  // Keyboard navigation\n  useEffect(() => {\n    const readline = require('node:readline');\n    readline.emitKeypressEvents(process.stdin);\n    process.stdin.setRawMode(true);\n\n    const handleKeyPress = (_chunk: Buffer, key: KeyPressEvent) => {\n      if (key.name === 'tab' || key.name === 'right') {\n        focusNext();\n      } else if (key.name === 'left') {\n        focusPrevious();\n      }\n    };\n\n    process.stdin.on('keypress', handleKeyPress);\n\n    return () => {\n      process.stdin.off('keypress', handleKeyPress);\n    };\n  }, [focusNext, focusPrevious]);\n\n  return {\n    focusedIndex,\n    focusNext,\n    focusPrevious,\n    setFocus,\n    isFocused,\n  };\n};\n","import { useCallback, useEffect, useState } from 'react';\n\n/**\n * useStdoutDimensions - Hook for getting terminal dimensions\n */\nexport const useStdoutDimensions = () => {\n  const [dimensions, setDimensions] = useState(() => ({\n    columns: process.stdout.columns || 80,\n    rows: process.stdout.rows || 24,\n  }));\n\n  useEffect(() => {\n    const handleResize = () => {\n      setDimensions({\n        columns: process.stdout.columns || 80,\n        rows: process.stdout.rows || 24,\n      });\n    };\n\n    process.stdout.on('resize', handleResize);\n\n    return () => {\n      process.stdout.off('resize', handleResize);\n    };\n  }, []);\n\n  return dimensions;\n};\n\n/**\n * useStdout - Hook for stdout operations\n */\nexport const useStdout = () => {\n  const write = useCallback((data: string) => {\n    process.stdout.write(data);\n  }, []);\n\n  return { write };\n};\n","import { useEffect, useRef } from 'react';\n\n/**\n * useInterval - Hook for setting up intervals\n */\nexport const useInterval = (callback: () => void, delay: number | null) => {\n  const savedCallback = useRef(callback);\n\n  // Remember the latest callback\n  useEffect(() => {\n    savedCallback.current = callback;\n  }, [callback]);\n\n  // Set up the interval\n  useEffect(() => {\n    if (delay === null) return;\n\n    const tick = () => savedCallback.current();\n\n    const id = setInterval(tick, delay);\n\n    return () => clearInterval(id);\n  }, [delay]);\n};\n\n/**\n * useTimeout - Hook for setting up timeouts\n */\nexport const useTimeout = (callback: () => void, delay: number | null) => {\n  const savedCallback = useRef(callback);\n\n  useEffect(() => {\n    savedCallback.current = callback;\n  }, [callback]);\n\n  useEffect(() => {\n    if (delay === null) return;\n\n    const tick = () => savedCallback.current();\n\n    const id = setTimeout(tick, delay);\n\n    return () => clearTimeout(id);\n  }, [delay]);\n};\n","import { useState, useCallback } from 'react';\n\ntype AppState = 'idle' | 'loading' | 'success' | 'error';\n\n/**\n * useAppState - Hook for managing application state\n */\nexport const useAppState = (initialState: AppState = 'idle') => {\n  const [state, setState] = useState<AppState>(initialState);\n  const [error, setError] = useState<Error | null>(null);\n\n  const setLoading = useCallback(() => {\n    setState('loading');\n    setError(null);\n  }, []);\n\n  const setSuccess = useCallback(() => {\n    setState('success');\n    setError(null);\n  }, []);\n\n  const setErrorState = useCallback((err: Error) => {\n    setState('error');\n    setError(err);\n  }, []);\n\n  const setIdle = useCallback(() => {\n    setState('idle');\n    setError(null);\n  }, []);\n\n  const isLoading = state === 'loading';\n  const isSuccess = state === 'success';\n  const isError = state === 'error';\n  const isIdle = state === 'idle';\n\n  return {\n    state,\n    error,\n    isLoading,\n    isSuccess,\n    isError,\n    isIdle,\n    setLoading,\n    setSuccess,\n    setError: setErrorState,\n    setIdle,\n  };\n};\n","import { useState, useCallback } from 'react';\n\ninterface ListOptions<T> {\n  initialItems?: T[];\n  initialIndex?: number;\n  loop?: boolean;\n}\n\n/**\n * useList - Hook for managing list navigation\n */\nexport const useList = <T>({\n  initialItems = [],\n  initialIndex = 0,\n  loop = true,\n}: ListOptions<T> = {}) => {\n  const [items, setItems] = useState<T[]>(initialItems);\n  const [index, setIndex] = useState(initialIndex);\n\n  const next = useCallback(() => {\n    setIndex((current) => {\n      if (items.length === 0) return 0;\n\n      const nextIndex = current + 1;\n\n      if (nextIndex >= items.length) {\n        return loop ? 0 : items.length - 1;\n      }\n\n      return nextIndex;\n    });\n  }, [items.length, loop]);\n\n  const previous = useCallback(() => {\n    setIndex((current) => {\n      if (items.length === 0) return 0;\n\n      const prevIndex = current - 1;\n\n      if (prevIndex < 0) {\n        return loop ? items.length - 1 : 0;\n      }\n\n      return prevIndex;\n    });\n  }, [items.length, loop]);\n\n  const select = useCallback((item: T) => {\n    const newIndex = items.indexOf(item);\n    if (newIndex !== -1) {\n      setIndex(newIndex);\n    }\n  }, [items]);\n\n  const selectedIndex = index;\n  const selectedItem = items[index] ?? null;\n\n  return {\n    items,\n    setItems,\n    index: selectedIndex,\n    setIndex,\n    selectedItem,\n    next,\n    previous,\n    select,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;AACA,SAAS,WAAW,UAAU,cAAc;AAWrC,IAAM,SAAS,CAAC,UAAsB,CAAC,MAAM;AAClD,QAAM,cAAc,OAAwB,IAAI;AAChD,QAAM,CAAC,MAAM,OAAO,IAAI,SAAS,EAAE,MAAM,IAAI,MAAM,GAAG,CAAC;AACvD,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,KAAK;AAE5C,YAAU,MAAM;AAiBd,UAAM,gBAAgB,MAAM;AAAA,IAE5B;AAEA,eAAW,IAAI;AAEf,WAAO,MAAM;AACX,iBAAW,KAAK;AAChB,oBAAc;AAAA,IAEhB;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,QAAM,OAAO,MAAM;AACjB,QAAI,YAAY,SAAS;AAEvB,iBAAW,KAAK;AAAA,IAClB;AAAA,EACF;AAEA,SAAO;AAAA,IACL,UAAU,YAAY;AAAA,IACtB;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;;;AC5DA,SAAS,aAAAA,YAAW,mBAAmB;AAwBhC,IAAM,WAAW,CAAC,UAAyB,OAAc,CAAC,MAAM;AACrE,EAAAA,WAAU,MAAM;AACd,UAAM,WAAW,UAAQ,UAAe;AAExC,UAAM,UAAU,CAAC,OAAe,QAAqB;AACnD,UAAI,CAAC,IAAK;AAEV,eAAS;AAAA,QACP,KAAK,IAAI,QAAQ;AAAA,QACjB,MAAM,IAAI,QAAQ;AAAA,QAClB,MAAM,IAAI,QAAQ;AAAA,QAClB,MAAM,IAAI,QAAQ;AAAA,QAClB,OAAO,IAAI,SAAS;AAAA,QACpB,UAAU,IAAI,YAAY;AAAA,MAC5B,CAAC;AAAA,IACH;AAEA,YAAQ,MAAM,WAAW,IAAI;AAC7B,aAAS,mBAAmB,QAAQ,KAAK;AAEzC,YAAQ,MAAM,GAAG,YAAY,OAAO;AAEpC,WAAO,MAAM;AACX,cAAQ,MAAM,IAAI,YAAY,OAAO;AAAA,IACvC;AAAA,EACF,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC;AACxB;AAKO,IAAM,SAAS,CACpB,SACA,UACA,OAAc,CAAC,MACZ;AACH,QAAM,OAAO,MAAM,QAAQ,OAAO,IAAI,UAAU,CAAC,OAAO;AAExD;AAAA,IACE;AAAA,MACE,CAAC,EAAE,KAAK,MAAM,KAAK,MAAM;AAEvB,YAAI,QAAQ,KAAM;AAElB,YAAI,KAAK,SAAS,GAAG,GAAG;AACtB,mBAAS;AAAA,QACX;AAAA,MACF;AAAA,MACA,CAAC,UAAU,IAAI;AAAA,IACjB;AAAA,IACA;AAAA,EACF;AACF;;;AC5EA,SAAS,YAAAC,WAAU,eAAAC,cAAa,UAAAC,SAAQ,aAAAC,kBAAiB;AAclD,IAAM,WAAW,CAAC,eAAe,GAAG,cAAsB;AAC/D,QAAM,CAAC,cAAc,eAAe,IAAIH,UAAS,YAAY;AAC7D,QAAM,gBAAgBE,QAAiC,oBAAI,IAAI,CAAC;AAEhE,QAAM,YAAYD,aAAY,MAAM;AAClC,oBAAgB,CAAC,aAAa,UAAU,KAAK,SAAS;AAAA,EACxD,GAAG,CAAC,SAAS,CAAC;AAEd,QAAM,gBAAgBA,aAAY,MAAM;AACtC,oBAAgB,CAAC,aAAa,UAAU,IAAI,aAAa,SAAS;AAAA,EACpE,GAAG,CAAC,SAAS,CAAC;AAEd,QAAM,WAAWA,aAAY,CAAC,UAAkB;AAC9C,QAAI,SAAS,KAAK,QAAQ,WAAW;AACnC,sBAAgB,KAAK;AAAA,IACvB;AAAA,EACF,GAAG,CAAC,SAAS,CAAC;AAEd,QAAM,YAAYA;AAAA,IAChB,CAAC,UAAkB,UAAU;AAAA,IAC7B,CAAC,YAAY;AAAA,EACf;AAGA,EAAAE,WAAU,MAAM;AACd,UAAM,WAAW,UAAQ,UAAe;AACxC,aAAS,mBAAmB,QAAQ,KAAK;AACzC,YAAQ,MAAM,WAAW,IAAI;AAE7B,UAAM,iBAAiB,CAAC,QAAgB,QAAuB;AAC7D,UAAI,IAAI,SAAS,SAAS,IAAI,SAAS,SAAS;AAC9C,kBAAU;AAAA,MACZ,WAAW,IAAI,SAAS,QAAQ;AAC9B,sBAAc;AAAA,MAChB;AAAA,IACF;AAEA,YAAQ,MAAM,GAAG,YAAY,cAAc;AAE3C,WAAO,MAAM;AACX,cAAQ,MAAM,IAAI,YAAY,cAAc;AAAA,IAC9C;AAAA,EACF,GAAG,CAAC,WAAW,aAAa,CAAC;AAE7B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;;;ACjEA,SAAS,eAAAC,cAAa,aAAAC,YAAW,YAAAC,iBAAgB;AAK1C,IAAM,sBAAsB,MAAM;AACvC,QAAM,CAAC,YAAY,aAAa,IAAIA,UAAS,OAAO;AAAA,IAClD,SAAS,QAAQ,OAAO,WAAW;AAAA,IACnC,MAAM,QAAQ,OAAO,QAAQ;AAAA,EAC/B,EAAE;AAEF,EAAAD,WAAU,MAAM;AACd,UAAM,eAAe,MAAM;AACzB,oBAAc;AAAA,QACZ,SAAS,QAAQ,OAAO,WAAW;AAAA,QACnC,MAAM,QAAQ,OAAO,QAAQ;AAAA,MAC/B,CAAC;AAAA,IACH;AAEA,YAAQ,OAAO,GAAG,UAAU,YAAY;AAExC,WAAO,MAAM;AACX,cAAQ,OAAO,IAAI,UAAU,YAAY;AAAA,IAC3C;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,SAAO;AACT;AAKO,IAAM,YAAY,MAAM;AAC7B,QAAM,QAAQD,aAAY,CAAC,SAAiB;AAC1C,YAAQ,OAAO,MAAM,IAAI;AAAA,EAC3B,GAAG,CAAC,CAAC;AAEL,SAAO,EAAE,MAAM;AACjB;;;ACtCA,SAAS,aAAAG,YAAW,UAAAC,eAAc;AAK3B,IAAM,cAAc,CAAC,UAAsB,UAAyB;AACzE,QAAM,gBAAgBA,QAAO,QAAQ;AAGrC,EAAAD,WAAU,MAAM;AACd,kBAAc,UAAU;AAAA,EAC1B,GAAG,CAAC,QAAQ,CAAC;AAGb,EAAAA,WAAU,MAAM;AACd,QAAI,UAAU,KAAM;AAEpB,UAAM,OAAO,MAAM,cAAc,QAAQ;AAEzC,UAAM,KAAK,YAAY,MAAM,KAAK;AAElC,WAAO,MAAM,cAAc,EAAE;AAAA,EAC/B,GAAG,CAAC,KAAK,CAAC;AACZ;AAKO,IAAM,aAAa,CAAC,UAAsB,UAAyB;AACxE,QAAM,gBAAgBC,QAAO,QAAQ;AAErC,EAAAD,WAAU,MAAM;AACd,kBAAc,UAAU;AAAA,EAC1B,GAAG,CAAC,QAAQ,CAAC;AAEb,EAAAA,WAAU,MAAM;AACd,QAAI,UAAU,KAAM;AAEpB,UAAM,OAAO,MAAM,cAAc,QAAQ;AAEzC,UAAM,KAAK,WAAW,MAAM,KAAK;AAEjC,WAAO,MAAM,aAAa,EAAE;AAAA,EAC9B,GAAG,CAAC,KAAK,CAAC;AACZ;;;AC5CA,SAAS,YAAAE,WAAU,eAAAC,oBAAmB;AAO/B,IAAM,cAAc,CAAC,eAAyB,WAAW;AAC9D,QAAM,CAAC,OAAO,QAAQ,IAAID,UAAmB,YAAY;AACzD,QAAM,CAAC,OAAO,QAAQ,IAAIA,UAAuB,IAAI;AAErD,QAAM,aAAaC,aAAY,MAAM;AACnC,aAAS,SAAS;AAClB,aAAS,IAAI;AAAA,EACf,GAAG,CAAC,CAAC;AAEL,QAAM,aAAaA,aAAY,MAAM;AACnC,aAAS,SAAS;AAClB,aAAS,IAAI;AAAA,EACf,GAAG,CAAC,CAAC;AAEL,QAAM,gBAAgBA,aAAY,CAAC,QAAe;AAChD,aAAS,OAAO;AAChB,aAAS,GAAG;AAAA,EACd,GAAG,CAAC,CAAC;AAEL,QAAM,UAAUA,aAAY,MAAM;AAChC,aAAS,MAAM;AACf,aAAS,IAAI;AAAA,EACf,GAAG,CAAC,CAAC;AAEL,QAAM,YAAY,UAAU;AAC5B,QAAM,YAAY,UAAU;AAC5B,QAAM,UAAU,UAAU;AAC1B,QAAM,SAAS,UAAU;AAEzB,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,UAAU;AAAA,IACV;AAAA,EACF;AACF;;;AChDA,SAAS,YAAAC,WAAU,eAAAC,oBAAmB;AAW/B,IAAM,UAAU,CAAI;AAAA,EACzB,eAAe,CAAC;AAAA,EAChB,eAAe;AAAA,EACf,OAAO;AACT,IAAoB,CAAC,MAAM;AACzB,QAAM,CAAC,OAAO,QAAQ,IAAID,UAAc,YAAY;AACpD,QAAM,CAAC,OAAO,QAAQ,IAAIA,UAAS,YAAY;AAE/C,QAAM,OAAOC,aAAY,MAAM;AAC7B,aAAS,CAAC,YAAY;AACpB,UAAI,MAAM,WAAW,EAAG,QAAO;AAE/B,YAAM,YAAY,UAAU;AAE5B,UAAI,aAAa,MAAM,QAAQ;AAC7B,eAAO,OAAO,IAAI,MAAM,SAAS;AAAA,MACnC;AAEA,aAAO;AAAA,IACT,CAAC;AAAA,EACH,GAAG,CAAC,MAAM,QAAQ,IAAI,CAAC;AAEvB,QAAM,WAAWA,aAAY,MAAM;AACjC,aAAS,CAAC,YAAY;AACpB,UAAI,MAAM,WAAW,EAAG,QAAO;AAE/B,YAAM,YAAY,UAAU;AAE5B,UAAI,YAAY,GAAG;AACjB,eAAO,OAAO,MAAM,SAAS,IAAI;AAAA,MACnC;AAEA,aAAO;AAAA,IACT,CAAC;AAAA,EACH,GAAG,CAAC,MAAM,QAAQ,IAAI,CAAC;AAEvB,QAAM,SAASA,aAAY,CAAC,SAAY;AACtC,UAAM,WAAW,MAAM,QAAQ,IAAI;AACnC,QAAI,aAAa,IAAI;AACnB,eAAS,QAAQ;AAAA,IACnB;AAAA,EACF,GAAG,CAAC,KAAK,CAAC;AAEV,QAAM,gBAAgB;AACtB,QAAM,eAAe,MAAM,KAAK,KAAK;AAErC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":["useEffect","useState","useCallback","useRef","useEffect","useCallback","useEffect","useState","useEffect","useRef","useState","useCallback","useState","useCallback"]}

package/dist/index-DAO84gkm.d.cts

@@ -0,0 +1,272 @@
+import { ReadStream, WriteStream } from 'node:tty';
+import * as readline from 'node:readline';
+import * as React from 'react';
+
+/**
+ * Terminal cell representation
+ */
+interface Cell {
+    char: string;
+    fg?: number;
+    bg?: number;
+    bold?: boolean;
+    dim?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    strikethrough?: boolean;
+}
+/**
+ * Terminal buffer - a 2D grid of cells
+ */
+declare class Buffer {
+    width: number;
+    height: number;
+    cells: Cell[][];
+    constructor(width: number, height: number, cells?: Cell[][]);
+    setCell(x: number, y: number, cell: Cell): void;
+    getCell(x: number, y: number): Cell | undefined;
+    clear(): void;
+    resize(width: number, height: number): void;
+    clone(): Buffer;
+}
+/**
+ * Terminal size
+ */
+interface Size {
+    cols: number;
+    rows: number;
+}
+
+type ProcessStdin = ReadStream & NodeJS.ReadStream;
+type ProcessStdout = WriteStream & NodeJS.WriteStream;
+/**
+ * ANSI escape codes for terminal control
+ */
+declare const ANSI: {
+    readonly CLEAR_SCREEN: "\u001B[2J";
+    readonly RESET_CURSOR: "\u001B[H";
+    readonly ALTERNATE_SCREEN_ENABLE: "\u001B[?1049h";
+    readonly ALTERNATE_SCREEN_DISABLE: "\u001B[?1049l";
+    readonly HIDE_CURSOR: "\u001B[?25l";
+    readonly SHOW_CURSOR: "\u001B[?25h";
+    readonly MOVE_CURSOR: (x: number, y: number) => string;
+    readonly RESET_STYLE: "\u001B[0m";
+    readonly FG_COLOR_256: (color: number) => string;
+    readonly BG_COLOR_256: (color: number) => string;
+    readonly FG_COLOR_RGB: (r: number, g: number, b: number) => string;
+    readonly BG_COLOR_RGB: (r: number, g: number, b: number) => string;
+    readonly BOLD: "\u001B[1m";
+    readonly DIM: "\u001B[2m";
+    readonly ITALIC: "\u001B[3m";
+    readonly UNDERLINE: "\u001B[4m";
+    readonly STRIKETHROUGH: "\u001B[9m";
+    readonly BOLD_OFF: "\u001B[22m";
+    readonly DIM_OFF: "\u001B[22m";
+    readonly ITALIC_OFF: "\u001B[23m";
+    readonly UNDERLINE_OFF: "\u001B[24m";
+    readonly STRIKETHROUGH_OFF: "\u001B[29m";
+};
+/**
+ * Terminal interface - handles low-level terminal I/O
+ */
+declare class Terminal {
+    private stdin;
+    private stdout;
+    private _size;
+    private rawMode;
+    private alternateScreen;
+    constructor(stdin?: ProcessStdin, stdout?: ProcessStdout);
+    get size(): Size;
+    /**
+     * Enable raw mode for character-by-character input
+     */
+    enableRawMode(): void;
+    /**
+     * Disable raw mode
+     */
+    disableRawMode(): void;
+    /**
+     * Enable alternate screen buffer
+     */
+    enableAlternateScreen(): void;
+    /**
+     * Disable alternate screen buffer
+     */
+    disableAlternateScreen(): void;
+    /**
+     * Hide cursor
+     */
+    hideCursor(): void;
+    /**
+     * Show cursor
+     */
+    showCursor(): void;
+    /**
+     * Clear the entire screen
+     */
+    clear(): void;
+    /**
+     * Write buffer to terminal
+     */
+    write(buffer: Buffer): void;
+    /**
+     * Build ANSI style string from cell
+     */
+    private buildStyleString;
+    /**
+     * Set up SIGWINCH handler for terminal resize
+     */
+    onResize(callback: (size: Size) => void): () => void;
+    /**
+     * Set up input handler
+     */
+    onInput(callback: (chunk: Buffer, key: readline.Key) => void): () => void;
+    /**
+     * Clean up terminal state
+     */
+    restore(): void;
+}
+
+/**
+ * Renderer - manages the rendering lifecycle
+ */
+declare class Renderer {
+    private terminal;
+    private buffer?;
+    private previousBuffer?;
+    private currentSize;
+    private running;
+    constructor(terminal?: Terminal);
+    /**
+     * Start the renderer
+     */
+    start(): void;
+    /**
+     * Stop the renderer
+     */
+    stop(): void;
+    /**
+     * Get a writable buffer for the current frame
+     */
+    getBuffer(): Buffer;
+    /**
+     * Present the current buffer to the terminal
+     */
+    present(): void;
+    /**
+     * Get the current terminal size
+     */
+    getSize(): Size;
+    /**
+     * Get the terminal instance for direct access
+     */
+    getTerminal(): Terminal;
+}
+
+interface AppOptions {
+    fullscreen?: boolean;
+    alternateScreen?: boolean;
+    mouseCapture?: boolean;
+}
+/**
+ * useApp - Hook for managing the application lifecycle
+ */
+declare const useApp: (options?: AppOptions) => {
+    renderer: Renderer | null;
+    size: {
+        cols: number;
+        rows: number;
+    };
+    running: boolean;
+    exit: () => void;
+};
+
+interface InputEvent {
+    key: string;
+    name: string;
+    ctrl: boolean;
+    meta: boolean;
+    shift: boolean;
+    sequence: string;
+}
+type InputCallback = (input: InputEvent) => void;
+/**
+ * useInput - Hook for capturing keyboard input
+ */
+declare const useInput: (callback: InputCallback, deps?: any[]) => void;
+/**
+ * useKey - Hook for capturing specific key presses
+ */
+declare const useKey: (keyName: string | string[], callback: () => void, deps?: any[]) => void;
+
+/**
+ * useFocus - Hook for managing focus state in forms and lists
+ */
+declare const useFocus: (initialFocus: number | undefined, itemCount: number) => {
+    focusedIndex: number;
+    focusNext: () => void;
+    focusPrevious: () => void;
+    setFocus: (index: number) => void;
+    isFocused: (index: number) => boolean;
+};
+
+/**
+ * useStdoutDimensions - Hook for getting terminal dimensions
+ */
+declare const useStdoutDimensions: () => {
+    columns: number;
+    rows: number;
+};
+/**
+ * useStdout - Hook for stdout operations
+ */
+declare const useStdout: () => {
+    write: (data: string) => void;
+};
+
+/**
+ * useInterval - Hook for setting up intervals
+ */
+declare const useInterval: (callback: () => void, delay: number | null) => void;
+/**
+ * useTimeout - Hook for setting up timeouts
+ */
+declare const useTimeout: (callback: () => void, delay: number | null) => void;
+
+type AppState = 'idle' | 'loading' | 'success' | 'error';
+/**
+ * useAppState - Hook for managing application state
+ */
+declare const useAppState: (initialState?: AppState) => {
+    state: AppState;
+    error: Error | null;
+    isLoading: boolean;
+    isSuccess: boolean;
+    isError: boolean;
+    isIdle: boolean;
+    setLoading: () => void;
+    setSuccess: () => void;
+    setError: (err: Error) => void;
+    setIdle: () => void;
+};
+
+interface ListOptions<T> {
+    initialItems?: T[];
+    initialIndex?: number;
+    loop?: boolean;
+}
+/**
+ * useList - Hook for managing list navigation
+ */
+declare const useList: <T>({ initialItems, initialIndex, loop, }?: ListOptions<T>) => {
+    items: T[];
+    setItems: React.Dispatch<React.SetStateAction<T[]>>;
+    index: number;
+    setIndex: React.Dispatch<React.SetStateAction<number>>;
+    selectedItem: NonNullable<T> | null;
+    next: () => void;
+    previous: () => void;
+    select: (item: T) => void;
+};
+
+export { ANSI as A, Buffer as B, Renderer as R, Terminal as T, useAppState as a, useFocus as b, useInput as c, useInterval as d, useKey as e, useList as f, useStdout as g, useStdoutDimensions as h, useTimeout as i, useApp as u };