@nice2dev/ui-audio 0.1.0

package/dist/utils/grooveTemplates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grooveTemplates.d.ts","sourceRoot":"","sources":["../../src/utils/grooveTemplates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,oDAAoD;IACpD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,oDAAoD;IACpD,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,0BAA0B;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,qBAAqB;IACrB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAID,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAiD5C,CAAC;AAcF,4BAA4B;AAC5B,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,UAAU,EAAE,CAclF;AAED,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,cAAc,GAAG,UAAU,EAAE,CAexF;AAED,sCAAsC;AACtC,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAAE,EACpB,QAAQ,EAAE,cAAc,EACxB,QAAQ,GAAE,MAAU,GACnB,UAAU,EAAE,CAmBd;AAED,oEAAoE;AACpE,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,iBAAiB,GAAG,UAAU,EAAE,CAmBzF;AAED,yBAAyB;AACzB,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAExE;AAED,8BAA8B;AAC9B,wBAAgB,sBAAsB,IAAI,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAE5E"}

package/dist/utils/karaokeHelpers.d.ts

@@ -0,0 +1,61 @@
+import { KaraokeSongFile } from '../models/modelsKaraoke';
+import { PlayerTrack } from '../player/GenericPlayer';
+import { NoteDescriptor, PitchPoint, NoteScoreResult } from './karaokeScoring';
+import { KaraokeNoteData } from '../karaoke/rendering/karaokeTimeline';
+/**
+ * Classic autocorrelation pitch estimator.
+ * Returns detected frequency in Hz, or 0 if the signal is below `rmsThreshold`.
+ */
+export declare function autoCorrelate(buf: Float32Array, sampleRate: number, rmsThreshold?: number): number;
+/**
+ * Converts parsed KaraokeNoteData[][] + gap (seconds) into a flat
+ * NoteDescriptor[] suitable for `scoreNotesWithPitchPoints`.
+ */
+export declare function buildNoteDescriptors(noteLines: KaraokeNoteData[][], gapSec: number): NoteDescriptor[];
+export interface SegmentScoreEntry {
+    start: number;
+    end: number;
+    pitch: number;
+    frac: number;
+    isGold?: boolean;
+    noteStart?: number;
+    noteEnd?: number;
+}
+/**
+ * Maps per-note scoring results back to timeline-friendly segment entries
+ * for canvas visualization.
+ */
+export declare function buildSegmentScores(perNote: NoteScoreResult[], noteLines: KaraokeNoteData[][], gapSec: number): SegmentScoreEntry[];
+/**
+ * Down-samples an array of pitch points to at most `maxPoints` evenly-spaced
+ * entries and quantizes time to 3 decimal places and frequency to integers.
+ */
+export declare function downsampleAndQuantizePitchPoints(points: PitchPoint[], maxPoints?: number): PitchPoint[];
+/**
+ * Estimates one-way latency (ms) between a server-recorded timestamp and now,
+ * accounting for clock offset.
+ */
+export declare function estimateLatencyMs(serverTimeUtc: string, localNowMs: number, clockOffsetMs: number): number;
+/**
+ * Returns a human-readable label for a pitch algorithm ID.
+ */
+export declare function getAlgorithmLabel(alg: string): string;
+/**
+ * Returns a hex colour associated with the given pitch algorithm.
+ */
+export declare function getAlgorithmColor(alg: string): string;
+export declare function getAlgorithmCssVar(alg: string): string;
+/**
+ * Converts a `KaraokeSongFile` into a `PlayerTrack` the generic player
+ * can consume.  Behaviour depends on `gameMode`:
+ *  - modes containing "no-music" → empty sources (a-cappella)
+ *  - modes containing "instrumental" → prefer `instrumentalPath`
+ *  - default → YouTube > audioPath
+ */
+export declare function toTrack(song: KaraokeSongFile, gameMode: string | undefined): PlayerTrack;
+/**
+ * Maps a "browser song" object (from KaraokeSongBrowser) to a proper
+ * `KaraokeSongFile`.  Accepts an `any`-ish input shape and normalises it.
+ */
+export declare function convertBrowserSongToKaraokeSongFile(initialSong: Record<string, unknown>): KaraokeSongFile;
+//# sourceMappingURL=karaokeHelpers.d.ts.map

package/dist/utils/karaokeHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"karaokeHelpers.d.ts","sourceRoot":"","sources":["../../src/utils/karaokeHelpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAO5E;;;GAGG;AACH,wBAAgB,aAAa,CACzB,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,MAAM,EAClB,YAAY,GAAE,MAAa,GAC5B,MAAM,CAkBR;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAChC,SAAS,EAAE,eAAe,EAAE,EAAE,EAC9B,MAAM,EAAE,MAAM,GACf,cAAc,EAAE,CAelB;AAMD,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAC9B,OAAO,EAAE,eAAe,EAAE,EAC1B,SAAS,EAAE,eAAe,EAAE,EAAE,EAC9B,MAAM,EAAE,MAAM,GACf,iBAAiB,EAAE,CAmBrB;AAMD;;;GAGG;AACH,wBAAgB,gCAAgC,CAC5C,MAAM,EAAE,UAAU,EAAE,EACpB,SAAS,GAAE,MAAY,GACxB,UAAU,EAAE,CAYd;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACtB,MAAM,CAIR;AAaD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAErD;AAID,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGtD;AAMD;;;;;;GAMG;AACH,wBAAgB,OAAO,CACnB,IAAI,EAAE,eAAe,EACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC7B,WAAW,CAmDb;AAMD;;;GAGG;AACH,wBAAgB,mCAAmC,CAC/C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,eAAe,CAkCjB"}

package/dist/utils/karaokeMetadata.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Parses metadata from format: v=youtubeId,co=cover.jpg,bg=background.jpg
+ * Used in VIDEO tags in karaoke files.
+ *
+ * @example
+ * parseVideoMetadata("v=l9ml3nyww80,co=cruel-summer.jpg,bg=bananarama.jpg")
+ * // returns { youtubeId: "l9ml3nyww80", coverImage: "cruel-summer.jpg", backgroundImage: "bananarama.jpg" }
+ */
+export interface VideoMetadata {
+    youtubeId?: string;
+    coverImage?: string;
+    backgroundImage?: string;
+}
+export declare function parseVideoMetadata(metadata: string | null | undefined): VideoMetadata;
+/**
+ * Constructs a cover image URL based on metadata.
+ * If coverImage is a full URL (http/https), returns it directly.
+ * If it is a relative filename, builds URL via backend API.
+ * If it is a youtubeId, returns YouTube thumbnail URL.
+ * Otherwise returns a placeholder.
+ */
+export declare function getCoverUrl(metadata: VideoMetadata, baseUrl?: string): string;
+/**
+ * Constructs background URL based on metadata.
+ */
+export declare function getBackgroundUrl(metadata: VideoMetadata, baseUrl?: string): string;
+//# sourceMappingURL=karaokeMetadata.d.ts.map

package/dist/utils/karaokeMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"karaokeMetadata.d.ts","sourceRoot":"","sources":["../../src/utils/karaokeMetadata.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,CAoBrF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,SAAuB,GAAG,MAAM,CAmB3F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,SAAiB,GAAG,MAAM,CAM1F"}

package/dist/utils/karaokeScoring.d.ts

@@ -0,0 +1,111 @@
+export interface NoteDescriptor {
+    startTime: number;
+    duration: number;
+    pitch: number;
+    isGold?: boolean;
+    line?: number;
+    idx?: number;
+}
+export interface PitchPoint {
+    t: number;
+    hz: number;
+}
+export interface ScoringParams {
+    semitoneTolerance: number;
+    preWindow: number;
+    postExtra: number;
+    segMs?: number;
+    completionBonusFactor?: number;
+    goldFullBonusFactor?: number;
+    difficultyMult?: number;
+    /** When true, gold notes are treated as regular (ScoreFactor=1 instead of 2). */
+    disableGoldNotes?: boolean;
+}
+export interface NoteScoreResult {
+    noteKey: string;
+    segments: Array<{
+        segIndex: number;
+        frac: number;
+        add: number;
+        segStart: number;
+        segEnd: number;
+        visualStart: number;
+        visualEnd: number;
+    }>;
+    totalAdded: number;
+    completed?: boolean;
+    completionBonus?: number;
+    goldFullBonus?: number;
+}
+/** Aggregated note-level statistics for backend submission. */
+export interface NoteStats {
+    /** Notes where the player scored > 0 */
+    hits: number;
+    /** Notes with zero score */
+    misses: number;
+    /** Partially-hit notes (some segments scored, not all) */
+    good: number;
+    /** Fully-completed notes (all segments scored) */
+    perfect: number;
+    /** Longest consecutive note-hit streak */
+    maxCombo: number;
+}
+export interface ScoringResult {
+    /** Classic score: note hits with gold 2× (UltraStar rules). Raw before scaling, 0–10 000 after. */
+    classicScore: number;
+    /** Bonus points: combo + completion + gold-full bonuses. Raw before scaling, uncapped after. */
+    bonusScore: number;
+    /** Total = classicScore + bonusScore */
+    totalScore: number;
+    /** @deprecated Alias for classicScore — backward compat with tests */
+    total: number;
+    perNote: NoteScoreResult[];
+    combo?: ComboResult;
+    verseRatings?: VerseRating[];
+    /** Aggregated hit/miss/good/perfect/combo stats for backend XP formula. */
+    noteStats?: NoteStats;
+}
+/** Rating labels for verse performance (UltraStar-style) */
+export type VerseRatingLabel = 'Awful' | 'Bad' | 'OK' | 'Good' | 'Great' | 'Perfect';
+export interface VerseRating {
+    verseIndex: number;
+    hitFraction: number;
+    label: VerseRatingLabel;
+    comboBonus: number;
+}
+export interface ComboResult {
+    maxCombo: number;
+    currentCombo: number;
+    totalComboBonus: number;
+}
+/** Map a hit fraction (0-1) to a rating label */
+export declare function getVerseRatingLabel(fraction: number): VerseRatingLabel;
+/** Combo multiplier: combo >= 10 → 1.5x, >= 20 → 2x, >= 30 → 2.5x, >= 50 → 3x */
+export declare function getComboMultiplier(combo: number): number;
+export declare function scoreNotesWithPitchPoints(notes: NoteDescriptor[], points: PitchPoint[], params: ScoringParams): ScoringResult;
+/**
+ * Compute the theoretical maximum raw segment score (perfect play on every note).
+ * This equals 10 000 in the scaled UI — songs of any length map to the same max.
+ */
+export declare function computeTheoreticalMax(notes: NoteDescriptor[], disableGoldNotes?: boolean): number;
+/**
+ * Scale a raw segment score to the 0–10 000 range.
+ * 10 000 = perfect performance regardless of song length.
+ */
+export declare function scaleTo10k(rawScore: number, theoreticalMax: number): number;
+/**
+ * Scale a full ScoringResult using UltraStar 10k normalization.
+ * - classicScore: capped at 10 000 (UltraStar parity)
+ * - bonusScore: scaled proportionally but uncapped (combo/completion/gold-full)
+ * - totalScore: classicScore + bonusScore
+ * - total: alias for classicScore (backward compat)
+ */
+export declare function scaleResult(result: ScoringResult, notes: NoteDescriptor[], disableGoldNotes?: boolean): ScoringResult;
+declare const _default: {
+    scoreNotesWithPitchPoints: typeof scoreNotesWithPitchPoints;
+    computeTheoreticalMax: typeof computeTheoreticalMax;
+    scaleTo10k: typeof scaleTo10k;
+    scaleResult: typeof scaleResult;
+};
+export default _default;
+//# sourceMappingURL=karaokeScoring.d.ts.map

package/dist/utils/karaokeScoring.d.ts.map

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

package/dist/utils/latencyEstimate.d.ts

@@ -0,0 +1,8 @@
+export declare function makeClickReference(totalMs: number, sampleRate: number, clickAtMs?: number, clickWidthMs?: number): Float32Array<ArrayBuffer>;
+export declare function estimateLatencyMsFromRecording(recorded: Float32Array, sampleRate: number, clickAtMs?: number, clickWidthMs?: number): number | null;
+declare const _default: {
+    estimateLatencyMsFromRecording: typeof estimateLatencyMsFromRecording;
+    makeClickReference: typeof makeClickReference;
+};
+export default _default;
+//# sourceMappingURL=latencyEstimate.d.ts.map

package/dist/utils/latencyEstimate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latencyEstimate.d.ts","sourceRoot":"","sources":["../../src/utils/latencyEstimate.ts"],"names":[],"mappings":"AAIA,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,SAAK,EAAE,YAAY,SAAK,6BAYxG;AA8CD,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,SAAK,EAAE,YAAY,SAAK,GAAI,MAAM,GAAG,IAAI,CAc5I;;;;;AAED,wBAAsE"}

package/dist/utils/lfoEngine.d.ts

@@ -0,0 +1,55 @@
+export type LFOWaveform = 'sine' | 'triangle' | 'sawtooth' | 'square' | 'random' | 'sample-hold';
+export interface LFOConfig {
+    /** Waveform shape */
+    waveform: LFOWaveform;
+    /** Frequency in Hz (0.01 - 20) */
+    rate: number;
+    /** Depth/amplitude (0-1) */
+    depth: number;
+    /** Phase offset in radians (0 - 2π) */
+    phase: number;
+    /** Center/bias value (0-1) — output = center ± depth/2 */
+    center: number;
+    /** Whether the LFO is synced to BPM */
+    syncToBpm: boolean;
+    /** Sync division (e.g. '1/4' = quarter note, '1/8' = eighth note) */
+    syncDivision: LFOSyncDivision;
+    /** Target CC number (or parameter ID) */
+    targetCC?: number;
+    /** Whether the LFO is active */
+    enabled: boolean;
+}
+export type LFOSyncDivision = '4/1' | '2/1' | '1/1' | '1/2' | '1/4' | '1/8' | '1/16' | '1/32' | '1/2t' | '1/4t' | '1/8t' | '1/16t';
+export declare function createDefaultLFO(): LFOConfig;
+/** Convert BPM + sync division to LFO frequency in Hz */
+export declare function syncDivisionToHz(bpm: number, division: LFOSyncDivision): number;
+/** Core waveform function: returns value in [-1, 1] range */
+export declare function waveformValue(waveform: LFOWaveform, phase: number): number;
+/**
+ * Compute LFO output at a given time.
+ * Returns value in [0, 1] range (clamped).
+ */
+export declare function evaluateLFO(config: LFOConfig, time: number, bpm?: number): number;
+/**
+ * Compute LFO output mapped to a CC value (0-127).
+ */
+export declare function evaluateLFOAsCC(config: LFOConfig, time: number, bpm?: number): number;
+/**
+ * Sample LFO over a time range to generate CC automation events.
+ */
+export declare function sampleLFOToCCEvents(config: LFOConfig, startTime: number, endTime: number, cc: number, samplesPerSecond?: number, bpm?: number): {
+    time: number;
+    value: number;
+    cc: number;
+}[];
+/**
+ * Generate an array of { x, y } points for SVG visualization.
+ * x in [0, width], y in [0, height].
+ */
+export declare function sampleLFOForDisplay(config: LFOConfig, width: number, height: number, duration?: number, bpm?: number, samples?: number): {
+    x: number;
+    y: number;
+}[];
+export declare function serializeLFO(config: LFOConfig): string;
+export declare function deserializeLFO(json: string): LFOConfig | null;
+//# sourceMappingURL=lfoEngine.d.ts.map

package/dist/utils/lfoEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lfoEngine.d.ts","sourceRoot":"","sources":["../../src/utils/lfoEngine.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEjG,MAAM,WAAW,SAAS;IACxB,qBAAqB;IACrB,QAAQ,EAAE,WAAW,CAAC;IACtB,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,qEAAqE;IACrE,YAAY,EAAE,eAAe,CAAC;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,eAAe,GACvB,KAAK,GAAG,KAAK,GAAG,KAAK,GACrB,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GACvC,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAIvC,wBAAgB,gBAAgB,IAAI,SAAS,CAW5C;AAmBD,yDAAyD;AACzD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,MAAM,CAG/E;AAID,6DAA6D;AAC7D,wBAAgB,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CA4B1E;AAID;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAYjF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAErF;AAID;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,gBAAgB,GAAE,MAAW,EAC7B,GAAG,CAAC,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,CAY/C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAU,EACpB,GAAG,CAAC,EAAE,MAAM,EACZ,OAAO,GAAE,MAAY,GACpB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,CAa5B;AAID,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAEtD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAS7D"}

package/dist/utils/librosaStreaming.d.ts

@@ -0,0 +1,19 @@
+import { BaseStreamClient, BaseStreamOptions } from './BaseStreamClient';
+export type LibrosaMessage = {
+    hz?: number;
+    confidence?: number;
+    error?: string;
+    [k: string]: unknown;
+};
+export type LibrosaStreamOptions = BaseStreamOptions & {
+    onMessage?: (msg: LibrosaMessage) => void;
+};
+export declare class LibrosaStreamClient extends BaseStreamClient {
+    private readonly librosaOpts;
+    constructor(opts: LibrosaStreamOptions);
+    protected get tag(): string;
+    protected handleWsMessage(data: string): void;
+    protected get useWorklet(): boolean;
+}
+export declare function startLibrosaMicStream(opts: LibrosaStreamOptions): Promise<LibrosaStreamClient>;
+//# sourceMappingURL=librosaStreaming.d.ts.map

package/dist/utils/librosaStreaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"librosaStreaming.d.ts","sourceRoot":"","sources":["../../src/utils/librosaStreaming.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,MAAM,cAAc,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAExG,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG;IACrD,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,CAAC;CAC3C,CAAC;AAEF,qBAAa,mBAAoB,SAAQ,gBAAgB;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;gBAEvC,IAAI,EAAE,oBAAoB;IAKtC,SAAS,KAAK,GAAG,IAAI,MAAM,CAE1B;IAED,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM7C,SAAS,KAAK,UAAU,IAAI,OAAO,CAElC;CACF;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,oBAAoB,gCAIrE"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,31 @@
+/**
+ * General-purpose debug logger with environment-based log levels.
+ *
+ * Production builds only emit WARN and ERROR.
+ * Development builds emit all levels by default (overridable via VITE_LOG_LEVEL).
+ *
+ * Usage:
+ *   *   logger.debug('KaraokeManager', 'pitch updated', { pitch: 440 });
+ *   logger.warn('AudioPitch', 'fallback to default analyser');
+ *   logger.error('RSVP', 'mutation failed', error);
+ *
+ * Scoped loggers:
+ *   const _LOG_PREFIX = 'KaraokeManager';*   console.debug(_LOG_PREFIX,'init');
+ *   console.error(_LOG_PREFIX,'failed', error);
+ */
+export interface ScopedLogger {
+    debug: (message: string, ...args: unknown[]) => void;
+    info: (message: string, ...args: unknown[]) => void;
+    warn: (message: string, ...args: unknown[]) => void;
+    error: (message: string, ...args: unknown[]) => void;
+}
+export declare const logger: {
+    readonly debug: (tag: string, message: string, ...args: unknown[]) => void;
+    readonly info: (tag: string, message: string, ...args: unknown[]) => void;
+    readonly warn: (tag: string, message: string, ...args: unknown[]) => void;
+    readonly error: (tag: string, message: string, ...args: unknown[]) => void;
+    /** Create a logger pre-bound to a specific tag/module name. */
+    readonly scoped: (tag: string) => ScopedLogger;
+};
+export default logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAsCH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACrD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpD,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpD,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACtD;AAED,eAAO,MAAM,MAAM;0BACN,MAAM,WAAW,MAAM,WAAW,OAAO,EAAE,KAAG,IAAI;yBAOnD,MAAM,WAAW,MAAM,WAAW,OAAO,EAAE,KAAG,IAAI;yBAOlD,MAAM,WAAW,MAAM,WAAW,OAAO,EAAE,KAAG,IAAI;0BAOjD,MAAM,WAAW,MAAM,WAAW,OAAO,EAAE,KAAG,IAAI;IAO7D,+DAA+D;2BACnD,MAAM,KAAG,YAAY;CAYzB,CAAC;AAEX,eAAe,MAAM,CAAC"}

package/dist/utils/macroSystem.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Macro system — macro controllers, parameter mapping, and modulation routing.
+ * Maps macro knobs → multiple target parameters with curves and ranges.
+ */
+export type ModulationCurve = 'linear' | 'exponential' | 'logarithmic' | 's-curve' | 'step' | 'inverse';
+export interface MacroMapping {
+    id: string;
+    /** Target parameter identifier (e.g., 'filter.frequency', 'reverb.mix') */
+    targetParam: string;
+    /** Target component/effect identifier */
+    targetId: string;
+    /** Min output value */
+    minValue: number;
+    /** Max output value */
+    maxValue: number;
+    /** Curve type for value transformation */
+    curve: ModulationCurve;
+    /** Bipolar: if true, 0.5 macro = center, below inverts range */
+    bipolar: boolean;
+    /** Enabled flag */
+    enabled: boolean;
+}
+export interface MacroController {
+    id: string;
+    name: string;
+    /** Current value 0-1 */
+    value: number;
+    /** Default value */
+    defaultValue: number;
+    /** Color for UI */
+    color: string;
+    /** Mappings to target parameters */
+    mappings: MacroMapping[];
+    /** MIDI CC number for external control (null = unmapped) */
+    midiCC?: number;
+    /** Smoothing time in ms */
+    smoothingMs: number;
+}
+export interface LFOModulator {
+    id: string;
+    name: string;
+    /** LFO waveform */
+    waveform: 'sine' | 'triangle' | 'square' | 'sawtooth' | 'random';
+    /** Rate in Hz (free) or note division (synced) */
+    rate: number;
+    /** Sync to BPM */
+    synced: boolean;
+    /** Phase offset 0-1 */
+    phase: number;
+    /** Depth 0-1 */
+    depth: number;
+    /** Center value */
+    center: number;
+    /** Target mappings */
+    mappings: MacroMapping[];
+    /** Is running */
+    active: boolean;
+}
+export interface ModulationMatrix {
+    macros: MacroController[];
+    lfos: LFOModulator[];
+}
+/** Create an empty modulation matrix with N macro knobs */
+export declare function createModulationMatrix(macroCount?: number, lfoCount?: number): ModulationMatrix;
+/** Add a mapping to a macro */
+export declare function addMacroMapping(matrix: ModulationMatrix, macroId: string, targetId: string, targetParam: string, minValue?: number, maxValue?: number, curve?: ModulationCurve): ModulationMatrix;
+/** Remove a mapping from a macro */
+export declare function removeMacroMapping(matrix: ModulationMatrix, macroId: string, mappingId: string): ModulationMatrix;
+/** Set macro value and compute all mapped output values */
+export declare function setMacroValue(matrix: ModulationMatrix, macroId: string, value: number): {
+    matrix: ModulationMatrix;
+    outputs: Array<{
+        targetId: string;
+        targetParam: string;
+        value: number;
+    }>;
+};
+/** Apply curve transformation to map macro value → output value */
+export declare function applyCurve(input: number, mapping: MacroMapping): number;
+/** Compute LFO value at a given time */
+export declare function computeLFOValue(lfo: LFOModulator, timeSeconds: number): number;
+/** Get all LFO outputs at a given time */
+export declare function computeAllLFOOutputs(matrix: ModulationMatrix, timeSeconds: number): Array<{
+    targetId: string;
+    targetParam: string;
+    value: number;
+}>;
+/** Reset macro to its default value */
+export declare function resetMacro(matrix: ModulationMatrix, macroId: string): ModulationMatrix;
+/** Add mapping to an LFO */
+export declare function addLFOMapping(matrix: ModulationMatrix, lfoId: string, targetId: string, targetParam: string, minValue?: number, maxValue?: number): ModulationMatrix;
+/** Get available modulation curves */
+export declare function getModulationCurves(): Array<{
+    curve: ModulationCurve;
+    label: string;
+}>;
+//# sourceMappingURL=macroSystem.d.ts.map

package/dist/utils/macroSystem.d.ts.map

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

package/dist/utils/musicPlayerUtils.d.ts

@@ -0,0 +1,7 @@
+export type SourceKind = "youtube" | "hls" | "audio";
+export declare const isYouTubeUrl: (u: string) => boolean;
+export declare const isM3U8: (u?: string) => boolean;
+export declare const isAudioFile: (u?: string) => boolean;
+export declare const formatTime: (sec: number) => string;
+export declare function extractVideoId(url?: string): string;
+//# sourceMappingURL=musicPlayerUtils.d.ts.map

package/dist/utils/musicPlayerUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"musicPlayerUtils.d.ts","sourceRoot":"","sources":["../../src/utils/musicPlayerUtils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,CAAC;AAErD,eAAO,MAAM,YAAY,GAAI,GAAG,MAAM,YAAmC,CAAC;AAC1E,eAAO,MAAM,MAAM,GAAI,IAAI,MAAM,YAAqC,CAAC;AACvE,eAAO,MAAM,WAAW,GAAI,IAAI,MAAM,YAA2D,CAAC;AAElG,eAAO,MAAM,UAAU,GAAI,KAAK,MAAM,WAKrC,CAAC;AAEF,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,UAM1C"}

package/dist/utils/padKaraokeSession.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Karaoke Pad Session — play karaoke by hitting notes with keyboard/pad instead of singing.
+ * Difficulty levels control how many keys are needed (more keys = harder).
+ */
+export type PadKaraokeDifficulty = 'easy' | 'normal' | 'hard' | 'expert';
+export interface PadKaraokeConfig {
+    difficulty: PadKaraokeDifficulty;
+    /** Number of active keys for this difficulty */
+    keyCount: number;
+    /** Tolerance in semitones for "correct" hit */
+    semitoneTolerance: number;
+    /** Window in ms before the note to accept early hits */
+    preWindowMs: number;
+    /** Window in ms after the note to accept late hits */
+    postWindowMs: number;
+}
+export interface PadKaraokeNote {
+    id: number;
+    pitch: number;
+    startTime: number;
+    duration: number;
+    lyric?: string;
+    isGolden?: boolean;
+}
+export interface PadKaraokeHit {
+    noteId: number;
+    padIndex: number;
+    accuracy: 'perfect' | 'good' | 'ok' | 'miss';
+    timeDeltaMs: number;
+    score: number;
+}
+export interface PadKaraokeResult {
+    totalScore: number;
+    maxScore: number;
+    hits: PadKaraokeHit[];
+    combo: number;
+    maxCombo: number;
+    accuracy: number;
+    grade: 'S' | 'A' | 'B' | 'C' | 'D' | 'F';
+}
+export declare const DIFFICULTY_CONFIGS: Record<PadKaraokeDifficulty, PadKaraokeConfig>;
+/** Map a MIDI note pitch to a pad index given difficulty key count */
+export declare function pitchToPadIndex(pitch: number, keyCount: number, minPitch?: number, maxPitch?: number): number;
+/** Check if a pad press matches an expected note */
+export declare function evaluateHit(padIndex: number, pressTimeMs: number, expectedNote: PadKaraokeNote, config: PadKaraokeConfig, minPitch?: number, maxPitch?: number): PadKaraokeHit;
+/** Calculate final results from all hits */
+export declare function calculateResult(hits: PadKaraokeHit[], totalNotes: number): PadKaraokeResult;
+/** Generate a key mapping label for UI display */
+export declare function getPadKeyLabel(padIndex: number, keyCount: number): string;
+//# sourceMappingURL=padKaraokeSession.d.ts.map

package/dist/utils/padKaraokeSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"padKaraokeSession.d.ts","sourceRoot":"","sources":["../../src/utils/padKaraokeSession.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,oBAAoB,CAAC;IACjC,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;CAC1C;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,oBAAoB,EAAE,gBAAgB,CAK7E,CAAC;AAEF,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM,CAIrH;AAED,oDAAoD;AACpD,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,cAAc,EAC5B,MAAM,EAAE,gBAAgB,EACxB,QAAQ,GAAE,MAAW,EACrB,QAAQ,GAAE,MAAW,GACpB,aAAa,CA2Bf;AAED,4CAA4C;AAC5C,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,gBAAgB,CA+B3F;AAED,kDAAkD;AAClD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUzE"}

package/dist/utils/songDataHelpers.d.ts

@@ -0,0 +1,59 @@
+/**
+ * songDataHelpers — Shared accessors for cover URL, year, and genre
+ * from KaraokeSong / KaraokeSongFile, consolidating linkedSong data.
+ *
+ * Handles TWO data shapes for linkedSong:
+ *   A) DTO shape (from /get-filtered-songs): flat fields like albumCoverUrl, albumReleaseYear, artistName
+ *   B) Raw entity shape (from /filter-songs): nested objects like album.coverUrl, album.releaseYear, primaryArtist.name
+ *
+ * Priority mirrors KaraokeSongBrowser.getSongCover():
+ *   1. linkedSong.albumCoverUrl / album.coverUrl  (highest quality, from catalog)
+ *   2. linkedSong.externalCoverUrl                 (Spotify / external service)
+ *   3. song.externalCoverUrl                       (from import)
+ *   4. song.coverPath / coverImage                 (local / YouTube)
+ */
+/** DTO shape returned by /get-filtered-songs (LinkedSongInfoDto) */
+interface LinkedSongDto {
+    albumCoverUrl?: string | null;
+    externalCoverUrl?: string | null;
+    albumReleaseYear?: number | null;
+    artistName?: string | null;
+}
+/** Raw entity shape returned by /filter-songs (Song with nav properties) */
+interface LinkedSongRaw {
+    album?: {
+        coverUrl?: string | null;
+        releaseYear?: number | null;
+    } | null;
+    primaryArtist?: {
+        name?: string | null;
+        imageUrl?: string | null;
+    } | null;
+    externalCoverUrl?: string | null;
+}
+type LinkedSongAny = (LinkedSongDto & LinkedSongRaw) | null | undefined;
+interface SongLike {
+    coverPath?: string;
+    coverImage?: string;
+    externalCoverUrl?: string | null;
+    genre?: string;
+    year?: number | string;
+    linkedSong?: LinkedSongAny;
+}
+/**
+ * Resolve the best available cover URL for a song,
+ * including data from the linked Song entity.
+ */
+export declare function getSongCoverUrl(s: SongLike): string | undefined;
+/**
+ * Resolve the best available year, falling back to linkedSong.albumReleaseYear.
+ */
+export declare function getSongYear(s: SongLike): number | undefined;
+/**
+ * Resolve the best available genre.
+ * (LinkedSongInfoDto has no genre field, so this is just the direct value,
+ *  but centralised here for future expansion.)
+ */
+export declare function getSongGenre(s: SongLike): string | undefined;
+export {};
+//# sourceMappingURL=songDataHelpers.d.ts.map

package/dist/utils/songDataHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"songDataHelpers.d.ts","sourceRoot":"","sources":["../../src/utils/songDataHelpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,oEAAoE;AACpE,UAAU,aAAa;IACnB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,4EAA4E;AAC5E,UAAU,aAAa;IACnB,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACzE,aAAa,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1E,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,KAAK,aAAa,GAAG,CAAC,aAAa,GAAG,aAAa,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AAExE,UAAU,QAAQ;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,aAAa,CAAC;CAC9B;AAkCD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAS/D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAI3D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAE5D"}