@h-ai/ui 0.1.0-alpha8 → 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
@@ -5,59 +5,252 @@
5
5
  @prop {T[]} data - 表格数据
6
6
  @prop {Column<T>[]} columns - 列配置
7
7
  @prop {keyof T} keyField - 用于唯一标识行的字段
8
+ @prop {Snippet<[T, string]>} cell - 单元格内容插槽
8
9
  @prop {Snippet<[T]>} actions - 操作按钮插槽
10
+ @prop {(item: T) => void} onrowclick - 行点击回调
11
+ @prop {(item: T) => void} columns[].onclick - 指定列的单元格点击回调
9
12
  @prop {Snippet} empty - 空状态插槽
10
13
  @prop {boolean} loading - 是否加载中
11
14
  @prop {boolean} striped - 是否斑马纹
12
15
  @prop {boolean} hoverable - 是否悬停高亮
16
+ @prop {'normal' | 'compact'} density - 显示密度,compact 为紧凑布局
13
17
 
14
18
  @example
15
- <DataTable
16
- data={users}
17
- columns={[
18
- { key: 'name', label: '姓名' },
19
- { key: 'email', label: '邮箱' },
20
- { key: 'createdAt', label: '创建时间', render: (item) => formatDate(item.createdAt) }
21
- ]}
22
- keyField="id"
23
- >
24
- {#snippet actions(item)}
25
- <Button size="xs" onclick={() => edit(item)}>编辑</Button>
26
- {/snippet}
27
- </DataTable>
19
+ ```ts
20
+ import { mount, unmount } from 'svelte'
21
+ import type { ComponentProps } from 'svelte'
22
+ import { DataTable } from '@h-ai/ui'
23
+ const Table = DataTable<{ id: string, name: string }>
24
+ const props: ComponentProps<typeof Table> = { data: [{ id: 'u1', name: 'Ada' }], keyField: 'id', columns: [{ key: 'name', label: '姓名', sortable: true }] }
25
+ const component = mount(Table, { target: document.body, props })
26
+ await unmount(component)
27
+ ```
28
28
  -->
29
29
  <script lang='ts' generics='T'>
30
30
  import type { Snippet } from 'svelte'
31
+ import type { DataAttributes } from '../../types.js'
31
32
  import { uiM } from '../../messages.js'
33
+ import { getDataAttributes } from '../../utils.js'
32
34
 
33
35
  const {
34
36
  data,
35
37
  columns,
36
38
  keyField,
39
+ cell,
37
40
  actions,
41
+ onrowclick,
38
42
  empty,
39
43
  loading = false,
40
44
  striped = true,
41
45
  hoverable = true,
46
+ density = 'normal',
47
+ sortKey,
48
+ sortDir,
49
+ onsort,
42
50
  class: className = '',
51
+ ...restProps
43
52
  }: {
44
53
  data: T[]
45
- columns: { key: keyof T | string, label: string, width?: string, align?: 'left' | 'center' | 'right', render?: (item: T) => string }[]
54
+ columns: { key: keyof T | string, label: string, width?: string, align?: 'left' | 'center' | 'right', sortable?: boolean, render?: (item: T) => string, onclick?: (item: T) => void }[]
46
55
  keyField: keyof T
56
+ /** 自定义单元格内容;参数依次为行记录和列 key。 */
57
+ cell?: Snippet<[T, string]>
47
58
  actions?: Snippet<[T]>
59
+ /** 点击数据行时的回调。 */
60
+ onrowclick?: (item: T) => void
48
61
  empty?: Snippet
49
62
  loading?: boolean
50
63
  striped?: boolean
51
64
  hoverable?: boolean
65
+ density?: 'normal' | 'compact'
66
+ /** 受控排序字段(提供 onsort 时由外部驱动,通常用于服务端排序) */
67
+ sortKey?: string
68
+ /** 受控排序方向 */
69
+ sortDir?: 'asc' | 'desc' | null
70
+ /** 排序回调;提供时为受控模式(不再对 data 做本地排序),否则组件内部对当前数据做客户端排序 */
71
+ onsort?: (key: string, dir: 'asc' | 'desc') => void
52
72
  class?: string
53
- } = $props()
73
+ } & DataAttributes = $props()
54
74
 
55
- type Column = { key: keyof T | string, label: string, width?: string, align?: 'left' | 'center' | 'right', render?: (item: T) => string }
75
+ /** 透传到根节点的 data-* 属性。 */
76
+ const dataAttributes = $derived(getDataAttributes(restProps))
77
+ /**
78
+ * DataTable 内部使用的列定义。
79
+ *
80
+ * @example
81
+ * ```ts
82
+ * import { mount, unmount } from 'svelte'
83
+ * import type { ComponentProps } from 'svelte'
84
+ * import { DataTable } from '@h-ai/ui'
85
+ * const Table = DataTable<{ id: string, name: string }>
86
+ * const props: ComponentProps<typeof Table> = { data: [{ id: 'u1', name: 'Ada' }], keyField: 'id', columns: [{ key: 'name', label: '姓名', sortable: true }] }
87
+ * const component = mount(Table, { target: document.body, props })
88
+ * await unmount(component)
89
+ * ```
90
+ */
91
+ type Column = {
92
+ /** 列对应的数据字段。 */
93
+ key: keyof T | string
94
+ /** 表头文案。 */
95
+ label: string
96
+ /** 列宽 CSS 值。 */
97
+ width?: string
98
+ /** 单元格对齐方式。 */
99
+ align?: 'left' | 'center' | 'right'
100
+ /** 是否允许点击表头排序。 */
101
+ sortable?: boolean
102
+ /** 自定义单元格格式化函数。 */
103
+ render?: (item: T) => string
104
+ /** 点击当前列单元格时的回调。 */
105
+ onclick?: (item: T) => void
106
+ }
107
+
108
+ // ─── 排序状态 ───
109
+ /** 是否由父组件接管排序;受控模式不复制和排序当前数据。 */
110
+ const controlled = $derived(typeof onsort === 'function')
111
+ // 非受控模式下的内部排序状态
112
+ /** 非受控模式下的本地排序字段。 */
113
+ let localSortKey = $state<string | null>(null)
114
+ /** 非受控模式下的本地排序方向。 */
115
+ let localSortDir = $state<'asc' | 'desc'>('asc')
116
+
117
+ /** 当前生效的排序字段。 */
118
+ const activeSortKey = $derived(controlled ? (sortKey ?? null) : localSortKey)
119
+ /** 当前生效的排序方向。 */
120
+ const activeSortDir = $derived<'asc' | 'desc' | null>(controlled ? (sortDir ?? null) : (localSortKey ? localSortDir : null))
121
+
122
+ /** 切换列排序,并在受控模式下通知父组件。 */
123
+ function toggleSort(col: Column) {
124
+ if (!col.sortable)
125
+ return
126
+ /** 统一为字符串的列 key,用于和受控排序字段比较。 */
127
+ const key = String(col.key)
128
+ /** 同一列再次点击时切换方向,否则从升序开始。 */
129
+ const nextDir: 'asc' | 'desc' = activeSortKey === key && activeSortDir === 'asc' ? 'desc' : 'asc'
130
+ if (controlled) {
131
+ onsort?.(key, nextDir)
132
+ return
133
+ }
134
+ localSortKey = key
135
+ localSortDir = nextDir
136
+ }
137
+
138
+ // 非受控模式:对当前数据做客户端排序(受控模式直接使用外部已排序数据)
139
+ /** 非受控模式的当前页客户端排序结果。 */
140
+ const sortedData = $derived.by(() => {
141
+ if (controlled || !localSortKey)
142
+ return data
143
+ /** 已确定的排序字段和方向。 */
144
+ const key = localSortKey
145
+ const dir = localSortDir
146
+ /** 复制输入数组,避免客户端排序改变父组件数据。 */
147
+ const copy = [...data]
148
+ copy.sort((a, b) => {
149
+ /** 两条记录的待比较值。 */
150
+ const av = (a as Record<string, unknown>)[key]
151
+ const bv = (b as Record<string, unknown>)[key]
152
+ if (av === bv)
153
+ return 0
154
+ if (av === null || av === undefined)
155
+ return 1
156
+ if (bv === null || bv === undefined)
157
+ return -1
158
+ /** 兼容数值和字符串字段的比较结果。 */
159
+ let cmp: number
160
+ if (typeof av === 'number' && typeof bv === 'number') {
161
+ cmp = av - bv
162
+ }
163
+ else {
164
+ cmp = String(av).localeCompare(String(bv), undefined, { numeric: true })
165
+ }
166
+ return dir === 'asc' ? cmp : -cmp
167
+ })
168
+ return copy
169
+ })
170
+
171
+ /** 按密度生成表格单元格间距。 */
172
+ const tableClass = $derived(
173
+ density === 'compact'
174
+ ? 'table table-sm w-full table-auto text-[12px] [&_thead_th]:px-3 [&_thead_th]:py-2 [&_tbody_td]:px-3 [&_tbody_td]:py-2'
175
+ : 'table w-full table-auto text-[13px] [&_thead_th]:px-4 [&_thead_th]:py-2.5 [&_tbody_td]:px-4 [&_tbody_td]:py-3',
176
+ )
177
+
178
+ /** 表头字号样式;分隔线由每个表头单元格独立绘制,避免 sticky 列形成不同的层叠效果。 */
179
+ const headerRowClass = $derived(
180
+ density === 'compact'
181
+ ? 'text-[11px] text-base-content/55'
182
+ : 'text-[12px] text-base-content/55',
183
+ )
56
184
 
185
+ /** 所有表头单元格共用同一条分隔线,确保普通列与 sticky 操作列的颜色和位置完全一致。 */
186
+ const headerCellDividerClass = `after:absolute after:inset-x-0 after:-bottom-px after:h-px after:bg-base-300 after:content-['']`
187
+
188
+ /** 数据行背景、悬停和分隔线样式;背景直接下发到每个单元格,避免 sticky 层透出下方内容。 */
189
+ const rowClass = $derived(
190
+ hoverable
191
+ ? `border-b border-base-content/5 transition-colors [&>td]:bg-base-100 ${striped ? 'even:[&>td]:bg-base-200' : ''} hover:[&>td]:[background-color:color-mix(in_oklab,var(--color-base-content)_3%,var(--color-base-100))] ${striped ? 'even:hover:[&>td]:[background-color:color-mix(in_oklab,var(--color-base-content)_3%,var(--color-base-200))]' : ''} last:border-b-0`
192
+ : `border-b border-base-content/5 [&>td]:bg-base-100 ${striped ? 'even:[&>td]:bg-base-200' : ''} last:border-b-0`,
193
+ )
194
+
195
+ /** 承载横向滚动的容器;固定操作列只在此容器中可能遮挡其他列。 */
196
+ let scrollContainer = $state<HTMLDivElement>()
197
+ /** 表格尺寸变化时需重新判断固定操作列是否已脱离其自然位置。 */
198
+ let tableElement = $state<HTMLTableElement>()
199
+ /** 仅在固定操作列覆盖滚动内容时显示其左侧分隔阴影。 */
200
+ let showActionColumnShadow = $state(false)
201
+
202
+ /**
203
+ * 固定列在滚动起点和终点都处于自然位置,不应产生视觉分割;
204
+ * 仅在横向滚动的中间区间覆盖其他列时才显示阴影,避免静态表格多出竖线。
205
+ */
206
+ function syncActionColumnShadow() {
207
+ if (!scrollContainer || !actions) {
208
+ showActionColumnShadow = false
209
+ return
210
+ }
211
+
212
+ const maxScrollLeft = scrollContainer.scrollWidth - scrollContainer.clientWidth
213
+ showActionColumnShadow = scrollContainer.scrollLeft > 1 && scrollContainer.scrollLeft < maxScrollLeft - 1
214
+ }
215
+
216
+ $effect(() => {
217
+ if (!scrollContainer || !tableElement || !actions) {
218
+ showActionColumnShadow = false
219
+ return
220
+ }
221
+
222
+ syncActionColumnShadow()
223
+ const resizeObserver = new ResizeObserver(syncActionColumnShadow)
224
+ resizeObserver.observe(scrollContainer)
225
+ resizeObserver.observe(tableElement)
226
+
227
+ return () => resizeObserver.disconnect()
228
+ })
229
+
230
+ /**
231
+ * 操作列严格按按钮内容的 max-content 宽度计算,不在少列时预留无效空白。
232
+ * 内容过宽时由表格外层已有的横向滚动容器承接,避免浏览器压缩或裁剪操作按钮。
233
+ */
234
+ const actionColumnClass = $derived(
235
+ `sticky right-0 z-10 w-max whitespace-nowrap text-center font-medium ${showActionColumnShadow ? 'shadow-[-1px_0_0_color-mix(in_srgb,var(--color-base-content)_10%,transparent)]' : ''}`,
236
+ )
237
+ /** 操作列表头复用统一分隔线,并保持不透明背景以遮挡横向滚动内容。 */
238
+ const actionHeaderClass = $derived(`${actionColumnClass} ${headerCellDividerClass} bg-base-100`)
239
+ /** 数据操作格的背景由 rowClass 统一下发,确保默认、斑马纹和 hover 状态一致且不透明。 */
240
+ const actionCellClass = $derived(actionColumnClass)
241
+ /** 操作按钮保持单行的固有宽度,既不强制填满单元格,也不会被其它列挤压。 */
242
+ const actionWrapClass = $derived(density === 'compact' ? 'inline-flex flex-nowrap items-center justify-center gap-0.5' : 'inline-flex flex-nowrap items-center justify-center gap-1')
243
+ /** 加载和空数据占位单元格样式。 */
244
+ const placeholderCellClass = $derived(density === 'compact' ? 'text-center py-6 text-base-content/40' : 'text-center py-8 text-base-content/40')
245
+ /** 未声明宽度的文本列最多占用的空间,保留其他列与操作列的可见区域。 */
246
+ const defaultContentMaxWidth = 'min(24rem, 40vw)'
247
+
248
+ /** 解析单元格值并应用自定义渲染、空值和时间戳格式化。 */
57
249
  function getValue(item: T, col: Column): string {
58
250
  if (col.render) {
59
251
  return col.render(item)
60
252
  }
253
+ /** 当前列的原始字段值。 */
61
254
  const value = item[col.key as keyof T]
62
255
  if (value === null || value === undefined) {
63
256
  return '-'
@@ -69,6 +262,7 @@
69
262
  return String(value)
70
263
  }
71
264
 
265
+ /** 将列对齐配置转换为 Tailwind 文本对齐类。 */
72
266
  function getAlignClass(align?: string): string {
73
267
  switch (align) {
74
268
  case 'center': return 'text-center'
@@ -76,35 +270,82 @@
76
270
  default: return 'text-left'
77
271
  }
78
272
  }
273
+
274
+ /**
275
+ * 为每列提供可压缩的优先宽度与下限。
276
+ * 显式宽度是调用方的布局契约,允许小于默认列宽;未设置宽度的列才保留 7rem 下限。
277
+ */
278
+ function getColumnStyle(col: Column): string {
279
+ if (!col.width) {
280
+ return 'width: auto; min-width: 7rem;'
281
+ }
282
+
283
+ /** 显式宽度仍受视口约束,同时通过 max-width 防止表格自动布局重新撑宽该列。 */
284
+ const boundedWidth = `min(${col.width}, 20vw)`
285
+ return `width: ${boundedWidth}; min-width: 0; max-width: ${boundedWidth};`
286
+ }
287
+
288
+ /**
289
+ * 限制表头和默认单元格内容的实际可用宽度。
290
+ * 仅给 th 设置 width 会被 table-auto 的内容尺寸重新撑开,必须同时限制 td 内的内容盒子。
291
+ */
292
+ function getContentStyle(col: Column): string {
293
+ const maxWidth = col.width ? `min(${col.width}, 20vw)` : defaultContentMaxWidth
294
+ return `max-width: ${maxWidth};`
295
+ }
79
296
  </script>
80
297
 
81
- <div class='overflow-x-auto {className}'>
82
- <table class='table w-full text-[13px]' class:table-zebra={striped}>
298
+ <div {...dataAttributes} bind:this={scrollContainer} class='overflow-x-auto {className}' onscroll={syncActionColumnShadow}>
299
+ <table bind:this={tableElement} class={tableClass} aria-busy={loading}>
83
300
  <thead>
84
- <tr class='text-xs text-base-content/50 border-b border-base-content/6'>
85
- {#each columns as col}
301
+ <tr class={headerRowClass}>
302
+ {#each columns as col (String(col.key))}
303
+ {@const isSorted = activeSortKey === String(col.key)}
86
304
  <th
87
- style={col.width ? `width: ${col.width}` : ''}
88
- class='{getAlignClass(col.align)} font-medium'
305
+ scope='col'
306
+ aria-sort={col.sortable ? (isSorted ? (activeSortDir === 'asc' ? 'ascending' : 'descending') : 'none') : undefined}
307
+ style={getColumnStyle(col)}
308
+ class='{getAlignClass(col.align)} {headerCellDividerClass} relative font-medium'
89
309
  >
90
- {col.label}
310
+ {#if col.sortable}
311
+ <button
312
+ type='button'
313
+ class='group inline-flex max-w-full min-w-0 select-none items-center gap-1 rounded-md px-1.5 py-0.5 -mx-1.5 font-medium transition-colors hover:bg-base-content/5 {isSorted ? 'text-base-content' : ''}'
314
+ style={getContentStyle(col)}
315
+ onclick={() => toggleSort(col)}
316
+ >
317
+ <span class='min-w-0 truncate'>{col.label}</span>
318
+ {#if isSorted && activeSortDir === 'asc'}
319
+ <span class='icon-[tabler--arrow-narrow-up] size-3.5 text-base-content/70'></span>
320
+ {:else if isSorted && activeSortDir === 'desc'}
321
+ <span class='icon-[tabler--arrow-narrow-down] size-3.5 text-base-content/70'></span>
322
+ {:else}
323
+ <span class='icon-[tabler--arrows-sort] size-3.5 text-base-content/30 group-hover:text-base-content/50'></span>
324
+ {/if}
325
+ </button>
326
+ {:else}
327
+ <div class='block min-w-0 truncate' style={getContentStyle(col)} title={col.label}>{col.label}</div>
328
+ {/if}
91
329
  </th>
92
330
  {/each}
93
331
  {#if actions}
94
- <th class='w-24 text-center font-medium'>{uiM('data_table_actions')}</th>
332
+ <th class='{actionHeaderClass} z-20'>{uiM('data_table_actions')}</th>
95
333
  {/if}
96
334
  </tr>
97
335
  </thead>
98
336
  <tbody>
99
337
  {#if loading}
100
338
  <tr>
101
- <td colspan={columns.length + (actions ? 1 : 0)} class='text-center py-8'>
102
- <span class='loading loading-spinner loading-sm'></span>
339
+ <td colspan={columns.length + (actions ? 1 : 0)} class={placeholderCellClass}>
340
+ <span role='status' class='inline-flex items-center gap-2'>
341
+ <span class='loading loading-spinner loading-sm' aria-hidden='true'></span>
342
+ <span>{uiM('common_loading')}</span>
343
+ </span>
103
344
  </td>
104
345
  </tr>
105
346
  {:else if data.length === 0}
106
347
  <tr>
107
- <td colspan={columns.length + (actions ? 1 : 0)} class='text-center py-8 text-base-content/40'>
348
+ <td colspan={columns.length + (actions ? 1 : 0)} class={placeholderCellClass}>
108
349
  {#if empty}
109
350
  {@render empty()}
110
351
  {:else}
@@ -113,14 +354,47 @@
113
354
  </td>
114
355
  </tr>
115
356
  {:else}
116
- {#each data as item (item[keyField])}
117
- <tr class={hoverable ? 'hover:bg-base-content/3 transition-colors' : ''}>
118
- {#each columns as col}
119
- <td class={getAlignClass(col.align)}>{getValue(item, col)}</td>
357
+ {#each sortedData as item (item[keyField])}
358
+ <tr class='{rowClass} {onrowclick ? 'cursor-pointer focus-visible:outline-2 focus-visible:outline-primary focus-visible:-outline-offset-2' : ''}'
359
+ tabindex={onrowclick ? 0 : undefined}
360
+ onclick={() => onrowclick?.(item)}
361
+ onkeydown={(event) => {
362
+ if (onrowclick && event.target === event.currentTarget && (event.key === 'Enter' || event.key === ' ')) {
363
+ event.preventDefault()
364
+ onrowclick(item)
365
+ }
366
+ }}
367
+ >
368
+ {#each columns as col (String(col.key))}
369
+ <td style={getColumnStyle(col)} class={getAlignClass(col.align)}>
370
+ {#if col.onclick}
371
+ <button
372
+ type='button'
373
+ class='block min-w-0 max-w-full cursor-pointer rounded-sm text-inherit hover:underline focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary'
374
+ style={getContentStyle(col)}
375
+ onclick={(event) => {
376
+ event.stopPropagation()
377
+ col.onclick?.(item)
378
+ }}
379
+ >
380
+ {#if cell}
381
+ {@render cell(item, String(col.key))}
382
+ {:else}
383
+ <span class='block min-w-0 truncate' title={getValue(item, col)}>{getValue(item, col)}</span>
384
+ {/if}
385
+ </button>
386
+ {:else if cell}
387
+ <div class='min-w-0' style={getContentStyle(col)}>
388
+ {@render cell(item, String(col.key))}
389
+ </div>
390
+ {:else}
391
+ <div class='block min-w-0 truncate' style={getContentStyle(col)} title={getValue(item, col)}>{getValue(item, col)}</div>
392
+ {/if}
393
+ </td>
120
394
  {/each}
121
395
  {#if actions}
122
- <td>
123
- <div class='flex items-center justify-center gap-1'>
396
+ <td class={actionCellClass}>
397
+ <div class={actionWrapClass}>
124
398
  {@render actions(item)}
125
399
  </div>
126
400
  </td>
@@ -131,3 +405,13 @@
131
405
  </tbody>
132
406
  </table>
133
407
  </div>
408
+
409
+ <style>
410
+ /* 表头层级必须高于固定操作数据格,避免纵向滚动时操作按钮覆盖表头。 */
411
+ thead {
412
+ position: sticky;
413
+ top: 0;
414
+ z-index: 20;
415
+ background: var(--color-base-100);
416
+ }
417
+ </style>
@@ -1,4 +1,5 @@
1
1
  import type { Snippet } from 'svelte';
2
+ import type { DataAttributes } from '../../types.js';
2
3
  declare function $$render<T>(): {
3
4
  props: {
4
5
  data: T[];
@@ -7,16 +8,29 @@ declare function $$render<T>(): {
7
8
  label: string;
8
9
  width?: string;
9
10
  align?: "left" | "center" | "right";
11
+ sortable?: boolean;
10
12
  render?: (item: T) => string;
13
+ onclick?: (item: T) => void;
11
14
  }[];
12
15
  keyField: keyof T;
16
+ /** 自定义单元格内容;参数依次为行记录和列 key。 */
17
+ cell?: Snippet<[T, string]>;
13
18
  actions?: Snippet<[T]>;
19
+ /** 点击数据行时的回调。 */
20
+ onrowclick?: (item: T) => void;
14
21
  empty?: Snippet;
15
22
  loading?: boolean;
16
23
  striped?: boolean;
17
24
  hoverable?: boolean;
25
+ density?: "normal" | "compact";
26
+ /** 受控排序字段(提供 onsort 时由外部驱动,通常用于服务端排序) */
27
+ sortKey?: string;
28
+ /** 受控排序方向 */
29
+ sortDir?: "asc" | "desc" | null;
30
+ /** 排序回调;提供时为受控模式(不再对 data 做本地排序),否则组件内部对当前数据做客户端排序 */
31
+ onsort?: (key: string, dir: "asc" | "desc") => void;
18
32
  class?: string;
19
- };
33
+ } & DataAttributes;
20
34
  exports: {};
21
35
  bindings: "";
22
36
  slots: {};
@@ -43,26 +57,26 @@ interface $$IsomorphicComponent {
43
57
  * @prop {T[]} data - 表格数据
44
58
  * @prop {Column<T>[]} columns - 列配置
45
59
  * @prop {keyof T} keyField - 用于唯一标识行的字段
60
+ * @prop {Snippet<[T, string]>} cell - 单元格内容插槽
46
61
  * @prop {Snippet<[T]>} actions - 操作按钮插槽
62
+ * @prop {(item: T) => void} onrowclick - 行点击回调
63
+ * @prop {(item: T) => void} columns[].onclick - 指定列的单元格点击回调
47
64
  * @prop {Snippet} empty - 空状态插槽
48
65
  * @prop {boolean} loading - 是否加载中
49
66
  * @prop {boolean} striped - 是否斑马纹
50
67
  * @prop {boolean} hoverable - 是否悬停高亮
68
+ * @prop {'normal' | 'compact'} density - 显示密度,compact 为紧凑布局
51
69
  *
52
70
  * @example
53
- * <DataTable
54
- * data={users}
55
- * columns={[
56
- * { key: 'name', label: '姓名' },
57
- * { key: 'email', label: '邮箱' },
58
- * { key: 'createdAt', label: '创建时间', render: (item) => formatDate(item.createdAt) }
59
- * ]}
60
- * keyField="id"
61
- * >
62
- * {#snippet actions(item)}
63
- * <Button size="xs" onclick={() => edit(item)}>编辑</Button>
64
- * {/snippet}
65
- * </DataTable>
71
+ * ```ts
72
+ * import { mount, unmount } from 'svelte'
73
+ * import type { ComponentProps } from 'svelte'
74
+ * import { DataTable } from '@h-ai/ui'
75
+ * const Table = DataTable<{ id: string, name: string }>
76
+ * const props: ComponentProps<typeof Table> = { data: [{ id: 'u1', name: 'Ada' }], keyField: 'id', columns: [{ key: 'name', label: '姓名', sortable: true }] }
77
+ * const component = mount(Table, { target: document.body, props })
78
+ * await unmount(component)
79
+ * ```
66
80
  */
67
81
  declare const DataTable: $$IsomorphicComponent;
68
82
  type DataTable<T> = InstanceType<typeof DataTable<T>>;
@@ -7,23 +7,43 @@
7
7
  @prop {DateValue} minValue - 最小可选日期
8
8
  @prop {DateValue} maxValue - 最大可选日期
9
9
  @prop {string} placeholder - 输入框占位文本
10
+ @prop {Size} size - 输入框尺寸
10
11
  @prop {boolean} disabled - 是否禁用
11
12
  @prop {string} error - 错误消息
12
13
  @prop {function} onchange - 日期变更回调
13
14
 
14
15
  @example
15
- ```svelte
16
- <script>
17
- import { CalendarDate } from '@internationalized/date'
18
- let date = $state(new CalendarDate(2024, 6, 15))
19
- </script>
20
- <DatePicker bind:value={date} />
16
+ ```ts
17
+ import { mount, unmount } from 'svelte'
18
+ import type { ComponentProps } from 'svelte'
19
+ import { DatePicker } from '@h-ai/ui'
20
+ const props: ComponentProps<typeof DatePicker> = { weekStartsOn: 1, size: 'md' }
21
+ const component = mount(DatePicker, { target: document.body, props })
22
+ await unmount(component)
21
23
  ```
22
24
  -->
23
25
  <script lang='ts'>
24
26
  import type { DateValue } from '@internationalized/date'
27
+ import type { DataAttributes, FormText, Size } from '../../types.js'
25
28
  import { DatePicker as BitsDatePicker } from 'bits-ui'
29
+ import { getFormFieldContext } from '../../internal/form-context.js'
30
+ import { resolveFormText, useControlFeedback } from '../../internal/form-validation.svelte.js'
31
+ import { cn, getDataAttributes } from '../../utils.js'
32
+ import { getFormControlSizeClasses } from '../control-size.js'
26
33
 
34
+ /**
35
+ * DatePicker 组件的属性契约;通过公开组件配置使用。
36
+ *
37
+ * @example
38
+ * ```ts
39
+ * import { mount, unmount } from 'svelte'
40
+ * import type { ComponentProps } from 'svelte'
41
+ * import { DatePicker } from '@h-ai/ui'
42
+ * const props: ComponentProps<typeof DatePicker> = { weekStartsOn: 1, size: 'md' }
43
+ * const component = mount(DatePicker, { target: document.body, props })
44
+ * await unmount(component)
45
+ * ```
46
+ */
27
47
  interface Props {
28
48
  /** 选中日期(双向绑定) */
29
49
  value?: DateValue
@@ -37,8 +57,10 @@
37
57
  isDateUnavailable?: (date: DateValue) => boolean
38
58
  /** 是否禁用 */
39
59
  disabled?: boolean
60
+ /** 尺寸 */
61
+ size?: Size
40
62
  /** 错误消息 */
41
- error?: string
63
+ error?: FormText
42
64
  /** 自定义类名 */
43
65
  class?: string
44
66
  /** 日期变更回调 */
@@ -52,13 +74,24 @@
52
74
  weekStartsOn = 1,
53
75
  isDateUnavailable,
54
76
  disabled = false,
77
+ size = 'md',
55
78
  error,
56
79
  class: className = '',
57
80
  onchange,
58
- }: Props = $props()
81
+ ...restProps
82
+ }: Props & DataAttributes = $props()
83
+
84
+ const dataAttributes = $derived(getDataAttributes(restProps))
85
+ const field = getFormFieldContext()
86
+ const uniqueId = $props.id()
87
+ const messageId = `${uniqueId}-message`
88
+ const localError = $derived(resolveFormText(error))
89
+ const effectiveError = $derived(field?.error || localError)
90
+ useControlFeedback(() => localError)
91
+ const sizeClasses = $derived(getFormControlSizeClasses(size))
59
92
  </script>
60
93
 
61
- <div class='fieldset w-full {className}'>
94
+ <div {...dataAttributes} class='fieldset w-full {className}'>
62
95
  <BitsDatePicker.Root
63
96
  bind:value
64
97
  {minValue}
@@ -68,12 +101,23 @@
68
101
  {disabled}
69
102
  onValueChange={v => onchange?.(v)}
70
103
  >
71
- <BitsDatePicker.Input class="input flex items-center gap-0.5 pr-2 {error ? 'input-error' : ''}">
104
+ <BitsDatePicker.Input
105
+ aria-labelledby={field?.labelId}
106
+ aria-describedby={[field?.messageId, localError && !field?.error ? messageId : ''].filter(Boolean).join(' ') || undefined}
107
+ class={cn(
108
+ 'flex w-full items-center gap-0.5 rounded-lg border bg-base-100 pr-2 transition-[border-color,box-shadow] duration-150',
109
+ sizeClasses.control,
110
+ effectiveError
111
+ ? 'border-error/60 focus-within:ring-2 focus-within:ring-error/15'
112
+ : 'border-base-content/15 hover:border-base-content/25 focus-within:border-primary/50 focus-within:ring-2 focus-within:ring-primary/10',
113
+ disabled && 'cursor-not-allowed opacity-50',
114
+ )}
115
+ >
72
116
  {#snippet children({ segments })}
73
- {#each segments as { part, value: segValue }}
117
+ {#each segments as { part, value: segValue }, index (`${part}-${index}`)}
74
118
  <BitsDatePicker.Segment
75
119
  {part}
76
- class='rounded px-0.5 py-0.5 text-sm tabular-nums focus:bg-primary focus:text-primary-content focus:outline-none data-[type=literal]:px-0 data-[type=literal]:text-base-content/50'
120
+ class='rounded px-0.5 py-0.5 tabular-nums focus:bg-primary focus:text-primary-content focus:outline-none data-[type=literal]:px-0 data-[type=literal]:text-base-content/50'
77
121
  >
78
122
  {segValue}
79
123
  </BitsDatePicker.Segment>
@@ -97,11 +141,11 @@
97
141
  </BitsDatePicker.NextButton>
98
142
  </BitsDatePicker.Header>
99
143
 
100
- {#each months as month}
144
+ {#each months as month (month.value.toString())}
101
145
  <BitsDatePicker.Grid class='w-full border-collapse'>
102
146
  <BitsDatePicker.GridHead>
103
147
  <BitsDatePicker.GridRow class='flex w-full'>
104
- {#each weekdays as day}
148
+ {#each weekdays as day, weekdayIndex (weekdayIndex)}
105
149
  <BitsDatePicker.HeadCell class='w-9 text-center text-xs font-medium text-base-content/50'>
106
150
  {day}
107
151
  </BitsDatePicker.HeadCell>
@@ -110,9 +154,9 @@
110
154
  </BitsDatePicker.GridHead>
111
155
 
112
156
  <BitsDatePicker.GridBody>
113
- {#each month.weeks as weekDates}
157
+ {#each month.weeks as weekDates, weekIndex (weekIndex)}
114
158
  <BitsDatePicker.GridRow class='flex w-full'>
115
- {#each weekDates as date}
159
+ {#each weekDates as date (date.toString())}
116
160
  <BitsDatePicker.Cell {date} month={month.value} class='p-0'>
117
161
  <BitsDatePicker.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'>
118
162
  {date.day}
@@ -129,7 +173,7 @@
129
173
  </BitsDatePicker.Content>
130
174
  </BitsDatePicker.Root>
131
175
 
132
- {#if error}
133
- <span class='fieldset-label text-error'>{error}</span>
176
+ {#if localError && !field?.error}
177
+ <p id={messageId} class='sr-only'>{localError}</p>
134
178
  {/if}
135
179
  </div>