programs/nix-search-tv: init

Create the programs/nix-search-tv module, with options to enable,
change settings, and television integration.

Co-authored-by: awwpotato <awwpotato@voidq.com>

modules/programs/nix-search-tv.nix

@@ -0,0 +1,86 @@
+{
+  config,
+  lib,
+  pkgs,
+  ...
+}:
+
+let
+  jsonFormat = pkgs.formats.json { };
+  cfg = config.programs.nix-search-tv;
+in
+{
+  meta.maintainers = with lib.hm.maintainers; [
+    poseidon-rises
+  ];
+
+  options.programs.nix-search-tv = {
+    enable = lib.mkEnableOption "nix-search-tv";
+    package = lib.mkPackageOption pkgs "nix-search-tv" { nullable = true; };
+
+    settings = lib.mkOption {
+      type = jsonFormat.type;
+      default = { };
+      description = ''
+        Configuration written to {file}`$XDG_CONFIG_HOME/nix-search-tv/config.json`.
+        See <https://github.com/3timeslazy/nix-search-tv?tab=readme-ov-file#configuration>
+        for the full list of options.
+      '';
+      example = lib.literalExpression ''
+        {
+          indexes = [ "nixpkgs" "home-manager" "nixos" ];
+
+          experimental = {
+            render_docs_indexes = {
+              nvf = "https://notashelf.github.io/nvf/options.html";
+            };
+          };
+        }
+      '';
+    };
+
+    enableTelevisionIntegration = lib.mkOption {
+      type = lib.types.bool;
+      default = config.programs.television.enable;
+      defaultText = lib.literalExpression "config.programs.television.enable";
+      description = ''
+        Enables integration with television. Creates a channel through
+        `programs.television.channels.nix-search-tv`, which are set as defaults
+        and can be overridden.
+        See [programs.television.channels](#opt-programs.television.channels)
+        for more information
+      '';
+      example = true;
+    };
+  };
+
+  config = lib.mkIf cfg.enable {
+    home.packages = lib.mkIf (cfg.package != null) [ cfg.package ];
+
+    xdg.configFile."nix-search-tv/config.json" = lib.mkIf (cfg.settings != { }) {
+      source = jsonFormat.generate "config.json" cfg.settings;
+    };
+
+    programs.television.channels.nix-search-tv = lib.mkIf cfg.enableTelevisionIntegration (
+      let
+        path = lib.getExe cfg.package;
+      in
+      {
+        metadata = {
+          name = "nix-search-tv";
+          description = "Search nix options and packages";
+        };
+
+        source.command = "${path} print";
+        preview.command = "${path} preview {}";
+      }
+    );
+
+    assertions = [
+      {
+        assertion = cfg.package != null || cfg.enableTelevisionIntegration;
+        message = "Cannot enable television integration when config.programs.nix-search-tv.package is null.";
+      }
+    ];
+  };
+}