themes

type Manifest struct {
	Name          string              `json:"name"`
	Description   *string             `json:"description,omitempty"`
	Version       string              `json:"version"`
	Author        *string             `json:"author,omitempty"`
	WidgetAreas   []ThemeWidgetArea   `json:"widget_areas,omitempty"`
	MenuLocations []ThemeMenuLocation `json:"menu_locations,omitempty"`
	Assets        *ThemeAssets        `json:"assets,omitempty"`
	Metadata      map[string]any      `json:"metadata,omitempty"`
}

type RegionInfo struct {
	Key            string
	Name           string
	AcceptsBlocks  bool
	AcceptsWidgets bool
	Fallbacks      []string
}

type RegisterTemplateInput struct {
	ThemeID      uuid.UUID
	Name         string
	Slug         string
	Description  *string
	TemplatePath string
	Regions      map[string]TemplateRegion
	Metadata     map[string]any
}

type RegisterThemeInput struct {
	Name        string
	Description *string
	Version     string
	Author      *string
	ThemePath   string
	Config      ThemeConfig
	Activate    bool
}

type Service interface {
	RegisterTheme(ctx context.Context, input RegisterThemeInput) (*Theme, error)
	GetTheme(ctx context.Context, id uuid.UUID) (*Theme, error)
	GetThemeByName(ctx context.Context, name string) (*Theme, error)
	ListThemes(ctx context.Context) ([]*Theme, error)
	ListActiveThemes(ctx context.Context) ([]*Theme, error)

	ActivateTheme(ctx context.Context, id uuid.UUID) (*Theme, error)
	DeactivateTheme(ctx context.Context, id uuid.UUID) (*Theme, error)

	RegisterTemplate(ctx context.Context, input RegisterTemplateInput) (*Template, error)
	UpdateTemplate(ctx context.Context, input UpdateTemplateInput) (*Template, error)
	DeleteTemplate(ctx context.Context, id uuid.UUID) error
	GetTemplate(ctx context.Context, id uuid.UUID) (*Template, error)
	ListTemplates(ctx context.Context, themeID uuid.UUID) ([]*Template, error)

	TemplateRegions(ctx context.Context, templateID uuid.UUID) ([]RegionInfo, error)
	ThemeRegionIndex(ctx context.Context, themeID uuid.UUID) (map[string][]RegionInfo, error)

	ListActiveSummaries(ctx context.Context) ([]ThemeSummary, error)
}

type Template struct {
	bun.BaseModel `bun:"table:templates,alias:tp"`

	ID           uuid.UUID                 `bun:",pk,type:uuid" json:"id"`
	ThemeID      uuid.UUID                 `bun:"theme_id,notnull,type:uuid" json:"theme_id"`
	Name         string                    `bun:"name,notnull" json:"name"`
	Slug         string                    `bun:"slug,notnull" json:"slug"`
	Description  *string                   `bun:"description" json:"description,omitempty"`
	TemplatePath string                    `bun:"template_path,notnull" json:"template_path"`
	Regions      map[string]TemplateRegion `bun:"regions,type:jsonb,notnull" json:"regions"`
	Metadata     map[string]any            `bun:"metadata,type:jsonb" json:"metadata,omitempty"`
	CreatedAt    time.Time                 `bun:"created_at,nullzero,default:current_timestamp" json:"created_at"`
	UpdatedAt    time.Time                 `bun:"updated_at,nullzero,default:current_timestamp" json:"updated_at"`

	Theme *Theme `bun:"rel:belongs-to,join:theme_id=id" json:"theme,omitempty"`
}

type TemplateRegion struct {
	Name            string   `json:"name"`
	Description     *string  `json:"description,omitempty"`
	AcceptsWidgets  bool     `json:"accepts_widgets"`
	AcceptsBlocks   bool     `json:"accepts_blocks"`
	FallbackRegions []string `json:"fallback_regions,omitempty"`
}

type Theme struct {
	bun.BaseModel `bun:"table:themes,alias:t"`

	ID          uuid.UUID   `bun:",pk,type:uuid" json:"id"`
	Name        string      `bun:"name,notnull,unique" json:"name"`
	Description *string     `bun:"description" json:"description,omitempty"`
	Version     string      `bun:"version,notnull" json:"version"`
	Author      *string     `bun:"author" json:"author,omitempty"`
	IsActive    bool        `bun:"is_active,notnull,default:false" json:"is_active"`
	ThemePath   string      `bun:"theme_path,notnull" json:"theme_path"`
	Config      ThemeConfig `bun:"config,type:jsonb" json:"config"`
	CreatedAt   time.Time   `bun:"created_at,nullzero,default:current_timestamp" json:"created_at"`
	UpdatedAt   time.Time   `bun:"updated_at,nullzero,default:current_timestamp" json:"updated_at"`

	Templates []*Template `bun:"rel:has-many,join:id=theme_id" json:"templates,omitempty"`
}

type ThemeAssets struct {
	BasePath *string  `json:"base_path,omitempty"`
	Styles   []string `json:"styles,omitempty"`
	Scripts  []string `json:"scripts,omitempty"`
	Images   []string `json:"images,omitempty"`
}

type ThemeAssetsSummary struct {
	Styles  []string
	Scripts []string
	Images  []string
}

type ThemeConfig struct {
	WidgetAreas   []ThemeWidgetArea   `json:"widget_areas,omitempty"`
	MenuLocations []ThemeMenuLocation `json:"menu_locations,omitempty"`
	Assets        *ThemeAssets        `json:"assets,omitempty"`
	Metadata      map[string]any      `json:"metadata,omitempty"`
}

type ThemeMenuLocation struct {
	Code        string  `json:"code"`
	Name        string  `json:"name"`
	Description *string `json:"description,omitempty"`
}

type ThemeSummary struct {
	Theme  *Theme
	Assets ThemeAssetsSummary
}

type ThemeWidgetArea struct {
	Code        string  `json:"code"`
	Name        string  `json:"name"`
	Description *string `json:"description,omitempty"`
	Scope       string  `json:"scope,omitempty"` // e.g. "global", "template", "page"
}

type UpdateTemplateInput struct {
	TemplateID   uuid.UUID
	Name         *string
	Description  *string
	TemplatePath *string
	Regions      map[string]TemplateRegion
	Metadata     map[string]any
}