Add array docs

Author: Folyd

docs/guide/language/enum-match.md renamed to docs/guide/language/enum-match.mdx

@@ -1,3 +1,5 @@
+import { Badge } from "rspress/theme";
+
 # Enum and Match
 
 Enums (short for enumerations) and match expressions are powerful features in AIScript that work together to provide type-safe pattern matching. These features are inspired by Rust's enum and match system, offering an elegant way to handle variants and control flow.
@@ -187,7 +189,7 @@ match value {
 // Double digits: 42
 ```
 
-### Match with Variable Binding
+### Match with Variable Binding <Badge text="Not supported yet" type="warning" />
 
 You can bind values to variables in match patterns:
 

docs/std/builtin/_meta.json

@@ -4,6 +4,11 @@
         "name": "functions",
         "label": "Functions"
     },
+    {
+        "type": "file",
+        "name": "array",
+        "label": "Array"
+    },
     {
         "type": "file",
         "name": "string",

docs/std/builtin/array.md

@@ -0,0 +1,170 @@
+# Array
+
+The `Array` type provides various methods for array manipulation, searching, and ordering.
+
+## append(item)
+
+Adds an item to the end of the array and returns the modified array.
+
+**Parameters**:
+- `item`: The item to add to the end of the array.
+
+**Return Type**: `Array`
+
+**Example**:
+```js
+let numbers = [1, 2, 3];
+numbers.append(4); // [1, 2, 3, 4]
+```
+
+## extend(array)
+
+Extends the array by appending all items from another array and returns the modified array.
+
+**Parameters**:
+- `array`: The array containing items to append.
+
+**Return Type**: `Array`
+
+**Example**:
+```js
+let numbers = [1, 2, 3];
+numbers.extend([4, 5]); // [1, 2, 3, 4, 5]
+```
+
+## insert(index, item)
+
+Inserts an item at the specified position in the array and returns the modified array.
+
+**Parameters**:
+- `index`: The index before which to insert the item.
+- `item`: The item to insert.
+
+**Return Type**: `Array`
+
+**Example**:
+```js
+let numbers = [1, 2, 4];
+numbers.insert(2, 3); // [1, 2, 3, 4]
+```
+
+## remove(item)
+
+Removes the first occurrence of the specified item from the array and returns the modified array.
+
+**Parameters**:
+- `item`: The item to remove.
+
+**Return Type**: `Array`
+
+**Example**:
+```js
+let numbers = [1, 2, 3, 2];
+numbers.remove(2); // [1, 3, 2]
+```
+
+## pop(index?)
+
+Removes and returns the item at the specified position. If no index is provided, removes and returns the last item.
+
+**Parameters**:
+- `index`: The index of the item to remove (optional).
+
+**Return Type**: The removed item.
+
+**Example**:
+```js
+let numbers = [1, 2, 3];
+let last = numbers.pop(); // 3, numbers becomes [1, 2]
+let first = numbers.pop(0); // 1, numbers becomes [2]
+```
+
+## clear()
+
+Removes all items from the array and returns the modified (empty) array.
+
+**Return Type**: `Array`
+
+**Example**:
+```js
+let numbers = [1, 2, 3];
+numbers.clear(); // []
+```
+
+## index(item, start?, end?)
+
+Returns the index of the first occurrence of the specified item within the optional start and end range.
+
+**Parameters**:
+- `item`: The item to search for.
+- `start`: The index to start the search from (optional).
+- `end`: The index to end the search at (optional).
+
+**Return Type**: `Number` (Returns -1 if the item is not found)
+
+**Example**:
+```js
+let numbers = [10, 20, 30, 20];
+numbers.index(20); // 1
+numbers.index(20, 2); // 3
+```
+
+## count(item)
+
+Returns the number of occurrences of the specified item in the array.
+
+**Parameters**:
+- `item`: The item to count.
+
+**Return Type**: `Number`
+
+**Example**:
+```js
+let numbers = [1, 2, 3, 2, 1];
+numbers.count(2); // 2
+```
+
+## sort(reverse?)
+
+Sorts the items of the array in place and returns the modified array.
+
+**Parameters**:
+- `reverse`: Whether to sort in descending order (optional, default: false).
+
+**Return Type**: `Array`
+
+**Example**:
+```js
+let numbers = [3, 1, 4, 2];
+numbers.sort(); // [1, 2, 3, 4]
+numbers.sort(true); // [4, 3, 2, 1]
+```
+
+## reverse()
+
+Reverses the elements of the array in place and returns the modified array.
+
+**Return Type**: `Array`
+
+**Example**:
+```js
+let numbers = [1, 2, 3];
+numbers.reverse(); // [3, 2, 1]
+```
+
+## slice(start, end?)
+
+Returns a shallow copy of a portion of the array into a new array, without modifying the original array.
+
+**Parameters**:
+- `start`: The beginning index (can be negative to index from the end).
+- `end`: The end index (optional, can be negative to index from the end).
+
+**Return Type**: `Array`
+
+**Example**:
+```js
+let numbers = [1, 2, 3, 4, 5];
+numbers.slice(1, 4); // [2, 3, 4]
+numbers.slice(-2); // [4, 5]
+```

theme/components/Landingpage/features.yaml

@@ -137,7 +137,7 @@ web:
                   name: str
               }
 
-              return "repo: " + name;
+              return f"repo: {query.name}";
           }
         filename: get.ai
       - code: |
@@ -152,7 +152,7 @@ web:
                   name: str
               }
 
-              return "create repo: " + name;
+              return f"create repo: {body.name}";
           }
         filename: post.ai
       - code: |
@@ -166,14 +166,14 @@ web:
                   name: str
               }
 
-              return "update repo: " + name;
+              return f"update repo: {body.name}";
           }
         filename: put.ai
       - code: |
           delete /repo/<id:int> {
               """Delete a repository"""
 
-              return "delete repo: " + id;
+              return f"delete repo: {id}";
           }
         filename: delete.ai
   - title: Validator
@@ -237,7 +237,7 @@ web:
                   message: str,
               }
 
-              return f"Input:  {body.message}!";
+              return f"Input: {body.message}!";
           }
         filename: openapi.ai
       - img: /toucan.png
@@ -716,13 +716,23 @@ std-library:
           print(text.split(" ")); // ["hello", "world"]
 
           // Array operations
-          let numbers = [1, 2, 3, 4, 5];
-          print(numbers.sum()); // 15
-          print(numbers.average()); // 3
-          print(numbers.map(fn(x) => x * 2)); // [2, 4, 6, 8, 10]
-
-          // Date and time
-          let now = datetime.now();
-          print(now.format("YYYY-MM-DD")); // 2024-03-21
-          print(now.add_days(7)); // 2024-03-28
+          // Initialize a test array
+          let numbers = [10, 5, 8, 3, 1];
+          print(numbers);  // expect: [10, 5, 8, 3, 1]
+
+          // append - Add an item to the end
+          numbers.append(20);
+          print(numbers);  // expect: [10, 5, 8, 3, 1, 20]
+
+          // extend - Extend with another array
+          numbers.extend([30, 40]);
+          print(numbers);  // expect: [10, 5, 8, 3, 1, 20, 30, 40]
+
+          // insert - Insert an item at position
+          numbers.insert(2, 15);
+          print(numbers);  // expect: [10, 5, 15, 8, 3, 1, 20, 30, 40]
+
+          // sort - Sort the array
+          let sorted = numbers.sort();
+          print(sorted);  // expect: [1, 3, 3, 5, 8, 10, 15, 20, 30, 40]
         filename: builtin.ai