haptic_kit 2.1.3

Haptic feedback, vibration and animated UI widgets for Flutter — Android & iOS. Impact, notification, selection, predefined effects, custom waveforms, Core Haptics patterns plus 8 production-ready widgets.

2.1.3

• Maintenance release.

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.

2.1.2 - 2026-07-10

Changed

• Set the pubspec documentation: field so the pub.dev "Documentation" link points to the hosted docs at codigee.com/open-source/haptic-kit.

2.1.1 - 2026-07-10

Added

• Hosted documentation on the Codigee open-source site — README now links to the overview, animated widgets and patterns & haptics API pages.

2.1.0 - 2026-07-10

Added

• HapticPulse widget — a looping "breathing" scale pulse that fires a haptic impact on every beat, the attention-getting counterpart to the one-shot HapticShake. Auto-plays on mount (autoPlay), loops forever or for a fixed number of beats (pulseCount), and exposes start() / stop() / isPulsing via GlobalKey<HapticPulseState> for manual control. Configurable minScale, maxScale, period, impactStyle and a visual-only haptics: false mode. No new native code — composes the existing Haptics.impact primitive.

2.0.0 - 2026-07-09

Added

• Swift Package Manager support — added ios/haptic_kit/Package.swift and a ios/haptic_kit/Sources/haptic_kit/ directory holding the plugin's Swift sources (moved from ios/Classes/). Flutter 3.44+ projects can now resolve this plugin via SPM; CocoaPods continues to work unchanged.

Changed

• BREAKING: minimum iOS deployment target raised from 12.0 to 15.0. Apps targeting iOS 12–14 must either stay on 1.x or raise their own deployment target. The plugin's runtime APIs are still guarded for iOS 13.0+ (Core Haptics), but the SPM tooling and example require iOS 15.0.
• Moved iOS sources from ios/Classes/ to ios/haptic_kit/Sources/haptic_kit/ and updated the podspec source_files accordingly.

Migration

• Ensure your iOS app's IPHONEOS_DEPLOYMENT_TARGET (and Podfile platform) is 15.0 or higher before upgrading to 2.0.0.

1.0.1 - 2026-06-07

Added

• VibrationPatterns.doubleTap() — two quick equal taps for double-tap acknowledgement feedback.

1.0.0 - 2026-05-13

Changed

• Promoted to stable 1.0.0. The public API is considered stable going forward — breaking changes will be reflected in a MAJOR version bump per Semantic Versioning.

0.1.2 - 2026-05-13

Changed

• Package renamed from flutter_haptics to haptic_kit because the former was rejected by pub.dev as too similar to the abandoned flutter_haptic package. The repository URL is unchanged.
• All identifiers updated to match: HapticKitPlugin (Android Kotlin
  • iOS Swift), HapticKitChannel (Dart), Android package dev.erykkruk.haptic_kit, method channel dev.erykkruk/haptic_kit.
• Import path is now package:haptic_kit/haptic_kit.dart.
• Version 0.1.1 was tagged in git but never published — the public history starts at haptic_kit 0.1.2.

0.1.1 - 2026-05-13

Changed

• Package renamed from flutter_vibration_animation to flutter_haptics to match the actual surface (Haptics, HapticPattern, HapticBounce, …) and to surface the library to users searching for haptic feedback rather than vibration animations. The GitHub repository keeps its original URL.
• Method channel renamed from dev.erykkruk/flutter_vibration_animation to dev.erykkruk/flutter_haptics. Android package and plugin class renamed accordingly (dev.erykkruk.flutter_haptics.FlutterHapticsPlugin). iOS podspec and plugin class renamed (FlutterHapticsPlugin).
• Haptics.prepare() now returns Future<bool> instead of Future<void> — true when the platform actually pre-warmed haptic generators (iOS), false when the call is a no-op on the current platform (Android).
• HapticBounce now validates pressedScale (must be in (0, 1)) and overshootScale (must be >= 1.0) at runtime, not only in debug. Bad values now throw ArgumentError instead of silently producing inverted scales in release builds.
• Dropped the deprecated library flutter_vibration_animation; directive from the barrel — modern Dart no longer requires it.
• Barrel-level doc comment now lists all 8 animated widgets, making them discoverable via IDE autocompletion on the flutter_haptics import.
• Pub.dev topics updated: haptics, vibration, haptic-feedback, animation, widgets.

Added

• Boundary-condition tests for InvalidVibrationArgumentException: negative duration, amplitude below kMinAmplitude, amplitude above kMaxAmplitude, amplitude at the upper boundary, empty timings, negative waveform amplitude, out-of-range repeat index.
• Tests covering the new Haptics.prepare() return value for both platform paths (iOS true / Android false).
• Test covering the invalid_argument platform error code mapping to InvalidVibrationArgumentException.

0.1.0 - 2026-04-30

Added

• Initial release.
• Haptics — impact (light/medium/heavy/soft/rigid), notification (success/warning/error), selection, prepare.
• Vibration — one-shot, custom waveforms with amplitude control, predefined OS effects, cancel.
• HapticPattern — fluent builder for Core Haptics events (intensity + sharpness, transient + continuous).
• VibrationPatterns — heartbeat, notification, alarm, tick, success, failure, charge-up.
• HapticCapabilities — runtime detection of vibrator hardware, amplitude control, Core Haptics, predefined effects.
• Android implementation (Kotlin) with Vibrator / VibratorManager (API 31+), VibrationEffect.createOneShot / createWaveform (API 26+), createPredefined (API 29+) and pre-API-26 fallbacks.
• iOS implementation (Swift) with UIImpactFeedbackGenerator, UINotificationFeedbackGenerator, UISelectionFeedbackGenerator and CHHapticEngine for custom patterns. AudioServices fallback for devices without Core Haptics.
• HapticToggle — animated switch with custom-painted thumb, spring-back easeOutBack curve and a selection tick on every flip.
• HapticSlider — wraps the standard Slider and fires a light tick at every detent crossing (configurable via divisions or tickEvery), with a heavier tick at the min/max endpoints.
• HapticStepper — composes two HapticBounce buttons around a sliding number; light haptic on each step, heavy haptic when hitting min/max.
• HapticShake — externally-triggered horizontal wiggle animation (6-segment decaying TweenSequence) with an error notification haptic. Triggered via GlobalKey<HapticShakeState>().shake().
• SlideToConfirm — drag-to-confirm pill (Uber-style) with light ticks at 25/50/75% drag, heavy thump on completion, and spring-back with a tick on early release. State exposes reset() for re-arming.
• HapticRating — star row that cascade-fills with one selection tick per star when tapped, configurable cascade delay.
• README "Building your own widget" section with the recurring pattern (one controller, gated thresholds, atomic cancel) and a table mapping each interaction moment to the right haptic.
• HapticBounce widget — drop-in tap wrapper with squash + recoil + elastic-settle bounce (3-segment TweenSequence with weights 1:2:3) synchronised with light/medium haptic impacts.
• PressAndHoldToConfirm widget — long-press confirmation with a finger-tracking progress ring, 12-tick densifying haptic schedule, escalating intensity (selection → light → medium → heavy) and a final heavy impact on completion. Single AnimationController drives the ring, haptics and callback in lock-step. Single-pointer guard, cancel-on-early-release, and reset() for re-arming.
• Showcase example app with five animated demos:
  • Typewriter — auto-typing text with a selection tick per character.
  • Heartbeat — pulsing heart icon synced with VibrationPatterns.heartbeat.
  • Loading ramp — progress bar 0→100% with light → medium → heavy haptic impacts at 25/50/75% and a success notification at 100%.
  • Bouncy press — gradient circle wrapped in HapticBounce.
  • Press & hold to unbox — gift-box card wrapped in PressAndHoldToConfirm that opens to a celebration on completion.