install.sh

#!/usr/bin/env bash

SCRIPT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
REPO_DIR="$SCRIPT_DIR"
BACKUP_ROOT="$HOME/.local/state/linux-configs-backups"
TIMESTAMP=$(date +%Y%m%d-%H%M%S)
BACKUP_DIR="$BACKUP_ROOT/$TIMESTAMP"
TEMP_DIR=""
MONITOR_SETUP_MODE=""
INSTALL_GRUB_THEME=false
INSTALL_DEVICE_TYPE="desktop"

REQUIRED_PACMAN_PACKAGES=(
  # Dev utilities
  alacritty
  git
  base-devel
  yad
  neovim
  jq
  fzf
  # Zsh
  zsh
  zsh-autosuggestions
  zsh-syntax-highlighting
  # Fonts
  ttf-nerd-fonts-symbols
  ttf-roboto
  otf-font-awesome
  noto-fonts-cjk
  # System apps
  firefox
  gnome-calendar
  gnome-disk-utility
  seahorse
  celluloid
  loupe
  resources
  nautilus
  nwg-look
  # Desktop components
  waybar
  swaync
  swayosd
  # Hyprland utilities
  hypridle
  hyprland
  hyprlock
  hyprpaper
  hyprpicker
  hyprshot
  # Audio
  pavucontrol
  pipewire-pulse
  playerctl
  # System services
  polkit-gnome
  gnome-keyring
  brightnessctl
  xdg-desktop-portal-hyprland
  # Hyprpm dependencies
  cmake
  cpio
  # Fluent theme dependencies
  gnome-themes-extra
  sassc
  # Other utilities
  keyd
  qt6ct
  wireplumber
  wtype
  socat
)

LAPTOP_PACMAN_PACKAGES=(
  power-profiles-daemon
)

REQUIRED_AUR_PACKAGES=(
  # VS Code
  visual-studio-code-bin
  # Cursor
  rose-pine-hyprcursor
  # Fonts
  otf-apple-sf-pro
  ttf-apple-emoji
  # Nautilus extensions
  nautilus-dropbox
  nautilus-admin-gtk4
  actions-for-nautilus-git
  nautilus-open-any-terminal
  # Fluent theme dependencies
  gtk-engine-murrine
  # Other utilities
  vicinae-bin
  hyprhalt
)

OPTIONAL_PACKAGE_SUGGESTIONS=(
  ghostty
  chromium
  telegram-desktop
  github-desktop-bin
  dropbox
  libreoffice-still
  fastfetch
  obs-studio
  teamspeak3
  vesktop
)

OPTIONAL_PACKAGES=()

HYPRPM_PLUGIN_SOURCES=(
  https://github.com/sandwichfarm/hyprexpo
  https://github.com/virtcode/hypr-dynamic-cursors
)

HYPRPM_ENABLED_PLUGINS=(
  hyprexpo
  dynamic-cursors
)

USER_SYMLINKS=(
  "$REPO_DIR/hypr:$HOME/.config/hypr"
  "$REPO_DIR/hyprhalt:$HOME/.config/hyprhalt"
  "$REPO_DIR/swaync:$HOME/.config/swaync"
  "$REPO_DIR/swayosd:$HOME/.config/swayosd"
  "$REPO_DIR/vicinae:$HOME/.config/vicinae"
  "$REPO_DIR/waybar:$HOME/.config/waybar"
  "$REPO_DIR/zsh/.zshrc:$HOME/.zshrc"
  "$REPO_DIR/zsh/.p10k.zsh:$HOME/.p10k.zsh"
  "$REPO_DIR/ghostty:$HOME/.config/ghostty"
  "$REPO_DIR/alacritty/alacritty.toml:$HOME/.config/alacritty/alacritty.toml"
  "$REPO_DIR/actions-for-nautilus/config.json:$HOME/.local/share/actions-for-nautilus/config.json"
  "$REPO_DIR/qt6ct/qt6ct.conf:$HOME/.config/qt6ct/qt6ct.conf"
  "$REPO_DIR/Templates:$HOME/Templates"
)

SYSTEM_SYMLINKS=(
  "$REPO_DIR/keyd:/etc/keyd"
)

start () {
  CheckEnvironment
  StartingInstallation
  PromptConfigurationOptions
  ConfirmReadyToStart
  PrepareWorkspace
  InstallYAY
  InstallPacmanPackages
  InstallAURPackages
  InstallOptionalPackages
  SetupZSH
  SetupAlacrittyTheme
  SetupGPU
  SetupUserSymlinks
  SetupDesktopEntries
  SetupSystemSymlinks
  SetupMonitors
  SetupHyprlandPlugins
  SetupFluentGTKTheme
  SetupFluentIconTheme
  [[ $INSTALL_GRUB_THEME == true ]] && InstallGrubTheme
  ConfigureNautilusExtensions
  ConfigureWaybar
  SetupServices
  RefreshDesktopDatabase
  ValidateInstallation
  Cleanup
  InstallationCompleted
  PromptForManualVicinaeExtensions
  PromptForHyprlandRestart
}

StartingInstallation () {
  printf "\n\n--- (-.-) Oh, hi there, little buddy (-.-) ---\n"
  printf "\nYou are a meme-big-boy looser, aren't ya? Don't got no arch hyprland config of your own, huh? Gotta snatch someone elses, huh? What a looser. What an animal. What a permanent underclass. If I were you I'd kill myself already. But hey, here you are, stealing my dot files. Good luck fixing anything when it breaks. What a disappointment you are. Disgrace.\n"
  printf "\nOkay, first things first, give me your sudo password, bitch (>_<)=O.\n\n"
  run sudo -v
}

CheckEnvironment () {
  logInfo 'Checking installer environment'

  if [[ ! -f /etc/arch-release ]]; then
    logError 'This installer only supports Arch Linux.'
    exit 1
  fi

  if [[ $EUID -eq 0 ]]; then
    logError 'Run this script as your normal user, not as root.'
    exit 1
  fi

  commandExists sudo || {
    logError 'sudo is required to install packages and create system symlinks.'
    exit 1
  }

  commandExists hyprctl || {
    logError 'hyprctl is required. Run this installer from an active Hyprland session.'
    exit 1
  }

  if [[ -z ${HYPRLAND_INSTANCE_SIGNATURE:-} ]]; then
    logError 'This installer must be run from an active Hyprland session.'
    exit 1
  fi
}

PromptConfigurationOptions () {
  PromptForDeviceType
  PromptForMonitorSetupMode
  PromptForGrubTheme
  PromptForOptionalPackages
}

ConfirmReadyToStart () {
  local confirmationOptions=(
    'Start'
    'Cancel'
  )
  local countdown
  local selectedConfirmation=()

  selectOptions confirmationOptions selectedConfirmation single true "Ready to start installation? This will make changes to your system which cannot be undone automatically. Backups will be created in $BACKUP_ROOT."

  if [[ ${selectedConfirmation[0]} != 'Start' ]]; then
    logInfo 'Installation cancelled before making changes.'
    exit 0
  fi

    logInfo 'Starting installation in 5 seconds. Press Ctrl+C to abort.'
    for ((countdown = 5; countdown > 0; countdown--)); do
      printf 'Starting in %d...\r' "$countdown"
      sleep 1
    done
    printf '%s\n' 'Starting now.'
}

PromptForOptionalPackages () {
  local optionalPackageOptions=("${OPTIONAL_PACKAGE_SUGGESTIONS[@]}" 'Provide custom packages [enter manually]')
  local selectedOptions=()
  local customPackages=()
  local selectedOption
  local selectionLabel='Select optional packages that you would like to install, you lazy dweeb.'

  selectOptions optionalPackageOptions selectedOptions multiple false "$selectionLabel"

  OPTIONAL_PACKAGES=()

  for selectedOption in "${selectedOptions[@]}"; do
    if [[ $selectedOption == 'Provide custom packages [enter manually]' ]]; then
      promptForPackageList 'Enter additional packages to install with yay [optional, space-separated, idiota]: ' customPackages
      BuildUniquePackageList OPTIONAL_PACKAGES "${OPTIONAL_PACKAGES[@]}" "${customPackages[@]}"
      continue
    fi

    OPTIONAL_PACKAGES+=("$selectedOption")
  done

  BuildUniquePackageList OPTIONAL_PACKAGES "${OPTIONAL_PACKAGES[@]}"
}

PromptForDeviceType () {
  local deviceOptions=(
    'Desktop'
    'Laptop'
  )
  local selectedDeviceOption=()

  selectOptions deviceOptions selectedDeviceOption single true 'Are you installing this on a laptopor a desktop?'

  [[ ${selectedDeviceOption[0]} == 'Laptop' ]] && INSTALL_DEVICE_TYPE='laptop'
}

PromptForMonitorSetupMode () {
  local monitorOptions=(
    "Keep monitor configuration from the repo, I'm stupid and scared to change anything."
    "Auto-generate monitor configuration, I'm lazy and want to die."
    "Provide custom configuration, I like to eat my own shit."
  )
  local selectedMonitorOption=()

  selectOptions monitorOptions selectedMonitorOption single true 'How you would like mommy to configure your monitors, big boy?'

  case "${selectedMonitorOption[0]}" in
    "Keep monitor configuration from the repo, I'm stupid and scared to change anything.")
      MONITOR_SETUP_MODE='keep'
      ;;
    "Auto-generate monitor configuration, I'm lazy and want to die.")
      MONITOR_SETUP_MODE='auto'
      ;;
    "Provide custom configuration, I like to eat my own shit.")
      MONITOR_SETUP_MODE='custom'
      ;;
    *)
      logError 'Unknown monitor setup option selected.'
      exit 1
      ;;
  esac
}

PromptForGrubTheme () {
  local grubThemeOptions=(
    'Hell yeah, install the sick-ass GRUB theme'
    'No, I want the boring default GRUB vibe'
  )
  local selectedGrubThemeOption=()

  selectOptions grubThemeOptions selectedGrubThemeOption single true 'Do you want to install the included GRUB theme?'

  [[ ${selectedGrubThemeOption[0]} == 'Hell yeah, install the sick-ass GRUB theme' ]] && INSTALL_GRUB_THEME=true
}

PrepareWorkspace () {
  logInfo 'Preparing installer workspace'

  TEMP_DIR=$(mktemp -d)
  run mkdir -p "$HOME/.config"
  run mkdir -p "$HOME/.local/share/applications"
  run mkdir -p "$BACKUP_DIR"
}

InstallYAY () {
  commandExists yay && {
    logInfo 'YAY is already installed'
    return
  }

  logInfo 'Installing YAY'

  run sudo pacman -S --needed --noconfirm git base-devel

  run git clone https://aur.archlinux.org/yay-bin.git "$TEMP_DIR/yay-bin"
  pushd "$TEMP_DIR/yay-bin" >/dev/null || {
    logError 'Failed to enter temporary YAY build directory.'
    exit 1
  }
  run makepkg -si --noconfirm
  popd >/dev/null || true

  run yay -Sy
}

InstallPacmanPackages () {
  local packages=()

  if [[ $INSTALL_DEVICE_TYPE == 'laptop' ]]; then
    BuildUniquePackageList packages "${REQUIRED_PACMAN_PACKAGES[@]}" "${LAPTOP_PACMAN_PACKAGES[@]}"
  else
    BuildUniquePackageList packages "${REQUIRED_PACMAN_PACKAGES[@]}"
  fi

  logInfo 'Installing pacman packages required by this configuration'
  run sudo pacman -S --needed --noconfirm "${packages[@]}"
}

InstallAURPackages () {
  local packages=()

  BuildUniquePackageList packages "${REQUIRED_AUR_PACKAGES[@]}"

  [[ ${#packages[@]} -eq 0 ]] && return

  logInfo 'Installing AUR packages required by this configuration'
  run yay -S --needed --noconfirm "${packages[@]}" --mflags --skipchecksums
}

InstallOptionalPackages () {
  local packages=()

  BuildUniquePackageList packages "${OPTIONAL_PACKAGES[@]}"

  [[ ${#packages[@]} -eq 0 ]] && return

  logInfo 'Installing optional packages selected for this machine'
  run yay -S --needed --noconfirm "${packages[@]}"
}

SetupZSH () {
  local ohMyZshDirectory="$HOME/.oh-my-zsh"
  local themeDirectory="${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k"
  local autosuggestionsDirectory="${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/zsh-autosuggestions"
  local syntaxHighlightingDirectory="${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting"

  if [[ ! -d $ohMyZshDirectory ]]; then
    logInfo 'Installing Oh My Zsh'
    run sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" "" --unattended
  else
    logInfo 'Oh My Zsh is already installed'
  fi

  if [[ -d $themeDirectory ]]; then
    logInfo 'Powerlevel10k theme is already installed'
  else
    logInfo 'Installing Powerlevel10k theme for ZSH'
    run git clone --depth=1 https://github.com/romkatv/powerlevel10k.git "$themeDirectory"
  fi

  if [[ -d $autosuggestionsDirectory ]]; then
    logInfo 'zsh-autosuggestions plugin is already installed'
  else
    logInfo 'Installing zsh-autosuggestions plugin for ZSH'
    run git clone https://github.com/zsh-users/zsh-autosuggestions "$autosuggestionsDirectory"
  fi

  if [[ -d $syntaxHighlightingDirectory ]]; then
    logInfo 'zsh-syntax-highlighting plugin is already installed'
  else
    logInfo 'Installing zsh-syntax-highlighting plugin for ZSH'
    run git clone https://github.com/zsh-users/zsh-syntax-highlighting.git "$syntaxHighlightingDirectory"
  fi

  logInfo 'Setting zsh as the default shell'
  run chsh -s $(which zsh)
}

SetupAlacrittyTheme() {
  local themeDirectory="$HOME/.config/alacritty/themes"

  logInfo 'Installing Alacritty themes'
  run mkdir -p "$themeDirectory"
  run git clone --depth=1 https://github.com/alacritty/alacritty-theme "$themeDirectory"
}

SetupFluentGTKTheme () {
  local themeRepositoryDirectory="$TEMP_DIR/Fluent-gtk-theme"
  local themeColorsFilePath="$themeRepositoryDirectory/src/_sass/_colors.scss"

  logInfo 'Installing customized Fluent GTK theme'

  run git clone --depth=1 https://github.com/vinceliuice/Fluent-gtk-theme.git "$themeRepositoryDirectory"

  CustomizeFluentGTKThemeColors "$themeColorsFilePath"

  pushd "$themeRepositoryDirectory" >/dev/null || {
    logError 'Failed to enter Fluent GTK theme directory.'
    exit 1
  }

  run ./install.sh -t grey -n Fluent-dark -c dark -l -s standard -i default --tweaks round square

  popd >/dev/null || true
}

SetupFluentIconTheme () {
  local iconRepositoryDirectory="$TEMP_DIR/Fluent-icon-theme"

  logInfo 'Installing Fluent icon theme'

  run git clone --depth=1 https://github.com/vinceliuice/Fluent-icon-theme.git "$iconRepositoryDirectory"

  pushd "$iconRepositoryDirectory" >/dev/null || {
    logError 'Failed to enter Fluent icon theme directory.'
    exit 1
  }

  run ./install.sh

  popd >/dev/null || true
}

InstallGrubTheme () {
  local themeRepositoryDirectory="$TEMP_DIR/Particle-circle-grub-theme"
  local screenSize

  logInfo 'Installing Particle Circle GRUB theme'

  screenSize=$(hyprctl monitors -j | jq -r '
    [.[] | select((.disabled // false) | not)]
    | max_by(.width * .height)
    | if (.width >= 3840 or .height >= 2160) then "4k"
      elif (.width >= 2560 or .height >= 1440) then "2k"
      else "1080p"
      end
  ')

  logInfo "Installing GRUB theme with $screenSize screen size."
  run git clone --depth=1 https://github.com/yeyushengfan258/Particle-circle-grub-theme.git "$themeRepositoryDirectory"

  pushd "$themeRepositoryDirectory" >/dev/null || {
    logError 'Failed to enter Particle Circle GRUB theme directory.'
    exit 1
  }

  run sudo ./install.sh -s "$screenSize"

  popd >/dev/null || true
}

CustomizeFluentGTKThemeColors () {
  local colorsFilePath=$1
  local tempFile

  if [[ ! -f $colorsFilePath ]]; then
    logError "Fluent GTK theme color customization failed: expected colors file at $colorsFilePath"
    exit 1
  fi

  logInfo 'Customizing Fluent GTK theme dark colors'
  tempFile=$(mktemp)

  awk '
    /^\$background:[[:space:]]+if\(\$variant == '\''light'\'', #F2F2F2, #333333\);$/ {
      print "$background:                            if($variant == '\''light'\'', #F2F2F2, #161616);"
      next
    }

    /^\$surface:[[:space:]]+if\(\$variant == '\''light'\'', #FFFFFF, #3C3C3C\);$/ {
      print "$surface:                               if($variant == '\''light'\'', #FFFFFF, #1e1e1e);"
      next
    }

    /^\$base:[[:space:]]+if\(\$variant == '\''light'\'', #FFFFFF, #2B2B2B\); \/\/ semi-surface with 1dp elevation$/ {
      print "$base:                                  if($variant == '\''light'\'', #FFFFFF, #0f0f0f); // semi-surface with 1dp elevation"
      next
    }

    /^\$base-alt:[[:space:]]+if\(\$variant == '\''light'\'', #FAFAFA, #303030\);$/ {
      print "$base-alt:                              if($variant == '\''light'\'', #FAFAFA, #141414);"
      next
    }

    { print }
  ' "$colorsFilePath" > "$tempFile"

  run mv "$tempFile" "$colorsFilePath"
}

SetupUserSymlinks () {
  local mapping source target

  logInfo 'Creating user config symlinks'

  for mapping in "${USER_SYMLINKS[@]}"; do
    source=${mapping%%:*}
    target=${mapping#*:}
    BackupTargetIfNeeded "$source" "$target"
    EnsureParentDirectory "$target"
    run ln -sfnT "$source" "$target"
  done
}

SetupGPU () {
  local envConfigPath aqDrmDevicesPattern tempFile

  envConfigPath="$REPO_DIR/hypr/configs/env.conf"
  aqDrmDevicesPattern='^[[:space:]]*env[[:space:]]*=[[:space:]]*AQ_DRM_DEVICES,'

  if [[ ! -f $envConfigPath ]]; then
    logError "GPU setup failed: expected env config at $envConfigPath"
    exit 1
  fi

  if ! grep -Eq "$aqDrmDevicesPattern" "$envConfigPath"; then
    logInfo 'No AQ_DRM_DEVICES override found in env.conf'
    return
  fi

  logInfo 'Removing AQ_DRM_DEVICES override from env.conf because its system specific.'
  tempFile=$(mktemp)

  awk '!match($0, /^[[:space:]]*env[[:space:]]*=[[:space:]]*AQ_DRM_DEVICES,/) { print }' "$envConfigPath" > "$tempFile"
  run mv "$tempFile" "$envConfigPath"
}

SetupDesktopEntries () {
  local desktopFile targetFile

  logInfo 'Creating .desktop files symlinks'

  for desktopFile in "$REPO_DIR"/hypr/apps/*.desktop; do
    targetFile="$HOME/.local/share/applications/$(basename "$desktopFile")"
    BackupTargetIfNeeded "$desktopFile" "$targetFile"
    EnsureParentDirectory "$targetFile"
    run ln -sfnT "$desktopFile" "$targetFile"
  done
}

SetupSystemSymlinks () {
  local mapping source target

  logInfo 'Creating system config symlinks'

  for mapping in "${SYSTEM_SYMLINKS[@]}"; do
    source=${mapping%%:*}
    target=${mapping#*:}
    BackupTargetIfNeeded "$source" "$target"
    EnsureParentDirectory "$target"
    run sudo ln -sfnT "$source" "$target"
  done
}

SetupMonitors () {
  local monitorsJson monitorRows monitorConfig

  case "$MONITOR_SETUP_MODE" in
    keep)
      logInfo 'Keeping monitor configuration from the repo'
      return
      ;;
    auto)
      logInfo 'Auto-generating monitor configuration from current Hyprland session'
      ;;
    custom)
      logInfo 'Collecting custom monitor configuration from current Hyprland session'
      ;;
    *)
      logError 'Monitor setup mode was not configured.'
      exit 1
      ;;
  esac

  monitorsJson=$(hyprctl monitors -j 2>/dev/null) || {
    logError 'Failed to read monitor information from hyprctl monitors -j.'
    exit 1
  }

  monitorRows=$(printf '%s\n' "$monitorsJson" | jq -r '.[] | select((.disabled // false) | not) | [.name, .width, .height, .refreshRate] | @tsv')

  if [[ -z $monitorRows ]]; then
    logError 'No active monitors were reported by hyprctl monitors -j.'
    exit 1
  fi

  case "$MONITOR_SETUP_MODE" in
    auto)
      monitorConfig=$(BuildAutoMonitorConfiguration "$monitorRows")
      ;;
    custom)
      monitorConfig=$(BuildCustomMonitorConfiguration "$monitorRows")
      ;;
  esac

  printf '%s\n' "$monitorConfig" > "$REPO_DIR/hypr/configs/monitors.conf"

  logInfo 'Updated hypr/configs/monitors.conf'
}

SetupHyprlandPlugins () {
  local pluginSource pluginName

  commandExists hyprpm || {
    logError 'hyprpm is required to install Hyprland plugins.'
    exit 1
  }

  logInfo 'Updating Hyprland plugin registry'
  run hyprpm update

  for pluginSource in "${HYPRPM_PLUGIN_SOURCES[@]}"; do
    logInfo "Adding Hyprland plugin source: $pluginSource"
    run hyprpm add "$pluginSource"
  done

  for pluginName in "${HYPRPM_ENABLED_PLUGINS[@]}"; do
    logInfo "Enabling Hyprland plugin: $pluginName"
    run hyprpm enable "$pluginName"
  done
}

ConfigureNautilusExtensions () {
  run gsettings set com.github.stunkymonkey.nautilus-open-any-terminal terminal alacritty
}

ConfigureWaybar () {
  local waybarConfigPath monitorsJson monitorNamesJson tempConfigFile

  waybarConfigPath="$REPO_DIR/waybar/config.jsonc"
  
  logInfo 'Configuring Waybar outputs from active monitors'

  monitorsJson=$(hyprctl monitors -j 2>/dev/null) || {
    logError 'Failed to read monitor information from hyprctl monitors -j for Waybar configuration.'
    exit 1
  }

  monitorNamesJson=$(printf '%s\n' "$monitorsJson" | jq -c '[.[] | select((.disabled // false) | not) | .name]') || {
    logError 'Failed to parse active monitor names for Waybar configuration.'
    exit 1
  }

  if [[ $monitorNamesJson == '[]' ]]; then
    logError 'No active monitors were reported by hyprctl monitors -j for Waybar configuration.'
    exit 1
  fi

  tempConfigFile=$(mktemp)

  JsoncToJson "$waybarConfigPath" | jq --argjson monitors "$monitorNamesJson" --arg device "$INSTALL_DEVICE_TYPE" '
    def with_power($modules):
      ($modules - ["group/power"]) as $clean
      | if $device != "laptop" then
          $clean
        else
          (($clean | index("group/settings")) // -1) as $index
          | if $index < 0 then
              $clean
            else
              $clean[0:($index + 1)] + ["group/power"] + $clean[($index + 1):]
            end
        end;

    (.[0] // error("waybar/config.jsonc must contain at least one array element")) as $primary
    | ((.[1] // .[0])) as $secondary
    | ($primary | ."modules-right" = with_power(.["modules-right"] // [])) as $primary
    | [($primary | .output = $monitors[0])] + [$monitors[1:][] | ($secondary | .output = .)]
  ' > "$tempConfigFile" || {
    rm -f "$tempConfigFile"
    logError 'Failed to rebuild Waybar monitor configuration.'
    exit 1
  }

  run mv "$tempConfigFile" "$waybarConfigPath"
  logInfo 'Updated waybar/config.jsonc outputs for active monitors'
}

JsoncToJson () {
  local jsoncFile=$1

  sed -E '/^[[:space:]]*\/\//d; s/[[:space:]]*\/\/.*$//' "$jsoncFile" | perl -0pe 's/,(\s*[\]}])/$1/g'
}

BuildAutoMonitorConfiguration () {
  local monitorRows=$1
  local output width height refresh

  {
    printf '# Auto-generated by install.sh using `hyprctl monitors -j`\n\n'

    while IFS=$'\t' read -r output width height refresh; do
      [[ -z $output ]] && continue
      printf 'monitorv2 {\n'
      printf '  output = %s\n' "$output"
      printf '  mode = %sx%s@%s\n' "$width" "$height" "$refresh"
      printf '  position = auto\n'
      printf '  scale = 1\n'
      printf '}\n'
    done <<< "$monitorRows"

    printf '\n'
    BuildWorkspaceAssignments "$monitorRows"
  }
}

BuildCustomMonitorConfiguration () {
  local monitorRows=$1
  local output width height refresh positionX positionY scale

  {
    printf '# Auto-generated by install.sh using `hyprctl monitors -j` with user-provided positions\n\n'

    while IFS=$'\t' read -r output width height refresh; do
      [[ -z $output ]] && continue

      PromptForMonitorCoordinate "$output" 'X' positionX
      PromptForMonitorCoordinate "$output" 'Y' positionY
      PromptForMonitorScale "$output" scale

      printf 'monitorv2 {\n'
      printf '  output = %s\n' "$output"
      printf '  mode = %sx%s@%s\n' "$width" "$height" "$refresh"
      printf '  position = %sx%s\n' "$positionX" "$positionY"
      printf '  scale = %s\n' "$scale"
      printf '}\n'
    done <<< "$monitorRows"

    printf '\n'
    BuildWorkspaceAssignments "$monitorRows"
  }
}

BuildWorkspaceAssignments () {
  local monitorRows=$1
  local output workspaceIndex workspaceCountI 

  workspaceIndex=1
  while IFS=$'\t' read -r output _; do
    [[ -z $output ]] && continue
    workspaceCount=0
    while (( workspaceCount < 4 )); do
      printf 'workspace = %d, monitor:%s, persistent:true\n' "$workspaceIndex" "$output"
      ((workspaceIndex++))
      ((workspaceCount++))
    done
  done <<< "$monitorRows"
}

PromptForMonitorCoordinate () {
  local output=$1
  local axis=$2
  local -n resultRef=$3

  while true; do
    promptForValue "Enter ${axis} position for monitor ${output}: " resultRef

    if [[ $resultRef =~ ^-?[0-9]+$ ]]; then
      return
    fi

    logError 'Please enter an integer value.'
  done
}

PromptForMonitorScale () {
  local output=$1
  local -n resultRef=$2

  while true; do
    promptForValue "Enter scale for monitor ${output} [default: 1]: " resultRef

    if [[ -z $resultRef ]]; then
      resultRef=1
      return
    fi

    if [[ $resultRef =~ ^[0-9]+([.][0-9]+)?$ ]]; then
      return
    fi

    logError 'Please enter a numeric scale value.'
  done
}

SetupServices () {
  logInfo 'Enabling required services'

  run sudo systemctl enable --now keyd
}

RefreshDesktopDatabase () {
  commandExists update-desktop-database || return

  logInfo 'Refreshing desktop database'
  run update-desktop-database "$HOME/.local/share/applications"
}

ValidateInstallation () {
  local mapping source target desktopFile targetFile

  logInfo 'Validating symlinks and required artifacts'

  for mapping in "${USER_SYMLINKS[@]}"; do
    source=${mapping%%:*}
    target=${mapping#*:}
    EnsureSymlinkMatches "$source" "$target"
  done

  for desktopFile in "$REPO_DIR"/hypr/apps/*.desktop; do
    targetFile="$HOME/.local/share/applications/$(basename "$desktopFile")"
    EnsureSymlinkMatches "$desktopFile" "$targetFile"
  done

  for mapping in "${SYSTEM_SYMLINKS[@]}"; do
    source=${mapping%%:*}
    target=${mapping#*:}
    EnsureSymlinkMatches "$source" "$target"
  done

  if [[ ! -f "$HOME/.config/waybar/hypr-ws-apps/libhypr_ws_apps.so" ]]; then
    logError 'Waybar CFFI module artifact is missing at ~/.config/waybar/hypr-ws-apps/libhypr_ws_apps.so'
    exit 1
  fi

  if ! systemctl is-enabled keyd >/dev/null 2>&1; then
    logError 'keyd service is not enabled.'
    exit 1
  fi

  logInfo 'Installer validation completed successfully'
}

InstallationCompleted () {
  printf "\n\n--- Installation completed ---\n"
  printf "\nGo ahead, enjoy the fruits of my labor, you little stupid fucking bitch. Don't forget that you are nobody, you are worthless, you are incapable of an original thought. Amoeba. Your dad would not be proud.\n"
  printf "\nBackups are located in '$BACKUP_DIR', but not like you had anything worthy saving anyway.\n"
  printf "\nRestart your computer to ensure all changes take effect and fuck off.\n"
  printf "\n8=============D\n"
}

PromptForManualVicinaeExtensions () {
  local acknowledgementOptions=(
    "Yes, master, I'll do as you say, don't hit me T_T"
  )
  local selectedAcknowledgement=()

  selectOptions acknowledgementOptions selectedAcknowledgement single true "Also, before I forget, I can't do everything for you. Go install the 'Wifi Commander' and 'Bluetooth' Vicinae extensions manually, bitch."
}

PromptForHyprlandRestart () {
  local restartOptions=(
    "Waaaah, do everything for me, daddy, restart now, please!"
    "Restart later, I like to play in mud."
  )
  local selectedRestartOption=()

  selectOptions restartOptions selectedRestartOption single true 'Restart computer now?'

  if [[ ${selectedRestartOption[0]} == 'Waaaah, do everything for me, daddy, restart now, please!' ]]; then
    logInfo 'Restarting computer now'
    run reboot
    return
  fi

  logInfo 'Skipped Hyprland restart. Restart later to apply all changes.'
}

Cleanup () {
  [[ -n $TEMP_DIR && -d $TEMP_DIR ]] || return

  logInfo 'Cleaning up temporary files'
  run rm -rf "$TEMP_DIR"
}

BackupTargetIfNeeded () {
  local source=$1
  local target=$2
  local backupPath

  if SymlinkAlreadyMatches "$source" "$target"; then
    return
  fi

  if ! PathExists "$target"; then
    return
  fi

  backupPath="$BACKUP_DIR/${target#/}"
  logInfo "Backing up $target to $backupPath"
  EnsureBackupParentDirectory "$backupPath"

  if IsSystemPath "$target"; then
    run sudo mv "$target" "$backupPath"
  else
    run mv "$target" "$backupPath"
  fi
}

EnsureParentDirectory () {
  local target=$1
  local parentDirectory

  parentDirectory=$(dirname "$target")

  if IsSystemPath "$target"; then
    run sudo mkdir -p "$parentDirectory"
  else
    run mkdir -p "$parentDirectory"
  fi
}

EnsureBackupParentDirectory () {
  local target=$1
  local parentDirectory

  parentDirectory=$(dirname "$target")

  if IsSystemPath "$target"; then
    run sudo mkdir -p "$parentDirectory"
  else
    run mkdir -p "$parentDirectory"
  fi
}

EnsureSymlinkMatches () {
  local source=$1
  local target=$2

  if SymlinkAlreadyMatches "$source" "$target"; then
    return
  fi

  logError "Symlink validation failed for $target"
  exit 1
}

SymlinkAlreadyMatches () {
  local source=$1
  local target=$2
  local sourcePath targetPath

  if ! PathIsSymlink "$target"; then
    return 1
  fi

  sourcePath=$(readlink -f "$source") || return 1

  if IsSystemPath "$target"; then
    targetPath=$(sudo readlink -f "$target") || return 1
  else
    targetPath=$(readlink -f "$target") || return 1
  fi

  [[ $sourcePath == "$targetPath" ]]
}

PathExists () {
  local target=$1

  if IsSystemPath "$target"; then
    sudo test -e "$target" -o -L "$target"
  else
    [[ -e $target || -L $target ]]
  fi
}

PathIsSymlink () {
  local target=$1

  if IsSystemPath "$target"; then
    sudo test -L "$target"
  else
    [[ -L $target ]]
  fi
}

IsSystemPath () {
  [[ $1 == /etc/* ]]
}

commandExists () {
  command -v "$1" >/dev/null 2>&1
}

selectOptions () {
  local optionsRefName=$1
  local resultRefName=$2
  local selectionMode=${3:-multiple}
  local requireSelection=${4:-true}
  local selectionLabel=${5:-}
  local -n optionsRef=$optionsRefName
  local -n resultRef=$resultRefName
  local currentIndex=0
  local footerMessage=''
  local key escapeSequence pointer marker
  local index selectedCount
  local -a selectedStates=()

  if [[ $selectionMode != 'single' && $selectionMode != 'multiple' ]]; then
    logError "Invalid selection mode: $selectionMode"
    exit 1
  fi

  if [[ $requireSelection != 'true' && $requireSelection != 'false' ]]; then
    logError "Invalid requireSelection value: $requireSelection"
    exit 1
  fi

  if [[ ${#optionsRef[@]} -eq 0 ]]; then
    logError 'selectOptions requires at least one option.'
    exit 1
  fi

  resultRef=()

  for ((index = 0; index < ${#optionsRef[@]}; index++)); do
    selectedStates[index]=0
  done

  tput sc

  while true; do
    tput rc
    tput ed

    if [[ -n $selectionLabel ]]; then
      printf '\n%s\n\n' "$selectionLabel"
    fi

    for ((index = 0; index < ${#optionsRef[@]}; index++)); do
      pointer=' '
      marker='○'

      if [[ $index -eq $currentIndex ]]; then
        pointer='>'
      fi

      if [[ $selectionMode == 'single' && $index -eq $currentIndex ]]; then
        marker='●'
      fi

      if [[ $selectionMode == 'multiple' && ${selectedStates[index]} -eq 1 ]]; then
        marker='●'
      fi

      printf '%s %s %s\n' "$pointer" "$marker" "${optionsRef[index]}"
    done

    if [[ -n $footerMessage ]]; then
      printf '\n%s\n' "$footerMessage"
    fi

    IFS= read -rsn1 key

    case "$key" in
      '')
        if [[ $selectionMode == 'single' ]]; then
          resultRef=("${optionsRef[currentIndex]}")
          printf '\n'
          return
        fi

        selectedCount=0
        for index in "${selectedStates[@]}"; do
          ((selectedCount += index))
        done

        if (( selectedCount == 0 )) && [[ $requireSelection == 'false' ]]; then
          printf '\n'
          return
        fi

        if (( selectedCount > 0 )); then
          resultRef=()
          for ((index = 0; index < ${#optionsRef[@]}; index++)); do
            if [[ ${selectedStates[index]} -eq 1 ]]; then
              resultRef+=("${optionsRef[index]}")
            fi
          done

          printf '\n'
          return
        fi

        footerMessage='Select at least one option before continuing.'
        ;;
      ' ')
        if [[ $selectionMode == 'multiple' ]]; then
          if [[ ${selectedStates[currentIndex]} -eq 1 ]]; then
            selectedStates[currentIndex]=0
          else
            selectedStates[currentIndex]=1
          fi
          footerMessage=''
        fi
        ;;
      $'\x1b')
        IFS= read -rsn2 -t 0.05 escapeSequence || continue

        case "$escapeSequence" in
          '[A')
            currentIndex=$(((currentIndex - 1 + ${#optionsRef[@]}) % ${#optionsRef[@]}))
            ;;
          '[B')
            currentIndex=$(((currentIndex + 1) % ${#optionsRef[@]}))
            ;;
        esac
        ;;
    esac
  done
}

promptForValue () {
  local promptMessage=$1
  local -n valueRef=$2

  printf '%s' "> $promptMessage"
  read -r valueRef
}

promptForPackageList () {
  local promptMessage=$1
  local -n resultRef=$2
  local packageInput=''

  resultRef=()
  printf '%s' "> $promptMessage"
  read -r packageInput

  [[ -z $packageInput ]] && return

  read -r -a resultRef <<< "$packageInput"
}

BuildUniquePackageList () {
  local -n resultRef=$1
  shift

  local package
  local -A seenPackages=()

  resultRef=()

  for package in "$@"; do
    [[ -n $package ]] || continue

    if [[ -n ${seenPackages[$package]:-} ]]; then
      continue
    fi

    seenPackages[$package]=1
    resultRef+=("$package")
  done
}

run() {
  printf '> %s\n' "$*"
  "$@" || {
    logError "command failed: $*"
    Cleanup
    exit 1
  }
}

logInfo() {
  printf '%s\n' "[INFO]: $*"
}

logError() {
  printf '\033[31m%s\033[0m\n' "[ERROR]: $*"
}

trap Cleanup EXIT

start