feat(DocPage): Add updatedAt meta

demo/src/Components/DocPage/page-en.json

@@ -149,7 +149,8 @@
         "name": "Anastasia Karavaeva",
         "url": ""
       }
-    ]
+    ],
+    "updatedAt": "2024-01-15T15:00:00.000Z"
   },
   "toc": {
     "title": "Yandex.Cloud overview",

demo/src/Components/DocPage/page-he.json

@@ -114,7 +114,8 @@
         "name": "DataUI VCS Robot",
         "url": ""
       }
-    ]
+    ],
+    "updatedAt": "2024-01-15T15:00:00.000Z"
   },
   "toc": {
     "title": "סקירת פלטפורמה",

demo/src/Components/DocPage/page-ru.json

@@ -114,7 +114,8 @@
         "name": "DataUI VCS Robot",
         "url": ""
       }
-    ]
+    ],
+    "updatedAt": "2024-01-15T15:00:00.000Z"
   },
   "toc": {
     "title": "Обзор платформы",

src/components/DocPage/DocPage.tsx

@@ -1,4 +1,4 @@
-import React, {ReactPortal} from 'react';
+import React, {Fragment, ReactPortal} from 'react';
 
 import {Link} from '@gravity-ui/icons';
 import block from 'bem-cn-lite';
@@ -28,6 +28,7 @@ import {HTML} from '../HTML';
 import {MiniToc} from '../MiniToc';
 import {SearchBar, withHighlightedSearchWords} from '../SearchBar';
 import {TocNavPanel} from '../TocNavPanel';
+import UpdatedAtDate from '../UpdatedAtDate/UpdatedAtDate';
 
 import './DocPage.scss';
 
@@ -382,18 +383,30 @@ class DocPage extends React.Component<DocPageInnerProps, DocPageState> {
             return null;
         }
 
+        const updatedAt = this.renderUpdatedAt(meta?.updatedAt);
         const author = this.renderAuthor(!meta?.contributors?.length);
         const contributors = this.renderContributors();
 
-        const separator = author && contributors && <div className={b('separator')}>{','}</div>;
-
         return (
             <div className={b('page-contributors')}>
-                {author} {separator} {contributors}
+                {[updatedAt, author, contributors].filter(Boolean).map((element, idx, arr) => (
+                    <Fragment key={idx}>
+                        {element}
+                        {arr.length - 1 !== idx && <div className={b('separator')}>{','}</div>}
+                    </Fragment>
+                ))}
             </div>
         );
     }
 
+    private renderUpdatedAt(updatedAt?: string) {
+        if (!updatedAt) {
+            return null;
+        }
+
+        return <UpdatedAtDate updatedAt={updatedAt} />;
+    }
+
     private renderAuthor(onlyAuthor: boolean) {
         const {meta} = this.props;
 

src/components/UpdatedAtDate/UpdatedAtDate.scss

@@ -0,0 +1,10 @@
+@import '../../styles/mixins';
+
+.updated-at-date {
+    display: flex;
+    margin: 0 0 32px;
+
+    &__title {
+        @include contributors-text();
+    }
+}

src/components/UpdatedAtDate/UpdatedAtDate.tsx

@@ -0,0 +1,35 @@
+import React, {memo, useMemo} from 'react';
+
+import block from 'bem-cn-lite';
+
+import {getConfig} from '../../config';
+import {useTranslation} from '../../hooks';
+import {format} from '../../utils/date';
+
+import './UpdatedAtDate.scss';
+
+const b = block('updated-at-date');
+
+export interface UpdatedAtDateProps {
+    updatedAt: string;
+    translationName?: string;
+}
+
+const UpdatedAtDate: React.FC<UpdatedAtDateProps> = (props) => {
+    const {updatedAt, translationName = 'updated-at-date'} = props;
+    const {t} = useTranslation(translationName);
+
+    const updatedAtFormatted = useMemo(() => {
+        const {localeCode} = getConfig();
+        return format(updatedAt, 'longDateTime', localeCode);
+    }, [updatedAt]);
+
+    return (
+        <div className={b()}>
+            <div className={b('title')}>{t<string>('title')}</div>
+            {updatedAtFormatted}
+        </div>
+    );
+};
+
+export default memo(UpdatedAtDate);

src/i18n/en.json

@@ -113,5 +113,8 @@
   "paginator": {
     "next": "Next page",
     "prev": "Previous page"
+  },
+  "updated-at-date": {
+    "label-updated-at": "Updated at"
   }
 }

src/i18n/ru.json

@@ -113,5 +113,8 @@
   "paginator": {
     "next": "Следующая страница",
     "prev": "Предыдущая страница"
+  },
+  "updated-at-date": {
+    "label-updated-at": "Обновлено"
   }
 }

src/models/index.ts

@@ -19,6 +19,7 @@ export enum ControlSizes {
 export interface Config {
     lang?: string;
     loc?: Loc;
+    localeCode?: string;
 }
 
 export interface DocSettings {
@@ -92,6 +93,7 @@ export interface DocMeta {
     contributors?: Contributor[];
     author?: unknown | Contributor;
     __system?: Record<string, unknown>;
+    updatedAt?: string;
 }
 
 export interface TocData {

src/utils/date.ts

@@ -0,0 +1,81 @@
+interface DateTimeFormatter {
+    longDate: Intl.DateTimeFormat;
+    shortDate: Intl.DateTimeFormat;
+    longMonthDay: Intl.DateTimeFormat;
+    shortMonthDay: Intl.DateTimeFormat;
+    longDateTime: Intl.DateTimeFormat;
+    shortDateTime: Intl.DateTimeFormat;
+    shortTime: Intl.DateTimeFormat;
+    nanoTime: Intl.DateTimeFormat;
+    year: Intl.DateTimeFormat;
+}
+
+const defaultRegion = 'en';
+
+const dateTimeFormatters: Map<string, DateTimeFormatter> = new Map();
+
+function getDateTimeFormatter(localeCode: string): DateTimeFormatter {
+    if (!dateTimeFormatters.has(localeCode)) {
+        const formatters = {
+            // December 20, 2012
+            longDate: new Intl.DateTimeFormat(localeCode, {
+                year: 'numeric',
+                month: 'long',
+                day: 'numeric',
+            }),
+            // 4/30/2021
+            shortDate: new Intl.DateTimeFormat(localeCode, {
+                year: 'numeric',
+                month: 'numeric',
+                day: 'numeric',
+            }),
+            // December 20
+            longMonthDay: new Intl.DateTimeFormat(localeCode, {month: 'long', day: 'numeric'}),
+            // 12/20
+            shortMonthDay: new Intl.DateTimeFormat(localeCode, {month: 'numeric', day: 'numeric'}),
+            // April 27, 2021, 3:03 PM
+            longDateTime: new Intl.DateTimeFormat(localeCode, {
+                year: 'numeric',
+                month: 'long',
+                day: 'numeric',
+                hour: 'numeric',
+                minute: 'numeric',
+            }),
+            // 4/30/2021, 2:30 PM
+            shortDateTime: new Intl.DateTimeFormat(localeCode, {
+                year: 'numeric',
+                month: 'numeric',
+                day: 'numeric',
+                hour: 'numeric',
+                minute: 'numeric',
+            }),
+            // 12:30
+            shortTime: new Intl.DateTimeFormat(localeCode, {hour: 'numeric', minute: 'numeric'}),
+            // 30:58
+            nanoTime: new Intl.DateTimeFormat(localeCode, {
+                minute: 'numeric',
+                second: 'numeric',
+            }),
+            // 2023
+            year: new Intl.DateTimeFormat(localeCode, {
+                year: 'numeric',
+            }),
+        };
+        dateTimeFormatters.set(localeCode, formatters);
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- formatter will be always inserted above
+    return dateTimeFormatters.get(localeCode)!;
+}
+
+export const format = (
+    date: string | number,
+    formatCode: keyof DateTimeFormatter,
+    localeCode = defaultRegion,
+) => {
+    let result = getDateTimeFormatter(localeCode)[formatCode].format(new Date(date));
+    if (formatCode === 'longDate' && ['ru-RU', 'ru-KZ'].includes(localeCode)) {
+        result = result.replace(/\sг\.$/, '');
+    }
+    return result;
+};