Let UI plugins register custom Blade @event names

[thelemon2020]

Summary

• UI plugins can declare first-class Blade handlers (@link, @scan, @signed, …) instead of hijacking @change.
• Names are opt-in via components[].element_events in nativephp.json and/or Element::elementEvents(). Unregistered @foo still compiles as a child-component _event-foo binding ($this->emit()).
• The collector wires _link → onLink(), _scan → onScan(), including hyphenated names (@link-tapped → onLinkTapped()). Native renderers can keep sending the payload with sendTextChangeEvent; PHP already routes by callback id.

Registered names are global at compile time, same as @change. If a plugin registers link, @link on a nested child component is no longer $this->emit('link').

Site docs at plugins/ui-components still show _change="updateLabel" — that page lives in nativephp.com and can follow once this lands.

Test plan

• vendor/bin/pest tests/Unit/Edge/ComponentEventBindingPrecompilerTest.php tests/Unit/Edge/NativeElementCollectorTest.php tests/Unit/Edge/UiPluginComponentBootTest.php tests/Unit/Plugins/PluginManifestValidationTest.php
• Confirm <native:markdown @link="open"> compiles to _link after registering link, and that unregistered @order-shipped still becomes _event-order-shipped
• Confirm @if / @endif are untouched
• Confirm _event-* attrs are still stripped from plain elements
• Confirm a plugin Element with onScan() receives the handler when @scan is declared
• Confirm nativephp.json element_events are registered at boot via registerUiPluginComponents()

Made with Cursor

[simonhamp]

This is great! Mind adding the docs for it over on the nativephp.com repo when you get the chance?

[thelemon2020]

@simonhamp Docs are up here: NativePHP/nativephp.com#552