@flemist/test-variants 5.0.2 → 5.0.3

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-LuHR6HJQ.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-BaW2oQ-k.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-LuHR6HJQ.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-BaW2oQ-k.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 */