# fan-standard-comp

> `fan-standard-comp@6.x` 是基于 React 18 和 Ant Design 6 的业务组件库，提供配置化表单、筛选、表格、弹窗、页面容器以及常用工具。

安装：`npm install fan-standard-comp --save`。公共 API 从 `fan-standard-comp` 包根路径按需导入。组件索引见 [`ai/component-index.json`](./ai/component-index.json)，更完整的文档导航见 [`llms-full.txt`](./llms-full.txt)。

在线文档根地址：[http://47.113.227.251:1203/doc-v6/](http://47.113.227.251:1203/doc-v6/)。在线入口包括 [llms.txt](http://47.113.227.251:1203/doc-v6/llms.txt)、[llms-full.txt](http://47.113.227.251:1203/doc-v6/llms-full.txt) 和 [AI 组件索引](http://47.113.227.251:1203/doc-v6/ai/component-index.json)。优先使用当前安装的 npm 包内文件，在线文档仅作为兜底；若在线文档与安装版本不一致，以本地 npm 包的文档和 TypeScript 类型声明为准。

## 必读

- [项目介绍](./docs/index.md)
- [安装与版本兼容](./docs/guide/usage.md)
- [AI 使用规范](./docs/guide/for-agents.md)
- [更新日志](./docs/guide/update.md)
- [Ant Design 6 主题样式](./docs/guide/theme.md)
- [全局配置 FanProvider](./docs/components/FanProvider.md)

## 主要公共组件

- 表单与控件：[Field / FieldComponent](./docs/components/Field.md)、[RefactorTreeSelect](./docs/components/Field.md)、[ItemGroup / RenderItemGroup](./docs/components/ItemGroup.md)、[StandardForm / StepForm / TabForm](./docs/components/StandardForm.md)、[JsonInput](./docs/components/JsonInput.md)、[Uploader](./docs/components/Uploader.md)、[EditButton](./docs/components/EditButton.md)、[VarTemplate](./docs/components/VarTemplate.md)
- 数据查询与展示：[StandardFilter](./docs/components/StandardFilter.md)、[StandardTable](./docs/components/StandardTable.md)、[StandardTablePro](./docs/components/StandardTablePro.md)、[StandardList](./docs/components/StandardList.md)、[RefactorTree](./docs/components/RefactortTree.md)
- 弹层：[StandardModal](./docs/components/StandardModal.md)、[StandardDrawer](./docs/components/StandardDrawer.md)
- 页面布局：[WrapperContent](./docs/components/WrapperContent.md)、[SubfieldContent](./docs/components/SubfieldContent.md)、[SideCard](./docs/components/SideCard.md)、[SplitterLayout](./docs/components/SplitterLayout.md)、[StandardPanel](./docs/components/StandardPanel.md)、[StandardTitle](./docs/components/StandardTitle.md)
- 操作、导航与媒体：[ButtonGroup](./docs/components/ButtonGroup.md)、[NavLeafScroll](./docs/components/NavLeafScroll.md)、[SpecIcon](./docs/components/SpecIcon.md)、[ImageGallery / ImagePreview](./docs/components/ImageGallery.md)、[DragContent](./docs/components/DragContent.md)
- 全局能力：`FanProvider`、`FanContext`、`FanDefaultConfig`、6.x 新增的 `useFanContext`。

## 公共 API 变化

- 6.x 新增包根公共导出：`RefactorTreeSelect`、`useFanContext`。
- `StandardDragModal` 已从包根公共导出移除并标记废弃，不要通过深层路径导入。
- `FieldComponent` 是 `Field` 的别名；`RenderItemGroup` 是 `ItemGroup` 的别名。
- `IconNode`、工具函数、数据常量和 `StandardTable` 类型也通过 `export *` 从包根路径公开，完整清单见组件索引的 `exports` 字段。

## 非推荐或非公共组件

- [DragContent](./docs/components/DragContent.md) 仍为公共导出，但功能处于实验状态。
- [StandardDragModal](./docs/components/StandardDragModal.md) 已废弃且不再是包根公共 API。
- [CalendarCoordPicker](./docs/components/CalendarCoordPicker.md)、[SpecNavigation](./docs/components/Navigation.md)、[ButtonGroupBeta](./docs/components/ButtonGroupBeta.md) 未从包根路径公开，仅用于实验或测试。

## 使用建议

1. 先在 `ai/component-index.json` 中按用途和 `public` / `status` 定位组件。
2. 再读取对应 `docs/components/*.md` 的 API 表格与示例源码链接。
3. 配置化表单中，`Field` 负责单个控件，`ItemGroup` 负责表单项布局，`StandardForm` / `StandardFilter` / `StandardModal` 组合它们。
4. 文档与类型声明不一致时，以当前安装版本的 TypeScript 声明为准。