@grain/stdlib 0.6.6 → 0.7.1

package/buffer.md

@@ -41,7 +41,7 @@ No other changes yet.
 </details>
 
 ```grain
-make : (initialSize: Number) => Buffer
+make: (initialSize: Number) => Buffer
 ```
 
 Creates a fresh buffer, initially empty.
@@ -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:
 
@@ -85,22 +85,22 @@ No other changes yet.
 </details>
 
 ```grain
-length : (buffer: Buffer) => Number
+length: (buffer: Buffer) => Number
 ```
 
 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:
 
@@ -122,7 +122,7 @@ No other changes yet.
 </details>
 
 ```grain
-clear : (buffer: Buffer) => Void
+clear: (buffer: Buffer) => Void
 ```
 
 Clears data in the buffer and sets its length to zero.
@@ -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:
 
@@ -153,7 +153,7 @@ No other changes yet.
 </details>
 
 ```grain
-reset : (buffer: Buffer) => Void
+reset: (buffer: Buffer) => Void
 ```
 
 Empty a buffer and deallocate the internal byte sequence holding the buffer contents.
@@ -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:
 
@@ -184,7 +184,7 @@ No other changes yet.
 </details>
 
 ```grain
-truncate : (length: Number, buffer: Buffer) => Void
+truncate: (length: Number, buffer: Buffer) => Void
 ```
 
 Shortens a buffer to the given length.
@@ -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:
 
@@ -223,22 +223,22 @@ No other changes yet.
 </details>
 
 ```grain
-toBytes : (buffer: Buffer) => Bytes
+toBytes: (buffer: Buffer) => Bytes
 ```
 
 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:
 
@@ -256,24 +256,24 @@ No other changes yet.
 </details>
 
 ```grain
-toBytesSlice : (start: Number, length: Number, buffer: Buffer) => Bytes
+toBytesSlice: (start: Number, length: Number, buffer: Buffer) => Bytes
 ```
 
 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:
 
@@ -299,22 +299,22 @@ No other changes yet.
 </details>
 
 ```grain
-toString : (buffer: Buffer) => String
+toString: (buffer: Buffer) => String
 ```
 
 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:
 
@@ -332,24 +332,24 @@ No other changes yet.
 </details>
 
 ```grain
-toStringSlice : (start: Number, length: Number, buffer: Buffer) => String
+toStringSlice: (start: Number, length: Number, buffer: Buffer) => String
 ```
 
 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:
 
@@ -367,17 +367,17 @@ No other changes yet.
 </details>
 
 ```grain
-addBytes : (bytes: Bytes, buffer: Buffer) => Void
+addBytes: (bytes: Bytes, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -395,17 +395,17 @@ No other changes yet.
 </details>
 
 ```grain
-addString : (string: String, buffer: Buffer) => Void
+addString: (string: String, buffer: Buffer) => Void
 ```
 
 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>
@@ -423,17 +468,17 @@ No other changes yet.
 </details>
 
 ```grain
-addChar : (char: Char, buffer: Buffer) => Void
+addChar: (char: Char, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -451,17 +496,17 @@ No other changes yet.
 </details>
 
 ```grain
-addCharFromCodePoint : (codePoint: Number, buffer: Buffer) => Void
+addCharFromCodePoint: (codePoint: Number, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -486,7 +531,7 @@ assert Buffer.toString(buf) == "H"
 </details>
 
 ```grain
-addStringSlice :
+addStringSlice:
   (start: Number, end: Number, string: String, buffer: Buffer) => Void
 ```
 
@@ -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:
 
@@ -517,7 +562,7 @@ No other changes yet.
 </details>
 
 ```grain
-addBytesSlice :
+addBytesSlice:
   (start: Number, length: Number, bytes: Bytes, buffer: Buffer) => Void
 ```
 
@@ -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:
 
@@ -557,7 +602,7 @@ No other changes yet.
 </details>
 
 ```grain
-addBuffer : (srcBuffer: Buffer, dstBuffer: Buffer) => Void
+addBuffer: (srcBuffer: Buffer, dstBuffer: Buffer) => Void
 ```
 
 Appends the bytes of a source buffer to destination buffer.
@@ -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:
 
@@ -590,7 +635,7 @@ No other changes yet.
 </details>
 
 ```grain
-addBufferSlice :
+addBufferSlice:
   (start: Number, length: Number, srcBuffer: Buffer, dstBuffer: Buffer) =>
    Void
 ```
@@ -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:
 
@@ -634,23 +679,23 @@ assert Buffer.toString(buf1) == "HelloWorld"
 </details>
 
 ```grain
-getInt8 : (index: Number, buffer: Buffer) => Int8
+getInt8: (index: Number, buffer: Buffer) => Int8
 ```
 
 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,23 +725,24 @@ 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>
 
 ```grain
-setInt8 : (index: Number, value: Int8, buffer: Buffer) => Void
+setInt8: (index: Number, value: Int8, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -728,17 +776,17 @@ assert Buffer.getInt8(0, buf) == 3s
 </details>
 
 ```grain
-addInt8 : (value: Int8, buffer: Buffer) => Void
+addInt8: (value: Int8, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -763,23 +811,23 @@ assert Buffer.getInt8(0, buf) == 2s
 </details>
 
 ```grain
-getUint8 : (index: Number, buffer: Buffer) => Uint8
+getUint8: (index: Number, buffer: Buffer) => Uint8
 ```
 
 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,24 +847,33 @@ 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
-setUint8 : (index: Number, value: Uint8, buffer: Buffer) => Void
+setUint8: (index: Number, value: Uint8, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -843,17 +900,17 @@ No other changes yet.
 </details>
 
 ```grain
-addUint8 : (value: Uint8, buffer: Buffer) => Void
+addUint8: (value: Uint8, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -878,23 +935,23 @@ assert Buffer.getUint8(0, buf) == 0us
 </details>
 
 ```grain
-getInt16 : (index: Number, buffer: Buffer) => Int16
+getInt16: (index: Number, buffer: Buffer) => Int16
 ```
 
 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,23 +981,24 @@ 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>
 
 ```grain
-setInt16 : (index: Number, value: Int16, buffer: Buffer) => Void
+setInt16: (index: Number, value: Int16, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -972,17 +1032,17 @@ assert Buffer.getInt16(5, buf) == 1S
 </details>
 
 ```grain
-addInt16 : (value: Int16, buffer: Buffer) => Void
+addInt16: (value: Int16, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -1007,23 +1067,23 @@ assert Buffer.getInt16(0, buf) == 2S
 </details>
 
 ```grain
-getUint16 : (index: Number, buffer: Buffer) => Uint16
+getUint16: (index: Number, buffer: Buffer) => Uint16
 ```
 
 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,24 +1103,33 @@ 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
-setUint16 : (index: Number, value: Uint16, buffer: Buffer) => Void
+setUint16: (index: Number, value: Uint16, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -1087,17 +1156,17 @@ No other changes yet.
 </details>
 
 ```grain
-addUint16 : (value: Uint16, buffer: Buffer) => Void
+addUint16: (value: Uint16, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -1115,23 +1184,23 @@ No other changes yet.
 </details>
 
 ```grain
-getInt32 : (index: Number, buffer: Buffer) => Int32
+getInt32: (index: Number, buffer: Buffer) => Int32
 ```
 
 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,24 +1220,33 @@ 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
-setInt32 : (index: Number, value: Int32, buffer: Buffer) => Void
+setInt32: (index: Number, value: Int32, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -1195,17 +1273,17 @@ No other changes yet.
 </details>
 
 ```grain
-addInt32 : (value: Int32, buffer: Buffer) => Void
+addInt32: (value: Int32, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -1223,23 +1301,23 @@ No other changes yet.
 </details>
 
 ```grain
-getUint32 : (index: Number, buffer: Buffer) => Uint32
+getUint32: (index: Number, buffer: Buffer) => Uint32
 ```
 
 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,24 +1337,33 @@ 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
-setUint32 : (index: Number, value: Uint32, buffer: Buffer) => Void
+setUint32: (index: Number, value: Uint32, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -1303,17 +1390,17 @@ No other changes yet.
 </details>
 
 ```grain
-addUint32 : (value: Uint32, buffer: Buffer) => Void
+addUint32: (value: Uint32, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -1331,23 +1418,23 @@ No other changes yet.
 </details>
 
 ```grain
-getFloat32 : (index: Number, buffer: Buffer) => Float32
+getFloat32: (index: Number, buffer: Buffer) => Float32
 ```
 
 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,24 +1454,33 @@ 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
-setFloat32 : (index: Number, value: Float32, buffer: Buffer) => Void
+setFloat32: (index: Number, value: Float32, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -1411,17 +1507,17 @@ No other changes yet.
 </details>
 
 ```grain
-addFloat32 : (value: Float32, buffer: Buffer) => Void
+addFloat32: (value: Float32, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -1439,23 +1535,23 @@ No other changes yet.
 </details>
 
 ```grain
-getInt64 : (index: Number, buffer: Buffer) => Int64
+getInt64: (index: Number, buffer: Buffer) => Int64
 ```
 
 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,24 +1571,33 @@ 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
-setInt64 : (index: Number, value: Int64, buffer: Buffer) => Void
+setInt64: (index: Number, value: Int64, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -1519,17 +1624,17 @@ No other changes yet.
 </details>
 
 ```grain
-addInt64 : (value: Int64, buffer: Buffer) => Void
+addInt64: (value: Int64, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -1547,23 +1652,23 @@ No other changes yet.
 </details>
 
 ```grain
-getUint64 : (index: Number, buffer: Buffer) => Uint64
+getUint64: (index: Number, buffer: Buffer) => Uint64
 ```
 
 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,24 +1688,33 @@ 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
-setUint64 : (index: Number, value: Uint64, buffer: Buffer) => Void
+setUint64: (index: Number, value: Uint64, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -1627,17 +1741,17 @@ No other changes yet.
 </details>
 
 ```grain
-addUint64 : (value: Uint64, buffer: Buffer) => Void
+addUint64: (value: Uint64, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -1655,23 +1769,23 @@ No other changes yet.
 </details>
 
 ```grain
-getFloat64 : (index: Number, buffer: Buffer) => Float64
+getFloat64: (index: Number, buffer: Buffer) => Float64
 ```
 
 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,24 +1805,33 @@ 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
-setFloat64 : (index: Number, value: Float64, buffer: Buffer) => Void
+setFloat64: (index: Number, value: Float64, buffer: Buffer) => Void
 ```
 
 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:
 
@@ -1735,17 +1858,17 @@ No other changes yet.
 </details>
 
 ```grain
-addFloat64 : (value: Float64, buffer: Buffer) => Void
+addFloat64: (value: Float64, buffer: Buffer) => Void
 ```
 
 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: