Modernize foresta-js library with NPM build process, latest esprima, comprehensive tests, and CI/CD (#2)

Author: Copilot

.github/workflows/ci.yml

@@ -0,0 +1,43 @@
+name: CI
+
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    
+    strategy:
+      matrix:
+        node-version: [14.x, 16.x, 18.x, 20.x]
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'npm'
+        
+    - name: Install dependencies
+      run: npm ci
+      
+    - name: Run tests
+      run: npm test
+      
+    - name: Run tests with coverage
+      run: npm run test:coverage
+      
+    - name: Upload coverage to Codecov
+      if: matrix.node-version == '20.x'
+      uses: codecov/codecov-action@v3
+      with:
+        file: ./coverage/lcov.info
+        flags: unittests
+        name: codecov-umbrella
+        fail_ci_if_error: false

.gitignore

@@ -0,0 +1,46 @@
+# Dependencies
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Build outputs
+dist/
+build/
+*.tgz
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage directory used by tools like istanbul
+coverage/
+.nyc_output
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+# Test artifacts
+test-results/

examples/basic.js

@@ -0,0 +1,64 @@
+const foresta = require('../dist/foresta');
+const esprima = require('esprima');
+
+// Example code to analyze
+const code = `
+var theValue = 4 + 2;
+var config = {
+  update: function() {
+    var s = "hello";
+    return s;
+  },
+  data: [1, 2, 3]
+};
+`;
+
+console.log('=== Foresta.js Examples ===\n');
+
+// Parse the code with esprima
+const ast = esprima.parseScript(code);
+
+// Example 1: Find all literal values
+console.log('1. All literal values:');
+const literalQuery = new foresta("Literal");
+literalQuery.visit(ast);
+literalQuery.results.forEach((result, i) => {
+  console.log(`   ${i + 1}. ${JSON.stringify(result.value)} (${typeof result.value})`);
+});
+
+// Example 2: Find specific variable by name
+console.log('\n2. Variable named "theValue":');
+const identifierQuery = new foresta("#theValue");
+identifierQuery.visit(ast);
+if (identifierQuery.results.length > 0) {
+  const result = identifierQuery.results[0];
+  console.log(`   Found: ${result.name}`);
+  console.log(`   Initialization: ${result.parent.init.type} (${result.parent.init.operator})`);
+}
+
+// Example 3: Find all global variables
+console.log('\n3. All global variable declarations:');
+const globalVarsQuery = new foresta("Program VariableDeclaration VariableDeclarator");
+globalVarsQuery.visit(ast);
+globalVarsQuery.results.forEach((result, i) => {
+  console.log(`   ${i + 1}. ${result.id.name}`);
+});
+
+// Example 4: Use property modifiers to find function expression
+console.log('\n4. Function expression using property modifier:');
+const functionQuery = new foresta("ObjectExpression Property #update:parent:value");
+functionQuery.visit(ast);
+if (functionQuery.results.length > 0) {
+  const result = functionQuery.results[0];
+  console.log(`   Found: ${result.type} with ${result.params.length} parameters`);
+}
+
+// Example 5: Find all binary expressions
+console.log('\n5. All binary expressions:');
+const binaryQuery = new foresta("BinaryExpression");
+binaryQuery.visit(ast);
+binaryQuery.results.forEach((result, i) => {
+  console.log(`   ${i + 1}. ${result.left.value || result.left.name} ${result.operator} ${result.right.value || result.right.name}`);
+});
+
+console.log('\n=== End Examples ===');

jest.config.json

@@ -0,0 +1,17 @@
+{
+  "testEnvironment": "node",
+  "testMatch": [
+    "**/test/**/*.test.js",
+    "**/test/**/*.spec.js"
+  ],
+  "collectCoverageFrom": [
+    "src/**/*.js",
+    "!src/**/*.test.js"
+  ],
+  "coverageDirectory": "coverage",
+  "coverageReporters": [
+    "text",
+    "lcov",
+    "html"
+  ]
+}