@sharpee/media 0.9.100

package/audio/audio-registry.d.ts

@@ -0,0 +1,249 @@
+/**
+ * AudioRegistry — central registration system for all audio in a story.
+ *
+ * Public interface: AudioCue, VariationPool, DuckingConfig, RoomAtmosphere,
+ * AtmosphereBuilder, and AudioRegistry class. Stories create one AudioRegistry
+ * in initializeWorld() and populate it with cues, pools, and atmospheres.
+ * Actions and handlers reference registered names only — never raw audio
+ * parameters.
+ *
+ * Owner context: @sharpee/media (ADR-138)
+ */
+import type { ISemanticEvent } from "../../core/index";
+import type { AudioAssetPath, AmbientChannel, Volume, DurationMs, DuckPriority, AudioEffectType, AudioTarget } from './types';
+import './registry-merge';
+/**
+ * An audio cue factory — returns a fresh event each invocation.
+ * Factories (not constants) because each call needs a unique event id/timestamp.
+ */
+export type AudioCue = () => ISemanticEvent;
+/**
+ * A variation pool — multiple audio files for the same logical sound.
+ * The registry picks one at random each time and applies jitter to
+ * prevent repetition fatigue.
+ */
+export interface VariationPool {
+    /** Audio files to choose from (at least one required) */
+    readonly sources: readonly AudioAssetPath[];
+    /** Base volume before jitter. Default: 1.0 */
+    readonly volume?: Volume;
+    /** Random volume jitter range: +/-jitter. e.g., 0.1 means volume varies +/-10%. Default: 0 */
+    readonly volumeJitter?: number;
+    /** Random pitch jitter range: +/-jitter applied to playback rate. e.g., 0.05 means +/-5%. Default: 0 */
+    readonly pitchJitter?: number;
+    /** Ducking priority. Default: 0 */
+    readonly duck?: DuckPriority;
+}
+/**
+ * Ducking configuration — how the client reduces background audio
+ * when a high-priority sound fires.
+ */
+export interface DuckingConfig {
+    /** Volume multiplier applied to ducked audio (0.0-1.0). Default: 0.3 */
+    readonly duckVolume: Volume;
+    /** How quickly ducked audio fades down (ms). Default: 100 */
+    readonly attackMs: DurationMs;
+    /** How quickly ducked audio recovers after the SFX ends (ms). Default: 500 */
+    readonly releaseMs: DurationMs;
+    /**
+     * Which categories get ducked. Default: ['music', 'ambient']
+     * SFX never duck other SFX.
+     */
+    readonly targets: readonly ('music' | 'ambient')[];
+}
+/**
+ * Atmosphere definition for a room or region.
+ * Describes the ambient soundscape, optional music track, and optional effect.
+ */
+export interface RoomAtmosphere {
+    readonly ambient: ReadonlyArray<{
+        readonly src: AudioAssetPath;
+        readonly channel: AmbientChannel;
+        readonly volume: Volume;
+    }>;
+    readonly music?: {
+        readonly src: AudioAssetPath;
+        readonly volume: Volume;
+    };
+    readonly effect?: {
+        readonly effect: AudioEffectType;
+        readonly target: AudioTarget;
+        readonly params: Readonly<Record<string, number>>;
+    };
+}
+/** Default fade durations for atmosphere transitions */
+export interface FadeDefaults {
+    /** Ambient channel fade-in duration (ms). Default: 2000 */
+    readonly ambientIn: DurationMs;
+    /** Ambient channel fade-out duration (ms). Default: 2000 */
+    readonly ambientOut: DurationMs;
+    /** Music track fade-in duration (ms). Default: 1000 */
+    readonly musicIn: DurationMs;
+    /** Audio effect transition duration (ms). Default: 2000 */
+    readonly effectTransition: DurationMs;
+}
+/**
+ * Central registry for all audio in a story.
+ * Stories populate this during initializeWorld(). Actions and handlers
+ * reference registered names — never raw audio parameters.
+ *
+ * @example
+ * ```typescript
+ * const audio = new AudioRegistry();
+ *
+ * // Register a simple cue
+ * audio.registerCue('skin.activate', () =>
+ *   createTypedEvent('audio.sfx', { src: 'sfx/skin-activate.mp3', volume: 0.8 })
+ * );
+ *
+ * // Register a variation pool (multiple files, random selection + jitter)
+ * audio.registerPool('footstep.metal', {
+ *   sources: ['sfx/step-metal-1.mp3', 'sfx/step-metal-2.mp3', 'sfx/step-metal-3.mp3'],
+ *   volume: 0.6,
+ *   volumeJitter: 0.1,
+ *   pitchJitter: 0.05,
+ * });
+ *
+ * // Register a room atmosphere using the fluent builder
+ * audio.atmosphere('entropy.room.bridge')
+ *   .ambient('ambient/ship-hum.mp3', 'environment', 0.3)
+ *   .ambient('ambient/console-beeps.mp3', 'machinery', 0.15)
+ *   .music('music/bridge-theme.mp3', 0.4)
+ *   .effect('lowpass', 'ambient:environment', { frequency: 2000, q: 1 })
+ *   .build();
+ *
+ * // In an action or handler — just use the name
+ * const events = audio.cue('skin.activate');
+ * ```
+ */
+export declare class AudioRegistry {
+    private cues;
+    private pools;
+    private atmospheres;
+    private fadeDefaultValues;
+    private duckingConfig;
+    /**
+     * Register a named audio cue (single sound, full control).
+     *
+     * @param name - Unique cue identifier (e.g., 'skin.activate', 'door.open')
+     * @param cue - Factory function that returns a fresh ISemanticEvent
+     */
+    registerCue(name: string, cue: AudioCue): void;
+    /**
+     * Register a variation pool — multiple files for one logical sound.
+     * When fired, the registry picks a random source and applies jitter.
+     *
+     * @param name - Unique pool identifier (e.g., 'footstep.metal')
+     * @param pool - Pool configuration with sources and jitter parameters
+     */
+    registerPool(name: string, pool: VariationPool): void;
+    /**
+     * Fire a registered cue or pool by name. Returns empty array if not registered.
+     *
+     * Resolution order:
+     * 1. Check cues (exact factory)
+     * 2. Check pools (random selection + jitter -> AudioSfxEvent)
+     * 3. Return [] (silent degradation)
+     *
+     * @param name - Registered cue or pool name
+     * @returns Array of events to emit (empty if name is not registered)
+     */
+    cue(name: string): ISemanticEvent[];
+    private resolvePool;
+    /**
+     * Override the default ducking behavior.
+     *
+     * @param config - Partial ducking configuration to merge with defaults
+     */
+    setDucking(config: Partial<DuckingConfig>): void;
+    /**
+     * Get the current ducking configuration.
+     *
+     * @returns Read-only ducking config
+     */
+    getDucking(): Readonly<DuckingConfig>;
+    /**
+     * Register a room atmosphere by room ID (raw object).
+     *
+     * @param roomId - Entity ID of the room
+     * @param atmosphere - Complete atmosphere definition
+     */
+    registerAtmosphere(roomId: string, atmosphere: RoomAtmosphere): void;
+    /**
+     * Start a fluent atmosphere builder for a room.
+     *
+     * @param roomId - Entity ID of the room
+     * @returns AtmosphereBuilder instance — call .build() to register
+     */
+    atmosphere(roomId: string): AtmosphereBuilder;
+    /**
+     * Get the registered atmosphere for a room.
+     *
+     * @param roomId - Entity ID of the room
+     * @returns The atmosphere definition, or undefined if none registered
+     */
+    getAtmosphere(roomId: string): RoomAtmosphere | undefined;
+    /**
+     * Override default fade durations (ms).
+     *
+     * @param defaults - Partial fade defaults to merge
+     */
+    setFadeDefaults(defaults: Partial<FadeDefaults>): void;
+    /**
+     * Get the current fade defaults.
+     *
+     * @returns Read-only fade defaults
+     */
+    getFadeDefaults(): Readonly<FadeDefaults>;
+}
+/**
+ * Fluent builder for room atmospheres.
+ * Avoids verbose JSON object literals in registration code.
+ *
+ * @example
+ * ```typescript
+ * registry.atmosphere('entropy.room.bridge')
+ *   .ambient('ambient/ship-hum.mp3', 'environment', 0.3)
+ *   .music('music/bridge-theme.mp3', 0.4)
+ *   .build();
+ * ```
+ */
+export declare class AtmosphereBuilder {
+    private registry;
+    private roomId;
+    private _ambient;
+    private _music;
+    private _effect;
+    constructor(registry: AudioRegistry, roomId: string);
+    /**
+     * Add an ambient channel to the atmosphere.
+     *
+     * @param src - Audio file path
+     * @param channel - Named channel identifier
+     * @param volume - Playback volume (0.0-1.0)
+     * @returns this (for chaining)
+     */
+    ambient(src: AudioAssetPath, channel: AmbientChannel, volume: Volume): this;
+    /**
+     * Set the music track for the atmosphere.
+     *
+     * @param src - Audio file path
+     * @param volume - Playback volume (0.0-1.0)
+     * @returns this (for chaining)
+     */
+    music(src: AudioAssetPath, volume: Volume): this;
+    /**
+     * Set an audio effect for the atmosphere.
+     *
+     * @param effect - Effect type (e.g., 'reverb', 'lowpass')
+     * @param target - Mix target to apply the effect to
+     * @param params - Effect-specific parameters
+     * @returns this (for chaining)
+     */
+    effect(effect: AudioEffectType, target: AudioTarget, params: Record<string, number>): this;
+    /**
+     * Register the atmosphere with the registry.
+     */
+    build(): void;
+}
+//# sourceMappingURL=audio-registry.d.ts.map

package/audio/audio-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-registry.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/media/src/audio/audio-registry.ts"],"names":[],"mappings":"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"}

package/audio/audio-registry.js

@@ -0,0 +1,250 @@
+"use strict";
+/**
+ * AudioRegistry — central registration system for all audio in a story.
+ *
+ * Public interface: AudioCue, VariationPool, DuckingConfig, RoomAtmosphere,
+ * AtmosphereBuilder, and AudioRegistry class. Stories create one AudioRegistry
+ * in initializeWorld() and populate it with cues, pools, and atmospheres.
+ * Actions and handlers reference registered names only — never raw audio
+ * parameters.
+ *
+ * Owner context: @sharpee/media (ADR-138)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AtmosphereBuilder = exports.AudioRegistry = void 0;
+const core_1 = require("../../core/index.js");
+// Ensure declaration merging is active
+require("./registry-merge");
+/**
+ * Central registry for all audio in a story.
+ * Stories populate this during initializeWorld(). Actions and handlers
+ * reference registered names — never raw audio parameters.
+ *
+ * @example
+ * ```typescript
+ * const audio = new AudioRegistry();
+ *
+ * // Register a simple cue
+ * audio.registerCue('skin.activate', () =>
+ *   createTypedEvent('audio.sfx', { src: 'sfx/skin-activate.mp3', volume: 0.8 })
+ * );
+ *
+ * // Register a variation pool (multiple files, random selection + jitter)
+ * audio.registerPool('footstep.metal', {
+ *   sources: ['sfx/step-metal-1.mp3', 'sfx/step-metal-2.mp3', 'sfx/step-metal-3.mp3'],
+ *   volume: 0.6,
+ *   volumeJitter: 0.1,
+ *   pitchJitter: 0.05,
+ * });
+ *
+ * // Register a room atmosphere using the fluent builder
+ * audio.atmosphere('entropy.room.bridge')
+ *   .ambient('ambient/ship-hum.mp3', 'environment', 0.3)
+ *   .ambient('ambient/console-beeps.mp3', 'machinery', 0.15)
+ *   .music('music/bridge-theme.mp3', 0.4)
+ *   .effect('lowpass', 'ambient:environment', { frequency: 2000, q: 1 })
+ *   .build();
+ *
+ * // In an action or handler — just use the name
+ * const events = audio.cue('skin.activate');
+ * ```
+ */
+class AudioRegistry {
+    cues = new Map();
+    pools = new Map();
+    atmospheres = new Map();
+    fadeDefaultValues = {
+        ambientIn: 2000,
+        ambientOut: 2000,
+        musicIn: 1000,
+        effectTransition: 2000,
+    };
+    duckingConfig = {
+        duckVolume: 0.3,
+        attackMs: 100,
+        releaseMs: 500,
+        targets: ['music', 'ambient'],
+    };
+    // ── Cues ────────────────────────────────────────────────────────────
+    /**
+     * Register a named audio cue (single sound, full control).
+     *
+     * @param name - Unique cue identifier (e.g., 'skin.activate', 'door.open')
+     * @param cue - Factory function that returns a fresh ISemanticEvent
+     */
+    registerCue(name, cue) {
+        this.cues.set(name, cue);
+    }
+    /**
+     * Register a variation pool — multiple files for one logical sound.
+     * When fired, the registry picks a random source and applies jitter.
+     *
+     * @param name - Unique pool identifier (e.g., 'footstep.metal')
+     * @param pool - Pool configuration with sources and jitter parameters
+     */
+    registerPool(name, pool) {
+        this.pools.set(name, pool);
+    }
+    /**
+     * Fire a registered cue or pool by name. Returns empty array if not registered.
+     *
+     * Resolution order:
+     * 1. Check cues (exact factory)
+     * 2. Check pools (random selection + jitter -> AudioSfxEvent)
+     * 3. Return [] (silent degradation)
+     *
+     * @param name - Registered cue or pool name
+     * @returns Array of events to emit (empty if name is not registered)
+     */
+    cue(name) {
+        const factory = this.cues.get(name);
+        if (factory)
+            return [factory()];
+        const pool = this.pools.get(name);
+        if (pool)
+            return [this.resolvePool(pool)];
+        return [];
+    }
+    resolvePool(pool) {
+        const src = pool.sources[Math.floor(Math.random() * pool.sources.length)];
+        const baseVolume = pool.volume ?? 1.0;
+        const volumeJitter = pool.volumeJitter ?? 0;
+        const pitchJitter = pool.pitchJitter ?? 0;
+        const volume = Math.max(0, Math.min(1, baseVolume + (Math.random() * 2 - 1) * volumeJitter));
+        const rate = 1.0 + (Math.random() * 2 - 1) * pitchJitter;
+        return (0, core_1.createTypedEvent)('audio.sfx', { src, volume, rate, duck: pool.duck });
+    }
+    // ── Ducking ─────────────────────────────────────────────────────────
+    /**
+     * Override the default ducking behavior.
+     *
+     * @param config - Partial ducking configuration to merge with defaults
+     */
+    setDucking(config) {
+        this.duckingConfig = { ...this.duckingConfig, ...config };
+    }
+    /**
+     * Get the current ducking configuration.
+     *
+     * @returns Read-only ducking config
+     */
+    getDucking() {
+        return this.duckingConfig;
+    }
+    // ── Atmospheres ─────────────────────────────────────────────────────
+    /**
+     * Register a room atmosphere by room ID (raw object).
+     *
+     * @param roomId - Entity ID of the room
+     * @param atmosphere - Complete atmosphere definition
+     */
+    registerAtmosphere(roomId, atmosphere) {
+        this.atmospheres.set(roomId, atmosphere);
+    }
+    /**
+     * Start a fluent atmosphere builder for a room.
+     *
+     * @param roomId - Entity ID of the room
+     * @returns AtmosphereBuilder instance — call .build() to register
+     */
+    atmosphere(roomId) {
+        return new AtmosphereBuilder(this, roomId);
+    }
+    /**
+     * Get the registered atmosphere for a room.
+     *
+     * @param roomId - Entity ID of the room
+     * @returns The atmosphere definition, or undefined if none registered
+     */
+    getAtmosphere(roomId) {
+        return this.atmospheres.get(roomId);
+    }
+    // ── Fade defaults ───────────────────────────────────────────────────
+    /**
+     * Override default fade durations (ms).
+     *
+     * @param defaults - Partial fade defaults to merge
+     */
+    setFadeDefaults(defaults) {
+        this.fadeDefaultValues = { ...this.fadeDefaultValues, ...defaults };
+    }
+    /**
+     * Get the current fade defaults.
+     *
+     * @returns Read-only fade defaults
+     */
+    getFadeDefaults() {
+        return this.fadeDefaultValues;
+    }
+}
+exports.AudioRegistry = AudioRegistry;
+/**
+ * Fluent builder for room atmospheres.
+ * Avoids verbose JSON object literals in registration code.
+ *
+ * @example
+ * ```typescript
+ * registry.atmosphere('entropy.room.bridge')
+ *   .ambient('ambient/ship-hum.mp3', 'environment', 0.3)
+ *   .music('music/bridge-theme.mp3', 0.4)
+ *   .build();
+ * ```
+ */
+class AtmosphereBuilder {
+    registry;
+    roomId;
+    _ambient = [];
+    _music;
+    _effect;
+    constructor(registry, roomId) {
+        this.registry = registry;
+        this.roomId = roomId;
+    }
+    /**
+     * Add an ambient channel to the atmosphere.
+     *
+     * @param src - Audio file path
+     * @param channel - Named channel identifier
+     * @param volume - Playback volume (0.0-1.0)
+     * @returns this (for chaining)
+     */
+    ambient(src, channel, volume) {
+        this._ambient = [...this._ambient, { src, channel, volume }];
+        return this;
+    }
+    /**
+     * Set the music track for the atmosphere.
+     *
+     * @param src - Audio file path
+     * @param volume - Playback volume (0.0-1.0)
+     * @returns this (for chaining)
+     */
+    music(src, volume) {
+        this._music = { src, volume };
+        return this;
+    }
+    /**
+     * Set an audio effect for the atmosphere.
+     *
+     * @param effect - Effect type (e.g., 'reverb', 'lowpass')
+     * @param target - Mix target to apply the effect to
+     * @param params - Effect-specific parameters
+     * @returns this (for chaining)
+     */
+    effect(effect, target, params) {
+        this._effect = { effect, target, params };
+        return this;
+    }
+    /**
+     * Register the atmosphere with the registry.
+     */
+    build() {
+        this.registry.registerAtmosphere(this.roomId, {
+            ambient: this._ambient,
+            music: this._music,
+            effect: this._effect,
+        });
+    }
+}
+exports.AtmosphereBuilder = AtmosphereBuilder;
+//# sourceMappingURL=audio-registry.js.map

package/audio/audio-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-registry.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/media/src/audio/audio-registry.ts"],"names":[],"mappings":"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"}

package/audio/capabilities.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Audio capability negotiation and player preference types.
+ *
+ * Public interface: AudioCapabilities (declared by clients at session start)
+ * and AudioPreferences (player settings persisted by clients).
+ *
+ * Owner context: @sharpee/media (ADR-138)
+ */
+import type { Volume, AudioFormat } from './types';
+/**
+ * Audio capabilities declared by the client at session start.
+ * Stories can check these before emitting audio events to avoid
+ * sending events the client cannot render.
+ */
+export interface AudioCapabilities {
+    /** Can play sound effects (AudioSfxEvent) */
+    readonly sfx: boolean;
+    /** Can play background music (AudioMusicPlayEvent/StopEvent) */
+    readonly music: boolean;
+    /** Can layer ambient channels (AudioAmbientPlayEvent/StopEvent) */
+    readonly ambient: boolean;
+    /** Can synthesize procedural sounds (AudioProceduralEvent) */
+    readonly procedural: boolean;
+    /** Can apply audio effects (AudioEffectEvent) */
+    readonly effects: boolean;
+    /** Maximum simultaneous audio sources. 0 = unlimited. */
+    readonly maxChannels?: number;
+    /** Supported audio file formats */
+    readonly formats: readonly AudioFormat[];
+}
+/**
+ * Player audio preferences, persisted to localStorage by the client.
+ * Player settings override story-specified volumes.
+ */
+export interface AudioPreferences {
+    /** Master audio enabled/disabled */
+    enabled: boolean;
+    /** Master volume (multiplied against all event volumes). Default: 1.0 */
+    masterVolume: Volume;
+    /** Per-category volume multipliers */
+    sfxVolume: Volume;
+    musicVolume: Volume;
+    ambientVolume: Volume;
+    /** Per-category mute toggles (independent of volume) */
+    sfxMuted: boolean;
+    musicMuted: boolean;
+    ambientMuted: boolean;
+}
+//# sourceMappingURL=capabilities.d.ts.map

package/audio/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/media/src/audio/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IAEtB,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAExB,mEAAmE;IACnE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAE7B,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,yDAAyD;IACzD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IAEjB,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IAErB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IAEtB,wDAAwD;IACxD,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;CACvB"}

package/audio/capabilities.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Audio capability negotiation and player preference types.
+ *
+ * Public interface: AudioCapabilities (declared by clients at session start)
+ * and AudioPreferences (player settings persisted by clients).
+ *
+ * Owner context: @sharpee/media (ADR-138)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=capabilities.js.map

package/audio/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/media/src/audio/capabilities.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}

package/audio/events.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Audio event interfaces for the Sharpee media subsystem.
+ *
+ * Public interface: All audio event shapes, the AudioEvent discriminated
+ * union, and the isAudioEvent() type guard.
+ *
+ * Owner context: @sharpee/media (ADR-138). These events flow through the
+ * engine's event pipeline unchanged — clients that support audio render
+ * them; others ignore them.
+ */
+import type { Volume, DurationMs, StereoPan, PlaybackRate, AudioAssetPath, AmbientChannel, DuckPriority, AudioTarget, AudioEffectType, ProceduralRecipeName } from './types';
+/**
+ * Base interface for all audio events.
+ * Audio events flow through the engine's event pipeline unchanged.
+ * Clients that support audio render them; others ignore them.
+ */
+export interface AudioEventBase {
+    readonly type: string;
+}
+/**
+ * Play a sound effect.
+ *
+ * Use cases: door opening, item pickup, skin activation, weapon fire,
+ * system alert, puzzle solve chime.
+ */
+export interface AudioSfxEvent extends AudioEventBase {
+    readonly type: 'audio.sfx';
+    /** Audio file path (relative to assets/audio/) */
+    readonly src: AudioAssetPath;
+    /** Playback volume. Default: 1.0 */
+    readonly volume?: Volume;
+    /** Playback speed. Default: 1.0 */
+    readonly rate?: PlaybackRate;
+    /** Stereo position. Default: 0.0 (center) */
+    readonly pan?: StereoPan;
+    /**
+     * Ducking priority. Higher values duck lower-priority audio.
+     * When this SFX fires, ambient and music temporarily reduce volume
+     * so the SFX cuts through the mix. Default: 0 (no ducking).
+     *
+     * Suggested values:
+     * - 0: ambient/background SFX (no ducking)
+     * - 1: normal gameplay SFX (subtle duck)
+     * - 2: important feedback (moderate duck)
+     * - 3: critical alerts, combat hits (aggressive duck)
+     */
+    readonly duck?: DuckPriority;
+}
+/**
+ * Start playing a music track, or crossfade to a new one.
+ * If music is already playing, the current track fades out while
+ * the new one fades in over the fadeIn duration.
+ *
+ * Use cases: exploration theme, tension/combat music, victory stinger.
+ */
+export interface AudioMusicPlayEvent extends AudioEventBase {
+    readonly type: 'audio.music.play';
+    /** Audio file path (relative to assets/audio/) */
+    readonly src: AudioAssetPath;
+    /** Playback volume. Default: 0.5 */
+    readonly volume?: Volume;
+    /** Fade-in duration. Default: 1000ms */
+    readonly fadeIn?: DurationMs;
+    /** Whether to loop the track. Default: true */
+    readonly loop?: boolean;
+}
+/**
+ * Stop the current music track.
+ */
+export interface AudioMusicStopEvent extends AudioEventBase {
+    readonly type: 'audio.music.stop';
+    /** Fade-out duration. Default: 1000ms */
+    readonly fadeOut?: DurationMs;
+}
+/**
+ * Start or replace an ambient channel.
+ *
+ * Use cases: wind, rain, cave dripping, engine hum, distant explosions,
+ * electrical buzz, crowd murmur.
+ */
+export interface AudioAmbientPlayEvent extends AudioEventBase {
+    readonly type: 'audio.ambient.play';
+    /** Audio file path (relative to assets/audio/) */
+    readonly src: AudioAssetPath;
+    /** Named channel. Reusing a channel name replaces the current source. */
+    readonly channel: AmbientChannel;
+    /** Playback volume. Default: 0.3 */
+    readonly volume?: Volume;
+    /** Fade-in duration. Default: 2000ms */
+    readonly fadeIn?: DurationMs;
+    /** Whether to loop. Default: true */
+    readonly loop?: boolean;
+}
+/**
+ * Stop a single ambient channel.
+ */
+export interface AudioAmbientStopEvent extends AudioEventBase {
+    readonly type: 'audio.ambient.stop';
+    /** Channel to stop */
+    readonly channel: AmbientChannel;
+    /** Fade-out duration. Default: 2000ms */
+    readonly fadeOut?: DurationMs;
+}
+/**
+ * Stop all ambient channels at once (e.g., on scene change).
+ */
+export interface AudioAmbientStopAllEvent extends AudioEventBase {
+    readonly type: 'audio.ambient.stop_all';
+    /** Fade-out duration for all channels. Default: 1000ms */
+    readonly fadeOut?: DurationMs;
+}
+/**
+ * Play a procedural sound from a named recipe.
+ *
+ * Recipes are registered by the client, not defined by the story.
+ * The story says *what* conceptual sound it wants; the client decides
+ * how to synthesize it. Clients without procedural support can map
+ * recipe names to fallback audio files, or skip the event.
+ *
+ * Use cases: system beeps, alerts, electrical hum, static bursts,
+ * tonal feedback for puzzle state.
+ */
+export interface AudioProceduralEvent extends AudioEventBase {
+    readonly type: 'audio.procedural';
+    /** Named recipe identifier */
+    readonly recipe: ProceduralRecipeName;
+    /** Recipe-specific parameters (override recipe defaults) */
+    readonly params?: Readonly<Record<string, number>>;
+    /** Playback volume. Default: 1.0 */
+    readonly volume?: Volume;
+    /** Duration override. Uses recipe default if omitted. */
+    readonly duration?: DurationMs;
+    /** Ducking priority. See AudioSfxEvent.duck. Default: 0 */
+    readonly duck?: DuckPriority;
+}
+/**
+ * Apply an audio effect to a mix target.
+ *
+ * Use cases: reverb in caves, muffled sound behind walls,
+ * distortion during damage, lowpass for flashback sequences.
+ */
+export interface AudioEffectEvent extends AudioEventBase {
+    readonly type: 'audio.effect';
+    /** Which part of the audio mix to affect */
+    readonly target: AudioTarget;
+    /** Effect to apply */
+    readonly effect: AudioEffectType;
+    /** Effect-specific parameters */
+    readonly params: Readonly<Record<string, number>>;
+    /** Transition time to reach new effect state. Default: 0 (instant) */
+    readonly transition?: DurationMs;
+}
+/**
+ * Remove all effects from a mix target.
+ */
+export interface AudioEffectClearEvent extends AudioEventBase {
+    readonly type: 'audio.effect.clear';
+    /** Which part of the audio mix to clear effects from */
+    readonly target: AudioTarget;
+    /** Transition time to remove effects. Default: 0 (instant) */
+    readonly transition?: DurationMs;
+}
+/**
+ * Union of all audio events. Clients switch on the `type` discriminant.
+ */
+export type AudioEvent = AudioSfxEvent | AudioMusicPlayEvent | AudioMusicStopEvent | AudioAmbientPlayEvent | AudioAmbientStopEvent | AudioAmbientStopAllEvent | AudioProceduralEvent | AudioEffectEvent | AudioEffectClearEvent;
+/**
+ * Returns true if the event is any audio event.
+ *
+ * @param event - Any object with a `type` string field
+ * @returns Type predicate narrowing to AudioEvent
+ */
+export declare function isAudioEvent(event: {
+    type: string;
+}): event is AudioEvent;
+//# sourceMappingURL=events.d.ts.map

package/audio/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/media/src/audio/events.ts"],"names":[],"mappings":"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"}

package/audio/events.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Audio event interfaces for the Sharpee media subsystem.
+ *
+ * Public interface: All audio event shapes, the AudioEvent discriminated
+ * union, and the isAudioEvent() type guard.
+ *
+ * Owner context: @sharpee/media (ADR-138). These events flow through the
+ * engine's event pipeline unchanged — clients that support audio render
+ * them; others ignore them.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAudioEvent = isAudioEvent;
+// ── Type Guards ───────────────────────────────────────────────────────
+/**
+ * Returns true if the event is any audio event.
+ *
+ * @param event - Any object with a `type` string field
+ * @returns Type predicate narrowing to AudioEvent
+ */
+function isAudioEvent(event) {
+    return event.type.startsWith('audio.');
+}
+//# sourceMappingURL=events.js.map

package/audio/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/media/src/audio/events.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AA0PH,oCAEC;AAVD,yEAAyE;AAEzE;;;;;GAKG;AACH,SAAgB,YAAY,CAAC,KAAuB;IAClD,OAAO,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;AACzC,CAAC"}

package/audio/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Audio module barrel — re-exports all audio types, events, capabilities,
+ * registry merging, and the AudioRegistry class.
+ *
+ * Public interface: Everything needed by stories and clients to work
+ * with Sharpee audio.
+ *
+ * Owner context: @sharpee/media (ADR-138)
+ */
+export type { Volume, DurationMs, StereoPan, PlaybackRate, AudioAssetPath, AmbientChannel, DuckPriority, AudioTarget, AudioEffectType, AudioFormat, BuiltinRecipeName, ProceduralRecipeName, } from './types';
+export type { AudioEventBase, AudioSfxEvent, AudioMusicPlayEvent, AudioMusicStopEvent, AudioAmbientPlayEvent, AudioAmbientStopEvent, AudioAmbientStopAllEvent, AudioProceduralEvent, AudioEffectEvent, AudioEffectClearEvent, AudioEvent, } from './events';
+export { isAudioEvent } from './events';
+export type { AudioCapabilities, AudioPreferences, } from './capabilities';
+export type { AudioSfxData, AudioMusicPlayData, AudioMusicStopData, AudioAmbientPlayData, AudioAmbientStopData, AudioAmbientStopAllData, AudioProceduralData, AudioEffectData, AudioEffectClearData, } from './registry-merge';
+import './registry-merge';
+export type { AudioCue, VariationPool, DuckingConfig, RoomAtmosphere, FadeDefaults, } from './audio-registry';
+export { AudioRegistry, AtmosphereBuilder } from './audio-registry';
+//# sourceMappingURL=index.d.ts.map

package/audio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/media/src/audio/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EACV,MAAM,EACN,UAAU,EACV,SAAS,EACT,YAAY,EACZ,cAAc,EACd,cAAc,EACd,YAAY,EACZ,WAAW,EACX,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,UAAU,GACX,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,YAAY,EACV,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,eAAe,EACf,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,kBAAkB,CAAC;AAE1B,YAAY,EACV,QAAQ,EACR,aAAa,EACb,aAAa,EACb,cAAc,EACd,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/audio/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * Audio module barrel — re-exports all audio types, events, capabilities,
+ * registry merging, and the AudioRegistry class.
+ *
+ * Public interface: Everything needed by stories and clients to work
+ * with Sharpee audio.
+ *
+ * Owner context: @sharpee/media (ADR-138)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AtmosphereBuilder = exports.AudioRegistry = exports.isAudioEvent = void 0;
+var events_1 = require("./events");
+Object.defineProperty(exports, "isAudioEvent", { enumerable: true, get: function () { return events_1.isAudioEvent; } });
+// Side-effect import: activates declaration merging for audio event keys
+require("./registry-merge");
+var audio_registry_1 = require("./audio-registry");
+Object.defineProperty(exports, "AudioRegistry", { enumerable: true, get: function () { return audio_registry_1.AudioRegistry; } });
+Object.defineProperty(exports, "AtmosphereBuilder", { enumerable: true, get: function () { return audio_registry_1.AtmosphereBuilder; } });
+//# sourceMappingURL=index.js.map

package/audio/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/media/src/audio/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AA+BH,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AAmBrB,yEAAyE;AACzE,4BAA0B;AAU1B,mDAAoE;AAA3D,+GAAA,aAAa,OAAA;AAAE,mHAAA,iBAAiB,OAAA"}

package/audio/registry-merge.d.ts

@@ -0,0 +1,81 @@
+/**
+ * EventDataRegistry declaration merging for audio events.
+ *
+ * Public interface: Nine *Data interfaces and the declaration merging
+ * block that extends @sharpee/core's EventDataRegistry with audio event
+ * keys. Importing this module (or any re-export of it) activates
+ * compile-time type checking for createTypedEvent('audio.*', ...).
+ *
+ * Owner context: @sharpee/media (ADR-138)
+ */
+import type { AudioAssetPath, Volume, DurationMs, StereoPan, PlaybackRate, AmbientChannel, DuckPriority, AudioTarget, AudioEffectType, ProceduralRecipeName } from './types';
+/** Data for audio.sfx events */
+export interface AudioSfxData {
+    readonly src: AudioAssetPath;
+    readonly volume?: Volume;
+    readonly rate?: PlaybackRate;
+    readonly pan?: StereoPan;
+    readonly duck?: DuckPriority;
+}
+/** Data for audio.music.play events */
+export interface AudioMusicPlayData {
+    readonly src: AudioAssetPath;
+    readonly volume?: Volume;
+    readonly fadeIn?: DurationMs;
+    readonly loop?: boolean;
+}
+/** Data for audio.music.stop events */
+export interface AudioMusicStopData {
+    readonly fadeOut?: DurationMs;
+}
+/** Data for audio.ambient.play events */
+export interface AudioAmbientPlayData {
+    readonly src: AudioAssetPath;
+    readonly channel: AmbientChannel;
+    readonly volume?: Volume;
+    readonly fadeIn?: DurationMs;
+    readonly loop?: boolean;
+}
+/** Data for audio.ambient.stop events */
+export interface AudioAmbientStopData {
+    readonly channel: AmbientChannel;
+    readonly fadeOut?: DurationMs;
+}
+/** Data for audio.ambient.stop_all events */
+export interface AudioAmbientStopAllData {
+    readonly fadeOut?: DurationMs;
+}
+/** Data for audio.procedural events */
+export interface AudioProceduralData {
+    readonly recipe: ProceduralRecipeName;
+    readonly params?: Readonly<Record<string, number>>;
+    readonly volume?: Volume;
+    readonly duration?: DurationMs;
+    readonly duck?: DuckPriority;
+}
+/** Data for audio.effect events */
+export interface AudioEffectData {
+    readonly target: AudioTarget;
+    readonly effect: AudioEffectType;
+    readonly params: Readonly<Record<string, number>>;
+    readonly transition?: DurationMs;
+}
+/** Data for audio.effect.clear events */
+export interface AudioEffectClearData {
+    readonly target: AudioTarget;
+    readonly transition?: DurationMs;
+}
+declare module '@sharpee/core' {
+    interface EventDataRegistry {
+        'audio.sfx': AudioSfxData;
+        'audio.music.play': AudioMusicPlayData;
+        'audio.music.stop': AudioMusicStopData;
+        'audio.ambient.play': AudioAmbientPlayData;
+        'audio.ambient.stop': AudioAmbientStopData;
+        'audio.ambient.stop_all': AudioAmbientStopAllData;
+        'audio.procedural': AudioProceduralData;
+        'audio.effect': AudioEffectData;
+        'audio.effect.clear': AudioEffectClearData;
+    }
+}
+//# sourceMappingURL=registry-merge.d.ts.map

package/audio/registry-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-merge.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/media/src/audio/registry-merge.ts"],"names":[],"mappings":"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"}

package/audio/registry-merge.js

@@ -0,0 +1,13 @@
+"use strict";
+/**
+ * EventDataRegistry declaration merging for audio events.
+ *
+ * Public interface: Nine *Data interfaces and the declaration merging
+ * block that extends @sharpee/core's EventDataRegistry with audio event
+ * keys. Importing this module (or any re-export of it) activates
+ * compile-time type checking for createTypedEvent('audio.*', ...).
+ *
+ * Owner context: @sharpee/media (ADR-138)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=registry-merge.js.map

package/audio/registry-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-merge.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/media/src/audio/registry-merge.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}

package/audio/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Common audio primitive types for the Sharpee media subsystem.
+ *
+ * Public interface: Type aliases used throughout all audio event interfaces,
+ * the AudioRegistry, and capability negotiation.
+ *
+ * Owner context: @sharpee/media (ADR-138)
+ */
+/** Volume level: 0.0 (silent) to 1.0 (full) */
+export type Volume = number;
+/** Duration in milliseconds */
+export type DurationMs = number;
+/** Stereo pan: -1.0 (hard left) to 1.0 (hard right), 0.0 = center */
+export type StereoPan = number;
+/** Playback rate: 1.0 = normal, 0.5 = half speed, 2.0 = double speed */
+export type PlaybackRate = number;
+/** Asset path relative to the story's assets/audio/ directory */
+export type AudioAssetPath = string;
+/** Named ambient channel identifier (e.g., 'wind', 'machinery', 'dripping') */
+export type AmbientChannel = string;
+/** Ducking priority: 0 (none) to 3 (aggressive). See AudioSfxEvent.duck. */
+export type DuckPriority = 0 | 1 | 2 | 3;
+/**
+ * Audio mix target — identifies where an effect or volume change applies.
+ * - 'master': affects all audio output
+ * - 'sfx': affects all sound effects
+ * - 'music': affects the music track
+ * - 'ambient:{channel}': affects a specific ambient channel
+ */
+export type AudioTarget = 'master' | 'sfx' | 'music' | `ambient:${string}`;
+/** Effect types that map to Web Audio API nodes */
+export type AudioEffectType = 'reverb' | 'lowpass' | 'highpass' | 'distortion' | 'delay';
+/** Audio file formats */
+export type AudioFormat = 'mp3' | 'ogg' | 'wav' | 'aac' | 'opus' | 'webm';
+/**
+ * Built-in recipe names that clients SHOULD support.
+ * Stories may use any string — unknown recipes are silently skipped.
+ */
+export type BuiltinRecipeName = 'beep' | 'alert' | 'sweep-up' | 'sweep-down' | 'static' | 'hum';
+/** Recipe name: built-in or story-defined */
+export type ProceduralRecipeName = BuiltinRecipeName | (string & {});
+//# sourceMappingURL=types.d.ts.map

package/audio/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/media/src/audio/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,+CAA+C;AAC/C,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B,+BAA+B;AAC/B,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC,qEAAqE;AACrE,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,wEAAwE;AACxE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC,iEAAiE;AACjE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,+EAA+E;AAC/E,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,4EAA4E;AAC5E,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,WAAW,MAAM,EAAE,CAAC;AAE3E,mDAAmD;AACnD,MAAM,MAAM,eAAe,GACvB,QAAQ,GACR,SAAS,GACT,UAAU,GACV,YAAY,GACZ,OAAO,CAAC;AAEZ,yBAAyB;AACzB,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAE1E;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,OAAO,GACP,UAAU,GACV,YAAY,GACZ,QAAQ,GACR,KAAK,CAAC;AAEV,6CAA6C;AAC7C,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC"}

package/audio/types.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Common audio primitive types for the Sharpee media subsystem.
+ *
+ * Public interface: Type aliases used throughout all audio event interfaces,
+ * the AudioRegistry, and capability negotiation.
+ *
+ * Owner context: @sharpee/media (ADR-138)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/audio/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/media/src/audio/types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}

package/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @sharpee/media — Audio and media type definitions for the Sharpee IF platform.
+ *
+ * Public interface: Re-exports all audio types, event interfaces, registry,
+ * and capability/preference types from the audio module.
+ *
+ * Owner context: Media subsystem (ADR-138). Types-only package with no
+ * runtime dependencies beyond @sharpee/core.
+ *
+ * Importing this module activates TypeScript declaration merging for
+ * audio event keys in @sharpee/core's EventDataRegistry.
+ */
+export * from './audio';
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/media/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,cAAc,SAAS,CAAC"}

package/index.js

@@ -0,0 +1,30 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @sharpee/media — Audio and media type definitions for the Sharpee IF platform.
+ *
+ * Public interface: Re-exports all audio types, event interfaces, registry,
+ * and capability/preference types from the audio module.
+ *
+ * Owner context: Media subsystem (ADR-138). Types-only package with no
+ * runtime dependencies beyond @sharpee/core.
+ *
+ * Importing this module activates TypeScript declaration merging for
+ * audio event keys in @sharpee/core's EventDataRegistry.
+ */
+__exportStar(require("./audio"), exports);
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/media/src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;GAWG;AACH,0CAAwB"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@sharpee/media",
+  "version": "0.9.100",
+  "description": "Audio and media type definitions for Sharpee Interactive Fiction Platform",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "require": "./index.js",
+      "default": "./index.js"
+    }
+  },
+  "dependencies": {
+    "@sharpee/core": "^0.9.100"
+  },
+  "keywords": [
+    "interactive-fiction",
+    "if",
+    "text-adventure",
+    "sharpee",
+    "media",
+    "audio"
+  ],
+  "author": "Sharpee Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ChicagoDave/sharpee.git",
+    "directory": "packages/media"
+  },
+  "homepage": "https://github.com/ChicagoDave/sharpee#readme",
+  "bugs": {
+    "url": "https://github.com/ChicagoDave/sharpee/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}