import { z } from 'zod';
export type QueryParamTransform = 'array' | 'boolean' | 'optional';
/**
 * Parses a comma-separated query string into a trimmed string array.
 */
export declare function queryParamArrayString<T extends z.ZodTypeAny>(schema: T): z.ZodEffects<T, T["_output"], unknown>;
/**
 * Parses common truthy query string values into a boolean.
 */
export declare function queryParamBoolean(defaultValue?: boolean): z.ZodEffects<z.ZodBoolean, boolean, unknown> | z.ZodDefault<z.ZodEffects<z.ZodBoolean, boolean, unknown>>;
/**
 * Treats empty query string values as undefined before validating optional fields.
 */
export declare function queryParamOptional<T extends z.ZodTypeAny>(schema: T): z.ZodEffects<any, any, unknown>;
/**
 * Builds a query-string Zod object schema from a filters shape and per-field transforms.
 * Use the inferred output type as the shared contract between API handlers and frontend callers.
 */
export declare function toQueryParamsSchema<T extends Record<string, z.ZodTypeAny>>(shape: T, transforms: Partial<Record<keyof T, QueryParamTransform>>): z.ZodObject<{ [K in keyof T]: z.ZodTypeAny; }, "strip", z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<{ [K in keyof T]: z.ZodTypeAny; }>, any> extends infer T_1 ? { [k in keyof T_1]: T_1[k]; } : never, z.baseObjectInputType<{ [K in keyof T]: z.ZodTypeAny; }> extends infer T_2 ? { [k_1 in keyof T_2]: T_2[k_1]; } : never>;