nvf/modules/plugins/visuals/visuals.nix

{
  config,
  lib,
  ...
}: let
  inherit (lib.options) mkEnableOption mkOption literalExpression;
  inherit (lib.types) int bool str nullOr either listOf attrsOf;
  inherit (lib.nvim.binds) mkMappingOption;

  cfg = config.vim.visuals;
in {
  options.vim.visuals = {
    enable = mkEnableOption "Visual enhancements.";

    nvimWebDevicons.enable = mkEnableOption "dev icons. Required for certain plugins [nvim-web-devicons].";

    scrollBar.enable = mkEnableOption "scrollbar [scrollbar.nvim]";

    smoothScroll.enable = mkEnableOption "smooth scrolling [cinnamon-nvim]";

    cellularAutomaton = {
      enable = mkEnableOption "cellular automaton [cellular-automaton]";

      mappings = {
        makeItRain = mkMappingOption "Make it rain [cellular-automaton]" "<leader>fml";
      };
    };

    cursorline = {
      enable = mkEnableOption "line hightlighting on the cursor [nvim-cursorline]";

      lineTimeout = mkOption {
        type = int;
        description = "Time in milliseconds for cursorline to appear";
        default = 0;
      };

      lineNumbersOnly = mkOption {
        type = bool;
        description = "Hightlight only in the presence of line numbers";
        default = true;
      };
    };

    indentBlankline = {
      enable = mkEnableOption "indentation guides [indent-blankline]";

      setupOpts = {
        debounce = mkOption {
          type = int;
          description = "Debounce time in milliseconds";
          default = 200;
        };

        viewport_buffer = {
          min = mkOption {
            type = int;
            description = "Number of lines above and below of what is currently
            visible in the window";
            default = 30;
          };

          max = mkOption {
            type = int;
            description = "Number of lines above and below of what is currently
            visible in the window";
            default = 500;
          };
        };

        indent = {
          char = mkOption {
            type = either str (listOf str);
            description = "Character(s) for indentation guide";
            default = "│";
          };

          tab_char = mkOption {
            type = nullOr (either str (listOf str));
            description = ''
              Character(s) for tab indentation guide.

              See `:help ibl.config.indent.tab_char`.
            '';
            default = null;
          };

          highlight = mkOption {
            type = nullOr (either str (listOf str));
            description = ''
              The highlight group(s) applied to the indentation guide.

              See `:help ibl.config.indent.highlight`.
            '';
            default = null;
          };

          smart_indent_cap = mkOption {
            type = bool;
            description = "Caps the number of indentation levels based on surrounding code";
            default = true;
          };

          priority = mkOption {
            type = int;
            description = "Virtual text priority for the indentation guide";
            default = 1;
          };

          repeat_linebreak = mkOption {
            type = bool;
            description = "Repeat indentation guides on wrapped lines";
            default = true;
          };
        };

        whitespace = {
          highlight = mkOption {
            type = nullOr (either str (listOf str));
            description = ''
              The highlight group(s) applied to whitespace.

              See `:help ibl.config.whitespace.highlight`.
            '';
            default = null;
          };

          remove_blankline_trail = mkOption {
            type = bool;
            description = "Remove trailing whitespace on blanklines";
            default = true;
          };
        };

        scope = {
          enabled = mkOption {
            description = "Highlight current scope from treesitter";
            type = bool;
            default = config.vim.treesitter.enable;
            defaultText = literalExpression "config.vim.treesitter.enable";
          };

          char = mkOption {
            type = either str (listOf str);
            description = "The character(s) for the scope indentation guide";
            default = cfg.indentBlankline.setupOpts.indent.char;
            defaultText = literalExpression "config.vim.visuals.indentBlankline.setuopOpts.indent.char";
          };

          show_start = mkOption {
            type = bool;
            description = "Show an underline on the first line of the scope";
            default = false;
          };

          show_end = mkOption {
            type = bool;
            description = "Show an underline on the last line of the scope";
            default = false;
          };

          show_exact_scope = mkOption {
            type = bool;
            description = "Show the scope underline at the exact start of the scope, even if that's to the right of the indentation guide";
            default = false;
          };

          injected_languages = mkOption {
            type = bool;
            description = "Check for injected languages (treesitter)";
            default = config.vim.treesitter.enable;
            defaultText = literalExpression "config.vim.treesitter.enable";
          };

          highlight = mkOption {
            type = nullOr (either str (listOf str));
            description = ''
              The highlight group(s) applied to the scope.

              See `:help `ibl.config.scope.highlight`.
            '';
            default = null;
          };

          priority = mkOption {
            type = int;
            description = "Virtual text priority for the scope";
            default = 1024;
          };

          include.node_type = mkOption {
            type = attrsOf (listOf str);
            description = "Additional nodes to be used for scope checking, per language";
            default = {};
          };

          exclude = {
            language = mkOption {
              type = listOf str;
              description = ''
                The list of treesitter languages to disable scope for.

                `*` can be used as a wildcard for every language/node type.
              '';
              default = [];
            };

            node_type = mkOption {
              type = attrsOf (listOf str);
              description = ''
                Nodes to ignore in scope checking, per language.

                `*` can be used as a wildcard for every language.
              '';
              default = {
                "*" = ["source_file" "program"];
                lua = ["chunk"];
                python = ["module"];
              };
            };
          };
        };
      };
    };

    highlight-undo = {
      enable = mkEnableOption "highlight undo [highlight-undo]";

      highlightForCount = mkOption {
        type = bool;
        default = true;
        description = ''
          Enable support for highlighting when a <count> is provided before the key
          If set to false it will only highlight when the mapping is not prefixed with a <count>
        '';
      };

      duration = mkOption {
        type = int;
        description = "Duration of highlight";
        default = 500;
      };

      undo = {
        hlGroup = mkOption {
          type = str;
          description = "Highlight group for undo";
          default = "HighlightUndo";
        };
      };

      redo = {
        hlGroup = mkOption {
          type = str;
          description = "Highlight group for redo";
          default = "HighlightUndo";
        };
      };
    };
  };
}