@urk/adapters 0.1.0 → 0.1.2

package/README.md

@@ -4,6 +4,7 @@ Contract-first capability adapters that prove URK's v0 kernel surface.
 
 ## Reference adapters
 
+- `createAudioAdapter()` - manage browser-native audio transport across a small set of registered tracks
 - `createPointerAdapter()` - bind DOM targets or pointer surfaces and emit normalized pointer events
 - `createInputAdapter()` - normalize keyboard input, track pressed keys, and bind simple key handlers
 - `createStorageAdapter()` - provide namespaced local/session key-value persistence with swappable backends
@@ -16,6 +17,7 @@ Contract-first capability adapters that prove URK's v0 kernel surface.
 ```ts
 import { createKernel } from '@urk/core';
 import {
+  createAudioAdapter,
   createInputAdapter,
   createPointerAdapter,
   createStorageAdapter,
@@ -29,6 +31,7 @@ const kernel = createKernel({
     'ui:host': document.querySelector('#overlay-host'),
   },
   adapters: [
+    createAudioAdapter(),
     createPointerAdapter(),
     createInputAdapter(),
     createStorageAdapter({ namespace: 'demo' }),
@@ -42,6 +45,14 @@ await kernel.boot();
 
 These adapters use the canonical `AdapterRegistration<TApi>` contract from `@urk/core`. They are intentionally small and exist to prove the kernel surface, not to introduce a broad adapter matrix early.
 
+`createAudioAdapter()` is deliberately transport-first in this milestone:
+
+- register a small set of browser-native media tracks
+- preload them into `HTMLAudioElement` instances
+- control playback through `play`, `pause`, `stop`, `setMuted`, and `setVolume`
+- expose one observable transport snapshot plus `audio:changed`, `audio:ended`, and `audio:error`
+- no Web Audio graph, spatial audio, playlist system, or mixer layer yet
+
 `createInputAdapter()` is deliberately keyboard-first in this milestone:
 
 - pressed-key tracking through `isPressed(code)`
@@ -73,7 +84,7 @@ These adapters use the canonical `AdapterRegistration<TApi>` contract from `@urk
 
 ## Validation
 
-This package is validated for this milestone through type-check/build plus the standalone DOM + Three picking proof in `@urk/examples`.
+This package is validated for this milestone through type-check/build plus the standalone browser proofs in `@urk/examples`, including the DOM-first audio transport proof.
 
 ## Architecture
 

package/dist/adapters.d.ts

@@ -1,11 +1,12 @@
 /**
  * URK adapter exports.
  */
-export * from './loading';
-export * from './input';
-export * from './pointer';
-export * from './storage';
-export * from './three';
-export * from './ui-widgets';
-export * from './contracts';
+export * from './loading.js';
+export * from './audio.js';
+export * from './input.js';
+export * from './pointer.js';
+export * from './storage.js';
+export * from './three.js';
+export * from './ui-widgets.js';
+export * from './contracts.js';
 //# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}

package/dist/adapters.js

@@ -1,11 +1,12 @@
 /**
  * URK adapter exports.
  */
-export * from './loading';
-export * from './input';
-export * from './pointer';
-export * from './storage';
-export * from './three';
-export * from './ui-widgets';
-export * from './contracts';
+export * from './loading.js';
+export * from './audio.js';
+export * from './input.js';
+export * from './pointer.js';
+export * from './storage.js';
+export * from './three.js';
+export * from './ui-widgets.js';
+export * from './contracts.js';
 //# sourceMappingURL=adapters.js.map

package/dist/adapters.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}

package/dist/audio.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Company: EonHive Inc.
+ * Title: Audio Adapter
+ * Purpose: Provide a small browser-native audio transport capability for URK.
+ * Author: Stan Nesi
+ * Created: 2026-04-23
+ * Updated: 2026-04-23
+ * Notes: Vibe coded with Codex.
+ */
+import type { AdapterRegistration } from '@urk/core';
+export interface AudioTrackDefinition {
+    id: string;
+    src: string;
+    label: string;
+    loop?: boolean;
+    volume?: number;
+}
+export type AudioPlaybackStatus = 'idle' | 'loading' | 'ready' | 'playing' | 'paused' | 'error';
+export interface AudioTransportSnapshot {
+    activeTrackId: string | null;
+    status: AudioPlaybackStatus;
+    muted: boolean;
+    volume: number;
+    loadedTrackIds: string[];
+    errorMessage?: string;
+}
+export type AudioListener = (snapshot: AudioTransportSnapshot) => void;
+export interface AudioAdapterApi {
+    registerTrack(track: AudioTrackDefinition): void;
+    preload(trackId: string): Promise<void>;
+    play(trackId?: string): Promise<void>;
+    pause(): void;
+    stop(): void;
+    setMuted(next: boolean): void;
+    setVolume(next: number): void;
+    getSnapshot(): AudioTransportSnapshot;
+    subscribe(listener: AudioListener): () => void;
+}
+export declare function createAudioAdapter(id?: string): AdapterRegistration<AudioAdapterApi>;
+//# sourceMappingURL=audio.d.ts.map

package/dist/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEhG,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,sBAAsB,KAAK,IAAI,CAAC;AAEvE,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACjD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,IAAI,sBAAsB,CAAC;IACtC,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI,CAAC;CAChD;AAkCD,wBAAgB,kBAAkB,CAChC,EAAE,SAAkB,GACnB,mBAAmB,CAAC,eAAe,CAAC,CA0XtC"}

package/dist/audio.js

@@ -0,0 +1,333 @@
+/**
+ * Company: EonHive Inc.
+ * Title: Audio Adapter
+ * Purpose: Provide a small browser-native audio transport capability for URK.
+ * Author: Stan Nesi
+ * Created: 2026-04-23
+ * Updated: 2026-04-23
+ * Notes: Vibe coded with Codex.
+ */
+function clampVolume(value) {
+    return Math.max(0, Math.min(value, 1));
+}
+function cloneSnapshot(snapshot) {
+    return {
+        ...snapshot,
+        loadedTrackIds: [...snapshot.loadedTrackIds],
+    };
+}
+function createEmptySnapshot() {
+    return {
+        activeTrackId: null,
+        status: 'idle',
+        muted: false,
+        volume: 1,
+        loadedTrackIds: [],
+    };
+}
+function formatTrackError(track, action) {
+    return `Failed ${action} for audio track: ${track.label}`;
+}
+export function createAudioAdapter(id = 'audio-adapter') {
+    let teardown = null;
+    return {
+        id,
+        capability: 'audio',
+        isSupported() {
+            return typeof window !== 'undefined' && typeof Audio !== 'undefined';
+        },
+        setup(ctx) {
+            const tracks = new Map();
+            const loadedTrackIds = new Set();
+            const listeners = new Set();
+            let snapshot = createEmptySnapshot();
+            const publish = (partial = {}, extraEvent) => {
+                snapshot = {
+                    ...snapshot,
+                    ...partial,
+                    loadedTrackIds: [...loadedTrackIds],
+                };
+                const next = cloneSnapshot(snapshot);
+                ctx.events.emit({
+                    type: 'audio:changed',
+                    source: id,
+                    payload: next,
+                    timestamp: Date.now(),
+                });
+                if (extraEvent) {
+                    ctx.events.emit({
+                        type: extraEvent.type,
+                        source: id,
+                        payload: extraEvent.payload,
+                        timestamp: Date.now(),
+                    });
+                }
+                for (const listener of [...listeners]) {
+                    listener(next);
+                }
+                return next;
+            };
+            const requireTrack = (trackId) => {
+                const record = tracks.get(trackId);
+                if (!record) {
+                    throw new Error(`Unknown audio track: ${trackId}`);
+                }
+                return record;
+            };
+            const applyElementSettings = (record) => {
+                record.element.loop = record.definition.loop ?? false;
+                record.element.muted = snapshot.muted;
+                record.element.volume = clampVolume(snapshot.volume * (record.definition.volume ?? 1));
+            };
+            const stopElement = (record) => {
+                record.element.pause();
+                try {
+                    record.element.currentTime = 0;
+                }
+                catch {
+                    // Some browsers can reject currentTime writes if metadata is unavailable.
+                }
+            };
+            const preloadElement = async (record) => {
+                if (loadedTrackIds.has(record.definition.id) || record.element.readyState >= 3) {
+                    loadedTrackIds.add(record.definition.id);
+                    return;
+                }
+                await new Promise((resolve, reject) => {
+                    const onReady = () => {
+                        cleanup();
+                        loadedTrackIds.add(record.definition.id);
+                        resolve();
+                    };
+                    const onError = () => {
+                        cleanup();
+                        reject(new Error(formatTrackError(record.definition, 'preload')));
+                    };
+                    const cleanup = () => {
+                        record.element.removeEventListener('canplaythrough', onReady);
+                        record.element.removeEventListener('loadeddata', onReady);
+                        record.element.removeEventListener('error', onError);
+                    };
+                    record.element.addEventListener('canplaythrough', onReady, { once: true });
+                    record.element.addEventListener('loadeddata', onReady, { once: true });
+                    record.element.addEventListener('error', onError, { once: true });
+                    record.element.load();
+                });
+            };
+            const preloadTrack = async (record, shouldSetLoading) => {
+                if (shouldSetLoading) {
+                    publish({
+                        status: 'loading',
+                        errorMessage: undefined,
+                    });
+                }
+                try {
+                    await preloadElement(record);
+                    publish({
+                        status: shouldSetLoading ? 'ready' : snapshot.status,
+                        errorMessage: undefined,
+                    });
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : formatTrackError(record.definition, 'preload');
+                    publish({
+                        status: 'error',
+                        errorMessage: message,
+                    }, {
+                        type: 'audio:error',
+                        payload: {
+                            trackId: record.definition.id,
+                            label: record.definition.label,
+                            message,
+                        },
+                    });
+                    throw new Error(message);
+                }
+            };
+            teardown = () => {
+                for (const record of tracks.values()) {
+                    record.element.pause();
+                    record.element.removeEventListener('ended', record.onEnded);
+                    record.element.removeEventListener('error', record.onError);
+                    record.element.src = '';
+                    record.element.load();
+                }
+                tracks.clear();
+                loadedTrackIds.clear();
+                listeners.clear();
+            };
+            return {
+                registerTrack(track) {
+                    if (tracks.has(track.id)) {
+                        throw new Error(`Audio track already registered: ${track.id}`);
+                    }
+                    const element = new Audio(track.src);
+                    element.preload = 'auto';
+                    const onEnded = () => {
+                        if (snapshot.activeTrackId !== track.id) {
+                            return;
+                        }
+                        publish({
+                            status: 'ready',
+                            errorMessage: undefined,
+                        }, {
+                            type: 'audio:ended',
+                            payload: {
+                                trackId: track.id,
+                                label: track.label,
+                            },
+                        });
+                    };
+                    const onError = () => {
+                        const message = formatTrackError(track, 'playback');
+                        if (snapshot.status === 'error' && snapshot.errorMessage === message) {
+                            return;
+                        }
+                        publish({
+                            activeTrackId: snapshot.activeTrackId ?? track.id,
+                            status: 'error',
+                            errorMessage: message,
+                        }, {
+                            type: 'audio:error',
+                            payload: {
+                                trackId: track.id,
+                                label: track.label,
+                                message,
+                            },
+                        });
+                    };
+                    const record = {
+                        definition: {
+                            ...track,
+                            volume: clampVolume(track.volume ?? 1),
+                        },
+                        element,
+                        onEnded,
+                        onError,
+                    };
+                    element.addEventListener('ended', onEnded);
+                    element.addEventListener('error', onError);
+                    applyElementSettings(record);
+                    tracks.set(track.id, record);
+                },
+                async preload(trackId) {
+                    const record = requireTrack(trackId);
+                    const shouldSetLoading = snapshot.status === 'idle' ||
+                        snapshot.status === 'loading' ||
+                        snapshot.status === 'ready';
+                    await preloadTrack(record, shouldSetLoading);
+                },
+                async play(trackId) {
+                    const nextTrackId = trackId ?? snapshot.activeTrackId;
+                    if (!nextTrackId) {
+                        return;
+                    }
+                    const nextRecord = requireTrack(nextTrackId);
+                    const previousTrackId = snapshot.activeTrackId;
+                    if (previousTrackId && previousTrackId !== nextTrackId) {
+                        stopElement(requireTrack(previousTrackId));
+                    }
+                    if (!loadedTrackIds.has(nextTrackId) && nextRecord.element.readyState < 3) {
+                        publish({
+                            activeTrackId: nextTrackId,
+                            status: 'loading',
+                            errorMessage: undefined,
+                        });
+                        await preloadTrack(nextRecord, false);
+                    }
+                    if (previousTrackId !== nextTrackId ||
+                        nextRecord.element.ended ||
+                        (nextRecord.element.duration > 0 &&
+                            nextRecord.element.currentTime >= nextRecord.element.duration)) {
+                        try {
+                            nextRecord.element.currentTime = 0;
+                        }
+                        catch {
+                            // Ignore currentTime reset failures for browsers without loaded metadata yet.
+                        }
+                    }
+                    applyElementSettings(nextRecord);
+                    try {
+                        await nextRecord.element.play();
+                        publish({
+                            activeTrackId: nextTrackId,
+                            status: 'playing',
+                            errorMessage: undefined,
+                        });
+                    }
+                    catch (error) {
+                        const message = error instanceof Error ? error.message : formatTrackError(nextRecord.definition, 'playback');
+                        publish({
+                            activeTrackId: nextTrackId,
+                            status: 'error',
+                            errorMessage: message,
+                        }, {
+                            type: 'audio:error',
+                            payload: {
+                                trackId: nextTrackId,
+                                label: nextRecord.definition.label,
+                                message,
+                            },
+                        });
+                        throw new Error(message);
+                    }
+                },
+                pause() {
+                    if (!snapshot.activeTrackId) {
+                        return;
+                    }
+                    const record = requireTrack(snapshot.activeTrackId);
+                    record.element.pause();
+                    publish({
+                        status: 'paused',
+                        errorMessage: undefined,
+                    });
+                },
+                stop() {
+                    if (!snapshot.activeTrackId) {
+                        return;
+                    }
+                    stopElement(requireTrack(snapshot.activeTrackId));
+                    publish({
+                        status: 'ready',
+                        errorMessage: undefined,
+                    });
+                },
+                setMuted(next) {
+                    const muted = Boolean(next);
+                    for (const record of tracks.values()) {
+                        record.element.muted = muted;
+                    }
+                    publish({
+                        muted,
+                        errorMessage: undefined,
+                    });
+                },
+                setVolume(next) {
+                    const volume = clampVolume(next);
+                    for (const record of tracks.values()) {
+                        record.element.volume = clampVolume(volume * (record.definition.volume ?? 1));
+                    }
+                    publish({
+                        volume,
+                        errorMessage: undefined,
+                    });
+                },
+                getSnapshot() {
+                    return cloneSnapshot(snapshot);
+                },
+                subscribe(listener) {
+                    listeners.add(listener);
+                    return () => {
+                        listeners.delete(listener);
+                    };
+                },
+            };
+        },
+        dispose() {
+            teardown?.();
+            teardown = null;
+        },
+    };
+}
+//# sourceMappingURL=audio.js.map

package/dist/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA4CH,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,aAAa,CAAC,QAAgC;IACrD,OAAO;QACL,GAAG,QAAQ;QACX,cAAc,EAAE,CAAC,GAAG,QAAQ,CAAC,cAAc,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB;IAC1B,OAAO;QACL,aAAa,EAAE,IAAI;QACnB,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,CAAC;QACT,cAAc,EAAE,EAAE;KACnB,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,KAA2B,EAAE,MAA8B;IACnF,OAAO,UAAU,MAAM,qBAAqB,KAAK,CAAC,KAAK,EAAE,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,EAAE,GAAG,eAAe;IAEpB,IAAI,QAAQ,GAAwB,IAAI,CAAC;IAEzC,OAAO;QACL,EAAE;QACF,UAAU,EAAE,OAAO;QACnB,WAAW;YACT,OAAO,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,KAAK,KAAK,WAAW,CAAC;QACvE,CAAC;QACD,KAAK,CAAC,GAAG;YACP,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;YAClD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;YACzC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAiB,CAAC;YAC3C,IAAI,QAAQ,GAAG,mBAAmB,EAAE,CAAC;YAErC,MAAM,OAAO,GAAG,CACd,UAA2C,EAAE,EAC7C,UAKa,EACW,EAAE;gBAC1B,QAAQ,GAAG;oBACT,GAAG,QAAQ;oBACX,GAAG,OAAO;oBACV,cAAc,EAAE,CAAC,GAAG,cAAc,CAAC;iBACpC,CAAC;gBAEF,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;gBAErC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,eAAe;oBACrB,MAAM,EAAE,EAAE;oBACV,OAAO,EAAE,IAAI;oBACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACtB,CAAC,CAAC;gBAEH,IAAI,UAAU,EAAE,CAAC;oBACf,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;wBACd,IAAI,EAAE,UAAU,CAAC,IAAI;wBACrB,MAAM,EAAE,EAAE;wBACV,OAAO,EAAE,UAAU,CAAC,OAAO;wBAC3B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;qBACtB,CAAC,CAAC;gBACL,CAAC;gBAED,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC;oBACtC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACjB,CAAC;gBAED,OAAO,IAAI,CAAC;YACd,CAAC,CAAC;YAEF,MAAM,YAAY,GAAG,CAAC,OAAe,EAAmB,EAAE;gBACxD,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAEnC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,MAAM,IAAI,KAAK,CAAC,wBAAwB,OAAO,EAAE,CAAC,CAAC;gBACrD,CAAC;gBAED,OAAO,MAAM,CAAC;YAChB,CAAC,CAAC;YAEF,MAAM,oBAAoB,GAAG,CAAC,MAAuB,EAAQ,EAAE;gBAC7D,MAAM,CAAC,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,KAAK,CAAC;gBACtD,MAAM,CAAC,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;gBACtC,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;YACzF,CAAC,CAAC;YAEF,MAAM,WAAW,GAAG,CAAC,MAAuB,EAAQ,EAAE;gBACpD,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBAEvB,IAAI,CAAC;oBACH,MAAM,CAAC,OAAO,CAAC,WAAW,GAAG,CAAC,CAAC;gBACjC,CAAC;gBAAC,MAAM,CAAC;oBACP,0EAA0E;gBAC5E,CAAC;YACH,CAAC,CAAC;YAEF,MAAM,cAAc,GAAG,KAAK,EAAE,MAAuB,EAAiB,EAAE;gBACtE,IAAI,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,EAAE,CAAC;oBAC/E,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;oBACzC,OAAO;gBACT,CAAC;gBAED,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;oBAC1C,MAAM,OAAO,GAAG,GAAS,EAAE;wBACzB,OAAO,EAAE,CAAC;wBACV,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;wBACzC,OAAO,EAAE,CAAC;oBACZ,CAAC,CAAC;oBAEF,MAAM,OAAO,GAAG,GAAS,EAAE;wBACzB,OAAO,EAAE,CAAC;wBACV,MAAM,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;oBACpE,CAAC,CAAC;oBAEF,MAAM,OAAO,GAAG,GAAS,EAAE;wBACzB,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;wBAC9D,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;wBAC1D,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBACvD,CAAC,CAAC;oBAEF,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,gBAAgB,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC3E,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;oBACvE,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;oBAClE,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBACxB,CAAC,CAAC,CAAC;YACL,CAAC,CAAC;YAEF,MAAM,YAAY,GAAG,KAAK,EACxB,MAAuB,EACvB,gBAAyB,EACV,EAAE;gBACjB,IAAI,gBAAgB,EAAE,CAAC;oBACrB,OAAO,CAAC;wBACN,MAAM,EAAE,SAAS;wBACjB,YAAY,EAAE,SAAS;qBACxB,CAAC,CAAC;gBACL,CAAC;gBAED,IAAI,CAAC;oBACH,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;oBAC7B,OAAO,CAAC;wBACN,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM;wBACpD,YAAY,EAAE,SAAS;qBACxB,CAAC,CAAC;gBACL,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;oBAE1F,OAAO,CACL;wBACE,MAAM,EAAE,OAAO;wBACf,YAAY,EAAE,OAAO;qBACtB,EACD;wBACE,IAAI,EAAE,aAAa;wBACnB,OAAO,EAAE;4BACP,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,EAAE;4BAC7B,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK;4BAC9B,OAAO;yBACR;qBACF,CACF,CAAC;oBAEF,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC3B,CAAC;YACH,CAAC,CAAC;YAEF,QAAQ,GAAG,GAAS,EAAE;gBACpB,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;oBACrC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;oBACvB,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;oBAC5D,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;oBAC5D,MAAM,CAAC,OAAO,CAAC,GAAG,GAAG,EAAE,CAAC;oBACxB,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBACxB,CAAC;gBAED,MAAM,CAAC,KAAK,EAAE,CAAC;gBACf,cAAc,CAAC,KAAK,EAAE,CAAC;gBACvB,SAAS,CAAC,KAAK,EAAE,CAAC;YACpB,CAAC,CAAC;YAEF,OAAO;gBACL,aAAa,CAAC,KAAK;oBACjB,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;wBACzB,MAAM,IAAI,KAAK,CAAC,mCAAmC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;oBACjE,CAAC;oBAED,MAAM,OAAO,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBACrC,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC;oBAEzB,MAAM,OAAO,GAAG,GAAS,EAAE;wBACzB,IAAI,QAAQ,CAAC,aAAa,KAAK,KAAK,CAAC,EAAE,EAAE,CAAC;4BACxC,OAAO;wBACT,CAAC;wBAED,OAAO,CACL;4BACE,MAAM,EAAE,OAAO;4BACf,YAAY,EAAE,SAAS;yBACxB,EACD;4BACE,IAAI,EAAE,aAAa;4BACnB,OAAO,EAAE;gCACP,OAAO,EAAE,KAAK,CAAC,EAAE;gCACjB,KAAK,EAAE,KAAK,CAAC,KAAK;6BACnB;yBACF,CACF,CAAC;oBACJ,CAAC,CAAC;oBAEF,MAAM,OAAO,GAAG,GAAS,EAAE;wBACzB,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;wBAEpD,IAAI,QAAQ,CAAC,MAAM,KAAK,OAAO,IAAI,QAAQ,CAAC,YAAY,KAAK,OAAO,EAAE,CAAC;4BACrE,OAAO;wBACT,CAAC;wBAED,OAAO,CACL;4BACE,aAAa,EAAE,QAAQ,CAAC,aAAa,IAAI,KAAK,CAAC,EAAE;4BACjD,MAAM,EAAE,OAAO;4BACf,YAAY,EAAE,OAAO;yBACtB,EACD;4BACE,IAAI,EAAE,aAAa;4BACnB,OAAO,EAAE;gCACP,OAAO,EAAE,KAAK,CAAC,EAAE;gCACjB,KAAK,EAAE,KAAK,CAAC,KAAK;gCAClB,OAAO;6BACR;yBACF,CACF,CAAC;oBACJ,CAAC,CAAC;oBAEF,MAAM,MAAM,GAAoB;wBAC9B,UAAU,EAAE;4BACV,GAAG,KAAK;4BACR,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;yBACvC;wBACD,OAAO;wBACP,OAAO;wBACP,OAAO;qBACR,CAAC;oBAEF,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBAC3C,OAAO,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;oBAC3C,oBAAoB,CAAC,MAAM,CAAC,CAAC;oBAC7B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;gBAC/B,CAAC;gBACD,KAAK,CAAC,OAAO,CAAC,OAAO;oBACnB,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;oBACrC,MAAM,gBAAgB,GACpB,QAAQ,CAAC,MAAM,KAAK,MAAM;wBAC1B,QAAQ,CAAC,MAAM,KAAK,SAAS;wBAC7B,QAAQ,CAAC,MAAM,KAAK,OAAO,CAAC;oBAE9B,MAAM,YAAY,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;gBAC/C,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,OAAO;oBAChB,MAAM,WAAW,GAAG,OAAO,IAAI,QAAQ,CAAC,aAAa,CAAC;oBAEtD,IAAI,CAAC,WAAW,EAAE,CAAC;wBACjB,OAAO;oBACT,CAAC;oBAED,MAAM,UAAU,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;oBAC7C,MAAM,eAAe,GAAG,QAAQ,CAAC,aAAa,CAAC;oBAE/C,IAAI,eAAe,IAAI,eAAe,KAAK,WAAW,EAAE,CAAC;wBACvD,WAAW,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC;oBAC7C,CAAC;oBAED,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;wBAC1E,OAAO,CAAC;4BACN,aAAa,EAAE,WAAW;4BAC1B,MAAM,EAAE,SAAS;4BACjB,YAAY,EAAE,SAAS;yBACxB,CAAC,CAAC;wBAEH,MAAM,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;oBACxC,CAAC;oBAED,IACE,eAAe,KAAK,WAAW;wBAC/B,UAAU,CAAC,OAAO,CAAC,KAAK;wBACxB,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,GAAG,CAAC;4BAC9B,UAAU,CAAC,OAAO,CAAC,WAAW,IAAI,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,EAChE,CAAC;wBACD,IAAI,CAAC;4BACH,UAAU,CAAC,OAAO,CAAC,WAAW,GAAG,CAAC,CAAC;wBACrC,CAAC;wBAAC,MAAM,CAAC;4BACP,8EAA8E;wBAChF,CAAC;oBACH,CAAC;oBAED,oBAAoB,CAAC,UAAU,CAAC,CAAC;oBAEjC,IAAI,CAAC;wBACH,MAAM,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;wBAChC,OAAO,CAAC;4BACN,aAAa,EAAE,WAAW;4BAC1B,MAAM,EAAE,SAAS;4BACjB,YAAY,EAAE,SAAS;yBACxB,CAAC,CAAC;oBACL,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;wBAE/F,OAAO,CACL;4BACE,aAAa,EAAE,WAAW;4BAC1B,MAAM,EAAE,OAAO;4BACf,YAAY,EAAE,OAAO;yBACtB,EACD;4BACE,IAAI,EAAE,aAAa;4BACnB,OAAO,EAAE;gCACP,OAAO,EAAE,WAAW;gCACpB,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK;gCAClC,OAAO;6BACR;yBACF,CACF,CAAC;wBAEF,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;oBAC3B,CAAC;gBACH,CAAC;gBACD,KAAK;oBACH,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;wBAC5B,OAAO;oBACT,CAAC;oBAED,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;oBACpD,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;oBAEvB,OAAO,CAAC;wBACN,MAAM,EAAE,QAAQ;wBAChB,YAAY,EAAE,SAAS;qBACxB,CAAC,CAAC;gBACL,CAAC;gBACD,IAAI;oBACF,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;wBAC5B,OAAO;oBACT,CAAC;oBAED,WAAW,CAAC,YAAY,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC;oBAElD,OAAO,CAAC;wBACN,MAAM,EAAE,OAAO;wBACf,YAAY,EAAE,SAAS;qBACxB,CAAC,CAAC;gBACL,CAAC;gBACD,QAAQ,CAAC,IAAI;oBACX,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;oBAE5B,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;wBACrC,MAAM,CAAC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;oBAC/B,CAAC;oBAED,OAAO,CAAC;wBACN,KAAK;wBACL,YAAY,EAAE,SAAS;qBACxB,CAAC,CAAC;gBACL,CAAC;gBACD,SAAS,CAAC,IAAI;oBACZ,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;oBAEjC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;wBACrC,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;oBAChF,CAAC;oBAED,OAAO,CAAC;wBACN,MAAM;wBACN,YAAY,EAAE,SAAS;qBACxB,CAAC,CAAC;gBACL,CAAC;gBACD,WAAW;oBACT,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;gBACjC,CAAC;gBACD,SAAS,CAAC,QAAQ;oBAChB,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBAExB,OAAO,GAAG,EAAE;wBACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;oBAC7B,CAAC,CAAC;gBACJ,CAAC;aACF,CAAC;QACJ,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,EAAE,CAAC;YACb,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/dom.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Company: EonHive Inc.
+ * Title: DOM Adapter Exports
+ * Purpose: Provide a dependency-light adapter surface for DOM-only URK consumers.
+ * Author: Stan Nesi
+ * Created: 2026-04-23
+ * Updated: 2026-04-23
+ * Notes: Vibe coded with Codex.
+ */
+export * from './loading.js';
+export * from './input.js';
+export * from './pointer.js';
+export * from './storage.js';
+export * from './ui-widgets.js';
+export * from './contracts.js';
+//# sourceMappingURL=dom.d.ts.map

package/dist/dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}

package/dist/dom.js

@@ -0,0 +1,16 @@
+/**
+ * Company: EonHive Inc.
+ * Title: DOM Adapter Exports
+ * Purpose: Provide a dependency-light adapter surface for DOM-only URK consumers.
+ * Author: Stan Nesi
+ * Created: 2026-04-23
+ * Updated: 2026-04-23
+ * Notes: Vibe coded with Codex.
+ */
+export * from './loading.js';
+export * from './input.js';
+export * from './pointer.js';
+export * from './storage.js';
+export * from './ui-widgets.js';
+export * from './contracts.js';
+//# sourceMappingURL=dom.js.map

package/dist/dom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.js","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /**
  * URK Adapters - Contract-first capability adapters.
  */
-export * from './adapters';
+export * from './adapters.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 /**
  * URK Adapters - Contract-first capability adapters.
  */
-export * from './adapters';
+export * from './adapters.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,eAAe,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@urk/adapters",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "URK adapters - reference three, pointer, input, loading, storage, and overlay capability adapters",
   "type": "module",
   "main": "./dist/index.js",
@@ -10,6 +10,10 @@
     ".": {
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
+    },
+    "./dom": {
+      "import": "./dist/dom.js",
+      "types": "./dist/dom.d.ts"
     }
   },
   "files": [
@@ -23,12 +27,17 @@
     "lint": "echo 'no lint yet'"
   },
   "peerDependencies": {
-    "@urk/core": "workspace:*",
+    "@urk/core": "^0.1.1",
     "three": "^0.184.0"
   },
+  "peerDependenciesMeta": {
+    "three": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/three": "^0.184.0",
-    "@urk/core": "workspace:*",
+    "@urk/core": "^0.1.1",
     "three": "^0.184.0",
     "typescript": "^5.3.0"
   }

package/src/adapters.ts

@@ -2,10 +2,11 @@
  * URK adapter exports.
  */
 
-export * from './loading';
-export * from './input';
-export * from './pointer';
-export * from './storage';
-export * from './three';
-export * from './ui-widgets';
-export * from './contracts';
+export * from './loading.js';
+export * from './audio.js';
+export * from './input.js';
+export * from './pointer.js';
+export * from './storage.js';
+export * from './three.js';
+export * from './ui-widgets.js';
+export * from './contracts.js';

package/src/audio.ts

@@ -0,0 +1,458 @@
+/**
+ * Company: EonHive Inc.
+ * Title: Audio Adapter
+ * Purpose: Provide a small browser-native audio transport capability for URK.
+ * Author: Stan Nesi
+ * Created: 2026-04-23
+ * Updated: 2026-04-23
+ * Notes: Vibe coded with Codex.
+ */
+
+import type { AdapterRegistration } from '@urk/core';
+
+export interface AudioTrackDefinition {
+  id: string;
+  src: string;
+  label: string;
+  loop?: boolean;
+  volume?: number;
+}
+
+export type AudioPlaybackStatus = 'idle' | 'loading' | 'ready' | 'playing' | 'paused' | 'error';
+
+export interface AudioTransportSnapshot {
+  activeTrackId: string | null;
+  status: AudioPlaybackStatus;
+  muted: boolean;
+  volume: number;
+  loadedTrackIds: string[];
+  errorMessage?: string;
+}
+
+export type AudioListener = (snapshot: AudioTransportSnapshot) => void;
+
+export interface AudioAdapterApi {
+  registerTrack(track: AudioTrackDefinition): void;
+  preload(trackId: string): Promise<void>;
+  play(trackId?: string): Promise<void>;
+  pause(): void;
+  stop(): void;
+  setMuted(next: boolean): void;
+  setVolume(next: number): void;
+  getSnapshot(): AudioTransportSnapshot;
+  subscribe(listener: AudioListener): () => void;
+}
+
+type RegisteredTrack = {
+  definition: AudioTrackDefinition;
+  element: HTMLAudioElement;
+  onEnded: () => void;
+  onError: () => void;
+};
+
+function clampVolume(value: number): number {
+  return Math.max(0, Math.min(value, 1));
+}
+
+function cloneSnapshot(snapshot: AudioTransportSnapshot): AudioTransportSnapshot {
+  return {
+    ...snapshot,
+    loadedTrackIds: [...snapshot.loadedTrackIds],
+  };
+}
+
+function createEmptySnapshot(): AudioTransportSnapshot {
+  return {
+    activeTrackId: null,
+    status: 'idle',
+    muted: false,
+    volume: 1,
+    loadedTrackIds: [],
+  };
+}
+
+function formatTrackError(track: AudioTrackDefinition, action: 'preload' | 'playback'): string {
+  return `Failed ${action} for audio track: ${track.label}`;
+}
+
+export function createAudioAdapter(
+  id = 'audio-adapter',
+): AdapterRegistration<AudioAdapterApi> {
+  let teardown: (() => void) | null = null;
+
+  return {
+    id,
+    capability: 'audio',
+    isSupported() {
+      return typeof window !== 'undefined' && typeof Audio !== 'undefined';
+    },
+    setup(ctx) {
+      const tracks = new Map<string, RegisteredTrack>();
+      const loadedTrackIds = new Set<string>();
+      const listeners = new Set<AudioListener>();
+      let snapshot = createEmptySnapshot();
+
+      const publish = (
+        partial: Partial<AudioTransportSnapshot> = {},
+        extraEvent?:
+          | {
+              type: 'audio:ended' | 'audio:error';
+              payload: unknown;
+            }
+          | undefined,
+      ): AudioTransportSnapshot => {
+        snapshot = {
+          ...snapshot,
+          ...partial,
+          loadedTrackIds: [...loadedTrackIds],
+        };
+
+        const next = cloneSnapshot(snapshot);
+
+        ctx.events.emit({
+          type: 'audio:changed',
+          source: id,
+          payload: next,
+          timestamp: Date.now(),
+        });
+
+        if (extraEvent) {
+          ctx.events.emit({
+            type: extraEvent.type,
+            source: id,
+            payload: extraEvent.payload,
+            timestamp: Date.now(),
+          });
+        }
+
+        for (const listener of [...listeners]) {
+          listener(next);
+        }
+
+        return next;
+      };
+
+      const requireTrack = (trackId: string): RegisteredTrack => {
+        const record = tracks.get(trackId);
+
+        if (!record) {
+          throw new Error(`Unknown audio track: ${trackId}`);
+        }
+
+        return record;
+      };
+
+      const applyElementSettings = (record: RegisteredTrack): void => {
+        record.element.loop = record.definition.loop ?? false;
+        record.element.muted = snapshot.muted;
+        record.element.volume = clampVolume(snapshot.volume * (record.definition.volume ?? 1));
+      };
+
+      const stopElement = (record: RegisteredTrack): void => {
+        record.element.pause();
+
+        try {
+          record.element.currentTime = 0;
+        } catch {
+          // Some browsers can reject currentTime writes if metadata is unavailable.
+        }
+      };
+
+      const preloadElement = async (record: RegisteredTrack): Promise<void> => {
+        if (loadedTrackIds.has(record.definition.id) || record.element.readyState >= 3) {
+          loadedTrackIds.add(record.definition.id);
+          return;
+        }
+
+        await new Promise<void>((resolve, reject) => {
+          const onReady = (): void => {
+            cleanup();
+            loadedTrackIds.add(record.definition.id);
+            resolve();
+          };
+
+          const onError = (): void => {
+            cleanup();
+            reject(new Error(formatTrackError(record.definition, 'preload')));
+          };
+
+          const cleanup = (): void => {
+            record.element.removeEventListener('canplaythrough', onReady);
+            record.element.removeEventListener('loadeddata', onReady);
+            record.element.removeEventListener('error', onError);
+          };
+
+          record.element.addEventListener('canplaythrough', onReady, { once: true });
+          record.element.addEventListener('loadeddata', onReady, { once: true });
+          record.element.addEventListener('error', onError, { once: true });
+          record.element.load();
+        });
+      };
+
+      const preloadTrack = async (
+        record: RegisteredTrack,
+        shouldSetLoading: boolean,
+      ): Promise<void> => {
+        if (shouldSetLoading) {
+          publish({
+            status: 'loading',
+            errorMessage: undefined,
+          });
+        }
+
+        try {
+          await preloadElement(record);
+          publish({
+            status: shouldSetLoading ? 'ready' : snapshot.status,
+            errorMessage: undefined,
+          });
+        } catch (error) {
+          const message =
+            error instanceof Error ? error.message : formatTrackError(record.definition, 'preload');
+
+          publish(
+            {
+              status: 'error',
+              errorMessage: message,
+            },
+            {
+              type: 'audio:error',
+              payload: {
+                trackId: record.definition.id,
+                label: record.definition.label,
+                message,
+              },
+            },
+          );
+
+          throw new Error(message);
+        }
+      };
+
+      teardown = (): void => {
+        for (const record of tracks.values()) {
+          record.element.pause();
+          record.element.removeEventListener('ended', record.onEnded);
+          record.element.removeEventListener('error', record.onError);
+          record.element.src = '';
+          record.element.load();
+        }
+
+        tracks.clear();
+        loadedTrackIds.clear();
+        listeners.clear();
+      };
+
+      return {
+        registerTrack(track) {
+          if (tracks.has(track.id)) {
+            throw new Error(`Audio track already registered: ${track.id}`);
+          }
+
+          const element = new Audio(track.src);
+          element.preload = 'auto';
+
+          const onEnded = (): void => {
+            if (snapshot.activeTrackId !== track.id) {
+              return;
+            }
+
+            publish(
+              {
+                status: 'ready',
+                errorMessage: undefined,
+              },
+              {
+                type: 'audio:ended',
+                payload: {
+                  trackId: track.id,
+                  label: track.label,
+                },
+              },
+            );
+          };
+
+          const onError = (): void => {
+            const message = formatTrackError(track, 'playback');
+
+            if (snapshot.status === 'error' && snapshot.errorMessage === message) {
+              return;
+            }
+
+            publish(
+              {
+                activeTrackId: snapshot.activeTrackId ?? track.id,
+                status: 'error',
+                errorMessage: message,
+              },
+              {
+                type: 'audio:error',
+                payload: {
+                  trackId: track.id,
+                  label: track.label,
+                  message,
+                },
+              },
+            );
+          };
+
+          const record: RegisteredTrack = {
+            definition: {
+              ...track,
+              volume: clampVolume(track.volume ?? 1),
+            },
+            element,
+            onEnded,
+            onError,
+          };
+
+          element.addEventListener('ended', onEnded);
+          element.addEventListener('error', onError);
+          applyElementSettings(record);
+          tracks.set(track.id, record);
+        },
+        async preload(trackId) {
+          const record = requireTrack(trackId);
+          const shouldSetLoading =
+            snapshot.status === 'idle' ||
+            snapshot.status === 'loading' ||
+            snapshot.status === 'ready';
+
+          await preloadTrack(record, shouldSetLoading);
+        },
+        async play(trackId) {
+          const nextTrackId = trackId ?? snapshot.activeTrackId;
+
+          if (!nextTrackId) {
+            return;
+          }
+
+          const nextRecord = requireTrack(nextTrackId);
+          const previousTrackId = snapshot.activeTrackId;
+
+          if (previousTrackId && previousTrackId !== nextTrackId) {
+            stopElement(requireTrack(previousTrackId));
+          }
+
+          if (!loadedTrackIds.has(nextTrackId) && nextRecord.element.readyState < 3) {
+            publish({
+              activeTrackId: nextTrackId,
+              status: 'loading',
+              errorMessage: undefined,
+            });
+
+            await preloadTrack(nextRecord, false);
+          }
+
+          if (
+            previousTrackId !== nextTrackId ||
+            nextRecord.element.ended ||
+            (nextRecord.element.duration > 0 &&
+              nextRecord.element.currentTime >= nextRecord.element.duration)
+          ) {
+            try {
+              nextRecord.element.currentTime = 0;
+            } catch {
+              // Ignore currentTime reset failures for browsers without loaded metadata yet.
+            }
+          }
+
+          applyElementSettings(nextRecord);
+
+          try {
+            await nextRecord.element.play();
+            publish({
+              activeTrackId: nextTrackId,
+              status: 'playing',
+              errorMessage: undefined,
+            });
+          } catch (error) {
+            const message =
+              error instanceof Error ? error.message : formatTrackError(nextRecord.definition, 'playback');
+
+            publish(
+              {
+                activeTrackId: nextTrackId,
+                status: 'error',
+                errorMessage: message,
+              },
+              {
+                type: 'audio:error',
+                payload: {
+                  trackId: nextTrackId,
+                  label: nextRecord.definition.label,
+                  message,
+                },
+              },
+            );
+
+            throw new Error(message);
+          }
+        },
+        pause() {
+          if (!snapshot.activeTrackId) {
+            return;
+          }
+
+          const record = requireTrack(snapshot.activeTrackId);
+          record.element.pause();
+
+          publish({
+            status: 'paused',
+            errorMessage: undefined,
+          });
+        },
+        stop() {
+          if (!snapshot.activeTrackId) {
+            return;
+          }
+
+          stopElement(requireTrack(snapshot.activeTrackId));
+
+          publish({
+            status: 'ready',
+            errorMessage: undefined,
+          });
+        },
+        setMuted(next) {
+          const muted = Boolean(next);
+
+          for (const record of tracks.values()) {
+            record.element.muted = muted;
+          }
+
+          publish({
+            muted,
+            errorMessage: undefined,
+          });
+        },
+        setVolume(next) {
+          const volume = clampVolume(next);
+
+          for (const record of tracks.values()) {
+            record.element.volume = clampVolume(volume * (record.definition.volume ?? 1));
+          }
+
+          publish({
+            volume,
+            errorMessage: undefined,
+          });
+        },
+        getSnapshot() {
+          return cloneSnapshot(snapshot);
+        },
+        subscribe(listener) {
+          listeners.add(listener);
+
+          return () => {
+            listeners.delete(listener);
+          };
+        },
+      };
+    },
+    dispose() {
+      teardown?.();
+      teardown = null;
+    },
+  };
+}

package/src/dom.ts

@@ -0,0 +1,16 @@
+/**
+ * Company: EonHive Inc.
+ * Title: DOM Adapter Exports
+ * Purpose: Provide a dependency-light adapter surface for DOM-only URK consumers.
+ * Author: Stan Nesi
+ * Created: 2026-04-23
+ * Updated: 2026-04-23
+ * Notes: Vibe coded with Codex.
+ */
+
+export * from './loading.js';
+export * from './input.js';
+export * from './pointer.js';
+export * from './storage.js';
+export * from './ui-widgets.js';
+export * from './contracts.js';

package/src/index.ts

@@ -2,4 +2,4 @@
  * URK Adapters - Contract-first capability adapters.
  */
 
-export * from './adapters';
+export * from './adapters.js';