generator

type CheckRules struct {
	Required   bool
	Min        *float64
	Max        *float64
	MinLen     *int
	MaxLen     *int
	Len        *int
	Enum       []string
	Pattern    string
	Default    string
	HasDefault bool
	Email      bool
	UUID       bool
	Date       bool
	Time       bool
	DateTime   bool
}

type ConfigBindBinding struct {
	TypeName string
	Prefix   string
}

type DiscoverySymbol struct {
	PackagePath string
	Name        string
	Usage       Usage
}

type Document map[string]any

type Feature string

type FieldPlan struct {
	Name     string      // Go field name
	Wire     string      // wire / tag name ("*" for payload rest)
	Source   FieldSource // input|query|payload|path|header|cookie|method
	Kind     string      // string|int|int64|bool|float64|file|rest_*|struct|slice|map
	JSON     string      // json name for encode/document keys
	Check    CheckRules  // from check:"" tag; empty if absent
	TypeName string      // KindStruct name, or element struct name for slice/map of struct
	ElemKind string      // for slice/map: string|int|int64|bool|float64|struct
	DB       string      // SQL result column (db tag or snake_case field name)
	GroupKey bool        // groupkey tag presence
}

type FieldSource string

type Generator struct{ Options Options }

type MethodPattern struct {
	PackagePath         string
	Name                string
	ReceiverPackagePath string
	ReceiverType        string
}

type Options struct {
	ServeMuxes      PatternSet[TypePattern]
	RouteMethods    PatternSet[MethodPattern]
	RouteFunctions  PatternSet[SymbolPattern]
	RuntimePackages PatternSet[string]

	Bind        PatternSet[SymbolPattern]
	Write       PatternSet[SymbolPattern]
	WriteStatus PatternSet[SymbolPattern]
	DecodeJSON  PatternSet[SymbolPattern]
	EncodeJSON  PatternSet[SymbolPattern]
	NewStream   PatternSet[SymbolPattern]
	ScanRows    PatternSet[SymbolPattern]
	FileTypes   PatternSet[TypePattern]
	// SQLContextAPI adds Context-resolved wrappers for exported SQL templates.
	SQLContextAPI bool
	// SQLExecutorResolver selects a framework-specific Context resolver and
	// implies SQLContextAPI. Nil uses sqlbind.SQLExecutorFromContext.
	SQLExecutorResolver *SymbolPattern

	DisableFeatures []Feature
	GenerateAll     bool
}

type PackagePlan struct {
	Package string
	Types   []TypePlan
	// Discovered lists type names referenced by configured generic call sites.
	Discovered []string
}

type PatternSet[T any] struct {
	Set      []T
	Disabled bool
}

type SymbolPattern struct{ PackagePath, Name string }

type TypePattern struct{ PackagePath, Name string }

type TypePlan struct {
	Name   string
	Fields []FieldPlan
	// Usage records which generated entry points are referenced by source code.
	// Zero means the type is unused and emits no mapping paths.
	Usage Usage
	// DirectUsage excludes usage inherited from containing structs.
	DirectUsage Usage
}

type Usage uint32