@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
@@ -1,59 +1,83 @@
1
1
  import type { Snippet } from 'svelte';
2
- import type { Size } from '../../../types.js';
3
- type FieldDef = {
4
- id: string;
5
- label: string | (() => string);
6
- type: string;
7
- inList?: boolean;
8
- filterable?: boolean;
9
- readonly?: boolean;
10
- inCreate?: boolean;
11
- inEdit?: boolean;
12
- inDetail?: boolean;
13
- options?: Array<{
14
- label: string;
15
- value: string | number | boolean;
16
- }> | (() => Array<{
17
- label: string;
18
- value: string | number | boolean;
19
- }>);
20
- validation?: {
21
- required?: boolean;
22
- min?: number;
23
- max?: number;
24
- pattern?: string;
25
- message?: string;
26
- };
27
- width?: string;
28
- align?: 'left' | 'center' | 'right';
29
- render?: (value: unknown, item: Record<string, unknown>) => string;
30
- placeholder?: string | (() => string);
31
- defaultValue?: unknown;
32
- order?: number;
2
+ import type { DataAttributes } from '../../../types.js';
3
+ import type { CrudFieldDef } from './crud-controller.svelte.js';
4
+ import type { CrudDensity, CrudFormConfig, CrudPaginationConfig } from './crud-types.js';
5
+ import type { NavAdapter } from './nav-adapter.js';
6
+ /**
7
+ * 详情/列表对字段定义的局部视图,不是独立的公开资源模型。
8
+ *
9
+ * @example 模块内部上下文
10
+ * ```ts
11
+ * const example: FieldDef = { id: 'email', label: '邮箱', type: 'email', inDetail: true }
12
+ * ```
13
+ */
14
+ type FieldDef = CrudFieldDef;
15
+ /**
16
+ * CrudPage 使用的异步资源操作集合。
17
+ *
18
+ * @example 模块内部上下文
19
+ * ```ts
20
+ * const api: CrudApi = { list: async () => ({ items: [{ id: 'u1' }], total: 1, page: 1, pageSize: 20 }) }
21
+ * const page = await api.list({ page: 1 })
22
+ * ```
23
+ */
24
+ type CrudApi = {
25
+ /** 获取当前分页、筛选和排序结果。 */
26
+ list(params: Record<string, unknown>): Promise<{
27
+ items: Record<string, unknown>[];
28
+ total: number;
29
+ page: number;
30
+ pageSize: number;
31
+ }>;
32
+ /** 按主键获取一条记录。 */
33
+ get?(id: string): Promise<Record<string, unknown> | null>;
34
+ /** 创建一条记录。 */
35
+ create?(data: Record<string, unknown>): Promise<Record<string, unknown>>;
36
+ /** 更新一条记录。 */
37
+ update?(id: string, data: Record<string, unknown>): Promise<Record<string, unknown>>;
38
+ /** 删除一条记录。 */
39
+ remove?(id: string): Promise<void>;
33
40
  };
34
- type AnyApiFunc = (...args: unknown[]) => Promise<Record<string, unknown> | unknown> | Record<string, unknown> | unknown;
41
+ /**
42
+ * 声明式 CRUD 资源及字段转换能力。
43
+ *
44
+ * @example 模块内部上下文
45
+ * ```ts
46
+ * const definition: CrudDef = crud
47
+ * const fields = definition.getListFields()
48
+ * ```
49
+ */
35
50
  type CrudDef = {
51
+ /** 资源元信息与后端 API。 */
36
52
  resource: {
53
+ /** 资源名称,用于识别当前业务实体。 */
37
54
  name: string;
55
+ /** 资源标题文案。 */
38
56
  label: string | (() => string);
57
+ /** 记录主键字段,默认使用 id。 */
39
58
  keyField?: string;
59
+ /** 资源字段定义。 */
40
60
  fields: FieldDef[];
61
+ /** 默认分页条数。 */
41
62
  defaultPageSize?: number;
63
+ /** 是否显示搜索框。 */
42
64
  searchable?: boolean;
65
+ /** 搜索框占位文案。 */
43
66
  searchPlaceholder?: string | (() => string);
44
- api: {
45
- list: AnyApiFunc;
46
- get?: AnyApiFunc;
47
- create?: AnyApiFunc;
48
- update?: AnyApiFunc;
49
- remove?: AnyApiFunc;
50
- };
67
+ /** 资源 CRUD API。 */
68
+ api: CrudApi;
51
69
  };
70
+ /** 获取列表字段。 */
52
71
  getListFields: () => FieldDef[];
72
+ /** 获取筛选字段。 */
53
73
  getFilterFields: () => FieldDef[];
74
+ /** 获取新建字段。 */
54
75
  getCreateFields: () => FieldDef[];
76
+ /** 获取编辑字段。 */
55
77
  getEditFields: () => FieldDef[];
78
+ /** 获取详情字段。 */
56
79
  getDetailFields: () => FieldDef[];
80
+ /** 转换为 DataTable 列定义。 */
57
81
  toTableColumns: () => Array<{
58
82
  key: string;
59
83
  label: string;
@@ -61,17 +85,15 @@ type CrudDef = {
61
85
  align?: string;
62
86
  render?: (item: Record<string, unknown>) => string;
63
87
  }>;
88
+ /** 生成新建表单默认值。 */
64
89
  getDefaultValues: () => Record<string, unknown>;
65
- api: {
66
- list: AnyApiFunc;
67
- get?: AnyApiFunc;
68
- create?: AnyApiFunc;
69
- update?: AnyApiFunc;
70
- remove?: AnyApiFunc;
71
- };
90
+ /** API 操作代理。 */
91
+ api: CrudApi;
72
92
  };
73
93
  type $$ComponentProps = {
94
+ /** CRUD 资源定义及其 API 操作。 */
74
95
  crud: CrudDef;
96
+ /** 当前页数据与服务端分页元数据。 */
75
97
  data: {
76
98
  items: Record<string, unknown>[];
77
99
  total: number;
@@ -79,35 +101,99 @@ type $$ComponentProps = {
79
101
  pageSize: number;
80
102
  filters?: Record<string, unknown>;
81
103
  };
104
+ /** 新建、编辑、删除权限;未设置的权限默认跟随 API 是否存在。 */
82
105
  permissions?: {
83
106
  create?: boolean;
84
107
  update?: boolean;
85
108
  delete?: boolean;
86
109
  };
87
- drawerSize?: Size;
110
+ /** 新建/编辑面板展示配置。 */
111
+ form?: CrudFormConfig;
112
+ /** 分页栏展示配置。 */
113
+ pagination?: CrudPaginationConfig;
114
+ /** 列表密度,影响行高、操作按钮和面板控件尺寸。 */
115
+ density?: CrudDensity;
116
+ /** 点击详情图标是否打开详情面板。 */
88
117
  rowClickDetail?: boolean;
118
+ /** 点击后打开详情的列 key。 */
119
+ detailColumns?: string[];
120
+ /** 工作区导航已有标题时默认隐藏;可显式开启,独立使用时默认显示。 */
121
+ showHeader?: boolean;
122
+ /** 每行额外操作按钮插槽。 */
89
123
  listItemActions?: Snippet<[Record<string, unknown>]>;
124
+ /** 自定义表格单元格;参数依次为行记录和列 key。 */
125
+ tableCell?: Snippet<[Record<string, unknown>, string]>;
126
+ /** 点击表格行时的回调。 */
127
+ onrowclick?: (item: Record<string, unknown>) => void;
128
+ /** 编辑表单额外字段插槽。 */
90
129
  editFormExtra?: Snippet<[Record<string, unknown> | null, 'create' | 'edit']>;
130
+ /** 详情面板额外内容插槽。 */
91
131
  detailExtra?: Snippet<[Record<string, unknown>]>;
132
+ /** 页面标题右侧额外操作插槽。 */
92
133
  headerActions?: Snippet;
134
+ /** 查询栏上方左侧内容插槽,可用于放置页面标题或说明。 */
135
+ toolbarLeading?: Snippet;
136
+ /** 页面右侧自定义操作插槽。 */
137
+ toolbarActions?: Snippet;
138
+ /** 卡片列表项渲染插槽;存在时替代 DataTable,仍复用工具栏、分页和独立滚动容器。 */
139
+ card?: Snippet<[Record<string, unknown>]>;
140
+ /** 后端支持的可排序列;为空时不显示排序按钮。 */
141
+ sortableColumns?: Array<{
142
+ key: string;
143
+ label: string;
144
+ }>;
145
+ /** 删除前钩子,返回 false 时取消删除。 */
93
146
  onbeforedelete?: (item: Record<string, unknown>) => Promise<boolean> | boolean;
147
+ /** 新建或编辑成功后的回调。 */
94
148
  onaftersubmit?: (item: Record<string, unknown>, mode: 'create' | 'edit') => void;
149
+ /** 删除成功后的回调。 */
95
150
  onafterdelete?: (item: Record<string, unknown>) => void;
151
+ /** 自定义错误回调。 */
96
152
  onerror?: (error: string) => void;
153
+ /** 列表路由基础路径。 */
97
154
  basePath?: string;
155
+ /**
156
+ * 路由适配器:用于读取当前 pathname、同步过滤参数到 URL、列表刷新。
157
+ * 默认使用 `createBrowserNavAdapter()`(基于 `globalThis.location`)。
158
+ * SvelteKit 应用应传入 `createSvelteKitNavAdapter()`(来自 `@h-ai/kit/client`),
159
+ * 以获得客户端跳转 + invalidateAll 体验。
160
+ */
161
+ nav?: NavAdapter;
162
+ /** 列表是否正在加载;由外部控制器(`createCrudController`)提供,用于展示查询中占位。 */
163
+ loading?: boolean;
164
+ /**
165
+ * 是否至少成功加载过一次。仅当 `loaded && total === 0` 时展示空状态,
166
+ * 避免首次请求未回时误显示“暂无数据”。默认 true 以兼容 SvelteKit SSR(数据随页面就绪)。
167
+ */
168
+ loaded?: boolean;
169
+ /** 最新一轮加载错误;无可用数据时展示错误信息与重试按钮。 */
170
+ error?: Error | string;
171
+ /** 点击“重试”回调;通常传入控制器的 `reload`。 */
172
+ onRetry?: () => void;
173
+ /** 失败或刷新时是否保留旧数据(默认 true);为 false 时加载中展示查询中占位而非旧列表。 */
174
+ keepPreviousData?: boolean;
175
+ /** 根节点自定义 class。 */
98
176
  class?: string;
99
- };
177
+ } & DataAttributes;
100
178
  /**
101
179
  * CrudPage
102
180
  * 通用 CRUD 页面组件
103
181
  *
104
- * 基于声明式资源定义,自动生成列表 + 搜索过滤 + 分页 + 详情抽屉 + 编辑/新建抽屉 + 删除确认。
182
+ * 基于声明式资源定义,自动生成列表 + 搜索过滤 + 分页 + 详情查看 + 编辑/新建面板 + 删除确认。
105
183
  *
106
184
  * 使用 Svelte 5 Runes ($props, $state, $derived, $effect)
107
- * 使用 compounds 组件:Card, DataTable, PageHeader, Pagination, Drawer
185
+ * 使用 compounds 组件:Card, DataTable, PageHeader, Pagination, Drawer, Modal
108
186
  *
109
187
  * @example
110
- * <CrudPage crud={userCrud} data={data} permissions={{ create: true, update: true, delete: true }} />
188
+ * ```svelte
189
+ * <script lang="ts">
190
+ * import { CrudPage, defineCrud } from '@h-ai/ui'
191
+ * import type { CrudPageProps } from '@h-ai/ui'
192
+ * 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 }) } })
193
+ * 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 } }
194
+ * </script>
195
+ * <CrudPage {...props} />
196
+ * ```
111
197
  */
112
198
  declare const CrudPage: import("svelte").Component<$$ComponentProps, {}, "">;
113
199
  type CrudPage = ReturnType<typeof CrudPage>;
@@ -0,0 +1,335 @@
1
+ /**
2
+ * @h-ai/ui — CRUD 控制器(SPA 数据 + 导航托管)
3
+ *
4
+ * 为 `CrudPage` 提供两个框架级适配器,业务应用无需在各自项目里重复实现:
5
+ * 1. `defineCrud`:由声明式资源定义生成 `CrudPage` 所需的 `crud` 对象(字段筛选、列映射、默认值),
6
+ * 不依赖 `@h-ai/kit`,纯 SPA / Tauri / Capacitor 均可直接使用。
7
+ * 2. `createCrudController`:在纯客户端(无 SvelteKit SSR)下托管 `CrudPage` 的 `data` 与 `nav`,
8
+ * 把 `CrudPage` 通过 URL query 同步的搜索/过滤/分页参数解析回本地状态并重新拉取列表。
9
+ *
10
+ * 控制器特性:latest-wins(seq + AbortSignal 双保险)、失败保留旧数据、惰性加载、并发去重、
11
+ * 查询串回填地址栏(保留 pathname 与 hash,不整页跳转)。
12
+ *
13
+ * @module crud-controller
14
+ */
15
+ import type { PaginatedResult } from '@h-ai/core';
16
+ import type { FormColSpan } from '../../../types.js';
17
+ import type { NavAdapter } from './nav-adapter.js';
18
+ /**
19
+ * 字段展示形式;与 `CrudEditPanel` / `CrudFilterBar` 支持的类型对齐,保留 `string` 以兼容 `@h-ai/kit`。
20
+ *
21
+ * @example
22
+ * ```ts
23
+ * import type { CrudFieldType } from '@h-ai/ui'
24
+ * const example: CrudFieldType = 'email'
25
+ * ```
26
+ */
27
+ export type CrudFieldType = 'text' | 'string' | 'textarea' | 'select' | 'radio' | 'multi-select' | 'boolean' | 'checkbox' | 'email' | 'url' | 'tel' | 'password' | 'number' | 'date' | 'datetime' | 'date-range' | 'custom';
28
+ /**
29
+ * 可解析为字符串的文本值(支持 i18n 函数)。
30
+ *
31
+ * @example
32
+ * ```ts
33
+ * import type { CrudText } from '@h-ai/ui'
34
+ * const example: CrudText = () => '邮箱'
35
+ * ```
36
+ */
37
+ export type CrudText = string | (() => string);
38
+ /**
39
+ * 选项项(select / radio / multi-select)。
40
+ *
41
+ * @example
42
+ * ```ts
43
+ * import type { CrudOption } from '@h-ai/ui'
44
+ * const example: CrudOption = { label: '启用', value: true }
45
+ * ```
46
+ */
47
+ export interface CrudOption {
48
+ label: string;
49
+ value: string | number | boolean;
50
+ }
51
+ /**
52
+ * 字段定义(与 `CrudPage` 的字段模型对齐)。
53
+ *
54
+ * @example
55
+ * ```ts
56
+ * import type { CrudFieldDef } from '@h-ai/ui'
57
+ * const example: CrudFieldDef = { id: 'email', label: '邮箱', type: 'email', inList: true, validation: { required: true } }
58
+ * ```
59
+ */
60
+ export interface CrudFieldDef {
61
+ /** 字段 id(对应数据对象的属性名)。 */
62
+ id: string;
63
+ /** 字段标签(支持 i18n 函数)。 */
64
+ label: CrudText;
65
+ /** 字段类型。 */
66
+ type: CrudFieldType;
67
+ /** 是否在列表展示(默认 true)。 */
68
+ inList?: boolean;
69
+ /** 是否可过滤(默认 false)。 */
70
+ filterable?: boolean;
71
+ /** 是否只读(编辑态禁用)。 */
72
+ readonly?: boolean;
73
+ /** 是否在新建表单出现(默认 true)。 */
74
+ inCreate?: boolean;
75
+ /** 是否在编辑表单出现(默认 true)。 */
76
+ inEdit?: boolean;
77
+ /** 是否在详情出现(默认 true)。 */
78
+ inDetail?: boolean;
79
+ /** 选项(select / radio / multi-select),支持工厂函数。 */
80
+ options?: CrudOption[] | (() => CrudOption[]);
81
+ /** 校验规则。 */
82
+ validation?: {
83
+ required?: boolean;
84
+ min?: number;
85
+ max?: number;
86
+ pattern?: string;
87
+ message?: CrudText;
88
+ };
89
+ /** 表单占用列数,默认 auto;多行文本、多选等自动占两列。 */
90
+ colSpan?: FormColSpan;
91
+ /** 列宽(CSS)。 */
92
+ width?: string;
93
+ /** 列对齐。 */
94
+ align?: 'left' | 'center' | 'right';
95
+ /** 列表单元格自定义渲染。 */
96
+ render?: (value: unknown, item: Record<string, unknown>) => string;
97
+ /** 占位文本。 */
98
+ placeholder?: CrudText;
99
+ /** 日期范围起始值 key(仅 date-range,默认 `${id}Start`)。 */
100
+ startKey?: string;
101
+ /** 日期范围结束值 key(仅 date-range,默认 `${id}End`)。 */
102
+ endKey?: string;
103
+ /** 默认值(新建时)。 */
104
+ defaultValue?: unknown;
105
+ /** 排序权重(升序)。 */
106
+ order?: number;
107
+ }
108
+ /**
109
+ * 列表请求附加项;用于 latest-wins 取消旧请求。
110
+ *
111
+ * @example
112
+ * ```ts
113
+ * import type { CrudListOptions } from '@h-ai/ui'
114
+ * const example: CrudListOptions = { signal: new AbortController().signal }
115
+ * ```
116
+ */
117
+ export interface CrudListOptions {
118
+ /** 取消信号;旧请求被新请求取代时触发 abort。 */
119
+ signal?: AbortSignal;
120
+ }
121
+ /**
122
+ * CRUD API 集合。列表返回标准 `PaginatedResult<T>`,避免各页面重复 page/pageSize/total 映射。
123
+ * @typeParam T - 字段值或资源条目的数据类型。
124
+ *
125
+ * @example
126
+ * ```ts
127
+ * import type { CrudApi } from '@h-ai/ui'
128
+ * const example: CrudApi<Record<string, unknown>> = { list: async () => ({ items: [{ id: 'u1', email: 'ada@example.com' }], total: 1, page: 1, pageSize: 20 }) }
129
+ * ```
130
+ */
131
+ export interface CrudApi<T> {
132
+ /** 分页列表;第二参数携带取消信号,实现方可透传给 fetch。 */
133
+ list: (params: Record<string, unknown>, options?: CrudListOptions) => Promise<PaginatedResult<T>>;
134
+ /** 按主键获取单条。 */
135
+ get?: (id: string) => Promise<T | null>;
136
+ /** 创建一条记录。 */
137
+ create?: (data: Partial<T>) => Promise<T>;
138
+ /** 更新一条记录。 */
139
+ update?: (id: string, data: Partial<T>) => Promise<T>;
140
+ /** 删除一条记录。 */
141
+ remove?: (id: string) => Promise<void>;
142
+ }
143
+ /**
144
+ * 资源定义。
145
+ * @typeParam T - 字段值或资源条目的数据类型。
146
+ *
147
+ * @example
148
+ * ```ts
149
+ * import type { CrudResource } from '@h-ai/ui'
150
+ * const example: CrudResource<Record<string, unknown>> = { 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 }) } }
151
+ * ```
152
+ */
153
+ export interface CrudResource<T> {
154
+ /** 资源名称(用于识别业务实体)。 */
155
+ name: string;
156
+ /** 资源标题(支持 i18n 函数)。 */
157
+ label: CrudText;
158
+ /** 主键字段(默认 `id`)。 */
159
+ keyField?: string;
160
+ /** 字段定义列表。 */
161
+ fields: CrudFieldDef[];
162
+ /** 默认分页条数(默认 10)。 */
163
+ defaultPageSize?: number;
164
+ /** 是否显示搜索框(默认 true)。 */
165
+ searchable?: boolean;
166
+ /** 搜索框占位文案。 */
167
+ searchPlaceholder?: CrudText;
168
+ /** 资源 CRUD API。 */
169
+ api: CrudApi<T>;
170
+ }
171
+ /**
172
+ * DataTable 列定义(适配 `CrudPage`)。
173
+ *
174
+ * @example
175
+ * ```ts
176
+ * import type { CrudTableColumn } from '@h-ai/ui'
177
+ * const example: CrudTableColumn = { key: 'email', label: '邮箱', width: '16rem' }
178
+ * ```
179
+ */
180
+ export interface CrudTableColumn {
181
+ key: string;
182
+ label: string;
183
+ width?: string;
184
+ align?: 'left' | 'center' | 'right';
185
+ render?: (item: Record<string, unknown>) => string;
186
+ }
187
+ /**
188
+ * `CrudPage` 所需的 crud 对象形状(`defineCrud` 的返回值)。
189
+ * @typeParam T - 字段值或资源条目的数据类型。
190
+ *
191
+ * @example
192
+ * ```ts
193
+ * import { defineCrud } from '@h-ai/ui'
194
+ * import type { CrudDef } from '@h-ai/ui'
195
+ * const definition: CrudDef<Record<string, unknown>> = 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 }) } })
196
+ * const columns = definition.toTableColumns()
197
+ * ```
198
+ */
199
+ export interface CrudDef<T> {
200
+ resource: CrudResource<T>;
201
+ getListFields: () => CrudFieldDef[];
202
+ getFilterFields: () => CrudFieldDef[];
203
+ getCreateFields: () => CrudFieldDef[];
204
+ getEditFields: () => CrudFieldDef[];
205
+ getDetailFields: () => CrudFieldDef[];
206
+ toTableColumns: () => CrudTableColumn[];
207
+ getDefaultValues: () => Record<string, unknown>;
208
+ api: CrudApi<T>;
209
+ }
210
+ /**
211
+ * `CrudPage` 的 `data` 形状。
212
+ * @typeParam T - 字段值或资源条目的数据类型。
213
+ *
214
+ * @example
215
+ * ```ts
216
+ * import type { CrudData } from '@h-ai/ui'
217
+ * const example: CrudData<Record<string, unknown>> = { items: [{ id: 'u1', email: 'ada@example.com' }], total: 1, page: 1, pageSize: 20, filters: { active: true } }
218
+ * ```
219
+ */
220
+ export interface CrudData<T> {
221
+ items: T[];
222
+ total: number;
223
+ page: number;
224
+ pageSize: number;
225
+ filters: Record<string, unknown>;
226
+ }
227
+ /**
228
+ * CRUD 控制器:托管列表数据与 SPA 导航适配器。
229
+ * @typeParam T - 字段值或资源条目的数据类型。
230
+ *
231
+ * @example
232
+ * ```ts
233
+ * import { defineCrud, createCrudController } from '@h-ai/ui'
234
+ * import type { CrudController } from '@h-ai/ui'
235
+ * 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 }) } })
236
+ * const controller: CrudController<Record<string, unknown>> = createCrudController(crud, { autoLoad: false, syncUrl: false })
237
+ * await controller.load()
238
+ * if (controller.error) throw controller.error
239
+ * const users = controller.data.items
240
+ * ```
241
+ */
242
+ export interface CrudController<T> {
243
+ /** 传给 `<CrudPage data={...}>` 的响应式数据对象。 */
244
+ readonly data: CrudData<T>;
245
+ /** 传给 `<CrudPage nav={...}>` 的导航适配器(仅同步 query,不整页跳转)。 */
246
+ readonly nav: NavAdapter;
247
+ /** 首次或按需拉取当前参数;惰性页签用它在首次激活时启动查询。 */
248
+ load: () => Promise<void>;
249
+ /** 主动按当前参数重新拉取(写操作后或重试触发)。 */
250
+ reload: () => Promise<void>;
251
+ /** 当前是否有最新一轮列表请求尚未结束。 */
252
+ readonly loading: boolean;
253
+ /** 是否至少成功取得过一次列表响应。 */
254
+ readonly loaded: boolean;
255
+ /** 最新一轮请求错误;已有成功数据时仍保留原列表。 */
256
+ readonly error: Error | undefined;
257
+ }
258
+ /**
259
+ * CRUD 控制器创建选项。
260
+ *
261
+ * @example
262
+ * ```ts
263
+ * import type { CrudControllerOptions } from '@h-ai/ui'
264
+ * const example: CrudControllerOptions = { autoLoad: false, keepPreviousData: true, syncUrl: true }
265
+ * ```
266
+ */
267
+ export interface CrudControllerOptions {
268
+ /** 是否在创建后立即加载;不可见 / 惰性页签应设为 false(默认 true)。 */
269
+ autoLoad?: boolean;
270
+ /** 请求失败或重新拉取时是否保留已有数据(默认 true,避免闪现空列表)。 */
271
+ keepPreviousData?: boolean;
272
+ /** 是否把查询串回填浏览器地址栏(保留 pathname 与 hash,默认 true)。 */
273
+ syncUrl?: boolean;
274
+ }
275
+ /**
276
+ * 映射分页结果的 `items`,保留 total / page / pageSize。
277
+ *
278
+ * @description 标准 `PaginatedResult<T>` 适配器:业务页面只需转换条目本身,
279
+ * 无需重复搬运分页元数据,配合 `CrudApi.list` 消除 page/pageSize/total 样板。
280
+ *
281
+ * @param result - 后端返回的分页结果。
282
+ * @param map - 单条映射函数。
283
+ * @returns 条目被映射、分页元数据不变的新分页结果。
284
+ * @typeParam T - 字段值或资源条目的数据类型。
285
+ * @typeParam R - 转换结果的数据类型。
286
+ *
287
+ * @example
288
+ * ```ts
289
+ * import { mapPaginated } from '@h-ai/ui'
290
+ * const page = mapPaginated({ items: [{ id: 'u1', email: 'ada@example.com' }], total: 1, page: 1, pageSize: 20 }, user => ({ ...user, label: user.email }))
291
+ * const email = page.items[0]?.label
292
+ * ```
293
+ */
294
+ export declare function mapPaginated<T, R>(result: PaginatedResult<T>, map: (item: T, index: number) => R): PaginatedResult<R>;
295
+ /**
296
+ * 由声明式资源定义生成 `CrudPage` 所需的 `crud` 对象。
297
+ *
298
+ * @description 仅做字段筛选、列映射与默认值收集,不依赖 `@h-ai/kit`,可在纯 SPA 直接使用。
299
+ *
300
+ * @param resource - 资源定义(字段、标签、API)。
301
+ * @returns `CrudPage` 可直接消费的 `crud` 对象。
302
+ * @typeParam T - 字段值或资源条目的数据类型。
303
+ *
304
+ * @example
305
+ * ```ts
306
+ * import { defineCrud } from '@h-ai/ui'
307
+ * 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 }) } })
308
+ * const columns = crud.toTableColumns()
309
+ * ```
310
+ */
311
+ export declare function defineCrud<T extends Record<string, unknown>>(resource: CrudResource<T>): CrudDef<T>;
312
+ /**
313
+ * 在纯客户端(无 SvelteKit SSR)下为 `CrudPage` 创建数据 + 导航控制器。
314
+ *
315
+ * @description `CrudPage` 通过 `nav.navigate(url)` 把搜索/过滤/分页写进 URL query,再调用 `nav.refresh()`
316
+ * 触发列表刷新。本控制器把 query 解析回参数、调用 `crud.api.list` 更新本地 `data`,并把查询串回填地址栏,
317
+ * 不触发整页跳转(避免刷新与登录态丢失)。连续请求只允许最新一轮更新状态(seq + AbortSignal 双保险),
318
+ * 失败时保留已有数据并暴露错误供页面重试。
319
+ *
320
+ * @param crud - `defineCrud` 的返回值。
321
+ * @param options - 加载策略;默认立即加载、失败保留旧数据、回填地址栏。
322
+ * @returns 含响应式 `data`、`nav` 适配器与 `load` / `reload` 的控制器。
323
+ * @typeParam T - 字段值或资源条目的数据类型。
324
+ *
325
+ * @example
326
+ * ```ts
327
+ * import { defineCrud, createCrudController } from '@h-ai/ui'
328
+ * 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 }) } })
329
+ * const controller = createCrudController(crud, { autoLoad: false, syncUrl: false })
330
+ * await controller.load()
331
+ * if (controller.error) throw controller.error
332
+ * const users = controller.data.items
333
+ * ```
334
+ */
335
+ export declare function createCrudController<T extends Record<string, unknown>>(crud: CrudDef<T>, options?: CrudControllerOptions): CrudController<T>;