Speak a shell destination's badge in words, and stop a null offset on PHP 8.5

<x-app-shell> passed no badge label to its rail and bar items, so a badge
like 0/3 reached a screen reader bare; a destination's badgeLabel now does.

The head script indexed the profiles with a null scheme when none are
configured, which PHP 8.5 reports as a deprecated null array offset on every
page with theme.meta on. It reads the default scheme without the lookup.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01RHoXZSHc8gGpZjFmA5fPc2

resources/boost/skills/livewire-material-development/SKILL.md

@@ -687,7 +687,7 @@ The adaptive app shell, a whole layout's body: a navigation bar below `sm`, a co
 </x-app-shell>
 ```
 
-- `destinations`: `title`, `icon`, `url`; optional `active` (default: the URL is the page's, also during a Livewire update request), `badge` (`true` for a dot, or a count), `section` (a heading in the rail, shown only while it is expanded; consecutive destinations with the same section are grouped), `bar` (default `true`; `false` keeps it out of the bottom bar — M3 wants three to five there), `navigate` (`false` for a full page load instead of `wire:navigate`).
+- `destinations`: `title`, `icon`, `url`; optional `active` (default: the URL is the page's, also during a Livewire update request), `badge` (`true` for a dot, or a count), `badgeLabel` (what a screen reader hears for the badge: "3 unread"), `section` (a heading in the rail, shown only while it is expanded; consecutive destinations with the same section are grouped), `bar` (default `true`; `false` keeps it out of the bottom bar — M3 wants three to five there), `navigate` (`false` for a full page load instead of `wire:navigate`).
 - Slots, each rendered once: `brand` (beside the rail's menu button, expanded only), `rail-header` (a FAB), `rail-footer` (pinned to the foot of the rail), `actions` (a row of icon buttons at the very foot, stacked when collapsed), `top` (the app bar, above the page at every width), and the page. `label` names the landmarks ("Main"); `rail-width` is the expanded width (`16rem`).
 - The rail is one element at every width: what is in it is also what a phone sees in the modal rail. Below `sm` nothing opens it but `$store.rail.show()`, so a page whose destinations are not all in the bar needs a menu button in its app bar (hidden from `sm`).
 - Below `sm` the shell sets `--material-bottom-bar` (the bar, the bottom safe area and `--material-bottom-extra`), so the snackbar, a `fab` button and the page's bottom padding clear the bar; pad anything else you pin to the bottom with it. See Safe areas.

resources/views/components/app-shell.blade.php

@@ -21,7 +21,8 @@
 
      `destinations` is a list of arrays: `title`, `icon` (a Material Symbol), `url`, and optionally
      `active` (by default: the URL is the page's; during a Livewire update request, the page the
-     component was rendered on rather than the update endpoint), `badge` (`true` for a dot, or a count),
+     component was rendered on rather than the update endpoint), `badge` (`true` for a dot, or a count), `badgeLabel` (what a screen reader hears for
+     the badge instead: "3 unread"),
      `section` (a heading the destination is grouped under in the rail; only an expanded rail shows
      it), `bar` (`false` keeps it out of the bottom bar; M3 wants three to five there) and
      `navigate` (`false` for a full page load instead of `wire:navigate`).
@@ -67,6 +68,7 @@
             'url' => $item['url'] ?? null,
             'active' => (bool) ($item['active'] ?? (filled($item['url'] ?? null) && rtrim(url($item['url']), '/') === rtrim($current, '/'))),
             'badge' => $item['badge'] ?? null,
+            'badgeLabel' => filled($item['badgeLabel'] ?? null) ? (string) $item['badgeLabel'] : null,
             'section' => filled($item['section'] ?? null) ? (string) $item['section'] : null,
             'bar' => ($item['bar'] ?? true) !== false,
             'navigate' => ($item['navigate'] ?? true) !== false,
@@ -105,12 +107,12 @@
             @if ($group->first()['section'] !== null)
                 <x-livewire-material::navigation-rail-section :label="$group->first()['section']">
                     @foreach ($group as $item)
-                        <x-livewire-material::navigation-rail-item :label="$item['title']" :icon="$item['icon']" :link="$item['url']" :active="$item['active']" :badge="$item['badge']" :no-wire-navigate="! $item['navigate']" />
+                        <x-livewire-material::navigation-rail-item :label="$item['title']" :icon="$item['icon']" :link="$item['url']" :active="$item['active']" :badge="$item['badge']" :badge-label="$item['badgeLabel']" :no-wire-navigate="! $item['navigate']" />
                     @endforeach
                 </x-livewire-material::navigation-rail-section>
             @else
                 @foreach ($group as $item)
-                    <x-livewire-material::navigation-rail-item :label="$item['title']" :icon="$item['icon']" :link="$item['url']" :active="$item['active']" :badge="$item['badge']" :no-wire-navigate="! $item['navigate']" />
+                    <x-livewire-material::navigation-rail-item :label="$item['title']" :icon="$item['icon']" :link="$item['url']" :active="$item['active']" :badge="$item['badge']" :badge-label="$item['badgeLabel']" :no-wire-navigate="! $item['navigate']" />
                 @endforeach
             @endif
         @endforeach
@@ -140,7 +142,7 @@
         <div data-app-shell-bar class="fixed inset-x-0 bottom-0 z-30 sm:hidden">
             <x-livewire-material::navigation-bar :label="$label">
                 @foreach ($barItems as $item)
-                    <x-livewire-material::navigation-bar-item :label="$item['title']" :icon="$item['icon']" :link="$item['url']" :active="$item['active']" :badge="$item['badge']" :no-wire-navigate="! $item['navigate']" />
+                    <x-livewire-material::navigation-bar-item :label="$item['title']" :icon="$item['icon']" :link="$item['url']" :active="$item['active']" :badge="$item['badge']" :badge-label="$item['badgeLabel']" :no-wire-navigate="! $item['navigate']" />
                 @endforeach
             </x-livewire-material::navigation-bar>
         </div>

resources/views/components/theme-script.blade.php

@@ -58,7 +58,8 @@
         $schemeProfiles = \NoNameWeb\LivewireMaterial\Support\Scheme::profiles();
 
         $settings['meta'] = [
-            ...$surfaces($schemeProfiles[$settings['scheme']] ?? \NoNameWeb\LivewireMaterial\Support\Scheme::load()),
+            // PHP 8.5 deprecates a null array offset: without profiles the scheme is null.
+            ...$surfaces(($settings['scheme'] !== null ? ($schemeProfiles[$settings['scheme']] ?? null) : null) ?? \NoNameWeb\LivewireMaterial\Support\Scheme::load()),
             'profiles' => (object) collect($schemeProfiles)->map($surfaces)->all(),
         ];
     }

tests/Feature/Components/AppShellTest.php

@@ -44,6 +44,16 @@ it('puts every destination in the rail and only those marked for the bar in the
         ->and(substr_count($html, 'aria-current="page"'))->toBe(2);
 });
 
+it('speaks a destination\'s badge in its own words when it has them', function () {
+    $html = (string) $this->blade('<x-app-shell :destinations="$destinations" />', ['destinations' => [
+        ['title' => 'Get started', 'icon' => 'rocket_launch', 'url' => '/start', 'badge' => '0/3', 'badgeLabel' => '0 of 3 done'],
+        ['title' => 'Inbox', 'icon' => 'inbox', 'url' => '/inbox', 'badge' => 4],
+    ]]);
+
+    expect($html)->toContain('0 of 3 done')
+        ->and(substr_count($html, '0 of 3 done'))->toBeGreaterThanOrEqual(2);
+});
+
 it('marks the destination at the current URL when none says it is active', function () {
     Route::get('/shell-probe/inbox', fn () => Blade::render('<x-app-shell :destinations="$destinations" />', ['destinations' => [
         ['title' => 'Inbox', 'icon' => 'inbox', 'url' => url('/shell-probe/inbox')],

tests/Feature/Components/ThemeScriptTest.php

@@ -107,3 +107,23 @@ it('gives the theme-color meta every profile\'s surfaces, the active one\'s firs
         File::delete($path);
     }
 });
+
+it('paints the meta without profiles and without a deprecation on PHP 8.5', function () {
+    config(['livewire-material.theme.meta' => true, 'livewire-material.profiles' => []]);
+
+    $deprecations = [];
+    set_error_handler(function (int $level, string $message) use (&$deprecations): bool {
+        $deprecations[] = $message;
+
+        return true;
+    }, E_DEPRECATED | E_USER_DEPRECATED);
+
+    try {
+        $html = (string) $this->blade('<x-theme-script />');
+    } finally {
+        restore_error_handler();
+    }
+
+    expect($html)->toContain('"meta":{')
+        ->and($deprecations)->toBe([]);
+});