import { describe, expect, it, vi } from "vitest"; import { AdminSidebar } from "./AdminSidebar"; import { AppSidebar } from "./AppSidebar"; import { DocsSidebar } from "./DocsSidebar"; import type { SideBarItem } from "./SidebarItem"; import { UI_NAV_IDS, UI_SURFACE_IDS } from "~/application/ui/uiRegistry"; function flattenSidebarItems(items: SideBarItem[]): SideBarItem[] { return items.flatMap((item) => [item, ...flattenSidebarItems(item.items ?? [])]); } function expectCompleteUniqueIds(items: SideBarItem[]) { const flattened = flattenSidebarItems(items); const ids = flattened.map((item) => item.id); expect(ids).not.toContain(undefined); expect(ids.every((id) => id?.startsWith("ui."))).toBe(true); expect(new Set(ids).size).toBe(ids.length); } function expectStaticItemsHaveIds(items: SideBarItem[]) { const staticItems = flattenSidebarItems(items).filter((item) => !item.uiIdPattern); expect(staticItems.length).toBeGreaterThan(0); expect(staticItems.every((item) => typeof item.id === "string" && item.id.length > 0)).toBe(true); } function expectDynamicItemsHavePatternMetadata(items: SideBarItem[]) { const dynamicItems = flattenSidebarItems(items).filter((item) => item.uiIdPattern); expect(dynamicItems.every((item) => item.id && item.uiIdPattern && item.uiIdParams && Object.keys(item.uiIdParams).length > 0)).toBe(true); } describe("sidebar UI IDs", () => { const t = vi.fn().mockImplementation((v: string) => v) as any; const i18n = { exists: vi.fn().mockReturnValue(false) } as any; it("defines the primary sidebar surface IDs", () => { expect(UI_SURFACE_IDS.appSidebar).toBe("ui.surface.app.sidebar"); expect(UI_SURFACE_IDS.adminSidebar).toBe("ui.surface.admin.sidebar"); expect(UI_SURFACE_IDS.docsSidebar).toBe("ui.surface.docs.sidebar"); }); it("assigns unique IDs to admin sidebar items", () => { const sidebar = AdminSidebar({ t, appConfiguration: null }); const ids = flattenSidebarItems(sidebar).map((item) => item.id); expectCompleteUniqueIds(sidebar); expectStaticItemsHaveIds(sidebar); expect(ids).toContain(UI_NAV_IDS.adminDashboard); expect(ids).toContain(UI_NAV_IDS.adminSettings); }); it("assigns unique IDs to app sidebar static items", () => { // R-P6B-β (AD-2): the generic entity-builder is gone, so AppSidebar no longer // renders dynamic per-entity / entity-group items. const sidebar = AppSidebar({ t, i18n, tenantId: "acme", appConfiguration: null }); const ids = flattenSidebarItems(sidebar).map((item) => item.id); expectCompleteUniqueIds(sidebar); expectStaticItemsHaveIds(sidebar); expectDynamicItemsHavePatternMetadata(sidebar); expect(ids).toContain(UI_NAV_IDS.appDashboard); expect(ids).toContain(UI_NAV_IDS.appSettings); expect(ids).not.toContain("ui.nav.app.entity.contacts"); expect(ids.some((id) => id?.startsWith("ui.nav.app.entity."))).toBe(false); expect(ids.some((id) => id?.startsWith("ui.nav.app.entityGroup."))).toBe(false); }); it("assigns unique IDs to docs sidebar items", () => { const sidebar = DocsSidebar(); const ids = flattenSidebarItems(sidebar).map((item) => item.id); expectCompleteUniqueIds(sidebar); expectStaticItemsHaveIds(sidebar); expectDynamicItemsHavePatternMetadata(sidebar); expect(ids).toContain(UI_NAV_IDS.docsIntroduction); expect(ids).toContain("ui.nav.docs.componentsButtons"); const removedDocsPrefix = ["ui.nav.docs.page", "Blocks."].join(""); expect(ids.some((id) => id?.startsWith(removedDocsPrefix))).toBe(false); }); });