@h-ai/ui 0.1.0-alpha8 → 1.0.0-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (367) hide show
  1. package/README.en.md +1036 -0
  2. package/README.ja.md +1036 -0
  3. package/README.md +670 -119
  4. package/auto-import.d.ts +45 -0
  5. package/auto-import.js +46 -69
  6. package/dist/components/compounds/Accordion.svelte +30 -3
  7. package/dist/components/compounds/Accordion.svelte.d.ts +37 -1
  8. package/dist/components/compounds/ActionSheet.svelte +35 -8
  9. package/dist/components/compounds/ActionSheet.svelte.d.ts +41 -1
  10. package/dist/components/compounds/Alert.svelte +24 -15
  11. package/dist/components/compounds/Alert.svelte.d.ts +14 -3
  12. package/dist/components/compounds/AppBar.svelte +37 -9
  13. package/dist/components/compounds/AppBar.svelte.d.ts +36 -1
  14. package/dist/components/compounds/BottomNav.svelte +68 -8
  15. package/dist/components/compounds/BottomNav.svelte.d.ts +51 -1
  16. package/dist/components/compounds/Breadcrumb.svelte +18 -5
  17. package/dist/components/compounds/Breadcrumb.svelte.d.ts +23 -2
  18. package/dist/components/compounds/Calendar.svelte +31 -12
  19. package/dist/components/compounds/Calendar.svelte.d.ts +23 -7
  20. package/dist/components/compounds/Card.svelte +17 -5
  21. package/dist/components/compounds/Card.svelte.d.ts +13 -2
  22. package/dist/components/compounds/Combobox.svelte +124 -42
  23. package/dist/components/compounds/Combobox.svelte.d.ts +42 -20
  24. package/dist/components/compounds/Confirm.svelte +32 -9
  25. package/dist/components/compounds/Confirm.svelte.d.ts +24 -2
  26. package/dist/components/compounds/DataTable.svelte +317 -33
  27. package/dist/components/compounds/DataTable.svelte.d.ts +28 -14
  28. package/dist/components/compounds/DatePicker.svelte +62 -18
  29. package/dist/components/compounds/DatePicker.svelte.d.ts +27 -8
  30. package/dist/components/compounds/Drawer.svelte +179 -22
  31. package/dist/components/compounds/Drawer.svelte.d.ts +24 -2
  32. package/dist/components/compounds/Dropdown.svelte +19 -5
  33. package/dist/components/compounds/Dropdown.svelte.d.ts +13 -2
  34. package/dist/components/compounds/Empty.svelte +22 -9
  35. package/dist/components/compounds/Empty.svelte.d.ts +23 -2
  36. package/dist/components/compounds/FilterBar.svelte +82 -0
  37. package/dist/components/compounds/FilterBar.svelte.d.ts +39 -0
  38. package/dist/components/compounds/Form.svelte +59 -16
  39. package/dist/components/compounds/Form.svelte.d.ts +23 -2
  40. package/dist/components/compounds/FormField.svelte +99 -16
  41. package/dist/components/compounds/FormField.svelte.d.ts +23 -2
  42. package/dist/components/compounds/FormLayout.svelte +71 -0
  43. package/dist/components/compounds/FormLayout.svelte.d.ts +17 -0
  44. package/dist/components/compounds/InfiniteScroll.svelte +34 -7
  45. package/dist/components/compounds/InfiniteScroll.svelte.d.ts +37 -1
  46. package/dist/components/compounds/JsonViewer.svelte +214 -0
  47. package/dist/components/compounds/JsonViewer.svelte.d.ts +26 -0
  48. package/dist/components/compounds/MessageBoxContainer.svelte +34 -0
  49. package/dist/components/compounds/MessageBoxContainer.svelte.d.ts +25 -0
  50. package/dist/components/compounds/MessageBoxDialog.svelte +209 -0
  51. package/dist/components/compounds/MessageBoxDialog.svelte.d.ts +29 -0
  52. package/dist/components/compounds/MessageContainer.svelte +24 -0
  53. package/dist/components/compounds/MessageContainer.svelte.d.ts +18 -0
  54. package/dist/components/compounds/Modal.svelte +348 -73
  55. package/dist/components/compounds/Modal.svelte.d.ts +13 -2
  56. package/dist/components/compounds/PageHeader.svelte +44 -20
  57. package/dist/components/compounds/PageHeader.svelte.d.ts +24 -9
  58. package/dist/components/compounds/Pagination.svelte +139 -105
  59. package/dist/components/compounds/Pagination.svelte.d.ts +23 -2
  60. package/dist/components/compounds/Popover.svelte +124 -25
  61. package/dist/components/compounds/Popover.svelte.d.ts +23 -2
  62. package/dist/components/compounds/PullRefresh.svelte +35 -8
  63. package/dist/components/compounds/PullRefresh.svelte.d.ts +35 -1
  64. package/dist/components/compounds/Result.svelte +17 -4
  65. package/dist/components/compounds/Result.svelte.d.ts +23 -2
  66. package/dist/components/compounds/SafeArea.svelte +30 -3
  67. package/dist/components/compounds/SafeArea.svelte.d.ts +35 -1
  68. package/dist/components/compounds/Skeleton.svelte +19 -7
  69. package/dist/components/compounds/Skeleton.svelte.d.ts +13 -2
  70. package/dist/components/compounds/Steps.svelte +17 -4
  71. package/dist/components/compounds/Steps.svelte.d.ts +23 -2
  72. package/dist/components/compounds/SwipeCell.svelte +30 -3
  73. package/dist/components/compounds/SwipeCell.svelte.d.ts +40 -1
  74. package/dist/components/compounds/TableToolbar.svelte +289 -0
  75. package/dist/components/compounds/TableToolbar.svelte.d.ts +69 -0
  76. package/dist/components/compounds/Tabs.svelte +84 -14
  77. package/dist/components/compounds/Tabs.svelte.d.ts +13 -2
  78. package/dist/components/compounds/TagInput.svelte +51 -33
  79. package/dist/components/compounds/TagInput.svelte.d.ts +23 -2
  80. package/dist/components/compounds/Timeline.svelte +30 -3
  81. package/dist/components/compounds/Timeline.svelte.d.ts +37 -1
  82. package/dist/components/compounds/ToastContainer.svelte +386 -28
  83. package/dist/components/compounds/ToastContainer.svelte.d.ts +27 -1
  84. package/dist/components/compounds/Tooltip.svelte +143 -9
  85. package/dist/components/compounds/Tooltip.svelte.d.ts +25 -2
  86. package/dist/components/compounds/accordion-types.d.ts +10 -1
  87. package/dist/components/compounds/action-sheet-types.d.ts +9 -0
  88. package/dist/components/compounds/bottom-nav-types.d.ts +9 -0
  89. package/dist/components/compounds/index.d.ts +7 -0
  90. package/dist/components/compounds/index.js +11 -0
  91. package/dist/components/compounds/swipe-cell-types.d.ts +9 -0
  92. package/dist/components/compounds/timeline-types.d.ts +9 -0
  93. package/dist/components/control-size.d.ts +35 -0
  94. package/dist/components/control-size.js +26 -0
  95. package/dist/components/primitives/Avatar.svelte +19 -5
  96. package/dist/components/primitives/Avatar.svelte.d.ts +13 -2
  97. package/dist/components/primitives/Badge.svelte +16 -4
  98. package/dist/components/primitives/Badge.svelte.d.ts +13 -2
  99. package/dist/components/primitives/BareButton.svelte +26 -12
  100. package/dist/components/primitives/BareButton.svelte.d.ts +23 -2
  101. package/dist/components/primitives/BareInput.svelte +57 -35
  102. package/dist/components/primitives/BareInput.svelte.d.ts +23 -2
  103. package/dist/components/primitives/Button.svelte +30 -9
  104. package/dist/components/primitives/Button.svelte.d.ts +13 -2
  105. package/dist/components/primitives/Checkbox.svelte +24 -5
  106. package/dist/components/primitives/Checkbox.svelte.d.ts +23 -2
  107. package/dist/components/primitives/IconButton.svelte +35 -10
  108. package/dist/components/primitives/IconButton.svelte.d.ts +23 -2
  109. package/dist/components/primitives/Input.svelte +56 -26
  110. package/dist/components/primitives/Input.svelte.d.ts +13 -2
  111. package/dist/components/primitives/Progress.svelte +17 -4
  112. package/dist/components/primitives/Progress.svelte.d.ts +23 -2
  113. package/dist/components/primitives/Radio.svelte +17 -4
  114. package/dist/components/primitives/Radio.svelte.d.ts +22 -2
  115. package/dist/components/primitives/Range.svelte +31 -4
  116. package/dist/components/primitives/Range.svelte.d.ts +37 -1
  117. package/dist/components/primitives/Rating.svelte +32 -5
  118. package/dist/components/primitives/Rating.svelte.d.ts +37 -1
  119. package/dist/components/primitives/Select.svelte +404 -47
  120. package/dist/components/primitives/Select.svelte.d.ts +23 -2
  121. package/dist/components/primitives/Spinner.svelte +17 -4
  122. package/dist/components/primitives/Spinner.svelte.d.ts +23 -2
  123. package/dist/components/primitives/Switch.svelte +22 -4
  124. package/dist/components/primitives/Switch.svelte.d.ts +23 -2
  125. package/dist/components/primitives/Tag.svelte +17 -4
  126. package/dist/components/primitives/Tag.svelte.d.ts +23 -2
  127. package/dist/components/primitives/Textarea.svelte +75 -30
  128. package/dist/components/primitives/Textarea.svelte.d.ts +24 -2
  129. package/dist/components/primitives/ToggleCheckbox.svelte +24 -10
  130. package/dist/components/primitives/ToggleCheckbox.svelte.d.ts +23 -2
  131. package/dist/components/primitives/ToggleInput.svelte +24 -10
  132. package/dist/components/primitives/ToggleInput.svelte.d.ts +23 -2
  133. package/dist/components/primitives/ToggleRadio.svelte +24 -10
  134. package/dist/components/primitives/ToggleRadio.svelte.d.ts +23 -2
  135. package/dist/components/scenes/ai/AiDocumentDownloadMenu.svelte +54 -23
  136. package/dist/components/scenes/ai/AiDocumentDownloadMenu.svelte.d.ts +30 -1
  137. package/dist/components/scenes/ai/AiDocumentEditor.svelte +3428 -693
  138. package/dist/components/scenes/ai/AiDocumentEditor.svelte.d.ts +26 -1
  139. package/dist/components/scenes/ai/MarkdownRenderer.svelte +119 -116
  140. package/dist/components/scenes/ai/MarkdownRenderer.svelte.d.ts +31 -1
  141. package/dist/components/scenes/ai/code-preview.d.ts +46 -0
  142. package/dist/components/scenes/ai/code-preview.js +141 -0
  143. package/dist/components/scenes/ai/document-download.d.ts +52 -0
  144. package/dist/components/scenes/ai/document-download.js +296 -77
  145. package/dist/components/scenes/ai/document-parse.d.ts +101 -11
  146. package/dist/components/scenes/ai/document-parse.js +212 -48
  147. package/dist/components/scenes/ai/document-types.d.ts +292 -75
  148. package/dist/components/scenes/ai/editor-markdown-extensions.d.ts +27 -0
  149. package/dist/components/scenes/ai/editor-markdown-extensions.js +215 -0
  150. package/dist/components/scenes/ai/highlight.d.ts +37 -0
  151. package/dist/components/scenes/ai/highlight.js +162 -0
  152. package/dist/components/scenes/ai/index.d.ts +5 -2
  153. package/dist/components/scenes/ai/index.js +3 -0
  154. package/dist/components/scenes/ai/markdown-parse.d.ts +11 -3
  155. package/dist/components/scenes/ai/markdown-parse.js +42 -31
  156. package/dist/components/scenes/ai/mermaid-host-sync.d.ts +72 -0
  157. package/dist/components/scenes/ai/mermaid-host-sync.js +65 -0
  158. package/dist/components/scenes/ai/mermaid-render.d.ts +30 -0
  159. package/dist/components/scenes/ai/mermaid-render.js +61 -0
  160. package/dist/components/scenes/ai/safe-html.d.ts +64 -0
  161. package/dist/components/scenes/ai/safe-html.js +345 -0
  162. package/dist/components/scenes/ai/table/AiTableEditor.svelte +1692 -0
  163. package/dist/components/scenes/ai/table/AiTableEditor.svelte.d.ts +32 -0
  164. package/dist/components/scenes/ai/table/table-types.d.ts +181 -0
  165. package/dist/components/scenes/ai/table/table-types.js +1 -0
  166. package/dist/components/scenes/app/FeedbackDetail.svelte +236 -0
  167. package/dist/components/scenes/app/FeedbackDetail.svelte.d.ts +40 -0
  168. package/dist/components/scenes/app/FeedbackForm.svelte +337 -0
  169. package/dist/components/scenes/app/FeedbackForm.svelte.d.ts +72 -0
  170. package/dist/components/scenes/app/FeedbackList.svelte +150 -0
  171. package/dist/components/scenes/app/FeedbackList.svelte.d.ts +28 -0
  172. package/dist/components/scenes/app/FeedbackModal.svelte +65 -139
  173. package/dist/components/scenes/app/FeedbackModal.svelte.d.ts +14 -39
  174. package/dist/components/scenes/app/FeedbackRecorder.svelte +154 -0
  175. package/dist/components/scenes/app/FeedbackRecorder.svelte.d.ts +9 -0
  176. package/dist/components/scenes/app/FeedbackReplay.svelte +142 -0
  177. package/dist/components/scenes/app/FeedbackReplay.svelte.d.ts +7 -0
  178. package/dist/components/scenes/app/FeedbackScreenshot.svelte +120 -0
  179. package/dist/components/scenes/app/FeedbackScreenshot.svelte.d.ts +8 -0
  180. package/dist/components/scenes/app/LanguageSwitch.svelte +38 -21
  181. package/dist/components/scenes/app/LanguageSwitch.svelte.d.ts +33 -20
  182. package/dist/components/scenes/app/SettingsLayout.svelte +115 -0
  183. package/dist/components/scenes/app/SettingsLayout.svelte.d.ts +54 -0
  184. package/dist/components/scenes/app/SettingsModal.svelte +33 -7
  185. package/dist/components/scenes/app/SettingsModal.svelte.d.ts +27 -1
  186. package/dist/components/scenes/app/ThemeColorPicker.svelte +240 -0
  187. package/dist/components/scenes/app/ThemeColorPicker.svelte.d.ts +57 -0
  188. package/dist/components/scenes/app/ThemeSelector.svelte +87 -26
  189. package/dist/components/scenes/app/ThemeSelector.svelte.d.ts +26 -7
  190. package/dist/components/scenes/app/ThemeToggle.svelte +27 -6
  191. package/dist/components/scenes/app/ThemeToggle.svelte.d.ts +24 -5
  192. package/dist/components/scenes/app/WorkspaceLayout.svelte +64 -0
  193. package/dist/components/scenes/app/WorkspaceLayout.svelte.d.ts +36 -0
  194. package/dist/components/scenes/app/feedback-functions.d.ts +57 -0
  195. package/dist/components/scenes/app/feedback-functions.js +107 -0
  196. package/dist/components/scenes/app/feedback-types.d.ts +224 -0
  197. package/dist/components/scenes/app/feedback-types.js +1 -0
  198. package/dist/components/scenes/app/index.d.ts +8 -1
  199. package/dist/components/scenes/app/index.js +7 -1
  200. package/dist/components/scenes/charts/Chart.svelte +163 -0
  201. package/dist/components/scenes/charts/Chart.svelte.d.ts +25 -0
  202. package/dist/components/scenes/charts/chart-theme.d.ts +47 -0
  203. package/dist/components/scenes/charts/chart-theme.js +68 -0
  204. package/dist/components/scenes/charts/chart-types.d.ts +153 -0
  205. package/dist/components/scenes/charts/chart-types.js +7 -0
  206. package/dist/components/scenes/charts/index.d.ts +8 -0
  207. package/dist/components/scenes/charts/index.js +7 -0
  208. package/dist/components/scenes/charts/renderers/AreaChart.svelte +18 -0
  209. package/dist/components/scenes/charts/renderers/AreaChart.svelte.d.ts +5 -0
  210. package/dist/components/scenes/charts/renderers/BarChart.svelte +18 -0
  211. package/dist/components/scenes/charts/renderers/BarChart.svelte.d.ts +5 -0
  212. package/dist/components/scenes/charts/renderers/LineChart.svelte +624 -0
  213. package/dist/components/scenes/charts/renderers/LineChart.svelte.d.ts +32 -0
  214. package/dist/components/scenes/charts/renderers/PieChart.svelte +18 -0
  215. package/dist/components/scenes/charts/renderers/PieChart.svelte.d.ts +5 -0
  216. package/dist/components/scenes/charts/renderers/ScatterChart.svelte +18 -0
  217. package/dist/components/scenes/charts/renderers/ScatterChart.svelte.d.ts +5 -0
  218. package/dist/components/scenes/crud/CrudDeleteConfirm.svelte +29 -11
  219. package/dist/components/scenes/crud/CrudDeleteConfirm.svelte.d.ts +13 -1
  220. package/dist/components/scenes/crud/CrudDetailDrawer.svelte +77 -22
  221. package/dist/components/scenes/crud/CrudDetailDrawer.svelte.d.ts +19 -4
  222. package/dist/components/scenes/crud/CrudDetailPanel.svelte +242 -0
  223. package/dist/components/scenes/crud/CrudDetailPanel.svelte.d.ts +66 -0
  224. package/dist/components/scenes/crud/CrudEditPanel.svelte +365 -0
  225. package/dist/components/scenes/crud/CrudEditPanel.svelte.d.ts +48 -0
  226. package/dist/components/scenes/crud/CrudFilterBar.svelte +17 -85
  227. package/dist/components/scenes/crud/CrudFilterBar.svelte.d.ts +13 -25
  228. package/dist/components/scenes/crud/CrudPage.svelte +564 -185
  229. package/dist/components/scenes/crud/CrudPage.svelte.d.ts +137 -51
  230. package/dist/components/scenes/crud/crud-controller.svelte.d.ts +335 -0
  231. package/dist/components/scenes/crud/crud-controller.svelte.js +276 -0
  232. package/dist/components/scenes/crud/crud-form-validation.d.ts +16 -0
  233. package/dist/components/scenes/crud/crud-form-validation.js +51 -0
  234. package/dist/components/scenes/crud/crud-types.d.ts +136 -43
  235. package/dist/components/scenes/crud/index.d.ts +9 -3
  236. package/dist/components/scenes/crud/index.js +8 -3
  237. package/dist/components/scenes/crud/nav-adapter.d.ts +50 -0
  238. package/dist/components/scenes/crud/nav-adapter.js +39 -0
  239. package/dist/components/scenes/crypto/EncryptedInput.svelte +63 -28
  240. package/dist/components/scenes/crypto/EncryptedInput.svelte.d.ts +38 -3
  241. package/dist/components/scenes/crypto/HashDisplay.svelte +30 -22
  242. package/dist/components/scenes/crypto/HashDisplay.svelte.d.ts +24 -1
  243. package/dist/components/scenes/crypto/SignatureDisplay.svelte +41 -40
  244. package/dist/components/scenes/crypto/SignatureDisplay.svelte.d.ts +24 -1
  245. package/dist/components/scenes/error/ErrorPage.svelte +135 -0
  246. package/dist/components/scenes/error/ErrorPage.svelte.d.ts +50 -0
  247. package/dist/components/scenes/error/error-presets.d.ts +60 -0
  248. package/dist/components/scenes/error/error-presets.js +51 -0
  249. package/dist/components/scenes/error/index.d.ts +8 -0
  250. package/dist/components/scenes/error/index.js +8 -0
  251. package/dist/components/scenes/guide/GuideHost.svelte +56 -0
  252. package/dist/components/scenes/guide/GuideHost.svelte.d.ts +35 -0
  253. package/dist/components/scenes/guide/GuideHostContent.svelte +136 -0
  254. package/dist/components/scenes/guide/GuideHostContent.svelte.d.ts +43 -0
  255. package/dist/components/scenes/guide/HelpCenter.svelte +135 -0
  256. package/dist/components/scenes/guide/HelpCenter.svelte.d.ts +40 -0
  257. package/dist/components/scenes/guide/index.d.ts +2 -0
  258. package/dist/components/scenes/guide/index.js +2 -0
  259. package/dist/components/scenes/iam/AgreementNotice.svelte +48 -0
  260. package/dist/components/scenes/iam/AgreementNotice.svelte.d.ts +7 -0
  261. package/dist/components/scenes/iam/AuthPanel.svelte +226 -0
  262. package/dist/components/scenes/iam/AuthPanel.svelte.d.ts +29 -0
  263. package/dist/components/scenes/iam/AuthShell.svelte +160 -0
  264. package/dist/components/scenes/iam/AuthShell.svelte.d.ts +56 -0
  265. package/dist/components/scenes/iam/ChangePasswordForm.svelte +84 -63
  266. package/dist/components/scenes/iam/ChangePasswordForm.svelte.d.ts +13 -1
  267. package/dist/components/scenes/iam/ForgotPasswordForm.svelte +113 -89
  268. package/dist/components/scenes/iam/ForgotPasswordForm.svelte.d.ts +24 -1
  269. package/dist/components/scenes/iam/LoginForm.svelte +215 -117
  270. package/dist/components/scenes/iam/LoginForm.svelte.d.ts +13 -1
  271. package/dist/components/scenes/iam/PasswordInput.svelte +79 -32
  272. package/dist/components/scenes/iam/PasswordInput.svelte.d.ts +30 -4
  273. package/dist/components/scenes/iam/PermGuard.svelte +21 -11
  274. package/dist/components/scenes/iam/PermGuard.svelte.d.ts +30 -0
  275. package/dist/components/scenes/iam/ReauthenticationDialog.svelte +68 -0
  276. package/dist/components/scenes/iam/ReauthenticationDialog.svelte.d.ts +17 -0
  277. package/dist/components/scenes/iam/RegisterForm.svelte +129 -116
  278. package/dist/components/scenes/iam/RegisterForm.svelte.d.ts +13 -1
  279. package/dist/components/scenes/iam/ResetPasswordForm.svelte +101 -88
  280. package/dist/components/scenes/iam/ResetPasswordForm.svelte.d.ts +13 -1
  281. package/dist/components/scenes/iam/SensitiveOperationsForm.svelte +76 -0
  282. package/dist/components/scenes/iam/SensitiveOperationsForm.svelte.d.ts +21 -0
  283. package/dist/components/scenes/iam/SessionRecoveryDialog.svelte +64 -0
  284. package/dist/components/scenes/iam/SessionRecoveryDialog.svelte.d.ts +22 -0
  285. package/dist/components/scenes/iam/UserProfile.svelte +47 -21
  286. package/dist/components/scenes/iam/UserProfile.svelte.d.ts +24 -1
  287. package/dist/components/scenes/iam/auth-captcha.d.ts +21 -0
  288. package/dist/components/scenes/iam/auth-captcha.js +23 -0
  289. package/dist/components/scenes/iam/auth-error-message.d.ts +13 -0
  290. package/dist/components/scenes/iam/auth-error-message.js +65 -0
  291. package/dist/components/scenes/iam/index.d.ts +10 -0
  292. package/dist/components/scenes/iam/index.js +9 -1
  293. package/dist/components/scenes/iam/password-utils.d.ts +33 -6
  294. package/dist/components/scenes/iam/password-utils.js +61 -8
  295. package/dist/components/scenes/iam/permission-context.svelte.d.ts +33 -23
  296. package/dist/components/scenes/iam/permission-context.svelte.js +20 -22
  297. package/dist/components/scenes/iam/sensitive-actions.svelte.d.ts +68 -0
  298. package/dist/components/scenes/iam/sensitive-actions.svelte.js +101 -0
  299. package/dist/components/scenes/iam/session-recovery.svelte.d.ts +44 -0
  300. package/dist/components/scenes/iam/session-recovery.svelte.js +57 -0
  301. package/dist/components/scenes/index.d.ts +3 -0
  302. package/dist/components/scenes/index.js +5 -0
  303. package/dist/components/scenes/storage/AvatarUpload.svelte +82 -68
  304. package/dist/components/scenes/storage/AvatarUpload.svelte.d.ts +23 -1
  305. package/dist/components/scenes/storage/FileList.svelte +19 -5
  306. package/dist/components/scenes/storage/FileList.svelte.d.ts +23 -1
  307. package/dist/components/scenes/storage/FileUpload.svelte +151 -96
  308. package/dist/components/scenes/storage/FileUpload.svelte.d.ts +24 -1
  309. package/dist/components/scenes/storage/ImageUpload.svelte +93 -94
  310. package/dist/components/scenes/storage/ImageUpload.svelte.d.ts +24 -1
  311. package/dist/components/scenes/types.d.ts +574 -42
  312. package/dist/guide-storage.d.ts +18 -0
  313. package/dist/guide-storage.js +79 -0
  314. package/dist/guide-types.d.ts +143 -0
  315. package/dist/guide-types.js +1 -0
  316. package/dist/guide.d.ts +3 -0
  317. package/dist/guide.js +3 -0
  318. package/dist/guide.svelte.d.ts +29 -0
  319. package/dist/guide.svelte.js +506 -0
  320. package/dist/i18n.svelte.d.ts +67 -4
  321. package/dist/i18n.svelte.js +106 -21
  322. package/dist/index.d.ts +6 -0
  323. package/dist/index.js +7 -0
  324. package/dist/internal/browser-safety.d.ts +88 -0
  325. package/dist/internal/browser-safety.js +140 -0
  326. package/dist/internal/dialog-focus.d.ts +21 -0
  327. package/dist/internal/dialog-focus.js +77 -0
  328. package/dist/internal/form-context.d.ts +92 -0
  329. package/dist/internal/form-context.js +70 -0
  330. package/dist/internal/form-validation.svelte.d.ts +70 -0
  331. package/dist/internal/form-validation.svelte.js +142 -0
  332. package/dist/internal/icon-safety.d.ts +14 -0
  333. package/dist/internal/icon-safety.js +40 -0
  334. package/dist/internal/locale.d.ts +21 -0
  335. package/dist/internal/locale.js +43 -0
  336. package/dist/message.svelte.d.ts +138 -0
  337. package/dist/message.svelte.js +149 -0
  338. package/dist/messagebox.svelte.d.ts +130 -0
  339. package/dist/messagebox.svelte.js +171 -0
  340. package/dist/messages/en-US.json +297 -16
  341. package/dist/messages/ja-JP.json +523 -0
  342. package/dist/messages/zh-CN.json +297 -16
  343. package/dist/messages.d.ts +25 -3
  344. package/dist/messages.js +23 -6
  345. package/dist/styles/design-tokens.css +4 -2
  346. package/dist/styles/formal.css +55 -0
  347. package/dist/styles/global.css +86 -18
  348. package/dist/styles/guide.css +88 -0
  349. package/dist/styles/high-contrast.css +64 -0
  350. package/dist/styles/mobile.css +28 -0
  351. package/dist/styles/theme.css +42 -0
  352. package/dist/theme-config.d.ts +263 -10
  353. package/dist/theme-config.js +252 -17
  354. package/dist/toast.svelte.d.ts +210 -2
  355. package/dist/toast.svelte.js +296 -19
  356. package/dist/types.d.ts +787 -63
  357. package/dist/utils/platform.svelte.d.ts +28 -15
  358. package/dist/utils/platform.svelte.js +23 -16
  359. package/dist/utils.d.ts +121 -1
  360. package/dist/utils.js +208 -13
  361. package/dist/workspace-context.d.ts +20 -0
  362. package/dist/workspace-context.js +9 -0
  363. package/package.json +120 -24
  364. package/vite.d.ts +13 -0
  365. package/vite.js +96 -0
  366. package/dist/components/scenes/crud/CrudEditDrawer.svelte +0 -225
  367. package/dist/components/scenes/crud/CrudEditDrawer.svelte.d.ts +0 -48
@@ -0,0 +1,276 @@
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 { SvelteURLSearchParams } from 'svelte/reactivity';
16
+ /**
17
+ * 解析可能是 i18n 函数的文本。
18
+ */
19
+ function resolveText(text) {
20
+ return typeof text === 'function' ? text() : text;
21
+ }
22
+ /**
23
+ * 映射分页结果的 `items`,保留 total / page / pageSize。
24
+ *
25
+ * @description 标准 `PaginatedResult<T>` 适配器:业务页面只需转换条目本身,
26
+ * 无需重复搬运分页元数据,配合 `CrudApi.list` 消除 page/pageSize/total 样板。
27
+ *
28
+ * @param result - 后端返回的分页结果。
29
+ * @param map - 单条映射函数。
30
+ * @returns 条目被映射、分页元数据不变的新分页结果。
31
+ * @typeParam T - 字段值或资源条目的数据类型。
32
+ * @typeParam R - 转换结果的数据类型。
33
+ *
34
+ * @example
35
+ * ```ts
36
+ * import { mapPaginated } from '@h-ai/ui'
37
+ * const page = mapPaginated({ items: [{ id: 'u1', email: 'ada@example.com' }], total: 1, page: 1, pageSize: 20 }, user => ({ ...user, label: user.email }))
38
+ * const email = page.items[0]?.label
39
+ * ```
40
+ */
41
+ export function mapPaginated(result, map) {
42
+ return {
43
+ items: result.items.map(map),
44
+ total: result.total,
45
+ page: result.page,
46
+ pageSize: result.pageSize,
47
+ };
48
+ }
49
+ /**
50
+ * 由声明式资源定义生成 `CrudPage` 所需的 `crud` 对象。
51
+ *
52
+ * @description 仅做字段筛选、列映射与默认值收集,不依赖 `@h-ai/kit`,可在纯 SPA 直接使用。
53
+ *
54
+ * @param resource - 资源定义(字段、标签、API)。
55
+ * @returns `CrudPage` 可直接消费的 `crud` 对象。
56
+ * @typeParam T - 字段值或资源条目的数据类型。
57
+ *
58
+ * @example
59
+ * ```ts
60
+ * import { defineCrud } from '@h-ai/ui'
61
+ * 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 }) } })
62
+ * const columns = crud.toTableColumns()
63
+ * ```
64
+ */
65
+ export function defineCrud(resource) {
66
+ const fields = [...resource.fields].sort((a, b) => (a.order ?? 0) - (b.order ?? 0));
67
+ return {
68
+ resource,
69
+ getListFields: () => fields.filter(f => f.inList !== false),
70
+ getFilterFields: () => fields.filter(f => f.filterable === true),
71
+ // readonly 仅表示“编辑态禁用”(由 CrudEditPanel 在 edit 模式 disable),新建仍可填写;
72
+ // 因此创建表单只按 inCreate 过滤,不排除 readonly 字段。
73
+ getCreateFields: () => fields.filter(f => f.inCreate !== false),
74
+ getEditFields: () => fields.filter(f => f.inEdit !== false),
75
+ getDetailFields: () => fields.filter(f => f.inDetail !== false),
76
+ toTableColumns: () => fields
77
+ .filter(f => f.inList !== false)
78
+ .map(f => ({
79
+ key: f.id,
80
+ label: resolveText(f.label),
81
+ width: f.width,
82
+ align: f.align,
83
+ render: f.render ? (item) => f.render(item[f.id], item) : undefined,
84
+ })),
85
+ getDefaultValues: () => Object.fromEntries(fields.filter(f => f.defaultValue !== undefined).map(f => [f.id, f.defaultValue])),
86
+ api: resource.api,
87
+ };
88
+ }
89
+ /**
90
+ * 在纯客户端(无 SvelteKit SSR)下为 `CrudPage` 创建数据 + 导航控制器。
91
+ *
92
+ * @description `CrudPage` 通过 `nav.navigate(url)` 把搜索/过滤/分页写进 URL query,再调用 `nav.refresh()`
93
+ * 触发列表刷新。本控制器把 query 解析回参数、调用 `crud.api.list` 更新本地 `data`,并把查询串回填地址栏,
94
+ * 不触发整页跳转(避免刷新与登录态丢失)。连续请求只允许最新一轮更新状态(seq + AbortSignal 双保险),
95
+ * 失败时保留已有数据并暴露错误供页面重试。
96
+ *
97
+ * @param crud - `defineCrud` 的返回值。
98
+ * @param options - 加载策略;默认立即加载、失败保留旧数据、回填地址栏。
99
+ * @returns 含响应式 `data`、`nav` 适配器与 `load` / `reload` 的控制器。
100
+ * @typeParam T - 字段值或资源条目的数据类型。
101
+ *
102
+ * @example
103
+ * ```ts
104
+ * import { defineCrud, createCrudController } from '@h-ai/ui'
105
+ * 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 }) } })
106
+ * const controller = createCrudController(crud, { autoLoad: false, syncUrl: false })
107
+ * await controller.load()
108
+ * if (controller.error) throw controller.error
109
+ * const users = controller.data.items
110
+ * ```
111
+ */
112
+ export function createCrudController(crud, options = {}) {
113
+ const defaultPageSize = crud.resource.defaultPageSize ?? 10;
114
+ const keepPreviousData = options.keepPreviousData !== false;
115
+ const syncUrl = options.syncUrl !== false;
116
+ const filterIds = crud.getFilterFields().map(f => f.id);
117
+ const data = $state({
118
+ items: [],
119
+ total: 0,
120
+ page: 1,
121
+ pageSize: defaultPageSize,
122
+ filters: {},
123
+ });
124
+ // 最近一次解析出的查询参数(供 refresh 使用)。
125
+ let pending = { search: '', page: 1, pageSize: defaultPageSize };
126
+ // 单调递增请求号;只有最新一轮请求可写回状态(latest-wins)。
127
+ let listRequestSeq = 0;
128
+ // 最新一轮请求的取消控制器;新请求发起前 abort 上一轮。
129
+ let abortController;
130
+ // 并发去重:同参数请求在途时复用同一 Promise。
131
+ let inFlightKey;
132
+ let inFlightPromise;
133
+ let loading = $state(false);
134
+ let loaded = $state(false);
135
+ let error = $state(undefined);
136
+ /** 生成参数的稳定 key(用于并发去重)。 */
137
+ function paramsKey(params) {
138
+ return JSON.stringify(Object.entries(params).sort(([a], [b]) => a.localeCompare(b)));
139
+ }
140
+ /** 把成功响应写回响应式 data,并回填 filters 供筛选栏回显。 */
141
+ function applyResult(result, params) {
142
+ data.items = result.items;
143
+ data.total = result.total;
144
+ data.page = result.page;
145
+ data.pageSize = result.pageSize;
146
+ const filters = { search: params.search ?? '' };
147
+ for (const id of filterIds) {
148
+ if (params[id] !== undefined)
149
+ filters[id] = params[id];
150
+ }
151
+ data.filters = filters;
152
+ }
153
+ /**
154
+ * 按参数拉取列表并写回响应式 data。
155
+ *
156
+ * @description 暴露查询中、已成功加载和错误三种状态;连续请求只允许最新响应更新状态与数据,
157
+ * 旧请求被 abort 且其结果被丢弃;失败时按 keepPreviousData 决定是否保留旧列表。
158
+ *
159
+ * @param params - 搜索、过滤与分页参数。
160
+ * @returns 最新请求结算后完成;错误被保存在控制器中,避免未处理 Promise 拒绝。
161
+ */
162
+ function fetchList(params) {
163
+ const key = paramsKey(params);
164
+ // 并发去重:同参数请求在途时直接复用,避免重复打后端。
165
+ if (inFlightPromise && inFlightKey === key)
166
+ return inFlightPromise;
167
+ const requestSeq = ++listRequestSeq;
168
+ // 取消上一轮在途请求,实现 latest-wins 的第一重保险。
169
+ abortController?.abort();
170
+ const ac = new AbortController();
171
+ abortController = ac;
172
+ loading = true;
173
+ error = undefined;
174
+ // 不保留旧数据时立即清空,展示查询中占位;保留时维持旧列表避免闪烁。
175
+ if (!keepPreviousData) {
176
+ data.items = [];
177
+ data.total = 0;
178
+ }
179
+ inFlightKey = key;
180
+ const promise = (async () => {
181
+ try {
182
+ const result = await crud.api.list(params, { signal: ac.signal });
183
+ // 旧请求晚返回:seq 已被新请求覆盖时丢弃,绝不污染用户当前看到的结果。
184
+ if (requestSeq !== listRequestSeq)
185
+ return;
186
+ applyResult(result, params);
187
+ loaded = true;
188
+ }
189
+ catch (cause) {
190
+ // 被新请求取代而 abort 的旧请求:静默丢弃,不写错误。
191
+ if (ac.signal.aborted || (cause instanceof Error && cause.name === 'AbortError'))
192
+ return;
193
+ // 列表加载失败(慢响应/重启/超时)时保留上一次结果,绝不用空列表覆盖,避免误显示“0 条记录”;
194
+ // 同时暴露错误给页面:首次失败不能被当成一次成功的空结果。
195
+ if (requestSeq === listRequestSeq)
196
+ error = cause instanceof Error ? cause : new Error(String(cause));
197
+ }
198
+ finally {
199
+ if (requestSeq === listRequestSeq) {
200
+ loading = false;
201
+ inFlightPromise = undefined;
202
+ inFlightKey = undefined;
203
+ abortController = undefined;
204
+ }
205
+ }
206
+ })();
207
+ inFlightPromise = promise;
208
+ return promise;
209
+ }
210
+ /** 从 CrudPage 生成的 URL 中解析查询参数。 */
211
+ function parseParams(url) {
212
+ const qs = url.includes('?') ? url.slice(url.indexOf('?') + 1) : '';
213
+ const sp = new SvelteURLSearchParams(qs);
214
+ const params = {
215
+ search: sp.get('search') ?? '',
216
+ page: sp.get('page') ? Number(sp.get('page')) : 1,
217
+ pageSize: sp.get('pageSize') ? Number(sp.get('pageSize')) : defaultPageSize,
218
+ };
219
+ for (const key of ['sortBy', 'sortDirection']) {
220
+ const v = sp.get(key);
221
+ if (v !== null && v !== '')
222
+ params[key] = v;
223
+ }
224
+ for (const id of filterIds) {
225
+ const v = sp.get(id);
226
+ if (v !== null && v !== '')
227
+ params[id] = v;
228
+ }
229
+ return params;
230
+ }
231
+ /** 把查询串回填地址栏,保留 pathname 与 hash,不触发跳转;SSR / 无 history 环境静默跳过。 */
232
+ function writeUrl(url) {
233
+ if (!syncUrl)
234
+ return;
235
+ const his = globalThis.history;
236
+ const loc = globalThis.location;
237
+ if (!his?.replaceState || !loc)
238
+ return;
239
+ const qs = url.includes('?') ? url.slice(url.indexOf('?')) : '';
240
+ try {
241
+ his.replaceState(his.state, '', `${loc.pathname}${qs}${loc.hash}`);
242
+ }
243
+ catch {
244
+ // 隐私模式 / 跨域等限制下忽略,不影响数据加载。
245
+ }
246
+ }
247
+ const nav = {
248
+ pathname: '',
249
+ navigate: (url) => {
250
+ // 仅解析参数并回填地址栏,不做真实跳转。
251
+ pending = parseParams(url);
252
+ writeUrl(url);
253
+ },
254
+ refresh: () => fetchList(pending),
255
+ };
256
+ // 默认立即加载;惰性页签显式关闭,避免挂载时抢占后端资源,在首次激活时调用 load()。
257
+ if (options.autoLoad !== false)
258
+ void fetchList(pending);
259
+ return {
260
+ get data() {
261
+ return data;
262
+ },
263
+ nav,
264
+ load: () => fetchList(pending),
265
+ reload: () => fetchList(pending),
266
+ get loading() {
267
+ return loading;
268
+ },
269
+ get loaded() {
270
+ return loaded;
271
+ },
272
+ get error() {
273
+ return error;
274
+ },
275
+ };
276
+ }
@@ -0,0 +1,16 @@
1
+ /** CRUD 客户端字段校验;仅返回消息键,避免错误文案锁定在提交时的语言。 */
2
+ import type { FormValidationIssue } from '../../../internal/form-validation.svelte.js';
3
+ import type { CrudFieldDef } from './crud-controller.svelte.js';
4
+ /**
5
+ * 按字段类型和声明约束生成可翻译错误,不承担服务端验证。
6
+ * @param field - 需要校验的 CRUD 字段定义。
7
+ * @param value - 待处理或校验的值。
8
+ * @returns 可翻译的约束错误;合法输入返回 undefined。
9
+ *
10
+ * @example 模块内部上下文
11
+ * ```ts
12
+ * const issue = getCrudValidationIssue({ id: 'email', label: '邮箱', type: 'email', validation: { required: true } }, '')
13
+ * const key = issue?.key
14
+ * ```
15
+ */
16
+ export declare function getCrudValidationIssue(field: CrudFieldDef, value: unknown): FormValidationIssue | undefined;
@@ -0,0 +1,51 @@
1
+ /**
2
+ * 按字段类型和声明约束生成可翻译错误,不承担服务端验证。
3
+ * @param field - 需要校验的 CRUD 字段定义。
4
+ * @param value - 待处理或校验的值。
5
+ * @returns 可翻译的约束错误;合法输入返回 undefined。
6
+ *
7
+ * @example 模块内部上下文
8
+ * ```ts
9
+ * const issue = getCrudValidationIssue({ id: 'email', label: '邮箱', type: 'email', validation: { required: true } }, '')
10
+ * const key = issue?.key
11
+ * ```
12
+ */
13
+ export function getCrudValidationIssue(field, value) {
14
+ const rules = field.validation;
15
+ const empty = value === undefined || value === null || (typeof value === 'string' && !value.trim()) || (Array.isArray(value) && value.length === 0);
16
+ if (rules?.required && (empty || (value === false && (field.type === 'boolean' || field.type === 'checkbox'))))
17
+ return { key: 'form_required' };
18
+ if (empty)
19
+ return undefined;
20
+ if (field.type === 'number') {
21
+ const number = typeof value === 'number' ? value : Number(value);
22
+ if (!Number.isFinite(number))
23
+ return { key: 'form_number' };
24
+ if (rules?.min !== undefined && number < rules.min)
25
+ return { key: 'form_min', params: { min: rules.min } };
26
+ if (rules?.max !== undefined && number > rules.max)
27
+ return { key: 'form_max', params: { max: rules.max } };
28
+ }
29
+ else if (typeof value === 'string') {
30
+ if (rules?.min !== undefined && value.length < rules.min)
31
+ return { key: 'form_min_length', params: { min: rules.min } };
32
+ if (rules?.max !== undefined && value.length > rules.max)
33
+ return { key: 'form_max_length', params: { max: rules.max } };
34
+ }
35
+ if (field.type === 'email' && !/^[\w.!#$%&'*+/=?^`{|}~-]+@[a-z\d](?:[a-z\d-]*[a-z\d])?(?:\.[a-z\d](?:[a-z\d-]*[a-z\d])?)*$/i.test(String(value)))
36
+ return { key: 'form_email' };
37
+ if (field.type === 'url') {
38
+ if (!URL.canParse(String(value)))
39
+ return { key: 'form_url' };
40
+ }
41
+ if (rules?.pattern) {
42
+ try {
43
+ if (!new RegExp(`^(?:${rules.pattern})$`, 'v').test(String(value)))
44
+ return { key: 'form_pattern' };
45
+ }
46
+ catch {
47
+ return { key: 'form_pattern' };
48
+ }
49
+ }
50
+ return undefined;
51
+ }
@@ -5,8 +5,17 @@
5
5
  * @module crud-types
6
6
  */
7
7
  import type { Snippet } from 'svelte';
8
- import type { Size } from '../../../types.js';
9
- /** CrudPage 权限控制 */
8
+ import type { DataAttributes, FormLayoutOptions, Size } from '../../../types.js';
9
+ import type { CrudFieldDef } from './crud-controller.svelte.js';
10
+ /**
11
+ * CrudPage 权限控制
12
+ *
13
+ * @example
14
+ * ```ts
15
+ * import type { CrudPermissions } from '@h-ai/ui'
16
+ * const example: CrudPermissions = { create: true, update: true, delete: false }
17
+ * ```
18
+ */
10
19
  export interface CrudPermissions {
11
20
  /** 允许新建 */
12
21
  create?: boolean;
@@ -15,7 +24,84 @@ export interface CrudPermissions {
15
24
  /** 允许删除 */
16
25
  delete?: boolean;
17
26
  }
18
- /** CrudPage 初始列表数据(由 +page.server.ts load 返回) */
27
+ /**
28
+ * 新建/编辑表单的展示形式
29
+ *
30
+ * @example
31
+ * ```ts
32
+ * import type { CrudFormVariant } from '@h-ai/ui'
33
+ * const example: CrudFormVariant = 'drawer'
34
+ * ```
35
+ */
36
+ export type CrudFormVariant = 'drawer' | 'modal';
37
+ /**
38
+ * 列表显示密度
39
+ *
40
+ * @example
41
+ * ```ts
42
+ * import type { CrudDensity } from '@h-ai/ui'
43
+ * const example: CrudDensity = 'compact'
44
+ * ```
45
+ */
46
+ export type CrudDensity = 'normal' | 'compact';
47
+ /**
48
+ * 新建/编辑表单展示配置
49
+ *
50
+ * @example
51
+ * ```ts
52
+ * import type { CrudFormConfig } from '@h-ai/ui'
53
+ * const example: CrudFormConfig = { variant: 'drawer', drawerWidth: '32rem', columns: 2, labelPosition: 'top' }
54
+ * ```
55
+ */
56
+ export interface CrudFormConfig extends FormLayoutOptions {
57
+ /** 展示形式:'drawer'(抽屉,默认)或 'modal'(弹出窗口) */
58
+ variant?: CrudFormVariant;
59
+ /** 抽屉尺寸预设(variant='drawer',默认 '2xl') */
60
+ drawerSize?: Size;
61
+ /** 抽屉自定义宽度 CSS 值,优先级高于 drawerSize(variant='drawer') */
62
+ drawerWidth?: string;
63
+ /** 是否允许拖动并按资源记忆抽屉宽度(variant='drawer',默认 true) */
64
+ drawerResizable?: boolean;
65
+ /** 弹窗尺寸预设(variant='modal',默认 '2xl') */
66
+ modalSize?: Size | 'full';
67
+ /** 弹窗自定义宽度 CSS 值(variant='modal') */
68
+ modalWidth?: string;
69
+ /** 弹窗自定义高度 CSS 值(variant='modal') */
70
+ modalHeight?: string;
71
+ }
72
+ /**
73
+ * 分页栏展示配置
74
+ *
75
+ * @example
76
+ * ```ts
77
+ * import type { CrudPaginationConfig } from '@h-ai/ui'
78
+ * const example: CrudPaginationConfig = { showSizeChanger: true, pageSizeOptions: [10, 20, 50], showTotal: true }
79
+ * ```
80
+ */
81
+ export interface CrudPaginationConfig {
82
+ /** 是否显示每页条数选择器(默认 true) */
83
+ showSizeChanger?: boolean;
84
+ /** 每页条数候选项(默认 [10, 20, 50, 100]) */
85
+ pageSizeOptions?: number[];
86
+ /** 是否显示跳页输入(默认 true) */
87
+ showJumper?: boolean;
88
+ /** 是否显示总数(默认 true) */
89
+ showTotal?: boolean;
90
+ /** 是否显示页码信息文案(默认 true;紧凑视图可关闭) */
91
+ showPageInfo?: boolean;
92
+ /** 是否显示首页 / 末页跳转按钮(默认 true;紧凑视图可仅保留上一页 / 下一页) */
93
+ showFirstLast?: boolean;
94
+ }
95
+ /**
96
+ * CrudPage 初始列表数据(由 +page.server.ts load 返回)
97
+ * @typeParam T - 字段值或资源条目的数据类型。
98
+ *
99
+ * @example
100
+ * ```ts
101
+ * import type { CrudPageData } from '@h-ai/ui'
102
+ * const example: CrudPageData = { items: [{ id: 'u1', email: 'ada@example.com' }], total: 1, page: 1, pageSize: 20 }
103
+ * ```
104
+ */
19
105
  export interface CrudPageData<T = Record<string, unknown>> {
20
106
  items: T[];
21
107
  total: number;
@@ -23,45 +109,29 @@ export interface CrudPageData<T = Record<string, unknown>> {
23
109
  pageSize: number;
24
110
  filters?: Record<string, unknown>;
25
111
  }
26
- /** CrudPage 组件 Props */
27
- export interface CrudPageProps<T = Record<string, unknown>> {
112
+ /**
113
+ * CrudPage 组件 Props
114
+ * @typeParam T - 字段值或资源条目的数据类型。
115
+ *
116
+ * @example
117
+ * ```svelte
118
+ * <script lang="ts">
119
+ * import { CrudPage, defineCrud } from '@h-ai/ui'
120
+ * import type { CrudPageProps } from '@h-ai/ui'
121
+ * 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 }) } })
122
+ * 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 } }
123
+ * </script>
124
+ * <CrudPage {...props} />
125
+ * ```
126
+ */
127
+ export interface CrudPageProps<T = Record<string, unknown>> extends DataAttributes {
28
128
  /** CRUD 操作定义(来自 kit.crud.define) */
29
129
  crud: {
30
130
  resource: {
31
131
  name: string;
32
132
  label: string | (() => string);
33
133
  keyField?: string;
34
- fields: Array<{
35
- id: string;
36
- label: string | (() => string);
37
- type: string;
38
- inList?: boolean;
39
- filterable?: boolean;
40
- readonly?: boolean;
41
- inCreate?: boolean;
42
- inEdit?: boolean;
43
- inDetail?: boolean;
44
- options?: Array<{
45
- label: string;
46
- value: string | number | boolean;
47
- }> | (() => Array<{
48
- label: string;
49
- value: string | number | boolean;
50
- }>);
51
- validation?: {
52
- required?: boolean;
53
- min?: number;
54
- max?: number;
55
- pattern?: string;
56
- message?: string;
57
- };
58
- width?: string;
59
- align?: 'left' | 'center' | 'right';
60
- render?: (value: unknown, item: Record<string, unknown>) => string;
61
- placeholder?: string | (() => string);
62
- defaultValue?: unknown;
63
- order?: number;
64
- }>;
134
+ fields: CrudFieldDef[];
65
135
  defaultPageSize?: number;
66
136
  searchable?: boolean;
67
137
  searchPlaceholder?: string | (() => string);
@@ -78,11 +148,11 @@ export interface CrudPageProps<T = Record<string, unknown>> {
78
148
  remove?: (id: string) => Promise<void>;
79
149
  };
80
150
  };
81
- getListFields: () => Array<Record<string, unknown>>;
82
- getFilterFields: () => Array<Record<string, unknown>>;
83
- getCreateFields: () => Array<Record<string, unknown>>;
84
- getEditFields: () => Array<Record<string, unknown>>;
85
- getDetailFields: () => Array<Record<string, unknown>>;
151
+ getListFields: () => CrudFieldDef[];
152
+ getFilterFields: () => CrudFieldDef[];
153
+ getCreateFields: () => CrudFieldDef[];
154
+ getEditFields: () => CrudFieldDef[];
155
+ getDetailFields: () => CrudFieldDef[];
86
156
  toTableColumns: () => Array<{
87
157
  key: string;
88
158
  label: string;
@@ -108,18 +178,41 @@ export interface CrudPageProps<T = Record<string, unknown>> {
108
178
  data: CrudPageData<T>;
109
179
  /** 权限控制 */
110
180
  permissions?: CrudPermissions;
111
- /** 抽屉尺寸(默认 '2xl') */
112
- drawerSize?: Size;
181
+ /** 新建/编辑表单展示配置(抽屉或弹窗、尺寸、宽高) */
182
+ form?: CrudFormConfig;
183
+ /** 分页栏展示配置(每页条数选择、跳页、总数) */
184
+ pagination?: CrudPaginationConfig;
185
+ /** 列表显示密度:影响列表行、行内操作、分页与详情/编辑表单;不影响页头与筛选栏 */
186
+ density?: CrudDensity;
113
187
  /** 列表行点击是否打开详情(默认 true) */
114
188
  rowClickDetail?: boolean;
189
+ /** 点击后打开详情的列 key;只让标题等主标识列可点击时使用 */
190
+ detailColumns?: string[];
191
+ /** 工作区导航已有标题时默认隐藏,独立使用时默认显示;true/false 显式覆盖,操作仍保留在工具栏。 */
192
+ showHeader?: boolean;
115
193
  /** 列表行操作按钮插槽 */
116
194
  listItemActions?: Snippet<[T]>;
195
+ /** 自定义表格单元格插槽;参数依次为行记录和列 key。 */
196
+ tableCell?: Snippet<[T, string]>;
197
+ /** 点击表格行的回调。 */
198
+ onrowclick?: (item: T) => void;
117
199
  /** 编辑表单额外字段插槽 */
118
200
  editFormExtra?: Snippet<[T | null, 'create' | 'edit']>;
119
201
  /** 详情额外内容插槽 */
120
202
  detailExtra?: Snippet<[T]>;
121
203
  /** 页面头部额外操作区插槽 */
122
204
  headerActions?: Snippet;
205
+ /** 查询栏上方左侧内容插槽,可放置页面标题或说明。 */
206
+ toolbarLeading?: Snippet;
207
+ /** 工具栏右侧自定义操作插槽。 */
208
+ toolbarActions?: Snippet;
209
+ /** 卡片列表项渲染插槽;存在时替代数据表格,分页和滚动容器保持一致。 */
210
+ card?: Snippet<[T]>;
211
+ /** 后端支持的可排序列;为空时不显示排序按钮。 */
212
+ sortableColumns?: Array<{
213
+ key: string;
214
+ label: string;
215
+ }>;
123
216
  /** 删除前钩子(返回 false 取消) */
124
217
  onbeforedelete?: (item: T) => Promise<boolean> | boolean;
125
218
  /** 提交成功后钩子 */
@@ -1,12 +1,18 @@
1
1
  /**
2
2
  * @h-ai/ui — CRUD 场景组件
3
3
  *
4
- * 提供声明式 CRUD 页面组件,基于 kit.crud.define() 定义自动渲染列表、搜索过滤、分页、详情/编辑抽屉和删除确认。
4
+ * 提供声明式 CRUD 页面组件与框架级控制器:
5
+ * - `CrudPage` 组件:自动渲染列表、搜索过滤、分页、详情/编辑面板、删除确认,以及查询中/失败/空态。
6
+ * - `defineCrud` / `createCrudController`:纯客户端(无 SvelteKit SSR)下托管数据与导航,
7
+ * 业务应用无需自建 CRUD 适配层。
5
8
  * @module crud
6
9
  */
10
+ export * from './crud-controller.svelte.js';
7
11
  export type * from './crud-types.js';
8
12
  export { default as CrudDeleteConfirm } from './CrudDeleteConfirm.svelte';
9
- export { default as CrudDetailDrawer } from './CrudDetailDrawer.svelte';
10
- export { default as CrudEditDrawer } from './CrudEditDrawer.svelte';
13
+ export { default as CrudDetailPanel } from './CrudDetailPanel.svelte';
14
+ export { default as CrudEditPanel } from './CrudEditPanel.svelte';
11
15
  export { default as CrudFilterBar } from './CrudFilterBar.svelte';
12
16
  export { default as CrudPage } from './CrudPage.svelte';
17
+ export type { NavAdapter } from './nav-adapter.js';
18
+ export { createBrowserNavAdapter } from './nav-adapter.js';
@@ -1,11 +1,16 @@
1
1
  /**
2
2
  * @h-ai/ui — CRUD 场景组件
3
3
  *
4
- * 提供声明式 CRUD 页面组件,基于 kit.crud.define() 定义自动渲染列表、搜索过滤、分页、详情/编辑抽屉和删除确认。
4
+ * 提供声明式 CRUD 页面组件与框架级控制器:
5
+ * - `CrudPage` 组件:自动渲染列表、搜索过滤、分页、详情/编辑面板、删除确认,以及查询中/失败/空态。
6
+ * - `defineCrud` / `createCrudController`:纯客户端(无 SvelteKit SSR)下托管数据与导航,
7
+ * 业务应用无需自建 CRUD 适配层。
5
8
  * @module crud
6
9
  */
10
+ export * from './crud-controller.svelte.js';
7
11
  export { default as CrudDeleteConfirm } from './CrudDeleteConfirm.svelte';
8
- export { default as CrudDetailDrawer } from './CrudDetailDrawer.svelte';
9
- export { default as CrudEditDrawer } from './CrudEditDrawer.svelte';
12
+ export { default as CrudDetailPanel } from './CrudDetailPanel.svelte';
13
+ export { default as CrudEditPanel } from './CrudEditPanel.svelte';
10
14
  export { default as CrudFilterBar } from './CrudFilterBar.svelte';
11
15
  export { default as CrudPage } from './CrudPage.svelte';
16
+ export { createBrowserNavAdapter } from './nav-adapter.js';
@@ -0,0 +1,50 @@
1
+ /**
2
+ * @h-ai/ui — CRUD 导航适配器
3
+ *
4
+ * `CrudPage` 通过 `nav` prop 接入宿主路由系统,避免对任何具体框架(SvelteKit、
5
+ * 自实现 hash router 等)形成强依赖。
6
+ *
7
+ * - SvelteKit 应用:传入 `createSvelteKitNavAdapter()`(从 `@h-ai/kit/client` 导入)。
8
+ * - 纯浏览器 / Tauri / Capacitor:传入自定义实现或使用默认 `createBrowserNavAdapter()`。
9
+ *
10
+ * @module nav-adapter
11
+ */
12
+ /**
13
+ * 路由适配器接口。`CrudPage` 通过此接口完成:
14
+ * - 读取当前 pathname(作为列表 URL 的 basePath 兜底)
15
+ * - 调用 `navigate(url)` 同步搜索 / 过滤 / 分页参数到地址栏
16
+ * - 调用 `refresh()` 在写操作后重新拉取列表数据
17
+ *
18
+ * @example
19
+ * ```ts
20
+ * import type { NavAdapter } from '@h-ai/ui'
21
+ * const example: NavAdapter = { pathname: '/users', navigate: url => { globalThis.location?.assign(url) } }
22
+ * ```
23
+ */
24
+ export interface NavAdapter {
25
+ /** 当前页面路径(不含 query / hash),用于推导 `basePath`。 */
26
+ readonly pathname: string;
27
+ /** 跳转到指定 URL(可带 query),通常用于更新 URL 上的搜索/分页参数。 */
28
+ readonly navigate: (url: string) => void | Promise<void>;
29
+ /** 写操作完成后触发列表刷新;未提供时由调用方自行通过 `onaftersubmit` / `onafterdelete` 处理。 */
30
+ readonly refresh?: () => void | Promise<void>;
31
+ }
32
+ /**
33
+ * 创建基于浏览器 `globalThis.location` 的默认导航适配器。
34
+ *
35
+ * 适用场景:纯 SPA(无 SvelteKit)、Tauri、Capacitor 等可以直接读写 `location` 的环境。
36
+ *
37
+ * - `pathname` 读 `globalThis.location?.pathname`,SSR 下安全降级为 `''`。
38
+ * - `navigate(url)` 调 `globalThis.location.assign(url)`;如需客户端路由(hash router 等),
39
+ * 宿主应自行实现一个 `NavAdapter` 传入。
40
+ * - 不提供 `refresh`:浏览器默认导航本身会触发页面加载,调用方需在导航前/后重新拉取数据。
41
+ * @returns 基于浏览器 location 的导航适配器;SSR 下 pathname 为空字符串。
42
+ *
43
+ * @example
44
+ * ```ts
45
+ * import { createBrowserNavAdapter } from '@h-ai/ui'
46
+ * const nav = createBrowserNavAdapter()
47
+ * await nav.navigate('/users?page=2')
48
+ * ```
49
+ */
50
+ export declare function createBrowserNavAdapter(): NavAdapter;