boot

type ActivityBinding interface {
	List(router.Context) (map[string]any, error)
}

type BootCtx interface {
	Router() Router
	AuthWrapper() HandlerWrapper
	BasePath() string
	AdminAPIGroup() string
	URLs() urlkit.Resolver
	DefaultLocale() string
	NavMenuCode() string
	Gates() FeatureGates
	Responder() Responder
	ParseBody(router.Context) (map[string]any, error)

	Panels() []PanelBinding
	BootDashboard() DashboardBinding
	BootNavigation() NavigationBinding
	BootSearch() SearchBinding
	ExportRegistrar() ExportRegistrar
	BootBulk() BulkBinding
	BootMedia() MediaBinding
	BootUserImport() UserImportBinding
	BootTranslationExchange() TranslationExchangeBinding
	BootTranslationQueue() TranslationQueueBinding
	BootNotifications() NotificationsBinding
	BootActivity() ActivityBinding
	BootJobs() JobsBinding
	BootSettings() SettingsBinding
	BootWorkflows() WorkflowManagementBinding
	BootSchemaRegistry() SchemaRegistryBinding
	BootFeatureOverrides() FeatureOverridesBinding
	BootIcons() IconsBinding

	SettingsWidget() error
	ActivityWidget() error
	NotificationsWidget() error
	RegisterWidgetAreas() error
	RegisterWidgetDefinitions() error
	RegisterDashboardProviders() error
}

type BulkBinding interface {
	List(router.Context) (map[string]any, error)
	Start(router.Context, map[string]any) (map[string]any, error)
	Rollback(router.Context, string, map[string]any) (map[string]any, error)
}

type DashboardBinding interface {
	Enabled() bool
	HasRenderer() bool
	RenderHTML(router.Context, string) (string, error)
	Widgets(router.Context, string) (map[string]any, error)
	Preferences(router.Context, string) (map[string]any, error)
	SavePreferences(router.Context, map[string]any) (map[string]any, error)
	Diagnostics(router.Context, string) (map[string]any, error)
}

type ExportRegistrar interface {
	Register(Router, ExportRouteOptions) error
}

type ExportRouteOptions struct {
	BasePath string
	Wrap     HandlerWrapper
}

type FeatureGates interface {
	Enabled(key string) bool
	Require(key string) error
}

type FeatureOverridesBinding interface {
	List(router.Context) (map[string]any, error)
	Set(router.Context, map[string]any) (map[string]any, error)
	Unset(router.Context, map[string]any) (map[string]any, error)
}

type HandlerWrapper func(router.HandlerFunc) router.HandlerFunc

type IconsBinding interface {
	// Libraries returns all registered icon libraries.
	Libraries(router.Context) (map[string]any, error)
	// Library returns a single icon library by ID.
	Library(router.Context, string) (map[string]any, error)
	// LibraryIcons returns icons from a library, optionally filtered by category.
	LibraryIcons(router.Context, string, string) ([]map[string]any, error)
	// Search searches icons across libraries.
	Search(router.Context, string, int) ([]map[string]any, error)
	// Resolve resolves an icon reference to its definition.
	Resolve(router.Context, string) (map[string]any, error)
	// Render renders an icon to HTML.
	Render(router.Context, string, string) (map[string]any, error)
}

type JobsBinding interface {
	List(router.Context) (map[string]any, error)
	Trigger(router.Context, map[string]any) error
}

type ListOptions struct {
	Page       int
	PerPage    int
	SortBy     string
	SortDesc   bool
	Filters    map[string]any
	Predicates []ListPredicate
	Search     string
}

type ListPredicate struct {
	Field    string
	Operator string
	Values   []string
}

type MediaBinding interface {
	List(router.Context) (map[string]any, error)
	Add(router.Context, map[string]any) (any, error)
}

type NavigationBinding interface {
	Resolve(router.Context, string, string) (items any, theme map[string]map[string]string)
}

type NotificationsBinding interface {
	List(router.Context) (map[string]any, error)
	Mark(router.Context, map[string]any) error
}

type PanelBinding interface {
	Name() string
	List(router.Context, string, ListOptions) ([]map[string]any, int, any, any, error)
	Detail(router.Context, string, string) (map[string]any, error)
	Create(router.Context, string, map[string]any) (map[string]any, error)
	Update(router.Context, string, string, map[string]any) (map[string]any, error)
	Delete(router.Context, string, string) error
	Action(router.Context, string, string, map[string]any) (map[string]any, error)
	Bulk(router.Context, string, string, map[string]any) (map[string]any, error)
	Preview(router.Context, string, string) (map[string]any, error)
	Subresources() []PanelSubresourceSpec
	HandleSubresource(router.Context, string, string, string, string) error
}

type PanelSubresourceSpec struct {
	Name   string
	Method string
}

type Responder interface {
	WriteJSON(router.Context, any) error
	WriteHTML(router.Context, string) error
	WriteError(router.Context, error) error
}

type RouteSpec struct {
	Method  string
	Path    string
	Handler router.HandlerFunc
}

type Router interface {
	Get(path string, handler router.HandlerFunc, mw ...router.MiddlewareFunc) router.RouteInfo
	Post(path string, handler router.HandlerFunc, mw ...router.MiddlewareFunc) router.RouteInfo
	Put(path string, handler router.HandlerFunc, mw ...router.MiddlewareFunc) router.RouteInfo
	Delete(path string, handler router.HandlerFunc, mw ...router.MiddlewareFunc) router.RouteInfo
}

type SchemaRegistryBinding interface {
	List(router.Context) (any, error)
	Get(router.Context, string) (any, error)
}

type SearchBinding interface {
	Query(router.Context, string, string, int) ([]any, error)
}

type SettingsBinding interface {
	Values(router.Context) (map[string]any, error)
	Form(router.Context) (any, error)
	Save(router.Context, map[string]any) (map[string]any, error)
}

type Step func(BootCtx) error

type TranslationExchangeBinding interface {
	Export(router.Context) (any, error)
	Template(router.Context) error
	ImportValidate(router.Context) (any, error)
	ImportApply(router.Context) (any, error)
	JobStatus(router.Context, string) (any, error)
}

type TranslationQueueBinding interface {
	MyWork(router.Context) (any, error)
	Queue(router.Context) (any, error)
	EntityTypesOptions(router.Context) (any, error)
	SourceRecordsOptions(router.Context) (any, error)
	LocalesOptions(router.Context) (any, error)
	TranslationGroupsOptions(router.Context) (any, error)
	AssigneesOptions(router.Context) (any, error)
}

type UserImportBinding interface {
	ImportUsers(router.Context) error
	ImportTemplate(router.Context) error
}

type WorkflowManagementBinding interface {
	ListWorkflows(router.Context) (map[string]any, error)
	CreateWorkflow(router.Context, map[string]any) (map[string]any, error)
	UpdateWorkflow(router.Context, string, map[string]any) (map[string]any, error)

	ListBindings(router.Context) (map[string]any, error)
	CreateBinding(router.Context, map[string]any) (map[string]any, error)
	UpdateBinding(router.Context, string, map[string]any) (map[string]any, error)
	DeleteBinding(router.Context, string) error
}