@flighthq/haptics 0.5.0-next.1944.cd6b6e7 → 0.5.1-edge.638.d4dbd4e

package/README.md

@@ -13,5 +13,5 @@ Import the supported application-facing API from `@flighthq/haptics`. The `@flig
 This package is part of the locked-version Flight SDK graph. Applications may instead install and import `@flighthq/sdk` when package-level tree shaking is sufficient.
 
 - [Flight project](https://github.com/flighthq/flight)
-- [Source for @flighthq/haptics@0.5.0-next.1944.cd6b6e7](https://github.com/flighthq/flight/tree/cd6b6e71eb472b3a4249830a7743333f019fa7b7/packages/haptics)
-- [License](https://github.com/flighthq/flight/blob/cd6b6e71eb472b3a4249830a7743333f019fa7b7/LICENSE.md)
+- [Source for @flighthq/haptics@0.5.1-edge.638.d4dbd4e](https://github.com/flighthq/flight/tree/d4dbd4e347dc8be10b180c85a766ab50333dcb51/packages/haptics)
+- [License](https://github.com/flighthq/flight/blob/d4dbd4e347dc8be10b180c85a766ab50333dcb51/LICENSE.md)

package/dist/haptics.d.ts

@@ -1,20 +1,12 @@
-import type { BackendExplanation } from '@flighthq/types/contract';
-import type { HapticImpactStyle, HapticNotificationType, HapticsBackend, HapticsCapabilities } from '@flighthq/types/contract';
-export declare function cancelDeviceVibration(): boolean;
-export declare function createWebHapticsBackend(): HapticsBackend;
-export declare function explainHapticsBackend(): BackendExplanation;
-export declare function getHapticsBackend(): HapticsBackend;
-export declare function getHapticsCapabilities(out: HapticsCapabilities): HapticsCapabilities;
-export declare function installHapticsHostBackend(backend: HapticsBackend): void;
-export declare function isHapticsSupported(): boolean;
-export declare function observeHapticsHostResult(operation: string, succeeded: boolean): void;
-export declare function prepareHaptics(): void;
-export declare function resetHapticsBackendForTest(): void;
-export declare function setHapticsBackend(backend: HapticsBackend | null): void;
-export declare function triggerHapticImpact(style: HapticImpactStyle, intensity?: number): boolean;
-export declare function triggerHapticNotification(type: HapticNotificationType): boolean;
-export declare function triggerHapticSelection(): boolean;
-export declare function vibrateDevice(durationMs: number): boolean;
-export declare function vibrateDevicePattern(pattern: Readonly<number[]>): boolean;
-export declare function vibrateDeviceWaveform(timings: Readonly<number[]>, amplitudes: Readonly<number[]>, repeat?: number): boolean;
+import type { HapticImpactStyle, HapticNotificationType, HapticsCapabilities, HasInputHaptics } from '@flighthq/types/contract';
+export declare function cancelDeviceVibration(host: HasInputHaptics): boolean;
+export declare function getHapticsCapabilities(host: HasInputHaptics, out: HapticsCapabilities): HapticsCapabilities;
+export declare function isHapticsSupported(host: HasInputHaptics): boolean;
+export declare function prepareHaptics(host: HasInputHaptics): void;
+export declare function triggerHapticImpact(host: HasInputHaptics, style: HapticImpactStyle, intensity?: number): boolean;
+export declare function triggerHapticNotification(host: HasInputHaptics, type: HapticNotificationType): boolean;
+export declare function triggerHapticSelection(host: HasInputHaptics): boolean;
+export declare function vibrateDevice(host: HasInputHaptics, durationMs: number): boolean;
+export declare function vibrateDevicePattern(host: HasInputHaptics, pattern: Readonly<number[]>): boolean;
+export declare function vibrateDeviceWaveform(host: HasInputHaptics, timings: Readonly<number[]>, amplitudes: Readonly<number[]>, repeat?: number): boolean;
 //# sourceMappingURL=haptics.d.ts.map

package/dist/haptics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"haptics.d.ts","sourceRoot":"","sources":["../src/haptics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,mBAAmB,EACpB,MAAM,0BAA0B,CAAC;AAElC,wBAAgB,qBAAqB,IAAI,OAAO,CAE/C;AAKD,wBAAgB,uBAAuB,IAAI,cAAc,CA2CxD;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,CAa1D;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAElD;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,mBAAmB,GAAG,mBAAmB,CAEpF;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAMvE;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAKpF;AAED,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,wBAAgB,0BAA0B,IAAI,IAAI,CAKjD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAEtE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAEzF;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAE/E;AAED,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAGzE;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,EAC3B,UAAU,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,EAC9B,MAAM,SAAK,GACV,OAAO,CAOT"}
+{"version":3,"file":"haptics.d.ts","sourceRoot":"","sources":["../src/haptics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAElC,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAEpE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,mBAAmB,GAAG,mBAAmB,CAE3G;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAEjE;AAID,wBAAgB,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAE1D;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,EAAE,KAAK,EAAE,iBAAiB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAEhH;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAEtG;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAErE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAEhF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAGhG;AAID,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,EAC3B,UAAU,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,EAC9B,MAAM,SAAK,GACV,OAAO,CAOT"}

package/dist/haptics.js

@@ -1,123 +1,38 @@
-export function cancelDeviceVibration() {
-    return getHapticsBackend().cancel();
+export function cancelDeviceVibration(host) {
+    return host.input.haptics.cancel();
 }
-// Builds the default web backend over navigator.vibrate. Every method returns false when the Vibration
-// API is absent (jsdom, desktop browsers) or the call fails, rather than throwing. Web vibration is a
-// coarse approximation of native haptics: it can only buzz the motor for a duration/pattern.
-export function createWebHapticsBackend() {
-    return {
-        cancel() {
-            return _webVibrate(0, 'cancel');
-        },
-        capabilities(out) {
-            const supported = typeof navigator !== 'undefined' && typeof navigator.vibrate === 'function';
-            out.amplitudeControl = false;
-            out.customEvents = false;
-            out.intensity = false;
-            out.patterns = supported;
-            out.supported = supported;
-            return out;
-        },
-        impact(style, intensity) {
-            const base = style === 'heavy' || style === 'rigid' ? 30 : style === 'medium' ? 20 : style === 'soft' ? 25 : 10;
-            const ms = intensity !== undefined ? Math.round(base * Math.max(0, Math.min(1, intensity))) : base;
-            return _webVibrate(ms, 'impact');
-        },
-        isSupported() {
-            return typeof navigator !== 'undefined' && typeof navigator.vibrate === 'function';
-        },
-        notification(type) {
-            const pattern = type === 'error' ? [20, 60, 20] : type === 'warning' ? [20, 60, 20, 60] : [15, 50, 15];
-            return _webVibrate(pattern, 'notification');
-        },
-        prepare() { },
-        selection() {
-            return _webVibrate(5, 'selection');
-        },
-        vibrate(durationMs) {
-            return _webVibrate(durationMs, 'vibrate');
-        },
-        vibratePattern(pattern) {
-            if (pattern.length === 0)
-                return false;
-            return _webVibrate(pattern, 'vibratePattern');
-        },
-        vibrateWaveform(timings, _amplitudes, repeat) {
-            if (timings.length === 0)
-                return false;
-            void repeat;
-            return _webVibrate(timings, 'vibrateWaveform');
-        },
-    };
+export function getHapticsCapabilities(host, out) {
+    return host.input.haptics.capabilities(out);
 }
-export function explainHapticsBackend() {
-    if (_custom !== null) {
-        return { conflict: _hostConflict, layer: 'custom', operation: null, viability: 'unobserved' };
-    }
-    if (_host !== null) {
-        return {
-            conflict: _hostConflict,
-            layer: 'host',
-            operation: _hostObservation !== null ? _hostObservation.operation : null,
-            viability: _hostObservation !== null ? _hostObservation.viability : 'unobserved',
-        };
-    }
-    return { conflict: false, layer: 'host-not-enabled', operation: null, viability: 'unobserved' };
-}
-export function getHapticsBackend() {
-    return _custom ?? _host ?? _sentinel;
-}
-export function getHapticsCapabilities(out) {
-    return getHapticsBackend().capabilities(out);
-}
-export function installHapticsHostBackend(backend) {
-    if (_host !== null) {
-        if (_host !== backend)
-            _hostConflict = true;
-        return;
-    }
-    _host = backend;
+export function isHapticsSupported(host) {
+    return host.input.haptics.isSupported();
 }
-export function isHapticsSupported() {
-    return getHapticsBackend().isSupported();
+// Warm-up hint. `prepare` is optional on the backend, so a host whose provider does not pre-allocate
+// simply does nothing here — that is the absence of a capability, not a failure.
+export function prepareHaptics(host) {
+    host.input.haptics.prepare?.();
 }
-export function observeHapticsHostResult(operation, succeeded) {
-    _hostObservation = {
-        operation,
-        viability: succeeded ? 'available' : 'runtime-api-unavailable',
-    };
+export function triggerHapticImpact(host, style, intensity) {
+    return host.input.haptics.impact(style, intensity ?? 1);
 }
-export function prepareHaptics() {
-    getHapticsBackend().prepare?.();
+export function triggerHapticNotification(host, type) {
+    return host.input.haptics.notification(type);
 }
-export function resetHapticsBackendForTest() {
-    _custom = null;
-    _host = null;
-    _hostConflict = false;
-    _hostObservation = null;
+export function triggerHapticSelection(host) {
+    return host.input.haptics.selection();
 }
-export function setHapticsBackend(backend) {
-    _custom = backend;
+export function vibrateDevice(host, durationMs) {
+    return host.input.haptics.vibrate(durationMs);
 }
-export function triggerHapticImpact(style, intensity) {
-    return getHapticsBackend().impact(style, intensity ?? 1);
-}
-export function triggerHapticNotification(type) {
-    return getHapticsBackend().notification(type);
-}
-export function triggerHapticSelection() {
-    return getHapticsBackend().selection();
-}
-export function vibrateDevice(durationMs) {
-    return getHapticsBackend().vibrate(durationMs);
-}
-export function vibrateDevicePattern(pattern) {
+export function vibrateDevicePattern(host, pattern) {
     if (pattern.length === 0)
         return false;
-    return getHapticsBackend().vibratePattern(pattern);
+    return host.input.haptics.vibratePattern(pattern);
 }
-export function vibrateDeviceWaveform(timings, amplitudes, repeat = -1) {
-    const backend = getHapticsBackend();
+// Amplitude-aware waveform, falling back to a plain timing pattern when the selected provider does not
+// implement one. The fallback drops amplitudes rather than failing: every backend can express timings.
+export function vibrateDeviceWaveform(host, timings, amplitudes, repeat = -1) {
+    const backend = host.input.haptics;
     if (timings.length === 0)
         return false;
     if (backend.vibrateWaveform !== undefined) {
@@ -125,55 +40,4 @@ export function vibrateDeviceWaveform(timings, amplitudes, repeat = -1) {
     }
     return backend.vibratePattern(timings);
 }
-let _custom = null;
-let _host = null;
-let _hostConflict = false;
-let _hostObservation = null;
-const _sentinel = {
-    cancel() {
-        return false;
-    },
-    capabilities(out) {
-        out.amplitudeControl = false;
-        out.customEvents = false;
-        out.intensity = false;
-        out.patterns = false;
-        out.supported = false;
-        return out;
-    },
-    impact() {
-        return false;
-    },
-    isSupported() {
-        return false;
-    },
-    notification() {
-        return false;
-    },
-    prepare() { },
-    selection() {
-        return false;
-    },
-    vibrate() {
-        return false;
-    },
-    vibratePattern() {
-        return false;
-    },
-};
-function _webVibrate(pattern, operation) {
-    if (typeof navigator === 'undefined' || !('vibrate' in navigator) || typeof navigator.vibrate !== 'function') {
-        observeHapticsHostResult(operation, false);
-        return false;
-    }
-    try {
-        const result = navigator.vibrate(pattern);
-        observeHapticsHostResult(operation, result);
-        return result;
-    }
-    catch {
-        observeHapticsHostResult(operation, false);
-        return false;
-    }
-}
 //# sourceMappingURL=haptics.js.map

package/dist/haptics.js.map

@@ -1 +1 @@
-{"version":3,"file":"haptics.js","sourceRoot":"","sources":["../src/haptics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"haptics.js","sourceRoot":"","sources":["../src/haptics.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,qBAAqB,CAAC,IAAqB;IACzD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAqB,EAAE,GAAwB;IACpF,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAqB;IACtD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;AAC1C,CAAC;AAED,qGAAqG;AACrG,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,IAAqB;IAClD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAqB,EAAE,KAAwB,EAAE,SAAkB;IACrG,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,IAAI,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAqB,EAAE,IAA4B;IAC3F,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAqB;IAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAqB,EAAE,UAAkB;IACrE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAqB,EAAE,OAA2B;IACrF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AACpD,CAAC;AAED,uGAAuG;AACvG,uGAAuG;AACvG,MAAM,UAAU,qBAAqB,CACnC,IAAqB,EACrB,OAA2B,EAC3B,UAA8B,EAC9B,MAAM,GAAG,CAAC,CAAC;IAEX,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;IACnC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,OAAO,CAAC,eAAe,CAAC,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { explainHapticsBackend, cancelDeviceVibration, getHapticsCapabilities, isHapticsSupported, prepareHaptics, triggerHapticImpact, triggerHapticNotification, triggerHapticSelection, vibrateDevice, vibrateDevicePattern, vibrateDeviceWaveform, } from './contract';
+export { cancelDeviceVibration, getHapticsCapabilities, isHapticsSupported, prepareHaptics, triggerHapticImpact, triggerHapticNotification, triggerHapticSelection, vibrateDevice, vibrateDevicePattern, vibrateDeviceWaveform, } from './contract';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,aAAa,EACb,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,aAAa,EACb,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { explainHapticsBackend, cancelDeviceVibration, getHapticsCapabilities, isHapticsSupported, prepareHaptics, triggerHapticImpact, triggerHapticNotification, triggerHapticSelection, vibrateDevice, vibrateDevicePattern, vibrateDeviceWaveform, } from './contract';
+export { cancelDeviceVibration, getHapticsCapabilities, isHapticsSupported, prepareHaptics, triggerHapticImpact, triggerHapticNotification, triggerHapticSelection, vibrateDevice, vibrateDevicePattern, vibrateDeviceWaveform, } from './contract';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,aAAa,EACb,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACtB,aAAa,EACb,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/haptics",
-  "version": "0.5.0-next.1944.cd6b6e7",
+  "version": "0.5.1-edge.638.d4dbd4e",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,7 +38,7 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/types": "0.5.0-next.1944.cd6b6e7"
+    "@flighthq/types": "0.5.1-edge.638.d4dbd4e"
   },
   "devDependencies": {
     "typescript": "^5.3.0"

package/src/haptics.test.ts

@@ -3,28 +3,27 @@ import type {
   HapticNotificationType,
   HapticsBackend,
   HapticsCapabilities,
+  HasInputHaptics,
 } from '@flighthq/types/contract';
 
 import {
   cancelDeviceVibration,
-  createWebHapticsBackend,
-  getHapticsBackend,
   getHapticsCapabilities,
   isHapticsSupported,
   prepareHaptics,
-  setHapticsBackend,
   triggerHapticImpact,
   triggerHapticNotification,
   triggerHapticSelection,
   vibrateDevice,
   vibrateDevicePattern,
   vibrateDeviceWaveform,
-  explainHapticsBackend,
-  installHapticsHostBackend,
-  observeHapticsHostResult,
-  resetHapticsBackendForTest,
 } from './haptics';
 
+interface RecordedCall {
+  readonly args: readonly unknown[];
+  readonly name: string;
+}
+
 function makeCapabilities(overrides: Partial<HapticsCapabilities> = {}): HapticsCapabilities {
   return {
     amplitudeControl: false,
@@ -36,391 +35,192 @@ function makeCapabilities(overrides: Partial<HapticsCapabilities> = {}): Haptics
   };
 }
 
-function fakeBackend(): HapticsBackend & {
-  cancelCount: number;
-  duration: number;
-  lastPattern: Readonly<number[]> | null;
-  lastWaveform: { amplitudes: Readonly<number[]>; repeat: number | undefined; timings: Readonly<number[]> } | null;
-  prepared: number;
-  style: HapticImpactStyle | null;
-  styleIntensity: number | undefined;
-  type: HapticNotificationType | null;
-  selections: number;
-} {
-  return {
-    cancelCount: 0,
-    duration: -1,
-    lastPattern: null,
-    lastWaveform: null,
-    prepared: 0,
-    style: null,
-    styleIntensity: undefined,
-    type: null,
-    selections: 0,
-    cancel() {
-      this.cancelCount += 1;
-      return true;
-    },
+// A host carrying a recording haptics provider. Every operation is explicit here — there is no ambient
+// slot to install into and nothing to reset between tests, which is the point of the migration: two
+// tests can hold two different providers at once without interfering.
+function makeHost(overrides: Partial<HapticsBackend> = {}): { calls: RecordedCall[]; host: HasInputHaptics } {
+  const calls: RecordedCall[] = [];
+  const record =
+    (name: string, result: boolean) =>
+    (...args: unknown[]): boolean => {
+      calls.push({ args, name });
+      return result;
+    };
+  const haptics: HapticsBackend = {
+    cancel: record('cancel', true),
     capabilities(out: HapticsCapabilities): HapticsCapabilities {
-      out.amplitudeControl = true;
-      out.customEvents = false;
-      out.intensity = true;
+      calls.push({ args: [], name: 'capabilities' });
       out.patterns = true;
       out.supported = true;
       return out;
     },
-    impact(style: HapticImpactStyle, intensity?: number) {
-      this.style = style;
-      this.styleIntensity = intensity;
-      return true;
-    },
-    isSupported() {
-      return true;
-    },
-    notification(type: HapticNotificationType) {
-      this.type = type;
-      return true;
-    },
-    prepare() {
-      this.prepared += 1;
-    },
-    selection() {
-      this.selections += 1;
-      return true;
-    },
-    vibrate(durationMs: number) {
-      this.duration = durationMs;
-      return true;
-    },
-    vibratePattern(pattern: Readonly<number[]>) {
-      this.lastPattern = pattern;
-      return true;
-    },
-    vibrateWaveform(timings: Readonly<number[]>, amplitudes: Readonly<number[]>, repeat?: number) {
-      this.lastWaveform = { amplitudes, repeat, timings };
-      return true;
-    },
+    impact: record('impact', true) as HapticsBackend['impact'],
+    isSupported: record('isSupported', true) as HapticsBackend['isSupported'],
+    notification: record('notification', true) as HapticsBackend['notification'],
+    selection: record('selection', true) as HapticsBackend['selection'],
+    vibrate: record('vibrate', true) as HapticsBackend['vibrate'],
+    vibratePattern: record('vibratePattern', true) as HapticsBackend['vibratePattern'],
+    ...overrides,
   };
+  return { calls, host: { input: { haptics } } };
 }
 
-afterEach(() => setHapticsBackend(null));
-
 describe('cancelDeviceVibration', () => {
-  it('forwards to backend cancel', () => {
-    const backend = fakeBackend();
-    setHapticsBackend(backend);
-    expect(cancelDeviceVibration()).toBe(true);
-    expect(backend.cancelCount).toBe(1);
-  });
-
-  it('returns false when haptics unavailable (jsdom)', () => {
-    expect(cancelDeviceVibration()).toBe(false);
-  });
-});
-
-describe('createWebHapticsBackend', () => {
-  it('returns false for every method without throwing when vibrate is unavailable (jsdom)', () => {
-    const backend = createWebHapticsBackend();
-    expect(backend.vibrate(10)).toBe(false);
-    expect(backend.impact('heavy')).toBe(false);
-    expect(backend.impact('rigid')).toBe(false);
-    expect(backend.impact('soft')).toBe(false);
-    expect(backend.notification('error')).toBe(false);
-    expect(backend.selection()).toBe(false);
-    expect(backend.vibratePattern([100, 50, 100])).toBe(false);
-    expect(backend.cancel()).toBe(false);
-    expect(backend.isSupported()).toBe(false);
-  });
-
-  it('returns false for empty pattern without throwing', () => {
-    const backend = createWebHapticsBackend();
-    expect(backend.vibratePattern([])).toBe(false);
-  });
-
-  it('returns false for waveform with empty timings', () => {
-    const backend = createWebHapticsBackend();
-    expect(backend.vibrateWaveform!([], [], undefined)).toBe(false);
-  });
-
-  it('fills capabilities for web (no vibrate)', () => {
-    const backend = createWebHapticsBackend();
-    const out = makeCapabilities();
-    backend.capabilities(out);
-    expect(out.supported).toBe(false);
-    expect(out.patterns).toBe(false);
-    expect(out.intensity).toBe(false);
-    expect(out.amplitudeControl).toBe(false);
-    expect(out.customEvents).toBe(false);
-  });
-
-  it('prepare is a no-op and does not throw', () => {
-    const backend = createWebHapticsBackend();
-    expect(() => backend.prepare!()).not.toThrow();
-  });
-});
-
-describe('explainHapticsBackend', () => {
-  afterEach(() => resetHapticsBackendForTest());
-
-  it('reports host-not-enabled when no backend is installed', () => {
-    resetHapticsBackendForTest();
-    const explanation = explainHapticsBackend();
-    expect(explanation.layer).toBe('host-not-enabled');
-    expect(explanation.conflict).toBe(false);
-    expect(explanation.viability).toBe('unobserved');
-  });
-
-  it('reports custom layer when a custom backend is set', () => {
-    setHapticsBackend(fakeBackend());
-    expect(explainHapticsBackend().layer).toBe('custom');
-  });
-
-  it('reports host layer when a host backend is installed', () => {
-    installHapticsHostBackend(fakeBackend());
-    expect(explainHapticsBackend().layer).toBe('host');
+  it('forwards to the selected provider', () => {
+    const { calls, host } = makeHost();
+    expect(cancelDeviceVibration(host)).toBe(true);
+    expect(calls.map((call) => call.name)).toEqual(['cancel']);
   });
 
-  it('reports conflict when two different host backends are installed', () => {
-    installHapticsHostBackend(fakeBackend());
-    installHapticsHostBackend(fakeBackend());
-    expect(explainHapticsBackend().conflict).toBe(true);
-  });
-});
-
-describe('getHapticsBackend', () => {
-  it('falls back to a web backend', () => {
-    expect(getHapticsBackend()).not.toBeNull();
-  });
-
-  it('returns the registered backend', () => {
-    const backend = fakeBackend();
-    setHapticsBackend(backend);
-    expect(getHapticsBackend()).toBe(backend);
+  it('returns whatever the provider reports rather than assuming success', () => {
+    const { host } = makeHost({ cancel: () => false });
+    expect(cancelDeviceVibration(host)).toBe(false);
   });
 });
 
 describe('getHapticsCapabilities', () => {
-  it('fills out via the fake backend', () => {
-    const backend = fakeBackend();
-    setHapticsBackend(backend);
+  it('fills and returns the caller-owned out parameter', () => {
+    const { host } = makeHost();
     const out = makeCapabilities();
-    const result = getHapticsCapabilities(out);
-    expect(result).toBe(out);
+    expect(getHapticsCapabilities(host, out)).toBe(out);
     expect(out.supported).toBe(true);
-    expect(out.intensity).toBe(true);
     expect(out.patterns).toBe(true);
-    expect(out.amplitudeControl).toBe(true);
-    expect(out.customEvents).toBe(false);
   });
 
-  it('fills out from web backend when no backend is set', () => {
-    const out = makeCapabilities();
-    getHapticsCapabilities(out);
-    expect(out.supported).toBe(false);
-  });
-});
-
-describe('installHapticsHostBackend', () => {
-  afterEach(() => resetHapticsBackendForTest());
+  // ★ Two hosts, two providers, no interference. Under the ambient model the second install either
+  // overwrote the first or was refused as a conflict; there was exactly one answer per process.
+  it('reports each host independently when two providers are live at once', () => {
+    const supported = makeHost();
+    const unsupported = makeHost({
+      capabilities: (out: HapticsCapabilities): HapticsCapabilities => {
+        out.supported = false;
+        out.patterns = false;
+        return out;
+      },
+    });
 
-  it('installs a host backend that getHapticsBackend returns', () => {
-    const backend = fakeBackend();
-    installHapticsHostBackend(backend);
-    expect(getHapticsBackend()).toBe(backend);
-  });
-
-  it('is first-host-wins: a second different backend sets conflict', () => {
-    const first = fakeBackend();
-    const second = fakeBackend();
-    installHapticsHostBackend(first);
-    installHapticsHostBackend(second);
-    expect(getHapticsBackend()).toBe(first);
-    expect(explainHapticsBackend().conflict).toBe(true);
+    expect(getHapticsCapabilities(supported.host, makeCapabilities()).supported).toBe(true);
+    expect(getHapticsCapabilities(unsupported.host, makeCapabilities()).supported).toBe(false);
   });
 });
 
 describe('isHapticsSupported', () => {
-  it('returns true from fake backend', () => {
-    setHapticsBackend(fakeBackend());
-    expect(isHapticsSupported()).toBe(true);
+  it('forwards to the selected provider', () => {
+    const { host } = makeHost();
+    expect(isHapticsSupported(host)).toBe(true);
   });
 
-  it('returns false when vibrate is unavailable (jsdom)', () => {
-    expect(isHapticsSupported()).toBe(false);
-  });
-});
-
-describe('observeHapticsHostResult', () => {
-  afterEach(() => resetHapticsBackendForTest());
-
-  it('records a successful observation', () => {
-    installHapticsHostBackend(fakeBackend());
-    observeHapticsHostResult('cancel', true);
-    const explanation = explainHapticsBackend();
-    expect(explanation.operation).toBe('cancel');
-    expect(explanation.viability).toBe('available');
-  });
-
-  it('records a failed observation', () => {
-    installHapticsHostBackend(fakeBackend());
-    observeHapticsHostResult('cancel', false);
-    expect(explainHapticsBackend().viability).toBe('runtime-api-unavailable');
+  it('reports false for a provider that says so', () => {
+    const { host } = makeHost({ isSupported: () => false });
+    expect(isHapticsSupported(host)).toBe(false);
   });
 });
 
 describe('prepareHaptics', () => {
-  it('calls prepare on backends that provide it', () => {
-    const backend = fakeBackend();
-    setHapticsBackend(backend);
-    prepareHaptics();
-    expect(backend.prepared).toBe(1);
+  it('calls prepare on providers that implement it', () => {
+    let prepared = false;
+    const { host } = makeHost({
+      prepare: (): void => {
+        prepared = true;
+      },
+    });
+    prepareHaptics(host);
+    expect(prepared).toBe(true);
   });
 
-  it('does not throw when backend has no prepare method', () => {
-    const backend = fakeBackend();
-    // Simulate a backend with no optional prepare
-    (backend as HapticsBackend & { prepare?: () => void }).prepare = undefined;
-    setHapticsBackend(backend);
-    expect(() => prepareHaptics()).not.toThrow();
-  });
-});
-
-describe('resetHapticsBackendForTest', () => {
-  it('clears all backend slots', () => {
-    setHapticsBackend(fakeBackend());
-    installHapticsHostBackend(fakeBackend());
-    observeHapticsHostResult('cancel', true);
-    resetHapticsBackendForTest();
-    expect(explainHapticsBackend().layer).toBe('host-not-enabled');
-    expect(explainHapticsBackend().conflict).toBe(false);
-    expect(explainHapticsBackend().viability).toBe('unobserved');
-  });
-});
-
-describe('setHapticsBackend', () => {
-  it('clears back to the web fallback when passed null', () => {
-    setHapticsBackend(fakeBackend());
-    setHapticsBackend(null);
-    expect(getHapticsBackend()).not.toBeNull();
+  // prepare is optional on HapticsBackend. A provider that does not pre-allocate is not a broken
+  // provider, so the absence has to be silent rather than a throw.
+  it('does nothing when the provider omits prepare', () => {
+    const { host } = makeHost();
+    expect(host.input.haptics.prepare).toBeUndefined();
+    expect(() => prepareHaptics(host)).not.toThrow();
   });
 });
 
 describe('triggerHapticImpact', () => {
-  it('forwards style to the active backend and defaults intensity to 1', () => {
-    const backend = fakeBackend();
-    setHapticsBackend(backend);
-    expect(triggerHapticImpact('medium')).toBe(true);
-    expect(backend.style).toBe('medium');
-    expect(backend.styleIntensity).toBe(1);
+  it('forwards the style and defaults intensity to 1', () => {
+    const { calls, host } = makeHost();
+    triggerHapticImpact(host, 'heavy');
+    expect(calls[0]).toEqual({ args: ['heavy', 1], name: 'impact' });
   });
 
-  it('forwards intensity to the backend', () => {
-    const backend = fakeBackend();
-    setHapticsBackend(backend);
-    triggerHapticImpact('heavy', 0.5);
-    expect(backend.style).toBe('heavy');
-    expect(backend.styleIntensity).toBe(0.5);
+  it('forwards an explicit intensity unchanged', () => {
+    const { calls, host } = makeHost();
+    triggerHapticImpact(host, 'light', 0.25);
+    expect(calls[0]).toEqual({ args: ['light', 0.25], name: 'impact' });
   });
 
-  it('supports rigid and soft styles', () => {
-    const backend = fakeBackend();
-    setHapticsBackend(backend);
-    triggerHapticImpact('rigid');
-    expect(backend.style).toBe('rigid');
-    triggerHapticImpact('soft');
-    expect(backend.style).toBe('soft');
-  });
-
-  it('web backend clamps intensity to 0..1', () => {
-    const webBackend = createWebHapticsBackend();
-    // Should not throw on out-of-range intensity even if vibrate returns false
-    expect(() => webBackend.impact('heavy', 2)).not.toThrow();
-    expect(() => webBackend.impact('heavy', -0.5)).not.toThrow();
+  it('forwards every impact style', () => {
+    const styles: readonly HapticImpactStyle[] = ['heavy', 'light', 'medium', 'rigid', 'soft'];
+    const { calls, host } = makeHost();
+    for (const style of styles) triggerHapticImpact(host, style);
+    expect(calls.map((call) => call.args[0])).toEqual(styles);
   });
 });
 
 describe('triggerHapticNotification', () => {
-  it('forwards type to the active backend', () => {
-    const backend = fakeBackend();
-    setHapticsBackend(backend);
-    expect(triggerHapticNotification('success')).toBe(true);
-    expect(backend.type).toBe('success');
+  it('forwards every notification type', () => {
+    const types: readonly HapticNotificationType[] = ['error', 'success', 'warning'];
+    const { calls, host } = makeHost();
+    for (const type of types) triggerHapticNotification(host, type);
+    expect(calls.map((call) => call.args[0])).toEqual(types);
   });
 });
 
 describe('triggerHapticSelection', () => {
-  it('triggers a selection on the active backend', () => {
-    const backend = fakeBackend();
-    setHapticsBackend(backend);
-    expect(triggerHapticSelection()).toBe(true);
-    expect(backend.selections).toBe(1);
+  it('forwards to the selected provider', () => {
+    const { calls, host } = makeHost();
+    expect(triggerHapticSelection(host)).toBe(true);
+    expect(calls.map((call) => call.name)).toEqual(['selection']);
   });
 });
 
 describe('vibrateDevice', () => {
-  it('forwards duration to the active backend', () => {
-    const backend = fakeBackend();
-    setHapticsBackend(backend);
-    expect(vibrateDevice(42)).toBe(true);
-    expect(backend.duration).toBe(42);
+  it('forwards the duration to the selected provider', () => {
+    const { calls, host } = makeHost();
+    vibrateDevice(host, 42);
+    expect(calls[0]).toEqual({ args: [42], name: 'vibrate' });
   });
 });
 
 describe('vibrateDevicePattern', () => {
-  it('forwards pattern to the active backend', () => {
-    const backend = fakeBackend();
-    setHapticsBackend(backend);
-    const pattern = [100, 50, 100] as const;
-    expect(vibrateDevicePattern(pattern)).toBe(true);
-    expect(backend.lastPattern).toEqual(pattern);
-  });
-
-  it('returns false for empty pattern', () => {
-    const backend = fakeBackend();
-    setHapticsBackend(backend);
-    expect(vibrateDevicePattern([])).toBe(false);
+  it('forwards a non-empty pattern', () => {
+    const { calls, host } = makeHost();
+    vibrateDevicePattern(host, [10, 20]);
+    expect(calls[0]).toEqual({ args: [[10, 20]], name: 'vibratePattern' });
   });
 
-  it('returns false when haptics unavailable (jsdom)', () => {
-    expect(vibrateDevicePattern([100, 50, 100])).toBe(false);
+  it('rejects an empty pattern before reaching the provider', () => {
+    const { calls, host } = makeHost();
+    expect(vibrateDevicePattern(host, [])).toBe(false);
+    expect(calls).toEqual([]);
   });
 });
 
 describe('vibrateDeviceWaveform', () => {
-  it('calls vibrateWaveform on backends that support it', () => {
-    const backend = fakeBackend();
-    setHapticsBackend(backend);
-    const timings = [100, 50, 100] as const;
-    const amplitudes = [255, 0, 128] as const;
-    expect(vibrateDeviceWaveform(timings, amplitudes, 0)).toBe(true);
-    expect(backend.lastWaveform).toEqual({ timings, amplitudes, repeat: 0 });
-  });
-
-  it('defaults repeat to -1', () => {
-    const backend = fakeBackend();
-    setHapticsBackend(backend);
-    vibrateDeviceWaveform([100], [255]);
-    expect(backend.lastWaveform?.repeat).toBe(-1);
-  });
-
-  it('falls back to vibratePattern when backend lacks vibrateWaveform', () => {
-    const backend = fakeBackend();
-    (backend as HapticsBackend).vibrateWaveform = undefined;
-    setHapticsBackend(backend);
-    const timings = [100, 50] as const;
-    const amplitudes = [255, 0] as const;
-    expect(vibrateDeviceWaveform(timings, amplitudes)).toBe(true);
-    expect(backend.lastPattern).toEqual(timings);
-    expect(backend.lastWaveform).toBeNull();
-  });
-
-  it('returns false for empty timings', () => {
-    const backend = fakeBackend();
-    setHapticsBackend(backend);
-    expect(vibrateDeviceWaveform([], [], undefined)).toBe(false);
-  });
-
-  it('returns false when haptics unavailable (jsdom)', () => {
-    expect(vibrateDeviceWaveform([100], [255])).toBe(false);
+  it('uses vibrateWaveform when the provider implements it', () => {
+    const { calls, host } = makeHost({
+      vibrateWaveform: (...args: unknown[]): boolean => {
+        calls.push({ args, name: 'vibrateWaveform' });
+        return true;
+      },
+    } as Partial<HapticsBackend>);
+    expect(vibrateDeviceWaveform(host, [10, 20], [255, 128], 1)).toBe(true);
+    expect(calls[0]).toEqual({ args: [[10, 20], [255, 128], 1], name: 'vibrateWaveform' });
+  });
+
+  // The fallback drops amplitudes rather than failing. Every provider can express timings, so a
+  // provider without amplitude support should still buzz rather than silently do nothing.
+  it('falls back to vibratePattern with the timings when vibrateWaveform is absent', () => {
+    const { calls, host } = makeHost();
+    expect(host.input.haptics.vibrateWaveform).toBeUndefined();
+    expect(vibrateDeviceWaveform(host, [10, 20], [255, 128])).toBe(true);
+    expect(calls[0]).toEqual({ args: [[10, 20]], name: 'vibratePattern' });
+  });
+
+  it('rejects empty timings before reaching either path', () => {
+    const { calls, host } = makeHost();
+    expect(vibrateDeviceWaveform(host, [], [])).toBe(false);
+    expect(calls).toEqual([]);
   });
 });