exprify 1.0.0

package/dist/exprify.min.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exprify.min.js","sources":["../src/math/operations.js","../src/functions/internalFunctions.js","../src/functions/externalFunctions.js","../src/variables/variables.js","../src/utils/typeConverter.js","../src/core/Exprify.js","../src/parser/tokenizer.js","../src/parser/infixToPostfix.js","../src/parser/evaluator.js"],"sourcesContent":["const isValidNumberPair = (a, b) =>\r\n  (typeof a === typeof b) &&\r\n  (typeof a === 'number' || typeof a === 'bigint');\r\n\r\nexport const mathOperations = Object.freeze({\r\n\r\n  operator_precedence: {\r\n    '^': 4,\r\n    '*': 3,\r\n    '/': 3,\r\n    '%': 3,\r\n    '+': 1,\r\n    '-': 1,\r\n  },\r\n\r\n  power: function(a, b) {\r\n    if (isValidNumberPair(a, b)) return a ** b;\r\n    throw new Error(\"Invalid types for ^\");\r\n  },\r\n\r\n  multiply: function(a, b) {\r\n    if (isValidNumberPair(a, b)) return a * b;\r\n    throw new Error(\"Invalid types for *\");\r\n  },\r\n\r\n  divide: function(a, b) {\r\n    if (isValidNumberPair(a, b)) {\r\n      if (b === 0) throw new Error(\"Division by zero\");\r\n      return a / b;\r\n    }\r\n    throw new Error(\"Invalid types for /\");\r\n  },\r\n\r\n  add: function(a, b) {\r\n    if (isValidNumberPair(a, b)) return a + b;\r\n    if (typeof a === 'string' && typeof b === 'string') return a + b;\r\n    throw new Error(\"Invalid types for +\");\r\n  },\r\n  subtract: function(a, b) {\r\n    if (isValidNumberPair(a, b)) return a - b;\r\n    throw new Error(\"Invalid types for -\");\r\n  },\r\n\r\n  modulus: function(a, b) {\r\n    if (isValidNumberPair(a, b)) return a % b;\r\n    throw new Error(\"Invalid types for %\");\r\n  }\r\n});","const and = (...args) => args.every(Boolean);\r\nconst or = (...args) => args.some(Boolean);\r\nconst not = (val) => !val;\r\n\r\nconst gt = (a, b) => a > b;\r\nconst lt = (a, b) => a < b;\r\nconst eq = (a, b) => a === b;\r\nconst gte = (a, b) => a >= b;\r\nconst lte = (a, b) => a <= b;\r\n\r\nexport const internalFunctions = Object.freeze({\r\n\r\n  max: (...args) => {\r\n    if (!args.every(v => typeof v === 'number')) {\r\n      throw new Error(\"max() expects numbers only\");\r\n    }\r\n    return Math.max(...args);\r\n  },\r\n\r\n  min: (...args) => {\r\n    if (!args.every(v => typeof v === 'number')) {\r\n      throw new Error(\"min() expects numbers only\");\r\n    }\r\n    return Math.min(...args);\r\n  },\r\n\r\n  and,\r\n  \"&&\": and,\r\n\r\n  or,\r\n  \"||\": or,\r\n\r\n  not,\r\n  \"!\": not,\r\n\r\n  greaterThan: gt,\r\n  \">\": gt,\r\n\r\n  lessThan: lt,\r\n  \"<\": lt,\r\n\r\n  isEqual: eq,\r\n  \"==\": eq,\r\n\r\n  greaterThanOrEqual: gte,\r\n  \">=\": gte,\r\n\r\n  lessThanOrEqual: lte,\r\n  \"<=\": lte,\r\n\r\n  if: (cond, t, f = false) => cond ? t : f\r\n\r\n});","export const externalFunctions = {};\r\n\r\n// Add user-defined function\r\nexport function addFunction(name, fn) {\r\n\r\n  if (typeof name !== \"string\" || name.trim() === \"\") {\r\n    throw new Error(\"Function name must be a non-empty string\");\r\n  }\r\n\r\n  if (typeof fn !== \"function\") {\r\n    throw new Error(\"Function must be a valid function\");\r\n  }\r\n\r\n  if (name in externalFunctions) {\r\n    throw new Error(`Function '${name}' already exists`);\r\n  }\r\n\r\n  externalFunctions[name] = fn;\r\n}\r\n","export const variablesDB = {};\r\n\r\n// Valid JS variable name (full check)\r\nconst validVarName = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/;\r\n\r\nexport function setVariable(name, value, { override = true } = {}) {\r\n\r\n  // Name validation\r\n  if (typeof name !== \"string\" || name.trim() === \"\") {\r\n    throw new Error(\"Variable Name Error: Name must be a non-empty string\");\r\n  }\r\n\r\n  if (!validVarName.test(name)) {\r\n    throw new Error(`Variable Name Error: '${name}' is not a valid variable name`);\r\n  }\r\n\r\n  // Value validation\r\n  if (value === undefined) {\r\n    throw new Error(`Variable Value Error: '${name}' cannot be undefined`);\r\n  }\r\n\r\n  // Prevent overwrite (optional)\r\n  if (!override && name in variablesDB) {\r\n    throw new Error(`Variable '${name}' already exists`);\r\n  }\r\n\r\n  variablesDB[name] = value;\r\n}","export function stringToJS(str, variablesDB) {\r\n    if (typeof str !== \"string\" || str.length === 0) {\r\n        throw new Error(\"Invalid input: expected a non-empty string.\");\r\n    }\r\n\r\n    const firstChar = str[0];\r\n    const lastChar = str[str.length - 1];\r\n\r\n    // HEX (0x...)\r\n    if (/^0x[0-9a-fA-F]+n?$/.test(str)) {\r\n\r\n        // BigInt hex (0xFFn)\r\n        if (lastChar === 'n') {\r\n            return BigInt(str.slice(0, -1));\r\n        }\r\n\r\n        return Number(str);\r\n    }\r\n\r\n    if (/^[+-]?(\\d+(\\.\\d+)?|\\.\\d+)(e[+-]?\\d+)?n?$/i.test(str)) {\r\n\r\n        // BigInt\r\n        if (lastChar === 'n') {\r\n            const numPart = str.slice(0, -1);\r\n\r\n            if (numPart.includes('.') || /e/i.test(numPart)) {\r\n                throw new Error(`Invalid BigInt: ${str}`);\r\n            }\r\n\r\n            return BigInt(numPart);\r\n        }\r\n\r\n        return Number(str);\r\n    }\r\n\r\n    if (\r\n        (firstChar === '\"' && lastChar === '\"') ||\r\n        (firstChar === \"'\" && lastChar === \"'\") ||\r\n        (firstChar === '`' && lastChar === '`')\r\n    ) {\r\n        return str.slice(1, -1);\r\n    }\r\n\r\n    if (\r\n        firstChar === '\"' ||\r\n        firstChar === \"'\" ||\r\n        firstChar === '`'\r\n    ) {\r\n        throw new Error(`Unmatched or missing quotes: ${str}`);\r\n    }\r\n\r\n    if (str === \"true\") return true;\r\n    if (str === \"false\") return false;\r\n\r\n    if (str in variablesDB) {\r\n        return variablesDB[str];\r\n    }\r\n\r\n    throw new Error(\r\n        `${str} is not defined. Use setVariable(\"${str}\", value) first.`\r\n    );\r\n}\r\nexport default stringToJS;","import { tokenize } from \"../parser/tokenizer.js\";\r\nimport { infixToPostfix } from \"../parser/infixToPostfix.js\";\r\nimport { evaluatePostfix } from \"../parser/evaluator.js\";\r\n\r\nimport { mathOperations } from \"../math/operations.js\";\r\n\r\nimport { internalFunctions } from \"../functions/internalFunctions.js\";\r\nimport { externalFunctions } from \"../functions/externalFunctions.js\";\r\n\r\nimport { variablesDB } from \"../variables/variables.js\";\r\n\r\nimport { stringToJS } from \"../utils/typeConverter.js\";\r\n\r\nclass ViewPoint {\r\n\r\n    constructor() {\r\n        // Shared state\r\n        this.variablesDB = variablesDB;\r\n        this.func_DB_intrnl = internalFunctions;\r\n        this.func_DB_extrnl = externalFunctions;\r\n\r\n        this.operator_precedence = mathOperations.operator_precedence;\r\n    }\r\n\r\n    setVariable(name, value) {\r\n        this.variablesDB[name] = value;\r\n    }\r\n\r\n    addFunction(name, fn) {\r\n        this.func_DB_extrnl[name] = fn;\r\n    }\r\n\r\n    stringToJS(str) {\r\n        return stringToJS.call(this, str, this.variablesDB);\r\n    }\r\n\r\n    evaluate(expr) {\r\n\r\n        if (typeof expr !== \"string\") {\r\n            throw new Error(\"Expression must be a string\");\r\n        }\r\n\r\n        const context = {\r\n            variablesDB: this.variablesDB,\r\n            func_DB_intrnl: this.func_DB_intrnl,\r\n            func_DB_extrnl: this.func_DB_extrnl,\r\n            stringToJS: this.stringToJS.bind(this),\r\n            evaluate: this.evaluate.bind(this)\r\n        };\r\n\r\n        // Step 1: Tokenize\r\n        const tokens = tokenize(expr, context);\r\n\r\n        // Step 2: Infix → Postfix\r\n        const postfix = infixToPostfix(\r\n            tokens,\r\n            this.operator_precedence\r\n        );\r\n\r\n        // Step 3: Evaluate Postfix\r\n        const result = evaluatePostfix(\r\n            postfix,\r\n            mathOperations\r\n        );\r\n\r\n        return result;\r\n    }\r\n}\r\n\r\nexport default ViewPoint;","export function tokenize(expr, context) {\r\n    let tokens = [];\r\n    let current = \"\";\r\n    let quote = \"\";\r\n\r\n    for (let i = 0; i < expr.length; i++) {\r\n\r\n        let char = expr[i];\r\n\r\n        const isOperator =\r\n            char === '(' || char === ')' ||\r\n            char === '^' || char === '*' ||\r\n            char === '/' || char === '%' ||\r\n            char === '+' || char === '-';\r\n\r\n        const isQuote = char === '\"' || char === \"'\" || char === \"`\";\r\n\r\n        if (isQuote) {\r\n            if (quote === \"\") {\r\n                quote = char;\r\n                current += char;\r\n            } else if (quote === char) {\r\n                current += char;\r\n                quote = \"\";\r\n\r\n                tokens.push(context.stringToJS(current, context.variablesDB));\r\n                current = \"\";\r\n            } else {\r\n                current += char;\r\n            }\r\n            continue;\r\n        }\r\n\r\n        if (quote !== \"\") {\r\n            current += char;\r\n            continue;\r\n        }\r\n\r\n        if (char === \"#\") {\r\n\r\n            let bracket = 0;\r\n            let funcName = \"\";\r\n            let arg = \"\";\r\n            let args = [];\r\n            let quoteFunc = \"\";\r\n\r\n            while (i < expr.length - 1) {\r\n                i++;\r\n                char = expr[i];\r\n\r\n                if (bracket === 0) {\r\n                    if (char === \"(\") {\r\n                        bracket++;\r\n                        continue;\r\n                    }\r\n\r\n                    if (char === \" \")\r\n                        throw new Error(\"Function name cannot contain space\");\r\n\r\n                    if (isQuote)\r\n                        throw new Error(\"Function name cannot contain quotes\");\r\n\r\n                    if (funcName === \"\" && /[0-9.]/.test(char))\r\n                        throw new Error(\"Function name cannot start with number\");\r\n\r\n                    funcName += char;\r\n                    continue;\r\n                }\r\n\r\n                if (isQuote) {\r\n                    if (quoteFunc === \"\") quoteFunc = char;\r\n                    else if (quoteFunc === char) quoteFunc = \"\";\r\n                }\r\n\r\n                if (quoteFunc === \"\") {\r\n\r\n                    if (char === \"(\") bracket++;\r\n                    else if (char === \")\") {\r\n                        bracket--;\r\n\r\n                        if (bracket === 0) {\r\n                            if (arg !== \"\") args.push(arg);\r\n                            break;\r\n                        }\r\n                    }\r\n\r\n                    if (char === \",\" && bracket === 1) {\r\n                        if (arg === \"\")\r\n                            throw new Error(`Missing argument in #${funcName}()`);\r\n\r\n                        args.push(arg);\r\n                        arg = \"\";\r\n                        continue;\r\n                    }\r\n                }\r\n\r\n                arg += char;\r\n            }\r\n\r\n            args = args.map(a => context.evaluate(a));\r\n\r\n            let fn =\r\n                context.func_DB_intrnl[funcName] ||\r\n                context.func_DB_extrnl[funcName];\r\n\r\n            if (!fn) {\r\n                throw new Error(`#${funcName}() not defined`);\r\n            }\r\n\r\n            tokens.push(fn(...args));\r\n            continue;\r\n        }\r\n\r\n        if (isOperator) {\r\n\r\n            if (current !== \"\") {\r\n                tokens.push(context.stringToJS(current, context.variablesDB));\r\n                current = \"\";\r\n            }\r\n\r\n            tokens.push(char);\r\n            continue;\r\n        }\r\n\r\n        if (char === \" \") {\r\n            if (current !== \"\") {\r\n                tokens.push(context.stringToJS(current, context.variablesDB));\r\n                current = \"\";\r\n            }\r\n            continue;\r\n        }\r\n\r\n        current += char;\r\n\r\n        if (i === expr.length - 1 && current !== \"\") {\r\n            tokens.push(context.stringToJS(current, context.variablesDB));\r\n        }\r\n    }\r\n\r\n    if (quote !== \"\") {\r\n        throw new Error(\"Unclosed string literal\");\r\n    }\r\n\r\n    return tokens;\r\n}","export function infixToPostfix(tokens, operator_precedence) {\r\n    let output = [];\r\n    let stack = [];\r\n\r\n    for (let i = 0; i < tokens.length; i++) {\r\n\r\n        let token = tokens[i];\r\n\r\n        const isOperator =\r\n            token === '^' || token === '*' ||\r\n            token === '/' || token === '%' ||\r\n            token === '+' || token === '-';\r\n\r\n        const isLeftParen = token === \"(\";\r\n        const isRightParen = token === \")\";\r\n\r\n        const isOperand = !isOperator && !isLeftParen && !isRightParen;\r\n\r\n        if (isOperand) {\r\n            output.push(token);\r\n        }\r\n\r\n        else if (isOperator) {\r\n\r\n            while (stack.length > 0) {\r\n\r\n                let top = stack[stack.length - 1];\r\n\r\n                if (top === \"(\") break;\r\n\r\n                let topPrec = operator_precedence[top] || 0;\r\n                let currPrec = operator_precedence[token];\r\n\r\n                // Right associativity for ^\r\n                if (\r\n                    (token === '^' && currPrec < topPrec) ||\r\n                    (token !== '^' && currPrec <= topPrec)\r\n                ) {\r\n                    output.push(stack.pop());\r\n                } else {\r\n                    break;\r\n                }\r\n            }\r\n\r\n            stack.push(token);\r\n        }\r\n\r\n        else if (isLeftParen) {\r\n            stack.push(token);\r\n        }\r\n\r\n        else if (isRightParen) {\r\n\r\n            while (stack.length > 0 && stack[stack.length - 1] !== \"(\") {\r\n                output.push(stack.pop());\r\n            }\r\n\r\n            if (stack.length === 0) {\r\n                throw new Error(\"Mismatched parentheses: missing '('\");\r\n            }\r\n\r\n            stack.pop();\r\n        }\r\n    }\r\n\r\n    while (stack.length > 0) {\r\n\r\n        let top = stack.pop();\r\n\r\n        if (top === \"(\" || top === \")\") {\r\n            throw new Error(\"Mismatched parentheses\");\r\n        }\r\n\r\n        output.push(top);\r\n    }\r\n\r\n    return output;\r\n}","export function evaluatePostfix(postfix, mathOperations) {\r\n\r\n    let stack = [];\r\n\r\n    const isOperator = (val) =>\r\n        val === '^' || val === '*' ||\r\n        val === '/' || val === '%' ||\r\n        val === '+' || val === '-';\r\n\r\n    for (let i = 0; i < postfix.length; i++) {\r\n\r\n        let token = postfix[i];\r\n\r\n        if (!isOperator(token)) {\r\n            stack.push(token);\r\n            continue;\r\n        }\r\n\r\n        if (stack.length < 2) {\r\n            throw new Error(\"Invalid expression: insufficient operands\");\r\n        }\r\n\r\n        let b = stack.pop(); // second\r\n        let a = stack.pop(); // first\r\n\r\n        let result;\r\n\r\n        switch (token) {\r\n            case '^':\r\n                result = mathOperations.power(a, b);\r\n                break;\r\n            case '*':\r\n                result = mathOperations.multiply(a, b);\r\n                break;\r\n            case '/':\r\n                result = mathOperations.divide(a, b);\r\n                break;\r\n            case '%':\r\n                result = mathOperations.modulus(a, b);\r\n                break;\r\n            case '+':\r\n                result = mathOperations.add(a, b);\r\n                break;\r\n            case '-':\r\n                result = mathOperations.subtract(a, b);\r\n                break;\r\n        }\r\n\r\n        stack.push(result);\r\n    }\r\n\r\n    if (stack.length !== 1) {\r\n        throw new Error(\"Invalid expression: leftover values in stack\");\r\n    }\r\n\r\n    return stack[0];\r\n}"],"names":["isValidNumberPair","a","b","mathOperations","Object","freeze","operator_precedence","power","Error","multiply","divide","add","subtract","modulus","and","args","every","Boolean","or","some","not","val","gt","lt","eq","gte","lte","internalFunctions","max","v","Math","min","greaterThan","lessThan","isEqual","greaterThanOrEqual","lessThanOrEqual","if","cond","t","f","externalFunctions","variablesDB","stringToJS","str","length","firstChar","lastChar","test","BigInt","slice","Number","numPart","includes","constructor","this","func_DB_intrnl","func_DB_extrnl","setVariable","name","value","addFunction","fn","call","evaluate","expr","tokens","context","current","quote","i","char","isOperator","isQuote","push","bracket","funcName","arg","quoteFunc","map","tokenize","bind","postfix","output","stack","token","isLeftParen","isRightParen","top","topPrec","currPrec","pop","infixToPostfix","result","evaluatePostfix"],"mappings":"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"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "exprify",
+  "version": "1.0.0",
+  "description": "A powerful math expression parser and evaluator with runtime data-type checking",
+  "type": "module",
+  "main": "dist/exprify.cjs.js",
+  "module": "dist/exprify.esm.js",
+  "browser": "dist/exprify.js",
+  "unpkg": "dist/exprify.min.js",
+  "scripts": {
+    "start": "node src/index.js",
+    "clean": "rimraf dist",
+    "build": "npm run clean && rollup -c",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+    "dev": "nodemon src/index.js"
+  },
+  "jest": {
+    "testMatch": [
+      "**/test/**/*.js"
+    ]
+  },
+  "keywords": [
+    "math",
+    "parser",
+    "expression",
+    "evaluator",
+    "calculator",
+    "javascript"
+  ],
+  "author": "Nirmal Paul",
+  "license": "GPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/code-hemu/Exprify.git"
+  },
+  "bugs": {
+    "url": "https://github.com/code-hemu/Exprify/issues"
+  },
+  "homepage": "https://github.com/code-hemu/Exprify#readme",
+  "devDependencies": {
+    "@babel/cli": "^7.24.0",
+    "@babel/core": "^7.24.0",
+    "@babel/preset-env": "^7.24.0",
+    "@rollup/plugin-commonjs": "^23.0.0",
+    "@rollup/plugin-node-resolve": "^15.0.0",
+    "jest": "^29.0.0",
+    "nodemon": "^3.0.0",
+    "rimraf": "^6.1.3",
+    "rollup": "^2.0.0",
+    "rollup-plugin-strip-banner": "^3.1.0",
+    "rollup-plugin-terser": "^7.0.2"
+  }
+}

package/src/core/Exprify.js

@@ -0,0 +1,70 @@
+import { tokenize } from "../parser/tokenizer.js";
+import { infixToPostfix } from "../parser/infixToPostfix.js";
+import { evaluatePostfix } from "../parser/evaluator.js";
+
+import { mathOperations } from "../math/operations.js";
+
+import { internalFunctions } from "../functions/internalFunctions.js";
+import { externalFunctions } from "../functions/externalFunctions.js";
+
+import { variablesDB } from "../variables/variables.js";
+
+import { stringToJS } from "../utils/typeConverter.js";
+
+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;
+    }
+}
+
+export default ViewPoint;

package/src/functions/externalFunctions.js

@@ -0,0 +1,19 @@
+export const externalFunctions = {};
+
+// Add user-defined function
+export function addFunction(name, fn) {
+
+  if (typeof name !== "string" || name.trim() === "") {
+    throw new Error("Function name must be a non-empty string");
+  }
+
+  if (typeof fn !== "function") {
+    throw new Error("Function must be a valid function");
+  }
+
+  if (name in externalFunctions) {
+    throw new Error(`Function '${name}' already exists`);
+  }
+
+  externalFunctions[name] = fn;
+}

package/src/functions/internalFunctions.js

@@ -0,0 +1,53 @@
+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;
+
+export 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
+
+});

package/src/index.js

@@ -0,0 +1,38 @@
+/**
+ * Exprify — Math Expression Parser & Evaluator
+ *
+ * A lightweight JavaScript library for parsing and evaluating mathematical expressions
+ * with runtime data-type checking.
+ *
+ * Author: Nirmal Paul (N Paul)
+ * GitHub: https://github.com/nirmalpaul383
+ *
+ * License: GNU General Public License v3.0 (GPLv3)
+ *
+ * Note:
+ * This project is licensed under GPLv3. While not legally required,
+ * attribution is highly appreciated. If you use, modify, or distribute
+ * this project, please give credit to the original author.
+ *
+ * This library has been carefully designed with clean, structured, and
+ * maintainable code. Acknowledgment of the original work is encouraged.
+ *
+ * Resources:
+ * GitHub Repository: https://github.com/nirmalpaul383/ViewPoint
+ * YouTube Channel:   https://www.youtube.com/channel/UCY6JY8bTlR7hZEvhy6Pldxg/
+ * Facebook Page:    https://www.facebook.com/a.New.Way.Technical/
+ */
+
+import Exprify from "./core/Exprify.js";
+import { mathOperations } from "./math/operations.js";
+import { internalFunctions } from "./functions/internalFunctions.js";
+import { externalFunctions } from "./functions/externalFunctions.js";
+import { variablesDB } from "./variables/variables.js";
+
+export {
+  Exprify,
+  mathOperations,
+  internalFunctions,
+  externalFunctions,
+  variablesDB
+};

package/src/math/operations.js

@@ -0,0 +1,48 @@
+const isValidNumberPair = (a, b) =>
+  (typeof a === typeof b) &&
+  (typeof a === 'number' || typeof a === 'bigint');
+
+export 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 %");
+  }
+});

package/src/parser/evaluator.js

@@ -0,0 +1,57 @@
+export 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];
+}

package/src/parser/infixToPostfix.js

@@ -0,0 +1,78 @@
+export 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;
+}

package/src/parser/tokenizer.js

@@ -0,0 +1,145 @@
+export 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;
+}