@waveform-playlist/core 5.0.0-alpha.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Naomi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.mts

@@ -0,0 +1,284 @@
+/**
+ * Clip-Based Model Types
+ *
+ * These types support a professional multi-track editing model where:
+ * - Each track can contain multiple audio clips
+ * - Clips can be positioned anywhere on the timeline
+ * - Clips have independent trim points (offset/duration)
+ * - Gaps between clips are silent
+ * - Clips can overlap (for crossfades)
+ */
+
+/**
+ * Generic effects function type for track-level audio processing.
+ *
+ * The actual implementation receives Tone.js audio nodes. Using generic types
+ * here to avoid circular dependencies with the playout package.
+ *
+ * @param graphEnd - The end of the track's audio graph (Tone.js Gain node)
+ * @param destination - Where to connect the effects output (Tone.js ToneAudioNode)
+ * @param isOffline - Whether rendering offline (for export)
+ * @returns Optional cleanup function called when track is disposed
+ *
+ * @example
+ * ```typescript
+ * const trackEffects: TrackEffectsFunction = (graphEnd, destination, isOffline) => {
+ *   const reverb = new Tone.Reverb({ decay: 1.5 });
+ *   graphEnd.connect(reverb);
+ *   reverb.connect(destination);
+ *
+ *   return () => {
+ *     reverb.dispose();
+ *   };
+ * };
+ * ```
+ */
+type TrackEffectsFunction = (graphEnd: unknown, destination: unknown, isOffline: boolean) => void | (() => void);
+/**
+ * Represents a single audio clip on the timeline
+ *
+ * IMPORTANT: All positions/durations are stored as SAMPLE COUNTS (integers)
+ * to avoid floating-point precision errors. Convert to seconds only when
+ * needed for playback using: seconds = samples / sampleRate
+ */
+interface AudioClip {
+    /** Unique identifier for this clip */
+    id: string;
+    /** The audio buffer containing the audio data */
+    audioBuffer: AudioBuffer;
+    /** Position on timeline where this clip starts (in samples at timeline sampleRate) */
+    startSample: number;
+    /** Duration of this clip (in samples) - how much of the audio buffer to play */
+    durationSamples: number;
+    /** Offset into the audio buffer where playback starts (in samples) - the "trim start" point */
+    offsetSamples: number;
+    /** Optional fade in effect */
+    fadeIn?: Fade;
+    /** Optional fade out effect */
+    fadeOut?: Fade;
+    /** Clip-specific gain/volume multiplier (0.0 to 1.0+) */
+    gain: number;
+    /** Optional label/name for this clip */
+    name?: string;
+    /** Optional color for visual distinction */
+    color?: string;
+}
+/**
+ * Represents a track containing multiple audio clips
+ */
+interface ClipTrack {
+    /** Unique identifier for this track */
+    id: string;
+    /** Display name for this track */
+    name: string;
+    /** Array of audio clips on this track */
+    clips: AudioClip[];
+    /** Whether this track is muted */
+    muted: boolean;
+    /** Whether this track is soloed */
+    soloed: boolean;
+    /** Track volume (0.0 to 1.0+) */
+    volume: number;
+    /** Stereo pan (-1.0 = left, 0 = center, 1.0 = right) */
+    pan: number;
+    /** Optional track color for visual distinction */
+    color?: string;
+    /** Track height in pixels (for UI) */
+    height?: number;
+    /** Optional effects function for this track */
+    effects?: TrackEffectsFunction;
+}
+/**
+ * Represents the entire timeline/project
+ */
+interface Timeline {
+    /** All tracks in the timeline */
+    tracks: ClipTrack[];
+    /** Total timeline duration in seconds */
+    duration: number;
+    /** Sample rate for all audio (typically 44100 or 48000) */
+    sampleRate: number;
+    /** Optional project name */
+    name?: string;
+    /** Optional tempo (BPM) for grid snapping */
+    tempo?: number;
+    /** Optional time signature for grid snapping */
+    timeSignature?: {
+        numerator: number;
+        denominator: number;
+    };
+}
+/**
+ * Options for creating a new audio clip (using sample counts)
+ */
+interface CreateClipOptions {
+    audioBuffer: AudioBuffer;
+    startSample: number;
+    durationSamples?: number;
+    offsetSamples?: number;
+    gain?: number;
+    name?: string;
+    color?: string;
+    fadeIn?: Fade;
+    fadeOut?: Fade;
+}
+/**
+ * Options for creating a new audio clip (using seconds for convenience)
+ */
+interface CreateClipOptionsSeconds {
+    audioBuffer: AudioBuffer;
+    startTime: number;
+    duration?: number;
+    offset?: number;
+    gain?: number;
+    name?: string;
+    color?: string;
+    fadeIn?: Fade;
+    fadeOut?: Fade;
+}
+/**
+ * Options for creating a new track
+ */
+interface CreateTrackOptions {
+    name: string;
+    clips?: AudioClip[];
+    muted?: boolean;
+    soloed?: boolean;
+    volume?: number;
+    pan?: number;
+    color?: string;
+    height?: number;
+}
+/**
+ * Creates a new AudioClip with sensible defaults (using sample counts)
+ */
+declare function createClip(options: CreateClipOptions): AudioClip;
+/**
+ * Creates a new AudioClip from time-based values (convenience function)
+ * Converts seconds to samples using the audioBuffer's sampleRate
+ */
+declare function createClipFromSeconds(options: CreateClipOptionsSeconds): AudioClip;
+/**
+ * Creates a new ClipTrack with sensible defaults
+ */
+declare function createTrack(options: CreateTrackOptions): ClipTrack;
+/**
+ * Creates a new Timeline with sensible defaults
+ */
+declare function createTimeline(tracks: ClipTrack[], sampleRate?: number, options?: {
+    name?: string;
+    tempo?: number;
+    timeSignature?: {
+        numerator: number;
+        denominator: number;
+    };
+}): Timeline;
+/**
+ * Utility: Get all clips within a sample range
+ */
+declare function getClipsInRange(track: ClipTrack, startSample: number, endSample: number): AudioClip[];
+/**
+ * Utility: Get all clips at a specific sample position
+ */
+declare function getClipsAtSample(track: ClipTrack, sample: number): AudioClip[];
+/**
+ * Utility: Check if two clips overlap
+ */
+declare function clipsOverlap(clip1: AudioClip, clip2: AudioClip): boolean;
+/**
+ * Utility: Sort clips by startSample
+ */
+declare function sortClipsByTime(clips: AudioClip[]): AudioClip[];
+/**
+ * Utility: Find gaps between clips (silent regions)
+ */
+interface Gap {
+    startSample: number;
+    endSample: number;
+    durationSamples: number;
+}
+declare function findGaps(track: ClipTrack): Gap[];
+
+interface WaveformConfig {
+    sampleRate: number;
+    samplesPerPixel: number;
+    waveHeight?: number;
+    waveOutlineColor?: string;
+    waveFillColor?: string;
+    waveProgressColor?: string;
+}
+interface AudioBuffer$1 {
+    length: number;
+    duration: number;
+    numberOfChannels: number;
+    sampleRate: number;
+    getChannelData(channel: number): Float32Array;
+}
+interface Track {
+    id: string;
+    name: string;
+    src?: string | AudioBuffer$1;
+    gain: number;
+    muted: boolean;
+    soloed: boolean;
+    stereoPan: number;
+    startTime: number;
+    endTime?: number;
+    fadeIn?: Fade;
+    fadeOut?: Fade;
+    cueIn?: number;
+    cueOut?: number;
+}
+/**
+ * Simple fade configuration
+ */
+interface Fade {
+    /** Duration of the fade in seconds */
+    duration: number;
+    /** Type of fade curve (default: 'linear') */
+    type?: FadeType;
+}
+type FadeType = 'logarithmic' | 'linear' | 'sCurve' | 'exponential';
+interface PlaylistConfig {
+    samplesPerPixel?: number;
+    waveHeight?: number;
+    container?: HTMLElement;
+    isAutomaticScroll?: boolean;
+    timescale?: boolean;
+    colors?: {
+        waveOutlineColor?: string;
+        waveFillColor?: string;
+        waveProgressColor?: string;
+    };
+    controls?: {
+        show?: boolean;
+        width?: number;
+    };
+    zoomLevels?: number[];
+}
+interface PlayoutState {
+    isPlaying: boolean;
+    isPaused: boolean;
+    cursor: number;
+    duration: number;
+}
+interface TimeSelection {
+    start: number;
+    end: number;
+}
+declare enum InteractionState {
+    Cursor = "cursor",
+    Select = "select",
+    Shift = "shift",
+    FadeIn = "fadein",
+    FadeOut = "fadeout"
+}
+
+declare function samplesToSeconds(samples: number, sampleRate: number): number;
+declare function secondsToSamples(seconds: number, sampleRate: number): number;
+declare function samplesToPixels(samples: number, samplesPerPixel: number): number;
+declare function pixelsToSamples(pixels: number, samplesPerPixel: number): number;
+declare function pixelsToSeconds(pixels: number, samplesPerPixel: number, sampleRate: number): number;
+declare function secondsToPixels(seconds: number, samplesPerPixel: number, sampleRate: number): number;
+
+export { type AudioBuffer$1 as AudioBuffer, type AudioClip, type ClipTrack, type CreateClipOptions, type CreateClipOptionsSeconds, type CreateTrackOptions, type Fade, type FadeType, type Gap, InteractionState, type PlaylistConfig, type PlayoutState, type TimeSelection, type Timeline, type Track, type TrackEffectsFunction, type WaveformConfig, clipsOverlap, createClip, createClipFromSeconds, createTimeline, createTrack, findGaps, getClipsAtSample, getClipsInRange, pixelsToSamples, pixelsToSeconds, samplesToPixels, samplesToSeconds, secondsToPixels, secondsToSamples, sortClipsByTime };

package/dist/index.d.ts

@@ -0,0 +1,284 @@
+/**
+ * Clip-Based Model Types
+ *
+ * These types support a professional multi-track editing model where:
+ * - Each track can contain multiple audio clips
+ * - Clips can be positioned anywhere on the timeline
+ * - Clips have independent trim points (offset/duration)
+ * - Gaps between clips are silent
+ * - Clips can overlap (for crossfades)
+ */
+
+/**
+ * Generic effects function type for track-level audio processing.
+ *
+ * The actual implementation receives Tone.js audio nodes. Using generic types
+ * here to avoid circular dependencies with the playout package.
+ *
+ * @param graphEnd - The end of the track's audio graph (Tone.js Gain node)
+ * @param destination - Where to connect the effects output (Tone.js ToneAudioNode)
+ * @param isOffline - Whether rendering offline (for export)
+ * @returns Optional cleanup function called when track is disposed
+ *
+ * @example
+ * ```typescript
+ * const trackEffects: TrackEffectsFunction = (graphEnd, destination, isOffline) => {
+ *   const reverb = new Tone.Reverb({ decay: 1.5 });
+ *   graphEnd.connect(reverb);
+ *   reverb.connect(destination);
+ *
+ *   return () => {
+ *     reverb.dispose();
+ *   };
+ * };
+ * ```
+ */
+type TrackEffectsFunction = (graphEnd: unknown, destination: unknown, isOffline: boolean) => void | (() => void);
+/**
+ * Represents a single audio clip on the timeline
+ *
+ * IMPORTANT: All positions/durations are stored as SAMPLE COUNTS (integers)
+ * to avoid floating-point precision errors. Convert to seconds only when
+ * needed for playback using: seconds = samples / sampleRate
+ */
+interface AudioClip {
+    /** Unique identifier for this clip */
+    id: string;
+    /** The audio buffer containing the audio data */
+    audioBuffer: AudioBuffer;
+    /** Position on timeline where this clip starts (in samples at timeline sampleRate) */
+    startSample: number;
+    /** Duration of this clip (in samples) - how much of the audio buffer to play */
+    durationSamples: number;
+    /** Offset into the audio buffer where playback starts (in samples) - the "trim start" point */
+    offsetSamples: number;
+    /** Optional fade in effect */
+    fadeIn?: Fade;
+    /** Optional fade out effect */
+    fadeOut?: Fade;
+    /** Clip-specific gain/volume multiplier (0.0 to 1.0+) */
+    gain: number;
+    /** Optional label/name for this clip */
+    name?: string;
+    /** Optional color for visual distinction */
+    color?: string;
+}
+/**
+ * Represents a track containing multiple audio clips
+ */
+interface ClipTrack {
+    /** Unique identifier for this track */
+    id: string;
+    /** Display name for this track */
+    name: string;
+    /** Array of audio clips on this track */
+    clips: AudioClip[];
+    /** Whether this track is muted */
+    muted: boolean;
+    /** Whether this track is soloed */
+    soloed: boolean;
+    /** Track volume (0.0 to 1.0+) */
+    volume: number;
+    /** Stereo pan (-1.0 = left, 0 = center, 1.0 = right) */
+    pan: number;
+    /** Optional track color for visual distinction */
+    color?: string;
+    /** Track height in pixels (for UI) */
+    height?: number;
+    /** Optional effects function for this track */
+    effects?: TrackEffectsFunction;
+}
+/**
+ * Represents the entire timeline/project
+ */
+interface Timeline {
+    /** All tracks in the timeline */
+    tracks: ClipTrack[];
+    /** Total timeline duration in seconds */
+    duration: number;
+    /** Sample rate for all audio (typically 44100 or 48000) */
+    sampleRate: number;
+    /** Optional project name */
+    name?: string;
+    /** Optional tempo (BPM) for grid snapping */
+    tempo?: number;
+    /** Optional time signature for grid snapping */
+    timeSignature?: {
+        numerator: number;
+        denominator: number;
+    };
+}
+/**
+ * Options for creating a new audio clip (using sample counts)
+ */
+interface CreateClipOptions {
+    audioBuffer: AudioBuffer;
+    startSample: number;
+    durationSamples?: number;
+    offsetSamples?: number;
+    gain?: number;
+    name?: string;
+    color?: string;
+    fadeIn?: Fade;
+    fadeOut?: Fade;
+}
+/**
+ * Options for creating a new audio clip (using seconds for convenience)
+ */
+interface CreateClipOptionsSeconds {
+    audioBuffer: AudioBuffer;
+    startTime: number;
+    duration?: number;
+    offset?: number;
+    gain?: number;
+    name?: string;
+    color?: string;
+    fadeIn?: Fade;
+    fadeOut?: Fade;
+}
+/**
+ * Options for creating a new track
+ */
+interface CreateTrackOptions {
+    name: string;
+    clips?: AudioClip[];
+    muted?: boolean;
+    soloed?: boolean;
+    volume?: number;
+    pan?: number;
+    color?: string;
+    height?: number;
+}
+/**
+ * Creates a new AudioClip with sensible defaults (using sample counts)
+ */
+declare function createClip(options: CreateClipOptions): AudioClip;
+/**
+ * Creates a new AudioClip from time-based values (convenience function)
+ * Converts seconds to samples using the audioBuffer's sampleRate
+ */
+declare function createClipFromSeconds(options: CreateClipOptionsSeconds): AudioClip;
+/**
+ * Creates a new ClipTrack with sensible defaults
+ */
+declare function createTrack(options: CreateTrackOptions): ClipTrack;
+/**
+ * Creates a new Timeline with sensible defaults
+ */
+declare function createTimeline(tracks: ClipTrack[], sampleRate?: number, options?: {
+    name?: string;
+    tempo?: number;
+    timeSignature?: {
+        numerator: number;
+        denominator: number;
+    };
+}): Timeline;
+/**
+ * Utility: Get all clips within a sample range
+ */
+declare function getClipsInRange(track: ClipTrack, startSample: number, endSample: number): AudioClip[];
+/**
+ * Utility: Get all clips at a specific sample position
+ */
+declare function getClipsAtSample(track: ClipTrack, sample: number): AudioClip[];
+/**
+ * Utility: Check if two clips overlap
+ */
+declare function clipsOverlap(clip1: AudioClip, clip2: AudioClip): boolean;
+/**
+ * Utility: Sort clips by startSample
+ */
+declare function sortClipsByTime(clips: AudioClip[]): AudioClip[];
+/**
+ * Utility: Find gaps between clips (silent regions)
+ */
+interface Gap {
+    startSample: number;
+    endSample: number;
+    durationSamples: number;
+}
+declare function findGaps(track: ClipTrack): Gap[];
+
+interface WaveformConfig {
+    sampleRate: number;
+    samplesPerPixel: number;
+    waveHeight?: number;
+    waveOutlineColor?: string;
+    waveFillColor?: string;
+    waveProgressColor?: string;
+}
+interface AudioBuffer$1 {
+    length: number;
+    duration: number;
+    numberOfChannels: number;
+    sampleRate: number;
+    getChannelData(channel: number): Float32Array;
+}
+interface Track {
+    id: string;
+    name: string;
+    src?: string | AudioBuffer$1;
+    gain: number;
+    muted: boolean;
+    soloed: boolean;
+    stereoPan: number;
+    startTime: number;
+    endTime?: number;
+    fadeIn?: Fade;
+    fadeOut?: Fade;
+    cueIn?: number;
+    cueOut?: number;
+}
+/**
+ * Simple fade configuration
+ */
+interface Fade {
+    /** Duration of the fade in seconds */
+    duration: number;
+    /** Type of fade curve (default: 'linear') */
+    type?: FadeType;
+}
+type FadeType = 'logarithmic' | 'linear' | 'sCurve' | 'exponential';
+interface PlaylistConfig {
+    samplesPerPixel?: number;
+    waveHeight?: number;
+    container?: HTMLElement;
+    isAutomaticScroll?: boolean;
+    timescale?: boolean;
+    colors?: {
+        waveOutlineColor?: string;
+        waveFillColor?: string;
+        waveProgressColor?: string;
+    };
+    controls?: {
+        show?: boolean;
+        width?: number;
+    };
+    zoomLevels?: number[];
+}
+interface PlayoutState {
+    isPlaying: boolean;
+    isPaused: boolean;
+    cursor: number;
+    duration: number;
+}
+interface TimeSelection {
+    start: number;
+    end: number;
+}
+declare enum InteractionState {
+    Cursor = "cursor",
+    Select = "select",
+    Shift = "shift",
+    FadeIn = "fadein",
+    FadeOut = "fadeout"
+}
+
+declare function samplesToSeconds(samples: number, sampleRate: number): number;
+declare function secondsToSamples(seconds: number, sampleRate: number): number;
+declare function samplesToPixels(samples: number, samplesPerPixel: number): number;
+declare function pixelsToSamples(pixels: number, samplesPerPixel: number): number;
+declare function pixelsToSeconds(pixels: number, samplesPerPixel: number, sampleRate: number): number;
+declare function secondsToPixels(seconds: number, samplesPerPixel: number, sampleRate: number): number;
+
+export { type AudioBuffer$1 as AudioBuffer, type AudioClip, type ClipTrack, type CreateClipOptions, type CreateClipOptionsSeconds, type CreateTrackOptions, type Fade, type FadeType, type Gap, InteractionState, type PlaylistConfig, type PlayoutState, type TimeSelection, type Timeline, type Track, type TrackEffectsFunction, type WaveformConfig, clipsOverlap, createClip, createClipFromSeconds, createTimeline, createTrack, findGaps, getClipsAtSample, getClipsInRange, pixelsToSamples, pixelsToSeconds, samplesToPixels, samplesToSeconds, secondsToPixels, secondsToSamples, sortClipsByTime };

package/dist/index.js

@@ -0,0 +1,223 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  InteractionState: () => InteractionState,
+  clipsOverlap: () => clipsOverlap,
+  createClip: () => createClip,
+  createClipFromSeconds: () => createClipFromSeconds,
+  createTimeline: () => createTimeline,
+  createTrack: () => createTrack,
+  findGaps: () => findGaps,
+  getClipsAtSample: () => getClipsAtSample,
+  getClipsInRange: () => getClipsInRange,
+  pixelsToSamples: () => pixelsToSamples,
+  pixelsToSeconds: () => pixelsToSeconds,
+  samplesToPixels: () => samplesToPixels,
+  samplesToSeconds: () => samplesToSeconds,
+  secondsToPixels: () => secondsToPixels,
+  secondsToSamples: () => secondsToSamples,
+  sortClipsByTime: () => sortClipsByTime
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/types/clip.ts
+function createClip(options) {
+  const {
+    audioBuffer,
+    startSample,
+    durationSamples = audioBuffer.length,
+    // Full buffer by default
+    offsetSamples = 0,
+    gain = 1,
+    name,
+    color,
+    fadeIn,
+    fadeOut
+  } = options;
+  return {
+    id: generateId(),
+    audioBuffer,
+    startSample,
+    durationSamples,
+    offsetSamples,
+    gain,
+    name,
+    color,
+    fadeIn,
+    fadeOut
+  };
+}
+function createClipFromSeconds(options) {
+  const {
+    audioBuffer,
+    startTime,
+    duration = audioBuffer.duration,
+    offset = 0,
+    gain = 1,
+    name,
+    color,
+    fadeIn,
+    fadeOut
+  } = options;
+  const sampleRate = audioBuffer.sampleRate;
+  return createClip({
+    audioBuffer,
+    startSample: Math.round(startTime * sampleRate),
+    durationSamples: Math.round(duration * sampleRate),
+    offsetSamples: Math.round(offset * sampleRate),
+    gain,
+    name,
+    color,
+    fadeIn,
+    fadeOut
+  });
+}
+function createTrack(options) {
+  const {
+    name,
+    clips = [],
+    muted = false,
+    soloed = false,
+    volume = 1,
+    pan = 0,
+    color,
+    height
+  } = options;
+  return {
+    id: generateId(),
+    name,
+    clips,
+    muted,
+    soloed,
+    volume,
+    pan,
+    color,
+    height
+  };
+}
+function createTimeline(tracks, sampleRate = 44100, options) {
+  const durationSamples = tracks.reduce((maxSamples, track) => {
+    const trackSamples = track.clips.reduce((max, clip) => {
+      return Math.max(max, clip.startSample + clip.durationSamples);
+    }, 0);
+    return Math.max(maxSamples, trackSamples);
+  }, 0);
+  const duration = durationSamples / sampleRate;
+  return {
+    tracks,
+    duration,
+    sampleRate,
+    name: options?.name,
+    tempo: options?.tempo,
+    timeSignature: options?.timeSignature
+  };
+}
+function generateId() {
+  return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+}
+function getClipsInRange(track, startSample, endSample) {
+  return track.clips.filter((clip) => {
+    const clipEnd = clip.startSample + clip.durationSamples;
+    return clip.startSample < endSample && clipEnd > startSample;
+  });
+}
+function getClipsAtSample(track, sample) {
+  return track.clips.filter((clip) => {
+    const clipEnd = clip.startSample + clip.durationSamples;
+    return sample >= clip.startSample && sample < clipEnd;
+  });
+}
+function clipsOverlap(clip1, clip2) {
+  const clip1End = clip1.startSample + clip1.durationSamples;
+  const clip2End = clip2.startSample + clip2.durationSamples;
+  return clip1.startSample < clip2End && clip1End > clip2.startSample;
+}
+function sortClipsByTime(clips) {
+  return [...clips].sort((a, b) => a.startSample - b.startSample);
+}
+function findGaps(track) {
+  if (track.clips.length === 0) return [];
+  const sorted = sortClipsByTime(track.clips);
+  const gaps = [];
+  for (let i = 0; i < sorted.length - 1; i++) {
+    const currentClipEnd = sorted[i].startSample + sorted[i].durationSamples;
+    const nextClipStart = sorted[i + 1].startSample;
+    if (nextClipStart > currentClipEnd) {
+      gaps.push({
+        startSample: currentClipEnd,
+        endSample: nextClipStart,
+        durationSamples: nextClipStart - currentClipEnd
+      });
+    }
+  }
+  return gaps;
+}
+
+// src/types/index.ts
+var InteractionState = /* @__PURE__ */ ((InteractionState2) => {
+  InteractionState2["Cursor"] = "cursor";
+  InteractionState2["Select"] = "select";
+  InteractionState2["Shift"] = "shift";
+  InteractionState2["FadeIn"] = "fadein";
+  InteractionState2["FadeOut"] = "fadeout";
+  return InteractionState2;
+})(InteractionState || {});
+
+// src/utils/conversions.ts
+function samplesToSeconds(samples, sampleRate) {
+  return samples / sampleRate;
+}
+function secondsToSamples(seconds, sampleRate) {
+  return Math.ceil(seconds * sampleRate);
+}
+function samplesToPixels(samples, samplesPerPixel) {
+  return Math.floor(samples / samplesPerPixel);
+}
+function pixelsToSamples(pixels, samplesPerPixel) {
+  return Math.floor(pixels * samplesPerPixel);
+}
+function pixelsToSeconds(pixels, samplesPerPixel, sampleRate) {
+  return pixels * samplesPerPixel / sampleRate;
+}
+function secondsToPixels(seconds, samplesPerPixel, sampleRate) {
+  return Math.ceil(seconds * sampleRate / samplesPerPixel);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  InteractionState,
+  clipsOverlap,
+  createClip,
+  createClipFromSeconds,
+  createTimeline,
+  createTrack,
+  findGaps,
+  getClipsAtSample,
+  getClipsInRange,
+  pixelsToSamples,
+  pixelsToSeconds,
+  samplesToPixels,
+  samplesToSeconds,
+  secondsToPixels,
+  secondsToSamples,
+  sortClipsByTime
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/types/clip.ts","../src/types/index.ts","../src/utils/conversions.ts"],"sourcesContent":["export * from './types';\nexport * from './utils';\n","/**\n * Clip-Based Model Types\n *\n * These types support a professional multi-track editing model where:\n * - Each track can contain multiple audio clips\n * - Clips can be positioned anywhere on the timeline\n * - Clips have independent trim points (offset/duration)\n * - Gaps between clips are silent\n * - Clips can overlap (for crossfades)\n */\n\nimport { Fade } from './index';\n\n/**\n * Generic effects function type for track-level audio processing.\n *\n * The actual implementation receives Tone.js audio nodes. Using generic types\n * here to avoid circular dependencies with the playout package.\n *\n * @param graphEnd - The end of the track's audio graph (Tone.js Gain node)\n * @param destination - Where to connect the effects output (Tone.js ToneAudioNode)\n * @param isOffline - Whether rendering offline (for export)\n * @returns Optional cleanup function called when track is disposed\n *\n * @example\n * ```typescript\n * const trackEffects: TrackEffectsFunction = (graphEnd, destination, isOffline) => {\n *   const reverb = new Tone.Reverb({ decay: 1.5 });\n *   graphEnd.connect(reverb);\n *   reverb.connect(destination);\n *\n *   return () => {\n *     reverb.dispose();\n *   };\n * };\n * ```\n */\nexport type TrackEffectsFunction = (\n  graphEnd: unknown,\n  destination: unknown,\n  isOffline: boolean\n) => void | (() => void);\n\n/**\n * Represents a single audio clip on the timeline\n *\n * IMPORTANT: All positions/durations are stored as SAMPLE COUNTS (integers)\n * to avoid floating-point precision errors. Convert to seconds only when\n * needed for playback using: seconds = samples / sampleRate\n */\nexport interface AudioClip {\n  /** Unique identifier for this clip */\n  id: string;\n\n  /** The audio buffer containing the audio data */\n  audioBuffer: AudioBuffer;\n\n  /** Position on timeline where this clip starts (in samples at timeline sampleRate) */\n  startSample: number;\n\n  /** Duration of this clip (in samples) - how much of the audio buffer to play */\n  durationSamples: number;\n\n  /** Offset into the audio buffer where playback starts (in samples) - the \"trim start\" point */\n  offsetSamples: number;\n\n  /** Optional fade in effect */\n  fadeIn?: Fade;\n\n  /** Optional fade out effect */\n  fadeOut?: Fade;\n\n  /** Clip-specific gain/volume multiplier (0.0 to 1.0+) */\n  gain: number;\n\n  /** Optional label/name for this clip */\n  name?: string;\n\n  /** Optional color for visual distinction */\n  color?: string;\n}\n\n/**\n * Represents a track containing multiple audio clips\n */\nexport interface ClipTrack {\n  /** Unique identifier for this track */\n  id: string;\n\n  /** Display name for this track */\n  name: string;\n\n  /** Array of audio clips on this track */\n  clips: AudioClip[];\n\n  /** Whether this track is muted */\n  muted: boolean;\n\n  /** Whether this track is soloed */\n  soloed: boolean;\n\n  /** Track volume (0.0 to 1.0+) */\n  volume: number;\n\n  /** Stereo pan (-1.0 = left, 0 = center, 1.0 = right) */\n  pan: number;\n\n  /** Optional track color for visual distinction */\n  color?: string;\n\n  /** Track height in pixels (for UI) */\n  height?: number;\n\n  /** Optional effects function for this track */\n  effects?: TrackEffectsFunction;\n}\n\n/**\n * Represents the entire timeline/project\n */\nexport interface Timeline {\n  /** All tracks in the timeline */\n  tracks: ClipTrack[];\n\n  /** Total timeline duration in seconds */\n  duration: number;\n\n  /** Sample rate for all audio (typically 44100 or 48000) */\n  sampleRate: number;\n\n  /** Optional project name */\n  name?: string;\n\n  /** Optional tempo (BPM) for grid snapping */\n  tempo?: number;\n\n  /** Optional time signature for grid snapping */\n  timeSignature?: {\n    numerator: number;\n    denominator: number;\n  };\n}\n\n/**\n * Options for creating a new audio clip (using sample counts)\n */\nexport interface CreateClipOptions {\n  audioBuffer: AudioBuffer;\n  startSample: number;           // Position on timeline (in samples)\n  durationSamples?: number;      // Defaults to full buffer duration (in samples)\n  offsetSamples?: number;        // Defaults to 0\n  gain?: number;                 // Defaults to 1.0\n  name?: string;\n  color?: string;\n  fadeIn?: Fade;\n  fadeOut?: Fade;\n}\n\n/**\n * Options for creating a new audio clip (using seconds for convenience)\n */\nexport interface CreateClipOptionsSeconds {\n  audioBuffer: AudioBuffer;\n  startTime: number;        // Position on timeline (in seconds)\n  duration?: number;        // Defaults to full buffer duration (in seconds)\n  offset?: number;          // Defaults to 0 (in seconds)\n  gain?: number;            // Defaults to 1.0\n  name?: string;\n  color?: string;\n  fadeIn?: Fade;\n  fadeOut?: Fade;\n}\n\n/**\n * Options for creating a new track\n */\nexport interface CreateTrackOptions {\n  name: string;\n  clips?: AudioClip[];\n  muted?: boolean;\n  soloed?: boolean;\n  volume?: number;\n  pan?: number;\n  color?: string;\n  height?: number;\n}\n\n/**\n * Creates a new AudioClip with sensible defaults (using sample counts)\n */\nexport function createClip(options: CreateClipOptions): AudioClip {\n  const {\n    audioBuffer,\n    startSample,\n    durationSamples = audioBuffer.length, // Full buffer by default\n    offsetSamples = 0,\n    gain = 1.0,\n    name,\n    color,\n    fadeIn,\n    fadeOut,\n  } = options;\n\n  return {\n    id: generateId(),\n    audioBuffer,\n    startSample,\n    durationSamples,\n    offsetSamples,\n    gain,\n    name,\n    color,\n    fadeIn,\n    fadeOut,\n  };\n}\n\n/**\n * Creates a new AudioClip from time-based values (convenience function)\n * Converts seconds to samples using the audioBuffer's sampleRate\n */\nexport function createClipFromSeconds(options: CreateClipOptionsSeconds): AudioClip {\n  const {\n    audioBuffer,\n    startTime,\n    duration = audioBuffer.duration,\n    offset = 0,\n    gain = 1.0,\n    name,\n    color,\n    fadeIn,\n    fadeOut,\n  } = options;\n\n  const sampleRate = audioBuffer.sampleRate;\n\n  return createClip({\n    audioBuffer,\n    startSample: Math.round(startTime * sampleRate),\n    durationSamples: Math.round(duration * sampleRate),\n    offsetSamples: Math.round(offset * sampleRate),\n    gain,\n    name,\n    color,\n    fadeIn,\n    fadeOut,\n  });\n}\n\n/**\n * Creates a new ClipTrack with sensible defaults\n */\nexport function createTrack(options: CreateTrackOptions): ClipTrack {\n  const {\n    name,\n    clips = [],\n    muted = false,\n    soloed = false,\n    volume = 1.0,\n    pan = 0,\n    color,\n    height,\n  } = options;\n\n  return {\n    id: generateId(),\n    name,\n    clips,\n    muted,\n    soloed,\n    volume,\n    pan,\n    color,\n    height,\n  };\n}\n\n/**\n * Creates a new Timeline with sensible defaults\n */\nexport function createTimeline(\n  tracks: ClipTrack[],\n  sampleRate: number = 44100,\n  options?: {\n    name?: string;\n    tempo?: number;\n    timeSignature?: { numerator: number; denominator: number };\n  }\n): Timeline {\n  // Calculate total duration from all clips across all tracks (in seconds)\n  const durationSamples = tracks.reduce((maxSamples, track) => {\n    const trackSamples = track.clips.reduce((max, clip) => {\n      return Math.max(max, clip.startSample + clip.durationSamples);\n    }, 0);\n    return Math.max(maxSamples, trackSamples);\n  }, 0);\n\n  const duration = durationSamples / sampleRate;\n\n  return {\n    tracks,\n    duration,\n    sampleRate,\n    name: options?.name,\n    tempo: options?.tempo,\n    timeSignature: options?.timeSignature,\n  };\n}\n\n/**\n * Generates a unique ID for clips and tracks\n */\nfunction generateId(): string {\n  return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;\n}\n\n/**\n * Utility: Get all clips within a sample range\n */\nexport function getClipsInRange(\n  track: ClipTrack,\n  startSample: number,\n  endSample: number\n): AudioClip[] {\n  return track.clips.filter((clip) => {\n    const clipEnd = clip.startSample + clip.durationSamples;\n    // Clip overlaps with range if:\n    // - Clip starts before range ends AND\n    // - Clip ends after range starts\n    return clip.startSample < endSample && clipEnd > startSample;\n  });\n}\n\n/**\n * Utility: Get all clips at a specific sample position\n */\nexport function getClipsAtSample(track: ClipTrack, sample: number): AudioClip[] {\n  return track.clips.filter((clip) => {\n    const clipEnd = clip.startSample + clip.durationSamples;\n    return sample >= clip.startSample && sample < clipEnd;\n  });\n}\n\n/**\n * Utility: Check if two clips overlap\n */\nexport function clipsOverlap(clip1: AudioClip, clip2: AudioClip): boolean {\n  const clip1End = clip1.startSample + clip1.durationSamples;\n  const clip2End = clip2.startSample + clip2.durationSamples;\n\n  return clip1.startSample < clip2End && clip1End > clip2.startSample;\n}\n\n/**\n * Utility: Sort clips by startSample\n */\nexport function sortClipsByTime(clips: AudioClip[]): AudioClip[] {\n  return [...clips].sort((a, b) => a.startSample - b.startSample);\n}\n\n/**\n * Utility: Find gaps between clips (silent regions)\n */\nexport interface Gap {\n  startSample: number;\n  endSample: number;\n  durationSamples: number;\n}\n\nexport function findGaps(track: ClipTrack): Gap[] {\n  if (track.clips.length === 0) return [];\n\n  const sorted = sortClipsByTime(track.clips);\n  const gaps: Gap[] = [];\n\n  for (let i = 0; i < sorted.length - 1; i++) {\n    const currentClipEnd = sorted[i].startSample + sorted[i].durationSamples;\n    const nextClipStart = sorted[i + 1].startSample;\n\n    if (nextClipStart > currentClipEnd) {\n      gaps.push({\n        startSample: currentClipEnd,\n        endSample: nextClipStart,\n        durationSamples: nextClipStart - currentClipEnd,\n      });\n    }\n  }\n\n  return gaps;\n}\n","export interface WaveformConfig {\n  sampleRate: number;\n  samplesPerPixel: number;\n  waveHeight?: number;\n  waveOutlineColor?: string;\n  waveFillColor?: string;\n  waveProgressColor?: string;\n}\n\nexport interface AudioBuffer {\n  length: number;\n  duration: number;\n  numberOfChannels: number;\n  sampleRate: number;\n  getChannelData(channel: number): Float32Array;\n}\n\nexport interface Track {\n  id: string;\n  name: string;\n  src?: string | AudioBuffer; // Support both URL strings and AudioBuffer objects\n  gain: number;\n  muted: boolean;\n  soloed: boolean;\n  stereoPan: number;\n  startTime: number;\n  endTime?: number;\n  fadeIn?: Fade;\n  fadeOut?: Fade;\n  cueIn?: number;\n  cueOut?: number;\n}\n\n/**\n * Simple fade configuration\n */\nexport interface Fade {\n  /** Duration of the fade in seconds */\n  duration: number;\n  /** Type of fade curve (default: 'linear') */\n  type?: FadeType;\n}\n\nexport type FadeType = 'logarithmic' | 'linear' | 'sCurve' | 'exponential';\n\nexport interface PlaylistConfig {\n  samplesPerPixel?: number;\n  waveHeight?: number;\n  container?: HTMLElement;\n  isAutomaticScroll?: boolean;\n  timescale?: boolean;\n  colors?: {\n    waveOutlineColor?: string;\n    waveFillColor?: string;\n    waveProgressColor?: string;\n  };\n  controls?: {\n    show?: boolean;\n    width?: number;\n  };\n  zoomLevels?: number[];\n}\n\nexport interface PlayoutState {\n  isPlaying: boolean;\n  isPaused: boolean;\n  cursor: number;\n  duration: number;\n}\n\nexport interface TimeSelection {\n  start: number;\n  end: number;\n}\n\nexport enum InteractionState {\n  Cursor = 'cursor',\n  Select = 'select',\n  Shift = 'shift',\n  FadeIn = 'fadein',\n  FadeOut = 'fadeout',\n}\n\n// Export clip-based model types\nexport * from './clip';\n","export function samplesToSeconds(samples: number, sampleRate: number): number {\n  return samples / sampleRate;\n}\n\nexport function secondsToSamples(seconds: number, sampleRate: number): number {\n  return Math.ceil(seconds * sampleRate);\n}\n\nexport function samplesToPixels(samples: number, samplesPerPixel: number): number {\n  return Math.floor(samples / samplesPerPixel);\n}\n\nexport function pixelsToSamples(pixels: number, samplesPerPixel: number): number {\n  return Math.floor(pixels * samplesPerPixel);\n}\n\nexport function pixelsToSeconds(\n  pixels: number,\n  samplesPerPixel: number,\n  sampleRate: number\n): number {\n  return (pixels * samplesPerPixel) / sampleRate;\n}\n\nexport function secondsToPixels(\n  seconds: number,\n  samplesPerPixel: number,\n  sampleRate: number\n): number {\n  return Math.ceil((seconds * sampleRate) / samplesPerPixel);\n}\n"],"mappings":"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","names":["InteractionState"]}

package/dist/index.mjs

@@ -0,0 +1,181 @@
+// src/types/clip.ts
+function createClip(options) {
+  const {
+    audioBuffer,
+    startSample,
+    durationSamples = audioBuffer.length,
+    // Full buffer by default
+    offsetSamples = 0,
+    gain = 1,
+    name,
+    color,
+    fadeIn,
+    fadeOut
+  } = options;
+  return {
+    id: generateId(),
+    audioBuffer,
+    startSample,
+    durationSamples,
+    offsetSamples,
+    gain,
+    name,
+    color,
+    fadeIn,
+    fadeOut
+  };
+}
+function createClipFromSeconds(options) {
+  const {
+    audioBuffer,
+    startTime,
+    duration = audioBuffer.duration,
+    offset = 0,
+    gain = 1,
+    name,
+    color,
+    fadeIn,
+    fadeOut
+  } = options;
+  const sampleRate = audioBuffer.sampleRate;
+  return createClip({
+    audioBuffer,
+    startSample: Math.round(startTime * sampleRate),
+    durationSamples: Math.round(duration * sampleRate),
+    offsetSamples: Math.round(offset * sampleRate),
+    gain,
+    name,
+    color,
+    fadeIn,
+    fadeOut
+  });
+}
+function createTrack(options) {
+  const {
+    name,
+    clips = [],
+    muted = false,
+    soloed = false,
+    volume = 1,
+    pan = 0,
+    color,
+    height
+  } = options;
+  return {
+    id: generateId(),
+    name,
+    clips,
+    muted,
+    soloed,
+    volume,
+    pan,
+    color,
+    height
+  };
+}
+function createTimeline(tracks, sampleRate = 44100, options) {
+  const durationSamples = tracks.reduce((maxSamples, track) => {
+    const trackSamples = track.clips.reduce((max, clip) => {
+      return Math.max(max, clip.startSample + clip.durationSamples);
+    }, 0);
+    return Math.max(maxSamples, trackSamples);
+  }, 0);
+  const duration = durationSamples / sampleRate;
+  return {
+    tracks,
+    duration,
+    sampleRate,
+    name: options?.name,
+    tempo: options?.tempo,
+    timeSignature: options?.timeSignature
+  };
+}
+function generateId() {
+  return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+}
+function getClipsInRange(track, startSample, endSample) {
+  return track.clips.filter((clip) => {
+    const clipEnd = clip.startSample + clip.durationSamples;
+    return clip.startSample < endSample && clipEnd > startSample;
+  });
+}
+function getClipsAtSample(track, sample) {
+  return track.clips.filter((clip) => {
+    const clipEnd = clip.startSample + clip.durationSamples;
+    return sample >= clip.startSample && sample < clipEnd;
+  });
+}
+function clipsOverlap(clip1, clip2) {
+  const clip1End = clip1.startSample + clip1.durationSamples;
+  const clip2End = clip2.startSample + clip2.durationSamples;
+  return clip1.startSample < clip2End && clip1End > clip2.startSample;
+}
+function sortClipsByTime(clips) {
+  return [...clips].sort((a, b) => a.startSample - b.startSample);
+}
+function findGaps(track) {
+  if (track.clips.length === 0) return [];
+  const sorted = sortClipsByTime(track.clips);
+  const gaps = [];
+  for (let i = 0; i < sorted.length - 1; i++) {
+    const currentClipEnd = sorted[i].startSample + sorted[i].durationSamples;
+    const nextClipStart = sorted[i + 1].startSample;
+    if (nextClipStart > currentClipEnd) {
+      gaps.push({
+        startSample: currentClipEnd,
+        endSample: nextClipStart,
+        durationSamples: nextClipStart - currentClipEnd
+      });
+    }
+  }
+  return gaps;
+}
+
+// src/types/index.ts
+var InteractionState = /* @__PURE__ */ ((InteractionState2) => {
+  InteractionState2["Cursor"] = "cursor";
+  InteractionState2["Select"] = "select";
+  InteractionState2["Shift"] = "shift";
+  InteractionState2["FadeIn"] = "fadein";
+  InteractionState2["FadeOut"] = "fadeout";
+  return InteractionState2;
+})(InteractionState || {});
+
+// src/utils/conversions.ts
+function samplesToSeconds(samples, sampleRate) {
+  return samples / sampleRate;
+}
+function secondsToSamples(seconds, sampleRate) {
+  return Math.ceil(seconds * sampleRate);
+}
+function samplesToPixels(samples, samplesPerPixel) {
+  return Math.floor(samples / samplesPerPixel);
+}
+function pixelsToSamples(pixels, samplesPerPixel) {
+  return Math.floor(pixels * samplesPerPixel);
+}
+function pixelsToSeconds(pixels, samplesPerPixel, sampleRate) {
+  return pixels * samplesPerPixel / sampleRate;
+}
+function secondsToPixels(seconds, samplesPerPixel, sampleRate) {
+  return Math.ceil(seconds * sampleRate / samplesPerPixel);
+}
+export {
+  InteractionState,
+  clipsOverlap,
+  createClip,
+  createClipFromSeconds,
+  createTimeline,
+  createTrack,
+  findGaps,
+  getClipsAtSample,
+  getClipsInRange,
+  pixelsToSamples,
+  pixelsToSeconds,
+  samplesToPixels,
+  samplesToSeconds,
+  secondsToPixels,
+  secondsToSamples,
+  sortClipsByTime
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types/clip.ts","../src/types/index.ts","../src/utils/conversions.ts"],"sourcesContent":["/**\n * Clip-Based Model Types\n *\n * These types support a professional multi-track editing model where:\n * - Each track can contain multiple audio clips\n * - Clips can be positioned anywhere on the timeline\n * - Clips have independent trim points (offset/duration)\n * - Gaps between clips are silent\n * - Clips can overlap (for crossfades)\n */\n\nimport { Fade } from './index';\n\n/**\n * Generic effects function type for track-level audio processing.\n *\n * The actual implementation receives Tone.js audio nodes. Using generic types\n * here to avoid circular dependencies with the playout package.\n *\n * @param graphEnd - The end of the track's audio graph (Tone.js Gain node)\n * @param destination - Where to connect the effects output (Tone.js ToneAudioNode)\n * @param isOffline - Whether rendering offline (for export)\n * @returns Optional cleanup function called when track is disposed\n *\n * @example\n * ```typescript\n * const trackEffects: TrackEffectsFunction = (graphEnd, destination, isOffline) => {\n *   const reverb = new Tone.Reverb({ decay: 1.5 });\n *   graphEnd.connect(reverb);\n *   reverb.connect(destination);\n *\n *   return () => {\n *     reverb.dispose();\n *   };\n * };\n * ```\n */\nexport type TrackEffectsFunction = (\n  graphEnd: unknown,\n  destination: unknown,\n  isOffline: boolean\n) => void | (() => void);\n\n/**\n * Represents a single audio clip on the timeline\n *\n * IMPORTANT: All positions/durations are stored as SAMPLE COUNTS (integers)\n * to avoid floating-point precision errors. Convert to seconds only when\n * needed for playback using: seconds = samples / sampleRate\n */\nexport interface AudioClip {\n  /** Unique identifier for this clip */\n  id: string;\n\n  /** The audio buffer containing the audio data */\n  audioBuffer: AudioBuffer;\n\n  /** Position on timeline where this clip starts (in samples at timeline sampleRate) */\n  startSample: number;\n\n  /** Duration of this clip (in samples) - how much of the audio buffer to play */\n  durationSamples: number;\n\n  /** Offset into the audio buffer where playback starts (in samples) - the \"trim start\" point */\n  offsetSamples: number;\n\n  /** Optional fade in effect */\n  fadeIn?: Fade;\n\n  /** Optional fade out effect */\n  fadeOut?: Fade;\n\n  /** Clip-specific gain/volume multiplier (0.0 to 1.0+) */\n  gain: number;\n\n  /** Optional label/name for this clip */\n  name?: string;\n\n  /** Optional color for visual distinction */\n  color?: string;\n}\n\n/**\n * Represents a track containing multiple audio clips\n */\nexport interface ClipTrack {\n  /** Unique identifier for this track */\n  id: string;\n\n  /** Display name for this track */\n  name: string;\n\n  /** Array of audio clips on this track */\n  clips: AudioClip[];\n\n  /** Whether this track is muted */\n  muted: boolean;\n\n  /** Whether this track is soloed */\n  soloed: boolean;\n\n  /** Track volume (0.0 to 1.0+) */\n  volume: number;\n\n  /** Stereo pan (-1.0 = left, 0 = center, 1.0 = right) */\n  pan: number;\n\n  /** Optional track color for visual distinction */\n  color?: string;\n\n  /** Track height in pixels (for UI) */\n  height?: number;\n\n  /** Optional effects function for this track */\n  effects?: TrackEffectsFunction;\n}\n\n/**\n * Represents the entire timeline/project\n */\nexport interface Timeline {\n  /** All tracks in the timeline */\n  tracks: ClipTrack[];\n\n  /** Total timeline duration in seconds */\n  duration: number;\n\n  /** Sample rate for all audio (typically 44100 or 48000) */\n  sampleRate: number;\n\n  /** Optional project name */\n  name?: string;\n\n  /** Optional tempo (BPM) for grid snapping */\n  tempo?: number;\n\n  /** Optional time signature for grid snapping */\n  timeSignature?: {\n    numerator: number;\n    denominator: number;\n  };\n}\n\n/**\n * Options for creating a new audio clip (using sample counts)\n */\nexport interface CreateClipOptions {\n  audioBuffer: AudioBuffer;\n  startSample: number;           // Position on timeline (in samples)\n  durationSamples?: number;      // Defaults to full buffer duration (in samples)\n  offsetSamples?: number;        // Defaults to 0\n  gain?: number;                 // Defaults to 1.0\n  name?: string;\n  color?: string;\n  fadeIn?: Fade;\n  fadeOut?: Fade;\n}\n\n/**\n * Options for creating a new audio clip (using seconds for convenience)\n */\nexport interface CreateClipOptionsSeconds {\n  audioBuffer: AudioBuffer;\n  startTime: number;        // Position on timeline (in seconds)\n  duration?: number;        // Defaults to full buffer duration (in seconds)\n  offset?: number;          // Defaults to 0 (in seconds)\n  gain?: number;            // Defaults to 1.0\n  name?: string;\n  color?: string;\n  fadeIn?: Fade;\n  fadeOut?: Fade;\n}\n\n/**\n * Options for creating a new track\n */\nexport interface CreateTrackOptions {\n  name: string;\n  clips?: AudioClip[];\n  muted?: boolean;\n  soloed?: boolean;\n  volume?: number;\n  pan?: number;\n  color?: string;\n  height?: number;\n}\n\n/**\n * Creates a new AudioClip with sensible defaults (using sample counts)\n */\nexport function createClip(options: CreateClipOptions): AudioClip {\n  const {\n    audioBuffer,\n    startSample,\n    durationSamples = audioBuffer.length, // Full buffer by default\n    offsetSamples = 0,\n    gain = 1.0,\n    name,\n    color,\n    fadeIn,\n    fadeOut,\n  } = options;\n\n  return {\n    id: generateId(),\n    audioBuffer,\n    startSample,\n    durationSamples,\n    offsetSamples,\n    gain,\n    name,\n    color,\n    fadeIn,\n    fadeOut,\n  };\n}\n\n/**\n * Creates a new AudioClip from time-based values (convenience function)\n * Converts seconds to samples using the audioBuffer's sampleRate\n */\nexport function createClipFromSeconds(options: CreateClipOptionsSeconds): AudioClip {\n  const {\n    audioBuffer,\n    startTime,\n    duration = audioBuffer.duration,\n    offset = 0,\n    gain = 1.0,\n    name,\n    color,\n    fadeIn,\n    fadeOut,\n  } = options;\n\n  const sampleRate = audioBuffer.sampleRate;\n\n  return createClip({\n    audioBuffer,\n    startSample: Math.round(startTime * sampleRate),\n    durationSamples: Math.round(duration * sampleRate),\n    offsetSamples: Math.round(offset * sampleRate),\n    gain,\n    name,\n    color,\n    fadeIn,\n    fadeOut,\n  });\n}\n\n/**\n * Creates a new ClipTrack with sensible defaults\n */\nexport function createTrack(options: CreateTrackOptions): ClipTrack {\n  const {\n    name,\n    clips = [],\n    muted = false,\n    soloed = false,\n    volume = 1.0,\n    pan = 0,\n    color,\n    height,\n  } = options;\n\n  return {\n    id: generateId(),\n    name,\n    clips,\n    muted,\n    soloed,\n    volume,\n    pan,\n    color,\n    height,\n  };\n}\n\n/**\n * Creates a new Timeline with sensible defaults\n */\nexport function createTimeline(\n  tracks: ClipTrack[],\n  sampleRate: number = 44100,\n  options?: {\n    name?: string;\n    tempo?: number;\n    timeSignature?: { numerator: number; denominator: number };\n  }\n): Timeline {\n  // Calculate total duration from all clips across all tracks (in seconds)\n  const durationSamples = tracks.reduce((maxSamples, track) => {\n    const trackSamples = track.clips.reduce((max, clip) => {\n      return Math.max(max, clip.startSample + clip.durationSamples);\n    }, 0);\n    return Math.max(maxSamples, trackSamples);\n  }, 0);\n\n  const duration = durationSamples / sampleRate;\n\n  return {\n    tracks,\n    duration,\n    sampleRate,\n    name: options?.name,\n    tempo: options?.tempo,\n    timeSignature: options?.timeSignature,\n  };\n}\n\n/**\n * Generates a unique ID for clips and tracks\n */\nfunction generateId(): string {\n  return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;\n}\n\n/**\n * Utility: Get all clips within a sample range\n */\nexport function getClipsInRange(\n  track: ClipTrack,\n  startSample: number,\n  endSample: number\n): AudioClip[] {\n  return track.clips.filter((clip) => {\n    const clipEnd = clip.startSample + clip.durationSamples;\n    // Clip overlaps with range if:\n    // - Clip starts before range ends AND\n    // - Clip ends after range starts\n    return clip.startSample < endSample && clipEnd > startSample;\n  });\n}\n\n/**\n * Utility: Get all clips at a specific sample position\n */\nexport function getClipsAtSample(track: ClipTrack, sample: number): AudioClip[] {\n  return track.clips.filter((clip) => {\n    const clipEnd = clip.startSample + clip.durationSamples;\n    return sample >= clip.startSample && sample < clipEnd;\n  });\n}\n\n/**\n * Utility: Check if two clips overlap\n */\nexport function clipsOverlap(clip1: AudioClip, clip2: AudioClip): boolean {\n  const clip1End = clip1.startSample + clip1.durationSamples;\n  const clip2End = clip2.startSample + clip2.durationSamples;\n\n  return clip1.startSample < clip2End && clip1End > clip2.startSample;\n}\n\n/**\n * Utility: Sort clips by startSample\n */\nexport function sortClipsByTime(clips: AudioClip[]): AudioClip[] {\n  return [...clips].sort((a, b) => a.startSample - b.startSample);\n}\n\n/**\n * Utility: Find gaps between clips (silent regions)\n */\nexport interface Gap {\n  startSample: number;\n  endSample: number;\n  durationSamples: number;\n}\n\nexport function findGaps(track: ClipTrack): Gap[] {\n  if (track.clips.length === 0) return [];\n\n  const sorted = sortClipsByTime(track.clips);\n  const gaps: Gap[] = [];\n\n  for (let i = 0; i < sorted.length - 1; i++) {\n    const currentClipEnd = sorted[i].startSample + sorted[i].durationSamples;\n    const nextClipStart = sorted[i + 1].startSample;\n\n    if (nextClipStart > currentClipEnd) {\n      gaps.push({\n        startSample: currentClipEnd,\n        endSample: nextClipStart,\n        durationSamples: nextClipStart - currentClipEnd,\n      });\n    }\n  }\n\n  return gaps;\n}\n","export interface WaveformConfig {\n  sampleRate: number;\n  samplesPerPixel: number;\n  waveHeight?: number;\n  waveOutlineColor?: string;\n  waveFillColor?: string;\n  waveProgressColor?: string;\n}\n\nexport interface AudioBuffer {\n  length: number;\n  duration: number;\n  numberOfChannels: number;\n  sampleRate: number;\n  getChannelData(channel: number): Float32Array;\n}\n\nexport interface Track {\n  id: string;\n  name: string;\n  src?: string | AudioBuffer; // Support both URL strings and AudioBuffer objects\n  gain: number;\n  muted: boolean;\n  soloed: boolean;\n  stereoPan: number;\n  startTime: number;\n  endTime?: number;\n  fadeIn?: Fade;\n  fadeOut?: Fade;\n  cueIn?: number;\n  cueOut?: number;\n}\n\n/**\n * Simple fade configuration\n */\nexport interface Fade {\n  /** Duration of the fade in seconds */\n  duration: number;\n  /** Type of fade curve (default: 'linear') */\n  type?: FadeType;\n}\n\nexport type FadeType = 'logarithmic' | 'linear' | 'sCurve' | 'exponential';\n\nexport interface PlaylistConfig {\n  samplesPerPixel?: number;\n  waveHeight?: number;\n  container?: HTMLElement;\n  isAutomaticScroll?: boolean;\n  timescale?: boolean;\n  colors?: {\n    waveOutlineColor?: string;\n    waveFillColor?: string;\n    waveProgressColor?: string;\n  };\n  controls?: {\n    show?: boolean;\n    width?: number;\n  };\n  zoomLevels?: number[];\n}\n\nexport interface PlayoutState {\n  isPlaying: boolean;\n  isPaused: boolean;\n  cursor: number;\n  duration: number;\n}\n\nexport interface TimeSelection {\n  start: number;\n  end: number;\n}\n\nexport enum InteractionState {\n  Cursor = 'cursor',\n  Select = 'select',\n  Shift = 'shift',\n  FadeIn = 'fadein',\n  FadeOut = 'fadeout',\n}\n\n// Export clip-based model types\nexport * from './clip';\n","export function samplesToSeconds(samples: number, sampleRate: number): number {\n  return samples / sampleRate;\n}\n\nexport function secondsToSamples(seconds: number, sampleRate: number): number {\n  return Math.ceil(seconds * sampleRate);\n}\n\nexport function samplesToPixels(samples: number, samplesPerPixel: number): number {\n  return Math.floor(samples / samplesPerPixel);\n}\n\nexport function pixelsToSamples(pixels: number, samplesPerPixel: number): number {\n  return Math.floor(pixels * samplesPerPixel);\n}\n\nexport function pixelsToSeconds(\n  pixels: number,\n  samplesPerPixel: number,\n  sampleRate: number\n): number {\n  return (pixels * samplesPerPixel) / sampleRate;\n}\n\nexport function secondsToPixels(\n  seconds: number,\n  samplesPerPixel: number,\n  sampleRate: number\n): number {\n  return Math.ceil((seconds * sampleRate) / samplesPerPixel);\n}\n"],"mappings":"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","names":["InteractionState"]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@waveform-playlist/core",
+  "version": "5.0.0-alpha.0",
+  "description": "Core types, interfaces and utilities for waveform-playlist",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "keywords": [
+    "waveform",
+    "audio",
+    "webaudio",
+    "waveform-playlist",
+    "types"
+  ],
+  "author": "Naomi Aro",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/naomiaro/waveform-playlist.git",
+    "directory": "packages/core"
+  },
+  "homepage": "https://naomiaro.github.io/waveform-playlist",
+  "bugs": {
+    "url": "https://github.com/naomiaro/waveform-playlist/issues"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "devDependencies": {
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3"
+  },
+  "dependencies": {},
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}