feat(nix): generate module options docs and sync to website

- Add nix/generate-hm-options.nix to export HM and NixOS module options as JSON via nixosOptionsDoc
- Expose hm-options-json and nixos-options-json packages in flake.nix
- Add CI workflow to auto-build and push JSONs to mangowm.github.io on module changes
- Add missing description to hm-modules enable option
This commit is contained in:
Ruixi-rebirth 2026-05-12 15:34:14 +08:00
parent 129d3da44e
commit 0a687f808d
No known key found for this signature in database
GPG key ID: 847E32F6F2F1D108
5 changed files with 97 additions and 0 deletions

28
nix/generate-options.nix Normal file
View file

@ -0,0 +1,28 @@
self:
{
pkgs,
lib ? pkgs.lib,
module,
optionPrefix,
}:
let
eval = lib.evalModules {
modules = [
(import module self)
{ _module.check = false; }
];
specialArgs = { inherit pkgs; };
};
optionsDoc = pkgs.nixosOptionsDoc {
options = eval.options;
transformOptions =
opt:
opt
// {
visible = opt.visible && !opt.internal;
name = lib.removePrefix optionPrefix opt.name;
};
};
in
optionsDoc.optionsJSON

View file

@ -22,6 +22,7 @@ in
enable = mkOption {
type = types.bool;
default = false;
description = "Whether to enable mangowm, a Wayland compositor based on dwl.";
};
package = lib.mkOption {
type = lib.types.package;