config

type Config struct {
	// Sources is an ordered list of fs.FS layers. Each source is scanned
	// for *.toml + *.cue files; later sources override earlier ones for
	// the same namespace (for TOML) or unify with them (for CUE).
	//
	// Typical ordering:
	//
	//	[]fs.FS{
	//	    hexdb.Configs(),       // framework defaults + schema
	//	    hexcache.Configs(),
	//	    appconfig.Files,        // consumer overrides + own schema.cue
	//	}
	Sources []fs.FS

	// SourcesDir is the subdirectory scanned within each source. Empty
	// means the source's root.
	SourcesDir string

	// UserDir is an optional directory on disk containing user override
	// files. For each namespace <name>, if UserDir contains a matching
	// <name>.toml it is merged over the layered sources. Leading ~ in
	// UserDir is expanded to the user's home directory. Missing UserDir
	// is not an error.
	UserDir string

	// EnvMap is an fs.FS containing the env-var binding YAML. Optional.
	EnvMap fs.FS

	// EnvMapFile is the path within EnvMap to the binding YAML. When empty,
	// no env-var bindings are applied.
	EnvMapFile string

	// EnvFile is an optional path to a .env file loaded before env-var
	// bindings resolve. Missing files are ignored.
	//
	// When Environment is non-empty, Load also attempts to load
	// `<EnvFile>.<Environment>` FIRST (so values there win over the
	// base .env). Common pattern:
	//
	//	.env               local defaults (typically gitignored)
	//	.env.test          committed; test overrides
	//	.env.production    committed; production overrides
	//
	// OS env still wins over anything godotenv loads.
	EnvFile string

	// Environment names the runtime environment. When non-empty, Load
	// also loads `<EnvFile>.<Environment>` (see EnvFile above) to
	// apply env-specific overrides.
	//
	// Env-bound values (declared in EnvMap / env.yaml) participate in
	// CUE schema validation at Load time, so bad env overrides fail
	// loudly like bad TOML values would.
	Environment string

	// StrictValidation, when true, causes Load to return an error if any
	// loaded TOML namespace has no matching schema. Off by default —
	// consumers opt into schemas per-namespace.
	StrictValidation bool
}

type Store struct {
	// contains filtered or unexported fields
}