functions

composer.json

@@ -24,7 +24,13 @@
     "psr-4": {
       "Maxonfjvipon\\ElegantElephant\\": "src",
       "Maxonfjvipon\\ElegantElephant\\Support\\": "support"
-    }
+    },
+    "files": [
+      "src/Any/functions.php",
+      "src/Arr/functions.php",
+      "src/Logic/functions.php",
+      "src/Txt/functions.php"
+    ]
   },
   "autoload-dev": {
     "psr-4": {

phpunit.xml

@@ -31,6 +31,7 @@
     </testsuites>
     <logging>
         <log type="coverage-clover" target="build/logs/clover.xml"/>
+        <log type="coverage-html" target="build/logs/html"/>
     </logging>
     <filter>
         <whitelist processUncoveredFilesFromWhitelist="true">

src/Any/AnyFork.php

@@ -30,6 +30,8 @@
 use Maxonfjvipon\ElegantElephant\Logic;
 use Maxonfjvipon\ElegantElephant\Logic\EnsureLogic;
 
+use function Maxonfjvipon\ElegantElephant\Any\any_fork;
+
 /**
  * Conditional Any.
  */
@@ -53,8 +55,6 @@ final public function __construct(
 
     public function value(): mixed
     {
-        return $this->ensuredBool($this->condition)
-            ? $this->ensuredAnyValue($this->first)
-            : $this->ensuredAnyValue($this->second);
+        return any_fork($this->condition, $this->first, $this->second);
     }
 }

src/Any/AtKey.php

@@ -32,6 +32,8 @@
 use Maxonfjvipon\ElegantElephant\Num;
 use Maxonfjvipon\ElegantElephant\Txt;
 
+use function Maxonfjvipon\ElegantElephant\Any\at_key;
+
 /**
  * At key.
  */
@@ -54,6 +56,6 @@ final public function __construct(
 
     public function value(): mixed
     {
-        return $this->ensuredArray($this->arr)[$this->ensuredAnyValue($this->key)];
+        return at_key($this->key, $this->arr);
     }
 }

src/Any/AtValue.php

@@ -26,13 +26,14 @@
 
 namespace Maxonfjvipon\ElegantElephant\Any;
 
-use Exception;
 use Maxonfjvipon\ElegantElephant\Any;
 use Maxonfjvipon\ElegantElephant\Arr;
 use Maxonfjvipon\ElegantElephant\Arr\EnsureArr;
 use Maxonfjvipon\ElegantElephant\Num;
 use Maxonfjvipon\ElegantElephant\Txt;
 
+use function Maxonfjvipon\ElegantElephant\Any\at_value;
+
 /**
  * Key from array by element.
  */
@@ -54,16 +55,6 @@ final public function __construct(
 
     final public function value(): string|int
     {
-        $key = array_search(
-            needle: $this->ensuredAnyValue($this->value),
-            haystack: $this->ensuredArray($this->arr),
-            strict: true
-        );
-
-        if ($key === false) {
-            throw new Exception("Key by given value not found!");
-        }
-
-        return $key;
+        return at_value($this->value, $this->arr);
     }
 }

src/Any/EnsureAny.php

@@ -27,11 +27,8 @@
 namespace Maxonfjvipon\ElegantElephant\Any;
 
 use Exception;
-use Maxonfjvipon\ElegantElephant\Any;
-use Maxonfjvipon\ElegantElephant\Arr;
-use Maxonfjvipon\ElegantElephant\Logic;
-use Maxonfjvipon\ElegantElephant\Num;
-use Maxonfjvipon\ElegantElephant\Txt;
+
+use function Maxonfjvipon\ElegantElephant\Any\ensured_any;
 
 /**
  * Ensured Any.
@@ -45,30 +42,6 @@ trait EnsureAny
      */
     private function ensuredAnyValue(mixed $any): mixed
     {
-        $getAny = function (mixed $any): Any {
-            if ($any instanceof Any) {
-                return $any;
-            }
-
-            if ($any instanceof Arr) {
-                return AnyOf::arr($any);
-            }
-
-            if ($any instanceof Txt) {
-                return AnyOf::text($any);
-            }
-
-            if ($any instanceof Num) {
-                return AnyOf::num($any);
-            }
-
-            if ($any instanceof Logic) {
-                return AnyOf::logic($any);
-            }
-
-            return AnyOf::just($any);
-        };
-
-        return $getAny($any)->value();
+        return ensured_any($any);
     }
 }

src/Any/FirstOf.php

@@ -26,11 +26,12 @@
 
 namespace Maxonfjvipon\ElegantElephant\Any;
 
-use Exception;
 use Maxonfjvipon\ElegantElephant\Any;
 use Maxonfjvipon\ElegantElephant\Arr;
 use Maxonfjvipon\ElegantElephant\Txt;
 
+use function Maxonfjvipon\ElegantElephant\Any\first_of;
+
 /**
  * First item.
  */
@@ -68,16 +69,6 @@ final public function __construct(private string|Any|Arr|array|Txt $container)
 
     public function value(): mixed
     {
-        $value = $this->ensuredAnyValue($this->container);
-
-        if (!is_string($value) && !is_array($value)) {
-            throw new Exception("The element to get the first element from must be an array or string");
-        }
-
-        if (empty($value)) {
-            throw new Exception("Can't get the first element of an empty value");
-        }
-
-        return $value[0];
+        return first_of($this->container);
     }
 }

src/Any/LastOf.php

@@ -26,12 +26,12 @@
 
 namespace Maxonfjvipon\ElegantElephant\Any;
 
-use Couchbase\IndexFailureException;
-use Exception;
 use Maxonfjvipon\ElegantElephant\Any;
 use Maxonfjvipon\ElegantElephant\Arr;
 use Maxonfjvipon\ElegantElephant\Txt;
 
+use function Maxonfjvipon\ElegantElephant\Any\last_of;
+
 /**
  * Last of.
  */
@@ -67,24 +67,6 @@ final public function __construct(private string|array|Txt|Arr|Any $container)
 
     public function value(): mixed
     {
-        $value = $this->ensuredAnyValue($this->container);
-
-        if (is_string($value)) {
-            if (empty($value)) {
-                throw new Exception(message: "Can't get the last element of an empty string");
-            }
-
-            $res = substr($value, -1);
-        } elseif (is_array($value)) {
-            if (empty($value)) {
-                throw new Exception(message: "Can't get the last element of an empty array");
-            }
-
-            $res = $value[count($value) - 1];
-        } else {
-            throw new Exception(message: "The element to get the last element from must be an array or string");
-        }
-
-        return $res;
+        return last_of($this->container);
     }
 }

src/Arr/ArrCombined.php

@@ -38,8 +38,6 @@
  */
 final class ArrCombined implements IterableArr
 {
-    use EnsureArr;
-    use EnsureAny;
     use HasArrIterator;
 
     /**
@@ -57,35 +55,6 @@ final public function __construct(
 
     final public function asArray(): array
     {
-        /**
-         * @var callable $callback
-         * @param string|int|float|Txt|Num|Any $item
-         * @return mixed
-         * @throws Exception
-         */
-        $callback = fn (string|int|float|Txt|Num|Any $item) => $this->ensuredAnyValue($item);
-
-        /** @var array<string|int> $keys */
-        $keys = array_map(
-            $callback,
-            $this->ensuredArray($this->keys)
-        );
-
-        /** @var array<mixed> $values */
-        $values = $this->ensuredArray($this->values);
-
-        if ($this->ensure) {
-            /** @var array<mixed> $values */
-            $values = array_map(
-                fn (mixed $item) => $this->ensuredAnyValue($item),
-                $this->ensuredArray($this->values)
-            );
-        }
-
-        if (count($keys) !== count($values)) {
-            throw new Exception("Keys and values arrays must have the same length");
-        }
-
-        return array_combine($keys, $values);
+        return array_combined($this->keys, $this->values, $this->ensure);
     }
 }

src/Arr/ArrCond.php

@@ -38,6 +38,7 @@ final class ArrCond extends ArrWrap
     /**
      * Ctor.
      *
+     * @param bool|Logic $condition
      * @param Arr|array<mixed> $first
      * @param array<mixed>|Arr $second
      */

src/Arr/ArrExploded.php

@@ -29,12 +29,13 @@
 use Maxonfjvipon\ElegantElephant\Txt;
 use Maxonfjvipon\ElegantElephant\Txt\EnsureTxt;
 
+use function Maxonfjvipon\ElegantElephant\Arr\array_exploded;
+
 /**
  * Array exploded.
  */
 final class ArrExploded implements IterableArr
 {
-    use EnsureTxt;
     use HasArrIterator;
 
     /**
@@ -49,16 +50,14 @@ final public static function byComma(string|Txt $text): ArrExploded
      * Ctor.
      *
      * @param non-empty-string|Txt $separator
+     * @param string|Txt $text
      */
     final public function __construct(private string|Txt $separator, private string|Txt $text)
     {
     }
 
     final public function asArray(): array
     {
-        /** @var non-empty-string $separator */
-        $separator = $this->ensuredString($this->separator);
-
-        return explode($separator, $this->ensuredString($this->text));
+        return array_exploded($this->separator, $this->text);
     }
 }

src/Arr/ArrFiltered.php

@@ -33,7 +33,6 @@
  */
 final class ArrFiltered implements IterableArr
 {
-    use EnsureArr;
     use HasArrIterator;
 
     /**
@@ -53,10 +52,6 @@ final public function __construct(private array|Arr $arr, callable $callback)
 
     final public function asArray(): array
     {
-        return array_filter(
-            $this->ensuredArray($this->arr),
-            $this->callback,
-            ARRAY_FILTER_USE_BOTH
-        );
+        return array_filtered($this->arr, $this->callback);
     }
 }

src/Arr/ArrFlatten.php

@@ -34,7 +34,6 @@
  */
 final class ArrFlatten implements IterableArr
 {
-    use EnsureArr;
     use HasArrIterator;
 
     /**
@@ -48,25 +47,6 @@ final public function __construct(private array|Arr $arr, private int $deep = 1)
 
     final public function asArray(): array
     {
-        return $this->flat($this->ensuredArray($this->arr), []);
-    }
-
-    /**
-     * @param  array<mixed> $arr
-     * @param  array<mixed> $new
-     * @return array<mixed>
-     * @throws Exception
-     */
-    private function flat(array $arr, array $new, int $currentDeep = 0): array
-    {
-        foreach ($arr as $item) {
-            if ($this->deep !== $currentDeep && (is_array($item) || $item instanceof Arr)) {
-                $new = $this->flat($this->ensuredArray($item), $new, $currentDeep + 1);
-            } else {
-                $new[] = $item;
-            }
-        }
-
-        return $new;
+        return array_flatten($this->arr, $this->deep);
     }
 }

src/Arr/ArrIf.php

@@ -43,7 +43,7 @@ final class ArrIf extends ArrWrap
     final public function __construct(bool|Logic $condition, array|Arr $arr)
     {
         parent::__construct(
-            new ArrCond(
+            new ArrFork(
                 $condition,
                 $arr,
                 new ArrEmpty()