@svgrid/grid 2.2.25 → 2.2.27

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 (218) hide show
  1. package/README.md +199 -145
  2. package/dist/FlexRender.svelte +96 -96
  3. package/dist/GridFooter.svelte +179 -179
  4. package/dist/GridMenus.svelte +734 -728
  5. package/dist/SvAutoComplete.svelte +165 -165
  6. package/dist/SvCalendar.svelte +503 -503
  7. package/dist/SvCarousel.svelte +141 -141
  8. package/dist/SvCheckBox.svelte +101 -101
  9. package/dist/SvColorInput.svelte +181 -181
  10. package/dist/SvComboBox.svelte +275 -275
  11. package/dist/SvContextMenu.svelte +116 -116
  12. package/dist/SvCountryInput.svelte +160 -160
  13. package/dist/SvDrawer.svelte +250 -250
  14. package/dist/SvDropDownList.svelte +374 -374
  15. package/dist/SvDurationInput.svelte +126 -126
  16. package/dist/SvField.svelte +293 -293
  17. package/dist/SvForm.svelte +437 -437
  18. package/dist/SvGrid.css +2723 -2719
  19. package/dist/SvGrid.svelte +3333 -3333
  20. package/dist/SvGridChart.svelte +1724 -1724
  21. package/dist/SvGridChartPanel.svelte +485 -485
  22. package/dist/SvGridChartView.svelte +70 -70
  23. package/dist/SvGridDropdown.svelte +696 -696
  24. package/dist/SvGridSelect.svelte +259 -259
  25. package/dist/SvGroupCell.svelte +109 -109
  26. package/dist/SvListBox.svelte +287 -287
  27. package/dist/SvMaskedInput.svelte +122 -122
  28. package/dist/SvMenu.svelte +124 -124
  29. package/dist/SvMenuList.svelte +146 -146
  30. package/dist/SvMultiSelect.svelte +281 -281
  31. package/dist/SvNumberInput.svelte +168 -168
  32. package/dist/SvOtpInput.svelte +158 -158
  33. package/dist/SvPasswordInput.svelte +151 -151
  34. package/dist/SvPhoneInput.svelte +131 -131
  35. package/dist/SvPopover.svelte +197 -197
  36. package/dist/SvRadioGroup.svelte +107 -107
  37. package/dist/SvRowGroupPanel.svelte +170 -170
  38. package/dist/SvScrollArea.svelte +61 -61
  39. package/dist/SvSlider.svelte +200 -200
  40. package/dist/SvSwitchButton.svelte +107 -107
  41. package/dist/SvTagsInput.svelte +112 -112
  42. package/dist/SvTextInput.svelte +147 -147
  43. package/dist/SvTimePicker.svelte +245 -245
  44. package/dist/SvToaster.svelte +159 -159
  45. package/dist/SvToggleButton.svelte +85 -85
  46. package/dist/SvTooltip.svelte +161 -161
  47. package/dist/SvTour.svelte +204 -204
  48. package/dist/SvTree.svelte +437 -437
  49. package/dist/SvTreeSelect.svelte +233 -233
  50. package/dist/a11y/dismissable.d.ts +11 -0
  51. package/dist/a11y/dismissable.js +21 -0
  52. package/dist/ai.js +3 -3
  53. package/dist/cdn/GridMenus-BzxEYNtW.js +421 -0
  54. package/dist/cdn/GridMenus-Dr-nGEXn.js +417 -0
  55. package/dist/cdn/{SvDateTimePicker-CYC7gRER.js → SvDateTimePicker-B1sDc9Pz.js} +451 -444
  56. package/dist/cdn/{SvDateTimePicker-DtQKd4Ns.js → SvDateTimePicker-Bh0FTs1E.js} +114 -107
  57. package/dist/cdn/{SvGridChart-BhnFdLd0.js → SvGridChart-BKQsO5fZ.js} +1 -1
  58. package/dist/cdn/{SvGridChart-BcLCYvw9.js → SvGridChart-Bgk4hDs8.js} +1 -1
  59. package/dist/cdn/{SvGridChartPanel-DvjwxLvK.js → SvGridChartPanel-DSkHIQDd.js} +1 -1
  60. package/dist/cdn/{SvGridChartPanel-Cmx9DHAS.js → SvGridChartPanel-DkCc2Z7b.js} +1 -1
  61. package/dist/cdn/{SvGridChartView-B40DTJSX.js → SvGridChartView-BrbVaELm.js} +1 -1
  62. package/dist/cdn/{SvGridChartView-PwqI4s02.js → SvGridChartView-i9rWvSKg.js} +1 -1
  63. package/dist/cdn/{SvGridDropdown-hpnHvOGt.js → SvGridDropdown-CGxxopQ4.js} +1 -1
  64. package/dist/cdn/{SvGridDropdown-DjALc_4f.js → SvGridDropdown-D08sVmAy.js} +1 -1
  65. package/dist/cdn/{src-DysW9qbk.js → src-Cw8d9U8j.js} +5753 -5753
  66. package/dist/cdn/{src-bYfr_7aR.js → src-cgs1wcUS.js} +8102 -8102
  67. package/dist/cdn/svgrid.js +9 -9
  68. package/dist/cdn/svgrid.svelte-external.js +9 -9
  69. package/dist/chart-export.js +8 -8
  70. package/dist/index.d.ts +1 -1
  71. package/dist/index.js +1 -1
  72. package/package.json +30 -13
  73. package/src/FlexRender.svelte +96 -96
  74. package/src/GridFooter.svelte +179 -179
  75. package/src/GridMenus.svelte +734 -728
  76. package/src/SvAutoComplete.svelte +165 -165
  77. package/src/SvCalendar.svelte +503 -503
  78. package/src/SvCalendar.test.ts +226 -226
  79. package/src/SvCarousel.svelte +141 -141
  80. package/src/SvCheckBox.svelte +101 -101
  81. package/src/SvColorInput.svelte +181 -181
  82. package/src/SvComboBox.svelte +275 -275
  83. package/src/SvContextMenu.svelte +116 -116
  84. package/src/SvCountryInput.svelte +160 -160
  85. package/src/SvDrawer.svelte +250 -250
  86. package/src/SvDropDownList.svelte +374 -374
  87. package/src/SvDurationInput.svelte +126 -126
  88. package/src/SvField.svelte +293 -293
  89. package/src/SvForm.svelte +437 -437
  90. package/src/SvForm.test.ts +411 -411
  91. package/src/SvGrid.controller.svelte.ts +3239 -3239
  92. package/src/SvGrid.css +2723 -2719
  93. package/src/SvGrid.svelte +3333 -3333
  94. package/src/SvGrid.types.ts +1613 -1613
  95. package/src/SvGridChart.svelte +1724 -1724
  96. package/src/SvGridChartPanel.svelte +485 -485
  97. package/src/SvGridChartView.svelte +70 -70
  98. package/src/SvGridDropdown.svelte +696 -696
  99. package/src/SvGridSelect.svelte +259 -259
  100. package/src/SvGroupCell.svelte +109 -109
  101. package/src/SvListBox.svelte +287 -287
  102. package/src/SvMaskedInput.svelte +122 -122
  103. package/src/SvMenu.svelte +124 -124
  104. package/src/SvMenu.test.ts +97 -97
  105. package/src/SvMenuList.svelte +146 -146
  106. package/src/SvMultiSelect.svelte +281 -281
  107. package/src/SvNumberInput.svelte +168 -168
  108. package/src/SvOtpInput.svelte +158 -158
  109. package/src/SvPasswordInput.svelte +151 -151
  110. package/src/SvPhoneInput.svelte +131 -131
  111. package/src/SvPopover.svelte +197 -197
  112. package/src/SvRadioGroup.svelte +107 -107
  113. package/src/SvRowGroupPanel.svelte +170 -170
  114. package/src/SvScrollArea.svelte +61 -61
  115. package/src/SvSlider.svelte +200 -200
  116. package/src/SvSwitchButton.svelte +107 -107
  117. package/src/SvTagsInput.svelte +112 -112
  118. package/src/SvTextInput.svelte +147 -147
  119. package/src/SvTimePicker.svelte +245 -245
  120. package/src/SvToaster.svelte +159 -159
  121. package/src/SvToaster.test.ts +95 -95
  122. package/src/SvToggleButton.svelte +85 -85
  123. package/src/SvTooltip.svelte +161 -161
  124. package/src/SvTour.svelte +204 -204
  125. package/src/SvTree.svelte +437 -437
  126. package/src/SvTreeSelect.svelte +233 -233
  127. package/src/a11y/dismissable.test.ts +119 -95
  128. package/src/a11y/dismissable.ts +114 -94
  129. package/src/a11y.contract.test.ts +49 -49
  130. package/src/a11y.test.ts +59 -59
  131. package/src/a11y.ts +61 -61
  132. package/src/ai.test.ts +502 -502
  133. package/src/ai.ts +1391 -1391
  134. package/src/build-api.coverage.test.ts +633 -633
  135. package/src/build-api.ts +895 -895
  136. package/src/builtin-editors.grid.test.ts +85 -85
  137. package/src/cell-formatting.ts +169 -169
  138. package/src/cell-render.ts +469 -469
  139. package/src/chart-export.ts +201 -201
  140. package/src/chart-view.svelte.ts +36 -36
  141. package/src/chart.ts +2296 -2296
  142. package/src/collaboration.test.ts +104 -104
  143. package/src/collaboration.ts +167 -167
  144. package/src/core.performance.test.ts +30 -30
  145. package/src/core.ts +1111 -1111
  146. package/src/createAutocomplete.svelte.ts +132 -132
  147. package/src/createCombobox.svelte.ts +191 -191
  148. package/src/createCountryInput.svelte.ts +157 -157
  149. package/src/createDropdownList.svelte.ts +168 -168
  150. package/src/createForm.svelte.ts +386 -386
  151. package/src/createGrid.svelte.ts +42 -42
  152. package/src/createGrid.test.ts +10 -10
  153. package/src/createGridState.svelte.ts +17 -17
  154. package/src/createMenu.svelte.ts +225 -225
  155. package/src/createPopoverSelect.svelte.ts +213 -213
  156. package/src/createSlider.svelte.ts +191 -191
  157. package/src/createTooltip.svelte.ts +144 -144
  158. package/src/createTree.svelte.ts +319 -319
  159. package/src/editing.test.ts +859 -859
  160. package/src/editing.ts +675 -675
  161. package/src/editor-contract.ts +157 -157
  162. package/src/export-data-api.test.ts +126 -126
  163. package/src/export-format.test.ts +107 -107
  164. package/src/export-format.ts +598 -598
  165. package/src/filter-operators.ts +157 -157
  166. package/src/flex-render.ts +3 -3
  167. package/src/form-field.ts +127 -127
  168. package/src/index.ts +713 -712
  169. package/src/js-scroller.svelte.ts +173 -173
  170. package/src/keyboard.test.ts +59 -59
  171. package/src/keyboard.ts +97 -97
  172. package/src/list-nav.test.ts +49 -49
  173. package/src/list-nav.ts +29 -29
  174. package/src/list-option.test.ts +56 -56
  175. package/src/list-option.ts +172 -172
  176. package/src/menus.test.ts +700 -700
  177. package/src/menus.ts +652 -652
  178. package/src/merge-objects.ts +48 -48
  179. package/src/overlays.test.ts +90 -90
  180. package/src/render-component.ts +28 -28
  181. package/src/scheduler-model.test.ts +562 -562
  182. package/src/scheduler-model.ts +872 -872
  183. package/src/selection.test.ts +754 -754
  184. package/src/selection.ts +600 -600
  185. package/src/server-data-source.test.ts +289 -289
  186. package/src/server-data-source.ts +413 -413
  187. package/src/sparkline.test.ts +68 -68
  188. package/src/sparkline.ts +169 -169
  189. package/src/spreadsheet.test.ts +489 -489
  190. package/src/spreadsheet.ts +312 -312
  191. package/src/static-functions.ts +11 -11
  192. package/src/subscribe.ts +38 -38
  193. package/src/svgrid-wrapper.types.ts +524 -524
  194. package/src/svgrid.behavior.test.ts +706 -706
  195. package/src/svgrid.charting.test.ts +534 -534
  196. package/src/svgrid.features.test.ts +157 -157
  197. package/src/svgrid.filter-menu-scroll.test.ts +102 -0
  198. package/src/svgrid.new-features.wrapper.test.ts +251 -251
  199. package/src/svgrid.wrapper.test.ts +40 -40
  200. package/src/test-setup.ts +62 -62
  201. package/src/themes/index.ts +215 -215
  202. package/src/toast-store.svelte.ts +246 -246
  203. package/src/toast-store.test.ts +147 -147
  204. package/src/ui-buttons.test.ts +144 -144
  205. package/src/ui-inputs.test.ts +118 -118
  206. package/src/ui-range.test.ts +70 -70
  207. package/src/ui-selection.test.ts +155 -155
  208. package/src/ui-tier1.test.ts +142 -142
  209. package/src/virtual.test.ts +88 -88
  210. package/src/virtualization/column-virtualizer.test.ts +27 -27
  211. package/src/virtualization/column-virtualizer.ts +30 -30
  212. package/src/virtualization/svelte-virtualizer.svelte.ts +26 -26
  213. package/src/virtualization/types.ts +30 -30
  214. package/src/virtualization/virtualizer.test.ts +47 -47
  215. package/src/virtualization/virtualizer.ts +296 -296
  216. package/themes/ember.css +71 -71
  217. package/dist/cdn/GridMenus-GfCAHgkZ.js +0 -420
  218. package/dist/cdn/GridMenus-GiVNSeDU.js +0 -416
@@ -1,157 +1,157 @@
1
- /**
2
- * createCountryInput - the HEADLESS core behind <SvCountryInput>: a searchable
3
- * country picker (search by name, dial code, or ISO code; roving active index +
4
- * keyboard) that emits the ISO 3166-1 alpha-2 code. Exposed as **prop-getters**
5
- * you spread onto YOUR OWN markup. No styles/DOM/portal - those stay in the
6
- * styled component.
7
- *
8
- * ```svelte
9
- * <script lang="ts">
10
- * import { createCountryInput, flagEmoji } from '@svgrid/grid'
11
- * let value = $state<string | null>(null)
12
- * const ci = createCountryInput({ value: () => value, onChange: (c) => (value = c) })
13
- * </script>
14
- * <button {...ci.triggerProps()}>{ci.selected?.name ?? 'Select'}</button>
15
- * {#if ci.open}
16
- * <input {...ci.searchProps()} />
17
- * <ul {...ci.listboxProps()}>
18
- * {#each ci.filtered as c, i (c.code)}<li {...ci.optionProps(i)}>{c.name}</li>{/each}
19
- * </ul>
20
- * {/if}
21
- * ```
22
- */
23
- import { COUNTRIES, COUNTRY_BY_CODE, type Country } from './countries'
24
- import { editorAria, type EditorAriaState } from './editor-contract'
25
-
26
- /** Reactive inputs are passed as getters so the core tracks live prop changes. */
27
- export type CountryInputConfig = {
28
- value: () => string | null
29
- onChange?: (code: string) => void
30
- disabled?: () => boolean
31
- ariaLabel?: () => string | undefined
32
- /** Accessible label for the in-panel search field (localizable). */
33
- searchLabel?: () => string | undefined
34
- /** DOM focus hook provided by the renderer; the core never touches the DOM. */
35
- focusTrigger?: () => void
36
- // Editor contract (ARIA + validation) - folded into triggerProps().
37
- id?: () => string | undefined
38
- invalid?: () => boolean
39
- required?: () => boolean
40
- error?: () => string | undefined
41
- hint?: () => string | undefined
42
- }
43
-
44
- let uid = 0
45
-
46
- export function createCountryInput(config: CountryInputConfig) {
47
- const id = `sv-country-${uid++}`
48
- const listId = `${id}-list`
49
- const optionId = (i: number) => `${listId}-opt-${i}`
50
- const disabled = () => config.disabled?.() ?? false
51
-
52
- const ariaState = (): EditorAriaState => ({
53
- id: config.id?.(),
54
- invalid: config.invalid?.(),
55
- required: config.required?.(),
56
- error: config.error?.(),
57
- hint: config.hint?.(),
58
- ariaLabel: config.ariaLabel?.(),
59
- })
60
-
61
- let open = $state(false)
62
- let query = $state('')
63
- let active = $state(0)
64
-
65
- const selected = $derived(config.value() ? COUNTRY_BY_CODE.get(config.value()!) ?? null : null)
66
- const filtered = $derived<Country[]>(
67
- query.trim() === ''
68
- ? COUNTRIES
69
- : COUNTRIES.filter(
70
- (c) =>
71
- c.name.toLowerCase().includes(query.toLowerCase()) ||
72
- c.dial.includes(query) ||
73
- c.code.toLowerCase() === query.toLowerCase(),
74
- ),
75
- )
76
-
77
- function openPanel() { if (disabled() || open) return; open = true; query = ''; active = 0 }
78
- function close() { open = false; config.focusTrigger?.() }
79
- function toggle() { if (open) { open = false } else { openPanel() } }
80
- function pick(code: string) { config.onChange?.(code); open = false; config.focusTrigger?.() }
81
- function setQuery(v: string) { query = v; active = 0 }
82
- function onSearchInput(e: Event) { setQuery((e.currentTarget as HTMLInputElement).value) }
83
- /** The current active-descendant id (for the focused search input), or undefined. */
84
- const activeDescendant = () => (open && filtered.length > 0 ? optionId(active) : undefined)
85
- function onKeydown(e: KeyboardEvent) {
86
- if (!open) return
87
- if (e.key === 'ArrowDown') { e.preventDefault(); active = Math.min(active + 1, filtered.length - 1) }
88
- else if (e.key === 'ArrowUp') { e.preventDefault(); active = Math.max(active - 1, 0) }
89
- else if (e.key === 'Enter') { e.preventDefault(); const c = filtered[active]; if (c) pick(c.code) }
90
- else if (e.key === 'Escape') { e.preventDefault(); close() }
91
- }
92
-
93
- return {
94
- /** Panel open state. */
95
- get open() { return open },
96
- /** Highlighted country index into `filtered`. */
97
- get activeIndex() { return active },
98
- /** Current search query. */
99
- get query() { return query },
100
- /** Countries after the current search filter. */
101
- get filtered() { return filtered },
102
- /** The selected country, if any. */
103
- get selected() { return selected },
104
- /** Controlled value (ISO alpha-2 code). */
105
- get value() { return config.value() },
106
- isActive: (i: number) => i === active,
107
- isSelected: (code: string) => code === config.value(),
108
- setActive: (i: number) => { active = i },
109
- setQuery,
110
- openPanel,
111
- close,
112
- toggle,
113
- pick,
114
- onKeydown,
115
- /** Spread onto the trigger <button>. */
116
- triggerProps: () => ({
117
- id: config.id?.(),
118
- type: 'button' as const,
119
- 'aria-haspopup': 'listbox' as const,
120
- 'aria-expanded': open,
121
- 'aria-controls': listId,
122
- ...editorAria(ariaState()),
123
- disabled: disabled(),
124
- onclick: toggle,
125
- }),
126
- /** Spread onto the search <input> inside the panel. */
127
- searchProps: () => ({
128
- type: 'text' as const,
129
- value: query,
130
- 'aria-label': config.searchLabel?.() ?? 'Search countries',
131
- 'aria-controls': listId,
132
- 'aria-activedescendant': activeDescendant(),
133
- oninput: onSearchInput,
134
- onkeydown: onKeydown,
135
- }),
136
- /** Spread onto the listbox container. */
137
- listboxProps: () => ({
138
- id: listId,
139
- role: 'listbox' as const,
140
- }),
141
- /** Spread onto the country option at `index` (index into `filtered`). */
142
- optionProps: (index: number) => {
143
- const c = filtered[index]
144
- return {
145
- id: optionId(index),
146
- role: 'option' as const,
147
- tabindex: -1,
148
- 'aria-selected': c ? c.code === config.value() : false,
149
- 'data-idx': index,
150
- onclick: () => { if (c) pick(c.code) },
151
- onpointermove: () => { active = index },
152
- }
153
- },
154
- }
155
- }
156
-
157
- export type CountryInput = ReturnType<typeof createCountryInput>
1
+ /**
2
+ * createCountryInput - the HEADLESS core behind <SvCountryInput>: a searchable
3
+ * country picker (search by name, dial code, or ISO code; roving active index +
4
+ * keyboard) that emits the ISO 3166-1 alpha-2 code. Exposed as **prop-getters**
5
+ * you spread onto YOUR OWN markup. No styles/DOM/portal - those stay in the
6
+ * styled component.
7
+ *
8
+ * ```svelte
9
+ * <script lang="ts">
10
+ * import { createCountryInput, flagEmoji } from '@svgrid/grid'
11
+ * let value = $state<string | null>(null)
12
+ * const ci = createCountryInput({ value: () => value, onChange: (c) => (value = c) })
13
+ * </script>
14
+ * <button {...ci.triggerProps()}>{ci.selected?.name ?? 'Select'}</button>
15
+ * {#if ci.open}
16
+ * <input {...ci.searchProps()} />
17
+ * <ul {...ci.listboxProps()}>
18
+ * {#each ci.filtered as c, i (c.code)}<li {...ci.optionProps(i)}>{c.name}</li>{/each}
19
+ * </ul>
20
+ * {/if}
21
+ * ```
22
+ */
23
+ import { COUNTRIES, COUNTRY_BY_CODE, type Country } from './countries'
24
+ import { editorAria, type EditorAriaState } from './editor-contract'
25
+
26
+ /** Reactive inputs are passed as getters so the core tracks live prop changes. */
27
+ export type CountryInputConfig = {
28
+ value: () => string | null
29
+ onChange?: (code: string) => void
30
+ disabled?: () => boolean
31
+ ariaLabel?: () => string | undefined
32
+ /** Accessible label for the in-panel search field (localizable). */
33
+ searchLabel?: () => string | undefined
34
+ /** DOM focus hook provided by the renderer; the core never touches the DOM. */
35
+ focusTrigger?: () => void
36
+ // Editor contract (ARIA + validation) - folded into triggerProps().
37
+ id?: () => string | undefined
38
+ invalid?: () => boolean
39
+ required?: () => boolean
40
+ error?: () => string | undefined
41
+ hint?: () => string | undefined
42
+ }
43
+
44
+ let uid = 0
45
+
46
+ export function createCountryInput(config: CountryInputConfig) {
47
+ const id = `sv-country-${uid++}`
48
+ const listId = `${id}-list`
49
+ const optionId = (i: number) => `${listId}-opt-${i}`
50
+ const disabled = () => config.disabled?.() ?? false
51
+
52
+ const ariaState = (): EditorAriaState => ({
53
+ id: config.id?.(),
54
+ invalid: config.invalid?.(),
55
+ required: config.required?.(),
56
+ error: config.error?.(),
57
+ hint: config.hint?.(),
58
+ ariaLabel: config.ariaLabel?.(),
59
+ })
60
+
61
+ let open = $state(false)
62
+ let query = $state('')
63
+ let active = $state(0)
64
+
65
+ const selected = $derived(config.value() ? COUNTRY_BY_CODE.get(config.value()!) ?? null : null)
66
+ const filtered = $derived<Country[]>(
67
+ query.trim() === ''
68
+ ? COUNTRIES
69
+ : COUNTRIES.filter(
70
+ (c) =>
71
+ c.name.toLowerCase().includes(query.toLowerCase()) ||
72
+ c.dial.includes(query) ||
73
+ c.code.toLowerCase() === query.toLowerCase(),
74
+ ),
75
+ )
76
+
77
+ function openPanel() { if (disabled() || open) return; open = true; query = ''; active = 0 }
78
+ function close() { open = false; config.focusTrigger?.() }
79
+ function toggle() { if (open) { open = false } else { openPanel() } }
80
+ function pick(code: string) { config.onChange?.(code); open = false; config.focusTrigger?.() }
81
+ function setQuery(v: string) { query = v; active = 0 }
82
+ function onSearchInput(e: Event) { setQuery((e.currentTarget as HTMLInputElement).value) }
83
+ /** The current active-descendant id (for the focused search input), or undefined. */
84
+ const activeDescendant = () => (open && filtered.length > 0 ? optionId(active) : undefined)
85
+ function onKeydown(e: KeyboardEvent) {
86
+ if (!open) return
87
+ if (e.key === 'ArrowDown') { e.preventDefault(); active = Math.min(active + 1, filtered.length - 1) }
88
+ else if (e.key === 'ArrowUp') { e.preventDefault(); active = Math.max(active - 1, 0) }
89
+ else if (e.key === 'Enter') { e.preventDefault(); const c = filtered[active]; if (c) pick(c.code) }
90
+ else if (e.key === 'Escape') { e.preventDefault(); close() }
91
+ }
92
+
93
+ return {
94
+ /** Panel open state. */
95
+ get open() { return open },
96
+ /** Highlighted country index into `filtered`. */
97
+ get activeIndex() { return active },
98
+ /** Current search query. */
99
+ get query() { return query },
100
+ /** Countries after the current search filter. */
101
+ get filtered() { return filtered },
102
+ /** The selected country, if any. */
103
+ get selected() { return selected },
104
+ /** Controlled value (ISO alpha-2 code). */
105
+ get value() { return config.value() },
106
+ isActive: (i: number) => i === active,
107
+ isSelected: (code: string) => code === config.value(),
108
+ setActive: (i: number) => { active = i },
109
+ setQuery,
110
+ openPanel,
111
+ close,
112
+ toggle,
113
+ pick,
114
+ onKeydown,
115
+ /** Spread onto the trigger <button>. */
116
+ triggerProps: () => ({
117
+ id: config.id?.(),
118
+ type: 'button' as const,
119
+ 'aria-haspopup': 'listbox' as const,
120
+ 'aria-expanded': open,
121
+ 'aria-controls': listId,
122
+ ...editorAria(ariaState()),
123
+ disabled: disabled(),
124
+ onclick: toggle,
125
+ }),
126
+ /** Spread onto the search <input> inside the panel. */
127
+ searchProps: () => ({
128
+ type: 'text' as const,
129
+ value: query,
130
+ 'aria-label': config.searchLabel?.() ?? 'Search countries',
131
+ 'aria-controls': listId,
132
+ 'aria-activedescendant': activeDescendant(),
133
+ oninput: onSearchInput,
134
+ onkeydown: onKeydown,
135
+ }),
136
+ /** Spread onto the listbox container. */
137
+ listboxProps: () => ({
138
+ id: listId,
139
+ role: 'listbox' as const,
140
+ }),
141
+ /** Spread onto the country option at `index` (index into `filtered`). */
142
+ optionProps: (index: number) => {
143
+ const c = filtered[index]
144
+ return {
145
+ id: optionId(index),
146
+ role: 'option' as const,
147
+ tabindex: -1,
148
+ 'aria-selected': c ? c.code === config.value() : false,
149
+ 'data-idx': index,
150
+ onclick: () => { if (c) pick(c.code) },
151
+ onpointermove: () => { active = index },
152
+ }
153
+ },
154
+ }
155
+ }
156
+
157
+ export type CountryInput = ReturnType<typeof createCountryInput>
@@ -1,168 +1,168 @@
1
- /**
2
- * createDropdownList - the HEADLESS core behind <SvDropDownList>: a single-select
3
- * dropdown state machine (trigger open/close, roving active index over enabled
4
- * options, full keyboard) exposed as **prop-getters** you spread onto YOUR OWN
5
- * markup. No styles, no DOM, no portal/measurement - those stay in the styled
6
- * component.
7
- *
8
- * ```svelte
9
- * <script lang="ts">
10
- * import { createDropdownList } from '@svgrid/grid'
11
- * let value = $state<string | null>(null)
12
- * const dd = createDropdownList({ options: () => options, value: () => value, onChange: (v) => (value = v) })
13
- * </script>
14
- * <button {...dd.triggerProps()}>{dd.selected?.label ?? 'Select'}</button>
15
- * {#if dd.open}
16
- * <ul {...dd.listboxProps()}>
17
- * {#each options as opt, i (opt.value)}<li {...dd.optionProps(i)}>{opt.label}</li>{/each}
18
- * </ul>
19
- * {/if}
20
- * ```
21
- */
22
- import { createTypeaheadBuffer, isTypeaheadKey, nextTypeaheadIndex, type ListOption } from './list-option'
23
- import { editorAria, type EditorAriaState } from './editor-contract'
24
-
25
- export type DropdownValue = string | number | null
26
-
27
- /** Reactive inputs are passed as getters so the core tracks live prop changes. */
28
- export type DropdownListConfig = {
29
- options: () => ReadonlyArray<ListOption>
30
- value: () => DropdownValue
31
- onChange?: (value: string | number) => void
32
- disabled?: () => boolean
33
- /** Read-only: value shown, trigger focusable, but the panel will not open. */
34
- readonly?: () => boolean
35
- ariaLabel?: () => string | undefined
36
- /** DOM focus hook provided by the renderer; the core never touches the DOM. */
37
- focusTrigger?: () => void
38
- // Editor contract (ARIA + validation) - folded into triggerProps().
39
- id?: () => string | undefined
40
- invalid?: () => boolean
41
- required?: () => boolean
42
- error?: () => string | undefined
43
- hint?: () => string | undefined
44
- }
45
-
46
- let uid = 0
47
-
48
- export function createDropdownList(config: DropdownListConfig) {
49
- const listId = `sv-ddl-${uid++}`
50
- const optionId = (index: number) => `${listId}-opt-${index}`
51
- const opts = () => config.options()
52
- const disabled = () => config.disabled?.() ?? false
53
- const readonly = () => config.readonly?.() ?? false
54
-
55
- const ariaState = (): EditorAriaState => ({
56
- id: config.id?.(),
57
- invalid: config.invalid?.(),
58
- required: config.required?.(),
59
- error: config.error?.(),
60
- hint: config.hint?.(),
61
- ariaLabel: config.ariaLabel?.(),
62
- })
63
-
64
- let open = $state(false)
65
- let active = $state(-1)
66
-
67
- const selected = $derived(opts().find((o) => o.value === config.value()) ?? null)
68
- const enabledIdx = $derived(opts().map((o, i) => (o.disabled ? -1 : i)).filter((i) => i >= 0))
69
-
70
- function openPanel() {
71
- if (disabled() || readonly() || open) return
72
- open = true
73
- active = Math.max(0, opts().findIndex((o) => o.value === config.value()))
74
- }
75
- function close() { open = false }
76
- function toggle() { if (open) { close() } else { openPanel() } }
77
- function pick(i: number) {
78
- if (readonly()) return
79
- const o = opts()[i]
80
- if (!o || o.disabled) return
81
- config.onChange?.(o.value); close(); config.focusTrigger?.()
82
- }
83
- function setActive(i: number) { const o = opts()[i]; if (o && !o.disabled) active = i }
84
- function move(d: number) {
85
- const pos = enabledIdx.indexOf(active)
86
- active = enabledIdx[(pos + d + enabledIdx.length) % enabledIdx.length] ?? active
87
- }
88
- // Type-ahead: typing a label prefix jumps the active option (and selects it
89
- // when the list is closed, matching a native <select>).
90
- const typeahead = createTypeaheadBuffer()
91
- function onTypeahead(char: string) {
92
- if (readonly()) return
93
- const buffer = typeahead.push(char.toLowerCase())
94
- const from = active >= 0 ? active : opts().findIndex((o) => o.value === config.value())
95
- const next = nextTypeaheadIndex(opts(), buffer, from)
96
- if (next < 0) return
97
- active = next
98
- if (!open) config.onChange?.(opts()[next]!.value)
99
- }
100
- function onKeydown(e: KeyboardEvent) {
101
- if (disabled() || readonly()) return
102
- if (isTypeaheadKey(e)) { onTypeahead(e.key); return }
103
- if (!open && (e.key === 'ArrowDown' || e.key === 'Enter' || e.key === ' ')) { e.preventDefault(); openPanel(); return }
104
- if (!open) return
105
- if (e.key === 'ArrowDown') { e.preventDefault(); move(1) }
106
- else if (e.key === 'ArrowUp') { e.preventDefault(); move(-1) }
107
- else if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); pick(active) }
108
- else if (e.key === 'Escape') { e.preventDefault(); close(); config.focusTrigger?.() }
109
- else if (e.key === 'Home') { active = enabledIdx[0] ?? 0 }
110
- else if (e.key === 'End') { active = enabledIdx.at(-1) ?? 0 }
111
- }
112
-
113
- return {
114
- /** Panel open state. */
115
- get open() { return open },
116
- /** Highlighted option index into `options`. */
117
- get activeIndex() { return active },
118
- /** The option matching the controlled value, if any. */
119
- get selected() { return selected },
120
- /** Controlled value. */
121
- get value() { return config.value() },
122
- isActive: (i: number) => i === active,
123
- isSelected: (o: ListOption) => o.value === config.value(),
124
- setActive,
125
- openPanel,
126
- close,
127
- toggle,
128
- pick,
129
- move,
130
- onKeydown,
131
- /** Spread onto the trigger <button>. */
132
- triggerProps: () => ({
133
- id: config.id?.(),
134
- type: 'button' as const,
135
- 'aria-haspopup': 'listbox' as const,
136
- 'aria-expanded': open,
137
- 'aria-controls': listId,
138
- 'aria-activedescendant': open && opts()[active] ? optionId(active) : undefined,
139
- ...editorAria(ariaState()),
140
- 'aria-readonly': readonly() || undefined,
141
- disabled: disabled(),
142
- onclick: toggle,
143
- onkeydown: onKeydown,
144
- }),
145
- /** Spread onto the listbox container. */
146
- listboxProps: () => ({
147
- id: listId,
148
- role: 'listbox' as const,
149
- tabindex: -1,
150
- }),
151
- /** Spread onto the option at `index` (index into `options`). */
152
- optionProps: (index: number) => {
153
- const o = opts()[index]
154
- return {
155
- role: 'option' as const,
156
- id: optionId(index),
157
- tabindex: -1,
158
- 'aria-selected': o ? o.value === config.value() : false,
159
- 'aria-disabled': o?.disabled,
160
- 'data-idx': index,
161
- onclick: () => pick(index),
162
- onpointermove: () => { if (o && !o.disabled) active = index },
163
- }
164
- },
165
- }
166
- }
167
-
168
- export type DropdownList = ReturnType<typeof createDropdownList>
1
+ /**
2
+ * createDropdownList - the HEADLESS core behind <SvDropDownList>: a single-select
3
+ * dropdown state machine (trigger open/close, roving active index over enabled
4
+ * options, full keyboard) exposed as **prop-getters** you spread onto YOUR OWN
5
+ * markup. No styles, no DOM, no portal/measurement - those stay in the styled
6
+ * component.
7
+ *
8
+ * ```svelte
9
+ * <script lang="ts">
10
+ * import { createDropdownList } from '@svgrid/grid'
11
+ * let value = $state<string | null>(null)
12
+ * const dd = createDropdownList({ options: () => options, value: () => value, onChange: (v) => (value = v) })
13
+ * </script>
14
+ * <button {...dd.triggerProps()}>{dd.selected?.label ?? 'Select'}</button>
15
+ * {#if dd.open}
16
+ * <ul {...dd.listboxProps()}>
17
+ * {#each options as opt, i (opt.value)}<li {...dd.optionProps(i)}>{opt.label}</li>{/each}
18
+ * </ul>
19
+ * {/if}
20
+ * ```
21
+ */
22
+ import { createTypeaheadBuffer, isTypeaheadKey, nextTypeaheadIndex, type ListOption } from './list-option'
23
+ import { editorAria, type EditorAriaState } from './editor-contract'
24
+
25
+ export type DropdownValue = string | number | null
26
+
27
+ /** Reactive inputs are passed as getters so the core tracks live prop changes. */
28
+ export type DropdownListConfig = {
29
+ options: () => ReadonlyArray<ListOption>
30
+ value: () => DropdownValue
31
+ onChange?: (value: string | number) => void
32
+ disabled?: () => boolean
33
+ /** Read-only: value shown, trigger focusable, but the panel will not open. */
34
+ readonly?: () => boolean
35
+ ariaLabel?: () => string | undefined
36
+ /** DOM focus hook provided by the renderer; the core never touches the DOM. */
37
+ focusTrigger?: () => void
38
+ // Editor contract (ARIA + validation) - folded into triggerProps().
39
+ id?: () => string | undefined
40
+ invalid?: () => boolean
41
+ required?: () => boolean
42
+ error?: () => string | undefined
43
+ hint?: () => string | undefined
44
+ }
45
+
46
+ let uid = 0
47
+
48
+ export function createDropdownList(config: DropdownListConfig) {
49
+ const listId = `sv-ddl-${uid++}`
50
+ const optionId = (index: number) => `${listId}-opt-${index}`
51
+ const opts = () => config.options()
52
+ const disabled = () => config.disabled?.() ?? false
53
+ const readonly = () => config.readonly?.() ?? false
54
+
55
+ const ariaState = (): EditorAriaState => ({
56
+ id: config.id?.(),
57
+ invalid: config.invalid?.(),
58
+ required: config.required?.(),
59
+ error: config.error?.(),
60
+ hint: config.hint?.(),
61
+ ariaLabel: config.ariaLabel?.(),
62
+ })
63
+
64
+ let open = $state(false)
65
+ let active = $state(-1)
66
+
67
+ const selected = $derived(opts().find((o) => o.value === config.value()) ?? null)
68
+ const enabledIdx = $derived(opts().map((o, i) => (o.disabled ? -1 : i)).filter((i) => i >= 0))
69
+
70
+ function openPanel() {
71
+ if (disabled() || readonly() || open) return
72
+ open = true
73
+ active = Math.max(0, opts().findIndex((o) => o.value === config.value()))
74
+ }
75
+ function close() { open = false }
76
+ function toggle() { if (open) { close() } else { openPanel() } }
77
+ function pick(i: number) {
78
+ if (readonly()) return
79
+ const o = opts()[i]
80
+ if (!o || o.disabled) return
81
+ config.onChange?.(o.value); close(); config.focusTrigger?.()
82
+ }
83
+ function setActive(i: number) { const o = opts()[i]; if (o && !o.disabled) active = i }
84
+ function move(d: number) {
85
+ const pos = enabledIdx.indexOf(active)
86
+ active = enabledIdx[(pos + d + enabledIdx.length) % enabledIdx.length] ?? active
87
+ }
88
+ // Type-ahead: typing a label prefix jumps the active option (and selects it
89
+ // when the list is closed, matching a native <select>).
90
+ const typeahead = createTypeaheadBuffer()
91
+ function onTypeahead(char: string) {
92
+ if (readonly()) return
93
+ const buffer = typeahead.push(char.toLowerCase())
94
+ const from = active >= 0 ? active : opts().findIndex((o) => o.value === config.value())
95
+ const next = nextTypeaheadIndex(opts(), buffer, from)
96
+ if (next < 0) return
97
+ active = next
98
+ if (!open) config.onChange?.(opts()[next]!.value)
99
+ }
100
+ function onKeydown(e: KeyboardEvent) {
101
+ if (disabled() || readonly()) return
102
+ if (isTypeaheadKey(e)) { onTypeahead(e.key); return }
103
+ if (!open && (e.key === 'ArrowDown' || e.key === 'Enter' || e.key === ' ')) { e.preventDefault(); openPanel(); return }
104
+ if (!open) return
105
+ if (e.key === 'ArrowDown') { e.preventDefault(); move(1) }
106
+ else if (e.key === 'ArrowUp') { e.preventDefault(); move(-1) }
107
+ else if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); pick(active) }
108
+ else if (e.key === 'Escape') { e.preventDefault(); close(); config.focusTrigger?.() }
109
+ else if (e.key === 'Home') { active = enabledIdx[0] ?? 0 }
110
+ else if (e.key === 'End') { active = enabledIdx.at(-1) ?? 0 }
111
+ }
112
+
113
+ return {
114
+ /** Panel open state. */
115
+ get open() { return open },
116
+ /** Highlighted option index into `options`. */
117
+ get activeIndex() { return active },
118
+ /** The option matching the controlled value, if any. */
119
+ get selected() { return selected },
120
+ /** Controlled value. */
121
+ get value() { return config.value() },
122
+ isActive: (i: number) => i === active,
123
+ isSelected: (o: ListOption) => o.value === config.value(),
124
+ setActive,
125
+ openPanel,
126
+ close,
127
+ toggle,
128
+ pick,
129
+ move,
130
+ onKeydown,
131
+ /** Spread onto the trigger <button>. */
132
+ triggerProps: () => ({
133
+ id: config.id?.(),
134
+ type: 'button' as const,
135
+ 'aria-haspopup': 'listbox' as const,
136
+ 'aria-expanded': open,
137
+ 'aria-controls': listId,
138
+ 'aria-activedescendant': open && opts()[active] ? optionId(active) : undefined,
139
+ ...editorAria(ariaState()),
140
+ 'aria-readonly': readonly() || undefined,
141
+ disabled: disabled(),
142
+ onclick: toggle,
143
+ onkeydown: onKeydown,
144
+ }),
145
+ /** Spread onto the listbox container. */
146
+ listboxProps: () => ({
147
+ id: listId,
148
+ role: 'listbox' as const,
149
+ tabindex: -1,
150
+ }),
151
+ /** Spread onto the option at `index` (index into `options`). */
152
+ optionProps: (index: number) => {
153
+ const o = opts()[index]
154
+ return {
155
+ role: 'option' as const,
156
+ id: optionId(index),
157
+ tabindex: -1,
158
+ 'aria-selected': o ? o.value === config.value() : false,
159
+ 'aria-disabled': o?.disabled,
160
+ 'data-idx': index,
161
+ onclick: () => pick(index),
162
+ onpointermove: () => { if (o && !o.disabled) active = index },
163
+ }
164
+ },
165
+ }
166
+ }
167
+
168
+ export type DropdownList = ReturnType<typeof createDropdownList>