velocious 1.0.171 → 1.0.172

package/build/src/testing/test-runner.d.ts

@@ -9,11 +9,14 @@
  * @property {() => (void|Promise<void>)} [function] - Test callback function.
  * @property {number} [retry] - Number of retries when a test fails.
  * @property {string[] | string} [tags] - Tags for filtering.
+ * @property {number} [timeoutSeconds] - Timeout in seconds for the test.
  * @property {string} [type] - Test type identifier.
  */
 /**
  * @typedef {object} TestData
  * @property {TestArgs} args - Arguments passed to the test.
+ * @property {string} [filePath] - Source file path.
+ * @property {number} [line] - Source line number.
  * @property {function(TestArgs) : (void|Promise<void>)} function - Test callback to execute.
  */
 /**
@@ -38,6 +41,8 @@
  * @property {BeforeAfterAllCallbackObjectType[]} afterAlls - After-all hooks for this scope.
  * @property {BeforeAfterAllCallbackObjectType[]} beforeAlls - Before-all hooks for this scope.
  * @property {AfterBeforeEachCallbackObjectType[]} beforeEaches - Before-each hooks for this scope.
+ * @property {string} [filePath] - Source file path.
+ * @property {number} [line] - Source line number.
  * @property {Record<string, TestData>} tests - A unique identifier for the node.
  * @property {Record<string, TestsArgument>} subs - Optional child nodes. Each item is another `Node`, allowing recursion.
  */
@@ -48,12 +53,16 @@ export default class TestRunner {
      * @param {string[] | string} [args.excludeTags] - Tags to exclude.
      * @param {string[] | string} [args.includeTags] - Tags to include.
      * @param {Array<string>} args.testFiles - Test files.
+     * @param {Record<string, number[]>} [args.lineFilters] - Line filters by file.
+     * @param {RegExp[]} [args.examplePatterns] - Example patterns.
      */
-    constructor({ configuration, excludeTags, includeTags, testFiles, ...restArgs }: {
+    constructor({ configuration, excludeTags, includeTags, testFiles, lineFilters, examplePatterns, ...restArgs }: {
         configuration: import("../configuration.js").default;
         excludeTags?: string[] | string;
         includeTags?: string[] | string;
         testFiles: Array<string>;
+        lineFilters?: Record<string, number[]>;
+        examplePatterns?: RegExp[];
     });
     _configuration: import("../configuration.js").default;
     _excludeTags: string[];
@@ -61,10 +70,13 @@ export default class TestRunner {
     _includeTags: string[];
     _includeTagSet: Set<string>;
     _testFiles: string[];
+    _lineFilters: Record<string, number[]>;
+    _examplePatterns: RegExp[];
     _failedTests: number;
     _successfulTests: number;
     _testsCount: number;
     _activeAfterAllScopes: any[];
+    _failedTestDetails: any[];
     /**
      * @returns {import("../configuration.js").default} - The configuration.
      */
@@ -73,6 +85,10 @@ export default class TestRunner {
      * @returns {string[]} - The test files.
      */
     getTestFiles(): string[];
+    /** @returns {Record<string, number[]>} - Line filters. */
+    getLineFilters(): Record<string, number[]>;
+    /** @returns {RegExp[]} - Example patterns. */
+    getExamplePatterns(): RegExp[];
     /**
      * @param {string[] | string | undefined} tags - Tags.
      * @returns {string[]} - Normalized tags.
@@ -90,14 +106,31 @@ export default class TestRunner {
     hasMatchingTag(testTags: string[] | string | undefined, tagSet: Set<string>): boolean;
     /**
      * @param {TestsArgument} tests - Tests.
+     * @param {string[]} [descriptions] - Description stack.
+     * @param {boolean} [lineMatchedInScope] - Whether line matched in scope.
      * @returns {boolean} - Whether any tests in this scope will run.
      */
-    hasRunnableTests(tests: TestsArgument): boolean;
+    hasRunnableTests(tests: TestsArgument, descriptions?: string[], lineMatchedInScope?: boolean): boolean;
     /**
      * @param {TestArgs} testArgs - Test args.
+     * @param {TestData} testData - Test data.
+     * @param {string} testDescription - Test description.
+     * @param {string[]} descriptions - Description stack.
+     * @param {boolean} lineMatchedInScope - Whether line matched in scope.
      * @returns {boolean} - Whether the test should be skipped.
      */
-    shouldSkipTest(testArgs: TestArgs): boolean;
+    shouldSkipTest(testArgs: TestArgs, testData: TestData, testDescription: string, descriptions: string[], lineMatchedInScope: boolean): boolean;
+    /**
+     * @param {TestData | TestsArgument} entry - Test entry.
+     * @returns {boolean} - Whether line filter matches entry.
+     */
+    matchesLineFilter(entry: TestData | TestsArgument): boolean;
+    /**
+     * @param {string[]} descriptions - Description stack.
+     * @param {string} testDescription - Test description.
+     * @returns {string} - Full description.
+     */
+    buildFullDescription(descriptions: string[], testDescription: string): string;
     /**
      * @returns {Promise<Application>} - Resolves with the application.
      */
@@ -120,6 +153,13 @@ export default class TestRunner {
      * @returns {number} - The failed tests.
      */
     getFailedTests(): number;
+    /** @returns {Array<{fullDescription: string, filePath?: string, line?: number, error: unknown}>} - Failed test details. */
+    getFailedTestDetails(): Array<{
+        fullDescription: string;
+        filePath?: string;
+        line?: number;
+        error: unknown;
+    }>;
     /**
      * @returns {number} - The successful tests.
      */
@@ -164,14 +204,16 @@ export default class TestRunner {
      * @param {TestsArgument} args.tests - Tests.
      * @param {string[]} args.descriptions - Descriptions.
      * @param {number} args.indentLevel - Indent level.
+     * @param {boolean} [args.lineMatchedInScope] - Whether line matched in scope.
      * @returns {Promise<void>} - Resolves when complete.
      */
-    runTests({ afterEaches, beforeEaches, tests, descriptions, indentLevel }: {
+    runTests({ afterEaches, beforeEaches, tests, descriptions, indentLevel, lineMatchedInScope }: {
         afterEaches: Array<AfterBeforeEachCallbackObjectType>;
         beforeEaches: Array<AfterBeforeEachCallbackObjectType>;
         tests: TestsArgument;
         descriptions: string[];
         indentLevel: number;
+        lineMatchedInScope?: boolean;
     }): Promise<void>;
     /**
      * @param {{tests: TestsArgument, afterAllsRun: boolean}} scopeEntry - Scope entry.
@@ -187,6 +229,32 @@ export default class TestRunner {
      * @returns {Promise<void>} - Resolves when all listeners complete.
      */
     emitEvent(eventName: string, payload: object): Promise<void>;
+    /**
+     * @param {object} args - Options object.
+     * @param {string[]} args.descriptions - Description stack.
+     * @param {string} args.testDescription - Test description.
+     * @param {TestData} args.testData - Test data.
+     * @param {string} args.leftPadding - Left padding.
+     * @returns {void} - No return value.
+     */
+    printRerunCommand({ descriptions, testDescription, testData, leftPadding }: {
+        descriptions: string[];
+        testDescription: string;
+        testData: TestData;
+        leftPadding: string;
+    }): void;
+    /**
+     * @param {object} args - Options object.
+     * @param {string[]} args.descriptions - Description stack.
+     * @param {string} args.testDescription - Test description.
+     * @param {TestData} args.testData - Test data.
+     * @returns {string | undefined} - Rerun command.
+     */
+    buildRerunCommand({ descriptions, testDescription, testData }: {
+        descriptions: string[];
+        testDescription: string;
+        testData: TestData;
+    }): string | undefined;
 }
 export type TestArgs = {
     /**
@@ -220,6 +288,10 @@ export type TestArgs = {
      * - Tags for filtering.
      */
     tags?: string[] | string;
+    /**
+     * - Timeout in seconds for the test.
+     */
+    timeoutSeconds?: number;
     /**
      * - Test type identifier.
      */
@@ -230,6 +302,14 @@ export type TestData = {
      * - Arguments passed to the test.
      */
     args: TestArgs;
+    /**
+     * - Source file path.
+     */
+    filePath?: string;
+    /**
+     * - Source line number.
+     */
+    line?: number;
     /**
      * - Test callback to execute.
      */
@@ -280,6 +360,14 @@ export type TestsArgument = {
      * - Before-each hooks for this scope.
      */
     beforeEaches: AfterBeforeEachCallbackObjectType[];
+    /**
+     * - Source file path.
+     */
+    filePath?: string;
+    /**
+     * - Source line number.
+     */
+    line?: number;
     /**
      * - A unique identifier for the node.
      */

package/build/src/testing/test-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-runner.d.ts","sourceRoot":"","sources":["../../../src/testing/test-runner.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"test-runner.d.ts","sourceRoot":"","sources":["../../../src/testing/test-runner.js"],"names":[],"mappings":"AAiCA;;;;;;;;;;;;;GAaG;AAEH;;;;;;GAMG;AAEH;;GAEG;AAEH;;;GAGG;AAEH;;GAEG;AAEH;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH;IACE;;;;;;;;OAQG;IACH,+GAPG;QAAoD,aAAa,EAAzD,OAAO,qBAAqB,EAAE,OAAO;QACZ,WAAW,GAApC,MAAM,EAAE,GAAG,MAAM;QACQ,WAAW,GAApC,MAAM,EAAE,GAAG,MAAM;QACG,SAAS,EAA7B,KAAK,CAAC,MAAM,CAAC;QACmB,WAAW,GAA3C,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QACR,eAAe,GAA/B,MAAM,EAAE;KAClB,EAoBA;IAdC,sDAAmC;IACnC,uBAAmD;IACnD,4BAAgD;IAChD,uBAAmD;IACnD,4BAAgD;IAChD,qBAA2B;IAC3B,uCAAqC;IACrC,2BAA6C;IAE7C,qBAAqB;IACrB,yBAAyB;IACzB,oBAAoB;IACpB,6BAA+B;IAC/B,0BAA4B;IAG9B;;OAEG;IACH,oBAFa,OAAO,qBAAqB,EAAE,OAAO,CAED;IAEjD;;OAEG;IACH,gBAFa,MAAM,EAAE,CAEoB;IAEzC,0DAA0D;IAC1D,kBADc,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CACO;IAE7C,8CAA8C;IAC9C,sBADc,MAAM,EAAE,CAC+B;IAErD;;;OAGG;IACH,oBAHW,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,GAC3B,MAAM,EAAE,CAqBpB;IAED;;OAEG;IACH,oBAFa,GAAG,CAAC,MAAM,CAAC,CAMvB;IAED;;;;OAIG;IACH,yBAJW,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,UAC7B,GAAG,CAAC,MAAM,CAAC,GACT,OAAO,CAYnB;IAED;;;;;OAKG;IACH,wBALW,aAAa,iBACb,MAAM,EAAE,uBACR,OAAO,GACL,OAAO,CAwBnB;IAED;;;;;;;OAOG;IACH,yBAPW,QAAQ,YACR,QAAQ,mBACR,MAAM,gBACN,MAAM,EAAE,sBACR,OAAO,GACL,OAAO,CA0BnB;IAED;;;OAGG;IACH,yBAHW,QAAQ,GAAG,aAAa,GACtB,OAAO,CAWnB;IAED;;;;OAIG;IACH,mCAJW,MAAM,EAAE,mBACR,MAAM,GACJ,MAAM,CAMlB;IAED;;OAEG;IACH,eAFa,OAAO,CAAC,WAAW,CAAC,CAehC;IAXG,0BAIE;IASN;;OAEG;IACH,iBAFa,OAAO,CAAC,aAAa,CAAC,CAQlC;IAJG,8BAAyC;IAM7C;;OAEG;IACH,mBAFa,OAAO,CAAC,IAAI,CAAC,CAIzB;IAED;;OAEG;IACH,YAFa,OAAO,CAE0D;IAE9E;;OAEG;IACH,kBAFa,MAAM,CAMlB;IAED,2HAA2H;IAC3H,wBADc,KAAK,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAC,CAAC,CAG/F;IAED;;OAEG;IACH,sBAFa,MAAM,CAMlB;IAED;;OAEG;IACH,iBAFa,MAAM,CAMlB;IAED;;OAEG;IACH,yBAFa,MAAM,CAQlB;IAED;;OAEG;IACH,WAFa,OAAO,CAAC,IAAI,CAAC,CAiBzB;IAdC,0BAA6B;IAO7B,uBAA0C;IAS5C;;OAEG;IACH,uBAFa,OAAO,CAQnB;IAED;;OAEG;IACH,OAFa,OAAO,CAAC,IAAI,CAAC,CAYzB;IAED;;OAEG;IACH,+BAFa,OAAO,CAAC,IAAI,CAAC,CAUzB;IAED;;;OAGG;IACH,oBAHW,aAAa,GACX;QAAC,gBAAgB,EAAE,OAAO,CAAA;KAAC,CA6BvC;IAED;;;;;;;;;OASG;IACH,8FARG;QAAuD,WAAW,EAA1D,KAAK,CAAC,iCAAiC,CAAC;QACO,YAAY,EAA3D,KAAK,CAAC,iCAAiC,CAAC;QACpB,KAAK,EAAzB,aAAa;QACE,YAAY,EAA3B,MAAM,EAAE;QACK,WAAW,EAAxB,MAAM;QACS,kBAAkB,GAAjC,OAAO;KACf,GAAU,OAAO,CAAC,IAAI,CAAC,CAoJzB;IAED;;;OAGG;IACH,iCAHW;QAAC,KAAK,EAAE,aAAa,CAAC;QAAC,YAAY,EAAE,OAAO,CAAA;KAAC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAUzB;IAED;;;;OAIG;IACH,qBAJW,MAAM,WACN,MAAM,GACJ,OAAO,CAAC,IAAI,CAAC,CAQzB;IAED;;;;;;;OAOG;IACH,4EANG;QAAuB,YAAY,EAA3B,MAAM,EAAE;QACK,eAAe,EAA5B,MAAM;QACS,QAAQ,EAAvB,QAAQ;QACK,WAAW,EAAxB,MAAM;KACd,GAAU,IAAI,CAQhB;IAED;;;;;;OAMG;IACH,+DALG;QAAuB,YAAY,EAA3B,MAAM,EAAE;QACK,eAAe,EAA5B,MAAM;QACS,QAAQ,EAAvB,QAAQ;KAChB,GAAU,MAAM,GAAG,SAAS,CAmB9B;CACF;;;;;kBAnoBa,WAAW;;;;aACX,aAAa;;;;uBAExB;QAAsC,WAAW,GAAtC,OAAO;QACoB,QAAQ,GAAnC,OAAO;KAClB;;;;YAAW,OAAO;;;;eACP,MAAM,CAAC,IAAI,GAAC,OAAO,CAAC,IAAI,CAAC,CAAC;;;;YAC1B,MAAM;;;;WACN,MAAM,EAAE,GAAG,MAAM;;;;qBACjB,MAAM;;;;WACN,MAAM;;;;;;UAKN,QAAQ;;;;eACR,MAAM;;;;WACN,MAAM;;;;cACN,CAAS,IAAQ,EAAR,QAAQ,KAAI,CAAC,IAAI,GAAC,OAAO,CAAC,IAAI,CAAC,CAAC;;0CAI1C,CAAS,IAA8F,EAA9F;IAAC,aAAa,EAAE,OAAO,qBAAqB,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAC,KAAI,CAAC,IAAI,GAAC,OAAO,CAAC,IAAI,CAAC,CAAC;;;;;cAK9H,2BAA2B;;yCAI5B,CAAS,IAAsD,EAAtD;IAAC,aAAa,EAAE,OAAO,qBAAqB,EAAE,OAAO,CAAA;CAAC,KAAI,CAAC,IAAI,GAAC,OAAO,CAAC,IAAI,CAAC,CAAC;;;;;cAKtF,0BAA0B;;;;;;UAK1B,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC;;;;uBACxB,OAAO;;;;iBACP,iCAAiC,EAAE;;;;eACnC,gCAAgC,EAAE;;;;gBAClC,gCAAgC,EAAE;;;;kBAClC,iCAAiC,EAAE;;;;eACnC,MAAM;;;;WACN,MAAM;;;;WACN,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC;;;;UACxB,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC;;wBAjFnB,0BAA0B;0BAExB,qBAAqB"}