render

type BBox struct {
	MinX, MinY, MaxX, MaxY float64
}

type ButtonInput struct {
	Label        string
	Value        string
	Subvalue     string
	Ratio        *float64 // nil = reference card
	Direction    string   // "up"|"down"|"right"|"left"
	Fill         string   // hex — meter fill
	Bg           string   // hex
	Fg           string   // hex
	Border       *bool    // nil = true
	ValueSize    string   // "small"|"medium"|"large"
	SubvalueSize string
	Stale        *bool
	Glyph        *ProviderGlyph
	GlyphMode    string // "watermark"|"centered"|"corner"|"none"
	ShowGlyph    *bool  // nil = true
	// SmartContrast enables the dual-layer contrast auto-flip for text
	// and the watermark glyph's back layer. The zero value (false)
	// renders fg exactly as provided — callers opt in per-render.
	// Application-level defaults live in GlobalSettings.SmartContrast
	// (default on), and main.go threads that runtime decision into
	// this field at each render site.
	SmartContrast bool
	// Starfield, when true, paints the animated xAI-style starfield
	// (orbital drift + per-star twinkle + a periodic shooting-star
	// streak) BEHIND the watermark glyph and text layers (paint order:
	// bg → starfield → glyph → meter fill → text). Currently set only
	// for Grok buttons (settings.StarfieldEnabled is provider-gated).
	// Animation requires a frame driver — see starfieldAnimationLoop
	// in cmd/plugin/main.go — because Stream Deck rasterizes each
	// SetImage SVG to a static PNG.
	Starfield bool
}

type GlyphPath struct {
	// D is the SVG path data for this glyph element.
	D string
	// Stroke renders this path as a stroked outline instead of a fill.
	Stroke bool
	// StrokeWidth preserves source SVG stroke widths for stroked paths.
	StrokeWidth float64
}

type ProviderGlyph struct {
	// ViewBox is the SVG viewBox attribute for the glyph path.
	ViewBox string
	// Markup holds raw inner SVG elements for glyphs that are not plain
	// path-only marks. Elements should use currentColor for brand-colored
	// fills/strokes so each render layer can recolor them safely.
	Markup string
	// D is the SVG path `d` attribute for the glyph geometry.
	D string
	// Paths holds multi-path glyph geometry. When set, Paths is rendered
	// instead of D so mixed fill/stroke logos can keep their source shape.
	Paths []GlyphPath
	// Stroke renders the glyph as an outline (stroke + fill:none +
	// vector-effect:non-scaling-stroke) instead of the default filled
	// silhouette — lets outline marks (Tabler, Lucide, etc.) sit
	// alongside solid brand glyphs without reshaping each path to a
	// closed fill region.
	Stroke bool
}