jest-runner-cli 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nojaja
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,349 @@
+# jest-runner-cli
+
+> A custom Jest runner with an imperative CLI process helper for testing CLI applications.
+
+**jest-runner-cli** is a lightweight, ESM-native Jest runner package that provides:
+- A custom Jest runner built with `create-jest-runner` for seamless integration
+- A `CliRunner` helper class to spawn and interact with child processes in tests
+- Full support for stdout/stderr monitoring, JSON parsing, and process management
+
+Perfect for testing CLI tools, scripts, and command-line applications in your Jest test suite.
+
+## Features
+
+✅ **Custom Jest Runner** — Drop-in replacement for running tests with a custom runner  
+✅ **CliRunner Helper** — Easy-to-use imperative API for spawning and controlling CLI processes  
+✅ **Flexible Output Reading** — Read stdout as lines, raw text, or parse JSON  
+✅ **Auto-Exit Protection** — Automatically detect and terminate hung processes  
+✅ **Cross-Platform** — Works on Windows, macOS, and Linux  
+✅ **ESM Native** — Built with modern ESM module support  
+✅ **TypeScript Ready** — Full type definitions included  
+
+⚠️ **Limitations** — Advanced retry strategies and custom signal handling not yet implemented
+
+## Installation
+
+```bash
+npm install --save-dev jest-runner-cli
+```
+
+**Peer Dependency:** Jest ^29.6.1
+
+## Quick Start
+
+### 1. Configure Jest
+
+Update `jest.config.js`:
+
+```js
+// jest.config.js (ESM)
+export default {
+  runner: 'jest-runner-cli',
+  testMatch: ['<rootDir>/test/**/*.test.ts']
+};
+```
+
+### 2. Use in Tests
+
+```ts
+import { CliRunner } from 'jest-runner-cli';
+
+describe('CLI testing', () => {
+  it('runs node -v and captures output', async () => {
+    const cli = new CliRunner();
+    cli.start({ command: process.execPath, args: ['-v'] });
+    
+    const lines = await cli.readStdout().toLines(2000);
+    expect(lines[0]).toMatch(/^v\d+\.\d+\.\d+/);
+    
+    await cli.sendCtrlC();
+    cli.dispose();
+  });
+});
+```
+
+## Usage Guide
+
+### Jest Runner Configuration
+
+The package acts as a Jest custom runner. Once configured in `jest.config.js`, Jest will automatically use it to execute your test files.
+
+### CliRunner API
+
+#### Basic Usage
+
+```ts
+import { CliRunner } from 'jest-runner-cli';
+
+const runner = new CliRunner();
+
+// Start a process
+runner.start({
+  command: 'node',
+  args: ['./my-script.js'],
+  cwd: process.cwd(),
+  env: process.env
+});
+
+// Write to stdin
+runner.writeln('input data');
+
+// Read output
+const output = await runner.readStdout().toLines();
+
+// Gracefully stop
+await runner.sendCtrlC();
+runner.dispose();
+```
+
+#### Reading Output
+
+```ts
+// Read as array of lines
+const lines = await runner.readStdout().toLines(2000); // timeout in ms
+
+// Read as raw string
+const text = await runner.readStdout(2000);
+
+// Extract JSON
+const json = await runner.readStdout().toJson(2000);
+
+// Get stderr
+const errors = runner.readStderr();
+
+// Clear buffer
+runner.readStdout().clear();
+```
+
+#### Handling Process Events
+
+```ts
+// Listen for process exit
+runner.on('exit', ({ code, signal }) => {
+  console.log(`Process exited with code ${code}`);
+});
+
+// Auto-exit on timeout (e.g., hung process)
+runner.start({ command: 'node', args: ['long-running.js'] }, 5000); // 5s timeout
+
+// Listen for auto-exit error
+runner.once('error', (err) => {
+  if (err.message === 'auto-exit timeout reached') {
+    console.log('Process was auto-terminated');
+  }
+});
+```
+
+### Complete Example
+
+```ts
+import { CliRunner } from 'jest-runner-cli';
+
+describe('My CLI App', () => {
+  let cli: CliRunner;
+
+  beforeEach(() => {
+    cli = new CliRunner();
+  });
+
+  afterEach(async () => {
+    await cli.sendCtrlC().catch(() => {});
+    cli.dispose();
+  });
+
+  it('displays help text', async () => {
+    cli.start({ command: 'node', args: ['./bin/cli.js', '--help'] });
+    const output = await cli.readStdout().toLines(2000);
+    
+    expect(output.join('\n')).toContain('Usage:');
+  });
+
+  it('handles JSON output', async () => {
+    cli.start({ command: 'node', args: ['./bin/cli.js', '--json'] });
+    const data = await cli.readStdout().toJson(2000);
+    
+    expect(data).toHaveProperty('version');
+  });
+
+  it('detects hung process', async () => {
+    const error = await new Promise((resolve) => {
+      cli.once('error', resolve);
+      cli.start(
+        { command: 'node', args: ['-e', 'setTimeout(() => {}, 60000)'] },
+        3000 // 3s timeout
+      );
+    });
+
+    expect(error.message).toBe('auto-exit timeout reached');
+  });
+});
+```
+
+## API Reference
+
+### CliRunner
+
+#### Methods
+
+| Method | Parameters | Returns | Description |
+|--------|-----------|---------|-------------|
+| `start()` | `SpawnOptions`, `exitWaitTimeout?` | `this` | Spawn a child process. If `exitWaitTimeout` is set (ms), the process will auto-terminate if it doesn't exit within that time. |
+| `write()` | `data: string` | `void` | Write to stdin without a newline. |
+| `writeln()` | `data: string` | `void` | Write to stdin with a newline appended. |
+| `readStdout()` | `timeout?: number` | `Promise<string>` \| `OutputHelper` | Read stdout buffer. With timeout arg, returns raw string. Without arg, returns helper with `.toLines()`, `.toJson()`, `.clear()` methods. |
+| `readStderr()` | — | `string` | Get stderr buffer (non-blocking). |
+| `sendCtrlC()` | `timeout?: number` | `Promise<void>` | Send SIGINT and wait for process exit. Falls back to SIGKILL on timeout. |
+| `dispose()` | — | `void` | Force-kill process and release resources. |
+
+#### Events
+
+| Event | Callback Arguments | Description |
+|-------|-------------------|-------------|
+| `exit` | `{ code, signal }` | Process exited. |
+| `stdout` | `chunk: string` | Data received on stdout. |
+| `stderr` | `chunk: string` | Data received on stderr. |
+| `error` | `err: Error` | Error occurred (e.g., auto-exit timeout). |
+
+#### Types
+
+```ts
+type SpawnOptions = {
+  command?: string;        // Required: command to execute
+  args?: string[];         // Command arguments
+  cwd?: string;            // Working directory
+  env?: NodeJS.ProcessEnv; // Environment variables
+};
+```
+
+## Project Structure
+
+```
+jest-runner-cli/
+├── src/
+│   ├── index.ts          # Main entry point, Jest runner export
+│   ├── run.ts            # Jest runner implementation
+│   └── CliRunner.ts      # CliRunner class
+├── test/unit/
+│   └── cliRunner.test.ts # Unit tests
+├── dist/                 # Compiled output (generated)
+├── jest.config.js        # Jest configuration
+├── tsconfig.json         # TypeScript base config
+├── tsconfig.build.json   # TypeScript build config
+└── package.json          # Package metadata
+```
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/yourusername/jest-runner-cli.git
+cd jest-runner-cli
+npm install
+```
+
+### Common Commands
+
+```bash
+npm run build      # Compile TypeScript
+npm run test       # Run tests
+npm run lint       # Check code quality
+npm run type-check # Check TypeScript types
+npm run docs       # Generate TypeDoc documentation
+npm run depcruise  # Analyze dependencies
+```
+
+### Testing
+
+```bash
+# Run all tests
+npm test
+
+# Run specific test file
+npm test -- cliRunner.test.ts
+
+# Run with coverage
+npm run test:ci
+```
+
+## Technical Details
+
+- **Runtime:** Node.js 18+, TypeScript 5.3+
+- **Module Format:** ESM (ECMAScript Modules)
+- **Jest Version:** 29.6.1+
+- **Build:** TypeScript compiled to `dist/` folder
+- **No Bundler:** Raw JS output, no webpack or similar
+
+### Implementation Notes
+
+- The Jest runner is built using `create-jest-runner` and delegates to Jest's core `runTest` function
+- TypeScript is compiled with separate configs:
+  - `tsconfig.json` — development (no emit)
+  - `tsconfig.build.json` — build (emits to `dist/`)
+- `CliRunner` is based on Node.js `child_process.spawn()` with event-driven stdout/stderr handling
+- Auto-exit timeout uses `setTimeout` to detect hung processes and escalates from `SIGINT` to `SIGKILL`
+
+## Troubleshooting
+
+### Process Not Starting
+
+**Error:** `No command provided`
+
+```ts
+// ❌ Wrong
+runner.start({});
+
+// ✅ Correct
+runner.start({ command: 'node', args: ['script.js'] });
+```
+
+### Timeout Reading Output
+
+**Error:** `stdout timeout`
+
+Increase the timeout value:
+
+```ts
+// Default 2000ms, increase if needed
+const output = await runner.readStdout().toLines(5000);
+```
+
+### Process Still Running After sendCtrlC
+
+On Windows, the process may not respond to SIGINT. The runner will auto-escalate to force-kill after timeout:
+
+```ts
+// Will escalate to taskkill after 2000ms
+await runner.sendCtrlC();
+
+// Or specify custom timeout
+await runner.sendCtrlC(5000);
+```
+
+## Changelog
+
+### v0.2.0 (Current)
+
+- ✅ Refactored to ESM with `type: module`
+- ✅ Integrated with `create-jest-runner` for Jest runner functionality
+- ✅ Added comprehensive TypeScript type definitions
+- ✅ Added auto-exit timeout feature for hung process detection
+- ✅ Updated test suite with async/await patterns
+
+### v0.1.0
+
+- Initial release with basic `CliRunner` functionality
+
+## License
+
+MIT © 2026
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit issues or pull requests.
+
+For development, ensure:
+- TypeScript strict mode is enabled
+- All tests pass (`npm test`)
+- Linting passes (`npm run lint`)
+- New features include unit tests in `test/unit/`

package/dist/CliRunner.d.ts

@@ -0,0 +1,147 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { EventEmitter } from 'events';
+/**
+ * Options describing how to spawn the child CLI process.
+ */
+export type SpawnOptions = {
+    command?: string;
+    args?: string[];
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+};
+/**
+ * CliRunner
+ *
+ * A small helper used in tests to spawn a child CLI process and read
+ * stdout/stderr conveniently. This is a near-direct extraction from the
+ * sample project and adapted to be a reusable library class.
+ */
+export declare class CliRunner extends EventEmitter {
+    private proc;
+    private stdoutBuffer;
+    private stdoutFragment;
+    private stdoutLines;
+    private stderrBuffer;
+    private _autoExitTimer;
+    /**
+     * 処理名: CliRunner 初期化
+     *
+     * 処理概要: イベントエミッタを初期化し、内部状態をセットアップする
+     *
+     * 実装理由: テスト用に子プロセスを制御するユーティリティとして振る舞うため
+     */
+    constructor();
+    private exitWaitTimeout;
+    /**
+     * 処理名: 子プロセス起動
+     *
+     * 処理概要: 指定されたコマンドで子プロセスを spawn し、stdout/stderr を監視する
+     *
+     * 実装理由: テスト内で CLI を起動・操作し出力を検査するため
+     * @param {SpawnOptions} options - 起動オプション
+     * @param {number} exitWaitTimeout - 自動終了タイムアウト (ms)
+     * @returns {this} this インスタンス
+     */
+    start(options?: SpawnOptions, exitWaitTimeout?: number): this;
+    /**
+     * stdout のハンドラを登録する
+     */
+    private _attachStdoutHandler;
+    /**
+     * stderr のハンドラを登録する
+     */
+    private _attachStderrHandler;
+    /**
+     * プロセスレベルのハンドラを登録する
+     */
+    private _attachProcessHandlers;
+    /**
+     * 処理名: stdin 書き込み
+     *
+     * 処理概要: 子プロセスの stdin にデータを書き込む
+     * @param {string} data - 書き込む文字列
+     */
+    write(data: string): void;
+    /**
+     * 処理名: stdin 書き込み（改行付き）
+     *
+     * 処理概要: 引数に改行を付与して stdin に書き込む
+     * @param {string} data - 書き込む文字列（改行は自動で追加される）
+     */
+    writeln(data: string): void;
+    /**
+     * 処理名: stdout 一括取得
+     *
+     * 処理概要: キューされている stdout 行をまとめて返す。タイムアウト付き。
+     * @param {number} timeout - タイムアウト（ms）
+     * @returns {Promise<string>} キュー内の文字列（改行区切り）を返す Promise
+     */
+    private _readStdoutOnce;
+    /**
+     * 処理名: stdout 1行取得
+     *
+     * 処理概要: キューから1行を取り出して返す。タイムアウト付き。
+     * @param {number} timeout - タイムアウト（ms）
+     * @returns {Promise<string>} キューの先頭行を返す Promise
+     */
+    private _readStdoutLineOnce;
+    /**
+     * 処理名: stdout 内の JSON を探索して返す
+     * @param {number} timeout - 総タイムアウト（ms）
+     * @returns {Promise<unknown>} 見つかった JSON オブジェクト
+     */
+    private _findJsonInStdout;
+    /**
+     * 処理名: 強制終了ユーティリティ
+     *
+     * 処理概要: タイムアウト時に子プロセスを強制終了する。Windows では `taskkill` を利用し、
+     *            それ以外は `SIGKILL` を送る。
+     * @returns {Promise<void>} 終了を待機する Promise
+     */
+    private _forceTerminate;
+    /**
+     * 処理名: stdout 取得ユーティリティ（オーバーロード）
+     *
+     * 処理概要: 引数を与えると一度にバッファを返す。引数を与えない場合は補助オブジェクトを返す。
+     * @returns `Promise<string>` または `toLines/toJson/clear` を持つヘルパオブジェクト
+     */
+    /**
+     *
+     */
+    readStdout(): {
+        toJson: (_timeout?: number) => Promise<unknown>;
+        toLines: (_timeout?: number) => Promise<string[]>;
+        clear: () => void;
+    };
+    /**
+     * 処理名: stdout 一括取得（タイムアウト付き）
+     * @param timeout - タイムアウト（ms）
+     * @returns stdout 全体を表す Promise<string>
+     */
+    readStdout(_timeout: number): Promise<string>;
+    /**
+     * 処理名: stderr 取得
+     *
+     * 処理概要: これまでに受信した stderr バッファを返す
+     * @returns {string} stderr バッファ文字列
+     */
+    readStderr(): string;
+    /**
+     * 処理名: SIGINT 送信と終了待ち
+     *
+     * 処理概要: 子プロセスへ SIGINT を送信し、終了するまで待機する。タイムアウト時は強制終了を試みる
+     * @param {number} timeout - 待機タイムアウト（ms）
+     * @returns {Promise<void>} Promise<void>
+     */
+    sendCtrlC(timeout?: number): Promise<void>;
+    /**
+     * 処理名: リソース解放
+     *
+     * 処理概要: 子プロセスが生存していれば終了させ、内部参照をクリアする
+     * @returns {void}
+     */
+    dispose(): void;
+}
+export default CliRunner;
+//# sourceMappingURL=CliRunner.d.ts.map

package/dist/CliRunner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CliRunner.d.ts","sourceRoot":"","sources":["../src/CliRunner.ts"],"names":[],"mappings":";;AACA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IAEzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB,CAAC;AAEF;;;;;;GAMG;AACH,qBAAa,SAAU,SAAQ,YAAY;IACzC,OAAO,CAAC,IAAI,CAA+C;IAC3D,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,cAAc,CAAM;IAC5B,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,cAAc,CAA+B;IAErD;;;;;;OAMG;;IAKH,OAAO,CAAC,eAAe,CAAQ;IAE/B;;;;;;;;;OASG;IACH,KAAK,CAAC,OAAO,GAAE,YAAiB,EAAE,eAAe,CAAC,EAAE,MAAM;IAsC1D;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAc9B;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM;IAKlB;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM;IAIpB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAqCvB;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IA4B3B;;;;OAIG;YACW,iBAAiB;IAiB/B;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAoBvB;;;;;OAKG;IAEH;;OAEG;IACH,UAAU,IAAI;QAAE,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;QAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,IAAI,CAAA;KAAE;IACvI;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuC7C;;;;;OAKG;IACH,UAAU;IAIV;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmD1C;;;;;OAKG;IACH,OAAO;CAUR;AAED,eAAe,SAAS,CAAC"}

package/dist/CliRunner.js

@@ -0,0 +1,384 @@
+import { spawn } from 'child_process';
+import { EventEmitter } from 'events';
+/**
+ * CliRunner
+ *
+ * A small helper used in tests to spawn a child CLI process and read
+ * stdout/stderr conveniently. This is a near-direct extraction from the
+ * sample project and adapted to be a reusable library class.
+ */
+export class CliRunner extends EventEmitter {
+    proc = null;
+    stdoutBuffer = '';
+    stdoutFragment = '';
+    stdoutLines = [];
+    stderrBuffer = '';
+    _autoExitTimer = null;
+    /**
+     * 処理名: CliRunner 初期化
+     *
+     * 処理概要: イベントエミッタを初期化し、内部状態をセットアップする
+     *
+     * 実装理由: テスト用に子プロセスを制御するユーティリティとして振る舞うため
+     */
+    constructor() {
+        super();
+    }
+    exitWaitTimeout = 2000;
+    /**
+     * 処理名: 子プロセス起動
+     *
+     * 処理概要: 指定されたコマンドで子プロセスを spawn し、stdout/stderr を監視する
+     *
+     * 実装理由: テスト内で CLI を起動・操作し出力を検査するため
+     * @param {SpawnOptions} options - 起動オプション
+     * @param {number} exitWaitTimeout - 自動終了タイムアウト (ms)
+     * @returns {this} this インスタンス
+     */
+    start(options = {}, exitWaitTimeout) {
+        if (this.proc)
+            throw new Error('process already started');
+        const cwd = options.cwd || process.cwd();
+        let command;
+        let args;
+        if (options.command) {
+            command = options.command;
+            args = options.args || [];
+        }
+        else {
+            throw new Error('No command provided. CliRunner.start requires options.command to be set.');
+        }
+        const childEnv = options.env ? options.env : process.env;
+        this.proc = spawn(command, args, {
+            cwd,
+            env: childEnv,
+            stdio: 'pipe',
+        });
+        // stdout / stderr / process イベントを設定
+        this._attachStdoutHandler();
+        this._attachStderrHandler();
+        this._attachProcessHandlers();
+        if (typeof exitWaitTimeout === 'number') {
+            this.exitWaitTimeout = exitWaitTimeout;
+            this._autoExitTimer = setTimeout(() => {
+                if (this.proc) {
+                    this.emit('error', new Error('auto-exit timeout reached'));
+                    this.sendCtrlC().catch(() => { });
+                }
+            }, this.exitWaitTimeout);
+        }
+        return this;
+    }
+    /**
+     * stdout のハンドラを登録する
+     */
+    _attachStdoutHandler() {
+        if (!this.proc)
+            return;
+        this.proc.stdout.setEncoding('utf8');
+        this.proc.stdout.on('data', (chunk) => {
+            this.stdoutBuffer += chunk;
+            this.stdoutFragment += chunk;
+            const parts = this.stdoutFragment.split('\n');
+            this.stdoutFragment = parts.pop() || '';
+            for (const p of parts) {
+                const line = p.trim();
+                if (line)
+                    this.stdoutLines.push(line);
+            }
+            this.emit('stdout', chunk);
+        });
+    }
+    /**
+     * stderr のハンドラを登録する
+     */
+    _attachStderrHandler() {
+        if (!this.proc)
+            return;
+        this.proc.stderr.on('data', (chunk) => {
+            this.stderrBuffer += chunk;
+            this.emit('stderr', chunk);
+        });
+    }
+    /**
+     * プロセスレベルのハンドラを登録する
+     */
+    _attachProcessHandlers() {
+        if (!this.proc)
+            return;
+        this.proc.on('exit', (code, signal) => {
+            this.emit('exit', { code, signal });
+            this.proc = null;
+            if (this._autoExitTimer) {
+                clearTimeout(this._autoExitTimer);
+                this._autoExitTimer = null;
+            }
+        });
+        this.proc.on('error', (err) => this.emit('error', err));
+    }
+    /**
+     * 処理名: stdin 書き込み
+     *
+     * 処理概要: 子プロセスの stdin にデータを書き込む
+     * @param {string} data - 書き込む文字列
+     */
+    write(data) {
+        if (!this.proc || !this.proc.stdin.writable)
+            throw new Error('process not started or stdin not writable');
+        this.proc.stdin.write(data);
+    }
+    /**
+     * 処理名: stdin 書き込み（改行付き）
+     *
+     * 処理概要: 引数に改行を付与して stdin に書き込む
+     * @param {string} data - 書き込む文字列（改行は自動で追加される）
+     */
+    writeln(data) {
+        this.write(data + '\n');
+    }
+    /**
+     * 処理名: stdout 一括取得
+     *
+     * 処理概要: キューされている stdout 行をまとめて返す。タイムアウト付き。
+     * @param {number} timeout - タイムアウト（ms）
+     * @returns {Promise<string>} キュー内の文字列（改行区切り）を返す Promise
+     */
+    _readStdoutOnce(timeout = 2000) {
+        if (this.stdoutLines.length > 0) {
+            const out = this.stdoutLines.join('\n');
+            this.stdoutLines = [];
+            return Promise.resolve(out);
+        }
+        if (!this.proc)
+            return Promise.reject(new Error('stdout timeout'));
+        return new Promise((resolve, reject) => {
+            if (this.stdoutLines.length > 0) {
+                const out = this.stdoutLines.join('\n');
+                this.stdoutLines = [];
+                return resolve(out);
+            }
+            /**
+             *
+             */
+            const onData = () => {
+                if (this.stdoutLines.length > 0) {
+                    this.removeListener('stdout', onData);
+                    clearTimeout(t);
+                    const out = this.stdoutLines.join('\n');
+                    this.stdoutLines = [];
+                    resolve(out);
+                }
+            };
+            const t = setTimeout(() => {
+                this.removeListener('stdout', onData);
+                this.stdoutLines = [];
+                reject(new Error('stdout timeout'));
+            }, timeout);
+            this.on('stdout', onData);
+        });
+    }
+    /**
+     * 処理名: stdout 1行取得
+     *
+     * 処理概要: キューから1行を取り出して返す。タイムアウト付き。
+     * @param {number} timeout - タイムアウト（ms）
+     * @returns {Promise<string>} キューの先頭行を返す Promise
+     */
+    _readStdoutLineOnce(timeout = 2000) {
+        if (this.stdoutLines.length > 0) {
+            return Promise.resolve(this.stdoutLines.shift());
+        }
+        if (!this.proc)
+            return Promise.reject(new Error('stdout line timeout'));
+        return new Promise((resolve, reject) => {
+            if (this.stdoutLines.length > 0)
+                return resolve(this.stdoutLines.shift());
+            /**
+             *
+             */
+            const onData = () => {
+                if (this.stdoutLines.length > 0) {
+                    this.removeListener('stdout', onData);
+                    clearTimeout(t);
+                    resolve(this.stdoutLines.shift());
+                }
+            };
+            const t = setTimeout(() => {
+                this.removeListener('stdout', onData);
+                reject(new Error('stdout line timeout'));
+            }, timeout);
+            this.on('stdout', onData);
+        });
+    }
+    /**
+     * 処理名: stdout 内の JSON を探索して返す
+     * @param {number} timeout - 総タイムアウト（ms）
+     * @returns {Promise<unknown>} 見つかった JSON オブジェクト
+     */
+    async _findJsonInStdout(timeout) {
+        const deadline = Date.now() + timeout;
+        while (Date.now() < deadline) {
+            const remaining = Math.max(0, deadline - Date.now());
+            const line = await this._readStdoutLineOnce(remaining);
+            if (!line)
+                break;
+            try {
+                const obj = JSON.parse(line);
+                if (obj)
+                    return obj;
+            }
+            catch (_e) {
+                // 継続して次の行を探す
+                continue;
+            }
+        }
+        throw new Error('no JSON found in stdout within timeout');
+    }
+    /**
+     * 処理名: 強制終了ユーティリティ
+     *
+     * 処理概要: タイムアウト時に子プロセスを強制終了する。Windows では `taskkill` を利用し、
+     *            それ以外は `SIGKILL` を送る。
+     * @returns {Promise<void>} 終了を待機する Promise
+     */
+    _forceTerminate() {
+        if (!this.proc)
+            return Promise.resolve();
+        if (process.platform === 'win32') {
+            return new Promise((resolve) => {
+                const tk = spawn('taskkill', ['/PID', String(this.proc.pid), '/T', '/F']);
+                tk.on('close', () => {
+                    resolve();
+                });
+                tk.on('error', () => resolve());
+            });
+        }
+        try {
+            this.proc.kill('SIGKILL');
+        }
+        catch (_e) {
+            // ignore
+        }
+        return Promise.resolve();
+    }
+    /**
+     * @param {number} timeout - 省略時はヘルパを返す
+     * @returns {unknown} ヘルパオブジェクトまたは Promise<string>
+     */
+    readStdout(timeout) {
+        if (typeof timeout === 'number')
+            return this._readStdoutOnce(timeout);
+        return {
+            /**
+             * 処理名: stdout を行単位で取得
+             * @param {number} t - タイムアウト（ms）
+             * @returns {Promise<string[]>} 行配列の Promise
+             */
+            toLines: async (t = 2000) => {
+                const buf = await this._readStdoutOnce(t);
+                if (!buf)
+                    return [];
+                return buf.split('\n').map((s) => s.trim()).filter(Boolean);
+            },
+            /**
+             * 処理名: stdout から JSON 行を探して返す
+             * @param {number} t - 総タイムアウト（ms）
+             * @returns {Promise<unknown>} 見つかった JSON オブジェクトを返す Promise
+             */
+            toJson: async (t = 2000) => {
+                return this._findJsonInStdout(t);
+            },
+            /**
+             * 処理名: stdout バッファクリア
+             */
+            clear: () => {
+                this.stdoutLines = [];
+                this.stdoutFragment = '';
+                this.stdoutBuffer = '';
+            },
+        };
+    }
+    /* eslint-enable no-unused-vars */
+    /**
+     * 処理名: stderr 取得
+     *
+     * 処理概要: これまでに受信した stderr バッファを返す
+     * @returns {string} stderr バッファ文字列
+     */
+    readStderr() {
+        return this.stderrBuffer;
+    }
+    /**
+     * 処理名: SIGINT 送信と終了待ち
+     *
+     * 処理概要: 子プロセスへ SIGINT を送信し、終了するまで待機する。タイムアウト時は強制終了を試みる
+     * @param {number} timeout - 待機タイムアウト（ms）
+     * @returns {Promise<void>} Promise<void>
+     */
+    sendCtrlC(timeout) {
+        const wait = typeof timeout === 'number' ? timeout : this.exitWaitTimeout;
+        return new Promise((resolve, reject) => {
+            if (!this.proc)
+                return resolve();
+            /**
+             *
+             */
+            const onExit = () => {
+                clearTimeout(to);
+                this.removeListener('error', onError);
+                resolve();
+            };
+            /**
+             * エラーハンドラ
+             * @param {unknown} e - 発生したエラー
+             */
+            const onError = (e) => {
+                clearTimeout(to);
+                this.removeListener('exit', onExit);
+                reject(e);
+            };
+            const to = setTimeout(async () => {
+                try {
+                    await this._forceTerminate();
+                    resolve();
+                }
+                catch (e) {
+                    reject(e);
+                }
+            }, wait);
+            this.once('exit', onExit);
+            this.once('error', onError);
+            try {
+                this.proc.stdin.end();
+            }
+            catch (_e) {
+                // ignore
+            }
+            try {
+                this.proc.kill('SIGINT');
+            }
+            catch (_e) {
+                // ignore
+            }
+        });
+    }
+    /**
+     * 処理名: リソース解放
+     *
+     * 処理概要: 子プロセスが生存していれば終了させ、内部参照をクリアする
+     * @returns {void}
+     */
+    dispose() {
+        if (!this.proc)
+            return;
+        try {
+            this.proc.kill();
+        }
+        catch (_e) {
+            // ignore
+        }
+        this.proc = null;
+    }
+}
+export default CliRunner;
+//# sourceMappingURL=CliRunner.js.map

package/dist/CliRunner.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { CliRunner } from './CliRunner.js';
+export { CliRunner };
+export type { SpawnOptions } from './CliRunner.js';
+declare const JestRunnerCli: unknown;
+export default JestRunnerCli;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAInD,QAAA,MAAM,aAAa,SAA4B,CAAC;AAEhD,eAAe,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+import createJestRunner from 'create-jest-runner';
+import { CliRunner } from './CliRunner.js';
+export { CliRunner };
+const runPath = new URL('./run.js', import.meta.url).pathname;
+const JestRunnerCli = createJestRunner(runPath);
+export default JestRunnerCli;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,CAAC;AAGrB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;AAE9D,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;AAEhD,eAAe,aAAa,CAAC"}

package/dist/run.d.ts

@@ -0,0 +1,14 @@
+import type { Config } from '@jest/types';
+import type { JestEnvironment } from '@jest/environment';
+import type Runtime from 'jest-runtime';
+/**
+ * Jest runner entry point that delegates to the core runTest helper.
+ * @param {Config.GlobalConfig} globalConfig - Jest global configuration.
+ * @param {Config.ProjectConfig} projectConfig - Project-specific configuration.
+ * @param {JestEnvironment} environment - Jest test environment instance.
+ * @param {Runtime} runtime - Jest runtime used to execute the test.
+ * @param {string} testPath - Path to the test file.
+ * @returns {Promise<unknown>} Execution result from runTest.
+ */
+export default function run(globalConfig: Config.GlobalConfig, projectConfig: Config.ProjectConfig, environment: JestEnvironment, runtime: Runtime, testPath: string): Promise<unknown>;
+//# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AAGxC;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,GAAG,CACzB,YAAY,EAAE,MAAM,CAAC,YAAY,EACjC,aAAa,EAAE,MAAM,CAAC,aAAa,EACnC,WAAW,EAAE,eAAe,EAC5B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,oBAGjB"}

package/dist/run.js

@@ -0,0 +1,14 @@
+import runTest from 'jest-runner/build/runTest.js';
+/**
+ * Jest runner entry point that delegates to the core runTest helper.
+ * @param {Config.GlobalConfig} globalConfig - Jest global configuration.
+ * @param {Config.ProjectConfig} projectConfig - Project-specific configuration.
+ * @param {JestEnvironment} environment - Jest test environment instance.
+ * @param {Runtime} runtime - Jest runtime used to execute the test.
+ * @param {string} testPath - Path to the test file.
+ * @returns {Promise<unknown>} Execution result from runTest.
+ */
+export default function run(globalConfig, projectConfig, environment, runtime, testPath) {
+    return runTest(testPath, globalConfig, projectConfig, environment, runtime);
+}
+//# sourceMappingURL=run.js.map

package/dist/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAGA,OAAO,OAAO,MAAM,8BAA8B,CAAC;AAEnD;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,GAAG,CACzB,YAAiC,EACjC,aAAmC,EACnC,WAA4B,EAC5B,OAAgB,EAChB,QAAgB;IAEhB,OAAO,OAAO,CAAC,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;AAC9E,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "jest-runner-cli",
+  "version": "0.2.0",
+  "description": "Jest custom runner for CLI workflows with a minimal CliRunner helper",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./run": "./dist/run.js",
+    "./CliRunner": "./dist/CliRunner.js"
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "type-check": "tsc --noEmit",
+    "test": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js",
+    "test:ci": "node --experimental-vm-modules ./node_modules/jest/bin/jest.js --coverage",
+    "lint": "eslint . --ext .ts",
+    "depcruise": "depcruise --config .dependency-cruiser.cjs src",
+    "docs": "typedoc --options typedoc.json"
+  },
+  "keywords": ["cli", "runner", "test", "jest"],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gutyoh/jest-runner-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/gutyoh/jest-runner-cli/issues"
+  },
+  "homepage": "https://github.com/gutyoh/jest-runner-cli#readme",
+  "license": "MIT",
+  "peerDependencies": {
+    "jest": "^29.6.1"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.2",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "dependency-cruiser": "^17.3.5",
+    "eslint": "^8.45.0",
+    "eslint-plugin-jsdoc": "^46.0.0",
+    "eslint-plugin-sonarjs": "^0.19.0",
+    "jest": "^29.6.1",
+    "ts-jest": "^29.1.0",
+    "typedoc": "^0.28.0",
+    "typedoc-plugin-markdown": "^4.8.0",
+    "typescript": "5.3.3"
+  },
+  "dependencies": {
+    "create-jest-runner": "^1.0.0",
+    "jest-runner": "^29.6.1"
+  }
+}