@visulima/tui 2.0.0 → 3.0.0

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 P,useEffectEvent as _,useEffect as b,useLayoutEffect as E}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-DhUGYWCr.js";import{useStdinContext as j}from"./use-stdin.js";const C=$(import.meta.url),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:I}=L("node:buffer"),N=/^\u001B([a-z0-9])$/i,M=/^\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),R=e=>["[2^","[3^","[5^","[6^","[7^","[8^","Oa","Ob","Oc","Od","Oe"].includes(e),B=/^\u001B\[(\d+)(?:;(\d+)(?::(\d+))?(?:;([\d:]+))?)?u$/,Z=/^\u001B\[(\d+);(\d+):(\d+)([A-Z~])$/i,D={A:"up",B:"down",C:"right",D:"left",E:"clear",F:"end",H:"home",P:"f1",Q:"f2",R:"f3",S:"f4"},F={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 U=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}},z=e=>{const a=Z.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==="~"?F[s]:D[l];return n?{name:n,...O(c),eventType:A(t),isKittyProtocol:!0,isPrintable:!1,raw:e,sequence:e}:null},H=(e="")=>{let a;I.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=U(e);if(s)return s;const c=z(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=N.exec(e))t.meta=!0,t.shift=/^[A-Z]$/.test(a[1]);else if(a=M.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=R(n)||t.ctrl}}return t},Y=(e,a={})=>{const{internal_eventEmitter:s,internal_exitOnCtrlC:c,setRawMode:t,stdin:l}=j(),n=a.imeEnabled??!0,o=a.imeTimeout??50,i=P(void 0),d=_(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&&q(u)){i.current?.add(u);return}i.current?.flush();const r=H(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{Y as default,Y 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 };

package/dist/ink/hooks/use-key-bindings.d.ts

@@ -1,40 +1,40 @@
 /**
-* A single key binding definition.
-*/
+ * A single key binding definition.
+ */
 type KeyBinding = {
   /** Human-readable description shown in Help. */
   readonly description: string;
   /**
-  * Whether this binding is active.
-  * @default true
-  */
+   * Whether this binding is active.
+   * @default true
+   */
   readonly enabled?: boolean;
   /** Optional group name for organizing in the Help component's full mode. */
   readonly group?: string;
   /**
-  * Key(s) that trigger this binding.
-  *
-  * A string can be:
-  * - A single character: `"q"`, `"a"`, `" "` (space)
-  * - A `Key` boolean field name: `"return"`, `"escape"`, `"upArrow"`, `"leftArrow"`, etc.
-  * - A modifier combo: `"ctrl+c"`, `"meta+s"` (modifier + character)
-  *
-  * Provide an array to match multiple keys for the same action.
-  */
+   * Key(s) that trigger this binding.
+   *
+   * A string can be:
+   * - A single character: `"q"`, `"a"`, `" "` (space)
+   * - A `Key` boolean field name: `"return"`, `"escape"`, `"upArrow"`, `"leftArrow"`, etc.
+   * - A modifier combo: `"ctrl+c"`, `"meta+s"` (modifier + character)
+   *
+   * Provide an array to match multiple keys for the same action.
+   */
   readonly key: string | ReadonlyArray<string>;
 };
 /**
-* A binding paired with its handler function.
-*/
+ * A binding paired with its handler function.
+ */
 type KeyBindingHandler = {
   readonly binding: KeyBinding;
   readonly handler: () => void;
 };
 type UseKeyBindingsOptions = {
   /**
-  * Whether keyboard input is captured.
-  * @default true
-  */
+   * Whether keyboard input is captured.
+   * @default true
+   */
   readonly isActive?: boolean;
 };
 type UseKeyBindingsResult = {
@@ -42,18 +42,18 @@ type UseKeyBindingsResult = {
   readonly bindings: ReadonlyArray<KeyBinding>;
 };
 /**
-* Declarative keybinding hook. Registers multiple key bindings with handlers
-* and returns the enabled bindings for display in a Help component.
-*
-* ```tsx
-* const { bindings } = useKeyBindings([
-*   { binding: { key: "q", description: "Quit" }, handler: () => exit() },
-*   { binding: { key: ["upArrow", "k"], description: "Move up" }, handler: () => moveUp() },
-*   { binding: { key: "ctrl+s", description: "Save" }, handler: () => save() },
-* ]);
-*
-* &lt;Help bindings={bindings} />
-* ```
-*/
+ * Declarative keybinding hook. Registers multiple key bindings with handlers
+ * and returns the enabled bindings for display in a Help component.
+ *
+ * ```tsx
+ * const { bindings } = useKeyBindings([
+ *   { binding: { key: "q", description: "Quit" }, handler: () => exit() },
+ *   { binding: { key: ["upArrow", "k"], description: "Move up" }, handler: () => moveUp() },
+ *   { binding: { key: "ctrl+s", description: "Save" }, handler: () => save() },
+ * ]);
+ *
+ * &lt;Help bindings={bindings} />
+ * ```
+ */
 declare function useKeyBindings(handlers: ReadonlyArray<KeyBindingHandler>, options?: UseKeyBindingsOptions): UseKeyBindingsResult;
 export { KeyBinding, KeyBindingHandler, useKeyBindings as default, useKeyBindings };

package/dist/ink/hooks/use-key-chord.d.ts

@@ -1,25 +1,25 @@
 type KeyChordStep = string;
 type UseKeyChordOptions = {
   /**
-  * Disable the chord while keeping the component rendered.
-  * @default true
-  */
+   * Disable the chord while keeping the component rendered.
+   * @default true
+   */
   readonly isActive?: boolean;
   /**
-  * Milliseconds of silence after which the partial chord resets.
-  * @default 1000
-  */
+   * Milliseconds of silence after which the partial chord resets.
+   * @default 1000
+   */
   readonly resetAfter?: number;
 };
 /**
-* Invoke `callback` when the user types the given sequence of keys in order
-* (like Vim's `g d` or Emacs's `C-x C-s`). The chord resets automatically
-* after `resetAfter` ms of silence.
-* @param sequence Ordered list of chord steps. Each step is compared against
-* a canonical key token (e.g. `"g"`, `"space"`, `"ctrl+s"`).
-* @param callback Invoked exactly once per successful chord match. Latest
-* reference is captured in a ref.
-* @param options Optional `isActive` flag and `resetAfter` silence timeout.
-*/
+ * Invoke `callback` when the user types the given sequence of keys in order
+ * (like Vim's `g d` or Emacs's `C-x C-s`). The chord resets automatically
+ * after `resetAfter` ms of silence.
+ * @param sequence Ordered list of chord steps. Each step is compared against
+ * a canonical key token (e.g. `"g"`, `"space"`, `"ctrl+s"`).
+ * @param callback Invoked exactly once per successful chord match. Latest
+ * reference is captured in a ref.
+ * @param options Optional `isActive` flag and `resetAfter` silence timeout.
+ */
 declare const useKeyChord: (sequence: ReadonlyArray<KeyChordStep>, callback: () => void, options?: UseKeyChordOptions) => void;
 export { KeyChordStep, UseKeyChordOptions, useKeyChord as default, useKeyChord };

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

@@ -1,45 +1,45 @@
 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
-  */
+   * 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` is the dedicated API for paste blobs. `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 while a
-* `usePaste` handler is active.
-*
-* If no `usePaste` handler is active, Ink still forwards bracketed paste text to
-* `useInput` for backward compatibility. That fallback is deprecated and will be
-* removed in the next major version.
-*
-* ```
-* import {useInput} from '@visulima/tui/hooks/use-input';
-* import {usePaste} from '@visulima/tui/hooks/use-paste';
-*
-* 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 …
-* };
-* ```
-*/
+ * 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` is the dedicated API for paste blobs. `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 while a
+ * `usePaste` handler is active.
+ *
+ * If no `usePaste` handler is active, Ink still forwards bracketed paste text to
+ * `useInput` for backward compatibility. That fallback is deprecated and will be
+ * removed in the next major version.
+ *
+ * ```
+ * import {useInput} from '@visulima/tui/hooks/use-input';
+ * import {usePaste} from '@visulima/tui/hooks/use-paste';
+ *
+ * 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 { usePaste as default, usePaste };

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

@@ -1 +1 @@
-import{useEffectEvent as c,useEffect as a}from"react";import{j as u}from"../../packem_shared/reconciler-DhUGYWCr.js";import{useStdinContext as m}from"./use-stdin.js";const l=(o,e={})=>{const{internal_eventEmitter:t,setBracketedPasteMode:s,setRawMode:r}=m(),f=c(o);a(()=>{if(e.isActive!==!1)return r(!0),s(!0),()=>{r(!1),s(!1)}},[e.isActive,r,s]),a(()=>{if(e.isActive===!1)return;const i=n=>{u.discreteUpdates(()=>{f(n)})};return t.on("paste",i),()=>{t.removeListener("paste",i)}},[e.isActive,t])};export{l as default,l as usePaste};
+import{useEffectEvent as c,useEffect as a}from"react";import{j as u}from"../../packem_shared/reconciler-DkwOtC5B.js";import{useStdinContext as m}from"./use-stdin.js";const l=(o,e={})=>{const{internal_eventEmitter:t,setBracketedPasteMode:s,setRawMode:r}=m(),f=c(o);a(()=>{if(e.isActive!==!1)return r(!0),s(!0),()=>{r(!1),s(!1)}},[e.isActive,r,s]),a(()=>{if(e.isActive===!1)return;const i=n=>{u.discreteUpdates(()=>{f(n)})};return t.on("paste",i),()=>{t.removeListener("paste",i)}},[e.isActive,t])};export{l as default,l as usePaste};