maomaowm/nix/generate-options.nix

self:
{
  pkgs,
  lib ? pkgs.lib,
  module,
  optionPrefix,
}:
let
  # Absolute store path of the flake root, used to compute relative subpaths
  repoPath = toString self;

  eval = lib.evalModules {
    modules = [
      (import module self)
      { _module.check = false; }
    ];
    specialArgs = { inherit pkgs; };
  };

  # Relative path of the module file within the repo (e.g. "nix/hm-modules.nix")
  moduleSubpath = lib.removePrefix "/" (lib.removePrefix repoPath (toString module));

  # Declaration entry linking each option back to its source file on GitHub
  moduleDeclaration = {
    url = "https://github.com/mangowm/mango/blob/main/${moduleSubpath}";
    name = "<mango/${moduleSubpath}>";
  };

  optionsDoc = pkgs.nixosOptionsDoc {
    options = eval.options;
    transformOptions =
      opt:
      opt
      // {
        visible = opt.visible && !opt.internal;
        # Strip the option prefix so docs show "enable" instead of "programs.mango.enable"
        name = lib.removePrefix optionPrefix opt.name;
        declarations = [ moduleDeclaration ];
      };
  };
in
optionsDoc.optionsJSON