@skdx/react 0.28.0 → 0.30.0

package/dist/utils/createContext.d.ts

@@ -1,10 +1,6 @@
 import * as React from 'react';
 /**
- * Creates a scoped `[Provider, useContext]` pair for a compound component's
- * internal state (e.g. `Tabs`'s selected value, shared with `TabsTrigger`
- * and `TabsContent`). Unlike raw `React.createContext`, the returned
- * `useContext(consumerName)` throws a descriptive error instead of silently
- * returning `undefined` when a part is rendered outside its root.
+ * Creates a scoped `[Provider, useContext]` pair for a compound component's internal state, whose `useContext(consumerName)` throws a descriptive error instead of silently returning `undefined` outside its root.
  *
  * @param rootComponentName - Name of the root component, used in the Provider's `displayName` and in error messages.
  * @param defaultValue - Optional fallback so the context also works without a Provider (rare; most compound components require one).
@@ -20,10 +16,13 @@ import * as React from 'react';
  * // in TabsTrigger.tsx
  * const context = useTabsContext('TabsTrigger'); // throws "`TabsTrigger` must be used within `Tabs`." if misused
  * ```
+ *
+ * @internal Not part of the public API; import it inside the package only.
  */
-export declare function createSafeContext<ContextValue extends object | null>(rootComponentName: string, defaultValue?: ContextValue): readonly [{
-    (props: ContextValue & {
+export declare function createSafeContext<ContextValue extends object | null>(rootComponentName: string, defaultValue?: ContextValue): readonly [
+    React.FC<ContextValue & {
         children: React.ReactNode;
-    }): React.JSX.Element;
-    displayName: string;
-}, (consumerName: string) => ContextValue, () => ContextValue | undefined];
+    }>,
+    (consumerName: string) => ContextValue,
+    () => ContextValue | undefined
+];

package/dist/utils/createContext.js

@@ -1 +1,2 @@
-import*as t from"react";import{jsx as f}from"react/jsx-runtime";function x(o,e){let n=Object.keys(o);return n.length!==Object.keys(e).length?!1:n.every(r=>r in e&&Object.is(o[r],e[r]))}function l(o,e){let n=t.createContext(e);function r(s){let{children:c,...i}=s,u=t.useRef(i);return x(u.current,i)||(u.current=i),f(n.Provider,{value:u.current,children:c})}r.displayName=`${o}Provider`;function a(s){let c=t.useContext(n);if(c!==void 0)return c;if(e!==void 0)return e;throw new Error(`[skandadx] \`${s}\` must be used within \`${o}\`.`)}function d(){return t.useContext(n)??e}return[r,a,d]}export{l as createSafeContext};
+'use client';
+import*as t from"react";import{jsx as l}from"react/jsx-runtime";function x(o,e){let n=Object.keys(o);return n.length!==Object.keys(e).length?!1:n.every(r=>r in e&&Object.is(o[r],e[r]))}function C(o,e){let n=t.createContext(e);function r(u){let{children:c,...s}=u,i=t.useRef(s);return x(i.current,s)||(i.current=s),l(n.Provider,{value:i.current,children:c})}r.displayName=`${o}Provider`;function a(u){let c=t.useContext(n);if(c!==void 0)return c;if(e!==void 0)return e;throw new Error(`[skandadx] \`${u}\` must be used within \`${o}\`.`)}function d(){return t.useContext(n)??e}return[r,a,d]}export{C as createSafeContext};

package/dist/utils/date-segments.cjs

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

package/dist/utils/{dateSegments.d.ts → date-segments.d.cts}

@@ -1,8 +1,3 @@
-/**
- * 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'). */
@@ -30,7 +25,29 @@ export interface Segment {
 }
 /** Default placeholder text; unreachable by Intl and untranslatable by locale. */
 export declare const SEGMENT_PLACEHOLDERS: Record<SegmentType, string>;
-/** The runtime's own locale, used whenever `locale` is omitted — matches `calendar/locale`'s `resolveLocale`. */
+/** 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 names for each segment type. */
+export declare const SEGMENT_LABELS: Record<SegmentType, string>;
+/** Localization strings for segmented date/time fields. */
+export interface SegmentedLabelProps {
+    /**
+     * Words the accessible name of each segment type.
+     * @default undefined — the built-in English names ('year', 'month', 'AM/PM', …).
+     */
+    getSegmentLabel?: ((type: SegmentType) => string | undefined) | undefined;
+    /**
+     * Aria text for untyped segments.
+     * @default 'Empty'
+     */
+    emptySegmentText?: string | undefined;
+    /**
+     * Words the placeholder for each segment.
+     * @default undefined — the built-in English letters ('yyyy', 'mm', 'dd', …).
+     */
+    getSegmentPlaceholder?: SegmentPlaceholderResolver | undefined;
+}
+/** 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
@@ -44,9 +61,7 @@ export declare function resolveLocale(locale?: string): string;
  */
 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.
+ * 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
@@ -66,10 +81,7 @@ export declare function segmentRange(type: SegmentType, values: SegmentValues, h
 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;
-/**
- * Words the placeholder of one segment type. Return the built-in
- * {@link SEGMENT_PLACEHOLDERS} entry for the types you do not want to change.
- */
+/** Words the placeholder of one segment type; return the built-in {@link SEGMENT_PLACEHOLDERS} entry for the types you do not want to change. */
 export type SegmentPlaceholderResolver = (type: SegmentType) => string;
 /**
  * How a segment renders: zero-padded digits, the locale's AM/PM name, or the
@@ -86,19 +98,19 @@ export interface BuildSegmentsOptions {
     /** How far down the field is editable. */
     granularity: Granularity;
     /** BCP-47 locale deciding segment order, literals and AM/PM names. */
-    locale?: string;
+    locale?: string | undefined;
     /** Forced hour cycle; omitted means "whatever the locale uses". */
-    hourCycle?: HourCycle;
+    hourCycle?: HourCycle | undefined;
     /** Current per-segment values. */
     values: SegmentValues;
     /** Words each segment's placeholder; omitted keeps the built-in English letters. */
-    getSegmentPlaceholder?: SegmentPlaceholderResolver;
+    getSegmentPlaceholder?: SegmentPlaceholderResolver | undefined;
     /**
      * 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;
+    shouldForceLeadingZeros?: boolean | undefined;
 }
 /**
  * The full ordered render list for a segmented field — editable segments
@@ -113,10 +125,7 @@ export interface BuildSegmentsOptions {
  */
 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.
+ * How many units one Arrow press moves a segment, given the field-level `step` in seconds; drives only the finest rendered segment, falling back to `1` when `step` doesn't fit the grid.
  *
  * @example
  * ```ts
@@ -126,25 +135,11 @@ export declare function buildSegments(options: BuildSegmentsOptions): Segment[];
  */
 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.
- *
+ * Stepper one segment by `delta`, wrapping around its range, snapping onto the `step` grid like a native stepper when `step` is past 1.
  * @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.
- */
+/** The `aria-valuenow` a segment publishes: its current value pulled back inside its own `aria-valuemin`/`aria-valuemax`, since mid-entry it can legitimately sit below minimum. */
 export declare function segmentValueNow(segment: Segment): number;
 /** The result of typing one digit into a segment. */
 export interface DigitEntry {
@@ -156,10 +151,7 @@ export interface DigitEntry {
     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.
+ * Types one digit into a segment: an overflowing keystroke restarts entry at that digit instead of being rejected, and focus advances once no further digit could fit.
  *
  * @param segment the segment being typed into
  * @param buffer what has been typed into it so far (`0` when entry just started)
@@ -197,10 +189,7 @@ export declare function timeStringToValues(time: string, hourCycle: HourCycle):
 /** 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.
+ * The inverse of {@link dateToFormValue}, built field by field rather than `new Date(string)`, which reads a bare `YYYY-MM-DD` as UTC midnight.
  *
  * @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
@@ -219,26 +208,16 @@ export type RangeViolation = 'underflow' | 'overflow';
  */
 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.)
+ * 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.
  *
  * @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.
- */
+/** 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.
- */
+/** 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. */
+/** @internal Drops every memoized `Intl` result. */
 export declare function clearDateSegmentCache(): void;

package/dist/utils/{dateSegments.d.cts → date-segments.d.ts}

@@ -1,8 +1,3 @@
-/**
- * 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'). */
@@ -30,7 +25,29 @@ export interface Segment {
 }
 /** Default placeholder text; unreachable by Intl and untranslatable by locale. */
 export declare const SEGMENT_PLACEHOLDERS: Record<SegmentType, string>;
-/** The runtime's own locale, used whenever `locale` is omitted — matches `calendar/locale`'s `resolveLocale`. */
+/** 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 names for each segment type. */
+export declare const SEGMENT_LABELS: Record<SegmentType, string>;
+/** Localization strings for segmented date/time fields. */
+export interface SegmentedLabelProps {
+    /**
+     * Words the accessible name of each segment type.
+     * @default undefined — the built-in English names ('year', 'month', 'AM/PM', …).
+     */
+    getSegmentLabel?: ((type: SegmentType) => string | undefined) | undefined;
+    /**
+     * Aria text for untyped segments.
+     * @default 'Empty'
+     */
+    emptySegmentText?: string | undefined;
+    /**
+     * Words the placeholder for each segment.
+     * @default undefined — the built-in English letters ('yyyy', 'mm', 'dd', …).
+     */
+    getSegmentPlaceholder?: SegmentPlaceholderResolver | undefined;
+}
+/** 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
@@ -44,9 +61,7 @@ export declare function resolveLocale(locale?: string): string;
  */
 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.
+ * 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
@@ -66,10 +81,7 @@ export declare function segmentRange(type: SegmentType, values: SegmentValues, h
 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;
-/**
- * Words the placeholder of one segment type. Return the built-in
- * {@link SEGMENT_PLACEHOLDERS} entry for the types you do not want to change.
- */
+/** Words the placeholder of one segment type; return the built-in {@link SEGMENT_PLACEHOLDERS} entry for the types you do not want to change. */
 export type SegmentPlaceholderResolver = (type: SegmentType) => string;
 /**
  * How a segment renders: zero-padded digits, the locale's AM/PM name, or the
@@ -86,19 +98,19 @@ export interface BuildSegmentsOptions {
     /** How far down the field is editable. */
     granularity: Granularity;
     /** BCP-47 locale deciding segment order, literals and AM/PM names. */
-    locale?: string;
+    locale?: string | undefined;
     /** Forced hour cycle; omitted means "whatever the locale uses". */
-    hourCycle?: HourCycle;
+    hourCycle?: HourCycle | undefined;
     /** Current per-segment values. */
     values: SegmentValues;
     /** Words each segment's placeholder; omitted keeps the built-in English letters. */
-    getSegmentPlaceholder?: SegmentPlaceholderResolver;
+    getSegmentPlaceholder?: SegmentPlaceholderResolver | undefined;
     /**
      * 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;
+    shouldForceLeadingZeros?: boolean | undefined;
 }
 /**
  * The full ordered render list for a segmented field — editable segments
@@ -113,10 +125,7 @@ export interface BuildSegmentsOptions {
  */
 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.
+ * How many units one Arrow press moves a segment, given the field-level `step` in seconds; drives only the finest rendered segment, falling back to `1` when `step` doesn't fit the grid.
  *
  * @example
  * ```ts
@@ -126,25 +135,11 @@ export declare function buildSegments(options: BuildSegmentsOptions): Segment[];
  */
 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.
- *
+ * Stepper one segment by `delta`, wrapping around its range, snapping onto the `step` grid like a native stepper when `step` is past 1.
  * @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.
- */
+/** The `aria-valuenow` a segment publishes: its current value pulled back inside its own `aria-valuemin`/`aria-valuemax`, since mid-entry it can legitimately sit below minimum. */
 export declare function segmentValueNow(segment: Segment): number;
 /** The result of typing one digit into a segment. */
 export interface DigitEntry {
@@ -156,10 +151,7 @@ export interface DigitEntry {
     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.
+ * Types one digit into a segment: an overflowing keystroke restarts entry at that digit instead of being rejected, and focus advances once no further digit could fit.
  *
  * @param segment the segment being typed into
  * @param buffer what has been typed into it so far (`0` when entry just started)
@@ -197,10 +189,7 @@ export declare function timeStringToValues(time: string, hourCycle: HourCycle):
 /** 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.
+ * The inverse of {@link dateToFormValue}, built field by field rather than `new Date(string)`, which reads a bare `YYYY-MM-DD` as UTC midnight.
  *
  * @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
@@ -219,26 +208,16 @@ export type RangeViolation = 'underflow' | 'overflow';
  */
 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.)
+ * 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.
  *
  * @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.
- */
+/** 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.
- */
+/** 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. */
+/** @internal Drops every memoized `Intl` result. */
 export declare function clearDateSegmentCache(): void;

package/dist/utils/date-segments.js

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

package/dist/utils/date-value.cjs

@@ -0,0 +1,2 @@
+'use client';
+"use strict";var d=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var h=(e,n)=>{for(var t in n)d(e,t,{get:n[t],enumerable:!0})},N=(e,n,t,r)=>{if(n&&typeof n=="object"||typeof n=="function")for(let a of p(n))!y.call(e,a)&&a!==t&&d(e,a,{get:()=>n[a],enumerable:!(r=g(n,a))||r.enumerable});return e};var x=e=>N(d({},"__esModule",{value:!0}),e);var L={};h(L,{resetMalformedDateWarning:()=>Y,toCalendarString:()=>$,toCalendarValue:()=>A,toDate:()=>i,toISODateValue:()=>o,toTimeValue:()=>V});module.exports=x(L);var s=require("./date-segments.cjs"),M=/^(\d{4,})-(\d{2})$/,I=/^(\d{4,}-\d{2}-\d{2})/,D=!1;function Y(){D=!1}function c(e,n){D||(D=!0,console.warn(`[skdx] ${n?`\`${n}\``:"A date property"} was given ${JSON.stringify(e)}, 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 \u2014 the property behaves as if it had not been supplied \u2014 rather than being coerced to today, to the epoch, or to an \`Invalid Date\` that would then poison every comparison after it.`))}function i(e,n){if(e==null)return null;if(e instanceof Date)return Number.isNaN(e.getTime())?null:e;if(typeof e!="string")return null;let t=e.trim();if(t==="")return null;let r=(0,s.parseDateFormValue)(t);if(r!==null){let l=I.exec(t)?.[1];return l!==void 0&&o(r)!==l?(c(t,n),null):r}let a=b(t);return a||(c(t,n),null)}function b(e){let n=M.exec(e);if(!n)return null;let t=Number(n[2])-1;if(t<0||t>11)return null;let r=Number(n[1]),a=new Date(r,t,1);return r<100&&a.setFullYear(r),Number.isNaN(a.getTime())?null:a}function o(e,n="day"){return(0,s.dateToFormValue)(e,n)}function A(e,n,t){if(e===void 0)return;if(e===null)return n==="multiple"?[]:null;if(typeof e=="string"){let l=S(e,t);return f(l,n)}if(Array.isArray(e)){let l=e.map(u=>i(u,t)).filter(u=>u!==null);return f(l,n)}if(e instanceof Date)return f(i(e,t),n);let r=e,a=i(r.start,t);return a===null?n==="multiple"?[]:null:{start:a,end:i(r.end,t)}}function f(e,n){return n!=="multiple"?e:e===null?[]:Array.isArray(e)?e:e instanceof Date?[e]:[]}function S(e,n){let t=e.trim();if(t==="")return null;if(t.includes("/")){let[r="",a=""]=t.split("/"),l=i(r,n);return l===null?null:{start:l,end:a===""?null:i(a,n)}}return t.includes(",")?t.split(",").map(r=>i(r,n)).filter(r=>r!==null):i(t,n)}function $(e){return e==null?null:Array.isArray(e)?e.length===0?null:e.map(n=>o(n)).join(","):e instanceof Date?o(e):`${o(e.start)}/${e.end===null?"":o(e.end)}`}var T=/^(\d{1,2}):(\d{2})(?::(\d{2}))?$/;function V(e,n){if(e==null)return null;if(e instanceof Date){if(Number.isNaN(e.getTime()))return null;let a=m=>String(m).padStart(2,"0"),l=e.getSeconds(),u=`${a(e.getHours())}:${a(e.getMinutes())}`;return l===0?u:`${u}:${a(l)}`}if(typeof e!="string")return null;let t=e.trim();if(t==="")return null;let r=T.exec(t);return!r||Number(r[1])>23||Number(r[2])>59||r[3]!==void 0&&Number(r[3])>59?(c(t,n),null):t}0&&(module.exports={resetMalformedDateWarning,toCalendarString,toCalendarValue,toDate,toISODateValue,toTimeValue});

package/dist/utils/{dateValue.d.ts → date-value.d.cts}

@@ -1,12 +1,4 @@
-/**
- * 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.js';
+import { type Granularity } from './date-segments.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`. */
@@ -18,13 +10,10 @@ export interface DateRangeLike {
 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. */
+/** @internal Puts {@link toDate}'s malformed-input warning back to "not yet warned". */
 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.
+ * Reads a consumer-supplied value into a local `Date` or `null`, parsing strings field-by-field (never via `new Date(string)`, which reads `YYYY-MM-DD` as UTC) and warning in dev on invalid shapes.
  *
  * @param input a `Date`, an ISO-8601 string, or `null`/`undefined`
  * @param source the property it arrived on, named in the warning
@@ -32,9 +21,7 @@ export declare function resetMalformedDateWarning(): void;
  */
 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).
+ * The canonical ISO-8601 string for a date — what to persist and what `<form>` submits — using local wall-clock fields, not `toISOString`, which would shift dates across the date line.
  *
  * @param date the local date to render
  * @param granularity how much of the time of day to include
@@ -42,11 +29,7 @@ export declare function toDate(input: DateInput | null | undefined, source?: str
  */
 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.
+ * Reads any authored selection shape into the canonical `DateValue`; the wire string is self-describing except for a single-date `multiple` selection, widened via `mode`.
  *
  * @param input the authored selection, in any accepted form
  * @param mode how many dates the selection holds
@@ -54,7 +37,7 @@ export declare function toISODateValue(date: Date, granularity?: Granularity): s
  */
 export declare function toCalendarValue(input: DateInput | ReadonlyArray<DateInput> | {
     start: DateInput;
-    end?: DateInput | null;
+    end?: DateInput | null | undefined;
 } | null | undefined, mode: SelectionModeLike, source?: string): DateValue | undefined;
 /**
  * The canonical wire string for a selection — what `value` takes as an
@@ -65,9 +48,7 @@ export declare function toCalendarValue(input: DateInput | ReadonlyArray<DateInp
  */
 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.
+ * Reads a time of day from a 24-hour string or a `Date`'s local wall-clock time, discarding the date part since time of day is not an instant.
  *
  * @param input a `HH:mm[:ss]` string, a `Date`, or `null`/`undefined`
  * @param source the property it arrived on, named in the warning

package/dist/utils/{dateValue.d.cts → date-value.d.ts}

@@ -1,12 +1,4 @@
-/**
- * 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';
+import { type Granularity } from './date-segments.js';
 /** 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`. */
@@ -18,13 +10,10 @@ export interface DateRangeLike {
 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. */
+/** @internal Puts {@link toDate}'s malformed-input warning back to "not yet warned". */
 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.
+ * Reads a consumer-supplied value into a local `Date` or `null`, parsing strings field-by-field (never via `new Date(string)`, which reads `YYYY-MM-DD` as UTC) and warning in dev on invalid shapes.
  *
  * @param input a `Date`, an ISO-8601 string, or `null`/`undefined`
  * @param source the property it arrived on, named in the warning
@@ -32,9 +21,7 @@ export declare function resetMalformedDateWarning(): void;
  */
 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).
+ * The canonical ISO-8601 string for a date — what to persist and what `<form>` submits — using local wall-clock fields, not `toISOString`, which would shift dates across the date line.
  *
  * @param date the local date to render
  * @param granularity how much of the time of day to include
@@ -42,11 +29,7 @@ export declare function toDate(input: DateInput | null | undefined, source?: str
  */
 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.
+ * Reads any authored selection shape into the canonical `DateValue`; the wire string is self-describing except for a single-date `multiple` selection, widened via `mode`.
  *
  * @param input the authored selection, in any accepted form
  * @param mode how many dates the selection holds
@@ -54,7 +37,7 @@ export declare function toISODateValue(date: Date, granularity?: Granularity): s
  */
 export declare function toCalendarValue(input: DateInput | ReadonlyArray<DateInput> | {
     start: DateInput;
-    end?: DateInput | null;
+    end?: DateInput | null | undefined;
 } | null | undefined, mode: SelectionModeLike, source?: string): DateValue | undefined;
 /**
  * The canonical wire string for a selection — what `value` takes as an
@@ -65,9 +48,7 @@ export declare function toCalendarValue(input: DateInput | ReadonlyArray<DateInp
  */
 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.
+ * Reads a time of day from a 24-hour string or a `Date`'s local wall-clock time, discarding the date part since time of day is not an instant.
  *
  * @param input a `HH:mm[:ss]` string, a `Date`, or `null`/`undefined`
  * @param source the property it arrived on, named in the warning

package/dist/utils/date-value.js

@@ -0,0 +1,2 @@
+'use client';
+import{dateToFormValue as c,parseDateFormValue as m}from"./date-segments.js";var g=/^(\d{4,})-(\d{2})$/,p=/^(\d{4,}-\d{2}-\d{2})/,d=!1;function M(){d=!1}function f(e,n){d||(d=!0,console.warn(`[skdx] ${n?`\`${n}\``:"A date property"} was given ${JSON.stringify(e)}, 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 \u2014 the property behaves as if it had not been supplied \u2014 rather than being coerced to today, to the epoch, or to an \`Invalid Date\` that would then poison every comparison after it.`))}function i(e,n){if(e==null)return null;if(e instanceof Date)return Number.isNaN(e.getTime())?null:e;if(typeof e!="string")return null;let t=e.trim();if(t==="")return null;let r=m(t);if(r!==null){let l=p.exec(t)?.[1];return l!==void 0&&o(r)!==l?(f(t,n),null):r}let a=y(t);return a||(f(t,n),null)}function y(e){let n=g.exec(e);if(!n)return null;let t=Number(n[2])-1;if(t<0||t>11)return null;let r=Number(n[1]),a=new Date(r,t,1);return r<100&&a.setFullYear(r),Number.isNaN(a.getTime())?null:a}function o(e,n="day"){return c(e,n)}function I(e,n,t){if(e===void 0)return;if(e===null)return n==="multiple"?[]:null;if(typeof e=="string"){let l=h(e,t);return s(l,n)}if(Array.isArray(e)){let l=e.map(u=>i(u,t)).filter(u=>u!==null);return s(l,n)}if(e instanceof Date)return s(i(e,t),n);let r=e,a=i(r.start,t);return a===null?n==="multiple"?[]:null:{start:a,end:i(r.end,t)}}function s(e,n){return n!=="multiple"?e:e===null?[]:Array.isArray(e)?e:e instanceof Date?[e]:[]}function h(e,n){let t=e.trim();if(t==="")return null;if(t.includes("/")){let[r="",a=""]=t.split("/"),l=i(r,n);return l===null?null:{start:l,end:a===""?null:i(a,n)}}return t.includes(",")?t.split(",").map(r=>i(r,n)).filter(r=>r!==null):i(t,n)}function Y(e){return e==null?null:Array.isArray(e)?e.length===0?null:e.map(n=>o(n)).join(","):e instanceof Date?o(e):`${o(e.start)}/${e.end===null?"":o(e.end)}`}var N=/^(\d{1,2}):(\d{2})(?::(\d{2}))?$/;function b(e,n){if(e==null)return null;if(e instanceof Date){if(Number.isNaN(e.getTime()))return null;let a=D=>String(D).padStart(2,"0"),l=e.getSeconds(),u=`${a(e.getHours())}:${a(e.getMinutes())}`;return l===0?u:`${u}:${a(l)}`}if(typeof e!="string")return null;let t=e.trim();if(t==="")return null;let r=N.exec(t);return!r||Number(r[1])>23||Number(r[2])>59||r[3]!==void 0&&Number(r[3])>59?(f(t,n),null):t}export{M as resetMalformedDateWarning,Y as toCalendarString,I as toCalendarValue,i as toDate,o as toISODateValue,b as toTimeValue};

package/dist/utils/declaredChildren.cjs

@@ -1 +1,2 @@
-"use strict";var i=Object.create;var c=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var R=Object.getOwnPropertyNames;var f=Object.getPrototypeOf,l=Object.prototype.hasOwnProperty;var u=(e,t)=>{for(var a in t)c(e,a,{get:t[a],enumerable:!0})},d=(e,t,a,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of R(t))!l.call(e,o)&&o!==a&&c(e,o,{get:()=>t[o],enumerable:!(n=p(t,o))||n.enumerable});return e};var m=(e,t,a)=>(a=e!=null?i(f(e)):{},d(t||!e||!e.__esModule?c(a,"default",{value:e,enumerable:!0}):a,e)),g=e=>d(c({},"__esModule",{value:!0}),e);var N={};u(N,{forEachDeclaredElement:()=>s,hasDeclaredChild:()=>y});module.exports=g(N);var r=m(require("react"),1);function s(e,t){r.Children.forEach(e,a=>{if(!r.isValidElement(a))return;let n=a.props;if(a.type===r.Fragment||typeof a.type=="string"){s(n.children,t);return}t(a.type.displayName,n),s(n.children,t)})}function y(e,t){let a=!1;return s(e,n=>{n===t&&(a=!0)}),a}0&&(module.exports={forEachDeclaredElement,hasDeclaredChild});
+'use client';
+"use strict";var i=Object.create;var c=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var R=Object.getOwnPropertyNames;var f=Object.getPrototypeOf,l=Object.prototype.hasOwnProperty;var u=(e,t)=>{for(var a in t)c(e,a,{get:t[a],enumerable:!0})},s=(e,t,a,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of R(t))!l.call(e,o)&&o!==a&&c(e,o,{get:()=>t[o],enumerable:!(n=p(t,o))||n.enumerable});return e};var m=(e,t,a)=>(a=e!=null?i(f(e)):{},s(t||!e||!e.__esModule?c(a,"default",{value:e,enumerable:!0}):a,e)),g=e=>s(c({},"__esModule",{value:!0}),e);var N={};u(N,{forEachDeclaredElement:()=>d,hasDeclaredChild:()=>y});module.exports=g(N);var r=m(require("react"),1);function d(e,t){r.Children.forEach(e,a=>{if(!r.isValidElement(a))return;let n=a.props;if(a.type===r.Fragment||typeof a.type=="string"){d(n.children,t);return}t(a.type.displayName,n),d(n.children,t)})}function y(e,t){let a=!1;return d(e,n=>{n===t&&(a=!0)}),a}0&&(module.exports={forEachDeclaredElement,hasDeclaredChild});