@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,5 @@
1
1
  <!--
2
+ @component Timeline
2
3
  =============================================================================
3
4
  @h-ai/ui - Timeline 组件
4
5
  =============================================================================
@@ -7,13 +8,37 @@
7
8
  使用 Svelte 5 Runes ($props, $derived)
8
9
  使用 DaisyUI timeline 类
9
10
  =============================================================================
11
+
12
+ @example
13
+ ```ts
14
+ import { mount, unmount } from 'svelte'
15
+ import type { ComponentProps } from 'svelte'
16
+ import { Timeline } from '@h-ai/ui'
17
+ const props: ComponentProps<typeof Timeline> = { items: [{ id: 'created', title: '已创建', time: '2026-01-01', completed: true }] }
18
+ const component = mount(Timeline, { 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 { TimelineItem } from './timeline-types.js'
15
- import { cn } from '../../utils.js'
27
+ import { cn, getDataAttributes } from '../../utils.js'
16
28
 
29
+ /**
30
+ * Timeline 组件的属性契约;通过公开组件配置使用。
31
+ *
32
+ * @example
33
+ * ```ts
34
+ * import { mount, unmount } from 'svelte'
35
+ * import type { ComponentProps } from 'svelte'
36
+ * import { Timeline } from '@h-ai/ui'
37
+ * const props: ComponentProps<typeof Timeline> = { items: [{ id: 'created', title: '已创建', time: '2026-01-01', completed: true }] }
38
+ * const component = mount(Timeline, { target: document.body, props })
39
+ * await unmount(component)
40
+ * ```
41
+ */
17
42
  interface Props {
18
43
  /** 时间线项数据 */
19
44
  items: TimelineItem[]
@@ -45,8 +70,10 @@
45
70
  snapIcon = false,
46
71
  class: className = '',
47
72
  children,
48
- }: Props = $props()
73
+ ...restProps
74
+ }: Props & DataAttributes = $props()
49
75
 
76
+ const dataAttributes = $derived(getDataAttributes(restProps))
50
77
  const timelineClass = $derived(
51
78
  cn(
52
79
  'timeline',
@@ -95,7 +122,7 @@
95
122
  }
96
123
  </script>
97
124
 
98
- <ul class={timelineClass}>
125
+ <ul {...dataAttributes} class={timelineClass}>
99
126
  {#each items as item, index (item.id)}
100
127
  <li>
101
128
  <!-- 前置连线 -->
@@ -1,5 +1,19 @@
1
1
  import type { Snippet } from 'svelte';
2
+ import type { DataAttributes } from '../../types.js';
2
3
  import type { TimelineItem } from './timeline-types.js';
4
+ /**
5
+ * Timeline 组件的属性契约;通过公开组件配置使用。
6
+ *
7
+ * @example
8
+ * ```ts
9
+ * import { mount, unmount } from 'svelte'
10
+ * import type { ComponentProps } from 'svelte'
11
+ * import { Timeline } from '@h-ai/ui'
12
+ * const props: ComponentProps<typeof Timeline> = { items: [{ id: 'created', title: '已创建', time: '2026-01-01', completed: true }] }
13
+ * const component = mount(Timeline, { target: document.body, props })
14
+ * await unmount(component)
15
+ * ```
16
+ */
3
17
  interface Props {
4
18
  /** 时间线项数据 */
5
19
  items: TimelineItem[];
@@ -20,6 +34,28 @@ interface Props {
20
34
  /** 自定义项渲染 */
21
35
  children?: Snippet<[TimelineItem, number]>;
22
36
  }
23
- declare const Timeline: import("svelte").Component<Props, {}, "">;
37
+ type $$ComponentProps = Props & DataAttributes;
38
+ /**
39
+ * Timeline
40
+ * =============================================================================
41
+ * @h-ai/ui - Timeline 组件
42
+ * =============================================================================
43
+ * 时间线组件,支持垂直/水平方向、多种样式变体
44
+ *
45
+ * 使用 Svelte 5 Runes ($props, $derived)
46
+ * 使用 DaisyUI timeline 类
47
+ * =============================================================================
48
+ *
49
+ * @example
50
+ * ```ts
51
+ * import { mount, unmount } from 'svelte'
52
+ * import type { ComponentProps } from 'svelte'
53
+ * import { Timeline } from '@h-ai/ui'
54
+ * const props: ComponentProps<typeof Timeline> = { items: [{ id: 'created', title: '已创建', time: '2026-01-01', completed: true }] }
55
+ * const component = mount(Timeline, { target: document.body, props })
56
+ * await unmount(component)
57
+ * ```
58
+ */
59
+ declare const Timeline: import("svelte").Component<$$ComponentProps, {}, "">;
24
60
  type Timeline = ReturnType<typeof Timeline>;
25
61
  export default Timeline;
@@ -1,59 +1,428 @@
1
1
  <!--
2
+ @component
2
3
  =============================================================================
3
4
  @h-ai/ui - ToastContainer 组件
4
5
  =============================================================================
5
- Toast 容器组件,显示所有 Toast 通知
6
+ 浮动操作提示容器,按先后顺序逐条显示,不占用页面布局。
6
7
 
7
- 使用 Svelte 5 Runes ($derived)
8
+ 使用 Svelte 5 Runes ($derived / $effect)
9
+
10
+ 叠加策略(关键):原生 <dialog>.showModal() 处于浏览器 top layer,且在 Chromium 中
11
+ 始终渲染在 Popover 之上。为保证 Toast 永远可见、不被弹窗遮挡:
12
+ - 当存在已打开的 modal dialog 时,将 Toast 层寄宿到该 dialog 内部(同处 top layer,
13
+ 作为最后子节点渲染在其内容之上);
14
+ - 否则寄宿到 <body> 并以 Popover 进入 top layer,叠加在普通内容之上。
8
15
  =============================================================================
16
+
17
+ @example
18
+ ```ts
19
+ import { mount, unmount } from 'svelte'
20
+ import type { ComponentProps } from 'svelte'
21
+ import { ToastContainer } from '@h-ai/ui'
22
+ const props: ComponentProps<typeof ToastContainer> = { 'data-testid': 'toasts' }
23
+ const component = mount(ToastContainer, { target: document.body, props })
24
+ await unmount(component)
25
+ ```
9
26
  -->
10
27
  <script lang='ts'>
28
+ import type { DataAttributes } from '../../types.js'
29
+ import { onMount, untrack } from 'svelte'
30
+ import { writeTextToClipboard } from '../../internal/browser-safety.js'
11
31
  import { uiM } from '../../messages.js'
12
32
  import { toast } from '../../toast.svelte.js'
13
- import { cn, getAlertVariantClass } from '../../utils.js'
33
+ import { cn, getDataAttributes } from '../../utils.js'
14
34
  import IconButton from '../primitives/IconButton.svelte'
15
35
 
16
- const positionMap = {
17
- 'top-right': 'toast-top toast-end',
18
- 'top-left': 'toast-top toast-start',
19
- 'bottom-right': 'toast-bottom toast-end',
20
- 'bottom-left': 'toast-bottom toast-start',
21
- 'top-center': 'toast-top toast-center',
22
- 'bottom-center': 'toast-bottom toast-center',
36
+ const { ...restProps }: DataAttributes = $props()
37
+ const dataAttributes = $derived(getDataAttributes(restProps))
38
+
39
+ const iconMap = {
40
+ info: 'icon-[tabler--info-circle] text-info',
41
+ success: 'icon-[tabler--circle-check] text-success',
42
+ warning: 'icon-[tabler--alert-triangle] text-warning',
43
+ error: 'icon-[tabler--circle-x] text-error',
44
+ }
45
+
46
+ // 容器根元素引用。
47
+ let layerElement: HTMLDivElement | undefined = $state()
48
+
49
+ const hasItems = $derived(toast.items.length > 0)
50
+
51
+ const currentItems = $derived(toast.items.slice(0, 1))
52
+ let expandedId = $state<string>()
53
+ let hoveredId = $state<string>()
54
+ let focusedId = $state<string>()
55
+ let copyResult = $state<{ id: string, success: boolean }>()
56
+
57
+ // 阅读、选择编号或键盘操作期间不自动关闭;交互结束后使用剩余时间继续计时。
58
+ $effect(() => {
59
+ const id = currentItems[0]?.id
60
+ if (!id)
61
+ return
62
+ const paused = expandedId === id || hoveredId === id || focusedId === id
63
+ untrack(() => paused ? toast.pause(id) : toast.resume(id))
64
+ return () => untrack(() => toast.resume(id))
65
+ })
66
+
67
+ async function copyTrace(id: string, traceId: string) {
68
+ const active = document.activeElement
69
+ const success = await writeTextToClipboard(traceId)
70
+ if (currentItems[0]?.id === id) {
71
+ copyResult = { id, success }
72
+ // execCommand 回退可能临时移动焦点,复制后继续留在当前操作。
73
+ if (active instanceof HTMLElement && active.isConnected)
74
+ active.focus({ preventScroll: true })
75
+ }
76
+ }
77
+
78
+ // Toast 可位于 Modal 的焦点循环之外;F8 提供统一入口,关闭后返回原操作。
79
+ let previousFocus: HTMLElement | null = null
80
+
81
+ function restoreFocus() {
82
+ if (previousFocus?.isConnected && !previousFocus.matches(':disabled'))
83
+ previousFocus.focus({ preventScroll: true })
84
+ previousFocus = null
85
+ }
86
+
87
+ function dismiss(id: string) {
88
+ if (layerElement?.contains(document.activeElement))
89
+ restoreFocus()
90
+ toast.remove(id)
91
+ }
92
+
93
+ function handleShortcut(event: KeyboardEvent) {
94
+ if (event.defaultPrevented || event.isComposing || event.ctrlKey || event.altKey || event.metaKey || !hasItems)
95
+ return
96
+ const inside = layerElement?.contains(document.activeElement)
97
+ if (event.key === 'F8') {
98
+ event.preventDefault()
99
+ if (inside) {
100
+ restoreFocus()
101
+ }
102
+ else {
103
+ previousFocus = document.activeElement instanceof HTMLElement ? document.activeElement : null
104
+ const target = layerElement?.querySelector<HTMLElement>('button, .hai-toast-item')
105
+ // 优先聚焦排查或关闭按钮;没有按钮的提示仍可聚焦阅读,再按 F8 返回。
106
+ const button = layerElement?.querySelector<HTMLButtonElement>('button')
107
+ ;(button ?? target)?.focus({ preventScroll: true })
108
+ }
109
+ }
110
+ else if (event.key === 'Escape' && inside) {
111
+ event.preventDefault()
112
+ event.stopPropagation()
113
+ const item = currentItems[0]
114
+ if (item?.dismissible)
115
+ dismiss(item.id)
116
+ else
117
+ restoreFocus()
118
+ }
119
+ }
120
+
121
+ // 在当前 DOM 被移除前恢复焦点,涵盖自动关闭、外部 clear/remove 及卸载。
122
+ $effect.pre(() => {
123
+ void currentItems[0]?.id
124
+ return () => {
125
+ if (layerElement?.contains(document.activeElement))
126
+ restoreFocus()
127
+ }
128
+ })
129
+
130
+ /** 找到最顶层处于打开状态的原生 modal dialog(位于浏览器 top layer)。 */
131
+ function findTopModalDialog(): HTMLDialogElement | null {
132
+ if (typeof document === 'undefined') {
133
+ return null
134
+ }
135
+
136
+ const dialogs = document.querySelectorAll<HTMLDialogElement>('dialog')
137
+ let top: HTMLDialogElement | null = null
138
+ for (const dialog of dialogs) {
139
+ if (dialog.open && typeof dialog.matches === 'function' && dialog.matches(':modal')) {
140
+ top = dialog
141
+ }
142
+ }
143
+ return top
144
+ }
145
+
146
+ function safeShowPopover(el: HTMLElement) {
147
+ try {
148
+ if (typeof el.showPopover === 'function' && el.isConnected && !el.matches(':popover-open')) {
149
+ el.showPopover()
150
+ }
151
+ }
152
+ catch {
153
+ // 元素未连接或重复调用时忽略。
154
+ }
155
+ }
156
+
157
+ function safeHidePopover(el: HTMLElement) {
158
+ try {
159
+ if (typeof el.hidePopover === 'function' && el.matches(':popover-open')) {
160
+ el.hidePopover()
161
+ }
162
+ }
163
+ catch {
164
+ // 同上,忽略异常。
165
+ }
166
+ }
167
+
168
+ /**
169
+ * 将 Toast 层寄宿到正确的容器:
170
+ * - 有打开的 modal dialog 时,去掉 popover 属性并寄宿到该 dialog 内部,渲染在其内容之上;
171
+ * - 否则寄宿到 <body>,恢复 popover 属性并按需进入 / 退出 top layer。
172
+ */
173
+ function relocate() {
174
+ const el = layerElement
175
+ if (!el) {
176
+ return
177
+ }
178
+
179
+ const modal = hasItems ? findTopModalDialog() : null
180
+
181
+ if (modal) {
182
+ // 寄宿到 dialog:popover 元素未显示时会 display:none,故先移除 popover 属性。
183
+ safeHidePopover(el)
184
+ if (el.hasAttribute('popover')) {
185
+ el.removeAttribute('popover')
186
+ }
187
+ if (el.parentElement !== modal) {
188
+ modal.appendChild(el)
189
+ }
190
+ return
191
+ }
192
+
193
+ if (el.parentElement !== document.body) {
194
+ document.body.appendChild(el)
195
+ }
196
+ // 部分宿主仅实现 popover 的隐藏样式;移除属性才能保持回退层可见、可聚焦。
197
+ if (typeof el.showPopover !== 'function') {
198
+ el.removeAttribute('popover')
199
+ return
200
+ }
201
+ if (!el.hasAttribute('popover')) {
202
+ el.setAttribute('popover', 'manual')
203
+ }
204
+ if (hasItems) {
205
+ safeShowPopover(el)
206
+ }
207
+ else {
208
+ safeHidePopover(el)
209
+ }
23
210
  }
24
211
 
25
- // 按位置分组
26
- const groupedItems = $derived(() => {
27
- const groups: Record<string, typeof toast.items> = {}
212
+ onMount(() => {
213
+ relocate()
214
+
215
+ // dialog 通过 showModal()/close() 切换 `open` 属性;据此重新寄宿 Toast 层。
216
+ const observer = new MutationObserver(() => relocate())
217
+ observer.observe(document.body, { subtree: true, attributes: true, attributeFilter: ['open'] })
28
218
 
29
- for (const item of toast.items) {
30
- const position = item.position ?? 'top-right'
31
- if (!groups[position]) {
32
- groups[position] = []
219
+ return () => {
220
+ observer.disconnect()
221
+ const el = layerElement
222
+ if (el) {
223
+ safeHidePopover(el)
224
+ el.remove()
33
225
  }
34
- groups[position].push(item)
35
226
  }
227
+ })
36
228
 
37
- return groups
229
+ // Toast 数量变化时重新寄宿(出现 / 消失、以及在 dialog 与 body 之间切换)。
230
+ $effect(() => {
231
+ void hasItems
232
+ relocate()
38
233
  })
39
234
  </script>
40
235
 
41
- {#each Object.entries(groupedItems()) as [position, items]}
42
- <div class={cn('toast z-50', positionMap[position as keyof typeof positionMap])}>
43
- {#each items as item (item.id)}
44
- <div class={cn('alert', getAlertVariantClass(item.variant ?? 'info'))}>
45
- <span>{item.message}</span>
236
+ <svelte:window onkeydown={handleShortcut} />
237
+
238
+ <div {...dataAttributes} bind:this={layerElement} popover='manual' class='hai-toast-layer'>
239
+ {#each currentItems as item (item.id)}
240
+ <div class='hai-toast-position' data-position={item.position ?? 'bottom-right'}>
241
+ <div {...getDataAttributes(item)} class='hai-toast-item text-base-content' role={item.variant === 'error' ? 'alert' : 'status'} aria-live={item.variant === 'error' ? 'assertive' : 'polite'} aria-atomic='true' aria-keyshortcuts='F8' tabindex='-1' data-variant={item.variant ?? 'info'}
242
+ onpointerenter={(event) => {
243
+ if (event.pointerType !== 'touch')
244
+ hoveredId = item.id
245
+ }}
246
+ onpointerleave={() => { hoveredId = undefined }}
247
+ onfocusin={() => { focusedId = item.id }}
248
+ onfocusout={(event) => {
249
+ if (!(event.relatedTarget instanceof Node) || !event.currentTarget.contains(event.relatedTarget))
250
+ focusedId = undefined
251
+ }}
252
+ >
253
+ <span aria-hidden='true' class={cn('size-5 shrink-0', iconMap[item.variant as keyof typeof iconMap] ?? iconMap.info)}></span>
254
+ <div class='hai-toast-content'>
255
+ <div class='hai-toast-message'>{item.message}</div>
256
+ {#if item.traceId && expandedId === item.id}
257
+ <div id={`toast-details-${item.id}`} class='hai-toast-details'>
258
+ <div class='font-medium'>{uiM('toast_traceId')}</div>
259
+ <code class='hai-toast-trace'>{item.traceId}</code>
260
+ <p>{uiM('toast_traceHelp')}</p>
261
+ <button type='button' class='btn btn-ghost btn-sm mt-1' onclick={() => copyTrace(item.id, item.traceId!)}>
262
+ <span aria-hidden='true' class='icon-[tabler--copy] size-4'></span>
263
+ {uiM('toast_copyTraceId')}
264
+ </button>
265
+ {#if copyResult?.id === item.id}
266
+ <p class='mt-1' role='status'>{copyResult.success ? uiM('toast_traceCopied') : uiM('toast_traceCopyFailed')}</p>
267
+ {/if}
268
+ </div>
269
+ {/if}
270
+ </div>
271
+ <span class='sr-only'>{uiM('toast_keyboardHint')}</span>
272
+ {#if item.traceId}
273
+ <button type='button' class='btn btn-ghost btn-sm btn-square hai-toast-details-toggle'
274
+ aria-label={uiM('toast_diagnostics')} title={uiM('toast_diagnostics')}
275
+ aria-expanded={expandedId === item.id} aria-controls={`toast-details-${item.id}`}
276
+ onclick={() => { expandedId = expandedId === item.id ? undefined : item.id }}
277
+ ><span aria-hidden='true' class='icon-[tabler--info-circle] size-4'></span></button>
278
+ {/if}
46
279
  {#if item.dismissible}
47
280
  <IconButton
48
281
  variant='ghost'
49
282
  size='sm'
50
- onclick={() => toast.remove(item.id)}
283
+ class='shrink-0 text-base-content/45'
284
+ onclick={() => dismiss(item.id)}
51
285
  ariaLabel={uiM('toast_dismiss')}
52
286
  >
53
287
  ✕
54
288
  </IconButton>
55
289
  {/if}
56
290
  </div>
57
- {/each}
58
- </div>
59
- {/each}
291
+ </div>
292
+ {/each}
293
+ </div>
294
+
295
+ <style>
296
+ /* 容器铺满视口但不拦截交互;仅 toast 本体接收指针事件。 */
297
+ .hai-toast-layer {
298
+ position: fixed;
299
+ inset: 0;
300
+ width: 100%;
301
+ height: 100%;
302
+ max-width: none;
303
+ max-height: none;
304
+ margin: 0;
305
+ padding: 0;
306
+ border: 0;
307
+ background: transparent;
308
+ overflow: visible;
309
+ pointer-events: none;
310
+ z-index: var(--hai-z-toast, 1200);
311
+ }
312
+
313
+ /* 未支持 Popover API 的浏览器忽略 popover 属性,容器仍保持固定定位;
314
+ 此时无 toast 项则内部不渲染任何内容,容器透明且不拦截交互。 */
315
+
316
+ .hai-toast-position {
317
+ position: absolute;
318
+ width: min(24rem, calc(100% - 2rem - env(safe-area-inset-left, 0px) - env(safe-area-inset-right, 0px)));
319
+ right: max(1rem, env(safe-area-inset-right, 0px));
320
+ bottom: max(1rem, env(safe-area-inset-bottom, 0px));
321
+ }
322
+
323
+ .hai-toast-position[data-position^='top-'] {
324
+ top: max(1rem, env(safe-area-inset-top, 0px));
325
+ bottom: auto;
326
+ }
327
+
328
+ .hai-toast-position:has([aria-expanded='true']) {
329
+ width: min(30rem, calc(100% - 2rem - env(safe-area-inset-left, 0px) - env(safe-area-inset-right, 0px)));
330
+ }
331
+
332
+ .hai-toast-position[data-position$='-left'] {
333
+ left: max(1rem, env(safe-area-inset-left, 0px));
334
+ right: auto;
335
+ }
336
+
337
+ .hai-toast-position[data-position$='-center'] {
338
+ left: 50%;
339
+ right: auto;
340
+ transform: translateX(-50%);
341
+ }
342
+
343
+ .hai-toast-item {
344
+ --hai-toast-accent: var(--color-info);
345
+ display: flex;
346
+ align-items: center;
347
+ gap: 0.75rem;
348
+ padding: 0.5rem 0.75rem;
349
+ border-width: 1px;
350
+ border-style: solid;
351
+ border-color: color-mix(in oklab, var(--hai-toast-accent) 20%, var(--color-base-100));
352
+ border-inline-start: 3px solid var(--hai-toast-accent);
353
+ background: color-mix(in oklab, var(--hai-toast-accent) 5%, var(--color-base-100));
354
+ border-radius: var(--hai-radius-md, 8px);
355
+ box-shadow: 0 4px 18px oklch(0 0 0 / 0.08);
356
+ pointer-events: auto;
357
+ animation: hai-toast-enter 150ms ease-out;
358
+ }
359
+
360
+ .hai-toast-content {
361
+ flex: 1;
362
+ min-width: 0;
363
+ max-height: min(30rem, 75dvh);
364
+ overflow: auto;
365
+ }
366
+
367
+ .hai-toast-details-toggle {
368
+ flex-shrink: 0;
369
+ }
370
+
371
+ /* 展开排查信息后,图标和操作仍与正文首行对齐。 */
372
+ .hai-toast-item:has(.hai-toast-details) {
373
+ align-items: flex-start;
374
+ }
375
+
376
+ .hai-toast-item:has(.hai-toast-details) > span[aria-hidden='true'] {
377
+ margin-top: 0.375rem;
378
+ }
379
+
380
+ .hai-toast-details {
381
+ margin-top: 0.75rem;
382
+ padding-top: 0.75rem;
383
+ border-top: 1px solid color-mix(in oklab, var(--hai-toast-accent) 20%, transparent);
384
+ font-size: 0.75rem;
385
+ line-height: 1.6;
386
+ }
387
+
388
+ .hai-toast-trace {
389
+ display: block;
390
+ margin-block: 0.25rem;
391
+ overflow-wrap: anywhere;
392
+ user-select: text;
393
+ }
394
+
395
+ .hai-toast-item[data-variant='success'] {
396
+ --hai-toast-accent: var(--color-success);
397
+ }
398
+
399
+ .hai-toast-item[data-variant='warning'] {
400
+ --hai-toast-accent: var(--color-warning);
401
+ }
402
+
403
+ .hai-toast-item[data-variant='error'] {
404
+ --hai-toast-accent: var(--color-error);
405
+ }
406
+
407
+ .hai-toast-message {
408
+ display: flex;
409
+ align-items: safe center;
410
+ min-height: 2rem;
411
+ min-width: 0;
412
+ max-height: min(20rem, 60dvh);
413
+ overflow: auto;
414
+ overflow-wrap: anywhere;
415
+ white-space: pre-wrap;
416
+ font-size: 0.875rem;
417
+ line-height: 1.5;
418
+ }
419
+
420
+ @keyframes hai-toast-enter {
421
+ from { opacity: 0; transform: translateY(0.25rem); }
422
+ to { opacity: 1; transform: translateY(0); }
423
+ }
424
+
425
+ @media (prefers-reduced-motion: reduce) {
426
+ .hai-toast-item { animation: none; }
427
+ }
428
+ </style>
@@ -1,3 +1,29 @@
1
- declare const ToastContainer: import("svelte").Component<Record<string, never>, {}, "">;
1
+ import type { DataAttributes } from '../../types.js';
2
+ /**
3
+ * =============================================================================
4
+ * @h-ai/ui - ToastContainer 组件
5
+ * =============================================================================
6
+ * 浮动操作提示容器,按先后顺序逐条显示,不占用页面布局。
7
+ *
8
+ * 使用 Svelte 5 Runes ($derived / $effect)
9
+ *
10
+ * 叠加策略(关键):原生 <dialog>.showModal() 处于浏览器 top layer,且在 Chromium 中
11
+ * 始终渲染在 Popover 之上。为保证 Toast 永远可见、不被弹窗遮挡:
12
+ * - 当存在已打开的 modal dialog 时,将 Toast 层寄宿到该 dialog 内部(同处 top layer,
13
+ * 作为最后子节点渲染在其内容之上);
14
+ * - 否则寄宿到 <body> 并以 Popover 进入 top layer,叠加在普通内容之上。
15
+ * =============================================================================
16
+ *
17
+ * @example
18
+ * ```ts
19
+ * import { mount, unmount } from 'svelte'
20
+ * import type { ComponentProps } from 'svelte'
21
+ * import { ToastContainer } from '@h-ai/ui'
22
+ * const props: ComponentProps<typeof ToastContainer> = { 'data-testid': 'toasts' }
23
+ * const component = mount(ToastContainer, { target: document.body, props })
24
+ * await unmount(component)
25
+ * ```
26
+ */
27
+ declare const ToastContainer: import("svelte").Component<DataAttributes, {}, "">;
2
28
  type ToastContainer = ReturnType<typeof ToastContainer>;
3
29
  export default ToastContainer;