AutocompleteComponent

Live autocomplete primitive: a search box backed by an injectable {@see DataSourceRegistryInterface}, with `search`/`select`/`remove`/`clear` actions and optional single- or multi-select state. Render-target-agnostic like every component here — this class only owns {@see contract()}, {@see mount()}, and {@see handle()}; turning its state into markup/TUI is a {@see \Milpa\Live\Contracts\Rendering\ComponentRendererInterface}'s job.

public function __construct(Milpa\Live\Contracts\Data\DataSourceRegistryInterface $dataSources, ?Milpa\Interfaces\Event\MilpaEventDispatcherInterface $dispatcher = null):

Parameters

public static function contract(): Milpa\Live\ValueObjects\ComponentContract

The autocomplete's runtime contract: props/state schema plus its four declared actions (`search`, `select`, `remove`, `clear`).

public function mount(array $props, Milpa\Live\ValueObjects\ComponentContext $context): Milpa\Live\ValueObjects\StateSnapshot

Builds the initial state from `source`/`query`/`selected`/`limit`/ `multiple` props; requires a non-empty `source` prop.

Parameters

Throws

\InvalidArgumentException If `source` is missing or empty.

public function handle(Milpa\Live\ValueObjects\InteractionRequest $request): Milpa\Live\ValueObjects\InteractionResult

Dispatches to `search`/`select`/`remove`/`clear`; an unrecognized action is reported via {@see InteractionResult::$errors} rather than thrown, per {@see ComponentDefinitionInterface::handle()}'s contract.

Parameters