# Haptics

A provider that connects components to your haptics library, with a hook to trigger feedback.

Haptics is an open-source mobile component from suiss/uim for React Native and Expo, with SwiftUI and Jetpack Compose versions built from the same design tokens. The @esuiss/uim CLI copies its source into your project, so you own the code.

Source: https://uim.suiss.app/docs/components/haptics

![Preview](https://uim.suiss.app/previews/components-haptics--default.light.webp)

```tsx
import * as React from "react"
import { View } from "react-native"
import { Stepper, StepperDecrement, StepperGroup, StepperIncrement, StepperInput, StepperSeparator } from "@/components/interactions/stepper"
import { Checkbox } from "@/components/ui/checkbox"
import { Chip } from "@/components/ui/chip"
import { type HapticsAdapter, HapticsProvider } from "@/components/ui/haptics"
import { Slider } from "@/components/ui/slider"
import { Switch } from "@/components/ui/switch"
import { Text } from "@/components/ui/text"

function useLoggingAdapter() {
  const [log, setLog] = React.useState({ last: "None", count: 0 })
  const adapter = React.useMemo<HapticsAdapter>(() => {
    const record = (event: string) =>
      setLog((current) => ({ last: event, count: current.count + 1 }))
    return {
      impact: (style) => record(`impact ${style}`),
      selection: () => record("selection"),
      notification: (type) => record(`notification ${type}`),
    }
  }, [])
  return { adapter, log }
}

function HapticLog({ last, count }: { last: string; count: number }) {
  return (
    <View className="flex-row items-center justify-between rounded-xl bg-surface-secondary px-4 py-3">
      <Text className="text-sm text-label-secondary">Last haptic</Text>
      <Text
        role="status"
        accessibilityLiveRegion="polite"
        className="text-sm font-medium"
      >
        {count > 0 ? `${last} (${count})` : last}
      </Text>
    </View>
  )
}

function Row({
  label,
  children,
}: {
  label: string
  children: React.ReactNode
}) {
  return (
    <View className="min-h-11 flex-row items-center justify-between gap-4">
      <Text>{label}</Text>
      {children}
    </View>
  )
}

function Controls() {
  const [wifi, setWifi] = React.useState(true)
  const [terms, setTerms] = React.useState(false)
  const [volume, setVolume] = React.useState(40)
  const [copies, setCopies] = React.useState(1)

  return (
    <View className="w-full gap-2">
      <Row label="Wi-Fi">
        <Switch
          accessibilityLabel="Wi-Fi"
          checked={wifi}
          onCheckedChange={setWifi}
        />
      </Row>
      <Row label="Accept terms">
        <Checkbox
          accessibilityLabel="Accept terms"
          checked={terms}
          onCheckedChange={setTerms}
        />
      </Row>
      <Row label="Copies">
        <Stepper value={copies} onValueChange={setCopies} min={1} max={9}>
          <StepperInput accessibilityLabel="Copies" />
          <StepperGroup>
            <StepperDecrement />
            <StepperSeparator />
            <StepperIncrement />
          </StepperGroup>
        </Stepper>
      </Row>
      <View className="flex-row gap-2 py-2">
        <Chip>Open now</Chip>
        <Chip>Top rated</Chip>
      </View>
      <Slider
        value={volume}
        step={10}
        onValueChange={(next) => setVolume(next)}
        accessibilityLabel="Volume"
      />
    </View>
  )
}

function ControlsDemo({ enabled = true }: { enabled?: boolean }) {
  const { adapter, log } = useLoggingAdapter()
  return (
    <HapticsProvider adapter={adapter} enabled={enabled}>
      <View className="w-full gap-4">
        <HapticLog {...log} />
        <Controls />
      </View>
    </HapticsProvider>
  )
}

export function HapticsExample() {
  return (
    <ControlsDemo />
  )
}
```

```swift
import EsuissUI
import SwiftUI

struct HapticsRow<Content: View>: View {
  let label: LocalizedStringKey
  @ViewBuilder let content: () -> Content

  var body: some View {
    HStack(spacing: 16) {
      Text(label)
        .textStyle(.base)
        .foregroundStyle(Color.label)
      Spacer(minLength: 0)
      content()
    }
    .frame(minHeight: 44)
  }
}

struct HapticsControls: View {
  @State private var wifi = true
  @State private var terms = false
  @State private var volume = 40.0
  @State private var copies = 1
  @State private var openNow = false
  @State private var topRated = false

  var body: some View {
    VStack(alignment: .leading, spacing: 8) {
      HapticsRow(label: "Wi-Fi") {
        Toggle(isOn: $wifi) { EmptyView() }
          .toggleStyle(.switch(size: .default))
          .accessibilityLabel(Text("Wi-Fi"))
      }
      HapticsRow(label: "Accept terms") {
        Toggle(isOn: $terms) { EmptyView() }
          .toggleStyle(.checkbox)
          .accessibilityLabel(Text("Accept terms"))
      }
      HapticsRow(label: "Copies") {
        ValueStepper(value: $copies, in: 1...9) {
          StepperInput()
            .accessibilityLabel(Text("Copies"))
          StepperGroup {
            StepperDecrement()
            StepperSeparator()
            StepperIncrement()
          }
        }
      }
      HStack(spacing: 8) {
        Chip("Open now", isSelected: $openNow)
        Chip("Top rated", isSelected: $topRated)
      }
      .padding(.vertical, 8)
      ValueSlider(value: $volume, in: 0...100, step: 10)
        .accessibilityLabel(Text("Volume"))
    }
    .frame(maxWidth: .infinity, alignment: .leading)
  }
}
```

```kotlin
import androidx.compose.foundation.background
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.heightIn
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.runtime.Composable
import androidx.compose.runtime.CompositionLocalProvider
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableDoubleStateOf
import androidx.compose.runtime.mutableFloatStateOf
import androidx.compose.runtime.mutableIntStateOf
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.hapticfeedback.HapticFeedback
import androidx.compose.ui.hapticfeedback.HapticFeedbackType
import androidx.compose.ui.platform.LocalHapticFeedback
import androidx.compose.ui.semantics.LiveRegionMode
import androidx.compose.ui.semantics.contentDescription
import androidx.compose.ui.semantics.liveRegion
import androidx.compose.ui.semantics.semantics
import androidx.compose.ui.text.font.FontWeight
import androidx.compose.ui.unit.dp
import com.esuiss.ui.components.Checkbox
import com.esuiss.ui.components.Chip
import com.esuiss.ui.components.ProvideHaptics
import com.esuiss.ui.components.Slider
import com.esuiss.ui.components.Switch
import com.esuiss.ui.components.Text
import com.esuiss.ui.interactions.Stepper
import com.esuiss.ui.interactions.StepperDecrement
import com.esuiss.ui.interactions.StepperGroup
import com.esuiss.ui.interactions.StepperIncrement
import com.esuiss.ui.interactions.StepperInput
import com.esuiss.ui.interactions.StepperSeparator
import com.esuiss.ui.theme.EsuissTheme
import com.esuiss.ui.theme.Radius
import com.esuiss.ui.theme.Typography

@Composable
fun HapticsExample() {
    HapticsControlsDemo(enabled = true)
}

class HapticsLog(private val system: HapticFeedback) : HapticFeedback {
    var last by mutableStateOf("None")
    var count by mutableIntStateOf(0)

    override fun performHapticFeedback(hapticFeedbackType: HapticFeedbackType) {
        last = hapticFeedbackType.toString()
        count += 1
        system.performHapticFeedback(hapticFeedbackType)
    }
}

@Composable
fun HapticsLogging(content: @Composable (HapticsLog) -> Unit) {
    val system = LocalHapticFeedback.current
    val log = remember(system) { HapticsLog(system) }
    CompositionLocalProvider(LocalHapticFeedback provides log) {
        content(log)
    }
}

@Composable
fun HapticsLogRow(log: HapticsLog) {
    val colors = EsuissTheme.colors
    Row(
        modifier = Modifier
            .fillMaxWidth()
            .background(colors.surfaceSecondary, RoundedCornerShape(Radius.xl))
            .padding(horizontal = 16.dp, vertical = 12.dp),
        horizontalArrangement = Arrangement.SpaceBetween,
        verticalAlignment = Alignment.CenterVertically,
    ) {
        Text("Last haptic", style = Typography.sm.copy(color = colors.labelSecondary))
        Text(
            if (log.count > 0) "${log.last} (${log.count})" else log.last,
            modifier = Modifier.semantics { liveRegion = LiveRegionMode.Polite },
            style = Typography.sm.copy(fontWeight = FontWeight.Medium),
        )
    }
}

@Composable
fun HapticsRow(label: String, content: @Composable () -> Unit) {
    Row(
        modifier = Modifier.fillMaxWidth().heightIn(min = 44.dp),
        horizontalArrangement = Arrangement.spacedBy(16.dp),
        verticalAlignment = Alignment.CenterVertically,
    ) {
        Text(label, modifier = Modifier.weight(1f))
        content()
    }
}

@Composable
fun HapticsControls() {
    var wifi by rememberSaveable { mutableStateOf(true) }
    var terms by rememberSaveable { mutableStateOf(false) }
    var volume by rememberSaveable { mutableFloatStateOf(40f) }
    var copies by rememberSaveable { mutableDoubleStateOf(1.0) }
    var openNow by rememberSaveable { mutableStateOf(false) }
    var topRated by rememberSaveable { mutableStateOf(false) }
    Column(Modifier.fillMaxWidth(), verticalArrangement = Arrangement.spacedBy(8.dp)) {
        HapticsRow("Wi-Fi") {
            Switch(wifi, { wifi = it }, Modifier.semantics { contentDescription = "Wi-Fi" })
        }
        HapticsRow("Accept terms") {
            Checkbox(terms, { terms = it }, Modifier.semantics { contentDescription = "Accept terms" })
        }
        HapticsRow("Copies") {
            Stepper(copies, { copies = it }, min = 1.0, max = 9.0) {
                StepperInput(contentDescription = "Copies")
                StepperGroup {
                    StepperDecrement()
                    StepperSeparator()
                    StepperIncrement()
                }
            }
        }
        Row(Modifier.padding(vertical = 8.dp), horizontalArrangement = Arrangement.spacedBy(8.dp)) {
            Chip("Open now", openNow, { openNow = it })
            Chip("Top rated", topRated, { topRated = it })
        }
        Slider(volume, { volume = it }, step = 10f, contentDescription = "Volume")
    }
}

@Composable
fun HapticsControlsDemo(enabled: Boolean) {
    HapticsLogging { log ->
        ProvideHaptics(enabled = enabled) {
            Column(Modifier.fillMaxWidth(), verticalArrangement = Arrangement.spacedBy(16.dp)) {
                HapticsLogRow(log)
                HapticsControls()
            }
        }
    }
}
```

Components such as Amount Input, Chart and Context Menu play haptic feedback through `useHaptics()`. By default nothing happens: `HapticsProvider` lets you plug in an adapter that calls the haptics library of your choice, so the components stay free of a native dependency.

The adapter has three methods: `impact(style)` with `light`, `medium`, `heavy`, `soft` or `rigid`; `selection()`; and `notification(type)` with `success`, `warning` or `error`.

## Installation

```bash title="Terminal"
npx @esuiss/uim@latest add haptics
```

```bash title="Terminal"
npx @esuiss/uim@latest add haptics --platform swift
```

```bash title="Terminal"
npx @esuiss/uim@latest add haptics --platform kotlin
```

### Manual

**Uniwind**

1. Add the pieces it builds on: the primitives `components/primitives/haptics.tsx`.

2. Copy the source into `components/ui/haptics.tsx`:

```tsx title="uniwind/components/ui/haptics.tsx"
import * as React from "react"
import {
  type HapticsAdapter,
  HapticsContext,
  type HapticsContextValue,
  type HapticsImpactStyle,
  type HapticsNotificationType,
  NOOP_HAPTICS_ADAPTER,
  useHaptics,
} from "@/components/primitives/haptics"

function HapticsProvider({
  adapter,
  enabled = true,
  children,
}: {
  adapter?: HapticsAdapter | null
  enabled?: boolean
  children?: React.ReactNode
}) {
  const value = React.useMemo<HapticsContextValue>(
    () => ({ adapter: adapter ?? NOOP_HAPTICS_ADAPTER, enabled }),
    [adapter, enabled]
  )
  return (
    <HapticsContext.Provider value={value}>{children}</HapticsContext.Provider>
  )
}

export type { HapticsAdapter, HapticsImpactStyle, HapticsNotificationType }
export { HapticsProvider, useHaptics }
```

3. Update the import paths to match your project.

**NativeWind**

1. Add the pieces it builds on: the primitives `components/primitives/haptics.tsx`.

2. Copy the source into `components/ui/haptics.tsx`:

```tsx title="nativewind/components/ui/haptics.tsx"
import * as React from "react"
import {
  type HapticsAdapter,
  HapticsContext,
  type HapticsContextValue,
  type HapticsImpactStyle,
  type HapticsNotificationType,
  NOOP_HAPTICS_ADAPTER,
  useHaptics,
} from "@/components/primitives/haptics"

function HapticsProvider({
  adapter,
  enabled = true,
  children,
}: {
  adapter?: HapticsAdapter | null
  enabled?: boolean
  children?: React.ReactNode
}) {
  const value = React.useMemo<HapticsContextValue>(
    () => ({ adapter: adapter ?? NOOP_HAPTICS_ADAPTER, enabled }),
    [adapter, enabled]
  )
  return (
    <HapticsContext.Provider value={value}>{children}</HapticsContext.Provider>
  )
}

export type { HapticsAdapter, HapticsImpactStyle, HapticsNotificationType }
export { HapticsProvider, useHaptics }
```

3. Update the import paths to match your project.

**StyleSheet**

1. Add the pieces it builds on: the primitives `components/primitives/haptics.tsx`.

2. Copy the source into `components/ui/haptics.tsx`:

```tsx title="stylesheet/components/ui/haptics.tsx"
import * as React from "react"
import {
  type HapticsAdapter,
  HapticsContext,
  type HapticsContextValue,
  type HapticsImpactStyle,
  type HapticsNotificationType,
  NOOP_HAPTICS_ADAPTER,
  useHaptics,
} from "@/components/primitives/haptics"

function HapticsProvider({
  adapter,
  enabled = true,
  children,
}: {
  adapter?: HapticsAdapter | null
  enabled?: boolean
  children?: React.ReactNode
}) {
  const value = React.useMemo<HapticsContextValue>(
    () => ({ adapter: adapter ?? NOOP_HAPTICS_ADAPTER, enabled }),
    [adapter, enabled]
  )
  return (
    <HapticsContext.Provider value={value}>{children}</HapticsContext.Provider>
  )
}

export type { HapticsAdapter, HapticsImpactStyle, HapticsNotificationType }
export { HapticsProvider, useHaptics }
```

3. Update the import paths to match your project.

**SwiftUI**

1. Target iOS 17 or later.

2. Copy the theme files every view uses:

```swift title="swift/Theme/Theme.swift"
import SwiftUI
import UIKit

struct RGBA: Sendable {
  let red: CGFloat
  let green: CGFloat
  let blue: CGFloat
  let alpha: CGFloat

  init(_ hex: UInt32, _ alpha: CGFloat = 1) {
    red = CGFloat((hex >> 16) & 0xFF) / 255
    green = CGFloat((hex >> 8) & 0xFF) / 255
    blue = CGFloat(hex & 0xFF) / 255
    self.alpha = alpha
  }

  var uiColor: UIColor {
    UIColor(red: red, green: green, blue: blue, alpha: alpha)
  }
}

extension Color {
  static func adaptive(light: RGBA, dark: RGBA) -> Color {
    let lightColor = light.uiColor
    let darkColor = dark.uiColor
    return Color(uiColor: UIColor { traits in
      traits.userInterfaceStyle == .dark ? darkColor : lightColor
    })
  }
}

public struct TextStyle: Sendable, Hashable {
  public let size: CGFloat
  public let lineHeight: CGFloat
  public let letterSpacing: CGFloat

  public init(size: CGFloat, lineHeight: CGFloat, letterSpacing: CGFloat) {
    self.size = size
    self.lineHeight = lineHeight
    self.letterSpacing = letterSpacing
  }

  public func font(weight: Font.Weight = .regular) -> Font {
    .system(size: size, weight: weight)
  }

  public var lineSpacing: CGFloat {
    max(0, lineHeight - UIFont.systemFont(ofSize: size).lineHeight)
  }
}

extension Hashable where Self == Font {
  public static func textStyle(_ style: TextStyle, weight: Font.Weight = .regular) -> Font {
    style.font(weight: weight)
  }
}

private struct TextStyleModifier: ViewModifier {
  let style: TextStyle
  let weight: Font.Weight

  func body(content: Content) -> some View {
    content
      .font(style.font(weight: weight))
      .tracking(style.letterSpacing)
      .lineSpacing(style.lineSpacing)
      .padding(.vertical, style.lineSpacing / 2)
  }
}

extension View {
  public func textStyle(_ style: TextStyle, weight: Font.Weight = .regular) -> some View {
    modifier(TextStyleModifier(style: style, weight: weight))
  }
}

public struct Shadow: Sendable, Hashable {
  public let color: Color
  public let radius: CGFloat
  public let x: CGFloat
  public let y: CGFloat

  public init(color: Color, radius: CGFloat, x: CGFloat = 0, y: CGFloat = 0) {
    self.color = color
    self.radius = radius
    self.x = x
    self.y = y
  }
}

extension View {
  public func shadow(_ shadow: Shadow) -> some View {
    self.shadow(color: shadow.color, radius: shadow.radius, x: shadow.x, y: shadow.y)
  }
}
```

```swift title="swift/Theme/Tokens.swift"
import SwiftUI

extension Color {
  public static let surface = Color.adaptive(light: .init(0xFFFFFF), dark: .init(0x000000))
  public static let surfaceSecondary = Color.adaptive(light: .init(0xF5F5F7), dark: .init(0x161617))
  public static let surfaceTertiary = Color.adaptive(light: .init(0xE8E8ED), dark: .init(0x2C2C2E))
  public static let surfaceRaised = Color.adaptive(light: .init(0xFFFFFF), dark: .init(0x1D1D1F))
  public static let label = Color.adaptive(light: .init(0x1D1D1F), dark: .init(0xF5F5F7))
  public static let labelSecondary = Color.adaptive(light: .init(0x6E6E73), dark: .init(0xA1A1A6))
  public static let labelTertiary = Color.adaptive(light: .init(0x86868B), dark: .init(0x86868B))
  public static let labelQuaternary = Color.adaptive(light: .init(0xD2D2D7), dark: .init(0x424245))
  public static let control = Color.adaptive(light: .init(0x000000, 0.04), dark: .init(0xFFFFFF, 0.1))
  public static let controlPressed = Color.adaptive(light: .init(0x000000, 0.12), dark: .init(0xFFFFFF, 0.22))
  public static let controlSelected = Color.adaptive(light: .init(0x1D1D1F), dark: .init(0xF5F5F7))
  public static let controlDisabled = Color.adaptive(light: .init(0x000000, 0.03), dark: .init(0xFFFFFF, 0.05))
  public static let onControlSelected = Color.adaptive(light: .init(0xFFFFFF), dark: .init(0x000000))
  public static let itemPressed = Color.adaptive(light: .init(0x000000, 0.08), dark: .init(0xFFFFFF, 0.12))
  public static let itemSelected = Color.adaptive(light: .init(0x000000, 0.06), dark: .init(0xFFFFFF, 0.1))
  public static let separator = Color.adaptive(light: .init(0xD2D2D7), dark: .init(0x424245))
  public static let separatorStrong = Color.adaptive(light: .init(0x86868B), dark: .init(0x6E6E73))
  public static let accent = Color.adaptive(light: .init(0x0071E3), dark: .init(0x0071E3))
  public static let accentPressed = Color.adaptive(light: .init(0x005BB8), dark: .init(0x004D9E))
  public static let accentSelected = Color.adaptive(light: .init(0x0071E3), dark: .init(0x0071E3))
  public static let accentDisabled = Color.adaptive(light: .init(0x0071E3, 0.4), dark: .init(0x0071E3, 0.4))
  public static let onAccent = Color.adaptive(light: .init(0xFFFFFF), dark: .init(0xFFFFFF))
  public static let accentSurface = Color.adaptive(light: .init(0x0071E3, 0.09), dark: .init(0x0071E3, 0.18))
  public static let accentSurfacePressed = Color.adaptive(light: .init(0x0071E3, 0.18), dark: .init(0x0071E3, 0.3))
  public static let link = Color.adaptive(light: .init(0x0066CC), dark: .init(0x2997FF))
  public static let focus = Color.adaptive(light: .init(0x0071E3), dark: .init(0x0071E3))
  public static let scrim = Color.adaptive(light: .init(0x000000, 0.48), dark: .init(0x000000, 0.48))
  public static let media = Color.adaptive(light: .init(0x000000), dark: .init(0x000000))
  public static let onMedia = Color.adaptive(light: .init(0xFFFFFF), dark: .init(0xFFFFFF))
  public static let danger = Color.adaptive(light: .init(0xD0000A), dark: .init(0xFF5447))
  public static let dangerSurface = Color.adaptive(light: .init(0xD70015, 0.08), dark: .init(0xFF453A, 0.2))
  public static let dangerSurfacePressed = Color.adaptive(light: .init(0xD70015, 0.16), dark: .init(0xFF453A, 0.36))
  public static let success = Color.adaptive(light: .init(0x008009), dark: .init(0x30D158))
  public static let successSurface = Color.adaptive(light: .init(0xEFFAF1), dark: .init(0x30D158, 0.16))
  public static let warning = Color.adaptive(light: .init(0xB64400), dark: .init(0xFF9F0A))
  public static let warningSurface = Color.adaptive(light: .init(0xFFF5EA), dark: .init(0xFF9F0A, 0.16))
}

public enum Radius {
  public static let xs: CGFloat = 3
  public static let sm: CGFloat = 5
  public static let md: CGFloat = 8
  public static let lg: CGFloat = 10
  public static let xl: CGFloat = 12
  public static let xl2: CGFloat = 18
  public static let xl3: CGFloat = 28
  public static let full: CGFloat = 9999
}

extension TextStyle {
  public static let xs3 = TextStyle(size: 11, lineHeight: 13, letterSpacing: 0.066)
  public static let xs2 = TextStyle(size: 12, lineHeight: 16, letterSpacing: 0)
  public static let xs = TextStyle(size: 13, lineHeight: 18, letterSpacing: -0.078)
  public static let sm = TextStyle(size: 15, lineHeight: 20, letterSpacing: -0.24)
  public static let md = TextStyle(size: 16, lineHeight: 21, letterSpacing: -0.32)
  public static let base = TextStyle(size: 17, lineHeight: 22, letterSpacing: -0.442)
  public static let lg = TextStyle(size: 20, lineHeight: 25, letterSpacing: -0.46)
  public static let xl = TextStyle(size: 22, lineHeight: 28, letterSpacing: -0.264)
  public static let xl2 = TextStyle(size: 28, lineHeight: 34, letterSpacing: 0.392)
  public static let xl3 = TextStyle(size: 34, lineHeight: 41, letterSpacing: 0.408)

  public static let allCases: [TextStyle] = [.xs3, .xs2, .xs, .sm, .md, .base, .lg, .xl, .xl2, .xl3]
}

extension Shadow {
  public static let md = Shadow(color: .black.opacity(0.08), radius: 6, x: 2, y: 4)
  public static let lg = Shadow(color: .black.opacity(0.12), radius: 12, y: 4)
}
```

3. Copy the source:

```swift title="swift/Components/Haptics.swift"
import SwiftUI

extension EnvironmentValues {
  @Entry public var hapticsEnabled = true
}

extension View {
  public func haptics(_ enabled: Bool) -> some View {
    environment(\.hapticsEnabled, enabled)
  }

  func hapticFeedback<Trigger: Equatable>(_ feedback: SensoryFeedback, trigger: Trigger) -> some View {
    modifier(HapticFeedbackModifier(feedback: feedback, trigger: trigger) { _, _ in true })
  }

  func hapticFeedback<Trigger: Equatable>(
    _ feedback: SensoryFeedback,
    trigger: Trigger,
    condition: @escaping (Trigger, Trigger) -> Bool
  ) -> some View {
    modifier(HapticFeedbackModifier(feedback: feedback, trigger: trigger, condition: condition))
  }
}

private struct HapticFeedbackModifier<Trigger: Equatable>: ViewModifier {
  let feedback: SensoryFeedback
  let trigger: Trigger
  let condition: (Trigger, Trigger) -> Bool

  @Environment(\.hapticsEnabled) private var enabled

  func body(content: Content) -> some View {
    let enabled = enabled
    let condition = condition
    content.sensoryFeedback(feedback, trigger: trigger) { old, new in
      enabled && condition(old, new)
    }
  }
}

enum HapticMoments {
  static func step(_ value: Double, bounds: ClosedRange<Double>, step: Double?) -> Int? {
    guard let step, step > 0 else { return nil }
    return Int(((value - bounds.lowerBound) / step).rounded())
  }

  static func lifted<Value: Equatable>(_ old: Value?, _ new: Value?) -> Bool {
    new != nil && old != new
  }

  static func crossed<Value: Equatable>(_ old: Value?, _ new: Value?) -> Bool {
    old == nil && new != nil
  }

  static func moved(_ old: Int?, _ new: Int?) -> Bool {
    guard let old, let new else { return false }
    return old != new
  }
}

struct HapticButton<Style: ButtonStyle>: View {
  let feedback: SensoryFeedback
  let action: () -> Bool
  let style: Style

  @State private var count = 0

  init(_ feedback: SensoryFeedback = .selection, style: Style, action: @escaping () -> Bool) {
    self.feedback = feedback
    self.style = style
    self.action = action
  }

  var body: some View {
    Button {
      if action() { count += 1 }
    } label: {
      EmptyView()
    }
    .buttonStyle(style)
    .hapticFeedback(feedback, trigger: count)
  }
}
```

4. Add the files to your app target.

**Jetpack Compose**

1. Set `minSdk` to 24 or higher and add the dependencies:

```kotlin title="build.gradle.kts"
implementation(platform("androidx.compose:compose-bom:2026.09.00"))
implementation("androidx.compose.foundation:foundation")
implementation("androidx.compose.ui:ui")
```

2. Copy the theme files every view uses:

```kt title="kotlin/theme/Theme.kt"
package com.esuiss.ui.theme

import androidx.compose.foundation.isSystemInDarkTheme
import androidx.compose.runtime.Composable
import androidx.compose.runtime.CompositionLocalProvider
import androidx.compose.runtime.Immutable
import androidx.compose.runtime.staticCompositionLocalOf
import androidx.compose.ui.Modifier
import androidx.compose.ui.draw.dropShadow
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.graphics.Shape
import androidx.compose.ui.graphics.shadow.Shadow as DropShadow
import androidx.compose.ui.text.TextStyle
import androidx.compose.ui.text.style.LineHeightStyle
import androidx.compose.ui.unit.Dp
import androidx.compose.ui.unit.DpOffset
import androidx.compose.ui.unit.em
import androidx.compose.ui.unit.sp

internal fun textStyle(size: Double, lineHeight: Double, letterSpacing: Double) = TextStyle(
    fontSize = size.sp,
    lineHeight = lineHeight.sp,
    letterSpacing = letterSpacing.em,
    lineHeightStyle = LineHeightStyle(
        alignment = LineHeightStyle.Alignment.Center,
        trim = LineHeightStyle.Trim.None,
    ),
)

@Immutable
data class Shadow(
    val offsetX: Dp,
    val offsetY: Dp,
    val blur: Dp,
    val color: Color,
)

fun Modifier.shadow(shadow: Shadow, shape: Shape): Modifier = dropShadow(
    shape,
    DropShadow(
        radius = shadow.blur,
        color = shadow.color,
        offset = DpOffset(shadow.offsetX, shadow.offsetY),
    ),
)

val LocalColors = staticCompositionLocalOf { LightColors }

object EsuissTheme {
    val colors: Colors
        @Composable get() = LocalColors.current

    val typography: Typography
        get() = Typography

    val radius: Radius
        get() = Radius

    val shadows: Shadows
        get() = Shadows
}

@Composable
fun EsuissTheme(
    darkTheme: Boolean = isSystemInDarkTheme(),
    content: @Composable () -> Unit,
) {
    CompositionLocalProvider(
        LocalColors provides if (darkTheme) DarkColors else LightColors,
        content = content,
    )
}
```

```kt title="kotlin/theme/Tokens.kt"
package com.esuiss.ui.theme

import androidx.compose.runtime.Immutable
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.unit.dp

@Immutable
data class Colors(
    val surface: Color,
    val surfaceSecondary: Color,
    val surfaceTertiary: Color,
    val surfaceRaised: Color,
    val label: Color,
    val labelSecondary: Color,
    val labelTertiary: Color,
    val labelQuaternary: Color,
    val control: Color,
    val controlPressed: Color,
    val controlSelected: Color,
    val controlDisabled: Color,
    val onControlSelected: Color,
    val itemPressed: Color,
    val itemSelected: Color,
    val separator: Color,
    val separatorStrong: Color,
    val accent: Color,
    val accentPressed: Color,
    val accentSelected: Color,
    val accentDisabled: Color,
    val onAccent: Color,
    val accentSurface: Color,
    val accentSurfacePressed: Color,
    val link: Color,
    val focus: Color,
    val scrim: Color,
    val media: Color,
    val onMedia: Color,
    val danger: Color,
    val dangerSurface: Color,
    val dangerSurfacePressed: Color,
    val success: Color,
    val successSurface: Color,
    val warning: Color,
    val warningSurface: Color,
    val blue: Color,
    val green: Color,
    val orange: Color,
    val red: Color,
    val yellow: Color,
    val purple: Color,
    val pink: Color,
    val indigo: Color,
    val teal: Color,
    val mint: Color,
    val cyan: Color,
    val brown: Color,
    val gray: Color,
    val isDark: Boolean,
)

val LightColors = Colors(
    surface = Color(0xFFFFFFFF),
    surfaceSecondary = Color(0xFFF5F5F7),
    surfaceTertiary = Color(0xFFE8E8ED),
    surfaceRaised = Color(0xFFFFFFFF),
    label = Color(0xFF1D1D1F),
    labelSecondary = Color(0xFF6E6E73),
    labelTertiary = Color(0xFF86868B),
    labelQuaternary = Color(0xFFD2D2D7),
    control = Color(0xFF000000).copy(alpha = 0.04f),
    controlPressed = Color(0xFF000000).copy(alpha = 0.12f),
    controlSelected = Color(0xFF1D1D1F),
    controlDisabled = Color(0xFF000000).copy(alpha = 0.03f),
    onControlSelected = Color(0xFFFFFFFF),
    itemPressed = Color(0xFF000000).copy(alpha = 0.08f),
    itemSelected = Color(0xFF000000).copy(alpha = 0.06f),
    separator = Color(0xFFD2D2D7),
    separatorStrong = Color(0xFF86868B),
    accent = Color(0xFF0071E3),
    accentPressed = Color(0xFF005BB8),
    accentSelected = Color(0xFF0071E3),
    accentDisabled = Color(0xFF0071E3).copy(alpha = 0.4f),
    onAccent = Color(0xFFFFFFFF),
    accentSurface = Color(0xFF0071E3).copy(alpha = 0.09f),
    accentSurfacePressed = Color(0xFF0071E3).copy(alpha = 0.18f),
    link = Color(0xFF0066CC),
    focus = Color(0xFF0071E3),
    scrim = Color(0xFF000000).copy(alpha = 0.48f),
    media = Color(0xFF000000),
    onMedia = Color(0xFFFFFFFF),
    danger = Color(0xFFD0000A),
    dangerSurface = Color(0xFFD70015).copy(alpha = 0.08f),
    dangerSurfacePressed = Color(0xFFD70015).copy(alpha = 0.16f),
    success = Color(0xFF008009),
    successSurface = Color(0xFFEFFAF1),
    warning = Color(0xFFB64400),
    warningSurface = Color(0xFFFFF5EA),
    blue = Color(0xFF007AFF),
    green = Color(0xFF34C759),
    orange = Color(0xFFFF9500),
    red = Color(0xFFFF3B30),
    yellow = Color(0xFFFFCC00),
    purple = Color(0xFFAF52DE),
    pink = Color(0xFFFF2D55),
    indigo = Color(0xFF5856D6),
    teal = Color(0xFF30B0C7),
    mint = Color(0xFF00C7BE),
    cyan = Color(0xFF32ADE6),
    brown = Color(0xFFA2845E),
    gray = Color(0xFF8E8E93),
    isDark = false,
)

val DarkColors = Colors(
    surface = Color(0xFF000000),
    surfaceSecondary = Color(0xFF161617),
    surfaceTertiary = Color(0xFF2C2C2E),
    surfaceRaised = Color(0xFF1D1D1F),
    label = Color(0xFFF5F5F7),
    labelSecondary = Color(0xFFA1A1A6),
    labelTertiary = Color(0xFF86868B),
    labelQuaternary = Color(0xFF424245),
    control = Color(0xFFFFFFFF).copy(alpha = 0.1f),
    controlPressed = Color(0xFFFFFFFF).copy(alpha = 0.22f),
    controlSelected = Color(0xFFF5F5F7),
    controlDisabled = Color(0xFFFFFFFF).copy(alpha = 0.05f),
    onControlSelected = Color(0xFF000000),
    itemPressed = Color(0xFFFFFFFF).copy(alpha = 0.12f),
    itemSelected = Color(0xFFFFFFFF).copy(alpha = 0.1f),
    separator = Color(0xFF424245),
    separatorStrong = Color(0xFF6E6E73),
    accent = Color(0xFF0071E3),
    accentPressed = Color(0xFF004D9E),
    accentSelected = Color(0xFF0071E3),
    accentDisabled = Color(0xFF0071E3).copy(alpha = 0.4f),
    onAccent = Color(0xFFFFFFFF),
    accentSurface = Color(0xFF0071E3).copy(alpha = 0.18f),
    accentSurfacePressed = Color(0xFF0071E3).copy(alpha = 0.3f),
    link = Color(0xFF2997FF),
    focus = Color(0xFF0071E3),
    scrim = Color(0xFF000000).copy(alpha = 0.48f),
    media = Color(0xFF000000),
    onMedia = Color(0xFFFFFFFF),
    danger = Color(0xFFFF5447),
    dangerSurface = Color(0xFFFF453A).copy(alpha = 0.2f),
    dangerSurfacePressed = Color(0xFFFF453A).copy(alpha = 0.36f),
    success = Color(0xFF30D158),
    successSurface = Color(0xFF30D158).copy(alpha = 0.16f),
    warning = Color(0xFFFF9F0A),
    warningSurface = Color(0xFFFF9F0A).copy(alpha = 0.16f),
    blue = Color(0xFF0A84FF),
    green = Color(0xFF30D158),
    orange = Color(0xFFFF9F0A),
    red = Color(0xFFFF453A),
    yellow = Color(0xFFFFD60A),
    purple = Color(0xFFBF5AF2),
    pink = Color(0xFFFF375F),
    indigo = Color(0xFF5E5CE6),
    teal = Color(0xFF40C8E0),
    mint = Color(0xFF66D4CF),
    cyan = Color(0xFF64D2FF),
    brown = Color(0xFFAC8E68),
    gray = Color(0xFF8E8E93),
    isDark = true,
)

object Radius {
    val xs = 3.dp
    val sm = 5.dp
    val md = 8.dp
    val lg = 10.dp
    val xl = 12.dp
    val xl2 = 18.dp
    val xl3 = 28.dp
    val full = 9999.dp
}

object Typography {
    val xs3 = textStyle(11.0, 13.0, 0.006)
    val xs2 = textStyle(12.0, 16.0, 0.0)
    val xs = textStyle(13.0, 18.0, -0.006)
    val sm = textStyle(15.0, 20.0, -0.016)
    val md = textStyle(16.0, 21.0, -0.02)
    val base = textStyle(17.0, 22.0, -0.026)
    val lg = textStyle(20.0, 25.0, -0.023)
    val xl = textStyle(22.0, 28.0, -0.012)
    val xl2 = textStyle(28.0, 34.0, 0.014)
    val xl3 = textStyle(34.0, 41.0, 0.012)

    val all = listOf(xs3, xs2, xs, sm, md, base, lg, xl, xl2, xl3)
}

object Shadows {
    val md = Shadow(2.dp, 4.dp, 12.dp, Color.Black.copy(alpha = 0.08f))
    val lg = Shadow(0.dp, 4.dp, 24.dp, Color.Black.copy(alpha = 0.12f))
}
```

3. Copy the source:

```kt title="kotlin/components/Haptics.kt"
package com.esuiss.ui.components

import androidx.compose.runtime.Composable
import androidx.compose.runtime.CompositionLocalProvider
import androidx.compose.runtime.remember
import androidx.compose.runtime.staticCompositionLocalOf
import androidx.compose.ui.hapticfeedback.HapticFeedback
import androidx.compose.ui.hapticfeedback.HapticFeedbackType
import androidx.compose.ui.platform.LocalHapticFeedback

val LocalHapticsEnabled = staticCompositionLocalOf { true }

@Composable
fun ProvideHaptics(enabled: Boolean, content: @Composable () -> Unit) {
    CompositionLocalProvider(LocalHapticsEnabled provides enabled, content = content)
}

internal class Haptics(private val feedback: HapticFeedback, private val enabled: Boolean) {
    fun perform(type: HapticFeedbackType) {
        if (enabled) feedback.performHapticFeedback(type)
    }

    fun toggle(on: Boolean) = perform(if (on) HapticFeedbackType.ToggleOn else HapticFeedbackType.ToggleOff)

    fun selection() = perform(HapticFeedbackType.SegmentTick)
}

@Composable
internal fun rememberHaptics(): Haptics {
    val feedback = LocalHapticFeedback.current
    val enabled = LocalHapticsEnabled.current
    return remember(feedback, enabled) { Haptics(feedback, enabled) }
}
```

4. Update the `com.esuiss.ui` package names to match your project.

## Usage

```tsx
import { HapticsProvider } from "@/components/ui/haptics"
```

```tsx
<ControlsDemo />
```

Wrap your app in `HapticsProvider` and pass an `adapter` object that implements `impact`, `selection` and `notification`. Set `enabled={false}` to turn all feedback off, for example from a user setting.

Call `useHaptics()` in your own components to get the same methods. Without a provider, or when disabled, they do nothing.

## Examples

### Feedback

Buttons for each impact, selection and notification type.

![Preview](https://uim.suiss.app/previews/components-haptics--feedback.light.webp)

```tsx
import * as React from "react"
import { View } from "react-native"
import { Button } from "@/components/ui/button"
import { type HapticsAdapter, HapticsProvider, useHaptics } from "@/components/ui/haptics"
import { Text } from "@/components/ui/text"

function useLoggingAdapter() {
  const [log, setLog] = React.useState({ last: "None", count: 0 })
  const adapter = React.useMemo<HapticsAdapter>(() => {
    const record = (event: string) =>
      setLog((current) => ({ last: event, count: current.count + 1 }))
    return {
      impact: (style) => record(`impact ${style}`),
      selection: () => record("selection"),
      notification: (type) => record(`notification ${type}`),
    }
  }, [])
  return { adapter, log }
}

function HapticLog({ last, count }: { last: string; count: number }) {
  return (
    <View className="flex-row items-center justify-between rounded-xl bg-surface-secondary px-4 py-3">
      <Text className="text-sm text-label-secondary">Last haptic</Text>
      <Text
        role="status"
        accessibilityLiveRegion="polite"
        className="text-sm font-medium"
      >
        {count > 0 ? `${last} (${count})` : last}
      </Text>
    </View>
  )
}

function FeedbackButtons() {
  const haptics = useHaptics()
  return (
    <View className="w-full gap-3">
      <Text variant="muted">Impact</Text>
      <View className="flex-row flex-wrap gap-2">
        {(["light", "medium", "heavy", "soft", "rigid"] as const).map(
          (style) => (
            <Button
              key={style}
              size="sm"
              variant="secondary"
              onPress={() => haptics.impact(style)}
            >
              {style}
            </Button>
          )
        )}
      </View>
      <Text variant="muted">Selection</Text>
      <View className="flex-row flex-wrap gap-2">
        <Button
          size="sm"
          variant="secondary"
          onPress={() => haptics.selection()}
        >
          selection
        </Button>
      </View>
      <Text variant="muted">Notification</Text>
      <View className="flex-row flex-wrap gap-2">
        {(["success", "warning", "error"] as const).map((type) => (
          <Button
            key={type}
            size="sm"
            variant="secondary"
            onPress={() => haptics.notification(type)}
          >
            {type}
          </Button>
        ))}
      </View>
    </View>
  )
}

function FeedbackDemo() {
  const { adapter, log } = useLoggingAdapter()
  return (
    <HapticsProvider adapter={adapter}>
      <View className="w-full gap-4">
        <HapticLog {...log} />
        <FeedbackButtons />
      </View>
    </HapticsProvider>
  )
}

export function HapticsFeedbackExample() {
  return (
    <FeedbackDemo />
  )
}
```

```swift
import EsuissUI
import SwiftUI

struct HapticsLog: View {
  let last: String
  let count: Int

  var body: some View {
    HStack {
      Text("Last haptic")
        .textStyle(.sm)
        .foregroundStyle(Color.labelSecondary)
      Spacer(minLength: 16)
      Text(verbatim: count > 0 ? "\(last) (\(count))" : last)
        .textStyle(.sm, weight: .medium)
        .foregroundStyle(Color.label)
        .accessibilityAddTraits(.updatesFrequently)
    }
    .padding(.horizontal, 16)
    .padding(.vertical, 12)
    .background(Color.surfaceSecondary, in: RoundedRectangle(cornerRadius: Radius.xl, style: .continuous))
  }
}

struct HapticsFeedbackDemo: View {
  struct Entry: Identifiable {
    let id: String
    let feedback: SensoryFeedback
  }

  private static let impacts = [
    Entry(id: "light", feedback: .impact(weight: .light)),
    Entry(id: "medium", feedback: .impact(weight: .medium)),
    Entry(id: "heavy", feedback: .impact(weight: .heavy)),
    Entry(id: "soft", feedback: .impact(flexibility: .soft)),
    Entry(id: "rigid", feedback: .impact(flexibility: .rigid)),
  ]

  private static let notifications = [
    Entry(id: "success", feedback: .success),
    Entry(id: "warning", feedback: .warning),
    Entry(id: "error", feedback: .error),
  ]

  @State private var last = "None"
  @State private var count = 0

  var body: some View {
    VStack(alignment: .leading, spacing: 16) {
      HapticsLog(last: last, count: count)
      VStack(alignment: .leading, spacing: 12) {
        Text("Impact").textVariant(.muted)
        FlowRow(spacing: 8) {
          ForEach(Self.impacts) { entry in
            HapticsFeedbackButton(title: entry.id, feedback: entry.feedback) { record("impact \(entry.id)") }
          }
        }
        Text("Selection").textVariant(.muted)
        FlowRow(spacing: 8) {
          HapticsFeedbackButton(title: "selection", feedback: .selection) { record("selection") }
        }
        Text("Notification").textVariant(.muted)
        FlowRow(spacing: 8) {
          ForEach(Self.notifications) { entry in
            HapticsFeedbackButton(title: entry.id, feedback: entry.feedback) { record("notification \(entry.id)") }
          }
        }
      }
    }
  }

  func record(_ event: String) {
    last = event
    count += 1
  }
}

struct HapticsFeedbackButton: View {
  let title: String
  let feedback: SensoryFeedback
  let action: () -> Void

  @State private var trigger = 0

  var body: some View {
    Button(title) {
      trigger += 1
      action()
    }
    .buttonStyle(.variant(.secondary, size: .sm))
    .sensoryFeedback(feedback, trigger: trigger)
  }
}

let impacts = [
  Entry(id: "light", feedback: .impact(weight: .light)),
  Entry(id: "medium", feedback: .impact(weight: .medium)),
  Entry(id: "heavy", feedback: .impact(weight: .heavy)),
  Entry(id: "soft", feedback: .impact(flexibility: .soft)),
  Entry(id: "rigid", feedback: .impact(flexibility: .rigid)),
]

let notifications = [
  Entry(id: "success", feedback: .success),
  Entry(id: "warning", feedback: .warning),
  Entry(id: "error", feedback: .error),
]
```

### Reorder

Feedback while dragging items in a reorder list.

![Preview](https://uim.suiss.app/previews/components-haptics--reorder.light.webp)

```tsx
import * as React from "react"
import { View } from "react-native"
import { ReorderList, ReorderListHandle, ReorderListItem } from "@/components/interactions/reorder-list"
import { type HapticsAdapter, HapticsProvider } from "@/components/ui/haptics"
import { Text } from "@/components/ui/text"

function useLoggingAdapter() {
  const [log, setLog] = React.useState({ last: "None", count: 0 })
  const adapter = React.useMemo<HapticsAdapter>(() => {
    const record = (event: string) =>
      setLog((current) => ({ last: event, count: current.count + 1 }))
    return {
      impact: (style) => record(`impact ${style}`),
      selection: () => record("selection"),
      notification: (type) => record(`notification ${type}`),
    }
  }, [])
  return { adapter, log }
}

function HapticLog({ last, count }: { last: string; count: number }) {
  return (
    <View className="flex-row items-center justify-between rounded-xl bg-surface-secondary px-4 py-3">
      <Text className="text-sm text-label-secondary">Last haptic</Text>
      <Text
        role="status"
        accessibilityLiveRegion="polite"
        className="text-sm font-medium"
      >
        {count > 0 ? `${last} (${count})` : last}
      </Text>
    </View>
  )
}

const tasks = ["Inbox", "Today", "Upcoming", "Someday"]

function ReorderDemo() {
  const { adapter, log } = useLoggingAdapter()
  const [value, setValue] = React.useState(tasks)
  return (
    <HapticsProvider adapter={adapter}>
      <View className="w-full gap-4">
        <HapticLog {...log} />
        <ReorderList
          value={value}
          onValueChange={setValue}
          className="overflow-hidden rounded-2xl border border-separator"
        >
          {value.map((task) => (
            <ReorderListItem key={task} value={task} className="ps-4">
              <View className="min-w-0 grow py-3">
                <Text numberOfLines={1}>{task}</Text>
              </View>
              <ReorderListHandle accessibilityLabel={`Reorder ${task}`} />
            </ReorderListItem>
          ))}
        </ReorderList>
      </View>
    </HapticsProvider>
  )
}

export function HapticsReorderExample() {
  return (
    <ReorderDemo />
  )
}
```

```swift
import EsuissUI
import SwiftUI

struct HapticsReorderDemo: View {
  @State private var tasks = ["Inbox", "Today", "Upcoming", "Someday"]

  var body: some View {
    ReorderList($tasks) { task in
      Text(verbatim: task)
        .textStyle(.base)
        .foregroundStyle(Color.label)
        .lineLimit(1)
        .padding(.vertical, 12)
    }
    .clipShape(RoundedRectangle(cornerRadius: Radius.xl2, style: .continuous))
    .overlay {
      RoundedRectangle(cornerRadius: Radius.xl2, style: .continuous)
        .strokeBorder(Color.separator)
    }
  }
}
```

```kotlin
import androidx.compose.foundation.background
import androidx.compose.foundation.border
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.runtime.Composable
import androidx.compose.runtime.CompositionLocalProvider
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableIntStateOf
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.draw.clip
import androidx.compose.ui.hapticfeedback.HapticFeedback
import androidx.compose.ui.hapticfeedback.HapticFeedbackType
import androidx.compose.ui.platform.LocalHapticFeedback
import androidx.compose.ui.semantics.LiveRegionMode
import androidx.compose.ui.semantics.contentDescription
import androidx.compose.ui.semantics.liveRegion
import androidx.compose.ui.semantics.semantics
import androidx.compose.ui.text.font.FontWeight
import androidx.compose.ui.text.style.TextOverflow
import androidx.compose.ui.unit.dp
import com.esuiss.ui.components.Text
import com.esuiss.ui.interactions.ReorderList
import com.esuiss.ui.interactions.ReorderListHandle
import com.esuiss.ui.interactions.ReorderListItem
import com.esuiss.ui.theme.EsuissTheme
import com.esuiss.ui.theme.Radius
import com.esuiss.ui.theme.Typography

class HapticsLog(private val system: HapticFeedback) : HapticFeedback {
    var last by mutableStateOf("None")
    var count by mutableIntStateOf(0)

    override fun performHapticFeedback(hapticFeedbackType: HapticFeedbackType) {
        last = hapticFeedbackType.toString()
        count += 1
        system.performHapticFeedback(hapticFeedbackType)
    }
}

@Composable
fun HapticsLogging(content: @Composable (HapticsLog) -> Unit) {
    val system = LocalHapticFeedback.current
    val log = remember(system) { HapticsLog(system) }
    CompositionLocalProvider(LocalHapticFeedback provides log) {
        content(log)
    }
}

@Composable
fun HapticsLogRow(log: HapticsLog) {
    val colors = EsuissTheme.colors
    Row(
        modifier = Modifier
            .fillMaxWidth()
            .background(colors.surfaceSecondary, RoundedCornerShape(Radius.xl))
            .padding(horizontal = 16.dp, vertical = 12.dp),
        horizontalArrangement = Arrangement.SpaceBetween,
        verticalAlignment = Alignment.CenterVertically,
    ) {
        Text("Last haptic", style = Typography.sm.copy(color = colors.labelSecondary))
        Text(
            if (log.count > 0) "${log.last} (${log.count})" else log.last,
            modifier = Modifier.semantics { liveRegion = LiveRegionMode.Polite },
            style = Typography.sm.copy(fontWeight = FontWeight.Medium),
        )
    }
}

val HapticsTasks = listOf("Inbox", "Today", "Upcoming", "Someday")

@Composable
fun HapticsReorderDemo() {
    var value by rememberSaveable { mutableStateOf(HapticsTasks) }
    val shape = RoundedCornerShape(Radius.xl2)
    HapticsLogging { log ->
        Column(Modifier.fillMaxWidth(), verticalArrangement = Arrangement.spacedBy(16.dp)) {
            HapticsLogRow(log)
            ReorderList(
                value,
                { value = it },
                modifier = Modifier
                    .fillMaxWidth()
                    .clip(shape)
                    .border(1.dp, EsuissTheme.colors.separator, shape),
            ) { task ->
                ReorderListItem {
                    Text(
                        task,
                        modifier = Modifier.weight(1f).padding(vertical = 12.dp),
                        maxLines = 1,
                        overflow = TextOverflow.Ellipsis,
                    )
                    ReorderListHandle(contentDescription = "Reorder $task")
                }
            }
        }
    }
}
```

### Disabled

The same controls with haptics turned off.

![Preview](https://uim.suiss.app/previews/components-haptics--disabled.light.webp)

```tsx
import * as React from "react"
import { View } from "react-native"
import { Stepper, StepperDecrement, StepperGroup, StepperIncrement, StepperInput, StepperSeparator } from "@/components/interactions/stepper"
import { Checkbox } from "@/components/ui/checkbox"
import { Chip } from "@/components/ui/chip"
import { type HapticsAdapter, HapticsProvider } from "@/components/ui/haptics"
import { Slider } from "@/components/ui/slider"
import { Switch } from "@/components/ui/switch"
import { Text } from "@/components/ui/text"

function useLoggingAdapter() {
  const [log, setLog] = React.useState({ last: "None", count: 0 })
  const adapter = React.useMemo<HapticsAdapter>(() => {
    const record = (event: string) =>
      setLog((current) => ({ last: event, count: current.count + 1 }))
    return {
      impact: (style) => record(`impact ${style}`),
      selection: () => record("selection"),
      notification: (type) => record(`notification ${type}`),
    }
  }, [])
  return { adapter, log }
}

function HapticLog({ last, count }: { last: string; count: number }) {
  return (
    <View className="flex-row items-center justify-between rounded-xl bg-surface-secondary px-4 py-3">
      <Text className="text-sm text-label-secondary">Last haptic</Text>
      <Text
        role="status"
        accessibilityLiveRegion="polite"
        className="text-sm font-medium"
      >
        {count > 0 ? `${last} (${count})` : last}
      </Text>
    </View>
  )
}

function Row({
  label,
  children,
}: {
  label: string
  children: React.ReactNode
}) {
  return (
    <View className="min-h-11 flex-row items-center justify-between gap-4">
      <Text>{label}</Text>
      {children}
    </View>
  )
}

function Controls() {
  const [wifi, setWifi] = React.useState(true)
  const [terms, setTerms] = React.useState(false)
  const [volume, setVolume] = React.useState(40)
  const [copies, setCopies] = React.useState(1)

  return (
    <View className="w-full gap-2">
      <Row label="Wi-Fi">
        <Switch
          accessibilityLabel="Wi-Fi"
          checked={wifi}
          onCheckedChange={setWifi}
        />
      </Row>
      <Row label="Accept terms">
        <Checkbox
          accessibilityLabel="Accept terms"
          checked={terms}
          onCheckedChange={setTerms}
        />
      </Row>
      <Row label="Copies">
        <Stepper value={copies} onValueChange={setCopies} min={1} max={9}>
          <StepperInput accessibilityLabel="Copies" />
          <StepperGroup>
            <StepperDecrement />
            <StepperSeparator />
            <StepperIncrement />
          </StepperGroup>
        </Stepper>
      </Row>
      <View className="flex-row gap-2 py-2">
        <Chip>Open now</Chip>
        <Chip>Top rated</Chip>
      </View>
      <Slider
        value={volume}
        step={10}
        onValueChange={(next) => setVolume(next)}
        accessibilityLabel="Volume"
      />
    </View>
  )
}

function ControlsDemo({ enabled = true }: { enabled?: boolean }) {
  const { adapter, log } = useLoggingAdapter()
  return (
    <HapticsProvider adapter={adapter} enabled={enabled}>
      <View className="w-full gap-4">
        <HapticLog {...log} />
        <Controls />
      </View>
    </HapticsProvider>
  )
}

export function HapticsDisabledExample() {
  return (
    <ControlsDemo enabled={false} />
  )
}
```

```swift
import EsuissUI
import SwiftUI

struct HapticsDisabledExample: View {
  var body: some View {
    HapticsControls()
      .haptics(false)
  }
}

struct HapticsRow<Content: View>: View {
  let label: LocalizedStringKey
  @ViewBuilder let content: () -> Content

  var body: some View {
    HStack(spacing: 16) {
      Text(label)
        .textStyle(.base)
        .foregroundStyle(Color.label)
      Spacer(minLength: 0)
      content()
    }
    .frame(minHeight: 44)
  }
}

struct HapticsControls: View {
  @State private var wifi = true
  @State private var terms = false
  @State private var volume = 40.0
  @State private var copies = 1
  @State private var openNow = false
  @State private var topRated = false

  var body: some View {
    VStack(alignment: .leading, spacing: 8) {
      HapticsRow(label: "Wi-Fi") {
        Toggle(isOn: $wifi) { EmptyView() }
          .toggleStyle(.switch(size: .default))
          .accessibilityLabel(Text("Wi-Fi"))
      }
      HapticsRow(label: "Accept terms") {
        Toggle(isOn: $terms) { EmptyView() }
          .toggleStyle(.checkbox)
          .accessibilityLabel(Text("Accept terms"))
      }
      HapticsRow(label: "Copies") {
        ValueStepper(value: $copies, in: 1...9) {
          StepperInput()
            .accessibilityLabel(Text("Copies"))
          StepperGroup {
            StepperDecrement()
            StepperSeparator()
            StepperIncrement()
          }
        }
      }
      HStack(spacing: 8) {
        Chip("Open now", isSelected: $openNow)
        Chip("Top rated", isSelected: $topRated)
      }
      .padding(.vertical, 8)
      ValueSlider(value: $volume, in: 0...100, step: 10)
        .accessibilityLabel(Text("Volume"))
    }
    .frame(maxWidth: .infinity, alignment: .leading)
  }
}
```

```kotlin
import androidx.compose.foundation.background
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.Row
import androidx.compose.foundation.layout.fillMaxWidth
import androidx.compose.foundation.layout.heightIn
import androidx.compose.foundation.layout.padding
import androidx.compose.foundation.shape.RoundedCornerShape
import androidx.compose.runtime.Composable
import androidx.compose.runtime.CompositionLocalProvider
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableDoubleStateOf
import androidx.compose.runtime.mutableFloatStateOf
import androidx.compose.runtime.mutableIntStateOf
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.hapticfeedback.HapticFeedback
import androidx.compose.ui.hapticfeedback.HapticFeedbackType
import androidx.compose.ui.platform.LocalHapticFeedback
import androidx.compose.ui.semantics.LiveRegionMode
import androidx.compose.ui.semantics.contentDescription
import androidx.compose.ui.semantics.liveRegion
import androidx.compose.ui.semantics.semantics
import androidx.compose.ui.text.font.FontWeight
import androidx.compose.ui.unit.dp
import com.esuiss.ui.components.Checkbox
import com.esuiss.ui.components.Chip
import com.esuiss.ui.components.ProvideHaptics
import com.esuiss.ui.components.Slider
import com.esuiss.ui.components.Switch
import com.esuiss.ui.components.Text
import com.esuiss.ui.interactions.Stepper
import com.esuiss.ui.interactions.StepperDecrement
import com.esuiss.ui.interactions.StepperGroup
import com.esuiss.ui.interactions.StepperIncrement
import com.esuiss.ui.interactions.StepperInput
import com.esuiss.ui.interactions.StepperSeparator
import com.esuiss.ui.theme.EsuissTheme
import com.esuiss.ui.theme.Radius
import com.esuiss.ui.theme.Typography

@Composable
fun HapticsDisabledExample() {
    HapticsControlsDemo(enabled = false)
}

class HapticsLog(private val system: HapticFeedback) : HapticFeedback {
    var last by mutableStateOf("None")
    var count by mutableIntStateOf(0)

    override fun performHapticFeedback(hapticFeedbackType: HapticFeedbackType) {
        last = hapticFeedbackType.toString()
        count += 1
        system.performHapticFeedback(hapticFeedbackType)
    }
}

@Composable
fun HapticsLogging(content: @Composable (HapticsLog) -> Unit) {
    val system = LocalHapticFeedback.current
    val log = remember(system) { HapticsLog(system) }
    CompositionLocalProvider(LocalHapticFeedback provides log) {
        content(log)
    }
}

@Composable
fun HapticsLogRow(log: HapticsLog) {
    val colors = EsuissTheme.colors
    Row(
        modifier = Modifier
            .fillMaxWidth()
            .background(colors.surfaceSecondary, RoundedCornerShape(Radius.xl))
            .padding(horizontal = 16.dp, vertical = 12.dp),
        horizontalArrangement = Arrangement.SpaceBetween,
        verticalAlignment = Alignment.CenterVertically,
    ) {
        Text("Last haptic", style = Typography.sm.copy(color = colors.labelSecondary))
        Text(
            if (log.count > 0) "${log.last} (${log.count})" else log.last,
            modifier = Modifier.semantics { liveRegion = LiveRegionMode.Polite },
            style = Typography.sm.copy(fontWeight = FontWeight.Medium),
        )
    }
}

@Composable
fun HapticsRow(label: String, content: @Composable () -> Unit) {
    Row(
        modifier = Modifier.fillMaxWidth().heightIn(min = 44.dp),
        horizontalArrangement = Arrangement.spacedBy(16.dp),
        verticalAlignment = Alignment.CenterVertically,
    ) {
        Text(label, modifier = Modifier.weight(1f))
        content()
    }
}

@Composable
fun HapticsControls() {
    var wifi by rememberSaveable { mutableStateOf(true) }
    var terms by rememberSaveable { mutableStateOf(false) }
    var volume by rememberSaveable { mutableFloatStateOf(40f) }
    var copies by rememberSaveable { mutableDoubleStateOf(1.0) }
    var openNow by rememberSaveable { mutableStateOf(false) }
    var topRated by rememberSaveable { mutableStateOf(false) }
    Column(Modifier.fillMaxWidth(), verticalArrangement = Arrangement.spacedBy(8.dp)) {
        HapticsRow("Wi-Fi") {
            Switch(wifi, { wifi = it }, Modifier.semantics { contentDescription = "Wi-Fi" })
        }
        HapticsRow("Accept terms") {
            Checkbox(terms, { terms = it }, Modifier.semantics { contentDescription = "Accept terms" })
        }
        HapticsRow("Copies") {
            Stepper(copies, { copies = it }, min = 1.0, max = 9.0) {
                StepperInput(contentDescription = "Copies")
                StepperGroup {
                    StepperDecrement()
                    StepperSeparator()
                    StepperIncrement()
                }
            }
        }
        Row(Modifier.padding(vertical = 8.dp), horizontalArrangement = Arrangement.spacedBy(8.dp)) {
            Chip("Open now", openNow, { openNow = it })
            Chip("Top rated", topRated, { topRated = it })
        }
        Slider(volume, { volume = it }, step = 10f, contentDescription = "Volume")
    }
}

@Composable
fun HapticsControlsDemo(enabled: Boolean) {
    HapticsLogging { log ->
        ProvideHaptics(enabled = enabled) {
            Column(Modifier.fillMaxWidth(), verticalArrangement = Arrangement.spacedBy(16.dp)) {
                HapticsLogRow(log)
                HapticsControls()
            }
        }
    }
}
```

## API Reference

### HapticsProvider

Supplies the adapter to every component below it.

## Notes

- The types `HapticsAdapter`, `HapticsImpactStyle` and `HapticsNotificationType` are exported for typing your adapter.
- Haptics have no visual output; pair important feedback with a visible change.