/**
 * Params resolver — merges params from multiple sources and computes
 * the expansion matrix (cross-product of product arrays, zip of zip arrays).
 */
import type { ParamValue, ParamExpansionResult } from "./types.js";
/**
 * Merge params from suite-level (.vally.yaml), eval-level (eval.params.yaml),
 * and CLI-level (--param flags).
 * Precedence (highest wins): CLI > eval-level > suite-level.
 */
export declare function mergeParams(suiteParams: Record<string, ParamValue> | undefined, evalParams: Record<string, ParamValue> | undefined, cliParams?: Record<string, string>): Record<string, ParamValue>;
/** Default maximum number of matrix combinations before an error is raised. */
export declare const DEFAULT_MAX_COMBINATIONS = 100;
/**
 * Compute the full expansion matrix from merged params.
 *
 * - Scalar values: included in every combination unchanged.
 * - Product arrays: cross-product with all other product arrays.
 * - Zip arrays: all zipped together (must have matching lengths).
 *
 * Returns the list of all combinations and metadata about expanding params.
 *
 * @param params - Merged param values (scalars, product arrays, zip arrays).
 * @param nameSuffixTemplate - Optional name suffix template for expanded stimuli.
 * @param maxCombinations - Maximum allowed combinations (default 100). Set to
 *   `Infinity` to disable the guard.
 */
export declare function computeExpansion(params: Record<string, ParamValue>, nameSuffixTemplate?: string, maxCombinations?: number): ParamExpansionResult;
//# sourceMappingURL=resolver.d.ts.map