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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (367) hide show
  1. package/README.en.md +1036 -0
  2. package/README.ja.md +1036 -0
  3. package/README.md +670 -119
  4. package/auto-import.d.ts +45 -0
  5. package/auto-import.js +46 -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 +386 -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 +296 -77
  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 +215 -0
  150. package/dist/components/scenes/ai/highlight.d.ts +37 -0
  151. package/dist/components/scenes/ai/highlight.js +162 -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 +42 -31
  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 +163 -0
  201. package/dist/components/scenes/charts/Chart.svelte.d.ts +25 -0
  202. package/dist/components/scenes/charts/chart-theme.d.ts +47 -0
  203. package/dist/components/scenes/charts/chart-theme.js +68 -0
  204. package/dist/components/scenes/charts/chart-types.d.ts +153 -0
  205. package/dist/components/scenes/charts/chart-types.js +7 -0
  206. package/dist/components/scenes/charts/index.d.ts +8 -0
  207. package/dist/components/scenes/charts/index.js +7 -0
  208. package/dist/components/scenes/charts/renderers/AreaChart.svelte +18 -0
  209. package/dist/components/scenes/charts/renderers/AreaChart.svelte.d.ts +5 -0
  210. package/dist/components/scenes/charts/renderers/BarChart.svelte +18 -0
  211. package/dist/components/scenes/charts/renderers/BarChart.svelte.d.ts +5 -0
  212. package/dist/components/scenes/charts/renderers/LineChart.svelte +624 -0
  213. package/dist/components/scenes/charts/renderers/LineChart.svelte.d.ts +32 -0
  214. package/dist/components/scenes/charts/renderers/PieChart.svelte +18 -0
  215. package/dist/components/scenes/charts/renderers/PieChart.svelte.d.ts +5 -0
  216. package/dist/components/scenes/charts/renderers/ScatterChart.svelte +18 -0
  217. package/dist/components/scenes/charts/renderers/ScatterChart.svelte.d.ts +5 -0
  218. package/dist/components/scenes/crud/CrudDeleteConfirm.svelte +29 -11
  219. package/dist/components/scenes/crud/CrudDeleteConfirm.svelte.d.ts +13 -1
  220. package/dist/components/scenes/crud/CrudDetailDrawer.svelte +77 -22
  221. package/dist/components/scenes/crud/CrudDetailDrawer.svelte.d.ts +19 -4
  222. package/dist/components/scenes/crud/CrudDetailPanel.svelte +242 -0
  223. package/dist/components/scenes/crud/CrudDetailPanel.svelte.d.ts +66 -0
  224. package/dist/components/scenes/crud/CrudEditPanel.svelte +365 -0
  225. package/dist/components/scenes/crud/CrudEditPanel.svelte.d.ts +48 -0
  226. package/dist/components/scenes/crud/CrudFilterBar.svelte +17 -85
  227. package/dist/components/scenes/crud/CrudFilterBar.svelte.d.ts +13 -25
  228. package/dist/components/scenes/crud/CrudPage.svelte +564 -185
  229. package/dist/components/scenes/crud/CrudPage.svelte.d.ts +137 -51
  230. package/dist/components/scenes/crud/crud-controller.svelte.d.ts +335 -0
  231. package/dist/components/scenes/crud/crud-controller.svelte.js +276 -0
  232. package/dist/components/scenes/crud/crud-form-validation.d.ts +16 -0
  233. package/dist/components/scenes/crud/crud-form-validation.js +51 -0
  234. package/dist/components/scenes/crud/crud-types.d.ts +136 -43
  235. package/dist/components/scenes/crud/index.d.ts +9 -3
  236. package/dist/components/scenes/crud/index.js +8 -3
  237. package/dist/components/scenes/crud/nav-adapter.d.ts +50 -0
  238. package/dist/components/scenes/crud/nav-adapter.js +39 -0
  239. package/dist/components/scenes/crypto/EncryptedInput.svelte +63 -28
  240. package/dist/components/scenes/crypto/EncryptedInput.svelte.d.ts +38 -3
  241. package/dist/components/scenes/crypto/HashDisplay.svelte +30 -22
  242. package/dist/components/scenes/crypto/HashDisplay.svelte.d.ts +24 -1
  243. package/dist/components/scenes/crypto/SignatureDisplay.svelte +41 -40
  244. package/dist/components/scenes/crypto/SignatureDisplay.svelte.d.ts +24 -1
  245. package/dist/components/scenes/error/ErrorPage.svelte +135 -0
  246. package/dist/components/scenes/error/ErrorPage.svelte.d.ts +50 -0
  247. package/dist/components/scenes/error/error-presets.d.ts +60 -0
  248. package/dist/components/scenes/error/error-presets.js +51 -0
  249. package/dist/components/scenes/error/index.d.ts +8 -0
  250. package/dist/components/scenes/error/index.js +8 -0
  251. package/dist/components/scenes/guide/GuideHost.svelte +56 -0
  252. package/dist/components/scenes/guide/GuideHost.svelte.d.ts +35 -0
  253. package/dist/components/scenes/guide/GuideHostContent.svelte +136 -0
  254. package/dist/components/scenes/guide/GuideHostContent.svelte.d.ts +43 -0
  255. package/dist/components/scenes/guide/HelpCenter.svelte +135 -0
  256. package/dist/components/scenes/guide/HelpCenter.svelte.d.ts +40 -0
  257. package/dist/components/scenes/guide/index.d.ts +2 -0
  258. package/dist/components/scenes/guide/index.js +2 -0
  259. package/dist/components/scenes/iam/AgreementNotice.svelte +48 -0
  260. package/dist/components/scenes/iam/AgreementNotice.svelte.d.ts +7 -0
  261. package/dist/components/scenes/iam/AuthPanel.svelte +226 -0
  262. package/dist/components/scenes/iam/AuthPanel.svelte.d.ts +29 -0
  263. package/dist/components/scenes/iam/AuthShell.svelte +160 -0
  264. package/dist/components/scenes/iam/AuthShell.svelte.d.ts +56 -0
  265. package/dist/components/scenes/iam/ChangePasswordForm.svelte +84 -63
  266. package/dist/components/scenes/iam/ChangePasswordForm.svelte.d.ts +13 -1
  267. package/dist/components/scenes/iam/ForgotPasswordForm.svelte +113 -89
  268. package/dist/components/scenes/iam/ForgotPasswordForm.svelte.d.ts +24 -1
  269. package/dist/components/scenes/iam/LoginForm.svelte +215 -117
  270. package/dist/components/scenes/iam/LoginForm.svelte.d.ts +13 -1
  271. package/dist/components/scenes/iam/PasswordInput.svelte +79 -32
  272. package/dist/components/scenes/iam/PasswordInput.svelte.d.ts +30 -4
  273. package/dist/components/scenes/iam/PermGuard.svelte +21 -11
  274. package/dist/components/scenes/iam/PermGuard.svelte.d.ts +30 -0
  275. package/dist/components/scenes/iam/ReauthenticationDialog.svelte +68 -0
  276. package/dist/components/scenes/iam/ReauthenticationDialog.svelte.d.ts +17 -0
  277. package/dist/components/scenes/iam/RegisterForm.svelte +129 -116
  278. package/dist/components/scenes/iam/RegisterForm.svelte.d.ts +13 -1
  279. package/dist/components/scenes/iam/ResetPasswordForm.svelte +101 -88
  280. package/dist/components/scenes/iam/ResetPasswordForm.svelte.d.ts +13 -1
  281. package/dist/components/scenes/iam/SensitiveOperationsForm.svelte +76 -0
  282. package/dist/components/scenes/iam/SensitiveOperationsForm.svelte.d.ts +21 -0
  283. package/dist/components/scenes/iam/SessionRecoveryDialog.svelte +64 -0
  284. package/dist/components/scenes/iam/SessionRecoveryDialog.svelte.d.ts +22 -0
  285. package/dist/components/scenes/iam/UserProfile.svelte +47 -21
  286. package/dist/components/scenes/iam/UserProfile.svelte.d.ts +24 -1
  287. package/dist/components/scenes/iam/auth-captcha.d.ts +21 -0
  288. package/dist/components/scenes/iam/auth-captcha.js +23 -0
  289. package/dist/components/scenes/iam/auth-error-message.d.ts +13 -0
  290. package/dist/components/scenes/iam/auth-error-message.js +65 -0
  291. package/dist/components/scenes/iam/index.d.ts +10 -0
  292. package/dist/components/scenes/iam/index.js +9 -1
  293. package/dist/components/scenes/iam/password-utils.d.ts +33 -6
  294. package/dist/components/scenes/iam/password-utils.js +61 -8
  295. package/dist/components/scenes/iam/permission-context.svelte.d.ts +33 -23
  296. package/dist/components/scenes/iam/permission-context.svelte.js +20 -22
  297. package/dist/components/scenes/iam/sensitive-actions.svelte.d.ts +68 -0
  298. package/dist/components/scenes/iam/sensitive-actions.svelte.js +101 -0
  299. package/dist/components/scenes/iam/session-recovery.svelte.d.ts +44 -0
  300. package/dist/components/scenes/iam/session-recovery.svelte.js +57 -0
  301. package/dist/components/scenes/index.d.ts +3 -0
  302. package/dist/components/scenes/index.js +5 -0
  303. package/dist/components/scenes/storage/AvatarUpload.svelte +82 -68
  304. package/dist/components/scenes/storage/AvatarUpload.svelte.d.ts +23 -1
  305. package/dist/components/scenes/storage/FileList.svelte +19 -5
  306. package/dist/components/scenes/storage/FileList.svelte.d.ts +23 -1
  307. package/dist/components/scenes/storage/FileUpload.svelte +151 -96
  308. package/dist/components/scenes/storage/FileUpload.svelte.d.ts +24 -1
  309. package/dist/components/scenes/storage/ImageUpload.svelte +93 -94
  310. package/dist/components/scenes/storage/ImageUpload.svelte.d.ts +24 -1
  311. package/dist/components/scenes/types.d.ts +574 -42
  312. package/dist/guide-storage.d.ts +18 -0
  313. package/dist/guide-storage.js +79 -0
  314. package/dist/guide-types.d.ts +143 -0
  315. package/dist/guide-types.js +1 -0
  316. package/dist/guide.d.ts +3 -0
  317. package/dist/guide.js +3 -0
  318. package/dist/guide.svelte.d.ts +29 -0
  319. package/dist/guide.svelte.js +506 -0
  320. package/dist/i18n.svelte.d.ts +67 -4
  321. package/dist/i18n.svelte.js +106 -21
  322. package/dist/index.d.ts +6 -0
  323. package/dist/index.js +7 -0
  324. package/dist/internal/browser-safety.d.ts +88 -0
  325. package/dist/internal/browser-safety.js +140 -0
  326. package/dist/internal/dialog-focus.d.ts +21 -0
  327. package/dist/internal/dialog-focus.js +77 -0
  328. package/dist/internal/form-context.d.ts +92 -0
  329. package/dist/internal/form-context.js +70 -0
  330. package/dist/internal/form-validation.svelte.d.ts +70 -0
  331. package/dist/internal/form-validation.svelte.js +142 -0
  332. package/dist/internal/icon-safety.d.ts +14 -0
  333. package/dist/internal/icon-safety.js +40 -0
  334. package/dist/internal/locale.d.ts +21 -0
  335. package/dist/internal/locale.js +43 -0
  336. package/dist/message.svelte.d.ts +138 -0
  337. package/dist/message.svelte.js +149 -0
  338. package/dist/messagebox.svelte.d.ts +130 -0
  339. package/dist/messagebox.svelte.js +171 -0
  340. package/dist/messages/en-US.json +297 -16
  341. package/dist/messages/ja-JP.json +523 -0
  342. package/dist/messages/zh-CN.json +297 -16
  343. package/dist/messages.d.ts +25 -3
  344. package/dist/messages.js +23 -6
  345. package/dist/styles/design-tokens.css +4 -2
  346. package/dist/styles/formal.css +55 -0
  347. package/dist/styles/global.css +86 -18
  348. package/dist/styles/guide.css +88 -0
  349. package/dist/styles/high-contrast.css +64 -0
  350. package/dist/styles/mobile.css +28 -0
  351. package/dist/styles/theme.css +42 -0
  352. package/dist/theme-config.d.ts +263 -10
  353. package/dist/theme-config.js +252 -17
  354. package/dist/toast.svelte.d.ts +210 -2
  355. package/dist/toast.svelte.js +296 -19
  356. package/dist/types.d.ts +787 -63
  357. package/dist/utils/platform.svelte.d.ts +28 -15
  358. package/dist/utils/platform.svelte.js +23 -16
  359. package/dist/utils.d.ts +121 -1
  360. package/dist/utils.js +208 -13
  361. package/dist/workspace-context.d.ts +20 -0
  362. package/dist/workspace-context.js +9 -0
  363. package/package.json +120 -24
  364. package/vite.d.ts +13 -0
  365. package/vite.js +96 -0
  366. package/dist/components/scenes/crud/CrudEditDrawer.svelte +0 -225
  367. package/dist/components/scenes/crud/CrudEditDrawer.svelte.d.ts +0 -48
package/auto-import.d.ts CHANGED
@@ -16,6 +16,8 @@ type AutoImportHaiUiPreprocessor = {
16
16
  export function autoImportHaiUi(): AutoImportHaiUiPreprocessor
17
17
 
18
18
  declare global {
19
+ const GuideHost: typeof import('@h-ai/ui')['GuideHost']
20
+ const HelpCenter: typeof import('@h-ai/ui')['HelpCenter']
19
21
  // primitives
20
22
  const Avatar: typeof import('@h-ai/ui')['Avatar']
21
23
  const Badge: typeof import('@h-ai/ui')['Badge']
@@ -27,6 +29,7 @@ declare global {
27
29
  const Input: typeof import('@h-ai/ui')['Input']
28
30
  const Progress: typeof import('@h-ai/ui')['Progress']
29
31
  const Radio: typeof import('@h-ai/ui')['Radio']
32
+ // `Range` 与 DOM Range 构造器冲突,保持显式 import。
30
33
  const Rating: typeof import('@h-ai/ui')['Rating']
31
34
  const Select: typeof import('@h-ai/ui')['Select']
32
35
  const Spinner: typeof import('@h-ai/ui')['Spinner']
@@ -39,7 +42,10 @@ declare global {
39
42
 
40
43
  // compounds
41
44
  const Accordion: typeof import('@h-ai/ui')['Accordion']
45
+ const ActionSheet: typeof import('@h-ai/ui')['ActionSheet']
42
46
  const Alert: typeof import('@h-ai/ui')['Alert']
47
+ const AppBar: typeof import('@h-ai/ui')['AppBar']
48
+ const BottomNav: typeof import('@h-ai/ui')['BottomNav']
43
49
  const Breadcrumb: typeof import('@h-ai/ui')['Breadcrumb']
44
50
  const Calendar: typeof import('@h-ai/ui')['Calendar']
45
51
  const Card: typeof import('@h-ai/ui')['Card']
@@ -52,13 +58,25 @@ declare global {
52
58
  const Empty: typeof import('@h-ai/ui')['Empty']
53
59
  const Form: typeof import('@h-ai/ui')['Form']
54
60
  const FormField: typeof import('@h-ai/ui')['FormField']
61
+ const FormLayout: typeof import('@h-ai/ui')['FormLayout']
62
+ const InfiniteScroll: typeof import('@h-ai/ui')['InfiniteScroll']
63
+ const JsonViewer: typeof import('@h-ai/ui')['JsonViewer']
64
+ const MessageContainer: typeof import('@h-ai/ui')['MessageContainer']
65
+ const MessageBoxContainer: typeof import('@h-ai/ui')['MessageBoxContainer']
66
+ const MessageBoxDialog: typeof import('@h-ai/ui')['MessageBoxDialog']
55
67
  const Modal: typeof import('@h-ai/ui')['Modal']
56
68
  const PageHeader: typeof import('@h-ai/ui')['PageHeader']
69
+ const FilterBar: typeof import('@h-ai/ui')['FilterBar']
70
+ const WorkspaceLayout: typeof import('@h-ai/ui')['WorkspaceLayout']
57
71
  const Pagination: typeof import('@h-ai/ui')['Pagination']
58
72
  const Popover: typeof import('@h-ai/ui')['Popover']
73
+ const PullRefresh: typeof import('@h-ai/ui')['PullRefresh']
59
74
  const Result: typeof import('@h-ai/ui')['Result']
75
+ const SafeArea: typeof import('@h-ai/ui')['SafeArea']
60
76
  const Skeleton: typeof import('@h-ai/ui')['Skeleton']
61
77
  const Steps: typeof import('@h-ai/ui')['Steps']
78
+ const SwipeCell: typeof import('@h-ai/ui')['SwipeCell']
79
+ const TableToolbar: typeof import('@h-ai/ui')['TableToolbar']
62
80
  const Tabs: typeof import('@h-ai/ui')['Tabs']
63
81
  const TagInput: typeof import('@h-ai/ui')['TagInput']
64
82
  const Timeline: typeof import('@h-ai/ui')['Timeline']
@@ -66,19 +84,30 @@ declare global {
66
84
  const Tooltip: typeof import('@h-ai/ui')['Tooltip']
67
85
 
68
86
  // scenes - app
87
+ const FeedbackDetail: typeof import('@h-ai/ui')['FeedbackDetail']
88
+ const FeedbackForm: typeof import('@h-ai/ui')['FeedbackForm']
89
+ const FeedbackList: typeof import('@h-ai/ui')['FeedbackList']
69
90
  const FeedbackModal: typeof import('@h-ai/ui')['FeedbackModal']
70
91
  const LanguageSwitch: typeof import('@h-ai/ui')['LanguageSwitch']
92
+ const SettingsLayout: typeof import('@h-ai/ui')['SettingsLayout']
71
93
  const SettingsModal: typeof import('@h-ai/ui')['SettingsModal']
94
+ const ThemeColorPicker: typeof import('@h-ai/ui')['ThemeColorPicker']
72
95
  const ThemeSelector: typeof import('@h-ai/ui')['ThemeSelector']
73
96
  const ThemeToggle: typeof import('@h-ai/ui')['ThemeToggle']
74
97
 
75
98
  // scenes - iam
99
+ const AuthShell: typeof import('@h-ai/ui')['AuthShell']
100
+ const AuthPanel: typeof import('@h-ai/ui')['AuthPanel']
76
101
  const ChangePasswordForm: typeof import('@h-ai/ui')['ChangePasswordForm']
77
102
  const ForgotPasswordForm: typeof import('@h-ai/ui')['ForgotPasswordForm']
78
103
  const LoginForm: typeof import('@h-ai/ui')['LoginForm']
79
104
  const PasswordInput: typeof import('@h-ai/ui')['PasswordInput']
105
+ const PermGuard: typeof import('@h-ai/ui')['PermGuard']
106
+ const ReauthenticationDialog: typeof import('@h-ai/ui')['ReauthenticationDialog']
80
107
  const RegisterForm: typeof import('@h-ai/ui')['RegisterForm']
81
108
  const ResetPasswordForm: typeof import('@h-ai/ui')['ResetPasswordForm']
109
+ const SensitiveOperationsForm: typeof import('@h-ai/ui')['SensitiveOperationsForm']
110
+ const SessionRecoveryDialog: typeof import('@h-ai/ui')['SessionRecoveryDialog']
82
111
  const UserProfile: typeof import('@h-ai/ui')['UserProfile']
83
112
 
84
113
  // scenes - storage
@@ -91,6 +120,22 @@ declare global {
91
120
  const EncryptedInput: typeof import('@h-ai/ui')['EncryptedInput']
92
121
  const HashDisplay: typeof import('@h-ai/ui')['HashDisplay']
93
122
  const SignatureDisplay: typeof import('@h-ai/ui')['SignatureDisplay']
123
+
124
+ // scenes - ai
125
+ const AiDocumentDownloadMenu: typeof import('@h-ai/ui')['AiDocumentDownloadMenu']
126
+ const AiDocumentEditor: typeof import('@h-ai/ui')['AiDocumentEditor']
127
+ const AiTableEditor: typeof import('@h-ai/ui')['AiTableEditor']
128
+ const MarkdownRenderer: typeof import('@h-ai/ui')['MarkdownRenderer']
129
+
130
+ // scenes - crud
131
+ const CrudDeleteConfirm: typeof import('@h-ai/ui')['CrudDeleteConfirm']
132
+ const CrudDetailPanel: typeof import('@h-ai/ui')['CrudDetailPanel']
133
+ const CrudEditPanel: typeof import('@h-ai/ui')['CrudEditPanel']
134
+ const CrudFilterBar: typeof import('@h-ai/ui')['CrudFilterBar']
135
+ const CrudPage: typeof import('@h-ai/ui')['CrudPage']
136
+
137
+ // scenes - error
138
+ const ErrorPage: typeof import('@h-ai/ui')['ErrorPage']
94
139
  }
95
140
 
96
141
  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,25 @@ 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 - error
124
+ 'ErrorPage',
93
125
  ])
94
126
 
95
127
  const TAG_REGEX = /<([A-Z][A-Za-z0-9]*)\b/g
96
128
  const SCRIPT_REGEX = /<script\b([^>]*)>([\s\S]*?)<\/script>/g
97
129
  const UI_IMPORT_REGEX = /import\s*\{([^}]+)\}\s*from\s*['"]@h-ai\/ui['"];?/
130
+ const WINDOWS_PATH_SEPARATOR_REGEX = /\\/g
131
+ const MODULE_CONTEXT_ATTR_REGEX = /context\s*=\s*['"]module['"]/i
98
132
 
99
133
  function collectUsedComponents(content) {
100
134
  const used = new Set()
@@ -109,73 +143,16 @@ function collectUsedComponents(content) {
109
143
 
110
144
  function collectImportedNames(scriptContent) {
111
145
  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
- }
146
+ // 复用 Svelte 的 TS 解析器识别绑定,兼容无分号、跨行、注释及别名。
147
+ const ast = parse(`<script lang="ts">${scriptContent}</script>`, { modern: true })
148
+ for (const statement of ast.instance?.content.body ?? []) {
149
+ if (statement.type !== 'ImportDeclaration' || statement.importKind === 'type')
166
150
  continue
167
- }
168
-
169
- buffer += ` ${trimmed}`
170
- if (trimmed.endsWith(';')) {
171
- flushImport(buffer)
172
- buffer = ''
151
+ for (const specifier of statement.specifiers) {
152
+ if (specifier.importKind !== 'type')
153
+ imported.add(specifier.local.name)
173
154
  }
174
155
  }
175
-
176
- if (buffer)
177
- flushImport(buffer)
178
-
179
156
  return imported
180
157
  }
181
158
 
@@ -212,9 +189,9 @@ function autoImportHaiUi() {
212
189
  return { code: content }
213
190
  }
214
191
 
215
- // 跳过 @h-ai/ui 包自身的文件,避免重复导入
216
- const normalizedPath = filename.replace(/\\/g, '/')
217
- if (normalizedPath.includes('/packages/ui/') || normalizedPath.includes('/@h-ai/ui/')) {
192
+ // 自动导入只服务应用源码;第三方依赖和 @h-ai/ui 自身必须保持原样,避免改写依赖内部的同名组件。
193
+ const normalizedPath = filename.replace(WINDOWS_PATH_SEPARATOR_REGEX, '/')
194
+ if (normalizedPath.includes('/node_modules/') || normalizedPath.includes('/packages/ui/') || normalizedPath.includes('/@h-ai/ui/')) {
218
195
  return { code: content }
219
196
  }
220
197
 
@@ -229,7 +206,7 @@ function autoImportHaiUi() {
229
206
 
230
207
  for (const match of content.matchAll(SCRIPT_REGEX)) {
231
208
  const [fullMatch, attrs, scriptContent] = match
232
- const isModule = /context\s*=\s*['"]module['"]/i.test(attrs)
209
+ const isModule = MODULE_CONTEXT_ATTR_REGEX.test(attrs)
233
210
  const start = match.index ?? 0
234
211
 
235
212
  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;