templating

type Config struct {
	OutputPath string  `yaml:"output_path,omitempty"`
	FontPath   *string `yaml:"font_path,omitempty"`
	Covers     []Cover `yaml:"covers,omitempty"`
}

type Cover struct {
	Meta CoverMeta
	Data any
}

type CoverMeta struct {
	Name     string `yaml:"name"`
	Template string `yaml:"template"`
}

type GradientTemplate struct{}

type GradientTemplateConfig struct {
	HeadingLines *[]string `yaml:"heading_lines,omitempty"`
	Title        *string   `yaml:"title,omitempty"`
	Subtitle     *string   `yaml:"subtitle,omitempty"`
	Font         *string   `yaml:"font,omitempty"`
}

type GradientTemplateContext struct {
	GradientTemplateConfig

	Colour1 string
	Colour2 string
}

type State struct {
	DataHash     string `yaml:"data_hash"`
	TemplateHash string `yaml:"template_hash"`
}

type StateFile struct {
	GeneratedCovers map[string]State `yaml:"generated_covers"`
}

type TemplateDefinition interface {
	// ID returns a unique identifier for the template.
	// The value should match the filename for the template, without the .svg extension.
	ID() string

	// DecodeConfig decodes the config for the template from the given yaml.Node.
	// The yaml.Node will be a mapping node.
	DecodeConfig(value *yaml.Node) (any, error)

	// TemplateContext returns the data to be passed to the template for a given cover.
	TemplateContext(cover Cover) any
}