@visulima/tui 1.0.0-alpha.2 → 1.0.0-alpha.21

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

@@ -0,0 +1 @@
+var i=Object.defineProperty;var c=(e,a)=>i(e,"name",{value:a,configurable:!0});import{useCallback as m}from"react";import l from"./use-input.js";var u=Object.defineProperty,o=c((e,a)=>u(e,"name",{value:a,configurable:!0}),"o");const f=new Set(["backspace","delete","downArrow","end","escape","home","leftArrow","pageDown","pageUp","return","rightArrow","tab","upArrow"]),p=o(e=>{const a=e.split("+").map(r=>r.trim()).filter(r=>r.length>0),t={};for(const r of a){const s=r.toLowerCase();switch(s){case"alt":case"cmd":case"meta":{t.meta=!0;break}case"control":case"ctrl":{t.ctrl=!0;break}case"shift":{t.shift=!0;break}default:if(f.has(s))t.name=s;else switch(s){case"down":{t.name="downArrow";break}case"enter":{t.name="return";break}case"esc":{t.name="escape";break}case"left":{t.name="leftArrow";break}case"right":{t.name="rightArrow";break}case"up":{t.name="upArrow";break}default:t.input=r}}}return t},"parseShortcut"),w=o((e,a,t)=>e.ctrl!==void 0&&e.ctrl!==t.ctrl||e.shift!==void 0&&e.shift!==t.shift||e.meta!==void 0&&e.meta!==t.meta?!1:e.name!==void 0?!!t[e.name]:e.input!==void 0?a===e.input:!1,"matches"),k=o((e,a,t)=>{const r=typeof e=="string"?p(e):e;l(m((s,n)=>{w(r,s,n)&&a()},[e,a]),{isActive:t?.isActive??!0})},"useHotkey");export{k as default,k as useHotkey};

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

@@ -1,149 +1,149 @@
 /**
- * Handy information about a key that was pressed.
- */
-export type Key = {
-    /**
-     * Backspace key was pressed.
-     */
-    backspace: boolean;
-    /**
-     * Caps Lock is active.
-     *
-     * Only available with kitty keyboard protocol.
-     */
-    capsLock: boolean;
-    /**
-     * Ctrl key was pressed.
-     */
-    ctrl: boolean;
-    /**
-     * Delete key was pressed.
-     */
-    delete: boolean;
-    /**
-     * Down arrow key was pressed.
-     */
-    downArrow: boolean;
-    /**
-     * End key was pressed.
-     */
-    end: boolean;
-    /**
-     * Escape key was pressed.
-     */
-    escape: boolean;
-    /**
-     * Event type for key events.
-     *
-     * Only available with kitty keyboard protocol.
-     */
-    eventType?: "press" | "repeat" | "release";
-    /**
-     * Home key was pressed.
-     */
-    home: boolean;
-    /**
-     * Hyper key was pressed.
-     *
-     * Only available with kitty keyboard protocol.
-     */
-    hyper: boolean;
-    /**
-     * Left arrow key was pressed.
-     */
-    leftArrow: boolean;
-    /**
-     * [Meta key](https://en.wikipedia.org/wiki/Meta_key) was pressed.
-     */
-    meta: boolean;
-    /**
-     * Num Lock is active.
-     *
-     * Only available with kitty keyboard protocol.
-     */
-    numLock: boolean;
-    /**
-     * Page Down key was pressed.
-     */
-    pageDown: boolean;
-    /**
-     * Page Up key was pressed.
-     */
-    pageUp: boolean;
-    /**
-     * Return (Enter) key was pressed.
-     */
-    return: boolean;
-    /**
-     * Right arrow key was pressed.
-     */
-    rightArrow: boolean;
-    /**
-     * Shift key was pressed.
-     */
-    shift: boolean;
-    /**
-     * Super key (Cmd on Mac, Win on Windows) was pressed.
-     *
-     * Only available with kitty keyboard protocol.
-     */
-    super: boolean;
-    /**
-     * Tab key was pressed.
-     */
-    tab: boolean;
-    /**
-     * Up arrow key was pressed.
-     */
-    upArrow: boolean;
+* Handy information about a key that was pressed.
+*/
+type Key = {
+  /**
+  * Backspace key was pressed.
+  */
+  backspace: boolean;
+  /**
+  * Caps Lock is active.
+  *
+  * Only available with kitty keyboard protocol.
+  */
+  capsLock: boolean;
+  /**
+  * Ctrl key was pressed.
+  */
+  ctrl: boolean;
+  /**
+  * Delete key was pressed.
+  */
+  delete: boolean;
+  /**
+  * Down arrow key was pressed.
+  */
+  downArrow: boolean;
+  /**
+  * End key was pressed.
+  */
+  end: boolean;
+  /**
+  * Escape key was pressed.
+  */
+  escape: boolean;
+  /**
+  * Event type for key events.
+  *
+  * Only available with kitty keyboard protocol.
+  */
+  eventType?: "press" | "repeat" | "release";
+  /**
+  * Home key was pressed.
+  */
+  home: boolean;
+  /**
+  * Hyper key was pressed.
+  *
+  * Only available with kitty keyboard protocol.
+  */
+  hyper: boolean;
+  /**
+  * Left arrow key was pressed.
+  */
+  leftArrow: boolean;
+  /**
+  * [Meta key](https://en.wikipedia.org/wiki/Meta_key) was pressed.
+  */
+  meta: boolean;
+  /**
+  * Num Lock is active.
+  *
+  * Only available with kitty keyboard protocol.
+  */
+  numLock: boolean;
+  /**
+  * Page Down key was pressed.
+  */
+  pageDown: boolean;
+  /**
+  * Page Up key was pressed.
+  */
+  pageUp: boolean;
+  /**
+  * Return (Enter) key was pressed.
+  */
+  return: boolean;
+  /**
+  * Right arrow key was pressed.
+  */
+  rightArrow: boolean;
+  /**
+  * Shift key was pressed.
+  */
+  shift: boolean;
+  /**
+  * Super key (Cmd on Mac, Win on Windows) was pressed.
+  *
+  * Only available with kitty keyboard protocol.
+  */
+  super: boolean;
+  /**
+  * Tab key was pressed.
+  */
+  tab: boolean;
+  /**
+  * 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
-     */
-    imeEnabled?: boolean;
-    /**
-     * 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
-     */
-    isActive?: boolean;
+  /**
+  * 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
+  */
+  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
+  */
+  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 'ink';
- *
- * 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 default useInput;
+export { Key, useInput as default, useInput };

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

@@ -0,0 +1,2 @@
+var K=Object.defineProperty;var m=(e,r)=>K(e,"name",{value:r,configurable:!0});import{createRequire as S}from"node:module";import{useRef as I,useEffectEvent as $,useEffect as w}from"react";import{IMECompositionBuffer as q,isIMEInput as j}from"../../packem_shared/IMECompositionBuffer-C89PhiOu.js";import{kittyModifiers as u}from"../../packem_shared/kittyFlags-C3rZLbcK.js";import{L as x}from"../../packem_shared/reconciler-CUbhOvcr.js";import{useStdinContext as N}from"./use-stdin.js";const _=S(import.meta.url),h=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,E=m(e=>{if(typeof h<"u"&&h.versions&&h.versions.node){const[r,s]=h.versions.node.split(".").map(Number);if(r>22||r===22&&s>=3||r===20&&s>=16)return h.getBuiltinModule(e)}return _(e)},"__cjs_getBuiltinModule"),{Buffer:M}=E("node:buffer");var T=Object.defineProperty,c=m((e,r)=>T(e,"name",{value:r,configurable:!0}),"i");const D=/^\u001B([a-z0-9])$/i,R=/^\u001B+([ON[]|\[\[)(?:(\d+)(?:;(\d+))?([~^$])|(?:1;)?(\d+)?([a-zA-Z]))/,C={"[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"},Z=[...Object.values(C),"backspace"],F=c(e=>["[2$","[3$","[5$","[6$","[7$","[8$","[a","[b","[c","[d","[e","[Z"].includes(e),"isShiftKey"),U=c(e=>["[2^","[3^","[5^","[6^","[7^","[8^","Oa","Ob","Oc","Od","Oe"].includes(e),"isCtrlKey"),P=/^\u001B\[(\d+)(?:;(\d+)(?::(\d+))?(?:;([\d:]+))?)?u$/,z=/^\u001B\[(\d+);(\d+):(\d+)([A-Z~])$/i,H={A:"up",B:"down",C:"right",D:"left",E:"clear",F:"end",H:"home",P:"f1",Q:"f2",R:"f3",S:"f4"},Q={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"},A={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"},L=c(e=>e>=0&&e<=1114111&&!(e>=55296&&e<=57343),"isValidCodepoint"),y=c(e=>L(e)?String.fromCodePoint(e):"?","safeFromCodePoint");function B(e){return e===3?"release":e===2?"repeat":"press"}m(B,"k");c(B,"resolveEventType");function O(e){return{capsLock:!!(e&u.capsLock),ctrl:!!(e&u.ctrl),hyper:!!(e&u.hyper),meta:!!(e&u.meta),numLock:!!(e&u.numLock),option:!!(e&u.alt),shift:!!(e&u.shift),super:!!(e&u.super)}}m(O,"h");c(O,"parseKittyModifiers");const V=c(e=>{const r=P.exec(e);if(!r)return null;const s=Number.parseInt(r[1],10),p=r[2]?Math.max(0,Number.parseInt(r[2],10)-1):0,t=r[3]?Number.parseInt(r[3],10):1,l=r[4];if(!L(s))return null;let n;l&&(n=l.split(":").map(k=>y(Number.parseInt(k,10))).join(""));let i,f;return s===32?(i="space",f=!0):s===13?(i="return",f=!0):A[s]?(i=A[s],f=!1):s>=1&&s<=26?(i=String.fromCodePoint(s+96),f=!1):(i=y(s).toLowerCase(),f=!0),f&&!n&&(n=y(s)),{name:i,...O(p),eventType:B(t),isKittyProtocol:!0,isPrintable:f,raw:e,sequence:e,text:n}},"parseKittyKeypress"),W=c(e=>{const r=z.exec(e);if(!r)return null;const s=Number.parseInt(r[1],10),p=Math.max(0,Number.parseInt(r[2],10)-1),t=Number.parseInt(r[3],10),l=r[4],n=l==="~"?Q[s]:H[l];return n?{name:n,...O(p),eventType:B(t),isKittyProtocol:!0,isPrintable:!1,raw:e,sequence:e}:null},"parseKittySpecialKey"),G=c((e="")=>{let r;M.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=V(e);if(s)return s;const p=W(e);if(p)return p;if(P.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(r=D.exec(e))t.meta=!0,t.shift=/^[A-Z]$/.test(r[1]);else if(r=R.exec(e)){const l=[...e];l[0]==="\x1B"&&l[1]==="\x1B"&&(t.option=!0);const n=[r[1],r[2],r[4],r[6]].filter(Boolean).join(""),i=(r[3]||r[5]||1)-1;t.ctrl=!!(i&4),t.meta=!!(i&10),t.shift=!!(i&1),t.code=n,t.name=C[n]??"",t.shift=F(n)||t.shift,t.ctrl=U(n)||t.ctrl}}return t},"parseKeypress");var J=Object.defineProperty,v=m((e,r)=>J(e,"name",{value:r,configurable:!0}),"l");const ne=v((e,r={})=>{const{internal_eventEmitter:s,internal_exitOnCtrlC:p,setRawMode:t,stdin:l}=N(),n=r.imeEnabled??!0,i=r.imeTimeout??50,f=I(void 0),k=$(e);w(()=>{if(n)return f.current=new q({onFlush:v(g=>{const d={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};x.discreteUpdates(()=>{k(g,d)})},"onFlush"),timeout:i}),()=>{f.current?.destroy(),f.current=void 0}},[n,i]),w(()=>{if(r.isActive!==!1)return t(!0),()=>{t(!1)}},[r.isActive,t]),w(()=>{if(r.isActive===!1)return;const g=v(d=>{if(n&&j(d)){f.current?.add(d);return}f.current?.flush();const a=G(d),b={backspace:a.name==="backspace",capsLock:a.capsLock??!1,ctrl:a.ctrl,delete:a.name==="delete",downArrow:a.name==="down",end:a.name==="end",escape:a.name==="escape",eventType:a.eventType,home:a.name==="home",hyper:a.hyper??!1,leftArrow:a.name==="left",meta:a.meta||a.option,numLock:a.numLock??!1,pageDown:a.name==="pagedown",pageUp:a.name==="pageup",return:a.name==="return",rightArrow:a.name==="right",shift:a.shift,super:a.super??!1,tab:a.name==="tab",upArrow:a.name==="up"};let o;a.isKittyProtocol?a.isPrintable?o=a.text??a.name:a.ctrl&&a.name.length===1?o=a.name:o="":a.ctrl?o=a.name:o=a.sequence,!a.isKittyProtocol&&Z.includes(a.name)&&(o=""),o.startsWith("\x1B")&&(o=o.slice(1)),o.length===1&&typeof o[0]=="string"&&/[A-Z]/.test(o[0])&&(b.shift=!0),!(o==="c"&&b.ctrl&&p)&&(!a.name&&o===""||x.discreteUpdates(()=>{k(o,b)}))},"handleData");return s.on("input",g),()=>{s.removeListener("input",g)}},[r.isActive,l,p,n])},"useInput");export{ne as default,ne as useInput};

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

@@ -0,0 +1,25 @@
+type UseIntervalOptions = {
+  /**
+  * 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.
+  */
+  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.
+*/
+declare const useInterval: (callback: () => void, interval: number, options?: UseIntervalOptions) => UseIntervalResult;
+export { UseIntervalOptions, UseIntervalResult, useInterval as default, useInterval };

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

@@ -0,0 +1 @@
+var o=Object.defineProperty;var c=(e,r)=>o(e,"name",{value:r,configurable:!0});import{useRef as s,useLayoutEffect as l,useEffect as v,useCallback as f}from"react";var d=Object.defineProperty,I=c((e,r)=>d(e,"name",{value:r,configurable:!0}),"o");const p=I((e,r,i)=>{const{isActive:u=!0}=i??{},n=s(e),t=s(void 0);return l(()=>{n.current=e},[e]),v(()=>{if(!u||r<=0||!Number.isFinite(r))return;const a=setInterval(()=>{n.current()},r);return t.current=a,()=>{clearInterval(a),t.current=void 0}},[r,u]),{clear:f(()=>{t.current!==void 0&&(clearInterval(t.current),t.current=void 0)},[])}},"useInterval");export{p as default,p as 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 default useIsScreenReaderEnabled;
+export { useIsScreenReaderEnabled as default, useIsScreenReaderEnabled };

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

@@ -0,0 +1 @@
+var t=Object.defineProperty;var a=(e,r)=>t(e,"name",{value:r,configurable:!0});import{useContext as n}from"react";import{a as s}from"../../packem_shared/accessibility-context-DDyHTwmA.js";var o=Object.defineProperty,c=a((e,r)=>o(e,"name",{value:r,configurable:!0}),"t");const l=c(()=>{const{isScreenReaderEnabled:e}=n(s);return e},"useIsScreenReaderEnabled");export{l as default,l as useIsScreenReaderEnabled};

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

@@ -1,61 +1,59 @@
 /**
- * A single key binding definition.
- */
-export type KeyBinding = {
-    /** Human-readable description shown in Help. */
-    readonly description: string;
-    /**
-     * 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.
-     */
-    readonly key: string | readonly string[];
+* A single key binding definition.
+*/
+type KeyBinding = {
+  /** Human-readable description shown in Help. */
+  readonly description: string;
+  /**
+  * 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.
+  */
+  readonly key: string | ReadonlyArray<string>;
 };
 /**
- * A binding paired with its handler function.
- */
-export type KeyBindingHandler = {
-    readonly binding: KeyBinding;
-    readonly handler: () => void;
+* A binding paired with its handler function.
+*/
+type KeyBindingHandler = {
+  readonly binding: KeyBinding;
+  readonly handler: () => void;
 };
 type UseKeyBindingsOptions = {
-    /**
-     * Whether keyboard input is captured.
-     *
-     * @default true
-     */
-    readonly isActive?: boolean;
+  /**
+  * Whether keyboard input is captured.
+  * @default true
+  */
+  readonly isActive?: boolean;
 };
 type UseKeyBindingsResult = {
-    /** The enabled bindings, suitable for passing to the Help component. */
-    readonly bindings: readonly KeyBinding[];
+  /** The enabled bindings, suitable for passing to the Help component. */
+  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() },
- * ]);
- *
- * <Help bindings={bindings} />
- * ```
- */
-export default function useKeyBindings(handlers: readonly KeyBindingHandler[], options?: UseKeyBindingsOptions): UseKeyBindingsResult;
-export {};
+* 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-bindings.js

@@ -0,0 +1 @@
+var g=Object.defineProperty;var a=(e,n)=>g(e,"name",{value:n,configurable:!0});import{useRef as b,useCallback as y,useMemo as m}from"react";import h from"./use-input.js";var w=Object.defineProperty,u=a((e,n)=>w(e,"name",{value:n,configurable:!0}),"d");const c=new Set(["backspace","delete","downArrow","end","escape","home","leftArrow","pageDown","pageUp","return","rightArrow","tab","upArrow"]),A=new Set(["ctrl","hyper","meta","shift","super"]);function f(e,n,i){const t=e.indexOf("+");if(t!==-1){const r=e.slice(0,t),s=e.slice(t+1);return!A.has(r)||!i[r]?!1:c.has(s)?i[s]===!0:n===s}return c.has(e)?i[e]===!0:n===e}a(f,"B");u(f,"matchesKey");function k(e,n){const{isActive:i=!0}=n??{},t=b(e);return t.current=e,h(y((r,s)=>{for(const{binding:o,handler:l}of t.current){if(o.enabled===!1)continue;const d=typeof o.key=="string"?[o.key]:o.key;for(const p of d)if(f(p,r,s)){l();return}}},[]),{isActive:i}),{bindings:m(()=>e.filter(r=>r.binding.enabled!==!1).map(r=>r.binding),[e])}}a(k,"y");u(k,"useKeyBindings");export{k as default,k as useKeyBindings};

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

@@ -0,0 +1,25 @@
+type KeyChordStep = string;
+type UseKeyChordOptions = {
+  /**
+  * Disable the chord while keeping the component rendered.
+  * @default true
+  */
+  readonly isActive?: boolean;
+  /**
+  * 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.
+*/
+declare const useKeyChord: (sequence: ReadonlyArray<KeyChordStep>, callback: () => void, options?: UseKeyChordOptions) => void;
+export { KeyChordStep, UseKeyChordOptions, useKeyChord as default, useKeyChord };

package/dist/ink/hooks/use-key-chord.js

@@ -0,0 +1 @@
+var w=Object.defineProperty;var d=(r,e)=>w(r,"name",{value:e,configurable:!0});import{useRef as p,useCallback as v}from"react";import b from"./use-input.js";var A=Object.defineProperty,o=d((r,e)=>A(r,"name",{value:e,configurable:!0}),"o");const y=o((r,e)=>{if(e.escape)return"escape";if(e.return)return"return";if(e.tab)return"tab";if(e.backspace)return"backspace";if(e.delete)return"delete";if(e.home)return"home";if(e.end)return"end";if(e.pageUp)return"pageup";if(e.pageDown)return"pagedown";if(e.upArrow)return"up";if(e.downArrow)return"down";if(e.leftArrow)return"left";if(e.rightArrow)return"right";if(r===" ")return"space";if(!(!r||r.length===0))return r},"resolveKeyName"),C=o((r,e)=>{const u=y(r,e);if(u===void 0)return;const n=[];return e.ctrl&&n.push("ctrl"),e.meta&&n.push("meta"),e.shift&&n.push("shift"),n.push(u),n.join("+")},"keyToString"),i=o(r=>r.trim().toLowerCase(),"normalizeStep"),D=o((r,e,u)=>{const{isActive:n=!0,resetAfter:c=1e3}=u??{},t=p(0),f=p(0),l=p(e);l.current=e,b(v((m,g)=>{const a=Date.now();c>0&&t.current>0&&a-f.current>c&&(t.current=0);const s=C(m,g);if(s===void 0||r.length===0)return;const h=r[t.current];if(h===void 0){t.current=0;return}if(i(s)===i(h)){t.current+=1,f.current=a,t.current>=r.length&&(t.current=0,l.current());return}t.current=0,i(s)===i(r[0]??"")&&(t.current=1,f.current=a)},[r,c]),{isActive:n})},"useKeyChord");export{D as default,D as useKeyChord};

package/dist/ink/hooks/use-linked-scroll.d.ts

@@ -1,41 +1,49 @@
-import type { RefObject } from "react";
-import type { ScrollViewRef } from "../components/scroll/ScrollView.d.ts";
-export type UseLinkedScrollReturn = {
-    /**
-     * Callback to pass to ScrollView's `onScroll` prop.
-     * Broadcasts the scroll position to all linked instances.
-     */
-    onScroll: (scrollOffset: number) => void;
-    /**
-     * Ref to attach to the ScrollView component.
-     * Used internally to call `scrollTo()` when other instances scroll.
-     */
-    ref: RefObject<ScrollViewRef | null>;
+import { RefObject } from 'react';
+import { b as ScrollViewRef } from "../../packem_shared/scroll-view.d-DtpsgHLg.js";
+import "../../components/box.js";
+import 'type-fest';
+import "../../packem_shared/dom.d-C1IxuLJ9.js";
+import 'yoga-layout';
+import "../../packem_shared/cursor-helpers.d-BONB9tky.js";
+import '@visulima/colorize';
+import 'cli-boxes';
+import "../../packem_shared/styles.d-cMo36xQz.js";
+type UseLinkedScrollReturn = {
+  /**
+  * Callback to pass to ScrollView's `onScroll` prop.
+  * Broadcasts the scroll position to all linked instances.
+  */
+  onScroll: (scrollOffset: number) => void;
+  /**
+  * Ref to attach to the ScrollView component.
+  * Used internally to call `scrollTo()` when other instances scroll.
+  */
+  ref: RefObject<ScrollViewRef | null>;
 };
-export type LinkedScrollGroup = {
-    /**
-     * Hook that returns a ref and onScroll callback for linking a ScrollView
-     * to this group. Call once per ScrollView instance.
-     */
-    useLinkedScroll: () => UseLinkedScrollReturn;
+type LinkedScrollGroup = {
+  /**
+  * Hook that returns a ref and onScroll callback for linking a ScrollView
+  * to this group. Call once per ScrollView instance.
+  */
+  useLinkedScroll: () => UseLinkedScrollReturn;
 };
 /**
- * Creates a linked scroll group that synchronizes scroll position
- * across multiple ScrollView instances.
- * @example
- * ```tsx
- * const group = createLinkedScrollGroup();
- *
- * const PanelA = () => {
- *     const { ref, onScroll } = group.useLinkedScroll();
- *     return <ScrollView ref={ref} onScroll={onScroll}>...</ScrollView>;
- * };
- *
- * const PanelB = () => {
- *     const { ref, onScroll } = group.useLinkedScroll();
- *     return <ScrollView ref={ref} onScroll={onScroll}>...</ScrollView>;
- * };
- * ```
- */
+* Creates a linked scroll group that synchronizes scroll position
+* across multiple ScrollView instances.
+* @example
+* ```tsx
+* const group = createLinkedScrollGroup();
+*
+* const PanelA = () => {
+*     const { ref, onScroll } = group.useLinkedScroll();
+*     return <ScrollView ref={ref} onScroll={onScroll}>...</ScrollView>;
+* };
+*
+* const PanelB = () => {
+*     const { ref, onScroll } = group.useLinkedScroll();
+*     return <ScrollView ref={ref} onScroll={onScroll}>...</ScrollView>;
+* };
+* ```
+*/
 declare const createLinkedScrollGroup: () => LinkedScrollGroup;
-export default createLinkedScrollGroup;
+export { LinkedScrollGroup, UseLinkedScrollReturn, createLinkedScrollGroup, createLinkedScrollGroup as default };

package/dist/ink/hooks/use-linked-scroll.js

@@ -0,0 +1 @@
+var i=Object.defineProperty;var s=(e,r)=>i(e,"name",{value:r,configurable:!0});import{useRef as u,useState as d,useEffect as S,useCallback as k}from"react";var p=Object.defineProperty,n=s((e,r)=>p(e,"name",{value:r,configurable:!0}),"t");const m=n(()=>{const e=new Set;let r=!1;return{useLinkedScroll:n(()=>{const l=u(null),[,a]=d(0),o={ref:l,setOffset:n(()=>{a(t=>t+1)},"setOffset")},c=u(o);return c.current=o,S(()=>{const{current:t}=c;return e.add(t),()=>{e.delete(t)}},[]),{onScroll:k(t=>{if(!r){r=!0;try{for(const f of e)f.ref!==l&&f.ref.current?.scrollTo(t)}finally{r=!1}}},[]),ref:l}},"useLinkedScroll")}},"createLinkedScrollGroup");export{m as createLinkedScrollGroup,m as default};