@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,240 @@
1
+ <!--
2
+ @component ThemeColorPicker
3
+ 主题色选择器,提供预置主题色与原生取色盘能力。
4
+
5
+ @prop {string} value - 当前选中的颜色值(Hex)
6
+ @prop {Array<{ value: string, label: string }>} presets - 预置主题色列表
7
+ @prop {function} onchange - 颜色变更回调
8
+
9
+ @example
10
+ ```ts
11
+ import { mount, unmount } from 'svelte'
12
+ import type { ComponentProps } from 'svelte'
13
+ import { ThemeColorPicker } from '@h-ai/ui'
14
+ const props: ComponentProps<typeof ThemeColorPicker> = { value: '#2563eb', presets: [{ value: '#2563eb', label: '蓝色' }] }
15
+ const component = mount(ThemeColorPicker, { target: document.body, props })
16
+ await unmount(component)
17
+ ```
18
+ -->
19
+ <script lang='ts'>
20
+ import type { DataAttributes } from '../../../types.js'
21
+ import { uiM } from '../../../messages.js'
22
+ import { DEFAULT_THEME_COLOR, THEME_COLOR_PRESETS } from '../../../theme-config.js'
23
+ import { cn, getDataAttributes } from '../../../utils.js'
24
+
25
+ const HEX_COLOR_REGEX = /^#[0-9a-f]{6}$/
26
+ const SHORT_HEX_COLOR_REGEX = /^#[0-9a-f]{3}$/
27
+
28
+ /**
29
+ * 主题色选择器的显示名称与 Hex 值。
30
+ *
31
+ * @example 模块内部上下文
32
+ * ```ts
33
+ * const example: ThemeColorPreset = { value: '#2563eb', label: '蓝色' }
34
+ * ```
35
+ */
36
+ interface ThemeColorPreset {
37
+ value: string
38
+ label: string
39
+ }
40
+
41
+ /**
42
+ * ThemeColorPicker 组件的属性契约;通过公开组件配置使用。
43
+ *
44
+ * @example
45
+ * ```ts
46
+ * import { mount, unmount } from 'svelte'
47
+ * import type { ComponentProps } from 'svelte'
48
+ * import { ThemeColorPicker } from '@h-ai/ui'
49
+ * const props: ComponentProps<typeof ThemeColorPicker> = { value: '#2563eb', presets: [{ value: '#2563eb', label: '蓝色' }] }
50
+ * const component = mount(ThemeColorPicker, { target: document.body, props })
51
+ * await unmount(component)
52
+ * ```
53
+ */
54
+ interface Props {
55
+ value?: string
56
+ presets?: ThemeColorPreset[]
57
+ disabled?: boolean
58
+ onchange?: (color: string) => void
59
+ pickerLabel?: string
60
+ customLabel?: string
61
+ class?: string
62
+ }
63
+
64
+ const {
65
+ value = DEFAULT_THEME_COLOR,
66
+ presets,
67
+ disabled = false,
68
+ onchange,
69
+ pickerLabel,
70
+ customLabel,
71
+ class: className = '',
72
+ ...restProps
73
+ }: Props & DataAttributes = $props()
74
+
75
+ const dataAttributes = $derived(getDataAttributes(restProps))
76
+ let colorInputRef = $state<HTMLInputElement | null>(null)
77
+
78
+ const defaultPresets = $derived(
79
+ THEME_COLOR_PRESETS.map(preset => ({
80
+ value: preset.value,
81
+ label: uiM(preset.labelKey),
82
+ })),
83
+ )
84
+
85
+ const resolvedPresets = $derived(presets?.length ? presets : defaultPresets)
86
+ const displayPickerLabel = $derived(pickerLabel ?? uiM('theme_color_picker_label'))
87
+ const displayCustomLabel = $derived(customLabel ?? uiM('theme_color_custom'))
88
+
89
+ function normalizeHexColor(input: string | undefined): string | null {
90
+ const normalized = input?.trim().toLowerCase() ?? ''
91
+
92
+ if (HEX_COLOR_REGEX.test(normalized)) {
93
+ return normalized
94
+ }
95
+
96
+ if (SHORT_HEX_COLOR_REGEX.test(normalized)) {
97
+ return `#${normalized[1]}${normalized[1]}${normalized[2]}${normalized[2]}${normalized[3]}${normalized[3]}`
98
+ }
99
+
100
+ return null
101
+ }
102
+
103
+ const normalizedPresets = $derived(
104
+ resolvedPresets
105
+ .map((preset) => {
106
+ const normalizedValue = normalizeHexColor(preset.value)
107
+ if (!normalizedValue) {
108
+ return null
109
+ }
110
+
111
+ return {
112
+ ...preset,
113
+ value: normalizedValue,
114
+ }
115
+ })
116
+ .filter((preset): preset is ThemeColorPreset => Boolean(preset)),
117
+ )
118
+
119
+ const currentColor = $derived(normalizeHexColor(value) ?? DEFAULT_THEME_COLOR)
120
+ const activePreset = $derived(
121
+ normalizedPresets.find(preset => preset.value === currentColor) ?? null,
122
+ )
123
+
124
+ function updateColor(nextColor: string): void {
125
+ const normalized = normalizeHexColor(nextColor)
126
+ if (!normalized || normalized === currentColor) {
127
+ return
128
+ }
129
+
130
+ onchange?.(normalized)
131
+ }
132
+ </script>
133
+
134
+ <div {...dataAttributes} class={cn('theme-color-picker', className)}>
135
+ <div class='flex flex-wrap items-center gap-2'>
136
+ {#each normalizedPresets as preset (preset.value)}
137
+ <button
138
+ type='button'
139
+ class={cn(
140
+ 'inline-flex items-center gap-2 rounded-full border px-3 py-2 text-sm transition-colors',
141
+ preset.value === currentColor
142
+ ? 'border-primary bg-primary/10 text-primary shadow-sm'
143
+ : 'border-base-content/12 bg-base-100 text-base-content hover:border-primary/25 hover:bg-base-200/80',
144
+ disabled && 'cursor-not-allowed opacity-60',
145
+ )}
146
+ aria-pressed={preset.value === currentColor}
147
+ disabled={disabled}
148
+ onclick={() => updateColor(preset.value)}
149
+ >
150
+ <span
151
+ class='size-4 shrink-0 rounded-full border border-black/10'
152
+ style={`background:${preset.value};`}
153
+ aria-hidden='true'
154
+ ></span>
155
+ <span>{preset.label}</span>
156
+ </button>
157
+ {/each}
158
+
159
+ <button
160
+ type='button'
161
+ class={cn(
162
+ 'group inline-flex items-center gap-2 rounded-full border px-3 py-2 text-left text-sm transition-colors',
163
+ activePreset
164
+ ? 'border-base-content/12 bg-base-100 text-base-content hover:border-primary/25 hover:bg-base-200/80'
165
+ : 'border-primary bg-primary/10 text-primary shadow-sm',
166
+ disabled && 'cursor-not-allowed opacity-60',
167
+ )}
168
+ aria-label={displayPickerLabel}
169
+ aria-pressed={!activePreset}
170
+ disabled={disabled}
171
+ onclick={() => colorInputRef?.click()}
172
+ >
173
+ <span
174
+ class='size-4 shrink-0 rounded-full border border-black/10 shadow-sm transition-transform group-hover:scale-[1.03]'
175
+ style={`background:${currentColor};`}
176
+ aria-hidden='true'
177
+ ></span>
178
+
179
+ <span class='inline-flex items-center gap-2 min-w-0'>
180
+ <span>{displayCustomLabel}</span>
181
+ {#if !activePreset}
182
+ <span class='text-xs uppercase tracking-[0.14em] text-current/70'>
183
+ {currentColor}
184
+ </span>
185
+ {/if}
186
+ </span>
187
+ </button>
188
+
189
+ <input
190
+ bind:this={colorInputRef}
191
+ class='sr-only'
192
+ type='color'
193
+ value={currentColor}
194
+ aria-label={displayPickerLabel}
195
+ disabled={disabled}
196
+ onchange={event => updateColor(event.currentTarget.value)}
197
+ />
198
+ </div>
199
+ </div>
200
+
201
+ <style>
202
+ .theme-color-picker button {
203
+ border-color: var(--soft-border, color-mix(in oklab, var(--color-base-content) 12%, transparent));
204
+ background: var(--soft-surface, var(--color-base-100));
205
+ color: var(--soft-text-body, var(--color-base-content));
206
+ box-shadow: none;
207
+ font-weight: 500;
208
+ }
209
+
210
+ .theme-color-picker button:hover:not(:disabled) {
211
+ border-color: color-mix(in oklab, var(--color-primary) 28%, var(--soft-border, transparent) 72%);
212
+ background: color-mix(
213
+ in oklab,
214
+ var(--soft-surface, var(--color-base-100)) 88%,
215
+ var(--color-base-200) 12%
216
+ );
217
+ }
218
+
219
+ .theme-color-picker button[aria-pressed='true'] {
220
+ border-color: color-mix(in oklab, var(--color-primary) 42%, var(--soft-border, transparent) 58%);
221
+ background: color-mix(
222
+ in oklab,
223
+ var(--color-primary) 10%,
224
+ var(--soft-surface, var(--color-base-100)) 90%
225
+ );
226
+ color: var(--color-primary);
227
+ }
228
+
229
+ .theme-color-picker button:focus,
230
+ .theme-color-picker button:focus-visible {
231
+ outline: none;
232
+ border-color: color-mix(in oklab, var(--color-primary) 48%, var(--soft-border, transparent) 52%);
233
+ box-shadow: 0 0 0 4px color-mix(in oklab, var(--color-primary) 12%, transparent 88%);
234
+ }
235
+
236
+ .theme-color-picker button > span:first-child {
237
+ border-color: color-mix(in oklab, var(--color-base-content) 10%, transparent 90%);
238
+ box-shadow: none;
239
+ }
240
+ </style>
@@ -0,0 +1,57 @@
1
+ import type { DataAttributes } from '../../../types.js';
2
+ /**
3
+ * 主题色选择器的显示名称与 Hex 值。
4
+ *
5
+ * @example 模块内部上下文
6
+ * ```ts
7
+ * const example: ThemeColorPreset = { value: '#2563eb', label: '蓝色' }
8
+ * ```
9
+ */
10
+ interface ThemeColorPreset {
11
+ value: string;
12
+ label: string;
13
+ }
14
+ /**
15
+ * ThemeColorPicker 组件的属性契约;通过公开组件配置使用。
16
+ *
17
+ * @example
18
+ * ```ts
19
+ * import { mount, unmount } from 'svelte'
20
+ * import type { ComponentProps } from 'svelte'
21
+ * import { ThemeColorPicker } from '@h-ai/ui'
22
+ * const props: ComponentProps<typeof ThemeColorPicker> = { value: '#2563eb', presets: [{ value: '#2563eb', label: '蓝色' }] }
23
+ * const component = mount(ThemeColorPicker, { target: document.body, props })
24
+ * await unmount(component)
25
+ * ```
26
+ */
27
+ interface Props {
28
+ value?: string;
29
+ presets?: ThemeColorPreset[];
30
+ disabled?: boolean;
31
+ onchange?: (color: string) => void;
32
+ pickerLabel?: string;
33
+ customLabel?: string;
34
+ class?: string;
35
+ }
36
+ type $$ComponentProps = Props & DataAttributes;
37
+ /**
38
+ * ThemeColorPicker
39
+ * 主题色选择器,提供预置主题色与原生取色盘能力。
40
+ *
41
+ * @prop {string} value - 当前选中的颜色值(Hex)
42
+ * @prop {Array<{ value: string, label: string }>} presets - 预置主题色列表
43
+ * @prop {function} onchange - 颜色变更回调
44
+ *
45
+ * @example
46
+ * ```ts
47
+ * import { mount, unmount } from 'svelte'
48
+ * import type { ComponentProps } from 'svelte'
49
+ * import { ThemeColorPicker } from '@h-ai/ui'
50
+ * const props: ComponentProps<typeof ThemeColorPicker> = { value: '#2563eb', presets: [{ value: '#2563eb', label: '蓝色' }] }
51
+ * const component = mount(ThemeColorPicker, { target: document.body, props })
52
+ * await unmount(component)
53
+ * ```
54
+ */
55
+ declare const ThemeColorPicker: import("svelte").Component<$$ComponentProps, {}, "">;
56
+ type ThemeColorPicker = ReturnType<typeof ThemeColorPicker>;
57
+ export default ThemeColorPicker;
@@ -8,26 +8,44 @@
8
8
  @prop {boolean} grouped - 是否按分组显示
9
9
 
10
10
  @example
11
- <ThemeSelector
12
- currentTheme={$theme}
13
- onchange={(theme) => setTheme(theme)}
14
- showPreview
15
- grouped
16
- />
11
+ ```ts
12
+ import { mount, unmount } from 'svelte'
13
+ import type { ComponentProps } from 'svelte'
14
+ import { ThemeSelector } from '@h-ai/ui'
15
+ const props: ComponentProps<typeof ThemeSelector> = { currentTheme: 'light', grouped: true }
16
+ const component = mount(ThemeSelector, { target: document.body, props })
17
+ await unmount(component)
18
+ ```
17
19
  -->
18
20
  <script lang='ts'>
19
21
  import type { ThemeInfo } from '../../../theme-config.js'
22
+ import type { DataAttributes } from '../../../types.js'
23
+ import { tick } from 'svelte'
20
24
  import { uiM } from '../../../messages.js'
21
25
  import { THEME_GROUPS, THEMES } from '../../../theme-config.js'
22
- import { cn } from '../../../utils.js'
23
- import BareButton from '../../primitives/BareButton.svelte'
26
+ import { cn, getDataAttributes } from '../../../utils.js'
24
27
 
28
+ /**
29
+ * ThemeSelector 组件的属性契约;通过公开组件配置使用。
30
+ *
31
+ * @example
32
+ * ```ts
33
+ * import { mount, unmount } from 'svelte'
34
+ * import type { ComponentProps } from 'svelte'
35
+ * import { ThemeSelector } from '@h-ai/ui'
36
+ * const props: ComponentProps<typeof ThemeSelector> = { currentTheme: 'light', grouped: true }
37
+ * const component = mount(ThemeSelector, { target: document.body, props })
38
+ * await unmount(component)
39
+ * ```
40
+ */
25
41
  interface Props {
26
42
  currentTheme?: string
27
43
  /** 选择主题按钮的 aria-label */
28
44
  selectLabel?: string
29
45
  onchange?: (theme: string) => void
30
46
  showPreview?: boolean
47
+ /** 下拉菜单水平对齐方式 */
48
+ align?: 'start' | 'end'
31
49
  /** 紧凑模式:仅显示预览色块,适用于移动端头部 */
32
50
  compact?: boolean
33
51
  grouped?: boolean
@@ -39,12 +57,16 @@
39
57
  selectLabel,
40
58
  onchange,
41
59
  showPreview = true,
60
+ align = 'end',
42
61
  compact = false,
43
62
  grouped = true,
44
63
  class: className = '',
45
- }: Props = $props()
64
+ ...restProps
65
+ }: Props & DataAttributes = $props()
46
66
 
67
+ const dataAttributes = $derived(getDataAttributes(restProps))
47
68
  const displaySelectLabel = $derived(selectLabel ?? uiM('theme_selector_label'))
69
+ const menuId = $props.id()
48
70
 
49
71
  let open = $state(false)
50
72
  let containerRef = $state<HTMLDivElement | null>(null)
@@ -56,6 +78,32 @@
56
78
  function selectTheme(themeId: string) {
57
79
  onchange?.(themeId)
58
80
  open = false
81
+ containerRef?.querySelector('button')?.focus()
82
+ }
83
+
84
+ async function handleKeydown(event: KeyboardEvent) {
85
+ if (event.key === 'Escape' && open) {
86
+ event.preventDefault()
87
+ event.stopPropagation()
88
+ open = false
89
+ containerRef?.querySelector('button')?.focus()
90
+ return
91
+ }
92
+ if (!['ArrowDown', 'ArrowUp', 'Home', 'End'].includes(event.key))
93
+ return
94
+ event.preventDefault()
95
+ const opening = !open
96
+ open = true
97
+ await tick()
98
+ const choices = [...containerRef?.querySelectorAll<HTMLButtonElement>('[data-theme-option]') ?? []]
99
+ const current = choices.findIndex(button => button === document.activeElement)
100
+ const selected = choices.findIndex(button => button.dataset.themeOption === currentTheme)
101
+ const index = event.key === 'Home' ? 0 : event.key === 'End' ? choices.length - 1 : opening ? Math.max(0, selected) : (current + (event.key === 'ArrowDown' ? 1 : -1) + choices.length) % choices.length
102
+ choices[index]?.focus()
103
+ }
104
+
105
+ function themeName(theme: ThemeInfo): string {
106
+ return theme.id === 'high-contrast' ? uiM('theme_high_contrast') : theme.id === 'formal' ? uiM('theme_formal') : theme.id === 'eye-care' ? uiM('theme_eye_care') : theme.name
59
107
  }
60
108
 
61
109
  function renderThemePreview(theme: ThemeInfo) {
@@ -65,7 +113,7 @@
65
113
  `
66
114
  }
67
115
 
68
- function handleClickOutside(event: MouseEvent) {
116
+ function handleClickOutside(event: MouseEvent | FocusEvent) {
69
117
  if (containerRef && !containerRef.contains(event.target as Node)) {
70
118
  open = false
71
119
  }
@@ -74,18 +122,25 @@
74
122
  $effect(() => {
75
123
  if (open) {
76
124
  document.addEventListener('click', handleClickOutside)
77
- return () => document.removeEventListener('click', handleClickOutside)
125
+ document.addEventListener('focusin', handleClickOutside)
126
+ return () => {
127
+ document.removeEventListener('click', handleClickOutside)
128
+ document.removeEventListener('focusin', handleClickOutside)
129
+ }
78
130
  }
79
131
  return undefined
80
132
  })
81
133
  </script>
82
134
 
83
- <div bind:this={containerRef} class='dropdown dropdown-end {open ? 'dropdown-open' : ''} {className}'>
84
- <BareButton
135
+ <div {...dataAttributes} bind:this={containerRef} class={cn('dropdown', align === 'end' ? 'dropdown-end' : '', open ? 'dropdown-open' : '', className)}>
136
+ <button
85
137
  type='button'
86
138
  class='btn btn-ghost {compact ? 'btn-sm btn-square' : 'gap-2'}'
87
139
  onclick={() => (open = !open)}
88
- ariaLabel={displaySelectLabel}
140
+ onkeydown={handleKeydown}
141
+ aria-label={displaySelectLabel}
142
+ aria-expanded={open}
143
+ aria-controls={menuId}
89
144
  >
90
145
  <!-- 当前主题预览 -->
91
146
  {#if showPreview}
@@ -95,35 +150,38 @@
95
150
  ></div>
96
151
  {/if}
97
152
  {#if !compact}
98
- <span class='text-sm'>{currentInfo.name}</span>
153
+ <span class='text-sm'>{themeName(currentInfo)}</span>
99
154
  <!-- 下拉箭头 -->
100
155
  <svg xmlns='http://www.w3.org/2000/svg' class='h-4 w-4' viewBox='0 0 24 24' fill='none' stroke='currentColor' stroke-width='2'>
101
156
  <path stroke-linecap='round' stroke-linejoin='round' d='M19 9l-7 7-7-7' />
102
157
  </svg>
103
158
  {/if}
104
- </BareButton>
159
+ </button>
105
160
 
106
161
  {#if open}
107
162
  <!-- 主题列表 -->
108
- <div class='dropdown-content bg-base-100 rounded-box shadow-xl border border-base-content/10 z-50 p-4 max-h-[80vh] overflow-y-auto {compact ? 'w-56 right-0' : ''}'>
163
+ <div id={menuId} class='dropdown-content bg-base-100 rounded-box shadow-xl border border-base-content/10 z-50 p-4 max-h-[80vh] overflow-y-auto {compact ? 'w-56 right-0' : ''}'>
109
164
  {#if grouped}
110
165
  <!-- 分组显示 -->
111
- {#each THEME_GROUPS as group}
166
+ {#each THEME_GROUPS as group (group.nameKey)}
112
167
  <div class='mb-4 last:mb-0'>
113
168
  <div class='text-xs font-semibold text-base-content/50 uppercase tracking-wider px-2 mb-2'>
114
169
  {uiM(group.nameKey)}
115
170
  </div>
116
171
  <div class='flex flex-wrap gap-2'>
117
172
  {#each group.themes as theme (theme.id)}
118
- <BareButton
173
+ <button
119
174
  type='button'
120
175
  class={cn(
121
- 'flex items-center gap-2 px-3 py-1.5 rounded-lg text-left transition-colors w-28',
176
+ 'flex min-w-28 max-w-full items-center gap-2 px-3 py-1.5 rounded-lg text-left transition-colors',
122
177
  theme.id === currentTheme
123
178
  ? 'bg-primary/10 text-primary ring-1 ring-primary/30'
124
179
  : 'hover:bg-base-200',
125
180
  )}
126
181
  onclick={() => selectTheme(theme.id)}
182
+ onkeydown={handleKeydown}
183
+ data-theme-option={theme.id}
184
+ aria-pressed={theme.id === currentTheme}
127
185
  >
128
186
  <!-- 主题预览色块 -->
129
187
  <div
@@ -131,14 +189,14 @@
131
189
  style={renderThemePreview(theme)}
132
190
  ></div>
133
191
  <!-- 主题名称 -->
134
- <span class='text-sm whitespace-nowrap'>{theme.name}</span>
192
+ <span class='text-sm'>{themeName(theme)}</span>
135
193
  <!-- 选中标记 -->
136
194
  {#if theme.id === currentTheme}
137
195
  <svg xmlns='http://www.w3.org/2000/svg' class='h-4 w-4 text-primary shrink-0' viewBox='0 0 24 24' fill='none' stroke='currentColor' stroke-width='2'>
138
196
  <path stroke-linecap='round' stroke-linejoin='round' d='M5 13l4 4L19 7' />
139
197
  </svg>
140
198
  {/if}
141
- </BareButton>
199
+ </button>
142
200
  {/each}
143
201
  </div>
144
202
  </div>
@@ -147,27 +205,30 @@
147
205
  <!-- 平铺显示 -->
148
206
  <div class='flex flex-wrap gap-2'>
149
207
  {#each THEMES as theme (theme.id)}
150
- <BareButton
208
+ <button
151
209
  type='button'
152
210
  class={cn(
153
- 'flex items-center gap-2 px-3 py-1.5 rounded-lg text-left transition-colors w-28',
211
+ 'flex min-w-28 max-w-full items-center gap-2 px-3 py-1.5 rounded-lg text-left transition-colors',
154
212
  theme.id === currentTheme
155
213
  ? 'bg-primary/10 text-primary ring-1 ring-primary/30'
156
214
  : 'hover:bg-base-200',
157
215
  )}
158
216
  onclick={() => selectTheme(theme.id)}
217
+ onkeydown={handleKeydown}
218
+ data-theme-option={theme.id}
219
+ aria-pressed={theme.id === currentTheme}
159
220
  >
160
221
  <div
161
222
  class='w-4 h-4 rounded border shrink-0'
162
223
  style={renderThemePreview(theme)}
163
224
  ></div>
164
- <span class='text-sm whitespace-nowrap'>{theme.name}</span>
225
+ <span class='text-sm'>{themeName(theme)}</span>
165
226
  {#if theme.id === currentTheme}
166
227
  <svg xmlns='http://www.w3.org/2000/svg' class='h-4 w-4 text-primary shrink-0' viewBox='0 0 24 24' fill='none' stroke='currentColor' stroke-width='2'>
167
228
  <path stroke-linecap='round' stroke-linejoin='round' d='M5 13l4 4L19 7' />
168
229
  </svg>
169
230
  {/if}
170
- </BareButton>
231
+ </button>
171
232
  {/each}
172
233
  </div>
173
234
  {/if}
@@ -1,14 +1,31 @@
1
+ import type { DataAttributes } from '../../../types.js';
2
+ /**
3
+ * ThemeSelector 组件的属性契约;通过公开组件配置使用。
4
+ *
5
+ * @example
6
+ * ```ts
7
+ * import { mount, unmount } from 'svelte'
8
+ * import type { ComponentProps } from 'svelte'
9
+ * import { ThemeSelector } from '@h-ai/ui'
10
+ * const props: ComponentProps<typeof ThemeSelector> = { currentTheme: 'light', grouped: true }
11
+ * const component = mount(ThemeSelector, { target: document.body, props })
12
+ * await unmount(component)
13
+ * ```
14
+ */
1
15
  interface Props {
2
16
  currentTheme?: string;
3
17
  /** 选择主题按钮的 aria-label */
4
18
  selectLabel?: string;
5
19
  onchange?: (theme: string) => void;
6
20
  showPreview?: boolean;
21
+ /** 下拉菜单水平对齐方式 */
22
+ align?: 'start' | 'end';
7
23
  /** 紧凑模式:仅显示预览色块,适用于移动端头部 */
8
24
  compact?: boolean;
9
25
  grouped?: boolean;
10
26
  class?: string;
11
27
  }
28
+ type $$ComponentProps = Props & DataAttributes;
12
29
  /**
13
30
  * ThemeSelector
14
31
  * 主题选择器组件,支持内置主题集合的选择和预览。
@@ -19,13 +36,15 @@ interface Props {
19
36
  * @prop {boolean} grouped - 是否按分组显示
20
37
  *
21
38
  * @example
22
- * <ThemeSelector
23
- * currentTheme={$theme}
24
- * onchange={(theme) => setTheme(theme)}
25
- * showPreview
26
- * grouped
27
- * />
39
+ * ```ts
40
+ * import { mount, unmount } from 'svelte'
41
+ * import type { ComponentProps } from 'svelte'
42
+ * import { ThemeSelector } from '@h-ai/ui'
43
+ * const props: ComponentProps<typeof ThemeSelector> = { currentTheme: 'light', grouped: true }
44
+ * const component = mount(ThemeSelector, { target: document.body, props })
45
+ * await unmount(component)
46
+ * ```
28
47
  */
29
- declare const ThemeSelector: import("svelte").Component<Props, {}, "">;
48
+ declare const ThemeSelector: import("svelte").Component<$$ComponentProps, {}, "">;
30
49
  type ThemeSelector = ReturnType<typeof ThemeSelector>;
31
50
  export default ThemeSelector;
@@ -8,16 +8,35 @@
8
8
  @prop {string} darkTheme - 暗色主题名称
9
9
 
10
10
  @example
11
- <ThemeToggle
12
- currentTheme={$theme}
13
- onchange={(theme) => themeStore.set(theme)}
14
- />
11
+ ```ts
12
+ import { mount, unmount } from 'svelte'
13
+ import type { ComponentProps } from 'svelte'
14
+ import { ThemeToggle } from '@h-ai/ui'
15
+ const props: ComponentProps<typeof ThemeToggle> = { currentTheme: 'light', lightTheme: 'light', darkTheme: 'dark' }
16
+ const component = mount(ThemeToggle, { target: document.body, props })
17
+ await unmount(component)
18
+ ```
15
19
  -->
16
20
  <script lang='ts'>
21
+ import type { DataAttributes } from '../../../types.js'
17
22
  import { uiM } from '../../../messages.js'
18
23
  import { isDarkTheme } from '../../../theme-config.js'
24
+ import { getDataAttributes } from '../../../utils.js'
19
25
  import IconButton from '../../primitives/IconButton.svelte'
20
26
 
27
+ /**
28
+ * ThemeToggle 组件的属性契约;通过公开组件配置使用。
29
+ *
30
+ * @example
31
+ * ```ts
32
+ * import { mount, unmount } from 'svelte'
33
+ * import type { ComponentProps } from 'svelte'
34
+ * import { ThemeToggle } from '@h-ai/ui'
35
+ * const props: ComponentProps<typeof ThemeToggle> = { currentTheme: 'light', lightTheme: 'light', darkTheme: 'dark' }
36
+ * const component = mount(ThemeToggle, { target: document.body, props })
37
+ * await unmount(component)
38
+ * ```
39
+ */
21
40
  interface Props {
22
41
  currentTheme?: string
23
42
  onchange?: (theme: string) => void
@@ -37,8 +56,10 @@
37
56
  darkTheme = 'dark',
38
57
  labels = {},
39
58
  class: className = '',
40
- }: Props = $props()
59
+ ...restProps
60
+ }: Props & DataAttributes = $props()
41
61
 
62
+ const dataAttributes = $derived(getDataAttributes(restProps))
42
63
  // labels 优先,缺省回退到内置文案
43
64
  const isDark = $derived(isDarkTheme(currentTheme))
44
65
 
@@ -48,7 +69,7 @@
48
69
  }
49
70
  </script>
50
71
 
51
- <div class='tooltip tooltip-bottom {className}' data-tip={isDark ? (labels.switchToLight ?? uiM('theme_switch_to_light')) : (labels.switchToDark ?? uiM('theme_switch_to_dark'))}>
72
+ <div {...dataAttributes} class='tooltip tooltip-bottom {className}' data-tip={isDark ? (labels.switchToLight ?? uiM('theme_switch_to_light')) : (labels.switchToDark ?? uiM('theme_switch_to_dark'))}>
52
73
  <IconButton
53
74
  variant='ghost'
54
75
  size='sm'