software-mansion · mdydek · Nov 13, 2025 · Nov 13, 2025 · Nov 14, 2025 · Nov 16, 2025
diff --git a/apps/common-app/src/demos/PedalBoard/EchoPedal.tsx b/apps/common-app/src/demos/PedalBoard/EchoPedal.tsx
@@ -1,8 +1,7 @@
 import React, { useRef, useState, useEffect } from 'react';
 import { View, Text, StyleSheet } from 'react-native';
 import { GestureDetector, Gesture } from 'react-native-gesture-handler';
-import { VerticalSlider } from '../../components';
-import { ConvolverNode, AudioNode, AudioContext, GainNode } from 'react-native-audio-api';
+import { ConvolverNode, AudioNode, AudioContext } from 'react-native-audio-api';
 import { makeEchoCurve } from './curves';
 
 interface EchoPedalProps {
@@ -17,7 +16,6 @@ export default function EchoPedal({
   outputNode,
 }: EchoPedalProps) {
   const [isActive, setIsActive] = useState(false);
-  const [time, setTime] = useState(0.5); // Echo delay time (0-1 mapped to actual delay)
 
   const convolverNodeRef = useRef<ConvolverNode | null>(null);
 
@@ -32,23 +30,15 @@ export default function EchoPedal({
     }
   }, [isActive, inputNode, outputNode]);
 
-  useEffect(() => {
-    if (isActive && inputNode && outputNode) {
-      applyEffect(context, inputNode, outputNode);
-    }
-  }, [time]);
-
   const applyEffect = (context: AudioContext, inputNode: AudioNode, outputNode: AudioNode) => {
     if (convolverNodeRef.current) {
       inputNode.disconnect(convolverNodeRef.current);
       convolverNodeRef.current.disconnect();
     }
-    // Map slider value (0-1) to delay time (0.1s - 2.0s)
-    const delayTime = 0.1 + time * 1.9;
 
     // Create new convolver with echo curve
-    const convolver = context.createConvolver({ disableNormalization: true});
-    convolver.buffer = makeEchoCurve(delayTime, context);
+    const convolver = new ConvolverNode(context, { disableNormalization: true})
+    convolver.buffer = makeEchoCurve(0.7, context);
     convolverNodeRef.current = convolver;
 
     // Reconnect audio graph

diff --git a/apps/common-app/src/examples/AudioFile/AudioPlayer.ts b/apps/common-app/src/examples/AudioFile/AudioPlayer.ts
@@ -42,9 +42,7 @@ class AudioPlayer {
       await this.audioContext.resume();
     }
 
-    this.sourceNode = this.audioContext.createBufferSource({
-      pitchCorrection: true,
-    });
+    this.sourceNode = this.audioContext.createBufferSource(true);
     this.sourceNode.buffer = this.audioBuffer;
     this.sourceNode.playbackRate.value = this.playbackRate;
 

diff --git a/apps/common-app/src/examples/AudioVisualizer/AudioVisualizer.tsx b/apps/common-app/src/examples/AudioVisualizer/AudioVisualizer.tsx
@@ -105,10 +105,7 @@ const AudioVisualizer: React.FC = () => {
     }
 
     if (!analyserRef.current) {
-      analyserRef.current = audioContextRef.current.createAnalyser();
-      analyserRef.current.fftSize = FFT_SIZE;
-      analyserRef.current.smoothingTimeConstant = 0.2;
-
+      analyserRef.current = new AnalyserNode(audioContextRef.current, { fftSize: FFT_SIZE, smoothingTimeConstant: 0.2 });
       analyserRef.current.connect(audioContextRef.current.destination);
     }
 

diff --git a/apps/common-app/src/examples/PlaybackSpeed/PlaybackSpeed.tsx b/apps/common-app/src/examples/PlaybackSpeed/PlaybackSpeed.tsx
@@ -58,11 +58,7 @@ const PlaybackSpeed: FC = () => {
           )
         );
 
-      const source = audioContext.createBufferSource({
-        pitchCorrection: audioSettings.PSOLA
-          ? false
-          : audioSettings.pitchCorrection,
-      });
+      const source = audioContext.createBufferSource(audioSettings.PSOLA ? false : audioSettings.pitchCorrection);
 
       source.buffer = buffer;
       source.playbackRate.value = audioSettings.PSOLA ? 1 : playbackSpeed;

diff --git a/packages/audiodocs/docs/analysis/analyser-node.mdx b/packages/audiodocs/docs/analysis/analyser-node.mdx
@@ -3,7 +3,7 @@ sidebar_position: 1
 ---
 
 import AudioNodePropsTable from "@site/src/components/AudioNodePropsTable"
-import { ReadOnly } from '@site/src/components/Badges';
+import { Optional, ReadOnly } from '@site/src/components/Badges';
 
 # AnalyserNode
 
@@ -23,7 +23,23 @@ In contrast, a frequency-domain graph reveals how the signal's energy or power i
 
 ## Constructor
 
-[`BaseAudioContext.createAnalyser()`](/docs/core/base-audio-context#createanalyser)
+```tsx
+constructor(context: BaseAudioContext, options?: AnalyserOptions)
+```
+
+### `AnalyserOptions`
+
+Inherits all properties from [`AudioNodeOptions`](/docs/core/audio-node#audionodeoptions)
+
+| Parameter | Type | Default | |
+| :---: | :---: | :----: | :---- |
+| `fftSize` <Optional /> | `number` | 2048 | Number representing size of fast fourier transform |
+| `minDecibels` <Optional /> | `number` | -100 | Initial minimum power in dB for FFT analysis |
+| `maxDecibels` <Optional /> | `number` | -30 | Initial maximum power in dB for FFT analysis |
+| `smoothingTimeConstant` <Optional /> | `number` | 0.8 | Initial smoothing constant for the FFT analysis |
+
+Or by using `BaseAudioContext` factory method:
+[`BaseAudioContext.createAnalyser()`](/docs/core/base-audio-context#createanalyser) that creates node with default values.
 
 ## Properties
 
@@ -95,24 +111,20 @@ Each value in the array is within the range 0 to 255, where value of 127 indicat
 ## Remarks
 
 #### `fftSize`
-- Default value is 2048.
 - Must be a power of 2 between 32 and 32768.
 - Throws `IndexSizeError` if set value is not power of 2, or is outside the allowed range.
 
 #### `minDecibels`
-- Default value is -100 dB.
 - 0 dB([decibel](https://en.wikipedia.org/wiki/Decibel)) is the loudest possible sound, -10 dB is a 10th of that.
 - When getting data from [`getByteFrequencyData()`](/docs/analysis/analyser-node#getbytefrequencydata), any frequency with amplitude lower then `minDecibels` will be returned as 0.
 - Throws `IndexSizeError` if set value is greater than or equal to `maxDecibels`.
 
 #### `maxDecibels`
-- Default value is -30 dB.
 - 0 dB([decibel](https://en.wikipedia.org/wiki/Decibel)) is the loudest possible sound, -10 dB is a 10th of that.
 - When getting data from [`getByteFrequencyData()`](/docs/analysis/analyser-node#getbytefrequencydata), any frequency with amplitude higher then `maxDecibels` will be returned as 255.
 - Throws `IndexSizeError` if set value is less then or equal to `minDecibels`.
 
 #### `smoothingTimeConstant`
-- Default value is 0.8.
 - Nominal range is 0 to 1.
 - 0 means no averaging, 1 means "overlap the previous and current buffer quite a lot while computing the value".
 - Throws `IndexSizeError` if set value is outside the allowed range.

diff --git a/packages/audiodocs/docs/core/audio-node.mdx b/packages/audiodocs/docs/core/audio-node.mdx
@@ -111,6 +111,18 @@ If no arguments provided node disconnects from all outgoing connections.
 
 #### Returns `undefined`.
 
+### `AudioNodeOptions`
+
+It is used to constructing majority of all `AudioNodes`.
+
+| Parameter | Type | Default | Description |
+| :---: | :---: | :----: | :---- |
+| `channelCount` <Optional /> | `number` | 2 | Indicates number of channels used in mixing of node. |
+| `channelCountMode` <Optional /> | [`ChannelCountMode`](/docs/types/channel-count-mode) | `max` | Determines how the number of input channels affects the number of output channels in an audio node. |
+| `channelInterpretation` <Optional /> | [`ChannelInterpretation`](/docs/types/channel-interpretation) | `speakers` | Specifies how input channels are mapped out to output channels when the number of them are different. |
+
+If any of these values are not provided, default values are used.
+
 ## Remarks
 
 #### `numberOfInputs`

diff --git a/packages/audiodocs/docs/core/base-audio-context.mdx b/packages/audiodocs/docs/core/base-audio-context.mdx
@@ -84,7 +84,7 @@ Creates [`AudioBufferSourceNode`](/docs/sources/audio-buffer-source-node).
 
 | Parameter | Type | Description |
 | :---: | :---: | :---- |
-| `options` <Optional /> | [`AudioBufferBaseSourceNodeOptions`](/docs/sources/audio-buffer-source-node#constructor) | Dictionary object that specifies if pitch correction has to be available. |
+| `pitchCorrection` <Optional /> | `boolean` | Boolean that specifies if pitch correction has to be available. |
 
 #### Returns `AudioBufferSourceNode`.
 
@@ -94,7 +94,7 @@ Creates [`AudioBufferQueueSourceNode`](/docs/sources/audio-buffer-queue-source-n
 
 | Parameter | Type | Description |
 | :---: | :---: | :---- |
-| `options` <Optional /> | [`AudioBufferBaseSourceNodeOptions`](/docs/sources/audio-buffer-queue-source-node#constructor) | Dictionary object that specifies if pitch correction has to be available. |
+| `pitchCorrection` <Optional /> | `boolean` | Boolean that specifies if pitch correction has to be available. |
 
 #### Returns `AudioBufferQueueSourceNode`.
 
@@ -108,16 +108,6 @@ Creates [`ConstantSourceNode`](/docs/sources/constant-source-node).
 
 Creates [`ConvolverNode`](/docs/effects/convolver-node).
 
-| Parameter | Type | Description |
-| :---: | :---: | :---- |
-| `options` <Optional /> | [`ConvolverNodeOptions`](/docs/effects/convolver-node#constructor) | Dictionary object that specifies associated buffer and normalization. |
-
-#### Errors
-
-| Error type | Description |
-| :---: | :---- |
-| `NotSupportedError` | `numOfChannels` of buffer is not 1, 2 or 4. |
-
 #### Returns `ConvolverNode`.
 
 ### `createDelay`
@@ -140,17 +130,6 @@ Creates [`GainNode`](/docs/effects/gain-node).
 
 Creates [`IIRFilterNode`](/docs/effects/iir-filter-node).
 
-| Parameter | Type | Description |
-| :---: | :---: | :---- |
-| `options` | [`IIRFilterNodeOptions`](/docs/effects/iir-filter-node#constructor) | Dictionary object that specifies the feedforward (numerator) and feedback (denominator) coefficients for the transfer function of the IIR filter. |
-
-#### Errors
-
-| Error type | Description |
-| :---: | :---- |
-| `NotSupportedError` | One or both of the input arrays exceeds 20 members. |
-| `InvalidStateError` | All of the feedforward coefficients are 0, or the first feedback coefficient is 0. |
-
 #### Returns `IIRFilterNode`.
 
 ### `createOscillator`

diff --git a/packages/audiodocs/docs/effects/biquad-filter-node.mdx b/packages/audiodocs/docs/effects/biquad-filter-node.mdx
@@ -3,7 +3,7 @@ sidebar_position: 1
 ---
 
 import AudioNodePropsTable from "@site/src/components/AudioNodePropsTable"
-import { ReadOnly } from '@site/src/components/Badges';
+import { Optional, ReadOnly } from '@site/src/components/Badges';
 import InteractiveExample from '@site/src/components/InteractiveExample';
 import AudioApiExample from '@site/src/components/AudioApiExample'
 import VinylPlayer from '@site/src/components/RecordPlayerExample/VinylAnimation';
@@ -23,7 +23,24 @@ Multiple `BiquadFilterNode` instances can be combined to create more complex fil
 
 ## Constructor
 
-[`BaseAudioContext.createBiquadFilter()`](/docs/core/base-audio-context#createbiquadfilter)
+```tsx
+constructor(context: BaseAudioContext, options?: BiquadFilterOptions)
+```
+
+### `BiquadFilterOptions`
+
+Inherits all properties from [`AudioNodeOptions`](/docs/core/audio-node#audionodeoptions)
+
+| Parameter | Type | Default | |
+| :---: | :---: | :----: | :---- |
+| `Q` <Optional /> | `number` | 1 | Initial value for [`Q`](/docs/effects/biquad-filter-node#properties) |
+| `detune` <Optional /> | `number` | 0 | Initial value for [`detune`](/docs/effects/biquad-filter-node#properties) |
+| `frequency` <Optional /> | `number` | 350 | Initial value for [`frequency`](/docs/effects/biquad-filter-node#properties) |
+| `gain` <Optional /> | `number` | 0 | Initial value for [`gain`](/docs/effects/biquad-filter-node#properties) |
+| `type` <Optional /> | `BiquadFilterType` | `lowpass` | Initial value for [`type`](/docs/effects/biquad-filter-node#properties) |
+
+Or by using `BaseAudioContext` factory method:
+[`BaseAudioContext.createBiquadFilter()`](/docs/core/base-audio-context#createbiquadfilter) that creates node with default values.
 
 ## Properties
 
@@ -72,24 +89,15 @@ It inherits all methods from [`AudioNode`](/docs/core/audio-node#methods).
 ## Remarks
 
 #### `frequency`
-- Float. Default: 350.
 - Range: [10, $\frac{sampleRate}{2}$].
 
-#### `detune`
-- Float. Default: 0.
-
 #### `Q`
-- Float. Default: 1.
 - Range:
   - For `lowpass` and `highpass` is [-Q, Q], where Q is the largest value for which $10^{Q/20}$ does not overflow the single-precision floating-point representation.
 Numerically: Q ≈ 770.63678.
   - For `bandpass`, `notch`, `allpass`, and `peaking`: Q is related to the filter’s bandwidth and should be positive.
   - Not used for `lowshelf` and `highshelf`.
 
 #### `gain`
-- Float. Default: 0.
 - Range: [-40, 40].
 - Positive values correspond to amplification; negative to attenuation.
-
-#### `type`
-- [`BiquadFilterType`](#biquadfiltertype-enumeration-description). Default: `"lowpass"`.
diff --git a/packages/audiodocs/docs/effects/convolver-node.mdx b/packages/audiodocs/docs/effects/convolver-node.mdx
@@ -3,6 +3,7 @@ sidebar_position: 2
 ---
 
 import AudioNodePropsTable from "@site/src/components/AudioNodePropsTable"
+import { Optional } from '@site/src/components/Badges';
 
 # ConvolverNode
 
@@ -19,18 +20,30 @@ Convolver is a node with tail-time, which means, that it continues to output non
 
 ## Constructor
 
-[`BaseAudioContext.createConvolver(options: ConvolverNodeOptions)`](/docs/core/base-audio-context#createconvolver)
-
-```jsx
-interface ConvolverNodeOptions {
-  buffer?: AudioBuffer | null; // impulse response
-  disableNormalization?: boolean; // if normalization of output should be applied, true by default
-}
+```tsx
+constructor(context: BaseAudioContext, options?: ConvolverOptions)
 ```
 
+### `ConvolverOptions`
+
+Inherits all properties from [`AudioNodeOptions`](/docs/core/audio-node#audionodeoptions)
+
+| Parameter | Type | Default | |
+| :---: | :---: | :----: | :---- |
+| `buffer` <Optional /> | `number` |  | Initial value for [`buffer`](/docs/effects/convolver-node#properties). |
+| `normalize` <Optional /> | `boolean` | true | Initial value for [`normalize`](/docs/effects/convolver-node#properties). |
+
+Or by using `BaseAudioContext` factory method:
+[`BaseAudioContext.createConvolver()`](/docs/core/base-audio-context#createconvolver)
+
 ## Properties
 
-It inherits all properties from [`AudioNode`](/docs/core/audio-node#properties) and has no individual ones.
+It inherits all properties from [`AudioNode`](/docs/core/audio-node#properties).
+
+| Name | Type | Description |
+| :----: | :----: | :-------- |
+| `buffer` | [`AudioBuffer`](/docs/sources/audio-buffer) | Associated AudioBuffer. |
+| `normalize` | `boolean` | Whether the impulse response from the buffer will be scaled by an equal-power normalization when the buffer attribute is set. |
 
 :::caution
 Linear convolution is a heavy computational process, so if your audio has some weird artefacts that should not be there, try to decrease the duration of impulse response buffer.

diff --git a/packages/audiodocs/docs/effects/gain-node.mdx b/packages/audiodocs/docs/effects/gain-node.mdx
@@ -3,7 +3,7 @@ sidebar_position: 3
 ---
 
 import AudioNodePropsTable from "@site/src/components/AudioNodePropsTable"
-import { ReadOnly } from '@site/src/components/Badges';
+import { Optional, ReadOnly } from '@site/src/components/Badges';
 import { useGainAdsrPlayground } from '@site/src/components/InteractivePlayground/GainAdsrExample/useGainAdsrPlayground';
 import InteractivePlayground from '@site/src/components/InteractivePlayground';
 
@@ -43,7 +43,20 @@ You can read more about envelopes and ADSR on [Wikipedia](<https://en.wikipedia.
 
 ## Constructor
 
-[`BaseAudioContext.createGain()`](/docs/core/base-audio-context#creategain)
+```tsx
+constructor(context: BaseAudioContext, options?: GainOptions)
+```
+
+### `GainOptions`
+
+Inherits all properties from [`AudioNodeOptions`](/docs/core/audio-node#audionodeoptions)
+
+| Parameter | Type | Default | |
+| :---: | :---: | :----: | :---- |
+| `gain` <Optional /> | `number` | 1.0 | Initial value for [`gain`](/docs/effects/gain-node#properties) |
+
+Or by using `BaseAudioContext` factory method:
+[`BaseAudioContext.createGain()`](/docs/core/base-audio-context#creategain) that creates node with default values.
 
 ## Properties
 
@@ -61,5 +74,4 @@ It inherits all methods from [`AudioNode`](/docs/core/audio-node#methods).
 ## Remarks
 
 #### `gain`
-- Default value is 1.0.
 - Nominal range is -∞ to ∞.
diff --git a/packages/audiodocs/docs/effects/iir-filter-node.mdx b/packages/audiodocs/docs/effects/iir-filter-node.mdx
@@ -24,6 +24,13 @@ interface IIRFilterNodeOptions {
 }
 ```
 
+#### Errors
+
+| Error type | Description |
+| :---: | :---- |
+| `NotSupportedError` | One or both of the input arrays exceeds 20 members. |
+| `InvalidStateError` | All of the feedforward coefficients are 0, or the first feedback coefficient is 0. |
+
 ## Properties
 It inherits all properties from [`AudioNode`](/docs/core/audio-node#properties).