refactor: use overloads to preserve type information

Signed-off-by: Athan <[email protected]>

Author: kgryte

lib/node_modules/@stdlib/array/base/for-each/docs/types/index.d.ts

@@ -60,6 +60,25 @@ type Ternary<T, U, V> = ( this: V, value: T, indices: Array<number>, arr: U ) =>
 */
 type Callback<T, U, V> = Nullary<V> | Unary<T, V> | Binary<T, V> | Ternary<T, U, V>;
 
+/**
+* Invokes a callback function once for each array element.
+*
+* @param x - input array
+* @param fcn - callback function
+* @param thisArg - callback function execution context
+*
+* @example
+* var naryFunction = require( '@stdlib/utils/nary-function' );
+* var toAccessorArray = require( '@stdlib/array/base/to-accessor' );
+* var log = require( '@stdlib/console/log' );
+*
+* var x = toAccesorArray( [ 1, 2, 3, 4] );
+*
+* // Apply the callback function:
+* forEach( x, naryFunction( log, 1 ) );
+*/
+declare function forEach<T = unknown, V = unknown>( x: AccessorArrayLike<T>, fcn: Callback<T, AccessorArrayLike<T>, V>, thisArg?: ThisParameterType<Callback<T, AccessorArrayLike<T>, V>> ): void;
+
 /**
 * Invokes a callback function once for each array element.
 *
@@ -76,7 +95,7 @@ type Callback<T, U, V> = Nullary<V> | Unary<T, V> | Binary<T, V> | Ternary<T, U,
 * // Apply the callback function:
 * forEach( x, naryFunction( log, 1 ) );
 */
-declare function forEach<T = unknown, U = unknown, V = unknown>( x: Collection<T> | AccessorArrayLike<U>, fcn: Callback<number, Collection<T>, V>, thisArg?: ThisParameterType<Callback<number, Collection<T>, V>> ): void;
+declare function forEach<T = unknown, V = unknown>( x: Collection<T>, fcn: Callback<T, Collection<T>, V>, thisArg?: ThisParameterType<Callback<T, Collection<T>, V>> ): void;
 
 
 // EXPORTS //