@kalyx/react 0.3.0 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (8) hide show
  1. package/CHANGELOG.md +24 -0
  2. package/dist/index.cjs +102 -62
  3. package/dist/index.cjs.map +1 -1
  4. package/dist/index.d.cts +33 -4
  5. package/dist/index.d.ts +33 -4
  6. package/dist/index.js +103 -63
  7. package/dist/index.js.map +1 -1
  8. package/package.json +12 -4
package/dist/index.d.cts CHANGED
@@ -41,6 +41,12 @@ interface DatePickerRootProps {
41
41
  displayFormat?: string;
42
42
  /** BCP 47 locale (e.g., "en-US", "ko-KR", "ja-JP") */
43
43
  locale?: string;
44
+ /**
45
+ * IANA timezone used for display and selection semantics (e.g., "Asia/Seoul").
46
+ * When set, the Input formats the value in this zone, Calendar highlights the matching civil
47
+ * day, and selecting a date emits the civil midnight of that day (UTC-ISO form).
48
+ */
49
+ displayTimezone?: string;
44
50
  /** Date adapter */
45
51
  adapter?: DateAdapter;
46
52
  /** Override ARIA labels (defaults to English) */
@@ -48,7 +54,7 @@ interface DatePickerRootProps {
48
54
  /** Child components */
49
55
  children: ReactNode;
50
56
  }
51
- declare function DatePickerRoot({ value: controlledValue, defaultValue, onChange, disabled, readOnly, weekStartsOn, displayFormat, locale, adapter, labels: labelsProp, children, }: DatePickerRootProps): react_jsx_runtime.JSX.Element;
57
+ declare function DatePickerRoot({ value: controlledValue, defaultValue, onChange, disabled, readOnly, weekStartsOn, displayFormat, locale, displayTimezone, adapter, labels: labelsProp, children, }: DatePickerRootProps): react_jsx_runtime.JSX.Element;
52
58
 
53
59
  interface DatePickerPopoverProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role'> {
54
60
  children?: ReactNode;
@@ -213,6 +219,12 @@ interface RangePickerRootProps {
213
219
  displayFormat?: string;
214
220
  /** BCP 47 locale */
215
221
  locale?: string;
222
+ /**
223
+ * IANA timezone for display (e.g., "Asia/Seoul"). When set, inputs format in this zone,
224
+ * calendar highlighting uses civil-day comparison in this zone, and selected start/end are
225
+ * emitted as civil midnight of the clicked day in this zone (UTC-ISO form).
226
+ */
227
+ displayTimezone?: string;
216
228
  /** Date adapter */
217
229
  adapter?: DateAdapter;
218
230
  /** Override ARIA labels (defaults to English) */
@@ -220,7 +232,7 @@ interface RangePickerRootProps {
220
232
  /** Child components */
221
233
  children: ReactNode;
222
234
  }
223
- declare function RangePickerRoot({ value: controlledValue, defaultValue, onChange, disabled, readOnly, weekStartsOn, displayFormat, locale, adapter, labels: labelsProp, children, }: RangePickerRootProps): react_jsx_runtime.JSX.Element;
235
+ declare function RangePickerRoot({ value: controlledValue, defaultValue, onChange, disabled, readOnly, weekStartsOn, displayFormat, locale, displayTimezone, adapter, labels: labelsProp, children, }: RangePickerRootProps): react_jsx_runtime.JSX.Element;
224
236
 
225
237
  interface RangePickerPopoverProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role'> {
226
238
  children?: ReactNode;
@@ -371,6 +383,11 @@ interface TimePickerRootProps {
371
383
  step?: number;
372
384
  /** Whether to display seconds */
373
385
  withSeconds?: boolean;
386
+ /**
387
+ * IANA timezone used to interpret time. When set, the hour/minute controls read and write
388
+ * the time as observed in this zone.
389
+ */
390
+ displayTimezone?: string;
374
391
  /** Whether entire picker is disabled */
375
392
  disabled?: boolean;
376
393
  /** Read-only */
@@ -380,7 +397,7 @@ interface TimePickerRootProps {
380
397
  /** Child components */
381
398
  children: ReactNode;
382
399
  }
383
- declare function TimePickerRoot({ value: controlledValue, defaultValue, onChange, format, step, withSeconds, disabled, readOnly, labels: labelsProp, children, }: TimePickerRootProps): react_jsx_runtime.JSX.Element;
400
+ declare function TimePickerRoot({ value: controlledValue, defaultValue, onChange, format, step, withSeconds, displayTimezone, disabled, readOnly, labels: labelsProp, children, }: TimePickerRootProps): react_jsx_runtime.JSX.Element;
384
401
 
385
402
  interface TimePickerHourListClassNames {
386
403
  root?: string;
@@ -489,6 +506,12 @@ interface DateTimePickerRootProps {
489
506
  displayFormat?: string;
490
507
  /** BCP 47 locale */
491
508
  locale?: string;
509
+ /**
510
+ * IANA timezone used for display (e.g., "Asia/Seoul"). When set, Calendar highlights match
511
+ * civil days in this zone, TimePicker reads/writes the time in this zone, and the Input
512
+ * formats the combined date+time in this zone.
513
+ */
514
+ displayTimezone?: string;
492
515
  /** Date adapter */
493
516
  adapter?: DateAdapter;
494
517
  /** Override ARIA labels (defaults to English) */
@@ -508,7 +531,7 @@ interface DateTimePickerRootProps {
508
531
  * - Changing time in TimePicker -> changes only the time, preserves the date
509
532
  * - Escape / outside click -> close the popover (commit)
510
533
  */
511
- declare function DateTimePickerRoot({ value: controlledValue, defaultValue, onChange, format, step, disabled, readOnly, weekStartsOn, displayFormat, locale, adapter, labels: labelsProp, children, }: DateTimePickerRootProps): react_jsx_runtime.JSX.Element;
534
+ declare function DateTimePickerRoot({ value: controlledValue, defaultValue, onChange, format, step, disabled, readOnly, weekStartsOn, displayFormat, locale, displayTimezone, adapter, labels: labelsProp, children, }: DateTimePickerRootProps): react_jsx_runtime.JSX.Element;
512
535
 
513
536
  interface DateTimePickerInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'value' | 'onChange' | 'type'> {
514
537
  }
@@ -569,6 +592,8 @@ interface UseDatePickerOptions {
569
592
  weekStartsOn?: WeekStartsOn;
570
593
  /** Date adapter */
571
594
  adapter?: DateAdapter;
595
+ /** IANA timezone for display (see DatePickerRoot#displayTimezone) */
596
+ displayTimezone?: string;
572
597
  }
573
598
  interface UseDatePickerReturn {
574
599
  /** Currently selected date (ISO string) */
@@ -634,6 +659,8 @@ interface UseRangePickerOptions {
634
659
  weekStartsOn?: WeekStartsOn;
635
660
  /** Date adapter */
636
661
  adapter?: DateAdapter;
662
+ /** IANA timezone for display (see RangePickerRoot#displayTimezone) */
663
+ displayTimezone?: string;
637
664
  }
638
665
  interface UseRangePickerReturn {
639
666
  /** Currently selected range */
@@ -699,6 +726,8 @@ interface UseTimePickerOptions {
699
726
  step?: number;
700
727
  /** Whether seconds are shown */
701
728
  withSeconds?: boolean;
729
+ /** IANA timezone for time interpretation (see TimePickerRoot#displayTimezone) */
730
+ displayTimezone?: string;
702
731
  }
703
732
  interface UseTimePickerReturn {
704
733
  /** Current ISO datetime value */
package/dist/index.d.ts CHANGED
@@ -41,6 +41,12 @@ interface DatePickerRootProps {
41
41
  displayFormat?: string;
42
42
  /** BCP 47 locale (e.g., "en-US", "ko-KR", "ja-JP") */
43
43
  locale?: string;
44
+ /**
45
+ * IANA timezone used for display and selection semantics (e.g., "Asia/Seoul").
46
+ * When set, the Input formats the value in this zone, Calendar highlights the matching civil
47
+ * day, and selecting a date emits the civil midnight of that day (UTC-ISO form).
48
+ */
49
+ displayTimezone?: string;
44
50
  /** Date adapter */
45
51
  adapter?: DateAdapter;
46
52
  /** Override ARIA labels (defaults to English) */
@@ -48,7 +54,7 @@ interface DatePickerRootProps {
48
54
  /** Child components */
49
55
  children: ReactNode;
50
56
  }
51
- declare function DatePickerRoot({ value: controlledValue, defaultValue, onChange, disabled, readOnly, weekStartsOn, displayFormat, locale, adapter, labels: labelsProp, children, }: DatePickerRootProps): react_jsx_runtime.JSX.Element;
57
+ declare function DatePickerRoot({ value: controlledValue, defaultValue, onChange, disabled, readOnly, weekStartsOn, displayFormat, locale, displayTimezone, adapter, labels: labelsProp, children, }: DatePickerRootProps): react_jsx_runtime.JSX.Element;
52
58
 
53
59
  interface DatePickerPopoverProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role'> {
54
60
  children?: ReactNode;
@@ -213,6 +219,12 @@ interface RangePickerRootProps {
213
219
  displayFormat?: string;
214
220
  /** BCP 47 locale */
215
221
  locale?: string;
222
+ /**
223
+ * IANA timezone for display (e.g., "Asia/Seoul"). When set, inputs format in this zone,
224
+ * calendar highlighting uses civil-day comparison in this zone, and selected start/end are
225
+ * emitted as civil midnight of the clicked day in this zone (UTC-ISO form).
226
+ */
227
+ displayTimezone?: string;
216
228
  /** Date adapter */
217
229
  adapter?: DateAdapter;
218
230
  /** Override ARIA labels (defaults to English) */
@@ -220,7 +232,7 @@ interface RangePickerRootProps {
220
232
  /** Child components */
221
233
  children: ReactNode;
222
234
  }
223
- declare function RangePickerRoot({ value: controlledValue, defaultValue, onChange, disabled, readOnly, weekStartsOn, displayFormat, locale, adapter, labels: labelsProp, children, }: RangePickerRootProps): react_jsx_runtime.JSX.Element;
235
+ declare function RangePickerRoot({ value: controlledValue, defaultValue, onChange, disabled, readOnly, weekStartsOn, displayFormat, locale, displayTimezone, adapter, labels: labelsProp, children, }: RangePickerRootProps): react_jsx_runtime.JSX.Element;
224
236
 
225
237
  interface RangePickerPopoverProps extends Omit<HTMLAttributes<HTMLDivElement>, 'role'> {
226
238
  children?: ReactNode;
@@ -371,6 +383,11 @@ interface TimePickerRootProps {
371
383
  step?: number;
372
384
  /** Whether to display seconds */
373
385
  withSeconds?: boolean;
386
+ /**
387
+ * IANA timezone used to interpret time. When set, the hour/minute controls read and write
388
+ * the time as observed in this zone.
389
+ */
390
+ displayTimezone?: string;
374
391
  /** Whether entire picker is disabled */
375
392
  disabled?: boolean;
376
393
  /** Read-only */
@@ -380,7 +397,7 @@ interface TimePickerRootProps {
380
397
  /** Child components */
381
398
  children: ReactNode;
382
399
  }
383
- declare function TimePickerRoot({ value: controlledValue, defaultValue, onChange, format, step, withSeconds, disabled, readOnly, labels: labelsProp, children, }: TimePickerRootProps): react_jsx_runtime.JSX.Element;
400
+ declare function TimePickerRoot({ value: controlledValue, defaultValue, onChange, format, step, withSeconds, displayTimezone, disabled, readOnly, labels: labelsProp, children, }: TimePickerRootProps): react_jsx_runtime.JSX.Element;
384
401
 
385
402
  interface TimePickerHourListClassNames {
386
403
  root?: string;
@@ -489,6 +506,12 @@ interface DateTimePickerRootProps {
489
506
  displayFormat?: string;
490
507
  /** BCP 47 locale */
491
508
  locale?: string;
509
+ /**
510
+ * IANA timezone used for display (e.g., "Asia/Seoul"). When set, Calendar highlights match
511
+ * civil days in this zone, TimePicker reads/writes the time in this zone, and the Input
512
+ * formats the combined date+time in this zone.
513
+ */
514
+ displayTimezone?: string;
492
515
  /** Date adapter */
493
516
  adapter?: DateAdapter;
494
517
  /** Override ARIA labels (defaults to English) */
@@ -508,7 +531,7 @@ interface DateTimePickerRootProps {
508
531
  * - Changing time in TimePicker -> changes only the time, preserves the date
509
532
  * - Escape / outside click -> close the popover (commit)
510
533
  */
511
- declare function DateTimePickerRoot({ value: controlledValue, defaultValue, onChange, format, step, disabled, readOnly, weekStartsOn, displayFormat, locale, adapter, labels: labelsProp, children, }: DateTimePickerRootProps): react_jsx_runtime.JSX.Element;
534
+ declare function DateTimePickerRoot({ value: controlledValue, defaultValue, onChange, format, step, disabled, readOnly, weekStartsOn, displayFormat, locale, displayTimezone, adapter, labels: labelsProp, children, }: DateTimePickerRootProps): react_jsx_runtime.JSX.Element;
512
535
 
513
536
  interface DateTimePickerInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'value' | 'onChange' | 'type'> {
514
537
  }
@@ -569,6 +592,8 @@ interface UseDatePickerOptions {
569
592
  weekStartsOn?: WeekStartsOn;
570
593
  /** Date adapter */
571
594
  adapter?: DateAdapter;
595
+ /** IANA timezone for display (see DatePickerRoot#displayTimezone) */
596
+ displayTimezone?: string;
572
597
  }
573
598
  interface UseDatePickerReturn {
574
599
  /** Currently selected date (ISO string) */
@@ -634,6 +659,8 @@ interface UseRangePickerOptions {
634
659
  weekStartsOn?: WeekStartsOn;
635
660
  /** Date adapter */
636
661
  adapter?: DateAdapter;
662
+ /** IANA timezone for display (see RangePickerRoot#displayTimezone) */
663
+ displayTimezone?: string;
637
664
  }
638
665
  interface UseRangePickerReturn {
639
666
  /** Currently selected range */
@@ -699,6 +726,8 @@ interface UseTimePickerOptions {
699
726
  step?: number;
700
727
  /** Whether seconds are shown */
701
728
  withSeconds?: boolean;
729
+ /** IANA timezone for time interpretation (see TimePickerRoot#displayTimezone) */
730
+ displayTimezone?: string;
702
731
  }
703
732
  interface UseTimePickerReturn {
704
733
  /** Current ISO datetime value */