feat: Add individual doc generation script

fix: Fix filterOptions.nix and doc generation

devenv.nix

@@ -142,6 +142,15 @@
       EOF
     '';
   };
+  scripts."devenv-generate-individual-docs" = {
+    description = "Generate individual docs of all devenv modules";
+    exec = ''
+      mkdir -p docs/reference/autogen
+      nix build --impure --extra-experimental-features 'flakes nix-command' --show-trace --print-out-paths '.#devenv-generate-individual-docs'
+      cp -r result/docs/individual-docs/* docs/reference/autogen/
+      chmod -R u+rwX docs/reference/autogen/
+    '';
+  };
 
   pre-commit.hooks = {
     nixpkgs-fmt.enable = true;

filterOptions.nix

@@ -0,0 +1,27 @@
+# https://gitlab.com/rycee/nur-expressions/-/blob/master/doc/default.nix
+# https://github.com/molybdenumsoftware/pr-tracker/blob/main/filterOptions.nix
+{ concatMapAttrs
+, isOption
+, ...
+}: predicate: options:
+let
+  inherit (builtins) isAttrs;
+
+  recurse = path: options:
+    concatMapAttrs
+      (
+        name: value:
+          let
+            newPath = path ++ [ name ];
+          in
+          if !(isAttrs value)
+          then { ${name} = value; }
+          else if !(isOption value)
+          then { ${name} = recurse newPath value; }
+          else if predicate newPath value
+          then { ${name} = value; }
+          else { }
+      )
+      options;
+in
+recurse [ ] options

flake.nix

@@ -79,14 +79,93 @@
     {
       packages = forAllSystems (system:
         let
+          inherit (pkgs) lib;
           pkgs = nixpkgs.legacyPackages.${system};
           options = mkDocOptions pkgs;
+          filterOptions = import ./filterOptions.nix lib;
+          evaluatedModules = pkgs.lib.evalModules {
+            modules = [
+              ./src/modules/top-level.nix
+            ];
+            specialArgs = { inherit pre-commit-hooks pkgs inputs; };
+          };
+          generate-key-options = key:
+            filterOptions
+              (path: option:
+                lib.any (lib.hasSuffix "${key}.nix") option.declarations)
+              evaluatedModules.options;
+
+          optionsDocs = optionParameter: pkgs.nixosOptionsDoc {
+            options = optionParameter;
+            variablelistId = "options";
+            transformOptions = options: removeAttrs options [ "declarations" ];
+          };
         in
         {
           default = self.packages.${system}.devenv;
           devenv = mkPackage pkgs;
           devenv-docs-options = options.optionsCommonMark;
           devenv-docs-options-json = options.optionsJSON;
+          devenv-generate-individual-docs =
+            let
+              inherit (pkgs) lib;
+              languageOptions = builtins.mapAttrs (key: _: generate-key-options key) evaluatedModules.config.languages;
+              serviceOptions = builtins.mapAttrs (key: _: generate-key-options key) evaluatedModules.config.services;
+              processManagersOptions = builtins.mapAttrs (key: _: generate-key-options key) evaluatedModules.config.process-managers;
+              processedOptions = option: builtins.mapAttrs (key: options: optionsDocs options) option;
+            in
+            pkgs.stdenv.mkDerivation {
+              name = "pr-tracker-nixos-modules-manual";
+              src = ./.;
+              buildPhase = ''
+                                languageDir=./docs/individual-docs/languages
+                                serviceDir=./docs/individual-docs/services
+                                processManagerDir=./docs/individual-docs/process-managers
+                                mkdir -p $out/docs/individual-docs/language
+                                mkdir -p $out/docs/individual-docs/service
+                                mkdir -p $out/docs/individual-docs/process-managers
+                                ${lib.concatStringsSep "\n" (lib.mapAttrsToList (key: options:  ''
+                                    content=$(cat ${options.optionsCommonMark})
+                                    file=$languageDir/${key}.md
+
+                                    substituteInPlace $file \
+                                    --subst-var-by \
+                                    AUTOGEN_OPTIONS \
+                                    "$content"
+
+                                    cp $file $out/docs/individual-docs/language/${key}.md
+
+                                '') ( processedOptions languageOptions ))}
+
+                ${lib.concatStringsSep "\n" (lib.mapAttrsToList (key: options:  ''
+                                    content=$(cat ${options.optionsCommonMark})
+
+                                    file=$serviceDir/${key}.md
+
+                                    substituteInPlace $file \
+                                    --subst-var-by \
+                                    AUTOGEN_OPTIONS \
+                                    "$content"
+
+                                    cp $file $out/docs/individual-docs/service/${key}.md
+
+                                '') ( processedOptions serviceOptions ))}
+
+                ${lib.concatStringsSep "\n" (lib.mapAttrsToList (key: options:  ''
+                                    content=$(cat ${options.optionsCommonMark})
+
+                                    file=$processManagerDir/${key}.md
+
+                                    substituteInPlace $file \
+                                    --subst-var-by \
+                                    AUTOGEN_OPTIONS \
+                                    "$content"
+
+                                    cp $file $out/docs/individual-docs/process-managers/${key}.md
+                                '') ( processedOptions  processManagersOptions))}
+
+              '';
+            };
         });
 
       modules = ./src/modules;