support handles by reference

Author: ryanmitchell

src/Http/Middleware/CacheTracker.php

@@ -13,6 +13,7 @@
 use Statamic\Facades\URL;
 use Statamic\Forms;
 use Statamic\StaticCaching\Cacher;
+use Statamic\Structures\Nav;
 use Statamic\Structures\Page;
 use Statamic\Support\Str;
 use Statamic\Tags;
@@ -181,7 +182,13 @@ private function setupTagHooks()
         });
 
         Tags\Nav::hook('init', function ($value, $next) use ($self) {
-            $handle = 'nav:'.$this->params->get('handle', $this->tag != 'nav:index' ? Str::after($this->tag, 'nav:') : 'collection::pages');
+            $handle = $this->params->get('handle', $this->tag != 'nav:index' ? Str::after($this->tag, 'nav:') : 'collection::pages');
+
+            if ($handle instanceof Nav) {
+                $handle = $handle->handle();
+            }
+
+            $handle = 'nav:'.$handle;
             $self->addContentTag($handle);
 
             return $next($value);

tests/Unit/NavTagTest.php

@@ -98,6 +98,41 @@ public function it_tracks_nav_tag_without_handle_using_default()
         $this->assertContains('nav:collection::pages', $tags);
     }
 
+    #[Test]
+    public function it_tracks_nav_tag_when_handle_is_nav_instance()
+    {
+        // Create a navigation structure
+        $nav = Facades\Nav::make('sidebar')
+            ->title('Sidebar')
+            ->expectsRoot(true)
+            ->collections(['pages'])
+            ->save();
+
+        $view = <<<'BLADE'
+{{ nav :handle="nav" }}
+    {{ title }}
+{{ /nav }}
+BLADE;
+
+        file_put_contents($this->viewPath('nav-test.antlers.html'), $view);
+
+        Facades\Entry::make()
+            ->id('nav-test-page')
+            ->slug('nav-test')
+            ->collection('pages')
+            ->data([
+                'template' => 'nav-test',
+                'nav' => $nav,
+            ])
+            ->save();
+
+        $this->get('/nav-test');
+
+        $tags = collect(Tracker::all())->first()['tags'] ?? [];
+
+        $this->assertContains('nav:sidebar', $tags);
+    }
+
     protected function viewPath($name)
     {
         return __DIR__.'/../__fixtures__/resources/views/'.$name;