@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
package/auto-import.d.ts CHANGED
@@ -16,6 +16,12 @@ type AutoImportHaiUiPreprocessor = {
16
16
  export function autoImportHaiUi(): AutoImportHaiUiPreprocessor
17
17
 
18
18
  declare global {
19
+ const Chart: typeof import('@h-ai/ui')['Chart']
20
+ const DashboardGrid: typeof import('@h-ai/ui')['DashboardGrid']
21
+ const MetricCard: typeof import('@h-ai/ui')['MetricCard']
22
+ const ReportCard: typeof import('@h-ai/ui')['ReportCard']
23
+ const GuideHost: typeof import('@h-ai/ui')['GuideHost']
24
+ const HelpCenter: typeof import('@h-ai/ui')['HelpCenter']
19
25
  // primitives
20
26
  const Avatar: typeof import('@h-ai/ui')['Avatar']
21
27
  const Badge: typeof import('@h-ai/ui')['Badge']
@@ -27,6 +33,7 @@ declare global {
27
33
  const Input: typeof import('@h-ai/ui')['Input']
28
34
  const Progress: typeof import('@h-ai/ui')['Progress']
29
35
  const Radio: typeof import('@h-ai/ui')['Radio']
36
+ // `Range` 与 DOM Range 构造器冲突,保持显式 import。
30
37
  const Rating: typeof import('@h-ai/ui')['Rating']
31
38
  const Select: typeof import('@h-ai/ui')['Select']
32
39
  const Spinner: typeof import('@h-ai/ui')['Spinner']
@@ -39,7 +46,10 @@ declare global {
39
46
 
40
47
  // compounds
41
48
  const Accordion: typeof import('@h-ai/ui')['Accordion']
49
+ const ActionSheet: typeof import('@h-ai/ui')['ActionSheet']
42
50
  const Alert: typeof import('@h-ai/ui')['Alert']
51
+ const AppBar: typeof import('@h-ai/ui')['AppBar']
52
+ const BottomNav: typeof import('@h-ai/ui')['BottomNav']
43
53
  const Breadcrumb: typeof import('@h-ai/ui')['Breadcrumb']
44
54
  const Calendar: typeof import('@h-ai/ui')['Calendar']
45
55
  const Card: typeof import('@h-ai/ui')['Card']
@@ -52,13 +62,25 @@ declare global {
52
62
  const Empty: typeof import('@h-ai/ui')['Empty']
53
63
  const Form: typeof import('@h-ai/ui')['Form']
54
64
  const FormField: typeof import('@h-ai/ui')['FormField']
65
+ const FormLayout: typeof import('@h-ai/ui')['FormLayout']
66
+ const InfiniteScroll: typeof import('@h-ai/ui')['InfiniteScroll']
67
+ const JsonViewer: typeof import('@h-ai/ui')['JsonViewer']
68
+ const MessageContainer: typeof import('@h-ai/ui')['MessageContainer']
69
+ const MessageBoxContainer: typeof import('@h-ai/ui')['MessageBoxContainer']
70
+ const MessageBoxDialog: typeof import('@h-ai/ui')['MessageBoxDialog']
55
71
  const Modal: typeof import('@h-ai/ui')['Modal']
56
72
  const PageHeader: typeof import('@h-ai/ui')['PageHeader']
73
+ const FilterBar: typeof import('@h-ai/ui')['FilterBar']
74
+ const WorkspaceLayout: typeof import('@h-ai/ui')['WorkspaceLayout']
57
75
  const Pagination: typeof import('@h-ai/ui')['Pagination']
58
76
  const Popover: typeof import('@h-ai/ui')['Popover']
77
+ const PullRefresh: typeof import('@h-ai/ui')['PullRefresh']
59
78
  const Result: typeof import('@h-ai/ui')['Result']
79
+ const SafeArea: typeof import('@h-ai/ui')['SafeArea']
60
80
  const Skeleton: typeof import('@h-ai/ui')['Skeleton']
61
81
  const Steps: typeof import('@h-ai/ui')['Steps']
82
+ const SwipeCell: typeof import('@h-ai/ui')['SwipeCell']
83
+ const TableToolbar: typeof import('@h-ai/ui')['TableToolbar']
62
84
  const Tabs: typeof import('@h-ai/ui')['Tabs']
63
85
  const TagInput: typeof import('@h-ai/ui')['TagInput']
64
86
  const Timeline: typeof import('@h-ai/ui')['Timeline']
@@ -66,19 +88,30 @@ declare global {
66
88
  const Tooltip: typeof import('@h-ai/ui')['Tooltip']
67
89
 
68
90
  // scenes - app
91
+ const FeedbackDetail: typeof import('@h-ai/ui')['FeedbackDetail']
92
+ const FeedbackForm: typeof import('@h-ai/ui')['FeedbackForm']
93
+ const FeedbackList: typeof import('@h-ai/ui')['FeedbackList']
69
94
  const FeedbackModal: typeof import('@h-ai/ui')['FeedbackModal']
70
95
  const LanguageSwitch: typeof import('@h-ai/ui')['LanguageSwitch']
96
+ const SettingsLayout: typeof import('@h-ai/ui')['SettingsLayout']
71
97
  const SettingsModal: typeof import('@h-ai/ui')['SettingsModal']
98
+ const ThemeColorPicker: typeof import('@h-ai/ui')['ThemeColorPicker']
72
99
  const ThemeSelector: typeof import('@h-ai/ui')['ThemeSelector']
73
100
  const ThemeToggle: typeof import('@h-ai/ui')['ThemeToggle']
74
101
 
75
102
  // scenes - iam
103
+ const AuthShell: typeof import('@h-ai/ui')['AuthShell']
104
+ const AuthPanel: typeof import('@h-ai/ui')['AuthPanel']
76
105
  const ChangePasswordForm: typeof import('@h-ai/ui')['ChangePasswordForm']
77
106
  const ForgotPasswordForm: typeof import('@h-ai/ui')['ForgotPasswordForm']
78
107
  const LoginForm: typeof import('@h-ai/ui')['LoginForm']
79
108
  const PasswordInput: typeof import('@h-ai/ui')['PasswordInput']
109
+ const PermGuard: typeof import('@h-ai/ui')['PermGuard']
110
+ const ReauthenticationDialog: typeof import('@h-ai/ui')['ReauthenticationDialog']
80
111
  const RegisterForm: typeof import('@h-ai/ui')['RegisterForm']
81
112
  const ResetPasswordForm: typeof import('@h-ai/ui')['ResetPasswordForm']
113
+ const SensitiveOperationsForm: typeof import('@h-ai/ui')['SensitiveOperationsForm']
114
+ const SessionRecoveryDialog: typeof import('@h-ai/ui')['SessionRecoveryDialog']
82
115
  const UserProfile: typeof import('@h-ai/ui')['UserProfile']
83
116
 
84
117
  // scenes - storage
@@ -91,6 +124,22 @@ declare global {
91
124
  const EncryptedInput: typeof import('@h-ai/ui')['EncryptedInput']
92
125
  const HashDisplay: typeof import('@h-ai/ui')['HashDisplay']
93
126
  const SignatureDisplay: typeof import('@h-ai/ui')['SignatureDisplay']
127
+
128
+ // scenes - ai
129
+ const AiDocumentDownloadMenu: typeof import('@h-ai/ui')['AiDocumentDownloadMenu']
130
+ const AiDocumentEditor: typeof import('@h-ai/ui')['AiDocumentEditor']
131
+ const AiTableEditor: typeof import('@h-ai/ui')['AiTableEditor']
132
+ const MarkdownRenderer: typeof import('@h-ai/ui')['MarkdownRenderer']
133
+
134
+ // scenes - crud
135
+ const CrudDeleteConfirm: typeof import('@h-ai/ui')['CrudDeleteConfirm']
136
+ const CrudDetailPanel: typeof import('@h-ai/ui')['CrudDetailPanel']
137
+ const CrudEditPanel: typeof import('@h-ai/ui')['CrudEditPanel']
138
+ const CrudFilterBar: typeof import('@h-ai/ui')['CrudFilterBar']
139
+ const CrudPage: typeof import('@h-ai/ui')['CrudPage']
140
+
141
+ // scenes - error
142
+ const ErrorPage: typeof import('@h-ai/ui')['ErrorPage']
94
143
  }
95
144
 
96
145
  export {}
package/auto-import.js CHANGED
@@ -7,6 +7,8 @@
7
7
  * =============================================================================
8
8
  */
9
9
 
10
+ import { parse } from 'svelte/compiler'
11
+
10
12
  const UI_COMPONENTS = new Set([
11
13
  // primitives
12
14
  'Avatar',
@@ -19,7 +21,6 @@ const UI_COMPONENTS = new Set([
19
21
  'Input',
20
22
  'Progress',
21
23
  'Radio',
22
- 'Range',
23
24
  'Rating',
24
25
  'Select',
25
26
  'Spinner',
@@ -29,6 +30,7 @@ const UI_COMPONENTS = new Set([
29
30
  'ToggleCheckbox',
30
31
  'ToggleInput',
31
32
  'ToggleRadio',
33
+ // `Range` 与 DOM Range 构造器重名,保持显式 import 更稳妥。
32
34
  // compounds
33
35
  'Accordion',
34
36
  'ActionSheet',
@@ -47,9 +49,16 @@ const UI_COMPONENTS = new Set([
47
49
  'Empty',
48
50
  'Form',
49
51
  'FormField',
52
+ 'FormLayout',
50
53
  'InfiniteScroll',
54
+ 'JsonViewer',
55
+ 'MessageContainer',
56
+ 'MessageBoxContainer',
57
+ 'MessageBoxDialog',
51
58
  'Modal',
52
59
  'PageHeader',
60
+ 'FilterBar',
61
+ 'WorkspaceLayout',
53
62
  'Pagination',
54
63
  'Popover',
55
64
  'PullRefresh',
@@ -58,25 +67,38 @@ const UI_COMPONENTS = new Set([
58
67
  'Skeleton',
59
68
  'Steps',
60
69
  'SwipeCell',
70
+ 'TableToolbar',
61
71
  'Tabs',
62
72
  'TagInput',
63
73
  'Timeline',
64
74
  'ToastContainer',
65
75
  'Tooltip',
66
76
  // scenes - app
77
+ 'FeedbackDetail',
78
+ 'FeedbackForm',
79
+ 'FeedbackList',
67
80
  'FeedbackModal',
68
81
  'LanguageSwitch',
82
+ 'SettingsLayout',
69
83
  'SettingsModal',
84
+ 'ThemeColorPicker',
70
85
  'ThemeSelector',
71
86
  'ThemeToggle',
87
+ 'GuideHost',
88
+ 'HelpCenter',
72
89
  // scenes - iam
90
+ 'AuthShell',
91
+ 'AuthPanel',
73
92
  'ChangePasswordForm',
74
93
  'ForgotPasswordForm',
75
94
  'LoginForm',
76
95
  'PasswordInput',
77
96
  'PermGuard',
97
+ 'ReauthenticationDialog',
78
98
  'RegisterForm',
79
99
  'ResetPasswordForm',
100
+ 'SensitiveOperationsForm',
101
+ 'SessionRecoveryDialog',
80
102
  'UserProfile',
81
103
  // scenes - storage
82
104
  'AvatarUpload',
@@ -88,13 +110,30 @@ const UI_COMPONENTS = new Set([
88
110
  'HashDisplay',
89
111
  'SignatureDisplay',
90
112
  // scenes - ai
113
+ 'AiDocumentDownloadMenu',
91
114
  'AiDocumentEditor',
115
+ 'AiTableEditor',
92
116
  'MarkdownRenderer',
117
+ // scenes - crud
118
+ 'CrudDeleteConfirm',
119
+ 'CrudDetailPanel',
120
+ 'CrudEditPanel',
121
+ 'CrudFilterBar',
122
+ 'CrudPage',
123
+ // scenes - charts
124
+ 'Chart',
125
+ 'DashboardGrid',
126
+ 'MetricCard',
127
+ 'ReportCard',
128
+ // scenes - error
129
+ 'ErrorPage',
93
130
  ])
94
131
 
95
132
  const TAG_REGEX = /<([A-Z][A-Za-z0-9]*)\b/g
96
133
  const SCRIPT_REGEX = /<script\b([^>]*)>([\s\S]*?)<\/script>/g
97
134
  const UI_IMPORT_REGEX = /import\s*\{([^}]+)\}\s*from\s*['"]@h-ai\/ui['"];?/
135
+ const WINDOWS_PATH_SEPARATOR_REGEX = /\\/g
136
+ const MODULE_CONTEXT_ATTR_REGEX = /context\s*=\s*['"]module['"]/i
98
137
 
99
138
  function collectUsedComponents(content) {
100
139
  const used = new Set()
@@ -109,73 +148,16 @@ function collectUsedComponents(content) {
109
148
 
110
149
  function collectImportedNames(scriptContent) {
111
150
  const imported = new Set()
112
- const lines = scriptContent.split('\n')
113
- let buffer = ''
114
-
115
- const flushImport = (statement) => {
116
- const fromIndex = statement.lastIndexOf(' from ')
117
- if (fromIndex === -1)
118
- return
119
-
120
- let clause = statement.slice('import '.length, fromIndex).trim()
121
- clause = clause.replace(/^type\s+/, '')
122
- if (!clause)
123
- return
124
-
125
- // default + named: Button, { Input as UiInput }
126
- if (clause.includes('{')) {
127
- const [defaultPart, namedPart] = clause.split('{')
128
- const defaultName = defaultPart.replace(',', '').trim()
129
- if (defaultName)
130
- imported.add(defaultName)
131
-
132
- const raw = namedPart.replace('}', '')
133
- for (const segment of raw.split(',')) {
134
- const cleaned = segment.trim().replace(/^type\s+/, '')
135
- if (!cleaned)
136
- continue
137
- const [original] = cleaned.split(/\s+as\s+/i)
138
- if (original)
139
- imported.add(original.trim())
140
- }
141
- return
142
- }
143
-
144
- // namespace import: * as name
145
- if (clause.startsWith('* as ')) {
146
- const name = clause.replace('* as ', '').trim()
147
- if (name)
148
- imported.add(name)
149
- return
150
- }
151
-
152
- // default import
153
- imported.add(clause)
154
- }
155
-
156
- for (const line of lines) {
157
- const trimmed = line.trim()
158
- if (!buffer) {
159
- if (!trimmed.startsWith('import '))
160
- continue
161
- buffer = trimmed
162
- if (trimmed.endsWith(';')) {
163
- flushImport(buffer)
164
- buffer = ''
165
- }
151
+ // 复用 Svelte 的 TS 解析器识别绑定,兼容无分号、跨行、注释及别名。
152
+ const ast = parse(`<script lang="ts">${scriptContent}</script>`, { modern: true })
153
+ for (const statement of ast.instance?.content.body ?? []) {
154
+ if (statement.type !== 'ImportDeclaration' || statement.importKind === 'type')
166
155
  continue
167
- }
168
-
169
- buffer += ` ${trimmed}`
170
- if (trimmed.endsWith(';')) {
171
- flushImport(buffer)
172
- buffer = ''
156
+ for (const specifier of statement.specifiers) {
157
+ if (specifier.importKind !== 'type')
158
+ imported.add(specifier.local.name)
173
159
  }
174
160
  }
175
-
176
- if (buffer)
177
- flushImport(buffer)
178
-
179
161
  return imported
180
162
  }
181
163
 
@@ -212,9 +194,9 @@ function autoImportHaiUi() {
212
194
  return { code: content }
213
195
  }
214
196
 
215
- // 跳过 @h-ai/ui 包自身的文件,避免重复导入
216
- const normalizedPath = filename.replace(/\\/g, '/')
217
- if (normalizedPath.includes('/packages/ui/') || normalizedPath.includes('/@h-ai/ui/')) {
197
+ // 自动导入只服务应用源码;第三方依赖和 @h-ai/ui 自身必须保持原样,避免改写依赖内部的同名组件。
198
+ const normalizedPath = filename.replace(WINDOWS_PATH_SEPARATOR_REGEX, '/')
199
+ if (normalizedPath.includes('/node_modules/') || normalizedPath.includes('/packages/ui/') || normalizedPath.includes('/@h-ai/ui/')) {
218
200
  return { code: content }
219
201
  }
220
202
 
@@ -229,7 +211,7 @@ function autoImportHaiUi() {
229
211
 
230
212
  for (const match of content.matchAll(SCRIPT_REGEX)) {
231
213
  const [fullMatch, attrs, scriptContent] = match
232
- const isModule = /context\s*=\s*['"]module['"]/i.test(attrs)
214
+ const isModule = MODULE_CONTEXT_ATTR_REGEX.test(attrs)
233
215
  const start = match.index ?? 0
234
216
 
235
217
  updated += content.slice(lastIndex, start)
@@ -1,4 +1,5 @@
1
1
  <!--
2
+ @component Accordion
2
3
  =============================================================================
3
4
  @h-ai/ui - Accordion 组件
4
5
  =============================================================================
@@ -7,15 +8,39 @@
7
8
  使用 Svelte 5 Runes ($props, $state, $derived)
8
9
  使用 DaisyUI collapse 类
9
10
  =============================================================================
11
+
12
+ @example
13
+ ```ts
14
+ import { mount, unmount } from 'svelte'
15
+ import type { ComponentProps } from 'svelte'
16
+ import { Accordion } from '@h-ai/ui'
17
+ const props: ComponentProps<typeof Accordion> = { items: [{ id: 'intro', title: '简介', content: '操作说明' }], value: 'intro' }
18
+ const component = mount(Accordion, { target: document.body, props })
19
+ await unmount(component)
20
+ ```
10
21
  -->
11
22
 
12
23
  <script lang='ts'>
13
24
  import type { Snippet } from 'svelte'
25
+ import type { DataAttributes } from '../../types.js'
14
26
  import type { AccordionItem } from './accordion-types.js'
15
- import { cn } from '../../utils.js'
27
+ import { cn, getDataAttributes } from '../../utils.js'
16
28
  import ToggleCheckbox from '../primitives/ToggleCheckbox.svelte'
17
29
  import ToggleRadio from '../primitives/ToggleRadio.svelte'
18
30
 
31
+ /**
32
+ * Accordion 组件的属性契约;通过公开组件配置使用。
33
+ *
34
+ * @example
35
+ * ```ts
36
+ * import { mount, unmount } from 'svelte'
37
+ * import type { ComponentProps } from 'svelte'
38
+ * import { Accordion } from '@h-ai/ui'
39
+ * const props: ComponentProps<typeof Accordion> = { items: [{ id: 'intro', title: '简介', content: '操作说明' }], value: 'intro' }
40
+ * const component = mount(Accordion, { target: document.body, props })
41
+ * await unmount(component)
42
+ * ```
43
+ */
19
44
  interface Props {
20
45
  /** 折叠项数据 */
21
46
  items: AccordionItem[]
@@ -47,8 +72,10 @@
47
72
  onchange,
48
73
  class: className = '',
49
74
  children,
50
- }: Props = $props()
75
+ ...restProps
76
+ }: Props & DataAttributes = $props()
51
77
 
78
+ const dataAttributes = $derived(getDataAttributes(restProps))
52
79
  const groupName = `accordion-${Math.random().toString(36).slice(2, 9)}`
53
80
 
54
81
  function isExpanded(itemId: string): boolean {
@@ -103,7 +130,7 @@
103
130
  }
104
131
  </script>
105
132
 
106
- <div class={containerClass}>
133
+ <div {...dataAttributes} class={containerClass}>
107
134
  {#each items as item (item.id)}
108
135
  <div class={getItemClass(item)}>
109
136
  {#if multiple}
@@ -1,5 +1,19 @@
1
1
  import type { Snippet } from 'svelte';
2
+ import type { DataAttributes } from '../../types.js';
2
3
  import type { AccordionItem } from './accordion-types.js';
4
+ /**
5
+ * Accordion 组件的属性契约;通过公开组件配置使用。
6
+ *
7
+ * @example
8
+ * ```ts
9
+ * import { mount, unmount } from 'svelte'
10
+ * import type { ComponentProps } from 'svelte'
11
+ * import { Accordion } from '@h-ai/ui'
12
+ * const props: ComponentProps<typeof Accordion> = { items: [{ id: 'intro', title: '简介', content: '操作说明' }], value: 'intro' }
13
+ * const component = mount(Accordion, { target: document.body, props })
14
+ * await unmount(component)
15
+ * ```
16
+ */
3
17
  interface Props {
4
18
  /** 折叠项数据 */
5
19
  items: AccordionItem[];
@@ -20,6 +34,28 @@ interface Props {
20
34
  /** 自定义内容渲染 */
21
35
  children?: Snippet<[AccordionItem]>;
22
36
  }
23
- declare const Accordion: import("svelte").Component<Props, {}, "value">;
37
+ type $$ComponentProps = Props & DataAttributes;
38
+ /**
39
+ * Accordion
40
+ * =============================================================================
41
+ * @h-ai/ui - Accordion 组件
42
+ * =============================================================================
43
+ * 手风琴/折叠面板组件,支持单选/多选模式、多种样式变体
44
+ *
45
+ * 使用 Svelte 5 Runes ($props, $state, $derived)
46
+ * 使用 DaisyUI collapse 类
47
+ * =============================================================================
48
+ *
49
+ * @example
50
+ * ```ts
51
+ * import { mount, unmount } from 'svelte'
52
+ * import type { ComponentProps } from 'svelte'
53
+ * import { Accordion } from '@h-ai/ui'
54
+ * const props: ComponentProps<typeof Accordion> = { items: [{ id: 'intro', title: '简介', content: '操作说明' }], value: 'intro' }
55
+ * const component = mount(Accordion, { target: document.body, props })
56
+ * await unmount(component)
57
+ * ```
58
+ */
59
+ declare const Accordion: import("svelte").Component<$$ComponentProps, {}, "value">;
24
60
  type Accordion = ReturnType<typeof Accordion>;
25
61
  export default Accordion;
@@ -1,4 +1,5 @@
1
1
  <!--
2
+ @component ActionSheet
2
3
  @h-ai/ui — ActionSheet(底部操作菜单)
3
4
 
4
5
  用法:
@@ -11,14 +12,38 @@
11
12
  onselect={(id) => handleAction(id)}
12
13
  onclose={() => showActions = false}
13
14
  />
15
+
16
+ @example
17
+ ```ts
18
+ import { mount, unmount } from 'svelte'
19
+ import type { ComponentProps } from 'svelte'
20
+ import { ActionSheet } from '@h-ai/ui'
21
+ const props: ComponentProps<typeof ActionSheet> = { open: true, items: [{ id: 'remove', label: '删除', destructive: true }] }
22
+ const component = mount(ActionSheet, { target: document.body, props })
23
+ await unmount(component)
24
+ ```
14
25
  -->
15
26
  <script lang='ts'>
27
+ import type { DataAttributes } from '../../types.js'
16
28
  import type { ActionSheetItem } from './action-sheet-types.js'
17
- import { cn } from '../../utils.js'
29
+ import { cn, getDataAttributes } from '../../utils.js'
18
30
 
19
31
  // eslint-disable-next-line no-import-assign -- type re-export
20
32
  export type { ActionSheetItem }
21
33
 
34
+ /**
35
+ * ActionSheet 组件的属性契约;通过公开组件配置使用。
36
+ *
37
+ * @example
38
+ * ```ts
39
+ * import { mount, unmount } from 'svelte'
40
+ * import type { ComponentProps } from 'svelte'
41
+ * import { ActionSheet } from '@h-ai/ui'
42
+ * const props: ComponentProps<typeof ActionSheet> = { open: true, items: [{ id: 'remove', label: '删除', destructive: true }] }
43
+ * const component = mount(ActionSheet, { target: document.body, props })
44
+ * await unmount(component)
45
+ * ```
46
+ */
22
47
  interface Props {
23
48
  /** 是否显示 */
24
49
  open?: boolean
@@ -44,8 +69,10 @@
44
69
  onselect,
45
70
  onclose,
46
71
  class: className,
47
- }: Props = $props()
72
+ ...restProps
73
+ }: Props & DataAttributes = $props()
48
74
 
75
+ const dataAttributes = $derived(getDataAttributes(restProps))
49
76
  function handleSelect(id: string) {
50
77
  onselect?.(id)
51
78
  onclose?.()
@@ -54,12 +81,12 @@
54
81
 
55
82
  {#if open}
56
83
  <!-- 遮罩层 -->
57
- <div
58
- class='fixed inset-0 bg-black/50 z-50 transition-opacity'
59
- role='button'
60
- tabindex='-1'
61
- onclick={onclose}
62
- onkeydown={e => e.key === 'Escape' && onclose?.()}
84
+ <div {...dataAttributes}
85
+ class='fixed inset-0 bg-black/50 z-50 transition-opacity'
86
+ role='button'
87
+ tabindex='-1'
88
+ onclick={onclose}
89
+ onkeydown={e => e.key === 'Escape' && onclose?.()}
63
90
  ></div>
64
91
 
65
92
  <!-- 操作面板 -->
@@ -1,4 +1,18 @@
1
+ import type { DataAttributes } from '../../types.js';
1
2
  import type { ActionSheetItem } from './action-sheet-types.js';
3
+ /**
4
+ * ActionSheet 组件的属性契约;通过公开组件配置使用。
5
+ *
6
+ * @example
7
+ * ```ts
8
+ * import { mount, unmount } from 'svelte'
9
+ * import type { ComponentProps } from 'svelte'
10
+ * import { ActionSheet } from '@h-ai/ui'
11
+ * const props: ComponentProps<typeof ActionSheet> = { open: true, items: [{ id: 'remove', label: '删除', destructive: true }] }
12
+ * const component = mount(ActionSheet, { target: document.body, props })
13
+ * await unmount(component)
14
+ * ```
15
+ */
2
16
  interface Props {
3
17
  /** 是否显示 */
4
18
  open?: boolean;
@@ -15,7 +29,33 @@ interface Props {
15
29
  /** 额外 CSS 类 */
16
30
  class?: string;
17
31
  }
18
- declare const ActionSheet: import("svelte").Component<Props, {
32
+ type $$ComponentProps = Props & DataAttributes;
33
+ /**
34
+ * ActionSheet
35
+ * @h-ai/ui — ActionSheet(底部操作菜单)
36
+ *
37
+ * 用法:
38
+ * <ActionSheet
39
+ * open={showActions}
40
+ * items={[
41
+ * { id: 'edit', label: '编辑' },
42
+ * { id: 'delete', label: '删除', destructive: true },
43
+ * ]}
44
+ * onselect={(id) => handleAction(id)}
45
+ * onclose={() => showActions = false}
46
+ * />
47
+ *
48
+ * @example
49
+ * ```ts
50
+ * import { mount, unmount } from 'svelte'
51
+ * import type { ComponentProps } from 'svelte'
52
+ * import { ActionSheet } from '@h-ai/ui'
53
+ * const props: ComponentProps<typeof ActionSheet> = { open: true, items: [{ id: 'remove', label: '删除', destructive: true }] }
54
+ * const component = mount(ActionSheet, { target: document.body, props })
55
+ * await unmount(component)
56
+ * ```
57
+ */
58
+ declare const ActionSheet: import("svelte").Component<$$ComponentProps, {
19
59
  ActionSheetItem: typeof ActionSheetItem;
20
60
  }, "">;
21
61
  type ActionSheet = ReturnType<typeof ActionSheet>;
@@ -1,11 +1,21 @@
1
1
  <!--
2
2
  @component Alert
3
- 警告框组件,使用 tabler icon 替代 emoji,更精致。
3
+ 持续信息组件;警告与错误使用 ToastContainer。
4
+
5
+ @example
6
+ ```ts
7
+ import { mount, unmount, createRawSnippet } from 'svelte'
8
+ import type { ComponentProps } from 'svelte'
9
+ import { Alert } from '@h-ai/ui'
10
+ const props: ComponentProps<typeof Alert> = { title: '服务状态', variant: 'info', children: createRawSnippet(() => ({ render: () => "<span>系统将于今晚进行维护。</span>" })) }
11
+ const component = mount(Alert, { target: document.body, props })
12
+ await unmount(component)
13
+ ```
4
14
  -->
5
15
  <script lang='ts'>
6
- import type { AlertProps } from '../../types.js'
16
+ import type { AlertProps, DataAttributes } from '../../types.js'
7
17
  import { uiM } from '../../messages.js'
8
- import { cn, getAlertVariantClass } from '../../utils.js'
18
+ import { cn, getAlertVariantClass, getDataAttributes } from '../../utils.js'
9
19
  import IconButton from '../primitives/IconButton.svelte'
10
20
 
11
21
  const {
@@ -15,13 +25,16 @@
15
25
  class: className = '',
16
26
  onclose,
17
27
  children,
18
- }: AlertProps = $props()
28
+ ...restProps
29
+ }: AlertProps & DataAttributes = $props()
19
30
 
31
+ const dataAttributes = $derived(getDataAttributes(restProps))
20
32
  let visible = $state(true)
21
33
 
22
34
  const alertClass = $derived(
23
35
  cn(
24
- 'alert',
36
+ 'alert alert-soft shadow-none',
37
+ 'flex items-start gap-3',
25
38
  getAlertVariantClass(variant),
26
39
  className,
27
40
  ),
@@ -31,8 +44,6 @@
31
44
  const iconMap: Record<string, string> = {
32
45
  info: 'icon-[tabler--info-circle]',
33
46
  success: 'icon-[tabler--circle-check]',
34
- warning: 'icon-[tabler--alert-triangle]',
35
- error: 'icon-[tabler--circle-x]',
36
47
  }
37
48
 
38
49
  function handleClose() {
@@ -42,25 +53,23 @@
42
53
  </script>
43
54
 
44
55
  {#if visible}
45
- <div class={alertClass} role='alert'>
46
- <span class='{iconMap[variant] ?? iconMap.info} size-5 shrink-0'></span>
56
+ <div {...dataAttributes} class={alertClass} role='status'>
57
+ <span class='{iconMap[variant] ?? iconMap.info} mt-0.5 size-5 shrink-0' aria-hidden='true'></span>
47
58
 
48
- <div>
59
+ <div class='min-w-0 flex-1 [overflow-wrap:anywhere]'>
49
60
  {#if title}
50
61
  <h3 class='font-semibold text-sm'>{title}</h3>
51
62
  {/if}
52
63
  {#if children}
53
- <div class='text-sm'>
64
+ <div class='text-sm leading-relaxed'>
54
65
  {@render children()}
55
66
  </div>
56
67
  {/if}
57
68
  </div>
58
69
 
59
70
  {#if dismissible}
60
- <IconButton size='sm' variant='ghost' label={uiM('common_close')} onclick={handleClose}>
61
- {#snippet children()}
62
- <span class='icon-[tabler--x] size-4'></span>
63
- {/snippet}
71
+ <IconButton size='sm' variant='ghost' class='shrink-0' label={uiM('common_close')} onclick={handleClose}>
72
+ <span class='icon-[tabler--x] size-4'></span>
64
73
  </IconButton>
65
74
  {/if}
66
75
  </div>
@@ -1,8 +1,19 @@
1
- import type { AlertProps } from '../../types.js';
1
+ import type { AlertProps, DataAttributes } from '../../types.js';
2
+ type $$ComponentProps = AlertProps & DataAttributes;
2
3
  /**
3
4
  * Alert
4
- * 警告框组件,使用 tabler icon 替代 emoji,更精致。
5
+ * 持续信息组件;警告与错误使用 ToastContainer。
6
+ *
7
+ * @example
8
+ * ```ts
9
+ * import { mount, unmount, createRawSnippet } from 'svelte'
10
+ * import type { ComponentProps } from 'svelte'
11
+ * import { Alert } from '@h-ai/ui'
12
+ * const props: ComponentProps<typeof Alert> = { title: '服务状态', variant: 'info', children: createRawSnippet(() => ({ render: () => "<span>系统将于今晚进行维护。</span>" })) }
13
+ * const component = mount(Alert, { target: document.body, props })
14
+ * await unmount(component)
15
+ * ```
5
16
  */
6
- declare const Alert: import("svelte").Component<AlertProps, {}, "">;
17
+ declare const Alert: import("svelte").Component<$$ComponentProps, {}, "">;
7
18
  type Alert = ReturnType<typeof Alert>;
8
19
  export default Alert;