modeladmin

type ActiveChoice struct {
	Value    string
	Label    string
	URL      string // pre-built URL with this filter applied
	IsActive bool
}

type ActiveFilter struct {
	Field     string
	Label     string
	Choices   []ActiveChoice
	HasActive bool // true if any choice is selected
}

type BulkAction struct {
	Slug    string // URL segment: /admin/{model}/bulk/{slug}
	Label   string // button text (i18n key)
	Confirm string // JS confirm() text (i18n key); empty = no confirm
	Handler func(ctx context.Context, db *bun.DB, ids []string) error
}

type CascadeImpact struct {
	Table       string // SQL table name
	DisplayName string // human-readable name (from registered ModelAdmin, or Table as fallback)
	Count       int
}

type ChoicesFunc func(ctx context.Context) ([]forms.Choice, error)

type FilterDef struct {
	Field    string         // database column name
	Label    string         // human-readable label
	LabelKey string         // i18n key for the label; translated via i18n.T at request time
	Type     string         // "select", "bool", "date_range"
	Choices  []forms.Choice // for select filters
}

type ItemActions struct {
	Actions []RenderAction
}

type ModelAdmin[T any] struct {
	// Slug is the URL path segment, e.g. "articles".
	Slug string
	// DisplayName is the singular human-readable name, also used as i18n key, e.g. "Article".
	DisplayName string
	// DisplayPluralName is the plural human-readable name, also used as i18n key, e.g. "Articles".
	DisplayPluralName string
	// DB is the Bun database connection.
	DB *bun.DB
	// Renderer renders list, detail, and form views.
	Renderer Renderer[T]
	// IDFunc extracts the primary key from the request URL.
	// Defaults to chi.URLParam(r, "id").
	IDFunc func(*http.Request) string
	// CanCreate enables the create action. Default: false.
	CanCreate bool
	// CanEdit enables the update action. Default: false.
	CanEdit bool
	// CanDelete enables the delete action. Default: false.
	CanDelete bool
	// ListFields lists struct field names to show in the list view.
	ListFields []string
	// OrderBy is the default ORDER BY clause, e.g. "created_at DESC".
	OrderBy string
	// Relations lists Bun .Relation() names to eager-load.
	Relations []string
	// PageSize is the number of items per page. Default: 25.
	PageSize int
	// SearchFields lists database column names to full-text search across.
	SearchFields []string
	// Filters defines the sidebar filters for the list view.
	Filters []FilterDef
	// SortFields lists database column names that support column sorting.
	SortFields []string
	// RowActions defines custom per-row actions for the list/detail views.
	RowActions []RowAction
	// FieldChoices provides dynamic choices for form select fields.
	// Key is the Go struct field name, value is a function that returns choices
	// (typically loaded from the database). Fields with FieldChoices are
	// rendered as <select> dropdowns instead of text/number inputs.
	FieldChoices map[string]ChoicesFunc
	// EmptyMessage is shown when the list has no items. Default: "No items found."
	EmptyMessage string
	// EmptyMessageKey is the i18n key for the empty-list message.
	// Translated via i18n.T at request time.
	EmptyMessageKey string
	// ReadOnlyFields lists struct field names (by Go name) to render as
	// plain text in forms. Read-only fields cannot be modified by the user;
	// their values are preserved from the model instance.
	ReadOnlyFields []string
	// CanExport enables CSV/JSON export of the list view. Default: false.
	CanExport bool
	// FormOptions holds additional forms.Option[T] applied when building
	// create/edit forms. Use this to pass WithCleanFunc or other options
	// that need external dependencies captured at configuration time.
	FormOptions []forms.Option[T]
	// BulkActions defines bulk operations on multiple selected items.
	BulkActions []BulkAction
	// ListDisplay defines computed columns for the list view.
	// Keys are column names (which can also appear in ListFields).
	// The function receives an item and returns pre-rendered HTML.
	ListDisplay map[string]func(T) template.HTML
	// contains filtered or unexported fields
}

type RenderAction struct {
	Slug    string
	Label   string
	Icon    template.HTML
	Method  string
	Class   string
	Confirm string
}

type RenderBulkAction struct {
	Slug    string
	Label   string
	Confirm string
}

type RenderConfig struct {
	Slug              string
	DisplayName       string
	DisplayPluralName string
	CanCreate         bool
	CanEdit           bool
	CanDelete         bool
	CanExport         bool
	ListFields        []string // Go struct field names (for columnValue/fieldValue lookups)
	ListFieldLabels   []string // translated column headers (parallel to ListFields)
	IDField           string   // struct field name for the primary key (default: "ID")
	Filters           []ActiveFilter
	RowActions        []RenderAction
	HasRowActions     bool
	ItemActionSets    [][]RenderAction // per-item action sets, parallel to items (ShowWhen-evaluated)
	BulkActions       []RenderBulkAction
	HasBulkActions    bool
	EmptyMessage      string
	ComputedColumns   map[string]func(any) template.HTML // field → render function
	DeleteImpacts     []CascadeImpact                    // cascade-delete impact counts (confirm-delete page)
}

type Renderer[T any] interface {
	List(w http.ResponseWriter, r *http.Request, items []T, page burrow.PageResult, cfg RenderConfig) error
	Detail(w http.ResponseWriter, r *http.Request, item *T, cfg RenderConfig) error
	Form(w http.ResponseWriter, r *http.Request, item *T, fields []forms.BoundField, cfg RenderConfig) error
	ConfirmDelete(w http.ResponseWriter, r *http.Request, item *T, cfg RenderConfig) error
}

type RowAction struct {
	Slug     string              // URL segment: /admin/{model}/{id}/{slug}
	Label    string              // button text
	Icon     template.HTML       // icon HTML (optional)
	Method   string              // "POST" or "DELETE" (default: "POST")
	Class    string              // CSS class (default: "btn-outline-secondary")
	Confirm  string              // hx-confirm text (empty = no confirm)
	Handler  burrow.HandlerFunc  // the actual handler
	ShowWhen func(item any) bool // nil = always show
}