@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
@@ -5,32 +5,97 @@
5
5
  * @module i18n.svelte
6
6
  */
7
7
  import { core } from '@h-ai/core';
8
+ import { readStoredValue, writeStoredValue } from './internal/browser-safety.js';
9
+ import { changeUILocale as setGlobalLocale } from './internal/locale.js';
10
+ // 状态层可格式化安全认证提示,无需加载场景组件。
11
+ export { authErrorMessage } from './components/scenes/iam/auth-error-message.js';
8
12
  // 从 core.i18n 解构常用函数
9
- const { DEFAULT_LOCALE, DEFAULT_LOCALES, setGlobalLocale, } = core.i18n;
13
+ const { DEFAULT_LOCALE, DEFAULT_LOCALES, } = core.i18n;
14
+ /** 匹配实际支持项;区域/脚本逐级回退,始终返回列表中的原始代码,不执行默认回退。 */
15
+ function matchSupportedLocale(locale, supportedLocales) {
16
+ const normalize = (value) => value.trim().replaceAll('_', '-').toLowerCase();
17
+ let candidate = normalize(locale);
18
+ while (candidate) {
19
+ const exact = supportedLocales.find(item => normalize(item.code) === candidate);
20
+ if (exact)
21
+ return exact.code;
22
+ const variant = supportedLocales.find(item => normalize(item.code).startsWith(`${candidate}-`));
23
+ if (variant)
24
+ return variant.code;
25
+ const separator = candidate.lastIndexOf('-');
26
+ candidate = separator < 0 ? '' : candidate.slice(0, separator);
27
+ }
28
+ return null;
29
+ }
30
+ /**
31
+ * 检查语言是否匹配应用支持列表,允许区域回退,不把默认值计作命中。
32
+ * @param locale - 显式语言代码;省略时使用当前上下文。
33
+ * @param supportedLocales - 应用支持的语言列表。
34
+ * @returns 是否存在真实支持项。
35
+ * @example
36
+ * ```ts
37
+ * import { isLocaleSupported } from '@h-ai/ui/i18n'
38
+ * const supported = isLocaleSupported('en-GB')
39
+ * ```
40
+ */
10
41
  function isLocaleSupported(locale, supportedLocales = DEFAULT_LOCALES) {
11
- const normalized = locale === 'en' ? 'en-US' : locale === 'zh' ? 'zh-CN' : locale;
12
- return supportedLocales.some(item => item.code === normalized);
42
+ return matchSupportedLocale(locale, supportedLocales) !== null;
13
43
  }
44
+ /**
45
+ * 将候选语言归一化为支持列表中的实际代码,无命中时使用默认值。
46
+ * @param locale - 显式语言代码;省略时使用当前上下文。
47
+ * @param supportedLocales - 应用支持的语言列表。
48
+ * @param defaultLocale - 无候选命中时的默认语言。
49
+ * @returns 归一化后的文本。
50
+ * @example
51
+ * ```ts
52
+ * import { resolveLocale } from '@h-ai/ui/i18n'
53
+ * const locale = resolveLocale('unsupported', undefined, 'zh-CN')
54
+ * ```
55
+ */
14
56
  function resolveLocale(locale, supportedLocales = DEFAULT_LOCALES, defaultLocale = DEFAULT_LOCALE) {
15
- const normalized = locale === 'en' ? 'en-US' : locale === 'zh' ? 'zh-CN' : locale;
16
- return isLocaleSupported(normalized, supportedLocales) ? normalized : defaultLocale;
57
+ return matchSupportedLocale(locale, supportedLocales)
58
+ ?? matchSupportedLocale(defaultLocale, supportedLocales)
59
+ ?? supportedLocales[0]?.code
60
+ ?? defaultLocale;
17
61
  }
62
+ /**
63
+ * 依浏览器语言顺序选择实际支持项;SSR 或无匹配项返回 null。
64
+ * @param supportedLocales - 应用支持的语言列表。
65
+ * @returns 规范的语言代码或 null。
66
+ * @example
67
+ * ```ts
68
+ * import { detectBrowserLocale } from '@h-ai/ui/i18n'
69
+ * const locale = detectBrowserLocale()
70
+ * ```
71
+ */
18
72
  function detectBrowserLocale(supportedLocales = DEFAULT_LOCALES) {
19
- if (typeof navigator === 'undefined') {
73
+ if (typeof window === 'undefined' || typeof navigator === 'undefined') {
20
74
  return null;
21
75
  }
22
76
  const browserCandidates = [
23
- navigator.language,
24
77
  ...(navigator.languages ?? []),
78
+ navigator.language,
25
79
  ];
26
80
  for (const candidate of browserCandidates) {
27
- const resolved = resolveLocale(candidate, supportedLocales, DEFAULT_LOCALE);
28
- if (isLocaleSupported(resolved, supportedLocales)) {
81
+ const resolved = matchSupportedLocale(candidate, supportedLocales);
82
+ if (resolved) {
29
83
  return resolved;
30
84
  }
31
85
  }
32
86
  return null;
33
87
  }
88
+ /**
89
+ * 替换消息模板中的命名参数;缺少的参数保留原占位符。
90
+ * @param template - 包含命名占位符的消息模板。
91
+ * @param params - 消息插值参数。
92
+ * @returns 归一化后的文本。
93
+ * @example
94
+ * ```ts
95
+ * import { interpolate } from '@h-ai/ui/i18n'
96
+ * const message = interpolate('你好,{name}', { name: 'Ada' })
97
+ * ```
98
+ */
34
99
  function interpolate(template, params = {}) {
35
100
  return template.replace(/\{(\w+)\}/g, (_, key) => {
36
101
  const value = params[key];
@@ -44,21 +109,30 @@ const LOCALE_STORAGE_KEY = 'hai-locale';
44
109
  * 创建 locale 状态管理器
45
110
  *
46
111
  * @param options - 配置选项
47
- * @param options.defaultLocale - 默认 locale
112
+ * @param options.defaultLocale - 全部候选不支持后的默认 locale;不在列表时使用首个支持项。
48
113
  * @param options.supportedLocales - 支持的 locale 列表
49
- * @param options.detectBrowser - 是否检测浏览器语言
114
+ * @param options.detectBrowser - 是否按完整 navigator.languages 顺序匹配;全部失败才回退默认值。
50
115
  * @param options.persistKey - localStorage key
51
116
  * @returns locale 状态对象
117
+ *
118
+ * @example
119
+ * ```ts
120
+ * import { createLocaleStore } from '@h-ai/ui'
121
+ * const locale = createLocaleStore({ defaultLocale: 'zh-CN', detectBrowser: false, persistKey: 'demo-locale' })
122
+ * locale.set('en-US')
123
+ * const selected = locale.current
124
+ * ```
52
125
  */
53
126
  export function createLocaleStore(options = {}) {
54
127
  const { defaultLocale = DEFAULT_LOCALE, supportedLocales = DEFAULT_LOCALES, detectBrowser = true, persistKey = LOCALE_STORAGE_KEY, } = options;
55
128
  // 初始化 locale
56
- let initialLocale = defaultLocale;
129
+ let initialLocale = resolveLocale(defaultLocale, supportedLocales, defaultLocale);
57
130
  if (typeof window !== 'undefined') {
58
131
  // 1. 优先从 localStorage 读取
59
- const savedLocale = localStorage.getItem(persistKey);
60
- if (savedLocale && isLocaleSupported(savedLocale, supportedLocales)) {
61
- initialLocale = savedLocale;
132
+ const savedLocale = readStoredValue(persistKey);
133
+ const supportedSavedLocale = savedLocale ? matchSupportedLocale(savedLocale, supportedLocales) : null;
134
+ if (supportedSavedLocale) {
135
+ initialLocale = supportedSavedLocale;
62
136
  }
63
137
  // 2. 其次检测浏览器语言
64
138
  else if (detectBrowser) {
@@ -68,8 +142,9 @@ export function createLocaleStore(options = {}) {
68
142
  }
69
143
  }
70
144
  }
71
- // 同步初始 locale 到 @h-ai/core 的全局管理器
72
- setGlobalLocale(initialLocale);
145
+ // SSR store 属于当前组件树,不能修改另一个请求的默认语言。
146
+ if (typeof window !== 'undefined')
147
+ setGlobalLocale(initialLocale);
73
148
  // 使用 Svelte 5 runes 创建响应式状态
74
149
  let currentLocale = $state(initialLocale);
75
150
  return {
@@ -83,17 +158,18 @@ export function createLocaleStore(options = {}) {
83
158
  },
84
159
  /**
85
160
  * 设置当前语言
86
- * 会同步到 @h-ai/core 的全局 locale 管理器
161
+ * 浏览器同步到 @h-ai/core;SSR 仅改变当前 store,消息语言由 runWithLocale 绑定。
87
162
  * 注意:你还需要调用 Paraglide 的 setLocale 来更新 UI 翻译
88
163
  */
89
164
  set(locale) {
90
165
  const resolved = resolveLocale(locale, supportedLocales, defaultLocale);
91
166
  currentLocale = resolved;
92
- // 同步到 @h-ai/core 的全局 locale 管理器
93
- setGlobalLocale(resolved);
167
+ // 服务端语言由外层 runWithLocale 明确绑定,store 只在浏览器同步应用状态。
168
+ if (typeof window !== 'undefined')
169
+ setGlobalLocale(resolved);
94
170
  // 持久化到 localStorage
95
171
  if (typeof window !== 'undefined') {
96
- localStorage.setItem(persistKey, resolved);
172
+ writeStoredValue(persistKey, resolved);
97
173
  }
98
174
  },
99
175
  /** 检查语言是否支持 */
@@ -105,4 +181,13 @@ export function createLocaleStore(options = {}) {
105
181
  // 重导出常用常量和函数(便于应用层使用)
106
182
  export { DEFAULT_LOCALE, DEFAULT_LOCALES, detectBrowserLocale, interpolate, isLocaleSupported, resolveLocale, setGlobalLocale, };
107
183
  // 导出额外的便捷函数
184
+ /**
185
+ * 读取 core 当前请求或浏览器上下文的语言,不由 UI store 隐式改写服务端默认值。
186
+ *
187
+ * @example
188
+ * ```ts
189
+ * import { getGlobalLocale } from '@h-ai/ui'
190
+ * const currentLocale = getGlobalLocale()
191
+ * ```
192
+ */
108
193
  export const getGlobalLocale = core.i18n.getGlobalLocale;
package/dist/index.d.ts CHANGED
@@ -5,7 +5,13 @@
5
5
  * @module index
6
6
  */
7
7
  export * from './components/index.js';
8
+ export * from './guide-types.js';
9
+ export * from './guide.svelte.js';
8
10
  export * from './i18n.svelte.js';
11
+ export type { ClipboardHostWriter } from './internal/browser-safety.js';
12
+ export { registerClipboardHostWriter, writeTextToClipboard } from './internal/browser-safety.js';
13
+ export * from './message.svelte.js';
14
+ export * from './messagebox.svelte.js';
9
15
  export * from './theme-config.js';
10
16
  export * from './toast.svelte.js';
11
17
  export * from './types.js';
package/dist/index.js CHANGED
@@ -6,8 +6,15 @@
6
6
  */
7
7
  // ─── 组件导出(从 components/ 统一导出所有三层组件及其类型) ───
8
8
  export * from './components/index.js';
9
+ export * from './guide-types.js';
10
+ export * from './guide.svelte.js';
9
11
  // ─── i18n 国际化(Paraglide 辅助工具) ───
10
12
  export * from './i18n.svelte.js';
13
+ export { registerClipboardHostWriter, writeTextToClipboard } from './internal/browser-safety.js';
14
+ // ─── Message 轻量消息提示(类似 ElementUI Message) ───
15
+ export * from './message.svelte.js';
16
+ // ─── MessageBox 命令式弹框(类似 ElementUI MessageBox) ───
17
+ export * from './messagebox.svelte.js';
11
18
  // ─── 主题配置 ───
12
19
  export * from './theme-config.js';
13
20
  // ─── Toast 状态管理 ───
@@ -0,0 +1,88 @@
1
+ /**
2
+ * @h-ai/ui — 浏览器能力安全辅助
3
+ *
4
+ * 统一封装容易在受限 WebView、隐私模式或不安全上下文中失败的浏览器 API,
5
+ * 让组件在能力缺失时优雅降级而不是抛出运行时错误。
6
+ */
7
+ /**
8
+ * 宿主页面剪贴板写入器(跨域 iframe 场景由嵌入方注入)。
9
+ *
10
+ * @example
11
+ * ```ts
12
+ * import type { ClipboardHostWriter } from '@h-ai/ui'
13
+ * const writer: ClipboardHostWriter = async text => {
14
+ * try { await navigator.clipboard.writeText(text); return true }
15
+ * catch { return false }
16
+ * }
17
+ * ```
18
+ */
19
+ export type ClipboardHostWriter = (text: string) => Promise<boolean>;
20
+ /**
21
+ * 注册宿主页面剪贴板写入器。
22
+ *
23
+ * 当 iframe 内 Clipboard API 与 execCommand 都不可用时,把文本交给宿主页面写入。
24
+ * 宿主仍须满足自身权限、焦点与用户激活要求;返回 false 表示实际写入未成功,不能保证兜底一定可用。
25
+ *
26
+ * @param writer - 宿主写入器;传入 null 注销
27
+ * @returns {void} 无返回值;替换宿主写入器,null 用于注销。
28
+ *
29
+ * @example
30
+ * ```ts
31
+ * import { registerClipboardHostWriter } from '@h-ai/ui'
32
+ * registerClipboardHostWriter(async text => {
33
+ * try { await navigator.clipboard.writeText(text); return true }
34
+ * catch { return false }
35
+ * })
36
+ * // 宿主销毁时注销,避免保留过期窗口闭包。
37
+ * registerClipboardHostWriter(null)
38
+ * ```
39
+ */
40
+ export declare function registerClipboardHostWriter(writer: ClipboardHostWriter | null): void;
41
+ /**
42
+ * 安全读取 localStorage。
43
+ *
44
+ * 某些浏览器隐私模式或嵌入式 WebView 会在访问 localStorage 时直接抛出 SecurityError,
45
+ * 这里统一吞掉异常并回退为 null。
46
+ * @param key - 要读取的条目或消息键。
47
+ * @returns 偏好值;未保存、SSR 或读取失败时返回 null。
48
+ *
49
+ * @example 模块内部上下文
50
+ * ```ts
51
+ * const savedTheme = readStoredValue('demo-theme')
52
+ * // 只保存非敏感偏好;不可用于认证 Token。
53
+ * ```
54
+ */
55
+ export declare function readStoredValue(key: string): string | null;
56
+ /**
57
+ * 安全写入 localStorage。
58
+ *
59
+ * 返回值显式告诉调用方持久化是否成功,方便调用方在失败时继续使用内存态而不必中断交互。
60
+ * @param key - 要读取的条目或消息键。
61
+ * @param value - 待处理或校验的值。
62
+ * @returns 持久化是否成功;失败时调用方可继续保留非敏感内存偏好。
63
+ *
64
+ * @example 模块内部上下文
65
+ * ```ts
66
+ * const persisted = writeStoredValue('demo-theme', 'dark')
67
+ * if (!persisted) { const memoryTheme = 'dark' }
68
+ * ```
69
+ */
70
+ export declare function writeStoredValue(key: string, value: string): boolean;
71
+ /**
72
+ * 安全写入剪贴板。
73
+ *
74
+ * 优先使用现代 Clipboard API;在不安全上下文(HTTP)、旧 WebView
75
+ * 或浏览器策略禁用时回退到 `document.execCommand('copy')`;
76
+ * 跨域 iframe 中上述两种方式都可能被权限/聚焦策略拒绝时,再回退到宿主页面写入器,
77
+ * 确保尽可能多的环境下复制操作可用。
78
+ * @param text - 待处理文本。
79
+ * @returns 任一实际写入路径是否成功。
80
+ *
81
+ * @example
82
+ * ```ts
83
+ * import { writeTextToClipboard } from '@h-ai/ui'
84
+ * const copied = await writeTextToClipboard('https://example.com/help')
85
+ * if (!copied) throw new Error('Clipboard is unavailable')
86
+ * ```
87
+ */
88
+ export declare function writeTextToClipboard(text: string): Promise<boolean>;
@@ -0,0 +1,140 @@
1
+ /**
2
+ * @h-ai/ui — 浏览器能力安全辅助
3
+ *
4
+ * 统一封装容易在受限 WebView、隐私模式或不安全上下文中失败的浏览器 API,
5
+ * 让组件在能力缺失时优雅降级而不是抛出运行时错误。
6
+ */
7
+ let clipboardHostWriter = null;
8
+ /**
9
+ * 注册宿主页面剪贴板写入器。
10
+ *
11
+ * 当 iframe 内 Clipboard API 与 execCommand 都不可用时,把文本交给宿主页面写入。
12
+ * 宿主仍须满足自身权限、焦点与用户激活要求;返回 false 表示实际写入未成功,不能保证兜底一定可用。
13
+ *
14
+ * @param writer - 宿主写入器;传入 null 注销
15
+ * @returns {void} 无返回值;替换宿主写入器,null 用于注销。
16
+ *
17
+ * @example
18
+ * ```ts
19
+ * import { registerClipboardHostWriter } from '@h-ai/ui'
20
+ * registerClipboardHostWriter(async text => {
21
+ * try { await navigator.clipboard.writeText(text); return true }
22
+ * catch { return false }
23
+ * })
24
+ * // 宿主销毁时注销,避免保留过期窗口闭包。
25
+ * registerClipboardHostWriter(null)
26
+ * ```
27
+ */
28
+ export function registerClipboardHostWriter(writer) {
29
+ clipboardHostWriter = writer;
30
+ }
31
+ /**
32
+ * 安全读取 localStorage。
33
+ *
34
+ * 某些浏览器隐私模式或嵌入式 WebView 会在访问 localStorage 时直接抛出 SecurityError,
35
+ * 这里统一吞掉异常并回退为 null。
36
+ * @param key - 要读取的条目或消息键。
37
+ * @returns 偏好值;未保存、SSR 或读取失败时返回 null。
38
+ *
39
+ * @example 模块内部上下文
40
+ * ```ts
41
+ * const savedTheme = readStoredValue('demo-theme')
42
+ * // 只保存非敏感偏好;不可用于认证 Token。
43
+ * ```
44
+ */
45
+ export function readStoredValue(key) {
46
+ try {
47
+ if (typeof localStorage === 'undefined') {
48
+ return null;
49
+ }
50
+ return localStorage.getItem(key);
51
+ }
52
+ catch {
53
+ return null;
54
+ }
55
+ }
56
+ /**
57
+ * 安全写入 localStorage。
58
+ *
59
+ * 返回值显式告诉调用方持久化是否成功,方便调用方在失败时继续使用内存态而不必中断交互。
60
+ * @param key - 要读取的条目或消息键。
61
+ * @param value - 待处理或校验的值。
62
+ * @returns 持久化是否成功;失败时调用方可继续保留非敏感内存偏好。
63
+ *
64
+ * @example 模块内部上下文
65
+ * ```ts
66
+ * const persisted = writeStoredValue('demo-theme', 'dark')
67
+ * if (!persisted) { const memoryTheme = 'dark' }
68
+ * ```
69
+ */
70
+ export function writeStoredValue(key, value) {
71
+ try {
72
+ if (typeof localStorage === 'undefined') {
73
+ return false;
74
+ }
75
+ localStorage.setItem(key, value);
76
+ return true;
77
+ }
78
+ catch {
79
+ return false;
80
+ }
81
+ }
82
+ /**
83
+ * 安全写入剪贴板。
84
+ *
85
+ * 优先使用现代 Clipboard API;在不安全上下文(HTTP)、旧 WebView
86
+ * 或浏览器策略禁用时回退到 `document.execCommand('copy')`;
87
+ * 跨域 iframe 中上述两种方式都可能被权限/聚焦策略拒绝时,再回退到宿主页面写入器,
88
+ * 确保尽可能多的环境下复制操作可用。
89
+ * @param text - 待处理文本。
90
+ * @returns 任一实际写入路径是否成功。
91
+ *
92
+ * @example
93
+ * ```ts
94
+ * import { writeTextToClipboard } from '@h-ai/ui'
95
+ * const copied = await writeTextToClipboard('https://example.com/help')
96
+ * if (!copied) throw new Error('Clipboard is unavailable')
97
+ * ```
98
+ */
99
+ export async function writeTextToClipboard(text) {
100
+ // 现代 Clipboard API(仅安全上下文可用)
101
+ if (typeof navigator !== 'undefined' && navigator.clipboard?.writeText) {
102
+ try {
103
+ await navigator.clipboard.writeText(text);
104
+ return true;
105
+ }
106
+ catch {
107
+ // Clipboard API 失败时继续尝试 fallback
108
+ }
109
+ }
110
+ // fallback:textarea + execCommand(兼容 HTTP、旧浏览器)
111
+ if (typeof document !== 'undefined') {
112
+ try {
113
+ const textarea = document.createElement('textarea');
114
+ textarea.value = text;
115
+ textarea.style.cssText = 'position:fixed;left:-9999px;top:-9999px;opacity:0';
116
+ document.body.appendChild(textarea);
117
+ try {
118
+ textarea.select();
119
+ if (document.execCommand('copy'))
120
+ return true;
121
+ }
122
+ finally {
123
+ document.body.removeChild(textarea);
124
+ }
125
+ }
126
+ catch {
127
+ // 继续尝试宿主写入器
128
+ }
129
+ }
130
+ // 最终兜底:跨域 iframe 场景由宿主页面写入
131
+ if (clipboardHostWriter) {
132
+ try {
133
+ return await clipboardHostWriter(text);
134
+ }
135
+ catch {
136
+ return false;
137
+ }
138
+ }
139
+ return false;
140
+ }
@@ -0,0 +1,21 @@
1
+ /**
2
+ * 打开后优先聚焦可编辑字段,清理时取消首帧校准并恢复触发控件。
3
+ * @example 模块内部上下文
4
+ * ```ts
5
+ * function example(panel: HTMLElement) {
6
+ * const restore = focusDialog(panel)
7
+ * return restore
8
+ * }
9
+ * ```
10
+ */
11
+ export declare function focusDialog(panel: HTMLElement): () => void;
12
+ /**
13
+ * 原生 Tab 顺序只在边缘循环;嵌套弹层已处理的键盘事件不再拦截。
14
+ * @example 模块内部上下文
15
+ * ```ts
16
+ * function example(event: KeyboardEvent, panel: HTMLElement) {
17
+ * handleDialogKeydown(event, panel, () => {})
18
+ * }
19
+ * ```
20
+ */
21
+ export declare function handleDialogKeydown(event: KeyboardEvent, panel: HTMLElement, close?: () => void): void;
@@ -0,0 +1,77 @@
1
+ /** 弹窗和抽屉共享可见、可操作的焦点边界。 */
2
+ function focusable(panel) {
3
+ return [...panel.querySelectorAll('button, a[href], input:not([type="hidden"]), select, textarea, [tabindex]')]
4
+ .filter(element => element.tabIndex >= 0 && !element.matches(':disabled') && element.getClientRects().length > 0);
5
+ }
6
+ /**
7
+ * 打开后优先聚焦可编辑字段,清理时取消首帧校准并恢复触发控件。
8
+ * @example 模块内部上下文
9
+ * ```ts
10
+ * function example(panel: HTMLElement) {
11
+ * const restore = focusDialog(panel)
12
+ * return restore
13
+ * }
14
+ * ```
15
+ */
16
+ export function focusDialog(panel) {
17
+ const previous = document.activeElement instanceof HTMLElement ? document.activeElement : null;
18
+ function preferred() {
19
+ const elements = focusable(panel);
20
+ return elements.find(element => element.matches('input:not([readonly]), textarea, select, [role="combobox"]')) ?? elements[0] ?? panel;
21
+ }
22
+ const initial = preferred();
23
+ initial.focus({ preventScroll: true });
24
+ function alignFocus() {
25
+ const active = document.activeElement;
26
+ if (panel.isConnected && (active === previous || active === initial || active === panel || active === document.body))
27
+ preferred().focus({ preventScroll: true });
28
+ }
29
+ function onTransition(event) {
30
+ if (event.target === panel)
31
+ alignFocus();
32
+ }
33
+ panel.addEventListener('transitionend', onTransition);
34
+ const frame = typeof requestAnimationFrame === 'function' ? requestAnimationFrame(alignFocus) : undefined;
35
+ return () => {
36
+ panel.removeEventListener('transitionend', onTransition);
37
+ if (frame !== undefined)
38
+ cancelAnimationFrame(frame);
39
+ if (previous?.isConnected && !previous.matches(':disabled'))
40
+ previous.focus();
41
+ };
42
+ }
43
+ /**
44
+ * 原生 Tab 顺序只在边缘循环;嵌套弹层已处理的键盘事件不再拦截。
45
+ * @example 模块内部上下文
46
+ * ```ts
47
+ * function example(event: KeyboardEvent, panel: HTMLElement) {
48
+ * handleDialogKeydown(event, panel, () => {})
49
+ * }
50
+ * ```
51
+ */
52
+ export function handleDialogKeydown(event, panel, close) {
53
+ if (event.defaultPrevented)
54
+ return;
55
+ if (event.key === 'Escape' && close) {
56
+ event.preventDefault();
57
+ event.stopPropagation();
58
+ close();
59
+ }
60
+ else if (event.key === 'Tab') {
61
+ const elements = focusable(panel);
62
+ const first = elements[0];
63
+ const last = elements.at(-1);
64
+ if (!first) {
65
+ event.preventDefault();
66
+ panel.focus();
67
+ }
68
+ else if (event.shiftKey && (document.activeElement === first || document.activeElement === panel)) {
69
+ event.preventDefault();
70
+ last?.focus();
71
+ }
72
+ else if (!event.shiftKey && document.activeElement === last) {
73
+ event.preventDefault();
74
+ first.focus();
75
+ }
76
+ }
77
+ }
@@ -0,0 +1,92 @@
1
+ /** 表单布局和字段提示的内部上下文,不要求应用转发控件属性。 */
2
+ import type { FormLayoutOptions } from '../types.js';
3
+ /**
4
+ * 表单布局的私有 Svelte Context 键;应用通过 FormLayout 使用。
5
+ *
6
+ * @example 模块内部上下文
7
+ * ```ts
8
+ * const context = getContext<FormLayoutOptions | undefined>(FORM_LAYOUT_CONTEXT)
9
+ * const columns = context?.columns
10
+ * ```
11
+ */
12
+ export declare const FORM_LAYOUT_CONTEXT: unique symbol;
13
+ /**
14
+ * 字段标签、错误与主控件关联的私有 Context 键。
15
+ *
16
+ * @example 模块内部上下文
17
+ * ```ts
18
+ * const field = getContext<FormFieldContext | undefined>(FORM_FIELD_CONTEXT)
19
+ * const controlId = field?.controlId
20
+ * ```
21
+ */
22
+ export declare const FORM_FIELD_CONTEXT: unique symbol;
23
+ /**
24
+ * Modal/Drawer 向内部表单同步可见性的私有 Context 键。
25
+ *
26
+ * @example 模块内部上下文
27
+ * ```ts
28
+ * const visibility = getContext<FormVisibilityContext | undefined>(FORM_VISIBILITY_CONTEXT)
29
+ * const open = visibility?.open
30
+ * ```
31
+ */
32
+ export declare const FORM_VISIBILITY_CONTEXT: unique symbol;
33
+ /**
34
+ * 表单宿主的响应式可见状态,用于关闭时重置触碰校验。
35
+ *
36
+ * @example 模块内部上下文
37
+ * ```ts
38
+ * const example: FormVisibilityContext = { open: true }
39
+ * ```
40
+ */
41
+ interface FormVisibilityContext {
42
+ readonly open: boolean;
43
+ }
44
+ /**
45
+ * 组件初始化阶段读取可见性;没有宿主时返回 undefined。
46
+ * @returns 最近宿主的可见状态;无宿主时为 undefined。
47
+ *
48
+ * @example 模块内部上下文
49
+ * ```ts
50
+ * const visibility = getFormVisibilityContext()
51
+ * const open = visibility?.open ?? true
52
+ * ```
53
+ */
54
+ export declare function getFormVisibilityContext(): FormVisibilityContext | undefined;
55
+ /**
56
+ * 标签、消息和主控件的关联状态,只在当前组件树中使用。
57
+ *
58
+ * @example 模块内部上下文
59
+ * ```ts
60
+ * const example: FormFieldContext = { controlId: 'email', labelId: 'email-label', messageId: 'email-error', error: '邮箱不能为空' }
61
+ * ```
62
+ */
63
+ export interface FormFieldContext {
64
+ readonly label?: string;
65
+ readonly controlId: string;
66
+ readonly labelId: string;
67
+ readonly messageId: string | undefined;
68
+ readonly error: string;
69
+ }
70
+ /**
71
+ * 组件初始化阶段读取祖先布局;没有祖先时使用控件默认布局。
72
+ * @returns 最近表单布局;无祖先时为 undefined。
73
+ *
74
+ * @example 模块内部上下文
75
+ * ```ts
76
+ * const layout = getFormLayoutContext()
77
+ * const columns = layout?.columns ?? 1
78
+ * ```
79
+ */
80
+ export declare function getFormLayoutContext(): FormLayoutOptions | undefined;
81
+ /**
82
+ * 组件初始化阶段读取最近字段的无障碍关联和校验消息。
83
+ * @returns 最近字段的标签、控件和校验消息关联;无字段时为 undefined。
84
+ *
85
+ * @example 模块内部上下文
86
+ * ```ts
87
+ * const field = getFormFieldContext()
88
+ * const descriptionId = field?.messageId
89
+ * ```
90
+ */
91
+ export declare function getFormFieldContext(): FormFieldContext | undefined;
92
+ export {};