weifuwu 0.86.0 → 0.87.0

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 (651) hide show
  1. package/README.md +56 -45
  2. package/content/apps/admin.md +55 -0
  3. package/content/apps/agent-platform.md +35 -0
  4. package/content/apps/auth.md +49 -0
  5. package/content/apps/multi.md +44 -0
  6. package/content/apps/todo.md +51 -0
  7. package/content/backend/ai.md +28 -0
  8. package/content/backend/auth.md +20 -0
  9. package/content/backend/email.md +23 -0
  10. package/content/backend/graphql.md +23 -0
  11. package/content/backend/http.md +23 -0
  12. package/content/backend/limit.md +23 -0
  13. package/content/backend/middleware.md +17 -0
  14. package/content/backend/queue.md +23 -0
  15. package/content/backend/redis.md +26 -0
  16. package/content/backend/router.md +23 -0
  17. package/content/backend/schedule.md +23 -0
  18. package/content/backend/sql.md +27 -0
  19. package/content/backend/sse.md +26 -0
  20. package/content/backend/ws.md +26 -0
  21. package/content/capabilities/app-node.md +21 -0
  22. package/content/capabilities/data.md +21 -0
  23. package/content/capabilities/events.md +21 -0
  24. package/content/capabilities/hooks.md +22 -0
  25. package/content/capabilities/i18n.md +21 -0
  26. package/content/capabilities/popup.md +21 -0
  27. package/content/capabilities/render-only.md +23 -0
  28. package/content/capabilities/router.md +22 -0
  29. package/content/capabilities/self-id.md +21 -0
  30. package/content/capabilities/store.md +21 -0
  31. package/content/capabilities/theme.md +21 -0
  32. package/content/capabilities/two-phase.md +21 -0
  33. package/content/components/accordion.md +50 -0
  34. package/content/components/actionsheet.md +46 -0
  35. package/content/components/affix.md +51 -0
  36. package/content/components/aichat.md +57 -0
  37. package/content/components/alert.md +52 -0
  38. package/content/components/alertgroup.md +45 -0
  39. package/content/components/anchor.md +52 -0
  40. package/content/components/app.md +37 -0
  41. package/content/components/approvalcard.md +56 -0
  42. package/content/components/appshell.md +50 -0
  43. package/content/components/aspectratio.md +47 -0
  44. package/content/components/authpage.md +61 -0
  45. package/content/components/autocomplete-v2.md +40 -0
  46. package/content/components/autocomplete.md +56 -0
  47. package/content/components/avatar.md +51 -0
  48. package/content/components/avatargroup.md +47 -0
  49. package/content/components/backtop.md +53 -0
  50. package/content/components/badge.md +55 -0
  51. package/content/components/breadcrumb.md +49 -0
  52. package/content/components/button.md +63 -0
  53. package/content/components/calendar-v2.md +40 -0
  54. package/content/components/calendar.md +50 -0
  55. package/content/components/card.md +58 -0
  56. package/content/components/carousel.md +52 -0
  57. package/content/components/cascader-v2.md +39 -0
  58. package/content/components/cascader.md +54 -0
  59. package/content/components/chart.md +53 -0
  60. package/content/components/chatinput.md +63 -0
  61. package/content/components/checkbox.md +51 -0
  62. package/content/components/checkboxgroup.md +52 -0
  63. package/content/components/citationcard.md +48 -0
  64. package/content/components/codeblock.md +48 -0
  65. package/content/components/codeeditor.md +47 -0
  66. package/content/components/collapse.md +49 -0
  67. package/content/components/colorpicker.md +50 -0
  68. package/content/components/command.md +50 -0
  69. package/content/components/confirm.md +57 -0
  70. package/content/components/contextmenu.md +48 -0
  71. package/content/components/copybutton.md +51 -0
  72. package/content/components/datepicker.md +52 -0
  73. package/content/components/descriptions-v2.md +39 -0
  74. package/content/components/descriptions.md +52 -0
  75. package/content/components/diffview-v2.md +39 -0
  76. package/content/components/diffview.md +50 -0
  77. package/content/components/divider.md +48 -0
  78. package/content/components/drawer.md +55 -0
  79. package/content/components/dropdown.md +53 -0
  80. package/content/components/editor.md +49 -0
  81. package/content/components/emptystate.md +51 -0
  82. package/content/components/exportcsv.md +38 -0
  83. package/content/components/field.md +54 -0
  84. package/content/components/filepreview-office.md +37 -0
  85. package/content/components/filepreview.md +49 -0
  86. package/content/components/filetree.md +56 -0
  87. package/content/components/fileupload-v2.md +39 -0
  88. package/content/components/fileupload.md +57 -0
  89. package/content/components/floatbutton.md +52 -0
  90. package/content/components/form-v2.md +41 -0
  91. package/content/components/form.md +60 -0
  92. package/content/components/grid.md +51 -0
  93. package/content/components/highlight-v2.md +39 -0
  94. package/content/components/highlight.md +46 -0
  95. package/content/components/hovercard.md +51 -0
  96. package/content/components/icon.md +50 -0
  97. package/content/components/imagecropper.md +45 -0
  98. package/content/components/img.md +56 -0
  99. package/content/components/infinitescroll-v2.md +40 -0
  100. package/content/components/infinitescroll.md +54 -0
  101. package/content/components/input.md +65 -0
  102. package/content/components/inputnumber.md +58 -0
  103. package/content/components/inview.md +56 -0
  104. package/content/components/jsonschemaform.md +53 -0
  105. package/content/components/jsonviewer-v2.md +39 -0
  106. package/content/components/jsonviewer.md +49 -0
  107. package/content/components/kanban.md +46 -0
  108. package/content/components/label.md +48 -0
  109. package/content/components/layout.md +54 -0
  110. package/content/components/layoutcontent.md +43 -0
  111. package/content/components/layoutheader.md +43 -0
  112. package/content/components/layoutsider.md +43 -0
  113. package/content/components/link.md +52 -0
  114. package/content/components/list.md +44 -0
  115. package/content/components/loading.md +45 -0
  116. package/content/components/logviewer-v2.md +39 -0
  117. package/content/components/logviewer.md +53 -0
  118. package/content/components/markdown.md +51 -0
  119. package/content/components/markdowneditor.md +47 -0
  120. package/content/components/math.md +42 -0
  121. package/content/components/mentions-v2.md +39 -0
  122. package/content/components/mentions.md +52 -0
  123. package/content/components/menu.md +56 -0
  124. package/content/components/menubar.md +44 -0
  125. package/content/components/messagebubble.md +50 -0
  126. package/content/components/modal.md +59 -0
  127. package/content/components/navmenu.md +47 -0
  128. package/content/components/notification.md +51 -0
  129. package/content/components/pageheader.md +53 -0
  130. package/content/components/pagination.md +49 -0
  131. package/content/components/paragraph.md +45 -0
  132. package/content/components/passwordinput.md +57 -0
  133. package/content/components/pininput-v2.md +39 -0
  134. package/content/components/pininput.md +50 -0
  135. package/content/components/pipeline.md +49 -0
  136. package/content/components/popconfirm.md +58 -0
  137. package/content/components/popover.md +61 -0
  138. package/content/components/progressbar.md +50 -0
  139. package/content/components/prompttemplate.md +49 -0
  140. package/content/components/qrcode.md +50 -0
  141. package/content/components/radiogroup.md +53 -0
  142. package/content/components/rate.md +53 -0
  143. package/content/components/reasoningblock.md +47 -0
  144. package/content/components/relationgraph.md +52 -0
  145. package/content/components/resizable.md +53 -0
  146. package/content/components/result.md +49 -0
  147. package/content/components/scrollbar.md +49 -0
  148. package/content/components/searchinput.md +51 -0
  149. package/content/components/segmentedcontrol.md +59 -0
  150. package/content/components/select-searchable.md +47 -0
  151. package/content/components/select.md +66 -0
  152. package/content/components/sessionlist.md +52 -0
  153. package/content/components/sheetgrid.md +44 -0
  154. package/content/components/skeleton.md +55 -0
  155. package/content/components/slidecanvas.md +44 -0
  156. package/content/components/slider.md +62 -0
  157. package/content/components/sortablelist.md +39 -0
  158. package/content/components/space.md +52 -0
  159. package/content/components/sparkline.md +52 -0
  160. package/content/components/statcard-countdown.md +39 -0
  161. package/content/components/statcard.md +56 -0
  162. package/content/components/steps.md +48 -0
  163. package/content/components/switch.md +50 -0
  164. package/content/components/tabbar.md +45 -0
  165. package/content/components/table-v2.md +40 -0
  166. package/content/components/table.md +66 -0
  167. package/content/components/tabs.md +56 -0
  168. package/content/components/tag.md +51 -0
  169. package/content/components/tagsinput-v2.md +39 -0
  170. package/content/components/tagsinput.md +54 -0
  171. package/content/components/text.md +45 -0
  172. package/content/components/textarea.md +57 -0
  173. package/content/components/themeswitch.md +69 -0
  174. package/content/components/timeline.md +50 -0
  175. package/content/components/title.md +45 -0
  176. package/content/components/toast.md +52 -0
  177. package/content/components/toggle-togglegroup.md +52 -0
  178. package/content/components/togglegroup.md +47 -0
  179. package/content/components/toolcallcard.md +51 -0
  180. package/content/components/tooltip.md +50 -0
  181. package/content/components/tour.md +50 -0
  182. package/content/components/transfer.md +52 -0
  183. package/content/components/tree-v2.md +39 -0
  184. package/content/components/tree.md +59 -0
  185. package/content/components/treeselect.md +54 -0
  186. package/content/components/typography.md +51 -0
  187. package/content/components/videoplayer.md +52 -0
  188. package/content/components/virtuallist.md +52 -0
  189. package/content/components/virtualtable-v2.md +39 -0
  190. package/content/components/virtualtable.md +55 -0
  191. package/content/components/watermark.md +53 -0
  192. package/content/components/wave.md +43 -0
  193. package/content/guides/ai-chat-family.md +24 -0
  194. package/content/guides/choose.md +67 -0
  195. package/content/guides/component-model.md +32 -0
  196. package/content/guides/component-standards.md +123 -0
  197. package/{docs/components.md → content/guides/components-guide.md} +31 -7
  198. package/{docs/custom-components.md → content/guides/custom-component.md} +70 -55
  199. package/{docs/data.md → content/guides/data-guide.md} +5 -2
  200. package/content/guides/file-preview-family.md +18 -0
  201. package/{docs → content/guides}/frontend.md +122 -52
  202. package/content/guides/layout-choice.md +64 -0
  203. package/{docs/layout.md → content/guides/layout-guide.md} +12 -8
  204. package/{docs/frontend-middleware.md → content/guides/middleware.md} +34 -3
  205. package/{docs/mobile.md → content/guides/mobile-guide.md} +20 -24
  206. package/content/guides/page-building.md +98 -0
  207. package/content/guides/production.md +37 -0
  208. package/content/guides/quality.md +60 -0
  209. package/{docs/realtime.md → content/guides/realtime-guide.md} +6 -3
  210. package/content/guides/render-only.md +44 -0
  211. package/{docs/saas.md → content/guides/saas-guide.md} +8 -5
  212. package/{docs/server.md → content/guides/server-guide.md} +5 -2
  213. package/content/guides/start.md +41 -0
  214. package/{docs → content/guides}/styling.md +5 -1
  215. package/{docs/frontend-ui-dom.md → content/guides/ui-dom-guide.md} +7 -1
  216. package/content/index.json +4344 -0
  217. package/content/index.md +181 -0
  218. package/content/layout/align.md +20 -0
  219. package/content/layout/anchor.md +19 -0
  220. package/content/layout/app-shell.md +23 -0
  221. package/content/layout/border.md +20 -0
  222. package/content/layout/center.md +19 -0
  223. package/content/layout/cluster.md +19 -0
  224. package/content/layout/container.md +19 -0
  225. package/content/layout/fill.md +19 -0
  226. package/content/layout/grid.md +19 -0
  227. package/content/layout/hidden.md +22 -0
  228. package/content/layout/layer.md +19 -0
  229. package/content/layout/position.md +22 -0
  230. package/content/layout/row.md +23 -0
  231. package/content/layout/safe-area.md +20 -0
  232. package/content/layout/scroll.md +21 -0
  233. package/content/layout/spacing.md +22 -0
  234. package/content/layout/split.md +19 -0
  235. package/content/layout/stack.md +19 -0
  236. package/content/layout/surface.md +23 -0
  237. package/content/layout/text.md +22 -0
  238. package/content/patterns/app-shell.md +34 -0
  239. package/content/patterns/dashboard.md +36 -0
  240. package/content/patterns/data-screen.md +30 -0
  241. package/content/patterns/detail-page.md +31 -0
  242. package/content/patterns/docs.md +34 -0
  243. package/content/patterns/focus-task.md +34 -0
  244. package/content/patterns/landing.md +35 -0
  245. package/content/patterns/list-page.md +32 -0
  246. package/content/patterns/mobile.md +31 -0
  247. package/content/patterns/settings-page.md +33 -0
  248. package/content/patterns/workspace.md +32 -0
  249. package/dist/cli/apps-typecheck.test.d.ts +11 -0
  250. package/dist/cli/docs.d.ts +2 -0
  251. package/dist/cli/docs.mjs +10961 -0
  252. package/dist/cli/home-flash.test.d.ts +1 -0
  253. package/dist/{components → client/components}/Accordion/Accordion.d.ts +1 -1
  254. package/dist/client/components/ActionSheet/ActionSheet.d.ts +37 -0
  255. package/dist/{components → client/components}/Affix/Affix.d.ts +1 -1
  256. package/dist/{components → client/components}/AiChat/AiChat.d.ts +3 -3
  257. package/dist/{components → client/components}/Alert/Alert.d.ts +1 -1
  258. package/dist/{components → client/components}/AlertGroup/AlertGroup.d.ts +1 -1
  259. package/dist/{components → client/components}/Anchor/Anchor.d.ts +1 -1
  260. package/dist/client/components/AppShell/AppShell.d.ts +55 -0
  261. package/dist/{components → client/components}/ApprovalCard/ApprovalCard.d.ts +2 -2
  262. package/dist/{components → client/components}/AspectRatio/AspectRatio.d.ts +1 -1
  263. package/dist/{components → client/components}/AuthPage/AuthPage.d.ts +2 -2
  264. package/dist/{components → client/components}/AutoComplete/AutoComplete.d.ts +1 -1
  265. package/dist/{components → client/components}/Avatar/Avatar.d.ts +1 -1
  266. package/dist/{components → client/components}/AvatarGroup/AvatarGroup.d.ts +1 -1
  267. package/dist/{components → client/components}/BackTop/BackTop.d.ts +1 -1
  268. package/dist/{components → client/components}/Badge/Badge.d.ts +1 -1
  269. package/dist/{components → client/components}/Breadcrumb/Breadcrumb.d.ts +1 -1
  270. package/dist/{components → client/components}/Button/Button.d.ts +1 -1
  271. package/dist/{components → client/components}/Calendar/Calendar.d.ts +1 -1
  272. package/dist/{components → client/components}/Card/Card.d.ts +1 -1
  273. package/dist/{components → client/components}/Carousel/Carousel.d.ts +1 -1
  274. package/dist/{components → client/components}/Cascader/Cascader.d.ts +1 -1
  275. package/dist/{components → client/components}/Chart/Chart.d.ts +1 -1
  276. package/dist/{components → client/components}/Chart/chart-utils.d.ts +5 -1
  277. package/dist/{components → client/components}/ChatInput/ChatInput.d.ts +7 -7
  278. package/dist/{components → client/components}/Checkbox/Checkbox.d.ts +1 -1
  279. package/dist/{components → client/components}/CheckboxGroup/CheckboxGroup.d.ts +1 -1
  280. package/dist/{components → client/components}/CitationCard/CitationCard.d.ts +3 -3
  281. package/dist/{components → client/components}/CodeBlock/CodeBlock.d.ts +1 -1
  282. package/dist/client/components/CodeEditor/CodeEditor.d.ts +18 -0
  283. package/dist/{components → client/components}/Collapse/Collapse.d.ts +1 -1
  284. package/dist/{components → client/components}/ColorPicker/ColorPicker.d.ts +1 -1
  285. package/dist/{components → client/components}/Command/Command.d.ts +1 -1
  286. package/dist/{components → client/components}/Confirm/Confirm.d.ts +2 -7
  287. package/dist/{components → client/components}/ContextMenu/ContextMenu.d.ts +1 -1
  288. package/dist/{components → client/components}/CopyButton/CopyButton.d.ts +1 -1
  289. package/dist/{components → client/components}/DatePicker/DatePicker.d.ts +2 -2
  290. package/dist/{components → client/components}/Descriptions/Descriptions.d.ts +1 -1
  291. package/dist/{components → client/components}/DiffView/DiffView.d.ts +1 -1
  292. package/dist/{components → client/components}/Divider/Divider.d.ts +1 -1
  293. package/dist/{components → client/components}/Drawer/Drawer.d.ts +1 -1
  294. package/dist/{components → client/components}/Dropdown/Dropdown.d.ts +1 -1
  295. package/dist/{components → client/components}/Editor/Editor.d.ts +1 -1
  296. package/dist/{components → client/components}/Editor/tools/toolbar.d.ts +1 -1
  297. package/dist/{components → client/components}/EmptyState/EmptyState.d.ts +1 -1
  298. package/dist/client/components/ExportCSV/ExportCSV.d.ts +30 -0
  299. package/dist/{components → client/components}/Field/Field.d.ts +1 -1
  300. package/dist/{components → client/components}/FilePreview/FilePreview.d.ts +1 -1
  301. package/dist/client/components/FileTree/FileTree.d.ts +57 -0
  302. package/dist/{components → client/components}/FileUpload/FileUpload.d.ts +1 -1
  303. package/dist/{components → client/components}/FloatButton/FloatButton.d.ts +1 -1
  304. package/dist/{components → client/components}/Form/Form.d.ts +1 -1
  305. package/dist/{components → client/components}/Grid/Grid.d.ts +1 -1
  306. package/dist/{components → client/components}/Highlight/Highlight.d.ts +1 -1
  307. package/dist/{components → client/components}/HoverCard/HoverCard.d.ts +5 -4
  308. package/dist/{components → client/components}/Icon/Icon.d.ts +2 -2
  309. package/dist/client/components/ImageCropper/ImageCropper.d.ts +17 -0
  310. package/dist/{components → client/components}/Img/Img.d.ts +1 -1
  311. package/dist/{components → client/components}/InView/InView.d.ts +1 -1
  312. package/dist/{components → client/components}/InfiniteScroll/InfiniteScroll.d.ts +1 -1
  313. package/dist/{components → client/components}/Input/Input.d.ts +1 -1
  314. package/dist/{components → client/components}/InputNumber/InputNumber.d.ts +1 -1
  315. package/dist/{components → client/components}/JSONViewer/JSONViewer.d.ts +1 -1
  316. package/dist/{components → client/components}/JsonSchemaForm/JsonSchemaForm.d.ts +3 -3
  317. package/dist/{components → client/components}/Kanban/Kanban.d.ts +1 -1
  318. package/dist/{components → client/components}/Label/Label.d.ts +1 -1
  319. package/dist/{components → client/components}/Layout/Layout.d.ts +1 -1
  320. package/dist/{components → client/components}/Link/Link.d.ts +1 -1
  321. package/dist/{components → client/components}/List/List.d.ts +1 -1
  322. package/dist/{components → client/components}/Loading/Loading.d.ts +1 -1
  323. package/dist/{components → client/components}/LogViewer/LogViewer.d.ts +1 -1
  324. package/dist/{components → client/components}/Markdown/Markdown.d.ts +1 -1
  325. package/dist/client/components/MarkdownEditor/MarkdownEditor.d.ts +18 -0
  326. package/dist/client/components/Math/Math.d.ts +15 -0
  327. package/dist/{components → client/components}/Mentions/Mentions.d.ts +1 -1
  328. package/dist/{components → client/components}/Menu/Menu.d.ts +1 -1
  329. package/dist/{components → client/components}/Menubar/Menubar.d.ts +1 -1
  330. package/dist/{components → client/components}/MessageBubble/MessageBubble.d.ts +1 -1
  331. package/dist/{components → client/components}/Modal/Modal.d.ts +1 -1
  332. package/dist/{components → client/components}/NavMenu/NavMenu.d.ts +2 -2
  333. package/dist/{components → client/components}/Notification/Notification.d.ts +7 -2
  334. package/dist/{components → client/components}/PageHeader/PageHeader.d.ts +1 -1
  335. package/dist/{components → client/components}/Pagination/Pagination.d.ts +1 -1
  336. package/dist/{components → client/components}/PasswordInput/PasswordInput.d.ts +1 -1
  337. package/dist/{components → client/components}/PinInput/PinInput.d.ts +1 -1
  338. package/dist/{components → client/components}/Pipeline/Pipeline.d.ts +1 -1
  339. package/dist/{components → client/components}/Popconfirm/Popconfirm.d.ts +2 -2
  340. package/dist/{components → client/components}/Popover/Popover.d.ts +5 -4
  341. package/dist/{components → client/components}/ProgressBar/ProgressBar.d.ts +1 -1
  342. package/dist/client/components/PromptTemplate/PromptTemplate.d.ts +37 -0
  343. package/dist/{components → client/components}/QRCode/QRCode.d.ts +1 -1
  344. package/dist/{components → client/components}/RadioGroup/RadioGroup.d.ts +1 -1
  345. package/dist/{components → client/components}/Rate/Rate.d.ts +1 -1
  346. package/dist/{components → client/components}/ReasoningBlock/ReasoningBlock.d.ts +3 -3
  347. package/dist/client/components/RelationGraph/RelationGraph.d.ts +59 -0
  348. package/dist/{components → client/components}/Resizable/Resizable.d.ts +1 -1
  349. package/dist/{components → client/components}/Result/Result.d.ts +1 -1
  350. package/dist/{components → client/components}/Scrollbar/Scrollbar.d.ts +1 -1
  351. package/dist/{components → client/components}/SearchInput/SearchInput.d.ts +1 -1
  352. package/dist/{components → client/components}/SegmentedControl/SegmentedControl.d.ts +1 -1
  353. package/dist/{components → client/components}/Select/Select.d.ts +1 -1
  354. package/dist/{components → client/components}/SessionList/SessionList.d.ts +3 -3
  355. package/dist/{components → client/components}/SheetGrid/SheetGrid.d.ts +1 -1
  356. package/dist/{components → client/components}/Skeleton/Skeleton.d.ts +1 -1
  357. package/dist/{components → client/components}/SlideCanvas/SlideCanvas.d.ts +1 -1
  358. package/dist/client/components/Slider/Slider.d.ts +27 -0
  359. package/dist/client/components/SortableList/SortableList.d.ts +23 -0
  360. package/dist/{components → client/components}/Space/Space.d.ts +1 -1
  361. package/dist/{components → client/components}/Sparkline/Sparkline.d.ts +1 -1
  362. package/dist/{components → client/components}/StatCard/StatCard.d.ts +1 -1
  363. package/dist/{components → client/components}/Steps/Steps.d.ts +1 -1
  364. package/dist/{components → client/components}/Switch/Switch.d.ts +1 -1
  365. package/dist/client/components/TabBar/TabBar.d.ts +35 -0
  366. package/dist/{components → client/components}/Table/Table.d.ts +7 -1
  367. package/dist/client/components/Tabs/Tabs.d.ts +22 -0
  368. package/dist/{components → client/components}/Tag/Tag.d.ts +1 -1
  369. package/dist/{components → client/components}/TagsInput/TagsInput.d.ts +1 -1
  370. package/dist/{components → client/components}/Textarea/Textarea.d.ts +1 -1
  371. package/dist/{components → client/components}/ThemeSwitch/ThemeSwitch.d.ts +1 -1
  372. package/dist/{components → client/components}/Timeline/Timeline.d.ts +1 -1
  373. package/dist/{components → client/components}/Toast/Toast.d.ts +1 -1
  374. package/dist/{components → client/components}/ToggleGroup/ToggleGroup.d.ts +1 -1
  375. package/dist/{components → client/components}/ToolCallCard/ToolCallCard.d.ts +2 -2
  376. package/dist/{components → client/components}/Tooltip/Tooltip.d.ts +4 -3
  377. package/dist/{components → client/components}/Tour/Tour.d.ts +1 -1
  378. package/dist/{components → client/components}/Transfer/Transfer.d.ts +1 -1
  379. package/dist/{components → client/components}/Tree/Tree.d.ts +5 -1
  380. package/dist/{components → client/components}/TreeSelect/TreeSelect.d.ts +5 -1
  381. package/dist/{components → client/components}/Typography/Typography.d.ts +1 -1
  382. package/dist/client/components/VideoPlayer/VideoPlayer.d.ts +25 -0
  383. package/dist/{components → client/components}/VirtualList/VirtualList.d.ts +1 -1
  384. package/dist/{components → client/components}/VirtualTable/VirtualTable.d.ts +1 -1
  385. package/dist/{components → client/components}/Watermark/Watermark.d.ts +1 -1
  386. package/dist/client/components/Wave/Wave.d.ts +15 -0
  387. package/dist/{components → client/components}/index.d.ts +44 -5
  388. package/dist/client/components/index.js +57 -0
  389. package/dist/{components → client/components}/style.css +1081 -98
  390. package/dist/{layout → client/layout}/weifuwu-layout.css +60 -6
  391. package/dist/{office → client/office}/xml-serialize.d.ts +1 -1
  392. package/dist/client/vdom/browser/Browser.d.ts +73 -0
  393. package/dist/client/vdom/browser/create-client-browser.d.ts +11 -0
  394. package/dist/client/vdom/commands.d.ts +19 -0
  395. package/dist/client/vdom/context/UIContext.d.ts +61 -0
  396. package/dist/client/vdom/context/data.d.ts +17 -0
  397. package/dist/client/vdom/core/async-guard.d.ts +20 -0
  398. package/dist/client/vdom/core/build.d.ts +36 -0
  399. package/dist/client/vdom/core/command/create.d.ts +25 -0
  400. package/dist/client/vdom/core/command/index.d.ts +15 -0
  401. package/dist/client/vdom/core/command/insert.d.ts +32 -0
  402. package/dist/client/vdom/core/command/lifecycle.d.ts +47 -0
  403. package/dist/client/vdom/core/command/props.d.ts +22 -0
  404. package/dist/client/vdom/core/diff/attrs.d.ts +10 -0
  405. package/dist/client/vdom/core/diff/children.d.ts +29 -0
  406. package/dist/client/vdom/core/diff/cleanup.d.ts +44 -0
  407. package/dist/client/vdom/core/diff/index.d.ts +22 -0
  408. package/dist/client/vdom/core/diff/output.d.ts +30 -0
  409. package/dist/client/vdom/core/diff/same.d.ts +22 -0
  410. package/dist/client/vdom/core/field/attributes.d.ts +15 -0
  411. package/dist/client/vdom/core/field/events.d.ts +54 -0
  412. package/dist/client/vdom/core/field/index.d.ts +19 -0
  413. package/dist/client/vdom/core/field/key.d.ts +16 -0
  414. package/dist/client/vdom/core/field/props.d.ts +15 -0
  415. package/dist/client/vdom/core/field/ref.d.ts +38 -0
  416. package/dist/client/vdom/core/field/style.d.ts +17 -0
  417. package/dist/client/vdom/core/node/children.d.ts +20 -0
  418. package/dist/client/vdom/core/node/component.d.ts +93 -0
  419. package/dist/client/vdom/core/node/fragment.d.ts +14 -0
  420. package/dist/client/vdom/core/node/hole.d.ts +22 -0
  421. package/dist/client/vdom/core/node/index.d.ts +35 -0
  422. package/dist/client/vdom/core/node/keyed.d.ts +64 -0
  423. package/dist/client/vdom/core/node/native.d.ts +20 -0
  424. package/dist/client/vdom/core/node/portal.d.ts +11 -0
  425. package/dist/client/vdom/core/patch/fields.d.ts +15 -0
  426. package/dist/client/vdom/core/patch/index.d.ts +51 -0
  427. package/dist/client/vdom/core/patch/processors.d.ts +75 -0
  428. package/dist/client/vdom/core/patch/state-machine.d.ts +38 -0
  429. package/dist/client/vdom/core/patch/verify.d.ts +17 -0
  430. package/dist/client/vdom/core/router.d.ts +31 -0
  431. package/dist/client/vdom/core/serve.d.ts +75 -0
  432. package/dist/client/vdom/core/ssr/absorb.d.ts +53 -0
  433. package/dist/client/vdom/core/ssr/html.d.ts +32 -0
  434. package/dist/client/vdom/core/ssr/index.d.ts +25 -0
  435. package/dist/client/vdom/core/transform/component.d.ts +23 -0
  436. package/dist/client/vdom/core/transform/element.d.ts +21 -0
  437. package/dist/client/vdom/core/transform/fragment.d.ts +21 -0
  438. package/dist/client/vdom/core/transform/hole.d.ts +13 -0
  439. package/dist/client/vdom/core/transform/index.d.ts +46 -0
  440. package/dist/client/vdom/core/transform/states.d.ts +22 -0
  441. package/dist/client/vdom/core/transform/table.d.ts +28 -0
  442. package/dist/client/vdom/core/transform/text.d.ts +10 -0
  443. package/dist/client/vdom/core/vnode.d.ts +45 -0
  444. package/dist/client/vdom/dev/effect-guard.d.ts +8 -0
  445. package/dist/client/vdom/hooks/ai-stream.d.ts +46 -0
  446. package/dist/client/vdom/hooks/basic.d.ts +42 -0
  447. package/dist/client/vdom/hooks/chat.d.ts +91 -0
  448. package/dist/client/vdom/hooks/controlled.d.ts +27 -0
  449. package/dist/client/vdom/hooks/drag-media.d.ts +52 -0
  450. package/dist/client/vdom/hooks/env.d.ts +119 -0
  451. package/dist/client/vdom/hooks/input.d.ts +43 -0
  452. package/dist/client/vdom/hooks/observe.d.ts +60 -0
  453. package/dist/client/vdom/hooks/popup-manager.d.ts +92 -0
  454. package/dist/client/vdom/hooks/popup.d.ts +52 -0
  455. package/dist/client/vdom/hooks/stable.d.ts +45 -0
  456. package/dist/client/vdom/index.d.ts +67 -0
  457. package/dist/client/vdom/index.js +8 -0
  458. package/dist/client/vdom/jsx-runtime.d.ts +28 -0
  459. package/dist/client/vdom/jsx-runtime.js +1 -0
  460. package/dist/client/vdom/middlewares/api.d.ts +38 -0
  461. package/dist/client/vdom/middlewares/auth-i18n.d.ts +66 -0
  462. package/dist/client/vdom/middlewares/ws.d.ts +37 -0
  463. package/dist/client/vdom/store.d.ts +49 -0
  464. package/dist/client/vdom/testing.d.ts +46 -0
  465. package/dist/client/vdom/testing.js +2 -0
  466. package/dist/dev/index.d.ts +12 -0
  467. package/dist/dev/index.js +4 -4
  468. package/dist/{ai → server/ai}/contracts.d.ts +1 -1
  469. package/dist/{ai → server/ai}/index.d.ts +2 -2
  470. package/dist/{ai → server/ai}/types.d.ts +1 -1
  471. package/dist/{core → server/core}/router.d.ts +2 -4
  472. package/dist/{db → server/db}/contracts.d.ts +1 -1
  473. package/dist/server/db/postgres-server.d.ts +37 -0
  474. package/dist/server/db/redis-server.d.ts +32 -0
  475. package/dist/server/db/server.d.ts +30 -0
  476. package/dist/server/db/test-servers.d.ts +21 -0
  477. package/dist/{email → server/email}/contracts.d.ts +1 -1
  478. package/dist/{index.js → server/index.js} +3145 -2487
  479. package/dist/{ui → server/ui}/index.d.ts +2 -2
  480. package/dist/{user → server/user}/token.d.ts +1 -1
  481. package/dist/shared/router/trie.d.ts +61 -0
  482. package/docs/components-map.md +5 -5
  483. package/docs/style-guide.md +14 -2
  484. package/examples/apps/admin/README.md +23 -0
  485. package/examples/apps/admin/api.ts +27 -0
  486. package/examples/apps/admin/app.tsx +144 -0
  487. package/examples/apps/admin/main.tsx +8 -0
  488. package/examples/apps/admin/server.ts +37 -0
  489. package/examples/apps/auth/README.md +23 -0
  490. package/examples/apps/auth/api.ts +49 -0
  491. package/examples/apps/auth/app.tsx +137 -0
  492. package/examples/apps/auth/main.tsx +8 -0
  493. package/examples/apps/auth/server.ts +37 -0
  494. package/examples/apps/multi/README.md +23 -0
  495. package/examples/apps/multi/app.tsx +83 -0
  496. package/examples/apps/multi/main.tsx +8 -0
  497. package/examples/apps/multi/server.ts +33 -0
  498. package/examples/apps/todo/README.md +23 -0
  499. package/examples/apps/todo/api.ts +26 -0
  500. package/examples/apps/todo/app.tsx +128 -0
  501. package/examples/apps/todo/main.tsx +9 -0
  502. package/examples/apps/todo/server.ts +39 -0
  503. package/examples/hello-world/README.md +9 -0
  504. package/examples/hello-world/client.ts +14 -0
  505. package/examples/hello-world/routes.tsx +26 -0
  506. package/examples/hello-world/server.ts +46 -0
  507. package/examples/patterns/AppShell.tsx +224 -0
  508. package/examples/patterns/Dashboard.tsx +153 -0
  509. package/examples/patterns/DataScreen.tsx +104 -0
  510. package/examples/patterns/DetailPage.tsx +79 -0
  511. package/examples/patterns/Docs.tsx +105 -0
  512. package/examples/patterns/FocusTask.tsx +67 -0
  513. package/examples/patterns/Landing.tsx +90 -0
  514. package/examples/patterns/ListPage.tsx +77 -0
  515. package/examples/patterns/Mobile.tsx +154 -0
  516. package/examples/patterns/SettingsPage.tsx +98 -0
  517. package/examples/patterns/SplitWorkspace.tsx +113 -0
  518. package/package.json +61 -29
  519. package/dist/components/Slider/Slider.d.ts +0 -19
  520. package/dist/components/Tabs/Tabs.d.ts +0 -12
  521. package/dist/components/index.js +0 -55
  522. package/dist/ui-dom/Confirm.d.ts +0 -8
  523. package/dist/ui-dom/Notification.d.ts +0 -8
  524. package/dist/ui-dom/Toast.d.ts +0 -8
  525. package/dist/ui-dom/ai.d.ts +0 -59
  526. package/dist/ui-dom/browser.d.ts +0 -10
  527. package/dist/ui-dom/debug.d.ts +0 -21
  528. package/dist/ui-dom/hooks/chat.d.ts +0 -11
  529. package/dist/ui-dom/hooks/events.d.ts +0 -30
  530. package/dist/ui-dom/hooks/external.d.ts +0 -20
  531. package/dist/ui-dom/hooks/index.d.ts +0 -29
  532. package/dist/ui-dom/hooks/input.d.ts +0 -33
  533. package/dist/ui-dom/hooks/media.d.ts +0 -17
  534. package/dist/ui-dom/hooks/popup.d.ts +0 -30
  535. package/dist/ui-dom/hooks/stable.d.ts +0 -35
  536. package/dist/ui-dom/hooks/types.d.ts +0 -77
  537. package/dist/ui-dom/i18n.d.ts +0 -31
  538. package/dist/ui-dom/index.d.ts +0 -47
  539. package/dist/ui-dom/index.js +0 -41
  540. package/dist/ui-dom/jsx-runtime.d.ts +0 -4
  541. package/dist/ui-dom/jsx-runtime.js +0 -1
  542. package/dist/ui-dom/locale/en_US.d.ts +0 -69
  543. package/dist/ui-dom/locale/zh_CN.d.ts +0 -69
  544. package/dist/ui-dom/middleware/api.d.ts +0 -91
  545. package/dist/ui-dom/middleware/auth.d.ts +0 -30
  546. package/dist/ui-dom/middleware/ws.d.ts +0 -33
  547. package/dist/ui-dom/motion.d.ts +0 -8
  548. package/dist/ui-dom/popup-tracker.d.ts +0 -36
  549. package/dist/ui-dom/popup.d.ts +0 -42
  550. package/dist/ui-dom/store.d.ts +0 -24
  551. package/dist/ui-dom/testing.d.ts +0 -68
  552. package/dist/ui-dom/testing.js +0 -7
  553. package/dist/ui-dom/types.d.ts +0 -634
  554. package/dist/ui-dom/use-chat.d.ts +0 -95
  555. package/dist/ui-dom/vdom3/README.d.ts +0 -32
  556. package/dist/ui-dom/vdom3/app.d.ts +0 -20
  557. package/dist/ui-dom/vdom3/audit.d.ts +0 -29
  558. package/dist/ui-dom/vdom3/build.d.ts +0 -20
  559. package/dist/ui-dom/vdom3/commands.d.ts +0 -21
  560. package/dist/ui-dom/vdom3/comp-index.d.ts +0 -18
  561. package/dist/ui-dom/vdom3/delegate.d.ts +0 -53
  562. package/dist/ui-dom/vdom3/events.d.ts +0 -17
  563. package/dist/ui-dom/vdom3/index.d.ts +0 -42
  564. package/dist/ui-dom/vdom3/jsx.d.ts +0 -32
  565. package/dist/ui-dom/vdom3/record.d.ts +0 -16
  566. package/dist/ui-dom/vdom3/registry.d.ts +0 -30
  567. package/dist/ui-dom/vdom3/render.d.ts +0 -39
  568. package/dist/ui-dom/vdom3/replay.d.ts +0 -28
  569. package/dist/ui-dom/vdom3/root.d.ts +0 -24
  570. package/dist/ui-dom/vdom3/router.d.ts +0 -31
  571. package/dist/ui-dom/vdom3/scheduler.d.ts +0 -23
  572. package/dist/ui-dom/vdom3/ssr.d.ts +0 -27
  573. package/dist/ui-dom/vdom3/sync.d.ts +0 -22
  574. package/dist/ui-dom/vdom3/types.d.ts +0 -173
  575. package/dist/ui-dom/vdom3/ui.d.ts +0 -16
  576. package/dist/ui-dom/vdom3.js +0 -41
  577. package/dist/ui-dom/vnode.d.ts +0 -13
  578. /package/dist/{make-executable-schema.test.d.ts → cli/content-sync.test.d.ts} +0 -0
  579. /package/dist/{ui-dom/testing.test.d.ts → cli/docs-cli.test.d.ts} +0 -0
  580. /package/dist/{components → client/components}/CodeBlock/highlight.d.ts +0 -0
  581. /package/dist/{components → client/components}/DatePicker/calendar-utils.d.ts +0 -0
  582. /package/dist/{components → client/components}/DiffView/diff-utils.d.ts +0 -0
  583. /package/dist/{components → client/components}/Editor/edit-events.d.ts +0 -0
  584. /package/dist/{components → client/components}/Editor/model/apply.d.ts +0 -0
  585. /package/dist/{components → client/components}/Editor/model/diff.d.ts +0 -0
  586. /package/dist/{components → client/components}/Editor/model/dom.d.ts +0 -0
  587. /package/dist/{components → client/components}/Editor/model/history.d.ts +0 -0
  588. /package/dist/{components → client/components}/Editor/model/html.d.ts +0 -0
  589. /package/dist/{components → client/components}/Editor/model/inverse.d.ts +0 -0
  590. /package/dist/{components → client/components}/Editor/model/types.d.ts +0 -0
  591. /package/dist/{components → client/components}/Editor/tools/table.d.ts +0 -0
  592. /package/dist/{components → client/components}/Editor/tools/types.d.ts +0 -0
  593. /package/dist/{components → client/components}/FilePreview/markdown.d.ts +0 -0
  594. /package/dist/{components → client/components}/Markdown/parser.d.ts +0 -0
  595. /package/dist/{components → client/components}/OfficeEditor/ai/ai-bridge.d.ts +0 -0
  596. /package/dist/{components → client/components}/OfficeEditor/model/apply.d.ts +0 -0
  597. /package/dist/{components → client/components}/OfficeEditor/model/types.d.ts +0 -0
  598. /package/dist/{components → client/components}/Pipeline/dag-utils.d.ts +0 -0
  599. /package/dist/{components → client/components}/QRCode/qr.d.ts +0 -0
  600. /package/dist/{components → client/components}/Sparkline/sparkline-utils.d.ts +0 -0
  601. /package/dist/{office → client/office}/docx.d.ts +0 -0
  602. /package/dist/{office → client/office}/pptx.d.ts +0 -0
  603. /package/dist/{office → client/office}/xlsx.d.ts +0 -0
  604. /package/dist/{office → client/office}/xml.d.ts +0 -0
  605. /package/dist/{office → client/office}/zip.d.ts +0 -0
  606. /package/dist/{ai → server/ai}/agent.d.ts +0 -0
  607. /package/dist/{ai → server/ai}/client.d.ts +0 -0
  608. /package/dist/{ai → server/ai}/sse.d.ts +0 -0
  609. /package/dist/{core → server/core}/serve.d.ts +0 -0
  610. /package/dist/{core → server/core}/ws.d.ts +0 -0
  611. /package/dist/{db → server/db}/errors.d.ts +0 -0
  612. /package/dist/{db → server/db}/memory-redis.d.ts +0 -0
  613. /package/dist/{db → server/db}/memory-sql.d.ts +0 -0
  614. /package/dist/{db → server/db}/postgres/connection.d.ts +0 -0
  615. /package/dist/{db → server/db}/postgres/pool.d.ts +0 -0
  616. /package/dist/{db → server/db}/postgres/protocol.d.ts +0 -0
  617. /package/dist/{db → server/db}/postgres/schema.d.ts +0 -0
  618. /package/dist/{db → server/db}/query-builder.d.ts +0 -0
  619. /package/dist/{db → server/db}/query.d.ts +0 -0
  620. /package/dist/{db → server/db}/redis/client.d.ts +0 -0
  621. /package/dist/{db → server/db}/redis/commands.d.ts +0 -0
  622. /package/dist/{db → server/db}/redis/connection.d.ts +0 -0
  623. /package/dist/{db → server/db}/redis/pipeline.d.ts +0 -0
  624. /package/dist/{db → server/db}/redis/pool.d.ts +0 -0
  625. /package/dist/{db → server/db}/redis/resp.d.ts +0 -0
  626. /package/dist/{db → server/db}/redis/subscriber.d.ts +0 -0
  627. /package/dist/{db → server/db}/sql-parser.d.ts +0 -0
  628. /package/dist/{email → server/email}/index.d.ts +0 -0
  629. /package/dist/{email → server/email}/smtp.d.ts +0 -0
  630. /package/dist/{graphql.d.ts → server/graphql.d.ts} +0 -0
  631. /package/dist/{index.d.ts → server/index.d.ts} +0 -0
  632. /package/dist/{make-executable-schema.d.ts → server/make-executable-schema.d.ts} +0 -0
  633. /package/dist/{messager → server/messager}/index.d.ts +0 -0
  634. /package/dist/{middleware → server/middleware}/cors.d.ts +0 -0
  635. /package/dist/{middleware → server/middleware}/rate-limit.d.ts +0 -0
  636. /package/dist/{middleware → server/middleware}/static.d.ts +0 -0
  637. /package/dist/{postgres → server/postgres}/client.d.ts +0 -0
  638. /package/dist/{postgres → server/postgres}/index.d.ts +0 -0
  639. /package/dist/{postgres → server/postgres}/types.d.ts +0 -0
  640. /package/dist/{queue → server/queue}/index.d.ts +0 -0
  641. /package/dist/{redis → server/redis}/client.d.ts +0 -0
  642. /package/dist/{redis → server/redis}/index.d.ts +0 -0
  643. /package/dist/{redis → server/redis}/types.d.ts +0 -0
  644. /package/dist/{request.d.ts → server/request.d.ts} +0 -0
  645. /package/dist/{response.d.ts → server/response.d.ts} +0 -0
  646. /package/dist/{scheduler → server/scheduler}/cron.d.ts +0 -0
  647. /package/dist/{scheduler → server/scheduler}/index.d.ts +0 -0
  648. /package/dist/{types.d.ts → server/types.d.ts} +0 -0
  649. /package/dist/{ui → server/ui}/html-safe.d.ts +0 -0
  650. /package/dist/{user → server/user}/index.d.ts +0 -0
  651. /package/dist/{user → server/user}/password.d.ts +0 -0
@@ -0,0 +1,45 @@
1
+ # AlertGroup · components
2
+
3
+ ## 概述
4
+
5
+ 通知合并组:≥3 条折叠为 +N,点击展开
6
+
7
+ ## 典型场景
8
+
9
+ - 操作反馈/结果页/确认——保存成功、删除确认、空态/加载态
10
+
11
+ ## API
12
+
13
+ | prop | 类型 | 必填 | 说明 |
14
+ |------|------|------|------|
15
+ | `items` | `AlertGroupItem[]` | 是 | |
16
+ | `onClose` | `(id: string) => void` | 否 | |
17
+
18
+ ## 用法示例
19
+
20
+ ```tsx
21
+ <AlertGroup items={alerts} />
22
+ ```
23
+
24
+ ## 纪律/坑
25
+
26
+ > 退场动画(§8):exit 类必须挂载(animationend 驱动)+ reduced-motion 降级
27
+
28
+ ## 关系
29
+
30
+ - ↑ 用于页面模式:(暂无)
31
+ - ↑ 用于应用:(暂无)
32
+ - → 后端能力:(暂无)
33
+
34
+ ## 文件位置
35
+
36
+ | 文件 | 路径 |
37
+ |------|------|
38
+ | 源码 | `src/client/components/AlertGroup/AlertGroup.ts` |
39
+ | 样式 | `src/client/components/AlertGroup/AlertGroup.css` |
40
+ | 测试 | `src/client/components/AlertGroup/AlertGroup.test.ts` |
41
+ | demo | `apps/showcase/src/demos/DemoAlertGroup.tsx`(P1 拆分) |
42
+
43
+ ## 验证
44
+
45
+ > agent-browser 走查:打开 `/components/feedback/alertgroup` ——(P1 填充具体步骤)
@@ -0,0 +1,52 @@
1
+ # Anchor · components
2
+
3
+ ## 概述
4
+
5
+ 锚点导航:滚动高亮跟随 + 点击平滑滚动
6
+
7
+ ## 典型场景
8
+
9
+ - 页面模式:docs(复制即用蓝本——examples/patterns/)
10
+ - 页面导航——侧栏、页头、标签页、步骤、分页
11
+
12
+ ## API
13
+
14
+ | prop | 类型 | 必填 | 说明 |
15
+ |------|------|------|------|
16
+ | `items` | `AnchorItem[]` | 是 | |
17
+ | `activeKey` | `string` | 否 | 当前激活锚点(受控可选;省略时滚动自动跟随) |
18
+ | `onAnchorChange` | `(href: string) => void` | 否 | 激活锚点变化回调(受控或观察) |
19
+ | `useHash` | `boolean` | 否 | 点击是否更新 location.hash(默认 false——回调 + 滚动) |
20
+ | `container` | `() => HTMLElement \| Window` | 否 | 滚动容器(默认 window) |
21
+ | `offsetTop` | `number` | 否 | 高亮阈值:锚点进入视口该偏移内视为激活(px),默认 80 |
22
+ | `className` | `string` | 否 | |
23
+
24
+ ## 用法示例
25
+
26
+ ```tsx
27
+ <Anchor items={[{ href: '#intro', title: '简介' }, ...]}
28
+ activeKey={active} onAnchorChange={setActive} />
29
+ ```
30
+
31
+ ## 纪律/坑
32
+
33
+ > 键盘可达(P1):方向键导航焦点跟随(roving tabindex);受控 props 配回调
34
+
35
+ ## 关系
36
+
37
+ - ↑ 用于页面模式:[docs](../patterns/docs.md)
38
+ - ↑ 用于应用:(暂无)
39
+ - → 后端能力:(暂无)
40
+
41
+ ## 文件位置
42
+
43
+ | 文件 | 路径 |
44
+ |------|------|
45
+ | 源码 | `src/client/components/Anchor/Anchor.ts` |
46
+ | 样式 | `src/client/components/Anchor/Anchor.css` |
47
+ | 测试 | `src/client/components/Anchor/Anchor.test.ts` |
48
+ | demo | `apps/showcase/src/demos/DemoAnchor.tsx`(P1 拆分) |
49
+
50
+ ## 验证
51
+
52
+ > agent-browser 走查:打开 `/components/navigation/anchor` ——(P1 填充具体步骤)
@@ -0,0 +1,37 @@
1
+ # 多应用(app 节点) · components
2
+
3
+ ## 概述
4
+
5
+ 父应用嵌入子应用:注册表 + 独立状态 + app:* 边界事件(appId 可区分——同流全链路)
6
+
7
+ ## 典型场景
8
+
9
+ - AI 对话/工具调用/审批/提示词——agent 场景全链路
10
+
11
+ ## API
12
+
13
+ > props 提取降级(接口格式特殊)——见源码:`—`
14
+
15
+ ## 用法示例
16
+
17
+ > (P1 迁移 CODE 字符串)
18
+
19
+ ## 纪律/坑
20
+
21
+ > AI 协议纪律:消息流事件驱动(useChat 订阅)——高频 notify 由写者控制频率
22
+
23
+ ## 关系
24
+
25
+ - ↑ 用于页面模式:(暂无)
26
+ - ↑ 用于应用:(暂无)
27
+ - → 后端能力:(暂无)
28
+
29
+ ## 文件位置
30
+
31
+ | 文件 | 路径 |
32
+ |------|------|
33
+ | demo | `apps/showcase/src/demos/DemoApp.tsx`(P1 拆分) |
34
+
35
+ ## 验证
36
+
37
+ > agent-browser 走查:打开 `/components/ai/app` ——(P1 填充具体步骤)
@@ -0,0 +1,56 @@
1
+ # ApprovalCard · components
2
+
3
+ ## 概述
4
+
5
+ HITL 审批卡片:pending 可批/拒 + 修改参数(JsonSchemaForm)· approved/rejected/timeout 终态
6
+
7
+ ## 典型场景
8
+
9
+ - AI 对话/工具调用/审批/提示词——agent 场景全链路
10
+
11
+ ## API
12
+
13
+ | prop | 类型 | 必填 | 说明 |
14
+ |------|------|------|------|
15
+ | `request` | `WfApprovalRequest` | 是 | wf:approval_request 数据 |
16
+ | `status` | `ApprovalStatus` | 否 | 卡片状态(默认 pending) |
17
+ | `onApprove` | `(modifiedArgs?: Record<string, unknown>) => void` | 否 | 用户点"允许"(modified 决策时带修改后参数——父层据此选 decision) |
18
+ | `onReject` | `(note?: string) => void` | 否 | 用户点"拒绝",note 为可选备注(进 agent 上下文) |
19
+ | `renderDetail` | `(request: WfApprovalRequest) => any` | 否 | 自定义详情渲染(默认显示 name + args) |
20
+ | `loading` | `boolean` | 否 | 提交中(按钮禁用 + 文案反馈,防连点) |
21
+ | `argsSchema` | `JsonSchema` | 否 | 工具参数 schema——提供时渲染「修改参数」入口(JsonSchemaForm,预填 request.args),提交带修改后参数 |
22
+
23
+ ## 用法示例
24
+
25
+ ```tsx
26
+ <ApprovalCard request={{ id, toolCallId, name, args }}
27
+ argsSchema={toolSchema} // 提供 → 「修改参数」入口(JsonSchemaForm)
28
+ onApprove={(modifiedArgs) =>
29
+ chat.approve(modifiedArgs ? 'modified' : 'approved', undefined, modifiedArgs)}
30
+ onReject={(note) => chat.approve('rejected', note)} />
31
+
32
+ // 终态:<ApprovalCard request={...} status="approved" />
33
+ ```
34
+
35
+ ## 纪律/坑
36
+
37
+ > AI 协议纪律:消息流事件驱动(useChat 订阅)——高频 notify 由写者控制频率
38
+
39
+ ## 关系
40
+
41
+ - ↑ 用于页面模式:(暂无)
42
+ - ↑ 用于应用:(暂无)
43
+ - → 后端能力:[ai](../backend/ai.md)
44
+
45
+ ## 文件位置
46
+
47
+ | 文件 | 路径 |
48
+ |------|------|
49
+ | 源码 | `src/client/components/ApprovalCard/ApprovalCard.ts` |
50
+ | 样式 | `src/client/components/ApprovalCard/ApprovalCard.css` |
51
+ | 测试 | `src/client/components/ApprovalCard/ApprovalCard.test.ts` |
52
+ | demo | `apps/showcase/src/demos/DemoApprovalCard.tsx`(P1 拆分) |
53
+
54
+ ## 验证
55
+
56
+ > agent-browser 走查:打开 `/components/ai/approvalcard` ——(P1 填充具体步骤)
@@ -0,0 +1,50 @@
1
+ # AppShell · components
2
+
3
+ ## 概述
4
+
5
+ 应用壳——品牌 + 分组导航 + 用户区 + 主内容(受控——父层驱动)
6
+
7
+ ## 典型场景
8
+
9
+ - 页面导航——侧栏、页头、标签页、步骤、分页
10
+
11
+ ## API
12
+
13
+ | prop | 类型 | 必填 | 说明 |
14
+ |------|------|------|------|
15
+ | `nav` | `AppShellNavItem[]` | 否 | 导航菜单项(Menu items——key/label/icon/group) |
16
+ | `path` | `string` | 否 | 当前路由路径(activeKey 匹配——'/' 精确,其余前缀) |
17
+ | `onNavigate` | `(key: string) => void` | 否 | 导航回调(菜单选择 → 父层 navigate) |
18
+ | `onLogout` | `() => void` | 否 | |
19
+ | `onSettings` | `() => void` | 否 | |
20
+ | `loading` | `boolean` | 否 | 守卫加载态(骨架占位——不渲染菜单/用户) |
21
+ | `children` | `any` | 否 | 主内容区 |
22
+ | `footer` | `any` | 否 | 自定义底部(覆盖用户区——高级场景) |
23
+ | `sidebarWidth` | `string` | 否 | 侧栏宽度(layout 变量——默认 240px) |
24
+
25
+ ## 用法示例
26
+
27
+ > (P1 迁移 CODE 字符串)
28
+
29
+ ## 纪律/坑
30
+
31
+ > 键盘可达(P1):方向键导航焦点跟随(roving tabindex);受控 props 配回调
32
+
33
+ ## 关系
34
+
35
+ - ↑ 用于页面模式:(暂无)
36
+ - ↑ 用于应用:(暂无)
37
+ - → 后端能力:(暂无)
38
+
39
+ ## 文件位置
40
+
41
+ | 文件 | 路径 |
42
+ |------|------|
43
+ | 源码 | `src/client/components/AppShell/AppShell.ts` |
44
+ | 样式 | `src/client/components/AppShell/AppShell.css` |
45
+ | 测试 | `src/client/components/AppShell/AppShell.test.ts` |
46
+ | demo | `apps/showcase/src/demos/DemoAppShell.tsx`(P1 拆分) |
47
+
48
+ ## 验证
49
+
50
+ > agent-browser 走查:打开 `/components/navigation/appshell` ——(P1 填充具体步骤)
@@ -0,0 +1,47 @@
1
+ # AspectRatio · components
2
+
3
+ ## 概述
4
+
5
+ 独立标签(required 星号)+ 宽高比容器(内容填满)
6
+
7
+ ## 典型场景
8
+
9
+ - 基础元素(按钮/图标/文本/卡片/标签)——任意页面的构成单元
10
+
11
+ ## API
12
+
13
+ | prop | 类型 | 必填 | 说明 |
14
+ |------|------|------|------|
15
+ | `ratio` | `number` | 否 | 宽/高比,默认 16/9 |
16
+ | `children` | `any` | 否 | |
17
+ | `className` | `string` | 否 | |
18
+
19
+ ## 用法示例
20
+
21
+ ```tsx
22
+ <Label htmlFor="name">用户名</Label>
23
+ <Label required>必填</Label>
24
+ ```
25
+
26
+ ## 纪律/坑
27
+
28
+ > 浏览器纪律(§5.5):组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
29
+
30
+ ## 关系
31
+
32
+ - ↑ 用于页面模式:(暂无)
33
+ - ↑ 用于应用:(暂无)
34
+ - → 后端能力:(暂无)
35
+
36
+ ## 文件位置
37
+
38
+ | 文件 | 路径 |
39
+ |------|------|
40
+ | 源码 | `src/client/components/AspectRatio/AspectRatio.ts` |
41
+ | 样式 | `src/client/components/AspectRatio/AspectRatio.css` |
42
+ | 测试 | `src/client/components/AspectRatio/AspectRatio.test.ts` |
43
+ | demo | `apps/showcase/src/demos/DemoAspectRatio.tsx`(P1 拆分) |
44
+
45
+ ## 验证
46
+
47
+ > agent-browser 走查:打开 `/components/core/aspectratio` ——(P1 填充具体步骤)
@@ -0,0 +1,61 @@
1
+ # AuthPage · components
2
+
3
+ ## 概述
4
+
5
+ 认证页骨架:居中卡片 + logo + 表单插槽 + 错误条 + 提交 loading(登录/注册复用)
6
+
7
+ ## 典型场景
8
+
9
+ - 应用模板:agent-platform(examples/apps/ 完整可跑)
10
+ - AI 对话/工具调用/审批/提示词——agent 场景全链路
11
+
12
+ ## API
13
+
14
+ | prop | 类型 | 必填 | 说明 |
15
+ |------|------|------|------|
16
+ | `title` | `string` | 是 | 标题(如「登录」) |
17
+ | `subtitle` | `string` | 否 | 副标题(如「多租户 AI 平台」) |
18
+ | `logo` | `VNode \| null` | 否 | logo / 头像位(VNode——Avatar 或图片) |
19
+ | `children` | `any` | 否 | 表单字段插槽 |
20
+ | `footer` | `VNode \| null` | 否 | 底部链接位(登录↔注册切换) |
21
+ | `submitLabel` | `string` | 是 | 提交按钮文案 |
22
+ | `loading` | `boolean` | 否 | 提交中——按钮 loading + 禁用 |
23
+ | `error` | `string \| null` | 否 | 错误文案(Alert 错误条渲染) |
24
+ | `onSubmit` | `() => void` | 否 | 表单提交回调(preventDefault 已处理) |
25
+
26
+ ## 用法示例
27
+
28
+ ```tsx
29
+ <AuthPage title="登录" subtitle="多租户 AI 平台" logo={<Avatar />}
30
+ submitLabel="登 录" loading={loading} error={error}
31
+ onSubmit={submit} // 表单提交回调(preventDefault 已处理)
32
+ footer={<span>没有账号?<a>注册</a></span>}>
33
+ <Field label="邮箱"><Input type="email" /></Field>
34
+ <Field label="密码"><PasswordInput /></Field>
35
+ </AuthPage>
36
+
37
+ // 纯骨架:字段(children)与提交逻辑(onSubmit)由消费方提供
38
+ // 认证流程(token/跳转)不进组件——框架 ctx.auth 可组合
39
+ ```
40
+
41
+ ## 纪律/坑
42
+
43
+ > AI 协议纪律:消息流事件驱动(useChat 订阅)——高频 notify 由写者控制频率
44
+
45
+ ## 关系
46
+
47
+ - ↑ 用于页面模式:(暂无)
48
+ - ↑ 用于应用:[agent-platform](../apps/agent-platform.md)
49
+ - → 后端能力:[auth](../backend/auth.md)
50
+
51
+ ## 文件位置
52
+
53
+ | 文件 | 路径 |
54
+ |------|------|
55
+ | 源码 | `src/client/components/AuthPage/AuthPage.ts` |
56
+ | 测试 | `src/client/components/AuthPage/AuthPage.test.ts` |
57
+ | demo | `apps/showcase/src/demos/DemoAuthPage.tsx`(P1 拆分) |
58
+
59
+ ## 验证
60
+
61
+ > agent-browser 走查:打开 `/components/ai/authpage` ——(P1 填充具体步骤)
@@ -0,0 +1,40 @@
1
+ # AutoComplete 禁用态 · components
2
+
3
+ ## 概述
4
+
5
+ disabled 时不可输入(状态矩阵覆盖)
6
+
7
+ ## 典型场景
8
+
9
+ - 表单输入/搜索/筛选——查询区、编辑表单、设置页
10
+
11
+ ## API
12
+
13
+ > props 提取降级(接口格式特殊)——见源码:`—`
14
+
15
+ ## 用法示例
16
+
17
+ ```tsx
18
+ <AutoComplete options={[{value:'pay-admin',label:'支付平台管理'},{value:'order-center',label:'订单中心'}]}
19
+ value="" disabled placeholder="禁用时不可输入" />
20
+ ```
21
+
22
+ ## 纪律/坑
23
+
24
+ - 受控输入纪律:焦点丢失——useControlledInput(与 autocomplete 同源事故)
25
+
26
+ ## 关系
27
+
28
+ - ↑ 用于页面模式:(暂无)
29
+ - ↑ 用于应用:(暂无)
30
+ - → 后端能力:(暂无)
31
+
32
+ ## 文件位置
33
+
34
+ | 文件 | 路径 |
35
+ |------|------|
36
+ | demo | `apps/showcase/src/demos/DemoAutoCompleteDis.tsx`(P1 拆分) |
37
+
38
+ ## 验证
39
+
40
+ > agent-browser 走查:打开 `/components/input/autocomplete-v2` ——(P1 填充具体步骤)
@@ -0,0 +1,56 @@
1
+ # AutoComplete · components
2
+
3
+ ## 概述
4
+
5
+ 输入联想:自由输入 + 过滤下拉 + 键盘流 + 选中回填
6
+
7
+ ## 典型场景
8
+
9
+ - 复杂数据交互——穿梭、树、级联、看板、流水线
10
+
11
+ ## API
12
+
13
+ | prop | 类型 | 必填 | 说明 |
14
+ |------|------|------|------|
15
+ | `options` | `AutoCompleteOption[]` | 是 | |
16
+ | `value` | `string` | 否 | |
17
+ | `onChange` | `(value: string) => void` | 否 | |
18
+ | `placeholder` | `string` | 否 | |
19
+ | `open` | `boolean` | 否 | |
20
+ | `onOpenChange` | `(open: boolean) => void` | 否 | |
21
+ | `disabled` | `boolean` | 否 | |
22
+ | `error` | `string` | 否 | 错误态(F2 状态矩阵——输入类基线) |
23
+ | `filter` | `(options: AutoCompleteOption[], query: string) => AutoCompleteOption[]` | 否 | 过滤函数(默认包含匹配) |
24
+ | `renderOption` | `(option: AutoCompleteOption) => any` | 否 | |
25
+ | `onSelect` | `(value: string, option: AutoCompleteOption) => void` | 否 | |
26
+
27
+ ## 用法示例
28
+
29
+ ```tsx
30
+ <AutoComplete options={options}
31
+ value={query} onChange={setQuery} />
32
+ ```
33
+
34
+ ## 纪律/坑
35
+
36
+ - 受控输入纪律(§5.3):受控 input 焦点丢失事故——输入期间 value 走内部 keyword(useControlledInput),不依赖受控 value 回流
37
+ - IME composition:中文输入组合期间受控 value 重置打断——isComposing 门控
38
+
39
+ ## 关系
40
+
41
+ - ↑ 用于页面模式:(暂无)
42
+ - ↑ 用于应用:(暂无)
43
+ - → 后端能力:(暂无)
44
+
45
+ ## 文件位置
46
+
47
+ | 文件 | 路径 |
48
+ |------|------|
49
+ | 源码 | `src/client/components/AutoComplete/AutoComplete.ts` |
50
+ | 样式 | `src/client/components/AutoComplete/AutoComplete.css` |
51
+ | 测试 | `src/client/components/AutoComplete/AutoComplete.test.ts` |
52
+ | demo | `apps/showcase/src/demos/DemoAutoComplete.tsx`(P1 拆分) |
53
+
54
+ ## 验证
55
+
56
+ > agent-browser 走查:打开 `/components/advanced/autocomplete` ——(P1 填充具体步骤)
@@ -0,0 +1,51 @@
1
+ # Avatar · components
2
+
3
+ ## 概述
4
+
5
+ 头像(首字母/图片),3 种 size
6
+
7
+ ## 典型场景
8
+
9
+ - 页面模式:landing、mobile(复制即用蓝本——examples/patterns/)
10
+ - 应用模板:admin(examples/apps/ 完整可跑)
11
+ - 基础元素(按钮/图标/文本/卡片/标签)——任意页面的构成单元
12
+
13
+ ## API
14
+
15
+ | prop | 类型 | 必填 | 说明 |
16
+ |------|------|------|------|
17
+ | `name` | `string` | 否 | |
18
+ | `src` | `string` | 否 | |
19
+ | `size` | `'sm' \| 'md' \| 'lg'` | 否 | |
20
+ | `color` | `string` | 否 | 指定背景色(覆盖按名字哈希的颜色),如按类型着色:user=蓝 / ai=紫 |
21
+
22
+ ## 用法示例
23
+
24
+ ```tsx
25
+ <Avatar name="张三" />
26
+ <Avatar size="sm" />
27
+ <Avatar src="/photo.jpg" />
28
+ ```
29
+
30
+ ## 纪律/坑
31
+
32
+ > 浏览器纪律(§5.5):组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
33
+
34
+ ## 关系
35
+
36
+ - ↑ 用于页面模式:[landing](../patterns/landing.md) · [mobile](../patterns/mobile.md)
37
+ - ↑ 用于应用:[admin](../apps/admin.md)
38
+ - → 后端能力:(暂无)
39
+
40
+ ## 文件位置
41
+
42
+ | 文件 | 路径 |
43
+ |------|------|
44
+ | 源码 | `src/client/components/Avatar/Avatar.ts` |
45
+ | 样式 | `src/client/components/Avatar/Avatar.css` |
46
+ | 测试 | `src/client/components/Avatar/Avatar.test.ts` |
47
+ | demo | `apps/showcase/src/demos/DemoAvatar.tsx`(P1 拆分) |
48
+
49
+ ## 验证
50
+
51
+ > agent-browser 走查:打开 `/components/core/avatar` ——(P1 填充具体步骤)
@@ -0,0 +1,47 @@
1
+ # AvatarGroup · components
2
+
3
+ ## 概述
4
+
5
+ 头像组:堆叠 + max 溢出 +N
6
+
7
+ ## 典型场景
8
+
9
+ - 基础元素(按钮/图标/文本/卡片/标签)——任意页面的构成单元
10
+
11
+ ## API
12
+
13
+ | prop | 类型 | 必填 | 说明 |
14
+ |------|------|------|------|
15
+ | `items` | `AvatarGroupItem[]` | 是 | |
16
+ | `max` | `number` | 否 | |
17
+ | `size` | `AvatarProps['size']` | 否 | |
18
+ | `className` | `string` | 否 | |
19
+
20
+ ## 用法示例
21
+
22
+ ```tsx
23
+ <AvatarGroup items={[{ name: '张三' }, { name: '李四' }]} max={3} />
24
+ ```
25
+
26
+ ## 纪律/坑
27
+
28
+ > 浏览器纪律(§5.5):组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
29
+
30
+ ## 关系
31
+
32
+ - ↑ 用于页面模式:(暂无)
33
+ - ↑ 用于应用:(暂无)
34
+ - → 后端能力:(暂无)
35
+
36
+ ## 文件位置
37
+
38
+ | 文件 | 路径 |
39
+ |------|------|
40
+ | 源码 | `src/client/components/AvatarGroup/AvatarGroup.ts` |
41
+ | 样式 | `src/client/components/AvatarGroup/AvatarGroup.css` |
42
+ | 测试 | `src/client/components/AvatarGroup/AvatarGroup.test.ts` |
43
+ | demo | `apps/showcase/src/demos/DemoAvatarGroup.tsx`(P1 拆分) |
44
+
45
+ ## 验证
46
+
47
+ > agent-browser 走查:打开 `/components/core/avatargroup` ——(P1 填充具体步骤)
@@ -0,0 +1,53 @@
1
+ # BackTop · components
2
+
3
+ ## 概述
4
+
5
+ 回到顶部(滚动超 400px 显示)+ 固定导航(距顶 80px 钉住)
6
+
7
+ ## 典型场景
8
+
9
+ - 页面模式:docs、landing(复制即用蓝本——examples/patterns/)
10
+ - 页面导航——侧栏、页头、标签页、步骤、分页
11
+
12
+ ## API
13
+
14
+ | prop | 类型 | 必填 | 说明 |
15
+ |------|------|------|------|
16
+ | `visibilityHeight` | `number` | 否 | 滚动超过此高度显示(px),默认 400 |
17
+ | `target` | `() => HTMLElement \| Window` | 否 | 滚动容器(默认 window) |
18
+ | `smooth` | `boolean` | 否 | 平滑滚动,默认 true |
19
+ | `children` | `any` | 否 | |
20
+ | `className` | `string` | 否 | |
21
+
22
+ ## 用法示例
23
+
24
+ ```tsx
25
+ <BackTop visibilityHeight={400} />
26
+
27
+ <Affix offsetTop={80}>
28
+ <nav>固定导航条</nav>
29
+ </Affix>
30
+ ```
31
+
32
+ ## 纪律/坑
33
+
34
+ > 键盘可达(P1):方向键导航焦点跟随(roving tabindex);受控 props 配回调
35
+
36
+ ## 关系
37
+
38
+ - ↑ 用于页面模式:[docs](../patterns/docs.md) · [landing](../patterns/landing.md)
39
+ - ↑ 用于应用:(暂无)
40
+ - → 后端能力:(暂无)
41
+
42
+ ## 文件位置
43
+
44
+ | 文件 | 路径 |
45
+ |------|------|
46
+ | 源码 | `src/client/components/BackTop/BackTop.ts` |
47
+ | 样式 | `src/client/components/BackTop/BackTop.css` |
48
+ | 测试 | `src/client/components/BackTop/BackTop.test.ts` |
49
+ | demo | `apps/showcase/src/demos/DemoBackTop.tsx`(P1 拆分) |
50
+
51
+ ## 验证
52
+
53
+ > agent-browser 走查:打开 `/components/navigation/backtop` ——(P1 填充具体步骤)
@@ -0,0 +1,55 @@
1
+ # Badge · components
2
+
3
+ ## 概述
4
+
5
+ 状态标签 + 圆点,6 种 variant
6
+
7
+ ## 典型场景
8
+
9
+ - 页面模式:app-shell、dashboard、data-screen、landing、mobile(复制即用蓝本——examples/patterns/)
10
+ - 应用模板:admin(examples/apps/ 完整可跑)
11
+ - 基础元素(按钮/图标/文本/卡片/标签)——任意页面的构成单元
12
+
13
+ ## API
14
+
15
+ | prop | 类型 | 必填 | 说明 |
16
+ |------|------|------|------|
17
+ | `variant` | `BadgeVariant` | 否 | |
18
+ | `dot` | `boolean` | 否 | |
19
+ | `children` | `any` | 否 | |
20
+ | `count` | `number` | 否 | 数值角标(与 children 互斥;超出 overflowCount 显示 N+) |
21
+ | `overflowCount` | `number` | 否 | 数值溢出阈值,默认 99(count > 阈值 → 阈值+) |
22
+ | `showZero` | `boolean` | 否 | count=0 时是否显示(默认 false 隐藏,antd showZero=false 语义) |
23
+
24
+ ## 用法示例
25
+
26
+ ```tsx
27
+ <Badge>默认</Badge>
28
+ <Badge variant="primary" />
29
+ <Badge variant="success" />
30
+ <Badge variant="danger" />
31
+ <Badge dot />
32
+ ```
33
+
34
+ ## 纪律/坑
35
+
36
+ > 浏览器纪律(§5.5):组件能力经 ctx.browser / ctx.ui.useXXX——禁裸 window/document
37
+
38
+ ## 关系
39
+
40
+ - ↑ 用于页面模式:[app-shell](../patterns/app-shell.md) · [dashboard](../patterns/dashboard.md) · [data-screen](../patterns/data-screen.md) · [landing](../patterns/landing.md) · [mobile](../patterns/mobile.md)
41
+ - ↑ 用于应用:[admin](../apps/admin.md)
42
+ - → 后端能力:(暂无)
43
+
44
+ ## 文件位置
45
+
46
+ | 文件 | 路径 |
47
+ |------|------|
48
+ | 源码 | `src/client/components/Badge/Badge.ts` |
49
+ | 样式 | `src/client/components/Badge/Badge.css` |
50
+ | 测试 | `src/client/components/Badge/Badge.test.ts` |
51
+ | demo | `apps/showcase/src/demos/DemoBadge.tsx`(P1 拆分) |
52
+
53
+ ## 验证
54
+
55
+ > agent-browser 走查:打开 `/components/core/badge` ——(P1 填充具体步骤)