@redocly/theme 0.59.0-rc.2 → 0.60.0-next.0

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

@@ -6,15 +6,20 @@ const react_1 = require("react");
 const react_router_dom_1 = require("react-router-dom");
 const MORE_BUTTON_WIDTH = 80;
 const TABS_GAP = 8;
-function useTabs({ activeTab, onTabChange, totalTabs, containerRef }) {
+function useTabs({ activeTab, onTabChange, totalTabs, containerRef, }) {
     const [tabs, setTabs] = (0, react_1.useState)({
         visible: Array.from({ length: totalTabs }, (_, i) => i),
         overflow: [],
     });
+    const [isReady, setIsReady] = (0, react_1.useState)(false);
+    const isFirstCalculation = (0, react_1.useRef)(true);
     const tabRefs = (0, react_1.useRef)([]);
     const tabWidthsRef = (0, react_1.useRef)([]);
     const tabLabelsRef = (0, react_1.useRef)([]);
-    const allTabsHidden = (0, react_1.useMemo)(() => tabs.visible.length === 0, [tabs.visible]);
+    const activeTabRef = (0, react_1.useRef)(activeTab);
+    const calculateVisibleTabsRef = (0, react_1.useRef)(null);
+    // Synchronously update ref before any callbacks or effects run
+    activeTabRef.current = activeTab;
     const setTabRef = (0, react_1.useCallback)((element, index) => {
         tabRefs.current[index] = element;
         const width = element === null || element === void 0 ? void 0 : element.offsetWidth;
@@ -25,18 +30,25 @@ function useTabs({ activeTab, onTabChange, totalTabs, containerRef }) {
         if (label) {
             tabLabelsRef.current[index] = label;
         }
-    }, []);
-    const focusTab = (index) => {
+        // Trigger calculation once all tabs are registered
+        if (isFirstCalculation.current &&
+            tabWidthsRef.current.length >= totalTabs &&
+            tabLabelsRef.current.length >= totalTabs &&
+            calculateVisibleTabsRef.current) {
+            requestAnimationFrame(calculateVisibleTabsRef.current);
+        }
+    }, [totalTabs]);
+    const focusTab = (0, react_1.useCallback)((index) => {
         const currentElement = tabRefs.current[index];
         currentElement === null || currentElement === void 0 ? void 0 : currentElement.focus();
-    };
+    }, []);
     const onTabSelect = (0, react_1.useCallback)((index) => {
         var _a;
         focusTab(index);
         const label = (_a = tabRefs.current[index]) === null || _a === void 0 ? void 0 : _a.getAttribute('data-label');
         if (label)
             onTabChange(label);
-    }, [onTabChange]);
+    }, [onTabChange, focusTab]);
     const handleKeyboard = (0, react_1.useCallback)((event, index) => {
         let newIndex = index;
         if (event.key === 'ArrowRight') {
@@ -59,109 +71,155 @@ function useTabs({ activeTab, onTabChange, totalTabs, containerRef }) {
         onTabSelect(newIndex);
     }, [totalTabs, onTabSelect]);
     const replaceLastVisibleTabWithClickedOverflowTab = (0, react_1.useCallback)((clickedIndex) => {
-        const { visible: visibleTabs, overflow: overflowTabs } = tabs;
-        // Indexes of visible tabs should be sorted(asc), to replace the last visible tab with the clicked tab
-        const newVisibleTabs = [...visibleTabs].sort((a, b) => a - b);
-        const newOverflowTabs = [...overflowTabs];
-        const clickedIdxInOverflow = newOverflowTabs.indexOf(clickedIndex);
-        if (clickedIdxInOverflow !== -1) {
-            const lastVisible = newVisibleTabs[newVisibleTabs.length - 1];
-            newOverflowTabs.splice(clickedIdxInOverflow, 1);
-            newOverflowTabs.unshift(lastVisible);
-            newVisibleTabs.splice(newVisibleTabs.length - 1, 1);
-            newVisibleTabs.unshift(clickedIndex);
-        }
-        setTabs({
-            visible: newVisibleTabs,
-            overflow: newOverflowTabs,
+        setTabs((prevTabs) => {
+            const { visible: visibleTabs, overflow: overflowTabs } = prevTabs;
+            const sortedVisible = [...visibleTabs].sort((a, b) => a - b);
+            const lastVisible = sortedVisible[sortedVisible.length - 1];
+            return {
+                visible: visibleTabs.map((idx) => (idx === lastVisible ? clickedIndex : idx)),
+                overflow: overflowTabs.map((idx) => (idx === clickedIndex ? lastVisible : idx)),
+            };
         });
-    }, [tabs]);
+    }, []);
     const onTabClick = (0, react_1.useCallback)((labelOrIndex) => {
         const clickedIndex = typeof labelOrIndex === 'string'
             ? tabRefs.current.findIndex((ref) => (ref === null || ref === void 0 ? void 0 : ref.getAttribute('data-label')) === labelOrIndex)
             : labelOrIndex;
         if (clickedIndex === -1)
             return;
-        const hasOverflowTabs = tabs.overflow.length > 0;
-        if (hasOverflowTabs && !allTabsHidden && tabs.overflow.includes(clickedIndex)) {
-            replaceLastVisibleTabWithClickedOverflowTab(clickedIndex);
-        }
         const label = tabLabelsRef.current[clickedIndex];
-        if (label) {
-            onTabChange(label);
-            focusTab(clickedIndex);
+        if (!label)
+            return;
+        // If this is an overflow tab, replace it with a visible one
+        if (tabs.overflow.includes(clickedIndex)) {
+            replaceLastVisibleTabWithClickedOverflowTab(clickedIndex);
         }
-    }, [allTabsHidden, tabs.overflow, onTabChange, replaceLastVisibleTabWithClickedOverflowTab]);
+        onTabChange(label);
+        focusTab(clickedIndex);
+    }, [tabs.overflow, onTabChange, replaceLastVisibleTabWithClickedOverflowTab, focusTab]);
     const calculateVisibleTabs = (0, react_1.useCallback)(() => {
         const container = containerRef === null || containerRef === void 0 ? void 0 : containerRef.current;
         if (!container)
             return;
         const containerWidth = container.offsetWidth;
         const tabWidths = tabWidthsRef.current;
-        const activeTabIndex = tabRefs.current.findIndex((ref) => (ref === null || ref === void 0 ? void 0 : ref.getAttribute('data-label')) === activeTab);
-        // Active tab should always be visible, so we include it at the beginning of the array
+        const tabLabels = tabLabelsRef.current;
+        // Wait until all tabs are registered before calculating
+        if (tabWidths.length < totalTabs || tabLabels.length < totalTabs) {
+            return;
+        }
+        // Check if container has proper width (not zero)
+        if (containerWidth === 0) {
+            return;
+        }
+        // Find active tab index by label in tabLabelsRef, not by DOM element
+        // because tab might not be rendered if it's in overflow
+        const activeTabIndex = tabLabels.findIndex((label) => label === activeTabRef.current);
         let tabsWidth = activeTabIndex !== -1 ? tabWidths[activeTabIndex] : 0;
-        const visible = activeTabIndex !== -1 ? [activeTabIndex] : [];
-        const overflow = [];
+        const visibleTabs = activeTabIndex !== -1 ? [activeTabIndex] : [];
+        const overflowTabs = [];
         for (let i = 0; i < tabWidths.length; i++) {
-            // Skip active tab, it was added initially
-            if (i === activeTabIndex) {
+            if (i === activeTabIndex)
                 continue;
-            }
             const tabWidthWithGap = tabWidths[i] + TABS_GAP;
             const projectedWidth = tabsWidth + tabWidthWithGap;
             if (projectedWidth <= containerWidth) {
-                visible.push(i);
+                visibleTabs.push(i);
                 tabsWidth += tabWidthWithGap;
             }
             else {
-                overflow.push(i);
+                overflowTabs.push(i);
             }
         }
-        if (overflow.length > 0) {
+        if (overflowTabs.length > 0) {
             tabsWidth += MORE_BUTTON_WIDTH;
-            // Remove tabs starting from the end of the array until the width of the visible tabs is less than the container width
-            while (tabsWidth > containerWidth && visible.length) {
-                const removed = visible.pop();
-                if (removed !== undefined) {
-                    overflow.unshift(removed);
+            while (tabsWidth > containerWidth && visibleTabs.length > 1) {
+                const removed = visibleTabs.pop();
+                // Never remove the active tab - it should always stay visible or be the last one
+                if (removed !== undefined && removed !== activeTabIndex) {
+                    overflowTabs.unshift(removed);
                     tabsWidth -= tabWidths[removed];
                 }
+                else if (removed === activeTabIndex) {
+                    // Put it back if we accidentally removed the active tab
+                    visibleTabs.push(removed);
+                    break;
+                }
+            }
+            // If even with only the active tab visible, it doesn't fit with More button,
+            // move all tabs to overflow (show only dropdown)
+            if (tabsWidth > containerWidth && visibleTabs.length === 1) {
+                overflowTabs.unshift(...visibleTabs);
+                visibleTabs.length = 0;
             }
         }
         setTabs({
-            visible,
-            overflow,
+            visible: visibleTabs,
+            overflow: overflowTabs,
         });
-    }, [containerRef, activeTab]);
+        // Set ready state on first calculation
+        if (isFirstCalculation.current) {
+            isFirstCalculation.current = false;
+            setIsReady(true);
+        }
+    }, [containerRef, totalTabs]);
+    // Store calculateVisibleTabs in ref for use in setTabRef
+    calculateVisibleTabsRef.current = calculateVisibleTabs;
+    // Reset isFirstCalculation when totalTabs changes (new page/tabs)
     (0, react_1.useEffect)(() => {
-        if (!(containerRef === null || containerRef === void 0 ? void 0 : containerRef.current))
+        isFirstCalculation.current = true;
+        setIsReady(false);
+        // Clear refs so we wait for new tabs to register
+        tabWidthsRef.current = [];
+        tabLabelsRef.current = [];
+    }, [totalTabs]);
+    // Call calculateVisibleTabs on first render and resize
+    (0, react_1.useEffect)(() => {
+        const container = containerRef === null || containerRef === void 0 ? void 0 : containerRef.current;
+        if (!container)
             return;
-        let resizeTimeout = requestAnimationFrame(calculateVisibleTabs);
+        let resizeTimeout = null;
+        // Use ResizeObserver to wait until container has proper size
+        const resizeObserver = new ResizeObserver(() => {
+            if (resizeTimeout)
+                cancelAnimationFrame(resizeTimeout);
+            resizeTimeout = requestAnimationFrame(calculateVisibleTabs);
+        });
+        resizeObserver.observe(container);
         const handleResize = () => {
-            if (resizeTimeout) {
+            if (resizeTimeout)
                 cancelAnimationFrame(resizeTimeout);
-            }
             resizeTimeout = requestAnimationFrame(calculateVisibleTabs);
         };
         window.addEventListener('resize', handleResize);
         return () => {
+            resizeObserver.disconnect();
             window.removeEventListener('resize', handleResize);
-            cancelAnimationFrame(resizeTimeout);
+            if (resizeTimeout)
+                cancelAnimationFrame(resizeTimeout);
         };
     }, [containerRef, totalTabs, calculateVisibleTabs]);
+    // Recalculate when activeTab changes to ensure it's visible
+    (0, react_1.useEffect)(() => {
+        if (!(containerRef === null || containerRef === void 0 ? void 0 : containerRef.current) || isFirstCalculation.current)
+            return;
+        requestAnimationFrame(calculateVisibleTabs);
+    }, [activeTab, containerRef, calculateVisibleTabs]);
     return {
         setTabRef,
         onTabClick,
         handleKeyboard,
         visibleTabs: tabs.visible,
         overflowTabs: tabs.overflow,
-        allTabsHidden,
+        isReady,
     };
 }
 const useActiveTab = ({ initialTab, tabsId }) => {
     const [searchParams, setSearchParams] = (0, react_router_dom_1.useSearchParams)();
-    const [activeTab, setActiveTab] = (0, react_1.useState)(getInitialTab({ initialTab, searchParams, tabsId }));
+    const initialTabValue = (0, react_1.useMemo)(() => getInitialTab({ initialTab, searchParams, tabsId }), 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    []);
+    const [activeTab, setActiveTab] = (0, react_1.useState)(initialTabValue);
     const prevActiveTabRef = (0, react_1.useRef)(activeTab);
     (0, react_1.useEffect)(() => {
         const hasActiveTabChanged = prevActiveTabRef.current !== activeTab;
@@ -174,10 +232,10 @@ const useActiveTab = ({ initialTab, tabsId }) => {
             return searchParams;
         });
     }, [activeTab, setSearchParams, tabsId]);
-    return {
+    return (0, react_1.useMemo)(() => ({
         activeTab,
         setActiveTab,
-    };
+    }), [activeTab]);
 };
 exports.useActiveTab = useActiveTab;
 const getInitialTab = ({ initialTab, searchParams, tabsId }) => {

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

@@ -36,20 +36,22 @@ export declare const useTelemetryFallback: () => {
     sendLanguagePickerLocaleChangedMessage: () => void;
     sendSearchOpenedMessage: () => void;
     sendSearchQueryMessage: () => void;
+    sendSearchAiOpenedMessage: () => void;
     sendSearchAIQueryMessage: () => void;
+    sendSearchAIFeedbackMessage: () => void;
     sendFeedbackMessage: () => void;
     sendSearchResultClickedMessage: () => void;
     sendRedirectMessage: () => void;
     sendOpenapiDocsMessage: () => void;
     sendCopyCodeSnippetClickedMessage: () => void;
-    sendOpenapiDocsViewedMessage: () => void;
-    sendOpenapiDocsPerformanceMetricsMessage: () => void;
-    sendOpenapiDocsDownloadDefinitionClickedMessage: () => void;
-    sendOpenapiDocsSelectLanguageClickedMessage: () => void;
-    sendOpenapiDocsExpandCollapseAllClickedMessage: () => void;
-    sendOpenapiDocsSwitchServersClickedMessage: () => void;
-    sendOpenapiDocsExamplesSwitcherClickedMessage: () => void;
-    sendOpenapiDocsTryItOpenedMessage: () => void;
+    sendViewedMessage: () => void;
+    sendPerformanceMetricsMessage: () => void;
+    sendDownloadDefinitionClickedMessage: () => void;
+    sendSelectLanguageClickedMessage: () => void;
+    sendExpandCollapseAllClickedMessage: () => void;
+    sendSwitchServersClickedMessage: () => void;
+    sendExamplesSwitcherClickedMessage: () => void;
+    sendTryItOpenedMessage: () => void;
     sendAsyncapiDocsViewedMessage: () => void;
     sendAsyncapiDocsPerformanceMetricsMessage: () => void;
     sendAsyncapiDocsSwitchMessageClickedMessage: () => void;

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

@@ -40,20 +40,22 @@ const useTelemetryFallback = () => ({
     sendLanguagePickerLocaleChangedMessage: () => { },
     sendSearchOpenedMessage: () => { },
     sendSearchQueryMessage: () => { },
+    sendSearchAiOpenedMessage: () => { },
     sendSearchAIQueryMessage: () => { },
+    sendSearchAIFeedbackMessage: () => { },
     sendFeedbackMessage: () => { },
     sendSearchResultClickedMessage: () => { },
     sendRedirectMessage: () => { },
     sendOpenapiDocsMessage: () => { },
     sendCopyCodeSnippetClickedMessage: () => { },
-    sendOpenapiDocsViewedMessage: () => { },
-    sendOpenapiDocsPerformanceMetricsMessage: () => { },
-    sendOpenapiDocsDownloadDefinitionClickedMessage: () => { },
-    sendOpenapiDocsSelectLanguageClickedMessage: () => { },
-    sendOpenapiDocsExpandCollapseAllClickedMessage: () => { },
-    sendOpenapiDocsSwitchServersClickedMessage: () => { },
-    sendOpenapiDocsExamplesSwitcherClickedMessage: () => { },
-    sendOpenapiDocsTryItOpenedMessage: () => { },
+    sendViewedMessage: () => { },
+    sendPerformanceMetricsMessage: () => { },
+    sendDownloadDefinitionClickedMessage: () => { },
+    sendSelectLanguageClickedMessage: () => { },
+    sendExpandCollapseAllClickedMessage: () => { },
+    sendSwitchServersClickedMessage: () => { },
+    sendExamplesSwitcherClickedMessage: () => { },
+    sendTryItOpenedMessage: () => { },
     sendAsyncapiDocsViewedMessage: () => { },
     sendAsyncapiDocsPerformanceMetricsMessage: () => { },
     sendAsyncapiDocsSwitchMessageClickedMessage: () => { },

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

@@ -2,6 +2,7 @@ export type { UserClaims } from '../types/user-claims';
 export type { OperationParameter, ParameterHighlight } from '../types/search';
 export type { TFunction, TOptions } from '../types/l10n';
 export type { SelectOption, SelectProps } from '../types/select';
+export type { SegmentedOption, SegmentedProps } from '../types/segmented';
 export { IS_BROWSER } from '../utils/dom';
 export { addLeadingSlash, removeLeadingSlash, getPathPrefix, combineUrls, addTrailingSlash, withPathPrefix, } from '../utils/urls';
 export { capitalize } from '../utils/string';

package/lib/core/styles/dark.js

@@ -37,6 +37,10 @@ const replayDarkMode = (0, styled_components_1.css) `
   --replay-server-variable-bg-color-hover: rgba(31, 10, 144, 0.4); // @presenter Color
   --replay-path-parameter-bg-color-hover: rgba(5, 88, 99, 0.4); // @presenter Color
 
+  --replay-runtime-expression-color:  rgba(147, 166, 249, 1); // @presenter Color
+  --replay-runtime-expression-bg-color: rgba(147, 166, 249, 0.16); // @presenter Color
+  --replay-operators-color: rgba(168, 143, 88, 1); // @presenter Color
+
   // @tokens End
 `;
 exports.darkMode = (0, styled_components_1.css) `

package/lib/core/styles/global.js

@@ -1203,6 +1203,10 @@ const replay = (0, styled_components_1.css) `
   --replay-server-variable-bg-color-hover: rgba(119, 45, 240, 0.16); // @presenter Color
   --replay-path-parameter-bg-color-hover: rgba(4, 117, 161, 0.16); // @presenter Color
 
+  --replay-runtime-expression-color: rgba(54, 90, 249, 1); // @presenter Color
+  --replay-runtime-expression-bg-color: rgba(54, 90, 249, 0.08); // @presenter Color
+  --replay-operators-color: rgba(193, 142, 31, 1); // @presenter Color
+
   // @tokens End
 `;
 exports.styles = (0, styled_components_1.css) `
@@ -1216,6 +1220,7 @@ exports.styles = (0, styled_components_1.css) `
     ${variables_5.breadcrumbs}
     ${variables_19.button}
     ${variables_20.aiAssistantButton}
+    ${variables_20.connectMCPButton}
     ${variables_38.cards}
     ${variables_8.catalog}
     ${variables_10.catalogClassic}

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

@@ -60,7 +60,7 @@ export type ThemeHooks = {
         breadcrumbs: BreadcrumbItem[];
         currentItemSiblings?: BreadcrumbItem[];
     };
-    useSearch: (product?: string, autoSearchDisabled?: boolean) => {
+    useSearch: (product?: string, autoSearchDisabled?: boolean, searchSessionId?: string) => {
         query: string;
         setQuery: React.Dispatch<React.SetStateAction<string>>;
         filter: SearchFilterItem[];
@@ -78,7 +78,7 @@ export type ThemeHooks = {
     };
     useAiSearch: (options?: {
         filter?: SearchFilterItem[];
-    }) => {
+    }, searchSessionId?: string) => {
         askQuestion: (question: string, history?: AiSearchConversationItem[]) => void;
         isGeneratingResponse: boolean;
         question: string;

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

@@ -1,6 +1,7 @@
 export * from './breadcrumb';
 export * from './catalog';
 export * from './l10n';
+export * from './mcp';
 export * from './feedback';
 export * from './hooks';
 export * from './markdown';

package/lib/core/types/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./breadcrumb"), exports);
 __exportStar(require("./catalog"), exports);
 __exportStar(require("./l10n"), exports);
+__exportStar(require("./mcp"), exports);
 __exportStar(require("./feedback"), exports);
 __exportStar(require("./hooks"), exports);
 __exportStar(require("./markdown"), exports);

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.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.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' | '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' | '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' | '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.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.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';
+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' | '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' | '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.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';
 export type Locale = {
     code: string;
     name: string;

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

@@ -0,0 +1,6 @@
+export type MCPClientType = 'cursor' | 'vscode';
+export type MCPOption = 'cursor' | 'vscode' | 'copy';
+export type McpConnectionParams = {
+    serverName: string;
+    url: string;
+};

package/lib/core/types/mcp.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=mcp.js.map

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

@@ -82,11 +82,18 @@ export type AiSearchErrorConfig = {
     messageKey: string;
     messageDefault: string;
 };
+export declare enum FeedbackType {
+    Like = "like",
+    Dislike = "dislike"
+}
+export type SearchAiMessageResource = {
+    url: string;
+    title: string;
+};
 export type AiSearchConversationItem = {
     role: AiSearchConversationRole;
     content: string;
-    resources?: {
-        url: string;
-        title: string;
-    }[];
+    resources?: SearchAiMessageResource[];
+    messageId?: string;
+    feedback?: FeedbackType;
 };

package/lib/core/types/search.js

@@ -1,3 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeedbackType = void 0;
+var FeedbackType;
+(function (FeedbackType) {
+    FeedbackType["Like"] = "like";
+    FeedbackType["Dislike"] = "dislike";
+})(FeedbackType || (exports.FeedbackType = FeedbackType = {}));
 //# sourceMappingURL=search.js.map

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

@@ -0,0 +1,12 @@
+import type React from 'react';
+import type { SelectOption } from './select';
+export type SegmentedOption<T> = SelectOption<T> & {
+    divider?: React.ReactNode;
+};
+export type SegmentedProps<T = any> = {
+    options: SegmentedOption<T>[];
+    value: T;
+    onChange: ({ label, value }: SegmentedOption<T>) => void;
+    className?: string;
+    size?: 'regular' | 'small';
+};

package/lib/core/types/segmented.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=segmented.js.map

package/lib/core/utils/frontmatter-translate.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Utility function for use in React frontmatter
+ * This function creates a string that will be processed by the frontmatter loader
+ * to convert it into a translation key object
+ */
+export declare const frontmatterTranslate: (key: string, defaultValue: string) => string;

package/lib/core/utils/frontmatter-translate.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.frontmatterTranslate = void 0;
+/**
+ * Utility function for use in React frontmatter
+ * This function creates a string that will be processed by the frontmatter loader
+ * to convert it into a translation key object
+ */
+const frontmatterTranslate = (key, defaultValue) => {
+    const escapedDefaultValue = defaultValue.replace(/'/g, "\\'");
+    return `frontmatterTranslate('${key}', '${escapedDefaultValue}')`;
+};
+exports.frontmatterTranslate = frontmatterTranslate;
+//# sourceMappingURL=frontmatter-translate.js.map

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

@@ -1,6 +1,7 @@
 export * from './clipboard-service';
 export * from './css-variables';
 export * from './add-line-numbers';
+export * from './mcp';
 export * from './media-css';
 export * from './theme-helpers';
 export * from './class-names';
@@ -38,3 +39,4 @@ export * from './enhanced-smoothstep';
 export * from './icon-resolver';
 export * from './dynamic';
 export * from './tabs';
+export * from './frontmatter-translate';

package/lib/core/utils/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./clipboard-service"), exports);
 __exportStar(require("./css-variables"), exports);
 __exportStar(require("./add-line-numbers"), exports);
+__exportStar(require("./mcp"), exports);
 __exportStar(require("./media-css"), exports);
 __exportStar(require("./theme-helpers"), exports);
 __exportStar(require("./class-names"), exports);
@@ -54,4 +55,5 @@ __exportStar(require("./enhanced-smoothstep"), exports);
 __exportStar(require("./icon-resolver"), exports);
 __exportStar(require("./dynamic"), exports);
 __exportStar(require("./tabs"), exports);
+__exportStar(require("./frontmatter-translate"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -0,0 +1,2 @@
+import type { MCPClientType, McpConnectionParams } from '../types';
+export declare function generateMCPDeepLink(clientType: MCPClientType, config: McpConnectionParams): string;

package/lib/core/utils/mcp.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateMCPDeepLink = generateMCPDeepLink;
+function generateCursorMCPDeepLink(config) {
+    const cursorConfig = {
+        url: config.url,
+        description: 'MCP Server',
+    };
+    const encodedConfig = btoa(JSON.stringify(cursorConfig));
+    return `cursor://anysphere.cursor-deeplink/mcp/install?name=${config.serverName}&config=${encodedConfig}`;
+}
+function generateVSCodeMCPDeepLink(config) {
+    const vscodeConfig = {
+        name: config.serverName,
+        url: config.url,
+        type: 'http',
+    };
+    const encodedConfig = encodeURIComponent(JSON.stringify(vscodeConfig));
+    return `vscode:mcp/install?${encodedConfig}`;
+}
+function generateMCPDeepLink(clientType, config) {
+    switch (clientType) {
+        case 'cursor':
+            return generateCursorMCPDeepLink(config);
+        case 'vscode':
+            return generateVSCodeMCPDeepLink(config);
+        default:
+            return generateCursorMCPDeepLink(config);
+    }
+}
+//# sourceMappingURL=mcp.js.map