@grain/stdlib 0.6.6 → 0.7.1

package/string.md

@@ -51,23 +51,23 @@ No other changes yet.
 </details>
 
 ```grain
-concat : (str1: String, str2: String) => String
+concat: (str1: String, str2: String) => String
 ```
 
 Concatenate two strings.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`str1`|`String`|The beginning string|
-|`str2`|`String`|The ending string|
+| param  | type     | description          |
+| ------ | -------- | -------------------- |
+| `str1` | `String` | The beginning string |
+| `str2` | `String` | The ending string    |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`String`|The combined string|
+| type     | description         |
+| -------- | ------------------- |
+| `String` | The combined string |
 
 Examples:
 
@@ -83,22 +83,22 @@ No other changes yet.
 </details>
 
 ```grain
-length : (string: String) => Number
+length: (string: String) => Number
 ```
 
 Returns the character length of the input string.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`string`|`String`|The string to inspect|
+| param    | type     | description           |
+| -------- | -------- | --------------------- |
+| `string` | `String` | The string to inspect |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Number`|The number of characters in the string|
+| type     | description                            |
+| -------- | -------------------------------------- |
+| `Number` | The number of characters in the string |
 
 Examples:
 
@@ -114,22 +114,22 @@ No other changes yet.
 </details>
 
 ```grain
-byteLength : (string: String) => Number
+byteLength: (string: String) => Number
 ```
 
 Returns the byte length of the input string.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`string`|`String`|The string to inspect|
+| param    | type     | description           |
+| -------- | -------- | --------------------- |
+| `string` | `String` | The string to inspect |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Number`|The number of bytes in the string|
+| type     | description                       |
+| -------- | --------------------------------- |
+| `Number` | The number of bytes in the string |
 
 Examples:
 
@@ -145,22 +145,22 @@ No other changes yet.
 </details>
 
 ```grain
-isEmpty : (string: String) => Bool
+isEmpty: (string: String) => Bool
 ```
 
 Determines if the string contains no characters.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`string`|`String`|The string to inspect|
+| param    | type     | description           |
+| -------- | -------- | --------------------- |
+| `string` | `String` | The string to inspect |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Bool`|`true` if the string is empty and `false` otherwise|
+| type   | description                                         |
+| ------ | --------------------------------------------------- |
+| `Bool` | `true` if the string is empty and `false` otherwise |
 
 ### String.**indexOf**
 
@@ -170,23 +170,23 @@ No other changes yet.
 </details>
 
 ```grain
-indexOf : (search: String, string: String) => Option<Number>
+indexOf: (search: String, string: String) => Option<Number>
 ```
 
 Finds the first position of a substring in the input string.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`search`|`String`|The substring to find|
-|`string`|`String`|The string to inspect|
+| param    | type     | description           |
+| -------- | -------- | --------------------- |
+| `search` | `String` | The substring to find |
+| `string` | `String` | The string to inspect |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Option<Number>`|`Some(position)` containing the starting position of the substring if found or `None` otherwise|
+| type             | description                                                                                     |
+| ---------------- | ----------------------------------------------------------------------------------------------- |
+| `Option<Number>` | `Some(position)` containing the starting position of the substring if found or `None` otherwise |
 
 Examples:
 
@@ -202,23 +202,23 @@ No other changes yet.
 </details>
 
 ```grain
-lastIndexOf : (search: String, string: String) => Option<Number>
+lastIndexOf: (search: String, string: String) => Option<Number>
 ```
 
 Finds the last position of a substring in the input string.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`search`|`String`|The substring to find|
-|`string`|`String`|The string to inspect|
+| param    | type     | description           |
+| -------- | -------- | --------------------- |
+| `search` | `String` | The substring to find |
+| `string` | `String` | The string to inspect |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Option<Number>`|`Some(position)` containing the starting position of the substring if found or `None` otherwise|
+| type             | description                                                                                     |
+| ---------------- | ----------------------------------------------------------------------------------------------- |
+| `Option<Number>` | `Some(position)` containing the starting position of the substring if found or `None` otherwise |
 
 Examples:
 
@@ -234,23 +234,23 @@ No other changes yet.
 </details>
 
 ```grain
-charCodeAt : (position: Number, string: String) => Number
+charCodeAt: (position: Number, string: String) => Number
 ```
 
 Get the Unicode code point at the position in the input string.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`position`|`Number`|The position to check|
-|`string`|`String`|The string to search|
+| param      | type     | description           |
+| ---------- | -------- | --------------------- |
+| `position` | `Number` | The position to check |
+| `string`   | `String` | The string to search  |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Number`|The character code at the provided position|
+| type     | description                                 |
+| -------- | ------------------------------------------- |
+| `Number` | The character code at the provided position |
 
 Throws:
 
@@ -276,23 +276,23 @@ No other changes yet.
 </details>
 
 ```grain
-charAt : (position: Number, string: String) => Char
+charAt: (position: Number, string: String) => Char
 ```
 
 Get the character at the position in the input string.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`position`|`Number`|The position to check|
-|`string`|`String`|The string to search|
+| param      | type     | description           |
+| ---------- | -------- | --------------------- |
+| `position` | `Number` | The position to check |
+| `string`   | `String` | The string to search  |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Char`|The character at the provided position|
+| type   | description                            |
+| ------ | -------------------------------------- |
+| `Char` | The character at the provided position |
 
 Throws:
 
@@ -318,22 +318,22 @@ No other changes yet.
 </details>
 
 ```grain
-explode : (string: String) => Array<Char>
+explode: (string: String) => Array<Char>
 ```
 
 Split a string into its Unicode characters.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`string`|`String`|The string to split|
+| param    | type     | description         |
+| -------- | -------- | ------------------- |
+| `string` | `String` | The string to split |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Array<Char>`|An array containing all characters in the string|
+| type          | description                                      |
+| ------------- | ------------------------------------------------ |
+| `Array<Char>` | An array containing all characters in the string |
 
 Throws:
 
@@ -355,22 +355,22 @@ No other changes yet.
 </details>
 
 ```grain
-implode : (arr: Array<Char>) => String
+implode: (arr: Array<Char>) => String
 ```
 
 Create a string from an array of characters.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`arr`|`Array<Char>`|The array to combine|
+| param | type          | description          |
+| ----- | ------------- | -------------------- |
+| `arr` | `Array<Char>` | The array to combine |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`String`|A string representation of the array of characters|
+| type     | description                                        |
+| -------- | -------------------------------------------------- |
+| `String` | A string representation of the array of characters |
 
 Examples:
 
@@ -386,22 +386,22 @@ No other changes yet.
 </details>
 
 ```grain
-reverse : (string: String) => String
+reverse: (string: String) => String
 ```
 
 Create a string that is the given string reversed.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`string`|`String`|The string to reverse|
+| param    | type     | description           |
+| -------- | -------- | --------------------- |
+| `string` | `String` | The string to reverse |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`String`|A string whose characters are in the reverse order of the given string|
+| type     | description                                                            |
+| -------- | ---------------------------------------------------------------------- |
+| `String` | A string whose characters are in the reverse order of the given string |
 
 Examples:
 
@@ -412,23 +412,23 @@ String.reverse("olleH") == "Hello"
 ### String.**split**
 
 ```grain
-split : (separator: String, string: String) => Array<String>
+split: (separator: String, string: String) => Array<String>
 ```
 
 Split a string by the given separator.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`separator`|`String`|The separator to split on|
-|`string`|`String`|The string to split|
+| param       | type     | description               |
+| ----------- | -------- | ------------------------- |
+| `separator` | `String` | The separator to split on |
+| `string`    | `String` | The string to split       |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Array<String>`|An array of substrings from the initial string|
+| type            | description                                    |
+| --------------- | ---------------------------------------------- |
+| `Array<String>` | An array of substrings from the initial string |
 
 Throws:
 
@@ -457,24 +457,24 @@ String.split(" ", "Hello world") == [> "Hello", "world"]
 </details>
 
 ```grain
-slice : (start: Number, ?end: Number, string: String) => String
+slice: (start: Number, ?end: Number, string: String) => String
 ```
 
 Get a portion of a string.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`start`|`Number`|The start position of the substring|
-|`?end`|`Number`|The end position of the substring, exclusive|
-|`string`|`String`|The input string|
+| param    | type     | description                                  |
+| -------- | -------- | -------------------------------------------- |
+| `start`  | `Number` | The start position of the substring          |
+| `?end`   | `Number` | The end position of the substring, exclusive |
+| `string` | `String` | The input string                             |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`String`|The substring from the initial string|
+| type     | description                           |
+| -------- | ------------------------------------- |
+| `String` | The substring from the initial string |
 
 Throws:
 
@@ -507,23 +507,23 @@ No other changes yet.
 </details>
 
 ```grain
-contains : (search: String, string: String) => Bool
+contains: (search: String, string: String) => Bool
 ```
 
 Check if a string contains a substring.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`search`|`String`|The substring to check|
-|`string`|`String`|The string to search|
+| param    | type     | description            |
+| -------- | -------- | ---------------------- |
+| `search` | `String` | The substring to check |
+| `string` | `String` | The string to search   |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Bool`|`true` if the input string contains the search value or `false` otherwise|
+| type   | description                                                               |
+| ------ | ------------------------------------------------------------------------- |
+| `Bool` | `true` if the input string contains the search value or `false` otherwise |
 
 Examples:
 
@@ -539,23 +539,23 @@ No other changes yet.
 </details>
 
 ```grain
-startsWith : (search: String, string: String) => Bool
+startsWith: (search: String, string: String) => Bool
 ```
 
 Check if a string begins with another string.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`search`|`String`|The string to compare to the start|
-|`string`|`String`|The string to search|
+| param    | type     | description                        |
+| -------- | -------- | ---------------------------------- |
+| `search` | `String` | The string to compare to the start |
+| `string` | `String` | The string to search               |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Bool`|`true` if the input string starts with the search value or `false` otherwise|
+| type   | description                                                                  |
+| ------ | ---------------------------------------------------------------------------- |
+| `Bool` | `true` if the input string starts with the search value or `false` otherwise |
 
 Examples:
 
@@ -571,23 +571,23 @@ No other changes yet.
 </details>
 
 ```grain
-endsWith : (search: String, string: String) => Bool
+endsWith: (search: String, string: String) => Bool
 ```
 
 Check if a string ends with another string.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`search`|`String`|The string to compare to the end|
-|`string`|`String`|The string to search|
+| param    | type     | description                      |
+| -------- | -------- | -------------------------------- |
+| `search` | `String` | The string to compare to the end |
+| `string` | `String` | The string to search             |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Bool`|`true` if the input string ends with the search value or `false` otherwise|
+| type   | description                                                                |
+| ------ | -------------------------------------------------------------------------- |
+| `Bool` | `true` if the input string ends with the search value or `false` otherwise |
 
 Examples:
 
@@ -603,7 +603,7 @@ No other changes yet.
 </details>
 
 ```grain
-replaceFirst :
+replaceFirst:
   (searchPattern: String, replacement: String, string: String) => String
 ```
 
@@ -611,17 +611,17 @@ Replaces the first appearance of the search pattern in the string with the repla
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`searchPattern`|`String`|The string to replace|
-|`replacement`|`String`|The replacement|
-|`string`|`String`|The string to change|
+| param           | type     | description           |
+| --------------- | -------- | --------------------- |
+| `searchPattern` | `String` | The string to replace |
+| `replacement`   | `String` | The replacement       |
+| `string`        | `String` | The string to change  |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`String`|A new string with the first occurrence of the search pattern replaced|
+| type     | description                                                           |
+| -------- | --------------------------------------------------------------------- |
+| `String` | A new string with the first occurrence of the search pattern replaced |
 
 Examples:
 
@@ -637,7 +637,7 @@ No other changes yet.
 </details>
 
 ```grain
-replaceLast :
+replaceLast:
   (searchPattern: String, replacement: String, string: String) => String
 ```
 
@@ -645,17 +645,17 @@ Replaces the last appearance of the search pattern in the string with the replac
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`searchPattern`|`String`|The string to replace|
-|`replacement`|`String`|The replacement|
-|`string`|`String`|The string to change|
+| param           | type     | description           |
+| --------------- | -------- | --------------------- |
+| `searchPattern` | `String` | The string to replace |
+| `replacement`   | `String` | The replacement       |
+| `string`        | `String` | The string to change  |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`String`|A new string with the last occurrence of the search pattern replaced|
+| type     | description                                                          |
+| -------- | -------------------------------------------------------------------- |
+| `String` | A new string with the last occurrence of the search pattern replaced |
 
 Examples:
 
@@ -671,7 +671,7 @@ No other changes yet.
 </details>
 
 ```grain
-replaceAll :
+replaceAll:
   (searchPattern: String, replacement: String, string: String) => String
 ```
 
@@ -679,17 +679,17 @@ Replaces every appearance of the search pattern in the string with the replaceme
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`searchPattern`|`String`|The string to replace|
-|`replacement`|`String`|The replacement|
-|`string`|`String`|The string to change|
+| param           | type     | description           |
+| --------------- | -------- | --------------------- |
+| `searchPattern` | `String` | The string to replace |
+| `replacement`   | `String` | The replacement       |
+| `string`        | `String` | The string to change  |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`String`|A new string with each occurrence of the search pattern replaced|
+| type     | description                                                      |
+| -------- | ---------------------------------------------------------------- |
+| `String` | A new string with each occurrence of the search pattern replaced |
 
 Examples:
 
@@ -712,7 +712,7 @@ String.replaceAll("🌾", "🌎", "Hello 🌾🌾") == "Hello 🌎🌎"
 </details>
 
 ```grain
-encodeAt :
+encodeAt:
   (string: String, encoding: Encoding, dest: Bytes, destPos: Number,
    ?includeBom: Bool) => Bytes
 ```
@@ -721,19 +721,19 @@ Encodes the given string into a byte sequence at the supplied position using the
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`string`|`String`|The input string|
-|`encoding`|`Encoding`|The encoding to use|
-|`dest`|`Bytes`|The byte sequence that will be copied|
-|`destPos`|`Number`|The location in the byte sequence to write the output|
-|`?includeBom`|`Bool`|Whether or not to include a byte order marker (false by default)|
+| param         | type       | description                                                      |
+| ------------- | ---------- | ---------------------------------------------------------------- |
+| `string`      | `String`   | The input string                                                 |
+| `encoding`    | `Encoding` | The encoding to use                                              |
+| `dest`        | `Bytes`    | The byte sequence that will be copied                            |
+| `destPos`     | `Number`   | The location in the byte sequence to write the output            |
+| `?includeBom` | `Bool`     | Whether or not to include a byte order marker (false by default) |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Bytes`|A copy of the input bytes with the encoded string replaced at the given position|
+| type    | description                                                                      |
+| ------- | -------------------------------------------------------------------------------- |
+| `Bytes` | A copy of the input bytes with the encoded string replaced at the given position |
 
 Throws:
 
@@ -757,24 +757,24 @@ Throws:
 </details>
 
 ```grain
-encode : (string: String, encoding: Encoding, ?includeBom: Bool) => Bytes
+encode: (string: String, encoding: Encoding, ?includeBom: Bool) => Bytes
 ```
 
 Encodes the given string using the given encoding scheme.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`string`|`String`|The input string|
-|`encoding`|`Encoding`|The encoding to use|
-|`?includeBom`|`Bool`|Whether or not to include a byte order marker (false by default)|
+| param         | type       | description                                                      |
+| ------------- | ---------- | ---------------------------------------------------------------- |
+| `string`      | `String`   | The input string                                                 |
+| `encoding`    | `Encoding` | The encoding to use                                              |
+| `?includeBom` | `Bool`     | Whether or not to include a byte order marker (false by default) |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`Bytes`|The byte representation of the string in the given encoding|
+| type    | description                                                 |
+| ------- | ----------------------------------------------------------- |
+| `Bytes` | The byte representation of the string in the given encoding |
 
 ### String.**decodeRange**
 
@@ -791,7 +791,7 @@ Returns:
 </details>
 
 ```grain
-decodeRange :
+decodeRange:
   (bytes: Bytes, encoding: Encoding, start: Number, size: Number,
    ?keepBom: Bool) => String
 ```
@@ -800,19 +800,19 @@ Decodes the given byte sequence of the specified range into a string using the e
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`bytes`|`Bytes`|The input bytes|
-|`encoding`|`Encoding`|The encoding to use|
-|`start`|`Number`|The byte offset to begin decoding from|
-|`size`|`Number`|The maximum number of bytes to decode|
-|`?keepBom`|`Bool`|Whether or not to include a byte order marker (false by default)|
+| param      | type       | description                                                      |
+| ---------- | ---------- | ---------------------------------------------------------------- |
+| `bytes`    | `Bytes`    | The input bytes                                                  |
+| `encoding` | `Encoding` | The encoding to use                                              |
+| `start`    | `Number`   | The byte offset to begin decoding from                           |
+| `size`     | `Number`   | The maximum number of bytes to decode                            |
+| `?keepBom` | `Bool`     | Whether or not to include a byte order marker (false by default) |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`String`|The decoded string|
+| type     | description        |
+| -------- | ------------------ |
+| `String` | The decoded string |
 
 Throws:
 
@@ -838,24 +838,24 @@ Throws:
 </details>
 
 ```grain
-decode : (bytes: Bytes, encoding: Encoding, ?keepBom: Bool) => String
+decode: (bytes: Bytes, encoding: Encoding, ?keepBom: Bool) => String
 ```
 
 Decodes the given byte sequence into a string using the given encoding scheme.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`bytes`|`Bytes`|The input bytes|
-|`encoding`|`Encoding`|The encoding to use|
-|`?keepBom`|`Bool`|Whether or not to include a byte order marker (false by default)|
+| param      | type       | description                                                      |
+| ---------- | ---------- | ---------------------------------------------------------------- |
+| `bytes`    | `Bytes`    | The input bytes                                                  |
+| `encoding` | `Encoding` | The encoding to use                                              |
+| `?keepBom` | `Bool`     | Whether or not to include a byte order marker (false by default) |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`String`|The decoded string|
+| type     | description        |
+| -------- | ------------------ |
+| `String` | The decoded string |
 
 ### String.**forEachCodePoint**
 
@@ -865,17 +865,17 @@ No other changes yet.
 </details>
 
 ```grain
-forEachCodePoint : (fn: (Number => Void), str: String) => Void
+forEachCodePoint: (fn: (Number => Void), str: String) => Void
 ```
 
 Iterates over Unicode code points in a string.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`fn`|`Number => Void`|The iterator function|
-|`str`|`String`|The string to iterate|
+| param | type             | description           |
+| ----- | ---------------- | --------------------- |
+| `fn`  | `Number => Void` | The iterator function |
+| `str` | `String`         | The string to iterate |
 
 Examples:
 
@@ -891,7 +891,7 @@ No other changes yet.
 </details>
 
 ```grain
-forEachCodePointi : (fn: ((Number, Number) => Void), str: String) => Void
+forEachCodePointi: (fn: ((Number, Number) => Void), str: String) => Void
 ```
 
 Iterates over Unicode code points in a string. This is the same as
@@ -900,10 +900,10 @@ as the second argument to the iterator function.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`fn`|`(Number, Number) => Void`|The iterator function|
-|`str`|`String`|The string to iterate|
+| param | type                       | description           |
+| ----- | -------------------------- | --------------------- |
+| `fn`  | `(Number, Number) => Void` | The iterator function |
+| `str` | `String`                   | The string to iterate |
 
 Examples:
 
@@ -919,17 +919,17 @@ No other changes yet.
 </details>
 
 ```grain
-forEachChar : (fn: (Char => Void), str: String) => Void
+forEachChar: (fn: (Char => Void), str: String) => Void
 ```
 
 Iterates over Unicode characters in a string.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`fn`|`Char => Void`|The iterator function|
-|`str`|`String`|The string to iterate|
+| param | type           | description           |
+| ----- | -------------- | --------------------- |
+| `fn`  | `Char => Void` | The iterator function |
+| `str` | `String`       | The string to iterate |
 
 Examples:
 
@@ -945,7 +945,7 @@ No other changes yet.
 </details>
 
 ```grain
-forEachChari : (fn: ((Char, Number) => Void), str: String) => Void
+forEachChari: (fn: ((Char, Number) => Void), str: String) => Void
 ```
 
 Iterates over Unicode characters in a string. This is the same as
@@ -954,10 +954,10 @@ as the second argument to the iterator function.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`fn`|`(Char, Number) => Void`|The iterator function|
-|`str`|`String`|The string to iterate|
+| param | type                     | description           |
+| ----- | ------------------------ | --------------------- |
+| `fn`  | `(Char, Number) => Void` | The iterator function |
+| `str` | `String`                 | The string to iterate |
 
 Examples:
 
@@ -973,17 +973,17 @@ No other changes yet.
 </details>
 
 ```grain
-map : (fn: (Char => Char), str: String) => String
+map: (fn: (Char => Char), str: String) => String
 ```
 
 Builds a new string by mapping Unicode characters.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`fn`|`Char => Char`|The mapping function|
-|`str`|`String`|The string to map|
+| param | type           | description          |
+| ----- | -------------- | -------------------- |
+| `fn`  | `Char => Char` | The mapping function |
+| `str` | `String`       | The string to map    |
 
 Examples:
 
@@ -999,7 +999,7 @@ No other changes yet.
 </details>
 
 ```grain
-mapi : (fn: ((Char, Number) => Char), str: String) => String
+mapi: (fn: ((Char, Number) => Char), str: String) => String
 ```
 
 Builds a new string by mapping Unicode characters. This is the same as
@@ -1008,10 +1008,10 @@ as the second argument to the mapping function.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`fn`|`(Char, Number) => Char`|The mapping function|
-|`str`|`String`|The string to map|
+| param | type                     | description          |
+| ----- | ------------------------ | -------------------- |
+| `fn`  | `(Char, Number) => Char` | The mapping function |
+| `str` | `String`                 | The string to map    |
 
 Examples:
 
@@ -1027,22 +1027,22 @@ No other changes yet.
 </details>
 
 ```grain
-trimStart : (string: String) => String
+trimStart: (string: String) => String
 ```
 
 Trims the beginning of a string—removing any leading whitespace characters.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`string`|`String`|The string to be trimmed|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `string` | `String` | The string to be trimmed |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`String`|The trimmed string|
+| type     | description        |
+| -------- | ------------------ |
+| `String` | The trimmed string |
 
 Examples:
 
@@ -1058,22 +1058,22 @@ No other changes yet.
 </details>
 
 ```grain
-trimEnd : (string: String) => String
+trimEnd: (string: String) => String
 ```
 
 Trims the end of a string—removing any trailing whitespace characters.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`string`|`String`|The string to be trimmed|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `string` | `String` | The string to be trimmed |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`String`|The trimmed string|
+| type     | description        |
+| -------- | ------------------ |
+| `String` | The trimmed string |
 
 Examples:
 
@@ -1089,22 +1089,22 @@ No other changes yet.
 </details>
 
 ```grain
-trim : (string: String) => String
+trim: (string: String) => String
 ```
 
 Trims a string—removing all leading and trailing whitespace characters.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`string`|`String`|The string to be trimmed|
+| param    | type     | description              |
+| -------- | -------- | ------------------------ |
+| `string` | `String` | The string to be trimmed |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`String`|The trimmed string|
+| type     | description        |
+| -------- | ------------------ |
+| `String` | The trimmed string |
 
 Examples:
 
@@ -1120,22 +1120,22 @@ No other changes yet.
 </details>
 
 ```grain
-toAsciiLowercase : (string: String) => String
+toAsciiLowercase: (string: String) => String
 ```
 
 Converts all ASCII uppercase characters in the string to lowercase.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`string`|`String`|The string to convert|
+| param    | type     | description           |
+| -------- | -------- | --------------------- |
+| `string` | `String` | The string to convert |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`String`|The lowercased string|
+| type     | description           |
+| -------- | --------------------- |
+| `String` | The lowercased string |
 
 Examples:
 
@@ -1151,22 +1151,22 @@ No other changes yet.
 </details>
 
 ```grain
-toAsciiUppercase : (string: String) => String
+toAsciiUppercase: (string: String) => String
 ```
 
 Converts all ASCII lowercase characters in the string to uppercase.
 
 Parameters:
 
-|param|type|description|
-|-----|----|-----------|
-|`string`|`String`|The string to convert|
+| param    | type     | description           |
+| -------- | -------- | --------------------- |
+| `string` | `String` | The string to convert |
 
 Returns:
 
-|type|description|
-|----|-----------|
-|`String`|The uppercased string|
+| type     | description           |
+| -------- | --------------------- |
+| `String` | The uppercased string |
 
 Examples:
 
@@ -1174,3 +1174,46 @@ Examples:
 assert String.toAsciiUppercase("aBc123") == "ABC123"
 ```
 
+### String.**repeat**
+
+<details disabled>
+<summary tabindex="-1">Added in <code>0.6.7</code></summary>
+No other changes yet.
+</details>
+
+```grain
+repeat: (count: Number, string: String) => String
+```
+
+Produces a new string by repeating a substring a given number of times.
+
+Parameters:
+
+| param    | type     | description                              |
+| -------- | -------- | ---------------------------------------- |
+| `count`  | `Number` | The number of times to repeat the string |
+| `string` | `String` | The string to repeat                     |
+
+Returns:
+
+| type     | description                                   |
+| -------- | --------------------------------------------- |
+| `String` | A string containing the repeated input string |
+
+Throws:
+
+`InvalidArgument(String)`
+
+* When the `count` is not an integer
+* When the `count` is negative
+
+Examples:
+
+```grain
+assert String.repeat(5, "=") == "====="
+```
+
+```grain
+assert String.repeat(0, ".") == ""
+```
+