sxy-test-runner 2.3.20 → 2.3.22

package/dist/cli/watch.js

@@ -8,7 +8,6 @@ import { isTest } from './lib/isTest.js';
 import { makeRunManagerState } from './lib/makeWatchRunState.js';
 import { makeReRunManager } from './lib/reRunManager.js';
 export async function watch() {
-    out(chalk.brightblue `[${packageName}]...`);
     const startTime = new Date().getTime();
     const { parseCommandLineArguments } = await import('./lib/parseCommandLineArguments.js');
     const allowedClArguments = {
@@ -35,10 +34,22 @@ export async function watch() {
         'status-file': {
             flag: 's',
             hasValue: true
+        },
+        'agent': {
+            hasValue: false
         }
     };
     const clArguments = parseCommandLineArguments(allowedClArguments);
     //debug('clArguments', clArguments)
+    // agent mode owns stdout, so the banner and every later message below is routed through
+    // agentOut - a sink when the flag is on. Announced before the config loads, so a reader
+    // sees the process is alive even if startup is slow.
+    const agentMode = clArguments.agent === true;
+    const { agentInit, agentFound, agentRunStart, agentDone, agentWatching, agentSilentOut } = await import('./lib/agentReport.js');
+    agentInit(agentMode);
+    const agentOut = (agentMode) ? agentSilentOut : out;
+    const runsOut = (agentMode) ? agentSilentOut : undefined;
+    agentOut(chalk.brightblue `[${packageName}]...`);
     setEnv();
     const { loadConfig } = await import('./lib/loadConfig.js');
     const userConfig = (typeof clArguments.config === 'string')
@@ -75,6 +86,10 @@ export async function watch() {
     const executionFilters = { it: filterIt, describe: filterDescribe };
     const { applyConfigDefaults } = await import('./lib/applyConfigDefaults.js');
     const config = applyConfigDefaults(userConfig);
+    if (agentMode)
+        config.watch.agent = true;
+    // 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');
     validateConfig(config);
     // no run has finished yet, so the status file starts at -1 rather than stale
@@ -90,10 +105,11 @@ export async function watch() {
         teardown: doUserTeardown,
         exit: code => process.exit(code)
     });
-    out(chalk.brightblue(findingTestsMessage(config)));
+    agentOut(chalk.brightblue(findingTestsMessage(config)));
     const { findTestFiles } = await import('./lib/findTestFiles.js');
     const testFiles = await findTestFiles(config);
     debug(testFiles);
+    agentFound(config, testFiles.size);
     // global store of the dependencies of tests
     let dependencyTrees = {};
     // store failing tests so we can re-run them.
@@ -101,20 +117,20 @@ export async function watch() {
     const reRunManager = makeReRunManager(null, makeRunManagerState({
         allTestFiles: testFiles,
         lastTestFiles: testFiles
-    }));
+    }), runsOut);
     const { runTests } = await import('./lib/runTests.js');
     let initialTestRun = null;
     if (testFiles.size > 0) {
-        out(chalk.brightblue(foundTestsMessage(testFiles.size)));
+        agentOut(chalk.brightblue(foundTestsMessage(testFiles.size)));
         const { buildDependencyTrees } = await import('./lib/buildDependencyTrees.js');
-        out(chalk.brightblue `finding initial dependency trees...`);
+        agentOut(chalk.brightblue `finding initial dependency trees...`);
         dependencyTrees = await buildDependencyTrees(config, testFiles);
         if (config.watch.runAllOnStartup) {
-            out(chalk.brightblue `running initial tests...`);
-            initialTestRun = runTests(config, testFiles, reRunManager, (isTest) ? 'refresh' : 'cached', undefined, executionFilters).then(async (testsResult) => {
+            agentOut(chalk.brightblue `running initial tests...`);
+            initialTestRun = runTests(config, testFiles, reRunManager, (isTest) ? 'refresh' : 'cached', runsOut, executionFilters).then(async (testsResult) => {
                 const time = new Date().getTime() - startTime;
                 //await new Promise((resolve) => setTimeout(resolve, 100))
-                out(chalk.grey `\n${time.toLocaleString()}ms`);
+                agentOut(chalk.grey `\n${time.toLocaleString()}ms`);
                 return testsResult;
             });
             reRunManager.state.currentRun = initialTestRun;
@@ -123,8 +139,11 @@ export async function watch() {
         }
     }
     else {
-        out(chalk.orange `no test files found`);
+        agentOut(chalk.orange `no test files found`);
         writeStatusFile(config, statusCodes.couldNotRun, 'no test files found');
+        // still reported as a run, so a reader waiting on a done line always gets one
+        const run = agentRunStart(config, 0);
+        agentDone(config, run, statusCodes.couldNotRun, 'no test files found', null, new Date().getTime() - startTime, 0);
     }
     const { watchFilesAndRunTests } = await import('./lib/watchFilesAndRunTests.js');
     await watchFilesAndRunTests(config, 
@@ -132,12 +151,13 @@ export async function watch() {
     dependencyTrees, failingTests, // CHECK this should also be in state
     reRunManager, 
     //watchRunState,
-    undefined, executionFilters);
-    out(chalk.brightblue `watching...`);
+    runsOut, executionFilters);
+    agentOut(chalk.brightblue `watching...`);
+    agentWatching(config, testFiles.size);
     const { listenToUser } = await import('./lib/listenToUser.js');
     listenToUser(reRunManager, files => () => {
-        return runTests(config, files, reRunManager, 'refresh', undefined, executionFilters);
-    }, config.watch.ttyActionsOnKeypress, initialTestRun).catch(e => { throw e; });
+        return runTests(config, files, reRunManager, 'refresh', runsOut, executionFilters);
+    }, config.watch.ttyActionsOnKeypress, initialTestRun, process.stdin, runsOut).catch(e => { throw e; });
     // park forever - watch mode ends by being signalled, and the shutdown handlers registered
     // above run the user's teardown on the way out
     await new Promise(() => { });

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 } 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"]}
+{"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        const { buildDependencyTrees } = await import('./lib/buildDependencyTrees.js')\n        agentOut(chalk.brightblue`finding initial dependency trees...`)\n        dependencyTrees = await buildDependencyTrees(config, testFiles)\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

@@ -16,6 +16,7 @@ export interface WatchConfig {
     reRunFailingTests: boolean;
     ttyActionsOnKeypress: boolean;
     statusFile: StatusFileConfig;
+    agent: boolean;
 }
 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\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"]}
+{"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    // 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"]}

package/package.json

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