refactor: Cleanup git state - commit all staged changes

Major refactoring cleanup:
- Add new controller architecture (class-controller-*.php)
- Add new settings-v2 UI (views/settings-v2/)
- Add new CSS architecture (agentic-sidebar.css, tokens)
- Add esbuild build pipeline (scripts/build.js, package.json)
- Add composer dependencies (vendor/)
- Add frontend src directory (assets/js/src/index.jsx)
- Add documentation files
- Remove old/obsolete files (class-settings.php, old CSS)

This commits all pending changes from previous refactoring efforts.
This commit is contained in:
Dwindi Ramadhana
2026-06-17 05:27:58 +07:00
parent d3f142222c
commit 690991c526
7963 changed files with 941566 additions and 67372 deletions

View File

@@ -0,0 +1,73 @@
<?php
declare(strict_types=1);
/**
* This file is part of phpDocumentor.
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*
* @link http://phpdoc.org
*/
namespace Flyfinder\Specification;
use Mockery as m;
use PHPUnit\Framework\TestCase;
/**
* Test case for AndSpecification
*
* @coversDefaultClass \Flyfinder\Specification\AndSpecification
*/
class AndSpecificationTest extends TestCase
{
/** @var m\MockInterface|HasExtension */
private $hasExtension;
/** @var m\MockInterface|IsHidden */
private $isHidden;
/** @var AndSpecification */
private $fixture;
/**
* Initializes the fixture for this test.
*/
public function setUp() : void
{
$this->hasExtension = m::mock(HasExtension::class);
$this->isHidden = m::mock(IsHidden::class);
$this->fixture = new AndSpecification($this->hasExtension, $this->isHidden);
}
public function tearDown() : void
{
m::close();
}
/**
* @covers ::__construct
* @covers ::isSatisfiedBy
*/
public function testIfSpecificationIsSatisfied() : void
{
$this->hasExtension->shouldReceive('isSatisfiedBy')->once()->andReturn(true);
$this->isHidden->shouldReceive('isSatisfiedBy')->once()->andReturn(true);
$this->assertTrue($this->fixture->isSatisfiedBy(['test']));
}
/**
* @covers ::__construct
* @covers ::isSatisfiedBy
*/
public function testIfSpecificationIsNotSatisfied() : void
{
$this->hasExtension->shouldReceive('isSatisfiedBy')->once()->andReturn(true);
$this->isHidden->shouldReceive('isSatisfiedBy')->once()->andReturn(false);
$this->assertFalse($this->fixture->isSatisfiedBy(['test']));
}
}

View File

@@ -0,0 +1,85 @@
<?php
declare(strict_types=1);
/**
* This file is part of phpDocumentor.
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*
* @link http://phpdoc.org
*/
namespace Flyfinder\Specification;
use Mockery as m;
use PHPUnit\Framework\MockObject\MockObject;
use PHPUnit\Framework\TestCase;
/**
* Test case for CompositeSpecification
*
* @coversDefaultClass Flyfinder\Specification\CompositeSpecification
*/
class CompositeSpecificationTest extends TestCase
{
/** @var m\MockInterface|HasExtension */
private $hasExtension;
/** @var CompositeSpecification|MockObject */
private $fixture;
/**
* Initializes the fixture for this test.
*/
public function setUp() : void
{
$this->hasExtension = m::mock(HasExtension::class);
$this->fixture = $this->getMockForAbstractClass(CompositeSpecification::class);
}
public function tearDown() : void
{
m::close();
}
/**
* @uses \Flyfinder\Specification\AndSpecification
*
* @covers ::andSpecification
*/
public function testAndSpecification() : void
{
$this->assertInstanceOf(
AndSpecification::class,
$this->fixture->andSpecification($this->hasExtension)
);
}
/**
* @uses \Flyfinder\Specification\OrSpecification
*
* @covers ::orSpecification
*/
public function testOrSpecification() : void
{
$this->assertInstanceOf(
OrSpecification::class,
$this->fixture->orSpecification($this->hasExtension)
);
}
/**
* @uses \Flyfinder\Specification\NotSpecification
*
* @covers ::notSpecification
*/
public function testNotSpecification() : void
{
$this->assertInstanceOf(
NotSpecification::class,
$this->fixture->notSpecification()
);
}
}

View File

@@ -0,0 +1,179 @@
<?php
declare(strict_types=1);
namespace Flyfinder\Specification;
use Generator;
use InvalidArgumentException;
use PHPUnit\Framework\TestCase;
use function is_array;
use function sprintf;
/**
* @coversDefaultClass \Flyfinder\Specification\Glob
* @covers ::<private>
* @covers ::isSatisfiedBy
* @covers ::__construct
*/
final class GlobTest extends TestCase
{
/**
* @param mixed[] $file
*
* @dataProvider matchingPatternFileProvider
* @dataProvider matchingPatternFileWithEscapeCharProvider
*
* @psalm-param array{basename: string, path: string, stream: resource, dirname: string, type: string, extension: string} $file
*/
public function testGlobIsMatching(string $pattern, array $file) : void
{
$glob = new Glob($pattern);
$this->assertTrue(
$glob->isSatisfiedBy($file),
sprintf('Failed: %s to match %s', $pattern, $file['path'])
);
}
/**
* @param mixed[] $file
*
* @dataProvider notMatchingPatternFileProvider
* @psalm-param array{basename: string, path: string, stream: resource, dirname: string, type: string, extension: string} $file
*/
public function testGlobIsNotMatching(string $pattern, array $file) : void
{
$glob = new Glob($pattern);
$this->assertFalse(
$glob->isSatisfiedBy($file),
sprintf('Failed: %s to match %s', $pattern, $file['path'])
);
}
/**
* @dataProvider invalidPatternProvider
*/
public function testInvalidGlobThrows(string $pattern) : void
{
$this->expectException(InvalidArgumentException::class);
new Glob($pattern);
}
/**
* @covers ::canBeSatisfiedBySomethingBelow
*/
public function testCanBeSatisfiedBySomethingBelow() : void
{
$glob = new Glob('/**/*');
$this->assertTrue($glob->canBeSatisfiedBySomethingBelow(['path' => 'src']));
}
public function invalidPatternProvider() : Generator
{
$invalidPatterns = [
'[aaa',
'{aaa',
'{a,{b}',
'aaaa', //path must be absolute
];
foreach ($invalidPatterns as $pattern) {
yield $pattern => [$pattern];
}
}
public function matchingPatternFileProvider() : Generator
{
$input = [
'/*.php' => 'test.php',
'/src/*' => 'src/test.php',
'/src/**/*.php' => 'src/subdir/test.php',
'/src/**/*' => 'src/subdir/second/test.php',
'/src/{subdir,other}/*' => [
'src/subdir/test.php',
'src/other/test.php',
],
'/src/subdir/test-[a-c].php' => [
'src/subdir/test-a.php',
'src/subdir/test-b.php',
'src/subdir/test-c.php',
],
'/src/subdir/test-[^a-c].php' => 'src/subdir/test-d.php',
'/src/subdir/test-?.php' => [
'src/subdir/test-a.php',
'src/subdir/test-b.php',
'src/subdir/test-c.php',
'src/subdir/test-~.php',
],
'/src/subdir/test-}.php' => 'src/subdir/test-}.php',
];
yield from $this->toTestData($input);
}
public function matchingPatternFileWithEscapeCharProvider() : Generator
{
$escapeChars = [
'*',
'?',
'{',
'}',
'[',
']',
'-',
'^',
'$',
'~',
'\\',
'\\\\',
];
foreach ($escapeChars as $char) {
$file = sprintf('/src/test\\%s.php', $char);
yield $file => [
$file,
['path' => sprintf('src/test%s.php', $char)],
];
}
}
public function notMatchingPatternFileProvider() : Generator
{
$input = [
'/*.php' => 'test.css',
'/src/*' => 'src/subdir/test.php',
'/src/**/*.php' => 'src/subdir/test.css',
'/src/subdir/test-[a-c].php' => 'src/subdir/test-d.php',
'/src/subdir/test-[^a-c].php' => [
'src/subdir/test-a.php',
'src/subdir/test-b.php',
'src/subdir/test-c.php',
],
'/src' => 'test/file.php',
];
yield from $this->toTestData($input);
}
/**
* @param mixed[] $input
*/
private function toTestData(array $input) : Generator
{
foreach ($input as $glob => $path) {
if (!is_array($path)) {
$path = [$path];
}
foreach ($path as $key => $item) {
yield ($key !== 0 ? $key . ' - ' : '') . $glob => [
$glob,
['path' => $item],
];
}
}
}
}

View File

@@ -0,0 +1,59 @@
<?php
declare(strict_types=1);
/**
* This file is part of phpDocumentor.
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*
* @link http://phpdoc.org
*/
namespace Flyfinder\Specification;
use Mockery as m;
use PHPUnit\Framework\TestCase;
/**
* Test case for HasExtension
*
* @coversDefaultClass Flyfinder\Specification\HasExtension
*/
class HasExtensionTest extends TestCase
{
/** @var HasExtension */
private $fixture;
/**
* Initializes the fixture for this test.
*/
public function setUp() : void
{
$this->fixture = new HasExtension(['txt']);
}
public function tearDown() : void
{
m::close();
}
/**
* @covers ::__construct
* @covers ::isSatisfiedBy
*/
public function testIfSpecificationIsSatisfied() : void
{
$this->assertTrue($this->fixture->isSatisfiedBy(['extension' => 'txt']));
}
/**
* @covers ::__construct
* @covers ::isSatisfiedBy
*/
public function testIfSpecificationIsNotSatisfied() : void
{
$this->assertFalse($this->fixture->isSatisfiedBy(['extension' => 'php']));
}
}

View File

@@ -0,0 +1,167 @@
<?php
declare(strict_types=1);
/**
* This file is part of phpDocumentor.
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*
* @link http://phpdoc.org
*/
namespace Flyfinder\Specification;
use Flyfinder\Path;
use Mockery as m;
use PHPUnit\Framework\TestCase;
use function dirname;
/**
* Test case for InPath
*
* @coversDefaultClass \Flyfinder\Specification\InPath
* @covers ::<private>
*/
class InPathTest extends TestCase
{
/** @var InPath */
private $fixture;
public function tearDown() : void
{
m::close();
}
/**
* @uses \Flyfinder\Path
*
* @covers ::__construct
* @covers ::isSatisfiedBy
* @dataProvider validDirnames
*/
public function testExactMatch() : void
{
$absolutePath = 'absolute/path/to/file.txt';
$spec = new InPath(new Path($absolutePath));
$this->assertTrue($spec->isSatisfiedBy([
'type' => 'file',
'path' => $absolutePath,
'dirname' => $absolutePath,
'filename' => 'file',
'extension' => 'txt',
'basename' => 'file.txt',
]));
}
private function useWildcardPath() : void
{
$this->fixture = new InPath(new Path('*dden?ir/n'));
}
/**
* @uses \Flyfinder\Path
*
* @covers ::__construct
* @covers ::isSatisfiedBy
* @dataProvider validDirnames
*/
public function testIfSpecificationIsSatisfied(string $dirname) : void
{
$this->useWildcardPath();
$this->assertTrue($this->fixture->isSatisfiedBy(['dirname' => $dirname]));
}
/**
* @uses \Flyfinder\Path
*
* @covers ::__construct
* @covers ::isSatisfiedBy
* @dataProvider validDirnames
*/
public function testWithSingleDotSpec(string $dirname) : void
{
$spec = new InPath(new Path('.'));
$this->assertTrue($spec->isSatisfiedBy(['dirname' => $dirname]));
}
/**
* @uses \Flyfinder\Path
*
* @covers ::__construct
* @covers ::isSatisfiedBy
* @dataProvider validDirnames
*/
public function testWithCurrentDirSpec(string $dirname) : void
{
$spec = new InPath(new Path('./'));
$this->assertTrue($spec->isSatisfiedBy(['dirname' => $dirname]));
}
/**
* Data provider for testIfSpecificationIsSatisfied. Contains a few valid directory names
*
* @return string[][]
*/
public function validDirnames() : array
{
return [
['.hiddendir/n'],
['.hiddendir/n/'],
['.hiddendir/n/somedir'],
['.hiddendir/n/somedir.txt'],
['ddenxir/n'],
];
}
/**
* @uses \Flyfinder\Path
*
* @covers ::__construct
* @covers ::isSatisfiedBy
* @dataProvider invalidDirnames
*/
public function testIfSpecificationIsNotSatisfied(string $dirname) : void
{
$this->useWildcardPath();
$this->assertFalse($this->fixture->isSatisfiedBy(['dirname' => $dirname]));
}
/**
* Data provider for testIfSpecificationIsNotSatisfied. Contains a few invalid directory names
*
* @return string[][]
*/
public function invalidDirnames() : array
{
return [
['/hiddendir/n'],
['.hiddendir/normaldir'],
['.hiddendir.ext/n'],
['.hiddenxxir/n'],
['.hiddenir/n'],
];
}
/**
* @uses \Flyfinder\Path
*
* @covers ::__construct
* @covers ::isSatisfiedBy
*/
public function testNoFalsePositiveWithLongerDirName() : void
{
$prefixDir = 'absolute/path';
$absolutePath = 'absolute/pathMOAR/to/file.txt';
$spec = new InPath(new Path($prefixDir));
$this->assertFalse($spec->isSatisfiedBy([
'type' => 'file',
'path' => $absolutePath,
'dirname' => dirname($absolutePath),
'filename' => 'file',
'extension' => 'txt',
'basename' => 'file.txt',
]));
}
}

View File

@@ -0,0 +1,57 @@
<?php
declare(strict_types=1);
/**
* This file is part of phpDocumentor.
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*
* @link http://phpdoc.org
*/
namespace Flyfinder\Specification;
use Mockery as m;
use PHPUnit\Framework\TestCase;
/**
* Test case for IsHidden
*
* @coversDefaultClass Flyfinder\Specification\IsHidden
*/
class IsHiddenTest extends TestCase
{
/** @var IsHidden */
private $fixture;
/**
* Initializes the fixture for this test.
*/
public function setUp() : void
{
$this->fixture = new IsHidden();
}
public function tearDown() : void
{
m::close();
}
/**
* @covers ::isSatisfiedBy
*/
public function testIfSpecificationIsSatisfied() : void
{
$this->assertTrue($this->fixture->isSatisfiedBy(['basename' => '.test']));
}
/**
* @covers ::isSatisfiedBy
*/
public function testIfSpecificationIsNotSatisfied() : void
{
$this->assertFalse($this->fixture->isSatisfiedBy(['basename' => 'test']));
}
}

View File

@@ -0,0 +1,67 @@
<?php
declare(strict_types=1);
/**
* This file is part of phpDocumentor.
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*
* @link http://phpdoc.org
*/
namespace Flyfinder\Specification;
use Mockery as m;
use PHPUnit\Framework\TestCase;
/**
* Test case for NotSpecification
*
* @coversDefaultClass Flyfinder\Specification\NotSpecification
*/
class NotSpecificationTest extends TestCase
{
/** @var m\MockInterface|HasExtension */
private $hasExtension;
/** @var NotSpecification */
private $fixture;
/**
* Initializes the fixture for this test.
*/
public function setUp() : void
{
$this->hasExtension = m::mock(HasExtension::class);
$this->fixture = new NotSpecification($this->hasExtension);
}
public function tearDown() : void
{
m::close();
}
/**
* @covers ::__construct
* @covers ::isSatisfiedBy
*/
public function testIfSpecificationIsSatisfied() : void
{
$this->hasExtension->shouldReceive('isSatisfiedBy')->once()->andReturn(false);
$this->assertTrue($this->fixture->isSatisfiedBy(['test']));
}
/**
* @covers ::__construct
* @covers ::isSatisfiedBy
*/
public function testIfSpecificationIsNotSatisfied() : void
{
$this->hasExtension->shouldReceive('isSatisfiedBy')->once()->andReturn(true);
$this->assertFalse($this->fixture->isSatisfiedBy(['test']));
}
}

View File

@@ -0,0 +1,73 @@
<?php
declare(strict_types=1);
/**
* This file is part of phpDocumentor.
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*
* @link http://phpdoc.org
*/
namespace Flyfinder\Specification;
use Mockery as m;
use PHPUnit\Framework\TestCase;
/**
* Test case for OrSpecification
*
* @coversDefaultClass Flyfinder\Specification\OrSpecification
*/
class OrSpecificationTest extends TestCase
{
/** @var m\MockInterface|HasExtension */
private $hasExtension;
/** @var m\MockInterface|IsHidden */
private $isHidden;
/** @var OrSpecification */
private $fixture;
/**
* Initializes the fixture for this test.
*/
public function setUp() : void
{
$this->hasExtension = m::mock(HasExtension::class);
$this->isHidden = m::mock(IsHidden::class);
$this->fixture = new OrSpecification($this->hasExtension, $this->isHidden);
}
public function tearDown() : void
{
m::close();
}
/**
* @covers ::__construct
* @covers ::isSatisfiedBy
*/
public function testIfSpecificationIsSatisfied() : void
{
$this->hasExtension->shouldReceive('isSatisfiedBy')->once()->andReturn(false);
$this->isHidden->shouldReceive('isSatisfiedBy')->once()->andReturn(true);
$this->assertTrue($this->fixture->isSatisfiedBy(['test']));
}
/**
* @covers ::__construct
* @covers ::isSatisfiedBy
*/
public function testIfSpecificationIsNotSatisfied() : void
{
$this->hasExtension->shouldReceive('isSatisfiedBy')->once()->andReturn(false);
$this->isHidden->shouldReceive('isSatisfiedBy')->once()->andReturn(false);
$this->assertFalse($this->fixture->isSatisfiedBy(['test']));
}
}