@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,135 @@
1
+ <!--
2
+ @component ErrorPage
3
+ 通用错误页场景组件
4
+
5
+ 展示大号状态码 + 标题 + 描述 + 操作按钮,内置 401/403/404/500/503 预设。
6
+ 借鉴 shadcn-admin 错误页布局,复用现有主题 token。
7
+
8
+ 使用 Svelte 5 Runes ($props, $derived)
9
+
10
+ @example
11
+ ```ts
12
+ import { mount, unmount } from 'svelte'
13
+ import type { ComponentProps } from 'svelte'
14
+ import { ErrorPage } from '@h-ai/ui'
15
+ const props: ComponentProps<typeof ErrorPage> = { status: 403, homeUrl: '/' }
16
+ const component = mount(ErrorPage, { target: document.body, props })
17
+ await unmount(component)
18
+ ```
19
+ -->
20
+ <script lang='ts'>
21
+ import type { Snippet } from 'svelte'
22
+ import type { DataAttributes } from '../../../types.js'
23
+ import type { ErrorPreset } from './error-presets.js'
24
+ import { uiM } from '../../../messages.js'
25
+ import { cn, getDataAttributes } from '../../../utils.js'
26
+ import Button from '../../primitives/Button.svelte'
27
+ import { ERROR_PRESETS, resolveErrorPreset } from './error-presets.js'
28
+
29
+ const {
30
+ status = 404,
31
+ code,
32
+ title,
33
+ description,
34
+ showHome = true,
35
+ showBack = true,
36
+ homeUrl = '/',
37
+ onhome,
38
+ onback,
39
+ icon,
40
+ actions,
41
+ class: className = '',
42
+ ...restProps
43
+ }: {
44
+ /** HTTP 状态码或预设标识;未命中预设时回退到最接近的预设 */
45
+ status?: number | string | ErrorPreset
46
+ /** 自定义大号展示码(覆盖预设) */
47
+ code?: string
48
+ /** 自定义标题(覆盖预设文案) */
49
+ title?: string
50
+ /** 自定义描述(覆盖预设文案) */
51
+ description?: string
52
+ /** 是否显示「返回首页」按钮 */
53
+ showHome?: boolean
54
+ /** 是否显示「返回上一页」按钮 */
55
+ showBack?: boolean
56
+ /** 首页地址(未提供 onhome 时作为链接跳转) */
57
+ homeUrl?: string
58
+ /** 自定义「返回首页」处理(优先于 homeUrl 链接) */
59
+ onhome?: () => void
60
+ /** 自定义「返回上一页」处理(默认 history.back()) */
61
+ onback?: () => void
62
+ /** 自定义图标插槽 */
63
+ icon?: Snippet
64
+ /** 自定义操作区插槽(提供时覆盖默认按钮) */
65
+ actions?: Snippet
66
+ class?: string
67
+ } & DataAttributes = $props()
68
+
69
+ const dataAttributes = $derived(getDataAttributes(restProps))
70
+ const preset = $derived(ERROR_PRESETS[resolveErrorPreset(status)])
71
+ const displayCode = $derived(code ?? preset.code)
72
+ const displayTitle = $derived(title ?? uiM(preset.titleKey))
73
+ const displayDesc = $derived(description ?? uiM(preset.descKey))
74
+
75
+ function handleBack() {
76
+ if (onback) {
77
+ onback()
78
+ return
79
+ }
80
+ if (typeof history !== 'undefined') {
81
+ history.back()
82
+ }
83
+ }
84
+
85
+ function handleHome() {
86
+ onhome?.()
87
+ }
88
+ </script>
89
+
90
+ <div {...dataAttributes} class={cn('flex min-h-[60vh] w-full flex-col items-center justify-center px-6 py-12 text-center', className)}>
91
+ <!-- 图标 -->
92
+ <div class='mb-6 flex size-16 items-center justify-center rounded-2xl bg-base-content/5 text-base-content/40'>
93
+ {#if icon}
94
+ {@render icon()}
95
+ {:else}
96
+ <span class='{preset.icon} size-8'></span>
97
+ {/if}
98
+ </div>
99
+
100
+ <!-- 大号状态码 -->
101
+ <p class='text-6xl font-bold tracking-tight text-base-content/85 sm:text-7xl'>{displayCode}</p>
102
+
103
+ <!-- 标题 -->
104
+ <h1 class='mt-4 text-xl font-semibold text-base-content sm:text-2xl'>{displayTitle}</h1>
105
+
106
+ <!-- 描述 -->
107
+ <p class='mt-2 max-w-md text-sm text-base-content/55'>{displayDesc}</p>
108
+
109
+ <!-- 操作区 -->
110
+ <div class='mt-8 flex flex-wrap items-center justify-center gap-3'>
111
+ {#if actions}
112
+ {@render actions()}
113
+ {:else}
114
+ {#if showBack}
115
+ <Button variant='outline' size='sm' onclick={handleBack}>
116
+ <span class='icon-[tabler--arrow-left] mr-1.5 size-4'></span>
117
+ {uiM('error_go_back')}
118
+ </Button>
119
+ {/if}
120
+ {#if showHome}
121
+ {#if onhome}
122
+ <Button variant='primary' size='sm' onclick={handleHome}>
123
+ <span class='icon-[tabler--home] mr-1.5 size-4'></span>
124
+ {uiM('error_back_home')}
125
+ </Button>
126
+ {:else}
127
+ <a href={homeUrl} class='btn btn-primary btn-sm'>
128
+ <span class='icon-[tabler--home] mr-1.5 size-4'></span>
129
+ {uiM('error_back_home')}
130
+ </a>
131
+ {/if}
132
+ {/if}
133
+ {/if}
134
+ </div>
135
+ </div>
@@ -0,0 +1,50 @@
1
+ import type { Snippet } from 'svelte';
2
+ import type { DataAttributes } from '../../../types.js';
3
+ import type { ErrorPreset } from './error-presets.js';
4
+ type $$ComponentProps = {
5
+ /** HTTP 状态码或预设标识;未命中预设时回退到最接近的预设 */
6
+ status?: number | string | ErrorPreset;
7
+ /** 自定义大号展示码(覆盖预设) */
8
+ code?: string;
9
+ /** 自定义标题(覆盖预设文案) */
10
+ title?: string;
11
+ /** 自定义描述(覆盖预设文案) */
12
+ description?: string;
13
+ /** 是否显示「返回首页」按钮 */
14
+ showHome?: boolean;
15
+ /** 是否显示「返回上一页」按钮 */
16
+ showBack?: boolean;
17
+ /** 首页地址(未提供 onhome 时作为链接跳转) */
18
+ homeUrl?: string;
19
+ /** 自定义「返回首页」处理(优先于 homeUrl 链接) */
20
+ onhome?: () => void;
21
+ /** 自定义「返回上一页」处理(默认 history.back()) */
22
+ onback?: () => void;
23
+ /** 自定义图标插槽 */
24
+ icon?: Snippet;
25
+ /** 自定义操作区插槽(提供时覆盖默认按钮) */
26
+ actions?: Snippet;
27
+ class?: string;
28
+ } & DataAttributes;
29
+ /**
30
+ * ErrorPage
31
+ * 通用错误页场景组件
32
+ *
33
+ * 展示大号状态码 + 标题 + 描述 + 操作按钮,内置 401/403/404/500/503 预设。
34
+ * 借鉴 shadcn-admin 错误页布局,复用现有主题 token。
35
+ *
36
+ * 使用 Svelte 5 Runes ($props, $derived)
37
+ *
38
+ * @example
39
+ * ```ts
40
+ * import { mount, unmount } from 'svelte'
41
+ * import type { ComponentProps } from 'svelte'
42
+ * import { ErrorPage } from '@h-ai/ui'
43
+ * const props: ComponentProps<typeof ErrorPage> = { status: 403, homeUrl: '/' }
44
+ * const component = mount(ErrorPage, { target: document.body, props })
45
+ * await unmount(component)
46
+ * ```
47
+ */
48
+ declare const ErrorPage: import("svelte").Component<$$ComponentProps, {}, "">;
49
+ type ErrorPage = ReturnType<typeof ErrorPage>;
50
+ export default ErrorPage;
@@ -0,0 +1,60 @@
1
+ /**
2
+ * @h-ai/ui — 错误页预设
3
+ *
4
+ * 为 ErrorPage 提供常见 HTTP 错误的内置文案 key 与图标。
5
+ * @module error-presets
6
+ */
7
+ import type { UIMessageKey } from '../../../messages.js';
8
+ /**
9
+ * 内置错误预设标识
10
+ *
11
+ * @example
12
+ * ```ts
13
+ * import type { ErrorPreset } from '@h-ai/ui'
14
+ * const example: ErrorPreset = '404'
15
+ * ```
16
+ */
17
+ export type ErrorPreset = '401' | '403' | '404' | '500' | '503';
18
+ /**
19
+ * 单个错误预设的展示信息
20
+ *
21
+ * @example
22
+ * ```ts
23
+ * import type { ErrorPresetInfo } from '@h-ai/ui'
24
+ * const example: ErrorPresetInfo = { code: '404', titleKey: 'error_404_title', descKey: 'error_404_desc', icon: 'icon-[tabler--map-search]' }
25
+ * ```
26
+ */
27
+ export interface ErrorPresetInfo {
28
+ /** HTTP 状态码(用于大号展示) */
29
+ code: string;
30
+ /** 标题文案 key */
31
+ titleKey: UIMessageKey;
32
+ /** 描述文案 key */
33
+ descKey: UIMessageKey;
34
+ /** Tabler 图标类名 */
35
+ icon: string;
36
+ }
37
+ /**
38
+ * 错误预设映射表
39
+ *
40
+ * @example
41
+ * ```ts
42
+ * import { ERROR_PRESETS } from '@h-ai/ui'
43
+ * const missing = ERROR_PRESETS['404']
44
+ * const titleKey = missing.titleKey
45
+ * ```
46
+ */
47
+ export declare const ERROR_PRESETS: Record<ErrorPreset, ErrorPresetInfo>;
48
+ /**
49
+ * 根据 HTTP 状态码解析到最接近的预设
50
+ * @param status - HTTP 状态码或文本形式。
51
+ * @returns 最接近输入状态的内置错误页标识。
52
+ *
53
+ * @example
54
+ * ```ts
55
+ * import { resolveErrorPreset } from '@h-ai/ui'
56
+ * const unavailable = resolveErrorPreset(503)
57
+ * const fallback = resolveErrorPreset(418)
58
+ * ```
59
+ */
60
+ export declare function resolveErrorPreset(status: number | string | undefined): ErrorPreset;
@@ -0,0 +1,51 @@
1
+ /**
2
+ * @h-ai/ui — 错误页预设
3
+ *
4
+ * 为 ErrorPage 提供常见 HTTP 错误的内置文案 key 与图标。
5
+ * @module error-presets
6
+ */
7
+ /**
8
+ * 错误预设映射表
9
+ *
10
+ * @example
11
+ * ```ts
12
+ * import { ERROR_PRESETS } from '@h-ai/ui'
13
+ * const missing = ERROR_PRESETS['404']
14
+ * const titleKey = missing.titleKey
15
+ * ```
16
+ */
17
+ export const ERROR_PRESETS = {
18
+ 401: { code: '401', titleKey: 'error_401_title', descKey: 'error_401_desc', icon: 'icon-[tabler--lock]' },
19
+ 403: { code: '403', titleKey: 'error_403_title', descKey: 'error_403_desc', icon: 'icon-[tabler--shield-lock]' },
20
+ 404: { code: '404', titleKey: 'error_404_title', descKey: 'error_404_desc', icon: 'icon-[tabler--map-search]' },
21
+ 500: { code: '500', titleKey: 'error_500_title', descKey: 'error_500_desc', icon: 'icon-[tabler--server-off]' },
22
+ 503: { code: '503', titleKey: 'error_503_title', descKey: 'error_503_desc', icon: 'icon-[tabler--tool]' },
23
+ };
24
+ /**
25
+ * 根据 HTTP 状态码解析到最接近的预设
26
+ * @param status - HTTP 状态码或文本形式。
27
+ * @returns 最接近输入状态的内置错误页标识。
28
+ *
29
+ * @example
30
+ * ```ts
31
+ * import { resolveErrorPreset } from '@h-ai/ui'
32
+ * const unavailable = resolveErrorPreset(503)
33
+ * const fallback = resolveErrorPreset(418)
34
+ * ```
35
+ */
36
+ export function resolveErrorPreset(status) {
37
+ const code = String(status ?? '');
38
+ if (code in ERROR_PRESETS) {
39
+ return code;
40
+ }
41
+ const num = Number(code);
42
+ if (num === 401)
43
+ return '401';
44
+ if (num === 403)
45
+ return '403';
46
+ if (num === 503)
47
+ return '503';
48
+ if (num >= 500)
49
+ return '500';
50
+ return '404';
51
+ }
@@ -0,0 +1,8 @@
1
+ /**
2
+ * @h-ai/ui — 错误页场景组件 (Error Scenes)
3
+ *
4
+ * 通用错误页展示,内置常见 HTTP 错误预设。
5
+ * @module index
6
+ */
7
+ export * from './error-presets.js';
8
+ export { default as ErrorPage } from './ErrorPage.svelte';
@@ -0,0 +1,8 @@
1
+ /**
2
+ * @h-ai/ui — 错误页场景组件 (Error Scenes)
3
+ *
4
+ * 通用错误页展示,内置常见 HTTP 错误预设。
5
+ * @module index
6
+ */
7
+ export * from './error-presets.js';
8
+ export { default as ErrorPage } from './ErrorPage.svelte';
@@ -0,0 +1,56 @@
1
+ <!--
2
+ @component GuideHost
3
+ GuideHost 组件的公开使用示例。
4
+
5
+ @example
6
+ ```ts
7
+ import { mount, unmount } from 'svelte'
8
+ import { GuideHost, createGuide } from '@h-ai/ui'
9
+ const guide = createGuide({ tours: [], persistence: 'memory' })
10
+ const host = mount(GuideHost, { target: document.body, props: { guide, locale: 'zh-CN', scope: 'demo' } })
11
+ await unmount(host)
12
+ guide.stop()
13
+ ```
14
+ -->
15
+ <script lang='ts'>
16
+ import type { GuideController } from '../../../guide-types.js'
17
+ import type { DataAttributes } from '../../../types.js'
18
+ import { getUILocale, uiM } from '../../../messages.js'
19
+ import { toast } from '../../../toast.svelte.js'
20
+ import Button from '../../primitives/Button.svelte'
21
+ import GuideHostContent from './GuideHostContent.svelte'
22
+
23
+ /** GuideHost 组件的属性契约。
24
+ * @example
25
+ * ```ts
26
+ * import type { ComponentProps } from 'svelte'
27
+ * import { GuideHost } from '@h-ai/ui'
28
+ * const props: Partial<ComponentProps<typeof GuideHost>> = {}
29
+ * void props
30
+ * ```
31
+ */
32
+ interface Props {
33
+ guide: GuideController
34
+ locale?: string
35
+ scope?: string
36
+ autoStart?: string
37
+ }
38
+ const { guide, locale = getUILocale(), ...rest }: Props & DataAttributes = $props()
39
+ function release() {
40
+ guide.stop()
41
+ guide.closeHelp()
42
+ toast.warning(uiM('guide_startFailed', undefined, locale))
43
+ }
44
+ </script>
45
+
46
+ <svelte:boundary onerror={release}>
47
+ <GuideHostContent {guide} {locale} {...rest} />
48
+ {#snippet failed(_error, reset)}
49
+ <div class='fixed bottom-4 right-4 z-[1150] max-w-[calc(100vw-2rem)]' data-testid='guide-error'>
50
+ <Button variant='ghost' size='sm' onclick={() => {
51
+ guide.defer()
52
+ reset()
53
+ }}>{uiM('guide_close', undefined, locale)}</Button>
54
+ </div>
55
+ {/snippet}
56
+ </svelte:boundary>
@@ -0,0 +1,35 @@
1
+ import type { GuideController } from '../../../guide-types.js';
2
+ import type { DataAttributes } from '../../../types.js';
3
+ /** GuideHost 组件的属性契约。
4
+ * @example
5
+ * ```ts
6
+ * import type { ComponentProps } from 'svelte'
7
+ * import { GuideHost } from '@h-ai/ui'
8
+ * const props: Partial<ComponentProps<typeof GuideHost>> = {}
9
+ * void props
10
+ * ```
11
+ */
12
+ interface Props {
13
+ guide: GuideController;
14
+ locale?: string;
15
+ scope?: string;
16
+ autoStart?: string;
17
+ }
18
+ type $$ComponentProps = Props & DataAttributes;
19
+ /**
20
+ * GuideHost
21
+ * GuideHost 组件的公开使用示例。
22
+ *
23
+ * @example
24
+ * ```ts
25
+ * import { mount, unmount } from 'svelte'
26
+ * import { GuideHost, createGuide } from '@h-ai/ui'
27
+ * const guide = createGuide({ tours: [], persistence: 'memory' })
28
+ * const host = mount(GuideHost, { target: document.body, props: { guide, locale: 'zh-CN', scope: 'demo' } })
29
+ * await unmount(host)
30
+ * guide.stop()
31
+ * ```
32
+ */
33
+ declare const GuideHost: import("svelte").Component<$$ComponentProps, {}, "">;
34
+ type GuideHost = ReturnType<typeof GuideHost>;
35
+ export default GuideHost;
@@ -0,0 +1,136 @@
1
+ <!--
2
+ @component GuideHost
3
+ GuideHost 组件的公开使用示例。
4
+
5
+ @example
6
+ ```ts
7
+ import { mount, unmount } from 'svelte'
8
+ import { GuideHost, createGuide } from '@h-ai/ui'
9
+ const guide = createGuide({ tours: [], persistence: 'memory' })
10
+ const host = mount(GuideHost, { target: document.body, props: { guide, locale: 'zh-CN', scope: 'demo' } })
11
+ await unmount(host)
12
+ guide.stop()
13
+ ```
14
+ -->
15
+ <script lang='ts'>
16
+ import type { GuideController } from '../../../guide-types.js'
17
+ import type { DataAttributes } from '../../../types.js'
18
+ import { onMount, untrack } from 'svelte'
19
+ import { resolveGuideText } from '../../../guide.svelte.js'
20
+ import { getUILocale, uiM } from '../../../messages.js'
21
+ import { useToastFeedback } from '../../../toast.svelte.js'
22
+ import { getDataAttributes } from '../../../utils.js'
23
+ import Modal from '../../compounds/Modal.svelte'
24
+ import Button from '../../primitives/Button.svelte'
25
+ import HelpCenter from './HelpCenter.svelte'
26
+ import 'driver.js/dist/driver.css'
27
+ import '../../../styles/guide.css'
28
+
29
+ /**
30
+ * 导览宿主属性;绑定应用语言、非敏感身份范围和控制器。
31
+ *
32
+ * @example
33
+ * ```ts
34
+ * import { mount, unmount } from 'svelte'
35
+ * import { GuideHost, createGuide } from '@h-ai/ui'
36
+ * const guide = createGuide({ tours: [], persistence: 'memory' })
37
+ * const host = mount(GuideHost, { target: document.body, props: { guide, locale: 'zh-CN', scope: 'demo' } })
38
+ * await unmount(host)
39
+ * guide.stop()
40
+ * ```
41
+ */
42
+ interface Props {
43
+ guide: GuideController
44
+ locale?: string
45
+ /** 非敏感的用户标识,账号切换后独立记录引导偏好。 */
46
+ scope?: string
47
+ /** 挂载后提示首次使用者,不会直接打断操作或自动跳转。 */
48
+ autoStart?: string
49
+ }
50
+
51
+ const { guide, locale = getUILocale(), scope = 'anonymous', autoStart, ...restProps }: Props & DataAttributes = $props()
52
+ const dataAttributes = $derived(getDataAttributes(restProps))
53
+ let ready = $state(false)
54
+ const offered = $derived.by(() => {
55
+ void locale
56
+ const tour = guide.offeredTour
57
+ return tour ? { id: tour.id, title: resolveGuideText(tour.title), description: resolveGuideText(tour.description) } : null
58
+ })
59
+ const text = $derived.by(() => ({
60
+ welcome: uiM('guide_welcome', undefined, locale),
61
+ start: uiM('guide_start', undefined, locale),
62
+ later: uiM('guide_later', undefined, locale),
63
+ dismiss: uiM('guide_dismiss', undefined, locale),
64
+ help: uiM('guide_help', undefined, locale),
65
+ close: uiM('guide_close', undefined, locale),
66
+ loading: uiM('guide_loading', undefined, locale),
67
+ }))
68
+
69
+ $effect(() => {
70
+ const currentLocale = locale
71
+ untrack(() => guide.setLocale(currentLocale))
72
+ })
73
+ $effect(() => {
74
+ const currentScope = scope
75
+ const tourId = autoStart
76
+ if (ready) {
77
+ untrack(() => {
78
+ guide.setScope(currentScope)
79
+ if (tourId)
80
+ guide.startIfNeeded(tourId)
81
+ })
82
+ }
83
+ })
84
+ $effect(() => {
85
+ const pathname = guide.pathname
86
+ untrack(() => guide.handleNavigation(pathname))
87
+ })
88
+ onMount(() => {
89
+ let alive = true
90
+ guide.setScope(scope)
91
+ guide.setLocale(locale)
92
+ void guide.resume().then(() => {
93
+ if (alive)
94
+ ready = true
95
+ }).catch(() => {
96
+ if (alive) {
97
+ guide.stop()
98
+ guide.closeHelp()
99
+ }
100
+ })
101
+ return () => {
102
+ alive = false
103
+ guide.stop()
104
+ }
105
+ })
106
+ useToastFeedback(() => guide.error, 'warning')
107
+ </script>
108
+
109
+ <div {...dataAttributes} class='contents'>
110
+
111
+ {#if offered}
112
+ <aside class='hai-guide-offer fixed bottom-4 right-4 z-[1150] w-96 max-w-[calc(100vw-2rem)] rounded-2xl border border-base-content/10 bg-base-100 p-5 text-base-content shadow-(--shadow-overlay)' aria-label={text.welcome} data-testid='guide-offer'>
113
+ <p class='text-xs font-medium text-primary'>{text.welcome}</p>
114
+ <h2 class='mt-2 text-base font-semibold'>{offered.title}</h2>
115
+ <p class='mt-2 text-sm leading-6 text-base-content/65'>{offered.description}</p>
116
+ <div class='mt-4 flex flex-wrap gap-2'>
117
+ <Button variant='primary' size='sm' onclick={() => offered && void guide.start(offered.id)} data-testid='guide-start'>{text.start}</Button>
118
+ <Button variant='ghost' size='sm' onclick={() => guide.defer()} data-testid='guide-later'>{text.later}</Button>
119
+ <Button variant='ghost' size='sm' onclick={() => guide.dismiss()} data-testid='guide-dismiss'>{text.dismiss}</Button>
120
+ </div>
121
+ </aside>
122
+ {/if}
123
+
124
+ {#if guide.busy}
125
+ <div class='hai-guide-loading fixed bottom-4 left-1/2 z-[1000000001] flex max-w-[calc(100vw-2rem)] -translate-x-1/2 items-center gap-3 rounded-xl border border-base-content/10 bg-base-100 px-4 py-2 text-sm text-base-content shadow-lg' role='status' data-testid='guide-loading'>
126
+ <span class='loading loading-spinner loading-xs'></span>{text.loading}
127
+ <Button size='sm' variant='ghost' onclick={() => guide.stop()} data-testid='guide-cancel'>{text.close}</Button>
128
+ </div>
129
+ {/if}
130
+
131
+ {#if guide.helpOpen}
132
+ <Modal open title={text.help} size='4xl' height='min(80dvh, 48rem)' bodyClass='p-0' onclose={() => guide.closeHelp()} data-testid='guide-help'>
133
+ <HelpCenter articles={guide.articles} tours={guide.tours} selectedId={guide.articleId} {locale} onstart={id => void guide.start(id)} />
134
+ </Modal>
135
+ {/if}
136
+ </div>
@@ -0,0 +1,43 @@
1
+ import type { GuideController } from '../../../guide-types.js';
2
+ import type { DataAttributes } from '../../../types.js';
3
+ import 'driver.js/dist/driver.css';
4
+ import '../../../styles/guide.css';
5
+ /**
6
+ * 导览宿主属性;绑定应用语言、非敏感身份范围和控制器。
7
+ *
8
+ * @example
9
+ * ```ts
10
+ * import { mount, unmount } from 'svelte'
11
+ * import { GuideHost, createGuide } from '@h-ai/ui'
12
+ * const guide = createGuide({ tours: [], persistence: 'memory' })
13
+ * const host = mount(GuideHost, { target: document.body, props: { guide, locale: 'zh-CN', scope: 'demo' } })
14
+ * await unmount(host)
15
+ * guide.stop()
16
+ * ```
17
+ */
18
+ interface Props {
19
+ guide: GuideController;
20
+ locale?: string;
21
+ /** 非敏感的用户标识,账号切换后独立记录引导偏好。 */
22
+ scope?: string;
23
+ /** 挂载后提示首次使用者,不会直接打断操作或自动跳转。 */
24
+ autoStart?: string;
25
+ }
26
+ type $$ComponentProps = Props & DataAttributes;
27
+ /**
28
+ * GuideHost
29
+ * GuideHost 组件的公开使用示例。
30
+ *
31
+ * @example
32
+ * ```ts
33
+ * import { mount, unmount } from 'svelte'
34
+ * import { GuideHost, createGuide } from '@h-ai/ui'
35
+ * const guide = createGuide({ tours: [], persistence: 'memory' })
36
+ * const host = mount(GuideHost, { target: document.body, props: { guide, locale: 'zh-CN', scope: 'demo' } })
37
+ * await unmount(host)
38
+ * guide.stop()
39
+ * ```
40
+ */
41
+ declare const GuideHostContent: import("svelte").Component<$$ComponentProps, {}, "">;
42
+ type GuideHostContent = ReturnType<typeof GuideHostContent>;
43
+ export default GuideHostContent;