compose

type BindMount struct {
	Source   string
	Target   string
	ReadOnly bool
}

type LoadOptions struct {
	// Files lists compose files in declaration order — earlier files
	// are overridden by later ones. Required.
	Files []string

	// WorkingDir is the directory compose-go uses as the base for
	// relative-path resolution inside the project (build contexts,
	// env_file paths, etc.). Required.
	WorkingDir string

	// ProjectName is set on the resulting types.Project. Engine derives
	// it from the workspace id; required.
	ProjectName string

	// Profiles activates compose profiles. Empty = no profiles
	// activated (which keeps services without `profiles:` running and
	// drops services that opt into a profile).
	Profiles []string

	// Env contains environment variables exposed to compose's $VAR
	// interpolation. Empty falls back to compose-go's default
	// behavior of reading os.Environ().
	Env []string
}

type Override struct {
	// Service is the name of the primary service to override; matches
	// devcontainer.json's "service" field.
	Service string

	// Image, when set, replaces the primary service's image and
	// clears its build directive (mutually exclusive in compose).
	// Engine sets this to the feature-extended image tag built
	// upstream.
	Image string

	// ExtraBindMounts are added to the primary service's volumes.
	// Engine adds the workspace folder bind here, plus any mounts
	// declared in devcontainer.json (cfg.Mounts).
	//
	// IMPORTANT: compose v2's default merge strategy for sequence
	// fields is REPLACEMENT, not concatenation. WriteRunOverride
	// reads the existing service's volumes from the loaded project
	// and emits the full merged list so we don't drop the user's
	// declarations.
	ExtraBindMounts []BindMount

	// ExtraEnvironment is merged into the primary service's
	// environment map. Compose merges maps natively, so we only
	// need to emit our additions.
	ExtraEnvironment map[string]string

	// Labels written on the primary service so Engine.Attach's
	// label-based lookup works (`dev.containers.id`, etc.).
	Labels map[string]string
}