Files
livewire-material/resources/views/components/surface.blade.php
T
Andreas Reinhold / reiniandClaude Opus 5 247c596c3a Cut duplicated and speculative code across the package
An over-engineering audit of the whole tree, applied in five reviewed
batches. Behaviour stays the same except where UPGRADE.md says otherwise.

PHP: the showcase and error-page stylesheets are prebuilt into
resources/dist by bin/stylesheets.mjs, through Vite's own postcss-import
(first occurrence kept, the order an application's build gives), instead
of Stylesheets::bundle() inlining imports on every request; only the
import walk DesignGuard needs stays. SchemeStylesheet::withProfiles()
replaces three copies of the scheme-plus-profiles loop, material:scheme
leaves spec and contrast checks to the node script that already made
them, and the error page's scheme cache, the hashed view namespace, the
translations path with no lang/ folder and DesignGuard's 1.x-name hints
are gone.

JS: the androidx shape port progress.js and both bin scripts each carried
lives once in resources/js/shapes.js (the generated SVGs are unchanged);
util.js holds ringIndex(), ms(), reopenGuard() and remember(), which
were written out several times; listeners are released through
AbortController; tooltip.js's hoverPopover() serves the rich tooltip too.

CSS: every rule for an element inside the navigation rail queries
`--md-navigation-rail-value` instead of repeating the seven collapsed
conditions under five media branches; badge, alert, progress, slider and
button read one non-inheriting colour-role table (components/color.css);
the dialog chrome, the submenu's popover chrome, the chip's state layer
and touch target, and the visually-hidden inputs use the shared rules
they copied; foundation/tokens.css is folded into foundation.css.

Views: Support\Field and Support\Link replace the error-key, bound-value
and link-attribute blocks copied into the fields and link components;
the timepicker period group, the menu filter and the showcase head are
partials; the datepicker's steppers and entry fields are loops; component
docblocks no longer restate SKILL.md.

Tests and tooling: one dataset-driven ComponentStylesheetsTest replaces
four per-group files, DesignGuardTest and the layout-component tests use
datasets, browser tests share one ready() helper, CSS parsing lives in
ComponentStylesheet alone. docs/audits and the finding IDs citing it are
removed, as are pestphp/pest-plugin-laravel, the unused composer scripts
and check:font; the lint job runs in the feature job, which now installs
node packages so the prebuilt-stylesheet staleness test runs in CI.

Feature suite 1177 passed, Chrome browser suite 299 passed.

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

49 lines
2.3 KiB
PHP

{{-- A tonal region: M3's surface, or a step of its surface containers.
<x-surface level="surface-container-low" padding="space300" corner="lg" outlined>…</x-surface>
`level` is the colour role it is filled with: `surface`, `surface-dim`, `surface-bright`,
`surface-container-lowest`, `surface-container-low`, `surface-container` (the default),
`surface-container-high` or `surface-container-highest`; the text on it is `on-surface`
(docs/reference/m3/styles.md § Color). Higher steps read as nearer, which is how M3 sets
regions apart without a shadow. An unknown level is the default.
`padding` is a spacing token's name, `space25` `space900`
(docs/reference/m3/styles-supplement.md § Spacing); anything else is no padding. `corner` is a
corner token, `none`, `xs`, `sm`, `md`, `lg`, `lg-increased`, `xl`, `xl-increased`, `xxl` or
`full` (resources/css/tokens/shape.css); anything else leaves it square. `outlined` draws
the 1dp outline-variant edge.
Like every layout component it takes `as` (the element, `div` by default: `section`,
`article`, `aside` ) and `hide-below` / `hide-from` (`medium`, `expanded`, `large` or
`extra-large`), and the caller's `class` and `style` land on it untouched. Drawn by
resources/css/layout/surface.css; the props are read in src/Support/Layout.php. --}}
@props([
'as' => null,
'level' => null,
'padding' => null,
'corner' => null,
'outlined' => false,
'hideBelow' => null,
'hideFrom' => null,
])
@php
$layout = \NoNameWeb\LivewireMaterial\Support\Layout::class;
$element = $layout::element($as);
$attributes = $attributes->merge([
'data-md-surface' => true,
'data-md-level' => $layout::choice($level, [
'surface', 'surface-dim', 'surface-bright', 'surface-container-lowest', 'surface-container-low',
'surface-container', 'surface-container-high', 'surface-container-highest',
], 'surface-container'),
'data-md-padding' => $layout::spacing($padding),
'data-md-corner' => $layout::choice($corner, ['none', 'xs', 'sm', 'md', 'lg', 'lg-increased', 'xl', 'xl-increased', 'xxl', 'full']),
'data-md-outlined' => $outlined ? true : null,
] + $layout::visibility($hideBelow, $hideFrom));
@endphp
<{{ $element }} {{ $attributes }}>{{ $slot }}</{{ $element }}>