Add plugin option runAfterServe

[hirasso]

Add a new plugin option runAfterServe. The option allows to run an arbitrary callback each time vite or vite serve is cancelled.

Use Case

When running vite serve (or vite), the asset state can drift from the last build. Automatically running vite build on exit ensures the assets folder stays up-to-date.

Usage

import { defineConfig } from "vite";
import laravel from "laravel-vite-plugin";
import { execSync } from "child_process";

export default defineConfig(async ({ mode }) => {
  return {
    plugins: [
      laravel({
        runAfterServe: () => {
          /** build assets each time serve is stopped */
          execSync("pnpm run build");
        },
      }),
    ]
  };
});

Why include this in laravel-vite-plugin

• Laravel (and most PHP sites) are usually served via an independent dev server (e.g., Herd, Valet, ddev). This means it's easy to access the site when Vite isn't running, potentially leading to outdated assets. Automatically running build on exit ensures a consistent asset state.
• laravel-vite-plugin already has a robust exit handler for removing the hot file (kudos for that!). Adding a custom callback here introduces minimal overhead while providing significant benefits for developers who rely on this behavior.

Alternatives Considered

Maintain an independent vite plugin. An example can be found here: https://gist.github.com/hirasso/604e3776ecfb402c8513154a8ae46cba

Naming

• runAfterServe?
• onExit?
• cleanup?

[hirasso]

Closing this for now, as I'll need more time to implement tests. eslint tests are now passing. If the idea is considered interesting at all, I could look into a possibility to add vitest tests, if required (and possible).

[timacdonald]

I would prefer to see this one released as dedicated plugin that anyone in the Vite community can use. This functionality would then be accessible to Laravel applications and other communities.

The great thing about using Vite directly is that we can lean on all the existing community plugins.

[hirasso]

Point taken. I'll think about releasing it as a separate plugin.