@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,99 @@
1
+ /**
2
+ * МЕНЮ ПЛАТФОРМЫ ДАННЫМИ. Реестр `PLATFORM_MODULES` отдаёт ilanding документом на общем домене, и
3
+ * оболочка каждого модуля забирает его при загрузке: смена пункта — выкатка одного ilanding, а не
4
+ * выпуск пакета и пересборка всех модулей. Вшитый список остаётся первым кадром и запасом.
5
+ *
6
+ * Здесь без React: формат документа нужен и серверу ilanding, и браузеру.
7
+ */
8
+ import { PLATFORM_MODULES, type PlatformModule } from "./nav";
9
+
10
+ /** Адрес документа — от корня домена: все модули живут на одном хосте, CORS не нужен. */
11
+ export const MODULES_PATH = "/platform/modules.json";
12
+
13
+ /** Номер формата. Меняется только при несовместимой правке — старая оболочка тогда останется на вшитом. */
14
+ export const MODULES_FORMAT = 1;
15
+
16
+ /** Кэш документа: пункт меню доезжает до людей за пять минут, сервер не спрашивают на каждый экран. */
17
+ export const MODULES_CACHE_SECONDS = 300;
18
+
19
+ export interface ModulesDocument {
20
+ readonly format: number;
21
+ readonly modules: readonly PlatformModule[];
22
+ }
23
+
24
+ export function modulesDocument(
25
+ modules: readonly PlatformModule[] = PLATFORM_MODULES
26
+ ): ModulesDocument {
27
+ return { format: MODULES_FORMAT, modules };
28
+ }
29
+
30
+ const isText = (value: unknown): value is string => typeof value === "string" && value !== "";
31
+
32
+ /** Путь на этом же хосте: `//host` и `/\\host` браузер читает как чужой сайт. */
33
+ function isSameOriginPath(href: string): boolean {
34
+ if (!href.startsWith("/")) return false;
35
+ const base = "https://same.invalid";
36
+ try {
37
+ return new URL(href, base).origin === base;
38
+ } catch {
39
+ return false;
40
+ }
41
+ }
42
+
43
+ function parseModule(value: unknown): PlatformModule | null {
44
+ const raw = value as Partial<Record<keyof PlatformModule, unknown>> | null;
45
+ if (!raw || typeof raw !== "object") return null;
46
+ const title = raw.title as { ru?: unknown; en?: unknown } | undefined;
47
+ if (
48
+ !isText(raw.id) ||
49
+ !isText(raw.titleKey) ||
50
+ !isText(title?.ru) ||
51
+ !isText(title?.en) ||
52
+ !isText(raw.href) ||
53
+ !isSameOriginPath(raw.href) ||
54
+ !isText(raw.project) ||
55
+ !isText(raw.groupKey)
56
+ )
57
+ return null;
58
+ // `roles: []` прячет пункт от всех — битый пункт, а не «никому».
59
+ if (
60
+ raw.roles !== undefined &&
61
+ !(Array.isArray(raw.roles) && raw.roles.length > 0 && raw.roles.every(isText))
62
+ )
63
+ return null;
64
+ return {
65
+ id: raw.id,
66
+ titleKey: raw.titleKey,
67
+ title: { ru: title.ru, en: title.en },
68
+ href: raw.href,
69
+ project: raw.project,
70
+ groupKey: raw.groupKey,
71
+ ...(raw.roles ? { roles: raw.roles as string[] } : {}),
72
+ };
73
+ }
74
+
75
+ /**
76
+ * Документ → реестр. Чужой формат, пустой список или ХОТЯ БЫ ОДИН битый пункт — `null`: меню из
77
+ * половины документа хуже вшитого целого, потому что пропавший пункт никто не заметит.
78
+ */
79
+ export function parseModulesDocument(value: unknown): readonly PlatformModule[] | null {
80
+ const doc = value as Partial<ModulesDocument> | null;
81
+ if (!doc || doc.format !== MODULES_FORMAT || !Array.isArray(doc.modules)) return null;
82
+ if (doc.modules.length === 0) return null;
83
+ const modules = doc.modules.map(parseModule);
84
+ return modules.every((module) => module !== null) ? (modules as PlatformModule[]) : null;
85
+ }
86
+
87
+ /** Загрузка документа. Любой сбой — `null`: вызывающий остаётся на вшитом списке. */
88
+ export async function loadPlatformModules(
89
+ fetchImpl: typeof fetch = fetch,
90
+ path: string = MODULES_PATH
91
+ ): Promise<readonly PlatformModule[] | null> {
92
+ try {
93
+ const response = await fetchImpl(path, { credentials: "omit" });
94
+ if (!response.ok) return null;
95
+ return parseModulesDocument(await response.json());
96
+ } catch {
97
+ return null;
98
+ }
99
+ }
@@ -0,0 +1,83 @@
1
+ import { Button } from "@icomponents/react/components/ui/button";
2
+ import { TESTID, testid } from "@icomponents/react/testids";
3
+ import { LogIn, LogOut } from "lucide-react";
4
+
5
+ /**
6
+ * ВХОД И ВЫХОД — ОДИН НА ВСЮ ПЛАТФОРМУ.
7
+ *
8
+ * До этого компонента управление сессией было написано трижды и выглядело трижды по-разному:
9
+ * витрина рисовала залитую ссылку «Вход в кабинет» (`shell-signin`, разметка прототипа), кабинет
10
+ * подбора — ghost-кнопку с иконкой «Войти» (`header-sign-in`, своя вёрстка), кабинет лендинга —
11
+ * вообще не рисовал входа, только выход в профильном меню. Три подписи, три формы, три хваталки —
12
+ * и всё это на ОДНОМ хосте, где человек переходит между модулями за один клик.
13
+ *
14
+ * Расходилось не по недосмотру: оболочка сдавала правый угол шапки в аренду (`headerSlot`), и
15
+ * каждый модуль честно заполнял его сам. Поэтому починка — не «договориться», а забрать угол
16
+ * обратно: `PlatformHeader` принимает сессию ДАННЫМИ, а не вёрсткой, и нарисовать «свою» кнопку
17
+ * входа модулю больше не через что.
18
+ *
19
+ * Своего клиента авторизации здесь нет и быть не может — по той же причине, по которой его нет у
20
+ * `DashboardShell`: у каждого модуля свой better-auth (свой секрет, своя база, свой OIDC-клиент),
21
+ * и компонент, потянувший конкретный клиент, работал бы ровно в одном модуле. Модуль отдаёт «кто
22
+ * вошёл» и два обработчика; вёрстку держит платформа.
23
+ */
24
+
25
+ export interface SessionControlUser {
26
+ name: string;
27
+ email: string;
28
+ }
29
+
30
+ export interface SessionControlProps {
31
+ /**
32
+ * `undefined` — сессия ещё едет, места под кнопку не занимаем; `null` — не вошёл.
33
+ *
34
+ * Разделение не косметическое: мелькнувший «Войти» у вошедшего читается как «меня выкинуло», и
35
+ * человек жмёт вход повторно уже в рабочей сессии.
36
+ */
37
+ user?: SessionControlUser | null;
38
+ onSignIn: () => void;
39
+ onSignOut: () => void;
40
+ /** Подписи — от модуля: у платформы нет одного языка, локаль знает приложение. */
41
+ labels: { signIn: string; signOut: string };
42
+ }
43
+
44
+ export function SessionControl({ user, onSignIn, onSignOut, labels }: SessionControlProps) {
45
+ if (user === undefined) return null;
46
+
47
+ if (user === null)
48
+ return (
49
+ <Button
50
+ size="sm"
51
+ {...testid(TESTID.signIn)}
52
+ // Имя задано явно: на телефоне подпись скрыта, и без него кнопка — безымянная иконка.
53
+ aria-label={labels.signIn}
54
+ onClick={onSignIn}
55
+ className="min-h-11 gap-1.5 md:min-h-9"
56
+ >
57
+ <LogIn className="size-4" />
58
+ <span className="hidden sm:inline">{labels.signIn}</span>
59
+ </Button>
60
+ );
61
+
62
+ return (
63
+ <div className="flex min-w-0 items-center gap-1.5">
64
+ <span
65
+ {...testid("header-user")}
66
+ className="text-muted-foreground hidden max-w-[14rem] truncate text-[13px] md:inline"
67
+ title={user.email}
68
+ >
69
+ {user.name || user.email}
70
+ </span>
71
+ <Button
72
+ variant="ghost"
73
+ size="sm"
74
+ {...testid(TESTID.signOut)}
75
+ aria-label={labels.signOut}
76
+ onClick={onSignOut}
77
+ className="text-muted-foreground min-h-11 min-w-11 md:min-h-9 md:min-w-9"
78
+ >
79
+ <LogOut className="size-4" />
80
+ </Button>
81
+ </div>
82
+ );
83
+ }
@@ -0,0 +1,40 @@
1
+ import { useEffect, useState } from "react";
2
+
3
+ import { PLATFORM_MODULES, type PlatformModule } from "./nav";
4
+ import { loadPlatformModules } from "./platform-modules";
5
+
6
+ /** Один запрос на страницу: оболочка монтируется заново при переходах, документ от этого не меняется. */
7
+ let pending: Promise<readonly PlatformModule[] | null> | undefined;
8
+
9
+ /**
10
+ * Реестр модулей для оболочки. Первый кадр — вшитый список (серверный рендер и гидратация от сети не
11
+ * зависят), затем — документ ilanding, если он пришёл и прошёл проверку. Свой `explicit` (тесты,
12
+ * превью) побеждает и документ не запрашивает.
13
+ */
14
+ export function usePlatformModules(
15
+ explicit?: readonly PlatformModule[]
16
+ ): readonly PlatformModule[] {
17
+ const [loaded, setLoaded] = useState<readonly PlatformModule[] | null>(null);
18
+
19
+ useEffect(() => {
20
+ if (explicit) return;
21
+ let alive = true;
22
+ pending ??= loadPlatformModules();
23
+ void pending.then((modules) => {
24
+ if (alive && modules) setLoaded(modules);
25
+ });
26
+ return () => {
27
+ alive = false;
28
+ };
29
+ }, [explicit]);
30
+
31
+ return pickModules(explicit, loaded);
32
+ }
33
+
34
+ /** Что рисовать: свой список модуля, иначе документ ilanding, иначе вшитый. */
35
+ export function pickModules(
36
+ explicit: readonly PlatformModule[] | undefined,
37
+ loaded: readonly PlatformModule[] | null
38
+ ): readonly PlatformModule[] {
39
+ return explicit ?? loaded ?? PLATFORM_MODULES;
40
+ }
package/README.md DELETED
@@ -1,3 +0,0 @@
1
- # Temporary Holding Version
2
-
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.