tangent_haptic_feedback 0.0.1

A powerful, type-safe haptic feedback library for iOS using Core Haptics. Create custom haptic patterns with parameter curves.

0.0.1

Initial release of TangentHapticFeedback.

Features

• Core Haptic Events

  • TransientEvent - Sharp, instantaneous haptic feedback (taps, clicks)
  • ContinuousEvent - Sustained haptic feedback (rumbles, vibrations)

• Parameter Curves

  • HapticParam.constant - Fixed intensity/sharpness value
  • HapticParam.linear - Linear interpolation between two values
  • HapticParam.curve - Custom multi-point curves
  • Built-in presets: fadeIn, fadeOut, rampUp, rampDown, pulse, spike

• Pattern Composition

  • then() - Chain patterns sequentially
  • overlay() - Play patterns simultaneously
  • repeat() - Repeat patterns with configurable gap
  • scaled() - Adjust pattern intensity
  • Operator overloads: + (sequential), | (parallel)

• Fluent Builder API

  • HapticPatternBuilder for intuitive pattern creation
  • Methods: tap(), rumble(), rumbleCurved(), wait(), waitMs(), fadeIn(), fadeOut(), pulse()

• Built-in Pattern Library (20+ patterns)

  • Simple taps: lightTap, mediumTap, heavyTap, soft, rigid
  • UI feedback: selection, doubleClick, tripleClick
  • Notifications: success, warning, error
  • Expressive: heartbeat, buzz, longBuzz
  • Curved: explosion, engineRev, pulseWave, impactDecay, chargeUp

• Silent Fail

  • Gracefully handles unsupported devices without throwing exceptions

Platform Support

• iOS 13.0+ (using Core Haptics)
• Android support planned for future release