@nice2dev/ui-audio 0.1.0 → 1.0.2

package/CHANGELOG.md

@@ -1,4 +1,78 @@
-# Changelog
+# @nice2dev/ui-audio — Changelog
+
+All notable changes to the audio/music editor package.
+
+## [Unreleased] — OmniVerk Professional Roadmap
+
+### Planned — DAW-Grade Waveform Editor (PRO-3.1)
+
+- **Non-Destructive Editing** — pełny undo, zachowanie oryginalnych plików
+- **Multi-Track Timeline** — nieograniczona liczba ścieżek z grupowaniem
+- **Time Stretch/Pitch Shift** — profesjonalna jakość élastique
+- **Comp Lanes** — workflow dla nagrań wielu take'ów
+- **Batch Processing** — automatyczne przetwarzanie z presetami
+
+### Planned — Professional Effects Chain (PRO-3.2)
+
+- **VST3/AU Plugin Host** — ładowanie zewnętrznych pluginów
+- **Built-in EQ Pro** — parametric, graphic, linear phase
+- **Compressor Suite** — emulacje VCA, Opto, FET
+- **Metering Suite** — LUFS, true peak, spektrum, korelacja fazy
+
+### Planned — Karaoke Editor Professional (PRO-3.4)
+
+- **AI Waveform-to-Lyrics Alignment** — automatyczne dopasowanie timing
+- **Syllable-Level Sync** — precyzyjne timing sylab
+- **Pitch Guide Track** — wyświetlanie oczekiwanej wysokości dźwięku
+- **Gold Note System** — notatki bonusowe z własnym scoringiem
+- **Duet Support** — wiele partii wokalnych
+- **Backing Track Separation** — izolacja wokalu przez AI
+- **Multiplayer Mode** — system pojedynków i duetów
+
+### Planned — Sound Design Tools (PRO-3.5)
+
+- **Synthesizer Engine** — analog, FM, wavetable, granular
+- **Wwise/FMOD Integration** — eksport do middleware gier
+- **Spatial Audio** — binaural, ambisonics, HRTF
+
+---
+
+## [0.2.0] — 2026-03-25
+
+### Added (FAZA 7.2)
+
+- **Multitrack export** — bounce to WAV/MP3/FLAC with per-track volume/pan/effects
+- **Audio effects rack** — reverb, delay, chorus, compressor, EQ chain with drag & drop, presets
+- **Sample browser** — built-in browser with waveform preview, BPM detect, key detect
+- **MIDI controller mapping** — learn mode: press knob → assign to parameter
+- **DMX lighting integration** — timeline DMX channels, fixture library, Art-Net/sACN output
+- **Spotify/Apple Music import** — playlist import from API, fallback to manual paste
+
+### Added (FAZA 3.1 — Streaming)
+
+- **WebRTC P2P audio** — peer-to-peer audio chat (ICE, offer/answer, mute, multi-peer)
+- **RTMP/HLS ingest** — live stream audio reception
+- **AudioWorklet migration** — full AudioWorklet pipeline with ScriptProcessorNode fallback
+- **NiceStreamingVisualizer** — real-time frequency/waveform from microphone
+- **NiceVoiceChatOverlay** — embeddable widget with mic toggle, participant avatars, speaking indicators
+
+### Tests
+
+- 24 tests: karaoke scoring, AudioWorklet, multitrack export, effects rack, sample browser, shortcut manager, DMX timeline
+- Audio latency benchmark (mic → effect → output)
+
+---
+
+## [0.1.0] — 2025-06-01
+
+Initial beta release — DAW editor, karaoke engine, player, playlist, visualizers, MIDI, DMX.
+
+- DAW-style multitrack editor (tracks, clips, timeline, piano roll)
+- Karaoke engine (UltraStar format, pitch detection, scoring, leaderboard)
+- Audio player with playlist and waveform visualization
+- 5 visualizer modes (bars, waveform, circle, mirror bars, spectrum)
+- MIDI input/output with Web MIDI API
+- Vocal effects engine (reverb, pitch shift, harmonizer)
 
 All notable changes to `@nice2dev/ui-audio` will be documented in this file.
 
@@ -7,6 +81,148 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [0.2.0] — 2026-06-16
+
+### 🎶 Massive Expansion — Playlists, Radio, Visualizers & Production Tools
+
+### Radio
+
+- **NiceRadioPlayer** — internet radio player with stream metadata, station presets, and buffering indicator
+
+### Karaoke Editor
+
+- **KaraokeEditorManager** — full karaoke project editor with timeline, word sync, and preview
+- **KaraokePhaserRenderer** — Phaser.js-based karaoke rendering with visual effects
+- Extended karaoke sub-components: `AudioPitchAnalyzer`, `BarFillEditor`, `KaraokeLyrics`, `KaraokeTimeline`
+- Rendering pipeline with scene management and real-time scoring display
+
+### Playlist System (`playlist/`)
+
+- **PlaylistBrowser** — browse and discover playlists with search and filters
+- **PlaylistDualPane** — dual-pane playlist manager with drag-and-drop between lists
+- **PlaylistGridView** — card grid layout for playlist browsing
+- **PlaylistImportWizard** — import playlists from multiple sources (Spotify, YouTube, files)
+- **PlaylistList** — compact list view with inline editing
+- **PlaylistOverview** — playlist detail view with cover art, stats, and controls
+- **PlaylistSearchBar** — search and filter bar for track finding
+- **PlaylistSidebar** — sidebar with playlist navigation and categories
+- **PlaylistTagEditor** — tag management for playlist organization
+- **PlaylistTrackList** — track listing with sorting, reordering, and metadata
+- **GenericPlaylist / GenericPlaylistItem** — base playlist components
+- **DynamicRuleEditor** — smart/dynamic playlist rule builder (genre, BPM, mood, date, etc.)
+- `useLocalPlaylists` — local storage playlist persistence hook
+
+### Visualizer Modes (21 modes)
+
+- **BarsMode** — classic equalizer bars
+- **BlobFlowMode** — organic blob flow animation
+- **ColorRipplesMode** — rippling color waves
+- **CoverMode** — album art with audio-reactive effects
+- **CozyFireplaceMode** — fireplace visualization
+- **EqualizerCircleMode** — circular equalizer
+- **GridMode** — frequency grid display
+- **ImageTornadoMode** — spinning image tornado
+- **LavaLampMode** — lava lamp fluid simulation
+- **NeonTrianglesMode** — neon triangle geometry
+- **OrbitalsMode** — orbital particle system
+- **PaletteMode** — palette-based color visualization
+- **ParticlesMode** — audio-reactive particles
+- **PlasmaBallMode** — plasma ball effect
+- **RadialMode** — radial spectrum display
+- **RaysMode** — light rays visualization
+- **RiftMode** — dimensional rift effect
+- **RingsMode** — concentric ring display
+- **SpectrumMode** — full spectrum analyzer
+- **StarfieldMode** — star-field warp effect
+- **WaveformMode** — waveform display
+- `ModeSwitcher`, `StageVisualizer`, `VuOverlay` — visualizer infrastructure
+
+### DAW Editor — New Panels
+
+- **ArpeggiatorPanel** — MIDI arpeggiator with pattern modes (up, down, random, etc.)
+- **CCAutomationLaneEditor** — CC automation lane editing with curves
+- **LFOPanel** — low-frequency oscillator for modulation
+- **StepSequencerPanel** — 16/32-step drum machine sequencer
+- **AdvancedEditingPanel** — advanced MIDI editing tools
+- **DisplayModeSelector** — switch between piano roll, drum, score views
+- **ProjectPanel** — project settings and metadata
+- **SectionPanel** — arrangement section management
+- **LayerTrack** — multi-layer audio track component
+- `AudioLayersNav`, `AudioProjectSectionNav`, `AudioTimelineNav` — navigation components
+- `SaveLoadControls` — save/load project controls
+
+### DAW Editor — New Hooks
+
+- `useAutoSave` — automatic project saving with interval and change detection
+- `usePlaybackEngine` — audio playback engine with transport controls
+- `useProjectCRUD` — project create/read/update/delete operations
+- `useRecording` — audio/MIDI recording with input selection
+
+### DAW Editor — Sub-components
+
+- `AudioClipBox`, `AudioClipInfo` — clip display and info
+- `AudioLayerDetails`, `AudioSourceDetails` — detail panels
+- `AudioMiniMap` — project overview minimap
+- `AudioTimeline` — timeline ruler with markers
+- `PianoRoll` — MIDI note editing with velocity
+- `Waveform` — audio waveform rendering
+- `CCLane`, `CCLaneSelector` — CC lane components
+
+### Visual Effects
+
+- **NoteParticles** — particle effects triggered by MIDI notes
+- **NoteRiver** — continuous note river visualization
+- `noteThemeColors` — theming for note-based visual effects
+
+### Audio Engine
+
+- `audioContext.ts` — Web Audio context management
+- `audioKeyboard.ts` — MIDI keyboard input mapping
+- `audioPlaybackEngine.ts` — multi-track playback engine
+- `audioProject.ts` — project data model
+- `audioSource.ts` — audio source management
+- `audioTimeline.ts` — timeline and transport
+- `instrumentPresets.ts` — built-in instrument presets (piano, strings, synth, drums)
+- `simpleSynth.ts` — basic synthesizer engine
+- `recording.ts` — recording pipeline
+- `pitch-worklet-processor.ts` — AudioWorklet for real-time pitch detection
+
+### Audio Utilities (~50 modules)
+
+- `arpeggiator.ts` — arpeggiator engine
+- `chordScale.ts` — chord and scale detection/generation
+- `clipLauncher.ts` — Ableton-style clip launcher
+- `envelopeFollower.ts` — envelope follower for sidechain
+- `grooveTemplates.ts` — swing/groove templates
+- `lfoEngine.ts` — LFO modulation engine
+- `stepSequencer.ts` — step sequencer engine
+- `vocalEffectsEngine.ts` — vocal processing effects (autotune, harmonizer, vocoder)
+- `vocalPerformanceMetrics.ts` — vocal performance analysis
+- `macroSystem.ts` — macro control system
+- `gameAudio.ts` — game audio integration utilities
+- And many more utility modules
+
+### Hooks
+
+- `useCCAutomation` — CC automation state management
+- `useStepSequencer` — step sequencer integration hook
+
+### Workers
+
+- `pitchWorker.ts` — Web Worker for pitch detection
+- `scoringWorker.ts` — Web Worker for karaoke scoring
+
+### Data Models
+
+- `modelsAiAudio.ts` — AI-assisted audio generation types
+- `modelsAiVideo.ts` — AI-assisted video/music video types
+- `modelsGame.ts` — game audio integration types
+- `modelsMusicPlatform.ts` — music platform integration types
+- `modelsPlatforms.ts` — platform/streaming types
+- `modelsPlaylistManager.ts` — playlist manager data models
+
+---
+
 ## [0.1.0] — 2026-03-17
 
 ### 🎵 Initial Release (Beta)

package/dist/__benchmarks__/audio-latency.bench.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=audio-latency.bench.d.ts.map

package/dist/__benchmarks__/audio-latency.bench.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-latency.bench.d.ts","sourceRoot":"","sources":["../../src/__benchmarks__/audio-latency.bench.ts"],"names":[],"mappings":""}

package/dist/constants/index.d.ts

@@ -0,0 +1,6 @@
+export * from './audioColors';
+export * from './debugKaraoke';
+export * from './karaokeScoringConfig';
+export * from './playerColors';
+export * from './ui';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AACA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,MAAM,CAAC"}

package/dist/constants/karaokeScoringConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"karaokeScoringConfig.d.ts","sourceRoot":"","sources":["../../src/constants/karaokeScoringConfig.ts"],"names":[],"mappings":"AAA2C,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpG,MAAM,WAAW,aAAa;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,eAAe,EAAE,aAAa,CAIxE,CAAC;AAoCF,eAAO,IAAI,cAAc,wCAAiB,CAAC;AAG3C,UAAU,4BAA4B;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;CACpE;AAED,eAAO,MAAM,wBAAwB,GAAU,UAAU;IAAE,uBAAuB,EAAE,MAAM,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAAA;CAAE,oDAkBvI,CAAC;AAEF,eAAe,cAAc,CAAC;AAG9B,eAAO,MAAM,gBAAgB,GAAI,QAAO,eAA0B,KAAG,aAEpE,CAAC"}
+{"version":3,"file":"karaokeScoringConfig.d.ts","sourceRoot":"","sources":["../../src/constants/karaokeScoringConfig.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,aAAa;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,eAAe,EAAE,aAAa,CAIxE,CAAC;AAoCF,eAAO,IAAI,cAAc,wCAAiB,CAAC;AAG3C,UAAU,4BAA4B;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;CACpE;AAED,eAAO,MAAM,wBAAwB,aAAoB;IAAE,uBAAuB,EAAE,MAAM,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAAA;CAAE,oDAkBvI,CAAC;AAEF,eAAe,cAAc,CAAC;AAG9B,eAAO,MAAM,gBAAgB,WAAW,eAAe,KAAc,aAEpE,CAAC"}

package/dist/core/NiceAudioErrorBoundary.d.ts

@@ -0,0 +1,28 @@
+import { default as React, Component } from 'react';
+/** Props for {@link NiceAudioErrorBoundary}. */
+export interface NiceAudioErrorBoundaryProps {
+    /** Fallback UI to render on error. */
+    fallback?: React.ReactNode | ((error: Error, reset: () => void) => React.ReactNode);
+    /** Called when an error is caught. */
+    onError?: (error: Error, errorInfo: React.ErrorInfo) => void;
+    /** Component name for logging context. */
+    componentName?: string;
+    children: React.ReactNode;
+}
+interface State {
+    hasError: boolean;
+    error: Error | null;
+}
+/**
+ * Error boundary for audio components (Editor, Player, Karaoke).
+ * Catches render errors and provides recovery UI with a retry button.
+ */
+export declare class NiceAudioErrorBoundary extends Component<NiceAudioErrorBoundaryProps, State> {
+    state: State;
+    static getDerivedStateFromError(error: Error): State;
+    componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void;
+    private reset;
+    render(): string | number | boolean | Iterable<React.ReactNode> | import("react/jsx-runtime").JSX.Element;
+}
+export {};
+//# sourceMappingURL=NiceAudioErrorBoundary.d.ts.map

package/dist/core/NiceAudioErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NiceAudioErrorBoundary.d.ts","sourceRoot":"","sources":["../../src/core/NiceAudioErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIzC,gDAAgD;AAChD,MAAM,WAAW,2BAA2B;IAC1C,sCAAsC;IACtC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,IAAI,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC;IACpF,sCAAsC;IACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;IAC7D,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,UAAU,KAAK;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAID;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,SAAS,CAAC,2BAA2B,EAAE,KAAK,CAAC;IACvF,KAAK,EAAE,KAAK,CAAoC;IAEhD,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,KAAK;IAIpD,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI;IAMjE,OAAO,CAAC,KAAK,CAEX;IAEF,MAAM;CA6BP"}

package/dist/editor/NiceSampleBrowser.d.ts

@@ -0,0 +1,79 @@
+import { default as React } from 'react';
+export interface AudioSample {
+    id: string;
+    name: string;
+    path: string;
+    url?: string;
+    duration: number;
+    sampleRate: number;
+    channels: number;
+    fileSize: number;
+    format: 'wav' | 'mp3' | 'ogg' | 'flac' | 'aiff';
+    waveformData?: Float32Array;
+    bpm?: number;
+    key?: MusicalKey;
+    tags?: string[];
+    favorite?: boolean;
+    dateAdded?: Date;
+    dateModified?: Date;
+}
+export type MusicalKey = 'C' | 'C#' | 'D' | 'D#' | 'E' | 'F' | 'F#' | 'G' | 'G#' | 'A' | 'A#' | 'B' | 'Cm' | 'C#m' | 'Dm' | 'D#m' | 'Em' | 'Fm' | 'F#m' | 'Gm' | 'G#m' | 'Am' | 'A#m' | 'Bm';
+export interface SampleFolder {
+    id: string;
+    name: string;
+    path: string;
+    children?: SampleFolder[];
+    samples?: AudioSample[];
+}
+export interface SampleAnalysis {
+    bpm: number;
+    bpmConfidence: number;
+    key: MusicalKey;
+    keyConfidence: number;
+    waveformData: Float32Array;
+    peakLevel: number;
+    rmsLevel: number;
+    transients: number[];
+}
+export interface NiceSampleBrowserProps {
+    folders?: SampleFolder[];
+    samples?: AudioSample[];
+    onSampleSelect?: (sample: AudioSample) => void;
+    onSampleDragStart?: (sample: AudioSample, event: React.DragEvent) => void;
+    onSampleDrop?: (sample: AudioSample, targetId: string) => void;
+    onFolderSelect?: (folder: SampleFolder) => void;
+    onAnalyze?: (sample: AudioSample) => Promise<SampleAnalysis>;
+    audioContext?: AudioContext;
+    showWaveform?: boolean;
+    showAnalysis?: boolean;
+    sortBy?: 'name' | 'duration' | 'bpm' | 'key' | 'date';
+    sortDirection?: 'asc' | 'desc';
+    filterTags?: string[];
+    searchQuery?: string;
+    className?: string;
+}
+/**
+ * Detect BPM using onset detection and autocorrelation
+ */
+export declare function detectBPM(audioBuffer: AudioBuffer): Promise<{
+    bpm: number;
+    confidence: number;
+}>;
+/**
+ * Detect musical key using chromagram analysis
+ */
+export declare function detectKey(audioBuffer: AudioBuffer): Promise<{
+    key: MusicalKey;
+    confidence: number;
+}>;
+/**
+ * Generate waveform data for visualization
+ */
+export declare function generateWaveform(audioBuffer: AudioBuffer, numPoints?: number): Float32Array;
+/**
+ * Analyze an audio sample
+ */
+export declare function analyzeSample(audioBuffer: AudioBuffer): Promise<SampleAnalysis>;
+export declare const NiceSampleBrowser: React.FC<NiceSampleBrowserProps>;
+export default NiceSampleBrowser;
+//# sourceMappingURL=NiceSampleBrowser.d.ts.map

package/dist/editor/NiceSampleBrowser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NiceSampleBrowser.d.ts","sourceRoot":"","sources":["../../src/editor/NiceSampleBrowser.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAA4D,MAAM,OAAO,CAAC;AACjF,OAAO,yBAAyB,CAAC;AAGjC,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IAChD,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,YAAY,CAAC,EAAE,IAAI,CAAC;CACrB;AAED,MAAM,MAAM,UAAU,GAClB,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAC1E,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC;AAE3F,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,GAAG,EAAE,UAAU,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IAC/C,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC;IAC1E,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;IAChD,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7D,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IACtD,aAAa,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID;;GAEG;AACH,wBAAsB,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CA0DtG;AAWD;;GAEG;AACH,wBAAsB,SAAS,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAkE1G;AAID;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,SAAM,GAAG,YAAY,CAgBxF;AAID;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CA0CrF;AAsLD,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAoR9D,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/editor/Waveform.d.ts

@@ -1,8 +1,60 @@
 import { default as React } from 'react';
-interface WaveformProps {
+/** Marker on the waveform timeline */
+export interface WaveformMarker {
+    id: string;
+    time: number;
+    label?: string;
+    color?: string;
+}
+/** A region (selection range) on the waveform */
+export interface WaveformRegion {
+    id: string;
+    start: number;
+    end: number;
+    label?: string;
+    color?: string;
+}
+/** Display mode for the waveform */
+export type WaveformDisplayMode = 'waveform' | 'spectrogram' | 'bars';
+export interface WaveformProps {
     audioBlob: Blob | null;
     currentTime: number;
     duration: number;
+    /** Width in pixels (default 600) */
+    width?: number;
+    /** Height in pixels (default 200) */
+    height?: number;
+    /** Zoom level (1 = fit-to-width, 2 = 2x zoom, etc.) */
+    zoom?: number;
+    /** Called when user clicks on waveform to seek */
+    onSeek?: (time: number) => void;
+    /** Called when user selects a region by dragging */
+    onRegionSelect?: (region: {
+        start: number;
+        end: number;
+    }) => void;
+    /** Markers on the timeline */
+    markers?: WaveformMarker[];
+    /** Regions on the timeline */
+    regions?: WaveformRegion[];
+    /** Display mode */
+    displayMode?: WaveformDisplayMode;
+    /** Show all channels (true) or only channel 0 (false, default) */
+    multiChannel?: boolean;
+    /** Waveform color */
+    waveColor?: string;
+    /** Progress overlay color */
+    progressColor?: string;
+    /** Background color */
+    backgroundColor?: string;
+    /** Show time ruler at top */
+    showRuler?: boolean;
+    /** Show channel labels (L/R) for multi-channel */
+    showChannelLabels?: boolean;
+    /** Show dB meter on the right side */
+    showPeakMeter?: boolean;
+    /** CSS class name */
+    className?: string;
 }
 declare const Waveform: React.FC<WaveformProps>;
 export default Waveform;

package/dist/editor/Waveform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Waveform.d.ts","sourceRoot":"","sources":["../../src/editor/Waveform.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAClB,UAAU,aAAa;IAClD,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,QAAA,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CAkErC,CAAC;AAEF,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"Waveform.d.ts","sourceRoot":"","sources":["../../src/editor/Waveform.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAKjF,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,oCAAoC;AACpC,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,aAAa,GAAG,MAAM,CAAC;AAEtE,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,oDAAoD;IACpD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAClE,8BAA8B;IAC9B,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,mBAAmB;IACnB,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,kEAAkE;IAClE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uBAAuB;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kDAAkD;IAClD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,sCAAsC;IACtC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,qBAAqB;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAID,QAAA,MAAM,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC,aAAa,CAyRrC,CAAC;AA+EF,eAAe,QAAQ,CAAC"}

package/dist/editor/hooks/useProjectCRUD.d.ts.map

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

package/dist/editor/nav/SaveLoadControls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SaveLoadControls.d.ts","sourceRoot":"","sources":["../../../src/editor/nav/SaveLoadControls.tsx"],"names":[],"mappings":"AACA,OAAO,KAAiB,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAClB,UAAU,qBAAqB;IAClE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;CAClD;;AAwDD,wBAA4C"}
+{"version":3,"file":"SaveLoadControls.d.ts","sourceRoot":"","sources":["../../../src/editor/nav/SaveLoadControls.tsx"],"names":[],"mappings":"AACA,OAAO,KAAiB,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEX,UAAU,qBAAqB;IACzE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;CAClD;;AAwDD,wBAA4C"}

package/dist/editor/useEditorRecording.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useEditorRecording.d.ts","sourceRoot":"","sources":["../../src/editor/useEditorRecording.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAChC,MAAM,WAAW,wBAAwB;IAC9E,WAAW,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,gBAAgB,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IAC7D,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACzC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC7C,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,KAAK,IAAI,CAAC;IAC1E,CAAC,EAAE,eAAe,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IAC9D,aAAa,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;IACtE,eAAe,EAAE,QAAQ,CAAC,cAAc,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IACtF,YAAY,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACrE,gBAAgB,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,aAAa,EAAE,QAAQ,CAAC,cAAc,CAAC,SAAS,GAAG,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC;CACrE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,wBAAwB;;;;;;;;;;;;;;;EA+LlE"}
+{"version":3,"file":"useEditorRecording.d.ts","sourceRoot":"","sources":["../../src/editor/useEditorRecording.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAGzE,MAAM,WAAW,wBAAwB;IACrC,WAAW,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,gBAAgB,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAAC;IAC7D,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACzC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC7C,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,KAAK,IAAI,CAAC;IAC1E,CAAC,EAAE,eAAe,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC;IAC9D,aAAa,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;IACtE,eAAe,EAAE,QAAQ,CAAC,cAAc,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IACtF,YAAY,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACrE,gBAAgB,EAAE,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IACnD,aAAa,EAAE,QAAQ,CAAC,cAAc,CAAC,SAAS,GAAG,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC;CACrE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,wBAAwB;;;;;;;;;;;;;;;EA+LlE"}

package/dist/engine/NiceAudioEffects.d.ts

@@ -0,0 +1,186 @@
+/**
+ * NiceAudioEffects — Audio effects processing chain
+ *
+ * Includes:
+ * - Gain
+ * - Compressor
+ * - Reverb (convolution)
+ * - Delay
+ * - Chorus
+ * - EQ (parametric/graphic)
+ * - Filter (low/high pass)
+ * - Distortion
+ * - Tremolo
+ * - Phaser
+ */
+export type EffectType = 'gain' | 'compressor' | 'reverb' | 'delay' | 'chorus' | 'eq' | 'filter' | 'distortion' | 'tremolo' | 'phaser';
+export interface BaseEffectParams {
+    enabled: boolean;
+    mix: number;
+    /** Additional dynamic parameters for UI controls */
+    params?: Record<string, number>;
+}
+export interface GainParams extends BaseEffectParams {
+    type: 'gain';
+    gain: number;
+}
+export interface CompressorParams extends BaseEffectParams {
+    type: 'compressor';
+    threshold: number;
+    ratio: number;
+    attack: number;
+    release: number;
+    knee: number;
+    makeupGain: number;
+}
+export interface ReverbParams extends BaseEffectParams {
+    type: 'reverb';
+    decay: number;
+    preDelay: number;
+    damping: number;
+    roomSize: number;
+}
+export interface DelayParams extends BaseEffectParams {
+    type: 'delay';
+    time: number;
+    feedback: number;
+    pingPong: boolean;
+    highCut: number;
+}
+export interface ChorusParams extends BaseEffectParams {
+    type: 'chorus';
+    rate: number;
+    depth: number;
+    delay: number;
+    voices: number;
+}
+export interface EQBand {
+    frequency: number;
+    gain: number;
+    q: number;
+    type: BiquadFilterType;
+}
+export interface EQParams extends BaseEffectParams {
+    type: 'eq';
+    bands: EQBand[];
+}
+export interface FilterParams extends BaseEffectParams {
+    type: 'filter';
+    filterType: BiquadFilterType;
+    frequency: number;
+    q: number;
+    gain: number;
+}
+export interface DistortionParams extends BaseEffectParams {
+    type: 'distortion';
+    drive: number;
+    tone: number;
+    curve: 'soft' | 'hard' | 'fuzz' | 'tube';
+}
+export interface TremoloParams extends BaseEffectParams {
+    type: 'tremolo';
+    rate: number;
+    depth: number;
+    waveform: OscillatorType;
+}
+export interface PhaserParams extends BaseEffectParams {
+    type: 'phaser';
+    rate: number;
+    depth: number;
+    feedback: number;
+    stages: number;
+    frequency: number;
+}
+export type EffectParams = GainParams | CompressorParams | ReverbParams | DelayParams | ChorusParams | EQParams | FilterParams | DistortionParams | TremoloParams | PhaserParams;
+export interface EffectInstance {
+    id: string;
+    params: EffectParams;
+    nodes: AudioNode[];
+    input: AudioNode;
+    output: AudioNode;
+}
+export declare const DEFAULT_GAIN: GainParams;
+export declare const DEFAULT_COMPRESSOR: CompressorParams;
+export declare const DEFAULT_REVERB: ReverbParams;
+export declare const DEFAULT_DELAY: DelayParams;
+export declare const DEFAULT_CHORUS: ChorusParams;
+export declare const DEFAULT_EQ: EQParams;
+export declare const DEFAULT_FILTER: FilterParams;
+export declare const DEFAULT_DISTORTION: DistortionParams;
+export declare const DEFAULT_TREMOLO: TremoloParams;
+export declare const DEFAULT_PHASER: PhaserParams;
+export declare const EFFECT_PRESETS: Record<EffectType, Record<string, EffectParams>>;
+/**
+ * Convert dB to linear gain
+ */
+export declare function dbToGain(db: number): number;
+/**
+ * Convert linear gain to dB
+ */
+export declare function gainToDb(gain: number): number;
+/**
+ * Generate impulse response for convolution reverb
+ */
+export declare function generateImpulseResponse(audioContext: BaseAudioContext, duration: number, decay: number, damping: number): AudioBuffer;
+/**
+ * Generate distortion curve
+ */
+export declare function makeDistortionCurve(amount: number, type: DistortionParams['curve']): Float32Array;
+export declare class NiceAudioEffectsChain {
+    private audioContext;
+    private effects;
+    private inputNode;
+    private outputNode;
+    private bypass;
+    constructor(audioContext: BaseAudioContext);
+    /**
+     * Get the input node to connect audio source
+     */
+    get input(): AudioNode;
+    /**
+     * Get the output node to connect to destination
+     */
+    get output(): AudioNode;
+    /**
+     * Add an effect to the chain
+     */
+    addEffect(params: EffectParams, index?: number): string;
+    /**
+     * Remove an effect from the chain
+     */
+    removeEffect(id: string): boolean;
+    /**
+     * Update effect parameters
+     */
+    updateEffect(id: string, params: Partial<EffectParams>): boolean;
+    /**
+     * Reorder effects in the chain
+     */
+    reorderEffects(fromIndex: number, toIndex: number): boolean;
+    /**
+     * Set bypass state
+     */
+    setBypass(bypass: boolean): void;
+    /**
+     * Get all effects
+     */
+    getEffects(): EffectInstance[];
+    /**
+     * Clear all effects
+     */
+    clear(): void;
+    /**
+     * Create effect instance based on params
+     */
+    private createEffectInstance;
+    /**
+     * Reconnect the audio chain
+     */
+    private reconnectChain;
+    /**
+     * Dispose of all resources
+     */
+    dispose(): void;
+}
+export default NiceAudioEffectsChain;
+//# sourceMappingURL=NiceAudioEffects.d.ts.map

package/dist/engine/NiceAudioEffects.d.ts.map

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