feat: audio node options in ctor

[mdydek]

Closes RNAA-297, RNAA-293

⚠️ Breaking changes ⚠️

• createIIRFilter method of BaseAudioContext now takes two parameters feedforward: number[], feedback: number[] instead of one object that encapsulated them
• createConvolver method of BaseAudioContext now takes no parameters
• createBuffer method of BaseAudioContext now has first parameter named numberOfChannels
• createBufferQueueSource and createBufferSource now has optional one boolean parameter pitchCorrection instread of optional one object

Introduced changes

• now nodes can be constructed also by new keyword with some possible option to manipulate its values

LIST:

• AudioBuffer
• AudioNode
• AnalyserNode
• AudioBufferBaseSourceNode
• AudioBufferQueueSourceNode
• AudioBufferSourceNode
• BiquadFilterNode
• ConstantSourceNode
• ConvolverNode
• DelayNode
• GainNode
• IIRFilterNode
• OscillatorNode
• PeriodicWave
• RecorderAdapterNode
• StereoPannerNode
• StreamerNode
• WorkletNode
• WorkletSourceNode
• WorkletProcessingNode

Checklist

• Linked relevant issue
• Updated relevant documentation
• Added/Conducted relevant tests
• Performed self-review of the code
• Updated Web Audio API coverage
• Added support for web

[Copilot]

Pull Request Overview

This PR adds support for passing audio node options (channel configuration) in the GainNode constructor, aligning with the Web Audio API specification. The implementation spans TypeScript and C++ layers, introducing new type definitions and updating constructors to accept optional configuration parameters.

• Introduces TAudioNodeOptions and TGainOptions types for channel configuration
• Updates GainNode constructor to accept optional configuration parameters
• Adds C++ parsing logic for audio node options from JavaScript

Reviewed Changes

Copilot reviewed 14 out of 14 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
packages/react-native-audio-api/src/types.ts	Adds new type definitions TAudioNodeOptions and TGainOptions for audio node configuration
packages/react-native-audio-api/src/interfaces.ts	Updates createGain method signature in IBaseAudioContext to accept TGainOptions parameter
packages/react-native-audio-api/src/defaults.ts	Defines default values for audio node and gain options
packages/react-native-audio-api/src/core/GainNode.ts	Refactors constructor to accept and merge options with defaults before creating the native node
packages/react-native-audio-api/src/core/BaseAudioContext.ts	Simplifies createGain method to delegate parameter handling to GainNode constructor
packages/react-native-audio-api/common/cpp/audioapi/core/effects/GainNode.h	Updates constructor signature to accept GainOptions parameter
packages/react-native-audio-api/common/cpp/audioapi/core/effects/GainNode.cpp	Updates constructor implementation to use options for initializing gain parameter and audio node properties
packages/react-native-audio-api/common/cpp/audioapi/core/BaseAudioContext.h	Updates createGain method signature to accept GainOptions parameter
packages/react-native-audio-api/common/cpp/audioapi/core/BaseAudioContext.cpp	Updates createGain implementation to pass options to GainNode constructor
packages/react-native-audio-api/common/cpp/audioapi/core/AudioNode.h	Updates constructor to accept optional AudioNodeOptions parameter
packages/react-native-audio-api/common/cpp/audioapi/core/AudioNode.cpp	Implements conditional initialization of channel properties from options
packages/react-native-audio-api/common/cpp/audioapi/HostObjects/utils/NodeOptionsParser.h	Adds parsing functions to convert JavaScript option objects to C++ structs
packages/react-native-audio-api/common/cpp/audioapi/HostObjects/utils/NodeOptions.h	Defines C++ structs for AudioNodeOptions and GainOptions
packages/react-native-audio-api/common/cpp/audioapi/HostObjects/BaseAudioContextHostObject.cpp	Updates JSI binding to parse options from JavaScript before calling createGain

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[maciejmakowski2003]

looks promising, @michalsek wdyt?

[poneciak57]

you can make all types extend some empty base like

struct BaseOption {}

it does not cost anything compilers optimize this and might be helpfull in the future if all options types can be virtualized

[mdydek]

I don't like writing features "for the future". Adding some complexity because "maybe someday something will change and it will be helpful" for me should not be done.

[poneciak57]

here type gets sliced as explained before maybe const & ?

[poneciak57]

Great job overall but i see some possible improvements