wrappers: add meta.wrappers options to wrappers

Allows the docs to be a little less hard-coded.

Lays the groundwork for splitting up the platform-specific option docs
on a per-page basis.

docs/mdbook/default.nix

@@ -224,6 +224,35 @@ let
       in
       "${padding}- [${name}](${path})"
     ) docs.modules;
+
+    wrapperOptionFiles = lib.mapAttrs' (name: options: {
+      name = options.meta.wrapper.name.value;
+      # TODO:
+      # value.path = "./modules/${name}.md";
+      value.file = mkMDDoc options;
+    }) wrapperOptions;
+
+    wrapperOptionDocs =
+      pkgs.runCommandNoCCLocal "wrapper-option-doc"
+        {
+          __structuredAttrs = true;
+          files = lib.mapAttrs (name: value: value.file) mdbook.wrapperOptionFiles;
+          # TODO:
+          # paths = lib.mapAttrs (name: value: value.path) mdbook.wrapperOptionFiles;
+        }
+        ''
+          for name in "''${!files[@]}"
+          do
+            # $file contains the docs built by mkMDDoc
+            file="''${files[$name]}"
+            # TODO: consider putting wrapper docs in separate files:
+            # path="''${paths[$name]}"
+            echo >> "$out"
+            echo "## $name" >> "$out"
+            echo >> "$out"
+            cat "$file" >> $out
+          done
+        '';
   };
 
   wrapperOptions =
@@ -266,9 +295,7 @@ let
       --replace-fail "@NIXVIM_OPTIONS@" "$(cat ${pkgs.writeText "nixvim-options-summary.md" mdbook.nixvimOptions})"
 
     substituteInPlace ./modules/wrapper-options.md \
-      --replace-fail "@NIXOS_OPTIONS@" "$(cat ${mkMDDoc wrapperOptions.nixos})" \
-      --replace-fail "@HM_OPTIONS@" "$(cat ${mkMDDoc wrapperOptions.hm})" \
-      --replace-fail "@DARWIN_OPTIONS@" "$(cat ${mkMDDoc wrapperOptions.darwin})"
+      --replace-fail "@WRAPPER_OPTIONS@" "$(cat ${mdbook.wrapperOptionDocs})"
   '';
 in
 pkgs.stdenv.mkDerivation {

docs/modules/wrapper-options.md

@@ -8,17 +8,5 @@ See [Standalone Usage](./standalone.md) for more info.
 
 There are a few wrapper specific options that are documented below:
 
-## NixOS
-
-@NIXOS_OPTIONS@
-
-## home-manager
-
-@HM_OPTIONS@
-
-## nix-darwin
-
-@DARWIN_OPTIONS@
-
-<!-- TODO: Add @STANDALONE_OPTIONS@ if we ever have standalone-specific options -->
+@WRAPPER_OPTIONS@