docs: Add an option search to our documentation

docs/default.nix

@@ -1,5 +1,6 @@
 {
   pkgs ? import <nixpkgs> { config.enableUnfree = true; },
+  nuschtosSearch,
 }:
 let
   # Extend nixpkg's lib, so that we can handle recursive leaf types such as `either`
@@ -71,8 +72,7 @@ let
   hmOptions = builtins.removeAttrs (lib.evalModules {
     modules = [ (import ../wrappers/modules/hm.nix { inherit lib; }) ];
   }).options [ "_module" ];
-in
-rec {
+
   options-json =
     (pkgsDoc.nixosOptionsDoc {
       inherit
@@ -88,17 +88,38 @@ rec {
       inherit transformOptions;
       warningsAreErrors = false;
     }).optionsJSON;
+
+in
+{
+  inherit options-json;
+
   man-docs = pkgsDoc.callPackage ./man { inherit options-json; };
 }
-# Do not check if documentation builds fine on darwin as it fails:
-# > sandbox-exec: pattern serialization length 69298 exceeds maximum (65535)
-// lib.optionalAttrs (!pkgsDoc.stdenv.isDarwin) {
-  docs = pkgsDoc.callPackage ./mdbook {
-    inherit
-      helpers
-      modules
-      hmOptions
-      transformOptions
-      ;
-  };
-}
+// lib.optionalAttrs (!pkgsDoc.stdenv.isDarwin) (
+  let
+    mkSearch =
+      baseHref:
+      nuschtosSearch.packages.mkSearch {
+        optionsJSON = options-json + "/share/doc/nixos/options.json";
+        urlPrefix = "https://github.com/nix-community/nixvim/tree/main";
+        inherit baseHref;
+      };
+  in
+  {
+    # NuschtOS/search does not seem to work on darwin
+    search = mkSearch "/";
+
+    # Do not check if documentation builds fine on darwin as it fails:
+    # > sandbox-exec: pattern serialization length 69298 exceeds maximum (65535)
+    docs = pkgsDoc.callPackage ./mdbook {
+      inherit
+        helpers
+        modules
+        hmOptions
+        transformOptions
+        ;
+      # TODO: Find how to handle stable when 24.11 lands
+      search = mkSearch "/search/";
+    };
+  }
+)

docs/mdbook/SUMMARY.md

@@ -21,3 +21,4 @@
 ---
 
 [Contributing](./CONTRIBUTING.md)
+[NixVim Options Search](./search/index.html)

docs/mdbook/default.nix

@@ -6,6 +6,7 @@
   nixosOptionsDoc,
   transformOptions,
   hmOptions,
+  search,
 }:
 with lib;
 let
@@ -268,5 +269,7 @@ pkgs.stdenv.mkDerivation {
     ${prepareMD}
     mdbook build
     cp -r ./book/* $dest
+    mkdir -p $dest/search
+    cp -r ${search}/* $dest/search
   '';
 }

flake-modules/packages.nix

@@ -1,10 +1,16 @@
 {
   perSystem =
-    { pkgsUnfree, config, ... }:
+    {
+      pkgsUnfree,
+      config,
+      inputs',
+      ...
+    }:
     {
       packages = import ../docs {
         # Building the docs evaluates each plugin's default package, some of which are unfree
         pkgs = pkgsUnfree;
+        inherit (inputs') nuschtosSearch;
       };
 
       # Test that all packages build fine when running `nix flake check`.

flake.nix

@@ -33,6 +33,11 @@
       ```
     */
 
+    nuschtosSearch = {
+      url = "github:NuschtOS/search";
+      inputs.nixpkgs.follows = "nixpkgs";
+    };
+
     home-manager = {
       url = "github:nix-community/home-manager";
       inputs.nixpkgs.follows = "nixpkgs";
@@ -45,6 +50,7 @@
     devshell = {
       url = "github:numtide/devshell";
       inputs.nixpkgs.follows = "nixpkgs";
+      inputs.flake-utils.follows = "nuschtosSearch/flake-utils";
     };
     treefmt-nix = {
       url = "github:numtide/treefmt-nix";