@nice2dev/ui-audio 0.1.0 → 1.0.3

package/dist/streaming/webrtcAudio.d.ts

@@ -0,0 +1,111 @@
+/**
+ * WebRTC Audio Utilities — P2P audio chat / jam session support
+ *
+ * Provides helpers for establishing peer-to-peer audio connections
+ * using WebRTC with ICE candidates, offer/answer negotiation, and
+ * audio stream handling.
+ *
+ * @module @nice2dev/ui-audio/streaming
+ */
+export interface WebRTCAudioConfig {
+    /** STUN/TURN servers for ICE negotiation */
+    iceServers?: RTCIceServer[];
+    /** Audio constraints for getUserMedia */
+    audioConstraints?: MediaTrackConstraints;
+    /** Enable echo cancellation (default: true) */
+    echoCancellation?: boolean;
+    /** Enable noise suppression (default: true) */
+    noiseSuppression?: boolean;
+    /** Enable auto gain control (default: true) */
+    autoGainControl?: boolean;
+}
+export interface PeerConnection {
+    id: string;
+    pc: RTCPeerConnection;
+    remoteStream: MediaStream | null;
+    state: RTCPeerConnectionState;
+}
+export interface SignalingMessage {
+    type: 'offer' | 'answer' | 'ice-candidate' | 'leave';
+    from: string;
+    to: string;
+    payload: RTCSessionDescriptionInit | RTCIceCandidateInit | null;
+}
+export type OnRemoteStreamCallback = (peerId: string, stream: MediaStream) => void;
+export type OnPeerStateChangeCallback = (peerId: string, state: RTCPeerConnectionState) => void;
+export type OnSignalingMessageCallback = (message: SignalingMessage) => void;
+/**
+ * Manages WebRTC peer-to-peer audio connections for voice chat / jam sessions.
+ *
+ * @example
+ * ```tsx
+ * const manager = new WebRTCAudioManager({ iceServers: [...] });
+ * await manager.initialize();
+ *
+ * manager.onRemoteStream = (peerId, stream) => {
+ *   // Attach stream to <audio> element
+ * };
+ *
+ * manager.onSignalingMessage = (msg) => {
+ *   // Send to signaling server (WebSocket, SignalR, etc.)
+ *   socket.send(JSON.stringify(msg));
+ * };
+ *
+ * // When initiating a call:
+ * await manager.createOffer('peer-123');
+ *
+ * // When receiving signaling messages:
+ * manager.handleSignalingMessage(incomingMessage);
+ * ```
+ */
+export declare class WebRTCAudioManager {
+    private localStream;
+    private peers;
+    private config;
+    private localUserId;
+    /** Callback when a remote peer's audio stream is available */
+    onRemoteStream: OnRemoteStreamCallback | null;
+    /** Callback when a peer's connection state changes */
+    onPeerStateChange: OnPeerStateChangeCallback | null;
+    /** Callback when a signaling message needs to be sent */
+    onSignalingMessage: OnSignalingMessageCallback | null;
+    constructor(localUserId: string, config?: WebRTCAudioConfig);
+    /** Initialize local audio stream (must be called before creating connections) */
+    initialize(): Promise<MediaStream>;
+    /** Get the local audio stream */
+    getLocalStream(): MediaStream | null;
+    /** Get all connected peer IDs */
+    getPeerIds(): string[];
+    /** Get a peer's connection state */
+    getPeerState(peerId: string): RTCPeerConnectionState | null;
+    /** Create a new peer connection and send an offer */
+    createOffer(peerId: string): Promise<void>;
+    /** Handle an incoming signaling message */
+    handleSignalingMessage(message: SignalingMessage): Promise<void>;
+    /** Disconnect from a specific peer */
+    removePeer(peerId: string): void;
+    /** Disconnect from all peers and release local stream */
+    disconnect(): void;
+    /** Mute/unmute local audio */
+    setMuted(muted: boolean): void;
+    /** Check if local audio is muted */
+    isMuted(): boolean;
+    private createPeerConnection;
+    private handleOffer;
+    private handleAnswer;
+    private handleIceCandidate;
+    private sendSignalingMessage;
+}
+/**
+ * Check if WebRTC is supported in the current browser.
+ */
+export declare function isWebRTCSupported(): boolean;
+/**
+ * Enumerate available audio input devices.
+ */
+export declare function getAudioInputDevices(): Promise<MediaDeviceInfo[]>;
+/**
+ * Create an audio context with optimal settings for voice chat.
+ */
+export declare function createVoiceChatAudioContext(): AudioContext;
+//# sourceMappingURL=webrtcAudio.d.ts.map

package/dist/streaming/webrtcAudio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webrtcAudio.d.ts","sourceRoot":"","sources":["../../src/streaming/webrtcAudio.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IACzC,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,+CAA+C;IAC/C,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,iBAAiB,CAAC;IACtB,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,KAAK,EAAE,sBAAsB,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,eAAe,GAAG,OAAO,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,yBAAyB,GAAG,mBAAmB,GAAG,IAAI,CAAC;CACjE;AAED,MAAM,MAAM,sBAAsB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;AACnF,MAAM,MAAM,yBAAyB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC;AAChG,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAuB7E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,WAAW,CAAS;IAE5B,8DAA8D;IACvD,cAAc,EAAE,sBAAsB,GAAG,IAAI,CAAQ;IAC5D,sDAAsD;IAC/C,iBAAiB,EAAE,yBAAyB,GAAG,IAAI,CAAQ;IAClE,yDAAyD;IAClD,kBAAkB,EAAE,0BAA0B,GAAG,IAAI,CAAQ;gBAExD,WAAW,EAAE,MAAM,EAAE,MAAM,GAAE,iBAAsB;IAa/D,iFAAiF;IAC3E,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IAWxC,iCAAiC;IACjC,cAAc,IAAI,WAAW,GAAG,IAAI;IAIpC,iCAAiC;IACjC,UAAU,IAAI,MAAM,EAAE;IAItB,oCAAoC;IACpC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI;IAI3D,qDAAqD;IAC/C,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBhD,2CAA2C;IACrC,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBtE,sCAAsC;IACtC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAQhC,yDAAyD;IACzD,UAAU,IAAI,IAAI;IAwBlB,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IAQ9B,oCAAoC;IACpC,OAAO,IAAI,OAAO;IAUlB,OAAO,CAAC,oBAAoB;YAuDd,WAAW;YAmBX,YAAY;YAOZ,kBAAkB;IAOhC,OAAO,CAAC,oBAAoB;CAG7B;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAM3C;AAED;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAGvE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,YAAY,CAK1D"}

package/dist/ui-audio.css

@@ -1 +1 @@
-._panelNarrow_se2i3_3{max-width:520px}._panelWide_se2i3_9{max-width:820px}._smallLabel_se2i3_19{font-size:12px}._noteText_se2i3_29{font-size:13px;color:#888}._buttonRow_se2i3_41{display:flex;gap:8px}._noteTextMargin_se2i3_49{font-size:13px;color:#888;margin-top:4px}._rangeW100_se2i3_63{width:100px}._zoomValue_se2i3_69{font-size:12px;min-width:35px}._selectW100_se2i3_77{width:100px}._inputW70_se2i3_83{width:70px}._masterVolGroup_se2i3_93{min-width:min(220px,100%)}._rangeW140_se2i3_99{width:140px}._volumeValue_se2i3_105{font-size:12px;width:42px;text-align:right}._selectW140_se2i3_115{width:140px}._freqGroup_se2i3_121{min-width:min(200px,100%)}._freqValue_se2i3_127{font-size:12px;width:60px;text-align:right}._narrowGroup_se2i3_137{min-width:min(170px,100%)}._rangeW120_se2i3_143{width:120px}._smallValue_se2i3_149{font-size:12px;width:40px;text-align:right}._presetDivider_se2i3_159{border-top:1px solid #444}._presetLabel_se2i3_165{font-size:11px;font-weight:600;color:#aaa}._presetBtn_se2i3_175{font-size:11px;padding:2px 8px}._deletePresetSelect_se2i3_183{width:140px;font-size:11px}._presetNameInput_se2i3_191{width:160px;font-size:11px}._savePresetBtn_se2i3_199{font-size:11px;padding:2px 10px}._countInAlert_se2i3_211{font-size:12px;color:#f57c00}._inputW80_se2i3_219{width:80px}._levelLabel_se2i3_225{font-size:12px;color:#555}._levelMeter_se2i3_233{position:relative;background:#f1f1f1;height:12px;border-radius:6px;overflow:hidden;width:80px}._levelBar_se2i3_249{position:absolute;left:0;top:0;bottom:0;transition:width 80ms linear}
+._panelNarrow_se2i3_3{max-width:520px}._panelWide_se2i3_9{max-width:820px}._smallLabel_se2i3_19{font-size:12px}._noteText_se2i3_29{font-size:13px;color:#888}._buttonRow_se2i3_41{display:flex;gap:8px}._noteTextMargin_se2i3_49{font-size:13px;color:#888;margin-top:4px}._rangeW100_se2i3_63{width:100px}._zoomValue_se2i3_69{font-size:12px;min-width:35px}._selectW100_se2i3_77{width:100px}._inputW70_se2i3_83{width:70px}._masterVolGroup_se2i3_93{min-width:min(220px,100%)}._rangeW140_se2i3_99{width:140px}._volumeValue_se2i3_105{font-size:12px;width:42px;text-align:right}._selectW140_se2i3_115{width:140px}._freqGroup_se2i3_121{min-width:min(200px,100%)}._freqValue_se2i3_127{font-size:12px;width:60px;text-align:right}._narrowGroup_se2i3_137{min-width:min(170px,100%)}._rangeW120_se2i3_143{width:120px}._smallValue_se2i3_149{font-size:12px;width:40px;text-align:right}._presetDivider_se2i3_159{border-top:1px solid #444}._presetLabel_se2i3_165{font-size:11px;font-weight:600;color:#aaa}._presetBtn_se2i3_175{font-size:11px;padding:2px 8px}._deletePresetSelect_se2i3_183{width:140px;font-size:11px}._presetNameInput_se2i3_191{width:160px;font-size:11px}._savePresetBtn_se2i3_199{font-size:11px;padding:2px 10px}._countInAlert_se2i3_211{font-size:12px;color:#f57c00}._inputW80_se2i3_219{width:80px}._levelLabel_se2i3_225{font-size:12px;color:#555}._levelMeter_se2i3_233{position:relative;background:#f1f1f1;height:12px;border-radius:6px;overflow:hidden;width:80px}._levelBar_se2i3_249{position:absolute;left:0;top:0;bottom:0;transition:width 80ms linear}.nice-dmx-timeline{display:flex;flex-direction:column;height:100%;min-height:300px;background:linear-gradient(to bottom,#1a1a2e,#0f0f1a);border-radius:8px;overflow:hidden;color:#e0e0e0;font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,sans-serif;font-size:13px}.nice-dmx-timeline__toolbar{display:flex;align-items:center;gap:16px;padding:8px 12px;background:#0000004d;border-bottom:1px solid rgba(255,255,255,.1)}.nice-dmx-timeline__transport{display:flex;gap:4px}.nice-dmx-timeline__transport button{width:32px;height:32px;display:flex;align-items:center;justify-content:center;background:#8b5cf64d;border:none;border-radius:4px;color:#fff;cursor:pointer;font-size:14px;transition:all .15s}.nice-dmx-timeline__transport button:hover{background:#8b5cf680}.nice-dmx-timeline__transport button:active{transform:scale(.95)}.nice-dmx-timeline__time{font-family:Consolas,Monaco,monospace;font-size:18px;font-weight:600;color:#22d3ee;min-width:100px}.nice-dmx-timeline__tools{display:flex;align-items:center;gap:4px}.nice-dmx-timeline__tools button{width:28px;height:28px;display:flex;align-items:center;justify-content:center;background:#ffffff1a;border:none;border-radius:4px;color:#aaa;cursor:pointer;transition:all .15s}.nice-dmx-timeline__tools button:hover{background:#fff3;color:#fff}.nice-dmx-timeline__tools button.active{background:#8b5cf666;color:#fff}.nice-dmx-timeline__zoom{font-size:11px;color:#888;min-width:40px;text-align:center}.nice-dmx-timeline__bpm{display:flex;align-items:center;gap:6px;font-size:12px;color:#888}.nice-dmx-timeline__bpm span{color:#f472b6;font-weight:600}.nice-dmx-timeline__blackout{margin-left:auto;padding:6px 12px;background:#ef44444d;border:none;border-radius:4px;color:#fff;cursor:pointer;font-size:14px;transition:all .15s}.nice-dmx-timeline__blackout:hover{background:#ef444480}.nice-dmx-timeline__content{flex:1;display:flex;overflow:hidden}.nice-dmx-timeline__headers{width:180px;min-width:150px;background:#0003;border-right:1px solid rgba(255,255,255,.1);overflow-y:auto;padding-top:32px}.nice-dmx-timeline__header{display:flex;align-items:center;gap:8px;height:48px;padding:0 12px;border-bottom:1px solid rgba(255,255,255,.05);cursor:pointer;transition:background .15s}.nice-dmx-timeline__header:hover{background:#8b5cf61a}.nice-dmx-timeline__header--selected{background:#8b5cf633}.nice-dmx-timeline__track-color{width:8px;height:8px;border-radius:50%}.nice-dmx-timeline__track-name{flex:1;font-weight:500;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.nice-dmx-timeline__track-controls{display:flex;gap:4px}.nice-dmx-timeline__track-controls button{width:20px;height:20px;display:flex;align-items:center;justify-content:center;background:#ffffff1a;border:none;border-radius:3px;color:#888;cursor:pointer;font-size:10px;transition:all .15s}.nice-dmx-timeline__track-controls button:hover{background:#fff3;color:#fff}.nice-dmx-timeline__track-controls button.active{background:#ef444466;color:#fff}.nice-dmx-timeline__add-track{width:100%;padding:12px;background:none;border:none;border-top:1px dashed rgba(255,255,255,.1);color:#666;cursor:pointer;text-align:center;transition:all .15s}.nice-dmx-timeline__add-track:hover{background:#8b5cf61a;color:#8b5cf6}.nice-dmx-timeline__tracks{flex:1;overflow:auto;position:relative}.nice-dmx-timeline__ruler{position:sticky;top:0;height:32px;background:#0006;border-bottom:1px solid rgba(255,255,255,.1);z-index:10}.nice-dmx-timeline__beat{position:absolute;top:0;bottom:0;width:1px;background:#ffffff1a}.nice-dmx-timeline__beat--measure{background:#ffffff4d}.nice-dmx-timeline__beat-label{position:absolute;top:4px;left:4px;font-size:10px;color:#888}.nice-dmx-timeline__track{position:relative;height:48px;border-bottom:1px solid rgba(255,255,255,.05);background:linear-gradient(90deg,rgba(255,255,255,.02) 0%,transparent 1px,transparent 100%);background-size:100px 100%}.nice-dmx-timeline__track--muted{opacity:.4}.nice-dmx-timeline__cue{position:absolute;top:4px;height:calc(100% - 8px);border-radius:4px;cursor:pointer;overflow:hidden;transition:box-shadow .15s}.nice-dmx-timeline__cue:hover{box-shadow:0 0 0 2px #ffffff4d}.nice-dmx-timeline__cue--selected{box-shadow:0 0 0 2px #fff}.nice-dmx-timeline__cue-name{position:absolute;top:4px;left:6px;right:6px;font-size:11px;font-weight:500;color:#fff;text-shadow:0 1px 2px rgba(0,0,0,.5);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.nice-dmx-timeline__cue-fade{position:absolute;top:0;bottom:0;background:linear-gradient(to right,rgba(0,0,0,.8),transparent)}.nice-dmx-timeline__cue-fade--in{left:0}.nice-dmx-timeline__cue-fade--out{right:0;transform:scaleX(-1)}.nice-dmx-timeline__playhead{position:absolute;top:0;bottom:0;width:2px;background:#ef4444;z-index:20;pointer-events:none}.nice-dmx-timeline__playhead:before{content:"";position:absolute;top:0;left:50%;transform:translate(-50%);width:0;height:0;border-left:6px solid transparent;border-right:6px solid transparent;border-top:8px solid #ef4444}.nice-dmx-timeline__tracks::-webkit-scrollbar,.nice-dmx-timeline__headers::-webkit-scrollbar{width:8px;height:8px}.nice-dmx-timeline__tracks::-webkit-scrollbar-track,.nice-dmx-timeline__headers::-webkit-scrollbar-track{background:transparent}.nice-dmx-timeline__tracks::-webkit-scrollbar-thumb,.nice-dmx-timeline__headers::-webkit-scrollbar-thumb{background:#fff3;border-radius:4px}.nice-dmx-timeline__tracks::-webkit-scrollbar-thumb:hover,.nice-dmx-timeline__headers::-webkit-scrollbar-thumb:hover{background:#ffffff4d}@media(max-width:768px){.nice-dmx-timeline__toolbar{flex-wrap:wrap;gap:8px}.nice-dmx-timeline__headers{width:120px;min-width:100px}.nice-dmx-timeline__track-controls,.nice-dmx-timeline__bpm{display:none}}

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

@@ -1 +1 @@
-{"version":3,"file":"BaseStreamClient.d.ts","sourceRoot":"","sources":["../../src/utils/BaseStreamClient.ts"],"names":[],"mappings":"AAWA,wBAAgB,cAAc,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAahG;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,CAOjE;AAID,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,+FAA+F;IAC/F,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAOD;;;;;;;;;GASG;AACH,8BAAsB,gBAAgB;IAElC,SAAS,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC;IACzB,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,cAAc,CAAC,CAAgC;IACvD,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,oBAAoB,CAAK;IAGjC,SAAS,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACpC,SAAS,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IAClC,OAAO,CAAC,WAAW,CAAC,CAAmB;IACvC,OAAO,CAAC,IAAI,CAAC,CAAsB;IACnC,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAS;IAG7B,SAAS,CAAC,MAAM,UAAS;IACzB,SAAS,CAAC,OAAO,UAAS;IAG1B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,aAAa,CAAK;IAE1B,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;gBAE/B,IAAI,EAAE,iBAAiB;IAMnC,2CAA2C;IAC3C,SAAS,CAAC,QAAQ,KAAK,GAAG,IAAI,MAAM,CAAC;IAErC,kEAAkE;IAClE,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAEtD,iFAAiF;IACjF,SAAS,CAAC,cAAc,IAAI,IAAI;IAKhC,yEAAyE;IACzE,SAAS,KAAK,UAAU,IAAI,OAAO,CAElC;IAED,gDAAgD;IAChD,SAAS,KAAK,WAAW,IAAI,MAAM,CAElC;IAID,SAAS,CAAC,EAAE,IAAI,MAAM;IAMtB,SAAS,CAAC,SAAS,IAAI,IAAI;IAgF3B,OAAO,CAAC,gBAAgB;YAqEV,eAAe;IA+B7B,SAAS,CAAC,cAAc,IAAI,IAAI;IAmB1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAY9D,IAAI,IAAI,IAAI;CAiBf"}
+{"version":3,"file":"BaseStreamClient.d.ts","sourceRoot":"","sources":["../../src/utils/BaseStreamClient.ts"],"names":[],"mappings":"AAYA,wBAAgB,cAAc,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAahG;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,CAOjE;AAID,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IACpC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,+FAA+F;IAC/F,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAOD;;;;;;;;;GASG;AACH,8BAAsB,gBAAgB;IAElC,SAAS,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC;IACzB,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,cAAc,CAAC,CAAgC;IACvD,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,oBAAoB,CAAK;IAGjC,SAAS,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACpC,SAAS,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IAClC,OAAO,CAAC,WAAW,CAAC,CAAmB;IACvC,OAAO,CAAC,IAAI,CAAC,CAAsB;IACnC,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAS;IAG7B,SAAS,CAAC,MAAM,UAAS;IACzB,SAAS,CAAC,OAAO,UAAS;IAG1B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,aAAa,CAAK;IAE1B,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;gBAE/B,IAAI,EAAE,iBAAiB;IAMnC,2CAA2C;IAC3C,SAAS,CAAC,QAAQ,KAAK,GAAG,IAAI,MAAM,CAAC;IAErC,kEAAkE;IAClE,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAEtD,iFAAiF;IACjF,SAAS,CAAC,cAAc,IAAI,IAAI;IAKhC,yEAAyE;IACzE,SAAS,KAAK,UAAU,IAAI,OAAO,CAElC;IAED,gDAAgD;IAChD,SAAS,KAAK,WAAW,IAAI,MAAM,CAElC;IAID,SAAS,CAAC,EAAE,IAAI,MAAM;IAMtB,SAAS,CAAC,SAAS,IAAI,IAAI;IAgF3B,OAAO,CAAC,gBAAgB;YAqEV,eAAe;IA+B7B,SAAS,CAAC,cAAc,IAAI,IAAI;IAmB1B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAWtB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAY9D,IAAI,IAAI,IAAI;CAiBf"}

package/dist/utils/audioDragDrop.d.ts

@@ -0,0 +1,72 @@
+/**
+ * audioDragDrop.ts — Drag-and-drop audio file import utilities.
+ *
+ * Features:
+ * - Validate dropped files (type, size, extension)
+ * - Extract audio metadata from dropped files
+ * - Create drop zone handlers
+ * - Support for multiple file drop
+ */
+export interface AudioDropResult {
+    file: File;
+    name: string;
+    extension: string;
+    sizeBytes: number;
+    mimeType: string;
+    duration?: number;
+    sampleRate?: number;
+    channels?: number;
+}
+export interface AudioDropValidation {
+    /** Maximum file size in bytes (default: 500MB) */
+    maxSize?: number;
+    /** Allowed MIME types (default: audio/*) */
+    allowedTypes?: string[];
+    /** Allowed extensions (without dot) */
+    allowedExtensions?: string[];
+    /** Max number of files in a single drop (default: 20) */
+    maxFiles?: number;
+}
+export interface AudioDropError {
+    file: File;
+    reason: "type" | "size" | "extension" | "decode" | "limit";
+    message: string;
+}
+export interface AudioDropEvent {
+    accepted: AudioDropResult[];
+    rejected: AudioDropError[];
+}
+/** Validate a list of files against audio constraints. */
+export declare function validateAudioFiles(files: File[], validation?: AudioDropValidation): {
+    valid: File[];
+    errors: AudioDropError[];
+};
+/** Decode an audio file and extract basic metadata (duration, channels, sampleRate). */
+export declare function probeAudioFile(file: File): Promise<AudioDropResult>;
+export interface DropZoneCallbacks {
+    onDrop: (event: AudioDropEvent) => void;
+    onDragEnter?: () => void;
+    onDragLeave?: () => void;
+    validation?: AudioDropValidation;
+    /** Whether to probe audio metadata (slower but provides duration/channels). */
+    probe?: boolean;
+}
+/**
+ * Create event handlers for a drag-and-drop zone.
+ * Returns props to spread on a container element.
+ */
+export declare function createDropZoneHandlers(callbacks: DropZoneCallbacks): {
+    onDragEnter: (e: React.DragEvent | DragEvent) => void;
+    onDragOver: (e: React.DragEvent | DragEvent) => void;
+    onDragLeave: (e: React.DragEvent | DragEvent) => void;
+    onDrop: (e: React.DragEvent | DragEvent) => Promise<void>;
+};
+/**
+ * Open a file picker dialog for audio files.
+ * Returns selected files (same validation as drop zone).
+ */
+export declare function openAudioFilePicker(options?: {
+    multiple?: boolean;
+    validation?: AudioDropValidation;
+}): Promise<AudioDropEvent>;
+//# sourceMappingURL=audioDragDrop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audioDragDrop.d.ts","sourceRoot":"","sources":["../../src/utils/audioDragDrop.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,uCAAuC;IACvC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC3D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAkDD,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,IAAI,EAAE,EACb,UAAU,GAAE,mBAAwB,GACnC;IAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAAC,MAAM,EAAE,cAAc,EAAE,CAAA;CAAE,CA+B7C;AAMD,wFAAwF;AACxF,wBAAsB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC,CAqBzE;AAMD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,+EAA+E;IAC/E,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,iBAAiB;qBAI9C,KAAK,CAAC,SAAS,GAAG,SAAS;oBAO5B,KAAK,CAAC,SAAS,GAAG,SAAS;qBAU1B,KAAK,CAAC,SAAS,GAAG,SAAS;gBAO1B,KAAK,CAAC,SAAS,GAAG,SAAS;EAoChD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,mBAAmB,CAAA;CAAO,GACrE,OAAO,CAAC,cAAc,CAAC,CA4BzB"}

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

@@ -1 +1 @@
-{"version":3,"file":"crepeStreaming.d.ts","sourceRoot":"","sources":["../../src/utils/crepeStreaming.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvB,MAAM,MAAM,YAAY,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;AAE3I,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAAG;IACnD,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC,qGAAqG;IACrG,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB,CAAC;AAEF,qBAAa,iBAAkB,SAAQ,gBAAgB;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;gBAEnC,IAAI,EAAE,kBAAkB;IAKpC,SAAS,KAAK,GAAG,IAAI,MAAM,CAE1B;IAED,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK7C,SAAS,CAAC,cAAc,IAAI,IAAI;CAKjC;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,8BAIjE"}
+{"version":3,"file":"crepeStreaming.d.ts","sourceRoot":"","sources":["../../src/utils/crepeStreaming.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEhB,MAAM,MAAM,YAAY,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;AAElJ,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAAG;IACnD,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;IACxC,qGAAqG;IACrG,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB,CAAC;AAEF,qBAAa,iBAAkB,SAAQ,gBAAgB;IACrD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;gBAEnC,IAAI,EAAE,kBAAkB;IAKpC,SAAS,KAAK,GAAG,IAAI,MAAM,CAE1B;IAED,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK7C,SAAS,CAAC,cAAc,IAAI,IAAI;CAKjC;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,8BAIjE"}

package/dist/utils/index.d.ts

@@ -0,0 +1,40 @@
+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';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAGA,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAG1C,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAGhC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,aAAa,CAAC;AAG5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,cAAc,YAAY,CAAC"}

package/dist/utils/latencyEstimate.d.ts

@@ -1,4 +1,4 @@
-export declare function makeClickReference(totalMs: number, sampleRate: number, clickAtMs?: number, clickWidthMs?: number): Float32Array<ArrayBuffer>;
+export declare function makeClickReference(totalMs: number, sampleRate: number, clickAtMs?: number, clickWidthMs?: number): Float32Array;
 export declare function estimateLatencyMsFromRecording(recorded: Float32Array, sampleRate: number, clickAtMs?: number, clickWidthMs?: number): number | null;
 declare const _default: {
     estimateLatencyMsFromRecording: typeof estimateLatencyMsFromRecording;

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

@@ -1 +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"}
+{"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,gBAYxG;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/midiCCMapping.d.ts

@@ -0,0 +1,93 @@
+/**
+ * midiCCMapping.ts — MIDI CC Mapping System for supported controllers.
+ *
+ * Provides a controller-agnostic CC mapping layer that pairs MIDI CC numbers
+ * with editor parameters. Includes built-in profiles for common controllers
+ * and a custom profile builder.
+ */
+/** Physical control type. */
+export type MidiControlType = "knob" | "fader" | "button" | "pad" | "encoder";
+/** A single mapping entry: CC number → parameter. */
+export interface MidiCCMap {
+    /** CC number (0-127). */
+    cc: number;
+    /** Target parameter ID in the editor. */
+    paramId: string;
+    /** Human label for display. */
+    label: string;
+    /** Physical control type (for UI rendering). */
+    controlType: MidiControlType;
+    /** Min output value (default 0). */
+    min: number;
+    /** Max output value (default 127). */
+    max: number;
+    /** Invert value direction? */
+    inverted: boolean;
+}
+/** Controller profile definition. */
+export interface MidiControllerProfile {
+    id: string;
+    name: string;
+    /** Substring to match against MIDI device name for auto-detection. */
+    deviceMatch: string;
+    /** Mappings — one per CC. */
+    mappings: MidiCCMap[];
+}
+/** Resolved CC event after mapping. */
+export interface MappedCCEvent {
+    paramId: string;
+    label: string;
+    /** Raw 0-127 CC value. */
+    rawValue: number;
+    /** Value scaled to [min, max] range. */
+    scaledValue: number;
+    /** Normalized 0-1 value. */
+    normalizedValue: number;
+}
+/**
+ * M-Audio Oxygen 25 MkIV profile.
+ * 8 knobs (CC 21-28), 1 fader (CC 7), transport buttons.
+ */
+export declare const OXYGEN25_PROFILE: MidiControllerProfile;
+/** Akai MPK Mini profile. 8 knobs (CC 1-8), 8 pads (notes). */
+export declare const MPK_MINI_PROFILE: MidiControllerProfile;
+/** Arturia MiniLab profile. 16 knobs + 8 pads. */
+export declare const MINILAB_PROFILE: MidiControllerProfile;
+/** Novation Launch Control XL profile. 24 knobs + 8 faders. */
+export declare const LAUNCH_CONTROL_PROFILE: MidiControllerProfile;
+/** Generic profile — CC 1, 7, 10, 11 (Mod, Volume, Pan, Expression). */
+export declare const GENERIC_PROFILE: MidiControllerProfile;
+/** All built-in profiles. */
+export declare const CONTROLLER_PROFILES: MidiControllerProfile[];
+export declare class MidiCCMapper {
+    private profile;
+    private ccMap;
+    private onChange;
+    constructor(profile?: MidiControllerProfile);
+    /** Switch to a different controller profile. */
+    setProfile(profile: MidiControllerProfile): void;
+    /** Get the current profile. */
+    getProfile(): MidiControllerProfile;
+    /** Auto-detect profile from MIDI device name. */
+    autoDetect(deviceName: string): MidiControllerProfile | null;
+    /** Register a change handler. */
+    onMappedChange(handler: (event: MappedCCEvent) => void): void;
+    /** Process a raw CC event. Returns the mapped event or null if no mapping. */
+    handleCC(cc: number, rawValue: number): MappedCCEvent | null;
+    /** Add or update a single CC mapping. */
+    setMapping(cc: number, paramId: string, label: string, controlType?: MidiControlType): void;
+    /** Remove a CC mapping. */
+    removeMapping(cc: number): void;
+    /** Get all current mappings. */
+    getMappings(): MidiCCMap[];
+    /** Get mapping for a specific CC. */
+    getMapping(cc: number): MidiCCMap | undefined;
+    /** Export current profile as JSON for persistence. */
+    exportConfig(): MidiControllerProfile;
+    /** Import a saved profile config. */
+    importConfig(config: MidiControllerProfile): void;
+    /** Create a custom profile from scratch. */
+    static createCustomProfile(name: string, mappings: Omit<MidiCCMap, "min" | "max" | "inverted">[]): MidiControllerProfile;
+    private rebuildMap;
+}
+//# sourceMappingURL=midiCCMapping.d.ts.map

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

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

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

@@ -1 +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"}
+{"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,MAAO,MAAM,YAAmC,CAAC;AAC1E,eAAO,MAAM,MAAM,OAAQ,MAAM,YAAqC,CAAC;AACvE,eAAO,MAAM,WAAW,OAAQ,MAAM,YAA2D,CAAC;AAElG,eAAO,MAAM,UAAU,QAAS,MAAM,WAKrC,CAAC;AAEF,wBAAgB,cAAc,CAAC,GAAG,CAAC,EAAE,MAAM,UAM1C"}

package/dist/utils/pianoRollUtils.d.ts

@@ -0,0 +1,58 @@
+import { MidiNote } from '../models/editor/midiTypes';
+export type QuantizeValue = '1/4' | '1/8' | '1/16' | '1/32' | '1/4T' | '1/8T' | '1/16T';
+/** Duration of one quantize grid step in beats (quarter notes). */
+export declare function quantizeStepInBeats(value: QuantizeValue): number;
+/** Convert a quantize step from beats to seconds at a given BPM. */
+export declare function quantizeStepInSeconds(value: QuantizeValue, bpm: number): number;
+/** Snap a time value to the nearest grid step. */
+export declare function snapTimeToQuantize(time: number, value: QuantizeValue, bpm: number): number;
+/** Options for quantizing MIDI notes. */
+export interface QuantizeOptions {
+    /** Quantize grid value. */
+    value: QuantizeValue;
+    /** Tempo in BPM. */
+    bpm: number;
+    /** Strength 0-1. 1.0 = full snap, 0.5 = halfway to grid. Default: 1.0 */
+    strength?: number;
+    /** Quantize note starts. Default: true */
+    quantizeStarts?: boolean;
+    /** Quantize note durations (snap to grid length). Default: false */
+    quantizeDurations?: boolean;
+}
+/**
+ * Quantize an array of MIDI notes. Returns new array with adjusted start/duration.
+ * Does not mutate the original notes.
+ */
+export declare function quantizeMidiNotes(notes: MidiNote[], options: QuantizeOptions): MidiNote[];
+export interface HumanizeOptions {
+    /** Max timing offset in seconds. Default: 0.02 (20ms) */
+    timingRange?: number;
+    /** Max velocity offset (±). Default: 10 */
+    velocityRange?: number;
+    /** Seed for deterministic results. Default: random */
+    seed?: number;
+}
+/**
+ * Add slight random offsets to notes for a more human feel.
+ * Returns new array, original is not mutated.
+ */
+export declare function humanizeMidiNotes(notes: MidiNote[], options?: HumanizeOptions): MidiNote[];
+export interface LoopRegion {
+    /** Start time in seconds. */
+    start: number;
+    /** End time in seconds. */
+    end: number;
+    /** Whether A→B looping is active. */
+    enabled: boolean;
+}
+/** Create a default (disabled) loop region. */
+export declare function createLoopRegion(): LoopRegion;
+/** Set loop region from a selection. */
+export declare function setLoopFromSelection(start: number, end: number): LoopRegion;
+/** Snap loop region boundaries to grid. */
+export declare function snapLoopToGrid(region: LoopRegion, quantize: QuantizeValue, bpm: number): LoopRegion;
+/** Check if a time value falls within the loop region. */
+export declare function isInLoopRegion(time: number, region: LoopRegion): boolean;
+/** Calculate loop-wrapped time (if time exceeds end, wrap back to start). */
+export declare function wrapTimeInLoop(time: number, region: LoopRegion): number;
+//# sourceMappingURL=pianoRollUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pianoRollUtils.d.ts","sourceRoot":"","sources":["../../src/utils/pianoRollUtils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAM3D,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAExF,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAUhE;AAED,oEAAoE;AACpE,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED,kDAAkD;AAClD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAG1F;AAED,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,oBAAoB;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,eAAe,GAAG,QAAQ,EAAE,CAoBzF;AAMD,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAWD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,GAAE,eAAoB,GAAG,QAAQ,EAAE,CAgB9F;AAMD,MAAM,WAAW,UAAU;IACzB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,IAAI,UAAU,CAE7C;AAED,wCAAwC;AACxC,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GACV,UAAU,CAGZ;AAED,2CAA2C;AAC3C,wBAAgB,cAAc,CAC5B,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,aAAa,EACvB,GAAG,EAAE,MAAM,GACV,UAAU,CAMZ;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAGxE;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAQvE"}

package/dist/utils/sanitize.d.ts

@@ -0,0 +1,24 @@
+/**
+ * sanitize.ts — XSS prevention utilities for user-provided text/metadata.
+ *
+ * Use these functions when rendering user-provided strings in contexts where
+ * React's automatic escaping is not available (e.g. canvas text, SVG templates,
+ * title attributes constructed from user data).
+ */
+/**
+ * Escape HTML special characters in a string.
+ * Use when inserting user text into raw HTML/SVG template strings.
+ */
+export declare function escapeHtml(str: string): string;
+/**
+ * Validate a URL for use in href/src attributes.
+ * Allows only http:, https:, data:image, and blob: URLs.
+ * Rejects javascript:, data:text/html, and other dangerous schemes.
+ */
+export declare function isSafeUrl(url: string): boolean;
+/**
+ * Strip all HTML tags from a string, leaving only plain text.
+ * Use for lyrics/metadata that should never contain HTML.
+ */
+export declare function stripHtmlTags(str: string): string;
+//# sourceMappingURL=sanitize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../src/utils/sanitize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAa9C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/dist/utils/shortcutManager.d.ts

@@ -0,0 +1,81 @@
+/**
+ * shortcutManager.ts — Configurable keyboard shortcut manager for audio editor.
+ *
+ * Features:
+ * - Register/unregister shortcuts with modifiers (Ctrl, Shift, Alt, Meta)
+ * - Groups & categories for organized shortcut display
+ * - Shortcut conflicts detection
+ * - Scope support (global / editor / piano-roll / timeline)
+ * - Serializable config for user persistence
+ */
+export type ShortcutScope = "global" | "editor" | "piano-roll" | "timeline" | "mixer" | "player";
+export interface ShortcutModifiers {
+    ctrl?: boolean;
+    shift?: boolean;
+    alt?: boolean;
+    meta?: boolean;
+}
+export interface ShortcutBinding {
+    key: string;
+    modifiers?: ShortcutModifiers;
+}
+export interface ShortcutAction {
+    id: string;
+    label: string;
+    group: string;
+    scope: ShortcutScope;
+    binding: ShortcutBinding;
+    callback: () => void;
+    enabled?: boolean;
+}
+export interface ShortcutConfig {
+    id: string;
+    binding: ShortcutBinding;
+}
+export declare class ShortcutManager {
+    private actions;
+    private activeScopes;
+    private enabled;
+    private listener;
+    /** Register a shortcut action. */
+    register(action: ShortcutAction): void;
+    /** Unregister a shortcut action by ID. */
+    unregister(id: string): void;
+    /** Update the key binding for a registered action. */
+    rebind(id: string, newBinding: ShortcutBinding): void;
+    /** Set which scopes are currently active. */
+    setActiveScopes(scopes: ShortcutScope[]): void;
+    /** Enable/disable the entire manager. */
+    setEnabled(on: boolean): void;
+    /** Enable/disable a single action. */
+    setActionEnabled(id: string, on: boolean): void;
+    /** Find conflicting bindings within active scopes. */
+    findConflicts(): Array<[ShortcutAction, ShortcutAction]>;
+    /** Get all registered actions grouped by group name. */
+    getGrouped(): Record<string, ShortcutAction[]>;
+    /** Get all registered actions as a flat list. */
+    getAll(): ShortcutAction[];
+    /** Export current bindings for persistence. */
+    exportConfig(): ShortcutConfig[];
+    /** Import bindings from saved config. */
+    importConfig(configs: ShortcutConfig[]): void;
+    /** Format a binding for display (e.g. "Ctrl+Z"). */
+    formatBinding(id: string): string;
+    /** Handle a keyboard event — returns true if a shortcut was triggered. */
+    handleKeyDown(e: KeyboardEvent): boolean;
+    /** Attach to window keydown events. Call detach() to clean up. */
+    attach(): void;
+    /** Detach from window keydown events. */
+    detach(): void;
+    /** Remove all registered actions and detach. */
+    destroy(): void;
+}
+/**
+ * Creates and returns a ShortcutManager pre-configured with
+ * default audio editor shortcuts. Callbacks are stubs that
+ * should be overridden by the consumer.
+ */
+export declare function createDefaultShortcuts(callbacks?: Partial<Record<string, () => void>>): ShortcutManager;
+/** Pretty-print a ShortcutBinding for UI display. */
+export declare function formatShortcut(binding: ShortcutBinding): string;
+//# sourceMappingURL=shortcutManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shortcutManager.d.ts","sourceRoot":"","sources":["../../src/utils/shortcutManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEjG,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,iBAAiB,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,aAAa,CAAC;IACrB,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,eAAe,CAAC;CAC1B;AAiCD,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,YAAY,CAAsC;IAC1D,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,QAAQ,CAA6C;IAE7D,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAItC,0CAA0C;IAC1C,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B,sDAAsD;IACtD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,GAAG,IAAI;IAOrD,6CAA6C;IAC7C,eAAe,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI;IAM9C,yCAAyC;IACzC,UAAU,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI;IAI7B,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI;IAK/C,sDAAsD;IACtD,aAAa,IAAI,KAAK,CAAC,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IAkBxD,wDAAwD;IACxD,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IAS9C,iDAAiD;IACjD,MAAM,IAAI,cAAc,EAAE;IAI1B,+CAA+C;IAC/C,YAAY,IAAI,cAAc,EAAE;IAOhC,yCAAyC;IACzC,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,IAAI;IAM7C,oDAAoD;IACpD,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAMjC,0EAA0E;IAC1E,aAAa,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO;IAgBxC,kEAAkE;IAClE,MAAM,IAAI,IAAI;IAad,yCAAyC;IACzC,MAAM,IAAI,IAAI;IAOd,gDAAgD;IAChD,OAAO,IAAI,IAAI;CAIhB;AAMD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,GAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAM,GAAG,eAAe,CAyD3G;AAED,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAE/D"}

package/dist/utils/undoRedoUtils.d.ts

@@ -2,4 +2,49 @@ 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;
+export interface EditorUndoAction<T = unknown> {
+    label: string;
+    /** Category: track, midi, fx, mix, arrangement, etc. */
+    category: string;
+    /** Timestamp when action was performed */
+    timestamp: number;
+    /** Forward action data */
+    newState: T;
+    /** Previous state for undo */
+    oldState: T;
+}
+export interface EditorUndoOptions {
+    maxSize?: number;
+    /** Optional callback when undo/redo is performed */
+    onChange?: (action: EditorUndoAction, direction: "undo" | "redo") => void;
+}
+/**
+ * A generic class-based undo/redo manager that works with any serializable state.
+ * Supports labels, categories, timestamps, and configurable max stack size.
+ */
+export declare class EditorUndoManager<T = unknown> {
+    private undoStack;
+    private redoStack;
+    private maxSize;
+    private onChange?;
+    constructor(options?: EditorUndoOptions);
+    /** Push a new undoable action. Clears redo stack. */
+    push(label: string, category: string, oldState: T, newState: T): void;
+    /** Undo the last action. Returns the old state to apply, or null. */
+    undo(): T | null;
+    /** Redo the last undone action. Returns the new state to apply, or null. */
+    redo(): T | null;
+    get canUndo(): boolean;
+    get canRedo(): boolean;
+    get undoLabel(): string | null;
+    get redoLabel(): string | null;
+    get undoCount(): number;
+    get redoCount(): number;
+    /** Get the history of undo actions (most recent first). */
+    getHistory(): EditorUndoAction<T>[];
+    /** Clear all undo/redo history. */
+    clear(): void;
+    /** Jump to a specific point in history by index (0 = most recent). */
+    undoTo(index: number): T | null;
+}
 //# sourceMappingURL=undoRedoUtils.d.ts.map