variable

type Expression struct {
	// Value is the CEL expression string.
	Value string
	// AST is the parsed CEL AST of the expression.
	// This can be nil if the expression has not been parsed yet.
	// If the expression is parsed, this AST can be used for further analysis
	AST *cel.Ast
}

type FieldDescriptor struct {
	// Path is the path to the field in a nested object.
	Path fieldpath.Path

	// Expressions is a list of CEL expressions in the field.
	Expressions []Expression

	// ExpectedType is the expected CEL type of the field.
	// Set by: builder.setExpectedTypeOnDescriptor() - the single place where types are determined.
	// Parser leaves this nil, builder sets it based on StandaloneExpression:
	//   - For string templates (StandaloneExpression=false): always cel.StringType
	//   - For standalone expressions (StandaloneExpression=true): derived from a schema
	ExpectedType *cel.Type

	// StandaloneExpression indicates if this is a single CEL expression vs a string template.
	// Set by: parser (both parser.go and schemaless.go)
	// Used by: builder.setExpectedTypeOnDescriptor() to determine how to set ExpectedType
	// Examples:
	//   true:  "${foo}" - single expression, type derived from schema
	//   false: "hello-${foo}" or "${foo}-${bar}" - string template, always produces string
	StandaloneExpression bool
}

type Kind string

type Variable struct {
	// FieldDescriptor is the object that contains the expression, the path, and
	// the expected type.
	FieldDescriptor
	// Kind is the kind of the variable (static or dynamic).
	Kind Kind
	// Dependencies is a list of resources this variable depends on. We need
	// this information to wait for the dependencies to be resolved before
	// evaluating the variable.
	Dependencies []string
}