@hapticjs/core 0.1.0 → 0.2.1

package/dist/index.d.ts

@@ -284,24 +284,48 @@ declare class NoopAdapter implements HapticAdapter {
 /**
  * Web Vibration API adapter.
  * Uses navigator.vibrate() — supported on Android browsers.
- * Intensity is simulated via PWM (rapid on/off) since the API only supports on/off.
+ * Android Vibration API is on/off only — no intensity control.
+ * We ignore intensity and just vibrate for the requested duration.
  */
 declare class WebVibrationAdapter implements HapticAdapter {
     readonly name = "web-vibration";
     readonly supported: boolean;
-    private _cancelled;
     constructor();
     capabilities(): AdapterCapabilities;
     pulse(_intensity: number, duration: number): Promise<void>;
     playSequence(steps: HapticStep[]): Promise<void>;
     cancel(): void;
     dispose(): void;
-    /** Convert steps to Vibration API pattern array */
-    private _toVibrationPattern;
-    /** Check if all steps can be played with native pattern (no intensity variation) */
-    private _canUseNativePattern;
-    /** Simulate lower intensity via pulse-width modulation */
-    private _pwmVibrate;
+}
+
+/**
+ * iOS Audio workaround adapter.
+ * Uses AudioContext to generate short, low-frequency oscillator tones (20-60 Hz)
+ * that create a subtle physical sensation through device speakers.
+ * This is a fallback for iOS Safari, which does not support the Vibration API.
+ */
+declare class IoSAudioAdapter implements HapticAdapter {
+    readonly name = "ios-audio";
+    readonly supported: boolean;
+    private _audioCtx;
+    private _activeOscillator;
+    private _activeGain;
+    private _cancelled;
+    constructor();
+    capabilities(): AdapterCapabilities;
+    pulse(intensity: number, duration: number): Promise<void>;
+    playSequence(steps: HapticStep[]): Promise<void>;
+    cancel(): void;
+    dispose(): void;
+    private _detectSupport;
+    /** Get or create the AudioContext, resuming if suspended */
+    private _getAudioContext;
+    /** Map intensity (0-1) to frequency in the 20-60 Hz sub-bass range */
+    private _intensityToFrequency;
+    /** Play a single oscillator tone for the given duration */
+    private _playTone;
+    /** Immediately stop the active oscillator if any */
+    private _stopOscillator;
 }
 
 declare class HPLParserError extends Error {
@@ -357,6 +381,61 @@ interface ValidationResult {
 }
 declare function validateHPL(input: string): ValidationResult;
 
+/** Portable JSON-serializable format for sharing haptic patterns */
+interface HapticPatternExport {
+    version: 1;
+    name: string;
+    description?: string;
+    /** Original HPL string if pattern was created from HPL */
+    hpl?: string;
+    /** Compiled haptic steps */
+    steps: HapticStep[];
+    metadata?: {
+        /** Total duration in milliseconds */
+        duration: number;
+        author?: string;
+        tags?: string[];
+        /** ISO date string */
+        createdAt?: string;
+    };
+}
+/** Options for exporting a pattern */
+interface ExportOptions {
+    name?: string;
+    description?: string;
+    author?: string;
+    tags?: string[];
+}
+/** Input types accepted by exportPattern */
+type ExportInput = HapticPattern | HapticStep[] | string;
+/**
+ * Export a haptic pattern as a portable JSON-serializable object.
+ *
+ * Accepts a HapticPattern, HapticStep[], or HPL string.
+ */
+declare function exportPattern(input: ExportInput, options?: ExportOptions): HapticPatternExport;
+/**
+ * Import a pattern from a HapticPatternExport object or JSON string.
+ * Validates the data and returns a HapticPattern.
+ */
+declare function importPattern(data: HapticPatternExport | string): HapticPattern;
+/**
+ * Serialize a pattern to a pretty-printed JSON string.
+ */
+declare function patternToJSON(input: ExportInput, options?: ExportOptions): string;
+/**
+ * Parse a JSON string into a HapticPattern.
+ */
+declare function patternFromJSON(json: string): HapticPattern;
+/**
+ * Encode a pattern as a data: URL for easy sharing via links.
+ */
+declare function patternToDataURL(input: ExportInput, options?: ExportOptions): string;
+/**
+ * Decode a data: URL back to a HapticPattern.
+ */
+declare function patternFromDataURL(url: string): HapticPattern;
+
 /** Platform detection utilities */
 interface PlatformInfo {
     isWeb: boolean;
@@ -381,4 +460,4 @@ declare function detectPlatform(): PlatformInfo;
  */
 declare const haptic: HapticEngine;
 
-export { type AdapterCapabilities, AdaptiveEngine, type EasingFunction, type FallbackConfig, FallbackManager, type HPLNode, type HPLNodeType, HPLParser, HPLParserError, type HPLToken, type HPLTokenType, HPLTokenizerError, type HapticAdapter, type HapticConfig, HapticEngine, type HapticPattern, type HapticStep, type ImpactStyle, NoopAdapter, type NotificationType, PatternComposer, type PlatformInfo, type SemanticEffect, type ValidationResult, type VisualFallbackStyle, WebVibrationAdapter, compile, detectAdapter, detectPlatform, haptic, optimizeSteps, parseHPL, tokenize, validateHPL };
+export { type AdapterCapabilities, AdaptiveEngine, type EasingFunction, type ExportOptions, type FallbackConfig, FallbackManager, type HPLNode, type HPLNodeType, HPLParser, HPLParserError, type HPLToken, type HPLTokenType, HPLTokenizerError, type HapticAdapter, type HapticConfig, HapticEngine, type HapticPattern, type HapticPatternExport, type HapticStep, type ImpactStyle, IoSAudioAdapter, NoopAdapter, type NotificationType, PatternComposer, type PlatformInfo, type SemanticEffect, type ValidationResult, type VisualFallbackStyle, WebVibrationAdapter, compile, detectAdapter, detectPlatform, exportPattern, haptic, importPattern, optimizeSteps, parseHPL, patternFromDataURL, patternFromJSON, patternToDataURL, patternToJSON, tokenize, validateHPL };