@thesonicprint/haptics 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2014 Shantanu Bala
+Copyright (c) 2026 Sonicprint
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/Readme.md

@@ -0,0 +1,204 @@
+# @thesonicprint/haptics
+
+A modern haptics library for React and Progressive Web Apps (PWA). Provides a declarative way to interact with the Vibration API with advanced patterns, pulse-width modulation (PWM), and built-in React hooks/components.
+
+## Features
+
+- **Modern ES6 Core**: Lightweight and dependency-free core.
+- **React Ready**: Full suite of hooks, context provider, and components.
+- **Advanced Patterns**: Easily create complex tactile sequences.
+- **PWM Support**: Fine-grained control over vibration intensity.
+- **PWA Optimized**: Robust error handling for non-supported devices and environments.
+- **Recording**: Record tactile patterns from user touch/mouse events.
+
+## Installation
+
+```bash
+npm install @thesonicprint/haptics
+```
+
+## Quick Start
+
+### Basic Usage
+
+```javascript
+import { vibrate, clunk, notification } from '@thesonicprint/haptics';
+
+// Simple vibration
+vibrate(50);
+
+// Built-in patterns
+clunk(100);
+notification(500);
+```
+
+### React Integration
+
+```jsx
+import { HapticsProvider, useHaptics } from '@thesonicprint/haptics';
+
+function App() {
+  return (
+    <HapticsProvider>
+      <MyComponent />
+    </HapticsProvider>
+  );
+}
+
+function MyComponent() {
+  const { clunk, fadeIn } = useHaptics();
+  
+  return (
+    <button onClick={() => clunk(50)}>
+      Click Me
+    </button>
+  );
+}
+```
+
+## Pulse Width Modulation (PWM)
+
+PWM allows you to simulate different vibration intensities by rapidly cycling the vibration motor on and off.
+
+### Creating PWM Patterns
+
+```javascript
+import { createPatternPWM } from '@thesonicprint/haptics';
+
+// Intensity presets (on-duration, off-duration in ms)
+const light = createPatternPWM(5, 25);
+const medium = createPatternPWM(15, 15);
+const strong = createPatternPWM(25, 5);
+
+// Usage: call with total duration
+light(300); // Soft vibration for 300ms
+strong(500); // Intense vibration for 500ms
+```
+
+### Why use PWM?
+Hardware vibration motors are binary (on or off). PWM is the standard technique to create "soft" or "sharp" tactile sensations, essential for premium UX in PWAs.
+
+## Progressive Enhancement (PWA focus)
+
+The library is designed to fail silently on unsupported devices (like desktop browsers or iOS Safari).
+
+- **`isSupported`**: Use this flag to conditionally show/hide haptic settings or UI elements.
+- **Silent Fail**: Calling vibration methods on unsupported devices will not throw errors; they will return `false` or return silently.
+
+```javascript
+import { enabled } from '@thesonicprint/haptics';
+
+if (enabled) {
+  console.log("Haptics are supported and ready!");
+}
+```
+
+## API Reference
+
+### Core Methods
+
+| Method | Description |
+| :--- | :--- |
+| `vibrate(pattern)` | Standard vibration. Pattern can be a `number` or `number[]`. |
+| `record()` | Start recording a pattern from touch/mouse events. |
+| `finish()` | Stop recording and return the pattern as an array. |
+| `pwm(duration, on, off)` | Raw PWM vibration for intensity control. |
+| `createPattern(...args)` | Compose higher-order pattern functions. |
+| `createPatternPWM(on, off)` | Factory for reusable intensity-based patterns. |
+
+### Built-in Effects
+
+All built-in effects are factory-prepared. You can call them with a total `duration`.
+
+- **`fadeIn(duration)`**: Gradual increase in intensity.
+- **`fadeOut(duration)`**: Gradual decrease in intensity.
+- **`notification(duration)`**: Triple-pulse "alert" pattern.
+- **`heartbeat(duration)`**: Double-pulse "lub-dub" sensation.
+- **`clunk(duration)`**: Sharp, heavy mechanical "click".
+
+### React Extensions
+
+The library provides fully integrated hooks and components for React/Vite projects.
+
+- **`useHaptics()`**: Access all core haptic methods with context awareness.
+- **`useHapticFeedback(pattern, options)`**: Declarative hook for triggering patterns based on state.
+- **`useHapticRecorder()`**: Recording interface with built-in playback and state management.
+- **`<HapticButton />`**, **`<HapticToggle />`**, **`<HapticSlider />`**: Specialized UI components with built-in tactile feedback.
+
+---
+
+## Creative Implementations
+
+### 1. Morse Code Generator
+Convert text into tactile signals for accessibility or covert notifications.
+
+```javascript
+import { createPattern } from '@thesonicprint/haptics';
+
+const MORSE_MAP = {
+  '.': [100, 100], // Dot + pause
+  '-': [300, 100], // Dash + pause
+  ' ': [0, 400]    // Word gap
+};
+
+function textToMorse(text) {
+  const pattern = text.toLowerCase().split('').flatMap(char => {
+    if (char === ' ') return MORSE_MAP[' '];
+    return MORSE_MAP[char] || [];
+  });
+  return createPattern(pattern);
+}
+
+const sos = textToMorse('sos');
+sos(1000); // Triggers tactile SOS (scaled to 1s)
+```
+
+### 2. Biometric "Scan" Effect
+Simulate the feeling of a fingerprint or face scan in your PWA.
+
+```javascript
+import { fadeIn, clunk } from '@thesonicprint/haptics';
+
+async function simulateScan() {
+  // Start with a 1s "scanning" ramp up
+  fadeIn(1000); 
+  
+  await new Promise(r => setTimeout(r, 1100));
+  
+  // Confirmed hit
+  clunk(100);
+}
+```
+
+### 3. Digital "Textures" (PWM)
+Simulate different surface feelings by varying PWM frequency.
+
+```javascript
+import { createPatternPWM } from '@sonicprint/haptics';
+
+// High frequency (Smooth/Metallic)
+const metallic = createPatternPWM(2, 2); 
+// Low frequency (Rough/Gravel)
+const rough = createPatternPWM(30, 30); 
+
+// Usage in interaction
+<div onMouseMove={() => metallic(50)}>Slide over Metal</div>
+<div onMouseMove={() => rough(50)}>Slide over Stone</div>
+```
+
+### 4. Impact Velocity (Physics FX)
+Scale haptic feedback based on game physics or interaction speed.
+
+```javascript
+import { vibrate } from '@thesonicprint/haptics';
+
+function onCollision(velocity) {
+  // Scale duration (10ms to 200ms) based on impact speed
+  const duration = Math.min(Math.max(velocity * 10, 10), 200);
+  vibrate(duration);
+}
+```
+
+## License
+
+MIT © Sonicprint

package/dist/index.d.mts

@@ -0,0 +1,61 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare function useHaptics(): {
+    isSupported: any;
+    vibrate: (pattern: any) => any;
+    fadeIn: (duration: any) => void;
+    fadeOut: (duration: any) => void;
+    notification: (duration: any) => void;
+    heartbeat: (duration: any) => void;
+    clunk: (duration: any) => void;
+    pwm: (duration: any, on: any, off: any) => void;
+    createPattern: (...args: any[]) => any;
+    createPatternPWM: (on: any, off: any) => any;
+};
+
+declare function useHapticFeedback(pattern?: number, options?: {}): (customPattern: any) => any;
+
+declare function useHapticRecorder(): {
+    isRecording: boolean;
+    recordedPattern: null;
+    startRecording: () => void;
+    stopRecording: () => any;
+    playback: (pattern: any) => void;
+    reset: () => void;
+};
+
+declare function HapticsProvider({ children, defaultEnabled }: {
+    children: any;
+    defaultEnabled?: boolean | undefined;
+}): react_jsx_runtime.JSX.Element;
+declare function useHapticsContext(): never;
+
+declare const enabled: boolean;
+declare function vibrate(pattern: any): boolean;
+declare function record(): void;
+declare function finish(): number[];
+declare const fadeIn: ((args: any) => void) | null;
+declare const fadeOut: ((args: any) => void) | null;
+declare const notification: ((args: any) => void) | null;
+declare const heartbeat: ((args: any) => void) | null;
+declare const clunk: ((args: any) => void) | null;
+declare function pwm(duration: any, on: any, off: any): void;
+declare function createPatternPWM(on: any, off: any): (args: any) => void;
+declare function createPattern(...args: any[]): ((args: any) => void) | null;
+
+declare namespace _default {
+    export { enabled };
+    export { vibrate };
+    export { record };
+    export { finish };
+    export { fadeIn };
+    export { fadeOut };
+    export { notification };
+    export { heartbeat };
+    export { clunk };
+    export { pwm };
+    export { createPatternPWM };
+    export { createPattern };
+}
+
+export { HapticsProvider, clunk, createPattern, createPatternPWM, _default as default, enabled, fadeIn, fadeOut, finish, heartbeat, notification, pwm, record, useHapticFeedback, useHapticRecorder, useHaptics, useHapticsContext, vibrate };

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare function useHaptics(): {
+    isSupported: any;
+    vibrate: (pattern: any) => any;
+    fadeIn: (duration: any) => void;
+    fadeOut: (duration: any) => void;
+    notification: (duration: any) => void;
+    heartbeat: (duration: any) => void;
+    clunk: (duration: any) => void;
+    pwm: (duration: any, on: any, off: any) => void;
+    createPattern: (...args: any[]) => any;
+    createPatternPWM: (on: any, off: any) => any;
+};
+
+declare function useHapticFeedback(pattern?: number, options?: {}): (customPattern: any) => any;
+
+declare function useHapticRecorder(): {
+    isRecording: boolean;
+    recordedPattern: null;
+    startRecording: () => void;
+    stopRecording: () => any;
+    playback: (pattern: any) => void;
+    reset: () => void;
+};
+
+declare function HapticsProvider({ children, defaultEnabled }: {
+    children: any;
+    defaultEnabled?: boolean | undefined;
+}): react_jsx_runtime.JSX.Element;
+declare function useHapticsContext(): never;
+
+declare const enabled: boolean;
+declare function vibrate(pattern: any): boolean;
+declare function record(): void;
+declare function finish(): number[];
+declare const fadeIn: ((args: any) => void) | null;
+declare const fadeOut: ((args: any) => void) | null;
+declare const notification: ((args: any) => void) | null;
+declare const heartbeat: ((args: any) => void) | null;
+declare const clunk: ((args: any) => void) | null;
+declare function pwm(duration: any, on: any, off: any): void;
+declare function createPatternPWM(on: any, off: any): (args: any) => void;
+declare function createPattern(...args: any[]): ((args: any) => void) | null;
+
+declare namespace _default {
+    export { enabled };
+    export { vibrate };
+    export { record };
+    export { finish };
+    export { fadeIn };
+    export { fadeOut };
+    export { notification };
+    export { heartbeat };
+    export { clunk };
+    export { pwm };
+    export { createPatternPWM };
+    export { createPattern };
+}
+
+export { HapticsProvider, clunk, createPattern, createPatternPWM, _default as default, enabled, fadeIn, fadeOut, finish, heartbeat, notification, pwm, record, useHapticFeedback, useHapticRecorder, useHaptics, useHapticsContext, vibrate };

package/dist/index.js

@@ -0,0 +1 @@
+"use strict";var I=Object.defineProperty;var j=Object.getOwnPropertyDescriptor;var A=Object.getOwnPropertyNames;var B=Object.prototype.hasOwnProperty;var G=(a,e)=>{for(var t in e)I(a,t,{get:e[t],enumerable:!0})},J=(a,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of A(e))!B.call(a,n)&&n!==t&&I(a,n,{get:()=>e[n],enumerable:!(r=j(e,n))||r.enumerable});return a};var K=a=>J(I({},"__esModule",{value:!0}),a);var S={};G(S,{HapticsProvider:()=>_,clunk:()=>P,createPattern:()=>y,createPatternPWM:()=>k,default:()=>X,enabled:()=>h,fadeIn:()=>w,fadeOut:()=>g,finish:()=>V,heartbeat:()=>R,notification:()=>x,pwm:()=>H,record:()=>E,useHapticFeedback:()=>L,useHapticRecorder:()=>W,useHaptics:()=>q,useHapticsContext:()=>z,vibrate:()=>d});module.exports=K(S);var p=require("react");function N(){let[a,e]=(0,p.useState)(h);(0,p.useEffect)(()=>{e(h)},[]);let t=(0,p.useCallback)(o=>d(o),[]),r=(0,p.useCallback)(o=>{w(o)},[]),n=(0,p.useCallback)(o=>{g(o)},[]),c=(0,p.useCallback)(o=>{x(o)},[]),f=(0,p.useCallback)(o=>{R(o)},[]),l=(0,p.useCallback)(o=>{P(o)},[]),s=(0,p.useCallback)((o,C,T)=>{H(o,C,T)},[]),u=(0,p.useCallback)((...o)=>y(...o),[]),m=(0,p.useCallback)((o,C)=>k(o,C),[]);return{isSupported:a,vibrate:t,fadeIn:r,fadeOut:n,notification:c,heartbeat:f,clunk:l,pwm:s,createPattern:u,createPatternPWM:m}}var q=N;var F=require("react");function Q(a=50,e={}){let{enabled:t=!0,onSuccess:r,onError:n}=e;return(0,F.useCallback)(f=>{if(!t||!h)return!1;try{let l=d(f||a);return l&&r&&r(),l}catch(l){return n&&n(l),!1}},[a,t,r,n])}var L=Q;var b=require("react");function U(){let[a,e]=(0,b.useState)(!1),[t,r]=(0,b.useState)(null),n=(0,b.useRef)(!1),c=(0,b.useCallback)(()=>{n.current||(E(),e(!0),n.current=!0)},[]),f=(0,b.useCallback)(()=>{if(!n.current)return;let u=V();return r(u),e(!1),n.current=!1,u},[]),l=(0,b.useCallback)(u=>{let m=u||t;m&&d(m)},[t]),s=(0,b.useCallback)(()=>{r(null)},[]);return{isRecording:a,recordedPattern:t,startRecording:c,stopRecording:f,playback:l,reset:s}}var W=U;var v=require("react");var D=require("react/jsx-runtime"),O=(0,v.createContext)(null);function _({children:a,defaultEnabled:e=!0}){let[t,r]=(0,v.useState)(e&&h),[n]=(0,v.useState)(h),c=(0,v.useCallback)(s=>t?d(s):!1,[t]),f=(0,v.useCallback)((s,u=50)=>t?{click:()=>P(u),success:()=>w(u),error:()=>d([50,50,50,50,50]),notification:()=>x(u),subtle:()=>H(u,5,25),medium:()=>H(u,15,15),strong:()=>H(u,25,5)}[s]||(()=>d(u)):()=>{},[t]),l={enabled:t,isSupported:n,setEnabled:r,vibrate:c,createFeedback:f,fadeIn:s=>t&&w(s),fadeOut:s=>t&&g(s),notification:s=>t&&x(s),heartbeat:s=>t&&R(s),clunk:s=>t&&P(s),pwm:(s,u,m)=>t&&H(s,u,m),createPattern:y,createPatternPWM:k};return(0,D.jsx)(O.Provider,{value:l,children:a})}function z(){let a=(0,v.useContext)(O);if(!a)throw new Error("useHapticsContext must be used within HapticsProvider");return a}var M=class{constructor(){this.enabled=!1,this.currentRecording=null,this.navigatorVibrate=null,this.logHistory=[],this._initialize()}_initialize(){typeof navigator>"u"||(this.navigatorVibrate=navigator.vibrate?.bind(navigator)||navigator.webkitVibrate?.bind(navigator)||navigator.mozVibrate?.bind(navigator)||navigator.msVibrate?.bind(navigator),this.enabled=!!this.navigatorVibrate)}log(...e){this.logHistory.push(e),typeof console<"u"&&console.log(...e)}vibrate(e){if(this.enabled&&this.navigatorVibrate)try{return this.navigatorVibrate(e),!0}catch(t){return this.log("Vibration failed:",t),!1}return!1}executeSequence(e,t,r){if(!this.enabled)return!1;let n=e.shift(),c=r||t;try{t(n)}catch(f){this.log("Sequence execution failed:",f)}return e.length===0?!0:setTimeout(()=>this.executeSequence(e,c,t),n)}createSequenceFunc(e){let t=e.reduce((r,n)=>r+n,0);return r=>{let n=r/t,c=e.map(f=>f*n);this.vibrate(c)}}concatenatePatternFuncs(...e){return t=>{let r=t/e.length;e.forEach((n,c)=>{setTimeout(()=>n(r),c*r)})}}patternFactory(...e){let t=e.map(n=>typeof n!="function"?this.createSequenceFunc(n):n),r=this.concatenatePatternFuncs(...t);return n=>{typeof n=="number"?r(n):this.executeSequence([...n],r,()=>{})}}createPattern(...e){let t;if(e.length>1)t=this.patternFactory(...e);else if(e[0]&&typeof e[0]!="function"&&e[0].length)t=this.createSequenceFunc(e[0]);else{if(e[0]&&typeof e[0]!="function")return null;t=e[0]}return r=>{typeof r=="number"?t(r):this.executeSequence([...r],t,()=>{})}}startRecording(){this.currentRecording=[];let e=t=>{t.preventDefault(),this.currentRecording.push(new Date)};this._recordHandlers={onRecord:e},typeof window<"u"&&(window.addEventListener("touchstart",e,!1),window.addEventListener("touchend",e,!1),window.addEventListener("mousedown",e,!1),window.addEventListener("mouseup",e,!1))}stopRecording(){if(typeof window<"u"&&this._recordHandlers){let{onRecord:t}=this._recordHandlers;window.removeEventListener("touchstart",t),window.removeEventListener("touchend",t),window.removeEventListener("mousedown",t),window.removeEventListener("mouseup",t)}if(!this.currentRecording)return[];this.currentRecording.length%2!==0&&this.currentRecording.push(new Date);let e=[];for(let t=0;t<this.currentRecording.length;t+=2){let r=t+1;if(r>=this.currentRecording.length)break;e.push(this.currentRecording[r]-this.currentRecording[t])}return e}fadeIn(e){let t=[];if(e<100){this.vibrate(e);return}let r=e/100;for(let n=1;n<=10;n++)t.push(n*r),n<10&&t.push((10-n)*r);this.vibrate(t)}fadeOut(e){let t=[];if(e<100){this.vibrate(e);return}let r=e/100;for(let n=1;n<=10;n++)t.push(n*r),n<10&&t.push((10-n)*r);this.vibrate(t.reverse())}notification(e){let t=e/27,r=2*t,n=3*t;this.vibrate([r,t,r,t,r,t*2,n,t,n,t*2,r,t,r,t,r])}heartbeat(e){let t=e/60,r=t*2,n=t*24;this.vibrate([t,r,n,r*2,n,r*2,t])}clunk(e){let t=e*4/22,r=t*2,n=t/2*5;this.vibrate([t,r,n])}pwm(e,t,r){let n=[t],c=e-t;for(;c>0;)c-=r,c-=t,n.push(r),n.push(t);this.vibrate(n)}createPatternPWM(e,t){return r=>{if(typeof r=="number")this.pwm(r,e,t);else{let n=c=>this.pwm(c,e,t);this.executeSequence([...r],n,()=>{})}}}},i=new M,h=i.enabled,d=i.vibrate.bind(i),E=i.startRecording.bind(i),V=i.stopRecording.bind(i),w=i.createPattern(i.fadeIn.bind(i)),g=i.createPattern(i.fadeOut.bind(i)),x=i.createPattern(i.notification.bind(i)),R=i.createPattern(i.heartbeat.bind(i)),P=i.createPattern(i.clunk.bind(i)),H=i.pwm.bind(i),k=i.createPatternPWM.bind(i),y=i.createPattern.bind(i),X={enabled:h,vibrate:d,record:E,finish:V,fadeIn:w,fadeOut:g,notification:x,heartbeat:R,clunk:P,pwm:H,createPatternPWM:k,createPattern:y};0&&(module.exports={HapticsProvider,clunk,createPattern,createPatternPWM,enabled,fadeIn,fadeOut,finish,heartbeat,notification,pwm,record,useHapticFeedback,useHapticRecorder,useHaptics,useHapticsContext,vibrate});

package/dist/index.mjs

@@ -0,0 +1 @@
+import{useCallback as l,useEffect as W,useState as O}from"react";function _(){let[u,e]=O(h);W(()=>{e(h)},[]);let t=l(c=>d(c),[]),n=l(c=>{H(c)},[]),r=l(c=>{x(c)},[]),s=l(c=>{m(c)},[]),p=l(c=>{P(c)},[]),f=l(c=>{w(c)},[]),a=l((c,S,L)=>{b(c,S,L)},[]),o=l((...c)=>R(...c),[]),v=l((c,S)=>g(c,S),[]);return{isSupported:u,vibrate:t,fadeIn:n,fadeOut:r,notification:s,heartbeat:p,clunk:f,pwm:a,createPattern:o,createPatternPWM:v}}var z=_;import{useCallback as D}from"react";function T(u=50,e={}){let{enabled:t=!0,onSuccess:n,onError:r}=e;return D(p=>{if(!t||!h)return!1;try{let f=d(p||u);return f&&n&&n(),f}catch(f){return r&&r(f),!1}},[u,t,n,r])}var j=T;import{useState as I,useCallback as y,useRef as A}from"react";function B(){let[u,e]=I(!1),[t,n]=I(null),r=A(!1),s=y(()=>{r.current||(E(),e(!0),r.current=!0)},[]),p=y(()=>{if(!r.current)return;let o=V();return n(o),e(!1),r.current=!1,o},[]),f=y(o=>{let v=o||t;v&&d(v)},[t]),a=y(()=>{n(null)},[]);return{isRecording:u,recordedPattern:t,startRecording:s,stopRecording:p,playback:f,reset:a}}var G=B;import{createContext as J,useContext as K,useState as M,useCallback as q}from"react";import{jsx as U}from"react/jsx-runtime";var F=J(null);function N({children:u,defaultEnabled:e=!0}){let[t,n]=M(e&&h),[r]=M(h),s=q(a=>t?d(a):!1,[t]),p=q((a,o=50)=>t?{click:()=>w(o),success:()=>H(o),error:()=>d([50,50,50,50,50]),notification:()=>m(o),subtle:()=>b(o,5,25),medium:()=>b(o,15,15),strong:()=>b(o,25,5)}[a]||(()=>d(o)):()=>{},[t]),f={enabled:t,isSupported:r,setEnabled:n,vibrate:s,createFeedback:p,fadeIn:a=>t&&H(a),fadeOut:a=>t&&x(a),notification:a=>t&&m(a),heartbeat:a=>t&&P(a),clunk:a=>t&&w(a),pwm:(a,o,v)=>t&&b(a,o,v),createPattern:R,createPatternPWM:g};return U(F.Provider,{value:f,children:u})}function Q(){let u=K(F);if(!u)throw new Error("useHapticsContext must be used within HapticsProvider");return u}var C=class{constructor(){this.enabled=!1,this.currentRecording=null,this.navigatorVibrate=null,this.logHistory=[],this._initialize()}_initialize(){typeof navigator>"u"||(this.navigatorVibrate=navigator.vibrate?.bind(navigator)||navigator.webkitVibrate?.bind(navigator)||navigator.mozVibrate?.bind(navigator)||navigator.msVibrate?.bind(navigator),this.enabled=!!this.navigatorVibrate)}log(...e){this.logHistory.push(e),typeof console<"u"&&console.log(...e)}vibrate(e){if(this.enabled&&this.navigatorVibrate)try{return this.navigatorVibrate(e),!0}catch(t){return this.log("Vibration failed:",t),!1}return!1}executeSequence(e,t,n){if(!this.enabled)return!1;let r=e.shift(),s=n||t;try{t(r)}catch(p){this.log("Sequence execution failed:",p)}return e.length===0?!0:setTimeout(()=>this.executeSequence(e,s,t),r)}createSequenceFunc(e){let t=e.reduce((n,r)=>n+r,0);return n=>{let r=n/t,s=e.map(p=>p*r);this.vibrate(s)}}concatenatePatternFuncs(...e){return t=>{let n=t/e.length;e.forEach((r,s)=>{setTimeout(()=>r(n),s*n)})}}patternFactory(...e){let t=e.map(r=>typeof r!="function"?this.createSequenceFunc(r):r),n=this.concatenatePatternFuncs(...t);return r=>{typeof r=="number"?n(r):this.executeSequence([...r],n,()=>{})}}createPattern(...e){let t;if(e.length>1)t=this.patternFactory(...e);else if(e[0]&&typeof e[0]!="function"&&e[0].length)t=this.createSequenceFunc(e[0]);else{if(e[0]&&typeof e[0]!="function")return null;t=e[0]}return n=>{typeof n=="number"?t(n):this.executeSequence([...n],t,()=>{})}}startRecording(){this.currentRecording=[];let e=t=>{t.preventDefault(),this.currentRecording.push(new Date)};this._recordHandlers={onRecord:e},typeof window<"u"&&(window.addEventListener("touchstart",e,!1),window.addEventListener("touchend",e,!1),window.addEventListener("mousedown",e,!1),window.addEventListener("mouseup",e,!1))}stopRecording(){if(typeof window<"u"&&this._recordHandlers){let{onRecord:t}=this._recordHandlers;window.removeEventListener("touchstart",t),window.removeEventListener("touchend",t),window.removeEventListener("mousedown",t),window.removeEventListener("mouseup",t)}if(!this.currentRecording)return[];this.currentRecording.length%2!==0&&this.currentRecording.push(new Date);let e=[];for(let t=0;t<this.currentRecording.length;t+=2){let n=t+1;if(n>=this.currentRecording.length)break;e.push(this.currentRecording[n]-this.currentRecording[t])}return e}fadeIn(e){let t=[];if(e<100){this.vibrate(e);return}let n=e/100;for(let r=1;r<=10;r++)t.push(r*n),r<10&&t.push((10-r)*n);this.vibrate(t)}fadeOut(e){let t=[];if(e<100){this.vibrate(e);return}let n=e/100;for(let r=1;r<=10;r++)t.push(r*n),r<10&&t.push((10-r)*n);this.vibrate(t.reverse())}notification(e){let t=e/27,n=2*t,r=3*t;this.vibrate([n,t,n,t,n,t*2,r,t,r,t*2,n,t,n,t,n])}heartbeat(e){let t=e/60,n=t*2,r=t*24;this.vibrate([t,n,r,n*2,r,n*2,t])}clunk(e){let t=e*4/22,n=t*2,r=t/2*5;this.vibrate([t,n,r])}pwm(e,t,n){let r=[t],s=e-t;for(;s>0;)s-=n,s-=t,r.push(n),r.push(t);this.vibrate(r)}createPatternPWM(e,t){return n=>{if(typeof n=="number")this.pwm(n,e,t);else{let r=s=>this.pwm(s,e,t);this.executeSequence([...n],r,()=>{})}}}},i=new C,h=i.enabled,d=i.vibrate.bind(i),E=i.startRecording.bind(i),V=i.stopRecording.bind(i),H=i.createPattern(i.fadeIn.bind(i)),x=i.createPattern(i.fadeOut.bind(i)),m=i.createPattern(i.notification.bind(i)),P=i.createPattern(i.heartbeat.bind(i)),w=i.createPattern(i.clunk.bind(i)),b=i.pwm.bind(i),g=i.createPatternPWM.bind(i),R=i.createPattern.bind(i),ct={enabled:h,vibrate:d,record:E,finish:V,fadeIn:H,fadeOut:x,notification:m,heartbeat:P,clunk:w,pwm:b,createPatternPWM:g,createPattern:R};export{N as HapticsProvider,w as clunk,R as createPattern,g as createPatternPWM,ct as default,h as enabled,H as fadeIn,x as fadeOut,V as finish,P as heartbeat,m as notification,b as pwm,E as record,j as useHapticFeedback,G as useHapticRecorder,z as useHaptics,Q as useHapticsContext,d as vibrate};

package/package.json

@@ -0,0 +1,40 @@
+{
+    "name": "@thesonicprint/haptics",
+    "version": "1.0.0",
+    "description": "Modern haptics library for React and PWA",
+    "main": "./dist/index.js",
+    "module": "./dist/index.mjs",
+    "types": "./dist/index.d.ts",
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsup index.js --format cjs,esm --dts --clean --minify --external react,react-dom",
+        "dev": "tsup index.js --format cjs,esm --watch --dts",
+        "lint": "eslint ."
+    },
+    "keywords": [
+        "haptics",
+        "vibrate",
+        "react",
+        "pwa",
+        "feedback"
+    ],
+    "author": "Sonicprint",
+    "license": "MIT",
+    "peerDependencies": {
+        "react": ">=16.8.0",
+        "react-dom": ">=16.8.0"
+    },
+    "devDependencies": {
+        "tsup": "^8.0.0",
+        "typescript": "^5.0.0",
+        "react": "^18.2.0",
+        "react-dom": "^18.2.0",
+        "@types/react": "^18.2.0",
+        "@types/react-dom": "^18.2.0"
+    },
+    "publishConfig": {
+        "access": "public"
+    }
+}