kubernetes

type ComposeProjectRequest struct {
	// Spec is the parsed devcontainer.json (must be in compose mode).
	Spec *spec.DevContainer

	// SpecPath is the host path the spec was loaded from. Stored as
	// AnnotationConfigFile.
	SpecPath string

	// LocalWorkspace is the host workspace path. Stored as
	// AnnotationLocalFolder and used as the default workspace
	// HostPath source.
	LocalWorkspace string

	// ContainerWorkspace is where the workspace mounts inside the
	// primary container. Falls back to spec.WorkspaceFolder, then
	// "/workspaces/<basename>".
	ContainerWorkspace string

	// Project is the parsed compose project. Required.
	Project *composetypes.Project

	// PrimaryImage, when non-empty, replaces the primary service's
	// compose `image:`. Used to point the Pod at a feature-derived
	// image produced by pkg/host/dockercompose.BuildPrimaryImage.
	PrimaryImage string

	// Features as resolved by pkg/features. Their containerEnv,
	// init/privileged/capAdd/securityOpt, and mounts merge into the
	// primary container only — sidecar services don't see them.
	Features []features.Resolved

	// Name and Namespace seed metadata.
	Name      string
	Namespace string

	// Labels and Annotations seed metadata.
	Labels      map[string]string
	Annotations map[string]string

	// WorkspaceVolumeSource overrides the workspace volume source.
	// When nil, falls back to a HostPath sourced from LocalWorkspace
	// (matching the single-container projection's default).
	WorkspaceVolumeSource *corev1.VolumeSource

	// VolumeStorageClass is set on PVCs generated for compose named
	// volumes. Empty means the cluster's default storage class.
	VolumeStorageClass string

	// VolumeStorageRequest is the per-PVC storage request. Defaults
	// to DefaultComposeVolumeStorage when zero.
	VolumeStorageRequest resource.Quantity

	// Profiles activates compose service profiles. Services whose
	// `profiles:` list is non-empty are excluded from the projected
	// Pod unless one of their entries matches Profiles (or Profiles
	// contains "*"). The primary service stays enabled regardless.
	Profiles []string

	// LocalEnv is the lookup table for compose `secrets:` /
	// `configs:` declared with `environment:` source. Materializing
	// happens at projection time, so the env variable's value is
	// baked into the resulting Secret/ConfigMap.
	LocalEnv map[string]string
}

type ComposeProjection struct {
	Pod                    *corev1.Pod
	PersistentVolumeClaims []*corev1.PersistentVolumeClaim
	ConfigMaps             []*corev1.ConfigMap
	Secrets                []*corev1.Secret
}

type ProjectRequest struct {
	// Spec is the parsed devcontainer.json. Required.
	Spec *spec.DevContainer

	// SpecPath is the host-side path the spec was loaded from. When
	// non-empty it's stored in the AnnotationConfigFile annotation so
	// downstream tooling can reverse-look-up the source file.
	SpecPath string

	// LocalWorkspace is the host-side workspace folder (absolute). When
	// non-empty it's stored in AnnotationLocalFolder and used as the
	// default HostPath source for the workspace volume.
	LocalWorkspace string

	// ContainerWorkspace is the path inside the container where the
	// workspace is mounted. Falls back to spec.WorkspaceFolder, then
	// "/workspaces/<basename>".
	ContainerWorkspace string

	// Image is the already-built container image reference.
	Image string

	// Features as resolved by pkg/features. Their containerEnv,
	// init/privileged/capAdd/securityOpt, and mounts merge into the
	// pod the same way the docker host merges them.
	Features []features.Resolved

	// Name is the metadata.name written onto the projected Pod. May be
	// empty — the caller can fill it in or use generateName.
	Name string

	// Namespace is metadata.namespace. May be empty.
	Namespace string

	// ContainerName overrides the container's name. Defaults to
	// DefaultContainerName.
	ContainerName string

	// Labels and Annotations are seeded onto metadata. The package adds
	// AnnotationLocalFolder and AnnotationConfigFile on top.
	Labels      map[string]string
	Annotations map[string]string

	// WorkspaceVolumeSource overrides the default workspace volume.
	// When nil, a HostPath sourced from LocalWorkspace is used — a fit
	// for single-node clusters (kind, minikube, docker-desktop) where
	// the host workspace is reachable from the kubelet. Set to a
	// PersistentVolumeClaim or other source for remote clusters.
	WorkspaceVolumeSource *corev1.VolumeSource
}

type Projection struct {
	Pod *corev1.Pod
}