Command Palette

Preview

Commands are set in a script: el.commands = [{ id, label, group, action }, …].

<button id="open-cmdk">Open command palette</button>

<esa-command-palette id="cmdk"></esa-command-palette>

import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
import '@esa/ecology/esa-command-palette';

@Component({
  selector: 'app-command-palette-demo',
  standalone: true,
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
  template: `
    <button id="open-cmdk">Open command palette</button>
    <esa-command-palette id="cmdk"></esa-command-palette>
  `,
})
export class CommandPaletteDemo {}

API

Methods

Selecting a command runs its action callback, then closes the palette — there is no separate event.

Accessibility

• The overlay is role="dialog"; the results list is role="listbox" with role="option" items and aria-selected.
• ArrowUp / ArrowDown move the active option (wrapping), Enter executes, Esc closes.
• The search input is focused automatically when the palette opens.

Theming surface

Every public token this component reads, extracted from its source at build time, split by blast radius: the hooks that belong to this component, then the shared and system tokens it consumes alongside everything else. The Resolves to column walks each token's real lineage — component → semantic → primitive → raw value — so you can see exactly where re-pointing it lands. A spoke re-skins by overriding these in its theme-<slug>.css; component internals are never edited. No hook for what you need? File it with /request-lego.

Type roles it names

This component does not set a size, weight, face or tracking of its own — it names a composite, and the composite carries all five. A composite is a class rather than a token, so none of it appears in the tables below; re-theme text by re-pointing the token family, not by editing the component.

Wired to this component

No other component reads these — re-point them and esa-command-palette is the only thing that moves.

Shared tokens it reads

Owned by a family or by the semantic layer. Still overridable — but scope the override (esa-foo { --form-border-color: … }) unless you mean to move everything that reads it. Reach says what else that is.