@hyperframes/core 0.6.96 → 0.6.98

package/dist/beats/beatDetection.d.ts

@@ -0,0 +1,22 @@
+export interface MusicBeatAnalysis {
+    beatTimes: number[];
+    /** Per-beat loudness 0–1 (local RMS / peak), aligned by index with beatTimes. */
+    beatStrengths: number[];
+    bpm: number | null;
+    bpmConfidence: "high" | "low" | "uncertain";
+    /** Decoded mono samples — retained so strength can be measured at user-added
+     *  beats. Audio-file coordinates. May be null if decode data was dropped. */
+    channelData: Float32Array | null;
+    sampleRate: number;
+    /** Reference peak RMS used to normalize beat strengths. */
+    peak: number;
+}
+/** Local RMS amplitude at a given audio-file time. */
+export declare function computeRmsAt(channelData: Float32Array, sampleRate: number, time: number): number;
+/** Normalized beat strength (0–1) at an audio-file time, using a track peak. */
+export declare function strengthAtTime(analysis: Pick<MusicBeatAnalysis, "channelData" | "sampleRate" | "peak">, time: number): number;
+export declare function detectBeats(audioBuffer: AudioBuffer): Promise<number[]>;
+export declare function analyzeMusicFromBuffer(audioBuffer: AudioBuffer): Promise<MusicBeatAnalysis>;
+export declare function detectBeatsFromUrl(url: string): Promise<number[]>;
+export declare function analyzeMusicFromUrl(url: string): Promise<MusicBeatAnalysis>;
+//# sourceMappingURL=beatDetection.d.ts.map

package/dist/beats/beatDetection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beatDetection.d.ts","sourceRoot":"","sources":["../../src/beats/beatDetection.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,iFAAiF;IACjF,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,KAAK,GAAG,WAAW,CAAC;IAC5C;iFAC6E;IAC7E,WAAW,EAAE,YAAY,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;CACd;AAID,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,WAAW,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAWhG;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,YAAY,GAAG,MAAM,CAAC,EACxE,IAAI,EAAE,MAAM,GACX,MAAM,CAGR;AAGD,wBAAsB,WAAW,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAwC7E;AAkGD,wBAAsB,sBAAsB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA6DjG;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAUvE;AAED,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAUjF"}

package/dist/beats/beatDetection.js

@@ -0,0 +1,246 @@
+let bpmDetectivePromise = null;
+function loadBpmDetective() {
+    if (!bpmDetectivePromise) {
+        bpmDetectivePromise = import(
+        // @ts-ignore -- no type declarations for bpm-detective
+        "bpm-detective")
+            .then((m) => (m.default ?? m) || null)
+            .catch(() => null);
+    }
+    return bpmDetectivePromise;
+}
+const WINDOW_SIZE = 1024;
+const HOP_SIZE = 512;
+const STRENGTH_WINDOW_S = 0.05; // ±50ms RMS window
+/** Local RMS amplitude at a given audio-file time. */
+export function computeRmsAt(channelData, sampleRate, time) {
+    const halfWindow = Math.floor(sampleRate * STRENGTH_WINDOW_S);
+    const center = Math.floor(time * sampleRate);
+    const start = Math.max(0, center - halfWindow);
+    const end = Math.min(channelData.length, center + halfWindow);
+    let sum = 0;
+    for (let i = start; i < end; i++) {
+        const s = channelData[i] ?? 0;
+        sum += s * s;
+    }
+    return Math.sqrt(sum / Math.max(end - start, 1));
+}
+/** Normalized beat strength (0–1) at an audio-file time, using a track peak. */
+export function strengthAtTime(analysis, time) {
+    if (!analysis.channelData || analysis.peak <= 0)
+        return 0.5;
+    return Math.min(1, computeRmsAt(analysis.channelData, analysis.sampleRate, time) / analysis.peak);
+}
+// fallow-ignore-next-line complexity
+export async function detectBeats(audioBuffer) {
+    const channelData = audioBuffer.getChannelData(0);
+    const sampleRate = audioBuffer.sampleRate;
+    const energies = [];
+    for (let i = 0; i < channelData.length - WINDOW_SIZE; i += HOP_SIZE) {
+        let sum = 0;
+        for (let j = 0; j < WINDOW_SIZE; j++) {
+            const sample = channelData[i + j];
+            sum += sample * sample;
+        }
+        energies.push(sum / WINDOW_SIZE);
+    }
+    const beats = [];
+    const localWindowSize = 20;
+    for (let i = localWindowSize; i < energies.length - localWindowSize; i++) {
+        let localMean = 0;
+        for (let j = i - localWindowSize; j < i + localWindowSize; j++) {
+            localMean += energies[j];
+        }
+        localMean /= localWindowSize * 2;
+        const threshold = localMean * 1.5;
+        const current = energies[i];
+        if (current > threshold &&
+            current > (energies[i - 1] ?? 0) &&
+            current > (energies[i + 1] ?? 0)) {
+            const timeInSeconds = (i * HOP_SIZE) / sampleRate;
+            if (beats.length === 0 || timeInSeconds - beats[beats.length - 1] > 0.1) {
+                beats.push(Math.round(timeInSeconds * 1000) / 1000);
+            }
+        }
+    }
+    return beats;
+}
+function computeBpmFromBeats(beatTimes) {
+    if (beatTimes.length < 4)
+        return null;
+    const iois = [];
+    for (let i = 1; i < beatTimes.length; i++) {
+        iois.push(beatTimes[i] - beatTimes[i - 1]);
+    }
+    const sorted = [...iois].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    const medianIoi = sorted.length % 2 === 0 ? (sorted[mid - 1] + sorted[mid]) / 2 : sorted[mid];
+    if (medianIoi <= 0)
+        return null;
+    return Math.round((60 / medianIoi) * 10) / 10;
+}
+// Fold into 60–120 for octave-safe BPM comparison
+function canonicalizeBpm(bpm) {
+    let b = bpm;
+    while (b > 120)
+        b /= 2;
+    while (b < 60)
+        b *= 2;
+    return b;
+}
+// Pick the *2/÷2 octave of `bpm` whose beat interval is closest to the onset
+// pulse, so a half-time detective reading (e.g. 174 for an 87bpm song) doesn't
+// produce a double-density grid.
+function octaveAlignBpm(bpm, reference) {
+    const candidates = [bpm / 2, bpm, bpm * 2];
+    let best = bpm;
+    let bestDist = Number.POSITIVE_INFINITY;
+    for (const c of candidates) {
+        if (c <= 0)
+            continue;
+        const dist = Math.abs(c - reference);
+        if (dist < bestDist) {
+            bestDist = dist;
+            best = c;
+        }
+    }
+    return best;
+}
+// fallow-ignore-next-line complexity
+function regularizeBeats(rawBeats, bpm, duration) {
+    if (rawBeats.length === 0 || bpm <= 0 || duration <= 0)
+        return rawBeats;
+    const beatInterval = 60 / bpm;
+    // Guard against a pathological (octave-misread) tempo producing a millisecond
+    // interval → tens of thousands of grid beats that freeze the timeline. 480 BPM
+    // (0.125s) is well above any real music tempo; bail to the raw onsets instead.
+    if (beatInterval < 0.125)
+        return rawBeats;
+    const threshold = beatInterval * 0.25;
+    // Find phase offset that maximally aligns with raw onsets
+    let bestOffset = 0;
+    let bestScore = -1;
+    for (const anchor of rawBeats.slice(0, 10)) {
+        const offset = ((anchor % beatInterval) + beatInterval) % beatInterval;
+        let score = 0;
+        for (const rb of rawBeats) {
+            const phase = ((rb % beatInterval) + beatInterval) % beatInterval;
+            const dist = Math.min(Math.abs(phase - offset), beatInterval - Math.abs(phase - offset));
+            if (dist < threshold)
+                score++;
+        }
+        if (score > bestScore) {
+            bestScore = score;
+            bestOffset = offset;
+        }
+    }
+    const beats = [];
+    for (let t = bestOffset; t <= duration + 0.001; t += beatInterval) {
+        beats.push(Math.round(t * 1000) / 1000);
+    }
+    return beats;
+}
+// Drop beats that fall in silent/near-silent regions (e.g. intro/outro) and
+// score each surviving beat's loudness (local RMS / peak) for brightness.
+function gateBeatsBySilence(beats, channelData, sampleRate) {
+    if (beats.length === 0)
+        return { times: beats, strengths: [], peak: 1e-6 };
+    const energies = beats.map((t) => computeRmsAt(channelData, sampleRate, t));
+    const peak = Math.max(...energies, 1e-6);
+    const threshold = peak * 0.12;
+    const times = [];
+    const strengths = [];
+    for (let i = 0; i < beats.length; i++) {
+        if (energies[i] >= threshold) {
+            times.push(beats[i]);
+            strengths.push(Math.min(1, energies[i] / peak));
+        }
+    }
+    return { times, strengths, peak };
+}
+// fallow-ignore-next-line complexity
+export async function analyzeMusicFromBuffer(audioBuffer) {
+    const channelData = audioBuffer.getChannelData(0);
+    const sampleRate = audioBuffer.sampleRate;
+    const duration = audioBuffer.duration;
+    const rawBeats = await detectBeats(audioBuffer);
+    const onsetBpm = computeBpmFromBeats(rawBeats);
+    let detectiveBpm = null;
+    try {
+        const detect = await loadBpmDetective();
+        if (detect)
+            detectiveBpm = detect(audioBuffer);
+    }
+    catch {
+        // Not enough peaks or browser context unavailable
+    }
+    let bpm = onsetBpm;
+    let confidence = "uncertain";
+    let regularizeBpm = null;
+    if (onsetBpm !== null && detectiveBpm !== null) {
+        const pctDiff = Math.abs(canonicalizeBpm(onsetBpm) - canonicalizeBpm(detectiveBpm)) /
+            canonicalizeBpm(detectiveBpm);
+        if (pctDiff < 0.05) {
+            // Detective folds tempo into 90–180; re-pick the octave nearest the onset
+            // pulse so a half-time track isn't gridded at double density.
+            bpm = octaveAlignBpm(detectiveBpm, onsetBpm);
+            confidence = "high";
+            regularizeBpm = bpm;
+        }
+        else if (pctDiff < 0.1) {
+            bpm = Math.round((onsetBpm + detectiveBpm) / 2);
+            confidence = "low";
+            regularizeBpm = bpm;
+        }
+        else {
+            bpm = onsetBpm;
+            confidence = "uncertain";
+        }
+    }
+    else if (onsetBpm !== null) {
+        bpm = onsetBpm;
+        confidence = "low";
+        regularizeBpm = onsetBpm;
+    }
+    else if (detectiveBpm !== null) {
+        bpm = detectiveBpm;
+        confidence = "low";
+        regularizeBpm = detectiveBpm;
+    }
+    const gridBeats = regularizeBpm !== null ? regularizeBeats(rawBeats, regularizeBpm, duration) : rawBeats;
+    const gated = gateBeatsBySilence(gridBeats, channelData, sampleRate);
+    return {
+        beatTimes: gated.times,
+        beatStrengths: gated.strengths,
+        bpm,
+        bpmConfidence: confidence,
+        channelData,
+        sampleRate,
+        peak: gated.peak,
+    };
+}
+export async function detectBeatsFromUrl(url) {
+    const audioContext = new AudioContext();
+    try {
+        const response = await fetch(url);
+        const arrayBuffer = await response.arrayBuffer();
+        const audioBuffer = await audioContext.decodeAudioData(arrayBuffer);
+        return detectBeats(audioBuffer);
+    }
+    finally {
+        await audioContext.close();
+    }
+}
+export async function analyzeMusicFromUrl(url) {
+    const audioContext = new AudioContext();
+    try {
+        const response = await fetch(url);
+        const arrayBuffer = await response.arrayBuffer();
+        const audioBuffer = await audioContext.decodeAudioData(arrayBuffer);
+        return analyzeMusicFromBuffer(audioBuffer);
+    }
+    finally {
+        await audioContext.close();
+    }
+}
+//# sourceMappingURL=beatDetection.js.map

package/dist/beats/beatDetection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"beatDetection.js","sourceRoot":"","sources":["../../src/beats/beatDetection.ts"],"names":[],"mappings":"AAKA,IAAI,mBAAmB,GAAqC,IAAI,CAAC;AACjE,SAAS,gBAAgB;IACvB,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzB,mBAAmB,GAAG,MAAM;QAC1B,uDAAuD;QACvD,eAAe,CAChB;aACE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAE,CAA6B,CAAC,OAAO,IAAK,CAA0B,CAAC,IAAI,IAAI,CAAC;aAC5F,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,mBAAmB,CAAC;AAC7B,CAAC;AAED,MAAM,WAAW,GAAG,IAAI,CAAC;AACzB,MAAM,QAAQ,GAAG,GAAG,CAAC;AAgBrB,MAAM,iBAAiB,GAAG,IAAI,CAAC,CAAC,mBAAmB;AAEnD,sDAAsD;AACtD,MAAM,UAAU,YAAY,CAAC,WAAyB,EAAE,UAAkB,EAAE,IAAY;IACtF,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,iBAAiB,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,UAAU,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;IAC9D,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9B,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,cAAc,CAC5B,QAAwE,EACxE,IAAY;IAEZ,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC,IAAI,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC;IAC5D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;AACpG,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,WAAwB;IACxD,MAAM,WAAW,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC;IAE1C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC;QACpE,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;YACnC,GAAG,IAAI,MAAM,GAAG,MAAM,CAAC;QACzB,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,WAAW,CAAC,CAAC;IACnC,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,eAAe,GAAG,EAAE,CAAC;IAE3B,KAAK,IAAI,CAAC,GAAG,eAAe,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;QACzE,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,eAAe,EAAE,CAAC,GAAG,CAAC,GAAG,eAAe,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/D,SAAS,IAAI,QAAQ,CAAC,CAAC,CAAE,CAAC;QAC5B,CAAC;QACD,SAAS,IAAI,eAAe,GAAG,CAAC,CAAC;QAEjC,MAAM,SAAS,GAAG,SAAS,GAAG,GAAG,CAAC;QAClC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAC;QAE7B,IACE,OAAO,GAAG,SAAS;YACnB,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;YAChC,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,EAChC,CAAC;YACD,MAAM,aAAa,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,UAAU,CAAC;YAClD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,GAAG,GAAG,EAAE,CAAC;gBACzE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,mBAAmB,CAAC,SAAmB;IAC9C,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAE,GAAG,SAAS,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAE,GAAG,MAAM,CAAC,GAAG,CAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAE,CAAC;IACjG,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;AAChD,CAAC;AAED,kDAAkD;AAClD,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,CAAC,GAAG,GAAG,CAAC;IACZ,OAAO,CAAC,GAAG,GAAG;QAAE,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,CAAC,GAAG,EAAE;QAAE,CAAC,IAAI,CAAC,CAAC;IACtB,OAAO,CAAC,CAAC;AACX,CAAC;AAED,6EAA6E;AAC7E,+EAA+E;AAC/E,iCAAiC;AACjC,SAAS,cAAc,CAAC,GAAW,EAAE,SAAiB;IACpD,MAAM,UAAU,GAAG,CAAC,GAAG,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;IAC3C,IAAI,IAAI,GAAG,GAAG,CAAC;IACf,IAAI,QAAQ,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;QACrC,IAAI,IAAI,GAAG,QAAQ,EAAE,CAAC;YACpB,QAAQ,GAAG,IAAI,CAAC;YAChB,IAAI,GAAG,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qCAAqC;AACrC,SAAS,eAAe,CAAC,QAAkB,EAAE,GAAW,EAAE,QAAgB;IACxE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IACxE,MAAM,YAAY,GAAG,EAAE,GAAG,GAAG,CAAC;IAC9B,8EAA8E;IAC9E,+EAA+E;IAC/E,+EAA+E;IAC/E,IAAI,YAAY,GAAG,KAAK;QAAE,OAAO,QAAQ,CAAC;IAC1C,MAAM,SAAS,GAAG,YAAY,GAAG,IAAI,CAAC;IAEtC,0DAA0D;IAC1D,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC;IACnB,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,GAAG,YAAY,CAAC,GAAG,YAAY,CAAC,GAAG,YAAY,CAAC;QACvE,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,CAAC,CAAC,EAAE,GAAG,YAAY,CAAC,GAAG,YAAY,CAAC,GAAG,YAAY,CAAC;YAClE,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC;YACzF,IAAI,IAAI,GAAG,SAAS;gBAAE,KAAK,EAAE,CAAC;QAChC,CAAC;QACD,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;YACtB,SAAS,GAAG,KAAK,CAAC;YAClB,UAAU,GAAG,MAAM,CAAC;QACtB,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,UAAU,EAAE,CAAC,IAAI,QAAQ,GAAG,KAAK,EAAE,CAAC,IAAI,YAAY,EAAE,CAAC;QAClE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,4EAA4E;AAC5E,0EAA0E;AAC1E,SAAS,kBAAkB,CACzB,KAAe,EACf,WAAyB,EACzB,UAAkB;IAElB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC3E,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,EAAE,IAAI,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,QAAQ,CAAC,CAAC,CAAE,IAAI,SAAS,EAAE,CAAC;YAC9B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;YACtB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,WAAwB;IACnE,MAAM,WAAW,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC;IAC1C,MAAM,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC;IAEtC,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAE/C,IAAI,YAAY,GAAkB,IAAI,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,EAAE,CAAC;QACxC,IAAI,MAAM;YAAE,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;IACpD,CAAC;IAED,IAAI,GAAG,GAAkB,QAAQ,CAAC;IAClC,IAAI,UAAU,GAAuC,WAAW,CAAC;IACjE,IAAI,aAAa,GAAkB,IAAI,CAAC;IAExC,IAAI,QAAQ,KAAK,IAAI,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC/C,MAAM,OAAO,GACX,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;YACnE,eAAe,CAAC,YAAY,CAAC,CAAC;QAChC,IAAI,OAAO,GAAG,IAAI,EAAE,CAAC;YACnB,0EAA0E;YAC1E,8DAA8D;YAC9D,GAAG,GAAG,cAAc,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;YAC7C,UAAU,GAAG,MAAM,CAAC;YACpB,aAAa,GAAG,GAAG,CAAC;QACtB,CAAC;aAAM,IAAI,OAAO,GAAG,GAAG,EAAE,CAAC;YACzB,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;YAChD,UAAU,GAAG,KAAK,CAAC;YACnB,aAAa,GAAG,GAAG,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,GAAG,GAAG,QAAQ,CAAC;YACf,UAAU,GAAG,WAAW,CAAC;QAC3B,CAAC;IACH,CAAC;SAAM,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC7B,GAAG,GAAG,QAAQ,CAAC;QACf,UAAU,GAAG,KAAK,CAAC;QACnB,aAAa,GAAG,QAAQ,CAAC;IAC3B,CAAC;SAAM,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QACjC,GAAG,GAAG,YAAY,CAAC;QACnB,UAAU,GAAG,KAAK,CAAC;QACnB,aAAa,GAAG,YAAY,CAAC;IAC/B,CAAC;IAED,MAAM,SAAS,GACb,aAAa,KAAK,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACzF,MAAM,KAAK,GAAG,kBAAkB,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IAErE,OAAO;QACL,SAAS,EAAE,KAAK,CAAC,KAAK;QACtB,aAAa,EAAE,KAAK,CAAC,SAAS;QAC9B,GAAG;QACH,aAAa,EAAE,UAAU;QACzB,WAAW;QACX,UAAU;QACV,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAW;IAClD,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;QACjD,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QACpE,OAAO,WAAW,CAAC,WAAW,CAAC,CAAC;IAClC,CAAC;YAAS,CAAC;QACT,MAAM,YAAY,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAW;IACnD,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;QACjD,MAAM,WAAW,GAAG,MAAM,YAAY,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC;QACpE,OAAO,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC;YAAS,CAAC;QACT,MAAM,YAAY,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/dist/beats/beatFile.d.ts

@@ -0,0 +1,18 @@
+/** Project-relative path of the audio file behind a (possibly absolute) src URL. */
+export declare function audioRelPathForSrc(src: string | null | undefined): string | null;
+/** Path of the beat file for a given audio src, or null if it can't be derived. */
+export declare function beatFilePathForSrc(src: string | null | undefined): string | null;
+export declare function serializeBeats(times: number[], strengths: number[], audio: string): string;
+export declare function parseBeats(content: string): {
+    times: number[];
+    strengths: number[];
+} | null;
+/**
+ * Find the music track's src in composition HTML, applying the SAME rules as the
+ * Studio's `isMusicTrack` so the CLI and Studio agree on which `<audio>` is music:
+ * the FIRST `<audio>` (in document order) where data-timeline-role="music", or —
+ * when no role is set — whose id matches the music regex. An explicit non-music
+ * role excludes the element. Returns the raw src attribute, or null.
+ */
+export declare function findMusicAudioSrc(html: string): string | null;
+//# sourceMappingURL=beatFile.d.ts.map

package/dist/beats/beatFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"beatFile.d.ts","sourceRoot":"","sources":["../../src/beats/beatFile.ts"],"names":[],"mappings":"AAUA,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CA8BhF;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAGhF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAO1F;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAsB3F;AASD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgB7D"}

package/dist/beats/beatFile.js

@@ -0,0 +1,112 @@
+// Persistence for beat data: one JSON file per audio file, matched by the
+// audio's project-relative path. Lives under `beats/` in the project so it
+// survives the audio being removed and re-added.
+/** Project-relative path of the audio file behind a (possibly absolute) src URL. */
+export function audioRelPathForSrc(src) {
+    if (!src)
+        return null;
+    // blob:/data: URLs have no stable identity across sessions — not persistable.
+    if (/^(blob:|data:)/i.test(src))
+        return null;
+    // Studio preview URLs: /api/projects/<id>/preview[/comp]/<relpath>.
+    // Parsed with indexOf/slice (not a regex) to avoid polynomial backtracking
+    // on adversarial inputs (CodeQL js/polynomial-redos).
+    let rel = null;
+    const PREVIEW = "/preview/";
+    const previewIdx = src.indexOf(PREVIEW);
+    if (previewIdx !== -1) {
+        let after = src.slice(previewIdx + PREVIEW.length);
+        // Strip query/hash (single char class — linear, ReDoS-safe).
+        const queryOrHash = after.search(/[?#]/);
+        if (queryOrHash !== -1)
+            after = after.slice(0, queryOrHash);
+        if (after.startsWith("comp/"))
+            after = after.slice("comp/".length);
+        rel = after ? decodeURIComponent(after) : null;
+    }
+    if (!rel) {
+        // Fall back to the FULL pathname (not just basename) so two files with the
+        // same name in different folders don't collide on one beat file.
+        try {
+            rel = decodeURIComponent(new URL(src, "http://_").pathname);
+        }
+        catch {
+            rel = src;
+        }
+    }
+    if (!rel)
+        return null;
+    rel = rel.replace(/^\/+/, "");
+    return rel || null;
+}
+/** Path of the beat file for a given audio src, or null if it can't be derived. */
+export function beatFilePathForSrc(src) {
+    const rel = audioRelPathForSrc(src);
+    return rel ? `beats/${rel}.json` : null;
+}
+export function serializeBeats(times, strengths, audio) {
+    const beats = times.map((t, i) => ({
+        time: Math.round(t * 1000) / 1000,
+        strength: Math.round((strengths[i] ?? 0.5) * 1000) / 1000,
+    }));
+    const data = { version: 1, audio, beats };
+    return `${JSON.stringify(data, null, 2)}\n`;
+}
+export function parseBeats(content) {
+    try {
+        const data = JSON.parse(content);
+        // Gate on the schema version so a future v2 file (with changed semantics)
+        // isn't silently parsed as v1 — an unknown version is treated as absent.
+        if (!data || data.version !== 1 || !Array.isArray(data.beats))
+            return null;
+        const times = [];
+        const strengths = [];
+        for (const b of data.beats) {
+            if (b && typeof b.time === "number" && Number.isFinite(b.time)) {
+                times.push(b.time);
+                // Clamp to [0,1] — a hand-edited file could carry an out-of-range or
+                // non-finite strength, and the renderers feed it into Math.pow(s, 2.2)
+                // (NaN for a negative base).
+                const s = typeof b.strength === "number" && Number.isFinite(b.strength) ? b.strength : 0.5;
+                strengths.push(Math.max(0, Math.min(1, s)));
+            }
+        }
+        return { times, strengths };
+    }
+    catch {
+        return null;
+    }
+}
+const MUSIC_ID_RE = /\b(music|bgm|soundtrack|background[-_]?music)\b/i;
+function attr(tag, name) {
+    const m = tag.match(new RegExp(`\\b${name}\\s*=\\s*["']([^"']*)["']`, "i"));
+    return m ? m[1] : null;
+}
+/**
+ * Find the music track's src in composition HTML, applying the SAME rules as the
+ * Studio's `isMusicTrack` so the CLI and Studio agree on which `<audio>` is music:
+ * the FIRST `<audio>` (in document order) where data-timeline-role="music", or —
+ * when no role is set — whose id matches the music regex. An explicit non-music
+ * role excludes the element. Returns the raw src attribute, or null.
+ */
+export function findMusicAudioSrc(html) {
+    // `[^>]*` spans newlines (it's a negated class, not `.`), so multi-line opening
+    // tags are handled. HyperFrames authors src as an attribute on <audio>.
+    const tags = html.match(/<audio\b[^>]*>/gi) ?? [];
+    for (const tag of tags) {
+        const src = attr(tag, "src");
+        if (!src)
+            continue;
+        const role = attr(tag, "data-timeline-role");
+        if (role) {
+            if (role === "music")
+                return src;
+            continue; // explicit non-music role excludes
+        }
+        const id = attr(tag, "id");
+        if (id && MUSIC_ID_RE.test(id))
+            return src;
+    }
+    return null;
+}
+//# sourceMappingURL=beatFile.js.map

package/dist/beats/beatFile.js.map

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

package/dist/beats/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./beatDetection";
+export * from "./beatFile";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/beats/index.js

@@ -0,0 +1,3 @@
+export * from "./beatDetection";
+export * from "./beatFile";
+//# sourceMappingURL=index.js.map

package/dist/beats/index.js.map

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

package/dist/compiler/htmlBundler.d.ts

@@ -21,14 +21,5 @@ export interface BundleOptions {
      */
     runtime?: "inline" | "placeholder";
 }
-/**
- * Bundle a project's index.html into a single self-contained HTML file.
- *
- * - Compiles timing attributes and optionally resolves media durations
- * - Injects the HyperFrames runtime script
- * - Inlines local CSS and JS files
- * - Inlines sub-composition HTML fragments (data-composition-src)
- * - Inlines small textual assets as data URLs
- */
 export declare function bundleToSingleHtml(projectDir: string, options?: BundleOptions): Promise<string>;
 //# sourceMappingURL=htmlBundler.d.ts.map

package/dist/compiler/htmlBundler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"htmlBundler.d.ts","sourceRoot":"","sources":["../../src/compiler/htmlBundler.ts"],"names":[],"mappings":"AAGA,OAAO,EAAe,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AA8XvE,eAAO,MAAM,gCAAgC,UAW5C,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAmBrE;AA4KD,MAAM,WAAW,aAAa;IAC5B,oGAAoG;IACpG,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;IACzC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,MAAM,CAAC,CAqVjB"}
+{"version":3,"file":"htmlBundler.d.ts","sourceRoot":"","sources":["../../src/compiler/htmlBundler.ts"],"names":[],"mappings":"AAIA,OAAO,EAAe,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAsWvE,eAAO,MAAM,gCAAgC,UAW5C,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAmBrE;AA2KD,MAAM,WAAW,aAAa;IAC5B,oGAAoG;IACpG,kBAAkB,CAAC,EAAE,mBAAmB,CAAC;IACzC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;CACpC;AAmFD,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,MAAM,CAAC,CAyRjB"}