@aelionsdk/audio 1.0.0-rc.1 → 1.2.0-rc.1

package/README.md

@@ -1,7 +1,28 @@
-# @aelionsdk/audio
+# `@aelionsdk/audio`
 
-AudioWorklet clock, PCM buffering and audio mixing for AelionSDK
+Audio scheduling and deterministic PCM processing primitives for AelionSDK.
 
-Install with `npm install @aelionsdk/audio@next`.
+## Install
 
-Version 1.0.0-rc.1 is a prerelease and its API may change before the first stable release. This package is part of [AelionSDK](https://github.com/FoyonaCZY/AelionSDK); see the repository README for supported browsers, examples and deployment requirements.
+```bash
+npm install @aelionsdk/audio@next
+```
+
+`next` currently resolves to `1.2.0-rc.1`. Product applications should prefer
+`@aelionsdk/sdk`; use this package directly when building a custom audio host,
+analysis pipeline or renderer integration.
+
+## Public surface
+
+- IR audio mixing and channel matrices;
+- streaming resampling and pitch-preserving time stretch;
+- SharedArrayBuffer and transferable PCM queues;
+- AudioWorklet clocks, device state and video scheduling.
+
+Queue and clock instances own browser and buffer resources. Stop producers,
+cancel pending work and dispose the owning session or primitive when playback
+ends.
+
+See the [package map](https://foyonaczy.github.io/AelionSDK/reference/packages/)
+and [API reference](https://foyonaczy.github.io/AelionSDK/api/aelionsdk/audio/overview/).
+Licensed under MIT.

package/dist/analysis.d.ts

@@ -0,0 +1,58 @@
+/** A bounded PCM source for offline analysis, mirroring the waveform readFrames contract. */
+export interface AnalysisSource {
+    readonly sampleRate: number;
+    readonly channelCount: number;
+    readonly totalFrames: number;
+    readonly readFrames: (startFrame: number, frameCount: number, signal?: AbortSignal) => Promise<Float32Array>;
+    readonly signal?: AbortSignal;
+    readonly onProgress?: (progress: number) => void;
+}
+/** A single detected beat. */
+export interface BeatMarker {
+    /** Beat start frame. */
+    readonly frame: number;
+    /** Frame-based duration (estimated from the analysis window). */
+    readonly frameCount: number;
+    /** Normalized beat strength, 0..1. */
+    readonly strength: number;
+}
+/** Result of beat detection over a PCM source. */
+export interface BeatDetectionResult {
+    readonly sampleRate: number;
+    readonly totalFrames: number;
+    readonly beats: readonly BeatMarker[];
+}
+/** A single detected scene boundary. */
+export interface SceneBoundary {
+    /** Frame where the scene change is detected. */
+    readonly frame: number;
+    /** Normalized change magnitude, 0..1. */
+    readonly magnitude: number;
+}
+/** Result of scene-boundary detection over a PCM source. */
+export interface SceneDetectionResult {
+    readonly sampleRate: number;
+    readonly totalFrames: number;
+    readonly scenes: readonly SceneBoundary[];
+}
+/**
+ * Detect beats from an interleaved PCM source using a bounded energy-envelope
+ * onset detector. The signal is processed in fixed windows, computing a local
+ * RMS envelope; an onset is flagged where the envelope rises above the local
+ * noise floor by `minimumOnsetDb`. Bounded memory: only the current window and
+ * a rolling floor are retained.
+ */
+export declare function detectBeats(options: AnalysisSource & {
+    readonly minimumOnsetDb?: number;
+}): Promise<BeatDetectionResult>;
+/**
+ * Detect scene boundaries as audio-energy discontinuities. A scene change in
+ * video is usually accompanied by an abrupt change in the audio envelope, so a
+ * large window-to-window energy jump is reported as a candidate boundary.
+ * This is a deterministic, media-agnostic approximation driven by the same
+ * readFrames source; it does not inspect video pixels.
+ */
+export declare function detectScenes(options: AnalysisSource & {
+    readonly minimumJumpDb?: number;
+}): Promise<SceneDetectionResult>;
+//# sourceMappingURL=analysis.d.ts.map

package/dist/analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../src/analysis.ts"],"names":[],"mappings":"AAEA,6FAA6F;AAC7F,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,CACnB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,KACjB,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD;AAED,8BAA8B;AAC9B,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,kDAAkD;AAClD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;CACvC;AAED,wCAAwC;AACxC,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,4DAA4D;AAC5D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;CAC3C;AAID;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,GAAG;IAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D,OAAO,CAAC,mBAAmB,CAAC,CAgC9B;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,GAAG;IAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D,OAAO,CAAC,oBAAoB,CAAC,CA6B/B"}

package/dist/analysis.js

@@ -0,0 +1,81 @@
+import { throwIfAborted } from '@aelionsdk/core';
+const MIN_CHANGE_DB = 6;
+/**
+ * Detect beats from an interleaved PCM source using a bounded energy-envelope
+ * onset detector. The signal is processed in fixed windows, computing a local
+ * RMS envelope; an onset is flagged where the envelope rises above the local
+ * noise floor by `minimumOnsetDb`. Bounded memory: only the current window and
+ * a rolling floor are retained.
+ */
+export async function detectBeats(options) {
+    const sampleRate = options.sampleRate;
+    const channelCount = options.channelCount;
+    const totalFrames = options.totalFrames;
+    const minimumOnsetDb = options.minimumOnsetDb ?? MIN_CHANGE_DB;
+    const windowFrames = Math.max(1, Math.round(sampleRate / 20));
+    const beats = [];
+    let previousDb = 0;
+    let floor = 0;
+    let lastBeatFrame = -windowFrames;
+    for (let startFrame = 0; startFrame < totalFrames; startFrame += windowFrames) {
+        throwIfAborted(options.signal, 'Beat detection');
+        const frameCount = Math.min(windowFrames, totalFrames - startFrame);
+        const pcm = await options.readFrames(startFrame, frameCount, options.signal);
+        if (pcm.length !== frameCount * channelCount) {
+            throw new RangeError('Beat source returned an unexpected PCM length');
+        }
+        let squares = 0;
+        for (const sample of pcm)
+            squares += sample * sample;
+        const envelope = Math.sqrt(squares / Math.max(1, frameCount * channelCount));
+        const db = 20 * Math.log10(Math.max(1e-9, envelope));
+        floor = floor === 0 ? db : Math.max(-120, floor * 0.95 + db * 0.05);
+        const onset = db - floor > minimumOnsetDb && db > previousDb;
+        if (onset && startFrame - lastBeatFrame >= windowFrames) {
+            const strength = Math.min(1, Math.max(0, (db - floor) / 24));
+            beats.push({ frame: startFrame, frameCount: windowFrames, strength });
+            lastBeatFrame = startFrame;
+        }
+        previousDb = db;
+        options.onProgress?.((startFrame + frameCount) / totalFrames);
+    }
+    return { sampleRate, totalFrames, beats };
+}
+/**
+ * Detect scene boundaries as audio-energy discontinuities. A scene change in
+ * video is usually accompanied by an abrupt change in the audio envelope, so a
+ * large window-to-window energy jump is reported as a candidate boundary.
+ * This is a deterministic, media-agnostic approximation driven by the same
+ * readFrames source; it does not inspect video pixels.
+ */
+export async function detectScenes(options) {
+    const sampleRate = options.sampleRate;
+    const channelCount = options.channelCount;
+    const totalFrames = options.totalFrames;
+    const minimumJumpDb = options.minimumJumpDb ?? MIN_CHANGE_DB;
+    const windowFrames = Math.max(1, Math.round(sampleRate / 10));
+    const scenes = [];
+    let previousDb = 0;
+    for (let startFrame = 0; startFrame < totalFrames; startFrame += windowFrames) {
+        throwIfAborted(options.signal, 'Scene detection');
+        const frameCount = Math.min(windowFrames, totalFrames - startFrame);
+        const pcm = await options.readFrames(startFrame, frameCount, options.signal);
+        if (pcm.length !== frameCount * channelCount) {
+            throw new RangeError('Scene source returned an unexpected PCM length');
+        }
+        let squares = 0;
+        for (const sample of pcm)
+            squares += sample * sample;
+        const envelope = Math.sqrt(squares / Math.max(1, frameCount * channelCount));
+        const db = 20 * Math.log10(Math.max(1e-9, envelope));
+        if (startFrame > 0) {
+            const jump = Math.abs(db - previousDb);
+            if (jump >= minimumJumpDb) {
+                scenes.push({ frame: startFrame, magnitude: Math.min(1, jump / 24) });
+            }
+        }
+        previousDb = db;
+        options.onProgress?.((startFrame + frameCount) / totalFrames);
+    }
+    return { sampleRate, totalFrames, scenes };
+}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './ir-mixer.js';
 export * from './processing.js';
+export * from './analysis.js';
 export * from './pcm-ring.js';
 export * from './worklet-clock.js';
 export * from './video-scheduler.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export * from './ir-mixer.js';
 export * from './processing.js';
+export * from './analysis.js';
 export * from './pcm-ring.js';
 export * from './worklet-clock.js';
 export * from './video-scheduler.js';

package/dist/pcm-utils.d.ts

@@ -0,0 +1,3 @@
+export declare function positiveInteger(value: number, name: string): void;
+export declare function concat(left: Float32Array, right: Float32Array): Float32Array;
+//# sourceMappingURL=pcm-utils.d.ts.map

package/dist/pcm-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pcm-utils.d.ts","sourceRoot":"","sources":["../src/pcm-utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAIjE;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,GAAG,YAAY,CAO5E"}

package/dist/pcm-utils.js

@@ -0,0 +1,15 @@
+export function positiveInteger(value, name) {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        throw new RangeError(`${name} must be a positive safe integer`);
+    }
+}
+export function concat(left, right) {
+    if (left.length === 0)
+        return right.slice();
+    if (right.length === 0)
+        return left;
+    const result = new Float32Array(left.length + right.length);
+    result.set(left);
+    result.set(right, left.length);
+    return result;
+}

package/dist/processing.d.ts

@@ -76,6 +76,7 @@ export interface BuildWaveformPeaksOptions {
     readonly onProgress?: (progress: number) => void;
 }
 export declare function buildWaveformPeaks(options: BuildWaveformPeaksOptions): Promise<WaveformPeakResult>;
+/** A contiguous range of audio frames. */
 export interface AudioFrameRange {
     readonly startFrame: number;
     readonly frameCount: number;

package/dist/processing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"processing.d.ts","sourceRoot":"","sources":["../src/processing.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"processing.d.ts","sourceRoot":"","sources":["../src/processing.ts"],"names":[],"mappings":"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"}

package/dist/resampler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resampler.d.ts","sourceRoot":"","sources":["../src/resampler.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAiBD;;;;;;;GAOG;AACH,qBAAa,qBAAqB;;gBAUb,OAAO,EAAE,4BAA4B;IAUxD,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,IAAW,YAAY,IAAI,MAAM,CAEhC;IAEM,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,KAAK,UAAQ,GAAG,YAAY;CAyDpE;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,4BAA4B,GACpC,YAAY,CAEd"}
+{"version":3,"file":"resampler.d.ts","sourceRoot":"","sources":["../src/resampler.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,qBAAa,qBAAqB;;gBAUb,OAAO,EAAE,4BAA4B;IAUxD,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,IAAW,YAAY,IAAI,MAAM,CAEhC;IAEM,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,KAAK,UAAQ,GAAG,YAAY;CAyDpE;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,4BAA4B,GACpC,YAAY,CAEd"}

package/dist/resampler.js

@@ -1,18 +1,4 @@
-function positiveInteger(value, name) {
-    if (!Number.isSafeInteger(value) || value <= 0) {
-        throw new RangeError(`${name} must be a positive safe integer`);
-    }
-}
-function concat(left, right) {
-    if (left.length === 0)
-        return right.slice();
-    if (right.length === 0)
-        return left;
-    const result = new Float32Array(left.length + right.length);
-    result.set(left);
-    result.set(right, left.length);
-    return result;
-}
+import { concat, positiveInteger } from './pcm-utils.js';
 /**
  * Deterministic, chunk-boundary-independent linear PCM resampler.
  *

package/dist/time-stretch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"time-stretch.d.ts","sourceRoot":"","sources":["../src/time-stretch.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,0CAA0C;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAiBD;;;;;;;GAOG;AACH,qBAAa,mCAAmC;;gBAiB3B,OAAO,EAAE,0CAA0C;IAkB/D,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,KAAK,UAAQ,GAAG,YAAY;CAmHpE;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,iCAAiC,GACzC,YAAY,CAwBd"}
+{"version":3,"file":"time-stretch.d.ts","sourceRoot":"","sources":["../src/time-stretch.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,gFAAgF;IAChF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,0CAA0C;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,qBAAa,mCAAmC;;gBAiB3B,OAAO,EAAE,0CAA0C;IAkB/D,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,KAAK,UAAQ,GAAG,YAAY;CAmHpE;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,iCAAiC,GACzC,YAAY,CAwBd"}

package/dist/time-stretch.js

@@ -1,18 +1,4 @@
-function positiveInteger(value, name) {
-    if (!Number.isSafeInteger(value) || value <= 0) {
-        throw new RangeError(`${name} must be a positive safe integer`);
-    }
-}
-function concat(left, right) {
-    if (left.length === 0)
-        return right.slice();
-    if (right.length === 0)
-        return left;
-    const result = new Float32Array(left.length + right.length);
-    result.set(left);
-    result.set(right, left.length);
-    return result;
-}
+import { concat, positiveInteger } from './pcm-utils.js';
 /**
  * Stateful deterministic synchronous overlap-add time stretch.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aelionsdk/audio",
-  "version": "1.0.0-rc.1",
+  "version": "1.2.0-rc.1",
   "description": "AudioWorklet clock, PCM buffering and audio mixing for AelionSDK",
   "license": "MIT",
   "repository": {
@@ -27,15 +27,15 @@
     "!dist/.tsbuildinfo"
   ],
   "engines": {
-    "node": ">=20.19"
+    "node": ">=24 <25"
   },
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
   "dependencies": {
-    "@aelionsdk/core": "1.0.0-rc.1",
-    "@aelionsdk/render-ir": "1.0.0-rc.1"
+    "@aelionsdk/core": "1.2.0-rc.1",
+    "@aelionsdk/render-ir": "1.2.0-rc.1"
   },
   "scripts": {
     "build": "tsc -b",