Files
livewire-material/resources/views/components/grid.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

50 lines
2.3 KiB
PHP

{{-- Children in columns, inside a pane.
<x-grid :columns="['compact' => 1, 'medium' => 2, 'expanded' => 3]" gap="space300"></x-grid>
<x-grid min-item="280px" gap="space200"></x-grid>
`columns` is the column count per breakpoint `compact`, `medium` (600px), `expanded` (840),
`large` (1200), `extra-large` (1600), M3's (docs/reference/m3/foundations.md § Layout →
Breakpoints) — as a map, or one whole number for all of them. A breakpoint left out takes the
nearest smaller one's count, and compact is 1 unless given. All five are written on the grid as
`--md-columns-compact` `--md-columns-extra-large`, so a grid nested in another never inherits
its parent's.
`min-item` (`280px`, `18rem`, `20ch`, or a number of px) fills each row with as many columns as
fit at that width, which follows the room the grid has rather than the window — the right
choice inside a pane whose width is not the window's. With `columns` as well, the counts become
a ceiling. `gap` is a spacing token's name, `space25` … `space900`
(docs/reference/m3/styles-supplement.md § Spacing), none when left out or unknown. Children
keep their order, which is the reading order.
It takes `as`, `hide-below` and `hide-from` like every layout component, and the caller's
`class` and `style` land on it untouched (the caller's style after the column properties).
Drawn by resources/css/layout/grid.css. --}}
@props([
'as' => null,
'columns' => null,
'gap' => null,
'minItem' => null,
'hideBelow' => null,
'hideFrom' => null,
])
@php
$layout = \NoNameWeb\LivewireMaterial\Support\Layout::class;
$element = $layout::element($as);
$minItem = $layout::length($minItem);
$style = $layout::columnStyle($layout::columns($columns)).($minItem !== null ? " --md-min-item: {$minItem};" : '');
$attributes = $attributes->merge([
'data-md-grid' => true,
'data-md-gap' => $layout::spacing($gap),
'data-md-min-item' => $minItem !== null ? true : null,
'data-md-columns' => $minItem !== null && $columns !== null ? true : null,
'style' => $style,
] + $layout::visibility($hideBelow, $hideFrom));
@endphp
<{{ $element }} {{ $attributes }}>{{ $slot }}</{{ $element }}>