@cognitap/radiant 0.0.81 → 0.0.82

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 (144) hide show
  1. package/CHANGELOG.md +14 -0
  2. package/dist/library/components/Autocomplete/Autocomplete.d.ts +1 -1
  3. package/dist/library/components/Autocomplete/Autocomplete.d.ts.map +1 -1
  4. package/dist/library/components/Autocomplete/Autocomplete.js +2 -6
  5. package/dist/library/components/Autocomplete/Autocomplete.js.map +1 -1
  6. package/dist/library/components/Calendar/Calendar.d.ts +39 -0
  7. package/dist/library/components/Calendar/Calendar.d.ts.map +1 -0
  8. package/dist/library/components/Calendar/Calendar.js +143 -0
  9. package/dist/library/components/Calendar/Calendar.js.map +1 -0
  10. package/dist/library/components/Combobox/Combobox.d.ts.map +1 -1
  11. package/dist/library/components/Combobox/Combobox.js +10 -4
  12. package/dist/library/components/Combobox/Combobox.js.map +1 -1
  13. package/dist/library/components/DatePicker/DateCalendar.d.ts +13 -0
  14. package/dist/library/components/DatePicker/DateCalendar.d.ts.map +1 -0
  15. package/dist/library/components/DatePicker/DateCalendar.js +25 -0
  16. package/dist/library/components/DatePicker/DateCalendar.js.map +1 -0
  17. package/dist/library/components/DatePicker/DateEditor.d.ts +13 -0
  18. package/dist/library/components/DatePicker/DateEditor.d.ts.map +1 -0
  19. package/dist/library/components/DatePicker/DateEditor.js +84 -0
  20. package/dist/library/components/DatePicker/DateEditor.js.map +1 -0
  21. package/dist/library/components/DatePicker/DatePicker.d.ts +10 -0
  22. package/dist/library/components/DatePicker/DatePicker.d.ts.map +1 -0
  23. package/dist/library/components/DatePicker/DatePicker.js +34 -0
  24. package/dist/library/components/DatePicker/DatePicker.js.map +1 -0
  25. package/dist/library/components/DatePicker/dateSegments.d.ts +13 -0
  26. package/dist/library/components/DatePicker/dateSegments.d.ts.map +1 -0
  27. package/dist/library/components/DatePicker/dateSegments.js +43 -0
  28. package/dist/library/components/DatePicker/dateSegments.js.map +1 -0
  29. package/dist/library/components/DateRangePicker/DateRangePicker.d.ts +23 -0
  30. package/dist/library/components/DateRangePicker/DateRangePicker.d.ts.map +1 -0
  31. package/dist/library/components/DateRangePicker/DateRangePicker.js +69 -0
  32. package/dist/library/components/DateRangePicker/DateRangePicker.js.map +1 -0
  33. package/dist/library/components/LocaleProvider/LocaleProvider.d.ts +9 -0
  34. package/dist/library/components/LocaleProvider/LocaleProvider.d.ts.map +1 -0
  35. package/dist/library/components/LocaleProvider/LocaleProvider.js +11 -0
  36. package/dist/library/components/LocaleProvider/LocaleProvider.js.map +1 -0
  37. package/dist/library/components/Menu/Menu.d.ts.map +1 -1
  38. package/dist/library/components/Menu/Menu.js +7 -2
  39. package/dist/library/components/Menu/Menu.js.map +1 -1
  40. package/dist/library/components/NumberField/NumberField.d.ts +1 -1
  41. package/dist/library/components/NumberField/NumberField.d.ts.map +1 -1
  42. package/dist/library/components/NumberField/NumberField.js +3 -1
  43. package/dist/library/components/NumberField/NumberField.js.map +1 -1
  44. package/dist/library/components/Popover/Popover.d.ts +2 -1
  45. package/dist/library/components/Popover/Popover.d.ts.map +1 -1
  46. package/dist/library/components/Popover/Popover.js +4 -1
  47. package/dist/library/components/Popover/Popover.js.map +1 -1
  48. package/dist/library/components/Select/Select.d.ts.map +1 -1
  49. package/dist/library/components/Select/Select.js +18 -9
  50. package/dist/library/components/Select/Select.js.map +1 -1
  51. package/dist/library/components/TimeInput/TimeInput.d.ts +18 -0
  52. package/dist/library/components/TimeInput/TimeInput.d.ts.map +1 -0
  53. package/dist/library/components/TimeInput/TimeInput.js +123 -0
  54. package/dist/library/components/TimeInput/TimeInput.js.map +1 -0
  55. package/dist/library/components/TimeInput/timeSegments.d.ts +24 -0
  56. package/dist/library/components/TimeInput/timeSegments.d.ts.map +1 -0
  57. package/dist/library/components/TimeInput/timeSegments.js +94 -0
  58. package/dist/library/components/TimeInput/timeSegments.js.map +1 -0
  59. package/dist/library/components/Tooltip/Tooltip.d.ts.map +1 -1
  60. package/dist/library/components/Tooltip/Tooltip.js +3 -1
  61. package/dist/library/components/Tooltip/Tooltip.js.map +1 -1
  62. package/dist/library/index.d.ts +6 -0
  63. package/dist/library/index.d.ts.map +1 -1
  64. package/dist/library/index.js +6 -0
  65. package/dist/library/index.js.map +1 -1
  66. package/dist/library/internal/calendar.d.ts +18 -0
  67. package/dist/library/internal/calendar.d.ts.map +1 -0
  68. package/dist/library/internal/calendar.js +78 -0
  69. package/dist/library/internal/calendar.js.map +1 -0
  70. package/dist/library/internal/locale.d.ts +9 -0
  71. package/dist/library/internal/locale.d.ts.map +1 -0
  72. package/dist/library/internal/locale.js +57 -0
  73. package/dist/library/internal/locale.js.map +1 -0
  74. package/dist/library/internal/localeMatcher.d.ts +6 -0
  75. package/dist/library/internal/localeMatcher.d.ts.map +1 -0
  76. package/dist/library/internal/localeMatcher.js +52 -0
  77. package/dist/library/internal/localeMatcher.js.map +1 -0
  78. package/dist/library/internal/localizedDigits.d.ts +5 -0
  79. package/dist/library/internal/localizedDigits.d.ts.map +1 -0
  80. package/dist/library/internal/localizedDigits.js +13 -0
  81. package/dist/library/internal/localizedDigits.js.map +1 -0
  82. package/dist/library/internal/numberField.d.ts.map +1 -1
  83. package/dist/library/internal/numberField.js +14 -5
  84. package/dist/library/internal/numberField.js.map +1 -1
  85. package/dist/library/internal/popupLocale.d.ts +6 -0
  86. package/dist/library/internal/popupLocale.d.ts.map +1 -0
  87. package/dist/library/internal/popupLocale.js +22 -0
  88. package/dist/library/internal/popupLocale.js.map +1 -0
  89. package/dist/library/internal/select.d.ts +2 -1
  90. package/dist/library/internal/select.d.ts.map +1 -1
  91. package/dist/library/internal/select.js +5 -6
  92. package/dist/library/internal/select.js.map +1 -1
  93. package/dist/library/react/useComboboxPopup.d.ts +4 -1
  94. package/dist/library/react/useComboboxPopup.d.ts.map +1 -1
  95. package/dist/library/react/useComboboxPopup.js +8 -4
  96. package/dist/library/react/useComboboxPopup.js.map +1 -1
  97. package/dist/library/react/useFormReset.d.ts +4 -0
  98. package/dist/library/react/useFormReset.d.ts.map +1 -0
  99. package/dist/library/react/useFormReset.js +32 -0
  100. package/dist/library/react/useFormReset.js.map +1 -0
  101. package/dist/library/react/useLocale.d.ts +8 -0
  102. package/dist/library/react/useLocale.d.ts.map +1 -0
  103. package/dist/library/react/useLocale.js +14 -0
  104. package/dist/library/react/useLocale.js.map +1 -0
  105. package/dist/library/react/usePopoverSurface.d.ts +3 -0
  106. package/dist/library/react/usePopoverSurface.d.ts.map +1 -1
  107. package/dist/library/react/usePopoverSurface.js +18 -4
  108. package/dist/library/react/usePopoverSurface.js.map +1 -1
  109. package/dist/library/styles.css +1 -1
  110. package/dist/library/themes/components.d.ts +4 -0
  111. package/dist/library/themes/components.d.ts.map +1 -1
  112. package/dist/library/themes/components.js +1 -0
  113. package/dist/library/themes/components.js.map +1 -1
  114. package/docs/architecture.md +8 -0
  115. package/package.json +1 -1
  116. package/src/components/Autocomplete/Autocomplete.tsx +1 -13
  117. package/src/components/Calendar/Calendar.tsx +310 -0
  118. package/src/components/Combobox/Combobox.tsx +19 -6
  119. package/src/components/DatePicker/DateCalendar.tsx +83 -0
  120. package/src/components/DatePicker/DateEditor.tsx +189 -0
  121. package/src/components/DatePicker/DatePicker.tsx +117 -0
  122. package/src/components/DatePicker/dateSegments.ts +46 -0
  123. package/src/components/DateRangePicker/DateRangePicker.tsx +201 -0
  124. package/src/components/LocaleProvider/LocaleProvider.tsx +26 -0
  125. package/src/components/Menu/Menu.tsx +8 -2
  126. package/src/components/NumberField/NumberField.tsx +3 -1
  127. package/src/components/Popover/Popover.tsx +8 -1
  128. package/src/components/Select/Select.tsx +20 -9
  129. package/src/components/TimeInput/TimeInput.tsx +269 -0
  130. package/src/components/TimeInput/timeSegments.ts +102 -0
  131. package/src/components/Tooltip/Tooltip.tsx +3 -1
  132. package/src/index.ts +16 -0
  133. package/src/internal/calendar.ts +99 -0
  134. package/src/internal/locale.ts +60 -0
  135. package/src/internal/localeMatcher.ts +53 -0
  136. package/src/internal/localizedDigits.ts +14 -0
  137. package/src/internal/numberField.ts +14 -5
  138. package/src/internal/popupLocale.ts +28 -0
  139. package/src/internal/select.ts +8 -8
  140. package/src/react/useComboboxPopup.ts +9 -4
  141. package/src/react/useFormReset.ts +30 -0
  142. package/src/react/useLocale.ts +17 -0
  143. package/src/react/usePopoverSurface.ts +21 -4
  144. package/src/themes/components.ts +1 -0
@@ -0,0 +1,189 @@
1
+ 'use client'
2
+ import {
3
+ useLayoutEffect,
4
+ useMemo,
5
+ useRef,
6
+ useState,
7
+ type ReactNode,
8
+ type ComponentProps
9
+ } from 'react'
10
+ import { cn } from 'cn'
11
+ import { useField, useFieldControl, WithoutField } from '../Field/Field.js'
12
+ import { InputGroup, InputGroupInput } from '../InputGroup/InputGroup.js'
13
+ import { requireAccessibleName } from '../../internal/accessibleName.js'
14
+ import { civilTime } from '../../internal/calendar.js'
15
+ import { useComposedRefs } from '../../react/useComposedRefs.js'
16
+ import { useFormReset } from '../../react/useFormReset.js'
17
+ import { useLocale } from '../../react/useLocale.js'
18
+ import { dateSegments, type Segment, type Segments } from './dateSegments.js'
19
+ import type { CalendarProps } from '../Calendar/Calendar.js'
20
+
21
+ type EditorProps = Pick<
22
+ ComponentProps<'input'>,
23
+ | 'id'
24
+ | 'ref'
25
+ | 'name'
26
+ | 'form'
27
+ | 'disabled'
28
+ | 'required'
29
+ | 'readOnly'
30
+ | 'aria-label'
31
+ | 'aria-labelledby'
32
+ | 'aria-describedby'
33
+ | 'aria-invalid'
34
+ | 'className'
35
+ > &
36
+ Pick<CalendarProps, 'controlSize' | 'locale' | 'calendar' | 'min' | 'max' | 'isDateDisabled'> & {
37
+ value: string | null
38
+ onValueChange: (date: string | null) => void
39
+ onFormReset?: () => void
40
+ revision: number
41
+ slot: string
42
+ children?: ReactNode
43
+ }
44
+ export function DateEditor({
45
+ value,
46
+ onValueChange,
47
+ onFormReset,
48
+ revision,
49
+ slot,
50
+ children,
51
+ name,
52
+ form,
53
+ readOnly,
54
+ className,
55
+ controlSize = 'medium',
56
+ locale,
57
+ calendar,
58
+ min,
59
+ max,
60
+ isDateDisabled,
61
+ ref,
62
+ ...props
63
+ }: EditorProps) {
64
+ const field = useField()
65
+ const control = useFieldControl(props)
66
+ const labelledBy = props['aria-labelledby'] ?? field?.labelId
67
+ const label = props['aria-label']
68
+ requireAccessibleName('DatePicker', { 'aria-label': label, 'aria-labelledby': labelledBy })
69
+ if (min !== undefined) civilTime(min)
70
+ if (max !== undefined) civilTime(max)
71
+ if (min && max && min > max) throw new RangeError('DatePicker min must be on or before max.')
72
+
73
+ const language = useLocale(locale)
74
+ const format = useMemo(() => dateSegments(language, calendar), [language, calendar])
75
+ const [draft, setDraft] = useState<{
76
+ revision: number
77
+ owner: string | null
78
+ format: typeof format
79
+ parts: Segments
80
+ } | null>(null)
81
+ if (draft && (draft.owner !== value || draft.format !== format || draft.revision !== revision))
82
+ setDraft(null)
83
+ const parts =
84
+ draft && draft.owner === value && draft.format === format && draft.revision === revision
85
+ ? draft.parts
86
+ : format.display(value)
87
+ const allowed = (date: string) =>
88
+ !((min && date < min) || (max && date > max) || isDateDisabled?.(date))
89
+ const parsed = format.parse(parts)
90
+ const invalid = parsed === undefined || (parsed !== null && !allowed(parsed))
91
+ // An edited constraint can make a previously rejected draft valid. Keep the
92
+ // displayed and submitted dates together until the user makes another edit.
93
+ if (draft && !invalid && parsed !== value) setDraft(null)
94
+ const firstInput = useRef<HTMLInputElement>(null)
95
+ const firstRef = useComposedRefs(firstInput, ref)
96
+ const order = format.parts
97
+ .map(p => p.type)
98
+ .filter((p): p is Segment => p === 'year' || p === 'month' || p === 'day')
99
+
100
+ useLayoutEffect(() => {
101
+ const input = firstInput.current
102
+ input?.setCustomValidity(invalid ? 'Enter a valid, available date.' : '')
103
+ return () => input?.setCustomValidity('')
104
+ }, [invalid, format])
105
+ useFormReset(firstInput, () => {
106
+ onFormReset?.()
107
+ setDraft(null)
108
+ })
109
+
110
+ function edit(segment: Segment, input: HTMLInputElement) {
111
+ const text = format.ascii(input.value)
112
+ const limit = segment === 'year' ? format.maxYearDigits : 2
113
+ if (!/^\d*$/.test(text) || text.length > limit) return
114
+ const updated = { ...parts, [segment]: text }
115
+ const next = format.parse(updated)
116
+ const commit = next !== undefined && (next === null || allowed(next))
117
+ setDraft({ revision, owner: commit ? next : value, format, parts: updated })
118
+ if (commit) onValueChange(next)
119
+ if (text.length === limit) {
120
+ const nextPart = order[order.indexOf(segment) + 1]
121
+ if (nextPart)
122
+ input.parentElement
123
+ ?.querySelector<HTMLInputElement>('[data-segment="' + nextPart + '"]')
124
+ ?.focus()
125
+ }
126
+ }
127
+
128
+ return (
129
+ <InputGroup
130
+ data-slot={slot}
131
+ controlSize={controlSize}
132
+ // oxlint-disable-next-line jsx-a11y/prefer-tag-over-role -- InputGroup owns the shared control surface and groups its labelled segments.
133
+ role="group"
134
+ aria-label={label}
135
+ aria-labelledby={labelledBy}
136
+ className={cn('w-fit max-w-full gap-0', className)}
137
+ >
138
+ <WithoutField>
139
+ {format.parts.map((part, index) => {
140
+ if (part.type !== 'day' && part.type !== 'month' && part.type !== 'year')
141
+ return (
142
+ <span
143
+ key={index}
144
+ aria-hidden="true"
145
+ >
146
+ {part.value}
147
+ </span>
148
+ )
149
+ const segment = part.type
150
+ const first = segment === order[0]
151
+ const year = segment === 'year'
152
+ return (
153
+ <InputGroupInput
154
+ key={segment}
155
+ ref={first ? firstRef : undefined}
156
+ id={first ? control.id : undefined}
157
+ data-segment={segment}
158
+ inputMode="numeric"
159
+ autoComplete="off"
160
+ aria-label={format.names.of(segment)}
161
+ aria-describedby={control['aria-describedby']}
162
+ aria-invalid={control['aria-invalid'] || invalid || undefined}
163
+ disabled={control.disabled}
164
+ readOnly={readOnly}
165
+ required={control.required}
166
+ form={form}
167
+ placeholder={year ? 'yyyy' : segment === 'month' ? 'mm' : 'dd'}
168
+ className={cn(
169
+ 'flex-none text-center tabular-nums focus-visible:underline',
170
+ year ? 'w-[5ch]' : 'w-[2.7ch]'
171
+ )}
172
+ value={format.localize(parts[segment])}
173
+ onFocus={event => event.currentTarget.select()}
174
+ onChange={event => edit(segment, event.currentTarget)}
175
+ />
176
+ )
177
+ })}
178
+ {children}
179
+ </WithoutField>
180
+ <input
181
+ type="hidden"
182
+ name={name}
183
+ form={form}
184
+ disabled={control.disabled}
185
+ value={invalid ? '' : (value ?? '')}
186
+ />
187
+ </InputGroup>
188
+ )
189
+ }
@@ -0,0 +1,117 @@
1
+ 'use client'
2
+ import { useRef, useState, type ComponentProps } from 'react'
3
+ import type { CalendarProps } from '../Calendar/Calendar.js'
4
+ import { useFieldControl } from '../Field/Field.js'
5
+ import { Popover } from '../Popover/Popover.js'
6
+ import { useComposedRefs } from '../../react/useComposedRefs.js'
7
+ import { useControllableState } from '../../react/useControllableState.js'
8
+ import type { ValueOwner } from '../../react/useNativeOwner.js'
9
+ import { DateEditor } from './DateEditor.js'
10
+ import { DateCalendarPopup, DateCalendarTrigger } from './DateCalendar.js'
11
+
12
+ export type DatePickerProps = ValueOwner<string | null> &
13
+ Pick<
14
+ CalendarProps,
15
+ | 'locale'
16
+ | 'calendar'
17
+ | 'firstDayOfWeek'
18
+ | 'today'
19
+ | 'min'
20
+ | 'max'
21
+ | 'isDateDisabled'
22
+ | 'controlSize'
23
+ | 'previousMonthLabel'
24
+ | 'nextMonthLabel'
25
+ > &
26
+ Pick<
27
+ ComponentProps<'input'>,
28
+ | 'id'
29
+ | 'ref'
30
+ | 'name'
31
+ | 'form'
32
+ | 'disabled'
33
+ | 'required'
34
+ | 'readOnly'
35
+ | 'aria-label'
36
+ | 'aria-labelledby'
37
+ | 'aria-describedby'
38
+ | 'aria-invalid'
39
+ > & {
40
+ onValueChange?: (iso: string | null) => void
41
+ calendarLabel?: string
42
+ className?: string
43
+ }
44
+
45
+ export function DatePicker({
46
+ value,
47
+ defaultValue,
48
+ onValueChange,
49
+ calendarLabel = 'Choose date',
50
+ firstDayOfWeek,
51
+ previousMonthLabel,
52
+ nextMonthLabel,
53
+ today,
54
+ ref,
55
+ ...props
56
+ }: DatePickerProps) {
57
+ const owner = useControllableState({
58
+ name: 'DatePicker value',
59
+ value,
60
+ defaultValue,
61
+ initialValue: null,
62
+ onChange: onValueChange
63
+ })
64
+ const [open, setOpen] = useState(false)
65
+ const [revision, refresh] = useState(0)
66
+ const input = useRef<HTMLInputElement>(null)
67
+ const editorRef = useComposedRefs(input, ref)
68
+ const blocked = useFieldControl(props).disabled || props.readOnly
69
+ if (open && blocked) setOpen(false)
70
+ return (
71
+ <Popover
72
+ open={open && !blocked}
73
+ onOpenChange={setOpen}
74
+ >
75
+ <DateEditor
76
+ {...props}
77
+ slot="date-picker"
78
+ ref={editorRef}
79
+ value={owner.value}
80
+ revision={revision}
81
+ onValueChange={owner.request}
82
+ onFormReset={() => {
83
+ owner.reset()
84
+ setOpen(false)
85
+ }}
86
+ >
87
+ <DateCalendarTrigger
88
+ label={calendarLabel}
89
+ controlSize={props.controlSize}
90
+ disabled={blocked}
91
+ />
92
+ </DateEditor>
93
+ {open && !blocked && (
94
+ <DateCalendarPopup
95
+ aria-label={calendarLabel}
96
+ returnFocusRef={input}
97
+ locale={props.locale}
98
+ calendar={props.calendar}
99
+ min={props.min}
100
+ max={props.max}
101
+ isDateDisabled={props.isDateDisabled}
102
+ controlSize={props.controlSize}
103
+ today={today}
104
+ firstDayOfWeek={firstDayOfWeek}
105
+ previousMonthLabel={previousMonthLabel}
106
+ nextMonthLabel={nextMonthLabel}
107
+ value={owner.value}
108
+ onDaySelect={date => {
109
+ refresh(n => n + 1)
110
+ owner.request(date)
111
+ setOpen(false)
112
+ }}
113
+ />
114
+ )}
115
+ </Popover>
116
+ )
117
+ }
@@ -0,0 +1,46 @@
1
+ import { localizedDigits } from '../../internal/localizedDigits.js'
2
+ import { calendarFormat, civilTime, isoDate, type CalendarSystem } from '../../internal/calendar.js'
3
+
4
+ export type Segment = 'day' | 'month' | 'year'
5
+ export type Segments = Record<Segment, string>
6
+
7
+ const empty: Segments = { day: '', month: '', year: '' }
8
+
9
+ export function dateSegments(locale: string, calendar?: CalendarSystem) {
10
+ const format = calendarFormat(
11
+ locale,
12
+ calendar
13
+ )({ year: 'numeric', month: '2-digit', day: '2-digit' })
14
+ const resolved = format.resolvedOptions()
15
+ const { ascii, localize } = localizedDigits(resolved.locale, resolved.numberingSystem)
16
+ const names = new Intl.DisplayNames(resolved.locale, { type: 'dateTimeField' })
17
+ const parts = format.formatToParts(Date.UTC(2000, 10, 22))
18
+ const yearOffset = resolved.calendar === 'buddhist' ? 543 : 0
19
+ return {
20
+ parts,
21
+ names,
22
+ ascii,
23
+ localize,
24
+ maxYearDigits: String(9999 + yearOffset).length,
25
+ display(iso: string | null): Segments {
26
+ if (!iso) return empty
27
+ civilTime(iso)
28
+ const [year, month, day] = iso.split('-')
29
+ return { year: String(Number(year) + yearOffset).padStart(4, '0'), month, day }
30
+ },
31
+ parse(parts: Segments): string | null | undefined {
32
+ const { year, month, day } = parts
33
+ if (!year && !month && !day) return null
34
+ if (year.length < 4 || !month || !day) return undefined
35
+ const isoYear = Number(year) - yearOffset
36
+ if (isoYear < 1 || isoYear > 9999) return undefined
37
+ const iso = [
38
+ String(isoYear).padStart(4, '0'),
39
+ month.padStart(2, '0'),
40
+ day.padStart(2, '0')
41
+ ].join('-')
42
+ const time = Date.parse(iso + 'T00:00:00Z')
43
+ return Number.isFinite(time) && isoDate(time) === iso ? iso : undefined
44
+ }
45
+ }
46
+ }
@@ -0,0 +1,201 @@
1
+ 'use client'
2
+
3
+ import { useRef, useState, type ReactNode } from 'react'
4
+ import { cn } from 'cn'
5
+ import type { DatePickerProps } from '../DatePicker/DatePicker.js'
6
+ import { DateEditor } from '../DatePicker/DateEditor.js'
7
+ import { DateCalendarPopup, DateCalendarTrigger } from '../DatePicker/DateCalendar.js'
8
+ import { Button } from '../Button/Button.js'
9
+ import { Popover } from '../Popover/Popover.js'
10
+ import { Field, useField, useFieldControl } from '../Field/Field.js'
11
+ import { useControllableState } from '../../react/useControllableState.js'
12
+ import type { ValueOwner } from '../../react/useNativeOwner.js'
13
+ import { civilTime, rangeHasDisabledDate } from '../../internal/calendar.js'
14
+
15
+ /** Either endpoint can be typed first. Values use ISO civil dates. */
16
+ export type DateRangeValue = { start: string | null; end: string | null }
17
+ export type DateRangePreset = { label: string; start: string; end: string }
18
+ export type DateRangePickerProps = ValueOwner<DateRangeValue> &
19
+ Pick<
20
+ DatePickerProps,
21
+ | 'form'
22
+ | 'disabled'
23
+ | 'required'
24
+ | 'readOnly'
25
+ | 'locale'
26
+ | 'calendar'
27
+ | 'firstDayOfWeek'
28
+ | 'today'
29
+ | 'min'
30
+ | 'max'
31
+ | 'isDateDisabled'
32
+ | 'controlSize'
33
+ | 'calendarLabel'
34
+ | 'previousMonthLabel'
35
+ | 'nextMonthLabel'
36
+ | 'aria-invalid'
37
+ | 'aria-describedby'
38
+ | 'className'
39
+ > & {
40
+ startLabel: ReactNode
41
+ endLabel: ReactNode
42
+ startName?: string
43
+ endName?: string
44
+ onValueChange?: (range: DateRangeValue) => void
45
+ presets?: readonly DateRangePreset[]
46
+ }
47
+
48
+ const empty: DateRangeValue = { start: null, end: null }
49
+
50
+ export function DateRangePicker({
51
+ value,
52
+ defaultValue,
53
+ onValueChange,
54
+ startLabel,
55
+ endLabel,
56
+ startName,
57
+ endName,
58
+ presets,
59
+ calendarLabel = 'Choose date range',
60
+ firstDayOfWeek,
61
+ today,
62
+ previousMonthLabel,
63
+ nextMonthLabel,
64
+ className,
65
+ ...props
66
+ }: DateRangePickerProps) {
67
+ const owner = useControllableState({
68
+ name: 'DateRangePicker value',
69
+ value,
70
+ defaultValue,
71
+ initialValue: empty,
72
+ onChange: onValueChange,
73
+ equal: (left, right) => left.start === right.start && left.end === right.end
74
+ })
75
+ const { start, end } = owner.value
76
+ if (start !== null) civilTime(start)
77
+ if (end !== null) civilTime(end)
78
+ if (start && end && start > end)
79
+ throw new RangeError('DateRangePicker end must be on or after start.')
80
+ const field = useField()
81
+ const control = useFieldControl(props)
82
+ const blocked = control.disabled || props.readOnly
83
+ const required = control.required || field?.required
84
+ const [open, setOpen] = useState(false)
85
+ if (open && blocked) setOpen(false)
86
+ const [revision, refresh] = useState(0)
87
+ const firstInput = useRef<HTMLInputElement>(null)
88
+ const editorProps = {
89
+ ...props,
90
+ disabled: control.disabled,
91
+ 'aria-invalid': control['aria-invalid'],
92
+ 'aria-describedby': control['aria-describedby'] ?? field?.describedBy,
93
+ revision
94
+ }
95
+ function unavailable(from: string, to: string) {
96
+ return (
97
+ from > to ||
98
+ !!(props.min && from < props.min) ||
99
+ !!(props.max && to > props.max) ||
100
+ rangeHasDisabledDate(from, to, props.isDateDisabled)
101
+ )
102
+ }
103
+ function selectRange(range: DateRangeValue) {
104
+ owner.request(range)
105
+ refresh(current => current + 1)
106
+ if (range.end) setOpen(false)
107
+ }
108
+ return (
109
+ <Popover
110
+ open={open && !blocked}
111
+ onOpenChange={setOpen}
112
+ >
113
+ <div
114
+ data-slot="date-range-picker"
115
+ className={cn('grid w-fit max-w-full gap-2', className)}
116
+ >
117
+ <div className="flex max-w-full flex-wrap items-end gap-3">
118
+ <Field
119
+ label={startLabel}
120
+ required={required || !!end}
121
+ controlId={control.id}
122
+ >
123
+ <DateEditor
124
+ {...editorProps}
125
+ slot="date-range-start"
126
+ ref={firstInput}
127
+ value={start}
128
+ name={startName}
129
+ isDateDisabled={date => unavailable(date, end ?? date)}
130
+ onValueChange={date => owner.request({ start: date, end })}
131
+ onFormReset={() => {
132
+ owner.reset()
133
+ setOpen(false)
134
+ }}
135
+ />
136
+ </Field>
137
+ <Field
138
+ label={endLabel}
139
+ required={required || !!start}
140
+ >
141
+ <DateEditor
142
+ {...editorProps}
143
+ slot="date-range-end"
144
+ value={end}
145
+ name={endName}
146
+ isDateDisabled={date => unavailable(start ?? date, date)}
147
+ onValueChange={date => owner.request({ start, end: date })}
148
+ >
149
+ <DateCalendarTrigger
150
+ label={calendarLabel}
151
+ disabled={blocked}
152
+ controlSize={props.controlSize}
153
+ />
154
+ </DateEditor>
155
+ </Field>
156
+ </div>
157
+ {!!presets?.length && (
158
+ <div className="flex flex-wrap gap-2">
159
+ {presets.map(preset => {
160
+ civilTime(preset.start)
161
+ civilTime(preset.end)
162
+ return (
163
+ <Button
164
+ key={JSON.stringify([preset.label, preset.start, preset.end])}
165
+ controlSize={props.controlSize}
166
+ variant="outline"
167
+ tone="neutral"
168
+ disabled={blocked || unavailable(preset.start, preset.end)}
169
+ onClick={() => selectRange({ start: preset.start, end: preset.end })}
170
+ >
171
+ {preset.label}
172
+ </Button>
173
+ )
174
+ })}
175
+ </div>
176
+ )}
177
+ {open && !blocked && (
178
+ <DateCalendarPopup
179
+ type="range"
180
+ aria-label={calendarLabel}
181
+ returnFocusRef={firstInput}
182
+ locale={props.locale}
183
+ calendar={props.calendar}
184
+ firstDayOfWeek={firstDayOfWeek}
185
+ today={today}
186
+ min={props.min}
187
+ max={props.max}
188
+ isDateDisabled={props.isDateDisabled}
189
+ controlSize={props.controlSize}
190
+ previousMonthLabel={previousMonthLabel}
191
+ nextMonthLabel={nextMonthLabel}
192
+ value={start ? { start, end } : null}
193
+ onValueChange={range => {
194
+ if (range) selectRange(range)
195
+ }}
196
+ />
197
+ )}
198
+ </div>
199
+ </Popover>
200
+ )
201
+ }
@@ -0,0 +1,26 @@
1
+ 'use client'
2
+
3
+ import type { ReactNode } from 'react'
4
+ import { getLocaleAttributes } from '../../internal/locale.js'
5
+ import { LocaleContext, useLocale } from '../../react/useLocale.js'
6
+
7
+ export type LocaleProviderProps = {
8
+ locale?: string
9
+ scope?: 'subtree' | 'document'
10
+ children?: ReactNode
11
+ }
12
+
13
+ /** Use document scope when the root layout renders lang and dir on html. */
14
+ export function LocaleProvider({
15
+ locale,
16
+ scope = 'subtree',
17
+ children
18
+ }: LocaleProviderProps): ReactNode {
19
+ const current = useLocale(locale)
20
+ const attributes = getLocaleAttributes(locale)
21
+ return (
22
+ <LocaleContext.Provider value={current}>
23
+ {scope === 'document' ? children : <div {...attributes}>{children}</div>}
24
+ </LocaleContext.Provider>
25
+ )
26
+ }
@@ -40,6 +40,7 @@ import { composeAction } from '../../internal/events.js'
40
40
  import { joinIds } from '../../internal/ids.js'
41
41
  import { matchSelectText } from '../../internal/select.js'
42
42
  import { useComposedRefs } from '../../react/useComposedRefs.js'
43
+ import { useLocaleMatcher } from '../../react/useLocale.js'
43
44
 
44
45
  export type MenuProps = PopoverProps
45
46
  export type MenuState = PopoverState
@@ -259,6 +260,7 @@ export function MenuContentRoot({
259
260
  ...props
260
261
  }: MenuContentProps & { onFocusOutside?: () => void }) {
261
262
  const menu = useMenuContext()
263
+ const matcher = useLocaleMatcher()
262
264
  const nested = !!menu.parent || menu.family === 'menubar'
263
265
  const triggerId = menu.triggerId
264
266
  const capture = useCallback(
@@ -294,6 +296,9 @@ export function MenuContentRoot({
294
296
  const options = items(node)
295
297
  focusItem(node, edge === 'last' ? options.at(-1) : options[0])
296
298
  }, [menu.open, menu.content, menu.intent])
299
+ useLayoutEffect(() => {
300
+ search.current = { text: '', time: 0 }
301
+ }, [matcher])
297
302
  return (
298
303
  <PopoverContentRoot
299
304
  {...props}
@@ -335,7 +340,7 @@ export function MenuContentRoot({
335
340
  else if (event.key === 'ArrowDown') next = options[(index + 1) % options.length]
336
341
  else if (event.key === 'ArrowUp')
337
342
  next = options[(index - 1 + options.length) % options.length]
338
- else if (event.key.length === 1 && event.key !== ' ') {
343
+ else if (matcher.isSingleKey(event.key) && event.key !== ' ') {
339
344
  const now = node.ownerDocument.defaultView!.performance.now()
340
345
  search.current.text =
341
346
  (now - search.current.time > 700 ? '' : search.current.text) + event.key
@@ -346,7 +351,8 @@ export function MenuContentRoot({
346
351
  textValue: item.dataset.textValue ?? item.textContent ?? ''
347
352
  })),
348
353
  search.current.text,
349
- String(index)
354
+ String(index),
355
+ matcher
350
356
  )
351
357
  if (match !== undefined) next = options[Number(match)]
352
358
  } else return
@@ -22,6 +22,7 @@ import {
22
22
  import type { ValueOwner } from '../../react/useNativeOwner.js'
23
23
  import { useControllableState } from '../../react/useControllableState.js'
24
24
  import { useComposedRefs } from '../../react/useComposedRefs.js'
25
+ import { useLocale } from '../../react/useLocale.js'
25
26
  export type { NumberFieldFormatOptions } from '../../internal/numberField.js'
26
27
 
27
28
  export type NumberFieldProps = DistributiveOmit<
@@ -62,7 +63,7 @@ export function NumberField({
62
63
  max,
63
64
  step = 1,
64
65
  largeStep = step * 10,
65
- locale = 'en-US',
66
+ locale: localeProp,
66
67
  formatOptions,
67
68
  incrementLabel = 'Increase value',
68
69
  decrementLabel = 'Decrease value',
@@ -109,6 +110,7 @@ export function NumberField({
109
110
  const control = useFieldControl(props),
110
111
  input = useRef<HTMLInputElement>(null),
111
112
  composed = useComposedRefs(input, ref)
113
+ const locale = useLocale(localeProp)
112
114
  const adapter = useMemo(() => createNumberAdapter(locale, formatOptions), [locale, formatOptions])
113
115
  const [draft, setDraft] = useState<{ value: number | null; text: string; key: string } | null>(
114
116
  null
@@ -211,6 +211,7 @@ export function PopoverContent(props: PopoverContentProps) {
211
211
  /** Private focus-leave timing seam; native pointer/Escape dismissal stays shared. */
212
212
  export function PopoverContentRoot({
213
213
  onFocusOutside,
214
+ returnFocusRef,
214
215
  ref,
215
216
  className,
216
217
  side = 'bottom',
@@ -220,7 +221,10 @@ export function PopoverContentRoot({
220
221
  initialFocusRef,
221
222
  motion = 'inherit',
222
223
  ...props
223
- }: PopoverContentProps & { onFocusOutside?: () => void }) {
224
+ }: PopoverContentProps & {
225
+ onFocusOutside?: () => void
226
+ returnFocusRef?: RefObject<HTMLElement | null>
227
+ }) {
224
228
  const popover = usePopoverContext()
225
229
  if (![sideOffset, collisionPadding].every(value => Number.isFinite(value) && value >= 0))
226
230
  throw new TypeError('Popover offsets and padding must be finite, nonnegative numbers.')
@@ -242,7 +246,10 @@ export function PopoverContentRoot({
242
246
  sideOffset,
243
247
  collisionPadding,
244
248
  initialFocusRef,
249
+ returnFocusRef,
245
250
  onFocusOutside,
251
+ lang: props.lang,
252
+ dir: props.dir,
246
253
  anchorPoint: popover.anchorPoint
247
254
  }
248
255
  )