@rafaelaugusto/jolt 0.1.0-rc.11.1 → 0.1.0-rc.12

package/README.md

@@ -31,7 +31,7 @@ NativeScript's `view.animate()` covers the basics and stops there: one curve for
 
 Jolt computes the motion once, in JavaScript, when the animation starts, and hands it to the platform as keyframes: Core Animation on iOS, `ObjectAnimator` on Android. Those default view tracks play without per-frame JavaScript. Real-size layout, opt-in subscribers, gesture input and timeline step activation retain their documented [execution limits](https://jolt.rafaelaugusto.dev/guide/how-it-works). Springs follow real physics, and an animation that interrupts another one starts from where the view is, at the speed it was going.
 
-The [0.1.0-rc.11.1 release candidate](https://github.com/rafaelaugustos/jolt/blob/v0.1.0-rc.11.1/CHANGELOG.md) adds retained native resources and Vue drawing ownership, behavior priorities and interruption, articulated 2D parts, gradient text with moving light, and named timeline effects. [Native composition](https://jolt.rafaelaugusto.dev/guide/native-composition) documents the APIs and platform limits with real recordings. Install `@rafaelaugusto/jolt@0.1.0-rc.11.1` and rebuild native apps; external native properties also need matching `@rafaelaugusto/jolt-native@0.1.0-rc.11.1`. Web APIs remain experimental and [stable-release acceptance](https://jolt.rafaelaugusto.dev/guide/not-there-yet) continues.
+The [0.1.0-rc.12 release candidate](https://github.com/rafaelaugustos/jolt/blob/v0.1.0-rc.12/CHANGELOG.md) adds native/Web pointer presence, property groups, renderer activity, bounded drawing, drop targets, optional audio/cues and inspection, plus Web paths, 3D rotation and shadows. The versioned [portable foundations](https://github.com/rafaelaugustos/jolt/blob/v0.1.0-rc.12/docs/guide/portable-foundations.md) and [interaction/depth guides](https://github.com/rafaelaugustos/jolt/blob/v0.1.0-rc.12/docs/guide/interaction-depth.md) include reviewed recordings and platform limits. Install `@rafaelaugusto/jolt@0.1.0-rc.12` and rebuild native apps; external native properties also need matching `@rafaelaugusto/jolt-native@0.1.0-rc.12`. Web APIs remain experimental; physical-device acceptance and performance investigations remain open.
 
 For the browser, import **`@rafaelaugusto/jolt/web`**. It installs without NativeScript, Vue or React; **`@rafaelaugusto/jolt/web/vue`** optionally integrates Vue 3.5 DOM refs and enter/leave. Both entries are experimental and use the same motion compiler as native playback. See [installation](https://jolt.rafaelaugusto.dev/guide/install#experimental-web-candidate), [finite Web playback](https://jolt.rafaelaugusto.dev/guide/web-runtime) and [Vue Web motion](https://jolt.rafaelaugusto.dev/guide/web-vue). Mavis integration and its shared application proof continue separately.
 
@@ -101,7 +101,7 @@ For the browser, import **`@rafaelaugusto/jolt/web`**. It installs without Nativ
 npm install @rafaelaugusto/jolt@next
 ```
 
-The current release candidate is **0.1.0-rc.11.1**, published under the `next` tag. Requires `@nativescript/core` 8.9 or later. It doesn't depend on a framework: it takes a view, or an element that holds one. Rebuild the native app after installing or upgrading Jolt. See [release status and limits](https://jolt.rafaelaugusto.dev/guide/not-there-yet) for the remaining stable-release acceptance work.
+The current release candidate is **0.1.0-rc.12**, published under the `next` tag. Requires `@nativescript/core` 8.9 or later. It doesn't depend on a framework: it takes a view, or an element that holds one. Rebuild the native app after installing or upgrading Jolt. See [release status and limits](https://jolt.rafaelaugusto.dev/guide/not-there-yet) for the remaining stable-release acceptance work.
 
 On iOS 15+, Jolt requests up to 120 Hz on ProMotion displays. Set `CADisableMinimumFrameDurationOnPhone` to `true` in the app's `App_Resources/iOS/Info.plist` and rebuild to enable higher rates on iPhone. See the [iOS setup](https://jolt.rafaelaugusto.dev/guide/install#promotion-on-ios); the system still chooses the actual refresh rate.
 

package/dist/audio/index.d.ts

@@ -0,0 +1,9 @@
+import { type AudioCueOptions } from '../core/audio.js';
+export type { AudioCue, AudioPlayback } from '../core/audio.js';
+export interface NativeAudioCueOptions extends AudioCueOptions {
+    /** Ambient respects the silent switch. Application leaves the audio session to its owner. */
+    iosSession?: 'ambient' | 'application';
+}
+/** Preload a bundled/local one-shot. Native playback owns the clock; no JS frame polling. */
+export declare function audioCue(file: string, options?: NativeAudioCueOptions): import("./index.js").AudioCue;
+//# sourceMappingURL=index.d.ts.map

package/dist/audio/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAqC,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAC1F,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAC/D,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,6FAA6F;IAC7F,UAAU,CAAC,EAAE,SAAS,GAAG,aAAa,CAAA;CACvC;AAoFD,6FAA6F;AAC7F,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,iCA+JzE"}

package/dist/audio/index.js

@@ -0,0 +1,216 @@
+import { Application, File, knownFolders, path } from '@nativescript/core';
+import { createAudioCue } from '../core/audio.js';
+let ambientLeases = 0, restoreSession;
+function ambientSession() {
+    const session = AVAudioSession.sharedInstance();
+    if (!ambientLeases) {
+        const category = session.category, mode = session.mode, options = session.categoryOptions;
+        if (category !== AVAudioSessionCategoryAmbient &&
+            category !== AVAudioSessionCategorySoloAmbient)
+            throw new Error('The app owns a non-ambient audio session. Pass iosSession: application and configure its policy explicitly.');
+        session.setCategoryError(AVAudioSessionCategoryAmbient);
+        const appliedMode = session.mode, appliedOptions = session.categoryOptions;
+        restoreSession = () => {
+            if (session.category === AVAudioSessionCategoryAmbient &&
+                session.mode === appliedMode &&
+                session.categoryOptions === appliedOptions)
+                session.setCategoryModeOptionsError(category, mode, options);
+        };
+    }
+    ambientLeases++;
+    let released = false;
+    return () => {
+        if (released)
+            return;
+        released = true;
+        if (--ambientLeases === 0) {
+            const restore = restoreSession;
+            restoreSession = undefined;
+            restore?.();
+        }
+    };
+}
+const audioCallbacks = new WeakMap();
+let AudioDelegateClass;
+function audioDelegate() {
+    if (!AudioDelegateClass) {
+        const base = NSObject;
+        AudioDelegateClass = base.extend({
+            audioPlayerDidFinishPlayingSuccessfully(_player, success) {
+                const callbacks = audioCallbacks.get(this);
+                if (success)
+                    callbacks?.complete?.();
+                else
+                    callbacks?.fail?.(new Error('Native audio did not finish successfully.'));
+            },
+            audioPlayerDecodeErrorDidOccurError(_player, error) {
+                audioCallbacks.get(this)?.fail?.(error);
+            },
+        }, { protocols: [AVAudioPlayerDelegate], name: 'JoltAudioCueDelegate' });
+    }
+    const delegate = AudioDelegateClass.new();
+    const callbacks = {};
+    audioCallbacks.set(delegate, callbacks);
+    return { delegate, callbacks };
+}
+/** Preload a bundled/local one-shot. Native playback owns the clock; no JS frame polling. */
+export function audioCue(file, options = {}) {
+    if (typeof file !== 'string' || !file || /^(?:https?|content|data):/i.test(file))
+        throw new TypeError('Audio cues require a bundled or absolute local file path.');
+    if (options.iosSession !== undefined &&
+        !['ambient', 'application'].includes(options.iosSession))
+        throw new TypeError('Invalid iOS audio session policy.');
+    const resolved = file.startsWith('~/')
+        ? path.join(knownFolders.currentApp().path, file.slice(2))
+        : file;
+    if (!resolved.startsWith('/'))
+        throw new TypeError('Audio files use ~/app-relative or absolute paths.');
+    let disposePlatform = () => { }, off = () => { };
+    let player, androidPlayer;
+    let delegate;
+    let ended = false, released = false;
+    let fail;
+    const adapter = {
+        load(ready, rejected) {
+            fail = rejected;
+            if (!File.exists(resolved))
+                throw new Error(`Audio file is unavailable: ${file}`);
+            if (__IOS__) {
+                if (options.iosSession !== 'application')
+                    disposePlatform = ambientSession();
+                player = AVAudioPlayer.alloc().initWithContentsOfURLError(NSURL.fileURLWithPath(resolved));
+                if (!player || !player.prepareToPlay())
+                    throw new Error('Audio preparation failed.');
+                delegate = audioDelegate();
+                delegate.callbacks.fail = (error) => fail?.(error);
+                player.delegate = delegate.delegate;
+                ready(player.duration * 1000);
+            }
+            else {
+                androidPlayer = new android.media.MediaPlayer();
+                androidPlayer.setAudioAttributes(new android.media.AudioAttributes.Builder()
+                    .setUsage(android.media.AudioAttributes.USAGE_ASSISTANCE_SONIFICATION)
+                    .setContentType(android.media.AudioAttributes.CONTENT_TYPE_SONIFICATION)
+                    .build());
+                androidPlayer.setOnPreparedListener(new android.media.MediaPlayer.OnPreparedListener({
+                    onPrepared: (p) => ready(p.getDuration()),
+                }));
+                androidPlayer.setOnErrorListener(new android.media.MediaPlayer.OnErrorListener({
+                    onError: (_p, what, extra) => {
+                        fail?.(new Error(`Android audio error ${what}/${extra}`));
+                        return true;
+                    },
+                }));
+                androidPlayer.setDataSource(resolved);
+                androidPlayer.prepareAsync();
+            }
+        },
+        start(complete, rejected) {
+            fail = rejected;
+            if (__IOS__) {
+                if (ended)
+                    player.currentTime = 0;
+                delegate.callbacks.complete = () => {
+                    ended = true;
+                    complete();
+                };
+                ended = false;
+                if (!player.play())
+                    throw new Error('Native audio output could not start.');
+            }
+            else {
+                if (ended)
+                    androidPlayer.seekTo(0);
+                ended = false;
+                androidPlayer.setOnCompletionListener(new android.media.MediaPlayer.OnCompletionListener({
+                    onCompletion: () => {
+                        ended = true;
+                        complete();
+                    },
+                }));
+                androidPlayer.start();
+            }
+        },
+        pause() {
+            if (__IOS__)
+                player?.pause();
+            else
+                androidPlayer?.pause();
+        },
+        stop() {
+            ended = false;
+            if (__IOS__) {
+                player?.stop();
+                if (player)
+                    player.currentTime = 0;
+                if (delegate)
+                    delegate.callbacks.complete = undefined;
+            }
+            else if (androidPlayer) {
+                androidPlayer.setOnCompletionListener(null);
+                if (androidPlayer.isPlaying())
+                    androidPlayer.pause();
+                androidPlayer.seekTo(0);
+            }
+        },
+        volume(value) {
+            if (__IOS__) {
+                if (player)
+                    player.volume = value;
+            }
+            else
+                androidPlayer?.setVolume(value, value);
+        },
+        dispose() {
+            if (released)
+                return;
+            released = true;
+            off();
+            fail = undefined;
+            if (__IOS__) {
+                player?.stop();
+                if (player)
+                    player.delegate = null;
+                delegate = undefined;
+                player = undefined;
+                disposePlatform();
+            }
+            else if (androidPlayer) {
+                androidPlayer.setOnPreparedListener(null);
+                androidPlayer.setOnCompletionListener(null);
+                androidPlayer.setOnErrorListener(null);
+                androidPlayer.release();
+                androidPlayer = undefined;
+            }
+        },
+    };
+    const cue = createAudioCue(adapter, options);
+    if (cue.status === 'failed')
+        return cue;
+    let held = false;
+    const suspend = () => {
+        if (!cue.suspended) {
+            held = true;
+            cue.suspend();
+        }
+    };
+    const resume = () => {
+        if (held) {
+            held = false;
+            cue.resume();
+        }
+    };
+    Application.on(Application.suspendEvent, suspend);
+    Application.on(Application.resumeEvent, resume);
+    const observer = __IOS__
+        ? Application.ios.addNotificationObserver(AVAudioSessionInterruptionNotification, () => cue.stop())
+        : undefined;
+    off = () => {
+        Application.off(Application.suspendEvent, suspend);
+        Application.off(Application.resumeEvent, resume);
+        if (__IOS__ && observer)
+            Application.ios.removeNotificationObserver(observer, AVAudioSessionInterruptionNotification);
+    };
+    return cue;
+}
+//# sourceMappingURL=index.js.map

package/dist/audio/index.js.map

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

package/dist/core/adapter-inspection.d.ts

@@ -0,0 +1,82 @@
+import type { RenderActivity } from './render-activity.js';
+export type AdapterEventKind = 'prepare' | 'write' | 'start' | 'replace' | 'bind' | 'pause' | 'play' | 'seek' | 'cancel' | 'complete' | 'dispose';
+export interface AdapterObservation {
+    alive: boolean;
+    values: readonly number[] | null;
+    owner?: object;
+    binding: boolean;
+    paused?: boolean;
+}
+interface AdapterDefinition {
+    name: string;
+    units: readonly string[];
+    platform: 'ios' | 'android' | 'web';
+    target: object;
+    read(): AdapterObservation;
+}
+export declare function registerAdapterInspection(property: object, definition: AdapterDefinition): void;
+export declare function adapterEvent(property: object, kind: AdapterEventKind, owner?: object, previous?: object): void;
+/** Disabled path performs one WeakMap lookup and allocates no timing/sample objects. */
+export declare function adapterMeasure(property: object, kind: 'prepare' | 'write'): ((components?: number) => void) | undefined;
+export interface AdapterInspectionEvent {
+    sequence: number;
+    at: number;
+    target: string;
+    kind: AdapterEventKind;
+    owner?: number;
+    previous?: number;
+    ownerLabel?: string;
+    previousLabel?: string;
+    jsMs?: number;
+    preparedComponents?: number;
+}
+export interface AdapterInspectionSnapshot {
+    version: 1;
+    properties: {
+        id: string;
+        name: string;
+        units: string[];
+        platform: 'ios' | 'android' | 'web';
+        target: number;
+        values: number[] | null;
+        observation: 'adapter-read' | 'unavailable';
+        owner?: number;
+        ownerLabel?: string;
+        binding: boolean;
+        paused?: boolean;
+    }[];
+    activities: {
+        id: string;
+        active: boolean;
+        suspended: boolean;
+        references: number;
+    }[];
+    events: AdapterInspectionEvent[];
+    cost: {
+        reads: number;
+        readMs: number;
+        prepareMs: number;
+        updateMs: number;
+        writes: number;
+        preparedComponents: number;
+        droppedEvents: number;
+    };
+    /** No renderer, native sampling, allocator or GPU measurements are inferred. */
+    unavailable: readonly ['gpuTime', 'nativeSamplingTime', 'allocatedBytes'];
+}
+export interface AdapterInspector {
+    watch(property: object, id: string): () => void;
+    activity(activity: RenderActivity, id: string): () => void;
+    label(owner: object, label: string): void;
+    read(): AdapterInspectionSnapshot;
+    clear(): void;
+    dispose(): void;
+}
+/** Explicit, bounded, pull-only registration. Weak references do not keep targets alive. */
+export declare function createAdapterInspector(options: {
+    development: true;
+    capacity?: number;
+    now(): number;
+}): AdapterInspector;
+export {};
+//# sourceMappingURL=adapter-inspection.d.ts.map

package/dist/core/adapter-inspection.d.ts.map

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

package/dist/core/adapter-inspection.js

@@ -0,0 +1,215 @@
+const definitions = new WeakMap();
+const hooks = new WeakMap();
+export function registerAdapterInspection(property, definition) {
+    definitions.set(property, definition);
+}
+export function adapterEvent(property, kind, owner, previous) {
+    const listeners = hooks.get(property);
+    if (listeners)
+        for (const listener of listeners)
+            listener.event(kind, owner, previous);
+    if (kind === 'dispose') {
+        definitions.delete(property);
+        hooks.delete(property);
+    }
+}
+/** Disabled path performs one WeakMap lookup and allocates no timing/sample objects. */
+export function adapterMeasure(property, kind) {
+    const listeners = hooks.get(property);
+    if (!listeners?.size)
+        return undefined;
+    const starts = [...listeners].map((listener) => [listener, listener.now()]);
+    return (components = 0) => {
+        for (const [listener, start] of starts)
+            listener.event(kind, undefined, undefined, Math.max(0, listener.now() - start), components);
+    };
+}
+/** Explicit, bounded, pull-only registration. Weak references do not keep targets alive. */
+export function createAdapterInspector(options) {
+    if (options.development !== true)
+        throw new TypeError('Adapter inspection requires development: true.');
+    const capacity = options.capacity ?? 240;
+    if (!Number.isInteger(capacity) || capacity < 8 || capacity > 2000)
+        throw new RangeError('Inspector capacity is 8–2000.');
+    const properties = new Map();
+    const activities = new Map();
+    const identities = new WeakMap(), labels = new WeakMap();
+    let sequence = 0, next = 0, disposed = false;
+    const events = [];
+    const cost = {
+        reads: 0,
+        readMs: 0,
+        prepareMs: 0,
+        updateMs: 0,
+        writes: 0,
+        preparedComponents: 0,
+        droppedEvents: 0,
+    };
+    const identity = (value) => {
+        let id = identities.get(value);
+        if (!id) {
+            id = ++next;
+            identities.set(value, id);
+        }
+        return id;
+    };
+    const validID = (id) => {
+        if (disposed)
+            throw new Error('Adapter inspector is disposed.');
+        if (!/^[A-Za-z][\w.-]{0,63}$/.test(id) || properties.has(id) || activities.has(id))
+            throw new TypeError('Use a unique non-personal ASCII inspector ID.');
+        if (properties.size + activities.size >= 128)
+            throw new RangeError('Inspect at most 128 explicit resources.');
+    };
+    const remove = (id) => {
+        properties.get(id)?.off();
+        properties.delete(id);
+    };
+    return {
+        watch(property, id) {
+            validID(id);
+            const definition = definitions.get(property);
+            if (!definition)
+                throw new TypeError('This resource does not expose adapter inspection.');
+            const ref = new WeakRef(property);
+            const listener = {
+                now: options.now,
+                event(kind, owner, previous, jsMs, components) {
+                    if (disposed || !properties.has(id))
+                        return;
+                    events.push({
+                        sequence: ++sequence,
+                        at: options.now(),
+                        target: id,
+                        kind,
+                        ...(owner && { owner: identity(owner), ownerLabel: labels.get(owner) }),
+                        ...(previous && {
+                            previous: identity(previous),
+                            previousLabel: labels.get(previous),
+                        }),
+                        ...(jsMs !== undefined && { jsMs }),
+                        ...(components !== undefined && { preparedComponents: components }),
+                    });
+                    if (events.length > capacity) {
+                        events.shift();
+                        cost.droppedEvents++;
+                    }
+                    if (kind === 'prepare') {
+                        cost.prepareMs += jsMs ?? 0;
+                        cost.preparedComponents += components ?? 0;
+                    }
+                    if (kind === 'write') {
+                        cost.updateMs += jsMs ?? 0;
+                        cost.writes++;
+                    }
+                    if (kind === 'dispose')
+                        remove(id);
+                },
+            };
+            let listeners = hooks.get(property);
+            if (!listeners) {
+                listeners = new Set();
+                hooks.set(property, listeners);
+            }
+            listeners.add(listener);
+            const held = listeners;
+            properties.set(id, { ref, off: () => held.delete(listener) });
+            return () => remove(id);
+        },
+        activity(activity, id) {
+            validID(id);
+            activities.set(id, new WeakRef(activity));
+            return () => {
+                activities.delete(id);
+            };
+        },
+        label(owner, label) {
+            if (typeof label !== 'string' || !label || label.length > 100)
+                throw new TypeError('Use a short non-personal inspector label.');
+            labels.set(owner, label);
+            const id = identities.get(owner);
+            if (id)
+                for (const event of events) {
+                    if (event.owner === id)
+                        event.ownerLabel = label;
+                    if (event.previous === id)
+                        event.previousLabel = label;
+                }
+        },
+        read() {
+            const start = options.now();
+            const result = [];
+            for (const [id, entry] of properties) {
+                const property = entry.ref.deref(), definition = property && definitions.get(property);
+                if (!definition) {
+                    remove(id);
+                    continue;
+                }
+                let observation;
+                try {
+                    observation = definition.read();
+                }
+                catch {
+                    remove(id);
+                    continue;
+                }
+                if (!observation.alive) {
+                    remove(id);
+                    continue;
+                }
+                result.push({
+                    id,
+                    name: definition.name,
+                    units: [...definition.units],
+                    platform: definition.platform,
+                    target: identity(definition.target),
+                    values: observation.values ? [...observation.values] : null,
+                    observation: observation.values ? 'adapter-read' : 'unavailable',
+                    binding: observation.binding,
+                    paused: observation.paused,
+                    ...(observation.owner && {
+                        owner: identity(observation.owner),
+                        ownerLabel: labels.get(observation.owner),
+                    }),
+                });
+            }
+            const demand = [];
+            for (const [id, ref] of activities) {
+                const activity = ref.deref();
+                if (!activity || activity.disposed) {
+                    activities.delete(id);
+                    continue;
+                }
+                demand.push({
+                    id,
+                    active: activity.active,
+                    suspended: activity.suspended,
+                    references: activity.size,
+                });
+            }
+            cost.reads++;
+            cost.readMs += Math.max(0, options.now() - start);
+            return {
+                version: 1,
+                properties: result,
+                activities: demand,
+                events: events.map((e) => ({ ...e })),
+                cost: { ...cost },
+                unavailable: ['gpuTime', 'nativeSamplingTime', 'allocatedBytes'],
+            };
+        },
+        clear() {
+            events.length = 0;
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            for (const id of properties.keys())
+                remove(id);
+            activities.clear();
+            events.length = 0;
+        },
+    };
+}
+//# sourceMappingURL=adapter-inspection.js.map

package/dist/core/adapter-inspection.js.map

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

package/dist/core/audio.d.ts

@@ -0,0 +1,39 @@
+import type { Animation } from './playback.js';
+export interface AudioPlayback extends Animation {
+    readonly duration: number | undefined;
+    readonly paused: boolean;
+    pause(): void;
+    play(): void;
+    dispose(): void;
+}
+export interface AudioCueOptions {
+    volume?: number;
+    muted?: boolean;
+    onError?: (error: unknown) => void;
+}
+export interface AudioCue {
+    /** Preparation failures resolve false; they never reject visual timelines. */
+    readonly ready: Promise<boolean>;
+    readonly status: 'loading' | 'ready' | 'failed' | 'disposed';
+    readonly duration: number | undefined;
+    readonly suspended: boolean;
+    volume: number;
+    muted: boolean;
+    /** One voice per cue. A new play replaces the preceding voice; play on a handle resumes. */
+    play(): AudioPlayback;
+    stop(): void;
+    suspend(): void;
+    resume(): void;
+    dispose(): void;
+}
+export interface AudioAdapter {
+    load(ready: (duration: number) => void, fail: (error: unknown) => void): void;
+    start(complete: () => void, fail: (error: unknown) => void): void | Promise<void>;
+    pause(): void;
+    stop(): void;
+    volume(value: number): void;
+    dispose(): void;
+}
+/** Boundary callbacks only: the audio backend owns its playback clock. */
+export declare function createAudioCue(adapter: AudioAdapter, options?: AudioCueOptions): AudioCue;
+//# sourceMappingURL=audio.d.ts.map

package/dist/core/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../src/core/audio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,MAAM,WAAW,aAAc,SAAQ,SAAS;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,KAAK,IAAI,IAAI,CAAA;IACb,IAAI,IAAI,IAAI,CAAA;IACZ,OAAO,IAAI,IAAI,CAAA;CAChB;AACD,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACnC;AACD,MAAM,WAAW,QAAQ;IACvB,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAA;IAC5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,OAAO,CAAA;IACd,4FAA4F;IAC5F,IAAI,IAAI,aAAa,CAAA;IACrB,IAAI,IAAI,IAAI,CAAA;IACZ,OAAO,IAAI,IAAI,CAAA;IACf,MAAM,IAAI,IAAI,CAAA;IACd,OAAO,IAAI,IAAI,CAAA;CAChB;AACD,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAA;IAC7E,KAAK,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjF,KAAK,IAAI,IAAI,CAAA;IACb,IAAI,IAAI,IAAI,CAAA;IACZ,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAC5B,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,eAAoB,GAC5B,QAAQ,CAuNV"}