alert-interface.ts

import type { OverlayOptions } from '@utils/overlays-interface';

import type { LiteralUnion, TextFieldTypes } from '../../interface';
import type { IonicSafeString } from '../../utils/sanitization';

export interface AlertOptions extends OverlayOptions {
  header?: string;
  subHeader?: string;
  message?: string | IonicSafeString;
  cssClass?: string | string[];
  inputs?: AlertInput[];
  buttons?: (AlertButton | string)[];
  backdropDismiss?: boolean;
  translucent?: boolean;
  htmlAttributes?: { [key: string]: any };

  keyboardClose?: boolean;
}

export interface AlertInput {
  type?: TextFieldTypes | 'checkbox' | 'radio' | 'textarea';
  name?: string;
  placeholder?: string;
  value?: any; // TODO(FW-2832): type
  /**
   * The label text to display next to the input, if the input type is `radio` or `checkbox`.
   */
  label?: string | HTMLElement;
  checked?: boolean;
  disabled?: boolean;
  id?: string;
  handler?: (input: AlertInput) => void;
  min?: string | number;
  max?: string | number;
  cssClass?: string | string[];
  attributes?: { [key: string]: any };
  tabindex?: number;
  startContent?: HTMLElement;
  endContent?: HTMLElement;
  description?: string;
}

type AlertButtonOverlayHandler = boolean | void | { [key: string]: any };

export interface AlertButton {
  text: string;
  role?: LiteralUnion<'cancel' | 'destructive', string>;
  cssClass?: string | string[];
  id?: string;
  htmlAttributes?: { [key: string]: any };
  // TODO(FW-2832): type
  handler?: (value: any) => AlertButtonOverlayHandler | Promise<AlertButtonOverlayHandler>;
}