expander

type DiscoveredPath struct {
	// Path relative to BaseDir (or the repo root if BaseDir is empty).
	Path string
	// BaseDir is the root directory for Path resolution.
	// If empty, Path is resolved against the main repo root.
	BaseDir string
	// Namespace overrides the namespace for all namespace-scoped resources
	// rendered from this path (e.g. Flux Kustomization spec.targetNamespace).
	Namespace string
	// Producer describes the Flux object or path that caused this path to be rendered.
	Producer string
	// Substitutions contains Flux postBuild inline substitutions for this path.
	Substitutions map[string]string
}

type DiscoveryRunner struct {
	Expanders     *Registry
	PathKey       PathKeyFunc
	RenderPath    RenderPathFunc
	MaxIterations int
}

type ExpandResult struct {
	// Resources contains additional resources produced by the expander.
	Resources resmap.ResMap
	// DiscoveredPaths contains new paths that should be rendered.
	DiscoveredPaths []DiscoveredPath
	// Errors contains non-fatal errors encountered during expansion
	// (e.g. a HelmRelease whose chart could not be resolved).
	// These do not stop expansion but should be surfaced to the user.
	Errors []error
	// DeferredErrors contains unresolved dependencies that may be discovered in
	// later iterations. Expanders must recompute these on every call; discovery
	// promotes only those remaining at the fixed point to Errors.
	DeferredErrors []error
}

type Expander interface {
	Expand(ctx context.Context, r *render.Render) (*ExpandResult, error)
}

type PathKeyFunc func(DiscoveredPath) string

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

type RenderPathFunc func(DiscoveredPath) error