import { type ArrayOrValue } from '../array/array';
import { type Maybe } from '../value/maybe.type';
/**
 * Combines multiple Maps into a single Map. Later maps override earlier values for the same key.
 *
 * @param maps - The maps to combine (null/undefined maps are skipped)
 * @returns A new Map containing all entries
 */
export declare function combineMaps<K, T>(...maps: Maybe<Map<K, T>>[]): Map<K, T>;
/**
 * Sets the same value for one or more keys in a Map.
 *
 * @param map - The map to set values on
 * @param key - A single key or array of keys to set
 * @param value - The value to set for all keys
 * @returns The modified map
 */
export declare function setKeysOnMap<K, T>(map: Map<K, T>, key: ArrayOrValue<K>, value: T): Map<K, T>;
/**
 * Converts a Map to an array of key-value tuples.
 *
 * @param map - The map to convert
 * @returns An array of [key, value] tuples
 */
export declare function mapToTuples<K, T>(map: Map<K, T>): [K, T][];
/**
 * Expands a Map with array values into individual key/value tuples.
 *
 * @param map - A Map where values are arrays
 * @returns An array of [key, value] tuples, one for each element in each array
 */
export declare function expandArrayMapTuples<K, T>(map: Map<K, T[]>): [K, T][];
/**
 * Expands tuples where values may be arrays into individual key/value tuples.
 *
 * @param values - Array of [key, ArrayOrValue] tuples to expand
 * @returns An array of [key, value] tuples
 */
export declare function expandArrayValueTuples<K, T>(values: [K, ArrayOrValue<T>][]): [K, T][];