install

type AtmosPackageParams struct {
	Name              string
	URI               string
	TargetPath        string
	Version           string
	RawVersion        string
	PkgType           PkgType
	SourceIsLocalFile bool
	Source            schema.AtmosVendorSource
}

type ComponentPackageParams struct {
	Name              string
	URI               string
	ComponentPath     string
	Version           string
	RawVersion        string
	PkgType           PkgType
	SourceIsLocalFile bool
	Spec              *schema.VendorComponentSpec
	IsMixin           bool
	MixinFilename     string
}

type CopyContext struct {
	SrcDir   string
	DstDir   string
	BaseDir  string
	Excluded []string
	Included []string
}

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

type InstallOptions struct {
	// DryRun performs only the side effects a real fetch would also trigger for
	// go-getter-unsupported URI schemes (custom Git detection), without writing anything.
	DryRun bool
	// RefreshLock bypasses FilterPending's materialization check, forcing every package back
	// through Install even when an existing vendor.lock.yaml receipt says it's unchanged.
	RefreshLock bool
	// LockEnforcement is one of LockEnforcementSilent/Warn/Strict, governing how FilterPending
	// reacts to a drifted package. Empty is treated as LockEnforcementWarn, the config default.
	LockEnforcement string
}

type PkgType int

type PrefixCopyContext struct {
	SrcDir     string
	DstDir     string
	GlobalBase string
	Prefix     string
	Excluded   []string
}

type ResolveEffectiveVersionInputs struct {
	AtmosConfig *schema.AtmosConfiguration
	// Name identifies the declaring source/target -- typically the component name.
	Name string
	// Source is the source's raw, un-templated URI/source string (before {{.Version}} is
	// substituted) -- see VersionResolveParams.SourceForGitURI.
	Source      string
	RawVersion  string
	Constraints *schema.VendorConstraints
	// Discriminator disambiguates multiple version declarations that would otherwise share the
	// same Name (e.g. a vendor.yaml source's per-target version overrides).
	Discriminator string
	RefreshLock   bool
	// Lister overrides the remote Git tag lister; nil defaults to version.DefaultLister.
	Lister version.RemoteLister
}

type Result struct {
	Name string
	Err  error
}

type VendorPackage struct {
	// Name identifies the package for progress/status reporting: a vendor.yaml source's
	// component name (or its URI when no component name is declared), a component.yaml's
	// component name, or "mixin <uri>" for a mixin.
	Name string
	// Version is the declared version/ref, shown alongside Name in status output. Empty when
	// the source has no explicit version. For a range-declared `version:`, this is the resolved
	// concrete version (what's actually fetched), not the raw range -- see RawVersion.
	Version string
	// RawVersion is the source's originally-declared version string, populated only when it
	// differs from the resolved Version above -- i.e. only for a range-declared `version:` (see
	// pkg/vendoring/install/version_resolve.go). Empty for an exact-pinned version:, matching
	// lockfile.Source.VersionConstraint's own omitempty convention.
	RawVersion string
	// contains filtered or unexported fields
}

type VersionResolveParams struct {
	// RawVersion is the source's (or per-target override's) declared version string, exactly as
	// written in vendor.yaml/component.yaml -- an exact pin, a semver range, or an opaque literal
	// (commit SHA, branch name).
	RawVersion string
	// Name identifies the declaring source/target for the lock cache key -- typically the
	// component name (or the raw source URI, when a source declares no component name).
	Name string
	// Discriminator, when non-empty, is folded into the lock cache key alongside Name. Needed when
	// multiple declarations share one Name but must resolve/cache independently -- e.g. a
	// vendor.yaml source's per-target `targets[].version` overrides, which all share the source's
	// Component name.
	Discriminator string
	// SourceForGitURI is the source's raw, un-templated URI/source string (before {{.Version}} is
	// substituted). Used both to extract the Git remote to list tags from, and as part of the lock
	// cache key -- it is stable across pulls regardless of how the range resolves, unlike an
	// installed target path, which may itself template {{.Version}} and therefore isn't knowable
	// until after this resolution completes.
	SourceForGitURI string
	// Constraints are the source's separate `constraints:` block. Only ExcludedVersions/
	// NoPrereleases are applied here -- Constraints.Version is an unrelated concept (the ceiling
	// `atmos vendor update`'s bump search may not exceed) and is never consulted by this function.
	Constraints *schema.VendorConstraints
	// RefreshLock forces fresh resolution even when a matching lock entry exists.
	RefreshLock bool
	// Lister lists remote Git tags; defaults to version.DefaultLister when nil.
	Lister version.RemoteLister
}