v1alpha1

type Dependency struct {
	// Type defines the type of dependency.
	// +kubebuilder:validation:Enum=k8s;crd;xpkg
	Type string `json:"type"`

	// Xpkg defines the Crossplane package reference for the dependency.
	// Only used when Type is "xpkg".
	// +optional
	Xpkg *XpkgDependency `json:"xpkg,omitempty"`

	// Git defines the git repository source for the dependency.
	// Only used when Type is "crd".
	// +optional
	Git *GitDependency `json:"git,omitempty"`

	// HTTP defines the HTTP source for the dependency.
	// Only used when Type is "crd".
	// +optional
	HTTP *HTTPDependency `json:"http,omitempty"`

	// K8s defines the Kubernetes API version for the dependency.
	// Only used when Type is "k8s".
	// +optional
	K8s *K8sDependency `json:"k8s,omitempty"`
}

type Function struct {
	// Source defines how the function's runtime image is supplied.
	// +kubebuilder:validation:Enum=Directory;Tarball
	Source string `json:"source"`

	// Directory describes a function whose source code lives in a directory
	// under the project's functions path. The CLI builds the runtime image
	// from this source. Only used when Source is "Directory".
	// +optional
	Directory *FunctionDirectory `json:"directory,omitempty"`

	// Tarball describes a function whose runtime image is supplied as a
	// pre-built OCI image tarball. Only used when Source is "Tarball".
	// +optional
	Tarball *FunctionTarball `json:"tarball,omitempty"`
}

type FunctionDirectory struct {
	// Name is the name of the function. It must match the name of a
	// subdirectory under the project's functions path.
	Name string `json:"name"`
}

type FunctionTarball struct {
	// Name is the name of the function. It is used to derive the OCI
	// repository for the function's package as `<project-repository>_<name>`.
	Name string `json:"name"`

	// PathPrefix is the prefix of the per-architecture runtime image
	// tarballs, relative to the project root. For each target architecture
	// the CLI loads either `<pathPrefix>-<arch>.tar` or
	// `<pathPrefix>-<arch>.tar.gz`, preferring the former when both are
	// present.
	PathPrefix string `json:"pathPrefix"`
}

type GitDependency struct {
	// Repository is the git repository URL.
	Repository string `json:"repository"`

	// Ref is the git reference (branch, tag, or commit SHA).
	// +optional
	Ref string `json:"ref,omitempty"`

	// Path is the path within the repository to the API definition.
	// +optional
	Path string `json:"path,omitempty"`
}

type HTTPDependency struct {
	// URL is the HTTP/HTTPS URL to fetch the API dependency from.
	URL string `json:"url"`
}

type K8sDependency struct {
	// Version is the Kubernetes API version (e.g., "v1.33.0").
	Version string `json:"version"`
}

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

	Spec ProjectSpec `json:"spec"`
}

type ProjectPackageMetadata struct {
	Maintainer  string `json:"maintainer,omitempty"`
	Source      string `json:"source,omitempty"`
	License     string `json:"license,omitempty"`
	Description string `json:"description,omitempty"`
	Readme      string `json:"readme,omitempty"`
}

type ProjectPaths struct {
	// APIs is the directory holding the project's apis (XRDs and
	// compositions). If not specified, it defaults to `apis/`.
	APIs string `json:"apis,omitempty"`
	// Functions is the directory holding the project's functions. If not
	// specified, it defaults to `functions/`.
	Functions string `json:"functions,omitempty"`
	// Examples is the directory holding the project's examples. If not
	// specified, it defaults to `examples/`.
	Examples string `json:"examples,omitempty"`
	// Tests is the directory holding the project's tests. If not
	// specified, it defaults to `tests/`.
	Tests string `json:"tests,omitempty"`
	// Operations is the directory holding the project's operations. If not
	// specified, it defaults to `operations/`.
	Operations string `json:"operations,omitempty"`
	// Schemas is the directory holding language bindings for the project's XRDs
	// and dependencies. If not specified, it defaults to `schemas/`.
	Schemas string `json:"schemas,omitempty"`
}

type ProjectSchemas struct {
	// Languages restricts schema generation to the listed languages.
	// Supported values are "go", "json", "kcl", and "python". If not
	// specified, schemas are generated for all supported languages.
	Languages []string `json:"languages,omitempty"`
}

type ProjectSpec struct {
	ProjectPackageMetadata `json:",inline"`

	// Repository is the OCI repository to which the configuration package built
	// from this project will be pushed. It is also used to form the OCI
	// repository paths for embedded functions in the project by appending an
	// underscore and the function name. The repository can be overridden at
	// build time, but the repository used for build and push must match in
	// order for dependencies on embedded functions to resolve correctly.
	Repository string `json:"repository"`

	// Crossplane defines the Crossplane version constraints for the
	// configuration package built from the project. If not specified, the
	// constraint will be '>=v2.0.0-rc.0' such that the packages support any
	// Crossplane 2.x release.
	Crossplane *pkgmetav1.CrossplaneConstraints `json:"crossplane,omitempty"`
	// Dependencies are built-time and runtime dependencies of the project.
	Dependencies []Dependency `json:"dependencies,omitempty"`
	// Functions explicitly declares the embedded functions in this project.
	// If specified, automatic discovery of functions under the functions path
	// is disabled and only the functions listed here will be built and
	// packaged. If omitted, all subdirectories of the functions path are
	// treated as Directory-source functions and built automatically.
	Functions []Function `json:"functions,omitempty"`
	// Paths defines the relative paths to various parts of the project.
	Paths *ProjectPaths `json:"paths,omitempty"`
	// Architectures indicates for which architectures embedded functions should
	// be built. If not specified, it defaults to [amd64, arm64].
	Architectures []string `json:"architectures,omitempty"`
	// Schemas configures language-specific schema generation for the
	// project's XRDs and declared dependencies.
	Schemas *ProjectSchemas `json:"schemas,omitempty"`
	// ImageConfigs configure how images are fetched during
	// development. Currently, only rewriting is supported; other options will
	// be silently ignored. Note that these configs are for development only;
	// any necessary ImageConfigs for deployment into a cluster must be created
	// separately at deployment time.
	ImageConfigs []pkgv1beta1.ImageConfig `json:"imageConfigs,omitempty"`
}

type XpkgDependency struct {
	// APIVersion of the dependency package. This should be the package
	// apiVersion (e.g., pkg.crossplane.io/v1), not the package metadata type.
	APIVersion string `json:"apiVersion"`

	// Kind of the dependency package.
	Kind string `json:"kind"`

	// Package is the OCI image reference of the dependency package.
	Package string `json:"package"`

	// Version is the semantic version constraints for the dependency.
	Version string `json:"version"`

	// APIOnly indicates that this dependency is only needed for API/schema
	// purposes and should not be included as a runtime dependency in the
	// built package. Only xpkg dependencies can be runtime dependencies.
	// Default is false, meaning xpkg dependencies are runtime by default.
	// +optional
	APIOnly bool `json:"apiOnly,omitempty"`
}