plan

type ComponentRoute struct {
	Path       string
	FieldName  string
	Type       reflect.Type
	InputType  reflect.Type
	OutputType reflect.Type
	InputName  string
	OutputName string
	ViewName   string
	SourceURL  string
	SummaryURL string
	Name       string
	RoutePath  string
	Method     string
	Connector  string
	Marshaller string
	Handler    string
	Report     *dqlshape.ReportDirective
}

type Field struct {
	Path  string
	Name  string
	Type  reflect.Type
	Index []int
}

type Planner struct{}

type Relation struct {
	Name          string
	Parent        string
	Holder        string
	Ref           string
	Table         string
	Kind          string
	Raw           string
	ColumnsConfig map[string]*ViewColumnConfig
	On            []*RelationLink
	Warnings      []string
}

type RelationLink struct {
	ParentField     string
	ParentNamespace string
	ParentColumn    string
	RefField        string
	RefNamespace    string
	RefColumn       string
	Expression      string
}

type Result struct {
	RootType reflect.Type
	EmbedFS  *embed.FS

	Fields           []*Field
	ByPath           map[string]*Field
	Views            []*View
	ViewsByName      map[string]*View
	States           []*State
	Components       []*ComponentRoute
	Types            []*Type
	ColumnsDiscovery bool
	Const            map[string]string
	TypeContext      *typectx.Context
	Directives       *dqlshape.Directives
	Diagnostics      []*dqlshape.Diagnostic
}

type SelfReference struct {
	Holder string
	Child  string
	Parent string
}

type State struct {
	state.Parameter `yaml:",inline"`
	QuerySelector   string
	OutputDataType  string
	EmitOutput      bool
}

type Type struct {
	Name        string
	Alias       string
	DataType    string
	Cardinality string
	Package     string
	ModulePath  string
}

type View struct {
	Path                   string
	Name                   string
	Ref                    string
	Mode                   string
	Table                  string
	Module                 string
	Connector              string
	CacheRef               string
	Partitioner            string
	PartitionedConcurrency int
	RelationalConcurrency  int
	SQL                    string
	SQLURI                 string
	Summary                string
	SummaryURL             string
	SummaryName            string
	Relations              []*Relation
	Holder                 string

	AllowNulls             *bool
	Groupable              *bool
	SelectorNamespace      string
	SelectorLimit          *int
	SelectorNoLimit        *bool
	SelectorCriteria       *bool
	SelectorProjection     *bool
	SelectorOrderBy        *bool
	SelectorOffset         *bool
	SelectorPage           *bool
	SelectorFilterable     []string
	SelectorOrderByColumns map[string]string
	SchemaType             string
	ColumnsDiscovery       bool
	Self                   *SelfReference

	Cardinality string
	ElementType reflect.Type
	FieldType   reflect.Type
	Declaration *ViewDeclaration
}

type ViewColumnConfig struct {
	DataType  string
	Tag       string
	Groupable *bool
}

type ViewDeclaration struct {
	Tag           string
	TypeName      string
	Dest          string
	Codec         string
	CodecArgs     []string
	HandlerName   string
	HandlerArgs   []string
	StatusCode    *int
	ErrorMessage  string
	QuerySelector string
	CacheRef      string
	Limit         *int
	Cacheable     *bool
	When          string
	Scope         string
	DataType      string
	Of            string
	Value         string
	Async         bool
	Output        bool
	Predicates    []*ViewPredicate
	ColumnsConfig map[string]*ViewColumnConfig
}

type ViewPredicate struct {
	Name      string
	Source    string
	Ensure    bool
	Arguments []string
}