@redocly/theme 0.61.0-next.1 → 0.61.0-next.3

package/lib/core/hooks/use-page-actions.js

@@ -23,6 +23,13 @@ const use_mcp_config_1 = require("./use-mcp-config");
 const clipboard_service_1 = require("../utils/clipboard-service");
 const dom_1 = require("../utils/dom");
 const mcp_1 = require("../utils/mcp");
+function createPageActionResource(pageSlug, pageUrl) {
+    return {
+        id: pageSlug,
+        object: 'page',
+        uri: pageUrl,
+    };
+}
 const DEFAULT_ENABLED_ACTIONS = [
     'copy',
     'view',
@@ -33,10 +40,11 @@ const DEFAULT_ENABLED_ACTIONS = [
 ];
 function usePageActions(pageSlug, mcpUrl, actions) {
     var _a, _b, _c;
-    const { useTranslate, usePageData, usePageProps, usePageSharedData } = (0, use_theme_hooks_1.useThemeHooks)();
+    const { useTranslate, usePageData, usePageProps, usePageSharedData, useTelemetry } = (0, use_theme_hooks_1.useThemeHooks)();
     const { translate } = useTranslate();
     const themeConfig = (0, use_theme_config_1.useThemeConfig)();
     const pageProps = usePageProps();
+    const telemetry = useTelemetry();
     const openApiSharedData = usePageSharedData('openAPIDocsStore');
     const mcpConfig = (0, use_mcp_config_1.useMCPConfig)();
     const shouldHideAllActions = shouldHidePageActions(pageProps, themeConfig, (_a = openApiSharedData === null || openApiSharedData === void 0 ? void 0 : openApiSharedData.options) === null || _a === void 0 ? void 0 : _a.excludeFromSearch);
@@ -49,8 +57,18 @@ function usePageActions(pageSlug, mcpUrl, actions) {
         const config = requiresMcpUrl
             ? { serverName: mcpConfig.serverName, url: mcpUrl || '' }
             : { serverName: mcpConfig.serverName, url: mcpConfig.serverUrl || '' };
-        return createMCPAction({ clientType, mcpConfig: config, translate });
-    }, [mcpUrl, mcpConfig, translate]);
+        const isDocsMcp = !requiresMcpUrl;
+        const origin = dom_1.IS_BROWSER ? window.location.origin : '';
+        const pageUrl = `${origin}${pageSlug}`;
+        return createMCPAction({
+            clientType,
+            mcpConfig: config,
+            translate,
+            onClickCallback: isDocsMcp
+                ? () => telemetry.sendPageActionsButtonClickedMessage(Object.assign(Object.assign({}, createPageActionResource(pageSlug, pageUrl)), { action_type: `docs-mcp-${clientType}` }))
+                : undefined,
+        });
+    }, [mcpUrl, mcpConfig, translate, telemetry, pageSlug]);
     const result = (0, react_1.useMemo)(() => {
         var _a, _b, _c;
         if (shouldHideAllActions) {
@@ -60,10 +78,11 @@ function usePageActions(pageSlug, mcpUrl, actions) {
             ? window.location.origin
             : ((_a = globalThis['SSR_HOSTNAME']) !== null && _a !== void 0 ? _a : '');
         const normalizedSlug = pageSlug.startsWith('/') ? pageSlug : '/' + pageSlug;
+        const pageUrl = `${origin}${normalizedSlug}`;
         const mdPageUrl = new URL(origin + normalizedSlug + (normalizedSlug === '/' ? 'index.html.md' : '.md')).toString();
         const actionHandlers = {
-            'docs-mcp-cursor': createMCPHandler('cursor'),
-            'docs-mcp-vscode': createMCPHandler('vscode'),
+            'docs-mcp-cursor': createMCPHandler('cursor', false),
+            'docs-mcp-vscode': createMCPHandler('vscode', false),
             'mcp-cursor': createMCPHandler('cursor', true),
             'mcp-vscode': createMCPHandler('vscode', true),
             copy: () => ({
@@ -79,6 +98,7 @@ function usePageActions(pageSlug, mcpUrl, actions) {
                         }
                         const text = yield result.text();
                         clipboard_service_1.ClipboardService.copyCustom(text);
+                        telemetry.sendPageActionsButtonClickedMessage(Object.assign(Object.assign({}, createPageActionResource(pageSlug, pageUrl)), { action_type: 'copy' }));
                     }
                     catch (error) {
                         console.error(error);
@@ -91,6 +111,9 @@ function usePageActions(pageSlug, mcpUrl, actions) {
                 description: translate('page.actions.viewAsMdDescription', 'Open this page as Markdown'),
                 iconComponent: MarkdownFullIcon_1.MarkdownFullIcon,
                 link: mdPageUrl,
+                onClick: () => {
+                    telemetry.sendPageActionsButtonClickedMessage(Object.assign(Object.assign({}, createPageActionResource(pageSlug, pageUrl)), { action_type: 'view' }));
+                },
             }),
             chatgpt: () => {
                 if (!isPublic) {
@@ -102,6 +125,9 @@ function usePageActions(pageSlug, mcpUrl, actions) {
                     description: translate('page.actions.chatGptDescription', 'Get insights from ChatGPT'),
                     iconComponent: ChatGptIcon_1.ChatGptIcon,
                     link: getExternalAiPromptLink('https://chat.openai.com', mdPageUrl),
+                    onClick: () => {
+                        telemetry.sendPageActionsButtonClickedMessage(Object.assign(Object.assign({}, createPageActionResource(pageSlug, pageUrl)), { action_type: 'chatgpt' }));
+                    },
                 };
             },
             claude: () => {
@@ -114,6 +140,9 @@ function usePageActions(pageSlug, mcpUrl, actions) {
                     description: translate('page.actions.claudeDescription', 'Get insights from Claude'),
                     iconComponent: ClaudeIcon_1.ClaudeIcon,
                     link: getExternalAiPromptLink('https://claude.ai/new', mdPageUrl),
+                    onClick: () => {
+                        telemetry.sendPageActionsButtonClickedMessage(Object.assign(Object.assign({}, createPageActionResource(pageSlug, pageUrl)), { action_type: 'claude' }));
+                    },
                 };
             },
         };
@@ -128,6 +157,7 @@ function usePageActions(pageSlug, mcpUrl, actions) {
         translate,
         isPublic,
         createMCPHandler,
+        telemetry,
     ]);
     return result;
 }
@@ -137,10 +167,11 @@ function getExternalAiPromptLink(baseUrl, mdPageUrl) {
     url.searchParams.set('q', externalAiPrompt);
     return url.toString();
 }
-function createMCPAction({ clientType, mcpConfig, translate }) {
+function createMCPAction({ clientType, mcpConfig, translate, onClickCallback, }) {
     const url = (0, mcp_1.generateMCPDeepLink)(clientType, mcpConfig);
     const sharedProps = {
         onClick: () => {
+            onClickCallback === null || onClickCallback === void 0 ? void 0 : onClickCallback();
             window.open(url, '_blank');
         },
     };

package/lib/core/hooks/use-product-picker.js

@@ -2,8 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useProductPicker = useProductPicker;
 const react_router_dom_1 = require("react-router-dom");
+const utils_1 = require("../../components/Product/utils");
 const use_theme_hooks_1 = require("./use-theme-hooks");
-const utils_1 = require("../utils");
+const utils_2 = require("../utils");
 function useProductPicker() {
     const { useCurrentProduct, useProducts, useTelemetry, useLoadAndNavigate } = (0, use_theme_hooks_1.useThemeHooks)();
     const currentProduct = useCurrentProduct();
@@ -15,7 +16,16 @@ function useProductPicker() {
         if (!product)
             return;
         telemetry.sendProductPickedMessage({ product: product.slug });
-        loadAndNavigate({ navigate, to: (0, utils_1.withPathPrefix)(product.link) });
+        if (typeof document === 'undefined')
+            return;
+        if (product.name) {
+            const root = document.documentElement;
+            Array.from(root.classList)
+                .filter((c) => c.startsWith('product-'))
+                .forEach((c) => root.classList.remove(c));
+            root.classList.add((0, utils_1.getProductClassName)(product.name));
+        }
+        loadAndNavigate({ navigate, to: (0, utils_2.withPathPrefix)(product.link) });
     }
     return {
         currentProduct,

package/lib/core/hooks/use-store.d.ts

@@ -0,0 +1,17 @@
+type Store<T> = {
+    getValue: (defaultValue: T) => T;
+    setValue: (next: T) => void;
+    subscribe: (callback: () => void) => Unsubscribe;
+};
+type Unsubscribe = () => void;
+type CreateStoreProps<T> = {
+    storageKey: string;
+    storageType?: 'localStorage' | 'sessionStorage';
+    serializer?: {
+        parse: (value: string) => T;
+        serialize: (value: T) => string;
+    };
+};
+export declare function createStore<T>({ storageKey, storageType, serializer, }: CreateStoreProps<T>): Store<T>;
+export declare function useStore<T>(store: Store<T>, defaultValue: T): readonly [T, (next: T) => void];
+export {};

package/lib/core/hooks/use-store.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStore = createStore;
+exports.useStore = useStore;
+const react_1 = require("react");
+const js_utils_1 = require("../utils/js-utils");
+function createStore({ storageKey, storageType = 'localStorage', serializer = {
+    parse: (value) => JSON.parse(value),
+    serialize: (value) => JSON.stringify(value),
+}, }) {
+    const subscribers = new Set();
+    let cachedValue;
+    const shouldSerialize = (value) => typeof value !== 'string';
+    const getValue = (defaultValue) => {
+        if (!(0, js_utils_1.isBrowser)())
+            return defaultValue;
+        if (cachedValue !== undefined)
+            return cachedValue;
+        const value = window[storageType].getItem(storageKey);
+        if (!value) {
+            cachedValue = defaultValue;
+            return cachedValue;
+        }
+        if (!shouldSerialize(defaultValue)) {
+            cachedValue = value;
+            return cachedValue;
+        }
+        try {
+            cachedValue = JSON.parse(value);
+        }
+        catch (_a) {
+            cachedValue = defaultValue;
+        }
+        return cachedValue;
+    };
+    const setValue = (next) => {
+        if (!(0, js_utils_1.isBrowser)())
+            return;
+        try {
+            window[storageType].setItem(storageKey, shouldSerialize(next) ? serializer.serialize(next) : next);
+            cachedValue = next;
+            subscribers.forEach((callback) => callback());
+        }
+        catch (_a) {
+            return;
+        }
+    };
+    const subscribe = (callback) => {
+        subscribers.add(callback);
+        return () => {
+            subscribers.delete(callback);
+        };
+    };
+    return {
+        getValue,
+        setValue,
+        subscribe,
+    };
+}
+function useStore(store, defaultValue) {
+    const value = (0, react_1.useSyncExternalStore)(store.subscribe, () => store.getValue(defaultValue), () => defaultValue);
+    return [value, store.setValue];
+}
+//# sourceMappingURL=use-store.js.map

package/lib/core/hooks/use-telemetry-fallback.d.ts

@@ -1,6 +1,7 @@
 export declare const useTelemetryFallback: () => {
     send: () => void;
     sendPageViewedMessage: () => void;
+    sendPageActionsButtonClickedMessage: () => void;
     sendErrorMessage: () => void;
     sendClientErrorMessage: () => void;
     sendBreadcrumbClickedMessage: () => void;
@@ -61,6 +62,7 @@ export declare const useTelemetryFallback: () => {
     sendAsyncapiDocsMessageClickedMessage: () => void;
     sendAsyncapiDocsServerModalOpenedMessage: () => void;
     sendAsyncapiDocsDownloadDefinitionClickedMessage: () => void;
+    sendAsyncapiDocsReferencedInClickedMessage: () => void;
     sendGraphqlDocsViewedMessage: () => void;
     sendGraphqlDocsPerformanceMetricsMessage: () => void;
     sendGraphqlDocsReferencedInLinkClickedMessage: () => void;

package/lib/core/hooks/use-telemetry-fallback.js

@@ -6,6 +6,7 @@ exports.useTelemetryFallback = void 0;
 const useTelemetryFallback = () => ({
     send: () => { },
     sendPageViewedMessage: () => { },
+    sendPageActionsButtonClickedMessage: () => { },
     sendErrorMessage: () => { },
     sendClientErrorMessage: () => { },
     sendBreadcrumbClickedMessage: () => { },
@@ -66,6 +67,7 @@ const useTelemetryFallback = () => ({
     sendAsyncapiDocsMessageClickedMessage: () => { },
     sendAsyncapiDocsServerModalOpenedMessage: () => { },
     sendAsyncapiDocsDownloadDefinitionClickedMessage: () => { },
+    sendAsyncapiDocsReferencedInClickedMessage: () => { },
     sendGraphqlDocsViewedMessage: () => { },
     sendGraphqlDocsPerformanceMetricsMessage: () => { },
     sendGraphqlDocsReferencedInLinkClickedMessage: () => { },

package/lib/core/types/catalog.d.ts

@@ -33,10 +33,6 @@ export type UseCatalogResponse = {
     layout: LayoutVariant;
     collapsedSidebar: boolean;
 };
-export type UseCatalogFetchCatalogEntities = (params: CatalogApiParams, initialData?: BffCatalogEntityList) => CatalogApiResults<BffCatalogEntity>;
-export type UseCatalogFetchCatalogEntitiesRelations = (params: CatalogApiParams & {
-    entityKey: string;
-}, initialData?: BffCatalogRelatedEntityList) => CatalogApiResults<BffCatalogRelatedEntity>;
 export type UseCatalogSortResponse = {
     sortOption: SortOption | null;
     setSortOption: (option: SortOption | null) => void;
@@ -109,6 +105,7 @@ export type CatalogApiParams = {
     filter?: string;
     sort?: string;
     search?: string;
+    entityVersion?: string | null;
 };
 export type UseCatalogEntitiesProps = {
     entitiesTypes: string[];
@@ -136,6 +133,7 @@ export type BffCatalogRelatedEntity = {
     sourceFile?: string | null;
     metadata?: Record<string, any>;
     version?: string | null;
+    revision?: string | null;
     readonly createdAt: string | null;
     readonly updatedAt: string | null;
 };
@@ -171,6 +169,7 @@ export type BffCatalogEntity = {
     readonly revision: string;
     readonly isCurrent?: boolean | null;
     readonly isDefaultVersion?: boolean | null;
+    readonly isDeleted?: boolean | null;
     readonly createdAt: string;
     readonly updatedAt: string;
 };
@@ -189,5 +188,35 @@ export type Page = {
     limit: number;
     total: number;
 };
+export type BffCatalogEntityRevision = {
+    readonly version: string | null;
+    readonly revision: string | null;
+    readonly isCurrent: boolean | null;
+    readonly isDefaultVersion: boolean | null;
+    readonly createdAt: string | null;
+    readonly updatedAt: string | null;
+};
+export type BffCatalogEntityRevisionList = BffCatalogList<BffCatalogEntityRevision>;
 export type EntityRelationType = (typeof ENTITY_RELATION_TYPES)[number];
 export type ListType = 'default' | 'team' | 'api-operation' | 'data-schema';
+export type CatalogEntityRevision = {
+    name: string;
+    date: string;
+    revisionDate: string | null;
+    isActive?: boolean;
+    isCurrent?: boolean;
+};
+export type CatalogEntityVersionHistoryGroup = {
+    version: string;
+    date: string;
+    isCurrent?: boolean;
+    isExpanded?: boolean;
+    revisions?: CatalogEntityRevision[];
+    singleRevisionDate?: string | null;
+    hasCurrentRevisionFromBackend?: boolean;
+    isDefaultVersion?: boolean;
+};
+export type SidebarConnectedEntity = {
+    key: string;
+    version?: string;
+};

package/lib/core/types/common.d.ts

@@ -1 +1,3 @@
+import { DEFAULT_COLOR_MODES } from '../constants';
 export type Plural<T extends string> = `${T}s`;
+export type ColorMode = (typeof DEFAULT_COLOR_MODES)[keyof typeof DEFAULT_COLOR_MODES];

package/lib/core/types/hooks.d.ts

@@ -3,8 +3,9 @@ import type { BannerConfig, PageData, PageProps, ResolvedNavItemWithLink, Versio
 import type { ShikiTransformer } from '@shikijs/types';
 import type { Callback, TFunction as TFunc } from 'i18next';
 import type { To, Location, NavigateFunction } from 'react-router-dom';
+import type { UseQueryResult } from '@tanstack/react-query';
 import type { CatalogConfig, ProductUiConfig } from '../../config';
-import type { UseCatalogResponse, FilteredCatalog, UseCatalogSortResponse, UseCatalogSearchResponse, UseCatalogProps, UseCatalogFetchCatalogEntities, UseCatalogFetchCatalogEntitiesRelations } from './catalog';
+import type { UseCatalogResponse, FilteredCatalog, UseCatalogSortResponse, UseCatalogSearchResponse, UseCatalogProps, CatalogApiParams, CatalogApiResults } from './catalog';
 import type { UserMenuData } from './user-menu';
 import type { ItemState } from './sidebar';
 import type { SearchItemData, SearchFacet, SearchFilterItem, SearchFacetQuery, AiSearchConversationItem } from './search';
@@ -12,6 +13,7 @@ import type { SubmitFeedbackParams } from './feedback';
 import type { TFunction } from './l10n';
 import type { BreadcrumbItem } from './breadcrumb';
 import type { DrilldownMenuItemDetails } from './sidebar';
+import { BffCatalogEntity, BffCatalogEntityList, BffCatalogRelatedEntity, BffCatalogRelatedEntityList, BffCatalogEntityRevision, BffCatalogEntityRevisionList } from './catalog';
 import { AiSearchError } from '../constants/search';
 export type ThemeHooks = {
     useTranslate: () => {
@@ -124,8 +126,17 @@ export type ThemeHooks = {
     useCatalog: (props?: UseCatalogProps) => UseCatalogResponse;
     useCatalogSort: () => UseCatalogSortResponse;
     useCatalogSearch: () => UseCatalogSearchResponse;
-    useFetchCatalogEntities: UseCatalogFetchCatalogEntities;
-    useFetchCatalogEntitiesRelations: UseCatalogFetchCatalogEntitiesRelations;
+    useFetchCatalogEntities: (params: CatalogApiParams, initialData?: BffCatalogEntityList) => CatalogApiResults<BffCatalogEntity>;
+    useFetchCatalogEntitiesRelations: (params: CatalogApiParams & {
+        entityKey: string;
+    }, initialData?: BffCatalogRelatedEntityList) => CatalogApiResults<BffCatalogRelatedEntity>;
+    useFetchCatalogEntityRevisions: (params: {
+        entityKey: string;
+        version?: string | null;
+    }) => {
+        query: UseQueryResult<BffCatalogEntityRevisionList, Error>;
+        items: BffCatalogEntityRevision[];
+    };
     useCatalogClassic: (config: CatalogConfig) => FilteredCatalog;
     useTelemetry: () => Omit<AsyncApiRealmUI.Telemetry, 'init' | 'updateCloudEventData' | 'forceFlush' | 'startSpan' | 'constructCloudEvent' | 'sendToOtelService'>;
     useUserTeams: () => string[];

package/lib/core/types/l10n.d.ts

@@ -1,5 +1,5 @@
 import type { TOptions } from 'i18next';
-export type TranslationKey = 'dev.newApp' | 'dev.newApp.text' | 'dev.sidebar.header' | 'dev.sidebar.footer.text' | 'dev.create.app.dialog.appName.placeholder' | 'dev.create.app.dialog.appName.error' | 'dev.create.app.dialog.selectAPIs' | 'dev.create.app.dialog.description' | 'dev.create.app.dialog.description.placeholder' | 'dev.create.app.dialog.create' | 'dev.create.app.dialog.cancel' | 'dev.main.tab.appKeys' | 'dev.main.tab.logs' | 'dev.app.description.title' | 'dev.edit.description.dialog.title' | 'dev.edit.description.dialog.save' | 'dev.edit.description.dialog.cancel' | 'dev.edit.apis.dialog.selectedAPIs' | 'dev.app.key.create' | 'dev.create.key.dialog.title' | 'dev.create.key.dialog.create' | 'dev.create.key.dialog.cancel' | 'dev.app.edit' | 'dev.app.delete' | 'dev.edit.app.dialog.title' | 'dev.edit.app.dialog.save' | 'dev.edit.app.dialog.cancel' | 'dev.delete.app.dialog.title' | 'dev.delete.app.dialog.confirmation' | 'dev.delete.app.dialog.delete' | 'dev.delete.app.dialog.cancel' | 'dev.app.key.roll' | 'dev.roll.key.dialog.title' | 'dev.roll.key.dialog.apiKey' | 'dev.roll.key.dialog.expires' | 'dev.roll.key.dialog.confirmation' | 'dev.roll.key.dialog.cancel' | 'dev.roll.key.dialog.roll' | 'dev.update.key.dialog.title' | 'dev.update.key.dialog.update' | 'dev.update.key.dialog.cancel' | 'dev.app.key.api.name' | 'dev.app.key.api.status' | 'dev.app.key.api.edit' | 'dev.edit.apis.dialog.title' | 'dev.edit.apis.dialog.apiKey' | 'dev.edit.apis.dialog.save' | 'dev.edit.apis.dialog.cancel' | 'dev.select.placeholder' | 'dev.app.overview.status.pending' | 'dev.app.overview.status.approved' | 'dev.app.overview.status.revoked' | 'dev.app.overview.status' | 'dev.app.overview.non-production' | 'dev.app.overview.production' | 'dev.app.overview.clientId' | 'dev.app.overview.apiKey' | 'dev.app.key.revoke' | 'dev.revoke.key.dialog.title' | 'dev.revoke.key.dialog.apiKey' | 'dev.revoke.key.dialog.expires' | 'dev.revoke.key.dialog.confirmation' | 'dev.revoke.key.dialog.revoke' | 'dev.revoke.key.dialog.cancel' | 'dev.app.overview.expires' | 'dev.app.overview.created' | 'dev.app.overview.visibilityToggle.hide' | 'dev.app.overview.visibilityToggle.show' | 'search.loading' | 'search.noResults.title' | 'search.keys.navigate' | 'search.keys.select' | 'search.keys.exit' | 'search.label' | 'search.cancel' | 'search.recent' | 'search.navbar.label' | 'search.suggested' | 'search.showMore' | 'search.filter.title' | 'search.filter.reset' | 'search.filter.field.reset' | 'search.ai.welcomeText' | 'search.ai.newConversation' | 'search.ai.backToSearch' | 'search.ai.back' | 'search.ai.placeholder' | 'search.ai.generatingResponse' | 'search.ai.followUpQuestion' | 'search.ai.suggestionsTitle' | 'search.ai.thinkingText' | 'search.ai.resourcesFound' | 'search.ai.resourcesFound.basedOn' | 'search.ai.resourcesFound.resources' | 'search.ai.feedback.title' | 'search.ai.feedback.detailsPlaceholder' | 'search.ai.feedback.thanks' | 'search.ai.button' | 'search.ai.label' | 'search.ai.disclaimer' | 'search.ai.error.description' | 'search.ai.error.description.forbidden' | 'search.ai.error.description.unauthorized' | 'search.ai.error.header' | 'search.ai.error.header.forbidden' | 'search.ai.error.header.unauthorized' | 'search.ai.feedback.more' | 'search.searchItem.deprecated' | 'search.groups.all' | 'search.filter.field.footer' | 'aiAssistant.trigger' | 'toc.header' | 'footer.copyrightText' | 'page.homeButton' | 'page.forbidden.title' | 'page.notFound.title' | 'page.notFound.description' | 'page.lastUpdated.timeago' | 'page.lastUpdated.on' | 'catalog.filters.placeholder' | 'catalog.filters.title' | 'catalog.filters.add' | 'catalog.filters.clearAll' | 'catalog.filters.select.addFilter' | 'catalog.filters.select.all' | 'catalog.filters.done' | 'catalog.catalogs.all.title' | 'catalog.catalogs.all.description' | 'catalog.catalogs.all.switcherLabel' | 'catalog.catalogs.service.title' | 'catalog.catalogs.service.description' | 'catalog.catalogs.service.switcherLabel' | 'catalog.catalogs.user.title' | 'catalog.catalogs.user.description' | 'catalog.catalogs.user.switcherLabel' | 'catalog.catalogs.team.title' | 'catalog.catalogs.team.description' | 'catalog.catalogs.team.switcherLabel' | 'catalog.catalogs.domain.title' | 'catalog.catalogs.domain.description' | 'catalog.catalogs.domain.switcherLabel' | 'catalog.catalogs.apiDescription.title' | 'catalog.catalogs.apiDescription.description' | 'catalog.catalogs.apiDescription.switcherLabel' | 'catalog.catalogs.dataSchema.title' | 'catalog.catalogs.dataSchema.description' | 'catalog.catalogs.dataSchema.switcherLabel' | 'catalog.catalogs.apiOperation.title' | 'catalog.catalogs.apiOperation.description' | 'catalog.catalogs.apiOperation.switcherLabel' | 'catalog.entity.metadata.title' | 'catalog.entity.schema.title' | 'catalog.entity.properties.apiDescription.title' | 'catalog.backToAllLabel' | 'catalog.tags.more' | 'catalog.tags.label' | 'catalog.sort' | 'catalog.catalogs.label' | 'catalog.owners.label' | 'catalog.repositories.label' | 'catalog.email.label' | 'catalog.format.label' | 'catalog.entityType.label' | 'catalog.domains.label' | 'catalog.contact.label' | 'catalog.methodAndPath.label' | 'catalog.links.label' | 'catalog.metadata.domains' | 'catalog.metadata.owners' | 'sidebar.menu.backLabel' | 'sidebar.menu.backToLabel' | 'sidebar.actions.show' | 'sidebar.actions.hide' | 'sidebar.actions.changeToSingleColumn' | 'sidebar.actions.changeToTwoColumns' | 'sidebar.actions.singleColumn' | 'sidebar.actions.twoColumns' | 'versionPicker.label' | 'versionPicker.unversioned' | 'codeSnippet.copy.buttonText' | 'codeSnippet.copy.tooltipText' | 'codeSnippet.copy.toasterText' | 'markdown.editPage.text' | 'feedback.settings.comment.submitText' | 'feedback.settings.comment.label' | 'feedback.settings.comment.send' | 'feedback.settings.comment.cancel' | 'feedback.settings.comment.satisfiedLabel' | 'feedback.settings.comment.neutralLabel' | 'feedback.settings.comment.dissatisfiedLabel' | 'feedback.settings.submitText' | 'feedback.settings.label' | 'feedback.settings.reasons.label' | 'feedback.submit' | 'feedback.cancel' | 'feedback.settings.comment.likeLabel' | 'feedback.settings.comment.dislikeLabel' | 'feedback.sentiment.thumbUp' | 'feedback.sentiment.thumbDown' | 'feedback.settings.leftScaleLabel' | 'feedback.settings.rightScaleLabel' | 'feedback.settings.optionalEmail.placeholder' | 'feedback.settings.optionalEmail.label' | 'codeSnippet.report.buttonText' | 'codeSnippet.report.tooltipText' | 'codeSnippet.report.label' | 'codeSnippet.expand.tooltipText' | 'codeSnippet.collapse.tooltipText' | 'userMenu.login' | 'userMenu.logout' | 'userMenu.devOnboardingLabel' | 'mobileMenu.mainMenu' | 'mobileMenu.previous' | 'mobileMenu.products' | 'mobileMenu.version' | 'navbar.products' | 'page.nextButton' | 'page.previousButton' | 'page.actions.copyButtonText' | 'page.actions.copyTitle' | 'page.actions.copyDescription' | 'page.actions.viewAsMdTitle' | 'page.actions.viewAsMdButtonText' | 'page.actions.viewAsMdDescription' | 'page.actions.chatGptTitle' | 'page.actions.chatGptButtonText' | 'page.actions.chatGptDescription' | 'page.actions.claudeTitle' | 'page.actions.claudeButtonText' | 'page.actions.claudeDescription' | 'page.actions.cursorMcpButtonText' | 'page.actions.cursorMcpTitle' | 'page.actions.cursorMcpDescription' | 'page.actions.connectMcp' | 'page.actions.connectMcp.cursor' | 'page.actions.connectMcp.cursorDescription' | 'page.actions.connectMcp.vscode' | 'page.actions.connectMcp.vscodeDescription' | 'page.actions.connectMcp.copyConfig' | 'page.actions.connectMcp.copyConfigDescription' | 'openapi.download.description.title' | 'openapi.info.title' | 'openapi.info.contact.url' | 'openapi.info.contact.name' | 'openapi.info.license' | 'openapi.info.termsOfService' | 'openapi.info.metadata.title' | 'openapi.key' | 'openapi.value' | 'openapi.enum' | 'openapi.items' | 'openapi.default' | 'openapi.variable' | 'openapi.variables' | 'openapi.actions.show' | 'openapi.actions.hide' | 'openapi.actions.more' | 'openapi.languages.title' | 'openapi.servers.title' | 'openapi.operations' | 'openapi.webhooks' | 'openapi.description' | 'openapi.badges.deprecated' | 'openapi.badges.required' | 'openapi.badges.webhook' | 'openapi.request' | 'openapi.path' | 'openapi.query' | 'openapi.cookie' | 'openapi.header' | 'openapi.body' | 'openapi.responses' | 'openapi.response' | 'openapi.callbacks' | 'openapi.callbackRequest' | 'openapi.callbackResponse' | 'openapi.payload' | 'openapi.discriminator' | 'openapi.contentType' | 'openapi.tryIt' | 'openapi.loading' | 'openapi.example' | 'openapi.examples' | 'openapi.additionalProperties' | 'openapi.patternProperties' | 'openapi.required' | 'openapi.recursive' | 'openapi.complex' | 'openapi.hideExample' | 'openapi.showExample' | 'openapi.expandAll' | 'openapi.collapseAll' | 'openapi.viewSecurityDetails' | 'openapi.noResponseExample' | 'openapi.discriminator.searchPlaceholder' | 'openapi.discriminator.searchNoResults' | 'openapi.discriminator.defaultMapping' | 'openapi.discriminator.defaultMappingTooltip' | 'openapi.noResponseContent' | 'openapi.noRequestPayload' | 'openapi.hidePattern' | 'openapi.showPattern' | 'openapi.authorizationUrl' | 'openapi.tokenUrl' | 'openapi.refreshUrl' | 'openapi.showOptionalScopes' | 'openapi.hideOptionalScopes' | 'openapi.security' | 'openapi.httpAuthorizationScheme' | 'openapi.bearerFormat' | 'openapi.parameterName' | 'openapi.flowType' | 'openapi.connectUrl' | 'openapi.requiredScopes' | 'openapi.unsupportedLanguage' | 'openapi.failedToGenerateCodeSample' | 'openapi.schemaCatalogLink.title' | 'openapi.schemaCatalogLink.copyButtonTooltip' | 'openapi.schemaCatalogLink.copiedTooltip' | 'openapi.mcp.title' | 'openapi.mcp.endpoint' | 'openapi.mcp.tools' | 'openapi.mcp.protocolVersion' | 'openapi.mcp.capabilities' | 'openapi.mcp.experimentalCapabilities' | 'openapi.mcp.inputSchema' | 'openapi.mcp.inputExample' | 'openapi.mcp.outputSchema' | 'openapi.mcp.outputExample' | 'asyncapi.download.description.title' | 'asyncapi.info.title' | 'graphql.download.description.title' | 'graphql.info.title' | 'graphql.info.contact.url' | 'graphql.info.contact.name' | 'graphql.info.license' | 'graphql.info.termsOfService' | 'graphql.overview' | 'graphql.metadata' | 'graphql.key' | 'graphql.value' | 'graphql.queries' | 'graphql.mutations' | 'graphql.subscriptions' | 'graphql.directives' | 'graphql.objects' | 'graphql.interfaces' | 'graphql.unions' | 'graphql.enums' | 'graphql.inputs' | 'graphql.scalars' | 'graphql.arguments.label' | 'graphql.arguments.show' | 'graphql.arguments.hide' | 'graphql.arguments.here' | 'graphql.returnTypes.label' | 'graphql.returnTypes.show' | 'graphql.returnTypes.hide' | 'graphql.possibleTypes' | 'graphql.defaultValue' | 'graphql.deprecationReason' | 'graphql.requiredScopes' | 'graphql.viewSecurityDetails' | 'graphql.objectScopes' | 'graphql.fieldScopes' | 'graphql.implementedInterfaces' | 'graphql.nonNull' | 'graphql.required' | 'graphql.deprecated' | 'graphql.variables' | 'graphql.querySample' | 'graphql.mutationSample' | 'graphql.subscriptionSample' | 'graphql.responseSample' | 'graphql.locations' | 'graphql.sample' | 'graphql.referenced' | 'graphql.content.fragment' | 'codeWalkthrough.download' | 'codeWalkthrough.preview' | 'time.justNow' | 'time.past.second' | 'time.past.seconds' | 'time.past.minute' | 'time.past.minutes' | 'time.past.hour' | 'time.past.hours' | 'time.past.day' | 'time.past.days' | 'time.past.week' | 'time.past.weeks' | 'time.past.month' | 'time.past.months' | 'time.past.year' | 'time.past.years' | 'page.internalServerError.title' | 'page.internalServerError.description' | 'page.skipToContent.label' | 'select.noResults' | 'loaders.loading' | 'filter.dateRange.from' | 'filter.dateRange.to';
+export type TranslationKey = 'dev.newApp' | 'dev.newApp.text' | 'dev.sidebar.header' | 'dev.sidebar.footer.text' | 'dev.create.app.dialog.appName.placeholder' | 'dev.create.app.dialog.appName.error' | 'dev.create.app.dialog.selectAPIs' | 'dev.create.app.dialog.description' | 'dev.create.app.dialog.description.placeholder' | 'dev.create.app.dialog.create' | 'dev.create.app.dialog.cancel' | 'dev.main.tab.appKeys' | 'dev.main.tab.logs' | 'dev.app.description.title' | 'dev.edit.description.dialog.title' | 'dev.edit.description.dialog.save' | 'dev.edit.description.dialog.cancel' | 'dev.edit.apis.dialog.selectedAPIs' | 'dev.app.key.create' | 'dev.create.key.dialog.title' | 'dev.create.key.dialog.create' | 'dev.create.key.dialog.cancel' | 'dev.app.edit' | 'dev.app.delete' | 'dev.edit.app.dialog.title' | 'dev.edit.app.dialog.save' | 'dev.edit.app.dialog.cancel' | 'dev.delete.app.dialog.title' | 'dev.delete.app.dialog.confirmation' | 'dev.delete.app.dialog.delete' | 'dev.delete.app.dialog.cancel' | 'dev.app.key.roll' | 'dev.roll.key.dialog.title' | 'dev.roll.key.dialog.apiKey' | 'dev.roll.key.dialog.expires' | 'dev.roll.key.dialog.confirmation' | 'dev.roll.key.dialog.cancel' | 'dev.roll.key.dialog.roll' | 'dev.update.key.dialog.title' | 'dev.update.key.dialog.update' | 'dev.update.key.dialog.cancel' | 'dev.app.key.api.name' | 'dev.app.key.api.status' | 'dev.app.key.api.edit' | 'dev.edit.apis.dialog.title' | 'dev.edit.apis.dialog.apiKey' | 'dev.edit.apis.dialog.save' | 'dev.edit.apis.dialog.cancel' | 'dev.select.placeholder' | 'dev.app.overview.status.pending' | 'dev.app.overview.status.approved' | 'dev.app.overview.status.revoked' | 'dev.app.overview.status' | 'dev.app.overview.non-production' | 'dev.app.overview.production' | 'dev.app.overview.clientId' | 'dev.app.overview.apiKey' | 'dev.app.key.revoke' | 'dev.revoke.key.dialog.title' | 'dev.revoke.key.dialog.apiKey' | 'dev.revoke.key.dialog.expires' | 'dev.revoke.key.dialog.confirmation' | 'dev.revoke.key.dialog.revoke' | 'dev.revoke.key.dialog.cancel' | 'dev.app.overview.expires' | 'dev.app.overview.created' | 'dev.app.overview.visibilityToggle.hide' | 'dev.app.overview.visibilityToggle.show' | 'search.loading' | 'search.noResults.title' | 'search.keys.navigate' | 'search.keys.select' | 'search.keys.exit' | 'search.label' | 'search.cancel' | 'search.recent' | 'search.navbar.label' | 'search.suggested' | 'search.showMore' | 'search.filter.title' | 'search.filter.reset' | 'search.filter.field.reset' | 'search.ai.welcomeText' | 'search.ai.newConversation' | 'search.ai.backToSearch' | 'search.ai.back' | 'search.ai.placeholder' | 'search.ai.generatingResponse' | 'search.ai.followUpQuestion' | 'search.ai.suggestionsTitle' | 'search.ai.thinkingText' | 'search.ai.resourcesFound' | 'search.ai.resourcesFound.basedOn' | 'search.ai.resourcesFound.resources' | 'search.ai.feedback.title' | 'search.ai.feedback.detailsPlaceholder' | 'search.ai.feedback.thanks' | 'search.ai.button' | 'search.ai.label' | 'search.ai.disclaimer' | 'search.ai.error.description' | 'search.ai.error.description.forbidden' | 'search.ai.error.description.unauthorized' | 'search.ai.error.header' | 'search.ai.error.header.forbidden' | 'search.ai.error.header.unauthorized' | 'search.ai.feedback.more' | 'search.searchItem.deprecated' | 'search.groups.all' | 'search.filter.field.footer' | 'aiAssistant.trigger' | 'toc.header' | 'footer.copyrightText' | 'page.homeButton' | 'page.forbidden.title' | 'page.notFound.title' | 'page.notFound.description' | 'page.lastUpdated.timeago' | 'page.lastUpdated.on' | 'catalog.filters.placeholder' | 'catalog.filters.title' | 'catalog.filters.add' | 'catalog.filters.clearAll' | 'catalog.filters.select.addFilter' | 'catalog.filters.select.all' | 'catalog.filters.done' | 'catalog.catalogs.all.title' | 'catalog.catalogs.all.description' | 'catalog.catalogs.all.switcherLabel' | 'catalog.catalogs.service.title' | 'catalog.catalogs.service.description' | 'catalog.catalogs.service.switcherLabel' | 'catalog.catalogs.user.title' | 'catalog.catalogs.user.description' | 'catalog.catalogs.user.switcherLabel' | 'catalog.catalogs.team.title' | 'catalog.catalogs.team.description' | 'catalog.catalogs.team.switcherLabel' | 'catalog.catalogs.domain.title' | 'catalog.catalogs.domain.description' | 'catalog.catalogs.domain.switcherLabel' | 'catalog.catalogs.apiDescription.title' | 'catalog.catalogs.apiDescription.description' | 'catalog.catalogs.apiDescription.switcherLabel' | 'catalog.catalogs.dataSchema.title' | 'catalog.catalogs.dataSchema.description' | 'catalog.catalogs.dataSchema.switcherLabel' | 'catalog.catalogs.apiOperation.title' | 'catalog.catalogs.apiOperation.description' | 'catalog.catalogs.apiOperation.switcherLabel' | 'catalog.entity.metadata.title' | 'catalog.entity.schema.title' | 'catalog.entity.properties.apiDescription.title' | 'catalog.backToAllLabel' | 'catalog.tags.more' | 'catalog.tags.label' | 'catalog.sort' | 'catalog.catalogs.label' | 'catalog.owners.label' | 'catalog.repositories.label' | 'catalog.email.label' | 'catalog.format.label' | 'catalog.entityType.label' | 'catalog.domains.label' | 'catalog.contact.label' | 'catalog.methodAndPath.label' | 'catalog.links.label' | 'catalog.metadata.domains' | 'catalog.metadata.owners' | 'catalog.history.button.label' | 'catalog.history.sidebar.title' | 'catalog.history.sidebar.close' | 'catalog.history.version.label' | 'catalog.history.version.notSpecified' | 'catalog.history.version.default' | 'catalog.history.revisions.limitMessage' | 'catalog.history.revision.current' | 'catalog.history.revisions.showLess' | 'catalog.history.revisions.showMore' | 'sidebar.menu.backLabel' | 'sidebar.menu.backToLabel' | 'sidebar.actions.show' | 'sidebar.actions.hide' | 'sidebar.actions.changeToSingleColumn' | 'sidebar.actions.changeToTwoColumns' | 'sidebar.actions.singleColumn' | 'sidebar.actions.twoColumns' | 'versionPicker.label' | 'versionPicker.unversioned' | 'codeSnippet.copy.buttonText' | 'codeSnippet.copy.tooltipText' | 'codeSnippet.copy.toasterText' | 'markdown.editPage.text' | 'feedback.settings.comment.submitText' | 'feedback.settings.comment.label' | 'feedback.settings.comment.send' | 'feedback.settings.comment.cancel' | 'feedback.settings.comment.satisfiedLabel' | 'feedback.settings.comment.neutralLabel' | 'feedback.settings.comment.dissatisfiedLabel' | 'feedback.settings.submitText' | 'feedback.settings.label' | 'feedback.settings.reasons.label' | 'feedback.submit' | 'feedback.cancel' | 'feedback.settings.comment.likeLabel' | 'feedback.settings.comment.dislikeLabel' | 'feedback.sentiment.thumbUp' | 'feedback.sentiment.thumbDown' | 'feedback.settings.leftScaleLabel' | 'feedback.settings.rightScaleLabel' | 'feedback.settings.optionalEmail.placeholder' | 'feedback.settings.optionalEmail.label' | 'codeSnippet.report.buttonText' | 'codeSnippet.report.tooltipText' | 'codeSnippet.report.label' | 'codeSnippet.expand.tooltipText' | 'codeSnippet.collapse.tooltipText' | 'userMenu.login' | 'userMenu.logout' | 'userMenu.devOnboardingLabel' | 'mobileMenu.mainMenu' | 'mobileMenu.previous' | 'mobileMenu.products' | 'mobileMenu.version' | 'navbar.products' | 'page.nextButton' | 'page.previousButton' | 'page.actions.copyButtonText' | 'page.actions.copyTitle' | 'page.actions.copyDescription' | 'page.actions.viewAsMdTitle' | 'page.actions.viewAsMdButtonText' | 'page.actions.viewAsMdDescription' | 'page.actions.chatGptTitle' | 'page.actions.chatGptButtonText' | 'page.actions.chatGptDescription' | 'page.actions.claudeTitle' | 'page.actions.claudeButtonText' | 'page.actions.claudeDescription' | 'page.actions.cursorMcpButtonText' | 'page.actions.cursorMcpTitle' | 'page.actions.cursorMcpDescription' | 'page.actions.connectMcp' | 'page.actions.connectMcp.cursor' | 'page.actions.connectMcp.cursorDescription' | 'page.actions.connectMcp.vscode' | 'page.actions.connectMcp.vscodeDescription' | 'page.actions.connectMcp.copyConfig' | 'page.actions.connectMcp.copyConfigDescription' | 'openapi.download.description.title' | 'openapi.info.title' | 'openapi.info.contact.url' | 'openapi.info.contact.name' | 'openapi.info.license' | 'openapi.info.termsOfService' | 'openapi.info.metadata.title' | 'openapi.key' | 'openapi.value' | 'openapi.enum' | 'openapi.items' | 'openapi.default' | 'openapi.variable' | 'openapi.variables' | 'openapi.actions.show' | 'openapi.actions.hide' | 'openapi.actions.more' | 'openapi.languages.title' | 'openapi.servers.title' | 'openapi.operations' | 'openapi.webhooks' | 'openapi.description' | 'openapi.badges.deprecated' | 'openapi.badges.required' | 'openapi.badges.webhook' | 'openapi.request' | 'openapi.path' | 'openapi.query' | 'openapi.cookie' | 'openapi.header' | 'openapi.body' | 'openapi.responses' | 'openapi.response' | 'openapi.callbacks' | 'openapi.callbackRequest' | 'openapi.callbackResponse' | 'openapi.payload' | 'openapi.discriminator' | 'openapi.contentType' | 'openapi.tryIt' | 'openapi.loading' | 'openapi.example' | 'openapi.examples' | 'openapi.additionalProperties' | 'openapi.patternProperties' | 'openapi.required' | 'openapi.recursive' | 'openapi.complex' | 'openapi.hideExample' | 'openapi.showExample' | 'openapi.expandAll' | 'openapi.collapseAll' | 'openapi.viewSecurityDetails' | 'openapi.noResponseExample' | 'openapi.discriminator.searchPlaceholder' | 'openapi.discriminator.searchNoResults' | 'openapi.discriminator.defaultMapping' | 'openapi.discriminator.defaultMappingTooltip' | 'openapi.noResponseContent' | 'openapi.noRequestPayload' | 'openapi.hidePattern' | 'openapi.showPattern' | 'openapi.authorizationUrl' | 'openapi.tokenUrl' | 'openapi.refreshUrl' | 'openapi.showOptionalScopes' | 'openapi.hideOptionalScopes' | 'openapi.security' | 'openapi.httpAuthorizationScheme' | 'openapi.bearerFormat' | 'openapi.parameterName' | 'openapi.flowType' | 'openapi.connectUrl' | 'openapi.requiredScopes' | 'openapi.unsupportedLanguage' | 'openapi.failedToGenerateCodeSample' | 'openapi.schemaCatalogLink.title' | 'openapi.schemaCatalogLink.copyButtonTooltip' | 'openapi.schemaCatalogLink.copiedTooltip' | 'openapi.mcp.title' | 'openapi.mcp.endpoint' | 'openapi.mcp.tools' | 'openapi.mcp.protocolVersion' | 'openapi.mcp.capabilities' | 'openapi.mcp.experimentalCapabilities' | 'openapi.mcp.inputSchema' | 'openapi.mcp.inputExample' | 'openapi.mcp.outputSchema' | 'openapi.mcp.outputExample' | 'asyncapi.download.description.title' | 'asyncapi.info.title' | 'graphql.download.description.title' | 'graphql.info.title' | 'graphql.info.contact.url' | 'graphql.info.contact.name' | 'graphql.info.license' | 'graphql.info.termsOfService' | 'graphql.overview' | 'graphql.metadata' | 'graphql.key' | 'graphql.value' | 'graphql.queries' | 'graphql.mutations' | 'graphql.subscriptions' | 'graphql.directives' | 'graphql.objects' | 'graphql.interfaces' | 'graphql.unions' | 'graphql.enums' | 'graphql.inputs' | 'graphql.scalars' | 'graphql.arguments.label' | 'graphql.arguments.show' | 'graphql.arguments.hide' | 'graphql.arguments.here' | 'graphql.returnTypes.label' | 'graphql.returnTypes.show' | 'graphql.returnTypes.hide' | 'graphql.possibleTypes' | 'graphql.defaultValue' | 'graphql.deprecationReason' | 'graphql.requiredScopes' | 'graphql.viewSecurityDetails' | 'graphql.objectScopes' | 'graphql.fieldScopes' | 'graphql.implementedInterfaces' | 'graphql.nonNull' | 'graphql.required' | 'graphql.deprecated' | 'graphql.variables' | 'graphql.querySample' | 'graphql.mutationSample' | 'graphql.subscriptionSample' | 'graphql.responseSample' | 'graphql.locations' | 'graphql.sample' | 'graphql.referenced' | 'graphql.content.fragment' | 'codeWalkthrough.download' | 'codeWalkthrough.preview' | 'time.justNow' | 'time.past.second' | 'time.past.seconds' | 'time.past.minute' | 'time.past.minutes' | 'time.past.hour' | 'time.past.hours' | 'time.past.day' | 'time.past.days' | 'time.past.week' | 'time.past.weeks' | 'time.past.month' | 'time.past.months' | 'time.past.year' | 'time.past.years' | 'page.internalServerError.title' | 'page.internalServerError.description' | 'page.skipToContent.label' | 'select.noResults' | 'loaders.loading' | 'filter.dateRange.from' | 'filter.dateRange.to';
 export type Locale = {
     code: string;
     name: string;

package/lib/core/utils/build-revision-url.d.ts

@@ -0,0 +1 @@
+export declare function buildRevisionUrl(basePath: string, revisionDate: string | null | undefined, version?: string | null): string | undefined;

package/lib/core/utils/build-revision-url.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildRevisionUrl = buildRevisionUrl;
+function buildRevisionUrl(basePath, revisionDate, version) {
+    if (!revisionDate) {
+        return undefined;
+    }
+    const params = new URLSearchParams();
+    params.set('revision', revisionDate);
+    if (version) {
+        params.set('version', version);
+    }
+    return `${basePath}?${params.toString()}`;
+}
+//# sourceMappingURL=build-revision-url.js.map

package/lib/core/utils/date.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Formats a date string to localized short date format (e.g., "Dec 12, 2025")
+ * @param dateString - ISO date string or null
+ * @param locale - Locale string (e.g., "en-US")
+ * @returns Formatted date string or empty string if dateString is null
+ */
+export declare function toLocalizedShortDate(dateString: string | null, locale: string): string;
+/**
+ * Formats a date string to localized short date-time format (e.g., "Dec 12, 3:45 PM")
+ * @param dateString - ISO date string or null
+ * @param locale - Locale string (e.g., "en-US")
+ * @returns Formatted date-time string or empty string if dateString is null
+ */
+export declare function toLocalizedShortDateTime(dateString: string | null, locale: string): string;

package/lib/core/utils/date.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toLocalizedShortDate = toLocalizedShortDate;
+exports.toLocalizedShortDateTime = toLocalizedShortDateTime;
+/**
+ * Formats a date string to localized short date format (e.g., "Dec 12, 2025")
+ * @param dateString - ISO date string or null
+ * @param locale - Locale string (e.g., "en-US")
+ * @returns Formatted date string or empty string if dateString is null
+ */
+function toLocalizedShortDate(dateString, locale) {
+    if (!dateString)
+        return '';
+    const date = new Date(dateString);
+    return date.toLocaleDateString(locale, {
+        month: 'short',
+        day: 'numeric',
+        year: 'numeric',
+    });
+}
+/**
+ * Formats a date string to localized short date-time format (e.g., "Dec 12, 3:45 PM")
+ * @param dateString - ISO date string or null
+ * @param locale - Locale string (e.g., "en-US")
+ * @returns Formatted date-time string or empty string if dateString is null
+ */
+function toLocalizedShortDateTime(dateString, locale) {
+    if (!dateString)
+        return '';
+    const date = new Date(dateString);
+    return date.toLocaleString(locale, {
+        month: 'short',
+        day: 'numeric',
+        hour: 'numeric',
+        minute: '2-digit',
+        hour12: true,
+    });
+}
+//# sourceMappingURL=date.js.map

package/lib/core/utils/index.d.ts

@@ -41,3 +41,5 @@ export * from './Dynamic';
 export * from './tabs';
 export * from './get-operation-color';
 export * from './frontmatter-translate';
+export * from './transform-revisions-to-version-history';
+export * from './build-revision-url';

package/lib/core/utils/index.js

@@ -57,4 +57,6 @@ __exportStar(require("./Dynamic"), exports);
 __exportStar(require("./tabs"), exports);
 __exportStar(require("./get-operation-color"), exports);
 __exportStar(require("./frontmatter-translate"), exports);
+__exportStar(require("./transform-revisions-to-version-history"), exports);
+__exportStar(require("./build-revision-url"), exports);
 //# sourceMappingURL=index.js.map

package/lib/core/utils/load-and-navigate.js

@@ -10,12 +10,13 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.loadAndNavigate = loadAndNavigate;
+const get_navbar_element_1 = require("./get-navbar-element");
 const with_load_progress_1 = require("./with-load-progress");
 let lastNavigatedPath;
 // this is copy from portal/src/client/app/utils/loadAndNavigate.ts, for case when we need to run Redoc without Realm
 function loadAndNavigate(_a) {
     return __awaiter(this, arguments, void 0, function* ({ navigate, to, origin = 'browser', options, }) {
-        var _b;
+        var _b, _c;
         lastNavigatedPath = to;
         const { pathname, hash, search } = new URL(to, window.location.origin + window.location.pathname);
         // use window-shared loader instead of importing to prevent circular import issue
@@ -38,7 +39,11 @@ function loadAndNavigate(_a) {
             if (hash) {
                 const el = document.getElementById(hash.slice(1));
                 if (el) {
-                    el.scrollIntoView();
+                    const navbar = (0, get_navbar_element_1.getNavbarElement)();
+                    const navbarHeight = (_c = navbar === null || navbar === void 0 ? void 0 : navbar.offsetHeight) !== null && _c !== void 0 ? _c : 0;
+                    const elementTop = el.getBoundingClientRect().top + window.scrollY;
+                    const scrollPosition = elementTop - navbarHeight;
+                    window.scrollTo({ top: scrollPosition, behavior: 'smooth' });
                 }
             }
             else {

package/lib/core/utils/transform-revisions-to-version-history.d.ts

@@ -0,0 +1,8 @@
+import type { BffCatalogEntityRevision, CatalogEntityVersionHistoryGroup } from '../../core/types';
+export type TransformRevisionsToVersionHistoryParams = {
+    revisions: BffCatalogEntityRevision[];
+    currentRevisionDate?: string;
+    currentVersion?: string | null;
+    locale?: string;
+};
+export declare function transformRevisionsToVersionHistory({ revisions, currentRevisionDate, currentVersion, locale, }: TransformRevisionsToVersionHistoryParams): CatalogEntityVersionHistoryGroup[];