nash_ui 2.11.11

A modern, scalable Flutter Design System built with Material 3, providing design tokens, themes, responsive framework, animations, widgets, and templates.

Changelog

All notable changes to the nash_ui package will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

2.11.11 - 2026-09-06

Maintenance

• CI workflow enhancements and dependency cleanup.
• Refined test pipeline for stable cross-platform verification.

2.11.10 - 2026-09-06

Changed

• Removed discontinued golden_toolkit dev dependency — golden tests now use flutter_test only.
• Golden tests excluded from CI to avoid platform-specific pixel drift; run locally with flutter test test/golden_test.dart.

2.11.9 - 2026-09-06

Added

• Repository & Issue Tracker: Linked the official GitHub repository and issue tracker in package metadata (https://github.com/neshwantaha/nash_ui).
• License & Documentation: Updated README badges and documentation to reflect the official OSI-approved BSD 3-Clause license and verified full platform + WASM compatibility.

2.11.8 - 2026-09-05

Fixed

• Web Compilation: Fixed an issue where tear-off of external JS interop member setRequestHeader in network_web.dart caused compilation errors when running on Web / Edge / Chrome. Replaced tear-off with a closure.

2.11.7 - 2026-09-05

Added

• Full WebAssembly (WASM) Runtime Compatibility: Migrated web platform code to package:web and dart:js_interop, completely removing legacy dart:html imports. Implemented pure Dart stubs as default imports and configured conditional exports using dart.library.io and dart.library.js_interop. The package is now 100% compatible with Flutter WasmGC compilation, earning full platform & WASM points (20/20) on pub.dev.

2.11.6 - 2026-09-05

Added

• Full Web Platform Support: Enabled official Web platform compatibility across all services and feedback widgets by introducing platform-adaptive conditional imports/exports for AppNetwork and ConnectivityBanner (using HttpRequest instead of dart:io on Web). The package now officially supports all 6 platforms: Android, iOS, Web, Windows, macOS, and Linux.

Fixed

• Static Analysis & Linting: Resolved remaining deprecation warnings and cleaned up unused variables, achieving 0 issues across all package files.

2.11.5 - 2026-09-05

Changed

• License: Switched from MIT to BSD 3-Clause License — OSI-approved, requires attribution, and prevents use of the author's name to endorse or promote derived products without prior written permission.

2.11.4 - 2026-09-05

Changed

• License: Replaced custom Nash UI Free Use License with the standard MIT License to comply with OSI-approved license requirements on pub.dev.

2.11.3 - 2026-09-05

Fixed

• Deprecation Warnings: Suppressed deprecated axisAlignment usage in speed_dial.dart and banner.dart to maintain Flutter SDK >=3.27.0 compatibility (the replacement alignment property is unavailable in older SDK versions).
• Drag & Drop Compatibility: Suppressed deprecated onReorder usage in drag_drop_widgets.dart to maintain cross-version compatibility.

2.11.2 - 2026-09-04

Fixed

• Cross-Version PageTransitionsTheme: Updated PageTransitionsTheme in app_theme.dart and theme_builder.dart to maintain universal compatibility across all Flutter versions (including Flutter 3.47+), eliminating undefined builder references.
• Package Example: Included example/ directory in published package for full documentation and interactive demonstration on pub.dev.
• Code Formatting & Links: Formatted code with dart format and ensured all documentation links use secure https URLs.

2.11.1 - 2026-09-04

Fixed

• Static Analysis & Flutter Compatibility: Resolved PageTransitionsTheme builder compatibility for Flutter SDKs.
• Code Formatting: Applied dart format across all files to meet pub.dev static analysis standards.

2.11.0 - 2026-09-01

Added — 7 New Interactive, Media & UX Components

• MorphButton — Smooth morphing button that transitions from a text label to a circular progress loader and finally to a success (✓) or error (✗) checkmark.
• SpotlightHighlight — Screen highlight overlay with dark backdrop and circular cutout for guided onboarding tours and tutorials.
• ExpandableText — Truncated text widget with animated "Read more / Read less" expansion toggle and customizable styling.
• PinchableImage — Interactive pan-and-zoom image viewer with double-tap zoom, minimum/maximum scale bounds, and spring animation.
• AnimatedTabBar — Sleek animated tab bar with a sliding indicator pill and elastic motion.
• TagInput — Interactive chip/tag input field allowing users to add, remove, and validate custom tags.
• InlineAlert — Contextual inline notification banner with semantic styling (info, success, warning, error), custom actions, and dismiss button.
• AppRangeSlider — Dual-thumb range slider with floating value indicators and theme-aware track styling.
• PullToReveal — Pull-to-reveal container that unveils hidden top content (search bar, quick actions) when scrolling past the top edge.

2.10.0 - 2026-09-01

Fixed

• AppMasonry (True Masonry Engine) — Completely rewritten using a shortest-column greedy algorithm. Items now render at their natural variable heights without uniform cell constraints. Supports both children: [...] list and AppMasonry.builder(itemCount, itemBuilder) lazy loading, with adaptive width calculation.

Added — 8 New Creative & Modern Components

• ProgressRing — Apple Watch-style animated circular arc activity indicator with gradient fill and customizable center slot.
• SegmentedProgressBar — Instagram/Snapchat Stories-style multi-segment progress bar with active animations and auto-play support.
• FlipCard — 3D perspective rotation card with front and back faces, tap interaction, and horizontal/vertical flip axes.
• GlowBorderWidget — Smooth rotating gradient halo glow border with configurable blur, colors, and border radius.
• StepperInput — Modern numeric + / - stepper input with long-press repeat acceleration, min/max limits, and step control.
• SwipeableCards — Tinder-style interactive swipeable card stack with 3D fan depth, like/nope indicators, and swipe callbacks.
• AppToast — Lightweight sliding toast notification with semantic themes (success, info, warning, error) and auto-dismiss.
• AppContextMenu — Long-press / right-click contextual popover menu with haptic feedback and destructive action support.
• ParallaxListItem — Dynamic 3D depth parallax scroll background for list items and custom scroll views.
• ColorSwatchViewer — Interactive color palette grid with hex tooltips, one-tap clipboard copy, and selection states.

2.9.0 - 2026-09-01

Added

• AppMasonry — Self-balancing masonry (Pinterest-style) grid with fixed or adaptive columns.
• AppReactiveForm (ReactiveField + ReactiveFormController) — Fully reactive, observable form engine with per-field validity, automatic validation, and ValueNotifier-driven state (no manual setState).
• CI: publish dry-run job + golden failure artifacts — a new GitHub Actions publish job runs dart pub publish --dry-run, and the test job now uploads golden test/failures/ and test/goldens/ as artifacts when tests fail.

2.8.0 - 2026-08-29

Added — 18 Modern Creative, Data Viz, E-Commerce, Maps & Dev-Tools Components

• NeonButton — Eye-catching neon glow button with pulsing shadow bleed and smooth click animations.
• FloatingParticles — Ambient floating particles background generator with configurable density, colors, and velocities.
• GradientText — Animated moving gradient shader text with custom palettes and directions.
• TypingIndicator — Modern 3-dot bouncing "is typing..." chat bubble indicator.
• NumberPadDialog — Fullscreen-style numeric pin/amount dialog with formatted display and responsive keypad.
• ScratchReveal — Scratch-and-reveal canvas layer with customizable brush radius and completion threshold.
• CandlestickChart — Financial/stock OHLC candlestick chart with bullish/bearish wicks and date labels.
• BubbleChart — 3D data point comparison bubble scatter chart with customizable opacity and grids.
• TreeMapChart — Proportional hierarchical treemap chart with nested category rectangles.
• SparklineWidget — Compact inline mini trendline chart with smooth cubic bezier curves and area fills.
• ProductImageZoom — E-commerce image zoom widget with double-tap magnification and interactive pan/pinch.
• ReceiptCard — Paper-style receipt invoice with perforated dividers, line items, and totals summary.
• PriceTag — E-commerce price tag with strike-through original price, discount percentage badge, and currency formatting.
• InboxCard — Rich email/message inbox card with unread badge, avatar initials, and swipe-to-archive gestures.
• MentionField — Rich text input field with popup auto-complete suggestions for @mentions and #hashtags.
• ReactionPicker — Long-press social emoji reaction popup with bounce scaling animations.
• PollWidget — Interactive social poll widget with animated vote fraction bars and percentage calculations.
• LocationPinCard — Map & location preview card with address details, distance badge, and navigation actions.
• DeliveryTracker — Shipment & order progress timeline with active pulse node indicators.
• DistanceBar — Visual point-to-point journey progress bar with estimated time and vehicle icons.
• ThemeSwitcherFab — Rotating FloatingActionButton for instant Light/Dark/System theme toggling.
• JsonViewer — Interactive collapsible JSON tree viewer with syntax highlighting and one-tap copy.
• DebugOverlay — Diagnostics floating badge displaying live FPS and screen resolution stats.
• NetworkStatusBar — Animated banner indicating online and offline connection state changes.
• AppRatingDialog — Interactive 5-star in-app review & rating feedback dialog.
• UpdateRequiredScreen — Mandatory app update blocker screen with changelog notes and update CTA.
• PermissionRequestCard — Permission request card for camera, location, notifications, and media.
• GestureHintOverlay — Interactive touch gesture tutorial overlay illustrating swipe, pinch, and tap actions.

2.7.1 - 2026-08-29

Fixed

• OtpPinField — Rewrote layout to use LayoutBuilder + proportional scaling; eliminates the "RIGHT OVERFLOWED BY N PIXELS" error when length: 6 is used on narrow screens. Invisible TextField now wrapped in a bounded SizedBox so Stack always has finite constraints.
• LiquidProgressBar — Slider in the example was passing values in the 0–100 range (Nash Slider default) instead of 0.0–1.0; corrected min/max to 0.0/1.0 so the displayed percentage is now accurate.
• Example app — Fixed 8 analyzer errors across charts_advanced_page.dart, creative_cards_page.dart, security_auth_page.dart, and interactive_widgets_page.dart (wrong parameter names, ambiguous imports, missing required arguments).

2.7.0 - 2026-08-29

Added — 10 Next-Gen Creative, Media & Interactive Components

• VoiceNotePlayer — Modern voice note audio player with play/pause, seekable amplitude waveform, and 1x/1.5x/2x playback speed toggle.
• WheelOfFortune — Interactive spinning prize/fortune wheel with physics deceleration, custom slice colors, and completion callbacks.
• AnimatedTextKit — Versatile text animation suite supporting Typewriter, Fade, Scale, and character sequencing.
• GlassmorphicContainer — Premium frosted-glass container with BackdropFilter blur, luminous gradient border, and soft elevation shadows.
• FunnelChart — Sales and conversion pipeline chart visualizing sequential drop-off rates across stages.
• EqualizerWidget — Animated audio equalizer visualizer with frequency bands.
• BoardingPassCard — Realistic airline boarding pass & event ticket card with perforated divider, cutout notches, and barcode footer.
• MagnifierLens — Interactive touch-following magnifying glass lens for images and text inspection.
• AnimatedCounter — Smooth numeric counter animation with currency, decimal formatting, and ease-out curves.
• SecurityPinKeyboard — Secure on-screen PIN keypad with optional randomized/scrambled digit order and biometric key support.

2.6.1 - 2026-08-29

Fixed & Polish

• Test Suite & Lints: Cleaned all analyzer warnings across test suites and widget files.
• 100% Analyzer & Test Pass: Verified all 209 unit & widget tests pass with zero warnings.

2.6.0 - 2026-08-29

Added — 14 Modern Interactive, Visual & Media Components

• MiniMap — Interactive scrollable thumbnail overlay with draggable viewport indicator.
• CameraCapture — Simulated camera viewfinder UI with shutter animation, flash mode cycling, and front/rear camera switch.
• GradientPicker — Interactive multi-stop gradient color builder with stop add/remove and color palette presets.
• RadarChart — Multi-dimensional spider/radar chart with smooth animations, grid polygons, and legend.
• PushNotificationCard — Rich notification card with unread indicator, action buttons, avatar, and swipe-to-dismiss.
• ParallaxCard — 3D parallax depth card with smooth gesture and pointer tracking.
• ChatBubble — Modern chat bubble supporting read receipts, animated entry, replies, and emoji reactions.
• OnboardingOverlay — Interactive spotlight tutorial overlay that highlights target widgets with step-by-step tooltips.
• TimelinePicker — Horizontal scrollable date picker timeline with today/selected styling.
• BiometricButton — Animated biometric authentication button with idle pulse, scanning progress, and success/failure transitions.
• BottomSheetDraggable — Multi-snap draggable bottom sheet with configurable height stops.
• LiquidProgressBar — Animated wave liquid progress bar using CustomPainter with percentage display.
• DraggableDashboard — Interactive drag-and-drop reorderable grid dashboard.

2.5.0 - 2026-08-29

Added — Interactive, Media, Security & QR Components

• BeforeAfterImage — Interactive split-slider for comparing before/after images side-by-side with drag gesture support.
• ImageViewer — Full-screen zoomable & pannable image overlay with swipe-to-dismiss and hero animation.
• CornerRibbon — Diagonal corner banner (top-left/top-right/bottom-left/bottom-right) for cards with fully customisable color and label.
• CreditCardWidget — Realistic 3D-flippable credit/debit card with automatic brand detection (Visa, Mastercard, Amex, Mada) and gradient backgrounds.
• PatternLock — 9-dot security gesture lock screen with custom path drawing, error state, and completion callback.
• OtpPinField — Modern OTP/PIN verification field with auto-advance, paste support, custom styling, error state, and SMS autofill-ready design.
• ConfettiWidget — Pure Flutter celebration particle-burst overlay with configurable particle count, color palette, duration, and trigger controller.
• ScratchCard — Interactive scratch-to-reveal surface using CustomPainter with configurable reveal threshold and completion callback.
• AudioWaveform — Audio visualiser with animated wave bars, playhead tracking, seek-on-tap, and playback state indication.
• QrCodeWidget — Pure-Flutter QR code generator with customisable size, foreground/background color, and error-correction level.
• BarcodeWidget — Pure-Flutter 1D barcode generator (Code 128 algorithm) with optional label and size control.

2.4.2 - 2026-08-29

Documentation

• Clean API & README: Updated the entire README.md on pub.dev to remove legacy Nash class prefixes (AppTheme, CustomAppBar, AppTextField, AppCard, AppSnackbar, AppDropdown, etc.) and document all newly added 2.4.0 components (SignaturePad, Watermark, SpeedDial, SwipeActionCard, CountDownTimer, StickyHeaderList, Accordion, SyntaxHighlighter, MarkdownText).

2.4.1 - 2026-08-29

Fixed & Improved

• Code Quality & Lints: Cleaned up all analyzer warnings and inference types across all components.
• SpeedDial Interactions: Enhanced SpeedDial so that tapping either the action button or the action label executes the callback seamlessly.
• Clean Namespace: Dedicated SyntaxHighlighter component in rich_text without conflicting with standard CodeBlock.

2.4.0 - 2026-08-29

Added

• SignaturePad: Free-hand signature drawing canvas with clear(), toImage(), and toImageBytes() export.
• Watermark: Diagonal tiled text overlay with configurable angle, spacing, opacity, and enabled toggle.
• SpeedDial (FabMenu): Animated expandable FAB with labeled SpeedDialItem actions and smooth open/close transitions.
• SwipeActionCard: Swipeable card revealing configurable left/right SwipeAction buttons (icon + label + color).
• CountDownTimer & StopWatch: Timer widgets with start(), pause(), reset() controls and hms/ms/s format options.
• StickyHeaderList: Grouped list with floating sticky section headers.
• Accordion: Animated expandable panels with single- or multi-open modes.
• SyntaxHighlighter: Built-in code block with language-aware token coloring (Dart, Python, JS/TS, HTML, CSS, YAML, JSON) and line numbers.
• MarkdownText: Lightweight Markdown renderer (headings, bold, italic, inline code, lists, blockquotes, hr) — no external dependency.
• Debouncer & Throttler: Utility classes re-exported from utils/debouncer.dart.

2.3.0 - 2026-08-28

Added

• Gap Widget: Smart, adaptive gap spacing component with auto-detection of parent Flex axis (Row or Column), plus Gap.expand(), Gap.vertical(), and Gap.horizontal().
• Advanced Charts Suite:
  • HeatMap: GitHub-style daily activity and contribution heatmap with customizable intensity levels, date ranges, and tooltips.
  • GanttChart: Project roadmap and timeline chart with task progress visualization and interaction support.
• Extensions Expansion:
  • NumX, IntX, DoubleX: Duration helpers (.seconds, .minutes, .hours, .days, .ms), .between(), .clampTo(), .generate(), .times().
  • IterableX, ListX: .chunked(), .sumBy(), .separated(), .firstWhereOrNull(), .distinctBy(), .whereNotNull.
  • StringX: .toTitleCase(), .toSlug(), .toDate(), .ellipsize().
  • BuildContextX: .showInfoSnack(), .popToRoot(), .arguments<T>().
• AppNetwork Service: Complete HTTP client with get, post, put, patch, delete, JSON parsing, base URL, auth token headers, and interceptors.
• AppPermissions & AppBiometrics & AppNotifications: Standardized device and system services.
• AppPalette.fromSeed(): Dynamic MaterialColor palette generation from any brand seed color.
• CupertinoIcons Re-export: Complete access to both Material and Cupertino icons directly from import 'package:nash_ui/nash_ui.dart';.

2.2.3 - 2026-08-21

Fixed & Improved

• Dependency Constraint Bounds (pana score fix): Tightened lower-bound constraints for google_fonts (^8.1.0) and intl (^0.20.3) to ensure full compatibility with pub downgrade analysis.
• Cleaned Documentation: Standardized all backwards-compatible typedef doc comments across all 34 widget files.

2.2.2 - 2026-08-19

Changed & Refactored — Pure Zero-Prefix Class Definitions

• All class declarations in lib/ are now natively un-prefixed: Renamed all 51 class declarations across 34 files (e.g. class Card, class TextField, class AppBar, class Dialog, class ListTile, class TabBar, class Draggable, class PopupMenuItem, etc.) directly without prefix.
• Direct DataCell Support Everywhere: DataTable now natively accepts standard Flutter DataCell(Widget child, ...) or raw Widgets for all cells without requiring NashDataCell.
• Full Backward Compatibility: Kept typedef NashX = X; aliases so existing code continues to work seamlessly without breaking changes.
• Chart Disambiguation: Resolved chart export collisions and added LineChart.fromData() convenience factory constructor.
• Zero Analysis Issues: Cleaned all analyzer warnings and achieved 100% pass across all 165+ automated tests.

2.2.1 - 2026-08-19

Added & Refined

• Complete Zero-Prefix Coverage: Added no-prefix aliases for DataTable, DataColumn, DataRow, PopupMenuItem, DraggableList, and Draggable.
• Full Example App Refactor: Refactored all 21 showcase pages in the example/ app to use the clean zero-prefix API across the board.
• DataCell Compatibility: Un-hid and preserved standard Flutter DataCell compatibility across tables.

2.2.0 - 2026-08-19

Added — Zero-Prefix API 🎉

• No more Nash prefix required! All components now available with clean Flutter-compatible names via a single import: import 'package:nash_ui/nash_ui.dart';
  • Card(...) instead of NashCard(...)
  • TextField(...) instead of NashTextField(...) — supports decoration: InputDecoration(...) override
  • AppBar(...) instead of NashAppBar(...)
  • Dialog(...) instead of NashDialog(...)
  • ListTile(...) instead of NashListTile(...)
  • ExpansionTile(...) instead of NashExpansionTile(...)
  • TabBar(...), Tab(...), TabView(...) without prefix
  • NavigationRail(...) without prefix
  • Form(...), FormTextField(...) without prefix
  • Chip(...), Checkbox(...), Radio(...), Switch(...) without prefix
  • Slider(...), RangeSlider(...) without prefix
  • Badge(...), Stepper(...), Tooltip(...), Banner(...), BottomSheet(...) without prefix
  • TextButton(...), IconButton(...) without prefix
  • FontConfig(...), DirectionText(...) without prefix
• 100% backwards compatible: All NashXxx names still work — zero breaking changes.
• Theme.of(context): Nash Theme class now supports Theme.of(context) just like Flutter's Theme, so existing code continues to work unmodified.
• TextField decoration parameter: NashTextField / TextField now accepts an explicit InputDecoration? decoration override for full Flutter-style compatibility.

2.1.1 - 2026-08-19

Maintenance & Quality

• Code Health & Strict Lint Cleanup: Cleaned up all analyzer hints and test suite parameters across the typography and font configuration tests.
• 100% Test Coverage: Full suite of 165+ automated tests passing with 0 analyzer issues.

2.1.0 - 2026-08-19

Added

• NashFontConfig System: Added a flexible, production-grade font configuration system supporting separate fonts for LTR and RTL text directions.
  • NashFontConfig.google(ltr: 'Inter', rtl: 'Cairo') — Dual Google Fonts for English and Arabic.
  • NashFontConfig.asset(ltr: 'MyFont', rtl: 'MyArabicFont') — Local asset fonts with zero external dependencies.
  • NashFontConfig.mixed(ltrGoogle: 'Inter', rtlAsset: 'Cairo') — Mixed Google Fonts + local assets.
  • NashFontConfig.system() — Pure platform default font fallback.
• NashDirectionText: Added a direction-aware Text widget that automatically selects and applies the appropriate font based on the active Directionality (LTR vs RTL).
• Theme Integration: Theme.light(), Theme.dark(), Theme.amoled(), Theme.custom(), and ThemeBuilder.fromSeed() now accept fontConfig and direction parameters.

2.0.6 - 2026-08-19

Removed

• uuid dependency: Removed entirely — it was never used in the codebase.
• cached_network_image dependency: Replaced with Flutter's built-in Image.network using loadingBuilder and errorBuilder. Flutter's own ImageCache (PaintingBinding.instance.imageCache) provides caching out of the box — no external library needed.

Changed

• NashNetworkImage: Now uses Image.network with loadingBuilder (placeholder icon) and errorBuilder (broken image icon). API is 100% backwards-compatible.
• NashImageCached: Now uses Image.network with AnimatedOpacity fade-in on load. Same API as before.

2.0.5 - 2026-08-19

Fixed

• Horizontal Stepper Overflow: Rebuilt the horizontal NashStepper layout using _HorizontalStepItem with Expanded slots. Step circles are now centered with connector lines on each side, and step labels sit below the circle with TextOverflow.ellipsis, eliminating the 45px overflow on constrained screens.
• _StepCircle onTap refactor: Converted the onTap getter into a proper constructor parameter so tappable steps work correctly in both horizontal and vertical layouts.

2.0.4 - 2026-08-19

Enhanced

• 100% Example App Migration: Migrated every single file and showcase in the example/ app to purely use import 'package:nash_ui/nash_ui.dart'; with zero direct Flutter imports needed.
• Enhanced AnimatedContainer & Dialog Compatibility: AnimatedContainer now supports decoration directly, and showDialog supports builder: (context) => ... alongside child for drop-in Flutter replacement compatibility.

2.0.3 - 2026-08-19

Cleaned & Optimized

• Clean Imports & Strict Analyzer Compliance: Removed all redundant flutter/material.dart and dart:typed_data imports across example pages and test suites now that nash_ui.dart provides full zero-config re-exports.
• Zero Analyzer Warnings: Achieved clean 100% pass across all lint, analyzer, and dry-run validation checks.

2.0.2 - 2026-08-19

Improved

• Zero-Config Single Import: nash_ui.dart now re-exports package:flutter/material.dart and package:flutter/services.dart with conflicting symbols resolved automatically. Consumers only need import 'package:nash_ui/nash_ui.dart'; to access all Flutter widgets, icons (Icons.* and AppIcons.*), and Nash design system components seamlessly.

2.0.1 - 2026-08-19

Bug Fixes

• NashStepper: Fixed layout crash caused by Expanded inside a nested Row in horizontal mode. Removed Flexible/Expanded from _StepItem label widget.
• NashStepper: Removed redundant Expanded wrapper on _StepConnector in horizontal layout.
• ZIndexed: Fixed Stack size assertion failure by replacing Stack + Positioned.fill + IndexedStack with a direct IndexedStack.

2.0.0 - 2026-08-19

BREAKING CHANGES — Class Renames

Removed the Nash prefix from all classes that do not conflict with Flutter built-in widgets. Classes that do conflict with Flutter (e.g., Card, TextField, Row) retain the Nash prefix.

Renamed (Nash prefix removed):

• NashTheme → Theme
• NashToast → Toast
• NashRating → Rating
• NashTag → Tag
• NashCarousel → Carousel
• NashNotificationCenter → NotificationCenter
• NashNotification → Notification
• NashNotificationType → NotificationType
• NashErrorBoundary → ErrorBoundary
• NashReducedMotion → ReducedMotion
• NashReducedMotionWrapper → ReducedMotionWrapper
• NashZIndexed → ZIndexed
• NashResponsiveTypography → ResponsiveTypography
• NashTokenExporter → TokenExporter
• NashCommandPalette → CommandPalette
• NashCommandItem → CommandItem
• NashPopover → Popover
• NashPopoverTriggerMode → PopoverTriggerMode
• NashDraggableSheet / showNashDraggableSheet → DraggableSheet / showDraggableSheet
• NashPopupMenu → PopupMenu
• NashCodeBlock → CodeBlock
• NashTreeView → TreeView
• NashTreeNode → TreeNode
• NashPagination → Pagination
• NashSplitView → SplitView
• NashCalendar → Calendar
• NashTimeline → Timeline
• NashTimelineItem → TimelineItem
• NashInfiniteList → InfiniteList
• NashResponsiveGrid → ResponsiveGrid
• NashLiveSearch → LiveSearch
• NashCopyButton → CopyButton
• NashShareSheet → ShareSheet
• NashFormWizard → FormWizard
• NashWizardStep → WizardStep
• NashDropdown → Dropdown
• NashDropdownItem → DropdownItem
• NashColorPicker → ColorPicker
• NashFileUpload → FileUpload
• NashUploadedFile → UploadedFile
• NashHorizontalDatePicker → HorizontalDatePicker
• NashWheelDatePicker → WheelDatePicker
• showNashStyledTimePicker → showStyledTimePicker
• showNashDateRangeDialog → showDateRangeDialog
• showNashDurationPicker → showDurationPicker
• showNashTimeRangePicker → showTimeRangePicker
• showNashDateRangePicker → showDateRangePicker
• NashStepState → StepState
• NashEnhancedDataTable → EnhancedDataTable
• NashAdaptiveScaffold → AdaptiveScaffold
• NashAdaptiveDialog → AdaptiveDialog
• NashAdaptiveActionSheet → AdaptiveActionSheet
• NashAdaptiveSwitch → AdaptiveSwitch
• NashAdaptiveProgress → AdaptiveProgress
• NashPlatform → Platform
• NashOnboardingScreen → OnboardingScreen
• NashOnboardingPage → OnboardingPage
• NashSplashScreen → SplashScreen
• NashProfileSetupScreen → ProfileSetupScreen
• NashTestUtils → TestUtils
• NashWidgetTesterX → WidgetTesterX
• NashRtlHelper → RtlHelper
• NashDirectionalRow → DirectionalRow
• NashThemeBuilder → ThemeBuilder
• NashConnectivityBanner → ConnectivityBanner
• NashRefreshList → RefreshList
• NashGlassButton → GlassButton
• NashGradientBorderButton → GradientBorderButton
• NashSlideButton → SlideButton
• NashSplitButton → SplitButton
• NashSplitAction → SplitAction
• NashHoldButton → HoldButton
• NashSocialButton → SocialButton
• NashButtonGroup → ButtonGroup
• NashGroupItem → GroupItem
• NashFocusRing → FocusRing
• NashTouchTarget → TouchTarget
• NashAccessibilityProvider → AccessibilityProvider
• NashSemanticsAnnouncer → SemanticsAnnouncer
• NashAccessibleButton → AccessibleButton
• NashRichTextEditor → RichTextEditor
• NashLoader → Loader
• NashShimmer / NashShimmerBox / NashShimmerCard / NashShimmerList / NashShimmerBanner → Shimmer / ShimmerBox / ShimmerCard / ShimmerList / ShimmerBanner
• NashTablePagination → TablePagination
• NashAvatar → Avatar
• showNashCommandPalette → showCommandPalette
• NashForm → NashForm (kept — conflicts with Flutter's Form)

Kept with Nash prefix (Flutter conflicts): NashCard, NashRow, NashColumn, NashContainer, NashPadding, NashCenter, NashStack, NashWrap, NashDivider, NashListView, NashTextField, NashTextButton, NashIconButton, NashAppBar, NashDialog, NashBottomSheet, NashPopupMenuItem, NashTooltip, NashBadge, NashBanner, NashForm, NashFormTextField, NashListTile, NashDataTable, NashDataCell, NashDataColumn, NashDataRow, NashExpansionTile, NashTabBar, NashTab, NashTabView, NashNavigationRail, NashImage, NashNetworkImage, NashDraggable, NashDraggableList, NashStepper, NashScrollBehavior, NashThemeExtension, NashLocalizations, NashLocalizationsDelegate, NashSlider, NashRangeSlider, NashCheckbox, NashRadio, NashSwitch, NashChip, NashSegmentedButton, NashMargin

1.4.0 - 2026-08-19

Added

• Accessibility System:
  • AppAccessibility — WCAG AA/AAA compliance tokens: touch targets, focus ring, contrast ratios, text scaling, reduced motion duration.
  • NashFocusRing — Themed focus ring wrapper with animated border on focus.
  • NashTouchTarget — Enforces minimum 48dp touch target on any child.
  • NashAccessibilityProvider — Respects system accessibleNavigation and disableAnimations.
  • NashSemanticsAnnouncer — Live-region semantics wrapper for screen reader announcements.
  • NashAccessibleButton — Icon-only button with semantic label and touch target.
• Drag & Drop:
  • NashDraggableList<T> — Reorderable list with drag handle, animations, callbacks.
  • NashDropZone — Drop target with visual feedback and onAccept/onWillAccept.
  • NashDraggable — Wraps any widget to make it draggable with LongPressDraggable.
• Rich Text Editor:
  • NashRichTextEditor — Lightweight rich text editor with formatting toolbar (bold, italic, underline, strikethrough, lists, alignment, links).
• In-App Notifications:
  • NashNotificationCenter — Overlay notification center with queue management.
  • NashNotification — Notification data model with semantic types (info, success, warning, error).
  • NashNotificationX — BuildContext extension for quick notification display.
• Date/Time/Duration Pickers:
  • showNashStyledTimePicker — Themed time picker following the design system.
  • showNashDateRangeDialog — Styled date range picker dialog.
  • showNashDurationPicker — Duration picker with hours, minutes, seconds.
  • showNashTimeRangePicker — Time range picker with start/end time selection.
• Enhanced Stepper:
  • NashStepper — Horizontal and vertical stepper with step validation, subtitles, icons, custom controls, and per-step content.
  • NashStepState — Step state enum (inactive, active, complete, error).
• Enhanced DataTable:
  • NashEnhancedDataTable — Feature-rich data table with sorting, row selection, pagination, CSV export, loading state, and empty state.
  • NashDataColumn, NashDataRow — Column and row definition models.
  • NashTablePagination — Pagination model and widget.
• Platform-Adaptive Widgets:
  • NashAdaptiveScaffold — Responsive scaffold with mobile/tablet/desktop builders.
  • NashAdaptiveDialog — Cupertino-style confirm dialog on iOS/macOS, Material elsewhere.
  • NashAdaptiveActionSheet — iOS-style action sheet on Apple platforms, bottom sheet elsewhere.
  • NashAdaptiveSwitch, NashAdaptiveProgress — Platform-adaptive switch and progress indicator.
  • NashPlatform — Platform detection helpers.
• Responsive Typography:
  • NashResponsiveTypography — Scales text styles based on screen width with min/max clamping.
• Localization:
  • NashLocalizations — Number, currency, date, time, and compact formatting.
  • NashLocalizationsX — BuildContext extension for easy access.
• Testing Utilities:
  • NashTestUtils — Widget finding helpers, pump utilities, mock data generators.
  • NashWidgetTesterX — Extension on WidgetTester for common test operations.
• Token Documentation Generator:
  • NashTokenExporter — Exports all design tokens to Markdown or JSON format.
• Reduced Motion:
  • NashReducedMotion — Checks system reduced motion preference.
  • NashReducedMotionWrapper — Wraps child to skip animations when reduced motion is active.
• Image Placeholder/Error Tokens:
  • AppImageTokens — Placeholder color, icon, border radius, error widget, and loading widget tokens.
• Z-Index/Elevation Tokens:
  • AppElevation — Material 3 elevation values (none through extraHigh) + custom levels.
  • NashZIndexed — Widget wrapper for custom z-index stacking.

Improved & Fixed

• Accessibility: All existing widgets now respect AppAccessibility touch targets and focus ring styles.
• Stepper: Replaced simple _StepCircle/_StepConnector with full NashStepper supporting horizontal/vertical layouts, step validation, subtitles, and custom controls.
• Responsive Typography: Added export in typography/typography.dart barrel file.
• Code Quality: Fixed all linter warnings — expression function bodies, deprecated activeColor on Switch, unnecessary imports, redundant arguments, cascade invocations, and BuildContext.mounted checks.
• Example App: Added 5 new showcase pages (Accessibility, Drag & Drop, Pickers, Stepper, New Features) with interactive demos of all new components.

1.3.0 - 2026-08-18

Added

• Date Picker Suite:
  • NashHorizontalDatePicker — Modern horizontal date timeline/strip with day pills, today jump button, marked dates, and custom ranges.
  • NashWheelDatePicker — iOS Cupertino-style scroll wheel picker with smooth physics and light/dark theme support.
  • showNashDatePicker — Rich modal bottom sheet calendar picker with quick apply/cancel actions and drag handle.
  • showNashDateRangePicker — Date range picker modal with quick preset chips (Today, Yesterday, Last 7 Days, Last 30 Days, This Month).
  • DateField enhancement with DateFieldPickerStyle (nash, wheel, platform).
• Modern Button Styles:
  • NashGlassButton — Frosted glassmorphism button with customizable BackdropFilter blur, specular border highlight, and dark/light tint.
  • NashGradientBorderButton — Glowing button with a multi-stop gradient border, interior background, and shader-masked icons.
  • NashSlideButton — Interactive drag-to-confirm / slide-to-act button with progress fill, loading indicator, spring animation, and auto-reset.
  • NashSplitButton — Combined primary action button with a dropdown action menu for multi-action workflows.
  • NashHoldButton — Safety button requiring press-and-hold with dynamic percentage fill to prevent accidental destructive actions.
  • NashSocialButton — Pre-branded authentication buttons for Google, Apple, GitHub, Microsoft, X, Facebook, and Discord.
  • NashButtonGroup — Connected segmented action button group with unified outer border and active selection transitions.

Improved & Fixed

• Button Sizing Consistency: Fixed PrimaryButton and OutlineButton padding and minimum width constraints (minWidth: 96, horizontal: 24) so buttons with short labels maintain proper visual weight and match surrounding controls.
• NashFormWizard: Updated footer buttons with uniform width for symmetrical Cancel/Back and Next/Submit layout.
• Example App: Replaced NavigationRail with a custom scrollable sidebar to eliminate overflow on compact viewports, and added showcases for all new features.

1.2.0 - 2026-08-18

Added

• NashForm & NashValidators — Smart form management with auto-validation, submit state handling, and a comprehensive validation suite (email, phone, password, required, minLength, maxLength, url, numeric, match, compose).
• NashToast — Standalone overlay toast notification system independent of Scaffold, with queue management, automatic dismissal, and semantic types (success, error, warning, info, neutral).
• NashShimmer — Animated shimmer loading effect with pre-built skeleton presets (NashShimmerBox, NashShimmerCard, NashShimmerList, NashShimmerBanner).
• NashConnectivityBanner — Zero-dependency auto-detecting offline/online banner that shows and hides based on network connectivity.
• Pure-Flutter Chart Suite — Dependency-free charting components including NashLineChart, NashBarChart, NashPieChart, NashSparkline, and NashAreaChart.
• NashInfiniteList & NashRefreshList — Paginated scrolling lists with built-in threshold triggers, loading shimmer placeholders, and pull-to-refresh integration.
• NashResponsiveGrid — Adaptive multi-column grid with breakpoint-driven column counts for mobile, tablet, desktop, and wide desktop screens.
• NashErrorBoundary — Widget-level crash protection that captures rendering exceptions and displays styled debug or production fallback UI.
• NashLiveSearch — Search input with configurable debounce delay, async search execution, and floating dropdown results overlay.
• NashCopyButton & NashShareSheet — Interactive copy-to-clipboard button with checkmark animation and bottom modal share action sheet.
• Onboarding & Auth Templates — NashOnboardingScreen (multi-page swipeable walkthrough), NashSplashScreen (animated logo reveal), and NashProfileSetupScreen (step-by-step setup wizard).
• RTL & Internationalization — NashRtlHelper and NashDirectionalRow for automated right-to-left layout adaptation and logical directional utilities.
• NashThemeBuilder — Dynamic Material 3 ThemeData generator from a single seed color with font, radius, and density customization.

1.1.0 - 2026-08-15

Added

• NashCommandPalette — Spotlight-style Ctrl+K command palette with fuzzy search, keyboard navigation, categories, shortcuts, and badges.
• NashCarousel — Swipeable banner carousel with auto-play, customizable indicator dots, navigation arrows, and viewport scaling.
• NashFileUpload — Drag-and-drop file dropzone with upload progress bars, file size display, and multi-file management.
• NashPopover — Anchor-aware floating popover with directional placement, click and hover trigger modes.
• NashPagination — Page navigation widget with numbered pages, ellipsis for large ranges, and prev/next controls.
• NashTreeView — Hierarchical tree explorer with expandable nodes, custom icons, trailing widgets, and indentation guides.
• NashCodeBlock — Syntax-styled code viewer with language label, line numbers, and one-click copy-to-clipboard.
• NashSlider / NashRangeSlider — Branded single-thumb and dual-thumb range sliders with tooltips, min/max labels, and prefix/suffix support.
• NashFormWizard — Multi-step form wizard with animated step transitions, step-level validation, and completion callback.
• NashColorPicker — Color palette selector with 20-swatch grid, hex input field, and opacity control.
• NashSplitView — Resizable horizontal/vertical split-panel layout with a draggable divider and configurable min sizes.
• NashDraggableSheet / showNashDraggableSheet — Snap-enabled draggable bottom sheet with custom snap stop ratios.
• Enhanced NashDataTable — Added column sorting (onSort, sortColumnIndex, sortAscending) and row selection (showCheckboxes, selectedIndices, onRowSelected).

1.0.4 - 2026-08-15

Fixed

• GlassCard & GlowCard: Fixed light-mode gradient and border contrast so glassmorphism cards remain visible on light surfaces without disappearing.
• Snackbars: Fixed global theme override that caused all snackbars to display in the same color; each severity type (success, error, warning, info) now displays its correct distinct semantic color.
• FloatingButton: Fixed icon visibility by removing the faulty shader mask that was painting the icon in the same color as the background; added support for extended FABs.
• OtpField: Fixed digit clipping and vertical alignment caused by theme content-padding; improved single-digit input, backspace navigation, and paste handling.
• EmptyState & OfflineState: Fixed bottom overflow issues in constrained containers and unbounded scrolling layouts.

1.0.3 - 2026-08-15

Changed

• Standardized and cleaned all remaining internal and public API identifiers by removing all legacy N prefixes (NashCheckbox, NashRadio, NashSwitch, EmptyState, ErrorState, OfflineState, SuccessState, LoginTemplate, SettingsGroup, UserCard, NashDataCell, etc.).

1.0.2 - 2026-08-15

Changed

• Updated licensing model to Nash UI Free Use License (NU-FUL) v1.0: free to use as a Flutter dependency in any application (personal, commercial, enterprise); proprietary source code — modifying, forking, or redistribution of the library itself is prohibited.
• Updated README.md badge and License section to reflect the new NU-FUL license.

1.0.1 - 2026-08-14

Added

• Added GlassCard and GlowCard widgets with backdrop blur and ambient aura shadows.
• Added vibrant gradient presets (cyberpunk, ocean, emerald, glass).
• Added vibrant accent color tokens (violet, emerald, rose, amber, cyan, pink) to AppColors.
• Added styled snackbar helpers (showSuccessSnack, showErrorSnack, etc.) to BuildContext.
• Added dedicated AnimationsPage showcase in the example application.

Changed

• Standardized class naming across the design system to clean, collision-free identifiers (NashTheme, AppColors, PrimaryButton, NashCard, Skeleton, Shimmer).
• Updated licensing model to Nash UI Free Use License (NU-FUL) v1.0 (free for personal, commercial, and enterprise application development; proprietary source code).

Fixed

• Resolved all static analysis issues and enabled full 6-platform support.

1.0.0 - 2026-08-13

Published

• Official publication on pub.dev.

Added

• Design tokens: colors, typography, spacing, radius, shadows, gradients, borders, opacity, dimensions, icons, durations, curves.
• Theme engine with NashTheme.light(), NashTheme.dark(), NashTheme.amoled() and full custom theme support via a ThemeExtension.
• Responsive framework (AppResponsive, screen types, breakpoints) and responsive number extensions (10.w, 20.h, 16.r, 5.v).
• Animation library: fade, slide, scale, rotate, bounce, shake, ripple, hover, hero, page transitions and shared-axis transitions.
• Widget catalog: buttons, inputs, cards, selection, media, feedback, lists, indicators and misc widgets.
• Navigation widgets: bottom navigation, navigation rail, sidebar, drawer, top navigation and breadcrumb.
• Dialogs: alert, confirm, success, error, warning and bottom sheet.
• Charts: line, bar, pie and donut charts.
• Loading, skeleton, shimmer and form helpers.
• UX screens: loading, empty state, no internet, 404, error, success, maintenance, permission and update required.
• Full UI templates: login, register, forgot password, dashboard, settings, profile, chat, learning, finance, medical, e-commerce, social, admin and analytics.
• Utilities: validators, formatters, date/color/number utilities, animation/file/image/permission/device utilities.
• Complete example application showcasing every component.
• Unit, widget and golden tests plus a CI/CD GitHub Actions workflow.