@scenography/plugin-audio 0.2.0

package/dist/data-ChoGUA4U.mjs

@@ -0,0 +1,27 @@
+import { existsProp, fail, isNonEmptyString, isNumberInRange, isOneOf, propIs, validate, when } from "@scenography/scene";
+//#region src/data/validate.ts
+const AUDIO_TYPES = new Set([
+	"stream",
+	"loop",
+	"playlist"
+]);
+const isTrackList = (tracks) => Array.isArray(tracks) && tracks.length > 0 && tracks.every((t) => isNonEmptyString(t));
+const validateAudio = (audio) => validate([
+	existsProp("id", "Audio source is missing an id."),
+	propIs("volume", isNumberInRange(0, 1), "volume must be a number between 0 and 1."),
+	when((a) => a.type === "stream" || a.type === "loop", existsProp("src", "Audio source is missing a src.")),
+	when((a) => a.type === "playlist", existsProp("tracks", "tracks must be a non-empty array of URLs."), propIs("tracks", isTrackList, "tracks must be a non-empty array of URLs.")),
+	when((a) => !isOneOf(AUDIO_TYPES)(a.type), fail("type", "unknown audio type."))
+])(audio);
+//#endregion
+//#region src/data/plugin.ts
+/** The data half of the audio plugin: owns the `audio` scene key (a collection). */
+const audioData = {
+	kind: "audio",
+	cardinality: "many",
+	validate: (source) => validateAudio(source)
+};
+//#endregion
+export { validateAudio as n, audioData as t };
+
+//# sourceMappingURL=data-ChoGUA4U.mjs.map

package/dist/data-ChoGUA4U.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-ChoGUA4U.mjs","names":[],"sources":["../src/data/validate.ts","../src/data/plugin.ts"],"sourcesContent":["import {\n  existsProp,\n  fail,\n  isNonEmptyString,\n  isNumberInRange,\n  isOneOf,\n  propIs,\n  validate,\n  when,\n  type ValidationResult,\n} from \"@scenography/scene\";\n\nimport type { AudioSource } from \"./audio\";\n\nconst AUDIO_TYPES: ReadonlySet<string> = new Set([\"stream\", \"loop\", \"playlist\"]);\n\nconst isTrackList = (tracks: unknown): boolean =>\n  Array.isArray(tracks) && tracks.length > 0 && tracks.every((t) => isNonEmptyString(t));\n\nexport const validateAudio = (audio: AudioSource): ValidationResult =>\n  validate<AudioSource>([\n    existsProp(\"id\", \"Audio source is missing an id.\"),\n    propIs(\"volume\", isNumberInRange(0, 1), \"volume must be a number between 0 and 1.\"),\n    when(\n      (a: AudioSource) => a.type === \"stream\" || a.type === \"loop\",\n      existsProp(\"src\", \"Audio source is missing a src.\"),\n    ),\n    when(\n      (a: AudioSource) => a.type === \"playlist\",\n      existsProp(\"tracks\", \"tracks must be a non-empty array of URLs.\"),\n      propIs(\"tracks\", isTrackList, \"tracks must be a non-empty array of URLs.\"),\n    ),\n    when(\n      (a: AudioSource) => !isOneOf(AUDIO_TYPES)(a.type),\n      fail(\"type\", \"unknown audio type.\"),\n    ),\n  ])(audio);\n","import type { DataPlugin } from \"@scenography/scene\";\n\nimport { validateAudio } from \"./validate\";\nimport type { AudioSource } from \"./audio\";\n\n/** The data half of the audio plugin: owns the `audio` scene key (a collection). */\nexport const audioData: DataPlugin<AudioSource> = {\n  kind: \"audio\",\n  cardinality: \"many\",\n  validate: (source) => validateAudio(source),\n};\n"],"mappings":";;AAcA,MAAM,cAAmC,IAAI,IAAI;CAAC;CAAU;CAAQ;AAAU,CAAC;AAE/E,MAAM,eAAe,WACnB,MAAM,QAAQ,MAAM,KAAK,OAAO,SAAS,KAAK,OAAO,OAAO,MAAM,iBAAiB,CAAC,CAAC;AAEvF,MAAa,iBAAiB,UAC5B,SAAsB;CACpB,WAAW,MAAM,gCAAgC;CACjD,OAAO,UAAU,gBAAgB,GAAG,CAAC,GAAG,0CAA0C;CAClF,MACG,MAAmB,EAAE,SAAS,YAAY,EAAE,SAAS,QACtD,WAAW,OAAO,gCAAgC,CACpD;CACA,MACG,MAAmB,EAAE,SAAS,YAC/B,WAAW,UAAU,2CAA2C,GAChE,OAAO,UAAU,aAAa,2CAA2C,CAC3E;CACA,MACG,MAAmB,CAAC,QAAQ,WAAW,CAAC,CAAC,EAAE,IAAI,GAChD,KAAK,QAAQ,qBAAqB,CACpC;AACF,CAAC,CAAC,CAAC,KAAK;;;;AC9BV,MAAa,YAAqC;CAChD,MAAM;CACN,aAAa;CACb,WAAW,WAAW,cAAc,MAAM;AAC5C"}

package/dist/data-vyKDnIYf.cjs

@@ -0,0 +1,38 @@
+let _scenography_scene = require("@scenography/scene");
+//#region src/data/validate.ts
+const AUDIO_TYPES = new Set([
+	"stream",
+	"loop",
+	"playlist"
+]);
+const isTrackList = (tracks) => Array.isArray(tracks) && tracks.length > 0 && tracks.every((t) => (0, _scenography_scene.isNonEmptyString)(t));
+const validateAudio = (audio) => (0, _scenography_scene.validate)([
+	(0, _scenography_scene.existsProp)("id", "Audio source is missing an id."),
+	(0, _scenography_scene.propIs)("volume", (0, _scenography_scene.isNumberInRange)(0, 1), "volume must be a number between 0 and 1."),
+	(0, _scenography_scene.when)((a) => a.type === "stream" || a.type === "loop", (0, _scenography_scene.existsProp)("src", "Audio source is missing a src.")),
+	(0, _scenography_scene.when)((a) => a.type === "playlist", (0, _scenography_scene.existsProp)("tracks", "tracks must be a non-empty array of URLs."), (0, _scenography_scene.propIs)("tracks", isTrackList, "tracks must be a non-empty array of URLs.")),
+	(0, _scenography_scene.when)((a) => !(0, _scenography_scene.isOneOf)(AUDIO_TYPES)(a.type), (0, _scenography_scene.fail)("type", "unknown audio type."))
+])(audio);
+//#endregion
+//#region src/data/plugin.ts
+/** The data half of the audio plugin: owns the `audio` scene key (a collection). */
+const audioData = {
+	kind: "audio",
+	cardinality: "many",
+	validate: (source) => validateAudio(source)
+};
+//#endregion
+Object.defineProperty(exports, "audioData", {
+	enumerable: true,
+	get: function() {
+		return audioData;
+	}
+});
+Object.defineProperty(exports, "validateAudio", {
+	enumerable: true,
+	get: function() {
+		return validateAudio;
+	}
+});
+
+//# sourceMappingURL=data-vyKDnIYf.cjs.map

package/dist/data-vyKDnIYf.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-vyKDnIYf.cjs","names":[],"sources":["../src/data/validate.ts","../src/data/plugin.ts"],"sourcesContent":["import {\n  existsProp,\n  fail,\n  isNonEmptyString,\n  isNumberInRange,\n  isOneOf,\n  propIs,\n  validate,\n  when,\n  type ValidationResult,\n} from \"@scenography/scene\";\n\nimport type { AudioSource } from \"./audio\";\n\nconst AUDIO_TYPES: ReadonlySet<string> = new Set([\"stream\", \"loop\", \"playlist\"]);\n\nconst isTrackList = (tracks: unknown): boolean =>\n  Array.isArray(tracks) && tracks.length > 0 && tracks.every((t) => isNonEmptyString(t));\n\nexport const validateAudio = (audio: AudioSource): ValidationResult =>\n  validate<AudioSource>([\n    existsProp(\"id\", \"Audio source is missing an id.\"),\n    propIs(\"volume\", isNumberInRange(0, 1), \"volume must be a number between 0 and 1.\"),\n    when(\n      (a: AudioSource) => a.type === \"stream\" || a.type === \"loop\",\n      existsProp(\"src\", \"Audio source is missing a src.\"),\n    ),\n    when(\n      (a: AudioSource) => a.type === \"playlist\",\n      existsProp(\"tracks\", \"tracks must be a non-empty array of URLs.\"),\n      propIs(\"tracks\", isTrackList, \"tracks must be a non-empty array of URLs.\"),\n    ),\n    when(\n      (a: AudioSource) => !isOneOf(AUDIO_TYPES)(a.type),\n      fail(\"type\", \"unknown audio type.\"),\n    ),\n  ])(audio);\n","import type { DataPlugin } from \"@scenography/scene\";\n\nimport { validateAudio } from \"./validate\";\nimport type { AudioSource } from \"./audio\";\n\n/** The data half of the audio plugin: owns the `audio` scene key (a collection). */\nexport const audioData: DataPlugin<AudioSource> = {\n  kind: \"audio\",\n  cardinality: \"many\",\n  validate: (source) => validateAudio(source),\n};\n"],"mappings":";;AAcA,MAAM,cAAmC,IAAI,IAAI;CAAC;CAAU;CAAQ;AAAU,CAAC;AAE/E,MAAM,eAAe,WACnB,MAAM,QAAQ,MAAM,KAAK,OAAO,SAAS,KAAK,OAAO,OAAO,OAAA,GAAA,mBAAA,iBAAA,CAAuB,CAAC,CAAC;AAEvF,MAAa,iBAAiB,WAAA,GAAA,mBAAA,SAAA,CACN;oCACT,MAAM,gCAAgC;gCAC1C,WAAA,GAAA,mBAAA,gBAAA,CAA0B,GAAG,CAAC,GAAG,0CAA0C;+BAE/E,MAAmB,EAAE,SAAS,YAAY,EAAE,SAAS,SAAA,GAAA,mBAAA,WAAA,CAC3C,OAAO,gCAAgC,CACpD;+BAEG,MAAmB,EAAE,SAAS,aAAA,GAAA,mBAAA,WAAA,CACpB,UAAU,2CAA2C,IAAA,GAAA,mBAAA,OAAA,CACzD,UAAU,aAAa,2CAA2C,CAC3E;+BAEG,MAAmB,EAAA,GAAA,mBAAA,QAAA,CAAS,WAAW,CAAC,CAAC,EAAE,IAAI,IAAA,GAAA,mBAAA,KAAA,CAC3C,QAAQ,qBAAqB,CACpC;AACF,CAAC,CAAC,CAAC,KAAK;;;;AC9BV,MAAa,YAAqC;CAChD,MAAM;CACN,aAAa;CACb,WAAW,WAAW,cAAc,MAAM;AAC5C"}

package/dist/data.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_data = require("./data-vyKDnIYf.cjs");
+exports.audioData = require_data.audioData;
+exports.validateAudio = require_data.validateAudio;

package/dist/data.d.cts

@@ -0,0 +1,2 @@
+import { i as AudioSourceType, n as validateAudio, r as AudioSource, t as audioData } from "./index-CR9ApbPg.cjs";
+export { type AudioSource, type AudioSourceType, audioData, validateAudio };

package/dist/data.d.mts

@@ -0,0 +1,2 @@
+import { i as AudioSourceType, n as validateAudio, r as AudioSource, t as audioData } from "./index-CR9ApbPg.mjs";
+export { type AudioSource, type AudioSourceType, audioData, validateAudio };

package/dist/data.mjs

@@ -0,0 +1,2 @@
+import { n as validateAudio, t as audioData } from "./data-ChoGUA4U.mjs";
+export { audioData, validateAudio };

package/dist/index-CR9ApbPg.d.cts

@@ -0,0 +1,48 @@
+import { DataPlugin, ValidationResult } from "@scenography/scene";
+
+//#region src/data/audio.d.ts
+/** Fields shared by every audio source variant. */
+interface AudioBase {
+  id: string;
+  /** Initial volume, `0`..`1`. Defaults to `1`. */
+  volume?: number;
+  /** Begin playing as soon as the visitor's first gesture unlocks audio. Defaults to `false`. */
+  autoplay?: boolean;
+}
+/**
+ * A background audio source. Extensible via `type`: a live online `stream`
+ * (radio), a single file on `loop`, or an ordered `playlist` of files. Playback
+ * (play/pause/fade) is driven by `id` from the runtime through `ctx.media` — the
+ * definition stays pure data.
+ */
+type AudioSource = (AudioBase & {
+  type: "stream"; /** URL of the live stream / online radio. */
+  src: string;
+}) | (AudioBase & {
+  type: "loop"; /** URL of the file played on repeat. */
+  src: string;
+}) | (AudioBase & {
+  type: "playlist"; /** Track URLs played in sequence. */
+  tracks: string[]; /** Restart from the first track when the last ends. Defaults to `true`. */
+  loop?: boolean; /** Play tracks in random order. Defaults to `false`. */
+  shuffle?: boolean; /** Crossfade between tracks, in ms. Defaults to `0` (hard cut). */
+  crossfade?: number;
+});
+/** The discriminant values an `AudioSource` can take. */
+type AudioSourceType = AudioSource["type"];
+declare module "@scenography/scene" {
+  interface Scene {
+    /** Background audio sources — provided by `@scenography/plugin-audio`. */
+    audio?: AudioSource[];
+  }
+}
+//#endregion
+//#region src/data/validate.d.ts
+declare const validateAudio: (audio: AudioSource) => ValidationResult;
+//#endregion
+//#region src/data/plugin.d.ts
+/** The data half of the audio plugin: owns the `audio` scene key (a collection). */
+declare const audioData: DataPlugin<AudioSource>;
+//#endregion
+export { AudioSourceType as i, validateAudio as n, AudioSource as r, audioData as t };
+//# sourceMappingURL=index-CR9ApbPg.d.cts.map

package/dist/index-CR9ApbPg.d.mts

@@ -0,0 +1,48 @@
+import { DataPlugin, ValidationResult } from "@scenography/scene";
+
+//#region src/data/audio.d.ts
+/** Fields shared by every audio source variant. */
+interface AudioBase {
+  id: string;
+  /** Initial volume, `0`..`1`. Defaults to `1`. */
+  volume?: number;
+  /** Begin playing as soon as the visitor's first gesture unlocks audio. Defaults to `false`. */
+  autoplay?: boolean;
+}
+/**
+ * A background audio source. Extensible via `type`: a live online `stream`
+ * (radio), a single file on `loop`, or an ordered `playlist` of files. Playback
+ * (play/pause/fade) is driven by `id` from the runtime through `ctx.media` — the
+ * definition stays pure data.
+ */
+type AudioSource = (AudioBase & {
+  type: "stream"; /** URL of the live stream / online radio. */
+  src: string;
+}) | (AudioBase & {
+  type: "loop"; /** URL of the file played on repeat. */
+  src: string;
+}) | (AudioBase & {
+  type: "playlist"; /** Track URLs played in sequence. */
+  tracks: string[]; /** Restart from the first track when the last ends. Defaults to `true`. */
+  loop?: boolean; /** Play tracks in random order. Defaults to `false`. */
+  shuffle?: boolean; /** Crossfade between tracks, in ms. Defaults to `0` (hard cut). */
+  crossfade?: number;
+});
+/** The discriminant values an `AudioSource` can take. */
+type AudioSourceType = AudioSource["type"];
+declare module "@scenography/scene" {
+  interface Scene {
+    /** Background audio sources — provided by `@scenography/plugin-audio`. */
+    audio?: AudioSource[];
+  }
+}
+//#endregion
+//#region src/data/validate.d.ts
+declare const validateAudio: (audio: AudioSource) => ValidationResult;
+//#endregion
+//#region src/data/plugin.d.ts
+/** The data half of the audio plugin: owns the `audio` scene key (a collection). */
+declare const audioData: DataPlugin<AudioSource>;
+//#endregion
+export { AudioSourceType as i, validateAudio as n, AudioSource as r, audioData as t };
+//# sourceMappingURL=index-CR9ApbPg.d.mts.map

package/dist/index.cjs

@@ -0,0 +1,222 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_data = require("./data-vyKDnIYf.cjs");
+let three = require("three");
+//#region src/AudioEngine.ts
+const range = (n) => Array.from({ length: n }, (_, i) => i);
+const shuffled = (n) => {
+	const a = range(n);
+	for (let i = a.length - 1; i > 0; i--) {
+		const j = Math.floor(Math.random() * (i + 1));
+		[a[i], a[j]] = [a[j], a[i]];
+	}
+	return a;
+};
+/**
+* Background-audio runtime over three.js `Audio` + an `AudioListener` on the
+* camera (no extra dependency; positional audio stays reachable later). Streams
+* and playlists ride an `HTMLAudioElement` routed through the listener's gain so
+* volume/fades go through the Web Audio graph.
+*
+* Browsers block audio until a user gesture, so playback is unlocked on the
+* first pointer/key event; `autoplay` sources start then.
+*/
+var AudioEngine = class {
+	listener;
+	camera;
+	players = /* @__PURE__ */ new Map();
+	unlocked = false;
+	masterMuted = false;
+	constructor(camera) {
+		this.camera = camera;
+		this.listener = new three.AudioListener();
+		camera.add(this.listener);
+		window.addEventListener("pointerdown", this.unlock);
+		window.addEventListener("keydown", this.unlock);
+	}
+	unlock = () => {
+		if (this.unlocked) return;
+		this.unlocked = true;
+		this.listener.context.resume();
+		for (const player of this.players.values()) if (player.source.autoplay) this.start(player);
+		window.removeEventListener("pointerdown", this.unlock);
+		window.removeEventListener("keydown", this.unlock);
+	};
+	/** Diff incoming audio sources against mounted players, by `id`. */
+	reconcile(sources) {
+		const list = sources ?? [];
+		const next = new Set(list.map((s) => s.id));
+		for (const [id, player] of this.players) if (!next.has(id)) {
+			this.teardown(player);
+			this.players.delete(id);
+		}
+		for (const source of list) {
+			const hash = JSON.stringify(source);
+			const existing = this.players.get(source.id);
+			if (existing?.hash === hash) continue;
+			if (existing) {
+				this.teardown(existing);
+				this.players.delete(source.id);
+			}
+			const player = this.build(source, hash);
+			this.players.set(source.id, player);
+			if (this.unlocked && source.autoplay) this.start(player);
+		}
+	}
+	build(source, hash) {
+		const el = document.createElement("audio");
+		el.crossOrigin = "anonymous";
+		el.preload = "auto";
+		const order = source.type === "playlist" ? source.shuffle ? shuffled(source.tracks.length) : range(source.tracks.length) : [0];
+		const audio = new three.Audio(this.listener);
+		audio.setMediaElementSource(el);
+		const volume = source.volume ?? 1;
+		audio.setVolume(volume);
+		const player = {
+			source,
+			hash,
+			el,
+			audio,
+			volume,
+			current: volume,
+			order,
+			index: 0
+		};
+		if (source.type === "loop") {
+			el.loop = true;
+			el.src = source.src;
+		} else if (source.type === "stream") el.src = source.src;
+		else {
+			el.addEventListener("ended", () => this.onTrackEnded(player));
+			this.loadTrack(player, 0);
+		}
+		return player;
+	}
+	loadTrack(player, index) {
+		if (player.source.type !== "playlist") return;
+		const track = player.order[index];
+		const url = track !== void 0 ? player.source.tracks[track] : void 0;
+		if (url === void 0) return;
+		player.index = index;
+		player.el.src = url;
+	}
+	onTrackEnded(player) {
+		const source = player.source;
+		if (source.type !== "playlist") return;
+		const next = player.index + 1;
+		if (next < player.order.length) this.advance(player, next);
+		else if (source.loop ?? true) {
+			if (source.shuffle) player.order = shuffled(source.tracks.length);
+			this.advance(player, 0);
+		}
+	}
+	advance(player, index) {
+		this.loadTrack(player, index);
+		const crossfade = player.source.type === "playlist" ? player.source.crossfade ?? 0 : 0;
+		if (crossfade > 0) {
+			this.applyVolume(player, 0);
+			this.fadeTo(player, player.volume, crossfade);
+		}
+		player.el.play().catch(() => void 0);
+	}
+	start(player) {
+		this.listener.context.resume();
+		player.el.play().catch(() => void 0);
+	}
+	applyVolume(player, volume) {
+		player.current = volume;
+		player.audio.setVolume(volume);
+	}
+	fadeTo(player, to, duration) {
+		if (!duration || duration <= 0) {
+			player.fade = void 0;
+			this.applyVolume(player, to);
+			return;
+		}
+		player.fade = {
+			from: player.current,
+			to,
+			elapsed: 0,
+			duration
+		};
+	}
+	teardown(player) {
+		player.el.pause();
+		player.el.removeAttribute("src");
+		player.audio.disconnect();
+	}
+	/** Advance active volume fades. Called once per frame with the delta in ms. */
+	update(deltaMs) {
+		for (const player of this.players.values()) {
+			const fade = player.fade;
+			if (!fade) continue;
+			fade.elapsed += deltaMs;
+			const k = fade.duration > 0 ? Math.min(fade.elapsed / fade.duration, 1) : 1;
+			this.applyVolume(player, fade.from + (fade.to - fade.from) * k);
+			if (k >= 1) player.fade = void 0;
+		}
+	}
+	/** The `ctx.media` surface backed by this engine. */
+	controller = {
+		play: (id) => {
+			const player = this.players.get(id);
+			if (player) this.start(player);
+		},
+		pause: (id) => this.players.get(id)?.el.pause(),
+		stop: (id) => {
+			const player = this.players.get(id);
+			if (!player) return;
+			player.el.pause();
+			if (player.source.type !== "stream") player.el.currentTime = 0;
+		},
+		setVolume: (id, volume, opts) => {
+			const player = this.players.get(id);
+			if (!player) return;
+			player.volume = volume;
+			this.fadeTo(player, volume, opts?.duration ?? 0);
+		},
+		playing: (id) => {
+			const player = this.players.get(id);
+			return player ? !player.el.paused : false;
+		},
+		setMuted: (muted) => {
+			this.masterMuted = muted;
+			this.listener.setMasterVolume(muted ? 0 : 1);
+		},
+		muted: () => this.masterMuted
+	};
+	dispose() {
+		window.removeEventListener("pointerdown", this.unlock);
+		window.removeEventListener("keydown", this.unlock);
+		for (const player of this.players.values()) this.teardown(player);
+		this.players.clear();
+		this.camera.remove(this.listener);
+	}
+};
+//#endregion
+//#region src/plugin.ts
+/**
+* Background audio — a *system* plugin. It attaches an `AudioListener` to the
+* kernel camera and plays/loops/streams the sources in `scene.audio`, exposing
+* `ctx.media` (play/pause/volume/mute). It manages its own audio nodes rather
+* than scene-graph objects, so it lives outside the element reconciler.
+*/
+const audio = () => ({
+	name: "audio",
+	setup: (ctx) => {
+		const engine = new AudioEngine(ctx.camera);
+		engine.reconcile(ctx.scene.audio);
+		return {
+			update: (deltaMs) => engine.update(deltaMs),
+			setScene: (scene) => engine.reconcile(scene.audio),
+			dispose: () => engine.dispose(),
+			api: engine.controller
+		};
+	}
+});
+//#endregion
+exports.AudioEngine = AudioEngine;
+exports.audio = audio;
+exports.audioData = require_data.audioData;
+exports.validateAudio = require_data.validateAudio;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["AudioListener","ThreeAudio"],"sources":["../src/AudioEngine.ts","../src/plugin.ts"],"sourcesContent":["import type { MediaController } from \"@scenography/engine\";\nimport { Audio as ThreeAudio, AudioListener, type Object3D } from \"three\";\n\nimport type { AudioSource } from \"./data\";\n\ninterface VolumeFade {\n  from: number;\n  to: number;\n  elapsed: number;\n  duration: number;\n}\n\ninterface Player {\n  source: AudioSource;\n  hash: string;\n  el: HTMLAudioElement;\n  audio: ThreeAudio;\n  /** Configured base volume (the fade target for `play`/track changes). */\n  volume: number;\n  /** Currently applied volume. */\n  current: number;\n  fade?: VolumeFade;\n  /** Playlist playback order (indices into `tracks`); single-entry otherwise. */\n  order: number[];\n  /** Position within `order`. */\n  index: number;\n}\n\nconst range = (n: number): number[] => Array.from({ length: n }, (_, i) => i);\n\nconst shuffled = (n: number): number[] => {\n  const a = range(n);\n  for (let i = a.length - 1; i > 0; i--) {\n    const j = Math.floor(Math.random() * (i + 1));\n    [a[i], a[j]] = [a[j]!, a[i]!];\n  }\n  return a;\n};\n\n/**\n * Background-audio runtime over three.js `Audio` + an `AudioListener` on the\n * camera (no extra dependency; positional audio stays reachable later). Streams\n * and playlists ride an `HTMLAudioElement` routed through the listener's gain so\n * volume/fades go through the Web Audio graph.\n *\n * Browsers block audio until a user gesture, so playback is unlocked on the\n * first pointer/key event; `autoplay` sources start then.\n */\nexport class AudioEngine {\n  private readonly listener: AudioListener;\n  private readonly camera: Object3D;\n  private readonly players = new Map<string, Player>();\n  private unlocked = false;\n  private masterMuted = false;\n\n  constructor(camera: Object3D) {\n    this.camera = camera;\n    this.listener = new AudioListener();\n    camera.add(this.listener);\n    window.addEventListener(\"pointerdown\", this.unlock);\n    window.addEventListener(\"keydown\", this.unlock);\n  }\n\n  private readonly unlock = (): void => {\n    if (this.unlocked) return;\n    this.unlocked = true;\n    void this.listener.context.resume();\n    for (const player of this.players.values()) {\n      if (player.source.autoplay) this.start(player);\n    }\n    window.removeEventListener(\"pointerdown\", this.unlock);\n    window.removeEventListener(\"keydown\", this.unlock);\n  };\n\n  /** Diff incoming audio sources against mounted players, by `id`. */\n  reconcile(sources: AudioSource[] | undefined): void {\n    const list = sources ?? [];\n    const next = new Set(list.map((s) => s.id));\n    for (const [id, player] of this.players) {\n      if (!next.has(id)) {\n        this.teardown(player);\n        this.players.delete(id);\n      }\n    }\n\n    for (const source of list) {\n      const hash = JSON.stringify(source);\n      const existing = this.players.get(source.id);\n      if (existing?.hash === hash) continue;\n      if (existing) {\n        this.teardown(existing);\n        this.players.delete(source.id);\n      }\n      const player = this.build(source, hash);\n      this.players.set(source.id, player);\n      if (this.unlocked && source.autoplay) this.start(player);\n    }\n  }\n\n  private build(source: AudioSource, hash: string): Player {\n    const el = document.createElement(\"audio\");\n    el.crossOrigin = \"anonymous\";\n    el.preload = \"auto\";\n\n    const order =\n      source.type === \"playlist\"\n        ? source.shuffle\n          ? shuffled(source.tracks.length)\n          : range(source.tracks.length)\n        : [0];\n\n    const audio = new ThreeAudio(this.listener);\n    audio.setMediaElementSource(el);\n    const volume = source.volume ?? 1;\n    audio.setVolume(volume);\n\n    const player: Player = { source, hash, el, audio, volume, current: volume, order, index: 0 };\n\n    if (source.type === \"loop\") {\n      el.loop = true;\n      el.src = source.src;\n    } else if (source.type === \"stream\") {\n      el.src = source.src;\n    } else {\n      el.addEventListener(\"ended\", () => this.onTrackEnded(player));\n      this.loadTrack(player, 0);\n    }\n\n    return player;\n  }\n\n  private loadTrack(player: Player, index: number): void {\n    if (player.source.type !== \"playlist\") return;\n    const track = player.order[index];\n    const url = track !== undefined ? player.source.tracks[track] : undefined;\n    if (url === undefined) return;\n    player.index = index;\n    player.el.src = url;\n  }\n\n  private onTrackEnded(player: Player): void {\n    const source = player.source;\n    if (source.type !== \"playlist\") return;\n    const next = player.index + 1;\n    if (next < player.order.length) {\n      this.advance(player, next);\n    } else if (source.loop ?? true) {\n      if (source.shuffle) player.order = shuffled(source.tracks.length);\n      this.advance(player, 0);\n    }\n  }\n\n  private advance(player: Player, index: number): void {\n    this.loadTrack(player, index);\n    const crossfade = player.source.type === \"playlist\" ? (player.source.crossfade ?? 0) : 0;\n    if (crossfade > 0) {\n      this.applyVolume(player, 0);\n      this.fadeTo(player, player.volume, crossfade);\n    }\n    void player.el.play().catch(() => undefined);\n  }\n\n  private start(player: Player): void {\n    void this.listener.context.resume();\n    void player.el.play().catch(() => undefined);\n  }\n\n  private applyVolume(player: Player, volume: number): void {\n    player.current = volume;\n    player.audio.setVolume(volume);\n  }\n\n  private fadeTo(player: Player, to: number, duration: number): void {\n    if (!duration || duration <= 0) {\n      player.fade = undefined;\n      this.applyVolume(player, to);\n      return;\n    }\n    player.fade = { from: player.current, to, elapsed: 0, duration };\n  }\n\n  private teardown(player: Player): void {\n    player.el.pause();\n    player.el.removeAttribute(\"src\");\n    player.audio.disconnect();\n  }\n\n  /** Advance active volume fades. Called once per frame with the delta in ms. */\n  update(deltaMs: number): void {\n    for (const player of this.players.values()) {\n      const fade = player.fade;\n      if (!fade) continue;\n      fade.elapsed += deltaMs;\n      const k = fade.duration > 0 ? Math.min(fade.elapsed / fade.duration, 1) : 1;\n      this.applyVolume(player, fade.from + (fade.to - fade.from) * k);\n      if (k >= 1) player.fade = undefined;\n    }\n  }\n\n  /** The `ctx.media` surface backed by this engine. */\n  readonly controller: MediaController = {\n    play: (id) => {\n      const player = this.players.get(id);\n      if (player) this.start(player);\n    },\n    pause: (id) => this.players.get(id)?.el.pause(),\n    stop: (id) => {\n      const player = this.players.get(id);\n      if (!player) return;\n      player.el.pause();\n      if (player.source.type !== \"stream\") player.el.currentTime = 0;\n    },\n    setVolume: (id, volume, opts) => {\n      const player = this.players.get(id);\n      if (!player) return;\n      player.volume = volume;\n      this.fadeTo(player, volume, opts?.duration ?? 0);\n    },\n    playing: (id) => {\n      const player = this.players.get(id);\n      return player ? !player.el.paused : false;\n    },\n    setMuted: (muted) => {\n      this.masterMuted = muted;\n      this.listener.setMasterVolume(muted ? 0 : 1);\n    },\n    muted: () => this.masterMuted,\n  };\n\n  dispose(): void {\n    window.removeEventListener(\"pointerdown\", this.unlock);\n    window.removeEventListener(\"keydown\", this.unlock);\n    for (const player of this.players.values()) this.teardown(player);\n    this.players.clear();\n    this.camera.remove(this.listener);\n  }\n}\n","import type { SystemPlugin, MediaController } from \"@scenography/engine\";\n\nimport { AudioEngine } from \"./AudioEngine\";\n\n/**\n * Background audio — a *system* plugin. It attaches an `AudioListener` to the\n * kernel camera and plays/loops/streams the sources in `scene.audio`, exposing\n * `ctx.media` (play/pause/volume/mute). It manages its own audio nodes rather\n * than scene-graph objects, so it lives outside the element reconciler.\n */\nexport const audio = (): SystemPlugin<MediaController> => ({\n  name: \"audio\",\n  setup: (ctx) => {\n    const engine = new AudioEngine(ctx.camera);\n    engine.reconcile(ctx.scene.audio);\n    return {\n      update: (deltaMs) => engine.update(deltaMs),\n      setScene: (scene) => engine.reconcile(scene.audio),\n      dispose: () => engine.dispose(),\n      api: engine.controller,\n    };\n  },\n});\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,50 @@
+import { i as AudioSourceType, n as validateAudio, r as AudioSource, t as audioData } from "./index-CR9ApbPg.cjs";
+import { MediaController, SystemPlugin } from "@scenography/engine";
+import { Object3D } from "three";
+
+//#region src/plugin.d.ts
+/**
+ * Background audio — a *system* plugin. It attaches an `AudioListener` to the
+ * kernel camera and plays/loops/streams the sources in `scene.audio`, exposing
+ * `ctx.media` (play/pause/volume/mute). It manages its own audio nodes rather
+ * than scene-graph objects, so it lives outside the element reconciler.
+ */
+declare const audio: () => SystemPlugin<MediaController>;
+//#endregion
+//#region src/AudioEngine.d.ts
+/**
+ * Background-audio runtime over three.js `Audio` + an `AudioListener` on the
+ * camera (no extra dependency; positional audio stays reachable later). Streams
+ * and playlists ride an `HTMLAudioElement` routed through the listener's gain so
+ * volume/fades go through the Web Audio graph.
+ *
+ * Browsers block audio until a user gesture, so playback is unlocked on the
+ * first pointer/key event; `autoplay` sources start then.
+ */
+declare class AudioEngine {
+  private readonly listener;
+  private readonly camera;
+  private readonly players;
+  private unlocked;
+  private masterMuted;
+  constructor(camera: Object3D);
+  private readonly unlock;
+  /** Diff incoming audio sources against mounted players, by `id`. */
+  reconcile(sources: AudioSource[] | undefined): void;
+  private build;
+  private loadTrack;
+  private onTrackEnded;
+  private advance;
+  private start;
+  private applyVolume;
+  private fadeTo;
+  private teardown;
+  /** Advance active volume fades. Called once per frame with the delta in ms. */
+  update(deltaMs: number): void;
+  /** The `ctx.media` surface backed by this engine. */
+  readonly controller: MediaController;
+  dispose(): void;
+}
+//#endregion
+export { AudioEngine, type AudioSource, type AudioSourceType, audio, audioData, validateAudio };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -0,0 +1,50 @@
+import { i as AudioSourceType, n as validateAudio, r as AudioSource, t as audioData } from "./index-CR9ApbPg.mjs";
+import { Object3D } from "three";
+import { MediaController, SystemPlugin } from "@scenography/engine";
+
+//#region src/plugin.d.ts
+/**
+ * Background audio — a *system* plugin. It attaches an `AudioListener` to the
+ * kernel camera and plays/loops/streams the sources in `scene.audio`, exposing
+ * `ctx.media` (play/pause/volume/mute). It manages its own audio nodes rather
+ * than scene-graph objects, so it lives outside the element reconciler.
+ */
+declare const audio: () => SystemPlugin<MediaController>;
+//#endregion
+//#region src/AudioEngine.d.ts
+/**
+ * Background-audio runtime over three.js `Audio` + an `AudioListener` on the
+ * camera (no extra dependency; positional audio stays reachable later). Streams
+ * and playlists ride an `HTMLAudioElement` routed through the listener's gain so
+ * volume/fades go through the Web Audio graph.
+ *
+ * Browsers block audio until a user gesture, so playback is unlocked on the
+ * first pointer/key event; `autoplay` sources start then.
+ */
+declare class AudioEngine {
+  private readonly listener;
+  private readonly camera;
+  private readonly players;
+  private unlocked;
+  private masterMuted;
+  constructor(camera: Object3D);
+  private readonly unlock;
+  /** Diff incoming audio sources against mounted players, by `id`. */
+  reconcile(sources: AudioSource[] | undefined): void;
+  private build;
+  private loadTrack;
+  private onTrackEnded;
+  private advance;
+  private start;
+  private applyVolume;
+  private fadeTo;
+  private teardown;
+  /** Advance active volume fades. Called once per frame with the delta in ms. */
+  update(deltaMs: number): void;
+  /** The `ctx.media` surface backed by this engine. */
+  readonly controller: MediaController;
+  dispose(): void;
+}
+//#endregion
+export { AudioEngine, type AudioSource, type AudioSourceType, audio, audioData, validateAudio };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -0,0 +1,218 @@
+import { n as validateAudio, t as audioData } from "./data-ChoGUA4U.mjs";
+import { Audio, AudioListener } from "three";
+//#region src/AudioEngine.ts
+const range = (n) => Array.from({ length: n }, (_, i) => i);
+const shuffled = (n) => {
+	const a = range(n);
+	for (let i = a.length - 1; i > 0; i--) {
+		const j = Math.floor(Math.random() * (i + 1));
+		[a[i], a[j]] = [a[j], a[i]];
+	}
+	return a;
+};
+/**
+* Background-audio runtime over three.js `Audio` + an `AudioListener` on the
+* camera (no extra dependency; positional audio stays reachable later). Streams
+* and playlists ride an `HTMLAudioElement` routed through the listener's gain so
+* volume/fades go through the Web Audio graph.
+*
+* Browsers block audio until a user gesture, so playback is unlocked on the
+* first pointer/key event; `autoplay` sources start then.
+*/
+var AudioEngine = class {
+	listener;
+	camera;
+	players = /* @__PURE__ */ new Map();
+	unlocked = false;
+	masterMuted = false;
+	constructor(camera) {
+		this.camera = camera;
+		this.listener = new AudioListener();
+		camera.add(this.listener);
+		window.addEventListener("pointerdown", this.unlock);
+		window.addEventListener("keydown", this.unlock);
+	}
+	unlock = () => {
+		if (this.unlocked) return;
+		this.unlocked = true;
+		this.listener.context.resume();
+		for (const player of this.players.values()) if (player.source.autoplay) this.start(player);
+		window.removeEventListener("pointerdown", this.unlock);
+		window.removeEventListener("keydown", this.unlock);
+	};
+	/** Diff incoming audio sources against mounted players, by `id`. */
+	reconcile(sources) {
+		const list = sources ?? [];
+		const next = new Set(list.map((s) => s.id));
+		for (const [id, player] of this.players) if (!next.has(id)) {
+			this.teardown(player);
+			this.players.delete(id);
+		}
+		for (const source of list) {
+			const hash = JSON.stringify(source);
+			const existing = this.players.get(source.id);
+			if (existing?.hash === hash) continue;
+			if (existing) {
+				this.teardown(existing);
+				this.players.delete(source.id);
+			}
+			const player = this.build(source, hash);
+			this.players.set(source.id, player);
+			if (this.unlocked && source.autoplay) this.start(player);
+		}
+	}
+	build(source, hash) {
+		const el = document.createElement("audio");
+		el.crossOrigin = "anonymous";
+		el.preload = "auto";
+		const order = source.type === "playlist" ? source.shuffle ? shuffled(source.tracks.length) : range(source.tracks.length) : [0];
+		const audio = new Audio(this.listener);
+		audio.setMediaElementSource(el);
+		const volume = source.volume ?? 1;
+		audio.setVolume(volume);
+		const player = {
+			source,
+			hash,
+			el,
+			audio,
+			volume,
+			current: volume,
+			order,
+			index: 0
+		};
+		if (source.type === "loop") {
+			el.loop = true;
+			el.src = source.src;
+		} else if (source.type === "stream") el.src = source.src;
+		else {
+			el.addEventListener("ended", () => this.onTrackEnded(player));
+			this.loadTrack(player, 0);
+		}
+		return player;
+	}
+	loadTrack(player, index) {
+		if (player.source.type !== "playlist") return;
+		const track = player.order[index];
+		const url = track !== void 0 ? player.source.tracks[track] : void 0;
+		if (url === void 0) return;
+		player.index = index;
+		player.el.src = url;
+	}
+	onTrackEnded(player) {
+		const source = player.source;
+		if (source.type !== "playlist") return;
+		const next = player.index + 1;
+		if (next < player.order.length) this.advance(player, next);
+		else if (source.loop ?? true) {
+			if (source.shuffle) player.order = shuffled(source.tracks.length);
+			this.advance(player, 0);
+		}
+	}
+	advance(player, index) {
+		this.loadTrack(player, index);
+		const crossfade = player.source.type === "playlist" ? player.source.crossfade ?? 0 : 0;
+		if (crossfade > 0) {
+			this.applyVolume(player, 0);
+			this.fadeTo(player, player.volume, crossfade);
+		}
+		player.el.play().catch(() => void 0);
+	}
+	start(player) {
+		this.listener.context.resume();
+		player.el.play().catch(() => void 0);
+	}
+	applyVolume(player, volume) {
+		player.current = volume;
+		player.audio.setVolume(volume);
+	}
+	fadeTo(player, to, duration) {
+		if (!duration || duration <= 0) {
+			player.fade = void 0;
+			this.applyVolume(player, to);
+			return;
+		}
+		player.fade = {
+			from: player.current,
+			to,
+			elapsed: 0,
+			duration
+		};
+	}
+	teardown(player) {
+		player.el.pause();
+		player.el.removeAttribute("src");
+		player.audio.disconnect();
+	}
+	/** Advance active volume fades. Called once per frame with the delta in ms. */
+	update(deltaMs) {
+		for (const player of this.players.values()) {
+			const fade = player.fade;
+			if (!fade) continue;
+			fade.elapsed += deltaMs;
+			const k = fade.duration > 0 ? Math.min(fade.elapsed / fade.duration, 1) : 1;
+			this.applyVolume(player, fade.from + (fade.to - fade.from) * k);
+			if (k >= 1) player.fade = void 0;
+		}
+	}
+	/** The `ctx.media` surface backed by this engine. */
+	controller = {
+		play: (id) => {
+			const player = this.players.get(id);
+			if (player) this.start(player);
+		},
+		pause: (id) => this.players.get(id)?.el.pause(),
+		stop: (id) => {
+			const player = this.players.get(id);
+			if (!player) return;
+			player.el.pause();
+			if (player.source.type !== "stream") player.el.currentTime = 0;
+		},
+		setVolume: (id, volume, opts) => {
+			const player = this.players.get(id);
+			if (!player) return;
+			player.volume = volume;
+			this.fadeTo(player, volume, opts?.duration ?? 0);
+		},
+		playing: (id) => {
+			const player = this.players.get(id);
+			return player ? !player.el.paused : false;
+		},
+		setMuted: (muted) => {
+			this.masterMuted = muted;
+			this.listener.setMasterVolume(muted ? 0 : 1);
+		},
+		muted: () => this.masterMuted
+	};
+	dispose() {
+		window.removeEventListener("pointerdown", this.unlock);
+		window.removeEventListener("keydown", this.unlock);
+		for (const player of this.players.values()) this.teardown(player);
+		this.players.clear();
+		this.camera.remove(this.listener);
+	}
+};
+//#endregion
+//#region src/plugin.ts
+/**
+* Background audio — a *system* plugin. It attaches an `AudioListener` to the
+* kernel camera and plays/loops/streams the sources in `scene.audio`, exposing
+* `ctx.media` (play/pause/volume/mute). It manages its own audio nodes rather
+* than scene-graph objects, so it lives outside the element reconciler.
+*/
+const audio = () => ({
+	name: "audio",
+	setup: (ctx) => {
+		const engine = new AudioEngine(ctx.camera);
+		engine.reconcile(ctx.scene.audio);
+		return {
+			update: (deltaMs) => engine.update(deltaMs),
+			setScene: (scene) => engine.reconcile(scene.audio),
+			dispose: () => engine.dispose(),
+			api: engine.controller
+		};
+	}
+});
+//#endregion
+export { AudioEngine, audio, audioData, validateAudio };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["ThreeAudio"],"sources":["../src/AudioEngine.ts","../src/plugin.ts"],"sourcesContent":["import type { MediaController } from \"@scenography/engine\";\nimport { Audio as ThreeAudio, AudioListener, type Object3D } from \"three\";\n\nimport type { AudioSource } from \"./data\";\n\ninterface VolumeFade {\n  from: number;\n  to: number;\n  elapsed: number;\n  duration: number;\n}\n\ninterface Player {\n  source: AudioSource;\n  hash: string;\n  el: HTMLAudioElement;\n  audio: ThreeAudio;\n  /** Configured base volume (the fade target for `play`/track changes). */\n  volume: number;\n  /** Currently applied volume. */\n  current: number;\n  fade?: VolumeFade;\n  /** Playlist playback order (indices into `tracks`); single-entry otherwise. */\n  order: number[];\n  /** Position within `order`. */\n  index: number;\n}\n\nconst range = (n: number): number[] => Array.from({ length: n }, (_, i) => i);\n\nconst shuffled = (n: number): number[] => {\n  const a = range(n);\n  for (let i = a.length - 1; i > 0; i--) {\n    const j = Math.floor(Math.random() * (i + 1));\n    [a[i], a[j]] = [a[j]!, a[i]!];\n  }\n  return a;\n};\n\n/**\n * Background-audio runtime over three.js `Audio` + an `AudioListener` on the\n * camera (no extra dependency; positional audio stays reachable later). Streams\n * and playlists ride an `HTMLAudioElement` routed through the listener's gain so\n * volume/fades go through the Web Audio graph.\n *\n * Browsers block audio until a user gesture, so playback is unlocked on the\n * first pointer/key event; `autoplay` sources start then.\n */\nexport class AudioEngine {\n  private readonly listener: AudioListener;\n  private readonly camera: Object3D;\n  private readonly players = new Map<string, Player>();\n  private unlocked = false;\n  private masterMuted = false;\n\n  constructor(camera: Object3D) {\n    this.camera = camera;\n    this.listener = new AudioListener();\n    camera.add(this.listener);\n    window.addEventListener(\"pointerdown\", this.unlock);\n    window.addEventListener(\"keydown\", this.unlock);\n  }\n\n  private readonly unlock = (): void => {\n    if (this.unlocked) return;\n    this.unlocked = true;\n    void this.listener.context.resume();\n    for (const player of this.players.values()) {\n      if (player.source.autoplay) this.start(player);\n    }\n    window.removeEventListener(\"pointerdown\", this.unlock);\n    window.removeEventListener(\"keydown\", this.unlock);\n  };\n\n  /** Diff incoming audio sources against mounted players, by `id`. */\n  reconcile(sources: AudioSource[] | undefined): void {\n    const list = sources ?? [];\n    const next = new Set(list.map((s) => s.id));\n    for (const [id, player] of this.players) {\n      if (!next.has(id)) {\n        this.teardown(player);\n        this.players.delete(id);\n      }\n    }\n\n    for (const source of list) {\n      const hash = JSON.stringify(source);\n      const existing = this.players.get(source.id);\n      if (existing?.hash === hash) continue;\n      if (existing) {\n        this.teardown(existing);\n        this.players.delete(source.id);\n      }\n      const player = this.build(source, hash);\n      this.players.set(source.id, player);\n      if (this.unlocked && source.autoplay) this.start(player);\n    }\n  }\n\n  private build(source: AudioSource, hash: string): Player {\n    const el = document.createElement(\"audio\");\n    el.crossOrigin = \"anonymous\";\n    el.preload = \"auto\";\n\n    const order =\n      source.type === \"playlist\"\n        ? source.shuffle\n          ? shuffled(source.tracks.length)\n          : range(source.tracks.length)\n        : [0];\n\n    const audio = new ThreeAudio(this.listener);\n    audio.setMediaElementSource(el);\n    const volume = source.volume ?? 1;\n    audio.setVolume(volume);\n\n    const player: Player = { source, hash, el, audio, volume, current: volume, order, index: 0 };\n\n    if (source.type === \"loop\") {\n      el.loop = true;\n      el.src = source.src;\n    } else if (source.type === \"stream\") {\n      el.src = source.src;\n    } else {\n      el.addEventListener(\"ended\", () => this.onTrackEnded(player));\n      this.loadTrack(player, 0);\n    }\n\n    return player;\n  }\n\n  private loadTrack(player: Player, index: number): void {\n    if (player.source.type !== \"playlist\") return;\n    const track = player.order[index];\n    const url = track !== undefined ? player.source.tracks[track] : undefined;\n    if (url === undefined) return;\n    player.index = index;\n    player.el.src = url;\n  }\n\n  private onTrackEnded(player: Player): void {\n    const source = player.source;\n    if (source.type !== \"playlist\") return;\n    const next = player.index + 1;\n    if (next < player.order.length) {\n      this.advance(player, next);\n    } else if (source.loop ?? true) {\n      if (source.shuffle) player.order = shuffled(source.tracks.length);\n      this.advance(player, 0);\n    }\n  }\n\n  private advance(player: Player, index: number): void {\n    this.loadTrack(player, index);\n    const crossfade = player.source.type === \"playlist\" ? (player.source.crossfade ?? 0) : 0;\n    if (crossfade > 0) {\n      this.applyVolume(player, 0);\n      this.fadeTo(player, player.volume, crossfade);\n    }\n    void player.el.play().catch(() => undefined);\n  }\n\n  private start(player: Player): void {\n    void this.listener.context.resume();\n    void player.el.play().catch(() => undefined);\n  }\n\n  private applyVolume(player: Player, volume: number): void {\n    player.current = volume;\n    player.audio.setVolume(volume);\n  }\n\n  private fadeTo(player: Player, to: number, duration: number): void {\n    if (!duration || duration <= 0) {\n      player.fade = undefined;\n      this.applyVolume(player, to);\n      return;\n    }\n    player.fade = { from: player.current, to, elapsed: 0, duration };\n  }\n\n  private teardown(player: Player): void {\n    player.el.pause();\n    player.el.removeAttribute(\"src\");\n    player.audio.disconnect();\n  }\n\n  /** Advance active volume fades. Called once per frame with the delta in ms. */\n  update(deltaMs: number): void {\n    for (const player of this.players.values()) {\n      const fade = player.fade;\n      if (!fade) continue;\n      fade.elapsed += deltaMs;\n      const k = fade.duration > 0 ? Math.min(fade.elapsed / fade.duration, 1) : 1;\n      this.applyVolume(player, fade.from + (fade.to - fade.from) * k);\n      if (k >= 1) player.fade = undefined;\n    }\n  }\n\n  /** The `ctx.media` surface backed by this engine. */\n  readonly controller: MediaController = {\n    play: (id) => {\n      const player = this.players.get(id);\n      if (player) this.start(player);\n    },\n    pause: (id) => this.players.get(id)?.el.pause(),\n    stop: (id) => {\n      const player = this.players.get(id);\n      if (!player) return;\n      player.el.pause();\n      if (player.source.type !== \"stream\") player.el.currentTime = 0;\n    },\n    setVolume: (id, volume, opts) => {\n      const player = this.players.get(id);\n      if (!player) return;\n      player.volume = volume;\n      this.fadeTo(player, volume, opts?.duration ?? 0);\n    },\n    playing: (id) => {\n      const player = this.players.get(id);\n      return player ? !player.el.paused : false;\n    },\n    setMuted: (muted) => {\n      this.masterMuted = muted;\n      this.listener.setMasterVolume(muted ? 0 : 1);\n    },\n    muted: () => this.masterMuted,\n  };\n\n  dispose(): void {\n    window.removeEventListener(\"pointerdown\", this.unlock);\n    window.removeEventListener(\"keydown\", this.unlock);\n    for (const player of this.players.values()) this.teardown(player);\n    this.players.clear();\n    this.camera.remove(this.listener);\n  }\n}\n","import type { SystemPlugin, MediaController } from \"@scenography/engine\";\n\nimport { AudioEngine } from \"./AudioEngine\";\n\n/**\n * Background audio — a *system* plugin. It attaches an `AudioListener` to the\n * kernel camera and plays/loops/streams the sources in `scene.audio`, exposing\n * `ctx.media` (play/pause/volume/mute). It manages its own audio nodes rather\n * than scene-graph objects, so it lives outside the element reconciler.\n */\nexport const audio = (): SystemPlugin<MediaController> => ({\n  name: \"audio\",\n  setup: (ctx) => {\n    const engine = new AudioEngine(ctx.camera);\n    engine.reconcile(ctx.scene.audio);\n    return {\n      update: (deltaMs) => engine.update(deltaMs),\n      setScene: (scene) => engine.reconcile(scene.audio),\n      dispose: () => engine.dispose(),\n      api: engine.controller,\n    };\n  },\n});\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@scenography/plugin-audio",
+  "version": "0.2.0",
+  "description": "Audio plugin for scenography: spatial/ambient audio sources with ctx.media runtime control.",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./data": {
+      "import": {
+        "types": "./dist/data.d.mts",
+        "default": "./dist/data.mjs"
+      },
+      "require": {
+        "types": "./dist/data.d.cts",
+        "default": "./dist/data.cjs"
+      }
+    }
+  },
+  "dependencies": {
+    "@scenography/scene": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/three": "^0.160.0",
+    "three": "^0.160.0",
+    "@scenography/engine": "0.2.0"
+  },
+  "peerDependencies": {
+    "three": ">=0.160.0",
+    "@scenography/engine": "0.2.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}