components

type Component interface {
	// GetName returns the name of the component.
	GetName() string
	// GetConfig returns the static configuration for the component.
	GetConfig() *projectconfig.ComponentConfig
	// GetSpec returns an abstract object that represents the specification for building the component.
	GetSpec() specs.ComponentSpec
	// GetDetails inspects the component and retrieves more detailed information; non-trivial
	// computation may be required to collect these details.
	GetDetails() (info *ComponentDetails, err error)
}

type ComponentDetails struct {
	// We embed the details retrieved from the component's spec as well.
	specs.ComponentSpecDetails

	// Config holds the static configuration for the component, including its name.
	Config projectconfig.ComponentConfig
}

type ComponentFilter struct {
	// Exact names to match against component groups. Does not support patterns or wildcards.
	ComponentGroupNames []string
	// Patterns to match against components; if no wildcards are present in the patterns, then an exact match
	// is required, otherwise lack of matches is still success.
	ComponentNamePatterns []string
	// Paths to individual spec files. Does not support patterns or wild-carding.
	SpecPaths []string
	// If true, then *all* known components are included in the result set.
	IncludeAllComponents bool
	// SkipLockValidation disables lock file consistency checks for this
	// filter's resolution. Commands that write lock files (update) or are
	// read-only (list) set this to true.
	SkipLockValidation bool
}

type ComponentGroup struct {
	// The group's name.
	Name string
	// A list of the group's members.
	Components []ComponentGroupMember
}

type ComponentGroupMember struct {
	// Name of the component.
	ComponentName string
	// Path to the component's spec (optional).
	SpecPath string
}

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

type Resolver struct {

	// SuppressLockWarnings disables advisory warnings emitted during lock
	// population (e.g., staleness warning when config pin differs from locked
	// commit). Set this for commands that are about to refresh the lock
	// themselves (e.g., 'component update') to avoid noise telling the user
	// to do what they're already doing.
	SuppressLockWarnings bool
	// CheckFreshness enables fingerprint-based freshness computation during
	// component resolution. When true, each component's
	// [projectconfig.ComponentLockData.Freshness] is set based on comparing
	// stored hashes to recomputed ones. When false (default), freshness
	// remains [projectconfig.FreshnessUnknown].
	//
	// Off by default because most commands (build, render, prepare-sources)
	// consume locked state as-is and don't need to know whether it's stale.
	// Only 'component update' enables this — it uses the freshness status to
	// decide which components need re-resolution and which can be skipped.
	CheckFreshness bool
	// contains filtered or unexported fields
}