feat(theme-search-algolia)!: upgrade to DocSearch v5 (AI-assisted)

package.json

@@ -52,7 +52,7 @@
     "format": "oxfmt .",
     "format:website:build": "oxfmt --config .oxfmtrc.website.build.json website/build",
     "format:diff": "oxfmt --list-different .",
-    "lint": "pnpm lint:js && pnpm lint:style && pnpm lint:SPELLING && pnpm lint:syncpack",
+    "lint": "pnpm lint:js && pnpm lint:style && pnpm lint:spelling && pnpm lint:syncpack",
     "lint:ci": "pnpm lint:js --quiet && pnpm lint:style && pnpm lint:spelling && pnpm lint:syncpack",
     "lint:js": "eslint --cache --report-unused-disable-directives \"**/*.{js,jsx,ts,tsx,mjs}\"",
     "lint:js:fix": "pnpm lint:js --fix",

packages/docusaurus-theme-search-algolia/package.json

@@ -34,7 +34,7 @@
   },
   "dependencies": {
     "@algolia/autocomplete-core": "^1.19.8",
-    "@docsearch/react": "^4.6.3",
+    "@docsearch/react": "^5.0.4",
     "@docusaurus/core": "3.10.1",
     "@docusaurus/logger": "3.10.1",
     "@docusaurus/plugin-content-docs": "3.10.1",

packages/docusaurus-theme-search-algolia/src/__tests__/utils.test.ts

@@ -6,7 +6,11 @@
  */
 
 import {describe, expect, it} from 'vitest';
-import {mergeFacetFilters} from '../client/utils';
+import {
+  facetFiltersToFilterString,
+  mergeFacetFilters,
+  mergeFilters,
+} from '../client/utils';
 
 describe('mergeFacetFilters', () => {
   it('merges [string,string]', () => {
@@ -45,4 +49,45 @@ describe('mergeFacetFilters', () => {
       'f4',
     ]);
   });
+
+  it('preserves nested OR groups', () => {
+    expect(mergeFacetFilters([['f1', 'f2']], ['f3', ['f4', 'f5']])).toEqual([
+      ['f1', 'f2'],
+      'f3',
+      ['f4', 'f5'],
+    ]);
+  });
+});
+
+describe('facetFiltersToFilterString', () => {
+  it('converts a single filter to filters syntax', () => {
+    expect(facetFiltersToFilterString('language:en')).toBe('language:"en"');
+  });
+
+  it('joins filters with AND', () => {
+    expect(facetFiltersToFilterString(['language:en', 'version:current'])).toBe(
+      'language:"en" AND version:"current"',
+    );
+  });
+
+  it('groups nested filters with OR', () => {
+    expect(
+      facetFiltersToFilterString([
+        ['language:en', 'language:fr'],
+        'version:current',
+      ]),
+    ).toBe('(language:"en" OR language:"fr") AND version:"current"');
+  });
+});
+
+describe('mergeFilters', () => {
+  it('returns the added filter when no existing filter is configured', () => {
+    expect(mergeFilters(undefined, 'version:current')).toBe('version:current');
+  });
+
+  it('groups and joins existing and added filters with AND', () => {
+    expect(mergeFilters('language:en OR language:fr', 'version:current')).toBe(
+      '(language:en OR language:fr) AND (version:current)',
+    );
+  });
 });