samasya

samasya is a TypeScript-based mathematical library inspired by math.js, designed to provide a comprehensive set of mathematical functions and utilities for JavaScript and TypeScript projects.

📚 Documentation

Explore the full documentation at https://samasya-docs.netlify.app. It includes detailed usage examples, API references, and more.

🌟 Features

• Basic Arithmetic Operations: Addition, subtraction, multiplication, and division for both numbers and arrays.
• Modular Arithmetic Operations: Operations such as modulo, modular addition, subtraction, multiplication, exponentiation, and more.
• Power and Root Calculations: Compute powers and nth roots of numbers.
• Chaining Operations: Chain multiple arithmetic operations in a fluent API style.
• Error Handling: Comprehensive error handling for invalid inputs and edge cases.
• Algebraic Evaluator: A new Evaluator class that supports algebraic expressions with variables, constants, and built-in functions (e.g., sqrt, log, sin, cos).
• Advanced Algebraic Operations: Evaluate complex algebraic expressions dynamically with support for custom functions and variables.
• Cryptography-Oriented Functions: Modular cryptographic functions such as modular hashing, encryption, and decryption.
• Prime and Factorial Functions: Compute factorials with modulus, and enhance prime-related functionalities.

📦 Installation

You can install samasya using npm:

npm install samasya

🚀 Quick Start

Basic Arithmetic Example

import { add, multiply } from 'samasya';

console.log(add(2, 3)); // Output: 5
console.log(multiply([2, 3, 4])); // Output: 24

Chaining Example

import { Chain } from 'samasya';

const result = new Chain(5).add(3).multiply(2).getResult();
console.log(result); // Output: 16

🛠 Development

To set up the project for development:

1. Clone the repository:

   git clone https://github.com/tejasbenibagde/samasya.git
   cd samasya

2. Install dependencies:

   npm install

3. Run tests:

   npm test

4. Build the project:

   npm run build

Contributing

We welcome contributions to samasya! Please see our Contributing Guide for more details on how to get started.

License

samasya is MIT licensed.

Author

samasya is created and maintained by Tejas Benibagde.

Support

If you encounter any issues or have questions, please file an issue on our GitHub issues page.

Acknowledgements

This project is inspired by math.js. We're grateful to the math.js team for their excellent work, which has served as a reference for many of the features planned for samasya.

Roadmap

• Add expression parsing and evaluation
• Develop unit conversion capabilities
• Implement matrix and vector operations
• Add complex number support
• Develop statistical functions
• Implement symbolic computation features

Stay tuned for updates!