/// <reference path="../../index.d.ts" />
import type { PublicLitElement as LitElement } from "@arcgis/lumina";
import type { Scale, SelectionMode } from "../interfaces.js";
import type { Card } from "../calcite-card/customElement.js";

/**
 * @cssproperty [--calcite-card-group-gap] - [Deprecated] in v2.13.0, removal target v6.0.0 - Use `--calcite-card-group-space` instead. Specifies the gap between slotted elements.
 * @cssproperty [--calcite-card-group-space] - Specifies the space between slotted elements.
 * @slot  - A slot for adding one or more `calcite-card`s.
 */
export abstract class CardGroup extends LitElement {
  /**
   * When `true`, interaction is prevented and the component is displayed with lower opacity.
   *
   * @default false
   */
  accessor disabled: boolean;
  /**
   * Specifies an accessible label for the component.
   *
   * @required
   */
  accessor label: string;
  /**
   * Specifies the size of the component. Child `calcite-card`s inherit the component's value.
   *
   * @default "m"
   */
  accessor scale: Scale;
  /** Specifies the component's selected items. */
  get selectedItems(): Card[];
  /**
   * Specifies the selection mode of the component.
   *
   * @default "none"
   */
  accessor selectionMode: Extract<"multiple" | "single" | "single-persist" | "none", SelectionMode>;
  /**
   * Sets focus on the component's first focusable element.
   *
   * @param options - When specified an optional object customizes the component's focusing process. When `preventScroll` is `true`, scrolling will not occur on the component.
   * @see [MDN - focus(options)](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus#options)
   */
  setFocus(options?: FocusOptions): Promise<void>;
  /** Fires when the component's selection changes and the `selectionMode` is not `none`. */
  readonly calciteCardGroupSelect: import("@arcgis/lumina").TargetedEvent<this, void>;
  readonly "@eventTypes": {
    calciteCardGroupSelect: CardGroup["calciteCardGroupSelect"]["detail"];
  };
}