@cognitap/radiant 0.0.80 → 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 (171) hide show
  1. package/CHANGELOG.md +25 -0
  2. package/dist/library/charts/Charts.d.ts +1 -2
  3. package/dist/library/charts/Charts.d.ts.map +1 -1
  4. package/dist/library/charts/Charts.js +4 -4
  5. package/dist/library/charts/Charts.js.map +1 -1
  6. package/dist/library/components/AppShell/AppShell.d.ts +1 -6
  7. package/dist/library/components/AppShell/AppShell.d.ts.map +1 -1
  8. package/dist/library/components/AppShell/AppShell.js +4 -10
  9. package/dist/library/components/AppShell/AppShell.js.map +1 -1
  10. package/dist/library/components/Autocomplete/Autocomplete.d.ts +1 -1
  11. package/dist/library/components/Autocomplete/Autocomplete.d.ts.map +1 -1
  12. package/dist/library/components/Autocomplete/Autocomplete.js +2 -6
  13. package/dist/library/components/Autocomplete/Autocomplete.js.map +1 -1
  14. package/dist/library/components/Calendar/Calendar.d.ts +39 -0
  15. package/dist/library/components/Calendar/Calendar.d.ts.map +1 -0
  16. package/dist/library/components/Calendar/Calendar.js +143 -0
  17. package/dist/library/components/Calendar/Calendar.js.map +1 -0
  18. package/dist/library/components/Carousel/Carousel.d.ts +9 -5
  19. package/dist/library/components/Carousel/Carousel.d.ts.map +1 -1
  20. package/dist/library/components/Carousel/Carousel.js +14 -6
  21. package/dist/library/components/Carousel/Carousel.js.map +1 -1
  22. package/dist/library/components/Combobox/Combobox.d.ts +6 -0
  23. package/dist/library/components/Combobox/Combobox.d.ts.map +1 -1
  24. package/dist/library/components/Combobox/Combobox.js +51 -10
  25. package/dist/library/components/Combobox/Combobox.js.map +1 -1
  26. package/dist/library/components/Combobox/comboboxStyles.d.ts +3 -0
  27. package/dist/library/components/Combobox/comboboxStyles.d.ts.map +1 -1
  28. package/dist/library/components/Combobox/comboboxStyles.js +20 -1
  29. package/dist/library/components/Combobox/comboboxStyles.js.map +1 -1
  30. package/dist/library/components/DatePicker/DateCalendar.d.ts +13 -0
  31. package/dist/library/components/DatePicker/DateCalendar.d.ts.map +1 -0
  32. package/dist/library/components/DatePicker/DateCalendar.js +25 -0
  33. package/dist/library/components/DatePicker/DateCalendar.js.map +1 -0
  34. package/dist/library/components/DatePicker/DateEditor.d.ts +13 -0
  35. package/dist/library/components/DatePicker/DateEditor.d.ts.map +1 -0
  36. package/dist/library/components/DatePicker/DateEditor.js +84 -0
  37. package/dist/library/components/DatePicker/DateEditor.js.map +1 -0
  38. package/dist/library/components/DatePicker/DatePicker.d.ts +10 -0
  39. package/dist/library/components/DatePicker/DatePicker.d.ts.map +1 -0
  40. package/dist/library/components/DatePicker/DatePicker.js +34 -0
  41. package/dist/library/components/DatePicker/DatePicker.js.map +1 -0
  42. package/dist/library/components/DatePicker/dateSegments.d.ts +13 -0
  43. package/dist/library/components/DatePicker/dateSegments.d.ts.map +1 -0
  44. package/dist/library/components/DatePicker/dateSegments.js +43 -0
  45. package/dist/library/components/DatePicker/dateSegments.js.map +1 -0
  46. package/dist/library/components/DateRangePicker/DateRangePicker.d.ts +23 -0
  47. package/dist/library/components/DateRangePicker/DateRangePicker.d.ts.map +1 -0
  48. package/dist/library/components/DateRangePicker/DateRangePicker.js +69 -0
  49. package/dist/library/components/DateRangePicker/DateRangePicker.js.map +1 -0
  50. package/dist/library/components/LocaleProvider/LocaleProvider.d.ts +9 -0
  51. package/dist/library/components/LocaleProvider/LocaleProvider.d.ts.map +1 -0
  52. package/dist/library/components/LocaleProvider/LocaleProvider.js +11 -0
  53. package/dist/library/components/LocaleProvider/LocaleProvider.js.map +1 -0
  54. package/dist/library/components/Menu/Menu.d.ts.map +1 -1
  55. package/dist/library/components/Menu/Menu.js +7 -2
  56. package/dist/library/components/Menu/Menu.js.map +1 -1
  57. package/dist/library/components/MultiSelect/MultiSelect.d.ts +4 -1
  58. package/dist/library/components/MultiSelect/MultiSelect.d.ts.map +1 -1
  59. package/dist/library/components/MultiSelect/MultiSelect.js +6 -1
  60. package/dist/library/components/MultiSelect/MultiSelect.js.map +1 -1
  61. package/dist/library/components/NumberField/NumberField.d.ts +1 -1
  62. package/dist/library/components/NumberField/NumberField.d.ts.map +1 -1
  63. package/dist/library/components/NumberField/NumberField.js +3 -1
  64. package/dist/library/components/NumberField/NumberField.js.map +1 -1
  65. package/dist/library/components/Popover/Popover.d.ts +2 -1
  66. package/dist/library/components/Popover/Popover.d.ts.map +1 -1
  67. package/dist/library/components/Popover/Popover.js +4 -1
  68. package/dist/library/components/Popover/Popover.js.map +1 -1
  69. package/dist/library/components/Select/Select.d.ts.map +1 -1
  70. package/dist/library/components/Select/Select.js +18 -9
  71. package/dist/library/components/Select/Select.js.map +1 -1
  72. package/dist/library/components/TimeInput/TimeInput.d.ts +18 -0
  73. package/dist/library/components/TimeInput/TimeInput.d.ts.map +1 -0
  74. package/dist/library/components/TimeInput/TimeInput.js +123 -0
  75. package/dist/library/components/TimeInput/TimeInput.js.map +1 -0
  76. package/dist/library/components/TimeInput/timeSegments.d.ts +24 -0
  77. package/dist/library/components/TimeInput/timeSegments.d.ts.map +1 -0
  78. package/dist/library/components/TimeInput/timeSegments.js +94 -0
  79. package/dist/library/components/TimeInput/timeSegments.js.map +1 -0
  80. package/dist/library/components/Tooltip/Tooltip.d.ts.map +1 -1
  81. package/dist/library/components/Tooltip/Tooltip.js +3 -1
  82. package/dist/library/components/Tooltip/Tooltip.js.map +1 -1
  83. package/dist/library/index.d.ts +12 -6
  84. package/dist/library/index.d.ts.map +1 -1
  85. package/dist/library/index.js +9 -3
  86. package/dist/library/index.js.map +1 -1
  87. package/dist/library/internal/calendar.d.ts +18 -0
  88. package/dist/library/internal/calendar.d.ts.map +1 -0
  89. package/dist/library/internal/calendar.js +78 -0
  90. package/dist/library/internal/calendar.js.map +1 -0
  91. package/dist/library/internal/locale.d.ts +9 -0
  92. package/dist/library/internal/locale.d.ts.map +1 -0
  93. package/dist/library/internal/locale.js +57 -0
  94. package/dist/library/internal/locale.js.map +1 -0
  95. package/dist/library/internal/localeMatcher.d.ts +6 -0
  96. package/dist/library/internal/localeMatcher.d.ts.map +1 -0
  97. package/dist/library/internal/localeMatcher.js +52 -0
  98. package/dist/library/internal/localeMatcher.js.map +1 -0
  99. package/dist/library/internal/localizedDigits.d.ts +5 -0
  100. package/dist/library/internal/localizedDigits.d.ts.map +1 -0
  101. package/dist/library/internal/localizedDigits.js +13 -0
  102. package/dist/library/internal/localizedDigits.js.map +1 -0
  103. package/dist/library/internal/numberField.d.ts.map +1 -1
  104. package/dist/library/internal/numberField.js +14 -5
  105. package/dist/library/internal/numberField.js.map +1 -1
  106. package/dist/library/internal/popupLocale.d.ts +6 -0
  107. package/dist/library/internal/popupLocale.d.ts.map +1 -0
  108. package/dist/library/internal/popupLocale.js +22 -0
  109. package/dist/library/internal/popupLocale.js.map +1 -0
  110. package/dist/library/internal/select.d.ts +2 -1
  111. package/dist/library/internal/select.d.ts.map +1 -1
  112. package/dist/library/internal/select.js +5 -6
  113. package/dist/library/internal/select.js.map +1 -1
  114. package/dist/library/react/useComboboxPopup.d.ts +4 -1
  115. package/dist/library/react/useComboboxPopup.d.ts.map +1 -1
  116. package/dist/library/react/useComboboxPopup.js +13 -7
  117. package/dist/library/react/useComboboxPopup.js.map +1 -1
  118. package/dist/library/react/useFormReset.d.ts +4 -0
  119. package/dist/library/react/useFormReset.d.ts.map +1 -0
  120. package/dist/library/react/useFormReset.js +32 -0
  121. package/dist/library/react/useFormReset.js.map +1 -0
  122. package/dist/library/react/useLocale.d.ts +8 -0
  123. package/dist/library/react/useLocale.d.ts.map +1 -0
  124. package/dist/library/react/useLocale.js +14 -0
  125. package/dist/library/react/useLocale.js.map +1 -0
  126. package/dist/library/react/usePopoverSurface.d.ts +3 -0
  127. package/dist/library/react/usePopoverSurface.d.ts.map +1 -1
  128. package/dist/library/react/usePopoverSurface.js +18 -4
  129. package/dist/library/react/usePopoverSurface.js.map +1 -1
  130. package/dist/library/styles.css +1 -1
  131. package/dist/library/themes/components.d.ts +4 -0
  132. package/dist/library/themes/components.d.ts.map +1 -1
  133. package/dist/library/themes/components.js +1 -0
  134. package/dist/library/themes/components.js.map +1 -1
  135. package/docs/architecture.md +8 -0
  136. package/docs/theming.md +10 -10
  137. package/package.json +1 -1
  138. package/src/charts/Charts.tsx +10 -7
  139. package/src/components/AppShell/AppShell.tsx +4 -14
  140. package/src/components/Autocomplete/Autocomplete.tsx +1 -13
  141. package/src/components/Calendar/Calendar.tsx +310 -0
  142. package/src/components/Carousel/Carousel.tsx +34 -6
  143. package/src/components/Combobox/Combobox.tsx +95 -19
  144. package/src/components/Combobox/comboboxStyles.ts +22 -1
  145. package/src/components/DatePicker/DateCalendar.tsx +83 -0
  146. package/src/components/DatePicker/DateEditor.tsx +189 -0
  147. package/src/components/DatePicker/DatePicker.tsx +117 -0
  148. package/src/components/DatePicker/dateSegments.ts +46 -0
  149. package/src/components/DateRangePicker/DateRangePicker.tsx +201 -0
  150. package/src/components/LocaleProvider/LocaleProvider.tsx +26 -0
  151. package/src/components/Menu/Menu.tsx +8 -2
  152. package/src/components/MultiSelect/MultiSelect.tsx +8 -0
  153. package/src/components/NumberField/NumberField.tsx +3 -1
  154. package/src/components/Popover/Popover.tsx +8 -1
  155. package/src/components/Select/Select.tsx +20 -9
  156. package/src/components/TimeInput/TimeInput.tsx +269 -0
  157. package/src/components/TimeInput/timeSegments.ts +102 -0
  158. package/src/components/Tooltip/Tooltip.tsx +3 -1
  159. package/src/index.ts +23 -4
  160. package/src/internal/calendar.ts +99 -0
  161. package/src/internal/locale.ts +60 -0
  162. package/src/internal/localeMatcher.ts +53 -0
  163. package/src/internal/localizedDigits.ts +14 -0
  164. package/src/internal/numberField.ts +14 -5
  165. package/src/internal/popupLocale.ts +28 -0
  166. package/src/internal/select.ts +8 -8
  167. package/src/react/useComboboxPopup.ts +14 -7
  168. package/src/react/useFormReset.ts +30 -0
  169. package/src/react/useLocale.ts +17 -0
  170. package/src/react/usePopoverSurface.ts +21 -4
  171. package/src/themes/components.ts +1 -0
@@ -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
@@ -11,6 +11,7 @@ import {
11
11
  ComboboxItem,
12
12
  ComboboxStatus,
13
13
  ComboboxTags,
14
+ ComboboxControl,
14
15
  useCombobox,
15
16
  type ComboboxMultipleProps,
16
17
  type ComboboxMultipleState,
@@ -22,6 +23,7 @@ import {
22
23
  type ComboboxItemProps,
23
24
  type ComboboxStatusProps,
24
25
  type ComboboxTagsProps,
26
+ type ComboboxControlProps,
25
27
  type ComboboxRenderProps
26
28
  } from '../Combobox/Combobox.js'
27
29
  import type { DistributiveOmit } from '../../internal/types.js'
@@ -39,6 +41,7 @@ export type MultiSelectContentProps = ComboboxContentProps
39
41
  export type MultiSelectItemProps = ComboboxItemProps
40
42
  export type MultiSelectStatusProps = ComboboxStatusProps
41
43
  export type MultiSelectTagsProps = ComboboxTagsProps
44
+ export type MultiSelectControlProps = ComboboxControlProps
42
45
  export type MultiSelectRenderProps = ComboboxRenderProps
43
46
 
44
47
  export function useMultiSelect(): MultiSelectState | null {
@@ -91,3 +94,8 @@ export function MultiSelectTags(props: MultiSelectTagsProps) {
91
94
  useMultiSelectContext()
92
95
  return <ComboboxTags {...props} />
93
96
  }
97
+ /** The field well around the chips, input and buttons. */
98
+ export function MultiSelectControl(props: MultiSelectControlProps) {
99
+ useMultiSelectContext()
100
+ return <ComboboxControl {...props} />
101
+ }
@@ -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
  )
@@ -20,8 +20,10 @@ import { cn } from 'cn'
20
20
  import { joinIds } from '../../internal/ids.js'
21
21
  import { controlMetrics, itemGroupLabelClass } from '../shared/controlStyles.js'
22
22
  import { matchSelectText, moveSelectFocus, positionSelect } from '../../internal/select.js'
23
+ import { observeAnchorLocale, syncPopupLocale } from '../../internal/popupLocale.js'
23
24
  import { useComposedRefs } from '../../react/useComposedRefs.js'
24
25
  import { useControllableState } from '../../react/useControllableState.js'
26
+ import { useLocaleMatcher } from '../../react/useLocale.js'
25
27
  import { useTransitionHost } from '../../motion/host.js'
26
28
  import type { StateOwner, ValueOwner } from '../../react/useNativeOwner.js'
27
29
  import type { ControlSize } from '../../presentation.js'
@@ -75,6 +77,7 @@ type Context = SelectState & {
75
77
  commit(value: string): void
76
78
  close(restore?: boolean): void
77
79
  search(key: string, current: string | null): string | undefined
80
+ isSearchKey(key: string): boolean
78
81
  restoreFocus: RefObject<boolean>
79
82
  }
80
83
  const SelectContext = createContext<Context | null>(null)
@@ -108,6 +111,7 @@ export function Select({
108
111
  children
109
112
  }: SelectProps) {
110
113
  const ids = useId()
114
+ const matcher = useLocaleMatcher()
111
115
  const field = useField()
112
116
  const disabled = !!(disabledProp || field?.disabled)
113
117
  const required = !!(requiredProp || field?.required)
@@ -140,7 +144,7 @@ export function Select({
140
144
  const restoreFocus = useRef(true)
141
145
  const pendingUser = useRef<string | null>(null)
142
146
  const dispatching = useRef(false)
143
- const searchBuffer = useRef({ text: '', at: 0 })
147
+ const searchBuffer = useRef({ text: '', at: 0, matcher })
144
148
  const selected = items.find(item => item.value === selection.value)
145
149
  const nativeValue = selected?.value ?? ''
146
150
  const [initialNativeValue] = useState(nativeValue)
@@ -148,7 +152,7 @@ export function Select({
148
152
  const unavailable = () => disabled || readOnly || !!trigger?.matches(':disabled')
149
153
  const setOpen = (next: boolean) => {
150
154
  if (next && unavailable()) return
151
- searchBuffer.current = { text: '', at: 0 }
155
+ searchBuffer.current = { text: '', at: 0, matcher }
152
156
  restoreFocus.current = true
153
157
  expansion.request(next)
154
158
  }
@@ -237,11 +241,14 @@ export function Select({
237
241
  commit,
238
242
  close,
239
243
  restoreFocus,
244
+ isSearchKey: matcher.isSingleKey,
240
245
  search(key, current) {
241
246
  const now = Date.now()
242
- const text = (now - searchBuffer.current.at < 1000 ? searchBuffer.current.text : '') + key
243
- searchBuffer.current = { text, at: now }
244
- return matchSelectText(entries, text, current)
247
+ const previous = searchBuffer.current
248
+ const text =
249
+ (previous.matcher === matcher && now - previous.at < 1000 ? previous.text : '') + key
250
+ searchBuffer.current = { text, at: now, matcher }
251
+ return matchSelectText(entries, text, current, matcher)
245
252
  }
246
253
  }
247
254
  return (
@@ -376,7 +383,7 @@ export function SelectTrigger({
376
383
  if (['Enter', ' ', 'ArrowDown', 'ArrowUp'].includes(event.key)) {
377
384
  event.preventDefault()
378
385
  select.setOpen(true)
379
- } else if (event.key.length === 1) {
386
+ } else if (select.isSearchKey(event.key)) {
380
387
  const next = select.search(event.key, select.value)
381
388
  if (next !== undefined) {
382
389
  event.preventDefault()
@@ -473,6 +480,7 @@ export function SelectContent({
473
480
  ...props
474
481
  }: SelectContentProps) {
475
482
  const select = useSelectContext()
483
+ const { lang, dir } = props
476
484
  const mergedRef = useComposedRefs(select.content, ref)
477
485
  const {
478
486
  ref: transitionRef,
@@ -511,9 +519,11 @@ export function SelectContent({
511
519
  }
512
520
  // Top-layer auto layout is viewport-sized. Establish the anchor width before it can paint.
513
521
  seedWidth()
522
+ syncPopupLocale(trigger, node, { lang, dir })
514
523
  node.showPopover()
515
524
  const place = () => {
516
525
  if (!node.isConnected || !node.matches(':popover-open')) return
526
+ const rtl = syncPopupLocale(trigger, node, { lang, dir })
517
527
  seedWidth()
518
528
  const viewport = win.visualViewport
519
529
  const selected = Array.from(
@@ -544,7 +554,7 @@ export function SelectContent({
544
554
  padding: Math.max(0, collisionPadding),
545
555
  offset: sideOffset,
546
556
  aligned: position === 'item-aligned',
547
- rtl: win.getComputedStyle(trigger).direction === 'rtl'
557
+ rtl
548
558
  })
549
559
  for (const [key, value] of Object.entries({
550
560
  top: next.top,
@@ -594,6 +604,7 @@ export function SelectContent({
594
604
  const observer = new win.ResizeObserver(schedule)
595
605
  const mutations = new win.MutationObserver(schedule)
596
606
  mutations.observe(node, { childList: true, subtree: true, characterData: true })
607
+ observeAnchorLocale(mutations, trigger)
597
608
  observer.observe(trigger)
598
609
  observer.observe(node)
599
610
  doc.addEventListener('pointerdown', outside, true)
@@ -613,7 +624,7 @@ export function SelectContent({
613
624
  win.visualViewport?.removeEventListener('resize', place)
614
625
  win.visualViewport?.removeEventListener('scroll', place)
615
626
  }
616
- }, [select.open, select.trigger, select.items, position, sideOffset, collisionPadding])
627
+ }, [select.open, select.trigger, select.items, position, sideOffset, collisionPadding, lang, dir])
617
628
  useLayoutEffect(() => {
618
629
  const node = select.content.current
619
630
  const trigger = select.trigger
@@ -665,7 +676,7 @@ export function SelectContent({
665
676
  if (['ArrowDown', 'ArrowUp', 'Home', 'End'].includes(event.key)) {
666
677
  event.preventDefault()
667
678
  select.focus(moveSelectFocus(select.entries, current, event.key))
668
- } else if (event.key.length === 1 && event.key !== ' ') {
679
+ } else if (select.isSearchKey(event.key) && event.key !== ' ') {
669
680
  event.preventDefault()
670
681
  select.focus(select.search(event.key, current))
671
682
  }