<?php

declare(strict_types=1);

namespace App\Controllers;

/**
 * Tool directory: /tools with search, category filter, popular, recent
 * and A–Z views. Server-rendered links only — crawlable navigation.
 */
final class Directory extends BaseController
{
    public function index(): string
    {
        $finder = service('finder');
        $q      = trim((string) $this->request->getGet('q'));
        $cat    = (string) ($this->request->getGet('category') ?? '');

        $tools = $finder->all();
        if ($q !== '') {
            $tools = service('toolSearch')->find($q, 100);
            service('analytics')->track('search', ['meta' => ['term' => mb_substr($q, 0, 80), 'scope' => 'directory']]);
        }
        if ($cat !== '') {
            $tools = array_values(array_filter(
                $tools,
                static fn (array $t): bool => (service('finder')->categoryById((int) $t['category_id'])['slug'] ?? '') === $cat
            ));
        }

        $this->seo->title('All Tools – ' . config('Site')->name)
            ->description('Search and browse every free online tool: video, audio, image, GIF, PDF and YouTube utilities.')
            ->canonical('/tools')
            ->breadcrumbs([['label' => 'Tools']]);

        return $this->render('directory', [
            'tools'      => $tools,
            'categories' => $finder->categories(),
            'query'      => $q,
            'activeCat'  => $cat,
            'view'       => 'all-tools',
        ]);
    }

    public function popular(): string
    {
        return $this->renderList(
            'Popular Tools',
            'The most used tools across the platform right now.',
            service('finder')->popular(24),
            '/tools/popular'
        );
    }

    public function recent(): string
    {
        return $this->renderList(
            'Recently Added Tools',
            'Fresh additions to the toolbox.',
            service('finder')->recent(24),
            '/tools/recent'
        );
    }

    public function az(): string
    {
        return $this->renderList(
            'All Tools A–Z',
            'Every tool in alphabetical order.',
            service('finder')->all(),
            '/tools/a-z'
        );
    }

    public function category(string $slug): string
    {
        return redirect()->to('/' . $slug, 301);
    }

    private function renderList(string $h1, string $intro, array $tools, string $path): string
    {
        $this->seo->title($h1 . ' – ' . config('Site')->name)
            ->description(mb_substr($intro, 0, 300))
            ->canonical($path)
            ->breadcrumbs([['label' => 'Tools', 'url' => '/tools'], ['label' => $h1]]);

        return $this->render('directory_list', [
            'tools' => $tools,
            'h1'    => $h1,
            'intro' => $intro,
            'view'  => $path,
        ]);
    }
}