theme

type Adjacent struct {
	Prev *content.Item
	Next *content.Item
}

type Alternate struct {
	Locale, Label, URL string
}

type AppearanceCustomCSS struct {
	Present bool   `json:"present"`
	Bytes   int    `json:"bytes"`
	Source  string `json:"source"`
	Status  string `json:"status" enum:"none,applied_requires_browser_evaluation,invalid_not_applied"`
}

type AppearanceDeclared struct {
	Colors map[string]AppearanceValue `json:"colors"`
	Fonts  map[string]AppearanceValue `json:"fonts"`
}

type AppearanceOverride struct {
	Role     string  `json:"role" doc:"colors.<role> or fonts.<role>"`
	Source   string  `json:"source"`
	Value    string  `json:"value"`
	Declared *string `json:"declared" doc:"The theme's declared value it replaced; null when the theme declared none"`
}

type AppearanceProvider interface {
	Appearance(context.Context) AppearanceReport
}

type AppearanceReport struct {
	Theme AppearanceTheme `json:"theme"`
	// Colors and Fonts are the effective values after site customisation
	// (identity settings) was applied to the theme's declarations; each
	// value names its source. Declared keeps the theme's own declarations.
	Colors      map[string]AppearanceValue `json:"colors" doc:"Effective values after site identity settings; source says which setting or theme token supplied each"`
	Fonts       map[string]AppearanceValue `json:"fonts" doc:"Effective values after site identity settings"`
	Declared    *AppearanceDeclared        `json:"declared" doc:"The theme's own declarations before site customisation; null when the theme cannot be read"`
	Overrides   []AppearanceOverride       `json:"overrides" doc:"Site settings that changed a declared value, with provenance"`
	Scheme      AppearanceValue            `json:"scheme" doc:"Site colour scheme setting (light, dark) or the theme default"`
	Radius      AppearanceValue            `json:"radius" doc:"Site corner-radius setting or the theme default"`
	CustomCSS   AppearanceCustomCSS        `json:"custom_css"`
	ObservedAt  time.Time                  `json:"observed_at"`
	Limitations []string                   `json:"limitations"`
}

type AppearanceTheme struct {
	Slug    AppearanceValue `json:"slug"`
	Name    AppearanceValue `json:"name"`
	Version AppearanceValue `json:"version"`
}

type AppearanceValue struct {
	Value     *string `json:"value"`
	Source    string  `json:"source"`
	Available bool    `json:"available"`
	Reason    string  `json:"reason,omitempty"`
}

type BuilderPreviewOptions struct {
	Theme, Title, Tagline, CSS, Logo string
	Identity                         brand.Identity // Zero means inherit the public theme without an identity override.
	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 Destination struct {
	Available bool
	Fallback  bool
	Purpose   string
	URL       string
	Title     string
	Locale    string
	Item      *content.Item
}

type IdentityDraft struct {
	Snapshot IdentitySnapshot `json:"snapshot"`
	SavedAt  string           `json:"saved_at"`
	Author   string           `json:"author"`
	// Base holds the live site values when the draft was saved, so a draft
	// never restores a title or logo that another apply changed meanwhile.
	Base map[string]string `json:"base,omitempty"`
	// Rebased lists the site keys replaced by their live value on load.
	Rebased []string `json:"-"`
}

type IdentityLogoSelectionStore interface {
	IdentityLogoReview(context.Context, string) (revision string, slotBaselines map[string]string, err error)
	SaveIdentityLogoSlot(ctx context.Context, slug, baseline, slot, mediaID string) error
}

type IdentityLogoStore interface {
	IdentityLogoRevision(context.Context, string) (string, error)
	SaveIdentityLogo(ctx context.Context, slug, revision, slot, mediaID string) error
}

type IdentityPreviewOptions struct {
	View     string // "home" or "single" (newest published post; home when none)
	Locale   string
	Snapshot IdentitySnapshot
}

type IdentityRevision struct {
	ID       string           `json:"id"`
	At       string           `json:"at"`
	Author   string           `json:"author"`
	Kind     string           `json:"kind"` // baseline, apply, revert, import
	Snapshot IdentitySnapshot `json:"snapshot"`
}

type IdentitySnapshot struct {
	Theme  string            `json:"theme"`
	Values map[string]string `json:"values"`
	Site   map[string]string `json:"site"`
	// Links are the theme's header link settings (cta_label, cta_url) when
	// the theme declares them; they are written with the identity but are
	// ordinary theme settings, not design tokens.
	Links map[string]string `json:"links,omitempty"`
}

type IdentityValidationError struct{ Fields map[string]string }

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"`
	// Logos are optional theme-shipped marks by variant (primary, dark,
	// light, icon): asset paths relative to the theme's assets/ directory,
	// served at /themes/<slug>/assets/<path>. Site settings take precedence.
	Logos map[string]string `json:"logos,omitempty"`
	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 Library struct {
	Spec   LibrarySpec
	Values map[string]string // key → value, keys from Spec only
	// contains filtered or unexported fields
}

type LibraryActive struct {
	Key, Value, Label, RemoveURL string
}

type LibraryFilters struct {
	Groups   []LibraryGroup
	Active   []LibraryActive
	ClearURL string
	Total    int
}

type LibraryGroup struct {
	Key, Label string
	Options    []LibraryOption
}

type LibraryOption struct {
	Value, Label, URL string
	Count             int
	Active            bool
}

type LibrarySpec struct {
	// Type narrows every query and enables field filters; empty for a term
	// archive spanning several types (taxonomy filters only).
	Type       string
	Taxonomies []string
	Fields     []content.Field
	// Fixed are filters the page itself imposes (a term archive's term);
	// they are applied but not offered as options.
	Fixed map[string][]string
}

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"`
	// PrevURL and NextURL keep the request's other parameters (filters, a
	// search query); set by the site for listings, empty otherwise.
	PrevURL string `json:"prev_url,omitempty"`
	NextURL string `json:"next_url,omitempty"`
}

type PatternAware interface {
	SetPatternLayer(p PatternLayer)
	InvalidateCache()
}

type PatternLayer interface {
	// Active returns the filesystem directory and slug of the active pattern.
	// ok is false when no pattern is active or the package cannot be loaded.
	Active(ctx context.Context) (dir, slug string, ok bool)
}

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 Series struct {
	Term  taxonomy.Term
	Parts []content.Item
	Index int
	Count int
	Prev  *content.Item
	Next  *content.Item
}

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 TermCount struct {
	Term  taxonomy.Term
	Count int
}

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