plugin

type CLIPlugin interface {
	Plugin
	// OnHook is called when a lifecycle hook is triggered.
	OnHook(hook Hook, ctx map[string]interface{}) error
	// Commands returns custom CLI commands provided by the plugin.
	Commands() []Command
}

type Command struct {
	Name        string
	Alias       string
	Description string
	Action      func(args []string) error
	// Flags defines command-line flags for this command.
	Flags []Flag
}

type Config struct {
	// Schema describes the configuration fields.
	Schema map[string]FieldSchema `json:"schema" yaml:"schema"`
	// Defaults provides default values.
	Defaults map[string]interface{} `json:"defaults" yaml:"defaults"`
}

type Dependency struct {
	// Type is the dependency type (go or bun).
	Type DependencyType
	// Name is the package name (e.g., "golang.org/x/oauth2" or "valibot").
	Name string
	// Version is the version constraint (e.g., "latest", "v1.2.3").
	Version string
}

type DependencyType string

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

type FieldSchema struct {
	Type        string      `json:"type" yaml:"type"`               // "string", "bool", "number", "array"
	Description string      `json:"description" yaml:"description"` // Human-readable description
	Required    bool        `json:"required" yaml:"required"`       // Is this field required?
	Default     interface{} `json:"default" yaml:"default"`         // Default value
}

type Flag struct {
	Name        string
	Shorthand   string
	Description string
	Default     interface{}
}

type Hook string

type Info struct {
	Name        string // Unique identifier
	Version     string // Semantic version
	Description string // Human-readable description
	Author      string // Plugin author
	State       State  // Current state
}

type Metadata struct {
	Name        string `json:"name"`
	Version     string `json:"version"`
	Description string `json:"description,omitempty"`
	Author      string `json:"author,omitempty"`
	Source      string `json:"source"`
	ResolvedRef string `json:"resolvedRef,omitempty"`
}

type Plugin interface {
	Name() string
	Init() error
	// Dependencies returns the list of dependencies required by this plugin.
	Dependencies() []Dependency
}

type RegistryEntry struct {
	Name        string `json:"name"`
	Description string `json:"description"`
	URL         string `json:"url"`
	Version     string `json:"version"`
	Installed   bool   `json:"installed"`
}

type RuntimePlugin interface {
	Plugin
	// Config returns the plugin configuration schema.
	Config() Config
	// Middlewares returns Fiber handlers to inject into the app.
	Middlewares() []interface{} // []fiber.Handler
	// TemplateFuncs returns template functions to expose to templ components.
	TemplateFuncs() map[string]interface{}
}

type State int