@visulima/tui 1.0.0-alpha.9 → 1.0.0

package/dist/ink/hooks/use-text-selection.d.ts

@@ -0,0 +1,45 @@
+import { RefObject } from 'react';
+import { D as DOMElement } from "../../packem_shared/dom.d-B4kXbaVY.js";
+import { S as Selection } from "../../packem_shared/selection.d-CI3_p8wg.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";
+import 'type-fest';
+type UseTextSelectionOptions = {
+  /**
+  * Automatically copy selected text to clipboard when selection changes.
+  * @default false
+  */
+  readonly copyOnSelect?: boolean;
+  /**
+  * Enable or disable text selection.
+  * @default true
+  */
+  readonly isActive?: boolean;
+  /**
+  * Called whenever the selection changes.
+  */
+  readonly onSelectionChange?: (selectedText: string) => void;
+};
+type UseTextSelectionResult = {
+  /** Clear the current selection. */
+  readonly clearSelection: () => void;
+  /** Select all content within the referenced element. */
+  readonly selectAll: () => void;
+  /** The currently selected text. */
+  readonly selectedText: string;
+  /** The underlying Selection instance. */
+  readonly selection: Selection;
+};
+/**
+* Hook for managing text selection on a DOM element.
+*
+* ```tsx
+* const ref = useRef(null);
+* const { selectedText, selectAll, clearSelection } = useTextSelection(ref);
+* ```
+*/
+declare const useTextSelection: (ref: RefObject<DOMElement | null>, options?: UseTextSelectionOptions) => UseTextSelectionResult;
+export { UseTextSelectionOptions, UseTextSelectionResult, useTextSelection as default, useTextSelection };

package/dist/ink/hooks/use-text-selection.js

@@ -0,0 +1 @@
+import{useRef as f,useState as p,useEffect as R,useCallback as g,useMemo as v}from"react";import{Selection as x,Range as A}from"../../packem_shared/Range-BsVYNWtg.js";import C from"./use-clipboard.js";const T=(o,d={})=>{const{copyOnSelect:c=!1,isActive:n=!0,onSelectionChange:r}=d,{copy:s}=C(),e=f(new x).current,[l,S]=p(""),a=f(r);a.current=r,R(()=>n?e.onChange(()=>{const t=e.toString();S(t),a.current?.(t),c&&t.length>0&&s(t)}):void 0,[n,e,c,s]);const u=g(()=>{const t=o.current;if(!t||!n)return;e.removeAllRanges();const m=new A;m.selectNodeContents(t),e.addRange(m)},[o,n,e]),i=g(()=>{e.removeAllRanges()},[e]);return v(()=>({clearSelection:i,selectAll:u,selectedText:l,selection:e}),[i,l,u,e])};export{T as default,T as useTextSelection};

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

@@ -0,0 +1,24 @@
+type UseTimeoutOptions = {
+  /**
+  * When false, the timer never starts. Flipping to true restarts it.
+  * @default true
+  */
+  readonly isActive?: boolean;
+};
+type UseTimeoutResult = {
+  /**
+  * Cancel the pending timer (no-op if already fired or never scheduled).
+  */
+  readonly cancel: () => void;
+  /**
+  * Restart the timer from now with the current delay.
+  */
+  readonly reset: () => void;
+};
+/**
+* A React hook that fires `callback` once after `delay` ms. Changing `delay`
+* or toggling `isActive` reschedules the timer from zero. Call `reset()` to
+* restart on demand.
+*/
+declare const useTimeout: (callback: () => void, delay: number, options?: UseTimeoutOptions) => UseTimeoutResult;
+export { UseTimeoutOptions, UseTimeoutResult, useTimeout as default, useTimeout };

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

@@ -0,0 +1 @@
+import{useRef as o,useState as d,useCallback as i,useEffect as v}from"react";const p=(u,r,s)=>{const{isActive:c=!0}=s??{},n=o(u),e=o(void 0),[a,m]=d(0);n.current=u;const f=i(()=>{e.current!==void 0&&(clearTimeout(e.current),e.current=void 0)},[]),l=i(()=>{m(t=>t+1)},[]);return v(()=>{if(!c||r<0||!Number.isFinite(r))return;const t=setTimeout(()=>{n.current()},r);return e.current=t,()=>{clearTimeout(t),e.current=void 0}},[r,c,a]),{cancel:f,reset:l}};export{p as default,p as useTimeout};

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

@@ -0,0 +1,48 @@
+type UseTimerOptions = {
+  /**
+  * Whether to start the timer immediately.
+  * @default false
+  */
+  readonly autoStart?: boolean;
+  /**
+  * Total countdown duration in milliseconds.
+  */
+  readonly duration: number;
+  /**
+  * Tick interval in milliseconds.
+  * @default 1000
+  */
+  readonly interval?: number;
+  /**
+  * Called once when the timer reaches zero.
+  */
+  readonly onTimeout?: () => void;
+};
+type UseTimerResult = {
+  /** Whether the countdown has reached zero. */
+  readonly isFinished: boolean;
+  /** Whether the timer is currently counting down. */
+  readonly isRunning: boolean;
+  /** Milliseconds remaining (clamped to >= 0). */
+  readonly remaining: number;
+  /** Reset the timer to the original duration and stop it. */
+  readonly reset: () => void;
+  /** Start the countdown. */
+  readonly start: () => void;
+  /** Stop (pause) the countdown. */
+  readonly stop: () => void;
+  /** Toggle between running and stopped. */
+  readonly toggle: () => void;
+};
+/**
+* A countdown timer hook built on `useAnimation`.
+*
+* ```tsx
+* const { remaining, isRunning, start, stop, reset, isFinished } = useTimer({
+*   duration: 60_000,
+*   onTimeout: () => console.log("Time's up!"),
+* });
+* ```
+*/
+declare function useTimer(options: UseTimerOptions): UseTimerResult;
+export { UseTimerOptions, UseTimerResult, useTimer as default, useTimer };

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

@@ -0,0 +1 @@
+import{useState as x,useRef as f,useEffect as S,useCallback as a}from"react";import b from"./use-animation.js";function A(c){const{autoStart:l=!1,duration:m,interval:g=1e3,onTimeout:u}=c,[r,e]=x(l),i=f(u);i.current=u;const n=f(!1),{reset:o,time:p}=b({interval:g,isActive:r}),s=Math.max(0,m-p),t=s<=0;S(()=>{t&&r&&(e(!1),n.current||(n.current=!0,i.current?.()))},[t,r]);const d=a(()=>{t||e(!0)},[t]),v=a(()=>{e(!1)},[]),h=a(()=>{e(T=>T?!1:s>0)},[s]),R=a(()=>{e(!1),n.current=!1,o()},[o]);return{isFinished:t,isRunning:r,remaining:s,reset:R,start:d,stop:v,toggle:h}}export{A as default,A as useTimer};

package/dist/ink/hooks/use-window-size.d.ts

@@ -0,0 +1,18 @@
+/**
+* Dimensions of the terminal window.
+*/
+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 { WindowSize, useWindowSize as default, useWindowSize };

package/dist/ink/hooks/use-window-size.js

@@ -0,0 +1 @@
+import{useState as i,useEffect as n}from"react";import{g as o}from"../../packem_shared/utils-Bup8lyK8.js";import f from"./use-stdout.js";const c=()=>{const{stdout:e}=f(),[r,s]=i(()=>o(e));return n(()=>{const t=()=>{s(o(e))};return e.on("resize",t),()=>{e.off("resize",t)}},[e]),r};export{c as default,c as useWindowSize};