@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,7 +4,15 @@
4
4
  * 提供运行时平台检测与 Svelte 5 响应式平台状态。
5
5
  * @module platform
6
6
  */
7
- /** 运行平台 */
7
+ /**
8
+ * 运行平台
9
+ *
10
+ * @example
11
+ * ```ts
12
+ * import type { Platform } from '@h-ai/ui'
13
+ * const example: Platform = 'web'
14
+ * ```
15
+ */
8
16
  export type Platform = 'web' | 'h5' | 'android' | 'ios' | 'unknown';
9
17
  /**
10
18
  * 检测当前运行平台
@@ -13,19 +21,31 @@ export type Platform = 'web' | 'h5' | 'android' | 'ios' | 'unknown';
13
21
  *
14
22
  * @example
15
23
  * ```ts
24
+ * import { detectPlatform } from '@h-ai/ui'
16
25
  * const platform = detectPlatform()
17
- * if (platform === 'android') {
18
- * // Android 特定逻辑
19
- * }
20
26
  * ```
21
27
  */
22
28
  export declare function detectPlatform(): Platform;
23
29
  /**
24
30
  * 判断是否为移动端
31
+ * @returns 当前是否为 H5 或 Android/iOS 原生壳。
32
+ *
33
+ * @example
34
+ * ```ts
35
+ * import { isMobile } from '@h-ai/ui'
36
+ * const compactLayout = isMobile()
37
+ * ```
25
38
  */
26
39
  export declare function isMobile(): boolean;
27
40
  /**
28
41
  * 判断是否为 Capacitor App
42
+ * @returns 是否为 Capacitor Android/iOS 原生壳。
43
+ *
44
+ * @example
45
+ * ```ts
46
+ * import { isNativeApp } from '@h-ai/ui'
47
+ * const useNativeBridge = isNativeApp()
48
+ * ```
29
49
  */
30
50
  export declare function isNativeApp(): boolean;
31
51
  /**
@@ -34,17 +54,10 @@ export declare function isNativeApp(): boolean;
34
54
  * @returns 包含当前平台、是否移动端和是否原生应用的响应式对象
35
55
  *
36
56
  * @example
37
- * ```svelte
38
- * <script>
39
- * import { usePlatform } from '@hai/ui'
40
- * const platform = usePlatform()
41
- * </script>
42
- *
43
- * {#if platform.isMobile}
44
- * <BottomNav />
45
- * {:else}
46
- * <Sidebar />
47
- * {/if}
57
+ * ```ts
58
+ * import { usePlatform } from '@h-ai/ui'
59
+ * const platform = usePlatform()
60
+ * const device = platform.current
48
61
  * ```
49
62
  */
50
63
  export declare function usePlatform(): {
@@ -4,6 +4,8 @@
4
4
  * 提供运行时平台检测与 Svelte 5 响应式平台状态。
5
5
  * @module platform
6
6
  */
7
+ const ANDROID_UA_REGEX = /android/;
8
+ const IOS_UA_REGEX = /iphone|ipad|ipod/;
7
9
  /**
8
10
  * 检测当前运行平台
9
11
  *
@@ -11,10 +13,8 @@
11
13
  *
12
14
  * @example
13
15
  * ```ts
16
+ * import { detectPlatform } from '@h-ai/ui'
14
17
  * const platform = detectPlatform()
15
- * if (platform === 'android') {
16
- * // Android 特定逻辑
17
- * }
18
18
  * ```
19
19
  */
20
20
  export function detectPlatform() {
@@ -32,9 +32,9 @@ export function detectPlatform() {
32
32
  return 'ios';
33
33
  }
34
34
  // 移动端 UA 检测
35
- if (/android/.test(ua))
35
+ if (ANDROID_UA_REGEX.test(ua))
36
36
  return 'h5';
37
- if (/iphone|ipad|ipod/.test(ua))
37
+ if (IOS_UA_REGEX.test(ua))
38
38
  return 'h5';
39
39
  // 移动端特征检测
40
40
  if ('ontouchstart' in window && navigator.maxTouchPoints > 0 && window.innerWidth < 768) {
@@ -44,6 +44,13 @@ export function detectPlatform() {
44
44
  }
45
45
  /**
46
46
  * 判断是否为移动端
47
+ * @returns 当前是否为 H5 或 Android/iOS 原生壳。
48
+ *
49
+ * @example
50
+ * ```ts
51
+ * import { isMobile } from '@h-ai/ui'
52
+ * const compactLayout = isMobile()
53
+ * ```
47
54
  */
48
55
  export function isMobile() {
49
56
  const platform = detectPlatform();
@@ -51,6 +58,13 @@ export function isMobile() {
51
58
  }
52
59
  /**
53
60
  * 判断是否为 Capacitor App
61
+ * @returns 是否为 Capacitor Android/iOS 原生壳。
62
+ *
63
+ * @example
64
+ * ```ts
65
+ * import { isNativeApp } from '@h-ai/ui'
66
+ * const useNativeBridge = isNativeApp()
67
+ * ```
54
68
  */
55
69
  export function isNativeApp() {
56
70
  const platform = detectPlatform();
@@ -62,17 +76,10 @@ export function isNativeApp() {
62
76
  * @returns 包含当前平台、是否移动端和是否原生应用的响应式对象
63
77
  *
64
78
  * @example
65
- * ```svelte
66
- * <script>
67
- * import { usePlatform } from '@hai/ui'
68
- * const platform = usePlatform()
69
- * </script>
70
- *
71
- * {#if platform.isMobile}
72
- * <BottomNav />
73
- * {:else}
74
- * <Sidebar />
75
- * {/if}
79
+ * ```ts
80
+ * import { usePlatform } from '@h-ai/ui'
81
+ * const platform = usePlatform()
82
+ * const device = platform.current
76
83
  * ```
77
84
  */
78
85
  export function usePlatform() {
package/dist/utils.d.ts CHANGED
@@ -4,43 +4,163 @@
4
4
  * CSS 类名处理工具
5
5
  * @module utils
6
6
  */
7
- import type { Size, Variant } from './types.js';
7
+ import type { DataAttributes, Size, Variant } from './types.js';
8
8
  /**
9
9
  * 合并类名(支持 Tailwind 类冲突消解)
10
10
  *
11
11
  * @param classes - 类名列表
12
12
  * @returns 合并后的类名字符串
13
+ *
14
+ * @example
15
+ * ```ts
16
+ * import { cn } from '@h-ai/ui'
17
+ * const classes = cn('px-2', 'px-4', false, 'font-medium')
18
+ * // classes 为冲突合并后的类名,可直接用于元素 class。
19
+ * ```
13
20
  */
14
21
  export declare function cn(...classes: (string | boolean | undefined | null)[]): string;
22
+ /**
23
+ * 实际可转发的 data-* 原子值映射,不包含 null 或 undefined。
24
+ *
25
+ * @example
26
+ * ```ts
27
+ * import type { ForwardedDataAttributes } from '@h-ai/ui'
28
+ * const example: ForwardedDataAttributes = { 'data-testid': 'profile-save' }
29
+ * ```
30
+ */
31
+ export type ForwardedDataAttributes = Record<`data-${string}`, string | number | boolean>;
32
+ /**
33
+ * 从组件未声明 props 中提取 data-* 属性,避免把普通未知属性透传到 DOM。
34
+ * @param props - 组件的属性对象。
35
+ * @returns 只包含安全原子值的 data-* 属性对象。
36
+ *
37
+ * @example
38
+ * ```ts
39
+ * import { getDataAttributes } from '@h-ai/ui'
40
+ * const attributes = getDataAttributes({ 'data-testid': 'save', 'data-loading': false, onclick: 'ignored' })
41
+ * // 仅保留安全类型的 data-* 字段。
42
+ * ```
43
+ */
44
+ export declare function getDataAttributes(props: DataAttributes | Record<string, unknown>): ForwardedDataAttributes;
15
45
  /**
16
46
  * 获取变体类名
47
+ * @param variant - 语义变体。
48
+ * @param prefix - 类名前缀或界面 ID 前缀。
49
+ * @returns 对应前缀和变体的 DaisyUI 类名;未知前缀按约定拼接。
50
+ *
51
+ * @example
52
+ * ```ts
53
+ * import { getVariantClass } from '@h-ai/ui'
54
+ * const classes = getVariantClass('primary', 'btn')
55
+ * ```
17
56
  */
18
57
  export declare function getVariantClass(variant: Variant, prefix?: string): string;
19
58
  /**
20
59
  * 获取尺寸类名
60
+ * @param size - 组件尺寸预设。
61
+ * @param prefix - 类名前缀或界面 ID 前缀。
62
+ * @returns 对应尺寸的类名,中号尺寸使用空字符串。
63
+ *
64
+ * @example
65
+ * ```ts
66
+ * import { getSizeClass } from '@h-ai/ui'
67
+ * const classes = getSizeClass('lg', 'btn')
68
+ * ```
21
69
  */
22
70
  export declare function getSizeClass(size: Size, prefix?: string): string;
23
71
  /**
24
72
  * 输入框尺寸类名
73
+ * @param size - 组件尺寸预设。
74
+ * @returns 输入框尺寸类名;大于 xl 的预设统一使用 input-xl。
75
+ *
76
+ * @example
77
+ * ```ts
78
+ * import { getInputSizeClass } from '@h-ai/ui'
79
+ * const classes = getInputSizeClass('sm')
80
+ * ```
25
81
  */
26
82
  export declare function getInputSizeClass(size: Size): string;
27
83
  /**
28
84
  * 徽章变体类名
85
+ * @param variant - 语义变体。
86
+ * @returns 徽章语义变体类名。
87
+ *
88
+ * @example
89
+ * ```ts
90
+ * import { getBadgeVariantClass } from '@h-ai/ui'
91
+ * const classes = getBadgeVariantClass('success')
92
+ * ```
29
93
  */
30
94
  export declare function getBadgeVariantClass(variant: Variant): string;
31
95
  /**
32
96
  * 徽章尺寸类名
97
+ * @param size - 组件尺寸预设。
98
+ * @returns 徽章尺寸类名。
99
+ *
100
+ * @example
101
+ * ```ts
102
+ * import { getBadgeSizeClass } from '@h-ai/ui'
103
+ * const classes = getBadgeSizeClass('sm')
104
+ * ```
33
105
  */
34
106
  export declare function getBadgeSizeClass(size: Size): string;
35
107
  /**
36
108
  * 警告框变体类名
109
+ * @param variant - 语义变体。
110
+ * @returns 警告框语义变体类名。
111
+ *
112
+ * @example
113
+ * ```ts
114
+ * import { getAlertVariantClass } from '@h-ai/ui'
115
+ * const classes = getAlertVariantClass('warning')
116
+ * ```
37
117
  */
38
118
  export declare function getAlertVariantClass(variant: Variant): string;
39
119
  /**
40
120
  * 进度条变体类名
121
+ * @param variant - 语义变体。
122
+ * @returns 进度条语义变体类名。
123
+ *
124
+ * @example
125
+ * ```ts
126
+ * import { getProgressVariantClass } from '@h-ai/ui'
127
+ * const classes = getProgressVariantClass('success')
128
+ * ```
41
129
  */
42
130
  export declare function getProgressVariantClass(variant: Variant): string;
43
131
  /**
44
132
  * 生成唯一 ID
133
+ * @param prefix - 类名前缀或界面 ID 前缀。
134
+ * @returns 用于界面节点关联的随机 ID,不具备安全令牌或分布式主键保证。
135
+ *
136
+ * @example
137
+ * ```ts
138
+ * import { generateId } from '@h-ai/ui'
139
+ * const inputId = generateId('profile-email')
140
+ * // 仅用于界面节点关联,不用作安全令牌或分布式业务主键。
141
+ * ```
45
142
  */
46
143
  export declare function generateId(prefix?: string): string;
144
+ /**
145
+ * Portal action:将节点移动到目标容器(默认 document.body)下渲染。
146
+ *
147
+ * 用于弹出层(下拉、气泡等)逃逸祖先的 `overflow: hidden` 裁剪与
148
+ * 堆叠上下文(stacking context)限制,避免被相邻控件遮挡。
149
+ *
150
+ * @param node - 要移动的节点
151
+ * @param target - 目标容器或选择器;默认 body
152
+ * @returns 包含 update 和 destroy 的 Svelte action 句柄。
153
+ *
154
+ * @example
155
+ * ```ts
156
+ * import { portal } from '@h-ai/ui'
157
+ * const popup = document.createElement('div')
158
+ * const action = portal(popup, document.body)
159
+ * action.update(document.body)
160
+ * action.destroy()
161
+ * ```
162
+ */
163
+ export declare function portal(node: HTMLElement, target?: HTMLElement | string): {
164
+ update(next: HTMLElement | string): void;
165
+ destroy(): void;
166
+ };
package/dist/utils.js CHANGED
@@ -10,38 +10,158 @@ import { twMerge } from 'tailwind-merge';
10
10
  *
11
11
  * @param classes - 类名列表
12
12
  * @returns 合并后的类名字符串
13
+ *
14
+ * @example
15
+ * ```ts
16
+ * import { cn } from '@h-ai/ui'
17
+ * const classes = cn('px-2', 'px-4', false, 'font-medium')
18
+ * // classes 为冲突合并后的类名,可直接用于元素 class。
19
+ * ```
13
20
  */
14
21
  export function cn(...classes) {
15
22
  return twMerge(classes.filter(Boolean).join(' '));
16
23
  }
24
+ /**
25
+ * 从组件未声明 props 中提取 data-* 属性,避免把普通未知属性透传到 DOM。
26
+ * @param props - 组件的属性对象。
27
+ * @returns 只包含安全原子值的 data-* 属性对象。
28
+ *
29
+ * @example
30
+ * ```ts
31
+ * import { getDataAttributes } from '@h-ai/ui'
32
+ * const attributes = getDataAttributes({ 'data-testid': 'save', 'data-loading': false, onclick: 'ignored' })
33
+ * // 仅保留安全类型的 data-* 字段。
34
+ * ```
35
+ */
36
+ export function getDataAttributes(props) {
37
+ const dataAttributes = {};
38
+ for (const [key, value] of Object.entries(props)) {
39
+ if (!key.startsWith('data-') || value === null || value === undefined) {
40
+ continue;
41
+ }
42
+ if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
43
+ dataAttributes[key] = value;
44
+ }
45
+ }
46
+ return dataAttributes;
47
+ }
48
+ /**
49
+ * 已知前缀的变体类名静态映射
50
+ *
51
+ * 使用静态字符串而非模板字符串拼接,确保 TailwindCSS 可静态扫描到所有类名。
52
+ */
53
+ const VARIANT_MAPS = {
54
+ btn: {
55
+ default: '',
56
+ primary: 'btn-primary',
57
+ secondary: 'btn-secondary',
58
+ success: 'btn-success',
59
+ warning: 'btn-warning',
60
+ error: 'btn-error',
61
+ info: 'btn-info',
62
+ ghost: 'btn-ghost',
63
+ link: 'btn-link',
64
+ outline: 'btn-outline',
65
+ },
66
+ badge: {
67
+ default: 'badge-neutral',
68
+ primary: 'badge-primary',
69
+ secondary: 'badge-secondary',
70
+ success: 'badge-success',
71
+ warning: 'badge-warning',
72
+ error: 'badge-error',
73
+ info: 'badge-info',
74
+ ghost: 'badge-ghost',
75
+ link: 'badge-link',
76
+ outline: 'badge-outline',
77
+ },
78
+ progress: {
79
+ default: 'progress-neutral',
80
+ primary: 'progress-primary',
81
+ secondary: 'progress-secondary',
82
+ success: 'progress-success',
83
+ warning: 'progress-warning',
84
+ error: 'progress-error',
85
+ info: 'progress-info',
86
+ ghost: 'progress-ghost',
87
+ link: 'progress-link',
88
+ outline: 'progress-outline',
89
+ },
90
+ };
91
+ /**
92
+ * 已知前缀的尺寸类名静态映射
93
+ */
94
+ const SIZE_MAPS = {
95
+ btn: {
96
+ 'xs': 'btn-xs',
97
+ 'sm': 'btn-sm',
98
+ 'md': '',
99
+ 'lg': 'btn-lg',
100
+ 'xl': 'btn-xl',
101
+ '2xl': 'btn-xl',
102
+ '3xl': 'btn-xl',
103
+ '4xl': 'btn-xl',
104
+ },
105
+ badge: {
106
+ 'xs': 'badge-xs',
107
+ 'sm': 'badge-sm',
108
+ 'md': '',
109
+ 'lg': 'badge-lg',
110
+ 'xl': 'badge-xl',
111
+ '2xl': 'badge-xl',
112
+ '3xl': 'badge-xl',
113
+ '4xl': 'badge-xl',
114
+ },
115
+ };
17
116
  /**
18
117
  * 获取变体类名
118
+ * @param variant - 语义变体。
119
+ * @param prefix - 类名前缀或界面 ID 前缀。
120
+ * @returns 对应前缀和变体的 DaisyUI 类名;未知前缀按约定拼接。
121
+ *
122
+ * @example
123
+ * ```ts
124
+ * import { getVariantClass } from '@h-ai/ui'
125
+ * const classes = getVariantClass('primary', 'btn')
126
+ * ```
19
127
  */
20
128
  export function getVariantClass(variant, prefix = 'btn') {
21
- const map = {
22
- default: `${prefix}-neutral`,
23
- primary: `${prefix}-primary`,
24
- secondary: `${prefix}-secondary`,
25
- success: `${prefix}-success`,
26
- warning: `${prefix}-warning`,
27
- error: `${prefix}-error`,
28
- info: `${prefix}-info`,
29
- ghost: `${prefix}-ghost`,
30
- link: `${prefix}-link`,
31
- outline: `${prefix}-outline`,
32
- };
33
- return map[variant] ?? map.default;
129
+ const map = VARIANT_MAPS[prefix];
130
+ if (map)
131
+ return map[variant] ?? map.default;
132
+ // 未预置的前缀回退为动态拼接(调用方需自行确保 Tailwind 可扫描)
133
+ return `${prefix}-${variant === 'default' ? 'neutral' : variant}`;
34
134
  }
35
135
  /**
36
136
  * 获取尺寸类名
137
+ * @param size - 组件尺寸预设。
138
+ * @param prefix - 类名前缀或界面 ID 前缀。
139
+ * @returns 对应尺寸的类名,中号尺寸使用空字符串。
140
+ *
141
+ * @example
142
+ * ```ts
143
+ * import { getSizeClass } from '@h-ai/ui'
144
+ * const classes = getSizeClass('lg', 'btn')
145
+ * ```
37
146
  */
38
147
  export function getSizeClass(size, prefix = 'btn') {
39
148
  if (size === 'md')
40
149
  return '';
150
+ const map = SIZE_MAPS[prefix];
151
+ if (map)
152
+ return map[size] ?? '';
41
153
  return `${prefix}-${size}`;
42
154
  }
43
155
  /**
44
156
  * 输入框尺寸类名
157
+ * @param size - 组件尺寸预设。
158
+ * @returns 输入框尺寸类名;大于 xl 的预设统一使用 input-xl。
159
+ *
160
+ * @example
161
+ * ```ts
162
+ * import { getInputSizeClass } from '@h-ai/ui'
163
+ * const classes = getInputSizeClass('sm')
164
+ * ```
45
165
  */
46
166
  export function getInputSizeClass(size) {
47
167
  const map = {
@@ -58,18 +178,42 @@ export function getInputSizeClass(size) {
58
178
  }
59
179
  /**
60
180
  * 徽章变体类名
181
+ * @param variant - 语义变体。
182
+ * @returns 徽章语义变体类名。
183
+ *
184
+ * @example
185
+ * ```ts
186
+ * import { getBadgeVariantClass } from '@h-ai/ui'
187
+ * const classes = getBadgeVariantClass('success')
188
+ * ```
61
189
  */
62
190
  export function getBadgeVariantClass(variant) {
63
191
  return getVariantClass(variant, 'badge');
64
192
  }
65
193
  /**
66
194
  * 徽章尺寸类名
195
+ * @param size - 组件尺寸预设。
196
+ * @returns 徽章尺寸类名。
197
+ *
198
+ * @example
199
+ * ```ts
200
+ * import { getBadgeSizeClass } from '@h-ai/ui'
201
+ * const classes = getBadgeSizeClass('sm')
202
+ * ```
67
203
  */
68
204
  export function getBadgeSizeClass(size) {
69
205
  return getSizeClass(size, 'badge');
70
206
  }
71
207
  /**
72
208
  * 警告框变体类名
209
+ * @param variant - 语义变体。
210
+ * @returns 警告框语义变体类名。
211
+ *
212
+ * @example
213
+ * ```ts
214
+ * import { getAlertVariantClass } from '@h-ai/ui'
215
+ * const classes = getAlertVariantClass('warning')
216
+ * ```
73
217
  */
74
218
  export function getAlertVariantClass(variant) {
75
219
  const map = {
@@ -88,13 +232,64 @@ export function getAlertVariantClass(variant) {
88
232
  }
89
233
  /**
90
234
  * 进度条变体类名
235
+ * @param variant - 语义变体。
236
+ * @returns 进度条语义变体类名。
237
+ *
238
+ * @example
239
+ * ```ts
240
+ * import { getProgressVariantClass } from '@h-ai/ui'
241
+ * const classes = getProgressVariantClass('success')
242
+ * ```
91
243
  */
92
244
  export function getProgressVariantClass(variant) {
93
245
  return getVariantClass(variant, 'progress');
94
246
  }
95
247
  /**
96
248
  * 生成唯一 ID
249
+ * @param prefix - 类名前缀或界面 ID 前缀。
250
+ * @returns 用于界面节点关联的随机 ID,不具备安全令牌或分布式主键保证。
251
+ *
252
+ * @example
253
+ * ```ts
254
+ * import { generateId } from '@h-ai/ui'
255
+ * const inputId = generateId('profile-email')
256
+ * // 仅用于界面节点关联,不用作安全令牌或分布式业务主键。
257
+ * ```
97
258
  */
98
259
  export function generateId(prefix = 'hai') {
99
260
  return `${prefix}-${Math.random().toString(36).slice(2, 9)}`;
100
261
  }
262
+ /**
263
+ * Portal action:将节点移动到目标容器(默认 document.body)下渲染。
264
+ *
265
+ * 用于弹出层(下拉、气泡等)逃逸祖先的 `overflow: hidden` 裁剪与
266
+ * 堆叠上下文(stacking context)限制,避免被相邻控件遮挡。
267
+ *
268
+ * @param node - 要移动的节点
269
+ * @param target - 目标容器或选择器;默认 body
270
+ * @returns 包含 update 和 destroy 的 Svelte action 句柄。
271
+ *
272
+ * @example
273
+ * ```ts
274
+ * import { portal } from '@h-ai/ui'
275
+ * const popup = document.createElement('div')
276
+ * const action = portal(popup, document.body)
277
+ * action.update(document.body)
278
+ * action.destroy()
279
+ * ```
280
+ */
281
+ export function portal(node, target = 'body') {
282
+ function mount(to) {
283
+ const targetEl = typeof to === 'string' ? document.querySelector(to) : to;
284
+ targetEl?.appendChild(node);
285
+ }
286
+ mount(target);
287
+ return {
288
+ update(next) {
289
+ mount(next);
290
+ },
291
+ destroy() {
292
+ node.parentNode?.removeChild(node);
293
+ },
294
+ };
295
+ }
@@ -0,0 +1,20 @@
1
+ /**
2
+ * 工作区导航标题按实例共享,读取 getter 以跟随路由及语言变化。
3
+ * @example 模块内部上下文
4
+ * ```ts
5
+ * const context: WorkspaceContext = { title: '用户管理' }
6
+ * void context
7
+ * ```
8
+ */
9
+ export interface WorkspaceContext {
10
+ readonly title: string;
11
+ }
12
+ /**
13
+ * 仅供布局和标题组件协作,不属于公开 API。
14
+ * @example 模块内部上下文
15
+ * ```ts
16
+ * const key: symbol = workspaceContextKey
17
+ * void key
18
+ * ```
19
+ */
20
+ export declare const workspaceContextKey: unique symbol;
@@ -0,0 +1,9 @@
1
+ /**
2
+ * 仅供布局和标题组件协作,不属于公开 API。
3
+ * @example 模块内部上下文
4
+ * ```ts
5
+ * const key: symbol = workspaceContextKey
6
+ * void key
7
+ * ```
8
+ */
9
+ export const workspaceContextKey = Symbol('hai-workspace');