@nice2dev/ui-audio 1.3.12 → 1.3.14

package/dist/utils/gameAudio.d.ts

@@ -1,236 +0,0 @@
-/**
- * Shared Game Audio Manager — lightweight Web Audio API wrapper for
- * loading and playing sound effects in mini-games.
- *
- * Designed to be shared across all games (underpaid, bunny-arena, etc.).
- * Supports:
- *  - SFX pool with one-shot playback
- *  - Looping background music with crossfade
- *  - Master / SFX / Music volume (persisted to localStorage)
- *  - Spatial panning (left/right)
- *  - Procedural sounds (oscillator-based) for games without audio assets
- *
- * Usage:
- *   const audio = GameAudio.getInstance()
- *   audio.loadSfx('pickup', '/sounds/pickup.mp3')
- *   audio.playSfx('pickup')
- *   audio.playTone({ frequency: 440, duration: 0.1, type: 'sine' })
- */
-export interface VolumeSettings {
-    master: number;
-    sfx: number;
-    music: number;
-}
-export interface ToneOptions {
-    /** Frequency in Hz */
-    frequency: number;
-    /** Duration in seconds */
-    duration: number;
-    /** Oscillator type */
-    type?: OscillatorType;
-    /** Volume 0..1 (relative to SFX volume) */
-    volume?: number;
-    /** Pan -1 (left) to 1 (right) */
-    pan?: number;
-    /** Frequency sweep target (portamento) */
-    frequencyEnd?: number;
-    /** Attack time in seconds */
-    attack?: number;
-    /** Decay time in seconds */
-    decay?: number;
-}
-export interface ProceduralSfxPreset {
-    tones: ToneOptions[];
-}
-export declare class GameAudio {
-    private ctx;
-    private masterGain;
-    private sfxGain;
-    private musicGain;
-    private volume;
-    private sfxBuffers;
-    private musicSource;
-    private musicId;
-    private constructor();
-    static getInstance(): GameAudio;
-    private ensureContext;
-    getVolume(): VolumeSettings;
-    setVolume(partial: Partial<VolumeSettings>): void;
-    private applyVolume;
-    private loadVolume;
-    private saveVolume;
-    loadSfx(id: string, url: string): Promise<void>;
-    /** Play a loaded SFX. Returns immediately (fire-and-forget). */
-    playSfx(id: string, options?: {
-        pan?: number;
-        volume?: number;
-        playbackRate?: number;
-    }): void;
-    /** Play a procedural tone (oscillator-based SFX). */
-    playTone(opts: ToneOptions): void;
-    /** Play a preset of multiple tones (chord, arpeggio, noise burst). */
-    playPreset(preset: ProceduralSfxPreset): void;
-    loadMusic(id: string, url: string): Promise<void>;
-    playMusic(id: string, loop?: boolean): void;
-    stopMusic(): void;
-    dispose(): void;
-}
-export declare const SFX_PRESETS: {
-    pickup: {
-        tones: {
-            frequency: number;
-            frequencyEnd: number;
-            duration: number;
-            type: OscillatorType;
-            volume: number;
-        }[];
-    };
-    drop: {
-        tones: {
-            frequency: number;
-            frequencyEnd: number;
-            duration: number;
-            type: OscillatorType;
-            volume: number;
-        }[];
-    };
-    chop: {
-        tones: {
-            frequency: number;
-            duration: number;
-            type: OscillatorType;
-            volume: number;
-        }[];
-    };
-    serve: {
-        tones: {
-            frequency: number;
-            duration: number;
-            type: OscillatorType;
-            volume: number;
-        }[];
-    };
-    combo: {
-        tones: {
-            frequency: number;
-            frequencyEnd: number;
-            duration: number;
-            type: OscillatorType;
-            volume: number;
-        }[];
-    };
-    error: {
-        tones: {
-            frequency: number;
-            frequencyEnd: number;
-            duration: number;
-            type: OscillatorType;
-            volume: number;
-        }[];
-    };
-    explosion: {
-        tones: {
-            frequency: number;
-            frequencyEnd: number;
-            duration: number;
-            type: OscillatorType;
-            volume: number;
-        }[];
-    };
-    cannon: {
-        tones: {
-            frequency: number;
-            frequencyEnd: number;
-            duration: number;
-            type: OscillatorType;
-            volume: number;
-        }[];
-    };
-    hit: {
-        tones: {
-            frequency: number;
-            frequencyEnd: number;
-            duration: number;
-            type: OscillatorType;
-            volume: number;
-        }[];
-    };
-    alarm: {
-        tones: {
-            frequency: number;
-            frequencyEnd: number;
-            duration: number;
-            type: OscillatorType;
-            volume: number;
-            attack: number;
-            decay: number;
-        }[];
-    };
-    coin: {
-        tones: {
-            frequency: number;
-            duration: number;
-            type: OscillatorType;
-            volume: number;
-        }[];
-    };
-    star: {
-        tones: {
-            frequency: number;
-            duration: number;
-            type: OscillatorType;
-            volume: number;
-        }[];
-    };
-    dash: {
-        tones: {
-            frequency: number;
-            frequencyEnd: number;
-            duration: number;
-            type: OscillatorType;
-            volume: number;
-        }[];
-    };
-    gameOver: {
-        tones: {
-            frequency: number;
-            frequencyEnd: number;
-            duration: number;
-            type: OscillatorType;
-            volume: number;
-        }[];
-    };
-    victory: {
-        tones: {
-            frequency: number;
-            duration: number;
-            type: OscillatorType;
-            volume: number;
-        }[];
-    };
-    tick: {
-        tones: {
-            frequency: number;
-            duration: number;
-            type: OscillatorType;
-            volume: number;
-        }[];
-    };
-    countdownTick: {
-        tones: {
-            frequency: number;
-            duration: number;
-            type: OscillatorType;
-            volume: number;
-        }[];
-    };
-    countdownFinal: {
-        tones: {
-            frequency: number;
-            duration: number;
-            type: OscillatorType;
-            volume: number;
-        }[];
-    };
-};
-export type SfxPresetId = keyof typeof SFX_PRESETS;

package/dist/utils/index.d.ts

@@ -1,39 +0,0 @@
-export * from './audioEditorUtils';
-export * from './audioFxUtils';
-export { generateUltrastarText } from './audioPitchAlgorithms';
-export * from './audioPitchAnalyzeFile';
-export * from './audioTimelineUtils';
-export * from './audioMidiUtils';
-export * from './karaokeHelpers';
-export * from './karaokeMetadata';
-export * from './karaokeScoring';
-export * from './arpeggiator';
-export * from './articulationEngine';
-export * from './envelopeFollower';
-export * from './lfoEngine';
-export * from './stepSequencer';
-export * from './vocalEffectsEngine';
-export * from './vocalPerformanceMetrics';
-export * from './BaseStreamClient';
-export * from './crepeStreaming';
-export * from './librosaStreaming';
-export * from './ccAutomation';
-export * from './chordScale';
-export * from './clipLauncher';
-export * from './colorResolver';
-export * from './drawTool';
-export * from './grooveTemplates';
-export * from './macroSystem';
-export * from './undoRedoUtils';
-export * from './musicPlayerUtils';
-export * from './songDataHelpers';
-export * from './padKaraokeSession';
-export * from './pianoRollUtils';
-export * from './gameAudio';
-export * from './latencyEstimate';
-export * from './shortcutManager';
-export * from './audioDragDrop';
-export * from './midiCCMapping';
-export { logger } from './logger';
-export type { ScopedLogger } from './logger';
-export * from './sanitize';

package/dist/utils/macroSystem.d.ts

@@ -1,96 +0,0 @@
-/**
- * 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;
-}>;

package/dist/utils/padKaraokeSession.d.ts

@@ -1,49 +0,0 @@
-/**
- * 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;

package/dist/utils/songDataHelpers.d.ts

@@ -1,58 +0,0 @@
-/**
- * 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 {};