generator

type CallOperation string

type CallPattern struct {
	Target        CallTarget
	Operation     CallOperation
	TypeRoles     map[string]TypeSource
	ArgumentRoles map[string]ValueSource
}

type CallPatternOption func(*CallPattern)

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

type CallTarget struct {
	Function *SymbolPattern
	Method   *MethodPattern
}

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 Command struct {
	Name    string
	Summary string
	Run     func(context.Context, []string, CommandIO) int
}

type CommandIO struct {
	Stdin            io.Reader
	Stdout           io.Writer
	Stderr           io.Writer
	WorkingDirectory string
	Environment      []string
}

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

type ConfigBindBinding struct {
	TypeName   string
	Prefix     string
	SubCommand bool
	Name       string
	Help       string
}

type DiscoverySymbol struct {
	PackagePath         string
	Name                string
	ReceiverPackagePath string
	ReceiverType        string
	Usage               Usage
	TypeArgument        int
	ArgumentType        *int
}

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 GenerateRequest struct {
	Dir            string
	Out            string
	Name           string
	OpenAPI        bool
	OpenAPIName    string
	TemplatesName  string
	ConfigBindName string
	Check          bool
	GenerateAll    bool
	SQLContextAPI  bool
}

type GenerateResult struct {
	BinderPath     string
	ConfigBindPath string
	OpenAPIPath    string
	TemplatesPath  string
	Diagnostics    []parser.Diagnostic
}

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]
	Calls           PatternSet[CallPattern]
	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
	PackagePath 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 TypeSource struct {
	GenericArgument *int
	ArgumentType    *int
}

type Usage uint32

type ValueSource struct {
	Argument   *int
	Constant   any
	IsConstant bool
}