From b64ee08d6b08b36b33fd1644b374ec2a5fd1a193 Mon Sep 17 00:00:00 2001
From: Gaetan Lepage <gaetan@glepage.com>
Date: Mon, 24 Jun 2024 08:43:38 +0200
Subject: [PATCH] plugins/codesnap: init

---
 plugins/default.nix                           |  1 +
 plugins/utils/codesnap.nix                    | 96 +++++++++++++++++++
 tests/test-sources/plugins/utils/codesnap.nix | 43 +++++++++
 3 files changed, 140 insertions(+)
 create mode 100644 plugins/utils/codesnap.nix
 create mode 100644 tests/test-sources/plugins/utils/codesnap.nix

diff --git a/plugins/default.nix b/plugins/default.nix
index f1f208ac..5c9e24c5 100644
--- a/plugins/default.nix
+++ b/plugins/default.nix
@@ -146,6 +146,7 @@
     ./utils/ccc.nix
     ./utils/clipboard-image.nix
     ./utils/cloak.nix
+    ./utils/codesnap.nix
     ./utils/comment.nix
     ./utils/commentary.nix
     ./utils/competitest.nix
diff --git a/plugins/utils/codesnap.nix b/plugins/utils/codesnap.nix
new file mode 100644
index 00000000..e9d5cdbd
--- /dev/null
+++ b/plugins/utils/codesnap.nix
@@ -0,0 +1,96 @@
+{
+  lib,
+  helpers,
+  config,
+  pkgs,
+  ...
+}:
+with lib;
+helpers.neovim-plugin.mkNeovimPlugin config {
+  name = "codesnap";
+  originalName = "codesnap.nvim";
+  defaultPackage = pkgs.vimPlugins.codesnap-nvim;
+
+  maintainers = [ maintainers.GaetanLepage ];
+
+  settingsOptions = {
+    save_path = helpers.defaultNullOpts.mkStr null ''
+      The save_path must be ends with `.png`, unless when you specified a directory path, CodeSnap
+      will append an auto-generated filename to the specified directory path.
+
+      For example:
+      - `save_path = "~/Pictures";`
+        parsed: `"~/Pictures/CodeSnap_y-m-d_at_h:m:s.png"`
+      - `save_path = "~/Pictures/foo.png";`
+        parsed: `"~/Pictures/foo.png"`
+    '';
+
+    mac_window_bar = helpers.defaultNullOpts.mkBool true ''
+      Whether to display the MacOS style title bar.
+    '';
+
+    title = helpers.defaultNullOpts.mkStr "CodeSnap.nvim" ''
+      The editor title.
+    '';
+
+    code_font_family = helpers.defaultNullOpts.mkStr "CaskaydiaCove Nerd Font" ''
+      Which font to use for the code.
+    '';
+
+    watermark_font_family = helpers.defaultNullOpts.mkStr "Pacifico" ''
+      Which font to use for watermarks.
+    '';
+
+    watermark = helpers.defaultNullOpts.mkStr "CodeSnap.nvim" ''
+      Wartermark of the code snapshot.
+    '';
+
+    bg_theme = helpers.defaultNullOpts.mkStr "default" ''
+      Background theme name.
+
+      Check the [upstream README](https://github.com/mistricky/codesnap.nvim?tab=readme-ov-file#custom-background)
+      for available options.
+    '';
+
+    bg_color = helpers.defaultNullOpts.mkStr' {
+      pluginDefault = null;
+      example = "#535c68";
+      description = ''
+        If you prefer solid color background, you can set bg_color to your preferred color.
+      '';
+    };
+
+    breadcrumbs_separator = helpers.defaultNullOpts.mkStr "/" ''
+      Separator for breadcrumbs.
+      The CodeSnap.nvim uses `/` as the separator of the file path by default, of course, you can
+      specify any symbol you prefer as the custom separator.
+    '';
+
+    has_breadcrumbs = helpers.defaultNullOpts.mkBool false ''
+      Whether to display the current snapshot file path.
+    '';
+
+    has_line_number = helpers.defaultNullOpts.mkBool false ''
+      Whether to display line numbers.
+    '';
+
+    show_workspace = helpers.defaultNullOpts.mkBool false ''
+      Breadcrumbs hide the workspace name by default, if you want to display workspace in
+      breadcrumbs, you can just set this option to `true`.
+    '';
+
+    min_width = helpers.defaultNullOpts.mkUnsignedInt 0 ''
+      Minimum width for the snapshot.
+    '';
+  };
+
+  settingsExample = {
+    save_path = "~/Pictures/Screenshots/";
+    mac_window_bar = true;
+    title = "CodeSnap.nvim";
+    watermark = "";
+    breadcrumbs_separator = "/";
+    has_breadcrumbs = true;
+    has_line_number = false;
+  };
+}
diff --git a/tests/test-sources/plugins/utils/codesnap.nix b/tests/test-sources/plugins/utils/codesnap.nix
new file mode 100644
index 00000000..cb69269b
--- /dev/null
+++ b/tests/test-sources/plugins/utils/codesnap.nix
@@ -0,0 +1,43 @@
+{
+  empty = {
+    plugins.codesnap.enable = true;
+  };
+
+  defaults = {
+    plugins.codesnap = {
+      enable = true;
+
+      settings = {
+        save_path = null;
+        mac_window_bar = true;
+        title = "CodeSnap.nvim";
+        code_font_family = "CaskaydiaCove Nerd Font";
+        watermark_font_family = "Pacifico";
+        watermark = "CodeSnap.nvim";
+        bg_theme = "default";
+        bg_color = null;
+        breadcrumbs_separator = "/";
+        has_breadcrumbs = false;
+        has_line_number = false;
+        show_workspace = false;
+        min_width = 0;
+      };
+    };
+  };
+
+  example = {
+    plugins.codesnap = {
+      enable = true;
+
+      settings = {
+        save_path = "~/Pictures/Screenshots/";
+        mac_window_bar = true;
+        title = "CodeSnap.nvim";
+        watermark = "";
+        breadcrumbs_separator = "/";
+        has_breadcrumbs = true;
+        has_line_number = false;
+      };
+    };
+  };
+}