@solid-design-system/mcp 0.0.1

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 (569) hide show
  1. package/CHANGELOG.md +1 -0
  2. package/LICENSE.md +10 -0
  3. package/README.md +408 -0
  4. package/dist/bin/start.d.ts +2 -0
  5. package/dist/bin/start.js +8 -0
  6. package/dist/build/build.d.ts +1 -0
  7. package/dist/build/build.js +36 -0
  8. package/dist/build/components.d.ts +9 -0
  9. package/dist/build/components.js +264 -0
  10. package/dist/build/icons.d.ts +12 -0
  11. package/dist/build/icons.js +79 -0
  12. package/dist/build/package-docs.d.ts +1 -0
  13. package/dist/build/package-docs.js +67 -0
  14. package/dist/build/static.d.ts +4 -0
  15. package/dist/build/static.js +39 -0
  16. package/dist/build/styles.d.ts +9 -0
  17. package/dist/build/styles.js +178 -0
  18. package/dist/build/templates.d.ts +1 -0
  19. package/dist/build/templates.js +239 -0
  20. package/dist/build/tokens.d.ts +4 -0
  21. package/dist/build/tokens.js +105 -0
  22. package/dist/server.d.ts +6 -0
  23. package/dist/server.js +20 -0
  24. package/dist/tools/components.d.ts +12 -0
  25. package/dist/tools/components.js +175 -0
  26. package/dist/tools/icon-search.d.ts +7 -0
  27. package/dist/tools/icon-search.js +184 -0
  28. package/dist/tools/index.d.ts +7 -0
  29. package/dist/tools/index.js +7 -0
  30. package/dist/tools/quickstart.d.ts +2 -0
  31. package/dist/tools/quickstart.js +104 -0
  32. package/dist/tools/styles.d.ts +12 -0
  33. package/dist/tools/styles.js +167 -0
  34. package/dist/tools/templates.d.ts +11 -0
  35. package/dist/tools/templates.js +146 -0
  36. package/dist/tools/tokens.d.ts +7 -0
  37. package/dist/tools/tokens.js +198 -0
  38. package/dist/tools/version.d.ts +7 -0
  39. package/dist/tools/version.js +50 -0
  40. package/dist/utilities/components.d.ts +8 -0
  41. package/dist/utilities/components.js +24 -0
  42. package/dist/utilities/config.d.ts +40 -0
  43. package/dist/utilities/config.js +44 -0
  44. package/dist/utilities/file.d.ts +12 -0
  45. package/dist/utilities/file.js +28 -0
  46. package/dist/utilities/index.d.ts +10 -0
  47. package/dist/utilities/index.js +10 -0
  48. package/dist/utilities/input.d.ts +9 -0
  49. package/dist/utilities/input.js +19 -0
  50. package/dist/utilities/metadata.d.ts +33 -0
  51. package/dist/utilities/metadata.js +55 -0
  52. package/dist/utilities/stdio.d.ts +14 -0
  53. package/dist/utilities/stdio.js +57 -0
  54. package/dist/utilities/styles.d.ts +16 -0
  55. package/dist/utilities/styles.js +47 -0
  56. package/dist/utilities/templates.d.ts +5 -0
  57. package/dist/utilities/templates.js +18 -0
  58. package/dist/utilities/tokens.d.ts +6 -0
  59. package/dist/utilities/tokens.js +42 -0
  60. package/dist/utilities/version.d.ts +28 -0
  61. package/dist/utilities/version.js +21 -0
  62. package/metadata/packages/components/docs/customization.md +101 -0
  63. package/metadata/packages/components/docs/form-controls.md +28 -0
  64. package/metadata/packages/components/docs/installation.md +271 -0
  65. package/metadata/packages/components/docs/localization.md +158 -0
  66. package/metadata/packages/components/docs/usage.md +182 -0
  67. package/metadata/packages/components/sd-accordion/info.md +82 -0
  68. package/metadata/packages/components/sd-accordion/stories/open.md +8 -0
  69. package/metadata/packages/components/sd-accordion/stories/summary.md +17 -0
  70. package/metadata/packages/components/sd-accordion-group/info.md +70 -0
  71. package/metadata/packages/components/sd-accordion-group/stories/close-others.md +24 -0
  72. package/metadata/packages/components/sd-audio/info.md +80 -0
  73. package/metadata/packages/components/sd-audio/stories/animated.md +34 -0
  74. package/metadata/packages/components/sd-audio/stories/inverted.md +36 -0
  75. package/metadata/packages/components/sd-audio/stories/no-timestamps.md +34 -0
  76. package/metadata/packages/components/sd-audio/stories/reverse.md +35 -0
  77. package/metadata/packages/components/sd-audio/stories/speed.md +38 -0
  78. package/metadata/packages/components/sd-audio/stories/transcript.md +36 -0
  79. package/metadata/packages/components/sd-badge/info.md +69 -0
  80. package/metadata/packages/components/sd-badge/stories/inverted.md +9 -0
  81. package/metadata/packages/components/sd-badge/stories/overflow.md +11 -0
  82. package/metadata/packages/components/sd-badge/stories/size.md +13 -0
  83. package/metadata/packages/components/sd-badge/stories/variant.md +40 -0
  84. package/metadata/packages/components/sd-brandshape/info.md +65 -0
  85. package/metadata/packages/components/sd-brandshape/stories/image-translate-y.md +13 -0
  86. package/metadata/packages/components/sd-brandshape/stories/shapes.md +22 -0
  87. package/metadata/packages/components/sd-brandshape/stories/transparent-variants.md +24 -0
  88. package/metadata/packages/components/sd-brandshape/stories/variant.md +95 -0
  89. package/metadata/packages/components/sd-breadcrumb/info.md +57 -0
  90. package/metadata/packages/components/sd-breadcrumb-item/info.md +42 -0
  91. package/metadata/packages/components/sd-button/info.md +120 -0
  92. package/metadata/packages/components/sd-button/stories/as-link.md +12 -0
  93. package/metadata/packages/components/sd-button/stories/disabled.md +10 -0
  94. package/metadata/packages/components/sd-button/stories/icon.md +10 -0
  95. package/metadata/packages/components/sd-button/stories/inverted.md +10 -0
  96. package/metadata/packages/components/sd-button/stories/loading.md +10 -0
  97. package/metadata/packages/components/sd-button/stories/size.md +13 -0
  98. package/metadata/packages/components/sd-button/stories/variants.md +15 -0
  99. package/metadata/packages/components/sd-button/stories/visually-disabled.md +23 -0
  100. package/metadata/packages/components/sd-carousel/info.md +99 -0
  101. package/metadata/packages/components/sd-carousel/stories/autoplay-interval.md +66 -0
  102. package/metadata/packages/components/sd-carousel/stories/autoplay.md +23 -0
  103. package/metadata/packages/components/sd-carousel/stories/fade.md +18 -0
  104. package/metadata/packages/components/sd-carousel/stories/inverted.md +17 -0
  105. package/metadata/packages/components/sd-carousel/stories/loop.md +17 -0
  106. package/metadata/packages/components/sd-carousel/stories/slides-per-move.md +49 -0
  107. package/metadata/packages/components/sd-carousel/stories/slides-per-page.md +23 -0
  108. package/metadata/packages/components/sd-carousel/stories/variant.md +32 -0
  109. package/metadata/packages/components/sd-carousel-item/info.md +26 -0
  110. package/metadata/packages/components/sd-checkbox/info.md +88 -0
  111. package/metadata/packages/components/sd-checkbox/stories/checked.md +7 -0
  112. package/metadata/packages/components/sd-checkbox/stories/disabled.md +7 -0
  113. package/metadata/packages/components/sd-checkbox/stories/indeterminate.md +7 -0
  114. package/metadata/packages/components/sd-checkbox/stories/invalid.md +22 -0
  115. package/metadata/packages/components/sd-checkbox/stories/required.md +7 -0
  116. package/metadata/packages/components/sd-checkbox/stories/size.md +14 -0
  117. package/metadata/packages/components/sd-checkbox/stories/visually-disabled.md +11 -0
  118. package/metadata/packages/components/sd-checkbox-group/info.md +71 -0
  119. package/metadata/packages/components/sd-checkbox-group/stories/help-text.md +13 -0
  120. package/metadata/packages/components/sd-checkbox-group/stories/label.md +10 -0
  121. package/metadata/packages/components/sd-checkbox-group/stories/orientation.md +19 -0
  122. package/metadata/packages/components/sd-checkbox-group/stories/size.md +21 -0
  123. package/metadata/packages/components/sd-combobox/info.md +170 -0
  124. package/metadata/packages/components/sd-combobox/stories/async-options.md +27 -0
  125. package/metadata/packages/components/sd-combobox/stories/clearable.md +13 -0
  126. package/metadata/packages/components/sd-combobox/stories/custom-filter.md +20 -0
  127. package/metadata/packages/components/sd-combobox/stories/disabled.md +13 -0
  128. package/metadata/packages/components/sd-combobox/stories/floating-label.md +14 -0
  129. package/metadata/packages/components/sd-combobox/stories/focus.md +11 -0
  130. package/metadata/packages/components/sd-combobox/stories/help-text.md +36 -0
  131. package/metadata/packages/components/sd-combobox/stories/icons.md +15 -0
  132. package/metadata/packages/components/sd-combobox/stories/invalid.md +29 -0
  133. package/metadata/packages/components/sd-combobox/stories/label.md +26 -0
  134. package/metadata/packages/components/sd-combobox/stories/max-options-visible.md +23 -0
  135. package/metadata/packages/components/sd-combobox/stories/multiple.md +24 -0
  136. package/metadata/packages/components/sd-combobox/stories/placeholder.md +13 -0
  137. package/metadata/packages/components/sd-combobox/stories/placement.md +29 -0
  138. package/metadata/packages/components/sd-combobox/stories/required.md +20 -0
  139. package/metadata/packages/components/sd-combobox/stories/search.md +13 -0
  140. package/metadata/packages/components/sd-combobox/stories/size.md +38 -0
  141. package/metadata/packages/components/sd-combobox/stories/suggestion-container-height.md +12 -0
  142. package/metadata/packages/components/sd-combobox/stories/valid.md +29 -0
  143. package/metadata/packages/components/sd-combobox/stories/visually-disabled.md +17 -0
  144. package/metadata/packages/components/sd-datepicker/info.md +159 -0
  145. package/metadata/packages/components/sd-datepicker/stories/alignment.md +10 -0
  146. package/metadata/packages/components/sd-datepicker/stories/disabled-dates.md +11 -0
  147. package/metadata/packages/components/sd-datepicker/stories/disabled-weekends.md +7 -0
  148. package/metadata/packages/components/sd-datepicker/stories/disabled.md +8 -0
  149. package/metadata/packages/components/sd-datepicker/stories/floating-label.md +8 -0
  150. package/metadata/packages/components/sd-datepicker/stories/help-text.md +11 -0
  151. package/metadata/packages/components/sd-datepicker/stories/invalid.md +15 -0
  152. package/metadata/packages/components/sd-datepicker/stories/label.md +11 -0
  153. package/metadata/packages/components/sd-datepicker/stories/placeholder.md +7 -0
  154. package/metadata/packages/components/sd-datepicker/stories/range.md +7 -0
  155. package/metadata/packages/components/sd-datepicker/stories/required.md +7 -0
  156. package/metadata/packages/components/sd-datepicker/stories/size.md +14 -0
  157. package/metadata/packages/components/sd-datepicker/stories/valid.md +16 -0
  158. package/metadata/packages/components/sd-datepicker/stories/visible-month.md +7 -0
  159. package/metadata/packages/components/sd-datepicker/stories/visually-disabled.md +11 -0
  160. package/metadata/packages/components/sd-dialog/info.md +89 -0
  161. package/metadata/packages/components/sd-dialog/stories/headline.md +22 -0
  162. package/metadata/packages/components/sd-dialog/stories/no-close-button.md +32 -0
  163. package/metadata/packages/components/sd-dialog/stories/open.md +72 -0
  164. package/metadata/packages/components/sd-divider/info.md +51 -0
  165. package/metadata/packages/components/sd-divider/stories/inverted.md +7 -0
  166. package/metadata/packages/components/sd-divider/stories/orientation.md +11 -0
  167. package/metadata/packages/components/sd-divider/stories/size.md +10 -0
  168. package/metadata/packages/components/sd-drawer/info.md +89 -0
  169. package/metadata/packages/components/sd-drawer/stories/no-header.md +16 -0
  170. package/metadata/packages/components/sd-drawer/stories/open.md +23 -0
  171. package/metadata/packages/components/sd-drawer/stories/placement.md +23 -0
  172. package/metadata/packages/components/sd-dropdown/info.md +86 -0
  173. package/metadata/packages/components/sd-dropdown/stories/disabled.md +8 -0
  174. package/metadata/packages/components/sd-dropdown/stories/distance.md +8 -0
  175. package/metadata/packages/components/sd-dropdown/stories/no-auto-size.md +10 -0
  176. package/metadata/packages/components/sd-dropdown/stories/no-flip.md +8 -0
  177. package/metadata/packages/components/sd-dropdown/stories/open.md +8 -0
  178. package/metadata/packages/components/sd-dropdown/stories/placement.md +20 -0
  179. package/metadata/packages/components/sd-dropdown/stories/rounded.md +10 -0
  180. package/metadata/packages/components/sd-dropdown/stories/skidding.md +8 -0
  181. package/metadata/packages/components/sd-dropdown/stories/stay-open.md +12 -0
  182. package/metadata/packages/components/sd-expandable/info.md +79 -0
  183. package/metadata/packages/components/sd-expandable/stories/gradient.md +75 -0
  184. package/metadata/packages/components/sd-expandable/stories/inverted.md +33 -0
  185. package/metadata/packages/components/sd-expandable/stories/open.md +60 -0
  186. package/metadata/packages/components/sd-flipcard/info.md +84 -0
  187. package/metadata/packages/components/sd-flipcard/stories/aspect-ratios.md +26 -0
  188. package/metadata/packages/components/sd-flipcard/stories/flip-direction.md +17 -0
  189. package/metadata/packages/components/sd-flipcard/stories/placement.md +17 -0
  190. package/metadata/packages/components/sd-flipcard/stories/variants.md +51 -0
  191. package/metadata/packages/components/sd-header/info.md +60 -0
  192. package/metadata/packages/components/sd-header/stories/fixed.md +9 -0
  193. package/metadata/packages/components/sd-icon/info.md +35 -0
  194. package/metadata/packages/components/sd-icon/stories/color.md +15 -0
  195. package/metadata/packages/components/sd-icon/stories/custom-libraries.md +119 -0
  196. package/metadata/packages/components/sd-icon/stories/label.md +12 -0
  197. package/metadata/packages/components/sd-icon/stories/libraries.md +38 -0
  198. package/metadata/packages/components/sd-icon/stories/name.md +36 -0
  199. package/metadata/packages/components/sd-icon/stories/size.md +10 -0
  200. package/metadata/packages/components/sd-include/info.md +20 -0
  201. package/metadata/packages/components/sd-input/info.md +176 -0
  202. package/metadata/packages/components/sd-input/stories/clearable.md +7 -0
  203. package/metadata/packages/components/sd-input/stories/disabled.md +7 -0
  204. package/metadata/packages/components/sd-input/stories/floating-label.md +8 -0
  205. package/metadata/packages/components/sd-input/stories/help-text.md +11 -0
  206. package/metadata/packages/components/sd-input/stories/icon.md +13 -0
  207. package/metadata/packages/components/sd-input/stories/invalid.md +14 -0
  208. package/metadata/packages/components/sd-input/stories/label.md +11 -0
  209. package/metadata/packages/components/sd-input/stories/max-length.md +7 -0
  210. package/metadata/packages/components/sd-input/stories/max.md +7 -0
  211. package/metadata/packages/components/sd-input/stories/min-length.md +7 -0
  212. package/metadata/packages/components/sd-input/stories/min.md +7 -0
  213. package/metadata/packages/components/sd-input/stories/pattern.md +7 -0
  214. package/metadata/packages/components/sd-input/stories/placeholder.md +7 -0
  215. package/metadata/packages/components/sd-input/stories/read-only.md +8 -0
  216. package/metadata/packages/components/sd-input/stories/required.md +7 -0
  217. package/metadata/packages/components/sd-input/stories/size.md +14 -0
  218. package/metadata/packages/components/sd-input/stories/spin-buttons.md +14 -0
  219. package/metadata/packages/components/sd-input/stories/toggle-password.md +8 -0
  220. package/metadata/packages/components/sd-input/stories/type.md +80 -0
  221. package/metadata/packages/components/sd-input/stories/valid.md +15 -0
  222. package/metadata/packages/components/sd-input/stories/value.md +7 -0
  223. package/metadata/packages/components/sd-input/stories/visually-disabled.md +11 -0
  224. package/metadata/packages/components/sd-link/info.md +80 -0
  225. package/metadata/packages/components/sd-link/stories/as-link.md +12 -0
  226. package/metadata/packages/components/sd-link/stories/disabled.md +7 -0
  227. package/metadata/packages/components/sd-link/stories/icon.md +14 -0
  228. package/metadata/packages/components/sd-link/stories/inverted.md +7 -0
  229. package/metadata/packages/components/sd-link/stories/size.md +13 -0
  230. package/metadata/packages/components/sd-link/stories/standalone.md +29 -0
  231. package/metadata/packages/components/sd-link/stories/visually-disabled.md +17 -0
  232. package/metadata/packages/components/sd-loader/info.md +54 -0
  233. package/metadata/packages/components/sd-loader/stories/default.md +5 -0
  234. package/metadata/packages/components/sd-loader/stories/size.md +15 -0
  235. package/metadata/packages/components/sd-loader/stories/variants.md +19 -0
  236. package/metadata/packages/components/sd-map-marker/info.md +74 -0
  237. package/metadata/packages/components/sd-map-marker/stories/animated.md +13 -0
  238. package/metadata/packages/components/sd-map-marker/stories/as-link.md +13 -0
  239. package/metadata/packages/components/sd-map-marker/stories/not-interactive.md +11 -0
  240. package/metadata/packages/components/sd-map-marker/stories/slot.md +8 -0
  241. package/metadata/packages/components/sd-map-marker/stories/state.md +47 -0
  242. package/metadata/packages/components/sd-map-marker/stories/variant.md +21 -0
  243. package/metadata/packages/components/sd-menu/info.md +68 -0
  244. package/metadata/packages/components/sd-menu/stories/checkmark.md +12 -0
  245. package/metadata/packages/components/sd-menu/stories/disabled.md +12 -0
  246. package/metadata/packages/components/sd-menu/stories/grouping.md +20 -0
  247. package/metadata/packages/components/sd-menu/stories/icon.md +80 -0
  248. package/metadata/packages/components/sd-menu/stories/submenu.md +18 -0
  249. package/metadata/packages/components/sd-menu-item/info.md +36 -0
  250. package/metadata/packages/components/sd-menu-item/stories/checkmark.md +5 -0
  251. package/metadata/packages/components/sd-menu-item/stories/disabled.md +5 -0
  252. package/metadata/packages/components/sd-menu-item/stories/icon-indent.md +8 -0
  253. package/metadata/packages/components/sd-navigation-item/info.md +98 -0
  254. package/metadata/packages/components/sd-navigation-item/stories/accordion.md +15 -0
  255. package/metadata/packages/components/sd-navigation-item/stories/as-link.md +7 -0
  256. package/metadata/packages/components/sd-navigation-item/stories/chevron.md +10 -0
  257. package/metadata/packages/components/sd-navigation-item/stories/current.md +8 -0
  258. package/metadata/packages/components/sd-navigation-item/stories/description.md +11 -0
  259. package/metadata/packages/components/sd-navigation-item/stories/disabled.md +5 -0
  260. package/metadata/packages/components/sd-navigation-item/stories/divider.md +6 -0
  261. package/metadata/packages/components/sd-navigation-item/stories/indented.md +8 -0
  262. package/metadata/packages/components/sd-navigation-item/stories/orientation.md +6 -0
  263. package/metadata/packages/components/sd-navigation-item/stories/relaxed.md +8 -0
  264. package/metadata/packages/components/sd-navigation-item/stories/separated.md +14 -0
  265. package/metadata/packages/components/sd-navigation-item/stories/size.md +13 -0
  266. package/metadata/packages/components/sd-navigation-item/stories/stacked.md +8 -0
  267. package/metadata/packages/components/sd-notification/info.md +135 -0
  268. package/metadata/packages/components/sd-notification/stories/closable.md +13 -0
  269. package/metadata/packages/components/sd-notification/stories/duration-indicator.md +15 -0
  270. package/metadata/packages/components/sd-notification/stories/duration.md +16 -0
  271. package/metadata/packages/components/sd-notification/stories/open.md +5 -0
  272. package/metadata/packages/components/sd-notification/stories/toast-bottom-center.md +53 -0
  273. package/metadata/packages/components/sd-notification/stories/toast-notification.md +67 -0
  274. package/metadata/packages/components/sd-notification/stories/variants.md +20 -0
  275. package/metadata/packages/components/sd-optgroup/info.md +55 -0
  276. package/metadata/packages/components/sd-optgroup/stories/disabled.md +13 -0
  277. package/metadata/packages/components/sd-option/info.md +65 -0
  278. package/metadata/packages/components/sd-option/stories/checkbox.md +19 -0
  279. package/metadata/packages/components/sd-option/stories/disabled.md +22 -0
  280. package/metadata/packages/components/sd-option/stories/selected.md +23 -0
  281. package/metadata/packages/components/sd-option/stories/size.md +26 -0
  282. package/metadata/packages/components/sd-popup/info.md +66 -0
  283. package/metadata/packages/components/sd-progress-bar/info.md +73 -0
  284. package/metadata/packages/components/sd-progress-bar/stories/custom-height.md +5 -0
  285. package/metadata/packages/components/sd-progress-bar/stories/inverted.md +9 -0
  286. package/metadata/packages/components/sd-progress-bar/stories/label.md +16 -0
  287. package/metadata/packages/components/sd-progress-bar/stories/loading.md +5 -0
  288. package/metadata/packages/components/sd-progress-bar/stories/value-formatter.md +20 -0
  289. package/metadata/packages/components/sd-progress-bar/stories/value-max.md +6 -0
  290. package/metadata/packages/components/sd-progress-bar/stories/value-position.md +11 -0
  291. package/metadata/packages/components/sd-quickfact/info.md +84 -0
  292. package/metadata/packages/components/sd-quickfact/stories/expandable.md +46 -0
  293. package/metadata/packages/components/sd-quickfact/stories/open.md +15 -0
  294. package/metadata/packages/components/sd-quickfact/stories/summary.md +13 -0
  295. package/metadata/packages/components/sd-radio/info.md +47 -0
  296. package/metadata/packages/components/sd-radio/stories/disabled.md +9 -0
  297. package/metadata/packages/components/sd-radio/stories/invalid.md +22 -0
  298. package/metadata/packages/components/sd-radio/stories/size.md +26 -0
  299. package/metadata/packages/components/sd-radio/stories/visually-disabled.md +11 -0
  300. package/metadata/packages/components/sd-radio-button/info.md +81 -0
  301. package/metadata/packages/components/sd-radio-button/stories/checked.md +20 -0
  302. package/metadata/packages/components/sd-radio-button/stories/disabled.md +20 -0
  303. package/metadata/packages/components/sd-radio-button/stories/icon.md +17 -0
  304. package/metadata/packages/components/sd-radio-button/stories/label.md +19 -0
  305. package/metadata/packages/components/sd-radio-button/stories/size.md +54 -0
  306. package/metadata/packages/components/sd-radio-button/stories/visually-disabled.md +26 -0
  307. package/metadata/packages/components/sd-radio-group/info.md +91 -0
  308. package/metadata/packages/components/sd-radio-group/stories/disabled.md +10 -0
  309. package/metadata/packages/components/sd-radio-group/stories/help-text.md +12 -0
  310. package/metadata/packages/components/sd-radio-group/stories/invalid.md +23 -0
  311. package/metadata/packages/components/sd-radio-group/stories/label.md +9 -0
  312. package/metadata/packages/components/sd-radio-group/stories/orientation.md +20 -0
  313. package/metadata/packages/components/sd-radio-group/stories/required.md +28 -0
  314. package/metadata/packages/components/sd-radio-group/stories/size.md +20 -0
  315. package/metadata/packages/components/sd-range/info.md +101 -0
  316. package/metadata/packages/components/sd-range/stories/tooltip-formatter.md +13 -0
  317. package/metadata/packages/components/sd-range-tick/info.md +21 -0
  318. package/metadata/packages/components/sd-scrollable/info.md +87 -0
  319. package/metadata/packages/components/sd-scrollable/stories/buttons.md +15 -0
  320. package/metadata/packages/components/sd-scrollable/stories/inset.md +15 -0
  321. package/metadata/packages/components/sd-scrollable/stories/orientation.md +32 -0
  322. package/metadata/packages/components/sd-scrollable/stories/scrollbar.md +15 -0
  323. package/metadata/packages/components/sd-scrollable/stories/shadows.md +15 -0
  324. package/metadata/packages/components/sd-scrollable/stories/step.md +15 -0
  325. package/metadata/packages/components/sd-select/info.md +155 -0
  326. package/metadata/packages/components/sd-select/stories/clearable.md +13 -0
  327. package/metadata/packages/components/sd-select/stories/disabled.md +13 -0
  328. package/metadata/packages/components/sd-select/stories/floating-label.md +14 -0
  329. package/metadata/packages/components/sd-select/stories/help-text.md +23 -0
  330. package/metadata/packages/components/sd-select/stories/invalid.md +30 -0
  331. package/metadata/packages/components/sd-select/stories/label.md +23 -0
  332. package/metadata/packages/components/sd-select/stories/max-options-visible.md +24 -0
  333. package/metadata/packages/components/sd-select/stories/multiple.md +14 -0
  334. package/metadata/packages/components/sd-select/stories/placeholder.md +13 -0
  335. package/metadata/packages/components/sd-select/stories/placement.md +24 -0
  336. package/metadata/packages/components/sd-select/stories/required.md +13 -0
  337. package/metadata/packages/components/sd-select/stories/size.md +34 -0
  338. package/metadata/packages/components/sd-select/stories/use-tags.md +14 -0
  339. package/metadata/packages/components/sd-select/stories/valid.md +29 -0
  340. package/metadata/packages/components/sd-select/stories/visually-disabled.md +17 -0
  341. package/metadata/packages/components/sd-skeleton/info.md +57 -0
  342. package/metadata/packages/components/sd-skeleton/stories/variants.md +13 -0
  343. package/metadata/packages/components/sd-spinner/info.md +53 -0
  344. package/metadata/packages/components/sd-spinner/stories/size.md +15 -0
  345. package/metadata/packages/components/sd-spinner/stories/variants.md +43 -0
  346. package/metadata/packages/components/sd-step/info.md +80 -0
  347. package/metadata/packages/components/sd-step/stories/as-link.md +9 -0
  348. package/metadata/packages/components/sd-step/stories/current.md +9 -0
  349. package/metadata/packages/components/sd-step/stories/description-and-label-using-attributes.md +7 -0
  350. package/metadata/packages/components/sd-step/stories/description.md +28 -0
  351. package/metadata/packages/components/sd-step/stories/disabled.md +9 -0
  352. package/metadata/packages/components/sd-step/stories/horizontal-inline.md +9 -0
  353. package/metadata/packages/components/sd-step/stories/icon.md +10 -0
  354. package/metadata/packages/components/sd-step/stories/label.md +7 -0
  355. package/metadata/packages/components/sd-step/stories/no-tail.md +9 -0
  356. package/metadata/packages/components/sd-step/stories/not-interactive.md +9 -0
  357. package/metadata/packages/components/sd-step/stories/orientation.md +15 -0
  358. package/metadata/packages/components/sd-step/stories/size.md +19 -0
  359. package/metadata/packages/components/sd-step/stories/waiting.md +9 -0
  360. package/metadata/packages/components/sd-step-group/info.md +74 -0
  361. package/metadata/packages/components/sd-step-group/stories/active-step.md +17 -0
  362. package/metadata/packages/components/sd-step-group/stories/horizontal-inline.md +17 -0
  363. package/metadata/packages/components/sd-step-group/stories/icon.md +20 -0
  364. package/metadata/packages/components/sd-step-group/stories/manual-state.md +23 -0
  365. package/metadata/packages/components/sd-step-group/stories/not-interactive.md +17 -0
  366. package/metadata/packages/components/sd-step-group/stories/orientation.md +39 -0
  367. package/metadata/packages/components/sd-step-group/stories/size.md +53 -0
  368. package/metadata/packages/components/sd-switch/info.md +79 -0
  369. package/metadata/packages/components/sd-switch/stories/checked.md +5 -0
  370. package/metadata/packages/components/sd-switch/stories/disabled.md +5 -0
  371. package/metadata/packages/components/sd-switch/stories/invalid.md +18 -0
  372. package/metadata/packages/components/sd-switch/stories/required.md +5 -0
  373. package/metadata/packages/components/sd-tab/info.md +42 -0
  374. package/metadata/packages/components/sd-tab/stories/active.md +44 -0
  375. package/metadata/packages/components/sd-tab/stories/disabled.md +20 -0
  376. package/metadata/packages/components/sd-tab/stories/icon.md +29 -0
  377. package/metadata/packages/components/sd-tab/stories/variant.md +42 -0
  378. package/metadata/packages/components/sd-tab/stories/visually-disabled.md +24 -0
  379. package/metadata/packages/components/sd-tab-group/info.md +88 -0
  380. package/metadata/packages/components/sd-tab-group/stories/activation.md +52 -0
  381. package/metadata/packages/components/sd-tab-group/stories/scrollable.md +66 -0
  382. package/metadata/packages/components/sd-tab-panel/info.md +26 -0
  383. package/metadata/packages/components/sd-tab-panel/stories/open.md +9 -0
  384. package/metadata/packages/components/sd-tag/info.md +75 -0
  385. package/metadata/packages/components/sd-tag/stories/as-link.md +12 -0
  386. package/metadata/packages/components/sd-tag/stories/disabled.md +10 -0
  387. package/metadata/packages/components/sd-tag/stories/icon.md +10 -0
  388. package/metadata/packages/components/sd-tag/stories/removable.md +22 -0
  389. package/metadata/packages/components/sd-tag/stories/selected.md +20 -0
  390. package/metadata/packages/components/sd-tag/stories/size.md +11 -0
  391. package/metadata/packages/components/sd-teaser/info.md +85 -0
  392. package/metadata/packages/components/sd-teaser/stories/breakpoint.md +28 -0
  393. package/metadata/packages/components/sd-teaser/stories/default-and-headline-slot.md +14 -0
  394. package/metadata/packages/components/sd-teaser/stories/distribution.md +13 -0
  395. package/metadata/packages/components/sd-teaser/stories/inset.md +12 -0
  396. package/metadata/packages/components/sd-teaser/stories/media-slot.md +14 -0
  397. package/metadata/packages/components/sd-teaser/stories/meta-slot.md +16 -0
  398. package/metadata/packages/components/sd-teaser/stories/reverse.md +14 -0
  399. package/metadata/packages/components/sd-teaser/stories/variant.md +34 -0
  400. package/metadata/packages/components/sd-teaser-media/info.md +86 -0
  401. package/metadata/packages/components/sd-teaser-media/stories/default-media-and-headline-slot.md +15 -0
  402. package/metadata/packages/components/sd-teaser-media/stories/expandable-slot.md +10 -0
  403. package/metadata/packages/components/sd-teaser-media/stories/meta-slot.md +9 -0
  404. package/metadata/packages/components/sd-teaser-media/stories/variant.md +78 -0
  405. package/metadata/packages/components/sd-textarea/info.md +132 -0
  406. package/metadata/packages/components/sd-textarea/stories/disabled.md +7 -0
  407. package/metadata/packages/components/sd-textarea/stories/floating-label.md +8 -0
  408. package/metadata/packages/components/sd-textarea/stories/help-text.md +11 -0
  409. package/metadata/packages/components/sd-textarea/stories/invalid.md +24 -0
  410. package/metadata/packages/components/sd-textarea/stories/label.md +11 -0
  411. package/metadata/packages/components/sd-textarea/stories/max-length.md +15 -0
  412. package/metadata/packages/components/sd-textarea/stories/min-length.md +15 -0
  413. package/metadata/packages/components/sd-textarea/stories/placeholder.md +7 -0
  414. package/metadata/packages/components/sd-textarea/stories/readonly.md +16 -0
  415. package/metadata/packages/components/sd-textarea/stories/required.md +7 -0
  416. package/metadata/packages/components/sd-textarea/stories/rows.md +11 -0
  417. package/metadata/packages/components/sd-textarea/stories/size.md +16 -0
  418. package/metadata/packages/components/sd-textarea/stories/valid.md +22 -0
  419. package/metadata/packages/components/sd-textarea/stories/visually-disabled.md +18 -0
  420. package/metadata/packages/components/sd-theme-listener/info.md +20 -0
  421. package/metadata/packages/components/sd-theme-listener/stories/default.md +31 -0
  422. package/metadata/packages/components/sd-tooltip/info.md +101 -0
  423. package/metadata/packages/components/sd-tooltip/stories/close-trigger.md +19 -0
  424. package/metadata/packages/components/sd-tooltip/stories/custom-trigger.md +20 -0
  425. package/metadata/packages/components/sd-tooltip/stories/disabled.md +5 -0
  426. package/metadata/packages/components/sd-tooltip/stories/hoist.md +7 -0
  427. package/metadata/packages/components/sd-tooltip/stories/placement.md +43 -0
  428. package/metadata/packages/components/sd-tooltip/stories/size.md +11 -0
  429. package/metadata/packages/components/sd-tooltip/stories/trigger.md +10 -0
  430. package/metadata/packages/components/sd-video/info.md +70 -0
  431. package/metadata/packages/components/sd-video/stories/playing.md +11 -0
  432. package/metadata/packages/components/sd-video/stories/video-element-with-poster-slot.md +24 -0
  433. package/metadata/packages/icons/default/content.json +2267 -0
  434. package/metadata/packages/icons/default/system.json +1112 -0
  435. package/metadata/packages/icons/sd-multi-theming/content.json +27 -0
  436. package/metadata/packages/icons/sd-multi-theming/system.json +307 -0
  437. package/metadata/packages/icons/sd-status-assets/status.json +37 -0
  438. package/metadata/packages/quickstart/docs/quickstart.md +50 -0
  439. package/metadata/packages/styles/docs/installation.md +161 -0
  440. package/metadata/packages/styles/docs/usage.md +11 -0
  441. package/metadata/packages/styles/sd-chip/info.md +49 -0
  442. package/metadata/packages/styles/sd-chip/stories/variants.md +40 -0
  443. package/metadata/packages/styles/sd-container/info.md +39 -0
  444. package/metadata/packages/styles/sd-container/stories/custom-padding.md +7 -0
  445. package/metadata/packages/styles/sd-container/stories/padding.md +7 -0
  446. package/metadata/packages/styles/sd-container/stories/triangle-border.md +26 -0
  447. package/metadata/packages/styles/sd-container/stories/triangle-color.md +12 -0
  448. package/metadata/packages/styles/sd-container/stories/triangle-position.md +27 -0
  449. package/metadata/packages/styles/sd-container/stories/variants.md +36 -0
  450. package/metadata/packages/styles/sd-copyright/info.md +41 -0
  451. package/metadata/packages/styles/sd-copyright/stories/no-shadow.md +13 -0
  452. package/metadata/packages/styles/sd-copyright/stories/orientation.md +16 -0
  453. package/metadata/packages/styles/sd-copyright/stories/placement.md +21 -0
  454. package/metadata/packages/styles/sd-copyright/stories/variants.md +15 -0
  455. package/metadata/packages/styles/sd-display/info.md +42 -0
  456. package/metadata/packages/styles/sd-display/stories/inverted.md +7 -0
  457. package/metadata/packages/styles/sd-display/stories/size.md +13 -0
  458. package/metadata/packages/styles/sd-flag/info.md +45 -0
  459. package/metadata/packages/styles/sd-flag/stories/variants.md +40 -0
  460. package/metadata/packages/styles/sd-footnotes/info.md +49 -0
  461. package/metadata/packages/styles/sd-footnotes/stories/inverted.md +11 -0
  462. package/metadata/packages/styles/sd-footnotes/stories/variants.md +19 -0
  463. package/metadata/packages/styles/sd-headline/info.md +56 -0
  464. package/metadata/packages/styles/sd-headline/stories/inline.md +14 -0
  465. package/metadata/packages/styles/sd-headline/stories/inverted.md +7 -0
  466. package/metadata/packages/styles/sd-headline/stories/sizes.md +21 -0
  467. package/metadata/packages/styles/sd-hidden-links/info.md +55 -0
  468. package/metadata/packages/styles/sd-hidden-links/stories/debug.md +12 -0
  469. package/metadata/packages/styles/sd-hidden-links/stories/multiple-links.md +13 -0
  470. package/metadata/packages/styles/sd-hidden-links/stories/stack-links.md +10 -0
  471. package/metadata/packages/styles/sd-hidden-links/stories/surrounding-content.md +54 -0
  472. package/metadata/packages/styles/sd-hidden-links/stories/title-for-multiple-links.md +34 -0
  473. package/metadata/packages/styles/sd-interactive/info.md +50 -0
  474. package/metadata/packages/styles/sd-interactive/stories/disabled.md +6 -0
  475. package/metadata/packages/styles/sd-interactive/stories/inverted.md +7 -0
  476. package/metadata/packages/styles/sd-interactive/stories/reset.md +30 -0
  477. package/metadata/packages/styles/sd-leadtext/info.md +41 -0
  478. package/metadata/packages/styles/sd-leadtext/stories/inverted.md +11 -0
  479. package/metadata/packages/styles/sd-leadtext/stories/size.md +19 -0
  480. package/metadata/packages/styles/sd-list/info.md +49 -0
  481. package/metadata/packages/styles/sd-list/stories/inverted.md +20 -0
  482. package/metadata/packages/styles/sd-list/stories/levels.md +62 -0
  483. package/metadata/packages/styles/sd-list/stories/orientation.md +34 -0
  484. package/metadata/packages/styles/sd-list/stories/variants.md +34 -0
  485. package/metadata/packages/styles/sd-mark/info.md +30 -0
  486. package/metadata/packages/styles/sd-media/info.md +50 -0
  487. package/metadata/packages/styles/sd-media/stories/description.md +8 -0
  488. package/metadata/packages/styles/sd-media/stories/inverted.md +14 -0
  489. package/metadata/packages/styles/sd-meta/info.md +38 -0
  490. package/metadata/packages/styles/sd-meta/stories/inverted.md +11 -0
  491. package/metadata/packages/styles/sd-meta/stories/pipe.md +7 -0
  492. package/metadata/packages/styles/sd-meta/stories/size.md +11 -0
  493. package/metadata/packages/styles/sd-meta/stories/variants.md +11 -0
  494. package/metadata/packages/styles/sd-pagination/info.md +60 -0
  495. package/metadata/packages/styles/sd-pagination/stories/hidden-headline.md +37 -0
  496. package/metadata/packages/styles/sd-pagination/stories/inverted.md +36 -0
  497. package/metadata/packages/styles/sd-pagination/stories/truncation.md +34 -0
  498. package/metadata/packages/styles/sd-pagination/stories/variants.md +51 -0
  499. package/metadata/packages/styles/sd-paragraph/info.md +39 -0
  500. package/metadata/packages/styles/sd-paragraph/stories/inverted.md +11 -0
  501. package/metadata/packages/styles/sd-paragraph/stories/size.md +19 -0
  502. package/metadata/packages/styles/sd-prose/info.md +49 -0
  503. package/metadata/packages/styles/sd-prose/stories/full-width.md +22 -0
  504. package/metadata/packages/styles/sd-prose/stories/inverted.md +11 -0
  505. package/metadata/packages/styles/sd-prose/stories/styling-options.md +108 -0
  506. package/metadata/packages/styles/sd-status-badge/info.md +44 -0
  507. package/metadata/packages/styles/sd-status-badge/stories/variants.md +27 -0
  508. package/metadata/packages/styles/sd-table/info.md +43 -0
  509. package/metadata/packages/styles/sd-table/stories/slot.md +11 -0
  510. package/metadata/packages/styles/sd-table-cell/info.md +61 -0
  511. package/metadata/packages/styles/sd-table-cell/stories/divider.md +19 -0
  512. package/metadata/packages/styles/sd-table-cell/stories/shadow.md +137 -0
  513. package/metadata/packages/styles/sd-table-cell/stories/variants.md +39 -0
  514. package/metadata/packages/templates/accordion-group.md +163 -0
  515. package/metadata/packages/templates/audio.md +194 -0
  516. package/metadata/packages/templates/autocomplete.md +213 -0
  517. package/metadata/packages/templates/badge.md +149 -0
  518. package/metadata/packages/templates/bottom-navigation.md +263 -0
  519. package/metadata/packages/templates/brandshape.md +81 -0
  520. package/metadata/packages/templates/breadcrumb.md +361 -0
  521. package/metadata/packages/templates/button.md +107 -0
  522. package/metadata/packages/templates/carousel.md +64 -0
  523. package/metadata/packages/templates/checkbox-group.md +81 -0
  524. package/metadata/packages/templates/chip.md +35 -0
  525. package/metadata/packages/templates/combobox.md +92 -0
  526. package/metadata/packages/templates/datepicker.md +44 -0
  527. package/metadata/packages/templates/dialog.md +270 -0
  528. package/metadata/packages/templates/drawer.md +185 -0
  529. package/metadata/packages/templates/dropdown.md +52 -0
  530. package/metadata/packages/templates/expandable.md +61 -0
  531. package/metadata/packages/templates/flag.md +38 -0
  532. package/metadata/packages/templates/flipcard.md +66 -0
  533. package/metadata/packages/templates/footnotes.md +80 -0
  534. package/metadata/packages/templates/forms.md +248 -0
  535. package/metadata/packages/templates/header-navigation.md +1951 -0
  536. package/metadata/packages/templates/headline.md +204 -0
  537. package/metadata/packages/templates/input.md +27 -0
  538. package/metadata/packages/templates/interactive.md +28 -0
  539. package/metadata/packages/templates/link.md +83 -0
  540. package/metadata/packages/templates/list.md +27 -0
  541. package/metadata/packages/templates/map-marker.md +15 -0
  542. package/metadata/packages/templates/mark.md +39 -0
  543. package/metadata/packages/templates/media.md +22 -0
  544. package/metadata/packages/templates/menu.md +93 -0
  545. package/metadata/packages/templates/notification.md +100 -0
  546. package/metadata/packages/templates/pagination.md +340 -0
  547. package/metadata/packages/templates/quickfact.md +267 -0
  548. package/metadata/packages/templates/quote.md +97 -0
  549. package/metadata/packages/templates/radio-button-group.md +24 -0
  550. package/metadata/packages/templates/radio-group.md +51 -0
  551. package/metadata/packages/templates/range.md +135 -0
  552. package/metadata/packages/templates/select.md +63 -0
  553. package/metadata/packages/templates/skeleton.md +32 -0
  554. package/metadata/packages/templates/status-badge.md +252 -0
  555. package/metadata/packages/templates/step-group.md +150 -0
  556. package/metadata/packages/templates/supernumber.md +178 -0
  557. package/metadata/packages/templates/switch.md +51 -0
  558. package/metadata/packages/templates/tab-group.md +157 -0
  559. package/metadata/packages/templates/table.md +2612 -0
  560. package/metadata/packages/templates/tag.md +230 -0
  561. package/metadata/packages/templates/teaser-media.md +164 -0
  562. package/metadata/packages/templates/teaser.md +320 -0
  563. package/metadata/packages/templates/tooltip.md +104 -0
  564. package/metadata/packages/templates/video.md +71 -0
  565. package/metadata/packages/tokens/docs/installation.md +445 -0
  566. package/metadata/packages/tokens/docs/usage.md +338 -0
  567. package/metadata/packages/tokens/themes.json +3 -0
  568. package/metadata/packages/tokens/tokens.json +185 -0
  569. package/package.json +76 -0
@@ -0,0 +1,73 @@
1
+ ## Overview
2
+
3
+ `<sd-progress-bar>` — Used to visually represent the progression of an activity.
4
+
5
+ ## API
6
+
7
+ ### Examples
8
+
9
+ Use the components tool by passing the args `component` and `example` for any of these combinations:
10
+
11
+ - component: sd-progress-bar, example: label
12
+ - component: sd-progress-bar, example: value-max
13
+ - component: sd-progress-bar, example: value-position
14
+ - component: sd-progress-bar, example: loading
15
+ - component: sd-progress-bar, example: custom-height
16
+ - component: sd-progress-bar, example: value-formatter
17
+ - component: sd-progress-bar, example: inverted
18
+
19
+ ### Key Properties
20
+
21
+ - prop.value: number|null, default=null — The current progress value.
22
+ - prop.max: number, default=100 — The maximum progress value.
23
+ - prop.label: string, default='' — The progress bar's label. If you need to display HTML, use the `label` slot instead.
24
+ - prop.valuePosition [attr: value-position]: 'right'|'bottom'|null, default=null — Displays the progress value on the right side of the indicator.
25
+ - prop.inverted: boolean, default=false — Inverts the progress bar's colors.
26
+ - prop.showLabel [attr: show-label]: boolean, default=false — Shows the label visually.
27
+ - prop.valueFormatter: (value: number) => string — A function used to format the progress-bar's value.
28
+ The value of the progress-bar is passed as the only argument.
29
+ The function should return a string to display in the value-position part.
30
+ - prop.dir: 'ltr'|'rtl'|'auto' — The element's directionality.
31
+ - prop.lang: string — The element's language.
32
+
33
+ ### Slots
34
+
35
+ - slot.label: The input's label. Alternatively, you can use the `label` attribute.
36
+
37
+ ### CSS Parts
38
+
39
+ - part.base: The component's base wrapper.
40
+ - part.value-right: Value's on the right side of the indicator.
41
+ - part.value-bottom: Value's on the bottom of the indicator.
42
+ - part.label: The label element.
43
+ - part.bar: The progress bar's container.
44
+
45
+ ## Guidelines
46
+
47
+ ### Use Cases
48
+
49
+ - Display the completion status of multi-step processes or task
50
+ - Communicate the loading or processing state of an activity, such as file uploads or data syncing.
51
+
52
+ ### Rules
53
+
54
+ ### Behavior
55
+
56
+ - Always reflect the actual progress accurately and avoid fake animations when real progress data is available.
57
+ - Avoid using a progress bar for binary states and use a status indicator instead.
58
+ - Pair the progress bar with a label or percentage to give users a clear sense of progress.
59
+
60
+ ### Value
61
+
62
+ - If displaying a value with a long copy prefer the bottom value-position.
63
+
64
+ ### Background
65
+
66
+ - Use light background options like white, neutral-100, primary-100, or use a primary background when inverted.
67
+
68
+ ### Accessibility
69
+
70
+ - Never omit label on functional progress bars (file uploads, form steps, loading states).
71
+ - The aria-hidden pattern is only appropriate when the progress information is either redundant or meaningless to screen reader users – for example, a visual scroll position tracker on a blog page.
72
+ - The label attribute is required in code. It provides an accessible name for the progress bar and must always be set, even when not visually displayed. For decorative uses (e.g. a blog article scroll indicator), add aria-hidden="true" to remove it from the accessibility tree entirely. In this case label can be omitted.
73
+ - Set a value for the label attribute to ensure aria-label and aria-description are set. Without it, the component defaults to aria-hidden="true", only appropriate for decorative progress bars (such as a scroll indicator).
@@ -0,0 +1,5 @@
1
+ Use the CSS property `--height` to adjust the height of the progress bar.
2
+
3
+ ```html
4
+ <div class="max-w-[300px]"><sd-progress-bar style="--height: 12px" value="35" max="100"></sd-progress-bar></div>
5
+ ```
@@ -0,0 +1,9 @@
1
+ Use the `inverted` attribute when displayed on primary background.
2
+
3
+ ```html
4
+ <div class="p-4 bg-primary">
5
+ <div class="max-w-[300px]">
6
+ <sd-progress-bar inverted value="35" max="100"></sd-progress-bar>
7
+ </div>
8
+ </div>
9
+ ```
@@ -0,0 +1,16 @@
1
+ Use the `label` attribute to add an accessible label to the progress bar. For labels that contain HTML, use the `label` slot instead.
2
+ This label is visually hidden by default, to display it, use the `show-label` attribute.
3
+ **Hint**: If no label is set the component receives an aria-hidden attribute of `true`.
4
+
5
+ ```html
6
+ <style>
7
+ sd-progress-bar {
8
+ height: 100%;
9
+ }
10
+ </style>
11
+ <div class="flex flex-col md:flex-row gap-4 items-end">
12
+ <sd-progress-bar value="35" max="100" label="Label"></sd-progress-bar>
13
+ <sd-progress-bar value="35" max="100" label="Label" show-label></sd-progress-bar>
14
+ <sd-progress-bar value="35" max="100" show-label><div slot="label" class="text-lg">Label slot</div></sd-progress-bar>
15
+ </div>
16
+ ```
@@ -0,0 +1,5 @@
1
+ The progress bar will display an indeterminate animation automatically when no value is provided, or if is set to `null`, `undefined` or `NaN`.
2
+
3
+ ```html
4
+ <div class="max-w-[300px]"><sd-progress-bar max="100"></sd-progress-bar></div>
5
+ ```
@@ -0,0 +1,20 @@
1
+ Use the `valueFormatter` to customize the display of the value in the progress bar. The function receives the current value as a parameter and should return a string to display in the value-position part.
2
+
3
+ ```html
4
+ <div class="flex flex-col gap-4">
5
+ <div class="value-formatter-story-right">
6
+ <sd-progress-bar class="max-w-[300px]" value="4" max="10" value-position="right"></sd-progress-bar>
7
+ </div>
8
+ <div class="value-formatter-story-bottom max-w-[300px]">
9
+ <sd-progress-bar value="4" max="10" value-position="bottom"></sd-progress-bar>
10
+ </div>
11
+ </div>
12
+ <script>
13
+ Promise.all([customElements.whenDefined('sd-progress-bar')]).then(() => {
14
+ document.querySelector('.value-formatter-story-right sd-progress-bar').valueFormatter = value =>
15
+ value + ' of 10 MB';
16
+ document.querySelector('.value-formatter-story-bottom sd-progress-bar').valueFormatter = value =>
17
+ '€' + value + 'k of €10k spent';
18
+ });
19
+ </script>
20
+ ```
@@ -0,0 +1,6 @@
1
+ Use the `value` and `max` attributes to set the progress value and maximum value of the progress bar.
2
+ The default value is `0` and the default max is `100`. The component will calculate the percentage based on these two values.
3
+
4
+ ```html
5
+ <div class="max-w-[300px]"><sd-progress-bar value="35" max="70"></sd-progress-bar></div>
6
+ ```
@@ -0,0 +1,11 @@
1
+ Use the `value-position` attribute to set the position of the value on the progress bar.
2
+
3
+ - `right`
4
+ - `bottom`
5
+
6
+ ```html
7
+ <div class="flex flex-col gap-4">
8
+ <sd-progress-bar class="max-w-[300px]" value="35" max="100" value-position="right"></sd-progress-bar>
9
+ <sd-progress-bar class="max-w-[300px]" value="35" max="100" value-position="bottom"></sd-progress-bar>
10
+ </div>
11
+ ```
@@ -0,0 +1,84 @@
1
+ ## Overview
2
+
3
+ `<sd-quickfact>` — Used to present brief information and expand to show additional content.
4
+
5
+ ## API
6
+
7
+ ### Examples
8
+
9
+ Use the components tool by passing the args `component` and `example` for any of these combinations:
10
+
11
+ - component: sd-quickfact, example: expandable
12
+ - component: sd-quickfact, example: open
13
+ - component: sd-quickfact, example: summary
14
+
15
+ ### Key Properties
16
+
17
+ - prop.expandable: boolean, default=false — Determines if the quickfact is not interactive. When set to `true`, the quickfact will not expand or collapse.
18
+ - prop.open: boolean, default=false — Indicates whether or not the accordion is open. You can toggle this attribute to show and hide the accordion, or you
19
+ can use the `show()` and `hide()` methods and this attribute will reflect the accordion' open state.
20
+ - prop.summary: string — The summary to show in the header. If you need to display HTML, use the `summary` slot instead.
21
+ - prop.dir: 'ltr'|'rtl'|'auto' — The element's directionality.
22
+ - prop.lang: string — The element's language.
23
+
24
+ ### Events
25
+
26
+ - event.sd-show: Emitted when the accordion opens.
27
+ - event.sd-after-show: Emitted after the accordion opens and all animations are complete.
28
+ - event.sd-hide: Emitted when the accordion closes.
29
+ - event.sd-after-hide: Emitted after the accordion closes and all animations are complete.
30
+
31
+ ### Slots
32
+
33
+ - slot.icon: Optional icon to show in the header. Works best with `<sd-icon>`.
34
+ - slot.default: The accordion main content.
35
+ - slot.summary: The accordion summary. Alternatively, you can use the `summary` attribute.
36
+ - slot.expand-icon: Optional expand icon to use instead of the default. Works best with `<sd-icon>`.
37
+ - slot.collapse-icon: Optional collapse icon to use instead of the default. Works best with `<sd-icon>`.
38
+
39
+ ### CSS Parts
40
+
41
+ - part.icon: The container that wraps the icon.
42
+ - part.base: The component's base wrapper.
43
+ - part.header: The header that wraps both the summary and the expand/collapse icon.
44
+ - part.summary: The container that wraps the summary.
45
+ - part.summary-icon: The container that wraps the expand/collapse icons.
46
+ - part.summary-border: The container that wraps the currently active accordions border.
47
+ - part.content: The container that wraps the accordion content slot.
48
+ - part.content\_\_slot: The accordion content slot.
49
+
50
+ ## Guidelines
51
+
52
+ ### Use Cases
53
+
54
+ - Highlight important statistics or facts within a page to draw attention.
55
+ - Summarize complex data into digestible pieces of information.
56
+ - Emphasize critical points or findings alongside articles or reports.
57
+ - Showcase key benefits or features of a product in promotional materials.
58
+
59
+ ### Rules
60
+
61
+ ### Content
62
+
63
+ - Focus on one key piece of information per quick fact.
64
+ - Ensure each quick fact can be understood independently, even when part of a group.
65
+ - Avoid using in contexts where detailed explanations are required.
66
+
67
+ ### Behavior
68
+
69
+ - Use the expandable attribute for supplementary information that isn’t essential for initial understanding.
70
+ - Limit the number of quick facts on a single page to avoid overwhelming users.
71
+ - Include a single quick fact when needed, even though they are typically presented in groups.
72
+
73
+ ### Icon and Responsiveness
74
+
75
+ - Make sure the chosen content icon logically illustrates the key fact you want to communicate.
76
+ - Adapt the style according to screen size (e.g., ≤ 414px width for mobile screens) to maintain responsiveness.
77
+
78
+ ### Background
79
+
80
+ - Use light background options such as white, neutral-100, or primary-100.
81
+
82
+ ### Accessibility
83
+
84
+ - Ensure that the summaries are short, concise and unique as they’re used as the label for the button.
@@ -0,0 +1,46 @@
1
+ **Disclaimer:** Due to a bug with Storybook Controls, the `expandable` attribute controls might not behave as expected. Please refresh the page if you wish to reset the controls.
2
+ You can follow this issue here: https://github.com/storybookjs/storybook/issues/28634
3
+ /
4
+ export default {
5
+ title: 'Components/sd-quickfact',
6
+ component: 'sd-quickfact',
7
+ tags: ['!dev', 'autodocs'],
8
+ args: overrideArgs([
9
+ {
10
+ type: 'slot',
11
+ name: 'summary',
12
+ value: `<div slot="summary" class="flex flex-col sm:gap-4"> <p class="text-base font-normal leading-normal sm:text-4xl sm:leading-tight">Lorem Ipsum</p>
13
+
14
+ <div class="text-base font-normal leading-normal sm:text-xl">Con sectetur adipiscing elit</div></div>`
15
+ },
16
+ {
17
+ type: 'slot',
18
+ name: 'icon',
19
+ value: `<sd-icon name="content/image" color="currentColor" aria-hidden="true" library="default" slot="icon"></sd-icon>`
20
+ }
21
+ ]),
22
+ argTypes,
23
+ parameters: {
24
+ ...parameters,
25
+ design: {
26
+ type: 'figma',
27
+ url: 'https://www.figma.com/design/YDktJcseQIIQbsuCpoKS4V/Component-Docs?node-id=2592-3469&node-type=section&t=5PpAC3TA3kYF7ufX-0'
28
+ }
29
+ }
30
+ };
31
+ export const Default = {
32
+ render: (args: any) => {
33
+ return generateTemplate({
34
+ args
35
+ });
36
+ }
37
+ };
38
+ /**
39
+ Use the `expandable` attribute to make the quickfact item expandable.
40
+
41
+ ```html
42
+ <sd-quickfact expandable="" summary="Lorem Ipsum">
43
+ <sd-icon name="content/image" color="currentColor" aria-hidden="true" library="default" slot="icon"></sd-icon>
44
+ <div class="slot slot--border slot--text h-16">Default slot</div>
45
+ </sd-quickfact>
46
+ ```
@@ -0,0 +1,15 @@
1
+ Use the `open` attribute to set the state of the quickfact.
2
+
3
+ ```html
4
+ <div class="flex flex-col gap-12">
5
+ <sd-quickfact expandable="" open summary="Open">
6
+ <sd-icon name="content/image" color="currentColor" aria-hidden="true" library="default" slot="icon"></sd-icon>
7
+ <div class="slot slot--border slot--text h-16">Default slot</div>
8
+ </sd-quickfact>
9
+
10
+ <sd-quickfact expandable="" summary="Closed">
11
+ <sd-icon name="content/image" color="currentColor" aria-hidden="true" library="default" slot="icon"></sd-icon>
12
+ <div class="slot slot--border slot--text h-16">Default slot</div>
13
+ </sd-quickfact>
14
+ </div>
15
+ ```
@@ -0,0 +1,13 @@
1
+ Use the `summary` attribute to provide the text in the quickfact.
2
+ For summaries that contain HTML, use the summary slot instead.
3
+
4
+ ```html
5
+ <sd-quickfact>
6
+ <sd-icon name="content/image" color="currentColor" aria-hidden="true" library="default" slot="icon"></sd-icon>
7
+ <div slot="summary" class="flex flex-col sm:gap-4">
8
+ <p class="text-base font-normal leading-normal sm:text-4xl sm:leading-tight">Summary</p>
9
+ <div class="text-base font-normal leading-normal sm:text-xl">Description</div>
10
+ </div>
11
+ <div class="slot slot--border slot--text h-16">Default slot</div>
12
+ </sd-quickfact>
13
+ ```
@@ -0,0 +1,47 @@
1
+ ## Overview
2
+
3
+ `<sd-radio>` — Used to allow the user to select a single option from a group.
4
+
5
+ ## API
6
+
7
+ ### Examples
8
+
9
+ Use the components tool by passing the args `component` and `example` for any of these combinations:
10
+
11
+ - component: sd-radio, example: size
12
+ - component: sd-radio, example: disabled
13
+ - component: sd-radio, example: visually-disabled
14
+ - component: sd-radio, example: invalid
15
+
16
+ ### Key Properties
17
+
18
+ - prop.size: 'lg'|'md'|'sm', default='lg' — The radio's size.
19
+ - prop.disabled: boolean, default=false — A Boolean attribute which, if present, disables the radio.
20
+ - prop.visuallyDisabled [attr: visually-disabled]: boolean, default=false — A Boolean attribute which, if present, disables the radio.
21
+ - prop.value: string — The radio's value. When selected, the radio group will receive this value.
22
+ - prop.invalid: boolean, default=false — A Boolean attribute which, if present, marks the radio Button valid or invalid
23
+ - prop.dir: 'ltr'|'rtl'|'auto' — The element's directionality.
24
+ - prop.lang: string — The element's language.
25
+
26
+ ### Events
27
+
28
+ - event.sd-blur: Emitted when the control loses focus.
29
+ - event.sd-focus: Emitted when the control gains focus.
30
+
31
+ ### Slots
32
+
33
+ - slot.default: The radio's label.
34
+
35
+ ### CSS Parts
36
+
37
+ - part.base: The component's base wrapper.
38
+ - part.control--unchecked: The radio control when the radio is unchecked.
39
+ - part.control--checked: The radio control when the radio is checked.
40
+ - part.checked: The dot inside the radio component when the radio is checked.
41
+ - part.label: The container that wraps the radio's label.
42
+
43
+ ## Guidelines
44
+
45
+ ### Accessibility
46
+
47
+ - Use the "visually disabled" attribute to keep disabled elements focusable, hoverable, and able to show tooltips, as they’re otherwise removed from the tab order and inaccessible to screen readers.
@@ -0,0 +1,9 @@
1
+ Use the `disabled` attribute to disable an input radio.
2
+
3
+ ```html
4
+ <sd-radio-group label="Disabled radio in group" value="1">
5
+ <sd-radio value="1">Radio 1</sd-radio>
6
+ <sd-radio value="2" disabled>Radio 2</sd-radio>
7
+ <sd-radio value="3">Radio 3</sd-radio>
8
+ </sd-radio-group>
9
+ ```
@@ -0,0 +1,22 @@
1
+ The component gets “invalid” state when the form is not valid.
2
+ For an invalid radio-group (since radios always come in groups) an error-text underneath the group is mandatory.
3
+
4
+ ```html
5
+ <form id="invalid-form" class="flex flex-col gap-8">
6
+ <sd-radio-group name="radio-group" id="invalid-radio" required>
7
+ <sd-radio value="1">Radio 1</sd-radio>
8
+ <sd-radio value="2">Radio 2</sd-radio>
9
+ <sd-radio value="3">Radio 3</sd-radio>
10
+ <label slot="label">Invalid Group</label>
11
+ </sd-radio-group>
12
+ </form>
13
+ <script type="module">
14
+ // Wait for custom elements to be defined
15
+ await Promise.all([customElements.whenDefined('sd-radio-group'), customElements.whenDefined('sd-button')]).then(
16
+ () => {
17
+ const input = document.getElementById('invalid-radio');
18
+ input.reportValidity();
19
+ }
20
+ );
21
+ </script>
22
+ ```
@@ -0,0 +1,26 @@
1
+ Use the `size` attribute to change the size of the input radio (`md` equals `lg` but added for consistency reason on input elements):
2
+
3
+ - `lg` (default)
4
+ - `md`
5
+ - `sm`
6
+ This attribute affects the font-size within the element, while the element itself remains the same size.
7
+
8
+ ```html
9
+ <div class="flex gap-12">
10
+ <sd-radio-group size="lg" value="1">
11
+ <sd-radio value="1">Radio 1</sd-radio>
12
+ <sd-radio value="2">Radio 2</sd-radio>
13
+ <sd-radio value="3">Radio 3</sd-radio>
14
+ </sd-radio-group>
15
+ <sd-radio-group size="md" value="1">
16
+ <sd-radio value="1">Radio 1</sd-radio>
17
+ <sd-radio value="2">Radio 2</sd-radio>
18
+ <sd-radio value="3">Radio 3</sd-radio>
19
+ </sd-radio-group>
20
+ <sd-radio-group size="sm" value="1">
21
+ <sd-radio value="1">Radio 1</sd-radio>
22
+ <sd-radio value="2">Radio 2</sd-radio>
23
+ <sd-radio value="3">Radio 3</sd-radio>
24
+ </sd-radio-group>
25
+ </div>
26
+ ```
@@ -0,0 +1,11 @@
1
+ Use the `visually-disabled` attribute to style the component as if it was disabled and enable `aria-disabled` to allow it to be reachable by screen readers.
2
+ **Hint:** When using this attribute, make sure to provide ways to inform the user why the element is disabled and how to enable it. This can be done by using the `help-text` attribute or wrapping the element in a sd-tooltip.
3
+ **Accessibility Hint:** Disabling elements is not recommended for accessibility reasons.
4
+
5
+ ```html
6
+ <sd-radio-group label="Visually disabled" value="1">
7
+ <sd-tooltip content="Visually disabled" trigger="hover focus" size="sm">
8
+ <sd-radio value="1" visually-disabled>Radio 1</sd-radio>
9
+ </sd-tooltip>
10
+ </sd-radio-group>
11
+ ```
@@ -0,0 +1,81 @@
1
+ ## Overview
2
+
3
+ `<sd-radio-button>` — Used to switch between different options by selecting a single option from a group.
4
+
5
+ ## API
6
+
7
+ ### Examples
8
+
9
+ Use the components tool by passing the args `component` and `example` for any of these combinations:
10
+
11
+ - component: sd-radio-button, example: size
12
+ - component: sd-radio-button, example: checked
13
+ - component: sd-radio-button, example: label
14
+ - component: sd-radio-button, example: icon
15
+ - component: sd-radio-button, example: disabled
16
+ - component: sd-radio-button, example: visually-disabled
17
+
18
+ ### Key Properties
19
+
20
+ - prop.size: 'lg'|'md'|'sm', default='lg' — The radio button's size.
21
+ - prop.disabled: boolean, default=false — Disables the radio button.
22
+ - prop.visuallyDisabled [attr: visually-disabled]: boolean, default=false — Styles the radio-button as if it was disabled and enables aria-disabled
23
+ - prop.value: string — The radio's value. When selected, the radio group will receive this value.
24
+ - prop.dir: 'ltr'|'rtl'|'auto' — The element's directionality.
25
+ - prop.lang: string — The element's language.
26
+
27
+ ### Events
28
+
29
+ - event.sd-blur: Emitted when the button loses focus.
30
+ - event.sd-focus: Emitted when the button gains focus.
31
+
32
+ ### Slots
33
+
34
+ - slot.default: The radio button's label.
35
+ - slot.icon: A presentational icon.
36
+
37
+ ### CSS Parts
38
+
39
+ - part.base: The component's base wrapper.
40
+ - part.button: The internal `<button>` element.
41
+ - part.button--checked: The internal button element when the radio button is checked.
42
+ - part.icon: The container that wraps the icon.
43
+ - part.label: The container that wraps the radio button's label.
44
+
45
+ ## Guidelines
46
+
47
+ ### Use Cases
48
+
49
+ - Select one option from a group where one is already preselected.
50
+ - Switch between groups of settings.
51
+ - Filter views by a parent category.
52
+
53
+ ### Rules
54
+
55
+ ### Content
56
+
57
+ - Include icons to support each option visually if possible.
58
+ - Label each choice clearly.
59
+
60
+ ### Behavior
61
+
62
+ - Don’t use as input method in forms, for they are not form elements. Use [sd-radio](./?path=/docs/components-sd-radio--docs) instead.
63
+ - Slot inside of an [sd-radio-group](./?path=/docs/components-sd-radio-group--docs).
64
+ - Use only in groups, as they are designed to allow the user to activate one of several options. To work with a single option, use [sd-checkbox](./?path=/docs/components-sd-checkbox--docs) instead.
65
+ - Pre-select always a “default” value; there is no invalid state.
66
+ - Limit the number of options in the group. Users should be able to retain all options available and not be overwhelmed by them.
67
+
68
+ ### Styling
69
+
70
+ - All radio buttons in the group must be styled similarly, e.g., each one is labelled with both text and icon.
71
+ - Avoid styling options only with icons if they are not common symbols, to prevent ambiguous interpretations.
72
+
73
+ ### Background
74
+
75
+ - Use with light background options such as white, neutral-100, or primary-100.
76
+
77
+ ### Accessibility
78
+
79
+ - Provide meaningful alternative text for icon-only radio buttons.
80
+ - Communicate the group’s function—such as filtering or view switching—through clear context or labels.
81
+ - Use the "visually disabled" attribute to keep disabled elements focusable, hoverable, and able to show tooltips, as they’re otherwise removed from the tab order and inaccessible to screen readers.
@@ -0,0 +1,20 @@
1
+ Use the `checked` attribute to set the state of the radio button to checked.
2
+
3
+ ```html
4
+ <div class="flex gap-12">
5
+ <sd-radio-group value="1">
6
+ <sd-radio-button value="1">
7
+ <sd-icon name="system/image" slot="icon"></sd-icon>
8
+ Label
9
+ </sd-radio-button>
10
+ <sd-radio-button value="2">
11
+ <sd-icon name="system/image" slot="icon"></sd-icon>
12
+ Label
13
+ </sd-radio-button>
14
+ <sd-radio-button value="3">
15
+ <sd-icon name="system/image" slot="icon"></sd-icon>
16
+ Label
17
+ </sd-radio-button>
18
+ </sd-radio-group>
19
+ </div>
20
+ ```
@@ -0,0 +1,20 @@
1
+ Use the `disabled` attribute to disable an input radio button.
2
+
3
+ ```html
4
+ <div class="flex gap-12">
5
+ <sd-radio-group value="1">
6
+ <sd-radio-button value="1">
7
+ <sd-icon name="system/image" slot="icon"></sd-icon>
8
+ Label
9
+ </sd-radio-button>
10
+ <sd-radio-button value="2" disabled>
11
+ <sd-icon name="system/image" slot="icon"></sd-icon>
12
+ Disabled
13
+ </sd-radio-button>
14
+ <sd-radio-button value="3">
15
+ <sd-icon name="system/image" slot="icon"></sd-icon>
16
+ Label
17
+ </sd-radio-button>
18
+ </sd-radio-group>
19
+ </div>
20
+ ```
@@ -0,0 +1,17 @@
1
+ Use the `icon` slot to add system icons.
2
+
3
+ ```html
4
+ <div class="flex gap-12">
5
+ <sd-radio-group value="1">
6
+ <sd-radio-button value="1">
7
+ <sd-icon label="landscape" name="system/image" slot="icon"></sd-icon>
8
+ </sd-radio-button>
9
+ <sd-radio-button value="2">
10
+ <sd-icon label="landscape" name="system/image" slot="icon"></sd-icon>
11
+ </sd-radio-button>
12
+ <sd-radio-button value="3">
13
+ <sd-icon label="landscape" name="system/image" slot="icon"></sd-icon>
14
+ </sd-radio-button>
15
+ </sd-radio-group>
16
+ </div>
17
+ ```
@@ -0,0 +1,19 @@
1
+ Use the `default` slot to add a label.
2
+
3
+ ```html
4
+ <div class="flex gap-12">
5
+ <sd-radio-group value="1">
6
+ <sd-radio-button value="1">
7
+ <div>Label</div>
8
+ </sd-radio-button>
9
+
10
+ <sd-radio-button value="2">
11
+ <div>Label</div>
12
+ </sd-radio-button>
13
+
14
+ <sd-radio-button value="3">
15
+ <div>Label</div>
16
+ </sd-radio-button>
17
+ </sd-radio-group>
18
+ </div>
19
+ ```
@@ -0,0 +1,54 @@
1
+ Use the `size` attribute to change the size:
2
+
3
+ - `lg` (default)
4
+ - `md`
5
+ - `sm`
6
+
7
+ ```html
8
+ <div class="flex flex-col gap-12">
9
+ <sd-radio-group value="1" size="lg">
10
+ <sd-radio-button value="1">
11
+ <sd-icon name="system/image" slot="icon"></sd-icon>
12
+ Large
13
+ </sd-radio-button>
14
+ <sd-radio-button value="2">
15
+ <sd-icon name="system/image" slot="icon"></sd-icon>
16
+ Large
17
+ </sd-radio-button>
18
+ <sd-radio-button value="3">
19
+ <sd-icon name="system/image" slot="icon"></sd-icon>
20
+ Large
21
+ </sd-radio-button>
22
+ </sd-radio-group>
23
+
24
+ <sd-radio-group value="1" size="md">
25
+ <sd-radio-button value="1" size="md">
26
+ <sd-icon name="system/image" slot="icon"></sd-icon>
27
+ Medium
28
+ </sd-radio-button>
29
+ <sd-radio-button value="2" size="md">
30
+ <sd-icon name="system/image" slot="icon"></sd-icon>
31
+ Medium
32
+ </sd-radio-button>
33
+ <sd-radio-button value="3" size="md">
34
+ <sd-icon name="system/image" slot="icon"></sd-icon>
35
+ Medium
36
+ </sd-radio-button>
37
+ </sd-radio-group>
38
+
39
+ <sd-radio-group value="1" size="sm">
40
+ <sd-radio-button value="1">
41
+ <sd-icon name="system/image" slot="icon"></sd-icon>
42
+ Small
43
+ </sd-radio-button>
44
+ <sd-radio-button value="2">
45
+ <sd-icon name="system/image" slot="icon"></sd-icon>
46
+ Small
47
+ </sd-radio-button>
48
+ <sd-radio-button value="3">
49
+ <sd-icon name="system/image" slot="icon"></sd-icon>
50
+ Small
51
+ </sd-radio-button>
52
+ </sd-radio-group>
53
+ </div>
54
+ ```