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 = model.FieldSubset

type HiddenField struct {
	Name  string `json:"name"`
	Value string `json:"value"`
}

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

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

type RenderMode string

type RenderOptions struct {
	// RenderMode selects document/current, form-only, or fields-only output.
	// The zero value preserves the renderer's historical document behavior.
	RenderMode RenderMode
	// 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 by an explicit theme helper so
	// renderers can resolve partials, assets, and tokens consistently.
	Theme *ThemeConfig
	// 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
	// StyleMode selects default, minimal, or unstyled vanilla output. Other
	// renderers may ignore this field when it does not apply.
	StyleMode StyleMode
	// IncludeSensitiveDefaults allows descriptor and browser renderers to emit
	// defaults for fields marked Sensitive. The default is to redact them.
	IncludeSensitiveDefaults 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 StyleMode string

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 ThemeConfig struct {
	Theme    string
	Variant  string
	Partials map[string]string
	Tokens   map[string]string
	CSSVars  map[string]string
	AssetURL func(string) string
}

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

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