Dialog Interface

/**
 * @deprecated Dialogs are deprecated. Use Block Kit modals instead.
 * @see https://docs.slack.dev/block-kit/upgrading-outmoded-dialogs-to-modals
 */
interface Dialog {
  /** Dialog title displayed to users */
  title: string;
  /** Callback identifier for handling submissions */
  callback_id: string;
  /** Array of form elements */
  elements: DialogElement[];
  /** Custom text for submit button (default: "Submit") */
  submit_label?: string;
  /** Whether to notify when dialog is cancelled */
  notify_on_cancel?: boolean;
  /** Optional state data to include with submissions */
  state?: string;
}

interface DialogElement {
  /** Element type */
  type: 'text' | 'textarea' | 'select';
  /** Element identifier */
  name: string;
  /** Label shown to user */
  label: string;
  /** Whether element is optional */
  optional?: boolean;
  /** Placeholder text */
  placeholder?: string;
  /** Default value */
  value?: string;
  
  // Text and textarea specific
  /** Maximum character length */
  max_length?: number;
  /** Minimum character length */
  min_length?: number;
  /** Help text shown below element */
  hint?: string;
  /** Input validation subtype */
  subtype?: 'email' | 'number' | 'tel' | 'url';
  
  // Select specific  
  /** Data source for select options */
  data_source?: 'users' | 'channels' | 'conversations' | 'external';
  /** Pre-selected options */
  selected_options?: SelectOption[];
  /** Static option list */
  options?: SelectOption[];
  /** Grouped options */
  option_groups?: {
    label: string;
    options: SelectOption[];
  }[];
  /** Minimum characters before external search */
  min_query_length?: number;
}

interface SelectOption {
  /** Option text shown to user */
  label: string;
  /** Option value sent to application */
  value: string;
}

import { Dialog, SelectOption } from "@slack/types";

// Simple text input dialog (DEPRECATED - use modals instead)
const legacyDialog: Dialog = {
  title: "Task Creation",
  callback_id: "create_task_dialog",
  elements: [
    {
      type: "text",
      name: "task_title",
      label: "Task Title",
      placeholder: "Enter task title",
      max_length: 100
    },
    {
      type: "textarea", 
      name: "task_description",
      label: "Description",
      optional: true,
      placeholder: "Describe the task",
      max_length: 500
    },
    {
      type: "select",
      name: "priority",
      label: "Priority",
      options: [
        { label: "Low", value: "low" },
        { label: "Medium", value: "medium" },
        { label: "High", value: "high" }
      ]
    }
  ],
  submit_label: "Create Task"
};

// Modern approach using ModalView
import { ModalView, PlainTextInput, SectionBlock } from "@slack/types";

const modernModal: ModalView = {
  type: "modal",
  title: {
    type: "plain_text",
    text: "Task Creation"
  },
  blocks: [
    {
      type: "input",
      block_id: "task_title",
      label: {
        type: "plain_text", 
        text: "Task Title"
      },
      element: {
        type: "plain_text_input",
        action_id: "title_input",
        placeholder: {
          type: "plain_text",
          text: "Enter task title"
        },
        max_length: 100
      }
    }
    // Add more input blocks as needed
  ],
  submit: {
    type: "plain_text",
    text: "Create Task"
  }
};