@h-ai/ui 0.1.0-alpha9 → 1.0.0-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (367) hide show
  1. package/README.en.md +1036 -0
  2. package/README.ja.md +1036 -0
  3. package/README.md +670 -119
  4. package/auto-import.d.ts +45 -0
  5. package/auto-import.js +46 -69
  6. package/dist/components/compounds/Accordion.svelte +30 -3
  7. package/dist/components/compounds/Accordion.svelte.d.ts +37 -1
  8. package/dist/components/compounds/ActionSheet.svelte +35 -8
  9. package/dist/components/compounds/ActionSheet.svelte.d.ts +41 -1
  10. package/dist/components/compounds/Alert.svelte +24 -15
  11. package/dist/components/compounds/Alert.svelte.d.ts +14 -3
  12. package/dist/components/compounds/AppBar.svelte +37 -9
  13. package/dist/components/compounds/AppBar.svelte.d.ts +36 -1
  14. package/dist/components/compounds/BottomNav.svelte +68 -8
  15. package/dist/components/compounds/BottomNav.svelte.d.ts +51 -1
  16. package/dist/components/compounds/Breadcrumb.svelte +18 -5
  17. package/dist/components/compounds/Breadcrumb.svelte.d.ts +23 -2
  18. package/dist/components/compounds/Calendar.svelte +31 -12
  19. package/dist/components/compounds/Calendar.svelte.d.ts +23 -7
  20. package/dist/components/compounds/Card.svelte +17 -5
  21. package/dist/components/compounds/Card.svelte.d.ts +13 -2
  22. package/dist/components/compounds/Combobox.svelte +124 -42
  23. package/dist/components/compounds/Combobox.svelte.d.ts +42 -20
  24. package/dist/components/compounds/Confirm.svelte +32 -9
  25. package/dist/components/compounds/Confirm.svelte.d.ts +24 -2
  26. package/dist/components/compounds/DataTable.svelte +317 -33
  27. package/dist/components/compounds/DataTable.svelte.d.ts +28 -14
  28. package/dist/components/compounds/DatePicker.svelte +62 -18
  29. package/dist/components/compounds/DatePicker.svelte.d.ts +27 -8
  30. package/dist/components/compounds/Drawer.svelte +179 -22
  31. package/dist/components/compounds/Drawer.svelte.d.ts +24 -2
  32. package/dist/components/compounds/Dropdown.svelte +19 -5
  33. package/dist/components/compounds/Dropdown.svelte.d.ts +13 -2
  34. package/dist/components/compounds/Empty.svelte +22 -9
  35. package/dist/components/compounds/Empty.svelte.d.ts +23 -2
  36. package/dist/components/compounds/FilterBar.svelte +82 -0
  37. package/dist/components/compounds/FilterBar.svelte.d.ts +39 -0
  38. package/dist/components/compounds/Form.svelte +59 -16
  39. package/dist/components/compounds/Form.svelte.d.ts +23 -2
  40. package/dist/components/compounds/FormField.svelte +99 -16
  41. package/dist/components/compounds/FormField.svelte.d.ts +23 -2
  42. package/dist/components/compounds/FormLayout.svelte +71 -0
  43. package/dist/components/compounds/FormLayout.svelte.d.ts +17 -0
  44. package/dist/components/compounds/InfiniteScroll.svelte +34 -7
  45. package/dist/components/compounds/InfiniteScroll.svelte.d.ts +37 -1
  46. package/dist/components/compounds/JsonViewer.svelte +214 -0
  47. package/dist/components/compounds/JsonViewer.svelte.d.ts +26 -0
  48. package/dist/components/compounds/MessageBoxContainer.svelte +34 -0
  49. package/dist/components/compounds/MessageBoxContainer.svelte.d.ts +25 -0
  50. package/dist/components/compounds/MessageBoxDialog.svelte +209 -0
  51. package/dist/components/compounds/MessageBoxDialog.svelte.d.ts +29 -0
  52. package/dist/components/compounds/MessageContainer.svelte +24 -0
  53. package/dist/components/compounds/MessageContainer.svelte.d.ts +18 -0
  54. package/dist/components/compounds/Modal.svelte +348 -73
  55. package/dist/components/compounds/Modal.svelte.d.ts +13 -2
  56. package/dist/components/compounds/PageHeader.svelte +44 -20
  57. package/dist/components/compounds/PageHeader.svelte.d.ts +24 -9
  58. package/dist/components/compounds/Pagination.svelte +139 -105
  59. package/dist/components/compounds/Pagination.svelte.d.ts +23 -2
  60. package/dist/components/compounds/Popover.svelte +124 -25
  61. package/dist/components/compounds/Popover.svelte.d.ts +23 -2
  62. package/dist/components/compounds/PullRefresh.svelte +35 -8
  63. package/dist/components/compounds/PullRefresh.svelte.d.ts +35 -1
  64. package/dist/components/compounds/Result.svelte +17 -4
  65. package/dist/components/compounds/Result.svelte.d.ts +23 -2
  66. package/dist/components/compounds/SafeArea.svelte +30 -3
  67. package/dist/components/compounds/SafeArea.svelte.d.ts +35 -1
  68. package/dist/components/compounds/Skeleton.svelte +19 -7
  69. package/dist/components/compounds/Skeleton.svelte.d.ts +13 -2
  70. package/dist/components/compounds/Steps.svelte +17 -4
  71. package/dist/components/compounds/Steps.svelte.d.ts +23 -2
  72. package/dist/components/compounds/SwipeCell.svelte +30 -3
  73. package/dist/components/compounds/SwipeCell.svelte.d.ts +40 -1
  74. package/dist/components/compounds/TableToolbar.svelte +289 -0
  75. package/dist/components/compounds/TableToolbar.svelte.d.ts +69 -0
  76. package/dist/components/compounds/Tabs.svelte +84 -14
  77. package/dist/components/compounds/Tabs.svelte.d.ts +13 -2
  78. package/dist/components/compounds/TagInput.svelte +51 -33
  79. package/dist/components/compounds/TagInput.svelte.d.ts +23 -2
  80. package/dist/components/compounds/Timeline.svelte +30 -3
  81. package/dist/components/compounds/Timeline.svelte.d.ts +37 -1
  82. package/dist/components/compounds/ToastContainer.svelte +386 -28
  83. package/dist/components/compounds/ToastContainer.svelte.d.ts +27 -1
  84. package/dist/components/compounds/Tooltip.svelte +143 -9
  85. package/dist/components/compounds/Tooltip.svelte.d.ts +25 -2
  86. package/dist/components/compounds/accordion-types.d.ts +10 -1
  87. package/dist/components/compounds/action-sheet-types.d.ts +9 -0
  88. package/dist/components/compounds/bottom-nav-types.d.ts +9 -0
  89. package/dist/components/compounds/index.d.ts +7 -0
  90. package/dist/components/compounds/index.js +11 -0
  91. package/dist/components/compounds/swipe-cell-types.d.ts +9 -0
  92. package/dist/components/compounds/timeline-types.d.ts +9 -0
  93. package/dist/components/control-size.d.ts +35 -0
  94. package/dist/components/control-size.js +26 -0
  95. package/dist/components/primitives/Avatar.svelte +19 -5
  96. package/dist/components/primitives/Avatar.svelte.d.ts +13 -2
  97. package/dist/components/primitives/Badge.svelte +16 -4
  98. package/dist/components/primitives/Badge.svelte.d.ts +13 -2
  99. package/dist/components/primitives/BareButton.svelte +26 -12
  100. package/dist/components/primitives/BareButton.svelte.d.ts +23 -2
  101. package/dist/components/primitives/BareInput.svelte +57 -35
  102. package/dist/components/primitives/BareInput.svelte.d.ts +23 -2
  103. package/dist/components/primitives/Button.svelte +30 -9
  104. package/dist/components/primitives/Button.svelte.d.ts +13 -2
  105. package/dist/components/primitives/Checkbox.svelte +24 -5
  106. package/dist/components/primitives/Checkbox.svelte.d.ts +23 -2
  107. package/dist/components/primitives/IconButton.svelte +35 -10
  108. package/dist/components/primitives/IconButton.svelte.d.ts +23 -2
  109. package/dist/components/primitives/Input.svelte +56 -26
  110. package/dist/components/primitives/Input.svelte.d.ts +13 -2
  111. package/dist/components/primitives/Progress.svelte +17 -4
  112. package/dist/components/primitives/Progress.svelte.d.ts +23 -2
  113. package/dist/components/primitives/Radio.svelte +17 -4
  114. package/dist/components/primitives/Radio.svelte.d.ts +22 -2
  115. package/dist/components/primitives/Range.svelte +31 -4
  116. package/dist/components/primitives/Range.svelte.d.ts +37 -1
  117. package/dist/components/primitives/Rating.svelte +32 -5
  118. package/dist/components/primitives/Rating.svelte.d.ts +37 -1
  119. package/dist/components/primitives/Select.svelte +404 -47
  120. package/dist/components/primitives/Select.svelte.d.ts +23 -2
  121. package/dist/components/primitives/Spinner.svelte +17 -4
  122. package/dist/components/primitives/Spinner.svelte.d.ts +23 -2
  123. package/dist/components/primitives/Switch.svelte +22 -4
  124. package/dist/components/primitives/Switch.svelte.d.ts +23 -2
  125. package/dist/components/primitives/Tag.svelte +17 -4
  126. package/dist/components/primitives/Tag.svelte.d.ts +23 -2
  127. package/dist/components/primitives/Textarea.svelte +75 -30
  128. package/dist/components/primitives/Textarea.svelte.d.ts +24 -2
  129. package/dist/components/primitives/ToggleCheckbox.svelte +24 -10
  130. package/dist/components/primitives/ToggleCheckbox.svelte.d.ts +23 -2
  131. package/dist/components/primitives/ToggleInput.svelte +24 -10
  132. package/dist/components/primitives/ToggleInput.svelte.d.ts +23 -2
  133. package/dist/components/primitives/ToggleRadio.svelte +24 -10
  134. package/dist/components/primitives/ToggleRadio.svelte.d.ts +23 -2
  135. package/dist/components/scenes/ai/AiDocumentDownloadMenu.svelte +54 -23
  136. package/dist/components/scenes/ai/AiDocumentDownloadMenu.svelte.d.ts +30 -1
  137. package/dist/components/scenes/ai/AiDocumentEditor.svelte +3428 -693
  138. package/dist/components/scenes/ai/AiDocumentEditor.svelte.d.ts +26 -1
  139. package/dist/components/scenes/ai/MarkdownRenderer.svelte +119 -116
  140. package/dist/components/scenes/ai/MarkdownRenderer.svelte.d.ts +31 -1
  141. package/dist/components/scenes/ai/code-preview.d.ts +46 -0
  142. package/dist/components/scenes/ai/code-preview.js +141 -0
  143. package/dist/components/scenes/ai/document-download.d.ts +52 -0
  144. package/dist/components/scenes/ai/document-download.js +296 -77
  145. package/dist/components/scenes/ai/document-parse.d.ts +101 -11
  146. package/dist/components/scenes/ai/document-parse.js +212 -48
  147. package/dist/components/scenes/ai/document-types.d.ts +292 -75
  148. package/dist/components/scenes/ai/editor-markdown-extensions.d.ts +27 -0
  149. package/dist/components/scenes/ai/editor-markdown-extensions.js +215 -0
  150. package/dist/components/scenes/ai/highlight.d.ts +37 -0
  151. package/dist/components/scenes/ai/highlight.js +162 -0
  152. package/dist/components/scenes/ai/index.d.ts +5 -2
  153. package/dist/components/scenes/ai/index.js +3 -0
  154. package/dist/components/scenes/ai/markdown-parse.d.ts +11 -3
  155. package/dist/components/scenes/ai/markdown-parse.js +42 -31
  156. package/dist/components/scenes/ai/mermaid-host-sync.d.ts +72 -0
  157. package/dist/components/scenes/ai/mermaid-host-sync.js +65 -0
  158. package/dist/components/scenes/ai/mermaid-render.d.ts +30 -0
  159. package/dist/components/scenes/ai/mermaid-render.js +61 -0
  160. package/dist/components/scenes/ai/safe-html.d.ts +64 -0
  161. package/dist/components/scenes/ai/safe-html.js +345 -0
  162. package/dist/components/scenes/ai/table/AiTableEditor.svelte +1692 -0
  163. package/dist/components/scenes/ai/table/AiTableEditor.svelte.d.ts +32 -0
  164. package/dist/components/scenes/ai/table/table-types.d.ts +181 -0
  165. package/dist/components/scenes/ai/table/table-types.js +1 -0
  166. package/dist/components/scenes/app/FeedbackDetail.svelte +236 -0
  167. package/dist/components/scenes/app/FeedbackDetail.svelte.d.ts +40 -0
  168. package/dist/components/scenes/app/FeedbackForm.svelte +337 -0
  169. package/dist/components/scenes/app/FeedbackForm.svelte.d.ts +72 -0
  170. package/dist/components/scenes/app/FeedbackList.svelte +150 -0
  171. package/dist/components/scenes/app/FeedbackList.svelte.d.ts +28 -0
  172. package/dist/components/scenes/app/FeedbackModal.svelte +65 -139
  173. package/dist/components/scenes/app/FeedbackModal.svelte.d.ts +14 -39
  174. package/dist/components/scenes/app/FeedbackRecorder.svelte +154 -0
  175. package/dist/components/scenes/app/FeedbackRecorder.svelte.d.ts +9 -0
  176. package/dist/components/scenes/app/FeedbackReplay.svelte +142 -0
  177. package/dist/components/scenes/app/FeedbackReplay.svelte.d.ts +7 -0
  178. package/dist/components/scenes/app/FeedbackScreenshot.svelte +120 -0
  179. package/dist/components/scenes/app/FeedbackScreenshot.svelte.d.ts +8 -0
  180. package/dist/components/scenes/app/LanguageSwitch.svelte +38 -21
  181. package/dist/components/scenes/app/LanguageSwitch.svelte.d.ts +33 -20
  182. package/dist/components/scenes/app/SettingsLayout.svelte +115 -0
  183. package/dist/components/scenes/app/SettingsLayout.svelte.d.ts +54 -0
  184. package/dist/components/scenes/app/SettingsModal.svelte +33 -7
  185. package/dist/components/scenes/app/SettingsModal.svelte.d.ts +27 -1
  186. package/dist/components/scenes/app/ThemeColorPicker.svelte +240 -0
  187. package/dist/components/scenes/app/ThemeColorPicker.svelte.d.ts +57 -0
  188. package/dist/components/scenes/app/ThemeSelector.svelte +87 -26
  189. package/dist/components/scenes/app/ThemeSelector.svelte.d.ts +26 -7
  190. package/dist/components/scenes/app/ThemeToggle.svelte +27 -6
  191. package/dist/components/scenes/app/ThemeToggle.svelte.d.ts +24 -5
  192. package/dist/components/scenes/app/WorkspaceLayout.svelte +64 -0
  193. package/dist/components/scenes/app/WorkspaceLayout.svelte.d.ts +36 -0
  194. package/dist/components/scenes/app/feedback-functions.d.ts +57 -0
  195. package/dist/components/scenes/app/feedback-functions.js +107 -0
  196. package/dist/components/scenes/app/feedback-types.d.ts +224 -0
  197. package/dist/components/scenes/app/feedback-types.js +1 -0
  198. package/dist/components/scenes/app/index.d.ts +8 -1
  199. package/dist/components/scenes/app/index.js +7 -1
  200. package/dist/components/scenes/charts/Chart.svelte +163 -0
  201. package/dist/components/scenes/charts/Chart.svelte.d.ts +25 -0
  202. package/dist/components/scenes/charts/chart-theme.d.ts +47 -0
  203. package/dist/components/scenes/charts/chart-theme.js +68 -0
  204. package/dist/components/scenes/charts/chart-types.d.ts +153 -0
  205. package/dist/components/scenes/charts/chart-types.js +7 -0
  206. package/dist/components/scenes/charts/index.d.ts +8 -0
  207. package/dist/components/scenes/charts/index.js +7 -0
  208. package/dist/components/scenes/charts/renderers/AreaChart.svelte +18 -0
  209. package/dist/components/scenes/charts/renderers/AreaChart.svelte.d.ts +5 -0
  210. package/dist/components/scenes/charts/renderers/BarChart.svelte +18 -0
  211. package/dist/components/scenes/charts/renderers/BarChart.svelte.d.ts +5 -0
  212. package/dist/components/scenes/charts/renderers/LineChart.svelte +624 -0
  213. package/dist/components/scenes/charts/renderers/LineChart.svelte.d.ts +32 -0
  214. package/dist/components/scenes/charts/renderers/PieChart.svelte +18 -0
  215. package/dist/components/scenes/charts/renderers/PieChart.svelte.d.ts +5 -0
  216. package/dist/components/scenes/charts/renderers/ScatterChart.svelte +18 -0
  217. package/dist/components/scenes/charts/renderers/ScatterChart.svelte.d.ts +5 -0
  218. package/dist/components/scenes/crud/CrudDeleteConfirm.svelte +29 -11
  219. package/dist/components/scenes/crud/CrudDeleteConfirm.svelte.d.ts +13 -1
  220. package/dist/components/scenes/crud/CrudDetailDrawer.svelte +77 -22
  221. package/dist/components/scenes/crud/CrudDetailDrawer.svelte.d.ts +19 -4
  222. package/dist/components/scenes/crud/CrudDetailPanel.svelte +242 -0
  223. package/dist/components/scenes/crud/CrudDetailPanel.svelte.d.ts +66 -0
  224. package/dist/components/scenes/crud/CrudEditPanel.svelte +365 -0
  225. package/dist/components/scenes/crud/CrudEditPanel.svelte.d.ts +48 -0
  226. package/dist/components/scenes/crud/CrudFilterBar.svelte +17 -85
  227. package/dist/components/scenes/crud/CrudFilterBar.svelte.d.ts +13 -25
  228. package/dist/components/scenes/crud/CrudPage.svelte +564 -185
  229. package/dist/components/scenes/crud/CrudPage.svelte.d.ts +137 -51
  230. package/dist/components/scenes/crud/crud-controller.svelte.d.ts +335 -0
  231. package/dist/components/scenes/crud/crud-controller.svelte.js +276 -0
  232. package/dist/components/scenes/crud/crud-form-validation.d.ts +16 -0
  233. package/dist/components/scenes/crud/crud-form-validation.js +51 -0
  234. package/dist/components/scenes/crud/crud-types.d.ts +136 -43
  235. package/dist/components/scenes/crud/index.d.ts +9 -3
  236. package/dist/components/scenes/crud/index.js +8 -3
  237. package/dist/components/scenes/crud/nav-adapter.d.ts +50 -0
  238. package/dist/components/scenes/crud/nav-adapter.js +39 -0
  239. package/dist/components/scenes/crypto/EncryptedInput.svelte +63 -28
  240. package/dist/components/scenes/crypto/EncryptedInput.svelte.d.ts +38 -3
  241. package/dist/components/scenes/crypto/HashDisplay.svelte +30 -22
  242. package/dist/components/scenes/crypto/HashDisplay.svelte.d.ts +24 -1
  243. package/dist/components/scenes/crypto/SignatureDisplay.svelte +41 -40
  244. package/dist/components/scenes/crypto/SignatureDisplay.svelte.d.ts +24 -1
  245. package/dist/components/scenes/error/ErrorPage.svelte +135 -0
  246. package/dist/components/scenes/error/ErrorPage.svelte.d.ts +50 -0
  247. package/dist/components/scenes/error/error-presets.d.ts +60 -0
  248. package/dist/components/scenes/error/error-presets.js +51 -0
  249. package/dist/components/scenes/error/index.d.ts +8 -0
  250. package/dist/components/scenes/error/index.js +8 -0
  251. package/dist/components/scenes/guide/GuideHost.svelte +56 -0
  252. package/dist/components/scenes/guide/GuideHost.svelte.d.ts +35 -0
  253. package/dist/components/scenes/guide/GuideHostContent.svelte +136 -0
  254. package/dist/components/scenes/guide/GuideHostContent.svelte.d.ts +43 -0
  255. package/dist/components/scenes/guide/HelpCenter.svelte +135 -0
  256. package/dist/components/scenes/guide/HelpCenter.svelte.d.ts +40 -0
  257. package/dist/components/scenes/guide/index.d.ts +2 -0
  258. package/dist/components/scenes/guide/index.js +2 -0
  259. package/dist/components/scenes/iam/AgreementNotice.svelte +48 -0
  260. package/dist/components/scenes/iam/AgreementNotice.svelte.d.ts +7 -0
  261. package/dist/components/scenes/iam/AuthPanel.svelte +226 -0
  262. package/dist/components/scenes/iam/AuthPanel.svelte.d.ts +29 -0
  263. package/dist/components/scenes/iam/AuthShell.svelte +160 -0
  264. package/dist/components/scenes/iam/AuthShell.svelte.d.ts +56 -0
  265. package/dist/components/scenes/iam/ChangePasswordForm.svelte +84 -63
  266. package/dist/components/scenes/iam/ChangePasswordForm.svelte.d.ts +13 -1
  267. package/dist/components/scenes/iam/ForgotPasswordForm.svelte +113 -89
  268. package/dist/components/scenes/iam/ForgotPasswordForm.svelte.d.ts +24 -1
  269. package/dist/components/scenes/iam/LoginForm.svelte +215 -117
  270. package/dist/components/scenes/iam/LoginForm.svelte.d.ts +13 -1
  271. package/dist/components/scenes/iam/PasswordInput.svelte +79 -32
  272. package/dist/components/scenes/iam/PasswordInput.svelte.d.ts +30 -4
  273. package/dist/components/scenes/iam/PermGuard.svelte +21 -11
  274. package/dist/components/scenes/iam/PermGuard.svelte.d.ts +30 -0
  275. package/dist/components/scenes/iam/ReauthenticationDialog.svelte +68 -0
  276. package/dist/components/scenes/iam/ReauthenticationDialog.svelte.d.ts +17 -0
  277. package/dist/components/scenes/iam/RegisterForm.svelte +129 -116
  278. package/dist/components/scenes/iam/RegisterForm.svelte.d.ts +13 -1
  279. package/dist/components/scenes/iam/ResetPasswordForm.svelte +101 -88
  280. package/dist/components/scenes/iam/ResetPasswordForm.svelte.d.ts +13 -1
  281. package/dist/components/scenes/iam/SensitiveOperationsForm.svelte +76 -0
  282. package/dist/components/scenes/iam/SensitiveOperationsForm.svelte.d.ts +21 -0
  283. package/dist/components/scenes/iam/SessionRecoveryDialog.svelte +64 -0
  284. package/dist/components/scenes/iam/SessionRecoveryDialog.svelte.d.ts +22 -0
  285. package/dist/components/scenes/iam/UserProfile.svelte +47 -21
  286. package/dist/components/scenes/iam/UserProfile.svelte.d.ts +24 -1
  287. package/dist/components/scenes/iam/auth-captcha.d.ts +21 -0
  288. package/dist/components/scenes/iam/auth-captcha.js +23 -0
  289. package/dist/components/scenes/iam/auth-error-message.d.ts +13 -0
  290. package/dist/components/scenes/iam/auth-error-message.js +65 -0
  291. package/dist/components/scenes/iam/index.d.ts +10 -0
  292. package/dist/components/scenes/iam/index.js +9 -1
  293. package/dist/components/scenes/iam/password-utils.d.ts +33 -6
  294. package/dist/components/scenes/iam/password-utils.js +61 -8
  295. package/dist/components/scenes/iam/permission-context.svelte.d.ts +33 -23
  296. package/dist/components/scenes/iam/permission-context.svelte.js +20 -22
  297. package/dist/components/scenes/iam/sensitive-actions.svelte.d.ts +68 -0
  298. package/dist/components/scenes/iam/sensitive-actions.svelte.js +101 -0
  299. package/dist/components/scenes/iam/session-recovery.svelte.d.ts +44 -0
  300. package/dist/components/scenes/iam/session-recovery.svelte.js +57 -0
  301. package/dist/components/scenes/index.d.ts +3 -0
  302. package/dist/components/scenes/index.js +5 -0
  303. package/dist/components/scenes/storage/AvatarUpload.svelte +82 -68
  304. package/dist/components/scenes/storage/AvatarUpload.svelte.d.ts +23 -1
  305. package/dist/components/scenes/storage/FileList.svelte +19 -5
  306. package/dist/components/scenes/storage/FileList.svelte.d.ts +23 -1
  307. package/dist/components/scenes/storage/FileUpload.svelte +151 -96
  308. package/dist/components/scenes/storage/FileUpload.svelte.d.ts +24 -1
  309. package/dist/components/scenes/storage/ImageUpload.svelte +93 -94
  310. package/dist/components/scenes/storage/ImageUpload.svelte.d.ts +24 -1
  311. package/dist/components/scenes/types.d.ts +574 -42
  312. package/dist/guide-storage.d.ts +18 -0
  313. package/dist/guide-storage.js +79 -0
  314. package/dist/guide-types.d.ts +143 -0
  315. package/dist/guide-types.js +1 -0
  316. package/dist/guide.d.ts +3 -0
  317. package/dist/guide.js +3 -0
  318. package/dist/guide.svelte.d.ts +29 -0
  319. package/dist/guide.svelte.js +506 -0
  320. package/dist/i18n.svelte.d.ts +67 -4
  321. package/dist/i18n.svelte.js +106 -21
  322. package/dist/index.d.ts +6 -0
  323. package/dist/index.js +7 -0
  324. package/dist/internal/browser-safety.d.ts +88 -0
  325. package/dist/internal/browser-safety.js +140 -0
  326. package/dist/internal/dialog-focus.d.ts +21 -0
  327. package/dist/internal/dialog-focus.js +77 -0
  328. package/dist/internal/form-context.d.ts +92 -0
  329. package/dist/internal/form-context.js +70 -0
  330. package/dist/internal/form-validation.svelte.d.ts +70 -0
  331. package/dist/internal/form-validation.svelte.js +142 -0
  332. package/dist/internal/icon-safety.d.ts +14 -0
  333. package/dist/internal/icon-safety.js +40 -0
  334. package/dist/internal/locale.d.ts +21 -0
  335. package/dist/internal/locale.js +43 -0
  336. package/dist/message.svelte.d.ts +138 -0
  337. package/dist/message.svelte.js +149 -0
  338. package/dist/messagebox.svelte.d.ts +130 -0
  339. package/dist/messagebox.svelte.js +171 -0
  340. package/dist/messages/en-US.json +297 -16
  341. package/dist/messages/ja-JP.json +523 -0
  342. package/dist/messages/zh-CN.json +297 -16
  343. package/dist/messages.d.ts +25 -3
  344. package/dist/messages.js +23 -6
  345. package/dist/styles/design-tokens.css +4 -2
  346. package/dist/styles/formal.css +55 -0
  347. package/dist/styles/global.css +86 -18
  348. package/dist/styles/guide.css +88 -0
  349. package/dist/styles/high-contrast.css +64 -0
  350. package/dist/styles/mobile.css +28 -0
  351. package/dist/styles/theme.css +42 -0
  352. package/dist/theme-config.d.ts +263 -10
  353. package/dist/theme-config.js +252 -17
  354. package/dist/toast.svelte.d.ts +210 -2
  355. package/dist/toast.svelte.js +296 -19
  356. package/dist/types.d.ts +787 -63
  357. package/dist/utils/platform.svelte.d.ts +28 -15
  358. package/dist/utils/platform.svelte.js +23 -16
  359. package/dist/utils.d.ts +121 -1
  360. package/dist/utils.js +208 -13
  361. package/dist/workspace-context.d.ts +20 -0
  362. package/dist/workspace-context.js +9 -0
  363. package/package.json +120 -24
  364. package/vite.d.ts +13 -0
  365. package/vite.js +96 -0
  366. package/dist/components/scenes/crud/CrudEditDrawer.svelte +0 -225
  367. package/dist/components/scenes/crud/CrudEditDrawer.svelte.d.ts +0 -48
@@ -0,0 +1,120 @@
1
+ <!-- 反馈截图的交互选区;由宿主回调实际遮挡/标注图像。 -->
2
+ <script lang='ts'>
3
+ import type { FeedbackAnnotation, FeedbackAttachmentView } from './feedback-types.js'
4
+ import { uiM } from '../../../messages.js'
5
+ import { errorMessage, useToastFeedback } from '../../../toast.svelte.js'
6
+ import Button from '../../primitives/Button.svelte'
7
+ import { imagePreviewUrl } from './feedback-functions.js'
8
+
9
+ const { attachment, onannotate }: {
10
+ attachment: FeedbackAttachmentView
11
+ onannotate?: (annotation: FeedbackAnnotation) => Promise<void>
12
+ } = $props()
13
+
14
+ let mode = $state<'mask' | 'outline'>('outline')
15
+ let rect = $state({ x: 0.1, y: 0.1, width: 0.2, height: 0.2 })
16
+ let start = $state<{ x: number, y: number } | null>(null)
17
+ let selected = $state(false)
18
+ let loading = $state(false)
19
+ let error = $state('')
20
+ let imageFailed = $state(false)
21
+ useToastFeedback(() => imageFailed ? uiM('feedback_preview_failed') : '', 'warning')
22
+ const url = $derived(imagePreviewUrl(attachment.url))
23
+
24
+ function point(event: PointerEvent & { currentTarget: HTMLDivElement }) {
25
+ const bounds = (event.currentTarget.querySelector('img') ?? event.currentTarget).getBoundingClientRect()
26
+ if (!bounds.width || !bounds.height)
27
+ return { x: 0, y: 0 }
28
+ return { x: Math.max(0, Math.min(1, (event.clientX - bounds.left) / bounds.width)), y: Math.max(0, Math.min(1, (event.clientY - bounds.top) / bounds.height)) }
29
+ }
30
+ function begin(event: PointerEvent & { currentTarget: HTMLDivElement }) {
31
+ if (!onannotate || loading)
32
+ return
33
+ event.preventDefault()
34
+ start = point(event)
35
+ rect = { ...start, width: 0, height: 0 }
36
+ selected = true
37
+ event.currentTarget.setPointerCapture?.(event.pointerId)
38
+ }
39
+ function move(event: PointerEvent & { currentTarget: HTMLDivElement }) {
40
+ if (!start)
41
+ return
42
+ const end = point(event)
43
+ rect = { x: Math.min(start.x, end.x), y: Math.min(start.y, end.y), width: Math.abs(end.x - start.x), height: Math.abs(end.y - start.y) }
44
+ }
45
+ function keydown(event: KeyboardEvent) {
46
+ if (!onannotate || loading)
47
+ return
48
+ if (event.key === 'Enter' || event.key === ' ') {
49
+ event.preventDefault()
50
+ selected = true
51
+ return
52
+ }
53
+ if (!['ArrowLeft', 'ArrowRight', 'ArrowUp', 'ArrowDown'].includes(event.key))
54
+ return
55
+ event.preventDefault()
56
+ selected = true
57
+ const dx = event.key === 'ArrowLeft' ? -0.01 : event.key === 'ArrowRight' ? 0.01 : 0
58
+ const dy = event.key === 'ArrowUp' ? -0.01 : event.key === 'ArrowDown' ? 0.01 : 0
59
+ rect = event.shiftKey
60
+ ? { ...rect, width: Math.max(0.01, Math.min(1 - rect.x, rect.width + dx)), height: Math.max(0.01, Math.min(1 - rect.y, rect.height + dy)) }
61
+ : { ...rect, x: Math.max(0, Math.min(1 - rect.width, rect.x + dx)), y: Math.max(0, Math.min(1 - rect.height, rect.y + dy)) }
62
+ }
63
+ function end(event: PointerEvent & { currentTarget: HTMLDivElement }) {
64
+ move(event)
65
+ start = null
66
+ }
67
+ function cancel() {
68
+ start = null
69
+ selected = false
70
+ }
71
+ async function apply() {
72
+ if (!onannotate || loading || !Object.values(rect).every(Number.isFinite) || rect.width <= 0 || rect.height <= 0)
73
+ return
74
+ loading = true
75
+ error = ''
76
+ try {
77
+ await onannotate({ id: attachment.id, mode, rect: { ...rect, width: Math.min(rect.width, 1 - rect.x), height: Math.min(rect.height, 1 - rect.y) } })
78
+ selected = false
79
+ }
80
+ catch (cause) {
81
+ error = errorMessage(cause, uiM('feedback_action_failed'))
82
+ }
83
+ finally {
84
+ loading = false
85
+ }
86
+ }
87
+ useToastFeedback(() => error)
88
+ </script>
89
+
90
+ {#if url}
91
+ <div class='space-y-3 min-w-0'>
92
+ <div class='relative w-fit max-w-full overflow-hidden rounded-lg border border-base-content/10 select-none' role='button' aria-label={attachment.name} aria-disabled={!onannotate} tabindex={onannotate ? 0 : -1} onkeydown={keydown} style:touch-action={onannotate ? 'none' : 'auto'} onpointerdown={begin} onpointermove={move} onpointerup={end} onpointercancel={cancel}>
93
+ <img src={url} alt={attachment.name} class='block max-w-full h-auto' draggable='false' referrerpolicy='no-referrer' onerror={() => imageFailed = true} onload={() => imageFailed = false} />
94
+ {#if selected}
95
+ <div class:mask-preview={mode === 'mask'} class='pointer-events-none absolute border-2 border-error' style:left={`${rect.x * 100}%`} style:top={`${rect.y * 100}%`} style:width={`${rect.width * 100}%`} style:height={`${rect.height * 100}%`}></div>
96
+ {/if}
97
+ </div>
98
+ {#if onannotate && !imageFailed}
99
+ <div class='flex flex-wrap gap-2'>
100
+ <Button size='xs' variant={mode === 'outline' ? 'primary' : 'ghost'} onclick={() => {
101
+ mode = 'outline'
102
+ selected = true
103
+ }}>{uiM('feedback_mark_outline')}</Button>
104
+ <Button size='xs' variant={mode === 'mask' ? 'primary' : 'ghost'} onclick={() => {
105
+ mode = 'mask'
106
+ selected = true
107
+ }}>{uiM('feedback_mark_mask')}</Button>
108
+ </div>
109
+ <p class='text-xs text-base-content/60'>{uiM('feedback_mark_hint')}</p>
110
+ <div class='flex flex-wrap gap-2'>
111
+ <Button size='sm' {loading} disabled={!selected || rect.width <= 0 || rect.height <= 0} onclick={apply}>{uiM('feedback_mark_apply')}</Button>
112
+ <Button size='sm' variant='ghost' onclick={() => selected = false}>{uiM('feedback_mark_clear')}</Button>
113
+ </div>
114
+ {/if}
115
+ </div>
116
+ {/if}
117
+
118
+ <style>
119
+ .mask-preview { background: black; }
120
+ </style>
@@ -0,0 +1,8 @@
1
+ import type { FeedbackAnnotation, FeedbackAttachmentView } from './feedback-types.js';
2
+ type $$ComponentProps = {
3
+ attachment: FeedbackAttachmentView;
4
+ onannotate?: (annotation: FeedbackAnnotation) => Promise<void>;
5
+ };
6
+ declare const FeedbackScreenshot: import("svelte").Component<$$ComponentProps, {}, "">;
7
+ type FeedbackScreenshot = ReturnType<typeof FeedbackScreenshot>;
8
+ export default FeedbackScreenshot;
@@ -7,37 +7,48 @@
7
7
  @prop {function} onchange - 语言变更回调,传入选中的语言代码
8
8
 
9
9
  @example
10
- ```svelte
11
- <script>
12
- import { LanguageSwitch, createLocaleStore, setGlobalLocale } from '@h-ai/ui'
13
- import { setLocale, getLocale } from '../../../paraglide/runtime.js'
14
-
15
- const localeStore = createLocaleStore()
16
- </script>
17
-
18
- <LanguageSwitch
19
- currentLanguage={localeStore.current}
20
- languages={[
21
- { value: 'zh-CN', label: '简体中文' },
22
- { value: 'en-US', label: 'English' }
23
- ]}
24
- onchange={(lang) => {
25
- localeStore.set(lang) // 同步到 @h-ai/core 全局 locale
26
- setLocale(lang) // 同步到 Paraglide
27
- }}
28
- />
10
+ ```ts
11
+ import { mount, unmount } from 'svelte'
12
+ import type { ComponentProps } from 'svelte'
13
+ import { LanguageSwitch } from '@h-ai/ui'
14
+ const props: ComponentProps<typeof LanguageSwitch> = { currentLanguage: 'zh-CN', languages: [{ value: 'zh-CN', label: '中文' }, { value: 'en-US', label: 'English' }] }
15
+ const component = mount(LanguageSwitch, { target: document.body, props })
16
+ await unmount(component)
29
17
  ```
30
18
  -->
31
19
  <script lang='ts'>
20
+ import type { DataAttributes } from '../../../types.js'
32
21
  import { uiM } from '../../../messages.js'
22
+ import { getDataAttributes } from '../../../utils.js'
33
23
  import BareButton from '../../primitives/BareButton.svelte'
34
24
 
25
+ /**
26
+ * 语言选择器候选项;value 使用应用实际支持的 locale 代码。
27
+ *
28
+ * @example 模块内部上下文
29
+ * ```ts
30
+ * const example: Language = { value: 'zh-CN', label: '中文' }
31
+ * ```
32
+ */
35
33
  interface Language {
36
34
  value: string
37
35
  label: string
38
36
  flag?: string
39
37
  }
40
38
 
39
+ /**
40
+ * LanguageSwitch 组件的属性契约;通过公开组件配置使用。
41
+ *
42
+ * @example
43
+ * ```ts
44
+ * import { mount, unmount } from 'svelte'
45
+ * import type { ComponentProps } from 'svelte'
46
+ * import { LanguageSwitch } from '@h-ai/ui'
47
+ * const props: ComponentProps<typeof LanguageSwitch> = { currentLanguage: 'zh-CN', languages: [{ value: 'zh-CN', label: '中文' }, { value: 'en-US', label: 'English' }] }
48
+ * const component = mount(LanguageSwitch, { target: document.body, props })
49
+ * await unmount(component)
50
+ * ```
51
+ */
41
52
  interface Props {
42
53
  /** 当前语言代码(BCP 47 格式) */
43
54
  currentLanguage?: string
@@ -45,6 +56,8 @@
45
56
  languages?: Language[]
46
57
  /** 语言变更回调 */
47
58
  onchange?: (lang: string) => void
59
+ /** 下拉菜单水平对齐方式 */
60
+ align?: 'start' | 'end'
48
61
  /** 紧凑模式:仅显示图标,适用于移动端头部 */
49
62
  compact?: boolean
50
63
  /** 自定义类名 */
@@ -56,12 +69,16 @@
56
69
  languages = [
57
70
  { value: 'zh-CN', label: '简体中文', flag: 'CN' },
58
71
  { value: 'en-US', label: 'English', flag: 'US' },
72
+ { value: 'ja-JP', label: '日本語', flag: 'JP' },
59
73
  ],
60
74
  onchange,
75
+ align = 'end',
61
76
  compact = false,
62
77
  class: className = '',
63
- }: Props = $props()
78
+ ...restProps
79
+ }: Props & DataAttributes = $props()
64
80
 
81
+ const dataAttributes = $derived(getDataAttributes(restProps))
65
82
  let open = $state(false)
66
83
  let containerRef = $state<HTMLDivElement | null>(null)
67
84
 
@@ -91,7 +108,7 @@
91
108
  })
92
109
  </script>
93
110
 
94
- <div bind:this={containerRef} class='dropdown dropdown-end {open ? 'dropdown-open' : ''} {className}'>
111
+ <div {...dataAttributes} bind:this={containerRef} class='dropdown {align === 'end' ? 'dropdown-end' : ''} {open ? 'dropdown-open' : ''} {className}'>
95
112
  <BareButton
96
113
  type='button'
97
114
  class='btn btn-ghost {compact ? 'btn-sm btn-square' : 'btn-sm gap-2 min-w-fit'}'
@@ -1,8 +1,30 @@
1
+ import type { DataAttributes } from '../../../types.js';
2
+ /**
3
+ * 语言选择器候选项;value 使用应用实际支持的 locale 代码。
4
+ *
5
+ * @example 模块内部上下文
6
+ * ```ts
7
+ * const example: Language = { value: 'zh-CN', label: '中文' }
8
+ * ```
9
+ */
1
10
  interface Language {
2
11
  value: string;
3
12
  label: string;
4
13
  flag?: string;
5
14
  }
15
+ /**
16
+ * LanguageSwitch 组件的属性契约;通过公开组件配置使用。
17
+ *
18
+ * @example
19
+ * ```ts
20
+ * import { mount, unmount } from 'svelte'
21
+ * import type { ComponentProps } from 'svelte'
22
+ * import { LanguageSwitch } from '@h-ai/ui'
23
+ * const props: ComponentProps<typeof LanguageSwitch> = { currentLanguage: 'zh-CN', languages: [{ value: 'zh-CN', label: '中文' }, { value: 'en-US', label: 'English' }] }
24
+ * const component = mount(LanguageSwitch, { target: document.body, props })
25
+ * await unmount(component)
26
+ * ```
27
+ */
6
28
  interface Props {
7
29
  /** 当前语言代码(BCP 47 格式) */
8
30
  currentLanguage?: string;
@@ -10,11 +32,14 @@ interface Props {
10
32
  languages?: Language[];
11
33
  /** 语言变更回调 */
12
34
  onchange?: (lang: string) => void;
35
+ /** 下拉菜单水平对齐方式 */
36
+ align?: 'start' | 'end';
13
37
  /** 紧凑模式:仅显示图标,适用于移动端头部 */
14
38
  compact?: boolean;
15
39
  /** 自定义类名 */
16
40
  class?: string;
17
41
  }
42
+ type $$ComponentProps = Props & DataAttributes;
18
43
  /**
19
44
  * LanguageSwitch
20
45
  * 语言切换下拉组件,支持多语言切换。
@@ -24,27 +49,15 @@ interface Props {
24
49
  * @prop {function} onchange - 语言变更回调,传入选中的语言代码
25
50
  *
26
51
  * @example
27
- * ```svelte
28
- * <script>
29
- * import { LanguageSwitch, createLocaleStore, setGlobalLocale } from '@h-ai/ui'
30
- * import { setLocale, getLocale } from '../../../paraglide/runtime.js'
31
- *
32
- * const localeStore = createLocaleStore()
33
- * </script>
34
- *
35
- * <LanguageSwitch
36
- * currentLanguage={localeStore.current}
37
- * languages={[
38
- * { value: 'zh-CN', label: '简体中文' },
39
- * { value: 'en-US', label: 'English' }
40
- * ]}
41
- * onchange={(lang) => {
42
- * localeStore.set(lang) // 同步到 @h-ai/core 全局 locale
43
- * setLocale(lang) // 同步到 Paraglide
44
- * }}
45
- * />
52
+ * ```ts
53
+ * import { mount, unmount } from 'svelte'
54
+ * import type { ComponentProps } from 'svelte'
55
+ * import { LanguageSwitch } from '@h-ai/ui'
56
+ * const props: ComponentProps<typeof LanguageSwitch> = { currentLanguage: 'zh-CN', languages: [{ value: 'zh-CN', label: '中文' }, { value: 'en-US', label: 'English' }] }
57
+ * const component = mount(LanguageSwitch, { target: document.body, props })
58
+ * await unmount(component)
46
59
  * ```
47
60
  */
48
- declare const LanguageSwitch: import("svelte").Component<Props, {}, "">;
61
+ declare const LanguageSwitch: import("svelte").Component<$$ComponentProps, {}, "">;
49
62
  type LanguageSwitch = ReturnType<typeof LanguageSwitch>;
50
63
  export default LanguageSwitch;
@@ -0,0 +1,115 @@
1
+ <!--
2
+ @component SettingsLayout
3
+ 设置页布局场景组件
4
+
5
+ 借鉴 shadcn-admin 设置页:顶部标题/描述 + 左侧分区导航 + 右侧内容区。
6
+ 分区内容由使用方通过 children 提供,导航高亮由 active 控制。
7
+
8
+ 使用 Svelte 5 Runes ($props, $derived)
9
+
10
+ @example
11
+ ```ts
12
+ import { mount, unmount, createRawSnippet } from 'svelte'
13
+ import type { ComponentProps } from 'svelte'
14
+ import { SettingsLayout } from '@h-ai/ui'
15
+ const props: ComponentProps<typeof SettingsLayout> = { title: '设置', sections: [{ id: 'profile', label: '资料', href: '/settings/profile' }], active: 'profile', children: createRawSnippet(() => ({ render: () => "<p>个人资料设置</p>" })) }
16
+ const component = mount(SettingsLayout, { target: document.body, props })
17
+ await unmount(component)
18
+ ```
19
+ -->
20
+ <script lang='ts'>
21
+ import type { Snippet } from 'svelte'
22
+ import type { DataAttributes } from '../../../types.js'
23
+ import { cn, getDataAttributes } from '../../../utils.js'
24
+ import PageHeader from '../../compounds/PageHeader.svelte'
25
+ import BareButton from '../../primitives/BareButton.svelte'
26
+
27
+ /**
28
+ * 设置页分区导航项;href 直接渲染链接,否则由宿主处理选中事件。
29
+ *
30
+ * @example
31
+ * ```ts
32
+ * import { mount, unmount, createRawSnippet } from 'svelte'
33
+ * import type { ComponentProps } from 'svelte'
34
+ * import { SettingsLayout } from '@h-ai/ui'
35
+ * const props: ComponentProps<typeof SettingsLayout> = { title: '设置', sections: [{ id: 'profile', label: '资料', href: '/settings/profile' }], active: 'profile', children: createRawSnippet(() => ({ render: () => "<p>个人资料设置</p>" })) }
36
+ * const component = mount(SettingsLayout, { target: document.body, props })
37
+ * await unmount(component)
38
+ * ```
39
+ */
40
+ type SettingsSection = {
41
+ id: string
42
+ label: string
43
+ icon?: string
44
+ /** 提供时渲染为链接(SSR 友好),否则触发 onselect */
45
+ href?: string
46
+ }
47
+
48
+ const {
49
+ title = '',
50
+ description = '',
51
+ sections = [],
52
+ active = '',
53
+ onselect,
54
+ children,
55
+ headerActions,
56
+ class: className = '',
57
+ ...restProps
58
+ }: {
59
+ title?: string
60
+ description?: string
61
+ sections?: SettingsSection[]
62
+ active?: string
63
+ onselect?: (id: string) => void
64
+ children?: Snippet
65
+ headerActions?: Snippet
66
+ class?: string
67
+ } & DataAttributes = $props()
68
+
69
+ const dataAttributes = $derived(getDataAttributes(restProps))
70
+ function navItemClass(id: string): string {
71
+ return cn(
72
+ 'flex w-full items-center gap-2.5 rounded-lg px-3 py-2 text-sm font-medium transition-colors',
73
+ id === active
74
+ ? 'bg-base-content/8 text-base-content'
75
+ : 'text-base-content/60 hover:bg-base-content/5 hover:text-base-content',
76
+ )
77
+ }
78
+ </script>
79
+
80
+ <div {...dataAttributes} class={cn('space-y-4', className)}>
81
+ <!-- 标题区 -->
82
+ {#if title || description || headerActions}
83
+ <PageHeader {title} {description} actions={headerActions} class='mb-0' />
84
+ {/if}
85
+
86
+ <div class='grid gap-4 lg:grid-cols-[13rem_minmax(0,1fr)]'>
87
+ <!-- 左侧分区导航 -->
88
+ {#if sections.length > 0}
89
+ <aside class='lg:sticky lg:top-4 lg:self-start'>
90
+ <nav class='flex gap-1 overflow-x-auto lg:flex-col lg:overflow-visible'>
91
+ {#each sections as section (section.id)}
92
+ {#if section.href}
93
+ <a href={section.href} class={navItemClass(section.id)} aria-current={section.id === active ? 'page' : undefined}>
94
+ {#if section.icon}<span class='{section.icon} size-4 shrink-0'></span>{/if}
95
+ <span class='whitespace-nowrap'>{section.label}</span>
96
+ </a>
97
+ {:else}
98
+ <BareButton type='button' class={navItemClass(section.id)} onclick={() => onselect?.(section.id)}>
99
+ {#if section.icon}<span class='{section.icon} size-4 shrink-0'></span>{/if}
100
+ <span class='whitespace-nowrap'>{section.label}</span>
101
+ </BareButton>
102
+ {/if}
103
+ {/each}
104
+ </nav>
105
+ </aside>
106
+ {/if}
107
+
108
+ <!-- 内容区 -->
109
+ <div class='min-w-0 space-y-5'>
110
+ {#if children}
111
+ {@render children()}
112
+ {/if}
113
+ </div>
114
+ </div>
115
+ </div>
@@ -0,0 +1,54 @@
1
+ import type { Snippet } from 'svelte';
2
+ import type { DataAttributes } from '../../../types.js';
3
+ /**
4
+ * 设置页分区导航项;href 直接渲染链接,否则由宿主处理选中事件。
5
+ *
6
+ * @example
7
+ * ```ts
8
+ * import { mount, unmount, createRawSnippet } from 'svelte'
9
+ * import type { ComponentProps } from 'svelte'
10
+ * import { SettingsLayout } from '@h-ai/ui'
11
+ * const props: ComponentProps<typeof SettingsLayout> = { title: '设置', sections: [{ id: 'profile', label: '资料', href: '/settings/profile' }], active: 'profile', children: createRawSnippet(() => ({ render: () => "<p>个人资料设置</p>" })) }
12
+ * const component = mount(SettingsLayout, { target: document.body, props })
13
+ * await unmount(component)
14
+ * ```
15
+ */
16
+ type SettingsSection = {
17
+ id: string;
18
+ label: string;
19
+ icon?: string;
20
+ /** 提供时渲染为链接(SSR 友好),否则触发 onselect */
21
+ href?: string;
22
+ };
23
+ type $$ComponentProps = {
24
+ title?: string;
25
+ description?: string;
26
+ sections?: SettingsSection[];
27
+ active?: string;
28
+ onselect?: (id: string) => void;
29
+ children?: Snippet;
30
+ headerActions?: Snippet;
31
+ class?: string;
32
+ } & DataAttributes;
33
+ /**
34
+ * SettingsLayout
35
+ * 设置页布局场景组件
36
+ *
37
+ * 借鉴 shadcn-admin 设置页:顶部标题/描述 + 左侧分区导航 + 右侧内容区。
38
+ * 分区内容由使用方通过 children 提供,导航高亮由 active 控制。
39
+ *
40
+ * 使用 Svelte 5 Runes ($props, $derived)
41
+ *
42
+ * @example
43
+ * ```ts
44
+ * import { mount, unmount, createRawSnippet } from 'svelte'
45
+ * import type { ComponentProps } from 'svelte'
46
+ * import { SettingsLayout } from '@h-ai/ui'
47
+ * const props: ComponentProps<typeof SettingsLayout> = { title: '设置', sections: [{ id: 'profile', label: '资料', href: '/settings/profile' }], active: 'profile', children: createRawSnippet(() => ({ render: () => "<p>个人资料设置</p>" })) }
48
+ * const component = mount(SettingsLayout, { target: document.body, props })
49
+ * await unmount(component)
50
+ * ```
51
+ */
52
+ declare const SettingsLayout: import("svelte").Component<$$ComponentProps, {}, "">;
53
+ type SettingsLayout = ReturnType<typeof SettingsLayout>;
54
+ export default SettingsLayout;
@@ -8,12 +8,37 @@
8
8
  @prop {string} currentTheme - 当前主题
9
9
  @prop {function} onlanguagechange - 语言变更回调
10
10
  @prop {function} onthemechange - 主题变更回调
11
+
12
+ @example
13
+ ```ts
14
+ import { mount, unmount } from 'svelte'
15
+ import type { ComponentProps } from 'svelte'
16
+ import { SettingsModal } from '@h-ai/ui'
17
+ const props: ComponentProps<typeof SettingsModal> = { open: true, currentLanguage: 'zh-CN', currentTheme: 'light' }
18
+ const component = mount(SettingsModal, { target: document.body, props })
19
+ await unmount(component)
20
+ ```
11
21
  -->
12
22
  <script lang='ts'>
23
+ import type { DataAttributes } from '../../../types.js'
13
24
  import { uiM } from '../../../messages.js'
25
+ import { cn, getDataAttributes } from '../../../utils.js'
14
26
  import BareButton from '../../primitives/BareButton.svelte'
15
27
  import IconButton from '../../primitives/IconButton.svelte'
16
28
 
29
+ /**
30
+ * SettingsModal 组件的属性契约;通过公开组件配置使用。
31
+ *
32
+ * @example
33
+ * ```ts
34
+ * import { mount, unmount } from 'svelte'
35
+ * import type { ComponentProps } from 'svelte'
36
+ * import { SettingsModal } from '@h-ai/ui'
37
+ * const props: ComponentProps<typeof SettingsModal> = { open: true, currentLanguage: 'zh-CN', currentTheme: 'light' }
38
+ * const component = mount(SettingsModal, { target: document.body, props })
39
+ * await unmount(component)
40
+ * ```
41
+ */
17
42
  interface Props {
18
43
  open?: boolean
19
44
  currentLanguage?: string
@@ -23,6 +48,7 @@
23
48
  onlanguagechange?: (lang: string) => void
24
49
  onthemechange?: (theme: string) => void
25
50
  onclose?: () => void
51
+ class?: string
26
52
  }
27
53
 
28
54
  let {
@@ -43,8 +69,11 @@
43
69
  onlanguagechange,
44
70
  onthemechange,
45
71
  onclose,
46
- }: Props = $props()
72
+ class: className = '',
73
+ ...restProps
74
+ }: Props & DataAttributes = $props()
47
75
 
76
+ const dataAttributes = $derived(getDataAttributes(restProps))
48
77
  function handleClose() {
49
78
  open = false
50
79
  onclose?.()
@@ -66,14 +95,13 @@
66
95
  <svelte:window onkeydown={handleKeydown} />
67
96
 
68
97
  {#if open}
69
- <!-- svelte-ignore a11y_click_events_have_key_events -->
70
- <!-- svelte-ignore a11y_no_static_element_interactions -->
71
98
  <div
99
+ {...dataAttributes}
72
100
  class='fixed inset-0 z-50 flex items-center justify-center bg-black/50 backdrop-blur-sm transition-opacity'
73
101
  onclick={handleBackdropClick}
74
102
  >
75
103
  <div
76
- class='relative w-full max-w-lg mx-4 transform overflow-hidden rounded-2xl bg-base-100 shadow-xl transition-all'
104
+ class={cn('relative w-full max-w-lg mx-4 transform overflow-hidden rounded-2xl bg-base-100 shadow-xl transition-all', className)}
77
105
  role='dialog'
78
106
  aria-modal='true'
79
107
  >
@@ -87,9 +115,7 @@
87
115
  onclick={handleClose}
88
116
  class='hover:bg-base-content/10'
89
117
  >
90
- {#snippet children()}
91
- <span class='icon-[tabler--x] size-5'></span>
92
- {/snippet}
118
+ <span class='icon-[tabler--x] size-5'></span>
93
119
  </IconButton>
94
120
  </div>
95
121
 
@@ -1,3 +1,17 @@
1
+ import type { DataAttributes } from '../../../types.js';
2
+ /**
3
+ * SettingsModal 组件的属性契约;通过公开组件配置使用。
4
+ *
5
+ * @example
6
+ * ```ts
7
+ * import { mount, unmount } from 'svelte'
8
+ * import type { ComponentProps } from 'svelte'
9
+ * import { SettingsModal } from '@h-ai/ui'
10
+ * const props: ComponentProps<typeof SettingsModal> = { open: true, currentLanguage: 'zh-CN', currentTheme: 'light' }
11
+ * const component = mount(SettingsModal, { target: document.body, props })
12
+ * await unmount(component)
13
+ * ```
14
+ */
1
15
  interface Props {
2
16
  open?: boolean;
3
17
  currentLanguage?: string;
@@ -14,7 +28,9 @@ interface Props {
14
28
  onlanguagechange?: (lang: string) => void;
15
29
  onthemechange?: (theme: string) => void;
16
30
  onclose?: () => void;
31
+ class?: string;
17
32
  }
33
+ type $$ComponentProps = Props & DataAttributes;
18
34
  /**
19
35
  * SettingsModal
20
36
  * 应用设置模态框,包含语言和主题切换功能。
@@ -25,7 +41,17 @@ interface Props {
25
41
  * @prop {string} currentTheme - 当前主题
26
42
  * @prop {function} onlanguagechange - 语言变更回调
27
43
  * @prop {function} onthemechange - 主题变更回调
44
+ *
45
+ * @example
46
+ * ```ts
47
+ * import { mount, unmount } from 'svelte'
48
+ * import type { ComponentProps } from 'svelte'
49
+ * import { SettingsModal } from '@h-ai/ui'
50
+ * const props: ComponentProps<typeof SettingsModal> = { open: true, currentLanguage: 'zh-CN', currentTheme: 'light' }
51
+ * const component = mount(SettingsModal, { target: document.body, props })
52
+ * await unmount(component)
53
+ * ```
28
54
  */
29
- declare const SettingsModal: import("svelte").Component<Props, {}, "open">;
55
+ declare const SettingsModal: import("svelte").Component<$$ComponentProps, {}, "open">;
30
56
  type SettingsModal = ReturnType<typeof SettingsModal>;
31
57
  export default SettingsModal;