admin

type Authorizer func(r *http.Request, action, model string) bool

type DataSource interface {
	// List returns one page of rows plus the total match count across all
	// pages (used for pagination). Rows are keyed by column name.
	List(ctx context.Context, params ListParams) (rows []map[string]any, total int, err error)
	// Get returns the single row identified by id (the primary-key value as a
	// string). It returns ErrNotFound when no row matches.
	Get(ctx context.Context, id string) (map[string]any, error)
	// Create inserts a new row and returns the stored representation (including
	// any generated id).
	Create(ctx context.Context, data map[string]any) (map[string]any, error)
	// Update mutates the row identified by id with the supplied fields and
	// returns the stored representation. It returns ErrNotFound when absent.
	Update(ctx context.Context, id string, data map[string]any) (map[string]any, error)
	// Delete removes the row identified by id. Soft-delete-aware sources may
	// set the soft-delete column instead of physically removing the row. It
	// returns ErrNotFound when absent.
	Delete(ctx context.Context, id string) error
}

type Field struct {
	// Name is the Go struct field name (e.g. "CreatedAt").
	Name string
	// Column is the storage/data-source key. It comes from the `column:` tag,
	// or the snake_case of Name when the tag is absent.
	Column string
	// Label is the human-readable header/label (Title Case of Name).
	Label string
	// Kind classifies the input control to render: "text", "number", "bool",
	// "datetime", or "text" as the catch-all.
	Kind string

	// IsPrimary marks the primary-key field (the row identifier).
	IsPrimary bool
	// IsCreatedAt / IsUpdatedAt / IsDeletedAt mark managed timestamp columns.
	IsCreatedAt bool
	IsUpdatedAt bool
	IsDeletedAt bool
	// IsRelation marks slice/pointer-to-struct fields (skipped by default).
	IsRelation bool

	// InList is true when the field appears in the list table. Populated from
	// Resource.Columns (or the default) at registration.
	InList bool
	// Editable is true when the field is rendered on the create/edit form.
	Editable bool
}

type ListParams struct {
	// Page is 1-indexed; the source clamps values < 1 to 1.
	Page int
	// PerPage is the page size; the source clamps values < 1 to the resource
	// default.
	PerPage int
	// Search is the free-text query (case-insensitive substring). Empty means
	// no text filtering.
	Search string
	// SearchFields lists the columns Search is matched against (supplied by the
	// panel from the resource configuration).
	SearchFields []string
	// Filters constrains rows to those whose column equals the given value
	// (string-compared). Multiple filters are AND-ed.
	Filters map[string]string
	// IncludeDeleted, when true, asks soft-delete-aware sources to return
	// soft-deleted rows as well. The panel leaves it false by default.
	IncludeDeleted bool
	// SoftDeleteColumn names the soft-delete timestamp column, or "" when the
	// model is not soft-delete aware.
	SoftDeleteColumn string
}

type Option func(*Panel)

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

type Resource struct {
	// Source is the persistence backend for this model. Required.
	Source DataSource
	// Slug overrides the URL segment for the model. Defaults to the snake_case
	// plural-ish form of the type name (e.g. "User" -> "user").
	Slug string
	// Label overrides the human-readable model name shown in the UI. Defaults
	// to the humanized (Title Case) type name, e.g. "BlogPost" -> "Blog Post".
	Label string
	// Columns names the fields shown in the list table, in order. Defaults to
	// every non-relation field reflected from the model.
	Columns []string
	// Editable names the fields rendered as inputs on the create/edit form.
	// Defaults to every field except the primary key and read-only timestamps
	// (CreatedAt / UpdatedAt / DeletedAt).
	Editable []string
	// Search names the fields matched (case-insensitive substring) by the list
	// view's search box. Empty disables search.
	Search []string
	// Filters names the fields offered as exact-match filter inputs on the
	// list view. Empty disables filtering.
	Filters []string
	// PerPage is the list page size. Defaults to DefaultPerPage when < 1.
	PerPage int
}

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