refactor(areString()): update to use every(), forEach() and `some…

…()` methods of the returned object to handle a given values of any type.

Add
- `every()`: Checks if every of the provided `values` of `areString()` is a `string` type or an instance of `String`.
- `forEach()`: The `forEach()` method executes a provided callback function once for each element of the supplied `values` of `areString()`.
- `some()`: Checks if some of the provided `values` of `areString()` are a `string` type or an instance of `String`.

src/are/lib/are-string.func.ts

@@ -1,7 +1,79 @@
-import { check } from './check-args.func';
+// Function.
+import { isArray } from '../../is/lib/is-array.func';
+import { isFunction } from '../../is/lib/is-function.func';
+import { isString } from '../../is/lib/is-string.func';
+import { resultCallback } from '../../lib/result-callback.func';
+// Type.
+import { CallbackPayload } from '../../type/callback-payload.type';
+import { ForEachCallback } from '../../type/foreach-callback.type';
+import { ResultCallback } from '../../type/result-callback.type';
 /**
- * Checks if all the values are a `string`.
- * @param value A rest parameter of any type to check.
- * @returns A `boolean` indicating whether or not all the values are `string`.
+ * Checks if the values are a `string` type or an instance of `String` by using `every()`, `forEach()` and `some()` methods of the
+ * returned object.
+ * @param value A rest parameter of `any` type to check its elements against a `string` type or an instance of `String`.
+ * @returns The return value is an `object` with `every()`, `some()` and `forEach()` as a methods of checking supplied values.
+ * @angularpackage
  */
-export const areString = (...value: any): boolean => check('string', ...value);
+export const areString = (...values: any[]) => {
+  return {
+    /**
+     * Checks if every of the provided `values` of `areString()` is a `string` type or an instance of `String`.
+     * @param callback A callback `function` of `ResultCallback` type with parameters, the `value` that has been checked, the `result` of
+     * this check, and `payload` of the default `CallbackPayload` shape with optional properties from the provided `payload`, to handle
+     * them before the `result` return. By default, it uses `resultCallback()` function.
+     * @param payload An optional `object` of `CallbackPayload` that is assigned to the `payload` of the supplied `callback` function.
+     * @returns The return value is a `boolean` indicating whether the provided values of `areString()` are a `string` type or an instance
+     * of `String`.
+     */
+    every: <Payload extends object>(
+      callback: ResultCallback<any, CallbackPayload<Payload>> = resultCallback,
+      payload?: CallbackPayload<Payload>
+    ): boolean =>
+      callback(
+        values.every((value) => isString(value)),
+        values,
+        { name: areString.name, ...payload } as Payload
+      ),
+
+    /**
+     * The `forEach()` method executes a provided callback function once for each element of the supplied `values` of `areString()`.
+     * @param forEachCallback A callback `function` of `ForEachCallback` type with parameters, the `value` that has been checked, the
+     * `result` of this check, `index` of each element, the provided `values` and `payload` of the default `CallbackPayload` shape with
+     * optional properties from the provided `payload`, to handle them before the `result` return.
+     * @param payload An optional `object` of `CallbackPayload` that is assigned to the `payload` of the supplied `callback` function.
+     * @returns The return value is void.
+     */
+    forEach: <Payload extends object>(
+      forEachCallback: ForEachCallback<any, CallbackPayload<Payload>>,
+      payload?: CallbackPayload<Payload>
+    ) => {
+      if (isArray(values) && isFunction(forEachCallback)) {
+        values.forEach((value, index) =>
+          forEachCallback(isString(value), value, index, values, {
+            name: areString.name,
+            ...payload,
+          } as CallbackPayload<Payload>)
+        );
+      }
+    },
+
+    /**
+     * Checks if some of the provided `values` of `areString()` are a `string` type or an instance of `String`.
+     * @param callback A callback `function` of `ResultCallback` type with parameters, the `value` that has been checked, the `result` of
+     * this check, and `payload` of the default `CallbackPayload` shape with optional properties from the provided `payload`, to handle
+     * them before the `result` return. By default, it uses `resultCallback()` function.
+     * @param payload An optional `object` of `CallbackPayload` that is assigned to the `payload` of the supplied `callback` function.
+     * @returns The return value is a `boolean` indicating whether some of the provided values of `areString()` are a `string` type or an
+     * instance of `String`.
+     */
+    some: <Payload extends object>(
+      callback: ResultCallback<any, CallbackPayload<Payload>> = resultCallback,
+      payload?: CallbackPayload<Payload>
+    ): boolean =>
+      callback(
+        isArray(values) ? values.some((value) => isString(value)) : false,
+        values,
+        { name: areString.name, ...payload } as Payload
+      ),
+  };
+};