macos

#!/usr/bin/env bash

set -euo pipefail

DRY_RUN=false
CHOICE=1
SAVE_FILE=''
CONFIG_FILE=''

COMMANDS=()
DESCRIPTIONS=()
SETTINGS=()
RESTART_DOCK=false
RESTART_FINDER=false
RESTART_SYSTEMUISERVER=false

if [ -t 1 ] && [ "${NO_COLOR:-}" = "" ]; then
  BOLD=$(printf '\033[1m')
  DIM=$(printf '\033[2m')
  RED=$(printf '\033[31m')
  GREEN=$(printf '\033[32m')
  YELLOW=$(printf '\033[33m')
  BLUE=$(printf '\033[34m')
  RESET=$(printf '\033[0m')
else
  BOLD=''
  DIM=''
  RED=''
  GREEN=''
  YELLOW=''
  BLUE=''
  RESET=''
fi

usage() {
  cat <<EOF
Usage: ./macos [--dry-run] [--save FILE] [--config FILE]

Options:
  -n, --dry-run  Choose tweaks and print commands without applying them.
  -s, --save     Save selected tweaks to a local config file.
  -c, --config   Load selected tweaks from a local config file.
  -h, --help     Show this help.
EOF
}

info() {
  printf '%s\n' "${BLUE}${BOLD}$1${RESET}"
}

note() {
  printf '%s\n' "${DIM}$1${RESET}"
}

warn() {
  printf '%s\n' "${YELLOW}$1${RESET}"
}

fail() {
  printf '%s\n' "${RED}${BOLD}Error:${RESET} $1" >&2
  exit 1
}

parse_args() {
  while [ "$#" -gt 0 ]; do
    case "$1" in
      -n|--dry-run)
        DRY_RUN=true
        ;;
      -s|--save)
        [ "$#" -gt 1 ] || fail '--save requires a file path.'
        SAVE_FILE=$2
        shift
        ;;
      -c|--config)
        [ "$#" -gt 1 ] || fail '--config requires a file path.'
        CONFIG_FILE=$2
        shift
        ;;
      -h|--help)
        usage
        exit 0
        ;;
      *)
        usage >&2
        exit 2
        ;;
    esac
    shift
  done
}

read_default() {
  local domain=$1 key=$2
  defaults read "$domain" "$key" 2>/dev/null || printf 'not set'
}

read_current_host_default() {
  local domain=$1 key=$2
  defaults -currentHost read "$domain" "$key" 2>/dev/null || printf 'not set'
}

read_system_timezone() {
  local output=
  output=$(systemsetup -gettimezone 2>/dev/null || true)

  case "$output" in
    'Time Zone: '*)
      printf '%s' "${output#Time Zone: }"
      ;;
    *)
      printf 'not set'
      ;;
  esac
}

add_command() {
  local setting=${3:-}

  DESCRIPTIONS+=("$1")
  COMMANDS+=("$2")

  if [ -n "$setting" ]; then
    SETTINGS+=("$setting")
  fi
}

add_setting() {
  local key=$1 value=$2 description=$3 command=$4
  add_command "$description" "$command" "$key=$value"
}

save_config() {
  local save_path=$1 save_dir command line
  save_path=$(expand_user_path "$save_path")
  save_dir=$(dirname "$save_path")
  mkdir -p "$save_dir"

  {
    printf '%s\n' '# Generated by ./macos. Review before reusing on another machine.'
    printf '%s\n' '# Format: scope:domain:key=type:value'
    for command in "${COMMANDS[@]}"; do
      while IFS= read -r line; do
        [ -n "$line" ] && printf '%s\n' "$line"
      done < <(command_to_config "$command")
    done
  } >"$save_path"

  printf '%s\n' "${GREEN}[OK]${RESET} Saved selected tweaks to $save_path"
}

command_to_config() {
  local command=$1 part
  local parts=()

  IFS=';' read -ra parts <<<"$command"
  for part in "${parts[@]}"; do
    part=${part#"${part%%[![:space:]]*}"}
    part=${part%"${part##*[![:space:]]}"}
    command_part_to_config "$part"
  done
}

command_part_to_config() {
  local part=$1 scope domain key type value values

  [ -n "$part" ] || return 0

  eval "set -- $part"

  if [ "${1:-}" = "sudo" ] && [ "${2:-}" = "systemsetup" ] && [ "${3:-}" = "-settimezone" ]; then
    printf '%s=%s\n' 'system:timezone' "${4:-}"
    return 0
  fi

  if [ "${1:-}" = "defaults" ] && [ "${2:-}" = "delete" ]; then
    printf 'defaults-delete:%s:%s=true\n' "$3" "$4"
    return 0
  fi

  scope=defaults
  if [ "${1:-}" = "defaults" ] && [ "${2:-}" = "-currentHost" ] && [ "${3:-}" = "write" ]; then
    scope=currentHost
    shift 3
  elif [ "${1:-}" = "defaults" ] && [ "${2:-}" = "write" ]; then
    shift 2
  else
    return 0
  fi

  domain=${1:-}
  key=${2:-}
  type=${3:-}
  shift 3 || true

  case "$domain" in
    */com.apple.universalaccess.plist)
      domain=com.apple.universalaccess
      ;;
  esac

  case "$type" in
    -bool|-boolean)
      printf '%s:%s:%s=bool:%s\n' "$scope" "$domain" "$key" "$1"
      ;;
    -int)
      printf '%s:%s:%s=int:%s\n' "$scope" "$domain" "$key" "$1"
      ;;
    -float)
      printf '%s:%s:%s=float:%s\n' "$scope" "$domain" "$key" "$1"
      ;;
    -string)
      printf '%s:%s:%s=string:%s\n' "$scope" "$domain" "$key" "$1"
      ;;
    -array)
      values=$(printf '%s|' "$@")
      values=${values%|}
      printf '%s:%s:%s=array:%s\n' "$scope" "$domain" "$key" "$values"
      ;;
  esac
}

load_config_file() {
  local config_path=$1 line key value
  config_path=$(expand_user_path "$config_path")
  [ -f "$config_path" ] || fail "Config file not found: $config_path"

  while IFS= read -r line || [ -n "$line" ]; do
    case "$line" in
      ''|'#'*)
        continue
        ;;
    esac

    key=${line%%=*}
    value=${line#*=}
    add_config_setting "$key" "$value"
  done <"$config_path"
}

add_config_setting() {
  local key=$1 value=$2 scope domain defaults_key type raw command description item
  local quoted_value array_values

  if [ "$key" = "system:timezone" ]; then
    quoted_value=$(shell_quote "$value")
    add_command "Set timezone to $value" "sudo systemsetup -settimezone $quoted_value >/dev/null"
    return
  fi

  IFS=':' read -r scope domain defaults_key <<<"$key"

  if [ "$scope" = "defaults-delete" ]; then
    add_command "Delete $domain $defaults_key" "defaults delete $domain $defaults_key 2>/dev/null || true"
    set_restart_for_domain "$domain"
    return
  fi

  type=${value%%:*}
  raw=${value#*:}

  case "$type" in
    bool)
      command="defaults write $domain $defaults_key -bool $raw"
      ;;
    int)
      command="defaults write $domain $defaults_key -int $raw"
      ;;
    float)
      command="defaults write $domain $defaults_key -float $raw"
      ;;
    string)
      quoted_value=$(shell_quote "$raw")
      command="defaults write $domain $defaults_key -string $quoted_value"
      if [ "$domain" = "com.apple.screencapture" ] && [ "$defaults_key" = "location" ]; then
        command="mkdir -p $quoted_value; $command"
      fi
      ;;
    array)
      command="defaults write $domain $defaults_key -array"
      IFS='|' read -ra array_values <<<"$raw"
      for item in "${array_values[@]}"; do
        quoted_value=$(shell_quote "$item")
        command="$command $quoted_value"
      done
      ;;
    *)
      warn "Skipping unknown config value: $key=$value"
      return
      ;;
  esac

  if [ "$domain" = "com.apple.universalaccess" ]; then
    command=${command/defaults write com.apple.universalaccess/defaults write \"\$HOME\/Library\/Preferences\/com.apple.universalaccess.plist\"}
  fi

  if [ "$scope" = "currentHost" ]; then
    command=${command/defaults write/defaults -currentHost write}
  elif [ "$scope" != "defaults" ]; then
    warn "Skipping unknown config scope: $key"
    return
  fi

  description="Set $domain $defaults_key to $raw"
  if [ "$domain" = "com.apple.universalaccess" ]; then
    case "$defaults_key" in
      closeViewScrollWheelToggle)
        if [ "$raw" = "true" ]; then
          description='Enable scroll gesture zoom'
        else
          description='Disable scroll gesture zoom'
        fi
        ;;
      HIDScrollZoomModifierMask)
        description="Set scroll gesture zoom modifier to $(modifier_label "$raw")"
        ;;
      closeViewZoomFollowsFocus)
        if [ "$raw" = "true" ]; then
          description='Follow keyboard focus while zoomed in'
        else
          description='Do not follow keyboard focus while zoomed in'
        fi
        ;;
    esac
  fi
  add_command "$description" "$command" "$key=$value"
  set_restart_for_domain "$domain"
}

set_restart_for_domain() {
  case "$1" in
    com.apple.dock)
      RESTART_DOCK=true
      ;;
    com.apple.finder)
      RESTART_FINDER=true
      ;;
    com.apple.screencapture)
      RESTART_SYSTEMUISERVER=true
      ;;
  esac
}

shell_quote() {
  printf '%q' "$1"
}

expand_user_path() {
  case "$1" in
    '~')
      printf '%s' "$HOME"
      ;;
    '~/'*)
      printf '%s/%s' "$HOME" "${1#\~/}"
      ;;
    *)
      printf '%s' "$1"
      ;;
  esac
}

ask_choice() {
  local prompt=$1 current=$2
  shift 2
  local options=("$@")
  local choice=

  printf '\n%s\n' "${BOLD}$prompt${RESET}"
  printf '%s\n' "${DIM}Current: $current${RESET}"

  local i=1
  for option in "${options[@]}"; do
    printf '  %s) %s\n' "$i" "$option"
    i=$((i + 1))
  done

  while true; do
    printf 'Selection [1]: '
    read -r choice
    choice=${choice:-1}

    case "$choice" in
      ''|*[!0-9]*)
        warn "Choose a number between 1 and ${#options[@]}."
        ;;
      *)
        if [ "$choice" -ge 1 ] && [ "$choice" -le "${#options[@]}" ]; then
          CHOICE=$choice
          return 0
        fi
        warn "Choose a number between 1 and ${#options[@]}."
        ;;
    esac
  done
}

confirm() {
  local prompt=$1 answer=

  while true; do
    printf '%s [y/N]: ' "$prompt"
    read -r answer
    case "$answer" in
      y|Y|yes|YES)
        return 0
        ;;
      ''|n|N|no|NO)
        return 1
        ;;
      *)
        warn 'Please answer y or n.'
        ;;
    esac
  done
}

configure_language_timezone() {
  local timezone quoted_timezone languages locale

  info 'Language and Timezone'

  languages=$(read_default NSGlobalDomain AppleLanguages)
  locale=$(read_default NSGlobalDomain AppleLocale)

  ask_choice 'Language and locale' "languages: $languages, locale: $locale" \
    'Keep current setting' \
    'English US + Portuguese Brazil, en_US locale' \
    'Custom primary language and locale'
  case "$CHOICE" in
    2)
      add_command 'Set languages to English US and Portuguese Brazil' 'defaults write NSGlobalDomain AppleLanguages -array "en-US" "pt_BR"; defaults write NSGlobalDomain AppleLocale -string "en_US"'
      ;;
    3)
      local primary_language=
      local custom_locale=
      local quoted_language=
      local quoted_locale=
      printf 'Primary language, for example en-US: '
      read -r primary_language
      [ -n "$primary_language" ] || fail 'Primary language cannot be empty.'
      printf 'Locale, for example en_US: '
      read -r custom_locale
      [ -n "$custom_locale" ] || fail 'Locale cannot be empty.'
      quoted_language=$(shell_quote "$primary_language")
      quoted_locale=$(shell_quote "$custom_locale")
      add_command "Set language to $primary_language and locale to $custom_locale" "defaults write NSGlobalDomain AppleLanguages -array $quoted_language; defaults write NSGlobalDomain AppleLocale -string $quoted_locale"
      ;;
  esac

  ask_choice 'Timezone' "$(read_system_timezone)" \
    'Keep current setting' \
    'America/Sao_Paulo' \
    'Custom timezone'
  case "$CHOICE" in
    2)
      add_command 'Set timezone to America/Sao_Paulo' 'sudo systemsetup -settimezone "America/Sao_Paulo" >/dev/null'
      ;;
    3)
      printf 'Timezone, for example America/Sao_Paulo: '
      read -r timezone
      [ -n "$timezone" ] || fail 'Timezone cannot be empty.'
      quoted_timezone=$(shell_quote "$timezone")
      add_command "Set timezone to $timezone" "sudo systemsetup -settimezone $quoted_timezone >/dev/null"
      ;;
  esac
}

configure_keyboard() {
  info 'Keyboard'

  ask_choice 'Key repeat speed' "$(read_default NSGlobalDomain KeyRepeat)" \
    'Keep current setting' \
    'macOS default' \
    'Fast' \
    'Very fast' \
    'Custom value'
  case "$CHOICE" in
    2)
      add_command 'Set key repeat speed to macOS default' 'defaults delete NSGlobalDomain KeyRepeat 2>/dev/null || true'
      ;;
    3)
      add_command 'Set key repeat speed to fast' 'defaults write NSGlobalDomain KeyRepeat -int 2'
      ;;
    4)
      add_command 'Set key repeat speed to very fast' 'defaults write NSGlobalDomain KeyRepeat -int 1'
      ;;
    5)
      local value=
      printf 'Custom KeyRepeat value: '
      read -r value
      [[ "$value" =~ ^[0-9]+$ ]] || fail 'KeyRepeat must be a number.'
      add_command "Set key repeat speed to $value" "defaults write NSGlobalDomain KeyRepeat -int $value"
      ;;
  esac

  ask_choice 'Initial key repeat delay' "$(read_default NSGlobalDomain InitialKeyRepeat)" \
    'Keep current setting' \
    'macOS default' \
    'Short' \
    'Very short' \
    'Custom value'
  case "$CHOICE" in
    2)
      add_command 'Set initial key repeat delay to macOS default' 'defaults delete NSGlobalDomain InitialKeyRepeat 2>/dev/null || true'
      ;;
    3)
      add_command 'Set initial key repeat delay to short' 'defaults write NSGlobalDomain InitialKeyRepeat -int 15'
      ;;
    4)
      add_command 'Set initial key repeat delay to very short' 'defaults write NSGlobalDomain InitialKeyRepeat -int 10'
      ;;
    5)
      local value=
      printf 'Custom InitialKeyRepeat value: '
      read -r value
      [[ "$value" =~ ^[0-9]+$ ]] || fail 'InitialKeyRepeat must be a number.'
      add_command "Set initial key repeat delay to $value" "defaults write NSGlobalDomain InitialKeyRepeat -int $value"
      ;;
  esac

  ask_choice 'Press and hold accent popup' "$(read_default NSGlobalDomain ApplePressAndHoldEnabled)" \
    'Keep current setting' \
    'Enable accents' \
    'Disable accents for faster key repeat'
  case "$CHOICE" in
    2)
      add_command 'Enable press-and-hold accents' 'defaults write NSGlobalDomain ApplePressAndHoldEnabled -bool true'
      ;;
    3)
      add_command 'Disable press-and-hold accents' 'defaults write NSGlobalDomain ApplePressAndHoldEnabled -bool false'
      ;;
  esac

  ask_choice 'Use F1, F2, etc. as standard function keys' "$(read_default NSGlobalDomain com.apple.keyboard.fnState)" \
    'Keep current setting' \
    'Enable standard function keys' \
    'Use media/special keys by default'
  case "$CHOICE" in
    2)
      add_command 'Use F1, F2, etc. as standard function keys' 'defaults write -g com.apple.keyboard.fnState -bool true'
      ;;
    3)
      add_command 'Use media/special keys by default' 'defaults write -g com.apple.keyboard.fnState -bool false'
      ;;
  esac
}

modifier_label() {
  case "$1" in
    0) printf 'No modifier' ;;
    131072) printf 'Shift' ;;
    262144) printf 'Control' ;;
    524288) printf 'Option' ;;
    1048576) printf 'Command' ;;
    *) printf 'Custom value %s' "$1" ;;
  esac
}

configure_accessibility() {
  local zoom_enabled zoom_modifier

  info 'Accessibility'

  zoom_enabled=$(read_default com.apple.universalaccess closeViewScrollWheelToggle)
  zoom_modifier=$(read_default com.apple.universalaccess HIDScrollZoomModifierMask)

  ask_choice 'Use scroll gesture with modifier key to zoom' "enabled: $zoom_enabled, modifier: $(modifier_label "$zoom_modifier") ($zoom_modifier)" \
    'Keep current setting' \
    'Enable with Control' \
    'Enable with Option' \
    'Enable with Command' \
    'Enable with Shift' \
    'Disable'
  case "$CHOICE" in
    2)
      add_command 'Enable scroll gesture zoom with Control' 'defaults write "$HOME/Library/Preferences/com.apple.universalaccess.plist" closeViewScrollWheelToggle -bool true; defaults write "$HOME/Library/Preferences/com.apple.universalaccess.plist" HIDScrollZoomModifierMask -int 262144'
      ;;
    3)
      add_command 'Enable scroll gesture zoom with Option' 'defaults write "$HOME/Library/Preferences/com.apple.universalaccess.plist" closeViewScrollWheelToggle -bool true; defaults write "$HOME/Library/Preferences/com.apple.universalaccess.plist" HIDScrollZoomModifierMask -int 524288'
      ;;
    4)
      add_command 'Enable scroll gesture zoom with Command' 'defaults write "$HOME/Library/Preferences/com.apple.universalaccess.plist" closeViewScrollWheelToggle -bool true; defaults write "$HOME/Library/Preferences/com.apple.universalaccess.plist" HIDScrollZoomModifierMask -int 1048576'
      ;;
    5)
      add_command 'Enable scroll gesture zoom with Shift' 'defaults write "$HOME/Library/Preferences/com.apple.universalaccess.plist" closeViewScrollWheelToggle -bool true; defaults write "$HOME/Library/Preferences/com.apple.universalaccess.plist" HIDScrollZoomModifierMask -int 131072'
      ;;
    6)
      add_command 'Disable scroll gesture zoom' 'defaults write "$HOME/Library/Preferences/com.apple.universalaccess.plist" closeViewScrollWheelToggle -bool false'
      ;;
  esac

  ask_choice 'Follow keyboard focus while zoomed in' "$(read_default com.apple.universalaccess closeViewZoomFollowsFocus)" \
    'Keep current setting' \
    'Follow keyboard focus while zoomed' \
    'Do not follow keyboard focus while zoomed'
  case "$CHOICE" in
    2)
      add_command 'Follow keyboard focus while zoomed in' 'defaults write "$HOME/Library/Preferences/com.apple.universalaccess.plist" closeViewZoomFollowsFocus -bool true'
      ;;
    3)
      add_command 'Do not follow keyboard focus while zoomed in' 'defaults write "$HOME/Library/Preferences/com.apple.universalaccess.plist" closeViewZoomFollowsFocus -bool false'
      ;;
  esac
}

configure_finder() {
  info 'Finder'

  ask_choice 'Finder status bar' "$(read_default com.apple.finder ShowStatusBar)" \
    'Keep current setting' \
    'Show status bar' \
    'Hide status bar'
  case "$CHOICE" in
    2)
      add_command 'Show Finder status bar' 'defaults write com.apple.finder ShowStatusBar -bool true'
      RESTART_FINDER=true
      ;;
    3)
      add_command 'Hide Finder status bar' 'defaults write com.apple.finder ShowStatusBar -bool false'
      RESTART_FINDER=true
      ;;
  esac

  ask_choice 'Show hidden files' "$(read_default com.apple.finder AppleShowAllFiles)" \
    'Keep current setting' \
    'Show hidden files' \
    'Hide hidden files'
  case "$CHOICE" in
    2)
      add_command 'Show hidden files in Finder' 'defaults write com.apple.finder AppleShowAllFiles -bool true'
      RESTART_FINDER=true
      ;;
    3)
      add_command 'Hide hidden files in Finder' 'defaults write com.apple.finder AppleShowAllFiles -bool false'
      RESTART_FINDER=true
      ;;
  esac

  ask_choice 'Show filename extensions' "$(read_default NSGlobalDomain AppleShowAllExtensions)" \
    'Keep current setting' \
    'Show all extensions' \
    'Hide extensions'
  case "$CHOICE" in
    2)
      add_command 'Show all filename extensions' 'defaults write NSGlobalDomain AppleShowAllExtensions -bool true'
      RESTART_FINDER=true
      ;;
    3)
      add_command 'Hide filename extensions' 'defaults write NSGlobalDomain AppleShowAllExtensions -bool false'
      RESTART_FINDER=true
      ;;
  esac

  ask_choice 'Finder path bar' "$(read_default com.apple.finder ShowPathbar)" \
    'Keep current setting' \
    'Show path bar' \
    'Hide path bar'
  case "$CHOICE" in
    2)
      add_command 'Show Finder path bar' 'defaults write com.apple.finder ShowPathbar -bool true'
      RESTART_FINDER=true
      ;;
    3)
      add_command 'Hide Finder path bar' 'defaults write com.apple.finder ShowPathbar -bool false'
      RESTART_FINDER=true
      ;;
  esac

  ask_choice 'Full POSIX path as Finder window title' "$(read_default com.apple.finder _FXShowPosixPathInTitle)" \
    'Keep current setting' \
    'Show full path in title' \
    'Hide full path in title'
  case "$CHOICE" in
    2)
      add_command 'Show full POSIX path in Finder window title' 'defaults write com.apple.finder _FXShowPosixPathInTitle -bool true'
      RESTART_FINDER=true
      ;;
    3)
      add_command 'Hide full POSIX path in Finder window title' 'defaults write com.apple.finder _FXShowPosixPathInTitle -bool false'
      RESTART_FINDER=true
      ;;
  esac

  ask_choice 'Folders first when sorting by name' "$(read_default com.apple.finder _FXSortFoldersFirst)" \
    'Keep current setting' \
    'Keep folders on top' \
    'Mix folders with files'
  case "$CHOICE" in
    2)
      add_command 'Keep folders on top when sorting by name' 'defaults write com.apple.finder _FXSortFoldersFirst -bool true'
      RESTART_FINDER=true
      ;;
    3)
      add_command 'Mix folders with files when sorting by name' 'defaults write com.apple.finder _FXSortFoldersFirst -bool false'
      RESTART_FINDER=true
      ;;
  esac

  ask_choice 'Default location for new Finder windows' "$(read_default com.apple.finder NewWindowTarget)" \
    'Keep current setting' \
    'Desktop' \
    'Home folder' \
    'Documents' \
    'Custom path'
  case "$CHOICE" in
    2)
      add_command 'Open new Finder windows at Desktop' 'defaults write com.apple.finder NewWindowTarget -string "PfDe"; defaults write com.apple.finder NewWindowTargetPath -string "file://${HOME}/Desktop/"'
      RESTART_FINDER=true
      ;;
    3)
      add_command 'Open new Finder windows at Home' 'defaults write com.apple.finder NewWindowTarget -string "PfHm"; defaults write com.apple.finder NewWindowTargetPath -string "file://${HOME}/"'
      RESTART_FINDER=true
      ;;
    4)
      add_command 'Open new Finder windows at Documents' 'defaults write com.apple.finder NewWindowTarget -string "PfDo"; defaults write com.apple.finder NewWindowTargetPath -string "file://${HOME}/Documents/"'
      RESTART_FINDER=true
      ;;
    5)
      local path=
      local quoted_url=
      printf 'Custom Finder path: '
      read -r path
      [ -n "$path" ] || fail 'Finder path cannot be empty.'
      path=$(expand_user_path "$path")
      quoted_url=$(shell_quote "file://$path/")
      add_command "Open new Finder windows at $path" "defaults write com.apple.finder NewWindowTarget -string PfLo; defaults write com.apple.finder NewWindowTargetPath -string $quoted_url"
      RESTART_FINDER=true
      ;;
  esac

  ask_choice 'Finder search scope' "$(read_default com.apple.finder FXDefaultSearchScope)" \
    'Keep current setting' \
    'Search current folder by default' \
    'Search this Mac by default' \
    'Use previous search scope'
  case "$CHOICE" in
    2)
      add_command 'Search current folder by default in Finder' 'defaults write com.apple.finder FXDefaultSearchScope -string "SCcf"'
      RESTART_FINDER=true
      ;;
    3)
      add_command 'Search this Mac by default in Finder' 'defaults write com.apple.finder FXDefaultSearchScope -string "SCev"'
      RESTART_FINDER=true
      ;;
    4)
      add_command 'Use previous Finder search scope' 'defaults write com.apple.finder FXDefaultSearchScope -string "SCsp"'
      RESTART_FINDER=true
      ;;
  esac

  ask_choice 'Warning when changing file extension' "$(read_default com.apple.finder FXEnableExtensionChangeWarning)" \
    'Keep current setting' \
    'Show warning' \
    'Disable warning'
  case "$CHOICE" in
    2)
      add_command 'Show warning when changing a file extension' 'defaults write com.apple.finder FXEnableExtensionChangeWarning -bool true'
      RESTART_FINDER=true
      ;;
    3)
      add_command 'Disable warning when changing a file extension' 'defaults write com.apple.finder FXEnableExtensionChangeWarning -bool false'
      RESTART_FINDER=true
      ;;
  esac

  ask_choice 'Create .DS_Store files on network volumes' "$(read_default com.apple.desktopservices DSDontWriteNetworkStores)" \
    'Keep current setting' \
    'Allow .DS_Store on network volumes' \
    'Avoid .DS_Store on network volumes'
  case "$CHOICE" in
    2)
      add_command 'Allow .DS_Store files on network volumes' 'defaults write com.apple.desktopservices DSDontWriteNetworkStores -bool false'
      ;;
    3)
      add_command 'Avoid .DS_Store files on network volumes' 'defaults write com.apple.desktopservices DSDontWriteNetworkStores -bool true'
      ;;
  esac

  ask_choice 'Create .DS_Store files on USB volumes' "$(read_default com.apple.desktopservices DSDontWriteUSBStores)" \
    'Keep current setting' \
    'Allow .DS_Store on USB volumes' \
    'Avoid .DS_Store on USB volumes'
  case "$CHOICE" in
    2)
      add_command 'Allow .DS_Store files on USB volumes' 'defaults write com.apple.desktopservices DSDontWriteUSBStores -bool false'
      ;;
    3)
      add_command 'Avoid .DS_Store files on USB volumes' 'defaults write com.apple.desktopservices DSDontWriteUSBStores -bool true'
      ;;
  esac

  ask_choice 'Default Finder view style' "$(read_default com.apple.finder FXPreferredViewStyle)" \
    'Keep current setting' \
    'Icon view' \
    'List view' \
    'Column view' \
    'Gallery view'
  case "$CHOICE" in
    2)
      add_command 'Use icon view in Finder by default' 'defaults write com.apple.finder FXPreferredViewStyle -string "icnv"'
      RESTART_FINDER=true
      ;;
    3)
      add_command 'Use list view in Finder by default' 'defaults write com.apple.finder FXPreferredViewStyle -string "Nlsv"'
      RESTART_FINDER=true
      ;;
    4)
      add_command 'Use column view in Finder by default' 'defaults write com.apple.finder FXPreferredViewStyle -string "clmv"'
      RESTART_FINDER=true
      ;;
    5)
      add_command 'Use gallery view in Finder by default' 'defaults write com.apple.finder FXPreferredViewStyle -string "glyv"'
      RESTART_FINDER=true
      ;;
  esac

  ask_choice 'Save new documents to iCloud by default' "$(read_default NSGlobalDomain NSDocumentSaveNewDocumentsToCloud)" \
    'Keep current setting' \
    'Save to iCloud by default' \
    'Save to disk by default'
  case "$CHOICE" in
    2)
      add_command 'Save new documents to iCloud by default' 'defaults write NSGlobalDomain NSDocumentSaveNewDocumentsToCloud -bool true'
      ;;
    3)
      add_command 'Save new documents to disk by default' 'defaults write NSGlobalDomain NSDocumentSaveNewDocumentsToCloud -bool false'
      ;;
  esac

  ask_choice 'Desktop drive and server icons' "external: $(read_default com.apple.finder ShowExternalHardDrivesOnDesktop), hard drives: $(read_default com.apple.finder ShowHardDrivesOnDesktop), servers: $(read_default com.apple.finder ShowMountedServersOnDesktop), removable: $(read_default com.apple.finder ShowRemovableMediaOnDesktop)" \
    'Keep current setting' \
    'Show hard drives, servers, and removable media' \
    'Hide hard drives, servers, and removable media'
  case "$CHOICE" in
    2)
      add_command 'Show drive, server, and removable media icons on Desktop' 'defaults write com.apple.finder ShowExternalHardDrivesOnDesktop -bool true; defaults write com.apple.finder ShowHardDrivesOnDesktop -bool true; defaults write com.apple.finder ShowMountedServersOnDesktop -bool true; defaults write com.apple.finder ShowRemovableMediaOnDesktop -bool true'
      RESTART_FINDER=true
      ;;
    3)
      add_command 'Hide drive, server, and removable media icons on Desktop' 'defaults write com.apple.finder ShowExternalHardDrivesOnDesktop -bool false; defaults write com.apple.finder ShowHardDrivesOnDesktop -bool false; defaults write com.apple.finder ShowMountedServersOnDesktop -bool false; defaults write com.apple.finder ShowRemovableMediaOnDesktop -bool false'
      RESTART_FINDER=true
      ;;
  esac
}

configure_dock() {
  info 'Dock'

  ask_choice 'Dock autohide' "$(read_default com.apple.dock autohide)" \
    'Keep current setting' \
    'Enable autohide' \
    'Disable autohide'
  case "$CHOICE" in
    2)
      add_command 'Enable Dock autohide' 'defaults write com.apple.dock autohide -bool true'
      RESTART_DOCK=true
      ;;
    3)
      add_command 'Disable Dock autohide' 'defaults write com.apple.dock autohide -bool false'
      RESTART_DOCK=true
      ;;
  esac

  ask_choice 'Minimize windows using' "$(read_default com.apple.dock mineffect)" \
    'Keep current setting' \
    'Genie effect' \
    'Scale effect'
  case "$CHOICE" in
    2)
      add_command 'Use Genie minimize effect' 'defaults write com.apple.dock mineffect -string genie'
      RESTART_DOCK=true
      ;;
    3)
      add_command 'Use Scale minimize effect' 'defaults write com.apple.dock mineffect -string scale'
      RESTART_DOCK=true
      ;;
  esac

  ask_choice 'Dock icon size' "$(read_default com.apple.dock tilesize)" \
    'Keep current setting' \
    '36 px' \
    '48 px' \
    '64 px' \
    'Custom size'
  case "$CHOICE" in
    2)
      add_command 'Set Dock icon size to 36 px' 'defaults write com.apple.dock tilesize -int 36'
      RESTART_DOCK=true
      ;;
    3)
      add_command 'Set Dock icon size to 48 px' 'defaults write com.apple.dock tilesize -int 48'
      RESTART_DOCK=true
      ;;
    4)
      add_command 'Set Dock icon size to 64 px' 'defaults write com.apple.dock tilesize -int 64'
      RESTART_DOCK=true
      ;;
    5)
      local size=
      printf 'Dock icon size: '
      read -r size
      [[ "$size" =~ ^[0-9]+$ ]] || fail 'Dock icon size must be a number.'
      add_command "Set Dock icon size to $size px" "defaults write com.apple.dock tilesize -int $size"
      RESTART_DOCK=true
      ;;
  esac

  ask_choice 'Dock magnification' "$(read_default com.apple.dock magnification)" \
    'Keep current setting' \
    'Enable magnification' \
    'Disable magnification'
  case "$CHOICE" in
    2)
      add_command 'Enable Dock magnification' 'defaults write com.apple.dock magnification -bool true'
      RESTART_DOCK=true
      ;;
    3)
      add_command 'Disable Dock magnification' 'defaults write com.apple.dock magnification -bool false'
      RESTART_DOCK=true
      ;;
  esac

  ask_choice 'Dock magnification size' "$(read_default com.apple.dock largesize)" \
    'Keep current setting' \
    '96 px' \
    '128 px' \
    '160 px' \
    'Custom size'
  case "$CHOICE" in
    2)
      add_command 'Set Dock magnification size to 96 px' 'defaults write com.apple.dock largesize -int 96'
      RESTART_DOCK=true
      ;;
    3)
      add_command 'Set Dock magnification size to 128 px' 'defaults write com.apple.dock largesize -int 128'
      RESTART_DOCK=true
      ;;
    4)
      add_command 'Set Dock magnification size to 160 px' 'defaults write com.apple.dock largesize -int 160'
      RESTART_DOCK=true
      ;;
    5)
      local size=
      printf 'Dock magnification size: '
      read -r size
      [[ "$size" =~ ^[0-9]+$ ]] || fail 'Dock magnification size must be a number.'
      add_command "Set Dock magnification size to $size px" "defaults write com.apple.dock largesize -int $size"
      RESTART_DOCK=true
      ;;
  esac

  ask_choice 'Recent applications in Dock' "$(read_default com.apple.dock show-recents)" \
    'Keep current setting' \
    'Show recent applications' \
    'Hide recent applications'
  case "$CHOICE" in
    2)
      add_command 'Show recent applications in Dock' 'defaults write com.apple.dock show-recents -bool true'
      RESTART_DOCK=true
      ;;
    3)
      add_command 'Hide recent applications in Dock' 'defaults write com.apple.dock show-recents -bool false'
      RESTART_DOCK=true
      ;;
  esac
}

configure_mission_control() {
  info 'Mission Control'

  ask_choice 'Mission Control animation speed' "$(read_default com.apple.dock expose-animation-duration)" \
    'Keep current setting' \
    'macOS default' \
    'Fast, 0.1 seconds' \
    'Custom duration'
  case "$CHOICE" in
    2)
      add_command 'Restore default Mission Control animation speed' 'defaults delete com.apple.dock expose-animation-duration 2>/dev/null || true'
      RESTART_DOCK=true
      ;;
    3)
      add_command 'Speed up Mission Control animations' 'defaults write com.apple.dock expose-animation-duration -float 0.1'
      RESTART_DOCK=true
      ;;
    4)
      local duration=
      printf 'Animation duration in seconds, for example 0.1: '
      read -r duration
      [[ "$duration" =~ ^[0-9]+([.][0-9]+)?$ ]] || fail 'Animation duration must be a number.'
      add_command "Set Mission Control animation duration to $duration seconds" "defaults write com.apple.dock expose-animation-duration -float $duration"
      RESTART_DOCK=true
      ;;
  esac

  ask_choice 'Dashboard as a Space' "$(read_default com.apple.dock dashboard-in-overlay)" \
    'Keep current setting' \
    'Do not show Dashboard as a Space' \
    'Show Dashboard as a Space'
  case "$CHOICE" in
    2)
      add_command 'Do not show Dashboard as a Space' 'defaults write com.apple.dock dashboard-in-overlay -bool true'
      RESTART_DOCK=true
      ;;
    3)
      add_command 'Show Dashboard as a Space' 'defaults write com.apple.dock dashboard-in-overlay -bool false'
      RESTART_DOCK=true
      ;;
  esac

  ask_choice 'Automatically rearrange Spaces' "$(read_default com.apple.dock mru-spaces)" \
    'Keep current setting' \
    'Automatically rearrange Spaces by recent use' \
    'Keep Spaces order fixed'
  case "$CHOICE" in
    2)
      add_command 'Automatically rearrange Spaces by recent use' 'defaults write com.apple.dock mru-spaces -bool true'
      RESTART_DOCK=true
      ;;
    3)
      add_command 'Keep Spaces order fixed' 'defaults write com.apple.dock mru-spaces -bool false'
      RESTART_DOCK=true
      ;;
  esac
}

hot_corner_action_label() {
  case "$1" in
    0) printf 'No action' ;;
    2) printf 'Mission Control' ;;
    3) printf 'Application Windows' ;;
    4) printf 'Desktop' ;;
    5) printf 'Start Screen Saver' ;;
    6) printf 'Disable Screen Saver' ;;
    7) printf 'Dashboard' ;;
    10) printf 'Put Display to Sleep' ;;
    11) printf 'Launchpad' ;;
    12) printf 'Notification Center' ;;
    13) printf 'Lock Screen' ;;
    14) printf 'Quick Note' ;;
    *) printf 'Custom value %s' "$1" ;;
  esac
}

configure_hot_corner() {
  local label=$1 key=$2 modifier_key=$3 current action modifier
  current=$(read_default com.apple.dock "$key")

  ask_choice "$label hot corner" "$(hot_corner_action_label "$current") ($current)" \
    'Keep current setting' \
    'No action' \
    'Mission Control' \
    'Application Windows' \
    'Desktop' \
    'Start Screen Saver' \
    'Disable Screen Saver' \
    'Dashboard' \
    'Put Display to Sleep' \
    'Launchpad' \
    'Notification Center' \
    'Lock Screen' \
    'Quick Note' \
    'Custom value'

  case "$CHOICE" in
    1) return ;;
    2) action=0 ;;
    3) action=2 ;;
    4) action=3 ;;
    5) action=4 ;;
    6) action=5 ;;
    7) action=6 ;;
    8) action=7 ;;
    9) action=10 ;;
    10) action=11 ;;
    11) action=12 ;;
    12) action=13 ;;
    13) action=14 ;;
    14)
      printf 'Custom hot corner action value: '
      read -r action
      [[ "$action" =~ ^[0-9]+$ ]] || fail 'Hot corner action must be a number.'
      ;;
  esac

  ask_choice "$label hot corner modifier key" "$(read_default com.apple.dock "$modifier_key")" \
    'Keep current setting' \
    'No modifier' \
    'Command' \
    'Option' \
    'Control' \
    'Shift'
  case "$CHOICE" in
    1) modifier= ;;
    2) modifier=0 ;;
    3) modifier=1048576 ;;
    4) modifier=524288 ;;
    5) modifier=262144 ;;
    6) modifier=131072 ;;
  esac

  add_command "Set $label hot corner to $(hot_corner_action_label "$action")" "defaults write com.apple.dock $key -int $action"
  if [ -n "$modifier" ]; then
    add_command "Set $label hot corner modifier" "defaults write com.apple.dock $modifier_key -int $modifier"
  fi
  RESTART_DOCK=true
}

configure_hot_corners() {
  info 'Hot Corners'
  configure_hot_corner 'Top left' wvous-tl-corner wvous-tl-modifier
  configure_hot_corner 'Top right' wvous-tr-corner wvous-tr-modifier
  configure_hot_corner 'Bottom left' wvous-bl-corner wvous-bl-modifier
  configure_hot_corner 'Bottom right' wvous-br-corner wvous-br-modifier
}

configure_trackpad() {
  info 'Trackpad'

  ask_choice 'Tap to click' "user: $(read_default com.apple.driver.AppleBluetoothMultitouch.trackpad Clicking), current host: $(read_current_host_default NSGlobalDomain com.apple.mouse.tapBehavior), global: $(read_default NSGlobalDomain com.apple.mouse.tapBehavior)" \
    'Keep current setting' \
    'Enable tap to click for user and login screen' \
    'Disable tap to click'
  case "$CHOICE" in
    2)
      add_command 'Enable tap to click for user and login screen' 'defaults write com.apple.driver.AppleBluetoothMultitouch.trackpad Clicking -bool true; defaults -currentHost write NSGlobalDomain com.apple.mouse.tapBehavior -int 1; defaults write NSGlobalDomain com.apple.mouse.tapBehavior -int 1'
      ;;
    3)
      add_command 'Disable tap to click' 'defaults write com.apple.driver.AppleBluetoothMultitouch.trackpad Clicking -bool false; defaults -currentHost write NSGlobalDomain com.apple.mouse.tapBehavior -int 0; defaults write NSGlobalDomain com.apple.mouse.tapBehavior -int 0'
      ;;
  esac

  ask_choice 'Trackpad right-click behavior' "corner: $(read_default com.apple.driver.AppleBluetoothMultitouch.trackpad TrackpadCornerSecondaryClick), right click: $(read_default com.apple.driver.AppleBluetoothMultitouch.trackpad TrackpadRightClick), host corner: $(read_current_host_default NSGlobalDomain com.apple.trackpad.trackpadCornerClickBehavior), host secondary: $(read_current_host_default NSGlobalDomain com.apple.trackpad.enableSecondaryClick)" \
    'Keep current setting' \
    'Map bottom-right corner to right-click' \
    'Disable corner right-click'
  case "$CHOICE" in
    2)
      add_command 'Map bottom-right trackpad corner to right-click' 'defaults write com.apple.driver.AppleBluetoothMultitouch.trackpad TrackpadCornerSecondaryClick -int 2; defaults write com.apple.driver.AppleBluetoothMultitouch.trackpad TrackpadRightClick -bool true; defaults -currentHost write NSGlobalDomain com.apple.trackpad.trackpadCornerClickBehavior -int 1; defaults -currentHost write NSGlobalDomain com.apple.trackpad.enableSecondaryClick -bool true'
      ;;
    3)
      add_command 'Disable trackpad corner right-click' 'defaults write com.apple.driver.AppleBluetoothMultitouch.trackpad TrackpadCornerSecondaryClick -int 0; defaults write com.apple.driver.AppleBluetoothMultitouch.trackpad TrackpadRightClick -bool false; defaults -currentHost write NSGlobalDomain com.apple.trackpad.trackpadCornerClickBehavior -int 0; defaults -currentHost write NSGlobalDomain com.apple.trackpad.enableSecondaryClick -bool false'
      ;;
  esac
}

configure_screen() {
  info 'Screen'

  ask_choice 'Require password after sleep or screen saver' "ask: $(read_default com.apple.screensaver askForPassword), delay: $(read_default com.apple.screensaver askForPasswordDelay)" \
    'Keep current setting' \
    'Require password immediately' \
    'Require password after 5 seconds' \
    'Do not require password'
  case "$CHOICE" in
    2)
      add_command 'Require password immediately after sleep or screen saver' 'defaults write com.apple.screensaver askForPassword -int 1; defaults write com.apple.screensaver askForPasswordDelay -int 0'
      ;;
    3)
      add_command 'Require password 5 seconds after sleep or screen saver' 'defaults write com.apple.screensaver askForPassword -int 1; defaults write com.apple.screensaver askForPasswordDelay -int 5'
      ;;
    4)
      add_command 'Do not require password after sleep or screen saver' 'defaults write com.apple.screensaver askForPassword -int 0'
      ;;
  esac
}

configure_mouse() {
  info 'Mouse'

  ask_choice 'Smooth scrolling' "$(read_default NSGlobalDomain NSScrollAnimationEnabled)" \
    'Keep current setting' \
    'Enable smooth scrolling' \
    'Disable smooth scrolling'
  case "$CHOICE" in
    2)
      add_command 'Enable smooth scrolling' 'defaults write NSGlobalDomain NSScrollAnimationEnabled -bool true'
      ;;
    3)
      add_command 'Disable smooth scrolling' 'defaults write NSGlobalDomain NSScrollAnimationEnabled -bool false'
      ;;
  esac
}

configure_screenshots() {
  info 'Screenshots'

  ask_choice 'Screenshot file format' "$(read_default com.apple.screencapture type)" \
    'Keep current setting' \
    'PNG' \
    'JPG' \
    'PDF' \
    'TIFF'
  case "$CHOICE" in
    2)
      add_command 'Set screenshot format to PNG' 'defaults write com.apple.screencapture type -string png'
      RESTART_SYSTEMUISERVER=true
      ;;
    3)
      add_command 'Set screenshot format to JPG' 'defaults write com.apple.screencapture type -string jpg'
      RESTART_SYSTEMUISERVER=true
      ;;
    4)
      add_command 'Set screenshot format to PDF' 'defaults write com.apple.screencapture type -string pdf'
      RESTART_SYSTEMUISERVER=true
      ;;
    5)
      add_command 'Set screenshot format to TIFF' 'defaults write com.apple.screencapture type -string tiff'
      RESTART_SYSTEMUISERVER=true
      ;;
  esac

  ask_choice 'Screenshot shadow' "$(read_default com.apple.screencapture disable-shadow)" \
    'Keep current setting' \
    'Keep window shadows' \
    'Disable window shadows'
  case "$CHOICE" in
    2)
      add_command 'Keep screenshot window shadows' 'defaults write com.apple.screencapture disable-shadow -bool false'
      RESTART_SYSTEMUISERVER=true
      ;;
    3)
      add_command 'Disable screenshot window shadows' 'defaults write com.apple.screencapture disable-shadow -bool true'
      RESTART_SYSTEMUISERVER=true
      ;;
  esac

  ask_choice 'Screenshot location' "$(read_default com.apple.screencapture location)" \
    'Keep current setting' \
    'Desktop' \
    'Downloads' \
    'Pictures/Screenshots' \
    'Custom path'
  case "$CHOICE" in
    2)
      add_command 'Save screenshots to Desktop' 'defaults write com.apple.screencapture location -string "$HOME/Desktop"'
      RESTART_SYSTEMUISERVER=true
      ;;
    3)
      add_command 'Save screenshots to Downloads' 'defaults write com.apple.screencapture location -string "$HOME/Downloads"'
      RESTART_SYSTEMUISERVER=true
      ;;
    4)
      add_command 'Save screenshots to Pictures/Screenshots' 'mkdir -p "$HOME/Pictures/Screenshots"; defaults write com.apple.screencapture location -string "$HOME/Pictures/Screenshots"'
      RESTART_SYSTEMUISERVER=true
      ;;
    5)
      local path=
      local quoted_path=
      printf 'Custom screenshot location: '
      read -r path
      [ -n "$path" ] || fail 'Screenshot path cannot be empty.'
      path=$(expand_user_path "$path")
      quoted_path=$(shell_quote "$path")
      add_command "Save screenshots to $path" "mkdir -p $quoted_path; defaults write com.apple.screencapture location -string $quoted_path"
      RESTART_SYSTEMUISERVER=true
      ;;
  esac
}

choose_groups() {
  printf '%s\n' "${BOLD}macOS Tweaks${RESET}"
  note 'Choose groups to configure. Every setting starts with "keep current".'

  if confirm 'Configure Language and Timezone tweaks?'; then
    configure_language_timezone
  fi

  if confirm 'Configure keyboard tweaks?'; then
    configure_keyboard
  fi

  if confirm 'Configure Accessibility tweaks?'; then
    configure_accessibility
  fi

  if confirm 'Configure Finder tweaks?'; then
    configure_finder
  fi

  if confirm 'Configure Dock tweaks?'; then
    configure_dock
  fi

  if confirm 'Configure Mission Control tweaks?'; then
    configure_mission_control
  fi

  if confirm 'Configure Hot Corners?'; then
    configure_hot_corners
  fi

  if confirm 'Configure Trackpad tweaks?'; then
    configure_trackpad
  fi

  if confirm 'Configure Screen tweaks?'; then
    configure_screen
  fi

  if confirm 'Configure Mouse tweaks?'; then
    configure_mouse
  fi

  if confirm 'Configure screenshot tweaks?'; then
    configure_screenshots
  fi
}

print_summary() {
  printf '\n%s\n' "${BOLD}Planned changes${RESET}"

  if [ "${#COMMANDS[@]}" -eq 0 ]; then
    note 'No changes selected.'
    return
  fi

  local i=0
  while [ "$i" -lt "${#COMMANDS[@]}" ]; do
    printf '  %s\n' "${DESCRIPTIONS[$i]}"
    note "    ${COMMANDS[$i]}"
    i=$((i + 1))
  done

  if [ "$RESTART_DOCK" = true ]; then
    printf '  %s\n' 'Restart Dock'
    note '    killall Dock'
  fi

  if [ "$RESTART_FINDER" = true ]; then
    printf '  %s\n' 'Restart Finder'
    note '    killall Finder'
  fi

  if [ "$RESTART_SYSTEMUISERVER" = true ]; then
    printf '  %s\n' 'Restart SystemUIServer'
    note '    killall SystemUIServer'
  fi
}

run_commands() {
  local i=0 output status failures=0 warnings=0
  local failed_descriptions=()
  local warning_descriptions=()

  while [ "$i" -lt "${#COMMANDS[@]}" ]; do
    set +e
    output=$(eval "${COMMANDS[$i]}" 2>&1)
    status=$?
    set -e

    if [ "$status" -ne 0 ] || printf '%s\n' "$output" | grep -E '(^|[[:space:]])(Error:|### Error:|Could not write domain)' >/dev/null; then
      if is_soft_failure "${DESCRIPTIONS[$i]}" "${COMMANDS[$i]}" "$output"; then
        printf '%s\n' "${YELLOW}[WARN]${RESET} ${DESCRIPTIONS[$i]}"
        if [ -n "$output" ]; then
          printf '%s\n' "$output" >&2
        fi
        print_manual_guidance "${DESCRIPTIONS[$i]}" "${COMMANDS[$i]}"
        warnings=$((warnings + 1))
        warning_descriptions+=("${DESCRIPTIONS[$i]}")
        i=$((i + 1))
        continue
      fi

      printf '%s\n' "${RED}[FAIL]${RESET} ${DESCRIPTIONS[$i]}" >&2
      if [ -n "$output" ]; then
        printf '%s\n' "$output" >&2
      fi
      failures=$((failures + 1))
      failed_descriptions+=("${DESCRIPTIONS[$i]}")
      i=$((i + 1))
      continue
    fi

    printf '%s\n' "${GREEN}[OK]${RESET} ${DESCRIPTIONS[$i]}"
    i=$((i + 1))
  done

  if [ "$RESTART_DOCK" = true ]; then
    killall Dock 2>/dev/null || true
  fi

  if [ "$RESTART_FINDER" = true ]; then
    killall Finder 2>/dev/null || true
  fi

  if [ "$RESTART_SYSTEMUISERVER" = true ]; then
    killall SystemUIServer 2>/dev/null || true
  fi

  if [ "$failures" -gt 0 ]; then
    printf '\n%s\n' "${RED}${BOLD}Completed with $failures failed tweak(s):${RESET}" >&2
    i=0
    while [ "$i" -lt "${#failed_descriptions[@]}" ]; do
      printf '  - %s\n' "${failed_descriptions[$i]}" >&2
      i=$((i + 1))
    done
    return 1
  fi

  if [ "$warnings" -gt 0 ]; then
    printf '\n%s\n' "${YELLOW}${BOLD}Completed with $warnings warning(s):${RESET}"
    i=0
    while [ "$i" -lt "${#warning_descriptions[@]}" ]; do
      printf '  - %s\n' "${warning_descriptions[$i]}"
      i=$((i + 1))
    done
  fi
}

is_soft_failure() {
  local description=$1 command=$2 output=$3

  case "$command" in
    *'systemsetup -settimezone'*)
      printf '%s\n' "$output" | grep '### Error:-99' >/dev/null && return 0
      ;;
    *'com.apple.universalaccess'*)
      printf '%s\n' "$output" | grep 'Could not write domain' >/dev/null && return 0
      ;;
  esac

  case "$description" in
    Set\ timezone\ to\ *|*scroll\ gesture\ zoom*|*keyboard\ focus\ while\ zoomed*)
      return 0
      ;;
  esac

  return 1
}

print_manual_guidance() {
  local description=$1 command=$2

  case "$command" in
    *'systemsetup -settimezone'*)
      warn '  Manual: System Settings > General > Date & Time > Time Zone.'
      ;;
    *'com.apple.universalaccess'*)
      warn '  Manual: System Settings > Accessibility > Zoom.'
      ;;
    *)
      warn "  Manual follow-up may be required for: $description"
      ;;
  esac
}

parse_args "$@"

case "$(uname -s)" in
  Darwin) ;;
  *) fail './macos only supports macOS.' ;;
esac

if [ -n "$CONFIG_FILE" ]; then
  load_config_file "$CONFIG_FILE"
else
  choose_groups
fi

print_summary

if [ "${#COMMANDS[@]}" -eq 0 ]; then
  exit 0
fi

if [ -n "$SAVE_FILE" ]; then
  save_config "$SAVE_FILE"
fi

if [ "$DRY_RUN" = true ]; then
  warn 'Dry run: no changes applied.'
  exit 0
fi

if confirm 'Apply these macOS tweaks?'; then
  run_commands
  printf '%s\n' "${GREEN}${BOLD}Done.${RESET}"
else
  warn 'No changes applied.'
fi