resourcegen

type Field struct {
	Name     string
	JSONName string
	GoName   string
	Type     FieldType
	GoType   string
	Required bool
	Unique   bool
	Index    bool
	Nullable bool

	// Filterable / Sortable / Searchable opt this field into the generated list
	// handler's declared query surface (issue #260): exact-match ?<field>=,
	// ?ordering=<field> (- prefix for DESC), and ?search= respectively — the same
	// spelling as the admin data plane. belongs_to fields are filterable by
	// default (see isFilterable) so the has_many detail-list case —
	// GET /children?<parent>_id=<id> — works without extra declaration.
	Filterable bool
	Sortable   bool
	Searchable bool

	// Aggregatable opts this numeric field into the generated list handler's
	// server-side aggregate surface (issue #272): ?aggregate=sum:<field>,
	// avg:<field>,min:<field>,max:<field>, computed over the same filtered and
	// searched set as the list, before pagination. Only numeric columns (int,
	// int64, uint, decimal) may opt in (see typeAllowsAggregate).
	Aggregatable bool

	// EnumValues holds the allowed stored values for FieldEnum, in declared
	// order. EnumLabels is the display text for each value. An empty label
	// list means the label is the stored value.
	EnumValues []string
	EnumLabels []string
	// Precision/Scale set the decimal(p,s) column for FieldDecimal.
	Precision int
	Scale     int

	// Declarative constraints (MODEL-3). Empty strings and a zero MaxLength
	// mean unset. Default is the raw token, without SQL quotes.
	Min       string
	Max       string
	MaxLength int
	Pattern   string
	Default   string

	// Target is the related model type (PascalCase) for a relation field, e.g.
	// "Engine". TargetPkg is its feature-package name (snake), e.g. "engine".
	// OnDelete is the GORM OnDelete clause (RESTRICT, CASCADE, SET NULL).
	// Self is a relation whose target is the resource being generated.
	Target    string
	TargetPkg string
	OnDelete  string
	Self      bool
	// FKGoType is the belongs_to / one_to_one foreign-key Go type. Empty
	// means uint. uuid.UUID matches a target whose primary key is a UUID.
	FKGoType string
}

type FieldType string

type GeneratedArtifact struct {
	Path      string    `json:"path"`
	Content   []byte    `json:"content"`
	Ownership Ownership `json:"ownership"`
}

type Options struct {
	WorkDir string
	Name    string
	Fields  []string
	// ID is the primary key strategy: uint (default, gorm.Model) or uuid.
	ID       string
	Service  bool
	Repo     bool
	DryRun   bool
	Force    bool
	Stdout   io.Writer
	Stderr   io.Writer
	AtlasBin string
	// SkipMigrations is the explicit opt-in to scaffolding the resource and
	// persisting the loader/registry state without generating the Atlas SQL diff.
	// It makes the committed output independent of whether Atlas is installed, at
	// the cost of a registry-ahead-of-SQL state the developer knowingly accepts
	// (#300).
	SkipMigrations bool
	// contains filtered or unexported fields
}

type Ownership int

type Pending struct {
	ImportPath string // module/internal/<pkg>
	TypeName   string // Book
	Pkg        string // book
	// Overlay maps real absolute paths to the source Program Mode compiles instead
	// of what is on disk, so the phase-2 preflight sees the resource exactly as this
	// run will commit it while the real tree stays untouched (nil when the committed
	// package already matches disk). It stages the model when make resource will
	// (re)write it, and — for a --force re-scaffold that changes the model — stubs
	// the package's other .go files so the changed model compiles without the stale
	// generated files this run is about to replace.
	Overlay map[string][]byte
}

type ResourceName struct {
	Input       string
	TypeName    string
	Package     string
	FileBase    string
	PluralSnake string
	HTTPPath    string
	Tag         string
	Kebab       string
}

type ResourcePlan struct {
	Pending Pending
	Models  []migrations.Model
	// contains filtered or unexported fields
}