add desc to orama

Author: avivkeller

src/generators/orama-db/constants.mjs

@@ -3,4 +3,5 @@
 export const SCHEMA = {
   title: 'string',
   description: 'string',
+  path: 'string',
 };

src/generators/orama-db/index.mjs

@@ -5,6 +5,7 @@ import { persistToFile } from '@orama/plugin-data-persistence/server';
 
 import { SCHEMA } from './constants.mjs';
 import { groupNodesByModule } from '../../utils/generators.mjs';
+import { transformNodeToString } from '../../utils/unist.mjs';
 
 /**
  * Builds a hierarchical title chain based on heading depths
@@ -67,13 +68,16 @@ export default {
 
     // Process all API groups and flatten into a single document array
     const documents = Array.from(apiGroups.values()).flatMap(headings =>
-      headings.map((node, index) => {
+      headings.map((entry, index) => {
         const hierarchicalTitle = buildHierarchicalTitle(headings, index);
+        const paragraph = entry.content.children.find(
+          child => child.type === 'paragraph'
+        );
 
         return {
           title: hierarchicalTitle,
-          // TODO(@avivkeller): Add `description` key.
-          path: `${node.api}.html#${node.slug}`,
+          description: paragraph ? transformNodeToString(paragraph) : undefined,
+          path: `${entry.api}.html#${entry.slug}`,
         };
       })
     );