plugin

type FieldSchema struct {
	Key         string // 字段名，对应 yaml key
	Type        string // "string" | "int" | "bool" | "string_slice" | "map"
	Required    bool   // true = 必填，启动时校验
	Default     any    // 默认值（Required=false 时生效）
	Description string // 人类可读的说明
	Sensitive   bool   // true = 在 CLI info 中 mask 为 ***
	EnvVarHint  string // 建议的环境变量名，仅用于文档提示
}

type Hook interface {
	Plugin

	// OnContentLoaded is called after all content files are loaded and parsed.
	// The plugin receives the full page list and may return a modified list.
	// Returning nil (or the same slice) is a no-op.
	OnContentLoaded(ctx context.Context, pages []interface{}) ([]interface{}, error)

	// OnPageRendered is called after each page is rendered to HTML.
	OnPageRendered(ctx context.Context, page interface{}) error

	// OnOutputWritten is called after all output files are written but before
	// the build result is finalized. Receives the output directory path for
	// post-processing.
	OnOutputWritten(ctx context.Context, outputDir string) error
}

type MetadataProvider interface {
	PluginMetadata() PluginMeta
}

type Plugin interface {
	// Name is the plugin's unique identifier. It matches the yaml key under
	// plugins: (e.g. Name()=="seo_injector" pairs with yaml plugins.seo_injector.*).
	Name() string
}

type PluginMeta struct {
	Version    string   `json:"version"`
	Author     string   `json:"author"`
	RepoURL    string   `json:"repoURL"`
	License    string   `json:"license"`
	Tags       []string `json:"tags"`
	IsOfficial bool     `json:"isOfficial"`
}

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

type Schema struct {
	Fields []FieldSchema
}

type SchemaProvider interface {
	ConfigSchema() Schema
}

type ShortcodeContext struct {
	Params map[string]string
	Inner  string
}

type ShortcodeHandler func(ctx ShortcodeContext) (string, error)

type ShortcodeProvider interface {
	Shortcodes() map[string]ShortcodeHandler
}

type TemplateEntry struct {
	Path    string // Logical path, e.g. "index.html"
	Content string // Template content
}

type ThemeHooks interface {
	BeforeRender(ctx context.Context) error
	AfterRender(ctx context.Context) error
}

type ThemeInfo struct {
	Name        string   `json:"name"`
	Version     string   `json:"version"`
	Author      string   `json:"author"`
	Description string   `json:"description"`
	Screenshot  string   `json:"screenshot,omitempty"`
	Tags        []string `json:"tags,omitempty"`
	MinHuanVer  string   `json:"minHuanVer,omitempty"`
}

type ThemePlugin interface {
	Plugin

	// Info returns the theme's metadata as a key-value map.
	Info() map[string]any

	// Templates returns the list of templates the theme provides.
	// Each entry has "path" and "content" keys.
	Templates() []map[string]string

	// FuncMap returns the theme's custom template functions.
	FuncMap() template.FuncMap

	// Assets returns the theme's static asset filesystem.
	Assets() fs.FS
}