@easyops-cn/docusaurus-search-local 0.52.0 → 0.52.2

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [0.52.2](https://github.com/easyops-cn/docusaurus-search-local/compare/v0.52.1...v0.52.2) (2025-12-01)
+
+
+### Bug Fixes
+
+* wrap SearchBar with DocsPreferredVersionContextProvider for Docusaurus 3.9+ compatibility ([5aedc2e](https://github.com/easyops-cn/docusaurus-search-local/commit/5aedc2e7c4f2672d90d793d1a13e75bb5386e15b))
+* wrap SearchBar with DocsPreferredVersionContextProvider for Docusaurus 3.9+ compatibility ([1b4f011](https://github.com/easyops-cn/docusaurus-search-local/commit/1b4f01139be07ba7cfa502db01aef61dd5e97929))
+
+## [0.52.1](https://github.com/easyops-cn/docusaurus-search-local/compare/v0.52.0...v0.52.1) (2025-07-22)
+
+
+### Bug Fixes
+
+* Fix non-deterministic search-index.json generation ([964f84a](https://github.com/easyops-cn/docusaurus-search-local/commit/964f84a32e7e683e4e557688764690dbc04d1b87))
+
 ## [0.52.0](https://github.com/easyops-cn/docusaurus-search-local/compare/v0.51.1...v0.52.0) (2025-07-16)
 
 

package/dist/client/client/theme/SearchBar/index.jsx

@@ -0,0 +1,9 @@
+import React from "react";
+import "../../utils/proxiedGenerated";
+import SearchBar from "./SearchBar";
+import { DocsPreferredVersionContextProvider } from "@docusaurus/plugin-content-docs/client";
+export default function SearchBarWrapper(props) {
+    return (<DocsPreferredVersionContextProvider>
+      <SearchBar {...props}/>
+    </DocsPreferredVersionContextProvider>);
+}

package/dist/server/server/utils/postBuildFactory.js

@@ -66,7 +66,7 @@ function postBuildFactory(config, searchIndexFilename) {
                 else {
                     docsByDirMap.set("", allDocuments);
                 }
-                for (const [k, allDocs] of docsByDirMap) {
+                for (const [k, allDocs] of Array.from(docsByDirMap.entries()).sort(([a], [b]) => a.localeCompare(b))) {
                     const searchIndex = (0, buildIndex_1.buildIndex)(allDocs, config);
                     (0, debug_1.debugInfo)(`writing index (/${k}) to disk`);
                     yield writeFileAsync(path_1.default.join(versionData.outDir, searchIndexFilename.replace("{dir}", k === "" ? "" : `-${k.replace(/\//g, "-")}`)), JSON.stringify(searchIndex), { encoding: "utf8" });

package/dist/server/server/utils/processDocInfos.js

@@ -36,8 +36,10 @@ function processDocInfos({ routesPaths, outDir, baseUrl, siteConfig, plugins },
     }
     // Create a list of files to index per document version. This will always include all pages and blogs.
     const result = [];
-    for (const [versionOutDir, docs] of versionData.entries()) {
-        const versionPaths = routesPaths
+    for (const [versionOutDir, docs] of Array.from(versionData.entries()).sort(([a], [b]) => a.localeCompare(b))) {
+        // Sort routesPaths to ensure deterministic processing order
+        const sortedRoutesPaths = routesPaths.slice().sort();
+        const versionPaths = sortedRoutesPaths
             .map((url) => {
             // istanbul ignore next
             if (!url.startsWith(baseUrl)) {

package/dist/server/server/utils/scanDocuments.js

@@ -26,14 +26,23 @@ function scanDocuments(DocInfoWithFilePathList, config) {
             keywordsDocuments,
             contentDocuments,
         ];
-        yield Promise.all(DocInfoWithFilePathList.map(({ filePath, url, type }) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+        // Process documents in parallel but assign IDs deterministically based on input order
+        const processedDocs = yield Promise.all(DocInfoWithFilePathList.map(({ filePath, url, type }, index) => tslib_1.__awaiter(this, void 0, void 0, function* () {
             (0, debug_1.debugVerbose)(`parsing %s file %o of %o`, type, path_1.default.relative(process.cwd(), filePath), url);
             const html = yield readFileAsync(filePath, { encoding: "utf8" });
             const parsed = (0, parse_1.parse)(html, type, url, config);
             if (!parsed) {
                 // Unlisted content
-                return;
+                return null;
             }
+            return { parsed, url, index };
+        })));
+        // Process results in input order to ensure deterministic ID assignment
+        for (let i = 0; i < processedDocs.length; i++) {
+            const result = processedDocs[i];
+            if (!result)
+                continue;
+            const { parsed, url } = result;
             const { pageTitle, description, keywords, sections, breadcrumb } = parsed;
             const titleId = getNextDocId();
             titleDocuments.push({
@@ -88,7 +97,7 @@ function scanDocuments(DocInfoWithFilePathList, config) {
                     });
                 }
             }
-        })));
+        }
         return allDocuments;
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@easyops-cn/docusaurus-search-local",
-  "version": "0.52.0",
+  "version": "0.52.2",
   "description": "An offline/local search plugin for Docusaurus v3",
   "repository": {
     "type": "git",

package/dist/client/client/theme/SearchBar/index.js

@@ -1,3 +0,0 @@
-import "../../utils/proxiedGenerated";
-import SearchBar from "./SearchBar";
-export default SearchBar;