@textui/testing 0.1.0 → 0.2.0

package/README.md

@@ -1,7 +1,8 @@
 # @textui/testing
 
-A headless harness for TextUI applications. No terminal, no timers, no
-snapshots of a screen nobody looked at.
+[![npm](https://img.shields.io/npm/v/@textui/testing?label=%40textui%2Ftesting)](https://www.npmjs.com/package/@textui/testing) [![license](https://img.shields.io/npm/l/@textui/testing)](https://github.com/softov/textui/blob/main/LICENSE)
+
+A headless harness for TextUI applications. No terminal, no timers, no snapshots of a screen nobody looked at.
 
 ```bash
 npm install --save-dev @textui/testing
@@ -20,9 +21,7 @@ expect(t.text()).toContain('Saved');
 
 ## Query by what it is, not where it is
 
-Every component declares a semantic role, so a test asks the way a person would
-- the Save button, the row labelled `api` - rather than by index into a tree
-that changes the moment the layout does.
+Every component declares a semantic role, so a test asks the way a person would - the Save button, the row labelled `api` - rather than by index into a tree that changes the moment the layout does.
 
 | | |
 |---|---|
@@ -32,21 +31,17 @@ that changes the moment the layout does.
 | `text()`, `line(y)`, `lines()` | What is actually on the screen |
 | `tree()` | The instance tree, for when the pixels are not the question |
 
-An `Element` is a description - role, label, text, rect, focus, props - not a
-handle. You act on the application with keys, the way a person does.
+An `Element` is a description - role, label, text, rect, focus, props - not a handle. You act on the application with keys, the way a person does.
 
 `get*` throws with the near misses listed; `query*` returns null.
 
 ## Drive it, then let it settle
 
-`press('ctrl+s')`, `pressAll('down', 'down', 'enter')`, `type('hello')`, and
-`resize(w, h)`. Effects and re-renders are asynchronous, so `await t.settle()`
-is what separates "I sent the key" from "the screen caught up".
+`press('ctrl+s')`, `pressAll('down', 'down', 'enter')`, `type('hello')`, and `resize(w, h)`. Effects and re-renders are asynchronous, so `await t.settle()` is what separates "I sent the key" from "the screen caught up".
 
 ## Test at two sizes
 
-A single fixed size skips every breakpoint and hides the layout break you were
-trying to catch. `resize` is cheap, and a loop over two sizes costs one line:
+A single fixed size skips every breakpoint and hides the layout break you were trying to catch. `resize` is cheap, and a loop over two sizes costs one line:
 
 ```ts
 for (const size of [{ width: 100, height: 30 }, { width: 60, height: 18 }]) {
@@ -56,9 +51,16 @@ for (const size of [{ width: 100, height: 30 }, { width: 60, height: 18 }]) {
 
 ## Runtime
 
-Depends on `@textui/core` and `@textui/terminal`. No `node:` imports - it runs
-on the virtual terminal, so there is no tty to have. Node 22+ and Bun.
+Depends on [`@textui/core`](https://www.npmjs.com/package/@textui/core) and [`@textui/terminal`](https://www.npmjs.com/package/@textui/terminal). No `node:` imports - it runs on the virtual terminal, so there is no tty to have. Node 22+ and Bun.
 
 ## Documentation
 
 <https://softov.github.io/textui/>
+
+<!-- family -->
+
+---
+
+Part of **[TextUI](https://github.com/softov/textui)** - [documentation](https://softov.github.io/textui/) - [getting started](https://softov.github.io/textui/getting-started.html)
+
+[`@textui/kit`](https://www.npmjs.com/package/@textui/kit) one install · [`@textui/core`](https://www.npmjs.com/package/@textui/core) the runtime · [`@textui/widgets`](https://www.npmjs.com/package/@textui/widgets) the catalog · [`@textui/terminal`](https://www.npmjs.com/package/@textui/terminal) adapters and input · **`@textui/testing`** the harness · [`@textui/cli`](https://www.npmjs.com/package/@textui/cli) the CLI

package/dist/index.d.ts

@@ -105,6 +105,24 @@ export interface Harness {
     click(x: number, y: number, button?: 'left' | 'middle' | 'right'): void;
     /** Click the centre of an element. */
     clickOn(element: Element): void;
+    /**
+     * Click the same cell `times` in a row, close enough together to count as
+     * one gesture.
+     *
+     * `click` deliberately does not: it steps the clock past the repeat window
+     * each time, so two of them are two clicks and a test that means a double
+     * click has to say so.
+     */
+    clickRepeat(x: number, y: number, times: number): void;
+    /**
+     * Press at one point, drag through any points between, and release at the
+     * last one - the whole gesture, because that is the only part of it a
+     * handler can be wrong about.
+     *
+     * The drag goes to whoever took the press, wherever the points lead, so
+     * dragging off the element under test is a case worth writing.
+     */
+    drag(from: [number, number], ...to: [number, number][]): void;
     moveMouse(x: number, y: number): void;
     wheel(x: number, y: number, delta: number): void;
     focusTerminal(focused: boolean): void;

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -69,6 +69,14 @@ async function mount(options) {
 }
 function createHarness(app, terminal, errors) {
     const flush = () => app.flush();
+    /**
+     * The clock mouse events are stamped from.
+     *
+     * A real terminal stamps them on arrival; here they are synthesised, so the
+     * harness owns the time - which is what lets "a double click" and "two
+     * clicks" be two different tests rather than a race.
+     */
+    let mouseClock = 0;
     const collect = (predicate) => {
         const tree = app.inspect();
         if (!tree)
@@ -172,8 +180,22 @@ function createHarness(app, terminal, errors) {
             flush();
         },
         click(x, y, button = 'left') {
-            app.handleInput({ type: 'mouse', action: 'down', button, x, y, ctrl: false, alt: false, shift: false, handled: false });
-            app.handleInput({ type: 'mouse', action: 'up', button, x, y, ctrl: false, alt: false, shift: false, handled: false });
+            // Past any repeat window, so consecutive clicks in a test are what they
+            // look like: separate ones.
+            mouseClock += 1000;
+            app.handleInput({ type: 'mouse', action: 'down', button, x, y, ctrl: false, alt: false, shift: false, at: mouseClock, handled: false });
+            app.handleInput({ type: 'mouse', action: 'up', button, x, y, ctrl: false, alt: false, shift: false, at: mouseClock, handled: false });
+            flush();
+        },
+        clickRepeat(x, y, times) {
+            mouseClock += 1000;
+            for (let i = 0; i < times; i++) {
+                // Inside the window, and on the same cell: the two things that make
+                // presses one gesture rather than several.
+                mouseClock += 60;
+                app.handleInput({ type: 'mouse', action: 'down', button: 'left', x, y, ctrl: false, alt: false, shift: false, at: mouseClock, handled: false });
+                app.handleInput({ type: 'mouse', action: 'up', button: 'left', x, y, ctrl: false, alt: false, shift: false, at: mouseClock, handled: false });
+            }
             flush();
         },
         clickOn(element) {
@@ -182,6 +204,19 @@ function createHarness(app, terminal, errors) {
                 throw new Error(`[textui/testing] <${element.component}> has no bounds to click`);
             this.click(rect.x + Math.floor(rect.width / 2), rect.y + Math.floor(rect.height / 2));
         },
+        drag(from, ...to) {
+            mouseClock += 1000;
+            const send = (action, [x, y]) => {
+                mouseClock += 20;
+                app.handleInput({ type: 'mouse', action, button: 'left', x, y, ctrl: false, alt: false, shift: false, at: mouseClock, handled: false });
+            };
+            send('down', from);
+            const last = to[to.length - 1] ?? from;
+            for (const point of to)
+                send('drag', point);
+            send('up', last);
+            flush();
+        },
         moveMouse(x, y) {
             app.handleInput({ type: 'mouse', action: 'move', button: 'none', x, y, ctrl: false, alt: false, shift: false, handled: false });
             flush();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@textui/testing",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Headless testing harness for TextUI - semantic queries, input, resizing, time",
   "keywords": [
     "terminal",
@@ -39,17 +39,17 @@
       "import": "./dist/index.js"
     }
   },
-  "dependencies": {
-    "@textui/widgets": "^0.1.0",
-    "@textui/terminal": "^0.1.0",
-    "@textui/core": "^0.1.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json",
     "test": "vitest run"
+  },
+  "dependencies": {
+    "@textui/core": "^0.2.0",
+    "@textui/terminal": "^0.2.0",
+    "@textui/widgets": "^0.2.0"
+  },
+  "publishConfig": {
+    "access": "public"
   }
-}
+}

package/src/index.ts

@@ -119,6 +119,24 @@ export interface Harness {
   click(x: number, y: number, button?: 'left' | 'middle' | 'right'): void;
   /** Click the centre of an element. */
   clickOn(element: Element): void;
+  /**
+   * Click the same cell `times` in a row, close enough together to count as
+   * one gesture.
+   *
+   * `click` deliberately does not: it steps the clock past the repeat window
+   * each time, so two of them are two clicks and a test that means a double
+   * click has to say so.
+   */
+  clickRepeat(x: number, y: number, times: number): void;
+  /**
+   * Press at one point, drag through any points between, and release at the
+   * last one - the whole gesture, because that is the only part of it a
+   * handler can be wrong about.
+   *
+   * The drag goes to whoever took the press, wherever the points lead, so
+   * dragging off the element under test is a case worth writing.
+   */
+  drag(from: [number, number], ...to: [number, number][]): void;
   moveMouse(x: number, y: number): void;
   wheel(x: number, y: number, delta: number): void;
   focusTerminal(focused: boolean): void;
@@ -241,6 +259,15 @@ function createHarness(
 ): Harness {
   const flush = (): void => app.flush();
 
+  /**
+   * The clock mouse events are stamped from.
+   *
+   * A real terminal stamps them on arrival; here they are synthesised, so the
+   * harness owns the time - which is what lets "a double click" and "two
+   * clicks" be two different tests rather than a race.
+   */
+  let mouseClock = 0;
+
   const collect = (predicate: (node: InspectorNode) => boolean): Element[] => {
     const tree = app.inspect();
     if (!tree) return [];
@@ -354,8 +381,22 @@ function createHarness(
       flush();
     },
     click(x, y, button = 'left') {
-      app.handleInput({ type: 'mouse', action: 'down', button, x, y, ctrl: false, alt: false, shift: false, handled: false });
-      app.handleInput({ type: 'mouse', action: 'up', button, x, y, ctrl: false, alt: false, shift: false, handled: false });
+      // Past any repeat window, so consecutive clicks in a test are what they
+      // look like: separate ones.
+      mouseClock += 1000;
+      app.handleInput({ type: 'mouse', action: 'down', button, x, y, ctrl: false, alt: false, shift: false, at: mouseClock, handled: false });
+      app.handleInput({ type: 'mouse', action: 'up', button, x, y, ctrl: false, alt: false, shift: false, at: mouseClock, handled: false });
+      flush();
+    },
+    clickRepeat(x, y, times) {
+      mouseClock += 1000;
+      for (let i = 0; i < times; i++) {
+        // Inside the window, and on the same cell: the two things that make
+        // presses one gesture rather than several.
+        mouseClock += 60;
+        app.handleInput({ type: 'mouse', action: 'down', button: 'left', x, y, ctrl: false, alt: false, shift: false, at: mouseClock, handled: false });
+        app.handleInput({ type: 'mouse', action: 'up', button: 'left', x, y, ctrl: false, alt: false, shift: false, at: mouseClock, handled: false });
+      }
       flush();
     },
     clickOn(element) {
@@ -363,6 +404,18 @@ function createHarness(
       if (!rect) throw new Error(`[textui/testing] <${element.component}> has no bounds to click`);
       this.click(rect.x + Math.floor(rect.width / 2), rect.y + Math.floor(rect.height / 2));
     },
+    drag(from, ...to) {
+      mouseClock += 1000;
+      const send = (action: 'down' | 'drag' | 'up', [x, y]: [number, number]): void => {
+        mouseClock += 20;
+        app.handleInput({ type: 'mouse', action, button: 'left', x, y, ctrl: false, alt: false, shift: false, at: mouseClock, handled: false });
+      };
+      send('down', from);
+      const last = to[to.length - 1] ?? from;
+      for (const point of to) send('drag', point);
+      send('up', last);
+      flush();
+    },
     moveMouse(x, y) {
       app.handleInput({ type: 'mouse', action: 'move', button: 'none', x, y, ctrl: false, alt: false, shift: false, handled: false });
       flush();