init

nix/module.nix

@@ -0,0 +1,92 @@
+# NixOS module: automatic nushell completion indexing
+#
+# Indexes completions using three strategies in priority order:
+#   1. Native completion generators (e.g. CMD completions nushell)
+#   2. Manpage parsing
+#   3. --help output parsing
+#
+# Produces a directory of .json/.nu files at build time.
+# The `complete` command reads from this directory as a system overlay.
+#
+# Usage:
+#   { pkgs, ... }: {
+#     imports = [ ./path/to/inshellah/nix/module.nix ];
+#     programs.inshellah.enable = true;
+#   }
+
+{
+  config,
+  lib,
+  pkgs,
+  ...
+}:
+
+let
+  cfg = config.programs.inshellah;
+in
+{
+  options.programs.inshellah = {
+    enable = lib.mkEnableOption "nushell completion indexing via inshellah";
+
+    package = lib.mkOption {
+      type = lib.types.package;
+      description = "package to use for indexing completions";
+    };
+
+    completionsPath = lib.mkOption {
+      type = lib.types.str;
+      default = "/share/inshellah";
+      description = ''
+        subdirectory within the system profile where completion files
+        are placed. used as --system-dir for the completer.
+      '';
+    };
+
+    ignoreCommands = lib.mkOption {
+      type = lib.types.listOf lib.types.str;
+      default = [ ];
+      example = [ "problematic-tool" ];
+      description = ''
+        list of command names to skip during completion indexing
+      '';
+    };
+
+    helpOnlyCommands = lib.mkOption {
+      type = lib.types.listOf lib.types.str;
+      default = [ ];
+      example = [ "nix" ];
+      description = ''
+        list of command names to skip manpage parsing for,
+        using --help scraping instead
+      '';
+    };
+
+    snippet = lib.mkOption {
+      type = lib.types.str;
+      readOnly = true;
+    };
+  };
+
+  config = lib.mkIf cfg.enable {
+    environment.systemPackages = [ config.programs.inshellah.package ];
+    environment.extraSetup =
+      let
+        inshellah = "${cfg.package}/bin/inshellah";
+        destDir = "$out${cfg.completionsPath}";
+        ignoreFile = pkgs.writeText "inshellah-ignore" (lib.concatStringsSep "\n" cfg.ignoreCommands);
+        ignoreFlag = lib.optionalString (cfg.ignoreCommands != [ ]) " --ignore ${ignoreFile}";
+        helpOnlyFile = pkgs.writeText "inshellah-help-only" (lib.concatStringsSep "\n" cfg.helpOnlyCommands);
+        helpOnlyFlag = lib.optionalString (cfg.helpOnlyCommands != [ ]) " --help-only ${helpOnlyFile}";
+      in
+      ''
+        mkdir -p ${destDir}
+
+        if [ -d "$out/bin" ] && [ -d "$out/share/man" ]; then
+          ${inshellah} index "$out" --dir ${destDir}${ignoreFlag}${helpOnlyFlag} \
+            2>/dev/null || true
+        fi
+
+        find ${destDir} -maxdepth 1 -empty -delete
+      '';
+  };
+}