exprify 1.0.1 → 1.0.2

package/docs/README.md

@@ -0,0 +1,34 @@
+---
+layout: default
+title: Exprify Docs
+---
+
+# Exprify Docs
+
+Exprify is a JavaScript expression parser and evaluator for math-heavy apps.
+
+## Highlights
+
+- arithmetic, precedence, bigint, and booleans
+- variables, assignments, and inline functions
+- unit conversion
+- matrices and linear algebra helpers
+- complex numbers
+- symbolic helpers like `simplify`, `derivative`, and `rationalize`
+
+## Quick Example
+
+```js
+import Exprify from "exprify";
+
+const expr = new Exprify();
+
+expr.evaluate("hyp(a, b) = sqrt(a ^ 2 + b ^ 2)");
+console.log(expr.evaluate("hyp(3, 4)"));
+// 5
+```
+
+## References
+
+- [Project README](../README.md)
+- [Token Type Notes](./tokenType.txt)

package/docs/assets/css/style.scss

@@ -0,0 +1,4 @@
+---
+---
+
+@import "jekyll-theme-primer";

package/docs/tokenType.txt

@@ -0,0 +1,21 @@
+Token notes for Exprify
+
+- Number
+- BigInt
+- Boolean
+- String
+- Identifier
+- Function
+- Operator
+- UnaryOperator
+- Keyword
+- Unit
+- NumberWithUnit
+- ImaginaryLiteral
+- Parenthesis
+- ArrayStart / ArrayEnd
+- BlockStart / BlockEnd
+- Comma
+- Semicolon
+- Colon
+- Dot

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "exprify",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "A powerful math expression parser and evaluator with runtime data-type checking",
   "type": "module",
   "main": "dist/exprify.cjs.js",

package/.gitattributes

@@ -1,2 +0,0 @@
-# Auto detect text files and perform LF normalization
-* text=auto

package/.github/workflows/ci.yml

@@ -1,40 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches:
-      - main
-      - master
-  pull_request:
-    branches:
-      - main
-      - master
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-
-    strategy:
-      matrix:
-        node-version:
-          - 20
-          - 22
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-          cache: npm
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Build package
-        run: npm run build
-
-      - name: Run tests
-        run: npm test

package/.github/workflows/npm-publish.yml

@@ -1,38 +0,0 @@
-name: Publish Package
-
-on:
-  release:
-    types:
-      - published
-  workflow_dispatch:
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          registry-url: https://registry.npmjs.org/
-          cache: npm
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Build package
-        run: npm run build
-
-      - name: Run tests
-        run: npm test
-
-      - name: Publish to npm
-        run: npm publish
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.github/workflows/security-audit.yml

@@ -1,34 +0,0 @@
-name: Security Audit
-
-on:
-  push:
-    branches:
-      - main
-      - master
-  pull_request:
-    branches:
-      - main
-      - master
-  schedule:
-    - cron: "0 6 * * 1"
-  workflow_dispatch:
-
-jobs:
-  audit:
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22
-          cache: npm
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Run npm audit
-        run: npm audit --audit-level=high

package/CHANGELOG.md

@@ -1,11 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on Keep a Changelog, and this project follows semantic versioning.
-
-## [1.0.1] - 2026-04-05
-
-### Fixed
-- Corrected the import path in `src/index.js` to match the actual filename casing of `src/core/Exprify.js`.
-- Resolved a cross-platform build issue where Rollup failed on Linux-based CI environments because of case-sensitive path resolution.

package/doc/tokenType.txt

@@ -1,48 +0,0 @@
-ALL TOKEN TYPES (FINAL DESIGN)
-
-// LITERALS
-{ type: "Number", value: 10 }
-{ type: "BigInt", value: 10n }
-{ type: "Boolean", value: true }
-{ type: "String", value: "hello" }
-
-{ type: "Unit", value: "cm" }
-{ type: "NumberWithUnit", value: 12.7, unit: "cm" }
-{ type: "UnknownUnit", value: 5, unit: "abc" }
-
-// IDENTIFIERS
-{ type: "Identifier", value: "x" }
-
-// FUNCTIONS
-{ type: "Function", value: "max" }
-
-// OPERATORS
-{ type: "Operator", value: "+" }
-{ type: "Operator", value: ">=" }
-{ type: "Operator", value: "&&" }
-{ type: "Operator", value: "|>" }
-
-// UNARY
-{ type: "UnaryOperator", value: "-" }
-{ type: "UnaryOperator", value: "!" }
-
-// LOGIC / TERNARY
-{ type: "Ternary", value: "?" }
-{ type: "Ternary", value: ":" }
-
-// STRUCTURE
-{ type: "Parenthesis", value: "(" }
-{ type: "Parenthesis", value: ")" }
-{ type: "ArrayStart" }
-{ type: "ArrayEnd" }
-{ type: "BlockStart" }
-{ type: "BlockEnd" }
-{ type: "Colon" }
-{ type: "Comma" }
-{ type: "Dot" }
-
-// KEYWORDS
-{ type: "Keyword", value: "to" }
-{ type: "Keyword", value: "if" }
-
-

package/rollup.config.js

@@ -1,80 +0,0 @@
-import fs from "fs";
-import path from "path";
-
-import resolve from "@rollup/plugin-node-resolve";
-import commonjs from "@rollup/plugin-commonjs";
-
-import terser from "@rollup/plugin-terser";
-import pkg from "./package.json";
-
-const short_banner = `/*! ${pkg.name} v${pkg.version} | * (c) ${new Date().getFullYear()} ${pkg.author} and contributors | ${pkg.license} License*/`;
-
-const banner = `/*!
-* ${pkg.name} v${pkg.version}
-* (c) ${new Date().getFullYear()} ${pkg.author} and other contributors
-*
-* Released under the ${pkg.license} License
-* Date: ${new Date().toISOString().split('T')[0]}
-*/`;
-
-function removeComment() {
-  return {
-    name: "remove-sourcemap-comment",
-    writeBundle(outputOptions, bundle) {
-      for (const fileName in bundle) {
-        if (fileName.endsWith(".js")) {
-          const filePath = path.join(
-            outputOptions.dir || path.dirname(outputOptions.file),
-            fileName
-          );
-
-          let code = fs.readFileSync(filePath, "utf-8");
-
-          code = code.replace(/\/\/# sourceMappingURL=.*$/gm, "");
-
-          fs.writeFileSync(filePath, code);
-        }
-      }
-    }
-  };
-}
-
-export default [
-  {
-    input: "src/index.js",
-    output: [
-      {
-        file: "dist/exprify.esm.js",
-        format: "esm",
-        sourcemap: true
-      },
-      {
-        file: "dist/exprify.cjs.js",
-        format: "cjs",
-        sourcemap: true,
-        exports: "default"
-      },
-      {
-        file: "dist/exprify.js",
-        format: "umd",
-        name: "Exprify",
-        banner: banner,
-        sourcemap: true,
-        indent: true,
-        exports: "default"
-      }
-    ],
-    plugins: [resolve(), commonjs(), removeComment()]
-  },
-  {
-    input: "src/index.js",
-    output: {
-      file: "dist/exprify.min.js",
-      format: "umd",
-      name: "Exprify",
-      sourcemap: true,
-      banner: short_banner
-    },
-    plugins: [resolve(), commonjs(), terser(), removeComment()]
-  }
-];

package/src/core/Exprify.js

@@ -1,140 +0,0 @@
-import { tokenize } from "../parser/tokenizer.js";
-// import { infixToPostfix } from "../parser/infixToPostfix.js";
-import { evaluateAST } from "../parser/evaluator.js";
-import { createContext } from "./context.js";
-import { mathOperations } from "../math/operations.js";
-
-import { createUnitsStore } from "../utils/store.js";
-import { globalUnits } from "../utils/globalUnits.js";
-
-import { createVarStore } from "../variables/store.js";
-import { createFunctionRegistry } from "../function/registry.js";
-import { internalFunctions } from "../function/internal.js";
-
-import { buildAST } from "../parser/astBuild.js";
-
-
-//
-
-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();
-    }
-
-}
-
-export default exprify;

package/src/core/context.js

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

package/src/function/executor.js

@@ -1,64 +0,0 @@
-export function createFunctionExecutor(fnRegistry, options = {}) {
-  if (!fnRegistry) {
-    throw new Error("Function registry is required");
-  }
-
-  const config = {
-    strict: options.strict ?? true
-  };
-
-  /* ================= EXECUTE ================= */
-
-  function execute(name, args = [], context) {
-    const fn = fnRegistry.get(name);
-
-    /* ----- NOT FOUND ----- */
-    if (!fn) {
-      if (config.strict) {
-        throw new Error(`Unknown function: ${name}`);
-      }
-      return undefined;
-    }
-
-    /* ----- VALIDATE ARGS ----- */
-    if (!Array.isArray(args)) {
-      throw new Error(`Arguments for "${name}" must be an array`);
-    }
-
-    /* ----- EXECUTE ----- */
-    try {
-      return fn(...args);
-    } catch (err) {
-      throw new Error(
-        `Error in function "${name}": ${err.message}`
-      );
-    }
-  }
-
-  /* ================= SAFE EXECUTE ================= */
-
-  function safeExecute(name, args = [], context) {
-    try {
-      return execute(name, args, context);
-    } catch (err) {
-      return {
-        error: true,
-        message: err.message
-      };
-    }
-  }
-
-  /* ================= EXISTS ================= */
-
-  function exists(name) {
-    return fnRegistry.has(name);
-  }
-
-  /* ================= API ================= */
-
-  return {
-    execute,
-    safeExecute,
-    exists
-  };
-}