neo-cmp-cli 1.13.17 → 1.13.19

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}

package/template/neo-pipeline-cmps/src/components/simpleTable__c/model.ts

@@ -1,72 +1,72 @@
 /**
- * @file XObject 表格组件对接编辑器的描述文件（简化版）
- * @description 定义组件在 Neo 平台编辑器中的配置信息
+ * @file XObject table component editor descriptor file (simplified version)
+ * @description Defines the component configuration for the Neo platform editor
  * @author Neo Custom Widget CLI
  * @version 1.0.0
  */
 export class SimpleTableModel {
   /**
-   * 组件类型标识
-   * 用于标识组件的唯一性，在构建时根据当前组件目录名称自动生成
-   * 注意：此字段在构建时会被自动替换，不需要手动设置
+   * Component type identifier
+   * Used to uniquely identify the component; automatically generated from the current component directory name during build
+   * Note: This field is automatically replaced during build and does not need to be set manually
    */
   // cmpType: string = 'simpleTable';
 
-  /** 组件名称，用于设置在编辑器左侧组件面板中展示的名称 */
-  label: string = '商机列表';
+  /** Component name, displayed in the editor's left component panel */
+  label: string = 'Opportunity List';
 
-  /** 组件描述，用于设置在编辑器左侧组件面板中展示的描述 */
+  /** Component description, displayed in the editor's left component panel */
   description: string =
-    '基于 XObject 的数据表格组件，仅支持数据展示，不支持增删改查操作';
+    'Data table component based on XObject, supports data display only, does not support CRUD operations';
 
-  /** 分类标签，用于设置在编辑器左侧组件面板哪个分类中展示  */
-  // tags: string[] = ['自定义组件'];
+  /** Category tags, determines which category the component appears under in the editor's left component panel */
+  // tags: string[] = ['Custom Components'];
 
-  /** 组件图标，用于设置在编辑器左侧组件面板中展示的图标 */
+  /** Component icon, displayed in the editor's left component panel */
   iconUrl: string = 'https://custom-widgets.bj.bcebos.com/table.svg';
 
   /**
-   * 用于设置组件支持的页面类型
+   * Sets the page types supported by the component
    *
-   * 当前 NeoCRM 平台存在的页面类型：
-   * all:	1	全页面
-   * entityFormPage:	4	实体表单页
-   * customPage:	6	自定义页面
+   * Page types available in the current NeoCRM platform:
+   * all:	1	All pages
+   * entityFormPage:	4	Entity form page
+   * customPage:	6	Custom page
    */
   targetPage: string[] = ['all'];
 
   /**
-   * 用于设置组件支持的终端类型
+   * Sets the device types supported by the component
    *
-   * 当前 NeoCRM 平台存在的终端类型：
-   * web:	网页端
-   * mobile: 移动端
+   * Device types available in the current NeoCRM platform:
+   * web:	Web
+   * mobile: Mobile
    */
   targetDevice: string = 'web';
 
-  /** 初次插入页面的默认属性数据 */
+  /** Default property data when first inserted into a page */
   defaultComProps = {
     title: 'Opportunity List',
     activeStage: 'Prospecting',
     description: 'Filtered by Close Date, Opportunity Owner, Business Type',
   };
 
-  // 当前组件支持的函数列表（其他组件可触发当前组件的函数）
+  // List of functions supported by the current component (other components can trigger these functions)
   functions = [
     {
       apiKey: 'loadData',
-      label: '刷新表格',
-      helpTextKey: '刷新当前表格数据',
+      label: 'Refresh Table',
+      helpTextKey: 'Refresh the current table data',
     },
     {
       apiKey: 'setFilter',
-      label: '设置过滤条件',
+      label: 'Set Filter Conditions',
       helpTextKey:
-        '设置与图表一致的 filter（closeDate / ownerId / entityType），并重新查询表格',
+        'Set filter conditions consistent with the chart (closeDate / ownerId / entityType), and re-query the table',
       funcInParams: [
         {
           apiKey: 'filter',
-          label: '过滤条件数据',
+          label: 'Filter condition data',
           type: 'Object',
           required: false,
         },
@@ -74,12 +74,12 @@ export class SimpleTableModel {
     },
     {
       apiKey: 'updateActiveStage',
-      label: '更新当前激活阶段',
-      helpTextKey: '设置当前激活的销售阶段',
+      label: 'Update Active Stage',
+      helpTextKey: 'Set the currently active sales stage',
       funcInParams: [
         {
           apiKey: 'activeStage',
-          label: '当前激活阶段',
+          label: 'Current active stage',
           type: 'String',
           required: false,
         },
@@ -88,33 +88,33 @@ export class SimpleTableModel {
   ];
 
   /**
-   * 组件属性配置模式
-   * 支持静态配置：propsSchema，优先级比 propsSchemaCreator 低
-   * 定义组件在编辑器中可配置的属性
+   * Component property configuration schema
+   * Supports static configuration: propsSchema, with lower priority than propsSchemaCreator
+   * Defines the configurable properties of the component in the editor
    */
   propsSchema = [
     {
       type: 'panelInput',
       name: 'title',
-      label: '表格标题',
-      placeholder: '请输入表格标题',
+      label: 'Table Title',
+      placeholder: 'Enter table title',
     },
     {
       type: 'panelInput',
       name: 'description',
-      label: '表格说明',
-      placeholder: '显示在标题下方的说明文字',
+      label: 'Table Description',
+      placeholder: 'Description text displayed below the title',
     },
     /*
     {
-      type: 'xObjectDataApi', // 用于获取实体业务数据列表的配置项
+      type: 'xObjectDataApi', // Configuration item for fetching entity business data list
       name: 'xObjectDataApi',
-      label: '实体数据源',
+      label: 'Entity Data Source',
       value: {
         xObjectApiKey: 'customContact__c',
         fields: ['name', 'phone__c'],
       },
-      placeholder: '请选择实体数据源',
+      placeholder: 'Select entity data source',
       custom: true,
     },
     */

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

@@ -1,4 +1,4 @@
-/** 表头 AI 图标：用法同 openChatPageBtn 的 openChatPageBtn-icon（背景图） */
+/** Table header AI icon: same usage as openChatPageBtn's openChatPageBtn-icon (background image) */
 .simpleTable-th-title-with-ai-icon {
   display: inline-flex;
   align-items: center;
@@ -157,7 +157,7 @@
     color: #fff;
   }
 
-  // 响应式设计
+  // Responsive design
   @media (max-width: 768px) {
     .panel-header {
       padding: 12px;
@@ -190,4 +190,3 @@
     }
   }
 }
-

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

@@ -1,8 +1,8 @@
-# StageSwitch 组件
+# StageSwitch Component
 
-阶段切换卡片组件，切换显示不同销售阶段的数据。
+Stage switch card component that toggles between different sales stage data.
 
-## 使用方式
+## Usage
 
 ```tsx
 import StageSwitch from './components/stageSwitch__c';
@@ -19,18 +19,18 @@ import StageSwitch from './components/stageSwitch__c';
 
 ## Props
 
-| 属性 | 说明 | 类型 | 默认值 |
-|------|------|------|--------|
-| stages | 阶段数据 | StageTab[] | [] |
-| activeStage | 当前阶段 | string | 第一个阶段 |
-| onStageChange | 阶段切换回调 | (stage: StageTab) => void | - |
+| Property | Description | Type | Default |
+|----------|-------------|------|---------|
+| stages | Stage data | StageTab[] | [] |
+| activeStage | Current stage | string | First stage |
+| onStageChange | Stage switch callback | (stage: StageTab) => void | - |
 
 ## StageTab
 
-| 属性 | 说明 | 类型 |
-|------|------|------|
-| key | 唯一标识 | string |
-| name | 阶段名称 | string |
-| amount | 金额 | string |
-| count | 数量 | number |
-| changes | 变化数据 | { amount, amountDirection, count, countDirection } |
+| Property | Description | Type |
+|----------|-------------|------|
+| key | Unique identifier | string |
+| name | Stage name | string |
+| amount | Amount | string |
+| count | Count | number |
+| changes | Change data | { amount, amountDirection, count, countDirection } |