import type { CustomOptions, CustomValidate } from "../custom/index.ts";
/**
 * @credits
 * [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) week regex.
 * [Valibot](https://github.com/fabian-hiller/valibot/blob/c3de9371c2cfa4e126734ddf0e2ab1de98e8a6ef/library/src/regex.ts#L111C1-L114C77)
 */
export declare const ISO_WEEK_REGEX: RegExp;
/**
 * Determines if the input is an ISO week string.
 *
 * @param input The value to check.
 * @param validate Additional validation to run against the input if it is an ISO week string. Default is `undefined`.
 * @returns `true` if the input is an ISO week string, `false` otherwise.
 */
export declare function isIsoWeek(input: unknown, validate?: CustomValidate<string>): input is string;
export type IsoWeekOptions = Omit<CustomOptions<string>, "typecheck">;
/**
 * Verifies that the input is an ISO week string, and returns it.
 * If the input is not an ISO week string, the fallback value is returned.
 *
 * @format `YYYY-Www`
 *
 * @param input The value to check.
 * @param fallback The value to return if the input is not an ISO week string. Default is `null`.
 * @returns The ISO week string value of the input, or the fallback if the input is not an ISO week string.
 */
export declare function isoWeek(input: unknown, fallback: string, options?: IsoWeekOptions): string;
export declare function isoWeek(input: unknown, fallback?: string | null | undefined, options?: IsoWeekOptions): string | null;