utility/images: add image.nvim

modules/utility/default.nix

@@ -1,11 +1,12 @@
-_: {
+{
   imports = [
     ./binds
+    ./ccc
     ./gestures
     ./motion
     ./telescope
-    ./ccc
     ./icon-picker
+    ./images
     ./telescope
     ./diffview
     ./wakatime

modules/utility/images/default.nix

@@ -0,0 +1,6 @@
+{
+  imports = [
+    #./hologram
+    ./image-nvim
+  ];
+}

modules/utility/images/hologram/default.nix

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

modules/utility/images/image-nvim/config.nix

@@ -0,0 +1,27 @@
+{
+  config,
+  pkgs,
+  lib,
+  ...
+}: let
+  inherit (lib) nvim mkIf attrValues;
+
+  cfg = config.vim.utility.images.image-nvim;
+in {
+  config = mkIf cfg.enable {
+    vim = {
+      startPlugins =
+        [
+          "image-nvim"
+          # TODO: needs luarockss here somehow
+        ]
+        ++ (attrValues {inherit (pkgs) luarocks imagemagick;});
+
+      luaConfigRC.image-nvim = nvim.dag.entryAnywhere ''
+        require("image").setup(
+          ${nvim.lua.toLuaObject cfg.setupOpts}
+        )
+      '';
+    };
+  };
+}

modules/utility/images/image-nvim/default.nix

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

modules/utility/images/image-nvim/image-nvim.nix

@@ -0,0 +1,116 @@
+{
+  config,
+  lib,
+  ...
+}: let
+  inherit (lib) mkEnableOption mkOption nvim types;
+in {
+  options.vim.utility.images.image-nvim = {
+    enable = mkEnableOption "image support in Neovim [image.nvim]";
+
+    setupOpts = nvim.types.mkPluginSetupOption "image.nvim" {
+      backend = mkOption {
+        type = types.enum ["kitty" "ueberzug"];
+        default = "ueberzug";
+        description = ''
+          The backend to use for rendering images.
+
+          - kitty - best in class, works great and is very snappy
+          - ueberzug - backed by ueberzugpp, supports any terminal,
+            but has lower performance
+        '';
+      };
+
+      integrations = {
+        markdown = {
+          enable = mkEnableOption " image.nvim in markdown files" // {default = true;};
+          clearInInsertMode = mkEnableOption "clearing of images when entering insert mode";
+          downloadRemoteImages = mkEnableOption "downloading remote images";
+          onlyRenderAtCursor = mkEnableOption "only rendering images at cursor";
+          filetypes = mkOption {
+            type = with types; listOf str;
+            default = ["markdown" "vimwiki"];
+            description = ''
+              Filetypes to enable image.nvim in. Markdown extensions
+              (i.e. quarto) can go here
+            '';
+          };
+        };
+
+        neorg = {
+          enable = mkEnableOption "image.nvim in Neorg files" // {default = true;};
+          clearInInsertMode = mkEnableOption "clearing of images when entering insert mode";
+          downloadRemoteImages = mkEnableOption "downloading remote images";
+          onlyRenderAtCursor = mkEnableOption "only rendering images at cursor";
+          filetypes = mkOption {
+            type = with types; listOf str;
+            default = ["neorg"];
+            description = ''
+              Filetypes to enable image.nvim in.
+            '';
+          };
+        };
+
+        maxWidth = mkOption {
+          type = with types; nullOr int;
+          default = null;
+          description = ''
+            The maximum width of images to render. Images larger than
+            this will be scaled down to fit within this width.
+          '';
+        };
+
+        maxHeight = mkOption {
+          type = with types; nullOr int;
+          default = null;
+          description = ''
+            The maximum height of images to render. Images larger than
+            this will be scaled down to fit within this height.
+          '';
+        };
+
+        maxWidthWindowPercentage = mkOption {
+          type = with types; nullOr int;
+          default = null;
+          description = ''
+            The maximum width of images to render as a percentage of the
+            window width. Images larger than this will be scaled down to
+            fit within this width.
+          '';
+        };
+
+        maxHeightWindowPercentage = mkOption {
+          type = with types; nullOr int;
+          default = 50;
+          description = ''
+            The maximum height of images to render as a percentage of the
+            window height. Images larger than this will be scaled down to
+            fit within this height.
+          '';
+        };
+
+        windowOverlapClear = {
+          enable = mkEnableOption "clearing of images when they overlap with the window";
+          ftIgnore = mkOption {
+            type = with types; listOf str;
+            default = ["cmp_menu" "cmp_docs" ""];
+            description = ''
+              Filetypes to ignore window overlap clearing in.
+            '';
+          };
+        };
+
+        editorOnlyRenderWhenFocused = mkEnableOption "only rendering images when the editor is focused";
+        hijackFilePatterns = mkOption {
+          type = with types; listOf str;
+          default = ["*.png" "*.jpg" "*.jpeg" "*.gif" "*.webp"];
+          description = ''
+            File patterns to hijack for image.nvim. This is useful for
+            filetypes that don't have a dedicated integration.
+          '';
+        };
+      };
+    };
+  };
+}
+