@skdx/vue 0.28.0 → 0.29.0

package/dist/utils/dateSegments.cjs

@@ -1 +0,0 @@
-var T={year:"yyyy",month:"mm",day:"dd",hour:"hh",minute:"mm",second:"ss",dayPeriod:"--"},b="Empty",$={year:"year",month:"month",day:"day",hour:"hour",minute:"minute",second:"second",dayPeriod:"AM/PM"},E={year:4,month:2,day:2,hour:2,minute:2,second:2,dayPeriod:0},w={...E,month:1,day:1,hour:1},x=Date.UTC(2024,0,15,13,45,56),y=new Map,g=new Map;function l(e){return e??new Intl.DateTimeFormat().resolvedOptions().locale}function S(e,t){if(t===12||t===24)return t;const n=new Intl.DateTimeFormat(l(e),{hour:"numeric"}).resolvedOptions(),r=n.hourCycle??(n.hour12?"h12":"h23");return r==="h11"||r==="h12"?12:24}function P(e,t){const n=e==="date"?["year","month","day"]:[];return(e==="time"||t!=="day")&&(n.push("hour","minute"),t==="second"&&n.push("second")),n}function p(e,t){return!e||!t?31:new Date(e,t,0).getDate()}function M(e,t,n){switch(e){case"year":return{min:1,max:9999};case"month":return{min:1,max:12};case"day":return{min:1,max:p(t.year,t.month)};case"hour":return n===12?{min:1,max:12}:{min:0,max:23};case"minute":case"second":return{min:0,max:59};case"dayPeriod":return{min:0,max:1}}}function d(e){const t=l(e),n=g.get(t);if(n)return n;const r=new Intl.DateTimeFormat(t,{hour:"numeric",hourCycle:"h12",timeZone:"UTC"}),o=i=>r.formatToParts(Date.UTC(2024,0,15,i)).find(a=>a.type==="dayPeriod")?.value??(i<12?"AM":"PM"),u=[o(1),o(13)];return g.set(t,u),u}function V(e,t){if([...e].length!==1)return null;const n=e.toLowerCase();if(n==="a")return 0;if(n==="p")return 1;const r=d(t),o=a=>{const h=[...a][0];return h!==void 0&&h.localeCompare(e,t,{sensitivity:"base"})===0},u=o(r[0]),i=o(r[1]);return u&&i?null:u?0:i?1:null}function C(e,t){const n={timeZone:"UTC"};return e.includes("year")&&(n.year="numeric"),e.includes("month")&&(n.month="2-digit"),e.includes("day")&&(n.day="2-digit"),e.includes("hour")&&(n.hour="2-digit",n.hourCycle=t===12?"h12":"h23"),e.includes("minute")&&(n.minute="2-digit"),e.includes("second")&&(n.second="2-digit"),n}function R(e,t,n){const r=`${e}|${t.join(",")}|${n}`,o=y.get(r);if(o)return o;const u=new Intl.DateTimeFormat(e,C(t,n)).formatToParts(x),i=[];for(const a of u)a.type==="literal"?i.push({type:"literal",text:a.value.replace(/[\u202F\u2009\u00A0]/g," "),value:null,min:0,max:0,isPlaceholder:!1,isEditable:!1}):(a.type==="dayPeriod"||t.includes(a.type))&&i.push({type:a.type,text:"",value:null,min:0,max:0,isPlaceholder:!0,isEditable:!0});return y.set(r,i),i}function D(e,t,n,r,o=!0){if(t===null)return r?.(e)??T[e];if(e==="dayPeriod")return d(n)[t===0?0:1];const u=o?E:w;return String(t).padStart(u[e],"0")}function L(e){const t=l(e.locale),n=S(t,e.hourCycle);return R(t,P(e.kind,e.granularity),n).map(r=>{if(!r.isEditable)return r;const o=r.type,u=e.values[o]??null,{min:i,max:a}=M(o,e.values,n);return{type:o,text:D(o,u,t,e.getSegmentPlaceholder,e.shouldForceLeadingZeros??!0),value:u,min:i,max:a,isPlaceholder:u===null,isEditable:!0}})}function A(e){const t=new Date;switch(e.type){case"year":return t.getFullYear();case"hour":{const n=t.getHours();return e.min===1?n%12===0?12:n%12:n}case"minute":return t.getMinutes();case"second":return t.getSeconds();case"dayPeriod":return t.getHours()<12?0:1;default:return e.min}}function H(e,t,n){const r=t==="second"?"second":"minute",o=t==="second"?1:60;if(e!==r||n===void 0||!Number.isFinite(n)||n<=0||n%o!==0)return 1;const u=n/o;return u<60?u:1}function _(e,t,n=1){const{min:r,max:o}=e;if(e.value===null)return r+Math.floor((A(e)-r)/n)*n;const u=Math.floor((o-r)/n)+1,i=e.value-r;return r+(((t>0?Math.floor(i/n):Math.ceil(i/n))+t)%u+u)%u*n}function O(e){return Math.min(Math.max(e.value??e.min,e.min),e.max)}function U(e,t,n){let r=t*10+n;r>e.max&&(r=n);const o=r*10>e.max;return{value:r,buffer:o?0:r,advance:o}}function Y(e){return e.every(t=>!t.isEditable||t.value!==null&&t.value>=t.min&&t.value<=t.max)}function m(e,t,n){return n===24?e:e%12+(t===1?12:0)}function f(e,t){return t===24?[e,null]:[e%12===0?12:e%12,e<12?0:1]}function G(e,t){const{year:n,month:r,day:o}=e;if(!n||!r||!o)return null;const u=e.hour==null?0:m(e.hour,e.dayPeriod,t),i=new Date(n,r-1,o,u,e.minute??0,e.second??0,0);return n<100&&i.setFullYear(n),i}function I(e,t){const[n,r]=f(e.getHours(),t);return{year:e.getFullYear(),month:e.getMonth()+1,day:e.getDate(),hour:n,minute:e.getMinutes(),second:e.getSeconds(),dayPeriod:r}}function F(e,t,n){if(e.hour==null||e.minute==null||n===12&&e.dayPeriod==null)return null;const r=u=>String(u).padStart(2,"0"),o=`${r(m(e.hour,e.dayPeriod,n))}:${r(e.minute)}`;return t!=="second"?o:e.second==null?null:`${o}:${r(e.second)}`}function N(e,t){const n=/^(\d{1,2}):(\d{2})(?::(\d{2}))?$/.exec(e.trim());if(!n)return{};const r=Number(n[1]),o=Number(n[2]),u=n[3]===void 0?0:Number(n[3]);if(r>23||o>59||u>59)return{};const[i,a]=f(r,t);return{hour:i,minute:o,second:u,dayPeriod:a}}function c(e,t){const n=(u,i=2)=>String(u).padStart(i,"0"),r=`${n(e.getFullYear(),4)}-${n(e.getMonth()+1)}-${n(e.getDate())}`;if(t==="day")return r;const o=`${n(e.getHours())}:${n(e.getMinutes())}`;return t==="second"?`${r}T${o}:${n(e.getSeconds())}`:`${r}T${o}`}function B(e){const t=/^(\d{4,})-(\d{2})-(\d{2})(?:T(\d{2}):(\d{2})(?::(\d{2}))?)?$/.exec(e.trim());if(!t)return null;const n=Number(t[1]),r=new Date(n,Number(t[2])-1,Number(t[3]),Number(t[4]??0),Number(t[5]??0),Number(t[6]??0));return n<100&&r.setFullYear(n),Number.isNaN(r.getTime())?null:r}function s(e){const t=/^(\d{1,2}):(\d{2})(?::(\d{2}))?$/.exec(e.trim());if(!t)return null;const n=r=>r.padStart(2,"0");return`${n(t[1])}:${t[2]}:${n(t[3]??"00")}`}function v(e,t,n){if(!e)return null;const r=s(e);if(r===null)return null;const o=t?s(t):null;if(o!==null&&r<o)return"underflow";const u=n?s(n):null;return u!==null&&r>u?"overflow":null}function Z(e,t,n,r,o){const u=v(F(e,t,n),r,o);return u===null?e:{...e,...N(u==="underflow"?r:o,n)}}function z(e,t,n,r){if(!e)return null;const o=c(e,t);return n&&o<c(n,t)?"underflow":r&&o>c(r,t)?"overflow":null}exports.EMPTY_VALUE_TEXT=b;exports.SEGMENT_LABELS=$;exports.SEGMENT_PLACEHOLDERS=T;exports.buildSegments=L;exports.clampValuesToTimeRange=Z;exports.dateRangeViolation=z;exports.dateToFormValue=c;exports.dateToValues=I;exports.dayPeriodFromKey=V;exports.daysInMonth=p;exports.formatSegmentText=D;exports.from24Hour=f;exports.getDayPeriodNames=d;exports.isComplete=Y;exports.parseDateFormValue=B;exports.resolveHourCycle=S;exports.resolveLocale=l;exports.segmentRange=M;exports.segmentStepFor=H;exports.segmentTypesFor=P;exports.segmentValueNow=O;exports.stepSegment=_;exports.timeRangeViolation=v;exports.timeStringToValues=N;exports.to24Hour=m;exports.typeDigit=U;exports.valuesToDate=G;exports.valuesToTimeString=F;

package/dist/utils/dateSegments.d.cts

@@ -1,244 +0,0 @@
-/**
- * Segment engine for segmented date/time fields: builds editable segments
- * from locale and granularity via Intl.DateTimeFormat.formatToParts.
- * Framework-free except for Intl memo caches.
- */
-/** One editable piece of a segmented date/time value. */
-export type SegmentType = 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second' | 'dayPeriod';
-/** How far down a segmented field is editable (no 'hour': would duplicate 'minute'). */
-export type Granularity = 'day' | 'minute' | 'second';
-/** Whether hours read `1`–`12` (with an AM/PM segment) or `0`–`23`. */
-export type HourCycle = 12 | 24;
-/** Current numeric value of each editable segment; `null` means "not typed yet". */
-export type SegmentValues = Partial<Record<SegmentType, number | null>>;
-/** One rendered piece of a segmented field — an editable segment or a locale literal. */
-export interface Segment {
-    /** The segment this piece edits, or `'literal'` for the text between segments. */
-    type: SegmentType | 'literal';
-    /** What to render: the padded value, the placeholder, or the literal itself. */
-    text: string;
-    /** Current numeric value; `null` for literals and for untyped segments. */
-    value: number | null;
-    /** Lowest accepted value (`0` for literals). */
-    min: number;
-    /** Highest accepted value (`0` for literals). Dynamic for `day`. */
-    max: number;
-    /** Whether this segment is still showing its placeholder. */
-    isPlaceholder: boolean;
-    /** `false` only for literals. */
-    isEditable: boolean;
-}
-/** Default placeholder text; unreachable by Intl and untranslatable by locale. */
-export declare const SEGMENT_PLACEHOLDERS: Record<SegmentType, string>;
-/** The `aria-valuetext` an untyped segment announces, so a spinbutton never reads a value the user did not enter. */
-export declare const EMPTY_VALUE_TEXT = "Empty";
-/** Accessible name of each segment; exported so consumers can fall back to it. */
-export declare const SEGMENT_LABELS: Record<SegmentType, string>;
-/** The runtime's own locale, used whenever `locale` is omitted — matches `calendar/locale`'s `resolveLocale`. */
-export declare function resolveLocale(locale?: string): string;
-/**
- * The hour cycle to render with: the explicit `hourCycle` when given, otherwise
- * whatever the locale resolves to (`h11`/`h12` → `12`, `h23`/`h24` → `24`).
- *
- * @example
- * ```ts
- * resolveHourCycle('en-US'); // 12
- * resolveHourCycle('de-DE'); // 24
- * ```
- */
-export declare function resolveHourCycle(locale?: string, hourCycle?: HourCycle): HourCycle;
-/**
- * The editable segments a field of this kind and granularity owns, in canonical
- * (not locale) order. `dayPeriod` is appended by {@link buildSegments} only when
- * the resolved hour cycle is 12.
- *
- * @example
- * ```ts
- * segmentTypesFor('date', 'minute'); // ['year','month','day','hour','minute']
- * segmentTypesFor('time', 'second'); // ['hour','minute','second']
- * ```
- */
-export declare function segmentTypesFor(kind: 'date' | 'time', granularity: Granularity): SegmentType[];
-/** Days in a Gregorian month; `31` while either input is unknown, so `day` stays fully typeable. */
-export declare function daysInMonth(year: number | null | undefined, month: number | null | undefined): number;
-/** The accepted range of one segment, given the values around it. */
-export declare function segmentRange(type: SegmentType, values: SegmentValues, hourCycle: HourCycle): {
-    min: number;
-    max: number;
-};
-/** The locale's AM and PM names, e.g. `['AM', 'PM']` or `['vorm.', 'nachm.']`. */
-export declare function getDayPeriodNames(locale?: string): [string, string];
-/** Converts a keystroke to day period index (0 AM, 1 PM, null if neither). */
-export declare function dayPeriodFromKey(key: string, locale?: string): number | null;
-/** Generates placeholder text for a segment type. */
-export type SegmentPlaceholderResolver = (type: SegmentType) => string;
-/**
- * Formats a segment's display text (zero-padded, AM/PM name, or placeholder).
- *
- * @param shouldForceLeadingZeros `false` renders a one-digit month, day or hour
- * bare — see {@link SEGMENT_PAD_UNFORCED} for why those three and no others.
- */
-export declare function formatSegmentText(type: SegmentType, value: number | null, locale?: string, getSegmentPlaceholder?: SegmentPlaceholderResolver, shouldForceLeadingZeros?: boolean): string;
-/** Options for {@link buildSegments}. */
-export interface BuildSegmentsOptions {
-    /** `'date'` adds year/month/day ahead of the time segments. */
-    kind: 'date' | 'time';
-    /** How far down the field is editable. */
-    granularity: Granularity;
-    /** BCP-47 locale deciding segment order, literals and AM/PM names. */
-    locale?: string;
-    /** Forced hour cycle; omitted means "whatever the locale uses". */
-    hourCycle?: HourCycle;
-    /** Current per-segment values. */
-    values: SegmentValues;
-    /** Words each segment's placeholder; omitted keeps the built-in English letters. */
-    getSegmentPlaceholder?: SegmentPlaceholderResolver;
-    /**
-     * Whether a one-digit month, day or hour renders zero-padded (`05`) or bare
-     * (`5`). Never touches `year`, `minute` or `second`.
-     * @default true
-     */
-    shouldForceLeadingZeros?: boolean;
-}
-/**
- * The full ordered render list for a segmented field — editable segments
- * interleaved with the locale's literals.
- *
- * @example
- * ```ts
- * buildSegments({ kind: 'date', granularity: 'day', locale: 'en-US', values: {} })
- *   .filter((s) => s.isEditable)
- *   .map((s) => s.type); // ['month', 'day', 'year']
- * ```
- */
-export declare function buildSegments(options: BuildSegmentsOptions): Segment[];
-/**
- * How many units one Arrow press moves a segment, given the field-level `step`
- * in seconds; drives only the finest rendered segment, like `<input
- * type="time" step>` does. Falls back to `1` when `step` isn't a whole number
- * of the segment's unit, or isn't smaller than the segment's 60-value range.
- *
- * @example
- * ```ts
- * segmentStepFor('minute', 'minute', 900); // 15
- * segmentStepFor('hour', 'minute', 900); // 1 — only the finest segment steps
- * ```
- */
-export declare function segmentStepFor(type: SegmentType, granularity: Granularity, step?: number): number;
-/**
- * Steps one segment by `delta`, wrapping around its range (Arrow Up on `12:59`
- * minutes gives `12:00`). An untyped segment starts from
- * {@link untypedSegmentStart} rather than from `delta` applied to nothing.
- *
- * With a `step` past 1, the segment only lands on the grid `min`, `min +
- * step`, … at or below `max`, wrapping off its last grid point back to `min`.
- * A value already off the grid snaps to the next grid point in the direction
- * pressed, like a native stepper.
- *
- * @param step the segment's own step, from {@link segmentStepFor}
- */
-export declare function stepSegment(segment: Segment, delta: number, step?: number): number;
-/**
- * The `aria-valuenow` a segment publishes: its current value pulled back
- * inside its own `aria-valuemin`/`aria-valuemax`. Mid-entry a segment can
- * legitimately sit below its minimum (typing `0` into the month segment); the
- * raw digits still reach the user via `aria-valuetext`, which a spinbutton
- * announces in preference to the number.
- */
-export declare function segmentValueNow(segment: Segment): number;
-/** The result of typing one digit into a segment. */
-export interface DigitEntry {
-    /** The segment's new value. May be below `min` mid-entry (typing `0` then `5` into a month). */
-    value: number;
-    /** Buffer to carry into the next keystroke on this segment; `0` once entry is complete. */
-    buffer: number;
-    /** Whether focus should move to the next editable segment. */
-    advance: boolean;
-}
-/**
- * Types one digit into a segment: a keystroke that would overflow the segment
- * restarts entry at that digit instead of being rejected, and focus advances
- * once no further digit could fit. Stated here and pinned by tests, since no
- * external source specifies this per-segment behaviour precisely enough to check against.
- *
- * @param segment the segment being typed into
- * @param buffer what has been typed into it so far (`0` when entry just started)
- * @param digit the digit `0`–`9` just pressed
- *
- * @example
- * ```ts
- * // month, "1" already typed, user presses 5 → 15 overflows, restart at 5
- * typeDigit(monthSegment, 1, 5); // { value: 5, buffer: 0, advance: true }
- * ```
- */
-export declare function typeDigit(segment: Segment, buffer: number, digit: number): DigitEntry;
-/** Whether every editable segment has been typed and sits inside its range. */
-export declare function isComplete(segments: Segment[]): boolean;
-/** Converts a possibly-12-hour `hour` plus `dayPeriod` into the 0-23 hour. */
-export declare function to24Hour(hour: number, dayPeriod: number | null | undefined, hourCycle: HourCycle): number;
-/** Converts a 0-23 hour into the `[hour, dayPeriod]` pair the given cycle renders. */
-export declare function from24Hour(hour: number, hourCycle: HourCycle): [number, number | null];
-/**
- * The `Date` these segment values describe, in local time, or `null` while
- * any date segment is still untyped; unowned time segments default to `0`,
- * like `<input type="date">`.
- */
-export declare function valuesToDate(values: SegmentValues, hourCycle: HourCycle): Date | null;
-/** Splits a `Date` back into segment values for the given hour cycle. */
-export declare function dateToValues(date: Date, hourCycle: HourCycle): SegmentValues;
-/**
- * The `HH:mm` / `HH:mm:ss` string these segment values describe — always 24
- * hour, like `<input type="time">`, regardless of the rendered `hourCycle` —
- * or `null` while hour or minute is untyped.
- */
-export declare function valuesToTimeString(values: SegmentValues, granularity: Granularity, hourCycle: HourCycle): string | null;
-/** Parses `HH:mm[:ss]` (24 hour) into segment values for the given hour cycle. Invalid input yields empty values. */
-export declare function timeStringToValues(time: string, hourCycle: HourCycle): SegmentValues;
-/** The `YYYY-MM-DD` / `YYYY-MM-DDTHH:mm[:ss]` string a segmented date field submits. */
-export declare function dateToFormValue(date: Date, granularity: Granularity): string;
-/**
- * The inverse of {@link dateToFormValue}: reads a `YYYY-MM-DD` or
- * `YYYY-MM-DDTHH:mm[:ss]` string back into a local `Date`. Built field by
- * field rather than handed to `new Date(string)`, which reads a bare
- * `YYYY-MM-DD` as UTC midnight — the previous day west of Greenwich.
- *
- * @param value a string in the shape {@link dateToFormValue} produces
- * @returns the local date, or `null` when the string is not one of those shapes
- */
-export declare function parseDateFormValue(value: string): Date | null;
-/** Which side of a `min`/`max` bound a value falls outside, or `null` when it is in range. */
-export type RangeViolation = 'underflow' | 'overflow';
-/**
- * Whether a `HH:mm[:ss]` time falls outside `min`/`max`, compared as strings
- * (24-hour times sort chronologically when zero-padded).
- *
- * @param value the field's current wire value, or `null` while incomplete
- * @param min the earliest accepted time, `HH:mm[:ss]`
- * @param max the latest accepted time, `HH:mm[:ss]`
- * @returns which bound was crossed, or `null` when in range
- */
-export declare function timeRangeViolation(value: string | null | undefined, min?: string, max?: string): RangeViolation | null;
-/**
- * Whether an `HH:mm[:ss]` time misses the `step` grid — the `stepMismatch`
- * `<input type="time" step>` raises. Step counts seconds, anchored on `min` or midnight.
- * (The other four ports mirror `step` to a hidden input; this one computes it directly.)
- *
- * @param value the field's current wire value, or `null` while incomplete
- * @param step the field's step in seconds; non-positive or non-finite is no constraint
- * @param min the step base — the same `min` the range check uses
- */
-export declare function timeStepMismatch(value: string | null | undefined, step?: number, min?: string): boolean;
-/**
- * Pulls segment values inside `min`/`max` bounds (Home/End only).
- * Arrow-stepping and typing deliberately do not clamp so out-of-bounds
- * values stay reachable for validation.
- */
-export declare function clampValuesToTimeRange(values: SegmentValues, granularity: Granularity, hourCycle: HourCycle, min?: string, max?: string): SegmentValues;
-/**
- * Whether a `Date` falls outside `minDate`/`maxDate`, compared at the field's
- * `granularity` (a `day` field ignores time of day). String-compared via
- * {@link dateToFormValue} to match the native input's behavior.
- */
-export declare function dateRangeViolation(value: Date | null | undefined, granularity: Granularity, minDate?: Date, maxDate?: Date): RangeViolation | null;
-/** @internal Drops every memoized `Intl` result. Only needed by tests that switch locales in one process. */
-export declare function clearDateSegmentCache(): void;

package/dist/utils/dateSegments.d.ts

@@ -1,244 +0,0 @@
-/**
- * Segment engine for segmented date/time fields: builds editable segments
- * from locale and granularity via Intl.DateTimeFormat.formatToParts.
- * Framework-free except for Intl memo caches.
- */
-/** One editable piece of a segmented date/time value. */
-export type SegmentType = 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second' | 'dayPeriod';
-/** How far down a segmented field is editable (no 'hour': would duplicate 'minute'). */
-export type Granularity = 'day' | 'minute' | 'second';
-/** Whether hours read `1`–`12` (with an AM/PM segment) or `0`–`23`. */
-export type HourCycle = 12 | 24;
-/** Current numeric value of each editable segment; `null` means "not typed yet". */
-export type SegmentValues = Partial<Record<SegmentType, number | null>>;
-/** One rendered piece of a segmented field — an editable segment or a locale literal. */
-export interface Segment {
-    /** The segment this piece edits, or `'literal'` for the text between segments. */
-    type: SegmentType | 'literal';
-    /** What to render: the padded value, the placeholder, or the literal itself. */
-    text: string;
-    /** Current numeric value; `null` for literals and for untyped segments. */
-    value: number | null;
-    /** Lowest accepted value (`0` for literals). */
-    min: number;
-    /** Highest accepted value (`0` for literals). Dynamic for `day`. */
-    max: number;
-    /** Whether this segment is still showing its placeholder. */
-    isPlaceholder: boolean;
-    /** `false` only for literals. */
-    isEditable: boolean;
-}
-/** Default placeholder text; unreachable by Intl and untranslatable by locale. */
-export declare const SEGMENT_PLACEHOLDERS: Record<SegmentType, string>;
-/** The `aria-valuetext` an untyped segment announces, so a spinbutton never reads a value the user did not enter. */
-export declare const EMPTY_VALUE_TEXT = "Empty";
-/** Accessible name of each segment; exported so consumers can fall back to it. */
-export declare const SEGMENT_LABELS: Record<SegmentType, string>;
-/** The runtime's own locale, used whenever `locale` is omitted — matches `calendar/locale`'s `resolveLocale`. */
-export declare function resolveLocale(locale?: string): string;
-/**
- * The hour cycle to render with: the explicit `hourCycle` when given, otherwise
- * whatever the locale resolves to (`h11`/`h12` → `12`, `h23`/`h24` → `24`).
- *
- * @example
- * ```ts
- * resolveHourCycle('en-US'); // 12
- * resolveHourCycle('de-DE'); // 24
- * ```
- */
-export declare function resolveHourCycle(locale?: string, hourCycle?: HourCycle): HourCycle;
-/**
- * The editable segments a field of this kind and granularity owns, in canonical
- * (not locale) order. `dayPeriod` is appended by {@link buildSegments} only when
- * the resolved hour cycle is 12.
- *
- * @example
- * ```ts
- * segmentTypesFor('date', 'minute'); // ['year','month','day','hour','minute']
- * segmentTypesFor('time', 'second'); // ['hour','minute','second']
- * ```
- */
-export declare function segmentTypesFor(kind: 'date' | 'time', granularity: Granularity): SegmentType[];
-/** Days in a Gregorian month; `31` while either input is unknown, so `day` stays fully typeable. */
-export declare function daysInMonth(year: number | null | undefined, month: number | null | undefined): number;
-/** The accepted range of one segment, given the values around it. */
-export declare function segmentRange(type: SegmentType, values: SegmentValues, hourCycle: HourCycle): {
-    min: number;
-    max: number;
-};
-/** The locale's AM and PM names, e.g. `['AM', 'PM']` or `['vorm.', 'nachm.']`. */
-export declare function getDayPeriodNames(locale?: string): [string, string];
-/** Converts a keystroke to day period index (0 AM, 1 PM, null if neither). */
-export declare function dayPeriodFromKey(key: string, locale?: string): number | null;
-/** Generates placeholder text for a segment type. */
-export type SegmentPlaceholderResolver = (type: SegmentType) => string;
-/**
- * Formats a segment's display text (zero-padded, AM/PM name, or placeholder).
- *
- * @param shouldForceLeadingZeros `false` renders a one-digit month, day or hour
- * bare — see {@link SEGMENT_PAD_UNFORCED} for why those three and no others.
- */
-export declare function formatSegmentText(type: SegmentType, value: number | null, locale?: string, getSegmentPlaceholder?: SegmentPlaceholderResolver, shouldForceLeadingZeros?: boolean): string;
-/** Options for {@link buildSegments}. */
-export interface BuildSegmentsOptions {
-    /** `'date'` adds year/month/day ahead of the time segments. */
-    kind: 'date' | 'time';
-    /** How far down the field is editable. */
-    granularity: Granularity;
-    /** BCP-47 locale deciding segment order, literals and AM/PM names. */
-    locale?: string;
-    /** Forced hour cycle; omitted means "whatever the locale uses". */
-    hourCycle?: HourCycle;
-    /** Current per-segment values. */
-    values: SegmentValues;
-    /** Words each segment's placeholder; omitted keeps the built-in English letters. */
-    getSegmentPlaceholder?: SegmentPlaceholderResolver;
-    /**
-     * Whether a one-digit month, day or hour renders zero-padded (`05`) or bare
-     * (`5`). Never touches `year`, `minute` or `second`.
-     * @default true
-     */
-    shouldForceLeadingZeros?: boolean;
-}
-/**
- * The full ordered render list for a segmented field — editable segments
- * interleaved with the locale's literals.
- *
- * @example
- * ```ts
- * buildSegments({ kind: 'date', granularity: 'day', locale: 'en-US', values: {} })
- *   .filter((s) => s.isEditable)
- *   .map((s) => s.type); // ['month', 'day', 'year']
- * ```
- */
-export declare function buildSegments(options: BuildSegmentsOptions): Segment[];
-/**
- * How many units one Arrow press moves a segment, given the field-level `step`
- * in seconds; drives only the finest rendered segment, like `<input
- * type="time" step>` does. Falls back to `1` when `step` isn't a whole number
- * of the segment's unit, or isn't smaller than the segment's 60-value range.
- *
- * @example
- * ```ts
- * segmentStepFor('minute', 'minute', 900); // 15
- * segmentStepFor('hour', 'minute', 900); // 1 — only the finest segment steps
- * ```
- */
-export declare function segmentStepFor(type: SegmentType, granularity: Granularity, step?: number): number;
-/**
- * Steps one segment by `delta`, wrapping around its range (Arrow Up on `12:59`
- * minutes gives `12:00`). An untyped segment starts from
- * {@link untypedSegmentStart} rather than from `delta` applied to nothing.
- *
- * With a `step` past 1, the segment only lands on the grid `min`, `min +
- * step`, … at or below `max`, wrapping off its last grid point back to `min`.
- * A value already off the grid snaps to the next grid point in the direction
- * pressed, like a native stepper.
- *
- * @param step the segment's own step, from {@link segmentStepFor}
- */
-export declare function stepSegment(segment: Segment, delta: number, step?: number): number;
-/**
- * The `aria-valuenow` a segment publishes: its current value pulled back
- * inside its own `aria-valuemin`/`aria-valuemax`. Mid-entry a segment can
- * legitimately sit below its minimum (typing `0` into the month segment); the
- * raw digits still reach the user via `aria-valuetext`, which a spinbutton
- * announces in preference to the number.
- */
-export declare function segmentValueNow(segment: Segment): number;
-/** The result of typing one digit into a segment. */
-export interface DigitEntry {
-    /** The segment's new value. May be below `min` mid-entry (typing `0` then `5` into a month). */
-    value: number;
-    /** Buffer to carry into the next keystroke on this segment; `0` once entry is complete. */
-    buffer: number;
-    /** Whether focus should move to the next editable segment. */
-    advance: boolean;
-}
-/**
- * Types one digit into a segment: a keystroke that would overflow the segment
- * restarts entry at that digit instead of being rejected, and focus advances
- * once no further digit could fit. Stated here and pinned by tests, since no
- * external source specifies this per-segment behaviour precisely enough to check against.
- *
- * @param segment the segment being typed into
- * @param buffer what has been typed into it so far (`0` when entry just started)
- * @param digit the digit `0`–`9` just pressed
- *
- * @example
- * ```ts
- * // month, "1" already typed, user presses 5 → 15 overflows, restart at 5
- * typeDigit(monthSegment, 1, 5); // { value: 5, buffer: 0, advance: true }
- * ```
- */
-export declare function typeDigit(segment: Segment, buffer: number, digit: number): DigitEntry;
-/** Whether every editable segment has been typed and sits inside its range. */
-export declare function isComplete(segments: Segment[]): boolean;
-/** Converts a possibly-12-hour `hour` plus `dayPeriod` into the 0-23 hour. */
-export declare function to24Hour(hour: number, dayPeriod: number | null | undefined, hourCycle: HourCycle): number;
-/** Converts a 0-23 hour into the `[hour, dayPeriod]` pair the given cycle renders. */
-export declare function from24Hour(hour: number, hourCycle: HourCycle): [number, number | null];
-/**
- * The `Date` these segment values describe, in local time, or `null` while
- * any date segment is still untyped; unowned time segments default to `0`,
- * like `<input type="date">`.
- */
-export declare function valuesToDate(values: SegmentValues, hourCycle: HourCycle): Date | null;
-/** Splits a `Date` back into segment values for the given hour cycle. */
-export declare function dateToValues(date: Date, hourCycle: HourCycle): SegmentValues;
-/**
- * The `HH:mm` / `HH:mm:ss` string these segment values describe — always 24
- * hour, like `<input type="time">`, regardless of the rendered `hourCycle` —
- * or `null` while hour or minute is untyped.
- */
-export declare function valuesToTimeString(values: SegmentValues, granularity: Granularity, hourCycle: HourCycle): string | null;
-/** Parses `HH:mm[:ss]` (24 hour) into segment values for the given hour cycle. Invalid input yields empty values. */
-export declare function timeStringToValues(time: string, hourCycle: HourCycle): SegmentValues;
-/** The `YYYY-MM-DD` / `YYYY-MM-DDTHH:mm[:ss]` string a segmented date field submits. */
-export declare function dateToFormValue(date: Date, granularity: Granularity): string;
-/**
- * The inverse of {@link dateToFormValue}: reads a `YYYY-MM-DD` or
- * `YYYY-MM-DDTHH:mm[:ss]` string back into a local `Date`. Built field by
- * field rather than handed to `new Date(string)`, which reads a bare
- * `YYYY-MM-DD` as UTC midnight — the previous day west of Greenwich.
- *
- * @param value a string in the shape {@link dateToFormValue} produces
- * @returns the local date, or `null` when the string is not one of those shapes
- */
-export declare function parseDateFormValue(value: string): Date | null;
-/** Which side of a `min`/`max` bound a value falls outside, or `null` when it is in range. */
-export type RangeViolation = 'underflow' | 'overflow';
-/**
- * Whether a `HH:mm[:ss]` time falls outside `min`/`max`, compared as strings
- * (24-hour times sort chronologically when zero-padded).
- *
- * @param value the field's current wire value, or `null` while incomplete
- * @param min the earliest accepted time, `HH:mm[:ss]`
- * @param max the latest accepted time, `HH:mm[:ss]`
- * @returns which bound was crossed, or `null` when in range
- */
-export declare function timeRangeViolation(value: string | null | undefined, min?: string, max?: string): RangeViolation | null;
-/**
- * Whether an `HH:mm[:ss]` time misses the `step` grid — the `stepMismatch`
- * `<input type="time" step>` raises. Step counts seconds, anchored on `min` or midnight.
- * (The other four ports mirror `step` to a hidden input; this one computes it directly.)
- *
- * @param value the field's current wire value, or `null` while incomplete
- * @param step the field's step in seconds; non-positive or non-finite is no constraint
- * @param min the step base — the same `min` the range check uses
- */
-export declare function timeStepMismatch(value: string | null | undefined, step?: number, min?: string): boolean;
-/**
- * Pulls segment values inside `min`/`max` bounds (Home/End only).
- * Arrow-stepping and typing deliberately do not clamp so out-of-bounds
- * values stay reachable for validation.
- */
-export declare function clampValuesToTimeRange(values: SegmentValues, granularity: Granularity, hourCycle: HourCycle, min?: string, max?: string): SegmentValues;
-/**
- * Whether a `Date` falls outside `minDate`/`maxDate`, compared at the field's
- * `granularity` (a `day` field ignores time of day). String-compared via
- * {@link dateToFormValue} to match the native input's behavior.
- */
-export declare function dateRangeViolation(value: Date | null | undefined, granularity: Granularity, minDate?: Date, maxDate?: Date): RangeViolation | null;
-/** @internal Drops every memoized `Intl` result. Only needed by tests that switch locales in one process. */
-export declare function clearDateSegmentCache(): void;

package/dist/utils/dateSegments.js

@@ -1 +0,0 @@
-var e={year:"yyyy",month:"mm",day:"dd",hour:"hh",minute:"mm",second:"ss",dayPeriod:"--"},n="Empty",t={year:"year",month:"month",day:"day",hour:"hour",minute:"minute",second:"second",dayPeriod:"AM/PM"},r={year:4,month:2,day:2,hour:2,minute:2,second:2,dayPeriod:0},u={...r,month:1,day:1,hour:1},o=Date.UTC(2024,0,15,13,45,56),a=/* @__PURE__ */new Map,i=/* @__PURE__ */new Map;function s(e){return e??(new Intl.DateTimeFormat).resolvedOptions().locale}function l(e,n){if(12===n||24===n)return n;const t=new Intl.DateTimeFormat(s(e),{hour:"numeric"}).resolvedOptions(),r=t.hourCycle??(t.hour12?"h12":"h23");return"h11"===r||"h12"===r?12:24}function c(e,n){const t="date"===e?["year","month","day"]:[];return("time"===e||"day"!==n)&&(t.push("hour","minute"),"second"===n&&t.push("second")),t}function d(e,n){return e&&n?new Date(e,n,0).getDate():31}function m(e,n,t){switch(e){case"year":return{min:1,max:9999};case"month":return{min:1,max:12};case"day":return{min:1,max:d(n.year,n.month)};case"hour":return 12===t?{min:1,max:12}:{min:0,max:23};case"minute":case"second":return{min:0,max:59};case"dayPeriod":return{min:0,max:1}}}function f(e){const n=s(e),t=i.get(n);if(t)return t;const r=new Intl.DateTimeFormat(n,{hour:"numeric",hourCycle:"h12",timeZone:"UTC"}),u=e=>r.formatToParts(Date.UTC(2024,0,15,e)).find(e=>"dayPeriod"===e.type)?.value??(e<12?"AM":"PM"),o=[u(1),u(13)];return i.set(n,o),o}function y(e,n){if(1!==[...e].length)return null;const t=e.toLowerCase();if("a"===t)return 0;if("p"===t)return 1;const r=f(n),u=t=>{const r=[...t][0];return void 0!==r&&0===r.localeCompare(e,n,{sensitivity:"base"})},o=u(r[0]),a=u(r[1]);return o&&a?null:o?0:a?1:null}function h(n,t,o,a,i=!0){if(null===t)return a?.(n)??e[n];if("dayPeriod"===n)return f(o)[0===t?0:1];const s=i?r:u;return String(t).padStart(s[n],"0")}function g(e){const n=s(e.locale),t=l(n,e.hourCycle);return function(e,n,t){const r=`${e}|${n.join(",")}|${t}`,u=a.get(r);if(u)return u;const i=new Intl.DateTimeFormat(e,function(e,n){const t={timeZone:"UTC"};return e.includes("year")&&(t.year="numeric"),e.includes("month")&&(t.month="2-digit"),e.includes("day")&&(t.day="2-digit"),e.includes("hour")&&(t.hour="2-digit",t.hourCycle=12===n?"h12":"h23"),e.includes("minute")&&(t.minute="2-digit"),e.includes("second")&&(t.second="2-digit"),t}(n,t)).formatToParts(o),s=[];for(const e of i)"literal"===e.type?s.push({type:"literal",text:e.value.replace(/[\u202F\u2009\u00A0]/g," "),value:null,min:0,max:0,isPlaceholder:!1,isEditable:!1}):("dayPeriod"===e.type||n.includes(e.type))&&s.push({type:e.type,text:"",value:null,min:0,max:0,isPlaceholder:!0,isEditable:!0});return a.set(r,s),s}(n,c(e.kind,e.granularity),t).map(r=>{if(!r.isEditable)return r;const u=r.type,o=e.values[u]??null,{min:a,max:i}=m(u,e.values,t);return{type:u,text:h(u,o,n,e.getSegmentPlaceholder,e.shouldForceLeadingZeros??!0),value:o,min:a,max:i,isPlaceholder:null===o,isEditable:!0}})}function p(e,n,t){const r="second"===n?1:60;if(e!==("second"===n?"second":"minute")||void 0===t||!Number.isFinite(t)||t<=0||t%r!==0)return 1;const u=t/r;return u<60?u:1}function v(e,n,t=1){const{min:r,max:u}=e;if(null===e.value)return r+Math.floor((function(e){const n=/* @__PURE__ */new Date;switch(e.type){case"year":return n.getFullYear();case"hour":{const t=n.getHours();return 1===e.min?t%12==0?12:t%12:t}case"minute":return n.getMinutes();case"second":return n.getSeconds();case"dayPeriod":return n.getHours()<12?0:1;default:return e.min}}(e)-r)/t)*t;const o=Math.floor((u-r)/t)+1,a=e.value-r;return r+(((n>0?Math.floor(a/t):Math.ceil(a/t))+n)%o+o)%o*t}function T(e){return Math.min(Math.max(e.value??e.min,e.min),e.max)}function x(e,n,t){let r=10*n+t;r>e.max&&(r=t);const u=10*r>e.max;return{value:r,buffer:u?0:r,advance:u}}function P(e){return e.every(e=>!e.isEditable||null!==e.value&&e.value>=e.min&&e.value<=e.max)}function $(e,n,t){return 24===t?e:e%12+(1===n?12:0)}function M(e,n){return 24===n?[e,null]:[e%12==0?12:e%12,e<12?0:1]}function S(e,n){const{year:t,month:r,day:u}=e;if(!t||!r||!u)return null;const o=null==e.hour?0:$(e.hour,e.dayPeriod,n),a=new Date(t,r-1,u,o,e.minute??0,e.second??0,0);return t<100&&a.setFullYear(t),a}function b(e,n){const[t,r]=M(e.getHours(),n);return{year:e.getFullYear(),month:e.getMonth()+1,day:e.getDate(),hour:t,minute:e.getMinutes(),second:e.getSeconds(),dayPeriod:r}}function w(e,n,t){if(null==e.hour||null==e.minute||12===t&&null==e.dayPeriod)return null;const r=e=>String(e).padStart(2,"0"),u=`${r($(e.hour,e.dayPeriod,t))}:${r(e.minute)}`;return"second"!==n?u:null==e.second?null:`${u}:${r(e.second)}`}function D(e,n){const t=/^(\d{1,2}):(\d{2})(?::(\d{2}))?$/.exec(e.trim());if(!t)return{};const r=Number(t[1]),u=Number(t[2]),o=void 0===t[3]?0:Number(t[3]);if(r>23||u>59||o>59)return{};const[a,i]=M(r,n);return{hour:a,minute:u,second:o,dayPeriod:i}}function F(e,n){const t=(e,n=2)=>String(e).padStart(n,"0"),r=`${t(e.getFullYear(),4)}-${t(e.getMonth()+1)}-${t(e.getDate())}`;if("day"===n)return r;const u=`${t(e.getHours())}:${t(e.getMinutes())}`;return"second"===n?`${r}T${u}:${t(e.getSeconds())}`:`${r}T${u}`}function N(e){const n=/^(\d{4,})-(\d{2})-(\d{2})(?:T(\d{2}):(\d{2})(?::(\d{2}))?)?$/.exec(e.trim());if(!n)return null;const t=Number(n[1]),r=new Date(t,Number(n[2])-1,Number(n[3]),Number(n[4]??0),Number(n[5]??0),Number(n[6]??0));return t<100&&r.setFullYear(t),Number.isNaN(r.getTime())?null:r}function E(e){const n=/^(\d{1,2}):(\d{2})(?::(\d{2}))?$/.exec(e.trim());if(!n)return null;const t=e=>e.padStart(2,"0");return`${t(n[1])}:${n[2]}:${t(n[3]??"00")}`}function C(e,n,t){if(!e)return null;const r=E(e);if(null===r)return null;const u=n?E(n):null;if(null!==u&&r<u)return"underflow";const o=t?E(t):null;return null!==o&&r>o?"overflow":null}function V(e,n,t,r,u){const o=C(w(e,n,t),r,u);return null===o?e:{...e,...D("underflow"===o?r:u,t)}}function H(e,n,t,r){if(!e)return null;const u=F(e,n);return t&&u<F(t,n)?"underflow":r&&u>F(r,n)?"overflow":null}export{n as EMPTY_VALUE_TEXT,t as SEGMENT_LABELS,e as SEGMENT_PLACEHOLDERS,g as buildSegments,V as clampValuesToTimeRange,H as dateRangeViolation,F as dateToFormValue,b as dateToValues,y as dayPeriodFromKey,d as daysInMonth,h as formatSegmentText,M as from24Hour,f as getDayPeriodNames,P as isComplete,N as parseDateFormValue,l as resolveHourCycle,s as resolveLocale,m as segmentRange,p as segmentStepFor,c as segmentTypesFor,T as segmentValueNow,v as stepSegment,C as timeRangeViolation,D as timeStringToValues,$ as to24Hour,x as typeDigit,S as valuesToDate,w as valuesToTimeString};

package/dist/utils/dateValue.cjs

@@ -1 +0,0 @@
-const D=require("./is-dev-mode.cjs"),m=require("./dateSegments.cjs");var g=/^(\d{4,})-(\d{2})$/,N=/^(\d{4,}-\d{2}-\d{2})/,c=!1;function d(r,e){c||(c=!0,D.isDevMode()&&console.warn(`[skdx] ${e?`\`${e}\``:"A date property"} was given ${JSON.stringify(r)}, which is not an ISO-8601 date. Expected \`YYYY-MM-DD\`, \`YYYY-MM-DDTHH:mm[:ss]\`, or a bare \`YYYY-MM\` for a month. The value is ignored — the property behaves as if it had not been supplied — rather than being coerced to today, to the epoch, or to an \`Invalid Date\` that would then poison every comparison after it.`))}function l(r,e){if(r==null)return null;if(r instanceof Date)return Number.isNaN(r.getTime())?null:r;if(typeof r!="string")return null;const t=r.trim();if(t==="")return null;const n=m.parseDateFormValue(t);if(n!==null){const i=N.exec(t)?.[1];return i!==void 0&&u(n)!==i?(d(t,e),null):n}const a=g.exec(t);if(a){const i=Number(a[2])-1;if(i>=0&&i<=11){const o=Number(a[1]),f=new Date(o,i,1);if(o<100&&f.setFullYear(o),!Number.isNaN(f.getTime()))return f}}return d(t,e),null}function u(r,e="day"){return m.dateToFormValue(r,e)}function h(r,e,t){if(r===void 0)return;if(r===null)return e==="multiple"?[]:null;if(typeof r=="string")return s(y(r,t),e);if(Array.isArray(r))return s(r.map(i=>l(i,t)).filter(i=>i!==null),e);if(r instanceof Date)return s(l(r,t),e);const n=r,a=l(n.start,t);return a===null?e==="multiple"?[]:null:{start:a,end:l(n.end,t)}}function s(r,e){return e!=="multiple"?r:r===null?[]:Array.isArray(r)?r:r instanceof Date?[r]:[]}function y(r,e){const t=r.trim();if(t==="")return null;if(t.includes("/")){const[n="",a=""]=t.split("/"),i=l(n,e);return i===null?null:{start:i,end:a===""?null:l(a,e)}}return t.includes(",")?t.split(",").map(n=>l(n,e)).filter(n=>n!==null):l(t,e)}function Y(r){return r==null?null:Array.isArray(r)?r.length===0?null:r.map(e=>u(e)).join(","):r instanceof Date?u(r):`${u(r.start)}/${r.end===null?"":u(r.end)}`}var b=/^(\d{1,2}):(\d{2})(?::(\d{2}))?$/;function M(r,e){if(r==null)return null;if(r instanceof Date){if(Number.isNaN(r.getTime()))return null;const a=f=>String(f).padStart(2,"0"),i=r.getSeconds(),o=`${a(r.getHours())}:${a(r.getMinutes())}`;return i===0?o:`${o}:${a(i)}`}if(typeof r!="string")return null;const t=r.trim();if(t==="")return null;const n=b.exec(t);return!n||Number(n[1])>23||Number(n[2])>59||n[3]!==void 0&&Number(n[3])>59?(d(t,e),null):t}exports.toCalendarString=Y;exports.toCalendarValue=h;exports.toDate=l;exports.toISODateValue=u;exports.toTimeValue=M;

package/dist/utils/dateValue.d.cts

@@ -1,76 +0,0 @@
-/**
- * Date type-crossing layer for Calendar, DateField, DatePicker, TimeField.
- * Accepts native `Date` or ISO-8601 string, emits `Date` shape, treats ISO
- * string as canonical for persistence (required for HTML attributes and
- * eventual `Temporal` migration). Copied identically across all five packages.
- *
- * @see `@skdx/shared`'s `contracts/date-value.ts`
- */
-import { type Granularity } from './dateSegments.cjs';
-/** Anything a date-shaped member accepts: the native object, or its ISO-8601 wire form. */
-export type DateInput = Date | string;
-/** A date range, structurally identical to Calendar's own `DateRange`. */
-export interface DateRangeLike {
-    start: Date;
-    end: Date | null;
-}
-/** What {@link toCalendarValue} produces — the `Date`-shaped selection every framework emits. */
-export type DateValue = Date | Date[] | DateRangeLike | null;
-/** How many dates a selection holds, deciding how a wire string widens. */
-export type SelectionModeLike = 'single' | 'multiple' | 'range';
-/** @internal Puts {@link toDate}'s malformed-input warning back to "not yet warned". Only needed by tests. */
-export declare function resetMalformedDateWarning(): void;
-/**
- * Reads a consumer-supplied value into a local `Date` or `null`. `Date` passes
- * through untouched (`Invalid Date` → `null`). Strings are parsed field-by-field
- * in local time (never via `new Date(string)`, which reads `YYYY-MM-DD` as UTC
- * and shifts the date west of Greenwich). Invalid shapes → `null` + dev warning.
- *
- * @param input a `Date`, an ISO-8601 string, or `null`/`undefined`
- * @param source the property it arrived on, named in the warning
- * @returns the local calendar date, or `null` when unreadable
- */
-export declare function toDate(input: DateInput | null | undefined, source?: string): Date | null;
-/**
- * The canonical ISO-8601 string for a date — what to persist and what `<form>` submits.
- * Uses local wall-clock fields (not `toISOString`, which would shift dates
- * across the date line for half the planet).
- *
- * @param date the local date to render
- * @param granularity how much of the time of day to include
- * @returns `YYYY-MM-DD`, or `YYYY-MM-DDTHH:mm[:ss]` past `day`
- */
-export declare function toISODateValue(date: Date, granularity?: Granularity): string;
-/**
- * Reads any authored selection shape into the canonical `DateValue`. Wire
- * string is self-describing: `2026-08-10` (single), `2026-08-10,2026-08-14`
- * (set), `2026-08-10/2026-08-14` or `2026-08-10/` (range). Only exception:
- * single-date `multiple` selection, widened via `mode`. `undefined` preserved
- * to distinguish controlled from uncontrolled.
- *
- * @param input the authored selection, in any accepted form
- * @param mode how many dates the selection holds
- * @param source the property it arrived on, named in the warning
- */
-export declare function toCalendarValue(input: DateInput | ReadonlyArray<DateInput> | {
-    start: DateInput;
-    end?: DateInput | null;
-} | null | undefined, mode: SelectionModeLike, source?: string): DateValue | undefined;
-/**
- * The canonical wire string for a selection — what `value` takes as an
- * attribute and what consumers persist.
- *
- * @param value a selection in the `Date` shape
- * @returns the string, or `null` when nothing is selected
- */
-export declare function toCalendarString(value: DateValue | undefined): string | null;
-/**
- * Reads a time of day from a 24-hour string or a `Date`'s local wall-clock time.
- * `Date` part is discarded (time of day is not an instant). Accepts `Date` to
- * avoid conversion overhead in DatePicker compositions.
- *
- * @param input a `HH:mm[:ss]` string, a `Date`, or `null`/`undefined`
- * @param source the property it arrived on, named in the warning
- * @returns the 24-hour string, or `null` when unreadable
- */
-export declare function toTimeValue(input: Date | string | null | undefined, source?: string): string | null;