@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
@@ -4,8 +4,15 @@
4
4
  * DaisyUI 主题元数据和配置
5
5
  * @module theme-config
6
6
  */
7
+ import { readStoredValue, writeStoredValue } from './internal/browser-safety.js';
7
8
  /**
8
- * DaisyUI 内置主题配置(精选)
9
+ * 精选 DaisyUI 主题及 UI 共享样式提供的高对比、直角商务主题。
10
+ *
11
+ * @example
12
+ * ```ts
13
+ * import { THEMES } from '@h-ai/ui'
14
+ * const choices = THEMES.map(theme => ({ value: theme.id, label: theme.name }))
15
+ * ```
9
16
  */
10
17
  export const THEMES = [
11
18
  // 亮色主题
@@ -16,6 +23,7 @@ export const THEMES = [
16
23
  { id: 'lofi', name: 'Lo-Fi', dark: false, primaryColor: '#0d0d0d', bgColor: '#ffffff' },
17
24
  { id: 'winter', name: 'Winter', dark: false, primaryColor: '#047aff', bgColor: '#ffffff' },
18
25
  { id: 'nord', name: 'Nord', dark: false, primaryColor: '#5e81ac', bgColor: '#eceff4' },
26
+ { id: 'formal', name: 'Formal', dark: false, primaryColor: '#123d70', bgColor: '#ffffff' },
19
27
  // 暗色主题
20
28
  { id: 'dark', name: 'Dark', dark: true, primaryColor: '#661ae6', bgColor: '#1d232a' },
21
29
  { id: 'dracula', name: 'Dracula', dark: true, primaryColor: '#ff79c6', bgColor: '#282a36' },
@@ -25,9 +33,17 @@ export const THEMES = [
25
33
  { id: 'sunset', name: 'Sunset', dark: true, primaryColor: '#ff865b', bgColor: '#1a1919' },
26
34
  { id: 'luxury', name: 'Luxury', dark: true, primaryColor: '#c9a53d', bgColor: '#171618' },
27
35
  { id: 'coffee', name: 'Coffee', dark: true, primaryColor: '#db924b', bgColor: '#20161f' },
36
+ { id: 'high-contrast', name: 'High contrast', dark: true, primaryColor: '#ffe04d', bgColor: '#000000' },
28
37
  ];
29
38
  /**
30
39
  * 主题分组配置
40
+ *
41
+ * @example
42
+ * ```ts
43
+ * import { THEME_GROUPS } from '@h-ai/ui'
44
+ * const light = THEME_GROUPS.find(group => group.id === 'light')
45
+ * const choices = light?.themes
46
+ * ```
31
47
  */
32
48
  export const THEME_GROUPS = [
33
49
  {
@@ -43,52 +59,257 @@ export const THEME_GROUPS = [
43
59
  ];
44
60
  /**
45
61
  * 暗色主题列表
62
+ *
63
+ * @example
64
+ * ```ts
65
+ * import { DARK_THEMES } from '@h-ai/ui'
66
+ * const dark = DARK_THEMES.includes('dark')
67
+ * ```
46
68
  */
47
69
  export const DARK_THEMES = THEMES.filter(t => t.dark).map(t => t.id);
70
+ /**
71
+ * 支持的主题 ID 列表
72
+ *
73
+ * @example
74
+ * ```ts
75
+ * import { SUPPORTED_THEME_IDS } from '@h-ai/ui'
76
+ * const supported = SUPPORTED_THEME_IDS.includes('light')
77
+ * ```
78
+ */
79
+ export const SUPPORTED_THEME_IDS = THEMES.map(theme => theme.id);
80
+ /**
81
+ * 默认主题色
82
+ *
83
+ * @example
84
+ * ```ts
85
+ * import { DEFAULT_THEME_COLOR } from '@h-ai/ui'
86
+ * const style = { '--brand-color': DEFAULT_THEME_COLOR }
87
+ * ```
88
+ */
89
+ export const DEFAULT_THEME_COLOR = '#5765f0';
90
+ /**
91
+ * 主题色 CSS 变量名
92
+ *
93
+ * @example
94
+ * ```ts
95
+ * import { DEFAULT_THEME_COLOR_CSS_VAR } from '@h-ai/ui'
96
+ * document.documentElement.style.setProperty(DEFAULT_THEME_COLOR_CSS_VAR, '#2563eb')
97
+ * ```
98
+ */
99
+ export const DEFAULT_THEME_COLOR_CSS_VAR = '--hai-theme-color-default';
100
+ /**
101
+ * 内置主题色预设
102
+ *
103
+ * @example
104
+ * ```ts
105
+ * import { THEME_COLOR_PRESETS } from '@h-ai/ui'
106
+ * const options = THEME_COLOR_PRESETS.map(preset => ({ value: preset.value, labelKey: preset.labelKey }))
107
+ * ```
108
+ */
109
+ export const THEME_COLOR_PRESETS = [
110
+ { value: DEFAULT_THEME_COLOR, labelKey: 'theme_color_tech_purple' },
111
+ { value: '#13b981', labelKey: 'theme_color_grid_green' },
112
+ { value: '#1f5eff', labelKey: 'theme_color_ocean' },
113
+ ];
114
+ const HEX_COLOR_REGEX = /^#[0-9a-f]{6}$/i;
115
+ const SHORT_HEX_COLOR_REGEX = /^#[0-9a-f]{3}$/i;
116
+ const SUPPORTED_THEME_ID_SET = new Set(SUPPORTED_THEME_IDS);
117
+ /**
118
+ * 默认主题
119
+ *
120
+ * @example
121
+ * ```ts
122
+ * import { DEFAULT_THEME, applyTheme } from '@h-ai/ui'
123
+ * applyTheme(DEFAULT_THEME, false)
124
+ * ```
125
+ */
126
+ export const DEFAULT_THEME = 'light';
127
+ /**
128
+ * 主题存储键名
129
+ *
130
+ * @example
131
+ * ```ts
132
+ * import { THEME_STORAGE_KEY, getSavedTheme } from '@h-ai/ui'
133
+ * const preference = { key: THEME_STORAGE_KEY, value: getSavedTheme('light') }
134
+ * // 通过公开安全读取函数消费偏好,不直接访问受限存储。
135
+ * ```
136
+ */
137
+ export const THEME_STORAGE_KEY = 'theme';
48
138
  /**
49
139
  * 获取主题信息
140
+ * @param themeId - 主题候选 ID。
141
+ * @returns 匹配的主题元数据,不存在时返回 undefined。
142
+ *
143
+ * @example
144
+ * ```ts
145
+ * import { getThemeInfo } from '@h-ai/ui'
146
+ * const theme = getThemeInfo('light')
147
+ * const background = theme?.bgColor
148
+ * ```
50
149
  */
51
150
  export function getThemeInfo(themeId) {
52
151
  return THEMES.find(t => t.id === themeId);
53
152
  }
54
153
  /**
55
154
  * 检查是否为暗色主题
155
+ * @param themeId - 主题候选 ID。
156
+ * @returns 是否属于内置暗色主题。
157
+ *
158
+ * @example
159
+ * ```ts
160
+ * import { isDarkTheme } from '@h-ai/ui'
161
+ * const dark = isDarkTheme('dark')
162
+ * ```
56
163
  */
57
164
  export function isDarkTheme(themeId) {
58
165
  return DARK_THEMES.includes(themeId);
59
166
  }
60
- // ─── 主题初始化工具 ───
61
167
  /**
62
- * 默认主题
168
+ * 归一化主题 ID,不支持的值回退到默认主题。
169
+ * @param themeId - 主题候选 ID。
170
+ * @param fallbackThemeId - 候选不支持时尝试的主题。
171
+ * @returns 支持的主题 ID;无效输入按候选和默认主题回退。
172
+ *
173
+ * @example
174
+ * ```ts
175
+ * import { normalizeThemeId } from '@h-ai/ui'
176
+ * const theme = normalizeThemeId('unknown-theme', 'light')
177
+ * ```
63
178
  */
64
- export const DEFAULT_THEME = 'light';
179
+ export function normalizeThemeId(themeId, fallbackThemeId = DEFAULT_THEME) {
180
+ const normalized = `${themeId ?? ''}`;
181
+ if (SUPPORTED_THEME_ID_SET.has(normalized)) {
182
+ return normalized;
183
+ }
184
+ return SUPPORTED_THEME_ID_SET.has(fallbackThemeId) ? fallbackThemeId : DEFAULT_THEME;
185
+ }
65
186
  /**
66
- * 主题存储键名
187
+ * 归一化 Hex 颜色;无效值返回 null。
188
+ * @param value - 待处理或校验的值。
189
+ * @returns 小写六位 Hex 颜色;无效输入返回 null。
190
+ *
191
+ * @example
192
+ * ```ts
193
+ * import { normalizeHexColor } from '@h-ai/ui'
194
+ * const color = normalizeHexColor('#abc')
195
+ * ```
67
196
  */
68
- export const THEME_STORAGE_KEY = 'theme';
197
+ export function normalizeHexColor(value) {
198
+ const normalized = value?.trim().toLowerCase() ?? '';
199
+ if (HEX_COLOR_REGEX.test(normalized)) {
200
+ return normalized;
201
+ }
202
+ if (SHORT_HEX_COLOR_REGEX.test(normalized)) {
203
+ return `#${normalized[1]}${normalized[1]}${normalized[2]}${normalized[2]}${normalized[3]}${normalized[3]}`;
204
+ }
205
+ return null;
206
+ }
207
+ /**
208
+ * 解析主题对应的浏览器色调。
209
+ * @param themeId - 主题候选 ID。
210
+ * @returns 供浏览器控件配色使用的 light/dark 值。
211
+ *
212
+ * @example
213
+ * ```ts
214
+ * import { resolveThemeTone } from '@h-ai/ui'
215
+ * const tone = resolveThemeTone('dark')
216
+ * ```
217
+ */
218
+ export function resolveThemeTone(themeId) {
219
+ return isDarkTheme(themeId) ? 'dark' : 'light';
220
+ }
221
+ function escapeJsonForScript(value) {
222
+ return JSON.stringify(value)
223
+ .replace(/</g, '\\u003C')
224
+ .replace(/>/g, '\\u003E')
225
+ .replace(/\u2028/g, '\\u2028')
226
+ .replace(/\u2029/g, '\\u2029');
227
+ }
228
+ /**
229
+ * 生成首屏主题恢复脚本,适合注入到 SvelteKit `app.html` 的 `<script>` 中。
230
+ * @param options - 本次操作的行为与显示选项。
231
+ * @returns 可放入受控 HTML shell 的初始化脚本文本。
232
+ *
233
+ * @example
234
+ * ```ts
235
+ * import { createThemeBootstrapScript } from '@h-ai/ui'
236
+ * const script = createThemeBootstrapScript({ storageKey: 'demo-theme', defaultThemeId: 'light' })
237
+ * // 在应用 HTML shell 中作为受控脚本使用,避免首屏主题闪烁。
238
+ * ```
239
+ */
240
+ export function createThemeBootstrapScript(options) {
241
+ const defaultThemeId = normalizeThemeId(options.defaultThemeId ?? DEFAULT_THEME);
242
+ const defaultThemeColor = options.defaultThemeColor == null
243
+ ? null
244
+ : normalizeHexColor(options.defaultThemeColor) ?? DEFAULT_THEME_COLOR;
245
+ const locale = options.locale
246
+ ? {
247
+ key: options.locale.key,
248
+ defaultValue: options.locale.defaultValue,
249
+ supportedValues: [...options.locale.supportedValues],
250
+ }
251
+ : null;
252
+ const defaultPreferences = {
253
+ themeId: defaultThemeId,
254
+ };
255
+ if (defaultThemeColor) {
256
+ defaultPreferences.themeColor = defaultThemeColor;
257
+ }
258
+ if (locale) {
259
+ defaultPreferences[locale.key] = locale.defaultValue;
260
+ }
261
+ return `(function(){var d=${escapeJsonForScript(defaultPreferences)};var s=${escapeJsonForScript(options.storageKey)};var l=${escapeJsonForScript(options.legacyThemeStorageKey ?? null)};var u=new Set(${escapeJsonForScript(SUPPORTED_THEME_IDS)});var k=new Set(${escapeJsonForScript(DARK_THEMES)});var c=${escapeJsonForScript(options.colorCssVar ?? null)};var y=${escapeJsonForScript(options.toneDatasetKey ?? null)};var i=${escapeJsonForScript(locale)};function n(e){var r=''+(e??'');return u.has(r)?r:d.themeId}function h(e){var r=(''+(e??'')).trim().toLowerCase();if(/^#[0-9a-f]{6}$/i.test(r))return r;if(/^#[0-9a-f]{3}$/i.test(r))return '#'+r[1]+r[1]+r[2]+r[2]+r[3]+r[3];return Object.prototype.hasOwnProperty.call(d,'themeColor')?d.themeColor:null}function g(e){var r={...d,themeId:n(e?.themeId)};if(Object.prototype.hasOwnProperty.call(d,'themeColor'))r.themeColor=h(e?.themeColor);if(i)r[i.key]=i.supportedValues.includes(e?.[i.key])?e[i.key]:d[i.key];return r}function a(e){var r=document.documentElement;var o=k.has(e.themeId)?'dark':'light';r.setAttribute('data-theme',e.themeId);if(y)r.dataset[y]=o;if(c){if(e.themeColor){r.style.setProperty(c,e.themeColor)}else{r.style.removeProperty(c)}}r.style.setProperty('color-scheme',o)}var p=d;try{var f=window.localStorage.getItem(s);if(f){p=g(JSON.parse(f))}else if(l){p=g({themeId:window.localStorage.getItem(l)})}else{p=g(d)}a(p);window.localStorage.setItem(s,JSON.stringify(p));if(l)window.localStorage.removeItem(l)}catch{a(d)}})()`;
262
+ }
69
263
  /**
70
- * 获取主题初始化脚本(用于 app.html 防闪烁)
264
+ * 获取主题初始化脚本(用于 HTML shell 防闪烁)
71
265
  *
72
- * 使用方式:在 app.html 的 <head> 中添加 <script>{getThemeInitScript()}</script>
266
+ * 返回值是“脚本标签内的文本内容”,适合宿主在构建阶段或服务端模板中注入。
267
+ * 对于 SvelteKit `app.html`,请直接粘贴这段脚本字符串的内容,不能写 `{@html getThemeInitScript()}`。
268
+ * @returns 使用默认存储约定的主题初始化脚本。
269
+ *
270
+ * @example
271
+ * ```ts
272
+ * import { getThemeInitScript } from '@h-ai/ui'
273
+ * const script = getThemeInitScript()
274
+ * ```
73
275
  */
74
276
  export function getThemeInitScript() {
75
- return `(function(){var t=localStorage.getItem('${THEME_STORAGE_KEY}')||'${DEFAULT_THEME}';document.documentElement.setAttribute('data-theme',t)})()`;
277
+ return createThemeBootstrapScript({
278
+ storageKey: THEME_STORAGE_KEY,
279
+ defaultThemeId: DEFAULT_THEME,
280
+ });
76
281
  }
77
282
  /**
78
- * 应用主题
283
+ * 应用主题,并同步原生表单控件配色;自定义主题由宿主 CSS 决定配色。
79
284
  * @param theme - 主题 ID
80
285
  * @param persist - 是否持久化到 localStorage
286
+ * @returns {void} 无返回值;更新当前文档,并按 persist 决定是否保存偏好。
287
+ *
288
+ * @example
289
+ * ```ts
290
+ * import { applyTheme } from '@h-ai/ui'
291
+ * applyTheme('dark', false)
292
+ * // false 仅更新当前 DOM,不写入持久化偏好。
293
+ * ```
81
294
  */
82
295
  export function applyTheme(theme, persist = true) {
83
296
  if (typeof document === 'undefined')
84
297
  return;
85
298
  document.documentElement.setAttribute('data-theme', theme);
86
- if (persist && typeof localStorage !== 'undefined') {
87
- localStorage.setItem(THEME_STORAGE_KEY, theme);
299
+ document.documentElement.style.setProperty('color-scheme', getThemeInfo(theme) ? resolveThemeTone(theme) : '');
300
+ if (persist) {
301
+ writeStoredValue(THEME_STORAGE_KEY, theme);
88
302
  }
89
303
  }
90
304
  /**
91
305
  * 获取当前主题
306
+ * @returns 当前文档主题;无 DOM 时使用默认值。
307
+ *
308
+ * @example
309
+ * ```ts
310
+ * import { getCurrentTheme } from '@h-ai/ui'
311
+ * const theme = getCurrentTheme()
312
+ * ```
92
313
  */
93
314
  export function getCurrentTheme() {
94
315
  if (typeof document === 'undefined')
@@ -96,12 +317,19 @@ export function getCurrentTheme() {
96
317
  return document.documentElement.getAttribute('data-theme') ?? DEFAULT_THEME;
97
318
  }
98
319
  /**
99
- * 获取保存的主题(从 localStorage)
320
+ * 获取保存的主题;存储为空或不可用时使用宿主默认主题。
321
+ *
322
+ * @param fallbackTheme - 未保存主题时的默认值,默认 light
323
+ * @returns 安全读取并归一化的主题偏好。
324
+ *
325
+ * @example
326
+ * ```ts
327
+ * import { getSavedTheme } from '@h-ai/ui'
328
+ * const theme = getSavedTheme('light')
329
+ * ```
100
330
  */
101
- export function getSavedTheme() {
102
- if (typeof localStorage === 'undefined')
103
- return DEFAULT_THEME;
104
- return localStorage.getItem(THEME_STORAGE_KEY) ?? DEFAULT_THEME;
331
+ export function getSavedTheme(fallbackTheme = DEFAULT_THEME) {
332
+ return readStoredValue(THEME_STORAGE_KEY) ?? fallbackTheme;
105
333
  }
106
334
  /**
107
335
  * DaisyUI 主题配置字符串(用于 app.css)
@@ -112,6 +340,13 @@ export function getSavedTheme() {
112
340
  * @plugin "daisyui" {
113
341
  * themes: light --default, dark --prefersdark, cupcake, bumblebee, ...
114
342
  * }
343
+ *
344
+ * @example
345
+ * ```ts
346
+ * import { DAISYUI_THEMES_CONFIG } from '@h-ai/ui'
347
+ * const css = '@plugin "daisyui" { themes: ' + DAISYUI_THEMES_CONFIG + '; }'
348
+ * // 将生成的配置用于构建时 CSS,不在浏览器动态安装主题。
349
+ * ```
115
350
  */
116
351
  export const DAISYUI_THEMES_CONFIG = THEMES.map((t, i) => {
117
352
  if (i === 0)
@@ -7,6 +7,12 @@
7
7
  import type { ToastProps } from './types.js';
8
8
  /**
9
9
  * Toast 项
10
+ *
11
+ * @example
12
+ * ```ts
13
+ * import type { ToastItem } from '@h-ai/ui'
14
+ * const example: ToastItem = { id: 'toast-1', message: '保存完成', variant: 'success', duration: 3000 }
15
+ * ```
10
16
  */
11
17
  export interface ToastItem extends ToastProps {
12
18
  id: string;
@@ -16,30 +22,232 @@ export interface ToastItem extends ToastProps {
16
22
  */
17
23
  declare class ToastState {
18
24
  items: ToastItem[];
19
- /** 自动关闭定时器 */
20
- private timers;
25
+ /** 仅队首计时,等待项在展示后才开始计算停留时间。 */
26
+ private timer;
27
+ private deadline;
28
+ private remaining;
29
+ private paused;
30
+ private startTimer;
31
+ /**
32
+ * 暂停当前提示的自动关闭,供阅读和交互期间使用;等待项不受影响。
33
+ * @param id - 当前提示 ID。
34
+ * @example
35
+ * ```ts
36
+ * const id = toast.info('同步中')
37
+ * toast.pause(id)
38
+ * toast.resume(id)
39
+ * ```
40
+ */
41
+ pause(id: string): void;
42
+ /**
43
+ * 从剩余时间恢复当前提示的自动关闭;手工关闭或清空后不会恢复旧计时器。
44
+ * @param id - 当前提示 ID。
45
+ * @example
46
+ * ```ts
47
+ * const id = toast.info('同步中')
48
+ * toast.pause(id)
49
+ * toast.resume(id)
50
+ * ```
51
+ */
52
+ resume(id: string): void;
21
53
  /**
22
54
  * 添加 Toast
55
+ * @param props - 组件的属性对象。
56
+ * @returns 新条目的 ID,可用于提前移除。
57
+ * @example
58
+ * ```ts
59
+ * import { toast } from '@h-ai/ui'
60
+ * // 布局中需挂载 ToastContainer。
61
+ * const id = toast.add({ message: '保存完成', variant: 'success', duration: 3000 })
62
+ * toast.remove(id)
63
+ * ```
23
64
  */
24
65
  add(props: Omit<ToastProps, 'onclose'>): string;
25
66
  /**
26
67
  * 移除 Toast
68
+ * @param id - 待移除的条目 ID。
69
+ * @returns {void} 无返回值;同时清理对应的自动关闭定时器。
70
+ * @example
71
+ * ```ts
72
+ * import { toast } from '@h-ai/ui'
73
+ * // 布局中需挂载 ToastContainer。
74
+ * const id = toast.info('同步中', 0)
75
+ * toast.remove(id)
76
+ * ```
27
77
  */
28
78
  remove(id: string): void;
29
79
  /**
30
80
  * 清空所有 Toast
81
+ * @returns {void} 无返回值;同时清理对应的自动关闭定时器。
82
+ * @example
83
+ * ```ts
84
+ * import { toast } from '@h-ai/ui'
85
+ * // 布局中需挂载 ToastContainer。
86
+ * toast.info('同步中', 0)
87
+ * toast.clear()
88
+ * ```
31
89
  */
32
90
  clear(): void;
33
91
  /**
34
92
  * 快捷方法
93
+ * @param message - 已经本地化的用户提示。
94
+ * @param duration - 提示持续时间,单位毫秒。
95
+ * @returns 新条目的 ID,可用于提前移除。
96
+ * @example
97
+ * ```ts
98
+ * import { toast } from '@h-ai/ui'
99
+ * // 布局中需挂载 ToastContainer。
100
+ * const id = toast.success('操作结果', 3000)
101
+ * toast.remove(id)
102
+ * ```
35
103
  */
36
104
  success(message: string, duration?: number): string;
105
+ /**
106
+ * 处理 error 操作。
107
+ * @param message - 已经本地化的用户提示。
108
+ * @param duration - 提示持续时间,单位毫秒。
109
+ * @returns 新条目的 ID,可用于提前移除。
110
+ * @example
111
+ * ```ts
112
+ * import { toast } from '@h-ai/ui'
113
+ * // 布局中需挂载 ToastContainer。
114
+ * const id = toast.error('操作结果', 3000)
115
+ * toast.remove(id)
116
+ * ```
117
+ */
37
118
  error(message: string, duration?: number): string;
119
+ /**
120
+ * 处理 warning 操作。
121
+ * @param message - 已经本地化的用户提示。
122
+ * @param duration - 提示持续时间,单位毫秒。
123
+ * @returns 新条目的 ID,可用于提前移除。
124
+ * @example
125
+ * ```ts
126
+ * import { toast } from '@h-ai/ui'
127
+ * // 布局中需挂载 ToastContainer。
128
+ * const id = toast.warning('操作结果', 3000)
129
+ * toast.remove(id)
130
+ * ```
131
+ */
38
132
  warning(message: string, duration?: number): string;
133
+ /**
134
+ * 处理 info 操作。
135
+ * @param message - 已经本地化的用户提示。
136
+ * @param duration - 提示持续时间,单位毫秒。
137
+ * @returns 新条目的 ID,可用于提前移除。
138
+ * @example
139
+ * ```ts
140
+ * import { toast } from '@h-ai/ui'
141
+ * // 布局中需挂载 ToastContainer。
142
+ * const id = toast.info('操作结果', 3000)
143
+ * toast.remove(id)
144
+ * ```
145
+ */
39
146
  info(message: string, duration?: number): string;
40
147
  }
41
148
  /**
42
149
  * Toast 单例
150
+ *
151
+ * @example
152
+ * ```ts
153
+ * import { toast } from '@h-ai/ui'
154
+ * // 页面布局需挂载 ToastContainer。
155
+ * const id = toast.success('保存完成', 3000)
156
+ * toast.remove(id)
157
+ * toast.clear()
158
+ * ```
43
159
  */
44
160
  export declare const toast: ToastState;
161
+ /**
162
+ * 在组件初始化时订阅操作提示,统一交给根布局的 ToastContainer 展示。
163
+ * 只跟踪消息来源,不订阅 Toast 队列;同一消息已在队列中时合并,避免父子组件重复提示。
164
+ * 字段校验保留控件关联和定位,提示统一由此入口展示;文案应已经完成安全映射和本地化。
165
+ * 订阅随组件销毁结束,已发出的通知继续由根容器管理。
166
+ * @param message - 响应式消息读取函数;空值表示没有待提示的操作结果。
167
+ * @param variant - 通知类型,默认 error。
168
+ * @example
169
+ * ```svelte
170
+ * <script lang="ts">
171
+ * import { useToastFeedback } from '@h-ai/ui/toast'
172
+ * let error = $state('')
173
+ * useToastFeedback(() => error)
174
+ * </script>
175
+ * ```
176
+ */
177
+ export declare function useToastFeedback(message: () => string | undefined | null, variant?: NonNullable<ToastProps['variant']>): void;
178
+ /**
179
+ * 弹出操作成功提示(默认右下角)。
180
+ *
181
+ * @description 统一封装 toast 单例,业务应用无需自建 toast 工具文件即可获得一致的成功反馈。
182
+ *
183
+ * @param message - 用户可见的成功文案(已本地化)。
184
+ * @param duration - 可选停留时长(毫秒),默认 3000。
185
+ * @returns 新通知的 ID,可交给 toast.remove 提前移除。
186
+ *
187
+ * @example
188
+ * ```ts
189
+ * import { notifySuccess, toast } from '@h-ai/ui'
190
+ * const id = notifySuccess('保存完成', 3000)
191
+ * toast.remove(id)
192
+ * ```
193
+ */
194
+ export declare function notifySuccess(message: string, duration?: number): string;
195
+ /**
196
+ * 弹出操作失败提示(默认右下角)。
197
+ *
198
+ * @description 接受完整错误对象或已本地化的安全字符串;普通 Error 隐藏原文,
199
+ * 使用 fallback 或通用错误并保留 traceId。不要把未知 Error.message 转成字符串传入。
200
+ *
201
+ * @param error - 错误对象或已本地化的错误文案。
202
+ * @param fallback - 未识别的异常或缺少错误文案时使用的安全兜底说明。
203
+ * @param duration - 可选停留时长(毫秒),默认 5000。
204
+ * @returns 新错误通知的 ID,可交给 toast.remove 提前移除。
205
+ *
206
+ * @example
207
+ * ```ts
208
+ * import { notifyError, toast } from '@h-ai/ui'
209
+ * const id = notifyError(new Error('提交失败'), '请稍后重试', 5000)
210
+ * toast.remove(id)
211
+ * ```
212
+ */
213
+ export declare function notifyError(error: unknown, fallback?: string, duration?: number): string;
214
+ /**
215
+ * 生成安全错误提示;日志保留脱敏原因,字符串携带追踪编号供 ToastContainer 分离展示。
216
+ * @example
217
+ * ```ts
218
+ * import { errorMessage } from '@h-ai/ui'
219
+ * const text = errorMessage(new Error('Internal detail'), '保存失败')
220
+ * ```
221
+ */
222
+ export declare function errorMessage(error: unknown, fallback?: string): string;
223
+ /**
224
+ * 弹出信息提示(默认右下角)。
225
+ *
226
+ * @param message - 用户可见文案(已本地化)。
227
+ * @param duration - 可选停留时长(毫秒),默认 3000。
228
+ * @returns 新提示的 ID。
229
+ *
230
+ * @example
231
+ * ```ts
232
+ * import { notifyInfo, toast } from '@h-ai/ui'
233
+ * const id = notifyInfo('正在同步', 3000)
234
+ * toast.remove(id)
235
+ * ```
236
+ */
237
+ export declare function notifyInfo(message: string, duration?: number): string;
238
+ /**
239
+ * 弹出警告提示(默认右下角)。
240
+ *
241
+ * @param message - 用户可见文案(已本地化)。
242
+ * @param duration - 可选停留时长(毫秒),默认 5000。
243
+ * @returns 新警告的 ID。
244
+ *
245
+ * @example
246
+ * ```ts
247
+ * import { notifyWarning, toast } from '@h-ai/ui'
248
+ * const id = notifyWarning('请先保存修改', 5000)
249
+ * toast.remove(id)
250
+ * ```
251
+ */
252
+ export declare function notifyWarning(message: string, duration?: number): string;
45
253
  export {};