v1

type ClusterProjection struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   ClusterProjectionSpec   `json:"spec,omitempty"`
	Status ClusterProjectionStatus `json:"status,omitempty"`
}

type ClusterProjectionDestination struct {
	// Namespaces is an explicit list of destination namespaces. Mutually
	// exclusive with NamespaceSelector. Each entry is a DNS-1123 label;
	// at least one entry is required when this field is set.
	// +optional
	// +listType=set
	// +kubebuilder:validation:MinItems=1
	Namespaces []string `json:"namespaces,omitempty"`

	// NamespaceSelector picks destination namespaces by label. Mutually
	// exclusive with Namespaces.
	// +optional
	NamespaceSelector *metav1.LabelSelector `json:"namespaceSelector,omitempty"`

	// Name in each destination namespace (DNS-1123 subdomain). Defaults to
	// Source.Name when empty. The same Name is written into every targeted
	// namespace.
	// +optional
	// +kubebuilder:validation:Pattern=`^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$`
	// +kubebuilder:validation:MaxLength=253
	Name string `json:"name,omitempty"`
}

type ClusterProjectionList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []ClusterProjection `json:"items"`
}

type ClusterProjectionSpec struct {
	// Source identifies the object to project.
	Source SourceRef `json:"source"`

	// Destination configures the fan-out target set and optional rename.
	Destination ClusterProjectionDestination `json:"destination"`

	// Overlay applies metadata patches uniformly to every projected copy.
	// (Per-target overlays are not supported in v0.3.)
	// +optional
	Overlay Overlay `json:"overlay,omitempty"`
}

type ClusterProjectionStatus struct {
	// Conditions: SourceResolved, DestinationWritten, Ready.
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`

	// DestinationName is the resolved name of the destination object,
	// identical across all targeted namespaces. Populated after the first
	// successful write; empty before that.
	// +optional
	DestinationName string `json:"destinationName,omitempty"`

	// NamespacesWritten is the count of namespaces in which the destination
	// was successfully created or updated during the most recent reconcile.
	// +optional
	NamespacesWritten int32 `json:"namespacesWritten,omitempty"`

	// NamespacesFailed is the count of namespaces where the write failed
	// during the most recent reconcile. The DestinationWritten condition's
	// message carries a (truncated) list of failed namespace names.
	// +optional
	NamespacesFailed int32 `json:"namespacesFailed,omitempty"`
}

type Overlay struct {
	// Labels are merged onto the destination's metadata.labels. Overlay
	// entries win on key conflicts with the source (overlay-last semantics);
	// source-only and overlay-only keys are kept as-is.
	// +optional
	Labels map[string]string `json:"labels,omitempty"`

	// Annotations are merged onto the destination's metadata.annotations.
	// Same overlay-wins merge rule as Labels.
	// +optional
	Annotations map[string]string `json:"annotations,omitempty"`
}

type Projection struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   ProjectionSpec   `json:"spec,omitempty"`
	Status ProjectionStatus `json:"status,omitempty"`
}

type ProjectionDestination struct {
	// Name in the destination namespace (DNS-1123 subdomain). Defaults to
	// Source.Name when empty.
	// +optional
	// +kubebuilder:validation:Pattern=`^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$`
	// +kubebuilder:validation:MaxLength=253
	Name string `json:"name,omitempty"`
}

type ProjectionList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []Projection `json:"items"`
}

type ProjectionSpec struct {
	// Source identifies the object to project.
	Source SourceRef `json:"source"`

	// Destination optionally renames the destination. The destination
	// namespace is implicitly the Projection's own namespace and cannot
	// be set; for cross-namespace mirroring use ClusterProjection.
	// +optional
	Destination ProjectionDestination `json:"destination,omitempty"`

	// Overlay applies metadata patches on top of the projected object.
	// +optional
	Overlay Overlay `json:"overlay,omitempty"`
}

type ProjectionStatus struct {
	// Conditions: SourceResolved, DestinationWritten, Ready.
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`

	// DestinationName is the resolved name of the destination object after
	// applying any rename override (`spec.destination.name`) or defaulting to
	// `spec.source.name`. Populated by the controller after a successful
	// write; empty before the first reconcile completes.
	// +optional
	DestinationName string `json:"destinationName,omitempty"`
}

type SourceRef struct {
	// Group is the API group of the source object. Empty string means the
	// core group (e.g. ConfigMap, Secret, Service).
	// +optional
	// +kubebuilder:validation:Pattern=`^$|^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$`
	Group string `json:"group,omitempty"`

	// Version is the API version of the source object within its Group. Omit
	// for non-core groups to use the RESTMapper's preferred served version
	// (the source automatically follows CRD version promotions). When set,
	// must match Kubernetes' canonical version-string shape (`vN`,
	// `vNalphaM`, `vNbetaM`).
	// +optional
	// +kubebuilder:validation:Pattern=`^$|^v[0-9]+((alpha|beta)[0-9]+)?$`
	Version string `json:"version,omitempty"`

	// Kind is the API Kind of the source object (PascalCase).
	// +kubebuilder:validation:Pattern=`^[A-Z][a-zA-Z0-9]*$`
	Kind string `json:"kind"`

	// Namespace where the source object lives.
	// +kubebuilder:validation:Pattern=`^[a-z0-9]([-a-z0-9]*[a-z0-9])?$`
	// +kubebuilder:validation:MaxLength=63
	Namespace string `json:"namespace"`

	// Name of the source object (DNS-1123 subdomain).
	// +kubebuilder:validation:Pattern=`^[a-z0-9]([-a-z0-9]*[a-z0-9])?(\.[a-z0-9]([-a-z0-9]*[a-z0-9])?)*$`
	// +kubebuilder:validation:MaxLength=253
	Name string `json:"name"`
}