@jrichman/ink 6.3.1

package/build/dom.d.ts

@@ -0,0 +1,62 @@
+import { type Node as YogaNode } from 'yoga-layout';
+import { type Styles } from './styles.js';
+import { type OutputTransformer } from './render-node-to-output.js';
+type InkNode = {
+    parentNode: DOMElement | undefined;
+    yogaNode?: YogaNode;
+    internal_static?: boolean;
+    style: Styles;
+};
+export type TextName = '#text';
+export type ElementNames = 'ink-root' | 'ink-box' | 'ink-text' | 'ink-virtual-text';
+export type NodeNames = ElementNames | TextName;
+export type DOMElement = {
+    nodeName: ElementNames;
+    attributes: Record<string, DOMNodeAttribute>;
+    childNodes: DOMNode[];
+    internal_transform?: OutputTransformer;
+    internal_accessibility?: {
+        role?: 'button' | 'checkbox' | 'combobox' | 'list' | 'listbox' | 'listitem' | 'menu' | 'menuitem' | 'option' | 'progressbar' | 'radio' | 'radiogroup' | 'tab' | 'tablist' | 'table' | 'textbox' | 'timer' | 'toolbar';
+        state?: {
+            busy?: boolean;
+            checked?: boolean;
+            disabled?: boolean;
+            expanded?: boolean;
+            multiline?: boolean;
+            multiselectable?: boolean;
+            readonly?: boolean;
+            required?: boolean;
+            selected?: boolean;
+        };
+    };
+    isStaticDirty?: boolean;
+    staticNode?: DOMElement;
+    onComputeLayout?: () => void;
+    onRender?: () => void;
+    onImmediateRender?: () => void;
+    internal_scrollTop?: number;
+    internal_scrollHeight?: number;
+    internal_clientHeight?: number;
+    internal_scrollLeft?: number;
+    internal_scrollWidth?: number;
+    internal_clientWidth?: number;
+} & InkNode;
+export type TextNode = {
+    nodeName: TextName;
+    nodeValue: string;
+} & InkNode;
+export type DOMNode<T = {
+    nodeName: NodeNames;
+}> = T extends {
+    nodeName: infer U;
+} ? U extends '#text' ? TextNode : DOMElement : never;
+export type DOMNodeAttribute = boolean | string | number;
+export declare const createNode: (nodeName: ElementNames) => DOMElement;
+export declare const appendChildNode: (node: DOMElement, childNode: DOMElement) => void;
+export declare const insertBeforeNode: (node: DOMElement, newChildNode: DOMNode, beforeChildNode: DOMNode) => void;
+export declare const removeChildNode: (node: DOMElement, removeNode: DOMNode) => void;
+export declare const setAttribute: (node: DOMElement, key: string, value: DOMNodeAttribute) => void;
+export declare const setStyle: (node: DOMNode, style: Styles) => void;
+export declare const createTextNode: (text: string) => TextNode;
+export declare const setTextNodeValue: (node: TextNode, text: string) => void;
+export {};

package/build/dom.js

@@ -0,0 +1,123 @@
+import Yoga from 'yoga-layout';
+import measureText from './measure-text.js';
+import wrapText from './wrap-text.js';
+import squashTextNodes from './squash-text-nodes.js';
+export const createNode = (nodeName) => {
+    const node = {
+        nodeName,
+        style: {},
+        attributes: {},
+        childNodes: [],
+        parentNode: undefined,
+        yogaNode: nodeName === 'ink-virtual-text' ? undefined : Yoga.Node.create(),
+        // eslint-disable-next-line @typescript-eslint/naming-convention
+        internal_accessibility: {},
+    };
+    if (nodeName === 'ink-text') {
+        node.yogaNode?.setMeasureFunc(measureTextNode.bind(null, node));
+    }
+    return node;
+};
+export const appendChildNode = (node, childNode) => {
+    if (childNode.parentNode) {
+        removeChildNode(childNode.parentNode, childNode);
+    }
+    childNode.parentNode = node;
+    node.childNodes.push(childNode);
+    if (childNode.yogaNode) {
+        node.yogaNode?.insertChild(childNode.yogaNode, node.yogaNode.getChildCount());
+    }
+    if (node.nodeName === 'ink-text' || node.nodeName === 'ink-virtual-text') {
+        markNodeAsDirty(node);
+    }
+};
+export const insertBeforeNode = (node, newChildNode, beforeChildNode) => {
+    if (newChildNode.parentNode) {
+        removeChildNode(newChildNode.parentNode, newChildNode);
+    }
+    newChildNode.parentNode = node;
+    const index = node.childNodes.indexOf(beforeChildNode);
+    if (index >= 0) {
+        node.childNodes.splice(index, 0, newChildNode);
+        if (newChildNode.yogaNode) {
+            node.yogaNode?.insertChild(newChildNode.yogaNode, index);
+        }
+        return;
+    }
+    node.childNodes.push(newChildNode);
+    if (newChildNode.yogaNode) {
+        node.yogaNode?.insertChild(newChildNode.yogaNode, node.yogaNode.getChildCount());
+    }
+    if (node.nodeName === 'ink-text' || node.nodeName === 'ink-virtual-text') {
+        markNodeAsDirty(node);
+    }
+};
+export const removeChildNode = (node, removeNode) => {
+    if (removeNode.yogaNode) {
+        removeNode.parentNode?.yogaNode?.removeChild(removeNode.yogaNode);
+    }
+    removeNode.parentNode = undefined;
+    const index = node.childNodes.indexOf(removeNode);
+    if (index >= 0) {
+        node.childNodes.splice(index, 1);
+    }
+    if (node.nodeName === 'ink-text' || node.nodeName === 'ink-virtual-text') {
+        markNodeAsDirty(node);
+    }
+};
+export const setAttribute = (node, key, value) => {
+    if (key === 'internal_accessibility') {
+        node.internal_accessibility = value;
+        return;
+    }
+    node.attributes[key] = value;
+};
+export const setStyle = (node, style) => {
+    node.style = style;
+};
+export const createTextNode = (text) => {
+    const node = {
+        nodeName: '#text',
+        nodeValue: text,
+        yogaNode: undefined,
+        parentNode: undefined,
+        style: {},
+    };
+    setTextNodeValue(node, text);
+    return node;
+};
+const measureTextNode = function (node, width) {
+    const text = node.nodeName === '#text' ? node.nodeValue : squashTextNodes(node);
+    const dimensions = measureText(text);
+    // Text fits into container, no need to wrap
+    if (dimensions.width <= width) {
+        return dimensions;
+    }
+    // This is happening when <Box> is shrinking child nodes and Yoga asks
+    // if we can fit this text node in a <1px space, so we just tell Yoga "no"
+    if (dimensions.width >= 1 && width > 0 && width < 1) {
+        return dimensions;
+    }
+    const textWrap = node.style?.textWrap ?? 'wrap';
+    const wrappedText = wrapText(text, width, textWrap);
+    return measureText(wrappedText);
+};
+const findClosestYogaNode = (node) => {
+    if (!node?.parentNode) {
+        return undefined;
+    }
+    return node.yogaNode ?? findClosestYogaNode(node.parentNode);
+};
+const markNodeAsDirty = (node) => {
+    // Mark closest Yoga node as dirty to measure text dimensions again
+    const yogaNode = findClosestYogaNode(node);
+    yogaNode?.markDirty();
+};
+export const setTextNodeValue = (node, text) => {
+    if (typeof text !== 'string') {
+        text = String(text);
+    }
+    node.nodeValue = text;
+    markNodeAsDirty(node);
+};
+//# sourceMappingURL=dom.js.map

package/build/dom.js.map

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

package/build/get-max-width.d.ts

@@ -0,0 +1,3 @@
+import { type Node as YogaNode } from 'yoga-layout';
+declare const getMaxWidth: (yogaNode: YogaNode) => number;
+export default getMaxWidth;

package/build/get-max-width.js

@@ -0,0 +1,10 @@
+import Yoga from 'yoga-layout';
+const getMaxWidth = (yogaNode) => {
+    return (yogaNode.getComputedWidth() -
+        yogaNode.getComputedPadding(Yoga.EDGE_LEFT) -
+        yogaNode.getComputedPadding(Yoga.EDGE_RIGHT) -
+        yogaNode.getComputedBorder(Yoga.EDGE_LEFT) -
+        yogaNode.getComputedBorder(Yoga.EDGE_RIGHT));
+};
+export default getMaxWidth;
+//# sourceMappingURL=get-max-width.js.map

package/build/get-max-width.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-max-width.js","sourceRoot":"","sources":["../src/get-max-width.ts"],"names":[],"mappings":"AAAA,OAAO,IAA6B,MAAM,aAAa,CAAC;AAExD,MAAM,WAAW,GAAG,CAAC,QAAkB,EAAE,EAAE;IAC1C,OAAO,CACN,QAAQ,CAAC,gBAAgB,EAAE;QAC3B,QAAQ,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC;QAC3C,QAAQ,CAAC,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC;QAC5C,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC;QAC1C,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,CAC3C,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,WAAW,CAAC"}

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

@@ -0,0 +1,5 @@
+/**
+`useApp` is a React hook that exposes a method to manually exit the app (unmount).
+*/
+declare const useApp: () => import("../components/AppContext.js").Props;
+export default useApp;

package/build/hooks/use-app.js

@@ -0,0 +1,8 @@
+import { useContext } from 'react';
+import AppContext from '../components/AppContext.js';
+/**
+`useApp` is a React hook that exposes a method to manually exit the app (unmount).
+*/
+const useApp = () => useContext(AppContext);
+export default useApp;
+//# sourceMappingURL=use-app.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-app.js","sourceRoot":"","sources":["../../src/hooks/use-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AACjC,OAAO,UAAU,MAAM,6BAA6B,CAAC;AAErD;;EAEE;AACF,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAC5C,eAAe,MAAM,CAAC"}

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

@@ -0,0 +1,28 @@
+import { type Props } from '../components/FocusContext.js';
+type Output = {
+    /**
+    Enable focus management for all components.
+    */
+    enableFocus: Props['enableFocus'];
+    /**
+    Disable focus management for all components. The currently active component (if there's one) will lose its focus.
+    */
+    disableFocus: Props['disableFocus'];
+    /**
+    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.
+    */
+    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.
+    */
+    focus: Props['focus'];
+};
+/**
+This hook exposes methods to enable or disable focus management for all components or manually switch focus to next or previous components.
+*/
+declare const useFocusManager: () => Output;
+export default useFocusManager;

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

@@ -0,0 +1,17 @@
+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.
+*/
+const useFocusManager = () => {
+    const focusContext = useContext(FocusContext);
+    return {
+        enableFocus: focusContext.enableFocus,
+        disableFocus: focusContext.disableFocus,
+        focusNext: focusContext.focusNext,
+        focusPrevious: focusContext.focusPrevious,
+        focus: focusContext.focus,
+    };
+};
+export default useFocusManager;
+//# sourceMappingURL=use-focus-manager.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,29 @@
+type Input = {
+    /**
+    Enable or disable this component's focus, while still maintaining its position in the list of focusable components.
+    */
+    isActive?: boolean;
+    /**
+    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)`.
+    */
+    id?: string;
+};
+type Output = {
+    /**
+    Determines whether this component is focused.
+    */
+    isFocused: boolean;
+    /**
+    Allows focusing a specific element with the provided `id`.
+    */
+    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.
+*/
+declare const useFocus: ({ isActive, autoFocus, id: customId, }?: Input) => Output;
+export default useFocus;

package/build/hooks/use-focus.js

@@ -0,0 +1,42 @@
+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.
+*/
+const useFocus = ({ isActive = true, autoFocus = false, id: customId, } = {}) => {
+    const { isRawModeSupported, setRawMode } = useStdin();
+    const { activeId, add, remove, activate, deactivate, focus } = useContext(FocusContext);
+    const id = useMemo(() => {
+        return customId ?? Math.random().toString().slice(2, 7);
+    }, [customId]);
+    useEffect(() => {
+        add(id, { autoFocus });
+        return () => {
+            remove(id);
+        };
+    }, [id, autoFocus]);
+    useEffect(() => {
+        if (isActive) {
+            activate(id);
+        }
+        else {
+            deactivate(id);
+        }
+    }, [isActive, id]);
+    useEffect(() => {
+        if (!isRawModeSupported || !isActive) {
+            return;
+        }
+        setRawMode(true);
+        return () => {
+            setRawMode(false);
+        };
+    }, [isActive]);
+    return {
+        isFocused: Boolean(id) && activeId === id,
+        focus,
+    };
+};
+export default useFocus;
+//# sourceMappingURL=use-focus.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,93 @@
+/**
+Handy information about a key that was pressed.
+*/
+export type Key = {
+    /**
+    Up arrow key was pressed.
+    */
+    upArrow: boolean;
+    /**
+    Down arrow key was pressed.
+    */
+    downArrow: boolean;
+    /**
+    Left arrow key was pressed.
+    */
+    leftArrow: boolean;
+    /**
+    Right arrow key was pressed.
+    */
+    rightArrow: boolean;
+    /**
+    Page Down key was pressed.
+    */
+    pageDown: boolean;
+    /**
+    Page Up key was pressed.
+    */
+    pageUp: boolean;
+    /**
+    Return (Enter) key was pressed.
+    */
+    return: boolean;
+    /**
+    Escape key was pressed.
+    */
+    escape: boolean;
+    /**
+    Ctrl key was pressed.
+    */
+    ctrl: boolean;
+    /**
+    Shift key was pressed.
+    */
+    shift: boolean;
+    /**
+    Tab key was pressed.
+    */
+    tab: boolean;
+    /**
+    Backspace key was pressed.
+    */
+    backspace: boolean;
+    /**
+    Delete key was pressed.
+    */
+    delete: boolean;
+    /**
+    [Meta key](https://en.wikipedia.org/wiki/Meta_key) was pressed.
+    */
+    meta: boolean;
+};
+type Handler = (input: string, key: Key) => void;
+type Options = {
+    /**
+    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;
+};
+/**
+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`.
+
+```
+import {useInput} from 'ink';
+
+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 default useInput;

package/build/hooks/use-input.js

@@ -0,0 +1,93 @@
+import { useEffect } from 'react';
+import parseKeypress, { nonAlphanumericKeys } from '../parse-keypress.js';
+import reconciler from '../reconciler.js';
+import useStdin 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`.
+
+```
+import {useInput} from 'ink';
+
+const UserInput = () => {
+  useInput((input, key) => {
+    if (input === 'q') {
+      // Exit program
+    }
+
+    if (key.leftArrow) {
+      // Left arrow key pressed
+    }
+  });
+
+  return …
+};
+```
+*/
+const useInput = (inputHandler, options = {}) => {
+    // eslint-disable-next-line @typescript-eslint/naming-convention
+    const { stdin, setRawMode, internal_exitOnCtrlC, internal_eventEmitter } = useStdin();
+    useEffect(() => {
+        if (options.isActive === false) {
+            return;
+        }
+        setRawMode(true);
+        return () => {
+            setRawMode(false);
+        };
+    }, [options.isActive, setRawMode]);
+    useEffect(() => {
+        if (options.isActive === false) {
+            return;
+        }
+        const handleData = (data) => {
+            const keypress = parseKeypress(data);
+            const key = {
+                upArrow: keypress.name === 'up',
+                downArrow: keypress.name === 'down',
+                leftArrow: keypress.name === 'left',
+                rightArrow: keypress.name === 'right',
+                pageDown: keypress.name === 'pagedown',
+                pageUp: keypress.name === 'pageup',
+                return: keypress.name === 'return',
+                escape: keypress.name === 'escape',
+                ctrl: keypress.ctrl,
+                shift: keypress.shift,
+                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,
+            };
+            let input = keypress.ctrl ? keypress.name : keypress.sequence;
+            if (nonAlphanumericKeys.includes(keypress.name)) {
+                input = '';
+            }
+            // Strip meta if it's still remaining after `parseKeypress`
+            // TODO(vadimdemedes): remove this in the next major version.
+            if (input.startsWith('\u001B')) {
+                input = input.slice(1);
+            }
+            if (input.length === 1 &&
+                typeof input[0] === 'string' &&
+                /[A-Z]/.test(input[0])) {
+                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);
+                });
+            }
+        };
+        internal_eventEmitter?.on('input', handleData);
+        return () => {
+            internal_eventEmitter?.removeListener('input', handleData);
+        };
+    }, [options.isActive, stdin, internal_exitOnCtrlC, inputHandler]);
+};
+export default useInput;
+//# sourceMappingURL=use-input.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,5 @@
+/**
+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.js

@@ -0,0 +1,11 @@
+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.
+*/
+const useIsScreenReaderEnabled = () => {
+    const { isScreenReaderEnabled } = useContext(accessibilityContext);
+    return isScreenReaderEnabled;
+};
+export default useIsScreenReaderEnabled;
+//# sourceMappingURL=use-is-screen-reader-enabled.js.map

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

@@ -0,0 +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"}

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

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

package/build/hooks/use-stderr.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-stderr.js","sourceRoot":"","sources":["../../src/hooks/use-stderr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AACjC,OAAO,aAAa,MAAM,gCAAgC,CAAC;AAE3D;;EAEE;AACF,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClD,eAAe,SAAS,CAAC"}

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

@@ -0,0 +1,5 @@
+/**
+`useStdin` is a React hook that exposes the stdin stream.
+*/
+declare const useStdin: () => import("../components/StdinContext.js").Props;
+export default useStdin;

package/build/hooks/use-stdin.js

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

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

@@ -0,0 +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"}

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

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

package/build/hooks/use-stdout.js

@@ -0,0 +1,8 @@
+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.
+*/
+const useStdout = () => useContext(StdoutContext);
+export default useStdout;
+//# sourceMappingURL=use-stdout.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-stdout.js","sourceRoot":"","sources":["../../src/hooks/use-stdout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,OAAO,CAAC;AACjC,OAAO,aAAa,MAAM,gCAAgC,CAAC;AAE3D;;EAEE;AACF,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClD,eAAe,SAAS,CAAC"}