@raqm/ui 0.0.0-stage → 0.1.1

package/types/raqm-ui-combobox.d.ts

@@ -0,0 +1,405 @@
+import * as i0 from "@angular/core";
+import { Injector, OnDestroy, OnInit, Signal, TemplateRef, WritableSignal } from "@angular/core";
+import { ControlValueAccessor } from "@angular/forms";
+import { InteractivityChecker } from "@angular/cdk/a11y";
+/**
+ * A single selectable option; `value` is the stable string identity, separate from the translated
+ * `label`, and `''` is legitimate, not `null`. Values must be unique (duplicates report a dev error),
+ * and a `disabled` option can never be newly selected nor removed.
+ */
+interface RaqmComboboxOption {
+  value: string;
+  label: string;
+  /** Accessible description, separate from the name and filter label. */
+  description?: string;
+  disabled?: boolean;
+}
+interface RaqmComboboxGroup {
+  label: string;
+  options: readonly RaqmComboboxOption[];
+  /** Draws a separator before this group when a preceding entry is visible. */
+  separatorBefore?: boolean;
+}
+type RaqmComboboxEntry = RaqmComboboxOption | RaqmComboboxGroup;
+/** Context passed to an item template; `$implicit` and `item` are the same option. */
+interface RaqmComboboxItemContext {
+  $implicit: RaqmComboboxOption;
+  item: RaqmComboboxOption;
+  selected: boolean;
+  active: boolean;
+}
+type RaqmComboboxModel = readonly string[] | string | null;
+type RaqmComboboxMode = 'multiple' | 'popup' | 'inline';
+declare function labelContains(label: string, query: string): boolean;
+declare function normalizeMultiple(value: unknown): string[];
+declare function normalizePopup(value: unknown): string | null;
+declare function normalizeModel(value: unknown, mode: RaqmComboboxMode): RaqmComboboxModel;
+declare function reportDuplicateValues(items: readonly RaqmComboboxOption[]): void;
+interface RaqmComboboxOptionView {
+  readonly item: RaqmComboboxOption;
+  readonly id: string;
+  readonly index: number;
+}
+interface RaqmComboboxRenderEntry {
+  label: string | null;
+  id: string;
+  options: RaqmComboboxOptionView[];
+  separatorBefore: boolean;
+}
+interface RaqmComboboxChipView {
+  readonly value: string;
+  readonly label: string;
+  readonly removable: boolean;
+}
+declare function flattenItems(items: readonly RaqmComboboxEntry[]): readonly RaqmComboboxOption[];
+declare function filterOptions(items: readonly RaqmComboboxOption[], query: string, mode: RaqmComboboxMode, selectedLabel: string | null): readonly RaqmComboboxOption[];
+declare function optionDomId(inputId: string, value: string): string;
+declare function buildOptionViews(items: readonly RaqmComboboxOption[], inputId: string): readonly RaqmComboboxOptionView[];
+declare function buildRenderEntries(items: readonly RaqmComboboxEntry[], views: readonly RaqmComboboxOptionView[], listboxId: string): readonly RaqmComboboxRenderEntry[];
+declare function buildSelectedLabel(selected: RaqmComboboxModel, items: readonly RaqmComboboxOption[]): string | null;
+declare function buildSelectionRemovable(selected: RaqmComboboxModel, items: readonly RaqmComboboxOption[]): boolean;
+declare function buildChipViews(selected: RaqmComboboxModel, items: readonly RaqmComboboxOption[]): readonly RaqmComboboxChipView[];
+interface RaqmComboboxFieldHost {
+  open(): boolean;
+  disabled(): boolean;
+  selectionRemovable(): boolean;
+  chipViews(): readonly RaqmComboboxChipView[];
+  optionViews(): readonly RaqmComboboxOptionView[];
+  activeId(): string | null;
+  selected(): RaqmComboboxModel;
+  isOptionDisabled(item: RaqmComboboxOption): boolean;
+  trigger(): HTMLButtonElement | null;
+  element(): HTMLElement;
+  overlayElement(): HTMLElement | undefined;
+  openPopup(): void;
+  close(touched: boolean, restoreFocus?: boolean): void;
+  select(item: RaqmComboboxOption): void;
+  emit(value: RaqmComboboxModel): void;
+  resetActive(): void;
+  reconcileActive(): void;
+  markTouched(): void;
+  activateOption(index: number): void;
+}
+declare class RaqmComboboxField {
+  private readonly host;
+  private readonly document;
+  private readonly interactivityChecker;
+  readonly query: import("@angular/core").WritableSignal<string>;
+  readonly composingValue: import("@angular/core").WritableSignal<string | null>;
+  suppressBlurTouched: boolean;
+  private composing;
+  constructor(host: RaqmComboboxFieldHost, document: Document, interactivityChecker: InteractivityChecker);
+  get isComposing(): boolean;
+  /** Clears the query and any composition text on close. */
+  reset(): void;
+  /** Clears only the query; a CDK detach leaves composition text untouched. */
+  resetQuery(): void;
+  onChipsPointerDown(event: PointerEvent): void;
+  onInputPointerDown(): void;
+  onInlineFocus(event: FocusEvent): void;
+  onClearClick(event: MouseEvent): void;
+  onTriggerClick(): void;
+  onFocusOut(event: FocusEvent): void;
+  onInput(event: Event): void;
+  onCompositionStart(event: CompositionEvent): void;
+  onCompositionEnd(event: CompositionEvent): void;
+  onOptionPointerMove(view: RaqmComboboxOptionView, event: PointerEvent): void;
+  onOptionPointerLeave(event: PointerEvent): void;
+  onOptionClick(item: RaqmComboboxOption): void;
+  isSelected(item: RaqmComboboxOption): boolean;
+  leavePopupByTab(event: KeyboardEvent): void;
+  onChipRemoveClick(index: number, event: MouseEvent): void;
+  removeAt(index: number): void;
+  focusInput(): void;
+  focusChip(index: number): void;
+  restoreTriggerFocus(): void;
+  private applyQueryHighlight;
+  private inputElement;
+  private chipButton;
+}
+interface RaqmComboboxKeyboardHost {
+  /** Current option views, in render order. */
+  views(): readonly RaqmComboboxOptionView[];
+  open(): boolean;
+  disabled(): boolean;
+  /** True inside an IME composition, so a composing key never commits. */
+  composing(): boolean;
+  mode(): RaqmComboboxMode;
+  autoHighlight(): boolean;
+  query(): string;
+  direction(): 'ltr' | 'rtl';
+  isOptionDisabled(item: RaqmComboboxOption): boolean;
+  chipCount(): number;
+  scrollTo(id: string | null): void;
+  openPopup(): void;
+  close(touched: boolean): void;
+  select(item: RaqmComboboxOption): void;
+  removeChip(index: number): void;
+  focusChip(index: number): void;
+  focusInput(): void;
+  /** The portal sits at the document end, so the next tab stop is found by the caller. */
+  leavePopupByTab(event: KeyboardEvent): void;
+}
+declare class RaqmComboboxKeyboard {
+  private readonly host;
+  private readonly injector;
+  private keyManager;
+  private suppressActivationScroll;
+  private readonly activeValue;
+  readonly activeId: import("@angular/core").Signal<string | null>;
+  private readonly optionRefs;
+  constructor(host: RaqmComboboxKeyboardHost, injector: Injector);
+  /**
+   * Creates the key manager once `items` is bound; building it in the constructor would read the
+   * required `items` input before Angular binds it (`NG0950`).
+   */
+  init(): void;
+  destroy(): void;
+  onTriggerKeydown(event: KeyboardEvent): void;
+  onKeydown(event: KeyboardEvent): void;
+  onChipKeydown(index: number, event: KeyboardEvent): void;
+  /** Moves the active option; pointer activation never scrolls. */
+  activateIndex(index: number, scroll: boolean): void;
+  /** Marks the first enabled result active; an all-disabled list is left untouched. */
+  activateFirst(): void;
+  reconcile(views: readonly RaqmComboboxOptionView[]): void;
+  reset(): void;
+  private handleChipNavigation;
+}
+/**
+ * A searchable combobox in `multiple`, `popup` and `inline` presentations.
+ *
+ * @remarks
+ * The host has no ARIA role or tab stop; the single `input[raqm-input]` is the `role="combobox"`
+ * control and the popup an overlay `role="listbox"`. Bind one controller only: `writeValue` neither
+ * emits nor marks touched, a user change emits once, and option values are unique strings.
+ */
+export declare class RaqmCombobox implements ControlValueAccessor, OnInit, OnDestroy {
+  private readonly host;
+  private readonly document;
+  private readonly interactivityChecker;
+  private readonly overlay;
+  private readonly viewportRuler;
+  private readonly viewContainerRef;
+  private readonly injector;
+  private readonly directionality;
+  private readonly popupTemplate;
+  private readonly itemTemplateDirective;
+  private readonly inlinePrefixDirective;
+  private readonly chipsRef;
+  private readonly triggerRef;
+  private readonly inlineGroupRef;
+  private readonly autoId;
+  readonly mode: import("@angular/core").InputSignal<RaqmComboboxMode>;
+  readonly items: import("@angular/core").InputSignal<readonly RaqmComboboxEntry[]>;
+  /** Inline-only passive content in the input group's start addon. */
+  readonly inlinePrefix: Signal<TemplateRef<unknown> | null>;
+  /** Noninteractive option content; the option label stays the accessible name. */
+  readonly itemTemplate: Signal<TemplateRef<import("@raqm/ui/combobox").RaqmComboboxItemContext> | null>;
+  /** Popup pane width; `null` follows the anchor width. */
+  readonly popupWidth: import("@angular/core").InputSignal<string | null>;
+  /** Inline-axis offset in CSS pixels; negative moves toward inline-start. */
+  readonly popupAlignOffset: import("@angular/core").InputSignal<number>;
+  /** A string array in `multiple`, a scalar otherwise. */
+  readonly value: import("@angular/core").InputSignal<string | readonly string[] | null>;
+  /** Emits once per committed user change, never while typing. */
+  readonly valueChange: import("@angular/core").OutputEmitterRef<string | readonly string[] | null>;
+  /** Explicit disabled state, ORed with a Forms-driven one. */
+  readonly disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /** Application-owned invalid state; drives `aria-invalid`. */
+  readonly invalid: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /** Id of the real editable control; generated when absent. */
+  readonly inputId: import("@angular/core").InputSignal<string>;
+  /** Optional internal label text, rendered as a `<label [for]>`. */
+  readonly label: import("@angular/core").InputSignal<string | undefined>;
+  /** External label id(s); takes precedence over `label`. */
+  readonly labelledBy: import("@angular/core").InputSignal<string | undefined>;
+  readonly describedBy: import("@angular/core").InputSignal<string | undefined>;
+  /** Text shown when no item matches the query (multiple/popup). */
+  readonly placeholder: import("@angular/core").InputSignal<string>;
+  readonly searchPlaceholder: import("@angular/core").InputSignal<string | null>;
+  readonly emptyText: import("@angular/core").InputSignal<string | null>;
+  /** Accessible name of a chip's remove button. */
+  readonly removeLabel: import("@angular/core").InputSignal<string | null>;
+  /** Explicit direction; falls back to the nearest ancestor. */
+  readonly dir: import("@angular/core").InputSignal<"ltr" | "rtl" | undefined>;
+  /** Marks the first match active when typing or opening. */
+  readonly autoHighlight: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /** Inline only: renders the inline-end chevron trigger. */
+  readonly showTrigger: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /** Inline only: replaces the trigger with a clear button while a value exists. */
+  readonly showClear: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly clearLabel: import("@angular/core").InputSignal<string | null>;
+  readonly triggerLabel: import("@angular/core").InputSignal<string | null>;
+  readonly selected: WritableSignal<RaqmComboboxModel>;
+  private readonly view;
+  readonly resolvedInputId: Signal<string>;
+  readonly labelId: Signal<string>;
+  /** Id of the popup listbox, referenced by the control's `aria-controls`. */
+  readonly listboxId: Signal<string>;
+  readonly popupId: Signal<string>;
+  readonly searchId: Signal<string>;
+  readonly inputLabelledBy: Signal<string | null>;
+  readonly flatItems: Signal<readonly RaqmComboboxOption[]>;
+  readonly filteredItems: Signal<readonly RaqmComboboxOption[]>;
+  readonly optionViews: Signal<readonly RaqmComboboxOptionView[]>;
+  readonly renderEntries: Signal<readonly RaqmComboboxRenderEntry[]>;
+  readonly selectedLabel: Signal<string | null>;
+  readonly selectionRemovable: Signal<boolean>;
+  readonly inlineValue: Signal<string>;
+  readonly chipViews: Signal<readonly RaqmComboboxChipView[]>;
+  private readonly control;
+  readonly effectiveDisabled: Signal<boolean>;
+  protected readonly field: RaqmComboboxField;
+  protected readonly keyboard: RaqmComboboxKeyboard;
+  private readonly layer;
+  private readonly popup;
+  readonly open: WritableSignal<boolean>;
+  readonly overlayDir: WritableSignal<'ltr' | 'rtl'>;
+  readonly activeId: Signal<string | null>;
+  readonly query: WritableSignal<string>;
+  readonly composingValue: WritableSignal<string | null>;
+  constructor();
+  /**
+   * Creates the key manager once `items` is bound; building it in the constructor would read the
+   * required `items` input before Angular binds it (`NG0950`).
+   */
+  ngOnInit(): void;
+  ngOnDestroy(): void;
+  isOptionDisabled(item: RaqmComboboxOption): boolean;
+  /** Writes an external value without emitting or marking touched; normalised per mode. */
+  writeValue(value: unknown): void;
+  registerOnChange(fn: (value: RaqmComboboxModel) => void): void;
+  registerOnTouched(fn: () => void): void;
+  /** ORs a Forms disabled state with the explicit input and closes the popup. */
+  setDisabledState(isDisabled: boolean): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmCombobox, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RaqmCombobox, "raqm-combobox", never, {
+    "mode": {
+      "alias": "mode";
+      "required": false;
+      "isSignal": true;
+    };
+    "items": {
+      "alias": "items";
+      "required": true;
+      "isSignal": true;
+    };
+    "popupWidth": {
+      "alias": "popupWidth";
+      "required": false;
+      "isSignal": true;
+    };
+    "popupAlignOffset": {
+      "alias": "popupAlignOffset";
+      "required": false;
+      "isSignal": true;
+    };
+    "value": {
+      "alias": "value";
+      "required": false;
+      "isSignal": true;
+    };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+    "invalid": {
+      "alias": "invalid";
+      "required": false;
+      "isSignal": true;
+    };
+    "inputId": {
+      "alias": "inputId";
+      "required": false;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+    "labelledBy": {
+      "alias": "labelledBy";
+      "required": false;
+      "isSignal": true;
+    };
+    "describedBy": {
+      "alias": "describedBy";
+      "required": false;
+      "isSignal": true;
+    };
+    "placeholder": {
+      "alias": "placeholder";
+      "required": false;
+      "isSignal": true;
+    };
+    "searchPlaceholder": {
+      "alias": "searchPlaceholder";
+      "required": false;
+      "isSignal": true;
+    };
+    "emptyText": {
+      "alias": "emptyText";
+      "required": false;
+      "isSignal": true;
+    };
+    "removeLabel": {
+      "alias": "removeLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "dir": {
+      "alias": "dir";
+      "required": false;
+      "isSignal": true;
+    };
+    "autoHighlight": {
+      "alias": "autoHighlight";
+      "required": false;
+      "isSignal": true;
+    };
+    "showTrigger": {
+      "alias": "showTrigger";
+      "required": false;
+      "isSignal": true;
+    };
+    "showClear": {
+      "alias": "showClear";
+      "required": false;
+      "isSignal": true;
+    };
+    "clearLabel": {
+      "alias": "clearLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "triggerLabel": {
+      "alias": "triggerLabel";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "valueChange": "valueChange";
+  }, ["itemTemplateDirective", "inlinePrefixDirective"], never, true, never>;
+}
+/**
+ * Projected item template for a popup row; renders with the option context (`$implicit`/`item`,
+ * `selected`, `active`) and must stay noninteractive — the option `label` remains the accessible name.
+ */
+export declare class RaqmComboboxItemDirective {
+  readonly template: TemplateRef<RaqmComboboxItemContext>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmComboboxItemDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmComboboxItemDirective, "ng-template[raqm-combobox-item]", ["raqmComboboxItem"], {}, {}, never, never, true, never>;
+}
+/**
+ * Projected start-addon template for the inline presentation; its content is passive and
+ * application-owned.
+ */
+export declare class RaqmComboboxPrefixDirective {
+  readonly template: TemplateRef<unknown>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmComboboxPrefixDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmComboboxPrefixDirective, "ng-template[raqm-combobox-prefix]", ["raqmComboboxPrefix"], {}, {}, never, never, true, never>;
+}
+export type { RaqmComboboxEntry, RaqmComboboxGroup, RaqmComboboxItemContext, RaqmComboboxOption };

package/types/raqm-ui-command.d.ts

@@ -0,0 +1,256 @@
+import * as i0 from "@angular/core";
+import { InjectionToken, OnInit, Signal } from "@angular/core";
+import { RaqmDialogBaseComponent } from "@raqm/ui/dialog";
+interface RaqmCommandOption {
+  readonly id: string;
+  readonly element: HTMLElement;
+  readonly disabled: boolean;
+  readonly checked: Signal<boolean>;
+  readonly group: string | null;
+  readonly value: Signal<string>;
+  readonly title: Signal<string>;
+  readonly keywords: Signal<readonly string[]>;
+  setActiveStyles(): void;
+  setInactiveStyles(): void;
+  select(): void;
+  scrollIntoView(): void;
+}
+declare const RAQM_COMMAND: InjectionToken<RaqmCommandComponent>;
+declare const RAQM_COMMAND_GROUP: InjectionToken<string>;
+/** Inline command palette. Focus stays on its input; active options never receive DOM focus. */
+export declare class RaqmCommandComponent {
+  /** The application-authored accessible name for the listbox. */
+  readonly label: import("@angular/core").InputSignal<string>;
+  readonly search: import("@angular/core").ModelSignal<string>;
+  /** Whether keyboard navigation wraps at the ends; defaults to `false`. */
+  readonly loop: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /** Whether search filters and ranks rows; defaults to `true`. */
+  readonly shouldFilter: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly listId: string;
+  readonly inputId: string;
+  readonly items: import("@angular/core").WritableSignal<readonly RaqmCommandOption[]>;
+  readonly activeId: import("@angular/core").WritableSignal<string | null>;
+  readonly listPresent: import("@angular/core").WritableSignal<boolean>;
+  readonly visibleItems: import("@angular/core").Signal<RaqmCommandOption[]>;
+  /** Whether any registered row is checked; switches the list to multi-select. */
+  readonly hasChecked: import("@angular/core").Signal<boolean>;
+  private readonly scores;
+  private readonly rankedItems;
+  private readonly injector;
+  readonly contentInjector: import("@angular/core").DestroyableInjector;
+  private readonly manager;
+  private sequence;
+  private focusInput;
+  private readonly originalChildren;
+  constructor();
+  private lastSearch;
+  register(item: RaqmCommandOption): void;
+  unregister(item: RaqmCommandOption): void;
+  mintId(): string;
+  registerInput(focus: () => void): void;
+  unregisterInput(): void;
+  matches(item: RaqmCommandOption): boolean;
+  activate(item: RaqmCommandOption): void;
+  select(item: RaqmCommandOption): void;
+  keydown(event: KeyboardEvent): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmCommandComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RaqmCommandComponent, "raqm-command", never, {
+    "label": {
+      "alias": "label";
+      "required": true;
+      "isSignal": true;
+    };
+    "search": {
+      "alias": "search";
+      "required": false;
+      "isSignal": true;
+    };
+    "loop": {
+      "alias": "loop";
+      "required": false;
+      "isSignal": true;
+    };
+    "shouldFilter": {
+      "alias": "shouldFilter";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "search": "searchChange";
+  }, never, ["*"], true, never>;
+}
+/** Command modal using Dialog's lifecycle. Project an ng-template[raqm-dialog-content]; a trigger is optional. */
+export declare class RaqmCommandDialogComponent extends RaqmDialogBaseComponent {
+  /** Whether the root renders its own close control; defaults to `false`. */
+  readonly showCloseButton: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly closeLabel: import("@angular/core").InputSignal<string | undefined>;
+  readonly title: import("@angular/core").InputSignal<string>;
+  /** Optional supporting copy under the title. */
+  readonly description: import("@angular/core").InputSignal<string>;
+  protected readonly closeButtonVisible: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  protected readonly closeLabelText: Signal<string | undefined>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmCommandDialogComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RaqmCommandDialogComponent, "raqm-command-dialog", never, {
+    "showCloseButton": {
+      "alias": "showCloseButton";
+      "required": false;
+      "isSignal": true;
+    };
+    "closeLabel": {
+      "alias": "closeLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "title": {
+      "alias": "title";
+      "required": true;
+      "isSignal": true;
+    };
+    "description": {
+      "alias": "description";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, ["*"], true, never>;
+}
+/** Native search input composed with Input Group, owning the palette's single tab stop. */
+export declare class RaqmCommandInputComponent {
+  protected readonly command: import("@raqm/ui/command").RaqmCommandComponent;
+  readonly placeholder: import("@angular/core").InputSignal<string>;
+  readonly label: import("@angular/core").InputSignal<string>;
+  readonly disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  private readonly control;
+  constructor();
+  protected onInput(event: Event): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmCommandInputComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RaqmCommandInputComponent, "raqm-command-input", never, {
+    "placeholder": {
+      "alias": "placeholder";
+      "required": false;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": true;
+      "isSignal": true;
+    };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+/** Scrollable, named result list for the input's combobox. */
+export declare class RaqmCommandListComponent {
+  protected readonly command: import("@raqm/ui/command").RaqmCommandComponent;
+  readonly label: import("@angular/core").InputSignal<string>;
+  constructor();
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmCommandListComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RaqmCommandListComponent, "raqm-command-list", never, {
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, ["*"], true, never>;
+}
+/** Empty-results message, including when filtering removes every group. */
+export declare class RaqmCommandEmptyComponent {
+  protected readonly command: import("@raqm/ui/command").RaqmCommandComponent;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmCommandEmptyComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RaqmCommandEmptyComponent, "raqm-command-empty", never, {}, {}, never, ["*"], true, never>;
+}
+/** Named option group; hides its heading with its last filtered-out item. */
+export declare class RaqmCommandGroupComponent implements OnInit {
+  protected readonly command: import("@raqm/ui/command").RaqmCommandComponent;
+  readonly id: string;
+  readonly headingId: string;
+  readonly heading: import("@angular/core").InputSignal<string>;
+  readonly label: import("@angular/core").InputSignal<string>;
+  protected readonly visible: import("@angular/core").Signal<boolean>;
+  ngOnInit(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmCommandGroupComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RaqmCommandGroupComponent, "raqm-command-group", never, {
+    "heading": {
+      "alias": "heading";
+      "required": false;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, ["*"], true, never>;
+}
+export declare class RaqmCommandSeparatorDirective {
+  protected readonly command: import("@raqm/ui/command").RaqmCommandComponent;
+  readonly alwaysRender: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmCommandSeparatorDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmCommandSeparatorDirective, "[raqm-command-separator]", never, {
+    "alwaysRender": {
+      "alias": "alwaysRender";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+export declare class RaqmCommandItemComponent implements RaqmCommandOption, OnInit {
+  protected readonly command: import("@raqm/ui/command").RaqmCommandComponent;
+  private readonly host;
+  readonly group: string | null;
+  readonly id: string;
+  readonly value: import("@angular/core").InputSignal<string>;
+  readonly title: import("@angular/core").InputSignal<string>;
+  readonly keywords: import("@angular/core").InputSignal<readonly string[]>;
+  readonly disabledValue: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly checked: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly selected: import("@angular/core").OutputEmitterRef<string>;
+  get disabled(): boolean;
+  get element(): HTMLElement;
+  constructor();
+  ngOnInit(): void;
+  setActiveStyles(): void;
+  setInactiveStyles(): void;
+  select(): void;
+  scrollIntoView(): void;
+  protected onPointerMove(event: PointerEvent): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmCommandItemComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<RaqmCommandItemComponent, "raqm-command-item", never, {
+    "value": {
+      "alias": "value";
+      "required": true;
+      "isSignal": true;
+    };
+    "title": {
+      "alias": "title";
+      "required": false;
+      "isSignal": true;
+    };
+    "keywords": {
+      "alias": "keywords";
+      "required": false;
+      "isSignal": true;
+    };
+    "disabledValue": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+    "checked": {
+      "alias": "checked";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "selected": "selected";
+  }, never, ["*"], true, never>;
+}
+/** Display-only shortcut. This never registers a global keyboard binding. */
+export declare class RaqmCommandShortcutDirective {
+  static ɵfac: i0.ɵɵFactoryDeclaration<RaqmCommandShortcutDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<RaqmCommandShortcutDirective, "[raqm-command-shortcut]", never, {}, {}, never, never, true, never>;
+}
+export declare const RaqmCommand: readonly [typeof RaqmCommandComponent, typeof RaqmCommandDialogComponent, typeof RaqmCommandInputComponent, typeof RaqmCommandListComponent, typeof RaqmCommandEmptyComponent, typeof RaqmCommandGroupComponent, typeof RaqmCommandSeparatorDirective, typeof RaqmCommandItemComponent, typeof RaqmCommandShortcutDirective];
+export {};