@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,4 +1,5 @@
1
1
  <!--
2
+ @component AppBar
2
3
  @h-ai/ui — AppBar(顶部应用栏,支持安全区域)
3
4
 
4
5
  用法:
@@ -6,11 +7,35 @@
6
7
  {#snippet leading()}<BackButton />{/snippet}
7
8
  {#snippet trailing()}<Avatar />{/snippet}
8
9
  </AppBar>
10
+
11
+ @example
12
+ ```ts
13
+ import { mount, unmount } from 'svelte'
14
+ import type { ComponentProps } from 'svelte'
15
+ import { AppBar } from '@h-ai/ui'
16
+ const props: ComponentProps<typeof AppBar> = { title: '设置', safeArea: true }
17
+ const component = mount(AppBar, { target: document.body, props })
18
+ await unmount(component)
19
+ ```
9
20
  -->
10
21
  <script lang='ts'>
11
22
  import type { Snippet } from 'svelte'
12
- import { cn } from '../../utils.js'
23
+ import type { DataAttributes } from '../../types.js'
24
+ import { cn, getDataAttributes } from '../../utils.js'
13
25
 
26
+ /**
27
+ * AppBar 组件的属性契约;通过公开组件配置使用。
28
+ *
29
+ * @example
30
+ * ```ts
31
+ * import { mount, unmount } from 'svelte'
32
+ * import type { ComponentProps } from 'svelte'
33
+ * import { AppBar } from '@h-ai/ui'
34
+ * const props: ComponentProps<typeof AppBar> = { title: '设置', safeArea: true }
35
+ * const component = mount(AppBar, { target: document.body, props })
36
+ * await unmount(component)
37
+ * ```
38
+ */
14
39
  interface Props {
15
40
  /** 标题文本 */
16
41
  title?: string
@@ -36,16 +61,19 @@
36
61
  leading,
37
62
  trailing,
38
63
  children,
39
- }: Props = $props()
64
+ ...restProps
65
+ }: Props & DataAttributes = $props()
66
+
67
+ const dataAttributes = $derived(getDataAttributes(restProps))
40
68
  </script>
41
69
 
42
- <header
43
- class={cn(
44
- 'flex items-center h-14 px-4 bg-base-100 border-b border-base-200',
45
- safeArea && 'hai-safe-top',
46
- fixed && 'fixed top-0 left-0 right-0 z-40',
47
- className,
48
- )}
70
+ <header {...dataAttributes}
71
+ class={cn(
72
+ 'flex items-center h-14 px-4 bg-base-100 border-b border-base-200',
73
+ safeArea && 'hai-safe-top',
74
+ fixed && 'fixed top-0 left-0 right-0 z-40',
75
+ className,
76
+ )}
49
77
  >
50
78
  <!-- 左侧 -->
51
79
  <div class='flex items-center min-w-[48px]'>
@@ -1,4 +1,18 @@
1
1
  import type { Snippet } from 'svelte';
2
+ import type { DataAttributes } from '../../types.js';
3
+ /**
4
+ * AppBar 组件的属性契约;通过公开组件配置使用。
5
+ *
6
+ * @example
7
+ * ```ts
8
+ * import { mount, unmount } from 'svelte'
9
+ * import type { ComponentProps } from 'svelte'
10
+ * import { AppBar } from '@h-ai/ui'
11
+ * const props: ComponentProps<typeof AppBar> = { title: '设置', safeArea: true }
12
+ * const component = mount(AppBar, { target: document.body, props })
13
+ * await unmount(component)
14
+ * ```
15
+ */
2
16
  interface Props {
3
17
  /** 标题文本 */
4
18
  title?: string;
@@ -15,6 +29,27 @@ interface Props {
15
29
  /** 自定义标题区域 */
16
30
  children?: Snippet;
17
31
  }
18
- declare const AppBar: import("svelte").Component<Props, {}, "">;
32
+ type $$ComponentProps = Props & DataAttributes;
33
+ /**
34
+ * AppBar
35
+ * @h-ai/ui — AppBar(顶部应用栏,支持安全区域)
36
+ *
37
+ * 用法:
38
+ * <AppBar title="首页">
39
+ * {#snippet leading()}<BackButton />{/snippet}
40
+ * {#snippet trailing()}<Avatar />{/snippet}
41
+ * </AppBar>
42
+ *
43
+ * @example
44
+ * ```ts
45
+ * import { mount, unmount } from 'svelte'
46
+ * import type { ComponentProps } from 'svelte'
47
+ * import { AppBar } from '@h-ai/ui'
48
+ * const props: ComponentProps<typeof AppBar> = { title: '设置', safeArea: true }
49
+ * const component = mount(AppBar, { target: document.body, props })
50
+ * await unmount(component)
51
+ * ```
52
+ */
53
+ declare const AppBar: import("svelte").Component<$$ComponentProps, {}, "">;
19
54
  type AppBar = ReturnType<typeof AppBar>;
20
55
  export default AppBar;
@@ -1,16 +1,64 @@
1
1
  <!--
2
+ @component BottomNav
2
3
  @h-ai/ui — BottomNav(底部导航栏)
3
4
 
4
5
  用法:
5
6
  <BottomNav items={navItems} active="home" onchange={(id) => goto(`/${id}`)} />
7
+
8
+ @example
9
+ ```ts
10
+ import { mount, unmount } from 'svelte'
11
+ import type { ComponentProps } from 'svelte'
12
+ import { BottomNav } from '@h-ai/ui'
13
+ const props: ComponentProps<typeof BottomNav> = { items: [{ id: 'home', label: '首页', iconClass: 'icon-[tabler--home]' }], active: 'home', maxWidth: 'lg' }
14
+ const component = mount(BottomNav, { target: document.body, props })
15
+ await unmount(component)
16
+ ```
6
17
  -->
7
18
  <script lang='ts'>
19
+ import type { DataAttributes } from '../../types.js'
8
20
  import type { BottomNavItem } from './bottom-nav-types.js'
9
- import { cn } from '../../utils.js'
21
+ import { cn, getDataAttributes } from '../../utils.js'
10
22
 
11
23
  // eslint-disable-next-line no-import-assign -- type re-export
12
24
  export type { BottomNavItem }
13
25
 
26
+ /**
27
+ * 底部导航的内容宽度预设;none 取消预设宽度约束。
28
+ *
29
+ * @example
30
+ * ```ts
31
+ * import { mount, unmount } from 'svelte'
32
+ * import type { ComponentProps } from 'svelte'
33
+ * import { BottomNav } from '@h-ai/ui'
34
+ * const props: ComponentProps<typeof BottomNav> = { items: [{ id: 'home', label: '首页', iconClass: 'icon-[tabler--home]' }], active: 'home', maxWidth: 'lg' }
35
+ * const component = mount(BottomNav, { target: document.body, props })
36
+ * await unmount(component)
37
+ * ```
38
+ */
39
+ type BottomNavMaxWidth = 'sm' | 'md' | 'lg' | 'xl' | 'none'
40
+
41
+ const MAX_WIDTH_CLASS: Record<BottomNavMaxWidth, string> = {
42
+ sm: 'max-w-sm',
43
+ md: 'max-w-md',
44
+ lg: 'max-w-lg',
45
+ xl: 'max-w-xl',
46
+ none: '',
47
+ }
48
+
49
+ /**
50
+ * BottomNav 组件的属性契约;通过公开组件配置使用。
51
+ *
52
+ * @example
53
+ * ```ts
54
+ * import { mount, unmount } from 'svelte'
55
+ * import type { ComponentProps } from 'svelte'
56
+ * import { BottomNav } from '@h-ai/ui'
57
+ * const props: ComponentProps<typeof BottomNav> = { items: [{ id: 'home', label: '首页', iconClass: 'icon-[tabler--home]' }], active: 'home', maxWidth: 'lg' }
58
+ * const component = mount(BottomNav, { target: document.body, props })
59
+ * await unmount(component)
60
+ * ```
61
+ */
14
62
  interface Props {
15
63
  /** 导航项列表 */
16
64
  items: BottomNavItem[]
@@ -20,6 +68,10 @@
20
68
  onchange?: (id: string) => void
21
69
  /** 是否适配底部安全区域 */
22
70
  safeArea?: boolean
71
+ /** 是否将 fixed 导航居中,适用于移动端仿真器/桌面预览中的窄屏壳 */
72
+ centered?: boolean
73
+ /** fixed 导航最大宽度,centered=true 时生效 */
74
+ maxWidth?: BottomNavMaxWidth
23
75
  /** 额外 CSS 类 */
24
76
  class?: string
25
77
  }
@@ -29,16 +81,24 @@
29
81
  active,
30
82
  onchange,
31
83
  safeArea = true,
84
+ centered = false,
85
+ maxWidth = 'none',
32
86
  class: className,
33
- }: Props = $props()
87
+ ...restProps
88
+ }: Props & DataAttributes = $props()
89
+
90
+ const dataAttributes = $derived(getDataAttributes(restProps))
91
+ const constrained = $derived(centered && maxWidth !== 'none')
34
92
  </script>
35
93
 
36
- <nav
37
- class={cn(
38
- 'fixed bottom-0 left-0 right-0 bg-base-100 border-t border-base-200 z-40',
39
- safeArea && 'hai-safe-bottom',
40
- className,
41
- )}
94
+ <nav {...dataAttributes}
95
+ class={cn(
96
+ 'fixed bottom-0 bg-base-100 border-t border-base-200 z-40',
97
+ constrained ? 'left-1/2 right-auto w-full -translate-x-1/2' : 'left-0 right-0',
98
+ constrained && MAX_WIDTH_CLASS[maxWidth],
99
+ safeArea && 'hai-safe-bottom',
100
+ className,
101
+ )}
42
102
  >
43
103
  <div class='flex items-center justify-around h-14'>
44
104
  {#each items as item (item.id)}
@@ -1,4 +1,32 @@
1
+ import type { DataAttributes } from '../../types.js';
1
2
  import type { BottomNavItem } from './bottom-nav-types.js';
3
+ /**
4
+ * 底部导航的内容宽度预设;none 取消预设宽度约束。
5
+ *
6
+ * @example
7
+ * ```ts
8
+ * import { mount, unmount } from 'svelte'
9
+ * import type { ComponentProps } from 'svelte'
10
+ * import { BottomNav } from '@h-ai/ui'
11
+ * const props: ComponentProps<typeof BottomNav> = { items: [{ id: 'home', label: '首页', iconClass: 'icon-[tabler--home]' }], active: 'home', maxWidth: 'lg' }
12
+ * const component = mount(BottomNav, { target: document.body, props })
13
+ * await unmount(component)
14
+ * ```
15
+ */
16
+ type BottomNavMaxWidth = 'sm' | 'md' | 'lg' | 'xl' | 'none';
17
+ /**
18
+ * BottomNav 组件的属性契约;通过公开组件配置使用。
19
+ *
20
+ * @example
21
+ * ```ts
22
+ * import { mount, unmount } from 'svelte'
23
+ * import type { ComponentProps } from 'svelte'
24
+ * import { BottomNav } from '@h-ai/ui'
25
+ * const props: ComponentProps<typeof BottomNav> = { items: [{ id: 'home', label: '首页', iconClass: 'icon-[tabler--home]' }], active: 'home', maxWidth: 'lg' }
26
+ * const component = mount(BottomNav, { target: document.body, props })
27
+ * await unmount(component)
28
+ * ```
29
+ */
2
30
  interface Props {
3
31
  /** 导航项列表 */
4
32
  items: BottomNavItem[];
@@ -8,10 +36,32 @@ interface Props {
8
36
  onchange?: (id: string) => void;
9
37
  /** 是否适配底部安全区域 */
10
38
  safeArea?: boolean;
39
+ /** 是否将 fixed 导航居中,适用于移动端仿真器/桌面预览中的窄屏壳 */
40
+ centered?: boolean;
41
+ /** fixed 导航最大宽度,centered=true 时生效 */
42
+ maxWidth?: BottomNavMaxWidth;
11
43
  /** 额外 CSS 类 */
12
44
  class?: string;
13
45
  }
14
- declare const BottomNav: import("svelte").Component<Props, {
46
+ type $$ComponentProps = Props & DataAttributes;
47
+ /**
48
+ * BottomNav
49
+ * @h-ai/ui — BottomNav(底部导航栏)
50
+ *
51
+ * 用法:
52
+ * <BottomNav items={navItems} active="home" onchange={(id) => goto(`/${id}`)} />
53
+ *
54
+ * @example
55
+ * ```ts
56
+ * import { mount, unmount } from 'svelte'
57
+ * import type { ComponentProps } from 'svelte'
58
+ * import { BottomNav } from '@h-ai/ui'
59
+ * const props: ComponentProps<typeof BottomNav> = { items: [{ id: 'home', label: '首页', iconClass: 'icon-[tabler--home]' }], active: 'home', maxWidth: 'lg' }
60
+ * const component = mount(BottomNav, { target: document.body, props })
61
+ * await unmount(component)
62
+ * ```
63
+ */
64
+ declare const BottomNav: import("svelte").Component<$$ComponentProps, {
15
65
  BottomNavItem: typeof BottomNavItem;
16
66
  }, "">;
17
67
  type BottomNav = ReturnType<typeof BottomNav>;
@@ -1,4 +1,5 @@
1
1
  <!--
2
+ @component Breadcrumb
2
3
  =============================================================================
3
4
  @h-ai/ui - Breadcrumb 组件
4
5
  =============================================================================
@@ -6,16 +7,28 @@
6
7
 
7
8
  使用 Svelte 5 Runes ($props)
8
9
  =============================================================================
10
+
11
+ @example
12
+ ```ts
13
+ import { mount, unmount } from 'svelte'
14
+ import type { ComponentProps } from 'svelte'
15
+ import { Breadcrumb } from '@h-ai/ui'
16
+ const props: ComponentProps<typeof Breadcrumb> = { items: [{ label: '首页', href: '/' }, { label: '设置' }] }
17
+ const component = mount(Breadcrumb, { target: document.body, props })
18
+ await unmount(component)
19
+ ```
9
20
  -->
10
21
  <script lang='ts'>
11
- import type { BreadcrumbProps } from '../../types.js'
12
- import { cn } from '../../utils.js'
22
+ import type { BreadcrumbProps, DataAttributes } from '../../types.js'
23
+ import { cn, getDataAttributes } from '../../utils.js'
13
24
 
14
25
  const {
15
26
  items,
16
27
  class: className = '',
17
- }: BreadcrumbProps = $props()
28
+ ...restProps
29
+ }: BreadcrumbProps & DataAttributes = $props()
18
30
 
31
+ const dataAttributes = $derived(getDataAttributes(restProps))
19
32
  const breadcrumbClass = $derived(
20
33
  cn(
21
34
  'breadcrumbs text-sm',
@@ -24,9 +37,9 @@
24
37
  )
25
38
  </script>
26
39
 
27
- <div class={breadcrumbClass}>
40
+ <div {...dataAttributes} class={breadcrumbClass}>
28
41
  <ul>
29
- {#each items as item, index}
42
+ {#each items as item, index (item.href ?? `${item.label}:${index}`)}
30
43
  <li>
31
44
  {#if item.href && index < items.length - 1}
32
45
  <a href={item.href}>
@@ -1,4 +1,25 @@
1
- import type { BreadcrumbProps } from '../../types.js';
2
- declare const Breadcrumb: import("svelte").Component<BreadcrumbProps, {}, "">;
1
+ import type { BreadcrumbProps, DataAttributes } from '../../types.js';
2
+ type $$ComponentProps = BreadcrumbProps & DataAttributes;
3
+ /**
4
+ * Breadcrumb
5
+ * =============================================================================
6
+ * @h-ai/ui - Breadcrumb 组件
7
+ * =============================================================================
8
+ * 面包屑导航组件
9
+ *
10
+ * 使用 Svelte 5 Runes ($props)
11
+ * =============================================================================
12
+ *
13
+ * @example
14
+ * ```ts
15
+ * import { mount, unmount } from 'svelte'
16
+ * import type { ComponentProps } from 'svelte'
17
+ * import { Breadcrumb } from '@h-ai/ui'
18
+ * const props: ComponentProps<typeof Breadcrumb> = { items: [{ label: '首页', href: '/' }, { label: '设置' }] }
19
+ * const component = mount(Breadcrumb, { target: document.body, props })
20
+ * await unmount(component)
21
+ * ```
22
+ */
23
+ declare const Breadcrumb: import("svelte").Component<$$ComponentProps, {}, "">;
3
24
  type Breadcrumb = ReturnType<typeof Breadcrumb>;
4
25
  export default Breadcrumb;
@@ -11,18 +11,34 @@
11
11
  @prop {function} onchange - 日期变更回调
12
12
 
13
13
  @example
14
- ```svelte
15
- <script>
16
- import { CalendarDate } from '@internationalized/date'
17
- let date = $state(new CalendarDate(2024, 1, 15))
18
- </script>
19
- <Calendar bind:value={date} />
14
+ ```ts
15
+ import { mount, unmount } from 'svelte'
16
+ import type { ComponentProps } from 'svelte'
17
+ import { Calendar } from '@h-ai/ui'
18
+ const props: ComponentProps<typeof Calendar> = { weekStartsOn: 1 }
19
+ const component = mount(Calendar, { target: document.body, props })
20
+ await unmount(component)
20
21
  ```
21
22
  -->
22
23
  <script lang='ts'>
23
24
  import type { DateValue } from '@internationalized/date'
25
+ import type { DataAttributes } from '../../types.js'
24
26
  import { Calendar as BitsCalendar } from 'bits-ui'
27
+ import { getDataAttributes } from '../../utils.js'
25
28
 
29
+ /**
30
+ * Calendar 组件的属性契约;通过公开组件配置使用。
31
+ *
32
+ * @example
33
+ * ```ts
34
+ * import { mount, unmount } from 'svelte'
35
+ * import type { ComponentProps } from 'svelte'
36
+ * import { Calendar } from '@h-ai/ui'
37
+ * const props: ComponentProps<typeof Calendar> = { weekStartsOn: 1 }
38
+ * const component = mount(Calendar, { target: document.body, props })
39
+ * await unmount(component)
40
+ * ```
41
+ */
26
42
  interface Props {
27
43
  /** 选中日期(双向绑定) */
28
44
  value?: DateValue
@@ -57,10 +73,13 @@
57
73
  readonly: isReadonly = false,
58
74
  class: className = '',
59
75
  onchange,
60
- }: Props = $props()
76
+ ...restProps
77
+ }: Props & DataAttributes = $props()
78
+
79
+ const dataAttributes = $derived(getDataAttributes(restProps))
61
80
  </script>
62
81
 
63
- <div class={className}>
82
+ <div {...dataAttributes} class={className}>
64
83
  <BitsCalendar.Root
65
84
  type='single'
66
85
  bind:value
@@ -84,11 +103,11 @@
84
103
  </BitsCalendar.NextButton>
85
104
  </BitsCalendar.Header>
86
105
 
87
- {#each months as month}
106
+ {#each months as month (month.value.toString())}
88
107
  <BitsCalendar.Grid class='w-full border-collapse'>
89
108
  <BitsCalendar.GridHead>
90
109
  <BitsCalendar.GridRow class='flex w-full'>
91
- {#each weekdays as day}
110
+ {#each weekdays as day, weekdayIndex (weekdayIndex)}
92
111
  <BitsCalendar.HeadCell class='w-9 text-center text-xs font-medium text-base-content/50'>
93
112
  {day}
94
113
  </BitsCalendar.HeadCell>
@@ -97,9 +116,9 @@
97
116
  </BitsCalendar.GridHead>
98
117
 
99
118
  <BitsCalendar.GridBody>
100
- {#each month.weeks as weekDates}
119
+ {#each month.weeks as weekDates, weekIndex (weekIndex)}
101
120
  <BitsCalendar.GridRow class='flex w-full'>
102
- {#each weekDates as date}
121
+ {#each weekDates as date (date.toString())}
103
122
  <BitsCalendar.Cell {date} month={month.value} class='p-0'>
104
123
  <BitsCalendar.Day class='inline-flex size-9 items-center justify-center rounded-lg text-sm transition-colors hover:bg-base-200 data-[selected]:bg-primary data-[selected]:text-primary-content data-[disabled]:opacity-30 data-[unavailable]:line-through data-[unavailable]:opacity-30 data-[outside-month]:text-base-content/30'>
105
124
  {date.day}
@@ -1,4 +1,18 @@
1
1
  import type { DateValue } from '@internationalized/date';
2
+ import type { DataAttributes } from '../../types.js';
3
+ /**
4
+ * Calendar 组件的属性契约;通过公开组件配置使用。
5
+ *
6
+ * @example
7
+ * ```ts
8
+ * import { mount, unmount } from 'svelte'
9
+ * import type { ComponentProps } from 'svelte'
10
+ * import { Calendar } from '@h-ai/ui'
11
+ * const props: ComponentProps<typeof Calendar> = { weekStartsOn: 1 }
12
+ * const component = mount(Calendar, { target: document.body, props })
13
+ * await unmount(component)
14
+ * ```
15
+ */
2
16
  interface Props {
3
17
  /** 选中日期(双向绑定) */
4
18
  value?: DateValue;
@@ -21,6 +35,7 @@ interface Props {
21
35
  /** 日期变更回调 */
22
36
  onchange?: (value: DateValue | undefined) => void;
23
37
  }
38
+ type $$ComponentProps = Props & DataAttributes;
24
39
  /**
25
40
  * Calendar
26
41
  * 日历组件,基于 Bits UI headless + DaisyUI 样式。
@@ -34,14 +49,15 @@ interface Props {
34
49
  * @prop {function} onchange - 日期变更回调
35
50
  *
36
51
  * @example
37
- * ```svelte
38
- * <script>
39
- * import { CalendarDate } from '@internationalized/date'
40
- * let date = $state(new CalendarDate(2024, 1, 15))
41
- * </script>
42
- * <Calendar bind:value={date} />
52
+ * ```ts
53
+ * import { mount, unmount } from 'svelte'
54
+ * import type { ComponentProps } from 'svelte'
55
+ * import { Calendar } from '@h-ai/ui'
56
+ * const props: ComponentProps<typeof Calendar> = { weekStartsOn: 1 }
57
+ * const component = mount(Calendar, { target: document.body, props })
58
+ * await unmount(component)
43
59
  * ```
44
60
  */
45
- declare const Calendar: import("svelte").Component<Props, {}, "value" | "placeholder">;
61
+ declare const Calendar: import("svelte").Component<$$ComponentProps, {}, "value" | "placeholder">;
46
62
  type Calendar = ReturnType<typeof Calendar>;
47
63
  export default Calendar;
@@ -1,10 +1,20 @@
1
1
  <!--
2
2
  @component Card
3
3
  卡片组件,默认使用 border 而非 shadow,更现代克制。
4
+
5
+ @example
6
+ ```ts
7
+ import { mount, unmount, createRawSnippet } from 'svelte'
8
+ import type { ComponentProps } from 'svelte'
9
+ import { Card } from '@h-ai/ui'
10
+ const props: ComponentProps<typeof Card> = { title: '个人资料', bordered: true, children: createRawSnippet(() => ({ render: () => "<span>资料内容</span>" })) }
11
+ const component = mount(Card, { target: document.body, props })
12
+ await unmount(component)
13
+ ```
4
14
  -->
5
15
  <script lang='ts'>
6
- import type { CardProps } from '../../types.js'
7
- import { cn } from '../../utils.js'
16
+ import type { CardProps, DataAttributes } from '../../types.js'
17
+ import { cn, getDataAttributes } from '../../utils.js'
8
18
 
9
19
  const {
10
20
  title = '',
@@ -15,10 +25,12 @@
15
25
  header,
16
26
  footer,
17
27
  children,
18
- }: CardProps = $props()
28
+ ...restProps
29
+ }: CardProps & DataAttributes = $props()
19
30
 
31
+ const dataAttributes = $derived(getDataAttributes(restProps))
20
32
  const paddingMap = {
21
- 'none': '',
33
+ 'none': 'p-0',
22
34
  'xs': 'p-2',
23
35
  'sm': 'p-3',
24
36
  'md': 'p-4',
@@ -54,7 +66,7 @@
54
66
  )
55
67
  </script>
56
68
 
57
- <div class={cardClass}>
69
+ <div {...dataAttributes} class={cardClass}>
58
70
  <div class={bodyClass}>
59
71
  {#if header}
60
72
  <div class='card-title text-sm font-semibold'>
@@ -1,8 +1,19 @@
1
- import type { CardProps } from '../../types.js';
1
+ import type { CardProps, DataAttributes } from '../../types.js';
2
+ type $$ComponentProps = CardProps & DataAttributes;
2
3
  /**
3
4
  * Card
4
5
  * 卡片组件,默认使用 border 而非 shadow,更现代克制。
6
+ *
7
+ * @example
8
+ * ```ts
9
+ * import { mount, unmount, createRawSnippet } from 'svelte'
10
+ * import type { ComponentProps } from 'svelte'
11
+ * import { Card } from '@h-ai/ui'
12
+ * const props: ComponentProps<typeof Card> = { title: '个人资料', bordered: true, children: createRawSnippet(() => ({ render: () => "<span>资料内容</span>" })) }
13
+ * const component = mount(Card, { target: document.body, props })
14
+ * await unmount(component)
15
+ * ```
5
16
  */
6
- declare const Card: import("svelte").Component<CardProps, {}, "">;
17
+ declare const Card: import("svelte").Component<$$ComponentProps, {}, "">;
7
18
  type Card = ReturnType<typeof Card>;
8
19
  export default Card;