refactor/fix: improve panel registration, toolbar lifecycle, AJAX tracking, accessibility, and shared asset handling.

README.md

@@ -67,7 +67,16 @@ The adapter-facing API is documented in the source PHPDoc under `src/`.
 
 ## Frontend development
 
-The frontend source lives in `resources/src` and Vite builds it into `resources/assets/dist`. Rebuild and verify with:
+The frontend source lives in `resources/src` and Vite builds it into `resources/assets/dist`. Two entries are built:
+
+- `resources/src/toolbar/index.js` — the `<yii-debug-toolbar>` custom element. `element.js` owns the view state, the
+  shadow skeleton, and the render cycle; it composes one controller per responsibility (`loader.js`,
+  `theme-controller.js`, `drawer.js`) and renders through the stateless builders in `render.js`.
+- `resources/src/core/debug.js` — the debugger page bootstrap. It resolves the theme, initializes the page
+  controllers (`theme.js`, `disclosure.js`, `live-filter.js`, `grid-navigation.js`, `tabs.js`, `deep-links.js`,
+  `clipboard.js`, `features.js`), and owns the keyboard precedence between the layers.
+
+Rebuild and verify with:
 
 ```bash
 npm install
@@ -76,8 +85,13 @@ npm run lint:js
 npm run lint:css
 npm run test:js
 npm run build
+npm run check:size
+npm run check:icons
 ```
 
+`check:icons` compares the toolbar's inline glyphs with `resources/assets/svg`; the toolbar-only chrome glyphs
+(`chevron-left`, `chevron-right`, `close`, `external-link`) have no panel file by design and never fail `--strict`.
+
 ## Package information
 
 [![PHP](https://img.shields.io/badge/%3E%3D8.3-777BB4.svg?style=for-the-badge&logo=php&logoColor=white)](https://www.php.net/releases/8.3/en.php)

composer.json

@@ -29,7 +29,7 @@
         "ui-awesome/html-interop": "^0.4",
         "ui-awesome/html-mixin": "^0.8.2",
         "ui-awesome/html-svg": "^0.6",
-        "php-forge/debug": "^0.2"
+        "php-forge/debug": "^0.3"
     },
     "require-dev": {
         "infection/infection": "^0.35",
@@ -40,9 +40,7 @@
         "phpstan/phpstan-strict-rules": "^2.0.3",
         "phpunit/phpunit": "^12.5",
         "xepozz/internal-mocker": "^1.4",
-        "yii2-extensions/scaffold": "^0.2",
-        "php-forge/vite": "^0.2",
-        "php-forge/inertia": "^0.2"
+        "yii2-extensions/scaffold": "^0.2"
     },
     "autoload": {
         "psr-4": {

package.json

@@ -19,6 +19,8 @@
     "check:contrast": "node tools/check-token-contrast.mjs",
     "check:contrast:strict": "node tools/check-token-contrast.mjs --strict",
     "check:css-vocabulary": "node tools/check-css-vocabulary.mjs",
+    "check:icons": "node tools/check-icons.mjs",
+    "check:icons:strict": "node tools/check-icons.mjs --strict",
     "contact-sheet": "node tools/contact-sheet.mjs",
     "test:events": "DEBUG_UI_SEED_FIXTURES=0 playwright test e2e/events.spec.js",
     "test:e2e": "playwright test e2e/smoke.spec.js e2e/security.spec.js e2e/db-controls.spec.js e2e/history-layout.spec.js",