loader

type Listener = func(event string, metadata map[string]any)

type NoopPostProcessor struct{}

type Options struct {
	// Skip schema validation
	SkipValidation bool
	// Skip interpolation
	SkipInterpolation bool
	// Skip normalization
	SkipNormalization bool
	// Resolve path
	ResolvePaths bool
	// Convert Windows path
	ConvertWindowsPaths bool
	// Skip consistency check
	SkipConsistencyCheck bool
	// Skip extends
	SkipExtends bool
	// SkipInclude will ignore `include` and only load model from file(s) set by ConfigDetails
	SkipInclude bool
	// SkipResolveEnvironment will ignore computing `environment` for services
	SkipResolveEnvironment bool
	// SkipResolveLabels will ignore resolving `label_file` into `labels` for services.
	// When set, service `labels` may be incomplete: `label_file` entries are left unresolved,
	// so callers must not treat `labels` as authoritative.
	SkipResolveLabels bool
	// SkipDefaultValues will ignore missing required attributes
	SkipDefaultValues bool
	// Interpolation options
	Interpolate *interp.Options

	// Profiles set profiles to enable
	Profiles []string
	// SelectedServices restricts the project model to these services (and their dependencies)
	// after parsing. An empty slice means "all services". When set, services not in the list
	// are dropped from the project before environment resolution, so their env_file / label_file
	// entries are not loaded.
	SelectedServices []string
	// PruneUnnecessaryResources drops networks/volumes/secrets/configs/models that are not
	// referenced by active services after service selection.
	PruneUnnecessaryResources bool
	// ResourceLoaders manages support for remote resources
	ResourceLoaders []ResourceLoader
	// KnownExtensions manages x-* attribute we know and the corresponding go structs
	KnownExtensions map[string]any
	// Metada for telemetry
	Listeners []Listener
	// MaxNodeVisits caps total YAML node visits during reset/override resolution.
	// Zero means use the default. Useful for very large compose files that exceed the default cap.
	MaxNodeVisits int
	// UnsupportedAttributesCheck detects caller-supplied patterns identifying
	// compose-file attributes not honored by the caller's runtime. See
	// WithUnsupportedAttributesCheck.
	UnsupportedAttributesCheck *UnsupportedAttributesCheck
	// contains filtered or unexported fields
}

type PostProcessor interface {
	// Apply changes to compose model based on recorder metadata
	Apply(interface{}) error
}

type ResetProcessor struct {
	// contains filtered or unexported fields
}

type ResourceLoader interface {
	// Accept returns `true` is the resource reference matches ResourceLoader supported protocol(s)
	Accept(path string) bool
	// Load returns the path to a local copy of remote resource identified by `path`.
	Load(ctx context.Context, path string) (string, error)
	// Dir computes path to resource"s parent folder, made relative if possible
	Dir(path string) string
}

type UnsupportedAttribute struct {
	// Path locates the match in the loaded model, e.g. "services.web.deploy.mode".
	Path tree.Path
	// Value is whatever Path resolved to: a scalar, a map, or a list item,
	// depending on the depth the matching pattern targeted.
	Value any
}

type UnsupportedAttributePattern struct {
	// Path is a tree.Path pattern (may use tree.PathMatchAll) identifying
	// the node to inspect.
	Path tree.Path
	// Detect reports whether the value found at Path is unsupported. Nil
	// means presence alone is unsupported. Detect may target an
	// intermediate map node (not just a scalar leaf) to inspect sibling
	// fields, e.g. matching a whole `ports` entry to flag only `mode: host`.
	//
	// Once any pattern's Path matches a node, the walk stops descending into
	// that node's children regardless of what Detect returns: a pattern
	// targeting a child of an already-matched node will never be evaluated
	// for that occurrence.
	Detect func(value any) bool
}

type UnsupportedAttributesCheck struct {
	Patterns  []UnsupportedAttributePattern
	Supported []tree.Path
	Report    func([]UnsupportedAttribute)
}