m3e-haptic-standards

name	M3E Haptic Standards
description	Guidelines for premium tactile "Felt" experience in Varisankya

M3E Haptic Standards

To achieve the "Premium Felt" experience, haptics must be curated based on the interaction weight:

Interaction Hierarchy

Interaction	Haptic Role	Method
Scrolling	Mechanical Tick	PreferenceHelper.attachScrollHaptics(recyclerView)
Success/Save	Confirmation	PreferenceHelper.performSuccessHaptic(view)
Error/Reject	Reject	PreferenceHelper.performErrorHaptic(view)
Toggle/Click	Light Tick	PreferenceHelper.performClickHaptic(view)
Long Press	Contextual	HapticFeedbackConstants.LONG_PRESS

Implementation Patterns

1. Mechanical Scroll Feel

Attach to ANY list containing core data:

PreferenceHelper.attachScrollHaptics(recyclerView)

2. Guarded Haptics

NEVER call performHapticFeedback directly in Activities. Use PreferenceHelper to ensure the user's preference is respected:

saveButton.setOnClickListener {
    PreferenceHelper.performSuccessHaptic(it)
    // ... save logic ...
}

3. Selection Haptics

For AutoCompleteTextViews or Bottom Sheets, trigger a tick on every delta/selection:

PreferenceHelper.performHaptics(v, HapticFeedbackConstants.SEGMENT_TICK)