@danielsimonjr/mathts-compat 0.1.8 → 0.2.0

package/dist/index.d.ts

@@ -66,6 +66,9 @@ declare function atan(x: number): number;
 declare function atan2(y: number, x: number): number;
 declare const sum: typeof sum$1;
 declare const mean: typeof mean$1;
+type Normalization = 'unbiased' | 'uncorrected' | 'biased';
+declare function variance(data: unknown, normalization?: Normalization): number;
+declare function std(data: unknown, normalization?: Normalization): number;
 declare const min: typeof min$1;
 declare const max: typeof max$1;
 declare const gcd: typeof gcd$1;
@@ -90,9 +93,10 @@ declare function im(c: Complex | number): number;
  */
 declare function arg(c: Complex): number;
 /**
- * Transpose matrix (mathjs-compatible)
+ * Transpose matrix (mathjs-compatible). Array in → array out (mathjs returns a
+ * plain nested array for array input, a Matrix for Matrix input).
  */
-declare function transpose(m: DenseMatrix | SparseMatrix | number[][]): DenseMatrix | SparseMatrix;
+declare function transpose(m: DenseMatrix | SparseMatrix | number[][]): DenseMatrix | SparseMatrix | number[][];
 /**
  * Matrix determinant (mathjs-compatible)
  *
@@ -157,6 +161,8 @@ declare const shims: {
     atan2: typeof atan2;
     sum: typeof sum$1;
     mean: typeof mean$1;
+    std: typeof std;
+    variance: typeof variance;
     min: typeof min$1;
     max: typeof max$1;
     gcd: typeof gcd$1;
@@ -194,6 +200,21 @@ declare const shims: {
     NaN: number;
 };
 
+/**
+ * GC12 — mathjs-style fluent `chain` API.
+ *
+ *   chain(3).add(4).multiply(2).done()   // 14
+ *
+ * Each math function `f` becomes a chain method that calls `f(value, ...args)`
+ * and returns a new chain wrapping the result. `.done()` / `.valueOf()` unwrap.
+ */
+interface Chain {
+    done(): unknown;
+    valueOf(): unknown;
+    toString(): string;
+    [method: string]: (...args: unknown[]) => Chain | unknown;
+}
+
 /**
  * @danielsimonjr/mathts-compat - mathjs Compatibility Layer
  *
@@ -239,6 +260,8 @@ interface MathInstance {
      * `unknown` and can be narrowed by the caller.
      */
     [name: string]: unknown;
+    /** Fluent chain: `math.chain(x).add(3).done()`. */
+    chain: (value: unknown) => Chain;
     config: (newConfig?: Partial<MathJSConfig>) => MathJSConfig;
     complex: typeof shims.complex;
     fraction: typeof shims.fraction;
@@ -263,6 +286,8 @@ interface MathInstance {
     atan2: typeof shims.atan2;
     sum: typeof shims.sum;
     mean: typeof shims.mean;
+    std: typeof shims.std;
+    variance: typeof shims.variance;
     min: typeof shims.min;
     max: typeof shims.max;
     gcd: typeof shims.gcd;
@@ -326,4 +351,4 @@ declare function create(factories?: Record<string, unknown>, config?: Partial<Ma
  */
 declare const all: Record<string, unknown>;
 
-export { Infinity_, LN10, LN2, LOG10E, LOG2E, type MathInstance, type MathJSConfig, NaN_, SQRT1_2, SQRT2, abs, acos, add, all, arg, asin, atan, atan2, bignumber, ceil, complex, conj, cos, create, det, divide, e, exp, floor, fraction, gcd, i, identity, im, isBigNumber_, isComplex_, isFraction_, isMatrix, isNumber_, lcm, log, matrix, max, mean, min, multiply, ones, phi, pi, pow, re, round, shims, sin, size, sparse, sqrt, subtract, sum, tan, tau, transpose, zeros };
+export { Infinity_, LN10, LN2, LOG10E, LOG2E, type MathInstance, type MathJSConfig, NaN_, SQRT1_2, SQRT2, abs, acos, add, all, arg, asin, atan, atan2, bignumber, ceil, complex, conj, cos, create, det, divide, e, exp, floor, fraction, gcd, i, identity, im, isBigNumber_, isComplex_, isFraction_, isMatrix, isNumber_, lcm, log, matrix, max, mean, min, multiply, ones, phi, pi, pow, re, round, shims, sin, size, sparse, sqrt, std, subtract, sum, tan, tau, transpose, variance, zeros };

package/dist/index.js

@@ -33,7 +33,13 @@ import {
   floor as _floor,
   ceil as _ceil
 } from "@danielsimonjr/mathts-functions";
-import { DenseMatrix, SparseMatrix } from "@danielsimonjr/mathts-matrix";
+import {
+  DenseMatrix,
+  SparseMatrix,
+  add as _matAdd,
+  subtract as _matSubtract,
+  multiply as _matMultiply
+} from "@danielsimonjr/mathts-matrix";
 function complex(re2, im2) {
   if (re2 === void 0) {
     return COMPLEX_ZERO;
@@ -92,9 +98,38 @@ function sparse(data) {
   }
   return SparseMatrix.fromDense(DenseMatrix.fromArray(data));
 }
-var add = _add;
-var subtract = _subtract;
-var multiply = _multiply;
+var isMatrixLike = (x) => x instanceof DenseMatrix || Array.isArray(x) && x.length > 0 && Array.isArray(x[0]);
+var toDenseMatrix = (x) => x instanceof DenseMatrix ? x : DenseMatrix.fromArray(x);
+var unwrap = (r) => r instanceof DenseMatrix ? r.toArray() : r;
+var applyArithmetic = (scalarFn, matrixFn, a, b) => {
+  if (isMatrixLike(a) || isMatrixLike(b)) {
+    const aa = isMatrixLike(a) ? toDenseMatrix(a) : a;
+    const bb = isMatrixLike(b) ? toDenseMatrix(b) : b;
+    return unwrap(matrixFn(aa, bb));
+  }
+  return scalarFn(a, b);
+};
+var makeArithmetic = (scalarFn, matrixFn) => (...args) => {
+  if (args.length === 0) {
+    throw new TypeError("Too few arguments (expected at least 1)");
+  }
+  if (args.length === 1) {
+    return args[0];
+  }
+  return args.reduce((acc, next) => applyArithmetic(scalarFn, matrixFn, acc, next));
+};
+var add = makeArithmetic(
+  _add,
+  _matAdd
+);
+var subtract = makeArithmetic(
+  _subtract,
+  _matSubtract
+);
+var multiply = makeArithmetic(
+  _multiply,
+  _matMultiply
+);
 var divide = _divide;
 var pow = _pow;
 var sqrt = _sqrt;
@@ -118,6 +153,23 @@ function atan2(y, x) {
 }
 var sum = _sum;
 var mean = _mean;
+function toNumericArray(data) {
+  if (data instanceof DenseMatrix) return data.toArray().flat(Infinity);
+  if (Array.isArray(data)) return data.flat(Infinity);
+  return [data];
+}
+function variance(data, normalization = "unbiased") {
+  const arr = toNumericArray(data);
+  const n = arr.length;
+  if (n === 0) return NaN;
+  const mu = arr.reduce((s, x) => s + x, 0) / n;
+  const ss = arr.reduce((s, x) => s + (x - mu) * (x - mu), 0);
+  const denom = normalization === "uncorrected" ? n : normalization === "biased" ? n + 1 : n > 1 ? n - 1 : n;
+  return ss / denom;
+}
+function std(data, normalization = "unbiased") {
+  return Math.sqrt(variance(data, normalization));
+}
 var min = _min;
 var max = _max;
 var gcd = _gcd;
@@ -149,7 +201,7 @@ function arg(c) {
 }
 function transpose(m) {
   if (Array.isArray(m)) {
-    return DenseMatrix.fromArray(m).transpose();
+    return DenseMatrix.fromArray(m).transpose().toArray();
   }
   return m.transpose();
 }
@@ -281,6 +333,8 @@ var shims = {
   // Statistics
   sum,
   mean,
+  std,
+  variance,
   min,
   max,
   // Number theory
@@ -324,6 +378,30 @@ var shims = {
   NaN: NaN_
 };
 
+// src/chain.ts
+function createChain(math) {
+  function chain(value) {
+    const base = {
+      done: () => value,
+      valueOf: () => value,
+      toString: () => String(value)
+    };
+    return new Proxy(base, {
+      get(target, prop) {
+        if (prop in target || typeof prop === "symbol") {
+          return target[prop];
+        }
+        const fn = math[prop];
+        if (typeof fn === "function") {
+          return (...args) => chain(fn(value, ...args));
+        }
+        return void 0;
+      }
+    });
+  }
+  return chain;
+}
+
 // src/index.ts
 import * as mathFunctions from "@danielsimonjr/mathts-functions";
 import {
@@ -351,7 +429,7 @@ var defaultConfig = {
 };
 function create(factories = all, config = {}) {
   const currentConfig = { ...defaultConfig, ...config };
-  return {
+  const instance = {
     // Full @danielsimonjr/mathts-functions namespace — det, integrate, eigs,
     // simplify, and the rest. The compat-specific shims below overlay it.
     ...factories,
@@ -389,6 +467,8 @@ function create(factories = all, config = {}) {
     // Statistics
     sum: shims.sum,
     mean: shims.mean,
+    std: shims.std,
+    variance: shims.variance,
     min: shims.min,
     max: shims.max,
     // Number theory
@@ -429,8 +509,15 @@ function create(factories = all, config = {}) {
     SQRT2: shims.SQRT2,
     SQRT1_2: shims.SQRT1_2,
     Infinity: shims.Infinity,
-    NaN: shims.NaN
+    NaN: shims.NaN,
+    // Placeholder; rebound below once `instance` exists so chain methods can
+    // resolve against the full surfaced namespace.
+    chain: (() => {
+      throw new Error("chain not initialized");
+    })
   };
+  instance.chain = createChain(instance);
+  return instance;
 }
 var all = {
   ...mathFunctions
@@ -506,10 +593,12 @@ export {
   size,
   sparse,
   sqrt,
+  std,
   subtract,
   sum,
   tan,
   tau,
   transpose,
+  variance,
   zeros
 };

package/package.json

@@ -1,56 +1,56 @@
-{
-  "name": "@danielsimonjr/mathts-compat",
-  "version": "0.1.8",
-  "description": "mathjs compatibility layer for MathTS",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsup src/index.ts --format esm --dts --clean",
-    "dev": "tsup src/index.ts --format esm --dts --watch",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "build:prod": "tsup src/index.ts --format esm --dts --clean --minify --treeshake"
-  },
-  "dependencies": {
-    "@danielsimonjr/mathts-core": "^0.1.4",
-    "@danielsimonjr/mathts-functions": "^0.2.7",
-    "@danielsimonjr/mathts-matrix": "^0.1.6",
-    "@danielsimonjr/mathts-parallel": "^0.2.2"
-  },
-  "devDependencies": {
-    "@types/node": "^25.5.2",
-    "tsup": "^8.0.0",
-    "typescript": "^5.3.0",
-    "vitest": "^4.1.5"
-  },
-  "keywords": [
-    "math",
-    "mathjs",
-    "compat",
-    "compatibility",
-    "migration"
-  ],
-  "author": "Daniel Simon Jr.",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/danielsimonjr/mathts",
-    "directory": "compat"
-  },
-  "module": "./dist/index.js",
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "@danielsimonjr/mathts-compat",
+  "version": "0.2.0",
+  "description": "mathjs compatibility layer for MathTS",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "dev": "tsup src/index.ts --format esm --dts --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "build:prod": "tsup src/index.ts --format esm --dts --clean --minify --treeshake"
+  },
+  "dependencies": {
+    "@danielsimonjr/mathts-core": "^0.1.5",
+    "@danielsimonjr/mathts-functions": "^0.3.0",
+    "@danielsimonjr/mathts-matrix": "^0.1.10",
+    "@danielsimonjr/mathts-parallel": "^0.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^4.1.5"
+  },
+  "keywords": [
+    "math",
+    "mathjs",
+    "compat",
+    "compatibility",
+    "migration"
+  ],
+  "author": "Daniel Simon Jr.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/danielsimonjr/mathts",
+    "directory": "compat"
+  },
+  "module": "./dist/index.js",
+  "publishConfig": {
+    "access": "public"
+  }
+}