@khsura/sui 0.0.0-stage → 1.19.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 (498) hide show
  1. package/.claude-plugin/marketplace.json +18 -0
  2. package/@types/components/badge/index.d.ts +1 -0
  3. package/@types/components/badge/sBadge.vue.d.ts +18 -0
  4. package/@types/components/badge/sBadgeContent.vue.d.ts +14 -0
  5. package/@types/components/calendar/index.d.ts +1 -0
  6. package/@types/components/calendar/sCalendar.vue.d.ts +52 -0
  7. package/@types/components/calendar/sCalendarMonthly.vue.d.ts +51 -0
  8. package/@types/components/calendar/sCalendarWeekly.vue.d.ts +75 -0
  9. package/@types/components/cards/index.d.ts +5 -0
  10. package/@types/components/cards/sCard.vue.d.ts +14 -0
  11. package/@types/components/cards/sCardActions.vue.d.ts +15 -0
  12. package/@types/components/cards/sCardSubtitle.vue.d.ts +15 -0
  13. package/@types/components/cards/sCardText.vue.d.ts +15 -0
  14. package/@types/components/cards/sCardTitle.vue.d.ts +15 -0
  15. package/@types/components/carousel/index.d.ts +2 -0
  16. package/@types/components/carousel/sCarousel.vue.d.ts +34 -0
  17. package/@types/components/carousel/sCarouselItem.vue.d.ts +14 -0
  18. package/@types/components/datePicker/index.d.ts +2 -0
  19. package/@types/components/datePicker/sDatePicker.vue.d.ts +22 -0
  20. package/@types/components/datePicker/sDatePickerDate.vue.d.ts +12 -0
  21. package/@types/components/datePicker/sDatePickerInput.vue.d.ts +31 -0
  22. package/@types/components/datePicker/sDatePickerMonth.vue.d.ts +12 -0
  23. package/@types/components/datePicker/sDatePickerSwitch.vue.d.ts +15 -0
  24. package/@types/components/datePicker/sDatePickerTitle.vue.d.ts +16 -0
  25. package/@types/components/datePicker/sDatePickerYear.vue.d.ts +12 -0
  26. package/@types/components/expansionPanel/index.d.ts +4 -0
  27. package/@types/components/expansionPanel/sExpansionPanel.vue.d.ts +17 -0
  28. package/@types/components/expansionPanel/sExpansionPanelContent.vue.d.ts +15 -0
  29. package/@types/components/expansionPanel/sExpansionPanelHeader.vue.d.ts +21 -0
  30. package/@types/components/expansionPanel/sExpansionPanels.vue.d.ts +24 -0
  31. package/@types/components/form/common/index.d.ts +1 -0
  32. package/@types/components/form/common/sFormInputError.vue.d.ts +25 -0
  33. package/@types/components/form/index.d.ts +7 -0
  34. package/@types/components/form/radio/index.d.ts +2 -0
  35. package/@types/components/form/radio/sRadio.vue.d.ts +32 -0
  36. package/@types/components/form/radio/sRadioGroup.vue.d.ts +35 -0
  37. package/@types/components/form/sCheckbox.vue.d.ts +22 -0
  38. package/@types/components/form/sForm.vue.d.ts +31 -0
  39. package/@types/components/form/sInput.vue.d.ts +73 -0
  40. package/@types/components/form/sSelect.vue.d.ts +64 -0
  41. package/@types/components/form/sTextarea.vue.d.ts +38 -0
  42. package/@types/components/grids/index.d.ts +4 -0
  43. package/@types/components/grids/sColumn.vue.d.ts +14 -0
  44. package/@types/components/grids/sContainer.vue.d.ts +14 -0
  45. package/@types/components/grids/sRow.vue.d.ts +14 -0
  46. package/@types/components/grids/sSpacer.vue.d.ts +13 -0
  47. package/@types/components/index.d.ts +36 -0
  48. package/@types/components/layout/index.d.ts +8 -0
  49. package/@types/components/layout/sApp.vue.d.ts +15 -0
  50. package/@types/components/layout/sAppBar.vue.d.ts +22 -0
  51. package/@types/components/layout/sAppBarTitle.vue.d.ts +16 -0
  52. package/@types/components/layout/sBottomNavigation.vue.d.ts +24 -0
  53. package/@types/components/layout/sFooter.vue.d.ts +18 -0
  54. package/@types/components/layout/sLayout.vue.d.ts +14 -0
  55. package/@types/components/layout/sMain.vue.d.ts +14 -0
  56. package/@types/components/layout/sNavigationDrawer.vue.d.ts +45 -0
  57. package/@types/components/list/index.d.ts +8 -0
  58. package/@types/components/list/sList.vue.d.ts +14 -0
  59. package/@types/components/list/sListItem.vue.d.ts +18 -0
  60. package/@types/components/list/sListItemAction.vue.d.ts +14 -0
  61. package/@types/components/list/sListItemContent.vue.d.ts +13 -0
  62. package/@types/components/list/sListItemGroup.vue.d.ts +47 -0
  63. package/@types/components/list/sListItemIcon.vue.d.ts +14 -0
  64. package/@types/components/list/sListItemSubtitle.vue.d.ts +13 -0
  65. package/@types/components/list/sListItemTitle.vue.d.ts +13 -0
  66. package/@types/components/progress/index.d.ts +2 -0
  67. package/@types/components/progress/sProgressCircular.vue.d.ts +18 -0
  68. package/@types/components/progress/sProgressLinear.vue.d.ts +17 -0
  69. package/@types/components/sAlert.vue.d.ts +14 -0
  70. package/@types/components/sAutocomplete.vue.d.ts +57 -0
  71. package/@types/components/sBreadcrumbs.vue.d.ts +16 -0
  72. package/@types/components/sButton.vue.d.ts +20 -0
  73. package/@types/components/sChip.vue.d.ts +24 -0
  74. package/@types/components/sDialog.vue.d.ts +33 -0
  75. package/@types/components/sDivider.vue.d.ts +4 -0
  76. package/@types/components/sDroppable.vue.d.ts +28 -0
  77. package/@types/components/sIcon.vue.d.ts +4 -0
  78. package/@types/components/sImage.vue.d.ts +14 -0
  79. package/@types/components/sMenu.vue.d.ts +36 -0
  80. package/@types/components/sOverlay.vue.d.ts +26 -0
  81. package/@types/components/sSheet.vue.d.ts +14 -0
  82. package/@types/components/sSnackbar.vue.d.ts +35 -0
  83. package/@types/components/sSubheader.vue.d.ts +13 -0
  84. package/@types/components/sSwitch.vue.d.ts +23 -0
  85. package/@types/components/sTooltip.vue.d.ts +25 -0
  86. package/@types/components/slideGroup/index.d.ts +2 -0
  87. package/@types/components/slideGroup/sSlideGroup.vue.d.ts +42 -0
  88. package/@types/components/slideGroup/sSlideItem.vue.d.ts +17 -0
  89. package/@types/components/splitViews/index.d.ts +2 -0
  90. package/@types/components/splitViews/sSplitView.vue.d.ts +17 -0
  91. package/@types/components/splitViews/sSplitViewItem.vue.d.ts +13 -0
  92. package/@types/components/stepper/index.d.ts +2 -0
  93. package/@types/components/stepper/sStepper.vue.d.ts +26 -0
  94. package/@types/components/stepper/sStepperStep.vue.d.ts +14 -0
  95. package/@types/components/table/index.d.ts +3 -0
  96. package/@types/components/table/sTable.vue.d.ts +72 -0
  97. package/@types/components/table/sTableBodyCell.vue.d.ts +22 -0
  98. package/@types/components/table/sTableHeadCell.vue.d.ts +24 -0
  99. package/@types/components/table/sTablePagination.vue.d.ts +33 -0
  100. package/@types/components/tabs/index.d.ts +2 -0
  101. package/@types/components/tabs/sTab.vue.d.ts +14 -0
  102. package/@types/components/tabs/sTabs.vue.d.ts +20 -0
  103. package/@types/components/toggleButtonGroup/index.d.ts +2 -0
  104. package/@types/components/toggleButtonGroup/sToggleButton.vue.d.ts +14 -0
  105. package/@types/components/toggleButtonGroup/sToggleButtonGroup.vue.d.ts +31 -0
  106. package/@types/components/toolbar/index.d.ts +3 -0
  107. package/@types/components/toolbar/sToolbar.vue.d.ts +23 -0
  108. package/@types/components/toolbar/sToolbarItem.vue.d.ts +5 -0
  109. package/@types/components/toolbar/sToolbarTitle.vue.d.ts +16 -0
  110. package/@types/components/window/index.d.ts +2 -0
  111. package/@types/components/window/sWindow.vue.d.ts +57 -0
  112. package/@types/components/window/sWindowItem.vue.d.ts +13 -0
  113. package/@types/componentsTypes.d.ts +8 -0
  114. package/@types/configs/app.d.ts +72 -0
  115. package/@types/configs/color.d.ts +2 -0
  116. package/@types/configs/core/breakpoint.d.ts +9 -0
  117. package/@types/configs/core/index.d.ts +1 -0
  118. package/@types/configs/datePicker.d.ts +34 -0
  119. package/@types/configs/grids.d.ts +3 -0
  120. package/@types/configs/i18n.d.ts +73 -0
  121. package/@types/configs/iconSizes.d.ts +7 -0
  122. package/@types/configs/index.d.ts +11 -0
  123. package/@types/configs/provider.d.ts +42 -0
  124. package/@types/configs/size.d.ts +2 -0
  125. package/@types/configs/toolbar.d.ts +11 -0
  126. package/@types/configs/transitions.d.ts +2 -0
  127. package/@types/constants/alert.d.ts +52 -0
  128. package/@types/constants/app.d.ts +7 -0
  129. package/@types/constants/button.d.ts +5 -0
  130. package/@types/constants/color.d.ts +318 -0
  131. package/@types/constants/cssVariables.d.ts +4 -0
  132. package/@types/constants/datePicker.d.ts +14 -0
  133. package/@types/constants/form.d.ts +9 -0
  134. package/@types/constants/grids.d.ts +14 -0
  135. package/@types/constants/i18n.d.ts +68 -0
  136. package/@types/constants/imageLoader.d.ts +13 -0
  137. package/@types/constants/index.d.ts +20 -0
  138. package/@types/constants/layout.d.ts +10 -0
  139. package/@types/constants/lazyLoad.d.ts +5 -0
  140. package/@types/constants/materialDesignIcon.d.ts +3 -0
  141. package/@types/constants/menuDimensions.d.ts +2 -0
  142. package/@types/constants/navigationDrawer.d.ts +8 -0
  143. package/@types/constants/overlay.d.ts +1 -0
  144. package/@types/constants/position.d.ts +1 -0
  145. package/@types/constants/size.d.ts +7 -0
  146. package/@types/constants/toolbar.d.ts +7 -0
  147. package/@types/constants/transition.d.ts +6 -0
  148. package/@types/definitions/app.d.ts +22 -0
  149. package/@types/definitions/emits/emitsTable.d.ts +18 -0
  150. package/@types/definitions/emits/index.d.ts +1 -0
  151. package/@types/definitions/index.d.ts +4 -0
  152. package/@types/definitions/props/core/index.d.ts +18 -0
  153. package/@types/definitions/props/core/propsActivator.d.ts +6 -0
  154. package/@types/definitions/props/core/propsBorder.d.ts +5 -0
  155. package/@types/definitions/props/core/propsButtonVariant.d.ts +3 -0
  156. package/@types/definitions/props/core/propsColor.d.ts +6 -0
  157. package/@types/definitions/props/core/propsComponentTheme.d.ts +4 -0
  158. package/@types/definitions/props/core/propsContent.d.ts +5 -0
  159. package/@types/definitions/props/core/propsDisabled.d.ts +4 -0
  160. package/@types/definitions/props/core/propsElevation.d.ts +3 -0
  161. package/@types/definitions/props/core/propsGroup.d.ts +6 -0
  162. package/@types/definitions/props/core/propsGroupItem.d.ts +6 -0
  163. package/@types/definitions/props/core/propsLayoutBase.d.ts +3 -0
  164. package/@types/definitions/props/core/propsLink.d.ts +7 -0
  165. package/@types/definitions/props/core/propsLocation.d.ts +6 -0
  166. package/@types/definitions/props/core/propsMeasurableStyles.d.ts +8 -0
  167. package/@types/definitions/props/core/propsPosition.d.ts +4 -0
  168. package/@types/definitions/props/core/propsTag.d.ts +4 -0
  169. package/@types/definitions/props/core/propsTextColor.d.ts +3 -0
  170. package/@types/definitions/props/core/propsToggleButtonGroupVariant.d.ts +3 -0
  171. package/@types/definitions/props/index.d.ts +70 -0
  172. package/@types/definitions/props/propsAlert.d.ts +7 -0
  173. package/@types/definitions/props/propsApp.d.ts +2 -0
  174. package/@types/definitions/props/propsAppBar.d.ts +9 -0
  175. package/@types/definitions/props/propsAutocomplete.d.ts +40 -0
  176. package/@types/definitions/props/propsBadge.d.ts +19 -0
  177. package/@types/definitions/props/propsBottomNavigation.d.ts +14 -0
  178. package/@types/definitions/props/propsBreadcrumbs.d.ts +7 -0
  179. package/@types/definitions/props/propsButton.d.ts +10 -0
  180. package/@types/definitions/props/propsCalendar.d.ts +27 -0
  181. package/@types/definitions/props/propsCard.d.ts +2 -0
  182. package/@types/definitions/props/propsCarousel.d.ts +12 -0
  183. package/@types/definitions/props/propsCarouselItem.d.ts +3 -0
  184. package/@types/definitions/props/propsCheckbox.d.ts +9 -0
  185. package/@types/definitions/props/propsChip.d.ts +7 -0
  186. package/@types/definitions/props/propsColumn.d.ts +10 -0
  187. package/@types/definitions/props/propsContainer.d.ts +8 -0
  188. package/@types/definitions/props/propsDatePicker.d.ts +15 -0
  189. package/@types/definitions/props/propsDatePickerFormat.d.ts +5 -0
  190. package/@types/definitions/props/propsDatePickerInput.d.ts +18 -0
  191. package/@types/definitions/props/propsDatePickerItem.d.ts +18 -0
  192. package/@types/definitions/props/propsDatePickerItemSwitch.d.ts +9 -0
  193. package/@types/definitions/props/propsDatePickerItemTitle.d.ts +3 -0
  194. package/@types/definitions/props/propsDialog.d.ts +10 -0
  195. package/@types/definitions/props/propsDivider.d.ts +3 -0
  196. package/@types/definitions/props/propsDroppable.d.ts +2 -0
  197. package/@types/definitions/props/propsExpansionPanels.d.ts +8 -0
  198. package/@types/definitions/props/propsFooter.d.ts +6 -0
  199. package/@types/definitions/props/propsFormInput.d.ts +10 -0
  200. package/@types/definitions/props/propsIcon.d.ts +10 -0
  201. package/@types/definitions/props/propsImage.d.ts +9 -0
  202. package/@types/definitions/props/propsImageLoader.d.ts +11 -0
  203. package/@types/definitions/props/propsInput.d.ts +32 -0
  204. package/@types/definitions/props/propsLayout.d.ts +6 -0
  205. package/@types/definitions/props/propsLayoutProvider.d.ts +4 -0
  206. package/@types/definitions/props/propsLink.d.ts +7 -0
  207. package/@types/definitions/props/propsList.d.ts +10 -0
  208. package/@types/definitions/props/propsListItem.d.ts +7 -0
  209. package/@types/definitions/props/propsListMediaItem.d.ts +4 -0
  210. package/@types/definitions/props/propsMain.d.ts +4 -0
  211. package/@types/definitions/props/propsMenu.d.ts +9 -0
  212. package/@types/definitions/props/propsNavigationDrawer.d.ts +20 -0
  213. package/@types/definitions/props/propsOverlay.d.ts +8 -0
  214. package/@types/definitions/props/propsProgressCircular.d.ts +8 -0
  215. package/@types/definitions/props/propsProgressLinear.d.ts +9 -0
  216. package/@types/definitions/props/propsRadioGroup.d.ts +9 -0
  217. package/@types/definitions/props/propsRow.d.ts +11 -0
  218. package/@types/definitions/props/propsScrollable.d.ts +5 -0
  219. package/@types/definitions/props/propsSelect.d.ts +13 -0
  220. package/@types/definitions/props/propsSheet.d.ts +2 -0
  221. package/@types/definitions/props/propsSingleGroup.d.ts +6 -0
  222. package/@types/definitions/props/propsSingleGroupItem.d.ts +5 -0
  223. package/@types/definitions/props/propsSizePreset.d.ts +4 -0
  224. package/@types/definitions/props/propsSizeUnion.d.ts +4 -0
  225. package/@types/definitions/props/propsSlideGroup.d.ts +11 -0
  226. package/@types/definitions/props/propsSnackbar.d.ts +6 -0
  227. package/@types/definitions/props/propsSplitView.d.ts +9 -0
  228. package/@types/definitions/props/propsStepper.d.ts +10 -0
  229. package/@types/definitions/props/propsStepperStep.d.ts +6 -0
  230. package/@types/definitions/props/propsSwitch.d.ts +5 -0
  231. package/@types/definitions/props/propsTab.d.ts +5 -0
  232. package/@types/definitions/props/propsTable.d.ts +58 -0
  233. package/@types/definitions/props/propsTabs.d.ts +12 -0
  234. package/@types/definitions/props/propsTextarea.d.ts +25 -0
  235. package/@types/definitions/props/propsToggleButton.d.ts +3 -0
  236. package/@types/definitions/props/propsToggleButtonGroup.d.ts +8 -0
  237. package/@types/definitions/props/propsToolbar.d.ts +11 -0
  238. package/@types/definitions/props/propsToolbarTitle.d.ts +4 -0
  239. package/@types/definitions/props/propsTooltip.d.ts +9 -0
  240. package/@types/definitions/props/propsWindow.d.ts +13 -0
  241. package/@types/definitions/props/propsWindowItem.d.ts +2 -0
  242. package/@types/definitions/provider.d.ts +20 -0
  243. package/@types/directives/index.d.ts +2 -0
  244. package/@types/directives/resize.d.ts +2 -0
  245. package/@types/directives/scroll.d.ts +2 -0
  246. package/@types/helpers/autocompleteHelpers.d.ts +7 -0
  247. package/@types/helpers/colorHelpers.d.ts +3 -0
  248. package/@types/helpers/createAppStore.d.ts +77 -0
  249. package/@types/helpers/display.d.ts +1 -0
  250. package/@types/helpers/index.d.ts +6 -0
  251. package/@types/helpers/selectItemHelpers.d.ts +4 -0
  252. package/@types/helpers/tableHelpers.d.ts +9 -0
  253. package/@types/helpers/themeHelpers.d.ts +2 -0
  254. package/@types/index.d.ts +10 -0
  255. package/@types/lib/browser.d.ts +26 -0
  256. package/@types/lib/button.d.ts +3 -0
  257. package/@types/lib/color.d.ts +19 -0
  258. package/@types/lib/compositionApi.d.ts +2 -0
  259. package/@types/lib/formatNumber.d.ts +1 -0
  260. package/@types/lib/getCleanSetObject.d.ts +5 -0
  261. package/@types/lib/getNumericCssAttribute.d.ts +1 -0
  262. package/@types/lib/getNumericValue.d.ts +13 -0
  263. package/@types/lib/getPluginName.d.ts +1 -0
  264. package/@types/lib/htmlClass.d.ts +1 -0
  265. package/@types/lib/htmlToText.d.ts +2 -0
  266. package/@types/lib/index.d.ts +12 -0
  267. package/@types/lib/isEmpty.d.ts +1 -0
  268. package/@types/lib/retry.d.ts +1 -0
  269. package/@types/lib/scroll.d.ts +13 -0
  270. package/@types/lib/wait.d.ts +1 -0
  271. package/@types/modules/index.d.ts +1 -0
  272. package/@types/modules/sUI.d.ts +2 -0
  273. package/@types/repositories/calendarRepository.d.ts +3 -0
  274. package/@types/repositories/colorRepository.d.ts +14 -0
  275. package/@types/repositories/columnRepository.d.ts +9 -0
  276. package/@types/repositories/core/appProviderRepository.d.ts +4 -0
  277. package/@types/repositories/datePicker.d.ts +18 -0
  278. package/@types/repositories/form.d.ts +66 -0
  279. package/@types/repositories/htmlClassRepository.d.ts +1 -0
  280. package/@types/repositories/index.d.ts +9 -0
  281. package/@types/repositories/positionRepository.d.ts +10 -0
  282. package/@types/repositories/tableRepository.d.ts +2 -0
  283. package/@types/repositories/touchRepository.d.ts +4 -0
  284. package/@types/services/appBarService.d.ts +41 -0
  285. package/@types/services/appService.d.ts +6 -0
  286. package/@types/services/autocompleteService.d.ts +42 -0
  287. package/@types/services/backgroundScrollService.d.ts +4 -0
  288. package/@types/services/borderService.d.ts +12 -0
  289. package/@types/services/calendar/calendarEventService.d.ts +5 -0
  290. package/@types/services/calendar/calendarMonthlyService.d.ts +14 -0
  291. package/@types/services/calendar/calendarService.d.ts +8 -0
  292. package/@types/services/calendar/calendarWeeklyService.d.ts +28 -0
  293. package/@types/services/calendar/index.d.ts +8 -0
  294. package/@types/services/calendar/useCalendarDateFormatters.d.ts +6 -0
  295. package/@types/services/calendar/useCalendarEventHandlers.d.ts +19 -0
  296. package/@types/services/calendar/useCalendarWeeklyAllDayEvents.d.ts +20 -0
  297. package/@types/services/calendar/useCalendarWeeklyEventPositioning.d.ts +23 -0
  298. package/@types/services/colorService.d.ts +19 -0
  299. package/@types/services/columnService.d.ts +8 -0
  300. package/@types/services/componentDefaultsService.d.ts +1 -0
  301. package/@types/services/componentThemeService.d.ts +6 -0
  302. package/@types/services/core/activatorService.d.ts +16 -0
  303. package/@types/services/core/clickOutsideService.d.ts +9 -0
  304. package/@types/services/core/contentService.d.ts +13 -0
  305. package/@types/services/core/expandableItemCoreService.d.ts +4 -0
  306. package/@types/services/core/groupCoreItemService.d.ts +11 -0
  307. package/@types/services/core/groupCoreService.d.ts +16 -0
  308. package/@types/services/core/index.d.ts +9 -0
  309. package/@types/services/core/layoutCoreService.d.ts +21 -0
  310. package/@types/services/core/locationService.d.ts +11 -0
  311. package/@types/services/core/tableCellCommonService.d.ts +8 -0
  312. package/@types/services/datePicker/datePickerInputService.d.ts +9 -0
  313. package/@types/services/datePicker/datePickerItemCoreService.d.ts +30 -0
  314. package/@types/services/datePicker/datePickerItemDateService.d.ts +18 -0
  315. package/@types/services/datePicker/datePickerItemMonthService.d.ts +17 -0
  316. package/@types/services/datePicker/datePickerItemSwitchService.d.ts +11 -0
  317. package/@types/services/datePicker/datePickerItemTitleService.d.ts +8 -0
  318. package/@types/services/datePicker/datePickerItemYearService.d.ts +17 -0
  319. package/@types/services/datePicker/datePickerService.d.ts +7 -0
  320. package/@types/services/datePicker/index.d.ts +7 -0
  321. package/@types/services/dialogService.d.ts +32 -0
  322. package/@types/services/disabledService.d.ts +12 -0
  323. package/@types/services/displayService.d.ts +24 -0
  324. package/@types/services/elevationService.d.ts +6 -0
  325. package/@types/services/expandableItemService.d.ts +5 -0
  326. package/@types/services/expandableService.d.ts +5 -0
  327. package/@types/services/formInputService.d.ts +8 -0
  328. package/@types/services/groupItemService.d.ts +10 -0
  329. package/@types/services/groupService.d.ts +16 -0
  330. package/@types/services/index.d.ts +43 -0
  331. package/@types/services/layoutProviderService.d.ts +28 -0
  332. package/@types/services/layoutService.d.ts +24 -0
  333. package/@types/services/linkService.d.ts +21 -0
  334. package/@types/services/listMediaItemService.d.ts +8 -0
  335. package/@types/services/measurableStylesService.d.ts +11 -0
  336. package/@types/services/menuService.d.ts +35 -0
  337. package/@types/services/navigationDrawerResizeService.d.ts +10 -0
  338. package/@types/services/navigationDrawerService.d.ts +6 -0
  339. package/@types/services/positionService.d.ts +10 -0
  340. package/@types/services/resizeService.d.ts +4 -0
  341. package/@types/services/scrollService.d.ts +8 -0
  342. package/@types/services/scrollableService.d.ts +15 -0
  343. package/@types/services/singleGroupItemService.d.ts +10 -0
  344. package/@types/services/singleGroupService.d.ts +34 -0
  345. package/@types/services/sizeService.d.ts +12 -0
  346. package/@types/services/slideGroupService.d.ts +19 -0
  347. package/@types/services/table/index.d.ts +3 -0
  348. package/@types/services/table/tableBodyCellService.d.ts +9 -0
  349. package/@types/services/table/tableHeadCellService.d.ts +8 -0
  350. package/@types/services/table/tableService.d.ts +179 -0
  351. package/@types/services/tagService.d.ts +9 -0
  352. package/@types/services/textColorService.d.ts +15 -0
  353. package/@types/services/themeService.d.ts +5 -0
  354. package/@types/services/toolbarService.d.ts +7 -0
  355. package/@types/services/touchService.d.ts +2 -0
  356. package/@types/store/index.d.ts +5 -0
  357. package/@types/types/app.d.ts +36 -0
  358. package/@types/types/autocomplete.d.ts +7 -0
  359. package/@types/types/breadcrumbs.d.ts +8 -0
  360. package/@types/types/button.d.ts +1 -0
  361. package/@types/types/calendar.d.ts +61 -0
  362. package/@types/types/core/color.d.ts +2 -0
  363. package/@types/types/core/emit.d.ts +1 -0
  364. package/@types/types/core/form.d.ts +2 -0
  365. package/@types/types/core/group.d.ts +1 -0
  366. package/@types/types/core/index.d.ts +4 -0
  367. package/@types/types/datePicker.d.ts +12 -0
  368. package/@types/types/display.d.ts +9 -0
  369. package/@types/types/emits.d.ts +17 -0
  370. package/@types/types/form.d.ts +9 -0
  371. package/@types/types/grids.d.ts +2 -0
  372. package/@types/types/html.d.ts +1 -0
  373. package/@types/types/icon.d.ts +1 -0
  374. package/@types/types/index.d.ts +24 -0
  375. package/@types/types/input.d.ts +3 -0
  376. package/@types/types/location.d.ts +2 -0
  377. package/@types/types/materialDesignIcon.d.ts +2 -0
  378. package/@types/types/menu.d.ts +9 -0
  379. package/@types/types/resize.d.ts +12 -0
  380. package/@types/types/scroll.d.ts +26 -0
  381. package/@types/types/select.d.ts +6 -0
  382. package/@types/types/size.d.ts +2 -0
  383. package/@types/types/table.d.ts +84 -0
  384. package/@types/types/tag.d.ts +1 -0
  385. package/@types/types/toolbar.d.ts +2 -0
  386. package/@types/types/touch.d.ts +28 -0
  387. package/@types/validators/index.d.ts +1 -0
  388. package/@types/validators/numeric.d.ts +1 -0
  389. package/@types/vendors/dayjs.d.ts +2 -0
  390. package/@types/vendors/merge.d.ts +2 -0
  391. package/@types/vite.config.d.ts +2 -0
  392. package/@types/vitest.config.d.ts +2 -0
  393. package/README.md +189 -2
  394. package/dist/base.css +7282 -0
  395. package/dist/base.css.map +1 -0
  396. package/dist/s-ui.css +2 -0
  397. package/dist/s-ui.js +8976 -0
  398. package/dist/s-ui.umd.cjs +1 -0
  399. package/dist/styles/_helpers.scss +9 -0
  400. package/dist/styles/components/appBar/_variables.scss +4 -0
  401. package/dist/styles/components/appBar/index.scss +1 -0
  402. package/dist/styles/components/button/_variables.scss +51 -0
  403. package/dist/styles/components/button/index.scss +2 -0
  404. package/dist/styles/components/button/mixins.scss +60 -0
  405. package/dist/styles/components/cards/index.scss +1 -0
  406. package/dist/styles/components/cards/variables.scss +5 -0
  407. package/dist/styles/components/icon/_variables.scss +14 -0
  408. package/dist/styles/components/icon/index.scss +1 -0
  409. package/dist/styles/components/index.scss +10 -0
  410. package/dist/styles/components/layout/_mixins.scss +7 -0
  411. package/dist/styles/components/layout/_variables.scss +6 -0
  412. package/dist/styles/components/layout/index.scss +2 -0
  413. package/dist/styles/components/list/_mixins.scss +53 -0
  414. package/dist/styles/components/list/index.scss +1 -0
  415. package/dist/styles/components/menu/_mixins.scss +11 -0
  416. package/dist/styles/components/menu/index.scss +1 -0
  417. package/dist/styles/components/table/_mixins.scss +51 -0
  418. package/dist/styles/components/table/index.scss +1 -0
  419. package/dist/styles/components/toggleButton/_variables.scss +4 -0
  420. package/dist/styles/components/toggleButton/index.scss +1 -0
  421. package/dist/styles/components/window/_variables.scss +2 -0
  422. package/dist/styles/components/window/index.scss +1 -0
  423. package/dist/styles/generic/_common.scss +95 -0
  424. package/dist/styles/generic/_reset.scss +357 -0
  425. package/dist/styles/generic/_transitions.scss +83 -0
  426. package/dist/styles/generic/index.scss +3 -0
  427. package/dist/styles/index.scss +6 -0
  428. package/dist/styles/lib/_functions.scss +86 -0
  429. package/dist/styles/lib/index.scss +1 -0
  430. package/dist/styles/mixins/_app.scss +13 -0
  431. package/dist/styles/mixins/_border.scss +104 -0
  432. package/dist/styles/mixins/_dark.scss +31 -0
  433. package/dist/styles/mixins/_display.scss +9 -0
  434. package/dist/styles/mixins/_elevation.scss +15 -0
  435. package/dist/styles/mixins/_grids.scss +66 -0
  436. package/dist/styles/mixins/_media.scss +14 -0
  437. package/dist/styles/mixins/_text.scss +44 -0
  438. package/dist/styles/mixins/_utilities.scss +68 -0
  439. package/dist/styles/mixins/index.scss +10 -0
  440. package/dist/styles/modules/breakpoints.module.scss +10 -0
  441. package/dist/styles/tools/_breakpoint.scss +20 -0
  442. package/dist/styles/tools/_color.scss +35 -0
  443. package/dist/styles/tools/index.scss +2 -0
  444. package/dist/styles/variables/_border.scss +19 -0
  445. package/dist/styles/variables/_colors.scss +34 -0
  446. package/dist/styles/variables/_elevations.scss +98 -0
  447. package/dist/styles/variables/_font.scss +8 -0
  448. package/dist/styles/variables/_grid.scss +36 -0
  449. package/dist/styles/variables/_headings.scss +100 -0
  450. package/dist/styles/variables/_spacers.scss +17 -0
  451. package/dist/styles/variables/_transitions.scss +16 -0
  452. package/dist/styles/variables/_utilities.scss +360 -0
  453. package/dist/styles/variables/index.scss +9 -0
  454. package/dist/sui-api.json +10018 -0
  455. package/package.json +82 -4
  456. package/sui-plugin/.claude-plugin/plugin.json +10 -0
  457. package/sui-plugin/README.md +96 -0
  458. package/sui-plugin/skills/sui-component/SKILL.md +135 -0
  459. package/sui-plugin/skills/sui-component/references/alert.md +69 -0
  460. package/sui-plugin/skills/sui-component/references/autocomplete.md +167 -0
  461. package/sui-plugin/skills/sui-component/references/badge.md +106 -0
  462. package/sui-plugin/skills/sui-component/references/breadcrumbs.md +80 -0
  463. package/sui-plugin/skills/sui-component/references/button.md +113 -0
  464. package/sui-plugin/skills/sui-component/references/calendar.md +150 -0
  465. package/sui-plugin/skills/sui-component/references/cards.md +214 -0
  466. package/sui-plugin/skills/sui-component/references/carousel.md +178 -0
  467. package/sui-plugin/skills/sui-component/references/chip.md +92 -0
  468. package/sui-plugin/skills/sui-component/references/date-picker.md +226 -0
  469. package/sui-plugin/skills/sui-component/references/dialog.md +120 -0
  470. package/sui-plugin/skills/sui-component/references/divider.md +61 -0
  471. package/sui-plugin/skills/sui-component/references/droppable.md +88 -0
  472. package/sui-plugin/skills/sui-component/references/expansion-panels.md +185 -0
  473. package/sui-plugin/skills/sui-component/references/form.md +575 -0
  474. package/sui-plugin/skills/sui-component/references/icon.md +80 -0
  475. package/sui-plugin/skills/sui-component/references/image.md +77 -0
  476. package/sui-plugin/skills/sui-component/references/layout.md +612 -0
  477. package/sui-plugin/skills/sui-component/references/list.md +321 -0
  478. package/sui-plugin/skills/sui-component/references/menu.md +107 -0
  479. package/sui-plugin/skills/sui-component/references/overlay.md +67 -0
  480. package/sui-plugin/skills/sui-component/references/progress.md +126 -0
  481. package/sui-plugin/skills/sui-component/references/sheet.md +81 -0
  482. package/sui-plugin/skills/sui-component/references/slide-group.md +160 -0
  483. package/sui-plugin/skills/sui-component/references/snackbar.md +88 -0
  484. package/sui-plugin/skills/sui-component/references/split-view.md +98 -0
  485. package/sui-plugin/skills/sui-component/references/stepper.md +127 -0
  486. package/sui-plugin/skills/sui-component/references/table.md +213 -0
  487. package/sui-plugin/skills/sui-component/references/tabs.md +133 -0
  488. package/sui-plugin/skills/sui-component/references/toggle-button-group.md +155 -0
  489. package/sui-plugin/skills/sui-component/references/toolbar.md +160 -0
  490. package/sui-plugin/skills/sui-component/references/tooltip.md +102 -0
  491. package/sui-plugin/skills/sui-component/references/window.md +130 -0
  492. package/sui-plugin/skills/sui-form/SKILL.md +227 -0
  493. package/sui-plugin/skills/sui-getting-started/SKILL.md +365 -0
  494. package/sui-plugin/skills/sui-layout/SKILL.md +111 -0
  495. package/sui-plugin/skills/sui-utilities/SKILL.md +40 -0
  496. package/sui-plugin/skills/sui-utilities/docs/classes.md +487 -0
  497. package/sui-plugin/skills/sui-utilities/docs/directives.md +200 -0
  498. package/sui-plugin/skills/sui-utilities/docs/helpers.md +583 -0
@@ -0,0 +1,365 @@
1
+ ---
2
+ name: sui-getting-started
3
+ description: Set up and configure @khsura/sui in a Vue 3 or Nuxt app. Use when installing @khsura/sui (public npm, migrating off the old GitHub Packages registry), wiring createSUI and the SApp root, importing the stylesheets and @mdi/font icons, adding @khsura/sui-nuxt, overriding theme colors or switching dark mode with useTheme, setting app-wide component defaults, setting up vue-i18n for SUI messages and form rules, importing SUI TypeScript types, setting up the @khsura/sui-mcp MCP server for Claude Code, Cursor, VS Code or Windsurf, or looking up shared props, the component list, composables and common mistakes.
4
+ ---
5
+
6
+ # SUI — Getting Started in a consumer app
7
+
8
+ **`@khsura/sui`** is a Vue 3 + TypeScript component library. Every component is prefixed with `S` (`SButton`, `SCard`, `SInput`).
9
+
10
+ ---
11
+
12
+ ## 1. Install (public npm)
13
+
14
+ `@khsura/sui` is published to the **public npm registry** — no registry config, `.npmrc` or token needed:
15
+
16
+ ```bash
17
+ npm i @khsura/sui @mdi/font # or: yarn add / pnpm add
18
+ ```
19
+
20
+ Component docs and live examples: **Storybook at https://sui.surakh.com/**
21
+
22
+ ### Migrating from GitHub Packages
23
+
24
+ Older versions were published to GitHub Packages. If your project still points the `@khsura` scope there, remove that config, or installs keep hitting the old registry (404 / 401 for new versions):
25
+
26
+ - `.npmrc` (npm / pnpm): delete the `@khsura:registry=...` line that points at GitHub Packages, and its matching `:_authToken=...` line.
27
+ - `.yarnrc.yml` (Yarn 4): delete the `npmScopes.khsura` block (`npmRegistryServer`, `npmAlwaysAuth`, `npmAuthToken`).
28
+ - CI: the GitHub token secret your install step used for SUI is no longer needed.
29
+
30
+ `vue`, `vue-i18n` and `dayjs` come in as dependencies of `@khsura/sui`. `@mdi/font` is **not** included — install it yourself (see step 3).
31
+
32
+ ---
33
+
34
+ ## 2. Register the plugin and wrap the app in `SApp`
35
+
36
+ ```typescript
37
+ // main.ts
38
+ import { createApp } from 'vue'
39
+ import { createSUI } from '@khsura/sui'
40
+ import '@khsura/sui/base.css' // reset, typography, s_* utility classes
41
+ import '@khsura/sui/style.css' // component styles
42
+ import '@mdi/font/css/materialdesignicons.css' // icons for SIcon / icon props
43
+ import App from './App.vue'
44
+
45
+ createApp(App).use(createSUI()).mount('#app')
46
+ ```
47
+
48
+ ```vue
49
+ <!-- App.vue -->
50
+ <template>
51
+ <SApp>
52
+ <router-view />
53
+ </SApp>
54
+ </template>
55
+
56
+ <script setup lang="ts">
57
+ import { SApp } from '@khsura/sui'
58
+ </script>
59
+ ```
60
+
61
+ **`SApp` is required at the root.** It sets the theme CSS variables (`--s-color-*`, `--s-app-color-*`) that every component's colors read, and renders the container that `SDialog`, `SMenu`, `STooltip`, `SSnackbar`, `SOverlay` and the select popups teleport into. Without it colors are missing and popups don't appear.
62
+
63
+ `createSUI()` also registers the `v-scroll` and `v-resize` directives.
64
+
65
+ Import components where you use them (Vue): `import { SButton, SCard } from '@khsura/sui'`.
66
+
67
+ ---
68
+
69
+ ## 3. Styles and icons
70
+
71
+ | Import | Contains | Needed |
72
+ |---|---|---|
73
+ | `@khsura/sui/base.css` | Reset, typography, `s_*` utility classes | Yes |
74
+ | `@khsura/sui/style.css` | Styles of the components themselves | Yes |
75
+ | `@khsura/sui/style.scss` | SCSS source of `base.css` (alternative to `base.css`) | Optional |
76
+ | `@khsura/sui/helpers.scss` | SCSS functions / mixins only, emits no CSS | For your own SCSS: `@use '@khsura/sui/helpers.scss' as *;` |
77
+ | `@mdi/font/css/materialdesignicons.css` | Material Design Icons font | Yes, if you use any icon |
78
+
79
+ `SIcon` (and every `icon` / `prependIcon` / `appendIcon` prop) renders an MDI **class name** (`icon="mdi-home"`). Without the `@mdi/font` stylesheet it renders an empty box — no error.
80
+
81
+ ---
82
+
83
+ ## 4. Nuxt — `@khsura/sui-nuxt`
84
+
85
+ `@khsura/sui-nuxt` is a Nuxt module (Nuxt ≥ 4) under the same `@khsura` scope; install it the same way.
86
+
87
+ ```bash
88
+ yarn add @khsura/sui @khsura/sui-nuxt @mdi/font
89
+ ```
90
+
91
+ ```typescript
92
+ // nuxt.config.ts
93
+ export default defineNuxtConfig({
94
+ modules: ['@khsura/sui-nuxt'],
95
+ css: ['@mdi/font/css/materialdesignicons.css'],
96
+ sui: {
97
+ // AppStateOptions passed to createSUI(): theme, themes, display, components
98
+ },
99
+ })
100
+ ```
101
+
102
+ The module:
103
+
104
+ - calls `createSUI(sui options)` for you
105
+ - loads `@khsura/sui/style.css` and `@khsura/sui/style.scss` (you don't import them, but you **do** add `@mdi/font` to `css`)
106
+ - auto-imports `useDisplay`, `useTheme`, `STransition`, and the types `FormInputModelValueRule`, `GroupItemValue`, `SInput`, `SSelect`, `SForm`, `TableHeader`, `TableItem`, `MaterialDesignIcon`
107
+ - provides `useNuxtApp().$suiFormRules` = `getFormInputModelValueRules(nuxtApp.$i18n)` — this needs `@nuxtjs/i18n` installed, or the rules throw when they try to build a message
108
+ - registers every component globally (since `@khsura/sui-nuxt` 1.1.6, which requires `@khsura/sui` ^1.18.0). Older versions did **not** register `SLayout`, `SBottomNavigation`, `SCarousel`, `SCarouselItem`, `SSplitView`, `SSplitViewItem`, `SToolbarItem`, `STableHeadCell`, `STableBodyCell`, `SDroppable`, `SWindow`, `SWindowItem` — on those, import them from `@khsura/sui`
109
+
110
+ You still need `<SApp>` at the root (e.g. in `app.vue` or your layout).
111
+
112
+ ---
113
+
114
+ ## 5. App options — `createSUI(options)`
115
+
116
+ Options (type `AppStateOptions`) are deep-merged with the built-in defaults (exported as `defaultAppConfig`), so pass only what you change. In Nuxt put the same object under `sui`.
117
+
118
+ | Option | Type | Description |
119
+ |---|---|---|
120
+ | `theme` | `'light' \| 'dark'` | Initial theme (default `'light'`) |
121
+ | `themes` | `{ light?: ThemeConfigOptions, dark?: ThemeConfigOptions }` | Per-theme `presetColors` and `appColors` |
122
+ | `display` | `{ thresholds?, scrollBarWidth? }` | Breakpoints and scrollbar width |
123
+ | `components` | `{ [ComponentName]: Record<string, unknown> }` | App-wide default props per component |
124
+
125
+ ### Theme colors
126
+
127
+ ```typescript
128
+ app.use(
129
+ createSUI({
130
+ themes: {
131
+ light: { presetColors: { primary: '#6200ee', secondary: '#03dac6' } },
132
+ dark: {
133
+ presetColors: { primary: '#bb86fc' },
134
+ appColors: { background: '#121212', card: '#1e1e1e' },
135
+ },
136
+ },
137
+ }),
138
+ )
139
+ ```
140
+
141
+ - **`presetColors` keys:** `primary`, `secondary`, `success`, `info`, `warning`, `important`, `error` — usable as `color="..."` on components. Extra keys you add become usable too.
142
+ - **`appColors` keys:** `appBar`, `title`, `text`, `secondaryText`, `anchor`, `background`, `card`, `button`, `switch`, `border`, `disabled`, `snackbar`, `inputPlaceholderShown`, `textErrorHover`.
143
+ - Use **opaque hex** values (`#ffc107`). An alpha hex (`#ffc10799`) looks washed out everywhere; for translucency use `color-mix(in srgb, #{s_getPresetColor('warning')} 60%, transparent)` in SCSS.
144
+
145
+ ### Dark mode — `useTheme()`
146
+
147
+ ```typescript
148
+ import { useTheme } from '@khsura/sui'
149
+
150
+ const { theme, setTheme } = useTheme() // theme: ComputedRef<'light' | 'dark'>
151
+
152
+ setTheme('dark')
153
+ setTheme(theme.value === 'dark' ? 'light' : 'dark') // toggle — there is no toggleTheme()
154
+ setTheme(null) // follow the OS setting
155
+ ```
156
+
157
+ Call it inside a component below `app.use(createSUI())`; it throws if the plugin isn't installed.
158
+
159
+ ### Component defaults — `components`
160
+
161
+ Set a prop once for every instance instead of repeating it (or overriding classes with `:deep(.s_*)`):
162
+
163
+ ```typescript
164
+ app.use(
165
+ createSUI({
166
+ components: {
167
+ SSelect: { outlined: true },
168
+ SButton: { color: 'primary', size: 'small' },
169
+ SInput: { dense: true },
170
+ },
171
+ }),
172
+ )
173
+ ```
174
+
175
+ Priority: **prop on the element > `components` default > built-in default**. Keys are component names (`SButton`, `SInput`, …).
176
+
177
+ ---
178
+
179
+ ## 6. vue-i18n — SUI messages and form rules
180
+
181
+ SUI ships messages in **`en`, `mn`, `ja`** for `STable` (`table.itemsPerPage`, `table.noData`) and the predefined form rules (`formRules.*`). `STable` reads them through the global `$t`, so register vue-i18n with the SUI messages merged in. `i18nConfig` (exported) is a ready config: `{ availableLocales: ['en', 'mn', 'ja'], locale: 'en', fallbackLocale: 'en', messages: i18nMessages }`.
182
+
183
+ ```typescript
184
+ import { createI18n } from 'vue-i18n'
185
+ import { i18nConfig, i18nMessages, getFormInputModelValueRules } from '@khsura/sui'
186
+
187
+ export const i18n = createI18n({
188
+ ...i18nConfig,
189
+ locale: 'ja',
190
+ messages: {
191
+ en: { ...i18nMessages.en, ...appMessages.en },
192
+ mn: { ...i18nMessages.mn, ...appMessages.mn },
193
+ ja: { ...i18nMessages.ja, ...appMessages.ja },
194
+ },
195
+ })
196
+
197
+ app.use(i18n)
198
+
199
+ // Predefined rules with localized messages
200
+ const rules = getFormInputModelValueRules(i18n.global)
201
+ // rules.required({ target: 'Email' }), rules.maxLength({ target: 'Name', maxLength: 50 }), …
202
+ ```
203
+
204
+ Inside a component: `getFormInputModelValueRules(useI18n())`. In Nuxt use `@nuxtjs/i18n` and merge `i18nMessages` into its messages; `useNuxtApp().$suiFormRules` is prebuilt. Rule list: **sui-form**.
205
+
206
+ ---
207
+
208
+ ## 7. TypeScript types
209
+
210
+ All exported from `@khsura/sui` (`import type { … } from '@khsura/sui'`):
211
+
212
+ | Type | Use |
213
+ |---|---|
214
+ | `TableHeader`, `TableItem`, `TableSortOrder` | `STable` headers (`{ text, value, … }`) and rows |
215
+ | `SelectItem` | `SSelect` / `SAutocomplete` items (`{ text, value, disabled? }`) |
216
+ | `FormInputModelValueRule` | A validation rule `(value) => true \| string` |
217
+ | `FormComponent`, `InputComponent`, `SelectComponent` | Template-ref types (`ref<FormComponent>()`) |
218
+ | `AppStateOptions`, `ThemeConfigOptions`, `AppThemeType` | `createSUI` options |
219
+ | `MaterialDesignIcon`, `GroupItemValue`, `BreadcrumbsItem`, `CalendarEvent` | Icon names, group values, breadcrumb items, calendar events |
220
+
221
+ Prop types for every component ship in `node_modules/@khsura/sui/@types/definitions/props/props<Component>.d.ts` — check there before using a prop you're unsure of.
222
+
223
+ ---
224
+
225
+ ## Critical patterns
226
+
227
+ ### Activator slot (SDialog, SMenu, SSnackbar)
228
+
229
+ Bind **both** `v-on="on"` and `v-bind="attrs"`:
230
+
231
+ ```vue
232
+ <SMenu location="bottom">
233
+ <template #activator="{ on, attrs }">
234
+ <SButton v-on="on" v-bind="attrs">Open</SButton>
235
+ </template>
236
+ <!-- content -->
237
+ </SMenu>
238
+ ```
239
+
240
+ `STooltip` is different: its activator slot passes **no** scope — put the trigger in `#activator` without `v-on`/`v-bind`; the tooltip's own wrapper handles hover. See the `sui-component` references.
241
+
242
+ ### Named layouts
243
+
244
+ `SLayout name="app"` + children with `for="app"`. Once `SLayout` has a `name`, every child needs the matching `for`. Details: **sui-layout**.
245
+
246
+ ### Validation rules
247
+
248
+ ```typescript
249
+ type FormInputModelValueRule = (value: unknown) => true | string
250
+ // true = pass, string = error message (false/null show nothing)
251
+ ```
252
+
253
+ ---
254
+
255
+ ## Shared props
256
+
257
+ Available on most components (check the component's reference when unsure):
258
+
259
+ | Prop | Type | Description |
260
+ |---|---|---|
261
+ | `color` | `string` | Preset name (`primary`, `error`, …) or CSS color |
262
+ | `elevation` | `0–24` | Box shadow depth |
263
+ | `size` | `'mini' \| 'small' \| 'default' \| 'large' \| 'extra'` | Preset size |
264
+ | `outlined` / `underlined` / `borderRadius` | `boolean` / `boolean` / `string \| number` | Border styles |
265
+ | `disabled` | `boolean` | Disable interaction |
266
+ | `width` / `height` / `maxWidth` / `minWidth` | `string \| number` | Dimensions |
267
+ | `tag` | `string` | Override root element |
268
+ | `href` / `to` | `string` / `RouteLocationRaw` | Render as `<a>` / `router-link` |
269
+
270
+ ---
271
+
272
+ ## Components
273
+
274
+ | Family | Components | Reference |
275
+ |---|---|---|
276
+ | App shell | `SApp`, `SLayout`, `SAppBar`, `SAppBarTitle`, `SNavigationDrawer`, `SMain`, `SFooter`, `SBottomNavigation` | **sui-layout** |
277
+ | Grid | `SContainer`, `SRow`, `SColumn` (there is no `SCol`), `SSpacer` | **sui-layout** |
278
+ | Forms | `SForm`, `SInput`, `STextarea`, `SSelect`, `SAutocomplete`, `SCheckbox`, `SRadioGroup` + `SRadio`, `SSwitch`, `SDatePickerInput` | **sui-form** |
279
+ | Everything else | Buttons, cards, lists, tables, dialogs, menus, tabs, steppers, carousels, date pickers, … | **sui-component** (one reference file per family) |
280
+
281
+ ---
282
+
283
+ ## Composables
284
+
285
+ ```typescript
286
+ import { useTheme, useDisplay, useScroll, useClickOutside } from '@khsura/sui'
287
+
288
+ const { theme, setTheme } = useTheme()
289
+
290
+ // Breakpoints (refs): xs, sm, md, lg, xl, xxl, smAndUp, smAndDown, mdAndUp, mdAndDown,
291
+ // lgAndUp, lgAndDown, mobile, name, width, height, isTouchDevice
292
+ const { mdAndUp, mobile } = useDisplay()
293
+
294
+ // Scroll helpers
295
+ const { smoothScrollTo, scrollIntoView, smoothElementScroll, hasScrollFeature } = useScroll()
296
+
297
+ // Click outside: register/unregister yourself
298
+ const el = ref<HTMLElement | null>(null)
299
+ const { register, unregister } = useClickOutside().onClick(el, ({ isOutside }) => {
300
+ if (isOutside) close()
301
+ })
302
+ onMounted(register)
303
+ onBeforeUnmount(unregister)
304
+ ```
305
+
306
+ Directives (`v-scroll`, `v-resize`) and utility classes: **sui-utilities**.
307
+
308
+ ---
309
+
310
+ ## Common mistakes
311
+
312
+ | ❌ | ✅ |
313
+ |---|---|
314
+ | `npm i @khsura/sui` → 404/401 | A leftover `@khsura` scope override still points at GitHub Packages — remove it from `.npmrc` / `.yarnrc.yml` (step 1, *Migrating from GitHub Packages*) |
315
+ | Icons render as empty boxes | Load `@mdi/font` — `import '@mdi/font/css/materialdesignicons.css'` (Vue) or `css: ['@mdi/font/css/materialdesignicons.css']` (Nuxt) |
316
+ | Only `style.css` (or only `base.css`) imported | Import both in plain Vue; the Nuxt module loads them |
317
+ | No `<SApp>` root → no colors, dialogs/menus never show | Wrap the app in `<SApp>` |
318
+ | `const { toggleTheme, isMobile } = …` | They don't exist: `setTheme(...)`; `useDisplay().mobile` / `mdAndUp` |
319
+ | Nuxt: `<SLayout>` / `<SCarousel>` "failed to resolve component" | Import them from `@khsura/sui` — the module doesn't auto-register them |
320
+ | Birth-date picker without `min` → years older than 5 years can't be picked | Without `min`/`max`, `SDatePicker` / `SDatePickerInput` allow Jan 1 five years before `today` to Dec 31 five years after — pass `min` / `max` for wider ranges |
321
+ | `SDatePicker` model as a `Date` | A string: `'YYYY-MM-DD'`, `'YYYY-MM'` or `'YYYY'` by `type` |
322
+ | Popup activator binds only `v-on="on"` | Bind `v-on="on"` **and** `v-bind="attrs"` (SDialog, SMenu, SSnackbar) |
323
+ | `SMenu` without `location` opens on top of its button | `location="bottom"` |
324
+ | Named `SLayout` with un-`for`ed children | `for` on every child, or `name`/`for` on none |
325
+ | Items as `{ title, value }` / `{ label, id }` | `{ text, value }` or plain strings |
326
+ | `SSelect multiple / chips / clearable / placeholder` | `SAutocomplete` |
327
+ | Rule returns `false` | Return a message string |
328
+ | `if (!formRef.value.validate()) return` | `validate()` returns `true` when there **are** errors |
329
+ | `hideDetails` to hide just the error | `hideError` (`hideDetails` hides the label too) |
330
+ | Unknown props (`SDialog title`, `persistent-hint`, `app`) | Silently ignored — check `@types/definitions/props` |
331
+ | `:deep(.s_*) { … !important }` | A prop, a `createSUI({ components })` default, or theme colors |
332
+ | `alpha` hex in `presetColors` | Opaque hex + `color-mix()` where you need translucency |
333
+
334
+ ---
335
+
336
+ ## AI tooling — the SUI MCP server
337
+
338
+ `@khsura/sui-mcp` is a local stdio MCP server that answers from the `@khsura/sui` version the project installs. Set it up from the app's folder:
339
+
340
+ ```bash
341
+ npx -y @khsura/sui-mcp config # detects Claude Code / Cursor / VS Code / Windsurf and writes the config
342
+ npx -y @khsura/sui-mcp config --dry-run # print the planned changes only
343
+ npx -y @khsura/sui-mcp config --client cursor
344
+ ```
345
+
346
+ It merges a `sui` entry (`{ "command": "npx", "args": ["-y", "@khsura/sui-mcp"] }`) into `.mcp.json` (Claude Code), `.cursor/mcp.json` (Cursor) or `.vscode/mcp.json` (VS Code, under `servers` with `"type": "stdio"`), keeping other servers. For Windsurf it prints the snippet for `~/.codeium/windsurf/mcp_config.json`. Restart the client afterwards.
347
+
348
+ When the server is connected:
349
+
350
+ - Call `get_component_api` before using a component you have not checked; it reports the project's version. If it says the component needs a newer `@khsura/sui`, upgrade or pick another component.
351
+ - Start common patterns (app shell, validated form, activator overlays, data table, responsive grid, theme setup) from `get_recipe`.
352
+ - Run `validate_sui_template` on every template you write and fix every error before finishing.
353
+
354
+ Per-client snippets: the package README at https://www.npmjs.com/package/@khsura/sui-mcp and the **AI / MCP** page at https://sui.surakh.com/.
355
+
356
+ ---
357
+
358
+ ## Related skills
359
+
360
+ Use the installed plugin rather than copying these files into a project (`.claude/skills/`) — copies go stale when SUI updates.
361
+
362
+ - **sui-layout** — app shell (app bar, drawer, footer, grid)
363
+ - **sui-form** — validated forms and rules
364
+ - **sui-component** — any component: props, slots, events, examples (per-family references)
365
+ - **sui-utilities** — utility classes, directives, SCSS helpers
@@ -0,0 +1,111 @@
1
+ ---
2
+ name: sui-layout
3
+ description: Scaffold the app shell and page grid of a Vue or Nuxt app with @khsura/sui — SApp root, SLayout with SAppBar, SNavigationDrawer (left nav, right resizable panel), SMain, SFooter, SBottomNavigation, and the SContainer/SRow/SColumn grid. Use when creating an app layout, admin dashboard shell, sidebar/nav drawer, top bar, mobile bottom navigation, responsive grid, or fixing content hidden under the app bar/drawer or a drawer that doesn't attach.
4
+ argument-hint: [description of the layout you need]
5
+ ---
6
+
7
+ Scaffold a SUI layout for: $ARGUMENTS
8
+
9
+ Ask the user the following if not already clear from $ARGUMENTS:
10
+ 1. Which sections are needed? (app bar, navigation drawer, footer, bottom navigation, or just a content grid)
11
+ 2. What goes in each section? (title, nav links, route slots, etc.)
12
+ 3. Any color preferences?
13
+
14
+ Then generate a complete Vue SFC using these rules:
15
+
16
+ **Layout rules:**
17
+ - The app root is `<SApp>` (it provides theme colors and the popup container); `SLayout name="app"` goes inside it, at the app-shell level
18
+ - In Nuxt, `@khsura/sui-nuxt` 1.1.6+ registers `SLayout` and `SBottomNavigation` globally; on older versions import them from `@khsura/sui`
19
+ - All layout children must use `for="app"` to match the layout name. (`name`/`for` can be omitted together — everything then uses the app's default layout name — but never set `name` and leave `for` off: that child will not attach.)
20
+ - Do not add Vuetify's `app` prop to `SAppBar`/`SMain`/`SFooter` — it doesn't exist; `SLayout` handles placement
21
+ - `SAppBar for="app" position="fixed"` — top bar. Everything goes in the **default slot** (it has only `default` and `extension` slots — no `#prepend`/`#append`); order hamburger, title, `SSpacer`, actions. Without `position="fixed"` it scrolls away with the page and `elevate-on-scroll` does nothing
22
+ - `SNavigationDrawer for="app" v-model="drawer"` — sidebar
23
+ - Right-side panel (AI chat, details, inspector): a second `SNavigationDrawer for="app" location="right" persistent resizable v-model:width="panelWidth"`. A left and a right drawer share one layout and `SMain` makes room for both. `persistent` keeps it open when the user clicks in the content; `resizable` adds a drag handle (desktop only, clamped by `minWidth`/`maxWidth`, defaults 200/720)
24
+ - `SMain for="app"` — wraps all page content
25
+ - `SFooter for="app"` — optional bottom bar
26
+ - `SBottomNavigation for="app" v-model="activeNav" :height="56" active-class="…"` — mobile bottom tabs. Set `height` (it collapses without one) and `active-class` (there is no active styling otherwise)
27
+ - Below the `md` breakpoint the drawer becomes a mobile overlay; toggle it with `v-model`
28
+ - Keep one app-level `SLayout`. A nested/secondary `SLayout` does not offset its `SMain` for a drawer and `permanent` has no effect there — use the grid or `SSplitView` inside pages instead
29
+ - `SDivider` in a flex column collapses to zero width (it's an `<hr>` with auto margins) — give it `width: 100%` / `align-self: stretch`
30
+ - Use `SSpacer` inside `SAppBar` to push items right
31
+ - Use `SButton variant="icon"` + `SIcon` for toolbar icon buttons
32
+
33
+ **Grid rules:**
34
+ - `SContainer > SRow > SColumn` for responsive grids
35
+ - `SColumn` props: `:cols` (default), `:sm`, `:md`, `:lg` — values 1–12, `'auto'`, or `'grow'`
36
+ - `SRow` props: `align`, `justify`, `noGutters`, `fillHeight`, `dense`, `gap`
37
+
38
+ **Allowed prop values (use these, not CSS/flex names like flexEnd):**
39
+
40
+ | Component | Prop | Allowed values |
41
+ |-----------|------|----------------|
42
+ | **SRow** | `align` | `'start'` \| `'center'` \| `'end'` \| `'stretch'` \| `'baseline'` |
43
+ | **SRow** | `justify` | `'start'` \| `'center'` \| `'end'` \| `'spaceAround'` \| `'spaceBetween'` |
44
+ | **SColumn** | `cols`, `sm`, `md`, `lg` | `1`–`12` \| `'auto'` \| `'grow'` |
45
+ | **SColumn** | `alignSelf` | `'auto'` \| `'start'` \| `'center'` \| `'end'` \| `'stretch'` \| `'baseline'` \| etc. (CSS align-self values) |
46
+
47
+ Do **not** use `flexStart`, `flexEnd`, or `space-between` (kebab) — use `start`, `end`, and `spaceAround` / `spaceBetween` (camelCase).
48
+
49
+ **Imports:** all from `@khsura/sui`. Full props, slots and gotchas: [layout.md](../sui-component/references/layout.md). Icons (`mdi-*`) need `@mdi/font` loaded — see **sui-getting-started**.
50
+
51
+ **Reference template:**
52
+
53
+ ```vue
54
+ <!-- App.vue (Vue) or layouts/default.vue (Nuxt) -->
55
+ <template>
56
+ <SApp>
57
+ <SLayout name="app">
58
+ <SAppBar for="app" position="fixed" color="primary" elevate-on-scroll>
59
+ <SButton variant="icon" @click="drawer = !drawer">
60
+ <SIcon icon="mdi-menu" />
61
+ </SButton>
62
+ <SAppBarTitle>My App</SAppBarTitle>
63
+ <SSpacer />
64
+ <SButton variant="icon">
65
+ <SIcon icon="mdi-account" />
66
+ </SButton>
67
+ </SAppBar>
68
+
69
+ <SNavigationDrawer for="app" v-model="drawer">
70
+ <SList>
71
+ <SListItem
72
+ v-for="item in navItems"
73
+ :key="item.to"
74
+ :to="item.to"
75
+ link
76
+ >
77
+ <SListItemIcon><SIcon :icon="item.icon" /></SListItemIcon>
78
+ <SListItemContent>
79
+ <SListItemTitle>{{ item.title }}</SListItemTitle>
80
+ </SListItemContent>
81
+ </SListItem>
82
+ </SList>
83
+ </SNavigationDrawer>
84
+
85
+ <SMain for="app">
86
+ <SContainer>
87
+ <router-view />
88
+ </SContainer>
89
+ </SMain>
90
+ </SLayout>
91
+ </SApp>
92
+ </template>
93
+
94
+ <script setup lang="ts">
95
+ import { ref } from 'vue'
96
+ import {
97
+ SApp, SLayout, SAppBar, SAppBarTitle, SNavigationDrawer, SMain,
98
+ SContainer, SList, SListItem, SListItemIcon, SListItemContent,
99
+ SListItemTitle, SIcon, SButton, SSpacer,
100
+ } from '@khsura/sui'
101
+
102
+ const drawer = ref(false)
103
+
104
+ const navItems = [
105
+ { title: 'Home', icon: 'mdi-home', to: '/' },
106
+ { title: 'Settings', icon: 'mdi-cog', to: '/settings' },
107
+ ]
108
+ </script>
109
+ ```
110
+
111
+ Adapt this to match the user's requirements. Replace placeholder content, nav links, and colors with actual values.
@@ -0,0 +1,40 @@
1
+ ---
2
+ name: sui-utilities
3
+ description: Reference for @khsura/sui styling in a Vue or Nuxt app — s_* utility classes (spacing, display, flex, typography, colors, breakpoints), the v-scroll / v-resize directives, and SCSS helpers from @khsura/sui/helpers.scss (s_getPresetColor, s_getAppColor, s_elevation, mixins). Use when writing CSS/SCSS next to SUI components, picking a utility class, theming colors in component styles, using scroll/resize directives, or restyling a SUI component without fragile :deep() overrides.
4
+ argument-hint: [classes | directives | helpers | or a specific topic]
5
+ ---
6
+
7
+ Answer questions about SUI utility classes, directives, and SCSS helpers with the reference files bundled in this skill.
8
+
9
+ ## Reference files
10
+
11
+ - **Utility classes** (spacing, display, flex, grid, typography, colors, etc.): [docs/classes.md](docs/classes.md)
12
+ - **Vue directives** (v-scroll, etc.): [docs/directives.md](docs/directives.md)
13
+ - **SCSS helpers** (functions, mixins, variables): [docs/helpers.md](docs/helpers.md)
14
+
15
+ When the user asks about:
16
+ - **CSS utility classes** (e.g. `s_pa__4`, `s_display__flex`, breakpoints, spacing) → read [docs/classes.md](docs/classes.md)
17
+ - **Directives** (e.g. `v-scroll`, `v-scroll.self`) → read [docs/directives.md](docs/directives.md)
18
+ - **SCSS** (e.g. `s_getPresetColor`, `s_getAppColor`, mixins) → read [docs/helpers.md](docs/helpers.md)
19
+
20
+ ## Imports
21
+
22
+ | What | Import | Notes |
23
+ |---|---|---|
24
+ | Utility classes (+ reset, typography) | `import '@khsura/sui/base.css'` (or `@khsura/sui/style.scss`) | Loaded automatically by the Nuxt module |
25
+ | Component styles | `import '@khsura/sui/style.css'` | Also required in plain Vue; loaded by the Nuxt module |
26
+ | SCSS functions / mixins | `@use '@khsura/sui/helpers.scss' as *;` | Emits no CSS; keep the `.scss` extension |
27
+
28
+ ## Restyling SUI components — try these before `:deep(.s_*)`
29
+
30
+ Overriding internal classes (`:deep(.s_input__input)`, `.s_button { … !important }`) is the most common source of breakage after a SUI update, because internal class names and structure are not a public API. In order of preference:
31
+
32
+ 1. **A prop** — `color`, `size`, `dense`, `outlined` / `underlined` / `borderRadius`, `elevation`, `width` / `maxWidth`, `inputBackground` / `placeholderBackground` (SInput, STextarea).
33
+ 2. **An app-wide default** — `createSUI({ components: { SInput: { dense: true } } })` (see **sui-getting-started**).
34
+ 3. **Theme colors** — change `themes.light/dark.presetColors` / `appColors` instead of recoloring elements one by one.
35
+ 4. **Utility classes** on the component root — spacing, display, typography from [docs/classes.md](docs/classes.md).
36
+ 5. Only then a scoped `:deep()` override. Keep it narrow, use `s_getPresetColor` / `s_getAppColor` for colors, never hard-code hex values or use `!important`. Add a comment naming the missing prop so it can become a library feature.
37
+
38
+ Color helpers read CSS variables set by `<SApp>`, so they only resolve inside it.
39
+
40
+ Built-in state styling you should not re-implement: focus outlines, disabled colors, and the red error frame on form inputs (shown even with `hideError` / `hideDetails`).