@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,60 @@
1
+ export const defaultLocale = 'en-US'
2
+
3
+ // Right-to-left scripts from Unicode CLDR script metadata, including script variants.
4
+ const rtlScripts = new Set([
5
+ 'Adlm',
6
+ 'Arab',
7
+ 'Aran',
8
+ 'Armi',
9
+ 'Avst',
10
+ 'Chrs',
11
+ 'Elym',
12
+ 'Gara',
13
+ 'Hatr',
14
+ 'Hebr',
15
+ 'Hung',
16
+ 'Khar',
17
+ 'Lydi',
18
+ 'Mand',
19
+ 'Mani',
20
+ 'Mend',
21
+ 'Merc',
22
+ 'Mero',
23
+ 'Narb',
24
+ 'Nbat',
25
+ 'Nkoo',
26
+ 'Orkh',
27
+ 'Ougr',
28
+ 'Palm',
29
+ 'Phli',
30
+ 'Phlp',
31
+ 'Phnx',
32
+ 'Prti',
33
+ 'Rohg',
34
+ 'Samr',
35
+ 'Sarb',
36
+ 'Sidt',
37
+ 'Sogd',
38
+ 'Sogo',
39
+ 'Syrc',
40
+ 'Syre',
41
+ 'Syrj',
42
+ 'Syrn',
43
+ 'Thaa',
44
+ 'Yezi'
45
+ ])
46
+
47
+ export function getLocaleAttributes(locale?: string): { lang?: string; dir?: 'ltr' | 'rtl' } {
48
+ if (locale === undefined) return {}
49
+ const tag = new Intl.Locale(locale)
50
+ const script = tag.script ?? tag.maximize().script
51
+ return { lang: tag.baseName, dir: script && rtlScripts.has(script) ? 'rtl' : 'ltr' }
52
+ }
53
+
54
+ type LocaleSupport = Pick<typeof Intl.NumberFormat, 'supportedLocalesOf'>
55
+
56
+ export function supportedLocale(service: LocaleSupport, locale: string): string {
57
+ return service.supportedLocalesOf(locale, { localeMatcher: 'lookup' }).length
58
+ ? locale
59
+ : defaultLocale
60
+ }
@@ -0,0 +1,53 @@
1
+ import { supportedLocale } from './locale.js'
2
+
3
+ const asciiWords = /^[A-Za-z0-9 ]*$/
4
+
5
+ export function createLocaleMatcher(locale: string) {
6
+ const collator = new Intl.Collator(supportedLocale(Intl.Collator, locale), {
7
+ localeMatcher: 'lookup',
8
+ usage: 'search',
9
+ sensitivity: 'accent',
10
+ ignorePunctuation: false
11
+ })
12
+ const segmenter = new Intl.Segmenter(supportedLocale(Intl.Segmenter, locale), {
13
+ localeMatcher: 'lookup'
14
+ })
15
+ const matches = (left: string, right: string) => collator.compare(left, right) === 0
16
+
17
+ function match(query: string, mode: 'prefix' | 'substring') {
18
+ if (!query) return () => true
19
+ const matchingLocale = collator.resolvedOptions().locale
20
+ const foldedQuery = asciiWords.test(query) ? query.toLocaleLowerCase(matchingLocale) : undefined
21
+ return (text: string) => {
22
+ if (foldedQuery !== undefined && asciiWords.test(text)) {
23
+ const folded = text.toLocaleLowerCase(matchingLocale)
24
+ return mode === 'prefix' ? folded.startsWith(foldedQuery) : folded.includes(foldedQuery)
25
+ }
26
+ const offsets = [
27
+ 0,
28
+ ...Array.from(segmenter.segment(text), ({ index, segment }) => index + segment.length)
29
+ ]
30
+ // A collation match can span a different number of graphemes than the query.
31
+ const starts = mode === 'prefix' ? 1 : offsets.length - 1
32
+ for (let start = 0; start < starts; start++) {
33
+ for (let end = start + 1; end < offsets.length; end++) {
34
+ if (matches(text.slice(offsets[start], offsets[end]), query)) return true
35
+ }
36
+ }
37
+ return false
38
+ }
39
+ }
40
+
41
+ return {
42
+ match,
43
+ typeaheadQuery(text: string) {
44
+ const keys = Array.from(segmenter.segment(text), ({ segment }) => segment)
45
+ const first = keys[0] ?? ''
46
+ return keys.every(key => matches(key, first)) ? first : text
47
+ },
48
+ isSingleKey(text: string) {
49
+ const first = segmenter.segment(text).containing(0)
50
+ return first?.segment === text
51
+ }
52
+ }
53
+ }
@@ -0,0 +1,14 @@
1
+ export function localizedDigits(locale: string, numberingSystem: string) {
2
+ const numbers = new Intl.NumberFormat(locale, {
3
+ numberingSystem,
4
+ useGrouping: false
5
+ })
6
+ const digits = Array.from({ length: 10 }, (_, i) => numbers.format(i))
7
+ function ascii(text: string) {
8
+ return Array.from(text, char =>
9
+ digits.includes(char) ? String(digits.indexOf(char)) : char
10
+ ).join('')
11
+ }
12
+ const localize = (text: string) => text.replace(/[0-9]/g, digit => digits[Number(digit)])
13
+ return { ascii, localize }
14
+ }
@@ -1,4 +1,5 @@
1
1
  import { addDecimal } from './decimal.js'
2
+ import { supportedLocale } from './locale.js'
2
3
 
3
4
  /** A bounded editable decimal adapter; Intl supplies display and locale symbols. */
4
5
  export type NumberFieldFormatOptions = {
@@ -15,6 +16,7 @@ const clean = (text: string) =>
15
16
  text.replace(/[\u061c\u200e\u200f]/g, '').replace(/[\u00a0\u202f]/g, ' ')
16
17
  const numeric = new Set(['integer', 'group', 'decimal', 'fraction'])
17
18
  export function createNumberAdapter(locale: string, options: NumberFieldFormatOptions = {}) {
19
+ locale = supportedLocale(Intl.NumberFormat, locale)
18
20
  const allowed = new Set([
19
21
  'style',
20
22
  'currency',
@@ -34,14 +36,20 @@ export function createNumberAdapter(locale: string, options: NumberFieldFormatOp
34
36
  !['auto', 'always', 'exceptZero'].includes(options.signDisplay))
35
37
  )
36
38
  throw new TypeError('NumberField supports standard decimal, percent and currency formatting.')
37
- const formatter = new Intl.NumberFormat(locale, { maximumFractionDigits: 20, ...options })
39
+ const formatter = new Intl.NumberFormat(locale, {
40
+ maximumFractionDigits: 20,
41
+ ...options,
42
+ localeMatcher: 'lookup'
43
+ })
38
44
  const resolved = formatter.resolvedOptions()
39
- const decimal = new Intl.NumberFormat(locale, {
45
+ const decimal = new Intl.NumberFormat(resolved.locale, {
46
+ localeMatcher: 'lookup',
40
47
  numberingSystem: resolved.numberingSystem,
41
48
  maximumFractionDigits: 20
42
49
  })
43
50
  const digits = new Map<string, string>()
44
- const digitFormatter = new Intl.NumberFormat(locale, {
51
+ const digitFormatter = new Intl.NumberFormat(resolved.locale, {
52
+ localeMatcher: 'lookup',
45
53
  numberingSystem: resolved.numberingSystem,
46
54
  useGrouping: false
47
55
  })
@@ -76,10 +84,11 @@ export function createNumberAdapter(locale: string, options: NumberFieldFormatOp
76
84
  sign: value < 0 ? -1 : 1
77
85
  }
78
86
  })
79
- const plus = new Intl.NumberFormat(locale, {
87
+ const plus = new Intl.NumberFormat(resolved.locale, {
80
88
  maximumFractionDigits: 20,
81
89
  ...options,
82
- signDisplay: 'always'
90
+ signDisplay: 'always',
91
+ localeMatcher: 'lookup'
83
92
  }).formatToParts(1)
84
93
  affixes.push({
85
94
  prefix: clean(
@@ -0,0 +1,28 @@
1
+ function parent(element: Element): Element | null {
2
+ const root = element.getRootNode()
3
+ return element.assignedSlot ?? element.parentElement ?? (root as ShadowRoot).host ?? null
4
+ }
5
+
6
+ export function observeAnchorLocale(observer: MutationObserver, anchor: HTMLElement) {
7
+ for (let element: Element | null = anchor; element; element = parent(element))
8
+ observer.observe(element, { attributeFilter: ['lang', 'dir', 'class', 'style'] })
9
+ }
10
+
11
+ export function syncPopupLocale(
12
+ anchor: HTMLElement,
13
+ popup: HTMLElement,
14
+ { lang, dir }: { lang?: string; dir?: string }
15
+ ) {
16
+ for (
17
+ let element: Element | null = anchor;
18
+ lang === undefined && element;
19
+ element = parent(element)
20
+ )
21
+ lang = element.getAttribute('lang') ?? undefined
22
+ const direction = anchor.ownerDocument.defaultView!.getComputedStyle(anchor).direction
23
+ dir ??= direction
24
+ if (lang === undefined) popup.removeAttribute('lang')
25
+ else if (popup.getAttribute('lang') !== lang) popup.setAttribute('lang', lang)
26
+ if (popup.getAttribute('dir') !== dir) popup.setAttribute('dir', dir)
27
+ return direction === 'rtl'
28
+ }
@@ -1,20 +1,20 @@
1
+ import type { createLocaleMatcher } from './localeMatcher.js'
2
+
1
3
  export type SelectEntry = { value: string; textValue: string; disabled?: boolean }
2
4
 
3
5
  /** Native-like text matching, including repeated-letter cycling. */
4
6
  export function matchSelectText(
5
7
  items: readonly SelectEntry[],
6
8
  text: string,
7
- current: string | null
9
+ current: string | null,
10
+ matcher: ReturnType<typeof createLocaleMatcher>
8
11
  ) {
9
- const search = text.toLocaleLowerCase()
10
- const repeated = search.length > 1 && [...search].every(letter => letter === search[0])
11
- const query = repeated ? search[0] : search
12
+ const query = matcher.typeaheadQuery(text)
13
+ const matches = matcher.match(query, 'prefix')
12
14
  const index = items.findIndex(item => item.value === current)
13
15
  const ordered = [...items.slice(index + 1), ...items.slice(0, index + 1)]
14
- if (query.length > 1 && index >= 0) ordered.unshift(items[index])
15
- return ordered.find(
16
- item => !item.disabled && item.textValue.toLocaleLowerCase().startsWith(query)
17
- )?.value
16
+ if (query && !matcher.isSingleKey(query) && index >= 0) ordered.unshift(items[index])
17
+ return ordered.find(item => !item.disabled && matches(item.textValue))?.value
18
18
  }
19
19
 
20
20
  export function moveSelectFocus(
@@ -2,6 +2,7 @@
2
2
 
3
3
  import { useLayoutEffect, useRef, useState, type RefObject } from 'react'
4
4
  import { positionSelect } from '../internal/select.js'
5
+ import { observeAnchorLocale, syncPopupLocale } from '../internal/popupLocale.js'
5
6
 
6
7
  /** Local top-layer popup: preserve theme/modal ancestry and place before its first paint. */
7
8
  export function useComboboxPopup(
@@ -10,13 +11,14 @@ export function useComboboxPopup(
10
11
  open: boolean,
11
12
  dismiss: () => void,
12
13
  sideOffset: number,
13
- collisionPadding: number
14
+ collisionPadding: number,
15
+ { lang, dir }: { lang?: string; dir?: string }
14
16
  ) {
15
- const latest = useRef({ dismiss, open })
17
+ const latest = useRef({ dismiss, open, lang, dir })
16
18
  const reposition = useRef<() => void>(() => {})
17
19
  const [generation, setGeneration] = useState(0)
18
20
  useLayoutEffect(() => {
19
- latest.current = { dismiss, open }
21
+ latest.current = { dismiss, open, lang, dir }
20
22
  })
21
23
  // A manual popup stays in the top layer after an ancestor dialog or popover closes.
22
24
  useLayoutEffect(() => {
@@ -69,9 +71,11 @@ export function useComboboxPopup(
69
71
  )
70
72
  }
71
73
  seedWidth()
74
+ syncPopupLocale(input, node, latest.current)
72
75
  node.showPopover()
73
76
  const place = () => {
74
77
  if (!node.isConnected || !node.matches(':popover-open')) return
78
+ const rtl = syncPopupLocale(input, node, latest.current)
75
79
  seedWidth()
76
80
  const viewport = win.visualViewport
77
81
  const css = win.getComputedStyle(node)
@@ -107,7 +111,7 @@ export function useComboboxPopup(
107
111
  padding: Math.max(0, collisionPadding),
108
112
  offset: sideOffset,
109
113
  aligned: false,
110
- rtl: win.getComputedStyle(input).direction === 'rtl'
114
+ rtl
111
115
  })
112
116
  for (const [key, value] of Object.entries({
113
117
  top: next.top,
@@ -144,6 +148,7 @@ export function useComboboxPopup(
144
148
  observer.observe(anchorNode)
145
149
  observer.observe(node)
146
150
  mutations.observe(node, { childList: true, subtree: true, characterData: true })
151
+ observeAnchorLocale(mutations, input)
147
152
  doc.addEventListener('pointerdown', outside, true)
148
153
  doc.addEventListener('focusin', outside)
149
154
  doc.addEventListener('scroll', schedule, true)
@@ -0,0 +1,30 @@
1
+ 'use client'
2
+
3
+ import { useEffect, useLayoutEffect, useRef, type RefObject } from 'react'
4
+
5
+ /** Native reset can be cancelled and the form owner can live outside the subtree. */
6
+ export function useFormReset(inputRef: RefObject<HTMLInputElement | null>, onReset: () => void) {
7
+ const latest = useRef(onReset)
8
+ useLayoutEffect(() => {
9
+ latest.current = onReset
10
+ })
11
+ useEffect(() => {
12
+ const input = inputRef.current
13
+ const view = input?.ownerDocument.defaultView
14
+ if (!input || !view) return
15
+ const root = input.getRootNode()
16
+ let timer: number | undefined
17
+ const reset = (event: Event) => {
18
+ if (event.target !== inputRef.current?.form) return
19
+ view.clearTimeout(timer)
20
+ timer = view.setTimeout(() => {
21
+ if (!event.defaultPrevented && inputRef.current?.isConnected) latest.current()
22
+ }, 0)
23
+ }
24
+ root.addEventListener('reset', reset, true)
25
+ return () => {
26
+ root.removeEventListener('reset', reset, true)
27
+ view.clearTimeout(timer)
28
+ }
29
+ }, [inputRef])
30
+ }
@@ -0,0 +1,17 @@
1
+ 'use client'
2
+
3
+ import { createContext, useContext, useMemo } from 'react'
4
+ import { defaultLocale } from '../internal/locale.js'
5
+ import { createLocaleMatcher } from '../internal/localeMatcher.js'
6
+
7
+ export const LocaleContext = createContext(defaultLocale)
8
+
9
+ export function useLocale(override?: string): string {
10
+ const inherited = useContext(LocaleContext)
11
+ return override ?? inherited
12
+ }
13
+
14
+ export function useLocaleMatcher() {
15
+ const locale = useLocale()
16
+ return useMemo(() => createLocaleMatcher(locale), [locale])
17
+ }
@@ -2,6 +2,7 @@
2
2
 
3
3
  import { useLayoutEffect, useRef, useState, type RefObject } from 'react'
4
4
  import { positionPopover, type PopoverAlign, type PopoverSide } from '../internal/popover.js'
5
+ import { observeAnchorLocale, syncPopupLocale } from '../internal/popupLocale.js'
5
6
 
6
7
  // Each document owns its layers; imports never inspect a browser global.
7
8
  const layers = new WeakMap<Document, HTMLElement[]>()
@@ -15,11 +16,14 @@ export function usePopoverSurface<Node extends HTMLElement>(
15
16
  options: {
16
17
  anchorPoint?: { x: number; y: number }
17
18
  initialFocusRef?: RefObject<HTMLElement | null>
19
+ returnFocusRef?: RefObject<HTMLElement | null>
18
20
  onFocusOutside?: () => void
19
21
  side: PopoverSide
20
22
  align: PopoverAlign
21
23
  sideOffset: number
22
24
  collisionPadding: number
25
+ lang?: string
26
+ dir?: string
23
27
  }
24
28
  ) {
25
29
  const latest = useRef({ ...options, open, close })
@@ -65,8 +69,10 @@ export function usePopoverSurface<Node extends HTMLElement>(
65
69
  const doc = node.ownerDocument
66
70
  const win = doc.defaultView!
67
71
  const shouldRestore = () => restoreFocus.current
72
+ const focusTarget = () => latest.current.returnFocusRef?.current ?? trigger
68
73
  const place = () => {
69
74
  if (!node.isConnected || !node.matches(':popover-open')) return
75
+ const rtl = syncPopupLocale(trigger, node, latest.current)
70
76
  const { side, align, sideOffset, collisionPadding, anchorPoint } = latest.current
71
77
  const viewport = win.visualViewport
72
78
  const view = {
@@ -103,7 +109,7 @@ export function usePopoverSurface<Node extends HTMLElement>(
103
109
  align,
104
110
  offset: sideOffset,
105
111
  padding: collisionPadding,
106
- rtl: win.getComputedStyle(trigger).direction === 'rtl'
112
+ rtl
107
113
  })
108
114
  for (const key of ['left', 'top', 'maxWidth', 'maxHeight'] as const) {
109
115
  const property = key === 'maxWidth' ? 'max-width' : key === 'maxHeight' ? 'max-height' : key
@@ -114,6 +120,7 @@ export function usePopoverSurface<Node extends HTMLElement>(
114
120
  }
115
121
  // A manual native popover keeps controlled owners authoritative and avoids auto-stack reopen loops.
116
122
  // The source preserves the browser's logical Tab order without assigning content semantics.
123
+ syncPopupLocale(trigger, node, latest.current)
117
124
  node.showPopover({ source: trigger })
118
125
  ancestorClosing.current = false
119
126
  reposition.current = place
@@ -186,13 +193,14 @@ export function usePopoverSurface<Node extends HTMLElement>(
186
193
  observer.observe(trigger)
187
194
  observer.observe(node)
188
195
  mutations.observe(node, { childList: true, subtree: true, characterData: true })
196
+ observeAnchorLocale(mutations, trigger)
189
197
  // Inline anchors do not report text-size changes through ResizeObserver.
190
198
  mutations.observe(trigger, {
191
199
  childList: true,
192
200
  subtree: true,
193
201
  characterData: true,
194
202
  attributes: true,
195
- attributeFilter: ['class', 'style', 'dir']
203
+ attributeFilter: ['class', 'style', 'dir', 'lang']
196
204
  })
197
205
 
198
206
  node.addEventListener('toggle', toggle)
@@ -222,13 +230,22 @@ export function usePopoverSurface<Node extends HTMLElement>(
222
230
  stack.splice(stack.indexOf(node), 1)
223
231
  if (!stack.length) layers.delete(doc)
224
232
  if (shouldRestore() && node.contains(doc.activeElement) && trigger.isConnected)
225
- trigger.focus({ preventScroll: true })
233
+ focusTarget().focus({ preventScroll: true })
226
234
  if (node.matches(':popover-open')) node.hidePopover()
227
235
  reposition.current = () => {}
228
236
  }
229
237
  }, [nodeRef, trigger, open, generation, restoreFocus])
230
238
  useLayoutEffect(
231
239
  () => reposition.current(),
232
- [side, align, sideOffset, collisionPadding, anchorPoint?.x, anchorPoint?.y]
240
+ [
241
+ side,
242
+ align,
243
+ sideOffset,
244
+ collisionPadding,
245
+ anchorPoint?.x,
246
+ anchorPoint?.y,
247
+ options.lang,
248
+ options.dir
249
+ ]
233
250
  )
234
251
  }
@@ -156,6 +156,7 @@ export const componentRegistry = {
156
156
  focusStyle: 'css',
157
157
  invalidBorder: 'css'
158
158
  },
159
+ timeInput: { periodColor: 'css', periodIndicatorColor: 'css' },
159
160
  kbd: {
160
161
  background: 'css',
161
162
  color: 'css',