Files
InvoiceShelf/tests/Feature/Company/Modules/BootstrapModuleMenuTest.php
Darko Gjorgjijoski 7885bf9d11 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.
2026-04-11 00:30:00 +02:00

86 lines
2.7 KiB
PHP

<?php
use App\Models\User;
use Illuminate\Support\Facades\Artisan;
use InvoiceShelf\Modules\Registry;
use Laravel\Sanctum\Sanctum;
use function Pest\Laravel\getJson;
beforeEach(function () {
Artisan::call('db:seed', ['--class' => 'DatabaseSeeder', '--force' => true]);
Artisan::call('db:seed', ['--class' => 'DemoSeeder', '--force' => true]);
$user = User::find(1);
$this->withHeaders([
'company' => $user->companies()->first()->id,
]);
Sanctum::actingAs($user, ['*']);
Registry::flush();
});
afterEach(function () {
Registry::flush();
});
test('bootstrap merges module menu items into main_menu', function () {
Registry::registerMenu('sales-tax-us', [
'title' => 'sales_tax_us::menu.title',
'link' => '/admin/modules/sales-tax-us/settings',
'icon' => 'CalculatorIcon',
]);
$response = getJson('api/v1/bootstrap')->assertOk();
$mainMenu = collect($response->json('main_menu'));
$moduleItem = $mainMenu->firstWhere('name', 'module-sales-tax-us');
expect($moduleItem)->not->toBeNull();
expect($moduleItem['link'])->toBe('/admin/modules/sales-tax-us/settings');
expect($moduleItem['icon'])->toBe('CalculatorIcon');
expect($moduleItem['group'])->toBe('modules');
});
test('module items support custom group and priority', function () {
Registry::registerMenu('sales-tax-us', [
'title' => 'sales_tax_us::menu.title',
'link' => '/admin/modules/sales-tax-us/settings',
'icon' => 'CalculatorIcon',
'group' => 'documents',
'priority' => 25,
]);
$response = getJson('api/v1/bootstrap')->assertOk();
$mainMenu = collect($response->json('main_menu'));
$moduleItem = $mainMenu->firstWhere('name', 'module-sales-tax-us');
expect($moduleItem['group'])->toBe('documents');
expect($moduleItem['priority'])->toBe(25);
});
test('bootstrap has no module items when nothing is registered', function () {
$response = getJson('api/v1/bootstrap')->assertOk();
$mainMenu = collect($response->json('main_menu'));
$moduleItems = $mainMenu->filter(fn ($item) => str_starts_with($item['name'], 'module-'));
expect($moduleItems)->toBeEmpty();
});
test('admin-mode bootstrap does not include module items', function () {
Registry::registerMenu('sales-tax-us', [
'title' => 'sales_tax_us::menu.title',
'link' => '/admin/modules/sales-tax-us/settings',
'icon' => 'CalculatorIcon',
]);
$response = getJson('api/v1/bootstrap?admin_mode=1');
$mainMenu = collect($response->json('main_menu'));
$moduleItems = $mainMenu->filter(fn ($item) => str_starts_with($item['name'] ?? '', 'module-'));
expect($moduleItems)->toBeEmpty();
});