[11.x] Support Single and Multi-Selection for Publishing Stubs

[ahinkle]

This PR adds support for single and multi-selection using Laravel Prompts in the stub:publish artisan command.

Screen.Recording.2024-12-04.at.10.43.23.AM.mov

The stub:publish command currently publishes all customizable stubs, which now includes 52 stubs. With this change, it adds flexibility for developers who only need to customize a few specific stubs.

• You can now choose which stubs to publish directly from a selection menu, making it easier to target just the stubs you need.

• --all Option: If you prefer to publish everything, the --all flag skips the menu and works just like it does today.

Examples:

Interactive Mode:

Simply run:

php artisan stub:publish

and select one or more stubs from the list:

End Result:

Publish All:

Use the --all flag to publish everything at once:

php artisan stub:publish --all

[taylorotwell]

I think we should limit this prompt to the most commonly customized stubs and give them human friendly names rather than file names. 👍

[ahinkle]

Thanks! Made a few updates.

• I updated the names to be more human-readable. After reviewing, I realized that reading the names left to right didn’t feel natural. Leading with the secondary descriptor (e.g., "Invokable Controller" instead of "Controller Invokable") makes them easier to understand.

• I reviewed our laravel apps to find the most commonly used stubs and narrowed the list to focus on essentials. Models, controllers, migrations, seeders, factories, tests (+ Pest), resources, notifications, mailables, and jobs. This reduced the list from 52 to 31 stubs. I’d love to hear your thoughts on whether this selection feels right or needs some adjustments.

• Since we’re now focusing on common stubs, what do you think about adding a --list-all flag to show the full list of available stubs? This could be useful for developers looking for less common ones.

[taylorotwell]

Couple of notes here... I think things like Controllers should probably be grouped like

• Controller
• Controller (Invokable)
• Controller (API)

That being said, the amount of controller stubs we have makes me sad and makes the menu feel a bit confusing 🥲 ... not sure what to do about that. There would be 12 entries just for controllers.