@visulima/tui 1.0.8 → 2.0.1

package/dist/ink/hooks/use-cursor.d.ts

@@ -1,12 +1,12 @@
 import 'node:stream';
-import { a as CursorPosition } from "../../packem_shared/cursor-helpers.d-BONB9tky.js";
+import { CursorPosition } from "../public/cursor.js";
 /**
-* A React hook that returns methods to control the terminal cursor position.
-*
-* Setting a cursor position makes the cursor visible at the specified coordinates (relative to the Ink output origin). This is useful for IME (Input Method Editor) support, where the composing character is displayed at the cursor location.
-*
-* Pass `undefined` to hide the cursor.
-*/
+ * A React hook that returns methods to control the terminal cursor position.
+ *
+ * Setting a cursor position makes the cursor visible at the specified coordinates (relative to the Ink output origin). This is useful for IME (Input Method Editor) support, where the composing character is displayed at the cursor location.
+ *
+ * Pass `undefined` to hide the cursor.
+ */
 declare const useCursor: () => {
   setCursorPosition: (position: CursorPosition | undefined) => void;
 };

package/dist/ink/hooks/use-focus-manager.d.ts

@@ -15,43 +15,43 @@ type Props = {
 };
 type Output = {
   /**
-  * The ID of the currently focused component, or `undefined` if no component is focused.
-  * @example
-  * ```tsx
-  * import {Text} from '@visulima/tui/components/text';
-  * import {useFocusManager} from '@visulima/tui/hooks/use-focus-manager';
-  *
-  * const Example = () => {
-  * const {activeId} = useFocusManager();
-  *
-  * return <Text>Focused: {activeId ?? 'none'}</Text>;
-  * };
-  * ```
-  */
+   * The ID of the currently focused component, or `undefined` if no component is focused.
+   * @example
+   * ```tsx
+   * import {Text} from '@visulima/tui/components/text';
+   * import {useFocusManager} from '@visulima/tui/hooks/use-focus-manager';
+   *
+   * const Example = () => {
+   * const {activeId} = useFocusManager();
+   *
+   * return <Text>Focused: {activeId ?? 'none'}</Text>;
+   * };
+   * ```
+   */
   activeId: Props["activeId"];
   /**
-  * Disable focus management for all components. The currently active component (if there's one) will lose its focus.
-  */
+   * Disable focus management for all components. The currently active component (if there's one) will lose its focus.
+   */
   disableFocus: Props["disableFocus"];
   /**
-  * Enable focus management for all components.
-  */
+   * Enable focus management for all components.
+   */
   enableFocus: Props["enableFocus"];
   /**
-  * Switch focus to the element with provided `id`. If there's no element with that `id`, focus is not changed.
-  */
+   * Switch focus to the element with provided `id`. If there's no element with that `id`, focus is not changed.
+   */
   focus: Props["focus"];
   /**
-  * Switch focus to the next focusable component. If there's no active component right now, focus will be given to the first focusable component. If the active component is the last in the list of focusable components, focus will be switched to the first focusable component.
-  */
+   * Switch focus to the next focusable component. If there's no active component right now, focus will be given to the first focusable component. If the active component is the last in the list of focusable components, focus will be switched to the first focusable component.
+   */
   focusNext: Props["focusNext"];
   /**
-  * Switch focus to the previous focusable component. If there's no active component right now, focus will be given to the first focusable component. If the active component is the first in the list of focusable components, focus will be switched to the last focusable component.
-  */
+   * Switch focus to the previous focusable component. If there's no active component right now, focus will be given to the first focusable component. If the active component is the first in the list of focusable components, focus will be switched to the last focusable component.
+   */
   focusPrevious: Props["focusPrevious"];
 };
 /**
-* A React hook that returns methods to enable or disable focus management for all components or manually switch focus to the next or previous components.
-*/
+ * A React hook that returns methods to enable or disable focus management for all components or manually switch focus to the next or previous components.
+ */
 declare const useFocusManager: () => Output;
 export { useFocusManager as default, useFocusManager };

package/dist/ink/hooks/use-focus.d.ts

@@ -1,34 +1,30 @@
 type Input = {
   /**
-  * Auto-focus this component if there's no active (focused) component right now.
-  */
+   * Auto-focus this component if there's no active (focused) component right now.
+   */
   autoFocus?: boolean;
   /**
-  * Assign an ID to this component, so it can be programmatically focused with `focus(id)`.
-  */
+   * Assign an ID to this component, so it can be programmatically focused with `focus(id)`.
+   */
   id?: string;
   /**
-  * Enable or disable this component's focus, while still maintaining its position in the list of focusable components.
-  */
+   * Enable or disable this component's focus, while still maintaining its position in the list of focusable components.
+   */
   isActive?: boolean;
 };
 type Output = {
   /**
-  * Allows focusing a specific element with the provided `id`.
-  */
+   * Allows focusing a specific element with the provided `id`.
+   */
   focus: (id: string) => void;
   /**
-  * Determines whether this component is focused.
-  */
+   * Determines whether this component is focused.
+   */
   isFocused: boolean;
 };
 /**
-* A React hook that returns focus state and focus controls for the current component.
-* A component that uses the `useFocus` hook becomes "focusable" to Ink, so when the user presses <kbd>Tab</kbd>, Ink will switch focus to this component. If there are multiple components that execute the `useFocus` hook, focus will be given to them in the order in which these components are rendered.
-*/
-declare const useFocus: ({
-  autoFocus,
-  id: customId,
-  isActive
-}?: Input) => Output;
+ * A React hook that returns focus state and focus controls for the current component.
+ * A component that uses the `useFocus` hook becomes "focusable" to Ink, so when the user presses <kbd>Tab</kbd>, Ink will switch focus to this component. If there are multiple components that execute the `useFocus` hook, focus will be given to them in the order in which these components are rendered.
+ */
+declare const useFocus: ({ autoFocus, id: customId, isActive }?: Input) => Output;
 export { useFocus as default, useFocus };

package/dist/ink/hooks/use-form.d.ts

@@ -2,67 +2,67 @@ type ValidationResult = string | undefined;
 type FieldValidator<V> = (value: V, values: Readonly<Record<string, unknown>>) => ValidationResult;
 type FieldConfig<V = unknown> = {
   /**
-  * Initial value.
-  */
+   * Initial value.
+   */
   readonly initialValue: V;
   /**
-  * Optional validator. Return a string to indicate an error; return
-  * `undefined` for valid.
-  */
+   * Optional validator. Return a string to indicate an error; return
+   * `undefined` for valid.
+   */
   readonly validate?: FieldValidator<V>;
 };
 type FormSchema = Readonly<Record<string, FieldConfig<never>>>;
-type FormValues<S extends Readonly<Record<string, FieldConfig>>> = { [K in keyof S]: S[K] extends FieldConfig<infer V> ? V : never };
+type FormValues<S extends Readonly<Record<string, FieldConfig>>> = { [K in keyof S]: S[K] extends FieldConfig<infer V> ? V : never; };
 type UseFormOptions<S extends Readonly<Record<string, FieldConfig>>> = {
   /**
-  * Field declarations.
-  */
+   * Field declarations.
+   */
   readonly fields: S;
   /**
-  * Called on submit if all fields validate.
-  */
+   * Called on submit if all fields validate.
+   */
   readonly onSubmit?: (values: FormValues<S>) => void | Promise<void>;
 };
 type UseFormResult<S extends Readonly<Record<string, FieldConfig>>> = {
   /**
-  * Map of fieldName -> validation error (if any).
-  */
+   * Map of fieldName -> validation error (if any).
+   */
   readonly errors: Readonly<Partial<Record<keyof S, string>>>;
   /**
-  * True while the last `submit()` is in-flight.
-  */
+   * True while the last `submit()` is in-flight.
+   */
   readonly isSubmitting: boolean;
   /**
-  * Reset all fields back to their initial values and clear errors / touched.
-  */
+   * Reset all fields back to their initial values and clear errors / touched.
+   */
   readonly reset: () => void;
   /**
-  * Mark a field as touched. Useful on blur.
-  */
+   * Mark a field as touched. Useful on blur.
+   */
   readonly setTouched: <K extends keyof S>(name: K, touched?: boolean) => void;
   /**
-  * Update a single field.
-  */
+   * Update a single field.
+   */
   readonly setValue: <K extends keyof S>(name: K, value: FormValues<S>[K]) => void;
   /**
-  * Trigger validation and call the `onSubmit` option. Returns true if
-  * submission succeeded (all fields valid).
-  */
+   * Trigger validation and call the `onSubmit` option. Returns true if
+   * submission succeeded (all fields valid).
+   */
   readonly submit: () => Promise<boolean>;
   /**
-  * Map of fieldName -> boolean. Field is considered touched after the
-  * first `setTouched(name)` or `submit()` invocation.
-  */
+   * Map of fieldName -> boolean. Field is considered touched after the
+   * first `setTouched(name)` or `submit()` invocation.
+   */
   readonly touched: Readonly<Partial<Record<keyof S, boolean>>>;
   /**
-  * Current values.
-  */
+   * Current values.
+   */
   readonly values: FormValues<S>;
 };
 /**
-* Minimal headless form state machine. Tracks values, touched state, errors,
-* and submission in-flight. Pair with `&lt;Form />` for default layout, or wire
-* up your own inputs directly.
-*/
+ * Minimal headless form state machine. Tracks values, touched state, errors,
+ * and submission in-flight. Pair with `&lt;Form />` for default layout, or wire
+ * up your own inputs directly.
+ */
 declare const useForm: <S extends Readonly<Record<string, FieldConfig>>>(options: UseFormOptions<S>) => UseFormResult<S>;
 export { FieldConfig, FieldValidator, FormSchema, FormValues, UseFormOptions, UseFormResult, ValidationResult, useForm as default, useForm };

package/dist/ink/hooks/use-hotkey.d.ts

@@ -1,37 +1,37 @@
 import { Key } from "./use-input.js";
 type HotkeyDescriptor = {
   /**
-  * Whether Ctrl must be held.
-  */
+   * Whether Ctrl must be held.
+   */
   readonly ctrl?: boolean;
   /**
-  * Character(s) to match after modifiers, e.g. `"s"`, `"?"`, `"k"`.
-  * Ignored if `name` is set.
-  */
+   * Character(s) to match after modifiers, e.g. `"s"`, `"?"`, `"k"`.
+   * Ignored if `name` is set.
+   */
   readonly input?: string;
   /**
-  * Whether Meta must be held.
-  */
+   * Whether Meta must be held.
+   */
   readonly meta?: boolean;
   /**
-  * Named special key, e.g. `"escape"`, `"return"`, `"tab"`, `"upArrow"`.
-  */
+   * Named special key, e.g. `"escape"`, `"return"`, `"tab"`, `"upArrow"`.
+   */
   readonly name?: keyof Key;
   /**
-  * Whether Shift must be held.
-  */
+   * Whether Shift must be held.
+   */
   readonly shift?: boolean;
 };
 type UseHotkeyOptions = {
   /**
-  * Disable the binding while keeping the component rendered.
-  * @default true
-  */
+   * Disable the binding while keeping the component rendered.
+   * @default true
+   */
   readonly isActive?: boolean;
 };
 /**
-* Bind a keyboard shortcut to a callback. Accepts either a short string
-* (`"ctrl+s"`, `"?"`, `"escape"`) or a structured descriptor.
-*/
+ * Bind a keyboard shortcut to a callback. Accepts either a short string
+ * (`"ctrl+s"`, `"?"`, `"escape"`) or a structured descriptor.
+ */
 declare const useHotkey: (shortcut: HotkeyDescriptor | string, callback: () => void, options?: UseHotkeyOptions) => void;
 export { HotkeyDescriptor, UseHotkeyOptions, useHotkey as default, useHotkey };

package/dist/ink/hooks/use-input.d.ts

@@ -1,149 +1,149 @@
 /**
-* Handy information about a key that was pressed.
-*/
+ * Handy information about a key that was pressed.
+ */
 type Key = {
   /**
-  * Backspace key was pressed.
-  */
+   * Backspace key was pressed.
+   */
   backspace: boolean;
   /**
-  * Caps Lock is active.
-  *
-  * Only available with kitty keyboard protocol.
-  */
+   * Caps Lock is active.
+   *
+   * Only available with kitty keyboard protocol.
+   */
   capsLock: boolean;
   /**
-  * Ctrl key was pressed.
-  */
+   * Ctrl key was pressed.
+   */
   ctrl: boolean;
   /**
-  * Delete key was pressed.
-  */
+   * Delete key was pressed.
+   */
   delete: boolean;
   /**
-  * Down arrow key was pressed.
-  */
+   * Down arrow key was pressed.
+   */
   downArrow: boolean;
   /**
-  * End key was pressed.
-  */
+   * End key was pressed.
+   */
   end: boolean;
   /**
-  * Escape key was pressed.
-  */
+   * Escape key was pressed.
+   */
   escape: boolean;
   /**
-  * Event type for key events.
-  *
-  * Only available with kitty keyboard protocol.
-  */
+   * Event type for key events.
+   *
+   * Only available with kitty keyboard protocol.
+   */
   eventType?: "press" | "repeat" | "release";
   /**
-  * Home key was pressed.
-  */
+   * Home key was pressed.
+   */
   home: boolean;
   /**
-  * Hyper key was pressed.
-  *
-  * Only available with kitty keyboard protocol.
-  */
+   * Hyper key was pressed.
+   *
+   * Only available with kitty keyboard protocol.
+   */
   hyper: boolean;
   /**
-  * Left arrow key was pressed.
-  */
+   * Left arrow key was pressed.
+   */
   leftArrow: boolean;
   /**
-  * [Meta key](https://en.wikipedia.org/wiki/Meta_key) was pressed.
-  */
+   * [Meta key](https://en.wikipedia.org/wiki/Meta_key) was pressed.
+   */
   meta: boolean;
   /**
-  * Num Lock is active.
-  *
-  * Only available with kitty keyboard protocol.
-  */
+   * Num Lock is active.
+   *
+   * Only available with kitty keyboard protocol.
+   */
   numLock: boolean;
   /**
-  * Page Down key was pressed.
-  */
+   * Page Down key was pressed.
+   */
   pageDown: boolean;
   /**
-  * Page Up key was pressed.
-  */
+   * Page Up key was pressed.
+   */
   pageUp: boolean;
   /**
-  * Return (Enter) key was pressed.
-  */
+   * Return (Enter) key was pressed.
+   */
   return: boolean;
   /**
-  * Right arrow key was pressed.
-  */
+   * Right arrow key was pressed.
+   */
   rightArrow: boolean;
   /**
-  * Shift key was pressed.
-  */
+   * Shift key was pressed.
+   */
   shift: boolean;
   /**
-  * Super key (Cmd on Mac, Win on Windows) was pressed.
-  *
-  * Only available with kitty keyboard protocol.
-  */
+   * Super key (Cmd on Mac, Win on Windows) was pressed.
+   *
+   * Only available with kitty keyboard protocol.
+   */
   super: boolean;
   /**
-  * Tab key was pressed.
-  */
+   * Tab key was pressed.
+   */
   tab: boolean;
   /**
-  * Up arrow key was pressed.
-  */
+   * Up arrow key was pressed.
+   */
   upArrow: boolean;
 };
 type Handler = (input: string, key: Key) => void;
 type Options = {
   /**
-  * Enable IME (Input Method Editor) composition buffering for Vietnamese, Chinese,
-  * Japanese, Korean, and other non-ASCII input methods.
-  * @default true
-  */
+   * Enable IME (Input Method Editor) composition buffering for Vietnamese, Chinese,
+   * Japanese, Korean, and other non-ASCII input methods.
+   * @default true
+   */
   imeEnabled?: boolean;
   /**
-  * Timeout in milliseconds to wait before flushing IME composition buffer.
-  * @default 50
-  */
+   * Timeout in milliseconds to wait before flushing IME composition buffer.
+   * @default 50
+   */
   imeTimeout?: number;
   /**
-  * Enable or disable capturing of user input. Useful when there are multiple `useInput` hooks used at once to avoid handling the same input several times.
-  * @default true
-  */
+   * Enable or disable capturing of user input. Useful when there are multiple `useInput` hooks used at once to avoid handling the same input several times.
+   * @default true
+   */
   isActive?: boolean;
 };
 /**
-* A React hook that returns `void` and handles user input.
-* It's a more convenient alternative to using `StdinContext` and listening for
-* `data` events. The callback you pass to `useInput` is called for typed
-* characters and key events.
-*
-* Bracketed paste payloads belong to `usePaste`. If no `usePaste` handler is
-* active, Ink still forwards bracketed paste text to `useInput` for backward
-* compatibility, but that fallback is deprecated and will be removed in the next
-* major version.
-*
-* ```
-* import {useInput} from '@visulima/tui/hooks/use-input';
-*
-* const UserInput = () => {
-* useInput((input, key) => {
-* if (input === 'q') {
-* // Exit program
-* }
-*
-* if (key.leftArrow) {
-* // Left arrow key pressed
-* }
-* });
-*
-* return …
-* };
-* ```
-*/
+ * A React hook that returns `void` and handles user input.
+ * It's a more convenient alternative to using `StdinContext` and listening for
+ * `data` events. The callback you pass to `useInput` is called for typed
+ * characters and key events.
+ *
+ * Bracketed paste payloads belong to `usePaste`. If no `usePaste` handler is
+ * active, Ink still forwards bracketed paste text to `useInput` for backward
+ * compatibility, but that fallback is deprecated and will be removed in the next
+ * major version.
+ *
+ * ```
+ * import {useInput} from '@visulima/tui/hooks/use-input';
+ *
+ * const UserInput = () => {
+ * useInput((input, key) => {
+ * if (input === 'q') {
+ * // Exit program
+ * }
+ *
+ * if (key.leftArrow) {
+ * // Left arrow key pressed
+ * }
+ * });
+ *
+ * return …
+ * };
+ * ```
+ */
 declare const useInput: (inputHandler: Handler, options?: Options) => void;
 export { Key, useInput as default, useInput };

package/dist/ink/hooks/use-input.js

@@ -1,2 +1,2 @@
-import{createRequire as $}from"node:module";import{useRef as L,useEffectEvent as _,useEffect as g}from"react";import{IMECompositionBuffer as S,isIMEInput as q}from"../../packem_shared/IMECompositionBuffer-VhC9HRCv.js";import{kittyModifiers as p}from"../../packem_shared/kittyFlags-g8ALyoCU.js";import{j as w}from"../../packem_shared/reconciler-CFyBVf7l.js";import{useStdinContext as I}from"./use-stdin.js";const C=$(import.meta.url),m=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,P=e=>{if(typeof m<"u"&&m.versions&&m.versions.node){const[a,n]=m.versions.node.split(".").map(Number);if(a>22||a===22&&n>=3||a===20&&n>=16)return m.getBuiltinModule(e)}return C(e)},{Buffer:E}=P("node:buffer"),j=/^\u001B([a-z0-9])$/i,N=/^\u001B+([ON[]|\[\[)(?:(\d+)(?:;(\d+))?([~^$])|(?:1;)?(\d+)?([a-zA-Z]))/,y={"[1~":"home","[2$":"insert","[2^":"insert","[2~":"insert","[3$":"delete","[3^":"delete","[3~":"delete","[4~":"end","[5$":"pageup","[5^":"pageup","[5~":"pageup","[6$":"pagedown","[6^":"pagedown","[6~":"pagedown","[7$":"home","[7^":"home","[7~":"home","[8$":"end","[8^":"end","[8~":"end","[11~":"f1","[12~":"f2","[13~":"f3","[14~":"f4","[15~":"f5","[17~":"f6","[18~":"f7","[19~":"f8","[20~":"f9","[21~":"f10","[23~":"f11","[24~":"f12","[[5~":"pageup","[[6~":"pagedown","[[A":"f1","[[B":"f2","[[C":"f3","[[D":"f4","[[E":"f5","[A":"up","[a":"up","[B":"down","[b":"down","[C":"right","[c":"right","[D":"left","[d":"left","[E":"clear","[e":"clear","[F":"end","[H":"home","[P":"f1","[Q":"f2","[R":"f3","[S":"f4","[Z":"tab",OA:"up",Oa:"up",OB:"down",Ob:"down",OC:"right",Oc:"right",OD:"left",Od:"left",OE:"clear",Oe:"clear",OF:"end",OH:"home",OP:"f1",OQ:"f2",OR:"f3",OS:"f4"},M=[...Object.values(y),"backspace"],T=e=>["[2$","[3$","[5$","[6$","[7$","[8$","[a","[b","[c","[d","[e","[Z"].includes(e),K=e=>["[2^","[3^","[5^","[6^","[7^","[8^","Oa","Ob","Oc","Od","Oe"].includes(e),B=/^\u001B\[(\d+)(?:;(\d+)(?::(\d+))?(?:;([\d:]+))?)?u$/,R=/^\u001B\[(\d+);(\d+):(\d+)([A-Z~])$/i,Z={A:"up",B:"down",C:"right",D:"left",E:"clear",F:"end",H:"home",P:"f1",Q:"f2",R:"f3",S:"f4"},D={2:"insert",3:"delete",5:"pageup",6:"pagedown",7:"home",8:"end",11:"f1",12:"f2",13:"f3",14:"f4",15:"f5",17:"f6",18:"f7",19:"f8",20:"f9",21:"f10",23:"f11",24:"f12"},v={8:"backspace",9:"tab",27:"escape",127:"backspace",57358:"capslock",57359:"scrolllock",57360:"numlock",57361:"printscreen",57362:"pause",57363:"menu",57376:"f13",57377:"f14",57378:"f15",57379:"f16",57380:"f17",57381:"f18",57382:"f19",57383:"f20",57384:"f21",57385:"f22",57386:"f23",57387:"f24",57388:"f25",57389:"f26",57390:"f27",57391:"f28",57392:"f29",57393:"f30",57394:"f31",57395:"f32",57396:"f33",57397:"f34",57398:"f35",57399:"kp0",57400:"kp1",57401:"kp2",57402:"kp3",57403:"kp4",57404:"kp5",57405:"kp6",57406:"kp7",57407:"kp8",57408:"kp9",57409:"kpdecimal",57410:"kpdivide",57411:"kpmultiply",57412:"kpsubtract",57413:"kpadd",57414:"kpenter",57415:"kpequal",57416:"kpseparator",57417:"kpleft",57418:"kpright",57419:"kpup",57420:"kpdown",57421:"kppageup",57422:"kppagedown",57423:"kphome",57424:"kpend",57425:"kpinsert",57426:"kpdelete",57427:"kpbegin",57428:"mediaplay",57429:"mediapause",57430:"mediaplaypause",57431:"mediareverse",57432:"mediastop",57433:"mediafastforward",57434:"mediarewind",57435:"mediatracknext",57436:"mediatrackprevious",57437:"mediarecord",57438:"lowervolume",57439:"raisevolume",57440:"mutevolume",57441:"leftshift",57442:"leftcontrol",57443:"leftalt",57444:"leftsuper",57445:"lefthyper",57446:"leftmeta",57447:"rightshift",57448:"rightcontrol",57449:"rightalt",57450:"rightsuper",57451:"righthyper",57452:"rightmeta",57453:"isoLevel3Shift",57454:"isoLevel5Shift"},x=e=>e>=0&&e<=1114111&&!(e>=55296&&e<=57343),b=e=>x(e)?String.fromCodePoint(e):"?";function A(e){return e===3?"release":e===2?"repeat":"press"}function O(e){return{capsLock:!!(e&p.capsLock),ctrl:!!(e&p.ctrl),hyper:!!(e&p.hyper),meta:!!(e&p.meta),numLock:!!(e&p.numLock),option:!!(e&p.alt),shift:!!(e&p.shift),super:!!(e&p.super)}}const F=e=>{const a=B.exec(e);if(!a)return null;const n=Number.parseInt(a[1],10),c=a[2]?Math.max(0,Number.parseInt(a[2],10)-1):0,t=a[3]?Number.parseInt(a[3],10):1,l=a[4];if(!x(n))return null;let s;l&&(s=l.split(":").map(d=>b(Number.parseInt(d,10))).join(""));let o,i;return n===32?(o="space",i=!0):n===13?(o="return",i=!0):v[n]?(o=v[n],i=!1):n>=1&&n<=26?(o=String.fromCodePoint(n+96),i=!1):(o=b(n).toLowerCase(),i=!0),i&&!s&&(s=b(n)),{name:o,...O(c),eventType:A(t),isKittyProtocol:!0,isPrintable:i,raw:e,sequence:e,text:s}},U=e=>{const a=R.exec(e);if(!a)return null;const n=Number.parseInt(a[1],10),c=Math.max(0,Number.parseInt(a[2],10)-1),t=Number.parseInt(a[3],10),l=a[4],s=l==="~"?D[n]:Z[l];return s?{name:s,...O(c),eventType:A(t),isKittyProtocol:!0,isPrintable:!1,raw:e,sequence:e}:null},z=(e="")=>{let a;E.isBuffer(e)?e[0]>127&&e[1]===void 0?(e[0]-=128,e=`\x1B${String(e)}`):e=String(e):e!==void 0&&typeof e!="string"?e=String(e):e||(e="");const n=F(e);if(n)return n;const c=U(e);if(c)return c;if(B.test(e))return{ctrl:!1,isKittyProtocol:!0,isPrintable:!1,meta:!1,name:"",option:!1,raw:e,sequence:e,shift:!1};const t={ctrl:!1,meta:!1,name:"",option:!1,raw:e,sequence:e,shift:!1};switch(t.sequence=t.sequence||e||t.name,e){case"\r":case"\x1B\r":{t.raw=void 0,t.name="return",t.option=e.length===2;break}case`
-`:{t.name="enter";break}case"	":{t.name="tab";break}case" ":case"\x1B ":{t.name="space",t.meta=e.length===2;break}case"\b":case"\x1B\b":{t.name="backspace",t.meta=e.charAt(0)==="\x1B";break}case"\x1B":case"\x1B\x1B":{t.name="escape",t.meta=e.length===2;break}case"\x1B":case"":{t.name="backspace",t.meta=e.charAt(0)==="\x1B";break}default:if(e.length===1&&e<="")t.name=String.fromCharCode(e.charCodeAt(0)+97-1),t.ctrl=!0;else if(e.length===1&&e>="0"&&e<="9")t.name="number";else if(e.length===1&&e>="a"&&e<="z")t.name=e;else if(e.length===1&&e>="A"&&e<="Z")t.name=e.toLowerCase(),t.shift=!0;else if(a=j.exec(e))t.meta=!0,t.shift=/^[A-Z]$/.test(a[1]);else if(a=N.exec(e)){const l=[...e];l[0]==="\x1B"&&l[1]==="\x1B"&&(t.option=!0);const s=[a[1],a[2],a[4],a[6]].filter(Boolean).join(""),o=(a[3]||a[5]||1)-1;t.ctrl=!!(o&4),t.meta=!!(o&10),t.shift=!!(o&1),t.code=s,t.name=y[s]??"",t.shift=T(s)||t.shift,t.ctrl=K(s)||t.ctrl}}return t},X=(e,a={})=>{const{internal_eventEmitter:n,internal_exitOnCtrlC:c,setRawMode:t,stdin:l}=I(),s=a.imeEnabled??!0,o=a.imeTimeout??50,i=L(void 0),d=_(e);g(()=>{if(s)return i.current=new S({onFlush:h=>{const u={backspace:!1,capsLock:!1,ctrl:!1,delete:!1,downArrow:!1,end:!1,escape:!1,home:!1,hyper:!1,leftArrow:!1,meta:!1,numLock:!1,pageDown:!1,pageUp:!1,return:!1,rightArrow:!1,shift:!1,super:!1,tab:!1,upArrow:!1};w.discreteUpdates(()=>{d(h,u)})},timeout:o}),()=>{i.current?.destroy(),i.current=void 0}},[s,o]),g(()=>{if(a.isActive!==!1)return t(!0),()=>{t(!1)}},[a.isActive,t]),g(()=>{if(a.isActive===!1)return;const h=u=>{if(s&&q(u)){i.current?.add(u);return}i.current?.flush();const r=z(u),k={backspace:r.name==="backspace",capsLock:r.capsLock??!1,ctrl:r.ctrl,delete:r.name==="delete",downArrow:r.name==="down",end:r.name==="end",escape:r.name==="escape",eventType:r.eventType,home:r.name==="home",hyper:r.hyper??!1,leftArrow:r.name==="left",meta:r.meta||r.option,numLock:r.numLock??!1,pageDown:r.name==="pagedown",pageUp:r.name==="pageup",return:r.name==="return",rightArrow:r.name==="right",shift:r.shift,super:r.super??!1,tab:r.name==="tab",upArrow:r.name==="up"};let f;r.isKittyProtocol?r.isPrintable?f=r.text??r.name:r.ctrl&&r.name.length===1?f=r.name:f="":r.ctrl?f=r.name:f=r.sequence,!r.isKittyProtocol&&M.includes(r.name)&&(f=""),f.startsWith("\x1B")&&(f=f.slice(1)),f.length===1&&typeof f[0]=="string"&&/[A-Z]/.test(f[0])&&(k.shift=!0),!(f==="c"&&k.ctrl&&c)&&(!r.name&&f===""||w.discreteUpdates(()=>{d(f,k)}))};return n.on("input",h),()=>{n.removeListener("input",h)}},[a.isActive,l,c,s])};export{X as default,X as useInput};
+import{createRequire as $}from"node:module";import{useRef as P,useEffectEvent as q,useEffect as b,useLayoutEffect as E}from"react";import{IMECompositionBuffer as S,isIMEInput as I}from"../../packem_shared/IMECompositionBuffer-VhC9HRCv.js";import{kittyModifiers as p}from"../../packem_shared/kittyFlags-g8ALyoCU.js";import{j as w}from"../../packem_shared/reconciler-DkwOtC5B.js";import{useStdinContext as N}from"./use-stdin.js";let _;const C=e=>(_??=$(import.meta.url))(e),m=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,L=e=>{if(typeof m<"u"&&m.versions&&m.versions.node){const[a,s]=m.versions.node.split(".").map(Number);if(a>22||a===22&&s>=3||a===20&&s>=16)return m.getBuiltinModule(e)}return C(e)},{Buffer:j}=L("node:buffer"),M=/^\u001B([a-z0-9])$/i,R=/^\u001B+([ON[]|\[\[)(?:(\d+)(?:;(\d+))?([~^$])|(?:1;)?(\d+)?([a-zA-Z]))/,y={"[1~":"home","[2$":"insert","[2^":"insert","[2~":"insert","[3$":"delete","[3^":"delete","[3~":"delete","[4~":"end","[5$":"pageup","[5^":"pageup","[5~":"pageup","[6$":"pagedown","[6^":"pagedown","[6~":"pagedown","[7$":"home","[7^":"home","[7~":"home","[8$":"end","[8^":"end","[8~":"end","[11~":"f1","[12~":"f2","[13~":"f3","[14~":"f4","[15~":"f5","[17~":"f6","[18~":"f7","[19~":"f8","[20~":"f9","[21~":"f10","[23~":"f11","[24~":"f12","[[5~":"pageup","[[6~":"pagedown","[[A":"f1","[[B":"f2","[[C":"f3","[[D":"f4","[[E":"f5","[A":"up","[a":"up","[B":"down","[b":"down","[C":"right","[c":"right","[D":"left","[d":"left","[E":"clear","[e":"clear","[F":"end","[H":"home","[P":"f1","[Q":"f2","[R":"f3","[S":"f4","[Z":"tab",OA:"up",Oa:"up",OB:"down",Ob:"down",OC:"right",Oc:"right",OD:"left",Od:"left",OE:"clear",Oe:"clear",OF:"end",OH:"home",OP:"f1",OQ:"f2",OR:"f3",OS:"f4"},T=[...Object.values(y),"backspace"],K=e=>["[2$","[3$","[5$","[6$","[7$","[8$","[a","[b","[c","[d","[e","[Z"].includes(e),Z=e=>["[2^","[3^","[5^","[6^","[7^","[8^","Oa","Ob","Oc","Od","Oe"].includes(e),B=/^\u001B\[(\d+)(?:;(\d+)(?::(\d+))?(?:;([\d:]+))?)?u$/,D=/^\u001B\[(\d+);(\d+):(\d+)([A-Z~])$/i,F={A:"up",B:"down",C:"right",D:"left",E:"clear",F:"end",H:"home",P:"f1",Q:"f2",R:"f3",S:"f4"},U={2:"insert",3:"delete",5:"pageup",6:"pagedown",7:"home",8:"end",11:"f1",12:"f2",13:"f3",14:"f4",15:"f5",17:"f6",18:"f7",19:"f8",20:"f9",21:"f10",23:"f11",24:"f12"},v={8:"backspace",9:"tab",27:"escape",127:"backspace",57358:"capslock",57359:"scrolllock",57360:"numlock",57361:"printscreen",57362:"pause",57363:"menu",57376:"f13",57377:"f14",57378:"f15",57379:"f16",57380:"f17",57381:"f18",57382:"f19",57383:"f20",57384:"f21",57385:"f22",57386:"f23",57387:"f24",57388:"f25",57389:"f26",57390:"f27",57391:"f28",57392:"f29",57393:"f30",57394:"f31",57395:"f32",57396:"f33",57397:"f34",57398:"f35",57399:"kp0",57400:"kp1",57401:"kp2",57402:"kp3",57403:"kp4",57404:"kp5",57405:"kp6",57406:"kp7",57407:"kp8",57408:"kp9",57409:"kpdecimal",57410:"kpdivide",57411:"kpmultiply",57412:"kpsubtract",57413:"kpadd",57414:"kpenter",57415:"kpequal",57416:"kpseparator",57417:"kpleft",57418:"kpright",57419:"kpup",57420:"kpdown",57421:"kppageup",57422:"kppagedown",57423:"kphome",57424:"kpend",57425:"kpinsert",57426:"kpdelete",57427:"kpbegin",57428:"mediaplay",57429:"mediapause",57430:"mediaplaypause",57431:"mediareverse",57432:"mediastop",57433:"mediafastforward",57434:"mediarewind",57435:"mediatracknext",57436:"mediatrackprevious",57437:"mediarecord",57438:"lowervolume",57439:"raisevolume",57440:"mutevolume",57441:"leftshift",57442:"leftcontrol",57443:"leftalt",57444:"leftsuper",57445:"lefthyper",57446:"leftmeta",57447:"rightshift",57448:"rightcontrol",57449:"rightalt",57450:"rightsuper",57451:"righthyper",57452:"rightmeta",57453:"isoLevel3Shift",57454:"isoLevel5Shift"},x=e=>e>=0&&e<=1114111&&!(e>=55296&&e<=57343),g=e=>x(e)?String.fromCodePoint(e):"?";function A(e){return e===3?"release":e===2?"repeat":"press"}function O(e){return{capsLock:!!(e&p.capsLock),ctrl:!!(e&p.ctrl),hyper:!!(e&p.hyper),meta:!!(e&p.meta),numLock:!!(e&p.numLock),option:!!(e&p.alt),shift:!!(e&p.shift),super:!!(e&p.super)}}const z=e=>{const a=B.exec(e);if(!a)return null;const s=Number.parseInt(a[1],10),c=a[2]?Math.max(0,Number.parseInt(a[2],10)-1):0,t=a[3]?Number.parseInt(a[3],10):1,l=a[4];if(!x(s))return null;let n;l&&(n=l.split(":").map(d=>g(Number.parseInt(d,10))).join(""));let o,i;return s===32?(o="space",i=!0):s===13?(o="return",i=!0):v[s]?(o=v[s],i=!1):s>=1&&s<=26?(o=String.fromCodePoint(s+96),i=!1):(o=g(s).toLowerCase(),i=!0),i&&!n&&(n=g(s)),{name:o,...O(c),eventType:A(t),isKittyProtocol:!0,isPrintable:i,raw:e,sequence:e,text:n}},H=e=>{const a=D.exec(e);if(!a)return null;const s=Number.parseInt(a[1],10),c=Math.max(0,Number.parseInt(a[2],10)-1),t=Number.parseInt(a[3],10),l=a[4],n=l==="~"?U[s]:F[l];return n?{name:n,...O(c),eventType:A(t),isKittyProtocol:!0,isPrintable:!1,raw:e,sequence:e}:null},Q=(e="")=>{let a;j.isBuffer(e)?e[0]>127&&e[1]===void 0?(e[0]-=128,e=`\x1B${String(e)}`):e=String(e):e!==void 0&&typeof e!="string"?e=String(e):e||(e="");const s=z(e);if(s)return s;const c=H(e);if(c)return c;if(B.test(e))return{ctrl:!1,isKittyProtocol:!0,isPrintable:!1,meta:!1,name:"",option:!1,raw:e,sequence:e,shift:!1};const t={ctrl:!1,meta:!1,name:"",option:!1,raw:e,sequence:e,shift:!1};switch(t.sequence=t.sequence||e||t.name,e){case"\r":case"\x1B\r":{t.raw=void 0,t.name="return",t.option=e.length===2;break}case`
+`:{t.name="enter";break}case"	":{t.name="tab";break}case" ":case"\x1B ":{t.name="space",t.meta=e.length===2;break}case"\b":case"\x1B\b":{t.name="backspace",t.meta=e.charAt(0)==="\x1B";break}case"\x1B":case"\x1B\x1B":{t.name="escape",t.meta=e.length===2;break}case"\x1B":case"":{t.name="backspace",t.meta=e.charAt(0)==="\x1B";break}default:if(e.length===1&&e<="")t.name=String.fromCharCode(e.charCodeAt(0)+97-1),t.ctrl=!0;else if(e.length===1&&e>="0"&&e<="9")t.name="number";else if(e.length===1&&e>="a"&&e<="z")t.name=e;else if(e.length===1&&e>="A"&&e<="Z")t.name=e.toLowerCase(),t.shift=!0;else if(a=M.exec(e))t.meta=!0,t.shift=/^[A-Z]$/.test(a[1]);else if(a=R.exec(e)){const l=[...e];l[0]==="\x1B"&&l[1]==="\x1B"&&(t.option=!0);const n=[a[1],a[2],a[4],a[6]].filter(Boolean).join(""),o=(a[3]||a[5]||1)-1;t.ctrl=!!(o&4),t.meta=!!(o&10),t.shift=!!(o&1),t.code=n,t.name=y[n]??"",t.shift=K(n)||t.shift,t.ctrl=Z(n)||t.ctrl}}return t},ee=(e,a={})=>{const{internal_eventEmitter:s,internal_exitOnCtrlC:c,setRawMode:t,stdin:l}=N(),n=a.imeEnabled??!0,o=a.imeTimeout??50,i=P(void 0),d=q(e);b(()=>{if(n)return i.current=new S({onFlush:h=>{const u={backspace:!1,capsLock:!1,ctrl:!1,delete:!1,downArrow:!1,end:!1,escape:!1,home:!1,hyper:!1,leftArrow:!1,meta:!1,numLock:!1,pageDown:!1,pageUp:!1,return:!1,rightArrow:!1,shift:!1,super:!1,tab:!1,upArrow:!1};w.discreteUpdates(()=>{d(h,u)})},timeout:o}),()=>{i.current?.destroy(),i.current=void 0}},[n,o]),b(()=>{if(a.isActive!==!1)return t(!0),()=>{t(!1)}},[a.isActive,t]),E(()=>{if(a.isActive===!1)return;const h=u=>{if(n&&I(u)){i.current?.add(u);return}i.current?.flush();const r=Q(u),k={backspace:r.name==="backspace",capsLock:r.capsLock??!1,ctrl:r.ctrl,delete:r.name==="delete",downArrow:r.name==="down",end:r.name==="end",escape:r.name==="escape",eventType:r.eventType,home:r.name==="home",hyper:r.hyper??!1,leftArrow:r.name==="left",meta:r.meta||r.option,numLock:r.numLock??!1,pageDown:r.name==="pagedown",pageUp:r.name==="pageup",return:r.name==="return",rightArrow:r.name==="right",shift:r.shift,super:r.super??!1,tab:r.name==="tab",upArrow:r.name==="up"};let f;r.isKittyProtocol?r.isPrintable?f=r.text??r.name:r.ctrl&&r.name.length===1?f=r.name:f="":r.ctrl?f=r.name:f=r.sequence,!r.isKittyProtocol&&T.includes(r.name)&&(f=""),f.startsWith("\x1B")&&(f=f.slice(1)),f.length===1&&typeof f[0]=="string"&&/[A-Z]/.test(f[0])&&(k.shift=!0),!(f==="c"&&k.ctrl&&c)&&(!r.name&&f===""||w.discreteUpdates(()=>{d(f,k)}))};return s.on("input",h),()=>{s.removeListener("input",h)}},[a.isActive,l,c,n])};export{ee as default,ee as useInput};

package/dist/ink/hooks/use-interval.d.ts

@@ -1,25 +1,25 @@
 type UseIntervalOptions = {
   /**
-  * When false, the timer is paused. Flipping back to true restarts it.
-  * @default true
-  */
+   * When false, the timer is paused. Flipping back to true restarts it.
+   * @default true
+   */
   readonly isActive?: boolean;
 };
 type UseIntervalResult = {
   /**
-  * Cancel the currently-running timer. The hook effect will reschedule on
-  * the next re-render if `isActive` remains true.
-  */
+   * Cancel the currently-running timer. The hook effect will reschedule on
+   * the next re-render if `isActive` remains true.
+   */
   readonly clear: () => void;
 };
 /**
-* A React hook that invokes `callback` every `interval` ms. The callback
-* reference is captured in a ref so it always sees the latest closure; only
-* `interval` and `isActive` cause the timer to be rebuilt.
-* @param callback Invoked on every tick. Latest closure is captured in a ref.
-* @param interval Tick period in milliseconds. Invalid values pause the timer.
-* @param options Optional `isActive` flag to pause without unmounting.
-* @returns A stable object with a `clear()` method to cancel on demand.
-*/
+ * A React hook that invokes `callback` every `interval` ms. The callback
+ * reference is captured in a ref so it always sees the latest closure; only
+ * `interval` and `isActive` cause the timer to be rebuilt.
+ * @param callback Invoked on every tick. Latest closure is captured in a ref.
+ * @param interval Tick period in milliseconds. Invalid values pause the timer.
+ * @param options Optional `isActive` flag to pause without unmounting.
+ * @returns A stable object with a `clear()` method to cancel on demand.
+ */
 declare const useInterval: (callback: () => void, interval: number, options?: UseIntervalOptions) => UseIntervalResult;
 export { UseIntervalOptions, UseIntervalResult, useInterval as default, useInterval };

package/dist/ink/hooks/use-is-screen-reader-enabled.d.ts

@@ -1,6 +1,6 @@
 /**
-* A React hook that returns whether a screen reader is enabled.
-* This is useful when you want to render different output for screen readers.
-*/
+ * A React hook that returns whether a screen reader is enabled.
+ * This is useful when you want to render different output for screen readers.
+ */
 declare const useIsScreenReaderEnabled: () => boolean;
 export { useIsScreenReaderEnabled as default, useIsScreenReaderEnabled };