utility/multicursors-nvim: init #610)

* feat: add multicursors-nvim plugin

multicursors-nvim with hydra dependency and static config.

* add most used default options

* add more descriptions and refine

* disable debug mode

* maximal by default

* add multicursors addition to changelog

* Update modules/plugins/hydra/hydra.nix

place hydra plugin in utility folder

Co-authored-by: raf <raf@notashelf.dev>

* clean up hydra config and implementation

* mention hydra dependency addition

* update to using npins instead of flake based additions.

---------

Co-authored-by: raf <raf@notashelf.dev>
Co-authored-by: raf <me@notashelf.dev>

modules/plugins/hydra/config.nix

@@ -0,0 +1,22 @@
+{
+  config,
+  lib,
+  ...
+}: let
+  inherit (lib.modules) mkIf;
+  cfg = config.vim.hydra;
+in {
+  config = mkIf cfg.enable {
+    vim = {
+      startPlugins = [];
+      lazy.plugins.hydra = {
+        package = "hydra.nvim";
+        setupModule = "hydra";
+        inherit (cfg) setupOpts;
+
+        event = ["DeferredUIEnter"];
+        cmd = ["MCstart" "MCvisual" "MCclear" "MCpattern" "MCvisualPattern" "MCunderCursor"];
+      };
+    };
+  };
+}

modules/plugins/hydra/default.nix

@@ -0,0 +1,6 @@
+{
+  imports = [
+    ./hydra.nix
+    ./config.nix
+  ];
+}

modules/plugins/hydra/hydra.nix

@@ -0,0 +1,7 @@
+{lib, ...}: let
+  inherit (lib.options) mkEnableOption;
+in {
+  options.vim.utility.hydra = {
+    enable = mkEnableOption "utility for creating custom submodes and menus [nvimtools/hydra.nvim]";
+  };
+}

modules/plugins/utility/default.nix

@@ -8,6 +8,7 @@
     ./icon-picker
     ./images
     ./motion
+    ./multicursors
     ./new-file-template
     ./outline
     ./preview

modules/plugins/utility/multicursors/config.nix

@@ -0,0 +1,36 @@
+{
+  config,
+  lib,
+  ...
+}: let
+  inherit (lib.modules) mkIf;
+  cfg = config.vim.utility.multicursors;
+in {
+  config = mkIf cfg.enable {
+    vim = {
+      startPlugins = ["hydra-nvim"];
+      lazy.plugins."multicursors-nvim" = {
+        package = "multicursors-nvim";
+        setupModule = "multicursors";
+        inherit (cfg) setupOpts;
+
+        event = ["DeferredUIEnter"];
+        cmd = ["MCstart" "MCvisual" "MCclear" "MCpattern" "MCvisualPattern" "MCunderCursor"];
+        keys = [
+          {
+            mode = ["v" "n"];
+            key = "<leader>mcs";
+            action = ":MCstart<cr>";
+            desc = "Create a selection for selected text or word under the cursor [multicursors.nvim]";
+          }
+          {
+            mode = ["v" "n"];
+            key = "<leader>mcp";
+            action = ":MCpattern<cr>";
+            desc = "Create a selection for pattern entered [multicursors.nvim]";
+          }
+        ];
+      };
+    };
+  };
+}

modules/plugins/utility/multicursors/default.nix

@@ -0,0 +1,6 @@
+{
+  imports = [
+    ./multicursors.nix
+    ./config.nix
+  ];
+}

modules/plugins/utility/multicursors/multicursors.nix

@@ -0,0 +1,126 @@
+{lib, ...}: let
+  inherit (lib.types) bool int str;
+  inherit (lib.nvim.types) mkPluginSetupOption;
+  inherit (lib.options) mkOption mkEnableOption;
+  hintConfig = {lib, ...}: {
+    options = {
+      float_opts = mkOption {
+        description = "The options for the floating hint window";
+        type = lib.types.submodule {
+          options = {
+            border = mkOption {
+              type = lib.types.str;
+              default = "none";
+              description = "The border style for the hint window";
+            };
+          };
+        };
+      };
+      position = mkOption {
+        type = lib.types.str;
+        default = "bottom";
+        description = "The position of the hint window";
+      };
+    };
+  };
+  generateHints = {lib, ...}: {
+    options = {
+      normal = mkOption {
+        type = lib.types.bool;
+        description = "Generate hints for the normal mode";
+        default = true;
+      };
+      insert = mkOption {
+        type = lib.types.bool;
+        description = "Generate hints for the insert mode";
+        default = true;
+      };
+      extend = mkOption {
+        type = lib.types.bool;
+        description = "Generate hints for the extend mode";
+        default = true;
+      };
+      config = mkOption {
+        description = "The configuration for generating hints for multicursors.nvim";
+        type = lib.types.submodule {
+          options = {
+            column_count = mkOption {
+              type = lib.types.nullOr int;
+              description = "The number of columns to use for the hint window";
+              default = null;
+            };
+            max_hint_length = mkOption {
+              type = int;
+              description = "The maximum length of the hint";
+              default = 25;
+            };
+          };
+        };
+        default = {
+          column_count = null;
+          max_hint_length = 25;
+        };
+      };
+    };
+  };
+in {
+  options.vim.utility.multicursors = {
+    enable = mkEnableOption "multicursors.nvim plugin (vscode like multiple cursors)";
+
+    setupOpts = mkPluginSetupOption "multicursors" {
+      DEBUG_MODE = mkOption {
+        type = bool;
+        default = false;
+        description = "Enable debug mode.";
+      };
+      create_commands = mkOption {
+        type = bool;
+        default = true;
+        description = "Create Multicursor user commands";
+      };
+      updatetime = mkOption {
+        type = int;
+        default = 50;
+        description = "The time in milliseconds to wait before updating the cursor in insert mode";
+      };
+      nowait = mkOption {
+        type = bool;
+        description = "Don't wait for the cursor to move before updating the cursor";
+        default = true;
+      };
+      mode_keys = mkOption {
+        type = lib.types.attrsOf str;
+        description = "The keys to use for each mode";
+        default = {
+          insert = "i";
+          append = "a";
+          change = "c";
+          extend = "e";
+        };
+      };
+      hint_config = mkOption {
+        type = lib.types.submodule hintConfig;
+        description = "The configuration for the hint window";
+        default = {
+          float_opts = {
+            border = "none";
+          };
+          position = "bottom";
+        };
+      };
+      generate_hints = mkOption {
+        type = lib.types.submodule generateHints;
+        description = "The configuration for generating hints";
+        default = {
+          normal = true;
+          insert = true;
+          extend = true;
+          config = {
+            column_count = null;
+            max_hint_length = 25;
+          };
+        };
+      };
+    };
+  };
+}