@scandit/web-datacapture-core 8.4.0 → 8.5.0-beta.1

package/build/js/private/customHowler/AudioCache.d.ts

@@ -1,37 +1,2 @@
-/// <reference types="emscripten" />
-/**
- * Audio buffer cache manager
- * Avoids re-loading and re-decoding the same audio files
- *
- * Benefits:
- * - Multiple Howl instances for the same sound share one AudioBuffer
- * - Avoids redundant network requests and CPU-intensive decoding
- * - Particularly important for frequently played sounds (like beeps)
- *
- * @private
- */
-declare class AudioCache {
-    private cache;
-    /**
-     * Get a cached audio buffer promise
-     * @param src Audio source URL (data URI or file path)
-     * @returns Promise<AudioBuffer> if cached, undefined otherwise
-     */
-    get(src: string): Promise<AudioBuffer> | undefined;
-    /**
-     * Cache an audio buffer promise
-     * @param src Audio source URL
-     * @param promise Promise that resolves to decoded AudioBuffer
-     */
-    set(src: string, promise: Promise<AudioBuffer>): void;
-    /**
-     * Clear all cached buffers (useful for cleanup or testing)
-     */
-    clear(): void;
-    /**
-     * Get cache size (for monitoring)
-     */
-    size(): number;
-}
-
-export { AudioCache };
+import { t as AudioCache } from "../../AudioCache-D893YEVZ.js";
+export { AudioCache };

package/build/js/private/customHowler/AudioCache.js

@@ -1 +1 @@
-export{a as AudioCache}from'../../chunks/chunk-NYYGU4ZV.js';
+import"./debug.js";var e=class{constructor(){this.cache=new Map}get(e){return this.cache.get(e)}set(e,t){this.cache.set(e,t)}clear(){this.cache.clear()}size(){return this.cache.size}};export{e as AudioCache};

package/build/js/private/customHowler/Howl.d.ts

@@ -1,17 +1,17 @@
-/// <reference types="emscripten" />
+//#region src/main/private/customHowler/Howl.d.ts
 /**
  * Type definitions for customHowler audio system
  * @private
  */
 interface HowlOptions {
-    src: string | string[];
-    /**
-     * Force use of HTML5 audio element instead of Web Audio API.
-     * Useful for testing or specific use cases where HTML5 is preferred.
-     * Default: auto-detect (use Web Audio API everywhere for non-blocking playback)
-     * Note: HTML5 audio blocks the main thread and should be avoided.
-     */
-    html5?: boolean;
+  src: string | string[];
+  /**
+   * Force use of HTML5 audio element instead of Web Audio API.
+   * Useful for testing or specific use cases where HTML5 is preferred.
+   * Default: auto-detect (use Web Audio API everywhere for non-blocking playback)
+   * Note: HTML5 audio blocks the main thread and should be avoided.
+   */
+  html5?: boolean;
 }
 /**
  * Lightweight Howl implementation using Web Audio API
@@ -54,136 +54,136 @@ interface HowlOptions {
  * The decoded AudioBuffer is shared, only the source nodes are created per play.
  */
 declare class Howl {
-    /** Audio source URL (data URI, file path, or URL) */
-    private src;
-    /** Use HTML5 audio element (true) or Web Audio API (false) */
-    private html5;
-    /** Decoded audio buffer (cached after first load) - for Web Audio API only */
-    private audioBuffer;
-    /** Loading promise (prevents duplicate loads) */
-    private loadPromise;
-    /** Pool of HTML5 Sound objects (similar to Howler.js) */
-    private soundPool;
-    private soundPoolSize;
-    /** Track inactive (available) sounds for O(1) lookup instead of O(n) find */
-    private inactiveSounds;
-    constructor(options: HowlOptions);
-    /**
-     * Load and decode the audio file
-     *
-     * ## Caching Strategy
-     *
-     * This method implements three levels of caching:
-     *
-     * 1. **Instance cache**: Check if this Howl instance has already loaded the audio
-     * 2. **Instance promise cache**: Check if this Howl instance is currently loading
-     * 3. **Global cache**: Check if any Howl instance has loaded this URL
-     *
-     * Benefits:
-     * - Multiple Howl instances for the same sound share one AudioBuffer
-     * - Prevents duplicate network requests
-     * - Avoids redundant CPU-intensive audio decoding
-     * - Important for rapid scanning where same sound plays frequently
-     *
-     * ## Loading Process
-     *
-     * 1. Fetch audio file (supports data URIs, relative paths, full URLs)
-     * 2. Convert to ArrayBuffer
-     * 3. Decode using AudioContext.decodeAudioData() (async, CPU-intensive)
-     * 4. Cache the decoded AudioBuffer
-     *
-     * Note: decodeAudioData() runs in a separate thread and doesn't block the main thread
-     *
-     * @returns Promise<AudioBuffer> - Decoded audio ready for playback
-     */
-    private load;
-    /**
-     * Get or create a sound from the pool
-     * Follows Howler.js pattern: pool of Sound objects with state tracking
-     * Uses Set for O(1) lookup of inactive sounds instead of O(n) array find
-     * @private
-     */
-    private getSoundFromPool;
-    /**
-     * Verify audio buffer contains actual data (debugging helper, no-op in production)
-     * @private
-     */
-    private verifyAudioBuffer;
-    /**
-     * Handle playback errors for Web Audio API
-     * @private
-     */
-    private handlePlaybackError;
-    /**
-     * Prepare AudioContext for playback
-     * @private
-     */
-    private prepareAudioContext;
-    /**
-     * Play sound using HTML5 Sound pool (Howler.js style)
-     * Follows Howler.js pattern of Sound objects with state tracking
-     *
-     * ## Non-blocking Playback
-     *
-     * On iOS, the HTML5 audio play() call can block the main thread. To prevent
-     * this from blocking overlay rendering during continuous scanning, we defer
-     * the play() call to the next animation frame using requestAnimationFrame.
-     * This keeps the current frame free for UI rendering.
-     *
-     * @private
-     */
-    private playHTML5;
-    /**
-     * Play the sound.
-     *
-     * This method is the public API - call it to play the sound.
-     * It's non-blocking (fire-and-forget) and supports overlapping playback.
-     *
-     * ## Behavior
-     *
-     * - Creates a new AudioBufferSourceNode for each call (allows overlapping)
-     * - Reuses cached AudioBuffer (efficient repeated playback)
-     * - Auto-unlocks audio on first play (if not already unlocked)
-     * - Uses iOS MediaStreamDestination workaround when needed
-     *
-     * ## Example
-     *
-     * ```typescript
-     * const beep = new Howl({ src: 'beep.mp3' });
-     * beep.play(); // First play
-     * beep.play(); // Overlapping play (both sounds play simultaneously)
-     * ```
-     */
-    play(): void;
-    /**
-     * Internal async play method
-     *
-     * ## Playback Flow
-     *
-     * 1. **Unlock check**: Ensure audio is unlocked (iOS requirement)
-     * 2. **Load**: Load and decode audio if not already cached
-     * 3. **Create source**: Create new AudioBufferSourceNode for this playback
-     * 4. **Setup audio graph**: Source → Gain → Destination
-     * 5. **Start playback**: Call source.start(0) to play immediately
-     * 6. **Cleanup**: Disconnect source after playback completes
-     *
-     * ## Platform-specific playback
-     *
-     * **Desktop:**
-     * - Uses Web Audio API with standard AudioContext destination
-     *
-     * **iOS:**
-     * - Uses HTML5 <audio> elements for reliable playback
-     * - Avoids Web Audio API pitch shifting issues on real devices
-     *
-     * ## Performance Notes
-     *
-     * - AudioBuffer loading/decoding happens once (cached)
-     * - Each play() creates only a lightweight source node
-     * - Gain node allows future volume control (currently 1.0)
-     * - Source disconnects automatically after playback to free memory
-     */
-    private playAsync;
+  /** Audio source URL (data URI, file path, or URL) */
+  private src;
+  /** Use HTML5 audio element (true) or Web Audio API (false) */
+  private html5;
+  /** Decoded audio buffer (cached after first load) - for Web Audio API only */
+  private audioBuffer;
+  /** Loading promise (prevents duplicate loads) */
+  private loadPromise;
+  /** Pool of HTML5 Sound objects (similar to Howler.js) */
+  private soundPool;
+  private soundPoolSize;
+  /** Track inactive (available) sounds for O(1) lookup instead of O(n) find */
+  private inactiveSounds;
+  constructor(options: HowlOptions);
+  /**
+   * Load and decode the audio file
+   *
+   * ## Caching Strategy
+   *
+   * This method implements three levels of caching:
+   *
+   * 1. **Instance cache**: Check if this Howl instance has already loaded the audio
+   * 2. **Instance promise cache**: Check if this Howl instance is currently loading
+   * 3. **Global cache**: Check if any Howl instance has loaded this URL
+   *
+   * Benefits:
+   * - Multiple Howl instances for the same sound share one AudioBuffer
+   * - Prevents duplicate network requests
+   * - Avoids redundant CPU-intensive audio decoding
+   * - Important for rapid scanning where same sound plays frequently
+   *
+   * ## Loading Process
+   *
+   * 1. Fetch audio file (supports data URIs, relative paths, full URLs)
+   * 2. Convert to ArrayBuffer
+   * 3. Decode using AudioContext.decodeAudioData() (async, CPU-intensive)
+   * 4. Cache the decoded AudioBuffer
+   *
+   * Note: decodeAudioData() runs in a separate thread and doesn't block the main thread
+   *
+   * @returns Promise<AudioBuffer> - Decoded audio ready for playback
+   */
+  private load;
+  /**
+   * Get or create a sound from the pool
+   * Follows Howler.js pattern: pool of Sound objects with state tracking
+   * Uses Set for O(1) lookup of inactive sounds instead of O(n) array find
+   * @private
+   */
+  private getSoundFromPool;
+  /**
+   * Verify audio buffer contains actual data (debugging helper, no-op in production)
+   * @private
+   */
+  private verifyAudioBuffer;
+  /**
+   * Handle playback errors for Web Audio API
+   * @private
+   */
+  private handlePlaybackError;
+  /**
+   * Prepare AudioContext for playback
+   * @private
+   */
+  private prepareAudioContext;
+  /**
+   * Play sound using HTML5 Sound pool (Howler.js style)
+   * Follows Howler.js pattern of Sound objects with state tracking
+   *
+   * ## Non-blocking Playback
+   *
+   * On iOS, the HTML5 audio play() call can block the main thread. To prevent
+   * this from blocking overlay rendering during continuous scanning, we defer
+   * the play() call to the next animation frame using requestAnimationFrame.
+   * This keeps the current frame free for UI rendering.
+   *
+   * @private
+   */
+  private playHTML5;
+  /**
+   * Play the sound.
+   *
+   * This method is the public API - call it to play the sound.
+   * It's non-blocking (fire-and-forget) and supports overlapping playback.
+   *
+   * ## Behavior
+   *
+   * - Creates a new AudioBufferSourceNode for each call (allows overlapping)
+   * - Reuses cached AudioBuffer (efficient repeated playback)
+   * - Auto-unlocks audio on first play (if not already unlocked)
+   * - Uses iOS MediaStreamDestination workaround when needed
+   *
+   * ## Example
+   *
+   * ```typescript
+   * const beep = new Howl({ src: 'beep.mp3' });
+   * beep.play(); // First play
+   * beep.play(); // Overlapping play (both sounds play simultaneously)
+   * ```
+   */
+  play(): void;
+  /**
+   * Internal async play method
+   *
+   * ## Playback Flow
+   *
+   * 1. **Unlock check**: Ensure audio is unlocked (iOS requirement)
+   * 2. **Load**: Load and decode audio if not already cached
+   * 3. **Create source**: Create new AudioBufferSourceNode for this playback
+   * 4. **Setup audio graph**: Source → Gain → Destination
+   * 5. **Start playback**: Call source.start(0) to play immediately
+   * 6. **Cleanup**: Disconnect source after playback completes
+   *
+   * ## Platform-specific playback
+   *
+   * **Desktop:**
+   * - Uses Web Audio API with standard AudioContext destination
+   *
+   * **iOS:**
+   * - Uses HTML5 <audio> elements for reliable playback
+   * - Avoids Web Audio API pitch shifting issues on real devices
+   *
+   * ## Performance Notes
+   *
+   * - AudioBuffer loading/decoding happens once (cached)
+   * - Each play() creates only a lightweight source node
+   * - Gain node allows future volume control (currently 1.0)
+   * - Source disconnects automatically after playback to free memory
+   */
+  private playAsync;
 }
-
-export { Howl, type HowlOptions };
+//#endregion
+export { Howl, HowlOptions };

package/build/js/private/customHowler/Howl.js

@@ -1 +1 @@
-export{a as Howl}from'../../chunks/chunk-CERFU73N.js';
+import{t as e}from"../../browserHelper-BQPnAZ2Y.js";import"./debug.js";import{Html5Sound as t}from"./Html5Sound.js";import{getAudioCacheInstance as n}from"./WebAudioContextManager.js";import{registerHowlInstance as r,unregisterHowlInstance as i}from"./HowlRegistry.js";import{ensureUnlockSetup as a,getGlobalAudioContext as o}from"./setup.js";var s=class{constructor(t){this.audioBuffer=null,this.loadPromise=null,this.soundPool=[],this.soundPoolSize=25,this.inactiveSounds=new Set,this.src=Array.isArray(t.src)?t.src[0]:t.src,t.html5===void 0?this.html5=e.isIOS():this.html5=t.html5,r(this),a()}async load(){if(this.loadPromise)return this.loadPromise;if(this.audioBuffer)return this.audioBuffer;let e=n().get(this.src);return e?(this.loadPromise=e,this.audioBuffer=await e,this.audioBuffer):(this.loadPromise=(async()=>{try{let e=o().getContext(),t;if(this.src.startsWith(`data:`)){let e=this.src.split(`,`)[1],n=atob(e),r=new Uint8Array(n.length);for(let e=0;e<n.length;e++)r[e]=n.charCodeAt(e);t=r.buffer}else t=await(await fetch(this.src)).arrayBuffer();let n=await e.decodeAudioData(t);return this.audioBuffer=n,n}catch(e){throw e}})(),n().set(this.src,this.loadPromise),this.loadPromise)}getSoundFromPool(){if(this.inactiveSounds.size>0){let e=[...this.inactiveSounds][0];return this.inactiveSounds.delete(e),e}if(this.soundPool.length<this.soundPoolSize){let e=new t(this.src,e=>{this.inactiveSounds.add(e)});return this.soundPool.push(e),e}let e=this.soundPool[0];return this.inactiveSounds.delete(e),e}verifyAudioBuffer(e){}handlePlaybackError(e){e instanceof DOMException&&(e.name===`NotAllowedError`||e.name)}async prepareAudioContext(e){e.unlocked||await e.unlock(),e.checkAndRecreateContextIfSampleRateChanged();let t=e.getContext();return t.state===`suspended`&&await t.resume(),t}playHTML5(){try{this.getSoundFromPool().play()}catch{}}play(){this.playAsync()}async playAsync(){try{if(this.html5)return this.playHTML5();let e=o(),t=await this.prepareAudioContext(e),n=await this.load();this.verifyAudioBuffer(n);let r=t.createBufferSource();r.buffer=n,r.loop=!1;let i=t.createGain();i.gain.value=1,r.connect(i);let a=e.getDestination();i.connect(a),r.onended=()=>{r.disconnect()},r.start(0)}catch(e){this.handlePlaybackError(e)}}dispose(){for(let e of this.soundPool)e.stop(),e.dispose();this.soundPool=[],this.inactiveSounds.clear(),i(this)}};export{s as Howl};

package/build/js/private/customHowler/HowlRegistry.d.ts

@@ -1,4 +1,4 @@
-/// <reference types="emscripten" />
+//#region src/main/private/customHowler/HowlRegistry.d.ts
 /**
  * Register a Howl instance in the global registry
  * @private
@@ -14,5 +14,5 @@ declare function unregisterHowlInstance(howl: any): void;
  * @private
  */
 declare function getActiveHowlInstances(): any[];
-
-export { getActiveHowlInstances, registerHowlInstance, unregisterHowlInstance };
+//#endregion
+export { getActiveHowlInstances, registerHowlInstance, unregisterHowlInstance };

package/build/js/private/customHowler/HowlRegistry.js

@@ -1 +1 @@
-export{c as getActiveHowlInstances,a as registerHowlInstance,b as unregisterHowlInstance}from'../../chunks/chunk-ZAXZRQYF.js';
+const e=new Set;function t(t){e.add(t)}function n(t){e.delete(t)}function r(){return Array.from(e)}export{r as getActiveHowlInstances,t as registerHowlInstance,n as unregisterHowlInstance};

package/build/js/private/customHowler/Html5Sound.d.ts

@@ -1,52 +1,52 @@
-/// <reference types="emscripten" />
+//#region src/main/private/customHowler/Html5Sound.d.ts
 /**
  * Wrapper for HTML5 audio element with state tracking (similar to Howler.js Sound)
  * Tracks paused, ended, and seek position independently from element state
  * @private
  */
 declare class Html5Sound {
-    node: HTMLAudioElement;
-    _paused: boolean;
-    _ended: boolean;
-    _seek: number;
-    private onEndedHandler;
-    private onPauseHandler;
-    private onPlayHandler;
-    private onInactive?;
-    constructor(src: string, onInactive?: (sound: Html5Sound) => void);
-    /**
-     * Handle natural playback completion
-     * @private
-     */
-    private onEnded;
-    /**
-     * Track pause events
-     * @private
-     */
-    private onPause;
-    /**
-     * Track play events
-     * @private
-     */
-    private onPlay;
-    /**
-     * Start playback from the beginning, deferred to the next animation frame.
-     * Deferring avoids blocking the main thread (critical for smooth overlay
-     * rendering during continuous scanning on iOS).
-     */
-    play(): void;
-    /**
-     * Pause playback and preserve current position
-     */
-    pause(): void;
-    /**
-     * Stop playback and reset to beginning
-     */
-    stop(): void;
-    /**
-     * Clean up event listeners (for disposal)
-     */
-    dispose(): void;
+  node: HTMLAudioElement;
+  _paused: boolean;
+  _ended: boolean;
+  _seek: number;
+  private onEndedHandler;
+  private onPauseHandler;
+  private onPlayHandler;
+  private onInactive?;
+  constructor(src: string, onInactive?: (sound: Html5Sound) => void);
+  /**
+   * Handle natural playback completion
+   * @private
+   */
+  private onEnded;
+  /**
+   * Track pause events
+   * @private
+   */
+  private onPause;
+  /**
+   * Track play events
+   * @private
+   */
+  private onPlay;
+  /**
+   * Start playback from the beginning, deferred to the next animation frame.
+   * Deferring avoids blocking the main thread (critical for smooth overlay
+   * rendering during continuous scanning on iOS).
+   */
+  play(): void;
+  /**
+   * Pause playback and preserve current position
+   */
+  pause(): void;
+  /**
+   * Stop playback and reset to beginning
+   */
+  stop(): void;
+  /**
+   * Clean up event listeners (for disposal)
+   */
+  dispose(): void;
 }
-
-export { Html5Sound };
+//#endregion
+export { Html5Sound };

package/build/js/private/customHowler/Html5Sound.js

@@ -1 +1 @@
-export{a as Html5Sound}from'../../chunks/chunk-AAPD5YU3.js';
+import{safeRequestAnimationFrame as e}from"../utils/safeRequestAnimationFrame.js";import"./debug.js";var t=class{constructor(e,t){this._paused=!0,this._ended=!1,this._seek=0,this.onEndedHandler=this.onEnded.bind(this),this.onPauseHandler=this.onPause.bind(this),this.onPlayHandler=this.onPlay.bind(this),this.node=new Audio,this.node.src=e,this.onInactive=t,this.node.addEventListener(`ended`,this.onEndedHandler),this.node.addEventListener(`pause`,this.onPauseHandler),this.node.addEventListener(`play`,this.onPlayHandler)}onEnded(){var e;this._paused=!0,this._ended=!0,(e=this.onInactive)==null||e.call(this,this)}onPause(){var e;this._paused=!0,(e=this.onInactive)==null||e.call(this,this)}onPlay(){this._paused=!1,this._ended=!1}play(){this._seek=0,this._paused=!1,this._ended=!1,this.node.currentTime=0,this.node.volume=1,e(()=>{let e=this.node.play();e&&e.catch(e=>{e instanceof DOMException&&e.name})})}pause(){this._paused||(this._paused=!0,this._seek=this.node.currentTime,this.node.pause())}stop(){this._paused=!0,this._ended=!0,this._seek=0,this.node.currentTime=0,this.node.pause()}dispose(){this.node.removeEventListener(`ended`,this.onEndedHandler),this.node.removeEventListener(`pause`,this.onPauseHandler),this.node.removeEventListener(`play`,this.onPlayHandler)}};export{t as Html5Sound};

package/build/js/private/customHowler/UnlockManager.d.ts

@@ -1,39 +1,39 @@
-/// <reference types="emscripten" />
+//#region src/main/private/customHowler/UnlockManager.d.ts
 /**
  * Manages audio unlock state and event listeners
  * Handles setup of user interaction listeners for iOS audio unlock
  * @private
  */
 declare class UnlockManager {
-    private setupComplete;
-    private handler;
-    private readonly events;
-    private readonly doc;
-    /**
-     * Constructor - accepts optional document for dependency injection
-     * @param doc - Document object (defaults to global document for browser, undefined for tests)
-     */
-    constructor(doc?: Document);
-    /**
-     * Check if unlock setup is complete
-     */
-    isSetupComplete(): boolean;
-    /**
-     * Mark setup as complete
-     */
-    markSetupComplete(): void;
-    /**
-     * Setup unlock handlers and add event listeners
-     */
-    setup(handler: EventListener): void;
-    /**
-     * Reset unlock state (called during disposal/reset)
-     */
-    reset(): void;
-    /**
-     * Remove all event listeners
-     */
-    private removeListeners;
+  private setupComplete;
+  private handler;
+  private readonly events;
+  private readonly doc;
+  /**
+   * Constructor - accepts optional document for dependency injection
+   * @param doc - Document object (defaults to global document for browser, undefined for tests)
+   */
+  constructor(doc?: Document);
+  /**
+   * Check if unlock setup is complete
+   */
+  isSetupComplete(): boolean;
+  /**
+   * Mark setup as complete
+   */
+  markSetupComplete(): void;
+  /**
+   * Setup unlock handlers and add event listeners
+   */
+  setup(handler: EventListener): void;
+  /**
+   * Reset unlock state (called during disposal/reset)
+   */
+  reset(): void;
+  /**
+   * Remove all event listeners
+   */
+  private removeListeners;
 }
-
-export { UnlockManager };
+//#endregion
+export { UnlockManager };

package/build/js/private/customHowler/UnlockManager.js

@@ -1 +1 @@
-export{a as UnlockManager}from'../../chunks/chunk-LV6LGCDC.js';
+import"./debug.js";var e=class{constructor(e){this.setupComplete=!1,this.handler=null,this.events=[`touchstart`,`touchend`,`click`,`keydown`],this.doc=e??(typeof document<`u`?document:void 0)}isSetupComplete(){return this.setupComplete}markSetupComplete(){this.setupComplete=!0}setup(e){this.handler=e;let t=this.doc;t&&this.events.forEach(n=>{t.addEventListener(n,e,!0)})}reset(){this.removeListeners(),this.handler=null,this.setupComplete=!1}removeListeners(){this.handler&&this.doc&&this.events.forEach(e=>{var t;(t=this.doc)==null||t.removeEventListener(e,this.handler,!0)})}};export{e as UnlockManager};