states

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

type CacheMount struct {
	// RunOption Run options
	RunOption llb.RunOption
	// Persisted should the cache be persisted to image.
	Persisted bool
}

type DockerTarImageSolver interface {
	SolveImage(ctx context.Context, mts *MultiTarget, dockerTag string, outFile string, printOutput bool) error
}

type ImageDef struct {
	Platform  platutil.Platform
	MTS       *MultiTarget
	ImageName string
}

type ImageResult struct {
	ImageDescriptor          *ocispecs.Descriptor
	Annotations              map[string]string
	IntermediateImageName    string
	FinalImageName           string
	FinalImageNameWithDigest string
	ImageDigest              string
	ConfigDigest             string
	NewInterImgFormat        bool
}

type ImageSolverResults struct {
	ResultChan  chan *ImageResult
	ErrChan     chan error
	ReleaseFunc func()
}

type InteractiveSession struct {
	State       pllb.State
	CommandStr  string
	Kind        InteractiveSessionKind
	Initialized bool
}

type InteractiveSessionKind string

type MultiImageSolver interface {
	SolveImages(ctx context.Context, defs []*ImageDef) (*ImageSolverResults, error)
}

type MultiTarget struct {
	// Visited represents the previously visited states, grouped by target
	// name. Duplicate targets are possible if same target is called with different
	// build args.
	Visited VisitedCollection
	// Final is the main target to be built.
	Final *SingleTarget
}

type RunPush struct {
	State              pllb.State
	InteractiveSession InteractiveSession
	CommandStrs        []string
	SaveLocals         []SaveLocal
	SaveImages         []SaveImage
	HasState           bool
}

type SaveImage struct {
	State               pllb.State
	Platform            platutil.Platform
	Image               *image.Image
	DockerTag           string
	HasPushDependencies bool
	// CacheHint instructs earth to save a separate ref for this image, even if no tag is provided.
	CacheHint    bool
	InsecurePush bool
	// ForceSave indicates whether the image should be force-saved and (possibly pushed).
	ForceSave bool
	// CheckDuplicate indicates whether to check if the image name shows up
	// multiple times during output.
	CheckDuplicate bool
	// NoManifestList indicates that the image should not include a manifest
	// list (usually used for multi-platform setups). This means that the image
	// can only be a single-platform image.
	NoManifestList bool
	Push           bool
	// true when the --platform value was set (either on cli, or via FROM --platform=..., or BUILD --platform=...)
	HasPlatform bool
	SkipBuilder bool // for use with WAIT/END
}

type SaveLocal struct {
	// DestPath is the local dest path to copy the artifact to.
	DestPath string
	// ArtifactPath is the relative path within the artifacts image.
	ArtifactPath string
	// Index is the index number of the "save as local" command encountered. Starts as 0.
	Index int
	// IfExists allows the artifact to be optional.
	IfExists bool
}

type SingleTarget struct {
	MainState      pllb.State
	ArtifactsState pllb.State
	Target         domain.Target

	SaveLocals             []SaveLocal
	SeparateArtifactsState []pllb.State

	// WaitBlocks contains the caller's waitblock plus any additional waitblocks defined in the target
	WaitBlocks []WaitBlock
	// WaitItems contains all wait items which are created by the target
	// it exists for tracking items in the target vs a caller's wait block that is shared between multiple targets
	WaitItems  []WaitItem
	SaveImages []SaveImage

	// ID is a random unique string.
	ID string

	GlobalImports      map[string]domain.ImportTrackerVal
	MainImage          *image.Image
	PlatformResolver   *platutil.Resolver
	VarCollection      *variables.Collection
	InteractiveSession InteractiveSession
	RunPush            RunPush

	// HasDangling represents whether the target has dangling instructions -
	// ie if there are any non-SAVE commands after the first SAVE command,
	// or if the target is invoked via BUILD command (not COPY nor FROM).
	HasDangling bool
	// RanFromLike represents whether we have encountered a FROM-like command
	// (eg FROM, FROM DOCKERFILE, LOCALLY).
	RanFromLike bool
	// RanInteractive represents whether we have encountered an --interactive command.
	RanInteractive bool
	// contains filtered or unexported fields
}

type SolveCache = synccache.Cache[StateKey, pllb.State]

type StateKey string

type VisitedCollection interface {
	// All returns all visited items.
	All() []*SingleTarget
	// Add adds a target to the collection, if it hasn't yet been visited. The returned sts is
	// either the previously visited one or a brand new one.
	Add(
		ctx context.Context,
		target domain.Target,
		platr *platutil.Resolver,
		allowPrivileged bool,
		overridingVars *variables.Scope,
		parentDepSub chan string,
	) (*SingleTarget, bool, error)
}

type WaitBlock interface {
	Wait(ctx context.Context, push, save bool) error
	AddItem(item WaitItem)
	SetDoSaves()
	SetDoPushes()
}

type WaitItem interface {
	SetDoPush()
	SetDoSave()
}