@rspress-theme-anatole/theme-default 0.7.56 → 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 = () => {
@@ -6722,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 }) {
@@ -6757,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 = [
@@ -7153,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);
@@ -7210,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",
@@ -7227,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.56",
+  "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.56",
-    "@rspress-theme-anatole/shared": "0.7.56",
+    "@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",