patternmapper

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

type MappingRule struct {
	// Source path pattern (e.g., "app.settings.api_key", "app.*.key", "app.{env}.api-key")
	// Supports:
	//   - Exact match: "app.settings.api_key"
	//   - Wildcard: "app.*.api_key" (matches but doesn't capture)
	//   - Named capture: "app.{env}.api_key" (captures "env")
	Source string

	// Target section slug (e.g., "demo")
	// If not set in child rules, inherits from parent rule
	TargetSection string

	// Target field name (supports captures like "{env}-api-key")
	// Capture references use the format "{name}" where name is a capture group from Source
	TargetField string

	// Optional: nested rules for mapping child objects
	// If provided, Source should point to an object, and Rules maps its children
	Rules []MappingRule

	// Optional: whether to skip if source doesn't exist (default: false, means skip silently)
	// If Required is true, pattern must match or an error is returned
	Required bool
}