@svgrid/grid 3.0.0 → 3.0.2

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 (304) hide show
  1. package/CHANGELOG.md +116 -88
  2. package/README.md +199 -199
  3. package/dist/FlexRender.svelte +96 -96
  4. package/dist/GridFooter.svelte +190 -181
  5. package/dist/GridFooter.svelte.d.ts +8 -0
  6. package/dist/GridMenus.svelte +18 -10
  7. package/dist/GridMenus.svelte.d.ts +2 -1
  8. package/dist/SvAutoComplete.svelte +169 -169
  9. package/dist/SvAvatar.svelte +75 -75
  10. package/dist/SvCalendar.svelte +503 -503
  11. package/dist/SvCarousel.svelte +141 -141
  12. package/dist/SvCheckBox.svelte +102 -102
  13. package/dist/SvCircularProgress.svelte +109 -109
  14. package/dist/SvColorInput.svelte +181 -181
  15. package/dist/SvComboBox.svelte +279 -279
  16. package/dist/SvContextMenu.svelte +116 -116
  17. package/dist/SvCountryInput.svelte +163 -163
  18. package/dist/SvDrawer.svelte +254 -254
  19. package/dist/SvDropDownList.svelte +378 -378
  20. package/dist/SvDurationInput.svelte +126 -126
  21. package/dist/SvField.svelte +293 -293
  22. package/dist/SvForm.svelte +437 -437
  23. package/dist/SvGrid.controller.svelte.d.ts +17 -0
  24. package/dist/SvGrid.controller.svelte.js +128 -14
  25. package/dist/SvGrid.css +79 -10
  26. package/dist/SvGrid.svelte +191 -186
  27. package/dist/SvGrid.types.d.ts +42 -1
  28. package/dist/SvGridCellEditor.svelte +748 -744
  29. package/dist/SvGridChart.svelte +2246 -1716
  30. package/dist/SvGridChart.svelte.d.ts +63 -1
  31. package/dist/SvGridChartPanel.svelte +633 -485
  32. package/dist/SvGridChartView.svelte +79 -70
  33. package/dist/SvGridChartView.svelte.d.ts +7 -0
  34. package/dist/SvGridDropdown.svelte +728 -728
  35. package/dist/SvGridSelect.svelte +270 -270
  36. package/dist/SvGroupCell.svelte +141 -116
  37. package/dist/SvGroupCell.svelte.d.ts +8 -0
  38. package/dist/SvListBox.svelte +334 -334
  39. package/dist/SvMaskedInput.svelte +122 -122
  40. package/dist/SvMenu.svelte +124 -124
  41. package/dist/SvMenuList.svelte +146 -146
  42. package/dist/SvMultiSelect.svelte +293 -293
  43. package/dist/SvNumberInput.svelte +172 -172
  44. package/dist/SvOtpInput.svelte +158 -158
  45. package/dist/SvPasswordInput.svelte +151 -151
  46. package/dist/SvPhoneInput.svelte +133 -133
  47. package/dist/SvPopover.svelte +197 -197
  48. package/dist/SvProgress.svelte +116 -116
  49. package/dist/SvRadioGroup.svelte +107 -107
  50. package/dist/SvRating.svelte +112 -112
  51. package/dist/SvResult.svelte +73 -73
  52. package/dist/SvRichText.svelte +211 -211
  53. package/dist/SvRowGroupPanel.svelte +186 -170
  54. package/dist/SvRowGroupPanel.svelte.d.ts +8 -0
  55. package/dist/SvScrollArea.svelte +61 -61
  56. package/dist/SvSlider.svelte +203 -203
  57. package/dist/SvSwitchButton.svelte +108 -108
  58. package/dist/SvTagsInput.svelte +115 -115
  59. package/dist/SvTextInput.svelte +147 -147
  60. package/dist/SvTimePicker.svelte +245 -245
  61. package/dist/SvToaster.svelte +159 -159
  62. package/dist/SvToggleButton.svelte +85 -85
  63. package/dist/SvTooltip.svelte +161 -161
  64. package/dist/SvTour.svelte +208 -208
  65. package/dist/SvTree.svelte +444 -444
  66. package/dist/SvTreeSelect.svelte +239 -239
  67. package/dist/ai.d.ts +11 -2
  68. package/dist/ai.js +51 -7
  69. package/dist/cdn/GridMenus-DyFA-QxA.js +602 -0
  70. package/dist/cdn/GridMenus-M2XP9t0_.js +603 -0
  71. package/dist/cdn/{SvDateRangeInput-DflbiP7N.js → SvDateRangeInput-CaOuMs8O.js} +1 -1
  72. package/dist/cdn/{SvDateRangeInput-Bh0A0JkF.js → SvDateRangeInput-DMLKmGEc.js} +1 -1
  73. package/dist/cdn/{SvDateTimePicker-Bivn8dAP.js → SvDateTimePicker-CCbDZNZB.js} +1 -1
  74. package/dist/cdn/{SvDateTimePicker-BWwpfB_o.js → SvDateTimePicker-sonaH0oh.js} +1 -1
  75. package/dist/cdn/{SvGridCellEditor-Ba7rY3eu.js → SvGridCellEditor-BWnTi2N7.js} +2 -2
  76. package/dist/cdn/{SvGridCellEditor-AXL8cHGO.js → SvGridCellEditor-CjEJMJKc.js} +2 -2
  77. package/dist/cdn/SvGridChart-DAb9RbRs.js +1480 -0
  78. package/dist/cdn/SvGridChart-Yl-IXZFO.js +1481 -0
  79. package/dist/cdn/SvGridChartPanel-DayQpDsR.js +834 -0
  80. package/dist/cdn/SvGridChartPanel-aqf8n-vJ.js +810 -0
  81. package/dist/cdn/{SvGridChartView-eSPuJE6g.js → SvGridChartView-CxfakxR0.js} +5 -3
  82. package/dist/cdn/{SvGridChartView-SmPW10dI.js → SvGridChartView-Dm_YEx9L.js} +5 -3
  83. package/dist/cdn/{SvGridDropdown-B1ZcLpgs.js → SvGridDropdown-D0VdjeR8.js} +1 -1
  84. package/dist/cdn/{SvGridDropdown-CtdbHcIS.js → SvGridDropdown-D13MtJ2j.js} +1 -1
  85. package/dist/cdn/cell-formatting-C2Hf5gqd.js +86 -0
  86. package/dist/cdn/chart-CKJRCPOk.js +1652 -0
  87. package/dist/cdn/{date-format-DZT7T1wf.js → date-format-BNii4zeD.js} +2 -2
  88. package/dist/cdn/{date-format-CcP1tafP.js → date-format-BnnHlqGw.js} +2 -2
  89. package/dist/cdn/{export-format-Cv1Dll6k.js → export-format-CUDLy2yn.js} +84 -168
  90. package/dist/cdn/{src-B_YS5AOc.js → src-BJ2opd0j.js} +3642 -3450
  91. package/dist/cdn/{src-DYXXpuSk.js → src-DNbz94Ct.js} +8649 -8457
  92. package/dist/cdn/svgrid.js +16 -15
  93. package/dist/cdn/svgrid.svelte-external.js +16 -15
  94. package/dist/cell-formatting.d.ts +7 -0
  95. package/dist/cell-formatting.js +7 -1
  96. package/dist/chart-export.d.ts +23 -2
  97. package/dist/chart-export.js +88 -14
  98. package/dist/chart.d.ts +410 -18
  99. package/dist/chart.js +824 -24
  100. package/dist/editing.js +22 -13
  101. package/dist/grid-icons.d.ts +49 -0
  102. package/dist/grid-icons.js +86 -0
  103. package/dist/index.d.ts +3 -2
  104. package/dist/index.js +3 -2
  105. package/package.json +1 -1
  106. package/src/FlexRender.svelte +96 -96
  107. package/src/GridFooter.svelte +190 -181
  108. package/src/GridMenus.svelte +18 -10
  109. package/src/SvAutoComplete.svelte +169 -169
  110. package/src/SvAvatar.svelte +75 -75
  111. package/src/SvCalendar.svelte +503 -503
  112. package/src/SvCalendar.test.ts +226 -226
  113. package/src/SvCarousel.svelte +141 -141
  114. package/src/SvCheckBox.svelte +102 -102
  115. package/src/SvCircularProgress.svelte +109 -109
  116. package/src/SvColorInput.svelte +181 -181
  117. package/src/SvComboBox.svelte +279 -279
  118. package/src/SvContextMenu.svelte +116 -116
  119. package/src/SvCountryInput.svelte +163 -163
  120. package/src/SvDrawer.svelte +254 -254
  121. package/src/SvDropDownList.svelte +378 -378
  122. package/src/SvDurationInput.svelte +126 -126
  123. package/src/SvField.svelte +293 -293
  124. package/src/SvForm.svelte +437 -437
  125. package/src/SvForm.test.ts +411 -411
  126. package/src/SvGrid.controller.svelte.ts +146 -13
  127. package/src/SvGrid.css +79 -10
  128. package/src/SvGrid.svelte +191 -186
  129. package/src/SvGrid.types.ts +2133 -2092
  130. package/src/SvGridCellEditor.svelte +748 -744
  131. package/src/SvGridChart.svelte +2246 -1716
  132. package/src/SvGridChart.test.ts +243 -1
  133. package/src/SvGridChartPanel.svelte +633 -485
  134. package/src/SvGridChartView.svelte +79 -70
  135. package/src/SvGridDropdown.svelte +728 -728
  136. package/src/SvGridSelect.svelte +270 -270
  137. package/src/SvGroupCell.svelte +141 -116
  138. package/src/SvListBox.svelte +334 -334
  139. package/src/SvMaskedInput.svelte +122 -122
  140. package/src/SvMenu.svelte +124 -124
  141. package/src/SvMenu.test.ts +97 -97
  142. package/src/SvMenuList.svelte +146 -146
  143. package/src/SvMultiSelect.svelte +293 -293
  144. package/src/SvNumberInput.svelte +172 -172
  145. package/src/SvOtpInput.svelte +158 -158
  146. package/src/SvPasswordInput.svelte +151 -151
  147. package/src/SvPhoneInput.svelte +133 -133
  148. package/src/SvPopover.svelte +197 -197
  149. package/src/SvProgress.svelte +116 -116
  150. package/src/SvRadioGroup.svelte +107 -107
  151. package/src/SvRating.svelte +112 -112
  152. package/src/SvResult.svelte +73 -73
  153. package/src/SvRichText.svelte +211 -211
  154. package/src/SvRowGroupPanel.svelte +186 -170
  155. package/src/SvScrollArea.svelte +61 -61
  156. package/src/SvSlider.svelte +203 -203
  157. package/src/SvSwitchButton.svelte +108 -108
  158. package/src/SvTagsInput.svelte +115 -115
  159. package/src/SvTextInput.svelte +147 -147
  160. package/src/SvTimePicker.svelte +245 -245
  161. package/src/SvToaster.svelte +159 -159
  162. package/src/SvToaster.test.ts +95 -95
  163. package/src/SvToggleButton.svelte +85 -85
  164. package/src/SvTooltip.svelte +161 -161
  165. package/src/SvTour.svelte +208 -208
  166. package/src/SvTree.svelte +444 -444
  167. package/src/SvTreeSelect.svelte +239 -239
  168. package/src/a11y/dismissable.test.ts +119 -119
  169. package/src/a11y/dismissable.ts +114 -114
  170. package/src/a11y.contract.test.ts +49 -49
  171. package/src/a11y.test.ts +59 -59
  172. package/src/a11y.ts +61 -61
  173. package/src/ai.test.ts +561 -502
  174. package/src/ai.ts +1472 -1419
  175. package/src/build-api.coverage.test.ts +633 -633
  176. package/src/build-api.ts +846 -846
  177. package/src/builtin-editors.grid.test.ts +83 -83
  178. package/src/cell-formatting.ts +177 -171
  179. package/src/cell-render.test.ts +513 -513
  180. package/src/cell-render.ts +496 -496
  181. package/src/cell-values.ts +148 -148
  182. package/src/chart-export.test.ts +112 -0
  183. package/src/chart-export.ts +270 -202
  184. package/src/chart-view.svelte.ts +36 -36
  185. package/src/chart.test.ts +830 -1
  186. package/src/chart.ts +3342 -2321
  187. package/src/collaboration.test.ts +104 -104
  188. package/src/collaboration.ts +167 -167
  189. package/src/column-groups.ts +78 -78
  190. package/src/core.performance.test.ts +30 -30
  191. package/src/core.ts +1865 -1865
  192. package/src/createAutocomplete.svelte.ts +132 -132
  193. package/src/createCombobox.svelte.ts +191 -191
  194. package/src/createCountryInput.svelte.ts +157 -157
  195. package/src/createDropdownList.svelte.ts +168 -168
  196. package/src/createForm.svelte.ts +386 -386
  197. package/src/createGrid.svelte.ts +42 -42
  198. package/src/createGrid.test.ts +10 -10
  199. package/src/createGridState.svelte.ts +17 -17
  200. package/src/createListbox.svelte.ts +250 -250
  201. package/src/createMenu.svelte.ts +224 -224
  202. package/src/createPopoverSelect.svelte.ts +213 -213
  203. package/src/createSlider.svelte.ts +191 -191
  204. package/src/createTooltip.svelte.ts +144 -144
  205. package/src/createTree.svelte.ts +322 -322
  206. package/src/datetime/date-core.ts +206 -206
  207. package/src/datetime/date-restrict.ts +61 -61
  208. package/src/datetime/timezone.ts +135 -135
  209. package/src/dock-manager-model.ts +596 -596
  210. package/src/dock-model.ts +374 -374
  211. package/src/editing.test.ts +974 -974
  212. package/src/editing.ts +618 -609
  213. package/src/editor-contract.ts +171 -171
  214. package/src/editor-registry.grid.test.ts +144 -144
  215. package/src/editor-registry.ts +122 -122
  216. package/src/export-data-api.test.ts +126 -126
  217. package/src/export-format.test.ts +107 -107
  218. package/src/export-format.ts +601 -601
  219. package/src/filter-operators.ts +160 -160
  220. package/src/filtering/excel-filters.ts +325 -325
  221. package/src/flex-render.ts +3 -3
  222. package/src/form-field.ts +127 -127
  223. package/src/grid-icons.test.ts +46 -0
  224. package/src/grid-icons.ts +184 -0
  225. package/src/group-display.test.ts +167 -167
  226. package/src/group-display.ts +200 -200
  227. package/src/headless.ts +87 -87
  228. package/src/icon-overrides.grid.test.ts +188 -0
  229. package/src/icon-seam.test.ts +100 -0
  230. package/src/index.ts +19 -0
  231. package/src/js-scroller.svelte.ts +173 -173
  232. package/src/keyboard-handlers.ts +270 -270
  233. package/src/keyboard.test.ts +59 -59
  234. package/src/keyboard.ts +97 -97
  235. package/src/list-nav.test.ts +49 -49
  236. package/src/list-nav.ts +29 -29
  237. package/src/list-option.test.ts +56 -56
  238. package/src/list-option.ts +179 -179
  239. package/src/menus.ts +597 -597
  240. package/src/merge-objects.ts +48 -48
  241. package/src/overlays.test.ts +90 -90
  242. package/src/positioning.ts +268 -268
  243. package/src/render-component.ts +28 -28
  244. package/src/row-drag.test.ts +401 -401
  245. package/src/row-drag.ts +419 -419
  246. package/src/row-resize.test.ts +524 -524
  247. package/src/row-resize.ts +228 -228
  248. package/src/scheduler-ical.ts +181 -181
  249. package/src/scheduler-model.test.ts +562 -562
  250. package/src/scheduler-model.ts +873 -873
  251. package/src/selection.test.ts +885 -885
  252. package/src/server-data-source.test.ts +383 -383
  253. package/src/server-data-source.ts +469 -469
  254. package/src/sparkline.test.ts +68 -68
  255. package/src/sparkline.ts +169 -169
  256. package/src/spreadsheet.test.ts +488 -488
  257. package/src/spreadsheet.ts +312 -312
  258. package/src/static-functions.ts +11 -11
  259. package/src/subscribe.ts +38 -38
  260. package/src/summaries.ts +113 -113
  261. package/src/svgrid-wrapper.types.ts +563 -563
  262. package/src/svgrid.async-editor-options.test.ts +273 -273
  263. package/src/svgrid.auto-row-height.test.ts +204 -204
  264. package/src/svgrid.behavior.test.ts +910 -910
  265. package/src/svgrid.charting.test.ts +654 -534
  266. package/src/svgrid.comments-autocomplete.test.ts +127 -127
  267. package/src/svgrid.context-menu.test.ts +147 -147
  268. package/src/svgrid.features.test.ts +157 -157
  269. package/src/svgrid.filter-depth.test.ts +163 -163
  270. package/src/svgrid.filter-menu-listbox.svelte.test.ts +382 -377
  271. package/src/svgrid.filter-menu-scroll.test.ts +112 -112
  272. package/src/svgrid.grand-total.test.ts +188 -188
  273. package/src/svgrid.group-display-mode.test.ts +171 -171
  274. package/src/svgrid.group-footers.test.ts +121 -121
  275. package/src/svgrid.group-pagination.test.ts +153 -153
  276. package/src/svgrid.new-features.wrapper.test.ts +251 -251
  277. package/src/svgrid.tree-data.test.ts +186 -186
  278. package/src/svgrid.wrapper.test.ts +63 -63
  279. package/src/svgriddropdown.async-panel.svelte.test.ts +195 -195
  280. package/src/test-setup.ts +62 -62
  281. package/src/themes/index.ts +288 -288
  282. package/src/toast-store.svelte.ts +250 -250
  283. package/src/toast-store.test.ts +147 -147
  284. package/src/tree-row-model.test.ts +168 -168
  285. package/src/ui-buttons.test.ts +144 -144
  286. package/src/ui-inputs.test.ts +118 -118
  287. package/src/ui-localization.test.ts +113 -113
  288. package/src/ui-range.test.ts +70 -70
  289. package/src/ui-selection.test.ts +155 -155
  290. package/src/ui-tier1.test.ts +142 -142
  291. package/src/virtual.test.ts +88 -88
  292. package/src/virtualization/column-virtualizer.test.ts +27 -27
  293. package/src/virtualization/column-virtualizer.ts +30 -30
  294. package/src/virtualization/svelte-virtualizer.svelte.ts +26 -26
  295. package/src/virtualization/types.ts +30 -30
  296. package/src/virtualization/virtualizer.test.ts +47 -47
  297. package/src/virtualization/virtualizer.ts +322 -322
  298. package/dist/cdn/GridMenus-DMihUtma.js +0 -600
  299. package/dist/cdn/GridMenus-nmNDj1a3.js +0 -601
  300. package/dist/cdn/SvGridChart-Bs2GIR2Q.js +0 -1202
  301. package/dist/cdn/SvGridChart-CwhFz7GV.js +0 -1203
  302. package/dist/cdn/SvGridChartPanel-1WXuStzM.js +0 -561
  303. package/dist/cdn/SvGridChartPanel-e5_nqNP9.js +0 -585
  304. package/dist/cdn/chart-i4XcXyHJ.js +0 -1214
@@ -1,293 +1,293 @@
1
- <script lang="ts">
2
- /**
3
- * SvField - the shared field chrome for every value-bearing editor in the kit.
4
- * It renders an optional `label` (wired to the control via `for`/`id`), the
5
- * control itself (passed as children), and an optional `hint` / `error` line
6
- * whose ids match `editorHintId` / `editorErrorId` for `aria-describedby`.
7
- *
8
- * Two modes:
9
- *
10
- * 1. Default (`frame` unset) - SvField renders only the label / children / hint
11
- * / error rows; the editor draws its own bordered control box. This is the
12
- * original behavior and is byte-identical for every existing call site.
13
- *
14
- * ```svelte
15
- * <SvField {id} {label} {hint} {error} {required} {dir}>
16
- * <div class="sv-num">...control...</div>
17
- * </SvField>
18
- * ```
19
- *
20
- * 2. Framed (`frame`) - SvField OWNS the bordered control box, so it applies
21
- * `invalid` + `size` styling, the shared leading/trailing adornments and
22
- * prefix/suffix affixes, and the shared clear button ONCE, and the editor
23
- * passes only its bare control (an `<input>` / `<button>` / etc.):
24
- *
25
- * ```svelte
26
- * <SvField frame {id} {label} {size} {invalid} clearable showClear={!!value}
27
- * onclear={() => set('')}>
28
- * {#snippet leading()}<SearchIcon />{/snippet}
29
- * <input class="sv-field__native" ... />
30
- * </SvField>
31
- * ```
32
- *
33
- * In framed mode the editor's bare `<input>` / `<textarea>` / `<select>`
34
- * inherits borderless chrome automatically (see the scoped `:global` rule),
35
- * so editors no longer re-implement the box / focus ring / invalid / size.
36
- */
37
- import type { Snippet } from 'svelte'
38
- import { editorErrorId, editorHintId, type EditorAction, type EditorDir, type EditorSize } from './editor-contract'
39
-
40
- let {
41
- id,
42
- label,
43
- hint,
44
- error,
45
- required = false,
46
- dir,
47
- /** Stretch the field (and its control) to the container width. */
48
- block = false,
49
- /** Busy state - shows a small spinner beside the label. */
50
- loading = false,
51
- /**
52
- * Own the bordered control box (invalid/size/adornments/clear). Opt-in so
53
- * existing editors that draw their own box are unaffected.
54
- */
55
- frame = false,
56
- /** Framed mode: invalid styling on the box + border. */
57
- invalid = false,
58
- /** Framed mode: control size / density. */
59
- size = 'md',
60
- /** Framed mode: dim + block interaction styling. */
61
- disabled = false,
62
- /** Framed mode: read-only styling. */
63
- readonly = false,
64
- /** Framed mode: leading adornment (icon/button) at the start of the box. */
65
- leading,
66
- /** Framed mode: trailing adornment (icon/button) at the end of the box. */
67
- trailing,
68
- /** Framed mode: plain-text affix at the start (units like `$`). */
69
- prefix,
70
- /** Framed mode: plain-text affix at the end (units like `kg`). */
71
- suffix,
72
- /** Framed mode: render the shared clear button when {@link showClear}. */
73
- clearable = false,
74
- /** Framed mode: whether there is a value to clear right now. */
75
- showClear = false,
76
- /** Framed mode: invoked when the shared clear button is pressed. */
77
- onclear,
78
- /** Framed mode: accessible label for the clear button. */
79
- clearLabel = 'Clear',
80
- /** Framed mode: control width (number = px). Default 220; `block` overrides to 100%. */
81
- width,
82
- /** `floating` overlays the label in the box and animates it up on focus/value
83
- * (framed mode only). Default `static` (label above the control). */
84
- labelMode = 'static',
85
- /** Floating mode: whether the control currently holds a value (keeps the
86
- * label up). Focus is detected via `:focus-within`. */
87
- filled = false,
88
- /** Framed mode: compact in-field action buttons (lookup/generate/copy...). */
89
- actions,
90
- children,
91
- }: {
92
- id?: string
93
- label?: string
94
- hint?: string
95
- error?: string
96
- required?: boolean
97
- dir?: EditorDir
98
- block?: boolean
99
- loading?: boolean
100
- frame?: boolean
101
- invalid?: boolean
102
- size?: EditorSize
103
- disabled?: boolean
104
- readonly?: boolean
105
- leading?: Snippet
106
- trailing?: Snippet
107
- prefix?: string
108
- suffix?: string
109
- clearable?: boolean
110
- showClear?: boolean
111
- onclear?: () => void
112
- clearLabel?: string
113
- width?: number | string
114
- labelMode?: 'static' | 'floating'
115
- filled?: boolean
116
- actions?: EditorAction[]
117
- children: Snippet
118
- } = $props()
119
-
120
- const controlWidth = $derived(width == null ? undefined : typeof width === 'number' ? `${width}px` : width)
121
- // Floating labels need the framed box to anchor to and an actual label.
122
- const floating = $derived(labelMode === 'floating' && frame && !!label)
123
-
124
- // 'auto'/undefined -> inherit from the document (no dir attribute).
125
- const resolvedDir = $derived(dir === 'ltr' || dir === 'rtl' ? dir : undefined)
126
- </script>
127
-
128
- <div class="sv-field" class:sv-field--block={block} class:sv-field--floating={floating} dir={resolvedDir}>
129
- {#if (label && !floating) || loading}
130
- <span class="sv-field__labelrow">
131
- {#if label && !floating}
132
- <label class="sv-field__label" for={id}>
133
- {label}{#if required}<span class="sv-field__req" aria-hidden="true">*</span>{/if}
134
- </label>
135
- {/if}
136
- {#if loading}<span class="sv-field__spinner" role="status" aria-label="Loading"></span>{/if}
137
- </span>
138
- {/if}
139
- {#if frame}
140
- <div
141
- class="sv-field__control sv-field--{size}"
142
- class:is-invalid={invalid}
143
- class:is-disabled={disabled}
144
- class:is-readonly={readonly}
145
- class:is-filled={filled}
146
- style:width={block ? undefined : controlWidth}
147
- >
148
- {#if floating}
149
- <label class="sv-field__float-label" for={id}>{label}{#if required}<span class="sv-field__req" aria-hidden="true">*</span>{/if}</label>
150
- {/if}
151
- {#if leading}<span class="sv-field__adorn sv-field__adorn--lead">{@render leading()}</span>{/if}
152
- {#if prefix}<span class="sv-field__affix sv-field__affix--pre">{prefix}</span>{/if}
153
- <span class="sv-field__slot">{@render children()}</span>
154
- {#if suffix}<span class="sv-field__affix sv-field__affix--suf">{suffix}</span>{/if}
155
- {#if trailing}<span class="sv-field__adorn sv-field__adorn--trail">{@render trailing()}</span>{/if}
156
- {#if actions?.length}
157
- {#each actions as a (a.label)}
158
- <button class="sv-field__action" type="button" tabindex="-1" aria-label={a.label} title={a.label} disabled={disabled || a.disabled} onclick={() => a.onClick()}>
159
- {#if a.icon}{@render a.icon()}{:else}<span class="sv-field__action-txt">{a.label}</span>{/if}
160
- </button>
161
- {/each}
162
- {/if}
163
- {#if clearable && showClear && !disabled && !readonly}
164
- <button class="sv-field__clear" type="button" tabindex="-1" aria-label={clearLabel} onclick={() => onclear?.()}>&times;</button>
165
- {/if}
166
- </div>
167
- {:else}
168
- {@render children()}
169
- {/if}
170
- {#if error}
171
- <span class="sv-field__error" id={editorErrorId(id)} role="alert">{error}</span>
172
- {:else if hint}
173
- <span class="sv-field__hint" id={editorHintId(id)}>{hint}</span>
174
- {/if}
175
- </div>
176
-
177
- <style>
178
- .sv-field {
179
- display: inline-flex;
180
- flex-direction: column;
181
- gap: 3px;
182
- text-align: start;
183
- }
184
- .sv-field--block { display: flex; width: 100%; }
185
- .sv-field__labelrow { display: inline-flex; align-items: center; gap: 6px; }
186
- .sv-field__label {
187
- font-size: 12.5px;
188
- font-weight: 550;
189
- color: var(--sg-fg, #0f172a);
190
- line-height: 1.3;
191
- }
192
- .sv-field__spinner {
193
- width: 12px; height: 12px; flex: none; border-radius: 50%;
194
- border: 2px solid color-mix(in srgb, var(--sg-accent, #2563eb) 30%, transparent);
195
- border-top-color: var(--sg-accent, #2563eb);
196
- animation: sv-field-spin 0.6s linear infinite;
197
- }
198
- @keyframes sv-field-spin { to { transform: rotate(360deg); } }
199
- @media (prefers-reduced-motion: reduce) { .sv-field__spinner { animation: none; } }
200
- .sv-field__req { color: var(--sg-danger, #dc2626); margin-inline-start: 2px; }
201
- .sv-field__hint {
202
- font-size: 11.5px;
203
- color: var(--sg-muted, #64748b);
204
- line-height: 1.35;
205
- }
206
- .sv-field__error {
207
- font-size: 11.5px;
208
- font-weight: 500;
209
- color: var(--sg-danger, #dc2626);
210
- line-height: 1.35;
211
- }
212
-
213
- /* ---- Framed mode: the shared control box (opt-in via `frame`) ---- */
214
- .sv-field__control {
215
- --_accent: var(--sg-accent, #2563eb);
216
- display: flex; align-items: center; width: 220px;
217
- background: var(--sg-input-bg, #fff); color: var(--sg-fg, #0f172a);
218
- border: 1px solid var(--sg-input-border, var(--sg-border, #cbd5e1));
219
- border-radius: var(--sg-radius, 8px);
220
- }
221
- .sv-field--block .sv-field__control { width: 100%; }
222
- .sv-field__control:focus-within {
223
- border-color: var(--_accent);
224
- box-shadow: 0 0 0 2px color-mix(in srgb, var(--_accent) 22%, transparent);
225
- }
226
- .sv-field__control.is-invalid { border-color: var(--sg-danger, #dc2626); }
227
- .sv-field__control.is-invalid:focus-within {
228
- box-shadow: 0 0 0 2px color-mix(in srgb, var(--sg-danger, #dc2626) 22%, transparent);
229
- }
230
- .sv-field__control.is-disabled { opacity: 0.6; }
231
- .sv-field__control.is-readonly { background: var(--sg-muted-bg, color-mix(in srgb, var(--sg-fg, #0f172a) 4%, var(--sg-input-bg, #fff))); }
232
-
233
- /* ---- Floating label ---- */
234
- .sv-field--floating .sv-field__control { position: relative; }
235
- .sv-field__float-label {
236
- position: absolute; inset-inline-start: 11px; top: 50%; transform: translateY(-50%);
237
- font-size: 13px; color: var(--sg-muted, #64748b); pointer-events: none;
238
- background: var(--sg-input-bg, #fff); padding: 0 4px; max-width: calc(100% - 24px);
239
- white-space: nowrap; overflow: hidden; text-overflow: ellipsis; z-index: 1;
240
- transition: top 0.14s ease, font-size 0.14s ease, color 0.14s ease;
241
- }
242
- .sv-field__control:focus-within .sv-field__float-label,
243
- .sv-field__control.is-filled .sv-field__float-label {
244
- top: 0; font-size: 10.5px; color: var(--_accent, var(--sg-accent, #2563eb));
245
- }
246
- .sv-field__control.is-invalid .sv-field__float-label { color: var(--sg-danger, #dc2626); }
247
- @media (prefers-reduced-motion: reduce) { .sv-field__float-label { transition: none; } }
248
-
249
- .sv-field__slot { display: flex; flex: 1; min-width: 0; }
250
- /* Bare form controls passed as children inherit borderless chrome so editors
251
- no longer re-implement the box. Scoped to the framed control only. */
252
- .sv-field__slot :global(input),
253
- .sv-field__slot :global(textarea),
254
- .sv-field__slot :global(select) {
255
- flex: 1; min-width: 0; width: 100%;
256
- border: 0; background: none; outline: none;
257
- color: inherit; font: inherit; padding: 0 10px;
258
- }
259
-
260
- .sv-field__adorn { display: inline-flex; align-items: center; color: var(--sg-muted, #64748b); }
261
- .sv-field__adorn--lead { padding-inline-start: 10px; }
262
- .sv-field__adorn--trail { padding-inline-end: 10px; }
263
- .sv-field__affix { display: inline-flex; align-items: center; color: var(--sg-muted, #64748b); white-space: nowrap; }
264
- .sv-field__affix--pre { padding-inline-start: 10px; }
265
- .sv-field__affix--suf { padding-inline-end: 10px; }
266
- /* When an affix/adornment sits next to the control, drop the control's own
267
- edge padding so text hugs the affix. */
268
- .sv-field__adorn--lead + .sv-field__slot :global(input),
269
- .sv-field__affix--pre + .sv-field__slot :global(input) { padding-inline-start: 6px; }
270
-
271
- .sv-field__clear {
272
- display: grid; place-items: center; width: 28px; align-self: stretch;
273
- background: none; border: 0; color: var(--sg-muted, #64748b); cursor: pointer;
274
- font-size: 17px; line-height: 1;
275
- }
276
- .sv-field__clear:hover { color: var(--sg-fg, #0f172a); }
277
- .sv-field__action {
278
- display: inline-grid; place-items: center; align-self: center; flex: none;
279
- min-width: 24px; height: 24px; margin-inline-end: 3px; padding: 0 5px;
280
- background: none; border: 0; border-radius: 5px; color: var(--sg-muted, #64748b);
281
- cursor: pointer; font: inherit; font-size: 12px;
282
- }
283
- .sv-field__action:hover:not([disabled]) { background: var(--sg-row-hover-bg, #f1f5f9); color: var(--sg-accent, #2563eb); }
284
- .sv-field__action[disabled] { opacity: 0.5; cursor: default; }
285
- .sv-field__action-txt { font-weight: 600; white-space: nowrap; }
286
-
287
- .sv-field--sm .sv-field__control,
288
- .sv-field__control.sv-field--sm { height: 28px; font-size: 12px; }
289
- .sv-field--md .sv-field__control,
290
- .sv-field__control.sv-field--md { height: 34px; font-size: 13px; }
291
- .sv-field--lg .sv-field__control,
292
- .sv-field__control.sv-field--lg { height: 40px; font-size: 15px; }
293
- </style>
1
+ <script lang="ts">
2
+ /**
3
+ * SvField - the shared field chrome for every value-bearing editor in the kit.
4
+ * It renders an optional `label` (wired to the control via `for`/`id`), the
5
+ * control itself (passed as children), and an optional `hint` / `error` line
6
+ * whose ids match `editorHintId` / `editorErrorId` for `aria-describedby`.
7
+ *
8
+ * Two modes:
9
+ *
10
+ * 1. Default (`frame` unset) - SvField renders only the label / children / hint
11
+ * / error rows; the editor draws its own bordered control box. This is the
12
+ * original behavior and is byte-identical for every existing call site.
13
+ *
14
+ * ```svelte
15
+ * <SvField {id} {label} {hint} {error} {required} {dir}>
16
+ * <div class="sv-num">...control...</div>
17
+ * </SvField>
18
+ * ```
19
+ *
20
+ * 2. Framed (`frame`) - SvField OWNS the bordered control box, so it applies
21
+ * `invalid` + `size` styling, the shared leading/trailing adornments and
22
+ * prefix/suffix affixes, and the shared clear button ONCE, and the editor
23
+ * passes only its bare control (an `<input>` / `<button>` / etc.):
24
+ *
25
+ * ```svelte
26
+ * <SvField frame {id} {label} {size} {invalid} clearable showClear={!!value}
27
+ * onclear={() => set('')}>
28
+ * {#snippet leading()}<SearchIcon />{/snippet}
29
+ * <input class="sv-field__native" ... />
30
+ * </SvField>
31
+ * ```
32
+ *
33
+ * In framed mode the editor's bare `<input>` / `<textarea>` / `<select>`
34
+ * inherits borderless chrome automatically (see the scoped `:global` rule),
35
+ * so editors no longer re-implement the box / focus ring / invalid / size.
36
+ */
37
+ import type { Snippet } from 'svelte'
38
+ import { editorErrorId, editorHintId, type EditorAction, type EditorDir, type EditorSize } from './editor-contract'
39
+
40
+ let {
41
+ id,
42
+ label,
43
+ hint,
44
+ error,
45
+ required = false,
46
+ dir,
47
+ /** Stretch the field (and its control) to the container width. */
48
+ block = false,
49
+ /** Busy state - shows a small spinner beside the label. */
50
+ loading = false,
51
+ /**
52
+ * Own the bordered control box (invalid/size/adornments/clear). Opt-in so
53
+ * existing editors that draw their own box are unaffected.
54
+ */
55
+ frame = false,
56
+ /** Framed mode: invalid styling on the box + border. */
57
+ invalid = false,
58
+ /** Framed mode: control size / density. */
59
+ size = 'md',
60
+ /** Framed mode: dim + block interaction styling. */
61
+ disabled = false,
62
+ /** Framed mode: read-only styling. */
63
+ readonly = false,
64
+ /** Framed mode: leading adornment (icon/button) at the start of the box. */
65
+ leading,
66
+ /** Framed mode: trailing adornment (icon/button) at the end of the box. */
67
+ trailing,
68
+ /** Framed mode: plain-text affix at the start (units like `$`). */
69
+ prefix,
70
+ /** Framed mode: plain-text affix at the end (units like `kg`). */
71
+ suffix,
72
+ /** Framed mode: render the shared clear button when {@link showClear}. */
73
+ clearable = false,
74
+ /** Framed mode: whether there is a value to clear right now. */
75
+ showClear = false,
76
+ /** Framed mode: invoked when the shared clear button is pressed. */
77
+ onclear,
78
+ /** Framed mode: accessible label for the clear button. */
79
+ clearLabel = 'Clear',
80
+ /** Framed mode: control width (number = px). Default 220; `block` overrides to 100%. */
81
+ width,
82
+ /** `floating` overlays the label in the box and animates it up on focus/value
83
+ * (framed mode only). Default `static` (label above the control). */
84
+ labelMode = 'static',
85
+ /** Floating mode: whether the control currently holds a value (keeps the
86
+ * label up). Focus is detected via `:focus-within`. */
87
+ filled = false,
88
+ /** Framed mode: compact in-field action buttons (lookup/generate/copy...). */
89
+ actions,
90
+ children,
91
+ }: {
92
+ id?: string
93
+ label?: string
94
+ hint?: string
95
+ error?: string
96
+ required?: boolean
97
+ dir?: EditorDir
98
+ block?: boolean
99
+ loading?: boolean
100
+ frame?: boolean
101
+ invalid?: boolean
102
+ size?: EditorSize
103
+ disabled?: boolean
104
+ readonly?: boolean
105
+ leading?: Snippet
106
+ trailing?: Snippet
107
+ prefix?: string
108
+ suffix?: string
109
+ clearable?: boolean
110
+ showClear?: boolean
111
+ onclear?: () => void
112
+ clearLabel?: string
113
+ width?: number | string
114
+ labelMode?: 'static' | 'floating'
115
+ filled?: boolean
116
+ actions?: EditorAction[]
117
+ children: Snippet
118
+ } = $props()
119
+
120
+ const controlWidth = $derived(width == null ? undefined : typeof width === 'number' ? `${width}px` : width)
121
+ // Floating labels need the framed box to anchor to and an actual label.
122
+ const floating = $derived(labelMode === 'floating' && frame && !!label)
123
+
124
+ // 'auto'/undefined -> inherit from the document (no dir attribute).
125
+ const resolvedDir = $derived(dir === 'ltr' || dir === 'rtl' ? dir : undefined)
126
+ </script>
127
+
128
+ <div class="sv-field" class:sv-field--block={block} class:sv-field--floating={floating} dir={resolvedDir}>
129
+ {#if (label && !floating) || loading}
130
+ <span class="sv-field__labelrow">
131
+ {#if label && !floating}
132
+ <label class="sv-field__label" for={id}>
133
+ {label}{#if required}<span class="sv-field__req" aria-hidden="true">*</span>{/if}
134
+ </label>
135
+ {/if}
136
+ {#if loading}<span class="sv-field__spinner" role="status" aria-label="Loading"></span>{/if}
137
+ </span>
138
+ {/if}
139
+ {#if frame}
140
+ <div
141
+ class="sv-field__control sv-field--{size}"
142
+ class:is-invalid={invalid}
143
+ class:is-disabled={disabled}
144
+ class:is-readonly={readonly}
145
+ class:is-filled={filled}
146
+ style:width={block ? undefined : controlWidth}
147
+ >
148
+ {#if floating}
149
+ <label class="sv-field__float-label" for={id}>{label}{#if required}<span class="sv-field__req" aria-hidden="true">*</span>{/if}</label>
150
+ {/if}
151
+ {#if leading}<span class="sv-field__adorn sv-field__adorn--lead">{@render leading()}</span>{/if}
152
+ {#if prefix}<span class="sv-field__affix sv-field__affix--pre">{prefix}</span>{/if}
153
+ <span class="sv-field__slot">{@render children()}</span>
154
+ {#if suffix}<span class="sv-field__affix sv-field__affix--suf">{suffix}</span>{/if}
155
+ {#if trailing}<span class="sv-field__adorn sv-field__adorn--trail">{@render trailing()}</span>{/if}
156
+ {#if actions?.length}
157
+ {#each actions as a (a.label)}
158
+ <button class="sv-field__action" type="button" tabindex="-1" aria-label={a.label} title={a.label} disabled={disabled || a.disabled} onclick={() => a.onClick()}>
159
+ {#if a.icon}{@render a.icon()}{:else}<span class="sv-field__action-txt">{a.label}</span>{/if}
160
+ </button>
161
+ {/each}
162
+ {/if}
163
+ {#if clearable && showClear && !disabled && !readonly}
164
+ <button class="sv-field__clear" type="button" tabindex="-1" aria-label={clearLabel} onclick={() => onclear?.()}>&times;</button>
165
+ {/if}
166
+ </div>
167
+ {:else}
168
+ {@render children()}
169
+ {/if}
170
+ {#if error}
171
+ <span class="sv-field__error" id={editorErrorId(id)} role="alert">{error}</span>
172
+ {:else if hint}
173
+ <span class="sv-field__hint" id={editorHintId(id)}>{hint}</span>
174
+ {/if}
175
+ </div>
176
+
177
+ <style>
178
+ .sv-field {
179
+ display: inline-flex;
180
+ flex-direction: column;
181
+ gap: 3px;
182
+ text-align: start;
183
+ }
184
+ .sv-field--block { display: flex; width: 100%; }
185
+ .sv-field__labelrow { display: inline-flex; align-items: center; gap: 6px; }
186
+ .sv-field__label {
187
+ font-size: 12.5px;
188
+ font-weight: 550;
189
+ color: var(--sg-fg, #0f172a);
190
+ line-height: 1.3;
191
+ }
192
+ .sv-field__spinner {
193
+ width: 12px; height: 12px; flex: none; border-radius: 50%;
194
+ border: 2px solid color-mix(in srgb, var(--sg-accent, #2563eb) 30%, transparent);
195
+ border-top-color: var(--sg-accent, #2563eb);
196
+ animation: sv-field-spin 0.6s linear infinite;
197
+ }
198
+ @keyframes sv-field-spin { to { transform: rotate(360deg); } }
199
+ @media (prefers-reduced-motion: reduce) { .sv-field__spinner { animation: none; } }
200
+ .sv-field__req { color: var(--sg-danger, #dc2626); margin-inline-start: 2px; }
201
+ .sv-field__hint {
202
+ font-size: 11.5px;
203
+ color: var(--sg-muted, #64748b);
204
+ line-height: 1.35;
205
+ }
206
+ .sv-field__error {
207
+ font-size: 11.5px;
208
+ font-weight: 500;
209
+ color: var(--sg-danger, #dc2626);
210
+ line-height: 1.35;
211
+ }
212
+
213
+ /* ---- Framed mode: the shared control box (opt-in via `frame`) ---- */
214
+ .sv-field__control {
215
+ --_accent: var(--sg-accent, #2563eb);
216
+ display: flex; align-items: center; width: 220px;
217
+ background: var(--sg-input-bg, #fff); color: var(--sg-fg, #0f172a);
218
+ border: 1px solid var(--sg-input-border, var(--sg-border, #cbd5e1));
219
+ border-radius: var(--sg-radius, 8px);
220
+ }
221
+ .sv-field--block .sv-field__control { width: 100%; }
222
+ .sv-field__control:focus-within {
223
+ border-color: var(--_accent);
224
+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--_accent) 22%, transparent);
225
+ }
226
+ .sv-field__control.is-invalid { border-color: var(--sg-danger, #dc2626); }
227
+ .sv-field__control.is-invalid:focus-within {
228
+ box-shadow: 0 0 0 2px color-mix(in srgb, var(--sg-danger, #dc2626) 22%, transparent);
229
+ }
230
+ .sv-field__control.is-disabled { opacity: 0.6; }
231
+ .sv-field__control.is-readonly { background: var(--sg-muted-bg, color-mix(in srgb, var(--sg-fg, #0f172a) 4%, var(--sg-input-bg, #fff))); }
232
+
233
+ /* ---- Floating label ---- */
234
+ .sv-field--floating .sv-field__control { position: relative; }
235
+ .sv-field__float-label {
236
+ position: absolute; inset-inline-start: 11px; top: 50%; transform: translateY(-50%);
237
+ font-size: 13px; color: var(--sg-muted, #64748b); pointer-events: none;
238
+ background: var(--sg-input-bg, #fff); padding: 0 4px; max-width: calc(100% - 24px);
239
+ white-space: nowrap; overflow: hidden; text-overflow: ellipsis; z-index: 1;
240
+ transition: top 0.14s ease, font-size 0.14s ease, color 0.14s ease;
241
+ }
242
+ .sv-field__control:focus-within .sv-field__float-label,
243
+ .sv-field__control.is-filled .sv-field__float-label {
244
+ top: 0; font-size: 10.5px; color: var(--_accent, var(--sg-accent, #2563eb));
245
+ }
246
+ .sv-field__control.is-invalid .sv-field__float-label { color: var(--sg-danger, #dc2626); }
247
+ @media (prefers-reduced-motion: reduce) { .sv-field__float-label { transition: none; } }
248
+
249
+ .sv-field__slot { display: flex; flex: 1; min-width: 0; }
250
+ /* Bare form controls passed as children inherit borderless chrome so editors
251
+ no longer re-implement the box. Scoped to the framed control only. */
252
+ .sv-field__slot :global(input),
253
+ .sv-field__slot :global(textarea),
254
+ .sv-field__slot :global(select) {
255
+ flex: 1; min-width: 0; width: 100%;
256
+ border: 0; background: none; outline: none;
257
+ color: inherit; font: inherit; padding: 0 10px;
258
+ }
259
+
260
+ .sv-field__adorn { display: inline-flex; align-items: center; color: var(--sg-muted, #64748b); }
261
+ .sv-field__adorn--lead { padding-inline-start: 10px; }
262
+ .sv-field__adorn--trail { padding-inline-end: 10px; }
263
+ .sv-field__affix { display: inline-flex; align-items: center; color: var(--sg-muted, #64748b); white-space: nowrap; }
264
+ .sv-field__affix--pre { padding-inline-start: 10px; }
265
+ .sv-field__affix--suf { padding-inline-end: 10px; }
266
+ /* When an affix/adornment sits next to the control, drop the control's own
267
+ edge padding so text hugs the affix. */
268
+ .sv-field__adorn--lead + .sv-field__slot :global(input),
269
+ .sv-field__affix--pre + .sv-field__slot :global(input) { padding-inline-start: 6px; }
270
+
271
+ .sv-field__clear {
272
+ display: grid; place-items: center; width: 28px; align-self: stretch;
273
+ background: none; border: 0; color: var(--sg-muted, #64748b); cursor: pointer;
274
+ font-size: 17px; line-height: 1;
275
+ }
276
+ .sv-field__clear:hover { color: var(--sg-fg, #0f172a); }
277
+ .sv-field__action {
278
+ display: inline-grid; place-items: center; align-self: center; flex: none;
279
+ min-width: 24px; height: 24px; margin-inline-end: 3px; padding: 0 5px;
280
+ background: none; border: 0; border-radius: 5px; color: var(--sg-muted, #64748b);
281
+ cursor: pointer; font: inherit; font-size: 12px;
282
+ }
283
+ .sv-field__action:hover:not([disabled]) { background: var(--sg-row-hover-bg, #f1f5f9); color: var(--sg-accent, #2563eb); }
284
+ .sv-field__action[disabled] { opacity: 0.5; cursor: default; }
285
+ .sv-field__action-txt { font-weight: 600; white-space: nowrap; }
286
+
287
+ .sv-field--sm .sv-field__control,
288
+ .sv-field__control.sv-field--sm { height: 28px; font-size: 12px; }
289
+ .sv-field--md .sv-field__control,
290
+ .sv-field__control.sv-field--md { height: 34px; font-size: 13px; }
291
+ .sv-field--lg .sv-field__control,
292
+ .sv-field__control.sv-field--lg { height: 40px; font-size: 15px; }
293
+ </style>