extensions

type Base struct {
	// The name of the extension.
	// This is used to uniquely identify the extension.
	ExtensionName string

	// The callback that is called when the extension is rendered.
	// This is used to get the template data and the template name.
	// The template name is the name of the template to render.
	// This is not the file name, but the name of the template.
	// IE: {{template "base" .}}
	Callback func(w http.ResponseWriter, r *http.Request) map[string]any
}

type Block struct {
	// The name of the block.
	// IE: {{define "content"}}, the block name is "content".
	BlockName string
	// The value of the block.
	// IE: {{define "content"}}Hello World{{end}}, the value is "Hello World".
	Value string
}

type Extension interface {
	// The name of the extension.
	// This is used to uniquely identify the extension.
	Name() string

	// Extra data for the extension when it is rendered.
	View(w http.ResponseWriter, r *http.Request) map[string]any
}

type ExtensionWithFilename interface {
	Extension
	// The file name for the extension.
	// This is the name of the template to render.
	// The template will be fetched from a template.Manager.
	Filename() string
}

type ExtensionWithStrings interface {
	Extension
	String(w http.ResponseWriter, r *http.Request) string
}

type ExtensionWithTemplate interface {
	Extension
	Template(w http.ResponseWriter, r *http.Request) *template.Template
}

type Options struct {
	// BaseManager is the manager for the base template.
	// It is used to get the base template, and to parse the extension template.
	BaseManager *templates.Manager

	// ExtensionManager is the manager for the extension template.
	ExtensionManager *templates.Manager

	// TemplateName is the name of the template to use as the base.
	// This is not the file name, but the name of the template.
	// IE: {{template "base" .}}
	TemplateName string

	// BlockName is the name of the block to render the template into.
	// IE: {{define "content"}}
	BlockName string

	// Called when an error occurs.
	OnError func(w http.ResponseWriter, r *http.Request, err error)

	// Called before the template is rendered.
	BeforeRender func(w http.ResponseWriter, r *http.Request, t *template.Template)

	// Custom blocks
	// These are blocks that are rendered before and after the template.
	CSS *Block
	JS  *Block
}

type WithFilename struct {
	Base
	// The file name for the extension.
	// This is the name of the template to render.
	FileName string
}

type WithStrings struct {
	Base
	HTMLString string
}

type WithTemplate struct {
	Base
	HTMLTemplate *template.Template
}