[Bug]: Regression in v1.5 - "app" is stripped from filename leading to file not found exception

[reafeichtinger]

Extension Version

v1.5+

PHP Binary

Sail

Operating System

Linux

What happened?

The issue

After updating the extension to v1.5 or v1.5.1 it started throwing an exception. The cause seems to be agressive namespace normalization. I have the following livewire 4 component:

@livewire('venues.bookings.partials.appointment-pagination') in
resources/views/livewire/venues/bookings/partials/appointment-pagination.blade.php

The error occurs because it is stripping the "app" from the filename of the component leading to
/resources/views/livewire/venues/bookings/partialsointment-pagination.blade.php, which obviously doesn't exist.

Of course I double checked for bad references in my code but everything is referenced correctly.

Workaround

Currently the only way to get the extension back to running normally (except for renaming my component which I don't want to do) is to rollback to v1.4.3.

Full error

2026-01-31 20:34:17.424 [error] Error: __VSCODE_LARAVEL_START_OUTPUT__
   ErrorException 

  file_get_contents(/app/resources/views/livewire/venues/bookings/partialsointment-pagination.blade.php): Failed to open stream: No such file or directory

  at vendor/_laravel_ide/discover-cfae44312a91110c691459b4106ded61.php:418
    414▕     }
    415▕ 
    416▕     protected function parseProps($compiler, array $component): ?string
    417▕     {
  ➜ 418▕         $content = file_get_contents(base_path($component['path']));
    419▕ 
    420▕         $result = '';
    421▕ 
    422▕         $compiler->directive('props', function ($expression) use (&$result) {

      �[2m+2 vendor frames �[22m

  3   [internal]:0
      class@anonymous\/app/vendor/_laravel_ide/discover-cfae44312a91110c691459b4106ded61.php:68$1::{closure:{closure:class@anonymous\/app/vendor/_laravel_ide/discover-cfae44312a91110c691459b4106ded61.php:68$1::setProps():397}:398}(["resources/views/livewire/venues/bookings/partialsointment-pagination.blade.php"])
      �[2m+4 vendor frames �[22m

  8   [internal]:0
      class@anonymous\/app/vendor/_laravel_ide/discover-cfae44312a91110c691459b4106ded61.php:68$1::{closure:class@anonymous\/app/vendor/_laravel_ide/discover-cfae44312a91110c691459b4106ded61.php:68$1::setProps():397}(Object(Illuminate\Support\Collection), "venues.bookings.partials.appointment-pagination")

Mimimal Code Sample

I would assume just creating a component that starts with "app" would be enough to trigger this.

[N1ebieski]

Hi @reafeichtinger, that’s weird. Could you show your livewire.php config?

I can’t reproduce the issue on my end.

[reafeichtinger]

@N1ebieski Thank you for checking. Here is my config. It is an older (and quite big) project so some configs may be outdated but I couldn't see anything out of the ordinary. Also, I'm not using the new component structure but the classic one where the Component is in App\Http\Livewire\Venues\Bookings\Partials\AppointmentPagination and the view for it is in resources/views/livewire/venues/bookings/partials/appointment-pagination.blade.php.

<?php

return [
    'component_locations' => [
        resource_path('views/components'),
        resource_path('views/livewire'),
    ],

    'component_namespaces' => [
        'layouts' => resource_path('views/layouts'),
        'pages' => resource_path('views/pages'),
    ],

    'class_namespace' => 'App\\Http\\Livewire',

    'view_path' => resource_path('views/livewire'),

    'component_layout' => 'layouts::app',

    'temporary_file_upload' => [
        'disk' => null,              
        'rules' => null,         
        'directory' => 'livewire-tmp',  
        'middleware' => null,     
        'preview_mimes' => [          
            'png', 'gif', 'bmp', 'svg', 'wav', 'mp4',
            'mov', 'avi', 'wmv', 'mp3', 'm4a', 'pdf',
            'jpg', 'jpeg', 'mpga', 'webp', 'wma',
        ],
        'max_upload_time' => 5,
        'cleanup' => true, 
    ],

    'render_on_redirect' => false,

    'component_placeholder' => 'components.livewire.placeholder',

    'legacy_model_binding' => false,

    'inject_assets' => true,

    'navigate' => false,

    'inject_morph_markers' => true,

    'smart_wire_keys' => false,

    'pagination_theme' => 'tailwind',
];

[N1ebieski]

@reafeichtinger thanks. It's still working for me. Are you sure you don't have any unusual changes in the default Blade compiler? The VS Code plugin has used it since v1.5: https://github.com/laravel/vs-code-extension/blob/main/php-templates/blade-components.php#L327

[reafeichtinger]

@N1ebieski Actually I do have a custom Blade Compiler because I needed some custom parsing before Livewire kicks in.

In my AppServiceProvider->register() method:

$this->app->singleton('blade.compiler', function ($app) {
    return new WTagBladeCompiler($app['files'], $app['config']['view.compiled']);
});

And the WTagBladeCompiler:

<?php

namespace App\View\Compilers;

use Illuminate\View\Compilers\BladeCompiler;

class WTagBladeCompiler extends BladeCompiler
{
    /**
     * This is overriding the main method that compiles blade views.
     */
    public function compileString($value)
    {
        if (str_contains($value, '{{--W-REWRITTEN--}}')) {
            return parent::compileString($value);
        }

        $value = $this->rewriteOpeningTags($value);
        $value = $this->rewriteClosingTags($value);
        $value = $this->markAsRewritten($value);

        return parent::compileString($value);
    }

    /**
     * Custom method to parse <w-xxx
     */
    protected function rewriteOpeningTags(string $value): string
    {
        return preg_replace_callback(
            '/<w-([a-zA-Z0-9\-]+)/m',
            function ($matches) {
                if (!($matches[1] ?? null)) {
                    return $matches[0] ?? '';
                }

                return "<livewire:components.{$matches[1]}";
            },
            $value
        );
    }

    /**
     * Custom method to parse </w-xxx>
     */
    protected function rewriteClosingTags(string $value): string
    {
        return preg_replace_callback(
            '/<\/w-([a-zA-Z0-9\-]+)>/m',
            function ($matches) {
                if (!($matches[1] ?? null)) {
                    return $matches[0] ?? '';
                }

                return "</livewire:components.{$matches[1]}>";
            },
            $value
        );
    }

    /**
     * Add a blade comment so the same content is not parsed twice.
     */
    protected function markAsRewritten(string $value): string
    {
        return "{{--W-REWRITTEN--}}\n$value";
    }
}

It will point <w-xxx tags to livewire:components.xxx .

[N1ebieski]

@reafeichtinger could you comment out this code in the AppServiceProvider->register(), reload the VS Code and check if the VS Code error appears?

[reafeichtinger]

@N1ebieski Even when commenting out the custom BladeCompiler I get the same error unfortunately. I also tried clearing caches and deleting the _laravel_ide folder.

[N1ebieski]

@reafeichtinger thanks. Maybe you have your own implementation of the base_path (or App::basePath) helper method? The VS Code plugin uses it as well: https://github.com/laravel/vs-code-extension/blob/main/php-templates/blade-components.php#L353

[reafeichtinger]

@N1ebieski No I don't have anything custom for that.