Add LazyBreadcrumb functionality and initial test cases

Introduce the LazyBreadcrumb class with basic methods to manage breadcrumbs. Add the `breadcrumbs` helper function and implement initial test cases to verify breadcrumb creation and addition. Update configuration to include a default breadcrumb entry.

Author: CrazyBoy49z

config/lazy-breadcrumb.php

@@ -2,4 +2,10 @@
 
 // config for Step2Dev/LazyBreadcrumb
 return [
+    'default' => [
+        [
+            'url'   => '/',//route('home'),
+            'label' => env('APP_NAME'),
+        ],
+    ],
 ];

src/LazyBreadcrumb.php

@@ -2,4 +2,31 @@
 
 namespace Step2Dev\LazyBreadcrumb;
 
-class LazyBreadcrumb {}
+class LazyBreadcrumb
+{
+    /**
+     * @var array|array[]
+     */
+    private array $breadcrumbs;
+
+    public function __construct()
+    {
+        $this->breadcrumbs = (array) config('lazy-breadcrumb.default', []);
+    }
+
+    public function add(string|null $url, string|null $label): static
+    {
+        if (! $url && ! $label) {
+            return $this;
+        }
+
+        $this->breadcrumbs[] = array_filter(compact('url', 'label'));
+
+        return $this;
+    }
+
+    public function getBreadcrumbs(): array
+    {
+        return $this->breadcrumbs;
+    }
+}

src/helpers.php

@@ -0,0 +1,15 @@
+<?php
+
+use Step2Dev\LazyBreadcrumb\LazyBreadcrumb;
+
+if (! function_exists('breadcrumbs')) {
+    /**
+     * Generate breadcrumbs.
+     *
+     * @return LazyBreadcrumb
+     */
+    function breadcrumbs(): LazyBreadcrumb
+    {
+        return new LazyBreadcrumb();
+    }
+}

tests/LazyBreadcrumbTest.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace Step2Dev\LazyBreadcrumb\Tests;
+
+use Illuminate\Support\Facades\Config;
+use PHPUnit\Framework\TestCase;
+use Step2Dev\LazyBreadcrumb\LazyBreadcrumb;
+
+class LazyBreadcrumbTest extends TestCase
+{
+    public function testInitialBreadcrumbs()
+    {
+        $breadcrumbs = new LazyBreadcrumb();
+        $this->assertEquals(Config::get('lazy_breadcrumb.default'), $breadcrumbs->getBreadcrumbs());
+    }
+
+    public function testAddBreadcrumb()
+    {
+        $breadcrumbs = new LazyBreadcrumb();
+        $breadcrumbs->add('/new-url', 'New Label');
+
+        $this->assertEquals([
+            Config::get('lazy_breadcrumb.default'),
+            [
+                'url'   => '/new-url',
+                'label' => 'New Label',
+            ],
+        ], $breadcrumbs->getBreadcrumbs());
+    }
+}