neo-cmp-cli 1.13.16 → 1.13.18

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

@@ -0,0 +1,349 @@
+/**
+ * Table simpleTable specific: formatting, history snapshots, trends and cell rendering
+ */
+import * as React from 'react';
+import { Card, Popover } from 'antd';
+import moment from 'moment';
+
+import { toFiniteNumber } from './common';
+
+/** Period-start opportunity snapshot (associated with current row id) */
+export interface HistoryOppSnap {
+  id: string;
+  closeDate: unknown;
+  opportunityName: string;
+  saleStageId: string;
+  money: unknown;
+}
+
+export interface FieldInfo {
+  name: string;
+  label: string;
+  apiKey: string;
+  type: string;
+  itemType: string;
+  checkitem: any[];
+  selectitem?: any[];
+  required: boolean;
+}
+
+function parseNumberForCompare(value: unknown): number | null {
+  if (value == null || value === '') return null;
+  const n = parseFloat(String(value).replace(/,/g, '').trim());
+  return Number.isFinite(n) ? n : null;
+}
+
+function parseCloseDateMs(value: unknown): number | null {
+  if (value == null || value === '') return null;
+  const m = moment(value);
+  return m.isValid() ? m.valueOf() : null;
+}
+
+type Trend = 'up' | 'down' | 'same';
+
+function moneyTrend(
+  current: unknown,
+  history: HistoryOppSnap | null | undefined,
+): Trend | null {
+  if (!history) return null;
+  const cur = parseNumberForCompare(current);
+  const prev = parseNumberForCompare(history.money);
+  if (cur == null || prev == null) return null;
+  if (cur > prev) return 'up';
+  if (cur < prev) return 'down';
+  return 'same';
+}
+
+function closeDateTrend(
+  current: unknown,
+  history: HistoryOppSnap | null | undefined,
+): Trend | null {
+  if (!history) return null;
+  const cur = parseCloseDateMs(current);
+  const prev = parseCloseDateMs(history.closeDate);
+  if (cur == null || prev == null) return null;
+  if (cur > prev) return 'up';
+  if (cur < prev) return 'down';
+  return 'same';
+}
+
+/** 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)) {
+    if (row.length < 5) return null;
+    return {
+      id: String(row[0] ?? '').trim(),
+      closeDate: row[1],
+      opportunityName: row[2] != null ? String(row[2]) : '',
+      saleStageId: row[3] != null ? String(row[3]) : '',
+      money: row[4],
+    };
+  }
+  if (typeof row === 'object') {
+    const o = row as Record<string, unknown>;
+    const id = o.id ?? o.opportunity_1_id;
+    if (id == null || id === '') return null;
+    return {
+      id: String(id).trim(),
+      closeDate:
+        o.opportunity_1_closeDate ?? o.closeDate ?? o.opportunity_1_close_date,
+      opportunityName: String(
+        o.opportunity_1_opportunityName ?? o.opportunityName ?? '',
+      ),
+      saleStageId: String(o.opportunity_1_saleStageId ?? o.saleStageId ?? ''),
+      money: o.opportunity_1_money ?? o.money,
+    };
+  }
+  return null;
+}
+
+export function buildHistoryMap(rows: unknown[]): Map<string, HistoryOppSnap> {
+  const map = new Map<string, HistoryOppSnap>();
+  for (const raw of rows) {
+    const snap = historyRowToSnap(raw);
+    if (snap?.id) map.set(snap.id, snap);
+  }
+  return map;
+}
+
+/** closeDate：YYYY-MM-DD */
+export function formatCloseDate(value: unknown): string {
+  if (value == null || value === '') return '—';
+  const m = moment(value);
+  return m.isValid() ? m.format('YYYY-MM-DD') : String(value);
+}
+
+/** recentActivityRecordTime：YYYY-MM-DD HH:mm:ss */
+export function formatActivityDateTime(value: unknown): string {
+  if (value == null || value === '') return '—';
+  const m = moment(value);
+  return m.isValid() ? m.format('YYYY-MM-DD HH:mm:ss') : String(value);
+}
+
+/** 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);
+  if (n != null) {
+    const ms = n < 1e12 ? n * 1000 : n;
+    const m = moment(ms);
+    if (m.isValid()) return m.format('YYYY-MM-DD');
+  }
+  const m = moment(value);
+  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());
+  if (!Number.isFinite(n)) return String(value);
+  const part = Number.isInteger(n)
+    ? n.toLocaleString('en-US')
+    : n.toLocaleString('en-US', {
+        minimumFractionDigits: 0,
+        maximumFractionDigits: 2,
+      });
+  return `$${part}`;
+}
+
+/** 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) {
+    return (
+      <span className="opp-health-tag opp-health-tag--green">Excellent</span>
+    );
+  }
+  if (n === 6) {
+    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>;
+  }
+  if (n === 8) {
+    return <span className="opp-health-tag opp-health-tag--red">Problem</span>;
+  }
+  return '—';
+}
+
+/**
+ * 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 '—';
+  const raw = String(value).replace(/,/g, '').trim();
+  const n = parseFloat(raw.replace(/%/g, ''));
+  if (!Number.isFinite(n)) return String(value);
+  let pct = n;
+  if (n > 0 && n <= 1) {
+    pct = n * 100;
+  }
+  const text = Number.isInteger(pct)
+    ? String(pct)
+    : pct.toLocaleString('en-US', {
+        minimumFractionDigits: 0,
+        maximumFractionDigits: 2,
+      });
+  return `${text}%`;
+}
+
+export function moneyChangeTooltipTitle(
+  record: any,
+  current: unknown,
+): React.ReactNode {
+  const preset = record?.customItem246__c;
+  const h = record?.historyData as HistoryOppSnap | undefined;
+  if (!h) return null;
+  return (
+    <div className="simpleTable-change-tip">
+      <div className="simpleTable-change-tip__title">Amount</div>
+      <div className="simpleTable-change-tip__detail">
+        {formatMoneyCell(h.money)}
+        {' → '}
+        <span className="simpleTable-change-tip__to">
+          {formatMoneyCell(current)}
+        </span>
+      </div>
+      <div className="simpleTable-change-tip__meta">
+        Changed on {formatChangeRecordedAt(preset)}
+      </div>
+    </div>
+  );
+}
+
+export function closeDateChangeTooltipTitle(
+  record: any,
+  current: unknown,
+): React.ReactNode {
+  const preset = record?.customItem247__c;
+  const h = record?.historyData as HistoryOppSnap | undefined;
+  if (!h) return null;
+  return (
+    <div className="simpleTable-change-tip">
+      <div className="simpleTable-change-tip__title">Close Date</div>
+      <div className="simpleTable-change-tip__detail">
+        {formatCloseDate(h.closeDate)}
+        {' → '}
+        <span className="simpleTable-change-tip__to">
+          {formatCloseDate(current)}
+        </span>
+      </div>
+      <div className="simpleTable-change-tip__meta">
+        Changed on {formatChangeRecordedAt(preset)}
+      </div>
+    </div>
+  );
+}
+
+export function renderTrendCell(args: {
+  displayText: string;
+  trend: Trend | null;
+  tooltip: React.ReactNode;
+}): React.ReactNode {
+  const { displayText, trend, tooltip } = args;
+  const showArrow = trend === 'up' || trend === 'down';
+  const arrow =
+    trend === 'up' ? (
+      <span className="simpleTable-trend simpleTable-trend--up">↑</span>
+    ) : trend === 'down' ? (
+      <span className="simpleTable-trend simpleTable-trend--down">↓</span>
+    ) : null;
+
+  return (
+    <span className="simpleTable-cell-trend-wrap">
+      <span className="simpleTable-cell-trend-wrap__text">{displayText}</span>
+      {showArrow && arrow ? (
+        <Popover
+          content={tooltip}
+          trigger="hover"
+          placement="top"
+          overlayClassName="simpleTable-change-popover"
+          mouseEnterDelay={0.08}
+        >
+          <span className="simpleTable-cell-trend-wrap__arrow">{arrow}</span>
+        </Popover>
+      ) : null}
+    </span>
+  );
+}
+
+/** 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));
+
+  return (
+    <Card size="small" bordered={false} className="simpleTable-winrate-card">
+      <div className="simpleTable-winrate-card__baseline">
+        Baseline Probability{' '}
+        <span className="simpleTable-winrate-card__baseline-val">
+          {formatPercentCell(baseline)}
+        </span>
+      </div>
+      <hr className="simpleTable-winrate-card__hr" />
+      <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__negatives">
+        {fmtLine(negatives)}
+      </div>
+      <hr className="simpleTable-winrate-card__hr" />
+      <div className="simpleTable-winrate-card__footer">
+        <span>AI Win Rate</span>
+        <span className="simpleTable-winrate-card__winrate-val">
+          {formatPercentCell(winRate)}
+        </span>
+      </div>
+    </Card>
+  );
+}
+
+/** Summary amount display (number format consistent with formatMoneyCell) */
+export function formatMoneySummaryAmount(n: number): string {
+  const part = Number.isInteger(n)
+    ? n.toLocaleString('en-US')
+    : n.toLocaleString('en-US', {
+        minimumFractionDigits: 0,
+        maximumFractionDigits: 2,
+      });
+  return `$${part}`;
+}
+
+/** 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) {
+    const v = row?.[moneyFieldKey];
+    if (v == null || v === '') continue;
+    const n = parseFloat(String(v).replace(/,/g, '').trim());
+    if (Number.isFinite(n)) total += n;
+  }
+  return total;
+}
+
+export function isMoneyField(field: FieldInfo): boolean {
+  const k = field.apiKey?.toLowerCase?.() ?? '';
+  if (k === 'money' || k === 'amount') return true;
+  if (field.type === 'currency' || field.itemType === 'currency') return true;
+  return false;
+}
+
+export { moneyTrend, closeDateTrend };

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

@@ -0,0 +1,15 @@
+/**
+ * Stage switch stageSwitch specific (opportunity row field parsing)
+ */
+import { parseNumberOrZero } from './common';
+
+export function rowOpportunityStage(row: Record<string, unknown>): string {
+  return String(row.customItem248__c ?? '');
+}
+
+export function rowMoney(row: Record<string, unknown>): number {
+  if (row.money !== undefined && row.money !== null && row.money !== '') {
+    return parseNumberOrZero(row.money);
+  }
+  return parseNumberOrZero(row.amount);
+}

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

@@ -0,0 +1,90 @@
+/**
+ * Stage time stageTimeChart specific
+ */
+import { extractStageKeyFromStageName } from './common';
+
+const COLOR_GREEN = '#22c55e';
+const COLOR_YELLOW = '#eab308';
+const COLOR_RED = '#ef4444';
+const COLOR_NEUTRAL = '#94a3b8';
+
+export interface StageTimeRow {
+  stageName: string;
+  actualTime: number;
+  actualTimeDisplay: string;
+  targetPercent: number;
+  limitPercent: number;
+}
+
+export interface StageTimeItem {
+  stageName: string;
+  actualTime: string;
+  actualPercent: number;
+  actualColor: string;
+  barActualWidthPct: number;
+  barTargetLeftPct: number;
+  barLimitLeftPct: number;
+}
+
+/**
+ * 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();
+  if (!s) return 0;
+  let days = 0;
+  let hours = 0;
+  const dayMatch = s.match(/(\d+(?:\.\d+)?)\s*(天|Day)/);
+  if (dayMatch) days = parseFloat(dayMatch[1]) || 0;
+  const hourMatch = s.match(/(\d+(?:\.\d+)?)\s*(?:小时|时|Hour)/);
+  if (hourMatch) hours = parseFloat(hourMatch[1]) || 0;
+  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';
+}
+
+/** Color: compare actual days with customItem3 (target) / customItem4 (limit) */
+export function resolveActualColor(
+  actualDays: number,
+  target: number,
+  limit: number,
+): string {
+  if (actualDays <= target) return COLOR_GREEN;
+  if (actualDays > limit) return COLOR_RED;
+  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;
+    const hasTh =
+      Number.isFinite(row.targetPercent) && Number.isFinite(row.limitPercent);
+    let targetNum = row.targetPercent;
+    let limitNum = row.limitPercent;
+    let actualColor: string;
+    const scaleMax = 60;
+
+    if (hasTh) {
+      actualColor = resolveActualColor(actualPercent, targetNum, limitNum);
+    } else {
+      targetNum = 0;
+      limitNum = 0;
+      actualColor = COLOR_NEUTRAL;
+    }
+
+    return {
+      stageName: row.stageName,
+      actualTime: row.actualTimeDisplay,
+      actualPercent,
+      actualColor,
+      barActualWidthPct: Math.min(100, (actualPercent / scaleMax) * 100),
+      barTargetLeftPct: hasTh ? (targetNum / scaleMax) * 100 : 0,
+      barLimitLeftPct: hasTh ? (limitNum / scaleMax) * 100 : 0,
+    };
+  });
+}

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

@@ -0,0 +1,12 @@
+/**
+ * Numeric indicator targetNumber: style helpers
+ */
+
+/** 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())) {
+    return value;
+  }
+  return `${value}${unit}`;
+}

package/template/neo-pipeline-cmps/tsconfig.json

@@ -0,0 +1,40 @@
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "target": "esnext",
+    "module": "esnext",
+    "allowJs": false,
+    "jsx": "react", // preserve
+    "declaration": false,
+    "noEmit": false,
+    "importHelpers": true,
+    "isolatedModules": false,
+    "strict": false,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "noImplicitThis": true,
+    "noUnusedLocals": false,
+    "noImplicitReturns": true,
+    "moduleResolution": "node",
+    "baseUrl": "./",
+    "paths": {
+      "@": [
+        "./src"
+      ]
+    },
+    "typeRoots": [
+      "./@types",
+      "./node_modules/@types"
+    ],
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": [
+    "src",
+    "test"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}

package/template/neo-web-entity-grid/package.json

@@ -37,7 +37,7 @@
     "antd": "^4.9.4",
     "axios": "^1.7.0",
     "lodash": "^4.17.23",
-    "neo-open-api": "^1.2.3",
+    "neo-open-api": "^1.2.7",
     "neo-register": "^1.2.0",
     "react": "^16.9.0",
     "react-dom": "^16.9.0",
@@ -52,7 +52,7 @@
     "@types/react-dom": "^16.9.15",
     "husky": "^4.2.5",
     "lint-staged": "^10.2.9",
-    "neo-cmp-cli": "^1.13.16",
+    "neo-cmp-cli": "^1.13.17",
     "prettier": "^2.0.5"
   },
   "overrides": {

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

@@ -37,7 +37,7 @@
     "antd": "^4.9.4",
     "axios": "^1.7.0",
     "lodash": "^4.17.23",
-    "neo-open-api": "^1.2.3",
+    "neo-open-api": "^1.2.7",
     "neo-register": "^1.2.0",
     "react": "^16.9.0",
     "react-dom": "^16.9.0",
@@ -53,7 +53,7 @@
     "@types/react-dom": "^16.9.15",
     "husky": "^4.2.5",
     "lint-staged": "^10.2.9",
-    "neo-cmp-cli": "^1.13.16",
+    "neo-cmp-cli": "^1.13.18",
     "prettier": "^2.0.5"
   },
   "overrides": {