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.
- package/README.md +56 -45
- package/content/apps/admin.md +55 -0
- package/content/apps/agent-platform.md +35 -0
- package/content/apps/auth.md +49 -0
- package/content/apps/multi.md +44 -0
- package/content/apps/todo.md +51 -0
- package/content/backend/ai.md +28 -0
- package/content/backend/auth.md +20 -0
- package/content/backend/email.md +23 -0
- package/content/backend/graphql.md +23 -0
- package/content/backend/http.md +23 -0
- package/content/backend/limit.md +23 -0
- package/content/backend/middleware.md +17 -0
- package/content/backend/queue.md +23 -0
- package/content/backend/redis.md +26 -0
- package/content/backend/router.md +23 -0
- package/content/backend/schedule.md +23 -0
- package/content/backend/sql.md +27 -0
- package/content/backend/sse.md +26 -0
- package/content/backend/ws.md +26 -0
- package/content/capabilities/app-node.md +21 -0
- package/content/capabilities/data.md +21 -0
- package/content/capabilities/events.md +21 -0
- package/content/capabilities/hooks.md +22 -0
- package/content/capabilities/i18n.md +21 -0
- package/content/capabilities/popup.md +21 -0
- package/content/capabilities/render-only.md +23 -0
- package/content/capabilities/router.md +22 -0
- package/content/capabilities/self-id.md +21 -0
- package/content/capabilities/store.md +21 -0
- package/content/capabilities/theme.md +21 -0
- package/content/capabilities/two-phase.md +21 -0
- package/content/components/accordion.md +50 -0
- package/content/components/actionsheet.md +46 -0
- package/content/components/affix.md +51 -0
- package/content/components/aichat.md +57 -0
- package/content/components/alert.md +52 -0
- package/content/components/alertgroup.md +45 -0
- package/content/components/anchor.md +52 -0
- package/content/components/app.md +37 -0
- package/content/components/approvalcard.md +56 -0
- package/content/components/appshell.md +50 -0
- package/content/components/aspectratio.md +47 -0
- package/content/components/authpage.md +61 -0
- package/content/components/autocomplete-v2.md +40 -0
- package/content/components/autocomplete.md +56 -0
- package/content/components/avatar.md +51 -0
- package/content/components/avatargroup.md +47 -0
- package/content/components/backtop.md +53 -0
- package/content/components/badge.md +55 -0
- package/content/components/breadcrumb.md +49 -0
- package/content/components/button.md +63 -0
- package/content/components/calendar-v2.md +40 -0
- package/content/components/calendar.md +50 -0
- package/content/components/card.md +58 -0
- package/content/components/carousel.md +52 -0
- package/content/components/cascader-v2.md +39 -0
- package/content/components/cascader.md +54 -0
- package/content/components/chart.md +53 -0
- package/content/components/chatinput.md +63 -0
- package/content/components/checkbox.md +51 -0
- package/content/components/checkboxgroup.md +52 -0
- package/content/components/citationcard.md +48 -0
- package/content/components/codeblock.md +48 -0
- package/content/components/codeeditor.md +47 -0
- package/content/components/collapse.md +49 -0
- package/content/components/colorpicker.md +50 -0
- package/content/components/command.md +50 -0
- package/content/components/confirm.md +57 -0
- package/content/components/contextmenu.md +48 -0
- package/content/components/copybutton.md +51 -0
- package/content/components/datepicker.md +52 -0
- package/content/components/descriptions-v2.md +39 -0
- package/content/components/descriptions.md +52 -0
- package/content/components/diffview-v2.md +39 -0
- package/content/components/diffview.md +50 -0
- package/content/components/divider.md +48 -0
- package/content/components/drawer.md +55 -0
- package/content/components/dropdown.md +53 -0
- package/content/components/editor.md +49 -0
- package/content/components/emptystate.md +51 -0
- package/content/components/exportcsv.md +38 -0
- package/content/components/field.md +54 -0
- package/content/components/filepreview-office.md +37 -0
- package/content/components/filepreview.md +49 -0
- package/content/components/filetree.md +56 -0
- package/content/components/fileupload-v2.md +39 -0
- package/content/components/fileupload.md +57 -0
- package/content/components/floatbutton.md +52 -0
- package/content/components/form-v2.md +41 -0
- package/content/components/form.md +60 -0
- package/content/components/grid.md +51 -0
- package/content/components/highlight-v2.md +39 -0
- package/content/components/highlight.md +46 -0
- package/content/components/hovercard.md +51 -0
- package/content/components/icon.md +50 -0
- package/content/components/imagecropper.md +45 -0
- package/content/components/img.md +56 -0
- package/content/components/infinitescroll-v2.md +40 -0
- package/content/components/infinitescroll.md +54 -0
- package/content/components/input.md +65 -0
- package/content/components/inputnumber.md +58 -0
- package/content/components/inview.md +56 -0
- package/content/components/jsonschemaform.md +53 -0
- package/content/components/jsonviewer-v2.md +39 -0
- package/content/components/jsonviewer.md +49 -0
- package/content/components/kanban.md +46 -0
- package/content/components/label.md +48 -0
- package/content/components/layout.md +54 -0
- package/content/components/layoutcontent.md +43 -0
- package/content/components/layoutheader.md +43 -0
- package/content/components/layoutsider.md +43 -0
- package/content/components/link.md +52 -0
- package/content/components/list.md +44 -0
- package/content/components/loading.md +45 -0
- package/content/components/logviewer-v2.md +39 -0
- package/content/components/logviewer.md +53 -0
- package/content/components/markdown.md +51 -0
- package/content/components/markdowneditor.md +47 -0
- package/content/components/math.md +42 -0
- package/content/components/mentions-v2.md +39 -0
- package/content/components/mentions.md +52 -0
- package/content/components/menu.md +56 -0
- package/content/components/menubar.md +44 -0
- package/content/components/messagebubble.md +50 -0
- package/content/components/modal.md +59 -0
- package/content/components/navmenu.md +47 -0
- package/content/components/notification.md +51 -0
- package/content/components/pageheader.md +53 -0
- package/content/components/pagination.md +49 -0
- package/content/components/paragraph.md +45 -0
- package/content/components/passwordinput.md +57 -0
- package/content/components/pininput-v2.md +39 -0
- package/content/components/pininput.md +50 -0
- package/content/components/pipeline.md +49 -0
- package/content/components/popconfirm.md +58 -0
- package/content/components/popover.md +61 -0
- package/content/components/progressbar.md +50 -0
- package/content/components/prompttemplate.md +49 -0
- package/content/components/qrcode.md +50 -0
- package/content/components/radiogroup.md +53 -0
- package/content/components/rate.md +53 -0
- package/content/components/reasoningblock.md +47 -0
- package/content/components/relationgraph.md +52 -0
- package/content/components/resizable.md +53 -0
- package/content/components/result.md +49 -0
- package/content/components/scrollbar.md +49 -0
- package/content/components/searchinput.md +51 -0
- package/content/components/segmentedcontrol.md +59 -0
- package/content/components/select-searchable.md +47 -0
- package/content/components/select.md +66 -0
- package/content/components/sessionlist.md +52 -0
- package/content/components/sheetgrid.md +44 -0
- package/content/components/skeleton.md +55 -0
- package/content/components/slidecanvas.md +44 -0
- package/content/components/slider.md +62 -0
- package/content/components/sortablelist.md +39 -0
- package/content/components/space.md +52 -0
- package/content/components/sparkline.md +52 -0
- package/content/components/statcard-countdown.md +39 -0
- package/content/components/statcard.md +56 -0
- package/content/components/steps.md +48 -0
- package/content/components/switch.md +50 -0
- package/content/components/tabbar.md +45 -0
- package/content/components/table-v2.md +40 -0
- package/content/components/table.md +66 -0
- package/content/components/tabs.md +56 -0
- package/content/components/tag.md +51 -0
- package/content/components/tagsinput-v2.md +39 -0
- package/content/components/tagsinput.md +54 -0
- package/content/components/text.md +45 -0
- package/content/components/textarea.md +57 -0
- package/content/components/themeswitch.md +69 -0
- package/content/components/timeline.md +50 -0
- package/content/components/title.md +45 -0
- package/content/components/toast.md +52 -0
- package/content/components/toggle-togglegroup.md +52 -0
- package/content/components/togglegroup.md +47 -0
- package/content/components/toolcallcard.md +51 -0
- package/content/components/tooltip.md +50 -0
- package/content/components/tour.md +50 -0
- package/content/components/transfer.md +52 -0
- package/content/components/tree-v2.md +39 -0
- package/content/components/tree.md +59 -0
- package/content/components/treeselect.md +54 -0
- package/content/components/typography.md +51 -0
- package/content/components/videoplayer.md +52 -0
- package/content/components/virtuallist.md +52 -0
- package/content/components/virtualtable-v2.md +39 -0
- package/content/components/virtualtable.md +55 -0
- package/content/components/watermark.md +53 -0
- package/content/components/wave.md +43 -0
- package/content/guides/ai-chat-family.md +24 -0
- package/content/guides/choose.md +67 -0
- package/content/guides/component-model.md +32 -0
- package/content/guides/component-standards.md +123 -0
- package/{docs/components.md → content/guides/components-guide.md} +31 -7
- package/{docs/custom-components.md → content/guides/custom-component.md} +70 -55
- package/{docs/data.md → content/guides/data-guide.md} +5 -2
- package/content/guides/file-preview-family.md +18 -0
- package/{docs → content/guides}/frontend.md +122 -52
- package/content/guides/layout-choice.md +64 -0
- package/{docs/layout.md → content/guides/layout-guide.md} +12 -8
- package/{docs/frontend-middleware.md → content/guides/middleware.md} +34 -3
- package/{docs/mobile.md → content/guides/mobile-guide.md} +20 -24
- package/content/guides/page-building.md +98 -0
- package/content/guides/production.md +37 -0
- package/content/guides/quality.md +60 -0
- package/{docs/realtime.md → content/guides/realtime-guide.md} +6 -3
- package/content/guides/render-only.md +44 -0
- package/{docs/saas.md → content/guides/saas-guide.md} +8 -5
- package/{docs/server.md → content/guides/server-guide.md} +5 -2
- package/content/guides/start.md +41 -0
- package/{docs → content/guides}/styling.md +5 -1
- package/{docs/frontend-ui-dom.md → content/guides/ui-dom-guide.md} +7 -1
- package/content/index.json +4344 -0
- package/content/index.md +181 -0
- package/content/layout/align.md +20 -0
- package/content/layout/anchor.md +19 -0
- package/content/layout/app-shell.md +23 -0
- package/content/layout/border.md +20 -0
- package/content/layout/center.md +19 -0
- package/content/layout/cluster.md +19 -0
- package/content/layout/container.md +19 -0
- package/content/layout/fill.md +19 -0
- package/content/layout/grid.md +19 -0
- package/content/layout/hidden.md +22 -0
- package/content/layout/layer.md +19 -0
- package/content/layout/position.md +22 -0
- package/content/layout/row.md +23 -0
- package/content/layout/safe-area.md +20 -0
- package/content/layout/scroll.md +21 -0
- package/content/layout/spacing.md +22 -0
- package/content/layout/split.md +19 -0
- package/content/layout/stack.md +19 -0
- package/content/layout/surface.md +23 -0
- package/content/layout/text.md +22 -0
- package/content/patterns/app-shell.md +34 -0
- package/content/patterns/dashboard.md +36 -0
- package/content/patterns/data-screen.md +30 -0
- package/content/patterns/detail-page.md +31 -0
- package/content/patterns/docs.md +34 -0
- package/content/patterns/focus-task.md +34 -0
- package/content/patterns/landing.md +35 -0
- package/content/patterns/list-page.md +32 -0
- package/content/patterns/mobile.md +31 -0
- package/content/patterns/settings-page.md +33 -0
- package/content/patterns/workspace.md +32 -0
- package/dist/cli/apps-typecheck.test.d.ts +11 -0
- package/dist/cli/docs.d.ts +2 -0
- package/dist/cli/docs.mjs +10961 -0
- package/dist/cli/home-flash.test.d.ts +1 -0
- package/dist/{components → client/components}/Accordion/Accordion.d.ts +1 -1
- package/dist/client/components/ActionSheet/ActionSheet.d.ts +37 -0
- package/dist/{components → client/components}/Affix/Affix.d.ts +1 -1
- package/dist/{components → client/components}/AiChat/AiChat.d.ts +3 -3
- package/dist/{components → client/components}/Alert/Alert.d.ts +1 -1
- package/dist/{components → client/components}/AlertGroup/AlertGroup.d.ts +1 -1
- package/dist/{components → client/components}/Anchor/Anchor.d.ts +1 -1
- package/dist/client/components/AppShell/AppShell.d.ts +55 -0
- package/dist/{components → client/components}/ApprovalCard/ApprovalCard.d.ts +2 -2
- package/dist/{components → client/components}/AspectRatio/AspectRatio.d.ts +1 -1
- package/dist/{components → client/components}/AuthPage/AuthPage.d.ts +2 -2
- package/dist/{components → client/components}/AutoComplete/AutoComplete.d.ts +1 -1
- package/dist/{components → client/components}/Avatar/Avatar.d.ts +1 -1
- package/dist/{components → client/components}/AvatarGroup/AvatarGroup.d.ts +1 -1
- package/dist/{components → client/components}/BackTop/BackTop.d.ts +1 -1
- package/dist/{components → client/components}/Badge/Badge.d.ts +1 -1
- package/dist/{components → client/components}/Breadcrumb/Breadcrumb.d.ts +1 -1
- package/dist/{components → client/components}/Button/Button.d.ts +1 -1
- package/dist/{components → client/components}/Calendar/Calendar.d.ts +1 -1
- package/dist/{components → client/components}/Card/Card.d.ts +1 -1
- package/dist/{components → client/components}/Carousel/Carousel.d.ts +1 -1
- package/dist/{components → client/components}/Cascader/Cascader.d.ts +1 -1
- package/dist/{components → client/components}/Chart/Chart.d.ts +1 -1
- package/dist/{components → client/components}/Chart/chart-utils.d.ts +5 -1
- package/dist/{components → client/components}/ChatInput/ChatInput.d.ts +7 -7
- package/dist/{components → client/components}/Checkbox/Checkbox.d.ts +1 -1
- package/dist/{components → client/components}/CheckboxGroup/CheckboxGroup.d.ts +1 -1
- package/dist/{components → client/components}/CitationCard/CitationCard.d.ts +3 -3
- package/dist/{components → client/components}/CodeBlock/CodeBlock.d.ts +1 -1
- package/dist/client/components/CodeEditor/CodeEditor.d.ts +18 -0
- package/dist/{components → client/components}/Collapse/Collapse.d.ts +1 -1
- package/dist/{components → client/components}/ColorPicker/ColorPicker.d.ts +1 -1
- package/dist/{components → client/components}/Command/Command.d.ts +1 -1
- package/dist/{components → client/components}/Confirm/Confirm.d.ts +2 -7
- package/dist/{components → client/components}/ContextMenu/ContextMenu.d.ts +1 -1
- package/dist/{components → client/components}/CopyButton/CopyButton.d.ts +1 -1
- package/dist/{components → client/components}/DatePicker/DatePicker.d.ts +2 -2
- package/dist/{components → client/components}/Descriptions/Descriptions.d.ts +1 -1
- package/dist/{components → client/components}/DiffView/DiffView.d.ts +1 -1
- package/dist/{components → client/components}/Divider/Divider.d.ts +1 -1
- package/dist/{components → client/components}/Drawer/Drawer.d.ts +1 -1
- package/dist/{components → client/components}/Dropdown/Dropdown.d.ts +1 -1
- package/dist/{components → client/components}/Editor/Editor.d.ts +1 -1
- package/dist/{components → client/components}/Editor/tools/toolbar.d.ts +1 -1
- package/dist/{components → client/components}/EmptyState/EmptyState.d.ts +1 -1
- package/dist/client/components/ExportCSV/ExportCSV.d.ts +30 -0
- package/dist/{components → client/components}/Field/Field.d.ts +1 -1
- package/dist/{components → client/components}/FilePreview/FilePreview.d.ts +1 -1
- package/dist/client/components/FileTree/FileTree.d.ts +57 -0
- package/dist/{components → client/components}/FileUpload/FileUpload.d.ts +1 -1
- package/dist/{components → client/components}/FloatButton/FloatButton.d.ts +1 -1
- package/dist/{components → client/components}/Form/Form.d.ts +1 -1
- package/dist/{components → client/components}/Grid/Grid.d.ts +1 -1
- package/dist/{components → client/components}/Highlight/Highlight.d.ts +1 -1
- package/dist/{components → client/components}/HoverCard/HoverCard.d.ts +5 -4
- package/dist/{components → client/components}/Icon/Icon.d.ts +2 -2
- package/dist/client/components/ImageCropper/ImageCropper.d.ts +17 -0
- package/dist/{components → client/components}/Img/Img.d.ts +1 -1
- package/dist/{components → client/components}/InView/InView.d.ts +1 -1
- package/dist/{components → client/components}/InfiniteScroll/InfiniteScroll.d.ts +1 -1
- package/dist/{components → client/components}/Input/Input.d.ts +1 -1
- package/dist/{components → client/components}/InputNumber/InputNumber.d.ts +1 -1
- package/dist/{components → client/components}/JSONViewer/JSONViewer.d.ts +1 -1
- package/dist/{components → client/components}/JsonSchemaForm/JsonSchemaForm.d.ts +3 -3
- package/dist/{components → client/components}/Kanban/Kanban.d.ts +1 -1
- package/dist/{components → client/components}/Label/Label.d.ts +1 -1
- package/dist/{components → client/components}/Layout/Layout.d.ts +1 -1
- package/dist/{components → client/components}/Link/Link.d.ts +1 -1
- package/dist/{components → client/components}/List/List.d.ts +1 -1
- package/dist/{components → client/components}/Loading/Loading.d.ts +1 -1
- package/dist/{components → client/components}/LogViewer/LogViewer.d.ts +1 -1
- package/dist/{components → client/components}/Markdown/Markdown.d.ts +1 -1
- package/dist/client/components/MarkdownEditor/MarkdownEditor.d.ts +18 -0
- package/dist/client/components/Math/Math.d.ts +15 -0
- package/dist/{components → client/components}/Mentions/Mentions.d.ts +1 -1
- package/dist/{components → client/components}/Menu/Menu.d.ts +1 -1
- package/dist/{components → client/components}/Menubar/Menubar.d.ts +1 -1
- package/dist/{components → client/components}/MessageBubble/MessageBubble.d.ts +1 -1
- package/dist/{components → client/components}/Modal/Modal.d.ts +1 -1
- package/dist/{components → client/components}/NavMenu/NavMenu.d.ts +2 -2
- package/dist/{components → client/components}/Notification/Notification.d.ts +7 -2
- package/dist/{components → client/components}/PageHeader/PageHeader.d.ts +1 -1
- package/dist/{components → client/components}/Pagination/Pagination.d.ts +1 -1
- package/dist/{components → client/components}/PasswordInput/PasswordInput.d.ts +1 -1
- package/dist/{components → client/components}/PinInput/PinInput.d.ts +1 -1
- package/dist/{components → client/components}/Pipeline/Pipeline.d.ts +1 -1
- package/dist/{components → client/components}/Popconfirm/Popconfirm.d.ts +2 -2
- package/dist/{components → client/components}/Popover/Popover.d.ts +5 -4
- package/dist/{components → client/components}/ProgressBar/ProgressBar.d.ts +1 -1
- package/dist/client/components/PromptTemplate/PromptTemplate.d.ts +37 -0
- package/dist/{components → client/components}/QRCode/QRCode.d.ts +1 -1
- package/dist/{components → client/components}/RadioGroup/RadioGroup.d.ts +1 -1
- package/dist/{components → client/components}/Rate/Rate.d.ts +1 -1
- package/dist/{components → client/components}/ReasoningBlock/ReasoningBlock.d.ts +3 -3
- package/dist/client/components/RelationGraph/RelationGraph.d.ts +59 -0
- package/dist/{components → client/components}/Resizable/Resizable.d.ts +1 -1
- package/dist/{components → client/components}/Result/Result.d.ts +1 -1
- package/dist/{components → client/components}/Scrollbar/Scrollbar.d.ts +1 -1
- package/dist/{components → client/components}/SearchInput/SearchInput.d.ts +1 -1
- package/dist/{components → client/components}/SegmentedControl/SegmentedControl.d.ts +1 -1
- package/dist/{components → client/components}/Select/Select.d.ts +1 -1
- package/dist/{components → client/components}/SessionList/SessionList.d.ts +3 -3
- package/dist/{components → client/components}/SheetGrid/SheetGrid.d.ts +1 -1
- package/dist/{components → client/components}/Skeleton/Skeleton.d.ts +1 -1
- package/dist/{components → client/components}/SlideCanvas/SlideCanvas.d.ts +1 -1
- package/dist/client/components/Slider/Slider.d.ts +27 -0
- package/dist/client/components/SortableList/SortableList.d.ts +23 -0
- package/dist/{components → client/components}/Space/Space.d.ts +1 -1
- package/dist/{components → client/components}/Sparkline/Sparkline.d.ts +1 -1
- package/dist/{components → client/components}/StatCard/StatCard.d.ts +1 -1
- package/dist/{components → client/components}/Steps/Steps.d.ts +1 -1
- package/dist/{components → client/components}/Switch/Switch.d.ts +1 -1
- package/dist/client/components/TabBar/TabBar.d.ts +35 -0
- package/dist/{components → client/components}/Table/Table.d.ts +7 -1
- package/dist/client/components/Tabs/Tabs.d.ts +22 -0
- package/dist/{components → client/components}/Tag/Tag.d.ts +1 -1
- package/dist/{components → client/components}/TagsInput/TagsInput.d.ts +1 -1
- package/dist/{components → client/components}/Textarea/Textarea.d.ts +1 -1
- package/dist/{components → client/components}/ThemeSwitch/ThemeSwitch.d.ts +1 -1
- package/dist/{components → client/components}/Timeline/Timeline.d.ts +1 -1
- package/dist/{components → client/components}/Toast/Toast.d.ts +1 -1
- package/dist/{components → client/components}/ToggleGroup/ToggleGroup.d.ts +1 -1
- package/dist/{components → client/components}/ToolCallCard/ToolCallCard.d.ts +2 -2
- package/dist/{components → client/components}/Tooltip/Tooltip.d.ts +4 -3
- package/dist/{components → client/components}/Tour/Tour.d.ts +1 -1
- package/dist/{components → client/components}/Transfer/Transfer.d.ts +1 -1
- package/dist/{components → client/components}/Tree/Tree.d.ts +5 -1
- package/dist/{components → client/components}/TreeSelect/TreeSelect.d.ts +5 -1
- package/dist/{components → client/components}/Typography/Typography.d.ts +1 -1
- package/dist/client/components/VideoPlayer/VideoPlayer.d.ts +25 -0
- package/dist/{components → client/components}/VirtualList/VirtualList.d.ts +1 -1
- package/dist/{components → client/components}/VirtualTable/VirtualTable.d.ts +1 -1
- package/dist/{components → client/components}/Watermark/Watermark.d.ts +1 -1
- package/dist/client/components/Wave/Wave.d.ts +15 -0
- package/dist/{components → client/components}/index.d.ts +44 -5
- package/dist/client/components/index.js +57 -0
- package/dist/{components → client/components}/style.css +1081 -98
- package/dist/{layout → client/layout}/weifuwu-layout.css +60 -6
- package/dist/{office → client/office}/xml-serialize.d.ts +1 -1
- package/dist/client/vdom/browser/Browser.d.ts +73 -0
- package/dist/client/vdom/browser/create-client-browser.d.ts +11 -0
- package/dist/client/vdom/commands.d.ts +19 -0
- package/dist/client/vdom/context/UIContext.d.ts +61 -0
- package/dist/client/vdom/context/data.d.ts +17 -0
- package/dist/client/vdom/core/async-guard.d.ts +20 -0
- package/dist/client/vdom/core/build.d.ts +36 -0
- package/dist/client/vdom/core/command/create.d.ts +25 -0
- package/dist/client/vdom/core/command/index.d.ts +15 -0
- package/dist/client/vdom/core/command/insert.d.ts +32 -0
- package/dist/client/vdom/core/command/lifecycle.d.ts +47 -0
- package/dist/client/vdom/core/command/props.d.ts +22 -0
- package/dist/client/vdom/core/diff/attrs.d.ts +10 -0
- package/dist/client/vdom/core/diff/children.d.ts +29 -0
- package/dist/client/vdom/core/diff/cleanup.d.ts +44 -0
- package/dist/client/vdom/core/diff/index.d.ts +22 -0
- package/dist/client/vdom/core/diff/output.d.ts +30 -0
- package/dist/client/vdom/core/diff/same.d.ts +22 -0
- package/dist/client/vdom/core/field/attributes.d.ts +15 -0
- package/dist/client/vdom/core/field/events.d.ts +54 -0
- package/dist/client/vdom/core/field/index.d.ts +19 -0
- package/dist/client/vdom/core/field/key.d.ts +16 -0
- package/dist/client/vdom/core/field/props.d.ts +15 -0
- package/dist/client/vdom/core/field/ref.d.ts +38 -0
- package/dist/client/vdom/core/field/style.d.ts +17 -0
- package/dist/client/vdom/core/node/children.d.ts +20 -0
- package/dist/client/vdom/core/node/component.d.ts +93 -0
- package/dist/client/vdom/core/node/fragment.d.ts +14 -0
- package/dist/client/vdom/core/node/hole.d.ts +22 -0
- package/dist/client/vdom/core/node/index.d.ts +35 -0
- package/dist/client/vdom/core/node/keyed.d.ts +64 -0
- package/dist/client/vdom/core/node/native.d.ts +20 -0
- package/dist/client/vdom/core/node/portal.d.ts +11 -0
- package/dist/client/vdom/core/patch/fields.d.ts +15 -0
- package/dist/client/vdom/core/patch/index.d.ts +51 -0
- package/dist/client/vdom/core/patch/processors.d.ts +75 -0
- package/dist/client/vdom/core/patch/state-machine.d.ts +38 -0
- package/dist/client/vdom/core/patch/verify.d.ts +17 -0
- package/dist/client/vdom/core/router.d.ts +31 -0
- package/dist/client/vdom/core/serve.d.ts +75 -0
- package/dist/client/vdom/core/ssr/absorb.d.ts +53 -0
- package/dist/client/vdom/core/ssr/html.d.ts +32 -0
- package/dist/client/vdom/core/ssr/index.d.ts +25 -0
- package/dist/client/vdom/core/transform/component.d.ts +23 -0
- package/dist/client/vdom/core/transform/element.d.ts +21 -0
- package/dist/client/vdom/core/transform/fragment.d.ts +21 -0
- package/dist/client/vdom/core/transform/hole.d.ts +13 -0
- package/dist/client/vdom/core/transform/index.d.ts +46 -0
- package/dist/client/vdom/core/transform/states.d.ts +22 -0
- package/dist/client/vdom/core/transform/table.d.ts +28 -0
- package/dist/client/vdom/core/transform/text.d.ts +10 -0
- package/dist/client/vdom/core/vnode.d.ts +45 -0
- package/dist/client/vdom/dev/effect-guard.d.ts +8 -0
- package/dist/client/vdom/hooks/ai-stream.d.ts +46 -0
- package/dist/client/vdom/hooks/basic.d.ts +42 -0
- package/dist/client/vdom/hooks/chat.d.ts +91 -0
- package/dist/client/vdom/hooks/controlled.d.ts +27 -0
- package/dist/client/vdom/hooks/drag-media.d.ts +52 -0
- package/dist/client/vdom/hooks/env.d.ts +119 -0
- package/dist/client/vdom/hooks/input.d.ts +43 -0
- package/dist/client/vdom/hooks/observe.d.ts +60 -0
- package/dist/client/vdom/hooks/popup-manager.d.ts +92 -0
- package/dist/client/vdom/hooks/popup.d.ts +52 -0
- package/dist/client/vdom/hooks/stable.d.ts +45 -0
- package/dist/client/vdom/index.d.ts +67 -0
- package/dist/client/vdom/index.js +8 -0
- package/dist/client/vdom/jsx-runtime.d.ts +28 -0
- package/dist/client/vdom/jsx-runtime.js +1 -0
- package/dist/client/vdom/middlewares/api.d.ts +38 -0
- package/dist/client/vdom/middlewares/auth-i18n.d.ts +66 -0
- package/dist/client/vdom/middlewares/ws.d.ts +37 -0
- package/dist/client/vdom/store.d.ts +49 -0
- package/dist/client/vdom/testing.d.ts +46 -0
- package/dist/client/vdom/testing.js +2 -0
- package/dist/dev/index.d.ts +12 -0
- package/dist/dev/index.js +4 -4
- package/dist/{ai → server/ai}/contracts.d.ts +1 -1
- package/dist/{ai → server/ai}/index.d.ts +2 -2
- package/dist/{ai → server/ai}/types.d.ts +1 -1
- package/dist/{core → server/core}/router.d.ts +2 -4
- package/dist/{db → server/db}/contracts.d.ts +1 -1
- package/dist/server/db/postgres-server.d.ts +37 -0
- package/dist/server/db/redis-server.d.ts +32 -0
- package/dist/server/db/server.d.ts +30 -0
- package/dist/server/db/test-servers.d.ts +21 -0
- package/dist/{email → server/email}/contracts.d.ts +1 -1
- package/dist/{index.js → server/index.js} +3145 -2487
- package/dist/{ui → server/ui}/index.d.ts +2 -2
- package/dist/{user → server/user}/token.d.ts +1 -1
- package/dist/shared/router/trie.d.ts +61 -0
- package/docs/components-map.md +5 -5
- package/docs/style-guide.md +14 -2
- package/examples/apps/admin/README.md +23 -0
- package/examples/apps/admin/api.ts +27 -0
- package/examples/apps/admin/app.tsx +144 -0
- package/examples/apps/admin/main.tsx +8 -0
- package/examples/apps/admin/server.ts +37 -0
- package/examples/apps/auth/README.md +23 -0
- package/examples/apps/auth/api.ts +49 -0
- package/examples/apps/auth/app.tsx +137 -0
- package/examples/apps/auth/main.tsx +8 -0
- package/examples/apps/auth/server.ts +37 -0
- package/examples/apps/multi/README.md +23 -0
- package/examples/apps/multi/app.tsx +83 -0
- package/examples/apps/multi/main.tsx +8 -0
- package/examples/apps/multi/server.ts +33 -0
- package/examples/apps/todo/README.md +23 -0
- package/examples/apps/todo/api.ts +26 -0
- package/examples/apps/todo/app.tsx +128 -0
- package/examples/apps/todo/main.tsx +9 -0
- package/examples/apps/todo/server.ts +39 -0
- package/examples/hello-world/README.md +9 -0
- package/examples/hello-world/client.ts +14 -0
- package/examples/hello-world/routes.tsx +26 -0
- package/examples/hello-world/server.ts +46 -0
- package/examples/patterns/AppShell.tsx +224 -0
- package/examples/patterns/Dashboard.tsx +153 -0
- package/examples/patterns/DataScreen.tsx +104 -0
- package/examples/patterns/DetailPage.tsx +79 -0
- package/examples/patterns/Docs.tsx +105 -0
- package/examples/patterns/FocusTask.tsx +67 -0
- package/examples/patterns/Landing.tsx +90 -0
- package/examples/patterns/ListPage.tsx +77 -0
- package/examples/patterns/Mobile.tsx +154 -0
- package/examples/patterns/SettingsPage.tsx +98 -0
- package/examples/patterns/SplitWorkspace.tsx +113 -0
- package/package.json +61 -29
- package/dist/components/Slider/Slider.d.ts +0 -19
- package/dist/components/Tabs/Tabs.d.ts +0 -12
- package/dist/components/index.js +0 -55
- package/dist/ui-dom/Confirm.d.ts +0 -8
- package/dist/ui-dom/Notification.d.ts +0 -8
- package/dist/ui-dom/Toast.d.ts +0 -8
- package/dist/ui-dom/ai.d.ts +0 -59
- package/dist/ui-dom/browser.d.ts +0 -10
- package/dist/ui-dom/debug.d.ts +0 -21
- package/dist/ui-dom/hooks/chat.d.ts +0 -11
- package/dist/ui-dom/hooks/events.d.ts +0 -30
- package/dist/ui-dom/hooks/external.d.ts +0 -20
- package/dist/ui-dom/hooks/index.d.ts +0 -29
- package/dist/ui-dom/hooks/input.d.ts +0 -33
- package/dist/ui-dom/hooks/media.d.ts +0 -17
- package/dist/ui-dom/hooks/popup.d.ts +0 -30
- package/dist/ui-dom/hooks/stable.d.ts +0 -35
- package/dist/ui-dom/hooks/types.d.ts +0 -77
- package/dist/ui-dom/i18n.d.ts +0 -31
- package/dist/ui-dom/index.d.ts +0 -47
- package/dist/ui-dom/index.js +0 -41
- package/dist/ui-dom/jsx-runtime.d.ts +0 -4
- package/dist/ui-dom/jsx-runtime.js +0 -1
- package/dist/ui-dom/locale/en_US.d.ts +0 -69
- package/dist/ui-dom/locale/zh_CN.d.ts +0 -69
- package/dist/ui-dom/middleware/api.d.ts +0 -91
- package/dist/ui-dom/middleware/auth.d.ts +0 -30
- package/dist/ui-dom/middleware/ws.d.ts +0 -33
- package/dist/ui-dom/motion.d.ts +0 -8
- package/dist/ui-dom/popup-tracker.d.ts +0 -36
- package/dist/ui-dom/popup.d.ts +0 -42
- package/dist/ui-dom/store.d.ts +0 -24
- package/dist/ui-dom/testing.d.ts +0 -68
- package/dist/ui-dom/testing.js +0 -7
- package/dist/ui-dom/types.d.ts +0 -634
- package/dist/ui-dom/use-chat.d.ts +0 -95
- package/dist/ui-dom/vdom3/README.d.ts +0 -32
- package/dist/ui-dom/vdom3/app.d.ts +0 -20
- package/dist/ui-dom/vdom3/audit.d.ts +0 -29
- package/dist/ui-dom/vdom3/build.d.ts +0 -20
- package/dist/ui-dom/vdom3/commands.d.ts +0 -21
- package/dist/ui-dom/vdom3/comp-index.d.ts +0 -18
- package/dist/ui-dom/vdom3/delegate.d.ts +0 -53
- package/dist/ui-dom/vdom3/events.d.ts +0 -17
- package/dist/ui-dom/vdom3/index.d.ts +0 -42
- package/dist/ui-dom/vdom3/jsx.d.ts +0 -32
- package/dist/ui-dom/vdom3/record.d.ts +0 -16
- package/dist/ui-dom/vdom3/registry.d.ts +0 -30
- package/dist/ui-dom/vdom3/render.d.ts +0 -39
- package/dist/ui-dom/vdom3/replay.d.ts +0 -28
- package/dist/ui-dom/vdom3/root.d.ts +0 -24
- package/dist/ui-dom/vdom3/router.d.ts +0 -31
- package/dist/ui-dom/vdom3/scheduler.d.ts +0 -23
- package/dist/ui-dom/vdom3/ssr.d.ts +0 -27
- package/dist/ui-dom/vdom3/sync.d.ts +0 -22
- package/dist/ui-dom/vdom3/types.d.ts +0 -173
- package/dist/ui-dom/vdom3/ui.d.ts +0 -16
- package/dist/ui-dom/vdom3.js +0 -41
- package/dist/ui-dom/vnode.d.ts +0 -13
- /package/dist/{make-executable-schema.test.d.ts → cli/content-sync.test.d.ts} +0 -0
- /package/dist/{ui-dom/testing.test.d.ts → cli/docs-cli.test.d.ts} +0 -0
- /package/dist/{components → client/components}/CodeBlock/highlight.d.ts +0 -0
- /package/dist/{components → client/components}/DatePicker/calendar-utils.d.ts +0 -0
- /package/dist/{components → client/components}/DiffView/diff-utils.d.ts +0 -0
- /package/dist/{components → client/components}/Editor/edit-events.d.ts +0 -0
- /package/dist/{components → client/components}/Editor/model/apply.d.ts +0 -0
- /package/dist/{components → client/components}/Editor/model/diff.d.ts +0 -0
- /package/dist/{components → client/components}/Editor/model/dom.d.ts +0 -0
- /package/dist/{components → client/components}/Editor/model/history.d.ts +0 -0
- /package/dist/{components → client/components}/Editor/model/html.d.ts +0 -0
- /package/dist/{components → client/components}/Editor/model/inverse.d.ts +0 -0
- /package/dist/{components → client/components}/Editor/model/types.d.ts +0 -0
- /package/dist/{components → client/components}/Editor/tools/table.d.ts +0 -0
- /package/dist/{components → client/components}/Editor/tools/types.d.ts +0 -0
- /package/dist/{components → client/components}/FilePreview/markdown.d.ts +0 -0
- /package/dist/{components → client/components}/Markdown/parser.d.ts +0 -0
- /package/dist/{components → client/components}/OfficeEditor/ai/ai-bridge.d.ts +0 -0
- /package/dist/{components → client/components}/OfficeEditor/model/apply.d.ts +0 -0
- /package/dist/{components → client/components}/OfficeEditor/model/types.d.ts +0 -0
- /package/dist/{components → client/components}/Pipeline/dag-utils.d.ts +0 -0
- /package/dist/{components → client/components}/QRCode/qr.d.ts +0 -0
- /package/dist/{components → client/components}/Sparkline/sparkline-utils.d.ts +0 -0
- /package/dist/{office → client/office}/docx.d.ts +0 -0
- /package/dist/{office → client/office}/pptx.d.ts +0 -0
- /package/dist/{office → client/office}/xlsx.d.ts +0 -0
- /package/dist/{office → client/office}/xml.d.ts +0 -0
- /package/dist/{office → client/office}/zip.d.ts +0 -0
- /package/dist/{ai → server/ai}/agent.d.ts +0 -0
- /package/dist/{ai → server/ai}/client.d.ts +0 -0
- /package/dist/{ai → server/ai}/sse.d.ts +0 -0
- /package/dist/{core → server/core}/serve.d.ts +0 -0
- /package/dist/{core → server/core}/ws.d.ts +0 -0
- /package/dist/{db → server/db}/errors.d.ts +0 -0
- /package/dist/{db → server/db}/memory-redis.d.ts +0 -0
- /package/dist/{db → server/db}/memory-sql.d.ts +0 -0
- /package/dist/{db → server/db}/postgres/connection.d.ts +0 -0
- /package/dist/{db → server/db}/postgres/pool.d.ts +0 -0
- /package/dist/{db → server/db}/postgres/protocol.d.ts +0 -0
- /package/dist/{db → server/db}/postgres/schema.d.ts +0 -0
- /package/dist/{db → server/db}/query-builder.d.ts +0 -0
- /package/dist/{db → server/db}/query.d.ts +0 -0
- /package/dist/{db → server/db}/redis/client.d.ts +0 -0
- /package/dist/{db → server/db}/redis/commands.d.ts +0 -0
- /package/dist/{db → server/db}/redis/connection.d.ts +0 -0
- /package/dist/{db → server/db}/redis/pipeline.d.ts +0 -0
- /package/dist/{db → server/db}/redis/pool.d.ts +0 -0
- /package/dist/{db → server/db}/redis/resp.d.ts +0 -0
- /package/dist/{db → server/db}/redis/subscriber.d.ts +0 -0
- /package/dist/{db → server/db}/sql-parser.d.ts +0 -0
- /package/dist/{email → server/email}/index.d.ts +0 -0
- /package/dist/{email → server/email}/smtp.d.ts +0 -0
- /package/dist/{graphql.d.ts → server/graphql.d.ts} +0 -0
- /package/dist/{index.d.ts → server/index.d.ts} +0 -0
- /package/dist/{make-executable-schema.d.ts → server/make-executable-schema.d.ts} +0 -0
- /package/dist/{messager → server/messager}/index.d.ts +0 -0
- /package/dist/{middleware → server/middleware}/cors.d.ts +0 -0
- /package/dist/{middleware → server/middleware}/rate-limit.d.ts +0 -0
- /package/dist/{middleware → server/middleware}/static.d.ts +0 -0
- /package/dist/{postgres → server/postgres}/client.d.ts +0 -0
- /package/dist/{postgres → server/postgres}/index.d.ts +0 -0
- /package/dist/{postgres → server/postgres}/types.d.ts +0 -0
- /package/dist/{queue → server/queue}/index.d.ts +0 -0
- /package/dist/{redis → server/redis}/client.d.ts +0 -0
- /package/dist/{redis → server/redis}/index.d.ts +0 -0
- /package/dist/{redis → server/redis}/types.d.ts +0 -0
- /package/dist/{request.d.ts → server/request.d.ts} +0 -0
- /package/dist/{response.d.ts → server/response.d.ts} +0 -0
- /package/dist/{scheduler → server/scheduler}/cron.d.ts +0 -0
- /package/dist/{scheduler → server/scheduler}/index.d.ts +0 -0
- /package/dist/{types.d.ts → server/types.d.ts} +0 -0
- /package/dist/{ui → server/ui}/html-safe.d.ts +0 -0
- /package/dist/{user → server/user}/index.d.ts +0 -0
- /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 填充具体步骤)
|