feat(menu): priority-sorted menu groups, user-menu items, sidebar appearance toggle

Every main_menu entry moves from numeric group (1/2/3) to string-based group + group_label + priority. Groups now carry their own i18n label and child entries are sorted by an explicit priority field instead of config-array order, so module-contributed menu items can slot into any existing group at any position.

BootstrapController merges module-registered menu items into main_menu (previously they lived in a separate module_menu response key) and introduces a user_menu response key for items modules want to place in the avatar dropdown. The global store follows suit: moduleMenu becomes userMenu, menuGroups is a computed that sorts by priority, and hasActiveModules drops out.

New admin Appearance setting page with a single toggle for whether sidebar group labels render — so instances that prefer a compact sidebar can hide the Documents/Administration/Modules headings without losing the grouping itself. CompanyLayout watches route meta and re-bootstraps when the admin-mode flag flips so the sidebar repaints with the right menu on navigation across the admin boundary.

Test suites updated: module menu merging is asserted against main_menu (name: 'module-{slug}') rather than the old module_menu response; HelloWorldIntegrationTest verifies the schema translation path; CompanyModulesIndexTest covers the display_name attachment.

tests/Feature/Company/Modules/HelloWorldIntegrationTest.php

@@ -4,7 +4,6 @@ use App\Models\CompanySetting;
 use App\Models\Module;
 use App\Models\User;
 use Illuminate\Support\Facades\Artisan;
-use InvoiceShelf\Modules\Registry;
 use Laravel\Sanctum\Sanctum;
 
 use function Pest\Laravel\getJson;
@@ -14,7 +13,7 @@ use function Pest\Laravel\putJson;
  * Integration test that exercises the real Modules/HelloWorld module end-to-end
  * — no Registry mocking. Proves that when an active module's ServiceProvider
  * registers menu + settings via InvoiceShelf\Modules\Registry, the host app's
- * bootstrap, company-modules index, and settings controllers all surface it.
+ * company-modules index and settings controllers surface it consistently.
  *
  * The HelloWorld module's provider boots automatically because nwidart sees
  * it in `storage/app/modules_statuses.json` (set to enabled when the module
@@ -39,18 +38,19 @@ beforeEach(function () {
     );
 });
 
-test('HelloWorld registers a menu entry visible in bootstrap', function () {
+test('bootstrap merges HelloWorld into main_menu under modules group', function () {
     $response = getJson('api/v1/bootstrap')->assertOk();
 
-    $menu = collect($response->json('module_menu'));
-    $entry = $menu->firstWhere('link', '/admin/modules/hello-world/settings');
+    $mainMenu = collect($response->json('main_menu'));
+    $helloWorld = $mainMenu->firstWhere('name', 'module-hello-world');
 
-    expect($entry)->not->toBeNull();
-    expect($entry['title'])->toBe('helloworld::menu.title');
-    expect($entry['icon'])->toBe('HandRaisedIcon');
+    expect($helloWorld)->not->toBeNull();
+    expect($helloWorld['link'])->toBe('/admin/modules/hello-world/dashboard');
+    expect($helloWorld['icon'])->toBe('HandRaisedIcon');
+    expect($helloWorld['group'])->toBe('modules');
 });
 
-test('HelloWorld appears in the company Active Modules index with has_settings flag', function () {
+test('HelloWorld appears in the company Active Modules index with translated display name', function () {
     $response = getJson('api/v1/company-modules')->assertOk();
 
     // The DB row stores PascalCase but the controller normalizes to kebab-case
@@ -58,20 +58,23 @@ test('HelloWorld appears in the company Active Modules index with has_settings f
     $row = collect($response->json('data'))->firstWhere('slug', 'hello-world');
     expect($row)->not->toBeNull();
     expect($row['name'])->toBe('HelloWorld');
+    expect($row['display_name'])->toBe('Hello World');
     expect($row['has_settings'])->toBeTrue();
+    expect($row['menu']['title'])->toBe('Hello World');
     expect($row['menu']['icon'])->toBe('HandRaisedIcon');
 });
 
-test('GET module settings returns the HelloWorld schema with defaults', function () {
+test('GET module settings returns the translated HelloWorld schema with defaults', function () {
     $response = getJson('api/v1/modules/hello-world/settings')->assertOk();
 
     $sections = $response->json('schema.sections');
     expect($sections)->toHaveCount(2);
-    expect($sections[0]['title'])->toBe('helloworld::settings.greeting_section');
+    expect($sections[0]['title'])->toBe('Greeting');
 
     $fields = collect($sections[0]['fields'])->keyBy('key');
     expect($fields)->toHaveKeys(['greeting', 'recipient', 'show_emoji']);
     expect($fields['greeting']['type'])->toBe('text');
+    expect($fields['greeting']['label'])->toBe('Greeting message');
     expect($fields['greeting']['rules'])->toContain('required');
 
     // Defaults flow through when nothing has been saved yet