v0.5.0

[rcalicdan]

What's New in v0.5.0

Tooling Annotation Priority Hierarchy (@phpstan-* & @psalm-*)

TypePHP now natively respects the 3-Tier Tooling Priority Hierarchy: @phpstan-* > @psalm-* > standard @*.

• @phpstan-param and @psalm-param override broad @param tags.
• @phpstan-return and @psalm-return override broad @return tags.
• @phpstan-var and @psalm-var override broad @var tags.
• Enables seamless, out-of-the-box runtime generic enforcement for libraries like Doctrine Collections, Symfony, and Laravel without manual wrapper boilerplate.

Generic Trait Support (@use, @template-use, @phpstan-use)

Full runtime generic support for traits:

• Class-level trait annotations: /** @use GenericTrait<T> */ class Service { use GenericTrait; }
• Inline statement annotations: class Service { /** @use GenericTrait<T> */ use GenericTrait; }
• Single-line compact annotations: /** @use GenericTrait<T> */ use GenericTrait;
• Inherited trait templates are bound in $O(1)$ constant time in \WeakMap memory with full Vendor Isolation protection.

Extended Inherited Template Annotations

Full support for third-party inheritance tag variations:

• Class Inheritance: @extends, @template-extends, @phpstan-extends, @psalm-extends
• Interface Implementation: @implements, @template-implements, @phpstan-implements, @psalm-implements
• Trait Usage: @use, @template-use, @phpstan-use

Automatic Project Root Resolution (Web Server Independence)

• Introduced Config::getProjectRoot() which searches upwards for vendor/autoload.php or composer.json and memoizes the path in static RAM.
• Eliminates getcwd() discrepancies in web server document roots (e.g. public/index.php in Symfony / Laravel / PHP-FPM / FrankenPHP).

Stability & CI Matrix

• Full test suite expansion to 751+ tests (1,777 assertions).
• 100% green build matrix across PHP 8.2, 8.3, 8.4, and 8.5 on Ubuntu, Windows, and macOS.
• PHPStan static analysis verified at Level MAX (0 errors).
• PSR-12 code style enforced across all 339+ files.

Full Changelog: v0.4.3...v0.5.0

---

This discussion was created from the release v0.5.0.