mega_ui_kit 0.0.13

Flutter UI kit with themeable semantic colors (MegaColorScheme), design tokens, and Mega-aligned widgets. Brand colors are provided by your app — see example.

Changelog

All notable changes to this project will be documented in this file.

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

0.0.13 - 2026-07-27

Fixed

• MegaBottomSheet — wrap sheet content in SafeArea(top: false) so body and footer respect the bottom system inset (home indicator).
• MegaSnackBar — use SafeArea(bottom: false) for top positioning instead of manual MediaQuery.padding math.

0.0.12 - 2026-07-27

Fixed

• MegaDropdown.page — wrap the selection screen in SafeArea(top: false) so the option list respects the bottom system inset (home indicator).

0.0.11 - 2026-06-29

Fixed

• MegaDropdownFormField — defer syncing controlled [value] to the underlying [FormField] until after build, fixing setState() called during build when the parent updates state in [onChanged].

0.0.10 - 2026-06-29

Added

• MegaDropdownFormField — FormField wrapper for [MegaDropdown.bottomSheet] and [MegaDropdown.page] with validator, autovalidateMode, and onSaved.
• MegaDropdown.page — optional empty widget shown when the option list is empty (or search has no matches); the picker opens only when empty is set.
• Kitchen sink examples for form validation and empty page state.
• Widget tests for [MegaDropdownFormField] and empty [MegaDropdown.page].

0.0.9 - 2026-06-29

Added

• MegaSearchField — Figma-aligned compact search input (40 dp, surfaceHigh fill): leading search icon (SVG), Nagel 16/24 hint and input styles, animated clear control when non-empty, optional in-field [trailing] slot, optional external cancel action ([onCancel] / [cancelText]) for iOS-style search-mode exit.
• MegaTextScroll — horizontally scrolling title text (endless and bouncing modes) for long app-bar titles.
• MegaDropdown.page — optional isSearch with MegaSearchField and MegaDropdownSearchField configuration; optional pageTitleTextStyle.
• Widget tests for clear, cancel, styling, and callbacks.
• Kitchen sink: search-mode flow demo (header → field + Cancel → exit) and trailing variant on the MegaTextField tab; widget constructor names in section headers across example tabs.

Changed

• MegaSearchField — replaces the 0.0.7 @Deprecated MegaTextField wrapper with a standalone implementation (no floating label; borderless inner field).
• MegaAppBar — custom title widget is no longer wrapped with TextOverflow.ellipsis; default title style is 16 sp / FontWeight.w500.
• MegaDropdown.page — selection screen uses MegaAppBar with back button and MegaTextScroll title instead of Material AppBar.

Migration

// 0.0.8 — thin wrapper over MegaTextField (labelText supported)
MegaSearchField(
  labelText: 'Search',
  hintText: 'Query',
  onChanged: (v) {},
);

// 0.0.9 — dedicated search field
MegaSearchField(
  hintText: 'Search',
  onChanged: (v) {},
  onCancel: () {
    // Dismiss keyboard, clear query, collapse search UI.
  },
  cancelText: 'Cancel', // default label: «Отмена»
  trailing: Icon(Icons.tune),
);

Remove labelText — use screen title / app bar for context. Wire [onCancel] only when the screen enters dedicated search mode.

0.0.8 - 2026-05-29

Fixed

• MegaTabsScrollPhysics — replace deprecated tolerance with toleranceFor() (Flutter 3.7+ / pub.dev Pana static analysis 50/50).

0.0.7 - 2026-05-29

Added

• MegaTextField — Figma-aligned text field: floating label, ghost hint overlay, inputTemplate masking (# slots), clear/obscure toggles, character counter, read-only and error states.
• MegaTextFormField — FormField wrapper with validator, autovalidateMode, and onSaved. Controller is the single source of truth for the field value.
• MegaCards — card component with MegaCardStyle presets (icon, service, text, featured).
• MegaRadii.field — 16 dp semantic radius for text fields, dropdowns, and list tiles.
• Kitchen sink example tabs for MegaTextField and MegaCards.
• Widget and unit tests for MegaTextField, MegaTextFormField, and MegaCards.

Changed

• Breaking: MegaTextField API rewritten (removed the previous @Deprecated stub). Rename label → labelText, hint → hintText, prefixIcon / suffixIcon → leading / trailing.
• MegaSearchField — reimplemented as a thin wrapper over MegaTextField (still @Deprecated; will be replaced).
• MegaTypography — dartdoc comments on display and heading styles.

Migration

// 0.0.6
MegaTextField(
  label: 'Email',
  hint: '[e-mail]',
  prefixIcon: Icon(Icons.email_outlined),
);

// 0.0.7
MegaTextField(
  labelText: 'Email',
  hintText: '[e-mail]',
  leading: Icon(Icons.email_outlined),
);

Phone and card inputs with templates — validate with MegaTextField.isTemplateComplete instead of isEmpty alone (leading literals may be inserted on focus).

0.0.6 - 2026-05-20

Fixed

• MegaDropdown — replace deprecated SizeTransition.axisAlignment with Align + heightFactor (Flutter 3.44+ / pub.dev Pana).

0.0.5 - 2026-05-20

Added

• Package logo — assets/megauikit_logo.svg and assets/megauikit_logo.png (wordmark for pub.dev and README).

0.0.4 - 2026-05-20

Fixed

• README preview images: markdown + GitLab raw URLs (pub.dev/GitLab display).

0.0.3 - 2026-05-20

Added

• MegaColorScheme — semantic color tokens as a ThemeExtension (primary, secondary, surface, success, error, disabled, system accents, component-specific fills).
• BuildContext.megaColors — resolved colors for the active light or dark theme.
• Documented pub.dev example — example/lib/main.dart: theme setup, color previews, MegaButton, MegaSnackBar, MegaSwitch, MegaCheckbox.
• Kitchen sink entry — example/lib/kitchen_sink_main.dart for the full component gallery.
• Example brand reference — example/lib/theme/mega_palette.dart (raw hex) and example/lib/theme/mega_brand_colors.dart (MegaBrandColors.light / .dark).
• README screenshots — assets/screenshots/ (buttons, list tiles, dropdown, dividers & progress).
• Example README — run instructions and integration checklist.

Changed

• Breaking: MegaTheme.light() and MegaTheme.dark() now require colors: MegaColorScheme.
• Breaking: Removed MegaColors and MegaPalette from the package API. Brand colors live in the example only.
• Breaking: Widgets use context.megaColors instead of static MegaColors.* / *Light / *Dark branches.
• Unified semantic names per theme variant (secondary, onSecondary, …) — no secondaryLight / secondaryDark in widget code.
• Expanded root README (theming model, migration, widget list, example commands).
• Updated pub.dev example from a one-line kitchen-sink re-export to a self-contained demo in main.dart.

Migration

// 0.0.x
MaterialApp(theme: MegaTheme.light());
color: MegaColors.primary;

// 0.0.3
MaterialApp(theme: MegaTheme.light(colors: MegaBrandColors.light));
color: context.megaColors.primary;

Copy example/lib/theme/mega_brand_colors.dart into your app or define your own MegaColorScheme values.

0.0.2 - 2026-05-18

Added

• README preview screenshots from the example app.
• Declared package platform support for Android and iOS.
• Core widgets: MegaAppBar, MegaButton, MegaBottomSheet.
• Feedback and display widgets: MegaLoadingIndicator, MegaLinearProgressIndicator, MegaCircularProgressIndicator, MegaDivider, MegaSnackBar.
• Navigation: MegaStepBars.

Changed

• Updated package metadata for pub.dev publication.
• Included the example app in the published package archive.

Fixed

• Replaced the license file with canonical Apache-2.0.
• Updated README license text from MIT to Apache-2.0.
• Fixed MegaBottomSheet behavior and layout edge cases.

0.0.1 - 2026-03-05

Added

• Initial package structure.
• Design tokens: MegaColors, MegaTypography, MegaSpacing, MegaRadii, MegaShadows.
• MegaTheme with light() and dark() constructors.
• Example app with color palette, typography, and spacing viewers.