stk-table-vue 1.2.4 → 1.2.6

package/src/StkTable/custom-cells/utils/formatNumber.ts

@@ -1,137 +1,137 @@
-/**
- * 数字格式化选项
- *
- * NumberCell / ChangeCell 共享的格式化配置。
- */
-export interface FormatNumberOptions {
-    /** 小数位数（四舍五入）。不传则不强制处理小数位 */
-    decimals?: number;
-    /** 是否使用千分位分隔符，默认 true */
-    thousands?: boolean;
-    /** 前缀，如 '¥'、'$' */
-    prefix?: string;
-    /** 后缀，如 '元'、'股' */
-    suffix?: string;
-    /** 正数是否强制显示 '+' 号，默认 false（负数始终带 '-'） */
-    showSign?: boolean;
-    /** 百分比模式：值 ×100 并追加 '%'，默认 false。与 abbr 互斥 */
-    percent?: boolean;
-    /** 单位缩放：'cn' = 万/亿，'en' = K/M/B。不传则不缩放。与 percent 互斥 */
-    abbr?: 'cn' | 'en';
-    /** 缩放后保留的小数位，默认 2 */
-    abbrDecimals?: number;
-    /** 空值(null/undefined/'')或非数字时的占位符，默认 '--' */
-    placeholder?: string;
-}
-
-/** 缩放单位阈值表（从大到小匹配） */
-const ABBR_UNITS: Record<'cn' | 'en', Array<[number, string]>> = {
-    cn: [
-        [1e8, '亿'],
-        [1e4, '万'],
-    ],
-    en: [
-        [1e9, 'B'],
-        [1e6, 'M'],
-        [1e3, 'K'],
-    ],
-};
-
-/**
- * 给数字字符串的整数部分添加千分位分隔符。
- * @param numStr 不含符号的正数字符串（可含小数部分）
- *
- * 用手动分组代替先读正则 `\B(?=(\d{3})+(?!\d))`：
- * 后者在长数字上开销随位数非线性增长，且 split('.') 会额外分配数组。
- */
-function addThousandsSeparator(numStr: string): string {
-    // 用 indexOf/slice 分离整数与小数部分，避免 split 分配数组
-    const dotIndex = numStr.indexOf('.');
-    const intPart = dotIndex === -1 ? numStr : numStr.slice(0, dotIndex);
-    const len = intPart.length;
-
-    // 三位以内无需分隔，直接返回原串
-    if (len <= 3) return numStr;
-
-    // 首组长度：不足三位的高位余数
-    const firstGroupLen = len % 3 || 3;
-    let withSep = intPart.slice(0, firstGroupLen);
-    for (let i = firstGroupLen; i < len; i += 3) {
-        withSep += ',' + intPart.slice(i, i + 3);
-    }
-
-    return dotIndex === -1 ? withSep : withSep + numStr.slice(dotIndex);
-}
-
-/**
- * 数字格式化纯函数（NumberCell / ChangeCell 共享内核）。
- *
- * 处理管线：空值判断 → 取符号 → 百分比 → 单位缩放 → 小数位 → 千分位 → 拼装。
- *
- * @param value 原始值（数字或可转为数字的字符串）
- * @param options 格式化选项
- * @returns 格式化后的字符串；空值或非数字返回 placeholder
- */
-export function formatNumber(value: unknown, options: FormatNumberOptions = {}): string {
-    const {
-        decimals,
-        thousands = true,
-        prefix = '',
-        suffix = '',
-        showSign = false,
-        percent = false,
-        abbr,
-        abbrDecimals,
-        placeholder = '--',
-    } = options;
-
-    // 空值判断（注意：Number('') === 0，必须先拦掉空字符串）
-    if (value === null || value === undefined || value === '') {
-        return placeholder;
-    }
-    const num = typeof value === 'number' ? value : Number(value);
-    if (Number.isNaN(num)) {
-        return placeholder;
-    }
-
-    // 符号基于原始值正负；0 不带符号
-    const sign = num < 0 ? '-' : showSign && num > 0 ? '+' : '';
-    let work = Math.abs(num);
-
-    // 百分比
-    if (percent) {
-        work = work * 100;
-    }
-
-    // 单位缩放（与百分比互斥）
-    let unit = '';
-    if (abbr && !percent) {
-        // 用索引 for 遍历阈值表，避免 for...of 的迭代器与数组解构开销
-        const units = ABBR_UNITS[abbr];
-        for (let i = 0; i < units.length; i++) {
-            const threshold = units[i][0];
-            if (work >= threshold) {
-                work = work / threshold;
-                unit = units[i][1];
-                break;
-            }
-        }
-    }
-
-    // 小数位：缩放后优先 abbrDecimals，否则回落到 decimals，最终默认 2；未缩放时不强制
-    let fractionDigits: number | null;
-    if (unit) {
-        fractionDigits = abbrDecimals ?? decimals ?? 2;
-    } else {
-        fractionDigits = decimals ?? null;
-    }
-    let numStr = fractionDigits == null ? String(work) : work.toFixed(fractionDigits);
-
-    // 千分位
-    if (thousands) {
-        numStr = addThousandsSeparator(numStr);
-    }
-
-    const percentSuffix = percent ? '%' : '';
-    return `${prefix}${sign}${numStr}${unit}${percentSuffix}${suffix}`;
-}
+/**
+ * 数字格式化选项
+ *
+ * NumberCell / ChangeCell 共享的格式化配置。
+ */
+export interface FormatNumberOptions {
+    /** 小数位数（四舍五入）。不传则不强制处理小数位 */
+    decimals?: number;
+    /** 是否使用千分位分隔符，默认 true */
+    thousands?: boolean;
+    /** 前缀，如 '¥'、'$' */
+    prefix?: string;
+    /** 后缀，如 '元'、'股' */
+    suffix?: string;
+    /** 正数是否强制显示 '+' 号，默认 false（负数始终带 '-'） */
+    showSign?: boolean;
+    /** 百分比模式：值 ×100 并追加 '%'，默认 false。与 abbr 互斥 */
+    percent?: boolean;
+    /** 单位缩放：'cn' = 万/亿，'en' = K/M/B。不传则不缩放。与 percent 互斥 */
+    abbr?: 'cn' | 'en';
+    /** 缩放后保留的小数位，默认 2 */
+    abbrDecimals?: number;
+    /** 空值(null/undefined/'')或非数字时的占位符，默认 '--' */
+    placeholder?: string;
+}
+
+/** 缩放单位阈值表（从大到小匹配） */
+const ABBR_UNITS: Record<'cn' | 'en', Array<[number, string]>> = {
+    cn: [
+        [1e8, '亿'],
+        [1e4, '万'],
+    ],
+    en: [
+        [1e9, 'B'],
+        [1e6, 'M'],
+        [1e3, 'K'],
+    ],
+};
+
+/**
+ * 给数字字符串的整数部分添加千分位分隔符。
+ * @param numStr 不含符号的正数字符串（可含小数部分）
+ *
+ * 用手动分组代替先读正则 `\B(?=(\d{3})+(?!\d))`：
+ * 后者在长数字上开销随位数非线性增长，且 split('.') 会额外分配数组。
+ */
+function addThousandsSeparator(numStr: string): string {
+    // 用 indexOf/slice 分离整数与小数部分，避免 split 分配数组
+    const dotIndex = numStr.indexOf('.');
+    const intPart = dotIndex === -1 ? numStr : numStr.slice(0, dotIndex);
+    const len = intPart.length;
+
+    // 三位以内无需分隔，直接返回原串
+    if (len <= 3) return numStr;
+
+    // 首组长度：不足三位的高位余数
+    const firstGroupLen = len % 3 || 3;
+    let withSep = intPart.slice(0, firstGroupLen);
+    for (let i = firstGroupLen; i < len; i += 3) {
+        withSep += ',' + intPart.slice(i, i + 3);
+    }
+
+    return dotIndex === -1 ? withSep : withSep + numStr.slice(dotIndex);
+}
+
+/**
+ * 数字格式化纯函数（NumberCell / ChangeCell 共享内核）。
+ *
+ * 处理管线：空值判断 → 取符号 → 百分比 → 单位缩放 → 小数位 → 千分位 → 拼装。
+ *
+ * @param value 原始值（数字或可转为数字的字符串）
+ * @param options 格式化选项
+ * @returns 格式化后的字符串；空值或非数字返回 placeholder
+ */
+export function formatNumber(value: unknown, options: FormatNumberOptions = {}): string {
+    const {
+        decimals,
+        thousands = true,
+        prefix = '',
+        suffix = '',
+        showSign = false,
+        percent = false,
+        abbr,
+        abbrDecimals,
+        placeholder = '--',
+    } = options;
+
+    // 空值判断（注意：Number('') === 0，必须先拦掉空字符串）
+    if (value === null || value === undefined || value === '') {
+        return placeholder;
+    }
+    const num = typeof value === 'number' ? value : Number(value);
+    if (Number.isNaN(num)) {
+        return placeholder;
+    }
+
+    // 符号基于原始值正负；0 不带符号
+    const sign = num < 0 ? '-' : showSign && num > 0 ? '+' : '';
+    let work = Math.abs(num);
+
+    // 百分比
+    if (percent) {
+        work = work * 100;
+    }
+
+    // 单位缩放（与百分比互斥）
+    let unit = '';
+    if (abbr && !percent) {
+        // 用索引 for 遍历阈值表，避免 for...of 的迭代器与数组解构开销
+        const units = ABBR_UNITS[abbr];
+        for (let i = 0; i < units.length; i++) {
+            const threshold = units[i][0];
+            if (work >= threshold) {
+                work = work / threshold;
+                unit = units[i][1];
+                break;
+            }
+        }
+    }
+
+    // 小数位：缩放后优先 abbrDecimals，否则回落到 decimals，最终默认 2；未缩放时不强制
+    let fractionDigits: number | null;
+    if (unit) {
+        fractionDigits = abbrDecimals ?? decimals ?? 2;
+    } else {
+        fractionDigits = decimals ?? null;
+    }
+    let numStr = fractionDigits == null ? String(work) : work.toFixed(fractionDigits);
+
+    // 千分位
+    if (thousands) {
+        numStr = addThousandsSeparator(numStr);
+    }
+
+    const percentSuffix = percent ? '%' : '';
+    return `${prefix}${sign}${numStr}${unit}${percentSuffix}${suffix}`;
+}

package/src/StkTable/features/const.ts

@@ -1 +1 @@
-export const MY_FN_NAME = 'stkName';
+export const MY_FN_NAME = 'stkName';

package/src/StkTable/features/index.ts

@@ -1 +1 @@
-export { useAreaSelection, useAreaSelectionName } from './useAreaSelection';
+export { useAreaSelection, useAreaSelectionName } from './useAreaSelection';