@icomponents/shell 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,89 @@
1
+ import { describe, expect, it } from "bun:test";
2
+
3
+ import { renderToStaticMarkup } from "react-dom/server";
4
+
5
+ import { DashboardShell } from "./dashboard-shell";
6
+ import type { PlatformModule } from "./nav";
7
+
8
+ const MODULES: PlatformModule[] = [
9
+ {
10
+ id: "admin",
11
+ titleKey: "admin",
12
+ title: { ru: "Управление", en: "Management" },
13
+ href: "/admin",
14
+ project: "admin",
15
+ groupKey: "groupPlatform",
16
+ },
17
+ {
18
+ id: "talent",
19
+ titleKey: "talent",
20
+ title: { ru: "Таланты", en: "Talents" },
21
+ href: "/talent",
22
+ project: "talent",
23
+ groupKey: "groupHiring",
24
+ },
25
+ {
26
+ id: "pay",
27
+ titleKey: "pay",
28
+ title: { ru: "Расчёты", en: "Payments" },
29
+ href: "/pay",
30
+ project: "pay",
31
+ groupKey: "groupWork",
32
+ },
33
+ ];
34
+ const SECTIONS = [
35
+ { key: "jobs", href: "/talent/jobs", title: "Вакансии" },
36
+ { key: "rates", href: "/talent/rates", title: "Ставки" },
37
+ ];
38
+
39
+ const render = (roles: string[] | null, pathname = "/talent/jobs") =>
40
+ renderToStaticMarkup(
41
+ <DashboardShell
42
+ pathname={pathname}
43
+ roles={roles}
44
+ t={(key) => `«${key}»`}
45
+ brandTitle="Платформа"
46
+ modules={MODULES}
47
+ sections={SECTIONS}
48
+ sectionsGroupKey="groupModule"
49
+ >
50
+ экран
51
+ </DashboardShell>
52
+ );
53
+
54
+ const ALL = ["admin:user", "talent:manager", "pay:admin"];
55
+ const at = (html: string, needle: string) => html.indexOf(needle);
56
+
57
+ describe("сайдбар: цельное меню модулей, подменю только у текущего", () => {
58
+ it("модули подряд ссылками с подписями реестра, без заголовков групп", () => {
59
+ const html = render(ALL);
60
+ for (const id of ["admin", "talent", "pay"])
61
+ expect(html).toContain(`data-testid="nav-item-${id}"`);
62
+ expect(html).toContain(">Управление<");
63
+ expect(html).toContain(">Таланты<");
64
+ expect(html).not.toContain("«group");
65
+ });
66
+
67
+ it("разделы текущего модуля — подменю СРАЗУ под его пунктом, до следующего модуля", () => {
68
+ const html = render(ALL);
69
+ expect(at(html, 'nav-item-talent"')).toBeLessThan(at(html, 'nav-jobs"'));
70
+ expect(at(html, 'nav-rates"')).toBeLessThan(at(html, 'nav-item-pay"'));
71
+ expect(html).toContain('data-sidebar="menu-sub"');
72
+ });
73
+
74
+ it("у свёрнутых модулей подпунктов нет: в другом модуле разделов «Талантов» не видно", () => {
75
+ const html = renderToStaticMarkup(
76
+ <DashboardShell pathname="/pay" roles={ALL} t={(k) => k} brandTitle="П" modules={MODULES}>
77
+ экран
78
+ </DashboardShell>
79
+ );
80
+ expect(html).not.toContain('data-sidebar="menu-sub"');
81
+ expect(html).toContain('data-testid="nav-item-talent"');
82
+ });
83
+
84
+ it("текущего модуля нет среди видимых (роли не приехали) — разделы плоским списком", () => {
85
+ const html = render(null);
86
+ expect(html).toContain('data-testid="nav-jobs"');
87
+ expect(html).not.toContain('data-sidebar="menu-sub"');
88
+ });
89
+ });
@@ -0,0 +1,384 @@
1
+ import { platformIdentityUrl } from "@icomponents/auth/client/platform-identity";
2
+ import { usePlatformIdentity } from "@icomponents/auth/client/use-platform-identity";
3
+ import { ThemeSwitch } from "@icomponents/react/components/theme-switch";
4
+ import {
5
+ Sidebar,
6
+ SidebarContent,
7
+ SidebarFooter,
8
+ SidebarGroup,
9
+ SidebarGroupContent,
10
+ SidebarHeader,
11
+ SidebarInset,
12
+ SidebarMenu,
13
+ SidebarMenuButton,
14
+ SidebarMenuItem,
15
+ SidebarMenuSub,
16
+ SidebarMenuSubButton,
17
+ SidebarMenuSubItem,
18
+ SidebarProvider,
19
+ SidebarRail,
20
+ SidebarTrigger,
21
+ } from "@icomponents/react/components/ui/sidebar";
22
+ import { TESTID, testid } from "@icomponents/react/testids";
23
+ import { PaletteSwitch } from "@icomponents/theme/palette-switch";
24
+
25
+ import {
26
+ activeModuleId,
27
+ activeSectionKey,
28
+ allSections,
29
+ ownSectionGroups,
30
+ visibleModules,
31
+ type ModuleSection,
32
+ type SectionGroup,
33
+ type PlatformModule,
34
+ } from "./nav";
35
+ import { organizationInitials, type ShellOrganization } from "./organization";
36
+ import { PlatformHeader } from "./platform-header";
37
+ import type { SessionControlProps } from "./session-control";
38
+ import { usePlatformModules } from "./use-platform-modules";
39
+
40
+ /**
41
+ * ОБОЛОЧКА КАБИНЕТА — одна на все модули платформы.
42
+ *
43
+ * Каждый модуль (`/italent`, `/calendar`, …) — отдельное приложение со своим бандлом, и он
44
+ * рендерит ЭТУ оболочку у себя. Поэтому здесь нет ни роутера, ни клиента авторизации: всё, что
45
+ * зависит от конкретного приложения, приходит пропсами. Компонент, тянущий `@tanstack/react-router`
46
+ * или better-auth, работал бы только в том модуле, для которого написан, — то есть не был бы общим.
47
+ *
48
+ * Пункты меню — обычные `<a>`, а не `<Link>` роутера, и это не упрощение: соседний модуль живёт в
49
+ * другом бандле, и клиентский роутинг попытался бы найти его маршрут у себя и показал бы
50
+ * собственный 404. Переход между модулями — полная навигация браузера, по-другому и не бывает.
51
+ *
52
+ * Активный пункт считается по `pathname`, который передаёт приложение: своего роутера у оболочки
53
+ * нет, а `window.location` в момент первого рендера на сервере не существует.
54
+ */
55
+
56
+ export interface DashboardUser {
57
+ name: string;
58
+ email: string;
59
+ avatar?: string;
60
+ }
61
+
62
+ export interface DashboardShellProps {
63
+ /** Текущий путь целиком (`/italent/jobs`) — из него подсвечивается активный модуль. */
64
+ pathname: string;
65
+ /**
66
+ * Роли пользователя из токена, в формате `<проект>:<роль>`. `null` — ещё грузятся: меню пустое,
67
+ * deny-default (см. `visibleModules`).
68
+ *
69
+ * Не заданы — оболочка спрашивает свой модуль (`identityUrl`); на 401 — `session.onSignIn`
70
+ * (иначе перезагрузка), не чаще раза за 5 мин, затем «Войти».
71
+ */
72
+ roles?: readonly string[] | null;
73
+ /** Адрес `createPlatformIdentityHandler` модуля; по умолчанию `/<первый сегмент>/api/platform/me`. */
74
+ identityUrl?: string;
75
+ user?: DashboardUser;
76
+ /** Перевод ключей заголовков СВОИХ групп разделов модуля (`SectionGroup.groupKey`). */
77
+ t: (key: string) => string;
78
+ /** Язык подписей модулей из реестра (`PlatformModule.title`). По умолчанию `ru`. */
79
+ locale?: "ru" | "en";
80
+ /** Подпись угла сайдбара, когда организации нет (`organization` не задана или `null`). */
81
+ brandTitle: string;
82
+ /**
83
+ * ОРГАНИЗАЦИЯ, от лица которой работает человек, — угол сайдбара во всех модулях: плашка с
84
+ * инициалами и название, `href` — ссылка угла. Данные — из ответа модуля (`identityUrl`). Угол рисует
85
+ * оболочка, а не модуль: пока его рисовал каждый сам, модули показывали разное.
86
+ */
87
+ organization?: ShellOrganization | null;
88
+ /**
89
+ * @deprecated Угол сайдбара вёрсткой модуля. Ровно он развёл кабинеты («im italent» против
90
+ * «ip ООО "ПРОСТО"») — переезжайте на `organization`. Задан вместе с ней — побеждает `organization`.
91
+ */
92
+ brandSlot?: React.ReactNode;
93
+ /**
94
+ * Реестр модулей. По умолчанию — документ ilanding `/platform/modules.json` поверх вшитого списка;
95
+ * заданный здесь (тесты, превью) побеждает, и документ не запрашивается.
96
+ */
97
+ modules?: readonly PlatformModule[];
98
+ /**
99
+ * Разделы САМОГО модуля — второй уровень меню, отдельной группой под модулями платформы.
100
+ * Пусто — группы нет вовсе: пустой заголовок читается как оборванная загрузка.
101
+ */
102
+ sections?: readonly ModuleSection[];
103
+ /** Заголовок группы разделов (ключ перевода, тот же неймспейс `nav`). */
104
+ sectionsGroupKey?: string;
105
+ /**
106
+ * Свои разделы, разложенные ПО ГРУППАМ, — для модулей, у которых меню не плоское.
107
+ *
108
+ * Задано вместе с `sections` — побеждают группы: смешение означало бы два ответа на вопрос «из
109
+ * чего состоит меню модуля». Плоская форма оставлена, потому что ею пользуются модули с двумя-тремя
110
+ * разделами, и заставлять их оборачивать список в группу значило бы сломать всех ради одного.
111
+ */
112
+ sectionGroups?: readonly SectionGroup[];
113
+ /**
114
+ * Ссылка раздела. Разделы живут в ЭТОМ ЖЕ бандле, поэтому переход между ними — клиентский
115
+ * роутинг модуля; по умолчанию рисуется обычный `<a>` (полная перезагрузка), и модуль с
116
+ * роутером обязан отдать свою ссылку, иначе он терял бы состояние на каждом переходе.
117
+ * Оболочка роутера не знает и знать не может: он у каждого модуля свой.
118
+ *
119
+ * Атрибуты приезжают ГОТОВЫМ объектом и раскрываются в ссылку целиком (`<Link {...props} />`):
120
+ * `data-testid` принадлежит оболочке, и собирать его в модуле значило бы завести вторую правду о
121
+ * контракте вёрстки — ту, которую забудут поставить.
122
+ */
123
+ renderSectionLink?: (
124
+ section: ModuleSection,
125
+ props: { "data-testid": string; children: React.ReactNode }
126
+ ) => React.ReactNode;
127
+ /**
128
+ * Сессия — ДАННЫМИ, а не вёрсткой: кто вошёл и что делать по «войти»/«выйти». Кнопку рисует
129
+ * платформа (`PlatformHeader`), поэтому у модулей она одна на всех.
130
+ *
131
+ * Не задана — правый угол собирается по-старому из `headerSlot`. Это переходное состояние для
132
+ * модулей, которые ещё не переехали, а не второй способ: см. пометку у `headerSlot`.
133
+ */
134
+ session?: SessionControlProps;
135
+ /**
136
+ * СЕРЕДИНА шапки — то, что занимает свободное место: поиск модуля. Отдельно от `actions`, потому
137
+ * что это разные места, а не разные названия: поиск тянется, действия жмутся к правому краю.
138
+ * Сложи их в один слот — и поиск подбора уедет к иконкам, а шапка перестанет быть одинаковой.
139
+ */
140
+ center?: React.ReactNode;
141
+ /**
142
+ * Действия САМОГО модуля в шапке — узкий слот: диагностика подбора, палитра. Работает только
143
+ * вместе с `session`; без неё правый угол целиком за `headerSlot`.
144
+ */
145
+ actions?: React.ReactNode;
146
+ /** Переключатель языка — не у всех модулей есть локали, поэтому узлом и по запросу. */
147
+ languageSlot?: React.ReactNode;
148
+ /**
149
+ * Переключатель темы. Не задан — оболочка ставит `ThemeSwitch` кита САМА, и поэтому он одинаков
150
+ * во всех кабинетах, хотя в `PlatformHeader` приходит узлом (там объяснено, почему иначе нельзя:
151
+ * провайдер темы завязан на `window`, а витрина рендерится на сервере).
152
+ */
153
+ themeSlot?: React.ReactNode;
154
+ /**
155
+ * ВИДИМОСТЬ элементов, которые оболочка рисует сама. Нужна, чтобы выключить элемент у одного
156
+ * модуля БЕЗ выпуска новой версии пакета: перевыпуск ради «у нас пока не надо» превращает
157
+ * общую шапку в повод ждать релиза.
158
+ *
159
+ * Не задано — элемент виден. Умолчание «включено» намеренное: выключенный по умолчанию элемент
160
+ * не появится нигде, и общая шапка снова станет набором слотов, которые каждый заполняет сам.
161
+ */
162
+ controls?: { palette?: boolean };
163
+ /**
164
+ * @deprecated Правый угол шапки целиком. Ровно этот слот и развёл модули: он широкий, поэтому в
165
+ * него уехала сессия — и приехала в каждый модуль своя. Переезжайте на `session` + `actions`;
166
+ * слот снят не будет до мажорной версии, чтобы не сломать сборку модулей на `^0.3.0`.
167
+ */
168
+ headerSlot?: React.ReactNode;
169
+ /** Подвал сайдбара: карточка пользователя, выход. */
170
+ footerSlot?: React.ReactNode;
171
+ children?: React.ReactNode;
172
+ }
173
+
174
+ export function DashboardShell({
175
+ pathname,
176
+ roles: rolesProp,
177
+ identityUrl,
178
+ user,
179
+ t,
180
+ brandTitle,
181
+ organization: organizationProp,
182
+ brandSlot,
183
+ modules,
184
+ locale = "ru",
185
+ sections,
186
+ sectionsGroupKey,
187
+ sectionGroups,
188
+ renderSectionLink,
189
+ session: sessionProp,
190
+ center,
191
+ actions,
192
+ languageSlot,
193
+ themeSlot,
194
+ controls,
195
+ headerSlot,
196
+ footerSlot,
197
+ children,
198
+ }: DashboardShellProps) {
199
+ // Роли не отданы модулем — оболочка спрашивает свой модуль (один запрос на страницу).
200
+ // 401 — вход модуля (`session.onSignIn`): перезагрузка не поможет, если жива сессия, а не токен.
201
+ const identity = usePlatformIdentity({
202
+ url: identityUrl ?? platformIdentityUrl(pathname),
203
+ enabled: rolesProp === undefined,
204
+ onUnauthorized: sessionProp?.onSignIn,
205
+ });
206
+ const me = identity.status === "ok" ? identity.identity : null;
207
+ const roles = rolesProp === undefined ? (me?.roles ?? null) : rolesProp;
208
+ const organization =
209
+ organizationProp !== undefined || rolesProp !== undefined
210
+ ? organizationProp
211
+ : me?.organization
212
+ ? { name: me.organization.name, href: "/iprofile/organization" }
213
+ : null;
214
+ // Сессии модуля нет, а уход на вход уже был — «Войти» вместо имени, вход модуля.
215
+ const session =
216
+ sessionProp && identity.status === "signed-out" ? { ...sessionProp, user: null } : sessionProp;
217
+ // Реестр — документ ilanding (меню меняется без пересборки модуля), первый кадр — вшитый список.
218
+ const registry = usePlatformModules(modules);
219
+ const visible = visibleModules(roles, registry);
220
+ const active = activeModuleId(pathname, registry);
221
+ // Разделы сводятся к одной форме — списку групп: дальше по коду их различие не нужно.
222
+ const ownGroups = ownSectionGroups({ sections, sectionsGroupKey, sectionGroups });
223
+ const activeSection = activeSectionKey(pathname, allSections(ownGroups));
224
+ /*
225
+ МЕНЮ ЦЕЛЬНОЕ: модули реестра подряд, каждый — ссылка в свой модуль. Под ТЕКУЩИМ раскрыто подменю
226
+ его разделов (их даёт сам модуль), у остальных подпунктов нет. Групп-заголовков нет — разрывов нет.
227
+ Текущего модуля нет среди видимых (роли не приехали, не зарегистрирован) — его разделы идут
228
+ плоским списком после модулей: своё меню не пропадает из-за чужих ролей.
229
+ */
230
+ const expanded = ownGroups.length > 0 && visible.some((module) => module.id === active);
231
+
232
+ const sectionItems = (sub: boolean) =>
233
+ ownGroups.flatMap((group, index) => [
234
+ ownGroups.length > 1 && group.groupKey ? (
235
+ <li
236
+ key={`heading-${group.groupKey ?? index}`}
237
+ className="text-sidebar-foreground/60 px-2 pt-2 text-xs"
238
+ >
239
+ {t(group.groupKey)}
240
+ </li>
241
+ ) : null,
242
+ ...group.sections.map((section) => {
243
+ const linkProps = {
244
+ "data-testid": `nav-${section.key}`,
245
+ children: (
246
+ <>
247
+ {section.icon ? <section.icon /> : null}
248
+ <span>{section.title}</span>
249
+ </>
250
+ ),
251
+ };
252
+ const link = renderSectionLink ? (
253
+ renderSectionLink(section, linkProps)
254
+ ) : (
255
+ <a href={section.href} {...linkProps} />
256
+ );
257
+ const isActive = section.key === activeSection;
258
+ return sub ? (
259
+ <SidebarMenuSubItem key={section.key}>
260
+ <SidebarMenuSubButton asChild isActive={isActive}>
261
+ {link}
262
+ </SidebarMenuSubButton>
263
+ </SidebarMenuSubItem>
264
+ ) : (
265
+ <SidebarMenuItem key={section.key}>
266
+ <SidebarMenuButton asChild isActive={isActive} tooltip={section.title}>
267
+ {link}
268
+ </SidebarMenuButton>
269
+ </SidebarMenuItem>
270
+ );
271
+ }),
272
+ ]);
273
+
274
+ return (
275
+ <SidebarProvider>
276
+ <Sidebar collapsible="icon" variant="inset">
277
+ <SidebarHeader>
278
+ <div className="flex items-center gap-2 px-2 py-1.5">
279
+ {organization ? (
280
+ <OrganizationCorner organization={organization} />
281
+ ) : (
282
+ (brandSlot ?? (
283
+ <span className="font-display truncate text-sm font-semibold">{brandTitle}</span>
284
+ ))
285
+ )}
286
+ </div>
287
+ </SidebarHeader>
288
+
289
+ {/* Пропала навигация — человек заперт на одном экране; хваталка `nav` это стережёт. */}
290
+ <SidebarContent {...testid(TESTID.nav)}>
291
+ <SidebarGroup>
292
+ <SidebarGroupContent>
293
+ <SidebarMenu>
294
+ {visible.map((module) => (
295
+ <SidebarMenuItem key={module.id}>
296
+ <SidebarMenuButton
297
+ asChild
298
+ isActive={module.id === active && activeSection === undefined}
299
+ tooltip={module.title[locale]}
300
+ >
301
+ <a href={module.href} {...testid(TESTID.navItem(module.id))}>
302
+ <span>{module.title[locale]}</span>
303
+ </a>
304
+ </SidebarMenuButton>
305
+ {expanded && module.id === active ? (
306
+ <SidebarMenuSub>{sectionItems(true)}</SidebarMenuSub>
307
+ ) : null}
308
+ </SidebarMenuItem>
309
+ ))}
310
+ {expanded ? null : sectionItems(false)}
311
+ </SidebarMenu>
312
+ </SidebarGroupContent>
313
+ </SidebarGroup>
314
+ </SidebarContent>
315
+
316
+ <SidebarFooter>
317
+ {footerSlot ?? <div className="truncate px-2 py-1.5 text-xs">{user?.email ?? ""}</div>}
318
+ </SidebarFooter>
319
+ <SidebarRail />
320
+ </Sidebar>
321
+
322
+ <SidebarInset className="@container/content">
323
+ {session ? (
324
+ <PlatformHeader
325
+ leading={<SidebarTrigger variant="outline" className="max-md:scale-125" />}
326
+ center={center}
327
+ actions={actions}
328
+ languageSlot={languageSlot}
329
+ themeSlot={themeSlot ?? <ThemeSwitch />}
330
+ paletteSlot={controls?.palette === false ? null : <PaletteSwitch />}
331
+ session={session}
332
+ />
333
+ ) : (
334
+ <header className="bg-background/80 sticky top-0 z-40 flex h-14 items-center gap-2 border-b px-4 backdrop-blur-lg">
335
+ <SidebarTrigger variant="outline" className="max-md:scale-125" />
336
+ <div className="ms-auto flex items-center gap-2">{headerSlot}</div>
337
+ </header>
338
+ )}
339
+ {/* ПРОКРУТКА ЭКРАНА — внутри, а не всей страницы. Парная половина высоты оболочки
340
+ (`.group/sidebar-wrapper { height: 100svh }` в `cabinet.css`): без этого контейнера
341
+ длинный экран вылезает за обёртку, и шапка с пагинацией уезжают вместе со страницей.
342
+ Раньше его ставил модуль (`<main overflow-y-auto>` у подбора), и у соседей его не
343
+ было. Без `cabinet.css` высота не ограничена, и контейнер ничего не меняет. */}
344
+ <div
345
+ data-testid="cabinet-scroll"
346
+ className="flex min-h-0 min-w-0 flex-1 flex-col overflow-y-auto"
347
+ >
348
+ {children}
349
+ </div>
350
+ </SidebarInset>
351
+ </SidebarProvider>
352
+ );
353
+ }
354
+
355
+ /**
356
+ * Угол сайдбара с организацией. Ссылка — обычный `<a>`: страница организации живёт в другом модуле
357
+ * (iprofile), и переход туда — полная навигация, а не роутинг текущего бандла.
358
+ */
359
+ function OrganizationCorner({ organization }: { organization: ShellOrganization }) {
360
+ const body = (
361
+ <>
362
+ <span className="bg-primary text-primary-foreground grid size-6 shrink-0 place-items-center rounded-sm font-mono text-[11px] font-bold">
363
+ {organizationInitials(organization.name)}
364
+ </span>
365
+ <span
366
+ data-testid="brand-organization"
367
+ className="font-display truncate text-[13px] font-semibold tracking-tight group-data-[collapsible=icon]:hidden"
368
+ >
369
+ {organization.name}
370
+ </span>
371
+ </>
372
+ );
373
+ if (!organization.href)
374
+ return <div className="flex min-h-11 min-w-0 items-center gap-2">{body}</div>;
375
+ return (
376
+ <a
377
+ href={organization.href}
378
+ data-testid="brand-home"
379
+ className="flex min-h-11 min-w-0 items-center gap-2"
380
+ >
381
+ {body}
382
+ </a>
383
+ );
384
+ }
@@ -0,0 +1,202 @@
1
+ import { describe, expect, test } from "bun:test";
2
+
3
+ import {
4
+ activeModuleId,
5
+ activeSectionKey,
6
+ groupModules,
7
+ parseProjectRole,
8
+ visibleModules,
9
+ type ModuleSection,
10
+ type PlatformModule,
11
+ allSections,
12
+ ownSectionGroups,
13
+ } from "./nav";
14
+
15
+ const MODULES: PlatformModule[] = [
16
+ {
17
+ id: "italent",
18
+ titleKey: "italent",
19
+ title: { ru: "italent", en: "italent" },
20
+ href: "/italent",
21
+ project: "italent",
22
+ groupKey: "g1",
23
+ },
24
+ {
25
+ id: "tasks",
26
+ titleKey: "tasks",
27
+ title: { ru: "tasks", en: "tasks" },
28
+ href: "/tasks",
29
+ project: "tasks",
30
+ groupKey: "g2",
31
+ },
32
+ {
33
+ id: "admin",
34
+ titleKey: "admin",
35
+ title: { ru: "admin", en: "admin" },
36
+ href: "/admin",
37
+ project: "italent",
38
+ roles: ["owner"],
39
+ groupKey: "g2",
40
+ },
41
+ ];
42
+
43
+ describe("видимость модулей по ролям проекта", () => {
44
+ test("любая роль в проекте открывает модуль — роль и есть факт выдачи доступа", () => {
45
+ expect(visibleModules(["italent:customers"], MODULES).map((m) => m.id)).toEqual(["italent"]);
46
+ });
47
+
48
+ test("пункт с перечисленными ролями требует одну из них, а не просто доступ к проекту", () => {
49
+ expect(visibleModules(["italent:customers"], MODULES).map((m) => m.id)).not.toContain("admin");
50
+ expect(visibleModules(["italent:owner"], MODULES).map((m) => m.id)).toEqual([
51
+ "italent",
52
+ "admin",
53
+ ]);
54
+ });
55
+
56
+ test("роли ещё не загружены — меню пустое (deny-default, как на сервере)", () => {
57
+ expect(visibleModules(null, MODULES)).toEqual([]);
58
+ });
59
+
60
+ test("роль чужого проекта не открывает модуль", () => {
61
+ expect(visibleModules(["billing:admin"], MODULES)).toEqual([]);
62
+ });
63
+
64
+ test("строка без проекта игнорируется, а не считается ролью", () => {
65
+ expect(parseProjectRole("customers")).toBeUndefined();
66
+ expect(parseProjectRole("italent:")).toBeUndefined();
67
+ expect(visibleModules(["customers"], MODULES)).toEqual([]);
68
+ });
69
+
70
+ test("роль с двоеточием внутри разбирается по ПЕРВОМУ разделителю", () => {
71
+ expect(parseProjectRole("italent:role:extra")).toEqual({
72
+ project: "italent",
73
+ role: "role:extra",
74
+ });
75
+ });
76
+ });
77
+
78
+ describe("активный модуль", () => {
79
+ test("подсвечивается по границе сегмента, а не по началу строки", () => {
80
+ expect(activeModuleId("/tasks", MODULES)).toBe("tasks");
81
+ expect(activeModuleId("/tasks/42", MODULES)).toBe("tasks");
82
+ // Иначе `/tasks-archive` подсветил бы «Задачи», и человек видел бы себя не там, где он есть.
83
+ expect(activeModuleId("/tasks-archive", MODULES)).toBeUndefined();
84
+ });
85
+
86
+ test("путь вне платформы не подсвечивает ничего", () => {
87
+ expect(activeModuleId("/", MODULES)).toBeUndefined();
88
+ });
89
+ });
90
+
91
+ describe("активный раздел модуля", () => {
92
+ // Корень модуля — такой же раздел, как остальные, и в этом вся сложность: по простому
93
+ // `startsWith` он совпадает с ЛЮБЫМ путём модуля.
94
+ const SECTIONS: ModuleSection[] = [
95
+ { key: "dashboard", href: "/italent", title: "Обзор", exact: true },
96
+ { key: "jobs", href: "/italent/jobs", title: "Вакансии" },
97
+ { key: "offers", href: "/italent/offers", title: "Кандидаты" },
98
+ ];
99
+
100
+ test("на корне модуля активен корневой раздел", () => {
101
+ expect(activeSectionKey("/italent", SECTIONS)).toBe("dashboard");
102
+ });
103
+
104
+ test("вложенный путь отдаёт САМОЕ ДЛИННОЕ совпадение, а не корень модуля", () => {
105
+ expect(activeSectionKey("/italent/jobs", SECTIONS)).toBe("jobs");
106
+ expect(activeSectionKey("/italent/jobs/16056", SECTIONS)).toBe("jobs");
107
+ });
108
+
109
+ test("совпадение по границе сегмента: /italent/offers-archive — не «Кандидаты»", () => {
110
+ expect(activeSectionKey("/italent/offers-archive", SECTIONS)).toBeUndefined();
111
+ });
112
+
113
+ test("`exact` у корня: страница модуля без своего раздела не подсвечивает «Обзор»", () => {
114
+ // Без флага «Обзор» горел бы здесь — его префикс покрывает весь модуль.
115
+ expect(activeSectionKey("/italent/staffing", SECTIONS)).toBeUndefined();
116
+ // А без `exact` — подсвечивал бы, и это ровно то, что флаг чинит.
117
+ const loose = SECTIONS.map((s) => ({ ...s, exact: false }));
118
+ expect(activeSectionKey("/italent/staffing", loose)).toBe("dashboard");
119
+ });
120
+
121
+ test("чужой модуль не подсвечивает ни одного раздела", () => {
122
+ expect(activeSectionKey("/iadmin/users", SECTIONS)).toBeUndefined();
123
+ });
124
+
125
+ test("разделов нет — активного нет, а не падение", () => {
126
+ expect(activeSectionKey("/italent/jobs", [])).toBeUndefined();
127
+ });
128
+ });
129
+
130
+ describe("группировка", () => {
131
+ test("группы идут в порядке первого появления, пустых не бывает", () => {
132
+ const groups = groupModules(visibleModules(["italent:owner", "tasks:member"], MODULES));
133
+ expect(groups.map((g) => g.groupKey)).toEqual(["g1", "g2"]);
134
+ expect(groups.every((g) => g.items.length > 0)).toBe(true);
135
+ });
136
+ });
137
+
138
+ describe("свои разделы модуля: плоский список и группы", () => {
139
+ const section = (key: string) => ({ key, href: `/x/${key}`, title: key });
140
+
141
+ test("плоский список превращается в одну группу с его заголовком", () => {
142
+ const groups = ownSectionGroups({
143
+ sections: [section("a"), section("b")],
144
+ sectionsGroupKey: "groupModule",
145
+ });
146
+ expect(groups).toHaveLength(1);
147
+ expect(groups[0]?.groupKey).toBe("groupModule");
148
+ expect(groups[0]?.sections).toHaveLength(2);
149
+ });
150
+
151
+ test("разделов нет — групп нет вовсе: пустой заголовок читается как оборванная загрузка", () => {
152
+ expect(ownSectionGroups({})).toEqual([]);
153
+ expect(ownSectionGroups({ sections: [] })).toEqual([]);
154
+ });
155
+
156
+ test("пустые группы отбрасываются: заголовок без пунктов — то же самое", () => {
157
+ const groups = ownSectionGroups({
158
+ sectionGroups: [
159
+ { groupKey: "пусто", sections: [] },
160
+ { groupKey: "есть", sections: [section("a")] },
161
+ ],
162
+ });
163
+ expect(groups.map((g) => g.groupKey)).toEqual(["есть"]);
164
+ });
165
+
166
+ test("обе формы сразу — побеждают группы, и это предсказуемо", () => {
167
+ // Смешение означало бы два ответа на «из чего состоит меню модуля».
168
+ const groups = ownSectionGroups({
169
+ sections: [section("плоский")],
170
+ sectionGroups: [{ groupKey: "г", sections: [section("групповой")] }],
171
+ });
172
+ expect(allSections(groups).map((s) => s.key)).toEqual(["групповой"]);
173
+ });
174
+
175
+ test("подсветка активного не зависит от групп: разделы сводятся в один список", () => {
176
+ const groups = ownSectionGroups({
177
+ sectionGroups: [
178
+ { groupKey: "первая", sections: [section("a")] },
179
+ { groupKey: "вторая", sections: [section("b")] },
180
+ ],
181
+ });
182
+ expect(activeSectionKey("/x/b", allSections(groups))).toBe("b");
183
+ });
184
+ });
185
+
186
+ describe("модуль iomp", () => {
187
+ test("пункт видят iomp:user и iomp:admin, служебная роль проекта его не открывает", () => {
188
+ const ids = (roles: string[]) => visibleModules(roles).map((module) => module.id);
189
+ expect(ids(["iomp:user"])).toContain("iomp");
190
+ expect(ids(["iomp:admin"])).toContain("iomp");
191
+ expect(ids(["iomp:agent"])).not.toContain("iomp");
192
+ });
193
+ });
194
+
195
+ describe("модуль iagent", () => {
196
+ test("пункт видят владелец и админ платформы, служебные роли проекта его не открывают", () => {
197
+ const ids = (roles: string[]) => visibleModules(roles).map((module) => module.id);
198
+ expect(ids(["iagent:iagent:platform-admin"])).toContain("iagent");
199
+ expect(ids(["iagent:iagent:owner"])).toContain("iagent");
200
+ expect(ids(["iagent:iagent:sender", "iagent:iagent:reader"])).not.toContain("iagent");
201
+ });
202
+ });