a-calc 3.0.0-beta.20260124.4 → 3.0.0-beta.20260129.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>;
         /** 多路取值时视为空值的值数组（仅运行时选项） */
@@ -116,29 +116,21 @@ export type CalcSum = <const Expr extends string | number, const Fmt extends str
     );
 
 /**
- * fmt 格式化选项（运行时选项，可以包含数据）
+ * fmt 格式化选项（运行时选项）
+ * 注意：单位转换相关配置（_unit_convert_out 等）只能通过 set_config 全局设置
  */
 export interface FmtOptions {
     _error?: any;
     _fmt?: string;
-    /** 紧凑格式单位数组（仅选项，临时覆盖） */
-    _compact_units?: string[];
-    /** 紧凑格式阶梯值（仅选项，临时覆盖） */
+    /** 紧凑格式符号数组（临时覆盖） */
+    _compact_symbols?: string[];
+    /** 紧凑格式阶梯值（临时覆盖） */
     _compact_step?: number | number[];
-    /** 紧凑格式预设配置（仅选项） */
-    _compact?: Record<string, CompactPreset>;
-    _unit_convert_out?: Record<string, any>;
-    _unit_convert_in?: Record<string, any>;
-    _unit_default_out?: string | string[];
-    _unit_default_in?: string | string[];
-    _unit_default_position?: 'before' | 'after' | 'middle';
-    _unit_position_map?: Record<string, 'before' | 'after' | 'middle'>;
+    /** 千分位预设配置 */
     _thousands?: Record<string, ThousandsPreset>;
-    _unit_thousands_map?: Record<string, string>;
-    _unit_compact_map?: Record<string, string>;
-    /** 多路取值时视为空值的值数组（仅运行时选项） */
+    /** 多路取值时视为空值的值数组 */
     _empty_values?: any[];
-    /** 多路取值时自定义空值判断函数（仅运行时选项） */
+    /** 多路取值时自定义空值判断函数 */
     _empty_check?: (value: any, path?: string) => boolean;
     [key: string]: any;
 }
@@ -166,17 +158,6 @@ export interface CalcWrap {
         (options: Options): FuncReturn<Options>;
 }
 
-declare const calc_util: {
-    /**
-     * 检查当前库是否有更新版本
-     */
-    check_update(): void;
-    /**
-     * 打印当前库的版本
-     */
-    print_version(): void;
-};
-
 /**
  * 传入字符串算术式或数字返回计算的结果（标准语法）
  * @param expr 一个字符串算术式或一个数字
@@ -268,7 +249,25 @@ export const fmt: Fmt;
  * ```
  */
 export const calc_wrap: CalcWrap;
-declare const version: string;
+
+/**
+ * 当前库版本号
+ */
+export const version: string;
+
+/**
+ * 工具函数集合
+ */
+export const calc_util: {
+    /**
+     * 检查当前库是否有更新版本
+     */
+    check_update(): void;
+    /**
+     * 打印当前库的版本
+     */
+    print_version(): void;
+};
 
 export const parse_thousands: (str: string) => string;
 
@@ -415,6 +414,85 @@ export const ln: UnaryOp;
  */
 export const exp: UnaryOp;
 
+// ==================== 链式计算 API ====================
+
+/**
+ * 链式计算返回值类型
+ * 可以直接调用获取结果，也可以继续链式调用
+ */
+export interface ChainValue {
+    /** 获取结果，可选传入格式化字符串 */
+    (format?: string): string;
+    /** 链式加法 */
+    add(...nums: (NumOrStr | ChainValue)[]): ChainValue;
+    /** 链式减法 */
+    sub(...nums: (NumOrStr | ChainValue)[]): ChainValue;
+    /** 链式乘法 */
+    mul(...nums: (NumOrStr | ChainValue)[]): ChainValue;
+    /** 链式除法 */
+    div(...nums: (NumOrStr | ChainValue)[]): ChainValue;
+    /** 链式取模 */
+    mod(...nums: (NumOrStr | ChainValue)[]): ChainValue;
+    /** 链式幂运算 */
+    pow(...nums: (NumOrStr | ChainValue)[]): ChainValue;
+    /** 链式整除 */
+    idiv(...nums: (NumOrStr | ChainValue)[]): ChainValue;
+}
+
+/**
+ * 链式加法起始
+ * @example
+ * cadd(1, 2, 3)()           // => "6"
+ * cadd(1, 2).mul(3)()       // => "9"
+ * cadd(100).sub(50)("=2")   // => "50.00"
+ */
+export function cadd(...nums: (NumOrStr | ChainValue)[]): ChainValue;
+
+/**
+ * 链式减法起始
+ * @example
+ * csub(10, 3)()             // => "7"
+ * csub(100, 50).div(2)()    // => "25"
+ */
+export function csub(first: NumOrStr | ChainValue, ...rest: (NumOrStr | ChainValue)[]): ChainValue;
+
+/**
+ * 链式乘法起始
+ * @example
+ * cmul(2, 3, 4)()           // => "24"
+ * cmul(10).add(5)()         // => "15"
+ */
+export function cmul(...nums: (NumOrStr | ChainValue)[]): ChainValue;
+
+/**
+ * 链式除法起始
+ * @example
+ * cdiv(100, 2)()            // => "50"
+ * cdiv(100, 2, 5)()         // => "10"
+ */
+export function cdiv(first: NumOrStr | ChainValue, ...rest: (NumOrStr | ChainValue)[]): ChainValue;
+
+/**
+ * 链式取模起始
+ * @example
+ * cmod(10, 3)()             // => "1"
+ */
+export function cmod(first: NumOrStr | ChainValue, ...rest: (NumOrStr | ChainValue)[]): ChainValue;
+
+/**
+ * 链式幂运算起始
+ * @example
+ * cpow(2, 3)()              // => "8"
+ */
+export function cpow(first: NumOrStr | ChainValue, ...rest: (NumOrStr | ChainValue)[]): ChainValue;
+
+/**
+ * 链式整除起始
+ * @example
+ * cidiv(10, 3)()            // => "3"
+ */
+export function cidiv(first: NumOrStr | ChainValue, ...rest: (NumOrStr | ChainValue)[]): ChainValue;
+
 // ==================== 计算模式 ====================
 
 /**
@@ -441,7 +519,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 +528,7 @@ export type UnitConvertRule =
 export type UnitConvertOut = Record<string, Record<string, UnitConvertRule> & {
     _position?: 'before' | 'after' | 'middle';
     _thousands?: string;
-    _vol?: string;
+    _compact?: string;
 }>;
 
 /**
@@ -460,7 +538,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 +546,7 @@ 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';
 
 /**
  * 紧凑格式预设名称（系统内置）
@@ -502,9 +580,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: {  // 自定义函数形式
@@ -621,7 +699,7 @@ export function reset_config(key: keyof GlobalConfig): void;
 export function reset_config(keys: (keyof GlobalConfig)[]): void;
 
 /**
- * 运算符方法类型（内部使用，通过 r* 函数访问）
+ * 运算符方法类型（跟随 _compute_mode 配置变化）
  */
 export interface Ops {
     // 基础运算
@@ -673,6 +751,11 @@ export interface Ops {
     gte: (a: string, b: string) => boolean;
 }
 
+/**
+ * 原始运算符对象（跟随 _compute_mode 配置变化）
+ */
+export const ops: Ops;
+
 /**
  * 加载 WASM 模块（异步）
  * @returns Promise，加载完成后 resolve
@@ -752,4 +835,176 @@ export function req(a: string, b: string): boolean;
 export function rlt(a: string, b: string): boolean;
 export function rgt(a: string, b: string): boolean;
 export function rlte(a: string, b: string): boolean;
-export function rgte(a: string, b: string): boolean;
+export function rgte(a: string, b: string): boolean;
+
+// ==================== d 前缀原始运算函数（decimal 模式） ====================
+// 这些函数始终使用 decimal.js 进行计算，不受 _compute_mode 配置影响
+
+// 基础运算
+export function dadd(a: string, b: string): string;
+export function dsub(a: string, b: string): string;
+export function dmul(a: string, b: string): string;
+export function ddiv(a: string, b: string): string;
+export function dmod(a: string, b: string): string;
+export function dpow(a: string, b: string): string;
+export function didiv(a: string, b: string): string;
+
+// 一元运算
+export function dabs(a: string): string;
+export function dneg(a: string): string;
+export function dsqrt(a: string): string;
+export function dcbrt(a: string): string;
+
+// 指数对数
+export function dexp(a: string): string;
+export function dln(a: string): string;
+export function dlog(a: string, base: string): string;
+export function dlog2(a: string): string;
+export function dlog10(a: string): string;
+
+// 三角函数
+export function dsin(a: string): string;
+export function dcos(a: string): string;
+export function dtan(a: string): string;
+export function dasin(a: string): string;
+export function dacos(a: string): string;
+export function datan(a: string): string;
+
+// 双曲函数
+export function dsinh(a: string): string;
+export function dcosh(a: string): string;
+export function dtanh(a: string): string;
+export function dasinh(a: string): string;
+export function dacosh(a: string): string;
+export function datanh(a: string): string;
+
+// 取整
+export function dfloor(a: string): string;
+export function dceil(a: string): string;
+export function dtrunc(a: string): string;
+export function dround(a: string): string;
+
+// 比较
+export function dmax(a: string, b: string): string;
+export function dmin(a: string, b: string): string;
+export function dcompare(a: string, b: string): number;
+export function deq(a: string, b: string): boolean;
+export function dlt(a: string, b: string): boolean;
+export function dgt(a: string, b: string): boolean;
+export function dlte(a: string, b: string): boolean;
+export function dgte(a: string, b: string): boolean;
+
+// ==================== b 前缀原始运算函数（bigint 模式） ====================
+// 这些函数始终使用 BigInt 进行计算，不受 _compute_mode 配置影响
+
+// 基础运算
+export function badd(a: string, b: string): string;
+export function bsub(a: string, b: string): string;
+export function bmul(a: string, b: string): string;
+export function bdiv(a: string, b: string): string;
+export function bmod(a: string, b: string): string;
+export function bpow(a: string, b: string): string;
+export function bidiv(a: string, b: string): string;
+
+// 一元运算
+export function babs(a: string): string;
+export function bneg(a: string): string;
+export function bsqrt(a: string): string;
+export function bcbrt(a: string): string;
+
+// 指数对数
+export function bexp(a: string): string;
+export function bln(a: string): string;
+export function blog(a: string, base: string): string;
+export function blog2(a: string): string;
+export function blog10(a: string): string;
+
+// 三角函数
+export function bsin(a: string): string;
+export function bcos(a: string): string;
+export function btan(a: string): string;
+export function basin(a: string): string;
+export function bacos(a: string): string;
+export function batan(a: string): string;
+
+// 双曲函数
+export function bsinh(a: string): string;
+export function bcosh(a: string): string;
+export function btanh(a: string): string;
+export function basinh(a: string): string;
+export function bacosh(a: string): string;
+export function batanh(a: string): string;
+
+// 取整
+export function bfloor(a: string): string;
+export function bceil(a: string): string;
+export function btrunc(a: string): string;
+export function bround(a: string): string;
+
+// 比较
+export function bmax(a: string, b: string): string;
+export function bmin(a: string, b: string): string;
+export function bcompare(a: string, b: string): number;
+export function beq(a: string, b: string): boolean;
+export function blt(a: string, b: string): boolean;
+export function bgt(a: string, b: string): boolean;
+export function blte(a: string, b: string): boolean;
+export function bgte(a: string, b: string): boolean;
+
+// ==================== w 前缀原始运算函数（wasm 模式） ====================
+// 这些函数使用 WASM 进行计算，首次调用时自动触发 WASM 加载
+// 加载完成前使用 decimal 模式兜底
+
+// 基础运算
+export function wadd(a: string, b: string): string;
+export function wsub(a: string, b: string): string;
+export function wmul(a: string, b: string): string;
+export function wdiv(a: string, b: string): string;
+export function wmod(a: string, b: string): string;
+export function wpow(a: string, b: string): string;
+export function widiv(a: string, b: string): string;
+
+// 一元运算
+export function wabs(a: string): string;
+export function wneg(a: string): string;
+export function wsqrt(a: string): string;
+export function wcbrt(a: string): string;
+
+// 指数对数
+export function wexp(a: string): string;
+export function wln(a: string): string;
+export function wlog(a: string, base: string): string;
+export function wlog2(a: string): string;
+export function wlog10(a: string): string;
+
+// 三角函数
+export function wsin(a: string): string;
+export function wcos(a: string): string;
+export function wtan(a: string): string;
+export function wasin(a: string): string;
+export function wacos(a: string): string;
+export function watan(a: string): string;
+
+// 双曲函数
+export function wsinh(a: string): string;
+export function wcosh(a: string): string;
+export function wtanh(a: string): string;
+export function wasinh(a: string): string;
+export function wacosh(a: string): string;
+export function watanh(a: string): string;
+
+// 取整
+export function wfloor(a: string): string;
+export function wceil(a: string): string;
+export function wtrunc(a: string): string;
+export function wround(a: string): string;
+
+// 比较
+export function wmax(a: string, b: string): string;
+export function wmin(a: string, b: string): string;
+export function wcompare(a: string, b: string): number;
+export function weq(a: string, b: string): boolean;
+export function wlt(a: string, b: string): boolean;
+export function wgt(a: string, b: string): boolean;
+export function wlte(a: string, b: string): boolean;
+export function wgte(a: string, b: string): boolean;