Repository navigation
ToastKit v1.4.0 adds a richer foreground-notification experience while preserving existing ToastKit behavior and APIs.
Highlights
- Added dynamic presentation with
presentation('dynamic')and thedynamic()shortcut. - Added expanding and collapsing foreground-pill designs for iOS and Android, including cutout-origin entrance and exit motion.
- Added predefined icon sizing with
iconSize('sm'|'md'|'lg'). - Added smooth content-update crossfades for title and message changes.
- Added whole-toast press handling through the new
ToastPressedevent. - Added optional JSON-serializable
data()payloads for toast presses and action events. - Added
actions()support for one or two actions with optional per-action colors. - Improved Android queued transitions and dynamic-action alignment.
- Improved accessibility, RTL-aware layouts, native renderer behavior, and Android/iOS parity.
Compatibility
There are no breaking changes in this release.
- Standard presentation remains the default.
- The existing
action(string $label, string $id)API remains supported. - The legacy single-action bridge payload remains compatible.
- Whole-toast presses are opt-in and occur only when non-empty data is attached.
- When
action()andactions()are both used, the last method called wins.
Validation
- 190 PHP tests passed with 378 assertions.
- 37 JavaScript tests passed.
- Standard, dynamic, and native presentations were manually verified on Android and iOS emulators.
- Animations, queued transitions, content updates, swipe dismissal, close controls, attached data, toast presses, one/two actions, action colors, and automatic action dismissal were verified.
Full changelog: v1.3.0...v1.4.0