render

type ChromeClasses struct {
	// Form overrides the CSS class attribute on the root <form> element.
	Form string
	// Header overrides the header wrapping title/subtitle chrome.
	Header string
	// Section overrides the section wrapper used for grouped fields.
	Section string
	// Fieldset overrides the section wrapper when section.fieldset is true.
	Fieldset string
	// Actions overrides the action row container class list.
	Actions string
	// Errors overrides the top-of-form error summary class list.
	Errors string
	// Grid overrides the grid container used for field layouts.
	Grid string
}

type ErrorMapping struct {
	Fields map[string][]string
	Form   []string
}

type FieldSubset struct {
	Groups   []string
	Tags     []string
	Sections []string
}

type HiddenField struct {
	Name  string
	Value string
}

type MissingTranslationHandler func(locale, key string, args []any, err error) string

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

type RenderOptions struct {
	// Method overrides the HTTP method declared by the form model. Renderers are
	// responsible for translating unsupported verbs (PATCH/PUT/DELETE) into
	// browser-friendly POST submissions plus a hidden _method input when needed.
	Method string
	// Subset restricts rendering to fields whose group, tags, or section match
	// the supplied tokens. Empty subsets leave the form unchanged.
	Subset FieldSubset
	// Values pre-populates rendered controls using dotted field paths (e.g.
	// "author.email"). Values may be wrapped in ValueWithProvenance to attach
	// provenance labels or lock fields as readonly/disabled. Renderers can
	// decide how to handle nested values or collections for advanced components
	// such as chips/typeahead controls.
	Values map[string]any
	// Errors surfaces server-side validation feedback keyed by field path. The
	// vanilla renderer maps these into inline chrome plus data-validation
	// attributes so the runtime and assistive tech can reflect the state without
	// waiting for client-side validation.
	Errors map[string][]string
	// FormErrors carries non-field-specific validation messages that should
	// render at the top of the form. These often come from request-scoped or
	// cross-field validation in the backend.
	FormErrors []string
	// HiddenFields injects name/value pairs as hidden inputs, useful for CSRF
	// tokens, auth/session hints, optimistic locking versions, or other
	// submission metadata that should travel with the form without showing up in
	// the visible schema.
	HiddenFields map[string]string
	// Locale selects the locale used by render-time localization helpers.
	Locale string
	// Translator enables model and template-level localization.
	Translator Translator
	// OnMissing customizes what string is used when a translation is missing.
	OnMissing MissingTranslationHandler
	// Theme passes renderer configuration derived from a go-theme Selection so
	// renderers can resolve partials, assets, and tokens consistently.
	Theme *theme.RendererConfig
	// VisibilityContext carries evaluator-specific inputs such as current form
	// values or feature flags used to decide whether a field should render.
	VisibilityContext visibility.Context
	// TopPadding controls how many leading newlines renderers emit before the
	// root form markup when no external stylesheets or inline styles are
	// present. A zero value allows the renderer to apply its default.
	TopPadding int
	// OmitAssets instructs renderers to skip emitting <link>, <style>, and
	// <script> tags. This is useful for rendering partial forms (e.g., modal
	// bodies) that will be embedded in a page where the parent already supplies
	// these assets.
	OmitAssets bool
	// ChromeClasses overrides high-level CSS class lists in renderer templates.
	// When nil or empty, renderer defaults are used.
	ChromeClasses *ChromeClasses
}

type Renderer interface {
	Name() string
	ContentType() string
	Render(ctx context.Context, model model.FormModel, options RenderOptions) ([]byte, error)
}

type TemplateI18nConfig struct {
	// LocaleKey selects the field/key used to infer locale from template data
	// when callers pass a struct or map instead of a raw string.
	LocaleKey string
	// FuncName customizes the translator helper name (defaults to "translate").
	FuncName string
	// OnMissing controls the string returned when a translation is missing.
	OnMissing MissingTranslationHandler
}

type Translator interface {
	Translate(locale, key string, args ...any) (string, error)
}

type ValueWithProvenance struct {
	Value      any
	Provenance string
	Readonly   bool
	Disabled   bool
}