WASM support (#26)

* feat(wasm): add wasm-js feature flag

pass flag to the getrandom crate
add feature documentation

* chore: fix Clippy lints about crate docs indentation

---------

Co-authored-by: Alejandro González <me@alegon.dev>

Author: pdesjardins90

packages/vorbis_rs/Cargo.toml

@@ -33,6 +33,7 @@ getrandom = { version = "0.3.0", features = ["std"], optional = true }
 [features]
 default = ["stream-serial-rng"]
 stream-serial-rng = ["dep:getrandom"]
+wasm-js = ["getrandom?/wasm_js"]
 
 [package.metadata.docs.rs]
 rustdoc-args = ["--cfg", "docsrs"]

packages/vorbis_rs/src/lib.rs

@@ -20,9 +20,14 @@
 //! # Features
 //!
 //! - `stream-serial-rng` (enabled by default): adds the [`VorbisEncoderBuilder::new`] convenience
-//!                       method, which automatically configures such a builder with suitable random
-//!                       Ogg stream serial numbers. This feature pulls dependencies on random number
-//!                       generation crates.
+//!   method, which automatically configures such a builder with suitable random
+//!   Ogg stream serial numbers. This feature pulls dependencies on random number
+//!   generation crates.
+//! - `wasm-js`: enhances the ergonomics of using `vorbis_rs` when targeting JavaScript environments
+//!   with WebAssembly. Currently, this enables the `wasm_js` feature flag on
+//!   [`getrandom`](https://crates.io/crates/getrandom), opting into its [WebAssembly
+//!   support](https://docs.rs/getrandom/latest/getrandom/#webassembly-support) for JavaScript
+//!   environments, but the concrete effects of this flag may change at any point in the future.
 //!
 //! # Examples
 //!