@khsura/sui 1.19.0 → 1.21.0

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 (180) hide show
  1. package/@types/components/avatar/index.d.ts +2 -0
  2. package/@types/components/avatar/sAvatar.vue.d.ts +13 -0
  3. package/@types/components/avatar/sAvatarGroup.vue.d.ts +16 -0
  4. package/@types/components/cards/sCardText.vue.d.ts +2 -2
  5. package/@types/components/datePicker/sDatePickerSwitch.vue.d.ts +2 -0
  6. package/@types/components/form/index.d.ts +2 -0
  7. package/@types/components/form/radio/sRadio.vue.d.ts +3 -0
  8. package/@types/components/form/sFormRow.vue.d.ts +18 -0
  9. package/@types/components/form/sInput.vue.d.ts +1 -0
  10. package/@types/components/form/sNumberInput.vue.d.ts +29 -0
  11. package/@types/components/form/sSelect.vue.d.ts +10 -3
  12. package/@types/components/index.d.ts +5 -0
  13. package/@types/components/layout/sNavigationDrawer.vue.d.ts +6 -6
  14. package/@types/components/progress/sProgressCircular.vue.d.ts +1 -0
  15. package/@types/components/progress/sProgressLinear.vue.d.ts +1 -0
  16. package/@types/components/sAutocomplete.vue.d.ts +11 -1
  17. package/@types/components/sEmptyState.vue.d.ts +26 -0
  18. package/@types/components/sFileInput.vue.d.ts +35 -0
  19. package/@types/components/sPagination.vue.d.ts +21 -0
  20. package/@types/components/sSkeletonLoader.vue.d.ts +19 -0
  21. package/@types/components/slideGroup/sSlideGroup.vue.d.ts +4 -1
  22. package/@types/components/table/sTable.vue.d.ts +2 -0
  23. package/@types/components/tabs/sTabs.vue.d.ts +2 -2
  24. package/@types/components/toggleButtonGroup/sToggleButtonGroup.vue.d.ts +2 -0
  25. package/@types/configs/app.d.ts +4 -0
  26. package/@types/configs/fileInput.d.ts +5 -0
  27. package/@types/configs/i18n.d.ts +3 -0
  28. package/@types/configs/index.d.ts +2 -0
  29. package/@types/configs/provider.d.ts +2 -0
  30. package/@types/configs/skeletonLoader.d.ts +57 -0
  31. package/@types/constants/avatar.d.ts +3 -0
  32. package/@types/constants/color.d.ts +15 -0
  33. package/@types/constants/cssVariables.d.ts +4 -0
  34. package/@types/constants/datePicker.d.ts +7 -0
  35. package/@types/constants/fileInput.d.ts +31 -0
  36. package/@types/constants/i18n.d.ts +3 -0
  37. package/@types/constants/index.d.ts +8 -0
  38. package/@types/constants/keyboard.d.ts +12 -0
  39. package/@types/constants/layout.d.ts +2 -0
  40. package/@types/constants/listbox.d.ts +1 -0
  41. package/@types/constants/numberInput.d.ts +22 -0
  42. package/@types/constants/overlay.d.ts +5 -0
  43. package/@types/constants/pagination.d.ts +20 -0
  44. package/@types/constants/skeletonLoader.d.ts +33 -0
  45. package/@types/constants/tabs.d.ts +10 -0
  46. package/@types/definitions/props/core/propsLink.d.ts +2 -2
  47. package/@types/definitions/props/index.d.ts +7 -0
  48. package/@types/definitions/props/propsAutocomplete.d.ts +8 -0
  49. package/@types/definitions/props/propsAvatar.d.ts +13 -0
  50. package/@types/definitions/props/propsAvatarGroup.d.ts +8 -0
  51. package/@types/definitions/props/propsEmptyState.d.ts +17 -0
  52. package/@types/definitions/props/propsFileInput.d.ts +41 -0
  53. package/@types/definitions/props/propsInput.d.ts +1 -0
  54. package/@types/definitions/props/propsLink.d.ts +2 -2
  55. package/@types/definitions/props/propsNumberInput.d.ts +46 -0
  56. package/@types/definitions/props/propsPagination.d.ts +32 -0
  57. package/@types/definitions/props/propsProgressCircular.d.ts +2 -0
  58. package/@types/definitions/props/propsProgressLinear.d.ts +2 -0
  59. package/@types/definitions/props/propsRow.d.ts +1 -0
  60. package/@types/definitions/props/propsSelect.d.ts +6 -0
  61. package/@types/definitions/props/propsSkeletonLoader.d.ts +18 -0
  62. package/@types/definitions/props/propsSlideGroup.d.ts +4 -0
  63. package/@types/definitions/props/propsTable.d.ts +1 -0
  64. package/@types/definitions/props/propsTabs.d.ts +4 -0
  65. package/@types/definitions/props/propsTextarea.d.ts +3 -0
  66. package/@types/helpers/colorHelpers.d.ts +1 -1
  67. package/@types/helpers/createAppStore.d.ts +4 -0
  68. package/@types/helpers/fileInputRules.d.ts +18 -0
  69. package/@types/helpers/index.d.ts +1 -0
  70. package/@types/lib/color.d.ts +21 -2
  71. package/@types/lib/escapeHtml.d.ts +2 -0
  72. package/@types/lib/flattenVNodes.d.ts +2 -0
  73. package/@types/lib/index.d.ts +7 -0
  74. package/@types/lib/linkLocation.d.ts +9 -0
  75. package/@types/lib/numberInput.d.ts +23 -0
  76. package/@types/lib/overlayPlacement.d.ts +11 -0
  77. package/@types/lib/revealInScroller.d.ts +25 -0
  78. package/@types/lib/safeArea.d.ts +3 -0
  79. package/@types/playwright.visual.config.d.ts +3 -0
  80. package/@types/services/appBarService.d.ts +14 -0
  81. package/@types/services/backgroundScrollService.d.ts +8 -2
  82. package/@types/services/core/layoutCoreService.d.ts +4 -0
  83. package/@types/services/datePicker/datePickerItemDateService.d.ts +1 -0
  84. package/@types/services/dialogService.d.ts +4 -8
  85. package/@types/services/fieldLayoutService.d.ts +19 -0
  86. package/@types/services/formInputService.d.ts +6 -0
  87. package/@types/services/index.d.ts +9 -0
  88. package/@types/services/layoutProviderService.d.ts +6 -0
  89. package/@types/services/layoutService.d.ts +4 -0
  90. package/@types/services/linkService.d.ts +11 -1
  91. package/@types/services/listboxNavigationService.d.ts +20 -0
  92. package/@types/services/menuService.d.ts +2 -0
  93. package/@types/services/overlayFocusService.d.ts +10 -0
  94. package/@types/services/paginationService.d.ts +39 -0
  95. package/@types/services/routerLinkService.d.ts +19 -0
  96. package/@types/services/scrollableFocusService.d.ts +10 -0
  97. package/@types/services/skeletonLoaderService.d.ts +22 -0
  98. package/@types/services/surfaceTextColorService.d.ts +8 -0
  99. package/@types/services/tabsService.d.ts +14 -0
  100. package/@types/store/index.d.ts +1 -0
  101. package/@types/store/scrollLockStore.d.ts +1 -0
  102. package/@types/tests/visual/constants/a11yAudit.d.ts +4 -0
  103. package/@types/tests/visual/constants/index.d.ts +4 -0
  104. package/@types/tests/visual/constants/resizeScroll.d.ts +10 -0
  105. package/@types/tests/visual/constants/storyRender.d.ts +5 -0
  106. package/@types/tests/visual/constants/visualMatrix.d.ts +20 -0
  107. package/@types/tests/visual/schemas/index.d.ts +1 -0
  108. package/@types/tests/visual/schemas/storyIndex.d.ts +17 -0
  109. package/@types/tests/visual/types/a11yAudit.d.ts +2 -0
  110. package/@types/tests/visual/types/index.d.ts +2 -0
  111. package/@types/tests/visual/types/visualStory.d.ts +8 -0
  112. package/@types/types/app.d.ts +2 -0
  113. package/@types/types/breadcrumbs.d.ts +2 -2
  114. package/@types/types/emits.d.ts +12 -0
  115. package/@types/types/fileInput.d.ts +28 -0
  116. package/@types/types/index.d.ts +6 -0
  117. package/@types/types/link.d.ts +20 -0
  118. package/@types/types/menu.d.ts +17 -0
  119. package/@types/types/numberInput.d.ts +12 -0
  120. package/@types/types/pagination.d.ts +17 -0
  121. package/@types/types/safeArea.d.ts +1 -0
  122. package/@types/types/skeletonLoader.d.ts +16 -0
  123. package/@types/vite.config.d.ts +1 -0
  124. package/README.md +12 -0
  125. package/dist/base.css.map +1 -1
  126. package/dist/s-ui.css +1 -1
  127. package/dist/s-ui.js +4792 -3038
  128. package/dist/s-ui.umd.cjs +1 -1
  129. package/dist/styles/components/avatar/_variables.scss +17 -0
  130. package/dist/styles/components/avatar/index.scss +1 -0
  131. package/dist/styles/components/button/mixins.scss +5 -0
  132. package/dist/styles/components/form/_variables.scss +11 -0
  133. package/dist/styles/components/form/index.scss +1 -0
  134. package/dist/styles/components/index.scss +2 -0
  135. package/dist/styles/mixins/_app.scss +7 -0
  136. package/dist/styles/tools/_safeArea.scss +8 -0
  137. package/dist/styles/tools/index.scss +1 -0
  138. package/dist/sui-api.json +1295 -212
  139. package/package.json +15 -4
  140. package/sui-plugin/.claude-plugin/plugin.json +1 -1
  141. package/sui-plugin/skills/sui-component/SKILL.md +21 -6
  142. package/sui-plugin/skills/sui-component/references/autocomplete.md +54 -46
  143. package/sui-plugin/skills/sui-component/references/avatar-group.md +66 -0
  144. package/sui-plugin/skills/sui-component/references/avatar.md +76 -0
  145. package/sui-plugin/skills/sui-component/references/badge.md +4 -4
  146. package/sui-plugin/skills/sui-component/references/breadcrumbs.md +3 -2
  147. package/sui-plugin/skills/sui-component/references/button.md +13 -13
  148. package/sui-plugin/skills/sui-component/references/calendar.md +1 -1
  149. package/sui-plugin/skills/sui-component/references/cards.md +12 -12
  150. package/sui-plugin/skills/sui-component/references/carousel.md +9 -9
  151. package/sui-plugin/skills/sui-component/references/chip.md +1 -1
  152. package/sui-plugin/skills/sui-component/references/date-picker.md +14 -13
  153. package/sui-plugin/skills/sui-component/references/dialog.md +11 -10
  154. package/sui-plugin/skills/sui-component/references/droppable.md +8 -8
  155. package/sui-plugin/skills/sui-component/references/empty-state.md +104 -0
  156. package/sui-plugin/skills/sui-component/references/expansion-panels.md +1 -1
  157. package/sui-plugin/skills/sui-component/references/file-input.md +106 -0
  158. package/sui-plugin/skills/sui-component/references/form.md +155 -105
  159. package/sui-plugin/skills/sui-component/references/image.md +11 -10
  160. package/sui-plugin/skills/sui-component/references/layout.md +53 -49
  161. package/sui-plugin/skills/sui-component/references/list.md +6 -3
  162. package/sui-plugin/skills/sui-component/references/menu.md +12 -9
  163. package/sui-plugin/skills/sui-component/references/number-input.md +102 -0
  164. package/sui-plugin/skills/sui-component/references/pagination.md +83 -0
  165. package/sui-plugin/skills/sui-component/references/progress.md +20 -18
  166. package/sui-plugin/skills/sui-component/references/sheet.md +8 -8
  167. package/sui-plugin/skills/sui-component/references/skeleton-loader.md +75 -0
  168. package/sui-plugin/skills/sui-component/references/slide-group.md +14 -12
  169. package/sui-plugin/skills/sui-component/references/snackbar.md +7 -5
  170. package/sui-plugin/skills/sui-component/references/split-view.md +2 -2
  171. package/sui-plugin/skills/sui-component/references/table.md +10 -3
  172. package/sui-plugin/skills/sui-component/references/tabs.md +19 -13
  173. package/sui-plugin/skills/sui-component/references/toggle-button-group.md +5 -4
  174. package/sui-plugin/skills/sui-component/references/toolbar.md +5 -5
  175. package/sui-plugin/skills/sui-component/references/tooltip.md +10 -9
  176. package/sui-plugin/skills/sui-component/references/window.md +6 -1
  177. package/sui-plugin/skills/sui-form/SKILL.md +25 -17
  178. package/sui-plugin/skills/sui-getting-started/SKILL.md +32 -7
  179. package/sui-plugin/skills/sui-layout/SKILL.md +3 -1
  180. package/sui-plugin/skills/sui-utilities/docs/classes.md +1 -1
@@ -18,7 +18,7 @@ Shared form-input props (`SInput`, `STextarea`, `SSelect`, `SCheckbox`, `SRadioG
18
18
  | `rules` | `FormInputModelValueRule[]` | `undefined` | `(value) => true \| string` — a string is the error message |
19
19
  | `id` | `string` | auto/`undefined` | Element id |
20
20
  | `disabled` / `readonly` | `boolean \| null` | `undefined` | Disabled inputs show no errors |
21
- | `hideDetails` | `boolean` | `undefined` | Hide label + error area |
21
+ | `hideDetails` | `boolean` | `undefined` | Hide the label above the field + error area (`SCheckbox` / `SRadio` keep their own label) |
22
22
  | `hideError` | `boolean` | `undefined` | Hide only the error message |
23
23
  | `error` / `dirty` | `boolean` | `undefined` | Typed; `dirty` only syncs the internal flag — neither triggers validation |
24
24
 
@@ -33,7 +33,9 @@ Shared events: `update:error` (`boolean`), `update:errors` (`string[]`), `update
33
33
 
34
34
  ## SForm
35
35
 
36
- Renders a native `<form>` and collects child inputs.
36
+ Renders a native `<form novalidate>` and collects child inputs. Native browser validation is off, so `type="email"` / `required` never show the browser bubble over the SUI error; validate with `rules`. `:novalidate="false"` turns it back on. Before 1.20.0 `SForm` did not add `novalidate`; add it yourself there.
37
+
38
+ Every validated field reserves one error line under itself. For an action row (field + button: search bar, filter bar) use `SFormRow` (below), never a plain flex `<div>`, where the button lines up with the label. Field labels are inset 16px to line up with the value text inside the field.
37
39
 
38
40
  | Model | Type | Description |
39
41
  |-------|------|-------------|
@@ -77,6 +79,42 @@ Exposed: `validate(): boolean` — **returns `true` when there ARE errors**; `re
77
79
 
78
80
  ---
79
81
 
82
+ ## SFormRow
83
+
84
+ *Since 1.20.0.* A wrapping row of text fields (`SInput`, `SNumberInput` since 1.21.0, `SSelect`, `SDatePickerInput`, `SAutocomplete`, `STextarea`) and their buttons. Each button's top and bottom match the field box: with or without a label, while an error shows, and when the row wraps at 375px. No props; slot `default`.
85
+
86
+ <!-- generated:api:start SFormRow -->
87
+ <!-- Generated from sui-api.json by `yarn sync:skills` (packages/app). Do not edit by hand. -->
88
+
89
+ **SFormRow props**
90
+
91
+ None.
92
+
93
+ **SFormRow slots**
94
+
95
+ | Slot | Slot props | Description |
96
+ | --- | --- | --- |
97
+ | `default` | `any` | The fields and buttons of the row. |
98
+
99
+ **SFormRow events**
100
+
101
+ None.
102
+
103
+ <!-- generated:api:end SFormRow -->
104
+
105
+ ```vue
106
+ <SFormRow>
107
+ <SDatePickerInput v-model="from" label="From" />
108
+ <SSelect v-model="status" label="Status" :items="statuses" />
109
+ <SButton color="primary" @click="apply">Apply</SButton>
110
+ </SFormRow>
111
+ ```
112
+
113
+ - `SInput` / `STextarea` / `SAutocomplete` (and `grow` `SSelect`, `block` `SDatePickerInput`) share the free width; `SSelect` / `SDatePickerInput` otherwise keep their own width; buttons keep theirs; the row wraps when they don't fit. Each field keeps its error line; buttons reserve the same space, so wrapped lines and the next row keep their gap.
114
+ - Don't mix a `simple` field into it (its label is shorter). Before 1.20.0 there is no `SFormRow`: put `hide-details` on the field in a flex row.
115
+
116
+ ---
117
+
80
118
  ## SInput
81
119
 
82
120
  <!-- generated:api:start SInput -->
@@ -88,8 +126,9 @@ Exposed: `validate(): boolean` — **returns `true` when there ARE errors**; `re
88
126
  | --- | --- | --- | --- | --- |
89
127
  | `allowDecimal` | `boolean \| null` | — | no | — |
90
128
  | `appendOuter` | `string \| null` | — | no | — |
129
+ | `ariaLabel` | `string` | — | no | — |
91
130
  | `ariaLabelledby` | `string` | — | no | — |
92
- | `autocapitalize` | `"on" \| "off" \| null` | — | no | `off`, `on` |
131
+ | `autocapitalize` | `"off" \| "on" \| null` | — | no | `off`, `on` |
93
132
  | `autocomplete` | `string \| null` | — | no | — |
94
133
  | `autofocus` | `boolean \| null` | — | no | — |
95
134
  | `dense` | `boolean` | — | no | — |
@@ -103,10 +142,10 @@ Exposed: `validate(): boolean` — **returns `true` when there ARE errors**; `re
103
142
  | `inputmode` | `InputModeTypeText \| null` | — | no | `decimal`, `email`, `none`, `numeric`, `search`, `tel`, `text`, `url` |
104
143
  | `isPasteDisabled` | `boolean` | — | no | — |
105
144
  | `label` | `string \| null` | — | no | — |
106
- | `max` | `string \| number \| null` | — | no | — |
107
- | `maxlength` | `string \| number \| null` | — | no | — |
108
- | `min` | `string \| number \| null` | — | no | — |
109
- | `minlength` | `string \| number \| null` | — | no | — |
145
+ | `max` | `number \| string \| null` | — | no | — |
146
+ | `maxlength` | `number \| string \| null` | — | no | — |
147
+ | `min` | `number \| string \| null` | — | no | — |
148
+ | `minlength` | `number \| string \| null` | — | no | — |
110
149
  | `modelValue` | `T \| null` | — | no | — |
111
150
  | `name` | `string` | — | no | — |
112
151
  | `pattern` | `string \| null` | — | no | — |
@@ -171,44 +210,46 @@ Model: `v-model` — `string | number | null`. Slots: `suffix`, `appendOuter` (n
171
210
 
172
211
  ## STextarea
173
212
 
174
- Props: `label`, `placeholder`, `rows` (default `2`), `cols` (default `20`), **`autogrow`** (not `autoGrow`), `resize` (default off → `resize: none`), `simple`, `dense`, `tile`, `minlength`, `maxlength`, `name`, `autocomplete`, `autocapitalize`, `autofocus`, `spellcheck`, `ariaLabelledby`, `inputBackground`, `placeholderBackground`, `size` + shared. Model: `string` (`null` → `''`). Events: `change`, `input`, `blur`, `keydown` + shared. No slots. Exposed: `validate()`.
213
+ Props: `label`, `placeholder`, `rows` (default `2`), `cols` (default `20`), **`autogrow`** (not `autoGrow`), `resize` (default off → `resize: none`), **`counter`** (character count at the right of the error line; `12 / 200` with `maxlength`), `simple`, `dense`, `tile`, `minlength`, `maxlength`, `name`, `autocomplete`, `autocapitalize`, `autofocus`, `spellcheck`, `ariaLabelledby`, `inputBackground`, `placeholderBackground`, `size` + shared. Model: `string` (`null` → `''`). Events: `change`, `input`, `blur`, `keydown` + shared. No slots. Exposed: `validate()`.
175
214
 
176
215
  <!-- generated:api:start STextarea -->
177
216
  <!-- Generated from sui-api.json by `yarn sync:skills` (packages/app). Do not edit by hand. -->
178
217
 
179
218
  **STextarea props**
180
219
 
181
- | Prop | Type | Default | Required | Values |
182
- | --- | --- | --- | --- | --- |
183
- | `ariaLabelledby` | `string` | — | no | — |
184
- | `autocapitalize` | `"on" \| "off"` | — | no | `off`, `on` |
185
- | `autocomplete` | `string` | — | no | — |
186
- | `autofocus` | `boolean` | — | no | — |
187
- | `autogrow` | `boolean` | — | no | — |
188
- | `cols` | `number` | `20` | no | — |
189
- | `dense` | `boolean` | — | no | — |
190
- | `dirty` | `boolean` | — | no | — |
191
- | `disabled` | `boolean \| null` | — | no | — |
192
- | `error` | `boolean` | — | no | — |
193
- | `hideDetails` | `boolean` | — | no | — |
194
- | `hideError` | `boolean` | — | no | — |
195
- | `id` | `string` | — | no | — |
196
- | `inputBackground` | `string` | — | no | — |
197
- | `label` | `string` | — | no | — |
198
- | `maxlength` | `string \| number` | — | no | — |
199
- | `minlength` | `string \| number` | — | no | — |
200
- | `modelValue` | `string` | `""` | no | — |
201
- | `name` | `string` | — | no | — |
202
- | `placeholder` | `string` | — | no | — |
203
- | `placeholderBackground` | `string` | — | no | — |
204
- | `readonly` | `boolean \| null` | — | no | — |
205
- | `resize` | `boolean` | — | no | — |
206
- | `rows` | `number` | `2` | no | — |
207
- | `rules` | `FormInputModelValueRule[]` | — | no | — |
208
- | `simple` | `boolean` | — | no | — |
209
- | `size` | `SizePropertyType` | — | no | `default`, `extra`, `large`, `mini`, `small` |
210
- | `spellcheck` | `boolean` | — | no | — |
211
- | `tile` | `boolean` | — | no | — |
220
+ | Prop | Type | Default | Required | Values | Description |
221
+ | --- | --- | --- | --- | --- | --- |
222
+ | `ariaLabel` | `string` | — | no | — | — |
223
+ | `ariaLabelledby` | `string` | — | no | — | — |
224
+ | `autocapitalize` | `"off" \| "on"` | — | no | `off`, `on` | — |
225
+ | `autocomplete` | `string` | — | no | — | — |
226
+ | `autofocus` | `boolean` | — | no | — | — |
227
+ | `autogrow` | `boolean` | — | no | — | — |
228
+ | `cols` | `number` | `20` | no | — | — |
229
+ | `counter` | `boolean` | — | no | — | Shows the character count (`12 / 200` with `maxlength`) at the right of the error line, right under the field. |
230
+ | `dense` | `boolean` | — | no | — | — |
231
+ | `dirty` | `boolean` | — | no | — | — |
232
+ | `disabled` | `boolean \| null` | — | no | — | — |
233
+ | `error` | `boolean` | — | no | — | — |
234
+ | `hideDetails` | `boolean` | — | no | — | — |
235
+ | `hideError` | `boolean` | — | no | — | — |
236
+ | `id` | `string` | — | no | — | — |
237
+ | `inputBackground` | `string` | — | no | — | — |
238
+ | `label` | `string` | — | no | — | — |
239
+ | `maxlength` | `number \| string` | — | no | — | — |
240
+ | `minlength` | `number \| string` | — | no | — | — |
241
+ | `modelValue` | `string` | `""` | no | — | — |
242
+ | `name` | `string` | — | no | — | — |
243
+ | `placeholder` | `string` | — | no | — | — |
244
+ | `placeholderBackground` | `string` | — | no | — | — |
245
+ | `readonly` | `boolean \| null` | — | no | — | — |
246
+ | `resize` | `boolean` | — | no | — | — |
247
+ | `rows` | `number` | `2` | no | — | — |
248
+ | `rules` | `FormInputModelValueRule[]` | — | no | — | — |
249
+ | `simple` | `boolean` | — | no | — | — |
250
+ | `size` | `SizePropertyType` | — | no | `default`, `extra`, `large`, `mini`, `small` | — |
251
+ | `spellcheck` | `boolean` | — | no | — | — |
252
+ | `tile` | `boolean` | — | no | — | — |
212
253
 
213
254
  **STextarea slots**
214
255
 
@@ -241,56 +282,60 @@ Single-value dropdown (no `multiple`, `chips`, `clearable` or `placeholder` —
241
282
 
242
283
  **SSelect props**
243
284
 
244
- | Prop | Type | Default | Required | Values |
245
- | --- | --- | --- | --- | --- |
246
- | `activator` | `string \| HTMLElement \| ComponentPublicInstance \| null` | — | no | — |
247
- | `borderRadius` | `` number \| "tile" \| "rounded" \| `${number}em` \| `${number}px` \| `${number}rem` \| `${number}%` \| `${number}vh` \| `${number}vw` \| null `` | — | no | — |
248
- | `closeOnClick` | `boolean` | — | no | — |
249
- | `closeOnContentClick` | `boolean` | — | no | — |
250
- | `closeOnScroll` | `boolean` | — | no | — |
251
- | `color` | `string` | — | no | — |
252
- | `colorThreshold` | `number` | — | no | — |
253
- | `contentClass` | `string \| string[] \| Record<string, boolean>` | — | no | — |
254
- | `contentStyle` | `StyleValue` | — | no | — |
255
- | `dense` | `boolean` | — | no | — |
256
- | `dirty` | `boolean` | — | no | — |
257
- | `disabled` | `boolean \| null` | — | no | — |
258
- | `divided` | `boolean` | — | no | — |
259
- | `error` | `boolean` | — | no | — |
260
- | `grow` | `boolean` | — | no | — |
261
- | `height` | `string \| number \| null` | — | no | — |
262
- | `hideDetails` | `boolean` | — | no | — |
263
- | `hideError` | `boolean` | — | no | — |
264
- | `id` | `string` | — | no | — |
265
- | `items` | `(string \| SelectItem \| null \| undefined)[]` | — | no | — |
266
- | `label` | `string \| null` | — | no | — |
267
- | `location` | `LocationRaw` | — | no | — |
268
- | `maxHeight` | `string \| number \| null` | — | no | — |
269
- | `maxWidth` | `string \| number \| null` | — | no | — |
270
- | `menu` | `boolean` | — | no | — |
271
- | `minHeight` | `string \| number \| null` | — | no | — |
272
- | `minWidth` | `string \| number \| null` | — | no | — |
273
- | `modelValue` | `T \| null` | — | no | — |
274
- | `name` | `string \| null` | — | no | — |
275
- | `offsetX` | `number \| null` | — | no | — |
276
- | `offsetY` | `number \| null` | — | no | — |
277
- | `outlined` | `boolean \| null` | — | no | — |
278
- | `position` | `Position` | — | no | `absolute`, `fixed`, `relative`, `static`, `sticky` |
279
- | `preventCloseOnClick` | `boolean` | — | no | — |
280
- | `readonly` | `boolean \| null` | — | no | — |
281
- | `rules` | `FormInputModelValueRule[]` | — | no | — |
282
- | `screenPadding` | `number \| null` | — | no | — |
283
- | `text` | `boolean` | — | no | — |
284
- | `theme` | `AppThemeType` | — | no | `dark`, `light` |
285
- | `underlined` | `boolean \| null` | — | no | — |
286
- | `width` | `string \| number \| null` | — | no | — |
285
+ | Prop | Type | Default | Required | Values | Description |
286
+ | --- | --- | --- | --- | --- | --- |
287
+ | `activator` | `string \| ComponentPublicInstance \| HTMLElement \| null` | — | no | — | — |
288
+ | `ariaLabel` | `string \| null` | — | no | — | Accessible name when there is no visible `label` (otherwise the label names the field). |
289
+ | `borderRadius` | `` number \| "rounded" \| "tile" \| `${number}%` \| `${number}em` \| `${number}px` \| `${number}rem` \| `${number}vh` \| `${number}vw` \| null `` | — | no | — | — |
290
+ | `closeOnClick` | `boolean` | — | no | — | — |
291
+ | `closeOnContentClick` | `boolean` | — | no | — | — |
292
+ | `closeOnScroll` | `boolean` | — | no | — | — |
293
+ | `color` | `string` | — | no | — | — |
294
+ | `colorThreshold` | `number` | — | no | — | — |
295
+ | `contentClass` | `string \| Record<string, boolean> \| string[]` | — | no | — | — |
296
+ | `contentStyle` | `StyleValue` | — | no | — | — |
297
+ | `dense` | `boolean` | — | no | — | — |
298
+ | `dirty` | `boolean` | — | no | — | — |
299
+ | `disabled` | `boolean \| null` | — | no | — | — |
300
+ | `divided` | `boolean` | — | no | — | — |
301
+ | `error` | `boolean` | — | no | — | — |
302
+ | `grow` | `boolean` | — | no | — | — |
303
+ | `height` | `number \| string \| null` | — | no | — | — |
304
+ | `hideDetails` | `boolean` | — | no | — | — |
305
+ | `hideError` | `boolean` | — | no | — | — |
306
+ | `id` | `string` | — | no | — | — |
307
+ | `items` | `(string \| SelectItem \| null \| undefined)[]` | — | no | — | — |
308
+ | `label` | `string \| null` | — | no | — | — |
309
+ | `location` | `LocationRaw` | — | no | — | — |
310
+ | `maxHeight` | `number \| string \| null` | — | no | — | — |
311
+ | `maxWidth` | `number \| string \| null` | — | no | — | — |
312
+ | `menu` | `boolean` | — | no | — | — |
313
+ | `minHeight` | `number \| string \| null` | — | no | — | — |
314
+ | `minWidth` | `number \| string \| null` | — | no | — | — |
315
+ | `modelValue` | `T \| null` | — | no | — | — |
316
+ | `name` | `string \| null` | — | no | — | — |
317
+ | `noDataText` | `string` | — | no | — | Message shown in the open menu when `items` is empty. Without it (and without the `noData` slot) an empty menu stays blank. Put an `SEmptyState` in the `noData` slot for an icon or an action. |
318
+ | `offsetX` | `number \| null` | — | no | — | — |
319
+ | `offsetY` | `number \| null` | — | no | — | — |
320
+ | `outlined` | `boolean \| null` | `true` | no | — | — |
321
+ | `placeholder` | `string \| null` | — | no | — | Text shown in the field while nothing is selected. The label is never repeated inside the field. |
322
+ | `position` | `Position` | — | no | `absolute`, `fixed`, `relative`, `static`, `sticky` | — |
323
+ | `preventCloseOnClick` | `boolean` | — | no | — | — |
324
+ | `readonly` | `boolean \| null` | — | no | — | — |
325
+ | `rules` | `FormInputModelValueRule[]` | — | no | — | — |
326
+ | `screenPadding` | `number \| null` | — | no | — | — |
327
+ | `text` | `boolean` | — | no | — | — |
328
+ | `theme` | `AppThemeType` | — | no | `dark`, `light` | — |
329
+ | `underlined` | `boolean \| null` | — | no | — | — |
330
+ | `width` | `number \| string \| null` | — | no | — | — |
287
331
 
288
332
  **SSelect slots**
289
333
 
290
- | Slot | Slot props |
291
- | --- | --- |
292
- | `activator` | `{ item: SelectItem \| null; value: boolean \| undefined; }` |
293
- | `dropdownIcon` | `{ color: string \| undefined; value: boolean \| undefined; }` |
334
+ | Slot | Slot props | Description |
335
+ | --- | --- | --- |
336
+ | `activator` | `{ item: SelectItem \| null; value: boolean \| undefined; }` | Replaces the selected item's text in the field. |
337
+ | `dropdownIcon` | `{ color: string \| undefined; value: boolean \| undefined; }` | Replaces the chevron icon. |
338
+ | `noData` | `any` | Replaces `noDataText` when `items` is empty, such as an `SEmptyState`. |
294
339
 
295
340
  **SSelect events**
296
341
 
@@ -308,11 +353,14 @@ Single-value dropdown (no `multiple`, `chips`, `clearable` or `placeholder` —
308
353
  **SSelect notes**
309
354
 
310
355
  - `items`: Options
311
- - `label`: Label above, **and** the text shown while nothing is selected
356
+ - `label`: Label above the field (never repeated inside it)
357
+ - `placeholder`: Text shown in the field while nothing is selected
358
+ - Width: as wide as the longest option or placeholder, like a native select; a long selection is clipped with an ellipsis; a long option in the list stays on one line with an ellipsis and its full text in `title`
312
359
  - `name`: Name of a hidden native `<select>`
313
360
  - `dense` / `grow` / `text` / `divided`: Compact / full width / text list style / list dividers
314
361
  - `color`: List color
315
- - `outlined` / `underlined` / `borderRadius`: Activator border
362
+ - `outlined`: default **`true`** (matches `SInput`); `:outlined="false"` for the borderless, shadowed look
363
+ - `underlined` / `borderRadius`: Activator border
316
364
  - `location`, `offsetX`, `offsetY`, …: Dropdown positioning
317
365
 
318
366
  ```ts
@@ -323,7 +371,7 @@ Model: `v-model` — `string | number | null`; `v-model:menu` — open state. Sl
323
371
 
324
372
  ## SCheckbox
325
373
 
326
- Boolean only. Props: `label`, `color` (preset name only), `size` (`'default' | 'large'`), `block`, `bordered` + shared. Model: `boolean`. Events: `change` (`boolean`) + shared. No `value`, `indeterminate` or array/group model.
374
+ Boolean only. Props: `label`, `color` (preset name only), `size` (`'default' | 'large'`), `block`, `bordered` + shared. Model: `boolean`. Events: `change` (`boolean`) + shared. No `value`, `indeterminate` or array/group model. The error line sits under the box; `hideDetails` removes only the error area, never the label.
327
375
 
328
376
  <!-- generated:api:start SCheckbox -->
329
377
  <!-- Generated from sui-api.json by `yarn sync:skills` (packages/app). Do not edit by hand. -->
@@ -367,7 +415,7 @@ None.
367
415
 
368
416
  ## SRadioGroup / SRadio
369
417
 
370
- Options are **`SRadio` children** — there is no `items` prop.
418
+ Options are **`SRadio` children** — there is no `items` prop. Long option labels wrap; the group's `hideDetails` removes only its error area (labels stay). Options have no background (before 1.20.0 a group with no value showed grey chips behind its options).
371
419
 
372
420
  `SRadioGroup` props: `name`, `column`, `grow`, `color` (preset name), `mandatory`, `outlined` / `underlined` / `borderRadius` + shared. Model: `string | number | boolean`. Events: `change` + shared.
373
421
 
@@ -380,7 +428,7 @@ Options are **`SRadio` children** — there is no `items` prop.
380
428
 
381
429
  | Prop | Type | Default | Required | Values |
382
430
  | --- | --- | --- | --- | --- |
383
- | `borderRadius` | `` number \| "tile" \| "rounded" \| `${number}em` \| `${number}px` \| `${number}rem` \| `${number}%` \| `${number}vh` \| `${number}vw` \| null `` | — | no | — |
431
+ | `borderRadius` | `` number \| "rounded" \| "tile" \| `${number}%` \| `${number}em` \| `${number}px` \| `${number}rem` \| `${number}vh` \| `${number}vw` \| null `` | — | no | — |
384
432
  | `color` | `string \| null` | — | no | — |
385
433
  | `column` | `boolean \| null` | — | no | — |
386
434
  | `continuous` | `boolean` | — | no | — |
@@ -423,20 +471,21 @@ Options are **`SRadio` children** — there is no `items` prop.
423
471
 
424
472
  **SRadio props**
425
473
 
426
- | Prop | Type | Default | Required | Values |
427
- | --- | --- | --- | --- | --- |
428
- | `activeClass` | `string \| null` | — | no | — |
429
- | `borderRadius` | `` number \| "tile" \| "rounded" \| `${number}em` \| `${number}px` \| `${number}rem` \| `${number}%` \| `${number}vh` \| `${number}vw` \| null `` | — | no | — |
430
- | `disabled` | `boolean \| null` | — | no | — |
431
- | `id` | `string` | — | no | — |
432
- | `label` | `string \| null` | — | no | — |
433
- | `name` | `string \| null` | — | no | — |
434
- | `outlined` | `boolean \| null` | — | no | — |
435
- | `readonly` | `boolean \| null` | — | no | — |
436
- | `selected` | `boolean` | — | no | — |
437
- | `type` | `ButtonTypeType` | — | no | `button`, `reset`, `submit` |
438
- | `underlined` | `boolean \| null` | — | no | — |
439
- | `value` | `string \| number \| boolean` | — | no | — |
474
+ | Prop | Type | Default | Required | Values | Description |
475
+ | --- | --- | --- | --- | --- | --- |
476
+ | `activeClass` | `string \| null` | — | no | — | — |
477
+ | `ariaLabel` | `string \| null` | — | no | — | Accessible name for a radio without a visible `label` (for example an icon-only option). |
478
+ | `borderRadius` | `` number \| "rounded" \| "tile" \| `${number}%` \| `${number}em` \| `${number}px` \| `${number}rem` \| `${number}vh` \| `${number}vw` \| null `` | — | no | — | — |
479
+ | `disabled` | `boolean \| null` | — | no | — | — |
480
+ | `id` | `string` | — | no | — | — |
481
+ | `label` | `string \| null` | — | no | — | — |
482
+ | `name` | `string \| null` | — | no | — | — |
483
+ | `outlined` | `boolean \| null` | — | no | — | — |
484
+ | `readonly` | `boolean \| null` | — | no | — | — |
485
+ | `selected` | `boolean` | — | no | — | — |
486
+ | `type` | `ButtonTypeType` | — | no | `button`, `reset`, `submit` | — |
487
+ | `underlined` | `boolean \| null` | — | no | — | — |
488
+ | `value` | `boolean \| number \| string` | — | no | — | — |
440
489
 
441
490
  **SRadio slots**
442
491
 
@@ -573,3 +622,4 @@ const submit = () => {
573
622
 
574
623
  - `SRadioGroup` without `mandatory`: clicking the selected radio clears the value.
575
624
  - `SSelect` validates when its menu opens, so a required error can appear on first open.
625
+ - `SSelect` / `SAutocomplete` / `SDatePickerInput` dropdowns flip or shift to stay 8px inside the viewport — no wrapper, padding or `location` workaround needed for fields at the bottom or right edge.
@@ -15,15 +15,15 @@ Types: `node_modules/@khsura/sui/@types/definitions/props/propsImage.d.ts`
15
15
  | --- | --- | --- | --- | --- |
16
16
  | `alt` | `string \| null` | — | no | — |
17
17
  | `aspectRatio` | `number \| null` | — | no | — |
18
- | `height` | `string \| number \| null` | — | no | — |
18
+ | `height` | `number \| string \| null` | — | no | — |
19
19
  | `lazyLoad` | `LazyLoad \| null` | — | no | — |
20
- | `maxHeight` | `string \| number \| null` | — | no | — |
21
- | `maxWidth` | `string \| number \| null` | — | no | — |
22
- | `minHeight` | `string \| number \| null` | — | no | — |
23
- | `minWidth` | `string \| number \| null` | — | no | — |
24
- | `objectFit` | `"fill" \| "none" \| "contain" \| "cover" \| "scale-down"` | — | no | `contain`, `cover`, `fill`, `none`, `scale-down` |
20
+ | `maxHeight` | `number \| string \| null` | — | no | — |
21
+ | `maxWidth` | `number \| string \| null` | — | no | — |
22
+ | `minHeight` | `number \| string \| null` | — | no | — |
23
+ | `minWidth` | `number \| string \| null` | — | no | — |
24
+ | `objectFit` | `"contain" \| "cover" \| "fill" \| "none" \| "scale-down"` | — | no | `contain`, `cover`, `fill`, `none`, `scale-down` |
25
25
  | `src` | `string \| null` | — | yes | — |
26
- | `width` | `string \| number \| null` | — | no | — |
26
+ | `width` | `number \| string \| null` | — | no | — |
27
27
 
28
28
  **SImage slots**
29
29
 
@@ -57,7 +57,7 @@ None.
57
57
  <!-- 16:9 cover -->
58
58
  <SImage src="/banner.jpg" :aspect-ratio="16/9" object-fit="cover" />
59
59
 
60
- <!-- Square avatar -->
60
+ <!-- Square image (for a user avatar with an initials fallback, use SAvatar) -->
61
61
  <SImage src="/avatar.jpg" :aspect-ratio="1" object-fit="cover" :width="80" />
62
62
 
63
63
  <!-- Overlay -->
@@ -68,9 +68,10 @@ None.
68
68
 
69
69
  ## Gotchas
70
70
 
71
- - The wrapper defaults to `width: 100%; height: 100%`. In a parent with no height, give it `aspect-ratio` or `height`.
71
+ - The wrapper defaults to `width: 100%; height: 100%` (`height: auto` when `aspect-ratio` is set). In a parent with no height, give it `aspect-ratio` or `height`.
72
72
  - Use `object-fit="cover"` with `aspect-ratio` to avoid stretching.
73
- - In a flex column (a card made `display: flex; flex-direction: column` to equalise heights) the `100%` height makes the image shrink, so images in a row end up with different heights. Add `height="auto"` next to `aspect-ratio`, or give the card `height="100%"` instead of making it a flex column.
73
+ - With `aspect-ratio` and no `height`, the wrapper uses `height: auto`, so the ratio sets its height even in a flex-column card (an equal-height grid). Older versions kept `height: 100%` there and the images in one row got different heights; on those, add `height="auto"`.
74
+ - Without a `src` the wrapper shows a neutral placeholder (the app background colour) instead of a blank gap, so a card with a missing image keeps its shape.
74
75
 
75
76
  | ❌ | ✅ |
76
77
  |----|----|