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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (380) hide show
  1. package/README.en.md +1062 -0
  2. package/README.ja.md +1062 -0
  3. package/README.md +696 -119
  4. package/auto-import.d.ts +49 -0
  5. package/auto-import.js +51 -69
  6. package/dist/components/compounds/Accordion.svelte +30 -3
  7. package/dist/components/compounds/Accordion.svelte.d.ts +37 -1
  8. package/dist/components/compounds/ActionSheet.svelte +35 -8
  9. package/dist/components/compounds/ActionSheet.svelte.d.ts +41 -1
  10. package/dist/components/compounds/Alert.svelte +24 -15
  11. package/dist/components/compounds/Alert.svelte.d.ts +14 -3
  12. package/dist/components/compounds/AppBar.svelte +37 -9
  13. package/dist/components/compounds/AppBar.svelte.d.ts +36 -1
  14. package/dist/components/compounds/BottomNav.svelte +68 -8
  15. package/dist/components/compounds/BottomNav.svelte.d.ts +51 -1
  16. package/dist/components/compounds/Breadcrumb.svelte +18 -5
  17. package/dist/components/compounds/Breadcrumb.svelte.d.ts +23 -2
  18. package/dist/components/compounds/Calendar.svelte +31 -12
  19. package/dist/components/compounds/Calendar.svelte.d.ts +23 -7
  20. package/dist/components/compounds/Card.svelte +17 -5
  21. package/dist/components/compounds/Card.svelte.d.ts +13 -2
  22. package/dist/components/compounds/Combobox.svelte +124 -42
  23. package/dist/components/compounds/Combobox.svelte.d.ts +42 -20
  24. package/dist/components/compounds/Confirm.svelte +32 -9
  25. package/dist/components/compounds/Confirm.svelte.d.ts +24 -2
  26. package/dist/components/compounds/DataTable.svelte +317 -33
  27. package/dist/components/compounds/DataTable.svelte.d.ts +28 -14
  28. package/dist/components/compounds/DatePicker.svelte +62 -18
  29. package/dist/components/compounds/DatePicker.svelte.d.ts +27 -8
  30. package/dist/components/compounds/Drawer.svelte +179 -22
  31. package/dist/components/compounds/Drawer.svelte.d.ts +24 -2
  32. package/dist/components/compounds/Dropdown.svelte +19 -5
  33. package/dist/components/compounds/Dropdown.svelte.d.ts +13 -2
  34. package/dist/components/compounds/Empty.svelte +22 -9
  35. package/dist/components/compounds/Empty.svelte.d.ts +23 -2
  36. package/dist/components/compounds/FilterBar.svelte +82 -0
  37. package/dist/components/compounds/FilterBar.svelte.d.ts +39 -0
  38. package/dist/components/compounds/Form.svelte +59 -16
  39. package/dist/components/compounds/Form.svelte.d.ts +23 -2
  40. package/dist/components/compounds/FormField.svelte +99 -16
  41. package/dist/components/compounds/FormField.svelte.d.ts +23 -2
  42. package/dist/components/compounds/FormLayout.svelte +71 -0
  43. package/dist/components/compounds/FormLayout.svelte.d.ts +17 -0
  44. package/dist/components/compounds/InfiniteScroll.svelte +34 -7
  45. package/dist/components/compounds/InfiniteScroll.svelte.d.ts +37 -1
  46. package/dist/components/compounds/JsonViewer.svelte +214 -0
  47. package/dist/components/compounds/JsonViewer.svelte.d.ts +26 -0
  48. package/dist/components/compounds/MessageBoxContainer.svelte +34 -0
  49. package/dist/components/compounds/MessageBoxContainer.svelte.d.ts +25 -0
  50. package/dist/components/compounds/MessageBoxDialog.svelte +209 -0
  51. package/dist/components/compounds/MessageBoxDialog.svelte.d.ts +29 -0
  52. package/dist/components/compounds/MessageContainer.svelte +24 -0
  53. package/dist/components/compounds/MessageContainer.svelte.d.ts +18 -0
  54. package/dist/components/compounds/Modal.svelte +348 -73
  55. package/dist/components/compounds/Modal.svelte.d.ts +13 -2
  56. package/dist/components/compounds/PageHeader.svelte +44 -20
  57. package/dist/components/compounds/PageHeader.svelte.d.ts +24 -9
  58. package/dist/components/compounds/Pagination.svelte +139 -105
  59. package/dist/components/compounds/Pagination.svelte.d.ts +23 -2
  60. package/dist/components/compounds/Popover.svelte +124 -25
  61. package/dist/components/compounds/Popover.svelte.d.ts +23 -2
  62. package/dist/components/compounds/PullRefresh.svelte +35 -8
  63. package/dist/components/compounds/PullRefresh.svelte.d.ts +35 -1
  64. package/dist/components/compounds/Result.svelte +17 -4
  65. package/dist/components/compounds/Result.svelte.d.ts +23 -2
  66. package/dist/components/compounds/SafeArea.svelte +30 -3
  67. package/dist/components/compounds/SafeArea.svelte.d.ts +35 -1
  68. package/dist/components/compounds/Skeleton.svelte +19 -7
  69. package/dist/components/compounds/Skeleton.svelte.d.ts +13 -2
  70. package/dist/components/compounds/Steps.svelte +17 -4
  71. package/dist/components/compounds/Steps.svelte.d.ts +23 -2
  72. package/dist/components/compounds/SwipeCell.svelte +30 -3
  73. package/dist/components/compounds/SwipeCell.svelte.d.ts +40 -1
  74. package/dist/components/compounds/TableToolbar.svelte +289 -0
  75. package/dist/components/compounds/TableToolbar.svelte.d.ts +69 -0
  76. package/dist/components/compounds/Tabs.svelte +84 -14
  77. package/dist/components/compounds/Tabs.svelte.d.ts +13 -2
  78. package/dist/components/compounds/TagInput.svelte +51 -33
  79. package/dist/components/compounds/TagInput.svelte.d.ts +23 -2
  80. package/dist/components/compounds/Timeline.svelte +30 -3
  81. package/dist/components/compounds/Timeline.svelte.d.ts +37 -1
  82. package/dist/components/compounds/ToastContainer.svelte +397 -28
  83. package/dist/components/compounds/ToastContainer.svelte.d.ts +27 -1
  84. package/dist/components/compounds/Tooltip.svelte +143 -9
  85. package/dist/components/compounds/Tooltip.svelte.d.ts +25 -2
  86. package/dist/components/compounds/accordion-types.d.ts +10 -1
  87. package/dist/components/compounds/action-sheet-types.d.ts +9 -0
  88. package/dist/components/compounds/bottom-nav-types.d.ts +9 -0
  89. package/dist/components/compounds/index.d.ts +7 -0
  90. package/dist/components/compounds/index.js +11 -0
  91. package/dist/components/compounds/swipe-cell-types.d.ts +9 -0
  92. package/dist/components/compounds/timeline-types.d.ts +9 -0
  93. package/dist/components/control-size.d.ts +35 -0
  94. package/dist/components/control-size.js +26 -0
  95. package/dist/components/primitives/Avatar.svelte +19 -5
  96. package/dist/components/primitives/Avatar.svelte.d.ts +13 -2
  97. package/dist/components/primitives/Badge.svelte +16 -4
  98. package/dist/components/primitives/Badge.svelte.d.ts +13 -2
  99. package/dist/components/primitives/BareButton.svelte +26 -12
  100. package/dist/components/primitives/BareButton.svelte.d.ts +23 -2
  101. package/dist/components/primitives/BareInput.svelte +57 -35
  102. package/dist/components/primitives/BareInput.svelte.d.ts +23 -2
  103. package/dist/components/primitives/Button.svelte +30 -9
  104. package/dist/components/primitives/Button.svelte.d.ts +13 -2
  105. package/dist/components/primitives/Checkbox.svelte +24 -5
  106. package/dist/components/primitives/Checkbox.svelte.d.ts +23 -2
  107. package/dist/components/primitives/IconButton.svelte +35 -10
  108. package/dist/components/primitives/IconButton.svelte.d.ts +23 -2
  109. package/dist/components/primitives/Input.svelte +56 -26
  110. package/dist/components/primitives/Input.svelte.d.ts +13 -2
  111. package/dist/components/primitives/Progress.svelte +17 -4
  112. package/dist/components/primitives/Progress.svelte.d.ts +23 -2
  113. package/dist/components/primitives/Radio.svelte +17 -4
  114. package/dist/components/primitives/Radio.svelte.d.ts +22 -2
  115. package/dist/components/primitives/Range.svelte +31 -4
  116. package/dist/components/primitives/Range.svelte.d.ts +37 -1
  117. package/dist/components/primitives/Rating.svelte +32 -5
  118. package/dist/components/primitives/Rating.svelte.d.ts +37 -1
  119. package/dist/components/primitives/Select.svelte +404 -47
  120. package/dist/components/primitives/Select.svelte.d.ts +23 -2
  121. package/dist/components/primitives/Spinner.svelte +17 -4
  122. package/dist/components/primitives/Spinner.svelte.d.ts +23 -2
  123. package/dist/components/primitives/Switch.svelte +22 -4
  124. package/dist/components/primitives/Switch.svelte.d.ts +23 -2
  125. package/dist/components/primitives/Tag.svelte +17 -4
  126. package/dist/components/primitives/Tag.svelte.d.ts +23 -2
  127. package/dist/components/primitives/Textarea.svelte +75 -30
  128. package/dist/components/primitives/Textarea.svelte.d.ts +24 -2
  129. package/dist/components/primitives/ToggleCheckbox.svelte +24 -10
  130. package/dist/components/primitives/ToggleCheckbox.svelte.d.ts +23 -2
  131. package/dist/components/primitives/ToggleInput.svelte +24 -10
  132. package/dist/components/primitives/ToggleInput.svelte.d.ts +23 -2
  133. package/dist/components/primitives/ToggleRadio.svelte +24 -10
  134. package/dist/components/primitives/ToggleRadio.svelte.d.ts +23 -2
  135. package/dist/components/scenes/ai/AiDocumentDownloadMenu.svelte +54 -23
  136. package/dist/components/scenes/ai/AiDocumentDownloadMenu.svelte.d.ts +30 -1
  137. package/dist/components/scenes/ai/AiDocumentEditor.svelte +3428 -693
  138. package/dist/components/scenes/ai/AiDocumentEditor.svelte.d.ts +26 -1
  139. package/dist/components/scenes/ai/MarkdownRenderer.svelte +119 -116
  140. package/dist/components/scenes/ai/MarkdownRenderer.svelte.d.ts +31 -1
  141. package/dist/components/scenes/ai/code-preview.d.ts +46 -0
  142. package/dist/components/scenes/ai/code-preview.js +141 -0
  143. package/dist/components/scenes/ai/document-download.d.ts +52 -0
  144. package/dist/components/scenes/ai/document-download.js +300 -79
  145. package/dist/components/scenes/ai/document-parse.d.ts +101 -11
  146. package/dist/components/scenes/ai/document-parse.js +212 -48
  147. package/dist/components/scenes/ai/document-types.d.ts +292 -75
  148. package/dist/components/scenes/ai/editor-markdown-extensions.d.ts +27 -0
  149. package/dist/components/scenes/ai/editor-markdown-extensions.js +216 -0
  150. package/dist/components/scenes/ai/highlight.d.ts +37 -0
  151. package/dist/components/scenes/ai/highlight.js +177 -0
  152. package/dist/components/scenes/ai/index.d.ts +5 -2
  153. package/dist/components/scenes/ai/index.js +3 -0
  154. package/dist/components/scenes/ai/markdown-parse.d.ts +11 -3
  155. package/dist/components/scenes/ai/markdown-parse.js +85 -47
  156. package/dist/components/scenes/ai/mermaid-host-sync.d.ts +72 -0
  157. package/dist/components/scenes/ai/mermaid-host-sync.js +65 -0
  158. package/dist/components/scenes/ai/mermaid-render.d.ts +30 -0
  159. package/dist/components/scenes/ai/mermaid-render.js +61 -0
  160. package/dist/components/scenes/ai/safe-html.d.ts +64 -0
  161. package/dist/components/scenes/ai/safe-html.js +345 -0
  162. package/dist/components/scenes/ai/table/AiTableEditor.svelte +1692 -0
  163. package/dist/components/scenes/ai/table/AiTableEditor.svelte.d.ts +32 -0
  164. package/dist/components/scenes/ai/table/table-types.d.ts +181 -0
  165. package/dist/components/scenes/ai/table/table-types.js +1 -0
  166. package/dist/components/scenes/app/FeedbackDetail.svelte +236 -0
  167. package/dist/components/scenes/app/FeedbackDetail.svelte.d.ts +40 -0
  168. package/dist/components/scenes/app/FeedbackForm.svelte +337 -0
  169. package/dist/components/scenes/app/FeedbackForm.svelte.d.ts +72 -0
  170. package/dist/components/scenes/app/FeedbackList.svelte +150 -0
  171. package/dist/components/scenes/app/FeedbackList.svelte.d.ts +28 -0
  172. package/dist/components/scenes/app/FeedbackModal.svelte +65 -139
  173. package/dist/components/scenes/app/FeedbackModal.svelte.d.ts +14 -39
  174. package/dist/components/scenes/app/FeedbackRecorder.svelte +154 -0
  175. package/dist/components/scenes/app/FeedbackRecorder.svelte.d.ts +9 -0
  176. package/dist/components/scenes/app/FeedbackReplay.svelte +142 -0
  177. package/dist/components/scenes/app/FeedbackReplay.svelte.d.ts +7 -0
  178. package/dist/components/scenes/app/FeedbackScreenshot.svelte +120 -0
  179. package/dist/components/scenes/app/FeedbackScreenshot.svelte.d.ts +8 -0
  180. package/dist/components/scenes/app/LanguageSwitch.svelte +38 -21
  181. package/dist/components/scenes/app/LanguageSwitch.svelte.d.ts +33 -20
  182. package/dist/components/scenes/app/SettingsLayout.svelte +115 -0
  183. package/dist/components/scenes/app/SettingsLayout.svelte.d.ts +54 -0
  184. package/dist/components/scenes/app/SettingsModal.svelte +33 -7
  185. package/dist/components/scenes/app/SettingsModal.svelte.d.ts +27 -1
  186. package/dist/components/scenes/app/ThemeColorPicker.svelte +240 -0
  187. package/dist/components/scenes/app/ThemeColorPicker.svelte.d.ts +57 -0
  188. package/dist/components/scenes/app/ThemeSelector.svelte +87 -26
  189. package/dist/components/scenes/app/ThemeSelector.svelte.d.ts +26 -7
  190. package/dist/components/scenes/app/ThemeToggle.svelte +27 -6
  191. package/dist/components/scenes/app/ThemeToggle.svelte.d.ts +24 -5
  192. package/dist/components/scenes/app/WorkspaceLayout.svelte +64 -0
  193. package/dist/components/scenes/app/WorkspaceLayout.svelte.d.ts +36 -0
  194. package/dist/components/scenes/app/feedback-functions.d.ts +57 -0
  195. package/dist/components/scenes/app/feedback-functions.js +107 -0
  196. package/dist/components/scenes/app/feedback-types.d.ts +224 -0
  197. package/dist/components/scenes/app/feedback-types.js +1 -0
  198. package/dist/components/scenes/app/index.d.ts +8 -1
  199. package/dist/components/scenes/app/index.js +7 -1
  200. package/dist/components/scenes/charts/Chart.svelte +186 -0
  201. package/dist/components/scenes/charts/Chart.svelte.d.ts +24 -0
  202. package/dist/components/scenes/charts/ChartLoadError.svelte +13 -0
  203. package/dist/components/scenes/charts/ChartLoadError.svelte.d.ts +6 -0
  204. package/dist/components/scenes/charts/DashboardGrid.svelte +34 -0
  205. package/dist/components/scenes/charts/DashboardGrid.svelte.d.ts +15 -0
  206. package/dist/components/scenes/charts/MetricCard.svelte +52 -0
  207. package/dist/components/scenes/charts/MetricCard.svelte.d.ts +15 -0
  208. package/dist/components/scenes/charts/ReportCard.svelte +48 -0
  209. package/dist/components/scenes/charts/ReportCard.svelte.d.ts +15 -0
  210. package/dist/components/scenes/charts/chart-presets.d.ts +15 -0
  211. package/dist/components/scenes/charts/chart-presets.js +19 -0
  212. package/dist/components/scenes/charts/chart-theme.d.ts +47 -0
  213. package/dist/components/scenes/charts/chart-theme.js +68 -0
  214. package/dist/components/scenes/charts/chart-types.d.ts +164 -0
  215. package/dist/components/scenes/charts/chart-types.js +7 -0
  216. package/dist/components/scenes/charts/dashboard-types.d.ts +79 -0
  217. package/dist/components/scenes/charts/dashboard-types.js +1 -0
  218. package/dist/components/scenes/charts/index.d.ts +12 -0
  219. package/dist/components/scenes/charts/index.js +10 -0
  220. package/dist/components/scenes/charts/renderers/AreaChart.svelte +19 -0
  221. package/dist/components/scenes/charts/renderers/AreaChart.svelte.d.ts +6 -0
  222. package/dist/components/scenes/charts/renderers/BarChart.svelte +19 -0
  223. package/dist/components/scenes/charts/renderers/BarChart.svelte.d.ts +6 -0
  224. package/dist/components/scenes/charts/renderers/LineChart.svelte +625 -0
  225. package/dist/components/scenes/charts/renderers/LineChart.svelte.d.ts +33 -0
  226. package/dist/components/scenes/charts/renderers/PieChart.svelte +19 -0
  227. package/dist/components/scenes/charts/renderers/PieChart.svelte.d.ts +6 -0
  228. package/dist/components/scenes/charts/renderers/ScatterChart.svelte +19 -0
  229. package/dist/components/scenes/charts/renderers/ScatterChart.svelte.d.ts +6 -0
  230. package/dist/components/scenes/crud/CrudDeleteConfirm.svelte +29 -11
  231. package/dist/components/scenes/crud/CrudDeleteConfirm.svelte.d.ts +13 -1
  232. package/dist/components/scenes/crud/CrudDetailDrawer.svelte +77 -22
  233. package/dist/components/scenes/crud/CrudDetailDrawer.svelte.d.ts +19 -4
  234. package/dist/components/scenes/crud/CrudDetailPanel.svelte +242 -0
  235. package/dist/components/scenes/crud/CrudDetailPanel.svelte.d.ts +66 -0
  236. package/dist/components/scenes/crud/CrudEditPanel.svelte +365 -0
  237. package/dist/components/scenes/crud/CrudEditPanel.svelte.d.ts +48 -0
  238. package/dist/components/scenes/crud/CrudFilterBar.svelte +17 -85
  239. package/dist/components/scenes/crud/CrudFilterBar.svelte.d.ts +13 -25
  240. package/dist/components/scenes/crud/CrudPage.svelte +564 -185
  241. package/dist/components/scenes/crud/CrudPage.svelte.d.ts +137 -51
  242. package/dist/components/scenes/crud/crud-controller.svelte.d.ts +335 -0
  243. package/dist/components/scenes/crud/crud-controller.svelte.js +276 -0
  244. package/dist/components/scenes/crud/crud-form-validation.d.ts +16 -0
  245. package/dist/components/scenes/crud/crud-form-validation.js +51 -0
  246. package/dist/components/scenes/crud/crud-types.d.ts +136 -43
  247. package/dist/components/scenes/crud/index.d.ts +9 -3
  248. package/dist/components/scenes/crud/index.js +8 -3
  249. package/dist/components/scenes/crud/nav-adapter.d.ts +50 -0
  250. package/dist/components/scenes/crud/nav-adapter.js +39 -0
  251. package/dist/components/scenes/crypto/EncryptedInput.svelte +63 -28
  252. package/dist/components/scenes/crypto/EncryptedInput.svelte.d.ts +38 -3
  253. package/dist/components/scenes/crypto/HashDisplay.svelte +30 -22
  254. package/dist/components/scenes/crypto/HashDisplay.svelte.d.ts +24 -1
  255. package/dist/components/scenes/crypto/SignatureDisplay.svelte +41 -40
  256. package/dist/components/scenes/crypto/SignatureDisplay.svelte.d.ts +24 -1
  257. package/dist/components/scenes/error/ErrorPage.svelte +135 -0
  258. package/dist/components/scenes/error/ErrorPage.svelte.d.ts +50 -0
  259. package/dist/components/scenes/error/error-presets.d.ts +60 -0
  260. package/dist/components/scenes/error/error-presets.js +51 -0
  261. package/dist/components/scenes/error/index.d.ts +8 -0
  262. package/dist/components/scenes/error/index.js +8 -0
  263. package/dist/components/scenes/guide/GuideHost.svelte +56 -0
  264. package/dist/components/scenes/guide/GuideHost.svelte.d.ts +35 -0
  265. package/dist/components/scenes/guide/GuideHostContent.svelte +136 -0
  266. package/dist/components/scenes/guide/GuideHostContent.svelte.d.ts +43 -0
  267. package/dist/components/scenes/guide/HelpCenter.svelte +135 -0
  268. package/dist/components/scenes/guide/HelpCenter.svelte.d.ts +40 -0
  269. package/dist/components/scenes/guide/index.d.ts +2 -0
  270. package/dist/components/scenes/guide/index.js +2 -0
  271. package/dist/components/scenes/iam/AgreementNotice.svelte +48 -0
  272. package/dist/components/scenes/iam/AgreementNotice.svelte.d.ts +7 -0
  273. package/dist/components/scenes/iam/AuthPanel.svelte +226 -0
  274. package/dist/components/scenes/iam/AuthPanel.svelte.d.ts +29 -0
  275. package/dist/components/scenes/iam/AuthShell.svelte +160 -0
  276. package/dist/components/scenes/iam/AuthShell.svelte.d.ts +56 -0
  277. package/dist/components/scenes/iam/ChangePasswordForm.svelte +84 -63
  278. package/dist/components/scenes/iam/ChangePasswordForm.svelte.d.ts +13 -1
  279. package/dist/components/scenes/iam/ForgotPasswordForm.svelte +113 -89
  280. package/dist/components/scenes/iam/ForgotPasswordForm.svelte.d.ts +24 -1
  281. package/dist/components/scenes/iam/LoginForm.svelte +215 -117
  282. package/dist/components/scenes/iam/LoginForm.svelte.d.ts +13 -1
  283. package/dist/components/scenes/iam/PasswordInput.svelte +79 -32
  284. package/dist/components/scenes/iam/PasswordInput.svelte.d.ts +30 -4
  285. package/dist/components/scenes/iam/PermGuard.svelte +21 -11
  286. package/dist/components/scenes/iam/PermGuard.svelte.d.ts +30 -0
  287. package/dist/components/scenes/iam/ReauthenticationDialog.svelte +68 -0
  288. package/dist/components/scenes/iam/ReauthenticationDialog.svelte.d.ts +17 -0
  289. package/dist/components/scenes/iam/RegisterForm.svelte +129 -116
  290. package/dist/components/scenes/iam/RegisterForm.svelte.d.ts +13 -1
  291. package/dist/components/scenes/iam/ResetPasswordForm.svelte +101 -88
  292. package/dist/components/scenes/iam/ResetPasswordForm.svelte.d.ts +13 -1
  293. package/dist/components/scenes/iam/SensitiveOperationsForm.svelte +76 -0
  294. package/dist/components/scenes/iam/SensitiveOperationsForm.svelte.d.ts +21 -0
  295. package/dist/components/scenes/iam/SessionRecoveryDialog.svelte +64 -0
  296. package/dist/components/scenes/iam/SessionRecoveryDialog.svelte.d.ts +22 -0
  297. package/dist/components/scenes/iam/UserProfile.svelte +47 -21
  298. package/dist/components/scenes/iam/UserProfile.svelte.d.ts +24 -1
  299. package/dist/components/scenes/iam/auth-captcha.d.ts +21 -0
  300. package/dist/components/scenes/iam/auth-captcha.js +23 -0
  301. package/dist/components/scenes/iam/auth-error-message.d.ts +13 -0
  302. package/dist/components/scenes/iam/auth-error-message.js +65 -0
  303. package/dist/components/scenes/iam/index.d.ts +10 -0
  304. package/dist/components/scenes/iam/index.js +9 -1
  305. package/dist/components/scenes/iam/password-utils.d.ts +33 -6
  306. package/dist/components/scenes/iam/password-utils.js +61 -8
  307. package/dist/components/scenes/iam/permission-context.svelte.d.ts +33 -23
  308. package/dist/components/scenes/iam/permission-context.svelte.js +20 -22
  309. package/dist/components/scenes/iam/sensitive-actions.svelte.d.ts +68 -0
  310. package/dist/components/scenes/iam/sensitive-actions.svelte.js +101 -0
  311. package/dist/components/scenes/iam/session-recovery.svelte.d.ts +44 -0
  312. package/dist/components/scenes/iam/session-recovery.svelte.js +57 -0
  313. package/dist/components/scenes/index.d.ts +3 -0
  314. package/dist/components/scenes/index.js +5 -0
  315. package/dist/components/scenes/storage/AvatarUpload.svelte +82 -68
  316. package/dist/components/scenes/storage/AvatarUpload.svelte.d.ts +23 -1
  317. package/dist/components/scenes/storage/FileList.svelte +19 -5
  318. package/dist/components/scenes/storage/FileList.svelte.d.ts +23 -1
  319. package/dist/components/scenes/storage/FileUpload.svelte +151 -96
  320. package/dist/components/scenes/storage/FileUpload.svelte.d.ts +24 -1
  321. package/dist/components/scenes/storage/ImageUpload.svelte +93 -94
  322. package/dist/components/scenes/storage/ImageUpload.svelte.d.ts +24 -1
  323. package/dist/components/scenes/types.d.ts +574 -42
  324. package/dist/guide-storage.d.ts +18 -0
  325. package/dist/guide-storage.js +79 -0
  326. package/dist/guide-types.d.ts +143 -0
  327. package/dist/guide-types.js +1 -0
  328. package/dist/guide.d.ts +3 -0
  329. package/dist/guide.js +3 -0
  330. package/dist/guide.svelte.d.ts +29 -0
  331. package/dist/guide.svelte.js +506 -0
  332. package/dist/i18n.svelte.d.ts +67 -4
  333. package/dist/i18n.svelte.js +106 -21
  334. package/dist/index.d.ts +6 -0
  335. package/dist/index.js +7 -0
  336. package/dist/internal/browser-safety.d.ts +88 -0
  337. package/dist/internal/browser-safety.js +140 -0
  338. package/dist/internal/dialog-focus.d.ts +21 -0
  339. package/dist/internal/dialog-focus.js +77 -0
  340. package/dist/internal/form-context.d.ts +92 -0
  341. package/dist/internal/form-context.js +70 -0
  342. package/dist/internal/form-validation.svelte.d.ts +70 -0
  343. package/dist/internal/form-validation.svelte.js +142 -0
  344. package/dist/internal/icon-safety.d.ts +14 -0
  345. package/dist/internal/icon-safety.js +40 -0
  346. package/dist/internal/locale.d.ts +21 -0
  347. package/dist/internal/locale.js +43 -0
  348. package/dist/message.svelte.d.ts +138 -0
  349. package/dist/message.svelte.js +149 -0
  350. package/dist/messagebox.svelte.d.ts +130 -0
  351. package/dist/messagebox.svelte.js +171 -0
  352. package/dist/messages/en-US.json +303 -16
  353. package/dist/messages/ja-JP.json +529 -0
  354. package/dist/messages/zh-CN.json +303 -16
  355. package/dist/messages.d.ts +25 -3
  356. package/dist/messages.js +23 -6
  357. package/dist/styles/design-tokens.css +4 -2
  358. package/dist/styles/eye-care.css +55 -0
  359. package/dist/styles/formal.css +55 -0
  360. package/dist/styles/global.css +86 -18
  361. package/dist/styles/guide.css +88 -0
  362. package/dist/styles/high-contrast.css +64 -0
  363. package/dist/styles/mobile.css +28 -0
  364. package/dist/styles/theme.css +43 -0
  365. package/dist/theme-config.d.ts +263 -10
  366. package/dist/theme-config.js +253 -17
  367. package/dist/toast.svelte.d.ts +210 -2
  368. package/dist/toast.svelte.js +305 -19
  369. package/dist/types.d.ts +787 -63
  370. package/dist/utils/platform.svelte.d.ts +28 -15
  371. package/dist/utils/platform.svelte.js +23 -16
  372. package/dist/utils.d.ts +121 -1
  373. package/dist/utils.js +208 -13
  374. package/dist/workspace-context.d.ts +20 -0
  375. package/dist/workspace-context.js +9 -0
  376. package/package.json +120 -24
  377. package/vite.d.ts +13 -0
  378. package/vite.js +96 -0
  379. package/dist/components/scenes/crud/CrudEditDrawer.svelte +0 -225
  380. package/dist/components/scenes/crud/CrudEditDrawer.svelte.d.ts +0 -48
@@ -2,20 +2,35 @@
2
2
  @component CrudPage
3
3
  通用 CRUD 页面组件
4
4
 
5
- 基于声明式资源定义,自动生成列表 + 搜索过滤 + 分页 + 详情抽屉 + 编辑/新建抽屉 + 删除确认。
5
+ 基于声明式资源定义,自动生成列表 + 搜索过滤 + 分页 + 详情查看 + 编辑/新建面板 + 删除确认。
6
6
 
7
7
  使用 Svelte 5 Runes ($props, $state, $derived, $effect)
8
- 使用 compounds 组件:Card, DataTable, PageHeader, Pagination, Drawer
8
+ 使用 compounds 组件:Card, DataTable, PageHeader, Pagination, Drawer, Modal
9
9
 
10
10
  @example
11
- <CrudPage crud={userCrud} data={data} permissions={{ create: true, update: true, delete: true }} />
11
+ ```svelte
12
+ <script lang="ts">
13
+ import { CrudPage, defineCrud } from '@h-ai/ui'
14
+ import type { CrudPageProps } from '@h-ai/ui'
15
+ const crud = defineCrud({ name: 'users', label: '用户', fields: [{ id: 'email', label: '邮箱', type: 'email', validation: { required: true } }], api: { list: async () => ({ items: [{ id: 'u1', email: 'ada@example.com' }], total: 1, page: 1, pageSize: 20 }) } })
16
+ const props: CrudPageProps = { crud, data: { items: [{ id: 'u1', email: 'ada@example.com' }], total: 1, page: 1, pageSize: 20 }, permissions: { create: true, update: true, delete: false } }
17
+ </script>
18
+ <CrudPage {...props} />
19
+ ```
12
20
  -->
13
21
  <script lang='ts'>
14
22
  import type { Snippet } from 'svelte'
15
- import type { Size } from '../../../types.js'
16
- import { goto, invalidateAll } from '$app/navigation'
17
- import { page } from '$app/state'
23
+ import type { DataAttributes } from '../../../types.js'
24
+ import type { WorkspaceContext } from '../../../workspace-context.js'
25
+ import type { CrudFieldDef } from './crud-controller.svelte.js'
26
+ import type { CrudDensity, CrudFormConfig, CrudPaginationConfig } from './crud-types.js'
27
+ import type { NavAdapter } from './nav-adapter.js'
28
+ import { getContext } from 'svelte'
29
+ import { SvelteURLSearchParams } from 'svelte/reactivity'
18
30
  import { uiM } from '../../../messages.js'
31
+ import { errorMessage as operationErrorMessage, toast, useToastFeedback } from '../../../toast.svelte.js'
32
+ import { getDataAttributes } from '../../../utils.js'
33
+ import { workspaceContextKey } from '../../../workspace-context.js'
19
34
  import Card from '../../compounds/Card.svelte'
20
35
  import DataTable from '../../compounds/DataTable.svelte'
21
36
  import PageHeader from '../../compounds/PageHeader.svelte'
@@ -23,65 +38,92 @@
23
38
  import Button from '../../primitives/Button.svelte'
24
39
  import IconButton from '../../primitives/IconButton.svelte'
25
40
  import CrudDeleteConfirm from './CrudDeleteConfirm.svelte'
26
- import CrudDetailDrawer from './CrudDetailDrawer.svelte'
27
- import CrudEditDrawer from './CrudEditDrawer.svelte'
41
+ import CrudDetailPanel from './CrudDetailPanel.svelte'
42
+ import CrudEditPanel from './CrudEditPanel.svelte'
28
43
  import CrudFilterBar from './CrudFilterBar.svelte'
44
+ import { createBrowserNavAdapter } from './nav-adapter.js'
29
45
 
30
46
  // ─── 类型定义 ───
31
47
 
32
- type FieldDef = {
33
- id: string
34
- label: string | (() => string)
35
- type: string
36
- inList?: boolean
37
- filterable?: boolean
38
- readonly?: boolean
39
- inCreate?: boolean
40
- inEdit?: boolean
41
- inDetail?: boolean
42
- options?: Array<{ label: string, value: string | number | boolean }> | (() => Array<{ label: string, value: string | number | boolean }>)
43
- validation?: { required?: boolean, min?: number, max?: number, pattern?: string, message?: string }
44
- width?: string
45
- align?: 'left' | 'center' | 'right'
46
- render?: (value: unknown, item: Record<string, unknown>) => string
47
- placeholder?: string | (() => string)
48
- defaultValue?: unknown
49
- order?: number
48
+ /**
49
+ * 详情/列表对字段定义的局部视图,不是独立的公开资源模型。
50
+ *
51
+ * @example 模块内部上下文
52
+ * ```ts
53
+ * const example: FieldDef = { id: 'email', label: '邮箱', type: 'email', inDetail: true }
54
+ * ```
55
+ */
56
+ type FieldDef = CrudFieldDef
57
+
58
+ // 使用 method shorthand 语法(双向协变)以兼容来自 @h-ai/kit 的 CrudOperations 类型
59
+ // 详见:https://www.typescriptlang.org/docs/handbook/release-notes/typescript-2-6.html#strict-function-types
60
+ /**
61
+ * CrudPage 使用的异步资源操作集合。
62
+ *
63
+ * @example 模块内部上下文
64
+ * ```ts
65
+ * const api: CrudApi = { list: async () => ({ items: [{ id: 'u1' }], total: 1, page: 1, pageSize: 20 }) }
66
+ * const page = await api.list({ page: 1 })
67
+ * ```
68
+ */
69
+ type CrudApi = {
70
+ /** 获取当前分页、筛选和排序结果。 */
71
+ list(params: Record<string, unknown>): Promise<{ items: Record<string, unknown>[], total: number, page: number, pageSize: number }>
72
+ /** 按主键获取一条记录。 */
73
+ get?(id: string): Promise<Record<string, unknown> | null>
74
+ /** 创建一条记录。 */
75
+ create?(data: Record<string, unknown>): Promise<Record<string, unknown>>
76
+ /** 更新一条记录。 */
77
+ update?(id: string, data: Record<string, unknown>): Promise<Record<string, unknown>>
78
+ /** 删除一条记录。 */
79
+ remove?(id: string): Promise<void>
50
80
  }
51
81
 
52
- type AnyApiFunc = (...args: unknown[]) => Promise<Record<string, unknown> | unknown> | Record<string, unknown> | unknown
53
-
82
+ /**
83
+ * 声明式 CRUD 资源及字段转换能力。
84
+ *
85
+ * @example 模块内部上下文
86
+ * ```ts
87
+ * const definition: CrudDef = crud
88
+ * const fields = definition.getListFields()
89
+ * ```
90
+ */
54
91
  type CrudDef = {
92
+ /** 资源元信息与后端 API。 */
55
93
  resource: {
94
+ /** 资源名称,用于识别当前业务实体。 */
56
95
  name: string
96
+ /** 资源标题文案。 */
57
97
  label: string | (() => string)
98
+ /** 记录主键字段,默认使用 id。 */
58
99
  keyField?: string
100
+ /** 资源字段定义。 */
59
101
  fields: FieldDef[]
102
+ /** 默认分页条数。 */
60
103
  defaultPageSize?: number
104
+ /** 是否显示搜索框。 */
61
105
  searchable?: boolean
106
+ /** 搜索框占位文案。 */
62
107
  searchPlaceholder?: string | (() => string)
63
- api: {
64
- list: AnyApiFunc
65
- get?: AnyApiFunc
66
- create?: AnyApiFunc
67
- update?: AnyApiFunc
68
- remove?: AnyApiFunc
69
- }
108
+ /** 资源 CRUD API。 */
109
+ api: CrudApi
70
110
  }
111
+ /** 获取列表字段。 */
71
112
  getListFields: () => FieldDef[]
113
+ /** 获取筛选字段。 */
72
114
  getFilterFields: () => FieldDef[]
115
+ /** 获取新建字段。 */
73
116
  getCreateFields: () => FieldDef[]
117
+ /** 获取编辑字段。 */
74
118
  getEditFields: () => FieldDef[]
119
+ /** 获取详情字段。 */
75
120
  getDetailFields: () => FieldDef[]
121
+ /** 转换为 DataTable 列定义。 */
76
122
  toTableColumns: () => Array<{ key: string, label: string, width?: string, align?: string, render?: (item: Record<string, unknown>) => string }>
123
+ /** 生成新建表单默认值。 */
77
124
  getDefaultValues: () => Record<string, unknown>
78
- api: {
79
- list: AnyApiFunc
80
- get?: AnyApiFunc
81
- create?: AnyApiFunc
82
- update?: AnyApiFunc
83
- remove?: AnyApiFunc
84
- }
125
+ /** API 操作代理。 */
126
+ api: CrudApi
85
127
  }
86
128
 
87
129
  // ─── Props ───
@@ -90,96 +132,280 @@
90
132
  crud,
91
133
  data,
92
134
  permissions = {},
93
- drawerSize = '2xl' as Size,
135
+ form = {},
136
+ pagination = {},
137
+ density = 'normal',
94
138
  rowClickDetail = true,
139
+ detailColumns = [],
140
+ showHeader,
95
141
  listItemActions,
142
+ tableCell,
143
+ onrowclick,
96
144
  editFormExtra,
97
145
  detailExtra,
98
146
  headerActions,
147
+ toolbarLeading,
148
+ toolbarActions,
149
+ card,
150
+ sortableColumns = [],
99
151
  onbeforedelete,
100
152
  onaftersubmit,
101
153
  onafterdelete,
102
154
  onerror,
103
155
  basePath = '',
156
+ nav = createBrowserNavAdapter(),
157
+ loading = false,
158
+ loaded = true,
159
+ error,
160
+ onRetry,
161
+ keepPreviousData = true,
104
162
  class: className = '',
163
+ ...restProps
105
164
  }: {
165
+ /** CRUD 资源定义及其 API 操作。 */
106
166
  crud: CrudDef
167
+ /** 当前页数据与服务端分页元数据。 */
107
168
  data: { items: Record<string, unknown>[], total: number, page: number, pageSize: number, filters?: Record<string, unknown> }
169
+ /** 新建、编辑、删除权限;未设置的权限默认跟随 API 是否存在。 */
108
170
  permissions?: { create?: boolean, update?: boolean, delete?: boolean }
109
- drawerSize?: Size
171
+ /** 新建/编辑面板展示配置。 */
172
+ form?: CrudFormConfig
173
+ /** 分页栏展示配置。 */
174
+ pagination?: CrudPaginationConfig
175
+ /** 列表密度,影响行高、操作按钮和面板控件尺寸。 */
176
+ density?: CrudDensity
177
+ /** 点击详情图标是否打开详情面板。 */
110
178
  rowClickDetail?: boolean
179
+ /** 点击后打开详情的列 key。 */
180
+ detailColumns?: string[]
181
+ /** 工作区导航已有标题时默认隐藏;可显式开启,独立使用时默认显示。 */
182
+ showHeader?: boolean
183
+ /** 每行额外操作按钮插槽。 */
111
184
  listItemActions?: Snippet<[Record<string, unknown>]>
185
+ /** 自定义表格单元格;参数依次为行记录和列 key。 */
186
+ tableCell?: Snippet<[Record<string, unknown>, string]>
187
+ /** 点击表格行时的回调。 */
188
+ onrowclick?: (item: Record<string, unknown>) => void
189
+ /** 编辑表单额外字段插槽。 */
112
190
  editFormExtra?: Snippet<[Record<string, unknown> | null, 'create' | 'edit']>
191
+ /** 详情面板额外内容插槽。 */
113
192
  detailExtra?: Snippet<[Record<string, unknown>]>
193
+ /** 页面标题右侧额外操作插槽。 */
114
194
  headerActions?: Snippet
195
+ /** 查询栏上方左侧内容插槽,可用于放置页面标题或说明。 */
196
+ toolbarLeading?: Snippet
197
+ /** 页面右侧自定义操作插槽。 */
198
+ toolbarActions?: Snippet
199
+ /** 卡片列表项渲染插槽;存在时替代 DataTable,仍复用工具栏、分页和独立滚动容器。 */
200
+ card?: Snippet<[Record<string, unknown>]>
201
+ /** 后端支持的可排序列;为空时不显示排序按钮。 */
202
+ sortableColumns?: Array<{ key: string, label: string }>
203
+ /** 删除前钩子,返回 false 时取消删除。 */
115
204
  onbeforedelete?: (item: Record<string, unknown>) => Promise<boolean> | boolean
205
+ /** 新建或编辑成功后的回调。 */
116
206
  onaftersubmit?: (item: Record<string, unknown>, mode: 'create' | 'edit') => void
207
+ /** 删除成功后的回调。 */
117
208
  onafterdelete?: (item: Record<string, unknown>) => void
209
+ /** 自定义错误回调。 */
118
210
  onerror?: (error: string) => void
211
+ /** 列表路由基础路径。 */
119
212
  basePath?: string
213
+ /**
214
+ * 路由适配器:用于读取当前 pathname、同步过滤参数到 URL、列表刷新。
215
+ * 默认使用 `createBrowserNavAdapter()`(基于 `globalThis.location`)。
216
+ * SvelteKit 应用应传入 `createSvelteKitNavAdapter()`(来自 `@h-ai/kit/client`),
217
+ * 以获得客户端跳转 + invalidateAll 体验。
218
+ */
219
+ nav?: NavAdapter
220
+ /** 列表是否正在加载;由外部控制器(`createCrudController`)提供,用于展示查询中占位。 */
221
+ loading?: boolean
222
+ /**
223
+ * 是否至少成功加载过一次。仅当 `loaded && total === 0` 时展示空状态,
224
+ * 避免首次请求未回时误显示“暂无数据”。默认 true 以兼容 SvelteKit SSR(数据随页面就绪)。
225
+ */
226
+ loaded?: boolean
227
+ /** 最新一轮加载错误;无可用数据时展示错误信息与重试按钮。 */
228
+ error?: Error | string
229
+ /** 点击“重试”回调;通常传入控制器的 `reload`。 */
230
+ onRetry?: () => void
231
+ /** 失败或刷新时是否保留旧数据(默认 true);为 false 时加载中展示查询中占位而非旧列表。 */
232
+ keepPreviousData?: boolean
233
+ /** 根节点自定义 class。 */
120
234
  class?: string
121
- } = $props()
122
-
235
+ } & DataAttributes = $props()
236
+
237
+ /** 透传到根节点的 data-* 属性。 */
238
+ const dataAttributes = $derived(getDataAttributes(restProps))
239
+ const workspace = getContext<WorkspaceContext | undefined>(workspaceContextKey)
240
+
241
+ // ─── 加载 / 空 / 错误展示态 ───
242
+
243
+ /** 是否已有可展示的数据行。 */
244
+ const hasItems = $derived(data.items.length > 0)
245
+ /** 加载失败且无可保留数据:整块替换为错误信息 + 重试。 */
246
+ const showErrorState = $derived(!!error && (!hasItems || !keepPreviousData))
247
+ /** 首次查询(或不保留旧数据时)尚无数据:展示查询中占位,避免误显示空状态。 */
248
+ const showQuerying = $derived(loading && !showErrorState && (!hasItems || !keepPreviousData))
249
+ /** 常规列表区块(含空状态);仅此区块内才可能出现“暂无数据”。 */
250
+ const showListRegion = $derived(!showErrorState && !showQuerying)
251
+ /** 列表可见但仍在刷新(保留旧数据):顶部细进度条提示。 */
252
+ const showRefreshing = $derived(showListRegion && loading && hasItems)
253
+ /** 保留旧数据时的错误细条 + 重试,不打断浏览已有列表。 */
254
+ const showErrorBanner = $derived(showListRegion && !!error && hasItems)
123
255
  // ─── 状态 ───
124
256
 
257
+ /** 表格行的主键字段。 */
125
258
  const keyField = $derived(crud.resource.keyField ?? 'id')
259
+ /** 当前资源的本地化标题。 */
126
260
  const resourceLabel = $derived(resolveText(crud.resource.label))
261
+ /** 同名导航已显示标题时,将页面操作并入筛选工具栏。 */
262
+ const effectiveShowHeader = $derived(showHeader ?? !workspace?.title)
263
+ /** 根据权限和 API 能力判断是否显示新建入口。 */
127
264
  const canCreate = $derived(permissions.create !== false && Boolean(crud.api.create))
265
+ /** 根据权限和 API 能力判断是否显示编辑入口。 */
128
266
  const canUpdate = $derived(permissions.update !== false && Boolean(crud.api.update))
267
+ /** 根据权限和 API 能力判断是否显示删除入口。 */
129
268
  const canDelete = $derived(permissions.delete !== false && Boolean(crud.api.remove))
269
+ /** 当前资源是否支持关键字搜索。 */
130
270
  const searchable = $derived(crud.resource.searchable !== false)
271
+ /** 是否使用紧凑列表密度。 */
272
+ const isCompact = $derived(density === 'compact')
273
+ /** 页面主体垂直间距;列表卡片会占满其余可用高度。 */
274
+ const pageGapClass = 'flex min-h-0 h-full min-w-0 flex-1 flex-col gap-3'
275
+ /** 行内操作按钮尺寸。 */
276
+ const actionButtonSize = $derived(isCompact ? 'xs' : 'sm')
277
+ /** 行内操作图标尺寸。 */
278
+ const actionIconClass = $derived(isCompact ? 'size-3.5' : 'size-4')
279
+ /** 分页组件尺寸。 */
280
+ const paginationSize = $derived(isCompact ? 'xs' : 'sm')
281
+ /**
282
+ * 列表承载容器样式;表格模式使用有边框的 Card,卡片模式移除该外壳以保留业务卡片的原始视觉层级。
283
+ * 两种模式均保留 flex 约束,避免数据区把底部分页推出父容器。
284
+ */
285
+ const listCardClass = $derived(
286
+ card
287
+ ? 'flex min-h-0 flex-1 flex-col overflow-hidden !rounded-none !border-0 !bg-transparent !shadow-none [&>.card-body]:min-h-0 [&>.card-body]:flex-1'
288
+ : 'flex min-h-0 flex-1 flex-col overflow-hidden rounded-xl border-base-content/8 !shadow-none [&>.card-body]:min-h-0 [&>.card-body]:flex-1 [&>.card-body]:gap-0',
289
+ )
290
+ /** 分页栏样式;shrink-0 保证它始终贴在卡片底部。 */
291
+ const paginationBarClass = 'mt-auto shrink-0 border-t border-base-content/8 px-3 py-2'
292
+
293
+ // 表单展示配置(抽屉 / 弹窗)
294
+ /** 编辑/新建面板类型。 */
295
+ const formVariant = $derived(form.variant ?? 'drawer')
296
+ /** 抽屉尺寸预设。 */
297
+ const formDrawerSize = $derived(form.drawerSize ?? '2xl')
298
+ /** 抽屉自定义宽度。 */
299
+ const formDrawerWidth = $derived(form.drawerWidth)
300
+ /** 是否允许拖动并记忆抽屉宽度。 */
301
+ const formDrawerResizable = $derived(form.drawerResizable !== false)
302
+ /** 同一资源的详情与编辑抽屉共享宽度记忆。 */
303
+ const formDrawerWidthStorageKey = $derived(`hai-ui:crud:${crud.resource.name}:drawer-width`)
304
+ /** 弹窗尺寸预设。 */
305
+ const formModalSize = $derived(form.modalSize ?? '2xl')
306
+ /** 弹窗自定义宽度。 */
307
+ const formModalWidth = $derived(form.modalWidth)
308
+ /** 弹窗自定义高度。 */
309
+ const formModalHeight = $derived(form.modalHeight)
310
+
311
+ // 分页栏配置
312
+ /** 是否显示每页条数选择器。 */
313
+ const paginationShowSizeChanger = $derived(pagination.showSizeChanger !== false)
314
+ /** 是否显示跳页输入框。 */
315
+ const paginationShowJumper = $derived(pagination.showJumper !== false)
316
+ /** 是否显示记录总数。 */
317
+ const paginationShowTotal = $derived(pagination.showTotal !== false)
318
+ /** 是否显示当前页 / 总页数文案。 */
319
+ const paginationShowPageInfo = $derived(pagination.showPageInfo !== false)
320
+ /** 是否显示首页和末页按钮。 */
321
+ const paginationShowFirstLast = $derived(pagination.showFirstLast !== false)
322
+ /** 每页条数候选项。 */
323
+ const paginationPageSizeOptions = $derived(pagination.pageSizeOptions ?? [10, 20, 50, 100])
131
324
 
132
325
  // 视图状态
133
- let drawerMode = $state<'detail' | 'edit' | 'create' | null>(null)
326
+ /** 当前打开的详情/编辑面板模式。 */
327
+ let panelMode = $state<'detail' | 'edit' | 'create' | null>(null)
328
+ /** 当前选中的列表记录。 */
134
329
  let selectedItem = $state<Record<string, unknown> | null>(null)
330
+ /** 编辑面板的草稿数据。 */
135
331
  let formData = $state<Record<string, unknown>>({})
332
+ /** 新建或编辑请求是否进行中。 */
136
333
  let submitting = $state(false)
334
+ /** 当前表单错误文案。 */
137
335
  let formError = $state('')
336
+ /** 删除确认框是否打开。 */
138
337
  let deleteConfirmOpen = $state(false)
338
+ /** 等待确认删除的记录。 */
139
339
  let deletingItem = $state<Record<string, unknown> | null>(null)
340
+ /** 删除请求是否进行中。 */
140
341
  let deleting = $state(false)
342
+ let deleteError = $state('')
141
343
 
142
344
  // 过滤状态
345
+ /** 搜索框当前值;提交时才同步到路由。 */
143
346
  let searchValue = $state('')
347
+ /** 筛选字段的当前草稿;查询时才提交。 */
144
348
  let filterValues = $state<Record<string, unknown>>({})
145
349
 
350
+ // 服务端排序状态由列头承接。
351
+ /** 当前服务端排序字段。 */
352
+ let sortBy = $state('')
353
+ /** 当前服务端排序方向。 */
354
+ let sortDirection = $state<'asc' | 'desc'>('desc')
355
+
146
356
  // 基础路径
147
- const currentBasePath = $derived(basePath || page.url.pathname)
357
+ /** 用于生成列表查询 URL 的基础路径。 */
358
+ const currentBasePath = $derived(basePath || nav.pathname)
148
359
 
149
360
  // ─── 工具函数 ───
150
361
 
362
+ /** 解析静态或延迟读取的显示文案。 */
151
363
  function resolveText(text: string | (() => string)): string {
152
364
  return typeof text === 'function' ? text() : text
153
365
  }
154
366
 
155
- // 同步 data.filters → 本地过滤状态
367
+ // 同步 data.filters → 本地过滤/排序状态;没有 filters 时也要清空旧状态。
156
368
  $effect(() => {
157
- if (data.filters) {
158
- searchValue = String(data.filters.search ?? '')
159
- const fv: Record<string, unknown> = {}
160
- for (const f of crud.getFilterFields()) {
161
- if (data.filters[f.id] !== undefined) {
162
- fv[f.id] = data.filters[f.id]
163
- }
369
+ const filters = data.filters ?? {}
370
+ searchValue = String(filters.search ?? '')
371
+ sortBy = String(filters.sortBy ?? '')
372
+ sortDirection = filters.sortDirection === 'asc' ? 'asc' : 'desc'
373
+ const fv: Record<string, unknown> = {}
374
+ for (const f of crud.getFilterFields()) {
375
+ if (filters[f.id] !== undefined) {
376
+ fv[f.id] = filters[f.id]
377
+ }
378
+ if (f.type.trim().toLowerCase() === 'date-range') {
379
+ const startKey = f.startKey ?? `${f.id}Start`
380
+ const endKey = f.endKey ?? `${f.id}End`
381
+ if (filters[startKey] !== undefined)
382
+ fv[startKey] = filters[startKey]
383
+ if (filters[endKey] !== undefined)
384
+ fv[endKey] = filters[endKey]
164
385
  }
165
- filterValues = fv
166
386
  }
387
+ filterValues = fv
167
388
  })
168
389
 
169
390
  // ─── 表格列 ───
170
391
 
392
+ /** 资源定义生成的基础列表列。 */
171
393
  const tableColumns = $derived(crud.toTableColumns())
172
-
173
394
  // ─── 导航 ───
174
395
 
175
- function navigateWithParams(overrides: Record<string, string | number>) {
176
- const params = new URLSearchParams()
396
+ /** 合并搜索、筛选、排序和分页状态,并交给宿主导航器刷新列表。 */
397
+ function navigateWithParams(overrides: Record<string, string | number>, conditions: Record<string, unknown> = data.filters ?? {}) {
398
+ /** 只包含有效值的查询参数容器。 */
399
+ const params = new SvelteURLSearchParams()
400
+ /** 当前状态与本次覆盖值合并后的完整查询对象。 */
177
401
  const merged: Record<string, string | number> = {
178
- search: searchValue,
402
+ search: String(data.filters?.search ?? ''),
179
403
  page: data.page,
180
404
  pageSize: data.pageSize,
405
+ sortBy,
406
+ sortDirection,
181
407
  ...Object.fromEntries(
182
- Object.entries(filterValues)
408
+ Object.entries(conditions).filter(([key]) => !['search', 'sortBy', 'sortDirection', 'page', 'pageSize'].includes(key))
183
409
  .filter(([, v]) => v !== undefined && v !== '')
184
410
  .map(([k, v]) => [k, String(v)]),
185
411
  ),
@@ -187,59 +413,83 @@
187
413
  }
188
414
 
189
415
  for (const [key, val] of Object.entries(merged)) {
416
+ /** 统一转换后的查询值。 */
190
417
  const strVal = String(val)
191
418
  if (strVal && strVal !== '' && !(key === 'page' && strVal === '1') && !(key === 'pageSize' && strVal === String(crud.resource.defaultPageSize ?? 20))) {
192
419
  params.set(key, strVal)
193
420
  }
194
421
  }
195
422
 
423
+ /** 序列化后的查询字符串。 */
196
424
  const qs = params.toString()
197
- goto(`${currentBasePath}${qs ? `?${qs}` : ''}`, { invalidateAll: true })
425
+ /** 交给宿主路由的目标 URL。 */
426
+ const url = `${currentBasePath}${qs ? `?${qs}` : ''}`
427
+ void Promise.resolve(nav.navigate(url)).then(() => nav.refresh?.())
198
428
  }
199
429
 
430
+ /** 提交关键字搜索并回到第一页。 */
200
431
  function handleSearch(search: string) {
201
- navigateWithParams({ search, page: 1 })
202
- }
203
-
204
- function handleFilterChange(filters: Record<string, unknown>) {
205
- const overrides: Record<string, string | number> = { page: 1 }
206
- for (const [k, v] of Object.entries(filters)) {
207
- overrides[k] = String(v ?? '')
208
- }
209
- navigateWithParams(overrides)
432
+ navigateWithParams({ search, page: 1 }, filterValues)
210
433
  }
211
434
 
435
+ /** 切换页码。 */
212
436
  function handlePageChange(newPage: number) {
213
437
  navigateWithParams({ page: newPage })
214
438
  }
215
439
 
440
+ /** 修改每页条数并回到第一页。 */
441
+ function handlePageSizeChange(newPageSize: number) {
442
+ navigateWithParams({ pageSize: newPageSize, page: 1 })
443
+ }
444
+
445
+ /** 清空搜索、筛选、排序并恢复默认分页。 */
446
+ function handleResetFilters() {
447
+ searchValue = ''
448
+ filterValues = {}
449
+ sortBy = ''
450
+ sortDirection = 'desc'
451
+ void Promise.resolve(nav.navigate(currentBasePath)).then(() => nav.refresh?.())
452
+ }
453
+
454
+ /** 提交服务端排序条件。 */
455
+ function handleSort(key: string, direction: 'asc' | 'desc') {
456
+ sortBy = key
457
+ sortDirection = direction
458
+ navigateWithParams({ sortBy: key, sortDirection: direction, page: 1 })
459
+ }
460
+
216
461
  // ─── 打开/关闭抽屉 ───
217
462
 
463
+ /** 打开记录详情面板。 */
218
464
  function openDetail(item: Record<string, unknown>) {
219
465
  selectedItem = item
220
- drawerMode = 'detail'
466
+ panelMode = 'detail'
221
467
  }
222
468
 
469
+ /** 打开新建面板并填充默认值。 */
223
470
  function openCreate() {
224
471
  selectedItem = null
225
472
  formData = { ...crud.getDefaultValues() }
226
473
  formError = ''
227
- drawerMode = 'create'
474
+ panelMode = 'create'
228
475
  }
229
476
 
477
+ /** 打开编辑面板并复制当前记录作为草稿。 */
230
478
  function openEdit(item: Record<string, unknown>) {
231
479
  selectedItem = item
232
480
  formData = { ...item }
233
481
  formError = ''
234
- drawerMode = 'edit'
482
+ panelMode = 'edit'
235
483
  }
236
484
 
237
- function closeDrawer() {
238
- drawerMode = null
485
+ /** 关闭详情或编辑面板并清理临时状态。 */
486
+ function closePanel() {
487
+ panelMode = null
239
488
  selectedItem = null
240
489
  formError = ''
241
490
  }
242
491
 
492
+ /** 将详情面板切换为当前记录的编辑面板。 */
243
493
  function switchToEdit() {
244
494
  if (selectedItem) {
245
495
  openEdit(selectedItem)
@@ -248,29 +498,36 @@
248
498
 
249
499
  // ─── 提交 ───
250
500
 
501
+ /** 根据当前面板模式调用新建或更新 API。 */
251
502
  async function handleSubmit(submitData: Record<string, unknown>) {
252
503
  formError = ''
253
504
  submitting = true
254
505
 
255
506
  try {
256
- if (drawerMode === 'create' && crud.api.create) {
507
+ if (panelMode === 'create' && crud.api.create) {
508
+ /** 创建 API 返回的记录;空返回时传递空对象以保持回调稳定。 */
257
509
  const result = await crud.api.create(submitData)
258
510
  const submitted = (result ?? {}) as Record<string, unknown>
259
- closeDrawer()
511
+ closePanel()
512
+ toast.success(uiM('crud_submit_success'))
260
513
  onaftersubmit?.(submitted, 'create')
261
- await invalidateAll()
514
+ await nav.refresh?.()
262
515
  }
263
- else if (drawerMode === 'edit' && crud.api.update && selectedItem) {
516
+ else if (panelMode === 'edit' && crud.api.update && selectedItem) {
517
+ /** 当前编辑记录的稳定主键。 */
264
518
  const id = String(selectedItem[keyField])
519
+ /** 更新 API 返回的记录。 */
265
520
  const result = await crud.api.update(id, submitData)
266
521
  const submitted = (result ?? {}) as Record<string, unknown>
267
- closeDrawer()
522
+ closePanel()
523
+ toast.success(uiM('crud_submit_success'))
268
524
  onaftersubmit?.(submitted, 'edit')
269
- await invalidateAll()
525
+ await nav.refresh?.()
270
526
  }
271
527
  }
272
528
  catch (e) {
273
- const msg = e instanceof Error ? e.message : uiM('crud_submit_failed')
529
+ /** 未知异常只显示本地化操作提示与关联编号。 */
530
+ const msg = operationErrorMessage(e, uiM('crud_submit_failed'))
274
531
  formError = msg
275
532
  onerror?.(msg)
276
533
  }
@@ -281,16 +538,19 @@
281
538
 
282
539
  // ─── 删除 ───
283
540
 
541
+ /** 打开删除确认框并记录待删除项。 */
284
542
  function requestDelete(item: Record<string, unknown>) {
285
543
  deletingItem = item
286
544
  deleteConfirmOpen = true
287
545
  }
288
546
 
547
+ /** 执行删除前钩子、删除请求和刷新流程。 */
289
548
  async function confirmDelete() {
290
549
  if (!deletingItem || !crud.api.remove)
291
550
  return
292
551
 
293
552
  if (onbeforedelete) {
553
+ /** 业务删除前钩子的最终决策。 */
294
554
  const proceed = await onbeforedelete(deletingItem)
295
555
  if (!proceed) {
296
556
  deleteConfirmOpen = false
@@ -300,34 +560,41 @@
300
560
  }
301
561
 
302
562
  deleting = true
563
+ deleteError = ''
303
564
  try {
565
+ /** 待删除记录的稳定主键。 */
304
566
  const id = String(deletingItem[keyField])
305
567
  await crud.api.remove(id)
568
+ /** 保留删除成功的记录,供回调在状态清空后使用。 */
306
569
  const deleted = deletingItem
307
570
  deleteConfirmOpen = false
308
571
  deletingItem = null
309
572
  // 如果删除的是当前详情/编辑中的项,关闭抽屉
310
573
  if (selectedItem && String(selectedItem[keyField]) === id) {
311
- closeDrawer()
574
+ closePanel()
312
575
  }
576
+ toast.success(uiM('crud_delete_success'))
313
577
  onafterdelete?.(deleted)
314
- await invalidateAll()
578
+ await nav.refresh?.()
315
579
  }
316
580
  catch (e) {
317
- const msg = e instanceof Error ? e.message : uiM('crud_delete_failed')
318
- onerror?.(msg)
581
+ /** 删除失败提示。 */
582
+ deleteError = operationErrorMessage(e, uiM('crud_delete_failed'))
583
+ onerror?.(deleteError)
319
584
  }
320
585
  finally {
321
586
  deleting = false
322
587
  }
323
588
  }
324
589
 
590
+ /** 取消删除并清理确认状态。 */
325
591
  function cancelDelete() {
326
592
  deleteConfirmOpen = false
327
593
  deletingItem = null
328
594
  }
329
595
 
330
596
  // 搜索占位符
597
+ /** 搜索框最终显示的占位文案。 */
331
598
  const searchPlaceholderText = $derived(
332
599
  crud.resource.searchPlaceholder
333
600
  ? resolveText(crud.resource.searchPlaceholder)
@@ -335,157 +602,269 @@
335
602
  )
336
603
 
337
604
  // 构建编辑/新建字段
605
+ /** 新建面板字段。 */
338
606
  const createFields = $derived(crud.getCreateFields() as FieldDef[])
607
+ /** 编辑面板字段。 */
339
608
  const editFields = $derived(crud.getEditFields() as FieldDef[])
609
+ /** 详情面板字段。 */
340
610
  const detailFields = $derived(crud.getDetailFields() as FieldDef[])
611
+ /** 工具栏筛选字段。 */
341
612
  const filterFields = $derived(crud.getFilterFields() as FieldDef[])
342
613
 
343
614
  // 抽屉标题
344
- const drawerTitle = $derived(
345
- drawerMode === 'create'
615
+ /** 当前详情/编辑面板标题。 */
616
+ const panelTitle = $derived(
617
+ panelMode === 'create'
346
618
  ? `${uiM('crud_create')}${resourceLabel}`
347
- : drawerMode === 'edit'
619
+ : panelMode === 'edit'
348
620
  ? `${uiM('crud_edit')}${resourceLabel}`
349
621
  : `${resourceLabel}${uiM('crud_detail')}`,
350
622
  )
351
623
 
352
- // 抽屉 open 状态
353
- const detailOpen = $derived(drawerMode === 'detail')
354
- const editOpen = $derived(drawerMode === 'create' || drawerMode === 'edit')
624
+ // 面板 open 状态
625
+ /** 详情面板开关。 */
626
+ const detailOpen = $derived(panelMode === 'detail')
627
+ /** 编辑/新建面板开关。 */
628
+ const editOpen = $derived(panelMode === 'create' || panelMode === 'edit')
355
629
 
356
630
  // 用于 DataTable 的 columns(含自定义渲染)
631
+ /** DataTable 列定义,补充受控排序所需的列元数据。 */
357
632
  const dtColumns = $derived(
358
633
  tableColumns.map(col => ({
359
634
  key: col.key,
360
635
  label: col.label,
361
636
  width: col.width,
362
637
  align: col.align as 'left' | 'center' | 'right' | undefined,
638
+ sortable: sortableColumns.some(column => column.key === col.key),
363
639
  render: col.render
364
640
  ? (item: Record<string, unknown>) => col.render!(item)
365
641
  : undefined,
642
+ onclick: detailColumns.includes(col.key)
643
+ ? (item: Record<string, unknown>) => openDetail(item)
644
+ : undefined,
366
645
  })),
367
646
  )
647
+ useToastFeedback(() => error ? typeof error === 'string' ? error : uiM('crud_load_failed') : '')
648
+ useToastFeedback(() => deleteError)
368
649
  </script>
369
650
 
370
- <div class='space-y-4 {className}'>
371
- <!-- 页面标题 -->
372
- <PageHeader title={resourceLabel}>
373
- {#snippet actions()}
374
- {#if headerActions}
375
- {@render headerActions()}
376
- {/if}
377
- {#if canCreate}
378
- <Button variant='primary' onclick={openCreate}>
379
- <span class='icon-[tabler--plus] size-4.5 mr-1'></span>
380
- {uiM('crud_create')}
381
- </Button>
382
- {/if}
383
- {/snippet}
384
- </PageHeader>
385
-
386
- <!-- 搜索 + 过滤栏 -->
387
- {#if searchable || filterFields.length > 0}
388
- <Card>
389
- <CrudFilterBar
390
- {searchable}
391
- searchPlaceholder={searchPlaceholderText}
392
- bind:searchValue
393
- {filterFields}
394
- bind:filterValues
395
- total={data.total}
396
- onsearch={handleSearch}
397
- onfilterchange={handleFilterChange}
398
- />
399
- </Card>
400
- {/if}
401
-
402
- <!-- 数据列表 -->
403
- <Card>
404
- <DataTable
405
- data={data.items}
406
- columns={dtColumns}
407
- keyField={keyField}
408
- loading={false}
409
- >
410
- {#snippet actions(item)}
411
- {#if rowClickDetail}
412
- <IconButton
413
- variant='ghost'
414
- size='sm'
415
- ariaLabel={uiM('crud_detail')}
416
- onclick={() => openDetail(item)}
417
- >
418
- <span class='icon-[tabler--eye] size-4'></span>
419
- </IconButton>
420
- {/if}
421
- {#if canUpdate}
422
- <IconButton
423
- variant='ghost'
424
- size='sm'
425
- ariaLabel={uiM('crud_edit')}
426
- onclick={() => openEdit(item)}
427
- >
428
- <span class='icon-[tabler--edit] size-4'></span>
429
- </IconButton>
651
+ <div {...dataAttributes} class='{pageGapClass} {className}'>
652
+ <!-- 页面标题;toolbarLeading 承载标题时由调用方关闭,避免重复占用垂直空间。 -->
653
+ {#if effectiveShowHeader}
654
+ <PageHeader title={resourceLabel} class='mb-0 shrink-0'>
655
+ {#snippet actions()}
656
+ {#if headerActions}
657
+ {@render headerActions()}
430
658
  {/if}
431
- {#if canDelete}
432
- <IconButton
433
- variant='ghost'
434
- size='sm'
435
- ariaLabel={uiM('crud_delete')}
436
- onclick={() => requestDelete(item)}
437
- class='hover:text-error'
438
- >
439
- <span class='icon-[tabler--trash] size-4'></span>
440
- </IconButton>
441
- {/if}
442
- {#if listItemActions}
443
- {@render listItemActions(item)}
659
+ {#if canCreate}
660
+ <Button variant='primary' size='sm' onclick={openCreate} class='shadow-sm'>
661
+ <span class='icon-[tabler--plus] size-4.5 mr-1.5'></span>
662
+ {uiM('crud_create')}
663
+ </Button>
444
664
  {/if}
445
665
  {/snippet}
446
- </DataTable>
666
+ </PageHeader>
667
+ {/if}
668
+
669
+ {#if toolbarLeading || toolbarActions || (!effectiveShowHeader && (canCreate || headerActions))}
670
+ <div class='flex shrink-0 min-w-0 flex-wrap items-center justify-between gap-2'>
671
+ <div class='min-w-0 flex-1'>{#if toolbarLeading}{@render toolbarLeading()}{/if}</div>
672
+ <div class='flex max-w-full flex-wrap items-center gap-2'>
673
+ {#if !effectiveShowHeader && headerActions}{@render headerActions()}{/if}
674
+ {#if toolbarActions}{@render toolbarActions()}{/if}
675
+ {#if !effectiveShowHeader && canCreate}<Button variant='primary' size='sm' onclick={openCreate}><span class='icon-[tabler--plus] size-4' aria-hidden='true'></span>{uiM('crud_create')}</Button>{/if}
676
+ </div>
677
+ </div>
678
+ {/if}
679
+
680
+ <!-- 查询、数据区与分页共用卡片;数据区独立滚动。 -->
681
+ <Card padding='none' class={listCardClass}>
682
+ {#if searchable || filterFields.length > 0}
683
+ <CrudFilterBar class='shrink-0 border-b border-base-content/8 p-3' {searchable} searchPlaceholder={searchPlaceholderText} bind:searchValue {filterFields} bind:filterValues onsearch={handleSearch} onreset={handleResetFilters} />
684
+ {/if}
685
+ {#if showQuerying}
686
+ <!-- 首次查询:展示查询中占位,避免请求未回时误显示“暂无数据” -->
687
+ <div class='flex min-h-40 flex-1 flex-col items-center justify-center gap-2 px-4 py-10 text-sm text-base-content/55'>
688
+ <span class='loading loading-spinner loading-md text-base-content/40'></span>
689
+ <span>{uiM('crud_loading')}</span>
690
+ </div>
691
+ {:else if showErrorState}
692
+ <!-- 空数据区域保留可恢复状态,具体失败原因由 Toast 展示。 -->
693
+ <div class='flex min-h-40 flex-1 flex-col items-center justify-center gap-3 px-4 py-10 text-sm'>
694
+ <span class='icon-[tabler--alert-triangle] size-8 text-error/70'></span>
695
+ <p class='max-w-md text-center text-base-content/70'>{uiM('crud_load_failed')}</p>
696
+ {#if onRetry}
697
+ <Button size={actionButtonSize} onclick={() => onRetry?.()}>
698
+ <span class='icon-[tabler--refresh] mr-1 size-4'></span>
699
+ {uiM('crud_retry')}
700
+ </Button>
701
+ {/if}
702
+ </div>
703
+ {:else}
704
+ {#if showErrorBanner}
705
+ <!-- 保留旧数据时仍提供原地重试入口。 -->
706
+ <div class='flex justify-end border-b border-base-content/8 px-3 py-2 text-xs'>
707
+ {#if onRetry}
708
+ <button type='button' class='shrink-0 font-medium underline underline-offset-2' onclick={() => onRetry?.()}>{uiM('crud_retry')}</button>
709
+ {/if}
710
+ </div>
711
+ {/if}
712
+ {#if showRefreshing}
713
+ <!-- 保留旧数据的刷新态:顶部细进度提示 -->
714
+ <div class='h-0.5 w-full overflow-hidden'>
715
+ <div class='h-full w-1/3 animate-pulse rounded-full bg-primary/60'></div>
716
+ </div>
717
+ {/if}
718
+ {#if card}
719
+ <!-- 卡片视图使用独立滚动容器,分页栏始终保留在容器外。 -->
720
+ <div class='min-h-0 flex-1 overflow-auto pt-2'>
721
+ {#if hasItems}
722
+ <div class='grid min-h-full grid-cols-[repeat(auto-fill,minmax(min(100%,18rem),1fr))] content-start gap-3'>
723
+ {#each data.items as item (String(item[keyField]))}
724
+ {@render card(item)}
725
+ {/each}
726
+ </div>
727
+ {:else if loaded}
728
+ <div class='flex min-h-full items-center justify-center px-4 text-sm text-base-content/55'>
729
+ {uiM('data_table_empty')}
730
+ </div>
731
+ {:else}
732
+ <!-- 惰性页签尚未激活:既未加载也无数据,留白不显示空状态 -->
733
+ <div class='min-h-full'></div>
734
+ {/if}
735
+ </div>
736
+ {:else if loaded || hasItems}
737
+ <!-- DataTable 自身同时承接横向和纵向滚动,确保 sticky 表头与数据行共享滚动上下文。 -->
738
+ <DataTable
739
+ data={data.items}
740
+ columns={dtColumns}
741
+ keyField={keyField}
742
+ loading={false}
743
+ striped={false}
744
+ sortKey={sortBy || undefined}
745
+ sortDir={sortBy ? sortDirection : null}
746
+ onsort={handleSort}
747
+ class='min-h-0 min-w-0 flex-1 overflow-auto'
748
+ {density}
749
+ cell={tableCell}
750
+ {onrowclick}
751
+ >
752
+ {#snippet actions(item)}
753
+ {#if rowClickDetail}
754
+ <IconButton
755
+ variant='ghost'
756
+ size={actionButtonSize}
757
+ ariaLabel={uiM('crud_detail')}
758
+ onclick={(event) => {
759
+ event.stopPropagation()
760
+ openDetail(item)
761
+ }}
762
+ >
763
+ <span class='icon-[tabler--eye] {actionIconClass}'></span>
764
+ </IconButton>
765
+ {/if}
766
+ {#if canUpdate}
767
+ <IconButton
768
+ variant='ghost'
769
+ size={actionButtonSize}
770
+ ariaLabel={uiM('crud_edit')}
771
+ onclick={(event) => {
772
+ event.stopPropagation()
773
+ openEdit(item)
774
+ }}
775
+ >
776
+ <span class='icon-[tabler--edit] {actionIconClass}'></span>
777
+ </IconButton>
778
+ {/if}
779
+ {#if canDelete}
780
+ <IconButton
781
+ variant='ghost'
782
+ size={actionButtonSize}
783
+ ariaLabel={uiM('crud_delete')}
784
+ onclick={(event) => {
785
+ event.stopPropagation()
786
+ requestDelete(item)
787
+ }}
788
+ class='hover:text-error'
789
+ >
790
+ <span class='icon-[tabler--trash] {actionIconClass}'></span>
791
+ </IconButton>
792
+ {/if}
793
+ {#if listItemActions}
794
+ {@render listItemActions(item)}
795
+ {/if}
796
+ {/snippet}
797
+ </DataTable>
798
+ {:else}
799
+ <!-- 惰性页签未激活:既未加载也无数据,留白不显示空状态 -->
800
+ <div class='min-h-40 flex-1'></div>
801
+ {/if}
447
802
 
448
- <!-- 分页 -->
449
- {#if data.total > data.pageSize}
450
- <div class='flex justify-center p-4 border-t border-base-content/5'>
803
+ <!-- 分页栏:始终显示,支持每页条数选择与跳页(shadcn table 风格) -->
804
+ <div class={paginationBarClass}>
451
805
  <Pagination
452
806
  page={data.page}
453
807
  total={data.total}
454
808
  pageSize={data.pageSize}
455
- size='sm'
456
- showTotal
809
+ size={paginationSize}
810
+ showTotal={paginationShowTotal}
811
+ showJumper={paginationShowJumper}
812
+ showSizeChanger={paginationShowSizeChanger}
813
+ showPageInfo={paginationShowPageInfo}
814
+ showFirstLast={paginationShowFirstLast}
815
+ pageSizeOptions={paginationPageSizeOptions}
457
816
  onchange={handlePageChange}
817
+ onpagesizechange={handlePageSizeChange}
458
818
  />
459
819
  </div>
460
820
  {/if}
461
821
  </Card>
462
822
  </div>
463
823
 
464
- <!-- 详情抽屉 -->
465
- <CrudDetailDrawer
824
+ <!-- 详情:抽屉或弹窗 -->
825
+ <CrudDetailPanel
466
826
  open={detailOpen}
467
827
  item={selectedItem}
468
828
  fields={detailFields}
469
- title={drawerTitle}
470
- size={drawerSize}
829
+ {density}
830
+ title={panelTitle}
831
+ variant={formVariant}
832
+ size={formDrawerSize}
833
+ drawerWidth={formDrawerWidth}
834
+ drawerResizable={formDrawerResizable}
835
+ drawerWidthStorageKey={formDrawerWidthStorageKey}
836
+ modalSize={formModalSize}
837
+ modalWidth={formModalWidth}
838
+ modalHeight={formModalHeight}
471
839
  canEdit={canUpdate}
472
840
  onedit={switchToEdit}
473
- onclose={closeDrawer}
841
+ onclose={closePanel}
474
842
  {detailExtra}
475
843
  />
476
844
 
477
- <!-- 编辑/新建抽屉 -->
478
- <CrudEditDrawer
845
+ <!-- 编辑/新建:抽屉或弹窗 -->
846
+ <CrudEditPanel
479
847
  open={editOpen}
480
- mode={drawerMode === 'create' ? 'create' : 'edit'}
481
- fields={drawerMode === 'create' ? createFields : editFields}
848
+ mode={panelMode === 'create' ? 'create' : 'edit'}
849
+ fields={panelMode === 'create' ? createFields : editFields}
850
+ {density}
482
851
  bind:formData
483
- title={drawerTitle}
484
- size={drawerSize}
852
+ title={panelTitle}
853
+ variant={formVariant}
854
+ size={formDrawerSize}
855
+ drawerWidth={formDrawerWidth}
856
+ drawerResizable={formDrawerResizable}
857
+ drawerWidthStorageKey={formDrawerWidthStorageKey}
858
+ modalSize={formModalSize}
859
+ modalWidth={formModalWidth}
860
+ modalHeight={formModalHeight}
485
861
  {submitting}
486
862
  error={formError}
863
+ columns={form?.columns}
864
+ labelPosition={form?.labelPosition}
865
+ labelWidth={form?.labelWidth}
487
866
  onsubmit={handleSubmit}
488
- onclose={closeDrawer}
867
+ onclose={closePanel}
489
868
  {editFormExtra}
490
869
  editingItem={selectedItem}
491
870
  />