Merge branch '2.x' into once-props

Author: michaelnabil230

.gitattributes

@@ -11,3 +11,4 @@
 /tests export-ignore
 /CHANGELOG.md export-ignore
 /README.md export-ignore
+/phpstan.neon export-ignore

.github/workflows/facade.yml

@@ -21,7 +21,7 @@ jobs:
       - name: Setup PHP
         uses: shivammathur/setup-php@v2
         with:
-          php-version: 8.1
+          php-version: 8.2
           tools: composer:v2
           coverage: none
 

.github/workflows/static-analysis.yml

@@ -0,0 +1,14 @@
+name: static analysis
+
+on:
+  push:
+    branches:
+      - "2.x"
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  tests:
+    uses: laravel/.github/.github/workflows/static-analysis.yml@main

.github/workflows/tests.yml

@@ -37,6 +37,10 @@ jobs:
           tools: composer:v2
           coverage: none
 
+      - name: Remove PHPStan on PHP 8.1 and Laravel 10
+        run: composer remove --dev larastan/larastan
+        if: matrix.php == 8.1 || matrix.laravel == 10
+
       - name: Set Minimum PHP 8.1 Versions
         uses: nick-fields/retry@v3
         with:

CHANGELOG.md

@@ -1,9 +1,46 @@
 # Release Notes
 
-## [Unreleased](https://github.com/inertiajs/inertia-laravel/compare/v2.0.3...2.x)
+## [Unreleased](https://github.com/inertiajs/inertia-laravel/compare/v2.0.5...2.x)
 
 - Nothing!
 
+## [v2.0.5](https://github.com/inertiajs/inertia-laravel/compare/v2.0.4...v2.0.5) - 2025-08-12
+
+### What's Changed
+
+* [2.x] Improve inertia helper docblock by [@mtlukaszczyk](https://github.com/mtlukaszczyk) in https://github.com/inertiajs/inertia-laravel/pull/766
+* [2.x] Introduce `ProvidesInertiaProp` interface by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/746
+* [2.x] Introduce ProvidesInertiaProps interface by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/769
+* Introduce PHPStan + improve DocBlocks by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/768
+
+### New Contributors
+
+* [@mtlukaszczyk](https://github.com/mtlukaszczyk) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/766
+
+**Full Changelog**: https://github.com/inertiajs/inertia-laravel/compare/v2.0.4...v2.0.5
+
+## [v2.0.4](https://github.com/inertiajs/inertia-laravel/compare/v2.0.3...v2.0.4) - 2025-07-15
+
+### What's Changed
+
+* [2.x] Ability to perform a SSR request without a bundle by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/751
+* [2.x] Added `inertia:check-ssr` Artisan command and `isHealthy()` method on `HttpGateway` by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/752
+* [2.x] Refactor `HttpGateway` by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/754
+* [2.x] Support for checking if the component exists when rendering by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/749
+* [2.x] Refactored `ssr.dispatch_without_bundle` to `ssr.ensure_bundle_exists` by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/755
+* [2.x] Restore `testing.page_paths` and `testing.page_extensions` configs by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/756
+* GitHub issue template by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/757
+* update return type in Middleware share method by [@hosmelq](https://github.com/hosmelq) in https://github.com/inertiajs/inertia-laravel/pull/758
+* Fix project name in `SECURITY.md` by [@duncanmcclean](https://github.com/duncanmcclean) in https://github.com/inertiajs/inertia-laravel/pull/759
+* [2.x] Remove old version checks by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/763
+
+### New Contributors
+
+* [@hosmelq](https://github.com/hosmelq) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/758
+* [@duncanmcclean](https://github.com/duncanmcclean) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/759
+
+**Full Changelog**: https://github.com/inertiajs/inertia-laravel/compare/v2.0.3...v2.0.4
+
 ## [v2.0.3](https://github.com/inertiajs/inertia-laravel/compare/v2.0.2...v2.0.3) - 2025-06-20
 
 ### What's Changed

composer.json

@@ -39,7 +39,8 @@
         "orchestra/testbench": "^8.0|^9.2|^10.0",
         "mockery/mockery": "^1.3.3",
         "phpunit/phpunit": "^10.4|^11.5",
-        "laravel/pint": "^1.16"
+        "laravel/pint": "^1.16",
+        "larastan/larastan": "^3.0"
     },
     "suggest": {
         "ext-pcntl": "Recommended when running the Inertia SSR server via the `inertia:start-ssr` artisan command."
@@ -53,4 +54,4 @@
     },
     "minimum-stability": "dev",
     "prefer-stable": true
-}
+}

helpers.php

@@ -6,7 +6,7 @@
      *
      * @param  null|string  $component
      * @param  array|\Illuminate\Contracts\Support\Arrayable  $props
-     * @return \Inertia\ResponseFactory|\Inertia\Response
+     * @return ($component is null ? \Inertia\ResponseFactory : \Inertia\Response)
      */
     function inertia($component = null, $props = [])
     {

phpstan.neon

@@ -0,0 +1,17 @@
+includes:
+	- vendor/larastan/larastan/extension.neon
+
+parameters:
+	level: 6
+	paths:
+		- src
+		- tests
+	excludePaths:
+		- src/Testing/Concerns
+	ignoreErrors:
+		- '#Call to an undefined method.*TestResponse.*::assertInertia\(\)#'
+		- '#Call to an undefined method.*TestResponse.*::inertiaPage\(\)#'
+		- '#Call to an undefined method.*TestResponse.*::inertiaProps\(\)#'
+		- '#Call to an undefined.*method.*Request::inertia\(\)#'
+		- '#Call to an undefined.*method.*Route::inertia\(\)#'
+

src/AlwaysProp.php

@@ -6,17 +6,32 @@
 
 class AlwaysProp
 {
-    /** @var mixed */
+    /**
+     * The property value.
+     *
+     * Always included in Inertia responses, bypassing partial reload filtering.
+     *
+     * @var mixed
+     */
     protected $value;
 
     /**
+     * Create a new always property instance. Always properties are included
+     * in every Inertia response, even during partial reloads when only
+     * specific props are requested.
+     *
      * @param  mixed  $value
      */
     public function __construct($value)
     {
         $this->value = $value;
     }
 
+    /**
+     * Resolve the property value.
+     *
+     * @return mixed
+     */
     public function __invoke()
     {
         return is_callable($this->value) ? App::call($this->value) : $this->value;

src/Commands/CheckSsr.php

@@ -25,7 +25,7 @@ class CheckSsr extends Command
     protected $description = 'Check the Inertia SSR server health status';
 
     /**
-     * check the SSR server via a Node process.
+     * Check the Inertia SSR server health status.
      */
     public function handle(Gateway $gateway): int
     {