All rules

Sheath rule

blade-alpine-directive-integrity

Alpine directives must use the values, companions, and modifiers its runtime consumes.
Package
Core
Category
Blade
Default severity
error by default
Auto-fix
Manual fix

#Why

Invalid Alpine directives can fail or silently do nothing. Coverage includes static x-id collections, assignable x-model and x-modelable values, modelable state, event listeners, transitions on inert templates, modifiers, model timing, and teleport placement. Valid system-key chords such as x-model.ctrl.enter are accepted.

Dynamic expressions are not evaluated. Explicit Blade attribute branches and x-ignore initialization boundaries are checked independently. Attributes on <x-...> and <livewire:...> component invocations are outside scope because the rendered browser markup is not known.

Supported behavior follows Alpine 3.15, including the .passive.false listener option added in Alpine 3.15.12.

#Examples

#Bad

<div x-show.transition="open"></div>
<input x-model.debonce.250ms="search">

#Good

<div x-show="open" x-transition></div>
<input x-model.debounce.250ms="search">