@travetto/test 8.0.0-alpha.14 → 8.0.0-alpha.16

package/README.md

@@ -220,12 +220,19 @@ class SimpleTest {
 ## Running Tests
 To run the tests you can either call the [Command Line Interface](https://github.com/travetto/travetto/tree/main/module/cli#readme "CLI infrastructure for Travetto framework") by invoking
 
-**Terminal: Test Help Output**
+## CLI - test
+
+**Terminal: Help for test**
 ```bash
 $ trv test --help
 
 Usage: test [options] [first:string] [globs...:string]
 
+Execute the test framework for targeted files, suites, or methods.
+
+Supports glob-based discovery, import-based targeting, tag filtering, and
+configurable output consumers for local and CI workflows.
+
 Options:
   -f, --format <string>          Output format for test results (default: "tap")
   -c, --concurrency <number>     Number of tests to run concurrently (default: 9)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@travetto/test",
-  "version": "8.0.0-alpha.14",
+  "version": "8.0.0-alpha.16",
   "type": "module",
   "description": "Declarative test framework",
   "keywords": [
@@ -28,15 +28,15 @@
     "directory": "module/test"
   },
   "dependencies": {
-    "@travetto/registry": "^8.0.0-alpha.14",
-    "@travetto/runtime": "^8.0.0-alpha.14",
-    "@travetto/terminal": "^8.0.0-alpha.14",
-    "@travetto/worker": "^8.0.0-alpha.14",
-    "yaml": "^2.8.3"
+    "@travetto/registry": "^8.0.0-alpha.16",
+    "@travetto/runtime": "^8.0.0-alpha.16",
+    "@travetto/terminal": "^8.0.0-alpha.16",
+    "@travetto/worker": "^8.0.0-alpha.16",
+    "yaml": "^2.9.0"
   },
   "peerDependencies": {
-    "@travetto/cli": "^8.0.0-alpha.20",
-    "@travetto/transformer": "^8.0.0-alpha.10"
+    "@travetto/cli": "^8.0.0-alpha.22",
+    "@travetto/transformer": "^8.0.0-alpha.11"
   },
   "peerDependenciesMeta": {
     "@travetto/transformer": {

package/src/consumer/types/tap-summary.ts

@@ -1,5 +1,5 @@
 import { Util, AsyncQueue } from '@travetto/runtime';
-import { StyleUtil, Terminal, TerminalUtil } from '@travetto/terminal';
+import { Terminal, TerminalUtil } from '@travetto/terminal';
 
 import type { TestEvent } from '../../model/event.ts';
 import type { TestResult } from '../../model/test.ts';
@@ -98,17 +98,25 @@ export class TapSummaryEmitter implements TestConsumerShape {
     this.onTestRunState(state);
 
     const total = TestModelUtil.buildSummary();
-    const success = StyleUtil.getStyle({ text: '#e5e5e5', background: '#026020' }); // White on dark green
-    const fail = StyleUtil.getStyle({ text: '#e5e5e5', background: '#8b0000' }); // White on dark red
     this.#progress = this.#terminal.streamToBottom(
       Util.mapAsyncIterable(
         this.#results,
         (value) => {
           TestModelUtil.countTestResult(total, [value]);
           const statusLine = `${total.failed} failed, ${total.errored} errored, ${total.skipped} skipped`;
-          return { value: `Tests %idx/%total [${statusLine}] -- ${value.classId}`, total: this.#state.testCount, idx: total.passed };
+          return {
+            value: `Tests %completed/%total [${statusLine}] -- ${value.classId}`,
+            total: this.#state.testCount,
+            completed: total.passed,
+            failed: total.failed + total.errored
+          };
         },
-        TerminalUtil.progressBarUpdater(this.#terminal, { style: () => ({ complete: (total.failed || total.errored) ? fail : success }) })
+        TerminalUtil.progressBarUpdater(this.#terminal, {
+          style: {
+            complete: { text: '#e5e5e5', background: '#026020' },
+            failed: { text: '#e5e5e5', background: '#8b0000' }
+          }
+        })
       ),
       { minDelay: 100 }
     );

package/support/cli.test.ts

@@ -8,7 +8,10 @@ import { Max, Min } from '@travetto/schema';
 import type { TestConsumerType } from './bin/run.ts';
 
 /**
- * Launch test framework and execute tests
+ * Execute the test framework for targeted files, suites, or methods.
+ *
+ * Supports glob-based discovery, import-based targeting, tag filtering, and
+ * configurable output consumers for local and CI workflows.
  */
 @CliCommand()
 export class TestCommand implements CliCommandShape {

package/support/cli.test_child.ts

@@ -4,7 +4,12 @@ import { Env } from '@travetto/runtime';
 import { CliCommand } from '@travetto/cli';
 import { IsPrivate } from '@travetto/schema';
 
-/** Test child worker target */
+/**
+ * Internal command target for test child workers.
+ *
+ * Used by the test runner to bootstrap isolated worker processes with test-
+ * oriented runtime configuration.
+ */
 @CliCommand()
 @IsPrivate()
 export class TestChildWorkerCommand {

package/support/cli.test_diff.ts

@@ -7,7 +7,12 @@ import { IsPrivate } from '@travetto/schema';
 import { runTests, type TestConsumerType } from './bin/run.ts';
 import type { TestDiffSource } from '../src/model/test.ts';
 
-/**  Direct test invocation */
+/**
+ * Run tests scoped by a precomputed diff source file.
+ *
+ * The first argument resolves the test import root, and the second argument is
+ * a JSON diff payload consumed by test-selection logic.
+ */
 @CliCommand()
 @IsPrivate()
 export class TestDiffCommand {

package/support/cli.test_digest.ts

@@ -8,8 +8,15 @@ import { RunUtil } from '../src/execute/run.ts';
 
 @CliCommand()
 @IsPrivate()
+/**
+ * Produce a deterministic digest of discovered test identifiers.
+ *
+ * This is an internal command used by tooling to enumerate tests in a stable
+ * order for planning, sharding, or change detection workflows.
+ */
 export class TestDigestCommand {
 
+  /** Output mode for digest emission. */
   output: 'json' | 'text' = 'text';
 
   preMain(): void {

package/support/cli.test_direct.ts

@@ -4,7 +4,12 @@ import { IsPrivate } from '@travetto/schema';
 
 import { runTests, type TestConsumerType } from './bin/run.ts';
 
-/**  Direct test invocation */
+/**
+ * Run tests directly from an import or source file with optional class/method filtering.
+ *
+ * This internal command bypasses discovery by targeting a specific test import
+ * and optional class or method names.
+ */
 @CliCommand()
 @IsPrivate()
 export class TestDirectCommand {

package/support/cli.test_watch.ts

@@ -4,7 +4,10 @@ import { CliCommand } from '@travetto/cli';
 import type { TestConsumerType } from './bin/run.ts';
 
 /**
- * Invoke the test watcher
+ * Start the test watcher for continuous test execution.
+ *
+ * Watches project changes and reruns either all tests or changed subsets,
+ * using the configured output format.
  */
 @CliCommand()
 export class TestWatcherCommand {