Theme configuration reference

• color.light.primary is the only required value. Brand and semantic colors require three- or six-digit hex strings with a leading #; CSS variables, rgb(), and named colors are not accepted here.

• color.light.secondary is derived from primary when omitted.

• color.dark is partial and inherits missing anchors from light.

• color.method defaults to analogous; supported values are analogous, monochromatic, and glass.

• color.fixShade defaults to true. It centers the source at shade 500; false places it near its inferred lightness.

• defaultTheme defaults to system. semantic values can be shared, then overridden under semantic.light or semantic.dark.

Interaction defaults are hoverLift 1px, hoverShadow 1, activeScale 0.98, focusAlpha 0.28, disabledOpacity equal to the scale opacity, and transition equal to the motion multiplier. hoverShadow, focusAlpha, and disabledOpacity accept 0–1; hoverLift, activeScale, and transition must be non-negative. These values live under interaction, while the table fields live under scale.

• fontFamily is the shared fallback. textFontFamily and headingFontFamily override it independently.

• bodySize defaults to 16px, captionSize to 13px, labelSize to 14px, and headingScale to 1.24 unless unit derives the first three.

• All typography sizes and headingScale must be positive.

• viewport.strategy accepts fixed, fluid, or stepped. fixed uses rootMax; fluid interpolates with clamp; stepped changes root size at generated threshold rules.

• With no viewport object, resolution uses fixed at 16px. A viewport object without strategy uses legacy fluid defaults of rootMin 14, rootMax 16, minWidth 320, and maxWidth 960. Preset merging can produce that object, so set strategy explicitly when size behavior matters.

• Use viewport: { strategy: "fixed" } for constant root sizing, or choose fluid/stepped and set the bounds intentionally. Changes affect rem-backed dimensions throughout the application.

• rootMin may equal rootMax for a fixed root size; minWidth must remain lower than maxWidth.

• Generated token names use the canonical --tui prefix.

• output.selector defaults to :root and darkSelector defaults to the data-tavo-theme dark selector.

• includeMediaQuery defaults to true but emits a system-dark query only when defaultTheme is system.

• breakpoint defaults are sm 480, md 768, and lg 1024 and must be strictly ascending.

• The current web package compiles responsive props and sx at its published breakpoints; changing config emits different token/build data but does not rebuild packaged media queries.

• tokens.light and tokens.dark are arbitrary name-to-string maps applied after generation.

• Without accessibility.contrast, theme generation produces no contrast warnings.

• AA checks at 4.5:1 and AAA checks at 7:1 for six supported token pairs.

• failOnViolation defaults to false. When true, buildThemeTokens and buildTheme throw when warnings exist.

• auditThemeA11y converts those thrown violations into error-severity structured issues.

• Token overrides can create violations after palette generation, so run the audit on the final project config.

• minimal: monochromatic, 2px radii, no shadows, comfortable density, and reduced motion.

• glass: translucent glass color method, 22px blur, stronger surface rounding and moderate shadow.

• enterprise: analogous fixed-shade palette, compact density, restrained radii and shadows.

• editorial: spacious density, larger surface radius and heading scale, half-pixel borders.

• dense: compact density, 36px medium controls, small radii and quiet shadows.

• mobile: spacious density, 46px controls, larger control and surface radii, glass method.

• monochrome: strict black primary, monochromatic method, zero radius and shadow.