@waveform-playlist/core 11.3.0 → 12.0.0

package/dist/index.d.mts

@@ -180,6 +180,12 @@ interface AudioClip {
     audioBuffer?: AudioBuffer;
     /** Position on timeline where this clip starts (in samples at timeline sampleRate) */
     startSample: number;
+    /**
+     * Position on timeline in ticks (authoritative when present).
+     * When set, startSample is a derived cache recomputed from startTick via TempoMap.
+     * Optional for backwards compatibility — engine enriches clips without startTick on ingestion.
+     */
+    startTick?: 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 */
@@ -285,6 +291,7 @@ interface CreateClipOptions {
     /** Audio buffer - optional for peaks-first rendering */
     audioBuffer?: AudioBuffer;
     startSample: number;
+    startTick?: number;
     durationSamples?: number;
     offsetSamples?: number;
     gain?: number;
@@ -315,6 +322,7 @@ interface CreateClipOptionsSeconds {
     /** Audio buffer - optional for peaks-first rendering */
     audioBuffer?: AudioBuffer;
     startTime: number;
+    startTick?: number;
     duration?: number;
     offset?: number;
     gain?: number;
@@ -335,6 +343,35 @@ interface CreateClipOptionsSeconds {
     /** MIDI program number (0-127). GM instrument for SoundFont playback. */
     midiProgram?: number;
 }
+/**
+ * Options for creating a new audio clip from tick position.
+ * startTick is authoritative; startSample is derived.
+ *
+ * Provide either:
+ * - ticksToSeconds callback (for variable-tempo / multi-tempo), or
+ * - bpm + ppqn (for single-tempo convenience)
+ */
+interface CreateClipOptionsTicks {
+    startTick: number;
+    ticksToSeconds?: (tick: number) => number;
+    bpm?: number;
+    ppqn?: number;
+    audioBuffer?: AudioBuffer;
+    durationSamples?: number;
+    offsetSamples?: number;
+    gain?: number;
+    name?: string;
+    color?: string;
+    fadeIn?: Fade;
+    fadeOut?: Fade;
+    waveformData?: WaveformDataObject;
+    sampleRate?: number;
+    sourceDurationSamples?: number;
+    midiNotes?: MidiNoteData[];
+    midiChannel?: number;
+    midiProgram?: number;
+}
+declare function createClipFromTicks(options: CreateClipOptionsTicks): AudioClip;
 /**
  * Options for creating a new track
  */
@@ -614,8 +651,6 @@ declare function ticksToSamples(ticks: number, bpm: number, sampleRate: number,
 declare function samplesToTicks(samples: number, bpm: number, sampleRate: number, ppqn?: number): number;
 /** Snap a tick position to the nearest grid line (rounds to nearest). */
 declare function snapToGrid(ticks: number, gridSizeTicks: number): number;
-/** Format ticks as a 1-indexed bar.beat label. Beat 1 shows bar number only (e.g., "3" not "3.1"). */
-declare function ticksToBarBeatLabel(ticks: number, timeSignature: [number, number], ppqn?: number): string;
 
 /**
  * Convert a dB value to a normalized range.
@@ -639,6 +674,13 @@ declare function dBToNormalized(dB: number, floor?: number): number;
  * @returns dB value (floor at 0, 0 dB at 1, positive dB above 1)
  */
 declare function normalizedToDb(normalized: number, floor?: number): number;
+/**
+ * Convert a linear gain value to decibels.
+ *
+ * @param gain - Linear gain (0 = silence, 1 = unity)
+ * @returns Decibel value (e.g., 0.5 → ≈ -6.02 dB)
+ */
+declare function gainToDb(gain: number): number;
 /**
  * Convert a linear gain value (0-1+) to normalized 0-1 via dB.
  *
@@ -652,6 +694,137 @@ declare function normalizedToDb(normalized: number, floor?: number): number;
  */
 declare function gainToNormalized(gain: number, floor?: number): number;
 
+interface MeterEntry {
+    tick: number;
+    numerator: number;
+    denominator: number;
+}
+/**
+ * Scans a beat number sequence and detects meter (time signature) changes.
+ *
+ * Each beat in the input has a `beat` number (1-indexed). When the beat resets
+ * to 1, we count how many beats were in the previous bar and derive the numerator.
+ *
+ * @param beats - Array of beat events with `time` (seconds) and `beat` (1-indexed number).
+ * @param firstBeatTick - The tick position of beats[0] on the timeline.
+ * @param ppqn - Ticks per quarter note (ticks per beat).
+ * @returns Array of MeterEntry sorted by tick. Always includes an entry at tick 0.
+ */
+declare function detectMeterChanges(beats: {
+    time: number;
+    beat: number;
+}[], firstBeatTick: number, ppqn: number): MeterEntry[];
+
+/** All supported snap-to-grid values. */
+type SnapTo = 'bar' | 'beat' | '1/2' | '1/4' | '1/8' | '1/16' | '1/32' | '1/2T' | '1/4T' | '1/8T' | '1/16T' | 'off';
+/**
+ * Returns the tick interval for the given SnapTo value.
+ *
+ * Straight subdivisions (1/2, 1/4, 1/8, 1/16, 1/32) are always expressed as
+ * fractions of a quarter note (ppqn), independent of the time signature
+ * denominator.  Triplet subdivisions use × 2/3 of the corresponding straight
+ * value.  'bar' and 'beat' depend on the first meter entry's time signature.
+ * 'off' returns 0.
+ */
+declare function snapToTicks(snapTo: SnapTo, timeSignature: [number, number], ppqn?: number): number;
+/**
+ * Three-tier tick hierarchy (following Audacity's model):
+ *   major      — Bar boundaries. Always labeled, strongest grid lines.
+ *   minor      — Beat boundaries. Labeled when wide enough, medium grid lines.
+ *   minorMinor — Subdivisions (eighths, sixteenths). Never labeled, ruler ticks only (no grid).
+ */
+type TickType = 'major' | 'minor' | 'minorMinor';
+/** Zoom level category used to select which subdivision to iterate at. */
+type ZoomLevel = 'coarse' | 'bar' | 'beat' | 'eighth' | 'sixteenth';
+/** A single musical tick with rendering metadata. */
+interface MusicalTick {
+    /** Pixel position of the tick in the timeline. */
+    pixel: number;
+    /** Three-tier type: major (bar), minor (beat), minorMinor (subdivision). */
+    type: TickType;
+    /** Human-readable label. Present for major ticks always; minor ticks when zoomed in. */
+    label?: string;
+    /** 0-based global bar index (for alternating bar-level striping). */
+    barIndex: number;
+}
+/** Result of computeMusicalTicks(). */
+interface MusicalTickData {
+    ticks: MusicalTick[];
+    pixelsPerQuarterNote: number;
+    zoomLevel: ZoomLevel;
+    /** At 'coarse' zoom: how many quarter notes between rendered tick lines. */
+    coarseQuarterNoteStep?: number;
+}
+/** Parameters for computeMusicalTicks(). */
+interface MusicalTickParams {
+    meterEntries: MeterEntry[];
+    /** Ticks per pixel (zoom level — lower value = more zoomed in). */
+    ticksPerPixel: number;
+    startPixel: number;
+    endPixel: number;
+    /** Pulses per quarter note. Defaults to 960. */
+    ppqn?: number;
+}
+/** Minimum pixels per musical unit before switching to a coarser zoom level. */
+declare const MIN_PIXELS_PER_UNIT = 8;
+/**
+ * Determines the zoom level and computes which tick lines to render for a
+ * given viewport. Pure tick arithmetic — no BPM or sample rate required.
+ *
+ * Walks meter entries in segments, so bar/beat boundaries and labels are
+ * correct across meter changes.
+ */
+declare function computeMusicalTicks(params: MusicalTickParams): MusicalTickData;
+/**
+ * Snaps a tick position to the nearest grid boundary defined by `snapTo`.
+ *
+ * Finds the meter entry active at the tick position and snaps relative to
+ * that meter's segment start.
+ *
+ * Returns the original tick unchanged when `snapTo` is 'off'.
+ */
+declare function snapTickToGrid(tick: number, snapTo: SnapTo, meterEntries: MeterEntry[], ppqn?: number): number;
+
+/**
+ * Peak generation for real-time waveform visualization during recording.
+ * Matches the format used by webaudio-peaks: min/max pairs with bit depth.
+ */
+/**
+ * Generate peaks from audio samples in standard min/max pair format.
+ *
+ * @param samples - Audio samples to process
+ * @param samplesPerPixel - Number of samples to represent in each peak
+ * @param bits - Bit depth for peak values (8 or 16)
+ * @returns Int8Array or Int16Array of peak values (min/max pairs)
+ */
+declare function generatePeaks(samples: Float32Array, samplesPerPixel: number, bits?: 8 | 16): Int8Array | Int16Array;
+/**
+ * Append new peaks to existing peaks array.
+ * This is used for incremental peak updates during recording.
+ */
+declare function appendPeaks(existingPeaks: Int8Array | Int16Array, newSamples: Float32Array, samplesPerPixel: number, totalSamplesProcessed: number, bits?: 8 | 16): Int8Array | Int16Array;
+
+/**
+ * Utility functions for working with AudioBuffers during recording
+ */
+/**
+ * Concatenate multiple Float32Arrays into a single array
+ */
+declare function concatenateAudioData(chunks: Float32Array[]): Float32Array;
+/**
+ * Convert channel data to AudioBuffer.
+ * Accepts either per-channel Float32Array[] or a single Float32Array (mono, backwards compatible).
+ */
+declare function createAudioBuffer(audioContext: AudioContext, channelData: Float32Array[] | Float32Array, sampleRate: number, channelCount?: number): AudioBuffer;
+/**
+ * Append new samples to an existing AudioBuffer (mono convenience)
+ */
+declare function appendToAudioBuffer(audioContext: AudioContext, existingBuffer: AudioBuffer | null, newSamples: Float32Array, sampleRate: number): AudioBuffer;
+/**
+ * Calculate duration in seconds from sample count and sample rate
+ */
+declare function calculateDuration(sampleCount: number, sampleRate: number): number;
+
 /** Clip start position in seconds */
 declare function clipStartTime(clip: AudioClip): number;
 /** Clip end position in seconds (start + duration) */
@@ -660,6 +833,11 @@ declare function clipEndTime(clip: AudioClip): number;
 declare function clipOffsetTime(clip: AudioClip): number;
 /** Clip duration in seconds */
 declare function clipDurationTime(clip: AudioClip): number;
+/**
+ * Max audio channel count across a track's clips.
+ * Used to set Panner channelCount and offline render output channels.
+ */
+declare function trackChannelCount(track: ClipTrack): number;
 /**
  * Clip width in pixels at a given samplesPerPixel.
  * Shared by Clip.tsx (container sizing) and ChannelWithProgress.tsx (progress overlay)
@@ -745,4 +923,4 @@ declare function handleKeyboardEvent(event: KeyboardEvent, shortcuts: KeyboardSh
  */
 declare const getShortcutLabel: (shortcut: KeyboardShortcut) => string;
 
-export { type AnnotationAction, type AnnotationActionOptions, type AnnotationData, type AnnotationEventMap, type AnnotationFormat, type AnnotationListOptions, type AudioBuffer$1 as AudioBuffer, type AudioClip, type Bits, type ClipTrack, type ColorMapEntry, type ColorMapName, type ColorMapValue, type CreateClipOptions, type CreateClipOptionsSeconds, type CreateTrackOptions, type FFTSize, type Fade, type FadeConfig, type FadeType, type Gap, InteractionState, type KeyboardShortcut, MAX_CANVAS_WIDTH, type MidiNoteData, PPQN, type PeakData, type Peaks, type PlaylistConfig, type PlayoutState, type RenderAnnotationItemProps, type RenderMode, type SpectrogramComputeConfig, type SpectrogramConfig, type SpectrogramData, type SpectrogramDisplayConfig, type TimeSelection, type Timeline, type Track, type TrackEffectsFunction, type TrackSpectrogramOverrides, type WaveformConfig, type WaveformDataObject, applyFadeIn, applyFadeOut, clipDurationTime, clipEndTime, clipOffsetTime, clipPixelWidth, clipStartTime, clipsOverlap, createClip, createClipFromSeconds, createTimeline, createTrack, dBToNormalized, exponentialCurve, findGaps, gainToNormalized, generateCurve, getClipsAtSample, getClipsInRange, getShortcutLabel, handleKeyboardEvent, linearCurve, logarithmicCurve, normalizedToDb, pixelsToSamples, pixelsToSeconds, sCurveCurve, samplesToPixels, samplesToSeconds, samplesToTicks, secondsToPixels, secondsToSamples, snapToGrid, sortClipsByTime, ticksPerBar, ticksPerBeat, ticksToBarBeatLabel, ticksToSamples };
+export { type AnnotationAction, type AnnotationActionOptions, type AnnotationData, type AnnotationEventMap, type AnnotationFormat, type AnnotationListOptions, type AudioBuffer$1 as AudioBuffer, type AudioClip, type Bits, type ClipTrack, type ColorMapEntry, type ColorMapName, type ColorMapValue, type CreateClipOptions, type CreateClipOptionsSeconds, type CreateClipOptionsTicks, type CreateTrackOptions, type FFTSize, type Fade, type FadeConfig, type FadeType, type Gap, InteractionState, type KeyboardShortcut, MAX_CANVAS_WIDTH, MIN_PIXELS_PER_UNIT, type MeterEntry, type MidiNoteData, type MusicalTick, type MusicalTickData, type MusicalTickParams, PPQN, type PeakData, type Peaks, type PlaylistConfig, type PlayoutState, type RenderAnnotationItemProps, type RenderMode, type SnapTo, type SpectrogramComputeConfig, type SpectrogramConfig, type SpectrogramData, type SpectrogramDisplayConfig, type TickType, type TimeSelection, type Timeline, type Track, type TrackEffectsFunction, type TrackSpectrogramOverrides, type WaveformConfig, type WaveformDataObject, type ZoomLevel, appendPeaks, appendToAudioBuffer, applyFadeIn, applyFadeOut, calculateDuration, clipDurationTime, clipEndTime, clipOffsetTime, clipPixelWidth, clipStartTime, clipsOverlap, computeMusicalTicks, concatenateAudioData, createAudioBuffer, createClip, createClipFromSeconds, createClipFromTicks, createTimeline, createTrack, dBToNormalized, detectMeterChanges, exponentialCurve, findGaps, gainToDb, gainToNormalized, generateCurve, generatePeaks, getClipsAtSample, getClipsInRange, getShortcutLabel, handleKeyboardEvent, linearCurve, logarithmicCurve, normalizedToDb, pixelsToSamples, pixelsToSeconds, sCurveCurve, samplesToPixels, samplesToSeconds, samplesToTicks, secondsToPixels, secondsToSamples, snapTickToGrid, snapToGrid, snapToTicks, sortClipsByTime, ticksPerBar, ticksPerBeat, ticksToSamples, trackChannelCount };

package/dist/index.d.ts

@@ -180,6 +180,12 @@ interface AudioClip {
     audioBuffer?: AudioBuffer;
     /** Position on timeline where this clip starts (in samples at timeline sampleRate) */
     startSample: number;
+    /**
+     * Position on timeline in ticks (authoritative when present).
+     * When set, startSample is a derived cache recomputed from startTick via TempoMap.
+     * Optional for backwards compatibility — engine enriches clips without startTick on ingestion.
+     */
+    startTick?: 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 */
@@ -285,6 +291,7 @@ interface CreateClipOptions {
     /** Audio buffer - optional for peaks-first rendering */
     audioBuffer?: AudioBuffer;
     startSample: number;
+    startTick?: number;
     durationSamples?: number;
     offsetSamples?: number;
     gain?: number;
@@ -315,6 +322,7 @@ interface CreateClipOptionsSeconds {
     /** Audio buffer - optional for peaks-first rendering */
     audioBuffer?: AudioBuffer;
     startTime: number;
+    startTick?: number;
     duration?: number;
     offset?: number;
     gain?: number;
@@ -335,6 +343,35 @@ interface CreateClipOptionsSeconds {
     /** MIDI program number (0-127). GM instrument for SoundFont playback. */
     midiProgram?: number;
 }
+/**
+ * Options for creating a new audio clip from tick position.
+ * startTick is authoritative; startSample is derived.
+ *
+ * Provide either:
+ * - ticksToSeconds callback (for variable-tempo / multi-tempo), or
+ * - bpm + ppqn (for single-tempo convenience)
+ */
+interface CreateClipOptionsTicks {
+    startTick: number;
+    ticksToSeconds?: (tick: number) => number;
+    bpm?: number;
+    ppqn?: number;
+    audioBuffer?: AudioBuffer;
+    durationSamples?: number;
+    offsetSamples?: number;
+    gain?: number;
+    name?: string;
+    color?: string;
+    fadeIn?: Fade;
+    fadeOut?: Fade;
+    waveformData?: WaveformDataObject;
+    sampleRate?: number;
+    sourceDurationSamples?: number;
+    midiNotes?: MidiNoteData[];
+    midiChannel?: number;
+    midiProgram?: number;
+}
+declare function createClipFromTicks(options: CreateClipOptionsTicks): AudioClip;
 /**
  * Options for creating a new track
  */
@@ -614,8 +651,6 @@ declare function ticksToSamples(ticks: number, bpm: number, sampleRate: number,
 declare function samplesToTicks(samples: number, bpm: number, sampleRate: number, ppqn?: number): number;
 /** Snap a tick position to the nearest grid line (rounds to nearest). */
 declare function snapToGrid(ticks: number, gridSizeTicks: number): number;
-/** Format ticks as a 1-indexed bar.beat label. Beat 1 shows bar number only (e.g., "3" not "3.1"). */
-declare function ticksToBarBeatLabel(ticks: number, timeSignature: [number, number], ppqn?: number): string;
 
 /**
  * Convert a dB value to a normalized range.
@@ -639,6 +674,13 @@ declare function dBToNormalized(dB: number, floor?: number): number;
  * @returns dB value (floor at 0, 0 dB at 1, positive dB above 1)
  */
 declare function normalizedToDb(normalized: number, floor?: number): number;
+/**
+ * Convert a linear gain value to decibels.
+ *
+ * @param gain - Linear gain (0 = silence, 1 = unity)
+ * @returns Decibel value (e.g., 0.5 → ≈ -6.02 dB)
+ */
+declare function gainToDb(gain: number): number;
 /**
  * Convert a linear gain value (0-1+) to normalized 0-1 via dB.
  *
@@ -652,6 +694,137 @@ declare function normalizedToDb(normalized: number, floor?: number): number;
  */
 declare function gainToNormalized(gain: number, floor?: number): number;
 
+interface MeterEntry {
+    tick: number;
+    numerator: number;
+    denominator: number;
+}
+/**
+ * Scans a beat number sequence and detects meter (time signature) changes.
+ *
+ * Each beat in the input has a `beat` number (1-indexed). When the beat resets
+ * to 1, we count how many beats were in the previous bar and derive the numerator.
+ *
+ * @param beats - Array of beat events with `time` (seconds) and `beat` (1-indexed number).
+ * @param firstBeatTick - The tick position of beats[0] on the timeline.
+ * @param ppqn - Ticks per quarter note (ticks per beat).
+ * @returns Array of MeterEntry sorted by tick. Always includes an entry at tick 0.
+ */
+declare function detectMeterChanges(beats: {
+    time: number;
+    beat: number;
+}[], firstBeatTick: number, ppqn: number): MeterEntry[];
+
+/** All supported snap-to-grid values. */
+type SnapTo = 'bar' | 'beat' | '1/2' | '1/4' | '1/8' | '1/16' | '1/32' | '1/2T' | '1/4T' | '1/8T' | '1/16T' | 'off';
+/**
+ * Returns the tick interval for the given SnapTo value.
+ *
+ * Straight subdivisions (1/2, 1/4, 1/8, 1/16, 1/32) are always expressed as
+ * fractions of a quarter note (ppqn), independent of the time signature
+ * denominator.  Triplet subdivisions use × 2/3 of the corresponding straight
+ * value.  'bar' and 'beat' depend on the first meter entry's time signature.
+ * 'off' returns 0.
+ */
+declare function snapToTicks(snapTo: SnapTo, timeSignature: [number, number], ppqn?: number): number;
+/**
+ * Three-tier tick hierarchy (following Audacity's model):
+ *   major      — Bar boundaries. Always labeled, strongest grid lines.
+ *   minor      — Beat boundaries. Labeled when wide enough, medium grid lines.
+ *   minorMinor — Subdivisions (eighths, sixteenths). Never labeled, ruler ticks only (no grid).
+ */
+type TickType = 'major' | 'minor' | 'minorMinor';
+/** Zoom level category used to select which subdivision to iterate at. */
+type ZoomLevel = 'coarse' | 'bar' | 'beat' | 'eighth' | 'sixteenth';
+/** A single musical tick with rendering metadata. */
+interface MusicalTick {
+    /** Pixel position of the tick in the timeline. */
+    pixel: number;
+    /** Three-tier type: major (bar), minor (beat), minorMinor (subdivision). */
+    type: TickType;
+    /** Human-readable label. Present for major ticks always; minor ticks when zoomed in. */
+    label?: string;
+    /** 0-based global bar index (for alternating bar-level striping). */
+    barIndex: number;
+}
+/** Result of computeMusicalTicks(). */
+interface MusicalTickData {
+    ticks: MusicalTick[];
+    pixelsPerQuarterNote: number;
+    zoomLevel: ZoomLevel;
+    /** At 'coarse' zoom: how many quarter notes between rendered tick lines. */
+    coarseQuarterNoteStep?: number;
+}
+/** Parameters for computeMusicalTicks(). */
+interface MusicalTickParams {
+    meterEntries: MeterEntry[];
+    /** Ticks per pixel (zoom level — lower value = more zoomed in). */
+    ticksPerPixel: number;
+    startPixel: number;
+    endPixel: number;
+    /** Pulses per quarter note. Defaults to 960. */
+    ppqn?: number;
+}
+/** Minimum pixels per musical unit before switching to a coarser zoom level. */
+declare const MIN_PIXELS_PER_UNIT = 8;
+/**
+ * Determines the zoom level and computes which tick lines to render for a
+ * given viewport. Pure tick arithmetic — no BPM or sample rate required.
+ *
+ * Walks meter entries in segments, so bar/beat boundaries and labels are
+ * correct across meter changes.
+ */
+declare function computeMusicalTicks(params: MusicalTickParams): MusicalTickData;
+/**
+ * Snaps a tick position to the nearest grid boundary defined by `snapTo`.
+ *
+ * Finds the meter entry active at the tick position and snaps relative to
+ * that meter's segment start.
+ *
+ * Returns the original tick unchanged when `snapTo` is 'off'.
+ */
+declare function snapTickToGrid(tick: number, snapTo: SnapTo, meterEntries: MeterEntry[], ppqn?: number): number;
+
+/**
+ * Peak generation for real-time waveform visualization during recording.
+ * Matches the format used by webaudio-peaks: min/max pairs with bit depth.
+ */
+/**
+ * Generate peaks from audio samples in standard min/max pair format.
+ *
+ * @param samples - Audio samples to process
+ * @param samplesPerPixel - Number of samples to represent in each peak
+ * @param bits - Bit depth for peak values (8 or 16)
+ * @returns Int8Array or Int16Array of peak values (min/max pairs)
+ */
+declare function generatePeaks(samples: Float32Array, samplesPerPixel: number, bits?: 8 | 16): Int8Array | Int16Array;
+/**
+ * Append new peaks to existing peaks array.
+ * This is used for incremental peak updates during recording.
+ */
+declare function appendPeaks(existingPeaks: Int8Array | Int16Array, newSamples: Float32Array, samplesPerPixel: number, totalSamplesProcessed: number, bits?: 8 | 16): Int8Array | Int16Array;
+
+/**
+ * Utility functions for working with AudioBuffers during recording
+ */
+/**
+ * Concatenate multiple Float32Arrays into a single array
+ */
+declare function concatenateAudioData(chunks: Float32Array[]): Float32Array;
+/**
+ * Convert channel data to AudioBuffer.
+ * Accepts either per-channel Float32Array[] or a single Float32Array (mono, backwards compatible).
+ */
+declare function createAudioBuffer(audioContext: AudioContext, channelData: Float32Array[] | Float32Array, sampleRate: number, channelCount?: number): AudioBuffer;
+/**
+ * Append new samples to an existing AudioBuffer (mono convenience)
+ */
+declare function appendToAudioBuffer(audioContext: AudioContext, existingBuffer: AudioBuffer | null, newSamples: Float32Array, sampleRate: number): AudioBuffer;
+/**
+ * Calculate duration in seconds from sample count and sample rate
+ */
+declare function calculateDuration(sampleCount: number, sampleRate: number): number;
+
 /** Clip start position in seconds */
 declare function clipStartTime(clip: AudioClip): number;
 /** Clip end position in seconds (start + duration) */
@@ -660,6 +833,11 @@ declare function clipEndTime(clip: AudioClip): number;
 declare function clipOffsetTime(clip: AudioClip): number;
 /** Clip duration in seconds */
 declare function clipDurationTime(clip: AudioClip): number;
+/**
+ * Max audio channel count across a track's clips.
+ * Used to set Panner channelCount and offline render output channels.
+ */
+declare function trackChannelCount(track: ClipTrack): number;
 /**
  * Clip width in pixels at a given samplesPerPixel.
  * Shared by Clip.tsx (container sizing) and ChannelWithProgress.tsx (progress overlay)
@@ -745,4 +923,4 @@ declare function handleKeyboardEvent(event: KeyboardEvent, shortcuts: KeyboardSh
  */
 declare const getShortcutLabel: (shortcut: KeyboardShortcut) => string;
 
-export { type AnnotationAction, type AnnotationActionOptions, type AnnotationData, type AnnotationEventMap, type AnnotationFormat, type AnnotationListOptions, type AudioBuffer$1 as AudioBuffer, type AudioClip, type Bits, type ClipTrack, type ColorMapEntry, type ColorMapName, type ColorMapValue, type CreateClipOptions, type CreateClipOptionsSeconds, type CreateTrackOptions, type FFTSize, type Fade, type FadeConfig, type FadeType, type Gap, InteractionState, type KeyboardShortcut, MAX_CANVAS_WIDTH, type MidiNoteData, PPQN, type PeakData, type Peaks, type PlaylistConfig, type PlayoutState, type RenderAnnotationItemProps, type RenderMode, type SpectrogramComputeConfig, type SpectrogramConfig, type SpectrogramData, type SpectrogramDisplayConfig, type TimeSelection, type Timeline, type Track, type TrackEffectsFunction, type TrackSpectrogramOverrides, type WaveformConfig, type WaveformDataObject, applyFadeIn, applyFadeOut, clipDurationTime, clipEndTime, clipOffsetTime, clipPixelWidth, clipStartTime, clipsOverlap, createClip, createClipFromSeconds, createTimeline, createTrack, dBToNormalized, exponentialCurve, findGaps, gainToNormalized, generateCurve, getClipsAtSample, getClipsInRange, getShortcutLabel, handleKeyboardEvent, linearCurve, logarithmicCurve, normalizedToDb, pixelsToSamples, pixelsToSeconds, sCurveCurve, samplesToPixels, samplesToSeconds, samplesToTicks, secondsToPixels, secondsToSamples, snapToGrid, sortClipsByTime, ticksPerBar, ticksPerBeat, ticksToBarBeatLabel, ticksToSamples };
+export { type AnnotationAction, type AnnotationActionOptions, type AnnotationData, type AnnotationEventMap, type AnnotationFormat, type AnnotationListOptions, type AudioBuffer$1 as AudioBuffer, type AudioClip, type Bits, type ClipTrack, type ColorMapEntry, type ColorMapName, type ColorMapValue, type CreateClipOptions, type CreateClipOptionsSeconds, type CreateClipOptionsTicks, type CreateTrackOptions, type FFTSize, type Fade, type FadeConfig, type FadeType, type Gap, InteractionState, type KeyboardShortcut, MAX_CANVAS_WIDTH, MIN_PIXELS_PER_UNIT, type MeterEntry, type MidiNoteData, type MusicalTick, type MusicalTickData, type MusicalTickParams, PPQN, type PeakData, type Peaks, type PlaylistConfig, type PlayoutState, type RenderAnnotationItemProps, type RenderMode, type SnapTo, type SpectrogramComputeConfig, type SpectrogramConfig, type SpectrogramData, type SpectrogramDisplayConfig, type TickType, type TimeSelection, type Timeline, type Track, type TrackEffectsFunction, type TrackSpectrogramOverrides, type WaveformConfig, type WaveformDataObject, type ZoomLevel, appendPeaks, appendToAudioBuffer, applyFadeIn, applyFadeOut, calculateDuration, clipDurationTime, clipEndTime, clipOffsetTime, clipPixelWidth, clipStartTime, clipsOverlap, computeMusicalTicks, concatenateAudioData, createAudioBuffer, createClip, createClipFromSeconds, createClipFromTicks, createTimeline, createTrack, dBToNormalized, detectMeterChanges, exponentialCurve, findGaps, gainToDb, gainToNormalized, generateCurve, generatePeaks, getClipsAtSample, getClipsInRange, getShortcutLabel, handleKeyboardEvent, linearCurve, logarithmicCurve, normalizedToDb, pixelsToSamples, pixelsToSeconds, sCurveCurve, samplesToPixels, samplesToSeconds, samplesToTicks, secondsToPixels, secondsToSamples, snapTickToGrid, snapToGrid, snapToTicks, sortClipsByTime, ticksPerBar, ticksPerBeat, ticksToSamples, trackChannelCount };