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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (367) hide show
  1. package/README.en.md +1036 -0
  2. package/README.ja.md +1036 -0
  3. package/README.md +670 -119
  4. package/auto-import.d.ts +45 -0
  5. package/auto-import.js +46 -69
  6. package/dist/components/compounds/Accordion.svelte +30 -3
  7. package/dist/components/compounds/Accordion.svelte.d.ts +37 -1
  8. package/dist/components/compounds/ActionSheet.svelte +35 -8
  9. package/dist/components/compounds/ActionSheet.svelte.d.ts +41 -1
  10. package/dist/components/compounds/Alert.svelte +24 -15
  11. package/dist/components/compounds/Alert.svelte.d.ts +14 -3
  12. package/dist/components/compounds/AppBar.svelte +37 -9
  13. package/dist/components/compounds/AppBar.svelte.d.ts +36 -1
  14. package/dist/components/compounds/BottomNav.svelte +68 -8
  15. package/dist/components/compounds/BottomNav.svelte.d.ts +51 -1
  16. package/dist/components/compounds/Breadcrumb.svelte +18 -5
  17. package/dist/components/compounds/Breadcrumb.svelte.d.ts +23 -2
  18. package/dist/components/compounds/Calendar.svelte +31 -12
  19. package/dist/components/compounds/Calendar.svelte.d.ts +23 -7
  20. package/dist/components/compounds/Card.svelte +17 -5
  21. package/dist/components/compounds/Card.svelte.d.ts +13 -2
  22. package/dist/components/compounds/Combobox.svelte +124 -42
  23. package/dist/components/compounds/Combobox.svelte.d.ts +42 -20
  24. package/dist/components/compounds/Confirm.svelte +32 -9
  25. package/dist/components/compounds/Confirm.svelte.d.ts +24 -2
  26. package/dist/components/compounds/DataTable.svelte +317 -33
  27. package/dist/components/compounds/DataTable.svelte.d.ts +28 -14
  28. package/dist/components/compounds/DatePicker.svelte +62 -18
  29. package/dist/components/compounds/DatePicker.svelte.d.ts +27 -8
  30. package/dist/components/compounds/Drawer.svelte +179 -22
  31. package/dist/components/compounds/Drawer.svelte.d.ts +24 -2
  32. package/dist/components/compounds/Dropdown.svelte +19 -5
  33. package/dist/components/compounds/Dropdown.svelte.d.ts +13 -2
  34. package/dist/components/compounds/Empty.svelte +22 -9
  35. package/dist/components/compounds/Empty.svelte.d.ts +23 -2
  36. package/dist/components/compounds/FilterBar.svelte +82 -0
  37. package/dist/components/compounds/FilterBar.svelte.d.ts +39 -0
  38. package/dist/components/compounds/Form.svelte +59 -16
  39. package/dist/components/compounds/Form.svelte.d.ts +23 -2
  40. package/dist/components/compounds/FormField.svelte +99 -16
  41. package/dist/components/compounds/FormField.svelte.d.ts +23 -2
  42. package/dist/components/compounds/FormLayout.svelte +71 -0
  43. package/dist/components/compounds/FormLayout.svelte.d.ts +17 -0
  44. package/dist/components/compounds/InfiniteScroll.svelte +34 -7
  45. package/dist/components/compounds/InfiniteScroll.svelte.d.ts +37 -1
  46. package/dist/components/compounds/JsonViewer.svelte +214 -0
  47. package/dist/components/compounds/JsonViewer.svelte.d.ts +26 -0
  48. package/dist/components/compounds/MessageBoxContainer.svelte +34 -0
  49. package/dist/components/compounds/MessageBoxContainer.svelte.d.ts +25 -0
  50. package/dist/components/compounds/MessageBoxDialog.svelte +209 -0
  51. package/dist/components/compounds/MessageBoxDialog.svelte.d.ts +29 -0
  52. package/dist/components/compounds/MessageContainer.svelte +24 -0
  53. package/dist/components/compounds/MessageContainer.svelte.d.ts +18 -0
  54. package/dist/components/compounds/Modal.svelte +348 -73
  55. package/dist/components/compounds/Modal.svelte.d.ts +13 -2
  56. package/dist/components/compounds/PageHeader.svelte +44 -20
  57. package/dist/components/compounds/PageHeader.svelte.d.ts +24 -9
  58. package/dist/components/compounds/Pagination.svelte +139 -105
  59. package/dist/components/compounds/Pagination.svelte.d.ts +23 -2
  60. package/dist/components/compounds/Popover.svelte +124 -25
  61. package/dist/components/compounds/Popover.svelte.d.ts +23 -2
  62. package/dist/components/compounds/PullRefresh.svelte +35 -8
  63. package/dist/components/compounds/PullRefresh.svelte.d.ts +35 -1
  64. package/dist/components/compounds/Result.svelte +17 -4
  65. package/dist/components/compounds/Result.svelte.d.ts +23 -2
  66. package/dist/components/compounds/SafeArea.svelte +30 -3
  67. package/dist/components/compounds/SafeArea.svelte.d.ts +35 -1
  68. package/dist/components/compounds/Skeleton.svelte +19 -7
  69. package/dist/components/compounds/Skeleton.svelte.d.ts +13 -2
  70. package/dist/components/compounds/Steps.svelte +17 -4
  71. package/dist/components/compounds/Steps.svelte.d.ts +23 -2
  72. package/dist/components/compounds/SwipeCell.svelte +30 -3
  73. package/dist/components/compounds/SwipeCell.svelte.d.ts +40 -1
  74. package/dist/components/compounds/TableToolbar.svelte +289 -0
  75. package/dist/components/compounds/TableToolbar.svelte.d.ts +69 -0
  76. package/dist/components/compounds/Tabs.svelte +84 -14
  77. package/dist/components/compounds/Tabs.svelte.d.ts +13 -2
  78. package/dist/components/compounds/TagInput.svelte +51 -33
  79. package/dist/components/compounds/TagInput.svelte.d.ts +23 -2
  80. package/dist/components/compounds/Timeline.svelte +30 -3
  81. package/dist/components/compounds/Timeline.svelte.d.ts +37 -1
  82. package/dist/components/compounds/ToastContainer.svelte +386 -28
  83. package/dist/components/compounds/ToastContainer.svelte.d.ts +27 -1
  84. package/dist/components/compounds/Tooltip.svelte +143 -9
  85. package/dist/components/compounds/Tooltip.svelte.d.ts +25 -2
  86. package/dist/components/compounds/accordion-types.d.ts +10 -1
  87. package/dist/components/compounds/action-sheet-types.d.ts +9 -0
  88. package/dist/components/compounds/bottom-nav-types.d.ts +9 -0
  89. package/dist/components/compounds/index.d.ts +7 -0
  90. package/dist/components/compounds/index.js +11 -0
  91. package/dist/components/compounds/swipe-cell-types.d.ts +9 -0
  92. package/dist/components/compounds/timeline-types.d.ts +9 -0
  93. package/dist/components/control-size.d.ts +35 -0
  94. package/dist/components/control-size.js +26 -0
  95. package/dist/components/primitives/Avatar.svelte +19 -5
  96. package/dist/components/primitives/Avatar.svelte.d.ts +13 -2
  97. package/dist/components/primitives/Badge.svelte +16 -4
  98. package/dist/components/primitives/Badge.svelte.d.ts +13 -2
  99. package/dist/components/primitives/BareButton.svelte +26 -12
  100. package/dist/components/primitives/BareButton.svelte.d.ts +23 -2
  101. package/dist/components/primitives/BareInput.svelte +57 -35
  102. package/dist/components/primitives/BareInput.svelte.d.ts +23 -2
  103. package/dist/components/primitives/Button.svelte +30 -9
  104. package/dist/components/primitives/Button.svelte.d.ts +13 -2
  105. package/dist/components/primitives/Checkbox.svelte +24 -5
  106. package/dist/components/primitives/Checkbox.svelte.d.ts +23 -2
  107. package/dist/components/primitives/IconButton.svelte +35 -10
  108. package/dist/components/primitives/IconButton.svelte.d.ts +23 -2
  109. package/dist/components/primitives/Input.svelte +56 -26
  110. package/dist/components/primitives/Input.svelte.d.ts +13 -2
  111. package/dist/components/primitives/Progress.svelte +17 -4
  112. package/dist/components/primitives/Progress.svelte.d.ts +23 -2
  113. package/dist/components/primitives/Radio.svelte +17 -4
  114. package/dist/components/primitives/Radio.svelte.d.ts +22 -2
  115. package/dist/components/primitives/Range.svelte +31 -4
  116. package/dist/components/primitives/Range.svelte.d.ts +37 -1
  117. package/dist/components/primitives/Rating.svelte +32 -5
  118. package/dist/components/primitives/Rating.svelte.d.ts +37 -1
  119. package/dist/components/primitives/Select.svelte +404 -47
  120. package/dist/components/primitives/Select.svelte.d.ts +23 -2
  121. package/dist/components/primitives/Spinner.svelte +17 -4
  122. package/dist/components/primitives/Spinner.svelte.d.ts +23 -2
  123. package/dist/components/primitives/Switch.svelte +22 -4
  124. package/dist/components/primitives/Switch.svelte.d.ts +23 -2
  125. package/dist/components/primitives/Tag.svelte +17 -4
  126. package/dist/components/primitives/Tag.svelte.d.ts +23 -2
  127. package/dist/components/primitives/Textarea.svelte +75 -30
  128. package/dist/components/primitives/Textarea.svelte.d.ts +24 -2
  129. package/dist/components/primitives/ToggleCheckbox.svelte +24 -10
  130. package/dist/components/primitives/ToggleCheckbox.svelte.d.ts +23 -2
  131. package/dist/components/primitives/ToggleInput.svelte +24 -10
  132. package/dist/components/primitives/ToggleInput.svelte.d.ts +23 -2
  133. package/dist/components/primitives/ToggleRadio.svelte +24 -10
  134. package/dist/components/primitives/ToggleRadio.svelte.d.ts +23 -2
  135. package/dist/components/scenes/ai/AiDocumentDownloadMenu.svelte +54 -23
  136. package/dist/components/scenes/ai/AiDocumentDownloadMenu.svelte.d.ts +30 -1
  137. package/dist/components/scenes/ai/AiDocumentEditor.svelte +3428 -693
  138. package/dist/components/scenes/ai/AiDocumentEditor.svelte.d.ts +26 -1
  139. package/dist/components/scenes/ai/MarkdownRenderer.svelte +119 -116
  140. package/dist/components/scenes/ai/MarkdownRenderer.svelte.d.ts +31 -1
  141. package/dist/components/scenes/ai/code-preview.d.ts +46 -0
  142. package/dist/components/scenes/ai/code-preview.js +141 -0
  143. package/dist/components/scenes/ai/document-download.d.ts +52 -0
  144. package/dist/components/scenes/ai/document-download.js +296 -77
  145. package/dist/components/scenes/ai/document-parse.d.ts +101 -11
  146. package/dist/components/scenes/ai/document-parse.js +212 -48
  147. package/dist/components/scenes/ai/document-types.d.ts +292 -75
  148. package/dist/components/scenes/ai/editor-markdown-extensions.d.ts +27 -0
  149. package/dist/components/scenes/ai/editor-markdown-extensions.js +215 -0
  150. package/dist/components/scenes/ai/highlight.d.ts +37 -0
  151. package/dist/components/scenes/ai/highlight.js +162 -0
  152. package/dist/components/scenes/ai/index.d.ts +5 -2
  153. package/dist/components/scenes/ai/index.js +3 -0
  154. package/dist/components/scenes/ai/markdown-parse.d.ts +11 -3
  155. package/dist/components/scenes/ai/markdown-parse.js +42 -31
  156. package/dist/components/scenes/ai/mermaid-host-sync.d.ts +72 -0
  157. package/dist/components/scenes/ai/mermaid-host-sync.js +65 -0
  158. package/dist/components/scenes/ai/mermaid-render.d.ts +30 -0
  159. package/dist/components/scenes/ai/mermaid-render.js +61 -0
  160. package/dist/components/scenes/ai/safe-html.d.ts +64 -0
  161. package/dist/components/scenes/ai/safe-html.js +345 -0
  162. package/dist/components/scenes/ai/table/AiTableEditor.svelte +1692 -0
  163. package/dist/components/scenes/ai/table/AiTableEditor.svelte.d.ts +32 -0
  164. package/dist/components/scenes/ai/table/table-types.d.ts +181 -0
  165. package/dist/components/scenes/ai/table/table-types.js +1 -0
  166. package/dist/components/scenes/app/FeedbackDetail.svelte +236 -0
  167. package/dist/components/scenes/app/FeedbackDetail.svelte.d.ts +40 -0
  168. package/dist/components/scenes/app/FeedbackForm.svelte +337 -0
  169. package/dist/components/scenes/app/FeedbackForm.svelte.d.ts +72 -0
  170. package/dist/components/scenes/app/FeedbackList.svelte +150 -0
  171. package/dist/components/scenes/app/FeedbackList.svelte.d.ts +28 -0
  172. package/dist/components/scenes/app/FeedbackModal.svelte +65 -139
  173. package/dist/components/scenes/app/FeedbackModal.svelte.d.ts +14 -39
  174. package/dist/components/scenes/app/FeedbackRecorder.svelte +154 -0
  175. package/dist/components/scenes/app/FeedbackRecorder.svelte.d.ts +9 -0
  176. package/dist/components/scenes/app/FeedbackReplay.svelte +142 -0
  177. package/dist/components/scenes/app/FeedbackReplay.svelte.d.ts +7 -0
  178. package/dist/components/scenes/app/FeedbackScreenshot.svelte +120 -0
  179. package/dist/components/scenes/app/FeedbackScreenshot.svelte.d.ts +8 -0
  180. package/dist/components/scenes/app/LanguageSwitch.svelte +38 -21
  181. package/dist/components/scenes/app/LanguageSwitch.svelte.d.ts +33 -20
  182. package/dist/components/scenes/app/SettingsLayout.svelte +115 -0
  183. package/dist/components/scenes/app/SettingsLayout.svelte.d.ts +54 -0
  184. package/dist/components/scenes/app/SettingsModal.svelte +33 -7
  185. package/dist/components/scenes/app/SettingsModal.svelte.d.ts +27 -1
  186. package/dist/components/scenes/app/ThemeColorPicker.svelte +240 -0
  187. package/dist/components/scenes/app/ThemeColorPicker.svelte.d.ts +57 -0
  188. package/dist/components/scenes/app/ThemeSelector.svelte +87 -26
  189. package/dist/components/scenes/app/ThemeSelector.svelte.d.ts +26 -7
  190. package/dist/components/scenes/app/ThemeToggle.svelte +27 -6
  191. package/dist/components/scenes/app/ThemeToggle.svelte.d.ts +24 -5
  192. package/dist/components/scenes/app/WorkspaceLayout.svelte +64 -0
  193. package/dist/components/scenes/app/WorkspaceLayout.svelte.d.ts +36 -0
  194. package/dist/components/scenes/app/feedback-functions.d.ts +57 -0
  195. package/dist/components/scenes/app/feedback-functions.js +107 -0
  196. package/dist/components/scenes/app/feedback-types.d.ts +224 -0
  197. package/dist/components/scenes/app/feedback-types.js +1 -0
  198. package/dist/components/scenes/app/index.d.ts +8 -1
  199. package/dist/components/scenes/app/index.js +7 -1
  200. package/dist/components/scenes/charts/Chart.svelte +163 -0
  201. package/dist/components/scenes/charts/Chart.svelte.d.ts +25 -0
  202. package/dist/components/scenes/charts/chart-theme.d.ts +47 -0
  203. package/dist/components/scenes/charts/chart-theme.js +68 -0
  204. package/dist/components/scenes/charts/chart-types.d.ts +153 -0
  205. package/dist/components/scenes/charts/chart-types.js +7 -0
  206. package/dist/components/scenes/charts/index.d.ts +8 -0
  207. package/dist/components/scenes/charts/index.js +7 -0
  208. package/dist/components/scenes/charts/renderers/AreaChart.svelte +18 -0
  209. package/dist/components/scenes/charts/renderers/AreaChart.svelte.d.ts +5 -0
  210. package/dist/components/scenes/charts/renderers/BarChart.svelte +18 -0
  211. package/dist/components/scenes/charts/renderers/BarChart.svelte.d.ts +5 -0
  212. package/dist/components/scenes/charts/renderers/LineChart.svelte +624 -0
  213. package/dist/components/scenes/charts/renderers/LineChart.svelte.d.ts +32 -0
  214. package/dist/components/scenes/charts/renderers/PieChart.svelte +18 -0
  215. package/dist/components/scenes/charts/renderers/PieChart.svelte.d.ts +5 -0
  216. package/dist/components/scenes/charts/renderers/ScatterChart.svelte +18 -0
  217. package/dist/components/scenes/charts/renderers/ScatterChart.svelte.d.ts +5 -0
  218. package/dist/components/scenes/crud/CrudDeleteConfirm.svelte +29 -11
  219. package/dist/components/scenes/crud/CrudDeleteConfirm.svelte.d.ts +13 -1
  220. package/dist/components/scenes/crud/CrudDetailDrawer.svelte +77 -22
  221. package/dist/components/scenes/crud/CrudDetailDrawer.svelte.d.ts +19 -4
  222. package/dist/components/scenes/crud/CrudDetailPanel.svelte +242 -0
  223. package/dist/components/scenes/crud/CrudDetailPanel.svelte.d.ts +66 -0
  224. package/dist/components/scenes/crud/CrudEditPanel.svelte +365 -0
  225. package/dist/components/scenes/crud/CrudEditPanel.svelte.d.ts +48 -0
  226. package/dist/components/scenes/crud/CrudFilterBar.svelte +17 -85
  227. package/dist/components/scenes/crud/CrudFilterBar.svelte.d.ts +13 -25
  228. package/dist/components/scenes/crud/CrudPage.svelte +564 -185
  229. package/dist/components/scenes/crud/CrudPage.svelte.d.ts +137 -51
  230. package/dist/components/scenes/crud/crud-controller.svelte.d.ts +335 -0
  231. package/dist/components/scenes/crud/crud-controller.svelte.js +276 -0
  232. package/dist/components/scenes/crud/crud-form-validation.d.ts +16 -0
  233. package/dist/components/scenes/crud/crud-form-validation.js +51 -0
  234. package/dist/components/scenes/crud/crud-types.d.ts +136 -43
  235. package/dist/components/scenes/crud/index.d.ts +9 -3
  236. package/dist/components/scenes/crud/index.js +8 -3
  237. package/dist/components/scenes/crud/nav-adapter.d.ts +50 -0
  238. package/dist/components/scenes/crud/nav-adapter.js +39 -0
  239. package/dist/components/scenes/crypto/EncryptedInput.svelte +63 -28
  240. package/dist/components/scenes/crypto/EncryptedInput.svelte.d.ts +38 -3
  241. package/dist/components/scenes/crypto/HashDisplay.svelte +30 -22
  242. package/dist/components/scenes/crypto/HashDisplay.svelte.d.ts +24 -1
  243. package/dist/components/scenes/crypto/SignatureDisplay.svelte +41 -40
  244. package/dist/components/scenes/crypto/SignatureDisplay.svelte.d.ts +24 -1
  245. package/dist/components/scenes/error/ErrorPage.svelte +135 -0
  246. package/dist/components/scenes/error/ErrorPage.svelte.d.ts +50 -0
  247. package/dist/components/scenes/error/error-presets.d.ts +60 -0
  248. package/dist/components/scenes/error/error-presets.js +51 -0
  249. package/dist/components/scenes/error/index.d.ts +8 -0
  250. package/dist/components/scenes/error/index.js +8 -0
  251. package/dist/components/scenes/guide/GuideHost.svelte +56 -0
  252. package/dist/components/scenes/guide/GuideHost.svelte.d.ts +35 -0
  253. package/dist/components/scenes/guide/GuideHostContent.svelte +136 -0
  254. package/dist/components/scenes/guide/GuideHostContent.svelte.d.ts +43 -0
  255. package/dist/components/scenes/guide/HelpCenter.svelte +135 -0
  256. package/dist/components/scenes/guide/HelpCenter.svelte.d.ts +40 -0
  257. package/dist/components/scenes/guide/index.d.ts +2 -0
  258. package/dist/components/scenes/guide/index.js +2 -0
  259. package/dist/components/scenes/iam/AgreementNotice.svelte +48 -0
  260. package/dist/components/scenes/iam/AgreementNotice.svelte.d.ts +7 -0
  261. package/dist/components/scenes/iam/AuthPanel.svelte +226 -0
  262. package/dist/components/scenes/iam/AuthPanel.svelte.d.ts +29 -0
  263. package/dist/components/scenes/iam/AuthShell.svelte +160 -0
  264. package/dist/components/scenes/iam/AuthShell.svelte.d.ts +56 -0
  265. package/dist/components/scenes/iam/ChangePasswordForm.svelte +84 -63
  266. package/dist/components/scenes/iam/ChangePasswordForm.svelte.d.ts +13 -1
  267. package/dist/components/scenes/iam/ForgotPasswordForm.svelte +113 -89
  268. package/dist/components/scenes/iam/ForgotPasswordForm.svelte.d.ts +24 -1
  269. package/dist/components/scenes/iam/LoginForm.svelte +215 -117
  270. package/dist/components/scenes/iam/LoginForm.svelte.d.ts +13 -1
  271. package/dist/components/scenes/iam/PasswordInput.svelte +79 -32
  272. package/dist/components/scenes/iam/PasswordInput.svelte.d.ts +30 -4
  273. package/dist/components/scenes/iam/PermGuard.svelte +21 -11
  274. package/dist/components/scenes/iam/PermGuard.svelte.d.ts +30 -0
  275. package/dist/components/scenes/iam/ReauthenticationDialog.svelte +68 -0
  276. package/dist/components/scenes/iam/ReauthenticationDialog.svelte.d.ts +17 -0
  277. package/dist/components/scenes/iam/RegisterForm.svelte +129 -116
  278. package/dist/components/scenes/iam/RegisterForm.svelte.d.ts +13 -1
  279. package/dist/components/scenes/iam/ResetPasswordForm.svelte +101 -88
  280. package/dist/components/scenes/iam/ResetPasswordForm.svelte.d.ts +13 -1
  281. package/dist/components/scenes/iam/SensitiveOperationsForm.svelte +76 -0
  282. package/dist/components/scenes/iam/SensitiveOperationsForm.svelte.d.ts +21 -0
  283. package/dist/components/scenes/iam/SessionRecoveryDialog.svelte +64 -0
  284. package/dist/components/scenes/iam/SessionRecoveryDialog.svelte.d.ts +22 -0
  285. package/dist/components/scenes/iam/UserProfile.svelte +47 -21
  286. package/dist/components/scenes/iam/UserProfile.svelte.d.ts +24 -1
  287. package/dist/components/scenes/iam/auth-captcha.d.ts +21 -0
  288. package/dist/components/scenes/iam/auth-captcha.js +23 -0
  289. package/dist/components/scenes/iam/auth-error-message.d.ts +13 -0
  290. package/dist/components/scenes/iam/auth-error-message.js +65 -0
  291. package/dist/components/scenes/iam/index.d.ts +10 -0
  292. package/dist/components/scenes/iam/index.js +9 -1
  293. package/dist/components/scenes/iam/password-utils.d.ts +33 -6
  294. package/dist/components/scenes/iam/password-utils.js +61 -8
  295. package/dist/components/scenes/iam/permission-context.svelte.d.ts +33 -23
  296. package/dist/components/scenes/iam/permission-context.svelte.js +20 -22
  297. package/dist/components/scenes/iam/sensitive-actions.svelte.d.ts +68 -0
  298. package/dist/components/scenes/iam/sensitive-actions.svelte.js +101 -0
  299. package/dist/components/scenes/iam/session-recovery.svelte.d.ts +44 -0
  300. package/dist/components/scenes/iam/session-recovery.svelte.js +57 -0
  301. package/dist/components/scenes/index.d.ts +3 -0
  302. package/dist/components/scenes/index.js +5 -0
  303. package/dist/components/scenes/storage/AvatarUpload.svelte +82 -68
  304. package/dist/components/scenes/storage/AvatarUpload.svelte.d.ts +23 -1
  305. package/dist/components/scenes/storage/FileList.svelte +19 -5
  306. package/dist/components/scenes/storage/FileList.svelte.d.ts +23 -1
  307. package/dist/components/scenes/storage/FileUpload.svelte +151 -96
  308. package/dist/components/scenes/storage/FileUpload.svelte.d.ts +24 -1
  309. package/dist/components/scenes/storage/ImageUpload.svelte +93 -94
  310. package/dist/components/scenes/storage/ImageUpload.svelte.d.ts +24 -1
  311. package/dist/components/scenes/types.d.ts +574 -42
  312. package/dist/guide-storage.d.ts +18 -0
  313. package/dist/guide-storage.js +79 -0
  314. package/dist/guide-types.d.ts +143 -0
  315. package/dist/guide-types.js +1 -0
  316. package/dist/guide.d.ts +3 -0
  317. package/dist/guide.js +3 -0
  318. package/dist/guide.svelte.d.ts +29 -0
  319. package/dist/guide.svelte.js +506 -0
  320. package/dist/i18n.svelte.d.ts +67 -4
  321. package/dist/i18n.svelte.js +106 -21
  322. package/dist/index.d.ts +6 -0
  323. package/dist/index.js +7 -0
  324. package/dist/internal/browser-safety.d.ts +88 -0
  325. package/dist/internal/browser-safety.js +140 -0
  326. package/dist/internal/dialog-focus.d.ts +21 -0
  327. package/dist/internal/dialog-focus.js +77 -0
  328. package/dist/internal/form-context.d.ts +92 -0
  329. package/dist/internal/form-context.js +70 -0
  330. package/dist/internal/form-validation.svelte.d.ts +70 -0
  331. package/dist/internal/form-validation.svelte.js +142 -0
  332. package/dist/internal/icon-safety.d.ts +14 -0
  333. package/dist/internal/icon-safety.js +40 -0
  334. package/dist/internal/locale.d.ts +21 -0
  335. package/dist/internal/locale.js +43 -0
  336. package/dist/message.svelte.d.ts +138 -0
  337. package/dist/message.svelte.js +149 -0
  338. package/dist/messagebox.svelte.d.ts +130 -0
  339. package/dist/messagebox.svelte.js +171 -0
  340. package/dist/messages/en-US.json +297 -16
  341. package/dist/messages/ja-JP.json +523 -0
  342. package/dist/messages/zh-CN.json +297 -16
  343. package/dist/messages.d.ts +25 -3
  344. package/dist/messages.js +23 -6
  345. package/dist/styles/design-tokens.css +4 -2
  346. package/dist/styles/formal.css +55 -0
  347. package/dist/styles/global.css +86 -18
  348. package/dist/styles/guide.css +88 -0
  349. package/dist/styles/high-contrast.css +64 -0
  350. package/dist/styles/mobile.css +28 -0
  351. package/dist/styles/theme.css +42 -0
  352. package/dist/theme-config.d.ts +263 -10
  353. package/dist/theme-config.js +252 -17
  354. package/dist/toast.svelte.d.ts +210 -2
  355. package/dist/toast.svelte.js +296 -19
  356. package/dist/types.d.ts +787 -63
  357. package/dist/utils/platform.svelte.d.ts +28 -15
  358. package/dist/utils/platform.svelte.js +23 -16
  359. package/dist/utils.d.ts +121 -1
  360. package/dist/utils.js +208 -13
  361. package/dist/workspace-context.d.ts +20 -0
  362. package/dist/workspace-context.js +9 -0
  363. package/package.json +120 -24
  364. package/vite.d.ts +13 -0
  365. package/vite.js +96 -0
  366. package/dist/components/scenes/crud/CrudEditDrawer.svelte +0 -225
  367. package/dist/components/scenes/crud/CrudEditDrawer.svelte.d.ts +0 -48
@@ -0,0 +1,70 @@
1
+ import { getContext } from 'svelte';
2
+ /**
3
+ * 表单布局的私有 Svelte Context 键;应用通过 FormLayout 使用。
4
+ *
5
+ * @example 模块内部上下文
6
+ * ```ts
7
+ * const context = getContext<FormLayoutOptions | undefined>(FORM_LAYOUT_CONTEXT)
8
+ * const columns = context?.columns
9
+ * ```
10
+ */
11
+ export const FORM_LAYOUT_CONTEXT = Symbol('hai-form-layout');
12
+ /**
13
+ * 字段标签、错误与主控件关联的私有 Context 键。
14
+ *
15
+ * @example 模块内部上下文
16
+ * ```ts
17
+ * const field = getContext<FormFieldContext | undefined>(FORM_FIELD_CONTEXT)
18
+ * const controlId = field?.controlId
19
+ * ```
20
+ */
21
+ export const FORM_FIELD_CONTEXT = Symbol('hai-form-field');
22
+ /**
23
+ * Modal/Drawer 向内部表单同步可见性的私有 Context 键。
24
+ *
25
+ * @example 模块内部上下文
26
+ * ```ts
27
+ * const visibility = getContext<FormVisibilityContext | undefined>(FORM_VISIBILITY_CONTEXT)
28
+ * const open = visibility?.open
29
+ * ```
30
+ */
31
+ export const FORM_VISIBILITY_CONTEXT = Symbol('hai-form-visibility');
32
+ /**
33
+ * 组件初始化阶段读取可见性;没有宿主时返回 undefined。
34
+ * @returns 最近宿主的可见状态;无宿主时为 undefined。
35
+ *
36
+ * @example 模块内部上下文
37
+ * ```ts
38
+ * const visibility = getFormVisibilityContext()
39
+ * const open = visibility?.open ?? true
40
+ * ```
41
+ */
42
+ export function getFormVisibilityContext() {
43
+ return getContext(FORM_VISIBILITY_CONTEXT);
44
+ }
45
+ /**
46
+ * 组件初始化阶段读取祖先布局;没有祖先时使用控件默认布局。
47
+ * @returns 最近表单布局;无祖先时为 undefined。
48
+ *
49
+ * @example 模块内部上下文
50
+ * ```ts
51
+ * const layout = getFormLayoutContext()
52
+ * const columns = layout?.columns ?? 1
53
+ * ```
54
+ */
55
+ export function getFormLayoutContext() {
56
+ return getContext(FORM_LAYOUT_CONTEXT);
57
+ }
58
+ /**
59
+ * 组件初始化阶段读取最近字段的无障碍关联和校验消息。
60
+ * @returns 最近字段的标签、控件和校验消息关联;无字段时为 undefined。
61
+ *
62
+ * @example 模块内部上下文
63
+ * ```ts
64
+ * const field = getFormFieldContext()
65
+ * const descriptionId = field?.messageId
66
+ * ```
67
+ */
68
+ export function getFormFieldContext() {
69
+ return getContext(FORM_FIELD_CONTEXT);
70
+ }
@@ -0,0 +1,70 @@
1
+ /** 将原生校验状态保留为消息键,显示时按当前 UI 语言解析。 */
2
+ import type { UIMessageKey } from '../messages.js';
3
+ import type { FormText } from '../types.js';
4
+ /**
5
+ * 将字段错误交给公共 Toast;字段本身继续保留 aria-invalid 和关联说明。
6
+ * @param message - 读取当前字段的错误。
7
+ * @param label - 可选的独立字段名称;省略时使用 FormField 上下文。
8
+ * @example 模块内部上下文
9
+ * ```ts
10
+ * // 在 Svelte 组件初始化时注册,状态由控件维护。
11
+ * useControlFeedback(() => '邮箱格式不正确', () => '邮箱')
12
+ * ```
13
+ */
14
+ export declare function useControlFeedback(message: () => string, label?: () => string | undefined): void;
15
+ /**
16
+ * 可重新翻译的原生约束错误,不缓存某个语言的最终文案。
17
+ *
18
+ * @example 模块内部上下文
19
+ * ```ts
20
+ * const example: FormValidationIssue = { key: 'form_min_length', params: { min: 12 } }
21
+ * ```
22
+ */
23
+ export interface FormValidationIssue {
24
+ key: UIMessageKey;
25
+ params?: Record<string, string | number>;
26
+ }
27
+ /**
28
+ * 参与原生约束校验的表单控件集合。
29
+ *
30
+ * @example 模块内部上下文
31
+ * ```ts
32
+ * const example: FormControl = document.createElement('input')
33
+ * ```
34
+ */
35
+ type FormControl = HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;
36
+ /**
37
+ * 在显示时求值表单提示,语言切换后读取最新业务翻译。
38
+ * @param text - 待处理文本。
39
+ * @returns 当前语言的表单提示,空输入为空字符串。
40
+ *
41
+ * @example 模块内部上下文
42
+ * ```ts
43
+ * const message = resolveFormText(() => '邮箱不能为空')
44
+ * ```
45
+ */
46
+ export declare function resolveFormText(text?: FormText): string;
47
+ /**
48
+ * 在组件初始化阶段创建原生约束校验状态;宿主关闭或表单 reset 时清除过期错误。
49
+ * @param getOverride - 读取自定义校验提示的函数。
50
+ * @param getValue - 读取当前控件值以跟踪程序回填的函数。
51
+ * @returns 带响应式 message 和 validate/blur/input/reset 方法的校验状态。
52
+ *
53
+ * @example 模块内部上下文
54
+ * ```ts
55
+ * const validation = createControlValidation(() => '邮箱不能为空')
56
+ * const input = document.createElement('input')
57
+ * input.required = true
58
+ * validation.validate(input)
59
+ * const message = validation.message
60
+ * validation.reset()
61
+ * ```
62
+ */
63
+ export declare function createControlValidation(getOverride?: () => FormText | undefined, getValue?: () => unknown): {
64
+ readonly message: string;
65
+ validate(control: FormControl): void;
66
+ blur(control: FormControl): void;
67
+ input(control: FormControl): void;
68
+ reset: () => void;
69
+ };
70
+ export {};
@@ -0,0 +1,142 @@
1
+ import { untrack } from 'svelte';
2
+ import { getUILocale, uiM } from '../messages.js';
3
+ import { useToastFeedback } from '../toast.svelte.js';
4
+ import { getFormFieldContext, getFormVisibilityContext } from './form-context.js';
5
+ /**
6
+ * 将字段错误交给公共 Toast;字段本身继续保留 aria-invalid 和关联说明。
7
+ * @param message - 读取当前字段的错误。
8
+ * @param label - 可选的独立字段名称;省略时使用 FormField 上下文。
9
+ * @example 模块内部上下文
10
+ * ```ts
11
+ * // 在 Svelte 组件初始化时注册,状态由控件维护。
12
+ * useControlFeedback(() => '邮箱格式不正确', () => '邮箱')
13
+ * ```
14
+ */
15
+ export function useControlFeedback(message, label) {
16
+ const field = getFormFieldContext();
17
+ const visibility = getFormVisibilityContext();
18
+ useToastFeedback(() => {
19
+ const value = message();
20
+ if (!value || field?.error || visibility?.open === false)
21
+ return '';
22
+ const name = label?.() || field?.label;
23
+ return name ? uiM('form_field_error', { label: name, message: value }) : value;
24
+ });
25
+ }
26
+ /**
27
+ * 在显示时求值表单提示,语言切换后读取最新业务翻译。
28
+ * @param text - 待处理文本。
29
+ * @returns 当前语言的表单提示,空输入为空字符串。
30
+ *
31
+ * @example 模块内部上下文
32
+ * ```ts
33
+ * const message = resolveFormText(() => '邮箱不能为空')
34
+ * ```
35
+ */
36
+ export function resolveFormText(text) {
37
+ if (typeof text !== 'function')
38
+ return text ?? '';
39
+ // 应用翻译函数也在 UI 语言同步后重新求值。
40
+ void getUILocale();
41
+ return text();
42
+ }
43
+ function readIssue(control) {
44
+ if (!control.willValidate)
45
+ return undefined;
46
+ const validity = control.validity;
47
+ if (validity.valueMissing)
48
+ return { key: 'form_required' };
49
+ if (validity.typeMismatch)
50
+ return { key: control.getAttribute('type') === 'email' ? 'form_email' : 'form_url' };
51
+ // 程序回填的值也需校验长度,原生 tooShort/tooLong 只覆盖用户输入。
52
+ const minLength = control.getAttribute('minlength');
53
+ const maxLength = control.getAttribute('maxlength');
54
+ if (validity.tooShort || (control.value && minLength !== null && control.value.length < Number(minLength)))
55
+ return { key: 'form_min_length', params: { min: control.getAttribute('minlength') ?? '' } };
56
+ if (validity.tooLong || (control.value && maxLength !== null && control.value.length > Number(maxLength)))
57
+ return { key: 'form_max_length', params: { max: control.getAttribute('maxlength') ?? '' } };
58
+ if (validity.rangeUnderflow)
59
+ return { key: 'form_min', params: { min: control.getAttribute('min') ?? '' } };
60
+ if (validity.rangeOverflow)
61
+ return { key: 'form_max', params: { max: control.getAttribute('max') ?? '' } };
62
+ if (validity.stepMismatch)
63
+ return { key: 'form_step', params: { step: control.getAttribute('step') ?? '1' } };
64
+ if (validity.badInput)
65
+ return { key: 'form_number' };
66
+ if (validity.patternMismatch)
67
+ return { key: 'form_pattern' };
68
+ return undefined;
69
+ }
70
+ /**
71
+ * 在组件初始化阶段创建原生约束校验状态;宿主关闭或表单 reset 时清除过期错误。
72
+ * @param getOverride - 读取自定义校验提示的函数。
73
+ * @param getValue - 读取当前控件值以跟踪程序回填的函数。
74
+ * @returns 带响应式 message 和 validate/blur/input/reset 方法的校验状态。
75
+ *
76
+ * @example 模块内部上下文
77
+ * ```ts
78
+ * const validation = createControlValidation(() => '邮箱不能为空')
79
+ * const input = document.createElement('input')
80
+ * input.required = true
81
+ * validation.validate(input)
82
+ * const message = validation.message
83
+ * validation.reset()
84
+ * ```
85
+ */
86
+ export function createControlValidation(getOverride = () => undefined, getValue) {
87
+ const visibility = getFormVisibilityContext();
88
+ let issue = $state();
89
+ let currentControl = $state();
90
+ let edited = false;
91
+ function reset() {
92
+ issue = undefined;
93
+ edited = false;
94
+ currentControl?.setCustomValidity('');
95
+ }
96
+ $effect(() => {
97
+ // 弹窗与抽屉保留子树;关闭时清理原生错误,重开不能沿用上次的触碰状态。
98
+ if (visibility && !visibility.open)
99
+ reset();
100
+ });
101
+ $effect(() => {
102
+ const form = currentControl?.form;
103
+ form?.addEventListener('reset', reset);
104
+ return () => form?.removeEventListener('reset', reset);
105
+ });
106
+ $effect(() => {
107
+ getValue?.();
108
+ const control = currentControl;
109
+ if (control) {
110
+ // 回填、重置及约束变更不一定触发 input;同步清除过期的原生错误。
111
+ untrack(() => {
112
+ control.setCustomValidity('');
113
+ if (issue)
114
+ issue = readIssue(control);
115
+ });
116
+ }
117
+ });
118
+ return {
119
+ get message() {
120
+ return issue ? resolveFormText(getOverride()) || uiM(issue.key, issue.params) : '';
121
+ },
122
+ validate(control) {
123
+ currentControl = control;
124
+ control.setCustomValidity('');
125
+ issue = readIssue(control);
126
+ control.setCustomValidity(issue ? resolveFormText(getOverride()) || uiM(issue.key, issue.params) : '');
127
+ },
128
+ blur(control) {
129
+ // 默认焦点离开未输入的空字段时不挤动按钮/链接;提交仍由原生 invalid 校验。
130
+ if (edited || control.value || issue)
131
+ this.validate(control);
132
+ },
133
+ input(control) {
134
+ edited = true;
135
+ currentControl = control;
136
+ control.setCustomValidity('');
137
+ if (issue)
138
+ issue = readIssue(control);
139
+ },
140
+ reset,
141
+ };
142
+ }
@@ -0,0 +1,14 @@
1
+ /**
2
+ * 校验 IconButton 字符串图标是否属于保守的内联 SVG 子集。
3
+ *
4
+ * 字符串入口只服务由应用代码内置的简单 path/circle 等图标。涉及链接、外部资源、
5
+ * CSS、动画或可执行事件的 SVG 一律拒绝;复杂图标应使用 Svelte Snippet。
6
+ * @param markup - 候选内联 SVG 文本。
7
+ * @returns 允许标签及属性的 SVG;无效或不安全内容被移除。
8
+ *
9
+ * @example 模块内部上下文
10
+ * ```ts
11
+ * const safe = sanitizeInlineSvg('<svg viewBox="0 0 24 24"><path d="M0 0h24v24"/></svg>')
12
+ * ```
13
+ */
14
+ export declare function sanitizeInlineSvg(markup: string): string;
@@ -0,0 +1,40 @@
1
+ const unsafeSvgElements = new Set([
2
+ 'a',
3
+ 'script',
4
+ 'style',
5
+ 'foreignobject',
6
+ 'iframe',
7
+ 'object',
8
+ 'embed',
9
+ 'link',
10
+ 'meta',
11
+ 'image',
12
+ 'use',
13
+ 'animate',
14
+ 'animatemotion',
15
+ 'animatetransform',
16
+ 'set',
17
+ ]);
18
+ /**
19
+ * 校验 IconButton 字符串图标是否属于保守的内联 SVG 子集。
20
+ *
21
+ * 字符串入口只服务由应用代码内置的简单 path/circle 等图标。涉及链接、外部资源、
22
+ * CSS、动画或可执行事件的 SVG 一律拒绝;复杂图标应使用 Svelte Snippet。
23
+ * @param markup - 候选内联 SVG 文本。
24
+ * @returns 允许标签及属性的 SVG;无效或不安全内容被移除。
25
+ *
26
+ * @example 模块内部上下文
27
+ * ```ts
28
+ * const safe = sanitizeInlineSvg('<svg viewBox="0 0 24 24"><path d="M0 0h24v24"/></svg>')
29
+ * ```
30
+ */
31
+ export function sanitizeInlineSvg(markup) {
32
+ const trimmed = markup.trim();
33
+ if (!trimmed || !/^<svg(?:\s[^>]*)?>[\s\S]*<\/svg>$/i.test(trimmed))
34
+ return '';
35
+ const hasUnsafeElement = [...trimmed.matchAll(/<\s*([a-z][\w-]*)\b/gi)]
36
+ .some(([, tagName]) => tagName && unsafeSvgElements.has(tagName.toLowerCase()));
37
+ const hasUnsafeAttribute = /\s(?:on[a-z]+|style|href|xlink:href|src)\s*=/i.test(trimmed);
38
+ const hasExternalReference = /url\s*\(|@import|javascript:|vbscript:|data:text\/html|<\s*!/i.test(trimmed);
39
+ return hasUnsafeElement || hasUnsafeAttribute || hasExternalReference ? '' : trimmed;
40
+ }
@@ -0,0 +1,21 @@
1
+ /**
2
+ * 读取请求/浏览器当前 UI 语言,服务端不跨请求修改全局默认值。
3
+ * @returns 当前请求或浏览器的 UI 语言。
4
+ *
5
+ * @example 模块内部上下文
6
+ * ```ts
7
+ * const locale = readUILocale()
8
+ * ```
9
+ */
10
+ export declare function readUILocale(): string;
11
+ /**
12
+ * 同步当前浏览器的 UI 语言;SSR 保持请求级隔离。
13
+ * @param locale - 显式语言代码;省略时使用当前上下文。
14
+ * @returns {void} 无返回值;同步浏览器语言,服务端保持请求隔离。
15
+ *
16
+ * @example 模块内部上下文
17
+ * ```ts
18
+ * changeUILocale('en-US')
19
+ * ```
20
+ */
21
+ export declare function changeUILocale(locale: string): void;
@@ -0,0 +1,43 @@
1
+ /** UI 语言变更触发组件重新求值;实际语言仍由 core 统一管理。 */
2
+ import { core } from '@h-ai/core';
3
+ import { untrack } from 'svelte';
4
+ import { createSubscriber } from 'svelte/reactivity';
5
+ let notifyLocaleChange;
6
+ const subscribe = createSubscriber((update) => {
7
+ notifyLocaleChange = update;
8
+ return () => {
9
+ notifyLocaleChange = undefined;
10
+ };
11
+ });
12
+ /**
13
+ * 读取请求/浏览器当前 UI 语言,服务端不跨请求修改全局默认值。
14
+ * @returns 当前请求或浏览器的 UI 语言。
15
+ *
16
+ * @example 模块内部上下文
17
+ * ```ts
18
+ * const locale = readUILocale()
19
+ * ```
20
+ */
21
+ export function readUILocale() {
22
+ subscribe();
23
+ return core.i18n.getGlobalLocale();
24
+ }
25
+ /**
26
+ * 同步当前浏览器的 UI 语言;SSR 保持请求级隔离。
27
+ * @param locale - 显式语言代码;省略时使用当前上下文。
28
+ * @returns {void} 无返回值;同步浏览器语言,服务端保持请求隔离。
29
+ *
30
+ * @example 模块内部上下文
31
+ * ```ts
32
+ * changeUILocale('en-US')
33
+ * ```
34
+ */
35
+ export function changeUILocale(locale) {
36
+ if (typeof window === 'undefined')
37
+ return;
38
+ core.i18n.setGlobalLocale(locale);
39
+ // 宿主可能在 $effect 中同步语言,setter 不能反向订阅自身状态。
40
+ untrack(() => {
41
+ notifyLocaleChange?.();
42
+ });
43
+ }
@@ -0,0 +1,138 @@
1
+ /**
2
+ * @h-ai/ui — Message 状态管理
3
+ *
4
+ * 命令式消息入口,复用 Toast 的显示风格、队列和生命周期。
5
+ * @module message.svelte
6
+ */
7
+ import type { MessageOptions } from './types.js';
8
+ /**
9
+ * 内部消息条目
10
+ *
11
+ * @example
12
+ * ```ts
13
+ * import type { MessageItem } from '@h-ai/ui'
14
+ * const example: MessageItem = { id: 'message-1', message: '保存完成', type: 'success', duration: 3000, closable: true }
15
+ * ```
16
+ */
17
+ export interface MessageItem {
18
+ id: string;
19
+ message: string;
20
+ type: 'info' | 'success' | 'warning' | 'error';
21
+ duration: number;
22
+ closable: boolean;
23
+ }
24
+ /**
25
+ * Message 状态
26
+ */
27
+ declare class MessageState {
28
+ /** 当前统一通知队列的消息视图。 */
29
+ get items(): MessageItem[];
30
+ /**
31
+ * 添加消息
32
+ * @param options - 本次操作的行为与显示选项。
33
+ * @returns 新条目的 ID,可用于提前移除。
34
+ * @example
35
+ * ```ts
36
+ * import { message } from '@h-ai/ui'
37
+ * // 布局中需挂载 MessageContainer。
38
+ * const id = message.add({ message: '保存完成', type: 'success', duration: 3000 })
39
+ * message.remove(id)
40
+ * ```
41
+ */
42
+ add(options: MessageOptions | string): string;
43
+ /**
44
+ * 移除消息
45
+ * @param id - 待移除的条目 ID。
46
+ * @returns {void} 无返回值;同时清理对应的自动关闭定时器。
47
+ * @example
48
+ * ```ts
49
+ * import { message } from '@h-ai/ui'
50
+ * // 布局中需挂载 MessageContainer。
51
+ * const id = message.info('同步中', 0)
52
+ * message.remove(id)
53
+ * ```
54
+ */
55
+ remove(id: string): void;
56
+ /**
57
+ * 清空所有消息
58
+ * @returns {void} 无返回值;同时清理对应的自动关闭定时器。
59
+ * @example
60
+ * ```ts
61
+ * import { message } from '@h-ai/ui'
62
+ * // 布局中需挂载 MessageContainer。
63
+ * message.info('同步中', 0)
64
+ * message.clear()
65
+ * ```
66
+ */
67
+ clear(): void;
68
+ /**
69
+ * 快捷方法
70
+ * @param message - 已经本地化的用户提示。
71
+ * @param duration - 提示持续时间,单位毫秒。
72
+ * @returns 新条目的 ID,可用于提前移除。
73
+ * @example
74
+ * ```ts
75
+ * import { message } from '@h-ai/ui'
76
+ * // 布局中需挂载 MessageContainer。
77
+ * const id = message.info('操作结果', 3000)
78
+ * message.remove(id)
79
+ * ```
80
+ */
81
+ info(message: string, duration?: number): string;
82
+ /**
83
+ * 处理 success 操作。
84
+ * @param message - 已经本地化的用户提示。
85
+ * @param duration - 提示持续时间,单位毫秒。
86
+ * @returns 新条目的 ID,可用于提前移除。
87
+ * @example
88
+ * ```ts
89
+ * import { message } from '@h-ai/ui'
90
+ * // 布局中需挂载 MessageContainer。
91
+ * const id = message.success('操作结果', 3000)
92
+ * message.remove(id)
93
+ * ```
94
+ */
95
+ success(message: string, duration?: number): string;
96
+ /**
97
+ * 处理 warning 操作。
98
+ * @param message - 已经本地化的用户提示。
99
+ * @param duration - 提示持续时间,单位毫秒。
100
+ * @returns 新条目的 ID,可用于提前移除。
101
+ * @example
102
+ * ```ts
103
+ * import { message } from '@h-ai/ui'
104
+ * // 布局中需挂载 MessageContainer。
105
+ * const id = message.warning('操作结果', 3000)
106
+ * message.remove(id)
107
+ * ```
108
+ */
109
+ warning(message: string, duration?: number): string;
110
+ /**
111
+ * 处理 error 操作。
112
+ * @param message - 已经本地化的用户提示。
113
+ * @param duration - 提示持续时间,单位毫秒。
114
+ * @returns 新条目的 ID,可用于提前移除。
115
+ * @example
116
+ * ```ts
117
+ * import { message } from '@h-ai/ui'
118
+ * // 布局中需挂载 MessageContainer。
119
+ * const id = message.error('操作结果', 3000)
120
+ * message.remove(id)
121
+ * ```
122
+ */
123
+ error(message: string, duration?: number): string;
124
+ }
125
+ /**
126
+ * Message 单例
127
+ *
128
+ * @example
129
+ * ```ts
130
+ * import { message } from '@h-ai/ui'
131
+ * // 页面布局需挂载 MessageContainer。
132
+ * const id = message.success('保存完成', 3000)
133
+ * message.remove(id)
134
+ * message.clear()
135
+ * ```
136
+ */
137
+ export declare const message: MessageState;
138
+ export {};
@@ -0,0 +1,149 @@
1
+ /**
2
+ * @h-ai/ui — Message 状态管理
3
+ *
4
+ * 命令式消息入口,复用 Toast 的显示风格、队列和生命周期。
5
+ * @module message.svelte
6
+ */
7
+ import { toast } from './toast.svelte.js';
8
+ /**
9
+ * Message 状态
10
+ */
11
+ class MessageState {
12
+ /** 当前统一通知队列的消息视图。 */
13
+ get items() {
14
+ return toast.items.map(item => ({
15
+ id: item.id,
16
+ message: item.message,
17
+ type: item.variant === 'success' || item.variant === 'warning' || item.variant === 'error' ? item.variant : 'info',
18
+ duration: item.duration ?? 3000,
19
+ closable: item.dismissible ?? true,
20
+ }));
21
+ }
22
+ /**
23
+ * 添加消息
24
+ * @param options - 本次操作的行为与显示选项。
25
+ * @returns 新条目的 ID,可用于提前移除。
26
+ * @example
27
+ * ```ts
28
+ * import { message } from '@h-ai/ui'
29
+ * // 布局中需挂载 MessageContainer。
30
+ * const id = message.add({ message: '保存完成', type: 'success', duration: 3000 })
31
+ * message.remove(id)
32
+ * ```
33
+ */
34
+ add(options) {
35
+ const opts = typeof options === 'string' ? { message: options } : options;
36
+ return toast.add({
37
+ message: opts.message,
38
+ variant: opts.type ?? 'info',
39
+ duration: opts.duration ?? 3000,
40
+ dismissible: opts.closable ?? true,
41
+ });
42
+ }
43
+ /**
44
+ * 移除消息
45
+ * @param id - 待移除的条目 ID。
46
+ * @returns {void} 无返回值;同时清理对应的自动关闭定时器。
47
+ * @example
48
+ * ```ts
49
+ * import { message } from '@h-ai/ui'
50
+ * // 布局中需挂载 MessageContainer。
51
+ * const id = message.info('同步中', 0)
52
+ * message.remove(id)
53
+ * ```
54
+ */
55
+ remove(id) {
56
+ toast.remove(id);
57
+ }
58
+ /**
59
+ * 清空所有消息
60
+ * @returns {void} 无返回值;同时清理对应的自动关闭定时器。
61
+ * @example
62
+ * ```ts
63
+ * import { message } from '@h-ai/ui'
64
+ * // 布局中需挂载 MessageContainer。
65
+ * message.info('同步中', 0)
66
+ * message.clear()
67
+ * ```
68
+ */
69
+ clear() {
70
+ toast.clear();
71
+ }
72
+ /**
73
+ * 快捷方法
74
+ * @param message - 已经本地化的用户提示。
75
+ * @param duration - 提示持续时间,单位毫秒。
76
+ * @returns 新条目的 ID,可用于提前移除。
77
+ * @example
78
+ * ```ts
79
+ * import { message } from '@h-ai/ui'
80
+ * // 布局中需挂载 MessageContainer。
81
+ * const id = message.info('操作结果', 3000)
82
+ * message.remove(id)
83
+ * ```
84
+ */
85
+ info(message, duration) {
86
+ return this.add({ message, type: 'info', duration });
87
+ }
88
+ /**
89
+ * 处理 success 操作。
90
+ * @param message - 已经本地化的用户提示。
91
+ * @param duration - 提示持续时间,单位毫秒。
92
+ * @returns 新条目的 ID,可用于提前移除。
93
+ * @example
94
+ * ```ts
95
+ * import { message } from '@h-ai/ui'
96
+ * // 布局中需挂载 MessageContainer。
97
+ * const id = message.success('操作结果', 3000)
98
+ * message.remove(id)
99
+ * ```
100
+ */
101
+ success(message, duration) {
102
+ return this.add({ message, type: 'success', duration });
103
+ }
104
+ /**
105
+ * 处理 warning 操作。
106
+ * @param message - 已经本地化的用户提示。
107
+ * @param duration - 提示持续时间,单位毫秒。
108
+ * @returns 新条目的 ID,可用于提前移除。
109
+ * @example
110
+ * ```ts
111
+ * import { message } from '@h-ai/ui'
112
+ * // 布局中需挂载 MessageContainer。
113
+ * const id = message.warning('操作结果', 3000)
114
+ * message.remove(id)
115
+ * ```
116
+ */
117
+ warning(message, duration) {
118
+ return this.add({ message, type: 'warning', duration });
119
+ }
120
+ /**
121
+ * 处理 error 操作。
122
+ * @param message - 已经本地化的用户提示。
123
+ * @param duration - 提示持续时间,单位毫秒。
124
+ * @returns 新条目的 ID,可用于提前移除。
125
+ * @example
126
+ * ```ts
127
+ * import { message } from '@h-ai/ui'
128
+ * // 布局中需挂载 MessageContainer。
129
+ * const id = message.error('操作结果', 3000)
130
+ * message.remove(id)
131
+ * ```
132
+ */
133
+ error(message, duration) {
134
+ return this.add({ message, type: 'error', duration });
135
+ }
136
+ }
137
+ /**
138
+ * Message 单例
139
+ *
140
+ * @example
141
+ * ```ts
142
+ * import { message } from '@h-ai/ui'
143
+ * // 页面布局需挂载 MessageContainer。
144
+ * const id = message.success('保存完成', 3000)
145
+ * message.remove(id)
146
+ * message.clear()
147
+ * ```
148
+ */
149
+ export const message = new MessageState();