@grain/stdlib 0.7.0 → 0.7.2

package/buffer.md

@@ -51,15 +51,15 @@ That byte sequence is automatically reallocated when more than `initialSize` byt
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`initialSize`|`Number`|The initial size of the buffer|
+| param         | type     | description                    |
+| ------------- | -------- | ------------------------------ |
+| `initialSize` | `Number` | The initial size of the buffer |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Buffer`|The new buffer|
+| type     | description    |
+| -------- | -------------- |
+| `Buffer` | The new buffer |
 
 Throws:
 
@@ -92,15 +92,15 @@ Gets the number of bytes currently contained in a buffer.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`buffer`|`Buffer`|The buffer to access|
+| param    | type     | description          |
+| -------- | -------- | -------------------- |
+| `buffer` | `Buffer` | The buffer to access |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Number`|The length of the buffer in bytes|
+| type     | description                       |
+| -------- | --------------------------------- |
+| `Number` | The length of the buffer in bytes |
 
 Examples:
 
@@ -131,9 +131,9 @@ This operation does not resize the underlying byte sequence.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`buffer`|`Buffer`|The buffer to clear|
+| param    | type     | description         |
+| -------- | -------- | ------------------- |
+| `buffer` | `Buffer` | The buffer to clear |
 
 Examples:
 
@@ -162,9 +162,9 @@ This operation resizes the underlying byte sequence to the initial size of the b
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`buffer`|`Buffer`|The buffer to reset|
+| param    | type     | description         |
+| -------- | -------- | ------------------- |
+| `buffer` | `Buffer` | The buffer to reset |
 
 Examples:
 
@@ -193,10 +193,10 @@ This operation does not resize the underlying byte sequence.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`length`|`Number`|The number of bytes to truncate the buffer to|
-|`buffer`|`Buffer`|The buffer to truncate|
+| param    | type     | description                                   |
+| -------- | -------- | --------------------------------------------- |
+| `length` | `Number` | The number of bytes to truncate the buffer to |
+| `buffer` | `Buffer` | The buffer to truncate                        |
 
 Throws:
 
@@ -230,15 +230,15 @@ Returns a copy of the current contents of the buffer as a byte sequence.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`buffer`|`Buffer`|The buffer to copy into a byte sequence|
+| param    | type     | description                             |
+| -------- | -------- | --------------------------------------- |
+| `buffer` | `Buffer` | The buffer to copy into a byte sequence |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Bytes`|A byte sequence made from copied buffer data|
+| type    | description                                  |
+| ------- | -------------------------------------------- |
+| `Bytes` | A byte sequence made from copied buffer data |
 
 Examples:
 
@@ -263,17 +263,17 @@ Returns a slice of the current contents of the buffer as a byte sequence.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`start`|`Number`|The start index|
-|`length`|`Number`|The number of bytes to include after the starting index|
-|`buffer`|`Buffer`|The buffer to copy from|
+| param    | type     | description                                             |
+| -------- | -------- | ------------------------------------------------------- |
+| `start`  | `Number` | The start index                                         |
+| `length` | `Number` | The number of bytes to include after the starting index |
+| `buffer` | `Buffer` | The buffer to copy from                                 |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Bytes`|A byte sequence with bytes copied from the buffer|
+| type    | description                                       |
+| ------- | ------------------------------------------------- |
+| `Bytes` | A byte sequence with bytes copied from the buffer |
 
 Throws:
 
@@ -306,15 +306,15 @@ Returns a copy of the current contents of the buffer as a string.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`buffer`|`Buffer`|The buffer to stringify|
+| param    | type     | description             |
+| -------- | -------- | ----------------------- |
+| `buffer` | `Buffer` | The buffer to stringify |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`String`|A string made with data copied from the buffer|
+| type     | description                                    |
+| -------- | ---------------------------------------------- |
+| `String` | A string made with data copied from the buffer |
 
 Examples:
 
@@ -339,17 +339,17 @@ Returns a copy of a subset of the current contents of the buffer as a string.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`start`|`Number`|The start index|
-|`length`|`Number`|The number of bytes to include after the starting index|
-|`buffer`|`Buffer`|The buffer to copy from|
+| param    | type     | description                                             |
+| -------- | -------- | ------------------------------------------------------- |
+| `start`  | `Number` | The start index                                         |
+| `length` | `Number` | The number of bytes to include after the starting index |
+| `buffer` | `Buffer` | The buffer to copy from                                 |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`String`|A string made with a subset of data copied from the buffer|
+| type     | description                                                |
+| -------- | ---------------------------------------------------------- |
+| `String` | A string made with a subset of data copied from the buffer |
 
 Examples:
 
@@ -374,10 +374,10 @@ Appends a byte sequence to a buffer.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`bytes`|`Bytes`|The byte sequence to append|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description                 |
+| -------- | -------- | --------------------------- |
+| `bytes`  | `Bytes`  | The byte sequence to append |
+| `buffer` | `Buffer` | The buffer to mutate        |
 
 Examples:
 
@@ -402,10 +402,10 @@ Appends the bytes of a string to a buffer.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`string`|`String`|The string to append|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description          |
+| -------- | -------- | -------------------- |
+| `string` | `String` | The string to append |
+| `buffer` | `Buffer` | The buffer to mutate |
 
 Examples:
 
@@ -415,6 +415,51 @@ Buffer.addString("Hello", buf)
 assert Buffer.toString(buf) == "Hello"
 ```
 
+### Buffer.**getChar**
+
+<details disabled>
+<summary tabindex="-1">Added in <code>0.7.1</code></summary>
+No other changes yet.
+</details>
+
+```grain
+getChar: (index: Number, buffer: Buffer) => Char
+```
+
+Gets the UTF-8 encoded character at the given byte index.
+
+Parameters:
+
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `index`  | `Number` | The byte index to access |
+| `buffer` | `Buffer` | The buffer to access     |
+
+Returns:
+
+| type   | description                             |
+| ------ | --------------------------------------- |
+| `Char` | A character starting at the given index |
+
+Throws:
+
+`IndexOutOfBounds`
+
+* When `index` is negative
+* When `index + 1` is greater than the buffer size
+
+`MalformedUnicode`
+
+* When the bytes at the index are not a valid UTF-8 sequence
+
+Examples:
+
+```grain
+let buf = Buffer.make(32)
+Buffer.addString("Hello World 🌾", buf)
+assert Buffer.getChar(12, buf) == '🌾'
+```
+
 ### Buffer.**addChar**
 
 <details disabled>
@@ -430,10 +475,10 @@ Appends the bytes of a character to a buffer.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`char`|`Char`|The character to append to the buffer|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description                           |
+| -------- | -------- | ------------------------------------- |
+| `char`   | `Char`   | The character to append to the buffer |
+| `buffer` | `Buffer` | The buffer to mutate                  |
 
 Examples:
 
@@ -458,10 +503,10 @@ Appends a character represented by a code point to a buffer.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`codePoint`|`Number`|The code point to append to the buffer|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param       | type     | description                            |
+| ----------- | -------- | -------------------------------------- |
+| `codePoint` | `Number` | The code point to append to the buffer |
+| `buffer`    | `Buffer` | The buffer to mutate                   |
 
 Examples:
 
@@ -494,12 +539,12 @@ Appends the bytes of a subset of a string to a buffer.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`start`|`Number`|The char offset into the string|
-|`end`|`Number`|The end offset into the string|
-|`string`|`String`|The string to append|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description                     |
+| -------- | -------- | ------------------------------- |
+| `start`  | `Number` | The char offset into the string |
+| `end`    | `Number` | The end offset into the string  |
+| `string` | `String` | The string to append            |
+| `buffer` | `Buffer` | The buffer to mutate            |
 
 Examples:
 
@@ -525,12 +570,12 @@ Appends the bytes of a subset of a byte sequence to a buffer.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`start`|`Number`|The byte offset into the byte sequence|
-|`length`|`Number`|The number of bytes to append|
-|`bytes`|`Bytes`|The byte sequence to append|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description                            |
+| -------- | -------- | -------------------------------------- |
+| `start`  | `Number` | The byte offset into the byte sequence |
+| `length` | `Number` | The number of bytes to append          |
+| `bytes`  | `Bytes`  | The byte sequence to append            |
+| `buffer` | `Buffer` | The buffer to mutate                   |
 
 Throws:
 
@@ -566,10 +611,10 @@ The source buffer is not mutated by this operation. The destination buffer, howe
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`srcBuffer`|`Buffer`|The buffer to append|
-|`dstBuffer`|`Buffer`|The buffer to mutate|
+| param       | type     | description          |
+| ----------- | -------- | -------------------- |
+| `srcBuffer` | `Buffer` | The buffer to append |
+| `dstBuffer` | `Buffer` | The buffer to mutate |
 
 Examples:
 
@@ -601,12 +646,12 @@ The source buffer is not mutated by this operation. The destination buffer, howe
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`start`|`Number`|The byte offset into the buffer|
-|`length`|`Number`|The number of bytes to append|
-|`srcBuffer`|`Buffer`|The buffer to append|
-|`dstBuffer`|`Buffer`|The buffer to mutate|
+| param       | type     | description                     |
+| ----------- | -------- | ------------------------------- |
+| `start`     | `Number` | The byte offset into the buffer |
+| `length`    | `Number` | The number of bytes to append   |
+| `srcBuffer` | `Buffer` | The buffer to append            |
+| `dstBuffer` | `Buffer` | The buffer to mutate            |
 
 Examples:
 
@@ -641,16 +686,16 @@ Gets a signed 8-bit integer starting at the given byte index.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`index`|`Number`|The byte index to access|
-|`buffer`|`Buffer`|The buffer to access|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `index`  | `Number` | The byte index to access |
+| `buffer` | `Buffer` | The buffer to access     |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Int8`|A signed 8-bit integer that starts at the given index|
+| type   | description                                           |
+| ------ | ----------------------------------------------------- |
+| `Int8` | A signed 8-bit integer that starts at the given index |
 
 Throws:
 
@@ -670,6 +715,8 @@ assert Buffer.getInt8(0, buf) == 1s
 
 ### Buffer.**setInt8**
 
+> **Deprecated:** Use `Bytes` instead of `Buffer` for set operations.
+
 <details>
 <summary>Added in <code>0.4.0</code></summary>
 <table>
@@ -678,6 +725,7 @@ assert Buffer.getInt8(0, buf) == 1s
 </thead>
 <tbody>
 <tr><td><code>0.6.0</code></td><td>`value` argument type changed to `Int8`</td></tr>
+<tr><td><code>0.7.1</code></td><td>Deprecated in favor of `Bytes.setInt8`</td></tr>
 </tbody>
 </table>
 </details>
@@ -690,11 +738,11 @@ Sets a signed 8-bit integer starting at the given byte index.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`index`|`Number`|The byte index to update|
-|`value`|`Int8`|The value to set|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `index`  | `Number` | The byte index to update |
+| `value`  | `Int8`   | The value to set         |
+| `buffer` | `Buffer` | The buffer to mutate     |
 
 Throws:
 
@@ -735,10 +783,10 @@ Appends a signed 8-bit integer to a buffer.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`value`|`Int8`|The value to append|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description          |
+| -------- | -------- | -------------------- |
+| `value`  | `Int8`   | The value to append  |
+| `buffer` | `Buffer` | The buffer to mutate |
 
 Examples:
 
@@ -770,16 +818,16 @@ Gets an unsigned 8-bit integer starting at the given byte index.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`index`|`Number`|The byte index to access|
-|`buffer`|`Buffer`|The buffer to access|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `index`  | `Number` | The byte index to access |
+| `buffer` | `Buffer` | The buffer to access     |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Uint8`|An unsigned 8-bit integer that starts at the given index|
+| type    | description                                              |
+| ------- | -------------------------------------------------------- |
+| `Uint8` | An unsigned 8-bit integer that starts at the given index |
 
 Throws:
 
@@ -799,9 +847,18 @@ assert Buffer.getUint8(0, buf) == 3us
 
 ### Buffer.**setUint8**
 
-<details disabled>
-<summary tabindex="-1">Added in <code>0.6.0</code></summary>
-No other changes yet.
+> **Deprecated:** Use `Bytes` instead of `Buffer` for set operations.
+
+<details>
+<summary>Added in <code>0.6.0</code></summary>
+<table>
+<thead>
+<tr><th>version</th><th>changes</th></tr>
+</thead>
+<tbody>
+<tr><td><code>0.7.1</code></td><td>Deprecated in favor of `Bytes.setUint8`</td></tr>
+</tbody>
+</table>
 </details>
 
 ```grain
@@ -812,11 +869,11 @@ Sets an unsigned 8-bit integer starting at the given byte index.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`index`|`Number`|The byte index to update|
-|`value`|`Uint8`|The value to set|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `index`  | `Number` | The byte index to update |
+| `value`  | `Uint8`  | The value to set         |
+| `buffer` | `Buffer` | The buffer to mutate     |
 
 Throws:
 
@@ -850,10 +907,10 @@ Appends an unsigned 8-bit integer to a buffer.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`value`|`Uint8`|The value to append|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description          |
+| -------- | -------- | -------------------- |
+| `value`  | `Uint8`  | The value to append  |
+| `buffer` | `Buffer` | The buffer to mutate |
 
 Examples:
 
@@ -885,16 +942,16 @@ Gets a signed 16-bit integer starting at the given byte index.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`index`|`Number`|The byte index to access|
-|`buffer`|`Buffer`|The buffer to access|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `index`  | `Number` | The byte index to access |
+| `buffer` | `Buffer` | The buffer to access     |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Int16`|A signed 16-bit integer that starts at the given index|
+| type    | description                                            |
+| ------- | ------------------------------------------------------ |
+| `Int16` | A signed 16-bit integer that starts at the given index |
 
 Throws:
 
@@ -914,6 +971,8 @@ assert Buffer.getInt16(0, buf) == 1S
 
 ### Buffer.**setInt16**
 
+> **Deprecated:** Use `Bytes` instead of `Buffer` for set operations.
+
 <details>
 <summary>Added in <code>0.4.0</code></summary>
 <table>
@@ -922,6 +981,7 @@ assert Buffer.getInt16(0, buf) == 1S
 </thead>
 <tbody>
 <tr><td><code>0.6.0</code></td><td>`value` argument type changed to `Int16`</td></tr>
+<tr><td><code>0.7.1</code></td><td>Deprecated in favor of `Bytes.setInt16`</td></tr>
 </tbody>
 </table>
 </details>
@@ -934,11 +994,11 @@ Sets a signed 16-bit integer starting at the given byte index.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`index`|`Number`|The byte index to update|
-|`value`|`Int16`|The value to set|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `index`  | `Number` | The byte index to update |
+| `value`  | `Int16`  | The value to set         |
+| `buffer` | `Buffer` | The buffer to mutate     |
 
 Throws:
 
@@ -979,10 +1039,10 @@ Appends a signed 16-bit integer to a buffer.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`value`|`Int16`|The value to append|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description          |
+| -------- | -------- | -------------------- |
+| `value`  | `Int16`  | The value to append  |
+| `buffer` | `Buffer` | The buffer to mutate |
 
 Examples:
 
@@ -1014,16 +1074,16 @@ Gets an unsigned 16-bit integer starting at the given byte index.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`index`|`Number`|The byte index to access|
-|`buffer`|`Buffer`|The buffer to access|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `index`  | `Number` | The byte index to access |
+| `buffer` | `Buffer` | The buffer to access     |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Uint16`|An unsigned 16-bit integer that starts at the given index|
+| type     | description                                               |
+| -------- | --------------------------------------------------------- |
+| `Uint16` | An unsigned 16-bit integer that starts at the given index |
 
 Throws:
 
@@ -1043,9 +1103,18 @@ assert Buffer.getUint16(0, buf) == 1uS
 
 ### Buffer.**setUint16**
 
-<details disabled>
-<summary tabindex="-1">Added in <code>0.6.0</code></summary>
-No other changes yet.
+> **Deprecated:** Use `Bytes` instead of `Buffer` for set operations.
+
+<details>
+<summary>Added in <code>0.6.0</code></summary>
+<table>
+<thead>
+<tr><th>version</th><th>changes</th></tr>
+</thead>
+<tbody>
+<tr><td><code>0.7.1</code></td><td>Deprecated in favor of `Bytes.setUint16`</td></tr>
+</tbody>
+</table>
 </details>
 
 ```grain
@@ -1056,11 +1125,11 @@ Sets an unsigned 16-bit integer starting at the given byte index.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`index`|`Number`|The byte index to update|
-|`value`|`Uint16`|The value to set|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `index`  | `Number` | The byte index to update |
+| `value`  | `Uint16` | The value to set         |
+| `buffer` | `Buffer` | The buffer to mutate     |
 
 Throws:
 
@@ -1094,10 +1163,10 @@ Appends an unsigned 16-bit integer to a buffer.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`value`|`Uint16`|The value to append|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description          |
+| -------- | -------- | -------------------- |
+| `value`  | `Uint16` | The value to append  |
+| `buffer` | `Buffer` | The buffer to mutate |
 
 Examples:
 
@@ -1122,16 +1191,16 @@ Gets a signed 32-bit integer starting at the given byte index.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`index`|`Number`|The byte index to access|
-|`buffer`|`Buffer`|The buffer to access|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `index`  | `Number` | The byte index to access |
+| `buffer` | `Buffer` | The buffer to access     |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Int32`|A signed 32-bit integer that starts at the given index|
+| type    | description                                            |
+| ------- | ------------------------------------------------------ |
+| `Int32` | A signed 32-bit integer that starts at the given index |
 
 Throws:
 
@@ -1151,9 +1220,18 @@ assert Buffer.getInt32(0, buf) == 1l
 
 ### Buffer.**setInt32**
 
-<details disabled>
-<summary tabindex="-1">Added in <code>0.4.0</code></summary>
-No other changes yet.
+> **Deprecated:** Use `Bytes` instead of `Buffer` for set operations.
+
+<details>
+<summary>Added in <code>0.4.0</code></summary>
+<table>
+<thead>
+<tr><th>version</th><th>changes</th></tr>
+</thead>
+<tbody>
+<tr><td><code>0.7.1</code></td><td>Deprecated in favor of `Bytes.setInt32`</td></tr>
+</tbody>
+</table>
 </details>
 
 ```grain
@@ -1164,11 +1242,11 @@ Sets a signed 32-bit integer starting at the given byte index.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`index`|`Number`|The byte index to update|
-|`value`|`Int32`|The value to set|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `index`  | `Number` | The byte index to update |
+| `value`  | `Int32`  | The value to set         |
+| `buffer` | `Buffer` | The buffer to mutate     |
 
 Throws:
 
@@ -1202,10 +1280,10 @@ Appends a signed 32-bit integer to a buffer.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`value`|`Int32`|The value to append|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description          |
+| -------- | -------- | -------------------- |
+| `value`  | `Int32`  | The value to append  |
+| `buffer` | `Buffer` | The buffer to mutate |
 
 Examples:
 
@@ -1230,16 +1308,16 @@ Gets an unsigned 32-bit integer starting at the given byte index.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`index`|`Number`|The byte index to access|
-|`buffer`|`Buffer`|The buffer to access|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `index`  | `Number` | The byte index to access |
+| `buffer` | `Buffer` | The buffer to access     |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Uint32`|An unsigned 32-bit integer that starts at the given index|
+| type     | description                                               |
+| -------- | --------------------------------------------------------- |
+| `Uint32` | An unsigned 32-bit integer that starts at the given index |
 
 Throws:
 
@@ -1259,9 +1337,18 @@ assert Buffer.getUint32(0, buf) == 1ul
 
 ### Buffer.**setUint32**
 
-<details disabled>
-<summary tabindex="-1">Added in <code>0.6.0</code></summary>
-No other changes yet.
+> **Deprecated:** Use `Bytes` instead of `Buffer` for set operations.
+
+<details>
+<summary>Added in <code>0.6.0</code></summary>
+<table>
+<thead>
+<tr><th>version</th><th>changes</th></tr>
+</thead>
+<tbody>
+<tr><td><code>0.7.1</code></td><td>Deprecated in favor of `Bytes.setUint32`</td></tr>
+</tbody>
+</table>
 </details>
 
 ```grain
@@ -1272,11 +1359,11 @@ Sets an unsigned 32-bit integer starting at the given byte index.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`index`|`Number`|The byte index to update|
-|`value`|`Uint32`|The value to set|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `index`  | `Number` | The byte index to update |
+| `value`  | `Uint32` | The value to set         |
+| `buffer` | `Buffer` | The buffer to mutate     |
 
 Throws:
 
@@ -1310,10 +1397,10 @@ Appends an unsigned 32-bit integer to a buffer.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`value`|`Uint32`|The value to append|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description          |
+| -------- | -------- | -------------------- |
+| `value`  | `Uint32` | The value to append  |
+| `buffer` | `Buffer` | The buffer to mutate |
 
 Examples:
 
@@ -1338,16 +1425,16 @@ Gets a 32-bit float starting at the given byte index.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`index`|`Number`|The byte index to access|
-|`buffer`|`Buffer`|The buffer to access|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `index`  | `Number` | The byte index to access |
+| `buffer` | `Buffer` | The buffer to access     |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Float32`|A 32-bit float that starts at the given index|
+| type      | description                                   |
+| --------- | --------------------------------------------- |
+| `Float32` | A 32-bit float that starts at the given index |
 
 Throws:
 
@@ -1367,9 +1454,18 @@ assert Buffer.getFloat32(0, buf) == 1.0f
 
 ### Buffer.**setFloat32**
 
-<details disabled>
-<summary tabindex="-1">Added in <code>0.4.0</code></summary>
-No other changes yet.
+> **Deprecated:** Use `Bytes` instead of `Buffer` for set operations.
+
+<details>
+<summary>Added in <code>0.4.0</code></summary>
+<table>
+<thead>
+<tr><th>version</th><th>changes</th></tr>
+</thead>
+<tbody>
+<tr><td><code>0.7.1</code></td><td>Deprecated in favor of `Bytes.setFloat32`</td></tr>
+</tbody>
+</table>
 </details>
 
 ```grain
@@ -1380,11 +1476,11 @@ Sets a 32-bit float starting at the given byte index.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`index`|`Number`|The byte index to update|
-|`value`|`Float32`|The value to set|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type      | description              |
+| -------- | --------- | ------------------------ |
+| `index`  | `Number`  | The byte index to update |
+| `value`  | `Float32` | The value to set         |
+| `buffer` | `Buffer`  | The buffer to mutate     |
 
 Throws:
 
@@ -1418,10 +1514,10 @@ Appends a 32-bit float to a buffer.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`value`|`Float32`|The value to append|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type      | description          |
+| -------- | --------- | -------------------- |
+| `value`  | `Float32` | The value to append  |
+| `buffer` | `Buffer`  | The buffer to mutate |
 
 Examples:
 
@@ -1446,16 +1542,16 @@ Gets a signed 64-bit integer starting at the given byte index.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`index`|`Number`|The byte index to access|
-|`buffer`|`Buffer`|The buffer to access|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `index`  | `Number` | The byte index to access |
+| `buffer` | `Buffer` | The buffer to access     |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Int64`|A signed 64-bit integer that starts at the given index|
+| type    | description                                            |
+| ------- | ------------------------------------------------------ |
+| `Int64` | A signed 64-bit integer that starts at the given index |
 
 Throws:
 
@@ -1475,9 +1571,18 @@ assert Buffer.getInt64(0, buf) == 1L
 
 ### Buffer.**setInt64**
 
-<details disabled>
-<summary tabindex="-1">Added in <code>0.4.0</code></summary>
-No other changes yet.
+> **Deprecated:** Use `Bytes` instead of `Buffer` for set operations.
+
+<details>
+<summary>Added in <code>0.4.0</code></summary>
+<table>
+<thead>
+<tr><th>version</th><th>changes</th></tr>
+</thead>
+<tbody>
+<tr><td><code>0.7.1</code></td><td>Deprecated in favor of `Bytes.setInt64</td></tr>
+</tbody>
+</table>
 </details>
 
 ```grain
@@ -1488,11 +1593,11 @@ Sets a signed 64-bit integer starting at the given byte index.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`index`|`Number`|The byte index to update|
-|`value`|`Int64`|The value to set|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `index`  | `Number` | The byte index to update |
+| `value`  | `Int64`  | The value to set         |
+| `buffer` | `Buffer` | The buffer to mutate     |
 
 Throws:
 
@@ -1526,10 +1631,10 @@ Appends a signed 64-bit integer to a buffer.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`value`|`Int64`|The value to set|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description          |
+| -------- | -------- | -------------------- |
+| `value`  | `Int64`  | The value to set     |
+| `buffer` | `Buffer` | The buffer to mutate |
 
 Examples:
 
@@ -1554,16 +1659,16 @@ Gets an unsigned 64-bit integer starting at the given byte index.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`index`|`Number`|The byte index to access|
-|`buffer`|`Buffer`|The buffer to access|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `index`  | `Number` | The byte index to access |
+| `buffer` | `Buffer` | The buffer to access     |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Uint64`|An unsigned 64-bit integer that starts at the given index|
+| type     | description                                               |
+| -------- | --------------------------------------------------------- |
+| `Uint64` | An unsigned 64-bit integer that starts at the given index |
 
 Throws:
 
@@ -1583,9 +1688,18 @@ assert Buffer.getUint64(0, buf) == 1uL
 
 ### Buffer.**setUint64**
 
-<details disabled>
-<summary tabindex="-1">Added in <code>0.6.0</code></summary>
-No other changes yet.
+> **Deprecated:** Use `Bytes` instead of `Buffer` for set operations.
+
+<details>
+<summary>Added in <code>0.6.0</code></summary>
+<table>
+<thead>
+<tr><th>version</th><th>changes</th></tr>
+</thead>
+<tbody>
+<tr><td><code>0.7.1</code></td><td>Deprecated in favor of `Bytes.setUint64`</td></tr>
+</tbody>
+</table>
 </details>
 
 ```grain
@@ -1596,11 +1710,11 @@ Sets an unsigned 64-bit integer starting at the given byte index.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`index`|`Number`|The byte index to update|
-|`value`|`Uint64`|The value to set|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `index`  | `Number` | The byte index to update |
+| `value`  | `Uint64` | The value to set         |
+| `buffer` | `Buffer` | The buffer to mutate     |
 
 Throws:
 
@@ -1634,10 +1748,10 @@ Appends an unsigned 64-bit integer to a buffer.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`value`|`Uint64`|The value to set|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type     | description          |
+| -------- | -------- | -------------------- |
+| `value`  | `Uint64` | The value to set     |
+| `buffer` | `Buffer` | The buffer to mutate |
 
 Examples:
 
@@ -1662,16 +1776,16 @@ Gets a 64-bit float starting at the given byte index.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`index`|`Number`|The byte index to access|
-|`buffer`|`Buffer`|The buffer to access|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `index`  | `Number` | The byte index to access |
+| `buffer` | `Buffer` | The buffer to access     |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Float64`|A 64-bit float that starts at the given index|
+| type      | description                                   |
+| --------- | --------------------------------------------- |
+| `Float64` | A 64-bit float that starts at the given index |
 
 Throws:
 
@@ -1691,9 +1805,18 @@ assert Buffer.getFloat64(0, buf) == 1.0F
 
 ### Buffer.**setFloat64**
 
-<details disabled>
-<summary tabindex="-1">Added in <code>0.4.0</code></summary>
-No other changes yet.
+> **Deprecated:** Use `Bytes` instead of `Buffer` for set operations.
+
+<details>
+<summary>Added in <code>0.4.0</code></summary>
+<table>
+<thead>
+<tr><th>version</th><th>changes</th></tr>
+</thead>
+<tbody>
+<tr><td><code>0.7.1</code></td><td>Deprecated in favor of `Bytes.setFloat64`</td></tr>
+</tbody>
+</table>
 </details>
 
 ```grain
@@ -1704,11 +1827,11 @@ Sets a 64-bit float starting at the given byte index.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`index`|`Number`|The byte index to update|
-|`value`|`Float64`|The value to set|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type      | description              |
+| -------- | --------- | ------------------------ |
+| `index`  | `Number`  | The byte index to update |
+| `value`  | `Float64` | The value to set         |
+| `buffer` | `Buffer`  | The buffer to mutate     |
 
 Throws:
 
@@ -1742,10 +1865,10 @@ Appends a 64-bit float to a buffer.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`value`|`Float64`|The value to append|
-|`buffer`|`Buffer`|The buffer to mutate|
+| param    | type      | description          |
+| -------- | --------- | -------------------- |
+| `value`  | `Float64` | The value to append  |
+| `buffer` | `Buffer`  | The buffer to mutate |
 
 Examples: