@redocly/theme 0.70.0-next.5 → 0.70.0-next.7

package/lib/components/Search/SearchAiMessage.d.ts

@@ -10,9 +10,10 @@ export type SearchAiMessageProps = {
     messageId?: string;
     feedback?: FeedbackType;
     onFeedbackChange: (messageId: string, feedback: FeedbackType | undefined) => void;
+    /** @deprecated Not used; the message reads its tool calls from `contentSegments`. */
     toolCalls?: ToolCall[];
     contentSegments?: ContentSegment[];
 };
-declare function SearchAiMessageComponent({ role, content, isThinking, resources, className, messageId, feedback, onFeedbackChange, toolCalls, contentSegments, }: SearchAiMessageProps): JSX.Element;
+declare function SearchAiMessageComponent({ role, content, isThinking, resources, className, messageId, feedback, onFeedbackChange, contentSegments, }: SearchAiMessageProps): JSX.Element;
 export declare const SearchAiMessage: React.MemoExoticComponent<typeof SearchAiMessageComponent>;
 export {};

package/lib/components/Search/SearchAiMessage.js

@@ -41,6 +41,7 @@ const react_1 = __importStar(require("react"));
 const styled_components_1 = __importDefault(require("styled-components"));
 const types_1 = require("../../core/types");
 const constants_1 = require("../../core/constants");
+const utils_1 = require("../../core/utils");
 const Link_1 = require("../../components/Link/Link");
 const Tag_1 = require("../../components/Tag/Tag");
 const hooks_1 = require("../../core/hooks");
@@ -50,36 +51,14 @@ const AiStarsIcon_1 = require("../../icons/AiStarsIcon/AiStarsIcon");
 const CheckmarkOutlineIcon_1 = require("../../icons/CheckmarkOutlineIcon/CheckmarkOutlineIcon");
 const SearchAiActionButtons_1 = require("../../components/Search/SearchAiActionButtons");
 const SearchAiNegativeFeedbackForm_1 = require("../../components/Search/SearchAiNegativeFeedbackForm");
+const SearchAiActivity_1 = require("../../components/Search/SearchAiActivity");
+const styles_1 = require("../../core/styles");
 function MarkdownSegment({ text }) {
     const { useMarkdownText } = (0, hooks_1.useThemeHooks)();
     const markdown = useMarkdownText(text);
     return react_1.default.createElement(ResponseText, { as: "div", children: markdown, "data-testid": "response-text" });
 }
-// The codemode `execute` tool passes a human-readable `description` of what its code
-// does; show that instead of a generic "Executing execute..." label.
-function getExecuteDescription(args) {
-    if (args && typeof args === 'object' && 'description' in args) {
-        const { description } = args;
-        if (typeof description === 'string' && description.trim().length > 0) {
-            return description.trim();
-        }
-    }
-    return undefined;
-}
-function getToolCallDisplayText(toolCall) {
-    var _a;
-    if (toolCall.name === types_1.ToolCallName.Execute) {
-        const description = getExecuteDescription(toolCall.args);
-        if (description) {
-            return { inProgressText: description, completedText: description };
-        }
-    }
-    return ((_a = constants_1.TOOL_CALL_DISPLAY_TEXT[toolCall.name]) !== null && _a !== void 0 ? _a : {
-        inProgressText: `Executing ${toolCall.name}...`,
-        completedText: `${toolCall.name} executed`,
-    });
-}
-function SearchAiMessageComponent({ role, content, isThinking, resources, className, messageId, feedback, onFeedbackChange, toolCalls = [], contentSegments = [{ type: 'text', text: content }], }) {
+function SearchAiMessageComponent({ role, content, isThinking, resources, className, messageId, feedback, onFeedbackChange, contentSegments = [{ type: 'text', text: content }], }) {
     var _a;
     const { useTranslate, useTelemetry } = (0, hooks_1.useThemeHooks)();
     const { translate } = useTranslate();
@@ -88,7 +67,8 @@ function SearchAiMessageComponent({ role, content, isThinking, resources, classN
     const hasResources = !isThinking && resources && resources.length > 0;
     const resourcesCount = (_a = resources === null || resources === void 0 ? void 0 : resources.length) !== null && _a !== void 0 ? _a : 0;
     const showSuccessMessage = feedbackSent && feedback;
-    const isLoading = isThinking && content.length === 0 && toolCalls.length === 0;
+    const groupedSegments = (0, utils_1.groupToolCallSegments)(contentSegments, isThinking);
+    const isFullWidth = (0, utils_1.hasToolCallsAndText)(contentSegments);
     const sendFeedbackTelemetry = (feedbackValue, dislikeReason) => {
         if (!messageId)
             return;
@@ -122,17 +102,11 @@ function SearchAiMessageComponent({ role, content, isThinking, resources, classN
     };
     return (react_1.default.createElement(SearchAiMessageWrapper, { "data-component-name": "Search/SearchAiMessage", $role: role, className: className, "data-testid": "search-ai-message" },
         role === constants_1.AiSearchConversationRole.ASSISTANT && (react_1.default.createElement(AiStarsIcon_1.AiStarsIcon, { size: "32px", background: "var(--search-ai-icon-bg-color)", borderRadius: "var(--border-radius-lg)", color: "var(--search-ai-icon-color)", margin: "0 var(--spacing-xs) 0 0" })),
-        react_1.default.createElement(MessageContentWrapper, null, role === constants_1.AiSearchConversationRole.ASSISTANT ? (react_1.default.createElement(react_1.default.Fragment, null,
-            react_1.default.createElement(MessageWrapper, { $role: role },
-                contentSegments.map((segment, index) => {
-                    if (segment.type === 'tool') {
-                        const toolCallCompleted = Boolean(segment.toolCall.result);
-                        const { inProgressText, completedText } = getToolCallDisplayText(segment.toolCall);
-                        const toolCallDisplayText = toolCallCompleted ? completedText : inProgressText;
-                        return (react_1.default.createElement(ToolCallsInfoWrapper, { key: `tool-${index}`, "data-testid": "tool-calls-info" },
-                            react_1.default.createElement(ToolCallInfoItem, null,
-                                react_1.default.createElement(DocumentIcon_1.DocumentIcon, { size: "14px", color: "--search-ai-text-color" }),
-                                react_1.default.createElement(ToolCallText, { $isSearching: !toolCallCompleted }, toolCallDisplayText))));
+        react_1.default.createElement(MessageContentWrapper, { $isFullWidth: isFullWidth }, role === constants_1.AiSearchConversationRole.ASSISTANT ? (react_1.default.createElement(react_1.default.Fragment, null,
+            react_1.default.createElement(MessageWrapper, { $role: role, $isFullWidth: isFullWidth },
+                groupedSegments.map((segment, index) => {
+                    if (segment.type === 'tools') {
+                        return (react_1.default.createElement(ToolCallsActivity, { key: `tools-${index}`, toolCalls: segment.toolCalls, isActive: segment.isActive }));
                     }
                     return react_1.default.createElement(MarkdownSegment, { key: `text-${index}`, text: segment.text });
                 }),
@@ -146,11 +120,7 @@ function SearchAiMessageComponent({ role, content, isThinking, resources, classN
                             translate('search.ai.resourcesFound.resources', 'resources')),
                         react_1.default.createElement(ResourceTagsWrapper, null, resources === null || resources === void 0 ? void 0 : resources.map((resource, index) => (react_1.default.createElement(Link_1.Link, { key: `${resource.url}-${index}`, to: resource.url, target: "_blank" },
                             react_1.default.createElement(ResourceTag, { borderless: true, icon: react_1.default.createElement(DocumentIcon_1.DocumentIcon, { color: "--search-ai-resource-tag-icon-color" }) }, resource.title)))))))),
-                isLoading && (react_1.default.createElement(ThinkingDotsWrapper, { "data-testid": "thinking-dots-wrapper" },
-                    react_1.default.createElement(ThinkingDot, null),
-                    react_1.default.createElement(ThinkingDot, null),
-                    react_1.default.createElement(ThinkingDot, null))),
-                content.length > 0 && (react_1.default.createElement(FeedbackWrapper, null,
+                !isThinking && content.length > 0 && (react_1.default.createElement(FeedbackWrapper, null,
                     react_1.default.createElement(SearchAiActionButtons_1.SearchAiActionButtons, { content: content, feedback: feedback, onFeedback: handleFeedbackClick, disabled: !!feedback })))),
             messageId && feedback === types_1.FeedbackType.Dislike && !showSuccessMessage && (react_1.default.createElement(SearchAiNegativeFeedbackForm_1.SearchAiNegativeFeedbackForm, { messageId: messageId, onClose: (messageId, feedback) => {
                     onFeedbackChange(messageId, feedback);
@@ -171,7 +141,6 @@ function areResourcesEqual(prev, next) {
     });
 }
 exports.SearchAiMessage = (0, react_1.memo)(SearchAiMessageComponent, (prevProps, nextProps) => {
-    var _a, _b;
     return (prevProps.role === nextProps.role &&
         prevProps.content === nextProps.content &&
         prevProps.isThinking === nextProps.isThinking &&
@@ -179,7 +148,6 @@ exports.SearchAiMessage = (0, react_1.memo)(SearchAiMessageComponent, (prevProps
         prevProps.feedback === nextProps.feedback &&
         prevProps.onFeedbackChange === nextProps.onFeedbackChange &&
         areResourcesEqual(prevProps.resources, nextProps.resources) &&
-        ((_a = prevProps.toolCalls) === null || _a === void 0 ? void 0 : _a.length) === ((_b = nextProps.toolCalls) === null || _b === void 0 ? void 0 : _b.length) &&
         prevProps.contentSegments === nextProps.contentSegments);
 });
 const SearchAiMessageWrapper = styled_components_1.default.div `
@@ -192,6 +160,7 @@ const SearchAiMessageWrapper = styled_components_1.default.div `
 const MessageContentWrapper = styled_components_1.default.div `
   display: flex;
   flex-direction: column;
+  flex-grow: ${({ $isFullWidth }) => ($isFullWidth ? 1 : 0)};
   gap: var(--spacing-sm);
   max-width: 80%;
   min-width: 0;
@@ -217,7 +186,7 @@ const MessageWrapper = styled_components_1.default.div `
     ? 'var(--spacing-sm)'
     : 'var(--spacing-sm) var(--spacing-sm) var(--spacing-xs) var(--spacing-sm)'};
   border-radius: var(--border-radius-xl);
-  width: fit-content;
+  width: ${({ $isFullWidth }) => ($isFullWidth ? 'auto' : 'fit-content')};
   max-width: 100%;
   word-wrap: break-word;
   white-space: pre-wrap;
@@ -234,12 +203,14 @@ const ResourcesWrapper = styled_components_1.default.div `
   display: flex;
   flex-direction: column;
   margin: 0;
+  ${styles_1.searchAiAppearAnimation}
 `;
 const FeedbackWrapper = styled_components_1.default.div `
   display: flex;
   flex-direction: row;
   gap: var(--search-ai-feedback-gap);
   margin-top: var(--spacing-sm);
+  ${styles_1.searchAiAppearAnimation}
 `;
 const ResourcesTitle = styled_components_1.default.div `
   font-weight: var(--search-ai-resources-title-font-weight);
@@ -270,41 +241,6 @@ const ResourceTag = (0, styled_components_1.default)(Tag_1.Tag).attrs({ textTran
     max-width: 100%;
   }
 `;
-const ThinkingDotsWrapper = styled_components_1.default.div `
-  display: flex;
-  gap: var(--search-ai-thinking-dots-gap);
-  padding: var(--search-ai-thinking-dots-padding);
-`;
-const ThinkingDot = styled_components_1.default.div `
-  width: var(--search-ai-thinking-dot-size);
-  height: var(--search-ai-thinking-dot-size);
-  border-radius: 50%;
-  background: var(--search-ai-thinking-dot-color);
-  animation: bounce 1.4s infinite ease-in-out;
-
-  &:nth-child(1) {
-    animation-delay: -0.32s;
-  }
-  &:nth-child(2) {
-    animation-delay: -0.16s;
-  }
-  &:nth-child(3) {
-    animation-delay: 0s;
-  }
-
-  @keyframes bounce {
-    0%,
-    80%,
-    100% {
-      opacity: 0.2;
-      transform: scale(0.8);
-    }
-    40% {
-      opacity: 1;
-      transform: scale(1);
-    }
-  }
-`;
 const SuccessMessageWrapper = styled_components_1.default.div `
   max-width: fit-content;
   display: flex;
@@ -319,35 +255,11 @@ const SuccessMessageText = styled_components_1.default.div `
   font-size: var(--font-size-base);
   color: var(--color-success-darker);
 `;
-const ToolCallsInfoWrapper = styled_components_1.default.div `
-  display: flex;
-  flex-direction: column;
-  gap: var(--spacing-xxs);
+const ToolCallsActivity = (0, styled_components_1.default)(SearchAiActivity_1.SearchAiActivity) `
   margin: 0 0 var(--spacing-sm) 0;
-  font-size: var(--font-size-xs);
-  color: var(--search-ai-text-color);
-  opacity: 0.6;
-`;
-const ToolCallInfoItem = styled_components_1.default.div `
-  display: flex;
-  align-items: center;
-  gap: var(--spacing-xxs);
-`;
-const ToolCallText = styled_components_1.default.span `
-  font-weight: var(--font-weight-regular);
 
-  ${({ $isSearching }) => $isSearching &&
-    `
-    animation: pulse 1.5s ease-in-out infinite;
-    
-    @keyframes pulse {
-      0%, 100% {
-        opacity: 1;
-      }
-      50% {
-        opacity: 0.4;
-      }
-    }
-  `}
+  &:last-child {
+    margin-bottom: var(--spacing-xxs);
+  }
 `;
 //# sourceMappingURL=SearchAiMessage.js.map

package/lib/components/Search/SearchDialog.js

@@ -76,6 +76,16 @@ function SearchDialog({ onClose, className, initialMode = 'search', }) {
     const autoSearchDisabled = mode !== 'search';
     const { query, setQuery, filter, setFilter, items, isSearchLoading, facets, groupCounts, setLoadMore, advancedSearch, askAi, groupField, searchError, retrySearch, } = useSearch(product === null || product === void 0 ? void 0 : product.name, autoSearchDisabled);
     const { isFilterOpen, onFilterToggle, onFilterChange, onFilterReset, onFacetReset, onQuickFilterReset, } = (0, hooks_1.useSearchFilter)(filter, setFilter);
+    (0, hooks_1.usePersistedQuickFilter)({
+        filter,
+        setFilter,
+        facets,
+        groupField,
+        query,
+        isSearchLoading,
+        searchError,
+        enabled: initialMode === 'search',
+    });
     const { addSearchHistoryItem } = (0, hooks_1.useRecentSearches)();
     const aiSearch = useAiSearch({ filter: filter, product: product === null || product === void 0 ? void 0 : product.name });
     (0, hooks_1.useModalScrollLock)(true);

package/lib/components/Search/SearchItem.js

@@ -67,14 +67,7 @@ function SearchItem({ onClick, item, className, product, innerRef, }) {
     });
     return (react_1.default.createElement(SearchItemWrapper, { className: className, to: document.url, onClick: onClick, tabIndex: 0, innerRef: (el) => {
             ref.current = el;
-            if (!innerRef)
-                return;
-            if (typeof innerRef === 'function') {
-                innerRef(el);
-            }
-            else {
-                innerRef.current = el;
-            }
+            (0, utils_1.assignRef)(innerRef, el);
         }, "data-component-name": "Search/SearchItem" },
         react_1.default.createElement(SearchItemContent, null,
             react_1.default.createElement(SearchItemHeader, null,

package/lib/components/Search/variables.js

@@ -200,8 +200,21 @@ exports.search = (0, styled_components_1.css) `
   --search-ai-suggestions-title-font-weight: var(--font-weight-light);
   --search-ai-suggestions-text-color: var(--text-color-description);
 
-  --search-ai-thinking-dots-gap: 4px;
-  --search-ai-thinking-dots-padding: 4px 0;
+  --search-ai-activity-font-size: var(--font-size-base);
+  --search-ai-activity-line-height: var(--line-height-sm);
+  --search-ai-activity-count-font-size: var(--font-size-sm);
+  --search-ai-activity-count-bg-color: var(--border-color-secondary);
+  --search-ai-activity-text-color: var(--text-color-description);
+  --search-ai-activity-text-color-hover: var(--text-color-primary);
+  --search-ai-activity-detail-color: var(--text-color-secondary);
+  --search-ai-activity-shimmer-color: var(--text-color-primary);
+  --search-ai-activity-rail-color: var(--border-color-primary);
+  --search-ai-activity-icon-size: 14px;
+  --search-ai-activity-fade-duration: 200ms;
+  --search-ai-activity-expand-duration: 250ms;
+  --search-ai-activity-shimmer-duration: 2s;
+  --search-ai-activity-easing: cubic-bezier(0.32, 0.72, 0, 1);
+
   --search-ai-thinking-dot-size: 6px;
   --search-ai-thinking-dot-color: var(--search-ai-gradient);
 

package/lib/components/Select/SelectInput.js

@@ -43,6 +43,7 @@ const react_1 = __importStar(require("react"));
 const Tag_1 = require("../../components/Tag/Tag");
 const CloseIcon_1 = require("../../icons/CloseIcon/CloseIcon");
 const Button_1 = require("../../components/Button/Button");
+const utils_1 = require("../../core/utils");
 function SelectInput(props) {
     const { id, listboxId, onlyIcon, icon, customIcon, selectedOptions, placeholder, stickyValue, multiple, searchable, expanded, clearable, clearHandler, searchHandler, clickHandler, searchValue, inputBlurHandler, inputFocusHandler, inputRef: forwardedInputRef, } = props;
     const inputRef = (0, react_1.useRef)(null);
@@ -87,14 +88,7 @@ function SelectInput(props) {
             if (!input)
                 return;
             inputRef.current = input;
-            if (!forwardedInputRef)
-                return;
-            if (typeof forwardedInputRef === 'function') {
-                forwardedInputRef(input);
-            }
-            else {
-                forwardedInputRef.current = input;
-            }
+            (0, utils_1.assignRef)(forwardedInputRef, input);
         }, $width: multiple ? (!searchValue && selectedOptions.length ? '10px' : 'auto') : '100%', tabIndex: 0, role: "combobox", "aria-expanded": !!expanded, "aria-controls": listboxId, "aria-autocomplete": "list", "aria-label": "Select option", onFocus: (e) => {
             e.stopPropagation();
         }, onMouseDown: (e) => {

package/lib/components/SplitButton/SplitButton.js

@@ -1,10 +1,43 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SplitButton = SplitButton;
-const react_1 = __importDefault(require("react"));
+const react_1 = __importStar(require("react"));
 const styled_components_1 = __importDefault(require("styled-components"));
 const Button_1 = require("../../components/Button/Button");
 const ButtonGroup_1 = require("../../components/Button/ButtonGroup");
@@ -12,10 +45,11 @@ const Dropdown_1 = require("../../components/Dropdown/Dropdown");
 function SplitButton(props) {
     const { button, children, variant, size, tone, placement = 'bottom', alignment = 'end', portalled, closeOnSelect = true, disabled, toggleAriaLabel, onOpen, onClose, className, } = props;
     const hasMenu = typeof children === 'function' || react_1.default.Children.toArray(children).length > 0;
-    return (react_1.default.createElement(SplitButtonWrapper, { "data-component-name": "SplitButton/SplitButton", className: className },
+    const wrapperRef = (0, react_1.useRef)(null);
+    return (react_1.default.createElement(SplitButtonWrapper, { "data-component-name": "SplitButton/SplitButton", className: className, ref: wrapperRef },
         react_1.default.createElement(ButtonGroup_1.ButtonGroup, { variant: variant, size: size },
             button,
-            hasMenu ? (react_1.default.createElement(ToggleDropdown, { closeOnClick: closeOnSelect, placement: placement, alignment: alignment, portalled: portalled, withArrow: true, onOpen: onOpen, onClose: onClose, trigger: react_1.default.createElement(Button_1.Button, { "aria-label": toggleAriaLabel, "aria-haspopup": "menu", variant: variant, size: size, tone: tone, disabled: disabled }) }, children)) : null)));
+            hasMenu ? (react_1.default.createElement(ToggleDropdown, { closeOnClick: closeOnSelect, placement: placement, alignment: alignment, portalled: portalled, alignmentAnchorRef: wrapperRef, withArrow: true, onOpen: onOpen, onClose: onClose, trigger: react_1.default.createElement(Button_1.Button, { "aria-label": toggleAriaLabel, "aria-haspopup": "menu", variant: variant, size: size, tone: tone, disabled: disabled }) }, children)) : null)));
 }
 const SplitButtonWrapper = styled_components_1.default.div `
   position: relative;

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

@@ -1,5 +1,5 @@
-import type { MCPOption } from '../types/mcp';
 export declare const DEFAULT_MCP_SERVER_NAME = "mcp-server";
 export declare const MCP_ROUTE = "/mcp";
 export declare const PUBLIC_MCP_ROUTE = "/mcp-public";
-export declare const DEFAULT_MCP_OPTIONS: MCPOption[];
+export declare const MCP_OPTIONS: readonly ['cursor', 'vscode', 'claude-code', 'codex', 'copy'];
+export declare const DEFAULT_MCP_OPTIONS: ("claude-code" | "codex" | "copy" | "cursor" | "vscode")[];

package/lib/core/constants/mcp.js

@@ -1,14 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_MCP_OPTIONS = exports.PUBLIC_MCP_ROUTE = exports.MCP_ROUTE = exports.DEFAULT_MCP_SERVER_NAME = void 0;
+exports.DEFAULT_MCP_OPTIONS = exports.MCP_OPTIONS = exports.PUBLIC_MCP_ROUTE = exports.MCP_ROUTE = exports.DEFAULT_MCP_SERVER_NAME = void 0;
 exports.DEFAULT_MCP_SERVER_NAME = 'mcp-server';
 exports.MCP_ROUTE = '/mcp';
 exports.PUBLIC_MCP_ROUTE = '/mcp-public';
-exports.DEFAULT_MCP_OPTIONS = [
-    'cursor',
-    'vscode',
-    'claude-code',
-    'codex',
-    'copy',
-];
+exports.MCP_OPTIONS = ['cursor', 'vscode', 'claude-code', 'codex', 'copy'];
+exports.DEFAULT_MCP_OPTIONS = [...exports.MCP_OPTIONS];
 //# sourceMappingURL=mcp.js.map

package/lib/core/constants/search.js

@@ -43,7 +43,7 @@ exports.DEFAULT_KEYBOARD_SHORTCUTS = '⌘+K,CTRL+K';
 exports.TOOL_CALL_DISPLAY_TEXT = {
     [search_1.ToolCallName.SearchDocumentation]: {
         inProgressText: 'Searching documentation...',
-        completedText: 'Search completed',
+        completedText: 'Searched the documentation',
     },
     [search_1.ToolCallName.ListApis]: {
         inProgressText: 'Browsing APIs...',
@@ -65,6 +65,10 @@ exports.TOOL_CALL_DISPLAY_TEXT = {
         inProgressText: 'Reading API description...',
         completedText: 'Read API description',
     },
+    [search_1.ToolCallName.Execute]: {
+        inProgressText: 'Running code...',
+        completedText: 'Ran code',
+    },
     [search_1.ToolCallName.DescribeTools]: {
         inProgressText: 'Discovering available tools...',
         completedText: 'Discovered available tools',

package/lib/core/contexts/PortalContainerContext.d.ts

@@ -0,0 +1,2 @@
+/** Where theme portals mount; set it inside a shadow root (the AI assistant web component), else `document.body`. */
+export declare const PortalContainerContext: import("react").Context<HTMLElement | null>;

package/lib/core/contexts/PortalContainerContext.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PortalContainerContext = void 0;
+const react_1 = require("react");
+/** Where theme portals mount; set it inside a shadow root (the AI assistant web component), else `document.body`. */
+exports.PortalContainerContext = (0, react_1.createContext)(null);
+//# sourceMappingURL=PortalContainerContext.js.map

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

@@ -30,6 +30,8 @@ export * from './use-product-picker';
 export * from './search/use-search-dialog';
 export * from './search/use-search-filter';
 export * from './search/use-feedback-tooltip';
+export * from './search/use-search-ai-activity';
+export * from './search/use-persisted-quick-filter';
 export * from './use-controlled-state';
 export * from './use-codeblock-tabs-controls';
 export * from './code-walkthrough/use-code-walkthrough';

package/lib/core/hooks/index.js

@@ -46,6 +46,8 @@ __exportStar(require("./use-product-picker"), exports);
 __exportStar(require("./search/use-search-dialog"), exports);
 __exportStar(require("./search/use-search-filter"), exports);
 __exportStar(require("./search/use-feedback-tooltip"), exports);
+__exportStar(require("./search/use-search-ai-activity"), exports);
+__exportStar(require("./search/use-persisted-quick-filter"), exports);
 __exportStar(require("./use-controlled-state"), exports);
 __exportStar(require("./use-codeblock-tabs-controls"), exports);
 __exportStar(require("./code-walkthrough/use-code-walkthrough"), exports);

package/lib/core/hooks/menu/use-collapse.js

@@ -169,6 +169,6 @@ function useEvent(callback) {
     (0, react_1.useEffect)(() => {
         ref.current = callback;
     });
-    return (0, react_1.useCallback)(((...args) => { var _a; return (_a = ref.current) === null || _a === void 0 ? void 0 : _a.call(ref, ...args); }), []);
+    return (0, react_1.useCallback)((...args) => { var _a; return (_a = ref.current) === null || _a === void 0 ? void 0 : _a.call(ref, ...args); }, []);
 }
 //# sourceMappingURL=use-collapse.js.map

package/lib/core/hooks/search/use-persisted-quick-filter.d.ts

@@ -0,0 +1,21 @@
+import type { Dispatch, SetStateAction } from 'react';
+import type { SearchFacet, SearchFilterItem } from '../../types/search';
+type UsePersistedQuickFilterOptions = {
+    filter: SearchFilterItem[];
+    setFilter: Dispatch<SetStateAction<SearchFilterItem[]>>;
+    facets: SearchFacet[];
+    groupField: string;
+    query: string;
+    isSearchLoading: boolean;
+    searchError: string | null;
+    enabled?: boolean;
+};
+/**
+ * Remembers the quick filter on `groupField` for the browser tab and restores it on mount unless
+ * one is already selected. Restored values are dropped once known not to exist: absent from the
+ * full value list, or from the `groupField` facet left by the first search that finishes without
+ * error on an empty query (the restored value is that search's filter, so a value without
+ * documents is not counted). Does nothing while `enabled` is false.
+ */
+export declare function usePersistedQuickFilter({ filter, setFilter, facets, groupField, query, isSearchLoading, searchError, enabled, }: UsePersistedQuickFilterOptions): void;
+export {};

package/lib/core/hooks/search/use-persisted-quick-filter.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePersistedQuickFilter = usePersistedQuickFilter;
+const react_1 = require("react");
+const use_store_1 = require("../use-store");
+const quickFilterStore = (0, use_store_1.createStore)({
+    storageKey: 'searchQuickFilter',
+    storageType: 'sessionStorage',
+});
+const findQuickFilter = (filter) => filter.find((item) => item.isQuickFilter);
+const withQuickFilter = (filter, quickFilter) => [
+    ...filter.filter((item) => !item.isQuickFilter),
+    ...(quickFilter.values.length ? [Object.assign(Object.assign({}, quickFilter), { isQuickFilter: true })] : []),
+];
+const groupFacetValues = (facets, field) => {
+    var _a;
+    const facet = facets.find((item) => item.field === field);
+    const values = (_a = facet === null || facet === void 0 ? void 0 : facet.values) !== null && _a !== void 0 ? _a : [];
+    return {
+        present: facet !== undefined,
+        values: values.map((item) => (typeof item === 'string' ? item : item.value)),
+        counted: values.some((item) => typeof item !== 'string' && item.isCounterVisible),
+    };
+};
+const isRestorable = (stored, groupField) => !!stored &&
+    stored.field === groupField &&
+    Array.isArray(stored.values) &&
+    stored.values.length > 0 &&
+    stored.values.every((value) => typeof value === 'string');
+/**
+ * Remembers the quick filter on `groupField` for the browser tab and restores it on mount unless
+ * one is already selected. Restored values are dropped once known not to exist: absent from the
+ * full value list, or from the `groupField` facet left by the first search that finishes without
+ * error on an empty query (the restored value is that search's filter, so a value without
+ * documents is not counted). Does nothing while `enabled` is false.
+ */
+function usePersistedQuickFilter({ filter, setFilter, facets, groupField, query, isSearchLoading, searchError, enabled = true, }) {
+    const [stored, setStored] = (0, use_store_1.useStore)(quickFilterStore, null);
+    const [initial] = (0, react_1.useState)(() => enabled && isRestorable(stored, groupField) && !findQuickFilter(filter) ? stored.values : null);
+    const phaseRef = (0, react_1.useRef)(initial ? 'restoring' : 'done');
+    const searchedRef = (0, react_1.useRef)(false);
+    (0, react_1.useEffect)(() => {
+        if (!initial)
+            return;
+        // oxlint-disable-next-line react-you-might-not-need-an-effect/no-pass-data-to-parent -- the filter state belongs to the product's `useSearch` and starts empty on every mount
+        setFilter((current) => withQuickFilter(current, { field: groupField, values: initial }));
+        // eslint-disable-next-line react-hooks/exhaustive-deps -- applies only to the initial state
+    }, []);
+    (0, react_1.useEffect)(() => {
+        if (!enabled)
+            return;
+        const quickFilter = findQuickFilter(filter);
+        // The commit that starts the restore still sees the empty initial filter.
+        if (phaseRef.current === 'restoring') {
+            if (!quickFilter)
+                return;
+            phaseRef.current = 'validating';
+        }
+        if (phaseRef.current === 'validating' && initial) {
+            if (isSearchLoading)
+                searchedRef.current = true;
+            const settled = searchedRef.current && !isSearchLoading && !searchError && !query.trim();
+            const { present, values: known, counted } = groupFacetValues(facets, groupField);
+            if ((known.length && !counted) || (settled && present)) {
+                phaseRef.current = 'done';
+                const values = quickFilter === null || quickFilter === void 0 ? void 0 : quickFilter.values.filter((value) => known.includes(value) || !initial.includes(value));
+                if (quickFilter && values && values.length !== quickFilter.values.length) {
+                    // oxlint-disable-next-line react-you-might-not-need-an-effect/no-pass-data-to-parent -- the facets arrive after the restore
+                    setFilter((current) => withQuickFilter(current, { field: groupField, values }));
+                    return;
+                }
+            }
+        }
+        const next = quickFilter ? { field: quickFilter.field, values: quickFilter.values } : null;
+        if (JSON.stringify(next) !== JSON.stringify(stored)) {
+            setStored(next);
+        }
+    }, [
+        enabled,
+        filter,
+        facets,
+        groupField,
+        query,
+        isSearchLoading,
+        searchError,
+        initial,
+        stored,
+        setFilter,
+        setStored,
+    ]);
+}
+//# sourceMappingURL=use-persisted-quick-filter.js.map

package/lib/core/hooks/search/use-search-ai-activity.d.ts

@@ -0,0 +1,11 @@
+import type { SearchAiActivityStatus, SearchAiActivityStep, ToolCall } from '../../types/search';
+type UseSearchAiActivityParams = {
+    toolCalls: ToolCall[];
+    isActive: boolean;
+};
+type UseSearchAiActivityReturn = {
+    status: SearchAiActivityStatus;
+    steps: SearchAiActivityStep[];
+};
+export declare function useSearchAiActivity({ toolCalls, isActive, }: UseSearchAiActivityParams): UseSearchAiActivityReturn;
+export {};

package/lib/core/hooks/search/use-search-ai-activity.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useSearchAiActivity = useSearchAiActivity;
+const use_theme_hooks_1 = require("../use-theme-hooks");
+const search_ai_activity_1 = require("../../utils/search-ai-activity");
+function useSearchAiActivity({ toolCalls, isActive, }) {
+    const { useTranslate } = (0, use_theme_hooks_1.useThemeHooks)();
+    const { translate } = useTranslate();
+    const runningToolCall = isActive ? toolCalls.find((toolCall) => !toolCall.result) : undefined;
+    return {
+        status: (0, search_ai_activity_1.getSearchAiActivityStatus)(toolCalls, isActive, runningToolCall, translate),
+        steps: toolCalls.map((toolCall) => (0, search_ai_activity_1.getSearchAiActivityStep)(toolCall, isActive && !toolCall.result, translate)),
+    };
+}
+//# sourceMappingURL=use-search-ai-activity.js.map

package/lib/core/hooks/use-connect-mcp-button.js

@@ -45,7 +45,8 @@ function useConnectMCPButton({ options = mcp_1.DEFAULT_MCP_OPTIONS, } = {}) {
         window.open(urlMap[action], '_blank');
     }, [cursorUrl, vscodeUrl, serverUrl, serverName, resetCopied, telemetry]);
     const triggerButtonText = (0, react_1.useMemo)(() => translate('page.actions.connectMcp', 'Connect MCP'), [translate]);
-    const visibleOptions = (0, react_1.useMemo)(() => options.filter(Boolean), [options]);
+    // Markdoc reports attribute errors but still renders the tag, so `options` can be any value.
+    const visibleOptions = (0, react_1.useMemo)(() => Array.isArray(options) ? [...new Set(options.filter(mcp_2.isMCPOption))] : [...mcp_1.DEFAULT_MCP_OPTIONS], [options]);
     return {
         copiedOption,
         cursorUrl,

package/lib/core/hooks/use-full-height.d.ts

@@ -1,2 +1,2 @@
 import type { RefObject } from 'react';
-export declare function useFullHeight(element: RefObject<HTMLElement | null>): void;
+export declare function useFullHeight(elementRef: RefObject<HTMLElement | null>): void;