Modernize parser to PHP 8.1+ with phpstan/phpdoc-parser

Complete rewrite of the parser architecture from legacy phpdocumentor/reflection
to modern PHP libraries while maintaining 100% backward compatibility.

## Major Changes

### Core Dependencies
- PHP requirement: 5.4+ → 8.1+
- Replace phpdocumentor/reflection v3.0 with phpstan/phpdoc-parser v2.0
- Add nikic/php-parser v5.0 for AST-based parsing
- Update PHPUnit: v7 → v9 for WordPress compatibility

### Parser Architecture
- Rewrite File_Reflector to use PHPParser NodeVisitorAbstract
- Implement modern AST traversal for improved accuracy
- Add advanced PHPDoc parsing with type support
- Maintain backward compatibility through runner.php bridge

### Features Added
- Namespace detection and tracking
- Property docblock parsing with visibility
- File-level docblock detection
- Advanced tag parsing (@param, @return with types)
- Class name resolution (self, parent, $this)
- Modern PHP syntax support

### Development Environment
- Update to Node.js 20+ with .nvmrc and .npmrc
- Modernize GitHub Actions for PHP 8.1-8.3 testing
- Add comprehensive documentation and contribution guidelines
- Add Dependabot for automated dependency updates

### Test Results
- All 22 tests passing (100% success rate)
- Full WordPress integration via wp-env
- Complete API compatibility maintained

Author: johnbillion

.github/dependabot.yml

@@ -0,0 +1,41 @@
+version: 2
+updates:
+  # Enable version updates for npm
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
+    groups:
+      wordpress:
+        patterns:
+          - "@wordpress/*"
+        update-types:
+          - "minor"
+          - "patch"
+
+  # Enable version updates for Composer
+  - package-ecosystem: "composer"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    open-pull-requests-limit: 10
+    groups:
+      phpstan:
+        patterns:
+          - "phpstan/*"
+        update-types:
+          - "minor"
+          - "patch"
+      phpunit:
+        patterns:
+          - "phpunit/*"
+        update-types:
+          - "minor"
+          - "patch"
+
+  # Enable version updates for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

.github/workflows/unit-test.yml

@@ -6,28 +6,34 @@ on:
   workflow_dispatch:
 
 jobs:
-    test-php:
-      runs-on: ubuntu-latest
-      strategy:
-          fail-fast: false
-          matrix:
-              php:
-                - '7.4'
-
-      env:
-        WP_ENV_PHP_VERSION: ${{ matrix.php }}
-
-      steps:
+  test-php:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        php:
+          - '8.1'
+          - '8.2'
+          - '8.3'
+
+    env:
+      WP_ENV_PHP_VERSION: ${{ matrix.php }}
+
+    steps:
       - name: Checkout
         uses: actions/checkout@v4
 
-      - name: Install
-        run: npm install
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: '.nvmrc'
+          cache: 'npm'
+
+      - name: Install Node.js dependencies
+        run: npm ci
 
-      - name: Setup Environment
-        run: |
-          rm composer.lock
-          npm run setup
+      - name: Setup WordPress environment
+        run: npm run setup
 
-      - name: Test
+      - name: Run tests
         run: npm run test

.gitignore

@@ -1,3 +1,4 @@
 vendor
 coverage
 node_modules
+.phpunit.result.cache

.npmrc

@@ -0,0 +1,14 @@
+# Use exact versions for reproducible builds
+save-exact=true
+
+# Automatically install peer dependencies
+auto-install-peers=true
+
+# Use npm audit signatures
+audit-level=moderate
+
+# Progress display for CI environments
+progress=false
+
+# Engine strict mode
+engine-strict=true

.nvmrc

@@ -0,0 +1 @@
+20

.wp-env.json

@@ -1,5 +1,5 @@
 {
-  "phpVersion": "7.4",
+  "phpVersion": "8.2",
   "plugins": [
     ".",
     "https://downloads.wordpress.org/plugin/posts-to-posts.latest-stable.zip"