feat: Added ArticleNavigation component, which provides next/prev navigation between articles

src/components/ArticleNavigation/ArticleNavigation.scss

@@ -0,0 +1,53 @@
+@use '~@gravity-ui/page-constructor/styles/variables.scss' as pcVariables;
+@use '../../variables.scss';
+
+$block: '.#{variables.$ns}article-navigation';
+
+#{$block} {
+    display: flex;
+    gap: var(--g-spacing-6);
+    @media (max-width: map-get(pcVariables.$gridBreakpoints, 'md') - 1) {
+        gap: var(--g-spacing-5);
+    }
+    &__content {
+        padding: var(--g-spacing-2) 0;
+        overflow: hidden;
+        width: 100%;
+        @media (max-width: map-get(pcVariables.$gridBreakpoints, 'md') - 1) {
+            padding: var(--g-spacing-3) 0;
+        }
+        &-title {
+            @media (max-width: map-get(pcVariables.$gridBreakpoints, 'md') - 1) {
+                display: none;
+            }
+        }
+    }
+    &__button {
+        cursor: pointer;
+        display: flex;
+        gap: var(--g-spacing-3);
+        width: 50%;
+        border-radius: 16px;
+        border: 1px solid var(--g-color-sfx-fade);
+        padding: var(--g-spacing-1);
+        justify-content: space-between;
+        &_reverse {
+            flex-direction: row-reverse;
+            margin-left: auto;
+            padding-left: var(--g-spacing-5);
+        }
+        &-icon {
+            flex: none;
+            border-radius: 12px;
+            background: var(--g-color-base-generic);
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            color: var(--g-color-text-primary);
+            padding: 0 var(--g-spacing-5);
+            @media (max-width: map-get(pcVariables.$gridBreakpoints, 'md') - 1) {
+                padding: 0 var(--g-spacing-3);
+            }
+        }
+    }
+}

src/components/ArticleNavigation/ArticleNavigation.tsx

@@ -0,0 +1,91 @@
+import {ArrowLeft, ArrowRight} from '@gravity-ui/icons';
+import {Flex, Icon, Link, Text} from '@gravity-ui/uikit';
+import {useCallback} from 'react';
+import {CONTENT_WRAPPER_ID} from 'src/constants';
+import {block} from 'src/utils';
+
+import {SubSection} from '../NavigationLayout/types';
+
+const b = block('article-navigation');
+
+import './ArticleNavigation.scss';
+
+interface ArticleNavigationProps {
+    prevSection: SubSection | null;
+    nextSection: SubSection | null;
+}
+
+export const ArticleNavigation = ({prevSection, nextSection}: ArticleNavigationProps) => {
+    const scrollTop = useCallback(() => {
+        const content = document.getElementById(CONTENT_WRAPPER_ID);
+        if (content) {
+            content.scrollTo({
+                top: 0,
+                behavior: 'smooth',
+            });
+        }
+    }, []);
+
+    const nextHandler = () => {
+        if (!nextSection) {
+            return;
+        }
+        scrollTop();
+    };
+
+    const prevHandler = () => {
+        if (!prevSection) {
+            return;
+        }
+        scrollTop();
+    };
+
+    return (
+        <div className={b()}>
+            {prevSection && (
+                <Link href={prevSection.url} onClick={prevHandler} className={b('button')}>
+                    <div className={b('button-icon')}>
+                        <Icon data={ArrowLeft} size={16} />
+                    </div>
+                    <Flex direction="column" gap="1" className={b('content')}>
+                        <Text variant="body-short" color="light-complementary">
+                            Previous
+                        </Text>
+                        <Text
+                            className={b('content-title')}
+                            ellipsis={true}
+                            variant="body-2"
+                            color="primary"
+                        >
+                            {prevSection.title}
+                        </Text>
+                    </Flex>
+                </Link>
+            )}
+            {nextSection && (
+                <Link
+                    href={nextSection.url}
+                    onClick={nextHandler}
+                    className={b('button', {reverse: true})}
+                >
+                    <div className={b('button-icon')}>
+                        <Icon data={ArrowRight} size={16} />
+                    </div>
+                    <Flex direction="column" gap="1" className={b('content')}>
+                        <Text variant="body-short" color="light-complementary">
+                            Next
+                        </Text>
+                        <Text
+                            className={b('content-title')}
+                            ellipsis={true}
+                            variant="body-2"
+                            color="primary"
+                        >
+                            {nextSection.title}
+                        </Text>
+                    </Flex>
+                </Link>
+            )}
+        </div>
+    );
+};

src/components/ArticleNavigation/index.ts

@@ -0,0 +1 @@
+export {ArticleNavigation} from './ArticleNavigation';

src/components/Component/Component.scss

@@ -19,6 +19,10 @@ $block: '.#{variables.$ns}component';
         border-radius: 10px;
     }
 
+    &__navigation {
+        margin-top: var(--g-spacing-10);
+    }
+
     &__header {
         display: flex;
         align-items: center;

src/components/Component/Component.tsx

@@ -8,6 +8,8 @@ import githubIcon from '../../assets/icons/github.svg';
 import {MDXRenderer} from '../../components/MDXRenderer/MDXRenderer';
 import {Component as ComponentType} from '../../content/components/types';
 import {block, getRouteFromReadmeUrl} from '../../utils';
+import {ArticleNavigation} from '../ArticleNavigation/ArticleNavigation';
+import {Section} from '../NavigationLayout/types';
 import {SandboxBlock} from '../SandboxBlock';
 
 import './Component.scss';
@@ -34,15 +36,64 @@ export type ComponentProps = {
     libId: string;
     component: ComponentType;
     readmeContent: string;
+    sections: Section[];
 };
 
-export const Component: React.FC<ComponentProps> = ({libId, component, readmeContent}) => {
+export const Component: React.FC<ComponentProps> = ({
+    libId,
+    component,
+    readmeContent,
+    sections,
+}) => {
     const router = useRouter();
     const {tabId} = router.query;
 
     const [activeTab, setActiveTab] = React.useState(
         tabId === Tab.Design ? Tab.Design : Tab.Overview,
     );
+
+    const currentSection = React.useMemo(
+        () => sections.find((item) => item.id === libId),
+        [libId, sections],
+    );
+
+    const currentIndex = React.useMemo(() => {
+        if (!currentSection || !currentSection.subSections) {
+            return null;
+        }
+        return currentSection.subSections.findIndex((item) => item.id === component.id);
+    }, [currentSection, component.id]);
+
+    const nextSection = React.useMemo(() => {
+        if (
+            !currentSection ||
+            !currentSection.subSections ||
+            (!currentIndex && currentIndex !== 0)
+        ) {
+            return null;
+        }
+        const nextIndex = currentIndex + 1;
+        if (nextIndex >= currentSection.subSections.length) {
+            return null;
+        }
+        return currentSection.subSections[nextIndex];
+    }, [currentIndex, currentSection]);
+
+    const prevSection = React.useMemo(() => {
+        if (
+            !currentSection ||
+            !currentSection.subSections ||
+            (!currentIndex && currentIndex !== 0)
+        ) {
+            return null;
+        }
+        const prevIndex = currentIndex - 1;
+        if (prevIndex < 0) {
+            return null;
+        }
+        return currentSection.subSections[prevIndex];
+    }, [currentIndex, currentSection]);
+
     React.useEffect(() => {
         setActiveTab(tabId === Tab.Design ? Tab.Design : Tab.Overview);
     }, [tabId]);
@@ -140,6 +191,12 @@ export const Component: React.FC<ComponentProps> = ({libId, component, readmeCon
                             rewriteLinks={rewriteLinks}
                             withComponents
                         />
+                        <div className={b('navigation')}>
+                            <ArticleNavigation
+                                prevSection={prevSection}
+                                nextSection={nextSection}
+                            />
+                        </div>
                     </>
                 )}
             </div>

src/components/ComponentsLayout/ComponentsLayout.tsx

@@ -1,34 +1,20 @@
-import React, {useMemo} from 'react';
+import React from 'react';
 
-import {libs} from '../../content/components';
 import {NavigationLayout, Section} from '../NavigationLayout/NavigationLayout';
 
 export type ComponentsLayoutProps = {
     libId: string;
     componentId?: string;
     children?: React.ReactNode;
+    sections: Section[];
 };
 
 export const ComponentsLayout: React.FC<ComponentsLayoutProps> = ({
     libId,
     componentId,
     children,
+    sections,
 }) => {
-    const sections = useMemo<Section[]>(() => {
-        return libs.map((lib) => ({
-            id: lib.id,
-            title: lib.title,
-            // url: `/components/${lib.id}`, // "Overview" link
-            subSections: lib.components.map((component) => ({
-                id: component.id,
-                title: component.title,
-                url:
-                    component.isComingSoon === true ? '#' : `/components/${lib.id}/${component.id}`,
-                isComingSoon: component.isComingSoon,
-            })),
-        }));
-    }, []);
-
     return (
         <NavigationLayout
             sections={sections}

src/components/DesignArticle/DesignArticle.scss

@@ -19,4 +19,7 @@ $block: '.#{variables.$ns}design-article';
         line-height: 48px;
         font-weight: 600;
     }
+    &__navigation {
+        margin-top: var(--g-spacing-10);
+    }
 }

src/components/DesignArticle/DesignArticle.tsx

@@ -1,23 +1,76 @@
-import React from 'react';
+import React, {useMemo} from 'react';
 
 import {Article} from '../../content/design/types';
 import {block} from '../../utils';
+import {ArticleNavigation} from '../ArticleNavigation/ArticleNavigation';
 import {MDXRenderer} from '../MDXRenderer/MDXRenderer';
+import {Section} from '../NavigationLayout/types';
 
 import './DesignArticle.scss';
 
 const b = block('design-article');
 
 export type DesignArticleProps = {
     article: Article;
+    articleId?: string;
+    sectionId?: string;
+    sections: Section[];
 };
 
-export const DesignArticle: React.FC<DesignArticleProps> = ({article}) => {
+export const DesignArticle: React.FC<DesignArticleProps> = ({
+    article,
+    articleId,
+    sectionId,
+    sections,
+}) => {
+    const currentSection = useMemo(
+        () => sections.find((item) => item.id === sectionId),
+        [sectionId, sections],
+    );
+
+    const currentIndex = useMemo(() => {
+        if (!currentSection || !currentSection.subSections) {
+            return null;
+        }
+        return currentSection.subSections.findIndex((item) => item.id === articleId);
+    }, [currentSection, articleId]);
+
+    const nextSection = useMemo(() => {
+        if (
+            !currentSection ||
+            !currentSection.subSections ||
+            (!currentIndex && currentIndex !== 0)
+        ) {
+            return null;
+        }
+        const nextIndex = currentIndex + 1;
+        if (nextIndex >= currentSection.subSections.length) {
+            return null;
+        }
+        return currentSection.subSections[nextIndex];
+    }, [currentIndex, currentSection]);
+
+    const prevSection = useMemo(() => {
+        if (
+            !currentSection ||
+            !currentSection.subSections ||
+            (!currentIndex && currentIndex !== 0)
+        ) {
+            return null;
+        }
+        const prevIndex = currentIndex - 1;
+        if (prevIndex < 0) {
+            return null;
+        }
+        return currentSection.subSections[prevIndex];
+    }, [currentIndex, currentSection]);
+
     return (
         <div className={b()}>
             <h1 className={b('title')}>{article.title}</h1>
-            <div className={b('content')}>
-                <MDXRenderer text={article.content} />
+            <MDXRenderer text={article.content} />
+            <div className={b('navigation')}>
+                <ArticleNavigation prevSection={prevSection} nextSection={nextSection} />
             </div>
         </div>
     );