@syncfusion/ej2-calculate 35.1.37

package/src/formulas/math-trig-hyperbolic.d.ts

@@ -0,0 +1,55 @@
+import { IBasicFormula } from '../common/index';
+import { FormulaOwner } from './formula-owner';
+import { FormulaModuleBase } from './formula-module-base';
+/**
+ * Hyperbolic trigonometric functions and their inverses for exponential growth/decay modeling.
+ *
+ * Registered functions: ACOSH, ASINH, ATANH.
+ *
+ * @hidden
+ */
+export declare class MathTrigHyperbolicFormulas extends FormulaModuleBase {
+    /** Formula definitions registered with {@link BasicFormulas}. */
+    formulas: IBasicFormula[];
+    /**
+     * @hidden
+     * @param {FormulaOwner} owner - Formula registration owner ({@link BasicFormulas}).
+     */
+    constructor(owner: FormulaOwner);
+    private unaryMath;
+    /**
+     * Returns the inverse hyperbolic cosine of a number.
+     *
+     * Excel: `ACOSH(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     *
+     * @example
+     * ```ts
+     * engine.computeFormula('=ACOSH(1)');
+     * ```
+     */
+    ComputeACOSH(...args: string[]): string | number;
+    /**
+     * Returns the inverse hyperbolic sine of a number.
+     *
+     * Excel: `ASINH(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    ComputeASINH(...args: string[]): string | number;
+    /**
+     * Returns the inverse hyperbolic tangent of a number.
+     *
+     * Excel: `ATANH(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    ComputeATANH(...args: string[]): string | number;
+}

package/src/formulas/math-trig-hyperbolic.js

@@ -0,0 +1,113 @@
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+import { FormulasErrorsStrings, CommonErrors } from '../common/index';
+import { isNullOrUndefined } from '@syncfusion/ej2-base';
+import { FormulaModuleBase } from './formula-module-base';
+/**
+ * Hyperbolic trigonometric functions and their inverses for exponential growth/decay modeling.
+ *
+ * Registered functions: ACOSH, ASINH, ATANH.
+ *
+ * @hidden
+ */
+var MathTrigHyperbolicFormulas = /** @class */ (function (_super) {
+    __extends(MathTrigHyperbolicFormulas, _super);
+    /**
+     * @hidden
+     * @param {FormulaOwner} owner - Formula registration owner ({@link BasicFormulas}).
+     */
+    function MathTrigHyperbolicFormulas(owner) {
+        var _this = _super.call(this, owner) || this;
+        /** Formula definitions registered with {@link BasicFormulas}. */
+        _this.formulas = [
+            { formulaName: 'ACOSH', category: 'Math & Trig', description: 'Returns the inverse hyperbolic cosine of a number.' },
+            { formulaName: 'ASINH', category: 'Math & Trig', description: 'Returns the inverse hyperbolic sine of a number.' },
+            { formulaName: 'ATANH', category: 'Math & Trig', description: 'Returns the inverse hyperbolic tangent of a number.' }
+        ];
+        return _this;
+    }
+    MathTrigHyperbolicFormulas.prototype.unaryMath = function (args, fn, domainCheck) {
+        var errCollection = this.parent.getErrorStrings();
+        if (isNullOrUndefined(args) || args.length !== 1 || args[0] === '') {
+            return this.parent.formulaErrorStrings[FormulasErrorsStrings.WrongNumberArguments];
+        }
+        var num = this.resolveNumberArg(args[0]);
+        if (typeof num === 'string') {
+            return num;
+        }
+        if (domainCheck && !domainCheck(num)) {
+            return errCollection[CommonErrors.Num];
+        }
+        var result = fn(num);
+        if (!isFinite(result)) {
+            return errCollection[CommonErrors.Num];
+        }
+        return result.toString();
+    };
+    /**
+     * Returns the inverse hyperbolic cosine of a number.
+     *
+     * Excel: `ACOSH(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     *
+     * @example
+     * ```ts
+     * engine.computeFormula('=ACOSH(1)');
+     * ```
+     */
+    MathTrigHyperbolicFormulas.prototype.ComputeACOSH = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        return this.unaryMath(args, Math.acosh, function (n) { return n >= 1; });
+    };
+    /**
+     * Returns the inverse hyperbolic sine of a number.
+     *
+     * Excel: `ASINH(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    MathTrigHyperbolicFormulas.prototype.ComputeASINH = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        return this.unaryMath(args, Math.asinh);
+    };
+    /**
+     * Returns the inverse hyperbolic tangent of a number.
+     *
+     * Excel: `ATANH(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    MathTrigHyperbolicFormulas.prototype.ComputeATANH = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        return this.unaryMath(args, Math.atanh, function (n) { return n > -1 && n < 1; });
+    };
+    return MathTrigHyperbolicFormulas;
+}(FormulaModuleBase));
+export { MathTrigHyperbolicFormulas };

package/src/formulas/math-trig.d.ts

@@ -0,0 +1,165 @@
+import { IBasicFormula } from '../common/index';
+import { FormulaOwner } from './formula-owner';
+import { FormulaModuleBase } from './formula-module-base';
+/**
+ * Standard trigonometric functions (SIN, COS, TAN, and inverses) operating on angles in radians.
+ *
+ * Registers 14 functions including SIN, COS, TAN, ASIN, ACOS, and others.
+ *
+ * @hidden
+ */
+export declare class MathTrigFormulas extends FormulaModuleBase {
+    /** Formula definitions registered with {@link BasicFormulas}. */
+    formulas: IBasicFormula[];
+    /**
+     * @hidden
+     * @param {FormulaOwner} owner - Formula registration owner ({@link BasicFormulas}).
+     */
+    constructor(owner: FormulaOwner);
+    private unaryMath;
+    /**
+     * Returns the sine of an angle.
+     *
+     * Excel: `SIN(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     *
+     * @example
+     * ```ts
+     * engine.computeFormula('=SIN(1)');
+     * ```
+     */
+    ComputeSIN(...args: string[]): string | number;
+    /**
+     * Returns the cosine of an angle.
+     *
+     * Excel: `COS(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    ComputeCOS(...args: string[]): string | number;
+    /**
+     * Returns the tangent of an angle.
+     *
+     * Excel: `TAN(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    ComputeTAN(...args: string[]): string | number;
+    /**
+     * Returns the arcsine of a number.
+     *
+     * Excel: `ASIN(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    ComputeASIN(...args: string[]): string | number;
+    /**
+     * Returns the arccosine of a number.
+     *
+     * Excel: `ACOS(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    ComputeACOS(...args: string[]): string | number;
+    /**
+     * Returns the arctangent of a number.
+     *
+     * Excel: `ATAN(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    ComputeATAN(...args: string[]): string | number;
+    /**
+     * Returns the hyperbolic sine of a number.
+     *
+     * Excel: `SINH(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    ComputeSINH(...args: string[]): string | number;
+    /**
+     * Returns the hyperbolic cosine of a number.
+     *
+     * Excel: `COSH(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    ComputeCOSH(...args: string[]): string | number;
+    /**
+     * Returns the hyperbolic tangent of a number.
+     *
+     * Excel: `TANH(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    ComputeTANH(...args: string[]): string | number;
+    /**
+     * Returns the base-10 logarithm of a number.
+     *
+     * Excel: `LOG10(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    ComputeLOG10(...args: string[]): string | number;
+    /**
+     * Returns the square root of a number multiplied by pi.
+     *
+     * Excel: `SQRTPI(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    ComputeSQRTPI(...args: string[]): string | number;
+    /**
+     * Returns the arctangent from x- and y-coordinates.
+     *
+     * Excel: `ATAN2(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    ComputeATAN2(...args: string[]): string | number;
+    /**
+     * Returns the sign of a number.
+     *
+     * Excel: `SIGN(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    ComputeSIGN(...args: string[]): string | number;
+    /**
+     * Returns the integer portion of a division.
+     *
+     * Excel: `QUOTIENT(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    ComputeQUOTIENT(...args: string[]): string | number;
+}

package/src/formulas/math-trig.js

@@ -0,0 +1,334 @@
+var __extends = (this && this.__extends) || (function () {
+    var extendStatics = function (d, b) {
+        extendStatics = Object.setPrototypeOf ||
+            ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+            function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+        return extendStatics(d, b);
+    };
+    return function (d, b) {
+        extendStatics(d, b);
+        function __() { this.constructor = d; }
+        d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+    };
+})();
+import { FormulasErrorsStrings, CommonErrors } from '../common/index';
+import { isNullOrUndefined } from '@syncfusion/ej2-base';
+import { FormulaModuleBase } from './formula-module-base';
+/**
+ * Standard trigonometric functions (SIN, COS, TAN, and inverses) operating on angles in radians.
+ *
+ * Registers 14 functions including SIN, COS, TAN, ASIN, ACOS, and others.
+ *
+ * @hidden
+ */
+var MathTrigFormulas = /** @class */ (function (_super) {
+    __extends(MathTrigFormulas, _super);
+    /**
+     * @hidden
+     * @param {FormulaOwner} owner - Formula registration owner ({@link BasicFormulas}).
+     */
+    function MathTrigFormulas(owner) {
+        var _this = _super.call(this, owner) || this;
+        /** Formula definitions registered with {@link BasicFormulas}. */
+        _this.formulas = [
+            { formulaName: 'SIN', category: 'Math & Trig', description: 'Returns the sine of an angle.' },
+            { formulaName: 'COS', category: 'Math & Trig', description: 'Returns the cosine of an angle.' },
+            { formulaName: 'TAN', category: 'Math & Trig', description: 'Returns the tangent of an angle.' },
+            { formulaName: 'ASIN', category: 'Math & Trig', description: 'Returns the arcsine of a number.' },
+            { formulaName: 'ACOS', category: 'Math & Trig', description: 'Returns the arccosine of a number.' },
+            { formulaName: 'ATAN', category: 'Math & Trig', description: 'Returns the arctangent of a number.' },
+            { formulaName: 'ATAN2', category: 'Math & Trig', description: 'Returns the arctangent from x- and y-coordinates.' },
+            { formulaName: 'SINH', category: 'Math & Trig', description: 'Returns the hyperbolic sine of a number.' },
+            { formulaName: 'COSH', category: 'Math & Trig', description: 'Returns the hyperbolic cosine of a number.' },
+            { formulaName: 'TANH', category: 'Math & Trig', description: 'Returns the hyperbolic tangent of a number.' },
+            { formulaName: 'SIGN', category: 'Math & Trig', description: 'Returns the sign of a number.' },
+            { formulaName: 'LOG10', category: 'Math & Trig', description: 'Returns the base-10 logarithm of a number.' },
+            { formulaName: 'QUOTIENT', category: 'Math & Trig', description: 'Returns the integer portion of a division.' },
+            { formulaName: 'SQRTPI', category: 'Math & Trig', description: 'Returns the square root of a number multiplied by pi.' }
+        ];
+        return _this;
+    }
+    MathTrigFormulas.prototype.unaryMath = function (args, fn, domainCheck) {
+        var errCollection = this.parent.getErrorStrings();
+        if (isNullOrUndefined(args) || args.length !== 1 || args[0] === '') {
+            return this.parent.formulaErrorStrings[FormulasErrorsStrings.WrongNumberArguments];
+        }
+        var num = this.resolveNumberArg(args[0]);
+        if (typeof num === 'string') {
+            return num;
+        }
+        if (domainCheck && !domainCheck(num)) {
+            return errCollection[CommonErrors.Num];
+        }
+        return fn(num).toString();
+    };
+    /**
+     * Returns the sine of an angle.
+     *
+     * Excel: `SIN(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     *
+     * @example
+     * ```ts
+     * engine.computeFormula('=SIN(1)');
+     * ```
+     */
+    MathTrigFormulas.prototype.ComputeSIN = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        return this.unaryMath(args, Math.sin);
+    };
+    /**
+     * Returns the cosine of an angle.
+     *
+     * Excel: `COS(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    MathTrigFormulas.prototype.ComputeCOS = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        return this.unaryMath(args, Math.cos);
+    };
+    /**
+     * Returns the tangent of an angle.
+     *
+     * Excel: `TAN(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    MathTrigFormulas.prototype.ComputeTAN = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        return this.unaryMath(args, Math.tan);
+    };
+    /**
+     * Returns the arcsine of a number.
+     *
+     * Excel: `ASIN(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    MathTrigFormulas.prototype.ComputeASIN = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        return this.unaryMath(args, Math.asin, function (n) { return n >= -1 && n <= 1; });
+    };
+    /**
+     * Returns the arccosine of a number.
+     *
+     * Excel: `ACOS(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    MathTrigFormulas.prototype.ComputeACOS = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        return this.unaryMath(args, Math.acos, function (n) { return n >= -1 && n <= 1; });
+    };
+    /**
+     * Returns the arctangent of a number.
+     *
+     * Excel: `ATAN(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    MathTrigFormulas.prototype.ComputeATAN = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        return this.unaryMath(args, Math.atan);
+    };
+    /**
+     * Returns the hyperbolic sine of a number.
+     *
+     * Excel: `SINH(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    MathTrigFormulas.prototype.ComputeSINH = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        return this.unaryMath(args, Math.sinh);
+    };
+    /**
+     * Returns the hyperbolic cosine of a number.
+     *
+     * Excel: `COSH(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    MathTrigFormulas.prototype.ComputeCOSH = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        return this.unaryMath(args, Math.cosh);
+    };
+    /**
+     * Returns the hyperbolic tangent of a number.
+     *
+     * Excel: `TANH(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    MathTrigFormulas.prototype.ComputeTANH = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        return this.unaryMath(args, Math.tanh);
+    };
+    /**
+     * Returns the base-10 logarithm of a number.
+     *
+     * Excel: `LOG10(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    MathTrigFormulas.prototype.ComputeLOG10 = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        return this.unaryMath(args, Math.log10, function (n) { return n > 0; });
+    };
+    /**
+     * Returns the square root of a number multiplied by pi.
+     *
+     * Excel: `SQRTPI(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    MathTrigFormulas.prototype.ComputeSQRTPI = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        return this.unaryMath(args, function (n) { return Math.sqrt(n * Math.PI); }, function (n) { return n >= 0; });
+    };
+    /**
+     * Returns the arctangent from x- and y-coordinates.
+     *
+     * Excel: `ATAN2(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    MathTrigFormulas.prototype.ComputeATAN2 = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        var errCollection = this.parent.getErrorStrings();
+        if (isNullOrUndefined(args) || args.length !== 2) {
+            return this.parent.formulaErrorStrings[FormulasErrorsStrings.WrongNumberArguments];
+        }
+        var x = this.resolveNumberArg(args[0]);
+        var y = this.resolveNumberArg(args[1]);
+        if (typeof x === 'string') {
+            return x;
+        }
+        if (typeof y === 'string') {
+            return y;
+        }
+        if (x === 0 && y === 0) {
+            return errCollection[CommonErrors.DivZero];
+        }
+        // Excel ATAN2(x_num, y_num) is atan2(y, x) in JS terms (x first).
+        return Math.atan2(y, x).toString();
+    };
+    /**
+     * Returns the sign of a number.
+     *
+     * Excel: `SIGN(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    MathTrigFormulas.prototype.ComputeSIGN = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        if (isNullOrUndefined(args) || args.length !== 1) {
+            return this.parent.formulaErrorStrings[FormulasErrorsStrings.WrongNumberArguments];
+        }
+        var num = this.resolveNumberArg(args[0]);
+        if (typeof num === 'string') {
+            return num;
+        }
+        return (num > 0 ? 1 : num < 0 ? -1 : 0).toString();
+    };
+    /**
+     * Returns the integer portion of a division.
+     *
+     * Excel: `QUOTIENT(...)`.
+     *
+     * @hidden
+     * @param {string[]} args - Formula argument tokens from the Calculate engine.
+     * @returns {string | number} - Computed Excel-compatible numeric or text result, or an error token such as `#VALUE!`, `#NUM!`, `#N/A`.
+     */
+    MathTrigFormulas.prototype.ComputeQUOTIENT = function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        var errCollection = this.parent.getErrorStrings();
+        if (isNullOrUndefined(args) || args.length !== 2) {
+            return this.parent.formulaErrorStrings[FormulasErrorsStrings.WrongNumberArguments];
+        }
+        var numerator = this.resolveNumberArg(args[0]);
+        var denominator = this.resolveNumberArg(args[1]);
+        if (typeof numerator === 'string') {
+            return numerator;
+        }
+        if (typeof denominator === 'string') {
+            return denominator;
+        }
+        if (denominator === 0) {
+            return errCollection[CommonErrors.DivZero];
+        }
+        return Math.trunc(numerator / denominator).toString();
+    };
+    return MathTrigFormulas;
+}(FormulaModuleBase));
+export { MathTrigFormulas };

package/src/formulas/matrix-base.d.ts

@@ -0,0 +1,13 @@
+import { FormulaModuleBase } from './formula-module-base';
+/**
+ * Shared matrix helpers for MDETERM / MINVERSE / MMULT / TRANSPOSE.
+ *
+ * @hidden
+ */
+export declare class MatrixFormulaBase extends FormulaModuleBase {
+    protected readMatrix(ref: string): number[][] | string;
+    protected flattenMatrix(matrix: number[][], transpose?: boolean): string;
+    protected determinant(m: number[][]): number;
+    protected inverse(m: number[][]): number[][] | null;
+    protected multiply(a: number[][], b: number[][]): number[][] | null;
+}