Enable multiple registrations

[dpanta94]

The primary funcitonality that is being introduced is allowing you to make multiple registrations just by using the API exposed.

Previously, because internally there were calls to wp_script_is or wp_style_is even if you removed the asset altogether you could not register more than once.

Registering more than once can have some advantages - listing a couple that pop on the top of my head.

1. Adding a script which is extending another script related to block editor.

Now you can modify your original's script dependencies to include your new script. Making managing when your script should be included easy. Wherever my original script is included, also please include my extension.

2. Enabling us to overwrite based on filters.

Also this PR introduces a magic method which enables us to call script or style methods from WP on the asset instance itself. You only need to call the method without the wp_ prefix and replacing with asset wherever the script or style would be.

So now you can do:

$asset->deregister_asset();

// will correctly call wp_deregister_script( $slug ) or wp_deregister_style( $slug ), based on the asset's type.
// The slug is always passed as the first param and you can pass anything else you might need.

See an example of a snippet we had to provide support to achieve the functionality being added here:
https://lw.slack.com/archives/C01SBD5T03V/p1732799298015619?thread_ts=1732270965.841129&cid=C01SBD5T03V

[lucatume]

This is smart and saves some lines of code, but I do not think makes for readable code.
I would unroll the __call method and explicitly create each method that is now part of the @method annotation.
This should likely not be a gateway to all wp_ functions, but to a limited, controlled and tested set of them.
What would this do if I call $asset->footer?
If you end up having to maintain a safe-list of functions that can be called, you're better served by an explicit API made of concrete methods.

[borkweb]

This looks pretty great (once Luca's comment is addressed) 🕺