Files
breadcrumb-the-shire/tests/Architecture/ContainerFactoryContractTest.php
fs c7b8fd516a feat: extend module platform with UI slots, runtime components, CLI tooling and {{userId}} search support
Completes the generic module platform that enables modules to contribute
UI elements, runtime JS components, and search resources without any
core hardcoding.

New generic UI slot types:
- topbar.right_item: module-contributed topbar buttons
- layout.body_end_template: module-contributed dialog/overlay templates
- layout.head_style: module-contributed global CSS
- runtime.component: declarative JS component registration with phase ordering

New infrastructure:
- ModuleAutoloader: PSR-4 autoloading for module-local PHP classes
- ModuleRuntimePageBuilder: symlinks module pages into runtime directory
- ModuleRuntimeAssetPublisher: publishes module CSS/JS to web/modules/
- ModulePermissionSynchronizer: syncs module permissions to DB
- CLI scripts: module-runtime-sync, module-build, module-migrate,
  module-permissions-sync, module-assets-sync
- {{userId}} placeholder in SearchDataService for user-scoped search queries
- Component runtime with phased initialization (early/default/late)
- AppContainer.protectExistingBindings() to prevent module→core overwrites
- Architecture tests: ModuleStructureContractTest, CoreTemplateIsolationTest,
  FrontendComponentRuntimeContractTest, AppContainerIsolationContractTest

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-18 22:19:56 +01:00

61 lines
2.6 KiB
PHP

<?php
namespace MintyPHP\Tests\Architecture;
use PHPUnit\Framework\Attributes\DataProvider;
use PHPUnit\Framework\TestCase;
use ReflectionClass;
use ReflectionMethod;
class ContainerFactoryContractTest extends TestCase
{
/**
* @return array<int, array{0: class-string}>
*/
public static function factoryClassProvider(): array
{
return [
[\MintyPHP\Service\Access\AccessServicesFactory::class],
[\MintyPHP\Module\AddressBook\Service\AddressBookServicesFactory::class],
[\MintyPHP\Service\Audit\AuditServicesFactory::class],
[\MintyPHP\Service\Auth\AuthServicesFactory::class],
[\MintyPHP\Service\Branding\BrandingServicesFactory::class],
[\MintyPHP\Service\Directory\DirectoryServicesFactory::class],
[\MintyPHP\Service\Import\ImportServicesFactory::class],
[\MintyPHP\Service\Mail\MailServicesFactory::class],
[\MintyPHP\Service\Scheduler\SchedulerServicesFactory::class],
[\MintyPHP\Service\Security\SecurityServicesFactory::class],
[\MintyPHP\Service\Settings\SettingServicesFactory::class],
[\MintyPHP\Service\Tenant\TenantServicesFactory::class],
[\MintyPHP\Service\User\UserServicesFactory::class],
];
}
#[DataProvider('factoryClassProvider')]
public function testContainerFactoriesCachePublicNoArgCreateMethods(string $factoryClass): void
{
$factory = app($factoryClass);
$this->assertInstanceOf($factoryClass, $factory);
$reflection = new ReflectionClass($factoryClass);
$methods = array_filter(
$reflection->getMethods(ReflectionMethod::IS_PUBLIC),
static fn (ReflectionMethod $method): bool =>
!$method->isStatic()
&& str_starts_with($method->getName(), 'create')
&& $method->getNumberOfRequiredParameters() === 0
);
usort($methods, static fn (ReflectionMethod $a, ReflectionMethod $b): int => strcmp($a->getName(), $b->getName()));
foreach ($methods as $method) {
$methodName = $method->getName();
$first = $factory->{$methodName}();
$second = $factory->{$methodName}();
$this->assertIsObject($first, sprintf('%s::%s() must return an object', $factoryClass, $methodName));
$this->assertInstanceOf($first::class, $second, sprintf('%s::%s() must be type-stable', $factoryClass, $methodName));
$this->assertSame($first, $second, sprintf('%s::%s() must return the cached instance', $factoryClass, $methodName));
}
}
}