@nuvin/ink 6.6.7 → 7.0.1-alpha

package/build/hooks/use-cursor.js

@@ -0,0 +1,29 @@
+import { useContext, useRef, useCallback, useInsertionEffect } from 'react';
+import CursorContext from '../components/CursorContext.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.
+*/
+const useCursor = () => {
+    const context = useContext(CursorContext);
+    const positionRef = useRef(undefined);
+    const setCursorPosition = useCallback((position) => {
+        positionRef.current = position;
+    }, []);
+    // Propagate cursor position to log-update only during commit phase.
+    // useInsertionEffect runs before resetAfterCommit (which triggers onRender),
+    // and does NOT run for abandoned concurrent renders (e.g. suspended components).
+    // This prevents cursor state from leaking across render boundaries.
+    useInsertionEffect(() => {
+        context.setCursorPosition(positionRef.current);
+        return () => {
+            context.setCursorPosition(undefined);
+        };
+    });
+    return { setCursorPosition };
+};
+export default useCursor;
+//# sourceMappingURL=use-cursor.js.map

package/build/hooks/use-cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-cursor.js","sourceRoot":"","sources":["../../src/hooks/use-cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,kBAAkB,EAAC,MAAM,OAAO,CAAC;AAC1E,OAAO,aAAa,MAAM,gCAAgC,CAAC;AAG3D;;;;;;EAME;AACF,MAAM,SAAS,GAAG,GAAG,EAAE;IACtB,MAAM,OAAO,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;IAC1C,MAAM,WAAW,GAAG,MAAM,CAA6B,SAAS,CAAC,CAAC;IAElE,MAAM,iBAAiB,GAAG,WAAW,CACpC,CAAC,QAAoC,EAAE,EAAE;QACxC,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IAChC,CAAC,EACD,EAAE,CACF,CAAC;IAEF,oEAAoE;IACpE,6EAA6E;IAC7E,iFAAiF;IACjF,oEAAoE;IACpE,kBAAkB,CAAC,GAAG,EAAE;QACvB,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC/C,OAAO,GAAG,EAAE;YACX,OAAO,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACtC,CAAC,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,EAAC,iBAAiB,EAAC,CAAC;AAC5B,CAAC,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/build/hooks/use-focus-manager.d.ts

@@ -17,12 +17,27 @@ type Output = {
     */
     focusPrevious: Props['focusPrevious'];
     /**
-    Switch focus to the element with provided `id`. If there's no element with that `id`, focus will be given to the first focusable component.
+    Switch focus to the element with provided `id`. If there's no element with that `id`, focus is not changed.
     */
     focus: Props['focus'];
+    /**
+    The ID of the currently focused component, or `undefined` if no component is focused.
+
+    @example
+    ```tsx
+    import {Text, useFocusManager} from 'ink';
+
+    const Example = () => {
+        const {activeId} = useFocusManager();
+
+        return <Text>Focused: {activeId ?? 'none'}</Text>;
+    };
+    ```
+    */
+    activeId: Props['activeId'];
 };
 /**
-This hook exposes methods to enable or disable focus management for all components or manually switch focus to 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 default useFocusManager;

package/build/hooks/use-focus-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-focus-manager.d.ts","sourceRoot":"","sources":["../../src/hooks/use-focus-manager.ts"],"names":[],"mappings":"AACA,OAAqB,EAAC,KAAK,KAAK,EAAC,MAAM,+BAA+B,CAAC;AAEvE,KAAK,MAAM,GAAG;IACb;;MAEE;IACF,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IAElC;;MAEE;IACF,YAAY,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;IAEpC;;MAEE;IACF,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IAE9B;;MAEE;IACF,aAAa,EAAE,KAAK,CAAC,eAAe,CAAC,CAAC;IAEtC;;MAEE;IACF,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAEtB;;;;;;;;;;;;;MAaE;IACF,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;CAC5B,CAAC;AAEF;;EAEE;AACF,QAAA,MAAM,eAAe,QAAO,MAW3B,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/build/hooks/use-focus-manager.js

@@ -1,7 +1,7 @@
 import { useContext } from 'react';
 import FocusContext from '../components/FocusContext.js';
 /**
-This hook exposes methods to enable or disable focus management for all components or manually switch focus to 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.
 */
 const useFocusManager = () => {
     const focusContext = useContext(FocusContext);
@@ -11,6 +11,7 @@ const useFocusManager = () => {
         focusNext: focusContext.focusNext,
         focusPrevious: focusContext.focusPrevious,
         focus: focusContext.focus,
+        activeId: focusContext.activeId,
     };
 };
 export default useFocusManager;

package/build/hooks/use-focus-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-focus-manager.js","sourceRoot":"","sources":["../../src/hooks/use-focus-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AACjC,OAAO,YAA0B,MAAM,+BAA+B,CAAC;AA6BvE;;EAEE;AACF,MAAM,eAAe,GAAG,GAAW,EAAE;IACpC,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IAE9C,OAAO;QACN,WAAW,EAAE,YAAY,CAAC,WAAW;QACrC,YAAY,EAAE,YAAY,CAAC,YAAY;QACvC,SAAS,EAAE,YAAY,CAAC,SAAS;QACjC,aAAa,EAAE,YAAY,CAAC,aAAa;QACzC,KAAK,EAAE,YAAY,CAAC,KAAK;KACzB,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"use-focus-manager.js","sourceRoot":"","sources":["../../src/hooks/use-focus-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AACjC,OAAO,YAA0B,MAAM,+BAA+B,CAAC;AA6CvE;;EAEE;AACF,MAAM,eAAe,GAAG,GAAW,EAAE;IACpC,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IAE9C,OAAO;QACN,WAAW,EAAE,YAAY,CAAC,WAAW;QACrC,YAAY,EAAE,YAAY,CAAC,YAAY;QACvC,SAAS,EAAE,YAAY,CAAC,SAAS;QACjC,aAAa,EAAE,YAAY,CAAC,aAAa;QACzC,KAAK,EAAE,YAAY,CAAC,KAAK;QACzB,QAAQ,EAAE,YAAY,CAAC,QAAQ;KAC/B,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/build/hooks/use-focus.d.ts

@@ -23,7 +23,8 @@ type Output = {
     focus: (id: string) => void;
 };
 /**
-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. This hook returns an object with an `isFocused` boolean property, which determines whether this component is focused.
+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: ({ isActive, autoFocus, id: customId, }?: Input) => Output;
 export default useFocus;

package/build/hooks/use-focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-focus.d.ts","sourceRoot":"","sources":["../../src/hooks/use-focus.ts"],"names":[],"mappings":"AAIA,KAAK,KAAK,GAAG;IACZ;;MAEE;IACF,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;MAEE;IACF,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;MAEE;IACF,EAAE,CAAC,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,KAAK,MAAM,GAAG;IACb;;MAEE;IACF,SAAS,EAAE,OAAO,CAAC;IAEnB;;MAEE;IACF,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B,CAAC;AAEF;;;EAGE;AACF,QAAA,MAAM,QAAQ,GAAI,yCAIf,KAAU,KAAG,MAyCf,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/build/hooks/use-focus.js

@@ -2,7 +2,8 @@ import { useEffect, useContext, useMemo } from 'react';
 import FocusContext from '../components/FocusContext.js';
 import useStdin from './use-stdin.js';
 /**
-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. This hook returns an object with an `isFocused` boolean property, which determines whether this component is focused.
+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.
 */
 const useFocus = ({ isActive = true, autoFocus = false, id: customId, } = {}) => {
     const { isRawModeSupported, setRawMode } = useStdin();
@@ -15,7 +16,7 @@ const useFocus = ({ isActive = true, autoFocus = false, id: customId, } = {}) =>
         return () => {
             remove(id);
         };
-    }, [id, autoFocus]);
+    }, [id, autoFocus, add, remove]);
     useEffect(() => {
         if (isActive) {
             activate(id);
@@ -23,7 +24,7 @@ const useFocus = ({ isActive = true, autoFocus = false, id: customId, } = {}) =>
         else {
             deactivate(id);
         }
-    }, [isActive, id]);
+    }, [isActive, id, activate, deactivate]);
     useEffect(() => {
         if (!isRawModeSupported || !isActive) {
             return;
@@ -32,7 +33,7 @@ const useFocus = ({ isActive = true, autoFocus = false, id: customId, } = {}) =>
         return () => {
             setRawMode(false);
         };
-    }, [isActive]);
+    }, [isActive, isRawModeSupported, setRawMode]);
     return {
         isFocused: Boolean(id) && activeId === id,
         focus,

package/build/hooks/use-focus.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-focus.js","sourceRoot":"","sources":["../../src/hooks/use-focus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAC,MAAM,OAAO,CAAC;AACrD,OAAO,YAAY,MAAM,+BAA+B,CAAC;AACzD,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AA+BtC;;EAEE;AACF,MAAM,QAAQ,GAAG,CAAC,EACjB,QAAQ,GAAG,IAAI,EACf,SAAS,GAAG,KAAK,EACjB,EAAE,EAAE,QAAQ,MACF,EAAE,EAAU,EAAE;IACxB,MAAM,EAAC,kBAAkB,EAAE,UAAU,EAAC,GAAG,QAAQ,EAAE,CAAC;IACpD,MAAM,EAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAC,GACzD,UAAU,CAAC,YAAY,CAAC,CAAC;IAE1B,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;QACvB,OAAO,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,SAAS,CAAC,GAAG,EAAE;QACd,GAAG,CAAC,EAAE,EAAE,EAAC,SAAS,EAAC,CAAC,CAAC;QAErB,OAAO,GAAG,EAAE;YACX,MAAM,CAAC,EAAE,CAAC,CAAC;QACZ,CAAC,CAAC;IACH,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;IAEpB,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,QAAQ,EAAE,CAAC;YACd,QAAQ,CAAC,EAAE,CAAC,CAAC;QACd,CAAC;aAAM,CAAC;YACP,UAAU,CAAC,EAAE,CAAC,CAAC;QAChB,CAAC;IACF,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC;IAEnB,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,CAAC,kBAAkB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtC,OAAO;QACR,CAAC;QAED,UAAU,CAAC,IAAI,CAAC,CAAC;QAEjB,OAAO,GAAG,EAAE;YACX,UAAU,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC,CAAC;IACH,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,OAAO;QACN,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,QAAQ,KAAK,EAAE;QACzC,KAAK;KACL,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"use-focus.js","sourceRoot":"","sources":["../../src/hooks/use-focus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAC,MAAM,OAAO,CAAC;AACrD,OAAO,YAAY,MAAM,+BAA+B,CAAC;AACzD,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AA+BtC;;;EAGE;AACF,MAAM,QAAQ,GAAG,CAAC,EACjB,QAAQ,GAAG,IAAI,EACf,SAAS,GAAG,KAAK,EACjB,EAAE,EAAE,QAAQ,MACF,EAAE,EAAU,EAAE;IACxB,MAAM,EAAC,kBAAkB,EAAE,UAAU,EAAC,GAAG,QAAQ,EAAE,CAAC;IACpD,MAAM,EAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAC,GACzD,UAAU,CAAC,YAAY,CAAC,CAAC;IAE1B,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;QACvB,OAAO,QAAQ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,SAAS,CAAC,GAAG,EAAE;QACd,GAAG,CAAC,EAAE,EAAE,EAAC,SAAS,EAAC,CAAC,CAAC;QAErB,OAAO,GAAG,EAAE;YACX,MAAM,CAAC,EAAE,CAAC,CAAC;QACZ,CAAC,CAAC;IACH,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IAEjC,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,QAAQ,EAAE,CAAC;YACd,QAAQ,CAAC,EAAE,CAAC,CAAC;QACd,CAAC;aAAM,CAAC;YACP,UAAU,CAAC,EAAE,CAAC,CAAC;QAChB,CAAC;IACF,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;IAEzC,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,CAAC,kBAAkB,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtC,OAAO;QACR,CAAC;QAED,UAAU,CAAC,IAAI,CAAC,CAAC;QAEjB,OAAO,GAAG,EAAE;YACX,UAAU,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC,CAAC;IACH,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,EAAE,UAAU,CAAC,CAAC,CAAC;IAE/C,OAAO;QACN,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC,IAAI,QAAQ,KAAK,EAAE;QACzC,KAAK;KACL,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/build/hooks/use-input.d.ts

@@ -27,6 +27,14 @@ export type Key = {
     */
     pageUp: boolean;
     /**
+    Home key was pressed.
+    */
+    home: boolean;
+    /**
+    End key was pressed.
+    */
+    end: boolean;
+    /**
     Return (Enter) key was pressed.
     */
     return: boolean;
@@ -58,6 +66,36 @@ export type Key = {
     [Meta key](https://en.wikipedia.org/wiki/Meta_key) was pressed.
     */
     meta: boolean;
+    /**
+    Super key (Cmd on Mac, Win on Windows) was pressed.
+
+    Only available with kitty keyboard protocol.
+    */
+    super: boolean;
+    /**
+    Hyper key was pressed.
+
+    Only available with kitty keyboard protocol.
+    */
+    hyper: boolean;
+    /**
+    Caps Lock is active.
+
+    Only available with kitty keyboard protocol.
+    */
+    capsLock: boolean;
+    /**
+    Num Lock is active.
+
+    Only available with kitty keyboard protocol.
+    */
+    numLock: boolean;
+    /**
+    Event type for key events.
+
+    Only available with kitty keyboard protocol.
+    */
+    eventType?: 'press' | 'repeat' | 'release';
 };
 type Handler = (input: string, key: Key) => void;
 type Options = {
@@ -69,7 +107,8 @@ type Options = {
     isActive?: boolean;
 };
 /**
-This hook is used for handling 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 each character when the user enters any input. However, if the user pastes text and it's more than one character, the callback will be called only once, and the whole string will be passed as `input`.
+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 each character when the user enters any input. However, if the user pastes text and it's more than one character, the callback will be called only once, and the whole string will be passed as `input`.
 
 ```
 import {useInput} from 'ink';

package/build/hooks/use-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-input.d.ts","sourceRoot":"","sources":["../../src/hooks/use-input.ts"],"names":[],"mappings":"AAKA;;EAEE;AACF,MAAM,MAAM,GAAG,GAAG;IACjB;;MAEE;IACF,OAAO,EAAE,OAAO,CAAC;IAEjB;;MAEE;IACF,SAAS,EAAE,OAAO,CAAC;IAEnB;;MAEE;IACF,SAAS,EAAE,OAAO,CAAC;IAEnB;;MAEE;IACF,UAAU,EAAE,OAAO,CAAC;IAEpB;;MAEE;IACF,QAAQ,EAAE,OAAO,CAAC;IAElB;;MAEE;IACF,MAAM,EAAE,OAAO,CAAC;IAEhB;;MAEE;IACF,IAAI,EAAE,OAAO,CAAC;IAEd;;MAEE;IACF,GAAG,EAAE,OAAO,CAAC;IAEb;;MAEE;IACF,MAAM,EAAE,OAAO,CAAC;IAEhB;;MAEE;IACF,MAAM,EAAE,OAAO,CAAC;IAEhB;;MAEE;IACF,IAAI,EAAE,OAAO,CAAC;IAEd;;MAEE;IACF,KAAK,EAAE,OAAO,CAAC;IAEf;;MAEE;IACF,GAAG,EAAE,OAAO,CAAC;IAEb;;MAEE;IACF,SAAS,EAAE,OAAO,CAAC;IAEnB;;MAEE;IACF,MAAM,EAAE,OAAO,CAAC;IAEhB;;MAEE;IACF,IAAI,EAAE,OAAO,CAAC;IAEd;;;;MAIE;IACF,KAAK,EAAE,OAAO,CAAC;IAEf;;;;MAIE;IACF,KAAK,EAAE,OAAO,CAAC;IAEf;;;;MAIE;IACF,QAAQ,EAAE,OAAO,CAAC;IAElB;;;;MAIE;IACF,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;MAIE;IACF,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC3C,CAAC;AAEF,KAAK,OAAO,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;AAEjD,KAAK,OAAO,GAAG;IACd;;;;MAIE;IACF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;EAqBE;AACF,QAAA,MAAM,QAAQ,GAAI,cAAc,OAAO,EAAE,UAAS,OAAY,SAuH7D,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/build/hooks/use-input.js

@@ -1,9 +1,10 @@
-import { useEffect } from 'react';
+import { useEffect, useRef } from 'react';
 import parseKeypress, { nonAlphanumericKeys } from '../parse-keypress.js';
 import reconciler from '../reconciler.js';
-import useStdin from './use-stdin.js';
+import { useStdinContext } from './use-stdin.js';
 /**
-This hook is used for handling 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 each character when the user enters any input. However, if the user pastes text and it's more than one character, the callback will be called only once, and the whole string will be passed as `input`.
+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 each character when the user enters any input. However, if the user pastes text and it's more than one character, the callback will be called only once, and the whole string will be passed as `input`.
 
 ```
 import {useInput} from 'ink';
@@ -25,7 +26,14 @@ const UserInput = () => {
 */
 const useInput = (inputHandler, options = {}) => {
     // eslint-disable-next-line @typescript-eslint/naming-convention
-    const { stdin, setRawMode, internal_exitOnCtrlC, internal_eventEmitter } = useStdin();
+    const { setRawMode, internal_exitOnCtrlC, internal_eventEmitter } = useStdinContext();
+    // Use a ref to always have the latest handler without re-subscribing
+    // to the event emitter. This avoids useEffectEvent which has a stale
+    // closure bug in ink's custom React reconciler when used with forwardRef.
+    const handlerRef = useRef(inputHandler);
+    handlerRef.current = inputHandler;
+    const exitOnCtrlCRef = useRef(internal_exitOnCtrlC);
+    exitOnCtrlCRef.current = internal_exitOnCtrlC;
     useEffect(() => {
         if (options.isActive === false) {
             return;
@@ -48,6 +56,8 @@ const useInput = (inputHandler, options = {}) => {
                 rightArrow: keypress.name === 'right',
                 pageDown: keypress.name === 'pagedown',
                 pageUp: keypress.name === 'pageup',
+                home: keypress.name === 'home',
+                end: keypress.name === 'end',
                 return: keypress.name === 'return',
                 escape: keypress.name === 'escape',
                 ctrl: keypress.ctrl,
@@ -55,39 +65,69 @@ const useInput = (inputHandler, options = {}) => {
                 tab: keypress.name === 'tab',
                 backspace: keypress.name === 'backspace',
                 delete: keypress.name === 'delete',
-                // `parseKeypress` parses \u001B\u001B[A (meta + up arrow) as meta = false
-                // but with option = true, so we need to take this into account here
-                // to avoid breaking changes in Ink.
-                // TODO(vadimdemedes): consider removing this in the next major version.
-                meta: keypress.meta || keypress.name === 'escape' || keypress.option,
+                meta: keypress.meta,
+                // Kitty keyboard protocol modifiers
+                super: keypress.super ?? false,
+                hyper: keypress.hyper ?? false,
+                capsLock: keypress.capsLock ?? false,
+                numLock: keypress.numLock ?? false,
+                eventType: keypress.eventType,
             };
-            let input = keypress.ctrl ? keypress.name : keypress.sequence;
-            if (nonAlphanumericKeys.includes(keypress.name)) {
+            let input;
+            if (keypress.isKittyProtocol) {
+                // Use text-as-codepoints field for printable keys (needed when
+                // reportAllKeysAsEscapeCodes flag is enabled), suppress non-printable
+                if (keypress.isPrintable) {
+                    input = keypress.text ?? keypress.name;
+                }
+                else if (keypress.ctrl && keypress.name.length === 1) {
+                    // Ctrl+letter via codepoint 1-26 form: not printable text, but
+                    // the letter name must flow through so handlers (e.g. exitOnCtrlC
+                    // checking `input === 'c' && key.ctrl`) still work.
+                    input = keypress.name;
+                }
+                else {
+                    input = '';
+                }
+            }
+            else if (keypress.ctrl) {
+                // Keypress.name is guaranteed non-undefined by parseKeypress,
+                // but guard defensively since a TypeError here would crash the
+                // entire Ink app (see https://github.com/vadimdemedes/ink/issues/901).
+                input = keypress.name ?? '';
+            }
+            else {
+                input = keypress.sequence;
+            }
+            if (!keypress.isKittyProtocol &&
+                nonAlphanumericKeys.includes(keypress.name)) {
                 input = '';
             }
-            // Strip meta if it's still remaining after `parseKeypress`
-            // TODO(vadimdemedes): remove this in the next major version.
+            // Strip escape prefix from broken/incomplete sequences that
+            // parseKeypress did not fully resolve (e.g. a flushed "\u001B[").
             if (input.startsWith('\u001B')) {
                 input = input.slice(1);
             }
-            if (input.length === 1 &&
-                typeof input[0] === 'string' &&
-                /[A-Z]/.test(input[0])) {
+            if (input.length === 1 && /[A-Z]/.test(input)) {
                 key.shift = true;
             }
-            // If app is not supposed to exit on Ctrl+C, then let input listener handle it
-            if (!(input === 'c' && key.ctrl) || !internal_exitOnCtrlC) {
-                // @ts-expect-error TypeScript types for `batchedUpdates` require an argument, but React's codebase doesn't provide it and it works without it as expected.
-                reconciler.batchedUpdates(() => {
-                    inputHandler(input, key);
-                });
+            // If app is supposed to exit on Ctrl+C, skip input listeners.
+            if (input === 'c' && key.ctrl && exitOnCtrlCRef.current) {
+                return;
             }
+            // Use discreteUpdates to assign DiscreteEventPriority to state
+            // updates from keyboard input, ensuring they are processed at the
+            // highest priority in concurrent mode.
+            // @ts-expect-error Types require 5 arguments (fn, a, b, c, d) but only fn is needed at runtime.
+            reconciler.discreteUpdates(() => {
+                handlerRef.current(input, key);
+            });
         };
-        internal_eventEmitter?.on('input', handleData);
+        internal_eventEmitter.on('input', handleData);
         return () => {
-            internal_eventEmitter?.removeListener('input', handleData);
+            internal_eventEmitter.removeListener('input', handleData);
         };
-    }, [options.isActive, stdin, internal_exitOnCtrlC, inputHandler]);
+    }, [options.isActive, internal_eventEmitter]);
 };
 export default useInput;
 //# sourceMappingURL=use-input.js.map

package/build/hooks/use-input.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-input.js","sourceRoot":"","sources":["../../src/hooks/use-input.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"use-input.js","sourceRoot":"","sources":["../../src/hooks/use-input.ts"],"names":[],"mappings":"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"}

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

@@ -1,5 +1,6 @@
 /**
-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 default useIsScreenReaderEnabled;

package/build/hooks/use-is-screen-reader-enabled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-is-screen-reader-enabled.d.ts","sourceRoot":"","sources":["../../src/hooks/use-is-screen-reader-enabled.ts"],"names":[],"mappings":"AAGA;;;EAGE;AACF,QAAA,MAAM,wBAAwB,QAAO,OAGpC,CAAC;AAEF,eAAe,wBAAwB,CAAC"}

package/build/hooks/use-is-screen-reader-enabled.js

@@ -1,7 +1,8 @@
 import { useContext } from 'react';
 import { accessibilityContext } from '../components/AccessibilityContext.js';
 /**
-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.
 */
 const useIsScreenReaderEnabled = () => {
     const { isScreenReaderEnabled } = useContext(accessibilityContext);

package/build/hooks/use-is-screen-reader-enabled.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-is-screen-reader-enabled.js","sourceRoot":"","sources":["../../src/hooks/use-is-screen-reader-enabled.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AACjC,OAAO,EAAC,oBAAoB,EAAC,MAAM,uCAAuC,CAAC;AAE3E;;EAEE;AACF,MAAM,wBAAwB,GAAG,GAAY,EAAE;IAC9C,MAAM,EAAC,qBAAqB,EAAC,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACjE,OAAO,qBAAqB,CAAC;AAC9B,CAAC,CAAC;AAEF,eAAe,wBAAwB,CAAC"}
+{"version":3,"file":"use-is-screen-reader-enabled.js","sourceRoot":"","sources":["../../src/hooks/use-is-screen-reader-enabled.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AACjC,OAAO,EAAC,oBAAoB,EAAC,MAAM,uCAAuC,CAAC;AAE3E;;;EAGE;AACF,MAAM,wBAAwB,GAAG,GAAY,EAAE;IAC9C,MAAM,EAAC,qBAAqB,EAAC,GAAG,UAAU,CAAC,oBAAoB,CAAC,CAAC;IACjE,OAAO,qBAAqB,CAAC;AAC9B,CAAC,CAAC;AAEF,eAAe,wBAAwB,CAAC"}

package/build/hooks/use-paste.d.ts

@@ -0,0 +1,35 @@
+type Options = {
+    /**
+    Enable or disable the paste handler. Useful when multiple components use `usePaste` and only one should be active at a time.
+
+    @default true
+    */
+    isActive?: boolean;
+};
+/**
+A React hook that calls `handler` whenever the user pastes text in the terminal. Bracketed paste mode (`\x1b[?2004h`) is automatically enabled while the hook is active, so pasted text arrives as a single string rather than being misinterpreted as individual key presses.
+
+`usePaste` and `useInput` can be used together in the same component. They operate on separate event channels, so paste content is never forwarded to `useInput` handlers when `usePaste` is active.
+
+```
+import {useInput, usePaste} from 'ink';
+
+const MyInput = () => {
+    useInput((input, key) => {
+        // Only receives typed characters and key events, not pasted text.
+        if (key.return) {
+            // Submit
+        }
+    });
+
+    usePaste((text) => {
+        // Receives the full pasted string, including newlines.
+        console.log('Pasted:', text);
+    });
+
+    return …
+};
+```
+*/
+declare const usePaste: (handler: (text: string) => void, options?: Options) => void;
+export default usePaste;

package/build/hooks/use-paste.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-paste.d.ts","sourceRoot":"","sources":["../../src/hooks/use-paste.ts"],"names":[],"mappings":"AAIA,KAAK,OAAO,GAAG;IACd;;;;MAIE;IACF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;EAwBE;AACF,QAAA,MAAM,QAAQ,GACb,SAAS,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC/B,UAAS,OAAY,KACnB,IA4CF,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/build/hooks/use-paste.js

@@ -0,0 +1,66 @@
+import { useEffect, useRef } from 'react';
+import reconciler from '../reconciler.js';
+import { useStdinContext } from './use-stdin.js';
+/**
+A React hook that calls `handler` whenever the user pastes text in the terminal. Bracketed paste mode (`\x1b[?2004h`) is automatically enabled while the hook is active, so pasted text arrives as a single string rather than being misinterpreted as individual key presses.
+
+`usePaste` and `useInput` can be used together in the same component. They operate on separate event channels, so paste content is never forwarded to `useInput` handlers when `usePaste` is active.
+
+```
+import {useInput, usePaste} from 'ink';
+
+const MyInput = () => {
+    useInput((input, key) => {
+        // Only receives typed characters and key events, not pasted text.
+        if (key.return) {
+            // Submit
+        }
+    });
+
+    usePaste((text) => {
+        // Receives the full pasted string, including newlines.
+        console.log('Pasted:', text);
+    });
+
+    return …
+};
+```
+*/
+const usePaste = (handler, options = {}) => {
+    // eslint-disable-next-line @typescript-eslint/naming-convention
+    const { setRawMode, setBracketedPasteMode, internal_eventEmitter } = useStdinContext();
+    useEffect(() => {
+        if (options.isActive === false) {
+            return;
+        }
+        setRawMode(true);
+        setBracketedPasteMode(true);
+        return () => {
+            setRawMode(false);
+            setBracketedPasteMode(false);
+        };
+    }, [options.isActive, setRawMode, setBracketedPasteMode]);
+    // Use a ref to always have the latest handler. useEffectEvent has a stale
+    // closure bug in ink's custom React reconciler when used with forwardRef.
+    const handlerRef = useRef(handler);
+    handlerRef.current = handler;
+    useEffect(() => {
+        if (options.isActive === false) {
+            return;
+        }
+        const handlePaste = (text) => {
+            // Use discreteUpdates to assign DiscreteEventPriority to state
+            // updates triggered by paste, matching the priority of useInput.
+            // @ts-expect-error Types require 5 arguments (fn, a, b, c, d) but only fn is needed at runtime.
+            reconciler.discreteUpdates(() => {
+                handlerRef.current(text);
+            });
+        };
+        internal_eventEmitter.on('paste', handlePaste);
+        return () => {
+            internal_eventEmitter.removeListener('paste', handlePaste);
+        };
+    }, [options.isActive, internal_eventEmitter]);
+};
+export default usePaste;
+//# sourceMappingURL=use-paste.js.map

package/build/hooks/use-paste.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-paste.js","sourceRoot":"","sources":["../../src/hooks/use-paste.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAE,MAAM,EAAC,MAAM,OAAO,CAAC;AACxC,OAAO,UAAU,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAC,eAAe,EAAC,MAAM,gBAAgB,CAAC;AAW/C;;;;;;;;;;;;;;;;;;;;;;;;EAwBE;AACF,MAAM,QAAQ,GAAG,CAChB,OAA+B,EAC/B,UAAmB,EAAE,EACd,EAAE;IACT,gEAAgE;IAChE,MAAM,EAAC,UAAU,EAAE,qBAAqB,EAAE,qBAAqB,EAAC,GAC/D,eAAe,EAAE,CAAC;IAEnB,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YAChC,OAAO;QACR,CAAC;QAED,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,qBAAqB,CAAC,IAAI,CAAC,CAAC;QAE5B,OAAO,GAAG,EAAE;YACX,UAAU,CAAC,KAAK,CAAC,CAAC;YAClB,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,qBAAqB,CAAC,CAAC,CAAC;IAE1D,0EAA0E;IAC1E,0EAA0E;IAC1E,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACd,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YAChC,OAAO;QACR,CAAC;QAED,MAAM,WAAW,GAAG,CAAC,IAAY,EAAQ,EAAE;YAC1C,+DAA+D;YAC/D,iEAAiE;YACjE,gGAAgG;YAChG,UAAU,CAAC,eAAe,CAAC,GAAG,EAAE;gBAC/B,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC,CAAC,CAAC;QACJ,CAAC,CAAC;QAEF,qBAAqB,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAE/C,OAAO,GAAG,EAAE;YACX,qBAAqB,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAC5D,CAAC,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAC/C,CAAC,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/build/hooks/use-stderr.d.ts

@@ -1,5 +1,5 @@
 /**
-`useStderr` is a React hook that exposes the stderr stream.
+A React hook that returns the stderr stream.
 */
 declare const useStderr: () => import("../components/StderrContext.js").Props;
 export default useStderr;

package/build/hooks/use-stderr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-stderr.d.ts","sourceRoot":"","sources":["../../src/hooks/use-stderr.ts"],"names":[],"mappings":"AAGA;;EAEE;AACF,QAAA,MAAM,SAAS,sDAAkC,CAAC;AAClD,eAAe,SAAS,CAAC"}

package/build/hooks/use-stderr.js

@@ -1,7 +1,7 @@
 import { useContext } from 'react';
 import StderrContext from '../components/StderrContext.js';
 /**
-`useStderr` is a React hook that exposes the stderr stream.
+A React hook that returns the stderr stream.
 */
 const useStderr = () => useContext(StderrContext);
 export default useStderr;

package/build/hooks/use-stdin.d.ts

@@ -1,5 +1,7 @@
+import { type PublicProps, type Props } from '../components/StdinContext.js';
 /**
-`useStdin` is a React hook that exposes the stdin stream.
+A React hook that returns the stdin stream and stdin-related utilities.
 */
-declare const useStdin: () => import("../components/StdinContext.js").Props;
+declare const useStdin: () => PublicProps;
+export declare const useStdinContext: () => Props;
 export default useStdin;

package/build/hooks/use-stdin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-stdin.d.ts","sourceRoot":"","sources":["../../src/hooks/use-stdin.ts"],"names":[],"mappings":"AACA,OAAqB,EACpB,KAAK,WAAW,EAChB,KAAK,KAAK,EACV,MAAM,+BAA+B,CAAC;AAEvC;;EAEE;AACF,QAAA,MAAM,QAAQ,QAAO,WAAuC,CAAC;AAE7D,eAAO,MAAM,eAAe,QAAO,KAAiC,CAAC;AAErE,eAAe,QAAQ,CAAC"}

package/build/hooks/use-stdin.js

@@ -1,8 +1,9 @@
 import { useContext } from 'react';
 import StdinContext from '../components/StdinContext.js';
 /**
-`useStdin` is a React hook that exposes the stdin stream.
+A React hook that returns the stdin stream and stdin-related utilities.
 */
 const useStdin = () => useContext(StdinContext);
+export const useStdinContext = () => useContext(StdinContext);
 export default useStdin;
 //# sourceMappingURL=use-stdin.js.map

package/build/hooks/use-stdin.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-stdin.js","sourceRoot":"","sources":["../../src/hooks/use-stdin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AACjC,OAAO,YAAY,MAAM,+BAA+B,CAAC;AAEzD;;EAEE;AACF,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AAChD,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"use-stdin.js","sourceRoot":"","sources":["../../src/hooks/use-stdin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AACjC,OAAO,YAGN,MAAM,+BAA+B,CAAC;AAEvC;;EAEE;AACF,MAAM,QAAQ,GAAG,GAAgB,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AAE7D,MAAM,CAAC,MAAM,eAAe,GAAG,GAAU,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AAErE,eAAe,QAAQ,CAAC"}

package/build/hooks/use-stdout.d.ts

@@ -1,5 +1,5 @@
 /**
-`useStdout` is a React hook that exposes the stdout stream where Ink renders your app.
+A React hook that returns the stdout stream where Ink renders your app.
 */
 declare const useStdout: () => import("../components/StdoutContext.js").Props;
 export default useStdout;

package/build/hooks/use-stdout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-stdout.d.ts","sourceRoot":"","sources":["../../src/hooks/use-stdout.ts"],"names":[],"mappings":"AAGA;;EAEE;AACF,QAAA,MAAM,SAAS,sDAAkC,CAAC;AAClD,eAAe,SAAS,CAAC"}

package/build/hooks/use-stdout.js

@@ -1,7 +1,7 @@
 import { useContext } from 'react';
 import StdoutContext from '../components/StdoutContext.js';
 /**
-`useStdout` is a React hook that exposes the stdout stream where Ink renders your app.
+A React hook that returns the stdout stream where Ink renders your app.
 */
 const useStdout = () => useContext(StdoutContext);
 export default useStdout;

package/build/hooks/use-window-size.d.ts

@@ -0,0 +1,18 @@
+/**
+Dimensions of the terminal window.
+*/
+export type WindowSize = {
+    /**
+    Number of columns (horizontal character cells).
+    */
+    readonly columns: number;
+    /**
+    Number of rows (vertical character cells).
+    */
+    readonly rows: number;
+};
+/**
+A React hook that returns the current terminal window dimensions and re-renders the component whenever the terminal is resized.
+*/
+declare const useWindowSize: () => WindowSize;
+export default useWindowSize;

package/build/hooks/use-window-size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-window-size.d.ts","sourceRoot":"","sources":["../../src/hooks/use-window-size.ts"],"names":[],"mappings":"AAIA;;EAEE;AACF,MAAM,MAAM,UAAU,GAAG;IACxB;;MAEE;IACF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;MAEE;IACF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;EAEE;AACF,QAAA,MAAM,aAAa,QAAO,UAiBzB,CAAC;AAEF,eAAe,aAAa,CAAC"}