Merge pull request #9 from Xoshbin:fix/search-functionality

fix: dynamic search paths for localized and versioned docs

Author: Xoshbin

dist/pertuk.js

@@ -256,7 +256,8 @@ class DocsManager {
         const ensureIndex = async () => {
             if (index) return index;
             try {
-                const res = await fetch("/docs/index.json", {
+                const indexUrl = input.getAttribute("data-index-url") || "/docs/index.json";
+                const res = await fetch(indexUrl, {
                     headers: { Accept: "application/json" },
                 });
                 const data = await res.json();
@@ -299,12 +300,14 @@ class DocsManager {
                 return;
             }
 
+            const baseUrl = input.getAttribute("data-base-url") || "/docs";
+
             results.innerHTML = items
                 .slice(0, 8)
                 .map((it) => {
                     const href = it.anchor
-                        ? `/docs/${it.slug}#${it.anchor}`
-                        : `/docs/${it.slug}`;
+                        ? `${baseUrl}/${it.slug}#${it.anchor}`
+                        : `${baseUrl}/${it.slug}`;
                     const displayTitle = it.heading
                         ? `${it.title} > ${it.heading}`
                         : it.title;

resources/js/pertuk.js

@@ -26,8 +26,20 @@ class="flex h-8 w-8 items-center justify-center rounded-lg bg-gradient-to-br fro
                                 d="M21 21l-6-6m2-5a7 7 0 11-14 0 7 7 0 0114 0z" />
                         </svg>
                     </div>
+                    @php
+                        $currentLocale = app()->getLocale();
+                        $currentVersion = $current_version ?? null;
+                        
+                        $searchIndexUrl = $currentVersion 
+                            ? route('pertuk.docs.version.search.json', ['version' => $currentVersion, 'locale' => $currentLocale])
+                            : route('pertuk.docs.search.json', ['locale' => $currentLocale]);
+                            
+                        $searchBaseUrl = url('/' . config('pertuk.route_prefix', 'docs') . ($currentVersion ? '/' . $currentVersion : '') . '/' . $currentLocale);
+                    @endphp
                     <input id="docs-search-input" type="search" placeholder="{{ __('Search documentation...') }}"
                         aria-label="{{ __('Search documentation') }}"
+                        data-index-url="{{ $searchIndexUrl }}"
+                        data-base-url="{{ $searchBaseUrl }}"
                         class="w-full rounded-lg border border-gray-300 bg-gray-50/50 ps-10 pe-4 py-2.5 text-sm placeholder-gray-500 outline-none transition-all duration-200 focus:border-orange-500 focus:bg-white focus:ring-2 focus:ring-orange-500/20 dark:border-gray-700 dark:bg-gray-900/50 dark:text-white dark:placeholder-gray-400 dark:focus:border-orange-400 dark:focus:bg-gray-900 dark:focus:ring-orange-400/20"
                         autocomplete="off" />
                     <div class="absolute inset-y-0 end-0 pe-3 flex items-center pointer-events-none">

resources/views/components/header.blade.php

@@ -134,10 +134,13 @@ protected function responseWithCacheHeaders(HttpResponse $response, int $mtime,
     /**
      * Search index endpoint.
      */
-    public function searchIndex(Request $request, string $locale): JsonResponse
+    public function searchIndex(Request $request): JsonResponse
     {
         $version = $request->route('version');
+        $locale = $request->route('locale');
+
         $version = is_string($version) ? $version : null;
+        $locale = is_string($locale) ? $locale : config('pertuk.default_locale', 'en');
 
         $items = DocumentationService::make($version)->buildIndex($locale);
 

src/Http/Controllers/DocumentController.php

@@ -11,6 +11,22 @@
     $response->assertSee('Payments', false);
 });
 
+it('discovers available versions correctly', function () {
+    // Set up supported locales
+    config(['pertuk.supported_locales' => ['en', 'ckb']]);
+
+    // Create versioned directories
+    $this->createTestMarkdownFile('test.md', '# Test', '', 'en', 'v1.0');
+    $this->createTestMarkdownFile('test.md', '# Test', '', 'ckb', 'v2.0');
+
+    $versions = \Xoshbin\Pertuk\Services\DocumentationService::getAvailableVersions();
+
+    expect($versions)->toBeArray();
+    expect($versions)->toContain('v1.0');
+    expect($versions)->toContain('v2.0');
+    expect($versions[0])->toBe('v2.0'); // Latest first
+});
+
 it('renders a doc page with TOC and breadcrumbs', function () {
     // Create a test document with multiple headings for TOC
     $content = "---\ntitle: Receipt and Payment Vouchers\norder: 2\n---\n\n# Receipt and Payment Vouchers\n\n## Overview\n\nThis section covers vouchers.\n\n### Types of Vouchers\n\nDifferent types available.\n\n```php\n\$voucher = new Voucher();\n```\n\n## Processing\n\nHow to process vouchers.";
@@ -82,3 +98,44 @@
     expect($data)->toHaveCount(1);
     expect($data[0])->toHaveKeys(['id', 'slug', 'title', 'heading', 'content', 'anchor']);
 });
+
+it('shows versioned documentation search index', function () {
+    // Create a test document in a versioned directory
+    $this->createTestMarkdownFile('test-v1.md', "# V1 Document\n\n## Subheading\n\nContent", '', 'en', 'v1');
+
+    // Attempt to access versioned search index via route
+    $response = $this->get('/docs/v1/en/index.json');
+
+    $response->assertStatus(200);
+    $response->assertJsonFragment(['slug' => 'test-v1']);
+});
+
+it('renders search input with dynamic data attributes', function () {
+    // Set up test doc
+    $this->createTestMarkdownFile('welcome.md', '# Welcome');
+
+    // Get a page with the header
+    $response = $this->get('/docs/en/welcome');
+    $response->assertOk();
+
+    $indexUrl = route('pertuk.docs.search.json', ['locale' => 'en']);
+    $baseUrl = url('/docs/en');
+
+    $response->assertSee('data-index-url="'.$indexUrl.'"', false);
+    $response->assertSee('data-base-url="'.$baseUrl.'"', false);
+});
+
+it('renders versioned search input with dynamic data attributes', function () {
+    // Set up versioned test doc
+    $this->createTestMarkdownFile('v10-welcome.md', '# V10 Welcome', '', 'en', 'v10.0');
+
+    // Get a versioned page
+    $response = $this->get('/docs/v10.0/en/v10-welcome');
+    $response->assertOk();
+
+    $indexUrl = route('pertuk.docs.version.search.json', ['version' => 'v10.0', 'locale' => 'en']);
+    $baseUrl = url('/docs/v10.0/en');
+
+    $response->assertSee('data-index-url="'.$indexUrl.'"', false);
+    $response->assertSee('data-base-url="'.$baseUrl.'"', false);
+});