calculator

Calculator

Evaluate arithmetic expressions with arbitrary-precision decimal math using big.js.

When to Use

• User asks to calculate or evaluate a math expression
• Precise decimal arithmetic is needed (avoids floating-point errors like 0.1 + 0.2 = 0.30000000000000004)
• Expressions involve parentheses, operator precedence, or exponents

Supported Operations

Operator	Description	Precedence
+	Addition	1
-	Subtraction	1
*	Multiplication	2
/	Division	2
^	Exponent (right-associative)	3
()	Parentheses	Highest

Usage

cd scripts
npm ci || npm install
npm run build
npm run calculate "<expression>"

Examples

Input	Output
"3 + 2"	5
"10 / 4"	2.5
"2 ^ 10"	1024
"(2 + 3) * 4"	20
"1 + 4.5 * (3-6) / 5"	-1.7
"-5 + 3"	-2
"2 ^ 3 ^ 2"	512 (right-associative: 2^9)

Edge Cases

• Empty expression: Throws "Empty expression" error
• Mismatched parentheses: Throws "Mismatched parentheses" error
• Division by zero: big.js throws an error
• Exponent must be integer: big.js .pow() requires integer exponents

Limitations

• No trigonometric functions (sin, cos, tan)
• No variables or symbolic math
• Exponents must be integers
• No factorial, modulo, or bitwise operators