Serve the showcase's own stylesheet without the application's build

Plan step 38 (first batch): a route bundles all.css, showcase.css and the application's generated scheme (Stylesheets::bundle(), found next to its configured JSON by swapping the extension, or a Scheme::load() fallback in tokens/scheme.css's own shape) into one long-cached, content-hashed CSS response; a stale hash redirects to the current one. A second route serves the fonts and SVGs its relative url()s point at, from the package's fonts/ and svg/ folders only, MIME-typed by extension and 404ing on ".." or an unlisted extension. Both stay unregistered with the showcase off. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Qwx5USif3wFFmxtHg5U1g9
2026-09-15 03:55:05 +02:00
parent bce55b26a2
commit 1c8a4d412a
3 changed files with 298 additions and 0 deletions
@@ -0,0 +1,106 @@
+<?php
+
+use Illuminate\Support\Str;
+use NoNameWeb\LivewireMaterial\Http\Controllers\ShowcaseAssetController;
+use NoNameWeb\LivewireMaterial\Support\Stylesheets;
+
+/**
+ * The showcase's own stylesheet route (plan step 38): `all.css` plus `showcase.css`, bundled by
+ * `Stylesheets::bundle()` and served without the application's Vite build, and the two package
+ * folders its relative `url()`s point into.
+ */
+afterEach(function () {
+    Stylesheets::resetCache();
+});
+
+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]')
+        ->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();
+
+    $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);
+
+    expect($css)->toContain($fontUrl)->toContain($svgUrl);
+
+    $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 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']);
+    Stylesheets::resetCache();
+
+    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 Scheme::load() in the default shape when no generated stylesheet is found', function () {
+    config(['livewire-material.scheme' => sys_get_temp_dir().'/livewire-material-showcase-missing-'.Str::random(8).'.json']);
+    Stylesheets::resetCache();
+
+    $css = $this->get(ShowcaseAssetController::url())->assertOk()->getContent();
+
+    // The fallback's own one-line selector list, distinct from tokens/scheme.css's multi-line one
+    // (already in all.css), so its presence here can only come from the appended fallback block.
+    expect($css)->toContain("[data-contrast='medium'], [data-contrast='medium'][data-theme='light'], [data-contrast='medium'] [data-theme='light']");
+});
+
+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/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();
+    }
+});