blueprint

type BackgroundWorker struct {
	// Name is a descriptive name for the worker
	Name string
	// FunctionCall is the function to call (e.g., "worker.StartQueue(ctx, queue)")
	FunctionCall string
	// DependsOn lists variables this worker needs
	DependsOn []string
	// Order for deterministic rendering
	Order int
}

type Blueprint struct {
	// Tools lists go tool dependencies for the go.mod tool directive
	Tools *OrderedSet

	// Controllers section
	Controllers ControllerSection

	// Routes section
	Routes RouteSection

	// Models section
	Models ModelSection

	// Configuration section
	Config ConfigSection

	// Migrations and database
	Migrations MigrationSection

	// Main holds configuration for the main.go application setup
	Main MainSection
}

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

type ConfigSection struct {
	// Config struct fields
	Fields []Field

	// Environment variable mappings
	EnvVars []EnvVar
}

type Constructor struct {
	// VarName is the variable name on the left side (e.g., "pages")
	VarName string
	// FieldName is the struct field this variable should be assigned to (e.g., "Pages")
	FieldName string
	// Expression is the right-hand side (e.g., "newPages(db, cache)")
	Expression string
	// Order for deterministic rendering
	Order int
}

type ControllerSection struct {
	// Import paths needed by controllers
	Imports *OrderedSet

	// Controller dependencies (parameters for New function)
	Dependencies []Dependency

	// Controller fields to add to the Controllers struct
	Fields []Field

	// Constructor initializations (e.g., "pages := newPages(db, cache)")
	Constructors []Constructor
}

type Dependency struct {
	Name string
	Type string
	// InitExpr is the optional initialization expression (e.g., "queue.NewInMemoryQueue()")
	// If empty, the dependency is assumed to be provided externally (like db)
	InitExpr string
	// ImportPath is the import path needed when InitExpr is provided
	// (e.g., "myapp/queue" for "queue.NewInMemoryQueue()")
	ImportPath string
	// Order for deterministic rendering
	Order int
}

type EnvVar struct {
	Key          string
	ConfigField  string
	DefaultValue string
	// Order for deterministic rendering
	Order int
}

type Field struct {
	Name string
	Type string
	// Order for deterministic rendering
	Order int
}

type Initialization struct {
	// VarName is the variable name (e.g., "emailSender")
	VarName string
	// Expression is the initialization code (e.g., "email.NewMailpit()")
	Expression string
	// DependsOn lists variable names this depends on (for ordering)
	DependsOn []string
	// Order for deterministic rendering
	Order int
}

type MainSection struct {
	// Import paths needed in main.go (beyond controller dependencies)
	Imports *OrderedSet

	// Initialization code blocks (e.g., service creation)
	Initializations []Initialization

	// Background workers to start
	BackgroundWorkers []BackgroundWorker

	// Pre-run hooks executed before server starts
	PreRunHooks []PreRunHook
}

type Migration struct {
	Name      string
	Timestamp string
	Path      string
	// Order for deterministic rendering (usually by timestamp)
	Order int
}

type MigrationSection struct {
	// Migration file paths
	Migrations []Migration
}

type Model struct {
	Name   string
	Fields []Field
	// Order for deterministic rendering
	Order int
}

type ModelSection struct {
	// Model imports
	Imports *OrderedSet

	// Model struct definitions
	Models []Model
}

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

type PreRunHook struct {
	// Name is a descriptive name for the hook
	Name string
	// Code is the Go code to execute (e.g., "if err := migrate(db); err != nil { return err }")
	Code string
	// Order for deterministic rendering
	Order int
}

type RegistrationFunction struct {
	// FunctionName is the name of the registration function (e.g., "registerAuthRoutes")
	FunctionName string
	// Registrations contains all route registrations for this function
	Registrations []RouteRegistration
	// Order for deterministic rendering
	Order int
}

type Route struct {
	Name             string
	Path             string
	Controller       string
	ControllerMethod string
	Method           string
	IncludeInSitemap bool
	// Order for deterministic rendering
	Order int
}

type RouteCollection struct {
	Routes []string
	// Order for deterministic rendering
	Order int
}

type RouteRegistration struct {
	// Method is the HTTP method (e.g., "http.MethodGet")
	Method string
	// RouteVariable is the route variable name (e.g., "routes.Health")
	RouteVariable string
	// ControllerRef is the controller method reference (e.g., "ctrls.API.Health")
	ControllerRef string
	// Middleware is optional middleware to apply to this route
	Middleware []string
	// Order for deterministic rendering
	Order int
}

type RouteSection struct {
	// Route definitions
	Routes []Route

	// Route groups (e.g., "auth" for authRoutes, "admin" for adminRoutes)
	// Used to aggregate routes in the router_routes_routes.tmpl aggregator
	RouteGroups *OrderedSet

	// RouteCollections holds grouped route expressions to include in BuildRoutes.
	RouteCollections []RouteCollection

	// Route group imports (for middleware, etc.)
	Imports *OrderedSet

	// RouteRegistrations holds route registration entries for the registrar function
	Registrations []RouteRegistration

	// RegistrationFunctions holds grouped registration functions
	RegistrationFunctions []RegistrationFunction
}