floaty_chatheads_platform_interface 3.0.0

Platform interface for floaty_chatheads. Defines the abstract contract, configuration models, and method-channel fallback shared by Android and iOS implementations.

Changelog

3.0.0

Breaking release. Minimum Flutter 3.44 / Dart 3.12, iOS 15, Android API 24. Built-in Kotlin end to end. See the migration notes at the end.

• ChatHeadConfig.entryPointLibrary (nullable) added and serialized over the method channel.
• ChatHeadConfig.readyTimeout, OverlayReadiness and FloatyOverlayNotReadyException: platform implementations confirm the overlay isolate is listening before showChatHead completes.
• FloatyChatheadsPlatform.supportsNativeIcons lets implementations whose bubble is a Flutter view skip native icon frames.
• FloatyChannels.envelope, ping and pong constants.
• ChatHeadConfig, AddChatHeadConfig, ChatHeadAssets, ChatHeadTheme, NotificationConfig, OverlayPosition, SnapConfig and MethodChannelFloatyChatheads are now final. Their constructors take the same arguments as before. FloatyChatheadsPlatform stays extendable for platform implementations.
• Minimum Flutter 3.44 / Dart 3.12.

2.1.0

New: PanelAnchor

• feat: new PanelAnchor enum (below / above / auto) on ChatHeadConfig.panelAnchor controls where the expanded content panel opens relative to the bubble. The panel is always clamped to the screen bounds; auto picks below when there is room, otherwise above.

Behavior change (non-breaking API)

• The content panel now opens below the bubble by default. Previously the panel rendered from the top of the screen with the bubble row overlapping its top edge (Android) or grew down-right from the bubble's corner (iOS). Full-screen panels are unaffected (clamping keeps them at the top). Overlays that reserved top padding for the bubble row on card-sized panels should remove it.
• MethodChannelFloatyChatheads serializes panelAnchor by index.

2.0.0

Released as part of the floaty_chatheads 2.0 line. See the main package CHANGELOG for the full migration guide.

New shared helpers

• FloatyChannels: single source of truth for the canonical messenger channel name (ni.devotion.floaty_head/messenger). The Dart side, the Android Kotlin service, and the iOS Swift plugin all reference this constant.
• ChatHeadConfigResolver: extracts default-value resolution (size-preset application, snap-config fallbacks, notification visibility default) from the Android and iOS Dart shims. Both platform packages now call the resolver, eliminating ~30 lines of duplicated null-coalescing logic.

Documented platform differences

• ChatHeadAssets documents that asset overrides are honored on Android only; the iOS chathead is a Flutter view, so app authors render icons inside the overlay entry point.

Toolchain (BREAKING)

• Dart SDK floor ^3.0.0, Flutter floor >=3.10.0. This matches the rest of the federated set and was picked as the bare minimum the Dart code requires.

1.0.5

Enhancements

• Added updateChatHeadIcon() to the platform interface. New abstract method that pushes raw RGBA pixel data to the native layer, enabling real-time animated chathead icons driven from Dart.
• Added matching implementation in MethodChannelFloatyChatheads.

Dependencies

• Removed package:meta dependency and replaced it with package:flutter/foundation.dart imports across all model files.

1.0.4

Enhancements

• Added autoLaunchOnBackground to ChatHeadConfig. When true, the chathead is automatically shown when the app goes to the background and dismissed when the app returns to the foreground.
• Added persistOnAppClose to ChatHeadConfig. When true, the overlay service uses START_STICKY and survives after the main app is killed. When false, the service stops itself on disconnect.

1.0.3

Enhancements

• Added NotificationConfig.description field. When set, the foreground-service notification uses a custom title and body instead of the default "<title> is running" format.

1.0.2

Metadata

• Added example/example.md for the pub.dev example tab.

1.0.1

• Documentation and metadata updates.

1.0.0

Initial Release

• FloatyChatheadsPlatform abstract interface with 13 platform methods.
• ChatHeadConfig: full configuration model with theming, size presets, snap behavior, entrance animations, and debug mode.
• ChatHeadTheme: badge colors, bubble border, shadow, close tint, and overlay palette.
• ContentSizePreset: compact, card, halfScreen, fullScreen.
• AddChatHeadConfig, OverlayPosition, OverlayFlag, SnapEdge, EntranceAnimation, NotificationVisibility models.
• MethodChannelFloatyChatheads fallback implementation.
• VGV-style {@template} / {@macro} documentation on all public APIs.