Files
livewire-material/tests/Feature/ShowcaseAssetsTest.php
T
Andreas Reinhold / reiniandClaude Opus 5 fb7007c976
tests / feature (8.4) (push) Successful in 2m0s
tests / feature (8.5) (push) Successful in 2m0s
tests / browser (chrome, chromium) (push) Failing after 8m3s
tests / browser (firefox, firefox) (push) Failing after 12m58s
tests / browser (safari, webkit) (push) Failing after 13m8s
Take Tailwind out of the package, and its detection out of the guard
Tailwind left the stack in 2.0.0, but the package still carried about 330
mentions of it. What the guard's Tailwind detection protected — a class
that compiles to nothing — is now protected by a check that does not care
where a dead class came from.

DesignGuard: about 500 lines of Tailwind tables, scales, palettes and
"2.0.0 replacement" hints give way to one check — a class a view or PHP
file writes that neither the application's stylesheets nor the package's
own declare. It catches a utility of any framework, a typo and a class
whose rules were deleted alike, so it also found two classes ReStride
draws nothing with. A stylesheet has to be in reach for it: the `.css`
files among the scanned paths, or what the `missingStylesheets()` entry
imports. The class reader no longer mistakes an array index for a class
list (`$block['base']`), and it reads the array a class helper is given,
where it read nothing before.

The package's own three Tailwind self-guards go with it. Only their one
unique check stays, as a test of its own: every `matchMedia` width in
resources/js is an M3 breakpoint.

The pagination views are `material.blade.php` and
`simple-material.blade.php`; only Laravel's and Livewire's default theme
names ever made them `tailwind`. The provider sets `Paginator`'s default
views and switches `livewire.pagination_theme` to `material` when it is
still Livewire's own default, so no application can forget the config; a
theme an application chose, and a component's own `$paginationTheme` or
`paginationView()`, still win.

The rest is prose: the layer-order guidance for an application that still
builds Tailwind, the Tailwind wording in the README, the Boost guidelines
and the development skill, and about 25 "this used to be a Tailwind
utility" comments, along with every "plan step NN" pointer into a
gitignored folder. The reset keeps its credit, and NOTICE now carries it
too.

Feature suite 1159 passed, Chrome browser suite 299 passed.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-17 21:07:39 +02:00

159 lines
6.8 KiB
PHP

<?php
use Illuminate\Support\Facades\Vite;
use Illuminate\Support\Str;
use NoNameWeb\LivewireMaterial\Http\Controllers\ShowcaseAssetController;
use NoNameWeb\LivewireMaterial\Support\Scheme;
use NoNameWeb\LivewireMaterial\Support\SchemeStylesheet;
/**
* The showcase's own stylesheet route: `all.css` plus `showcase.css`, prebuilt into
* resources/dist/showcase.css and served without the application's Vite build, and the two package
* folders its relative `url()`s point into.
*/
it('serves the bundle as long-cached CSS at the hash of its own content', function () {
$response = $this->get(ShowcaseAssetController::url())
->assertOk()
->assertHeader('Content-Type', 'text/css; charset=utf-8')
->assertHeader('Cache-Control', 'immutable, max-age=31536000, public');
expect($response->getContent())
->toContain('[data-md-showcase-brand]')
->toContain('[data-md-pane]')
->toContain('@layer material.reset, material.tokens');
});
it('redirects a hash that does not match the current bundle to the current one', function () {
$stale = route('livewire-material.stylesheet', ['hash' => '0000000000000000']);
$this->get($stale)->assertRedirect(ShowcaseAssetController::url());
});
it('serves the font and svg files the bundle references, mime-typed by extension', function () {
$css = $this->get(ShowcaseAssetController::url())->getContent();
// The stylesheet sits in assets/css/, so its relative `../fonts/…` and `../svg/…` land on the asset route.
expect(dirname(parse_url(ShowcaseAssetController::url(), PHP_URL_PATH)))->toBe(route('livewire-material.asset', ['path' => 'css'], false))
->and($css)->toContain("url('../fonts/google-sans-flex/GoogleSansFlex-Latin.woff2')")
->toContain('url("../svg/symbols/outlined/check.svg")');
$fontUrl = route('livewire-material.asset', ['path' => 'fonts/google-sans-flex/GoogleSansFlex-Latin.woff2'], false);
$svgUrl = route('livewire-material.asset', ['path' => 'svg/symbols/outlined/check.svg'], false);
$this->get($fontUrl)
->assertOk()
->assertHeader('Content-Type', 'font/woff2')
->assertHeader('Cache-Control', 'immutable, max-age=31536000, public');
$this->get($svgUrl)
->assertOk()
->assertHeader('Content-Type', 'image/svg+xml');
});
it('404s a path that climbs out of the two served folders', function () {
$this->get('/material/assets/fonts/../../composer.json')->assertNotFound();
});
it('404s every other way out of the two served folders', function (string $path) {
$this->get('/material/assets/'.$path)->assertNotFound();
})->with([
'encoded dot segments' => 'fonts/%2e%2e/%2e%2e/composer.json',
'encoded slashes' => 'fonts/..%2f..%2fcomposer.json',
'backslashes' => 'fonts/google-sans-flex/..%5c..%5c..%5ccomposer.json',
'an absolute path' => '/etc/hosts',
'an absolute path inside a folder' => 'fonts//etc/hosts',
'a null byte' => 'fonts/google-sans-flex/GoogleSansFlex-Latin.woff2%00.txt',
'a directory' => 'svg/symbols',
'a folder itself' => 'fonts/',
'a very long path' => 'fonts/'.str_repeat('a/', 3000).'x.woff2',
]);
it('404s a symbolic link inside a served folder that points out of it', function () {
$link = __DIR__.'/../../resources/svg/showcase-assets-test-link.svg';
symlink(realpath(__DIR__.'/../../composer.json'), $link);
try {
$this->get('/material/assets/svg/showcase-assets-test-link.svg')->assertNotFound();
} finally {
unlink($link);
}
});
it('404s a folder the showcase does not serve', function () {
$this->get('/material/assets/css/all.css')->assertNotFound();
});
it('404s an extension the showcase does not serve, even inside a served folder', function () {
$this->get('/material/assets/fonts/google-sans-flex/OFL.txt')->assertNotFound();
});
it('bundles the application generated scheme, unlayered, when one sits beside its configured JSON', function () {
$dir = sys_get_temp_dir().'/livewire-material-showcase-scheme-'.Str::random(8);
mkdir($dir);
file_put_contents($dir.'/material-scheme.css', ":root { --md-showcase-test-marker: #123456; }\n");
config(['livewire-material.scheme' => $dir.'/material-scheme.json']);
try {
$this->get(ShowcaseAssetController::url())
->assertOk()
->assertSee('--md-showcase-test-marker: #123456', false);
} finally {
unlink($dir.'/material-scheme.css');
rmdir($dir);
}
});
it('falls back to the scheme JSON in the generated shape when no generated stylesheet is found', function () {
config(['livewire-material.scheme' => sys_get_temp_dir().'/livewire-material-showcase-missing-'.Str::random(8).'.json']);
$css = $this->get(ShowcaseAssetController::url())->assertOk()->getContent();
expect($css)->toEndWith(SchemeStylesheet::withProfiles(...Scheme::forStylesheet()))
->toContain("[data-contrast='medium'][data-theme='dark']");
});
it('mounts none of the showcase asset routes when the showcase is off', function () {
putenv('MATERIAL_SHOWCASE=false');
$_ENV['MATERIAL_SHOWCASE'] = $_SERVER['MATERIAL_SHOWCASE'] = 'false';
$this->refreshApplication();
try {
$this->get('/material/assets/css/showcase.0000000000000000.css')->assertNotFound();
$this->get('/material/assets/fonts/google-sans-flex/GoogleSansFlex-Latin.woff2')->assertNotFound();
} finally {
putenv('MATERIAL_SHOWCASE=true');
$_ENV['MATERIAL_SHOWCASE'] = $_SERVER['MATERIAL_SHOWCASE'] = 'true';
$this->refreshApplication();
}
});
it('passes Vite the application entries but its stylesheets, on every kind of showcase page', function () {
$hot = sys_get_temp_dir().'/livewire-material-showcase-hot-'.Str::random(8);
file_put_contents($hot, 'http://vite.test');
Vite::useHotFile($hot);
config(['livewire-material.showcase.vite' => ['resources/css/app.css', 'resources/sass/extra.scss', 'resources/js/app.js']]);
try {
expect(ShowcaseAssetController::scripts())->toBe(['resources/js/app.js']);
foreach (['/material', '/material/progress', '/material/layout/feed', '/material/shell'] as $page) {
$this->get($page)
->assertOk()
->assertSee('http://vite.test/resources/js/app.js', false)
->assertDontSee('http://vite.test/resources/css/app.css', false)
->assertDontSee('http://vite.test/resources/sass/extra.scss', false)
->assertSee(ShowcaseAssetController::url(), false);
}
// A list of stylesheets alone leaves @vite() out, rather than reading a manifest for nothing.
config(['livewire-material.showcase.vite' => ['resources/css/app.css']]);
expect(ShowcaseAssetController::scripts())->toBe([]);
$this->get('/material/progress')->assertOk()->assertDontSee('http://vite.test', false);
} finally {
unlink($hot);
}
});