@proyecto-viviana/solidaria 0.2.4 → 0.2.8

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 (219) hide show
  1. package/LICENSE +21 -0
  2. package/dist/actiongroup/createActionGroup.d.ts +29 -0
  3. package/dist/actiongroup/createActionGroup.d.ts.map +1 -0
  4. package/dist/actiongroup/index.d.ts +2 -0
  5. package/dist/actiongroup/index.d.ts.map +1 -0
  6. package/dist/autocomplete/createAutocomplete.d.ts +6 -2
  7. package/dist/autocomplete/createAutocomplete.d.ts.map +1 -1
  8. package/dist/breadcrumbs/createBreadcrumbs.d.ts +2 -0
  9. package/dist/breadcrumbs/createBreadcrumbs.d.ts.map +1 -1
  10. package/dist/button/createToggleButtonGroup.d.ts +32 -0
  11. package/dist/button/createToggleButtonGroup.d.ts.map +1 -0
  12. package/dist/button/index.d.ts +2 -0
  13. package/dist/button/index.d.ts.map +1 -1
  14. package/dist/calendar/createCalendarCell.d.ts +2 -0
  15. package/dist/calendar/createCalendarCell.d.ts.map +1 -1
  16. package/dist/calendar/createCalendarGrid.d.ts.map +1 -1
  17. package/dist/calendar/createRangeCalendarCell.d.ts +3 -1
  18. package/dist/calendar/createRangeCalendarCell.d.ts.map +1 -1
  19. package/dist/checkbox/createCheckboxGroup.d.ts +5 -1
  20. package/dist/checkbox/createCheckboxGroup.d.ts.map +1 -1
  21. package/dist/collections/index.d.ts +56 -0
  22. package/dist/collections/index.d.ts.map +1 -0
  23. package/dist/color/createColorArea.d.ts.map +1 -1
  24. package/dist/color/createColorSlider.d.ts.map +1 -1
  25. package/dist/color/createColorWheel.d.ts.map +1 -1
  26. package/dist/combobox/createComboBox.d.ts +6 -0
  27. package/dist/combobox/createComboBox.d.ts.map +1 -1
  28. package/dist/datepicker/createDatePicker.d.ts +6 -0
  29. package/dist/datepicker/createDatePicker.d.ts.map +1 -1
  30. package/dist/datepicker/createDateRangePicker.d.ts +40 -0
  31. package/dist/datepicker/createDateRangePicker.d.ts.map +1 -0
  32. package/dist/datepicker/createDateSegment.d.ts +1 -1
  33. package/dist/datepicker/createDateSegment.d.ts.map +1 -1
  34. package/dist/datepicker/createTimeSegment.d.ts +29 -0
  35. package/dist/datepicker/createTimeSegment.d.ts.map +1 -0
  36. package/dist/datepicker/index.d.ts +2 -0
  37. package/dist/datepicker/index.d.ts.map +1 -1
  38. package/dist/disclosure/createDisclosureGroup.d.ts +2 -1
  39. package/dist/disclosure/createDisclosureGroup.d.ts.map +1 -1
  40. package/dist/dnd/createDrag.d.ts.map +1 -1
  41. package/dist/dnd/createDraggableCollection.d.ts +4 -0
  42. package/dist/dnd/createDraggableCollection.d.ts.map +1 -1
  43. package/dist/dnd/createDraggableItem.d.ts.map +1 -1
  44. package/dist/dnd/createDrop.d.ts.map +1 -1
  45. package/dist/dnd/createDroppableCollection.d.ts +32 -1
  46. package/dist/dnd/createDroppableCollection.d.ts.map +1 -1
  47. package/dist/dnd/createDroppableItem.d.ts.map +1 -1
  48. package/dist/dnd/index.d.ts +1 -1
  49. package/dist/dnd/index.d.ts.map +1 -1
  50. package/dist/grid/createGrid.d.ts.map +1 -1
  51. package/dist/gridlist/createGridList.d.ts.map +1 -1
  52. package/dist/index.d.ts +6 -4
  53. package/dist/index.d.ts.map +1 -1
  54. package/dist/index.js +4659 -3452
  55. package/dist/index.js.map +1 -7
  56. package/dist/index.ssr.js +4659 -3452
  57. package/dist/index.ssr.js.map +1 -7
  58. package/dist/interactions/createFocus.d.ts.map +1 -1
  59. package/dist/interactions/createFocusWithin.d.ts.map +1 -1
  60. package/dist/link/createLink.d.ts +10 -0
  61. package/dist/link/createLink.d.ts.map +1 -1
  62. package/dist/listbox/createListBox.d.ts +1 -0
  63. package/dist/listbox/createListBox.d.ts.map +1 -1
  64. package/dist/listbox/createOption.d.ts.map +1 -1
  65. package/dist/menu/createMenu.d.ts +1 -0
  66. package/dist/menu/createMenu.d.ts.map +1 -1
  67. package/dist/meter/createMeter.d.ts.map +1 -1
  68. package/dist/numberfield/createNumberField.d.ts +18 -0
  69. package/dist/numberfield/createNumberField.d.ts.map +1 -1
  70. package/dist/overlays/createModal.d.ts +16 -0
  71. package/dist/overlays/createModal.d.ts.map +1 -1
  72. package/dist/overlays/createOverlay.d.ts.map +1 -1
  73. package/dist/overlays/index.d.ts +1 -1
  74. package/dist/overlays/index.d.ts.map +1 -1
  75. package/dist/popover/createOverlayPosition.d.ts.map +1 -1
  76. package/dist/popover/createPopover.d.ts.map +1 -1
  77. package/dist/progress/createProgressBar.d.ts.map +1 -1
  78. package/dist/radio/createRadioGroup.d.ts +2 -2
  79. package/dist/radio/createRadioGroup.d.ts.map +1 -1
  80. package/dist/searchfield/createSearchField.d.ts.map +1 -1
  81. package/dist/select/createHiddenSelect.d.ts.map +1 -1
  82. package/dist/select/createSelect.d.ts.map +1 -1
  83. package/dist/slider/createSlider.d.ts.map +1 -1
  84. package/dist/table/createTable.d.ts.map +1 -1
  85. package/dist/tabs/createTabs.d.ts +1 -1
  86. package/dist/tabs/createTabs.d.ts.map +1 -1
  87. package/dist/tag/createTag.d.ts.map +1 -1
  88. package/dist/tag/createTagGroup.d.ts.map +1 -1
  89. package/dist/toast/createToast.d.ts +4 -0
  90. package/dist/toast/createToast.d.ts.map +1 -1
  91. package/dist/toast/createToastRegion.d.ts.map +1 -1
  92. package/dist/toolbar/createToolbar.d.ts.map +1 -1
  93. package/dist/tooltip/createTooltipTrigger.d.ts.map +1 -1
  94. package/dist/tree/createTree.d.ts.map +1 -1
  95. package/dist/tree/createTreeItem.d.ts.map +1 -1
  96. package/dist/tree/types.d.ts +4 -0
  97. package/dist/tree/types.d.ts.map +1 -1
  98. package/dist/utils/env.d.ts +1 -1
  99. package/dist/utils/env.d.ts.map +1 -1
  100. package/dist/utils/platform.d.ts.map +1 -1
  101. package/dist/visually-hidden/createVisuallyHidden.d.ts.map +1 -1
  102. package/package.json +8 -6
  103. package/src/actiongroup/createActionGroup.ts +324 -0
  104. package/src/actiongroup/index.ts +8 -0
  105. package/src/autocomplete/createAutocomplete.ts +32 -9
  106. package/src/breadcrumbs/createBreadcrumbs.ts +10 -15
  107. package/src/button/createButton.ts +1 -1
  108. package/src/button/createToggleButtonGroup.ts +128 -0
  109. package/src/button/index.ts +9 -0
  110. package/src/calendar/createCalendarCell.ts +6 -4
  111. package/src/calendar/createCalendarGrid.ts +27 -18
  112. package/src/calendar/createRangeCalendarCell.ts +26 -9
  113. package/src/checkbox/createCheckboxGroup.ts +21 -4
  114. package/src/collections/index.ts +242 -0
  115. package/src/color/createColorArea.ts +380 -314
  116. package/src/color/createColorField.ts +137 -137
  117. package/src/color/createColorSlider.ts +286 -197
  118. package/src/color/createColorSwatch.ts +40 -40
  119. package/src/color/createColorWheel.ts +218 -208
  120. package/src/color/index.ts +24 -24
  121. package/src/color/types.ts +116 -116
  122. package/src/combobox/createComboBox.ts +670 -647
  123. package/src/combobox/index.ts +6 -6
  124. package/src/datepicker/createDatePicker.ts +54 -16
  125. package/src/datepicker/createDateRangePicker.ts +246 -0
  126. package/src/datepicker/createDateSegment.ts +185 -31
  127. package/src/datepicker/createTimeSegment.ts +370 -0
  128. package/src/datepicker/index.ts +14 -0
  129. package/src/dialog/createDialog.ts +120 -120
  130. package/src/dialog/index.ts +2 -2
  131. package/src/dialog/types.ts +19 -19
  132. package/src/disclosure/createDisclosureGroup.ts +5 -2
  133. package/src/dnd/createDrag.ts +224 -209
  134. package/src/dnd/createDraggableCollection.ts +96 -63
  135. package/src/dnd/createDraggableItem.ts +259 -243
  136. package/src/dnd/createDrop.ts +322 -321
  137. package/src/dnd/createDroppableCollection.ts +682 -293
  138. package/src/dnd/createDroppableItem.ts +215 -213
  139. package/src/dnd/index.ts +55 -47
  140. package/src/dnd/types.ts +89 -89
  141. package/src/dnd/utils.ts +294 -294
  142. package/src/focus/createAutoFocus.ts +321 -321
  143. package/src/focus/createFocusRestore.ts +313 -313
  144. package/src/focus/createVirtualFocus.ts +396 -396
  145. package/src/form/createFormValidation.ts +224 -224
  146. package/src/form/index.ts +11 -11
  147. package/src/grid/createGrid.ts +3 -1
  148. package/src/gridlist/createGridList.ts +16 -0
  149. package/src/gridlist/createGridListItem.ts +1 -1
  150. package/src/i18n/NumberFormatter.ts +266 -266
  151. package/src/i18n/createCollator.ts +79 -79
  152. package/src/i18n/createDateFormatter.ts +83 -83
  153. package/src/i18n/createFilter.ts +131 -131
  154. package/src/i18n/createNumberFormatter.ts +52 -52
  155. package/src/i18n/index.ts +40 -40
  156. package/src/i18n/locale.tsx +188 -188
  157. package/src/i18n/utils.ts +99 -99
  158. package/src/index.ts +51 -0
  159. package/src/interactions/createFocus.ts +6 -5
  160. package/src/interactions/createFocusWithin.ts +6 -5
  161. package/src/interactions/createLongPress.ts +174 -174
  162. package/src/interactions/createMove.ts +289 -289
  163. package/src/interactions/createPress.ts +5 -5
  164. package/src/landmark/createLandmark.ts +377 -377
  165. package/src/landmark/index.ts +8 -8
  166. package/src/link/createLink.ts +23 -8
  167. package/src/listbox/createListBox.ts +308 -269
  168. package/src/listbox/createOption.ts +162 -151
  169. package/src/listbox/index.ts +12 -12
  170. package/src/live-announcer/announce.ts +322 -322
  171. package/src/live-announcer/index.ts +9 -9
  172. package/src/menu/createMenu.ts +405 -396
  173. package/src/menu/createMenuItem.ts +149 -149
  174. package/src/menu/createMenuTrigger.ts +88 -88
  175. package/src/menu/index.ts +18 -18
  176. package/src/meter/createMeter.ts +1 -6
  177. package/src/numberfield/createNumberField.ts +311 -268
  178. package/src/numberfield/index.ts +5 -5
  179. package/src/overlays/ariaHideOutside.ts +219 -219
  180. package/src/overlays/createInteractOutside.ts +149 -149
  181. package/src/overlays/createModal.tsx +238 -202
  182. package/src/overlays/createOverlay.ts +165 -155
  183. package/src/overlays/createOverlayTrigger.ts +85 -85
  184. package/src/overlays/createPreventScroll.ts +266 -266
  185. package/src/overlays/index.ts +48 -44
  186. package/src/popover/calculatePosition.ts +6 -6
  187. package/src/popover/createOverlayPosition.ts +7 -4
  188. package/src/popover/createPopover.ts +21 -7
  189. package/src/progress/createProgressBar.ts +6 -1
  190. package/src/radio/createRadioGroup.ts +88 -14
  191. package/src/searchfield/createSearchField.ts +241 -186
  192. package/src/searchfield/index.ts +2 -2
  193. package/src/select/createHiddenSelect.tsx +263 -236
  194. package/src/select/createSelect.ts +373 -395
  195. package/src/select/index.ts +14 -14
  196. package/src/slider/createSlider.ts +364 -349
  197. package/src/slider/index.ts +2 -2
  198. package/src/ssr/index.tsx +370 -370
  199. package/src/table/createTable.ts +3 -1
  200. package/src/table/createTableColumnHeader.ts +1 -1
  201. package/src/table/createTableRow.ts +1 -1
  202. package/src/tabs/createTabs.ts +80 -51
  203. package/src/tag/createTag.ts +135 -6
  204. package/src/tag/createTagGroup.ts +7 -2
  205. package/src/toast/createToast.ts +8 -2
  206. package/src/toast/createToastRegion.ts +0 -1
  207. package/src/toolbar/createToolbar.ts +75 -1
  208. package/src/tooltip/createTooltip.ts +79 -79
  209. package/src/tooltip/createTooltipTrigger.ts +226 -222
  210. package/src/tooltip/index.ts +6 -6
  211. package/src/tree/createTree.ts +261 -246
  212. package/src/tree/createTreeItem.ts +282 -233
  213. package/src/tree/createTreeSelectionCheckbox.ts +68 -68
  214. package/src/tree/index.ts +16 -16
  215. package/src/tree/types.ts +91 -87
  216. package/src/utils/env.ts +55 -54
  217. package/src/utils/platform.ts +16 -6
  218. package/src/visually-hidden/createVisuallyHidden.ts +139 -124
  219. package/src/visually-hidden/index.ts +6 -6
@@ -1,52 +1,52 @@
1
- /**
2
- * createNumberFormatter hook for solidaria
3
- *
4
- * Provides localized number formatting with automatic locale updates.
5
- *
6
- * Port of @react-aria/i18n useNumberFormatter.
7
- */
8
-
9
- import { createMemo } from 'solid-js';
10
- import { useLocale } from './locale';
11
- import { NumberFormatter, type NumberFormatOptions } from './NumberFormatter';
12
-
13
- /**
14
- * Provides localized number formatting for the current locale.
15
- * Automatically updates when the locale changes.
16
- *
17
- * @example
18
- * ```tsx
19
- * function PriceDisplay(props: { value: number }) {
20
- * const formatter = createNumberFormatter({
21
- * style: 'currency',
22
- * currency: 'USD',
23
- * });
24
- *
25
- * return <span>{formatter().format(props.value)}</span>;
26
- * }
27
- * ```
28
- *
29
- * @example
30
- * ```tsx
31
- * // Percent formatting
32
- * const percentFormatter = createNumberFormatter({
33
- * style: 'percent',
34
- * minimumFractionDigits: 1,
35
- * });
36
- * percentFormatter().format(0.125); // '12.5%'
37
- *
38
- * // Unit formatting
39
- * const tempFormatter = createNumberFormatter({
40
- * style: 'unit',
41
- * unit: 'celsius',
42
- * });
43
- * tempFormatter().format(25); // '25°C'
44
- * ```
45
- */
46
- export function createNumberFormatter(
47
- options: NumberFormatOptions = {}
48
- ): () => NumberFormatter {
49
- const locale = useLocale();
50
-
51
- return createMemo(() => new NumberFormatter(locale().locale, options));
52
- }
1
+ /**
2
+ * createNumberFormatter hook for solidaria
3
+ *
4
+ * Provides localized number formatting with automatic locale updates.
5
+ *
6
+ * Port of @react-aria/i18n useNumberFormatter.
7
+ */
8
+
9
+ import { createMemo } from 'solid-js';
10
+ import { useLocale } from './locale';
11
+ import { NumberFormatter, type NumberFormatOptions } from './NumberFormatter';
12
+
13
+ /**
14
+ * Provides localized number formatting for the current locale.
15
+ * Automatically updates when the locale changes.
16
+ *
17
+ * @example
18
+ * ```tsx
19
+ * function PriceDisplay(props: { value: number }) {
20
+ * const formatter = createNumberFormatter({
21
+ * style: 'currency',
22
+ * currency: 'USD',
23
+ * });
24
+ *
25
+ * return <span>{formatter().format(props.value)}</span>;
26
+ * }
27
+ * ```
28
+ *
29
+ * @example
30
+ * ```tsx
31
+ * // Percent formatting
32
+ * const percentFormatter = createNumberFormatter({
33
+ * style: 'percent',
34
+ * minimumFractionDigits: 1,
35
+ * });
36
+ * percentFormatter().format(0.125); // '12.5%'
37
+ *
38
+ * // Unit formatting
39
+ * const tempFormatter = createNumberFormatter({
40
+ * style: 'unit',
41
+ * unit: 'celsius',
42
+ * });
43
+ * tempFormatter().format(25); // '25°C'
44
+ * ```
45
+ */
46
+ export function createNumberFormatter(
47
+ options: NumberFormatOptions = {}
48
+ ): () => NumberFormatter {
49
+ const locale = useLocale();
50
+
51
+ return createMemo(() => new NumberFormatter(locale().locale, options));
52
+ }
package/src/i18n/index.ts CHANGED
@@ -1,40 +1,40 @@
1
- // Locale context and provider
2
- export {
3
- I18nProvider,
4
- useLocale,
5
- createDefaultLocale,
6
- getDefaultLocale,
7
- type Direction,
8
- type Locale,
9
- type I18nProviderProps,
10
- } from './locale';
11
-
12
- // RTL utilities
13
- export { isRTL, createCacheKey } from './utils';
14
-
15
- // Number formatting
16
- export {
17
- NumberFormatter,
18
- type NumberFormatOptions,
19
- } from './NumberFormatter';
20
-
21
- export { createNumberFormatter } from './createNumberFormatter';
22
-
23
- // Date formatting
24
- export { createDateFormatter } from './createDateFormatter';
25
-
26
- // String collation
27
- export { createCollator } from './createCollator';
28
-
29
- // String filtering
30
- export { createFilter, type Filter } from './createFilter';
31
-
32
- // String formatting (ICU MessageFormat)
33
- export {
34
- createStringFormatter,
35
- createStringDictionary,
36
- type LocalizedString,
37
- type LocalizedStringDictionary,
38
- type LocalizedStringFormatter,
39
- type LocalizedStrings,
40
- } from './createStringFormatter';
1
+ // Locale context and provider
2
+ export {
3
+ I18nProvider,
4
+ useLocale,
5
+ createDefaultLocale,
6
+ getDefaultLocale,
7
+ type Direction,
8
+ type Locale,
9
+ type I18nProviderProps,
10
+ } from './locale';
11
+
12
+ // RTL utilities
13
+ export { isRTL, createCacheKey } from './utils';
14
+
15
+ // Number formatting
16
+ export {
17
+ NumberFormatter,
18
+ type NumberFormatOptions,
19
+ } from './NumberFormatter';
20
+
21
+ export { createNumberFormatter } from './createNumberFormatter';
22
+
23
+ // Date formatting
24
+ export { createDateFormatter } from './createDateFormatter';
25
+
26
+ // String collation
27
+ export { createCollator } from './createCollator';
28
+
29
+ // String filtering
30
+ export { createFilter, type Filter } from './createFilter';
31
+
32
+ // String formatting (ICU MessageFormat)
33
+ export {
34
+ createStringFormatter,
35
+ createStringDictionary,
36
+ type LocalizedString,
37
+ type LocalizedStringDictionary,
38
+ type LocalizedStringFormatter,
39
+ type LocalizedStrings,
40
+ } from './createStringFormatter';
@@ -1,188 +1,188 @@
1
- /**
2
- * Locale context and provider for solidaria
3
- *
4
- * Provides locale and text direction to the component tree.
5
- *
6
- * Port of @react-aria/i18n context and useDefaultLocale.
7
- */
8
-
9
- import {
10
- type Accessor,
11
- type JSX,
12
- type ParentProps,
13
- createContext,
14
- createEffect,
15
- createMemo,
16
- createSignal,
17
- onCleanup,
18
- useContext,
19
- } from 'solid-js';
20
- import { isRTL } from './utils';
21
-
22
- // ============================================
23
- // TYPES
24
- // ============================================
25
-
26
- /** Text direction: left-to-right or right-to-left. */
27
- export type Direction = 'ltr' | 'rtl';
28
-
29
- /** Locale information including language code and text direction. */
30
- export interface Locale {
31
- /** The BCP47 language code for the locale (e.g., 'en-US', 'ar-SA'). */
32
- locale: string;
33
- /** The writing direction for the locale. */
34
- direction: Direction;
35
- }
36
-
37
- export interface I18nProviderProps extends ParentProps {
38
- /** The locale to apply to the children. If not provided, uses browser default. */
39
- locale?: string;
40
- }
41
-
42
- // ============================================
43
- // GLOBAL STATE
44
- // ============================================
45
-
46
- // Symbol for server-provided locale
47
- const localeSymbol = Symbol.for('solidaria.i18n.locale');
48
-
49
- let currentLocale: Locale | null = null;
50
- const listeners = new Set<(locale: Locale) => void>();
51
-
52
- /**
53
- * Gets the default locale from the browser/system.
54
- */
55
- export function getDefaultLocale(): Locale {
56
- let locale =
57
- (typeof window !== 'undefined' &&
58
- (window as unknown as Record<symbol, string>)[localeSymbol]) ||
59
- (typeof navigator !== 'undefined' &&
60
- (navigator.language ||
61
- (navigator as unknown as { userLanguage?: string }).userLanguage)) ||
62
- 'en-US';
63
-
64
- // Validate the locale is supported
65
- try {
66
- Intl.DateTimeFormat.supportedLocalesOf([locale]);
67
- } catch {
68
- locale = 'en-US';
69
- }
70
-
71
- return {
72
- locale,
73
- direction: isRTL(locale) ? 'rtl' : 'ltr',
74
- };
75
- }
76
-
77
- function updateLocale(): void {
78
- currentLocale = getDefaultLocale();
79
- for (const listener of listeners) {
80
- listener(currentLocale);
81
- }
82
- }
83
-
84
- // ============================================
85
- // CONTEXT
86
- // ============================================
87
-
88
- const I18nContext = createContext<Accessor<Locale> | null>(null);
89
-
90
- // ============================================
91
- // HOOKS
92
- // ============================================
93
-
94
- /**
95
- * Returns the current browser/system locale, and updates when it changes.
96
- *
97
- * @example
98
- * ```tsx
99
- * const locale = createDefaultLocale();
100
- * console.log(locale().locale); // 'en-US'
101
- * console.log(locale().direction); // 'ltr'
102
- * ```
103
- */
104
- export function createDefaultLocale(): Accessor<Locale> {
105
- if (!currentLocale) {
106
- currentLocale = getDefaultLocale();
107
- }
108
-
109
- const [locale, setLocale] = createSignal<Locale>(currentLocale);
110
-
111
- createEffect(() => {
112
- if (typeof window === 'undefined') {
113
- return;
114
- }
115
-
116
- if (listeners.size === 0) {
117
- window.addEventListener('languagechange', updateLocale);
118
- }
119
-
120
- listeners.add(setLocale);
121
-
122
- onCleanup(() => {
123
- listeners.delete(setLocale);
124
- if (listeners.size === 0) {
125
- window.removeEventListener('languagechange', updateLocale);
126
- }
127
- });
128
- });
129
-
130
- return locale;
131
- }
132
-
133
- /**
134
- * Returns the current locale and layout direction from context or browser default.
135
- *
136
- * @example
137
- * ```tsx
138
- * function MyComponent() {
139
- * const locale = useLocale();
140
- * return <div dir={locale().direction}>{locale().locale}</div>;
141
- * }
142
- * ```
143
- */
144
- export function useLocale(): Accessor<Locale> {
145
- const context = useContext(I18nContext);
146
- const defaultLocale = createDefaultLocale();
147
- return context || defaultLocale;
148
- }
149
-
150
- // ============================================
151
- // PROVIDER
152
- // ============================================
153
-
154
- /**
155
- * Provides the locale for the application to all child components.
156
- *
157
- * @example
158
- * ```tsx
159
- * // Use browser default locale
160
- * <I18nProvider>
161
- * <App />
162
- * </I18nProvider>
163
- *
164
- * // Override with specific locale
165
- * <I18nProvider locale="ar-SA">
166
- * <App /> // Will have RTL direction
167
- * </I18nProvider>
168
- * ```
169
- */
170
- export function I18nProvider(props: I18nProviderProps): JSX.Element {
171
- const defaultLocale = createDefaultLocale();
172
-
173
- const locale = createMemo<Locale>(() => {
174
- if (props.locale) {
175
- return {
176
- locale: props.locale,
177
- direction: isRTL(props.locale) ? 'rtl' : 'ltr',
178
- };
179
- }
180
- return defaultLocale();
181
- });
182
-
183
- return (
184
- <I18nContext.Provider value={locale}>
185
- {props.children}
186
- </I18nContext.Provider>
187
- );
188
- }
1
+ /**
2
+ * Locale context and provider for solidaria
3
+ *
4
+ * Provides locale and text direction to the component tree.
5
+ *
6
+ * Port of @react-aria/i18n context and useDefaultLocale.
7
+ */
8
+
9
+ import {
10
+ type Accessor,
11
+ type JSX,
12
+ type ParentProps,
13
+ createContext,
14
+ createEffect,
15
+ createMemo,
16
+ createSignal,
17
+ onCleanup,
18
+ useContext,
19
+ } from 'solid-js';
20
+ import { isRTL } from './utils';
21
+
22
+ // ============================================
23
+ // TYPES
24
+ // ============================================
25
+
26
+ /** Text direction: left-to-right or right-to-left. */
27
+ export type Direction = 'ltr' | 'rtl';
28
+
29
+ /** Locale information including language code and text direction. */
30
+ export interface Locale {
31
+ /** The BCP47 language code for the locale (e.g., 'en-US', 'ar-SA'). */
32
+ locale: string;
33
+ /** The writing direction for the locale. */
34
+ direction: Direction;
35
+ }
36
+
37
+ export interface I18nProviderProps extends ParentProps {
38
+ /** The locale to apply to the children. If not provided, uses browser default. */
39
+ locale?: string;
40
+ }
41
+
42
+ // ============================================
43
+ // GLOBAL STATE
44
+ // ============================================
45
+
46
+ // Symbol for server-provided locale
47
+ const localeSymbol = Symbol.for('solidaria.i18n.locale');
48
+
49
+ let currentLocale: Locale | null = null;
50
+ const listeners = new Set<(locale: Locale) => void>();
51
+
52
+ /**
53
+ * Gets the default locale from the browser/system.
54
+ */
55
+ export function getDefaultLocale(): Locale {
56
+ let locale =
57
+ (typeof window !== 'undefined' &&
58
+ (window as unknown as Record<symbol, string>)[localeSymbol]) ||
59
+ (typeof navigator !== 'undefined' &&
60
+ (navigator.language ||
61
+ (navigator as unknown as { userLanguage?: string }).userLanguage)) ||
62
+ 'en-US';
63
+
64
+ // Validate the locale is supported
65
+ try {
66
+ Intl.DateTimeFormat.supportedLocalesOf([locale]);
67
+ } catch {
68
+ locale = 'en-US';
69
+ }
70
+
71
+ return {
72
+ locale,
73
+ direction: isRTL(locale) ? 'rtl' : 'ltr',
74
+ };
75
+ }
76
+
77
+ function updateLocale(): void {
78
+ currentLocale = getDefaultLocale();
79
+ for (const listener of listeners) {
80
+ listener(currentLocale);
81
+ }
82
+ }
83
+
84
+ // ============================================
85
+ // CONTEXT
86
+ // ============================================
87
+
88
+ const I18nContext = createContext<Accessor<Locale> | null>(null);
89
+
90
+ // ============================================
91
+ // HOOKS
92
+ // ============================================
93
+
94
+ /**
95
+ * Returns the current browser/system locale, and updates when it changes.
96
+ *
97
+ * @example
98
+ * ```tsx
99
+ * const locale = createDefaultLocale();
100
+ * console.log(locale().locale); // 'en-US'
101
+ * console.log(locale().direction); // 'ltr'
102
+ * ```
103
+ */
104
+ export function createDefaultLocale(): Accessor<Locale> {
105
+ if (!currentLocale) {
106
+ currentLocale = getDefaultLocale();
107
+ }
108
+
109
+ const [locale, setLocale] = createSignal<Locale>(currentLocale);
110
+
111
+ createEffect(() => {
112
+ if (typeof window === 'undefined') {
113
+ return;
114
+ }
115
+
116
+ if (listeners.size === 0) {
117
+ window.addEventListener('languagechange', updateLocale);
118
+ }
119
+
120
+ listeners.add(setLocale);
121
+
122
+ onCleanup(() => {
123
+ listeners.delete(setLocale);
124
+ if (listeners.size === 0) {
125
+ window.removeEventListener('languagechange', updateLocale);
126
+ }
127
+ });
128
+ });
129
+
130
+ return locale;
131
+ }
132
+
133
+ /**
134
+ * Returns the current locale and layout direction from context or browser default.
135
+ *
136
+ * @example
137
+ * ```tsx
138
+ * function MyComponent() {
139
+ * const locale = useLocale();
140
+ * return <div dir={locale().direction}>{locale().locale}</div>;
141
+ * }
142
+ * ```
143
+ */
144
+ export function useLocale(): Accessor<Locale> {
145
+ const context = useContext(I18nContext);
146
+ const defaultLocale = createDefaultLocale();
147
+ return context || defaultLocale;
148
+ }
149
+
150
+ // ============================================
151
+ // PROVIDER
152
+ // ============================================
153
+
154
+ /**
155
+ * Provides the locale for the application to all child components.
156
+ *
157
+ * @example
158
+ * ```tsx
159
+ * // Use browser default locale
160
+ * <I18nProvider>
161
+ * <App />
162
+ * </I18nProvider>
163
+ *
164
+ * // Override with specific locale
165
+ * <I18nProvider locale="ar-SA">
166
+ * <App /> // Will have RTL direction
167
+ * </I18nProvider>
168
+ * ```
169
+ */
170
+ export function I18nProvider(props: I18nProviderProps): JSX.Element {
171
+ const defaultLocale = createDefaultLocale();
172
+
173
+ const locale = createMemo<Locale>(() => {
174
+ if (props.locale) {
175
+ return {
176
+ locale: props.locale,
177
+ direction: isRTL(props.locale) ? 'rtl' : 'ltr',
178
+ };
179
+ }
180
+ return defaultLocale();
181
+ });
182
+
183
+ return (
184
+ <I18nContext.Provider value={locale}>
185
+ {props.children}
186
+ </I18nContext.Provider>
187
+ );
188
+ }