plugins/alpha: migrate to mkNeovimPlugin

plugins/by-name/alpha/default.nix

@@ -1,15 +1,26 @@
-{
+{ lib, ... }:
-  lib,
-  config,
-  options,
-  pkgs,
-  ...
-}:
 let
-  inherit (lib) types mkOption;
+  inherit (lib) mkOption types;
+  inherit (lib.nixvim)
+    defaultNullOpts
+    mkAssertions
+    mkRaw
+    nestedLiteralLua
+    toLuaObject
+    ;
+in
+lib.nixvim.plugins.mkNeovimPlugin {
+  name = "alpha";
+  packPathName = "alpha-nvim";
+  package = "alpha-nvim";
 
-  cfg = config.plugins.alpha;
+  maintainers = [ lib.maintainers.HeitorAugustoLN ];
 
+  callSetup = false;
+
+  settingsOptions = {
+    layout =
+      let
         sectionType = types.submodule {
           freeformType = with types; attrsOf anything;
           options = {
@@ -21,66 +32,43 @@ let
                 "text"
                 "terminal"
               ];
-        description = "Type of section";
+              example = "button";
+              description = ''
+                The type of the section.
+              '';
             };
 
-      val = lib.nixvim.mkNullOrOption (
+            val = defaultNullOpts.mkNullableWithRaw' {
+              type =
                 with types;
-        nullOr (oneOf [
+                oneOf [
-
+                  # button || text
-          # "button", "text"
                   (maybeRaw str)
-          # "padding"
+                  # padding
                   int
                   (listOf (
-            either
+                    either str # text (list of strings)
-              # "text" (list of strings)
+                      (attrsOf anything) # group
-              str
-              # "group"
-              (attrsOf anything)
                   ))
-        ])
+                ];
-      ) "Value for section";
+              example = "Some text";
+              description = ''
+                The value for the section.
+              '';
+            };
 
             opts = mkOption {
               type = with types; attrsOf anything;
               default = { };
-        description = "Additional options for the section";
+              description = ''
+                Additional options for the section.
+              '';
             };
           };
         };
-in
+      in
-{
+      defaultNullOpts.mkNullableWithRaw' {
-  options = {
+        type = with types; either str (listOf sectionType);
-    plugins.alpha = {
-      enable = lib.mkEnableOption "alpha-nvim";
-
-      package = lib.mkPackageOption pkgs "alpha-nvim" {
-        default = [
-          "vimPlugins"
-          "alpha-nvim"
-        ];
-      };
-
-      # TODO: deprecated 2024-08-29 remove after 24.11
-      iconsEnabled = mkOption {
-        type = types.bool;
-        description = "Toggle icon support. Installs nvim-web-devicons.";
-        visible = false;
-      };
-
-      theme = mkOption {
-        type = with types; nullOr (maybeRaw str);
-        apply = v: if lib.isString v then lib.nixvim.mkRaw "require'alpha.themes.${v}'.config" else v;
-        default = null;
-        example = "dashboard";
-        description = "You can directly use a pre-defined theme.";
-      };
-
-      layout = mkOption {
-        type = with types; either (maybeRaw str) (listOf sectionType);
-        default = [ ];
-        description = "List of sections to layout for the dashboard";
         example = [
           {
             type = "padding";
@@ -135,57 +123,108 @@ in
             };
           }
         ];
+        description = ''
+          List of sections to layout for the dashboard
+        '';
       };
 
-      opts = lib.nixvim.mkNullOrOption (with types; attrsOf anything) ''
+    opts = defaultNullOpts.mkAttrsOf' {
+      type = types.anything;
+      description = ''
         Optional global options.
       '';
     };
   };
 
-  config =
+  settingsExample = {
-    let
+    layout = [
-      layoutDefined = cfg.layout != [ ];
+      {
-      themeDefined = cfg.theme != null;
+        type = "padding";
+        val = 2;
+      }
+      {
+        type = "text";
+        val = [
+          "███╗   ██╗██╗██╗  ██╗██╗   ██╗██╗███╗   ███╗"
+          "████╗  ██║██║╚██╗██╔╝██║   ██║██║████╗ ████║"
+          "██╔██╗ ██║██║ ╚███╔╝ ██║   ██║██║██╔████╔██║"
+          "██║╚██╗██║██║ ██╔██╗ ╚██╗ ██╔╝██║██║╚██╔╝██║"
+          "██║ ╚████║██║██╔╝ ██╗ ╚████╔╝ ██║██║ ╚═╝ ██║"
+          "╚═╝  ╚═══╝╚═╝╚═╝  ╚═╝  ╚═══╝  ╚═╝╚═╝     ╚═╝"
+        ];
+        opts = {
+          position = "center";
+          hl = "Type";
+        };
+      }
+      {
+        type = "padding";
+        val = 2;
+      }
+      {
+        type = "group";
+        val = [
+          {
+            type = "button";
+            val = "  New file";
+            on_press = nestedLiteralLua "function() vim.cmd[[ene]] end";
+            opts.shortcut = "n";
+          }
+          {
+            type = "button";
+            val = " Quit Neovim";
+            on_press = nestedLiteralLua "function() vim.cmd[[qa]] end";
+            opts.shortcut = "q";
+          }
+        ];
+      }
+      {
+        type = "padding";
+        val = 2;
+      }
+      {
+        type = "text";
+        val = "Inspiring quote here.";
+        opts = {
+          position = "center";
+          hl = "Keyword";
+        };
+      }
+    ];
+  };
 
-      opt = options.plugins.alpha;
+  extraOptions = {
-    in
+    theme = defaultNullOpts.mkStr' {
-    lib.mkIf cfg.enable {
+      description = ''
-
+        The theme to use for the dashboard.
-      # TODO: added 2024-09-20 remove after 24.11
-      warnings = lib.nixvim.mkWarnings "plugins.alpha" {
-        when = opt.iconsEnabled.isDefined;
-        message = ''
-          The option definition `plugins.alpha.iconsEnabled' in ${lib.showFiles opt.iconsEnabled.files} has been deprecated; please remove it.
       '';
+      example = "dashboard";
+      apply =
+        value: if builtins.isString value then mkRaw ''require("alpha.themes.${value}").config'' else value;
+    };
   };
 
-      plugins.web-devicons =
+  optionsRenamedToSettings = [
-        lib.mkIf
+    "opts"
-          (
+    "layout"
-            opt.iconsEnabled.isDefined
+  ];
-            && cfg.iconsEnabled
-            && !(
-              config.plugins.mini.enable
-              && config.plugins.mini.modules ? icons
-              && config.plugins.mini.mockDevIcons
-            )
-          )
-          {
-            enable = lib.mkOverride 1490 true;
-          };
 
-      extraPlugins = [ cfg.package ];
+  extraConfig =
-
+    cfg:
-      assertions = lib.nixvim.mkAssertions "plugins.alpha" [
+    let
+      layoutDefined = cfg.settings.layout != null;
+      themeDefined = cfg.theme != null;
+    in
     {
-          assertion = themeDefined || layoutDefined;
+      assertions = mkAssertions "plugins.alpha" [
+        {
+          assertion = layoutDefined || themeDefined;
           message = ''
             You have to either set a `theme` or define some sections in `layout`.
           '';
         }
         {
-          assertion = !(themeDefined && layoutDefined);
+          assertion = !(themeDefined && toLuaObject cfg.settings != "{}");
           message = ''
             You can't define both a `theme` and custom options.
             Set `plugins.alpha.theme = null` if you want to configure alpha manually using the `layout` option.
@@ -193,18 +232,8 @@ in
         }
       ];
 
-      extraConfigLua =
+      plugins.alpha.luaConfig.content = ''
-        let
+        require('alpha').setup(${toLuaObject (if themeDefined then cfg.theme else cfg.settings)});
-          setupOptions =
-            if themeDefined then
-              cfg.theme
-            else
-              (with cfg; {
-                inherit layout opts;
-              });
-        in
-        ''
-          require('alpha').setup(${lib.nixvim.toLuaObject setupOptions})
         require('alpha.term')
       '';
     };