@h-ai/ui 0.1.0-alpha9 → 1.0.0-beta.10

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 (380) hide show
  1. package/README.en.md +1062 -0
  2. package/README.ja.md +1062 -0
  3. package/README.md +696 -119
  4. package/auto-import.d.ts +49 -0
  5. package/auto-import.js +51 -69
  6. package/dist/components/compounds/Accordion.svelte +30 -3
  7. package/dist/components/compounds/Accordion.svelte.d.ts +37 -1
  8. package/dist/components/compounds/ActionSheet.svelte +35 -8
  9. package/dist/components/compounds/ActionSheet.svelte.d.ts +41 -1
  10. package/dist/components/compounds/Alert.svelte +24 -15
  11. package/dist/components/compounds/Alert.svelte.d.ts +14 -3
  12. package/dist/components/compounds/AppBar.svelte +37 -9
  13. package/dist/components/compounds/AppBar.svelte.d.ts +36 -1
  14. package/dist/components/compounds/BottomNav.svelte +68 -8
  15. package/dist/components/compounds/BottomNav.svelte.d.ts +51 -1
  16. package/dist/components/compounds/Breadcrumb.svelte +18 -5
  17. package/dist/components/compounds/Breadcrumb.svelte.d.ts +23 -2
  18. package/dist/components/compounds/Calendar.svelte +31 -12
  19. package/dist/components/compounds/Calendar.svelte.d.ts +23 -7
  20. package/dist/components/compounds/Card.svelte +17 -5
  21. package/dist/components/compounds/Card.svelte.d.ts +13 -2
  22. package/dist/components/compounds/Combobox.svelte +124 -42
  23. package/dist/components/compounds/Combobox.svelte.d.ts +42 -20
  24. package/dist/components/compounds/Confirm.svelte +32 -9
  25. package/dist/components/compounds/Confirm.svelte.d.ts +24 -2
  26. package/dist/components/compounds/DataTable.svelte +317 -33
  27. package/dist/components/compounds/DataTable.svelte.d.ts +28 -14
  28. package/dist/components/compounds/DatePicker.svelte +62 -18
  29. package/dist/components/compounds/DatePicker.svelte.d.ts +27 -8
  30. package/dist/components/compounds/Drawer.svelte +179 -22
  31. package/dist/components/compounds/Drawer.svelte.d.ts +24 -2
  32. package/dist/components/compounds/Dropdown.svelte +19 -5
  33. package/dist/components/compounds/Dropdown.svelte.d.ts +13 -2
  34. package/dist/components/compounds/Empty.svelte +22 -9
  35. package/dist/components/compounds/Empty.svelte.d.ts +23 -2
  36. package/dist/components/compounds/FilterBar.svelte +82 -0
  37. package/dist/components/compounds/FilterBar.svelte.d.ts +39 -0
  38. package/dist/components/compounds/Form.svelte +59 -16
  39. package/dist/components/compounds/Form.svelte.d.ts +23 -2
  40. package/dist/components/compounds/FormField.svelte +99 -16
  41. package/dist/components/compounds/FormField.svelte.d.ts +23 -2
  42. package/dist/components/compounds/FormLayout.svelte +71 -0
  43. package/dist/components/compounds/FormLayout.svelte.d.ts +17 -0
  44. package/dist/components/compounds/InfiniteScroll.svelte +34 -7
  45. package/dist/components/compounds/InfiniteScroll.svelte.d.ts +37 -1
  46. package/dist/components/compounds/JsonViewer.svelte +214 -0
  47. package/dist/components/compounds/JsonViewer.svelte.d.ts +26 -0
  48. package/dist/components/compounds/MessageBoxContainer.svelte +34 -0
  49. package/dist/components/compounds/MessageBoxContainer.svelte.d.ts +25 -0
  50. package/dist/components/compounds/MessageBoxDialog.svelte +209 -0
  51. package/dist/components/compounds/MessageBoxDialog.svelte.d.ts +29 -0
  52. package/dist/components/compounds/MessageContainer.svelte +24 -0
  53. package/dist/components/compounds/MessageContainer.svelte.d.ts +18 -0
  54. package/dist/components/compounds/Modal.svelte +348 -73
  55. package/dist/components/compounds/Modal.svelte.d.ts +13 -2
  56. package/dist/components/compounds/PageHeader.svelte +44 -20
  57. package/dist/components/compounds/PageHeader.svelte.d.ts +24 -9
  58. package/dist/components/compounds/Pagination.svelte +139 -105
  59. package/dist/components/compounds/Pagination.svelte.d.ts +23 -2
  60. package/dist/components/compounds/Popover.svelte +124 -25
  61. package/dist/components/compounds/Popover.svelte.d.ts +23 -2
  62. package/dist/components/compounds/PullRefresh.svelte +35 -8
  63. package/dist/components/compounds/PullRefresh.svelte.d.ts +35 -1
  64. package/dist/components/compounds/Result.svelte +17 -4
  65. package/dist/components/compounds/Result.svelte.d.ts +23 -2
  66. package/dist/components/compounds/SafeArea.svelte +30 -3
  67. package/dist/components/compounds/SafeArea.svelte.d.ts +35 -1
  68. package/dist/components/compounds/Skeleton.svelte +19 -7
  69. package/dist/components/compounds/Skeleton.svelte.d.ts +13 -2
  70. package/dist/components/compounds/Steps.svelte +17 -4
  71. package/dist/components/compounds/Steps.svelte.d.ts +23 -2
  72. package/dist/components/compounds/SwipeCell.svelte +30 -3
  73. package/dist/components/compounds/SwipeCell.svelte.d.ts +40 -1
  74. package/dist/components/compounds/TableToolbar.svelte +289 -0
  75. package/dist/components/compounds/TableToolbar.svelte.d.ts +69 -0
  76. package/dist/components/compounds/Tabs.svelte +84 -14
  77. package/dist/components/compounds/Tabs.svelte.d.ts +13 -2
  78. package/dist/components/compounds/TagInput.svelte +51 -33
  79. package/dist/components/compounds/TagInput.svelte.d.ts +23 -2
  80. package/dist/components/compounds/Timeline.svelte +30 -3
  81. package/dist/components/compounds/Timeline.svelte.d.ts +37 -1
  82. package/dist/components/compounds/ToastContainer.svelte +397 -28
  83. package/dist/components/compounds/ToastContainer.svelte.d.ts +27 -1
  84. package/dist/components/compounds/Tooltip.svelte +143 -9
  85. package/dist/components/compounds/Tooltip.svelte.d.ts +25 -2
  86. package/dist/components/compounds/accordion-types.d.ts +10 -1
  87. package/dist/components/compounds/action-sheet-types.d.ts +9 -0
  88. package/dist/components/compounds/bottom-nav-types.d.ts +9 -0
  89. package/dist/components/compounds/index.d.ts +7 -0
  90. package/dist/components/compounds/index.js +11 -0
  91. package/dist/components/compounds/swipe-cell-types.d.ts +9 -0
  92. package/dist/components/compounds/timeline-types.d.ts +9 -0
  93. package/dist/components/control-size.d.ts +35 -0
  94. package/dist/components/control-size.js +26 -0
  95. package/dist/components/primitives/Avatar.svelte +19 -5
  96. package/dist/components/primitives/Avatar.svelte.d.ts +13 -2
  97. package/dist/components/primitives/Badge.svelte +16 -4
  98. package/dist/components/primitives/Badge.svelte.d.ts +13 -2
  99. package/dist/components/primitives/BareButton.svelte +26 -12
  100. package/dist/components/primitives/BareButton.svelte.d.ts +23 -2
  101. package/dist/components/primitives/BareInput.svelte +57 -35
  102. package/dist/components/primitives/BareInput.svelte.d.ts +23 -2
  103. package/dist/components/primitives/Button.svelte +30 -9
  104. package/dist/components/primitives/Button.svelte.d.ts +13 -2
  105. package/dist/components/primitives/Checkbox.svelte +24 -5
  106. package/dist/components/primitives/Checkbox.svelte.d.ts +23 -2
  107. package/dist/components/primitives/IconButton.svelte +35 -10
  108. package/dist/components/primitives/IconButton.svelte.d.ts +23 -2
  109. package/dist/components/primitives/Input.svelte +56 -26
  110. package/dist/components/primitives/Input.svelte.d.ts +13 -2
  111. package/dist/components/primitives/Progress.svelte +17 -4
  112. package/dist/components/primitives/Progress.svelte.d.ts +23 -2
  113. package/dist/components/primitives/Radio.svelte +17 -4
  114. package/dist/components/primitives/Radio.svelte.d.ts +22 -2
  115. package/dist/components/primitives/Range.svelte +31 -4
  116. package/dist/components/primitives/Range.svelte.d.ts +37 -1
  117. package/dist/components/primitives/Rating.svelte +32 -5
  118. package/dist/components/primitives/Rating.svelte.d.ts +37 -1
  119. package/dist/components/primitives/Select.svelte +404 -47
  120. package/dist/components/primitives/Select.svelte.d.ts +23 -2
  121. package/dist/components/primitives/Spinner.svelte +17 -4
  122. package/dist/components/primitives/Spinner.svelte.d.ts +23 -2
  123. package/dist/components/primitives/Switch.svelte +22 -4
  124. package/dist/components/primitives/Switch.svelte.d.ts +23 -2
  125. package/dist/components/primitives/Tag.svelte +17 -4
  126. package/dist/components/primitives/Tag.svelte.d.ts +23 -2
  127. package/dist/components/primitives/Textarea.svelte +75 -30
  128. package/dist/components/primitives/Textarea.svelte.d.ts +24 -2
  129. package/dist/components/primitives/ToggleCheckbox.svelte +24 -10
  130. package/dist/components/primitives/ToggleCheckbox.svelte.d.ts +23 -2
  131. package/dist/components/primitives/ToggleInput.svelte +24 -10
  132. package/dist/components/primitives/ToggleInput.svelte.d.ts +23 -2
  133. package/dist/components/primitives/ToggleRadio.svelte +24 -10
  134. package/dist/components/primitives/ToggleRadio.svelte.d.ts +23 -2
  135. package/dist/components/scenes/ai/AiDocumentDownloadMenu.svelte +54 -23
  136. package/dist/components/scenes/ai/AiDocumentDownloadMenu.svelte.d.ts +30 -1
  137. package/dist/components/scenes/ai/AiDocumentEditor.svelte +3428 -693
  138. package/dist/components/scenes/ai/AiDocumentEditor.svelte.d.ts +26 -1
  139. package/dist/components/scenes/ai/MarkdownRenderer.svelte +119 -116
  140. package/dist/components/scenes/ai/MarkdownRenderer.svelte.d.ts +31 -1
  141. package/dist/components/scenes/ai/code-preview.d.ts +46 -0
  142. package/dist/components/scenes/ai/code-preview.js +141 -0
  143. package/dist/components/scenes/ai/document-download.d.ts +52 -0
  144. package/dist/components/scenes/ai/document-download.js +300 -79
  145. package/dist/components/scenes/ai/document-parse.d.ts +101 -11
  146. package/dist/components/scenes/ai/document-parse.js +212 -48
  147. package/dist/components/scenes/ai/document-types.d.ts +292 -75
  148. package/dist/components/scenes/ai/editor-markdown-extensions.d.ts +27 -0
  149. package/dist/components/scenes/ai/editor-markdown-extensions.js +216 -0
  150. package/dist/components/scenes/ai/highlight.d.ts +37 -0
  151. package/dist/components/scenes/ai/highlight.js +177 -0
  152. package/dist/components/scenes/ai/index.d.ts +5 -2
  153. package/dist/components/scenes/ai/index.js +3 -0
  154. package/dist/components/scenes/ai/markdown-parse.d.ts +11 -3
  155. package/dist/components/scenes/ai/markdown-parse.js +85 -47
  156. package/dist/components/scenes/ai/mermaid-host-sync.d.ts +72 -0
  157. package/dist/components/scenes/ai/mermaid-host-sync.js +65 -0
  158. package/dist/components/scenes/ai/mermaid-render.d.ts +30 -0
  159. package/dist/components/scenes/ai/mermaid-render.js +61 -0
  160. package/dist/components/scenes/ai/safe-html.d.ts +64 -0
  161. package/dist/components/scenes/ai/safe-html.js +345 -0
  162. package/dist/components/scenes/ai/table/AiTableEditor.svelte +1692 -0
  163. package/dist/components/scenes/ai/table/AiTableEditor.svelte.d.ts +32 -0
  164. package/dist/components/scenes/ai/table/table-types.d.ts +181 -0
  165. package/dist/components/scenes/ai/table/table-types.js +1 -0
  166. package/dist/components/scenes/app/FeedbackDetail.svelte +236 -0
  167. package/dist/components/scenes/app/FeedbackDetail.svelte.d.ts +40 -0
  168. package/dist/components/scenes/app/FeedbackForm.svelte +337 -0
  169. package/dist/components/scenes/app/FeedbackForm.svelte.d.ts +72 -0
  170. package/dist/components/scenes/app/FeedbackList.svelte +150 -0
  171. package/dist/components/scenes/app/FeedbackList.svelte.d.ts +28 -0
  172. package/dist/components/scenes/app/FeedbackModal.svelte +65 -139
  173. package/dist/components/scenes/app/FeedbackModal.svelte.d.ts +14 -39
  174. package/dist/components/scenes/app/FeedbackRecorder.svelte +154 -0
  175. package/dist/components/scenes/app/FeedbackRecorder.svelte.d.ts +9 -0
  176. package/dist/components/scenes/app/FeedbackReplay.svelte +142 -0
  177. package/dist/components/scenes/app/FeedbackReplay.svelte.d.ts +7 -0
  178. package/dist/components/scenes/app/FeedbackScreenshot.svelte +120 -0
  179. package/dist/components/scenes/app/FeedbackScreenshot.svelte.d.ts +8 -0
  180. package/dist/components/scenes/app/LanguageSwitch.svelte +38 -21
  181. package/dist/components/scenes/app/LanguageSwitch.svelte.d.ts +33 -20
  182. package/dist/components/scenes/app/SettingsLayout.svelte +115 -0
  183. package/dist/components/scenes/app/SettingsLayout.svelte.d.ts +54 -0
  184. package/dist/components/scenes/app/SettingsModal.svelte +33 -7
  185. package/dist/components/scenes/app/SettingsModal.svelte.d.ts +27 -1
  186. package/dist/components/scenes/app/ThemeColorPicker.svelte +240 -0
  187. package/dist/components/scenes/app/ThemeColorPicker.svelte.d.ts +57 -0
  188. package/dist/components/scenes/app/ThemeSelector.svelte +87 -26
  189. package/dist/components/scenes/app/ThemeSelector.svelte.d.ts +26 -7
  190. package/dist/components/scenes/app/ThemeToggle.svelte +27 -6
  191. package/dist/components/scenes/app/ThemeToggle.svelte.d.ts +24 -5
  192. package/dist/components/scenes/app/WorkspaceLayout.svelte +64 -0
  193. package/dist/components/scenes/app/WorkspaceLayout.svelte.d.ts +36 -0
  194. package/dist/components/scenes/app/feedback-functions.d.ts +57 -0
  195. package/dist/components/scenes/app/feedback-functions.js +107 -0
  196. package/dist/components/scenes/app/feedback-types.d.ts +224 -0
  197. package/dist/components/scenes/app/feedback-types.js +1 -0
  198. package/dist/components/scenes/app/index.d.ts +8 -1
  199. package/dist/components/scenes/app/index.js +7 -1
  200. package/dist/components/scenes/charts/Chart.svelte +186 -0
  201. package/dist/components/scenes/charts/Chart.svelte.d.ts +24 -0
  202. package/dist/components/scenes/charts/ChartLoadError.svelte +13 -0
  203. package/dist/components/scenes/charts/ChartLoadError.svelte.d.ts +6 -0
  204. package/dist/components/scenes/charts/DashboardGrid.svelte +34 -0
  205. package/dist/components/scenes/charts/DashboardGrid.svelte.d.ts +15 -0
  206. package/dist/components/scenes/charts/MetricCard.svelte +52 -0
  207. package/dist/components/scenes/charts/MetricCard.svelte.d.ts +15 -0
  208. package/dist/components/scenes/charts/ReportCard.svelte +48 -0
  209. package/dist/components/scenes/charts/ReportCard.svelte.d.ts +15 -0
  210. package/dist/components/scenes/charts/chart-presets.d.ts +15 -0
  211. package/dist/components/scenes/charts/chart-presets.js +19 -0
  212. package/dist/components/scenes/charts/chart-theme.d.ts +47 -0
  213. package/dist/components/scenes/charts/chart-theme.js +68 -0
  214. package/dist/components/scenes/charts/chart-types.d.ts +164 -0
  215. package/dist/components/scenes/charts/chart-types.js +7 -0
  216. package/dist/components/scenes/charts/dashboard-types.d.ts +79 -0
  217. package/dist/components/scenes/charts/dashboard-types.js +1 -0
  218. package/dist/components/scenes/charts/index.d.ts +12 -0
  219. package/dist/components/scenes/charts/index.js +10 -0
  220. package/dist/components/scenes/charts/renderers/AreaChart.svelte +19 -0
  221. package/dist/components/scenes/charts/renderers/AreaChart.svelte.d.ts +6 -0
  222. package/dist/components/scenes/charts/renderers/BarChart.svelte +19 -0
  223. package/dist/components/scenes/charts/renderers/BarChart.svelte.d.ts +6 -0
  224. package/dist/components/scenes/charts/renderers/LineChart.svelte +625 -0
  225. package/dist/components/scenes/charts/renderers/LineChart.svelte.d.ts +33 -0
  226. package/dist/components/scenes/charts/renderers/PieChart.svelte +19 -0
  227. package/dist/components/scenes/charts/renderers/PieChart.svelte.d.ts +6 -0
  228. package/dist/components/scenes/charts/renderers/ScatterChart.svelte +19 -0
  229. package/dist/components/scenes/charts/renderers/ScatterChart.svelte.d.ts +6 -0
  230. package/dist/components/scenes/crud/CrudDeleteConfirm.svelte +29 -11
  231. package/dist/components/scenes/crud/CrudDeleteConfirm.svelte.d.ts +13 -1
  232. package/dist/components/scenes/crud/CrudDetailDrawer.svelte +77 -22
  233. package/dist/components/scenes/crud/CrudDetailDrawer.svelte.d.ts +19 -4
  234. package/dist/components/scenes/crud/CrudDetailPanel.svelte +242 -0
  235. package/dist/components/scenes/crud/CrudDetailPanel.svelte.d.ts +66 -0
  236. package/dist/components/scenes/crud/CrudEditPanel.svelte +365 -0
  237. package/dist/components/scenes/crud/CrudEditPanel.svelte.d.ts +48 -0
  238. package/dist/components/scenes/crud/CrudFilterBar.svelte +17 -85
  239. package/dist/components/scenes/crud/CrudFilterBar.svelte.d.ts +13 -25
  240. package/dist/components/scenes/crud/CrudPage.svelte +564 -185
  241. package/dist/components/scenes/crud/CrudPage.svelte.d.ts +137 -51
  242. package/dist/components/scenes/crud/crud-controller.svelte.d.ts +335 -0
  243. package/dist/components/scenes/crud/crud-controller.svelte.js +276 -0
  244. package/dist/components/scenes/crud/crud-form-validation.d.ts +16 -0
  245. package/dist/components/scenes/crud/crud-form-validation.js +51 -0
  246. package/dist/components/scenes/crud/crud-types.d.ts +136 -43
  247. package/dist/components/scenes/crud/index.d.ts +9 -3
  248. package/dist/components/scenes/crud/index.js +8 -3
  249. package/dist/components/scenes/crud/nav-adapter.d.ts +50 -0
  250. package/dist/components/scenes/crud/nav-adapter.js +39 -0
  251. package/dist/components/scenes/crypto/EncryptedInput.svelte +63 -28
  252. package/dist/components/scenes/crypto/EncryptedInput.svelte.d.ts +38 -3
  253. package/dist/components/scenes/crypto/HashDisplay.svelte +30 -22
  254. package/dist/components/scenes/crypto/HashDisplay.svelte.d.ts +24 -1
  255. package/dist/components/scenes/crypto/SignatureDisplay.svelte +41 -40
  256. package/dist/components/scenes/crypto/SignatureDisplay.svelte.d.ts +24 -1
  257. package/dist/components/scenes/error/ErrorPage.svelte +135 -0
  258. package/dist/components/scenes/error/ErrorPage.svelte.d.ts +50 -0
  259. package/dist/components/scenes/error/error-presets.d.ts +60 -0
  260. package/dist/components/scenes/error/error-presets.js +51 -0
  261. package/dist/components/scenes/error/index.d.ts +8 -0
  262. package/dist/components/scenes/error/index.js +8 -0
  263. package/dist/components/scenes/guide/GuideHost.svelte +56 -0
  264. package/dist/components/scenes/guide/GuideHost.svelte.d.ts +35 -0
  265. package/dist/components/scenes/guide/GuideHostContent.svelte +136 -0
  266. package/dist/components/scenes/guide/GuideHostContent.svelte.d.ts +43 -0
  267. package/dist/components/scenes/guide/HelpCenter.svelte +135 -0
  268. package/dist/components/scenes/guide/HelpCenter.svelte.d.ts +40 -0
  269. package/dist/components/scenes/guide/index.d.ts +2 -0
  270. package/dist/components/scenes/guide/index.js +2 -0
  271. package/dist/components/scenes/iam/AgreementNotice.svelte +48 -0
  272. package/dist/components/scenes/iam/AgreementNotice.svelte.d.ts +7 -0
  273. package/dist/components/scenes/iam/AuthPanel.svelte +226 -0
  274. package/dist/components/scenes/iam/AuthPanel.svelte.d.ts +29 -0
  275. package/dist/components/scenes/iam/AuthShell.svelte +160 -0
  276. package/dist/components/scenes/iam/AuthShell.svelte.d.ts +56 -0
  277. package/dist/components/scenes/iam/ChangePasswordForm.svelte +84 -63
  278. package/dist/components/scenes/iam/ChangePasswordForm.svelte.d.ts +13 -1
  279. package/dist/components/scenes/iam/ForgotPasswordForm.svelte +113 -89
  280. package/dist/components/scenes/iam/ForgotPasswordForm.svelte.d.ts +24 -1
  281. package/dist/components/scenes/iam/LoginForm.svelte +215 -117
  282. package/dist/components/scenes/iam/LoginForm.svelte.d.ts +13 -1
  283. package/dist/components/scenes/iam/PasswordInput.svelte +79 -32
  284. package/dist/components/scenes/iam/PasswordInput.svelte.d.ts +30 -4
  285. package/dist/components/scenes/iam/PermGuard.svelte +21 -11
  286. package/dist/components/scenes/iam/PermGuard.svelte.d.ts +30 -0
  287. package/dist/components/scenes/iam/ReauthenticationDialog.svelte +68 -0
  288. package/dist/components/scenes/iam/ReauthenticationDialog.svelte.d.ts +17 -0
  289. package/dist/components/scenes/iam/RegisterForm.svelte +129 -116
  290. package/dist/components/scenes/iam/RegisterForm.svelte.d.ts +13 -1
  291. package/dist/components/scenes/iam/ResetPasswordForm.svelte +101 -88
  292. package/dist/components/scenes/iam/ResetPasswordForm.svelte.d.ts +13 -1
  293. package/dist/components/scenes/iam/SensitiveOperationsForm.svelte +76 -0
  294. package/dist/components/scenes/iam/SensitiveOperationsForm.svelte.d.ts +21 -0
  295. package/dist/components/scenes/iam/SessionRecoveryDialog.svelte +64 -0
  296. package/dist/components/scenes/iam/SessionRecoveryDialog.svelte.d.ts +22 -0
  297. package/dist/components/scenes/iam/UserProfile.svelte +47 -21
  298. package/dist/components/scenes/iam/UserProfile.svelte.d.ts +24 -1
  299. package/dist/components/scenes/iam/auth-captcha.d.ts +21 -0
  300. package/dist/components/scenes/iam/auth-captcha.js +23 -0
  301. package/dist/components/scenes/iam/auth-error-message.d.ts +13 -0
  302. package/dist/components/scenes/iam/auth-error-message.js +65 -0
  303. package/dist/components/scenes/iam/index.d.ts +10 -0
  304. package/dist/components/scenes/iam/index.js +9 -1
  305. package/dist/components/scenes/iam/password-utils.d.ts +33 -6
  306. package/dist/components/scenes/iam/password-utils.js +61 -8
  307. package/dist/components/scenes/iam/permission-context.svelte.d.ts +33 -23
  308. package/dist/components/scenes/iam/permission-context.svelte.js +20 -22
  309. package/dist/components/scenes/iam/sensitive-actions.svelte.d.ts +68 -0
  310. package/dist/components/scenes/iam/sensitive-actions.svelte.js +101 -0
  311. package/dist/components/scenes/iam/session-recovery.svelte.d.ts +44 -0
  312. package/dist/components/scenes/iam/session-recovery.svelte.js +57 -0
  313. package/dist/components/scenes/index.d.ts +3 -0
  314. package/dist/components/scenes/index.js +5 -0
  315. package/dist/components/scenes/storage/AvatarUpload.svelte +82 -68
  316. package/dist/components/scenes/storage/AvatarUpload.svelte.d.ts +23 -1
  317. package/dist/components/scenes/storage/FileList.svelte +19 -5
  318. package/dist/components/scenes/storage/FileList.svelte.d.ts +23 -1
  319. package/dist/components/scenes/storage/FileUpload.svelte +151 -96
  320. package/dist/components/scenes/storage/FileUpload.svelte.d.ts +24 -1
  321. package/dist/components/scenes/storage/ImageUpload.svelte +93 -94
  322. package/dist/components/scenes/storage/ImageUpload.svelte.d.ts +24 -1
  323. package/dist/components/scenes/types.d.ts +574 -42
  324. package/dist/guide-storage.d.ts +18 -0
  325. package/dist/guide-storage.js +79 -0
  326. package/dist/guide-types.d.ts +143 -0
  327. package/dist/guide-types.js +1 -0
  328. package/dist/guide.d.ts +3 -0
  329. package/dist/guide.js +3 -0
  330. package/dist/guide.svelte.d.ts +29 -0
  331. package/dist/guide.svelte.js +506 -0
  332. package/dist/i18n.svelte.d.ts +67 -4
  333. package/dist/i18n.svelte.js +106 -21
  334. package/dist/index.d.ts +6 -0
  335. package/dist/index.js +7 -0
  336. package/dist/internal/browser-safety.d.ts +88 -0
  337. package/dist/internal/browser-safety.js +140 -0
  338. package/dist/internal/dialog-focus.d.ts +21 -0
  339. package/dist/internal/dialog-focus.js +77 -0
  340. package/dist/internal/form-context.d.ts +92 -0
  341. package/dist/internal/form-context.js +70 -0
  342. package/dist/internal/form-validation.svelte.d.ts +70 -0
  343. package/dist/internal/form-validation.svelte.js +142 -0
  344. package/dist/internal/icon-safety.d.ts +14 -0
  345. package/dist/internal/icon-safety.js +40 -0
  346. package/dist/internal/locale.d.ts +21 -0
  347. package/dist/internal/locale.js +43 -0
  348. package/dist/message.svelte.d.ts +138 -0
  349. package/dist/message.svelte.js +149 -0
  350. package/dist/messagebox.svelte.d.ts +130 -0
  351. package/dist/messagebox.svelte.js +171 -0
  352. package/dist/messages/en-US.json +303 -16
  353. package/dist/messages/ja-JP.json +529 -0
  354. package/dist/messages/zh-CN.json +303 -16
  355. package/dist/messages.d.ts +25 -3
  356. package/dist/messages.js +23 -6
  357. package/dist/styles/design-tokens.css +4 -2
  358. package/dist/styles/eye-care.css +55 -0
  359. package/dist/styles/formal.css +55 -0
  360. package/dist/styles/global.css +86 -18
  361. package/dist/styles/guide.css +88 -0
  362. package/dist/styles/high-contrast.css +64 -0
  363. package/dist/styles/mobile.css +28 -0
  364. package/dist/styles/theme.css +43 -0
  365. package/dist/theme-config.d.ts +263 -10
  366. package/dist/theme-config.js +253 -17
  367. package/dist/toast.svelte.d.ts +210 -2
  368. package/dist/toast.svelte.js +305 -19
  369. package/dist/types.d.ts +787 -63
  370. package/dist/utils/platform.svelte.d.ts +28 -15
  371. package/dist/utils/platform.svelte.js +23 -16
  372. package/dist/utils.d.ts +121 -1
  373. package/dist/utils.js +208 -13
  374. package/dist/workspace-context.d.ts +20 -0
  375. package/dist/workspace-context.js +9 -0
  376. package/package.json +120 -24
  377. package/vite.d.ts +13 -0
  378. package/vite.js +96 -0
  379. package/dist/components/scenes/crud/CrudEditDrawer.svelte +0 -225
  380. package/dist/components/scenes/crud/CrudEditDrawer.svelte.d.ts +0 -48
@@ -1,22 +1,42 @@
1
1
  <!--
2
+ @component Tooltip
2
3
  =============================================================================
3
4
  @h-ai/ui - Tooltip 组件
4
5
  =============================================================================
5
- 提示框组件
6
+ 提示框组件,支持两种渲染模式:
7
+ - 默认:DaisyUI CSS 伪元素(::before),轻量无 JS 开销
8
+ - portal:通过 document.body 渲染,不受父容器 overflow 裁剪
6
9
 
7
10
  使用 Svelte 5 Runes ($props, $derived)
8
11
  =============================================================================
12
+
13
+ @example
14
+ ```ts
15
+ import { mount, unmount, createRawSnippet } from 'svelte'
16
+ import type { ComponentProps } from 'svelte'
17
+ import { Tooltip } from '@h-ai/ui'
18
+ const props: ComponentProps<typeof Tooltip> = { content: '复制链接', position: 'top', children: createRawSnippet(() => ({ render: () => "<span>复制</span>" })) }
19
+ const component = mount(Tooltip, { target: document.body, props })
20
+ await unmount(component)
21
+ ```
9
22
  -->
10
23
  <script lang='ts'>
11
- import type { TooltipProps } from '../../types.js'
12
- import { cn } from '../../utils.js'
24
+ import type { DataAttributes, TooltipProps } from '../../types.js'
25
+ import { cn, getDataAttributes } from '../../utils.js'
13
26
 
14
27
  const {
15
28
  content,
16
29
  position = 'top',
30
+ delay,
17
31
  class: className = '',
18
32
  children,
19
- }: TooltipProps = $props()
33
+ portal = false,
34
+ ...restProps
35
+ }: TooltipProps & DataAttributes = $props()
36
+
37
+ const dataAttributes = $derived(getDataAttributes(restProps))
38
+
39
+ // ─── CSS 模式(默认) ───
20
40
 
21
41
  const positionMap = {
22
42
  top: 'tooltip-top',
@@ -32,10 +52,124 @@
32
52
  className,
33
53
  ),
34
54
  )
55
+
56
+ // ─── Portal 模式 ───
57
+
58
+ let triggerEl = $state<HTMLDivElement>()
59
+ let portalEl: HTMLDivElement | null = null
60
+
61
+ function getClass(opacity: string): string {
62
+ return cn(
63
+ 'pointer-events-none fixed z-[9999] rounded-md bg-base-content px-2 py-1 text-xs text-base-100 shadow-md',
64
+ className,
65
+ opacity,
66
+ )
67
+ }
68
+
69
+ function ensurePortal(): HTMLDivElement {
70
+ if (!portalEl && typeof document !== 'undefined') {
71
+ portalEl = document.createElement('div')
72
+ portalEl.setAttribute('role', 'tooltip')
73
+ portalEl.className = getClass('opacity-0')
74
+ document.body.appendChild(portalEl)
75
+ }
76
+ return portalEl!
77
+ }
78
+
79
+ function updatePosition(): string {
80
+ if (!triggerEl)
81
+ return ''
82
+
83
+ const rect = triggerEl.getBoundingClientRect()
84
+ const gap = 6
85
+ let top: number
86
+ let left: number
87
+ let transform: string
88
+
89
+ switch (position) {
90
+ case 'top':
91
+ top = rect.top - gap
92
+ left = rect.left + rect.width / 2
93
+ transform = 'translate(-50%,-100%)'
94
+ break
95
+ case 'bottom':
96
+ top = rect.bottom + gap
97
+ left = rect.left + rect.width / 2
98
+ transform = 'translateX(-50%)'
99
+ break
100
+ case 'left':
101
+ top = rect.top + rect.height / 2
102
+ left = rect.left - gap
103
+ transform = 'translate(-100%,-50%)'
104
+ break
105
+ case 'right':
106
+ top = rect.top + rect.height / 2
107
+ left = rect.right + gap
108
+ transform = 'translateY(-50%)'
109
+ break
110
+ }
111
+
112
+ return `top:${top}px;left:${left}px;transform:${transform};`
113
+ }
114
+
115
+ let showTimer: ReturnType<typeof setTimeout> | undefined
116
+
117
+ function show() {
118
+ if (delay) {
119
+ showTimer = setTimeout(doShow, delay)
120
+ }
121
+ else {
122
+ doShow()
123
+ }
124
+ }
125
+
126
+ function doShow() {
127
+ const el = ensurePortal()
128
+ el.className = getClass('opacity-100')
129
+ el.style.cssText = updatePosition()
130
+ el.textContent = content
131
+ }
132
+
133
+ function hide() {
134
+ if (showTimer) {
135
+ clearTimeout(showTimer)
136
+ showTimer = undefined
137
+ }
138
+ if (portalEl) {
139
+ portalEl.className = getClass('opacity-0')
140
+ }
141
+ }
142
+
143
+ $effect(() => {
144
+ return () => {
145
+ if (showTimer)
146
+ clearTimeout(showTimer)
147
+ if (portalEl?.parentNode) {
148
+ portalEl.parentNode.removeChild(portalEl)
149
+ portalEl = null
150
+ }
151
+ }
152
+ })
35
153
  </script>
36
154
 
37
- <div class={tooltipClass} data-tip={content}>
38
- {#if children}
39
- {@render children()}
40
- {/if}
41
- </div>
155
+ {#if portal}
156
+ <div
157
+ {...dataAttributes}
158
+ bind:this={triggerEl}
159
+ class='inline-flex'
160
+ onmouseenter={show}
161
+ onmouseleave={hide}
162
+ onfocusin={show}
163
+ onfocusout={hide}
164
+ >
165
+ {#if children}
166
+ {@render children()}
167
+ {/if}
168
+ </div>
169
+ {:else}
170
+ <div {...dataAttributes} class={tooltipClass} data-tip={content}>
171
+ {#if children}
172
+ {@render children()}
173
+ {/if}
174
+ </div>
175
+ {/if}
@@ -1,4 +1,27 @@
1
- import type { TooltipProps } from '../../types.js';
2
- declare const Tooltip: import("svelte").Component<TooltipProps, {}, "">;
1
+ import type { DataAttributes, TooltipProps } from '../../types.js';
2
+ type $$ComponentProps = TooltipProps & DataAttributes;
3
+ /**
4
+ * Tooltip
5
+ * =============================================================================
6
+ * @h-ai/ui - Tooltip 组件
7
+ * =============================================================================
8
+ * 提示框组件,支持两种渲染模式:
9
+ * - 默认:DaisyUI CSS 伪元素(::before),轻量无 JS 开销
10
+ * - portal:通过 document.body 渲染,不受父容器 overflow 裁剪
11
+ *
12
+ * 使用 Svelte 5 Runes ($props, $derived)
13
+ * =============================================================================
14
+ *
15
+ * @example
16
+ * ```ts
17
+ * import { mount, unmount, createRawSnippet } from 'svelte'
18
+ * import type { ComponentProps } from 'svelte'
19
+ * import { Tooltip } from '@h-ai/ui'
20
+ * const props: ComponentProps<typeof Tooltip> = { content: '复制链接', position: 'top', children: createRawSnippet(() => ({ render: () => "<span>复制</span>" })) }
21
+ * const component = mount(Tooltip, { target: document.body, props })
22
+ * await unmount(component)
23
+ * ```
24
+ */
25
+ declare const Tooltip: import("svelte").Component<$$ComponentProps, {}, "">;
3
26
  type Tooltip = ReturnType<typeof Tooltip>;
4
27
  export default Tooltip;
@@ -2,12 +2,21 @@
2
2
  * @h-ai/ui — Accordion 类型定义
3
3
  * @module accordion-types
4
4
  */
5
+ /**
6
+ * 手风琴条目;id 应在当前条目集合内稳定且唯一。
7
+ *
8
+ * @example
9
+ * ```ts
10
+ * import type { AccordionItem } from '@h-ai/ui'
11
+ * const example: AccordionItem = { id: 'intro', title: '简介', content: '操作说明' }
12
+ * ```
13
+ */
5
14
  export interface AccordionItem {
6
15
  /** 唯一标识 */
7
16
  id: string;
8
17
  /** 标题 */
9
18
  title: string;
10
- /** 内容(字符串或 Snippet) */
19
+ /** 纯文本内容;自定义渲染使用 Accordion 的 children Snippet。 */
11
20
  content?: string;
12
21
  /** 是否禁用 */
13
22
  disabled?: boolean;
@@ -2,6 +2,15 @@
2
2
  * @h-ai/ui — ActionSheet 类型定义
3
3
  * @module action-sheet-types
4
4
  */
5
+ /**
6
+ * 底部操作菜单条目;危险动作可用 destructive 强调,禁用项不会触发选择。
7
+ *
8
+ * @example
9
+ * ```ts
10
+ * import type { ActionSheetItem } from '@h-ai/ui'
11
+ * const example: ActionSheetItem = { id: 'remove', label: '删除', destructive: true }
12
+ * ```
13
+ */
5
14
  export interface ActionSheetItem {
6
15
  /** 操作 ID */
7
16
  id: string;
@@ -3,6 +3,15 @@
3
3
  * @module bottom-nav-types
4
4
  */
5
5
  import type { Snippet } from 'svelte';
6
+ /**
7
+ * 移动端底部导航条目;icon 和 iconClass 任选一种图标来源。
8
+ *
9
+ * @example
10
+ * ```ts
11
+ * import type { BottomNavItem } from '@h-ai/ui'
12
+ * const example: BottomNavItem = { id: 'home', label: '首页', iconClass: 'icon-[tabler--home]' }
13
+ * ```
14
+ */
6
15
  export interface BottomNavItem {
7
16
  /** 导航项 ID */
8
17
  id: string;
@@ -22,9 +22,15 @@ export { default as DatePicker } from './DatePicker.svelte';
22
22
  export { default as Drawer } from './Drawer.svelte';
23
23
  export { default as Dropdown } from './Dropdown.svelte';
24
24
  export { default as Empty } from './Empty.svelte';
25
+ export { default as FilterBar } from './FilterBar.svelte';
25
26
  export { default as Form } from './Form.svelte';
26
27
  export { default as FormField } from './FormField.svelte';
28
+ export { default as FormLayout } from './FormLayout.svelte';
27
29
  export { default as InfiniteScroll } from './InfiniteScroll.svelte';
30
+ export { default as JsonViewer } from './JsonViewer.svelte';
31
+ export { default as MessageBoxContainer } from './MessageBoxContainer.svelte';
32
+ export { default as MessageBoxDialog } from './MessageBoxDialog.svelte';
33
+ export { default as MessageContainer } from './MessageContainer.svelte';
28
34
  export { default as Modal } from './Modal.svelte';
29
35
  export { default as PageHeader } from './PageHeader.svelte';
30
36
  export { default as Pagination } from './Pagination.svelte';
@@ -36,6 +42,7 @@ export { default as Skeleton } from './Skeleton.svelte';
36
42
  export { default as Steps } from './Steps.svelte';
37
43
  export type { SwipeCellAction } from './swipe-cell-types.js';
38
44
  export { default as SwipeCell } from './SwipeCell.svelte';
45
+ export { default as TableToolbar } from './TableToolbar.svelte';
39
46
  export { default as Tabs } from './Tabs.svelte';
40
47
  export { default as TagInput } from './TagInput.svelte';
41
48
  export type { TimelineItem } from './timeline-types.js';
@@ -28,11 +28,20 @@ export { default as Drawer } from './Drawer.svelte';
28
28
  export { default as Dropdown } from './Dropdown.svelte';
29
29
  // 状态占位
30
30
  export { default as Empty } from './Empty.svelte';
31
+ export { default as FilterBar } from './FilterBar.svelte';
31
32
  // 表单组合
32
33
  export { default as Form } from './Form.svelte';
33
34
  export { default as FormField } from './FormField.svelte';
35
+ export { default as FormLayout } from './FormLayout.svelte';
34
36
  // 无限滚动 / 上拉加载
35
37
  export { default as InfiniteScroll } from './InfiniteScroll.svelte';
38
+ // JSON 树查看器(可折叠、复制、主题自适应)
39
+ export { default as JsonViewer } from './JsonViewer.svelte';
40
+ // MessageBox 命令式弹框(类似 ElementUI MessageBox)
41
+ export { default as MessageBoxContainer } from './MessageBoxContainer.svelte';
42
+ export { default as MessageBoxDialog } from './MessageBoxDialog.svelte';
43
+ // Message 轻量消息提示(类似 ElementUI Message)
44
+ export { default as MessageContainer } from './MessageContainer.svelte';
36
45
  export { default as Modal } from './Modal.svelte';
37
46
  // 页面头部
38
47
  export { default as PageHeader } from './PageHeader.svelte';
@@ -46,6 +55,8 @@ export { default as SafeArea } from './SafeArea.svelte';
46
55
  export { default as Skeleton } from './Skeleton.svelte';
47
56
  export { default as Steps } from './Steps.svelte';
48
57
  export { default as SwipeCell } from './SwipeCell.svelte';
58
+ // 表格工具栏
59
+ export { default as TableToolbar } from './TableToolbar.svelte';
49
60
  export { default as Tabs } from './Tabs.svelte';
50
61
  export { default as TagInput } from './TagInput.svelte';
51
62
  export { default as Timeline } from './Timeline.svelte';
@@ -2,6 +2,15 @@
2
2
  * @h-ai/ui — SwipeCell 类型定义
3
3
  * @module swipe-cell-types
4
4
  */
5
+ /**
6
+ * 滑动单元格的操作按钮;id 交给宿主完成实际业务动作。
7
+ *
8
+ * @example
9
+ * ```ts
10
+ * import type { SwipeCellAction } from '@h-ai/ui'
11
+ * const example: SwipeCellAction = { id: 'remove', label: '删除', variant: 'error', width: 80 }
12
+ * ```
13
+ */
5
14
  export interface SwipeCellAction {
6
15
  /** 操作 ID */
7
16
  id: string;
@@ -2,6 +2,15 @@
2
2
  * @h-ai/ui — Timeline 类型定义
3
3
  * @module timeline-types
4
4
  */
5
+ /**
6
+ * 时间线节点的展示信息;completed 只控制界面状态,不提交业务操作。
7
+ *
8
+ * @example
9
+ * ```ts
10
+ * import type { TimelineItem } from '@h-ai/ui'
11
+ * const example: TimelineItem = { id: 'created', title: '已创建', time: '2026-01-01', completed: true }
12
+ * ```
13
+ */
5
14
  export interface TimelineItem {
6
15
  /** 唯一标识 */
7
16
  id: string;
@@ -0,0 +1,35 @@
1
+ import type { Size } from '../types.js';
2
+ /**
3
+ * 控件高度、间距与 DaisyUI 尺寸类的内部统一映射。
4
+ *
5
+ * @example 模块内部上下文
6
+ * ```ts
7
+ * const classes: FormControlSizeClasses = getFormControlSizeClasses('lg')
8
+ * const inputClasses = classes.control
9
+ * ```
10
+ */
11
+ interface FormControlSizeClasses {
12
+ /** 固定高度,适用于单行控件 */
13
+ height: string;
14
+ /** 最小高度,适用于内容可换行的控件 */
15
+ minHeight: string;
16
+ /** 水平内边距与字号 */
17
+ spacing: string;
18
+ /** 固定高度、水平内边距与字号的完整组合 */
19
+ control: string;
20
+ }
21
+ /**
22
+ * 获取输入类控件的统一尺寸类名。
23
+ *
24
+ * 仅供组件内部复用,确保 Input、Select 与复合输入控件使用同一盒模型。
25
+ * @param size - 组件尺寸预设。
26
+ * @returns 统一的高度、最小高度、间距与控件尺寸类。
27
+ *
28
+ * @example 模块内部上下文
29
+ * ```ts
30
+ * const classes = getFormControlSizeClasses('lg')
31
+ * const controlClass = classes.control
32
+ * ```
33
+ */
34
+ export declare function getFormControlSizeClasses(size: Size): FormControlSizeClasses;
35
+ export {};
@@ -0,0 +1,26 @@
1
+ const FORM_CONTROL_SIZE_CLASSES = {
2
+ 'xs': { height: 'h-8', minHeight: 'min-h-8', spacing: 'px-2.5 text-xs', control: 'h-8 px-2.5 text-xs' },
3
+ 'sm': { height: 'h-9', minHeight: 'min-h-9', spacing: 'px-3 text-sm', control: 'h-9 px-3 text-sm' },
4
+ 'md': { height: 'h-10', minHeight: 'min-h-10', spacing: 'px-3 text-sm', control: 'h-10 px-3 text-sm' },
5
+ 'lg': { height: 'h-12', minHeight: 'min-h-12', spacing: 'px-4 text-base', control: 'h-12 px-4 text-base' },
6
+ 'xl': { height: 'h-14', minHeight: 'min-h-14', spacing: 'px-4 text-lg', control: 'h-14 px-4 text-lg' },
7
+ '2xl': { height: 'h-14', minHeight: 'min-h-14', spacing: 'px-4 text-lg', control: 'h-14 px-4 text-lg' },
8
+ '3xl': { height: 'h-14', minHeight: 'min-h-14', spacing: 'px-4 text-lg', control: 'h-14 px-4 text-lg' },
9
+ '4xl': { height: 'h-14', minHeight: 'min-h-14', spacing: 'px-4 text-lg', control: 'h-14 px-4 text-lg' },
10
+ };
11
+ /**
12
+ * 获取输入类控件的统一尺寸类名。
13
+ *
14
+ * 仅供组件内部复用,确保 Input、Select 与复合输入控件使用同一盒模型。
15
+ * @param size - 组件尺寸预设。
16
+ * @returns 统一的高度、最小高度、间距与控件尺寸类。
17
+ *
18
+ * @example 模块内部上下文
19
+ * ```ts
20
+ * const classes = getFormControlSizeClasses('lg')
21
+ * const controlClass = classes.control
22
+ * ```
23
+ */
24
+ export function getFormControlSizeClasses(size) {
25
+ return FORM_CONTROL_SIZE_CLASSES[size];
26
+ }
@@ -1,10 +1,22 @@
1
1
  <!--
2
2
  @component Avatar
3
3
  头像组件,支持图片、名字首字母 fallback
4
+
5
+ @example
6
+ ```ts
7
+ import { mount, unmount } from 'svelte'
8
+ import type { ComponentProps } from 'svelte'
9
+ import { Avatar } from '@h-ai/ui'
10
+ const props: ComponentProps<typeof Avatar> = { name: 'Ada', alt: '用户头像', size: 'md' }
11
+ const component = mount(Avatar, { target: document.body, props })
12
+ await unmount(component)
13
+ ```
4
14
  -->
5
15
  <script lang='ts'>
6
- import type { AvatarProps } from '../../types.js'
7
- import { cn } from '../../utils.js'
16
+ import type { AvatarProps, DataAttributes } from '../../types.js'
17
+ import { cn, getDataAttributes } from '../../utils.js'
18
+
19
+ const NAME_PART_SPLIT_REGEX = /\s+/
8
20
 
9
21
  const {
10
22
  src = '',
@@ -13,8 +25,10 @@
13
25
  size = 'md',
14
26
  shape = 'circle',
15
27
  class: className = '',
16
- }: AvatarProps = $props()
28
+ ...restProps
29
+ }: AvatarProps & DataAttributes = $props()
17
30
 
31
+ const dataAttributes = $derived(getDataAttributes(restProps))
18
32
  const sizeMap = {
19
33
  'xs': 'w-6 h-6',
20
34
  'sm': 'w-8 h-8',
@@ -41,7 +55,7 @@
41
55
  const initials = $derived(() => {
42
56
  if (!name)
43
57
  return ''
44
- const parts = name.trim().split(/\s+/)
58
+ const parts = name.trim().split(NAME_PART_SPLIT_REGEX)
45
59
  if (parts.length >= 2) {
46
60
  return (parts[0][0] + parts[1][0]).toUpperCase()
47
61
  }
@@ -85,7 +99,7 @@
85
99
  )
86
100
  </script>
87
101
 
88
- <div class={containerClass}>
102
+ <div {...dataAttributes} class={containerClass}>
89
103
  <div
90
104
  class={innerClass}
91
105
  style:width={sizeValue}
@@ -1,8 +1,19 @@
1
- import type { AvatarProps } from '../../types.js';
1
+ import type { AvatarProps, DataAttributes } from '../../types.js';
2
+ type $$ComponentProps = AvatarProps & DataAttributes;
2
3
  /**
3
4
  * Avatar
4
5
  * 头像组件,支持图片、名字首字母 fallback
6
+ *
7
+ * @example
8
+ * ```ts
9
+ * import { mount, unmount } from 'svelte'
10
+ * import type { ComponentProps } from 'svelte'
11
+ * import { Avatar } from '@h-ai/ui'
12
+ * const props: ComponentProps<typeof Avatar> = { name: 'Ada', alt: '用户头像', size: 'md' }
13
+ * const component = mount(Avatar, { target: document.body, props })
14
+ * await unmount(component)
15
+ * ```
5
16
  */
6
- declare const Avatar: import("svelte").Component<AvatarProps, {}, "">;
17
+ declare const Avatar: import("svelte").Component<$$ComponentProps, {}, "">;
7
18
  type Avatar = ReturnType<typeof Avatar>;
8
19
  export default Avatar;
@@ -1,10 +1,20 @@
1
1
  <!--
2
2
  @component Badge
3
3
  徽章组件,支持多种变体与尺寸
4
+
5
+ @example
6
+ ```ts
7
+ import { mount, unmount, createRawSnippet } from 'svelte'
8
+ import type { ComponentProps } from 'svelte'
9
+ import { Badge } from '@h-ai/ui'
10
+ const props: ComponentProps<typeof Badge> = { variant: 'success', children: createRawSnippet(() => ({ render: () => "<span>已启用</span>" })) }
11
+ const component = mount(Badge, { target: document.body, props })
12
+ await unmount(component)
13
+ ```
4
14
  -->
5
15
  <script lang='ts'>
6
- import type { BadgeProps } from '../../types.js'
7
- import { cn, getBadgeSizeClass, getBadgeVariantClass } from '../../utils.js'
16
+ import type { BadgeProps, DataAttributes } from '../../types.js'
17
+ import { cn, getBadgeSizeClass, getBadgeVariantClass, getDataAttributes } from '../../utils.js'
8
18
 
9
19
  const {
10
20
  variant = 'default',
@@ -12,8 +22,10 @@
12
22
  outline = false,
13
23
  class: className = '',
14
24
  children,
15
- }: BadgeProps = $props()
25
+ ...restProps
26
+ }: BadgeProps & DataAttributes = $props()
16
27
 
28
+ const dataAttributes = $derived(getDataAttributes(restProps))
17
29
  const badgeClass = $derived(
18
30
  cn(
19
31
  'badge',
@@ -26,7 +38,7 @@
26
38
  )
27
39
  </script>
28
40
 
29
- <span class={badgeClass}>
41
+ <span {...dataAttributes} class={badgeClass}>
30
42
  {#if children}
31
43
  {@render children()}
32
44
  {/if}
@@ -1,8 +1,19 @@
1
- import type { BadgeProps } from '../../types.js';
1
+ import type { BadgeProps, DataAttributes } from '../../types.js';
2
+ type $$ComponentProps = BadgeProps & DataAttributes;
2
3
  /**
3
4
  * Badge
4
5
  * 徽章组件,支持多种变体与尺寸
6
+ *
7
+ * @example
8
+ * ```ts
9
+ * import { mount, unmount, createRawSnippet } from 'svelte'
10
+ * import type { ComponentProps } from 'svelte'
11
+ * import { Badge } from '@h-ai/ui'
12
+ * const props: ComponentProps<typeof Badge> = { variant: 'success', children: createRawSnippet(() => ({ render: () => "<span>已启用</span>" })) }
13
+ * const component = mount(Badge, { target: document.body, props })
14
+ * await unmount(component)
15
+ * ```
5
16
  */
6
- declare const Badge: import("svelte").Component<BadgeProps, {}, "">;
17
+ declare const Badge: import("svelte").Component<$$ComponentProps, {}, "">;
7
18
  type Badge = ReturnType<typeof Badge>;
8
19
  export default Badge;
@@ -1,4 +1,5 @@
1
1
  <!--
2
+ @component BareButton
2
3
  =============================================================================
3
4
  @h-ai/ui - BareButton 组件
4
5
  =============================================================================
@@ -6,9 +7,20 @@
6
7
 
7
8
  使用 Svelte 5 Runes ($props)
8
9
  =============================================================================
10
+
11
+ @example
12
+ ```ts
13
+ import { mount, unmount, createRawSnippet } from 'svelte'
14
+ import type { ComponentProps } from 'svelte'
15
+ import { BareButton } from '@h-ai/ui'
16
+ const props: ComponentProps<typeof BareButton> = { type: 'button', ariaLabel: '关闭', children: createRawSnippet(() => ({ render: () => "<span>关闭</span>" })) }
17
+ const component = mount(BareButton, { target: document.body, props })
18
+ await unmount(component)
19
+ ```
9
20
  -->
10
21
  <script lang='ts'>
11
- import type { BareButtonProps } from '../../types.js'
22
+ import type { BareButtonProps, DataAttributes } from '../../types.js'
23
+ import { getDataAttributes } from '../../utils.js'
12
24
 
13
25
  const {
14
26
  type = 'button',
@@ -21,23 +33,25 @@
21
33
  onclick,
22
34
  onkeydown,
23
35
  children,
24
- }: BareButtonProps = $props()
36
+ ...restProps
37
+ }: BareButtonProps & DataAttributes = $props()
25
38
 
39
+ const dataAttributes = $derived(getDataAttributes(restProps))
26
40
  function handleClick(e: MouseEvent) {
27
41
  onclick?.(e)
28
42
  }
29
43
  </script>
30
44
 
31
- <button
32
- {type}
33
- class={className}
34
- disabled={disabled}
35
- aria-label={ariaLabel || undefined}
36
- role={role}
37
- aria-selected={ariaSelected}
38
- tabindex={tabindex}
39
- onclick={handleClick}
40
- onkeydown={onkeydown}
45
+ <button {...dataAttributes}
46
+ {type}
47
+ class={className}
48
+ disabled={disabled}
49
+ aria-label={ariaLabel || undefined}
50
+ role={role}
51
+ aria-selected={ariaSelected}
52
+ tabindex={tabindex}
53
+ onclick={handleClick}
54
+ onkeydown={onkeydown}
41
55
  >
42
56
  {#if children}
43
57
  {@render children()}
@@ -1,4 +1,25 @@
1
- import type { BareButtonProps } from '../../types.js';
2
- declare const BareButton: import("svelte").Component<BareButtonProps, {}, "">;
1
+ import type { BareButtonProps, DataAttributes } from '../../types.js';
2
+ type $$ComponentProps = BareButtonProps & DataAttributes;
3
+ /**
4
+ * BareButton
5
+ * =============================================================================
6
+ * @h-ai/ui - BareButton 组件
7
+ * =============================================================================
8
+ * 无样式按钮组件(不注入 btn 类),用于自定义布局场景
9
+ *
10
+ * 使用 Svelte 5 Runes ($props)
11
+ * =============================================================================
12
+ *
13
+ * @example
14
+ * ```ts
15
+ * import { mount, unmount, createRawSnippet } from 'svelte'
16
+ * import type { ComponentProps } from 'svelte'
17
+ * import { BareButton } from '@h-ai/ui'
18
+ * const props: ComponentProps<typeof BareButton> = { type: 'button', ariaLabel: '关闭', children: createRawSnippet(() => ({ render: () => "<span>关闭</span>" })) }
19
+ * const component = mount(BareButton, { target: document.body, props })
20
+ * await unmount(component)
21
+ * ```
22
+ */
23
+ declare const BareButton: import("svelte").Component<$$ComponentProps, {}, "">;
3
24
  type BareButton = ReturnType<typeof BareButton>;
4
25
  export default BareButton;