neo-cmp-cli 1.13.17 → 1.13.18

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 } |

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

@@ -1,6 +1,6 @@
 /**
- * @file 阶段切换卡片组件
- * @description 切换显示不同销售阶段的数据；商机来自 xObject.query，阶段来自 stage 接口
+ * @file Stage Switch Card Component
+ * @description Toggle between different sales stage data; opportunities from xObject.query, stages from stage API
  */
 import * as React from 'react';
 import { Spin } from 'antd';
@@ -33,7 +33,7 @@ interface StageTab {
   name: string;
   amount: string;
   count: number;
-  /** 暂无环比时可为空对象，不参与渲染 */
+  /** Can be empty object when no period-over-period data, not rendered */
   changes?: Record<string, unknown>;
 }
 
@@ -51,11 +51,11 @@ interface StageSwitchProps {
 interface StageSwitchState {
   activeStage: string;
   opportunityList: Record<string, unknown>[];
-  /** 由接口 + getOpportunityList 生成的展示用阶段 */
+  /** Display stages generated from API + getOpportunityList */
   stages: StageTab[];
   loading: boolean;
   error: string | null;
-  /** 与 FilterBar 事件 payload 一致（closeDateCustomRange / opportunityOwner / businessType 等）；空对象时回退 defaultFilter */
+  /** Consistent with FilterBar event payload (closeDateCustomRange / opportunityOwner / businessType, etc.); falls back to defaultFilter when empty object */
   filter: any;
   defaultEntityTypeApiKey: string;
 }
@@ -93,15 +93,15 @@ class StageSwitch extends BaseCmp<StageSwitchProps, StageSwitchState> {
     this.fetchAllData();
 
     /*
-    // 监听一个广播事件
+    // Listen to a broadcast event
     NeoEvent.listen('updateFilterData', (filterData: any) => {
-      console.log('StageSwitch 监听到了一个广播事件 updateFilterData: ', filterData);
+      console.log('StageSwitch 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);
     });
     */
@@ -117,8 +117,9 @@ class StageSwitch extends BaseCmp<StageSwitchProps, StageSwitchState> {
     }
   }
 
-  /** 将 FilterBar 结构 filter 转为 xObject.query 的 where 字符串数组（SDK 按顺序 and 拼接） */
+  /** Convert FilterBar structured filter to xObject.query where string array (SDK concatenates with AND in order) */
   getOpportunityQueryFilter(): string[] {
+    const defaultFilter = getDefaultFilterByProps(this.props);
     const raw = this.state.filter;
     const curFilter: Record<string, unknown> =
       raw && typeof raw === 'object' && !Array.isArray(raw)
@@ -149,8 +150,9 @@ class StageSwitch extends BaseCmp<StageSwitchProps, StageSwitchState> {
     return where;
   }
 
-  /** 用于生成获取历史商机列表数据的查询条件 */
+  /** Generate query conditions for fetching historical opportunity list data */
   getHistoryOpportunityQueryFilter(): string[] {
+    const defaultFilter = getDefaultFilterByProps(this.props);
     const raw = this.state.filter;
     const curFilter: Record<string, unknown> =
       raw && typeof raw === 'object' && !Array.isArray(raw)
@@ -187,7 +189,7 @@ class StageSwitch extends BaseCmp<StageSwitchProps, StageSwitchState> {
     return where;
   }
 
-  /** 单次查询最多 1000 条 opportunity */
+  /** Query up to 1000 opportunities per request */
   async fetchOpportunityList(): Promise<Record<string, unknown>[]> {
     const result = await xObject.query({
       xObjectApiKey: 'opportunity',
@@ -202,7 +204,7 @@ class StageSwitch extends BaseCmp<StageSwitchProps, StageSwitchState> {
       : [];
   }
 
-  /** 查询历史商机列表数据 */
+  /** Query historical opportunity list data */
   async fetchHistoryOpportunityList(): Promise<unknown[]> {
     const result = await queryByCustomSQL({
       xObjectApiKey: 'biCustomModel_397169_20260401104916618',
@@ -220,16 +222,16 @@ class StageSwitch extends BaseCmp<StageSwitchProps, StageSwitchState> {
   }
 
   /**
-   * 按 stageName 过滤商机：取 stageName 第一个 `.` 之后的片段作为阶段键，与商机行上阶段文案同样规则比对。
-   * @returns count — 条数； amount — money（若无则 amount 字段）之和
+   * Filter opportunities by stageName: extract the segment after the first `.` in stageName as the stage key, and compare with the stage text on the opportunity row using the same rule.
+   * @returns count — number of records; amount — sum of money (or amount field if money is absent)
    */
   getOpportunityStats(
     stageName: string,
-    list: Record<string, unknown>[], // 商机列表
+    list: Record<string, unknown>[], // opportunity list
   ): { amount: number; count: number } {
     const key = extractStageKeyFromStageName(stageName);
-    let amount = 0; // 商机总金额
-    let count = 0; // 商机总条数
+    let amount = 0; // total opportunity amount
+    let count = 0; // total opportunity count
 
     for (const row of list) {
       if (!row || typeof row !== 'object') continue;
@@ -244,9 +246,9 @@ class StageSwitch extends BaseCmp<StageSwitchProps, StageSwitchState> {
   }
 
   /**
-   * 历史商机列表为自定义 SQL 返回的二维数组行：
-   * `[opportunityName, saleStageId, money, ...]` — 第 2 列为阶段 ID（与阶段 `key` 对应），第 3 列为销售额。
-   * @returns count — 条数； amount — 销售额之和
+   * Historical opportunity list is a 2D array returned by custom SQL:
+   * `[opportunityName, saleStageId, money, ...]` — column 2 is the stage ID (corresponds to stage `key`), column 3 is the sales amount.
+   * @returns count — number of records; amount — sum of sales amount
    */
   getHistoryOpportunityStats(
     stageKey: string,
@@ -284,9 +286,9 @@ class StageSwitch extends BaseCmp<StageSwitchProps, StageSwitchState> {
   }
 
   buildStagesFromApi(
-    rows: any[], // 阶段列表
-    opportunityList: Record<string, unknown>[], // 商机列表
-    historyOpportunityList: unknown[], // 历史商机：SQL 二维数组行
+    rows: any[], // stage list
+    opportunityList: Record<string, unknown>[], // opportunity list
+    historyOpportunityList: unknown[], // historical opportunities: SQL 2D array rows
   ): StageTab[] {
     console.log(
       '[StageSwitch__c] buildStagesFromApi:',
@@ -304,7 +306,7 @@ class StageSwitch extends BaseCmp<StageSwitchProps, StageSwitchState> {
         row.id ?? row.apiKey ?? (stageName || `stage-${index}`),
       );
 
-      // 根据商机ID，从历史商机列表中找到对应的商机
+      // Find the corresponding opportunity from the historical opportunity list by opportunity ID
       const { amount: historyAmount, count: historyCount } =
         this.getHistoryOpportunityStats(key, historyOpportunityList);
 
@@ -357,8 +359,8 @@ class StageSwitch extends BaseCmp<StageSwitchProps, StageSwitchState> {
         loading: false,
       });
     } catch (e: unknown) {
-      console.error('StageSwitch 加载失败:', e);
-      const msg = e instanceof Error ? e.message : '加载失败';
+      console.error('StageSwitch failed to load:', e);
+      const msg = e instanceof Error ? e.message : 'Failed to load';
       this.setState({
         loading: false,
         error: msg,
@@ -368,13 +370,13 @@ class StageSwitch extends BaseCmp<StageSwitchProps, StageSwitchState> {
     }
   }
 
-  // 点击阶段切换时，更新当前激活的销售阶段
+  // When a stage is clicked, update the currently active sales stage
   handleStageClick(stage: StageTab) {
     const { onStageChange } = this.props;
     if (onStageChange) {
       onStageChange(stage);
     }
-    // 广播事件：更新当前激活的销售阶段
+    // Broadcast event: update the currently active sales stage
     const activeStage = extractStageKeyFromStageName(stage.name);
     this.setState({ activeStage: activeStage });
 
@@ -382,7 +384,7 @@ class StageSwitch extends BaseCmp<StageSwitchProps, StageSwitchState> {
       activeStage,
     });
 
-    // 触发一个广播事件
+    // Trigger a broadcast event
     // NeoEvent.broadcast('updateActiveStage', activeStage);
   }
 
@@ -392,7 +394,7 @@ class StageSwitch extends BaseCmp<StageSwitchProps, StageSwitchState> {
   }
 
   /**
-   * 与 pipelineFunnel 一致：传入 { relation, filter }，将重新拉取商机并合并阶段统计。
+   * Consistent with pipelineFunnel: pass in { relation, filter }, will re-fetch opportunities and merge stage statistics.
    */
   @NeoEvent.function
   setFilter(filter?: any) {
@@ -413,7 +415,7 @@ class StageSwitch extends BaseCmp<StageSwitchProps, StageSwitchState> {
   }
 
   /**
-   * 更新当前激活的销售阶段
+   * Update the currently active sales stage
    */
   @NeoEvent.function
   updateActiveStage(activeStage?: string) {
@@ -435,7 +437,7 @@ class StageSwitch extends BaseCmp<StageSwitchProps, StageSwitchState> {
       <div
         className={`stageSwitch__c ${className || ''}`}
         style={style}
-        data-time="2026.4.15 01"
+        data-time="2026.4.17 01"
       >
         <Spin spinning={loading}>
           {error ? (

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

@@ -1,12 +1,13 @@
 export class StageSwitchModel {
-  label: string = '阶段切换卡片';
-  description: string = '切换显示不同销售阶段的数据，包含金额、数量和变化趋势';
+  label: string = 'Stage Switch Card';
+  description: string =
+    'Toggle between different sales stage data, including amount, count and change trends';
   iconUrl: string = 'https://custom-widgets.bj.bcebos.com/card.svg';
   targetPage: string[] = ['all'];
   targetDevice: string = 'all';
 
   defaultComProps = {
-    /** 请求阶段列表接口时传入的 defaultEntityTypeApiKey */
+    /** defaultEntityTypeApiKey passed when requesting the stage list API */
     // defaultEntityTypeApiKey: 'defaultBusiType',
     stages: [] as unknown[],
     activeStage: 'Prospecting',
@@ -15,23 +16,23 @@ export class StageSwitchModel {
   events = [
     {
       apiKey: 'onActiveStageChange',
-      label: '当前激活阶段变动后',
+      label: 'After active stage changes',
       helpText:
-        '当前激活阶段变动后触发；事件参数含 activeStage（当前激活阶段）',
+        'Triggered after the active stage changes; event params include activeStage (current active stage)',
       eventParams:
-        '[{"apiKey":"eventParam","children":[{"apiKey":"activeStage","label":"当前激活阶段","type":"String"}],"label":"事件入参","type":"Object"}]',
+        '[{"apiKey":"eventParam","children":[{"apiKey":"activeStage","label":"Current active stage","type":"String"}],"label":"Event parameters","type":"Object"}]',
     },
   ];
 
   functions = [
     {
       apiKey: 'updateActiveStage',
-      label: '更新当前激活阶段',
-      helpTextKey: '设置当前激活的销售阶段',
+      label: 'Update active stage',
+      helpTextKey: 'Set the current active sales stage',
       funcInParams: [
         {
           apiKey: 'activeStage',
-          label: '当前激活阶段',
+          label: 'Current active stage',
           type: 'String',
           required: false,
         },
@@ -39,13 +40,13 @@ export class StageSwitchModel {
     },
     {
       apiKey: 'setFilter',
-      label: '设置过滤条件',
+      label: 'Set filter conditions',
       helpTextKey:
-        '设置与图表一致的 filter（closeDate / ownerId / entityType），并重新拉取商机',
+        'Set the filter consistent with the chart (closeDate / ownerId / entityType) and re-fetch opportunities',
       funcInParams: [
         {
           apiKey: 'filter',
-          label: '过滤条件（relation + filter 数组）',
+          label: 'Filter conditions (relation + filter array)',
           type: 'Object',
           required: false,
         },
@@ -53,8 +54,8 @@ export class StageSwitchModel {
     },
     {
       apiKey: 'refreshData',
-      label: '刷新数据',
-      helpTextKey: '重新拉取商机列表与阶段列表',
+      label: 'Refresh data',
+      helpTextKey: 'Re-fetch opportunity list and stage list',
     },
   ];
 
@@ -62,7 +63,7 @@ export class StageSwitchModel {
     {
       type: 'panelInput',
       name: 'defaultEntityTypeApiKey',
-      label: '业务类型 ApiKey（阶段列表接口）',
+      label: 'Business type ApiKey (stage list API)',
     },
   ];
 }

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

@@ -1,8 +1,8 @@
-# StageTimeChart 组件
+# StageTimeChart Component
 
-阶段停留时间组件，展示各销售阶段的平均停留时间。
+Stage time component that displays the average time spent in each sales stage.
 
-## 使用方式
+## Usage
 
 ```tsx
 import StageTimeChart from './components/stageTimeChart__c';
@@ -10,7 +10,7 @@ import StageTimeChart from './components/stageTimeChart__c';
 <StageTimeChart
   title="Avg. Time in Stage"
   items={[
-    { stageName: 'Prospecting', actualTime: '8天6时', actualPercent: 28, actualColor: '#22c55e', targetPercent: 33, limitPercent: 50 },
+    { stageName: 'Prospecting', actualTime: '8d 6h', actualPercent: 28, actualColor: '#22c55e', targetPercent: 33, limitPercent: 50 },
   ]}
   onStageClick={(name) => console.log('Clicked:', name)}
 />
@@ -18,20 +18,20 @@ import StageTimeChart from './components/stageTimeChart__c';
 
 ## Props
 
-| 属性 | 说明 | 类型 | 默认值 |
-|------|------|------|--------|
-| title | 标题 | string | 'Avg. Time in Stage' |
-| items | 阶段数据 | StageTimeItem[] | [] |
-| showAiButton | 显示AI按钮 | boolean | true |
-| onStageClick | 阶段点击回调 | (stageName: string) => void | - |
+| Property | Description | Type | Default |
+|----------|-------------|------|---------|
+| title | Title | string | 'Avg. Time in Stage' |
+| items | Stage data | StageTimeItem[] | [] |
+| showAiButton | Show AI button | boolean | true |
+| onStageClick | Stage click callback | (stageName: string) => void | - |
 
 ## StageTimeItem
 
-| 属性 | 说明 | 类型 |
-|------|------|------|
-| stageName | 阶段名称 | string |
-| actualTime | 实际时间 | string |
-| actualPercent | 实际百分比 | number |
-| actualColor | 实际颜色 | string |
-| targetPercent | 目标百分比 | number |
-| limitPercent | 限制百分比 | number |
+| Property | Description | Type |
+|----------|-------------|------|
+| stageName | Stage name | string |
+| actualTime | Actual time | string |
+| actualPercent | Actual percentage | number |
+| actualColor | Actual color | string |
+| targetPercent | Target percentage | number |
+| limitPercent | Limit percentage | number |