sxy-test-runner 2.3.19 → 2.3.20

package/AGENTS.md

@@ -249,6 +249,47 @@ Important limitations:
 - Use `once` instead of watch mode for autonomous agent verification so the command
   terminates and returns a meaningful status.
 
+### Watching someone else's watch session
+
+`--status-file <file>` (`-s`, or `watch.statusFile` in the config) makes watch mode record
+each run's result where another process can read it, rather than in the terminal only. The
+first line is `<code> - <description>`, the second is when the run finished, then the summary,
+then any failures, with the run's duration last:
+
+```
+1 - 2 tests failed
+2026-08-03 20:14:52 +01:00
+Tests: 8/10
+Items: 4/5
+Test Files: 1/2
+Failures:
+  f: tests/users.test.js
+    d: creating a user
+      t: rejects a duplicate email
+        e: AssertionError: expected 409 to equal 200
+      t: sends a welcome email
+        e: Error: connect ECONNREFUSED 127.0.0.1:2525
+1,204ms
+```
+
+Failures nest as `f:` file, `d:` describe, `t:` test, `e:` error - one line each. A file that
+would not load gives `e: did not load: <error>` under its `f:` line, and a describe that
+threw gives `e: threw: <error>` under its `d:` line. Diffs, logs and stack traces are only in
+the terminal output.
+
+| code | meaning |
+| --- | --- |
+| -1 | watch mode has started, but no run has finished |
+| 0 | everything passed |
+| 1 | tests ran and failed |
+| 2 | the run died partway - a test file would not load, or a describe threw |
+| 3 | nothing ran - no test files were found, or the filters matched nothing |
+
+Code `2` is worth handling separately from `1`: it usually means the suite broke rather
+than the code under test. Watch mode writes `-1` on startup, so a status from a previous
+session is never read as current, and each write is renamed into place, so a poller only
+ever sees a complete status.
+
 ## Configuration reference
 
 The exported config type is available for JavaScript type checking:
@@ -284,7 +325,8 @@ export default {
         watchFilesIgnore: '**/node_modules/**',
         runAllOnStartup: true,
         reRunFailingTests: true,
-        ttyActionsOnKeypress: false
+        ttyActionsOnKeypress: false,
+        statusFile: false
     }
 }
 ```

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Robert Sandiford
+
+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/dist/cli/help.js

@@ -29,6 +29,7 @@ export function help() {
         '  -f, --filter <glob>      Further constrain the configured test pattern',
         '  -d, --filter-describe <substring>  Run matching describe blocks',
         '  -i, --filter-it <substring>        Run matching tests',
+        '  -s, --status-file <file>           Write the latest watch run status to a file',
         '',
         'Watch controls:',
         '  r/l + Enter           Re-run the last set of tests',
@@ -44,7 +45,7 @@ export function help() {
         `  ${cliName} once --config config/sxyt.config.js`,
         '',
         `Configuration: ${configNames} in ${configDirectories}.`,
-        `Executable aliases: sxyt, ${cliName}, ${packageName}.`
+        `Executable aliases: ${cliName}, sxy-test, ${packageName}.`
     ].join('\n'));
 }
 //# sourceMappingURL=help.js.map

package/dist/cli/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,sBAAsB,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACrF,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAElC,MAAM,UAAU,IAAI;IAChB,MAAM,WAAW,GAAG,eAAe;SAC9B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,eAAe,CAAC;SACnC,IAAI,CAAC,MAAM,CAAC,CAAA;IACjB,MAAM,iBAAiB,GAAG,eAAe;SACpC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,QAAQ,GAAG,CAAC;SACtE,IAAI,CAAC,MAAM,CAAC,CAAA;IAEjB,GAAG,CAAC;QACA,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC;QAC7B,EAAE;QACF,QAAQ;QACR,KAAK,OAAO,oBAAoB;QAChC,KAAK,OAAO,iBAAiB;QAC7B,KAAK,OAAO,OAAO;QACnB,KAAK,OAAO,OAAO;QACnB,EAAE;QACF,WAAW;QACX,iEAAiE;QACjE,2CAA2C;QAC3C,+CAA+C;QAC/C,yBAAyB;QACzB,EAAE;QACF,UAAU;QACV,8DAA8D;QAC9D,iEAAiE;QACjE,0EAA0E;QAC1E,mEAAmE;QACnE,yDAAyD;QACzD,EAAE;QACF,iBAAiB;QACjB,sDAAsD;QACtD,0CAA0C;QAC1C,8CAA8C;QAC9C,qEAAqE;QACrE,EAAE;QACF,WAAW;QACX,KAAK,OAAO,EAAE;QACd,KAAK,OAAO,OAAO;QACnB,KAAK,OAAO,4CAA4C;QACxD,KAAK,OAAO,8BAA8B;QAC1C,KAAK,OAAO,sCAAsC;QAClD,EAAE;QACF,kBAAkB,WAAW,OAAO,iBAAiB,GAAG;QACxD,6BAA6B,OAAO,KAAK,WAAW,GAAG;KAC1D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;AACjB,CAAC","sourcesContent":["import chalk from '../packages/chalk.js'\nimport { packageName, cliName, configFileNames, configLocations } from '../config.js'\nimport { out } from '../output.js'\n\nexport function help(): void {\n    const configNames = configFileNames\n        .map(name => `${name}.{js,cjs,mjs}`)\n        .join(' or ')\n    const configDirectories = configLocations\n        .map(location => location === '' ? 'the project root' : `${location}/`)\n        .join(' or ')\n\n    out([\n        chalk.brightblue(packageName),\n        '',\n        'Usage:',\n        `  ${cliName} [watch] [options]`,\n        `  ${cliName} once [options]`,\n        `  ${cliName} init`,\n        `  ${cliName} help`,\n        '',\n        'Commands:',\n        '  watch  Run tests and watch for related file changes (default)',\n        '  once   Run the test suite once and exit',\n        '  init   Create an initial configuration file',\n        '  help   Show this help',\n        '',\n        'Options:',\n        '  -c, --config <file>      Use a specific configuration file',\n        '  -t, --test-files <glob>  Override the configured test pattern',\n        '  -f, --filter <glob>      Further constrain the configured test pattern',\n        '  -d, --filter-describe <substring>  Run matching describe blocks',\n        '  -i, --filter-it <substring>        Run matching tests',\n        '',\n        'Watch controls:',\n        '  r/l + Enter           Re-run the last set of tests',\n        '  a + Enter             Re-run all tests',\n        '  f + Enter             Re-run failing tests',\n        '  Set watch.ttyActionsOnKeypress to true to run these without Enter',\n        '',\n        'Examples:',\n        `  ${cliName}`,\n        `  ${cliName} once`,\n        `  ${cliName} watch --test-files \"**/*.focused.test.js\"`,\n        `  ${cliName} once --filter \"**/users/**\"`,\n        `  ${cliName} once --config config/sxyt.config.js`,\n        '',\n        `Configuration: ${configNames} in ${configDirectories}.`,\n        `Executable aliases: sxyt, ${cliName}, ${packageName}.`\n    ].join('\\n'))\n}\n"]}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/cli/help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,sBAAsB,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACrF,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAElC,MAAM,UAAU,IAAI;IAChB,MAAM,WAAW,GAAG,eAAe;SAC9B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,eAAe,CAAC;SACnC,IAAI,CAAC,MAAM,CAAC,CAAA;IACjB,MAAM,iBAAiB,GAAG,eAAe;SACpC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,GAAG,QAAQ,GAAG,CAAC;SACtE,IAAI,CAAC,MAAM,CAAC,CAAA;IAEjB,GAAG,CAAC;QACA,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC;QAC7B,EAAE;QACF,QAAQ;QACR,KAAK,OAAO,oBAAoB;QAChC,KAAK,OAAO,iBAAiB;QAC7B,KAAK,OAAO,OAAO;QACnB,KAAK,OAAO,OAAO;QACnB,EAAE;QACF,WAAW;QACX,iEAAiE;QACjE,2CAA2C;QAC3C,+CAA+C;QAC/C,yBAAyB;QACzB,EAAE;QACF,UAAU;QACV,8DAA8D;QAC9D,iEAAiE;QACjE,0EAA0E;QAC1E,mEAAmE;QACnE,yDAAyD;QACzD,kFAAkF;QAClF,EAAE;QACF,iBAAiB;QACjB,sDAAsD;QACtD,0CAA0C;QAC1C,8CAA8C;QAC9C,qEAAqE;QACrE,EAAE;QACF,WAAW;QACX,KAAK,OAAO,EAAE;QACd,KAAK,OAAO,OAAO;QACnB,KAAK,OAAO,4CAA4C;QACxD,KAAK,OAAO,8BAA8B;QAC1C,KAAK,OAAO,sCAAsC;QAClD,EAAE;QACF,kBAAkB,WAAW,OAAO,iBAAiB,GAAG;QACxD,uBAAuB,OAAO,eAAe,WAAW,GAAG;KAC9D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;AACjB,CAAC","sourcesContent":["import chalk from '../packages/chalk.js'\nimport { packageName, cliName, configFileNames, configLocations } from '../config.js'\nimport { out } from '../output.js'\n\nexport function help(): void {\n    const configNames = configFileNames\n        .map(name => `${name}.{js,cjs,mjs}`)\n        .join(' or ')\n    const configDirectories = configLocations\n        .map(location => location === '' ? 'the project root' : `${location}/`)\n        .join(' or ')\n\n    out([\n        chalk.brightblue(packageName),\n        '',\n        'Usage:',\n        `  ${cliName} [watch] [options]`,\n        `  ${cliName} once [options]`,\n        `  ${cliName} init`,\n        `  ${cliName} help`,\n        '',\n        'Commands:',\n        '  watch  Run tests and watch for related file changes (default)',\n        '  once   Run the test suite once and exit',\n        '  init   Create an initial configuration file',\n        '  help   Show this help',\n        '',\n        'Options:',\n        '  -c, --config <file>      Use a specific configuration file',\n        '  -t, --test-files <glob>  Override the configured test pattern',\n        '  -f, --filter <glob>      Further constrain the configured test pattern',\n        '  -d, --filter-describe <substring>  Run matching describe blocks',\n        '  -i, --filter-it <substring>        Run matching tests',\n        '  -s, --status-file <file>           Write the latest watch run status to a file',\n        '',\n        'Watch controls:',\n        '  r/l + Enter           Re-run the last set of tests',\n        '  a + Enter             Re-run all tests',\n        '  f + Enter             Re-run failing tests',\n        '  Set watch.ttyActionsOnKeypress to true to run these without Enter',\n        '',\n        'Examples:',\n        `  ${cliName}`,\n        `  ${cliName} once`,\n        `  ${cliName} watch --test-files \"**/*.focused.test.js\"`,\n        `  ${cliName} once --filter \"**/users/**\"`,\n        `  ${cliName} once --config config/sxyt.config.js`,\n        '',\n        `Configuration: ${configNames} in ${configDirectories}.`,\n        `Executable aliases: ${cliName}, sxy-test, ${packageName}.`\n    ].join('\\n'))\n}\n"]}

package/dist/cli/init.js

@@ -126,6 +126,9 @@ export default {
         // run watch mode keyboard commands immediately, without waiting for Enter
         ttyActionsOnKeypress: false,
 
+        // file to write the latest run status to, or false for none
+        statusFile: false,
+
     },
 
 }`;

package/dist/cli/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,KAAK,MAAM,sBAAsB,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACrF,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAClC,OAAO,EAAE,MAAM,IAAI,CAAA;AAEnB,MAAM,UAAU,IAAI;IAChB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;IAEhC,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;QAC3C,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;YAC3C,IAAI,GAAG,CAAA;YACP,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,GAAG,KAAK,CAAC,CAAA;YAC9D,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,mBAAmB,CAAC,GAAG,CAAC,CAAA;YAC5B,CAAC;YACD,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,GAAG,MAAM,CAAC,CAAA;YAC/D,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,mBAAmB,CAAC,GAAG,CAAC,CAAA;YAC5B,CAAC;YACD,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,GAAG,MAAM,CAAC,CAAA;YAC/D,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,mBAAmB,CAAC,GAAG,CAAC,CAAA;YAC5B,CAAC;QACL,CAAC;IACL,CAAC;IAED,SAAS,mBAAmB,CAAC,GAAW;QACpC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAA,IAAI,WAAW,yCAAyC,GAAG,EAAE;cACvE,kEAAkE,OAAO,SAAS,CAAC,CAAA;IAC7F,CAAC;IAED,MAAM,0BAA0B,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAA;IACnE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,0BAA0B,CAAC,EAAE,CAAC;QAC7C,GAAG,CAAC,KAAK,CAAC,MAAM,CAAA,IAAI,WAAW,2CAA2C;cACpE,gEAAgE;cAChE,iFAAiF,CAAC,CAAA;IAC5F,CAAC;IAED,MAAM,cAAc,GAAG,EAAE,CAAC,YAAY,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAA;IAC1E,mEAAmE;IACnE,MAAM,WAAW,GAAsB,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;IAEjE,MAAM,gBAAgB,GAAG,CAAC,WAAW,CAAC,IAAI,KAAK,QAAQ,CAAC;QACpD,aAAa;QACb,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QACxE,SAAS;QACT,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAA;IAE7E,MAAM,aAAa,GACvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwFE,CAAA;IAEE,EAAE,CAAC,aAAa,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAA;IAEjD,GAAG,CAAC,KAAK,CAAC,WAAW,CAAA,IAAI,WAAW,sBAAsB,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAA;AAC9F,CAAC","sourcesContent":["import { join } from 'path'\nimport chalk from '../packages/chalk.js'\nimport { packageName, cliName, configFileNames, configLocations } from '../config.js'\nimport { out } from '../output.js'\nimport fs from 'fs'\n\nexport function init(): void {\n    const projectDir = process.cwd()\n\n    for (const configLocation of configLocations) {\n        for (const configFileName of configFileNames) {\n            let loc\n            loc = join(projectDir, configLocation, configFileName + '.js')\n            if (fs.existsSync(loc)) {\n                configAlreadyExists(loc)\n            }\n            loc = join(projectDir, configLocation, configFileName + '.cjs')\n            if (fs.existsSync(loc)) {\n                configAlreadyExists(loc)\n            }\n            loc = join(projectDir, configLocation, configFileName + '.mjs')\n            if (fs.existsSync(loc)) {\n                configAlreadyExists(loc)\n            }\n        }\n    }\n\n    function configAlreadyExists(loc: string): void {\n        out(chalk.orange`[${packageName}] A matching config already exists at ${loc}`\n            + `\\nPlease remove this config before generating a new one with \\`${cliName} init\\``)\n    }\n\n    const projectPackageJsonLocation = join(projectDir, 'package.json')\n    if (!fs.existsSync(projectPackageJsonLocation)) {\n        out(chalk.orange`[${packageName}] No package.json exists in this location`\n            + '\\nPlease initialise the package with `yarn init` on `npm init`'\n            + ' before running this command, and run this command from the project root folder')\n    }\n\n    const packageJsonRaw = fs.readFileSync(projectPackageJsonLocation, 'utf8')\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n    const packageJson: { type?: string } = JSON.parse(packageJsonRaw)\n\n    const targetConfigName = (packageJson.type === 'module')\n        // ES6 module\n        ? join(projectDir, configLocations[0] ?? '', configFileNames[0] + '.js')\n        // common\n        : join(projectDir, configLocations[0] ?? '', configFileNames[0] + '.mjs')\n\n    const defaultConfig =\n`\n// @ts-check\n\n/** @satisfies {import('sxy-test-runner').Config} */\nexport default {\n\n    // base folder for tests match and ignore patterns\n    testsBase: '.',\n\n    // glob pattern or array of glob patterns of test files\n    tests: [\n        '**/*.sxyt.{js,mjs,jsx}',\n        '**/*.test.{js,mjs,jsx}',\n        '**/*.spec.{js,mjs,jsx}',\n        '**/tests?/*.{js,mjs,jsx}',\n        '**/__tests?__/*.{js,mjs,jsx}'\n    ],\n\n    // glob pattern or array of patterns of test files to ignore\n    testsIgnore: ['**/node_modules/**/*'],\n\n    // whether to show the full error trace when an error occurs in a test file\n    showErrorTrace: false,\n\n    // tasks to run on startup\n    // accepts a function, file location (relative to project base), or array of functions and or files\n    setup: undefined,\n\n    // tasks to run before each test file is run\n    beforeEachFile: undefined,\n\n    // tasks to run after each test file is run\n    afterEachFile:  undefined,\n\n    // tasks to run before each describe block is processed\n    // if the function returns an object with named properties, or the file exports named exports,\n    // these will be passed to the callback function in argument 0, and can be access by destructruing e.g.\n    // describe('thing', ({exportA, exportB}) => { it('should', ...) })\n    beforeEachDescribe: undefined,\n\n    // tasks to run after each describe block\n    afterEachDescribe: undefined,\n\n    // tasks to run before each it/test block\n    // function returns and file exports will be passed to the it/test block as with describe above, e.g.\n    // it('should', ({exportA, exportB}) => { assert('something') })\n    beforeEachTest: undefined,\n\n    // tasks to run after each it/test block\n    afterEachTest: undefined,\n\n    // how to execute the different parts of test files\n    execution: {\n\n        // run test files in 'parallel' or 'sequential'ly\n        files: 'sequential',\n\n        // run describe blocks within a test file in 'parallel' or 'sequential'ly\n        describes: 'sequential',\n\n        // run it/test blocks within a describe blocks in 'parallel' or 'sequential'ly\n        tests: 'sequential'\n\n    },\n\n    // watch mode configurations\n    watch: {\n\n        //// the base directory to watch files in\n        watchFilesBase: '.',\n\n        //// glob filter or array of glob filters of files to watch\n        watchFiles: '**/*.js',\n\n        //// glob filter or array of globl filters of files to ignore\n        watchFilesIgnore: '**/node_modules/**/*',\n\n        // run all tests when starting the watcher\n        runAllOnStartup: true,\n\n        // re run all previously failed tests on each test run, until they pass\n        reRunFailingTests: true,\n\n        // run watch mode keyboard commands immediately, without waiting for Enter\n        ttyActionsOnKeypress: false,\n\n    },\n\n}`\n\n    fs.writeFileSync(targetConfigName, defaultConfig)\n\n    out(chalk.mediumgreen`[${packageName}] Created config at ` + chalk.blue(targetConfigName))\n}\n"]}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,KAAK,MAAM,sBAAsB,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACrF,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAClC,OAAO,EAAE,MAAM,IAAI,CAAA;AAEnB,MAAM,UAAU,IAAI;IAChB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;IAEhC,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;QAC3C,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;YAC3C,IAAI,GAAG,CAAA;YACP,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,GAAG,KAAK,CAAC,CAAA;YAC9D,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,mBAAmB,CAAC,GAAG,CAAC,CAAA;YAC5B,CAAC;YACD,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,GAAG,MAAM,CAAC,CAAA;YAC/D,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,mBAAmB,CAAC,GAAG,CAAC,CAAA;YAC5B,CAAC;YACD,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,GAAG,MAAM,CAAC,CAAA;YAC/D,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrB,mBAAmB,CAAC,GAAG,CAAC,CAAA;YAC5B,CAAC;QACL,CAAC;IACL,CAAC;IAED,SAAS,mBAAmB,CAAC,GAAW;QACpC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAA,IAAI,WAAW,yCAAyC,GAAG,EAAE;cACvE,kEAAkE,OAAO,SAAS,CAAC,CAAA;IAC7F,CAAC;IAED,MAAM,0BAA0B,GAAG,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAA;IACnE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,0BAA0B,CAAC,EAAE,CAAC;QAC7C,GAAG,CAAC,KAAK,CAAC,MAAM,CAAA,IAAI,WAAW,2CAA2C;cACpE,gEAAgE;cAChE,iFAAiF,CAAC,CAAA;IAC5F,CAAC;IAED,MAAM,cAAc,GAAG,EAAE,CAAC,YAAY,CAAC,0BAA0B,EAAE,MAAM,CAAC,CAAA;IAC1E,mEAAmE;IACnE,MAAM,WAAW,GAAsB,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;IAEjE,MAAM,gBAAgB,GAAG,CAAC,WAAW,CAAC,IAAI,KAAK,QAAQ,CAAC;QACpD,aAAa;QACb,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;QACxE,SAAS;QACT,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAA;IAE7E,MAAM,aAAa,GACvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2FE,CAAA;IAEE,EAAE,CAAC,aAAa,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAA;IAEjD,GAAG,CAAC,KAAK,CAAC,WAAW,CAAA,IAAI,WAAW,sBAAsB,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAA;AAC9F,CAAC","sourcesContent":["import { join } from 'path'\nimport chalk from '../packages/chalk.js'\nimport { packageName, cliName, configFileNames, configLocations } from '../config.js'\nimport { out } from '../output.js'\nimport fs from 'fs'\n\nexport function init(): void {\n    const projectDir = process.cwd()\n\n    for (const configLocation of configLocations) {\n        for (const configFileName of configFileNames) {\n            let loc\n            loc = join(projectDir, configLocation, configFileName + '.js')\n            if (fs.existsSync(loc)) {\n                configAlreadyExists(loc)\n            }\n            loc = join(projectDir, configLocation, configFileName + '.cjs')\n            if (fs.existsSync(loc)) {\n                configAlreadyExists(loc)\n            }\n            loc = join(projectDir, configLocation, configFileName + '.mjs')\n            if (fs.existsSync(loc)) {\n                configAlreadyExists(loc)\n            }\n        }\n    }\n\n    function configAlreadyExists(loc: string): void {\n        out(chalk.orange`[${packageName}] A matching config already exists at ${loc}`\n            + `\\nPlease remove this config before generating a new one with \\`${cliName} init\\``)\n    }\n\n    const projectPackageJsonLocation = join(projectDir, 'package.json')\n    if (!fs.existsSync(projectPackageJsonLocation)) {\n        out(chalk.orange`[${packageName}] No package.json exists in this location`\n            + '\\nPlease initialise the package with `yarn init` on `npm init`'\n            + ' before running this command, and run this command from the project root folder')\n    }\n\n    const packageJsonRaw = fs.readFileSync(projectPackageJsonLocation, 'utf8')\n    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n    const packageJson: { type?: string } = JSON.parse(packageJsonRaw)\n\n    const targetConfigName = (packageJson.type === 'module')\n        // ES6 module\n        ? join(projectDir, configLocations[0] ?? '', configFileNames[0] + '.js')\n        // common\n        : join(projectDir, configLocations[0] ?? '', configFileNames[0] + '.mjs')\n\n    const defaultConfig =\n`\n// @ts-check\n\n/** @satisfies {import('sxy-test-runner').Config} */\nexport default {\n\n    // base folder for tests match and ignore patterns\n    testsBase: '.',\n\n    // glob pattern or array of glob patterns of test files\n    tests: [\n        '**/*.sxyt.{js,mjs,jsx}',\n        '**/*.test.{js,mjs,jsx}',\n        '**/*.spec.{js,mjs,jsx}',\n        '**/tests?/*.{js,mjs,jsx}',\n        '**/__tests?__/*.{js,mjs,jsx}'\n    ],\n\n    // glob pattern or array of patterns of test files to ignore\n    testsIgnore: ['**/node_modules/**/*'],\n\n    // whether to show the full error trace when an error occurs in a test file\n    showErrorTrace: false,\n\n    // tasks to run on startup\n    // accepts a function, file location (relative to project base), or array of functions and or files\n    setup: undefined,\n\n    // tasks to run before each test file is run\n    beforeEachFile: undefined,\n\n    // tasks to run after each test file is run\n    afterEachFile:  undefined,\n\n    // tasks to run before each describe block is processed\n    // if the function returns an object with named properties, or the file exports named exports,\n    // these will be passed to the callback function in argument 0, and can be access by destructruing e.g.\n    // describe('thing', ({exportA, exportB}) => { it('should', ...) })\n    beforeEachDescribe: undefined,\n\n    // tasks to run after each describe block\n    afterEachDescribe: undefined,\n\n    // tasks to run before each it/test block\n    // function returns and file exports will be passed to the it/test block as with describe above, e.g.\n    // it('should', ({exportA, exportB}) => { assert('something') })\n    beforeEachTest: undefined,\n\n    // tasks to run after each it/test block\n    afterEachTest: undefined,\n\n    // how to execute the different parts of test files\n    execution: {\n\n        // run test files in 'parallel' or 'sequential'ly\n        files: 'sequential',\n\n        // run describe blocks within a test file in 'parallel' or 'sequential'ly\n        describes: 'sequential',\n\n        // run it/test blocks within a describe blocks in 'parallel' or 'sequential'ly\n        tests: 'sequential'\n\n    },\n\n    // watch mode configurations\n    watch: {\n\n        //// the base directory to watch files in\n        watchFilesBase: '.',\n\n        //// glob filter or array of glob filters of files to watch\n        watchFiles: '**/*.js',\n\n        //// glob filter or array of globl filters of files to ignore\n        watchFilesIgnore: '**/node_modules/**/*',\n\n        // run all tests when starting the watcher\n        runAllOnStartup: true,\n\n        // re run all previously failed tests on each test run, until they pass\n        reRunFailingTests: true,\n\n        // run watch mode keyboard commands immediately, without waiting for Enter\n        ttyActionsOnKeypress: false,\n\n        // file to write the latest run status to, or false for none\n        statusFile: false,\n\n    },\n\n}`\n\n    fs.writeFileSync(targetConfigName, defaultConfig)\n\n    out(chalk.mediumgreen`[${packageName}] Created config at ` + chalk.blue(targetConfigName))\n}\n"]}

package/dist/cli/lib/defaultConfig.js

@@ -21,7 +21,8 @@ export const defaultConfig = {
         watchFilesIgnore: '**/node_modules/**/*',
         runAllOnStartup: true,
         reRunFailingTests: true,
-        ttyActionsOnKeypress: false
+        ttyActionsOnKeypress: false,
+        statusFile: false
     }
 };
 //# sourceMappingURL=defaultConfig.js.map

package/dist/cli/lib/defaultConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaultConfig.js","sourceRoot":"","sources":["../../../src/cli/lib/defaultConfig.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAgB;IACtC,SAAS,EAAE,GAAG;IACd,KAAK,EAAE;QACH,wBAAwB;QACxB,wBAAwB;QACxB,wBAAwB;QACxB,0BAA0B;QAC1B,8BAA8B;KACjC;IACD,WAAW,EAAE,CAAC,sBAAsB,CAAC;IACrC,cAAc,EAAE,KAAK;IACrB,OAAO,EAAE,KAAK;IACd,SAAS,EAAE;QACP,KAAK,EAAE,YAAY;QACnB,SAAS,EAAE,YAAY;QACvB,KAAK,EAAE,YAAY;KACtB;IACD,KAAK,EAAE;QACH,cAAc,EAAE,GAAG;QACnB,UAAU,EAAE,SAAS;QACrB,gBAAgB,EAAE,sBAAsB;QACxC,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,IAAI;QACvB,oBAAoB,EAAE,KAAK;KAC9B;CACJ,CAAA","sourcesContent":["import type { FinalConfig } from '../../types.js'\n\nexport const defaultConfig: FinalConfig = {\n    testsBase: '.',\n    tests: [\n        '**/*.sxyt.{js,mjs,jsx}',\n        '**/*.test.{js,mjs,jsx}',\n        '**/*.spec.{js,mjs,jsx}',\n        '**/tests?/*.{js,mjs,jsx}',\n        '**/__tests?__/*.{js,mjs,jsx}'\n    ],\n    testsIgnore: ['**/node_modules/**/*'],\n    showErrorTrace: false,\n    compact: false,\n    execution: {\n        files: 'sequential',\n        describes: 'sequential',\n        tests: 'sequential'\n    },\n    watch: {\n        watchFilesBase: '.',\n        watchFiles: '**/*.js',\n        watchFilesIgnore: '**/node_modules/**/*',\n        runAllOnStartup: true,\n        reRunFailingTests: true,\n        ttyActionsOnKeypress: false\n    }\n}\n"]}
+{"version":3,"file":"defaultConfig.js","sourceRoot":"","sources":["../../../src/cli/lib/defaultConfig.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAgB;IACtC,SAAS,EAAE,GAAG;IACd,KAAK,EAAE;QACH,wBAAwB;QACxB,wBAAwB;QACxB,wBAAwB;QACxB,0BAA0B;QAC1B,8BAA8B;KACjC;IACD,WAAW,EAAE,CAAC,sBAAsB,CAAC;IACrC,cAAc,EAAE,KAAK;IACrB,OAAO,EAAE,KAAK;IACd,SAAS,EAAE;QACP,KAAK,EAAE,YAAY;QACnB,SAAS,EAAE,YAAY;QACvB,KAAK,EAAE,YAAY;KACtB;IACD,KAAK,EAAE;QACH,cAAc,EAAE,GAAG;QACnB,UAAU,EAAE,SAAS;QACrB,gBAAgB,EAAE,sBAAsB;QACxC,eAAe,EAAE,IAAI;QACrB,iBAAiB,EAAE,IAAI;QACvB,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE,KAAK;KACpB;CACJ,CAAA","sourcesContent":["import type { FinalConfig } from '../../types.js'\n\nexport const defaultConfig: FinalConfig = {\n    testsBase: '.',\n    tests: [\n        '**/*.sxyt.{js,mjs,jsx}',\n        '**/*.test.{js,mjs,jsx}',\n        '**/*.spec.{js,mjs,jsx}',\n        '**/tests?/*.{js,mjs,jsx}',\n        '**/__tests?__/*.{js,mjs,jsx}'\n    ],\n    testsIgnore: ['**/node_modules/**/*'],\n    showErrorTrace: false,\n    compact: false,\n    execution: {\n        files: 'sequential',\n        describes: 'sequential',\n        tests: 'sequential'\n    },\n    watch: {\n        watchFilesBase: '.',\n        watchFiles: '**/*.js',\n        watchFilesIgnore: '**/node_modules/**/*',\n        runAllOnStartup: true,\n        reRunFailingTests: true,\n        ttyActionsOnKeypress: false,\n        statusFile: false\n    }\n}\n"]}

package/dist/cli/lib/doUserSetup.js

@@ -4,13 +4,17 @@ export async function doUserSetup(config) {
     if (config.setup === undefined)
         return;
     const setupTasks = Array.isArray(config.setup) ? config.setup : [config.setup];
+    let setupFunctions = 0;
+    let setupFiles = 0;
     for (const setupTask of setupTasks) {
         switch (typeof setupTask) {
             case 'function': {
+                out('Running setup function ' + String(++setupFunctions));
                 await setupTask();
                 break;
             }
             case 'string': {
+                out('Running setup file ' + String(++setupFiles) + ': ' + setupTask);
                 await import(`file://${join(process.cwd(), setupTask)}`);
                 break;
             }

package/dist/cli/lib/doUserSetup.js.map

@@ -1 +1 @@
-{"version":3,"file":"doUserSetup.js","sourceRoot":"","sources":["../../../src/cli/lib/doUserSetup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAA;AAGrC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAmB;IACjD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,OAAM;IAEtC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC9E,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACjC,QAAQ,OAAO,SAAS,EAAE,CAAC;YACvB,KAAK,UAAU,CAAC,CAAC,CAAC;gBACd,MAAM,SAAS,EAAE,CAAA;gBACjB,MAAK;YACT,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACZ,MAAM,MAAM,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,EAAE,CAAC,CAAA;gBACxD,MAAK;YACT,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACN,GAAG,CAAC,mGAAmG,CAAC,CAAA;gBACxG,GAAG,CAAC,YAAY,OAAO,SAAS,GAAG,CAAC,CAAA;YACxC,CAAC;QACL,CAAC;IACL,CAAC;AACL,CAAC","sourcesContent":["import { join } from 'path'\nimport { out } from '../../output.js'\nimport type { FinalConfig } from '../../types.js'\n\nexport async function doUserSetup(config: FinalConfig): Promise<void> {\n    if (config.setup === undefined) return\n\n    const setupTasks = Array.isArray(config.setup) ? config.setup : [config.setup]\n    for (const setupTask of setupTasks) {\n        switch (typeof setupTask) {\n            case 'function': {\n                await setupTask()\n                break\n            }\n            case 'string': {\n                await import(`file://${join(process.cwd(), setupTask)}`)\n                break\n            }\n            default: {\n                out('Error: setup entry has an invalid type, expected \\'function\\' or \\'string\\' of an file to import.')\n                out(`Received ${typeof setupTask}.`)\n            }\n        }\n    }\n}\n"]}
+{"version":3,"file":"doUserSetup.js","sourceRoot":"","sources":["../../../src/cli/lib/doUserSetup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAA;AAGrC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAmB;IACjD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,OAAM;IAEtC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC9E,IAAI,cAAc,GAAG,CAAC,CAAA;IACtB,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACjC,QAAQ,OAAO,SAAS,EAAE,CAAC;YACvB,KAAK,UAAU,CAAC,CAAC,CAAC;gBACd,GAAG,CAAC,yBAAyB,GAAG,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC,CAAA;gBACzD,MAAM,SAAS,EAAE,CAAA;gBACjB,MAAK;YACT,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACZ,GAAG,CAAC,qBAAqB,GAAG,MAAM,CAAC,EAAE,UAAU,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;gBACpE,MAAM,MAAM,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,EAAE,CAAC,CAAA;gBACxD,MAAK;YACT,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACN,GAAG,CAAC,mGAAmG,CAAC,CAAA;gBACxG,GAAG,CAAC,YAAY,OAAO,SAAS,GAAG,CAAC,CAAA;YACxC,CAAC;QACL,CAAC;IACL,CAAC;AACL,CAAC","sourcesContent":["import { join } from 'path'\nimport { out } from '../../output.js'\nimport type { FinalConfig } from '../../types.js'\n\nexport async function doUserSetup(config: FinalConfig): Promise<void> {\n    if (config.setup === undefined) return\n\n    const setupTasks = Array.isArray(config.setup) ? config.setup : [config.setup]\n    let setupFunctions = 0\n    let setupFiles = 0\n    for (const setupTask of setupTasks) {\n        switch (typeof setupTask) {\n            case 'function': {\n                out('Running setup function ' + String(++setupFunctions))\n                await setupTask()\n                break\n            }\n            case 'string': {\n                out('Running setup file ' + String(++setupFiles) + ': ' + setupTask)\n                await import(`file://${join(process.cwd(), setupTask)}`)\n                break\n            }\n            default: {\n                out('Error: setup entry has an invalid type, expected \\'function\\' or \\'string\\' of an file to import.')\n                out(`Received ${typeof setupTask}.`)\n            }\n        }\n    }\n}\n"]}

package/dist/cli/lib/failureLines.d.ts

@@ -0,0 +1,3 @@
+import type { TestFile, TestResult } from '../../types.js';
+export declare function failureLines(testResults: TestResult[], erroringTests?: Record<string, TestFile>): string[];
+//# sourceMappingURL=failureLines.d.ts.map

package/dist/cli/lib/failureLines.js

@@ -0,0 +1,43 @@
+// The failures for the status file, as f: file > d: describe > t: test > error. Errors are
+// reduced to a single line - anything wanting the diff, the logs or the trace reads the
+// terminal.
+export function failureLines(testResults, erroringTests = {}) {
+    const lines = [];
+    for (const [file, test] of Object.entries(erroringTests)) {
+        lines.push(`  f: ${file}`, `    e: did not load: ${simplifyError(test.error)}`);
+    }
+    for (const testResult of testResults) {
+        const fileLines = [];
+        for (const describeResult of testResult.describeResults) {
+            const describeLines = [];
+            if (describeResult.error !== undefined) {
+                describeLines.push(`      e: threw: ${simplifyError(describeResult.error)}`);
+            }
+            for (const itResult of describeResult.itResults) {
+                if (itResult.success !== false)
+                    continue;
+                describeLines.push(`      t: ${itResult.should}`, `        e: ${simplifyError(itResult.error)}`);
+            }
+            if (describeLines.length > 0) {
+                fileLines.push(`    d: ${describeResult.thing}`, ...describeLines);
+            }
+        }
+        if (fileLines.length > 0)
+            lines.push(`  f: ${testResult.file}`, ...fileLines);
+    }
+    return (lines.length > 0) ? ['Failures:', ...lines] : [];
+}
+function simplifyError(error) {
+    if (error === undefined || error === null || error === false)
+        return 'unknown error';
+    if (typeof error === 'object' && 'message' in error && typeof error.message === 'string') {
+        const name = ('name' in error && typeof error.name === 'string') ? error.name : 'Error';
+        return `${name}: ${firstLine(error.message)}`;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-base-to-string -- only a fallback
+    return firstLine(String(error));
+}
+function firstLine(text) {
+    return text.split('\n')[0]?.trim() ?? '';
+}
+//# sourceMappingURL=failureLines.js.map

package/dist/cli/lib/failureLines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failureLines.js","sourceRoot":"","sources":["../../../src/cli/lib/failureLines.ts"],"names":[],"mappings":"AAEA,2FAA2F;AAC3F,wFAAwF;AACxF,YAAY;AACZ,MAAM,UAAU,YAAY,CACxB,WAAyB,EACzB,gBAA0C,EAAE;IAE5C,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,wBAAwB,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IACnF,CAAC;IAED,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACnC,MAAM,SAAS,GAAa,EAAE,CAAA;QAE9B,KAAK,MAAM,cAAc,IAAI,UAAU,CAAC,eAAe,EAAE,CAAC;YACtD,MAAM,aAAa,GAAa,EAAE,CAAA;YAElC,IAAI,cAAc,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBACrC,aAAa,CAAC,IAAI,CAAC,mBAAmB,aAAa,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YAChF,CAAC;YAED,KAAK,MAAM,QAAQ,IAAI,cAAc,CAAC,SAAS,EAAE,CAAC;gBAC9C,IAAI,QAAQ,CAAC,OAAO,KAAK,KAAK;oBAAE,SAAQ;gBACxC,aAAa,CAAC,IAAI,CACd,YAAY,QAAQ,CAAC,MAAM,EAAE,EAC7B,cAAc,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAChD,CAAA;YACL,CAAC;YAED,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3B,SAAS,CAAC,IAAI,CAAC,UAAU,cAAc,CAAC,KAAK,EAAE,EAAE,GAAG,aAAa,CAAC,CAAA;YACtE,CAAC;QACL,CAAC;QAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,UAAU,CAAC,IAAI,EAAE,EAAE,GAAG,SAAS,CAAC,CAAA;IACjF,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAC5D,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACjC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,eAAe,CAAA;IAEpF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QACvF,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAA;QACvF,OAAO,GAAG,IAAI,KAAK,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAA;IACjD,CAAC;IAED,mFAAmF;IACnF,OAAO,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;AACnC,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AAC5C,CAAC","sourcesContent":["import type { TestFile, TestResult } from '../../types.js'\n\n// The failures for the status file, as f: file > d: describe > t: test > error. Errors are\n// reduced to a single line - anything wanting the diff, the logs or the trace reads the\n// terminal.\nexport function failureLines(\n    testResults: TestResult[],\n    erroringTests: Record<string, TestFile> = {}\n): string[] {\n    const lines: string[] = []\n\n    for (const [file, test] of Object.entries(erroringTests)) {\n        lines.push(`  f: ${file}`, `    e: did not load: ${simplifyError(test.error)}`)\n    }\n\n    for (const testResult of testResults) {\n        const fileLines: string[] = []\n\n        for (const describeResult of testResult.describeResults) {\n            const describeLines: string[] = []\n\n            if (describeResult.error !== undefined) {\n                describeLines.push(`      e: threw: ${simplifyError(describeResult.error)}`)\n            }\n\n            for (const itResult of describeResult.itResults) {\n                if (itResult.success !== false) continue\n                describeLines.push(\n                    `      t: ${itResult.should}`,\n                    `        e: ${simplifyError(itResult.error)}`\n                )\n            }\n\n            if (describeLines.length > 0) {\n                fileLines.push(`    d: ${describeResult.thing}`, ...describeLines)\n            }\n        }\n\n        if (fileLines.length > 0) lines.push(`  f: ${testResult.file}`, ...fileLines)\n    }\n\n    return (lines.length > 0) ? ['Failures:', ...lines] : []\n}\n\nfunction simplifyError(error: unknown): string {\n    if (error === undefined || error === null || error === false) return 'unknown error'\n\n    if (typeof error === 'object' && 'message' in error && typeof error.message === 'string') {\n        const name = ('name' in error && typeof error.name === 'string') ? error.name : 'Error'\n        return `${name}: ${firstLine(error.message)}`\n    }\n\n    // eslint-disable-next-line @typescript-eslint/no-base-to-string -- only a fallback\n    return firstLine(String(error))\n}\n\nfunction firstLine(text: string): string {\n    return text.split('\\n')[0]?.trim() ?? ''\n}\n"]}

package/dist/cli/lib/runTests.js

@@ -9,14 +9,26 @@ import { loadTestFile } from './loadTestFile.js';
 import { runTest } from './runTest.js';
 import { showTestLoadingError } from './showTestLoadingError.js';
 import { showTestResult } from './showTestResult.js';
+import { failureLines } from './failureLines.js';
+import { statusCodes, writeStatusFile } from './statusFile.js';
 import { makeRunManagerState } from './makeWatchRunState.js';
 const { timeProfileAsync } = createTimeProfiler(showTimeProfiling);
+// the summary lines, minus the colouring, for the status file
+function joinPlain(...parts) {
+    return parts.filter(part => part !== '').join(' ');
+}
+function plural(count, noun, verb) {
+    if (count < 1)
+        return '';
+    return `${count} ${noun}${count === 1 ? '' : 's'} ${verb}`;
+}
 export async function runTests(config, testFiles, reRunManager, refresh = 'refresh', customOut, filters = {}) {
     if (reRunManager !== undefined) {
         reRunManager.state.lastTestFiles = new Set(testFiles);
         reRunManager.state.activeRuns++; // whatever, obsolete. Can use it to check on things
     }
     const state = reRunManager?.state || makeRunManagerState();
+    const runStartTime = new Date().getTime();
     //console.log('new runTests:', watchRunState?.activeRuns)
     //console.log(inspect(testFiles))
     try {
@@ -99,6 +111,7 @@ export async function runTests(config, testFiles, reRunManager, refresh = 'refre
                 && failedToLoadCount === 0
                 && describesThrownCount === 0) {
                 out(chalk.orange('No tests matched the describe/test filters.'));
+                writeStatusFile(config, statusCodes.couldNotRun, 'no tests matched the describe/test filters', [], new Date().getTime() - runStartTime);
                 return null;
             }
             out('\n');
@@ -121,17 +134,19 @@ export async function runTests(config, testFiles, reRunManager, refresh = 'refre
             }
             // number of items successful
             const describesText = `Items: ${testsResultsSummary.describesPasses}/${testsResultsSummary.describesTotal}`;
-            const invalidDescribesText = (testsResultsSummary.describesInvalid >= 1)
+            const invalidDescribesPlain = (testsResultsSummary.describesInvalid >= 1)
                 ? (testsResultsSummary.describesInvalid === 1)
-                    ? chalk.grey('(+1 describe without tests)')
-                    : chalk.grey(`(+${testsResultsSummary.describesInvalid} describes without tests)`)
+                    ? '(+1 describe without tests)'
+                    : `(+${testsResultsSummary.describesInvalid} describes without tests)`
                 : '';
-            const describesThrownText = (describesThrownCount >= 1)
+            const describesThrownPlain = (describesThrownCount >= 1)
                 ? (describesThrownCount === 1)
-                    ? chalk.mediumred('(1 describe errored)')
-                    : chalk.mediumred(`(${describesThrownCount} describes errored)`)
+                    ? '(1 describe errored)'
+                    : `(${describesThrownCount} describes errored)`
                 : '';
-            const describesDetailsText = [invalidDescribesText, describesThrownText]
+            const describesDetailsText = [
+                chalk.grey(invalidDescribesPlain), chalk.mediumred(describesThrownPlain)
+            ]
                 .filter(text => text !== '')
                 .join(' ');
             const describesDetailsSuffix = describesDetailsText === '' ? '' : ` ${describesDetailsText}`;
@@ -143,17 +158,19 @@ export async function runTests(config, testFiles, reRunManager, refresh = 'refre
             }
             // number of test files successful
             const testFilesText = `Test Files: ${testsResultsSummary.passes}/${testsResultsSummary.total}`;
-            const invalidTestFilesText = (testsResultsSummary.invalid >= 1)
+            const invalidTestFilesPlain = (testsResultsSummary.invalid >= 1)
                 ? (testsResultsSummary.invalid === 1)
-                    ? chalk.grey('(+1 file without tests)')
-                    : chalk.grey(`(+${testsResultsSummary.invalid} files without tests)`)
+                    ? '(+1 file without tests)'
+                    : `(+${testsResultsSummary.invalid} files without tests)`
                 : '';
-            const failedToLoadText = (failedToLoadCount >= 1)
+            const failedToLoadPlain = (failedToLoadCount >= 1)
                 ? (failedToLoadCount === 1)
-                    ? chalk.mediumred('(1 file failed to load, or errored)')
-                    : chalk.mediumred(`(${failedToLoadCount} files failed to load, or errored)`)
+                    ? '(1 file failed to load, or errored)'
+                    : `(${failedToLoadCount} files failed to load, or errored)`
                 : '';
-            const testFilesDetailsText = [invalidTestFilesText, failedToLoadText]
+            const testFilesDetailsText = [
+                chalk.grey(invalidTestFilesPlain), chalk.mediumred(failedToLoadPlain)
+            ]
                 .filter(text => text !== '')
                 .join(' ');
             const testFilesDetailsSuffix = testFilesDetailsText === '' ? '' : ` ${testFilesDetailsText}`;
@@ -163,6 +180,31 @@ export async function runTests(config, testFiles, reRunManager, refresh = 'refre
             else {
                 out(chalk.mediumred(`${testFilesText}`) + testFilesDetailsSuffix);
             }
+            const summaryLines = [
+                testsText,
+                joinPlain(describesText, invalidDescribesPlain, describesThrownPlain),
+                joinPlain(testFilesText, invalidTestFilesPlain, failedToLoadPlain)
+            ];
+            const durationMs = new Date().getTime() - runStartTime;
+            if (allPassed) {
+                writeStatusFile(config, statusCodes.passed, 'all tests passed', summaryLines, durationMs);
+            }
+            else {
+                const abortedFiles = Object.keys(erroringTests);
+                // a file that would not load, or a describe that threw, means the run died
+                // partway - a different problem from tests that ran and failed
+                const aborted = abortedFiles.length > 0 || describesThrownCount > 0;
+                const failedTestsCount = testsResultsSummary.itsTotal - testsResultsSummary.itsPasses;
+                const description = [
+                    plural(abortedFiles.length, 'test file', 'failed to load or errored'),
+                    plural(describesThrownCount, 'describe', 'errored'),
+                    plural(failedTestsCount, 'test', 'failed')
+                ].filter(part => part !== '').join(', ') || 'test run failed';
+                writeStatusFile(config, (aborted) ? statusCodes.aborted : statusCodes.failed, description, [
+                    ...summaryLines,
+                    ...failureLines(Object.values(runTestResults), erroringTests)
+                ], durationMs);
+            }
             // full success?
             // true/false gets returned to the caller of runTests()
             return allPassed;

package/dist/cli/lib/runTests.js.map

@@ -1 +1 @@
-{"version":3,"file":"runTests.js","sourceRoot":"","sources":["../../../src/cli/lib/runTests.ts"],"names":[],"mappings":"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","sourcesContent":["import { createTimeProfiler } from '../../packages/timeProfiler.js'\nimport { showTimeProfiling } from '../../config.js'\nimport chalk from '../../packages/chalk.js'\nimport { out as mainOut } from '../../output.js'\nimport figures from '../../packages/figures.js'\nimport { count } from 'sxy-lib/objects.js'\nimport { remove as arrayRemove } from 'sxy-lib/arrays.js'\nimport { allObj as promiseAllObj } from 'sxy-lib/promises.js'\n\nimport { loadTestFile } from './loadTestFile.js'\nimport { runTest } from './runTest.js'\nimport { showTestLoadingError } from './showTestLoadingError.js'\nimport { showTestResult } from './showTestResult.js'\n\nimport type {\n    FinalConfig, OutFn, TestExecutionFilters, TestFile, TestResult, TestsResultsSummary\n} from '../../types.js'\nimport { makeRunManagerState, ReRunManageState } from './makeWatchRunState.js'\nimport { ReRunManager } from './reRunManager.js'\n\nconst { timeProfileAsync } = createTimeProfiler(showTimeProfiling)\n\nexport type RunTestsPromise = Promise<boolean | null>\n\nexport async function runTests(\n    config: FinalConfig,\n    testFiles: Set<string>,\n    reRunManager: ReRunManager | undefined,\n    refresh: 'refresh' | 'cached' = 'refresh',\n    customOut?: OutFn,\n    filters: TestExecutionFilters = {}\n): RunTestsPromise {\n    if (reRunManager !== undefined) {\n        reRunManager.state.lastTestFiles = new Set(testFiles)\n        reRunManager.state.activeRuns++ // whatever, obsolete. Can use it to check on things\n    }\n\n    const state = reRunManager?.state || makeRunManagerState()\n    //console.log('new runTests:', watchRunState?.activeRuns)\n    //console.log(inspect(testFiles))\n\n    try {\n        const testRunPromises: Record<string, Promise<TestResult>> = {}\n        const erroringTests: Record<string, TestFile> = {}\n        const testRunOutPromises: Record<string, Promise<void>> = {}\n\n        await timeProfileAsync('run tests', async () => {\n            if (Array.isArray(testFiles) ? testFiles.length > 0 : testFiles.size > 0) {\n                for (const testFile of testFiles) {\n                    //console.log('testFiles', testFiles)\n                    //console.log('testFile', testFile)\n                    const test = await loadTestFile(config, testFile, refresh)\n\n                    if (test.error !== undefined && test.error !== false) {\n                        erroringTests[testFile] = test\n                        state.failedTestFiles.add(testFile)\n                        showTestLoadingError(config, test, customOut)\n                    } else {\n                        const testRunPromise = runTest(config, test, filters)\n                        testRunPromises[testFile] = testRunPromise\n\n                        testRunOutPromises[testFile] = testRunPromise.then(async testResult => {\n                            if (testResult.success === true || testResult.success === null) {\n                                state.failedTestFiles.delete(testResult.file)\n                            } else {\n                                state.failedTestFiles.add(testFile)\n                            }\n                            const executionFilterActive = filters.describe !== undefined || filters.it !== undefined\n                            if (!executionFilterActive || testResult.describeResultsSummary.itsTotal > 0) {\n                                await showTestResult(config, testResult, customOut)\n                            }\n                        })\n\n                    // wait for the test to complete before proceeding if we are in 'sequential' mode\n                        if (config.execution.files === 'sequential') await testRunOutPromises[testFile]\n                    }\n                }\n            }\n        })\n\n        let runTestResults: Record<string, TestResult> = {}\n\n        await timeProfileAsync('wait for tests to finish', async () => {\n            runTestResults = await promiseAllObj(testRunPromises)\n\n        // wait for the output to complete\n            await promiseAllObj(testRunOutPromises)\n        })\n\n        return await timeProfileAsync('show initial test run results', () => {\n            \n            const out = customOut ?? mainOut\n\n            const testsResultsSummary: TestsResultsSummary = {\n                total: 0,\n                passes: 0,\n                invalid: 0,\n                describesTotal: 0,\n                describesPasses: 0,\n                describesInvalid: 0,\n                itsTotal: 0,\n                itsPasses: 0\n            // itsInvalid: 0 // we don't check whether tests run any asserts (we don't control the assertion lib)\n            }\n            let describesThrownCount = 0\n\n            for (const testFile in runTestResults) {\n                const runTestResult = runTestResults[testFile]\n                if (!runTestResult) continue\n\n                testsResultsSummary.total += +(runTestResult.success !== null)\n                testsResultsSummary.passes += +(runTestResult.success ?? false)\n                testsResultsSummary.invalid += +(runTestResult.success === null)\n                testsResultsSummary.describesTotal += runTestResult.describeResultsSummary.total\n                testsResultsSummary.describesPasses += runTestResult.describeResultsSummary.passes\n                testsResultsSummary.describesInvalid += runTestResult.describeResultsSummary.invalid\n                testsResultsSummary.itsTotal += runTestResult.describeResultsSummary.itsTotal\n                testsResultsSummary.itsPasses += runTestResult.describeResultsSummary.itsPasses\n                describesThrownCount += runTestResult.describeResults\n                    .filter(describeResult => describeResult.error !== undefined)\n                    .length\n            }\n\n            const failedToLoadCount = count(erroringTests)\n            testsResultsSummary.total += failedToLoadCount\n\n            if (\n                (filters.describe !== undefined || filters.it !== undefined)\n                && testsResultsSummary.itsTotal === 0\n                && failedToLoadCount === 0\n                && describesThrownCount === 0\n            ) {\n                out(chalk.orange('No tests matched the describe/test filters.'))\n                return null\n            }\n\n            out('\\n')\n\n            const allPassed = (\n                testsResultsSummary.passes === testsResultsSummary.total\n                && testsResultsSummary.describesPasses === testsResultsSummary.describesTotal\n                && testsResultsSummary.itsPasses === testsResultsSummary.itsTotal\n            )\n\n            if (allPassed) {\n                out(chalk.mediumgreen(`${figures.tick}`))\n            } else {\n                out(chalk.mediumred(`${figures.cross}`))\n            }\n\n        // number of tests successful\n            const testsText = `Tests: ${testsResultsSummary.itsPasses}/${testsResultsSummary.itsTotal}`\n            if (testsResultsSummary.itsPasses === testsResultsSummary.itsTotal) {\n                out(chalk.mediumgreen(`${testsText}`))\n            } else {\n                out(chalk.mediumred(`${testsText}`))\n            }\n\n        // number of items successful\n            const describesText = `Items: ${testsResultsSummary.describesPasses}/${testsResultsSummary.describesTotal}`\n            const invalidDescribesText = (testsResultsSummary.describesInvalid >= 1)\n                ? (testsResultsSummary.describesInvalid === 1)\n                    ? chalk.grey('(+1 describe without tests)')\n                    : chalk.grey(`(+${testsResultsSummary.describesInvalid} describes without tests)`)\n                : ''\n            const describesThrownText = (describesThrownCount >= 1)\n                ? (describesThrownCount === 1)\n                    ? chalk.mediumred('(1 describe errored)')\n                    : chalk.mediumred(`(${describesThrownCount} describes errored)`)\n                : ''\n            const describesDetailsText = [invalidDescribesText, describesThrownText]\n                .filter(text => text !== '')\n                .join(' ')\n            const describesDetailsSuffix = describesDetailsText === '' ? '' : ` ${describesDetailsText}`\n            if (testsResultsSummary.describesPasses === testsResultsSummary.describesTotal) {\n                out(chalk.mediumgreen(`${describesText}`) + describesDetailsSuffix)\n            } else {\n                out(chalk.mediumred(`${describesText}`) + describesDetailsSuffix)\n            }\n\n        // number of test files successful\n            const testFilesText = `Test Files: ${testsResultsSummary.passes}/${testsResultsSummary.total}`\n            const invalidTestFilesText = (testsResultsSummary.invalid >= 1)\n                ? (testsResultsSummary.invalid === 1)\n                    ? chalk.grey('(+1 file without tests)')\n                    : chalk.grey(`(+${testsResultsSummary.invalid} files without tests)`)\n                : ''\n            const failedToLoadText = (failedToLoadCount >= 1)\n                ? (failedToLoadCount === 1)\n                    ? chalk.mediumred('(1 file failed to load, or errored)')\n                    : chalk.mediumred(`(${failedToLoadCount} files failed to load, or errored)`)\n                : ''\n            const testFilesDetailsText = [invalidTestFilesText, failedToLoadText]\n                .filter(text => text !== '')\n                .join(' ')\n            const testFilesDetailsSuffix = testFilesDetailsText === '' ? '' : ` ${testFilesDetailsText}`\n            if (testsResultsSummary.passes === testsResultsSummary.total) {\n                out(chalk.mediumgreen(`${testFilesText}`) + testFilesDetailsSuffix)\n            } else {\n                out(chalk.mediumred(`${testFilesText}`) + testFilesDetailsSuffix)\n            }\n\n            // full success?\n            // true/false gets returned to the caller of runTests()\n            return allPassed\n        })\n    } finally {\n        if (reRunManager !== undefined) reRunManager.state.activeRuns--\n    }\n}\n\n"]}
+{"version":3,"file":"runTests.js","sourceRoot":"","sources":["../../../src/cli/lib/runTests.ts"],"names":[],"mappings":"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","sourcesContent":["import { createTimeProfiler } from '../../packages/timeProfiler.js'\nimport { showTimeProfiling } from '../../config.js'\nimport chalk from '../../packages/chalk.js'\nimport { out as mainOut } from '../../output.js'\nimport figures from '../../packages/figures.js'\nimport { count } from 'sxy-lib/objects.js'\nimport { remove as arrayRemove } from 'sxy-lib/arrays.js'\nimport { allObj as promiseAllObj } from 'sxy-lib/promises.js'\n\nimport { loadTestFile } from './loadTestFile.js'\nimport { runTest } from './runTest.js'\nimport { showTestLoadingError } from './showTestLoadingError.js'\nimport { showTestResult } from './showTestResult.js'\nimport { failureLines } from './failureLines.js'\nimport { statusCodes, writeStatusFile } from './statusFile.js'\n\nimport type {\n    FinalConfig, OutFn, TestExecutionFilters, TestFile, TestResult, TestsResultsSummary\n} from '../../types.js'\nimport { makeRunManagerState, ReRunManageState } from './makeWatchRunState.js'\nimport { ReRunManager } from './reRunManager.js'\n\nconst { timeProfileAsync } = createTimeProfiler(showTimeProfiling)\n\nexport type RunTestsPromise = Promise<boolean | null>\n\n// the summary lines, minus the colouring, for the status file\nfunction joinPlain(...parts: string[]): string {\n    return parts.filter(part => part !== '').join(' ')\n}\n\nfunction plural(count: number, noun: string, verb: string): string {\n    if (count < 1) return ''\n    return `${count} ${noun}${count === 1 ? '' : 's'} ${verb}`\n}\n\n\nexport async function runTests(\n    config: FinalConfig,\n    testFiles: Set<string>,\n    reRunManager: ReRunManager | undefined,\n    refresh: 'refresh' | 'cached' = 'refresh',\n    customOut?: OutFn,\n    filters: TestExecutionFilters = {}\n): RunTestsPromise {\n    if (reRunManager !== undefined) {\n        reRunManager.state.lastTestFiles = new Set(testFiles)\n        reRunManager.state.activeRuns++ // whatever, obsolete. Can use it to check on things\n    }\n\n    const state = reRunManager?.state || makeRunManagerState()\n    const runStartTime = new Date().getTime()\n    //console.log('new runTests:', watchRunState?.activeRuns)\n    //console.log(inspect(testFiles))\n\n    try {\n        const testRunPromises: Record<string, Promise<TestResult>> = {}\n        const erroringTests: Record<string, TestFile> = {}\n        const testRunOutPromises: Record<string, Promise<void>> = {}\n\n        await timeProfileAsync('run tests', async () => {\n            if (Array.isArray(testFiles) ? testFiles.length > 0 : testFiles.size > 0) {\n                for (const testFile of testFiles) {\n                    //console.log('testFiles', testFiles)\n                    //console.log('testFile', testFile)\n                    const test = await loadTestFile(config, testFile, refresh)\n\n                    if (test.error !== undefined && test.error !== false) {\n                        erroringTests[testFile] = test\n                        state.failedTestFiles.add(testFile)\n                        showTestLoadingError(config, test, customOut)\n                    } else {\n                        const testRunPromise = runTest(config, test, filters)\n                        testRunPromises[testFile] = testRunPromise\n\n                        testRunOutPromises[testFile] = testRunPromise.then(async testResult => {\n                            if (testResult.success === true || testResult.success === null) {\n                                state.failedTestFiles.delete(testResult.file)\n                            } else {\n                                state.failedTestFiles.add(testFile)\n                            }\n                            const executionFilterActive = filters.describe !== undefined || filters.it !== undefined\n                            if (!executionFilterActive || testResult.describeResultsSummary.itsTotal > 0) {\n                                await showTestResult(config, testResult, customOut)\n                            }\n                        })\n\n                    // wait for the test to complete before proceeding if we are in 'sequential' mode\n                        if (config.execution.files === 'sequential') await testRunOutPromises[testFile]\n                    }\n                }\n            }\n        })\n\n        let runTestResults: Record<string, TestResult> = {}\n\n        await timeProfileAsync('wait for tests to finish', async () => {\n            runTestResults = await promiseAllObj(testRunPromises)\n\n        // wait for the output to complete\n            await promiseAllObj(testRunOutPromises)\n        })\n\n        return await timeProfileAsync('show initial test run results', () => {\n            \n            const out = customOut ?? mainOut\n\n            const testsResultsSummary: TestsResultsSummary = {\n                total: 0,\n                passes: 0,\n                invalid: 0,\n                describesTotal: 0,\n                describesPasses: 0,\n                describesInvalid: 0,\n                itsTotal: 0,\n                itsPasses: 0\n            // itsInvalid: 0 // we don't check whether tests run any asserts (we don't control the assertion lib)\n            }\n            let describesThrownCount = 0\n\n            for (const testFile in runTestResults) {\n                const runTestResult = runTestResults[testFile]\n                if (!runTestResult) continue\n\n                testsResultsSummary.total += +(runTestResult.success !== null)\n                testsResultsSummary.passes += +(runTestResult.success ?? false)\n                testsResultsSummary.invalid += +(runTestResult.success === null)\n                testsResultsSummary.describesTotal += runTestResult.describeResultsSummary.total\n                testsResultsSummary.describesPasses += runTestResult.describeResultsSummary.passes\n                testsResultsSummary.describesInvalid += runTestResult.describeResultsSummary.invalid\n                testsResultsSummary.itsTotal += runTestResult.describeResultsSummary.itsTotal\n                testsResultsSummary.itsPasses += runTestResult.describeResultsSummary.itsPasses\n                describesThrownCount += runTestResult.describeResults\n                    .filter(describeResult => describeResult.error !== undefined)\n                    .length\n            }\n\n            const failedToLoadCount = count(erroringTests)\n            testsResultsSummary.total += failedToLoadCount\n\n            if (\n                (filters.describe !== undefined || filters.it !== undefined)\n                && testsResultsSummary.itsTotal === 0\n                && failedToLoadCount === 0\n                && describesThrownCount === 0\n            ) {\n                out(chalk.orange('No tests matched the describe/test filters.'))\n                writeStatusFile(\n                    config,\n                    statusCodes.couldNotRun,\n                    'no tests matched the describe/test filters',\n                    [],\n                    new Date().getTime() - runStartTime\n                )\n                return null\n            }\n\n            out('\\n')\n\n            const allPassed = (\n                testsResultsSummary.passes === testsResultsSummary.total\n                && testsResultsSummary.describesPasses === testsResultsSummary.describesTotal\n                && testsResultsSummary.itsPasses === testsResultsSummary.itsTotal\n            )\n\n            if (allPassed) {\n                out(chalk.mediumgreen(`${figures.tick}`))\n            } else {\n                out(chalk.mediumred(`${figures.cross}`))\n            }\n\n        // number of tests successful\n            const testsText = `Tests: ${testsResultsSummary.itsPasses}/${testsResultsSummary.itsTotal}`\n            if (testsResultsSummary.itsPasses === testsResultsSummary.itsTotal) {\n                out(chalk.mediumgreen(`${testsText}`))\n            } else {\n                out(chalk.mediumred(`${testsText}`))\n            }\n\n        // number of items successful\n            const describesText = `Items: ${testsResultsSummary.describesPasses}/${testsResultsSummary.describesTotal}`\n            const invalidDescribesPlain = (testsResultsSummary.describesInvalid >= 1)\n                ? (testsResultsSummary.describesInvalid === 1)\n                    ? '(+1 describe without tests)'\n                    : `(+${testsResultsSummary.describesInvalid} describes without tests)`\n                : ''\n            const describesThrownPlain = (describesThrownCount >= 1)\n                ? (describesThrownCount === 1)\n                    ? '(1 describe errored)'\n                    : `(${describesThrownCount} describes errored)`\n                : ''\n            const describesDetailsText = [\n                chalk.grey(invalidDescribesPlain), chalk.mediumred(describesThrownPlain)\n            ]\n                .filter(text => text !== '')\n                .join(' ')\n            const describesDetailsSuffix = describesDetailsText === '' ? '' : ` ${describesDetailsText}`\n            if (testsResultsSummary.describesPasses === testsResultsSummary.describesTotal) {\n                out(chalk.mediumgreen(`${describesText}`) + describesDetailsSuffix)\n            } else {\n                out(chalk.mediumred(`${describesText}`) + describesDetailsSuffix)\n            }\n\n        // number of test files successful\n            const testFilesText = `Test Files: ${testsResultsSummary.passes}/${testsResultsSummary.total}`\n            const invalidTestFilesPlain = (testsResultsSummary.invalid >= 1)\n                ? (testsResultsSummary.invalid === 1)\n                    ? '(+1 file without tests)'\n                    : `(+${testsResultsSummary.invalid} files without tests)`\n                : ''\n            const failedToLoadPlain = (failedToLoadCount >= 1)\n                ? (failedToLoadCount === 1)\n                    ? '(1 file failed to load, or errored)'\n                    : `(${failedToLoadCount} files failed to load, or errored)`\n                : ''\n            const testFilesDetailsText = [\n                chalk.grey(invalidTestFilesPlain), chalk.mediumred(failedToLoadPlain)\n            ]\n                .filter(text => text !== '')\n                .join(' ')\n            const testFilesDetailsSuffix = testFilesDetailsText === '' ? '' : ` ${testFilesDetailsText}`\n            if (testsResultsSummary.passes === testsResultsSummary.total) {\n                out(chalk.mediumgreen(`${testFilesText}`) + testFilesDetailsSuffix)\n            } else {\n                out(chalk.mediumred(`${testFilesText}`) + testFilesDetailsSuffix)\n            }\n\n            const summaryLines = [\n                testsText,\n                joinPlain(describesText, invalidDescribesPlain, describesThrownPlain),\n                joinPlain(testFilesText, invalidTestFilesPlain, failedToLoadPlain)\n            ]\n\n            const durationMs = new Date().getTime() - runStartTime\n\n            if (allPassed) {\n                writeStatusFile(\n                    config, statusCodes.passed, 'all tests passed', summaryLines, durationMs\n                )\n            } else {\n                const abortedFiles = Object.keys(erroringTests)\n\n                // a file that would not load, or a describe that threw, means the run died\n                // partway - a different problem from tests that ran and failed\n                const aborted = abortedFiles.length > 0 || describesThrownCount > 0\n                const failedTestsCount = testsResultsSummary.itsTotal - testsResultsSummary.itsPasses\n\n                const description = [\n                    plural(abortedFiles.length, 'test file', 'failed to load or errored'),\n                    plural(describesThrownCount, 'describe', 'errored'),\n                    plural(failedTestsCount, 'test', 'failed')\n                ].filter(part => part !== '').join(', ') || 'test run failed'\n\n                writeStatusFile(\n                    config,\n                    (aborted) ? statusCodes.aborted : statusCodes.failed,\n                    description,\n                    [\n                        ...summaryLines,\n                        ...failureLines(Object.values(runTestResults), erroringTests)\n                    ],\n                    durationMs\n                )\n            }\n\n            // full success?\n            // true/false gets returned to the caller of runTests()\n            return allPassed\n        })\n    } finally {\n        if (reRunManager !== undefined) reRunManager.state.activeRuns--\n    }\n}\n\n"]}

package/dist/cli/lib/statusFile.d.ts

@@ -0,0 +1,12 @@
+import type { FinalConfig } from '../../types.js';
+export declare const statusCodes: {
+    readonly notRunYet: -1;
+    readonly passed: 0;
+    readonly failed: 1;
+    readonly aborted: 2;
+    readonly couldNotRun: 3;
+};
+export type StatusCode = typeof statusCodes[keyof typeof statusCodes];
+export declare function resetStatusFile(config: FinalConfig): void;
+export declare function writeStatusFile(config: FinalConfig, code: StatusCode, description: string, details?: string[], durationMs?: number): void;
+//# sourceMappingURL=statusFile.d.ts.map

package/dist/cli/lib/statusFile.js

@@ -0,0 +1,60 @@
+import fs from 'fs';
+import path from 'path';
+import chalk from '../../packages/chalk.js';
+import { packageName } from '../../config.js';
+import { log } from '../../output.js';
+// The status file holds the result of the latest run: `<code> - <description>` on the first
+// line, then any detail. Watch mode resets it to -1 on startup so a stale result is never
+// mistaken for the current one.
+export const statusCodes = {
+    notRunYet: -1, // watch mode has started, but no run has finished
+    passed: 0,
+    failed: 1, // tests ran and failed
+    aborted: 2, // the run died partway - a test file failed to load, or a describe threw
+    couldNotRun: 3 // nothing ran at all - no test files, or no match for the filters
+};
+export function resetStatusFile(config) {
+    writeStatusFile(config, statusCodes.notRunYet, 'no run has finished yet');
+}
+export function writeStatusFile(config, code, description, details = [], durationMs) {
+    write(config, [
+        `${code} - ${description}`,
+        localTime(new Date()),
+        ...details,
+        ...(durationMs === undefined) ? [] : [`${durationMs.toLocaleString()}ms`]
+    ].join('\n') + '\n');
+}
+// local time, so the file reads the way the terminal beside it does, with the offset so a
+// reader elsewhere can still place it
+function localTime(date) {
+    const pad = (value) => String(value).padStart(2, '0');
+    // getTimezoneOffset() counts minutes behind UTC, so the sign is the other way round
+    const offsetMinutes = -date.getTimezoneOffset();
+    const offset = `${(offsetMinutes < 0) ? '-' : '+'}`
+        + `${pad(Math.floor(Math.abs(offsetMinutes) / 60))}:${pad(Math.abs(offsetMinutes) % 60)}`;
+    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`
+        + ` ${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`
+        + ` ${offset}`;
+}
+function write(config, contents) {
+    const statusFile = config.watch.statusFile;
+    if (typeof statusFile !== 'string' || statusFile === '')
+        return;
+    const location = path.resolve(process.cwd(), statusFile);
+    // written via a temp file and renamed, so a poller never reads a half written status
+    const tempLocation = `${location}.${process.pid}.tmp`;
+    try {
+        fs.mkdirSync(path.dirname(location), { recursive: true });
+        fs.writeFileSync(tempLocation, contents);
+        fs.renameSync(tempLocation, location);
+    }
+    catch (error) {
+        // never let the status file take the run down with it
+        log(chalk.mediumred(`[${packageName}] Could not write status file ${location}: ${String(error)}`));
+        try {
+            fs.rmSync(tempLocation, { force: true });
+        }
+        catch { /* nothing more to do */ }
+    }
+}
+//# sourceMappingURL=statusFile.js.map

package/dist/cli/lib/statusFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusFile.js","sourceRoot":"","sources":["../../../src/cli/lib/statusFile.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from 'fs'\nimport path from 'path'\n\nimport chalk from '../../packages/chalk.js'\nimport { packageName } from '../../config.js'\nimport { log } from '../../output.js'\n\nimport type { FinalConfig } from '../../types.js'\n\n// The status file holds the result of the latest run: `<code> - <description>` on the first\n// line, then any detail. Watch mode resets it to -1 on startup so a stale result is never\n// mistaken for the current one.\nexport const statusCodes = {\n    notRunYet: -1, // watch mode has started, but no run has finished\n    passed: 0,\n    failed: 1, // tests ran and failed\n    aborted: 2, // the run died partway - a test file failed to load, or a describe threw\n    couldNotRun: 3 // nothing ran at all - no test files, or no match for the filters\n} as const\n\nexport type StatusCode = typeof statusCodes[keyof typeof statusCodes]\n\nexport function resetStatusFile(config: FinalConfig): void {\n    writeStatusFile(config, statusCodes.notRunYet, 'no run has finished yet')\n}\n\nexport function writeStatusFile(\n    config: FinalConfig,\n    code: StatusCode,\n    description: string,\n    details: string[] = [],\n    durationMs?: number\n): void {\n    write(config, [\n        `${code} - ${description}`,\n        localTime(new Date()),\n        ...details,\n        ...(durationMs === undefined) ? [] : [`${durationMs.toLocaleString()}ms`]\n    ].join('\\n') + '\\n')\n}\n\n// local time, so the file reads the way the terminal beside it does, with the offset so a\n// reader elsewhere can still place it\nfunction localTime(date: Date): string {\n    const pad = (value: number): string => String(value).padStart(2, '0')\n    // getTimezoneOffset() counts minutes behind UTC, so the sign is the other way round\n    const offsetMinutes = -date.getTimezoneOffset()\n    const offset = `${(offsetMinutes < 0) ? '-' : '+'}`\n        + `${pad(Math.floor(Math.abs(offsetMinutes) / 60))}:${pad(Math.abs(offsetMinutes) % 60)}`\n    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`\n        + ` ${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`\n        + ` ${offset}`\n}\n\nfunction write(config: FinalConfig, contents: string): void {\n    const statusFile = config.watch.statusFile\n    if (typeof statusFile !== 'string' || statusFile === '') return\n\n    const location = path.resolve(process.cwd(), statusFile)\n    // written via a temp file and renamed, so a poller never reads a half written status\n    const tempLocation = `${location}.${process.pid}.tmp`\n    try {\n        fs.mkdirSync(path.dirname(location), { recursive: true })\n        fs.writeFileSync(tempLocation, contents)\n        fs.renameSync(tempLocation, location)\n    } catch (error) {\n        // never let the status file take the run down with it\n        log(chalk.mediumred(\n            `[${packageName}] Could not write status file ${location}: ${String(error)}`\n        ))\n        try { fs.rmSync(tempLocation, { force: true }) } catch { /* nothing more to do */ }\n    }\n}\n"]}

package/dist/cli/lib/validateConfig.js

@@ -20,5 +20,9 @@ export function validateConfig(config, customOut) {
     if (typeof config.watch.ttyActionsOnKeypress !== 'boolean') {
         doError('Config error, config.watch.ttyActionsOnKeypress should be a boolean');
     }
+    const statusFile = config.watch.statusFile;
+    if (statusFile !== false && (typeof statusFile !== 'string' || statusFile === '')) {
+        doError('Config error, config.watch.statusFile should be false or a file path');
+    }
 }
 //# sourceMappingURL=validateConfig.js.map

package/dist/cli/lib/validateConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"validateConfig.js","sourceRoot":"","sources":["../../../src/cli/lib/validateConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,IAAI,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAGhD,MAAM,UAAU,cAAc,CAAC,MAAmB,EAAE,SAAiB;IACjE,MAAM,GAAG,GAAG,SAAS,IAAI,OAAO,CAAA;IAEhC,SAAS,OAAO,CAAC,OAAe;QAC5B,GAAG,CAAC,OAAO,CAAC,CAAA;QACZ,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAA;IAC5B,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,CAAC,+CAA+C,CAAC,CAAA;IAC5D,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,KAAK,UAAU,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;QACnF,OAAO,CAAC,+EAA+E,CAAC,CAAA;IAC5F,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,CAAC,SAAS,KAAK,UAAU,IAAI,MAAM,CAAC,SAAS,CAAC,SAAS,KAAK,YAAY,EAAE,CAAC;QAC3F,OAAO,CAAC,mFAAmF,CAAC,CAAA;IAChG,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,KAAK,UAAU,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;QACnF,OAAO,CAAC,+EAA+E,CAAC,CAAA;IAC5F,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,KAAK,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;QACzD,OAAO,CAAC,qEAAqE,CAAC,CAAA;IAClF,CAAC;AACL,CAAC","sourcesContent":["import { out as mainOut } from '../../output.js'\nimport type { FinalConfig, OutFn } from '../../types.js'\n\nexport function validateConfig(config: FinalConfig, customOut?: OutFn): void {\n    const out = customOut ?? mainOut\n\n    function doError(message: string): never {\n        out(message)\n        throw new Error(message)\n    }\n\n    if (config.execution === undefined) {\n        doError('Config error, config.execution is not defined')\n    }\n\n    if (config.execution.files !== 'parallel' && config.execution.files !== 'sequential') {\n        doError('Config error, config.execution.files should be \\'parallel\\' or \\'sequential\\'')\n    }\n\n    if (config.execution.describes !== 'parallel' && config.execution.describes !== 'sequential') {\n        doError('Config error, config.execution.describes should be \\'parallel\\' or \\'sequential\\'')\n    }\n\n    if (config.execution.tests !== 'parallel' && config.execution.tests !== 'sequential') {\n        doError('Config error, config.execution.tests should be \\'parallel\\' or \\'sequential\\'')\n    }\n\n    if (typeof config.watch.ttyActionsOnKeypress !== 'boolean') {\n        doError('Config error, config.watch.ttyActionsOnKeypress should be a boolean')\n    }\n}\n"]}
+{"version":3,"file":"validateConfig.js","sourceRoot":"","sources":["../../../src/cli/lib/validateConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,IAAI,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAGhD,MAAM,UAAU,cAAc,CAAC,MAAmB,EAAE,SAAiB;IACjE,MAAM,GAAG,GAAG,SAAS,IAAI,OAAO,CAAA;IAEhC,SAAS,OAAO,CAAC,OAAe;QAC5B,GAAG,CAAC,OAAO,CAAC,CAAA;QACZ,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAA;IAC5B,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,CAAC,+CAA+C,CAAC,CAAA;IAC5D,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,KAAK,UAAU,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;QACnF,OAAO,CAAC,+EAA+E,CAAC,CAAA;IAC5F,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,CAAC,SAAS,KAAK,UAAU,IAAI,MAAM,CAAC,SAAS,CAAC,SAAS,KAAK,YAAY,EAAE,CAAC;QAC3F,OAAO,CAAC,mFAAmF,CAAC,CAAA;IAChG,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,KAAK,UAAU,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;QACnF,OAAO,CAAC,+EAA+E,CAAC,CAAA;IAC5F,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,KAAK,CAAC,oBAAoB,KAAK,SAAS,EAAE,CAAC;QACzD,OAAO,CAAC,qEAAqE,CAAC,CAAA;IAClF,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAA;IAC1C,IAAI,UAAU,KAAK,KAAK,IAAI,CAAC,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,EAAE,CAAC,EAAE,CAAC;QAChF,OAAO,CAAC,sEAAsE,CAAC,CAAA;IACnF,CAAC;AACL,CAAC","sourcesContent":["import { out as mainOut } from '../../output.js'\nimport type { FinalConfig, OutFn } from '../../types.js'\n\nexport function validateConfig(config: FinalConfig, customOut?: OutFn): void {\n    const out = customOut ?? mainOut\n\n    function doError(message: string): never {\n        out(message)\n        throw new Error(message)\n    }\n\n    if (config.execution === undefined) {\n        doError('Config error, config.execution is not defined')\n    }\n\n    if (config.execution.files !== 'parallel' && config.execution.files !== 'sequential') {\n        doError('Config error, config.execution.files should be \\'parallel\\' or \\'sequential\\'')\n    }\n\n    if (config.execution.describes !== 'parallel' && config.execution.describes !== 'sequential') {\n        doError('Config error, config.execution.describes should be \\'parallel\\' or \\'sequential\\'')\n    }\n\n    if (config.execution.tests !== 'parallel' && config.execution.tests !== 'sequential') {\n        doError('Config error, config.execution.tests should be \\'parallel\\' or \\'sequential\\'')\n    }\n\n    if (typeof config.watch.ttyActionsOnKeypress !== 'boolean') {\n        doError('Config error, config.watch.ttyActionsOnKeypress should be a boolean')\n    }\n\n    const statusFile = config.watch.statusFile\n    if (statusFile !== false && (typeof statusFile !== 'string' || statusFile === '')) {\n        doError('Config error, config.watch.statusFile should be false or a file path')\n    }\n}\n"]}

package/dist/cli/watch.js

@@ -31,6 +31,10 @@ export async function watch() {
         'filter-describe': {
             flag: 'd',
             hasValue: true
+        },
+        'status-file': {
+            flag: 's',
+            hasValue: true
         }
     };
     const clArguments = parseCommandLineArguments(allowedClArguments);
@@ -54,6 +58,13 @@ export async function watch() {
         }
         userConfig.testsFilter = filter;
     }
+    if ('status-file' in clArguments) {
+        const statusFile = clArguments['status-file'];
+        if (typeof statusFile !== 'string' || statusFile === '') {
+            throw new Error('No file path specified for --status-file or -s argument');
+        }
+        userConfig.watch = { ...userConfig.watch, statusFile };
+    }
     const filterIt = clArguments['filter-it'];
     const filterDescribe = clArguments['filter-describe'];
     if (filterIt === true || filterIt === '')
@@ -66,6 +77,9 @@ export async function watch() {
     const config = applyConfigDefaults(userConfig);
     const { validateConfig } = await import('./lib/validateConfig.js');
     validateConfig(config);
+    // no run has finished yet, so the status file starts at -1 rather than stale
+    const { resetStatusFile, statusCodes, writeStatusFile } = await import('./lib/statusFile.js');
+    resetStatusFile(config);
     const { doUserSetup } = await import('./lib/doUserSetup.js');
     await doUserSetup(config);
     // watch mode never reaches an end of its own, so teardown only gets a chance on the way
@@ -110,6 +124,7 @@ export async function watch() {
     }
     else {
         out(chalk.orange `no test files found`);
+        writeStatusFile(config, statusCodes.couldNotRun, 'no test files found');
     }
     const { watchFilesAndRunTests } = await import('./lib/watchFilesAndRunTests.js');
     await watchFilesAndRunTests(config, 

package/dist/cli/watch.js.map

@@ -1 +1 @@
-{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/cli/watch.ts"],"names":[],"mappings":"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","sourcesContent":["import chalk from '../packages/chalk.js'\r\n\r\nimport { packageName } from '../config.js'\r\nimport { out, debug } from '../output.js'\r\n\r\nimport type { AllowedArguments, DependencyTrees } from '../types.js'\r\nimport { setEnv } from './lib/setEnv.js'\r\nimport { findingTestsMessage } from './lib/findingTestsMessage.js'\r\nimport { foundTestsMessage } from './lib/foundTestsMessage.js'\r\nimport { isTest } from './lib/isTest.js'\r\nimport { makeRunManagerState } from './lib/makeWatchRunState.js'\r\nimport { makeReRunManager } from './lib/reRunManager.js'\r\n\r\nexport async function watch(): Promise<void> {\r\n    out(chalk.brightblue`[${packageName}]...`)\r\n\r\n    const startTime = new Date().getTime()\r\n\r\n    const { parseCommandLineArguments } = await import('./lib/parseCommandLineArguments.js')\r\n    const allowedClArguments: AllowedArguments = {\r\n        'config': {\r\n            flag: 'c',\r\n            hasValue: true\r\n        },\r\n        'test-files': {\r\n            flag: 't',\r\n            hasValue: true\r\n        },\r\n        'filter': {\r\n            flag: 'f',\r\n            hasValue: true\r\n        },\r\n        'filter-it': {\r\n            flag: 'i',\r\n            hasValue: true\r\n        },\r\n        'filter-describe': {\r\n            flag: 'd',\r\n            hasValue: true\r\n        }\r\n    }\r\n    const clArguments = parseCommandLineArguments(allowedClArguments)\r\n    //debug('clArguments', clArguments)\r\n\r\n    setEnv()\r\n\r\n    const { loadConfig } = await import('./lib/loadConfig.js')\r\n    const userConfig = (typeof clArguments.config === 'string')\r\n        ? await loadConfig(clArguments.config)\r\n        : await loadConfig()\r\n\r\n    if ('test-files' in clArguments) {\r\n        const testFilesPattern = clArguments['test-files']\r\n        if (typeof testFilesPattern !== 'string' || testFilesPattern === '') {\r\n            throw new Error('No pattern specified for --test-files or -t argument')\r\n        }\r\n        userConfig.tests = testFilesPattern\r\n    }\r\n\r\n    if ('filter' in clArguments) {\r\n        const filter = clArguments.filter\r\n        if (typeof filter !== 'string' || filter === '') {\r\n            throw new Error('No pattern specified for --filter or -f argument')\r\n        }\r\n        userConfig.testsFilter = filter\r\n    }\r\n\r\n    const filterIt = clArguments['filter-it']\r\n    const filterDescribe = clArguments['filter-describe']\r\n    if (filterIt === true || filterIt === '') throw new Error('No substring specified for --filter-it')\r\n    if (filterDescribe === true || filterDescribe === '') {\r\n        throw new Error('No substring specified for --filter-describe')\r\n    }\r\n    const executionFilters = { it: filterIt, describe: filterDescribe }\r\n\r\n    const { applyConfigDefaults } = await import('./lib/applyConfigDefaults.js')\r\n    const config = applyConfigDefaults(userConfig)\r\n\r\n    const { validateConfig } = await import('./lib/validateConfig.js')\r\n    validateConfig(config)\r\n\r\n    const { doUserSetup } = await import('./lib/doUserSetup.js')\r\n    await doUserSetup(config)\r\n\r\n    // watch mode never reaches an end of its own, so teardown only gets a chance on the way\r\n    // out. Registered here so it pairs with the setup above and covers the initial run too.\r\n    const { doUserTeardown } = await import('./lib/doUserTeardown.js')\r\n    const { registerShutdownHandlers } = await import('./lib/shutdown.js')\r\n    registerShutdownHandlers(config, {\r\n        teardown: doUserTeardown,\r\n        exit: code => process.exit(code)\r\n    })\r\n\r\n    out(chalk.brightblue(findingTestsMessage(config)))\r\n    const { findTestFiles } = await import('./lib/findTestFiles.js')\r\n    const testFiles = await findTestFiles(config)\r\n    debug(testFiles)\r\n\r\n    // global store of the dependencies of tests\r\n    let dependencyTrees: DependencyTrees = {}\r\n    // store failing tests so we can re-run them.\r\n    const failingTests: string[] = []\r\n   \r\n    const reRunManager = makeReRunManager(\r\n        null,\r\n        makeRunManagerState({\r\n            allTestFiles: testFiles,\r\n            lastTestFiles: testFiles\r\n        }),\r\n    )\r\n\r\n    const { runTests } = await import('./lib/runTests.js')\r\n    let initialTestRun: Promise<boolean | null> | null = null\r\n\r\n    if (testFiles.size > 0) {\r\n        out(chalk.brightblue(foundTestsMessage(testFiles.size)))\r\n        const { buildDependencyTrees } = await import('./lib/buildDependencyTrees.js')\r\n        out(chalk.brightblue`finding initial dependency trees...`)\r\n        dependencyTrees = await buildDependencyTrees(config, testFiles)\r\n\r\n        if (config.watch.runAllOnStartup) {\r\n            out(chalk.brightblue`running initial tests...`)\r\n            initialTestRun = runTests(\r\n                config, testFiles, reRunManager,\r\n                (isTest) ? 'refresh' : 'cached',\r\n                undefined, executionFilters\r\n            ).then(async testsResult => {\r\n                const time = new Date().getTime() - startTime\r\n                //await new Promise((resolve) => setTimeout(resolve, 100))\r\n                out(chalk.grey`\\n${time.toLocaleString()}ms`)\r\n                return testsResult\r\n            })\r\n            reRunManager.state.currentRun = initialTestRun\r\n            // do we need to catch errors like this?\r\n            initialTestRun.catch(err => `Error during initial test run: ${err}`)\r\n        }\r\n    } else {\r\n        out(chalk.orange`no test files found`)\r\n    }\r\n\r\n    const { watchFilesAndRunTests } = await import('./lib/watchFilesAndRunTests.js')\r\n    await watchFilesAndRunTests(\r\n        config,\r\n        //testFiles,\r\n        dependencyTrees,\r\n        failingTests, // CHECK this should also be in state\r\n        reRunManager,\r\n        //watchRunState,\r\n        undefined,\r\n        executionFilters\r\n    )\r\n\r\n\r\n    out(chalk.brightblue`watching...`)\r\n\r\n    const { listenToUser } = await import('./lib/listenToUser.js')\r\n    listenToUser(\r\n        reRunManager,\r\n        files => () => {\r\n            return runTests(config, files, reRunManager, 'refresh', undefined, executionFilters)\r\n        },\r\n        config.watch.ttyActionsOnKeypress,\r\n        initialTestRun\r\n    ).catch(e => { throw e })\r\n\r\n\r\n    // park forever - watch mode ends by being signalled, and the shutdown handlers registered\r\n    // above run the user's teardown on the way out\r\n    await new Promise<void>(() => {})\r\n}\r\n"]}
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/cli/watch.ts"],"names":[],"mappings":"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","sourcesContent":["import chalk from '../packages/chalk.js'\n\nimport { packageName } from '../config.js'\nimport { out, debug } from '../output.js'\n\nimport type { AllowedArguments, DependencyTrees } from '../types.js'\nimport { setEnv } from './lib/setEnv.js'\nimport { findingTestsMessage } from './lib/findingTestsMessage.js'\nimport { foundTestsMessage } from './lib/foundTestsMessage.js'\nimport { isTest } from './lib/isTest.js'\nimport { makeRunManagerState } from './lib/makeWatchRunState.js'\nimport { makeReRunManager } from './lib/reRunManager.js'\n\nexport async function watch(): Promise<void> {\n    out(chalk.brightblue`[${packageName}]...`)\n\n    const startTime = new Date().getTime()\n\n    const { parseCommandLineArguments } = await import('./lib/parseCommandLineArguments.js')\n    const allowedClArguments: AllowedArguments = {\n        'config': {\n            flag: 'c',\n            hasValue: true\n        },\n        'test-files': {\n            flag: 't',\n            hasValue: true\n        },\n        'filter': {\n            flag: 'f',\n            hasValue: true\n        },\n        'filter-it': {\n            flag: 'i',\n            hasValue: true\n        },\n        'filter-describe': {\n            flag: 'd',\n            hasValue: true\n        },\n        'status-file': {\n            flag: 's',\n            hasValue: true\n        }\n    }\n    const clArguments = parseCommandLineArguments(allowedClArguments)\n    //debug('clArguments', clArguments)\n\n    setEnv()\n\n    const { loadConfig } = await import('./lib/loadConfig.js')\n    const userConfig = (typeof clArguments.config === 'string')\n        ? await loadConfig(clArguments.config)\n        : await loadConfig()\n\n    if ('test-files' in clArguments) {\n        const testFilesPattern = clArguments['test-files']\n        if (typeof testFilesPattern !== 'string' || testFilesPattern === '') {\n            throw new Error('No pattern specified for --test-files or -t argument')\n        }\n        userConfig.tests = testFilesPattern\n    }\n\n    if ('filter' in clArguments) {\n        const filter = clArguments.filter\n        if (typeof filter !== 'string' || filter === '') {\n            throw new Error('No pattern specified for --filter or -f argument')\n        }\n        userConfig.testsFilter = filter\n    }\n\n    if ('status-file' in clArguments) {\n        const statusFile = clArguments['status-file']\n        if (typeof statusFile !== 'string' || statusFile === '') {\n            throw new Error('No file path specified for --status-file or -s argument')\n        }\n        userConfig.watch = { ...userConfig.watch, statusFile }\n    }\n\n    const filterIt = clArguments['filter-it']\n    const filterDescribe = clArguments['filter-describe']\n    if (filterIt === true || filterIt === '') throw new Error('No substring specified for --filter-it')\n    if (filterDescribe === true || filterDescribe === '') {\n        throw new Error('No substring specified for --filter-describe')\n    }\n    const executionFilters = { it: filterIt, describe: filterDescribe }\n\n    const { applyConfigDefaults } = await import('./lib/applyConfigDefaults.js')\n    const config = applyConfigDefaults(userConfig)\n\n    const { validateConfig } = await import('./lib/validateConfig.js')\n    validateConfig(config)\n\n    // no run has finished yet, so the status file starts at -1 rather than stale\n    const { resetStatusFile, statusCodes, writeStatusFile } = await import('./lib/statusFile.js')\n    resetStatusFile(config)\n\n    const { doUserSetup } = await import('./lib/doUserSetup.js')\n    await doUserSetup(config)\n\n    // watch mode never reaches an end of its own, so teardown only gets a chance on the way\n    // out. Registered here so it pairs with the setup above and covers the initial run too.\n    const { doUserTeardown } = await import('./lib/doUserTeardown.js')\n    const { registerShutdownHandlers } = await import('./lib/shutdown.js')\n    registerShutdownHandlers(config, {\n        teardown: doUserTeardown,\n        exit: code => process.exit(code)\n    })\n\n    out(chalk.brightblue(findingTestsMessage(config)))\n    const { findTestFiles } = await import('./lib/findTestFiles.js')\n    const testFiles = await findTestFiles(config)\n    debug(testFiles)\n\n    // global store of the dependencies of tests\n    let dependencyTrees: DependencyTrees = {}\n    // store failing tests so we can re-run them.\n    const failingTests: string[] = []\n   \n    const reRunManager = makeReRunManager(\n        null,\n        makeRunManagerState({\n            allTestFiles: testFiles,\n            lastTestFiles: testFiles\n        }),\n    )\n\n    const { runTests } = await import('./lib/runTests.js')\n    let initialTestRun: Promise<boolean | null> | null = null\n\n    if (testFiles.size > 0) {\n        out(chalk.brightblue(foundTestsMessage(testFiles.size)))\n        const { buildDependencyTrees } = await import('./lib/buildDependencyTrees.js')\n        out(chalk.brightblue`finding initial dependency trees...`)\n        dependencyTrees = await buildDependencyTrees(config, testFiles)\n\n        if (config.watch.runAllOnStartup) {\n            out(chalk.brightblue`running initial tests...`)\n            initialTestRun = runTests(\n                config, testFiles, reRunManager,\n                (isTest) ? 'refresh' : 'cached',\n                undefined, executionFilters\n            ).then(async testsResult => {\n                const time = new Date().getTime() - startTime\n                //await new Promise((resolve) => setTimeout(resolve, 100))\n                out(chalk.grey`\\n${time.toLocaleString()}ms`)\n                return testsResult\n            })\n            reRunManager.state.currentRun = initialTestRun\n            // do we need to catch errors like this?\n            initialTestRun.catch(err => `Error during initial test run: ${err}`)\n        }\n    } else {\n        out(chalk.orange`no test files found`)\n        writeStatusFile(config, statusCodes.couldNotRun, 'no test files found')\n    }\n\n    const { watchFilesAndRunTests } = await import('./lib/watchFilesAndRunTests.js')\n    await watchFilesAndRunTests(\n        config,\n        //testFiles,\n        dependencyTrees,\n        failingTests, // CHECK this should also be in state\n        reRunManager,\n        //watchRunState,\n        undefined,\n        executionFilters\n    )\n\n\n    out(chalk.brightblue`watching...`)\n\n    const { listenToUser } = await import('./lib/listenToUser.js')\n    listenToUser(\n        reRunManager,\n        files => () => {\n            return runTests(config, files, reRunManager, 'refresh', undefined, executionFilters)\n        },\n        config.watch.ttyActionsOnKeypress,\n        initialTestRun\n    ).catch(e => { throw e })\n\n\n    // park forever - watch mode ends by being signalled, and the shutdown handlers registered\n    // above run the user's teardown on the way out\n    await new Promise<void>(() => {})\n}\n"]}

package/dist/config.d.ts

@@ -1,5 +1,5 @@
 export declare const packageName = "sxy-test-runner";
-export declare const cliName = "sxy-test";
+export declare const cliName = "sxyt";
 export declare const configFileNames: string[];
 export declare const configLocations: string[];
 export declare const debugging = false;

package/dist/config.js

@@ -1,5 +1,5 @@
 export const packageName = 'sxy-test-runner';
-export const cliName = 'sxy-test';
+export const cliName = 'sxyt';
 export const configFileNames = ['sxyt.config', 'sxy-test-runner.config'];
 export const configLocations = ['', 'config']; // locations where the configs may be placed in proj folder
 export const debugging = false;

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAA;AAE5C,MAAM,CAAC,MAAM,OAAO,GAAG,UAAU,CAAA;AAEjC,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,aAAa,EAAE,wBAAwB,CAAC,CAAA;AACxE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA,CAAC,2DAA2D;AAEzG,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAAA;AAE9B,6EAA6E;AAC7E,8EAA8E;AAC9E,wDAAwD;AACxD,SAAS,OAAO,CAAC,KAAyB;IACtC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IACrC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;IACzE,OAAO,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,GAAG,CAAA;AACtD,CAAC;AAED,sEAAsE;AACtE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAA","sourcesContent":["export const packageName = 'sxy-test-runner'\n\nexport const cliName = 'sxy-test'\n\nexport const configFileNames = ['sxyt.config', 'sxy-test-runner.config']\nexport const configLocations = ['', 'config'] // locations where the configs may be placed in proj folder\n\nexport const debugging = false\n\n// Parse a boolean-ish env var. Accepts true/false and 1/0, case-insensitive,\n// tolerant of surrounding quotes and whitespace (e.g. TIME_PROFILING=\"true\").\n// Anything unrecognised (or unset) is treated as false.\nfunction envFlag(value: string | undefined): boolean {\n    if (value === undefined) return false\n    const normalized = value.trim().replace(/^[\"']|[\"']$/g, '').toLowerCase()\n    return normalized === 'true' || normalized === '1'\n}\n\n// Toggle per-phase timing output with the SXYT_TIME_PROFILING env var\n// (SXYT_TIME_PROFILING=true | 1). Defaults to off so normal runs stay clean.\nexport const showTimeProfiling = envFlag(process.env.SXYT_TIME_PROFILING)\n"]}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAA;AAE5C,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAA;AAE7B,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,aAAa,EAAE,wBAAwB,CAAC,CAAA;AACxE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA,CAAC,2DAA2D;AAEzG,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAAA;AAE9B,6EAA6E;AAC7E,8EAA8E;AAC9E,wDAAwD;AACxD,SAAS,OAAO,CAAC,KAAyB;IACtC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IACrC,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;IACzE,OAAO,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,GAAG,CAAA;AACtD,CAAC;AAED,sEAAsE;AACtE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAA","sourcesContent":["export const packageName = 'sxy-test-runner'\n\nexport const cliName = 'sxyt'\n\nexport const configFileNames = ['sxyt.config', 'sxy-test-runner.config']\nexport const configLocations = ['', 'config'] // locations where the configs may be placed in proj folder\n\nexport const debugging = false\n\n// Parse a boolean-ish env var. Accepts true/false and 1/0, case-insensitive,\n// tolerant of surrounding quotes and whitespace (e.g. TIME_PROFILING=\"true\").\n// Anything unrecognised (or unset) is treated as false.\nfunction envFlag(value: string | undefined): boolean {\n    if (value === undefined) return false\n    const normalized = value.trim().replace(/^[\"']|[\"']$/g, '').toLowerCase()\n    return normalized === 'true' || normalized === '1'\n}\n\n// Toggle per-phase timing output with the SXYT_TIME_PROFILING env var\n// (SXYT_TIME_PROFILING=true | 1). Defaults to off so normal runs stay clean.\nexport const showTimeProfiling = envFlag(process.env.SXYT_TIME_PROFILING)\n"]}

package/dist/types.d.ts

@@ -7,6 +7,7 @@ export interface ExecutionConfig {
     describes: ExecutionMode;
     tests: ExecutionMode;
 }
+export type StatusFileConfig = string | false;
 export interface WatchConfig {
     watchFilesBase: string;
     watchFiles: GlobPattern;
@@ -14,6 +15,7 @@ export interface WatchConfig {
     runAllOnStartup: boolean;
     reRunFailingTests: boolean;
     ttyActionsOnKeypress: boolean;
+    statusFile: StatusFileConfig;
 }
 export type TaskExports = Record<string, unknown>;
 export type ConfigTaskFn = (parcel?: TaskExports) => TaskExports | void | Promise<TaskExports | void>;

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,2EAA2E;AAC3E,2EAA2E;AAC3E,+EAA+E","sourcesContent":["// Shared types for the test-run data model, user config, and CLI plumbing.\n// The config/result shapes are inferred from usage across the old awaitful\n// source (defaultConfig.js, validateConfig.js, init.js's template, and the\n// run*/parseDescribe/showTestResult modules) - there was no prior type source.\n\nimport { DescribeMeta } from './describe.js'\nimport { FileMeta } from './meta.js'\n\nexport type ExecutionMode = 'parallel' | 'sequential'\nexport type GlobPattern = string | string[]\n\nexport interface ExecutionConfig {\n    files: ExecutionMode\n    describes: ExecutionMode\n    tests: ExecutionMode\n}\n\nexport interface WatchConfig {\n    watchFilesBase: string\n    watchFiles: GlobPattern\n    watchFilesIgnore: GlobPattern\n    runAllOnStartup: boolean\n    reRunFailingTests: boolean\n    ttyActionsOnKeypress: boolean\n}\n\nexport type TaskExports = Record<string, unknown>\nexport type ConfigTaskFn = (parcel?: TaskExports) => TaskExports | void | Promise<TaskExports | void>\n// a task may also be a file path (relative to the project root) to dynamically import\nexport type ConfigTask = ConfigTaskFn | string\nexport type ConfigTasks = ConfigTask | ConfigTask[]\n\nexport interface FinalConfig {\n    testsBase: string\n    tests: GlobPattern\n    testsFilter?: string\n    testsIgnore: GlobPattern\n    setup?: ConfigTasks\n    beforeEachFile?: ConfigTasks\n    afterEachFile?: ConfigTasks\n    beforeEachDescribe?: ConfigTasks\n    afterEachDescribe?: ConfigTasks\n    beforeEachTest?: ConfigTasks\n    afterEachTest?: ConfigTasks\n    teardown?: ConfigTasks\n    showErrorTrace: boolean\n    compact: boolean\n    execution: ExecutionConfig\n    watch: WatchConfig\n}\n\nexport type UserConfig = Partial<Omit<FinalConfig, 'testsFilter' | 'execution' | 'watch'>> & {\n    execution?: Partial<ExecutionConfig>\n    watch?: Partial<WatchConfig>\n}\n\nexport type UserConfigInternal = UserConfig & Partial<Pick<FinalConfig, 'testsFilter'>>\n\n\n// -- test-run data model --------------------------------------------------\n\nexport type TestParcel = TaskExports\n\nexport interface DescribeParcel extends TaskExports {\n    it: (should: string, test: (parcel: TestParcel) => void | Promise<void>) => void\n    test: (should: string, test: (parcel: TestParcel) => void | Promise<void>) => void\n    afterDescribe: (func: () => void | Promise<void>) => void\n    beforeEachTest: (func: () => TaskExports | void | Promise<TaskExports | void>) => void\n    afterEachTest: (func: () => void | Promise<void>) => void\n}\n\nexport type DescribeCallback = (parcel: DescribeParcel) => void | Promise<void>\n\nexport interface Describe {\n    counter: number\n    thing: string\n    meta?: DescribeMeta\n    tests: DescribeCallback\n}\n\nexport interface It {\n    counter: number\n    should: string\n    test: (parcel: TestParcel) => void | Promise<void>\n}\n\nexport interface ParsedDescribe {\n    its: It[]\n    beforeDescribeExports: TaskExports\n    afterDescribeFunc?: () => void | Promise<void>\n    beforeEachTestFunc?: () => TaskExports | void | Promise<TaskExports | void>\n    afterEachTestFunc?: () => void | Promise<void>\n    error?: unknown\n}\n\nexport interface TestError extends Error {\n    actual?: unknown\n    expected?: unknown\n}\n\nexport interface ItResult {\n    counter: number\n    should: string\n    success: boolean | null\n    time: number\n    error?: TestError\n    logs: unknown[][]\n}\n\nexport interface ItResultsSummary {\n    total: number\n    passes: number\n}\n\nexport interface DescribeResult {\n    counter: number\n    thing: string\n    success: boolean | null\n    // total elapsed for the whole describe, filled in by runDescribe once it has finished\n    time: number\n    itResults: ItResult[]\n    itResultsSummary: ItResultsSummary\n    logs?: unknown[][]\n    error?: unknown\n}\n\nexport interface DescribeResultsSummary {\n    total: number\n    passes: number\n    invalid: number\n    itsTotal: number\n    itsPasses: number\n}\n\nexport interface TestFile {\n    file: string\n    describes?: Describe[]\n    meta?: FileMeta\n    error?: string | false\n    logs?: unknown[][]\n}\n\nexport interface TestResult {\n    file: string\n    success: boolean | null\n    describeResults: DescribeResult[]\n    describeResultsSummary: DescribeResultsSummary\n    logs: unknown[][]\n}\n\nexport interface TestsResultsSummary {\n    total: number\n    passes: number\n    invalid: number\n    describesTotal: number\n    describesPasses: number\n    describesInvalid: number\n    itsTotal: number\n    itsPasses: number\n}\n\nexport type DependencyTrees = Record<string, string[]>\n\nexport type OutFn = (...texts: unknown[]) => void\n\n\n\n// -- CLI argument parsing ---------------------------------------------------\n\nexport interface AllowedArgument {\n    flag?: string\n    hasValue: boolean\n}\n\nexport type AllowedArguments = Record<string, AllowedArgument>\nexport type AllowedFlags = Record<string, string>\nexport type ParsedArguments = Record<string, string | true>\n\nexport interface TestExecutionFilters {\n    describe?: string\n    it?: string\n}\n\n// -- globals ----------------------------------------------------------------\n\nexport interface SxyTestRunnerGlobal {\n    describes: Describe[]\n    describeCounter: number\n    fileMeta?: FileMeta\n}\ndeclare global {\n    // eslint-disable-next-line camelcase\n    var __sxy_test_runner__: SxyTestRunnerGlobal | undefined\n    // eslint-disable-next-line camelcase\n    var __sxyt_commandLineArguments: string[]\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,2EAA2E;AAC3E,2EAA2E;AAC3E,+EAA+E","sourcesContent":["// Shared types for the test-run data model, user config, and CLI plumbing.\n// The config/result shapes are inferred from usage across the old awaitful\n// source (defaultConfig.js, validateConfig.js, init.js's template, and the\n// run*/parseDescribe/showTestResult modules) - there was no prior type source.\n\nimport { DescribeMeta } from './describe.js'\nimport { FileMeta } from './meta.js'\n\nexport type ExecutionMode = 'parallel' | 'sequential'\nexport type GlobPattern = string | string[]\n\nexport interface ExecutionConfig {\n    files: ExecutionMode\n    describes: ExecutionMode\n    tests: ExecutionMode\n}\n\n// path to write the latest watch run status to, or false to write none\nexport type StatusFileConfig = string | false\n\nexport interface WatchConfig {\n    watchFilesBase: string\n    watchFiles: GlobPattern\n    watchFilesIgnore: GlobPattern\n    runAllOnStartup: boolean\n    reRunFailingTests: boolean\n    ttyActionsOnKeypress: boolean\n    statusFile: StatusFileConfig\n}\n\nexport type TaskExports = Record<string, unknown>\nexport type ConfigTaskFn = (parcel?: TaskExports) => TaskExports | void | Promise<TaskExports | void>\n// a task may also be a file path (relative to the project root) to dynamically import\nexport type ConfigTask = ConfigTaskFn | string\nexport type ConfigTasks = ConfigTask | ConfigTask[]\n\nexport interface FinalConfig {\n    testsBase: string\n    tests: GlobPattern\n    testsFilter?: string\n    testsIgnore: GlobPattern\n    setup?: ConfigTasks\n    beforeEachFile?: ConfigTasks\n    afterEachFile?: ConfigTasks\n    beforeEachDescribe?: ConfigTasks\n    afterEachDescribe?: ConfigTasks\n    beforeEachTest?: ConfigTasks\n    afterEachTest?: ConfigTasks\n    teardown?: ConfigTasks\n    showErrorTrace: boolean\n    compact: boolean\n    execution: ExecutionConfig\n    watch: WatchConfig\n}\n\nexport type UserConfig = Partial<Omit<FinalConfig, 'testsFilter' | 'execution' | 'watch'>> & {\n    execution?: Partial<ExecutionConfig>\n    watch?: Partial<WatchConfig>\n}\n\nexport type UserConfigInternal = UserConfig & Partial<Pick<FinalConfig, 'testsFilter'>>\n\n\n// -- test-run data model --------------------------------------------------\n\nexport type TestParcel = TaskExports\n\nexport interface DescribeParcel extends TaskExports {\n    it: (should: string, test: (parcel: TestParcel) => void | Promise<void>) => void\n    test: (should: string, test: (parcel: TestParcel) => void | Promise<void>) => void\n    afterDescribe: (func: () => void | Promise<void>) => void\n    beforeEachTest: (func: () => TaskExports | void | Promise<TaskExports | void>) => void\n    afterEachTest: (func: () => void | Promise<void>) => void\n}\n\nexport type DescribeCallback = (parcel: DescribeParcel) => void | Promise<void>\n\nexport interface Describe {\n    counter: number\n    thing: string\n    meta?: DescribeMeta\n    tests: DescribeCallback\n}\n\nexport interface It {\n    counter: number\n    should: string\n    test: (parcel: TestParcel) => void | Promise<void>\n}\n\nexport interface ParsedDescribe {\n    its: It[]\n    beforeDescribeExports: TaskExports\n    afterDescribeFunc?: () => void | Promise<void>\n    beforeEachTestFunc?: () => TaskExports | void | Promise<TaskExports | void>\n    afterEachTestFunc?: () => void | Promise<void>\n    error?: unknown\n}\n\nexport interface TestError extends Error {\n    actual?: unknown\n    expected?: unknown\n}\n\nexport interface ItResult {\n    counter: number\n    should: string\n    success: boolean | null\n    time: number\n    error?: TestError\n    logs: unknown[][]\n}\n\nexport interface ItResultsSummary {\n    total: number\n    passes: number\n}\n\nexport interface DescribeResult {\n    counter: number\n    thing: string\n    success: boolean | null\n    // total elapsed for the whole describe, filled in by runDescribe once it has finished\n    time: number\n    itResults: ItResult[]\n    itResultsSummary: ItResultsSummary\n    logs?: unknown[][]\n    error?: unknown\n}\n\nexport interface DescribeResultsSummary {\n    total: number\n    passes: number\n    invalid: number\n    itsTotal: number\n    itsPasses: number\n}\n\nexport interface TestFile {\n    file: string\n    describes?: Describe[]\n    meta?: FileMeta\n    error?: string | false\n    logs?: unknown[][]\n}\n\nexport interface TestResult {\n    file: string\n    success: boolean | null\n    describeResults: DescribeResult[]\n    describeResultsSummary: DescribeResultsSummary\n    logs: unknown[][]\n}\n\nexport interface TestsResultsSummary {\n    total: number\n    passes: number\n    invalid: number\n    describesTotal: number\n    describesPasses: number\n    describesInvalid: number\n    itsTotal: number\n    itsPasses: number\n}\n\nexport type DependencyTrees = Record<string, string[]>\n\nexport type OutFn = (...texts: unknown[]) => void\n\n\n\n// -- CLI argument parsing ---------------------------------------------------\n\nexport interface AllowedArgument {\n    flag?: string\n    hasValue: boolean\n}\n\nexport type AllowedArguments = Record<string, AllowedArgument>\nexport type AllowedFlags = Record<string, string>\nexport type ParsedArguments = Record<string, string | true>\n\nexport interface TestExecutionFilters {\n    describe?: string\n    it?: string\n}\n\n// -- globals ----------------------------------------------------------------\n\nexport interface SxyTestRunnerGlobal {\n    describes: Describe[]\n    describeCounter: number\n    fileMeta?: FileMeta\n}\ndeclare global {\n    // eslint-disable-next-line camelcase\n    var __sxy_test_runner__: SxyTestRunnerGlobal | undefined\n    // eslint-disable-next-line camelcase\n    var __sxyt_commandLineArguments: string[]\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sxy-test-runner",
-  "version": "2.3.19",
+  "version": "2.3.20",
   "license": "MIT",
   "homepage": "https://github.com/RobertSandiford/sxy-test-runner",
   "repository": {

package/readme.md

@@ -81,7 +81,7 @@ The other config options and fairly well explained in the config. More info on t
 ```
 npx sxy-test-runner
 ```
-*sxy-test is an alias for sxy-test-runner and can be used instead*
+*sxyt and sxy-test  are aliases for sxy-test-runner and can be used instead*
 
 ("npx" can be omitted in package.json scripts)
 
@@ -122,6 +122,52 @@ large set of files and filtering their describes or tests afterward can therefor
 slower than filtering files first. Prefer `--filter` when a file glob can select the work
 you need, and use the name filters for further narrowing within those files.
 
+To have watch mode record each run's result in a file, use `-s` or `--status-file`, or set
+`watch.statusFile` in the config. This is for anything watching the suite from outside - a
+script, a notifier, an agent - that would otherwise have to read the terminal:
+
+```
+npx sxy-test-runner --status-file .sxyt-status
+```
+
+The first line is a status code, a `-`, and a short description. The second is the time the
+run finished, then the summary, then any failures, and the run's duration last:
+
+```
+1 - 2 tests failed
+2026-08-03 20:14:52 +01:00
+Tests: 8/10
+Items: 4/5
+Test Files: 1/2
+Failures:
+  f: tests/users.test.js
+    d: creating a user
+      t: rejects a duplicate email
+        e: AssertionError: expected 409 to equal 200
+      t: sends a welcome email
+        e: Error: connect ECONNREFUSED 127.0.0.1:2525
+1,204ms
+```
+
+Failures nest as `f:` file, `d:` describe, `t:` test, `e:` error - one line each. Diffs, logs
+and stack traces stay in the terminal.
+
+| code | meaning |
+| --- | --- |
+| -1 | watch mode has started, but no run has finished |
+| 0 | everything passed |
+| 1 | tests ran and failed |
+| 2 | the run died partway - a test file would not load, or a describe threw |
+| 3 | nothing ran - no test files were found, or the filters matched nothing |
+
+Watch mode writes the `-1` status on startup, so a status left over from a previous session
+is never read as the current one. Each write goes to a temporary file and is renamed into
+place, so a poller only ever sees a complete status.
+
+Name the file `.sxys` and the VS Code extension in
+[`vscode-sxyt-status/`](vscode-sxyt-status) will colour it - green when the run passed, red
+where it did not.
+
 To specific an alternate config, use -c or --config
 ```
 npx sxy-test-runner --config sxy-test-runner.alternate.config.js