neo-cmp-cli 1.13.17 → 1.13.18

package/template/neo-pipeline-cmps/src/utils/queryByCustomSQL.ts

@@ -2,10 +2,10 @@
 import { request as axiosFetcher } from 'neo-open-api';
 
 /**
- * 这里存放通用查询类 Open API
+ * Common query Open APIs are stored here
  */
 
-/** 将 where 规范为 SQL 片段：字符串直接使用；数组用 and 拼接各条件 */
+/** Normalize where to SQL fragment: string is used directly; array items are joined with 'and' */
 function normalizeWhere(where: unknown): string {
   if (where == null || where === '') {
     return '';
@@ -22,7 +22,7 @@ function normalizeWhere(where: unknown): string {
   return '';
 }
 
-// 根据 sql 查询 BI 数据
+// Query BI data by SQL
 export const queryByCustomSQL = async (options?: any) => {
   const apiUrl = '/rest/neobi/v2.0/query/queryByCustomSQL';
   const curOptions = options || {};
@@ -31,34 +31,34 @@ export const queryByCustomSQL = async (options?: any) => {
   const page = curOptions.page || 1;
   const pageSize = curOptions.pageSize || 10;
 
-  // 自动添加 objectId 字段
+  // Automatically add objectId field
   if (!fields.includes('id')) {
     fields.push('id');
   }
 
-  // 计算分页偏移量
+  // Calculate pagination offset
   const offset = (page - 1) * pageSize;
 
-  // 构建 SQL 查询
+  // Build SQL query
   let querySql = `select ${fields.join(',')} from ${xObjectApiKey}`;
 
-  // 添加排序条件（如果有的话）
+  // Add sort conditions (if any)
   if (curOptions.orderBy) {
     querySql += ` order by ${curOptions.orderBy}`;
   }
 
   /**
-   * 添加过滤条件（如果有的话）
-   * 支持的操作符包括：=、!=、like、not like、not in、is not null、is null、>、<、<>、>=、<=、in、between ... and ...。
-   * 对于 =、like 和 in 有以下说明：
-   *   “=” 作为字符串的条件时，表示精确匹配。例如，查询条件 city = '北京'，将返回 city 字段值严格等于 "北京" 的所有记录。
-   *   "like" 作为字符串的条件时，需要使用"%" 通配符进行模糊匹配。例如，city like‘北京%'，将返回 city 字段值以 "北京" 开头的所有记录。
-   *         目前仅支持将通配符“%” 放到已知内容之后的查询方式，例如，不支持 city like ‘% 北京'的查询方式。
-   *         当 SQL 查询中包含“%”等特殊字符时，需要对 SQL 进行 URL 编码处理。
-   * 支持"in"，但不包括子查询。
-   * 支持的逻辑运算符包括：and、or。
+   * Add filter conditions (if any)
+   * Supported operators: =, !=, like, not like, not in, is not null, is null, >, <, <>, >=, <=, in, between ... and ...
+   * Notes for =, like and in:
+   *   "=" as a string condition means exact match. For example, city = 'Beijing' returns all records where city is strictly equal to "Beijing".
+   *   "like" as a string condition requires "%" wildcard for fuzzy matching. For example, city like 'Beijing%' returns all records where city starts with "Beijing".
+   *         Currently only supports placing "%" after the known content; e.g., city like '% Beijing' is not supported.
+   *         When the SQL query contains special characters like "%", URL encoding is required.
+   * Supports "in", but not subqueries.
+   * Supported logical operators: and, or.
    *
-   * `where` 可为字符串，或字符串数组（多项默认以 and 连接，等价于手写 `a and b`）。
+   * `where` can be a string, or a string array (multiple items joined with 'and' by default, equivalent to `a and b`).
    */
   const whereClause = normalizeWhere(curOptions.where);
 
@@ -67,7 +67,7 @@ export const queryByCustomSQL = async (options?: any) => {
   }
 
   if (curOptions.page || curOptions.pageSize) {
-    // 添加分页限制
+    // Add pagination limit
     querySql += ` limit ${offset},${pageSize}`;
   }
 
@@ -91,7 +91,8 @@ export const queryByCustomSQL = async (options?: any) => {
       return {
         status: true,
         code: resultData.code,
-        msg: resultData.msg || '获取业务对象数据列表成功',
+        msg:
+          resultData.msg || 'Successfully retrieved business object data list',
         totalSize: records.length,
         data: records || [],
       };
@@ -100,15 +101,18 @@ export const queryByCustomSQL = async (options?: any) => {
     return {
       status: false,
       code: resultData.code,
-      msg: resultData.msg || '获取业务对象数据列表失败',
+      msg: resultData.msg || 'Failed to retrieve business object data list',
       data: [],
     };
   } catch (error) {
-    console.error('获取业务对象数据列表失败:', error);
+    console.error('Failed to retrieve business object data list:', error);
 
     return {
       status: false,
-      msg: error.msg || error.message || '获取业务对象数据列表失败',
+      msg:
+        error.msg ||
+        error.message ||
+        'Failed to retrieve business object data list',
       data: [],
     };
   }

package/template/neo-pipeline-cmps/src/utils/requestDebounce.ts

@@ -1,10 +1,10 @@
 // @ts-nocheck
 import debounce from 'lodash/debounce';
 
-/** 组件内数据请求防抖间隔（毫秒），用于合并短时间内的重复触发 */
+/** Data request debounce interval in milliseconds for components, used to merge repeated triggers within a short time */
 export const REQUEST_DEBOUNCE_MS = 280;
 
-/** lodash debounce 实例（避免依赖 @types/lodash） */
+/** lodash debounce instance (avoids dependency on @types/lodash) */
 export type DebouncedRequestFn = {
   (): void;
   cancel(): void;
@@ -12,7 +12,7 @@ export type DebouncedRequestFn = {
 };
 
 /**
- * 尾部防抖：连续触发时仅在停顿后执行一次，适合 filter / props 连更新场景。
+ * Trailing debounce: executes only once after a pause during continuous triggers, suitable for filter / props rapid update scenarios.
  */
 export function createRequestDebounce(
   fn: () => void,

package/template/neo-pipeline-cmps/src/utils/simpleTable.tsx

@@ -1,5 +1,5 @@
 /**
- * 表格 simpleTable 专用：格式化、历史快照、趋势与单元格渲染
+ * Table simpleTable specific: formatting, history snapshots, trends and cell rendering
  */
 import * as React from 'react';
 import { Card, Popover } from 'antd';
@@ -7,7 +7,7 @@ import moment from 'moment';
 
 import { toFiniteNumber } from './common';
 
-/** 期间初商机快照（与当前行 id 关联） */
+/** Period-start opportunity snapshot (associated with current row id) */
 export interface HistoryOppSnap {
   id: string;
   closeDate: unknown;
@@ -67,7 +67,7 @@ function closeDateTrend(
   return 'same';
 }
 
-/** 自定义 SQL 返回行：数组列顺序与 HISTORY_QUERY_FIELDS 一致；或对象字段 */
+/** Custom SQL return row: array column order matches HISTORY_QUERY_FIELDS; or object fields */
 export function historyRowToSnap(row: unknown): HistoryOppSnap | null {
   if (row == null) return null;
   if (Array.isArray(row)) {
@@ -91,9 +91,7 @@ export function historyRowToSnap(row: unknown): HistoryOppSnap | null {
       opportunityName: String(
         o.opportunity_1_opportunityName ?? o.opportunityName ?? '',
       ),
-      saleStageId: String(
-        o.opportunity_1_saleStageId ?? o.saleStageId ?? '',
-      ),
+      saleStageId: String(o.opportunity_1_saleStageId ?? o.saleStageId ?? ''),
       money: o.opportunity_1_money ?? o.money,
     };
   }
@@ -123,7 +121,7 @@ export function formatActivityDateTime(value: unknown): string {
   return m.isValid() ? m.format('YYYY-MM-DD HH:mm:ss') : String(value);
 }
 
-/** customItem246/247：变更记录时间（毫秒/秒时间戳或可被 moment 解析的值）→ YYYY-MM-DD */
+/** customItem246/247: change record time (ms/s timestamp or moment-parseable value) -> YYYY-MM-DD */
 export function formatChangeRecordedAt(value: unknown): string {
   if (value == null || value === '') return '—';
   const n = toFiniteNumber(value);
@@ -136,7 +134,7 @@ export function formatChangeRecordedAt(value: unknown): string {
   return m.isValid() ? m.format('YYYY-MM-DD') : String(value);
 }
 
-/** 金额列：$ 前缀 + 千分位（不缩写） */
+/** Money column: $ prefix + thousands separator (no abbreviation) */
 export function formatMoneyCell(value: unknown): string {
   if (value == null || value === '') return '—';
   const n = parseFloat(String(value).replace(/,/g, '').trim());
@@ -150,8 +148,10 @@ export function formatMoneyCell(value: unknown): string {
   return `$${part}`;
 }
 
-/** oppHealthAssessmentLevel：数值 → 健康度标签（带颜色背景） */
-export function renderOppHealthAssessmentLevel(value: unknown): React.ReactNode {
+/** oppHealthAssessmentLevel: numeric value -> health label (with colored background) */
+export function renderOppHealthAssessmentLevel(
+  value: unknown,
+): React.ReactNode {
   if (value == null || value === '') return '—';
   const n = toFiniteNumber(value);
   if (n === 5) {
@@ -160,7 +160,9 @@ export function renderOppHealthAssessmentLevel(value: unknown): React.ReactNode
     );
   }
   if (n === 6) {
-    return <span className="opp-health-tag opp-health-tag--yellow">Health</span>;
+    return (
+      <span className="opp-health-tag opp-health-tag--yellow">Health</span>
+    );
   }
   if (n === 7) {
     return <span className="opp-health-tag opp-health-tag--red">Risk</span>;
@@ -172,7 +174,7 @@ export function renderOppHealthAssessmentLevel(value: unknown): React.ReactNode
 }
 
 /**
- * 百分比列：末尾加 %；接口常见为 0–1 小数或 0–100 数值，均按可读方式展示
+ * Percentage column: appends %; API commonly returns 0-1 decimal or 0-100 numeric, both displayed in readable format
  */
 export function formatPercentCell(value: unknown): string {
   if (value == null || value === '') return '—';
@@ -205,7 +207,9 @@ export function moneyChangeTooltipTitle(
       <div className="simpleTable-change-tip__detail">
         {formatMoneyCell(h.money)}
         {' → '}
-        <span className="simpleTable-change-tip__to">{formatMoneyCell(current)}</span>
+        <span className="simpleTable-change-tip__to">
+          {formatMoneyCell(current)}
+        </span>
       </div>
       <div className="simpleTable-change-tip__meta">
         Changed on {formatChangeRecordedAt(preset)}
@@ -227,7 +231,9 @@ export function closeDateChangeTooltipTitle(
       <div className="simpleTable-change-tip__detail">
         {formatCloseDate(h.closeDate)}
         {' → '}
-        <span className="simpleTable-change-tip__to">{formatCloseDate(current)}</span>
+        <span className="simpleTable-change-tip__to">
+          {formatCloseDate(current)}
+        </span>
       </div>
       <div className="simpleTable-change-tip__meta">
         Changed on {formatChangeRecordedAt(preset)}
@@ -268,22 +274,17 @@ export function renderTrendCell(args: {
   );
 }
 
-/** demo.html winRateTooltip 风格 */
+/** demo.html winRateTooltip style */
 export function renderWinRateHoverCard(record: any): React.ReactNode {
   const baseline = record?.customItem244__c;
   const positives = record?.customItem241__c;
   const negatives = record?.customItem242__c;
   const winRate = record?.customItem239__c;
 
-  const fmtLine = (v: unknown) =>
-    v == null || v === '' ? '—' : String(v);
+  const fmtLine = (v: unknown) => (v == null || v === '' ? '—' : String(v));
 
   return (
-    <Card
-      size="small"
-      bordered={false}
-      className="simpleTable-winrate-card"
-    >
+    <Card size="small" bordered={false} className="simpleTable-winrate-card">
       <div className="simpleTable-winrate-card__baseline">
         Baseline Probability{' '}
         <span className="simpleTable-winrate-card__baseline-val">
@@ -291,12 +292,16 @@ export function renderWinRateHoverCard(record: any): React.ReactNode {
         </span>
       </div>
       <hr className="simpleTable-winrate-card__hr" />
-      <div className="simpleTable-winrate-card__section-title">Positive Factors</div>
+      <div className="simpleTable-winrate-card__section-title">
+        Positive Factors
+      </div>
       <div className="simpleTable-winrate-card__positives">
         {fmtLine(positives)}
       </div>
       <hr className="simpleTable-winrate-card__hr" />
-      <div className="simpleTable-winrate-card__section-title">Negative Factors</div>
+      <div className="simpleTable-winrate-card__section-title">
+        Negative Factors
+      </div>
       <div className="simpleTable-winrate-card__negatives">
         {fmtLine(negatives)}
       </div>
@@ -311,7 +316,7 @@ export function renderWinRateHoverCard(record: any): React.ReactNode {
   );
 }
 
-/** 汇总金额展示（与 formatMoneyCell 数字格式一致） */
+/** Summary amount display (number format consistent with formatMoneyCell) */
 export function formatMoneySummaryAmount(n: number): string {
   const part = Number.isInteger(n)
     ? n.toLocaleString('en-US')
@@ -322,7 +327,7 @@ export function formatMoneySummaryAmount(n: number): string {
   return `$${part}`;
 }
 
-/** 按字段 apiKey 汇总行金额（解析规则与金额列一致） */
+/** Sum row amounts by field apiKey (parsing rules consistent with money column) */
 export function sumMoneyRows(rows: any[], moneyFieldKey: string): number {
   let total = 0;
   for (const row of rows) {

package/template/neo-pipeline-cmps/src/utils/stageSwitch.ts

@@ -1,5 +1,5 @@
 /**
- * 阶段切换 stageSwitch 专用（商机行字段解析）
+ * Stage switch stageSwitch specific (opportunity row field parsing)
  */
 import { parseNumberOrZero } from './common';
 

package/template/neo-pipeline-cmps/src/utils/stageTimeChart.ts

@@ -1,5 +1,5 @@
 /**
- * 阶段停留时间 stageTimeChart 专用
+ * Stage time stageTimeChart specific
  */
 import { extractStageKeyFromStageName } from './common';
 
@@ -27,7 +27,7 @@ export interface StageTimeItem {
 }
 
 /**
- * 将「16天11小时」「8天6时」等文案转为天数（浮点），如 16 + 11/24
+ * Convert duration text like "16 Days 11 Hours" or "8天6时" to days (float), e.g. 16 + 11/24
  */
 export function parseDurationToDays(text: unknown): number {
   const s = String(text ?? '').trim();
@@ -41,13 +41,13 @@ export function parseDurationToDays(text: unknown): number {
   return days + hours / 24;
 }
 
-/** 终局阶段不参与「阶段停留时间」展示 */
+/** Final/closed stages are excluded from "stage time" display */
 export function isClosedOutcomeStage(stageName: string): boolean {
   const key = extractStageKeyFromStageName(stageName).toLowerCase();
   return key === 'closed won' || key === 'closed lost';
 }
 
-/** 配色：实际天数与 customItem3（目标）/customItem4（上限）比较 */
+/** Color: compare actual days with customItem3 (target) / customItem4 (limit) */
 export function resolveActualColor(
   actualDays: number,
   target: number,
@@ -58,7 +58,7 @@ export function resolveActualColor(
   return COLOR_YELLOW;
 }
 
-/** 将解析后的行转为图表条数据（配色与条形比例） */
+/** Convert parsed rows to chart bar data (color and bar proportions) */
 export function buildStageTimeItems(rows: StageTimeRow[]): StageTimeItem[] {
   return rows.map((row) => {
     const actualPercent = row.actualTime;

package/template/neo-pipeline-cmps/src/utils/targetNumber.ts

@@ -1,8 +1,8 @@
 /**
- * 数值指标 targetNumber：样式辅助
+ * Numeric indicator targetNumber: style helpers
  */
 
-/** margin/padding 字符串：无单位时补上 quantity，已有 px/rem等则原样返回 */
+/** margin/padding string: appends unit when no unit present, returns as-is if px/rem/etc already exists */
 export function formatCssSpacing(value: string, unit: string): string {
   if (!value || value === '0') return '0';
   if (/\d+(px|rem|em|%)$/.test(value.trim())) {

package/template/neo-web-form/package.json

@@ -53,7 +53,7 @@
     "@types/react-dom": "^16.9.15",
     "husky": "^4.2.5",
     "lint-staged": "^10.2.9",
-    "neo-cmp-cli": "^1.13.17",
+    "neo-cmp-cli": "^1.13.18",
     "prettier": "^2.0.5"
   },
   "overrides": {