build

type BuildPlatformsVar struct{}

type BuildTarget interface {
	SourcePackage() schema.PackageName
	SourceLabel() string

	TargetPlatform() *specs.Platform
	// See Plan.PublishName.
	PublishName() compute.Computable[oci.RepositoryWithParent]
}

type Configuration interface {
	BuildTarget

	// If the builder has the ability to produce with buildkit, that's
	// preferred. A reason to do this is for instance when we want to merge
	// multiple images together, and want to defer the merge to buildkit.
	PrefersBuildkit() bool
	Workspace() Workspace
}

type Plan struct {
	SourcePackage schema.PackageName
	SourceLabel   string
	BuildKind     storage.Build_Kind
	Spec          Spec
	Workspace     Workspace
	Platforms     []specs.Platform

	// The caller has given us a hint or where the built image will be uploaded
	// to, in case the builder implementation can use this information for
	// optimization purposes. This may be null, and an implementation can always
	// elect to ignore it.
	PublishName compute.Computable[oci.RepositoryWithParent]
}

type Spec interface {
	BuildImage(context.Context, pkggraph.SealedContext, Configuration) (compute.Computable[oci.Image], error)
	PlatformIndependent() bool
}

type Workspace interface {
	ModuleName() string
	Abs() string
	IsExternal() bool
	ReadOnlyFS(rel ...string) fs.FS

	// ChangeTrigger returns an observable which will get a new value whenever a
	// path under `rel` is modified, and the filter function doesn't reject.
	// Excludes is a list of excluded files, in buildkit format. Implementations
	// are REQUIRED to depend on ChangeTrigger if they rely on the contents of
	// the workspace.
	ChangeTrigger(rel string, excludes []string) compute.Computable[any]
}