type TimePrecision='minute'|'second'|'millisecond';export interface ParsedTimeValue{hour:number;minute:number;second:number;millisecond:number;precision:TimePrecision;milliseconds:number;}export type TimeHourFormat='auto'|'12'|'24';export type TimePatternPart={type:'hour'|'minute'|'second'|'dayPeriod';value:string;}|{type:'literal';value:string;};
/** Parses the canonical, timezone-free wire representation used by an HTML time control. */
export declare function parseTimeValue(value:string):ParsedTimeValue|undefined;
/** Normalizes a public string/Date value without applying timezone or elapsed-time arithmetic. */
export declare function normalizeTimeValue(value:string|Date|null|undefined):string;
/**
* Formats milliseconds since local midnight as the canonical wire value, the inverse of
* `parseTimeValue(...).milliseconds`.
*
* Arithmetic rather than a round-trip through a `Date`: building a local `Date` at midnight and
* adding an offset lands on the wrong clock time on the days a zone shifts, which is exactly the
* kind of once-a-year bug nobody reproduces. Anything outside a single day -- negative, a full day
* or more, or non-finite -- yields `''`, matching how a native time input rejects an out-of-range
* `valueAsNumber` rather than silently wrapping it into a different time.
*/
export declare function timeValueFromMilliseconds(value:number):string;export declare function to24Hour(hour:number,dayPeriod:'am'|'pm'):number;
/** Implements HTML time's ordinary range and its useful reversed-bound overnight range. */
export declare function isTimeInRange(value:string,min:string,max:string):boolean;
/** HTML time's step base: valid `min`, otherwise the valid content/reset value, otherwise midnight. */
export declare function timeStepBaseMilliseconds(min:string,defaultValue?:string):number;
/** Checks the HTML time step grid using pure milliseconds since local midnight. */
export declare function hasTimeStepMismatch(value:string,step:number|'any',min:string,defaultValue?:string):boolean;
/** Derives segment order and separators from the active locale instead of assuming `HH:mm`. */
export declare function localeTimePattern(locale:string,hourFormat:TimeHourFormat,includeSeconds:boolean):TimePatternPart[];
/** Returns the locale's actual day-period labels, including non-Latin and punctuated forms. */
export declare function dayPeriodLabels(locale:string):{am:string;pm:string;};export declare function wrapTimeMilliseconds(value:number):number;export{};