fix: scroll behaviour when scroll

Author: TeymurDev

src/app/docs/utils/fetch-menu.ts

@@ -1,9 +1,121 @@
 import { Menu } from '../types';
 
-export const fetchMenu = async (lang: string): Promise<Menu> => {
-  const data = await fetch(
-    `https://raw.githubusercontent.com/rolling-scopes-school/docs/refs/heads/master/docs/${lang}/docsMenu_${lang}.json`,
-  );
+const DOCS_MENU_URL =
+  'https://raw.githubusercontent.com/rolling-scopes-school/docs/refs/heads/master/docs';
+
+type MenuNode = Menu[number];
+
+const EN_TO_RU_TITLE_MAP: Record<string, string> = {
+  'RS School Overview': 'RS School. Общая информация',
+  'Education Process': 'Процесс обучения',
+  'Communication. Communication Channels': 'Общение. Каналы связи',
+  'Code of Conduct': 'Нормы поведения',
+  'Dismission': 'Отчисление',
+  'Certificate': 'Сертификат',
+  'JavaScript/Front-end Course': 'Курс JavaScript/Front-end',
+  'Course Overview': 'Описание курса',
+  'How to enroll': 'Как записаться',
+  'Education process': 'Процесс обучения',
+  'Git convention': 'Требования к коммитам',
+  'First Interview': 'Первое интервью',
+  'Cross check': 'Кросс-чек',
+  'Course project': 'Курсовой проект',
+  'Code of conduct': 'Нормы поведения',
+  'Node.js EN Course': 'Курс Node.js EN',
+  'Short-track Course': 'Курс Short-track',
+  'Tasks': 'Задания',
+  'Pull Request Requirements': 'Требования к Pull Request',
+  'Moderation': 'Модерация',
+  'RS APP': 'RS APP',
+  'APP Overview': 'Описание приложения',
+  'Schedule': 'Расписание',
+  'Notifications': 'Нотификации',
+  'Roles': 'Роли',
+  'Moderators': 'Модераторы',
+  'Activists': 'Активисты',
+  'Support community': 'Поддержать сообщество',
+  'Activist': 'Активист',
+  'Mentor': 'Ментор',
+  'Trainer': 'Тренер',
+  'Mentoring': 'Менторинг',
+  'How to Become a Mentor?': 'Как стать ментором?',
+  'Pair Mentoring': 'Парный менторинг',
+  'Registration and Getting Students': 'Регистрация и получение студентов',
+  'Mentoring Process': 'Процесс менторинга',
+  'Mentor Assignment Review': 'Проверка задания ментором',
+  'For Trainers and Admins': 'Для тренеров и админов',
+  'General Information': 'Общая информация',
+  'Task Creation': 'Подготовка заданий',
+  'Adding Tests to RS App': 'Добавление тестов в RS App',
+  'Streaming': 'Стриминг',
+  'RS APP Platform': 'Платформа RS APP',
+  'Overview': 'Описание',
+  'Submitting Assignments in RS APP': 'Сдача заданий в RS APP',
+  'Typical Problems': 'Типичные проблемы',
+  'Private Repository': 'Приватный репозиторий',
+  'Git Convention': 'Требования к коммитам',
+  'How to help the school?': 'Как помочь школе?',
+  'Become an Activist': 'Стать активистом',
+  'How to Fix a Typo in Documentation?': 'Как исправить ошибку в документации?',
+  'Who are RSS AI?': 'Кто такие RSS AI?',
+  'How to contribute': 'Как контрибьютить',
+  'About The Rolling Scopes': 'О сообществе The Rolling Scopes',
+  'Cross-check': 'Кросс-чек',
+};
+
+const translateTitleToRu = (title: string): string => EN_TO_RU_TITLE_MAP[title] ?? title;
+
+const fetchMenuByLang = async (lang: string): Promise<Menu> => {
+  const data = await fetch(`${DOCS_MENU_URL}/${lang}/docsMenu_${lang}.json`);
 
   return await data.json();
 };
+
+const buildNodeKey = (node: MenuNode, index: number): string => {
+  if (node.link) {
+    return `link:${node.link}`;
+  }
+
+  return `group:${index}`;
+};
+
+const mergeRuWithEnglishMenu = (englishMenu: Menu, ruMenu: Menu): Menu => {
+  const ruNodeByKey = new Map<string, MenuNode>();
+
+  ruMenu.forEach((node, index) => {
+    ruNodeByKey.set(buildNodeKey(node, index), node);
+  });
+
+  const mergeNodes = (enNode: MenuNode, ruNode?: MenuNode): MenuNode => {
+    const mergedChildren = enNode.items?.map((child, index) => {
+      const key = buildNodeKey(child, index);
+      const ruChild = ruNode?.items?.find((item, itemIndex) => buildNodeKey(item, itemIndex) === key);
+
+      return mergeNodes(child, ruChild);
+    });
+
+    return {
+      ...enNode,
+      // Keep existing Russian wording whenever available, otherwise translate known English labels.
+      title: translateTitleToRu(ruNode?.title ?? enNode.title),
+      ...(mergedChildren ? { items: mergedChildren } : {}),
+    };
+  };
+
+  return englishMenu.map((enNode, index) => {
+    const key = buildNodeKey(enNode, index);
+    const ruNode = ruNodeByKey.get(key);
+
+    return mergeNodes(enNode, ruNode);
+  });
+};
+
+export const fetchMenu = async (lang: string): Promise<Menu> => {
+  if (lang !== 'ru') {
+    return fetchMenuByLang(lang);
+  }
+
+  const [englishMenu, ruMenu] = await Promise.all([fetchMenuByLang('en'), fetchMenuByLang('ru')]);
+
+  return mergeRuWithEnglishMenu(englishMenu, ruMenu);
+};