@driftengine/audio 4.7.0 → 4.7.2

package/dist/mix/console.d.ts

@@ -91,6 +91,9 @@ export declare class MixConsole {
     random(): number;
     /** Capture every level, mute and send, under a name. */
     snapshot(name: string): MixSnapshot;
-    /** Crossfade back to a captured snapshot over `seconds`. */
-    recall(name: string, seconds?: number): void;
+    /**
+     * Crossfade back to a captured snapshot over `seconds`. False, and nothing moves, when no
+     * snapshot was taken under that name.
+     */
+    recall(name: string, seconds?: number): boolean;
 }

package/dist/mix/console.js

@@ -113,12 +113,16 @@ export class MixConsole {
         this.snapshots.set(name, captured);
         return captured;
     }
-    /** Crossfade back to a captured snapshot over `seconds`. */
+    /**
+     * Crossfade back to a captured snapshot over `seconds`. False, and nothing moves, when no
+     * snapshot was taken under that name.
+     */
     recall(name, seconds = 0) {
         const captured = this.snapshots.get(name);
         if (captured === undefined)
-            return;
+            return false;
         recallSnapshot(this, captured, seconds);
+        return true;
     }
 }
 /** Whether `bus` is anywhere below `maybeAncestor` in the tree. */

package/dist/rhythm/kickDetector.d.ts

@@ -32,7 +32,7 @@ export declare class KickDetector {
      * **The one to drive a visual from, and `energy` is usually not.** `energy` is the raw sum of
      * the two lowest bands with a gain on it, which is honest about what it says and useless on
      * anything mastered loud: on a bass-heavy master it reaches its own ceiling and stays there,
-     * so a consumer reading it draws a constant. Measured on a phonk track through this detector:
+     * so a consumer reading it draws a constant. Measured on a bass-heavy track through this detector:
      * `energy` sat at 1.000 in every frame of a two-minute sample.
      *
      * This is the whitened signal the detector already computes for its own gating — the level

package/dist/rhythm/kickDetector.js

@@ -82,7 +82,7 @@ export class KickDetector {
      * **The one to drive a visual from, and `energy` is usually not.** `energy` is the raw sum of
      * the two lowest bands with a gain on it, which is honest about what it says and useless on
      * anything mastered loud: on a bass-heavy master it reaches its own ceiling and stays there,
-     * so a consumer reading it draws a constant. Measured on a phonk track through this detector:
+     * so a consumer reading it draws a constant. Measured on a bass-heavy track through this detector:
      * `energy` sat at 1.000 in every frame of a two-minute sample.
      *
      * This is the whitened signal the detector already computes for its own gating — the level

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@driftengine/audio",
-  "version": "4.7.0",
+  "version": "4.7.2",
   "description": "Layered stems, synthesis, rhythm analysis and positional placement",
   "license": "Apache-2.0",
   "type": "module",

package/src/mix/console.ts

@@ -164,11 +164,15 @@ export class MixConsole {
     return captured;
   }
 
-  /** Crossfade back to a captured snapshot over `seconds`. */
-  recall(name: string, seconds = 0): void {
+  /**
+   * Crossfade back to a captured snapshot over `seconds`. False, and nothing moves, when no
+   * snapshot was taken under that name.
+   */
+  recall(name: string, seconds = 0): boolean {
     const captured = this.snapshots.get(name);
-    if (captured === undefined) return;
+    if (captured === undefined) return false;
     recallSnapshot(this, captured, seconds);
+    return true;
   }
 }
 

package/src/rhythm/kickDetector.ts

@@ -98,7 +98,7 @@ export class KickDetector {
    * **The one to drive a visual from, and `energy` is usually not.** `energy` is the raw sum of
    * the two lowest bands with a gain on it, which is honest about what it says and useless on
    * anything mastered loud: on a bass-heavy master it reaches its own ceiling and stays there,
-   * so a consumer reading it draws a constant. Measured on a phonk track through this detector:
+   * so a consumer reading it draws a constant. Measured on a bass-heavy track through this detector:
    * `energy` sat at 1.000 in every frame of a two-minute sample.
    *
    * This is the whitened signal the detector already computes for its own gating — the level