Made of little things.

/**
 * NAP-KEYS action keybindings for discrete commands. The shell may bind each
 * action to a key; the injected binding then suppresses forwarding for that
 * key, calls `preventDefault()` and runs the handler locally. Built-in keys
 * stay as the fallback, so the optional domain only adds shell-owned bindings.
 * Held flight controls stay on raw key state: actions have no release edge.
 */
import { KEYS_DOMAIN, keys, type Action } from '@napplet/sdk';
import { runtimeHasDomain } from './domain-availability.ts';

export type ShellAction = Action & { run: () => void };

/** Register actions when the domain is present; returns a cleanup. */
export function registerShellActions(actions: readonly ShellAction[]): () => void {
  if (!runtimeHasDomain(KEYS_DOMAIN)) return () => {};
  const subscriptions = actions.map(({ run, ...action }) => {
    keys.registerAction(action).catch((error: unknown) => {
      console.warn(`Shell keybinding ${action.id} unavailable`, error);
    });
    return keys.onAction(action.id, run);
  });
  return () => {
    for (const subscription of subscriptions) subscription.close();
    for (const action of actions) keys.unregisterAction(action.id);
  };
}

/** True when a NAP-KEYS binding already handled this keystroke as an action. */
export const handledByShellBinding = (event: KeyboardEvent) => event.defaultPrevented;