/**
 * @file URL search-param coercion helpers — `urlSearchParamsAs*` normalise a
 *   raw `string | null | undefined` value into a typed shape (array / boolean /
 *   number / string) with a default. `urlSearchParamsGet*` take a
 *   `URLSearchParams` instance and a key.
 */
import type { UrlSearchParamsAsBooleanOptions, UrlSearchParamsAsNumberOptions, UrlSearchParamsAsStringOptions, UrlSearchParamsGetBooleanOptions } from './types';
/**
 * Convert a URL search parameter to an array.
 *
 * @example
 *   ;```typescript
 *   urlSearchParamsAsArray('a, b, c') // ['a', 'b', 'c']
 *   urlSearchParamsAsArray(null) // []
 *   ```
 */
export declare function urlSearchParamsAsArray(value: string | null | undefined): string[];
/**
 * Convert a URL search parameter to a boolean.
 *
 * @example
 *   ;```typescript
 *   urlSearchParamsAsBoolean('true') // true
 *   urlSearchParamsAsBoolean('0') // false
 *   urlSearchParamsAsBoolean(null) // false
 *   ```
 */
export declare function urlSearchParamsAsBoolean(value: string | null | undefined, options?: UrlSearchParamsAsBooleanOptions | undefined): boolean;
/**
 * Get number value from URLSearchParams with a default.
 *
 * @example
 *   ;```typescript
 *   const params = new URLSearchParams('limit=10')
 *   urlSearchParamsAsNumber(params, 'limit') // 10
 *   urlSearchParamsAsNumber(params, 'other') // 0
 *   ```
 */
export declare function urlSearchParamsAsNumber(params: URLSearchParams | null | undefined, key: string, options?: UrlSearchParamsAsNumberOptions | undefined): number;
/**
 * Get string value from URLSearchParams with a default.
 *
 * @example
 *   ;```typescript
 *   const params = new URLSearchParams('name=socket')
 *   urlSearchParamsAsString(params, 'name') // 'socket'
 *   urlSearchParamsAsString(params, 'other') // ''
 *   ```
 */
export declare function urlSearchParamsAsString(params: URLSearchParams | null | undefined, key: string, options?: UrlSearchParamsAsStringOptions | undefined): string;
/**
 * Helper to get array from URLSearchParams.
 *
 * @example
 *   ;```typescript
 *   const params = new URLSearchParams('tags=a,b,c')
 *   urlSearchParamsGetArray(params, 'tags') // ['a', 'b', 'c']
 *   ```
 */
export declare function urlSearchParamsGetArray(params: URLSearchParams | null | undefined, key: string): string[];
/**
 * Helper to get boolean from URLSearchParams.
 *
 * @example
 *   ;```typescript
 *   const params = new URLSearchParams('debug=true')
 *   urlSearchParamsGetBoolean(params, 'debug') // true
 *   urlSearchParamsGetBoolean(params, 'other') // false
 *   ```
 */
export declare function urlSearchParamsGetBoolean(params: URLSearchParams | null | undefined, key: string, options?: UrlSearchParamsGetBooleanOptions | undefined): boolean;
