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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (380) hide show
  1. package/README.en.md +1062 -0
  2. package/README.ja.md +1062 -0
  3. package/README.md +696 -119
  4. package/auto-import.d.ts +49 -0
  5. package/auto-import.js +51 -69
  6. package/dist/components/compounds/Accordion.svelte +30 -3
  7. package/dist/components/compounds/Accordion.svelte.d.ts +37 -1
  8. package/dist/components/compounds/ActionSheet.svelte +35 -8
  9. package/dist/components/compounds/ActionSheet.svelte.d.ts +41 -1
  10. package/dist/components/compounds/Alert.svelte +24 -15
  11. package/dist/components/compounds/Alert.svelte.d.ts +14 -3
  12. package/dist/components/compounds/AppBar.svelte +37 -9
  13. package/dist/components/compounds/AppBar.svelte.d.ts +36 -1
  14. package/dist/components/compounds/BottomNav.svelte +68 -8
  15. package/dist/components/compounds/BottomNav.svelte.d.ts +51 -1
  16. package/dist/components/compounds/Breadcrumb.svelte +18 -5
  17. package/dist/components/compounds/Breadcrumb.svelte.d.ts +23 -2
  18. package/dist/components/compounds/Calendar.svelte +31 -12
  19. package/dist/components/compounds/Calendar.svelte.d.ts +23 -7
  20. package/dist/components/compounds/Card.svelte +17 -5
  21. package/dist/components/compounds/Card.svelte.d.ts +13 -2
  22. package/dist/components/compounds/Combobox.svelte +124 -42
  23. package/dist/components/compounds/Combobox.svelte.d.ts +42 -20
  24. package/dist/components/compounds/Confirm.svelte +32 -9
  25. package/dist/components/compounds/Confirm.svelte.d.ts +24 -2
  26. package/dist/components/compounds/DataTable.svelte +317 -33
  27. package/dist/components/compounds/DataTable.svelte.d.ts +28 -14
  28. package/dist/components/compounds/DatePicker.svelte +62 -18
  29. package/dist/components/compounds/DatePicker.svelte.d.ts +27 -8
  30. package/dist/components/compounds/Drawer.svelte +179 -22
  31. package/dist/components/compounds/Drawer.svelte.d.ts +24 -2
  32. package/dist/components/compounds/Dropdown.svelte +19 -5
  33. package/dist/components/compounds/Dropdown.svelte.d.ts +13 -2
  34. package/dist/components/compounds/Empty.svelte +22 -9
  35. package/dist/components/compounds/Empty.svelte.d.ts +23 -2
  36. package/dist/components/compounds/FilterBar.svelte +82 -0
  37. package/dist/components/compounds/FilterBar.svelte.d.ts +39 -0
  38. package/dist/components/compounds/Form.svelte +59 -16
  39. package/dist/components/compounds/Form.svelte.d.ts +23 -2
  40. package/dist/components/compounds/FormField.svelte +99 -16
  41. package/dist/components/compounds/FormField.svelte.d.ts +23 -2
  42. package/dist/components/compounds/FormLayout.svelte +71 -0
  43. package/dist/components/compounds/FormLayout.svelte.d.ts +17 -0
  44. package/dist/components/compounds/InfiniteScroll.svelte +34 -7
  45. package/dist/components/compounds/InfiniteScroll.svelte.d.ts +37 -1
  46. package/dist/components/compounds/JsonViewer.svelte +214 -0
  47. package/dist/components/compounds/JsonViewer.svelte.d.ts +26 -0
  48. package/dist/components/compounds/MessageBoxContainer.svelte +34 -0
  49. package/dist/components/compounds/MessageBoxContainer.svelte.d.ts +25 -0
  50. package/dist/components/compounds/MessageBoxDialog.svelte +209 -0
  51. package/dist/components/compounds/MessageBoxDialog.svelte.d.ts +29 -0
  52. package/dist/components/compounds/MessageContainer.svelte +24 -0
  53. package/dist/components/compounds/MessageContainer.svelte.d.ts +18 -0
  54. package/dist/components/compounds/Modal.svelte +348 -73
  55. package/dist/components/compounds/Modal.svelte.d.ts +13 -2
  56. package/dist/components/compounds/PageHeader.svelte +44 -20
  57. package/dist/components/compounds/PageHeader.svelte.d.ts +24 -9
  58. package/dist/components/compounds/Pagination.svelte +139 -105
  59. package/dist/components/compounds/Pagination.svelte.d.ts +23 -2
  60. package/dist/components/compounds/Popover.svelte +124 -25
  61. package/dist/components/compounds/Popover.svelte.d.ts +23 -2
  62. package/dist/components/compounds/PullRefresh.svelte +35 -8
  63. package/dist/components/compounds/PullRefresh.svelte.d.ts +35 -1
  64. package/dist/components/compounds/Result.svelte +17 -4
  65. package/dist/components/compounds/Result.svelte.d.ts +23 -2
  66. package/dist/components/compounds/SafeArea.svelte +30 -3
  67. package/dist/components/compounds/SafeArea.svelte.d.ts +35 -1
  68. package/dist/components/compounds/Skeleton.svelte +19 -7
  69. package/dist/components/compounds/Skeleton.svelte.d.ts +13 -2
  70. package/dist/components/compounds/Steps.svelte +17 -4
  71. package/dist/components/compounds/Steps.svelte.d.ts +23 -2
  72. package/dist/components/compounds/SwipeCell.svelte +30 -3
  73. package/dist/components/compounds/SwipeCell.svelte.d.ts +40 -1
  74. package/dist/components/compounds/TableToolbar.svelte +289 -0
  75. package/dist/components/compounds/TableToolbar.svelte.d.ts +69 -0
  76. package/dist/components/compounds/Tabs.svelte +84 -14
  77. package/dist/components/compounds/Tabs.svelte.d.ts +13 -2
  78. package/dist/components/compounds/TagInput.svelte +51 -33
  79. package/dist/components/compounds/TagInput.svelte.d.ts +23 -2
  80. package/dist/components/compounds/Timeline.svelte +30 -3
  81. package/dist/components/compounds/Timeline.svelte.d.ts +37 -1
  82. package/dist/components/compounds/ToastContainer.svelte +397 -28
  83. package/dist/components/compounds/ToastContainer.svelte.d.ts +27 -1
  84. package/dist/components/compounds/Tooltip.svelte +143 -9
  85. package/dist/components/compounds/Tooltip.svelte.d.ts +25 -2
  86. package/dist/components/compounds/accordion-types.d.ts +10 -1
  87. package/dist/components/compounds/action-sheet-types.d.ts +9 -0
  88. package/dist/components/compounds/bottom-nav-types.d.ts +9 -0
  89. package/dist/components/compounds/index.d.ts +7 -0
  90. package/dist/components/compounds/index.js +11 -0
  91. package/dist/components/compounds/swipe-cell-types.d.ts +9 -0
  92. package/dist/components/compounds/timeline-types.d.ts +9 -0
  93. package/dist/components/control-size.d.ts +35 -0
  94. package/dist/components/control-size.js +26 -0
  95. package/dist/components/primitives/Avatar.svelte +19 -5
  96. package/dist/components/primitives/Avatar.svelte.d.ts +13 -2
  97. package/dist/components/primitives/Badge.svelte +16 -4
  98. package/dist/components/primitives/Badge.svelte.d.ts +13 -2
  99. package/dist/components/primitives/BareButton.svelte +26 -12
  100. package/dist/components/primitives/BareButton.svelte.d.ts +23 -2
  101. package/dist/components/primitives/BareInput.svelte +57 -35
  102. package/dist/components/primitives/BareInput.svelte.d.ts +23 -2
  103. package/dist/components/primitives/Button.svelte +30 -9
  104. package/dist/components/primitives/Button.svelte.d.ts +13 -2
  105. package/dist/components/primitives/Checkbox.svelte +24 -5
  106. package/dist/components/primitives/Checkbox.svelte.d.ts +23 -2
  107. package/dist/components/primitives/IconButton.svelte +35 -10
  108. package/dist/components/primitives/IconButton.svelte.d.ts +23 -2
  109. package/dist/components/primitives/Input.svelte +56 -26
  110. package/dist/components/primitives/Input.svelte.d.ts +13 -2
  111. package/dist/components/primitives/Progress.svelte +17 -4
  112. package/dist/components/primitives/Progress.svelte.d.ts +23 -2
  113. package/dist/components/primitives/Radio.svelte +17 -4
  114. package/dist/components/primitives/Radio.svelte.d.ts +22 -2
  115. package/dist/components/primitives/Range.svelte +31 -4
  116. package/dist/components/primitives/Range.svelte.d.ts +37 -1
  117. package/dist/components/primitives/Rating.svelte +32 -5
  118. package/dist/components/primitives/Rating.svelte.d.ts +37 -1
  119. package/dist/components/primitives/Select.svelte +404 -47
  120. package/dist/components/primitives/Select.svelte.d.ts +23 -2
  121. package/dist/components/primitives/Spinner.svelte +17 -4
  122. package/dist/components/primitives/Spinner.svelte.d.ts +23 -2
  123. package/dist/components/primitives/Switch.svelte +22 -4
  124. package/dist/components/primitives/Switch.svelte.d.ts +23 -2
  125. package/dist/components/primitives/Tag.svelte +17 -4
  126. package/dist/components/primitives/Tag.svelte.d.ts +23 -2
  127. package/dist/components/primitives/Textarea.svelte +75 -30
  128. package/dist/components/primitives/Textarea.svelte.d.ts +24 -2
  129. package/dist/components/primitives/ToggleCheckbox.svelte +24 -10
  130. package/dist/components/primitives/ToggleCheckbox.svelte.d.ts +23 -2
  131. package/dist/components/primitives/ToggleInput.svelte +24 -10
  132. package/dist/components/primitives/ToggleInput.svelte.d.ts +23 -2
  133. package/dist/components/primitives/ToggleRadio.svelte +24 -10
  134. package/dist/components/primitives/ToggleRadio.svelte.d.ts +23 -2
  135. package/dist/components/scenes/ai/AiDocumentDownloadMenu.svelte +54 -23
  136. package/dist/components/scenes/ai/AiDocumentDownloadMenu.svelte.d.ts +30 -1
  137. package/dist/components/scenes/ai/AiDocumentEditor.svelte +3428 -693
  138. package/dist/components/scenes/ai/AiDocumentEditor.svelte.d.ts +26 -1
  139. package/dist/components/scenes/ai/MarkdownRenderer.svelte +119 -116
  140. package/dist/components/scenes/ai/MarkdownRenderer.svelte.d.ts +31 -1
  141. package/dist/components/scenes/ai/code-preview.d.ts +46 -0
  142. package/dist/components/scenes/ai/code-preview.js +141 -0
  143. package/dist/components/scenes/ai/document-download.d.ts +52 -0
  144. package/dist/components/scenes/ai/document-download.js +300 -79
  145. package/dist/components/scenes/ai/document-parse.d.ts +101 -11
  146. package/dist/components/scenes/ai/document-parse.js +212 -48
  147. package/dist/components/scenes/ai/document-types.d.ts +292 -75
  148. package/dist/components/scenes/ai/editor-markdown-extensions.d.ts +27 -0
  149. package/dist/components/scenes/ai/editor-markdown-extensions.js +216 -0
  150. package/dist/components/scenes/ai/highlight.d.ts +37 -0
  151. package/dist/components/scenes/ai/highlight.js +177 -0
  152. package/dist/components/scenes/ai/index.d.ts +5 -2
  153. package/dist/components/scenes/ai/index.js +3 -0
  154. package/dist/components/scenes/ai/markdown-parse.d.ts +11 -3
  155. package/dist/components/scenes/ai/markdown-parse.js +85 -47
  156. package/dist/components/scenes/ai/mermaid-host-sync.d.ts +72 -0
  157. package/dist/components/scenes/ai/mermaid-host-sync.js +65 -0
  158. package/dist/components/scenes/ai/mermaid-render.d.ts +30 -0
  159. package/dist/components/scenes/ai/mermaid-render.js +61 -0
  160. package/dist/components/scenes/ai/safe-html.d.ts +64 -0
  161. package/dist/components/scenes/ai/safe-html.js +345 -0
  162. package/dist/components/scenes/ai/table/AiTableEditor.svelte +1692 -0
  163. package/dist/components/scenes/ai/table/AiTableEditor.svelte.d.ts +32 -0
  164. package/dist/components/scenes/ai/table/table-types.d.ts +181 -0
  165. package/dist/components/scenes/ai/table/table-types.js +1 -0
  166. package/dist/components/scenes/app/FeedbackDetail.svelte +236 -0
  167. package/dist/components/scenes/app/FeedbackDetail.svelte.d.ts +40 -0
  168. package/dist/components/scenes/app/FeedbackForm.svelte +337 -0
  169. package/dist/components/scenes/app/FeedbackForm.svelte.d.ts +72 -0
  170. package/dist/components/scenes/app/FeedbackList.svelte +150 -0
  171. package/dist/components/scenes/app/FeedbackList.svelte.d.ts +28 -0
  172. package/dist/components/scenes/app/FeedbackModal.svelte +65 -139
  173. package/dist/components/scenes/app/FeedbackModal.svelte.d.ts +14 -39
  174. package/dist/components/scenes/app/FeedbackRecorder.svelte +154 -0
  175. package/dist/components/scenes/app/FeedbackRecorder.svelte.d.ts +9 -0
  176. package/dist/components/scenes/app/FeedbackReplay.svelte +142 -0
  177. package/dist/components/scenes/app/FeedbackReplay.svelte.d.ts +7 -0
  178. package/dist/components/scenes/app/FeedbackScreenshot.svelte +120 -0
  179. package/dist/components/scenes/app/FeedbackScreenshot.svelte.d.ts +8 -0
  180. package/dist/components/scenes/app/LanguageSwitch.svelte +38 -21
  181. package/dist/components/scenes/app/LanguageSwitch.svelte.d.ts +33 -20
  182. package/dist/components/scenes/app/SettingsLayout.svelte +115 -0
  183. package/dist/components/scenes/app/SettingsLayout.svelte.d.ts +54 -0
  184. package/dist/components/scenes/app/SettingsModal.svelte +33 -7
  185. package/dist/components/scenes/app/SettingsModal.svelte.d.ts +27 -1
  186. package/dist/components/scenes/app/ThemeColorPicker.svelte +240 -0
  187. package/dist/components/scenes/app/ThemeColorPicker.svelte.d.ts +57 -0
  188. package/dist/components/scenes/app/ThemeSelector.svelte +87 -26
  189. package/dist/components/scenes/app/ThemeSelector.svelte.d.ts +26 -7
  190. package/dist/components/scenes/app/ThemeToggle.svelte +27 -6
  191. package/dist/components/scenes/app/ThemeToggle.svelte.d.ts +24 -5
  192. package/dist/components/scenes/app/WorkspaceLayout.svelte +64 -0
  193. package/dist/components/scenes/app/WorkspaceLayout.svelte.d.ts +36 -0
  194. package/dist/components/scenes/app/feedback-functions.d.ts +57 -0
  195. package/dist/components/scenes/app/feedback-functions.js +107 -0
  196. package/dist/components/scenes/app/feedback-types.d.ts +224 -0
  197. package/dist/components/scenes/app/feedback-types.js +1 -0
  198. package/dist/components/scenes/app/index.d.ts +8 -1
  199. package/dist/components/scenes/app/index.js +7 -1
  200. package/dist/components/scenes/charts/Chart.svelte +186 -0
  201. package/dist/components/scenes/charts/Chart.svelte.d.ts +24 -0
  202. package/dist/components/scenes/charts/ChartLoadError.svelte +13 -0
  203. package/dist/components/scenes/charts/ChartLoadError.svelte.d.ts +6 -0
  204. package/dist/components/scenes/charts/DashboardGrid.svelte +34 -0
  205. package/dist/components/scenes/charts/DashboardGrid.svelte.d.ts +15 -0
  206. package/dist/components/scenes/charts/MetricCard.svelte +52 -0
  207. package/dist/components/scenes/charts/MetricCard.svelte.d.ts +15 -0
  208. package/dist/components/scenes/charts/ReportCard.svelte +48 -0
  209. package/dist/components/scenes/charts/ReportCard.svelte.d.ts +15 -0
  210. package/dist/components/scenes/charts/chart-presets.d.ts +15 -0
  211. package/dist/components/scenes/charts/chart-presets.js +19 -0
  212. package/dist/components/scenes/charts/chart-theme.d.ts +47 -0
  213. package/dist/components/scenes/charts/chart-theme.js +68 -0
  214. package/dist/components/scenes/charts/chart-types.d.ts +164 -0
  215. package/dist/components/scenes/charts/chart-types.js +7 -0
  216. package/dist/components/scenes/charts/dashboard-types.d.ts +79 -0
  217. package/dist/components/scenes/charts/dashboard-types.js +1 -0
  218. package/dist/components/scenes/charts/index.d.ts +12 -0
  219. package/dist/components/scenes/charts/index.js +10 -0
  220. package/dist/components/scenes/charts/renderers/AreaChart.svelte +19 -0
  221. package/dist/components/scenes/charts/renderers/AreaChart.svelte.d.ts +6 -0
  222. package/dist/components/scenes/charts/renderers/BarChart.svelte +19 -0
  223. package/dist/components/scenes/charts/renderers/BarChart.svelte.d.ts +6 -0
  224. package/dist/components/scenes/charts/renderers/LineChart.svelte +625 -0
  225. package/dist/components/scenes/charts/renderers/LineChart.svelte.d.ts +33 -0
  226. package/dist/components/scenes/charts/renderers/PieChart.svelte +19 -0
  227. package/dist/components/scenes/charts/renderers/PieChart.svelte.d.ts +6 -0
  228. package/dist/components/scenes/charts/renderers/ScatterChart.svelte +19 -0
  229. package/dist/components/scenes/charts/renderers/ScatterChart.svelte.d.ts +6 -0
  230. package/dist/components/scenes/crud/CrudDeleteConfirm.svelte +29 -11
  231. package/dist/components/scenes/crud/CrudDeleteConfirm.svelte.d.ts +13 -1
  232. package/dist/components/scenes/crud/CrudDetailDrawer.svelte +77 -22
  233. package/dist/components/scenes/crud/CrudDetailDrawer.svelte.d.ts +19 -4
  234. package/dist/components/scenes/crud/CrudDetailPanel.svelte +242 -0
  235. package/dist/components/scenes/crud/CrudDetailPanel.svelte.d.ts +66 -0
  236. package/dist/components/scenes/crud/CrudEditPanel.svelte +365 -0
  237. package/dist/components/scenes/crud/CrudEditPanel.svelte.d.ts +48 -0
  238. package/dist/components/scenes/crud/CrudFilterBar.svelte +17 -85
  239. package/dist/components/scenes/crud/CrudFilterBar.svelte.d.ts +13 -25
  240. package/dist/components/scenes/crud/CrudPage.svelte +564 -185
  241. package/dist/components/scenes/crud/CrudPage.svelte.d.ts +137 -51
  242. package/dist/components/scenes/crud/crud-controller.svelte.d.ts +335 -0
  243. package/dist/components/scenes/crud/crud-controller.svelte.js +276 -0
  244. package/dist/components/scenes/crud/crud-form-validation.d.ts +16 -0
  245. package/dist/components/scenes/crud/crud-form-validation.js +51 -0
  246. package/dist/components/scenes/crud/crud-types.d.ts +136 -43
  247. package/dist/components/scenes/crud/index.d.ts +9 -3
  248. package/dist/components/scenes/crud/index.js +8 -3
  249. package/dist/components/scenes/crud/nav-adapter.d.ts +50 -0
  250. package/dist/components/scenes/crud/nav-adapter.js +39 -0
  251. package/dist/components/scenes/crypto/EncryptedInput.svelte +63 -28
  252. package/dist/components/scenes/crypto/EncryptedInput.svelte.d.ts +38 -3
  253. package/dist/components/scenes/crypto/HashDisplay.svelte +30 -22
  254. package/dist/components/scenes/crypto/HashDisplay.svelte.d.ts +24 -1
  255. package/dist/components/scenes/crypto/SignatureDisplay.svelte +41 -40
  256. package/dist/components/scenes/crypto/SignatureDisplay.svelte.d.ts +24 -1
  257. package/dist/components/scenes/error/ErrorPage.svelte +135 -0
  258. package/dist/components/scenes/error/ErrorPage.svelte.d.ts +50 -0
  259. package/dist/components/scenes/error/error-presets.d.ts +60 -0
  260. package/dist/components/scenes/error/error-presets.js +51 -0
  261. package/dist/components/scenes/error/index.d.ts +8 -0
  262. package/dist/components/scenes/error/index.js +8 -0
  263. package/dist/components/scenes/guide/GuideHost.svelte +56 -0
  264. package/dist/components/scenes/guide/GuideHost.svelte.d.ts +35 -0
  265. package/dist/components/scenes/guide/GuideHostContent.svelte +136 -0
  266. package/dist/components/scenes/guide/GuideHostContent.svelte.d.ts +43 -0
  267. package/dist/components/scenes/guide/HelpCenter.svelte +135 -0
  268. package/dist/components/scenes/guide/HelpCenter.svelte.d.ts +40 -0
  269. package/dist/components/scenes/guide/index.d.ts +2 -0
  270. package/dist/components/scenes/guide/index.js +2 -0
  271. package/dist/components/scenes/iam/AgreementNotice.svelte +48 -0
  272. package/dist/components/scenes/iam/AgreementNotice.svelte.d.ts +7 -0
  273. package/dist/components/scenes/iam/AuthPanel.svelte +226 -0
  274. package/dist/components/scenes/iam/AuthPanel.svelte.d.ts +29 -0
  275. package/dist/components/scenes/iam/AuthShell.svelte +160 -0
  276. package/dist/components/scenes/iam/AuthShell.svelte.d.ts +56 -0
  277. package/dist/components/scenes/iam/ChangePasswordForm.svelte +84 -63
  278. package/dist/components/scenes/iam/ChangePasswordForm.svelte.d.ts +13 -1
  279. package/dist/components/scenes/iam/ForgotPasswordForm.svelte +113 -89
  280. package/dist/components/scenes/iam/ForgotPasswordForm.svelte.d.ts +24 -1
  281. package/dist/components/scenes/iam/LoginForm.svelte +215 -117
  282. package/dist/components/scenes/iam/LoginForm.svelte.d.ts +13 -1
  283. package/dist/components/scenes/iam/PasswordInput.svelte +79 -32
  284. package/dist/components/scenes/iam/PasswordInput.svelte.d.ts +30 -4
  285. package/dist/components/scenes/iam/PermGuard.svelte +21 -11
  286. package/dist/components/scenes/iam/PermGuard.svelte.d.ts +30 -0
  287. package/dist/components/scenes/iam/ReauthenticationDialog.svelte +68 -0
  288. package/dist/components/scenes/iam/ReauthenticationDialog.svelte.d.ts +17 -0
  289. package/dist/components/scenes/iam/RegisterForm.svelte +129 -116
  290. package/dist/components/scenes/iam/RegisterForm.svelte.d.ts +13 -1
  291. package/dist/components/scenes/iam/ResetPasswordForm.svelte +101 -88
  292. package/dist/components/scenes/iam/ResetPasswordForm.svelte.d.ts +13 -1
  293. package/dist/components/scenes/iam/SensitiveOperationsForm.svelte +76 -0
  294. package/dist/components/scenes/iam/SensitiveOperationsForm.svelte.d.ts +21 -0
  295. package/dist/components/scenes/iam/SessionRecoveryDialog.svelte +64 -0
  296. package/dist/components/scenes/iam/SessionRecoveryDialog.svelte.d.ts +22 -0
  297. package/dist/components/scenes/iam/UserProfile.svelte +47 -21
  298. package/dist/components/scenes/iam/UserProfile.svelte.d.ts +24 -1
  299. package/dist/components/scenes/iam/auth-captcha.d.ts +21 -0
  300. package/dist/components/scenes/iam/auth-captcha.js +23 -0
  301. package/dist/components/scenes/iam/auth-error-message.d.ts +13 -0
  302. package/dist/components/scenes/iam/auth-error-message.js +65 -0
  303. package/dist/components/scenes/iam/index.d.ts +10 -0
  304. package/dist/components/scenes/iam/index.js +9 -1
  305. package/dist/components/scenes/iam/password-utils.d.ts +33 -6
  306. package/dist/components/scenes/iam/password-utils.js +61 -8
  307. package/dist/components/scenes/iam/permission-context.svelte.d.ts +33 -23
  308. package/dist/components/scenes/iam/permission-context.svelte.js +20 -22
  309. package/dist/components/scenes/iam/sensitive-actions.svelte.d.ts +68 -0
  310. package/dist/components/scenes/iam/sensitive-actions.svelte.js +101 -0
  311. package/dist/components/scenes/iam/session-recovery.svelte.d.ts +44 -0
  312. package/dist/components/scenes/iam/session-recovery.svelte.js +57 -0
  313. package/dist/components/scenes/index.d.ts +3 -0
  314. package/dist/components/scenes/index.js +5 -0
  315. package/dist/components/scenes/storage/AvatarUpload.svelte +82 -68
  316. package/dist/components/scenes/storage/AvatarUpload.svelte.d.ts +23 -1
  317. package/dist/components/scenes/storage/FileList.svelte +19 -5
  318. package/dist/components/scenes/storage/FileList.svelte.d.ts +23 -1
  319. package/dist/components/scenes/storage/FileUpload.svelte +151 -96
  320. package/dist/components/scenes/storage/FileUpload.svelte.d.ts +24 -1
  321. package/dist/components/scenes/storage/ImageUpload.svelte +93 -94
  322. package/dist/components/scenes/storage/ImageUpload.svelte.d.ts +24 -1
  323. package/dist/components/scenes/types.d.ts +574 -42
  324. package/dist/guide-storage.d.ts +18 -0
  325. package/dist/guide-storage.js +79 -0
  326. package/dist/guide-types.d.ts +143 -0
  327. package/dist/guide-types.js +1 -0
  328. package/dist/guide.d.ts +3 -0
  329. package/dist/guide.js +3 -0
  330. package/dist/guide.svelte.d.ts +29 -0
  331. package/dist/guide.svelte.js +506 -0
  332. package/dist/i18n.svelte.d.ts +67 -4
  333. package/dist/i18n.svelte.js +106 -21
  334. package/dist/index.d.ts +6 -0
  335. package/dist/index.js +7 -0
  336. package/dist/internal/browser-safety.d.ts +88 -0
  337. package/dist/internal/browser-safety.js +140 -0
  338. package/dist/internal/dialog-focus.d.ts +21 -0
  339. package/dist/internal/dialog-focus.js +77 -0
  340. package/dist/internal/form-context.d.ts +92 -0
  341. package/dist/internal/form-context.js +70 -0
  342. package/dist/internal/form-validation.svelte.d.ts +70 -0
  343. package/dist/internal/form-validation.svelte.js +142 -0
  344. package/dist/internal/icon-safety.d.ts +14 -0
  345. package/dist/internal/icon-safety.js +40 -0
  346. package/dist/internal/locale.d.ts +21 -0
  347. package/dist/internal/locale.js +43 -0
  348. package/dist/message.svelte.d.ts +138 -0
  349. package/dist/message.svelte.js +149 -0
  350. package/dist/messagebox.svelte.d.ts +130 -0
  351. package/dist/messagebox.svelte.js +171 -0
  352. package/dist/messages/en-US.json +303 -16
  353. package/dist/messages/ja-JP.json +529 -0
  354. package/dist/messages/zh-CN.json +303 -16
  355. package/dist/messages.d.ts +25 -3
  356. package/dist/messages.js +23 -6
  357. package/dist/styles/design-tokens.css +4 -2
  358. package/dist/styles/eye-care.css +55 -0
  359. package/dist/styles/formal.css +55 -0
  360. package/dist/styles/global.css +86 -18
  361. package/dist/styles/guide.css +88 -0
  362. package/dist/styles/high-contrast.css +64 -0
  363. package/dist/styles/mobile.css +28 -0
  364. package/dist/styles/theme.css +43 -0
  365. package/dist/theme-config.d.ts +263 -10
  366. package/dist/theme-config.js +253 -17
  367. package/dist/toast.svelte.d.ts +210 -2
  368. package/dist/toast.svelte.js +305 -19
  369. package/dist/types.d.ts +787 -63
  370. package/dist/utils/platform.svelte.d.ts +28 -15
  371. package/dist/utils/platform.svelte.js +23 -16
  372. package/dist/utils.d.ts +121 -1
  373. package/dist/utils.js +208 -13
  374. package/dist/workspace-context.d.ts +20 -0
  375. package/dist/workspace-context.js +9 -0
  376. package/package.json +120 -24
  377. package/vite.d.ts +13 -0
  378. package/vite.js +96 -0
  379. package/dist/components/scenes/crud/CrudEditDrawer.svelte +0 -225
  380. package/dist/components/scenes/crud/CrudEditDrawer.svelte.d.ts +0 -48
@@ -1,4 +1,18 @@
1
1
  import type { DateValue } from '@internationalized/date';
2
+ import type { DataAttributes, FormText, Size } from '../../types.js';
3
+ /**
4
+ * DatePicker 组件的属性契约;通过公开组件配置使用。
5
+ *
6
+ * @example
7
+ * ```ts
8
+ * import { mount, unmount } from 'svelte'
9
+ * import type { ComponentProps } from 'svelte'
10
+ * import { DatePicker } from '@h-ai/ui'
11
+ * const props: ComponentProps<typeof DatePicker> = { weekStartsOn: 1, size: 'md' }
12
+ * const component = mount(DatePicker, { target: document.body, props })
13
+ * await unmount(component)
14
+ * ```
15
+ */
2
16
  interface Props {
3
17
  /** 选中日期(双向绑定) */
4
18
  value?: DateValue;
@@ -12,13 +26,16 @@ interface Props {
12
26
  isDateUnavailable?: (date: DateValue) => boolean;
13
27
  /** 是否禁用 */
14
28
  disabled?: boolean;
29
+ /** 尺寸 */
30
+ size?: Size;
15
31
  /** 错误消息 */
16
- error?: string;
32
+ error?: FormText;
17
33
  /** 自定义类名 */
18
34
  class?: string;
19
35
  /** 日期变更回调 */
20
36
  onchange?: (value: DateValue | undefined) => void;
21
37
  }
38
+ type $$ComponentProps = Props & DataAttributes;
22
39
  /**
23
40
  * DatePicker
24
41
  * 日期选择器组件,基于 Bits UI headless + DaisyUI 样式。
@@ -28,19 +45,21 @@ interface Props {
28
45
  * @prop {DateValue} minValue - 最小可选日期
29
46
  * @prop {DateValue} maxValue - 最大可选日期
30
47
  * @prop {string} placeholder - 输入框占位文本
48
+ * @prop {Size} size - 输入框尺寸
31
49
  * @prop {boolean} disabled - 是否禁用
32
50
  * @prop {string} error - 错误消息
33
51
  * @prop {function} onchange - 日期变更回调
34
52
  *
35
53
  * @example
36
- * ```svelte
37
- * <script>
38
- * import { CalendarDate } from '@internationalized/date'
39
- * let date = $state(new CalendarDate(2024, 6, 15))
40
- * </script>
41
- * <DatePicker bind:value={date} />
54
+ * ```ts
55
+ * import { mount, unmount } from 'svelte'
56
+ * import type { ComponentProps } from 'svelte'
57
+ * import { DatePicker } from '@h-ai/ui'
58
+ * const props: ComponentProps<typeof DatePicker> = { weekStartsOn: 1, size: 'md' }
59
+ * const component = mount(DatePicker, { target: document.body, props })
60
+ * await unmount(component)
42
61
  * ```
43
62
  */
44
- declare const DatePicker: import("svelte").Component<Props, {}, "value">;
63
+ declare const DatePicker: import("svelte").Component<$$ComponentProps, {}, "value">;
45
64
  type DatePicker = ReturnType<typeof DatePicker>;
46
65
  export default DatePicker;
@@ -1,4 +1,5 @@
1
1
  <!--
2
+ @component Drawer
2
3
  =============================================================================
3
4
  @h-ai/ui - Drawer 组件
4
5
  =============================================================================
@@ -7,27 +8,71 @@
7
8
  使用 Svelte 5 Runes ($props, $derived, $effect, $bindable)
8
9
  使用 primitives 组件:IconButton
9
10
  =============================================================================
11
+
12
+ @example
13
+ ```ts
14
+ import { mount, unmount, createRawSnippet } from 'svelte'
15
+ import type { ComponentProps } from 'svelte'
16
+ import { Drawer } from '@h-ai/ui'
17
+ const props: ComponentProps<typeof Drawer> = { open: true, title: '详情', position: 'right', width: '28rem', children: createRawSnippet(() => ({ render: () => "<span>详情内容</span>" })) }
18
+ const component = mount(Drawer, { target: document.body, props })
19
+ await unmount(component)
20
+ ```
10
21
  -->
11
22
  <script lang='ts'>
12
- import type { DrawerProps } from '../../types.js'
23
+ import type { DataAttributes, DrawerProps } from '../../types.js'
24
+ import { onDestroy, onMount, setContext } from 'svelte'
25
+ import { readStoredValue, writeStoredValue } from '../../internal/browser-safety.js'
26
+ import { focusDialog, handleDialogKeydown } from '../../internal/dialog-focus.js'
27
+ import { FORM_VISIBILITY_CONTEXT } from '../../internal/form-context.js'
13
28
  import { uiM } from '../../messages.js'
14
- import { cn, generateId } from '../../utils.js'
29
+ import { cn, getDataAttributes } from '../../utils.js'
15
30
  import IconButton from '../primitives/IconButton.svelte'
16
- import ToggleCheckbox from '../primitives/ToggleCheckbox.svelte'
17
31
 
18
32
  let {
19
33
  open = $bindable(false),
20
34
  title = '',
21
35
  position = 'right',
22
36
  size = 'md',
37
+ width,
38
+ resizable = false,
39
+ widthStorageKey,
23
40
  closeOnBackdrop = true,
41
+ closeOnEscape = true,
24
42
  showClose = true,
25
43
  class: className = '',
26
44
  onclose,
27
45
  children,
28
- }: DrawerProps = $props()
46
+ ...restProps
47
+ }: DrawerProps & DataAttributes = $props()
29
48
 
30
- const id = generateId('drawer')
49
+ const dataAttributes = $derived(getDataAttributes(restProps))
50
+ setContext(FORM_VISIBILITY_CONTEXT, {
51
+ get open() { return open },
52
+ })
53
+ const id = $props.id()
54
+ const titleId = `${id}-title`
55
+ let panel = $state<HTMLDivElement>()
56
+ let resizing = false
57
+ $effect(() => {
58
+ if (!open || !panel)
59
+ return
60
+ const restore = focusDialog(panel)
61
+ return () => {
62
+ finishResize()
63
+ restore()
64
+ }
65
+ })
66
+ /** 用户拖动后的像素宽度;优先于 width 与 size。 */
67
+ let resizedWidth = $state<number | null>(null)
68
+ /** 与响应式渲染解耦的同步宽度,确保 mouseup 时持久化最后一次 mousemove 的值。 */
69
+ let resizeWidthForStorage: number | null = null
70
+ /** 当前拖动起点的指针横坐标。 */
71
+ let resizeStartX = 0
72
+ /** 当前拖动起点的抽屉宽度。 */
73
+ let resizeStartWidth = 0
74
+ /** 拖动期间临时保存页面原有的文本选择样式。 */
75
+ let previousUserSelect = ''
31
76
 
32
77
  const sizeMap = {
33
78
  'xs': 'w-60',
@@ -40,6 +85,18 @@
40
85
  '4xl': 'w-[42rem]',
41
86
  }
42
87
 
88
+ // width 优先:传入自定义 CSS 宽度时通过 inline style 覆盖预设宽度类
89
+ const hasCustomWidth = $derived(typeof width === 'string' && width.trim().length > 0)
90
+ const widthStyle = $derived(
91
+ resizedWidth !== null
92
+ ? `width: ${resizedWidth}px; max-width: calc(100vw - 1rem)`
93
+ : hasCustomWidth
94
+ ? `width: ${width!.trim()}; max-width: 100vw`
95
+ : undefined,
96
+ )
97
+ /** 纵向抽屉没有横向宽度拖动语义。 */
98
+ const canResize = $derived(resizable && (position === 'left' || position === 'right'))
99
+
43
100
  const drawerClass = $derived(
44
101
  cn(
45
102
  'drawer',
@@ -55,13 +112,14 @@
55
112
 
56
113
  const contentClass = $derived(
57
114
  cn(
58
- 'menu bg-base-200 text-base-content min-h-full p-4',
59
- sizeMap[size],
115
+ 'menu relative z-10 bg-base-200 text-base-content min-h-full p-4',
116
+ !hasCustomWidth && sizeMap[size],
60
117
  className,
61
118
  ),
62
119
  )
63
120
 
64
121
  function handleClose() {
122
+ finishResize()
65
123
  open = false
66
124
  onclose?.()
67
125
  }
@@ -71,36 +129,135 @@
71
129
  handleClose()
72
130
  }
73
131
  }
132
+
133
+ /** 将宽度限制在可视区域内,并保留移动端可关闭抽屉的边距。 */
134
+ function clampWidth(nextWidth: number): number {
135
+ const maximum = Math.max(0, globalThis.innerWidth - 16)
136
+ const minimum = Math.min(280, maximum)
137
+ return Math.round(Math.min(Math.max(nextWidth, minimum), maximum))
138
+ }
139
+
140
+ /** 根据抽屉方向计算拖动宽度。 */
141
+ function handleResizeMove(event: MouseEvent) {
142
+ const delta = position === 'right'
143
+ ? resizeStartX - event.clientX
144
+ : event.clientX - resizeStartX
145
+ const nextWidth = clampWidth(resizeStartWidth + delta)
146
+ resizeWidthForStorage = nextWidth
147
+ resizedWidth = nextWidth
148
+ }
149
+
150
+ /** 结束拖动并在配置了 key 时记忆最终宽度。 */
151
+ function finishResize() {
152
+ if (typeof document === 'undefined' || !resizing)
153
+ return
154
+ resizing = false
155
+
156
+ globalThis.removeEventListener('mousemove', handleResizeMove)
157
+ globalThis.removeEventListener('mouseup', finishResize)
158
+ document.documentElement.style.userSelect = previousUserSelect
159
+ if (widthStorageKey && resizeWidthForStorage !== null) {
160
+ writeStoredValue(widthStorageKey, String(resizeWidthForStorage))
161
+ }
162
+ }
163
+
164
+ /** 从抽屉可见边缘开始宽度拖动。 */
165
+ function startResize(event: MouseEvent) {
166
+ if (!canResize)
167
+ return
168
+
169
+ const drawer = event.currentTarget instanceof HTMLElement
170
+ ? event.currentTarget.parentElement
171
+ : null
172
+ if (!drawer)
173
+ return
174
+
175
+ event.preventDefault()
176
+ resizeStartX = event.clientX
177
+ resizeStartWidth = drawer.getBoundingClientRect().width
178
+ resizeWidthForStorage = resizeStartWidth
179
+ previousUserSelect = document.documentElement.style.userSelect
180
+ resizing = true
181
+ document.documentElement.style.userSelect = 'none'
182
+ globalThis.addEventListener('mousemove', handleResizeMove)
183
+ globalThis.addEventListener('mouseup', finishResize, { once: true })
184
+ }
185
+
186
+ /** 键盘左右键以固定步长调整宽度,并立即持久化。 */
187
+ function handleResizeKeydown(event: KeyboardEvent) {
188
+ if (event.key !== 'ArrowLeft' && event.key !== 'ArrowRight')
189
+ return
190
+
191
+ const drawer = event.currentTarget instanceof HTMLElement
192
+ ? event.currentTarget.parentElement
193
+ : null
194
+ if (!drawer)
195
+ return
196
+
197
+ event.preventDefault()
198
+ const edgeDelta = event.key === 'ArrowLeft' ? -16 : 16
199
+ const nextWidth = clampWidth(drawer.getBoundingClientRect().width + (position === 'right' ? -edgeDelta : edgeDelta))
200
+ resizeWidthForStorage = nextWidth
201
+ resizedWidth = nextWidth
202
+ if (widthStorageKey) {
203
+ writeStoredValue(widthStorageKey, String(nextWidth))
204
+ }
205
+ }
206
+
207
+ onMount(() => {
208
+ if (!canResize || !widthStorageKey)
209
+ return
210
+
211
+ const storedWidth = Number(readStoredValue(widthStorageKey))
212
+ if (Number.isFinite(storedWidth) && storedWidth > 0) {
213
+ const nextWidth = clampWidth(storedWidth)
214
+ resizeWidthForStorage = nextWidth
215
+ resizedWidth = nextWidth
216
+ }
217
+ })
218
+
219
+ onDestroy(finishResize)
74
220
  </script>
75
221
 
76
- <div class={drawerClass}>
77
- <ToggleCheckbox {id} class='drawer-toggle' bind:checked={open} />
222
+ <div {...dataAttributes} class={drawerClass} role='presentation' onkeydown={(event) => {
223
+ if (open && panel)
224
+ handleDialogKeydown(event, panel, closeOnEscape ? handleClose : undefined)
225
+ }}>
226
+ <input {id} type='checkbox' class='drawer-toggle' tabindex='-1' aria-hidden='true' bind:checked={open} />
78
227
 
79
- <div class={sideClass}>
80
- <div
81
- role='button'
82
- tabindex='0'
228
+ <div class={sideClass} inert={!open}>
229
+ <button
230
+ type='button'
231
+ tabindex='-1'
83
232
  aria-label={uiM('drawer_close')}
84
233
  class='drawer-overlay'
85
234
  onclick={handleBackdropClick}
86
- onkeydown={e => e.key === 'Enter' && handleBackdropClick()}
87
- ></div>
235
+ ></button>
236
+
237
+ <div bind:this={panel} class={contentClass} style={widthStyle} role='dialog' aria-modal={open ? 'true' : undefined} aria-labelledby={title ? titleId : undefined} aria-label={title ? undefined : uiM('common_dialog')} tabindex='-1'>
238
+ {#if canResize}
239
+ <button
240
+ type='button'
241
+ aria-label={uiM('drawer_resize')}
242
+ data-drawer-resize-handle
243
+ class='absolute inset-y-0 z-20 hidden w-2 cursor-col-resize touch-none border-0 bg-transparent p-0 md:block {position === 'right' ? 'left-0' : 'right-0'}'
244
+ onmousedown={startResize}
245
+ onkeydown={handleResizeKeydown}
246
+ ></button>
247
+ {/if}
88
248
 
89
- <div class={contentClass}>
90
249
  <div class='flex items-center justify-between mb-4'>
91
250
  {#if title}
92
- <h3 class='text-lg font-bold'>{title}</h3>
251
+ <h3 id={titleId} class='text-lg font-bold'>{title}</h3>
93
252
  {:else}
94
253
  <div></div>
95
254
  {/if}
96
255
 
97
256
  {#if showClose}
98
257
  <IconButton size='sm' variant='ghost' label={uiM('common_close')} onclick={handleClose}>
99
- {#snippet children()}
100
- <svg xmlns='http://www.w3.org/2000/svg' class='h-5 w-5' fill='none' viewBox='0 0 24 24' stroke='currentColor'>
101
- <path stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M6 18L18 6M6 6l12 12' />
102
- </svg>
103
- {/snippet}
258
+ <svg xmlns='http://www.w3.org/2000/svg' class='h-5 w-5' fill='none' viewBox='0 0 24 24' stroke='currentColor'>
259
+ <path stroke-linecap='round' stroke-linejoin='round' stroke-width='2' d='M6 18L18 6M6 6l12 12' />
260
+ </svg>
104
261
  </IconButton>
105
262
  {/if}
106
263
  </div>
@@ -1,4 +1,26 @@
1
- import type { DrawerProps } from '../../types.js';
2
- declare const Drawer: import("svelte").Component<DrawerProps, {}, "open">;
1
+ import type { DataAttributes, DrawerProps } from '../../types.js';
2
+ type $$ComponentProps = DrawerProps & DataAttributes;
3
+ /**
4
+ * Drawer
5
+ * =============================================================================
6
+ * @h-ai/ui - Drawer 组件
7
+ * =============================================================================
8
+ * 抽屉组件
9
+ *
10
+ * 使用 Svelte 5 Runes ($props, $derived, $effect, $bindable)
11
+ * 使用 primitives 组件:IconButton
12
+ * =============================================================================
13
+ *
14
+ * @example
15
+ * ```ts
16
+ * import { mount, unmount, createRawSnippet } from 'svelte'
17
+ * import type { ComponentProps } from 'svelte'
18
+ * import { Drawer } from '@h-ai/ui'
19
+ * const props: ComponentProps<typeof Drawer> = { open: true, title: '详情', position: 'right', width: '28rem', children: createRawSnippet(() => ({ render: () => "<span>详情内容</span>" })) }
20
+ * const component = mount(Drawer, { target: document.body, props })
21
+ * await unmount(component)
22
+ * ```
23
+ */
24
+ declare const Drawer: import("svelte").Component<$$ComponentProps, {}, "open">;
3
25
  type Drawer = ReturnType<typeof Drawer>;
4
26
  export default Drawer;
@@ -1,10 +1,20 @@
1
1
  <!--
2
2
  @component Dropdown
3
3
  下拉菜单组件,支持 click/hover 触发。
4
+
5
+ @example
6
+ ```ts
7
+ import { mount, unmount } from 'svelte'
8
+ import type { ComponentProps } from 'svelte'
9
+ import { Dropdown } from '@h-ai/ui'
10
+ const props: ComponentProps<typeof Dropdown> = { items: [{ key: 'edit', label: '编辑' }], position: 'bottom' }
11
+ const component = mount(Dropdown, { target: document.body, props })
12
+ await unmount(component)
13
+ ```
4
14
  -->
5
15
  <script lang='ts'>
6
- import type { DropdownProps } from '../../types.js'
7
- import { cn } from '../../utils.js'
16
+ import type { DataAttributes, DropdownProps } from '../../types.js'
17
+ import { cn, getDataAttributes } from '../../utils.js'
8
18
  import BareButton from '../primitives/BareButton.svelte'
9
19
 
10
20
  const {
@@ -13,10 +23,13 @@
13
23
  position = 'bottom',
14
24
  align = 'start',
15
25
  class: className = '',
26
+ triggerClass = '',
16
27
  onselect,
17
28
  children,
18
- }: DropdownProps = $props()
29
+ ...restProps
30
+ }: DropdownProps & DataAttributes = $props()
19
31
 
32
+ const dataAttributes = $derived(getDataAttributes(restProps))
20
33
  let isOpen = $state(false)
21
34
 
22
35
  const positionMap = {
@@ -55,10 +68,11 @@
55
68
  }
56
69
  </script>
57
70
 
58
- <div class={dropdownClass}>
71
+ <div {...dataAttributes} class={dropdownClass}>
59
72
  <BareButton
60
73
  tabindex={0}
61
74
  role='button'
75
+ class={triggerClass}
62
76
  onclick={toggleDropdown}
63
77
  onkeydown={e => e.key === 'Enter' && toggleDropdown()}
64
78
  >
@@ -69,7 +83,7 @@
69
83
 
70
84
  <!-- svelte-ignore a11y_no_noninteractive_tabindex -->
71
85
  <ul tabindex='0' class='dropdown-content menu bg-base-100 rounded-xl z-[1] w-52 p-1.5 shadow-lg border border-base-content/6 animate-[hai-scale-in_0.15s_cubic-bezier(0.16,1,0.3,1)]'>
72
- {#each items as item}
86
+ {#each items as item, index (item.key || `divider-${index}`)}
73
87
  {#if item.divider}
74
88
  <li class='divider'></li>
75
89
  {:else}
@@ -1,8 +1,19 @@
1
- import type { DropdownProps } from '../../types.js';
1
+ import type { DataAttributes, DropdownProps } from '../../types.js';
2
+ type $$ComponentProps = DropdownProps & DataAttributes;
2
3
  /**
3
4
  * Dropdown
4
5
  * 下拉菜单组件,支持 click/hover 触发。
6
+ *
7
+ * @example
8
+ * ```ts
9
+ * import { mount, unmount } from 'svelte'
10
+ * import type { ComponentProps } from 'svelte'
11
+ * import { Dropdown } from '@h-ai/ui'
12
+ * const props: ComponentProps<typeof Dropdown> = { items: [{ key: 'edit', label: '编辑' }], position: 'bottom' }
13
+ * const component = mount(Dropdown, { target: document.body, props })
14
+ * await unmount(component)
15
+ * ```
5
16
  */
6
- declare const Dropdown: import("svelte").Component<DropdownProps, {}, "">;
17
+ declare const Dropdown: import("svelte").Component<$$ComponentProps, {}, "">;
7
18
  type Dropdown = ReturnType<typeof Dropdown>;
8
19
  export default Dropdown;
@@ -1,4 +1,5 @@
1
1
  <!--
2
+ @component Empty
2
3
  =============================================================================
3
4
  @h-ai/ui - Empty 组件
4
5
  =============================================================================
@@ -6,11 +7,21 @@
6
7
 
7
8
  使用 Svelte 5 Runes ($props, $derived)
8
9
  =============================================================================
10
+
11
+ @example
12
+ ```ts
13
+ import { mount, unmount } from 'svelte'
14
+ import type { ComponentProps } from 'svelte'
15
+ import { Empty } from '@h-ai/ui'
16
+ const props: ComponentProps<typeof Empty> = { title: '暂无记录', icon: 'inbox' }
17
+ const component = mount(Empty, { target: document.body, props })
18
+ await unmount(component)
19
+ ```
9
20
  -->
10
21
  <script lang='ts'>
11
- import type { EmptyProps } from '../../types.js'
22
+ import type { DataAttributes, EmptyProps } from '../../types.js'
12
23
  import { uiM } from '../../messages.js'
13
- import { cn } from '../../utils.js'
24
+ import { cn, getDataAttributes } from '../../utils.js'
14
25
 
15
26
  const {
16
27
  title,
@@ -20,13 +31,15 @@
20
31
  class: className = '',
21
32
  action,
22
33
  children,
23
- }: EmptyProps = $props()
34
+ ...restProps
35
+ }: EmptyProps & DataAttributes = $props()
24
36
 
37
+ const dataAttributes = $derived(getDataAttributes(restProps))
25
38
  const displayTitle = $derived(title ?? uiM('empty_title'))
26
39
 
27
40
  const containerClass = $derived(
28
41
  cn(
29
- 'flex flex-col items-center justify-center py-8 text-center',
42
+ 'flex min-w-0 flex-col items-center justify-center px-4 py-8 text-center',
30
43
  size === 'sm' && 'py-4',
31
44
  size === 'lg' && 'py-12',
32
45
  className,
@@ -42,9 +55,9 @@
42
55
  )
43
56
  </script>
44
57
 
45
- <div class={containerClass}>
58
+ <div {...dataAttributes} class={containerClass}>
46
59
  <!-- 图标区域 -->
47
- <div class='text-base-content/30 mb-4 {iconSize}'>
60
+ <div class='text-base-content/40 mb-4 shrink-0 {iconSize}' aria-hidden='true'>
48
61
  {#if children}
49
62
  {@render children()}
50
63
  {:else if icon === 'inbox'}
@@ -67,16 +80,16 @@
67
80
  </div>
68
81
 
69
82
  <!-- 标题 -->
70
- <h3 class='font-medium text-base-content/70 {titleSize}'>{displayTitle}</h3>
83
+ <h3 class='max-w-full font-medium text-base-content/80 [overflow-wrap:anywhere] {titleSize}'>{displayTitle}</h3>
71
84
 
72
85
  <!-- 描述 -->
73
86
  {#if description}
74
- <p class='mt-1 text-sm text-base-content/50 max-w-sm'>{description}</p>
87
+ <p class='mt-2 max-w-prose text-sm text-base-content/70 leading-relaxed [overflow-wrap:anywhere]'>{description}</p>
75
88
  {/if}
76
89
 
77
90
  <!-- 操作按钮插槽 -->
78
91
  {#if action}
79
- <div class='mt-4'>
92
+ <div class='mt-5 flex max-w-full flex-wrap justify-center gap-2'>
80
93
  {@render action()}
81
94
  </div>
82
95
  {/if}
@@ -1,4 +1,25 @@
1
- import type { EmptyProps } from '../../types.js';
2
- declare const Empty: import("svelte").Component<EmptyProps, {}, "">;
1
+ import type { DataAttributes, EmptyProps } from '../../types.js';
2
+ type $$ComponentProps = EmptyProps & DataAttributes;
3
+ /**
4
+ * Empty
5
+ * =============================================================================
6
+ * @h-ai/ui - Empty 组件
7
+ * =============================================================================
8
+ * 空状态展示组件
9
+ *
10
+ * 使用 Svelte 5 Runes ($props, $derived)
11
+ * =============================================================================
12
+ *
13
+ * @example
14
+ * ```ts
15
+ * import { mount, unmount } from 'svelte'
16
+ * import type { ComponentProps } from 'svelte'
17
+ * import { Empty } from '@h-ai/ui'
18
+ * const props: ComponentProps<typeof Empty> = { title: '暂无记录', icon: 'inbox' }
19
+ * const component = mount(Empty, { target: document.body, props })
20
+ * await unmount(component)
21
+ * ```
22
+ */
23
+ declare const Empty: import("svelte").Component<$$ComponentProps, {}, "">;
3
24
  type Empty = ReturnType<typeof Empty>;
4
25
  export default Empty;
@@ -0,0 +1,82 @@
1
+ <!--
2
+ @component FilterBar
3
+ 常用搜索与操作保持可见,更多筛选可展开收起;收起不卸载控件或清除值。
4
+ @example
5
+ ```ts
6
+ import type { ComponentProps } from 'svelte'
7
+ import { FilterBar } from '@h-ai/ui/components/compounds/index'
8
+ const props: Pick<ComponentProps<typeof FilterBar>, 'expanded' | 'activeCount'> = { expanded: false, activeCount: 2 }
9
+ ```
10
+ -->
11
+ <script lang='ts'>
12
+ import type { Snippet } from 'svelte'
13
+ import type { DataAttributes } from '../../types.js'
14
+ import { uiM } from '../../messages.js'
15
+ import { cn, getDataAttributes } from '../../utils.js'
16
+ import Button from '../primitives/Button.svelte'
17
+
18
+ /** FilterBar 组件的属性契约。
19
+ * @example
20
+ * ```ts
21
+ * import type { ComponentProps } from 'svelte'
22
+ * import { FilterBar } from '@h-ai/ui'
23
+ * const props: Partial<ComponentProps<typeof FilterBar>> = {}
24
+ * void props
25
+ * ```
26
+ */
27
+ interface Props extends DataAttributes {
28
+ /** 常驻搜索或主要条件。 */
29
+ leading?: Snippet
30
+ /** 查询、重置和业务操作。 */
31
+ actions?: Snippet
32
+ /** 可收起的筛选字段。 */
33
+ children?: Snippet
34
+ /** 是否展开;默认收起,可 bind:expanded。 */
35
+ expanded?: boolean
36
+ /** 已启用条件数量,收起时仍提示。 */
37
+ activeCount?: number
38
+ /** 清空查询与全部筛选;按钮文案由 UI 提供。 */
39
+ onreset?: () => void
40
+ class?: string
41
+ }
42
+ let { leading, actions, children, expanded = $bindable(false), activeCount = 0, onreset, class: className = '', ...restProps }: Props = $props()
43
+ const dataAttributes = $derived(getDataAttributes(restProps))
44
+ const panelId = $props.id()
45
+ const toggleLabel = $derived(uiM(expanded ? 'filter_bar_collapse' : 'filter_bar_expand'))
46
+ </script>
47
+
48
+ <div {...dataAttributes} class={cn('hai-filter-bar min-w-0 space-y-3 [&_.fieldset]:m-0 [&_.fieldset]:p-0 [&_.fieldset]:min-w-0', className)}>
49
+ <div class='flex min-w-0 flex-wrap items-center gap-2'>
50
+ {#if leading}<div class='flex min-w-0 max-w-full flex-[1_1_14rem] flex-wrap items-center gap-2'>{@render leading()}</div>{/if}
51
+ <div class='ml-auto flex max-w-full shrink-0 flex-wrap items-center gap-2'>
52
+ {#if actions}{@render actions()}{/if}
53
+ {#if onreset}<Button type='button' variant='ghost' size='sm' onclick={onreset}>{uiM('crud_reset')}</Button>{/if}
54
+ {#if children}
55
+ <button type='button' class='hai-filter-bar__toggle inline-flex h-8 items-center gap-1.5 whitespace-nowrap rounded-md px-2 text-sm text-base-content/65 hover:bg-base-content/5 hover:text-base-content' aria-expanded={expanded} aria-controls={panelId} onclick={() => { expanded = !expanded }}>
56
+ <span>{toggleLabel}</span>
57
+ {#if activeCount > 0}<span class='rounded bg-primary/10 px-1.5 text-xs text-primary' aria-label={uiM('filter_bar_active').replace('{count}', String(activeCount))}>{activeCount}</span>{/if}
58
+ <span class='icon-[tabler--chevron-down] size-4 transition-transform' class:rotate-180={expanded} aria-hidden='true'></span>
59
+ </button>
60
+ {/if}
61
+ </div>
62
+ </div>
63
+ {#if children}
64
+ <div id={panelId} hidden={!expanded} class={expanded ? 'hai-filter-bar__panel flex min-w-0 flex-wrap items-start gap-4 border-t border-base-content/8 pt-3 pb-1' : 'hidden'}>
65
+ {@render children()}
66
+ </div>
67
+ {/if}
68
+ </div>
69
+
70
+ <style>
71
+ .hai-filter-bar__panel {
72
+ max-height: min(26rem, 50dvh);
73
+ overflow-y: auto;
74
+ }
75
+
76
+ @media (pointer: coarse) {
77
+ .hai-filter-bar__toggle {
78
+ min-height: var(--hai-touch-target-min, 44px);
79
+ min-width: var(--hai-touch-target-min, 44px);
80
+ }
81
+ }
82
+ </style>
@@ -0,0 +1,39 @@
1
+ import type { Snippet } from 'svelte';
2
+ import type { DataAttributes } from '../../types.js';
3
+ /** FilterBar 组件的属性契约。
4
+ * @example
5
+ * ```ts
6
+ * import type { ComponentProps } from 'svelte'
7
+ * import { FilterBar } from '@h-ai/ui'
8
+ * const props: Partial<ComponentProps<typeof FilterBar>> = {}
9
+ * void props
10
+ * ```
11
+ */
12
+ interface Props extends DataAttributes {
13
+ /** 常驻搜索或主要条件。 */
14
+ leading?: Snippet;
15
+ /** 查询、重置和业务操作。 */
16
+ actions?: Snippet;
17
+ /** 可收起的筛选字段。 */
18
+ children?: Snippet;
19
+ /** 是否展开;默认收起,可 bind:expanded。 */
20
+ expanded?: boolean;
21
+ /** 已启用条件数量,收起时仍提示。 */
22
+ activeCount?: number;
23
+ /** 清空查询与全部筛选;按钮文案由 UI 提供。 */
24
+ onreset?: () => void;
25
+ class?: string;
26
+ }
27
+ /**
28
+ * FilterBar
29
+ * 常用搜索与操作保持可见,更多筛选可展开收起;收起不卸载控件或清除值。
30
+ * @example
31
+ * ```ts
32
+ * import type { ComponentProps } from 'svelte'
33
+ * import { FilterBar } from '@h-ai/ui/components/compounds/index'
34
+ * const props: Pick<ComponentProps<typeof FilterBar>, 'expanded' | 'activeCount'> = { expanded: false, activeCount: 2 }
35
+ * ```
36
+ */
37
+ declare const FilterBar: import("svelte").Component<Props, {}, "expanded">;
38
+ type FilterBar = ReturnType<typeof FilterBar>;
39
+ export default FilterBar;