@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
@@ -1,123 +1,398 @@
1
1
  <!--
2
2
  @component Modal
3
3
  模态框组件,支持 backdrop-blur 和 scale-in 动画。
4
+
5
+ @example
6
+ ```ts
7
+ import { mount, unmount, createRawSnippet } from 'svelte'
8
+ import type { ComponentProps } from 'svelte'
9
+ import { Modal } from '@h-ai/ui'
10
+ const props: ComponentProps<typeof Modal> = { open: true, title: '编辑资料', closeOnBackdrop: false, children: createRawSnippet(() => ({ render: () => "<span>表单内容</span>" })) }
11
+ const component = mount(Modal, { target: document.body, props })
12
+ await unmount(component)
13
+ ```
4
14
  -->
5
15
  <script lang='ts'>
6
- import type { ModalProps } from '../../types.js'
16
+ import type { DataAttributes, ModalProps } from '../../types.js'
17
+ import { setContext } from 'svelte'
18
+ import { focusDialog, handleDialogKeydown } from '../../internal/dialog-focus.js'
19
+ import { FORM_VISIBILITY_CONTEXT } from '../../internal/form-context.js'
7
20
  import { uiM } from '../../messages.js'
8
- import { cn } from '../../utils.js'
9
- import IconButton from '../primitives/IconButton.svelte'
21
+ import { cn, getDataAttributes } from '../../utils.js'
10
22
 
11
23
  let {
12
24
  open = $bindable(false),
13
25
  title = '',
14
26
  size = 'md',
27
+ radius = '1rem',
15
28
  closeOnBackdrop = true,
16
29
  closeOnEscape = true,
17
30
  showClose = true,
31
+ width,
32
+ height,
33
+ bodyOverflow = 'auto',
34
+ bodyClass = '',
18
35
  class: className = '',
19
36
  onclose,
20
37
  header,
21
38
  footer,
22
39
  children,
23
- }: ModalProps = $props()
40
+ ...restProps
41
+ }: ModalProps & DataAttributes = $props()
42
+
43
+ const dataAttributes = $derived(getDataAttributes(restProps))
44
+ setContext(FORM_VISIBILITY_CONTEXT, {
45
+ get open() { return open },
46
+ })
47
+ const modalId = $props.id()
48
+ const titleId = `${modalId}-title`
49
+ let panel = $state<HTMLDivElement>()
24
50
 
51
+ // 标题区仅在显式提供标题或自定义 header 时出现;
52
+ // 仅需关闭按钮的场景改为右上角悬浮按钮,避免业务侧额外占一整行头部。
53
+ const hasHeader = $derived(Boolean(header || title))
54
+ const hasFloatingClose = $derived(showClose && !hasHeader)
25
55
  const sizeMap: Record<string, string> = {
26
- 'xs': 'max-w-xs',
27
- 'sm': 'max-w-sm',
28
- 'md': 'max-w-md',
29
- 'lg': 'max-w-lg',
30
- 'xl': 'max-w-xl',
31
- '2xl': 'max-w-2xl',
32
- '3xl': 'max-w-3xl',
33
- '4xl': 'max-w-4xl',
34
- 'full': 'max-w-full h-full',
56
+ 'xs': 'hai-modal__panel--xs',
57
+ 'sm': 'hai-modal__panel--sm',
58
+ 'md': 'hai-modal__panel--md',
59
+ 'lg': 'hai-modal__panel--lg',
60
+ 'xl': 'hai-modal__panel--xl',
61
+ '2xl': 'hai-modal__panel--2xl',
62
+ '3xl': 'hai-modal__panel--3xl',
63
+ '4xl': 'hai-modal__panel--4xl',
64
+ 'full': 'hai-modal__panel--full',
35
65
  }
36
66
 
67
+ // width / height 允许业务侧按需传入 CSS 值,覆盖尺寸预设。
68
+ const panelStyle = $derived.by(() => {
69
+ const styles: string[] = []
70
+
71
+ if (typeof width === 'string' && width.trim().length > 0) {
72
+ styles.push(`--hai-modal-width: ${width.trim()}`)
73
+ }
74
+
75
+ if (typeof height === 'string' && height.trim().length > 0) {
76
+ styles.push(`--hai-modal-height: ${height.trim()}`)
77
+ }
78
+
79
+ if (typeof radius === 'string' && radius.trim().length > 0) {
80
+ styles.push(`--hai-modal-radius: ${radius.trim()}`)
81
+ }
82
+
83
+ if (bodyOverflow === 'visible') {
84
+ styles.push('--hai-modal-panel-overflow: visible')
85
+ }
86
+
87
+ return styles.length > 0 ? styles.join('; ') : undefined
88
+ })
89
+
37
90
  const modalBoxClass = $derived(
38
91
  cn(
39
- 'modal-box border border-base-content/6 shadow-xl',
40
- 'animate-[hai-scale-in_0.2s_cubic-bezier(0.16,1,0.3,1)]',
92
+ 'hai-modal__panel flex min-h-0 flex-col',
93
+ 'relative',
94
+ 'bg-base-100 p-0',
41
95
  sizeMap[size],
42
96
  className,
43
97
  ),
44
98
  )
45
99
 
100
+ const bodyOverflowClass = $derived(
101
+ bodyOverflow === 'visible'
102
+ ? 'overflow-visible'
103
+ : bodyOverflow === 'hidden'
104
+ ? 'overflow-hidden'
105
+ : 'overflow-y-auto',
106
+ )
107
+
46
108
  function handleClose() {
47
109
  open = false
48
110
  onclose?.()
49
111
  }
50
112
 
51
- function handleBackdropClick() {
52
- if (closeOnBackdrop) {
53
- handleClose()
54
- }
55
- }
113
+ // 打开时把焦点移入弹窗,关闭后恢复原操作位置。
114
+ $effect(() => {
115
+ if (!open || !panel)
116
+ return
117
+ return focusDialog(panel)
118
+ })
56
119
 
57
- function handleKeydown(e: KeyboardEvent) {
58
- if (closeOnEscape && e.key === 'Escape') {
59
- handleClose()
60
- }
120
+ function handleKeydown(event: KeyboardEvent) {
121
+ if (!open || !panel)
122
+ return
123
+ handleDialogKeydown(event, panel, closeOnEscape ? handleClose : undefined)
61
124
  }
62
125
 
63
- // ESC 键处理
64
- $effect(() => {
65
- if (open) {
66
- document.addEventListener('keydown', handleKeydown)
67
- return () => document.removeEventListener('keydown', handleKeydown)
68
- }
69
- return undefined
70
- })
71
126
  </script>
72
127
 
73
- <dialog class='modal backdrop-blur-xs' class:modal-open={open}>
74
- <div class={modalBoxClass}>
75
- <!-- 头部:标题 + 关闭按钮 -->
76
- <div class='flex items-start justify-between gap-4'>
77
- {#if header}
78
- <div class='font-semibold text-base flex-1'>
79
- {@render header()}
80
- </div>
81
- {:else if title}
82
- <h3 class='font-semibold text-base flex-1'>{title}</h3>
83
- {:else}
84
- <div class='flex-1'></div>
85
- {/if}
128
+ <div {...dataAttributes}
129
+ class='hai-modal'
130
+ style:display={open ? '' : 'none'}
131
+ aria-hidden={open ? undefined : 'true'}
132
+ onkeydown={handleKeydown}
133
+ >
134
+ <div
135
+ class='hai-modal__viewport'
136
+ >
137
+ {#if closeOnBackdrop}
138
+ <button
139
+ type='button'
140
+ class='hai-modal__backdrop'
141
+ aria-label={uiM('common_close')}
142
+ tabindex='-1'
143
+ onclick={handleClose}
144
+ ></button>
145
+ {:else}
146
+ <div class='hai-modal__backdrop' aria-hidden='true'></div>
147
+ {/if}
86
148
 
87
- {#if showClose}
88
- <IconButton
89
- size='sm'
90
- variant='ghost'
91
- label={uiM('common_close')}
149
+ <div bind:this={panel} class={modalBoxClass} style={panelStyle} role='dialog' aria-modal='true' aria-labelledby={title && !header ? titleId : undefined} aria-label={title && !header ? undefined : title || uiM('common_dialog')} tabindex='-1'>
150
+ {#if hasFloatingClose}
151
+ <button
152
+ type='button'
153
+ class='hai-modal__close hai-modal__close--floating'
154
+ aria-label={uiM('common_close')}
92
155
  onclick={handleClose}
93
- class='-mt-1 -mr-2'
94
156
  >
95
- {#snippet children()}
96
- <span class='icon-[tabler--x] size-4.5'></span>
97
- {/snippet}
98
- </IconButton>
157
+ <svg viewBox='0 0 24 24' class='hai-modal__close-icon' aria-hidden='true'>
158
+ <path
159
+ d='M6 6l12 12M18 6L6 18'
160
+ fill='none'
161
+ stroke='currentColor'
162
+ stroke-width='1.9'
163
+ stroke-linecap='round'
164
+ ></path>
165
+ </svg>
166
+ </button>
99
167
  {/if}
100
- </div>
101
168
 
102
- <div class='py-4'>
103
- {#if children}
104
- {@render children()}
169
+ {#if hasHeader}
170
+ <!-- 顶部栏单独固定,保证滚动时标题和关闭操作始终可见。 -->
171
+ <div class='hai-modal__header flex flex-none items-start justify-between gap-4 px-6 py-5 sm:px-7'>
172
+ {#if header}
173
+ <div class='flex-1 font-semibold text-[1.05rem] text-base-content/92'>
174
+ {@render header()}
175
+ </div>
176
+ {:else if title}
177
+ <h3 id={titleId} class='flex-1 font-semibold text-[1.05rem] tracking-tight text-base-content/92'>
178
+ {title}
179
+ </h3>
180
+ {:else}
181
+ <div class='flex-1'></div>
182
+ {/if}
183
+
184
+ {#if showClose}
185
+ <button
186
+ type='button'
187
+ class='hai-modal__close'
188
+ aria-label={uiM('common_close')}
189
+ onclick={handleClose}
190
+ >
191
+ <svg viewBox='0 0 24 24' class='hai-modal__close-icon' aria-hidden='true'>
192
+ <path
193
+ d='M6 6l12 12M18 6L6 18'
194
+ fill='none'
195
+ stroke='currentColor'
196
+ stroke-width='1.9'
197
+ stroke-linecap='round'
198
+ ></path>
199
+ </svg>
200
+ </button>
201
+ {/if}
202
+ </div>
105
203
  {/if}
106
- </div>
107
204
 
108
- {#if footer}
109
- <div class='modal-action'>
110
- {@render footer()}
205
+ <!-- 主体区域独立滚动,避免长内容把头部和底部一起顶走。 -->
206
+ <div class={cn('min-h-0 flex-1 px-6 py-5 sm:px-7', bodyOverflowClass, bodyClass)}>
207
+ {#if children}
208
+ {@render children()}
209
+ {/if}
111
210
  </div>
112
- {/if}
211
+
212
+ {#if footer}
213
+ <!-- 底栏固定在面板底部,用于承接确认/取消或状态摘要。 -->
214
+ <div class='hai-modal__footer flex flex-none items-center px-6 py-4 sm:px-7'>
215
+ <div class='flex w-full items-center justify-end gap-3'>
216
+ {@render footer()}
217
+ </div>
218
+ </div>
219
+ {/if}
220
+ </div>
113
221
  </div>
222
+ </div>
114
223
 
115
- <button
116
- type='button'
117
- class='modal-backdrop'
118
- aria-label={uiM('modal_close')}
119
- onclick={handleBackdropClick}
120
- >
121
- {uiM('common_close')}
122
- </button>
123
- </dialog>
224
+ <style>
225
+ .hai-modal {
226
+ margin: 0;
227
+ padding: 0;
228
+ border: 0;
229
+ background: transparent;
230
+ outline: none;
231
+ overflow: visible;
232
+ box-sizing: border-box;
233
+ }
234
+
235
+ .hai-modal {
236
+ position: fixed;
237
+ inset: 0;
238
+ z-index: var(--hai-z-modal, 1100);
239
+ display: block;
240
+ pointer-events: none;
241
+ }
242
+
243
+ .hai-modal__viewport {
244
+ position: fixed;
245
+ inset: 0;
246
+ display: grid;
247
+ place-items: center;
248
+ padding: clamp(1rem, 2.6vw, 2rem);
249
+ pointer-events: auto;
250
+ }
251
+
252
+ .hai-modal__backdrop {
253
+ position: absolute;
254
+ inset: 0;
255
+ width: 100%;
256
+ height: 100%;
257
+ padding: 0;
258
+ border: 0;
259
+ background: rgb(15 23 42 / 0.26);
260
+ background: color-mix(in srgb, var(--color-base-content) 15%, transparent);
261
+ backdrop-filter: blur(2px);
262
+ }
263
+
264
+ .hai-modal__panel {
265
+ z-index: 1;
266
+ width: var(--hai-modal-width, min(100%, 44rem));
267
+ max-width: min(100%, calc(100vw - clamp(2rem, 5.2vw, 4rem)));
268
+ height: var(--hai-modal-height, auto);
269
+ max-height: calc(100vh - clamp(2rem, 5.2vw, 4rem));
270
+ max-height: calc(100dvh - clamp(2rem, 5.2vw, 4rem));
271
+ border-radius: var(--hai-modal-radius, 1rem);
272
+ overflow: var(--hai-modal-panel-overflow, hidden);
273
+ color: var(--color-base-content);
274
+ outline: none;
275
+ box-shadow:
276
+ 0 34px 84px -42px color-mix(in srgb, var(--color-base-content) 24%, transparent),
277
+ 0 14px 28px -22px color-mix(in srgb, var(--color-primary) 12%, transparent);
278
+ animation: hai-modal-enter 0.22s cubic-bezier(0.16, 1, 0.3, 1);
279
+ }
280
+
281
+ .hai-modal__header {
282
+ /* 头部单独承接面板圆角,避免滚动主体或主题背景把顶部边缘切成直角。 */
283
+ border-top-left-radius: inherit;
284
+ border-top-right-radius: inherit;
285
+ box-shadow: inset 0 -1px 0 color-mix(in srgb, var(--color-base-content) 6%, transparent);
286
+ }
287
+
288
+ .hai-modal__footer {
289
+ /* 底栏去掉独立背景后,继续继承圆角,保证底部阴影和面板外轮廓保持一致。 */
290
+ border-bottom-right-radius: inherit;
291
+ border-bottom-left-radius: inherit;
292
+ box-shadow: inset 0 1px 0 color-mix(in srgb, var(--color-base-content) 6%, transparent);
293
+ border-radius: 0 0 var(--hai-modal-radius, 1rem) var(--hai-modal-radius, 1rem);
294
+ }
295
+
296
+ .hai-modal__close {
297
+ display: inline-flex;
298
+ width: 2.25rem;
299
+ height: 2.25rem;
300
+ flex: none;
301
+ align-items: center;
302
+ justify-content: center;
303
+ border: 0;
304
+ border-radius: 999px;
305
+ background: color-mix(in srgb, var(--color-base-content) 4%, transparent);
306
+ color: color-mix(in srgb, var(--color-base-content) 54%, transparent);
307
+ cursor: pointer;
308
+ transition:
309
+ background-color 160ms ease,
310
+ color 160ms ease,
311
+ transform 160ms ease;
312
+ }
313
+
314
+ .hai-modal__close:hover {
315
+ background: color-mix(in srgb, var(--color-primary) 10%, transparent);
316
+ color: var(--color-primary);
317
+ transform: translateY(-1px);
318
+ }
319
+
320
+ .hai-modal__close:focus-visible {
321
+ outline: 2px solid color-mix(in srgb, var(--color-primary) 22%, transparent);
322
+ outline-offset: 2px;
323
+ }
324
+
325
+ .hai-modal__close-icon {
326
+ width: 1rem;
327
+ height: 1rem;
328
+ }
329
+
330
+ .hai-modal__close--floating {
331
+ position: absolute;
332
+ top: 1rem;
333
+ right: 1rem;
334
+ z-index: 1;
335
+ }
336
+
337
+ .hai-modal__panel--xs {
338
+ --hai-modal-width: min(100%, 24rem);
339
+ }
340
+
341
+ .hai-modal__panel--sm {
342
+ --hai-modal-width: min(100%, 32rem);
343
+ }
344
+
345
+ .hai-modal__panel--md {
346
+ --hai-modal-width: min(100%, 40rem);
347
+ }
348
+
349
+ .hai-modal__panel--lg {
350
+ --hai-modal-width: min(100%, 48rem);
351
+ }
352
+
353
+ .hai-modal__panel--xl {
354
+ --hai-modal-width: min(100%, 64rem);
355
+ }
356
+
357
+ .hai-modal__panel--2xl {
358
+ --hai-modal-width: min(100%, 72rem);
359
+ }
360
+
361
+ .hai-modal__panel--3xl {
362
+ --hai-modal-width: min(100%, 80rem);
363
+ }
364
+
365
+ .hai-modal__panel--4xl {
366
+ --hai-modal-width: min(100%, 88rem);
367
+ }
368
+
369
+ .hai-modal__panel--full {
370
+ --hai-modal-width: min(96vw, 96rem);
371
+ --hai-modal-height: min(92vh, 72rem);
372
+ }
373
+
374
+ @keyframes hai-modal-enter {
375
+ from {
376
+ opacity: 0;
377
+ transform: translateY(10px) scale(0.985);
378
+ }
379
+
380
+ to {
381
+ opacity: 1;
382
+ transform: translateY(0) scale(1);
383
+ }
384
+ }
385
+
386
+ @media (max-width: 768px) {
387
+ .hai-modal {
388
+ padding: 0.85rem;
389
+ }
390
+
391
+ .hai-modal__panel {
392
+ max-width: 100%;
393
+ max-height: calc(100vh - 1.7rem);
394
+ max-height: calc(100dvh - 1.7rem);
395
+ border-radius: min(var(--hai-modal-radius, 1rem), 1rem);
396
+ }
397
+ }
398
+ </style>
@@ -1,8 +1,19 @@
1
- import type { ModalProps } from '../../types.js';
1
+ import type { DataAttributes, ModalProps } from '../../types.js';
2
+ type $$ComponentProps = ModalProps & DataAttributes;
2
3
  /**
3
4
  * Modal
4
5
  * 模态框组件,支持 backdrop-blur 和 scale-in 动画。
6
+ *
7
+ * @example
8
+ * ```ts
9
+ * import { mount, unmount, createRawSnippet } from 'svelte'
10
+ * import type { ComponentProps } from 'svelte'
11
+ * import { Modal } from '@h-ai/ui'
12
+ * const props: ComponentProps<typeof Modal> = { open: true, title: '编辑资料', closeOnBackdrop: false, children: createRawSnippet(() => ({ render: () => "<span>表单内容</span>" })) }
13
+ * const component = mount(Modal, { target: document.body, props })
14
+ * await unmount(component)
15
+ * ```
5
16
  */
6
- declare const Modal: import("svelte").Component<ModalProps, {}, "open">;
17
+ declare const Modal: import("svelte").Component<$$ComponentProps, {}, "open">;
7
18
  type Modal = ReturnType<typeof Modal>;
8
19
  export default Modal;
@@ -7,18 +7,36 @@
7
7
  @prop {Snippet} actions - 右侧操作按钮插槽
8
8
 
9
9
  @example
10
- <PageHeader title="用户管理" description="管理系统用户">
11
- {#snippet actions()}
12
- <Button onclick={createUser}>
13
- <span class='icon-[tabler--plus] size-4'></span>
14
- 新建用户
15
- </Button>
16
- {/snippet}
17
- </PageHeader>
10
+ ```ts
11
+ import { mount, unmount } from 'svelte'
12
+ import type { ComponentProps } from 'svelte'
13
+ import { PageHeader } from '@h-ai/ui'
14
+ const props: ComponentProps<typeof PageHeader> = { title: '用户管理', description: '维护用户资料' }
15
+ const component = mount(PageHeader, { target: document.body, props })
16
+ await unmount(component)
17
+ ```
18
18
  -->
19
19
  <script lang='ts'>
20
20
  import type { Snippet } from 'svelte'
21
+ import type { DataAttributes } from '../../types.js'
22
+ import type { WorkspaceContext } from '../../workspace-context.js'
23
+ import { getContext } from 'svelte'
24
+ import { getDataAttributes } from '../../utils.js'
25
+ import { workspaceContextKey } from '../../workspace-context.js'
21
26
 
27
+ /**
28
+ * PageHeader 组件的属性契约;通过公开组件配置使用。
29
+ *
30
+ * @example
31
+ * ```ts
32
+ * import { mount, unmount } from 'svelte'
33
+ * import type { ComponentProps } from 'svelte'
34
+ * import { PageHeader } from '@h-ai/ui'
35
+ * const props: ComponentProps<typeof PageHeader> = { title: '用户管理', description: '维护用户资料' }
36
+ * const component = mount(PageHeader, { target: document.body, props })
37
+ * await unmount(component)
38
+ * ```
39
+ */
22
40
  interface Props {
23
41
  title: string
24
42
  description?: string
@@ -26,19 +44,25 @@
26
44
  class?: string
27
45
  }
28
46
 
29
- const { title, description, actions, class: className = '' }: Props = $props()
47
+ const { title, description, actions, class: className = '', ...restProps }: Props & DataAttributes = $props()
48
+
49
+ const dataAttributes = $derived(getDataAttributes(restProps))
50
+ const workspace = getContext<WorkspaceContext | undefined>(workspaceContextKey)
51
+ const showTitle = $derived(Boolean(title) && workspace?.title !== title)
30
52
  </script>
31
53
 
32
- <div class='flex flex-col sm:flex-row sm:items-center justify-between gap-3 mb-5 {className}'>
33
- <div>
34
- <h1 class='text-xl font-semibold tracking-tight'>{title}</h1>
35
- {#if description}
36
- <p class='text-sm text-base-content/45 mt-0.5'>{description}</p>
54
+ {#if showTitle || description || actions}
55
+ <div {...dataAttributes} class='flex flex-col sm:flex-row sm:items-center justify-between gap-2 mb-3 {className}'>
56
+ {#if showTitle || description}<div class='min-w-0'>
57
+ {#if showTitle}<h1 class='text-xl font-semibold tracking-tight'>{title}</h1>{/if}
58
+ {#if description}
59
+ <p class='text-sm text-base-content/45' class:mt-0.5={showTitle}>{description}</p>
60
+ {/if}
61
+ </div>{/if}
62
+ {#if actions}
63
+ <div class='flex items-center gap-2'>
64
+ {@render actions()}
65
+ </div>
37
66
  {/if}
38
67
  </div>
39
- {#if actions}
40
- <div class='flex items-center gap-2'>
41
- {@render actions()}
42
- </div>
43
- {/if}
44
- </div>
68
+ {/if}
@@ -1,10 +1,25 @@
1
1
  import type { Snippet } from 'svelte';
2
+ import type { DataAttributes } from '../../types.js';
3
+ /**
4
+ * PageHeader 组件的属性契约;通过公开组件配置使用。
5
+ *
6
+ * @example
7
+ * ```ts
8
+ * import { mount, unmount } from 'svelte'
9
+ * import type { ComponentProps } from 'svelte'
10
+ * import { PageHeader } from '@h-ai/ui'
11
+ * const props: ComponentProps<typeof PageHeader> = { title: '用户管理', description: '维护用户资料' }
12
+ * const component = mount(PageHeader, { target: document.body, props })
13
+ * await unmount(component)
14
+ * ```
15
+ */
2
16
  interface Props {
3
17
  title: string;
4
18
  description?: string;
5
19
  actions?: Snippet;
6
20
  class?: string;
7
21
  }
22
+ type $$ComponentProps = Props & DataAttributes;
8
23
  /**
9
24
  * PageHeader
10
25
  * 页面头部组件,包含标题、描述和操作按钮区域。
@@ -14,15 +29,15 @@ interface Props {
14
29
  * @prop {Snippet} actions - 右侧操作按钮插槽
15
30
  *
16
31
  * @example
17
- * <PageHeader title="用户管理" description="管理系统用户">
18
- * {#snippet actions()}
19
- * <Button onclick={createUser}>
20
- * <span class='icon-[tabler--plus] size-4'></span>
21
- * 新建用户
22
- * </Button>
23
- * {/snippet}
24
- * </PageHeader>
32
+ * ```ts
33
+ * import { mount, unmount } from 'svelte'
34
+ * import type { ComponentProps } from 'svelte'
35
+ * import { PageHeader } from '@h-ai/ui'
36
+ * const props: ComponentProps<typeof PageHeader> = { title: '用户管理', description: '维护用户资料' }
37
+ * const component = mount(PageHeader, { target: document.body, props })
38
+ * await unmount(component)
39
+ * ```
25
40
  */
26
- declare const PageHeader: import("svelte").Component<Props, {}, "">;
41
+ declare const PageHeader: import("svelte").Component<$$ComponentProps, {}, "">;
27
42
  type PageHeader = ReturnType<typeof PageHeader>;
28
43
  export default PageHeader;