wsl

type Distro struct {
	// Image is the config value this resolved from ("nix", "alpine", the
	// URL, or the path) — used in logs and errors.
	Image  string
	Recipe *Recipe
	URL    string
	Path   string
	// VerifyCommand / VerifyContains: see Recipe. External images get a
	// generic liveness check — their content is the publisher's contract.
	VerifyCommand  string
	VerifyContains string
}

type NixHomeOpts struct {
	// Attr is the homeConfigurations attribute name. Empty defaults to the
	// WSL_USER build arg (the distro user), which is what the embedded
	// flake uses. External flakes (community-home) use a naming scheme
	// like "wsl-<stack>-<arch>".
	Attr string
	// User is the username the external flake's config was built for
	// (e.g. "nixos"). Empty means it matches the WSL distro user and no
	// path redirection is needed.
	User string
}

type Recipe struct {
	// Image is the recipe selector name ("nix", "alpine"); it keys the
	// cache filename and log lines.
	Image string
	// User is the distro's default user, matched to the Windows account.
	User string
	// DistroName is the WSL registration name.
	DistroName string
	// Dockerfile is the full rootfs recipe.
	Dockerfile string
	// BuildArgs are extra --build-arg values (WSL_USER is set from User
	// automatically).
	BuildArgs map[string]string
	// ContextFiles are extra files written into the docker build context,
	// keyed by relative path (subdirectories allowed).
	ContextFiles map[string][]byte
	// Fingerprint is extra cache-key material for inputs not captured
	// above (e.g. a remote flake ref that cannot be content-hashed).
	Fingerprint string
	// VerifyCommand is a /bin/sh -lc command run inside the imported
	// distro after the build; VerifyContains must appear in its output.
	VerifyCommand  string
	VerifyContains string
}