@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
@@ -0,0 +1,506 @@
1
+ import { tick } from 'svelte';
2
+ import { SvelteSet } from 'svelte/reactivity';
3
+ import { createBrowserNavAdapter } from './components/scenes/crud/nav-adapter.js';
4
+ import { createGuideStorage } from './guide-storage.js';
5
+ import { getUILocale, uiM } from './messages.js';
6
+ /** 同一浏览器页面只允许一个导览拥有遮罩和键盘监听。 */
7
+ let stopActiveGuide;
8
+ /**
9
+ * 解析业务文案;既支持普通字符串,也支持应用 i18n 函数。
10
+ * @param text - 待处理文本。
11
+ * @returns 业务字符串或延迟翻译函数的当前文本;空输入为空字符串。
12
+ *
13
+ * @example
14
+ * ```ts
15
+ * import { resolveGuideText } from '@h-ai/ui'
16
+ * const title = resolveGuideText(() => '操作说明')
17
+ * ```
18
+ */
19
+ export function resolveGuideText(text) {
20
+ return typeof text === 'function' ? text() : text ?? '';
21
+ }
22
+ function escapeGuideText(text) {
23
+ return resolveGuideText(text).replace(/[&<>"']/g, character => ({
24
+ '&': '&amp;',
25
+ '<': '&lt;',
26
+ '>': '&gt;',
27
+ '"': '&quot;',
28
+ '\'': '&#39;',
29
+ })[character]);
30
+ }
31
+ function findTarget(step) {
32
+ try {
33
+ const element = typeof step.target === 'function'
34
+ ? step.target()
35
+ : [...document.querySelectorAll('[data-guide]')].find(item => item.getAttribute('data-guide') === step.target);
36
+ if (!element?.isConnected || !element.getClientRects().length || element.closest('[hidden], [aria-hidden="true"]'))
37
+ return null;
38
+ const style = getComputedStyle(element);
39
+ return style.visibility === 'hidden' || style.display === 'none' ? null : element;
40
+ }
41
+ catch {
42
+ return null;
43
+ }
44
+ }
45
+ /** 等待异步渲染、页签展开或布局变化,所有退出路径均清理监听和计时器。 */
46
+ function waitForTarget(step, signal, timeout, ready) {
47
+ return new Promise((resolve) => {
48
+ let observer;
49
+ let timer;
50
+ let poll;
51
+ const finish = (element) => {
52
+ observer?.disconnect();
53
+ clearTimeout(timer);
54
+ clearInterval(poll);
55
+ signal.removeEventListener('abort', aborted);
56
+ resolve(element);
57
+ };
58
+ function aborted() {
59
+ finish(null);
60
+ }
61
+ const check = () => {
62
+ if (signal.aborted) {
63
+ finish(null);
64
+ return;
65
+ }
66
+ try {
67
+ const element = ready() ? findTarget(step) : null;
68
+ if (element)
69
+ finish(element);
70
+ }
71
+ catch {
72
+ finish(null);
73
+ }
74
+ };
75
+ if (signal.aborted) {
76
+ finish(null);
77
+ return;
78
+ }
79
+ try {
80
+ const initial = ready() ? findTarget(step) : null;
81
+ if (initial) {
82
+ finish(initial);
83
+ return;
84
+ }
85
+ }
86
+ catch {
87
+ finish(null);
88
+ return;
89
+ }
90
+ observer = new MutationObserver(check);
91
+ observer.observe(document.documentElement, { childList: true, subtree: true, attributes: true });
92
+ signal.addEventListener('abort', aborted, { once: true });
93
+ timer = setTimeout(finish, timeout, null);
94
+ poll = setInterval(check, 50);
95
+ });
96
+ }
97
+ /**
98
+ * 创建应用独享的新手引导控制器。SSR 可创建,DOM 操作只在客户端启动时发生。
99
+ * 配置和控制器应在布局组件内创建,避免在 SSR 模块级共享用户状态。
100
+ * @param options - 本次操作的行为与显示选项。
101
+ * @returns 导览与帮助中心控制器;交互失败使用 false/error 表达。
102
+ *
103
+ * @example
104
+ * ```ts
105
+ * import { createGuide } from '@h-ai/ui'
106
+ * const guide = createGuide({ tours: [{ id: 'intro', title: '入门', steps: [{ target: 'save', title: '保存', description: '提交当前资料' }] }], persistence: 'memory' })
107
+ * const offered = guide.startIfNeeded('intro')
108
+ * if (offered) guide.openHelp()
109
+ * guide.stop()
110
+ * ```
111
+ */
112
+ export function createGuide(options) {
113
+ const storage = createGuideStorage(options);
114
+ const nav = options.nav ?? createBrowserNavAdapter();
115
+ const persistKey = options.persistKey ?? 'hai-guide';
116
+ const pendingKey = `${persistKey}-pending`;
117
+ let scope = 'anonymous';
118
+ let locale = $state(getUILocale());
119
+ let offeredId = $state(null);
120
+ let activeTourId = $state(null);
121
+ let busy = $state(false);
122
+ let error = $state('');
123
+ let helpOpen = $state(false);
124
+ let articleId = $state(null);
125
+ let driver;
126
+ let abort;
127
+ let generation = 0;
128
+ let expectedPath;
129
+ let navigating = false;
130
+ let focusBefore = null;
131
+ let activeElement = null;
132
+ let targetObserver;
133
+ const msg = (key) => uiM(key, undefined, locale);
134
+ const progressKey = (id) => `${persistKey}:${scope}:${id}`;
135
+ const tourFor = (id) => {
136
+ try {
137
+ return options.tours.find(tour => tour.id === id && (!tour.enabled || tour.enabled()));
138
+ }
139
+ catch {
140
+ return undefined;
141
+ }
142
+ };
143
+ function clearPending() {
144
+ try {
145
+ sessionStorage.removeItem(pendingKey);
146
+ }
147
+ catch {
148
+ // 存储受限时仅支持宿主客户端导航。
149
+ }
150
+ }
151
+ function stop() {
152
+ generation++;
153
+ abort?.abort();
154
+ abort = undefined;
155
+ targetObserver?.disconnect();
156
+ targetObserver = undefined;
157
+ const previousDriver = driver;
158
+ driver = undefined;
159
+ previousDriver?.destroy();
160
+ activeTourId = null;
161
+ activeElement = null;
162
+ busy = false;
163
+ expectedPath = undefined;
164
+ if (!navigating)
165
+ clearPending();
166
+ if (stopActiveGuide === stop)
167
+ stopActiveGuide = undefined;
168
+ if (focusBefore?.isConnected)
169
+ focusBefore.focus();
170
+ focusBefore = null;
171
+ }
172
+ function mark(tour, status) {
173
+ storage.set(progressKey(tour.id), { version: tour.version ?? 1, status, updatedAt: Date.now() });
174
+ }
175
+ function getProgress(id) {
176
+ return storage.get(progressKey(id));
177
+ }
178
+ function driverSteps(tour) {
179
+ return tour.steps.map(step => ({
180
+ element: () => findTarget(step) ?? document.body,
181
+ popover: {
182
+ title: escapeGuideText(step.title),
183
+ description: escapeGuideText(step.description),
184
+ side: step.side ?? 'bottom',
185
+ },
186
+ }));
187
+ }
188
+ function translatedConfig(tour) {
189
+ return {
190
+ steps: driverSteps(tour),
191
+ nextBtnText: msg('guide_next'),
192
+ prevBtnText: msg('guide_previous'),
193
+ doneBtnText: msg('guide_done'),
194
+ closeBtnLabel: msg('guide_close'),
195
+ progressText: uiM('guide_progress', { current: '{{current}}', total: '{{total}}' }, locale),
196
+ };
197
+ }
198
+ async function start(id) {
199
+ if (typeof document === 'undefined')
200
+ return false;
201
+ stopActiveGuide?.();
202
+ stop();
203
+ navigating = false;
204
+ error = '';
205
+ offeredId = null;
206
+ helpOpen = false;
207
+ const tour = tourFor(id);
208
+ if (!tour?.steps.length) {
209
+ error ||= 'guide_unavailable';
210
+ return false;
211
+ }
212
+ const run = generation;
213
+ const signal = new AbortController();
214
+ abort = signal;
215
+ activeTourId = id;
216
+ busy = true;
217
+ stopActiveGuide = stop;
218
+ focusBefore = document.activeElement instanceof HTMLElement ? document.activeElement : null;
219
+ const requiredSeen = new SvelteSet();
220
+ let finishHighlight;
221
+ function hasPreviousStep(index = driver?.getActiveIndex() ?? 0) {
222
+ return [...requiredSeen].some(stepIndex => stepIndex < index);
223
+ }
224
+ function disableNavigation(disabled) {
225
+ const popover = driver?.getState().popover;
226
+ if (popover) {
227
+ popover.nextButton.disabled = disabled;
228
+ popover.previousButton.disabled = disabled || !hasPreviousStep();
229
+ }
230
+ }
231
+ async function showStep(index, direction = 1) {
232
+ if (signal.signal.aborted || run !== generation)
233
+ return false;
234
+ busy = true;
235
+ disableNavigation(true);
236
+ try {
237
+ while (index >= 0 && index < tour.steps.length) {
238
+ const step = tour.steps[index];
239
+ await step.before?.(signal.signal);
240
+ await tick();
241
+ if (signal.signal.aborted || run !== generation)
242
+ return false;
243
+ const element = await waitForTarget(step, signal.signal, options.waitTimeout ?? 3000, () => !expectedPath || nav.pathname === expectedPath);
244
+ if (signal.signal.aborted || run !== generation)
245
+ return false;
246
+ if (!element) {
247
+ if (step.optional) {
248
+ index += direction;
249
+ continue;
250
+ }
251
+ error = 'guide_targetMissing';
252
+ stop();
253
+ return false;
254
+ }
255
+ requiredSeen.add(index);
256
+ activeElement = element;
257
+ driver?.setConfig({ ...driver.getConfig(), ...translatedConfig(tour) });
258
+ // 等到引擎完成首帧定位后再报告启动成功,键盘此时已可操作。
259
+ await new Promise((resolve) => {
260
+ const finished = () => {
261
+ signal.signal.removeEventListener('abort', finished);
262
+ if (finishHighlight === finished)
263
+ finishHighlight = undefined;
264
+ resolve();
265
+ };
266
+ finishHighlight = finished;
267
+ signal.signal.addEventListener('abort', finished, { once: true });
268
+ driver?.drive(index);
269
+ });
270
+ if (!signal.signal.aborted && run === generation && !findTarget(step)) {
271
+ error = 'guide_targetMissing';
272
+ stop();
273
+ return false;
274
+ }
275
+ return !signal.signal.aborted && run === generation;
276
+ }
277
+ if (direction > 0 && tour.steps.every((step, stepIndex) => step.optional || requiredSeen.has(stepIndex)) && requiredSeen.size) {
278
+ // 完成点击与 DOM 卸载可能发生在同一帧,不能把已消失的目标误记为完成。
279
+ const currentStep = tour.steps[driver?.getActiveIndex() ?? 0];
280
+ if (!currentStep || !findTarget(currentStep)) {
281
+ error = 'guide_targetMissing';
282
+ stop();
283
+ return false;
284
+ }
285
+ mark(tour, 'completed');
286
+ stop();
287
+ return true;
288
+ }
289
+ error = 'guide_targetMissing';
290
+ stop();
291
+ return false;
292
+ }
293
+ catch {
294
+ if (!signal.signal.aborted && run === generation) {
295
+ error = 'guide_startFailed';
296
+ stop();
297
+ }
298
+ return false;
299
+ }
300
+ finally {
301
+ if (run === generation) {
302
+ busy = false;
303
+ disableNavigation(false);
304
+ }
305
+ }
306
+ }
307
+ try {
308
+ // 动态导入引擎,只有开始导览时才加载定位和遮罩实现。
309
+ const { driver: createDriver } = await import('driver.js');
310
+ if (signal.signal.aborted || run !== generation)
311
+ return false;
312
+ if (tour.route && nav.pathname !== tour.route.split('?')[0]) {
313
+ expectedPath = tour.route.split('?')[0];
314
+ navigating = true;
315
+ try {
316
+ sessionStorage.setItem(pendingKey, JSON.stringify({ id, scope, route: expectedPath, createdAt: Date.now() }));
317
+ }
318
+ catch {
319
+ // Cookie 或 WebView 存储限制不阻止客户端导航。
320
+ }
321
+ await nav.navigate(tour.route);
322
+ if (signal.signal.aborted || run !== generation)
323
+ return false;
324
+ if (!options.nav) {
325
+ // 默认导航会完整加载新页面;保留待启动记录,由目标页宿主恢复。
326
+ stop();
327
+ return true;
328
+ }
329
+ navigating = false;
330
+ }
331
+ expectedPath ??= nav.pathname;
332
+ driver = createDriver({
333
+ ...translatedConfig(tour),
334
+ popoverClass: 'hai-guide-popover',
335
+ showProgress: true,
336
+ animate: !globalThis.matchMedia?.('(prefers-reduced-motion: reduce)').matches,
337
+ duration: 200,
338
+ stageRadius: 10,
339
+ stagePadding: 8,
340
+ overlayOpacity: 0.45,
341
+ allowKeyboardControl: true,
342
+ overlayClickBehavior: 'close',
343
+ onNextClick: () => {
344
+ if (!busy)
345
+ void showStep((driver?.getActiveIndex() ?? 0) + 1);
346
+ },
347
+ onPrevClick: () => {
348
+ if (!busy && hasPreviousStep())
349
+ void showStep((driver?.getActiveIndex() ?? 0) - 1, -1);
350
+ },
351
+ onDoneClick: () => {
352
+ if (!busy)
353
+ void showStep(tour.steps.length);
354
+ },
355
+ onHighlighted: () => finishHighlight?.(),
356
+ // 引擎首帧未完成时不会触发 onDestroyed;从关闭开始时统一取消等待。
357
+ onDestroyStarted: stop,
358
+ onDestroyed: () => {
359
+ if (driver) {
360
+ driver = undefined;
361
+ stop();
362
+ }
363
+ },
364
+ onPopoverRender: (popover) => {
365
+ try {
366
+ // 第三方默认支持 HTML;业务翻译和插值统一按纯文本写入。
367
+ const index = driver?.getActiveIndex() ?? 0;
368
+ const step = tour.steps[index];
369
+ popover.title.textContent = resolveGuideText(step?.title);
370
+ popover.description.textContent = resolveGuideText(step?.description);
371
+ popover.nextButton.textContent = msg(index === tour.steps.length - 1 ? 'guide_done' : 'guide_next');
372
+ popover.previousButton.textContent = msg('guide_previous');
373
+ popover.progress.textContent = uiM('guide_progress', { current: index + 1, total: tour.steps.length }, locale);
374
+ popover.nextButton.disabled = busy;
375
+ popover.previousButton.disabled = busy || !hasPreviousStep(index);
376
+ }
377
+ catch {
378
+ error = 'guide_startFailed';
379
+ stop();
380
+ }
381
+ },
382
+ });
383
+ const started = await showStep(0);
384
+ if (started && !signal.signal.aborted) {
385
+ clearPending();
386
+ targetObserver = new MutationObserver(() => {
387
+ if (!busy && activeElement && !findTarget(tour.steps[driver?.getActiveIndex() ?? 0])) {
388
+ error = 'guide_targetMissing';
389
+ stop();
390
+ }
391
+ });
392
+ targetObserver.observe(document.documentElement, { subtree: true, childList: true, attributes: true });
393
+ }
394
+ return started;
395
+ }
396
+ catch {
397
+ if (!signal.signal.aborted && run === generation) {
398
+ navigating = false;
399
+ error = 'guide_startFailed';
400
+ stop();
401
+ }
402
+ return false;
403
+ }
404
+ }
405
+ return {
406
+ get tours() { return options.tours.filter(tour => !tour.enabled || tour.enabled()); },
407
+ get articles() { return (options.articles ?? []).filter(article => !article.enabled || article.enabled()); },
408
+ get offeredTour() { return offeredId ? tourFor(offeredId) : undefined; },
409
+ get activeTourId() { return activeTourId; },
410
+ get busy() { return busy; },
411
+ get error() { return error ? msg(error) : ''; },
412
+ get locale() { return locale; },
413
+ get pathname() { return nav.pathname; },
414
+ get helpOpen() { return helpOpen; },
415
+ get articleId() { return articleId; },
416
+ start,
417
+ startIfNeeded(id) {
418
+ const tour = tourFor(id);
419
+ if (!tour || activeTourId || offeredId || typeof document === 'undefined')
420
+ return false;
421
+ const progress = getProgress(id);
422
+ if (progress?.version === (tour.version ?? 1)
423
+ && (progress.status !== 'deferred' || Date.now() - progress.updatedAt < 86400000)) {
424
+ return false;
425
+ }
426
+ offeredId = id;
427
+ return true;
428
+ },
429
+ defer() {
430
+ const tour = offeredId ? tourFor(offeredId) : undefined;
431
+ if (tour)
432
+ mark(tour, 'deferred');
433
+ offeredId = null;
434
+ },
435
+ dismiss() {
436
+ const tour = offeredId ? tourFor(offeredId) : undefined;
437
+ if (tour)
438
+ mark(tour, 'dismissed');
439
+ offeredId = null;
440
+ },
441
+ stop,
442
+ reset(id) { storage.set(progressKey(id), null); },
443
+ getProgress,
444
+ openHelp(id) {
445
+ stop();
446
+ offeredId = null;
447
+ error = '';
448
+ articleId = id ?? null;
449
+ helpOpen = true;
450
+ },
451
+ closeHelp() { helpOpen = false; },
452
+ clearError() { error = ''; },
453
+ setLocale(value) {
454
+ locale = value;
455
+ const tour = activeTourId ? tourFor(activeTourId) : undefined;
456
+ if (driver && tour) {
457
+ try {
458
+ driver.setConfig({ ...driver.getConfig(), ...translatedConfig(tour) });
459
+ driver.drive(driver.getActiveIndex() ?? 0);
460
+ }
461
+ catch {
462
+ error = 'guide_startFailed';
463
+ stop();
464
+ }
465
+ }
466
+ },
467
+ setScope(value) {
468
+ if (scope !== value) {
469
+ // 首次装配 scope 时保留上一页面的待启动记录,账号切换才取消当前交互。
470
+ if (activeTourId || offeredId || helpOpen) {
471
+ navigating = false;
472
+ stop();
473
+ }
474
+ scope = value;
475
+ offeredId = null;
476
+ helpOpen = false;
477
+ error = '';
478
+ }
479
+ },
480
+ handleNavigation(pathname) {
481
+ if (!navigating && activeTourId && expectedPath && pathname !== expectedPath)
482
+ stop();
483
+ },
484
+ async resume() {
485
+ try {
486
+ const raw = sessionStorage.getItem(pendingKey);
487
+ if (!raw)
488
+ return false;
489
+ clearPending();
490
+ const pending = JSON.parse(raw);
491
+ if (pending && typeof pending === 'object'
492
+ && 'id' in pending && typeof pending.id === 'string'
493
+ && 'scope' in pending && pending.scope === scope
494
+ && 'route' in pending && pending.route === nav.pathname
495
+ && 'createdAt' in pending && typeof pending.createdAt === 'number'
496
+ && Date.now() - pending.createdAt < 300000) {
497
+ return await start(pending.id);
498
+ }
499
+ }
500
+ catch {
501
+ // 过期或损坏的导航记录不阻止页面使用。
502
+ }
503
+ return false;
504
+ },
505
+ };
506
+ }
@@ -5,20 +5,74 @@
5
5
  * @module i18n.svelte
6
6
  */
7
7
  import type { Locale, LocaleInfo } from '@h-ai/core';
8
- declare const DEFAULT_LOCALE: string, DEFAULT_LOCALES: LocaleInfo[], setGlobalLocale: (locale: Locale) => void;
8
+ import { changeUILocale as setGlobalLocale } from './internal/locale.js';
9
+ export { authErrorMessage } from './components/scenes/iam/auth-error-message.js';
10
+ declare const DEFAULT_LOCALE: string, DEFAULT_LOCALES: LocaleInfo[];
11
+ /**
12
+ * 检查语言是否匹配应用支持列表,允许区域回退,不把默认值计作命中。
13
+ * @param locale - 显式语言代码;省略时使用当前上下文。
14
+ * @param supportedLocales - 应用支持的语言列表。
15
+ * @returns 是否存在真实支持项。
16
+ * @example
17
+ * ```ts
18
+ * import { isLocaleSupported } from '@h-ai/ui/i18n'
19
+ * const supported = isLocaleSupported('en-GB')
20
+ * ```
21
+ */
9
22
  declare function isLocaleSupported(locale: Locale, supportedLocales?: LocaleInfo[]): boolean;
23
+ /**
24
+ * 将候选语言归一化为支持列表中的实际代码,无命中时使用默认值。
25
+ * @param locale - 显式语言代码;省略时使用当前上下文。
26
+ * @param supportedLocales - 应用支持的语言列表。
27
+ * @param defaultLocale - 无候选命中时的默认语言。
28
+ * @returns 归一化后的文本。
29
+ * @example
30
+ * ```ts
31
+ * import { resolveLocale } from '@h-ai/ui/i18n'
32
+ * const locale = resolveLocale('unsupported', undefined, 'zh-CN')
33
+ * ```
34
+ */
10
35
  declare function resolveLocale(locale: Locale, supportedLocales?: LocaleInfo[], defaultLocale?: Locale): Locale;
36
+ /**
37
+ * 依浏览器语言顺序选择实际支持项;SSR 或无匹配项返回 null。
38
+ * @param supportedLocales - 应用支持的语言列表。
39
+ * @returns 规范的语言代码或 null。
40
+ * @example
41
+ * ```ts
42
+ * import { detectBrowserLocale } from '@h-ai/ui/i18n'
43
+ * const locale = detectBrowserLocale()
44
+ * ```
45
+ */
11
46
  declare function detectBrowserLocale(supportedLocales?: LocaleInfo[]): Locale | null;
47
+ /**
48
+ * 替换消息模板中的命名参数;缺少的参数保留原占位符。
49
+ * @param template - 包含命名占位符的消息模板。
50
+ * @param params - 消息插值参数。
51
+ * @returns 归一化后的文本。
52
+ * @example
53
+ * ```ts
54
+ * import { interpolate } from '@h-ai/ui/i18n'
55
+ * const message = interpolate('你好,{name}', { name: 'Ada' })
56
+ * ```
57
+ */
12
58
  declare function interpolate(template: string, params?: Record<string, string | number | boolean>): string;
13
59
  /**
14
60
  * 创建 locale 状态管理器
15
61
  *
16
62
  * @param options - 配置选项
17
- * @param options.defaultLocale - 默认 locale
63
+ * @param options.defaultLocale - 全部候选不支持后的默认 locale;不在列表时使用首个支持项。
18
64
  * @param options.supportedLocales - 支持的 locale 列表
19
- * @param options.detectBrowser - 是否检测浏览器语言
65
+ * @param options.detectBrowser - 是否按完整 navigator.languages 顺序匹配;全部失败才回退默认值。
20
66
  * @param options.persistKey - localStorage key
21
67
  * @returns locale 状态对象
68
+ *
69
+ * @example
70
+ * ```ts
71
+ * import { createLocaleStore } from '@h-ai/ui'
72
+ * const locale = createLocaleStore({ defaultLocale: 'zh-CN', detectBrowser: false, persistKey: 'demo-locale' })
73
+ * locale.set('en-US')
74
+ * const selected = locale.current
75
+ * ```
22
76
  */
23
77
  export declare function createLocaleStore(options?: {
24
78
  defaultLocale?: Locale;
@@ -32,7 +86,7 @@ export declare function createLocaleStore(options?: {
32
86
  readonly supported: LocaleInfo[];
33
87
  /**
34
88
  * 设置当前语言
35
- * 会同步到 @h-ai/core 的全局 locale 管理器
89
+ * 浏览器同步到 @h-ai/core;SSR 仅改变当前 store,消息语言由 runWithLocale 绑定。
36
90
  * 注意:你还需要调用 Paraglide 的 setLocale 来更新 UI 翻译
37
91
  */
38
92
  set(locale: Locale): void;
@@ -41,4 +95,13 @@ export declare function createLocaleStore(options?: {
41
95
  };
42
96
  export type { InterpolationParams, Locale, LocaleInfo } from '@h-ai/core';
43
97
  export { DEFAULT_LOCALE, DEFAULT_LOCALES, detectBrowserLocale, interpolate, isLocaleSupported, resolveLocale, setGlobalLocale, };
98
+ /**
99
+ * 读取 core 当前请求或浏览器上下文的语言,不由 UI store 隐式改写服务端默认值。
100
+ *
101
+ * @example
102
+ * ```ts
103
+ * import { getGlobalLocale } from '@h-ai/ui'
104
+ * const currentLocale = getGlobalLocale()
105
+ * ```
106
+ */
44
107
  export declare const getGlobalLocale: () => Locale;