@kalyx/react 1.0.0-rc.12 → 1.0.0-rc.14

package/dist/index.d.cts

@@ -1,8 +1,9 @@
+export { DateFnsAdapter } from '@kalyx/adapter-date-fns';
+import { ISODateString, DisabledRule, WeekStartsOn, DateAdapter, DatePickerLabels, DateRange, RangePickerLabels, TimePickerLabels, DateTimePickerLabels, CalendarGrid, TimeValue } from '@kalyx/core';
+export { CalendarDay, CalendarGrid, CalendarOptions, CalendarWeek, DEFAULT_DATEPICKER_LABELS, DEFAULT_DATETIMEPICKER_LABELS, DEFAULT_RANGEPICKER_LABELS, DEFAULT_TIMEPICKER_LABELS, DateAdapter, DatePickerLabels, DateRange, DateTimePickerLabels, DisabledRule, ISODateString, RangePickerLabels, TimePickerLabels, TimeValue, WeekStartsOn, WeekdayInfo } from '@kalyx/core';
 import * as react from 'react';
 import { ReactNode, HTMLAttributes, InputHTMLAttributes, ButtonHTMLAttributes } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ISODateString, DisabledRule, WeekStartsOn, DateAdapter, DatePickerLabels, DateRange, RangePickerLabels, TimePickerLabels, DateTimePickerLabels, CalendarGrid, TimeValue } from '@kalyx/core';
-export { CalendarDay, CalendarGrid, CalendarOptions, CalendarWeek, DEFAULT_DATEPICKER_LABELS, DEFAULT_DATETIMEPICKER_LABELS, DEFAULT_RANGEPICKER_LABELS, DEFAULT_TIMEPICKER_LABELS, DateAdapter, DateFnsAdapter, DatePickerLabels, DateRange, DateTimePickerLabels, DisabledRule, ISODateString, RangePickerLabels, TimePickerLabels, TimeValue, WeekStartsOn, WeekdayInfo } from '@kalyx/core';
 
 /**
  * Props for the DatePicker Root component.
@@ -61,7 +62,7 @@ interface DatePickerRootProps {
     /** Child components */
     children: ReactNode;
 }
-declare function DatePickerRoot({ value: controlledValue, defaultValue, onChange, onOpenChange, onCalendarNavigate, disabled, readOnly, weekStartsOn, displayFormat, locale, displayTimezone, adapter, labels: labelsProp, children, }: DatePickerRootProps): react_jsx_runtime.JSX.Element;
+declare function DatePickerRoot({ value: controlledValue, defaultValue, onChange, onOpenChange, onCalendarNavigate, disabled, readOnly, weekStartsOn, displayFormat, locale, displayTimezone, adapter: adapterProp, labels: labelsProp, children, }: DatePickerRootProps): react_jsx_runtime.JSX.Element;
 
 interface DatePickerPopoverProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role'> {
     children?: ReactNode;
@@ -313,7 +314,7 @@ interface RangePickerRootProps {
     /** Child components */
     children: ReactNode;
 }
-declare function RangePickerRoot({ value: controlledValue, defaultValue, onChange, onOpenChange, onCalendarNavigate, disabled, readOnly, weekStartsOn, displayFormat, locale, displayTimezone, adapter, labels: labelsProp, children, }: RangePickerRootProps): react_jsx_runtime.JSX.Element;
+declare function RangePickerRoot({ value: controlledValue, defaultValue, onChange, onOpenChange, onCalendarNavigate, disabled, readOnly, weekStartsOn, displayFormat, locale, displayTimezone, adapter: adapterProp, labels: labelsProp, children, }: RangePickerRootProps): react_jsx_runtime.JSX.Element;
 
 interface RangePickerPopoverProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role'> {
     children?: ReactNode;
@@ -503,12 +504,18 @@ interface TimePickerRootProps {
      * predicate returns `true` for every step within the hour. Always receives 24-hour values.
      */
     filterTime?: (hours: number, minutes: number) => boolean;
+    /**
+     * Date adapter. Only used when the controlled `value` is `null` to derive
+     * "today" as the base for the first time edit. The main `@kalyx/react` entry
+     * auto-injects `DateFnsAdapter`; on `@kalyx/react/headless` you must pass one.
+     */
+    adapter?: DateAdapter;
     /** Override ARIA labels (defaults to English) */
     labels?: Partial<TimePickerLabels>;
     /** Child components */
     children: ReactNode;
 }
-declare function TimePickerRoot({ value: controlledValue, defaultValue, onChange, format, step, withSeconds, displayTimezone, disabled, readOnly, filterTime, labels: labelsProp, children, }: TimePickerRootProps): react_jsx_runtime.JSX.Element;
+declare function TimePickerRoot({ value: controlledValue, defaultValue, onChange, format, step, withSeconds, displayTimezone, disabled, readOnly, filterTime, adapter: adapterProp, labels: labelsProp, children, }: TimePickerRootProps): react_jsx_runtime.JSX.Element;
 
 interface TimePickerHourListClassNames {
     root?: string;
@@ -661,7 +668,7 @@ interface DateTimePickerRootProps {
  * - Changing time in TimePicker -> changes only the time, preserves the date
  * - Escape / outside click -> close the popover (commit)
  */
-declare function DateTimePickerRoot({ value: controlledValue, defaultValue, onChange, onOpenChange, onCalendarNavigate, format, step, withSeconds, filterTime, disabled, readOnly, weekStartsOn, displayFormat, locale, displayTimezone, adapter, labels: labelsProp, children, }: DateTimePickerRootProps): react_jsx_runtime.JSX.Element;
+declare function DateTimePickerRoot({ value: controlledValue, defaultValue, onChange, onOpenChange, onCalendarNavigate, format, step, withSeconds, filterTime, disabled, readOnly, weekStartsOn, displayFormat, locale, displayTimezone, adapter: adapterProp, labels: labelsProp, children, }: DateTimePickerRootProps): react_jsx_runtime.JSX.Element;
 
 interface DateTimePickerInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'value' | 'onChange' | 'type'> {
 }
@@ -1053,6 +1060,12 @@ interface UseTimePickerOptions {
     withSeconds?: boolean;
     /** IANA timezone for time interpretation (see TimePickerRoot#displayTimezone) */
     displayTimezone?: string;
+    /**
+     * Date adapter. Only used when the controlled `value` is `null` to derive
+     * "today" as the base for the first time edit. The main `@kalyx/react` entry
+     * auto-injects `DateFnsAdapter`; on `@kalyx/react/headless` you must pass one.
+     */
+    adapter?: DateAdapter;
 }
 interface UseTimePickerReturn {
     /** Current ISO datetime value */

package/dist/index.d.ts

@@ -1,8 +1,9 @@
+export { DateFnsAdapter } from '@kalyx/adapter-date-fns';
+import { ISODateString, DisabledRule, WeekStartsOn, DateAdapter, DatePickerLabels, DateRange, RangePickerLabels, TimePickerLabels, DateTimePickerLabels, CalendarGrid, TimeValue } from '@kalyx/core';
+export { CalendarDay, CalendarGrid, CalendarOptions, CalendarWeek, DEFAULT_DATEPICKER_LABELS, DEFAULT_DATETIMEPICKER_LABELS, DEFAULT_RANGEPICKER_LABELS, DEFAULT_TIMEPICKER_LABELS, DateAdapter, DatePickerLabels, DateRange, DateTimePickerLabels, DisabledRule, ISODateString, RangePickerLabels, TimePickerLabels, TimeValue, WeekStartsOn, WeekdayInfo } from '@kalyx/core';
 import * as react from 'react';
 import { ReactNode, HTMLAttributes, InputHTMLAttributes, ButtonHTMLAttributes } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ISODateString, DisabledRule, WeekStartsOn, DateAdapter, DatePickerLabels, DateRange, RangePickerLabels, TimePickerLabels, DateTimePickerLabels, CalendarGrid, TimeValue } from '@kalyx/core';
-export { CalendarDay, CalendarGrid, CalendarOptions, CalendarWeek, DEFAULT_DATEPICKER_LABELS, DEFAULT_DATETIMEPICKER_LABELS, DEFAULT_RANGEPICKER_LABELS, DEFAULT_TIMEPICKER_LABELS, DateAdapter, DateFnsAdapter, DatePickerLabels, DateRange, DateTimePickerLabels, DisabledRule, ISODateString, RangePickerLabels, TimePickerLabels, TimeValue, WeekStartsOn, WeekdayInfo } from '@kalyx/core';
 
 /**
  * Props for the DatePicker Root component.
@@ -61,7 +62,7 @@ interface DatePickerRootProps {
     /** Child components */
     children: ReactNode;
 }
-declare function DatePickerRoot({ value: controlledValue, defaultValue, onChange, onOpenChange, onCalendarNavigate, disabled, readOnly, weekStartsOn, displayFormat, locale, displayTimezone, adapter, labels: labelsProp, children, }: DatePickerRootProps): react_jsx_runtime.JSX.Element;
+declare function DatePickerRoot({ value: controlledValue, defaultValue, onChange, onOpenChange, onCalendarNavigate, disabled, readOnly, weekStartsOn, displayFormat, locale, displayTimezone, adapter: adapterProp, labels: labelsProp, children, }: DatePickerRootProps): react_jsx_runtime.JSX.Element;
 
 interface DatePickerPopoverProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role'> {
     children?: ReactNode;
@@ -313,7 +314,7 @@ interface RangePickerRootProps {
     /** Child components */
     children: ReactNode;
 }
-declare function RangePickerRoot({ value: controlledValue, defaultValue, onChange, onOpenChange, onCalendarNavigate, disabled, readOnly, weekStartsOn, displayFormat, locale, displayTimezone, adapter, labels: labelsProp, children, }: RangePickerRootProps): react_jsx_runtime.JSX.Element;
+declare function RangePickerRoot({ value: controlledValue, defaultValue, onChange, onOpenChange, onCalendarNavigate, disabled, readOnly, weekStartsOn, displayFormat, locale, displayTimezone, adapter: adapterProp, labels: labelsProp, children, }: RangePickerRootProps): react_jsx_runtime.JSX.Element;
 
 interface RangePickerPopoverProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role'> {
     children?: ReactNode;
@@ -503,12 +504,18 @@ interface TimePickerRootProps {
      * predicate returns `true` for every step within the hour. Always receives 24-hour values.
      */
     filterTime?: (hours: number, minutes: number) => boolean;
+    /**
+     * Date adapter. Only used when the controlled `value` is `null` to derive
+     * "today" as the base for the first time edit. The main `@kalyx/react` entry
+     * auto-injects `DateFnsAdapter`; on `@kalyx/react/headless` you must pass one.
+     */
+    adapter?: DateAdapter;
     /** Override ARIA labels (defaults to English) */
     labels?: Partial<TimePickerLabels>;
     /** Child components */
     children: ReactNode;
 }
-declare function TimePickerRoot({ value: controlledValue, defaultValue, onChange, format, step, withSeconds, displayTimezone, disabled, readOnly, filterTime, labels: labelsProp, children, }: TimePickerRootProps): react_jsx_runtime.JSX.Element;
+declare function TimePickerRoot({ value: controlledValue, defaultValue, onChange, format, step, withSeconds, displayTimezone, disabled, readOnly, filterTime, adapter: adapterProp, labels: labelsProp, children, }: TimePickerRootProps): react_jsx_runtime.JSX.Element;
 
 interface TimePickerHourListClassNames {
     root?: string;
@@ -661,7 +668,7 @@ interface DateTimePickerRootProps {
  * - Changing time in TimePicker -> changes only the time, preserves the date
  * - Escape / outside click -> close the popover (commit)
  */
-declare function DateTimePickerRoot({ value: controlledValue, defaultValue, onChange, onOpenChange, onCalendarNavigate, format, step, withSeconds, filterTime, disabled, readOnly, weekStartsOn, displayFormat, locale, displayTimezone, adapter, labels: labelsProp, children, }: DateTimePickerRootProps): react_jsx_runtime.JSX.Element;
+declare function DateTimePickerRoot({ value: controlledValue, defaultValue, onChange, onOpenChange, onCalendarNavigate, format, step, withSeconds, filterTime, disabled, readOnly, weekStartsOn, displayFormat, locale, displayTimezone, adapter: adapterProp, labels: labelsProp, children, }: DateTimePickerRootProps): react_jsx_runtime.JSX.Element;
 
 interface DateTimePickerInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'value' | 'onChange' | 'type'> {
 }
@@ -1053,6 +1060,12 @@ interface UseTimePickerOptions {
     withSeconds?: boolean;
     /** IANA timezone for time interpretation (see TimePickerRoot#displayTimezone) */
     displayTimezone?: string;
+    /**
+     * Date adapter. Only used when the controlled `value` is `null` to derive
+     * "today" as the base for the first time edit. The main `@kalyx/react` entry
+     * auto-injects `DateFnsAdapter`; on `@kalyx/react/headless` you must pass one.
+     */
+    adapter?: DateAdapter;
 }
 interface UseTimePickerReturn {
     /** Current ISO datetime value */

package/dist/index.js

@@ -1,11 +1,29 @@
 "use client";
+import { DateFnsAdapter } from '@kalyx/adapter-date-fns';
+export { DateFnsAdapter } from '@kalyx/adapter-date-fns';
 import { createContext, forwardRef, useState, useRef, useEffect, useCallback, useContext, useId, useMemo } from 'react';
-import { parseInputValue, formatTimeString, parseTimeString, getTimeInTimezone, getTime, DateFnsAdapter, DEFAULT_DATEPICKER_LABELS, civilMidnightFromUtcDay, getMonthName, getWeekdayNames, getCalendarDays, formatMonthYear, isDateDisabled, getISOWeekNumber, DEFAULT_RANGEPICKER_LABELS, DEFAULT_TIMEPICKER_LABELS, setTimeInTimezone, setTime, to12Hour, to24Hour, generateMinutes, generateHours, formatFullDate } from '@kalyx/core';
-export { DEFAULT_DATEPICKER_LABELS, DEFAULT_DATETIMEPICKER_LABELS, DEFAULT_RANGEPICKER_LABELS, DEFAULT_TIMEPICKER_LABELS, DateFnsAdapter } from '@kalyx/core';
+import { parseInputValue, formatTimeString, parseTimeString, getTimeInTimezone, getTime, DEFAULT_DATEPICKER_LABELS, civilMidnightFromUtcDay, getMonthName, getWeekdayNames, getCalendarDays, formatMonthYear, isDateDisabled, getISOWeekNumber, DEFAULT_RANGEPICKER_LABELS, DEFAULT_TIMEPICKER_LABELS, setTimeInTimezone, setTime, to12Hour, to24Hour, generateMinutes, generateHours, formatFullDate } from '@kalyx/core';
+export { DEFAULT_DATEPICKER_LABELS, DEFAULT_DATETIMEPICKER_LABELS, DEFAULT_RANGEPICKER_LABELS, DEFAULT_TIMEPICKER_LABELS } from '@kalyx/core';
 import { jsxs, Fragment, jsx } from 'react/jsx-runtime';
 import { offset, flip, shift, useFloating, autoUpdate } from '@floating-ui/react';
 
-// src/components/DatePicker/Root.tsx
+// src/index.ts
+
+// src/internal/defaultAdapter.ts
+var __defaultAdapter = null;
+function setDefaultAdapter(adapter) {
+  __defaultAdapter = adapter;
+}
+function getDefaultAdapter() {
+  return __defaultAdapter;
+}
+function resolveAdapter(passed, fallback, componentName) {
+  if (passed) return passed;
+  if (fallback) return fallback;
+  throw new Error(
+    `[@kalyx/react/headless] ${componentName} requires an adapter. Pass one via <${componentName} adapter={...}>. If you don't need a custom adapter, import from '@kalyx/react' instead.`
+  );
+}
 var DatePickerContext = createContext(null);
 function useDatePickerContext(componentName) {
   const context = useContext(DatePickerContext);
@@ -44,10 +62,11 @@ function DatePickerRoot({
   displayFormat = "yyyy-MM-dd",
   locale = "en-US",
   displayTimezone,
-  adapter = DateFnsAdapter,
+  adapter: adapterProp,
   labels: labelsProp,
   children
 }) {
+  const adapter = resolveAdapter(adapterProp, getDefaultAdapter(), "DatePicker");
   const pickerId = useId();
   const isControlled = useRef(controlledValue !== void 0).current;
   const referenceRef = useRef(null);
@@ -1125,10 +1144,11 @@ function RangePickerRoot({
   displayFormat = "yyyy-MM-dd",
   locale = "en-US",
   displayTimezone,
-  adapter = DateFnsAdapter,
+  adapter: adapterProp,
   labels: labelsProp,
   children
 }) {
+  const adapter = resolveAdapter(adapterProp, getDefaultAdapter(), "RangePicker");
   const pickerId = useId();
   const isControlled = useRef(controlledValue !== void 0).current;
   const referenceRef = useRef(null);
@@ -1803,9 +1823,11 @@ function TimePickerRoot({
   disabled = false,
   readOnly = false,
   filterTime,
+  adapter: adapterProp,
   labels: labelsProp,
   children
 }) {
+  const adapter = resolveAdapter(adapterProp, getDefaultAdapter(), "TimePicker");
   const pickerId = useId();
   const mergedLabels = useMemo(
     () => ({ ...DEFAULT_TIMEPICKER_LABELS, ...labelsProp }),
@@ -1823,14 +1845,14 @@ function TimePickerRoot({
   const setTime$1 = useCallback(
     (partial) => {
       if (disabled || readOnly) return;
-      const base = currentValue ?? DateFnsAdapter.today(displayTimezone);
+      const base = currentValue ?? adapter.today(displayTimezone);
       const newIso = displayTimezone ? setTimeInTimezone(base, partial, displayTimezone) : setTime(base, partial);
       if (!isControlled) {
         setUncontrolledValue(newIso);
       }
       onChange?.(newIso);
     },
-    [disabled, readOnly, currentValue, displayTimezone, isControlled, onChange]
+    [disabled, readOnly, currentValue, displayTimezone, isControlled, onChange, adapter]
   );
   const contextValue = useMemo(
     () => ({
@@ -2206,10 +2228,11 @@ function DateTimePickerRoot({
   displayFormat = "yyyy-MM-dd HH:mm",
   locale = "en-US",
   displayTimezone,
-  adapter = DateFnsAdapter,
+  adapter: adapterProp,
   labels: labelsProp,
   children
 }) {
+  const adapter = resolveAdapter(adapterProp, getDefaultAdapter(), "DateTimePicker");
   const pickerId = useId();
   const mergedDateLabels = useMemo(
     () => ({ ...DEFAULT_DATEPICKER_LABELS, ...labelsProp }),
@@ -2744,9 +2767,10 @@ function useDatePicker(options = {}) {
     onChange,
     disabled = [],
     weekStartsOn = 0,
-    adapter = DateFnsAdapter,
+    adapter: adapterProp,
     displayTimezone
   } = options;
+  const adapter = resolveAdapter(adapterProp, getDefaultAdapter(), "useDatePicker");
   const pickerId = useId();
   const isControlled = useRef(controlledValue !== void 0).current;
   const [uncontrolledValue, setUncontrolledValue] = useState(
@@ -2827,9 +2851,10 @@ function useRangePicker(options = {}) {
     onChange,
     disabled = [],
     weekStartsOn = 0,
-    adapter = DateFnsAdapter,
+    adapter: adapterProp,
     displayTimezone
   } = options;
+  const adapter = resolveAdapter(adapterProp, getDefaultAdapter(), "useRangePicker");
   const pickerId = useId();
   const isControlled = useRef(controlledValue !== void 0).current;
   const [uncontrolledValue, setUncontrolledValue] = useState(
@@ -2934,9 +2959,6 @@ function useRangePicker(options = {}) {
     adapter
   };
 }
-function getDefaultIso() {
-  return DateFnsAdapter.today();
-}
 function useTimePicker(options = {}) {
   const {
     value: controlledValue,
@@ -2944,15 +2966,17 @@ function useTimePicker(options = {}) {
     onChange,
     format = "24h",
     step = 1,
-    displayTimezone
+    displayTimezone,
+    adapter: adapterProp
   } = options;
+  const adapter = resolveAdapter(adapterProp, getDefaultAdapter(), "useTimePicker");
   const pickerId = useId();
   const isControlled = useRef(controlledValue !== void 0).current;
   const [uncontrolledValue, setUncontrolledValue] = useState(
     defaultValue ?? null
   );
   const currentValue = isControlled ? controlledValue ?? null : uncontrolledValue;
-  const baseIso = currentValue ?? getDefaultIso();
+  const baseIso = currentValue ?? adapter.today();
   const currentTime = useMemo(
     () => displayTimezone ? getTimeInTimezone(baseIso, displayTimezone) : getTime(baseIso),
     [baseIso, displayTimezone]
@@ -3002,6 +3026,7 @@ function useTimePicker(options = {}) {
     pickerId
   };
 }
+setDefaultAdapter(DateFnsAdapter);
 
 export { DatePicker, DateTimePicker, MonthPicker, RangePicker, TimePicker, WeekPicker, YearPicker, useDatePicker, useRangePicker, useTimePicker };
 //# sourceMappingURL=index.js.map