AbstractDashboardComponent

Shared mount/handle plumbing for the dashboard primitive family (shell, topbar, sidebar, panel, grid, metric card, data table, …): concrete subclasses only implement {@see contract()} and, optionally, {@see initialData()} / {@see meta()} to describe their own props — this base class owns wiring {@see \Milpa\Live\Events\LiveEventEmitter}'s mounting/handling emit points and the default "no actions" `handle()`.

public function __construct(?Milpa\Interfaces\Event\MilpaEventDispatcherInterface $dispatcher = null):

Parameters

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

The subclass's runtime contract (name, props/state schema, actions).

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

Builds the initial state from {@see initialData()} (the `data` half) and {@see meta()} merged with common `id`/`title`/`route`/`principal` meta (the `meta` half).

Parameters

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

The default dashboard primitive `handle()`: none of these primitives declare actions, so every call reports an unrecognized-action error via {@see InteractionResult::$errors}. A subclass that does need actions (e.g. {@see DataTableComponent}) overrides this method entirely.

Parameters