@svgrid/grid 2.2.27 → 2.2.28

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 (212) hide show
  1. package/README.md +199 -199
  2. package/dist/FlexRender.svelte +96 -96
  3. package/dist/GridFooter.svelte +179 -179
  4. package/dist/GridMenus.svelte +734 -734
  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 +254 -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 -2723
  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 +133 -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/cdn/{GridMenus-BzxEYNtW.js → GridMenus-BbzEvTYO.js} +2 -2
  51. package/dist/cdn/{GridMenus-Dr-nGEXn.js → GridMenus-E220X2kM.js} +2 -2
  52. package/dist/cdn/{SvDateTimePicker-B1sDc9Pz.js → SvDateTimePicker-B8GopjhC.js} +2 -2
  53. package/dist/cdn/{SvDateTimePicker-Bh0FTs1E.js → SvDateTimePicker-DB0aIEk8.js} +2 -2
  54. package/dist/cdn/{SvGridChart-Bgk4hDs8.js → SvGridChart-BcLCYvw9.js} +1 -1
  55. package/dist/cdn/{SvGridChart-BKQsO5fZ.js → SvGridChart-BhnFdLd0.js} +1 -1
  56. package/dist/cdn/{SvGridChartPanel-DkCc2Z7b.js → SvGridChartPanel-Cmx9DHAS.js} +1 -1
  57. package/dist/cdn/{SvGridChartPanel-DSkHIQDd.js → SvGridChartPanel-DvjwxLvK.js} +1 -1
  58. package/dist/cdn/{SvGridChartView-BrbVaELm.js → SvGridChartView-B40DTJSX.js} +1 -1
  59. package/dist/cdn/{SvGridChartView-i9rWvSKg.js → SvGridChartView-PwqI4s02.js} +1 -1
  60. package/dist/cdn/{SvGridDropdown-D08sVmAy.js → SvGridDropdown-DjALc_4f.js} +1 -1
  61. package/dist/cdn/{SvGridDropdown-CGxxopQ4.js → SvGridDropdown-hpnHvOGt.js} +1 -1
  62. package/dist/cdn/{src-cgs1wcUS.js → src-BxNEslEo.js} +25 -25
  63. package/dist/cdn/{src-Cw8d9U8j.js → src-C4yKQZ5t.js} +26 -26
  64. package/dist/cdn/svgrid.js +5 -5
  65. package/dist/cdn/svgrid.svelte-external.js +5 -5
  66. package/dist/chart-export.js +8 -8
  67. package/package.json +10 -10
  68. package/src/FlexRender.svelte +96 -96
  69. package/src/GridFooter.svelte +179 -179
  70. package/src/GridMenus.svelte +734 -734
  71. package/src/SvAutoComplete.svelte +165 -165
  72. package/src/SvCalendar.svelte +503 -503
  73. package/src/SvCalendar.test.ts +226 -226
  74. package/src/SvCarousel.svelte +141 -141
  75. package/src/SvCheckBox.svelte +101 -101
  76. package/src/SvColorInput.svelte +181 -181
  77. package/src/SvComboBox.svelte +275 -275
  78. package/src/SvContextMenu.svelte +116 -116
  79. package/src/SvCountryInput.svelte +160 -160
  80. package/src/SvDrawer.svelte +254 -250
  81. package/src/SvDrawer.test.ts +18 -1
  82. package/src/SvDropDownList.svelte +374 -374
  83. package/src/SvDurationInput.svelte +126 -126
  84. package/src/SvField.svelte +293 -293
  85. package/src/SvForm.svelte +437 -437
  86. package/src/SvForm.test.ts +411 -411
  87. package/src/SvGrid.controller.svelte.ts +3239 -3239
  88. package/src/SvGrid.css +2723 -2723
  89. package/src/SvGrid.svelte +3333 -3333
  90. package/src/SvGrid.types.ts +1613 -1613
  91. package/src/SvGridChart.svelte +1724 -1724
  92. package/src/SvGridChartPanel.svelte +485 -485
  93. package/src/SvGridChartView.svelte +70 -70
  94. package/src/SvGridDropdown.svelte +696 -696
  95. package/src/SvGridSelect.svelte +259 -259
  96. package/src/SvGroupCell.svelte +109 -109
  97. package/src/SvListBox.svelte +287 -287
  98. package/src/SvMaskedInput.svelte +122 -122
  99. package/src/SvMenu.svelte +124 -124
  100. package/src/SvMenu.test.ts +97 -97
  101. package/src/SvMenuList.svelte +146 -146
  102. package/src/SvMultiSelect.svelte +281 -281
  103. package/src/SvNavPane.test.ts +15 -4
  104. package/src/SvNumberInput.svelte +168 -168
  105. package/src/SvOtpInput.svelte +158 -158
  106. package/src/SvPasswordInput.svelte +151 -151
  107. package/src/SvPhoneInput.svelte +133 -131
  108. package/src/SvPopover.svelte +197 -197
  109. package/src/SvRadioGroup.svelte +107 -107
  110. package/src/SvRowGroupPanel.svelte +170 -170
  111. package/src/SvScrollArea.svelte +61 -61
  112. package/src/SvSlider.svelte +200 -200
  113. package/src/SvSwitchButton.svelte +107 -107
  114. package/src/SvTagsInput.svelte +112 -112
  115. package/src/SvTextInput.svelte +147 -147
  116. package/src/SvTimePicker.svelte +245 -245
  117. package/src/SvToaster.svelte +159 -159
  118. package/src/SvToaster.test.ts +95 -95
  119. package/src/SvToggleButton.svelte +85 -85
  120. package/src/SvTooltip.svelte +161 -161
  121. package/src/SvTour.svelte +204 -204
  122. package/src/SvTree.svelte +437 -437
  123. package/src/SvTreeSelect.svelte +233 -233
  124. package/src/a11y/dismissable.test.ts +119 -119
  125. package/src/a11y/dismissable.ts +114 -114
  126. package/src/a11y.contract.test.ts +49 -49
  127. package/src/a11y.test.ts +59 -59
  128. package/src/a11y.ts +61 -61
  129. package/src/ai.test.ts +502 -502
  130. package/src/ai.ts +1391 -1391
  131. package/src/build-api.coverage.test.ts +633 -633
  132. package/src/build-api.ts +895 -895
  133. package/src/builtin-editors.grid.test.ts +85 -85
  134. package/src/cell-formatting.ts +169 -169
  135. package/src/cell-render.ts +469 -469
  136. package/src/chart-export.ts +201 -201
  137. package/src/chart-view.svelte.ts +36 -36
  138. package/src/chart.ts +2296 -2296
  139. package/src/collaboration.test.ts +104 -104
  140. package/src/collaboration.ts +167 -167
  141. package/src/core.performance.test.ts +30 -30
  142. package/src/core.ts +1111 -1111
  143. package/src/createAutocomplete.svelte.ts +132 -132
  144. package/src/createCombobox.svelte.ts +191 -191
  145. package/src/createCountryInput.svelte.ts +157 -157
  146. package/src/createDropdownList.svelte.ts +168 -168
  147. package/src/createForm.svelte.ts +386 -386
  148. package/src/createGrid.svelte.ts +42 -42
  149. package/src/createGrid.test.ts +10 -10
  150. package/src/createGridState.svelte.ts +17 -17
  151. package/src/createMenu.svelte.ts +225 -225
  152. package/src/createPopoverSelect.svelte.ts +213 -213
  153. package/src/createSlider.svelte.ts +191 -191
  154. package/src/createTooltip.svelte.ts +144 -144
  155. package/src/createTree.svelte.ts +319 -319
  156. package/src/editing.test.ts +859 -859
  157. package/src/editing.ts +675 -675
  158. package/src/editor-contract.ts +157 -157
  159. package/src/export-data-api.test.ts +126 -126
  160. package/src/export-format.test.ts +107 -107
  161. package/src/export-format.ts +598 -598
  162. package/src/filter-operators.ts +157 -157
  163. package/src/flex-render.ts +3 -3
  164. package/src/form-field.ts +127 -127
  165. package/src/index.ts +713 -713
  166. package/src/js-scroller.svelte.ts +173 -173
  167. package/src/keyboard.test.ts +59 -59
  168. package/src/keyboard.ts +97 -97
  169. package/src/list-nav.test.ts +49 -49
  170. package/src/list-nav.ts +29 -29
  171. package/src/list-option.test.ts +56 -56
  172. package/src/list-option.ts +172 -172
  173. package/src/menus.test.ts +700 -700
  174. package/src/menus.ts +652 -652
  175. package/src/merge-objects.ts +48 -48
  176. package/src/overlays.test.ts +90 -90
  177. package/src/render-component.ts +28 -28
  178. package/src/scheduler-model.test.ts +562 -562
  179. package/src/scheduler-model.ts +872 -872
  180. package/src/selection.test.ts +754 -754
  181. package/src/selection.ts +600 -600
  182. package/src/server-data-source.test.ts +289 -289
  183. package/src/server-data-source.ts +413 -413
  184. package/src/sparkline.test.ts +68 -68
  185. package/src/sparkline.ts +169 -169
  186. package/src/spreadsheet.test.ts +489 -489
  187. package/src/spreadsheet.ts +312 -312
  188. package/src/static-functions.ts +11 -11
  189. package/src/subscribe.ts +38 -38
  190. package/src/svgrid-wrapper.types.ts +524 -524
  191. package/src/svgrid.behavior.test.ts +706 -706
  192. package/src/svgrid.charting.test.ts +534 -534
  193. package/src/svgrid.features.test.ts +157 -157
  194. package/src/svgrid.new-features.wrapper.test.ts +251 -251
  195. package/src/svgrid.wrapper.test.ts +40 -40
  196. package/src/test-setup.ts +62 -62
  197. package/src/themes/index.ts +215 -215
  198. package/src/toast-store.svelte.ts +246 -246
  199. package/src/toast-store.test.ts +147 -147
  200. package/src/ui-buttons.test.ts +144 -144
  201. package/src/ui-inputs.test.ts +118 -118
  202. package/src/ui-range.test.ts +70 -70
  203. package/src/ui-selection.test.ts +155 -155
  204. package/src/ui-tier1.test.ts +142 -142
  205. package/src/virtual.test.ts +88 -88
  206. package/src/virtualization/column-virtualizer.test.ts +27 -27
  207. package/src/virtualization/column-virtualizer.ts +30 -30
  208. package/src/virtualization/svelte-virtualizer.svelte.ts +26 -26
  209. package/src/virtualization/types.ts +30 -30
  210. package/src/virtualization/virtualizer.test.ts +47 -47
  211. package/src/virtualization/virtualizer.ts +296 -296
  212. package/themes/ember.css +71 -71
@@ -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>