sxy-test-runner 2.3.17 → 2.3.19

package/dist/cli/lib/loadTestFile.js

@@ -37,6 +37,7 @@ export async function loadTestFile(config, testFile, refresh = 'refresh') {
                     await import(testFileFullUrl);
                 }
                 test.describes = global.__sxy_test_runner__?.describes ?? [];
+                test.meta = global.__sxy_test_runner__?.fileMeta;
                 test.error = false;
             }
             catch (e) {

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

@@ -1 +1 @@
-{"version":3,"file":"loadTestFile.js","sourceRoot":"","sources":["../../../src/cli/lib/loadTestFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,KAAK,MAAM,yBAAyB,CAAA;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,6BAA6B,CAAA,CAAC,wCAAwC;AAE7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAGjD,MAAM,EAAE,gBAAgB,EAAE,GAAG,kBAAkB,CAAC,iBAAiB,CAAC,CAAA;AAElE,IAAI,OAAO,GAA6B,IAAI,CAAA;AAE5C,IAAI,eAAe,GAAG,CAAC,CAAA;AACvB,SAAS,WAAW,CAAC,MAAc;IAC/B,OAAO,MAAM,CAAC,MAAM,GAAG,kBAAkB,eAAe,EAAE,EAAE,CAAC,CAAA;AACjE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,MAAmB,EACnB,QAAgB,EAChB,UAAgC,SAAS;IAEzC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACnB,KAAK,CAAC,KAAK,CAAC,MAAM,CAAA,mEAAmE,CAAC,CAAA;QACtF,MAAM,OAAO,CAAA;QACb,KAAK,CAAC,KAAK,CAAC,MAAM,CAAA,iDAAiD,CAAC,CAAA;IACxE,CAAC;IAED,MAAM,WAAW,GAAG,gBAAgB,CAAC,aAAa,QAAQ,EAAE,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;QAEhC,qCAAqC;QACrC,MAAM,CAAC,mBAAmB,GAAG;YACzB,SAAS,EAAE,EAAE;YACb,eAAe,EAAE,CAAC;SACrB,CAAA;QAED,MAAM,eAAe,GAAG,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;QAE9D,MAAM,IAAI,GAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;QAEzC,+BAA+B;QAC/B,MAAM,IAAI,GAAgB,EAAE,CAAA;QAC5B,MAAM,WAAW,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YAC/B,IAAI,CAAC;gBACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBACxB,MAAM,WAAW,CAAC,eAAe,CAAC,CAAA;gBACtC,CAAC;qBAAM,CAAC;oBACJ,MAAM,MAAM,CAAC,eAAe,CAAC,CAAA;gBACjC,CAAC;gBACD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,mBAAmB,EAAE,SAAS,IAAI,EAAE,CAAA;gBAC5D,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;YACtB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACT,IAAI,CAAC,KAAK,GAAG,uBAAuB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;YACnD,CAAC;QACL,CAAC,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI;QAEJ,OAAO,IAAI,CAAA;IACf,CAAC,CAAC,CAAA;IAEF,OAAO,GAAG,WAAW,CAAA;IAErB,OAAO,MAAM,WAAW,CAAA;AAC5B,CAAC","sourcesContent":["import { join } from 'path'\nimport chalk from '../../packages/chalk.js'\nimport { createTimeProfiler } from '../../packages/timeProfiler.js'\nimport '../../packages/esmReload.js' // registers the test module reload hook\n\nimport { showTimeProfiling } from '../../config.js'\nimport { debug } from '../../output.js'\nimport { captureLogs } from './consoleCapture.js'\nimport type { FinalConfig, TestFile } from '../../types.js'\n\nconst { timeProfileAsync } = createTimeProfiler(showTimeProfiling)\n\nlet loading: Promise<TestFile> | null = null\n\nlet importIteration = 1\nfunction importFresh(target: string): Promise<unknown> {\n    return import(target + `?sxyt-instance=${importIteration++}`)\n}\n\nexport async function loadTestFile(\n    config: FinalConfig,\n    testFile: string,\n    refresh: 'refresh' | 'cached' = 'refresh'\n): Promise<TestFile> {\n    if (loading !== null) {\n        debug(chalk.yellow`loadTestFile - another file is loading - waiting for it to finish`)\n        await loading\n        debug(chalk.yellow`previous file complete - will now load the file`)\n    }\n\n    const loadPromise = timeProfileAsync(`load test ${testFile}`, async () => {\n        const projectDir = process.cwd()\n\n        // eslint-disable-next-line camelcase\n        global.__sxy_test_runner__ = {\n            describes: [],\n            describeCounter: 1\n        }\n\n        const testFileFullUrl = 'file://' + join(projectDir, testFile)\n\n        const test: TestFile = { file: testFile }\n\n        //// capture console.log output\n        const logs: unknown[][] = []\n        await captureLogs(logs, async () => {\n            try {\n                if (refresh === 'refresh') {\n                    await importFresh(testFileFullUrl)\n                } else {\n                    await import(testFileFullUrl)\n                }\n                test.describes = global.__sxy_test_runner__?.describes ?? []\n                test.error = false\n            } catch (e) {\n                test.error = `Error loading file\\n${String(e)}`\n            }\n        })\n        test.logs = logs\n        ////\n\n        return test\n    })\n\n    loading = loadPromise\n\n    return await loadPromise\n}\n"]}
+{"version":3,"file":"loadTestFile.js","sourceRoot":"","sources":["../../../src/cli/lib/loadTestFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,KAAK,MAAM,yBAAyB,CAAA;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,6BAA6B,CAAA,CAAC,wCAAwC;AAE7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAGjD,MAAM,EAAE,gBAAgB,EAAE,GAAG,kBAAkB,CAAC,iBAAiB,CAAC,CAAA;AAElE,IAAI,OAAO,GAA6B,IAAI,CAAA;AAE5C,IAAI,eAAe,GAAG,CAAC,CAAA;AACvB,SAAS,WAAW,CAAC,MAAc;IAC/B,OAAO,MAAM,CAAC,MAAM,GAAG,kBAAkB,eAAe,EAAE,EAAE,CAAC,CAAA;AACjE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAC9B,MAAmB,EACnB,QAAgB,EAChB,UAAgC,SAAS;IAEzC,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACnB,KAAK,CAAC,KAAK,CAAC,MAAM,CAAA,mEAAmE,CAAC,CAAA;QACtF,MAAM,OAAO,CAAA;QACb,KAAK,CAAC,KAAK,CAAC,MAAM,CAAA,iDAAiD,CAAC,CAAA;IACxE,CAAC;IAED,MAAM,WAAW,GAAG,gBAAgB,CAAC,aAAa,QAAQ,EAAE,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAA;QAEhC,qCAAqC;QACrC,MAAM,CAAC,mBAAmB,GAAG;YACzB,SAAS,EAAE,EAAE;YACb,eAAe,EAAE,CAAC;SACrB,CAAA;QAED,MAAM,eAAe,GAAG,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;QAE9D,MAAM,IAAI,GAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;QAEzC,+BAA+B;QAC/B,MAAM,IAAI,GAAgB,EAAE,CAAA;QAC5B,MAAM,WAAW,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YAC/B,IAAI,CAAC;gBACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBACxB,MAAM,WAAW,CAAC,eAAe,CAAC,CAAA;gBACtC,CAAC;qBAAM,CAAC;oBACJ,MAAM,MAAM,CAAC,eAAe,CAAC,CAAA;gBACjC,CAAC;gBACD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,mBAAmB,EAAE,SAAS,IAAI,EAAE,CAAA;gBAC5D,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,mBAAmB,EAAE,QAAQ,CAAA;gBAChD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;YACtB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACT,IAAI,CAAC,KAAK,GAAG,uBAAuB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;YACnD,CAAC;QACL,CAAC,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI;QAEJ,OAAO,IAAI,CAAA;IACf,CAAC,CAAC,CAAA;IAEF,OAAO,GAAG,WAAW,CAAA;IAErB,OAAO,MAAM,WAAW,CAAA;AAC5B,CAAC","sourcesContent":["import { join } from 'path'\nimport chalk from '../../packages/chalk.js'\nimport { createTimeProfiler } from '../../packages/timeProfiler.js'\nimport '../../packages/esmReload.js' // registers the test module reload hook\n\nimport { showTimeProfiling } from '../../config.js'\nimport { debug } from '../../output.js'\nimport { captureLogs } from './consoleCapture.js'\nimport type { FinalConfig, TestFile } from '../../types.js'\n\nconst { timeProfileAsync } = createTimeProfiler(showTimeProfiling)\n\nlet loading: Promise<TestFile> | null = null\n\nlet importIteration = 1\nfunction importFresh(target: string): Promise<unknown> {\n    return import(target + `?sxyt-instance=${importIteration++}`)\n}\n\nexport async function loadTestFile(\n    config: FinalConfig,\n    testFile: string,\n    refresh: 'refresh' | 'cached' = 'refresh'\n): Promise<TestFile> {\n    if (loading !== null) {\n        debug(chalk.yellow`loadTestFile - another file is loading - waiting for it to finish`)\n        await loading\n        debug(chalk.yellow`previous file complete - will now load the file`)\n    }\n\n    const loadPromise = timeProfileAsync(`load test ${testFile}`, async () => {\n        const projectDir = process.cwd()\n\n        // eslint-disable-next-line camelcase\n        global.__sxy_test_runner__ = {\n            describes: [],\n            describeCounter: 1\n        }\n\n        const testFileFullUrl = 'file://' + join(projectDir, testFile)\n\n        const test: TestFile = { file: testFile }\n\n        //// capture console.log output\n        const logs: unknown[][] = []\n        await captureLogs(logs, async () => {\n            try {\n                if (refresh === 'refresh') {\n                    await importFresh(testFileFullUrl)\n                } else {\n                    await import(testFileFullUrl)\n                }\n                test.describes = global.__sxy_test_runner__?.describes ?? []\n                test.meta = global.__sxy_test_runner__?.fileMeta\n                test.error = false\n            } catch (e) {\n                test.error = `Error loading file\\n${String(e)}`\n            }\n        })\n        test.logs = logs\n        ////\n\n        return test\n    })\n\n    loading = loadPromise\n\n    return await loadPromise\n}\n"]}

package/dist/cli/lib/runDescribeRun.js

@@ -5,10 +5,18 @@ import { runIt } from './runIt.js';
 export function runDescribeRun(config, describe, parsedIts) {
     return timeProfileAsync(`run describe, run its ${describe.thing}`, async () => {
         const { its, beforeDescribeExports, afterDescribeFunc, beforeEachTestFunc, afterEachTestFunc } = parsedIts;
-        const itResults = [];
+        const parallelOverride = describe.meta === undefined
+            ? undefined
+            : 'parallelTests' in describe.meta ? describe.meta.parallelTests : !describe.meta.sequentialTests;
+        const isParallel = parallelOverride ?? config.execution.tests === 'parallel';
+        const itPromises = [];
         for (const it of its) {
-            itResults.push(await runIt(config, it, beforeEachTestFunc, afterEachTestFunc));
+            const itPromise = runIt(config, it, beforeEachTestFunc, afterEachTestFunc);
+            itPromises.push(itPromise);
+            if (!isParallel)
+                await itPromise;
         }
+        const itResults = await Promise.all(itPromises);
         const itResultsSummary = {
             total: 0,
             passes: 0

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

@@ -1 +1 @@
-{"version":3,"file":"runDescribeRun.js","sourceRoot":"","sources":["../../../src/cli/lib/runDescribeRun.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAMlC,MAAM,UAAU,cAAc,CAAC,MAAmB,EAAE,QAAkB,EAAE,SAAyB;IAE7F,OAAO,gBAAgB,CAAC,yBAAyB,QAAQ,CAAC,KAAK,EAAE,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,EAAE,GAAG,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAA;QAE1G,MAAM,SAAS,GAAe,EAAE,CAAA;QAChC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACnB,SAAS,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,kBAAkB,EAAE,iBAAiB,CAAC,CAAC,CAAA;QAClF,CAAC;QAED,MAAM,gBAAgB,GAAqB;YACvC,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,CAAC;SACZ,CAAA;QAED,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YAC/B,gBAAgB,CAAC,KAAK,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,KAAK,IAAI,CAAC,CAAA;YACtD,gBAAgB,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,IAAI,KAAK,CAAC,CAAA;QAC3D,CAAC;QAED,KAAK,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAA;QAE3C,MAAM,cAAc,GAAmB;YACnC,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,OAAO,EAAE,CAAC,gBAAgB,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,KAAK,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;YACjG,IAAI,EAAE,CAAC,EAAE,6BAA6B;YACtC,SAAS;YACT,gBAAgB;SACnB,CAAA;QAED,YAAY;QACZ,IAAI,OAAO,iBAAiB,KAAK,UAAU;YAAE,MAAM,iBAAiB,EAAE,CAAA;QACtE,MAAM,uBAAuB,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;QAE5D,OAAO,cAAc,CAAA;IACzB,CAAC,CAAC,CAAA;AACN,CAAC;AAED,KAAK,UAAU,uBAAuB,CAAC,MAAmB,EAAE,OAAoB;IAC5E,IAAI,MAAM,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAA;IACrD,CAAC;AACL,CAAC","sourcesContent":["import { timeProfileAsync } from './timeProfier.js'\nimport { runTasks } from './runTasks.js'\nimport { debug } from '../../output.js'\nimport { runIt } from './runIt.js'\n\nimport type {\n    FinalConfig, Describe, DescribeResult, ItResult, ItResultsSummary, ParsedDescribe, TaskExports\n} from '../../types.js'\n\nexport function runDescribeRun(config: FinalConfig, describe: Describe, parsedIts: ParsedDescribe)\n: Promise<DescribeResult> {\n    return timeProfileAsync(`run describe, run its ${describe.thing}`, async () => {\n        const { its, beforeDescribeExports, afterDescribeFunc, beforeEachTestFunc, afterEachTestFunc } = parsedIts\n\n        const itResults: ItResult[] = []\n        for (const it of its) {\n            itResults.push(await runIt(config, it, beforeEachTestFunc, afterEachTestFunc))\n        }\n\n        const itResultsSummary: ItResultsSummary = {\n            total: 0,\n            passes: 0\n        }\n\n        for (const itResult of itResults) {\n            itResultsSummary.total += +(itResult.success !== null)\n            itResultsSummary.passes += +(itResult.success ?? false)\n        }\n\n        debug('itResultsSummary', itResultsSummary)\n\n        const describeResult: DescribeResult = {\n            counter: describe.counter,\n            thing: describe.thing,\n            success: (itResultsSummary.total > 0) ? itResultsSummary.passes === itResultsSummary.total : null,\n            time: 0, // overwritten by runDescribe\n            itResults,\n            itResultsSummary\n        }\n\n        // run after\n        if (typeof afterDescribeFunc === 'function') await afterDescribeFunc()\n        await configAfterEachDescribe(config, beforeDescribeExports)\n\n        return describeResult\n    })\n}\n\nasync function configAfterEachDescribe(config: FinalConfig, exports: TaskExports): Promise<void> {\n    if (config.afterEachDescribe !== undefined) {\n        await runTasks(config.afterEachDescribe, exports)\n    }\n}\n"]}
+{"version":3,"file":"runDescribeRun.js","sourceRoot":"","sources":["../../../src/cli/lib/runDescribeRun.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAMlC,MAAM,UAAU,cAAc,CAAC,MAAmB,EAAE,QAAkB,EAAE,SAAyB;IAE7F,OAAO,gBAAgB,CAAC,yBAAyB,QAAQ,CAAC,KAAK,EAAE,EAAE,KAAK,IAAI,EAAE;QAC1E,MAAM,EAAE,GAAG,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAA;QAE1G,MAAM,gBAAgB,GAAG,QAAQ,CAAC,IAAI,KAAK,SAAS;YAChD,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,eAAe,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAA;QAErG,MAAM,UAAU,GAAG,gBAAgB,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,KAAK,UAAU,CAAA;QAE5E,MAAM,UAAU,GAA6B,EAAE,CAAA;QAC/C,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACnB,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,kBAAkB,EAAE,iBAAiB,CAAC,CAAA;YAC1E,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YAC1B,IAAI,CAAC,UAAU;gBAAE,MAAM,SAAS,CAAA;QACpC,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;QAE/C,MAAM,gBAAgB,GAAqB;YACvC,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,CAAC;SACZ,CAAA;QAED,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YAC/B,gBAAgB,CAAC,KAAK,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,KAAK,IAAI,CAAC,CAAA;YACtD,gBAAgB,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,OAAO,IAAI,KAAK,CAAC,CAAA;QAC3D,CAAC;QAED,KAAK,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAA;QAE3C,MAAM,cAAc,GAAmB;YACnC,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,OAAO,EAAE,CAAC,gBAAgB,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,KAAK,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;YACjG,IAAI,EAAE,CAAC,EAAE,6BAA6B;YACtC,SAAS;YACT,gBAAgB;SACnB,CAAA;QAED,YAAY;QACZ,IAAI,OAAO,iBAAiB,KAAK,UAAU;YAAE,MAAM,iBAAiB,EAAE,CAAA;QACtE,MAAM,uBAAuB,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAA;QAE5D,OAAO,cAAc,CAAA;IACzB,CAAC,CAAC,CAAA;AACN,CAAC;AAED,KAAK,UAAU,uBAAuB,CAAC,MAAmB,EAAE,OAAoB;IAC5E,IAAI,MAAM,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;QACzC,MAAM,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAA;IACrD,CAAC;AACL,CAAC","sourcesContent":["import { timeProfileAsync } from './timeProfier.js'\nimport { runTasks } from './runTasks.js'\nimport { debug } from '../../output.js'\nimport { runIt } from './runIt.js'\n\nimport type {\n    FinalConfig, Describe, DescribeResult, ItResult, ItResultsSummary, ParsedDescribe, TaskExports\n} from '../../types.js'\n\nexport function runDescribeRun(config: FinalConfig, describe: Describe, parsedIts: ParsedDescribe)\n: Promise<DescribeResult> {\n    return timeProfileAsync(`run describe, run its ${describe.thing}`, async () => {\n        const { its, beforeDescribeExports, afterDescribeFunc, beforeEachTestFunc, afterEachTestFunc } = parsedIts\n\n        const parallelOverride = describe.meta === undefined\n            ? undefined\n            : 'parallelTests' in describe.meta ? describe.meta.parallelTests : !describe.meta.sequentialTests\n\n        const isParallel = parallelOverride ?? config.execution.tests === 'parallel'\n\n        const itPromises: Array<Promise<ItResult>> = []\n        for (const it of its) {\n            const itPromise = runIt(config, it, beforeEachTestFunc, afterEachTestFunc)\n            itPromises.push(itPromise)\n            if (!isParallel) await itPromise\n        }\n        const itResults = await Promise.all(itPromises)\n\n        const itResultsSummary: ItResultsSummary = {\n            total: 0,\n            passes: 0\n        }\n\n        for (const itResult of itResults) {\n            itResultsSummary.total += +(itResult.success !== null)\n            itResultsSummary.passes += +(itResult.success ?? false)\n        }\n\n        debug('itResultsSummary', itResultsSummary)\n\n        const describeResult: DescribeResult = {\n            counter: describe.counter,\n            thing: describe.thing,\n            success: (itResultsSummary.total > 0) ? itResultsSummary.passes === itResultsSummary.total : null,\n            time: 0, // overwritten by runDescribe\n            itResults,\n            itResultsSummary\n        }\n\n        // run after\n        if (typeof afterDescribeFunc === 'function') await afterDescribeFunc()\n        await configAfterEachDescribe(config, beforeDescribeExports)\n\n        return describeResult\n    })\n}\n\nasync function configAfterEachDescribe(config: FinalConfig, exports: TaskExports): Promise<void> {\n    if (config.afterEachDescribe !== undefined) {\n        await runTasks(config.afterEachDescribe, exports)\n    }\n}\n"]}

package/dist/cli/lib/runTest.js

@@ -11,6 +11,10 @@ export function runTest(config, test, filters = {}) {
         // run before test file
         const fileExports = {};
         await configBeforeEachFile(config, fileExports);
+        const parallelOverride = test.meta === undefined
+            ? undefined
+            : 'parallelDescribes' in test.meta ? test.meta.parallelDescribes : !test.meta.sequentialDescribes;
+        const isParallel = parallelOverride ?? config.execution.describes === 'parallel';
         const runDescribePromises = [];
         for (const describe of test.describes ?? []) {
             if (filters.describe !== undefined
@@ -18,7 +22,7 @@ export function runTest(config, test, filters = {}) {
                 continue;
             const describePromise = runDescribe(config, describe, filters.it);
             runDescribePromises.push(describePromise);
-            if (config.execution.describes === 'sequential')
+            if (!isParallel)
                 await describePromise;
         }
         let describeResults = await Promise.all(runDescribePromises);

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

@@ -1 +1 @@
-{"version":3,"file":"runTest.js","sourceRoot":"","sources":["../../../src/cli/lib/runTest.ts"],"names":[],"mappings":"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","sourcesContent":["import { createTimeProfiler } from '../../packages/timeProfiler.js'\nimport { debug } from '../../output.js'\nimport { showTimeProfiling } from '../../config.js'\n\nimport { runTasks } from './runTasks.js'\nimport { addExports } from './addExports.js'\nimport { runDescribe } from './runDescribe.js'\n\nimport type {\n    FinalConfig, DescribeResult, DescribeResultsSummary, TaskExports, TestExecutionFilters, TestFile, TestResult\n} from '../../types.js'\n\nconst { timeProfileAsync } = createTimeProfiler(showTimeProfiling)\n\nexport function runTest(\n    config: FinalConfig,\n    test: TestFile,\n    filters: TestExecutionFilters = {}\n): Promise<TestResult> {\n    return timeProfileAsync(`run test ${test.file}`, async () => {\n        debug('test', test)\n\n        // run before test file\n        const fileExports: TaskExports = {}\n        await configBeforeEachFile(config, fileExports)\n\n        const runDescribePromises: Array<Promise<DescribeResult>> = []\n\n        for (const describe of test.describes ?? []) {\n            if (\n                filters.describe !== undefined\n                && !describe.thing.toLowerCase().includes(filters.describe.toLowerCase())\n            ) continue\n\n            const describePromise = runDescribe(config, describe, filters.it)\n            runDescribePromises.push(describePromise)\n            if (config.execution.describes === 'sequential') await describePromise\n        }\n\n        let describeResults = await Promise.all(runDescribePromises)\n        if (filters.it !== undefined) {\n            describeResults = describeResults.filter(result => (\n                result.itResults.length > 0 || result.error !== undefined\n            ))\n        }\n\n        const describeResultsSummary: DescribeResultsSummary = {\n            total: 0,\n            passes: 0,\n            invalid: 0,\n            itsTotal: 0,\n            itsPasses: 0\n        }\n\n        for (const describeResult of describeResults) {\n            describeResultsSummary.total += +(describeResult.success !== null)\n            describeResultsSummary.passes += +(describeResult.success ?? false)\n            describeResultsSummary.invalid += +(describeResult.success === null)\n            describeResultsSummary.itsTotal += describeResult.itResultsSummary.total\n            describeResultsSummary.itsPasses += describeResult.itResultsSummary.passes\n        }\n\n        const testResults: TestResult = {\n            file: test.file,\n            success: (describeResultsSummary.total > 0)\n                ? describeResultsSummary.total === describeResultsSummary.passes\n                : null,\n            describeResults,\n            describeResultsSummary,\n            logs: test.logs ?? []\n        }\n\n        // run after test\n        await configAfterEachFile(config, fileExports)\n\n        return testResults\n    })\n}\n\nasync function configBeforeEachFile(config: FinalConfig, exports: TaskExports): Promise<void> {\n    if (config.beforeEachFile !== undefined) {\n        const theExports = await runTasks(config.beforeEachFile, undefined)\n        if (theExports) addExports(exports, theExports)\n    }\n}\n\nasync function configAfterEachFile(config: FinalConfig, exports: TaskExports): Promise<void> {\n    if (config.afterEachFile !== undefined) {\n        await runTasks(config.afterEachFile, exports)\n    }\n}\n"]}
+{"version":3,"file":"runTest.js","sourceRoot":"","sources":["../../../src/cli/lib/runTest.ts"],"names":[],"mappings":"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","sourcesContent":["import { createTimeProfiler } from '../../packages/timeProfiler.js'\nimport { debug } from '../../output.js'\nimport { showTimeProfiling } from '../../config.js'\n\nimport { runTasks } from './runTasks.js'\nimport { addExports } from './addExports.js'\nimport { runDescribe } from './runDescribe.js'\n\nimport type {\n    FinalConfig, DescribeResult, DescribeResultsSummary, TaskExports, TestExecutionFilters, TestFile, TestResult\n} from '../../types.js'\n\nconst { timeProfileAsync } = createTimeProfiler(showTimeProfiling)\n\nexport function runTest(\n    config: FinalConfig,\n    test: TestFile,\n    filters: TestExecutionFilters = {}\n): Promise<TestResult> {\n    return timeProfileAsync(`run test ${test.file}`, async () => {\n        debug('test', test)\n\n        // run before test file\n        const fileExports: TaskExports = {}\n        await configBeforeEachFile(config, fileExports)\n\n        const parallelOverride = test.meta === undefined\n            ? undefined\n            : 'parallelDescribes' in test.meta ? test.meta.parallelDescribes : !test.meta.sequentialDescribes\n\n        const isParallel = parallelOverride ?? config.execution.describes === 'parallel'\n\n        const runDescribePromises: Array<Promise<DescribeResult>> = []\n\n        for (const describe of test.describes ?? []) {\n            if (\n                filters.describe !== undefined\n                && !describe.thing.toLowerCase().includes(filters.describe.toLowerCase())\n            ) continue\n\n            const describePromise = runDescribe(config, describe, filters.it)\n            runDescribePromises.push(describePromise)\n            if (!isParallel) await describePromise\n        }\n\n        let describeResults = await Promise.all(runDescribePromises)\n        if (filters.it !== undefined) {\n            describeResults = describeResults.filter(result => (\n                result.itResults.length > 0 || result.error !== undefined\n            ))\n        }\n\n        const describeResultsSummary: DescribeResultsSummary = {\n            total: 0,\n            passes: 0,\n            invalid: 0,\n            itsTotal: 0,\n            itsPasses: 0\n        }\n\n        for (const describeResult of describeResults) {\n            describeResultsSummary.total += +(describeResult.success !== null)\n            describeResultsSummary.passes += +(describeResult.success ?? false)\n            describeResultsSummary.invalid += +(describeResult.success === null)\n            describeResultsSummary.itsTotal += describeResult.itResultsSummary.total\n            describeResultsSummary.itsPasses += describeResult.itResultsSummary.passes\n        }\n\n        const testResults: TestResult = {\n            file: test.file,\n            success: (describeResultsSummary.total > 0)\n                ? describeResultsSummary.total === describeResultsSummary.passes\n                : null,\n            describeResults,\n            describeResultsSummary,\n            logs: test.logs ?? []\n        }\n\n        // run after test\n        await configAfterEachFile(config, fileExports)\n\n        return testResults\n    })\n}\n\nasync function configBeforeEachFile(config: FinalConfig, exports: TaskExports): Promise<void> {\n    if (config.beforeEachFile !== undefined) {\n        const theExports = await runTasks(config.beforeEachFile, undefined)\n        if (theExports) addExports(exports, theExports)\n    }\n}\n\nasync function configAfterEachFile(config: FinalConfig, exports: TaskExports): Promise<void> {\n    if (config.afterEachFile !== undefined) {\n        await runTasks(config.afterEachFile, exports)\n    }\n}\n"]}

package/dist/describe.d.ts

@@ -1,3 +1,9 @@
 import type { DescribeCallback } from './types.js';
+export type DescribeMeta = {
+    parallelTests: boolean;
+} | {
+    sequentialTests: boolean;
+};
 export declare function describe(theThing: string, tests: DescribeCallback): void;
+export declare function describe(theThing: string, meta: DescribeMeta, tests: DescribeCallback): void;
 //# sourceMappingURL=describe.d.ts.map

package/dist/describe.js

@@ -1,6 +1,6 @@
 import chalk from './packages/chalk.js';
 import { debug } from './output.js';
-export function describe(theThing, tests) {
+export function describe(theThing, testsOrMeta, possiblyTests) {
     if (!global.__sxy_test_runner__) {
         throw new Error('sxy-test-runner describe() was called, but the test framework has not initialized.'
             + ' This might be because you have run a test file directly'
@@ -9,9 +9,19 @@ export function describe(theThing, tests) {
     }
     const thisDescribeCounter = global.__sxy_test_runner__.describeCounter;
     global.__sxy_test_runner__.describeCounter++;
+    let meta = undefined;
+    let tests;
+    if (typeof testsOrMeta === 'function') {
+        tests = testsOrMeta;
+    }
+    else {
+        meta = testsOrMeta;
+        tests = possiblyTests; // eslint-disable-line no-type-assertion/no-type-assertion
+    }
     global.__sxy_test_runner__.describes.push({
         counter: thisDescribeCounter,
         thing: theThing,
+        meta,
         tests
     });
     debug(chalk.lightgrey `${thisDescribeCounter})`

package/dist/describe.js.map

@@ -1 +1 @@
-{"version":3,"file":"describe.js","sourceRoot":"","sources":["../src/describe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,qBAAqB,CAAA;AAEvC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAGnC,MAAM,UAAU,QAAQ,CAAC,QAAgB,EAAE,KAAuB;IAC9D,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACX,oFAAoF;cAClF,0DAA0D;cAC1D,+CAA+C,CACpD,CAAA;QACD,gFAAgF;IACpF,CAAC;IAED,MAAM,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,CAAC,eAAe,CAAA;IACtE,MAAM,CAAC,mBAAmB,CAAC,eAAe,EAAE,CAAA;IAE5C,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,IAAI,CAAC;QACtC,OAAO,EAAE,mBAAmB;QAC5B,KAAK,EAAE,QAAQ;QACf,KAAK;KACR,CAAC,CAAA;IAEF,KAAK,CACD,KAAK,CAAC,SAAS,CAAA,GAAG,mBAAmB,GAAG;UAClC,KAAK,CAAC,SAAS,CAAA,aAAa,GAAG,KAAK,CAAC,UAAU,CAAA,GAAG,QAAQ,IAAI,CACvE,CAAA;AACL,CAAC","sourcesContent":["import chalk from './packages/chalk.js'\n\nimport { debug } from './output.js'\nimport type { DescribeCallback } from './types.js'\n\nexport function describe(theThing: string, tests: DescribeCallback): void {\n    if (!global.__sxy_test_runner__) {\n        throw new Error(\n            'sxy-test-runner describe() was called, but the test framework has not initialized.'\n            + ' This might be because you have run a test file directly'\n            + ', instead of running \\'pnpm sxy-test-runner\\''\n        )\n        // todo - maybe we can initialise the framework and just run only this test file\n    }\n\n    const thisDescribeCounter = global.__sxy_test_runner__.describeCounter\n    global.__sxy_test_runner__.describeCounter++\n\n    global.__sxy_test_runner__.describes.push({\n        counter: thisDescribeCounter,\n        thing: theThing,\n        tests\n    })\n\n    debug(\n        chalk.lightgrey`${thisDescribeCounter})`\n            + chalk.lightgrey` Done with ` + chalk.brightblue`${theThing}\\n`\n    )\n}\n"]}
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../src/describe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,qBAAqB,CAAA;AAEvC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAOnC,MAAM,UAAU,QAAQ,CACpB,QAAgB,EAAE,WAA4C,EAAE,aAAgC;IAEhG,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACX,oFAAoF;cAClF,0DAA0D;cAC1D,+CAA+C,CACpD,CAAA;QACD,gFAAgF;IACpF,CAAC;IAED,MAAM,mBAAmB,GAAG,MAAM,CAAC,mBAAmB,CAAC,eAAe,CAAA;IACtE,MAAM,CAAC,mBAAmB,CAAC,eAAe,EAAE,CAAA;IAE5C,IAAI,IAAI,GAAG,SAAS,CAAA;IACpB,IAAI,KAAK,CAAA;IACT,IAAI,OAAO,WAAW,KAAK,UAAU,EAAE,CAAC;QACpC,KAAK,GAAG,WAAW,CAAA;IACvB,CAAC;SAAM,CAAC;QACJ,IAAI,GAAG,WAAW,CAAA;QAClB,KAAK,GAAG,aAAiC,CAAA,CAAC,0DAA0D;IACxG,CAAC;IACD,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,IAAI,CAAC;QACtC,OAAO,EAAE,mBAAmB;QAC5B,KAAK,EAAE,QAAQ;QACf,IAAI;QACJ,KAAK;KACR,CAAC,CAAA;IAEF,KAAK,CACD,KAAK,CAAC,SAAS,CAAA,GAAG,mBAAmB,GAAG;UAClC,KAAK,CAAC,SAAS,CAAA,aAAa,GAAG,KAAK,CAAC,UAAU,CAAA,GAAG,QAAQ,IAAI,CACvE,CAAA;AACL,CAAC","sourcesContent":["import chalk from './packages/chalk.js'\n\nimport { debug } from './output.js'\nimport type { DescribeCallback } from './types.js'\n\nexport type DescribeMeta = { parallelTests: boolean } | { sequentialTests: boolean }\n\nexport function describe(theThing: string, tests: DescribeCallback): void;\nexport function describe(theThing: string, meta: DescribeMeta, tests: DescribeCallback): void;\nexport function describe(\n    theThing: string, testsOrMeta: DescribeCallback | DescribeMeta, possiblyTests?: DescribeCallback\n): void {\n    if (!global.__sxy_test_runner__) {\n        throw new Error(\n            'sxy-test-runner describe() was called, but the test framework has not initialized.'\n            + ' This might be because you have run a test file directly'\n            + ', instead of running \\'pnpm sxy-test-runner\\''\n        )\n        // todo - maybe we can initialise the framework and just run only this test file\n    }\n\n    const thisDescribeCounter = global.__sxy_test_runner__.describeCounter\n    global.__sxy_test_runner__.describeCounter++\n\n    let meta = undefined\n    let tests\n    if (typeof testsOrMeta === 'function') {\n        tests = testsOrMeta\n    } else {\n        meta = testsOrMeta\n        tests = possiblyTests as DescribeCallback // eslint-disable-line no-type-assertion/no-type-assertion\n    }\n    global.__sxy_test_runner__.describes.push({\n        counter: thisDescribeCounter,\n        thing: theThing,\n        meta,\n        tests\n    })\n\n    debug(\n        chalk.lightgrey`${thisDescribeCounter})`\n            + chalk.lightgrey` Done with ` + chalk.brightblue`${theThing}\\n`\n    )\n}\n"]}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export { describe } from './describe.js';
+export { meta } from './meta.js';
 export type { UserConfig as Config } from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,2 +1,3 @@
 export { describe } from './describe.js';
+export { meta } from './meta.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA","sourcesContent":["\nexport { describe } from './describe.js'\nexport type { UserConfig as Config } from './types.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA","sourcesContent":["\nexport { describe } from './describe.js'\nexport { meta } from './meta.js'\nexport type { UserConfig as Config } from './types.js'\n"]}

package/dist/meta.d.ts

@@ -0,0 +1,7 @@
+export type FileMeta = {
+    parallelDescribes: boolean;
+} | {
+    sequentialDescribes: boolean;
+};
+export declare function meta(theMeta: FileMeta): void;
+//# sourceMappingURL=meta.d.ts.map

package/dist/meta.js

@@ -0,0 +1,9 @@
+export function meta(theMeta) {
+    if (!global.__sxy_test_runner__) {
+        throw new Error('sxy-test-runner meta() was called, but the test framework has not initialized.'
+            + ' This might be because you have run a test file directly'
+            + ', instead of running \'pnpm sxy-test-runner\'');
+    }
+    global.__sxy_test_runner__.fileMeta = theMeta;
+}
+//# sourceMappingURL=meta.js.map

package/dist/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../src/meta.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,IAAI,CAAC,OAAiB;IAClC,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACX,gFAAgF;cAC9E,0DAA0D;cAC1D,+CAA+C,CACpD,CAAA;IACL,CAAC;IAED,MAAM,CAAC,mBAAmB,CAAC,QAAQ,GAAG,OAAO,CAAA;AACjD,CAAC","sourcesContent":["\nexport type FileMeta\n    = { parallelDescribes: boolean }\n    | { sequentialDescribes: boolean }\n\nexport function meta(theMeta: FileMeta): void {\n    if (!global.__sxy_test_runner__) {\n        throw new Error(\n            'sxy-test-runner meta() was called, but the test framework has not initialized.'\n            + ' This might be because you have run a test file directly'\n            + ', instead of running \\'pnpm sxy-test-runner\\''\n        )\n    }\n\n    global.__sxy_test_runner__.fileMeta = theMeta\n}\n"]}

package/dist/types.d.ts

@@ -1,3 +1,5 @@
+import { DescribeMeta } from './describe.js';
+import { FileMeta } from './meta.js';
 export type ExecutionMode = 'parallel' | 'sequential';
 export type GlobPattern = string | string[];
 export interface ExecutionConfig {
@@ -52,6 +54,7 @@ export type DescribeCallback = (parcel: DescribeParcel) => void | Promise<void>;
 export interface Describe {
     counter: number;
     thing: string;
+    meta?: DescribeMeta;
     tests: DescribeCallback;
 }
 export interface It {
@@ -103,6 +106,7 @@ export interface DescribeResultsSummary {
 export interface TestFile {
     file: string;
     describes?: Describe[];
+    meta?: FileMeta;
     error?: string | false;
     logs?: unknown[][];
 }
@@ -139,6 +143,7 @@ export interface TestExecutionFilters {
 export interface SxyTestRunnerGlobal {
     describes: Describe[];
     describeCounter: number;
+    fileMeta?: FileMeta;
 }
 declare global {
     var __sxy_test_runner__: SxyTestRunnerGlobal | undefined;

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\nexport type ExecutionMode = 'parallel' | 'sequential'\nexport type GlobPattern = string | string[]\n\nexport interface ExecutionConfig {\n    files: ExecutionMode\n    describes: ExecutionMode\n    tests: ExecutionMode\n}\n\nexport interface WatchConfig {\n    watchFilesBase: string\n    watchFiles: GlobPattern\n    watchFilesIgnore: GlobPattern\n    runAllOnStartup: boolean\n    reRunFailingTests: boolean\n    ttyActionsOnKeypress: boolean\n}\n\nexport type TaskExports = Record<string, unknown>\nexport type ConfigTaskFn = (parcel?: TaskExports) => TaskExports | void | Promise<TaskExports | void>\n// a task may also be a file path (relative to the project root) to dynamically import\nexport type ConfigTask = ConfigTaskFn | string\nexport type ConfigTasks = ConfigTask | ConfigTask[]\n\nexport interface FinalConfig {\n    testsBase: string\n    tests: GlobPattern\n    testsFilter?: string\n    testsIgnore: GlobPattern\n    setup?: ConfigTasks\n    beforeEachFile?: ConfigTasks\n    afterEachFile?: ConfigTasks\n    beforeEachDescribe?: ConfigTasks\n    afterEachDescribe?: ConfigTasks\n    beforeEachTest?: ConfigTasks\n    afterEachTest?: ConfigTasks\n    teardown?: ConfigTasks\n    showErrorTrace: boolean\n    compact: boolean\n    execution: ExecutionConfig\n    watch: WatchConfig\n}\n\nexport type UserConfig = Partial<Omit<FinalConfig, 'testsFilter' | 'execution' | 'watch'>> & {\n    execution?: Partial<ExecutionConfig>\n    watch?: Partial<WatchConfig>\n}\n\nexport type UserConfigInternal = UserConfig & Partial<Pick<FinalConfig, 'testsFilter'>>\n\n\n// -- test-run data model --------------------------------------------------\n\nexport type TestParcel = TaskExports\n\nexport interface DescribeParcel extends TaskExports {\n    it: (should: string, test: (parcel: TestParcel) => void | Promise<void>) => void\n    test: (should: string, test: (parcel: TestParcel) => void | Promise<void>) => void\n    afterDescribe: (func: () => void | Promise<void>) => void\n    beforeEachTest: (func: () => TaskExports | void | Promise<TaskExports | void>) => void\n    afterEachTest: (func: () => void | Promise<void>) => void\n}\n\nexport type DescribeCallback = (parcel: DescribeParcel) => void | Promise<void>\n\nexport interface Describe {\n    counter: number\n    thing: string\n    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    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}\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\nexport interface WatchConfig {\n    watchFilesBase: string\n    watchFiles: GlobPattern\n    watchFilesIgnore: GlobPattern\n    runAllOnStartup: boolean\n    reRunFailingTests: boolean\n    ttyActionsOnKeypress: boolean\n}\n\nexport type TaskExports = Record<string, unknown>\nexport type ConfigTaskFn = (parcel?: TaskExports) => TaskExports | void | Promise<TaskExports | void>\n// a task may also be a file path (relative to the project root) to dynamically import\nexport type ConfigTask = ConfigTaskFn | string\nexport type ConfigTasks = ConfigTask | ConfigTask[]\n\nexport interface FinalConfig {\n    testsBase: string\n    tests: GlobPattern\n    testsFilter?: string\n    testsIgnore: GlobPattern\n    setup?: ConfigTasks\n    beforeEachFile?: ConfigTasks\n    afterEachFile?: ConfigTasks\n    beforeEachDescribe?: ConfigTasks\n    afterEachDescribe?: ConfigTasks\n    beforeEachTest?: ConfigTasks\n    afterEachTest?: ConfigTasks\n    teardown?: ConfigTasks\n    showErrorTrace: boolean\n    compact: boolean\n    execution: ExecutionConfig\n    watch: WatchConfig\n}\n\nexport type UserConfig = Partial<Omit<FinalConfig, 'testsFilter' | 'execution' | 'watch'>> & {\n    execution?: Partial<ExecutionConfig>\n    watch?: Partial<WatchConfig>\n}\n\nexport type UserConfigInternal = UserConfig & Partial<Pick<FinalConfig, 'testsFilter'>>\n\n\n// -- test-run data model --------------------------------------------------\n\nexport type TestParcel = TaskExports\n\nexport interface DescribeParcel extends TaskExports {\n    it: (should: string, test: (parcel: TestParcel) => void | Promise<void>) => void\n    test: (should: string, test: (parcel: TestParcel) => void | Promise<void>) => void\n    afterDescribe: (func: () => void | Promise<void>) => void\n    beforeEachTest: (func: () => TaskExports | void | Promise<TaskExports | void>) => void\n    afterEachTest: (func: () => void | Promise<void>) => void\n}\n\nexport type DescribeCallback = (parcel: DescribeParcel) => void | Promise<void>\n\nexport interface Describe {\n    counter: number\n    thing: string\n    meta?: DescribeMeta\n    tests: DescribeCallback\n}\n\nexport interface It {\n    counter: number\n    should: string\n    test: (parcel: TestParcel) => void | Promise<void>\n}\n\nexport interface ParsedDescribe {\n    its: It[]\n    beforeDescribeExports: TaskExports\n    afterDescribeFunc?: () => void | Promise<void>\n    beforeEachTestFunc?: () => TaskExports | void | Promise<TaskExports | void>\n    afterEachTestFunc?: () => void | Promise<void>\n    error?: unknown\n}\n\nexport interface TestError extends Error {\n    actual?: unknown\n    expected?: unknown\n}\n\nexport interface ItResult {\n    counter: number\n    should: string\n    success: boolean | null\n    time: number\n    error?: TestError\n    logs: unknown[][]\n}\n\nexport interface ItResultsSummary {\n    total: number\n    passes: number\n}\n\nexport interface DescribeResult {\n    counter: number\n    thing: string\n    success: boolean | null\n    // total elapsed for the whole describe, filled in by runDescribe once it has finished\n    time: number\n    itResults: ItResult[]\n    itResultsSummary: ItResultsSummary\n    logs?: unknown[][]\n    error?: unknown\n}\n\nexport interface DescribeResultsSummary {\n    total: number\n    passes: number\n    invalid: number\n    itsTotal: number\n    itsPasses: number\n}\n\nexport interface TestFile {\n    file: string\n    describes?: Describe[]\n    meta?: FileMeta\n    error?: string | false\n    logs?: unknown[][]\n}\n\nexport interface TestResult {\n    file: string\n    success: boolean | null\n    describeResults: DescribeResult[]\n    describeResultsSummary: DescribeResultsSummary\n    logs: unknown[][]\n}\n\nexport interface TestsResultsSummary {\n    total: number\n    passes: number\n    invalid: number\n    describesTotal: number\n    describesPasses: number\n    describesInvalid: number\n    itsTotal: number\n    itsPasses: number\n}\n\nexport type DependencyTrees = Record<string, string[]>\n\nexport type OutFn = (...texts: unknown[]) => void\n\n\n\n// -- CLI argument parsing ---------------------------------------------------\n\nexport interface AllowedArgument {\n    flag?: string\n    hasValue: boolean\n}\n\nexport type AllowedArguments = Record<string, AllowedArgument>\nexport type AllowedFlags = Record<string, string>\nexport type ParsedArguments = Record<string, string | true>\n\nexport interface TestExecutionFilters {\n    describe?: string\n    it?: string\n}\n\n// -- globals ----------------------------------------------------------------\n\nexport interface SxyTestRunnerGlobal {\n    describes: Describe[]\n    describeCounter: number\n    fileMeta?: FileMeta\n}\ndeclare global {\n    // eslint-disable-next-line camelcase\n    var __sxy_test_runner__: SxyTestRunnerGlobal | undefined\n    // eslint-disable-next-line camelcase\n    var __sxyt_commandLineArguments: string[]\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sxy-test-runner",
-  "version": "2.3.17",
+  "version": "2.3.19",
   "license": "MIT",
   "homepage": "https://github.com/RobertSandiford/sxy-test-runner",
   "repository": {
@@ -49,7 +49,7 @@
     "minimatch": "^5.1.9",
     "node-watch": "^0.7.4",
     "rimraf": "^6.1.3",
-    "sxy-lib": "^3.0.4"
+    "sxy-lib": "^3.0.5"
   },
   "devDependencies": {
     "@types/chai-as-promised": "^7.1.8",
@@ -60,11 +60,11 @@
     "@types/sinon": "^17.0.4",
     "@types/sinon-chai": "^3.2.12",
     "@typescript-eslint/utils": "^8.65.0",
-    "chai": "^6.0.0",
+    "chai": "^6.2.2",
     "chai-as-promised": "^7.1.2",
     "chai-string": "^1.6.0",
     "eslint": "^9.39.5",
-    "eslint-config-tungsten-flat": "^0.2.1",
+    "eslint-config-tungsten-flat": "^0.2.5",
     "mocha": "^9.2.2",
     "mocha-steps": "^1.3.0",
     "nodemon": "^2.0.22",