@nice2dev/ui-audio 0.1.0

package/dist/utils/stepSequencer.d.ts

@@ -0,0 +1,62 @@
+export interface Step {
+    /** Whether this step is active */
+    active: boolean;
+    /** MIDI note number (0-127) */
+    note: number;
+    /** Velocity (0-127) */
+    velocity: number;
+    /** Gate length as fraction of step duration (0-1) */
+    gate: number;
+    /** Probability of triggering (0-1, 1 = always) */
+    probability: number;
+    /** Optional slide/glide to next note */
+    slide: boolean;
+}
+export interface SequencerPattern {
+    /** Pattern name */
+    name: string;
+    /** Number of steps (16, 32, or 64) */
+    length: 16 | 32 | 64;
+    /** Steps data */
+    steps: Step[];
+    /** BPM (for standalone playback or sync reference) */
+    bpm: number;
+    /** Swing amount (0-1, 0 = straight, 0.67 = standard swing) */
+    swing: number;
+    /** Root note for pattern transposition */
+    rootNote: number;
+    /** CC lane to output to (optional) */
+    ccOutput?: number;
+}
+export declare function createEmptyStep(note?: number): Step;
+export declare function createEmptyPattern(name?: string, length?: 16 | 32 | 64, bpm?: number): SequencerPattern;
+export declare function toggleStep(pattern: SequencerPattern, index: number): SequencerPattern;
+export declare function setStepNote(pattern: SequencerPattern, index: number, note: number): SequencerPattern;
+export declare function setStepVelocity(pattern: SequencerPattern, index: number, velocity: number): SequencerPattern;
+export declare function setStepGate(pattern: SequencerPattern, index: number, gate: number): SequencerPattern;
+export declare function setStepProbability(pattern: SequencerPattern, index: number, prob: number): SequencerPattern;
+export declare function toggleStepSlide(pattern: SequencerPattern, index: number): SequencerPattern;
+/** Transpose all active steps by semitones */
+export declare function transposePattern(pattern: SequencerPattern, semitones: number): SequencerPattern;
+/** Reverse the pattern */
+export declare function reversePattern(pattern: SequencerPattern): SequencerPattern;
+/** Shift pattern left/right by N steps (wrapping) */
+export declare function shiftPattern(pattern: SequencerPattern, amount: number): SequencerPattern;
+/** Randomize velocity for all active steps */
+export declare function randomizeVelocity(pattern: SequencerPattern, min?: number, max?: number): SequencerPattern;
+/** Clear all steps (keep pattern structure) */
+export declare function clearPattern(pattern: SequencerPattern): SequencerPattern;
+/** Get the duration of one step in seconds */
+export declare function stepDuration(bpm: number, stepsPerBeat?: number): number;
+/** Get time offset for a step index, accounting for swing */
+export declare function stepTimeOffset(index: number, bpm: number, swing?: number, stepsPerBeat?: number): number;
+/** Should this step trigger? (probability check) */
+export declare function shouldTrigger(step: Step): boolean;
+export declare function createKickPattern(): SequencerPattern;
+export declare function createSnarePattern(): SequencerPattern;
+export declare function createHiHatPattern(): SequencerPattern;
+export declare function createArpPattern(rootNote?: number): SequencerPattern;
+export declare function createBasslinePattern(rootNote?: number): SequencerPattern;
+export declare function serializePattern(pattern: SequencerPattern): string;
+export declare function deserializePattern(json: string): SequencerPattern | null;
+//# sourceMappingURL=stepSequencer.d.ts.map

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

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

package/dist/utils/undoRedoUtils.d.ts

@@ -0,0 +1,5 @@
+import { AudioProject } from '../models/modelsEditor';
+export declare function setProjectWithUndo(next: AudioProject, project: AudioProject | null, setUndoStack: React.Dispatch<React.SetStateAction<AudioProject[]>>, setRedoStack: React.Dispatch<React.SetStateAction<AudioProject[]>>, setProject: React.Dispatch<React.SetStateAction<AudioProject | null>>): void;
+export declare function handleUndo(project: AudioProject | null, setUndoStack: React.Dispatch<React.SetStateAction<AudioProject[]>>, setRedoStack: React.Dispatch<React.SetStateAction<AudioProject[]>>, setProject: React.Dispatch<React.SetStateAction<AudioProject | null>>): void;
+export declare function handleRedo(project: AudioProject | null, setUndoStack: React.Dispatch<React.SetStateAction<AudioProject[]>>, setRedoStack: React.Dispatch<React.SetStateAction<AudioProject[]>>, setProject: React.Dispatch<React.SetStateAction<AudioProject | null>>): void;
+//# sourceMappingURL=undoRedoUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"undoRedoUtils.d.ts","sourceRoot":"","sources":["../../src/utils/undoRedoUtils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,wBAAgB,kBAAkB,CAC9B,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,YAAY,GAAG,IAAI,EAC5B,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,EAClE,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,EAClE,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,QAKxE;AAED,wBAAgB,UAAU,CACtB,OAAO,EAAE,YAAY,GAAG,IAAI,EAC5B,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,EAClE,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,EAClE,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,QASxE;AAED,wBAAgB,UAAU,CACtB,OAAO,EAAE,YAAY,GAAG,IAAI,EAC5B,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,EAClE,YAAY,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC,EAClE,UAAU,EAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,QASxE"}

package/dist/utils/vocalEffectsEngine.d.ts

@@ -0,0 +1,64 @@
+export type VocalEffectType = "chipmunk" | "deep" | "robot" | "echo" | "reverb" | "chorus" | "flanger" | "distortion" | "telephone" | "megaphone" | "whisper" | "alien" | "underwater" | "radio" | "cave" | "helium" | "demon" | "tremolo" | "autotune" | "vocoder";
+export interface VocalEffectConfig {
+    type: VocalEffectType;
+    enabled: boolean;
+    /** Effect-specific parameter (0-100). Meaning depends on effect type. */
+    intensity: number;
+    /** Display name */
+    label: string;
+    /** Emoji icon */
+    icon: string;
+}
+export declare const ALL_EFFECTS: VocalEffectConfig[];
+export declare class VocalEffectsEngine {
+    private audioCtx;
+    private mediaStream;
+    private sourceNode;
+    private inputGain;
+    private outputGain;
+    private activeEffects;
+    private effectOrder;
+    private monitoring;
+    private _volume;
+    private _inputVolume;
+    private started;
+    private externalStream;
+    private analyser;
+    get isStarted(): boolean;
+    get context(): AudioContext | null;
+    get activeEffectTypes(): VocalEffectType[];
+    start(deviceId?: string): Promise<void>;
+    startWithStream(stream: MediaStream): Promise<void>;
+    stop(): void;
+    setMonitoring(enabled: boolean): void;
+    setVolume(vol: number): void;
+    setInputGain(gain: number): void;
+    /** Get current audio level (RMS) */
+    getLevel(): number;
+    addEffect(type: VocalEffectType, intensity?: number): void;
+    removeEffect(type: VocalEffectType): void;
+    toggleEffect(type: VocalEffectType, intensity?: number): boolean;
+    updateIntensity(type: VocalEffectType, intensity: number): void;
+    clearAllEffects(): void;
+    private reconnectChain;
+    private buildEffectChain;
+    private buildPitchShift;
+    private buildRobot;
+    private buildAlien;
+    private buildDelay;
+    private buildCave;
+    private buildReverb;
+    private buildChorus;
+    private buildFlanger;
+    private buildDistortion;
+    private buildBandpass;
+    private buildMegaphone;
+    private buildRadio;
+    private buildUnderwater;
+    private buildWhisper;
+    private buildDemon;
+    private buildTremolo;
+    private buildAutotune;
+    private buildVocoder;
+}
+//# sourceMappingURL=vocalEffectsEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vocalEffectsEngine.d.ts","sourceRoot":"","sources":["../../src/utils/vocalEffectsEngine.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,eAAe,GACrB,UAAU,GACV,MAAM,GACN,OAAO,GACP,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,WAAW,GACX,WAAW,GACX,SAAS,GACT,OAAO,GACP,YAAY,GACZ,OAAO,GACP,MAAM,GACN,QAAQ,GACR,OAAO,GACP,SAAS,GACT,UAAU,GACV,SAAS,CAAC;AAEhB,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,WAAW,EAAE,iBAAiB,EAqB1C,CAAC;AAyCF,qBAAa,kBAAkB;IAC3B,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,UAAU,CAA2C;IAC7D,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,aAAa,CAAqD;IAC1E,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,OAAO,CAAO;IACtB,OAAO,CAAC,YAAY,CAAO;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAA6B;IAE7C,IAAI,SAAS,IAAI,OAAO,CAAyB;IACjD,IAAI,OAAO,IAAI,YAAY,GAAG,IAAI,CAA0B;IAC5D,IAAI,iBAAiB,IAAI,eAAe,EAAE,CAAkC;IAItE,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BvC,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBzD,IAAI,IAAI,IAAI;IAqBZ,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAOrC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAO5B,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOhC,oCAAoC;IACpC,QAAQ,IAAI,MAAM;IAclB,SAAS,CAAC,IAAI,EAAE,eAAe,EAAE,SAAS,SAAK,GAAG,IAAI;IAYtD,YAAY,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAYzC,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE,SAAS,SAAK,GAAG,OAAO;IAU5D,eAAe,CAAC,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAM/D,eAAe,IAAI,IAAI;IAgBvB,OAAO,CAAC,cAAc;IA8BtB,OAAO,CAAC,gBAAgB;IAoDxB,OAAO,CAAC,eAAe;IAoEvB,OAAO,CAAC,UAAU;IAkClB,OAAO,CAAC,UAAU;IA4ClB,OAAO,CAAC,UAAU;IA+BlB,OAAO,CAAC,SAAS;IA8CjB,OAAO,CAAC,WAAW;IAyBnB,OAAO,CAAC,WAAW;IAgDnB,OAAO,CAAC,YAAY;IAwCpB,OAAO,CAAC,eAAe;IA0BvB,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,cAAc;IAqCtB,OAAO,CAAC,UAAU;IAiClB,OAAO,CAAC,eAAe;IAuCvB,OAAO,CAAC,YAAY;IAqCpB,OAAO,CAAC,UAAU;IAiDlB,OAAO,CAAC,YAAY;IA2BpB,OAAO,CAAC,aAAa;IAuDrB,OAAO,CAAC,YAAY;CAmEvB"}

package/dist/utils/vocalPerformanceMetrics.d.ts

@@ -0,0 +1,117 @@
+import { PitchPoint, NoteDescriptor, ComboResult } from './karaokeScoring';
+/** Loose VerseRating that accepts label: string (compatible with useKaraokeManager) */
+export interface VerseRatingInput {
+    verseIndex: number;
+    hitFraction: number;
+    label: string;
+    comboBonus: number;
+}
+/** Single point in pitch-over-time chart data */
+export interface PitchChartPoint {
+    t: number;
+    sung: number;
+    expected: number;
+}
+/** Histogram bin for pitch deviation */
+export interface DeviationBin {
+    centRange: string;
+    count: number;
+    pct: number;
+}
+/** Pitch class usage (chromagram) */
+export interface PitchClassUsage {
+    note: string;
+    count: number;
+    pct: number;
+}
+/** Per-verse performance snapshot */
+export interface VerseMetric {
+    verseIndex: number;
+    label: string;
+    hitFraction: number;
+    avgCentDeviation: number;
+    noteCount: number;
+    notesHit: number;
+    comboBonus: number;
+}
+/** Vibrato analysis result */
+export interface VibratoStats {
+    detected: boolean;
+    avgRateHz: number;
+    avgExtentCents: number;
+    regularityPct: number;
+}
+/** Microphone settings snapshot */
+export interface MicSettingsSnapshot {
+    deviceId: string;
+    deviceLabel: string;
+    algorithm: string;
+    gain: number;
+    rmsThreshold: number;
+    pitchThreshold: number;
+    smoothingWindow: number;
+    hysteresisFrames: number;
+    useHanning: boolean;
+    latencyOffsetMs: number;
+    monitorEnabled: boolean;
+    monitorVolume: number;
+}
+/** Complete performance report for one player */
+export interface VocalPerformanceReport {
+    playerName: string;
+    playerColor: string;
+    songTitle: string;
+    songArtist: string;
+    songBpm: number;
+    difficulty: string;
+    timestamp: string;
+    classicScore: number;
+    bonusScore: number;
+    totalScore: number;
+    maxCombo: number;
+    totalComboBonus: number;
+    totalPitchPoints: number;
+    avgCentDeviation: number;
+    medianCentDeviation: number;
+    stdDevCents: number;
+    intonationAccuracyPct: number;
+    perfectHitPct: number;
+    pitchDeviationHistogram: DeviationBin[];
+    lowestHz: number;
+    highestHz: number;
+    lowestNote: string;
+    highestNote: string;
+    rangeInSemitones: number;
+    tessituraLow: string;
+    tessituraHigh: string;
+    pitchClassDistribution: PitchClassUsage[];
+    vibrato: VibratoStats;
+    avgOnsetDeviationMs: number;
+    rhythmStabilityPct: number;
+    jitterPct: number;
+    shimmerProxy: number;
+    verseMetrics: VerseMetric[];
+    micSettings: MicSettingsSnapshot | null;
+    pitchOverTime: PitchChartPoint[];
+    accuracyOverTime: {
+        t: number;
+        accuracy: number;
+    }[];
+}
+export declare function computeVocalPerformanceReport(params: {
+    playerName: string;
+    playerColor: string;
+    songTitle: string;
+    songArtist: string;
+    songBpm: number;
+    difficulty: string;
+    pitchPoints: PitchPoint[];
+    notes: NoteDescriptor[];
+    verseRatings: VerseRatingInput[];
+    combo: ComboResult | null;
+    classicScore: number;
+    bonusScore: number;
+    totalScore: number;
+    micSettings: MicSettingsSnapshot | null;
+}): VocalPerformanceReport;
+//# sourceMappingURL=vocalPerformanceMetrics.d.ts.map

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

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

package/dist/workers/pitchWorker.d.ts

@@ -0,0 +1,11 @@
+export interface PitchWorkerRequest {
+    id: number;
+    buffer: Float32Array;
+    sampleRate: number;
+    rmsThreshold: number;
+}
+export interface PitchWorkerResponse {
+    id: number;
+    hz: number;
+}
+//# sourceMappingURL=pitchWorker.d.ts.map

package/dist/workers/pitchWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pitchWorker.d.ts","sourceRoot":"","sources":["../../src/workers/pitchWorker.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ"}

package/dist/workers/scoringWorker.d.ts

@@ -0,0 +1,71 @@
+interface NoteDescriptor {
+    startTime: number;
+    duration: number;
+    pitch: number;
+    isGold?: boolean;
+    line?: number;
+    idx?: number;
+}
+interface PitchPoint {
+    t: number;
+    hz: number;
+}
+interface ScoringParams {
+    semitoneTolerance: number;
+    preWindow: number;
+    postExtra: number;
+    segMs?: number;
+    completionBonusFactor?: number;
+    goldFullBonusFactor?: number;
+    difficultyMult?: number;
+    disableGoldNotes?: boolean;
+}
+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;
+}
+interface ScoringResult {
+    classicScore: number;
+    bonusScore: number;
+    totalScore: number;
+    total: number;
+    perNote: NoteScoreResult[];
+    combo?: ComboResult;
+    verseRatings?: VerseRating[];
+}
+type VerseRatingLabel = 'Awful' | 'Bad' | 'OK' | 'Good' | 'Great' | 'Perfect';
+interface VerseRating {
+    verseIndex: number;
+    hitFraction: number;
+    label: VerseRatingLabel;
+    comboBonus: number;
+}
+interface ComboResult {
+    maxCombo: number;
+    currentCombo: number;
+    totalComboBonus: number;
+}
+export interface ScoringWorkerRequest {
+    id: number;
+    notes: NoteDescriptor[];
+    points: PitchPoint[];
+    params: ScoringParams;
+}
+export interface ScoringWorkerResponse {
+    id: number;
+    result: ScoringResult;
+}
+export {};
+//# sourceMappingURL=scoringWorker.d.ts.map

package/dist/workers/scoringWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoringWorker.d.ts","sourceRoot":"","sources":["../../src/workers/scoringWorker.ts"],"names":[],"mappings":"AAKA,UAAU,cAAc;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,UAAU,UAAU;IAAG,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE;AAE9C,UAAU,aAAa;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3I,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,UAAU,aAAa;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,YAAY,CAAC,EAAE,WAAW,EAAE,CAAC;CAC9B;AAED,KAAK,gBAAgB,GAAG,OAAO,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAE9E,UAAU,WAAW;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,gBAAgB,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,WAAW;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,aAAa,CAAC;CACvB"}

package/dist/workers/usePitchWorker.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Hook that offloads autoCorrelate pitch detection to a Web Worker.
+ * Returns `detectPitch(buffer, sampleRate, rmsThreshold)` → Promise<number>.
+ * Falls back to main-thread computation if Worker is unavailable.
+ */
+export declare function usePitchWorker(): (buffer: Float32Array, sampleRate: number, rmsThreshold?: number) => Promise<number>;
+//# sourceMappingURL=usePitchWorker.d.ts.map

package/dist/workers/usePitchWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePitchWorker.d.ts","sourceRoot":"","sources":["../../src/workers/usePitchWorker.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,wBAAgB,cAAc,aASX,YAAY,cAAc,MAAM,iBAAgB,MAAM,KAAU,OAAO,CAAC,MAAM,CAAC,CAQjG"}

package/dist/workers/useScoringWorker.d.ts

@@ -0,0 +1,7 @@
+import { NoteDescriptor, PitchPoint, ScoringParams, ScoringResult } from '../utils/karaokeScoring';
+/**
+ * Hook that offloads karaoke scoring to a Web Worker.
+ * Returns `computeScore(notes, points, params)` → Promise<ScoringResult>.
+ */
+export declare function useScoringWorker(): (notes: NoteDescriptor[], points: PitchPoint[], params: ScoringParams) => Promise<ScoringResult>;
+//# sourceMappingURL=useScoringWorker.d.ts.map

package/dist/workers/useScoringWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScoringWorker.d.ts","sourceRoot":"","sources":["../../src/workers/useScoringWorker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExG;;;GAGG;AACH,wBAAgB,gBAAgB,YASd,cAAc,EAAE,UAAU,UAAU,EAAE,UAAU,aAAa,KAAG,OAAO,CAAC,aAAa,CAAC,CAQvG"}

package/dist/workers/useWorker.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Generic hook that wraps a Web Worker in a promise-based API.
+ * - Lazily creates the worker on first call
+ * - Auto-terminates on unmount
+ * - Returns an `invoke(data)` function that returns a promise
+ */
+export declare function useWorker<Req extends {
+    id: number;
+}, Res extends {
+    id: number;
+}>(factory: () => Worker): (data: Omit<Req, "id">, transferables?: Transferable[]) => Promise<Res>;
+//# sourceMappingURL=useWorker.d.ts.map

package/dist/workers/useWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWorker.d.ts","sourceRoot":"","sources":["../../src/workers/useWorker.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAC9E,OAAO,EAAE,MAAM,MAAM,UA+BZ,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,kBAAkB,YAAY,EAAE,KAAG,OAAO,CAAC,GAAG,CAAC,CAYxE"}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@nice2dev/ui-audio",
+  "version": "0.1.0",
+  "description": "Nice2Dev Audio UI — DAW editor, karaoke engine, player, playlist, DMX, music visualizers for React",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./style.css": "./dist/style.css"
+  },
+  "files": ["dist", "LICENSE", "CHANGELOG.md", "README.md"],
+  "sideEffects": ["*.css"],
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -p tsconfig.build.json && vite build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "demo": "vite --config vite.demo.config.ts",
+    "demo:build": "vite build --config vite.demo.config.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "react", "audio", "daw", "karaoke", "player", "playlist", "dmx",
+    "visualizer", "midi", "pitch-detection", "scoring", "music",
+    "piano-roll", "waveform", "nicetodev"
+  ],
+  "author": "NiceToDev <contact@nicetodev.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NiceToDev/NiceToDev.UI.git",
+    "directory": "nice2dev-ui-audio"
+  },
+  "homepage": "https://github.com/NiceToDev/NiceToDev.UI#readme",
+  "bugs": {
+    "url": "https://github.com/NiceToDev/NiceToDev.UI/issues"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0",
+    "react-dom": ">=17.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react-window": { "optional": true },
+    "react-youtube": { "optional": true },
+    "hls.js": { "optional": true },
+    "pitchy": { "optional": true },
+    "phaser": { "optional": true },
+    "framer-motion": { "optional": true },
+    "@fortawesome/react-fontawesome": { "optional": true },
+    "@fortawesome/free-solid-svg-icons": { "optional": true },
+    "@fortawesome/free-brands-svg-icons": { "optional": true },
+    "music-metadata-browser": { "optional": true },
+    "fflate": { "optional": true },
+    "@ffmpeg/ffmpeg": { "optional": true },
+    "@monaco-editor/react": { "optional": true }
+  },
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/node": "^22.0.0",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "@vitejs/plugin-react": "^4.2.0",
+    "hls.js": "^1.5.0",
+    "jsdom": "^29.0.0",
+    "pitchy": "^4.1.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "react-window": "^1.8.0",
+    "react-youtube": "^10.1.0",
+    "typescript": "^5.3.0",
+    "vite": "^6.2.0",
+    "vite-plugin-dts": "^4.5.0",
+    "vitest": "^4.1.0"
+  }
+}