dependencies

type Depths struct {
	// Dependencies bounds forward (what the roots depend on) expansion.
	Dependencies int
	// Dependents bounds reverse (what depends on the roots) expansion.
	Dependents int
}

type DescribeFunc func(stack string, components []string, processTemplates, processFunctions bool) (map[string]any, error)

type Direction string

type Options struct {
	// Format is the output format: tree (default), json, yaml, or levels.
	Format string
	// Direction selects forward, reverse, or both edge directions.
	Direction Direction
	// Component optionally filters the top-level entries to a single component.
	Component string
	// Stack optionally filters the top-level entries to a single stack.
	Stack string
	// Tags optionally filters the top-level entries to components whose
	// metadata.tags contains at least one of these tags (any-match).
	Tags []string
	// Labels optionally filters the top-level entries to components whose
	// metadata.labels contains every key=value pair (all-match).
	Labels map[string]string
	// LeftDelim/RightDelim are the configured template delimiters ("{{"/"}}"
	// when empty), used to detect — and best-effort resolve — still-unresolved
	// selector templates under custom 'templates.settings.delimiters'
	// configurations.
	LeftDelim  string
	RightDelim string
}

type ScopeRequest struct {
	// Components optionally narrows the seed to these component names.
	Components []string
	// Stack optionally narrows the seed to a single stack.
	Stack string
	// Tags narrows the seed to components whose metadata.tags match (any-match).
	Tags []string
	// Labels narrows the seed to components whose metadata.labels match (all-match).
	Labels map[string]string
	// Direction selects forward (dependencies), reverse (dependents), or both.
	Direction Direction
	// Depths bounds the closure expansion per direction (0 = unlimited).
	Depths Depths
	// ProcessTemplates/ProcessFunctions control evaluation in the resolved
	// (Phase C) describe passes; the lightweight pass always runs with both off.
	ProcessTemplates bool
	ProcessFunctions bool
	// LeftDelim/RightDelim are the configured template delimiters ("{{"/"}}"
	// when empty), used to detect — and best-effort resolve — templated
	// selectors in the lightweight graph.
	LeftDelim  string
	RightDelim string
}

type ScopeResult struct {
	// Stacks is the merged union of the resolved per-stack describe passes —
	// exactly the stacks the closure touches, fully evaluated. Feed this to
	// graph-backed execution (e.g. scheduleradapters.ExecuteTerraform).
	Stacks map[string]any
	// Closure is the final reachable closure computed against the resolved
	// graph. List commands use it to filter rows.
	Closure *dependency.Graph
}

type Selector struct {
	Components []string
	Stack      string
	Tags       []string
	Labels     map[string]string
	LeftDelim  string
	RightDelim string
}