Andreas Reinhold / reiniandClaude Opus 5
247c596c3a
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>
89 lines
4.1 KiB
PHP
89 lines
4.1 KiB
PHP
{{-- A pane: a content region with M3's margins, and its own top app bar if it has a title.
|
||
|
||
<x-pane title="Settings" subtitle="Your account" width="narrow">
|
||
<x-slot:actions><x-button icon="help" tooltip="Help" /></x-slot:actions>
|
||
<x-slot:navigation><x-section-nav :items="$sections" /></x-slot:navigation>
|
||
…
|
||
</x-pane>
|
||
|
||
M3 puts every piece of content in a pane and lets each carry its own top app bar
|
||
(docs/reference/m3/foundations.md § Layout → Scaffold). The body is kept off the window's edge
|
||
by M3's margin, 16px below medium (600px) and 24px from it
|
||
(docs/reference/m3/foundations-supplement.md § Breakpoints); a pane inside something that
|
||
already keeps that margin — the scaffold's content region, a canonical layout, another pane's
|
||
body — draws none, so the margin is never doubled; on an `<x-surface>` it draws it again.
|
||
|
||
`width` caps the pane and centres it: `narrow` (40rem, M3's 40–60 characters a line),
|
||
`medium` (60rem), `wide` (80rem) or `full` (the default, all the room it has).
|
||
|
||
The app bar is `<x-app-bar>`, drawn when there is a `title`, `actions`, a `leading` slot or
|
||
`back`: `title` and `subtitle`, `heading` (`h1` by default; the second pane of a canonical
|
||
layout passes `h2`), `sticky` (true: it holds to the top of the window for as long as the pane
|
||
is on screen), the `actions` slot at its end. Its leading icon button is the `leading` slot,
|
||
or `back`: a URL makes it a link back there, and `true` calls `back()` in the Alpine scope
|
||
around it, which `<x-list-detail>` provides — and which it hides where both panes show, as M3
|
||
shows a back button only in a single-pane list-detail. The back arrow mirrors in a
|
||
right-to-left document.
|
||
|
||
`navigation` is the pane's section navigation (`<x-section-nav>`, `<x-tabs>`), under the bar
|
||
and above the body, with the body's margins; it is not the bar's leading button.
|
||
|
||
It takes `as` (`div` by default: `section`, `article`, `main` …), `hide-below` and `hide-from`
|
||
like every layout component, and the caller's `class` and `style` land on it untouched. Drawn
|
||
by resources/css/layout/pane.css. --}}
|
||
|
||
@props([
|
||
'as' => null,
|
||
'title' => null,
|
||
'subtitle' => null,
|
||
'heading' => 'h1',
|
||
'sticky' => true,
|
||
'back' => null,
|
||
'width' => null,
|
||
'hideBelow' => null,
|
||
'hideFrom' => null,
|
||
])
|
||
|
||
@php
|
||
$layout = \NoNameWeb\LivewireMaterial\Support\Layout::class;
|
||
$element = $layout::element($as);
|
||
$backLink = is_string($back) && $back !== '' ? $back : null;
|
||
$backAction = $back === true;
|
||
$bar = filled($title) || isset($actions) || isset($leading) || $backLink !== null || $backAction;
|
||
|
||
$attributes = $attributes->merge([
|
||
'data-md-pane' => true,
|
||
'data-md-width' => $layout::choice($width, ['full', 'narrow', 'medium', 'wide']),
|
||
] + $layout::visibility($hideBelow, $hideFrom));
|
||
@endphp
|
||
|
||
<{{ $element }} {{ $attributes }}>
|
||
@if ($bar)
|
||
<x-livewire-material::app-bar :title="$title" :subtitle="$subtitle" :heading="$heading" :sticky="$sticky" data-md-pane-bar>
|
||
@if (isset($leading))
|
||
<x-slot:navigation>{{ $leading }}</x-slot:navigation>
|
||
@elseif ($backLink !== null || $backAction)
|
||
<x-slot:navigation>
|
||
<span data-md-pane-back @if ($backAction) data-md-list-detail-back @endif>
|
||
@if ($backLink !== null)
|
||
<x-livewire-material::button icon="arrow_back" :tooltip="__('Back')" :link="$backLink" />
|
||
@else
|
||
<x-livewire-material::button icon="arrow_back" :tooltip="__('Back')" x-on:click="back()" />
|
||
@endif
|
||
</span>
|
||
</x-slot:navigation>
|
||
@endif
|
||
|
||
@isset($actions)
|
||
<x-slot:actions>{{ $actions }}</x-slot:actions>
|
||
@endisset
|
||
</x-livewire-material::app-bar>
|
||
@endif
|
||
|
||
@isset($navigation)
|
||
<div data-md-pane-navigation>{{ $navigation }}</div>
|
||
@endisset
|
||
|
||
<div data-md-pane-body>{{ $slot }}</div>
|
||
</{{ $element }}>
|