feat(core): initial release of financial calculation package with decimal precision

ts/calculation.classes.calculator.ts

@@ -0,0 +1,178 @@
+import * as plugins from './calculation.plugins.js';
+
+export interface ICalculatorOptions {
+  precision?: number;
+  rounding?: plugins.Decimal.Rounding;
+}
+
+/**
+ * Base calculator class providing high-precision decimal arithmetic
+ * for financial calculations
+ */
+export class Calculator {
+  private precision: number;
+  private rounding: plugins.Decimal.Rounding;
+
+  constructor(options: ICalculatorOptions = {}) {
+    this.precision = options.precision || 10;
+    this.rounding = options.rounding || plugins.Decimal.ROUND_HALF_UP;
+    
+    // Configure Decimal.js globally for this calculator instance
+    plugins.Decimal.set({
+      precision: this.precision,
+      rounding: this.rounding
+    });
+  }
+
+  /**
+   * Create a Decimal instance from a value
+   */
+  public decimal(value: plugins.Decimal.Value): plugins.Decimal {
+    return new plugins.Decimal(value);
+  }
+
+  /**
+   * Add two or more numbers with decimal precision
+   */
+  public add(...values: plugins.Decimal.Value[]): plugins.Decimal {
+    return values.reduce<plugins.Decimal>((sum, value) => {
+      return sum.add(this.decimal(value));
+    }, new plugins.Decimal(0));
+  }
+
+  /**
+   * Subtract numbers with decimal precision
+   */
+  public subtract(minuend: plugins.Decimal.Value, ...subtrahends: plugins.Decimal.Value[]): plugins.Decimal {
+    let result = new plugins.Decimal(minuend);
+    for (const subtrahend of subtrahends) {
+      result = result.sub(subtrahend);
+    }
+    return result;
+  }
+
+  /**
+   * Multiply numbers with decimal precision
+   */
+  public multiply(...values: plugins.Decimal.Value[]): plugins.Decimal {
+    return values.reduce<plugins.Decimal>((product, value) => {
+      return product.mul(this.decimal(value));
+    }, new plugins.Decimal(1));
+  }
+
+  /**
+   * Divide numbers with decimal precision
+   */
+  public divide(dividend: plugins.Decimal.Value, divisor: plugins.Decimal.Value): plugins.Decimal {
+    const divisorDecimal = new plugins.Decimal(divisor);
+    if (divisorDecimal.isZero()) {
+      throw new Error('Division by zero');
+    }
+    return new plugins.Decimal(dividend).div(divisor);
+  }
+
+  /**
+   * Calculate power with decimal precision
+   */
+  public power(base: plugins.Decimal.Value, exponent: plugins.Decimal.Value): plugins.Decimal {
+    return new plugins.Decimal(base).pow(exponent);
+  }
+
+  /**
+   * Calculate square root with decimal precision
+   */
+  public sqrt(value: plugins.Decimal.Value): plugins.Decimal {
+    return new plugins.Decimal(value).sqrt();
+  }
+
+  /**
+   * Calculate natural logarithm with decimal precision
+   */
+  public ln(value: plugins.Decimal.Value): plugins.Decimal {
+    return new plugins.Decimal(value).ln();
+  }
+
+  /**
+   * Calculate logarithm base 10 with decimal precision
+   */
+  public log10(value: plugins.Decimal.Value): plugins.Decimal {
+    return new plugins.Decimal(value).log();
+  }
+
+  /**
+   * Calculate exponential (e^x) with decimal precision
+   */
+  public exp(value: plugins.Decimal.Value): plugins.Decimal {
+    return new plugins.Decimal(value).exp();
+  }
+
+  /**
+   * Round a number to specified decimal places
+   */
+  public round(value: plugins.Decimal.Value, decimalPlaces: number = 0): plugins.Decimal {
+    return new plugins.Decimal(value).toDecimalPlaces(decimalPlaces);
+  }
+
+  /**
+   * Check if a value equals another value
+   */
+  public equals(value1: plugins.Decimal.Value, value2: plugins.Decimal.Value): boolean {
+    return new plugins.Decimal(value1).equals(value2);
+  }
+
+  /**
+   * Check if a value is greater than another value
+   */
+  public greaterThan(value1: plugins.Decimal.Value, value2: plugins.Decimal.Value): boolean {
+    return new plugins.Decimal(value1).greaterThan(value2);
+  }
+
+  /**
+   * Check if a value is less than another value
+   */
+  public lessThan(value1: plugins.Decimal.Value, value2: plugins.Decimal.Value): boolean {
+    return new plugins.Decimal(value1).lessThan(value2);
+  }
+
+  /**
+   * Get the minimum value from an array of values
+   */
+  public min(...values: plugins.Decimal.Value[]): plugins.Decimal {
+    return plugins.Decimal.min(...values);
+  }
+
+  /**
+   * Get the maximum value from an array of values
+   */
+  public max(...values: plugins.Decimal.Value[]): plugins.Decimal {
+    return plugins.Decimal.max(...values);
+  }
+
+  /**
+   * Calculate the absolute value
+   */
+  public abs(value: plugins.Decimal.Value): plugins.Decimal {
+    return new plugins.Decimal(value).abs();
+  }
+
+  /**
+   * Convert a decimal to a regular number
+   */
+  public toNumber(value: plugins.Decimal.Value): number {
+    return new plugins.Decimal(value).toNumber();
+  }
+
+  /**
+   * Convert a decimal to a string
+   */
+  public toString(value: plugins.Decimal.Value): string {
+    return new plugins.Decimal(value).toString();
+  }
+
+  /**
+   * Convert a decimal to a fixed-point string
+   */
+  public toFixed(value: plugins.Decimal.Value, decimalPlaces: number = 2): string {
+    return new plugins.Decimal(value).toFixed(decimalPlaces);
+  }
+}