Files
livewire-material/tests/Feature/InternalComponentsTest.php
Andreas Reinhold / reiniandClaude Sonnet 5 6f0e430804 Recognise a semicolon-terminated example heredoc as documented usage
InternalComponentsTest strips a showcase example's <<<'BLADE' heredoc
before checking that a package view only ever refers to its own
components through the livewire-material:: namespace, since an
example heredoc documents an application's own (unprefixed) usage.
The check only recognised an array's BLADE, terminator; the Layout
section's three dedicated pages (plan step 38) assign their one
example to $code with BLADE; instead, which the check now strips too.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Qwx5USif3wFFmxtHg5U1g9
2026-09-15 04:24:24 +02:00

77 lines
3.4 KiB
PHP

<?php
use Illuminate\Support\Facades\Blade;
use Illuminate\Support\Facades\File;
use Illuminate\Support\Facades\View;
use NoNameWeb\LivewireMaterial\LivewireMaterialServiceProvider;
/**
* The package's own component names, longest first.
*
* @return list<string>
*/
function packageComponentNames(): array
{
return collect(File::files(LivewireMaterialServiceProvider::componentPath()))
->map(fn (SplFileInfo $file): string => $file->getBasename('.blade.php'))
->sortByDesc(fn (string $name): int => strlen($name))
->values()
->all();
}
it('refers to its own components through its namespace, which no prefix or app component changes', function () {
$names = implode('|', array_map(fn (string $name): string => preg_quote($name, '/'), packageComponentNames()));
$unqualified = collect(File::allFiles(__DIR__.'/../../resources/views'))
->filter(fn (SplFileInfo $file): bool => str_ends_with($file->getFilename(), '.blade.php'))
->flatMap(function (SplFileInfo $file) use ($names): array {
// Comments document usage as an application writes it, and the showcase's examples
// are that usage; neither is compiled as the package's own markup. An example heredoc
// ends `BLADE,` as an array's value (most sections) or `BLADE;` assigned to its own
// variable (a Layout page with a single example of its own, plan step 38).
$source = preg_replace(['/\{\{--.*?--\}\}/s', "/<<<'BLADE'.*?^\\s*BLADE[,;]/sm"], '', $file->getContents());
preg_match_all('/<\/?x-('.$names.')(?=[\s\/>])/', $source, $matches);
return array_map(fn (string $tag): string => $file->getRelativePathname().': '.$tag, $matches[0]);
})
->values();
expect($unqualified->all())->toBe([]);
});
it('renders components that use others under a prefix', function () {
config(['livewire-material.prefix' => 'm']);
Blade::anonymousComponentPath(LivewireMaterialServiceProvider::componentPath(), 'm');
expect(Blade::render('<x-m::drawer title="Share" with-close-button separator><x-m::input label="Name" clearable /></x-m::drawer>'))
->toContain('aria-label="Close"')
->toContain('role="separator"')
->toContain('data-md-field-clear');
});
it('is not shadowed by an application component of the same name', function () {
$views = sys_get_temp_dir().'/livewire-material-shadow-'.uniqid();
File::ensureDirectoryExists($views.'/components');
File::put($views.'/components/button.blade.php', '<span>the application\'s button</span>');
View::getFinder()->prependLocation($views);
try {
expect(Blade::render('<x-button />'))->toContain('the application\'s button')
->and(Blade::render('<x-drawer title="Share" with-close-button />'))->not->toContain('the application\'s button')
->toContain('aria-label="Close"');
} finally {
File::deleteDirectory($views);
}
});
it('shows the showcase\'s examples as an application with a prefix writes them', function () {
config(['livewire-material.prefix' => 'm']);
Blade::anonymousComponentPath(LivewireMaterialServiceProvider::componentPath(), 'm');
expect(Blade::render('<x-showcase::example title="Buttons" :code="$code" />', ['code' => '<x-button label="Save" />']))
->toContain('&lt;x-m::button label=&quot;Save&quot; /&gt;')
->toContain('Save</span>');
});