@redocly/theme 0.70.0-next.1 → 0.70.0-next.11

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

@@ -21,12 +21,17 @@ export * from './menu/use-mobile-menu-levels';
 export * from './menu/use-collapse';
 export * from './feedback/use-report-dialog';
 export * from './use-tabs';
+export * from './use-tab-list';
 export * from './use-focus-trap';
+export * from './use-consent-dialog';
+export * from './use-consent-telemetry';
 export * from './use-language-picker';
 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';
@@ -56,3 +61,7 @@ export * from './use-toast-logic';
 export * from './use-banner-telemetry';
 export * from './use-tooltip-fallback-placement';
 export * from './use-anchor-positioning';
+export * from './use-scroll-item-into-view';
+export * from './use-pointer-border-highlight';
+export * from './prompt/use-prompt-text-limit';
+export * from './prompt/use-prompt-actions';

package/lib/core/hooks/index.js

@@ -37,12 +37,17 @@ __exportStar(require("./menu/use-mobile-menu-levels"), exports);
 __exportStar(require("./menu/use-collapse"), exports);
 __exportStar(require("./feedback/use-report-dialog"), exports);
 __exportStar(require("./use-tabs"), exports);
+__exportStar(require("./use-tab-list"), exports);
 __exportStar(require("./use-focus-trap"), exports);
+__exportStar(require("./use-consent-dialog"), exports);
+__exportStar(require("./use-consent-telemetry"), exports);
 __exportStar(require("./use-language-picker"), exports);
 __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);
@@ -72,4 +77,8 @@ __exportStar(require("./use-toast-logic"), exports);
 __exportStar(require("./use-banner-telemetry"), exports);
 __exportStar(require("./use-tooltip-fallback-placement"), exports);
 __exportStar(require("./use-anchor-positioning"), exports);
+__exportStar(require("./use-scroll-item-into-view"), exports);
+__exportStar(require("./use-pointer-border-highlight"), exports);
+__exportStar(require("./prompt/use-prompt-text-limit"), exports);
+__exportStar(require("./prompt/use-prompt-actions"), exports);
 //# sourceMappingURL=index.js.map

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/menu/use-mobile-menu-items.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useMobileMenuItems = void 0;
+const react_1 = require("react");
 const react_router_1 = require("react-router");
 const use_theme_hooks_1 = require("../use-theme-hooks");
 const use_theme_config_1 = require("../use-theme-config");
@@ -10,73 +11,96 @@ const MENU_SEPARATOR = {
     type: 'separator',
     separatorLine: true,
 };
+const NO_VERSIONS = [];
+const NO_NAV_ITEMS = [];
 const useMobileMenuItems = (menuType) => {
-    var _a, _b, _c;
-    const { useTranslate, useL10nConfig, useCurrentProduct, usePageVersions, useSidebarItems } = (0, use_theme_hooks_1.useThemeHooks)();
-    const { versions = [] } = usePageVersions() || {};
+    var _a, _b, _c, _d;
+    var _e, _f, _g;
+    const { useTranslate, useL10nConfig, useCurrentProduct, usePageVersions, useSidebarItems, useNavigationTabs, } = (0, use_theme_hooks_1.useThemeHooks)();
+    const versions = (_e = (_a = usePageVersions()) === null || _a === void 0 ? void 0 : _a.versions) !== null && _e !== void 0 ? _e : NO_VERSIONS;
     const { defaultLocale, currentLocale, locales } = useL10nConfig();
     const { translate } = useTranslate();
     const activeVersion = versions.find((version) => version.active);
     const { currentItems: sidebarItems, pushDrilldownState, popDrilldownState, backLink, } = useSidebarItems(activeVersion);
+    const navigationTabs = useNavigationTabs();
     const location = (0, react_router_1.useLocation)();
     const currentProduct = useCurrentProduct();
-    const hasProductNavbarOverride = (_a = currentProduct === null || currentProduct === void 0 ? void 0 : currentProduct.configOverride) === null || _a === void 0 ? void 0 : _a.navbar;
+    const hasProductNavbarOverride = (_b = currentProduct === null || currentProduct === void 0 ? void 0 : currentProduct.configOverride) === null || _b === void 0 ? void 0 : _b.navbar;
     const productThemeConfig = (0, use_theme_config_1.useThemeConfig)();
     const baseThemeConfig = (0, use_theme_config_1.useThemeConfig)(false);
-    const baseNavItems = (((_b = baseThemeConfig.navbar) === null || _b === void 0 ? void 0 : _b.items) || []);
-    const productNavItems = (hasProductNavbarOverride ? ((_c = productThemeConfig.navbar) === null || _c === void 0 ? void 0 : _c.items) || [] : []);
-    const menuItems = [];
-    if (menuType === common_1.MobileMenuType.PAGE) {
-        if (activeVersion) {
-            // eslint-disable-next-line no-warning-comments
-            // TODO: consider to refactor
-            const versionsSection = (0, menu_1.buildVersionSection)(translate, versions, activeVersion);
-            menuItems.push(...versionsSection);
+    const baseNavItems = ((_f = (_c = baseThemeConfig.navbar) === null || _c === void 0 ? void 0 : _c.items) !== null && _f !== void 0 ? _f : NO_NAV_ITEMS);
+    const productNavItems = (hasProductNavbarOverride ? ((_g = (_d = productThemeConfig.navbar) === null || _d === void 0 ? void 0 : _d.items) !== null && _g !== void 0 ? _g : NO_NAV_ITEMS) : NO_NAV_ITEMS);
+    const products = baseThemeConfig.products;
+    const items = (0, react_1.useMemo)(() => {
+        const menuItems = [];
+        const navigationTabsSelect = menuType === common_1.MobileMenuType.PAGE ? (0, menu_1.buildNavigationTabsSelect)({ navigationTabs }) : undefined;
+        if (menuType === common_1.MobileMenuType.PAGE) {
+            if (activeVersion) {
+                menuItems.push(...(0, menu_1.buildVersionSection)(translate, versions, activeVersion));
+            }
+            if (menuItems.length && sidebarItems.length) {
+                menuItems.push(MENU_SEPARATOR);
+            }
+            menuItems.push(...sidebarItems);
         }
-        if (menuItems.length && sidebarItems.length) {
-            menuItems.push(MENU_SEPARATOR);
-        }
-        menuItems.push(...sidebarItems);
-    }
-    else if (menuType === common_1.MobileMenuType.PRODUCT) {
-        menuItems.push(...productNavItems);
-        if (menuItems.length && baseNavItems.length) {
-            menuItems.push(MENU_SEPARATOR);
-        }
-        if (baseNavItems.length) {
-            menuItems.push(...baseNavItems);
+        else if (menuType === common_1.MobileMenuType.PRODUCT) {
+            menuItems.push(...productNavItems);
+            if (menuItems.length && baseNavItems.length) {
+                menuItems.push(MENU_SEPARATOR);
+            }
+            if (baseNavItems.length) {
+                menuItems.push(...baseNavItems);
+            }
         }
-    }
-    else if (menuType === common_1.MobileMenuType.MAIN_MENU) {
-        const productMenuItems = Object.values(baseThemeConfig.products || {}).map((product) => ({
-            label: product.name,
-            link: product.link,
-            icon: product.icon,
-            type: 'link',
-        }));
-        if (productMenuItems.length) {
-            menuItems.push({
-                type: 'separator',
-                label: translate('mobileMenu.products', 'Products'),
-            });
-            menuItems.push(...productMenuItems);
+        else if (menuType === common_1.MobileMenuType.MAIN_MENU) {
+            const productMenuItems = Object.values(products || {}).map((product) => ({
+                label: product.name,
+                link: product.link,
+                icon: product.icon,
+                type: 'link',
+            }));
+            if (productMenuItems.length) {
+                menuItems.push({
+                    type: 'separator',
+                    label: translate('mobileMenu.products', 'Products'),
+                });
+                menuItems.push(...productMenuItems);
+            }
+            if (menuItems.length && baseNavItems.length) {
+                menuItems.push(MENU_SEPARATOR);
+            }
+            if (baseNavItems.length) {
+                menuItems.push(...baseNavItems);
+            }
         }
-        if (menuItems.length && baseNavItems.length) {
+        const languagesMenu = (0, menu_1.buildLanguagesGroup)(locales, defaultLocale, currentLocale);
+        if (menuItems.length && languagesMenu) {
             menuItems.push(MENU_SEPARATOR);
         }
-        if (baseNavItems.length) {
-            menuItems.push(...baseNavItems);
+        if (languagesMenu) {
+            menuItems.push(languagesMenu);
         }
-    }
-    const languagesMenu = (0, menu_1.buildLanguagesGroup)(locales, defaultLocale, currentLocale);
-    if (menuItems.length && languagesMenu) {
-        menuItems.push(MENU_SEPARATOR);
-    }
-    if (languagesMenu) {
-        menuItems.push(languagesMenu);
-    }
+        return [
+            ...(navigationTabsSelect ? [navigationTabsSelect] : []),
+            ...(0, menu_1.mapNavbarItems)(menuItems, defaultLocale, currentLocale, locales, location),
+        ];
+    }, [
+        menuType,
+        navigationTabs,
+        activeVersion,
+        versions,
+        sidebarItems,
+        productNavItems,
+        baseNavItems,
+        products,
+        translate,
+        locales,
+        defaultLocale,
+        currentLocale,
+        location,
+    ]);
     return {
-        items: (0, menu_1.mapNavbarItems)(menuItems, defaultLocale, currentLocale, locales, location),
+        items,
         popDrilldownState,
         pushDrilldownState,
         backLink,

package/lib/core/hooks/menu/use-mobile-menu-levels.js

@@ -7,31 +7,36 @@ const use_theme_hooks_1 = require("../use-theme-hooks");
 const use_theme_config_1 = require("../use-theme-config");
 const common_1 = require("../../constants/common");
 const useMobileMenuLevels = () => {
-    var _a, _b;
-    const { useTranslate, useCurrentProduct, usePageVersions, useSidebarItems } = (0, use_theme_hooks_1.useThemeHooks)();
+    var _a, _b, _c;
+    const { useTranslate, useCurrentProduct, usePageVersions, useSidebarItems, useNavigationTabs } = (0, use_theme_hooks_1.useThemeHooks)();
     const { versions = [] } = usePageVersions() || {};
     const activeVersion = versions.find((version) => version === null || version === void 0 ? void 0 : version.active);
     const { currentItems: sidebarItems } = useSidebarItems(activeVersion);
+    const navigationTabs = useNavigationTabs();
     const { translate } = useTranslate();
     const currentProduct = useCurrentProduct();
     const productThemeConfig = (0, use_theme_config_1.useThemeConfig)();
+    const baseThemeConfig = (0, use_theme_config_1.useThemeConfig)(false);
     const location = (0, react_router_1.useLocation)();
     const hasProductNavbarOverride = (_a = currentProduct === null || currentProduct === void 0 ? void 0 : currentProduct.configOverride) === null || _a === void 0 ? void 0 : _a.navbar;
     const productNavItems = (hasProductNavbarOverride ? ((_b = productThemeConfig.navbar) === null || _b === void 0 ? void 0 : _b.items) || [] : []);
+    const hasMainMenuItems = Object.values(baseThemeConfig.products || {}).length > 0 ||
+        (((_c = baseThemeConfig.navbar) === null || _c === void 0 ? void 0 : _c.items) || []).length > 0;
     const menuLevels = (0, react_1.useMemo)(() => {
-        const menuLevels = [
-            {
+        const menuLevels = [];
+        if (hasMainMenuItems) {
+            menuLevels.push({
                 label: translate('mobileMenu.mainMenu', 'Main menu'),
                 type: common_1.MobileMenuType.MAIN_MENU,
-            },
-        ];
+            });
+        }
         if (currentProduct && productNavItems.length) {
             menuLevels.push({
                 label: currentProduct.name,
                 type: common_1.MobileMenuType.PRODUCT,
             });
         }
-        if (sidebarItems.length || activeVersion) {
+        if (sidebarItems.length || activeVersion || (navigationTabs === null || navigationTabs === void 0 ? void 0 : navigationTabs.tabs.length)) {
             menuLevels.push({
                 label: translate('mobileMenu.previous', 'Previous'),
                 type: common_1.MobileMenuType.PAGE,

package/lib/core/hooks/prompt/use-prompt-actions.d.ts

@@ -0,0 +1,7 @@
+import type { AiPromptTarget } from '../../types/prompt';
+export type PromptActionHandlers = {
+    reportCopy: () => void;
+    /** Opens the prompt in the AI tool and reports it. */
+    openIn: (target: AiPromptTarget) => void;
+};
+export declare function usePromptActions(prompt: string): PromptActionHandlers;

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

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePromptActions = usePromptActions;
+const use_theme_hooks_1 = require("../use-theme-hooks");
+const get_ai_prompt_link_1 = require("../../utils/get-ai-prompt-link");
+const get_base_data_attributes_1 = require("../../utils/telemetry/get-base-data-attributes");
+function usePromptActions(prompt) {
+    const { useTelemetry } = (0, use_theme_hooks_1.useThemeHooks)();
+    const telemetry = useTelemetry();
+    const tagData = (0, get_base_data_attributes_1.getBaseDataAttributes)('prompt', 'markdocTag');
+    return {
+        reportCopy: () => telemetry.sendPromptTagCopiedMessage([tagData]),
+        openIn: (target) => {
+            telemetry.sendPromptTagOpenedMessage([Object.assign(Object.assign({}, tagData), { target })]);
+            window.open((0, get_ai_prompt_link_1.getAiPromptLink)(target, prompt), '_blank', 'noopener,noreferrer');
+        },
+    };
+}
+//# sourceMappingURL=use-prompt-actions.js.map

package/lib/core/hooks/prompt/use-prompt-text-limit.d.ts

@@ -0,0 +1,19 @@
+import type { RefObject } from 'react';
+export type PromptTextLimit = 'none' | 'oneLine' | 'maxLines';
+export type UsePromptTextLimitParams = {
+    prompt: string;
+    singleLine: boolean;
+    isPromptVisible: boolean;
+};
+export type PromptTextLimitState = {
+    textRef: RefObject<HTMLDivElement | null>;
+    textLimit: PromptTextLimit;
+    isExpanded: boolean;
+    hasHiddenText: boolean;
+    toggleExpanded: () => void;
+};
+/**
+ * Tracks the line limit of the prompt text (one line or the maximum lines) and whether the
+ * reader expanded it. `hasHiddenText` is true only when the limit hides some text.
+ */
+export declare function usePromptTextLimit({ prompt, singleLine, isPromptVisible, }: UsePromptTextLimitParams): PromptTextLimitState;

package/lib/core/hooks/prompt/use-prompt-text-limit.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePromptTextLimit = usePromptTextLimit;
+const react_1 = require("react");
+/**
+ * Tracks the line limit of the prompt text (one line or the maximum lines) and whether the
+ * reader expanded it. `hasHiddenText` is true only when the limit hides some text.
+ */
+function usePromptTextLimit({ prompt, singleLine, isPromptVisible, }) {
+    const textRef = (0, react_1.useRef)(null);
+    const [isExpanded, setIsExpanded] = (0, react_1.useState)(false);
+    const [hasHiddenText, setHasHiddenText] = (0, react_1.useState)(false);
+    /* The text mounts late with hidePrompt and re-wraps on resize, so the observer is
+       attached each time the text (re)appears. */
+    (0, react_1.useLayoutEffect)(() => {
+        const text = textRef.current;
+        if (!text || isExpanded)
+            return;
+        const measure = () => setHasHiddenText(text.scrollHeight > text.clientHeight || text.scrollWidth > text.clientWidth);
+        measure();
+        if (typeof ResizeObserver === 'undefined')
+            return;
+        const observer = new ResizeObserver(measure);
+        observer.observe(text);
+        return () => observer.disconnect();
+    }, [prompt, singleLine, isExpanded, isPromptVisible]);
+    return {
+        textRef,
+        textLimit: isExpanded ? 'none' : singleLine ? 'oneLine' : 'maxLines',
+        isExpanded,
+        hasHiddenText,
+        toggleExpanded: () => setIsExpanded((expanded) => !expanded),
+    };
+}
+//# sourceMappingURL=use-prompt-text-limit.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

@@ -41,11 +41,13 @@ function useConnectMCPButton({ options = mcp_1.DEFAULT_MCP_OPTIONS, } = {}) {
         const urlMap = {
             cursor: cursorUrl,
             vscode: vscodeUrl,
+            claude: (0, mcp_2.generateMCPDeepLink)('claude', connection),
         };
         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-consent-dialog.d.ts

@@ -0,0 +1,12 @@
+import type { RefObject } from 'react';
+import type { ConsentCategory, ConsentCategoryId, UseConsentResult } from '../types/consent';
+export type ConsentDraft = Record<Exclude<ConsentCategoryId, 'necessary'>, boolean>;
+export type UseConsentDialogResult = {
+    draft: ConsentDraft;
+    setCategory: (id: keyof ConsentDraft, value: boolean) => void;
+    dialogRef: RefObject<HTMLDivElement | null>;
+    close: () => void;
+    save: () => void;
+    categories: readonly ConsentCategory[];
+};
+export declare function useConsentDialog(consent: UseConsentResult): UseConsentDialogResult;

package/lib/core/hooks/use-consent-dialog.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useConsentDialog = useConsentDialog;
+const react_1 = require("react");
+const consent_1 = require("../constants/consent");
+const use_focus_trap_1 = require("./use-focus-trap");
+function useConsentDialog(consent) {
+    const [draft, setDraft] = (0, react_1.useState)(() => { var _a, _b; var _c, _d; return ({
+        analytics: (_c = (_a = consent.state) === null || _a === void 0 ? void 0 : _a.analytics) !== null && _c !== void 0 ? _c : consent.mode === 'opt-out',
+        marketing: ((_d = (_b = consent.state) === null || _b === void 0 ? void 0 : _b.marketing) !== null && _d !== void 0 ? _d : consent.mode === 'opt-out') && !consent.gpc,
+    }); });
+    const dialogRef = (0, react_1.useRef)(null);
+    const close = consent.closeDialog;
+    const closeRef = (0, react_1.useRef)(close);
+    closeRef.current = close;
+    (0, react_1.useEffect)(() => {
+        const previous = document.activeElement;
+        const onKeyDown = (event) => {
+            if (event.key === 'Escape')
+                closeRef.current();
+        };
+        document.addEventListener('keydown', onKeyDown);
+        return () => {
+            var _a;
+            document.removeEventListener('keydown', onKeyDown);
+            (_a = previous === null || previous === void 0 ? void 0 : previous.focus) === null || _a === void 0 ? void 0 : _a.call(previous);
+        };
+    }, []);
+    (0, use_focus_trap_1.useFocusTrap)(dialogRef);
+    const setCategory = (id, value) => {
+        setDraft((current) => (Object.assign(Object.assign({}, current), { [id]: value })));
+    };
+    const save = () => consent.save(draft);
+    return { draft, setCategory, dialogRef, close, save, categories: consent_1.CONSENT_CATEGORIES };
+}
+//# sourceMappingURL=use-consent-dialog.js.map

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

@@ -0,0 +1 @@
+export declare function useConsentTelemetry(): void;

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

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useConsentTelemetry = useConsentTelemetry;
+const react_1 = require("react");
+const use_theme_hooks_1 = require("./use-theme-hooks");
+const get_base_data_attributes_1 = require("../utils/telemetry/get-base-data-attributes");
+function isRealmOwned(runtime) {
+    return runtime.region.source !== 'provider';
+}
+function getConsentRuntime() {
+    var _a;
+    if (typeof window === 'undefined')
+        return undefined;
+    return (_a = window.redocly) === null || _a === void 0 ? void 0 : _a.consent;
+}
+// Sends one consent.changed event per visitor choice in the modes Realm owns.
+function useConsentTelemetry() {
+    const { useTelemetry } = (0, use_theme_hooks_1.useThemeHooks)();
+    const telemetry = useTelemetry();
+    const telemetryRef = (0, react_1.useRef)(telemetry);
+    telemetryRef.current = telemetry;
+    (0, react_1.useEffect)(() => {
+        const found = getConsentRuntime();
+        const runtime = found && isRealmOwned(found) ? found : null;
+        if (!runtime)
+            return;
+        return runtime.on('change', (state) => {
+            const choice = state.analytics && state.marketing
+                ? 'accept'
+                : !state.analytics && !state.marketing
+                    ? 'reject'
+                    : 'partial';
+            const { origin, pathname, search, hash } = window.location;
+            const uri = `${origin}${pathname}${search}${hash}`;
+            telemetryRef.current.sendConsentChangedMessage([
+                Object.assign(Object.assign({}, (0, get_base_data_attributes_1.getBaseDataAttributes)('consent', 'consent')), { choice, mode: runtime.mode, configuredMode: runtime.configuredMode, regionSource: runtime.region.source, gpc: runtime.gpc }),
+                (0, get_base_data_attributes_1.getBaseDataAttributes)(uri, 'page', uri),
+            ]);
+        });
+    }, []);
+}
+//# sourceMappingURL=use-consent-telemetry.js.map

package/lib/core/hooks/use-dialog-hotkeys.js

@@ -23,8 +23,10 @@ function useDialogHotKeys(ref, onClose) {
     };
     const onFocusableElementsHandler = () => {
         var _a;
-        const focusableElements = (_a = ref.current) === null || _a === void 0 ? void 0 : _a.querySelectorAll('input, [href], [tabindex]:not([tabindex="-1"])');
-        if (focusableElements && focusableElements.length > 0) {
+        var _b;
+        const focusableElements = Array.from((_b = (_a = ref.current) === null || _a === void 0 ? void 0 : _a.querySelectorAll('input, textarea, select, button, [href], [tabindex]:not([tabindex="-1"])')) !== null && _b !== void 0 ? _b : []).filter((element) => !element.hasAttribute('disabled') &&
+            (typeof element.checkVisibility !== 'function' || element.checkVisibility()));
+        if (focusableElements.length > 0) {
             firstFocusableRef.current = focusableElements[0];
             lastFocusableRef.current = focusableElements[focusableElements.length - 1];
         }

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;