[9.x] Make Vite macroable

[timacdonald]

This PR makes the Vite class Macroable. This is rather nice for creating aliases for the Vite class to match those in your JS config.

Documentation PR: laravel/docs#8232

In JS land, configuration:

import { defineConfig } from 'vite';
import laravel from 'laravel-vite-plugin';
 
export default defineConfig({
    plugins: [
        laravel(/* ... */),
    ],
    resolve: {
        alias: {
            'image': '/resources/images',
            'page': '/resources/js/Pages',
        },
    },
});

Usage:

import Profile from '@image/profile.png'

In Laravel land, configuration:

<?php
 
namespace App\Providers;
 
use Illuminate\Support\Vite;
use Illuminate\Support\ServiceProvider;
 
class AppServiceProvider extends ServiceProvider
{
    /**
     * Bootstrap any application services.
     *
     * @return void
     */
    public function boot()
    {
        Vite::macro('image', fn ($asset) => $this->asset("resources/images/{$asset}"));
    }
}

Usage:

<img src="{{ Vite::image('profile.png') }}" ... >

You can also make more complicated alises based on things like the apps environment:

Vite::macro('localeAsset', function ($asset) {
    $locale = config('app.locale');

    // resources/jp/images/*
    // resources/en/images/*
    // resources/fr/images/*
    return $this->asset("resources/{$locale}/images/{$asset}");
});

<img src="{{ Vite::localeAsset('logo.png') }}" alt="...">

[timacdonald]

Using this approach, in userland you could also create your own internal standard to share aliases between you JS and you PHP.

e.g. you could have vite.alias.json

{
    "image": "resources/images"
}

And then read this file from your vite.config.js and also you service provider to generate the aliases dynamically. Of course if you needed loginc in here you could also come up with your own solution, such as string replacement:

{
    "image": "resources/{ENV:LOCALE}/images"
}

Then you could do a string replacement for ENV:LOCALE => `config('app.locale') and the same kinda thing in your JS.