ripplearc_coreui 0.10.2

A Flutter design system package with design tokens and basic components.

Changelog

0.10.2 Accessibility

✨ Features

• CoreInputChip: add optional removeSemanticLabel for a localizable remove-button announcement; when null, keeps the default 'Remove <label>' English label

0.10.1 Dark-mode contrast fixes

🔧 Fixes

• Accessibility / Dark mode
  • CoreButton (social variant): background changed from buttonInverse (gray25 — near-white) to backgroundSecondaryDark in dark mode, preventing invisible content when text and icon tokens also resolve to near-white
  • DimensionCard: same background-swap fix applied; card surface is now backgroundSecondaryDark in dark mode instead of buttonInverse
  • SizeCard: same background-swap fix applied; card surface is now backgroundSecondaryDark in dark mode instead of buttonInverse
  • All three fixes mirror the existing CoreSelectButton dark-mode guard pattern; contrast ratios now meet WCAG AA (≥ 4.5:1 for text, ≥ 3:1 for UI components)

🧪 Tests

• Social button: WCAG contrast a11y test + light & dark golden tests
• DimensionCard / SizeCard: WCAG contrast a11y tests added to core_geometry_area_a11y_test.dart
• Dark-mode golden tests added for CoreGeometryArea (collapsed and expanded)

0.10.0 Search & Filter Components

✨ Features

• UI Components
  • CoreDateFilterChip: Filter chip for a date-range filter. With no selection it renders a plain CoreFilterChip that opens a CoreDateRangeSheet on tap; with a selection it renders an active pill showing the formatted range with a clear ×. Surface-agnostic: each caller supplies its own label, accessibility labels, and widget keys.
  • CoreDateRangeSheet: Modal bottom sheet for picking an inclusive, whole-calendar-day DateRange. Offers predefined ranges (Today, Last 7 days, Last 30 days, This month) plus a Custom range option that opens CoreDatePicker twice — once for the start date, once for the end date. Resolves with the chosen DateRange, or null on cancel/dismiss.
  • CoreMultiSelectSheet: Modal bottom sheet body for selecting multiple values from a searchable list of {id, label} items. The caller supplies the (already filtered) list and reacts to search and apply callbacks; present it with CoreQuickSheet.show.
  • DateRange: Value type representing an inclusive calendar-day range, shared by the date filter components.
  • All three components ship with showcase screens, widget tests, accessibility tests, and light + dark golden tests.

0.9.1 Dart 3.8 compatibility patch

🔧 Fixes

• Dependency constraints loosened for Dart 3.8 compatibility
  • flutter_svg: ^2.3.0 → ^2.2.3 — 2.3.0 requires Dart ≥3.9.0; 2.2.3 is the last release compatible with Dart 3.8. No coreui APIs from 2.3.0 are used.
  • lottie: ^3.4.0 → ^3.3.1 — same reason; only Lottie.asset() with stable params is used.
  • ripplearc_linter moved from dependencies to dev_dependencies — the linter has no runtime role and should never have been a transitive dependency for consumers; this was causing analyzer ^8.4.0 to cascade to every app using coreui, breaking build tooling on Dart 3.8.

0.9.0 Dark theme

✨ Features

• Dark Color Tokens
  • 9 dark token classes mirroring each light class (DarkBackgroundColors, DarkTextColors, DarkIconColors, DarkBorderColors, DarkTabColors, DarkButtonColors, DarkInputColors, DarkSelectColors, DarkStateColors) — all colors sourced from the Figma dark-mode palette
  • CoreTheme.dark() now returns a fully populated ThemeData with brightness: Brightness.dark and scaffoldBackgroundColor mapped to gray50; both AppColorsExtension and AppTypographyExtension are switched to their dark variants automatically
  • AppTypographyExtension.createDark() — all 19 text styles substituted with CoreDarkTextColors.* (gray25 for headlines, gray100 for titles, gray300 for body); components using typography.someStyle without .copyWith now render correctly in dark mode

🔧 Fixes

• Accessibility
  • SingleItemSelector modal title: uses .copyWith(color: colors.textHeadline) so text stays visible on the dark scaffold (was gray900 on gray900 — 1:1 contrast)
  • SingleItemSelector item text: uses .copyWith(color: colors.textBody) to ensure list items remain legible in dark mode
  • CoreSelectButton selected tab: text color switches to textInverse (gray900) when tab background is tabsHighlight (orient300), resolving the 1.6:1 contrast failure in dark mode
• CoreLetterAvatar: replaced Image.asset with a BoxDecoration-based Container wrapped in AspectRatio(aspectRatio: 1.0); fixes Semantics label propagation that was blocked by Image.asset and correctly derives height from the available width constraint without a RenderBox infinite-constraint error

Tests

• CoreDatePicker Visual Regression - Dark golden added — verifies header background (blue900), selected day fill (orient200), and month row text under CoreTheme.dark()
• Dark-mode goldens added for color tokens, letter avatar, and check row item; all light goldens refreshed against current Flutter SDK

0.8.0 CoreInputChip

✨ Features

• UI Components
  • CoreInputChip: New non-toggleable input chip for displaying committed tokens (e.g. email addresses or tags) with a remove button.
    • Displays a text label in bodyMediumSemiBold with TextOverflow.ellipsis — safe inside Wrap rows and on narrow screens
    • Trailing close (×) button meets the 48 dp minimum tap-target requirement; tapping calls onRemove
    • onRemove is optional — omitting it hides the remove button entirely, enabling a read-only/locked-token display mode
    • Full accessibility support: chip container exposes a Semantics(container: true) node with the label text; remove button exposes a Semantics(button: true) node labelled "Remove <label>"; label Text is wrapped in ExcludeSemantics to prevent double-announcement
    • CoreInputChip.removeButtonKey static key for locating the tap target in tests
    • Widget tests, accessibility tests (both themes), and golden tests (light + dark, short label + email label)

0.7.2 CoreCheckRowItem & CoreDatePicker

Upgraded

• Flutter SDK bumped from 3.32.0 to 3.44.4; Dart SDK constraint raised to >=3.12.0 <4.0.0.
• Gradle wrapper 8.13 → 8.14.
• Android Gradle Plugin (AGP) 8.7.0 → 8.11.1.
• Kotlin Gradle Plugin 2.1.0 → 2.2.20.
• flutter_lints ^5.0.0 → ^6.0.0.
• flutter_svg ^2.2.2 → ^2.3.0, lottie ^3.3.1 → ^3.4.0, ripplearc_linter ^0.4.0 → ^0.4.1.
• Minimum supported iOS deployment target raised from 12.0 to 13.0 (example app).

Fixed

• Fixed a drag-reorder regression in CoreFunctionKeyBottomSheet where migrating to Flutter's new onReorderItem callback (which now performs index correction internally) had left the widget's own manual index-correction logic in place, causing dropped items to land one position off from where the user released them.

Changed

• Migrated ReorderableListView/ReorderableListView.builder usages (_SizesTable, CoreFunctionKeyBottomSheet) from the deprecated onReorder callback to onReorderItem, ahead of Flutter's planned removal of onReorder.
• Migrated widget tests off the deprecated SemanticsNode.hasFlag/SemanticsData.flags API to the new flagsCollection API, including the isSelected/isEnabled flags moving from bool to the new Tristate enum.
• SingleItemSelector's bottom sheet item now wraps its ListTile in a Material widget with Clip.antiAlias, fixing the tap ripple/ink effect rendering outside the intended bounds.
• CoreKeyboard's reveal/collapse SizeTransition migrated from axisAlignment: -1.0 to alignment: AlignmentDirectional.topStart.

Tests

• Existing SingleItemSelector widget tests now pass without framework exceptions after the Material(clipBehavior: Clip.antiAlias) wrapper fix.

0.7.0 CoreCheckRowItem & CoreDatePicker

✨ Features

• UI Components
  • CoreCheckRowItem: New selectable list row — leading widget, title (+ optional subtitle), and a trailing checkbox.
    • Whole row is tappable; tapping toggles selected via onChanged
    • Defaults the leading widget to a 24×24 circle showing the first initial of title (derived from the first whitespace-delimited token, uppercased, e.g. "John Doe" → "J"; blank title renders an empty circle, no crash); avatarBackgroundColor/avatarTextColor/avatarTextStyle theme it (ignored when a custom leading is supplied); avatarTextColor is applied last and remains the single source of truth for the glyph colour
    • Trailing checkbox swaps between CoreIcons.check and CoreIcons.checkBlank based on selected
    • Optional subtitle for a second line (e.g. an email address)
    • Localizable semanticLabel param (defaults to title); exposed as a Semantics(button: true, checked: selected) node
  • CoreDatePicker: New modal calendar widget for picking a single date (CA-220).
    • Header with a localizable label and a large spelled-out selected date ("Mon, Aug 17"-style by default, fully overridable via dateLabelBuilder)
    • Month selector row with previous/next navigation; arrows disable themselves once an adjacent month would be entirely out of the optional firstDate/lastDate range
    • Day grid with selected (filled), "today" (outlined), and disabled (out-of-range) states
    • CoreDatePicker.show static helper presents the picker in a themed dialog and resolves with the confirmed DateTime, or null on cancel/dismiss
    • monthLabelBuilder and weekdayLabels allow full localization of all date text without subclassing
    • Each day cell exposes a Semantics(button: true, selected: ...) node with a full date label via MaterialLocalizations.formatFullDate

0.5.0 Search components

✨ Features

• UI Components
  • CoreSearchBox: New borderless search input field.
    • Built-in leading search icon and auto-appearing clear button (shown only when the field has text)
    • Flat appearance with no visible border — designed for global or in-page search bars
    • Accepts an optional TextEditingController and FocusNode; manages its own when none are supplied
    • onChanged, onSearch (keyboard submit), and onClear callbacks
    • enabled flag renders the field non-interactive with a backgroundGrayMid fill
    • clearSemanticLabel localizable constructor param (defaults to 'Clear search')
    • hintText localizable constructor param for placeholder text
  • CoreSearchRowItem: New single-row item for search screens.
    • Two named constructors: CoreSearchRowItem.recentSearch (history icon) and CoreSearchRowItem.suggestion (search icon with bold-prefix query highlighting)
    • Trailing ↗ icon with independent onTrailingTap callback (e.g. fill the search field without triggering a search)
    • showTrailingIcon flag to hide the trailing icon
    • semanticLabel and trailingSemanticLabel localizable params for full screen-reader support
    • Custom variant via the default constructor: caller supplies any leadingIcon and a pre-built label widget

0.4.1 CoreIconSize token

✨ Features

• Design Tokens
  • CoreIconSize: New icon size token with four canonical sizes — size16 (16dp), size20 (20dp), size24 (24dp), size32 (32dp).
    • Value-based naming reflects how icon sizes are referenced in design tooling and specs
    • Exported from the public barrel alongside other theme tokens
    • Golden test verifying each size using CoreIconWidget

0.4.0 CoreFilterChip component

✨ Features

• UI Components
  • CoreFilterChip: New dropdown-style filter chip for filter rows.
    • Filled pill design using backgroundGrayMid (#F2F4F7) background token
    • Trailing dropdown arrow icon in iconDark (#015B7C) color
    • label (required) and onTap (optional) public API — chip is non-interactive when onTap is null
    • Full accessibility support: outer Semantics node exposes label and button role (only when enabled); Text and arrow icon wrapped in ExcludeSemantics to prevent double-announcement
    • Widget tests, accessibility tests, and golden tests (enabled, long label, disabled states)

0.3.9 CoreToast title support

✨ Features

• UI Components
  • CoreToast: Added optional title parameter to showSuccess, showError, and showWarning methods.

🔧 Fixes

• Code Quality
  • Improved null safety in CoreToast descriptions to avoid displaying "null" strings.
  • Cleaned up redundant documentation and implementation comments.

0.3.8 CoreQuickSheet component

✨ Features

• UI Components
  • CoreQuickSheet: New standardized bottom sheet component for consistent sheet presentation across the app
    • Automatic content-based height (up to 90% of screen)
    • Custom drag handle with consistent styling
    • Theme-aware background color (defaults to pageBackground)
    • Configurable dismiss behavior (isDismissible, enableDrag)
    • Optional safe area handling (useSafeArea)
    • Optional custom background color override
    • Rounded top corners (28px) per design spec
    • Returns values when dismissed for result handling

🔧 Fixes

• Code Quality
  • Fixed tooltip component forced unwrapping issue with overlay entry
  • Improved null safety in tooltip overlay insertion

0.3.7 Add splash screen icons

✨ Features

• Icons
  • Added splash screen animation icons (splashFirstState, splashSecondState, splashThirdState)
  • New SVG icons available via CoreIcons for splash screen animations

0.3.6 Accessibility improvements

✨ Features

• Accessibility
  • Added accessibility tests for all interactive components (CoreAvatar, CoreLetterAvatar, CoreKeyboard, CoreButton, CoreBottomNavBar, CoreLoadingIndicator)
  • Tests verify tap target size, semantic labels, and text contrast guidelines

🔧 Fixes

• Design Tokens

  • Updated text link color from orient600 to orient800 to match UI design specification

• Accessibility

  • Fixed CoreButton text overflow with ellipsis and FittedBox scaling for long labels
  • Fixed accessibility-related contrast and layout issues across components

0.3.5 Code quality improvements

✨ Features

• UI Components

  • CoreLoadingIndicator: Added Lottie-based loading indicator component with customizable size and fit options

• Dependencies

  • Added lottie (^3.2.0) for animation support

• Assets

  • Added loading animation asset (assets/animations/loading.json)

0.3.4 Code quality improvements

🔧 Fixes

• Code Quality
  • Fixed avoid_static_colors linter violations
  • Integrated shadow colors into theme system for consistent design token usage

0.3.3 Theme extension naming consistency

⚠️ Breaking Changes

• TypographyExtension has been renamed to AppTypographyExtension for consistency with other theme extensions
• Update your code: Theme.of(context).extension<TypographyExtension>() → Theme.of(context).extension<AppTypographyExtension>()

0.3.2 Code quality improvements

🔧 Fixes

• Code Quality
  • Fixed avoid_static_typography linter violations
  • Fixed forbid_forced_unwrapping linter violations
  • Fixed specific_exceptions_types linter violations

0.3.1 Add transparent utility color

✨ Features

• Design Tokens
  • Added transparent utility color to the core color palette and AppColorsExtension for consistent use across apps.

0.1.0 Initial Release

✨ Features

• UI Components

  • CoreBottomNavBar: A customizable bottom navigation bar component with responsive sizing and smooth animations.
  • SuccessModal: A bottom sheet that is displayed to the user when an operation is successful.
  • Toast: Provides a static interface to display toast messages, e.g., Toast.showSuccess, Toast.showError, Toast.showWarning.
  • CoreButton: Customizable button with support for primary, secondary, and social variants, multiple sizes, icons, and disabled state.
  • CoreTextField: Flexible text input with label, helper text, error handling, phone number input, prefix/suffix widgets, and country code selector.
  • SingleItemSelector: Single-select dropdown with bottom sheet support.
  • CoreIconWidget: Unified icon widget supporting both Material and SVG icons.

• Design Tokens

  • Color tokens (brand, gray, blue, red, etc.)
  • Typography tokens (font sizes, weights, styles)
  • Spacing tokens (consistent spacing system)
  • Shadow tokens (multiple shadow levels)
  • Icon tokens (Material and custom SVG icons)

• Theming

  • Light and dark theme support
  • Easily extendable theme data for custom branding

• Assets

  • Extensive icon set (SVG and Material icons)
  • IBM Plex Sans Hebrew font family included