@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
@@ -1,4 +1,5 @@
1
1
  <!--
2
+ @component Pagination
2
3
  =============================================================================
3
4
  @h-ai/ui - Pagination 组件
4
5
  =============================================================================
@@ -6,14 +7,25 @@
6
7
 
7
8
  使用 Svelte 5 Runes ($props, $derived, $bindable)
8
9
  =============================================================================
10
+
11
+ @example
12
+ ```ts
13
+ import { mount, unmount } from 'svelte'
14
+ import type { ComponentProps } from 'svelte'
15
+ import { Pagination } from '@h-ai/ui'
16
+ const props: ComponentProps<typeof Pagination> = { page: 1, total: 42, pageSize: 10 }
17
+ const component = mount(Pagination, { target: document.body, props })
18
+ await unmount(component)
19
+ ```
9
20
  -->
10
21
  <script lang='ts'>
11
- import type { PaginationProps } from '../../types.js'
22
+ import type { DataAttributes, PaginationProps } from '../../types.js'
12
23
  import { uiM } from '../../messages.js'
13
- import { cn, getSizeClass } from '../../utils.js'
24
+ import { cn, getDataAttributes } from '../../utils.js'
14
25
  import BareButton from '../primitives/BareButton.svelte'
15
26
 
16
27
  import Input from '../primitives/Input.svelte'
28
+ import Select from '../primitives/Select.svelte'
17
29
 
18
30
  let {
19
31
  page = $bindable(1),
@@ -22,136 +34,158 @@
22
34
  size = 'md',
23
35
  showTotal = true,
24
36
  showJumper = false,
37
+ showSizeChanger = false,
38
+ showPageInfo = true,
39
+ showFirstLast = true,
40
+ pageSizeOptions = [10, 20, 50, 100],
25
41
  labels = {},
26
42
  class: className = '',
27
43
  onchange,
28
- }: PaginationProps = $props()
44
+ onpagesizechange,
45
+ ...restProps
46
+ }: PaginationProps & DataAttributes = $props()
29
47
 
48
+ const dataAttributes = $derived(getDataAttributes(restProps))
49
+ const controlId = $props.id()
30
50
  // labels 优先,缺省回退到内置消息 uiM(...)
31
51
 
32
- // 计算总页数
33
- const totalPages = $derived(Math.ceil(total / pageSize))
34
-
35
- // 生成页码列表
36
- const pages = $derived(() => {
37
- const result: (number | string)[] = []
38
- const maxVisible = 7
39
-
40
- if (totalPages <= maxVisible) {
41
- for (let i = 1; i <= totalPages; i++) {
42
- result.push(i)
43
- }
44
- }
45
- else {
46
- // 始终显示第一页
47
- result.push(1)
48
-
49
- if (page > 3) {
50
- result.push('...')
51
- }
52
-
53
- // 中间页码
54
- const start = Math.max(2, page - 1)
55
- const end = Math.min(totalPages - 1, page + 1)
56
-
57
- for (let i = start; i <= end; i++) {
58
- result.push(i)
59
- }
60
-
61
- if (page < totalPages - 2) {
62
- result.push('...')
63
- }
64
-
65
- // 始终显示最后一页
66
- result.push(totalPages)
67
- }
68
-
69
- return result
70
- })
71
-
72
- const joinClass = $derived(
73
- cn(
74
- 'join',
75
- className,
76
- ),
52
+ // 计算总页数(至少 1 页,保证分页栏在空数据时仍可渲染)
53
+ const totalPages = $derived(Math.max(1, Math.ceil(total / pageSize)))
54
+
55
+ const controlSize = $derived(size === 'xs' ? 'xs' : 'sm')
56
+ const jumperControlSize = 'xs'
57
+ const sizeChangerClass = $derived(size === 'xs' ? 'w-17 shrink-0' : 'w-18 shrink-0')
58
+ const pageSizeSelectOptions = $derived(pageSizeOptions.map(opt => ({ value: String(opt), label: String(opt) })))
59
+ const jumperWrapClass = $derived(size === 'xs' ? 'flex min-w-fit items-center gap-1.5 whitespace-nowrap' : 'flex min-w-fit items-center gap-2 whitespace-nowrap')
60
+ const jumperInputClass = $derived(
61
+ size === 'xs'
62
+ ? 'w-[2.25rem] shrink-0 [&>.fieldset]:m-0 [&>.fieldset]:min-w-0'
63
+ : 'w-[2.5rem] shrink-0 [&>.fieldset]:m-0 [&>.fieldset]:min-w-0',
77
64
  )
78
65
 
79
- const btnClass = $derived(
80
- cn(
81
- 'join-item btn',
82
- getSizeClass(size),
83
- ),
84
- )
66
+ // 可写派生值保留编辑草稿,父级页码变化时自动恢复实际值。
67
+ let jumperValue = $derived(String(page))
85
68
 
86
69
  function goToPage(p: number) {
87
- if (p >= 1 && p <= totalPages && p !== page) {
88
- page = p
89
- onchange?.(p)
70
+ const clamped = Math.max(1, Math.min(totalPages, Math.round(p)))
71
+ if (clamped !== page) {
72
+ page = clamped
73
+ jumperValue = String(clamped)
74
+ onchange?.(clamped)
90
75
  }
91
76
  }
92
77
 
93
- let jumperValue = $state('')
94
-
95
78
  function handleJump() {
96
79
  const p = Number.parseInt(jumperValue, 10)
97
80
  if (!Number.isNaN(p)) {
98
81
  goToPage(p)
99
- jumperValue = ''
100
82
  }
101
83
  }
84
+
85
+ function handleJumperBlur() {
86
+ handleJump()
87
+ }
88
+
89
+ function handlePageSizeChange(value: string) {
90
+ const next = Number.parseInt(value, 10)
91
+ if (!Number.isNaN(next) && next !== pageSize) {
92
+ onpagesizechange?.(next)
93
+ }
94
+ }
95
+
96
+ // 统一 table 风格:首/上/下/末 导航按钮样式(等比例缩小)
97
+ const navBtnClass = $derived(
98
+ size === 'xs'
99
+ ? 'inline-flex h-6 w-6 items-center justify-center rounded-md border border-base-content/12 text-base-content/55 transition-colors hover:bg-base-content/5 hover:text-base-content disabled:pointer-events-none disabled:opacity-40'
100
+ : 'inline-flex h-7 w-7 items-center justify-center rounded-md border border-base-content/12 text-base-content/55 transition-colors hover:bg-base-content/5 hover:text-base-content disabled:pointer-events-none disabled:opacity-40',
101
+ )
102
+ const navIconClass = $derived(size === 'xs' ? 'size-3.5' : 'size-3.5')
103
+ const tableTextClass = $derived(size === 'xs' ? 'text-xs text-base-content/60' : 'text-sm text-base-content/60')
104
+ const rowGapClass = $derived(size === 'xs' ? 'flex flex-wrap items-center gap-3 sm:gap-4' : 'flex flex-wrap items-center gap-4 sm:gap-6')
105
+ const pageInfoText = $derived(
106
+ (labels.pageInfo ?? uiM('pagination_page_info'))
107
+ .replace('{page}', String(page))
108
+ .replace('{total}', String(totalPages)),
109
+ )
102
110
  </script>
103
111
 
104
- <div class='flex items-center gap-4'>
112
+ <div {...dataAttributes} class={cn('flex flex-wrap items-center justify-between gap-4', className)}>
105
113
  {#if showTotal}
106
- <span class='text-sm text-base-content/70'>
114
+ <span class={tableTextClass}>
107
115
  {(labels.total ?? uiM('pagination_total')).replace('{count}', String(total))}
108
116
  </span>
117
+ {:else}
118
+ <span></span>
109
119
  {/if}
110
120
 
111
- <div class={joinClass}>
112
- <BareButton
113
- class={btnClass}
114
- disabled={page === 1}
115
- onclick={() => goToPage(page - 1)}
116
- >
117
- «
118
- </BareButton>
119
-
120
- {#each pages() as p}
121
- {#if typeof p === 'number'}
122
- <BareButton
123
- class={cn(btnClass, page === p && 'btn-active')}
124
- onclick={() => goToPage(p)}
125
- >
126
- {p}
121
+ <div class={rowGapClass}>
122
+ {#if showSizeChanger}
123
+ <div class='flex items-center gap-2'>
124
+ <label for={`${controlId}-size`} class={tableTextClass}>{labels.rowsPerPage ?? uiM('pagination_rows_per_page')}</label>
125
+ <div class={sizeChangerClass}>
126
+ <Select
127
+ id={`${controlId}-size`}
128
+ size={controlSize}
129
+ value={String(pageSize)}
130
+ options={pageSizeSelectOptions}
131
+ onchange={handlePageSizeChange}
132
+ />
133
+ </div>
134
+ </div>
135
+ {/if}
136
+
137
+ {#if showPageInfo}
138
+ <span class={tableTextClass} aria-live='polite' aria-atomic='true'>{pageInfoText}</span>
139
+ {/if}
140
+
141
+ <div class='hai-pagination__navigation flex items-center gap-1'>
142
+ {#if showFirstLast}
143
+ <BareButton class={navBtnClass} disabled={page === 1} onclick={() => goToPage(1)} ariaLabel={uiM('pagination_first')}>
144
+ <span class={cn('icon-[tabler--chevrons-left]', navIconClass)}></span>
145
+ </BareButton>
146
+ {/if}
147
+ <BareButton class={navBtnClass} disabled={page === 1} onclick={() => goToPage(page - 1)} ariaLabel={uiM('pagination_previous')}>
148
+ <span class={cn('icon-[tabler--chevron-left]', navIconClass)}></span>
149
+ </BareButton>
150
+ <BareButton class={navBtnClass} disabled={page === totalPages} onclick={() => goToPage(page + 1)} ariaLabel={uiM('pagination_next')}>
151
+ <span class={cn('icon-[tabler--chevron-right]', navIconClass)}></span>
152
+ </BareButton>
153
+ {#if showFirstLast}
154
+ <BareButton class={navBtnClass} disabled={page === totalPages} onclick={() => goToPage(totalPages)} ariaLabel={uiM('pagination_last')}>
155
+ <span class={cn('icon-[tabler--chevrons-right]', navIconClass)}></span>
127
156
  </BareButton>
128
- {:else}
129
- <BareButton class={cn(btnClass, 'btn-disabled')} disabled>...</BareButton>
130
157
  {/if}
131
- {/each}
132
-
133
- <BareButton
134
- class={btnClass}
135
- disabled={page === totalPages}
136
- onclick={() => goToPage(page + 1)}
137
- >
138
- »
139
- </BareButton>
140
- </div>
141
-
142
- {#if showJumper}
143
- <div class='flex items-center gap-2'>
144
- <span class='text-sm'>{labels.jumpTo ?? uiM('pagination_jump_to')}</span>
145
- <Input
146
- type='number'
147
- size='sm'
148
- class='w-16'
149
- min={1}
150
- max={totalPages}
151
- bind:value={jumperValue}
152
- onkeydown={(e: KeyboardEvent & { currentTarget: HTMLInputElement }) => e.key === 'Enter' && handleJump()}
153
- />
154
- <span class='text-sm'>{labels.page ?? uiM('pagination_page')}</span>
155
158
  </div>
156
- {/if}
159
+
160
+ {#if showJumper}
161
+ <div class={jumperWrapClass}>
162
+ <span class={tableTextClass}>{labels.jumpTo ?? uiM('pagination_jump_to')}</span>
163
+ <div class={jumperInputClass}>
164
+ <label for={`${controlId}-jump`} class='sr-only'>{uiM('pagination_jump_label')}</label>
165
+ <Input
166
+ id={`${controlId}-jump`}
167
+ type='number'
168
+ size={jumperControlSize}
169
+ class='h-7 w-full rounded-md [&_input]:px-1.5 [&_input]:text-center [&_input]:text-[12px]'
170
+ min={1}
171
+ max={totalPages}
172
+ bind:value={jumperValue}
173
+ onkeydown={(e: KeyboardEvent & { currentTarget: HTMLInputElement }) => e.key === 'Enter' && handleJump()}
174
+ onblur={handleJumperBlur}
175
+ />
176
+ </div>
177
+ <span class={tableTextClass}>{labels.page ?? uiM('pagination_page')}</span>
178
+ </div>
179
+ {/if}
180
+ </div>
157
181
  </div>
182
+
183
+ <style>
184
+ /* 桌面保持紧凑;触摸设备扩大真实命中区域。 */
185
+ @media (pointer: coarse) {
186
+ .hai-pagination__navigation :global(button) {
187
+ min-width: var(--hai-touch-target-min, 44px);
188
+ min-height: var(--hai-touch-target-min, 44px);
189
+ }
190
+ }
191
+ </style>
@@ -1,4 +1,25 @@
1
- import type { PaginationProps } from '../../types.js';
2
- declare const Pagination: import("svelte").Component<PaginationProps, {}, "page">;
1
+ import type { DataAttributes, PaginationProps } from '../../types.js';
2
+ type $$ComponentProps = PaginationProps & DataAttributes;
3
+ /**
4
+ * Pagination
5
+ * =============================================================================
6
+ * @h-ai/ui - Pagination 组件
7
+ * =============================================================================
8
+ * 分页组件
9
+ *
10
+ * 使用 Svelte 5 Runes ($props, $derived, $bindable)
11
+ * =============================================================================
12
+ *
13
+ * @example
14
+ * ```ts
15
+ * import { mount, unmount } from 'svelte'
16
+ * import type { ComponentProps } from 'svelte'
17
+ * import { Pagination } from '@h-ai/ui'
18
+ * const props: ComponentProps<typeof Pagination> = { page: 1, total: 42, pageSize: 10 }
19
+ * const component = mount(Pagination, { target: document.body, props })
20
+ * await unmount(component)
21
+ * ```
22
+ */
23
+ declare const Pagination: import("svelte").Component<$$ComponentProps, {}, "page">;
3
24
  type Pagination = ReturnType<typeof Pagination>;
4
25
  export default Pagination;
@@ -1,4 +1,5 @@
1
1
  <!--
2
+ @component Popover
2
3
  =============================================================================
3
4
  @h-ai/ui - Popover 组件
4
5
  =============================================================================
@@ -6,25 +7,43 @@
6
7
 
7
8
  使用 Svelte 5 Runes ($props, $state, $effect)
8
9
  =============================================================================
10
+
11
+ @example
12
+ ```ts
13
+ import { mount, unmount, createRawSnippet } from 'svelte'
14
+ import type { ComponentProps } from 'svelte'
15
+ import { Popover } from '@h-ai/ui'
16
+ const props: ComponentProps<typeof Popover> = { position: 'bottom', portal: true, children: createRawSnippet(() => ({ render: () => "<span>提示内容</span>" })) }
17
+ const component = mount(Popover, { target: document.body, props })
18
+ await unmount(component)
19
+ ```
9
20
  -->
10
21
  <script lang='ts'>
11
- import type { PopoverProps } from '../../types.js'
12
- import { cn } from '../../utils.js'
22
+ import type { DataAttributes, PopoverProps } from '../../types.js'
23
+ import { tick } from 'svelte'
24
+ import { cn, getDataAttributes, portal as portalAction } from '../../utils.js'
13
25
 
14
26
  let {
15
27
  open = $bindable(false),
16
28
  position = 'bottom',
17
29
  trigger = 'click',
18
30
  offset = 8,
31
+ portal = false,
19
32
  class: className = '',
20
33
  onopen,
21
34
  onclose,
22
35
  triggerContent,
23
36
  children,
24
- }: PopoverProps = $props()
37
+ ...restProps
38
+ }: PopoverProps & DataAttributes = $props()
25
39
 
40
+ const dataAttributes = $derived(getDataAttributes(restProps))
26
41
  let triggerElement = $state<HTMLDivElement | null>(null)
27
42
  let popoverElement = $state<HTMLDivElement | null>(null)
43
+ /** portal 模式下的 fixed 坐标;每次滚动或缩放后重新计算。 */
44
+ let portalStyle = $state('')
45
+ /** 首帧布局收敛后的二次定位帧,关闭时必须取消避免过期写入。 */
46
+ let portalPositionFrame: number | undefined = $state()
28
47
 
29
48
  const positionClass = $derived({
30
49
  top: 'bottom-full left-1/2 -translate-x-1/2 mb-2',
@@ -40,6 +59,51 @@
40
59
  right: 'right-full top-1/2 -translate-y-1/2 border-r-base-100 border-t-transparent border-l-transparent border-b-transparent',
41
60
  }[position])
42
61
 
62
+ /** portal 模式下不再依赖相对容器,改用视口坐标并在边缘自动收敛。 */
63
+ function updatePortalPosition(): void {
64
+ if (!triggerElement || !popoverElement) {
65
+ return
66
+ }
67
+
68
+ const triggerRect = triggerElement.getBoundingClientRect()
69
+ const popoverRect = popoverElement.getBoundingClientRect()
70
+ const viewportPadding = 8
71
+ const gap = offset
72
+ const maxLeft = Math.max(viewportPadding, window.innerWidth - popoverRect.width - viewportPadding)
73
+ const maxTop = Math.max(viewportPadding, window.innerHeight - popoverRect.height - viewportPadding)
74
+ let left = triggerRect.left + (triggerRect.width - popoverRect.width) / 2
75
+ let top = triggerRect.bottom + gap
76
+
77
+ if (position === 'top') {
78
+ top = triggerRect.top - popoverRect.height - gap
79
+ }
80
+ else if (position === 'left') {
81
+ left = triggerRect.left - popoverRect.width - gap
82
+ top = triggerRect.top + (triggerRect.height - popoverRect.height) / 2
83
+ }
84
+ else if (position === 'right') {
85
+ left = triggerRect.right + gap
86
+ top = triggerRect.top + (triggerRect.height - popoverRect.height) / 2
87
+ }
88
+
89
+ portalStyle = `position:fixed;left:${Math.round(Math.min(Math.max(viewportPadding, left), maxLeft))}px;top:${Math.round(Math.min(Math.max(viewportPadding, top), maxTop))}px;z-index:1200;`
90
+ }
91
+
92
+ /** 等 portal 挂载完成后复测,避免首帧按未完成内容高度定位。 */
93
+ async function scheduleSettledPortalPosition(): Promise<void> {
94
+ await tick()
95
+ if (!open || !portal) {
96
+ return
97
+ }
98
+
99
+ portalPositionFrame = window.requestAnimationFrame(() => {
100
+ portalPositionFrame = undefined
101
+ if (open && portal) {
102
+ updatePortalPosition()
103
+ }
104
+ })
105
+ }
106
+
43
107
  function handleOpen() {
44
108
  open = true
45
109
  onopen?.()
@@ -93,13 +157,34 @@
93
157
  document.removeEventListener('click', handleClickOutside)
94
158
  }
95
159
  })
160
+
161
+ // portal 内容脱离原始相对定位容器后,以 fixed 坐标跟随触发器滚动和缩放。
162
+ $effect(() => {
163
+ if (!open || !portal) {
164
+ return
165
+ }
166
+
167
+ updatePortalPosition()
168
+ void scheduleSettledPortalPosition()
169
+ const listenerOptions = { passive: true, capture: true } as const
170
+ window.addEventListener('scroll', updatePortalPosition, listenerOptions)
171
+ window.addEventListener('resize', updatePortalPosition)
172
+ return () => {
173
+ if (portalPositionFrame !== undefined) {
174
+ window.cancelAnimationFrame(portalPositionFrame)
175
+ portalPositionFrame = undefined
176
+ }
177
+ window.removeEventListener('scroll', updatePortalPosition, listenerOptions)
178
+ window.removeEventListener('resize', updatePortalPosition)
179
+ }
180
+ })
96
181
  </script>
97
182
 
98
- <div
99
- class={cn('relative inline-block', className)}
100
- role='group'
101
- onmouseenter={handleMouseEnter}
102
- onmouseleave={handleMouseLeave}
183
+ <div {...dataAttributes}
184
+ class={cn('relative inline-block', className)}
185
+ role='group'
186
+ onmouseenter={handleMouseEnter}
187
+ onmouseleave={handleMouseLeave}
103
188
  >
104
189
  <!-- 触发器 -->
105
190
  <div
@@ -115,23 +200,37 @@
115
200
  {/if}
116
201
  </div>
117
202
 
118
- <!-- 弹出内容 -->
203
+ <!-- 弹出内容;portal 模式用于逃逸滚动容器的 overflow 裁剪。 -->
119
204
  {#if open}
120
- <div
121
- bind:this={popoverElement}
122
- class={cn(
123
- 'absolute z-50 bg-base-100 rounded-box shadow-lg border border-base-200 p-4',
124
- positionClass,
125
- )}
126
- style='--offset: {offset}px'
127
- role='dialog'
128
- >
129
- <!-- 箭头 -->
130
- <div class={cn('absolute w-0 h-0 border-8', arrowClass)}></div>
131
-
132
- {#if children}
133
- {@render children()}
134
- {/if}
135
- </div>
205
+ {#if portal}
206
+ <div
207
+ bind:this={popoverElement}
208
+ use:portalAction
209
+ class='fixed z-50 rounded-box border border-base-200 bg-base-100 p-4 shadow-lg'
210
+ style={portalStyle}
211
+ role='dialog'
212
+ >
213
+ {#if children}
214
+ {@render children()}
215
+ {/if}
216
+ </div>
217
+ {:else}
218
+ <div
219
+ bind:this={popoverElement}
220
+ class={cn(
221
+ 'absolute z-50 bg-base-100 rounded-box shadow-lg border border-base-200 p-4',
222
+ positionClass,
223
+ )}
224
+ style='--offset: {offset}px'
225
+ role='dialog'
226
+ >
227
+ <!-- 箭头 -->
228
+ <div class={cn('absolute w-0 h-0 border-8', arrowClass)}></div>
229
+
230
+ {#if children}
231
+ {@render children()}
232
+ {/if}
233
+ </div>
234
+ {/if}
136
235
  {/if}
137
236
  </div>
@@ -1,4 +1,25 @@
1
- import type { PopoverProps } from '../../types.js';
2
- declare const Popover: import("svelte").Component<PopoverProps, {}, "open">;
1
+ import type { DataAttributes, PopoverProps } from '../../types.js';
2
+ type $$ComponentProps = PopoverProps & DataAttributes;
3
+ /**
4
+ * Popover
5
+ * =============================================================================
6
+ * @h-ai/ui - Popover 组件
7
+ * =============================================================================
8
+ * 弹出层组件
9
+ *
10
+ * 使用 Svelte 5 Runes ($props, $state, $effect)
11
+ * =============================================================================
12
+ *
13
+ * @example
14
+ * ```ts
15
+ * import { mount, unmount, createRawSnippet } from 'svelte'
16
+ * import type { ComponentProps } from 'svelte'
17
+ * import { Popover } from '@h-ai/ui'
18
+ * const props: ComponentProps<typeof Popover> = { position: 'bottom', portal: true, children: createRawSnippet(() => ({ render: () => "<span>提示内容</span>" })) }
19
+ * const component = mount(Popover, { target: document.body, props })
20
+ * await unmount(component)
21
+ * ```
22
+ */
23
+ declare const Popover: import("svelte").Component<$$ComponentProps, {}, "open">;
3
24
  type Popover = ReturnType<typeof Popover>;
4
25
  export default Popover;
@@ -1,15 +1,40 @@
1
1
  <!--
2
+ @component PullRefresh
2
3
  @h-ai/ui — PullRefresh(下拉刷新)
3
4
 
4
5
  用法:
5
6
  <PullRefresh onrefresh={async () => await loadData()} >
6
7
  <div>列表内容</div>
7
8
  </PullRefresh>
9
+
10
+ @example
11
+ ```ts
12
+ import { mount, unmount, createRawSnippet } from 'svelte'
13
+ import type { ComponentProps } from 'svelte'
14
+ import { PullRefresh } from '@h-ai/ui'
15
+ const props: ComponentProps<typeof PullRefresh> = { threshold: 80, children: createRawSnippet(() => ({ render: () => "<p>可下拉更新的内容。</p>" })) }
16
+ const component = mount(PullRefresh, { target: document.body, props })
17
+ await unmount(component)
18
+ ```
8
19
  -->
9
20
  <script lang='ts'>
10
21
  import type { Snippet } from 'svelte'
11
- import { cn } from '../../utils.js'
22
+ import type { DataAttributes } from '../../types.js'
23
+ import { cn, getDataAttributes } from '../../utils.js'
12
24
 
25
+ /**
26
+ * PullRefresh 组件的属性契约;通过公开组件配置使用。
27
+ *
28
+ * @example
29
+ * ```ts
30
+ * import { mount, unmount, createRawSnippet } from 'svelte'
31
+ * import type { ComponentProps } from 'svelte'
32
+ * import { PullRefresh } from '@h-ai/ui'
33
+ * const props: ComponentProps<typeof PullRefresh> = { threshold: 80, children: createRawSnippet(() => ({ render: () => "<p>可下拉更新的内容。</p>" })) }
34
+ * const component = mount(PullRefresh, { target: document.body, props })
35
+ * await unmount(component)
36
+ * ```
37
+ */
13
38
  interface Props {
14
39
  /** 刷新回调(需返回 Promise) */
15
40
  onrefresh?: () => Promise<void>
@@ -29,8 +54,10 @@
29
54
  disabled = false,
30
55
  class: className,
31
56
  children,
32
- }: Props = $props()
57
+ ...restProps
58
+ }: Props & DataAttributes = $props()
33
59
 
60
+ const dataAttributes = $derived(getDataAttributes(restProps))
34
61
  let pulling = $state(false)
35
62
  let refreshing = $state(false)
36
63
  let pullDistance = $state(0)
@@ -71,12 +98,12 @@
71
98
  }
72
99
  </script>
73
100
 
74
- <div
75
- class={cn('relative overflow-hidden', className)}
76
- ontouchstart={handleTouchStart}
77
- ontouchmove={handleTouchMove}
78
- ontouchend={handleTouchEnd}
79
- role='region'
101
+ <div {...dataAttributes}
102
+ class={cn('relative overflow-hidden', className)}
103
+ ontouchstart={handleTouchStart}
104
+ ontouchmove={handleTouchMove}
105
+ ontouchend={handleTouchEnd}
106
+ role='region'
80
107
  >
81
108
  <!-- 刷新指示器 -->
82
109
  <div
@@ -1,4 +1,18 @@
1
1
  import type { Snippet } from 'svelte';
2
+ import type { DataAttributes } from '../../types.js';
3
+ /**
4
+ * PullRefresh 组件的属性契约;通过公开组件配置使用。
5
+ *
6
+ * @example
7
+ * ```ts
8
+ * import { mount, unmount, createRawSnippet } from 'svelte'
9
+ * import type { ComponentProps } from 'svelte'
10
+ * import { PullRefresh } from '@h-ai/ui'
11
+ * const props: ComponentProps<typeof PullRefresh> = { threshold: 80, children: createRawSnippet(() => ({ render: () => "<p>可下拉更新的内容。</p>" })) }
12
+ * const component = mount(PullRefresh, { target: document.body, props })
13
+ * await unmount(component)
14
+ * ```
15
+ */
2
16
  interface Props {
3
17
  /** 刷新回调(需返回 Promise) */
4
18
  onrefresh?: () => Promise<void>;
@@ -11,6 +25,26 @@ interface Props {
11
25
  /** 内容 */
12
26
  children: Snippet;
13
27
  }
14
- declare const PullRefresh: import("svelte").Component<Props, {}, "">;
28
+ type $$ComponentProps = Props & DataAttributes;
29
+ /**
30
+ * PullRefresh
31
+ * @h-ai/ui — PullRefresh(下拉刷新)
32
+ *
33
+ * 用法:
34
+ * <PullRefresh onrefresh={async () => await loadData()} >
35
+ * <div>列表内容</div>
36
+ * </PullRefresh>
37
+ *
38
+ * @example
39
+ * ```ts
40
+ * import { mount, unmount, createRawSnippet } from 'svelte'
41
+ * import type { ComponentProps } from 'svelte'
42
+ * import { PullRefresh } from '@h-ai/ui'
43
+ * const props: ComponentProps<typeof PullRefresh> = { threshold: 80, children: createRawSnippet(() => ({ render: () => "<p>可下拉更新的内容。</p>" })) }
44
+ * const component = mount(PullRefresh, { target: document.body, props })
45
+ * await unmount(component)
46
+ * ```
47
+ */
48
+ declare const PullRefresh: import("svelte").Component<$$ComponentProps, {}, "">;
15
49
  type PullRefresh = ReturnType<typeof PullRefresh>;
16
50
  export default PullRefresh;