Mobile v4 docs: validation + durable native callbacks

[shanerbaner82]

Summary

Documents the two feature PRs landing in core (NativePHP/mobile-air#301 and #302) for the v4 mobile docs.

New page — the-basics/validation.md (order 158, between Nested Components and Dialogs):

• validate() / validateOnly() in handlers: failure aborts the handler, keeps state, and the next frame renders with $errors — identical on device and web
• The repeatable #[Validate] attribute, eager per-sync validation (the native:model modifier is the cadence), rule merging, and the constant-expression limitation for Rule objects
• rules() / messages() / validationAttributes(), inline rule scoping, wildcard validateOnly
• FormRequest sharing: container method-injection for rules(), authorize() never called, props-only data scope
• Error display is explicit-only (Livewire semantics): @error, @nativeError, and input error/supporting attributes — a failed validation never changes an element's appearance on its own
• Manual bag control and per-component child scoping

Updated — the-basics/events.md:

• Both #[On] spellings (the native: prefix is applied idempotently)
• Fluent Pending* outcome callbacks and the new onSuccess() sugar
• Callback durability: two-tier storage, $this-bound closures surviving a process kill (serialize + rebind), constraints (serializable captures, no eval'd closures, persistent cache store), method-name strings as the most robust form
• Per-listener validation isolation, cross-linked to the validation page

Verification

Every documented fact was verified against the live core source and its test suites (26 validation tests + 8 durable-callback tests) rather than written from memory. Both pages render 200 on nativephp.test; prose Blade directives are @@-escaped per site convention (the docs pipeline compiles .md through Blade — a bare @error in prose is an unclosed if).

Note for reviewers: the feature PRs are not merged yet — this shouldn't ship before they do. One known naming inconsistency left alone per scope rules: text-input.md documents the error attribute as is-error while this page uses the :error alias (both are accepted by BaseTextInput).

🤖 Generated with Claude Code