mega_ui_kit 0.0.7

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.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.