@libraz/libsonare 1.7.2 → 1.8.0

package/dist/feature_inverse.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Inverse transforms: reconstructing a linear spectrogram or audio from a mel
+ * or MFCC representation, and the phase reconstruction they share.
+ */
+import type { GuardedOptions } from './_feature_validation';
+import type { SpectralFrameRequest } from './feature_spectral';
+import type { MelPowerResult, StftPowerResult } from './public_types';
+export interface MfccToMelRequest extends GuardedOptions {
+    mfccCoefficients: Float32Array;
+    nMfcc: number;
+    nFrames: number;
+    nMels?: number;
+    /** Lifter used by the forward MFCC transform; zero means no liftering. */
+    lifter?: number;
+}
+/** Canonical request form for reconstruction from a Mel power spectrogram. */
+export interface MelToStftRequest extends GuardedOptions {
+    melPower: Float32Array;
+    nMels: number;
+    nFrames: number;
+    sampleRate?: number;
+    nFft?: number;
+    fmin?: number;
+    fmax?: number;
+    htk?: boolean;
+}
+/** Canonical request form for Griffin-Lim reconstruction from Mel power. */
+export interface MelToAudioRequest extends MelToStftRequest {
+    hopLength?: number;
+    nIter?: number;
+}
+export interface GriffinLimRequest extends GuardedOptions {
+    magnitude: Float32Array;
+    nBins: number;
+    nFrames: number;
+    sampleRate?: number;
+    nFft?: number;
+    hopLength?: number;
+    nIter?: number;
+    momentum?: number;
+}
+/** Canonical request form for Griffin-Lim reconstruction from MFCCs. */
+export interface MfccToAudioRequest extends MfccToMelRequest {
+    sampleRate?: number;
+    nFft?: number;
+    hopLength?: number;
+    fmin?: number;
+    fmax?: number;
+    nIter?: number;
+    htk?: boolean;
+}
+/**
+ * Approximate inverse of a Mel filterbank: Mel power spectrogram -> STFT power
+ * spectrogram. Mirrors `feature::mel_to_stft`.
+ *
+ * @param melPower - Mel power spectrogram [nMels x nFrames] row-major
+ * @param nMels - Number of Mel bands
+ * @param nFrames - Number of time frames
+ * @param sampleRate - Sample rate in Hz
+ * @param nFft - FFT size (default: 2048)
+ * @param fmin - Lower Mel band edge in Hz (default: 0)
+ * @param fmax - Upper Mel band edge in Hz (default: sr/2 when 0)
+ * @param htk - Use the HTK Mel formula instead of Slaney (default: false)
+ * @returns STFT power spectrogram result
+ */
+export declare function melToStft(request: MelToStftRequest): StftPowerResult;
+export declare function melToStft(melPower: Float32Array, nMels: number, nFrames: number, sampleRate?: number, nFft?: number, fmin?: number, fmax?: number, htk?: boolean, options?: GuardedOptions): StftPowerResult;
+/**
+ * Reconstruct audio from a Mel power spectrogram via Griffin-Lim. Mirrors
+ * `feature::mel_to_audio`.
+ *
+ * @param melPower - Mel power spectrogram [nMels x nFrames] row-major
+ * @param nMels - Number of Mel bands
+ * @param nFrames - Number of time frames
+ * @param sampleRate - Sample rate in Hz
+ * @param nFft - FFT size (default: 2048)
+ * @param hopLength - Hop length (default: 512)
+ * @param fmin - Minimum Mel frequency in Hz (default: 0)
+ * @param fmax - Maximum Mel frequency in Hz (default: 0 = sr/2)
+ * @param nIter - Griffin-Lim iterations (default: 32)
+ * @param htk - Use the HTK Mel formula instead of Slaney (default: false)
+ * @returns Reconstructed audio samples (mono, float32)
+ */
+export declare function melToAudio(request: MelToAudioRequest): Float32Array;
+export declare function melToAudio(melPower: Float32Array, nMels: number, nFrames: number, sampleRate?: number, nFft?: number, hopLength?: number, fmin?: number, fmax?: number, nIter?: number, htk?: boolean, options?: GuardedOptions): Float32Array;
+/** Reconstruct audio from an STFT magnitude matrix via Griffin-Lim. */
+export declare function griffinLim(request: GriffinLimRequest): Float32Array;
+export declare function griffinLim(magnitude: Float32Array, nBins: number, nFrames: number, sampleRate?: number, nFft?: number, hopLength?: number, nIter?: number, momentum?: number, options?: GuardedOptions): Float32Array;
+/**
+ * Invert MFCC coefficients back to a Mel power spectrogram. Mirrors
+ * `feature::mfcc_to_mel`.
+ *
+ * @param mfccCoefficients - MFCC matrix [nMfcc x nFrames] row-major
+ * @param nMfcc - Number of MFCC coefficients
+ * @param nFrames - Number of time frames
+ * @param nMels - Number of Mel bins to reconstruct (default: 128)
+ * @returns Mel power spectrogram result
+ */
+export declare function mfccToMel(request: MfccToMelRequest): MelPowerResult;
+export declare function mfccToMel(mfccCoefficients: Float32Array, nMfcc: number, nFrames: number, nMels?: number, lifter?: number, options?: GuardedOptions): MelPowerResult;
+/**
+ * Reconstruct audio directly from MFCC coefficients via Griffin-Lim. Mirrors
+ * `feature::mfcc_to_audio`.
+ *
+ * @param mfccCoefficients - MFCC matrix [nMfcc x nFrames] row-major
+ * @param nMfcc - Number of MFCC coefficients
+ * @param nFrames - Number of time frames
+ * @param nMels - Number of Mel bins (default: 128)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param nFft - FFT size (default: 2048)
+ * @param hopLength - Hop length (default: 512)
+ * @param fmin - Minimum Mel frequency in Hz (default: 0)
+ * @param fmax - Maximum Mel frequency in Hz (default: 0 = sr/2)
+ * @param nIter - Griffin-Lim iterations (default: 32)
+ * @param htk - Use the HTK Mel formula instead of Slaney (default: false)
+ * @returns Reconstructed audio samples (mono, float32)
+ */
+export declare function mfccToAudio(request: MfccToAudioRequest): Float32Array;
+export declare function mfccToAudio(mfccCoefficients: Float32Array, nMfcc: number, nFrames: number, nMels?: number, sampleRate?: number, nFft?: number, hopLength?: number, fmin?: number, fmax?: number, nIter?: number, htk?: boolean, lifter?: number, options?: GuardedOptions): Float32Array;
+export interface PhaseVocoderRequest extends SpectralFrameRequest {
+    rate: number;
+}
+/**
+ * Phase-vocoder time-scale modification (rate > 1 faster, < 1 slower).
+ */
+export declare function phaseVocoder(request: PhaseVocoderRequest): Float32Array;
+export declare function phaseVocoder(samples: Float32Array, sampleRate: number, rate: number, nFft?: number, hopLength?: number): Float32Array;
+//# sourceMappingURL=feature_inverse.d.ts.map

package/dist/feature_inverse.d.ts.map

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

package/dist/feature_loudness.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Programme loudness over interleaved audio, as the broadcast standards define
+ * it.
+ */
+import type { WasmLufsResult, WasmLufsSeriesResult } from './sonare.js';
+import type { ValidateOptions } from './validation';
+export interface LufsInterleavedRequest extends ValidateOptions {
+    samples: Float32Array;
+    channels: number;
+    sampleRate?: number;
+}
+export interface LufsSeriesInterleavedRequest extends ValidateOptions {
+    samples: Float32Array;
+    channels: number;
+    sampleRate?: number;
+}
+export interface Ebur128LoudnessRangeRequest extends ValidateOptions {
+    samples: Float32Array;
+    sampleRate?: number;
+}
+/**
+ * Channel-weighted multichannel integrated loudness + LRA (ITU-R BS.1770 /
+ * EBU R128) from an interleaved buffer of `frames * channels` samples. The
+ * per-channel frame count is derived from the buffer length and `channels`.
+ *
+ * Pass the buffer's actual `sampleRate`: the default (22050) is non-standard for
+ * audio, and K-weighting is sample-rate dependent, so a wrong rate yields wrong
+ * loudness.
+ */
+export declare function lufsInterleaved(request: LufsInterleavedRequest): WasmLufsResult;
+export declare function lufsInterleaved(samples: Float32Array, channels: number, sampleRate?: number, options?: ValidateOptions): WasmLufsResult;
+/**
+ * Per-block momentary (400 ms) and short-term (3 s) LUFS series for an
+ * interleaved buffer of `frames * channels` samples, measured with ITU-R
+ * BS.1770-4 channel summing. The per-channel frame count is derived from the
+ * buffer length and `channels`.
+ *
+ * This is not recoverable from `momentaryLufs` / `shortTermLufs`: those measure
+ * one channel each, and the standard sums the K-weighted per-channel block
+ * energies rather than mixing per-channel loudness in dB. Both series come out
+ * of one K-weighting pass. For `channels === 1` they match the mono meters
+ * element for element.
+ *
+ * Pass the buffer's actual `sampleRate`: the default (22050) is non-standard for
+ * audio, and K-weighting is sample-rate dependent, so a wrong rate yields wrong
+ * loudness.
+ *
+ * @example
+ * ```ts
+ * const { momentary, shortTerm } = lufsSeriesInterleaved({
+ *   samples: interleavedStereo,
+ *   channels: 2,
+ *   sampleRate: 48000,
+ * });
+ * ```
+ */
+export declare function lufsSeriesInterleaved(request: LufsSeriesInterleavedRequest): WasmLufsSeriesResult;
+export declare function lufsSeriesInterleaved(samples: Float32Array, channels: number, sampleRate?: number, options?: ValidateOptions): WasmLufsSeriesResult;
+/**
+ * Standards-compliant EBU R128 loudness range (LRA) in LU. Pass the buffer's
+ * actual `sampleRate`: the default (22050) is non-standard and K-weighting is
+ * sample-rate dependent.
+ */
+export declare function ebur128LoudnessRange(request: Ebur128LoudnessRangeRequest): number;
+export declare function ebur128LoudnessRange(samples: Float32Array, sampleRate?: number): number;
+//# sourceMappingURL=feature_loudness.d.ts.map

package/dist/feature_loudness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature_loudness.d.ts","sourceRoot":"","sources":["../src/feature_loudness.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAOpD,MAAM,WAAW,sBAAuB,SAAQ,eAAe;IAC7D,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,4BAA6B,SAAQ,eAAe;IACnE,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,2BAA4B,SAAQ,eAAe;IAClE,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,cAAc,CAAC;AACjF,wBAAgB,eAAe,CAC7B,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,eAAe,GACxB,cAAc,CAAC;AAgBlB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,4BAA4B,GAAG,oBAAoB,CAAC;AACnG,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,eAAe,GACxB,oBAAoB,CAAC;AAgBxB;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,2BAA2B,GAAG,MAAM,CAAC;AACnF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC"}

package/dist/feature_music.d.ts

@@ -0,0 +1,307 @@
+import type { AnalyzeSectionsOptions, BoundaryOptions, BoundaryResult, CqtResult, LufsResult, MelodyResult, OnsetStrengthMultiResult, Section } from './public_types';
+import type { WasmFourierTempogramResult, WasmNnlsChromaResult } from './sonare.js';
+import type { ValidateOptions } from './validation';
+type GuardedOptions = ValidateOptions;
+type AnalyzeSectionsGuardedOptions = AnalyzeSectionsOptions & ValidateOptions;
+type BoundaryGuardedOptions = BoundaryOptions & ValidateOptions;
+type MelodyGuardedOptions = MelodyOptions & ValidateOptions;
+/** Canonical request form shared by the Constant-Q transform variants. */
+export interface CqtRequest extends GuardedOptions {
+    samples: Float32Array;
+    sampleRate?: number;
+    hopLength?: number;
+    fmin?: number;
+    nBins?: number;
+    binsPerOctave?: number;
+}
+/** Canonical request form for {@link vqt}. */
+export interface VqtRequest extends CqtRequest {
+    gamma?: number;
+}
+export interface OnsetEnvelopeRequest extends GuardedOptions {
+    samples: Float32Array;
+    sampleRate?: number;
+    nFft?: number;
+    hopLength?: number;
+    nMels?: number;
+}
+export interface OnsetStrengthMultiRequest extends OnsetEnvelopeRequest {
+    nBands?: number;
+}
+export interface FourierTempogramRequest extends GuardedOptions {
+    onsetEnvelope: Float32Array;
+    sampleRate?: number;
+    hopLength?: number;
+    winLength?: number;
+    center?: boolean;
+    norm?: boolean;
+}
+export interface TempogramRatioRequest extends GuardedOptions {
+    tempogramData: Float32Array;
+    winLength?: number;
+    sampleRate?: number;
+    hopLength?: number;
+    factors?: Float32Array | number[];
+}
+export interface CqtToAudioRequest extends GuardedOptions {
+    magnitude: Float32Array;
+    nBins: number;
+    nFrames: number;
+    sampleRate?: number;
+    hopLength?: number;
+    fmin?: number;
+    binsPerOctave?: number;
+    nIter?: number;
+}
+export interface VqtToAudioRequest extends CqtToAudioRequest {
+    gamma?: number;
+}
+export interface AnalyzeSectionsRequest extends AnalyzeSectionsGuardedOptions {
+    samples: Float32Array;
+    sampleRate?: number;
+}
+/** Canonical (and only) call form for {@link detectBoundaries}. */
+export interface DetectBoundariesRequest extends BoundaryGuardedOptions {
+    samples: Float32Array;
+    sampleRate?: number;
+}
+export interface AnalyzeMelodyRequest extends MelodyGuardedOptions {
+    samples: Float32Array;
+    sampleRate?: number;
+}
+export interface LufsRequest extends ValidateOptions {
+    samples: Float32Array;
+    sampleRate?: number;
+}
+export interface NnlsChromaRequest extends GuardedOptions {
+    samples: Float32Array;
+    sampleRate?: number;
+    enableStftBlend?: boolean;
+    stftBlendWeight?: number;
+    stftBlendNFft?: number;
+    hopLength?: number;
+}
+/**
+ * Compute NNLS (non-negative least squares) chromagram.
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @returns NNLS chroma result
+ */
+export declare function nnlsChroma(request: NnlsChromaRequest): WasmNnlsChromaResult;
+export declare function nnlsChroma(samples: Float32Array, sampleRate?: number, options?: Omit<NnlsChromaRequest, 'samples' | 'sampleRate'>): WasmNnlsChromaResult;
+/**
+ * Compute the Constant-Q Transform magnitude.
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param hopLength - Hop length (default: 512)
+ * @param fmin - Minimum frequency in Hz (default: 32.70319566257483, C1)
+ * @param nBins - Number of frequency bins (default: 84)
+ * @param binsPerOctave - Bins per octave (default: 12)
+ * @returns CQT magnitude result
+ */
+export declare function cqt(request: CqtRequest): CqtResult;
+export declare function cqt(samples: Float32Array, sampleRate?: number, hopLength?: number, fmin?: number, nBins?: number, binsPerOctave?: number, options?: GuardedOptions): CqtResult;
+/**
+ * Compute the pseudo Constant-Q Transform magnitude.
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param hopLength - Hop length (default: 512)
+ * @param fmin - Minimum frequency in Hz (default: 32.70319566257483, C1)
+ * @param nBins - Number of frequency bins (default: 84)
+ * @param binsPerOctave - Bins per octave (default: 12)
+ * @returns CQT magnitude result
+ */
+export declare function pseudoCqt(request: CqtRequest): CqtResult;
+export declare function pseudoCqt(samples: Float32Array, sampleRate?: number, hopLength?: number, fmin?: number, nBins?: number, binsPerOctave?: number, options?: GuardedOptions): CqtResult;
+/**
+ * Compute the hybrid Constant-Q Transform magnitude.
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param hopLength - Hop length (default: 512)
+ * @param fmin - Minimum frequency in Hz (default: 32.70319566257483, C1)
+ * @param nBins - Number of frequency bins (default: 84)
+ * @param binsPerOctave - Bins per octave (default: 12)
+ * @returns CQT magnitude result
+ */
+export declare function hybridCqt(request: CqtRequest): CqtResult;
+export declare function hybridCqt(samples: Float32Array, sampleRate?: number, hopLength?: number, fmin?: number, nBins?: number, binsPerOctave?: number, options?: GuardedOptions): CqtResult;
+/**
+ * Compute the Variable-Q Transform magnitude (gamma controls Q).
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param hopLength - Hop length (default: 512)
+ * @param fmin - Minimum frequency in Hz (default: 32.70319566257483, C1)
+ * @param nBins - Number of frequency bins (default: 84)
+ * @param binsPerOctave - Bins per octave (default: 12)
+ * @param gamma - Bandwidth offset; a negative value or NaN selects the automatic
+ *   ERB-derived value, while 0 is equivalent to CQT (default: -1)
+ * @returns VQT magnitude result (same shape as CQT)
+ */
+export declare function vqt(request: VqtRequest): CqtResult;
+export declare function vqt(samples: Float32Array, sampleRate?: number, hopLength?: number, fmin?: number, nBins?: number, binsPerOctave?: number, gamma?: number, options?: GuardedOptions): CqtResult;
+/** Reconstruct mono audio from row-major CQT magnitude via Griffin-Lim. */
+export declare function cqtToAudio(request: CqtToAudioRequest): Float32Array;
+export declare function cqtToAudio(magnitude: Float32Array, nBins: number, nFrames: number, sampleRate?: number, hopLength?: number, fmin?: number, binsPerOctave?: number, nIter?: number, options?: GuardedOptions): Float32Array;
+/** Reconstruct mono audio from row-major VQT magnitude via Griffin-Lim. */
+export declare function vqtToAudio(request: VqtToAudioRequest): Float32Array;
+export declare function vqtToAudio(magnitude: Float32Array, nBins: number, nFrames: number, sampleRate?: number, hopLength?: number, fmin?: number, binsPerOctave?: number, gamma?: number, nIter?: number, options?: GuardedOptions): Float32Array;
+/**
+ * Detect song-structure sections (intro/verse/chorus/...).
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param nFft - FFT size (default: 2048)
+ * @param hopLength - Hop length (default: 512)
+ * @param minSectionSec - Minimum section duration in seconds (default: 4.0)
+ * @returns Array of detected sections
+ */
+export declare function analyzeSections(request: AnalyzeSectionsRequest): Section[];
+export declare function analyzeSections(samples: Float32Array, sampleRate?: number, options?: AnalyzeSectionsGuardedOptions): Section[];
+/**
+ * Detect structural boundaries and return the novelty curve behind them.
+ *
+ * This is the unlabelled layer {@link analyzeSections} is built on, not a
+ * coarser view of its output: sections are labelled spans, these are the
+ * transitions plus the continuous curve they were picked from, so a caller
+ * applying its own threshold needs this and cannot derive it from a section
+ * list.
+ *
+ * @param request - Samples, sample rate and {@link BoundaryOptions}
+ * @returns The boundaries, the novelty curve, and the analysis grid they live on
+ * @throws {@link SonareError} with `InvalidParameter` when both `useMfcc` and
+ * `useChroma` are `false`: the two feature streams are combined frame-for-frame,
+ * so with neither enabled there is nothing to combine.
+ *
+ * @example
+ * ```ts
+ * const { boundaries, noveltyCurve, noveltyPeak } = detectBoundaries({
+ *   samples,
+ *   sampleRate: 44100,
+ *   absoluteThreshold: 0.01,
+ * });
+ * // `noveltyCurve` is scaled by its own maximum; recover the raw response with
+ * // `noveltyCurve[i] * noveltyPeak`.
+ * ```
+ */
+export declare function detectBoundaries(request: DetectBoundariesRequest): BoundaryResult;
+/** Options for {@link analyzeMelody}. All fields are optional. */
+export interface MelodyOptions {
+    /** Lowest f0 (Hz) the tracker will consider. Default 65 (≈ C2). */
+    fmin?: number;
+    /** Highest f0 (Hz) the tracker will consider. Default 2093 (≈ C7). */
+    fmax?: number;
+    /** Analysis frame length in samples. Default 2048. */
+    frameLength?: number;
+    /** Hop length between frames in samples. Default 256. */
+    hopLength?: number;
+    /** Voicing confidence threshold in [0,1]; frames below are unvoiced. Default 0.1. */
+    threshold?: number;
+    /**
+     * Use the pYIN tracker (Viterbi-smoothed) instead of plain per-frame YIN.
+     * Produces a less octave-jumpy contour. Defaults to `false`.
+     */
+    usePyin?: boolean;
+    /**
+     * When {@link usePyin} is `true`, zero-pad by `frameLength / 2` so frame
+     * `i` is centered at `i * hopLength` (matches `librosa.pyin(center=True)`).
+     * Ignored by the plain-YIN path. Defaults to `true`.
+     */
+    center?: boolean;
+}
+/**
+ * Extract the melody contour from monophonic audio via YIN (or pYIN).
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param options - Tracker + tuning options ({@link MelodyOptions})
+ * @returns Melody contour with per-frame pitch points and summary stats
+ */
+export declare function analyzeMelody(request: AnalyzeMelodyRequest): MelodyResult;
+export declare function analyzeMelody(samples: Float32Array, sampleRate?: number, options?: MelodyGuardedOptions): MelodyResult;
+/**
+ * Compute the onset strength envelope.
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param nFft - FFT size (default: 2048)
+ * @param hopLength - Hop length (default: 512)
+ * @param nMels - Number of Mel bands (default: 128)
+ * @returns Onset envelope for each frame
+ */
+export declare function onsetEnvelope(request: OnsetEnvelopeRequest): Float32Array;
+export declare function onsetEnvelope(samples: Float32Array, sampleRate?: number, nFft?: number, hopLength?: number, nMels?: number, options?: GuardedOptions): Float32Array;
+/**
+ * Compute multi-band onset strength envelopes.
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param nFft - FFT size (default: 2048)
+ * @param hopLength - Hop length (default: 512)
+ * @param nMels - Number of Mel bands (default: 128)
+ * @param nBands - Number of onset bands (default: 3)
+ * @returns Multi-band onset matrix
+ */
+export declare function onsetStrengthMulti(request: OnsetStrengthMultiRequest): OnsetStrengthMultiResult;
+export declare function onsetStrengthMulti(samples: Float32Array, sampleRate?: number, nFft?: number, hopLength?: number, nMels?: number, nBands?: number, options?: GuardedOptions): OnsetStrengthMultiResult;
+/**
+ * Compute the Fourier tempogram from an onset envelope.
+ *
+ * @param onsetEnvelope - Onset strength envelope (float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param hopLength - Hop length (default: 512)
+ * @param winLength - Window length in frames (default: 384)
+ * @returns Fourier tempogram result
+ */
+export declare function fourierTempogram(request: FourierTempogramRequest): WasmFourierTempogramResult;
+export declare function fourierTempogram(onsetEnvelope: Float32Array, sampleRate?: number, hopLength?: number, winLength?: number, center?: boolean, norm?: boolean, options?: GuardedOptions): WasmFourierTempogramResult;
+/**
+ * Compute tempogram ratio features.
+ *
+ * @param tempogramData - Tempogram data (float32)
+ * @param winLength - Window length in frames (default: 384)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param hopLength - Hop length (default: 512)
+ * @param factors - Lag ratios to evaluate. When omitted or empty, the library
+ *   default {0.5, 1, 2, 3, 4} is used.
+ * @returns Tempogram ratio features (one value per factor)
+ */
+export declare function tempogramRatio(request: TempogramRatioRequest): Float32Array;
+export declare function tempogramRatio(tempogramData: Float32Array, winLength?: number, sampleRate?: number, hopLength?: number, factors?: Float32Array | number[], options?: GuardedOptions): Float32Array;
+/**
+ * Measure loudness (EBU R128 / ITU-R BS.1770).
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz. The default (22050) is non-standard for
+ *   audio; pass the buffer's actual rate, as K-weighting is sample-rate
+ *   dependent and a wrong rate yields wrong loudness.
+ * @returns Loudness measurement result
+ */
+export declare function lufs(request: LufsRequest): LufsResult;
+export declare function lufs(samples: Float32Array, sampleRate?: number, options?: ValidateOptions): LufsResult;
+/**
+ * Compute the momentary loudness (LUFS) over time.
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz. The default (22050) is non-standard and
+ *   K-weighting is sample-rate dependent; pass the buffer's actual rate.
+ * @returns Momentary LUFS values over time
+ */
+export declare function momentaryLufs(request: LufsRequest): Float32Array;
+export declare function momentaryLufs(samples: Float32Array, sampleRate?: number, options?: ValidateOptions): Float32Array;
+/**
+ * Compute the short-term loudness (LUFS) over time.
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz. The default (22050) is non-standard and
+ *   K-weighting is sample-rate dependent; pass the buffer's actual rate.
+ * @returns Short-term LUFS values over time
+ */
+export declare function shortTermLufs(request: LufsRequest): Float32Array;
+export declare function shortTermLufs(samples: Float32Array, sampleRate?: number, options?: ValidateOptions): Float32Array;
+export {};
+//# sourceMappingURL=feature_music.d.ts.map

package/dist/feature_music.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature_music.d.ts","sourceRoot":"","sources":["../src/feature_music.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,cAAc,EACd,SAAS,EACT,UAAU,EACV,YAAY,EACZ,wBAAwB,EACxB,OAAO,EAER,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAapD,KAAK,cAAc,GAAG,eAAe,CAAC;AACtC,KAAK,6BAA6B,GAAG,sBAAsB,GAAG,eAAe,CAAC;AAC9E,KAAK,sBAAsB,GAAG,eAAe,GAAG,eAAe,CAAC;AAChE,KAAK,oBAAoB,GAAG,aAAa,GAAG,eAAe,CAAC;AAE5D,0EAA0E;AAC1E,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,8CAA8C;AAC9C,MAAM,WAAW,UAAW,SAAQ,UAAU;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,yBAA0B,SAAQ,oBAAoB;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAwB,SAAQ,cAAc;IAC7D,aAAa,EAAE,YAAY,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D,aAAa,EAAE,YAAY,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,SAAS,EAAE,YAAY,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAuB,SAAQ,6BAA6B;IAC3E,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,mEAAmE;AACnE,MAAM,WAAW,uBAAwB,SAAQ,sBAAsB;IACrE,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAyBD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,oBAAoB,CAAC;AAC7E,wBAAgB,UAAU,CACxB,OAAO,EAAE,YAAY,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,SAAS,GAAG,YAAY,CAAC,GAC1D,oBAAoB,CAAC;AAyBxB;;;;;;;;;;GAUG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC;AACpD,wBAAgB,GAAG,CACjB,OAAO,EAAE,YAAY,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,SAAS,CAAC;AA4Bb;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC;AAC1D,wBAAgB,SAAS,CACvB,OAAO,EAAE,YAAY,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,SAAS,CAAC;AA4Bb;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC;AAC1D,wBAAgB,SAAS,CACvB,OAAO,EAAE,YAAY,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE,cAAc,GACvB,SAAS,CAAC;AA4Bb;;;;;;;;;;;;GAYG;AACH,wBAAgB,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC;AACpD,wBAAgB,GAAG,CACjB,OAAO,EAAE,YAAY,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,EACtB,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,SAAS,CAAC;AA0Db,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,YAAY,CAAC;AACrE,wBAAgB,UAAU,CACxB,SAAS,EAAE,YAAY,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,EACtB,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,YAAY,CAAC;AAkDhB,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,YAAY,CAAC;AACrE,wBAAgB,UAAU,CACxB,SAAS,EAAE,YAAY,EACvB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,EACtB,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,YAAY,CAAC;AAsDhB;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,EAAE,CAAC;AAC5E,wBAAgB,eAAe,CAC7B,OAAO,EAAE,YAAY,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,6BAA6B,GACtC,OAAO,EAAE,CAAC;AAkCb;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,cAAc,CAmDjF;AAED,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,YAAY,CAAC;AAC3E,wBAAgB,aAAa,CAC3B,OAAO,EAAE,YAAY,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,YAAY,CAAC;AAmDhB;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,YAAY,CAAC;AAC3E,wBAAgB,aAAa,CAC3B,OAAO,EAAE,YAAY,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,YAAY,CAAC;AA0BhB;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,wBAAwB,CAAC;AACjG,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,YAAY,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,wBAAwB,CAAC;AAmC5B;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,0BAA0B,CAAC;AAC/F,wBAAgB,gBAAgB,CAC9B,aAAa,EAAE,YAAY,EAC3B,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,0BAA0B,CAAC;AAmC9B;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,YAAY,CAAC;AAC7E,wBAAgB,cAAc,CAC5B,aAAa,EAAE,YAAY,EAC3B,SAAS,CAAC,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,YAAY,GAAG,MAAM,EAAE,EACjC,OAAO,CAAC,EAAE,cAAc,GACvB,YAAY,CAAC;AA0BhB;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAAC;AACvD,wBAAgB,IAAI,CAClB,OAAO,EAAE,YAAY,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,eAAe,GACxB,UAAU,CAAC;AAed;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CAAC;AAClE,wBAAgB,aAAa,CAC3B,OAAO,EAAE,YAAY,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,eAAe,GACxB,YAAY,CAAC;AAehB;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,YAAY,CAAC;AAClE,wBAAgB,aAAa,CAC3B,OAAO,EAAE,YAAY,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,eAAe,GACxB,YAAY,CAAC"}

package/dist/feature_pitch.d.ts

@@ -0,0 +1,108 @@
+import type { SpectralFrameRequest } from './feature_spectral';
+import type { NoteSegment, PiptrackResult, PitchResult } from './public_types';
+/**
+ * Detect pitch using YIN algorithm.
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param frameLength - Frame length (default: 2048)
+ * @param hopLength - Hop length (default: 512)
+ * @param fmin - Minimum frequency in Hz (default: 65)
+ * @param fmax - Maximum frequency in Hz (default: 2093)
+ * @param threshold - YIN threshold (default: 0.1)
+ * @param fillNa - Retained for compatibility; YIN always returns a finite per-frame estimate.
+ * @returns Pitch detection result
+ */
+export interface PitchYinRequest {
+    samples: Float32Array;
+    sampleRate?: number;
+    frameLength?: number;
+    hopLength?: number;
+    fmin?: number;
+    fmax?: number;
+    threshold?: number;
+    fillNa?: boolean;
+}
+export interface PiptrackRequest {
+    samples: Float32Array;
+    sampleRate?: number;
+    nFft?: number;
+    hopLength?: number;
+    fmin?: number;
+    fmax?: number;
+    threshold?: number;
+}
+/** Per-bin spectral pitch candidates and peak magnitudes (librosa.piptrack). */
+export declare function piptrack(request: PiptrackRequest): PiptrackResult;
+export declare function piptrack(samples: Float32Array, sampleRate?: number, nFft?: number, hopLength?: number, fmin?: number, fmax?: number, threshold?: number): PiptrackResult;
+export declare function pitchYin(request: PitchYinRequest): PitchResult;
+export declare function pitchYin(samples: Float32Array, sampleRate?: number, frameLength?: number, hopLength?: number, fmin?: number, fmax?: number, threshold?: number, fillNa?: boolean): PitchResult;
+/**
+ * Detect pitch using pYIN algorithm (probabilistic YIN with HMM smoothing).
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param sampleRate - Sample rate in Hz (default: 22050)
+ * @param frameLength - Frame length (default: 2048)
+ * @param hopLength - Hop length (default: 512)
+ * @param fmin - Minimum frequency in Hz (default: 65)
+ * @param fmax - Maximum frequency in Hz (default: 2093)
+ * @param threshold - YIN threshold (default: 0.1)
+ * @param fillNa - If true, return 0 for unvoiced f0 frames; otherwise keep NaN (default: false)
+ * @returns Pitch detection result
+ */
+export interface PitchPyinRequest extends PitchYinRequest {
+}
+export declare function pitchPyin(request: PitchPyinRequest): PitchResult;
+export declare function pitchPyin(samples: Float32Array, sampleRate?: number, frameLength?: number, hopLength?: number, fmin?: number, fmax?: number, threshold?: number, fillNa?: boolean): PitchResult;
+/** Parameters for segmenting an F0 track into stable monophonic notes. */
+export interface NoteSegmentsRequest {
+    f0Hz: Float32Array;
+    /**
+     * Per-frame voicing values in `[0, 1]`; anything below `voicedThreshold` is
+     * unvoiced.
+     *
+     * Pass {@link PitchResult.voicedFlag} converted to `0`/`1`. Do **not** pass
+     * {@link pitchPyin}'s `voicedProb`: that value is the frame's voiced
+     * observation mass and rises with F0 for a fixed `frameLength`, so a fixed
+     * threshold silently returns no segments at all for low-register material
+     * (a steady tone below roughly C5 never reaches 0.5).
+     */
+    voicedProb: Float32Array;
+    frameRate: number;
+    /** Cents of pitch change that start a new segment. Default 50. */
+    segmentationThresholdCents?: number;
+    /** Shortest segment kept, in ms. Default 30. */
+    minNoteMs?: number;
+    /** Reference pitch each segment's cents are measured against. Default 440. */
+    referenceHz?: number;
+    /** Voicing threshold applied to `voicedProb`; defaults to `0.5`. */
+    voicedThreshold?: number;
+}
+/**
+ * Segment a caller-supplied monophonic F0 track into stable note regions.
+ *
+ * `f0Hz` and `voicedProb` must have the same non-zero length. Zero-Hz frames
+ * and values below `voicedThreshold` (default `0.5`) are treated as unvoiced.
+ */
+export declare function noteSegments(request: NoteSegmentsRequest): NoteSegment[];
+export interface PitchTuningRequest {
+    frequencies: Float32Array;
+    resolution?: number;
+    binsPerOctave?: number;
+}
+export interface EstimateTuningRequest extends SpectralFrameRequest {
+    resolution?: number;
+    binsPerOctave?: number;
+}
+/**
+ * Estimate the global tuning offset from a set of frequencies
+ * (librosa.pitch_tuning). Returns a deviation in fractions of a bin.
+ */
+export declare function pitchTuning(request: PitchTuningRequest): number;
+export declare function pitchTuning(frequencies: Float32Array, resolution?: number, binsPerOctave?: number): number;
+/**
+ * Estimate the tuning offset of an audio signal (librosa.estimate_tuning).
+ */
+export declare function estimateTuning(request: EstimateTuningRequest): number;
+export declare function estimateTuning(samples: Float32Array, sampleRate?: number, nFft?: number, hopLength?: number, resolution?: number, binsPerOctave?: number): number;
+//# sourceMappingURL=feature_pitch.d.ts.map

package/dist/feature_pitch.d.ts.map

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

package/dist/feature_resample.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Resample audio to a different sample rate.
+ *
+ * @param samples - Audio samples (mono, float32)
+ * @param srcSr - Source sample rate in Hz
+ * @param targetSr - Target sample rate in Hz
+ * @returns Resampled audio
+ */
+export interface ResampleRequest {
+    samples: Float32Array;
+    srcSr: number;
+    targetSr: number;
+}
+export declare function resample(request: ResampleRequest): Float32Array;
+export declare function resample(samples: Float32Array, srcSr: number, targetSr: number): Float32Array;
+//# sourceMappingURL=feature_resample.d.ts.map