vvk_ui_kit 1.1.0

A Flutter UI kit with Material 3 theming, reusable widgets, utilities, shimmer loading, SVG icons, and light/dark theme support.

1.1.0

• Theming ergonomics — new UIAppTheme.fromSeed(Color) and UIThemePalette.fromSeed(Color, {brightness}) generate a full semantic palette from a single seed color via Material 3's ColorScheme.fromSeed. Added high-contrast accessibility presets: UIThemePalette.highContrastLight / highContrastDark and UIAppTheme.highContrast(Brightness).
• Design tokens — new UIButtonMetrics / UIInputMetrics (aliases of UIButtonTheme / UIInputTheme) and a new UIGlassMetrics theme extension. UIStyledButtonStyle.primary/outlined/elevated/text and UIGlassSurface now resolve heights, radii, blur, and opacity from the theme when the matching parameter is left unset (defaults unchanged, so this is backwards compatible).
• Glass performance — UIGlassPerformanceMode (fullBlur / staticTint / auto) lets you swap the live BackdropFilter blur for a cheap static tint on low-end devices; UIGlassSurface optionally wraps its blur in a RepaintBoundary.
• Accessibility — added semanticsLabel / semanticsHint (and tooltips where relevant) to UIStyledButton, UIIconButton, UISplitButton, and a custom semanticsLabel on UIRatingBar; UILoadingOverlay and UISnackbar now expose live-region semantics. New shared UISemanticsProps.
• Adaptive Cupertino — UIPillSwitch gains adaptive / forceCupertino / forceMaterial to render a native CupertinoSwitch on Apple platforms.
• Theme-first APIs — added UISnackbarStyle.fromTheme(context).
• i18n — replaced hardcoded English strings in several widgets with overridable parameters (defaults unchanged, so behavior is backwards compatible):
  • UIHierarchySearchableDropdown — searchHintText ('Search here...') and clearSearchTooltip ('Clear search'); the clear button now has a tooltip.
  • UISearchBar — clearTooltip, ascendingTooltip, descendingTooltip, filterTooltip; the clear button now has a tooltip.
  • UIKeyboardToolbar — previousLabel and nextLabel.
  • UITourProgressIndicator — labelBuilder and compactLabelBuilder for the step text.
  • UIDropdown — requiredMarker (' *') and showRequiredMarker.
• a11y — added tooltips / semantic labels to icon buttons that previously had none, so they are now announced by screen readers and show hover/long-press hints:
  • Back buttons in UIAppBar (new backTooltip), UISettingsPageScaffold (backTooltip), and UITabbedDetailScaffold (backTooltip) — when the param is null they fall back to the locale-aware MaterialLocalizations.backButtonTooltip.
  • UICalendar month arrows — previousMonthTooltip / nextMonthTooltip (fall back to the matching MaterialLocalizations values).
  • UIPopover close button — closeButtonTooltip (falls back to MaterialLocalizations.closeButtonTooltip).
  • UIDetailDateNavigator — previousTooltip / nextTooltip.
  • UINumberField — decrementTooltip / incrementTooltip.
  • UIExpandableFloatingPanel & UITreeView — expandTooltip / collapseTooltip.
  • UITextFormField — showPasswordTooltip / hidePasswordTooltip on the password visibility toggle.
  • UITourTooltipCard skip and previous buttons now expose tooltips from UITourStep.skipButtonLabel / previousButtonLabel.
• Fixes — UIIconButton now inherits its color from the ambient IconTheme (was hardcoded to Colors.black, breaking dark mode) and is genuinely disabled when onPressed is null (previously always tappable). DateTimeUtil.getFormattedDate and getFormatDayMonthYearHourMinSec now log parse/format failures in debug instead of silently swallowing them.
• pub.dev metadata — declared supported platforms (android, ios, web, macos, windows, linux) and added screenshots for visual previews.
• Tooling — tightened the flutter SDK constraint to >=3.32.0 to match the required Dart SDK and modern APIs (Color.withValues, CardThemeData). Enabled the prefer_relative_imports lint and normalized all intra-package imports under lib/src to relative paths. Raised public_member_api_docs from info to warning so missing public docs fail analysis. CI now runs dart pub publish --dry-run; added a compile-time export guard (test/exports_test.dart) and accessibility tests. Migrated legacy MediaQuery.of(context).size usages to MediaQuery.sizeOf(context) in UIDivider, UITitleWithBorderedLine, UILabeledTextFormField, and widget helpers.
• Maintenance — decomposed the 1,830-line ui_hierarchy_searchable_dropdown.dart into focused part files (header / panel / tree) with no public API change.

1.0.0

• Stable release — first production-ready version of vvk_ui_kit with a complete public API exported from package:vvk_ui_kit/vvk_ui_kit.dart.
• Widget test suite — 301 tests across 30 test files covering the full component library:
  • Core — extensions, theme tokens, NavigationUtil, DialogUtil, JsonUtils, Translations, and widget helpers.
  • Buttons — UIStyledButton, split/glass/slider/social auth, and all button variants.
  • Accordion, cards & clips — expansion accordions, UICard, UIAnimatedFlipCard, ticket/coupon clips, hexagon, and sharp corners.
  • Carousel & decoration — carousels with indicators, gradient widgets, dotted borders, corner ribbons, and glass surfaces.
  • Display & rating — stat cards, banners, command bar, progress bars, animated counter, text avatar, stack badge, timer builder, and rating bars.
  • Dialogs — adaptive alert/action sheets, shell dialogs, Cupertino sheets, image picker, and bottom sheets.
  • Feedback — snackbars, badges, empty states, tooltips, popover, skeleton placeholders, and product tour (UITourController, spotlight overlay).
  • Inputs — form fields, UIForm, dropdowns, search bar, tag input, number field, color picker, OTP, sliders, calendar/date/time pickers, and settings tiles.
  • Layout & responsive — dividers, page scaffold, expandable panel, dynamic overflow, keyboard dismiss/toolbar, portal, glass scaffold, and Responsive helpers.
  • Lists, loading & media — swipe action tile, shimmer/overlay/load-more helpers, UIImage, and UIImageScope.
  • Navigation & tabs — app bars, bottom bars, menu bar, tree view, breadcrumbs, context menu, side menu, settings scaffolds, and tab bars.
  • Selection, states & text — list tile select, pill switch, radio group, rounded checkbox, error info, rich/read-more/marquee text, and SVG icons.
• Documentation — updated README.md, doc/IMPLEMENTATION_GUIDE.md, and example app catalog to match the current API.

0.0.9

• Glass — UIGlassSurface, UIGlassCard, UIGlassButton, UIGlassAppBar, UIGlassBottomNavBar, UIGlassScaffold, UIGlassTheme.
• Product tours — UITourController, UITourStep, UISpotlightOverlay, UITourTooltipCard, UITourProgressIndicator.
• Feedback — UIPopover.

0.0.8

• Coupon clips — UICouponClip, UICouponCard, UICouponClipper, UICouponDecorationPainter.
• Adaptive dialogs — showUIAdaptiveAlertDialog, showUIAdaptiveActionSheet with shared platform selection.
• Core — UIPageRoute transitions (UIEntrancePageTransition, UIDrillInPageTransition, UIHorizontalSlidePageTransition).
• Maintenance — removed dead loading/shimmer.dart re-export; consolidated adaptive platform helper and context-menu item mapping; expanded example showcase coverage.

0.0.7

• Buttons — UISplitButton.
• Display — UICommandBar.
• Inputs — UISearchBar, UITagInput, UINumberField, UIColorPicker.

0.0.6

• Layout — UIPageScaffold, UIExpandableFloatingPanel, UIDynamicOverflow.
• Lists — UISwipeActionTile.
• Navigation — UIBottomNavyBar, UIFloatingBottomBar, UIMenuBar, UITreeView.
• Cards — UIAnimatedFlipCard.

0.0.5

• Loading — UIShimmer, UIShimmerLoadingContainer, UIShimmerBase, UIShimmerPageLoading, UILoadingOverlay, UILoadMoreContainer, UILoadingIndicator.
• Interactive example app catalog covering all exported widgets and utilities.
• Implementation guide at doc/IMPLEMENTATION_GUIDE.md.

0.0.4

• Accordion, cards & clips — UIExpansionAccord, UIExpansionAccordItem, UIExpansionTile, UICard, UICardTopContainer, UIHexagon, UISharpCorners, UITicketClip.
• Carousel — UICarouselWithIndicator, UISectionCarousel, UICarouselControls, UICarouselRowPage, UICarouselNavButton, UICarouselPageIndicators.
• Decoration — UIGradientBox, UIGradientText, UIGradientSvgIcon, UIDottedBorder, UICornerRibbon.

0.0.3

• Display — UIStatSummaryCard, UIStatusBanner, UIBatteryIndicator, UISegmentedBar, UISummaryGrid, UIMetricListTile, UIIconBadge, UIAnimatedCounter, UITextAvatar, UIStackBadge, UITimerBuilder, and related display widgets.
• Dialogs — UICustomMessageDialog, UIShellDialog, UIAlertPanel, UIListDialog, UIImagePickerDialog, showUISheet, showUICupertinoActionSheet.
• Feedback — UISnackbar, UIEmptyState, UIBadge, UILiveBadge, UINoteList, UISkeletonPlaceholder, UITooltip.
• Inputs — UITextFormField, UILabeledField, UILabeledTextFormField, UIForm with named fields, UIDropdown, UIOverlayDropdown, UIPasswordStrengthIndicator, UIRangeSlider, NoLeadingSpaceFormatter, NoSpaceFormatter, and settings tile widgets.

0.0.2

• Selection & states — UIListTileSelect, UIRoundedCheckbox, UIRadioGroup, UIErrorInfo.
• Tabs — UITabBar, UISegmentedTabBar, UIButtonsTab.
• Text & icons — UIText, UIRichText, UIReadMoreText, UIMarquee, UITextRow, UISvgImage, UISvgAssetIcon, UISocialAuthIcon with a lightweight built-in SVG path parser; widget helpers buildUILabel, textStyle, textSpan, getMaxLines, getTextHeight.
• Core utilities — NavigationUtil, DialogUtil, DateTimeUtil, JsonUtils, JsonHelper, Mapper, Translations, TranslationCache, StringUtils, StringExtension, DoubleExtension.

0.0.1

• Initial release of vvk_ui_kit.
• Theming — UIAppTheme with UIThemePalette light/dark presets, UIThemeExtension semantic tokens, and UIMetrics layout values.
• Buttons — UIStyledButton with style variants, UIPrimaryTextButton, UITextButton, UIElevatedButton, UIIconButton, UIElevatedIconButton, UIImageButton, UIImageTextButton, UICupertinoTextButton, UICustomOutlinedButton, UITabTextButton, UIGradientButton, UISliderButton, and UISocialAuthButton.
• Layout & responsive — UIDivider, UIDashedDivider, UICenteredTextDivider, UIFixedSectionListView, UIScrollableScreen, UISeparatedRow, UISeparatedColumn, UISpacing, UIKeyboardDismissArea, Responsive, ResponsiveProvider, ResponsiveLayout.
• Media — UIImage for assets, network URLs, SVG, and base64 via UIImageScope builder injection.
• Navigation — UIAppBar, UISideMenu, UISettingsPageScaffold, UITabbedDetailScaffold, UIThemeToggleButton, UIDoubleBackToExit.