Audio Processing Types

Since 1.9.0

Types for audio processing and music applications.

Overview

Audio Processing Types provides type-level audio processing utilities. It supports audio samples, waveforms, MIDI, effects, synthesizers, and audio analysis.

This module enables building type-safe audio applications with proper constraints for audio buffers, effects, and music notation.

Basic Usage

import type { AudioSample, WaveformType, MIDINote, AudioEffect, Frequency } from 'uni-types'

// Define audio buffer
type AudioBuffer = AudioBufferData<Float32Array>

// Define MIDI note
type Note = MIDINote

// Define effect chain
type EffectChain = AudioEffect[]

Key Types

AudioSample

Audio sample type (single sample value).

type AudioSample = number

AudioBufferData

Audio buffer with metadata.

interface AudioBufferData<T = Float32Array | number[]> {
  data: T
  sampleRate: number
  numberOfChannels: number
  length: number
  duration: number
}

SampleRate

Sample rate enumeration.

type SampleRate =
  | 8000 | 11025 | 16000 | 22050 | 32000
  | 44100 | 48000 | 88200 | 96000 | 192000

WaveformType

Waveform type enumeration.

type WaveformType =
  | 'sine'
  | 'square'
  | 'triangle'
  | 'sawtooth'
  | 'pulse'
  | 'noise-white'
  | 'noise-pink'
  | 'noise-brown'

ADSREnvelope

ADSR envelope for synthesis.

interface ADSREnvelope {
  attack: number // Attack time in seconds
  decay: number // Decay time in seconds
  sustain: number // Sustain level (0-1)
  release: number // Release time in seconds
}

NoteName

Musical note names.

type NoteName =
  | 'C' | 'C#' | 'Db' | 'D' | 'D#' | 'Eb' | 'E'
  | 'F' | 'F#' | 'Gb' | 'G' | 'G#' | 'Ab' | 'A'
  | 'A#' | 'Bb' | 'B'

Octave

Octave range (standard piano).

type Octave = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8

Frequency

Frequency in Hz.

type Frequency = number

AudioEffect

All audio effect types.

type AudioEffect =
  | ReverbEffect
  | DelayEffect
  | FilterEffect
  | CompressorEffect
  | EqualizerEffect
  | DistortionEffect
  | ChorusEffect
  | FlangerEffect
  | PhaserEffect
  | TremoloEffect
  | LimiterEffect

MIDIEvent

MIDI event types.

type MIDIEvent =
  | MIDINoteOnEvent
  | MIDINoteOffEvent
  | MIDIControlChangeEvent
  | MIDIPitchBendEvent
  | MIDIAftertouchEvent
  | MIDIProgramChangeEvent
  | MIDISystemExclusiveEvent

MIDISequence

MIDI sequence with tracks.

interface MIDISequence {
  tracks: MIDITrack[]
  bpm: number
  timeSignature: [number, number]
  ppqn: number // Pulses per quarter note
  duration: number
}

SynthesizerPatch

Synthesizer patch configuration.

interface SynthesizerPatch {
  name: string
  voices: SynthVoice[]
  polyphonic: boolean
  maxVoices?: number
  portamento?: number
  effects?: AudioEffect[]
}

FFTResult

FFT analysis result.

interface FFTResult {
  magnitudes: number[]
  frequencies: number[]
  binSize: number
  size: number
  sampleRate: number
}

AudioFormat

Audio format enumeration.

type AudioFormat =
  | 'wav' | 'mp3' | 'ogg' | 'flac'
  | 'aac' | 'm4a' | 'opus' | 'aiff' | 'webm'

Related

• Animation - Animation types
• Game Development - Game audio types
• Graphics - Graphics types