render

type FlushableWriter struct {
	io.Writer
	FlushCount int
}

type HookConfig struct {
	Name   string // Hook name (e.g., "Sortable", "Tooltip")
	Config any    // Hook-specific configuration (struct or map, marshaled to JSON)
}

type LinkTag struct {
	Rel         string // rel attribute
	Href        string // href attribute
	Type        string // type attribute
	Sizes       string // sizes attribute
	CrossOrigin string // crossorigin attribute
	Media       string // media attribute
}

type MetaTag struct {
	Name      string // name attribute
	Content   string // content attribute
	Property  string // property attribute (for OpenGraph)
	HTTPEquiv string // http-equiv attribute
	Charset   string // charset attribute
}

type OptimisticConfig struct {
	Class string // Class to add/remove optimistically
	Text  string // Text to show optimistically
	Attr  string // Attribute to modify optimistically
	Value string // Attribute value
}

type PageData struct {
	// Body is the root VNode for the page content
	Body *vdom.VNode

	// Title is the page title
	Title string

	// Meta contains meta tags for the page
	Meta []MetaTag

	// Links contains link tags (stylesheets, favicon, etc.)
	Links []LinkTag

	// Scripts contains script tags to include
	Scripts []ScriptTag

	// Styles contains inline CSS styles
	// SECURITY: Style content is treated as trusted and must not contain "</style>".
	// RenderPage rejects any style string containing a closing style tag to prevent HTML injection.
	Styles []string

	// SessionID is deprecated and no longer rendered.
	// The client manages session IDs via sessionStorage for WebSocket reconnection.
	// This field is retained for backward compatibility but has no effect.
	SessionID string

	// CSRFToken is rendered as a <meta name="csrf-token"> tag in the document head.
	// The client reads this for WebSocket handshake; userland code can also use it
	// for HTTP requests (e.g., fetch with X-CSRF-Token header).
	CSRFToken string

	// ClientScript is the path to the thin client JavaScript
	// Defaults to "/_vango/client.js" if not specified
	ClientScript string

	// StyleSheets contains paths to external stylesheets
	StyleSheets []string

	// Lang is the language attribute for the html element
	// Defaults to "en" if not specified
	Lang string

	// Debug enables debug mode for the thin client.
	// When true, adds data-debug="true" to the client script tag.
	// Should be false in production.
	Debug bool
}

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

type RendererConfig struct {
	// Pretty enables pretty-printed HTML output with indentation.
	// Should only be used in development as it increases output size.
	Pretty bool

	// Indent is the string used for each indentation level in pretty mode.
	// Defaults to two spaces if not specified.
	Indent string

	// IncludeCSRF indicates whether to include CSRF token in the output.
	IncludeCSRF bool

	// AssetPath is the base path for assets.
	AssetPath string

	// InlineCriticalCSS indicates whether to inline critical CSS.
	InlineCriticalCSS bool

	// URLPolicy controls scheme allowlists for URL-bearing attributes.
	// If zero-valued, defaults are used.
	URLPolicy vdom.URLPolicy
}

type ScriptTag struct {
	Src    string // src attribute
	Type   string // type attribute
	Defer  bool   // defer attribute
	Async  bool   // async attribute
	Module bool   // type="module"
	Inline string // inline script content
}

type StreamingRenderer struct {
	*Renderer
	// contains filtered or unexported fields
}