@nice2dev/ui-audio 0.1.0

package/dist/utils/ccAutomation.d.ts

@@ -0,0 +1,51 @@
+import { MidiCCEvent } from '../models/editor/midiTypes';
+/** Snapshot of a single CC lane's events */
+export interface CCLaneSnapshot {
+    layerId: number;
+    events: MidiCCEvent[];
+}
+/** Full undo/redo state */
+export interface CCHistoryState {
+    past: CCLaneSnapshot[][];
+    present: CCLaneSnapshot[];
+    future: CCLaneSnapshot[][];
+}
+/** Create initial history state */
+export declare function createCCHistory(initial: CCLaneSnapshot[]): CCHistoryState;
+/** Push a new state (used after every edit) */
+export declare function pushCCState(history: CCHistoryState, next: CCLaneSnapshot[]): CCHistoryState;
+/** Undo — move present to future, pop past to present */
+export declare function undoCC(history: CCHistoryState): CCHistoryState;
+/** Redo — move present to past, pop future to present */
+export declare function redoCC(history: CCHistoryState): CCHistoryState;
+/** Can undo? */
+export declare function canUndo(history: CCHistoryState): boolean;
+/** Can redo? */
+export declare function canRedo(history: CCHistoryState): boolean;
+/** Time range for clipboard operations */
+export interface CCTimeRange {
+    start: number;
+    end: number;
+}
+/** Copy events within a time range (returns deep clone) */
+export declare function copyCCEvents(events: MidiCCEvent[], range: CCTimeRange): MidiCCEvent[];
+/** Paste events at a target time offset. Generates new IDs. */
+export declare function pasteCCEvents(existing: MidiCCEvent[], clipboard: MidiCCEvent[], targetTime: number): MidiCCEvent[];
+/** Cut events within a time range — returns { remaining, cut } */
+export declare function cutCCEvents(events: MidiCCEvent[], range: CCTimeRange): {
+    remaining: MidiCCEvent[];
+    cut: MidiCCEvent[];
+};
+/** Delete events within a time range */
+export declare function deleteCCEventsInRange(events: MidiCCEvent[], range: CCTimeRange): MidiCCEvent[];
+/** Select all events within a time range */
+export declare function selectCCEventsInRange(events: MidiCCEvent[], range: CCTimeRange): number[];
+/** Record a real-time CC value into an event list (during playback) */
+export declare function recordCCEvent(events: MidiCCEvent[], cc: number, value: number, time: number): MidiCCEvent[];
+/** Thin out recorded CC events to reduce density (keeps first/last + every Nth) */
+export declare function thinCCEvents(events: MidiCCEvent[], keepEveryN?: number): MidiCCEvent[];
+/** Serialize CC events to JSON string */
+export declare function exportCCLane(events: MidiCCEvent[]): string;
+/** Deserialize CC events from JSON string */
+export declare function importCCLane(json: string): MidiCCEvent[];
+//# sourceMappingURL=ccAutomation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ccAutomation.d.ts","sourceRoot":"","sources":["../../src/utils/ccAutomation.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,2BAA2B;AAC3B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,cAAc,EAAE,EAAE,CAAC;IACzB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,EAAE,cAAc,EAAE,EAAE,CAAC;CAC5B;AAID,mCAAmC;AACnC,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,cAAc,CAEzE;AAED,+CAA+C;AAC/C,wBAAgB,WAAW,CACzB,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,cAAc,EAAE,GACrB,cAAc,CAMhB;AAED,yDAAyD;AACzD,wBAAgB,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CAQ9D;AAED,yDAAyD;AACzD,wBAAgB,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CAQ9D;AAED,gBAAgB;AAChB,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAExD;AAED,gBAAgB;AAChB,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAExD;AAID,0CAA0C;AAC1C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,2DAA2D;AAC3D,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,EAAE,EACrB,KAAK,EAAE,WAAW,GACjB,WAAW,EAAE,CAIf;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,WAAW,EAAE,EACvB,SAAS,EAAE,WAAW,EAAE,EACxB,UAAU,EAAE,MAAM,GACjB,WAAW,EAAE,CAaf;AAED,kEAAkE;AAClE,wBAAgB,WAAW,CACzB,MAAM,EAAE,WAAW,EAAE,EACrB,KAAK,EAAE,WAAW,GACjB;IAAE,SAAS,EAAE,WAAW,EAAE,CAAC;IAAC,GAAG,EAAE,WAAW,EAAE,CAAA;CAAE,CAalD;AAED,wCAAwC;AACxC,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,WAAW,EAAE,EACrB,KAAK,EAAE,WAAW,GACjB,WAAW,EAAE,CAEf;AAED,4CAA4C;AAC5C,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,WAAW,EAAE,EACrB,KAAK,EAAE,WAAW,GACjB,MAAM,EAAE,CAIV;AAID,uEAAuE;AACvE,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,EAAE,EACrB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACX,WAAW,EAAE,CAQf;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,EAAE,EACrB,UAAU,GAAE,MAAU,GACrB,WAAW,EAAE,CASf;AAID,yCAAyC;AACzC,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAE1D;AAED,6CAA6C;AAC7C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CAiBxD"}

package/dist/utils/chordScale.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Chord & Scale recognition engine.
+ * Identifies chords from sets of notes and quantizes notes to scale.
+ */
+/** All pitch classes (chromatic) */
+export declare const PITCH_CLASSES: readonly ["C", "C#", "D", "D#", "E", "F", "F#", "G", "G#", "A", "A#", "B"];
+export type PitchClass = (typeof PITCH_CLASSES)[number];
+/** Scale interval patterns (semitones from root) */
+interface ScaleDefinition {
+    name: string;
+    intervals: number[];
+}
+export declare const SCALES: ScaleDefinition[];
+export interface ChordResult {
+    root: PitchClass;
+    quality: string;
+    symbol: string;
+    confidence: number;
+    inversion: number;
+}
+export interface ScaleMatch {
+    root: PitchClass;
+    name: string;
+    matchScore: number;
+    missingNotes: number[];
+    extraNotes: number[];
+}
+/** Convert MIDI note to pitch class index (0-11) */
+export declare function midiToPitchClass(midi: number): number;
+/** Get pitch class name from MIDI note */
+export declare function midiToPitchClassName(midi: number): PitchClass;
+/** Recognize chord from a set of MIDI notes */
+export declare function recognizeChord(midiNotes: number[]): ChordResult[];
+/** Get scale notes for a given root and scale */
+export declare function getScaleNotes(root: PitchClass, scaleName: string): number[];
+/** Quantize a MIDI note to the nearest note in the given scale */
+export declare function quantizeToScale(midi: number, root: PitchClass, scaleName: string): number;
+/** Quantize an array of MIDI notes to scale */
+export declare function quantizeNotesToScale(midiNotes: number[], root: PitchClass, scaleName: string): number[];
+/** Detect which scales best match a set of played notes */
+export declare function detectScale(midiNotes: number[]): ScaleMatch[];
+/** Get all available scale names */
+export declare function getScaleNames(): string[];
+/** Get interval name between two MIDI notes */
+export declare function getIntervalName(semitones: number): string;
+export {};
+//# sourceMappingURL=chordScale.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chordScale.d.ts","sourceRoot":"","sources":["../../src/utils/chordScale.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oCAAoC;AACpC,eAAO,MAAM,aAAa,4EAA6E,CAAC;AACxG,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAgCxD,oDAAoD;AACpD,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,eAAO,MAAM,MAAM,EAAE,eAAe,EAiBnC,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,0CAA0C;AAC1C,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAE7D;AAQD,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAmDjE;AAED,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAK3E;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAmBzF;AAED,+CAA+C;AAC/C,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvG;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,CAkC7D;AAED,oCAAoC;AACpC,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAQzD"}

package/dist/utils/clipLauncher.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Clip / Scene Launcher — Ableton-style clip grid with follow actions.
+ * Manages scenes (rows) of clips (cells) with transport control.
+ */
+export type ClipState = 'stopped' | 'playing' | 'queued' | 'recording';
+export type FollowAction = 'none' | 'stop' | 'play-again' | 'play-next' | 'play-prev' | 'play-first' | 'play-last' | 'play-random' | 'play-random-other';
+export interface LauncherClip {
+    id: string;
+    trackId: string;
+    sceneIndex: number;
+    name: string;
+    /** Length in bars */
+    lengthBars: number;
+    /** Color for UI */
+    color: string;
+    state: ClipState;
+    /** Source audio/MIDI clip reference */
+    sourceClipId?: string;
+    /** Follow action after clip finishes */
+    followAction: FollowAction;
+    /** Follow action probability (0-1, for random follow) */
+    followActionChance: number;
+    /** Alternative follow action */
+    followActionB?: FollowAction;
+    /** Chance for action B (remainder goes to action A) */
+    followActionBChance: number;
+    /** Loops enabled */
+    loop: boolean;
+    /** Quantize launch to this many bars (0 = immediate) */
+    launchQuantize: number;
+    /** Playback count before follow action fires (0 = infinite) */
+    playCount: number;
+    /** Current play count */
+    currentPlayCount: number;
+}
+export interface LauncherTrack {
+    id: string;
+    name: string;
+    /** Whether track is armed for recording */
+    armed: boolean;
+    /** Volume 0-1 */
+    volume: number;
+    /** Muted */
+    muted: boolean;
+    /** Soloed */
+    soloed: boolean;
+}
+export interface LauncherScene {
+    index: number;
+    name: string;
+    /** Tempo override (null = use global) */
+    tempo?: number;
+    /** Time signature override */
+    timeSignature?: string;
+}
+export interface ClipLauncherState {
+    tracks: LauncherTrack[];
+    scenes: LauncherScene[];
+    clips: LauncherClip[];
+    /** Current global position in bars */
+    currentBar: number;
+    /** Global BPM */
+    bpm: number;
+    /** Is global transport playing */
+    isPlaying: boolean;
+    /** Global launch quantize (bars) */
+    globalLaunchQuantize: number;
+}
+/** Create empty launcher state */
+export declare function createClipLauncher(trackCount?: number, sceneCount?: number): ClipLauncherState;
+/** Create a new clip in the grid */
+export declare function createClip(trackId: string, sceneIndex: number, name?: string, lengthBars?: number): LauncherClip;
+/** Add clip to launcher state */
+export declare function addClipToLauncher(state: ClipLauncherState, clip: LauncherClip): ClipLauncherState;
+/** Remove clip from launcher */
+export declare function removeClipFromLauncher(state: ClipLauncherState, clipId: string): ClipLauncherState;
+/** Get clip at grid position */
+export declare function getClipAt(state: ClipLauncherState, trackId: string, sceneIndex: number): LauncherClip | undefined;
+/** Launch (play) a single clip, stopping others on the same track */
+export declare function launchClip(state: ClipLauncherState, clipId: string): ClipLauncherState;
+/** Stop a clip */
+export declare function stopClip(state: ClipLauncherState, clipId: string): ClipLauncherState;
+/** Launch an entire scene (all clips in that row) */
+export declare function launchScene(state: ClipLauncherState, sceneIndex: number): ClipLauncherState;
+/** Stop all clips */
+export declare function stopAll(state: ClipLauncherState): ClipLauncherState;
+/** Resolve follow action and return next clip to launch (if any) */
+export declare function resolveFollowAction(state: ClipLauncherState, clipId: string): string | null;
+/** Add a new scene */
+export declare function addScene(state: ClipLauncherState, name?: string): ClipLauncherState;
+/** Add a new track */
+export declare function addTrack(state: ClipLauncherState, name?: string): ClipLauncherState;
+/** Get all currently playing clips */
+export declare function getPlayingClips(state: ClipLauncherState): LauncherClip[];
+/** Duplicate a clip to a new position */
+export declare function duplicateClip(state: ClipLauncherState, clipId: string, targetTrackId: string, targetScene: number): ClipLauncherState;
+//# sourceMappingURL=clipLauncher.d.ts.map

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

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

package/dist/utils/colorResolver.d.ts

@@ -0,0 +1,12 @@
+export declare function resolveCssColor(color: string): string;
+/** Parse a color string (hex or rgb(a)) into [r,g,b]. Falls back to [128,128,128]. */
+export declare function parseColorToRgb(color: string): [number, number, number];
+/** Resolve a CSS var(...) color and parse it to RGB. */
+export declare function cssColorToRgb(color: string): [number, number, number];
+declare const _default: {
+    resolveCssColor: typeof resolveCssColor;
+    parseColorToRgb: typeof parseColorToRgb;
+    cssColorToRgb: typeof cssColorToRgb;
+};
+export default _default;
+//# sourceMappingURL=colorResolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"colorResolver.d.ts","sourceRoot":"","sources":["../../src/utils/colorResolver.ts"],"names":[],"mappings":"AACA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAarD;AAED,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAcvE;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAGrE;;;;;;AAED,wBAAmE"}

package/dist/utils/crepeStreaming.d.ts

@@ -0,0 +1,21 @@
+import { BaseStreamClient, BaseStreamOptions } from './BaseStreamClient';
+export type CrepeMessage = {
+    hz?: number;
+    confidence?: number;
+    error?: string;
+    [k: string]: unknown;
+};
+export type CrepeStreamOptions = BaseStreamOptions & {
+    onMessage?: (msg: CrepeMessage) => void;
+    /** Called when WS exhausts all reconnect attempts — caller can fall back to local pitch detection */
+    onFallback?: () => void;
+};
+export declare class CrepeStreamClient extends BaseStreamClient {
+    private readonly crepeOpts;
+    constructor(opts: CrepeStreamOptions);
+    protected get tag(): string;
+    protected handleWsMessage(data: string): void;
+    protected onMaxReconnect(): void;
+}
+export declare function startCrepeMicStream(opts: CrepeStreamOptions): Promise<CrepeStreamClient>;
+//# sourceMappingURL=crepeStreaming.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/drawTool.d.ts

@@ -0,0 +1,31 @@
+import { MidiCCEvent } from '../models/editor/midiTypes';
+export type DrawMode = 'pencil' | 'line' | 'curve' | 'step' | 'ramp';
+export interface DrawPoint {
+    time: number;
+    value: number;
+}
+export interface DrawToolConfig {
+    mode: DrawMode;
+    cc: number;
+    resolution: number;
+    smoothing: number;
+    snap: boolean;
+    snapDivisions: number;
+}
+/** Generate CC events from pencil-drawn points */
+export declare function pencilDraw(points: DrawPoint[], cc: number, resolution?: number): MidiCCEvent[];
+/** Generate CC events forming a straight line between two points */
+export declare function lineDraw(start: DrawPoint, end: DrawPoint, cc: number, steps?: number): MidiCCEvent[];
+/** Generate CC events along a curve (quadratic bezier) */
+export declare function curveDraw(start: DrawPoint, control: DrawPoint, end: DrawPoint, cc: number, steps?: number): MidiCCEvent[];
+/** Generate CC events in step pattern */
+export declare function stepDraw(start: DrawPoint, end: DrawPoint, cc: number, stepCount?: number): MidiCCEvent[];
+/** Generate CC events along an exponential ramp */
+export declare function rampDraw(start: DrawPoint, end: DrawPoint, cc: number, curvature?: number, steps?: number): MidiCCEvent[];
+/** Smooth an array of CC events using moving average */
+export declare function smoothEvents(events: MidiCCEvent[], windowSize?: number): MidiCCEvent[];
+/** Snap CC event values to grid divisions */
+export declare function snapValues(events: MidiCCEvent[], divisions?: number): MidiCCEvent[];
+/** Apply draw tool with given config to generate events */
+export declare function applyDrawTool(config: DrawToolConfig, points: DrawPoint[]): MidiCCEvent[];
+//# sourceMappingURL=drawTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"drawTool.d.ts","sourceRoot":"","sources":["../../src/utils/drawTool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAErE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB;AASD,kDAAkD;AAClD,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,GAAE,MAAa,GAAG,WAAW,EAAE,CAYpG;AAED,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,WAAW,EAAE,CAYxG;AAED,0DAA0D;AAC1D,wBAAgB,SAAS,CACvB,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,SAAS,EAClB,GAAG,EAAE,SAAS,EACd,EAAE,EAAE,MAAM,EACV,KAAK,GAAE,MAAW,GACjB,WAAW,EAAE,CASf;AAED,yCAAyC;AACzC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU,GAAG,WAAW,EAAE,CAa3G;AAED,mDAAmD;AACnD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU,EAAE,KAAK,GAAE,MAAW,GAAG,WAAW,EAAE,CAa/H;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,UAAU,GAAE,MAAU,GAAG,WAAW,EAAE,CAUzF;AAED,6CAA6C;AAC7C,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,SAAS,GAAE,MAAW,GAAG,WAAW,EAAE,CAMvF;AAED,2DAA2D;AAC3D,wBAAgB,aAAa,CAC3B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,SAAS,EAAE,GAClB,WAAW,EAAE,CA6Cf"}

package/dist/utils/envelopeFollower.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Envelope Follower — tracks amplitude of audio signal and maps to CC values.
+ * Useful for dynamic control of effects based on audio level.
+ */
+export interface EnvelopeFollowerConfig {
+    /** Attack time in seconds (how fast the envelope rises) */
+    attackTime: number;
+    /** Release time in seconds (how fast the envelope falls) */
+    releaseTime: number;
+    /** Sensitivity multiplier (1 = normal) */
+    sensitivity: number;
+    /** Floor — minimum input level to trigger (0-1) */
+    floor: number;
+    /** Ceiling — maximum output value (0-127) */
+    ceiling: number;
+    /** Target CC number */
+    cc: number;
+    /** Invert the output */
+    invert: boolean;
+    /** Smoothing factor (0-1) */
+    smoothing: number;
+}
+export declare const DEFAULT_ENVELOPE_CONFIG: EnvelopeFollowerConfig;
+/**
+ * Process a block of audio samples and return the envelope value (0-1).
+ * Uses a simple peak follower with attack/release.
+ */
+export declare function processEnvelopeBlock(samples: Float32Array, previousEnvelope: number, config: EnvelopeFollowerConfig, sampleRate?: number): number;
+/**
+ * Convert an envelope value (0-1) to a CC value (0-127).
+ */
+export declare function envelopeToCC(envelope: number, config: EnvelopeFollowerConfig): number;
+/**
+ * Analyze a full audio buffer and generate CC events at specified intervals.
+ */
+export declare function analyzeBufferToCC(audioBuffer: AudioBuffer, config: EnvelopeFollowerConfig, intervalMs?: number, channel?: number): Array<{
+    time: number;
+    value: number;
+    cc: number;
+}>;
+/**
+ * Create an AudioWorklet-compatible envelope follower processor code.
+ * Returns the processor source as a string for use with AudioWorkletNode.
+ */
+export declare function getEnvelopeFollowerWorkletCode(): string;
+//# sourceMappingURL=envelopeFollower.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"envelopeFollower.d.ts","sourceRoot":"","sources":["../../src/utils/envelopeFollower.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,sBAAsB;IACrC,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,wBAAwB;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,uBAAuB,EAAE,sBASrC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,YAAY,EACrB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,sBAAsB,EAC9B,UAAU,GAAE,MAAc,GACzB,MAAM,CAaR;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,sBAAsB,GAC7B,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,sBAAsB,EAC9B,UAAU,GAAE,MAAW,EACvB,OAAO,GAAE,MAAU,GAClB,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BpD;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,IAAI,MAAM,CA2BvD"}

package/dist/utils/gameAudio.d.ts

@@ -0,0 +1,237 @@
+/**
+ * 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;
+//# sourceMappingURL=gameAudio.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gameAudio.d.ts","sourceRoot":"","sources":["../../src/utils/gameAudio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,sBAAsB;IACtB,IAAI,CAAC,EAAE,cAAc,CAAA;IACrB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,WAAW,EAAE,CAAA;CACrB;AASD,qBAAa,SAAS;IACpB,OAAO,CAAC,GAAG,CAA4B;IACvC,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,WAAW,CAAqC;IACxD,OAAO,CAAC,OAAO,CAAsB;IAErC,OAAO;IAIP,MAAM,CAAC,WAAW,IAAI,SAAS;IAO/B,OAAO,CAAC,aAAa;IAoBrB,SAAS,IAAI,cAAc;IAE3B,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAMjD,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,UAAU;IAQZ,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASrD,gEAAgE;IAChE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAiC7F,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAqCjC,sEAAsE;IACtE,UAAU,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAMvC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvD,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,UAAO,GAAG,IAAI;IAgBxC,SAAS,IAAI,IAAI;IAWjB,OAAO,IAAI,IAAI;CAWhB;AAKD,eAAO,MAAM,WAAW;;;;;;kBAGmD,cAAc;;;;;;;;;kBAKf,cAAc;;;;;;;;kBAK9B,cAAc;;;;;;;;kBAMhB,cAAc;;;;;;;;;kBAOM,cAAc;;;;;;;;;kBAMZ,cAAc;;;;;;;;;kBAKf,cAAc;;;;;;;;;kBAMb,cAAc;;;;;;;;;kBAMf,cAAc;;;;;;;;;kBAKf,cAAc;;;;;;;;;;kBAMjC,cAAc;;;;;;;;kBAMhB,cAAc;;;;;;;;;kBAQS,cAAc;;;;;;;;;kBAKlB,cAAc;;;;;;;;kBAMhC,cAAc;;;;;;;;kBAQb,cAAc;;;;;;;;kBAKf,cAAc;;;;;;;;kBAKd,cAAc;;;;CAGvB,CAAA;AAE/C,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,WAAW,CAAA"}

package/dist/utils/grooveTemplates.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Groove Templates engine — groove quantize, humanize, and swing.
+ * Applies rhythmic feel transformations to MIDI/audio events.
+ */
+export interface TimedEvent {
+    /** Start time in beats */
+    time: number;
+    /** Duration in beats */
+    duration: number;
+    /** Velocity 0-127 */
+    velocity: number;
+    /** Optional pitch (MIDI note) */
+    pitch?: number;
+}
+export interface GrooveTemplate {
+    id: string;
+    name: string;
+    /** Per-step timing offsets (fraction of step, -0.5 to 0.5) */
+    timingOffsets: number[];
+    /** Per-step velocity scales (0-2, 1 = no change) */
+    velocityScales: number[];
+    /** Per-step duration scales (0-2, 1 = no change) */
+    durationScales: number[];
+    /** Steps per bar (typically 8, 16, or 32) */
+    stepsPerBar: number;
+}
+export interface HumanizeConfig {
+    /** Max random timing offset in beats (0 = none) */
+    timingAmount: number;
+    /** Max random velocity offset (0-127 range, 0 = none) */
+    velocityAmount: number;
+    /** Max random duration offset in beats (0 = none) */
+    durationAmount: number;
+    /** Seed for reproducible randomization (null = truly random) */
+    seed?: number;
+}
+export interface SwingConfig {
+    /** Swing amount 0-1 (0 = straight, 0.67 ≈ triplet feel) */
+    amount: number;
+    /** Grid resolution in beats for swing application */
+    grid: number;
+}
+export interface GrooveApplyConfig {
+    /** Groove template to apply (null = none) */
+    template?: GrooveTemplate;
+    /** Groove strength 0-1 */
+    grooveStrength: number;
+    /** Humanize settings */
+    humanize?: HumanizeConfig;
+    /** Swing settings */
+    swing?: SwingConfig;
+}
+export declare const GROOVE_TEMPLATES: GrooveTemplate[];
+/** Apply swing to events */
+export declare function applySwing(events: TimedEvent[], config: SwingConfig): TimedEvent[];
+/** Apply humanize (random offsets) to events */
+export declare function applyHumanize(events: TimedEvent[], config: HumanizeConfig): TimedEvent[];
+/** Apply groove template to events */
+export declare function applyGrooveTemplate(events: TimedEvent[], template: GrooveTemplate, strength?: number): TimedEvent[];
+/** Apply full groove configuration (template + humanize + swing) */
+export declare function applyGroove(events: TimedEvent[], config: GrooveApplyConfig): TimedEvent[];
+/** Get template by ID */
+export declare function getGrooveTemplate(id: string): GrooveTemplate | undefined;
+/** List all template names */
+export declare function getGrooveTemplateNames(): Array<{
+    id: string;
+    name: string;
+}>;
+//# sourceMappingURL=grooveTemplates.d.ts.map