Specify render quantum size range

[mjwilson-google]

Fixes #2664

Specify the valid range, and include references in the relevant places. Also require that sample rate is set before the render quantum size in OfflineAudioContext. Don't modify AudioContext constructor yet, since we have a separate issue tracking that (#2663).

[mjwilson-google]

Note that WPTs have already landed:

• https://github.com/web-platform-tests/wpt/blob/master/webaudio/the-audio-api/the-audiocontext-interface/audiocontext-rendersizehint.html
• https://github.com/web-platform-tests/wpt/blob/master/webaudio/the-audio-api/the-offlineaudiocontext-interface/offlineaudiocontext-rendersizehint.html

[padenot]

We noticed during the 2026-02-17 call that there's a name discrepancy: renderSizeHint in the Option object, but renderQuantumSize on the BaseAudioContext and Worklet scope, but that might be too late to fix.

This PT looks good in any case

[mjwilson-google]

Thank you!

name discrepancy

I think this is because renderQuantumSize is the actual size as an integer, whereas renderSizeHint can take other values like 'default' and 'hardware'. If we change the API to only accept integer size hints then I think we should also change the Option object name to renderQuantumSize.

As far as I know, Chromium is the only implementation experimenting with this API right now and we're still in origin trial. So I don't think it's too late to make fixes yet.