{{-- Theme-mode toggle-button wiring. Runs at the bottom of the page. Wires up the click handler on [data-theme-toggle] (the sun/moon button in the app header), updates its label/icon based on the current theme, and persists the user's choice to localStorage. The initial data-theme application happens in partials/theme-mode-preflight.blade.php (loaded in ) so this script does NOT need to worry about FOUT on first paint. It just hydrates the button state and attaches the toggle behavior. Only included from layouts/default.blade.php. layouts/basic.blade.php has no toggle button (login and error pages honor system/stored preference silently). --}}