@type clipboard_target() :: :general | :find

@type config_state() :: %{
  options: %{required(Minga.Config.Options.option_name()) => term()},
  theme_previews: [theme_preview()],
  keybindings: [keybinding_entry()]
}

@type git_toast() :: %{
  :message => String.t(),
  :level => :success | :error,
  :action => git_toast_action(),
  optional(:dismiss_ref) => reference()
}

@type git_toast_action() :: :pull_and_retry | nil

@type gui_action() ::
  {:select_tab, id :: pos_integer()}
  | {:close_tab, id :: pos_integer()}
  | {:empty_state_activate, item_id :: String.t()}
  | {:file_tree_click, index :: non_neg_integer()}
  | {:file_tree_toggle, index :: non_neg_integer()}
  | {:completion_select, index :: non_neg_integer()}
  | {:breadcrumb_click, segment_index :: non_neg_integer()}
  | {:toggle_panel, panel :: non_neg_integer()}
  | :new_tab
  | {:panel_switch_tab, tab_index :: non_neg_integer()}
  | :panel_dismiss
  | {:panel_resize, height_percent :: non_neg_integer()}
  | {:open_file, path :: String.t()}
  | {:file_tree_new_file, index :: non_neg_integer()}
  | {:file_tree_new_folder, index :: non_neg_integer()}
  | {:file_tree_edit_confirm, text :: String.t()}
  | :file_tree_edit_cancel
  | :file_tree_collapse_all
  | :file_tree_refresh
  | {:agent_tool_toggle, message_id :: non_neg_integer()}
  | {:execute_command, name :: String.t()}
  | {:minibuffer_select, candidate_index :: non_neg_integer()}
  | {:git_stage_file, path :: String.t()}
  | {:git_unstage_file, path :: String.t()}
  | {:git_discard_file, path :: String.t()}
  | :git_stage_all
  | :git_unstage_all
  | {:git_commit, message :: String.t()}
  | {:git_commit, message :: String.t(), amend? :: boolean()}
  | {:git_open_file, path :: String.t()}
  | {:git_open_diff, path :: String.t(), section :: non_neg_integer()}
  | {:workspace_rename, id :: non_neg_integer(), name :: String.t()}
  | {:workspace_set_icon, id :: non_neg_integer(), icon :: String.t()}
  | {:workspace_close, id :: non_neg_integer()}
  | {:space_leader_chord, codepoint :: non_neg_integer(),
     modifiers :: non_neg_integer()}
  | {:space_leader_retract, codepoint :: non_neg_integer(),
     modifiers :: non_neg_integer()}
  | {:find_pasteboard_search, text :: String.t(),
     direction :: non_neg_integer()}
  | :agent_approve
  | :agent_request_changes
  | :agent_dismiss
  | {:change_summary_click, index :: non_neg_integer()}
  | {:file_tree_delete, index :: non_neg_integer()}
  | {:file_tree_rename, index :: non_neg_integer()}
  | {:file_tree_duplicate, index :: non_neg_integer()}
  | {:file_tree_move, source_index :: non_neg_integer(),
     target_dir_index :: non_neg_integer()}
  | {:file_tree_drop, MingaEditor.FileTree.DropIntent.t()}
  | {:fold_toggle_at_line, window_id :: non_neg_integer(),
     buffer_line :: non_neg_integer()}
  | {:file_tree_open_in_split, index :: non_neg_integer()}
  | {:tab_copy_path, id :: pos_integer()}
  | {:tab_reorder, id :: pos_integer(), new_index :: non_neg_integer()}
  | {:tab_pin, id :: pos_integer()}
  | {:tab_unpin, id :: pos_integer()}
  | {:tab_move_left, id :: pos_integer()}
  | {:tab_move_right, id :: pos_integer()}
  | :hover_open_action
  | :system_will_sleep
  | :system_did_wake
  | {:system_will_unmount, volume_path :: String.t()}
  | {:power_thermal_state, low_power? :: boolean(), thermal_state()}
  | :cmd_copy
  | :cmd_cut
  | :git_push
  | :git_pull
  | :git_fetch
  | {:git_commit_amend, message :: String.t()}
  | :git_pull_and_retry
  | {:config_update, Minga.Config.Options.option_name(), term()}
  | :config_query
  | {:notification_dismiss, notification_id :: String.t()}
  | {:notification_action, notification_id :: String.t(),
     action_id :: String.t()}
  | {:observatory_inspect, pid_string :: String.t()}
  | {:font_size_adjust, direction :: :decrease | :increase | :reset}
  | {:picker_query_changed, generation :: non_neg_integer(),
     edit_seq :: non_neg_integer(), query :: String.t()}
  | {:search_query, query :: String.t(), flags :: non_neg_integer()}
  | :search_next
  | :search_prev
  | {:search_replace, replacement :: String.t()}
  | {:search_replace_all, replacement :: String.t()}
  | :search_dismiss
  | {:sidebar_action, sidebar_id :: String.t(), kind :: String.t(),
     action :: String.t()}
  | {:extension_panel_action, ext_name :: String.t(), action_name :: String.t(),
     context :: map()}
  | {:extension_action, extension_id :: String.t(), action :: String.t(),
     payload :: binary()}
  | :float_popup_dismiss
  | :chat_scrolled_away_from_bottom
  | :chat_returned_to_bottom

@type keybinding_entry() :: %{
  mode: String.t(),
  key: String.t(),
  command: String.t(),
  description: String.t()
}

@type theme_preview() :: %{
  name: String.t(),
  atom: String.t(),
  editor_bg: non_neg_integer(),
  editor_fg: non_neg_integer(),
  accent: non_neg_integer()
}

@type thermal_state() ::
  :nominal | :fair | :serious | :critical | {:unknown, non_neg_integer()}