@trsys-tech/matrix-library 1.0.2 → 1.1.0

package/dist/components/date-picker/DatePicker.d.ts

@@ -1,7 +1,30 @@
 import { default as React } from 'react';
 import { DesktopDatePicker, DesktopDatePickerProps } from './DesktopDatePicker';
 import { MobileDatePicker, MobileDatePickerProps } from './MobileDatePicker';
+import { DateOnlyString, DateValue } from './dateValue';
+/**
+ * Props for the responsive single-date picker.
+ *
+ * Inherits the desktop and mobile single-date picker props and keeps the same
+ * public value contract: pass a Date or a YYYY-MM-DD string to selected and
+ * receive a YYYY-MM-DD string from onSelect.
+ */
 type DatePickerProps = DesktopDatePickerProps & MobileDatePickerProps & {};
+/**
+ * Responsive single-date picker.
+ *
+ * Renders the mobile dialog picker on mobile screens and the desktop popover
+ * picker on larger screens.
+ *
+ * @example
+ * const [invoiceDate, setInvoiceDate] = React.useState<string | undefined>("2025-12-24");
+ *
+ * <DatePicker
+ *   selected={invoiceDate}
+ *   onSelect={setInvoiceDate}
+ *   placeholder="Pick an invoice date"
+ * />
+ */
 declare const DatePicker: React.FC<DatePickerProps>;
-export { DatePicker, DesktopDatePicker, MobileDatePicker, type DatePickerProps, type DesktopDatePickerProps, type MobileDatePickerProps };
+export { DatePicker, DesktopDatePicker, MobileDatePicker, type DatePickerProps, type DesktopDatePickerProps, type MobileDatePickerProps, type DateOnlyString, type DateValue, };
 //# sourceMappingURL=DatePicker.d.ts.map

package/dist/components/date-picker/DatePicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DatePicker.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/DatePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAG7E,KAAK,eAAe,GAAG,sBAAsB,GAAG,qBAAqB,GAAG,EAAE,CAAC;AAE3E,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAIzC,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,sBAAsB,EAAE,KAAK,qBAAqB,EAAE,CAAC"}
+{"version":3,"file":"DatePicker.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/DatePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAGlE;;;;;;GAMG;AACH,KAAK,eAAe,GAAG,sBAAsB,GAAG,qBAAqB,GAAG,EAAE,CAAC;AAE3E;;;;;;;;;;;;;;GAcG;AACH,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAIzC,CAAC;AAEF,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EACnB,KAAK,SAAS,GACf,CAAC"}

package/dist/components/date-picker/DateRangePicker.d.ts

@@ -1,7 +1,29 @@
 import { default as React } from 'react';
 import { MobileDateRangePicker, MobileDateRangePickerProps } from './MobileDateRangePicker';
 import { DesktopDateRangePicker, DesktopDateRangePickerProps } from './DesktopDateRangePicker';
+import { DateOnlyRange, DateRangeValue } from './dateValue';
+/**
+ * Props for the responsive date-range picker.
+ *
+ * Inherits the desktop and mobile range picker props and keeps the same public
+ * value contract: pass Date objects or YYYY-MM-DD strings and receive a
+ * { from, to } object with YYYY-MM-DD values from onSelect.
+ */
 type DateRangePickerProps = DesktopDateRangePickerProps & MobileDateRangePickerProps & {};
+/**
+ * Responsive date-range picker.
+ *
+ * Renders the mobile dialog picker on mobile screens and the desktop popover
+ * picker on larger screens.
+ *
+ * @example
+ * const [billingRange, setBillingRange] = React.useState<{ from?: string; to?: string } | undefined>({
+ *   from: "2025-12-01",
+ *   to: "2025-12-31",
+ * });
+ *
+ * <DateRangePicker selected={billingRange} onSelect={setBillingRange} />
+ */
 declare const DateRangePicker: React.FC<DateRangePickerProps>;
-export { DateRangePicker, DesktopDateRangePicker, MobileDateRangePicker, type DateRangePickerProps, type DesktopDateRangePickerProps, type MobileDateRangePickerProps, };
+export { DateRangePicker, DesktopDateRangePicker, MobileDateRangePicker, type DateRangePickerProps, type DesktopDateRangePickerProps, type MobileDateRangePickerProps, type DateOnlyRange, type DateRangeValue, };
 //# sourceMappingURL=DateRangePicker.d.ts.map

package/dist/components/date-picker/DateRangePicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DateRangePicker.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/DateRangePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAE/F,KAAK,oBAAoB,GAAG,2BAA2B,GAAG,0BAA0B,GAAG,EAAE,CAAC;AAE1F,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAInD,CAAC;AAEF,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,GAChC,CAAC"}
+{"version":3,"file":"DateRangePicker.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/DateRangePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC/F,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAEtE;;;;;;GAMG;AACH,KAAK,oBAAoB,GAAG,2BAA2B,GAAG,0BAA0B,GAAG,EAAE,CAAC;AAE1F;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAInD,CAAC;AAEF,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,CAAC"}

package/dist/components/date-picker/DesktopDatePicker.d.ts

@@ -1,15 +1,36 @@
 import { PropsBase, PropsSingle, Matcher } from 'react-day-picker';
+import { DateOnlyString, DateValue } from './dateValue';
 import * as React from "react";
-type DesktopDatePickerProps = Omit<PropsBase, "disabled"> & Omit<PropsSingle, "mode" | "disabled"> & {
+/**
+ * Props for the desktop-only single-date picker.
+ *
+ * Inherits the single-date calendar props from react-day-picker, but normalizes
+ * the public value contract to Date | YYYY-MM-DD on input and YYYY-MM-DD on output.
+ */
+type DesktopDatePickerProps = Omit<PropsBase, "disabled"> & Omit<PropsSingle, "mode" | "disabled" | "selected" | "onSelect"> & {
+    /** Display format used in the trigger and accessibility label. */
     formatStr?: string;
+    /** Placeholder shown when no date is selected. */
     placeholder?: string;
+    /** Class name forwarded to the calendar content. */
     calendarClassName?: string;
-    selected?: Date;
+    /** Current value as a native Date or a YYYY-MM-DD string. */
+    selected?: DateValue;
+    /** Called with a YYYY-MM-DD string when the user selects a date. */
+    onSelect?: (date: DateOnlyString | undefined) => void;
+    /** Prevents clearing the selection when true. */
     required?: boolean;
+    /** Closes the popover immediately after a day is picked. */
     closeOnSelect?: boolean;
+    /** Disables the trigger button. */
     disabled?: boolean;
+    /** Dates disabled in the calendar. */
     disabledDates?: Matcher | Matcher[];
 };
+/**
+ * Desktop-only single-date picker rendered in a popover.
+ * Use this component when you want the desktop experience regardless of screen size.
+ */
 declare const DesktopDatePicker: React.FC<DesktopDatePickerProps>;
 export { DesktopDatePicker, type DesktopDatePickerProps };
 //# sourceMappingURL=DesktopDatePicker.d.ts.map

package/dist/components/date-picker/DesktopDatePicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DesktopDatePicker.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/DesktopDatePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAmB,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAOpF,KAAK,sBAAsB,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,GACvD,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;CACrC,CAAC;AAEJ,QAAA,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAsDvD,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"DesktopDatePicker.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/DesktopDatePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAmB,OAAO,EAAmB,MAAM,kBAAkB,CAAC;AAIrG,OAAO,EAAE,cAAc,EAAE,SAAS,EAAoC,MAAM,aAAa,CAAC;AAI1F;;;;;GAKG;AACH,KAAK,sBAAsB,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,GACvD,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC,GAAG;IACjE,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,KAAK,IAAI,CAAC;IACtD,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;CACrC,CAAC;AAEJ;;;GAGG;AACH,QAAA,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CA6DvD,CAAC;AAEF,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,CAAC"}

package/dist/components/date-picker/DesktopDateRangePicker.d.ts

@@ -1,16 +1,38 @@
-import { PropsBase, PropsRange, DateRange, Matcher } from 'react-day-picker';
+import { PropsBase, PropsRange, Matcher } from 'react-day-picker';
+import { DateOnlyRange, DateRangeValue } from './dateValue';
 import * as React from "react";
-type DesktopDateRangePickerProps = Omit<PropsBase, "disabled"> & Omit<PropsRange, "mode" | "disabled"> & {
+/**
+ * Props for the desktop-only date-range picker.
+ *
+ * Inherits the range calendar props from react-day-picker, but normalizes the
+ * public value contract to Date | YYYY-MM-DD on input and { from, to } strings on output.
+ */
+type DesktopDateRangePickerProps = Omit<PropsBase, "disabled"> & Omit<PropsRange, "mode" | "disabled" | "selected" | "onSelect"> & {
+    /** Display format used in the trigger and accessibility label. */
     formatStr?: string;
+    /** Placeholder shown when no range is selected. */
     placeholder?: string;
+    /** Class name forwarded to the calendar content. */
     calendarClassName?: string;
-    selected?: DateRange;
+    /** Current value as Date objects or YYYY-MM-DD strings. */
+    selected?: DateRangeValue;
+    /** Called with YYYY-MM-DD range values when the user selects a range. */
+    onSelect?: (date: DateOnlyRange | undefined) => void;
+    /** Prevents clearing the selection when true. */
     required?: boolean;
+    /** Label shown before the start date in the trigger. */
     fromText?: string;
+    /** Label shown before the end date in the trigger. */
     toText?: string;
+    /** Disables the trigger button. */
     disabled?: boolean;
+    /** Dates disabled in the calendar. */
     disabledDates?: Matcher | Matcher[];
 };
+/**
+ * Desktop-only date-range picker rendered in a popover.
+ * Use this component when you want the desktop experience regardless of screen size.
+ */
 declare const DesktopDateRangePicker: React.FC<DesktopDateRangePickerProps>;
 export { DesktopDateRangePicker, type DesktopDateRangePickerProps };
 //# sourceMappingURL=DesktopDateRangePicker.d.ts.map

package/dist/components/date-picker/DesktopDateRangePicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DesktopDateRangePicker.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/DesktopDateRangePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAO7E,KAAK,2BAA2B,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,GAC5D,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;CACrC,CAAC;AAEJ,QAAA,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAmEjE,CAAC;AAEF,OAAO,EAAE,sBAAsB,EAAE,KAAK,2BAA2B,EAAE,CAAC"}
+{"version":3,"file":"DesktopDateRangePicker.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/DesktopDateRangePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAa,OAAO,EAAmB,MAAM,kBAAkB,CAAC;AAI9F,OAAO,EAAE,aAAa,EAAE,cAAc,EAAwC,MAAM,aAAa,CAAC;AAIlG;;;;;GAKG;AACH,KAAK,2BAA2B,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,GAC5D,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC,GAAG;IAChE,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,KAAK,IAAI,CAAC;IACrD,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;CACrC,CAAC;AAEJ;;;GAGG;AACH,QAAA,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CA2EjE,CAAC;AAEF,OAAO,EAAE,sBAAsB,EAAE,KAAK,2BAA2B,EAAE,CAAC"}

package/dist/components/date-picker/DesktopTimePicker.d.ts

@@ -1,15 +1,32 @@
 import { HTMLAttributes } from 'react';
 import { Time } from './TimePickerContent';
+/**
+ * Props for the desktop-only time picker.
+ *
+ * In 12-hour mode, the time value should include ampm.
+ * In 24-hour mode, the time value should omit ampm and use hour values from 0-23.
+ */
 type DesktopTimePickerProps = HTMLAttributes<HTMLButtonElement> & {
+    /** Current time value. */
     time: Time | undefined;
+    /** Called whenever the selected time changes. */
     onTimeChange: (time: Time | undefined) => void;
+    /** Enables 24-hour mode and hides the AM/PM column when true. */
     is24HourMode?: boolean;
+    /** Accessible label and trigger fallback when no time is selected. */
     placeholder?: string;
+    /** Disables the trigger button. */
     disabled?: boolean;
+    /** Props forwarded to the popover content. */
     slotsProps?: {
+        /** Props forwarded to the time picker content container. */
         content?: HTMLAttributes<HTMLDivElement>;
     };
 };
+/**
+ * Desktop-only time picker rendered in a popover.
+ * Use this component when you want the desktop interaction regardless of screen size.
+ */
 declare const DesktopTimePicker: React.FC<DesktopTimePickerProps>;
 export { DesktopTimePicker, type DesktopTimePickerProps };
 //# sourceMappingURL=DesktopTimePicker.d.ts.map

package/dist/components/date-picker/DesktopTimePicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DesktopTimePicker.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/DesktopTimePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAY,MAAM,OAAO,CAAC;AAKjD,OAAO,EAAE,IAAI,EAAqB,MAAM,qBAAqB,CAAC;AAiB9D,KAAK,sBAAsB,GAAG,cAAc,CAAC,iBAAiB,CAAC,GAAG;IAChE,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;IACvB,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;KAC1C,CAAC;CACH,CAAC;AAEF,QAAA,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAiCvD,CAAC;AACF,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"DesktopTimePicker.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/DesktopTimePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAY,MAAM,OAAO,CAAC;AAKjD,OAAO,EAAE,IAAI,EAAqB,MAAM,qBAAqB,CAAC;AAiB9D;;;;;GAKG;AACH,KAAK,sBAAsB,GAAG,cAAc,CAAC,iBAAiB,CAAC,GAAG;IAChE,0BAA0B;IAC1B,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;IACvB,iDAAiD;IACjD,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IAC/C,iEAAiE;IACjE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,UAAU,CAAC,EAAE;QACX,4DAA4D;QAC5D,OAAO,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;KAC1C,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAiCvD,CAAC;AACF,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,CAAC"}

package/dist/components/date-picker/MobileDatePicker.d.ts

@@ -1,17 +1,38 @@
 import { Matcher, PropsBase, PropsSingle } from 'react-day-picker';
+import { DateOnlyString, DateValue } from './dateValue';
 import * as React from "react";
-type MobileDatePickerProps = Omit<PropsBase, "disabled"> & Omit<PropsSingle, "mode" | "disabled"> & {
+/**
+ * Props for the mobile-only single-date picker.
+ *
+ * Inherits the single-date calendar props from react-day-picker, but accepts
+ * Date | YYYY-MM-DD on input and emits YYYY-MM-DD on apply.
+ */
+type MobileDatePickerProps = Omit<PropsBase, "disabled"> & Omit<PropsSingle, "mode" | "disabled" | "selected" | "onSelect"> & {
+    /** Display format used in the trigger and dialog header. */
     formatStr?: string;
+    /** Placeholder shown when no date is selected. */
     placeholder?: string;
+    /** Class name forwarded to the calendar content. */
     calendarClassName?: string;
-    selected?: Date;
+    /** Current value as a native Date or a YYYY-MM-DD string. */
+    selected?: DateValue;
+    /** Prevents clearing the selection when true. */
     required?: boolean;
+    /** Label for the cancel button. */
     cancelText?: string;
+    /** Label for the apply button. */
     applyText?: string;
-    onSelect?: (date: Date | undefined) => void;
+    /** Called with a YYYY-MM-DD string when the user confirms the selection. */
+    onSelect?: (date: DateOnlyString | undefined) => void;
+    /** Disables the trigger button. */
     disabled?: boolean;
+    /** Dates disabled in the calendar. */
     disabledDates?: Matcher | Matcher[];
 };
+/**
+ * Mobile-only single-date picker rendered in a full-screen dialog.
+ * Use this component when you want mobile interaction regardless of screen size.
+ */
 declare const MobileDatePicker: React.FC<MobileDatePickerProps>;
 export { MobileDatePicker, type MobileDatePickerProps };
 //# sourceMappingURL=MobileDatePicker.d.ts.map

package/dist/components/date-picker/MobileDatePicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MobileDatePicker.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/MobileDatePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAQnE,KAAK,qBAAqB,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,GACtD,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;CACrC,CAAC;AAEJ,QAAA,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAkFrD,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,CAAC"}
+{"version":3,"file":"MobileDatePicker.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/MobileDatePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAKnE,OAAO,EAAE,cAAc,EAAE,SAAS,EAA2C,MAAM,aAAa,CAAC;AAIjG;;;;;GAKG;AACH,KAAK,qBAAqB,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,GACtD,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC,GAAG;IACjE,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,GAAG,SAAS,KAAK,IAAI,CAAC;IACtD,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;CACrC,CAAC;AAEJ;;;GAGG;AACH,QAAA,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAuFrD,CAAC;AAEF,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,CAAC"}

package/dist/components/date-picker/MobileDateRangePicker.d.ts

@@ -1,19 +1,42 @@
-import { PropsBase, PropsRange, DateRange, Matcher } from 'react-day-picker';
+import { PropsBase, PropsRange, Matcher } from 'react-day-picker';
+import { DateOnlyRange, DateRangeValue } from './dateValue';
 import * as React from "react";
-type MobileDateRangePickerProps = Omit<PropsBase, "disabled"> & Omit<PropsRange, "mode" | "disabled"> & {
+/**
+ * Props for the mobile-only date-range picker.
+ *
+ * Inherits the range calendar props from react-day-picker, but accepts Date
+ * objects or YYYY-MM-DD strings and emits { from, to } values in YYYY-MM-DD format.
+ */
+type MobileDateRangePickerProps = Omit<PropsBase, "disabled"> & Omit<PropsRange, "mode" | "disabled" | "selected" | "onSelect"> & {
+    /** Display format used in the trigger and dialog header. */
     formatStr?: string;
+    /** Placeholder shown when no range is selected. */
     placeholder?: string;
+    /** Class name forwarded to the calendar content. */
     calendarClassName?: string;
-    selected?: DateRange;
+    /** Current value as Date objects or YYYY-MM-DD strings. */
+    selected?: DateRangeValue;
+    /** Prevents clearing the selection when true. */
     required?: boolean;
+    /** Label for the cancel button. */
     cancelText?: string;
+    /** Label for the apply button. */
     applyText?: string;
-    onSelect?: (date: DateRange | undefined) => void;
+    /** Called with YYYY-MM-DD range values when the user confirms the selection. */
+    onSelect?: (date: DateOnlyRange | undefined) => void;
+    /** Label shown before the start date in the trigger. */
     fromText?: string;
+    /** Label shown before the end date in the trigger. */
     toText?: string;
+    /** Disables the trigger button. */
     disabled?: boolean;
+    /** Dates disabled in the calendar. */
     disabledDates?: Matcher | Matcher[];
 };
+/**
+ * Mobile-only date-range picker rendered in a full-screen dialog.
+ * Use this component when you want mobile interaction regardless of screen size.
+ */
 declare const MobileDateRangePicker: React.FC<MobileDateRangePickerProps>;
 export { MobileDateRangePicker, type MobileDateRangePickerProps };
 //# sourceMappingURL=MobileDateRangePicker.d.ts.map

package/dist/components/date-picker/MobileDateRangePicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MobileDateRangePicker.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/MobileDateRangePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAmB,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAO9F,KAAK,0BAA0B,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,GAC3D,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAC,GAAG;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,KAAK,IAAI,CAAC;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;CACrC,CAAC;AAEJ,QAAA,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,0BAA0B,CAgI/D,CAAC;AAEF,OAAO,EAAE,qBAAqB,EAAE,KAAK,0BAA0B,EAAE,CAAC"}
+{"version":3,"file":"MobileDateRangePicker.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/MobileDateRangePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAAE,SAAS,EAAE,UAAU,EAA8B,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAI9F,OAAO,EAAE,aAAa,EAAE,cAAc,EAAgD,MAAM,aAAa,CAAC;AAI1G;;;;;GAKG;AACH,KAAK,0BAA0B,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,GAC3D,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC,GAAG;IAChE,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,KAAK,IAAI,CAAC;IACrD,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sCAAsC;IACtC,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,CAAC;CACrC,CAAC;AAEJ;;;GAGG;AACH,QAAA,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,0BAA0B,CAwI/D,CAAC;AAEF,OAAO,EAAE,qBAAqB,EAAE,KAAK,0BAA0B,EAAE,CAAC"}

package/dist/components/date-picker/MobileTimePicker.d.ts

@@ -1,15 +1,32 @@
 import { HTMLAttributes } from 'react';
 import { Time } from './TimePickerContent';
+/**
+ * Props for the mobile-only time picker.
+ *
+ * In 12-hour mode, the time value should include ampm.
+ * In 24-hour mode, the time value should omit ampm and use hour values from 0-23.
+ */
 type MobileTimePickerProps = HTMLAttributes<HTMLButtonElement> & {
+    /** Current time value. */
     time: Time | undefined;
+    /** Called whenever the selected time changes. */
     onTimeChange: (time: Time | undefined) => void;
+    /** Enables 24-hour mode and hides the AM/PM column when true. */
     is24HourMode?: boolean;
+    /** Accessible label and trigger fallback when no time is selected. */
     placeholder?: string;
+    /** Disables the trigger button. */
     disabled?: boolean;
+    /** Props forwarded to the drawer content. */
     slotsProps?: {
+        /** Props forwarded to the time picker content container. */
         content?: HTMLAttributes<HTMLDivElement>;
     };
 };
+/**
+ * Mobile-only time picker rendered in a swipeable drawer.
+ * Use this component when you want the mobile interaction regardless of screen size.
+ */
 declare const MobileTimePicker: React.FC<MobileTimePickerProps>;
 export { MobileTimePicker, type MobileTimePickerProps };
 //# sourceMappingURL=MobileTimePicker.d.ts.map

package/dist/components/date-picker/MobileTimePicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MobileTimePicker.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/MobileTimePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAY,MAAM,OAAO,CAAC;AAKjD,OAAO,EAAE,IAAI,EAAqB,MAAM,qBAAqB,CAAC;AAwB9D,KAAK,qBAAqB,GAAG,cAAc,CAAC,iBAAiB,CAAC,GAAG;IAC/D,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;IACvB,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IAC/C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;KAC1C,CAAC;CACH,CAAC;AAEF,QAAA,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAsCrD,CAAC;AACF,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,CAAC"}
+{"version":3,"file":"MobileTimePicker.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/MobileTimePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAY,MAAM,OAAO,CAAC;AAKjD,OAAO,EAAE,IAAI,EAAqB,MAAM,qBAAqB,CAAC;AAwB9D;;;;;GAKG;AACH,KAAK,qBAAqB,GAAG,cAAc,CAAC,iBAAiB,CAAC,GAAG;IAC/D,0BAA0B;IAC1B,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;IACvB,iDAAiD;IACjD,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IAC/C,iEAAiE;IACjE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,UAAU,CAAC,EAAE;QACX,4DAA4D;QAC5D,OAAO,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;KAC1C,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAsCrD,CAAC;AACF,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,CAAC"}

package/dist/components/date-picker/TimePicker.d.ts

@@ -2,7 +2,29 @@ import { default as React } from 'react';
 import { Time } from './TimePickerContent';
 import { MobileTimePicker, MobileTimePickerProps } from './MobileTimePicker';
 import { DesktopTimePicker, DesktopTimePickerProps } from './DesktopTimePicker';
+/**
+ * Props for the responsive time picker.
+ *
+ * Accepts the same public API as the desktop and mobile time pickers.
+ * The controlled value is a Time object and onTimeChange receives the same shape.
+ */
 type TimePickerProps = DesktopTimePickerProps & {};
+/**
+ * Responsive time picker.
+ *
+ * Renders the mobile drawer picker on mobile screens and the desktop popover picker
+ * on larger screens.
+ *
+ * @example
+ * const [meetingTime, setMeetingTime] = React.useState<Time | undefined>({ hour: 9, minute: 30, ampm: "AM" });
+ *
+ * <TimePicker time={meetingTime} onTimeChange={setMeetingTime} />
+ *
+ * @example
+ * const [twentyFourHourTime, setTwentyFourHourTime] = React.useState<Time | undefined>({ hour: 14, minute: 30 });
+ *
+ * <TimePicker time={twentyFourHourTime} onTimeChange={setTwentyFourHourTime} is24HourMode />
+ */
 declare const TimePicker: React.FC<TimePickerProps>;
 export { TimePicker, DesktopTimePicker, type DesktopTimePickerProps, MobileTimePicker, type MobileTimePickerProps, type TimePickerProps, type Time };
 //# sourceMappingURL=TimePicker.d.ts.map

package/dist/components/date-picker/TimePicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TimePicker.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/TimePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAEhF,KAAK,eAAe,GAAG,sBAAsB,GAAG,EAAE,CAAC;AAEnD,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAIzC,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,KAAK,eAAe,EAAE,KAAK,IAAI,EAAE,CAAC"}
+{"version":3,"file":"TimePicker.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/TimePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAEhF;;;;;GAKG;AACH,KAAK,eAAe,GAAG,sBAAsB,GAAG,EAAE,CAAC;AAEnD;;;;;;;;;;;;;;;GAeG;AACH,QAAA,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAIzC,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,KAAK,eAAe,EAAE,KAAK,IAAI,EAAE,CAAC"}

package/dist/components/date-picker/TimePickerContent.d.ts

@@ -1,18 +1,42 @@
 import { HTMLAttributes } from 'react';
+/**
+ * Public value used by the time pickers.
+ *
+ * In 12-hour mode, provide hour values from 1-12 and include ampm.
+ * In 24-hour mode, provide hour values from 0-23 and omit ampm.
+ */
 type Time = {
+    /** Hour segment of the time value. */
     hour: number;
+    /** Minute segment of the time value. */
     minute: number;
+    /** Optional meridiem used in 12-hour mode. */
     ampm?: "AM" | "PM";
 };
+/**
+ * Props for the shared time picker content.
+ *
+ * This is the scrollable selector used by both the desktop and mobile wrappers.
+ */
 type TimePickerContentProps = {
+    /** Current time value. */
     time: Time | undefined;
+    /** Indicates whether the surrounding popover or drawer is open. */
     isOpen: boolean;
+    /** Enables 24-hour mode and hides the AM/PM column when true. */
     is24HourMode?: boolean;
+    /** Called whenever the user changes the selected time. */
     onTimeChange: (time: Time | undefined) => void;
+    /** Props forwarded to the content container. */
     slotsProps?: {
+        /** Props forwarded to the main content element. */
         content?: HTMLAttributes<HTMLDivElement>;
     };
 };
+/**
+ * Shared time picker content used by the desktop popover and mobile drawer variants.
+ * It normalizes values based on 12-hour or 24-hour mode and emits updates as the user picks segments.
+ */
 declare const TimePickerContent: React.FC<TimePickerContentProps>;
 export { TimePickerContent, type TimePickerContentProps, type Time };
 //# sourceMappingURL=TimePickerContent.d.ts.map

package/dist/components/date-picker/TimePickerContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TimePickerContent.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/TimePickerContent.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA+B,MAAM,OAAO,CAAC;AAIpE,KAAK,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;CAAE,CAAC;AAEjE,KAAK,sBAAsB,GAAG;IAC5B,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IAC/C,UAAU,CAAC,EAAE;QACX,OAAO,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;KAC1C,CAAC;CACH,CAAC;AAoCF,QAAA,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CA6HvD,CAAC;AACF,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC"}
+{"version":3,"file":"TimePickerContent.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/TimePickerContent.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA+B,MAAM,OAAO,CAAC;AAIpE;;;;;GAKG;AACH,KAAK,IAAI,GAAG;IACV,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,KAAK,sBAAsB,GAAG;IAC5B,0BAA0B;IAC1B,IAAI,EAAE,IAAI,GAAG,SAAS,CAAC;IACvB,mEAAmE;IACnE,MAAM,EAAE,OAAO,CAAC;IAChB,iEAAiE;IACjE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,0DAA0D;IAC1D,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IAC/C,gDAAgD;IAChD,UAAU,CAAC,EAAE;QACX,mDAAmD;QACnD,OAAO,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;KAC1C,CAAC;CACH,CAAC;AAoCF;;;GAGG;AACH,QAAA,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CA6HvD,CAAC;AACF,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC"}

package/dist/components/date-picker/dateValue.d.ts

@@ -0,0 +1,44 @@
+import { DateRange } from 'react-day-picker';
+/**
+ * Public value accepted by single-date pickers.
+ * Pass either a native Date or a date-only string in YYYY-MM-DD format.
+ */
+type DateValue = Date | string;
+/**
+ * Date-only value returned by single-date pickers.
+ * Example: "2025-12-24".
+ */
+type DateOnlyString = string;
+type DateSelectionKey = number | string | undefined;
+/**
+ * Public value accepted by date-range pickers.
+ * Each edge of the range can be a native Date or a YYYY-MM-DD string.
+ */
+type DateRangeValue = {
+    /** Inclusive start date for the range. */
+    from?: DateValue;
+    /** Inclusive end date for the range. */
+    to?: DateValue;
+};
+/**
+ * Date-only range returned by range pickers and form wrappers.
+ */
+type DateOnlyRange = {
+    /** Inclusive start date in YYYY-MM-DD format. */
+    from?: DateOnlyString;
+    /** Inclusive end date in YYYY-MM-DD format. */
+    to?: DateOnlyString;
+};
+/**
+ * Regular expression used to validate date-only strings.
+ * Matches values like "2025-12-24".
+ */
+declare const DATE_ONLY_PATTERN: RegExp;
+declare const toCalendarDate: (value?: DateValue) => Date | undefined;
+declare const toDateOnlyString: (value?: Date) => DateOnlyString | undefined;
+declare const toCalendarDateFromKey: (value?: DateSelectionKey) => Date | undefined;
+declare const toCalendarDateRange: (value?: DateRangeValue) => DateRange | undefined;
+declare const toCalendarDateRangeFromKeys: (fromKey?: DateSelectionKey, toKey?: DateSelectionKey) => DateRange | undefined;
+declare const toDateOnlyRange: (value?: DateRange) => DateOnlyRange | undefined;
+export { DATE_ONLY_PATTERN, toCalendarDate, toCalendarDateFromKey, toDateOnlyString, toCalendarDateRange, toCalendarDateRangeFromKeys, toDateOnlyRange, type DateOnlyRange, type DateOnlyString, type DateRangeValue, type DateSelectionKey, type DateValue, };
+//# sourceMappingURL=dateValue.d.ts.map

package/dist/components/date-picker/dateValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dateValue.d.ts","sourceRoot":"","sources":["../../../src/components/date-picker/dateValue.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;GAGG;AACH,KAAK,SAAS,GAAG,IAAI,GAAG,MAAM,CAAC;AAE/B;;;GAGG;AACH,KAAK,cAAc,GAAG,MAAM,CAAC;AAE7B,KAAK,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEpD;;;GAGG;AACH,KAAK,cAAc,GAAG;IACpB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,wCAAwC;IACxC,EAAE,CAAC,EAAE,SAAS,CAAC;CAChB,CAAC;AAEF;;GAEG;AACH,KAAK,aAAa,GAAG;IACnB,iDAAiD;IACjD,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,+CAA+C;IAC/C,EAAE,CAAC,EAAE,cAAc,CAAC;CACrB,CAAC;AAEF;;;GAGG;AACH,QAAA,MAAM,iBAAiB,QAA8B,CAAC;AAItD,QAAA,MAAM,cAAc,WAAY,SAAS,KAAG,IAAI,GAAG,SAuBlD,CAAC;AAEF,QAAA,MAAM,gBAAgB,WAAY,IAAI,KAAG,cAAc,GAAG,SAIzD,CAAC;AAEF,QAAA,MAAM,qBAAqB,WAAY,gBAAgB,KAAG,IAAI,GAAG,SAOhE,CAAC;AAEF,QAAA,MAAM,mBAAmB,WAAY,cAAc,KAAG,SAAS,GAAG,SASjE,CAAC;AAEF,QAAA,MAAM,2BAA2B,aAAc,gBAAgB,UAAU,gBAAgB,KAAG,SAAS,GAAG,SAOvG,CAAC;AAEF,QAAA,MAAM,eAAe,WAAY,SAAS,KAAG,aAAa,GAAG,SAS5D,CAAC;AAEF,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,2BAA2B,EAC3B,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,SAAS,GACf,CAAC"}

package/dist/components/form-date-picker/FormDatePicker.d.ts

@@ -1,14 +1,26 @@
 import { FormItem } from '../form/Form';
 import { SlotProps } from '@radix-ui/react-slot';
-import { Control, ControllerProps, FieldPath, FieldValues } from 'react-hook-form';
-import { DatePickerProps } from '../date-picker/DatePicker';
-type FormDatePickerProps<TFieldValues extends FieldValues, TName extends FieldPath<TFieldValues>> = Omit<ControllerProps<TFieldValues, TName>, "render"> & React.ComponentProps<typeof FormItem> & {
+import { Control, ControllerProps, FieldPathByValue, FieldValues } from 'react-hook-form';
+import { DateOnlyString, DatePickerProps } from '../date-picker/DatePicker';
+/**
+ * Props for FormDatePicker.
+ *
+ * The bound field value should be a YYYY-MM-DD string or undefined.
+ * Use slotProps.datepickerProps to forward props to the underlying DatePicker.
+ */
+type FormDatePickerProps<TFieldValues extends FieldValues, TName extends FieldPathByValue<TFieldValues, DateOnlyString | undefined>> = Omit<ControllerProps<TFieldValues, TName>, "render"> & React.ComponentProps<typeof FormItem> & {
+    /** Label rendered above the picker. */
     label: string;
+    /** React Hook Form control instance. */
     control: Control<TFieldValues>;
+    /** Shows the required asterisk next to the label. */
     required?: boolean;
+    /** Disables the picker and the field interaction. */
     disabled?: boolean;
+    /** Keeps the field readable while preventing edits. */
     readOnly?: boolean;
     formatStr?: string;
+    /** Props forwarded to the form shell and underlying DatePicker. */
     slotProps?: {
         formLabelProps?: React.HTMLAttributes<HTMLLabelElement> & React.RefAttributes<HTMLLabelElement>;
         formMessageProps?: React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>;
@@ -16,6 +28,22 @@ type FormDatePickerProps<TFieldValues extends FieldValues, TName extends FieldPa
         datepickerProps?: DatePickerProps;
     };
 };
-declare const FormDatePicker: <TFieldValues extends FieldValues, TName extends FieldPath<TFieldValues>>(props: FormDatePickerProps<TFieldValues, TName>) => import("react/jsx-runtime").JSX.Element;
+/**
+ * React Hook Form wrapper around DatePicker.
+ *
+ * Binds a YYYY-MM-DD field value to the shared date picker and renders the
+ * label, validation message, and disabled/read-only handling.
+ *
+ * @example
+ * const form = useForm<{ dueDate?: string }>({ defaultValues: { dueDate: "2025-12-24" } });
+ *
+ * <FormDatePicker
+ *   control={form.control}
+ *   name="dueDate"
+ *   label="Due date"
+ *   slotProps={{ datepickerProps: { placeholder: "Pick a due date" } }}
+ * />
+ */
+declare const FormDatePicker: <TFieldValues extends FieldValues, TName extends FieldPathByValue<TFieldValues, DateOnlyString | undefined>>(props: FormDatePickerProps<TFieldValues, TName>) => import("react/jsx-runtime").JSX.Element;
 export { FormDatePicker, type FormDatePickerProps };
 //# sourceMappingURL=FormDatePicker.d.ts.map

package/dist/components/form-date-picker/FormDatePicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormDatePicker.d.ts","sourceRoot":"","sources":["../../../src/components/form-date-picker/FormDatePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA0B,QAAQ,EAA0B,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE7E,KAAK,mBAAmB,CAAC,YAAY,SAAS,WAAW,EAAE,KAAK,SAAS,SAAS,CAAC,YAAY,CAAC,IAAI,IAAI,CACtG,eAAe,CAAC,YAAY,EAAE,KAAK,CAAC,EACpC,QAAQ,CACT,GACC,KAAK,CAAC,cAAc,CAAC,OAAO,QAAQ,CAAC,GAAG;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE;QACV,cAAc,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;QAChG,gBAAgB,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,oBAAoB,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;QAC1G,gBAAgB,CAAC,EAAE,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QAChH,eAAe,CAAC,EAAE,eAAe,CAAC;KACnC,CAAC;CACH,CAAC;AAEJ,QAAA,MAAM,cAAc,GAAI,YAAY,SAAS,WAAW,EAAE,KAAK,SAAS,SAAS,CAAC,YAAY,CAAC,SAAS,mBAAmB,CAAC,YAAY,EAAE,KAAK,CAAC,4CAiC/I,CAAC;AACF,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,CAAC"}
+{"version":3,"file":"FormDatePicker.d.ts","sourceRoot":"","sources":["../../../src/components/form-date-picker/FormDatePicker.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA0B,QAAQ,EAA0B,MAAM,cAAc,CAAC;AACxF,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAc,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAElG;;;;;GAKG;AACH,KAAK,mBAAmB,CAAC,YAAY,SAAS,WAAW,EAAE,KAAK,SAAS,gBAAgB,CAAC,YAAY,EAAE,cAAc,GAAG,SAAS,CAAC,IAAI,IAAI,CACzI,eAAe,CAAC,YAAY,EAAE,KAAK,CAAC,EACpC,QAAQ,CACT,GACC,KAAK,CAAC,cAAc,CAAC,OAAO,QAAQ,CAAC,GAAG;IACtC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,SAAS,CAAC,EAAE;QACV,cAAc,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC;QAChG,gBAAgB,CAAC,EAAE,KAAK,CAAC,cAAc,CAAC,oBAAoB,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC;QAC1G,gBAAgB,CAAC,EAAE,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;QAChH,eAAe,CAAC,EAAE,eAAe,CAAC;KACnC,CAAC;CACH,CAAC;AAEJ;;;;;;;;;;;;;;;GAeG;AACH,QAAA,MAAM,cAAc,GAAI,YAAY,SAAS,WAAW,EAAE,KAAK,SAAS,gBAAgB,CAAC,YAAY,EAAE,cAAc,GAAG,SAAS,CAAC,SACzH,mBAAmB,CAAC,YAAY,EAAE,KAAK,CAAC,4CAkChD,CAAC;AACF,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,CAAC"}

package/dist/components/form-date-range-picker/FormDateRangePicker.d.ts

@@ -1,12 +1,24 @@
 import { FormItem } from '../form/Form';
 import { SlotProps } from '@radix-ui/react-slot';
-import { Control, ControllerProps, FieldPath, FieldValues } from 'react-hook-form';
-import { DateRangePickerProps } from '../date-picker/DateRangePicker';
-type FormDateRangePickerProps<TFieldValues extends FieldValues, TName extends FieldPath<TFieldValues>> = Omit<ControllerProps<TFieldValues, TName>, "render"> & React.ComponentProps<typeof FormItem> & {
+import { Control, ControllerProps, FieldPathByValue, FieldValues } from 'react-hook-form';
+import { DateOnlyRange, DateRangePickerProps } from '../date-picker/DateRangePicker';
+/**
+ * Props for FormDateRangePicker.
+ *
+ * The bound field value should be an object shaped like
+ * { from?: "YYYY-MM-DD", to?: "YYYY-MM-DD" } or undefined.
+ * Use slotProps.datepickerProps to forward props to the underlying DateRangePicker.
+ */
+type FormDateRangePickerProps<TFieldValues extends FieldValues, TName extends FieldPathByValue<TFieldValues, DateOnlyRange | undefined>> = Omit<ControllerProps<TFieldValues, TName>, "render"> & React.ComponentProps<typeof FormItem> & {
+    /** Label rendered above the picker. */
     label: string;
+    /** React Hook Form control instance. */
     control: Control<TFieldValues>;
+    /** Shows the required asterisk next to the label. */
     required?: boolean;
+    /** Keeps the field readable while preventing edits. */
     readOnly?: boolean;
+    /** Props forwarded to the form shell and underlying DateRangePicker. */
     slotProps?: {
         formLabelProps?: React.HTMLAttributes<HTMLLabelElement> & React.RefAttributes<HTMLLabelElement>;
         formMessageProps?: React.HTMLAttributes<HTMLParagraphElement> & React.RefAttributes<HTMLParagraphElement>;
@@ -14,6 +26,24 @@ type FormDateRangePickerProps<TFieldValues extends FieldValues, TName extends Fi
         datepickerProps?: DateRangePickerProps;
     };
 };
-declare const FormDateRangePicker: <TFieldValues extends FieldValues, TName extends FieldPath<TFieldValues>>(props: FormDateRangePickerProps<TFieldValues, TName>) => import("react/jsx-runtime").JSX.Element;
+/**
+ * React Hook Form wrapper around DateRangePicker.
+ *
+ * Binds a { from, to } date-only string object to the shared range picker and
+ * renders the label, validation message, and read-only handling.
+ *
+ * @example
+ * const form = useForm<{ vacation?: { from?: string; to?: string } }>({
+ *   defaultValues: { vacation: { from: "2025-12-24", to: "2025-12-31" } },
+ * });
+ *
+ * <FormDateRangePicker
+ *   control={form.control}
+ *   name="vacation"
+ *   label="Vacation"
+ *   slotProps={{ datepickerProps: { fromText: "Start", toText: "End" } }}
+ * />
+ */
+declare const FormDateRangePicker: <TFieldValues extends FieldValues, TName extends FieldPathByValue<TFieldValues, DateOnlyRange | undefined>>(props: FormDateRangePickerProps<TFieldValues, TName>) => import("react/jsx-runtime").JSX.Element;
 export { FormDateRangePicker, type FormDateRangePickerProps };
 //# sourceMappingURL=FormDateRangePicker.d.ts.map