a-calc 3.0.0-beta.20260124.3 → 3.0.0-beta.20260128.1

package/calc.d.ts

@@ -78,7 +78,7 @@ type CalcRuntimeOptions<Fmt extends string, Err> =
         _debug?: boolean;
         _on_debug?: (info: any) => void;
         _angle_unit?: 'deg' | 'rad';
-        _compact_units?: string[];
+        _compact_symbols?: string[];
         _compact_step?: number | number[];
         _thousands?: Record<string, ThousandsPreset>;
         /** 多路取值时视为空值的值数组（仅运行时选项） */
@@ -121,8 +121,8 @@ export type CalcSum = <const Expr extends string | number, const Fmt extends str
 export interface FmtOptions {
     _error?: any;
     _fmt?: string;
-    /** 紧凑格式单位数组（仅选项，临时覆盖） */
-    _compact_units?: string[];
+    /** 紧凑格式符号数组（仅选项，临时覆盖） */
+    _compact_symbols?: string[];
     /** 紧凑格式阶梯值（仅选项，临时覆盖） */
     _compact_step?: number | number[];
     /** 紧凑格式预设配置（仅选项） */
@@ -441,7 +441,7 @@ export type UnitConvertRule =
         fn?: (value: number, input_unit: string, output_unit: string) => number;
         _position?: 'before' | 'after' | 'middle';
         _thousands?: string;
-        _vol?: string;
+        _compact?: string;
     };
 
 /**
@@ -450,7 +450,7 @@ export type UnitConvertRule =
 export type UnitConvertOut = Record<string, Record<string, UnitConvertRule> & {
     _position?: 'before' | 'after' | 'middle';
     _thousands?: string;
-    _vol?: string;
+    _compact?: string;
 }>;
 
 /**
@@ -460,7 +460,7 @@ export type UnitConvertIn = Record<string, Record<string, UnitConvertRule>>;
 
 /**
  * 千分位预设名称（系统内置）
- * - us: 美式/英式/国际标准 (1,234,567.89)
+ * - en: 英文/国际标准 (1,234,567.89)
  * - eu: 欧洲大陆格式 (1.234.567,89)
  * - swiss: 瑞士格式 (1'234'567.89)
  * - space: 空格分隔/ISO标准 (1 234 567.89)
@@ -468,7 +468,17 @@ export type UnitConvertIn = Record<string, Record<string, UnitConvertRule>>;
  * - indian: 印度格式 (12,34,567.89)
  * - wan: 万进制/东亚格式 (123,4567.89)
  */
-export type ThousandsPresetName = 'us' | 'eu' | 'swiss' | 'space' | 'fr' | 'indian' | 'wan';
+export type ThousandsPresetName = 'en' | 'eu' | 'swiss' | 'space' | 'fr' | 'indian' | 'wan';
+
+/**
+ * 紧凑格式预设名称（系统内置）
+ * - en: 英文/国际通用 (1.23K, 1.23M, 1.23B, 1.23T)
+ * - cn: 中文千进制 (1.23千, 1.23百万, 1.23十亿, 1.23万亿)
+ * - wan: 万进制 (1.23万, 1.23亿, 1.23万亿)
+ * - storage: 存储单位 (1KB, 1MB, 1GB, 1TB - 1024进制)
+ * - indian: 印度格式 (1.23K, 1.23L, 1.23Cr - 阶梯[1000,100,100])
+ */
+export type CompactPresetName = 'en' | 'cn' | 'wan' | 'storage' | 'indian';
 
 /**
  * 千分位预设配置类型
@@ -492,9 +502,9 @@ export interface ThousandsPreset {
  * 紧凑格式预设配置类型
  */
 export type CompactPreset =
-    | string[]  // 简写形式：只有单位数组，step 默认 1000
-    | {         // 完整形式：包含 units 和 step
-        units: string[];
+    | string[]  // 简写形式：只有符号数组，step 默认 1000
+    | {         // 完整形式：包含 symbols 和 step
+        symbols: string[];
         step?: number | number[];
     }
     | ((num_str: string, context: {  // 自定义函数形式