Update StaticArray & normalize other array's declarations (#104)

Author: MaxGraey

src/stdlib/array.md

@@ -53,7 +53,7 @@ arr[0]; // now it works 😊
   Copies a region of an array's values over the respective values starting at the target location.
 
 * ```ts
-  function every(fn: (value: T, index: i32, array: Array<T>) => bool): bool
+  function every(fn: (value: T, index: i32, self: Array<T>) => bool): bool
   ```
   Calls the specified function with every value of the array until it finds the first value for which the function returns `false`. Returns `true` if all functions returned `true` or the array is empty, otherwise `false`.
 
@@ -63,17 +63,17 @@ arr[0]; // now it works 😊
   Replaces the values of the array from `start` inclusive to `end` exclusive in place with the specified value, returning the array.
 
 * ```ts
-  function filter(fn: (value: T, index: i32, array: Array<T>) => bool): Array<T>
+  function filter(fn: (value: T, index: i32, self: Array<T>) => bool): Array<T>
   ```
   Calls the specified function with every value of the array, returning a new array with all values for which the function returned `true`.
 
 * ```ts
-  function findIndex(fn: (value: T, index: i32, array: Array<T>) => bool): i32
+  function findIndex(fn: (value: T, index: i32, self: Array<T>) => bool): i32
   ```
   Calls the specified function with every value of the array until it finds the first value for which the function returns `true`, returning its index. Returns `-1` if that's never the case.
 
 * ```ts
-  function findLastIndex(fn: (value: T, index: i32, self: this) => bool): i32;
+  function findLastIndex(fn: (value: T, index: i32, self: Array<T>) => bool): i32;
   ```
   Calls the specified function with every value of the array starting at the end until it finds the first value for which the function returns `true`, returning its index. Returns `-1` if that's never the case.
 
@@ -83,7 +83,7 @@ arr[0]; // now it works 😊
   Flattens an array of arrays to a one-dimensional array. `null` entries are ignored.
 
 * ```ts
-  function forEach(fn: (value: T, index: i32, array: Array<T>) => void): void
+  function forEach(fn: (value: T, index: i32, self: Array<T>) => void): void
   ```
   Calls the specified function with every value of the array.
 
@@ -108,7 +108,7 @@ arr[0]; // now it works 😊
   Gets the last index where the specified value can be found in the array. Returns `-1` if not found.
 
 * ```ts
-  function map<U>(fn: (value: T, index: i32, array: Array<T>) => U): Array<U>
+  function map<U>(fn: (value: T, index: i32, self: Array<T>) => U): Array<U>
   ```
   Calls the specified function with every value of the array, returning a new array of the function's return values.
 
@@ -124,15 +124,15 @@ arr[0]; // now it works 😊
 
 * ```ts
   function reduce<U>(
-    fn: (acc: U, cur: T, idx: i32, src: Array) => U,
+    fn: (accumValue: U, currentValue: T, index: i32, self: Array<T>) => U,
     initialValue: U
   ): U
   ```
-  Calls the specified reducer function with each value of the array, resulting in a single return value. The respective previous reducer function's return value is remembered in `acc`, starting with `initialValue`, becoming the final return value in the process.
+  Calls the specified reducer function with each value of the array, resulting in a single return value. The respective previous reducer function's return value is remembered in `accumValue`, starting with `initialValue`, becoming the final return value in the process.
 
 * ```ts
   function reduceRight<U>(
-    fn: (acc: U, cur: T, idx: i32, src: Array) => U,
+    fn: (accumValue: U, currentValue: T, index: i32, self: Array<T>) => U,
     initialValue: U
   ): U
   ```
@@ -154,7 +154,7 @@ arr[0]; // now it works 😊
   Returns a shallow copy of the array's values from `begin` inclusive to `end` exclusive, as a new array. If omitted, `end` defaults to the end of the array.
 
 * ```ts
-  function some(fn: (value: T, index: i32, array: Array<T>) => bool): bool
+  function some(fn: (value: T, index: i32, self: Array<T>) => bool): bool
   ```
   Calls the specified function with every value of the array until it finds the first value for which the function returns `true`, returning `true`. Returns `false` otherwise or if the array is empty.
 

src/stdlib/staticarray.md

@@ -18,7 +18,7 @@ The StaticArray API is similar to the [Array API](./array.md), with the importan
 ## Static members
 
 * ```ts
-  function fromArray<T>(source: T[]): StaticArray<T>
+  function fromArray<T>(source: Array<T>): StaticArray<T>
   ```
   Creates a static array from a normal array.
 
@@ -49,10 +49,45 @@ The StaticArray API is similar to the [Array API](./array.md), with the importan
   Gets the element at the specified position. This method allows for positive and negative integers. Negative integers count back from the last element.
 
 * ```ts
-  function concat(other: T[]): T[]
+  function concat(other: Array<T>): Array<T>
   ```
   Concatenates the values of this static and the other normal array to a new normal array, in this order.
 
+* ```ts
+  function copyWithin(target: i32, start: i32, end?: i32): this
+  ```
+  Copies a region of an array's values over the respective values starting at the target location.
+
+* ```ts
+  function every(fn: (value: T, index: i32, self: StaticArray<T>) => bool): bool
+  ```
+  Calls the specified function with every value of the array until it finds the first value for which the function returns `false`. Returns `true` if all functions returned `true` or the array is empty, otherwise `false`.
+
+* ```ts
+  function fill(value: T, start?: i32, end?: i32): this
+  ```
+  Replaces the values of the array from `start` inclusive to `end` exclusive in place with the specified value, returning the array.
+
+* ```ts
+  function filter(fn: (value: T, index: i32, self: StaticArray<T>) => bool): Array<T>
+  ```
+  Calls the specified function with every value of the array, returning a new array with all values for which the function returned `true`.
+
+* ```ts
+  function findIndex(fn: (value: T, index: i32, self: StaticArray<T>) => bool): i32
+  ```
+  Calls the specified function with every value of the array until it finds the first value for which the function returns `true`, returning its index. Returns `-1` if that's never the case.
+
+* ```ts
+  function findLastIndex(fn: (value: T, index: i32, self: StaticArray<T>) => bool): i32;
+  ```
+  Calls the specified function with every value of the array starting at the end until it finds the first value for which the function returns `true`, returning its index. Returns `-1` if that's never the case.
+
+* ```ts
+  function forEach(fn: (value: T, index: i32, self: StaticArray<T>) => void): void
+  ```
+  Calls the specified function with every value of the array.
+
 * ```ts
   function includes(value: T, fromIndex?: i32): bool
   ```
@@ -74,15 +109,46 @@ The StaticArray API is similar to the [Array API](./array.md), with the importan
   Gets the last index where the specified value can be found in the array. Returns `-1` if not found.
 
 * ```ts
-  function slice(start?: i32, end?: i32): T[]
+  function map<U>(fn: (value: T, index: i32, self: StaticArray<T>) => U): Array<U>
+  ```
+  Calls the specified function with every value of the array, returning a new array of the function's return values.
+
+* ```ts
+  function slice(start?: i32, end?: i32): Array<T>
   ```
   Returns a shallow copy of this static array's values from `begin` inclusive to `end` exclusive, as a new normal array. If omitted, `end` defaults to the end of the array.
 
+* ```ts
+  function some(fn: (value: T, index: i32, self: StaticArray<T>) => bool): bool
+  ```
+  Calls the specified function with every value of the array until it finds the first value for which the function returns `true`, returning `true`. Returns `false` otherwise or if the array is empty.
+
 * ```ts
   function sort(fn?: (a: T, b: T) => i32): this
   ```
   Sorts the values of the array in place, using the specified comparator function, modifying the array before returning it. The comparator returning a negative value means `a < b`, a positive value means `a > b` and `0` means that both are equal. Unlike in JavaScript, where an implicit conversion to strings is performed, the comparator defaults to compare two values of type `T`.
 
+* ```ts
+  function reduce<U>(
+    fn: (accumValue: U, currentValue: T, index: i32, self: StaticArray<T>) => U,
+    initialValue: U
+  ): U
+  ```
+  Calls the specified reducer function with each value of the array, resulting in a single return value. The respective previous reducer function's return value is remembered in `accumValue`, starting with `initialValue`, becoming the final return value in the process.
+
+* ```ts
+  function reduceRight<U>(
+    fn: (accumValue: U, currentValue: T, index: i32, self: StaticArray<T>) => U,
+    initialValue: U
+  ): U
+  ```
+  Calls the specified reducer function with each value of the array, from right to left, resulting in a single return value. See `Array#reduce` for the reducer function's signature.
+
+* ```ts
+  function reverse(): this
+  ```
+  Reverses an array's values in place, modifying the array before returning it.
+
 * ```ts
   function toString(): string
   ```

src/stdlib/typedarray.md

@@ -27,7 +27,7 @@ The TypedArray API works very much like JavaScript's \([MDN](https://developer.m
 ## Constructor
 
 * ```ts
-  new TypedArray<T>(length: i32)
+  new TypedArray(length: i32)
   ```
   Constructs a new typed array view with a new backing buffer and all values initialized to zero. See `wrap` below for wrapping a raw buffer.
 
@@ -39,7 +39,7 @@ The TypedArray API works very much like JavaScript's \([MDN](https://developer.m
   Number of bytes per element.
 
 * ```ts
-  function wrap(buffer: ArrayBuffer, byteOffset?: i32, length?: i32): TypedArray<T>
+  function wrap(buffer: ArrayBuffer, byteOffset?: i32, length?: i32): TypedArray
   ```
   Wraps a raw buffer to be viewed as a sequence of values of the typed array's value type. This is equivalent to the respective alternative constructor signature in JS but exists because there is no function overloading \(yet\).
 
@@ -70,9 +70,7 @@ The TypedArray API works very much like JavaScript's \([MDN](https://developer.m
 ### Methods
 
 * ```ts
-  function every(
-    fn: (value: T, index: i32, self: TypedArray) => bool
-  ): bool
+  function every(fn: (value: T, index: i32, self: TypedArray) => bool): bool
   ```
   Calls the specified function with every value of the array until it finds the first value for which the function returns `false`. Returns `true` if all functions returned `true` or the array is empty, otherwise `false`.
 
@@ -82,23 +80,17 @@ The TypedArray API works very much like JavaScript's \([MDN](https://developer.m
   Replaces the values of the array from `start` inclusive to `end` exclusive in place with the specified value, returning the array.
 
 * ```ts
-  function findIndex(
-    fn: (value: T, index: i32, self: TypedArray) => bool
-  ): i32
+  function findIndex(fn: (value: T, index: i32, self: TypedArray) => bool): i32
   ```
   Calls the specified function with every value of the array until it finds the first value for which the function returns `true`, returning its index. Returns `-1` if that's never the case.
 
 * ```ts
-  function findLastIndex(
-    fn: (value: T, index: i32, self: TypedArray) => bool
-  ): i32;
+  function findLastIndex(fn: (value: T, index: i32, self: TypedArray) => bool): i32
   ```
   Calls the specified function with every value of the array starting at the end until it finds the first value for which the function returns `true`, returning its index. Returns `-1` if that's never the case.
 
 * ```ts
-  function forEach(
-    fn: (value: T, index: i32, self: TypedArray) => void
-  ): void
+  function forEach(fn: (value: T, index: i32, self: TypedArray) => void): void
   ```
   Calls the specified function with every value of the array.
 
@@ -118,23 +110,21 @@ The TypedArray API works very much like JavaScript's \([MDN](https://developer.m
   Gets the last index where the specified value can be found in the array. Returns `-1` if not found.
 
 * ```ts
-  function map(
-    fn: (value: T, index: i32, self: TypedArray) => T
-  ): TypedArray
+  function map(fn: (value: T, index: i32, self: TypedArray) => T): TypedArray
   ```
   Calls the specified function with every value of the array, returning a new array of the function's return values.
 
 * ```ts
   function reduce<U>(
-    fn: (acc: U, cur: T, idx: i32, src: Array) => U,
+    fn: (accumValue: U, currentValue T, index: i32, self: TypedArray) => U,
     initialValue: U
   ): U
   ```
-  Calls the specified reducer function with each value of the array, resulting in a single return value. The respective previous reducer function's return value is remembered in `acc`, starting with `initialValue`, becoming the final return value in the process.
+  Calls the specified reducer function with each value of the array, resulting in a single return value. The respective previous reducer function's return value is remembered in `accumValue`, starting with `initialValue`, becoming the final return value in the process.
 
 * ```ts
   function reduceRight<U>(
-    fn: (acc: U, cur: T, idx: i32, src: Array) => U,
+    fn: (accumValue: U, currentValue: T, index: i32, self: TypedArray) => U,
     initialValue: U
   ): U
   ```
@@ -151,9 +141,7 @@ The TypedArray API works very much like JavaScript's \([MDN](https://developer.m
   Sets the typed array values (starting at `offset`, or 0), reading input values from a specified `source` typed array.
 
 * ```ts
-  function some(
-    fn: (value: T, index: i32, self: TypedArray) => bool
-  ): bool
+  function some(fn: (value: T, index: i32, self: TypedArray) => bool): bool
   ```
   Calls the specified function with every value of the array until it finds the first value for which the function returns `true`, returning `true`. Returns `false` otherwise or if the array is empty.