Add some docs

Author: richard-uk1

crates/file/src/blob.rs

@@ -10,7 +10,7 @@ use sealed::Sealed;
 /// This trait is used to overload the `Blob::new_with_options` function, allowing a variety of
 /// types to be used to create a `Blob`. Ignore this, and use &[u8], &str, etc to create a `Blob`.
 ///
-/// The trait is sealed: it must only be implemented by this
+/// The trait is sealed: it must only be implemented by types in this
 /// crate, as this crate relies on invariants regarding the `JsValue` returned from `into_jsvalue`.
 pub trait BlobContents: Sealed {
     fn into_jsvalue(self) -> JsValue;
@@ -289,6 +289,7 @@ impl From<File> for Blob {
 /// [Number.MAX_SAFE_INTEGER](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER)
 fn safe_u64_to_f64(number: u64) -> f64 {
     // Max integer stably representable by f64
+    // todo use js_sys::Number::MAX_SAFE_INTEGER once stable
     const MAX_SAFE_INTEGER: u64 = 9007199254740991; // (2^53 - 1)
     assert!(
         number <= MAX_SAFE_INTEGER,
@@ -302,6 +303,7 @@ fn safe_u64_to_f64(number: u64) -> f64 {
 
 fn safe_u128_to_f64(number: u128) -> f64 {
     // Max integer stably representable by f64
+    // todo use js_sys::Number::MAX_SAFE_INTEGER once stable
     const MAX_SAFE_INTEGER: u128 = 9007199254740991; // (2^53 - 1)
     assert!(
         number <= MAX_SAFE_INTEGER,
@@ -316,6 +318,7 @@ fn safe_u128_to_f64(number: u128) -> f64 {
 /// Like safe_u64_to_f64, but additionally checks that the number is an integer.
 fn safe_f64_to_u64(number: f64) -> u64 {
     // Max integer stably representable by f64
+    // todo use js_sys::Number::MAX_SAFE_INTEGER once stable
     const MAX_SAFE_INTEGER: f64 = 9007199254740991.0; // (2^53 - 1)
     assert!(
         number <= MAX_SAFE_INTEGER,