admin-bro/src/frontend/interfaces/action/action-json.interface.ts

import { VariantType } from '@admin-bro/design-system'
import { ParsedLayoutElement } from '../../../backend/utils/layout-element-parser'

/**
 * JSON representation of an {@link Action}
 * @see Action
 * @subcategory Frontend
 */
export interface ActionJSON {
  /**
   * Unique action name
   */
  name: string;
  /**
   * Type of an action
   */
  actionType: 'record' | 'resource' | 'bulk';
  /**
   * Action icon
   */
  icon?: string;
  /**
   * Action label - visible on the frontend
   */
  label: string;
  /**
   * Guarding message which should be presented in `alert()` after clicking the action button
   */
  guard?: string;
  /**
   * If action should have a filter (for resource actions)
   */
  showFilter: boolean;
  /**
   * Action component. When set to false action will be invoked immediately after clicking it,
   * to put in another words: there wont be an action view
   */
  component?: string | false | null;
  /**
   * Whether given action should be seen in a drawer
   */
  showInDrawer: boolean;
  /**
   * Whether given action have an action header
   */
  hideActionHeader: boolean;
  /**
   * containerWidth passed from the action setup.
   */
  containerWidth: string | number | Array<string | number>;
  /**
   * Id of a resource to which given action belongs.
   */
  resourceId: string;

  /**
   * Parsed layout passed in {@link Action#layout}
   */
  layout: Array<ParsedLayoutElement> | null;

  /**
   * action variant
   * @new in version 3.3
   */
  variant: VariantType;

  /**
   * If action is nested
   * @new in version 3.3
   */
  parent: string | null;

  /**
   * Indicates if action has action handler defined
   * @new in version 3.3
   */
  hasHandler: boolean;

  /**
   * Any custom options passed from the {@link Action} configuration.
   * @new in version 3.3
   */
  custom: Record<string, any>;
}