@visulima/tui 2.0.0 → 2.0.1

package/dist/testing/index.d.ts

@@ -1,287 +1,287 @@
 import { ReactElement } from 'react';
-import { R as RenderOptions } from "../packem_shared/render.d-BvfwvSCx.js";
-import "../packem_shared/dom.d-g-nsYquD.js";
+import { R as RenderOptions } from "../packem_shared/render.d-DjQhFsiN.js";
+import "../packem_shared/dom.d-CLGlidfI.js";
 import 'yoga-layout';
 import "../ink/public/cursor.js";
 import '@visulima/colorize';
-import "../packem_shared/styles.d-D7iZuNC-.js";
+import "../packem_shared/styles.d-CKGQFfm4.js";
 import 'type-fest';
-import "../packem_shared/app-context.d-CG88lgkg.js";
+import "../packem_shared/app-context.d-DMLw5Nxy.js";
 import 'node:stream';
 declare const KEY: {
   readonly backspace: "";
   readonly ctrlC: "";
-  readonly delete: "\x1B[3~";
-  readonly down: "\x1B[B";
-  readonly end: "\x1B[F";
-  readonly escape: "\x1B";
-  readonly home: "\x1B[H";
-  readonly left: "\x1B[D";
-  readonly pageDown: "\x1B[6~";
-  readonly pageUp: "\x1B[5~";
+  readonly delete: "[3~";
+  readonly down: "";
+  readonly end: "";
+  readonly escape: "";
+  readonly home: "";
+  readonly left: "";
+  readonly pageDown: "[6~";
+  readonly pageUp: "[5~";
   readonly return: "\r";
-  readonly right: "\x1B[C";
+  readonly right: "";
   readonly space: " ";
-  readonly tab: "	";
-  readonly up: "\x1B[A";
+  readonly tab: "\t";
+  readonly up: "";
 };
 type KeyName = keyof typeof KEY;
 interface KeySender {
   /**
-  * Simulate pressing the backspace key.
-  */
+   * Simulate pressing the backspace key.
+   */
   backspace: () => void;
   /**
-  * Simulate pressing the delete key.
-  */
+   * Simulate pressing the delete key.
+   */
   delete: () => void;
   /**
-  * Simulate pressing the down arrow key.
-  */
+   * Simulate pressing the down arrow key.
+   */
   down: () => void;
   /**
-  * Simulate pressing the end key.
-  */
+   * Simulate pressing the end key.
+   */
   end: () => void;
   /**
-  * Simulate pressing the enter/return key.
-  */
+   * Simulate pressing the enter/return key.
+   */
   enter: () => void;
   /**
-  * Simulate pressing the escape key.
-  */
+   * Simulate pressing the escape key.
+   */
   escape: () => void;
   /**
-  * Simulate pressing the home key.
-  */
+   * Simulate pressing the home key.
+   */
   home: () => void;
   /**
-  * Simulate pressing the left arrow key.
-  */
+   * Simulate pressing the left arrow key.
+   */
   left: () => void;
   /**
-  * Simulate pressing the page down key.
-  */
+   * Simulate pressing the page down key.
+   */
   pageDown: () => void;
   /**
-  * Simulate pressing the page up key.
-  */
+   * Simulate pressing the page up key.
+   */
   pageUp: () => void;
   /**
-  * Send a single character as a key press.
-  */
+   * Send a single character as a key press.
+   */
   press: (char: string) => void;
   /**
-  * Send arbitrary raw data to stdin.
-  */
+   * Send arbitrary raw data to stdin.
+   */
   raw: (data: string) => void;
   /**
-  * Simulate pressing the right arrow key.
-  */
+   * Simulate pressing the right arrow key.
+   */
   right: () => void;
   /**
-  * Simulate pressing the space key.
-  */
+   * Simulate pressing the space key.
+   */
   space: () => void;
   /**
-  * Simulate pressing the tab key.
-  */
+   * Simulate pressing the tab key.
+   */
   tab: () => void;
   /**
-  * Type a string character by character.
-  */
+   * Type a string character by character.
+   */
   type: (text: string) => void;
   /**
-  * Simulate pressing the up arrow key.
-  */
+   * Simulate pressing the up arrow key.
+   */
   up: () => void;
 }
 declare const createKeySender: (write: (data: string) => void) => KeySender;
 interface Screen {
   /**
-  * Check if the current screen output contains the given text (ANSI-stripped).
-  */
+   * Check if the current screen output contains the given text (ANSI-stripped).
+   */
   contains: (text: string) => boolean;
   /**
-  * Get all captured frames with ANSI codes stripped.
-  */
+   * Get all captured frames with ANSI codes stripped.
+   */
   frames: () => string[];
   /**
-  * Get a specific line by zero-based index from the current screen output.
-  */
+   * Get a specific line by zero-based index from the current screen output.
+   */
   line: (n: number) => string;
   /**
-  * Get all non-empty lines from the current screen output.
-  */
+   * Get all non-empty lines from the current screen output.
+   */
   lines: () => string[];
   /**
-  * Check if the current screen output matches the given pattern (ANSI-stripped).
-  */
+   * Check if the current screen output matches the given pattern (ANSI-stripped).
+   */
   matches: (pattern: RegExp) => boolean;
   /**
-  * Get all captured frames with ANSI codes preserved.
-  */
+   * Get all captured frames with ANSI codes preserved.
+   */
   rawFrames: () => string[];
   /**
-  * Get the last rendered frame with ANSI codes preserved.
-  */
+   * Get the last rendered frame with ANSI codes preserved.
+   */
   rawText: () => string;
   /**
-  * Get the last rendered frame with ANSI codes stripped.
-  */
+   * Get the last rendered frame with ANSI codes stripped.
+   */
   text: () => string;
 }
 declare const createScreen: (lastFrame: () => string | undefined, allFrames: ReadonlyArray<string>) => Screen;
 interface WaitForOptions {
   /**
-  * Polling interval in milliseconds.
-  * @default 50
-  */
+   * Polling interval in milliseconds.
+   * @default 50
+   */
   interval?: number;
   /**
-  * Maximum time to wait in milliseconds before throwing.
-  * @default 3000
-  */
+   * Maximum time to wait in milliseconds before throwing.
+   * @default 3000
+   */
   timeout?: number;
 }
 /**
-* Wait for a condition to be met by polling at a regular interval.
-*
-* If `condition` is a string, waits until `screenText()` contains it.
-* If `condition` is a function, waits until it stops throwing.
-* @throws The last error encountered if the timeout is reached.
-*/
+ * Wait for a condition to be met by polling at a regular interval.
+ *
+ * If `condition` is a string, waits until `screenText()` contains it.
+ * If `condition` is a function, waits until it stops throwing.
+ * @throws The last error encountered if the timeout is reached.
+ */
 declare const waitFor: (condition: (() => void) | string, screenText: () => string, options?: WaitForOptions) => Promise<void>;
 type TestInstanceStdout = {
   /**
-  * All rendered frames captured from stdout.
-  */
+   * All rendered frames captured from stdout.
+   */
   readonly frames: ReadonlyArray<string>;
   /**
-  * Returns the most recently rendered frame, or `undefined` if no frames have been written.
-  */
+   * Returns the most recently rendered frame, or `undefined` if no frames have been written.
+   */
   lastFrame: () => string | undefined;
   /**
-  * Write data to the mock stdout stream (used internally by the renderer).
-  */
+   * Write data to the mock stdout stream (used internally by the renderer).
+   */
   write: (frame: string) => boolean;
 };
 type TestInstanceStderr = {
   /**
-  * All rendered frames captured from stderr.
-  */
+   * All rendered frames captured from stderr.
+   */
   readonly frames: ReadonlyArray<string>;
   /**
-  * Returns the most recently rendered frame, or `undefined` if no frames have been written.
-  */
+   * Returns the most recently rendered frame, or `undefined` if no frames have been written.
+   */
   lastFrame: () => string | undefined;
   /**
-  * Write data to the mock stderr stream (used internally by the renderer).
-  */
+   * Write data to the mock stderr stream (used internally by the renderer).
+   */
   write: (frame: string) => boolean;
 };
 type TestInstanceStdin = {
   /**
-  * Whether the stdin is a TTY.
-  */
+   * Whether the stdin is a TTY.
+   */
   readonly isTTY: boolean;
   /**
-  * Simulate user input by writing data to stdin.
-  */
+   * Simulate user input by writing data to stdin.
+   */
   write: (data: string) => boolean;
 };
 type TestInstance = {
   /**
-  * Unmount the app and clean up resources.
-  */
+   * Unmount the app and clean up resources.
+   */
   cleanup: () => void;
   /**
-  * Wait for pending React renders to flush (two microtick delay).
-  */
+   * Wait for pending React renders to flush (two microtick delay).
+   */
   flush: () => Promise<void>;
   /**
-  * All rendered frames captured from stdout (shorthand for `stdout.frames`).
-  */
+   * All rendered frames captured from stdout (shorthand for `stdout.frames`).
+   */
   readonly frames: ReadonlyArray<string>;
   /**
-  * Keyboard input helpers for simulating key presses.
-  */
+   * Keyboard input helpers for simulating key presses.
+   */
   keys: KeySender;
   /**
-  * Returns the most recently rendered frame from stdout (shorthand for `stdout.lastFrame()`).
-  */
+   * Returns the most recently rendered frame from stdout (shorthand for `stdout.lastFrame()`).
+   */
   lastFrame: () => string | undefined;
   /**
-  * Replace the previous root node with a new one or update props.
-  */
+   * Replace the previous root node with a new one or update props.
+   */
   rerender: (node: ReactElement) => void;
   /**
-  * Screen query helpers for inspecting rendered output with ANSI stripping.
-  */
+   * Screen query helpers for inspecting rendered output with ANSI stripping.
+   */
   screen: Screen;
   /**
-  * Mock stderr stream with frame capture.
-  */
+   * Mock stderr stream with frame capture.
+   */
   stderr: TestInstanceStderr;
   /**
-  * Mock stdin stream for simulating user input.
-  */
+   * Mock stdin stream for simulating user input.
+   */
   stdin: TestInstanceStdin;
   /**
-  * Mock stdout stream with frame capture.
-  */
+   * Mock stdout stream with frame capture.
+   */
   stdout: TestInstanceStdout;
   /**
-  * Manually unmount the whole app.
-  */
+   * Manually unmount the whole app.
+   */
   unmount: () => void;
   /**
-  * Wait for a condition to be met by polling.
-  *
-  * If `condition` is a string, waits until the screen contains it.
-  * If `condition` is a function, waits until it stops throwing.
-  */
+   * Wait for a condition to be met by polling.
+   *
+   * If `condition` is a string, waits until the screen contains it.
+   * If `condition` is a function, waits until it stops throwing.
+   */
   waitFor: (condition: (() => void) | string, options?: WaitForOptions) => Promise<void>;
 };
 type TestRenderOptions = {
   /**
-  * Terminal column width for the mock stdout/stderr streams.
-  * @default 100
-  */
+   * Terminal column width for the mock stdout/stderr streams.
+   * @default 100
+   */
   columns?: number;
   /**
-  * Additional render options passed through to the underlying render function.
-  */
+   * Additional render options passed through to the underlying render function.
+   */
   options?: Omit<RenderOptions, "debug" | "exitOnCtrlC" | "patchConsole" | "stderr" | "stdin" | "stdout">;
 };
 /**
-* Render a React element for testing, capturing output in mock streams.
-*
-* Returns an object with methods to inspect rendered output, simulate input,
-* and control the component lifecycle.
-* @example
-* ```tsx
-* import { render } from "@visulima/tui/test";
-* import { Text } from "@visulima/tui";
-*
-* const { lastFrame } = render(<Text>Hello</Text>);
-* console.log(lastFrame()); // "Hello"
-* ```
-*/
+ * Render a React element for testing, capturing output in mock streams.
+ *
+ * Returns an object with methods to inspect rendered output, simulate input,
+ * and control the component lifecycle.
+ * @example
+ * ```tsx
+ * import { render } from "@visulima/tui/test";
+ * import { Text } from "@visulima/tui";
+ *
+ * const { lastFrame } = render(<Text>Hello</Text>);
+ * console.log(lastFrame()); // "Hello"
+ * ```
+ */
 declare const testRender: (node: ReactElement, testOptions?: TestRenderOptions) => TestInstance;
 /**
-* Unmount and clean up all rendered test instances.
-*
-* Call this in your test teardown (e.g., `afterEach`) to ensure
-* no test instances leak between tests.
-* @example
-* ```ts
-* import { cleanup } from "@visulima/tui/test";
-*
-* afterEach(() => {
-*     cleanup();
-* });
-* ```
-*/
+ * Unmount and clean up all rendered test instances.
+ *
+ * Call this in your test teardown (e.g., `afterEach`) to ensure
+ * no test instances leak between tests.
+ * @example
+ * ```ts
+ * import { cleanup } from "@visulima/tui/test";
+ *
+ * afterEach(() => {
+ *     cleanup();
+ * });
+ * ```
+ */
 declare const cleanup: () => void;
 export { KEY, type KeyName, type KeySender, type Screen, TestInstance, TestInstanceStderr, TestInstanceStdin, TestInstanceStdout, TestRenderOptions, type WaitForOptions, cleanup, createKeySender, createScreen, testRender as render, waitFor };

package/dist/testing/index.js

@@ -1 +1 @@
-import{createRequire as _}from"node:module";import F from"../packem_shared/render-D7aV_hO1.js";import{createKeySender as x}from"../packem_shared/KEY-C--kOw41.js";import{KEY as K}from"../packem_shared/KEY-C--kOw41.js";import{createScreen as y}from"../packem_shared/createScreen-DoYpyL0V.js";import{waitFor as T}from"../packem_shared/waitFor-CTAki32d.js";const g=_(import.meta.url),a=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,w=t=>{if(typeof a<"u"&&a.versions&&a.versions.node){const[e,n]=a.versions.node.split(".").map(Number);if(e>22||e===22&&n>=3||e===20&&n>=16)return a.getBuiltinModule(t)}return g(t)},m=w("node:events");class b extends m{columns;_lastFrame;_frames=[];constructor(e=100){super(),this.columns=e}get frames(){return this._frames}lastFrame(){return this._lastFrame}write=e=>(this._frames.push(e),this._lastFrame=e,!0)}class v extends m{columns;_lastFrame;_frames=[];constructor(e=100){super(),this.columns=e}get frames(){return this._frames}lastFrame(){return this._lastFrame}write=e=>(this._frames.push(e),this._lastFrame=e,!0)}class j extends m{isTTY=!0;pendingData;write=e=>(this.pendingData=e,this.emit("readable"),this.emit("data",e),!0);read(){const{pendingData:e}=this;return this.pendingData=void 0,e}setEncoding(){return this}setRawMode(){return this}resume(){return this}pause(){return this}ref(){return this}unref(){return this}}const u=[],P=(t,e={})=>{const{columns:n,options:d}=e,s=new b(n),c=new v(n),o=new j,i=F(t,{debug:!0,exitOnCtrlC:!1,patchConsole:!1,stderr:c,stdin:o,stdout:s,...d});u.push(i);const l=y(()=>s.lastFrame(),s.frames),p=x(r=>o.write(r)),f=async()=>{await new Promise(r=>{setTimeout(r,0)}),await new Promise(r=>{setTimeout(r,0)})};return{cleanup:i.cleanup,flush:f,get frames(){return s.frames},keys:p,lastFrame:()=>s.lastFrame(),rerender:i.rerender,screen:l,stderr:c,stdin:o,stdout:s,unmount:i.unmount,async waitFor(r,h){await T(r,()=>l.text(),h)}}},S=()=>{for(const t of u)t.cleanup();u.length=0};export{K as KEY,S as cleanup,x as createKeySender,y as createScreen,P as render,T as waitFor};
+import{createRequire as _}from"node:module";import x from"../packem_shared/render-CuCo-R-l.js";import{createKeySender as y}from"../packem_shared/KEY-C--kOw41.js";import{KEY as Y}from"../packem_shared/KEY-C--kOw41.js";import{createScreen as T}from"../packem_shared/createScreen-DoYpyL0V.js";import{waitFor as b}from"../packem_shared/waitFor-CTAki32d.js";let g;const w=t=>(g??=_(import.meta.url))(t),a=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,F=t=>{if(typeof a<"u"&&a.versions&&a.versions.node){const[e,n]=a.versions.node.split(".").map(Number);if(e>22||e===22&&n>=3||e===20&&n>=16)return a.getBuiltinModule(t)}return w(t)},m=F("node:events");class j extends m{columns;_lastFrame;_frames=[];constructor(e=100){super(),this.columns=e}get frames(){return this._frames}lastFrame(){return this._lastFrame}write=e=>(this._frames.push(e),this._lastFrame=e,!0)}class v extends m{columns;_lastFrame;_frames=[];constructor(e=100){super(),this.columns=e}get frames(){return this._frames}lastFrame(){return this._lastFrame}write=e=>(this._frames.push(e),this._lastFrame=e,!0)}class R extends m{isTTY=!0;pendingData;write=e=>(this.pendingData=e,this.emit("readable"),this.emit("data",e),!0);read(){const{pendingData:e}=this;return this.pendingData=void 0,e}setEncoding(){return this}setRawMode(){return this}resume(){return this}pause(){return this}ref(){return this}unref(){return this}}const u=[],S=(t,e={})=>{const{columns:n,options:d}=e,s=new j(n),c=new v(n),o=new R,i=x(t,{debug:!0,exitOnCtrlC:!1,patchConsole:!1,stderr:c,stdin:o,stdout:s,...d});u.push(i);const l=T(()=>s.lastFrame(),s.frames),p=y(r=>o.write(r)),f=async()=>{await new Promise(r=>{setTimeout(r,0)}),await new Promise(r=>{setTimeout(r,0)})};return{cleanup:i.cleanup,flush:f,get frames(){return s.frames},keys:p,lastFrame:()=>s.lastFrame(),rerender:i.rerender,screen:l,stderr:c,stdin:o,stdout:s,unmount:i.unmount,async waitFor(r,h){await b(r,()=>l.text(),h)}}},B=()=>{for(const t of u)t.cleanup();u.length=0};export{Y as KEY,B as cleanup,y as createKeySender,T as createScreen,S as render,b as waitFor};