@redocly/theme 0.67.0-next.4 → 0.67.0-next.6

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

@@ -24,13 +24,7 @@ const clipboard_service_1 = require("../utils/clipboard-service");
 const dom_1 = require("../utils/dom");
 const mcp_1 = require("../utils/mcp");
 const urls_1 = require("../utils/urls");
-function createPageActionResource(pageSlug, pageUrl) {
-    return {
-        id: pageSlug,
-        object: 'page',
-        uri: pageUrl,
-    };
-}
+const get_base_data_attributes_1 = require("../utils/telemetry/get-base-data-attributes");
 const DEFAULT_ENABLED_ACTIONS = [
     'copy',
     'view',
@@ -55,19 +49,17 @@ function usePageActions(pageSlug, mcpUrl, actions) {
             ? { serverName: mcpConfig.serverName, url: mcpUrl || '' }
             : { serverName: mcpConfig.serverName, url: mcpConfig.serverUrl || '' };
         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}` }),
+                ? () => telemetry.sendPageActionsClickedMessage([
+                    Object.assign(Object.assign({}, (0, get_base_data_attributes_1.getBaseDataAttributes)('pageActions', 'button')), { actionType: `docs-mcp-${clientType}` }),
                 ])
                 : undefined,
         });
-    }, [mcpUrl, mcpConfig, translate, telemetry, pageSlug]);
+    }, [mcpUrl, mcpConfig, translate, telemetry]);
     const result = (0, react_1.useMemo)(() => {
         var _a, _b;
         var _c;
@@ -83,7 +75,6 @@ function usePageActions(pageSlug, mcpUrl, actions) {
             ? window.location.origin
             : ((_c = globalThis['SSR_HOSTNAME']) !== null && _c !== void 0 ? _c : '');
         const pathname = (0, urls_1.addTrailingSlash)(pageSlug);
-        const pageUrl = (0, urls_1.combineUrls)(origin, pathname);
         const isRoot = (0, urls_1.withoutPathPrefix)(pathname) === '/';
         const mdPageUrl = isRoot
             ? (0, urls_1.combineUrls)(origin, pathname, 'index.html.md')
@@ -106,8 +97,8 @@ 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' }),
+                        telemetry.sendPageActionsClickedMessage([
+                            Object.assign(Object.assign({}, (0, get_base_data_attributes_1.getBaseDataAttributes)('pageActions', 'button')), { actionType: 'copy' }),
                         ]);
                     }
                     catch (error) {
@@ -122,8 +113,8 @@ function usePageActions(pageSlug, mcpUrl, actions) {
                 iconComponent: MarkdownFullIcon_1.MarkdownFullIcon,
                 link: mdPageUrl,
                 onClick: () => {
-                    telemetry.sendPageActionsButtonClickedMessage([
-                        Object.assign(Object.assign({}, createPageActionResource(pageSlug, pageUrl)), { action_type: 'view' }),
+                    telemetry.sendPageActionsClickedMessage([
+                        Object.assign(Object.assign({}, (0, get_base_data_attributes_1.getBaseDataAttributes)('pageActions', 'button')), { actionType: 'view' }),
                     ]);
                 },
             }),
@@ -136,8 +127,8 @@ function usePageActions(pageSlug, mcpUrl, actions) {
                     iconComponent: ChatGptIcon_1.ChatGptIcon,
                     link,
                     onClick: () => {
-                        telemetry.sendPageActionsButtonClickedMessage([
-                            Object.assign(Object.assign({}, createPageActionResource(pageSlug, pageUrl)), { action_type: 'chatgpt' }),
+                        telemetry.sendPageActionsClickedMessage([
+                            Object.assign(Object.assign({}, (0, get_base_data_attributes_1.getBaseDataAttributes)('pageActions', 'button')), { actionType: 'chatgpt' }),
                         ]);
                         window.location.href = link;
                     },
@@ -152,8 +143,8 @@ function usePageActions(pageSlug, mcpUrl, actions) {
                     iconComponent: ClaudeIcon_1.ClaudeIcon,
                     link,
                     onClick: () => {
-                        telemetry.sendPageActionsButtonClickedMessage([
-                            Object.assign(Object.assign({}, createPageActionResource(pageSlug, pageUrl)), { action_type: 'claude' }),
+                        telemetry.sendPageActionsClickedMessage([
+                            Object.assign(Object.assign({}, (0, get_base_data_attributes_1.getBaseDataAttributes)('pageActions', 'button')), { actionType: 'claude' }),
                         ]);
                         window.location.href = link;
                     },
@@ -199,24 +190,26 @@ function createMCPAction({ clientType, mcpConfig, translate, onClickCallback, })
 }
 function shouldHideAction(action, { pageProps, themeConfig, openapiExcludeFromSearch, isPublic, mcpUrl, isMcpDisabled, }) {
     var _a, _b, _c, _d, _e, _f, _g, _h;
-    // Can't use any actions if search is globally disabled (markdown files are not generated)
-    if ((_a = themeConfig.search) === null || _a === void 0 ? void 0 : _a.hide) {
-        return true;
-    }
-    // Can't use any actions if no markdown files are generated for LLMs
-    if ((_c = (_b = pageProps === null || pageProps === void 0 ? void 0 : pageProps.seo) === null || _b === void 0 ? void 0 : _b.llmstxt) === null || _c === void 0 ? void 0 : _c.hide) {
-        return true;
-    }
     // Page actions are explicitly disabled in config
-    if ((_e = (_d = themeConfig.navigation) === null || _d === void 0 ? void 0 : _d.actions) === null || _e === void 0 ? void 0 : _e.hide) {
+    if ((_b = (_a = themeConfig.navigation) === null || _a === void 0 ? void 0 : _a.actions) === null || _b === void 0 ? void 0 : _b.hide) {
         return true;
     }
-    const isOpenApiPage = ((_f = pageProps === null || pageProps === void 0 ? void 0 : pageProps.metadata) === null || _f === void 0 ? void 0 : _f.type) === 'openapi' || ((_g = pageProps === null || pageProps === void 0 ? void 0 : pageProps.metadata) === null || _g === void 0 ? void 0 : _g.subType) === 'openapi-operation';
-    const isPageExcludedFromSearch = ((_h = pageProps === null || pageProps === void 0 ? void 0 : pageProps.frontmatter) === null || _h === void 0 ? void 0 : _h.excludeFromSearch) || (isOpenApiPage && openapiExcludeFromSearch);
-    // Page excluded from search: only explicit MCP connect actions remain visible,
-    // since they don't depend on the page's markdown.
-    if (isPageExcludedFromSearch && action !== 'mcp-cursor' && action !== 'mcp-vscode') {
-        return true;
+    const actionDependsOnLlmsTxt = ['view', 'copy', 'chatgpt', 'claude'].includes(action);
+    if (actionDependsOnLlmsTxt) {
+        // Can't use any actions if search is globally disabled (markdown files are not generated)
+        if ((_c = themeConfig.search) === null || _c === void 0 ? void 0 : _c.hide) {
+            return true;
+        }
+        // Can't use any actions if no markdown files are generated for LLMs
+        if ((_e = (_d = pageProps === null || pageProps === void 0 ? void 0 : pageProps.seo) === null || _d === void 0 ? void 0 : _d.llmstxt) === null || _e === void 0 ? void 0 : _e.hide) {
+            return true;
+        }
+        const isOpenApiPage = ((_f = pageProps === null || pageProps === void 0 ? void 0 : pageProps.metadata) === null || _f === void 0 ? void 0 : _f.type) === 'openapi' ||
+            ((_g = pageProps === null || pageProps === void 0 ? void 0 : pageProps.metadata) === null || _g === void 0 ? void 0 : _g.subType) === 'openapi-operation';
+        const isPageExcludedFromSearch = ((_h = pageProps === null || pageProps === void 0 ? void 0 : pageProps.frontmatter) === null || _h === void 0 ? void 0 : _h.excludeFromSearch) || (isOpenApiPage && openapiExcludeFromSearch);
+        if (isPageExcludedFromSearch) {
+            return true;
+        }
     }
     return shouldHideActionByType(action, { isPublic, mcpUrl, isMcpDisabled });
 }

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useProductPicker = useProductPicker;
+const react_1 = require("react");
 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");
@@ -12,20 +13,29 @@ function useProductPicker() {
     const telemetry = useTelemetry();
     const navigate = (0, react_router_dom_1.useNavigate)();
     const loadAndNavigate = useLoadAndNavigate();
+    // An open dropdown can fire a menu item's onAction from an earlier render, so `product.link`
+    // may be stale (e.g. after a locale switch); resolve the live product via a ref.
+    const productsRef = (0, react_1.useRef)(products);
+    productsRef.current = products;
     function setProduct(product) {
+        var _a;
         if (!product)
             return;
-        telemetry.sendProductPickedMessage([{ object: 'product', product: product.slug }]);
+        // match on `name` (locale-stable; link/slug are re-localized)
+        const freshProduct = (_a = productsRef.current.find((p) => p.name === product.name)) !== null && _a !== void 0 ? _a : product;
+        telemetry.sendProductPickerChangedMessage([
+            ...(0, utils_2.generateBeforeAfterContext)('productPicker', 'dropdown', { product: (currentProduct === null || currentProduct === void 0 ? void 0 : currentProduct.slug) || '' }, { product: freshProduct.slug }),
+        ]);
         if (typeof document === 'undefined')
             return;
-        if (product.name) {
+        if (freshProduct.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));
+            root.classList.add((0, utils_1.getProductClassName)(freshProduct.name));
         }
-        loadAndNavigate({ navigate, to: (0, utils_2.withPathPrefix)(product.link) });
+        loadAndNavigate({ navigate, to: (0, utils_2.withPathPrefix)(freshProduct.link) });
     }
     return {
         currentProduct,

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

@@ -1,48 +1,59 @@
 export declare const useTelemetryFallback: () => {
     send: () => void;
-    sendPageViewedMessage: () => void;
-    sendPageActionsButtonClickedMessage: () => void;
     sendErrorMessage: () => void;
     sendClientErrorMessage: () => void;
+    sendCatalogEntitiesFilterCheckboxToggledMessage: () => void;
+    sendCatalogEntitiesCopyDataSchemaClickedMessage: () => void;
+    sendCatalogEntitiesViewModeChangedMessage: () => void;
+    sendCatalogEntitiesRelatedEntitiesListSearchQueryMessage: () => void;
+    sendCatalogEntitiesRelatedEntitiesListSearchResultClickMessage: () => void;
+    sendCatalogEntitiesListSearchQueryMessage: () => void;
+    sendCatalogEntitiesListSearchResultClickedMessage: () => void;
+    sendRedirectMessage: () => void;
+    sendCustomMessage: () => void;
+    sendSearchAIQueryMessage: () => void;
+    sendSearchAiOpenedMessage: () => void;
+    sendSearchAIFeedbackMessage: () => void;
+    sendLoginClickedMessage: () => void;
+    sendLoginProviderClickedMessage: () => void;
+    sendLogoutClickedMessage: () => void;
+    sendBannerViewedMessage: () => void;
+    sendBannerLinkClickedMessage: () => void;
+    sendBannerDismissedMessage: () => void;
     sendBreadcrumbClickedMessage: () => void;
-    sendColorModeSwitchedMessage: () => void;
-    sendSidebarItemClickedMessage: () => void;
-    sendSidebarItemExpandedMessage: () => void;
-    sendSidebarItemCollapsedMessage: () => void;
-    sendChangeLayoutButtonClickedMessage: () => void;
-    sendEditPageLinkClickedMessage: () => void;
-    sendCodeSnippetReportedMessage: () => void;
-    sendNavbarMenuItemClickedMessage: () => void;
-    sendLoginButtonClickedMessage: () => void;
-    sendLoginProviderButtonClickedMessage: () => void;
-    sendLogoutMenuItemClickedMessage: () => void;
-    sendLogoClickedMessage: () => void;
-    sendTocItemClickedMessage: () => void;
+    sendCatalogActionsClickedMessage: () => void;
     sendCatalogFilterChangedMessage: () => void;
     sendCatalogItemClickedMessage: () => void;
     sendScorecardLinkClickedMessage: () => void;
-    sendBackToCatalogButtonClickedMessage: () => void;
-    sendSidebarDrilldownBackButtonClickedMessage: () => void;
+    sendFilterCheckboxToggledMessage: () => void;
+    sendFeedbackMessage: () => void;
     sendFooterItemClickedMessage: () => void;
-    sendCatalogActionsButtonClickedMessage: () => void;
-    sendMobileMenuButtonCloseClickedMessage: () => void;
-    sendMobileMenuButtonOpenClickedMessage: () => void;
-    sendSearchInputResetButtonClickedMessage: () => void;
-    sendSearchRecentRemoveButtonClickedMessage: () => void;
+    sendNavbarMenuItemClickedMessage: () => void;
+    sendColorModeSwitchedMessage: () => void;
+    sendLanguagePickerChangedMessage: () => void;
+    sendProductPickerChangedMessage: () => void;
+    sendLogoClickedMessage: () => void;
+    sendCodeSnippetReportedMessage: () => void;
+    sendMobileMenuClosedMessage: () => void;
+    sendMobileMenuOpenedMessage: () => void;
+    sendPageViewedMessage: () => void;
+    sendPageTimeMessage: () => void;
+    sendPageActionsClickedMessage: () => void;
+    sendPageEditClickedMessage: () => void;
+    sendSidebarDrilldownBackClickedMessage: () => void;
+    sendSidebarItemClickedMessage: () => void;
+    sendSidebarExpandedMessage: () => void;
+    sendSidebarCollapsedMessage: () => void;
+    sendChangeLayoutClickedMessage: () => void;
+    sendRequestApiAccessClickedMessage: () => void;
+    sendVersionPickerChangedMessage: () => void;
+    sendSearchInputResetClickedMessage: () => void;
+    sendSearchResultClickedMessage: () => void;
+    sendSearchRecentRemoveClickedMessage: () => void;
     sendSearchRecentClickedMessage: () => void;
-    sendRequestApiAccessButtonClickedMessage: () => void;
-    sendVersionPickerSelectionChangeMessage: () => void;
-    sendProductPickedMessage: () => void;
-    sendFilterCheckboxToggledMessage: () => void;
-    sendLanguagePickerLocaleChangedMessage: () => void;
     sendSearchOpenedMessage: () => void;
     sendSearchQueryMessage: () => void;
-    sendSearchAiOpenedMessage: () => void;
-    sendSearchAIQueryMessage: () => void;
-    sendSearchAIFeedbackMessage: () => void;
-    sendFeedbackMessage: () => void;
-    sendSearchResultClickedMessage: () => void;
-    sendRedirectMessage: () => void;
+    sendTocItemClickedMessage: () => void;
     sendOpenapiDocsMessage: () => void;
     sendCopyCodeSnippetClickedMessage: () => void;
     sendViewedMessage: () => void;
@@ -65,10 +76,7 @@ export declare const useTelemetryFallback: () => {
     sendAsyncapiDocsReferencedInClickedMessage: () => void;
     sendGraphqlDocsViewedMessage: () => void;
     sendGraphqlDocsPerformanceMetricsMessage: () => void;
+    sendGraphqlDocsDownloadDefinitionClickedMessage: () => void;
     sendGraphqlDocsReferencedInLinkClickedMessage: () => void;
     sendGraphqlDocsRequiredScopesModalOpenedMessage: () => void;
-    sendGraphqlDocsDownloadDefinitionClickedMessage: () => void;
-    sendBannerViewedMessage: () => void;
-    sendBannerLinkClickedMessage: () => void;
-    sendBannerDismissedMessage: () => void;
 };

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

@@ -1,53 +1,64 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useTelemetryFallback = void 0;
-// eslint-disable-next-line no-warning-comments
-// TODO we need to create some common way to do this.
+// Fallback no-op telemetry used by `useThemeHooks` when no ThemeDataContext
+// provider supplies real hooks.
 const useTelemetryFallback = () => ({
     send: () => { },
-    sendPageViewedMessage: () => { },
-    sendPageActionsButtonClickedMessage: () => { },
     sendErrorMessage: () => { },
     sendClientErrorMessage: () => { },
+    sendCatalogEntitiesFilterCheckboxToggledMessage: () => { },
+    sendCatalogEntitiesCopyDataSchemaClickedMessage: () => { },
+    sendCatalogEntitiesViewModeChangedMessage: () => { },
+    sendCatalogEntitiesRelatedEntitiesListSearchQueryMessage: () => { },
+    sendCatalogEntitiesRelatedEntitiesListSearchResultClickMessage: () => { },
+    sendCatalogEntitiesListSearchQueryMessage: () => { },
+    sendCatalogEntitiesListSearchResultClickedMessage: () => { },
+    sendRedirectMessage: () => { },
+    sendCustomMessage: () => { },
+    sendSearchAIQueryMessage: () => { },
+    sendSearchAiOpenedMessage: () => { },
+    sendSearchAIFeedbackMessage: () => { },
+    sendLoginClickedMessage: () => { },
+    sendLoginProviderClickedMessage: () => { },
+    sendLogoutClickedMessage: () => { },
+    sendBannerViewedMessage: () => { },
+    sendBannerLinkClickedMessage: () => { },
+    sendBannerDismissedMessage: () => { },
     sendBreadcrumbClickedMessage: () => { },
-    sendColorModeSwitchedMessage: () => { },
-    sendSidebarItemClickedMessage: () => { },
-    sendSidebarItemExpandedMessage: () => { },
-    sendSidebarItemCollapsedMessage: () => { },
-    sendChangeLayoutButtonClickedMessage: () => { },
-    sendEditPageLinkClickedMessage: () => { },
-    sendCodeSnippetReportedMessage: () => { },
-    sendNavbarMenuItemClickedMessage: () => { },
-    sendLoginButtonClickedMessage: () => { },
-    sendLoginProviderButtonClickedMessage: () => { },
-    sendLogoutMenuItemClickedMessage: () => { },
-    sendLogoClickedMessage: () => { },
-    sendTocItemClickedMessage: () => { },
+    sendCatalogActionsClickedMessage: () => { },
     sendCatalogFilterChangedMessage: () => { },
     sendCatalogItemClickedMessage: () => { },
     sendScorecardLinkClickedMessage: () => { },
-    sendBackToCatalogButtonClickedMessage: () => { },
-    sendSidebarDrilldownBackButtonClickedMessage: () => { },
+    sendFilterCheckboxToggledMessage: () => { },
+    sendFeedbackMessage: () => { },
     sendFooterItemClickedMessage: () => { },
-    sendCatalogActionsButtonClickedMessage: () => { },
-    sendMobileMenuButtonCloseClickedMessage: () => { },
-    sendMobileMenuButtonOpenClickedMessage: () => { },
-    sendSearchInputResetButtonClickedMessage: () => { },
-    sendSearchRecentRemoveButtonClickedMessage: () => { },
+    sendNavbarMenuItemClickedMessage: () => { },
+    sendColorModeSwitchedMessage: () => { },
+    sendLanguagePickerChangedMessage: () => { },
+    sendProductPickerChangedMessage: () => { },
+    sendLogoClickedMessage: () => { },
+    sendCodeSnippetReportedMessage: () => { },
+    sendMobileMenuClosedMessage: () => { },
+    sendMobileMenuOpenedMessage: () => { },
+    sendPageViewedMessage: () => { },
+    sendPageTimeMessage: () => { },
+    sendPageActionsClickedMessage: () => { },
+    sendPageEditClickedMessage: () => { },
+    sendSidebarDrilldownBackClickedMessage: () => { },
+    sendSidebarItemClickedMessage: () => { },
+    sendSidebarExpandedMessage: () => { },
+    sendSidebarCollapsedMessage: () => { },
+    sendChangeLayoutClickedMessage: () => { },
+    sendRequestApiAccessClickedMessage: () => { },
+    sendVersionPickerChangedMessage: () => { },
+    sendSearchInputResetClickedMessage: () => { },
+    sendSearchResultClickedMessage: () => { },
+    sendSearchRecentRemoveClickedMessage: () => { },
     sendSearchRecentClickedMessage: () => { },
-    sendRequestApiAccessButtonClickedMessage: () => { },
-    sendVersionPickerSelectionChangeMessage: () => { },
-    sendProductPickedMessage: () => { },
-    sendFilterCheckboxToggledMessage: () => { },
-    sendLanguagePickerLocaleChangedMessage: () => { },
     sendSearchOpenedMessage: () => { },
     sendSearchQueryMessage: () => { },
-    sendSearchAiOpenedMessage: () => { },
-    sendSearchAIQueryMessage: () => { },
-    sendSearchAIFeedbackMessage: () => { },
-    sendFeedbackMessage: () => { },
-    sendSearchResultClickedMessage: () => { },
-    sendRedirectMessage: () => { },
+    sendTocItemClickedMessage: () => { },
     sendOpenapiDocsMessage: () => { },
     sendCopyCodeSnippetClickedMessage: () => { },
     sendViewedMessage: () => { },
@@ -70,12 +81,9 @@ const useTelemetryFallback = () => ({
     sendAsyncapiDocsReferencedInClickedMessage: () => { },
     sendGraphqlDocsViewedMessage: () => { },
     sendGraphqlDocsPerformanceMetricsMessage: () => { },
+    sendGraphqlDocsDownloadDefinitionClickedMessage: () => { },
     sendGraphqlDocsReferencedInLinkClickedMessage: () => { },
     sendGraphqlDocsRequiredScopesModalOpenedMessage: () => { },
-    sendGraphqlDocsDownloadDefinitionClickedMessage: () => { },
-    sendBannerViewedMessage: () => { },
-    sendBannerLinkClickedMessage: () => { },
-    sendBannerDismissedMessage: () => { },
 });
 exports.useTelemetryFallback = useTelemetryFallback;
 //# sourceMappingURL=use-telemetry-fallback.js.map

package/lib/core/styles/global.js

@@ -1013,6 +1013,39 @@ const pages = (0, styled_components_1.css) `
 
   // @tokens End
 
+  /**
+    * @tokens 405 MCP Page
+    * @presenter Color
+    */
+  --page-mcp-405-font-family: var(--font-family-base); // @presenter FontFamily
+  --page-mcp-405-margin-vertical: var(--spacing-xl);
+  --page-mcp-405-margin-horizontal: calc(var(--spacing-xxl) * 2);
+  --page-mcp-405-gap: var(--spacing-lg);
+  --page-mcp-405-max-width: 680px;
+  --page-mcp-405-margin-vertical-mobile: var(--spacing-xxl);
+  --page-mcp-405-margin-horizontal-mobile: 1rem;
+
+  --page-mcp-405-status-text-color: var(--text-color-helper);
+  --page-mcp-405-status-font-size: var(--font-size-lg); // @presenter FontSize
+  --page-mcp-405-status-line-height: var(--line-height-lg); // @presenter LineHeight
+  --page-mcp-405-status-font-weight: var(--font-weight-semibold); // @presenter FontWeight
+
+  --page-mcp-405-title-text-color: var(--text-color-primary);
+  --page-mcp-405-title-font-size: 42px; // @presenter FontSize
+  --page-mcp-405-title-font-weight: var(--font-weight-bold); // @presenter FontWeight
+  --page-mcp-405-title-line-height: 50px; // @presenter LineHeight
+  --page-mcp-405-title-font-size-mobile: var(--h3-font-size);
+  --page-mcp-405-title-line-height-mobile: var(--h3-line-height);
+
+  --page-mcp-405-description-text-color: var(--text-color-secondary);
+  --page-mcp-405-description-font-size: var(--font-size-xl); // @presenter FontSize
+  --page-mcp-405-description-font-weight: var(--font-weight-regular); // @presenter FontWeight
+  --page-mcp-405-description-line-height: var(--line-height-xl);
+  --page-mcp-405-description-font-size-mobile: var(--font-size-lg);
+  --page-mcp-405-description-line-height-mobile: var(--line-height-lg);
+
+   // @tokens End
+
   /**
     * @tokens 500 Page
     * @presenter Color

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.create.app.dialog.callbackUrls' | 'dev.create.app.dialog.callbackUrls.placeholder' | 'dev.create.app.dialog.callbackUrls.hint' | 'dev.app.callbackUrls.title' | 'dev.edit.callbackUrls.dialog.title' | 'dev.edit.callbackUrls.dialog.placeholder' | 'dev.edit.callbackUrls.dialog.hint' | 'dev.edit.callbackUrls.dialog.save' | 'dev.edit.callbackUrls.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.error.title' | 'search.error.button' | 'search.filter.title' | 'search.filter.reset' | 'search.filter.field.reset' | 'search.ai.welcomeText' | 'search.ai.newConversation' | 'search.ai.backToSearch' | 'search.ai.back' | 'search.ai.assistant' | '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.toolCall.executed' | 'search.ai.toolCall.executing' | 'search.ai.toolCall.withArgs' | '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.forbidden.description' | '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.notConnected' | '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.filters.close' | '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.maxLength' | '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.languages.moreButton.tooltipText' | '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.implementedBy' | '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' | 'button.copy.tooltipText' | 'button.download.tooltipText' | 'button.externalLink.tooltipText' | 'button.email.tooltipText' | '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' | 'diagram.openFullscreen' | 'diagram.zoomIn' | 'diagram.zoomOut' | 'diagram.reset' | 'diagram.close' | 'diagram.viewer';
+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.create.app.dialog.callbackUrls' | 'dev.create.app.dialog.callbackUrls.placeholder' | 'dev.create.app.dialog.callbackUrls.hint' | 'dev.app.callbackUrls.title' | 'dev.edit.callbackUrls.dialog.title' | 'dev.edit.callbackUrls.dialog.placeholder' | 'dev.edit.callbackUrls.dialog.hint' | 'dev.edit.callbackUrls.dialog.save' | 'dev.edit.callbackUrls.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.error.title' | 'search.error.button' | 'search.filter.title' | 'search.filter.reset' | 'search.filter.field.reset' | 'search.ai.welcomeText' | 'search.ai.newConversation' | 'search.ai.backToSearch' | 'search.ai.back' | 'search.ai.assistant' | '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.toolCall.executed' | 'search.ai.toolCall.executing' | 'search.ai.toolCall.withArgs' | '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.forbidden.description' | 'page.notFound.title' | 'page.notFound.description' | 'page.mcpNotAllowed.title' | 'page.mcpNotAllowed.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.notConnected' | '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.filters.close' | '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.maxLength' | '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.languages.moreButton.tooltipText' | '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.implementedBy' | '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' | 'button.copy.tooltipText' | 'button.download.tooltipText' | 'button.externalLink.tooltipText' | 'button.email.tooltipText' | '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' | 'diagram.openFullscreen' | 'diagram.zoomIn' | 'diagram.zoomOut' | 'diagram.reset' | 'diagram.close' | 'diagram.viewer';
 export type Locale = {
     code: string;
     name: string;

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

@@ -125,5 +125,6 @@ export declare enum ToolCallName {
     GetEndpointInfo = "get-endpoint-info",
     GetSecuritySchemes = "get-security-schemes",
     GetFullApiDescription = "get-full-api-description",
-    Execute = "execute"
+    Execute = "execute",
+    DescribeTools = "describe-tools"
 }

package/lib/core/types/search.js

@@ -15,5 +15,6 @@ var ToolCallName;
     ToolCallName["GetSecuritySchemes"] = "get-security-schemes";
     ToolCallName["GetFullApiDescription"] = "get-full-api-description";
     ToolCallName["Execute"] = "execute";
+    ToolCallName["DescribeTools"] = "describe-tools";
 })(ToolCallName || (exports.ToolCallName = ToolCallName = {}));
 //# sourceMappingURL=search.js.map

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

@@ -46,3 +46,5 @@ export * from './content-segments';
 export * from './custom-catalog-options-casing';
 export * from './get-auto-dismiss-duration';
 export * from './tooltip-placement';
+export * from './telemetry/get-base-data-attributes';
+export * from './telemetry/generate-before-after-context';

package/lib/core/utils/index.js

@@ -62,4 +62,6 @@ __exportStar(require("./content-segments"), exports);
 __exportStar(require("./custom-catalog-options-casing"), exports);
 __exportStar(require("./get-auto-dismiss-duration"), exports);
 __exportStar(require("./tooltip-placement"), exports);
+__exportStar(require("./telemetry/get-base-data-attributes"), exports);
+__exportStar(require("./telemetry/generate-before-after-context"), exports);
 //# sourceMappingURL=index.js.map

package/lib/core/utils/telemetry/generate-before-after-context.d.ts

@@ -0,0 +1,37 @@
+import type { AsyncApiRealmUI } from '@redocly/realm-asyncapi-sdk';
+type UITelemetryClient = AsyncApiRealmUI.Telemetry;
+type UITelemetryClientMethods = {
+    [K in keyof UITelemetryClient]: UITelemetryClient[K] extends (...args: any) => any ? UITelemetryClient[K] : never;
+};
+type UITelemetryClientMethodKeys = {
+    [K in keyof UITelemetryClientMethods]: Parameters<UITelemetryClientMethods[K]>[0] extends readonly [any, any, ...any[]] ? K : never;
+}[keyof UITelemetryClientMethods];
+type EventSchemaProps<T extends UITelemetryClientMethodKeys> = Parameters<UITelemetryClientMethods[T]>[0];
+type EventAfterContext<T extends UITelemetryClientMethodKeys> = EventSchemaProps<T>[0];
+type EventBeforeContext<T extends UITelemetryClientMethodKeys> = EventSchemaProps<T>[1];
+/**
+ * Builds a typed `[after, before]` tuple for Realm UI telemetry events whose AsyncAPI
+ * contract lists the updated state first, then the prior state (per CloudEvents styleguide).
+ *
+ * Each slice merges {@link getBaseDataAttributes} (`id`, `object`, `uri`) with the
+ * corresponding partial payload and sets `context` to `'after'` or `'before'`.
+ *
+ * @template T - Telemetry client method key whose `data` tuple is
+ *   `[after, before, ...]` (for example `'sendLanguagePickerChangedMessage'`).
+ * @param id - Stable resource identifier passed to {@link getBaseDataAttributes}
+ *   and included on both payloads.
+ * @param object - Resource kind passed to {@link getBaseDataAttributes}
+ *   and included on both payloads (for example `'dropdown'` or `'button'`).
+ * @param before - Event-specific fields for the prior state, excluding `id`, `object`,
+ *   `uri`, and `context` (filled by this helper).
+ * @param after - Event-specific fields for the updated state, excluding `id`, `object`,
+ *   `uri`, and `context` (filled by this helper).
+ * @returns A two-tuple in send order: the fully merged after payload, then the fully
+ *   merged before payload. Spread into the matching `send*Message` call.
+ */
+export declare function generateBeforeAfterContext<T extends UITelemetryClientMethodKeys>(id: EventAfterContext<T>['id'], object: EventAfterContext<T>['object'], before: Omit<EventBeforeContext<T>, 'id' | 'object' | 'uri' | 'context'>, after: Omit<EventAfterContext<T>, 'id' | 'object' | 'uri' | 'context'>): [EventAfterContext<T> & {
+    context: 'after';
+}, EventBeforeContext<T> & {
+    context: 'before';
+}];
+export {};

package/lib/core/utils/telemetry/generate-before-after-context.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateBeforeAfterContext = generateBeforeAfterContext;
+const get_base_data_attributes_1 = require("./get-base-data-attributes");
+/**
+ * Builds a typed `[after, before]` tuple for Realm UI telemetry events whose AsyncAPI
+ * contract lists the updated state first, then the prior state (per CloudEvents styleguide).
+ *
+ * Each slice merges {@link getBaseDataAttributes} (`id`, `object`, `uri`) with the
+ * corresponding partial payload and sets `context` to `'after'` or `'before'`.
+ *
+ * @template T - Telemetry client method key whose `data` tuple is
+ *   `[after, before, ...]` (for example `'sendLanguagePickerChangedMessage'`).
+ * @param id - Stable resource identifier passed to {@link getBaseDataAttributes}
+ *   and included on both payloads.
+ * @param object - Resource kind passed to {@link getBaseDataAttributes}
+ *   and included on both payloads (for example `'dropdown'` or `'button'`).
+ * @param before - Event-specific fields for the prior state, excluding `id`, `object`,
+ *   `uri`, and `context` (filled by this helper).
+ * @param after - Event-specific fields for the updated state, excluding `id`, `object`,
+ *   `uri`, and `context` (filled by this helper).
+ * @returns A two-tuple in send order: the fully merged after payload, then the fully
+ *   merged before payload. Spread into the matching `send*Message` call.
+ */
+function generateBeforeAfterContext(id, object, before, after) {
+    const baseAttributes = (0, get_base_data_attributes_1.getBaseDataAttributes)(id, object);
+    return [
+        Object.assign(Object.assign(Object.assign({}, baseAttributes), { context: 'after' }), after),
+        Object.assign(Object.assign(Object.assign({}, baseAttributes), { context: 'before' }), before),
+    ];
+}
+//# sourceMappingURL=generate-before-after-context.js.map

package/lib/core/utils/telemetry/generate-resource-urn.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Generates a resource URN for Realm UI telemetry.
+ * @param object - The object type.
+ * @param id - The resource ID.
+ * @returns The resource URN.
+ */
+export declare function generateResourceUrn<K, T, U>(object: K, id: T): U;