@redocly/theme 0.60.0-next.2 → 0.60.0-next.4

package/lib/components/Buttons/variables.js

@@ -24,7 +24,7 @@ exports.aiAssistantButton = (0, styled_components_1.css) `
   /* Positioning */
   --ai-assistant-button-bottom: var(--spacing-xl);
   --ai-assistant-button-right: var(--spacing-xl);
-  --ai-assistant-button-z-index: 50
+  --ai-assistant-button-z-index: calc(var(--z-index-overlay) - 1);
 
   /* Typography */
   --ai-assistant-button-font-size: var(--font-size-base);

package/lib/components/Menu/MenuItem.js

@@ -80,7 +80,11 @@ function MenuItem(props) {
         }
     };
     const chevron = hasChevron ? (isExpanded ? (react_1.default.createElement(ChevronDownIcon_1.ChevronDownIcon, { size: "var(--menu-item-label-chevron-size)", color: "--tree-content-color-default" })) : (react_1.default.createElement(ChevronRightIcon_1.ChevronRightIcon, { size: "var(--menu-item-label-chevron-size)", color: "--tree-content-color-default" }))) : null;
-    const httpColor = item.deprecated ? 'http-deprecated' : item.httpVerb;
+    const httpColor = (0, utils_1.getOperationColor)({
+        isAdditionalOperation: item.isAdditionalOperation,
+        deprecated: item.deprecated,
+        httpVerb: item.httpVerb || '',
+    });
     const label = item.label && (react_1.default.createElement(MenuItemLabelWrapper, { active: item.active, deprecated: item.deprecated, depth: depth, withChevron: hasChevron, isSeparator: isSeparator, onClick: handleOnClick, onKeyDown: handleExpandOnEnter, ref: labelRef, role: item.link ? 'none' : 'link', tabIndex: !item.link ? 0 : undefined, "data-testid": "menu-item-label", "data-active": item.active },
         hasChevron ? react_1.default.createElement(ChevronWrapper, null, chevron) : null,
         react_1.default.createElement(MenuItemIcon, { icon: item.icon, srcSet: item.srcSet }),

package/lib/components/Search/FilterFields/SearchFilterFieldTags.js

@@ -7,6 +7,8 @@ exports.SearchFilterFieldTags = SearchFilterFieldTags;
 const react_1 = __importDefault(require("react"));
 const styled_components_1 = __importDefault(require("styled-components"));
 const Tag_1 = require("../../../components/Tag/Tag");
+const utils_1 = require("../../../core/utils");
+const constants_1 = require("../../../core/constants");
 function SearchFilterFieldTags({ className, facet, selectedValues, onChange, }) {
     return (react_1.default.createElement(FilterTagsWrapper, { "data-component-name": "Search/FilterFields/SearchFilterFieldTags", className: className }, facet.values.map((facetCount, index) => {
         const { value, count, isCounterVisible } = facetCount;
@@ -17,7 +19,11 @@ function SearchFilterFieldTags({ className, facet, selectedValues, onChange, })
                 : [...selectedValues, value];
             onChange(values);
         };
-        return (react_1.default.createElement(FilterTagWrapper, { key: `${count}-${index}`, tabIndex: 0, color: value, onClick: () => {
+        const color = (0, utils_1.getOperationColor)({
+            httpVerb: value,
+            isAdditionalOperation: !constants_1.REQUEST_METHODS.includes(value.toUpperCase()),
+        });
+        return (react_1.default.createElement(FilterTagWrapper, { key: `${count}-${index}`, tabIndex: 0, color: color, onClick: () => {
                 updateSelectedValues();
             }, onKeyDown: (e) => {
                 if (e.key === 'Enter') {

package/lib/components/Search/SearchItem.js

@@ -61,6 +61,10 @@ function SearchItem({ onClick, item, className, product, innerRef, }) {
     const { document, highlight } = item;
     const parameter = highlight.parameters && highlight.parameters.length ? highlight.parameters[0] : null;
     const shouldShowPath = document.path && ((_a = document.path) === null || _a === void 0 ? void 0 : _a.length) > 1;
+    const httpColor = (0, utils_1.getOperationColor)({
+        isAdditionalOperation: document.isAdditionalOperation,
+        httpVerb: document.httpMethod || '',
+    });
     return (react_1.default.createElement(SearchItemWrapper, { className: className, to: document.url, onClick: onClick, tabIndex: 0, innerRef: (el) => {
             ref.current = el;
             if (!innerRef)
@@ -78,7 +82,7 @@ function SearchItem({ onClick, item, className, product, innerRef, }) {
                     react_1.default.createElement(Image_1.Image, { src: product.icon }),
                     product.name)),
                 document.httpMethod ? (react_1.default.createElement(SearchItemOperation, null,
-                    react_1.default.createElement(SearchItemOperationTag, { color: document.httpMethod }, document.httpMethod.toUpperCase()),
+                    react_1.default.createElement(SearchItemOperationTag, { color: httpColor }, document.httpMethod.toUpperCase()),
                     highlight.httpPath ? (0, SearchHighlight_1.searchHighlight)(highlight.httpPath) : document.httpPath)) : null,
                 react_1.default.createElement(SearchItemTitleWrapper, null,
                     react_1.default.createElement(SearchItemTitle, null, highlight.title ? (0, SearchHighlight_1.searchHighlight)(highlight.title) : document.title),

package/lib/components/Tag/Tag.d.ts

@@ -6,7 +6,7 @@ type SubjectStatusColor = 'active' | 'draft' | 'deprecated' | 'product';
 type HttpColor = 'get' | 'post' | 'put' | 'delete' | 'option' | 'patch' | 'head' | 'hook' | 'link';
 type ActionColor = 'receive' | 'send';
 type ChannelColor = 'channel';
-type HttpStatusColor = 'http-deprecated';
+type HttpStatusColor = 'http-deprecated' | 'http-additional-operation';
 type StatusColor = DefaultStatusColor | ActionStatusColor | SubjectStatusColor | HttpColor | ActionColor | ChannelColor | HttpStatusColor;
 type Color = 'red' | 'green' | 'blue' | 'grey' | 'turquoise' | 'magenta' | 'purple' | 'carrot' | 'raspberry' | 'orange' | 'grass' | 'persian-green' | 'sky' | 'blueberry';
 export type TagProps = {

package/lib/components/Tag/variables.dark.js

@@ -232,6 +232,12 @@ exports.tagDarkMode = (0, styled_components_1.css) `
     --tag-bg-color-hover: #373776; // @presenter Color
   }
 
+  .tag-http-additional-operation {
+    --tag-color: #FCAB69; // @presenter Color
+    --tag-bg-color: #523926; // @presenter Color
+    --tag-bg-color-hover: #694830; // @presenter Color
+  }
+
   .tag-receive {
     --tag-color: #88CF82; // @presenter Color
     --tag-bg-color: #23421F; // @presenter Color

package/lib/components/Tag/variables.js

@@ -313,6 +313,12 @@ exports.tag = (0, styled_components_1.css) `
     --tag-color: var(--text-color-disabled); // @presenter Color
   }
 
+  .tag-http-additional-operation {
+    --tag-color: #F97316; // @presenter Color
+    --tag-bg-color: #faede3; // @presenter Color
+    --tag-bg-color-hover: #fae2cf; // @presenter Color
+  }
+
   .tag-send {
     --tag-color: #4144F6; // @presenter Color
     --tag-bg-color: #ECECFE; // @presenter Color

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

@@ -4,4 +4,5 @@ export * from './code-walkthrough';
 export * from './search';
 export * from './catalog';
 export * from './breadcrumb';
+export * from './request-methods';
 export * from './mcp';

package/lib/core/constants/index.js

@@ -20,5 +20,6 @@ __exportStar(require("./code-walkthrough"), exports);
 __exportStar(require("./search"), exports);
 __exportStar(require("./catalog"), exports);
 __exportStar(require("./breadcrumb"), exports);
+__exportStar(require("./request-methods"), exports);
 __exportStar(require("./mcp"), exports);
 //# sourceMappingURL=index.js.map

package/lib/core/constants/request-methods.d.ts

@@ -0,0 +1 @@
+export declare const REQUEST_METHODS: string[];

package/lib/core/constants/request-methods.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REQUEST_METHODS = void 0;
+exports.REQUEST_METHODS = [
+    'GET',
+    'POST',
+    'PUT',
+    'DELETE',
+    'PATCH',
+    'OPTIONS',
+    'HEAD',
+    'TRACE',
+];
+//# sourceMappingURL=request-methods.js.map

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

@@ -11,6 +11,7 @@ export { useMount } from '../hooks/use-mount';
 export { GlobalStyle } from '../styles/global';
 export { breakpoints } from '../utils/media-css';
 export { isPrimitive } from '../utils/args-typecheck';
+export { getOperationColor } from '../utils/get-operation-color';
 export { ClipboardService } from '../utils/clipboard-service';
 export { getUserAgent } from '../utils/get-user-agent';
 export { useFocusTrap } from '../hooks/use-focus-trap';

package/lib/core/openapi/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ThemeDataContext = exports.isObject = exports.isNotNull = exports.isString = exports.isUndefined = exports.SecurityVariablesEnvSuffix = exports.useDialogHotKeys = exports.useSearchDialog = exports.useModalScrollLock = exports.useActiveSectionId = exports.useOutsideClick = exports.useThemeHooks = exports.useFocusTrap = exports.getUserAgent = exports.ClipboardService = exports.isPrimitive = exports.breakpoints = exports.GlobalStyle = exports.useMount = exports.typedMemo = exports.capitalize = exports.withPathPrefix = exports.addTrailingSlash = exports.combineUrls = exports.getPathPrefix = exports.removeLeadingSlash = exports.addLeadingSlash = exports.IS_BROWSER = void 0;
+exports.ThemeDataContext = exports.isObject = exports.isNotNull = exports.isString = exports.isUndefined = exports.SecurityVariablesEnvSuffix = exports.useDialogHotKeys = exports.useSearchDialog = exports.useModalScrollLock = exports.useActiveSectionId = exports.useOutsideClick = exports.useThemeHooks = exports.useFocusTrap = exports.getUserAgent = exports.ClipboardService = exports.getOperationColor = exports.isPrimitive = exports.breakpoints = exports.GlobalStyle = exports.useMount = exports.typedMemo = exports.capitalize = exports.withPathPrefix = exports.addTrailingSlash = exports.combineUrls = exports.getPathPrefix = exports.removeLeadingSlash = exports.addLeadingSlash = exports.IS_BROWSER = void 0;
 var dom_1 = require("../utils/dom");
 Object.defineProperty(exports, "IS_BROWSER", { enumerable: true, get: function () { return dom_1.IS_BROWSER; } });
 var urls_1 = require("../utils/urls");
@@ -22,6 +22,8 @@ var media_css_1 = require("../utils/media-css");
 Object.defineProperty(exports, "breakpoints", { enumerable: true, get: function () { return media_css_1.breakpoints; } });
 var args_typecheck_1 = require("../utils/args-typecheck");
 Object.defineProperty(exports, "isPrimitive", { enumerable: true, get: function () { return args_typecheck_1.isPrimitive; } });
+var get_operation_color_1 = require("../utils/get-operation-color");
+Object.defineProperty(exports, "getOperationColor", { enumerable: true, get: function () { return get_operation_color_1.getOperationColor; } });
 var clipboard_service_1 = require("../utils/clipboard-service");
 Object.defineProperty(exports, "ClipboardService", { enumerable: true, get: function () { return clipboard_service_1.ClipboardService; } });
 var get_user_agent_1 = require("../utils/get-user-agent");

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

@@ -119,6 +119,7 @@ export type BffCatalogRelatedEntity = {
     relationType: EntityRelationType;
     sourceFile?: string | null;
     metadata?: Record<string, any>;
+    version?: string | null;
     readonly createdAt: string | null;
     readonly updatedAt: string | null;
 };
@@ -150,6 +151,10 @@ export type BffCatalogEntity = {
     }>;
     sourceFile?: string;
     readonly object: 'catalogEntityView';
+    readonly version?: string | null;
+    readonly revision: string;
+    readonly isCurrent?: boolean | null;
+    readonly isDefaultVersion?: boolean | null;
     readonly createdAt: string;
     readonly updatedAt: string;
 };

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

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

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

@@ -22,6 +22,7 @@ export type SearchHit = {
     httpMethod?: string;
     httpPath?: string | string[];
     deprecated?: boolean;
+    isAdditionalOperation?: boolean;
     security?: string[];
     parameters?: OperationParameter[];
     version?: string;

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

@@ -43,6 +43,7 @@ export type ItemState = Omit<SidebarNavItem, 'items'> & {
     languageInsensitive?: boolean;
     modified?: boolean;
     deprecated?: boolean;
+    isAdditionalOperation?: boolean;
 };
 export type DrilldownMenuItemDetails = {
     previousLink?: string;

package/lib/core/utils/get-operation-color.d.ts

@@ -0,0 +1,7 @@
+type OperationColorProps = {
+    deprecated?: boolean;
+    isAdditionalOperation?: boolean;
+    httpVerb: string;
+};
+export declare function getOperationColor({ deprecated, isAdditionalOperation, httpVerb, }: OperationColorProps): string;
+export {};

package/lib/core/utils/get-operation-color.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOperationColor = getOperationColor;
+function getOperationColor({ deprecated, isAdditionalOperation, httpVerb, }) {
+    if (deprecated) {
+        return 'http-deprecated';
+    }
+    else if (isAdditionalOperation) {
+        return 'http-additional-operation';
+    }
+    return httpVerb;
+}
+//# sourceMappingURL=get-operation-color.js.map

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

@@ -39,4 +39,5 @@ export * from './enhanced-smoothstep';
 export * from './icon-resolver';
 export * from './Dynamic';
 export * from './tabs';
+export * from './get-operation-color';
 export * from './frontmatter-translate';

package/lib/core/utils/index.js

@@ -55,5 +55,6 @@ __exportStar(require("./enhanced-smoothstep"), exports);
 __exportStar(require("./icon-resolver"), exports);
 __exportStar(require("./Dynamic"), exports);
 __exportStar(require("./tabs"), exports);
+__exportStar(require("./get-operation-color"), exports);
 __exportStar(require("./frontmatter-translate"), exports);
 //# sourceMappingURL=index.js.map

package/lib/markdoc/components/Tabs/Tabs.d.ts

@@ -18,7 +18,8 @@ type TabsProps = {
     size: TabsSize;
     initialTab?: string;
     forceReady?: boolean;
+    activeTab?: string;
 };
-export declare function Tabs({ id, children, className, size, initialTab: propInitialTab, forceReady, }: TabsProps): JSX.Element;
+export declare function Tabs({ id, children, className, size, initialTab: propInitialTab, forceReady, activeTab: controlledActiveTab, }: TabsProps): JSX.Element;
 export declare const TabContent: import("styled-components").StyledComponent<"div", any, {}, never>;
 export {};

package/lib/markdoc/components/Tabs/Tabs.js

@@ -46,7 +46,7 @@ var TabsSize;
     TabsSize["SMALL"] = "small";
     TabsSize["MEDIUM"] = "medium";
 })(TabsSize || (exports.TabsSize = TabsSize = {}));
-function Tabs({ id, children, className, size, initialTab: propInitialTab, forceReady = false, }) {
+function Tabs({ id, children, className, size, initialTab: propInitialTab, forceReady = false, activeTab: controlledActiveTab, }) {
     var _a, _b;
     const childrenArray = react_1.default.Children.toArray(children);
     const [isReady, setIsReady] = (0, react_1.useState)(false);
@@ -62,10 +62,15 @@ function Tabs({ id, children, className, size, initialTab: propInitialTab, force
         setIsReady(false);
     }, [labelsHash]);
     const inRouter = (0, react_router_dom_1.useInRouterContext)();
-    return (react_1.default.createElement(TabsView, { id: id, className: className, size: size, childrenArray: childrenArray, initialTab: initialTab, useActiveTab: inRouter ? useActiveTabWithRouter : useActiveTabWithoutRouter, isReady: isReady || forceReady, labelsHash: labelsHash, containerRef: containerRef, onReadyChange: handleReadyChange }));
+    return (react_1.default.createElement(TabsView, { id: id, className: className, size: size, childrenArray: childrenArray, initialTab: initialTab, useActiveTab: inRouter ? useActiveTabWithRouter : useActiveTabWithoutRouter, isReady: isReady || forceReady, labelsHash: labelsHash, containerRef: containerRef, onReadyChange: handleReadyChange, externalActiveTab: controlledActiveTab }));
 }
-function TabsView({ id, className, size, childrenArray, useActiveTab, initialTab, isReady, labelsHash, containerRef, onReadyChange, }) {
+function TabsView({ id, className, size, childrenArray, useActiveTab, initialTab, isReady, labelsHash, containerRef, onReadyChange, externalActiveTab, }) {
     const { activeTab, setActiveTab } = useActiveTab(initialTab, id, childrenArray);
+    (0, react_1.useEffect)(() => {
+        if (externalActiveTab && externalActiveTab !== activeTab) {
+            setActiveTab(externalActiveTab);
+        }
+    }, [externalActiveTab, activeTab, setActiveTab]);
     return (react_1.default.createElement(TabsContainer, { "data-component-name": "Markdoc/Tabs/Tabs", className: className, key: id, "$isReady": isReady },
         react_1.default.createElement(TabList_1.TabList, { key: labelsHash, size: size, childrenArray: childrenArray, activeTab: activeTab, onTabChange: setActiveTab, containerRef: containerRef, onReadyChange: onReadyChange }),
         childrenArray.map((child, index) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@redocly/theme",
-  "version": "0.60.0-next.2",
+  "version": "0.60.0-next.4",
   "description": "Shared UI components lib",
   "keywords": [
     "theme",
@@ -50,7 +50,7 @@
     "@types/react-dom": "^19.1.4",
     "@types/styled-components": "5.1.34",
     "@types/styled-system": "5.1.22",
-    "@vitest/coverage-v8": "^3.1.1",
+    "@vitest/coverage-v8": "^4.0.9",
     "@vitest/ui": "3.2.4",
     "concurrently": "7.6.0",
     "json-schema-to-ts": "2.7.2",
@@ -67,7 +67,7 @@
     "tsconfig-paths": "4.2.0",
     "tsconfig-paths-webpack-plugin": "3.5.2",
     "typescript": "5.9.3",
-    "vitest": "3.2.4",
+    "vitest": "4.0.9",
     "vitest-when": "0.6.2",
     "webpack": "5.94.0"
   },
@@ -87,7 +87,7 @@
     "openapi-sampler": "1.6.2",
     "react-calendar": "5.1.0",
     "react-date-picker": "11.0.0",
-    "@redocly/config": "0.38.0",
+    "@redocly/config": "0.40.0",
     "@redocly/realm-asyncapi-sdk": "0.6.0-next.0"
   },
   "scripts": {

package/src/components/Buttons/variables.ts

@@ -22,7 +22,7 @@ export const aiAssistantButton = css`
   /* Positioning */
   --ai-assistant-button-bottom: var(--spacing-xl);
   --ai-assistant-button-right: var(--spacing-xl);
-  --ai-assistant-button-z-index: 50
+  --ai-assistant-button-z-index: calc(var(--z-index-overlay) - 1);
 
   /* Typography */
   --ai-assistant-button-font-size: var(--font-size-base);

package/src/components/Menu/MenuItem.tsx

@@ -11,7 +11,7 @@ import { ChevronDownIcon } from '@redocly/theme/icons/ChevronDownIcon/ChevronDow
 import { ChevronRightIcon } from '@redocly/theme/icons/ChevronRightIcon/ChevronRightIcon';
 import { HttpTag } from '@redocly/theme/components/Tags/HttpTag';
 import { MenuItemType } from '@redocly/theme/core/constants';
-import { getMenuItemType } from '@redocly/theme/core/utils';
+import { getMenuItemType, getOperationColor } from '@redocly/theme/core/utils';
 import { ArrowRightIcon } from '@redocly/theme/icons/ArrowRightIcon/ArrowRightIcon';
 import { Badge } from '@redocly/theme/components/Badge/Badge';
 import { GenericIcon } from '@redocly/theme/icons/GenericIcon/GenericIcon';
@@ -67,7 +67,11 @@ export function MenuItem(props: React.PropsWithChildren<MenuItemProps>): JSX.Ele
     )
   ) : null;
 
-  const httpColor = item.deprecated ? 'http-deprecated' : item.httpVerb;
+  const httpColor = getOperationColor({
+    isAdditionalOperation: item.isAdditionalOperation,
+    deprecated: item.deprecated,
+    httpVerb: item.httpVerb || '',
+  });
 
   const label = item.label && (
     <MenuItemLabelWrapper

package/src/components/Search/FilterFields/SearchFilterFieldTags.tsx

@@ -4,6 +4,8 @@ import styled from 'styled-components';
 import type { SearchFacet, SearchFacetCount } from '@redocly/theme/core/types';
 
 import { Tag } from '@redocly/theme/components/Tag/Tag';
+import { getOperationColor } from '@redocly/theme/core/utils';
+import { REQUEST_METHODS } from '@redocly/theme/core/constants';
 
 type SearchFilterFieldTagsProps = {
   className?: string;
@@ -32,11 +34,15 @@ export function SearchFilterFieldTags({
             : [...selectedValues, value];
           onChange(values);
         };
+        const color = getOperationColor({
+          httpVerb: value,
+          isAdditionalOperation: !REQUEST_METHODS.includes(value.toUpperCase()),
+        });
         return (
           <FilterTagWrapper
             key={`${count}-${index}`}
             tabIndex={0}
-            color={value}
+            color={color}
             onClick={() => {
               updateSelectedValues();
             }}

package/src/components/Search/SearchItem.tsx

@@ -9,7 +9,7 @@ import { Link } from '@redocly/theme/components/Link/Link';
 import { Image } from '@redocly/theme/components/Image/Image';
 import { searchHighlight } from '@redocly/theme/components/Search/SearchHighlight';
 import { Badge } from '@redocly/theme/components/Badge/Badge';
-import { trimText } from '@redocly/theme/core/utils';
+import { trimText, getOperationColor } from '@redocly/theme/core/utils';
 import { ReturnKeyIcon } from '@redocly/theme/icons/ReturnKeyIcon/ReturnKeyIcon';
 import { useThemeHooks } from '@redocly/theme/core/hooks';
 
@@ -48,6 +48,11 @@ export function SearchItem({
     highlight.parameters && highlight.parameters.length ? highlight.parameters[0] : null;
   const shouldShowPath = document.path && document.path?.length > 1;
 
+  const httpColor = getOperationColor({
+    isAdditionalOperation: document.isAdditionalOperation,
+    httpVerb: document.httpMethod || '',
+  });
+
   return (
     <SearchItemWrapper
       className={className}
@@ -77,7 +82,7 @@ export function SearchItem({
           )}
           {document.httpMethod ? (
             <SearchItemOperation>
-              <SearchItemOperationTag color={document.httpMethod}>
+              <SearchItemOperationTag color={httpColor}>
                 {document.httpMethod.toUpperCase()}
               </SearchItemOperationTag>
               {highlight.httpPath ? searchHighlight(highlight.httpPath) : document.httpPath}

package/src/components/Tag/Tag.tsx

@@ -12,7 +12,7 @@ type SubjectStatusColor = 'active' | 'draft' | 'deprecated' | 'product';
 type HttpColor = 'get' | 'post' | 'put' | 'delete' | 'option' | 'patch' | 'head' | 'hook' | 'link';
 type ActionColor = 'receive' | 'send';
 type ChannelColor = 'channel';
-type HttpStatusColor = 'http-deprecated';
+type HttpStatusColor = 'http-deprecated' | 'http-additional-operation';
 type StatusColor =
   | DefaultStatusColor
   | ActionStatusColor

package/src/components/Tag/variables.dark.ts

@@ -230,6 +230,12 @@ export const tagDarkMode = css`
     --tag-bg-color-hover: #373776; // @presenter Color
   }
 
+  .tag-http-additional-operation {
+    --tag-color: #FCAB69; // @presenter Color
+    --tag-bg-color: #523926; // @presenter Color
+    --tag-bg-color-hover: #694830; // @presenter Color
+  }
+
   .tag-receive {
     --tag-color: #88CF82; // @presenter Color
     --tag-bg-color: #23421F; // @presenter Color

package/src/components/Tag/variables.ts

@@ -311,6 +311,12 @@ export const tag = css`
     --tag-color: var(--text-color-disabled); // @presenter Color
   }
 
+  .tag-http-additional-operation {
+    --tag-color: #F97316; // @presenter Color
+    --tag-bg-color: #faede3; // @presenter Color
+    --tag-bg-color-hover: #fae2cf; // @presenter Color
+  }
+
   .tag-send {
     --tag-color: #4144F6; // @presenter Color
     --tag-bg-color: #ECECFE; // @presenter Color

package/src/core/constants/index.ts

@@ -4,4 +4,5 @@ export * from './code-walkthrough';
 export * from './search';
 export * from './catalog';
 export * from './breadcrumb';
+export * from './request-methods';
 export * from './mcp';

package/src/core/constants/request-methods.ts

@@ -0,0 +1,10 @@
+export const REQUEST_METHODS = [
+  'GET',
+  'POST',
+  'PUT',
+  'DELETE',
+  'PATCH',
+  'OPTIONS',
+  'HEAD',
+  'TRACE',
+];

package/src/core/hooks/__mocks__/use-controlled-state.ts

@@ -1,3 +1,6 @@
-import { vi } from 'vitest';
+import { vi, type MockedFunction } from 'vitest';
 
-export const useControlledState = () => [false, vi.fn()];
+export const useControlledState = (): [boolean, MockedFunction<(value: boolean) => void>] => [
+  false,
+  vi.fn(),
+];

package/src/core/hooks/__mocks__/use-input-key-commands.ts

@@ -1,5 +1,13 @@
-import { vi } from 'vitest';
+import { vi, type MockedFunction } from 'vitest';
 
-export const useInputKeyCommands = vi.fn(() => ({
+export const useInputKeyCommands: MockedFunction<
+  (actionHandlers?: {
+    onSelectAll?: (e: React.KeyboardEvent<HTMLInputElement>) => void;
+    onEscape?: (e: React.KeyboardEvent<HTMLInputElement>) => void;
+    onClear?: (e: React.KeyboardEvent<HTMLInputElement>) => void;
+    onEnter?: (e: React.KeyboardEvent<HTMLInputElement>) => void;
+    onPaste?: (e: React.KeyboardEvent<HTMLInputElement>) => void;
+  }) => { onKeyDown: (event: React.KeyboardEvent<HTMLInputElement>) => void }
+> = vi.fn(() => ({
   onKeyDown: vi.fn(),
 }));

package/src/core/hooks/__mocks__/use-mobile-menu.ts

@@ -1,3 +1,11 @@
-import { vi } from 'vitest';
+import { vi, type MockedFunction } from 'vitest';
 
-export const useMobileMenu = () => [false, vi.fn()];
+export const useMobileMenu = (): {
+  isOpen: boolean;
+  openMobileMenu: MockedFunction<() => void>;
+  closeMobileMenu: MockedFunction<() => void>;
+} => ({
+  isOpen: false,
+  openMobileMenu: vi.fn(),
+  closeMobileMenu: vi.fn(),
+});

package/src/core/hooks/__mocks__/use-theme-hooks.ts

@@ -1,4 +1,6 @@
-import { vi } from 'vitest';
+import { vi, type MockedFunction } from 'vitest';
+
+import type { ThemeHooks } from '../../types/hooks';
 
 export const useThemeHooks = vi.fn(() => ({
   useTranslate: vi.fn(() => ({
@@ -90,4 +92,4 @@ export const useThemeHooks = vi.fn(() => ({
   useLoadAndNavigate: vi.fn(),
   usePageProps: vi.fn().mockReturnValue({}),
   usePageData: vi.fn().mockReturnValue(null),
-}));
+})) as unknown as MockedFunction<() => ThemeHooks>;

package/src/core/hooks/menu/__mocks__/use-mobile-menu-items.ts

@@ -1,6 +1,17 @@
-import { vi } from 'vitest';
+import { vi, type MockedFunction } from 'vitest';
 
-export const useMobileMenuItems = vi.fn().mockReturnValue({
+import type { ResolvedNavItem } from '@redocly/config';
+
+import { MobileMenuType } from '../../../constants/common';
+
+export const useMobileMenuItems: MockedFunction<
+  (menuType: MobileMenuType) => {
+    items: ResolvedNavItem[];
+    popDrilldownState: () => void;
+    pushDrilldownState: (drilldownDetails: unknown) => void;
+    backLink?: { slug?: string; label?: string };
+  }
+> = vi.fn().mockReturnValue({
   items: [
     {
       type: 'group',

package/src/core/openapi/index.ts

@@ -24,6 +24,7 @@ export { useMount } from '../hooks/use-mount';
 export { GlobalStyle } from '../styles/global';
 export { breakpoints } from '../utils/media-css';
 export { isPrimitive } from '../utils/args-typecheck';
+export { getOperationColor } from '../utils/get-operation-color';
 export { ClipboardService } from '../utils/clipboard-service';
 export { getUserAgent } from '../utils/get-user-agent';
 export { useFocusTrap } from '../hooks/use-focus-trap';

package/src/core/types/catalog.ts

@@ -144,6 +144,7 @@ export type BffCatalogRelatedEntity = {
   sourceFile?: string | null;
   /* eslint-disable-next-line @typescript-eslint/no-explicit-any */
   metadata?: Record<string, any>;
+  version?: string | null;
   readonly createdAt: string | null;
   readonly updatedAt: string | null;
 };
@@ -177,6 +178,10 @@ export type BffCatalogEntity = {
   }>;
   sourceFile?: string;
   readonly object: 'catalogEntityView';
+  readonly version?: string | null;
+  readonly revision: string;
+  readonly isCurrent?: boolean | null;
+  readonly isDefaultVersion?: boolean | null;
   readonly createdAt: string;
   readonly updatedAt: string;
 };

package/src/core/types/l10n.ts

@@ -332,6 +332,16 @@ export type TranslationKey =
   | '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'

package/src/core/types/search.ts

@@ -25,6 +25,7 @@ export type SearchHit = {
   httpMethod?: string;
   httpPath?: string | string[];
   deprecated?: boolean;
+  isAdditionalOperation?: boolean;
   security?: string[];
   parameters?: OperationParameter[];
   version?: string;

package/src/core/types/sidebar.ts

@@ -51,6 +51,7 @@ export type ItemState = Omit<SidebarNavItem, 'items'> & {
   languageInsensitive?: boolean;
   modified?: boolean; //item from openapi-docs sidebar
   deprecated?: boolean; //item from openapi-docs sidebar
+  isAdditionalOperation?: boolean; //item from openapi-docs sidebar
 };
 
 export type DrilldownMenuItemDetails = {

package/src/core/utils/get-operation-color.ts

@@ -0,0 +1,18 @@
+type OperationColorProps = {
+  deprecated?: boolean;
+  isAdditionalOperation?: boolean;
+  httpVerb: string;
+};
+
+export function getOperationColor({
+  deprecated,
+  isAdditionalOperation,
+  httpVerb,
+}: OperationColorProps): string {
+  if (deprecated) {
+    return 'http-deprecated';
+  } else if (isAdditionalOperation) {
+    return 'http-additional-operation';
+  }
+  return httpVerb;
+}

package/src/core/utils/index.ts

@@ -39,4 +39,5 @@ export * from './enhanced-smoothstep';
 export * from './icon-resolver';
 export * from './Dynamic';
 export * from './tabs';
+export * from './get-operation-color';
 export * from './frontmatter-translate';

package/src/markdoc/components/Tabs/Tabs.tsx

@@ -28,6 +28,7 @@ type TabsProps = {
   size: TabsSize;
   initialTab?: string;
   forceReady?: boolean;
+  activeTab?: string;
 };
 
 type UseActiveTabFn = (
@@ -47,6 +48,7 @@ type TabsViewProps = Omit<TabsProps, 'children'> & {
   useActiveTab: UseActiveTabFn;
   containerRef: React.RefObject<HTMLUListElement | null>;
   onReadyChange: (ready: boolean) => void;
+  externalActiveTab?: string;
 };
 
 export function Tabs({
@@ -56,6 +58,7 @@ export function Tabs({
   size,
   initialTab: propInitialTab,
   forceReady = false,
+  activeTab: controlledActiveTab,
 }: TabsProps): JSX.Element {
   const childrenArray = React.Children.toArray(children) as React.ReactElement<TabItemProps>[];
   const [isReady, setIsReady] = useState(false);
@@ -88,6 +91,7 @@ export function Tabs({
       labelsHash={labelsHash}
       containerRef={containerRef}
       onReadyChange={handleReadyChange}
+      externalActiveTab={controlledActiveTab}
     />
   );
 }
@@ -103,9 +107,16 @@ function TabsView({
   labelsHash,
   containerRef,
   onReadyChange,
+  externalActiveTab,
 }: TabsViewProps): JSX.Element {
   const { activeTab, setActiveTab } = useActiveTab(initialTab, id, childrenArray);
 
+  useEffect(() => {
+    if (externalActiveTab && externalActiveTab !== activeTab) {
+      setActiveTab(externalActiveTab);
+    }
+  }, [externalActiveTab, activeTab, setActiveTab]);
+
   return (
     <TabsContainer
       data-component-name="Markdoc/Tabs/Tabs"