@flemist/test-variants 5.0.2 → 5.0.4

package/README.md

@@ -248,6 +248,10 @@ const result = await testVariants({
     tests,     // number of tests run before this mode change
   }) => void | Promise<void>,
 
+  // Pause debugger on error; requires IDE "step into library" enabled
+  // Repeats failing variant up to 5 times in debug mode
+  pauseDebuggerOnError: boolean | null, // default: true
+
   // Time controller for all internal delays, timeouts and getting current time
   // Used inside testVariants instead of direct setTimeout, Date.now calls, etc
   // Intended only for testing and debugging the test-variants library itself

package/build/browser/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../createTestVariants-Cmx68kHs.js");exports.createTestVariants=e.createTestVariants;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../createTestVariants-cAlu7ujN.js");exports.createTestVariants=e.createTestVariants;

package/build/browser/index.mjs

@@ -1,4 +1,4 @@
-import { c as r } from "../createTestVariants-BE_TQ9u5.mjs";
+import { c as r } from "../createTestVariants-D3rpiTL9.mjs";
 export {
   r as createTestVariants
 };

package/build/common/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../createTestVariants-Cmx68kHs.js");exports.createTestVariants=e.createTestVariants;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../createTestVariants-cAlu7ujN.js");exports.createTestVariants=e.createTestVariants;

package/build/common/index.mjs

@@ -1,4 +1,4 @@
-import { c as r } from "../createTestVariants-BE_TQ9u5.mjs";
+import { c as r } from "../createTestVariants-D3rpiTL9.mjs";
 export {
   r as createTestVariants
 };

package/build/common/test-variants/iterator/helpers/compareLexicographic.d.ts

@@ -0,0 +1,5 @@
+/** Compare indexes lexicographically (like numbers: 1999 < 2000)
+ * Returns: -1 if a < b, 0 if a == b, 1 if a > b
+ * Treat null/undefined as +Infinity
+ */
+export declare function compareLexicographic(a: (number | null)[], b: (number | null)[]): number;

package/build/common/test-variants/iterator/types.d.ts

@@ -14,10 +14,13 @@ export type AddLimitOptions<Args extends Obj> = {
     error?: unknown;
     /** Number of tests run when this limit is applied */
     tests?: null | number;
+};
+/** Options for calcIndexes method */
+export type CalcIndexesOptions = {
     /** Limit per-arg indexes; boolean enables/disables, function for custom per-arg logic */
     limitArg?: null | boolean | LimitArgOnError;
-    /** Extend template with extra args from limit if they are missing */
-    extendTemplates?: null | boolean;
+    /** When true, error variant is included in iteration (for debugging); default false excludes it */
+    includeLimit?: null | boolean;
 };
 /** Options for creating test variants iterator */
 export type VariantsIteratorOptions<Args extends Obj> = {
@@ -70,6 +73,10 @@ export type VariantsIterator<Args extends Obj> = {
     readonly tests: number;
     /** Add or tighten limit */
     addLimit(options?: null | AddLimitOptions<Args>): void;
+    /** Calculate indexes for args; returns null if args not in templates or beyond limit */
+    calcIndexes(args: ArgsWithSeed<Args>, options?: null | CalcIndexesOptions): number[] | null;
+    /** Extend templates with args values that are not in templates */
+    extendTemplates(args: Args): void;
     /** Get next variant or null when done */
     next(): ArgsWithSeed<Args> | null;
 };

package/build/common/test-variants/iterator/variant-navigation/variantNavigation.d.ts

@@ -8,6 +8,8 @@ export declare function createVariantNavigationState<Args extends Obj, Extra ext
 export declare function calcArgValues<Args extends Obj>(state: VariantNavigationState<Args>, argName: ArgName<Args>): readonly any[];
 /** Get max possible arg value index, considering limits */
 export declare function getArgValueMaxIndex(state: VariantNavigationState<any>, argIndex: number, belowMax: boolean): number;
+/** Check if variant navigation is at limit or beyond (lexicographic comparison) */
+export declare function isVariantNavigationAtLimit<Args extends Obj>(state: VariantNavigationState<Args>): boolean;
 /** Reset variant navigation to initial state; variant position will be undefined */
 export declare function resetVariantNavigation<Args extends Obj>(state: VariantNavigationState<Args>): void;
 /** Advance to next variant in cartesian product; returns true if successful */

package/build/common/test-variants/run/types.d.ts

@@ -52,6 +52,8 @@ export type TestVariantsCreateTestRunOptions<Args extends Obj> = {
     onError?: null | OnErrorCallback<Args>;
     /** Resolved logging options */
     log: RequiredNonNullable<TestVariantsLogOptions>;
+    /** Pause debugger on error */
+    pauseDebuggerOnError?: null | boolean;
 };
 export type TestVariantsCall<Args extends Obj> = <SavedArgs = Args>(options?: null | TestVariantsRunOptionsInternal<Args, SavedArgs>) => PromiseOrValue<TestVariantsResult<Args>>;
 export type TestVariantsSetArgs<Args extends Obj> = <ArgsExtra extends Obj>(args: TestVariantsTemplatesExt<Omit<Args, 'seed'>, Omit<ArgsExtra, 'seed'>>) => TestVariantsCall<Args>;

package/build/common/test-variants/types.d.ts

@@ -158,6 +158,8 @@ export type TestVariantsRunOptions<Args extends Obj = Obj, SavedArgs = Args> = {
     onError?: null | OnErrorCallback<Args>;
     /** Callback invoked when iteration mode changes */
     onModeChange?: null | OnModeChangeCallback;
+    /** Pause debugger on error */
+    pauseDebuggerOnError?: null | boolean;
     /** Wait for garbage collection after iterations */
     GC_Iterations?: null | number;
     /** Same as GC_Iterations but only for async test variants, required for 10000 and more of Promise rejections */