headless_theme library
Capability-based theme runtime and overrides for Headless.
Classes
- CapabilityOverrides
- Type-safe override bag for theme capabilities.
- CapabilityOverridesBuilder
- Builder for CapabilityOverrides.
- HeadlessApp
- Universal bootstrap for Headless.
- HeadlessButtonScope
- Scoped capability overrides for buttons without generics.
- HeadlessCheckboxListTileScope
- Scoped capability overrides for checkbox list tiles without generics.
- HeadlessCheckboxScope
- Scoped capability overrides for checkboxes without generics.
- HeadlessDropdownScope
- Scoped capability overrides for dropdowns without generics.
- HeadlessMissingCapabilityWidget
- Fallback widget shown when a required Headless capability is missing.
- HeadlessMotionDefaults
- Centralized motion defaults for Headless presets.
- HeadlessMotionTheme
- App-level motion theme for Headless.
- HeadlessPressableSurfaceFactory
- Capability interface for creating pressable surface wrappers.
- HeadlessTapTargetPolicy
- Contract for platform-specific minimum tap target sizing.
- HeadlessTextFieldScope
- Scoped capability overrides for text fields without generics.
- HeadlessTheme
- Root capability discovery contract (v1 skeleton).
- HeadlessThemeOverridesScope
- Scoped capability overrides for a subtree.
- HeadlessThemeProvider
- Provides HeadlessTheme to descendant widgets.
- HeadlessThemeWithOverrides
- Headless theme wrapper that overrides specific capabilities.
- HeadlessWidgetStateQuery
- Canonical WidgetState interpretation for token resolvers.
Enums
- HeadlessDropdownItemVisualState
- Canonical “dominant” visual state for a dropdown menu item.
- HeadlessDropdownTriggerVisualState
- Canonical “dominant” visual state for dropdown trigger.
- HeadlessInteractionVisualState
- Canonical “dominant” interaction state for visuals.
- HeadlessTapTargetComponent
- Component types that can have a custom tap target size.
Functions
-
headlessGoldenPathHint(
) → String -
headlessMissingCapabilityWidgetMessage(
{required String missingCapabilityType}) → String -
requireCapability<
T> (HeadlessTheme theme, {required String componentName}) → T - Require a capability from the theme, throwing a standardized error if missing.
-
resolveDropdownItemVisualState(
{required HeadlessListItemModel item, required bool isHighlighted, required bool isSelected}) → HeadlessDropdownItemVisualState -
resolveDropdownTriggerVisualState(
{required HeadlessWidgetStateQuery q, required ROverlayPhase overlayPhase}) → HeadlessDropdownTriggerVisualState
Exceptions / Errors
- MissingCapabilityException
- Exception thrown when a required capability is missing from the theme.
- MissingThemeException
- Exception thrown when HeadlessThemeProvider is not found in the widget tree.