theme

type Alternate struct {
	Locale, Label, URL string
}

type BuilderPreviewOptions struct {
	Theme, Title, Tagline, CSS, Logo string
	Identity                         brand.Identity
	Menu                             *menus.Menu
}

type CommentNode struct {
	ID, AuthorName, Body, CreatedAt string
	Replies                         []CommentNode
}

type CommentsData struct {
	Open      bool   // the item takes new comments
	ContentID string // posted as content_id
	Action    string // the form's action URL
	Back      string // posted as _back: the item's path (with its locale prefix)
	Count     int
	Items     []CommentNode // approved top-level comments, oldest first, with their replies
}

type Context struct {
	Site       SiteInfo
	Request    *http.Request
	Kind       string
	Content    *content.Item
	Items      []content.Item
	Term       *taxonomy.Term
	Pagination Pagination
	Query      map[string]string
	User       *auth.User
	Theme      Info
	Extra      map[string]any
	Locale     string
	Dir        string
	Status     int
	// Alternates are the page in each locale it exists in (hreflang links and language
	// switchers); empty when it exists in one locale only.
	Alternates []Alternate
}

type Info struct {
	Slug      string          `json:"slug"`
	Name      string          `json:"name"`
	Version   string          `json:"version"`
	Parent    string          `json:"parent"`
	Locations []string        `json:"locations"`
	Settings  []content.Field `json:"settings"`
	Supports  []string        `json:"supports"`
	Dir       string          `json:"dir"`
}

type InfoLookup interface {
	Lookup(slug string) (Info, error)
}

type InheritedSource struct {
	Name   string `json:"name"` // e.g. templates/single.html
	Before string `json:"before"`
	After  string `json:"after"` // "" when no theme in the new chain provides it
}

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

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

type Option func(*Module)

type Override struct {
	Name      string `json:"name"`
	Draft     bool   `json:"draft"`
	UpdatedAt string `json:"updated_at"`
}

type Pagination struct {
	Page    int  `json:"page"`
	PerPage int  `json:"per_page"`
	Total   int  `json:"total"`
	Pages   int  `json:"pages"`
	HasPrev bool `json:"has_prev"`
	HasNext bool `json:"has_next"`
}

type ReparentReport struct {
	Child      string            `json:"child"`
	OldParent  string            `json:"old_parent"`
	NewParent  string            `json:"new_parent"`
	Changed    []InheritedSource `json:"changed"`   // inherited files whose source theme changes
	Missing    []string          `json:"missing"`   // part/component references the new chain cannot resolve
	Unchanged  int               `json:"unchanged"` // inherited files with the same source
	Applied    bool              `json:"applied"`   // theme.json was rewritten
	BackupPath string            `json:"backup,omitempty"`
}

type Service interface {
	Active(ctx context.Context) Info
	List(ctx context.Context) ([]Info, error)
	Activate(ctx context.Context, slug string) error
	Resolve(req kernel.KindRequest) (templateName string, err error)
	Render(ctx context.Context, w http.ResponseWriter, req kernel.KindRequest, tc *Context) error // renders with layout; on template error → 500 page + log
	Templates(ctx context.Context) ([]TemplateFile, error)
	ReadTemplate(ctx context.Context, name string) (string, error)
	TemplateDetails(ctx context.Context, name string) (TemplateDTO, error)
	SaveOverride(ctx context.Context, name, body string, draft bool) error
	Overrides(ctx context.Context) ([]Override, error)
	PublishOverride(ctx context.Context, name string) error
	DeleteOverride(ctx context.Context, name string) error
}

type SiteInfo struct {
	Title   string `json:"title"`
	Tagline string `json:"tagline"`
	BaseURL string `json:"base_url"`
	Locale  string `json:"locale"`
	Dir     string `json:"dir"`
	Theme   string `json:"theme"`
}

type TOC struct {
	Body  template.HTML
	Items []TOCItem
}

type TOCItem struct {
	ID    string
	Text  string
	Level int
}

type TemplateDTO struct {
	Name   string  `json:"name"`
	Source string  `json:"source"`
	Body   string  `json:"body"`
	Draft  *string `json:"draft"`
}

type TemplateFile struct {
	Name   string `json:"name"`
	Path   string `json:"path"`
	Source string `json:"source"`
}

type TemplateListDTO struct {
	Templates []TemplateFile `json:"templates"`
	Overrides []Override     `json:"overrides"`
}

type ThemeDTO struct {
	Info
	Active bool `json:"active"`
}