@aura3d/engine 1.0.9 → 1.0.10

package/dist/audio/AudioTimelineTrack.js

@@ -0,0 +1,297 @@
+export class AudioTimelineTrack {
+    id;
+    name;
+    role;
+    busName;
+    volume;
+    muted;
+    solo;
+    clipsRef = [];
+    constructor(options) {
+        this.id = nonEmpty(options.id, "Audio timeline track id");
+        this.name = options.name ?? options.id;
+        this.role = options.role;
+        this.busName = options.busName ?? defaultAudioTimelineBusForRole(options.role);
+        this.volume = validateVolume(options.volume ?? 1, "Audio timeline track volume");
+        this.muted = options.muted ?? false;
+        this.solo = options.solo ?? false;
+        for (const clip of options.clips ?? []) {
+            this.addClip(clip);
+        }
+    }
+    get clips() {
+        return [...this.clipsRef].sort(compareTimelineClips);
+    }
+    addClip(options) {
+        if (this.clipsRef.some((clip) => clip.id === options.id)) {
+            throw new Error(`Audio timeline clip already exists: ${options.id}`);
+        }
+        const clip = createAudioTimelineClip(options, this.busName);
+        this.clipsRef.push(clip);
+        this.sortClips();
+        return clip;
+    }
+    getClip(id) {
+        const clip = this.clipsRef.find((entry) => entry.id === id);
+        if (!clip) {
+            throw new Error(`Unknown audio timeline clip: ${id}`);
+        }
+        return clip;
+    }
+    removeClip(id) {
+        const index = this.clipsRef.findIndex((clip) => clip.id === id);
+        if (index < 0) {
+            throw new Error(`Unknown audio timeline clip: ${id}`);
+        }
+        const [removed] = this.clipsRef.splice(index, 1);
+        return removed;
+    }
+    moveClip(id, startTime) {
+        const clip = this.getClip(id);
+        const updated = { ...clip, startTime: validateNonNegative(startTime, "Audio timeline clip startTime") };
+        this.replaceClip(updated);
+        return updated;
+    }
+    trimClip(id, trimStart, trimEnd) {
+        const clip = this.getClip(id);
+        const sourceDuration = clip.sourceDuration;
+        const nextTrimStart = validateNonNegative(trimStart, "Audio timeline clip trimStart");
+        const nextTrimEnd = validateNonNegative(trimEnd, "Audio timeline clip trimEnd");
+        if (nextTrimEnd <= nextTrimStart || nextTrimEnd > sourceDuration) {
+            throw new Error("Audio timeline trim range must be inside the source duration");
+        }
+        const updated = {
+            ...clip,
+            trimStart: nextTrimStart,
+            trimEnd: nextTrimEnd,
+            duration: nextTrimEnd - nextTrimStart,
+            envelope: clip.envelope.filter((point) => point.time <= nextTrimEnd - nextTrimStart)
+        };
+        this.replaceClip(updated);
+        return updated;
+    }
+    splitClip(id, splitTime, rightId = `${id}:split`) {
+        const clip = this.getClip(id);
+        const split = validateNonNegative(splitTime, "Audio timeline splitTime");
+        if (split <= clip.startTime || split >= clip.startTime + clip.duration) {
+            throw new Error("Audio timeline splitTime must fall inside the clip");
+        }
+        if (this.clipsRef.some((entry) => entry.id === rightId)) {
+            throw new Error(`Audio timeline clip already exists: ${rightId}`);
+        }
+        const leftDuration = split - clip.startTime;
+        const rightDuration = clip.duration - leftDuration;
+        const left = {
+            ...clip,
+            duration: leftDuration,
+            trimEnd: clip.trimStart + leftDuration,
+            envelope: clip.envelope.filter((point) => point.time <= leftDuration)
+        };
+        const right = {
+            ...clip,
+            id: rightId,
+            startTime: split,
+            duration: rightDuration,
+            trimStart: clip.trimStart + leftDuration,
+            envelope: shiftEnvelope(clip.envelope.filter((point) => point.time >= leftDuration), -leftDuration)
+        };
+        this.replaceClip(left);
+        this.clipsRef.push(right);
+        this.sortClips();
+        return [left, right];
+    }
+    activeClipsAt(time) {
+        const timelineTime = validateNonNegative(time, "Audio timeline sample time");
+        return this.clipsRef.filter((clip) => clipContainsTimelineTime(clip, timelineTime)).sort(compareTimelineClips);
+    }
+    sampleAt(time) {
+        const timelineTime = validateNonNegative(time, "Audio timeline sample time");
+        if (this.muted)
+            return [];
+        return this.activeClipsAt(timelineTime)
+            .map((clip) => createTimelineSample(this, clip, timelineTime))
+            .filter((sample) => !sample.muted && sample.volume > 0);
+    }
+    replaceClip(next) {
+        const index = this.clipsRef.findIndex((clip) => clip.id === next.id);
+        if (index < 0) {
+            throw new Error(`Unknown audio timeline clip: ${next.id}`);
+        }
+        this.clipsRef[index] = next;
+        this.sortClips();
+    }
+    sortClips() {
+        this.clipsRef.sort(compareTimelineClips);
+    }
+}
+export function defaultAudioTimelineBusForRole(role) {
+    if (role === "dialogue")
+        return "voice";
+    if (role === "sfx")
+        return "sfx";
+    return role;
+}
+export function createAudioTimelineMixSnapshot(tracks, time, options = {}) {
+    const soloTracks = tracks.filter((track) => track.solo);
+    const candidateTracks = soloTracks.length > 0 ? soloTracks : tracks;
+    const activeSamples = candidateTracks.flatMap((track) => track.sampleAt(time));
+    const dialogueActive = activeSamples.some((sample) => sample.role === "dialogue" && sample.volume > 0);
+    const duckingApplied = dialogueActive && options.duckMusicDuringDialogue !== false;
+    const mutedBuses = new Set(options.mutedBuses ?? []);
+    const soloBuses = new Set(options.soloBuses ?? []);
+    const hasSoloBus = soloBuses.size > 0;
+    const busByName = new Map();
+    busByName.set("master", {
+        busName: "master",
+        role: "master",
+        volume: validateVolume(options.masterVolume ?? 1, "Audio timeline master volume"),
+        muted: mutedBuses.has("master"),
+        solo: soloBuses.has("master"),
+        ducked: false
+    });
+    for (const track of tracks) {
+        const configuredVolume = options.busVolumes?.[track.busName] ?? track.volume;
+        const ducked = duckingApplied && track.role === "music";
+        const volume = validateVolume(configuredVolume, `Audio timeline bus ${track.busName} volume`)
+            * (ducked ? validateDuckingRatio(options.duckingRatio ?? 0.35) : 1);
+        const muted = track.muted || mutedBuses.has(track.busName) || (hasSoloBus && !soloBuses.has(track.busName));
+        busByName.set(track.busName, {
+            busName: track.busName,
+            role: track.role,
+            volume,
+            muted,
+            solo: soloBuses.has(track.busName),
+            ducked
+        });
+    }
+    return {
+        time: validateNonNegative(time, "Audio timeline mix snapshot time"),
+        activeSamples: activeSamples.filter((sample) => {
+            const bus = busByName.get(sample.busName);
+            return bus ? !bus.muted && bus.volume > 0 : true;
+        }),
+        buses: [...busByName.values()].sort((a, b) => a.busName.localeCompare(b.busName)),
+        dialogueActive,
+        duckingApplied
+    };
+}
+function createAudioTimelineClip(options, fallbackBusName) {
+    const id = nonEmpty(options.id, "Audio timeline clip id");
+    const sourceDuration = validateSourceDuration(options);
+    const trimStart = validateNonNegative(options.trimStart ?? 0, "Audio timeline clip trimStart");
+    const trimEnd = validateNonNegative(options.trimEnd ?? sourceDuration, "Audio timeline clip trimEnd");
+    if (trimEnd <= trimStart || trimEnd > sourceDuration) {
+        throw new Error("Audio timeline clip trim range must be inside the source duration");
+    }
+    const duration = validateNonNegative(options.duration ?? (trimEnd - trimStart), "Audio timeline clip duration");
+    if (duration <= 0) {
+        throw new Error("Audio timeline clip duration must be greater than zero");
+    }
+    return {
+        id,
+        ...(options.clip ? { clip: options.clip } : {}),
+        ...(options.assetId ? { assetId: options.assetId } : {}),
+        ...(options.sourceUrl ? { sourceUrl: options.sourceUrl } : {}),
+        ...(options.waveform ? { waveform: options.waveform } : {}),
+        startTime: validateNonNegative(options.startTime, "Audio timeline clip startTime"),
+        duration,
+        trimStart,
+        trimEnd,
+        sourceDuration,
+        volume: validateVolume(options.volume ?? 1, "Audio timeline clip volume"),
+        muted: options.muted ?? false,
+        loop: options.loop ?? false,
+        busName: options.busName ?? fallbackBusName,
+        envelope: sortEnvelope(options.envelope ?? [])
+    };
+}
+function validateSourceDuration(options) {
+    const sourceDuration = options.clip?.duration ?? options.waveform?.duration ?? options.duration;
+    if (sourceDuration === undefined) {
+        throw new Error("Audio timeline clip requires a clip, waveform, or explicit duration");
+    }
+    return finitePositive(sourceDuration, "Audio timeline clip source duration");
+}
+function createTimelineSample(track, clip, timelineTime) {
+    const localTime = timelineTime - clip.startTime;
+    const sourceWindow = clip.trimEnd - clip.trimStart;
+    const sourceOffset = clip.loop ? localTime % sourceWindow : Math.min(localTime, sourceWindow);
+    const sourceTime = clip.trimStart + sourceOffset;
+    return {
+        trackId: track.id,
+        clipId: clip.id,
+        role: track.role,
+        busName: clip.busName,
+        timelineTime,
+        localTime,
+        sourceTime,
+        volume: track.volume * clip.volume * envelopeValueAt(clip.envelope, localTime),
+        muted: track.muted || clip.muted,
+        clip
+    };
+}
+function clipContainsTimelineTime(clip, time) {
+    return time >= clip.startTime && time < clip.startTime + clip.duration;
+}
+function envelopeValueAt(envelope, time) {
+    if (envelope.length === 0)
+        return 1;
+    if (time <= envelope[0].time)
+        return envelope[0].value;
+    for (let index = 1; index < envelope.length; index++) {
+        const previous = envelope[index - 1];
+        const next = envelope[index];
+        if (time <= next.time) {
+            const span = next.time - previous.time;
+            const alpha = span <= 0 ? 0 : (time - previous.time) / span;
+            return previous.value + (next.value - previous.value) * alpha;
+        }
+    }
+    return envelope[envelope.length - 1].value;
+}
+function sortEnvelope(envelope) {
+    return envelope
+        .map((point) => ({
+        time: validateNonNegative(point.time, "Audio timeline envelope time"),
+        value: validateVolume(point.value, "Audio timeline envelope value")
+    }))
+        .sort((a, b) => a.time - b.time);
+}
+function shiftEnvelope(envelope, delta) {
+    return sortEnvelope(envelope.map((point) => ({ ...point, time: Math.max(0, point.time + delta) })));
+}
+function compareTimelineClips(left, right) {
+    return left.startTime - right.startTime || left.id.localeCompare(right.id);
+}
+function nonEmpty(value, label) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        throw new Error(`${label} must be a non-empty string`);
+    }
+    return trimmed;
+}
+function finitePositive(value, label) {
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`${label} must be a positive finite number`);
+    }
+    return value;
+}
+function validateNonNegative(value, label) {
+    if (!Number.isFinite(value) || value < 0) {
+        throw new Error(`${label} must be a non-negative finite number`);
+    }
+    return value;
+}
+function validateVolume(value, label) {
+    if (!Number.isFinite(value) || value < 0) {
+        throw new Error(`${label} must be a non-negative finite number`);
+    }
+    return value;
+}
+function validateDuckingRatio(value) {
+    if (!Number.isFinite(value) || value < 0 || value > 1) {
+        throw new Error("Audio timeline duckingRatio must be between 0 and 1");
+    }
+    return value;
+}
+//# sourceMappingURL=AudioTimelineTrack.js.map

package/dist/audio/AudioTimelineTrack.js.map

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

package/dist/audio/AudioWaveform.d.ts

@@ -0,0 +1,42 @@
+import type { AudioClip } from "./AudioClip";
+export interface AudioWaveformOptions {
+    readonly peakCount?: number;
+    readonly samplesPerPeak?: number;
+    readonly channel?: number | "mix";
+    readonly normalize?: boolean;
+}
+export interface AudioWaveformPeak {
+    readonly min: number;
+    readonly max: number;
+    readonly rms: number;
+}
+export interface AudioWaveformData {
+    readonly duration: number;
+    readonly sampleRate: number;
+    readonly channels: number;
+    readonly peakCount: number;
+    readonly samplesPerPeak: number;
+    readonly normalized: boolean;
+    readonly peaks: readonly AudioWaveformPeak[];
+}
+export interface AudioWaveformPathPoint {
+    readonly x: number;
+    readonly yMin: number;
+    readonly yMax: number;
+    readonly rmsHeight: number;
+}
+export interface AudioWaveformPathOptions {
+    readonly width: number;
+    readonly height: number;
+    readonly padding?: number;
+}
+export type AudioWaveformInput = AudioBuffer | AudioClip;
+export declare function createAudioWaveform(input: AudioWaveformInput, options?: AudioWaveformOptions): AudioWaveformData;
+export declare function sampleAudioWaveformAtTime(waveform: AudioWaveformData, timeSeconds: number): AudioWaveformPeak;
+export declare function createAudioWaveformPath(waveform: AudioWaveformData, options: AudioWaveformPathOptions): readonly AudioWaveformPathPoint[];
+export declare function audioWaveformPeakRange(waveform: AudioWaveformData): {
+    readonly min: number;
+    readonly max: number;
+    readonly rmsMax: number;
+};
+//# sourceMappingURL=AudioWaveform.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AudioWaveform.d.ts","sourceRoot":"","sources":["../../../../packages/audio/src/AudioWaveform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC9C;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,SAAS,CAAC;AAEzD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,EAAE,OAAO,GAAE,oBAAyB,GAAG,iBAAiB,CAiDpH;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,GAAG,iBAAiB,CAO7G;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,wBAAwB,GAAG,SAAS,sBAAsB,EAAE,CAezI;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,iBAAiB,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAU3I"}

package/dist/audio/AudioWaveform.js

@@ -0,0 +1,128 @@
+export function createAudioWaveform(input, options = {}) {
+    const buffer = audioBufferFromInput(input);
+    const channels = buffer.numberOfChannels;
+    const sampleRate = finitePositive(buffer.sampleRate, "sampleRate");
+    const duration = Math.max(0, buffer.duration);
+    const totalSamples = Math.max(0, Math.round(duration * sampleRate));
+    const samplesPerPeak = resolveSamplesPerPeak(totalSamples, options);
+    const peakCount = totalSamples === 0 ? 0 : Math.ceil(totalSamples / samplesPerPeak);
+    const peaks = [];
+    const sourceChannels = collectWaveformChannels(buffer, options.channel ?? "mix");
+    for (let peakIndex = 0; peakIndex < peakCount; peakIndex++) {
+        const start = peakIndex * samplesPerPeak;
+        const end = Math.min(totalSamples, start + samplesPerPeak);
+        let min = 0;
+        let max = 0;
+        let sumSquares = 0;
+        let sampleCount = 0;
+        for (let sampleIndex = start; sampleIndex < end; sampleIndex++) {
+            let value = 0;
+            for (const channel of sourceChannels) {
+                value += channel[sampleIndex] ?? 0;
+            }
+            value /= sourceChannels.length;
+            min = Math.min(min, value);
+            max = Math.max(max, value);
+            sumSquares += value * value;
+            sampleCount++;
+        }
+        peaks.push({
+            min,
+            max,
+            rms: sampleCount === 0 ? 0 : Math.sqrt(sumSquares / sampleCount)
+        });
+    }
+    const normalize = options.normalize ?? false;
+    const outputPeaks = normalize ? normalizePeaks(peaks) : peaks;
+    return {
+        duration,
+        sampleRate,
+        channels,
+        peakCount: outputPeaks.length,
+        samplesPerPeak,
+        normalized: normalize,
+        peaks: outputPeaks
+    };
+}
+export function sampleAudioWaveformAtTime(waveform, timeSeconds) {
+    if (waveform.peaks.length === 0 || waveform.duration <= 0) {
+        return { min: 0, max: 0, rms: 0 };
+    }
+    const normalizedTime = clamp(timeSeconds / waveform.duration, 0, 1);
+    const index = Math.min(waveform.peaks.length - 1, Math.floor(normalizedTime * waveform.peaks.length));
+    return waveform.peaks[index] ?? { min: 0, max: 0, rms: 0 };
+}
+export function createAudioWaveformPath(waveform, options) {
+    const width = finitePositive(options.width, "width");
+    const height = finitePositive(options.height, "height");
+    const padding = Math.max(0, options.padding ?? 0);
+    const drawableHeight = Math.max(1, height - padding * 2);
+    const centerY = padding + drawableHeight / 2;
+    const halfHeight = drawableHeight / 2;
+    const denominator = Math.max(1, waveform.peaks.length - 1);
+    return waveform.peaks.map((peak, index) => ({
+        x: waveform.peaks.length === 1 ? width / 2 : index / denominator * width,
+        yMin: centerY - clamp(peak.max, -1, 1) * halfHeight,
+        yMax: centerY - clamp(peak.min, -1, 1) * halfHeight,
+        rmsHeight: clamp(peak.rms, 0, 1) * halfHeight
+    }));
+}
+export function audioWaveformPeakRange(waveform) {
+    let min = 0;
+    let max = 0;
+    let rmsMax = 0;
+    for (const peak of waveform.peaks) {
+        min = Math.min(min, peak.min);
+        max = Math.max(max, peak.max);
+        rmsMax = Math.max(rmsMax, peak.rms);
+    }
+    return { min, max, rmsMax };
+}
+function audioBufferFromInput(input) {
+    return "buffer" in input ? input.buffer : input;
+}
+function resolveSamplesPerPeak(totalSamples, options) {
+    if (options.samplesPerPeak !== undefined) {
+        return Math.max(1, Math.floor(finitePositive(options.samplesPerPeak, "samplesPerPeak")));
+    }
+    if (options.peakCount !== undefined) {
+        const peakCount = Math.max(1, Math.floor(finitePositive(options.peakCount, "peakCount")));
+        return Math.max(1, Math.ceil(totalSamples / peakCount));
+    }
+    return Math.max(1, Math.ceil(totalSamples / 1024));
+}
+function collectWaveformChannels(buffer, channel) {
+    if (buffer.numberOfChannels <= 0) {
+        throw new Error("Audio waveform requires at least one channel");
+    }
+    if (channel === "mix") {
+        return Array.from({ length: buffer.numberOfChannels }, (_, index) => buffer.getChannelData(index));
+    }
+    if (!Number.isInteger(channel) || channel < 0 || channel >= buffer.numberOfChannels) {
+        throw new Error(`Audio waveform channel ${channel} is outside the buffer channel range`);
+    }
+    return [buffer.getChannelData(channel)];
+}
+function normalizePeaks(peaks) {
+    let maxAbs = 0;
+    for (const peak of peaks) {
+        maxAbs = Math.max(maxAbs, Math.abs(peak.min), Math.abs(peak.max), peak.rms);
+    }
+    if (maxAbs <= 0)
+        return peaks;
+    return peaks.map((peak) => ({
+        min: peak.min / maxAbs,
+        max: peak.max / maxAbs,
+        rms: peak.rms / maxAbs
+    }));
+}
+function finitePositive(value, label) {
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`Audio waveform ${label} must be a positive finite number`);
+    }
+    return value;
+}
+function clamp(value, min, max) {
+    return Math.min(max, Math.max(min, value));
+}
+//# sourceMappingURL=AudioWaveform.js.map

package/dist/audio/AudioWaveform.js.map

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

package/dist/audio/index.d.ts

@@ -1,6 +1,12 @@
 export { AudioBus } from "./AudioBus";
 export { AudioClip } from "./AudioClip";
 export type { AudioClipOptions } from "./AudioClip";
+export { AudioFileManager } from "./AudioFileManager";
+export type { AudioDecodeContextLike, AudioFileAssetLike, AudioFileFetchResponseLike, AudioFileInput, AudioFileManagerOptions, AudioFileRequest, ResolvedAudioFileRequest } from "./AudioFileManager";
+export { createAudioTimelineMixSnapshot, defaultAudioTimelineBusForRole, AudioTimelineTrack } from "./AudioTimelineTrack";
+export type { AudioTimelineBusMix, AudioTimelineClip, AudioTimelineClipOptions, AudioTimelineEnvelopePoint, AudioTimelineMixOptions, AudioTimelineMixSnapshot, AudioTimelineSample, AudioTimelineTrackOptions, AudioTimelineTrackRole } from "./AudioTimelineTrack";
+export { audioWaveformPeakRange, createAudioWaveform, createAudioWaveformPath, sampleAudioWaveformAtTime } from "./AudioWaveform";
+export type { AudioWaveformData, AudioWaveformInput, AudioWaveformOptions, AudioWaveformPathOptions, AudioWaveformPathPoint, AudioWaveformPeak } from "./AudioWaveform";
 export { sampleAudioEffectsAnalysisFixture } from "./AudioEffectsAnalysisFixtures";
 export type { AudioChorusPreset, AudioCompressorPreset, AudioDelayPreset, AudioDistortionCurve, AudioEffectsAnalysisFixture, AudioEffectsAnalysisFixtureOptions, AudioEqBandFixture, AudioSpectrumBandFixture } from "./AudioEffectsAnalysisFixtures";
 export { sampleAdaptiveMusicFixture } from "./AdaptiveMusicFixtures";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/audio/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AACnF,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,kCAAkC,EAClC,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,YAAY,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChL,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,YAAY,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC3H,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC7G,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/audio/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,cAAc,EACd,uBAAuB,EACvB,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,8BAA8B,EAAE,8BAA8B,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1H,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,mBAAmB,EACnB,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAClI,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AACnF,YAAY,EACV,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAC3B,kCAAkC,EAClC,kBAAkB,EAClB,wBAAwB,EACzB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,YAAY,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChL,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,YAAY,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC3H,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC7G,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/audio/index.js

@@ -1,5 +1,8 @@
 export { AudioBus } from "./AudioBus.js";
 export { AudioClip } from "./AudioClip.js";
+export { AudioFileManager } from "./AudioFileManager.js";
+export { createAudioTimelineMixSnapshot, defaultAudioTimelineBusForRole, AudioTimelineTrack } from "./AudioTimelineTrack.js";
+export { audioWaveformPeakRange, createAudioWaveform, createAudioWaveformPath, sampleAudioWaveformAtTime } from "./AudioWaveform.js";
 export { sampleAudioEffectsAnalysisFixture } from "./AudioEffectsAnalysisFixtures.js";
 export { sampleAdaptiveMusicFixture } from "./AdaptiveMusicFixtures.js";
 export { sampleAudioEnvironmentFixture } from "./SpatialAudioFixtures.js";

package/dist/audio/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/audio/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AAWnF,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAErE,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/audio/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAUtD,OAAO,EAAE,8BAA8B,EAAE,8BAA8B,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAY1H,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AASlI,OAAO,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AAWnF,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAErE,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/aura3d-cli/cartoon-asset-profiles.d.ts

@@ -0,0 +1,14 @@
+import type { CartoonAssetProfile } from "@aura3d/asset-index";
+export type AuraCliCartoonAssetProfile = CartoonAssetProfile;
+export interface AuraCliCartoonAssetProfileDefinition {
+    readonly id: AuraCliCartoonAssetProfile;
+    readonly label: string;
+    readonly category: "character" | "prop" | "set" | "environment";
+    readonly requiredMetadata: readonly string[];
+    readonly optionalMetadata: readonly string[];
+    readonly rejectionReasons: readonly string[];
+    readonly resolveHints: readonly string[];
+}
+export declare const cartoonCliAssetProfiles: readonly AuraCliCartoonAssetProfileDefinition[];
+export declare function getCartoonAssetProfileDefinition(profile: AuraCliCartoonAssetProfile): AuraCliCartoonAssetProfileDefinition | undefined;
+//# sourceMappingURL=cartoon-asset-profiles.d.ts.map

package/dist/aura3d-cli/cartoon-asset-profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cartoon-asset-profiles.d.ts","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/cartoon-asset-profiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,MAAM,0BAA0B,GAAG,mBAAmB,CAAC;AAE7D,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,EAAE,EAAE,0BAA0B,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,aAAa,CAAC;IAChE,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,eAAO,MAAM,uBAAuB,EAAE,SAAS,oCAAoC,EAqClF,CAAC;AAEF,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,0BAA0B,GAClC,oCAAoC,GAAG,SAAS,CAElD"}

package/dist/aura3d-cli/cartoon-asset-profiles.js

@@ -0,0 +1,42 @@
+export const cartoonCliAssetProfiles = [
+    {
+        id: "cartoon-character",
+        label: "Cartoon character",
+        category: "character",
+        requiredMetadata: ["verified redistributable license", "GLB model", "cartoon/stylized metadata", "rigged humanoid or skinned character evidence", "embedded animation clips", "checksum"],
+        optionalMetadata: ["facial morphs", "mouth bones", "emotion clips", "texture summary", "bounds"],
+        rejectionReasons: ["static asset", "non-character metadata", "missing rig evidence", "unverified license", "IP-risk metadata", "photoreal scan metadata", "oversized browser payload"],
+        resolveHints: ["Use --profile cartoon-character for animated humanoid or expressive mascot searches.", "Run assets validate-cartoon after resolve to confirm lip-sync and scale readiness."],
+    },
+    {
+        id: "cartoon-prop",
+        label: "Cartoon prop",
+        category: "prop",
+        requiredMetadata: ["verified redistributable license", "GLB model", "cartoon/stylized metadata", "prop-like category metadata", "checksum"],
+        optionalMetadata: ["bounds", "texture summary", "collision bounds", "triangle budget"],
+        rejectionReasons: ["unverified license", "IP-risk metadata", "photoreal scan metadata", "oversized browser payload", "non-prop metadata"],
+        resolveHints: ["Use --profile cartoon-prop for furniture, vehicles, nature props, tools, toys, and set dressing."],
+    },
+    {
+        id: "cartoon-set",
+        label: "Cartoon set",
+        category: "set",
+        requiredMetadata: ["verified redistributable license", "GLB model", "cartoon/stylized metadata", "set/location metadata", "checksum"],
+        optionalMetadata: ["environment-scale bounds", "walkable floor hints", "collision bounds", "thumbnail"],
+        rejectionReasons: ["unverified license", "IP-risk metadata", "photoreal scan metadata", "too small for a set", "oversized browser payload"],
+        resolveHints: ["Use --profile cartoon-set for rooms, parks, schools, streets, stages, and episode locations."],
+    },
+    {
+        id: "cartoon-environment",
+        label: "Cartoon environment",
+        category: "environment",
+        requiredMetadata: ["verified redistributable license", "GLB backdrop/world model", "cartoon/stylized metadata", "environment/backdrop metadata", "checksum"],
+        optionalMetadata: ["large-scale bounds", "skybox/backdrop hints", "thumbnail", "lighting notes"],
+        rejectionReasons: ["unverified license", "IP-risk metadata", "photoreal scan metadata", "non-environment metadata", "oversized browser payload"],
+        resolveHints: ["Use --profile cartoon-environment for skyboxes, backdrops, worlds, terrains, horizons, and large scenic layers."],
+    },
+];
+export function getCartoonAssetProfileDefinition(profile) {
+    return cartoonCliAssetProfiles.find((candidate) => candidate.id === profile);
+}
+//# sourceMappingURL=cartoon-asset-profiles.js.map

package/dist/aura3d-cli/cartoon-asset-profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cartoon-asset-profiles.js","sourceRoot":"","sources":["../../../../packages/aura3d-cli/src/cartoon-asset-profiles.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,uBAAuB,GAAoD;IACtF;QACE,EAAE,EAAE,mBAAmB;QACvB,KAAK,EAAE,mBAAmB;QAC1B,QAAQ,EAAE,WAAW;QACrB,gBAAgB,EAAE,CAAC,kCAAkC,EAAE,WAAW,EAAE,2BAA2B,EAAE,+CAA+C,EAAE,0BAA0B,EAAE,UAAU,CAAC;QACzL,gBAAgB,EAAE,CAAC,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,QAAQ,CAAC;QAChG,gBAAgB,EAAE,CAAC,cAAc,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,2BAA2B,CAAC;QACtL,YAAY,EAAE,CAAC,sFAAsF,EAAE,oFAAoF,CAAC;KAC7L;IACD;QACE,EAAE,EAAE,cAAc;QAClB,KAAK,EAAE,cAAc;QACrB,QAAQ,EAAE,MAAM;QAChB,gBAAgB,EAAE,CAAC,kCAAkC,EAAE,WAAW,EAAE,2BAA2B,EAAE,6BAA6B,EAAE,UAAU,CAAC;QAC3I,gBAAgB,EAAE,CAAC,QAAQ,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,CAAC;QACtF,gBAAgB,EAAE,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,2BAA2B,EAAE,mBAAmB,CAAC;QACzI,YAAY,EAAE,CAAC,kGAAkG,CAAC;KACnH;IACD;QACE,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,aAAa;QACpB,QAAQ,EAAE,KAAK;QACf,gBAAgB,EAAE,CAAC,kCAAkC,EAAE,WAAW,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,UAAU,CAAC;QACrI,gBAAgB,EAAE,CAAC,0BAA0B,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,WAAW,CAAC;QACvG,gBAAgB,EAAE,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,2BAA2B,CAAC;QAC3I,YAAY,EAAE,CAAC,8FAA8F,CAAC;KAC/G;IACD;QACE,EAAE,EAAE,qBAAqB;QACzB,KAAK,EAAE,qBAAqB;QAC5B,QAAQ,EAAE,aAAa;QACvB,gBAAgB,EAAE,CAAC,kCAAkC,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,+BAA+B,EAAE,UAAU,CAAC;QAC5J,gBAAgB,EAAE,CAAC,oBAAoB,EAAE,uBAAuB,EAAE,WAAW,EAAE,gBAAgB,CAAC;QAChG,gBAAgB,EAAE,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,2BAA2B,CAAC;QAChJ,YAAY,EAAE,CAAC,iHAAiH,CAAC;KAClI;CACF,CAAC;AAEF,MAAM,UAAU,gCAAgC,CAC9C,OAAmC;IAEnC,OAAO,uBAAuB,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;AAC/E,CAAC"}