@mudah-cli/testing 0.5.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -1 +1,2 @@
1
1
  export { TestApp, TestResult, type TestAppOptions } from './test-app.js';
2
+ export { TestTui, type TestTuiOptions } from './test-tui.js';
package/dist/index.js CHANGED
@@ -1,2 +1,3 @@
1
1
  export { TestApp, TestResult } from './test-app.js';
2
+ export { TestTui } from './test-tui.js';
2
3
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAuB,MAAM,eAAe,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAuB,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,OAAO,EAAuB,MAAM,eAAe,CAAC"}
@@ -0,0 +1,31 @@
1
+ import { type Layout, type TreeNode } from '@mudah-cli/tui';
2
+ export interface TestTuiOptions {
3
+ cols?: number;
4
+ rows?: number;
5
+ }
6
+ /**
7
+ * Headless TUI harness. No PTY. Mount a layout, inject keys and clicks,
8
+ * read an ASCII frame or a JSON tree.
9
+ *
10
+ * ```ts
11
+ * const tui = TestTui.mount(screen.root, { cols: 80, rows: 24 });
12
+ * tui.send('down').send('enter');
13
+ * expect(tui.snapshot()).toContain('▸');
14
+ * expect(tui.tree().role).toBe('Column');
15
+ * ```
16
+ */
17
+ export declare class TestTui {
18
+ readonly root: Layout;
19
+ cols: number;
20
+ rows: number;
21
+ private constructor();
22
+ static mount(root: Layout, options?: TestTuiOptions): TestTui;
23
+ send(name: string, ch?: string): this;
24
+ paste(text: string): this;
25
+ click(x: number, y: number): this;
26
+ wheel(direction: 'up' | 'down'): this;
27
+ resize(cols: number, rows: number): this;
28
+ frame(): string[];
29
+ snapshot(): string;
30
+ tree(): TreeNode;
31
+ }
@@ -0,0 +1,82 @@
1
+ import { dumpTree } from '@mudah-cli/tui';
2
+ /**
3
+ * Headless TUI harness. No PTY. Mount a layout, inject keys and clicks,
4
+ * read an ASCII frame or a JSON tree.
5
+ *
6
+ * ```ts
7
+ * const tui = TestTui.mount(screen.root, { cols: 80, rows: 24 });
8
+ * tui.send('down').send('enter');
9
+ * expect(tui.snapshot()).toContain('▸');
10
+ * expect(tui.tree().role).toBe('Column');
11
+ * ```
12
+ */
13
+ export class TestTui {
14
+ root;
15
+ cols;
16
+ rows;
17
+ constructor(root, cols, rows) {
18
+ this.root = root;
19
+ this.cols = cols;
20
+ this.rows = rows;
21
+ this.root.resize(cols, rows);
22
+ }
23
+ static mount(root, options = {}) {
24
+ return new TestTui(root, options.cols ?? 80, options.rows ?? 24);
25
+ }
26
+ send(name, ch) {
27
+ const event = { name, ch: ch ?? (name.length === 1 ? name : undefined) };
28
+ this.root.handleKey(event);
29
+ return this;
30
+ }
31
+ paste(text) {
32
+ this.root.handleKey({ name: 'paste', paste: text });
33
+ return this;
34
+ }
35
+ click(x, y) {
36
+ this.root.handleMouse(click(x, y));
37
+ return this;
38
+ }
39
+ wheel(direction) {
40
+ this.root.handleMouse({
41
+ ...click(0, 0),
42
+ buttons: { left: false, middle: false, right: false, extra: false },
43
+ wheel: direction,
44
+ });
45
+ return this;
46
+ }
47
+ resize(cols, rows) {
48
+ this.cols = cols;
49
+ this.rows = rows;
50
+ this.root.resize(cols, rows);
51
+ return this;
52
+ }
53
+ frame() {
54
+ this.root.resize(this.cols, this.rows);
55
+ const lines = this.root.render();
56
+ const out = lines.slice(0, this.rows);
57
+ while (out.length < this.rows)
58
+ out.push('');
59
+ return out;
60
+ }
61
+ snapshot() {
62
+ return this.frame().join('\n').replace(/[ \t]+\n/g, '\n').trimEnd();
63
+ }
64
+ tree() {
65
+ this.root.resize(this.cols, this.rows);
66
+ return dumpTree(this.root);
67
+ }
68
+ }
69
+ function click(x, y) {
70
+ return {
71
+ x,
72
+ y,
73
+ buttons: { left: true, middle: false, right: false, extra: false },
74
+ hover: false,
75
+ release: false,
76
+ drag: false,
77
+ shift: false,
78
+ alt: false,
79
+ ctrl: false,
80
+ };
81
+ }
82
+ //# sourceMappingURL=test-tui.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"test-tui.js","sourceRoot":"","sources":["../src/test-tui.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mudah-cli/testing",
3
- "version": "0.5.0",
3
+ "version": "0.7.0",
4
4
  "description": "In-process command test runner with captured output, mocked prompts, and JSON assertions.",
5
5
  "type": "module",
6
6
  "license": "MIT",
@@ -18,12 +18,12 @@
18
18
  ],
19
19
  "sideEffects": false,
20
20
  "dependencies": {
21
- "@mudah-cli/animation": "^0.5.0",
22
- "@mudah-cli/console": "^0.5.0",
23
- "@mudah-cli/core": "^0.5.0",
24
- "@mudah-cli/terminal": "^0.5.0",
25
- "@mudah-cli/tui": "^0.5.0",
26
- "@mudah-cli/ui": "^0.5.0"
21
+ "@mudah-cli/animation": "^0.7.0",
22
+ "@mudah-cli/console": "^0.7.0",
23
+ "@mudah-cli/core": "^0.7.0",
24
+ "@mudah-cli/terminal": "^0.7.0",
25
+ "@mudah-cli/tui": "^0.7.0",
26
+ "@mudah-cli/ui": "^0.7.0"
27
27
  },
28
28
  "publishConfig": {
29
29
  "access": "public"