Add AST dump helper and sample fixtures

Author: rlerdorf

TOLERANT_TODO.md

@@ -62,7 +62,7 @@ Monitor RFCs merged into php-src and mirror the token/grammar changes, for examp
 
 ### Verification Strategy
 
-- **AST comparison**: use Phan’s `tools/dump_ast.php` (php-ast) to capture the expected AST for new syntax. Create or extend a tolerant-side helper (instantiate `Microsoft\PhpParser\Parser` and `var_dump` the node tree) so we can diff tolerant output against php-ast.
+- **AST comparison**: use Phan’s `tools/dump_ast.php` (php-ast) to capture the expected AST for new syntax. For the tolerant side, run `php tools/PrintTolerantAst.php` (raw tolerant tree) in combination with Phan’s `internal/dump_fallback_ast.php` (uses the converter) to ensure both the parse tree and converted php-ast structures match expectations.
 - **PHP runtime selection**: on this dev machine we can run `sudo newphp 83`, `sudo newphp 84`, etc. to switch CLI versions; other environments may require Docker images, phpenv, asdf, etc. Record the PHP version used when regenerating fixtures.
 - **Leverage Phan fixtures**: pull feature-specific testcases (e.g. property hooks, asymmetric visibility) from `phan/tests/files/src` into tolerant’s parser tests to validate new constructs.
 - **Run tolerant PHPUnit suites**: keep `vendor/bin/phpunit --testsuite invariants,api` (with `zend.assertions=1`) as a fast regression check while iterating.

tests/samples/dynamic_class_const.php

@@ -0,0 +1,16 @@
+<?php
+
+class Example {
+    public const FOO = 'foo';
+    public const BAR = 'bar';
+}
+
+function pickConst(): string {
+    return 'FOO';
+}
+
+$name = 'BAR';
+
+// Dynamic class constant fetch (PHP 8.3)
+var_dump(Example::{pickConst()});
+var_dump(Example::{ $name });

tests/samples/property_hooks.php

@@ -0,0 +1,14 @@
+<?php
+
+class Counter {
+    private int $value = 0;
+
+    public int $count {
+        get => $this->value;
+        set (int $newValue) => $this->value = max(0, $newValue);
+    }
+}
+
+$counter = new Counter();
+$counter->count = 5;
+var_dump($counter->count);

tools/PrintTolerantAst.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+require __DIR__ . '/../vendor/autoload.php';
+
+use Microsoft\PhpParser\DiagnosticsProvider;
+use Microsoft\PhpParser\Parser;
+
+if ($argc < 2) {
+    fwrite(STDERR, "Usage: php tools/PrintTolerantAst.php <file.php>\n");
+    exit(1);
+}
+
+$file = $argv[1];
+if (!is_file($file)) {
+    fwrite(STDERR, "File not found: {$file}\n");
+    exit(1);
+}
+
+$code = file_get_contents($file);
+$parser = new Parser();
+$node = $parser->parseSourceFile($code);
+
+fwrite(STDOUT, "===== AST =====\n");
+echo json_encode($node, JSON_PRETTY_PRINT) ?: '';
+fwrite(STDOUT, "\n\n===== Diagnostics =====\n");
+echo json_encode(DiagnosticsProvider::getDiagnostics($node), JSON_PRETTY_PRINT) ?: '';
+fwrite(STDOUT, "\n");