voo_navigation_core 0.4.3

voo_navigation_core: ^0.4.3 copied to clipboard

Added #

• VooActionModalChrome — visual chrome for the modal opened by a VooActionNavigationItem, passed through the new VooActionNavigationItem.modalChrome field. Carries borderRadius, backgroundColor, border, boxShadow, barrierColor, barrierOpacity and widthFactor.

Every field is optional and null keeps the navigation bar's own default, so an item that passes no chrome renders exactly as before. Wired through copyWith.

Added #

• VooAppBarConfig.titleSpacing — horizontal spacing around the title. When null, Material's default (NavigationToolbar.kMiddleSpacing, 16) still applies, so existing layouts are unchanged. Set it to align the title with a design system's own spacing scale.
• VooAppBarConfig.leadingWidth — width allotted to the leading widget. When null, Material's default (kToolbarHeight, 56) still applies. Set it when the leading widget is a visibly bounded control (a filled/bordered icon button) whose edge must line up with the page gutter rather than its icon — Material's 56px slot centers a smaller control and leaves its edge short of the gutter.

Both fields are wired through copyWith, hasOverrides, and the VooAppBarConfig.hidden() constructor.

Added #

• VooChromeBlur — new entity for opting nav chrome into the glassmorphic recipe. Fields:
  • appBarSigma (default 8) and bottomNavSigma (default 14) — ImageFilter.blur sigmas.
  • appBarSurfaceColor / bottomNavSurfaceColor — translucent fills painted behind the blur. Pass colors with alpha < 1.0 so scrolling content shows through.
  • Convenience getters hasAppBarBlur / hasBottomNavBlur so consuming scaffolds can short-circuit when the field is unset.
• VooNavigationConfig.chromeBlur — optional VooChromeBlur field (+ matching copyWith). Leave null for the historical flat opaque chrome; set it to enable the frosted-glass top bar + bottom nav. VooMobileAppBar (in this package) now wraps its AppBar in a BackdropFilter over the configured translucent surface when chromeBlur?.hasAppBarBlur == true.

Migration #

• No migration required — existing call sites compile unchanged. To enable the recipe:

  VooNavigationConfig(
    items: ...,
    chromeBlur: VooChromeBlur(
      appBarSurfaceColor: Color.fromRGBO(17, 17, 22, 0.6),
      bottomNavSurfaceColor: Color.fromRGBO(17, 17, 22, 0.92),
    ),
  )
  

Breaking #

• VooNavigationConfig API consolidation. Eighteen individual fields were collapsed into six cohesive struct types. The old fields are removed (no deprecated stubs); existing call sites must migrate.
  • useBodyCard / bodyCardElevation / bodyCardBorderRadius / bodyCardColor → bodyCard: VooBodyCardConfig(...)
  • floatingActionButton / floatingActionButtonLocation / floatingActionButtonAnimator / showFloatingActionButton → fab: VooFabConfig(widget: ..., location: ..., animator: ..., visible: ...) (use VooFabConfig.hidden to suppress)
  • animationDuration / animationCurve / enableAnimations / badgeAnimationDuration → animation: VooAnimationConfig(duration: ..., curve: ..., enabled: ..., badgeDuration: ...) (defaults now match VooMinimal.motionNormal + motionCurve; use VooAnimationConfig.disabled for instant transitions)
  • navigationBackgroundColor / selectedItemColor / unselectedItemColor / indicatorColor / indicatorShape / elevation → moved onto the existing navigationTheme: VooNavigationTheme(...). VooNavigationTheme gained selectedItemColor, unselectedItemColor, indicatorShape fields plus matching resolver methods.
  • drawerHeader / drawerHeaderTrailing / drawerFooter → drawerSlots: VooDrawerSlots(header: ..., headerTrailing: ..., footer: ...)
  • contentAreaMargin / contentAreaBorderRadius / contentAreaBackgroundColor → contentArea: VooContentAreaConfig(margin: ..., borderRadius: ..., backgroundColor: ...)

Added #

• Design system primitives (VooMinimal, VooMinimalTheme) — Linear/Vercel-inspired neutral palette + state-layer opacities + motion/radius/typography tokens, exposed via a ThemeExtension and context.vooMinimal. VooMinimalTheme.lightThemeData() / darkThemeData() build ready-to-use ThemeData. When consumers don't opt in, VooMinimalTheme.fallback(scheme) derives every value from the active ColorScheme so widgets remain theme-conformant.
• VooNavigationConfig.simple(items, onItemSelected) factory for the minimal-case shell (items + selection).
• VooNavigationConfig.appShell(items, header, multiSwitcher, searchBar, ...) factory pre-baking the typical SaaS app-shell config (collapsible rail on, multi-switcher in footer, search bar in header).
• VooMultiSwitcherConfig.fromUser(user, organizations, ...) factory — collapses 7 user fields into a single VooMultiSwitcherUser struct (existing constructor still works for explicit field control).

Changed #

• Atom-level glow shadows removed across VooBadge, VooBadgeText, VooBadgeDot, VooDotBadge, VooTextBadge, VooStatusBadge, VooStatusIndicator, VooEdgeIndicator, VooInitialsAvatar, VooStackedAvatars. Selection signal now comes from contrast + ring borders, not colored halos.
• Modal/overlay surfaces (notifications bell dropdown, quick actions menu, organization dropdown, multi/context switcher modals + bottom sheets, mobile app bar, expanded profile dropdown, search bar results) now use m.dropdownShadow (subtle two-stop) + hairline m.border instead of 16–20px primary-tinted glows. Tighter radii (10/8/6 in place of 16/14/12).
• VooSearchField redesigned around the minimal palette — kbd-style shortcut chip with hairline border, restrained focus ring, smaller icon, 1.5px focused border (was 2px).
• VooMobileAppBar no longer renders a 8px blur shadow under itself; relies on the hairline divider from AppBarTheme.shape.

Migration #

// Before
VooNavigationConfig(
  items: items,
  onNavigationItemSelected: onSelect,
  useBodyCard: true,
  bodyCardElevation: 1,
  bodyCardColor: Colors.white,
  floatingActionButton: FloatingActionButton(...),
  floatingActionButtonLocation: FloatingActionButtonLocation.endFloat,
  showFloatingActionButton: true,
  animationDuration: Duration(milliseconds: 200),
  enableAnimations: true,
  navigationBackgroundColor: Colors.grey,
  selectedItemColor: Colors.blue,
  drawerHeader: const Text('Header'),
  drawerFooter: const Text('Footer'),
)

// After
VooNavigationConfig(
  items: items,
  onNavigationItemSelected: onSelect,
  bodyCard: const VooBodyCardConfig(enabled: true, elevation: 1, color: Colors.white),
  fab: VooFabConfig(widget: FloatingActionButton(...), location: FloatingActionButtonLocation.endFloat),
  animation: const VooAnimationConfig(duration: Duration(milliseconds: 200)),
  navigationTheme: const VooNavigationTheme(surfaceColor: Colors.grey, selectedItemColor: Colors.blue),
  drawerSlots: const VooDrawerSlots(header: Text('Header'), footer: Text('Footer')),
)

Fixed #

• Section item overflow: default sectionItemHeight / itemHeight raised from 100 → 112 on VooQuickAction.section factory, the underlying VooQuickAction constructor, and the standalone VooQuickActionSection class. The previous 100 was 12px short of fitting a 2-line label under the 48×48 icon, producing "BOTTOM OVERFLOWED BY 12 PIXELS" for any longer action label (e.g. "Create community", "Create workout plan"). Existing call sites that pass an explicit height are unaffected.

Changed #

• Quick Actions section headers: default label style upgraded from titleSmall / onSurfaceVariant / w600 to titleMedium / onSurface / w700 with a subtle -0.2 letter spacing. Header-to-content spacing increased from 8 → 12. Custom labelStyle overrides continue to take precedence.

Added #

• Hide-when-empty for Quick Actions sections: sections (both VooQuickActionsSectionsLayout entries and inline VooQuickAction.section items inside grid layouts) that contain zero actions no longer render their header or container. Lets callers hide a section just by passing an empty actions list.

Added #

• VooUserProfileConfig.showNavItemLabel: New bool (default true) that controls whether the profile entry shows a label next to its avatar in the bottom navigation. Set to false for an icon-only profile entry that collapses to a pure avatar circle when selected.

Changed #

• VooUserProfileConfig.effectiveNavItemLabel is now String? and returns null when showNavItemLabel: false. All internal callers fall back to 'Profile' when null, so existing call sites continue to work.

Changed (breaking) #

• VooNavigationDestination.label is now optional (String?). Destinations can omit a label for icon-only navigation; the selected expandable state collapses to a colored icon circle with no label expansion. Existing call sites passing a label continue to work unchanged.
• VooNavigationDestination.divider() factory no longer passes an empty label: — divider items now report label == null.

Added #

• VooActionItemPosition.trailingPill: New enum value placing the action item as a separate circular button outside the navigation pill (Apple Music style). Existing positions (start / center / end) keep rendering inside the pill.

Fixed #

• All label consumers (drawer items, rail items, search bar, app bar title, dropdown header/child) now safely handle a null label by falling back to an empty string.

Added #

• Hamburger Menu Config: VooNavigationConfig now exposes showHamburgerMenu (default false) and mobileDrawerBuilder to opt-in to a top-bar hamburger + drawer pattern on mobile. When the flag is on, consuming scaffolds automatically install a Scaffold.drawer and surface a hamburger leading icon in the mobile app bar.

Added #

• Profile Long-Press: VooUserProfileConfig now exposes onLongPress and longPressModalBuilder for handling long-press on the profile nav item. When longPressModalBuilder is set, long-press opens an overlay modal anchored to the avatar using the same downward-arrow + slide/scale/fade animation as the action button — useful for account/app/context switchers. Tap behavior is unchanged.

Fixed #

• Scroll-Under Tint: Added forceMaterialTransparency: true on mobile app bar to completely bypass M3 elevation/tint/shadow logic

Fixed #

• Scroll-Under Tint: Added surfaceTintColor: Colors.transparent on mobile app bar to fully disable M3 surface tint overlay

Fixed #

• Scroll-Under Tint: Set scrolledUnderElevation: 0 on mobile app bar to prevent surface tint color shift when content scrolls underneath

Fixed #

• Theming Fix: Fixed hard-coded colors in mobile app bar
  • Background now uses theme.colorScheme.surface instead of hard-coded dark/light colors
  • Mobile app bar properly respects custom dark themes

Fixed #

• VooNavigationTokens: Fixed bottom nav bar theming using hard-coded dark mode colors instead of theme-aware colors
  • All 6 expandable nav getters now use Material 3 colorScheme properties consistently
  • expandableNavBackground now uses surfaceContainer for both light and dark modes
  • expandableNavUnselectedCircle now uses surfaceContainerHighest
  • expandableNavSelectedBackground now uses surfaceContainerHigh
  • expandableNavUnselectedIcon now uses onSurfaceVariant
  • expandableNavSelectedIcon now uses onPrimary
  • expandableNavSelectedLabel now uses onSurface
  • Bottom nav bar now properly respects custom dark themes

Fixed #

• VooOrganizationSwitcher: Fixed crash on mobile when widget is disposed while overlay is open
  • Added mounted check in _removeOverlay() to prevent setState() on defunct widget
  • Fixed FocusNode leak by properly disposing keyboard listener focus node

Fixed #

• Overlay Theming: Fixed overlay components not inheriting app theme
  • VooQuickActions, VooMultiSwitcher, VooContextSwitcher, VooNotificationsBell, VooOrganizationSwitcher, VooSearchBar, VooCollapsedItemsDropdown now capture and pass theme context to overlays

Added #

• VooQuickActionsSection: New entity for grouping quick actions with customizable styles
• VooQuickAction: Added onTap callback support for custom action handling

Changed #

• App bar: Refactored app bar configuration components
• Cleanup: Removed unused navigation atoms and components

Changed #

• VooQuickActionsGridLayout: Now uses flutter_staggered_grid_view for proper column spanning
  • Items with gridColumnSpan > 1 now correctly span multiple columns
  • Wide items (span > 1) use horizontal layout with icon left, text right
  • Replaced childAspectRatio with defaultItemHeight for clearer sizing

Added #

• Dependencies: Added flutter_staggered_grid_view: ^0.7.0 for advanced grid layouts

Added #

• VooUserProfileConfig: Added position property with VooUserProfilePosition enum
  • VooUserProfilePosition.start - Profile appears at the start of the nav bar
  • VooUserProfilePosition.end - Profile appears at the end (default)
  • navItemIndex takes priority over position if both are set

Fixed #

• VooUserProfileConfig: User profile now correctly uses effectiveId for selection state
  • Custom id is now properly used for navigation selection and callbacks
  • Avatar URL and other profile config properties are now correctly passed to the nav item

Changed #

• VooQuickActionsGridLayout: Rewrote to use GridView.builder with SliverGridDelegateWithFixedCrossAxisCount
  • Simpler, more reliable layout using native GridView
  • Added spacing parameter (default 8.0) for consistent gap between items
  • Added childAspectRatio parameter (default 1.0) for controlling item proportions
  • Supports scrolling via shrinkWrap: true

Added #

• VooQuickActionsMenuContent: Added grid customization parameters
  • gridSpacing - Spacing between grid items (default 8.0)
  • gridChildAspectRatio - Aspect ratio for grid items (default 1.0)

Added #

• VooUserProfileConfig: Added id property for custom navigation identification
  • Use with selectedId to show profile as selected without hardcoding '_user_profile_nav'
  • Added effectiveId getter that returns id or '_user_profile_nav' as fallback

Changed #

• VooQuickActionsGridLayout: Rewrote to use row-based ListView instead of Wrap
  • Now properly handles gridColumnSpan by organizing items into rows
  • Supports scrolling
  • Fixed grid column width calculation issues

Added #

• VooQuickAction: Added showLabel property for per-action label visibility control
  • If null (default), uses global showLabelsInGrid setting
  • If true/false, overrides global setting for that action only
• VooQuickActionsMenuContent: Added header support
  • title - Optional title displayed at the top
  • showCloseButton - Whether to show a close button
  • onClose - Callback when close button is tapped
  • contentPadding - Custom padding for the actions content area

Improved #

• VooQuickActionsGridLayout: Better layout for multi-column spanning items
  • Items with gridColumnSpan > 1 now use horizontal Row layout (icon left, label/description right)
  • Single-column items keep centered vertical layout
  • Added default background color (surfaceContainerLow) so items are visible
  • Description is now shown for wide items

Fixed #

• VooQuickActionsGridLayout: Fixed grid column width calculation causing incorrect wrapping

Fixed #

• VooQuickActionsGridLayout: Fixed gridColumns not being respected
  • Grid now uses actual container width for column calculations
  • Previously used style.dropdownWidth which could be null/incorrect

Added #

• VooQuickAction: Added grid layout customization properties
  • gridColumnSpan - Number of columns to span (default: 1)
  • gridBackgroundColor - Custom background color for the item
  • gridIconBackgroundColor - Custom background color for the icon
  • gridHeight - Custom height for the item

Changed #

• VooQuickActionsMenuContent: Made parameters optional with sensible defaults
  • style is now optional (defaults to VooQuickActionsStyle())
  • useGridLayout defaults to false
  • gridColumns defaults to 4
  • showLabelsInGrid defaults to true

Added #

• VooQuickActionsMenuContent: Exported for use in custom modal builders
  • Allows displaying quick actions content directly without the trigger button
  • Useful when using VooActionNavigationItem.modalBuilder to show actions
  • Added onReorderActions callback to enable drag-to-reorder functionality
  • Supports reordering in both list and grid layouts
  • Grid layout uses long-press drag with visual feedback and haptics

Changed #

• VooActionNavigationItem: Changed icon and activeIcon from Icon to Widget
  • Supports any widget like FaIcon, Icon, Image, etc.

Changed #

• VooActionNavigationItem: Changed icon and activeIcon from IconData to Icon for full customization
  • Provides direct control over icon color, size, and other properties
  • Removed iconColor parameter (set color directly on the Icon widget)

Fixed #

• VooQuickActions: Fixed AnimationController.reverse() called after dispose() error
  • Overlay is now removed synchronously during dispose without animation

Added #

• VooActionNavigationItem: Added navItemIndex property for explicit position control
  • Accepts values 0-4 to specify exact position in the bottom nav bar
  • Takes precedence over position property when specified
  • When null (default), falls back to position behavior (start/center/end)

Added #

• VooUserProfileConfig: Added navItemIndex property for explicit position control in mobile bottom navigation
  • Accepts values 0-4 to specify exact position in the bottom nav bar
  • When null (default), user profile appears at the end

Fixed #

• VooNavigationTokens: Made expandable bottom nav colors theme-aware for proper light/dark mode support
  • expandableNavBackground now uses surfaceContainer in light mode
  • expandableNavUnselectedCircle now uses surfaceContainerHighest in light mode
  • expandableNavSelectedBackground now uses surfaceContainerHigh in light mode
  • expandableNavUnselectedIcon now uses onSurfaceVariant in light mode
  • expandableNavSelectedIcon now uses onPrimary in light mode
  • expandableNavSelectedLabel now uses onSurface in light mode

Changed #

• VooUserProfileConfig: Updated effectiveNavItemLabel fallback priority
  • Now returns navItemLabel ?? userEmail ?? userName ?? 'Profile'
  • Email is now preferred over userName when no explicit label is set

Changed #

• VooNavigationDestination: Icon type changed from IconData to Widget
  • Now accepts Icon widgets directly instead of IconData
  • Enables full customization of icon size, color, and other properties at definition time
  • Components use IconTheme to apply default styling when needed
  • effectiveSelectedIcon getter now returns Widget instead of IconData

Added #

• VooUserProfileConfig: Added mobile bottom navigation support
  • mobilePriority - Include user profile in mobile bottom navigation
  • modalBuilder - Custom modal builder for profile tap action in bottom nav
  • navItemSortOrder - Control positioning in bottom navigation
  • navItemLabel - Custom label for the nav item
  • effectiveInitials - Getter to derive initials from userName
  • effectiveNavItemLabel - Getter for resolved nav item label
• VooUserProfileModalData: Data class for modal builder callback

Changed #

• NavigationItem → NavigationDestination: Renamed VooNavigationItem to VooNavigationDestination for clarity
  • File renamed from navigation_item.dart to navigation_destination.dart
  • All usages updated across the package
• VooCustomIndicator → VooScaleIndicator: Renamed indicator for clarity
  • File renamed from voo_custom_indicator.dart to voo_scale_indicator.dart

Updated #

• Various component improvements and refinements

Improved #

• Expandable Nav Tokens: Updated design tokens for expandable bottom navigation
  • Increased expandableNavBarHeight from 56 to 64 for better proportions
  • Increased expandableNavSelectedCircleSize from 38 to 44 for larger tap targets
  • Increased expandableNavBarPaddingHorizontal/Vertical from 6 to 8
  • Increased expandableNavAnimationDurationMs from 250 to 300 for smoother animations
  • Added expandableNavItemSpacing token (8px)

Fixed #

• Floating Nav Background Color: Changed floatingNavBackground token from surfaceContainerHighest to surface
  • Floating bottom navigation bar now renders with a clean white background in light mode instead of noticeable grey
  • Dark mode continues to work correctly with the dark surface color
  • Shadow contrast is improved since the background is no longer grey

Fixed #

• Mobile App Bar Leading Widget Taking Up Space: Fixed VooMobileAppBar reserving space for the leading widget even when no content is shown
  • Uses VooAppBarLeading.wouldShowContent() to check if content would be rendered before building
  • Sets leadingWidth: 0 when no leading content exists
  • Changed automaticallyImplyLeading to false to prevent Flutter from implying a leading widget
  • Mirrors the fix already applied to VooAdaptiveAppBar in v0.2.5

Added #

• VooMultiSwitcherConfig.isLoading: New isLoading field for the multi-switcher (user/org switcher)
  • Shows a CircularProgressIndicator in place of the chevron on the card when loading
  • Disables tap interaction on the card while loading
  • Passed through to VooMultiSwitcherCardData and VooMultiSwitcherModalData for custom builders

Added #

• VooAppBarLeading.wouldShowContent(): New static helper method to check if the leading widget would render actual content
  • Useful for determining if leadingWidth should be set to 0 in AppBar to avoid empty space

Fixed #

• shouldShowBackButton Not Working: Fixed VooPageConfig.shouldShowBackButton not showing the back button
  • VooAppBarLeading.build() was short-circuiting on !showMenuButton before checking shouldShowBackButton
  • Reordered logic so shouldShowBackButton is evaluated even when showMenuButton=false
  • VooMobileAppBar now always creates VooAppBarLeading so back button logic can run

Added #

• VooMultiSwitcherNavItem: Mobile navigation support for the multi-switcher (org/user switcher)
  • Displays stacked avatars (organization + user) in compact form
  • Supports isCompact, useFloatingStyle, enableHapticFeedback properties
  • Opens VooMultiSwitcherBottomSheet on tap with combined organization and user sections
• VooMultiSwitcherBottomSheet: Bottom sheet modal for mobile multi-switcher interaction
  • Shows organization section with search (if enabled)
  • Shows user section with account info, multi-account list, settings, and logout
  • Reuses existing VooMultiSwitcherOrganizationSection and VooMultiSwitcherUserSection
• VooMultiSwitcherConfig: Added mobile nav item properties
  • showAsNavItem - Whether to show as navigation item
  • mobilePriority - Include in mobile priority items (max 5)
  • navItemSortOrder - Sort order among priority items
  • navItemLabel - Optional label for the nav item
• VooMultiSwitcherPosition: Added asNavItem position for rendering as navigation item
• VooNavigationConfig: Updated mobilePriorityItems getter to include multi-switcher when configured with mobilePriority: true

Added #

• VooPageConfig: Added shouldShowBackButton property for per-page back button control
  • null (default): Auto behavior based on Navigator.canPop()
  • true: Always show the back button
  • false: Never show the back button
• VooPageConfig: Added wrapInScaffold property for simple scaffold wrapping
  • When true, wraps the page child in a basic Scaffold(body: child)
  • Simpler alternative to useCustomScaffold + scaffoldBuilder
• VooAppBarLeading: Added pageConfig parameter to pass VooPageConfig for back button control
• VooMobileAppBar: Added pageConfig parameter to pass to VooAppBarLeading

Changed #

• VooNavigationItem: Removed strict assertion requiring route, destination, onTap, or children
  • Items can now be created without navigation callbacks when using scaffold-level onNavigationItemSelected
  • Cleaned up VooNavigationItem.divider() factory to no longer require unnecessary onTap

Added #

• VooNavigationConfig: Added validation that ensures navigation is properly configured
  • When onNavigationItemSelected is provided, items don't need individual navigation callbacks
  • When onNavigationItemSelected is NOT provided, items must have route, destination, onTap, or children
  • Dividers are automatically skipped during validation
  • Recursive validation for nested children items

Added #

• VooContextSwitcher: Inline context/project switching component for dynamic navigation

  • VooContextItem - Entity representing a switchable context (project, workspace, environment)
  • VooContextSwitcherConfig - Main configuration class with items, callbacks, and customization
  • VooContextSwitcherStyle - Style configuration for card, modal, and item appearance
  • VooContextSwitcherPosition - Enum for positioning (beforeItems, afterHeader)

• Context Switcher Widgets:

  • VooContextSwitcher - Main widget combining card and modal with overlay animation
  • VooContextSwitcherCard - Elegant pill-style selector with color indicator dot
  • VooContextSwitcherModal - Dropdown modal with context list, search, and create button

• Navigation Item Enhancement:

  • sectionHeaderWidget - Embed custom widgets (like context switcher) inside expandable sections
  • sectionHeaderLineColor - Custom color for the vertical line next to section header widgets

• Custom Builders: Full customization support with cardBuilder and modalBuilder

• VooMultiSwitcher: Unified organization and user switching component

  • VooMultiSwitcherConfig - Main configuration class for the multi-switcher
  • VooMultiSwitcherUser - Entity representing a switchable user account
  • VooMultiSwitcherStyle - Style configuration for card, modal, and sections
  • VooMultiSwitcherPosition - Enum for positioning (header, footer)

• Multi-Switcher Widgets:

  • VooMultiSwitcher - Main widget combining card and modal with overlay animation
  • VooMultiSwitcherCard - Closed state showing stacked org + user avatars
  • VooMultiSwitcherModal - Expanded state with organization and user sections
  • VooMultiSwitcherOrganizationSection - Organization list with selection
  • VooMultiSwitcherUserSection - User info with settings and logout actions
  • VooStackedAvatars - Overlapping org + user avatar display
  • VooMultiSwitcherOrgTile, VooMultiSwitcherUserTile, VooMultiSwitcherActionTile - List tiles

• Custom Builders: Full customization support with cardBuilder and modalBuilder

• Animation: Smooth overlay animation with spring physics using Curves.easeOutBack

Changed #

• VooNavigationConfig now includes multiSwitcher and multiSwitcherPosition fields

Added #

• VooNavigationTokens: New centralized design tokens for consistent styling across all navigation components
  • VooNavigationTokens class with static constants for icon sizes, spacing, typography, border radius, and opacity values
  • VooNavigationTokensTheme extension on BuildContext for theme-aware color generation:
    • context.navSelectedBackground([customColor]) - Selected item background with 10% opacity
    • context.navHoverBackground - Hover background with 4% opacity
    • context.navMutedIconColor - Muted icon color with 70% opacity
    • context.floatingNavBackground - Theme-aware floating nav background (surface)
    • context.floatingNavForeground - Floating nav foreground color
    • context.floatingNavSelectedColor - Primary color for selected floating nav items
    • context.navDividerColor - Divider color with proper opacity
    • context.navBorderSubtle - Subtle border color

Improved #

• Design System Consistency: All navigation packages now use shared tokens from voo_navigation_core
• Modern Appearance: Updated default itemBorderRadius to 8dp for a more modern look

Fixed #

• VooPageConfig Properties Not Applied: Fixed appBarTitle, appBarLeading, and additionalAppBarActions from VooPageConfig not being applied to the app bar
  • Added additionalActions parameter to VooMobileAppBar to support appending actions to the default actions
  • Actions are now properly merged instead of being ignored

Added #

• VooCollapseState: InheritedWidget for propagating collapse state to descendants
  • Enables auto-detection of compact mode for child widgets
  • VooCollapseState.isCollapsedOf(context) to read collapse state
  • VooCollapseState.toggleCallbackOf(context) to get toggle callback
• VooUserProfileConfig: Data-only config class for user profile
  • Simpler API for configuring user profile in navigation
  • Auto-handles compact mode based on VooCollapseState

Changed #

• Default Behavior: Made collapsible navigation and user profile the default
  • enableCollapsibleRail now defaults to true
  • showUserProfile now defaults to true
• VooUserProfileFooter: compact parameter now nullable (bool?)
  • When null, auto-detects from VooCollapseState in widget tree
• VooOrganizationSwitcher: compact parameter now nullable (bool?)
  • When null, auto-detects from VooCollapseState in widget tree
• Unified Theme: Default theme changed to clean flat design
  • Default theme is now minimalModern with containerBorderRadius: 0
  • navigationRailMargin defaults to 0 (flush to edge)

Added #

• Initial release - extracted from voo_navigation package

• Domain Entities: Core navigation configuration and data models

  • VooNavigationType - Navigation layout types (bottomNavigation, navigationRail, extendedNavigationRail, navigationDrawer)
  • VooNavigationItem - Navigation item with icons, labels, badges, routing
  • VooNavigationConfig - Master configuration for navigation system
  • VooBreakpoint - Responsive breakpoints with Material 3 defaults
  • VooNavigationTheme - Visual styling configuration (glassmorphism, liquidGlass, blurry, neomorphism, material3Enhanced, minimalModern)
  • VooNavigationRoute - GoRouter integration routes
  • VooNavigationSection - Hierarchical navigation grouping
  • VooPageConfig - Per-page scaffold customization

• Atoms: 20 foundational UI components

  • Badges: VooAnimatedBadge, VooModernBadge, VooDotBadge, VooTextBadge, VooIconWithBadge
  • Indicators: VooNavigationIndicator, VooThemedIndicator, VooLineIndicator, VooPillIndicator, VooGlowIndicator, VooCustomIndicator, VooBackgroundIndicator
  • Icons: VooNavigationIcon, VooAnimatedIcon, VooModernIcon
  • Labels: VooNavigationLabel
  • Surfaces: VooGlassSurface, VooLiquidGlassSurface, VooNeomorphSurface
  • Controls: VooCollapseToggle

• Molecules: 12 composite components

  • App Bar: VooMobileAppBar, VooAppBarLeading, VooAppBarTitle, VooAppBarActions
  • Themed: VooThemedNavItem, VooThemedNavContainer
  • Generic: VooNavigationBadge, VooNavigationItemWidget, VooDropdownHeader, VooDropdownChildren, VooDropdownChildItem
  • User Profile: VooUserProfileFooter

• Utils: Navigation helper utilities

  • VooNavigationAnimations - Animation presets and transitions
  • VooNavigationHelper - Static helper methods for navigation
  • VooNavigationInherited - InheritedWidget for config propagation