feat: normalize search text (#14449)

#### PR Dependency Tree


* **PR #14449** 👈

This tree was auto-generated by
[Charcoal](https://github.com/danerwilliams/charcoal)

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

* **Improvements**
* Search text normalization now applied consistently across doc titles,
search results, and highlights for uniform display formatting.

* **Tests**
* Added comprehensive test coverage for search text normalization
utility.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

packages/frontend/core/src/modules/docs-search/services/docs-search.ts

@@ -6,6 +6,7 @@ import { isEmpty, omit } from 'lodash-es';
 import { map, type Observable, of, switchMap } from 'rxjs';
 import { z } from 'zod';
 
+import { normalizeSearchText } from '../../../utils/normalize-search-text';
 import type { DocsService } from '../../doc/services/docs';
 import type { WorkspaceService } from '../../workspace';
 
@@ -26,24 +27,6 @@ export class DocsSearchService extends Service {
     errorMessage: null,
   } as IndexerSyncState);
 
-  private normalizeHighlight(value?: string | null) {
-    if (!value) {
-      return value ?? '';
-    }
-    try {
-      const parsed = JSON.parse(value);
-      if (Array.isArray(parsed)) {
-        return parsed.join(' ');
-      }
-      if (typeof parsed === 'string') {
-        return parsed;
-      }
-    } catch {
-      // ignore parse errors, return raw value
-    }
-    return value;
-  }
-
   searchTitle$(query: string) {
     return this.indexer
       .search$(
@@ -144,12 +127,12 @@ export class DocsSearchService extends Service {
             const firstMatchFlavour = bucket.hits.nodes[0]?.fields.flavour;
             if (firstMatchFlavour === 'affine:page') {
               // is title match
-              const blockContent = this.normalizeHighlight(
+              const blockContent = normalizeSearchText(
                 bucket.hits.nodes[1]?.highlights.content[0]
               ); // try to get block content
               result.push({
                 docId: bucket.key,
-                title: this.normalizeHighlight(
+                title: normalizeSearchText(
                   bucket.hits.nodes[0].highlights.content[0]
                 ),
                 score: bucket.score,
@@ -169,7 +152,7 @@ export class DocsSearchService extends Service {
                     ? matchedBlockId
                     : matchedBlockId[0],
                 score: bucket.score,
-                blockContent: this.normalizeHighlight(
+                blockContent: normalizeSearchText(
                   bucket.hits.nodes[0]?.highlights.content[0]
                 ),
               });

packages/frontend/core/src/modules/search-menu/services/index.ts

@@ -16,6 +16,7 @@ import { html } from 'lit';
 import { unsafeHTML } from 'lit/directives/unsafe-html.js';
 import { catchError, map, of } from 'rxjs';
 
+import { normalizeSearchText } from '../../../utils/normalize-search-text';
 import type { CollectionMeta, CollectionService } from '../../collection';
 import type { DocDisplayMetaService } from '../../doc-display-meta';
 import type { DocsSearchService } from '../../docs-search';
@@ -185,14 +186,16 @@ export class SearchMenuService extends Service {
               typeof node.fields.docId === 'string'
                 ? node.fields.docId
                 : node.fields.docId[0];
-            const title =
+            const title = normalizeSearchText(
               typeof node.fields.title === 'string'
                 ? node.fields.title
-                : node.fields.title[0];
+                : node.fields.title[0]
+            );
+            const highlights = normalizeSearchText(node.highlights?.title?.[0]);
             return {
               id,
               title,
-              highlights: node.highlights?.title?.[0],
+              highlights: highlights || undefined,
             };
           })
         )