atoms library
Atoms do Flocks — os componentes de UI mais fundamentais (texto, ícones…).
Só sobre a camada widgets (sem Material/Cupertino).
Classes
- AppAvatar
- Avatar genérico do design system.
- AppBadge
- A compact status pill — the Flocks badge.
- AppBorderProgress
- A widget that draws an animated border progress around its child.
- AppCheckbox
- Checkbox do design system. Reconstruído sobre FlocksInteraction (foco por Tab, Enter/Space, hover, ring de foco) com semântica de toggle.
- AppCircularLoading
- The App Circular Loading widget — anel de progresso.
- AppDivider
- A thin rule that separates content — the Flocks divider.
- AppDotsIndicator
- Indicador de passos/páginas em formato de "dots".
- AppIcon
- The App Icon widget.
- AppIllustration
- The App Illustration widget.
- AppIllustrationColorMapper
-
Um
ColorMapperque substitui as cores do SVG de ilustração do app. - AppImage
- Imagem raster (rede ou asset) do Flocks, com loading e fallback padronizados.
- AppLinearLoading
- The App Linear Loading widget — barra de progresso linear.
- AppOverlayLoading
- A widget that overlays a loading indicator on top of a child widget.
-
AppRadio<
T> - Radio button circular do design system.
- AppRichText
- Rich text of the Flocks design system: renders a single line/paragraph that mixes multiple inline styles (bold words, colored highlights, links).
- AppScrollEdgeFade
- Esmaece a borda do conteúdo que ROLA, para o corte contra um cabeçalho ou rodapé fixo não ser uma linha seca.
- AppScrollEdgeFadeOwner
- Assume o véu da própria área: enquanto montado, o AppScrollEdgeFade ancestral não pinta véu nenhum.
- AppShimmerLoading
- The App Shimmer Loading widget — placeholder com brilho animado.
- AppShortcut
- Um atalho de teclado, para ser exibido.
- AppShortcutHint
- Selo que mostra um atalho de teclado.
- AppShortcutHintColor
- Cor imposta aos AppShortcutHint de uma subárvore.
- AppSideInset
-
Aplica o respiro lateral que a superfície hospedeira publicou em
MediaQuery.padding— e o CONSOME, para ninguém abaixo aplicar de novo. - AppStepData
- Dados de um passo do AppStepper.
- AppStepper
- Indicador visual de progresso em etapas com suporte a orientação horizontal e vertical.
- AppSurface
- Container-base temável do Flocks — a superfície sobre a qual o conteúdo se apoia (cards, painéis, menus, sheets).
- AppSwatch
- Amostra de cor: um quadrado arredondado (ou círculo) pintado com color.
- AppSwitch
- Switch (liga/desliga) do design system. Reconstruído sobre FlocksInteraction (foco/teclado/hover/ring) com a animação do thumb via AppMotion (respeita reduce-motion) e semântica de toggle.
- AppText
- The class that defines the AppText widget.
- AppTextSpan
- The class that defines the AppTextSpan element.
Enums
- AppAvatarEffect
- Micro-animação de hover/press aplicada a um AppAvatar clicável.
- AppAvatarSize
- Tamanho nomeado do AppAvatar — específico do componente (espelha AppIconSize).
- AppBadgeColor
- Semantic color role of an AppBadge.
- AppBadgeEffect
- Micro-animação de hover/press aplicada a um AppBadge clicável.
- AppBadgeSize
- Tamanho nomeado do AppBadge — dirige o padding interno e o papel de texto.
- AppIconSize
- The size of the icon.
- AppIllustrationSize
- The size of the illustration.
- AppImageLoading
- Placeholder mostrado enquanto uma imagem de rede carrega.
- AppShortcutHintSize
- Tamanhos do selo de atalho.
- AppSurfaceVariant
- Nível de elevação de um AppSurface.
- AppSwatchShape
- Formato do AppSwatch (amostra de cor).
Constants
- appStepperCircleSize → const double
- Tamanho do círculo indicador de passo.
- appStepperMinLineLength → const double
- Tamanho mínimo da linha de conexão entre passos.
Functions
-
appCheckboxStateColors(
AppColorTheme theme, {required bool selected, required bool disabled, required bool isDark}) → ({Color? border, Color? container, Color indicator}) -
Cores do AppCheckbox por estado (função pura, testável — ver
test/src/theme/component_state_contrast_test.dart). -
appRadioStateColors(
AppColorTheme theme, {required bool selected, required bool disabled, required bool isDark}) → ({Color? border, Color? container, Color indicator}) -
Cores do AppRadio por estado (função pura, testável — ver
test/src/theme/component_state_contrast_test.dart). -
appSwitchStateColors(
AppColorTheme theme, {required bool selected, required bool disabled, required bool isDark}) → ({Color? border, Color? container, Color indicator}) -
Cores do AppSwitch por estado (função pura, testável — ver
test/src/theme/component_state_contrast_test.dart). -
resolveAvatarInteraction(
{required Set< WidgetState> states, required AppAvatarEffect effect, required Color onSurface, required bool isDark, required bool motionEnabled}) → AvatarInteraction -
Função pura que mapeia
states+effectpara o visual de interação de um avatar. Sem dependência deBuildContext— testável diretamente (espelhaappFilledButtonColors). -
resolveBadgeInteraction(
{required Set< WidgetState> states, required AppBadgeEffect effect, required Color onSurface, required bool isDark, required bool motionEnabled}) → BadgeInteraction -
Função pura que mapeia
states+effectpara o visual de interação de um badge. Sem dependência deBuildContext— testável diretamente (espelharesolveAvatarInteraction).
Typedefs
-
AvatarInteraction
= ({List<
BoxShadow> ? liftShadow, Color? overlay, double scale}) - Resolução visual de um conjunto de estados de interação de um avatar: a escala, o realce translúcido (overlay) e a sombra de "lift" (arraste).
-
BadgeInteraction
= ({List<
BoxShadow> ? liftShadow, Color? overlay, double scale}) - Resolução visual de um conjunto de estados de interação de um badge: a escala, o realce translúcido (overlay) e a sombra de "lift" (arraste).