neo-cmp-cli 1.13.17 → 1.13.18

package/template/neo-pipeline-cmps/src/components/simpleTable__c/README.md

@@ -1,39 +1,39 @@
-# XObject 数据表格组件（简化版）
+# XObject Data Table Component (Simplified)
 
-基于 XObject 的数据表格组件，仅支持数据展示，表格列根据 `xObject.getDesc` 返回的 fields 动态生成。
-备注：使用 Neo Open API SDK（neo-open-api） 提供的方法实现数据对象的查询操作。
+An XObject-based data table component that only supports data display. Table columns are dynamically generated based on fields returned by `xObject.getDesc`.
+Note: Uses methods provided by the Neo Open API SDK (neo-open-api) to implement data object query operations.
 
-## 功能特性
+## Features
 
-- 📊 **动态表格列**：根据 XObject 字段描述自动生成表格列
-- 🔍 **数据展示**：支持展示 XObject 实体数据
-- 🎨 **响应式设计**：适配不同屏幕尺寸
-- ⚙️ **属性配置**：支持通过编辑器配置组件属性
+- **Dynamic Table Columns**: Automatically generates table columns based on XObject field descriptions
+- **Data Display**: Supports displaying XObject entity data
+- **Responsive Design**: Adapts to different screen sizes
+- **Property Configuration**: Supports configuring component properties through the editor
 
-## 组件属性
+## Component Properties
 
-| 属性名 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| title | string | '数据表格' | 表格标题 |
-| xObjectDataApi | object | - | 实体数据源配置 |
-| xObjectDataApi.xObjectApiKey | string | '' | 数据对象的 API Key |
-| xObjectDataApi.fields | string[] | [] | 要显示的字段列表 |
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| title | string | 'Data Table' | Table title |
+| xObjectDataApi | object | - | Entity data source configuration |
+| xObjectDataApi.xObjectApiKey | string | '' | Data object API Key |
+| xObjectDataApi.fields | string[] | [] | List of fields to display |
 
-## 使用方法
+## Usage
 
-### 1. 在编辑器中使用
+### 1. Using in the Editor
 
-1. 从组件面板拖拽 "实体数据表格（简化版）" 组件到页面
-2. 在右侧属性面板中选择要操作的数据对象
-3. 配置要显示的字段（可选）
-4. 保存并预览
+1. Drag the "Entity Data Table (Simplified)" component from the component panel to the page
+2. Select the data object to operate on in the right property panel
+3. Configure the fields to display (optional)
+4. Save and preview
 
-### 2. 代码中使用
+### 2. Using in Code
 
 ```tsx
 import SimpleTable from './components/simpleTable__c';
 
-// 使用组件
+// Use the component
 <SimpleTable
   xObjectDataApi={{
     xObjectApiKey: 'customContact__c',
@@ -42,49 +42,48 @@ import SimpleTable from './components/simpleTable__c';
 />
 ```
 
-## 技术实现
+## Technical Implementation
 
-### 核心依赖
+### Core Dependencies
 
-- **Ant Design**：UI 组件库
-- **React**：前端框架
-- **TypeScript**：类型支持
+- **Ant Design**: UI component library
+- **React**: Frontend framework
+- **TypeScript**: Type support
 
-### 数据流程
+### Data Flow
 
-1. **初始化**：组件挂载时获取字段描述
-2. **列生成**：根据字段描述动态生成表格列
-3. **数据加载**：使用 `xObject.query` 获取数据列表
+1. **Initialization**: Fetches field descriptions when the component mounts
+2. **Column Generation**: Dynamically generates table columns based on field descriptions
+3. **Data Loading**: Uses `xObject.query` to fetch data list
 
-## 样式定制
+## Style Customization
 
-组件提供了完整的 SCSS 样式文件，支持以下定制：
+The component provides complete SCSS style files, supporting the following customizations:
 
-- 表格样式（边框、悬停效果等）
-- 响应式设计（移动端适配）
+- Table styles (borders, hover effects, etc.)
+- Responsive design (mobile adaptation)
 
-## 注意事项
+## Notes
 
-1. **权限要求**：确保用户有对应 XObject 的读取权限
-2. **字段类型**：支持所有基础字段类型的展示
-3. **错误处理**：组件内置了完善的错误处理和用户提示
+1. **Permission Requirements**: Ensure the user has read access to the corresponding XObject
+2. **Field Types**: Supports display of all basic field types
+3. **Error Handling**: The component has built-in comprehensive error handling and user prompts
 
-## 与完整版组件的区别
+## Differences from Full Version
 
-本简化版组件相比完整版 `entityTable__c` 组件：
+This simplified version compared to the full `entityTable__c` component:
 
-- ❌ **不支持新增**：移除了新增记录功能
-- ❌ **不支持编辑**：移除了编辑记录功能
-- ❌ **不支持删除**：移除了删除记录功能
-- ❌ **不支持刷新**：移除了手动刷新按钮
-- ❌ **不支持分页**：移除了分页功能，显示所有数据
-- ✅ **仅支持展示**：专注于数据展示功能
+- **No Create**: Removed record creation functionality
+- **No Edit**: Removed record editing functionality
+- **No Delete**: Removed record deletion functionality
+- **No Refresh**: Removed manual refresh button
+- **No Pagination**: Removed pagination, displays all data
+- **Display Only**: Focused on data display functionality
 
-## 扩展开发
+## Extension Development
 
-如需扩展功能，可以：
-
-1. **添加字段类型支持**：在 `generateColumns()` 方法中添加字段格式化逻辑
-2. **自定义样式**：修改 `style.scss` 文件定制组件外观
-3. **添加排序功能**：扩展表格功能支持列排序
+To extend functionality, you can:
 
+1. **Add Field Type Support**: Add field formatting logic in the `generateColumns()` method
+2. **Custom Styles**: Modify the `style.scss` file to customize component appearance
+3. **Add Sorting**: Extend table functionality to support column sorting

package/template/neo-pipeline-cmps/src/components/simpleTable__c/common.scss

@@ -1,13 +1,13 @@
-// css变量
+// CSS variables
 :root {
   --background-color: #f5f6fa;
 }
 
-// sass变量
+// SASS variables
 $background-color: #f5f6fa;
-// 自定义公共样式
+// Custom common styles
 
-/* AI Win Rate：hover 卡片（对齐 demo.html #winRateTooltip） */
+/* AI Win Rate: hover card (aligned with demo.html #winRateTooltip) */
 .simpleTable-winrate-trigger {
   cursor: pointer;
   border: none !important;
@@ -31,7 +31,7 @@ $background-color: #f5f6fa;
   }
 }
 
-/* 健康度列 hover：内嵌 showHealthResult__c */
+/* Health score column hover: embedded showHealthResult__c */
 .simpleTable-health-popover-trigger {
   cursor: pointer;
   display: inline-block;

package/template/neo-pipeline-cmps/src/components/simpleTable__c/index.tsx

@@ -1,6 +1,6 @@
 /**
- * @file XObject 数据表格组件（简化版）
- * @description 基于 Neo 平台的 XObject 实体对象数据表格组件，仅支持数据展示
+ * @file XObject data table component (simplified version)
+ * @description XObject entity data table component based on the Neo platform, supports data display only
  */
 import * as React from 'react';
 import { Table, Spin, Empty, Popover } from 'antd';
@@ -9,11 +9,11 @@ import { xObject } from 'neo-open-api'; // Neo Open API
 // @ts-ignore
 import isEqual from 'lodash/isEqual';
 
-// Neo Open API// 引入 neo-ui-common / BaseCmp
+// Neo Open API// Import neo-ui-common / BaseCmp
 // @ts-ignore
 import { BaseCmp } from 'neo-ui-common';
 
-// 引入 neo-ui-common / NeoEvent
+// Import neo-ui-common / NeoEvent
 // @ts-ignore
 import { NeoEvent } from 'neo-ui-common';
 
@@ -51,7 +51,7 @@ import './style.scss';
 
 export type { HistoryOppSnap } from '../../utils/simpleTable';
 
-/** 商机详情页 hash 路由（与平台 neoweb 一致） */
+/** Opportunity detail page hash route (consistent with platform neoweb) */
 function buildOpportunityDetailUrl(id: string, objectApiKey: string): string {
   const q = new URLSearchParams({
     objectApiKey,
@@ -60,7 +60,7 @@ function buildOpportunityDetailUrl(id: string, objectApiKey: string): string {
   return `/bff/neoweb#/entityDetail/opportunity/${id}?${q.toString()}`;
 }
 
-/** 不在表格中展示的字段（仍可通过 xObjectDataApi.fields 拉取，用于 hover 卡片 / tooltip） */
+/** Fields not displayed in the table (can still be fetched via xObjectDataApi.fields, used for hover cards / tooltips) */
 const HIDDEN_TABLE_COLUMN_KEYS = new Set([
   'customItem244__c',
   'customItem241__c',
@@ -68,15 +68,15 @@ const HIDDEN_TABLE_COLUMN_KEYS = new Set([
   'customItem246__c',
   'customItem247__c',
   'customItem245__c',
-  // 'objectId', // 跳转到详情页需要
-  // 'businessTypeId' // 跳转到详情页需要
+  // 'objectId', // Needed for navigating to detail page
+  // 'businessTypeId' // Needed for navigating to detail page
 ]);
 
-/** 历史商机 SQL 与 stageSwitch 一致；字段顺序需与 query fields 一致（数组行按列下标解析） */
+/** Historical opportunity SQL consistent with stageSwitch; field order must match query fields (array rows parsed by column index) */
 const HISTORY_OPPORTUNITY_BI_KEY = 'biCustomModel_397169_20260401104916618';
 const HISTORY_QUERY_FIELDS = [
-  // 'id', // 历史版本ID
-  'opportunity_1__id', // 商机ID
+  // 'id', // Historical version ID
+  'opportunity_1__id', // Opportunity ID
   'opportunity_1_closeDate',
   'opportunity_1_opportunityName',
   'opportunity_1_saleStageId',
@@ -86,76 +86,76 @@ const HISTORY_QUERY_FIELDS = [
 const defaultXObjectDataApi = {
   xObjectApiKey: 'opportunity',
   fields: [
-    'opportunityName', // OpportunityStageName 商机名称
+    'opportunityName', // OpportunityStageName Opportunity Name
     'money', // Amount
     'closeDate', // Close Date
     'customItem248__c', // Stage
     // 'oppHealthAssessmentScore',
     'recentActivityRecordTime',
-    'oppHealthAssessmentLevel', // 1.AI Score; hover卡片：调用商机健康度接口
-    'customItem239__c', // 2.AI Win Rate: hover卡片展示的3个信息，对应商机上的3个字段（baseline、positiveFactors、negativeFactors）
+    'oppHealthAssessmentLevel', // 1.AI Score; hover card: calls opportunity health assessment API
+    'customItem239__c', // 2.AI Win Rate: 3 fields shown in hover card (baseline, positiveFactors, negativeFactors)
     'customItem244__c', // baseline
     'customItem241__c', // positiveFactors
     'customItem242__c', // negativeFactors
     'customItem246__c', // AmoutChanged
     'customItem247__c', // ClosedDateChanged
     'customItem245__c', // StageChanged
-    // 'objectId', // 跳转到详情页需要
-    // 'businessTypeId' // 跳转到详情页需要
+    // 'objectId', // Needed for navigating to detail page
+    // 'businessTypeId' // Needed for navigating to detail page
   ],
   page: 1,
   pageSize: 50,
 };
 /**
- * 组件属性接口
+ * Component props interface
  */
 interface SimpleTableProps {
-  /** XObject 实体对象的 API Key，用于标识要操作的数据对象 */
+  /** XObject entity API Key, used to identify the data object to operate on */
   xObjectDataApi: {
     xObjectApiKey: string;
     fields: string[];
     fieldDescList?: any[];
     autoFetchData?: boolean;
   };
-  /** Neo 平台传递的数据，包含系统信息等 */
+  /** Neo platform data, including system information */
   data?: any;
-  entityData?: any; // Neo 平台自动获取的实体数据
-  /** 是否为自定义实体对象 */
+  entityData?: any; // Entity data automatically fetched by Neo platform
+  /** Whether it is a custom entity object */
   custom?: boolean;
-  /** 组件类名 */
+  /** Component class name */
   className?: string;
-  /** 表格标题，优先使用此配置 */
+  /** Table title, takes priority */
   title?: string;
-  /** 标题下方说明文案 */
+  /** Description text below the title */
   description?: string;
-  /** 当前激活的销售阶段 */
+  /** Currently active sales stage */
   activeStage?: string;
 }
 
 /**
- * 组件状态接口
+ * Component state interface
  */
 interface SimpleTableState {
-  /** 表格标题 */
+  /** Table title */
   title?: string;
   fieldList: FieldInfo[];
-  /** 表格数据源 */
+  /** Table data source */
   dataSource: any[];
-  /** 加载状态 */
+  /** Loading state */
   loading: boolean;
-  /** 错误信息 */
+  /** Error message */
   error: string | null;
-  activeStage: string; // 当前激活的销售阶段
+  activeStage: string; // Currently active sales stage
   /**
-   * 与 FilterBar 事件 payload 一致（closeDateCustomRange / opportunityOwner / businessType 等）；
-   * 默认值为 defaultFilter，getFilterWhere 仅从中取值
+   * Consistent with FilterBar event payload (closeDateCustomRange / opportunityOwner / businessType, etc.);
+   * Default value is defaultFilter, getFilterWhere only reads from it
    */
   filter: any;
 }
 
 /**
- * XObject 数据表格组件（简化版）
- * 仅支持数据展示，不支持增删改查操作
+ * XObject data table component (simplified version)
+ * Supports data display only, does not support CRUD operations
  */
 export default class SimpleTable extends BaseCmp<
   SimpleTableProps,
@@ -164,7 +164,7 @@ export default class SimpleTable extends BaseCmp<
   constructor(props: SimpleTableProps) {
     super(props);
 
-    // 初始化组件状态
+    // Initialize component state
     this.state = {
       fieldList: [],
       dataSource: [],
@@ -190,38 +190,38 @@ export default class SimpleTable extends BaseCmp<
     const { xObjectApiKey } = defaultXObjectDataApi;
 
     if (xObjectApiKey) {
-      // 初始化字段列表、加载数据
+      // Initialize field list and load data
       this.loadFieldList();
       this.loadData();
     }
 
     /*
-    // 广播事件：更新 FilterBar filter
+    // Broadcast event: update FilterBar filter
     NeoEvent.listen('updateFilterData', (filterData: any) => {
-      console.log('SimpleTable 监听到了一个广播事件 updateFilterData: ', filterData);
+      console.log('SimpleTable received a broadcast event updateFilterData: ', filterData);
       this.setFilter(filterData);
     });
 
-    // 广播事件：更新当前激活的销售阶段
+    // Broadcast event: update the currently active sales stage
     NeoEvent.listen('updateActiveStage', (activeStage: string) => {
-      console.log('SimpleTable 监听到了一个广播事件 updateActiveStage: ', activeStage);
+      console.log('SimpleTable received a broadcast event updateActiveStage: ', activeStage);
       this.updateActiveStage(activeStage);
     });
     */
   }
 
   /**
-   * 加载字段列表
-   * 从 Neo 平台获取 XObject 的字段描述信息
+   * Load field list
+   * Fetch XObject field description information from the Neo platform
    */
   async loadFieldList() {
     const xObjectDataApi: any = defaultXObjectDataApi;
 
-    // 方式一：直接从 props.xObjectDetailApi 中获取字段描述
+    // Method 1: Get field descriptions directly from props.xObjectDetailApi
     if (xObjectDataApi && xObjectDataApi.fieldDescList) {
       this.setState({ fieldList: xObjectDataApi.fieldDescList });
     } else {
-      // 方式二：自行通过 OpenAPI SDK 获取字段描述
+      // Method 2: Fetch field descriptions via OpenAPI SDK
       if (!xObjectDataApi.xObjectApiKey) return;
       try {
         const resultData = await xObject.getDesc(xObjectDataApi.xObjectApiKey);
@@ -231,13 +231,13 @@ export default class SimpleTable extends BaseCmp<
           this.setState({ fieldList, title: result.label });
         }
       } catch (error) {
-        console.error('获取字段列表失败:', error);
+        console.error('Failed to get field list:', error);
       }
     }
   }
 
   /**
-   * 当前表格可见字段列表（与列配置一致）
+   * Current visible field list for the table (consistent with column configuration)
    */
   getCurFieldList(): FieldInfo[] {
     // const { xObjectDataApi } = this.props;
@@ -256,7 +256,7 @@ export default class SimpleTable extends BaseCmp<
   }
 
   /**
-   * 汇总用金额字段 apiKey（与金额列一致，取第一个货币字段）
+   * Money field apiKey for summary (consistent with the money column, takes the first currency field)
    */
   getMoneyFieldApiKey(): string | null {
     const moneyField = this.getCurFieldList().find((f) => isMoneyField(f));
@@ -264,8 +264,8 @@ export default class SimpleTable extends BaseCmp<
   }
 
   /**
-   * 生成表格列配置
-   * @returns 表格列配置数组
+   * Generate table column configuration
+   * @returns Array of table column configurations
    */
   generateColumns() {
     const xObjectDataApi: any = defaultXObjectDataApi;
@@ -274,7 +274,7 @@ export default class SimpleTable extends BaseCmp<
       (field) => !HIDDEN_TABLE_COLUMN_KEYS.has(field.apiKey),
     );
 
-    // 根据字段列表生成基础列配置
+    // Generate base column configuration from field list
     const columns: any[] = curFieldList.map((field) => {
       const col: any = {
         title: field.label,
@@ -396,7 +396,7 @@ export default class SimpleTable extends BaseCmp<
   }
 
   /**
-   * 将 FilterBar 结构 filter 转为 xObject.√ 的 where 字符串数组（与 stageSwitch 一致，SDK 按顺序 and 拼接）
+   * Convert FilterBar structured filter to xObject.query where string array (consistent with stageSwitch, SDK concatenates with AND in order)
    */
   getFilterWhere(): string[] {
     const raw = this.state.filter;
@@ -424,9 +424,9 @@ export default class SimpleTable extends BaseCmp<
     }
 
     /*
-    // 如果 activeStage 存在，则添加 stage 过滤条件
+    // If activeStage exists, add stage filter condition
     if (this.state.activeStage) {
-      // customItem248__c 是销售阶段字段
+      // customItem248__c is the sales stage field
       where.push(`customItem248__c = '${this.state.activeStage}'`);
     }
     */
@@ -434,9 +434,11 @@ export default class SimpleTable extends BaseCmp<
     return where;
   }
 
-  /** 与 stageSwitch一致：历史商机自定义 SQL 的 where（opportunity_1_* 字段） */
+  /** Consistent with stageSwitch: historical opportunity custom SQL where (opportunity_1_* fields) */
   getHistoryOpportunityQueryFilter(): string[] {
     const raw = this.state.filter;
+    const defaultFilter = getDefaultFilterByProps(this.props);
+
     const curFilter: Record<string, unknown> =
       raw && typeof raw === 'object' && !Array.isArray(raw)
         ? Object.keys(raw as object).length > 0
@@ -472,7 +474,7 @@ export default class SimpleTable extends BaseCmp<
     return where;
   }
 
-  /** 查询期间初历史商机列表（与 stageSwitch.fetchHistoryOpportunityList 同源，字段按需求扩展） */
+  /** Query historical opportunity list for the period (same source as stageSwitch.fetchHistoryOpportunityList, fields extended as needed) */
   async fetchHistoryOpportunityList(): Promise<unknown[]> {
     const result = await queryByCustomSQL({
       xObjectApiKey: HISTORY_OPPORTUNITY_BI_KEY,
@@ -486,7 +488,7 @@ export default class SimpleTable extends BaseCmp<
   }
 
   /**
-   * 加载表格数据
+   * Load table data
    */
   @NeoEvent.function
   async loadData() {
@@ -519,7 +521,7 @@ export default class SimpleTable extends BaseCmp<
 
         console.log('[SimpleTable__c] records:', records, historyRows);
 
-        // 根据阶段过滤数据
+        // Filter data by stage
         if (this.state.activeStage) {
           records = records.filter((record: any) => {
             return record.customItem248__c === this.state.activeStage;
@@ -543,20 +545,20 @@ export default class SimpleTable extends BaseCmp<
         });
       } else {
         this.setState({
-          error: result?.msg || '获取数据失败',
+          error: result?.msg || 'Failed to fetch data',
           loading: false,
         });
       }
     } catch (error: any) {
       this.setState({
-        error: error.message || '获取数据失败',
+        error: error.message || 'Failed to fetch data',
         loading: false,
       });
     }
   }
 
   /**
-   * 与 stageSwitch 一致：更新 FilterBar filter 并重新拉取表格数据。
+   * Consistent with stageSwitch: update FilterBar filter and re-fetch table data.
    */
   @NeoEvent.function
   setFilter(filter?: any) {
@@ -570,7 +572,7 @@ export default class SimpleTable extends BaseCmp<
   }
 
   /**
-   * 更新当前激活的销售阶段
+   * Update the currently active sales stage
    */
   @NeoEvent.function
   updateActiveStage(activeStage?: string) {
@@ -584,8 +586,8 @@ export default class SimpleTable extends BaseCmp<
   }
 
   /**
-   * 渲染组件
-   * @returns 组件 JSX 元素
+   * Render component
+   * @returns Component JSX element
    */
   render() {
     const { title: stateTitle, dataSource, loading, error } = this.state;
@@ -594,8 +596,8 @@ export default class SimpleTable extends BaseCmp<
     const { xObjectApiKey } = defaultXObjectDataApi;
     const columns = this.generateColumns();
 
-    // 优先使用 props.title，其次使用 state.title，最后使用默认值
-    const displayTitle = propsTitle || stateTitle || '数据表格';
+    // Use props.title first, then state.title, and finally the default value
+    const displayTitle = propsTitle || stateTitle || 'Data Table';
 
     const moneyKey = this.getMoneyFieldApiKey();
     const totalAmount = moneyKey ? sumMoneyRows(dataSource, moneyKey) : 0;
@@ -613,7 +615,7 @@ export default class SimpleTable extends BaseCmp<
     );
 
     return (
-      <div className={`simpleTable__c ${className}`} data-time="2026.4.15 01">
+      <div className={`simpleTable__c ${className}`} data-time="2026.4.17 01">
         <div className="table-wrapper">
           <div className="panel-header">
             <div className="panel-header-text">
@@ -634,7 +636,7 @@ export default class SimpleTable extends BaseCmp<
             </div>
           </div>
           <div className="table-container">
-            <Spin spinning={loading} tip="加载数据中...">
+            <Spin spinning={loading} tip="Loading data...">
               {error ? (
                 <Empty
                   image={Empty.PRESENTED_IMAGE_SIMPLE}