@bit-sun/business-component 4.2.0-alpha.7 → 4.2.0-alpha.8

package/dist/index.d.ts

@@ -33,6 +33,7 @@ export { default as EllipsisTooltip } from './components/Functional/EllipsisTool
 export * from './components/Functional/BsAntdSula/index';
 export { default as RuleComponent } from './components/Solution/RuleComponent';
 export { default as RuleSetter } from './components/Solution/RuleSetter';
+export { default as RenderCompItem } from './components/Solution/RuleComponent/RenderCompItem';
 export { processDetailButtonsVisible as processDetailButtonsVisible } from './components/Business/DetailPageWrapper';
 export { default as ExtendedCollapse } from './components/Common/ExtendedCollapse';
 export { default as Section } from './components/Common/Section';

package/dist/index.esm.js

@@ -40734,4 +40734,4 @@ var SystemLog = function SystemLog(_ref) {
   });
 };
 
-export { AddSelect, AddSkcSelect, AddSkuSelect, AddSpuSelect, AuthButton, BillEntry, BsCascader, index$5 as BsLayout, BsSulaQueryTable, BusinessSearchSelect$1 as BusinessSearchSelect, BusinessTreeSearchSelect$1 as BusinessTreeSearchSelect, index$1 as CheckOneUser, ColumnSettingTable, ColumnsEdit, CommodityEntry, CustomSelector, DataImport, DataValidation, index$3 as DetailPageWrapper, EllipsisTooltip, ExportIcon, index$8 as ExtendedCollapse, GuideWrapper, HandleTotalCount, index$4 as HomePageWrapper, JsonQueryTable, ModalUtils, index$6 as MoreTreeTable, ParagraphCopier, PropertySelector, QueryMutipleInput, QueryMutipleSearchSelect, RuleObjectComponent as RuleComponent, index$7 as RuleSetter, SearchSelect, Section, index$2 as StateFlow, ColumnSettingSulaTable as SulaColumnSettingTable, SystemLog, TableColumnSetting, TreeSearchSelect, authFunc, calculateValidPeriod, checkQuantityAccuracy, _coverToParallel as coverToParallel, createUniqID, downloadExcel, ergodicMenuRoutes, formContainerAndItemLayout, _formatter as formatter, getAccountID, getAccountId, getBreadcrumbNameMap, getCommonInfoKey, getConfigTableColumns, getCurrentTargetBgId, getCurrentTenantId, getDictionarySource, getDictionaryTextByValue, getEmployeeCode, getEmployeeId, getItemDefaultWidth$1 as getItemDefaultWidth, getJoinDictionaryText, getLastKey, getLimitMenuDataKey, getLocalStorageSaveKey, getMenuAuthDataKey, getSessionId, getSkuImg, getTenantList, getUserId, getUserName, go2BackAndClose, handleAntdColumnsSpecialParams, handleBaseUrlPre, handleBeforeUpload, handleBssulaColumnsSpecialParams, handleCommonTimeRender$1 as handleCommonTimeRender, handleConvertResponse, handleError, handleExport, handleExportBarCode, handleJudgeAuthButtons, handleOssUrl, handleRequestAuthHeader, handleRequestHeader, handleRequestUrl, handleStatusBadge, handleTextBreakSpaces, handleTextDouble$1 as handleTextDouble, handleTextDoubleOrId, handleTextLineFeed$1 as handleTextLineFeed, handleTextOverflow$1 as handleTextOverflow, handleTextTooltip, handleTextWarp, handleTextWarpCustom, handleTooltip$1 as handleTooltip, handleTooltipHours$1 as handleTooltipHours, handleUserPhone, judgeIsEmpty, judgeIsRequestError, judgeIsRequestSuccess, keyToWord, memoizeOneFormatter, noEmptyArr, noEmptyArray, paramsControl, parseWidth, precisionQuantity, processDetailButtonsVisible, randomString, readerXlsxToList, removeCurrentTenantId, removeTenantList, renderFixed2, renderNumberText, saveCurrentTenantId, saveTenantList, setConfigTableColumns, shouldUseAuth, socketFunctions, sulaTableRenderTooltip, tableColumnsImage$1 as tableColumnsImage, textIcon, updateGuanDate, userColumns$1 as userColumns, userInfoCard$1 as userInfoCard, uuid, writeListToXlsx };
+export { AddSelect, AddSkcSelect, AddSkuSelect, AddSpuSelect, AuthButton, BillEntry, BsCascader, index$5 as BsLayout, BsSulaQueryTable, BusinessSearchSelect$1 as BusinessSearchSelect, BusinessTreeSearchSelect$1 as BusinessTreeSearchSelect, index$1 as CheckOneUser, ColumnSettingTable, ColumnsEdit, CommodityEntry, CustomSelector, DataImport, DataValidation, index$3 as DetailPageWrapper, EllipsisTooltip, ExportIcon, index$8 as ExtendedCollapse, GuideWrapper, HandleTotalCount, index$4 as HomePageWrapper, JsonQueryTable, ModalUtils, index$6 as MoreTreeTable, ParagraphCopier, PropertySelector, QueryMutipleInput, QueryMutipleSearchSelect, RenderCompItem, RuleObjectComponent as RuleComponent, index$7 as RuleSetter, SearchSelect, Section, index$2 as StateFlow, ColumnSettingSulaTable as SulaColumnSettingTable, SystemLog, TableColumnSetting, TreeSearchSelect, authFunc, calculateValidPeriod, checkQuantityAccuracy, _coverToParallel as coverToParallel, createUniqID, downloadExcel, ergodicMenuRoutes, formContainerAndItemLayout, _formatter as formatter, getAccountID, getAccountId, getBreadcrumbNameMap, getCommonInfoKey, getConfigTableColumns, getCurrentTargetBgId, getCurrentTenantId, getDictionarySource, getDictionaryTextByValue, getEmployeeCode, getEmployeeId, getItemDefaultWidth$1 as getItemDefaultWidth, getJoinDictionaryText, getLastKey, getLimitMenuDataKey, getLocalStorageSaveKey, getMenuAuthDataKey, getSessionId, getSkuImg, getTenantList, getUserId, getUserName, go2BackAndClose, handleAntdColumnsSpecialParams, handleBaseUrlPre, handleBeforeUpload, handleBssulaColumnsSpecialParams, handleCommonTimeRender$1 as handleCommonTimeRender, handleConvertResponse, handleError, handleExport, handleExportBarCode, handleJudgeAuthButtons, handleOssUrl, handleRequestAuthHeader, handleRequestHeader, handleRequestUrl, handleStatusBadge, handleTextBreakSpaces, handleTextDouble$1 as handleTextDouble, handleTextDoubleOrId, handleTextLineFeed$1 as handleTextLineFeed, handleTextOverflow$1 as handleTextOverflow, handleTextTooltip, handleTextWarp, handleTextWarpCustom, handleTooltip$1 as handleTooltip, handleTooltipHours$1 as handleTooltipHours, handleUserPhone, judgeIsEmpty, judgeIsRequestError, judgeIsRequestSuccess, keyToWord, memoizeOneFormatter, noEmptyArr, noEmptyArray, paramsControl, parseWidth, precisionQuantity, processDetailButtonsVisible, randomString, readerXlsxToList, removeCurrentTenantId, removeTenantList, renderFixed2, renderNumberText, saveCurrentTenantId, saveTenantList, setConfigTableColumns, shouldUseAuth, socketFunctions, sulaTableRenderTooltip, tableColumnsImage$1 as tableColumnsImage, textIcon, updateGuanDate, userColumns$1 as userColumns, userInfoCard$1 as userInfoCard, uuid, writeListToXlsx };

package/dist/index.js

@@ -40789,6 +40789,7 @@ exports.ParagraphCopier = ParagraphCopier;
 exports.PropertySelector = PropertySelector;
 exports.QueryMutipleInput = QueryMutipleInput;
 exports.QueryMutipleSearchSelect = QueryMutipleSearchSelect;
+exports.RenderCompItem = RenderCompItem;
 exports.RuleComponent = RuleObjectComponent;
 exports.RuleSetter = index$7;
 exports.SearchSelect = SearchSelect;

package/docs/flow-control-readme.md

@@ -0,0 +1,283 @@
+# 按钮流程控制架构与使用说明（重构版）
+
+## 背景
+为统一“列表页与详情页按钮显隐”的流程控制，新增了一套基于本地数据源的轻量机制，支持按业务类型、单据状态与资源编码进行控制，同时不改变既有权限与显隐表达式的使用方式。
+
+## 架构概览
+- 核心思想：数据先标注、视图只引用，不侵入既有权限与显隐逻辑
+- 统一数据源：`BUSINESS_FLOW_BUTTONS`（本地存储）
+- 列表页：在 `converter` 增强每条记录，生成 `__flowAllowedMap`；权限列在生成最终 `columns` 时对 `visible` 追加流程布尔条件
+- 详情页：提供 `processDetailButtonsVisible(buttons, params)` 对外方法，融合原 `visible` 与流程允许判定后返回按钮数组
+- 保护策略：未传 `tradeType` 或无匹配配置时不执行任何流程控制；只控制 `controlButtons` 范围内按钮
+
+## 核心数据源
+- 本地存储键：`BUSINESS_FLOW_BUTTONS`
+- 结构：
+```json
+[
+  {
+    "tradeType": 180,
+    "controlButtons": ["DRP_Sale_Sales_submit", "DRP_Sale_Sales_examine"],
+    "config": [
+      { "fromStatus": 1,  "buttons": ["DRP_Sale_Sales_submit"] },
+      { "fromStatus": 25, "buttons": ["DRP_Sale_Sales_examine", "DRP_Sale_Sales_back"] }
+    ]
+  }
+]
+```
+- 说明：
+  - `tradeType`：业务类型
+  - `controlButtons`：参与流程控制的按钮编码集合（控制范围）；不在此集合的按钮不受流程控制影响
+  - `config[].fromStatus`：状态值
+  - `config[].buttons`：该状态下允许显示的按钮编码集合
+
+## 控制原则
+- 未传入 `tradeType` 时，不执行任何流程控制逻辑（列表与详情一致）
+- 仅对 `controlButtons` 范围内的按钮做流程控制；其他按钮不改动
+- 顶部按钮：在控制范围内，保留“所有状态允许集合”中的按钮
+- 列权限按钮：在控制范围内，于既有 `visible` 表达式末尾追加 `&& record.__flowAllowedMap['<code>'] == true`
+- 权限不重复判断：流程控制不改动既有权限过滤（仍使用 `authFn` / `shouldUseAuth`）
+
+## 列表页实现
+- 文件：`src/components/Business/BsSulaQueryTable/index.tsx`
+- 行状态读取：
+  - 属性：`statusFieldPath`（可选，支持嵌套路径，如 `saleInfo.tradeStatus`）
+  - 未配置时自动探测：`status`、`orderStatus`、`flowStatus`、`tradeStatus`、`currentStatus`
+- 数据增强（convert）：
+  - 覆盖 `remoteDataSource.converter` 为管道：原 `converter` → 增强阶段
+  - 增强阶段为每条记录生成 `__flowAllowedMap`：`{ [code]: true | undefined }`
+  - 仅在传入 `tradeType` 且存在非空 `controlButtons` 时启用
+- 列权限按钮 `visible` 合并：
+  - 仅在传入 `tradeType` 且存在非空控制范围时，对 `isPermissionColumn: true` 且 `render` 为数组的列追加流程布尔条件
+  - 合并格式：
+    - 原：`#{record.tradeStatus == 25}`
+    - 新：`#{(record.tradeStatus == 25) && (record.__flowAllowedMap['DRP_Sale_Sales_examine'] == true)}`
+
+## 详情页实现
+- 文件：`src/components/Business/DetailPageWrapper/index.tsx`
+- 入口方法（对外）：
+```ts
+processDetailButtonsVisible(buttons: any[], params: any): any[]
+// params: { tradeType: number; fromStatus: number; 以及按钮 visible 表达式使用到的上下文 }
+```
+- 行为：
+  - 求值原 `visible` 表达式为布尔
+  - 仅在传入 `tradeType` 且按钮 `code ∈ controlButtons` 时，叠加“当前 fromStatus 的允许集合”判定
+  - 返回 `visible` 为最终布尔值的按钮数组，直接用于渲染
+
+## 调试日志（列表）
+- 顶部按钮：`[FlowCtrl:top]`、`[FlowCtrl:top-element]`
+- 数据增强：`__flowAllowedMap` 可在表格数据中查看
+- 列合并：最终 `columns` 中的按钮 `visible` 可直接检视字符串是否追加流程条件
+
+## 快速使用示例
+- 设置数据源：
+```js
+localStorage.setItem('BUSINESS_FLOW_BUTTONS', JSON.stringify([
+  {
+    tradeType: 180,
+    controlButtons: ['DRP_Sale_Order_edit'],
+    config: [
+      { fromStatus: 1, buttons: ['DRP_Sale_Order_edit'] },
+      { fromStatus: 25, buttons: [] }
+    ]
+  }
+]));
+```
+- 列表组件传参：
+```tsx
+<BsSulaQueryTable
+  tradeType={180}
+  statusFieldPath="saleInfo.tradeStatus"
+  {...otherProps}
+/>
+```
+- 列权限列按钮（最终 `columns`）：
+  - 原：`visible: '#{record.tradeStatus == 25}'`
+  - 新：内部自动生成为 `#{(record.tradeStatus == 25) && (record.__flowAllowedMap['DRP_Sale_Sales_examine'] == true)}`（仅控制范围内按钮）
+- 详情页使用：
+```ts
+const processed = processDetailButtonsVisible(buttons, { tradeType, fromStatus, viewMode, tradeStatus, detail, orderNo });
+```
+
+## 列表跳转详情（携带查询参数）
+- 示例（销售单）：
+```tsx
+<Button
+  onClick={() => {
+    history.push({
+      pathname: `/sales-management/sales-slip/view/${record.id}/${record.orderNo}`,
+      search: `?fromStatus=${record.saleInfo.tradeStatus}`,
+    });
+  }}
+  type="link"
+>
+  {text}
+</Button>
+```
+- 说明：
+  - 详情页通过查询参数 `fromStatus` 获取当前单据状态；与 `processDetailButtonsVisible` 的 `fromStatus` 对齐
+  - 列表需设置 `statusFieldPath: 'saleInfo.tradeStatus'` 以生成 `__flowAllowedMap`
+  - 建议所有“查看详情”链接统一携带 `fromStatus`，保持列表与详情流程控制的一致性
+
+### 详情页读取 fromStatus 并使用
+```ts
+import { useLocation } from 'umi';
+
+const { search } = useLocation();
+const qs = new URLSearchParams(search);
+const fromStatus = Number(qs.get('fromStatus') || '');
+
+// 与按钮可见性处理对齐
+const processed = processDetailButtonsVisible(buttons, {
+  tradeType: 180,
+  fromStatus,
+  // 其他上下文
+});
+
+// 传入 DetailPageWrapper（如需）
+<DetailPageWrapper
+  actionList={processed}
+  tradeType={180}
+  fromStatus={fromStatus}
+/>;
+```
+
+## 详情页示例（重构）
+两部分：下部按钮数组 + 顶部 DetailPageWrapper 按钮。
+
+1) 下部按钮数组（以部分按钮为例）：
+```ts
+actionsRender: processDetailButtonsVisible([
+  {
+    type: 'button',
+    props: { type: 'primary', children: '提交' },
+    code: 'DRP_Sale_Sales_submit',
+    visible: viewMode && tradeStatus == 1,
+    confirm: '是否提交该销售单？',
+    action: [ (ctx) => { /* 提交逻辑 */ } ],
+  },
+  {
+    type: 'button',
+    props: { type: 'primary', children: '驳回' },
+    code: 'DRP_Sale_Sales_back',
+    visible: viewMode && tradeStatus == 25,
+    confirm: '确认驳回 ？',
+    action: [ { url: `/drp-ops/new/tradeSubOrder/trigger?code=${orderNo}&event=7`, method: 'POST', converter: () => { message.success('驳回成功'); refreshForm(); } } ],
+  },
+  {
+    type: 'button',
+    props: { type: 'primary', children: '审核' },
+    code: 'DRP_Sale_Sales_examine',
+    visible: viewMode && tradeStatus == 25,
+    action: [ (ctx) => onAuditing(detail) ],
+  },
+  // ... 其他按钮
+], {
+  tradeType: 180,
+  fromStatus: tradeStatus,
+  viewMode,
+  tradeStatus,
+  detail,
+  orderNo,
+  modeType,
+  isProcessing,
+  hasDeletedOnce,
+})
+```
+
+2) 顶部 DetailPageWrapper 按钮：
+```tsx
+<DetailPageWrapper
+  title="详情页演示"
+  actionList={processDetailButtonsVisible(topButtons, { tradeType, fromStatus: tradeStatus, viewMode, tradeStatus })}
+  tradeType={180}
+  fromStatus={tradeStatus}
+/>
+```
+
+## 参数说明
+- 列表组件：
+  - `tradeType: number`（必须）
+  - `statusFieldPath: string`（可选，嵌套路径，如 `saleInfo.tradeStatus`）
+- 详情方法 `processDetailButtonsVisible(buttons, params)`：
+  - `params.tradeType: number`（必须）
+  - `params.fromStatus: number`（必须）
+  - 其他上下文：`viewMode`、`tradeStatus`、`detail`、`orderNo`、`modeType`、`isProcessing`、`hasDeletedOnce` 等按需传入
+- visible 格式：
+  - 字符串表达式：`'#{viewMode && tradeStatus == 25}'`
+  - 布尔或未定义：`true/false/undefined`（未定义视为 `true`）
+
+## tradeType 映射
+- 180：销售单
+- 可按业务扩展其他类型（在 `BUSINESS_FLOW_BUTTONS` 中新增对应项）
+
+## 初始化数据结构示例
+```js
+const flowConfig = [
+  {
+    tradeType: 180,
+    controlButtons: ['DRP_Sale_Order_edit'],
+    config: [
+      { fromStatus: 1, buttons: ['DRP_Sale_Order_edit'] },
+      { fromStatus: 25, buttons: [] },
+    ],
+  },
+];
+localStorage.setItem('BUSINESS_FLOW_BUTTONS', JSON.stringify(flowConfig));
+```
+
+### 详情页示例（重构）
+两部分：下部按钮数组 + 顶部 DetailPageWrapper 按钮。
+
+1) 下部按钮数组（以提交/驳回为例）：
+```ts
+actionsRender: processDetailButtonsVisible([
+  {
+    type: 'button',
+    props: { type: 'primary', children: '提交' },
+    code: 'DRP_Sale_Sales_submit',
+    visible: viewMode && tradeStatus == 1,
+    confirm: '是否提交该销售单？',
+    action: [ (ctx) => { /* 业务处理 */ } ],
+  },
+  {
+    type: 'button',
+    props: { type: 'primary', children: '驳回' },
+    code: 'DRP_Sale_Sales_back',
+    visible: viewMode && tradeStatus == 25,
+    confirm: '确认驳回 ？',
+    action: [ { url: `/drp-ops/new/tradeSubOrder/trigger?code=${orderNo}&event=7`, method: 'POST', converter: () => { message.success('驳回成功'); refreshForm(); } } ],
+  },
+  // ... 其他按钮
+], {
+  tradeType: 180,
+  fromStatus: tradeStatus,
+  viewMode,
+  tradeStatus,
+  detail,
+  orderNo,
+  modeType,
+  isProcessing,
+  hasDeletedOnce,
+})
+```
+
+2) 顶部 DetailPageWrapper 按钮（保持原传参方式）：
+```tsx
+<DetailPageWrapper
+  title="详情页演示"
+  actionList={processDetailButtonsVisible(topButtons, { tradeType, fromStatus: tradeStatus, viewMode, tradeStatus })}
+  tradeType={180}
+  fromStatus={tradeStatus}
+/>
+```
+
+## 常见问题
+- 按钮未展示且不在控制范围：流程控制不会影响非控制按钮，请确认是否是权限或原 `visible` 条件拦截
+- 顶部按钮未展示：仅在控制范围内按“所有状态允许集合”过滤；不在控制范围的顶栏按钮不受影响
+- 未传 `tradeType`：不会执行任何流程控制（顶栏/列表/详情均一致）
+
+## 变更范围
+- 列表：`BsSulaQueryTable/index.tsx`（convert增强、columns合并、顶部过滤与保护）
+- 详情：`DetailPageWrapper/index.tsx`（流程过滤保护）与 `processDetailButtonsVisible` 方法导出

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bit-sun/business-component",
-  "version": "4.2.0-alpha.7",
+  "version": "4.2.0-alpha.8",
   "scripts": {
     "start": "dumi dev",
     "docs:build": "dumi build",

package/src/components/Solution/RuleComponent/RenderCompItem_README.md

@@ -0,0 +1,189 @@
+# RenderCompItem 组件说明文档
+
+`RenderCompItem` 是一个通用的表单控件渲染组件，它根据传入的配置对象 (`ites`) 动态渲染不同类型的 Ant Design 表单组件或业务封装组件。
+
+## 1. 组件引入
+
+```typescript
+import RenderCompItem from '@/components/Solution/RuleComponent/RenderCompItem';
+```
+
+## 2. Props 参数说明
+
+| 参数名 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `ites` | `object` | 是 | 核心配置对象，决定渲染什么组件（见下文详解） |
+| `showValue` | `(code: string, type?: string) => any` | 是 | 获取组件当前值的回调函数 |
+| `handleEdit` | `(code: string, value: any) => void` | 是 | 组件值发生变化时的回调函数 |
+| `disabled` | `boolean` | 否 | 是否禁用组件 |
+| `regularDataList` | `array` | 否 | 用于表达式 (`Formula`) 组件的数据源列表 |
+| `others` | `object` | 否 | 扩展属性（目前主要用于 `CustomSelector` 的配置，**注意：源码中可能未正确解构此参数，使用自定义选择器时需检查**） |
+
+## 3. `ites` 配置详解
+
+`ites` 对象通过 `inputType`、`valueType` 和 `choiceType` 的组合来决定渲染的具体组件。
+
+### 3.1 基础输入类 (`inputType: 10`)
+
+当 `inputType` 为 `10` 时，根据 `valueType` 区分：
+
+| valueType | 组件类型 | 说明 | 对应 Antd 组件 |
+| --- | --- | --- | --- |
+| `21` | 文本输入 | 默认字符串输入 | `Input` |
+| `22` | 小数输入 | 保留2位小数 | `InputNumber` |
+| `23` | 整数输入 | 整数，无小数 | `InputNumber` |
+| `24` | 布尔开关 | Switch 开关 | `Switch` |
+| `32` | 日期时间 | 选择日期和时间 | `DatePicker` (showTime) |
+| `40` | 时间范围 | 选择时间范围 | `RangePicker` (showTime) |
+| `41` | 日期 | 仅选择日期 | `DatePicker` |
+
+### 3.2 选择类 (`inputType: 20 | 30`)
+
+*   `inputType: 20`: 单选
+*   `inputType: 30`: 多选
+
+根据 `choiceType` 区分具体业务组件：
+
+| choiceType | 组件类型 | 说明 | 数据源/依赖 |
+| --- | --- | --- | --- |
+| `10` | 枚举选择 | 静态选项 | 需提供 `ites.enumeration` 对象 (key-value) |
+| `20` | 数据字典 | 字典选择 | 需提供 `ites.dictionaryCode` |
+| `110` | 物理仓 | 业务选择器 | `BusinessSearchSelect` (physicalWarehouse) |
+| `120` | 逻辑仓 | 业务选择器 | `BusinessSearchSelect` (realWarehouse) |
+| `130` | 虚拟仓 | 业务选择器 | `BusinessSearchSelect` (virtualWarehouse) |
+| `140` | 渠道仓 | 业务选择器 | `BusinessSearchSelect` (channelWarehouse) |
+| `150` | SPU | 业务选择器 | `BusinessSearchSelect` (spuCommodity) |
+| `160` | SKU | 业务选择器 | `BusinessSearchSelect` (skuCommodity) |
+| `190` | 省市区 | 级联选择 | `BsCascader` |
+| `210` | 行政组织 | 树形选择 | `BusinessTreeSearchSelect` (department) |
+| `220` | 采购组织 | 树形选择 | `BusinessTreeSearchSelect` (purchase-organization) |
+| `230` | 销售组织 | 树形选择 | `BusinessTreeSearchSelect` (sales-organization) |
+| `240` | 供应商 | 业务选择器 | `BusinessSearchSelect` (supplier2) |
+| `250` | 客户 | 业务选择器 | `BusinessSearchSelect` (customer2) |
+| `260` | 店铺 | 业务选择器 | `BusinessSearchSelect` (shopFile2) |
+| `270` | 员工 | 业务选择器 | `BusinessSearchSelect` (employee2) |
+| `280` | 库存组织 | 树形选择 | `BusinessTreeSearchSelect` (stock-organization) |
+| `290` | 结算组织 | 树形选择 | `BusinessTreeSearchSelect` (settle-organization) |
+| `310` / `311`| 配送方式 | 业务选择器 | `BusinessSearchSelect` (deliveryMode) |
+| `360` | 角色 | 业务选择器 | `BusinessSearchSelect` (role) |
+| `410` | 品牌 | 业务选择器 | `BusinessSearchSelect` (brand) |
+| `420` | 类目 | 树形选择 | `BusinessTreeSearchSelect` (background-category) |
+| `40` | 自定义 | 自定义组件 | `CustomSelector` (依赖 `others.customSelectorConfig`) |
+
+### 3.3 表达式 (`inputType: 40`)
+
+渲染 `Formula` 组件，用于配置计算公式。依赖 `regularDataList` 作为变量源。
+
+## 4. 使用示例
+
+```tsx
+import React, { useState } from 'react';
+import RenderCompItem from './RenderCompItem';
+
+const Demo = () => {
+  const [formData, setFormData] = useState<any>({});
+
+  // 模拟数据回显
+  const showValue = (code: string) => {
+    return formData[code];
+  };
+
+  // 模拟数据更新
+  const handleEdit = (code: string, value: any) => {
+    console.log('Update:', code, value);
+    setFormData((prev: any) => ({ ...prev, [code]: value }));
+  };
+
+  // 配置项示例：文本输入
+  const inputConfig = {
+    code: 'userName',
+    inputType: 10,
+    valueType: 21,
+    defaultValue: '张三'
+  };
+
+  // 配置项示例：静态下拉选择
+  const selectConfig = {
+    code: 'status',
+    inputType: 20, // 单选
+    choiceType: 10, // 枚举
+    enumeration: {
+      '1': '启用',
+      '0': '禁用'
+    }
+  };
+
+  // 配置项示例：SKU 选择器 (多选)
+  const skuSelectConfig = {
+    code: 'skuCodes',
+    inputType: 30, // 多选
+    choiceType: 160, // SKU 选择器
+  };
+
+  // 配置项示例：数据字典选择 (单选)
+  const dictSelectConfig = {
+    code: 'warehouseType',
+    inputType: 20, // 单选
+    choiceType: 20, // 数据字典
+    dictionaryCode: 'SC0001' // 传入字典编码，组件会自动请求接口获取字典数据
+  };
+
+  return (
+    <div>
+      <div style={{ marginBottom: 20 }}>
+        <label>用户名：</label>
+        <RenderCompItem
+          ites={inputConfig}
+          showValue={showValue}
+          handleEdit={handleEdit}
+          regularDataList={[]}
+        />
+      </div>
+
+      <div style={{ marginBottom: 20 }}>
+        <label>状态：</label>
+        <RenderCompItem
+          ites={selectConfig}
+          showValue={showValue}
+          handleEdit={handleEdit}
+          regularDataList={[]}
+        />
+      </div>
+
+      <div style={{ marginBottom: 20 }}>
+        <label>商品SKU：</label>
+        <RenderCompItem
+          ites={skuSelectConfig}
+          showValue={showValue}
+          handleEdit={handleEdit}
+          regularDataList={[]}
+        />
+      </div>
+
+      <div>
+        <label>仓库类型(数据字典)：</label>
+        <RenderCompItem
+          ites={dictSelectConfig}
+          showValue={showValue}
+          handleEdit={handleEdit}
+          regularDataList={[]}
+        />
+      </div>
+    </div>
+  );
+};
+
+export default Demo;
+```
+
+## 5. 依赖说明
+
+该组件依赖以下项目内部组件和库：
+*   `antd`
+*   `bssula` (request)
+*   `@/components/Functional/BsAntdSula` (BsCascader)
+*   `@/index` (BusinessSearchSelect, BusinessTreeSearchSelect)
+*   内部组件: `./Formula`, `./InnerSelect`, `./CustomPlugin/CustomSelector`
+*   工具函数: `../../../utils/utils`
+
+使用前请确保相关依赖已安装且路径正确。

package/src/index.ts

@@ -43,6 +43,7 @@ export { default as EllipsisTooltip} from './components/Functional/EllipsisToolt
 export * from './components/Functional/BsAntdSula/index';
 export { default as RuleComponent} from './components/Solution/RuleComponent';
 export { default as RuleSetter} from './components/Solution/RuleSetter';
+export { default as RenderCompItem} from './components/Solution/RuleComponent/RenderCompItem';
 
 export { processDetailButtonsVisible as processDetailButtonsVisible } from './components/Business/DetailPageWrapper';