{
  config,
  lib,
  pkgs,
  ...
}:
# hypridle: idle-triggered locking and display power management.
{
  options.modules.desktop.session.hyprland.hypridle.enable =
    lib.mkEnableOption "hypridle idle management";

  config = lib.mkIf config.modules.desktop.session.hyprland.hypridle.enable {
    # Closing the lid suspends, and every suspend locks first through the
    # before_sleep_cmd below, so the lid always lands at a locked screen.
    services.logind.settings.Login.HandleLidSwitch = "suspend";

    home-manager.users.${config.user.name}.services.hypridle = {
      enable = true;

      settings = {
        general = {
          # The guard drops the call when a locker is already up, so no idle
          # trigger stacks a second hyprlock over the first.
          lock_cmd = "${lib.getExe' pkgs.procps "pidof"} hyprlock || ${lib.getExe pkgs.hyprlock}";
          before_sleep_cmd = "loginctl lock-session";
          # Waking pokes the compositor in case firmware leaves displays dark.
          after_sleep_cmd = "${lib.getExe' config.programs.hyprland.package "hyprctl"} dispatch 'hl.dsp.dpms({ action = \"enable\" })'";
        };

        listener = [
          # Lock on idle.
          {
            timeout = 300;
            on-timeout = "loginctl lock-session";
          }
        ];
      };
    };
  };
}