feat: layout builder

Author: yajra

src/Html/HasOptions.php

@@ -73,6 +73,7 @@ public function displayStart(int $value = 0): static
      * Set dom option value.
      *
      * @return $this
+     * @deprecated Use layout() method instead.
      *
      * @see https://datatables.net/reference/option/dom
      */
@@ -83,6 +84,30 @@ public function dom(string $value): static
         return $this;
     }
 
+    /**
+     * Set layout option value.
+     *
+     * @return $this
+     *
+     * @see https://datatables.net/reference/option/layout
+     */
+    public function layout(array|Layout|callable $value): static
+    {
+        if ($value instanceof Layout) {
+            $value = $value->toArray();
+        }
+
+        if (is_callable($value)) {
+            $layout = new Layout;
+            $value($layout);
+            $value = $layout->toArray();
+        }
+
+        $this->attributes['layout'] = $value;
+
+        return $this;
+    }
+
     /**
      * Set lengthMenu option value.
      *

src/Html/Layout.php

@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Yajra\DataTables\Html;
+
+use Illuminate\Support\Fluent;
+use Illuminate\Support\Traits\Macroable;
+
+class Layout extends Fluent
+{
+    use Macroable;
+
+    public function topStart(string|array|null $options, int $order = 0): static
+    {
+        return $this->top($options, $order, 'Start');
+    }
+
+    public function topEnd(string|array|null $options, int $order = 0): static
+    {
+        return $this->top($options, $order, 'End');
+    }
+
+    public function bottomStart(string|array|null $options, int $order = 0): static
+    {
+        return $this->bottom($options, $order, 'Start');
+    }
+
+    public function bottomEnd(string|array|null $options, int $order = 0): static
+    {
+        return $this->bottom($options, $order, 'End');
+    }
+
+    public function top(array|string|null $options, ?int $order = null, ?string $position = null): static
+    {
+        if ($order > 0) {
+            $this->attributes["top{$order}{$position}"] = $options;
+        } else {
+            $this->attributes["top{$position}"] = $options;
+        }
+
+        return $this;
+    }
+
+    public function bottom(array|string|null $options, ?int $order = null, ?string $position = null): static
+    {
+        if ($order > 0) {
+            $this->attributes["bottom{$order}{$position}"] = $options;
+        } else {
+            $this->attributes["bottom{$position}"] = $options;
+        }
+
+        return $this;
+    }
+}