@gjsify/webaudio 0.3.12 → 0.3.14

package/lib/esm/gain-node.js

@@ -1,19 +1,21 @@
 import { AudioNode } from "./audio-node.js";
 import { AudioParam } from "./audio-param.js";
-class GainNode extends AudioNode {
-  gain;
-  /** @internal active players that need volume updates */
-  _activePlayers = /* @__PURE__ */ new Set();
-  constructor() {
-    super(1, 1);
-    this.gain = new AudioParam(1, 0, 10);
-    this.gain._onChange = (value) => {
-      for (const player of this._activePlayers) {
-        player.setVolume(value);
-      }
-    };
-  }
-}
-export {
-  GainNode
+
+//#region src/gain-node.ts
+var GainNode = class extends AudioNode {
+	gain;
+	/** @internal active players that need volume updates */
+	_activePlayers = new Set();
+	constructor() {
+		super(1, 1);
+		this.gain = new AudioParam(1, 0, 10);
+		this.gain._onChange = (value) => {
+			for (const player of this._activePlayers) {
+				player.setVolume(value);
+			}
+		};
+	}
 };
+
+//#endregion
+export { GainNode };

package/lib/esm/gst-decoder.js

@@ -1,67 +1,76 @@
-import { ensureGstInit, Gst } from "./gst-init.js";
+import { Gst, ensureGstInit } from "./gst-init.js";
 import { AudioBuffer } from "./audio-buffer.js";
 import GstApp from "gi://GstApp?version=1.0";
+
+//#region src/gst-decoder.ts
 void GstApp;
-const PIPELINE_DESC = "appsrc name=src ! decodebin ! audioconvert ! audioresample ! capsfilter caps=audio/x-raw,format=F32LE,layout=interleaved ! appsink name=sink sync=false";
+const PIPELINE_DESC = "appsrc name=src ! decodebin ! audioconvert ! audioresample ! " + "capsfilter caps=audio/x-raw,format=F32LE,layout=interleaved ! " + "appsink name=sink sync=false";
+/**
+* Decode encoded audio data (MP3, WAV, OGG, FLAC, etc.) into an AudioBuffer
+* containing PCM Float32 channel data.
+*
+* This is a synchronous operation that blocks until decoding completes.
+* It must be called from the main thread (GJS requirement).
+*/
 function decodeAudioDataSync(arrayBuffer) {
-  ensureGstInit();
-  if (!(arrayBuffer instanceof ArrayBuffer) || arrayBuffer.byteLength === 0) {
-    throw new DOMException("Unable to decode audio data", "EncodingError");
-  }
-  const pipeline = Gst.parse_launch(PIPELINE_DESC);
-  const appsrc = pipeline.get_by_name("src");
-  const appsink = pipeline.get_by_name("sink");
-  pipeline.set_state(Gst.State.PLAYING);
-  const data = new Uint8Array(arrayBuffer);
-  appsrc.push_buffer(Gst.Buffer.new_wrapped(data));
-  appsrc.end_of_stream();
-  const chunks = [];
-  let sampleRate = 0;
-  let channels = 0;
-  while (true) {
-    const sample = appsink.try_pull_sample(2 * Number(Gst.SECOND));
-    if (!sample) break;
-    if (sampleRate === 0) {
-      const caps = sample.get_caps();
-      if (caps) {
-        const struct = caps.get_structure(0);
-        [, sampleRate] = struct.get_int("rate");
-        [, channels] = struct.get_int("channels");
-      }
-    }
-    const buffer = sample.get_buffer();
-    if (!buffer) continue;
-    const [ok, mapInfo] = buffer.map(Gst.MapFlags.READ);
-    if (ok) {
-      chunks.push(new Uint8Array(mapInfo.data));
-      buffer.unmap(mapInfo);
-    }
-  }
-  pipeline.set_state(Gst.State.NULL);
-  if (sampleRate === 0 || channels === 0) {
-    throw new DOMException("Unable to decode audio data", "EncodingError");
-  }
-  let totalBytes = 0;
-  for (const c of chunks) totalBytes += c.length;
-  const totalFrames = totalBytes / (4 * channels);
-  const audioBuffer = new AudioBuffer({
-    numberOfChannels: channels,
-    length: totalFrames,
-    sampleRate
-  });
-  let offset = 0;
-  for (const chunk of chunks) {
-    const f32 = new Float32Array(chunk.buffer, chunk.byteOffset, chunk.length / 4);
-    const framesInChunk = f32.length / channels;
-    for (let frame = 0; frame < framesInChunk; frame++) {
-      for (let ch = 0; ch < channels; ch++) {
-        audioBuffer._channelData[ch][offset + frame] = f32[frame * channels + ch];
-      }
-    }
-    offset += framesInChunk;
-  }
-  return audioBuffer;
+	ensureGstInit();
+	if (!(arrayBuffer instanceof ArrayBuffer) || arrayBuffer.byteLength === 0) {
+		throw new DOMException("Unable to decode audio data", "EncodingError");
+	}
+	const pipeline = Gst.parse_launch(PIPELINE_DESC);
+	const appsrc = pipeline.get_by_name("src");
+	const appsink = pipeline.get_by_name("sink");
+	pipeline.set_state(Gst.State.PLAYING);
+	const data = new Uint8Array(arrayBuffer);
+	appsrc.push_buffer(Gst.Buffer.new_wrapped(data));
+	appsrc.end_of_stream();
+	const chunks = [];
+	let sampleRate = 0;
+	let channels = 0;
+	while (true) {
+		const sample = appsink.try_pull_sample(2 * Number(Gst.SECOND));
+		if (!sample) break;
+		if (sampleRate === 0) {
+			const caps = sample.get_caps();
+			if (caps) {
+				const struct = caps.get_structure(0);
+				[, sampleRate] = struct.get_int("rate");
+				[, channels] = struct.get_int("channels");
+			}
+		}
+		const buffer = sample.get_buffer();
+		if (!buffer) continue;
+		const [ok, mapInfo] = buffer.map(Gst.MapFlags.READ);
+		if (ok) {
+			chunks.push(new Uint8Array(mapInfo.data));
+			buffer.unmap(mapInfo);
+		}
+	}
+	pipeline.set_state(Gst.State.NULL);
+	if (sampleRate === 0 || channels === 0) {
+		throw new DOMException("Unable to decode audio data", "EncodingError");
+	}
+	let totalBytes = 0;
+	for (const c of chunks) totalBytes += c.length;
+	const totalFrames = totalBytes / (4 * channels);
+	const audioBuffer = new AudioBuffer({
+		numberOfChannels: channels,
+		length: totalFrames,
+		sampleRate
+	});
+	let offset = 0;
+	for (const chunk of chunks) {
+		const f32 = new Float32Array(chunk.buffer, chunk.byteOffset, chunk.length / 4);
+		const framesInChunk = f32.length / channels;
+		for (let frame = 0; frame < framesInChunk; frame++) {
+			for (let ch = 0; ch < channels; ch++) {
+				audioBuffer._channelData[ch][offset + frame] = f32[frame * channels + ch];
+			}
+		}
+		offset += framesInChunk;
+	}
+	return audioBuffer;
 }
-export {
-  decodeAudioDataSync
-};
+
+//#endregion
+export { decodeAudioDataSync };

package/lib/esm/gst-init.js

@@ -1,12 +1,13 @@
 import Gst from "gi://Gst?version=1.0";
+
+//#region src/gst-init.ts
 let initialized = false;
 function ensureGstInit() {
-  if (!initialized) {
-    Gst.init(null);
-    initialized = true;
-  }
+	if (!initialized) {
+		Gst.init(null);
+		initialized = true;
+	}
 }
-export {
-  Gst,
-  ensureGstInit
-};
+
+//#endregion
+export { Gst, ensureGstInit };

package/lib/esm/gst-player.js

@@ -1,128 +1,125 @@
+import { Gst, ensureGstInit } from "./gst-init.js";
 import GLib from "gi://GLib?version=2.0";
-import { ensureGstInit, Gst } from "./gst-init.js";
 import GstApp from "gi://GstApp?version=1.0";
+
+//#region src/gst-player.ts
 void GstApp;
-class GstPlayer {
-  _pipeline = null;
-  _volumeElement = null;
-  _busWatchId = null;
-  _ended = false;
-  _loop;
-  _onEnded;
-  _audioBuffer;
-  constructor(options) {
-    ensureGstInit();
-    this._loop = options.loop;
-    this._onEnded = options.onEnded;
-    this._audioBuffer = options.audioBuffer;
-    const { audioBuffer, volume, offset, duration, playbackRate } = options;
-    const sr = audioBuffer.sampleRate;
-    const ch = audioBuffer.numberOfChannels;
-    const pcmData = this._interleave(audioBuffer, offset, duration);
-    if (pcmData.length === 0) {
-      this._fireEnded();
-      return;
-    }
-    const capsStr = `audio/x-raw,format=F32LE,rate=${sr},channels=${ch},layout=interleaved`;
-    const desc = `appsrc name=src caps="${capsStr}" format=3 ! audioconvert ! volume name=vol ! autoaudiosink`;
-    this._pipeline = Gst.parse_launch(desc);
-    this._volumeElement = this._pipeline.get_by_name("vol");
-    const appsrc = this._pipeline.get_by_name("src");
-    this._volumeElement.set_property("volume", Math.max(0, Math.min(volume, 10)));
-    const bus = this._pipeline.get_bus();
-    this._busWatchId = bus.add_watch(0, (_bus, msg) => {
-      if (msg.type === Gst.MessageType.EOS) {
-        if (this._loop && !this._ended) {
-          this._restartPlayback(appsrc, pcmData);
-        } else {
-          this._fireEnded();
-        }
-      } else if (msg.type === Gst.MessageType.ERROR) {
-        this._fireEnded();
-      }
-      return true;
-    });
-    const gstBuf = Gst.Buffer.new_wrapped(pcmData);
-    const totalFrames = pcmData.length / (4 * ch);
-    gstBuf.pts = 0;
-    gstBuf.duration = Math.floor(totalFrames / sr * Number(Gst.SECOND));
-    appsrc.push_buffer(gstBuf);
-    appsrc.end_of_stream();
-    if (playbackRate !== 1) {
-      this._pipeline.set_state(Gst.State.PAUSED);
-      this._pipeline.seek(
-        playbackRate,
-        Gst.Format.TIME,
-        Gst.SeekFlags.FLUSH | Gst.SeekFlags.ACCURATE,
-        Gst.SeekType.SET,
-        0,
-        Gst.SeekType.NONE,
-        -1
-      );
-    }
-    this._pipeline.set_state(Gst.State.PLAYING);
-  }
-  /** Update volume on a running pipeline */
-  setVolume(value) {
-    if (this._volumeElement && !this._ended) {
-      this._volumeElement.set_property("volume", Math.max(0, Math.min(value, 10)));
-    }
-  }
-  /** Update loop flag */
-  setLoop(value) {
-    this._loop = value;
-  }
-  /** Stop playback and clean up */
-  stop() {
-    if (this._ended) return;
-    this._fireEnded();
-  }
-  /** Whether playback has ended */
-  get ended() {
-    return this._ended;
-  }
-  _restartPlayback(appsrc, pcmData) {
-    if (this._pipeline) {
-      this._pipeline.seek_simple(Gst.Format.TIME, Gst.SeekFlags.FLUSH, 0);
-    }
-  }
-  _fireEnded() {
-    if (this._ended) return;
-    this._ended = true;
-    this._cleanup();
-    this._onEnded();
-  }
-  _cleanup() {
-    const pipeline = this._pipeline;
-    this._pipeline = null;
-    this._volumeElement = null;
-    this._busWatchId = null;
-    if (pipeline) {
-      GLib.idle_add(GLib.PRIORITY_LOW, () => {
-        pipeline.set_state(Gst.State.NULL);
-        return GLib.SOURCE_REMOVE;
-      });
-    }
-  }
-  /**
-   * Interleave AudioBuffer's per-channel Float32Arrays into a single Uint8Array.
-   * Applies offset (seconds) and optional duration (seconds).
-   */
-  _interleave(buf, offsetSec, durationSec) {
-    const ch = buf.numberOfChannels;
-    const startFrame = Math.min(Math.floor(offsetSec * buf.sampleRate), buf.length);
-    const maxFrames = buf.length - startFrame;
-    const frames = durationSec !== void 0 ? Math.min(Math.floor(durationSec * buf.sampleRate), maxFrames) : maxFrames;
-    if (frames <= 0) return new Uint8Array(0);
-    const interleaved = new Float32Array(frames * ch);
-    for (let frame = 0; frame < frames; frame++) {
-      for (let c = 0; c < ch; c++) {
-        interleaved[frame * ch + c] = buf._channelData[c][startFrame + frame];
-      }
-    }
-    return new Uint8Array(interleaved.buffer);
-  }
-}
-export {
-  GstPlayer
+/**
+* Manages a single GStreamer playback pipeline for one AudioBufferSourceNode.start() call.
+*/
+var GstPlayer = class {
+	_pipeline = null;
+	_volumeElement = null;
+	_busWatchId = null;
+	_ended = false;
+	_loop;
+	_onEnded;
+	_audioBuffer;
+	constructor(options) {
+		ensureGstInit();
+		this._loop = options.loop;
+		this._onEnded = options.onEnded;
+		this._audioBuffer = options.audioBuffer;
+		const { audioBuffer, volume, offset, duration, playbackRate } = options;
+		const sr = audioBuffer.sampleRate;
+		const ch = audioBuffer.numberOfChannels;
+		const pcmData = this._interleave(audioBuffer, offset, duration);
+		if (pcmData.length === 0) {
+			this._fireEnded();
+			return;
+		}
+		const capsStr = `audio/x-raw,format=F32LE,rate=${sr},channels=${ch},layout=interleaved`;
+		const desc = `appsrc name=src caps="${capsStr}" format=3 ! audioconvert ! volume name=vol ! autoaudiosink`;
+		this._pipeline = Gst.parse_launch(desc);
+		this._volumeElement = this._pipeline.get_by_name("vol");
+		const appsrc = this._pipeline.get_by_name("src");
+		this._volumeElement.set_property("volume", Math.max(0, Math.min(volume, 10)));
+		const bus = this._pipeline.get_bus();
+		this._busWatchId = bus.add_watch(0, (_bus, msg) => {
+			if (msg.type === Gst.MessageType.EOS) {
+				if (this._loop && !this._ended) {
+					this._restartPlayback(appsrc, pcmData);
+				} else {
+					this._fireEnded();
+				}
+			} else if (msg.type === Gst.MessageType.ERROR) {
+				this._fireEnded();
+			}
+			return true;
+		});
+		const gstBuf = Gst.Buffer.new_wrapped(pcmData);
+		const totalFrames = pcmData.length / (4 * ch);
+		gstBuf.pts = 0;
+		gstBuf.duration = Math.floor(totalFrames / sr * Number(Gst.SECOND));
+		appsrc.push_buffer(gstBuf);
+		appsrc.end_of_stream();
+		if (playbackRate !== 1) {
+			this._pipeline.set_state(Gst.State.PAUSED);
+			this._pipeline.seek(playbackRate, Gst.Format.TIME, Gst.SeekFlags.FLUSH | Gst.SeekFlags.ACCURATE, Gst.SeekType.SET, 0, Gst.SeekType.NONE, -1);
+		}
+		this._pipeline.set_state(Gst.State.PLAYING);
+	}
+	/** Update volume on a running pipeline */
+	setVolume(value) {
+		if (this._volumeElement && !this._ended) {
+			this._volumeElement.set_property("volume", Math.max(0, Math.min(value, 10)));
+		}
+	}
+	/** Update loop flag */
+	setLoop(value) {
+		this._loop = value;
+	}
+	/** Stop playback and clean up */
+	stop() {
+		if (this._ended) return;
+		this._fireEnded();
+	}
+	/** Whether playback has ended */
+	get ended() {
+		return this._ended;
+	}
+	_restartPlayback(appsrc, pcmData) {
+		if (this._pipeline) {
+			this._pipeline.seek_simple(Gst.Format.TIME, Gst.SeekFlags.FLUSH, 0);
+		}
+	}
+	_fireEnded() {
+		if (this._ended) return;
+		this._ended = true;
+		this._cleanup();
+		this._onEnded();
+	}
+	_cleanup() {
+		const pipeline = this._pipeline;
+		this._pipeline = null;
+		this._volumeElement = null;
+		this._busWatchId = null;
+		if (pipeline) {
+			GLib.idle_add(GLib.PRIORITY_LOW, () => {
+				pipeline.set_state(Gst.State.NULL);
+				return GLib.SOURCE_REMOVE;
+			});
+		}
+	}
+	/**
+	* Interleave AudioBuffer's per-channel Float32Arrays into a single Uint8Array.
+	* Applies offset (seconds) and optional duration (seconds).
+	*/
+	_interleave(buf, offsetSec, durationSec) {
+		const ch = buf.numberOfChannels;
+		const startFrame = Math.min(Math.floor(offsetSec * buf.sampleRate), buf.length);
+		const maxFrames = buf.length - startFrame;
+		const frames = durationSec !== undefined ? Math.min(Math.floor(durationSec * buf.sampleRate), maxFrames) : maxFrames;
+		if (frames <= 0) return new Uint8Array(0);
+		const interleaved = new Float32Array(frames * ch);
+		for (let frame = 0; frame < frames; frame++) {
+			for (let c = 0; c < ch; c++) {
+				interleaved[frame * ch + c] = buf._channelData[c][startFrame + frame];
+			}
+		}
+		return new Uint8Array(interleaved.buffer);
+	}
 };
+
+//#endregion
+export { GstPlayer };

package/lib/esm/html-audio-element.js

@@ -1,61 +1,61 @@
-import { ensureGstInit, Gst } from "./gst-init.js";
-const SUPPORTED_TYPES = /* @__PURE__ */ new Set([
-  "audio/mpeg",
-  "audio/mp3",
-  "audio/wav",
-  "audio/x-wav",
-  "audio/ogg",
-  "audio/webm",
-  "audio/flac",
-  "audio/x-flac",
-  "audio/aac",
-  "audio/mp4"
+import { Gst, ensureGstInit } from "./gst-init.js";
+
+//#region src/html-audio-element.ts
+const SUPPORTED_TYPES = new Set([
+	"audio/mpeg",
+	"audio/mp3",
+	"audio/wav",
+	"audio/x-wav",
+	"audio/ogg",
+	"audio/webm",
+	"audio/flac",
+	"audio/x-flac",
+	"audio/aac",
+	"audio/mp4"
 ]);
-class HTMLAudioElement {
-  src = "";
-  volume = 1;
-  loop = false;
-  paused = true;
-  currentTime = 0;
-  duration = 0;
-  readyState = 0;
-  _pipeline = null;
-  canPlayType(type) {
-    const mime = type.split(";")[0].trim().toLowerCase();
-    return SUPPORTED_TYPES.has(mime) ? "maybe" : "";
-  }
-  play() {
-    if (!this.src) return Promise.resolve();
-    ensureGstInit();
-    this._cleanup();
-    this._pipeline = Gst.ElementFactory.make("playbin", "player");
-    if (!this._pipeline) return Promise.resolve();
-    this._pipeline.set_property("uri", this.src);
-    this._pipeline.set_property("volume", this.volume);
-    this._pipeline.set_state(Gst.State.PLAYING);
-    this.paused = false;
-    return Promise.resolve();
-  }
-  pause() {
-    if (this._pipeline) {
-      this._pipeline.set_state(Gst.State.PAUSED);
-      this.paused = true;
-    }
-  }
-  load() {
-    this._cleanup();
-  }
-  addEventListener(_type, _listener) {
-  }
-  removeEventListener(_type, _listener) {
-  }
-  _cleanup() {
-    if (this._pipeline) {
-      this._pipeline.set_state(Gst.State.NULL);
-      this._pipeline = null;
-    }
-  }
-}
-export {
-  HTMLAudioElement
+var HTMLAudioElement = class {
+	src = "";
+	volume = 1;
+	loop = false;
+	paused = true;
+	currentTime = 0;
+	duration = 0;
+	readyState = 0;
+	_pipeline = null;
+	canPlayType(type) {
+		const mime = type.split(";")[0].trim().toLowerCase();
+		return SUPPORTED_TYPES.has(mime) ? "maybe" : "";
+	}
+	play() {
+		if (!this.src) return Promise.resolve();
+		ensureGstInit();
+		this._cleanup();
+		this._pipeline = Gst.ElementFactory.make("playbin", "player");
+		if (!this._pipeline) return Promise.resolve();
+		this._pipeline.set_property("uri", this.src);
+		this._pipeline.set_property("volume", this.volume);
+		this._pipeline.set_state(Gst.State.PLAYING);
+		this.paused = false;
+		return Promise.resolve();
+	}
+	pause() {
+		if (this._pipeline) {
+			this._pipeline.set_state(Gst.State.PAUSED);
+			this.paused = true;
+		}
+	}
+	load() {
+		this._cleanup();
+	}
+	addEventListener(_type, _listener) {}
+	removeEventListener(_type, _listener) {}
+	_cleanup() {
+		if (this._pipeline) {
+			this._pipeline.set_state(Gst.State.NULL);
+			this._pipeline = null;
+		}
+	}
 };
+
+//#endregion
+export { HTMLAudioElement };

package/lib/esm/index.js

@@ -1,18 +1,10 @@
-import { AudioContext } from "./audio-context.js";
-import { AudioBuffer } from "./audio-buffer.js";
 import { AudioNode } from "./audio-node.js";
-import { AudioDestinationNode } from "./audio-destination-node.js";
-import { AudioBufferSourceNode } from "./audio-buffer-source-node.js";
-import { GainNode } from "./gain-node.js";
 import { AudioParam } from "./audio-param.js";
+import { GainNode } from "./gain-node.js";
+import { AudioBufferSourceNode } from "./audio-buffer-source-node.js";
+import { AudioBuffer } from "./audio-buffer.js";
+import { AudioDestinationNode } from "./audio-destination-node.js";
+import { AudioContext } from "./audio-context.js";
 import { HTMLAudioElement } from "./html-audio-element.js";
-export {
-  AudioBuffer,
-  AudioBufferSourceNode,
-  AudioContext,
-  AudioDestinationNode,
-  AudioNode,
-  AudioParam,
-  GainNode,
-  HTMLAudioElement
-};
+
+export { AudioBuffer, AudioBufferSourceNode, AudioContext, AudioDestinationNode, AudioNode, AudioParam, GainNode, HTMLAudioElement };

package/lib/esm/register.js

@@ -1,13 +1,19 @@
-import { AudioContext, HTMLAudioElement } from "./index.js";
+import { AudioContext } from "./audio-context.js";
+import { HTMLAudioElement } from "./html-audio-element.js";
+import "./index.js";
+
+//#region src/register.ts
 if (typeof globalThis.AudioContext === "undefined") {
-  globalThis.AudioContext = AudioContext;
+	globalThis.AudioContext = AudioContext;
 }
 if (typeof globalThis.webkitAudioContext === "undefined") {
-  globalThis.webkitAudioContext = AudioContext;
+	globalThis.webkitAudioContext = AudioContext;
 }
 if (typeof globalThis.Audio === "undefined") {
-  globalThis.Audio = HTMLAudioElement;
+	globalThis.Audio = HTMLAudioElement;
 }
 if (typeof globalThis.HTMLAudioElement === "undefined") {
-  globalThis.HTMLAudioElement = HTMLAudioElement;
+	globalThis.HTMLAudioElement = HTMLAudioElement;
 }
+
+//#endregion