config

type ComposeContainer struct {
	DockerComposeFile StrArray `json:"dockerComposeFile,omitempty"`
	Service           string   `json:"service,omitempty"`
	RunServices       []string `json:"runServices,omitempty"`
}

type ConfigBuildOptions struct {
	Dockerfile string             `json:"dockerfile,omitempty"`
	Context    string             `json:"context,omitempty"`
	Args       map[string]*string `json:"args,omitempty"`
	Target     string             `json:"target,omitempty"`
	CacheFrom  StrArray           `json:"cacheFrom,omitempty"`
	Options    []string           `json:"options,omitempty"`
}

type DevContainerActions struct {
	OnCreateCommand      LifecycleHook  `json:"onCreateCommand,omitempty"`
	UpdateContentCommand LifecycleHook  `json:"updateContentCommand,omitempty"`
	PostCreateCommand    LifecycleHook  `json:"postCreateCommand,omitempty"`
	PostStartCommand     LifecycleHook  `json:"postStartCommand,omitempty"`
	PostAttachCommand    LifecycleHook  `json:"postAttachCommand,omitempty"`
	Customizations       map[string]any `json:"customizations,omitempty"`
}

type DevContainerConfig struct {
	DevContainerConfigBase `json:",inline"`
	DevContainerActions    `json:",inline"`
	NonComposeBase         `json:",inline"`
	ImageContainer         `json:",inline"`
	ComposeContainer       `json:",inline"`
	DockerfileContainer    `json:",inline"`

	// Origin is the absolute path to the devcontainer.json file (not serialized).
	Origin string `json:"-"`
}

type DevContainerConfigBase struct {
	Name                        string                   `json:"name,omitempty"`
	Features                    map[string]any           `json:"features,omitempty"`
	OverrideFeatureInstallOrder []string                 `json:"overrideFeatureInstallOrder,omitempty"`
	ForwardPorts                StrIntArray              `json:"forwardPorts,omitempty"`
	PortsAttributes             map[string]PortAttribute `json:"portsAttributes,omitempty"`
	OtherPortsAttributes        *PortAttribute           `json:"otherPortsAttributes,omitempty"`
	UpdateRemoteUserUID         *bool                    `json:"updateRemoteUserUID,omitempty"`
	RemoteEnv                   map[string]string        `json:"remoteEnv,omitempty"`
	RemoteUser                  string                   `json:"remoteUser,omitempty"`
	InitializeCommand           LifecycleHook            `json:"initializeCommand,omitempty"`
	ShutdownAction              string                   `json:"shutdownAction,omitempty"`
	WaitFor                     string                   `json:"waitFor,omitempty"`
	UserEnvProbe                string                   `json:"userEnvProbe,omitempty"`
	HostRequirements            *HostRequirements        `json:"hostRequirements,omitempty"`
	OverrideCommand             *bool                    `json:"overrideCommand,omitempty"`
	WorkspaceFolder             string                   `json:"workspaceFolder,omitempty"`

	// Deprecated fields (kept for legacy replacement).
	Settings   map[string]any `json:"settings,omitempty"`
	Extensions []string       `json:"extensions,omitempty"`
	DevPort    int            `json:"devPort,omitempty"`
}

type DockerfileContainer struct {
	Dockerfile string              `json:"dockerfile,omitempty"`
	Context    string              `json:"context,omitempty"`
	Build      *ConfigBuildOptions `json:"build,omitempty"`
}

type HostRequirements struct {
	CPUs    int    `json:"cpus,omitempty"`
	Memory  string `json:"memory,omitempty"`
	Storage string `json:"storage,omitempty"`
	GPU     any    `json:"gpu,omitempty"`
}

type ImageContainer struct {
	Image string `json:"image,omitempty"`
}

type ImageMetadata struct {
	ID         string `json:"id,omitempty"`
	Entrypoint string `json:"entrypoint,omitempty"`

	DevContainerConfigBase `json:",inline"`
	DevContainerActions    `json:",inline"`
	NonComposeBase         `json:",inline"`
}

type ImageMetadataConfig struct {
	Raw    []*ImageMetadata
	Config []*ImageMetadata
}

type LifecycleHook map[string][]string

type MergedConfigProperties struct {
	Entrypoints           []string        `json:"entrypoints,omitempty"`
	OnCreateCommands      []LifecycleHook `json:"onCreateCommands,omitempty"`
	UpdateContentCommands []LifecycleHook `json:"updateContentCommands,omitempty"`
	PostCreateCommands    []LifecycleHook `json:"postCreateCommands,omitempty"`
	PostStartCommands     []LifecycleHook `json:"postStartCommands,omitempty"`
	PostAttachCommands    []LifecycleHook `json:"postAttachCommands,omitempty"`
}

type MergedDevContainerConfig struct {
	DevContainerConfigBase `json:",inline"`
	MergedConfigProperties `json:",inline"`
	NonComposeBase         `json:",inline"`
	ImageContainer         `json:",inline"`
	ComposeContainer       `json:",inline"`
	DockerfileContainer    `json:",inline"`

	Origin string `json:"-"`
}

type Mount struct {
	Type     string `json:"type,omitempty"`
	Source   string `json:"source,omitempty"`
	Target   string `json:"target,omitempty"`
	External bool   `json:"external,omitempty"`
}

type NonComposeBase struct {
	AppPort        StrIntArray       `json:"appPort,omitempty"`
	ContainerEnv   map[string]string `json:"containerEnv,omitempty"`
	ContainerUser  string            `json:"containerUser,omitempty"`
	Mounts         []Mount           `json:"mounts,omitempty"`
	Init           *bool             `json:"init,omitempty"`
	Privileged     *bool             `json:"privileged,omitempty"`
	CapAdd         []string          `json:"capAdd,omitempty"`
	SecurityOpt    []string          `json:"securityOpt,omitempty"`
	RunArgs        []string          `json:"runArgs,omitempty"`
	WorkspaceMount string            `json:"workspaceMount,omitempty"`
}

type PortAttribute struct {
	Label            string `json:"label,omitempty"`
	Protocol         string `json:"protocol,omitempty"`
	OnAutoForward    string `json:"onAutoForward,omitempty"`
	RequireLocalPort bool   `json:"requireLocalPort,omitempty"`
	ElevateIfNeeded  bool   `json:"elevateIfNeeded,omitempty"`
}

type PrebuildHashParams struct {
	// Config is the devcontainer configuration.
	Config *DevContainerConfig

	// Platform is the target platform (e.g., "linux/amd64").
	Platform string

	// ContextPath is the absolute path to the build context directory.
	ContextPath string

	// DockerfileContent is the raw Dockerfile content.
	DockerfileContent string

	// IncludeFiles limits the context hash to only these files (relative paths).
	// If nil, all files in the context are included (minus .dockerignore exclusions).
	IncludeFiles []string
}

type StrArray []string

type StrBool string

type StrIntArray []string

type SubstitutionContext struct {
	DevContainerID           string
	LocalWorkspaceFolder     string
	ContainerWorkspaceFolder string
	Env                      map[string]string
}