optionalDeep helper (#4)

composer.json

@@ -13,6 +13,9 @@
         "illuminate/support": "^9.0|^10.0"
     },
     "autoload": {
+        "files": [
+            "src/helpers.php"
+        ],
         "psr-4": {
             "Rapidez\\BladeDirectives\\": "src"
         }

src/OptionalDeep.php

@@ -0,0 +1,164 @@
+<?php
+
+namespace Rapidez\BladeDirectives;
+
+use ArrayAccess;
+use ArrayObject;
+use Countable;
+use Illuminate\Support\Traits\Macroable;
+use IteratorAggregate;
+use JsonSerializable;
+use Traversable;
+
+class OptionalDeep implements ArrayAccess, IteratorAggregate, Countable, JsonSerializable
+{
+    use Macroable {
+        __call as macroCall;
+    }
+
+    protected $value;
+
+    public function __construct($value)
+    {
+        $this->value = $value;
+    }
+
+    public function __get($key): static
+    {
+        return new static($this->get($key));
+    }
+
+    public function get($key = null, $default = null): mixed
+    {
+        return data_get($this->value, $key, $default);
+    }
+
+    public function __set($key, $value): void
+    {
+        if (!is_object($this->value) && !is_array($this->value)) {
+            return;
+        }
+
+        $unwrappedValue = $value instanceof static ? $value->value : $value;
+
+        data_set($this->value, $key, $unwrappedValue);
+    }
+
+    public function __unset($key): void
+    {
+        if (!is_object($this->value) && !is_array($this->value)) {
+            return;
+        }
+
+        data_forget($this->value, $key);
+    }
+
+    public function __toString(): string
+    {
+        if (!isset($this->value)) {
+            return '';
+        }
+
+        if (is_string($this->value)) {
+            return $this->value;
+        }
+
+        return strval($this->value);
+    }
+
+    public function __invoke($default = null): mixed
+    {
+        return $this->get(null, $default);
+    }
+
+    public function __isset($key)
+    {
+        return isset($this->value->{$key});
+    }
+
+    public function isset(): bool
+    {
+        return isset($this->value);
+    }
+
+    public function __isNotEmpty(): bool
+    {
+        if (method_exists($this->value, 'value')) {
+            return boolval($this->value->value());
+        }
+
+        return boolval($this->value);
+    }
+
+    public function __isEmpty(): bool
+    {
+        return !$this->isNotEmpty();
+    }
+
+    // ArrayAccess interface
+    public function offsetGet(mixed $offset): mixed
+    {
+        return $this->__get($offset);
+    }
+
+    public function offsetSet(mixed $offset, mixed $value): void
+    {
+        $this->__set($offset, $value);
+    }
+
+    public function offsetExists(mixed $offset): bool
+    {
+        return isset($this->value->{$offset}) || isset($this->value[$offset]);
+    }
+
+    public function offsetUnset(mixed $offset): void
+    {
+        $this->__unset($offset);
+    }
+
+    // IteratorAggregate interface
+    public function getIterator(): Traversable
+    {
+        if (is_iterable($this->value)) {
+            return collect($this->value)->map(fn($item) => new static($item));
+        }
+
+        return new ArrayObject();
+    }
+
+    // Countable interface
+    public function count(): int
+    {
+        if ($this->value instanceof Countable) {
+            return count($this->value);
+        }
+
+        return 0;
+    }
+
+    // JsonSerializable interface
+    public function jsonSerialize(): mixed
+    {
+        return $this->value;
+    }
+
+    public function __call($method, $parameters): mixed
+    {
+        if (static::hasMacro($method)) {
+            return $this->macroCall($method, $parameters);
+        }
+
+        if (!is_object($this->value) || !is_string($this->value) || !method_exists($this->value, $method)) {
+            if ($method == 'isNotEmpty') {
+                return $this->__isNotEmpty();
+            }
+            if ($method == 'isEmpty') {
+                return $this->__isEmpty();
+            }
+
+            return new static(null);
+        }
+
+        return new static($this->value->{$method}($parameters));
+    }
+}

src/helpers.php

@@ -0,0 +1,10 @@
+<?php
+
+use Rapidez\BladeDirectives\OptionalDeep;
+
+if (! function_exists('optionalDeep')) {
+    function optionalDeep($value)
+    {
+        return new OptionalDeep($value);
+    }
+}