@haptics/vanilla 1.0.0

package/dist/index.cjs

@@ -0,0 +1,76 @@
+'use strict';
+
+var core = require('@haptics/core');
+
+// src/haptics.ts
+var Haptics = class {
+  constructor(options = {}) {
+    this.prefersReducedMotion = false;
+    this.destroyed = false;
+    this.mqlHandler = null;
+    this.mql = null;
+    this.patterns = { ...core.PRESETS, ...options.patterns };
+    this.respectReducedMotion = options.respectReducedMotion ?? true;
+    this.delegateFrom = options.delegateFrom ?? document;
+    this.selector = options.selector ?? "[data-haptic]";
+    this.isSupported = core.isVibrationSupported();
+    this.isIOSSupported = core.isIOS();
+    if (this.respectReducedMotion && typeof window !== "undefined" && window.matchMedia) {
+      this.mql = window.matchMedia("(prefers-reduced-motion: reduce)");
+      this.prefersReducedMotion = this.mql.matches;
+      this.mqlHandler = (e) => {
+        this.prefersReducedMotion = e.matches;
+      };
+      this.mql.addEventListener("change", this.mqlHandler);
+    }
+    this.clickHandler = (e) => {
+      if (this.destroyed) return;
+      if (this.respectReducedMotion && this.prefersReducedMotion) return;
+      const target = e.target?.closest(this.selector);
+      if (!target) return;
+      const action = target.getAttribute("data-haptic");
+      if (!action || !(action in this.patterns)) return;
+      const pattern = this.patterns[action];
+      if (this.isSupported) {
+        navigator.vibrate(core.toVibrateSequence(pattern));
+      } else if (this.isIOSSupported) {
+        core.schedulePattern(pattern);
+      }
+    };
+    this.delegateFrom.addEventListener("click", this.clickHandler, {
+      capture: true,
+      passive: true
+    });
+  }
+  /** Trigger haptic feedback imperatively by pattern name. */
+  trigger(action) {
+    if (this.destroyed) return;
+    if (this.respectReducedMotion && this.prefersReducedMotion) return;
+    const pattern = this.patterns[action];
+    if (!pattern) return;
+    if (this.isSupported) {
+      navigator.vibrate(core.toVibrateSequence(pattern));
+    } else if (this.isIOSSupported) {
+      core.schedulePattern(pattern);
+    }
+  }
+  /** Cancel active vibration (Android only). */
+  cancel() {
+    if (this.isSupported) navigator.vibrate(0);
+  }
+  /** Remove all listeners and clean up. */
+  destroy() {
+    if (this.destroyed) return;
+    this.destroyed = true;
+    this.delegateFrom.removeEventListener("click", this.clickHandler, {
+      capture: true
+    });
+    if (this.mql && this.mqlHandler) {
+      this.mql.removeEventListener("change", this.mqlHandler);
+    }
+  }
+};
+
+exports.Haptics = Haptics;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/haptics.ts"],"names":["PRESETS","isVibrationSupported","isIOS","toVibrateSequence","schedulePattern"],"mappings":"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","file":"index.cjs","sourcesContent":["import {\n\tPRESETS,\n\tisVibrationSupported,\n\tisIOS,\n\ttoVibrateSequence,\n\tschedulePattern,\n} from \"@haptics/core\";\nimport type { HapticPattern, PresetName } from \"@haptics/core\";\n\nexport interface HapticsOptions {\n\t/**\n\t * Element to delegate click events from. The capture-phase listener\n\t * is registered on this element. Default: document.\n\t */\n\tdelegateFrom?: Element | Document;\n\t/**\n\t * CSS selector for elements that trigger haptics on click.\n\t * Default: \"[data-haptic]\"\n\t */\n\tselector?: string;\n\t/** Custom patterns merged with built-in presets. */\n\tpatterns?: Record<string, HapticPattern>;\n\t/** Suppress haptics when prefers-reduced-motion is active. Default: true */\n\trespectReducedMotion?: boolean;\n}\n\n/**\n * Zero-framework haptic feedback controller.\n *\n * Registers a capture-phase click listener that intercepts clicks on\n * elements matching the selector, reads the pattern name from data-haptic,\n * and fires the appropriate haptic feedback.\n *\n * Works with HTMX, Alpine.js, Stimulus, plain HTML — anything.\n */\nexport class Haptics {\n\tprivate readonly patterns: Record<string, HapticPattern>;\n\tprivate readonly respectReducedMotion: boolean;\n\tprivate readonly delegateFrom: Element | Document;\n\tprivate readonly selector: string;\n\tprivate prefersReducedMotion = false;\n\tprivate destroyed = false;\n\tprivate readonly clickHandler: (e: Event) => void;\n\tprivate mqlHandler: ((e: MediaQueryListEvent) => void) | null = null;\n\tprivate mql: MediaQueryList | null = null;\n\n\treadonly isSupported: boolean;\n\treadonly isIOSSupported: boolean;\n\n\tconstructor(options: HapticsOptions = {}) {\n\t\tthis.patterns = { ...PRESETS, ...options.patterns };\n\t\tthis.respectReducedMotion = options.respectReducedMotion ?? true;\n\t\tthis.delegateFrom = options.delegateFrom ?? document;\n\t\tthis.selector = options.selector ?? \"[data-haptic]\";\n\t\tthis.isSupported = isVibrationSupported();\n\t\tthis.isIOSSupported = isIOS();\n\n\t\tif (\n\t\t\tthis.respectReducedMotion &&\n\t\t\ttypeof window !== \"undefined\" &&\n\t\t\twindow.matchMedia\n\t\t) {\n\t\t\tthis.mql = window.matchMedia(\"(prefers-reduced-motion: reduce)\");\n\t\t\tthis.prefersReducedMotion = this.mql.matches;\n\t\t\tthis.mqlHandler = (e: MediaQueryListEvent) => {\n\t\t\t\tthis.prefersReducedMotion = e.matches;\n\t\t\t};\n\t\t\tthis.mql.addEventListener(\"change\", this.mqlHandler);\n\t\t}\n\n\t\tthis.clickHandler = (e: Event) => {\n\t\t\tif (this.destroyed) return;\n\t\t\tif (this.respectReducedMotion && this.prefersReducedMotion) return;\n\n\t\t\tconst target = (e.target as Element)?.closest(this.selector);\n\t\t\tif (!target) return;\n\n\t\t\tconst action = target.getAttribute(\"data-haptic\");\n\t\t\tif (!action || !(action in this.patterns)) return;\n\n\t\t\tconst pattern = this.patterns[action];\n\t\t\tif (this.isSupported) {\n\t\t\t\tnavigator.vibrate(toVibrateSequence(pattern));\n\t\t\t} else if (this.isIOSSupported) {\n\t\t\t\tschedulePattern(pattern);\n\t\t\t}\n\t\t};\n\n\t\tthis.delegateFrom.addEventListener(\"click\", this.clickHandler, {\n\t\t\tcapture: true,\n\t\t\tpassive: true,\n\t\t});\n\t}\n\n\t/** Trigger haptic feedback imperatively by pattern name. */\n\ttrigger(action: PresetName | (string & {})): void {\n\t\tif (this.destroyed) return;\n\t\tif (this.respectReducedMotion && this.prefersReducedMotion) return;\n\n\t\tconst pattern = this.patterns[action];\n\t\tif (!pattern) return;\n\n\t\tif (this.isSupported) {\n\t\t\tnavigator.vibrate(toVibrateSequence(pattern));\n\t\t} else if (this.isIOSSupported) {\n\t\t\tschedulePattern(pattern);\n\t\t}\n\t}\n\n\t/** Cancel active vibration (Android only). */\n\tcancel(): void {\n\t\tif (this.isSupported) navigator.vibrate(0);\n\t}\n\n\t/** Remove all listeners and clean up. */\n\tdestroy(): void {\n\t\tif (this.destroyed) return;\n\t\tthis.destroyed = true;\n\n\t\tthis.delegateFrom.removeEventListener(\"click\", this.clickHandler, {\n\t\t\tcapture: true,\n\t\t} as EventListenerOptions);\n\n\t\tif (this.mql && this.mqlHandler) {\n\t\t\tthis.mql.removeEventListener(\"change\", this.mqlHandler);\n\t\t}\n\t}\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,49 @@
+import { HapticPattern, PresetName } from '@haptics/core';
+
+interface HapticsOptions {
+    /**
+     * Element to delegate click events from. The capture-phase listener
+     * is registered on this element. Default: document.
+     */
+    delegateFrom?: Element | Document;
+    /**
+     * CSS selector for elements that trigger haptics on click.
+     * Default: "[data-haptic]"
+     */
+    selector?: string;
+    /** Custom patterns merged with built-in presets. */
+    patterns?: Record<string, HapticPattern>;
+    /** Suppress haptics when prefers-reduced-motion is active. Default: true */
+    respectReducedMotion?: boolean;
+}
+/**
+ * Zero-framework haptic feedback controller.
+ *
+ * Registers a capture-phase click listener that intercepts clicks on
+ * elements matching the selector, reads the pattern name from data-haptic,
+ * and fires the appropriate haptic feedback.
+ *
+ * Works with HTMX, Alpine.js, Stimulus, plain HTML — anything.
+ */
+declare class Haptics {
+    private readonly patterns;
+    private readonly respectReducedMotion;
+    private readonly delegateFrom;
+    private readonly selector;
+    private prefersReducedMotion;
+    private destroyed;
+    private readonly clickHandler;
+    private mqlHandler;
+    private mql;
+    readonly isSupported: boolean;
+    readonly isIOSSupported: boolean;
+    constructor(options?: HapticsOptions);
+    /** Trigger haptic feedback imperatively by pattern name. */
+    trigger(action: PresetName | (string & {})): void;
+    /** Cancel active vibration (Android only). */
+    cancel(): void;
+    /** Remove all listeners and clean up. */
+    destroy(): void;
+}
+
+export { Haptics, type HapticsOptions };

package/dist/index.d.ts

@@ -0,0 +1,49 @@
+import { HapticPattern, PresetName } from '@haptics/core';
+
+interface HapticsOptions {
+    /**
+     * Element to delegate click events from. The capture-phase listener
+     * is registered on this element. Default: document.
+     */
+    delegateFrom?: Element | Document;
+    /**
+     * CSS selector for elements that trigger haptics on click.
+     * Default: "[data-haptic]"
+     */
+    selector?: string;
+    /** Custom patterns merged with built-in presets. */
+    patterns?: Record<string, HapticPattern>;
+    /** Suppress haptics when prefers-reduced-motion is active. Default: true */
+    respectReducedMotion?: boolean;
+}
+/**
+ * Zero-framework haptic feedback controller.
+ *
+ * Registers a capture-phase click listener that intercepts clicks on
+ * elements matching the selector, reads the pattern name from data-haptic,
+ * and fires the appropriate haptic feedback.
+ *
+ * Works with HTMX, Alpine.js, Stimulus, plain HTML — anything.
+ */
+declare class Haptics {
+    private readonly patterns;
+    private readonly respectReducedMotion;
+    private readonly delegateFrom;
+    private readonly selector;
+    private prefersReducedMotion;
+    private destroyed;
+    private readonly clickHandler;
+    private mqlHandler;
+    private mql;
+    readonly isSupported: boolean;
+    readonly isIOSSupported: boolean;
+    constructor(options?: HapticsOptions);
+    /** Trigger haptic feedback imperatively by pattern name. */
+    trigger(action: PresetName | (string & {})): void;
+    /** Cancel active vibration (Android only). */
+    cancel(): void;
+    /** Remove all listeners and clean up. */
+    destroy(): void;
+}
+
+export { Haptics, type HapticsOptions };

package/dist/index.js

@@ -0,0 +1,74 @@
+import { PRESETS, isVibrationSupported, isIOS, toVibrateSequence, schedulePattern } from '@haptics/core';
+
+// src/haptics.ts
+var Haptics = class {
+  constructor(options = {}) {
+    this.prefersReducedMotion = false;
+    this.destroyed = false;
+    this.mqlHandler = null;
+    this.mql = null;
+    this.patterns = { ...PRESETS, ...options.patterns };
+    this.respectReducedMotion = options.respectReducedMotion ?? true;
+    this.delegateFrom = options.delegateFrom ?? document;
+    this.selector = options.selector ?? "[data-haptic]";
+    this.isSupported = isVibrationSupported();
+    this.isIOSSupported = isIOS();
+    if (this.respectReducedMotion && typeof window !== "undefined" && window.matchMedia) {
+      this.mql = window.matchMedia("(prefers-reduced-motion: reduce)");
+      this.prefersReducedMotion = this.mql.matches;
+      this.mqlHandler = (e) => {
+        this.prefersReducedMotion = e.matches;
+      };
+      this.mql.addEventListener("change", this.mqlHandler);
+    }
+    this.clickHandler = (e) => {
+      if (this.destroyed) return;
+      if (this.respectReducedMotion && this.prefersReducedMotion) return;
+      const target = e.target?.closest(this.selector);
+      if (!target) return;
+      const action = target.getAttribute("data-haptic");
+      if (!action || !(action in this.patterns)) return;
+      const pattern = this.patterns[action];
+      if (this.isSupported) {
+        navigator.vibrate(toVibrateSequence(pattern));
+      } else if (this.isIOSSupported) {
+        schedulePattern(pattern);
+      }
+    };
+    this.delegateFrom.addEventListener("click", this.clickHandler, {
+      capture: true,
+      passive: true
+    });
+  }
+  /** Trigger haptic feedback imperatively by pattern name. */
+  trigger(action) {
+    if (this.destroyed) return;
+    if (this.respectReducedMotion && this.prefersReducedMotion) return;
+    const pattern = this.patterns[action];
+    if (!pattern) return;
+    if (this.isSupported) {
+      navigator.vibrate(toVibrateSequence(pattern));
+    } else if (this.isIOSSupported) {
+      schedulePattern(pattern);
+    }
+  }
+  /** Cancel active vibration (Android only). */
+  cancel() {
+    if (this.isSupported) navigator.vibrate(0);
+  }
+  /** Remove all listeners and clean up. */
+  destroy() {
+    if (this.destroyed) return;
+    this.destroyed = true;
+    this.delegateFrom.removeEventListener("click", this.clickHandler, {
+      capture: true
+    });
+    if (this.mql && this.mqlHandler) {
+      this.mql.removeEventListener("change", this.mqlHandler);
+    }
+  }
+};
+
+export { Haptics };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/haptics.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import {\n\tPRESETS,\n\tisVibrationSupported,\n\tisIOS,\n\ttoVibrateSequence,\n\tschedulePattern,\n} from \"@haptics/core\";\nimport type { HapticPattern, PresetName } from \"@haptics/core\";\n\nexport interface HapticsOptions {\n\t/**\n\t * Element to delegate click events from. The capture-phase listener\n\t * is registered on this element. Default: document.\n\t */\n\tdelegateFrom?: Element | Document;\n\t/**\n\t * CSS selector for elements that trigger haptics on click.\n\t * Default: \"[data-haptic]\"\n\t */\n\tselector?: string;\n\t/** Custom patterns merged with built-in presets. */\n\tpatterns?: Record<string, HapticPattern>;\n\t/** Suppress haptics when prefers-reduced-motion is active. Default: true */\n\trespectReducedMotion?: boolean;\n}\n\n/**\n * Zero-framework haptic feedback controller.\n *\n * Registers a capture-phase click listener that intercepts clicks on\n * elements matching the selector, reads the pattern name from data-haptic,\n * and fires the appropriate haptic feedback.\n *\n * Works with HTMX, Alpine.js, Stimulus, plain HTML — anything.\n */\nexport class Haptics {\n\tprivate readonly patterns: Record<string, HapticPattern>;\n\tprivate readonly respectReducedMotion: boolean;\n\tprivate readonly delegateFrom: Element | Document;\n\tprivate readonly selector: string;\n\tprivate prefersReducedMotion = false;\n\tprivate destroyed = false;\n\tprivate readonly clickHandler: (e: Event) => void;\n\tprivate mqlHandler: ((e: MediaQueryListEvent) => void) | null = null;\n\tprivate mql: MediaQueryList | null = null;\n\n\treadonly isSupported: boolean;\n\treadonly isIOSSupported: boolean;\n\n\tconstructor(options: HapticsOptions = {}) {\n\t\tthis.patterns = { ...PRESETS, ...options.patterns };\n\t\tthis.respectReducedMotion = options.respectReducedMotion ?? true;\n\t\tthis.delegateFrom = options.delegateFrom ?? document;\n\t\tthis.selector = options.selector ?? \"[data-haptic]\";\n\t\tthis.isSupported = isVibrationSupported();\n\t\tthis.isIOSSupported = isIOS();\n\n\t\tif (\n\t\t\tthis.respectReducedMotion &&\n\t\t\ttypeof window !== \"undefined\" &&\n\t\t\twindow.matchMedia\n\t\t) {\n\t\t\tthis.mql = window.matchMedia(\"(prefers-reduced-motion: reduce)\");\n\t\t\tthis.prefersReducedMotion = this.mql.matches;\n\t\t\tthis.mqlHandler = (e: MediaQueryListEvent) => {\n\t\t\t\tthis.prefersReducedMotion = e.matches;\n\t\t\t};\n\t\t\tthis.mql.addEventListener(\"change\", this.mqlHandler);\n\t\t}\n\n\t\tthis.clickHandler = (e: Event) => {\n\t\t\tif (this.destroyed) return;\n\t\t\tif (this.respectReducedMotion && this.prefersReducedMotion) return;\n\n\t\t\tconst target = (e.target as Element)?.closest(this.selector);\n\t\t\tif (!target) return;\n\n\t\t\tconst action = target.getAttribute(\"data-haptic\");\n\t\t\tif (!action || !(action in this.patterns)) return;\n\n\t\t\tconst pattern = this.patterns[action];\n\t\t\tif (this.isSupported) {\n\t\t\t\tnavigator.vibrate(toVibrateSequence(pattern));\n\t\t\t} else if (this.isIOSSupported) {\n\t\t\t\tschedulePattern(pattern);\n\t\t\t}\n\t\t};\n\n\t\tthis.delegateFrom.addEventListener(\"click\", this.clickHandler, {\n\t\t\tcapture: true,\n\t\t\tpassive: true,\n\t\t});\n\t}\n\n\t/** Trigger haptic feedback imperatively by pattern name. */\n\ttrigger(action: PresetName | (string & {})): void {\n\t\tif (this.destroyed) return;\n\t\tif (this.respectReducedMotion && this.prefersReducedMotion) return;\n\n\t\tconst pattern = this.patterns[action];\n\t\tif (!pattern) return;\n\n\t\tif (this.isSupported) {\n\t\t\tnavigator.vibrate(toVibrateSequence(pattern));\n\t\t} else if (this.isIOSSupported) {\n\t\t\tschedulePattern(pattern);\n\t\t}\n\t}\n\n\t/** Cancel active vibration (Android only). */\n\tcancel(): void {\n\t\tif (this.isSupported) navigator.vibrate(0);\n\t}\n\n\t/** Remove all listeners and clean up. */\n\tdestroy(): void {\n\t\tif (this.destroyed) return;\n\t\tthis.destroyed = true;\n\n\t\tthis.delegateFrom.removeEventListener(\"click\", this.clickHandler, {\n\t\t\tcapture: true,\n\t\t} as EventListenerOptions);\n\n\t\tif (this.mql && this.mqlHandler) {\n\t\t\tthis.mql.removeEventListener(\"change\", this.mqlHandler);\n\t\t}\n\t}\n}\n"]}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@haptics/vanilla",
+  "version": "1.0.0",
+  "description": "Zero-framework haptic feedback controller. Event delegation, imperative API, works with any stack.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/howdoiusekeyboard/haptics.git",
+    "directory": "packages/vanilla"
+  },
+  "author": "Howdoiusekeyboard",
+  "license": "MIT",
+  "keywords": [
+    "haptics",
+    "vanilla",
+    "haptic-feedback",
+    "vibration",
+    "ios",
+    "android",
+    "no-framework",
+    "htmx",
+    "alpine"
+  ],
+  "dependencies": {
+    "@haptics/core": "^1.0.0"
+  },
+  "devDependencies": {
+    "jsdom": "^29.0.0",
+    "tsup": "^8.0.0",
+    "vitest": "^4.1.0"
+  }
+}