How to Use MathJS with TypeScript?

Math.js library can be use with TypeScript to handle various mathematical tasks while getting the benefits of TypeScript’s type safety and autocompletion. Integrating Math.js into your TypeScript project allows you to perform arithmetic, algebra, statistics, and more, with the added advantage of TypeScript’s strong typing system. This setup offers both powerful features and a smoother development experience.

Steps to Use MathJS with TypeScript

Setting up math.js in your project is simple. Follow the below steps to install and use math.js with TypeScript for performing mathematical and statistical calculations.

Step 1: Initialize a Node.js Project

Before you can install math.js, you need to have a Node.js project. If you don’t have one, you can create it using the following command:

npm init -y

Step 2: Install math.js and TypeScript

Install math.js, TypeScript, and the TypeScript type definitions for math.js:

npm install mathjs 
npm install typescript @types/node --save-dev

Step 3: Configure TypeScript

Create a tsconfig.json file if you don't already have one. You can initialize it with:

npx tsc --init

Make sure your tsconfig.json includes at least the following configuration:

{
  "compilerOptions": {
    "target": "es6",
    "module": "commonjs",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "outDir": "./dist",
    "rootDir": "./src",
    "baseUrl": ".",
    "paths": {
      "*": [
        "node_modules/*"
      ]
    }
  },
  "include": [
    "src/**/*.ts"
  ],
  "exclude": [
    "node_modules",
    "dist"
  ]
}

Step 4: Create a TypeScript File

Create a TypeScript file (e.g., src/script.ts) where you'll write your code to perform calculations.

Folder Structure:

Dependencies:

"dependencies": {
    "mathjs": "^13.0.3"
  },
  "devDependencies": {
    "@types/node": "^22.1.0",
    "typescript": "^5.5.4"
  }

Step 5: Import math.js in Your TypeScript File

Import math.js in your script.ts file:

const math = require('mathjs');

Step 6: Perform Calculations Using MathJS

Write TypeScript code to perform calculations using math.js. Below is an example of calculating mean, median, and standard deviation:

const math = require("mathjs");
const sum: number = math.add(10, 20);
console.log(`Sum: ${sum}`);
const result: number = math.evaluate("sqrt(16) + log(100)");
console.log(`Result: ${result}`);
const matrixA = math.matrix([ [ 1, 2 ], [ 3, 4 ] ]);
const matrixB = math.matrix([ [ 5, 6 ], [ 7, 8 ] ]);
const sumMatrix = math.add(matrixA, matrixB);
console.log(`Sum of matrices: ${sumMatrix}`);

Step 7: Compile and Run Your TypeScript File

Compile your TypeScript file to JavaScript:

npx tsc script.ts

This will generate a script.js file.

Run the compiled JavaScript file with Node.js:

node script.js

Output:

Conclusion

Integrating Math.js with TypeScript offers a strong solution for performing various mathematical tasks while benefiting from TypeScript’s type safety and autocompletion. This guide will show you how to set up Math.js in your TypeScript projects efficiently. Whether you're working on financial apps, data analysis, or educational tools, Math.js provides the flexibility and power needed for complex calculations.