@rspress-theme-anatole/theme-default 0.7.55 → 0.7.57

package/dist/bundle.js

@@ -324,6 +324,7 @@ function useLocaleSiteData() {
         nextPageText: themeConfig.nextPageText,
         sourceCodeText: themeConfig.sourceCodeText,
         searchPlaceholderText: themeConfig.searchPlaceholderText,
+        searchDidYouMeanText: themeConfig.searchDidYouMeanText,
         searchNoResultsText: themeConfig.searchNoResultsText,
         searchSuggestedQueryText: themeConfig.searchSuggestedQueryText,
         overview: themeConfig.overview
@@ -412,6 +413,13 @@ function markLockedSidebarItems(items, userContext) {
         if ('items' in item && Array.isArray(item.items)) {
             const markedItems = markLockedSidebarItems(item.items, userContext);
             nextItem = { ...nextItem, items: markedItems };
+            // If group has no direct lock but all navigable children are locked, propagate lock upward
+            if (!locked && !nextItem.locked && 'items' in nextItem && nextItem.items.length > 0) {
+                const navigableChildren = nextItem.items.filter(child => child && !('dividerType' in child));
+                if (navigableChildren.length > 0 && navigableChildren.every(child => child.locked === true)) {
+                    nextItem = { ...nextItem, locked: true };
+                }
+            }
         }
         return nextItem;
     }).filter(Boolean);
@@ -6576,11 +6584,37 @@ function SuggestItem({ suggestion, query, closeSearch, isCurrent, setCurrentSugg
         });
     };
 
+    const SUGGESTION_PREFIX_TOKEN = '__KB_SUGGESTION__';
+    const SUGGESTION_SUFFIX_TOKEN = '__KB_SUGGESTION_END__';
+    const parseGatewaySuggestion = (statement) => {
+        if (!statement || 'string' != typeof statement) return {
+            suggestionText: '',
+            statementText: statement || ''
+        };
+        const prefixIndex = statement.indexOf(SUGGESTION_PREFIX_TOKEN);
+        if (prefixIndex < 0) return {
+            suggestionText: '',
+            statementText: statement
+        };
+        const contentStart = prefixIndex + SUGGESTION_PREFIX_TOKEN.length;
+        const suffixIndex = statement.indexOf(SUGGESTION_SUFFIX_TOKEN, contentStart);
+        if (suffixIndex < 0) return {
+            suggestionText: '',
+            statementText: statement
+        };
+        const suggestionText = statement.slice(contentStart, suffixIndex).trim();
+        const statementText = (statement.slice(0, prefixIndex) + ' ' + statement.slice(suffixIndex + SUGGESTION_SUFFIX_TOKEN.length)).trim();
+        return {
+            suggestionText,
+            statementText
+        };
+    };
     const renderStatementMatch = () => {
         if ('content' !== suggestion.type) return (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)("div", {});
+        const parsed = parseGatewaySuggestion(suggestion.statement || '');
         return (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)("div", {
             className: "text-sm text-gray-light w-full",
-            children: getHighlightedFragments(suggestion.statement)
+            children: getHighlightedFragments(parsed.statementText || suggestion.statement || '')
         });
     };
     const renderLink = () => {
@@ -6591,26 +6625,85 @@ function SuggestItem({ suggestion, query, closeSearch, isCurrent, setCurrentSugg
             children: cleanDisplayLink
         });
     };
-    let hitContent = null;
-    switch (suggestion.type) {
-        case 'title':
-        case 'header':
-            hitContent = renderHeaderMatch();
-            break;
-        case 'content':
-            hitContent = (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsxs)(__WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.Fragment, {
-                children: [
-                    renderStatementMatch(),
-                    (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)("p", {
-                        className: Search_index_module.titleForContent,
-                        children: suggestion.title
-                    })
-                ]
-            });
-            break;
-        default:
-            break;
-    }
+    const BREADCRUMB_SKIPPED_SEGMENTS = new Set([
+        'en',
+        'ja',
+        'product-page',
+        'solution-pages',
+        'index',
+        'index.html'
+    ]);
+    const formatBreadcrumbLabel = (segment) => {
+        if (!segment) return '';
+        const raw = decodeURIComponent(segment).replace(/\.html$/i, '').trim();
+        if (!raw) return '';
+        const normalized = raw.toLowerCase();
+        if (BREADCRUMB_SKIPPED_SEGMENTS.has(normalized)) return '';
+        if ('iaas-paas' === normalized) return 'IAAS & PAAS';
+        const words = raw.split(/[-_]+/).filter(Boolean);
+        const acronyms = new Set([
+            'iaas',
+            'paas',
+            'api',
+            'sql',
+            'vm',
+            'sso',
+            'kb',
+            'aws',
+            'gcp'
+        ]);
+        const lowerCaseWords = new Set([
+            'a',
+            'an',
+            'and',
+            'as',
+            'at',
+            'by',
+            'for',
+            'from',
+            'in',
+            'of',
+            'on',
+            'or',
+            'the',
+            'to',
+            'via',
+            'with'
+        ]);
+        return words.map((word, index) => {
+            const lower = word.toLowerCase();
+            if (acronyms.has(lower)) return lower.toUpperCase();
+            if (/^[a-z]+\d+$/i.test(word)) {
+                return lower.charAt(0).toUpperCase() + lower.slice(1);
+            }
+            if (index > 0 && lowerCaseWords.has(lower)) return lower;
+            return lower.charAt(0).toUpperCase() + lower.slice(1);
+        }).join(' ');
+    };
+    const buildBreadcrumbFromLink = () => {
+        const stripHtmlSuffix = (value) => 'string' == typeof value ? value.replace(/\.html(?=$|[?#\s])/gi, '').replace(/\?/g, '').trim() : value;
+        const displayLink = removeDomain(suggestion.link || '');
+        if (!displayLink) return '';
+        const sanitized = displayLink.replace(/([?&])kb_highlight=[^&#]*/g, '$1').replace(/[?&]$/, '');
+        const [pathWithQuery, hashPartRaw] = sanitized.split('#');
+        const pathPart = pathWithQuery.split('?')[0];
+        const pathSegments = pathPart.split('/').filter(Boolean).map(formatBreadcrumbLabel).filter(Boolean);
+        let hashPart = hashPartRaw ? stripHtmlSuffix(formatBreadcrumbLabel(hashPartRaw)) : '';
+        if (hashPartRaw && suggestion.header) {
+            hashPart = stripHtmlSuffix(suggestion.header);
+        }
+        const parts = hashPart ? [...pathSegments, hashPart] : pathSegments;
+        return parts.map(stripHtmlSuffix).join(' > ');
+    };
+    const hitContent = (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsxs)(__WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.Fragment, {
+        children: [
+            renderStatementMatch(),
+            (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)("p", {
+                className: Search_index_module.titleForContent,
+                children: buildBreadcrumbFromLink()
+            })
+        ]
+    });
     return (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)("li", {
         className: `rspress-search-suggest-item ${Search_index_module.suggestItem} ${isCurrent ? Search_index_module.current : ''}`,
         onMouseEnter: setCurrentSuggestionIndex,
@@ -6638,7 +6731,7 @@ function SuggestItem({ suggestion, query, closeSearch, isCurrent, setCurrentSugg
                             (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)("span", {
                                 children: hitContent
                             }),
-                            renderLink()
+                            // renderLink()
                         ]
                     }),
                     (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)("div", {
@@ -6663,7 +6756,10 @@ const SEARCH_PREWARM_EVENT = 'rspress-search-prewarm';
 const useDebounce = (cb) => {
     const cbRef = (0, __WEBPACK_EXTERNAL_MODULE_react__.useRef)(cb);
     cbRef.current = cb;
-    const debounced = (0, __WEBPACK_EXTERNAL_MODULE_react__.useCallback)((0, __WEBPACK_EXTERNAL_MODULE_lodash_es_18c59938__.debounce)((...args) => cbRef.current(...args), 150), []);
+    // 300ms debounce: only fire after the user stops typing for 300ms.
+    const debounced = (0, __WEBPACK_EXTERNAL_MODULE_react__.useCallback)((0, __WEBPACK_EXTERNAL_MODULE_lodash_es_18c59938__.debounce)((...args) => cbRef.current(...args), 300), []);
+    // Cancel any pending debounced call on unmount to prevent stale gateway requests.
+    (0, __WEBPACK_EXTERNAL_MODULE_react__.useEffect)(() => () => debounced.cancel(), [debounced]);
     return debounced;
 };
 function SearchPanel({ focused, setFocused }) {
@@ -6698,7 +6794,7 @@ function SearchPanel({ focused, setFocused }) {
         }
     };
     const { siteData, page: { lang, version, frontmatter, routePath } } = (0, __WEBPACK_EXTERNAL_MODULE__rspress_runtime_0abd3046__.usePageData)();
-    const { searchPlaceholderText = 'Search Docs', scopedSearchPrefixText = 'Search in', searchingText = 'Searching...' } = useLocaleSiteData();
+    const { searchPlaceholderText = 'Search Docs', searchDidYouMeanText = 'Did you mean', scopedSearchPrefixText = 'Search in', searchingText = 'Searching...' } = useLocaleSiteData();
     const { search, title: siteTitle, base } = siteData;
     const versionedSearch = search && 'remote' !== search.mode && search.versioned;
     const DEFAULT_RESULT = [
@@ -6922,37 +7018,16 @@ function SearchPanel({ focused, setFocused }) {
     ]);
     (0, __WEBPACK_EXTERNAL_MODULE_react__.useEffect)(() => {
         if (focused) {
+            // typesense-only focus flow: opening search must not initialize the browser search index.
+            // typesense-only result visibility: mark search ready without PageSearcher init.
+            setInitStatus('inited');
             setSearchResult(DEFAULT_RESULT);
-            initSearch();
         } else setQuery('');
     }, [
         focused
     ]);
     (0, __WEBPACK_EXTERNAL_MODULE_react__.useEffect)(() => {
-        if ('undefined' === typeof window) return;
-        let idleCallbackId;
-        const prewarm = () => {
-            ensureSearcherReady().catch(() => {});
-        };
-        const onPrewarm = () => {
-            prewarm();
-        };
-        window.addEventListener(SEARCH_PREWARM_EVENT, onPrewarm);
-        if (!pageSearcherRef.current) {
-            if ('requestIdleCallback' in window) idleCallbackId = window.requestIdleCallback(() => {
-                prewarm();
-            });
-            else idleCallbackId = window.setTimeout(() => {
-                prewarm();
-            }, 300);
-        }
-        return () => {
-            window.removeEventListener(SEARCH_PREWARM_EVENT, onPrewarm);
-            if (void 0 !== idleCallbackId) {
-                if ('cancelIdleCallback' in window) window.cancelIdleCallback(idleCallbackId);
-                else window.clearTimeout(idleCallbackId);
-            }
-        };
+        // typesense-only prewarm removal: Gateway search does not use PageSearcher indexes.
     }, []);
     (0, __WEBPACK_EXTERNAL_MODULE_react__.useEffect)(() => {
         if (!pageSearcherConfigRef.current) return;
@@ -7115,12 +7190,7 @@ function SearchPanel({ focused, setFocused }) {
 
         if (defaultSearchResult) localResult.push(...defaultSearchResult);
 
-        // Re-run onSearch/afterSearch với local result
-        if ('onSearch' in __WEBPACK_EXTERNAL_MODULE_virtual_search_hooks_9d01d01f__) {
-            const key = 'onSearch';
-            await __WEBPACK_EXTERNAL_MODULE_virtual_search_hooks_9d01d01f__[key](newQuery, localResult, searchScope);
-        }
-
+        // Keep a single onSearch invocation per debounced query.
         if ('afterSearch' in __WEBPACK_EXTERNAL_MODULE_virtual_search_hooks_9d01d01f__) {
             const key = 'afterSearch';
             await __WEBPACK_EXTERNAL_MODULE_virtual_search_hooks_9d01d01f__[key](newQuery, localResult);
@@ -7172,6 +7242,44 @@ function SearchPanel({ focused, setFocused }) {
             }, item.group))
         });
     };
+    const SUGGESTION_PREFIX_TOKEN = '__KB_SUGGESTION__';
+    const SUGGESTION_SUFFIX_TOKEN = '__KB_SUGGESTION_END__';
+    const parseGatewaySuggestion = (statement) => {
+        if (!statement || 'string' != typeof statement) return {
+            suggestionText: '',
+            statementText: statement || ''
+        };
+        const prefixIndex = statement.indexOf(SUGGESTION_PREFIX_TOKEN);
+        if (prefixIndex < 0) return {
+            suggestionText: '',
+            statementText: statement
+        };
+        const contentStart = prefixIndex + SUGGESTION_PREFIX_TOKEN.length;
+        const suffixIndex = statement.indexOf(SUGGESTION_SUFFIX_TOKEN, contentStart);
+        if (suffixIndex < 0) return {
+            suggestionText: '',
+            statementText: statement
+        };
+        const suggestionText = statement.slice(contentStart, suffixIndex).trim();
+        const statementText = (statement.slice(0, prefixIndex) + ' ' + statement.slice(suffixIndex + SUGGESTION_SUFFIX_TOKEN.length)).trim();
+        return {
+            suggestionText,
+            statementText
+        };
+    };
+    const extractSuggestionText = (suggestions) => {
+        for (const item of suggestions || []) {
+            if ('content' !== item?.type) continue;
+            const parsed = parseGatewaySuggestion(item.statement || '');
+            if (parsed.suggestionText) return parsed.suggestionText;
+        }
+        return '';
+    };
+    const getGatewaySuggestionText = () => {
+        if ('undefined' == typeof window) return '';
+        const suggestion = window.__KB_GATEWAY_SUGGESTION__;
+        return 'string' == typeof suggestion ? suggestion.trim() : '';
+    };
     const renderSearchResultItem = (suggestionList, query, isSearching) => {
         if (isSearching) return (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)("div", {
             className: "flex flex-col items-center",
@@ -7189,43 +7297,57 @@ function SearchPanel({ focused, setFocused }) {
         if (0 === suggestionList.length && 'inited' === initStatus) return (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)(NoSearchResult, {
             query: query
         });
+        const suggestionText = getGatewaySuggestionText();
         const normalizedSuggestions = normalizeSuggestions(suggestionList);
         let accumulateIndex = -1;
-        return (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)("ul", {
-            className: Search_index_module.suggestList,
-            children: Object.keys(normalizedSuggestions).map((group) => {
-                const groupSuggestions = normalizedSuggestions[group] || [];
-                return (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)("li", {
-                    children: (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)("ul", {
-                        // className: "pb-2",
-                        children: groupSuggestions.map((suggestion) => {
-                            accumulateIndex++;
-                            const suggestionIndex = accumulateIndex;
-                            return (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)(SuggestItem, {
-                                suggestion: suggestion,
-                                query: query,
-                                isCurrent: suggestionIndex === currentSuggestionIndex,
-                                setCurrentSuggestionIndex: (event) => {
-                                    if (mousePositionRef.current.pageX === event.pageX && mousePositionRef.current.pageY === event.pageY) return;
-                                    setCanScroll(false);
-                                    setCurrentSuggestionIndex(suggestionIndex);
-                                },
-                                onMouseMove: (event) => {
-                                    mousePositionRef.current = {
-                                        pageX: event.pageX,
-                                        pageY: event.pageY
-                                    };
-                                },
-                                closeSearch: () => {
-                                    clearSearchState();
-                                },
-                                inCurrentDocIndex: 0 === resultTabIndex,
-                                scrollTo: scrollTo
-                            }, `${suggestion.title}-${suggestionIndex}`);
-                        })
+        return (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsxs)(__WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.Fragment, {
+            children: [
+                suggestionText ? (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsxs)("p", {
+                    className: "kb-search-suggestion-banner",
+                    children: [
+                        searchDidYouMeanText,
+                        " \"",
+                        suggestionText,
+                        "\"?"
+                    ]
+                }) : null,
+                (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)("ul", {
+                    className: Search_index_module.suggestList,
+                    children: Object.keys(normalizedSuggestions).map((group) => {
+                        const groupSuggestions = normalizedSuggestions[group] || [];
+                        return (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)("li", {
+                            children: (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)("ul", {
+                                // className: "pb-2",
+                                children: groupSuggestions.map((suggestion) => {
+                                    accumulateIndex++;
+                                    const suggestionIndex = accumulateIndex;
+                                    return (0, __WEBPACK_EXTERNAL_MODULE_react_jsx_runtime_225474f2__.jsx)(SuggestItem, {
+                                        suggestion: suggestion,
+                                        query: query,
+                                        isCurrent: suggestionIndex === currentSuggestionIndex,
+                                        setCurrentSuggestionIndex: (event) => {
+                                            if (mousePositionRef.current.pageX === event.pageX && mousePositionRef.current.pageY === event.pageY) return;
+                                            setCanScroll(false);
+                                            setCurrentSuggestionIndex(suggestionIndex);
+                                        },
+                                        onMouseMove: (event) => {
+                                            mousePositionRef.current = {
+                                                pageX: event.pageX,
+                                                pageY: event.pageY
+                                            };
+                                        },
+                                        closeSearch: () => {
+                                            clearSearchState();
+                                        },
+                                        inCurrentDocIndex: 0 === resultTabIndex,
+                                        scrollTo: scrollTo
+                                    }, `${suggestion.title}-${suggestionIndex}`);
+                                })
+                            })
+                        }, group);
                     })
-                }, group);
-            })
+                })
+            ]
         });
     };
     const getScopedPlaceholder = () => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rspress-theme-anatole/theme-default",
   "author": "Anatole Tong",
-  "version": "0.7.55",
+  "version": "0.7.57",
   "license": "MIT",
   "sideEffects": [
     "*.css",
@@ -21,8 +21,8 @@
   "types": "./dist/bundle.d.ts",
   "dependencies": {
     "@mdx-js/react": "2.3.0",
-    "@rspress-theme-anatole/rspress-plugin-mermaid": "0.7.55",
-    "@rspress-theme-anatole/shared": "0.7.55",
+    "@rspress-theme-anatole/rspress-plugin-mermaid": "0.7.57",
+    "@rspress-theme-anatole/shared": "0.7.57",
     "@rspress/runtime": "1.43.8",
     "body-scroll-lock": "4.0.0-beta.0",
     "copy-to-clipboard": "^3.3.3",