features

type LockedFeature struct {
	Version   string   `json:"version"`
	Resolved  string   `json:"resolved"`
	Integrity string   `json:"integrity"`
	DependsOn []string `json:"dependsOn,omitempty"`
}

type Lockfile struct {
	Features map[string]LockedFeature `json:"features"`
}

type LockfileState struct {
	Lockfile *Lockfile
	// contains filtered or unexported fields
}

type Metadata struct {
	Customizations    map[string]any    `json:"customizations,omitempty"`
	ID                string            `json:"id"`
	Version           string            `json:"version"`
	Name              string            `json:"name,omitempty"`
	Description       string            `json:"description,omitempty"`
	DocumentationURL  string            `json:"documentationURL,omitempty"`
	Options           map[string]Option `json:"options,omitempty"`
	ContainerEnv      map[string]string `json:"containerEnv,omitempty"`
	Mounts            []any             `json:"mounts,omitempty"`
	Init              *bool             `json:"init,omitempty"`
	Privileged        *bool             `json:"privileged,omitempty"`
	CapAdd            []string          `json:"capAdd,omitempty"`
	SecurityOpt       []string          `json:"securityOpt,omitempty"`
	Entrypoint        string            `json:"entrypoint,omitempty"`
	InstallsAfter     []string          `json:"installsAfter,omitempty"`
	CurrentID         string            `json:"currentId,omitempty"`
	DependsOn         spec.OrderedMap   `json:"dependsOn,omitempty"`
	LegacyIDs         []string          `json:"legacyIds,omitempty"`
	Deprecated        bool              `json:"deprecated,omitempty"`
	OnCreateCommand   spec.Command      `json:"onCreateCommand,omitempty"`
	UpdateContent     spec.Command      `json:"updateContentCommand,omitempty"`
	PostCreateCommand spec.Command      `json:"postCreateCommand,omitempty"`
	PostStartCommand  spec.Command      `json:"postStartCommand,omitempty"`
	PostAttachCommand spec.Command      `json:"postAttachCommand,omitempty"`
	// contains filtered or unexported fields
}

type Option struct {
	Type        string   `json:"type,omitempty"`
	Default     any      `json:"default,omitempty"`
	Description string   `json:"description,omitempty"`
	Enum        []string `json:"enum,omitempty"`
	Proposals   []string `json:"proposals,omitempty"`
}

type Resolved struct {
	// Source is the original spec key (e.g. ghcr.io/devcontainers/features/node:1).
	Source string
	// Reference is the parsed OCI reference, if Source was an OCI ref.
	Reference *oci.Reference
	// Manifest is the resolved OCI manifest used for configuration reporting.
	Manifest *oci.Manifest
	// Options as supplied in devcontainer.json (raw JSON values).
	Options map[string]any
	// Value is the original option value, including scalar shorthand.
	Value any
	// Metadata loaded from the feature's devcontainer-feature.json.
	Metadata Metadata
	// Dir is the on-disk directory containing the feature contents
	// (devcontainer-feature.json, install.sh, etc.).
	Dir string
	// SafeID is a path-safe identifier used to namespace the feature
	// inside the staging directory.
	SafeID string
	// Digest is the manifest digest of an OCI feature. Empty for local
	// features.
	Digest string
	// Tarball is the direct HTTPS archive URL. Digest hashes its archive bytes.
	Tarball string
	// contains filtered or unexported fields
}

type Resolver struct {
	// SkipAutoMapping leaves legacy shorthand identifiers unchanged.
	SkipAutoMapping bool
	// CacheDir, if non-empty, is used to cache pulled OCI artifacts
	// keyed by digest. Otherwise resolution always re-fetches.
	CacheDir string
	// OCI is the registry client used for OCI-based features.
	OCI *oci.Client
	// Logger receives progress messages. May be nil.
	Logger func(format string, args ...any)
}