@grain/stdlib 0.5.2 → 0.5.4

package/string.md

@@ -148,7 +148,7 @@ No other changes yet.
 indexOf : (String, String) -> Option<Number>
 ```
 
-Finds the position of a substring in the input string.
+Finds the first position of a substring in the input string.
 
 Parameters:
 
@@ -169,6 +169,70 @@ Examples:
 String.indexOf("world", "Hello world") == Some(6)
 ```
 
+### String.**lastIndexOf**
+
+<details disabled>
+<summary tabindex="-1">Added in <code>0.5.3</code></summary>
+No other changes yet.
+</details>
+
+```grain
+lastIndexOf : (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|
+
+Returns:
+
+|type|description|
+|----|-----------|
+|`Option<Number>`|`Some(position)` containing the starting position of the substring if found or `None` otherwise|
+
+Examples:
+
+```grain
+String.lastIndexOf("world", "Hello world world") == Some(12)
+```
+
+### String.**charCodeAt**
+
+<details disabled>
+<summary tabindex="-1">Added in <code>0.5.3</code></summary>
+No other changes yet.
+</details>
+
+```grain
+charCodeAt : (Number, 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|
+
+Returns:
+
+|type|description|
+|----|-----------|
+|`Number`|The character code at the provided position|
+
+Examples:
+
+```grain
+String.charCodeAt(5, "Hello world") == 32
+```
+
 ### String.**charAt**
 
 <details disabled>
@@ -450,6 +514,105 @@ Examples:
 String.endsWith("world", "Hello world") == true
 ```
 
+### String.**replaceFirst**
+
+<details disabled>
+<summary tabindex="-1">Added in <code>0.5.4</code></summary>
+No other changes yet.
+</details>
+
+```grain
+replaceFirst : (String, String, String) -> String
+```
+
+Replaces the first appearance of the search pattern in the string with the replacement value.
+
+Parameters:
+
+|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|
+
+Examples:
+
+```grain
+String.replaceFirst("🌾", "🌎", "Hello 🌾🌾") == "Hello 🌎🌾"
+```
+
+### String.**replaceLast**
+
+<details disabled>
+<summary tabindex="-1">Added in <code>0.5.4</code></summary>
+No other changes yet.
+</details>
+
+```grain
+replaceLast : (String, String, String) -> String
+```
+
+Replaces the last appearance of the search pattern in the string with the replacement value.
+
+Parameters:
+
+|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|
+
+Examples:
+
+```grain
+String.replaceLast("🌾", "🌎", "Hello 🌾🌾") == "Hello 🌾🌎"
+```
+
+### String.**replaceAll**
+
+<details disabled>
+<summary tabindex="-1">Added in <code>0.5.4</code></summary>
+No other changes yet.
+</details>
+
+```grain
+replaceAll : (String, String, String) -> String
+```
+
+Replaces every appearance of the search pattern in the string with the replacement value.
+
+Parameters:
+
+|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|
+
+Examples:
+
+```grain
+String.replaceAll("🌾", "🌎", "Hello 🌾🌾") == "Hello 🌎🌎"
+```
+
 ### String.**encodeAt**
 
 <details disabled>

package/sys/file.gr

@@ -1,5 +1,5 @@
 /**
- * @module Sys/File: Utilities for accessing the filesystem & working with files.
+ * @module File: Utilities for accessing the filesystem & working with files.
  *
  * Many of the functions in this module are not intended to be used directly, but rather for other libraries to be built on top of them.
  *
@@ -36,7 +36,7 @@ import {
 import List from "list"
 
 /**
- * @section Types: Type declarations included in the Sys/File module.
+ * @section Types: Type declarations included in the File module.
  */
 
 /**
@@ -421,7 +421,7 @@ export record DirectoryEntry {
 }
 
 /**
- * @section Values: Functions and constants included in the Sys/File module.
+ * @section Values: Functions and constants included in the File module.
  */
 
 /**
@@ -816,7 +816,7 @@ export let fdStats = (fd: FileDescriptor) => {
       let rightsInheriting = WasmI64.load(structPtr, 16n)
       (rightsInheriting &
         1N << WasmI64.extendI32U(WasmI32.fromGrain(i) >> 1n)) >
-      0N
+        0N
     }
     let rightsInheritingList = List.filteri(flagsToWasmVal, orderedRights)
 

package/sys/file.md

@@ -1,5 +1,5 @@
 ---
-title: Sys/File
+title: File
 ---
 
 Utilities for accessing the filesystem & working with files.
@@ -12,7 +12,7 @@ import File from "sys/file"
 
 ## Types
 
-Type declarations included in the Sys/File module.
+Type declarations included in the File module.
 
 ### File.**FileDescriptor**
 
@@ -173,7 +173,7 @@ An entry in a directory.
 
 ## Values
 
-Functions and constants included in the Sys/File module.
+Functions and constants included in the File module.
 
 ### File.**stdin**
 

package/sys/process.gr

@@ -1,5 +1,5 @@
 /**
- * @module Sys/Process: Utilities for accessing functionality and information about the Grain program's process.
+ * @module Process: Utilities for accessing functionality and information about the Grain program's process.
  *
  * This includes things like accessing environment variables and sending signals.
  *
@@ -25,7 +25,7 @@ import {
 } from "runtime/dataStructures"
 
 /**
- * @section Types: Type declarations included in the Sys/Process module.
+ * @section Types: Type declarations included in the Process module.
  */
 
 /**
@@ -91,7 +91,7 @@ export enum Signal {
 }
 
 /**
- * @section Values: Functions and constants included in the Sys/Process module.
+ * @section Values: Functions and constants included in the Process module.
  */
 
 /**

package/sys/process.md

@@ -1,5 +1,5 @@
 ---
-title: Sys/Process
+title: Process
 ---
 
 Utilities for accessing functionality and information about the Grain program's process.
@@ -12,7 +12,7 @@ import Process from "sys/process"
 
 ## Types
 
-Type declarations included in the Sys/Process module.
+Type declarations included in the Process module.
 
 ### Process.**Signal**
 
@@ -55,7 +55,7 @@ Signals that can be sent to the host system.
 
 ## Values
 
-Functions and constants included in the Sys/Process module.
+Functions and constants included in the Process module.
 
 ### Process.**argv**
 

package/sys/random.gr

@@ -1,5 +1,5 @@
 /**
- * @module Sys/Random: System access to random values.
+ * @module Random: System access to random values.
  *
  * @example import Random from "sys/random"
  */
@@ -11,7 +11,7 @@ import Wasi from "runtime/wasi"
 import { tagSimpleNumber, newInt32, newInt64 } from "runtime/dataStructures"
 
 /**
- * @section Values: Functions and constants included in the Sys/Random module.
+ * @section Values: Functions and constants included in the Random module.
  */
 
 /**

package/sys/random.md

@@ -1,5 +1,5 @@
 ---
-title: Sys/Random
+title: Random
 ---
 
 System access to random values.
@@ -10,7 +10,7 @@ import Random from "sys/random"
 
 ## Values
 
-Functions and constants included in the Sys/Random module.
+Functions and constants included in the Random module.
 
 ### Random.**randomInt32**
 

package/sys/time.gr

@@ -1,5 +1,5 @@
 /**
- * @module Sys/Time: Access to system clocks.
+ * @module Time: Access to system clocks.
  *
  * @example import Time from "sys/time"
  */
@@ -15,7 +15,7 @@ import Errors from "runtime/unsafe/errors"
 import { allocateInt64, tagSimpleNumber } from "runtime/dataStructures"
 
 /**
- * @section Values: Functions and constants included in the Sys/Time module.
+ * @section Values: Functions and constants included in the Time module.
  */
 
 @unsafe

package/sys/time.md

@@ -1,5 +1,5 @@
 ---
-title: Sys/Time
+title: Time
 ---
 
 Access to system clocks.
@@ -10,7 +10,7 @@ import Time from "sys/time"
 
 ## Values
 
-Functions and constants included in the Sys/Time module.
+Functions and constants included in the Time module.
 
 ### Time.**realTime**