exprify 1.0.0 → 1.0.1

package/dist/exprify.js

@@ -1,532 +1,2349 @@
 /*!
-* exprify v1.0.0
+* exprify v1.0.1
 * (c) 2026 Nirmal Paul and other contributors
 *
 * Released under the GPL-3.0 License
-* Date: 2026-04-02
+* Date: 2026-04-05
 */
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
-    typeof define === 'function' && define.amd ? define(['exports'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.Exprify = {}));
-})(this, (function (exports) { 'use strict';
-
-    function tokenize(expr, context) {
-        let tokens = [];
-        let current = "";
-        let quote = "";
-
-        for (let i = 0; i < expr.length; i++) {
-
-            let char = expr[i];
-
-            const isOperator =
-                char === '(' || char === ')' ||
-                char === '^' || char === '*' ||
-                char === '/' || char === '%' ||
-                char === '+' || char === '-';
-
-            const isQuote = char === '"' || char === "'" || char === "`";
-
-            if (isQuote) {
-                if (quote === "") {
-                    quote = char;
-                    current += char;
-                } else if (quote === char) {
-                    current += char;
-                    quote = "";
-
-                    tokens.push(context.stringToJS(current, context.variablesDB));
-                    current = "";
-                } else {
-                    current += char;
-                }
-                continue;
-            }
-
-            if (quote !== "") {
-                current += char;
-                continue;
-            }
-
-            if (char === "#") {
-
-                let bracket = 0;
-                let funcName = "";
-                let arg = "";
-                let args = [];
-                let quoteFunc = "";
-
-                while (i < expr.length - 1) {
-                    i++;
-                    char = expr[i];
-
-                    if (bracket === 0) {
-                        if (char === "(") {
-                            bracket++;
-                            continue;
-                        }
-
-                        if (char === " ")
-                            throw new Error("Function name cannot contain space");
-
-                        if (isQuote)
-                            throw new Error("Function name cannot contain quotes");
-
-                        if (funcName === "" && /[0-9.]/.test(char))
-                            throw new Error("Function name cannot start with number");
-
-                        funcName += char;
-                        continue;
-                    }
-
-                    if (isQuote) {
-                        if (quoteFunc === "") quoteFunc = char;
-                        else if (quoteFunc === char) quoteFunc = "";
-                    }
-
-                    if (quoteFunc === "") {
-
-                        if (char === "(") bracket++;
-                        else if (char === ")") {
-                            bracket--;
-
-                            if (bracket === 0) {
-                                if (arg !== "") args.push(arg);
-                                break;
-                            }
-                        }
-
-                        if (char === "," && bracket === 1) {
-                            if (arg === "")
-                                throw new Error(`Missing argument in #${funcName}()`);
-
-                            args.push(arg);
-                            arg = "";
-                            continue;
-                        }
-                    }
-
-                    arg += char;
-                }
-
-                args = args.map(a => context.evaluate(a));
-
-                let fn =
-                    context.func_DB_intrnl[funcName] ||
-                    context.func_DB_extrnl[funcName];
-
-                if (!fn) {
-                    throw new Error(`#${funcName}() not defined`);
-                }
-
-                tokens.push(fn(...args));
-                continue;
-            }
-
-            if (isOperator) {
-
-                if (current !== "") {
-                    tokens.push(context.stringToJS(current, context.variablesDB));
-                    current = "";
-                }
-
-                tokens.push(char);
-                continue;
-            }
-
-            if (char === " ") {
-                if (current !== "") {
-                    tokens.push(context.stringToJS(current, context.variablesDB));
-                    current = "";
-                }
-                continue;
-            }
-
-            current += char;
-
-            if (i === expr.length - 1 && current !== "") {
-                tokens.push(context.stringToJS(current, context.variablesDB));
-            }
-        }
-
-        if (quote !== "") {
-            throw new Error("Unclosed string literal");
-        }
-
-        return tokens;
-    }
-
-    function infixToPostfix(tokens, operator_precedence) {
-        let output = [];
-        let stack = [];
-
-        for (let i = 0; i < tokens.length; i++) {
-
-            let token = tokens[i];
-
-            const isOperator =
-                token === '^' || token === '*' ||
-                token === '/' || token === '%' ||
-                token === '+' || token === '-';
-
-            const isLeftParen = token === "(";
-            const isRightParen = token === ")";
-
-            const isOperand = !isOperator && !isLeftParen && !isRightParen;
-
-            if (isOperand) {
-                output.push(token);
-            }
-
-            else if (isOperator) {
-
-                while (stack.length > 0) {
-
-                    let top = stack[stack.length - 1];
-
-                    if (top === "(") break;
-
-                    let topPrec = operator_precedence[top] || 0;
-                    let currPrec = operator_precedence[token];
-
-                    // Right associativity for ^
-                    if (
-                        (token === '^' && currPrec < topPrec) ||
-                        (token !== '^' && currPrec <= topPrec)
-                    ) {
-                        output.push(stack.pop());
-                    } else {
-                        break;
-                    }
-                }
-
-                stack.push(token);
-            }
-
-            else if (isLeftParen) {
-                stack.push(token);
-            }
-
-            else if (isRightParen) {
-
-                while (stack.length > 0 && stack[stack.length - 1] !== "(") {
-                    output.push(stack.pop());
-                }
-
-                if (stack.length === 0) {
-                    throw new Error("Mismatched parentheses: missing '('");
-                }
-
-                stack.pop();
-            }
-        }
-
-        while (stack.length > 0) {
-
-            let top = stack.pop();
-
-            if (top === "(" || top === ")") {
-                throw new Error("Mismatched parentheses");
-            }
-
-            output.push(top);
-        }
-
-        return output;
-    }
-
-    function evaluatePostfix(postfix, mathOperations) {
-
-        let stack = [];
-
-        const isOperator = (val) =>
-            val === '^' || val === '*' ||
-            val === '/' || val === '%' ||
-            val === '+' || val === '-';
-
-        for (let i = 0; i < postfix.length; i++) {
-
-            let token = postfix[i];
-
-            if (!isOperator(token)) {
-                stack.push(token);
-                continue;
-            }
-
-            if (stack.length < 2) {
-                throw new Error("Invalid expression: insufficient operands");
-            }
-
-            let b = stack.pop(); // second
-            let a = stack.pop(); // first
-
-            let result;
-
-            switch (token) {
-                case '^':
-                    result = mathOperations.power(a, b);
-                    break;
-                case '*':
-                    result = mathOperations.multiply(a, b);
-                    break;
-                case '/':
-                    result = mathOperations.divide(a, b);
-                    break;
-                case '%':
-                    result = mathOperations.modulus(a, b);
-                    break;
-                case '+':
-                    result = mathOperations.add(a, b);
-                    break;
-                case '-':
-                    result = mathOperations.subtract(a, b);
-                    break;
-            }
-
-            stack.push(result);
-        }
-
-        if (stack.length !== 1) {
-            throw new Error("Invalid expression: leftover values in stack");
-        }
-
-        return stack[0];
-    }
-
-    const isValidNumberPair = (a, b) =>
-      (typeof a === typeof b) &&
-      (typeof a === 'number' || typeof a === 'bigint');
-
-    const mathOperations = Object.freeze({
-
-      operator_precedence: {
-        '^': 4,
-        '*': 3,
-        '/': 3,
-        '%': 3,
-        '+': 1,
-        '-': 1,
-      },
-
-      power: function(a, b) {
-        if (isValidNumberPair(a, b)) return a ** b;
-        throw new Error("Invalid types for ^");
-      },
-
-      multiply: function(a, b) {
-        if (isValidNumberPair(a, b)) return a * b;
-        throw new Error("Invalid types for *");
-      },
-
-      divide: function(a, b) {
-        if (isValidNumberPair(a, b)) {
-          if (b === 0) throw new Error("Division by zero");
-          return a / b;
-        }
-        throw new Error("Invalid types for /");
-      },
-
-      add: function(a, b) {
-        if (isValidNumberPair(a, b)) return a + b;
-        if (typeof a === 'string' && typeof b === 'string') return a + b;
-        throw new Error("Invalid types for +");
-      },
-      subtract: function(a, b) {
-        if (isValidNumberPair(a, b)) return a - b;
-        throw new Error("Invalid types for -");
-      },
-
-      modulus: function(a, b) {
-        if (isValidNumberPair(a, b)) return a % b;
-        throw new Error("Invalid types for %");
-      }
-    });
-
-    const and = (...args) => args.every(Boolean);
-    const or = (...args) => args.some(Boolean);
-    const not = (val) => !val;
-
-    const gt = (a, b) => a > b;
-    const lt = (a, b) => a < b;
-    const eq = (a, b) => a === b;
-    const gte = (a, b) => a >= b;
-    const lte = (a, b) => a <= b;
-
-    const internalFunctions = Object.freeze({
-
-      max: (...args) => {
-        if (!args.every(v => typeof v === 'number')) {
-          throw new Error("max() expects numbers only");
-        }
-        return Math.max(...args);
-      },
-
-      min: (...args) => {
-        if (!args.every(v => typeof v === 'number')) {
-          throw new Error("min() expects numbers only");
-        }
-        return Math.min(...args);
-      },
-
-      and,
-      "&&": and,
-
-      or,
-      "||": or,
-
-      not,
-      "!": not,
-
-      greaterThan: gt,
-      ">": gt,
-
-      lessThan: lt,
-      "<": lt,
-
-      isEqual: eq,
-      "==": eq,
-
-      greaterThanOrEqual: gte,
-      ">=": gte,
-
-      lessThanOrEqual: lte,
-      "<=": lte,
-
-      if: (cond, t, f = false) => cond ? t : f
-
-    });
-
-    const externalFunctions = {};
-
-    const variablesDB = {};
-
-    function stringToJS(str, variablesDB) {
-        if (typeof str !== "string" || str.length === 0) {
-            throw new Error("Invalid input: expected a non-empty string.");
-        }
-
-        const firstChar = str[0];
-        const lastChar = str[str.length - 1];
-
-        // HEX (0x...)
-        if (/^0x[0-9a-fA-F]+n?$/.test(str)) {
-
-            // BigInt hex (0xFFn)
-            if (lastChar === 'n') {
-                return BigInt(str.slice(0, -1));
-            }
-
-            return Number(str);
-        }
-
-        if (/^[+-]?(\d+(\.\d+)?|\.\d+)(e[+-]?\d+)?n?$/i.test(str)) {
-
-            // BigInt
-            if (lastChar === 'n') {
-                const numPart = str.slice(0, -1);
-
-                if (numPart.includes('.') || /e/i.test(numPart)) {
-                    throw new Error(`Invalid BigInt: ${str}`);
-                }
-
-                return BigInt(numPart);
-            }
-
-            return Number(str);
-        }
-
-        if (
-            (firstChar === '"' && lastChar === '"') ||
-            (firstChar === "'" && lastChar === "'") ||
-            (firstChar === '`' && lastChar === '`')
-        ) {
-            return str.slice(1, -1);
-        }
-
-        if (
-            firstChar === '"' ||
-            firstChar === "'" ||
-            firstChar === '`'
-        ) {
-            throw new Error(`Unmatched or missing quotes: ${str}`);
-        }
-
-        if (str === "true") return true;
-        if (str === "false") return false;
-
-        if (str in variablesDB) {
-            return variablesDB[str];
-        }
-
-        throw new Error(
-            `${str} is not defined. Use setVariable("${str}", value) first.`
-        );
-    }
-
-    class ViewPoint {
-
-        constructor() {
-            // Shared state
-            this.variablesDB = variablesDB;
-            this.func_DB_intrnl = internalFunctions;
-            this.func_DB_extrnl = externalFunctions;
-
-            this.operator_precedence = mathOperations.operator_precedence;
-        }
-
-        setVariable(name, value) {
-            this.variablesDB[name] = value;
-        }
-
-        addFunction(name, fn) {
-            this.func_DB_extrnl[name] = fn;
-        }
-
-        stringToJS(str) {
-            return stringToJS.call(this, str, this.variablesDB);
-        }
-
-        evaluate(expr) {
-
-            if (typeof expr !== "string") {
-                throw new Error("Expression must be a string");
-            }
-
-            const context = {
-                variablesDB: this.variablesDB,
-                func_DB_intrnl: this.func_DB_intrnl,
-                func_DB_extrnl: this.func_DB_extrnl,
-                stringToJS: this.stringToJS.bind(this),
-                evaluate: this.evaluate.bind(this)
-            };
-
-            // Step 1: Tokenize
-            const tokens = tokenize(expr, context);
-
-            // Step 2: Infix → Postfix
-            const postfix = infixToPostfix(
-                tokens,
-                this.operator_precedence
-            );
-
-            // Step 3: Evaluate Postfix
-            const result = evaluatePostfix(
-                postfix,
-                mathOperations
-            );
-
-            return result;
-        }
-    }
-
-    exports.Exprify = ViewPoint;
-    exports.externalFunctions = externalFunctions;
-    exports.internalFunctions = internalFunctions;
-    exports.mathOperations = mathOperations;
-    exports.variablesDB = variablesDB;
-
-    Object.defineProperty(exports, '__esModule', { value: true });
+  typeof exports === 'object' && typeof module !== 'undefined' ? module.exports = factory() :
+  typeof define === 'function' && define.amd ? define(factory) :
+  (global = typeof globalThis !== 'undefined' ? globalThis : global || self, global.Exprify = factory());
+})(this, (function () { 'use strict';
+
+  function tokenize(expr, context = {}) {
+    const tokens = [];
+    let current = "";
+    let quote = "";
+
+    const operators = ["+", "-", "*", "/", "%", "^", "=", ">", "<", "!", "&", "|"];
+    const multiOps = [
+      "==", ">=", "<=", "&&", "||",
+      "+=", "-=", "*=", "/=", "%=",
+      "?.", "??", "|>"
+    ];
+
+    const parentheses = "()";
+    const comma = ",";
+    const semicolon = ";";
+    const keywords = ["to", "in"];
+    // const functions = context.functions?.getAllFunctionsName?.() || [];
+    const units = context.units?.getAllUnitsFlat?.() || [];
+
+    const isIdentifier = (s) => /^[a-zA-Z_][a-zA-Z0-9_]*$/.test(s);
+
+    function getContext(str, charIndex) {
+        // 1. Extract all alphanumeric words into an array
+        const words = str.match(/[a-z0-9]+/gi) || [];
+        
+        // 2. Identify the current character and the one immediately before it
+        const currentChar = str[charIndex] || null;
+        const prevChar = charIndex > 0 ? str[charIndex - 1] : null;
+        
+        // 3. Find the word that contains the current charIndex
+        let start = charIndex;
+        // Move pointer back to the start of the current word
+        while (start > 0 && /[a-z0-9]/i.test(str[start - 1])) start--;
+        
+        let end = charIndex;
+        // Move pointer forward to the end of the current word
+        while (end < str.length && /[a-z0-9]/i.test(str[end])) end++;
+        
+        const currentWord = str.substring(start, end);
+
+        // 4. Find the word that appears before the currentWord in the sequence
+        const currentWordIdx = words.indexOf(currentWord);
+        const prevWord = currentWordIdx > 0 ? words[currentWordIdx - 1] : null;
+
+        // 5. Find the word that appears after the currentWord
+        const nextWord = (currentWordIdx !== -1 && currentWordIdx < words.length - 1) 
+                        ? words[currentWordIdx + 1] 
+                        : null;
+
+        return {
+            prevWord: prevWord,
+            prevChar: prevChar,
+            currentWord: currentWord,
+            currentChar: currentChar,
+            nextWord: nextWord
+        };
+    }
+
+    const isUnaryContext = (prev) =>
+      !prev ||
+      prev.type === "Operator" ||
+      prev.type === "UnaryOperator" ||
+      (prev.type === "Parenthesis" && prev.value !== ")") ||
+      prev.type === "ArrayStart" ||
+      prev.type === "Semicolon" ||
+      prev.type === "Comma" ||
+      prev.type === "Ternary";
+
+    const flushCurrent = (nextChar, index) => {
+      if (!current) return;
+
+      // BOOLEAN
+      if (/^(true|false)$/i.test(current)) {
+        tokens.push({ type: "Boolean", value: current.toLowerCase() === "true" });
+        current = "";
+        return;
+      }
+
+      // KEYWORD
+      if (keywords.includes(current)) {
+        tokens.push({ type: "Keyword", value: current, pos: index });
+        current = "";
+        return;
+      }
+
+      // BIGINT
+      if (/^\d+n$/.test(current)) {
+        tokens.push({ type: "BigInt", value: BigInt(current.slice(0, -1)), pos: index });
+        current = "";
+        return;
+      }
+
+      // HEX
+      if (/^0x[0-9a-fA-F]+$/.test(current)) {
+        tokens.push({ type: "Number", value: parseInt(current, 16), pos: index });
+        current = "";
+        return;
+      }
+
+      // BINARY
+      if (/^0b[01]+$/.test(current)) {
+        tokens.push({ type: "Number", value: parseInt(current, 2), pos: index });
+        current = "";
+        return;
+      }
+
+      // NUMBER (including scientific)
+      if (/^[+-]?(\d+(\.\d+)?|\.\d+)(e[+-]?\d+)?$/i.test(current)) {
+        tokens.push({ type: "Number", value: parseFloat(current), pos: index });
+        current = "";
+        return;
+      }
+
+      // IMAGINARY NUMBER
+      if (/^[+-]?(\d+(\.\d+)?|\.\d+)(e[+-]?\d+)?i$/i.test(current)) {
+        tokens.push({
+          type: "ImaginaryLiteral",
+          value: parseFloat(current.slice(0, -1)),
+          pos: index
+        });
+        current = "";
+        return;
+      }
+
+      // IMAGINARY UNIT
+      if (/^[+-]?i$/i.test(current)) {
+        const sign = current[0] === "-" ? -1 : 1;
+        tokens.push({
+          type: "ImaginaryLiteral",
+          value: sign,
+          pos: index
+        });
+        current = "";
+        return;
+      }
+
+      // NUMBER + UNIT
+      const numUnit = current.match(/^([+-]?\d+(\.\d+)?)([a-zA-Z]+)$/);
+      if (numUnit) {
+        const value = parseFloat(numUnit[1]);
+        const unit = numUnit[3];
+
+        tokens.push({
+          type: units.includes(unit) ? "NumberWithUnit" : "UnknownUnit",
+          value,
+          unit,
+          pos: index
+        });
+
+        current = "";
+        return;
+      }
+
+      // UNIT
+      if (units.includes(current)) {
+        const {prevWord} = getContext(expr, index);
+        if (nextChar !== "(") {
+          if (prevWord){
+            if (!isNaN(parseFloat(prevWord)) || prevWord === "to" || prevWord === "in") {
+              // console.log("Context for unit detection:", {current, prevWord, nextChar});
+
+              tokens.push({ type: "Unit", value: current, pos: index });
+              current = "";
+              return;
+            }
+          }
+        }
+      }
+
+      // IDENTIFIER
+       if (isIdentifier(current)) {
+        if (nextChar === "(") {
+          tokens.push({
+            type: "Function",
+            name: current,
+            pos: index
+          });
+        } else {
+          tokens.push({
+            type: "Identifier",
+            name: current,
+            pos: index
+          });
+        }
+
+        current = "";
+        return;
+      }
+
+      throw new Error(`Invalid token "${current}" at index ${index}`);
+    };
+    
+
+    for (let i = 0; i < expr.length; i++) {
+      let char = expr[i];
+      let next = expr[i + 1];
+
+      // comments
+      if (char === "/" && next === "/") {
+        while (i < expr.length && expr[i] !== "\n") i++;
+        continue;
+      }
+
+      if (char === "/" && next === "*") {
+        i += 2;
+        while (i < expr.length && !(expr[i] === "*" && expr[i + 1] === "/")) i++;
+        i++;
+        continue;
+      }
+
+      // string
+      if (`"'`.includes(char)) {
+        if (!quote) {
+          quote = char;
+          current += char;
+        } else if (quote === char) {
+          current += char;
+          tokens.push({
+            type: "String",
+            value: current.slice(1, -1),
+            pos: i
+          });
+          current = "";
+          quote = "";
+        } else {
+          current += char;
+        }
+        continue;
+      }
+
+      if (quote) {
+        if (char === "\\") {
+          current += char + expr[++i];
+        } else {
+          current += char;
+        }
+        continue;
+      }
+
+      // multi operators
+      const twoChar = char + next;
+      if (multiOps.includes(twoChar)) {
+        flushCurrent(char, i);
+        tokens.push({ type: "Operator", value: twoChar, pos: i });
+        i++;
+        continue;
+      }
+
+      if (char === "?") {
+        tokens.push({ type: "Ternary", value: "?" });
+        continue;
+      }
+
+      // only treat ':' as ternary IF previous token was '?'
+      if (char === ":") {
+        flushCurrent(char, i);
+        const prev = tokens[tokens.length - 1];
+
+        if (prev && prev.type === "Ternary") {
+          tokens.push({ type: "Ternary", value: ":" });
+        } else {
+          tokens.push({ type: "Colon" });
+        }
+        continue;
+      }
+
+      // dot
+      if (char === "." && /\d/.test(current) && /\d/.test(next)) {
+        current += char;
+        continue;
+      }
+
+      if (char === ".") {
+        flushCurrent(char, i);
+        tokens.push({ type: "Dot", pos: i });
+        continue;
+      }
+
+      // operators
+      if (operators.includes(char)) {
+        flushCurrent(char, i);
+
+        const prev = tokens[tokens.length - 1];
+        if ((char === "-" || char === "!") && isUnaryContext(prev)) {
+          tokens.push({ type: "UnaryOperator", value: char, pos: i });
+        } else {
+          tokens.push({ type: "Operator", value: char, pos: i });
+        }
+        continue;
+      }
+
+      // parenthesis
+      if (parentheses.includes(char)) {
+        flushCurrent(char, i);
+        tokens.push({ type: "Parenthesis", value: char, pos: i });
+        continue;
+      }
+
+      // array
+      if (char === "[") {
+        flushCurrent(char, i);
+        tokens.push({ type: "ArrayStart", pos: i });
+        continue;
+      }
+
+      if (char === "]") {
+        flushCurrent(char, i);
+        tokens.push({ type: "ArrayEnd", pos: i });
+        continue;
+      }
+
+      // OBJECT START
+      if (char === "{") {
+        flushCurrent(char, i);
+        tokens.push({ type: "BlockStart", pos: i });
+        continue;
+      }
+
+      // OBJECT END
+      if (char === "}") {
+        flushCurrent(char, i);
+        tokens.push({ type: "BlockEnd", pos: i });
+        continue;
+      }
+
+      // comma
+      if (char === comma) {
+        flushCurrent(char, i);
+        tokens.push({ type: "Comma", pos: i });
+        continue;
+      }
+
+      // semicolon
+      if (char === semicolon) {
+        flushCurrent(char, i);
+        tokens.push({ type: "Semicolon", pos: i });
+        continue;
+      }
+
+      // space
+      if (char === " ") {
+        flushCurrent(next, i);
+        continue;
+      }
+
+      // build token
+      current += char;
+
+      if (i === expr.length - 1) {
+        flushCurrent(null, i);
+      }
+    }
+
+    if (quote) throw new Error("Unclosed string literal");
+
+    // merge number + unit
+    const merged = [];
+    for (let i = 0; i < tokens.length; i++) {
+      const t = tokens[i];
+      const next = tokens[i + 1];
+
+      if (t?.type === "Number" && next?.type === "Unit") {
+        merged.push({
+          type: "NumberWithUnit",
+          value: t.value,
+          unit: next.value,
+          pos: t.pos
+        });
+        i++;
+        continue;
+      }
+
+      merged.push(t);
+    }
+
+    // implicit multiplication
+    const final = [];
+    for (let i = 0; i < merged.length; i++) {
+      const a = merged[i];
+      const b = merged[i + 1];
+
+      final.push(a);
+
+      if (
+        a && b &&
+        (
+          (["Number", "Identifier"].includes(a.type) ||
+            (a.type === "Parenthesis" && a.value === ")") ||
+            a.type === "ArrayEnd") &&
+          (["Identifier", "Function"].includes(b.type) ||
+            (b.type === "Parenthesis" && b.value === "("))
+        )
+      ) {
+        final.push({ type: "Operator", value: "*", implicit: true });
+      }
+    }
+
+    return final;
+  }
+
+  function evaluateAST(node, context = {}) {
+
+    const vars = context.variables;
+    const fns = context.functions;
+    const units = context.units;
+
+
+    const isUnitObj = (v) =>
+      v && typeof v === "object" && "value" in v && "unit" in v;
+
+    const isComplex = (v) =>
+      v && typeof v === "object" && "re" in v && "im" in v;
+
+    const isSliceNode = (v) =>
+      v && typeof v === "object" && v.type === "SliceExpression";
+
+    const isMatrix = (v) =>
+      Array.isArray(v) && v.length > 0 && v.every(Array.isArray);
+
+    const normalizeMatrix = (value) => {
+      if (isMatrix(value)) return value.map((row) => [...row]);
+      if (Array.isArray(value)) return [value];
+      throw new Error("Expected matrix-compatible value");
+    };
+
+    const toOneBasedIndex = (value) => {
+      if (typeof value !== "number" || !Number.isInteger(value) || value < 1) {
+        throw new Error("Matrix indices must be positive integers");
+      }
+
+      return value - 1;
+    };
+
+    const resolveSelector = (selector, contextLength) => {
+      if (isSliceNode(selector)) {
+        const startValue = selector.start == null ? 1 : evaluateAST(selector.start, context);
+        const endValue = selector.end == null ? contextLength : evaluateAST(selector.end, context);
+        const start = toOneBasedIndex(startValue);
+        const end = toOneBasedIndex(endValue);
+
+        if (end < start) {
+          return [];
+        }
+
+        const result = [];
+        for (let index = start; index <= end; index++) {
+          result.push(index);
+        }
+        return result;
+      }
+
+      return [toOneBasedIndex(evaluateAST(selector, context))];
+    };
+
+    const indexMatrix = (matrix, selectors) => {
+      const target = normalizeMatrix(matrix);
+
+      if (selectors.length === 1) {
+        const rowIndexes = resolveSelector(selectors[0], target.length);
+        const rows = rowIndexes.map((rowIndex) => {
+          if (rowIndex >= target.length) {
+            throw new Error("Row index out of range");
+          }
+          return [...target[rowIndex]];
+        });
+
+        return rows.length === 1 ? rows[0] : rows;
+      }
+
+      const rowIndexes = resolveSelector(selectors[0], target.length);
+      const colIndexes = resolveSelector(selectors[1], target[0]?.length || 0);
+
+      const values = rowIndexes.map((rowIndex) => {
+        if (rowIndex >= target.length) {
+          throw new Error("Row index out of range");
+        }
+
+        return colIndexes.map((colIndex) => {
+          if (colIndex >= target[rowIndex].length) {
+            throw new Error("Column index out of range");
+          }
+          return target[rowIndex][colIndex];
+        });
+      });
+
+      if (rowIndexes.length === 1 && colIndexes.length === 1) {
+        return values[0][0];
+      }
+
+      if (rowIndexes.length === 1) {
+        return values[0];
+      }
+
+      if (colIndexes.length === 1) {
+        return values.map((row) => [row[0]]);
+      }
+
+      return values;
+    };
+
+    const assignMatrixIndex = (matrix, selectors, value) => {
+      const target = isMatrix(matrix)
+        ? matrix.map((row) => [...row])
+        : Array.isArray(matrix)
+          ? [matrix.slice()]
+          : [];
+
+      const rowSelector = selectors[0];
+      const colSelector = selectors[1];
+
+      if (!rowSelector) {
+        throw new Error("Matrix assignment requires at least one index");
+      }
+
+      const rowContextLength = Math.max(target.length, 1);
+      const rowIndexes = resolveSelector(rowSelector, rowContextLength);
+
+      if (selectors.length === 1) {
+        const rowsValue = isMatrix(value) ? value : normalizeMatrix(value);
+
+        if (rowsValue.length !== rowIndexes.length) {
+          throw new Error("Assigned row count does not match slice");
+        }
+
+        rowIndexes.forEach((rowIndex, index) => {
+          target[rowIndex] = [...rowsValue[index]];
+        });
+
+        return {
+          updatedMatrix: target,
+          selectionResult: rowIndexes.length === 1 ? [target[rowIndexes[0]]] : rowIndexes.map((rowIndex) => [target[rowIndex]])
+        };
+      }
+
+      const maxCols = Math.max(...target.map((row) => row.length), 0, 1);
+      const colIndexes = resolveSelector(colSelector, maxCols);
+      const normalizedValue = normalizeMatrix(value);
+
+      if (normalizedValue.length !== rowIndexes.length) {
+        throw new Error("Assigned row count does not match matrix slice");
+      }
+
+      normalizedValue.forEach((row, rowOffset) => {
+        if (row.length !== colIndexes.length) {
+          throw new Error("Assigned column count does not match matrix slice");
+        }
+      });
+
+      rowIndexes.forEach((rowIndex, rowOffset) => {
+        if (!target[rowIndex]) {
+          target[rowIndex] = [];
+        }
+
+        colIndexes.forEach((colIndex, colOffset) => {
+          target[rowIndex][colIndex] = normalizedValue[rowOffset][colOffset];
+        });
+      });
+
+      return {
+        updatedMatrix: target,
+        selectionResult: rowIndexes.length === 1
+          ? [colIndexes.map((colIndex) => target[rowIndexes[0]][colIndex])]
+          : rowIndexes.map((rowIndex) => colIndexes.map((colIndex) => target[rowIndex][colIndex]))
+      };
+    };
+
+    const multiplyMatrices = (left, right) => {
+      const a = normalizeMatrix(left);
+      const b = normalizeMatrix(right);
+
+      if (a[0].length !== b.length) {
+        throw new Error("Matrix dimensions do not allow multiplication");
+      }
+
+      return a.map((row) =>
+        b[0].map((_, colIndex) =>
+          row.reduce((sum, value, rowIndex) => sum + (value * b[rowIndex][colIndex]), 0)
+        )
+      );
+    };
+
+    const toComplex = (value) => {
+      if (isComplex(value)) return value;
+      if (typeof value === "number") return { re: value, im: 0 };
+      throw new Error("Complex arithmetic only supports numbers");
+    };
+
+    const fromImaginary = (value) => ({ re: 0, im: value });
+
+    const simplifyComplex = (value) =>
+      value.im === 0 ? value.re : value;
+
+    const evalComplexBinary = (operator, left, right) => {
+      const a = toComplex(left);
+      const b = toComplex(right);
+
+      switch (operator) {
+        case "+":
+          return simplifyComplex({ re: a.re + b.re, im: a.im + b.im });
+        case "-":
+          return simplifyComplex({ re: a.re - b.re, im: a.im - b.im });
+        case "*":
+          return simplifyComplex({
+            re: (a.re * b.re) - (a.im * b.im),
+            im: (a.re * b.im) + (a.im * b.re)
+          });
+        case "/": {
+          const denominator = (b.re ** 2) + (b.im ** 2);
+
+          if (denominator === 0) {
+            throw new Error("Division by zero");
+          }
+
+          return simplifyComplex({
+            re: ((a.re * b.re) + (a.im * b.im)) / denominator,
+            im: ((a.im * b.re) - (a.re * b.im)) / denominator
+          });
+        }
+        default:
+          throw new Error(`Operator ${operator} is not supported for complex numbers`);
+      }
+    };
+
+    /* ================= EVALUATOR ================= */
+
+    switch (node.type) {
+
+      /* ===== LITERAL ===== */
+      case "Literal":
+        return node.value;
+
+      case "ImaginaryLiteral":
+        return fromImaginary(node.value);
+
+      case "UnitLiteral":
+        return { value: node.value, unit: node.unit };
+
+      /* ===== VARIABLE ===== */
+      case "Identifier":
+        return vars.get(node.name);
+
+      /* ===== ASSIGNMENT ===== */
+      case "AssignmentExpression": {
+        const value = evaluateAST(node.right, context);
+
+        if (node.left.type === "Identifier") {
+          vars.set(node.left.name, value);
+          return value;
+        }
+
+        if (node.left.type === "IndexExpression" && node.left.object.type === "Identifier") {
+          const currentValue = vars.get(node.left.object.name);
+          const assigned = assignMatrixIndex(currentValue, node.left.selectors, value);
+          vars.set(node.left.object.name, assigned.updatedMatrix);
+          return assigned.selectionResult;
+        }
+
+        throw new Error("Invalid assignment target");
+      }
+
+      /* ===== UNARY ===== */
+      case "UnaryExpression": {
+        const val = evaluateAST(node.argument, context);
+
+        switch (node.operator) {
+          case "-":
+            return isComplex(val)
+              ? simplifyComplex({ re: -val.re, im: -val.im })
+              : -val;
+          case "!": return !val;
+        }
+
+        throw new Error(`Unknown unary operator ${node.operator}`);
+      }
+
+      /* ===== BINARY ===== */
+      case "BinaryExpression": {
+        let left = evaluateAST(node.left, context);
+        let right = evaluateAST(node.right, context);
+
+        // 🔥 UNIT handling
+        if (isUnitObj(left) || isUnitObj(right)) {
+
+          if (!units) throw new Error("Unit system not available");
+
+          return units.compute(node.operator, left, right);
+        }
+
+        if (node.operator === "*" && (Array.isArray(left) || Array.isArray(right))) {
+          return multiplyMatrices(left, right);
+        }
+
+        if (isComplex(left) || isComplex(right)) {
+          return evalComplexBinary(node.operator, left, right);
+        }
+
+        switch (node.operator) {
+          case "+": return left + right;
+          case "-": return left - right;
+          case "*": return left * right;
+          case "/": return left / right;
+          case "%": return left % right;
+          case "^": return left ** right;
+
+          case ">": return left > right;
+          case "<": return left < right;
+          case ">=": return left >= right;
+          case "<=": return left <= right;
+          case "==": return left === right;
+        }
+
+        throw new Error(`Unknown operator ${node.operator}`);
+      }
+
+      /* ===== LOGICAL ===== */
+      case "LogicalExpression": {
+        const left = evaluateAST(node.left, context);
+
+        if (node.operator === "&&") {
+          return left && evaluateAST(node.right, context);
+        }
+
+        if (node.operator === "||") {
+          return left || evaluateAST(node.right, context);
+        }
+
+        if (node.operator === "??") {
+          return left ?? evaluateAST(node.right, context);
+        }
+
+        throw new Error(`Unknown logical operator ${node.operator}`);
+      }
+
+      /* ===== FUNCTION CALL ===== */
+      case "CallExpression": {
+        const fnName = node.callee.name;
+        const fn = fns.get(fnName);
+
+        const args = node.arguments.map(arg =>
+          evaluateAST(arg, context)
+        );
+
+        return fn(...args);
+      }
+
+      /* ===== PIPELINE ===== */
+      case "PipelineExpression": {
+        const leftVal = evaluateAST(node.left, context);
+
+        // right must be function
+        if (node.right.type === "CallExpression") {
+          const fnName = node.right.callee.name;
+          const fn = fns.get(fnName);
+
+          const args = [
+            leftVal,
+            ...node.right.arguments.map(arg =>
+              evaluateAST(arg, context)
+            )
+          ];
+
+          return fn(...args);
+        }
+
+        if (node.right.type === "Identifier") {
+          const fn = fns.get(node.right.name);
+          return fn(leftVal);
+        }
+
+        throw new Error("Invalid pipeline target");
+      }
+
+      /* ===== UNIT CONVERSION ===== */
+      case "UnitConversion": {
+        const from = evaluateAST(node.from, context);
+
+        if (!isUnitObj(from)) {
+          throw new Error("Left side must be a unit value");
+        }
+
+        if (!units) {
+          throw new Error("Unit system not available");
+        }
+
+        return units.convert(from.value, from.unit, node.to);
+      }
+
+      /* ===== ARRAY ===== */
+      case "ArrayExpression":
+        return node.elements.map(el => evaluateAST(el, context));
+
+      case "IndexExpression": {
+        const target = evaluateAST(node.object, context);
+        return indexMatrix(target, node.selectors);
+      }
+
+      /* ===== OBJECT ===== */
+      case "ObjectExpression": {
+        const obj = {};
+        for (let p of node.properties) {
+          obj[p.key] = evaluateAST(p.value, context);
+        }
+        return obj;
+      }
+
+      /* ===== MEMBER ===== */
+      case "MemberExpression": {
+        const obj = evaluateAST(node.object, context);
+
+        if (node.optional && obj == null) return undefined;
+
+        return obj[node.property.name];
+      }
+
+      default:
+        throw new Error(`Unknown AST node type: ${node.type}`);
+    }
+  }
+
+  function createContext({ variables, functions, units, evaluate}) {
+      if (!variables) throw new Error("Variable store missing");
+      if (!functions) throw new Error("Function registry missing");
+      if (!units) throw new Error("Units list missing");
+      if (!evaluate) throw new Error("evaluate function missing");
+
+      return {
+          variables: variables,
+          functions: functions,
+          units: units,
+          evaluate,
+          withScope(scope = {}) {
+              const tempVars = {
+                  ...variables.all?.(),
+                  ...scope
+              };
+              return createContext({
+                  functions: functions,
+                  evaluate,
+                  units,
+                  variables: {
+                      get: (k) => tempVars[k],
+                      set: (k, v) => (tempVars[k] = v),
+                      all: () => tempVars
+                  }
+              });
+
+          }
+      };
+  }
+
+  const isValidNumberPair = (a, b) =>
+    (typeof a === typeof b) &&
+    (typeof a === 'number' || typeof a === 'bigint');
+
+  const mathOperations = Object.freeze({
+    power: function(a, b) {
+      if (isValidNumberPair(a, b)) return a ** b;
+      throw new Error("Invalid types for ^");
+    },
+
+    multiply: function(a, b) {
+      if (isValidNumberPair(a, b)) return a * b;
+      throw new Error("Invalid types for *");
+    },
+
+    divide: function(a, b) {
+      if (isValidNumberPair(a, b)) {
+        if (b === 0) throw new Error("Division by zero");
+        return a / b;
+      }
+      throw new Error("Invalid types for /");
+    },
+
+    add: function(a, b) {
+      if (isValidNumberPair(a, b)) return a + b;
+      if (typeof a === 'string' && typeof b === 'string') return a + b;
+      throw new Error("Invalid types for +");
+    },
+    subtract: function(a, b) {
+      if (isValidNumberPair(a, b)) return a - b;
+      throw new Error("Invalid types for -");
+    },
+
+    modulus: function(a, b) {
+      if (isValidNumberPair(a, b)) return a % b;
+      throw new Error("Invalid types for %");
+    }
+  });
+
+  function createUnitsStore(initial = {}) {
+    let units = { ...initial};
+
+    // ---------- Helpers ----------
+
+    function getAllUnitsFlat() {
+      const result = new Set();
+
+      for (const type in units) {
+        for (const key in units[type]) {
+          const u = units[type][key];
+
+          const keyLower = key.toLowerCase();
+          result.add(keyLower);
+
+          // Unit name
+          if (u.unit) {
+            const unitLower = u.unit.toLowerCase();
+
+            // Avoid duplicate like "m" vs "meter"
+            if (unitLower !== keyLower) {
+              // Optional: only single-word units
+              if (unitLower.split(/\s+/).length === 1) {
+                result.add(unitLower);
+              }
+            }
+          }
+
+          // Symbol
+          if (u.symbol) {
+            const symbolLower = u.symbol.toLowerCase();
+
+            // Avoid duplicate with unit name
+            if (!u.unit || symbolLower !== u.unit.toLowerCase()) {
+              result.add(symbolLower);
+            }
+          }
+        }
+      }
+
+      return Array.from(result);
+    }
+
+    function findUnit(input) {
+      input = input.toLowerCase();
+
+      for (const type in units) {
+        for (const key in units[type]) {
+          const u = units[type][key];
+
+          if (
+            key.toLowerCase() === input ||
+            u.unit?.toLowerCase() === input ||
+            u.symbol?.toLowerCase() === input
+          ) {
+            return { type, key , data: u};
+          }
+        }
+      }
+
+      return null;
+    }
+
+    // ---------- Core Convert ----------
+
+    function convert(value, fromUnit, toUnit) {
+        const from = findUnit(fromUnit);
+        const to = findUnit(toUnit);
+
+        if (!from) throw new Error(`Unknown unit: ${fromUnit}`);
+        if (!to) throw new Error(`Unknown unit: ${toUnit}`);
+
+        if (from.type !== to.type) {
+          throw new Error(`Cannot convert ${fromUnit} to ${toUnit} (${to.data.unit || to.key}). ${from.data.unit || from.key} conversion units like ${Object.keys(units[from.type]).join(", ")}`);
+        }
+
+        const result = value * (from.data.value / to.data.value);
+
+        return { value: result, unit: to.key };
+      }
+
+    // ---------- Public API ----------
+
+    return {
+      // Get all units
+      getUnits: () => units,
+
+      // Replace all units
+      setUnits: (newUnits) => {
+        units = { ...newUnits };
+      },
+
+      // Update single type
+      updateType: (type, data) => {
+        units[type] = { ...units[type], ...data };
+      },
+
+      // Add new unit
+      addUnit: (type, key, unitObj) => {
+        if (!units[type]) units[type] = {};
+        units[type][key] = unitObj;
+      },
+      compute(op, left, right) {
+
+        const isUnit = (v) =>
+          v && typeof v === "object" && "value" in v && "unit" in v;
+
+        const apply = (a, b) => {
+          switch (op) {
+            case "+": return a + b;
+            case "-": return a - b;
+            case "*": return a * b;
+            case "/": return a / b;
+            case "%": return a % b;
+            case "^": return Math.pow(a, b);
+          }
+        };
+
+        // BOTH UNIT
+        if (isUnit(left) && isUnit(right)) {
+
+          const from = this.findUnit(right.unit);
+          const to = this.findUnit(left.unit);
+
+          if (from.type !== to.type) {
+            throw new Error(`Cannot operate on different unit types`);
+          }
+
+          // convert right → left unit
+          const r = right.value * (from.data.value / to.data.value);
+
+          const result = apply(left.value, r);
+
+          // multiplication/division produce compound units
+          if (op === "*") {
+            return { value: result, unit: left.unit };
+          }
+
+          if (op === "/") {
+            return { value: result, unit: left.unit };
+          }
+
+          if (op === "^") {
+            return { value: result, unit: left.unit };
+          }
+
+          return { value: result, unit: left.unit };
+        }
+
+        // ================= LEFT UNIT =================
+        if (isUnit(left) && !isUnit(right)) {
+          const result = apply(left.value, right);
+
+          return { value: result, unit: left.unit };
+        }
+
+        // ================= RIGHT UNIT =================
+        if (!isUnit(left) && isUnit(right)) {
+          const result = apply(left, right.value);
+
+          if (op === "/") {
+            return { value: result, unit: right.unit };
+          }
+
+          return { value: result, unit: right.unit };
+        }
+
+        // ================= NORMAL =================
+        return apply(left, right);
+      },
+      // Convert
+      convert,
+
+      // Search helpers
+      getAllUnitsFlat,
+      findUnit
+    };
+  }
+
+  const globalUnits = {
+    // Length
+    length: {
+      m: { value: 1, unit: 'meter', symbol: 'm' },
+      cm: { value: 0.01, unit: 'centimeter', symbol: 'cm' },
+      mm: { value: 0.001, unit: 'millimeter', symbol: 'mm' },
+      km: { value: 1000, unit: 'kilometer', symbol: 'km' },
+      um: { value: 0.000001, unit: 'micrometer', symbol: 'um', note: 'also called micron' },
+      nm: { value: 0.000000001, unit: 'nanometer', symbol: 'nm' },
+      px: { value: 0.000264583, unit: 'pixel', symbol: 'px', note: '96dpi standard' },
+      em: { value: 0.000264583 * 16, unit: 'em', symbol: 'em', note: '1em = 16px by default' },
+      rem: { value: 0.000264583 * 16, unit: 'rem', symbol: 'rem', note: 'root em = 16px by default' },
+      pt: { value: 0.000352778, unit: 'point', symbol: 'pt', note: '1pt = 1/72 inch' },
+      pc: { value: 0.00423333, unit: 'pica', symbol: 'pc', note: '1pc = 12pt' },
+      inch: { value: 0.0254, unit: 'inch', symbol: 'in' },
+      ft: { value: 0.3048, unit: 'foot', symbol: 'ft' },
+      yd: { value: 0.9144, unit: 'yard', symbol: 'yd' },
+      mi: { value: 1609.344, unit: 'mile', symbol: 'mi' },
+      thou: { value: 0.0000254, unit: 'mil', symbol: 'thou', note: 'thousandth of an inch' },
+      furlong: { value: 201.168, unit: 'furlong', symbol: 'fur', note: '220 yards' },
+      nmi: { value: 1852, unit: 'nautical mile', symbol: 'nmi' },
+      fathom: { value: 1.8288, unit: 'fathom', symbol: 'fathom' },
+      au: { value: 1.496e11, unit: 'astronomical unit', symbol: 'AU' },
+      ly: { value: 9.4607e15, unit: 'light year', symbol: 'ly' },
+      pc: { value: 3.0857e16, unit: 'parsec', symbol: 'pc' }
+    },
+
+    // Weight / Mass
+    weight: {
+      mg: { value: 1e-6, unit: 'milligram', symbol: 'mg' },
+      g: { value: 0.001, unit: 'gram', symbol: 'g' },
+      kg: { value: 1, unit: 'kilogram', symbol: 'kg' },
+      t: { value: 1000, unit: 'tonne', symbol: 't', note: 'metric ton' },
+      lb: { value: 0.453592, unit: 'pound', symbol: 'lb' },
+      oz: { value: 0.0283495, unit: 'ounce', symbol: 'oz' },
+      stone: { value: 6.35029, unit: 'stone', symbol: 'st', note: '1 stone = 14 lb' }
+    },
+
+    // Time
+    time: {
+      s: { value: 1, unit: 'second', symbol: 's' },
+      min: { value: 60, unit: 'minute', symbol: 'min' },
+      h: { value: 3600, unit: 'hour', symbol: 'h' },
+      day: { value: 86400, unit: 'day', symbol: 'd' },
+      week: { value: 604800, unit: 'week', symbol: 'wk' },
+      month: { value: 2629800, unit: 'month', symbol: 'mo', note: 'average month = 30.44 days' },
+      year: { value: 31557600, unit: 'year', symbol: 'yr', note: 'average year = 365.25 days' }
+    },
+
+    // Voltage
+    voltage: {
+      V:      { value: 1, unit: 'volt', symbol: 'V' },
+      mV: { value: 0.001, unit: 'millivolt', symbol: 'mV' },
+      kV: { value: 1000, unit: 'kilovolt', symbol: 'kV' },
+      MV: { value: 1e6, unit: 'megavolt', symbol: 'MV' },
+      GV: { value: 1e9, unit: 'gigavolt', symbol: 'GV' },
+      statV: { value: 299.792458, unit: 'statvolt', symbol: 'statV', note: 'CGS unit' },
+      abV: { value: 1e-8, unit: 'abvolt', symbol: 'abV', note: 'CGS electromagnetic unit' }
+    },
+
+    // Frequency
+    frequency: {
+      Hz: { value: 1, unit: 'hertz', symbol: 'Hz', note: '1 cycle per second' },
+      kHz: { value: 1e3, unit: 'kilohertz', symbol: 'kHz' },
+      MHz: { value: 1e6, unit: 'megahertz', symbol: 'MHz' },
+      GHz: { value: 1e9, unit: 'gigahertz', symbol: 'GHz' },
+      THz: { value: 1e12, unit: 'terahertz', symbol: 'THz' }
+    },
+
+    // Power
+    power: {
+      W: { value: 1, unit: 'watt', symbol: 'W', note: '1 joule per second' },
+      mW: { value: 0.001, unit: 'milliwatt', symbol: 'mW' },
+      kW: { value: 1000, unit: 'kilowatt', symbol: 'kW' },
+      MW: { value: 1e6, unit: 'megawatt', symbol: 'MW' },
+      GW: { value: 1e9, unit: 'gigawatt', symbol: 'GW' },
+      HP: { value: 745.7, unit: 'horsepower', symbol: 'HP', note: 'mechanical HP = 745.7 W' },
+      kcal_per_h: { value: 1.163, unit: 'kilocalorie per hour', symbol: 'kcal/h', note: '= 1.163 W' },
+      BTU_per_h: { value: 0.29307107, unit: 'BTU per hour', symbol: 'BTU/h', note: '= 0.293 W' }
+    },
+
+    // Sound
+    sound: {
+      dB: { value: 1, unit: 'decibel', symbol: 'dB', note: 'logarithmic unit of sound intensity' },
+      dBA: { value: 1, unit: 'A-weighted decibel', symbol: 'dBA', note: 'Adjusted for human hearing' },
+      dBC: { value: 1, unit: 'C-weighted decibel', symbol: 'dBC', note: 'Flat weighting for high-level sounds' }
+    },
+
+    // Temperature
+    temperature: {
+      K: { value: 1, unit: 'kelvin', symbol: 'K' },
+      C: { value: 1, unit: 'Celsius', symbol: '°C', note: '°C → K: add 273.15' },
+      F: { value: 1, unit: 'Fahrenheit', symbol: '°F', note: '°F → K: (°F - 32) * 5/9 + 273.15' }
+    },
+
+    // Pressure
+    pressure: {
+      Pa: { value: 1, unit: 'pascal', symbol: 'Pa' },
+      kPa: { value: 1000, unit: 'kilopascal', symbol: 'kPa' },
+      MPa: { value: 1e6, unit: 'megapascal', symbol: 'MPa' },
+      bar: { value: 1e5, unit: 'bar', symbol: 'bar' },
+      atm: { value: 101325, unit: 'atmosphere', symbol: 'atm' },
+      psi: { value: 6894.757, unit: 'pound per square inch', symbol: 'psi' },
+      mmHg:{ value: 133.322, unit: 'millimeter of mercury', symbol: 'mmHg' }
+    },
+
+    // Energy
+    energy: {
+      J: { value: 1, unit: 'joule', symbol: 'J' },
+      kJ: { value: 1000, unit: 'kilojoule', symbol: 'kJ' },
+      cal: { value: 4.184, unit: 'calorie', symbol: 'cal' },
+      kcal:{ value: 4184, unit: 'kilocalorie', symbol: 'kcal' },
+      eV: { value: 1.60218e-19, unit: 'electronvolt', symbol: 'eV' },
+      BTU: { value: 1055.06, unit: 'BTU', symbol: 'BTU' }
+    },
+
+    // Force
+    force: {
+      N: { value: 1, unit: 'newton', symbol: 'N' },
+      kN: { value: 1000, unit: 'kilonewton', symbol: 'kN' },
+      lbf: { value: 4.44822, unit: 'pound-force', symbol: 'lbf' },
+      kgf: { value: 9.80665, unit: 'kilogram-force', symbol: 'kgf' },
+      dyne:{ value: 1e-5, unit: 'dyne', symbol: 'dyn' }
+    },
+
+    // Area
+    area: {
+      m2: { value: 1, unit: 'square meter', symbol: 'm²' },
+      cm2: { value: 0.0001, unit: 'square centimeter', symbol: 'cm²' },
+      km2: { value: 1e6, unit: 'square kilometer', symbol: 'km²' },
+      acre: { value: 4046.856, unit: 'acre', symbol: 'acre' },
+      hectare:{ value: 10000, unit: 'hectare', symbol: 'ha' },
+      ft2: { value: 0.092903, unit: 'square foot', symbol: 'ft²' },
+      yd2: { value: 0.836127, unit: 'square yard', symbol: 'yd²' }
+    },
+
+    // Volume
+    volume: {
+      m3: { value: 1, unit: 'cubic meter', symbol: 'm³' },
+      L: { value: 0.001, unit: 'liter', symbol: 'L' },
+      mL: { value: 1e-6, unit: 'milliliter', symbol: 'mL' },
+      gallon:{ value: 0.00378541, unit: 'US gallon', symbol: 'gal' },
+      pint: { value: 0.000473176, unit: 'US pint', symbol: 'pt' },
+      floz: { value: 2.9574e-5, unit: 'US fluid ounce', symbol: 'fl oz' }
+    },
+
+    // Electrical Current
+    current: {
+      A: { value: 1, unit: 'ampere', symbol: 'A' },
+      mA: { value: 0.001, unit: 'milliampere', symbol: 'mA' },
+      uA: { value: 0.000001, unit: 'microampere', symbol: 'uA' },
+      kA: { value: 1000, unit: 'kiloampere', symbol: 'kA' }
+    },
+
+    // Resistance / Conductance
+    resistance: {
+      ohm: { value: 1, unit: 'ohm' },
+      kohm: { value: 1000, unit: 'kiloohm'},
+      megaohm: { value: 1e6, unit: 'megaohm'},
+      S: { value: 1, unit: 'siemens', symbol: 'S', note: 'conductance' }
+    },
+
+    // Capacitance / Inductance
+    capacitance: {
+      F: { value: 1, unit: 'farad', symbol: 'F' },
+      mF: { value: 0.001, unit: 'millifarad'},
+      uF: { value: 0.000001, unit: 'microfarad' }
+    },
+    inductance: {
+      H: { value: 1, unit: 'henry', symbol: 'H' },
+      mH: { value: 0.001, unit: 'millihenry', symbol: 'mH' },
+      uH: { value: 0.000001, unit: 'microhenry', symbol: 'uH' }
+    },
+
+    // Luminous Intensity / Illuminance
+    light: {
+      cd: { value: 1, unit: 'candela', symbol: 'cd' },
+      lm: { value: 1, unit: 'lumen', symbol: 'lm' },
+      lx: { value: 1, unit: 'lux', symbol: 'lx' }
+    },
+
+    // Data / Digital Storage
+    data: {
+      bit: { value: 1, unit: 'bit', symbol: 'bit' },
+      B: { value: 8, unit: 'byte', symbol: 'B' },
+      KB: { value: 8e3, unit: 'kilobyte', symbol: 'KB' },
+      MB: { value: 8e6, unit: 'megabyte', symbol: 'MB' },
+      GB: { value: 8e9, unit: 'gigabyte', symbol: 'GB' },
+      TB: { value: 8e12, unit: 'terabyte', symbol: 'TB' }
+    },
+
+    // Angle
+    angle: {
+      deg: { value: 1, unit: 'degree', symbol: '°' },
+      rad: { value: 57.2958, unit: 'radian', symbol: 'rad', note: '1 rad = 57.2958°' },
+      grad:{ value: 0.9, unit: 'grad', symbol: 'grad', note: '1 grad = 0.9°' }
+    },
+    radiation: {
+      // Absorbed Dose
+      Gy: { value: 1, unit: 'gray', symbol: 'Gy', note: 'Absorbed dose: 1 Gy = 1 J/kg' },
+      mGy: { value: 0.001, unit: 'milligray', symbol: 'mGy' },
+      rad: { value: 0.01, unit: 'rad', symbol: 'rad', note: '1 rad = 0.01 Gy' },
+
+      // Dose Equivalent
+      Sv: { value: 1, unit: 'sievert', symbol: 'Sv', note: 'Biological effect dose equivalent' },
+      mSv: { value: 0.001, unit: 'millisievert', symbol: 'mSv' },
+      rem: { value: 0.01, unit: 'rem', symbol: 'rem', note: '1 rem = 0.01 Sv' },
+
+      // Radioactivity
+      Bq: { value: 1, unit: 'becquerel', symbol: 'Bq', note: '1 decay per second' },
+      kBq: { value: 1e3, unit: 'kilobecquerel', symbol: 'kBq' },
+      MBq: { value: 1e6, unit: 'megabecquerel', symbol: 'MBq' },
+      GBq: { value: 1e9, unit: 'gigabecquerel', symbol: 'GBq' },
+      Ci: { value: 3.7e10, unit: 'curie', symbol: 'Ci', note: '1 Ci = 3.7 x 10¹⁰ decays per second' },
+      mCi: { value: 3.7e7, unit: 'millicurie', symbol: 'mCi' }
+    }
+  };
+
+  const validVarName = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/;
+
+  function createVarStore(initial = {}) {
+    let store = Object.create(null);
+    
+
+    for (const key in initial) {
+      store[key] = initial[key];
+    }
+
+    return {
+      set(name, value, { override = true } = {}) {
+
+        // Name validation
+        if (typeof name !== "string" || !name) {
+          throw new Error("Variable name must be a non-empty string");
+        }
+
+        if (!validVarName.test(name)) {
+          throw new Error(`Variable Name Error: '${name}' is not a valid variable name`);
+        }
+
+        // Value validation
+        if (value === undefined) {
+          throw new Error(`Variable Value Error: '${name}' cannot be undefined`);
+        }
+
+        // Prevent overwrite (optional)
+        if (!override && name in variablesDB) {
+          throw new Error(`Variable '${name}' already exists`);
+        }
+
+        store[name] = value;
+      },
+
+      //get variable
+      get(name) {
+        return store[name];
+      },
+
+      // check existence
+      has(name) {
+        return Object.prototype.hasOwnProperty.call(store, name);
+      },
+
+      // remove variable
+      remove(name) {
+        delete store[name];
+      },
+
+      // get all variables (snapshot)
+      all() {
+        return { ...store };
+      },
+
+      // clear all
+      clear() {
+        store = Object.create(null);
+      },
+
+      // merge multiple variables
+      merge(obj = {}) {
+        for (const key in obj) {
+          store[key] = obj[key];
+        }
+      },
+
+      // clone store (for scoped instances) 
+      clone() {
+        return createVarStore(store);
+      }
+    };
+  }
+
+  function createFunctionRegistry(initial = {}) {
+    const store = Object.create(null);
+
+    for (const key in initial) {
+      if (typeof initial[key] === "function") {
+        store[key] = initial[key];
+      }
+    }
+
+    return {
+      getAllFunctionsName() {
+        return Object.keys(store);
+      },
+      // register new formula
+      register(name, fn) {
+        if (typeof name !== "string" || !name) {
+          throw new Error("Formula name must be a non-empty string");
+        }
+
+        if (typeof fn !== "function") {
+          throw new Error(`Formula "${name}" must be callable`);
+        }
+
+        store[name] = fn;
+      },
+
+      // get formula
+      get(name) {
+        return store[name];
+      },
+
+      // check existence
+      has(name) {
+        return Object.prototype.hasOwnProperty.call(store, name);
+      },
+
+      // remove formula
+      remove(name) {
+        delete store[name];
+      },
+
+      // list all
+      all() {
+        return { ...store };
+      },
+
+      // clear registry
+      clear() {
+        for (const key in store) {
+          delete store[key];
+        }
+      },
+
+      // extend multiple
+      extend(formulas = {}) {
+        for (const name in formulas) {
+          if (typeof formulas[name] === "function") {
+            store[name] = formulas[name];
+          }
+        }
+      },
+
+      // clone (for scoped instances)
+      clone() {
+        return createFormulaRegistry(store);
+      }
+    };
+  }
+
+  function validateSquareMatrix(matrix) {
+    if (!Array.isArray(matrix) || matrix.length === 0) {
+      throw new Error("det() expects a non-empty matrix");
+    }
+
+    if (!matrix.every(Array.isArray)) {
+      throw new Error("det() expects a 2D matrix");
+    }
+
+    const size = matrix.length;
+    if (!matrix.every((row) => row.length === size)) {
+      throw new Error("det() expects a square matrix");
+    }
+
+    for (const row of matrix) {
+      for (const value of row) {
+        if (typeof value !== "number" && typeof value !== "bigint") {
+          throw new Error("det() matrix values must be numeric");
+        }
+      }
+    }
+  }
+
+  function determinant(matrix) {
+    validateSquareMatrix(matrix);
+
+    if (matrix.length === 1) {
+      return matrix[0][0];
+    }
+
+    if (matrix.length === 2) {
+      return (matrix[0][0] * matrix[1][1]) - (matrix[0][1] * matrix[1][0]);
+    }
+
+    return matrix[0].reduce((sum, value, columnIndex) => {
+      const minor = matrix.slice(1).map((row) =>
+        row.filter((_, index) => index !== columnIndex)
+      );
+      const cofactor = columnIndex % 2 === 0 ? value : -value;
+      return sum + (cofactor * determinant(minor));
+    }, 0);
+  }
+
+  function splitTerms(expression) {
+    const normalized = expression.replace(/\s+/g, "");
+    if (!normalized) {
+      return [];
+    }
+
+    return normalized
+      .replace(/-/g, "+-")
+      .split("+")
+      .filter(Boolean);
+  }
+
+  function parsePolynomial(expression, variable) {
+    const terms = splitTerms(expression);
+    const coefficients = new Map();
+
+    for (const term of terms) {
+      if (term.includes(variable)) {
+        const [rawCoeff, rawPower] = term.split(variable);
+        let coefficient;
+
+        if (rawCoeff === "" || rawCoeff === "+") coefficient = 1;
+        else if (rawCoeff === "-") coefficient = -1;
+        else {
+          const cleaned = rawCoeff.endsWith("*") ? rawCoeff.slice(0, -1) : rawCoeff;
+          coefficient = Number(cleaned);
+        }
+
+        if (!Number.isFinite(coefficient)) {
+          throw new Error("Unsupported algebra term");
+        }
+
+        let power = 1;
+        if (rawPower) {
+          if (!rawPower.startsWith("^")) {
+            throw new Error("Unsupported algebra term");
+          }
+
+          power = Number(rawPower.slice(1));
+        }
+
+        if (!Number.isInteger(power) || power < 0) {
+          throw new Error("Only non-negative integer powers are supported");
+        }
+
+        coefficients.set(power, (coefficients.get(power) || 0) + coefficient);
+      } else {
+        const constant = Number(term);
+        if (!Number.isFinite(constant)) {
+          throw new Error("Unsupported algebra term");
+        }
+        coefficients.set(0, (coefficients.get(0) || 0) + constant);
+      }
+    }
+
+    return coefficients;
+  }
+
+  function formatPolynomial(coefficients, variable) {
+    const ordered = [...coefficients.entries()]
+      .filter(([, coefficient]) => coefficient !== 0)
+      .sort((a, b) => b[0] - a[0]);
+
+    if (!ordered.length) {
+      return "0";
+    }
+
+    return ordered.map(([power, coefficient], index) => {
+      const negative = coefficient < 0;
+      const absCoeff = Math.abs(coefficient);
+      let body;
+
+      if (power === 0) {
+        body = `${absCoeff}`;
+      } else if (power === 1) {
+        body = absCoeff === 1 ? variable : `${absCoeff} * ${variable}`;
+      } else {
+        body = absCoeff === 1
+          ? `${variable}^${power}`
+          : `${absCoeff} * ${variable}^${power}`;
+      }
+
+      if (index === 0) {
+        return negative ? `-${body}` : body;
+      }
+
+      return negative ? `- ${body}` : `+ ${body}`;
+    }).join(" ");
+  }
+
+  function simplifyExpression(expression) {
+    const compact = expression.replace(/\s+/g, "");
+    const variableMatch = compact.match(/[a-zA-Z]+/);
+    const variable = variableMatch?.[0] || "x";
+    const coefficients = parsePolynomial(expression, variable);
+    return formatPolynomial(coefficients, variable);
+  }
+
+  function derivativeExpression(expression, variable) {
+    const coefficients = parsePolynomial(expression, variable);
+    const derived = new Map();
+
+    for (const [power, coefficient] of coefficients.entries()) {
+      if (power === 0) continue;
+      derived.set(power - 1, (derived.get(power - 1) || 0) + (coefficient * power));
+    }
+
+    return formatPolynomial(derived, variable);
+  }
+
+  const internalFunctions = {
+    max: (...args) => {
+      if (!args.length) throw new Error("max() requires arguments");
+      return Math.max(...args);
+    },
+
+    min: (...args) => {
+      if (!args.length) throw new Error("min() requires arguments");
+      return Math.min(...args);
+    },
+
+    abs: (x) => Math.abs(x),
+
+    round: (x) => Math.round(x),
+
+    floor: (x) => Math.floor(x),
+
+    ceil: (x) => Math.ceil(x),
+
+    sqrt: (x) => {
+      if (x < 0) throw new Error("sqrt() domain error");
+      return Math.sqrt(x);
+    },
+
+    pow: (a, b) => a ** b,
+    det: (matrix) => determinant(matrix),
+    simplify: (expression) => {
+      if (typeof expression !== "string") {
+        throw new Error("simplify() expects an expression string");
+      }
+      return simplifyExpression(expression);
+    },
+    derivative: (expression, variable = "x") => {
+      if (typeof expression !== "string" || typeof variable !== "string") {
+        throw new Error("derivative() expects expression and variable strings");
+      }
+      return derivativeExpression(expression, variable);
+    },
+
+    /* ================= TRIGONOMETRY ================= */
+
+    sin: (x) => Math.sin(x),
+    cos: (x) => Math.cos(x),
+    tan: (x) => Math.tan(x),
+
+    asin: (x) => Math.asin(x),
+    acos: (x) => Math.acos(x),
+    atan: (x) => Math.atan(x),
+
+    /* ================= LOG / EXP ================= */
+
+    log: (x) => {
+      if (x <= 0) throw new Error("log() domain error");
+      return Math.log(x);
+    },
+
+    log10: (x) => {
+      if (x <= 0) throw new Error("log10() domain error");
+      return Math.log10(x);
+    },
+
+    exp: (x) => Math.exp(x),
+
+    /* ================= RANDOM ================= */
+
+    random: () => Math.random(),
+
+    /* ================= BOOLEAN / LOGIC ================= */
+
+    and: (a, b) => Boolean(a && b),
+
+    or: (a, b) => Boolean(a || b),
+
+    not: (a) => !a,
+    "!": (a) => !a,
+
+    /* ================= COMPARISON ================= */
+
+    eq: (a, b) => a === b,
+
+    neq: (a, b) => a !== b,
+    "notEqual": (a, b) => a !== b,
+
+    gt: (a, b) => a > b,
+    "greaterThan": (a, b) => a > b,
+
+    lt: (a, b) => a < b,
+    "lessThan": (a, b) => a < b,
+
+    gte: (a, b) => a >= b,
+    "greaterThanOrEqual": (a, b) => a >= b,
+
+    lte: (a, b) => a <= b,
+    "lessThanOrEqual": (a, b) => a <= b,
+
+    /* ================= UTILITY ================= */
+
+    clamp: (x, min, max) => {
+      if (min > max) throw new Error("clamp(): min > max");
+      return Math.min(Math.max(x, min), max);
+    },
+
+    if: (condition, a, b) => (condition ? a : b),
+
+    /* ================= TYPE ================= */
+
+    typeof: (x) => typeof x,
+
+    /* ================= STRING ================= */
+
+    length: (x) => {
+      if (typeof x === "string" || Array.isArray(x)) {
+        return x.length;
+      }
+      throw new Error("length() expects string or array");
+    }
+  };
+
+  function buildAST(tokens) {
+    let current = 0;
+
+    const peek = () => tokens[current];
+    const consume = () => tokens[current++];
+
+    const match = (type, value) => {
+      const t = peek();
+      if (!t) return false;
+
+      if (t.type !== type) return false;
+
+      if (value !== undefined && t.value !== value) return false;
+
+      current++;
+      return true;
+    };
+
+    const parseSliceOrIndex = () => {
+      let start = null;
+
+      if (!(peek()?.type === "Colon" || peek()?.type === "Comma" || peek()?.type === "ArrayEnd")) {
+        start = parseExpression();
+      }
+
+      if (match("Colon")) {
+        let end = null;
+
+        if (!(peek()?.type === "Comma" || peek()?.type === "ArrayEnd")) {
+          end = parseExpression();
+        }
+
+        return {
+          type: "SliceExpression",
+          start,
+          end
+        };
+      }
+
+      return start;
+    };
+
+    /* ================= PRIMARY ================= */
+    function parsePrimary() {
+      const token = consume();
+      if (!token) throw new Error("Unexpected end of input");
+
+      switch (token.type) {
+        case "Number":
+        case "BigInt":
+        case "Boolean":
+        case "String":
+          return { type: "Literal", value: token.value };
+
+        case "ImaginaryLiteral":
+          return { type: "ImaginaryLiteral", value: token.value };
+
+        case "NumberWithUnit":
+          return {
+            type: "UnitLiteral",
+            value: token.value,
+            unit: token.unit
+          };
+
+        case "Identifier":
+          return { type: "Identifier", name: token.name };
+        
+        case "Function": // 🔥 ADD THIS
+          return {
+            type: "Identifier",
+            name: token.name
+          };
+
+        case "Parenthesis":
+          if (token.value === "(") {
+            const expr = parseExpression();
+
+            if (!match("Parenthesis", ")")) {
+              throw new Error(`Expected ')'`);
+            }
+
+            return expr;
+          }
+          
+        case "ArrayStart": {
+          const rows = [];
+          let currentRow = [];
+
+          if (!match("ArrayEnd")) {
+            while (true) {
+              currentRow.push(parseExpression());
+
+              if (match("Comma")) {
+                continue;
+              }
+
+              if (match("Semicolon")) {
+                rows.push(currentRow);
+                currentRow = [];
+                continue;
+              }
+
+              if (match("ArrayEnd")) {
+                rows.push(currentRow);
+                break;
+              }
+
+              throw new Error(`Expected ',', ';', or ']' at ${current}`);
+            }
+          }
+
+          if (!rows.length) {
+            return { type: "ArrayExpression", elements: [] };
+          }
+
+          if (rows.length === 1) {
+            return { type: "ArrayExpression", elements: rows[0] };
+          }
+
+          return {
+            type: "ArrayExpression",
+            elements: rows.map((elements) => ({
+              type: "ArrayExpression",
+              elements
+            }))
+          };
+        }
+
+        case "BlockStart": {
+          const properties = [];
+
+          if (!match("BlockEnd")) {
+            do {
+              const keyToken = consume();
+
+              if (
+                keyToken.type !== "Identifier" &&
+                keyToken.type !== "String"
+              ) {
+                throw new Error("Invalid object key");
+              }
+
+              if (!match("Colon")) {
+                throw new Error("Expected ':' after key");
+              }
+
+              const value = parseExpression();
+
+              properties.push({
+                key: keyToken.value,
+                value
+              });
+
+            } while (match("Comma"));
+
+            if (!match("BlockEnd")) {
+              throw new Error(`Expected '}' at ${current}`);
+            }
+          }
+
+          return { type: "ObjectExpression", properties };
+        }
+      }
+
+      throw new Error(`Unexpected token: ${JSON.stringify(token)}`);
+    }
+
+    /* ================= MEMBER ================= */
+    function parseMember() {
+      let object = parsePrimary();
+
+      while (true) {
+        if (match("ArrayStart")) {
+          const selectors = [];
+
+          if (!match("ArrayEnd")) {
+            do {
+              selectors.push(parseSliceOrIndex());
+            } while (match("Comma"));
+
+            if (!match("ArrayEnd")) {
+              throw new Error(`Expected ']' at ${current}`);
+            }
+          }
+
+          object = {
+            type: "IndexExpression",
+            object,
+            selectors
+          };
+          continue;
+        }
+
+        if (match("Dot")) {
+          const property = consume();
+
+          if (property.type !== "Identifier") {
+            throw new Error("Expected property after '.'");
+          }
+
+          object = {
+            type: "MemberExpression",
+            object,
+            property: { type: "Identifier", name: property.value },
+            optional: false
+          };
+          continue;
+        }
+
+        if (match("Operator", "?.")) {
+          const property = consume();
+
+          object = {
+            type: "MemberExpression",
+            object,
+            property: { type: "Identifier", name: property.value },
+            optional: true
+          };
+          continue;
+        }
+
+        break;
+      }
+
+      return object;
+    }
+
+    /* ================= CALL ================= */
+    function parseCallChain() {
+      let expr = parseMember();
+
+      while (peek()?.type === "Parenthesis" && peek()?.value === "(") {
+        consume(); // '('
+
+        const args = [];
+
+        if (!(peek()?.type === "Parenthesis" && peek()?.value === ")")) {
+          do {
+            args.push(parseExpression());
+          } while (match("Comma"));
+        }
+
+        if (!match("Parenthesis", ")")) {
+          throw new Error(`Expected ')' at ${current}`);
+        }
+
+        expr = {
+          type: "CallExpression",
+          callee: expr,
+          arguments: args
+        };
+      }
+
+      return expr;
+    }
+
+    /* ================= UNARY ================= */
+    function parseUnary() {
+      if (match("UnaryOperator")) {
+        const operator = tokens[current - 1].value;
+
+        return {
+          type: "UnaryExpression",
+          operator,
+          argument: parseUnary()
+        };
+      }
+
+      return parseCallChain();
+    }
+
+    /* ================= POWER ================= */
+    function parsePower() {
+      let left = parseUnary();
+
+      if (match("Operator", "^")) {
+        const right = parsePower();
+        return {
+          type: "BinaryExpression",
+          operator: "^",
+          left,
+          right
+        };
+      }
+
+      return left;
+    }
+
+    /* ================= MULT ================= */
+    function parseMultiplication() {
+      let left = parsePower();
+
+      while (
+        match("Operator", "*") ||
+        match("Operator", "/") ||
+        match("Operator", "%")
+      ) {
+        const operator = tokens[current - 1].value;
+        const right = parsePower();
+
+        left = {
+          type: "BinaryExpression",
+          operator,
+          left,
+          right
+        };
+      }
+
+      return left;
+    }
+
+    /* ================= ADD ================= */
+    function parseAddition() {
+      let left = parseMultiplication();
+
+      while (match("Operator", "+") || match("Operator", "-")) {
+        const operator = tokens[current - 1].value;
+        const right = parseMultiplication();
+
+        left = {
+          type: "BinaryExpression",
+          operator,
+          left,
+          right
+        };
+      }
+
+      return left;
+    }
+
+    /* ================= UNIT CONVERSION ================= */
+    function parseUnitConversion() {
+      let left = parseAddition();
+
+      const nextKeyword = peek();
+      if (nextKeyword?.type === "Keyword" && ["to", "in"].includes(nextKeyword.value)) {
+        consume();
+        const next = consume();
+
+        if (!next || next.type !== "Unit") {
+          throw new Error(`Expected unit after '${nextKeyword.value}'`);
+        }
+
+        return {
+          type: "UnitConversion",
+          from: left,
+          to: next.value
+        };
+      }
+
+      return left;
+    }
+
+    /* ================= COMPARISON ================= */
+    function parseComparison() {
+      let left = parseUnitConversion();
+
+      while (
+        match("Operator", ">") ||
+        match("Operator", "<") ||
+        match("Operator", ">=") ||
+        match("Operator", "<=") ||
+        match("Operator", "==")
+      ) {
+        const operator = tokens[current - 1].value;
+        const right = parseUnitConversion();
+
+        left = {
+          type: "BinaryExpression",
+          operator,
+          left,
+          right
+        };
+      }
+
+      return left;
+    }
+
+    /* ================= LOGICAL ================= */
+    function parseLogical() {
+      let left = parseComparison();
+
+      while (
+        match("Operator", "&&") ||
+        match("Operator", "||")
+      ) {
+        const operator = tokens[current - 1].value;
+        const right = parseComparison();
+
+        left = {
+          type: "LogicalExpression",
+          operator,
+          left,
+          right
+        };
+      }
+
+      return left;
+    }
+
+    /* ================= NULLISH ================= */
+    function parseNullish() {
+      let left = parseLogical();
+
+      while (match("Operator", "??")) {
+        const right = parseLogical();
+
+        left = {
+          type: "LogicalExpression",
+          operator: "??",
+          left,
+          right
+        };
+      }
+
+      return left;
+    }
+
+    /* ================= TERNARY ================= */
+    function parseTernary() {
+      let test = parseNullish();
+
+      if (match("Ternary", "?")) {
+        const consequent = parseExpression();
+
+        if (!match("Ternary", ":")) {
+          throw new Error("Expected ':' in ternary");
+        }
+
+        const alternate = parseExpression();
+
+        return {
+          type: "ConditionalExpression",
+          test,
+          consequent,
+          alternate
+        };
+      }
+
+      return test;
+    }
+
+    /* ================= PIPELINE ================= */
+    function parsePipeline() {
+      let left = parseTernary();
+
+      while (match("Operator", "|>")) {
+        const right = parseTernary();
+
+        left = {
+          type: "PipelineExpression",
+          left,
+          right
+        };
+      }
+
+      return left;
+    }
+
+    /* ================= ASSIGNMENT ================= */
+    function parseAssignment() {
+      let left = parsePipeline();
+
+      if (
+        match("Operator", "=") ||
+        match("Operator", "+=") ||
+        match("Operator", "-=") ||
+        match("Operator", "*=") ||
+        match("Operator", "/=")
+      ) {
+        const operator = tokens[current - 1].value;
+
+        if (
+          left.type !== "Identifier" &&
+          left.type !== "MemberExpression" &&
+          left.type !== "IndexExpression"
+        ) {
+          throw new Error("Invalid assignment target");
+        }
+
+        const right = parseAssignment();
+
+        return {
+          type: "AssignmentExpression",
+          operator,
+          left,
+          right
+        };
+      }
+
+      return left;
+    }
+
+    /* ================= ENTRY ================= */
+    function parseExpression() {
+      return parseAssignment();
+    }
+
+    const ast = parseExpression();
+
+    if (current < tokens.length) {
+      throw new Error(
+        `Unexpected token at end: ${JSON.stringify(peek())}`
+      );
+    }
+
+    return ast;
+  }
+
+  //
+
+  const isComplex = (value) =>
+      value && typeof value === "object" && "re" in value && "im" in value;
+
+  const isUnitValue = (value) =>
+      value && typeof value === "object" && "value" in value && "unit" in value;
+
+  const isMatrix = (value) =>
+      Array.isArray(value) && value.length > 0 && value.every(Array.isArray);
+
+  const formatComplex = (value) => {
+      if (!isComplex(value)) return value;
+
+      const real = value.re;
+      const imaginary = Math.abs(value.im);
+      const sign = value.im < 0 ? "-" : "+";
+
+      if (real === 0) {
+          if (value.im === 1) return "i";
+          if (value.im === -1) return "-i";
+          return `${value.im}i`;
+      }
+
+      const imagPart = imaginary === 1 ? "i" : `${imaginary}i`;
+      return `${real} ${sign} ${imagPart}`;
+  };
+
+  const formatResult = (value) => {
+      if (isComplex(value)) {
+          return formatComplex(value);
+      }
+
+      if (isUnitValue(value)) {
+          return `${value.value} ${value.unit}`;
+      }
+
+      if (isMatrix(value)) {
+          return value.map((row) => row.join("\t")).join("\n");
+      }
+
+      if (Array.isArray(value)) {
+          return value.join("\n");
+      }
+
+      return value;
+  };
+
+  class exprify {
+      constructor() {
+          // Shared state
+          this.math = mathOperations;
+          this.units = createUnitsStore(globalUnits);
+          this.functions = createFunctionRegistry(internalFunctions);
+          this.variables = createVarStore();
+          this._cache = new Map();
+      }
+
+      setVariable(name, value) {
+          this.variables.set(name, value);
+      }
+
+      getVariable(name) {
+          return this.variables.get(name);
+      }
+
+      addFunction(name, fn) {
+          this.functions.register(name, fn);
+      }
+
+      _createContext() {
+          return createContext({
+              functions: this.functions,
+              variables: this.variables,
+              units: this.units,
+              evaluate: this.evaluate.bind(this)
+          });
+      }
+
+      tokenize(expr) {
+          if (typeof expr !== "string") {
+              throw new Error("Expression must be a string");
+          }
+          return tokenize(expr, this._createContext());
+      }
+
+      parse(expr) {
+          const tokens = this.tokenize(expr);
+          const ast = buildAST(tokens);
+          return { tokens, ast };
+      }
+
+      evaluate(expr) {
+          const { ast } = this.parse(expr);
+          return formatResult(evaluateAST(
+              ast,
+              this._createContext()
+          ));
+      }
+
+      compile(expr) {
+          if (this._cache.has(expr)) {
+              return this._cache.get(expr);
+          }
+
+          const { ast } = this.parse(expr);
+
+          const compiledFn = (scope = {}) => {
+              const baseContext = this._createContext();
+              const scopedContext = baseContext.withScope(scope);
+              return formatResult(evaluateAST(ast, scopedContext));
+          };
+
+          this._cache.set(expr, compiledFn);
+          return compiledFn;
+      }
+
+      clearCache() {
+          this._cache.clear();
+      }
+
+  }
+
+  return exprify;
 
 }));