Test: Add unit tests for Translator, NavigationBuilder and TOC Plugin (#1)

- Added Pest PHP, PHPStan and PHP-CS-Fixer configuration
- Added unit tests for NavigationBuilder
- Added unit tests for TableOfContentsPlugin (Regex logic)
- Added CI workflow for quality checks

Author: Ezar101

phpstan.neon

@@ -3,6 +3,7 @@ parameters:
     paths:
         - src
         - bin
+        - tests
     excludePaths:
         - vendor
     tmpDir: var/cache/phpstan

tests/Unit/KernelTest.php tests/Unit/Core/KernelTest.phptests/Unit/KernelTest.php renamed to tests/Unit/Core/KernelTest.php

@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+
+use LiteDocs\Core\NavigationBuilder;
+
+test('navigation builder converts flat config to tree', function () {
+    $builder = new NavigationBuilder();
+
+    $config = [
+        'Introduction' => 'index.md',
+        'Guide' => [
+            'Installation' => 'install.md'
+        ]
+    ];
+
+    expect($builder)->toBeInstanceOf(NavigationBuilder::class);
+});
+
+test('getFlatList flattens a tree correctly', function () {
+    $builder = new NavigationBuilder();
+
+    $tree = [
+        [
+            'title' => 'Home',
+            'url' => 'index.html',
+        ],
+        [
+            'title' => 'Guide',
+            'children' => [
+                [
+                    'title' => 'Install',
+                    'url' => 'install.html'
+                ]
+            ]
+        ]
+    ];
+
+    $flat = $builder->getFlatList($tree);
+
+    expect($flat)->toBeArray();
+    expect($flat)->toHaveCount(2);
+    expect($flat[0]['url'])->toBe('index.html');
+    expect($flat[1]['url'])->toBe('install.html');
+});

tests/Unit/Core/NavigationBuilderTest.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+use LiteDocs\Core\Translator;
+
+test('translator can be instantiated', function () {
+    $translator = new Translator(__DIR__, __DIR__, 'lite');
+
+    expect($translator)->toBeInstanceOf(Translator::class);
+});
+
+test('translator returns array', function () {
+    $translator = new Translator(__DIR__, __DIR__, 'lite');
+    $result = $translator->getTranslations('en');
+
+    expect($result)->toBeArray();
+});

tests/Unit/Core/TranslatorTest.php

@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types=1);
+
+use LiteDocs\Event\PageEvent;
+use LiteDocs\Plugin\TableOfContentsPlugin;
+
+test('toc plugin extracts h2 headers and generates ids', function () {
+    $plugin = new TableOfContentsPlugin();
+
+    $html = '<h1>Main Title</h1> <h2>Introduction</h2> <p>Text</p> <h2>Conclusion</h2>';
+
+    $event = new PageEvent($html, 'test.md', []);
+
+    $plugin->onAfterParse($event);
+
+    $newHtml = $event->content;
+
+    expect($newHtml)->toContain('id="introduction"');
+    expect($newHtml)->toContain('id="conclusion"');
+
+    $context = $event->getContext();
+
+    expect($context)->toHaveKey('toc');
+    expect($context['toc'])->toBeArray();
+    expect($context['toc'])->toHaveCount(2);
+
+    expect($context['toc'][0]['title'])->toBe('Introduction');
+    expect($context['toc'][0]['url'])->toBe('#introduction');
+
+    expect($context['toc'][1]['title'])->toBe('Conclusion');
+    expect($context['toc'][1]['url'])->toBe('#conclusion');
+});
+
+test('toc plugin handles duplicate headers correctly', function () {
+    $plugin = new TableOfContentsPlugin();
+
+    $html = '<h2>Installation</h2> <p>...</p> <h2>Installation</h2>';
+
+    $event = new PageEvent($html, 'test.md', []);
+    $plugin->onAfterParse($event);
+
+    $context = $event->getContext();
+
+    expect($context['toc'][0]['url'])->toBe('#installation');
+
+    expect($context['toc'][1]['url'])->not->toBe('#installation');
+    expect($context['toc'][1]['url'])->toContain('installation-');
+});