sxy-test-runner 2.4.3 → 2.4.5

package/dist/cli/once.js.map

@@ -1 +1 @@
-{"version":3,"file":"once.js","sourceRoot":"","sources":["../../src/cli/once.ts"],"names":[],"mappings":"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","sourcesContent":["\nimport chalk from '../packages/chalk.js'\n\nimport { packageName, configFileNames } from '../config.js'\nimport { out, log } from '../output.js'\n\nimport type { AllowedArguments } 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'\n\n\nexport async function once(): 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    }\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        //console.log('Looking for tests using pattern: ' + testFilesPattern) // eslint-disable-line no-console\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        //console.log('Filtering tests using pattern: ' + filter) // eslint-disable-line no-console\n        userConfig.testsFilter = filter\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\n    const { applyConfigDefaults } = await import('./lib/applyConfigDefaults.js')\n    const config = applyConfigDefaults(userConfig)\n    // agent reporting is a watch mode concern - `once` already ends with an exit code, so a\n    // config setting it must not leak in here\n    config.watch.agent = false\n\n    const { validateConfig } = await import('./lib/validateConfig.js')\n    validateConfig(config)\n\n    //console.log('run setup')\n    //console.log(util.inspect(config))\n    const { doUserSetup } = await import('./lib/doUserSetup.js')\n    await doUserSetup(config)\n    //console.log('ran setup')\n    \n    out(chalk.brightblue(findingTestsMessage(config)))\n    const { findTestFiles } = await import('./lib/findTestFiles.js')\n    const testFiles = await findTestFiles(config)\n\n    if (testFiles.size === 0) {\n        out(chalk.mediumred(`[${packageName}] Found no tests.`\n            + '\\nCreate tests matching the patterns, '\n            + `\\nor set new patterns in ${configFileNames.map(x => `${x}.js/cjs/mjs`).join(' or ')}`))\n\n        const endTime = new Date().getTime()\n        const time = endTime - startTime\n        out(chalk.brightblue(`[${packageName}] time: ${time.toLocaleString()}ms`))\n\n        // setup has already run by this point, so teardown must run too, or its side\n        // effects are left behind\n        const { doUserTeardown } = await import('./lib/doUserTeardown.js')\n        await doUserTeardown(config)\n\n        process.exit(4)\n    }\n\n    out(chalk.brightblue(foundTestsMessage(testFiles.size)))\n\n    // testFiles.size is guaranteed non-zero here - the no-tests case exited above\n    const { runTests } = await import('./lib/runTests.js')\n    log(chalk.brightblue`running tests...`)\n    const testsResult = await runTests(\n        config, testFiles,\n        undefined,\n        (isTest) ? 'refresh' : 'cached',\n        undefined,\n        {\n            it: filterIt,\n            describe: filterDescribe\n        }\n    )\n    // 5 - not 4 - so callers can tell \"no test files matched\" from \"filters matched nothing\"\n    const exitCode = testsResult === null ? 5 : testsResult ? 0 : 3\n\n    const time = new Date().getTime() - startTime\n    out(chalk.grey`\\n${time.toLocaleString()}ms\\n`)\n\n    const { doUserTeardown } = await import('./lib/doUserTeardown.js')\n    await doUserTeardown(config)\n\n    process.exit(exitCode)\n}\n"]}
+{"version":3,"file":"once.js","sourceRoot":"","sources":["../../src/cli/once.ts"],"names":[],"mappings":"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","sourcesContent":["\nimport chalk from '../packages/chalk.js'\n\nimport { packageName, configFileNames } from '../config.js'\nimport { out, log } from '../output.js'\n\nimport type { AllowedArguments, OutFn } 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 { exitCodes } from './lib/exitCodes.js'\n\n\nexport async function once(): Promise<void> {\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        'fail-fast': {\n            flag: 'x',\n            hasValue: false\n        },\n        'agent': {\n            hasValue: false\n        }\n    }\n    const clArguments = parseCommandLineArguments(allowedClArguments)\n    //debug('clArguments', clArguments)\n\n    // agent mode owns stdout: the usual per-test output is routed into a sink, leaving the\n    // failures and the summary. Announced before the config loads, as in watch mode.\n    const agentMode = clArguments.agent === true\n    const {\n        agentInit, agentFound, agentRunStart, agentDone, agentSetRunReason, agentSilentOut\n    } = await import('./lib/agentReport.js')\n    agentInit(agentMode)\n    agentSetRunReason('once')\n    const agentOut: OutFn = (agentMode) ? agentSilentOut : out\n    const runsOut = (agentMode) ? agentSilentOut : undefined\n\n    agentOut(chalk.brightblue`[${packageName}]...`)\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        //console.log('Looking for tests using pattern: ' + testFilesPattern) // eslint-disable-line no-console\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        //console.log('Filtering tests using pattern: ' + filter) // eslint-disable-line no-console\n        userConfig.testsFilter = filter\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\n    const { applyConfigDefaults } = await import('./lib/applyConfigDefaults.js')\n    const config = applyConfigDefaults(userConfig)\n    // both flags are the only source: assigned rather than or'd, so a config file cannot\n    // silently truncate every run, or swap the output format out from under a caller\n    config.failFast = clArguments['fail-fast'] === true\n    config.watch.agent = agentMode\n\n    const { validateConfig } = await import('./lib/validateConfig.js')\n    validateConfig(config)\n\n    //console.log('run setup')\n    //console.log(util.inspect(config))\n    const { doUserSetup } = await import('./lib/doUserSetup.js')\n    await doUserSetup(config)\n    //console.log('ran setup')\n    \n    agentOut(chalk.brightblue(findingTestsMessage(config)))\n    const { findTestFiles } = await import('./lib/findTestFiles.js')\n    const testFiles = await findTestFiles(config)\n    agentFound(config, testFiles.size)\n\n    if (testFiles.size === 0) {\n        agentOut(chalk.mediumred(`[${packageName}] Found no tests.`\n            + '\\nCreate tests matching the patterns, '\n            + `\\nor set new patterns in ${configFileNames.map(x => `${x}.js/cjs/mjs`).join(' or ')}`))\n\n        const endTime = new Date().getTime()\n        const time = endTime - startTime\n        agentOut(chalk.brightblue(`[${packageName}] time: ${time.toLocaleString()}ms`))\n\n        // reported as a run, so a reader waiting on a done line always gets one\n        const { statusCodes } = await import('./lib/statusFile.js')\n        const run = agentRunStart(config, 0)\n        agentDone(config, run, statusCodes.couldNotRun, 'no test files found', null, time, 0)\n\n        // setup has already run by this point, so teardown must run too, or its side\n        // effects are left behind\n        const { doUserTeardown } = await import('./lib/doUserTeardown.js')\n        await doUserTeardown(config)\n\n        process.exit(exitCodes.noTestFiles)\n    }\n\n    agentOut(chalk.brightblue(foundTestsMessage(testFiles.size)))\n\n    // testFiles.size is guaranteed non-zero here - the no-tests case exited above\n    const { runTests } = await import('./lib/runTests.js')\n    if (!agentMode) log(chalk.brightblue`running tests...`)\n    const testsResult = await runTests(\n        config, testFiles,\n        undefined,\n        (isTest) ? 'refresh' : 'cached',\n        runsOut,\n        {\n            it: filterIt,\n            describe: filterDescribe\n        }\n    )\n    // a distinct code from noTestFiles, so callers can tell \"no test file matched the\n    // pattern\" from \"the files matched but the filters selected nothing in them\"\n    const exitCode = (testsResult === null)\n        ? exitCodes.noMatchingTests\n        : (testsResult) ? exitCodes.passed : exitCodes.testErrors\n\n    const time = new Date().getTime() - startTime\n    agentOut(chalk.grey`\\n${time.toLocaleString()}ms\\n`)\n\n    const { doUserTeardown } = await import('./lib/doUserTeardown.js')\n    await doUserTeardown(config)\n\n    process.exit(exitCode)\n}\n"]}

package/dist/cli/version.d.ts

@@ -0,0 +1,2 @@
+export declare function version(): void;
+//# sourceMappingURL=version.d.ts.map

package/dist/cli/version.js

@@ -0,0 +1,23 @@
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { packageName } from '../config.js';
+import { out } from '../output.js';
+// Read at run time rather than baked in at build time, so it cannot drift from the version
+// actually installed. dist/cli/version.js sits two levels under the package root, both in
+// this repo and once published.
+export function version() {
+    const packageRoot = join(dirname(fileURLToPath(import.meta.url)), '..', '..');
+    let versionNumber = 'unknown';
+    try {
+        const raw = readFileSync(join(packageRoot, 'package.json'), 'utf8');
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const packageJson = JSON.parse(raw);
+        versionNumber = packageJson.version ?? 'unknown';
+    }
+    catch {
+        // reporting "unknown" beats failing to answer `--version` at all
+    }
+    out(`${packageName} ${versionNumber}`);
+}
+//# sourceMappingURL=version.js.map

package/dist/cli/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/cli/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAElC,2FAA2F;AAC3F,0FAA0F;AAC1F,gCAAgC;AAChC,MAAM,UAAU,OAAO;IACnB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IAE7E,IAAI,aAAa,GAAG,SAAS,CAAA;IAC7B,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAA;QACnE,mEAAmE;QACnE,MAAM,WAAW,GAAyB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACzD,aAAa,GAAG,WAAW,CAAC,OAAO,IAAI,SAAS,CAAA;IACpD,CAAC;IAAC,MAAM,CAAC;QACL,iEAAiE;IACrE,CAAC;IAED,GAAG,CAAC,GAAG,WAAW,IAAI,aAAa,EAAE,CAAC,CAAA;AAC1C,CAAC","sourcesContent":["import { readFileSync } from 'node:fs'\nimport { dirname, join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nimport { packageName } from '../config.js'\nimport { out } from '../output.js'\n\n// Read at run time rather than baked in at build time, so it cannot drift from the version\n// actually installed. dist/cli/version.js sits two levels under the package root, both in\n// this repo and once published.\nexport function version(): void {\n    const packageRoot = join(dirname(fileURLToPath(import.meta.url)), '..', '..')\n\n    let versionNumber = 'unknown'\n    try {\n        const raw = readFileSync(join(packageRoot, 'package.json'), 'utf8')\n        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment\n        const packageJson: { version?: string } = JSON.parse(raw)\n        versionNumber = packageJson.version ?? 'unknown'\n    } catch {\n        // reporting \"unknown\" beats failing to answer `--version` at all\n    }\n\n    out(`${packageName} ${versionNumber}`)\n}\n"]}

package/dist/cli/watch.js

@@ -88,6 +88,9 @@ export async function watch() {
     const config = applyConfigDefaults(userConfig);
     if (agentMode)
         config.watch.agent = true;
+    // there is no watch flag for it, and a config file must not enable it here: a truncated
+    // run would still report covers=all, and failing files would drop out of `failing`
+    config.failFast = false;
     // not silenced in agent mode - a config error is fatal, so losing the message is worse
     // than breaking the one-line-per-event contract
     const { validateConfig } = await import('./lib/validateConfig.js');

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'\n\nimport { packageName } from '../config.js'\nimport { out, debug } from '../output.js'\n\nimport type { AllowedArguments, DependencyTrees, OutFn } 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    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        'agent': {\n            hasValue: false\n        }\n    }\n    const clArguments = parseCommandLineArguments(allowedClArguments)\n    //debug('clArguments', clArguments)\n\n    // agent mode owns stdout, so the banner and every later message below is routed through\n    // agentOut - a sink when the flag is on. Announced before the config loads, so a reader\n    // sees the process is alive even if startup is slow.\n    const agentMode = clArguments.agent === true\n    const {\n        agentInit, agentFound, agentRunStart, agentDone, agentWatching, agentSilentOut\n    } = await import('./lib/agentReport.js')\n    agentInit(agentMode)\n    const agentOut: OutFn = (agentMode) ? agentSilentOut : out\n    const runsOut = (agentMode) ? agentSilentOut : undefined\n\n    agentOut(chalk.brightblue`[${packageName}]...`)\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    if (agentMode) config.watch.agent = true\n\n    // not silenced in agent mode - a config error is fatal, so losing the message is worse\n    // than breaking the one-line-per-event contract\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    agentOut(chalk.brightblue(findingTestsMessage(config)))\n    const { findTestFiles } = await import('./lib/findTestFiles.js')\n    const testFiles = await findTestFiles(config)\n    debug(testFiles)\n    agentFound(config, testFiles.size)\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        runsOut\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        agentOut(chalk.brightblue(foundTestsMessage(testFiles.size)))\n\n        // the trees are only consulted to narrow a run, so with evaluation off building them\n        // is pure cost - and it is the slowest part of startup on a large suite\n        if (config.watch.dependencyEvaluation) {\n            const { buildDependencyTrees } = await import('./lib/buildDependencyTrees.js')\n            agentOut(chalk.brightblue`finding initial dependency trees...`)\n            dependencyTrees = await buildDependencyTrees(config, testFiles)\n        }\n\n        if (config.watch.runAllOnStartup) {\n            agentOut(chalk.brightblue`running initial tests...`)\n            initialTestRun = runTests(\n                config, testFiles, reRunManager,\n                (isTest) ? 'refresh' : 'cached',\n                runsOut, executionFilters\n            ).then(async testsResult => {\n                const time = new Date().getTime() - startTime\n                //await new Promise((resolve) => setTimeout(resolve, 100))\n                agentOut(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        agentOut(chalk.orange`no test files found`)\n        writeStatusFile(config, statusCodes.couldNotRun, 'no test files found')\n        // still reported as a run, so a reader waiting on a done line always gets one\n        const run = agentRunStart(config, 0)\n        agentDone(\n            config, run, statusCodes.couldNotRun, 'no test files found',\n            null, new Date().getTime() - startTime, 0\n        )\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        runsOut,\n        executionFilters\n    )\n\n\n    agentOut(chalk.brightblue`watching...`)\n    agentWatching(config, testFiles.size)\n\n    const { listenToUser } = await import('./lib/listenToUser.js')\n    listenToUser(\n        reRunManager,\n        files => () => {\n            return runTests(config, files, reRunManager, 'refresh', runsOut, executionFilters)\n        },\n        config.watch.ttyActionsOnKeypress,\n        initialTestRun,\n        process.stdin,\n        runsOut\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"]}
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/cli/watch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,sBAAsB,CAAA;AAExC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC1C,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AAGzC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAA;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAExD,MAAM,CAAC,KAAK,UAAU,KAAK;IACvB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAA;IAEtC,MAAM,EAAE,yBAAyB,EAAE,GAAG,MAAM,MAAM,CAAC,oCAAoC,CAAC,CAAA;IACxF,MAAM,kBAAkB,GAAqB;QACzC,QAAQ,EAAE;YACN,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,IAAI;SACjB;QACD,YAAY,EAAE;YACV,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,IAAI;SACjB;QACD,QAAQ,EAAE;YACN,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,IAAI;SACjB;QACD,WAAW,EAAE;YACT,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,IAAI;SACjB;QACD,iBAAiB,EAAE;YACf,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,IAAI;SACjB;QACD,aAAa,EAAE;YACX,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,IAAI;SACjB;QACD,OAAO,EAAE;YACL,QAAQ,EAAE,KAAK;SAClB;KACJ,CAAA;IACD,MAAM,WAAW,GAAG,yBAAyB,CAAC,kBAAkB,CAAC,CAAA;IACjE,mCAAmC;IAEnC,wFAAwF;IACxF,wFAAwF;IACxF,qDAAqD;IACrD,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,KAAK,IAAI,CAAA;IAC5C,MAAM,EACF,SAAS,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EACjF,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAA;IACxC,SAAS,CAAC,SAAS,CAAC,CAAA;IACpB,MAAM,QAAQ,GAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,CAAA;IAC1D,MAAM,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAA;IAExD,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAA,IAAI,WAAW,MAAM,CAAC,CAAA;IAE/C,MAAM,EAAE,CAAA;IAER,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAA;IAC1D,MAAM,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,MAAM,KAAK,QAAQ,CAAC;QACvD,CAAC,CAAC,MAAM,UAAU,CAAC,WAAW,CAAC,MAAM,CAAC;QACtC,CAAC,CAAC,MAAM,UAAU,EAAE,CAAA;IAExB,IAAI,YAAY,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,gBAAgB,GAAG,WAAW,CAAC,YAAY,CAAC,CAAA;QAClD,IAAI,OAAO,gBAAgB,KAAK,QAAQ,IAAI,gBAAgB,KAAK,EAAE,EAAE,CAAC;YAClE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;QAC3E,CAAC;QACD,UAAU,CAAC,KAAK,GAAG,gBAAgB,CAAA;IACvC,CAAC;IAED,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAA;QACjC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;QACvE,CAAC;QACD,UAAU,CAAC,WAAW,GAAG,MAAM,CAAA;IACnC,CAAC;IAED,IAAI,aAAa,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,WAAW,CAAC,aAAa,CAAC,CAAA;QAC7C,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,EAAE,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAA;QAC9E,CAAC;QACD,UAAU,CAAC,KAAK,GAAG,EAAE,GAAG,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,CAAA;IAC1D,CAAC;IAED,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,CAAC,CAAA;IACzC,MAAM,cAAc,GAAG,WAAW,CAAC,iBAAiB,CAAC,CAAA;IACrD,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;IACnG,IAAI,cAAc,KAAK,IAAI,IAAI,cAAc,KAAK,EAAE,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;IACnE,CAAC;IACD,MAAM,gBAAgB,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAA;IAEnE,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAA;IAC5E,MAAM,MAAM,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAA;IAC9C,IAAI,SAAS;QAAE,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAA;IACxC,wFAAwF;IACxF,mFAAmF;IACnF,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAA;IAEvB,uFAAuF;IACvF,gDAAgD;IAChD,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAA;IAClE,cAAc,CAAC,MAAM,CAAC,CAAA;IAEtB,6EAA6E;IAC7E,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAA;IAC7F,eAAe,CAAC,MAAM,CAAC,CAAA;IAEvB,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAA;IAC5D,MAAM,WAAW,CAAC,MAAM,CAAC,CAAA;IAEzB,wFAAwF;IACxF,wFAAwF;IACxF,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAA;IAClE,MAAM,EAAE,wBAAwB,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAA;IACtE,wBAAwB,CAAC,MAAM,EAAE;QAC7B,QAAQ,EAAE,cAAc;QACxB,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;KACnC,CAAC,CAAA;IAEF,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IACvD,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAA;IAChE,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAA;IAC7C,KAAK,CAAC,SAAS,CAAC,CAAA;IAChB,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,CAAA;IAElC,4CAA4C;IAC5C,IAAI,eAAe,GAAoB,EAAE,CAAA;IACzC,6CAA6C;IAC7C,MAAM,YAAY,GAAa,EAAE,CAAA;IAEjC,MAAM,YAAY,GAAG,gBAAgB,CACjC,IAAI,EACJ,mBAAmB,CAAC;QAChB,YAAY,EAAE,SAAS;QACvB,aAAa,EAAE,SAAS;KAC3B,CAAC,EACF,OAAO,CACV,CAAA;IAED,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAA;IACtD,IAAI,cAAc,GAAmC,IAAI,CAAA;IAEzD,IAAI,SAAS,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACrB,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,iBAAiB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAE7D,qFAAqF;QACrF,wEAAwE;QACxE,IAAI,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,CAAC;YACpC,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAA;YAC9E,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAA,qCAAqC,CAAC,CAAA;YAC/D,eAAe,GAAG,MAAM,oBAAoB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;QACnE,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;YAC/B,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAA,0BAA0B,CAAC,CAAA;YACpD,cAAc,GAAG,QAAQ,CACrB,MAAM,EAAE,SAAS,EAAE,YAAY,EAC/B,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAC/B,OAAO,EAAE,gBAAgB,CAC5B,CAAC,IAAI,CAAC,KAAK,EAAC,WAAW,EAAC,EAAE;gBACvB,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,SAAS,CAAA;gBAC7C,0DAA0D;gBAC1D,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAA,KAAK,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,CAAA;gBAClD,OAAO,WAAW,CAAA;YACtB,CAAC,CAAC,CAAA;YACF,YAAY,CAAC,KAAK,CAAC,UAAU,GAAG,cAAc,CAAA;YAC9C,wCAAwC;YACxC,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,kCAAkC,GAAG,EAAE,CAAC,CAAA;QACxE,CAAC;IACL,CAAC;SAAM,CAAC;QACJ,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAA,qBAAqB,CAAC,CAAA;QAC3C,eAAe,CAAC,MAAM,EAAE,WAAW,CAAC,WAAW,EAAE,qBAAqB,CAAC,CAAA;QACvE,8EAA8E;QAC9E,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;QACpC,SAAS,CACL,MAAM,EAAE,GAAG,EAAE,WAAW,CAAC,WAAW,EAAE,qBAAqB,EAC3D,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,SAAS,EAAE,CAAC,CAC5C,CAAA;IACL,CAAC;IAED,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,MAAM,CAAC,gCAAgC,CAAC,CAAA;IAChF,MAAM,qBAAqB,CACvB,MAAM;IACN,YAAY;IACZ,eAAe,EACf,YAAY,EAAE,qCAAqC;IACnD,YAAY;IACZ,gBAAgB;IAChB,OAAO,EACP,gBAAgB,CACnB,CAAA;IAGD,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAA,aAAa,CAAC,CAAA;IACvC,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,CAAA;IAErC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAA;IAC9D,YAAY,CACR,YAAY,EACZ,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE;QACV,OAAO,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAA;IACtF,CAAC,EACD,MAAM,CAAC,KAAK,CAAC,oBAAoB,EACjC,cAAc,EACd,OAAO,CAAC,KAAK,EACb,OAAO,CACV,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,CAAA,CAAC,CAAC,CAAC,CAAA;IAGzB,0FAA0F;IAC1F,+CAA+C;IAC/C,MAAM,IAAI,OAAO,CAAO,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;AACrC,CAAC","sourcesContent":["import chalk from '../packages/chalk.js'\n\nimport { packageName } from '../config.js'\nimport { out, debug } from '../output.js'\n\nimport type { AllowedArguments, DependencyTrees, OutFn } 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    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        'agent': {\n            hasValue: false\n        }\n    }\n    const clArguments = parseCommandLineArguments(allowedClArguments)\n    //debug('clArguments', clArguments)\n\n    // agent mode owns stdout, so the banner and every later message below is routed through\n    // agentOut - a sink when the flag is on. Announced before the config loads, so a reader\n    // sees the process is alive even if startup is slow.\n    const agentMode = clArguments.agent === true\n    const {\n        agentInit, agentFound, agentRunStart, agentDone, agentWatching, agentSilentOut\n    } = await import('./lib/agentReport.js')\n    agentInit(agentMode)\n    const agentOut: OutFn = (agentMode) ? agentSilentOut : out\n    const runsOut = (agentMode) ? agentSilentOut : undefined\n\n    agentOut(chalk.brightblue`[${packageName}]...`)\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    if (agentMode) config.watch.agent = true\n    // there is no watch flag for it, and a config file must not enable it here: a truncated\n    // run would still report covers=all, and failing files would drop out of `failing`\n    config.failFast = false\n\n    // not silenced in agent mode - a config error is fatal, so losing the message is worse\n    // than breaking the one-line-per-event contract\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    agentOut(chalk.brightblue(findingTestsMessage(config)))\n    const { findTestFiles } = await import('./lib/findTestFiles.js')\n    const testFiles = await findTestFiles(config)\n    debug(testFiles)\n    agentFound(config, testFiles.size)\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        runsOut\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        agentOut(chalk.brightblue(foundTestsMessage(testFiles.size)))\n\n        // the trees are only consulted to narrow a run, so with evaluation off building them\n        // is pure cost - and it is the slowest part of startup on a large suite\n        if (config.watch.dependencyEvaluation) {\n            const { buildDependencyTrees } = await import('./lib/buildDependencyTrees.js')\n            agentOut(chalk.brightblue`finding initial dependency trees...`)\n            dependencyTrees = await buildDependencyTrees(config, testFiles)\n        }\n\n        if (config.watch.runAllOnStartup) {\n            agentOut(chalk.brightblue`running initial tests...`)\n            initialTestRun = runTests(\n                config, testFiles, reRunManager,\n                (isTest) ? 'refresh' : 'cached',\n                runsOut, executionFilters\n            ).then(async testsResult => {\n                const time = new Date().getTime() - startTime\n                //await new Promise((resolve) => setTimeout(resolve, 100))\n                agentOut(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        agentOut(chalk.orange`no test files found`)\n        writeStatusFile(config, statusCodes.couldNotRun, 'no test files found')\n        // still reported as a run, so a reader waiting on a done line always gets one\n        const run = agentRunStart(config, 0)\n        agentDone(\n            config, run, statusCodes.couldNotRun, 'no test files found',\n            null, new Date().getTime() - startTime, 0\n        )\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        runsOut,\n        executionFilters\n    )\n\n\n    agentOut(chalk.brightblue`watching...`)\n    agentWatching(config, testFiles.size)\n\n    const { listenToUser } = await import('./lib/listenToUser.js')\n    listenToUser(\n        reRunManager,\n        files => () => {\n            return runTests(config, files, reRunManager, 'refresh', runsOut, executionFilters)\n        },\n        config.watch.ttyActionsOnKeypress,\n        initialTestRun,\n        process.stdin,\n        runsOut\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/types.d.ts

@@ -38,14 +38,15 @@ export interface FinalConfig {
     teardown?: ConfigTasks;
     showErrorTrace: boolean;
     compact: boolean;
+    failFast: boolean;
     execution: ExecutionConfig;
     watch: WatchConfig;
 }
-export type UserConfig = Partial<Omit<FinalConfig, 'testsFilter' | 'execution' | 'watch'>> & {
+export type UserConfig = Partial<Omit<FinalConfig, 'testsFilter' | 'failFast' | 'execution' | 'watch'>> & {
     execution?: Partial<ExecutionConfig>;
     watch?: Partial<WatchConfig>;
 };
-export type UserConfigInternal = UserConfig & Partial<Pick<FinalConfig, 'testsFilter'>>;
+export type UserConfigInternal = UserConfig & Partial<Pick<FinalConfig, 'testsFilter' | 'failFast'>>;
 export type TestParcel = TaskExports;
 export interface DescribeParcel extends TaskExports {
     it: (should: string, test: (parcel: TestParcel) => void | Promise<void>) => 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\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    // map a changed file to the tests that import it. Off, any watched change runs everything\n    dependencyEvaluation: boolean\n    ttyActionsOnKeypress: boolean\n    statusFile: StatusFileConfig\n    // report the session as single agent readable lines instead of the usual output\n    agent: 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    // map a changed file to the tests that import it. Off, any watched change runs everything\n    dependencyEvaluation: boolean\n    ttyActionsOnKeypress: boolean\n    statusFile: StatusFileConfig\n    // report the session as single agent readable lines instead of the usual output\n    agent: 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    // stop the run at the first failing test, erroring describe or unloadable test file.\n    // Set by `once --fail-fast` only: it describes one invocation, not a project, and in\n    // watch mode it would silently truncate runs that report themselves as covering\n    // everything\n    failFast: boolean\n    execution: ExecutionConfig\n    watch: WatchConfig\n}\n\nexport type UserConfig = Partial<\n    Omit<FinalConfig, 'testsFilter' | 'failFast' | 'execution' | 'watch'>\n> & {\n    execution?: Partial<ExecutionConfig>\n    watch?: Partial<WatchConfig>\n}\n\nexport type UserConfigInternal = UserConfig\n    & Partial<Pick<FinalConfig, 'testsFilter' | 'failFast'>>\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.4.3",
+  "version": "2.4.5",
   "license": "MIT",
   "homepage": "https://github.com/RobertSandiford/sxy-test-runner",
   "repository": {
@@ -77,8 +77,10 @@
     "dev-mon": "cross-env NODE_OPTIONS=\"--experimental-specifier-resolution=node\" nodemon --experimental-specifier-resolution=node --watch dist/cli --watch dist/cli/lib --watch sxy-test-runner.config.js --watch sxy-loader.config.js dist/cli/index.js",
     "dev-mon-input": "cross-env NODE_OPTIONS=\"--experimental-specifier-resolution=node\" nodemon --no-stdin --experimental-specifier-resolution=node --watch dist/cli --watch dist/cli/lib --watch sxy-test-runner.config.js --watch sxy-loader.config.js dist/cli/index.js",
     "dev": "cross-env NODE_OPTIONS=\"--experimental-specifier-resolution=node\" node --experimental-specifier-resolution=node dist/cli/index.js",
+    "dev-agent": "cross-env NODE_OPTIONS=\"--experimental-specifier-resolution=node\" node --experimental-specifier-resolution=node dist/cli/index.js --agent",
     "dev-seq-f": "cross-env NODE_OPTIONS=\"--experimental-specifier-resolution=node\" node --experimental-specifier-resolution=node dist/cli/index.js --config sxy-test-runner.seq-f.config.js",
     "dev-once": "nodemon --experimental-specifier-resolution=node --watch dist/cli --watch sxy-test-runner.config.js --watch sxy-loader.config.js dist/cli/index.js once",
+    "dev-once-agent": "nodemon --experimental-specifier-resolution=node --watch dist/cli --watch sxy-test-runner.config.js --watch sxy-loader.config.js dist/cli/index.js once --agent",
     "dev-help": "cross-env NODE_OPTIONS=\"--experimental-specifier-resolution=node\" nodemon --experimental-specifier-resolution=node --watch dist/cli --watch dist/cli/lib --watch sxy-test-runner.config.js --watch sxy-loader.config.js dist/cli/index.js help",
     "dev-coverage": "TODO",
     "start": "cross-env NODE_OPTIONS=\"--experimental-specifier-resolution=node\" node --experimental-specifier-resolution=node dist/cli/index.js",

package/readme.md

@@ -173,6 +173,59 @@ To specific an alternate config, use -c or --config
 npx sxy-test-runner --config sxy-test-runner.alternate.config.js
 ```
 
+## Reporting for an agent
+
+`--agent` replaces the usual output with one line per event, for something reading the
+process's stdout rather than a terminal. It works in both modes. In `once` it leaves only
+the failures and the summary - passing tests are not listed - and the exit code is
+unchanged, so the run stays usable in CI:
+
+```
+npx sxy-test-runner once --agent
+```
+
+```
+[sxyt] init | pid=16744
+[sxyt] found | files=2
+[sxyt] running | n=1 | files=2 | why=once | covers=all
+[sxyt] fail | n=1 | file=tests/users.test.js | describe=creating a user | test=rejects a duplicate email | error=AssertionError: expected 409 to equal 200
+[sxyt] done | n=1 | code=1 | desc=1 test failed | tests=2/3 | items=1/2 | files=1/2 | failing=1 | ms=150
+```
+
+Every line is one complete event: `[sxyt] <event>` followed by ` | <key>=<value>` pairs.
+Newlines in free text are collapsed and any `|` becomes `/`, so one event never spans two
+lines. In watch mode the stream continues with `change`, further `run`/`done` pairs, and a
+`watching` line once the watcher is live.
+
+`failing` counts the test files still known to be failing across the whole session, and
+`covers` says what the run was built from, so a partial re-run cannot be mistaken for a
+clean suite. `code` is the status code from the table above, not the process exit code.
+
+## Stopping at the first failure
+
+`-x` or `--fail-fast` stops a `once` run at the first failing test, erroring describe, or
+test file that will not load. The failure is reported in full and nothing further starts;
+`afterEach*` hooks and `teardown` still run:
+
+```
+npx sxy-test-runner once --fail-fast
+```
+
+The tallies then count only what ran, so the summary ends with `stopped at the first
+failure (failFast)`. There is no watch equivalent, and no config option - it describes a
+single run rather than a project.
+
+## Unrecognised options
+
+`--help` (`-h`) and `--version` (`-v`) work on any command and take over from it, so
+`once --help` describes `once` rather than running the suite.
+
+An option that the command does not accept is an error: the command exits without running
+anything, rather than warning and carrying on. A typo like `--fitler-it` would otherwise
+quietly run the whole suite and report a pass. Options are per-command, so `--fail-fast`
+belongs to `once` and `--status-file` to `watch`. Run `npx sxy-test-runner help`, or add
+`--help` to any command, for the current list.
+
 # How it works
 
 sxy-test-runner runs all tests inside one node process, to improve performance (this framework far exceeds mocha in parallel mode, which is needed to test ESM files, due to this).
@@ -215,7 +268,11 @@ If your code is isolated, and asyncronous, you can use parallel exeecution modes
 
 Module dependencies are identified using dependency-tree. Dynamic imports will not be detected and will not trigger test re-runs.
 
-No option to re-run all tests on changes is currently available - I may add this on request, or submit a PR if you want this.
+To re-run every test on any watched change instead, set `config.watch.dependencyEvaluation`
+to `false`. The dependency analysis is then skipped entirely - no trees are built at startup,
+which is the slowest part of it on a large suite - and the blind spot above stops mattering,
+because nothing is being predicted. On a small or fast suite this is often the better
+setting; on a large one it trades a slower re-run for a complete one.
 
 ## Failing test re-running
 
@@ -293,8 +350,18 @@ describe('something', ({it, beforeEachTest, afterEachTest, afterDescribe}) => {
 
 # Exit codes for `once`
 
-0: success
-1: non sxyt error
-2: sxyt error
-3: test errors
-It may also crash due to exceptions without giving any of these errors codes
+```
+0:  success
+20: test errors - a failed assertion, a test file that would not load,
+    or a describe that threw
+21: no test file matched the `tests` pattern
+22: test files matched, but --filter-it/--filter-describe selected nothing
+23: an option was not recognised, or one needing a value was given none
+24: reserved for an error in sxy-test itself - not currently emitted
+```
+
+These start at 20 to stay clear of Node's reserved codes (1-14) and of signal exits
+(over 128), so a non-zero code is always sxy-test's own.
+
+It may also crash due to exceptions without giving any of these codes, in which case Node
+supplies the code - usually `1` for an uncaught exception.