🎯 Phase 3: Automated Testing Framework & Modern Development Infrastructure

.eslintrc.cjs

@@ -0,0 +1,169 @@
+/**
+ * ESLint Configuration for Parsec Equations Library
+ *
+ * Provides comprehensive linting rules for JavaScript/ES6+ code
+ * with Prettier integration for formatting and specific considerations
+ * for WebAssembly integration and cross-platform library development.
+ */
+
+module.exports = {
+  // Environment configuration
+  env: {
+    browser: true,
+    node: true,
+    es2022: true,
+    worker: true,
+  },
+
+  // Parser configuration for modern JavaScript
+  parserOptions: {
+    ecmaVersion: 2022,
+    sourceType: 'module',
+    allowImportExportEverywhere: true,
+  },
+
+  // Base configurations
+  extends: ['eslint:recommended', 'prettier'],
+
+  // Plugin configuration
+  plugins: ['prettier'],
+
+  // Global variables
+  globals: {
+    // Vitest globals
+    describe: 'readonly',
+    it: 'readonly',
+    test: 'readonly',
+    expect: 'readonly',
+    beforeAll: 'readonly',
+    beforeEach: 'readonly',
+    afterAll: 'readonly',
+    afterEach: 'readonly',
+    vi: 'readonly',
+
+    // WebAssembly globals
+    WebAssembly: 'readonly',
+
+    // AMD module globals
+    define: 'readonly',
+
+    // Test environment globals
+    __TEST_ENV__: 'readonly',
+    __VERSION__: 'readonly',
+  },
+
+  // Custom rules
+  rules: {
+    // Prettier integration
+    'prettier/prettier': 'error',
+
+    // Variables
+    'no-unused-vars': [
+      'error',
+      {
+        argsIgnorePattern: '^_',
+        varsIgnorePattern: '^_',
+        ignoreRestSiblings: true,
+      },
+    ],
+    'no-var': 'error',
+    'prefer-const': 'error',
+
+    // Functions
+    'no-unused-expressions': 'error',
+    'prefer-arrow-callback': 'error',
+
+    // Best practices
+    eqeqeq: ['error', 'always'],
+    'no-eval': 'error',
+    'no-implied-eval': 'error',
+    'no-new-func': 'error',
+    'no-console': 'off', // Allow console for WebAssembly debugging
+    'no-debugger': 'error',
+    'no-alert': 'error',
+
+    // ES6+ features
+    'prefer-template': 'error',
+    'prefer-destructuring': [
+      'error',
+      {
+        array: false,
+        object: true,
+      },
+    ],
+
+    // Error handling
+    'no-throw-literal': 'error',
+    'prefer-promise-reject-errors': 'error',
+
+    // Code complexity
+    complexity: ['warn', 15],
+    'max-depth': ['warn', 4],
+
+    // Async/await
+    'require-await': 'error',
+    'no-return-await': 'error',
+
+    // Classes
+    'class-methods-use-this': 'off', // Allow methods that don't use 'this'
+    'no-useless-constructor': 'error',
+
+    // Imports/exports
+    'no-duplicate-imports': 'error',
+
+    // WebAssembly specific
+    'no-new-wrappers': 'error',
+    'no-prototype-builtins': 'error',
+  },
+
+  // Override rules for specific file patterns
+  overrides: [
+    // Test files
+    {
+      files: ['tests/**/*.js', '**/*.test.js', '**/*.spec.js'],
+      rules: {
+        'no-magic-numbers': 'off', // Allow magic numbers in tests
+        'prefer-arrow-callback': 'off', // Allow function expressions in tests
+      },
+    },
+
+    // Configuration files
+    {
+      files: ['*.config.js', '.eslintrc.js', 'vitest.config.js'],
+      rules: {
+        'no-console': 'off',
+      },
+    },
+
+    // WebAssembly wrapper files
+    {
+      files: ['js/**/*.js'],
+      rules: {
+        'no-console': 'off', // Allow console for WASM debugging
+        complexity: ['warn', 20], // Allow higher complexity for WASM integration
+      },
+    },
+
+    // Entry point files
+    {
+      files: ['index.js', 'index.mjs'],
+      rules: {
+        complexity: ['warn', 20], // Allow higher complexity for compatibility layers
+      },
+    },
+  ],
+
+  // Ignore patterns
+  ignorePatterns: [
+    'node_modules/',
+    'coverage/',
+    'dist/',
+    'equations-parser/', // Git submodule - don't lint
+    'wasm/*.js', // Generated Emscripten files
+    '*.wasm',
+    'html/',
+    'docs/',
+    '*.min.js',
+    'emsdk/', // Emscripten SDK - don't lint
+  ],
+}

.github/workflows/tests.yml

@@ -0,0 +1,51 @@
+name: CI - Tests
+
+on:
+  push:
+    branches:
+      - '**'
+  pull_request:
+    branches:
+      - '**'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: Node ${{ matrix.node }} on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest]
+        node: [18.x, 20.x]
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js ${{ matrix.node }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test -- --run
+
+      # Optional: upload coverage if your `npm test` generates it
+      # - name: Upload coverage report
+      #   if: always()
+      #   uses: actions/upload-artifact@v4
+      #   with:
+      #     name: coverage-${{ matrix.os }}-node${{ matrix.node }}
+      #     path: coverage

.prettierignore

@@ -0,0 +1,40 @@
+# Dependencies
+node_modules/
+
+# Submodules
+equations-parser/
+
+# Emscripten SDK
+emsdk/
+
+# Build outputs
+dist/
+coverage/
+
+# Generated WebAssembly files
+wasm/*.js
+*.wasm
+
+# HTML test files (legacy)
+html/
+tests/*.html
+
+# Documentation
+docs/
+
+# Minified files
+*.min.js
+
+# Logs
+*.log
+npm-debug.log*
+
+# Test results
+test-results*.json
+
+# GitHub files
+.github/
+
+# OS files
+.DS_Store
+Thumbs.db

.prettierrc

@@ -0,0 +1,9 @@
+{
+  "semi": false,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "printWidth": 100,
+  "bracketSpacing": true,
+  "arrowParens": "avoid"
+}