feat: add suggested questions as plain string arrays

Author: tharropoulos

packages/docsearch-react/src/DocSearch.tsx

@@ -60,6 +60,13 @@ export type DocSearchAskAi = {
    * Typesense conversational model id.
    */
   conversationModelId: string;
+  /**
+   * Static suggested questions shown in Ask AI entry points.
+   *
+   * TODO: Replace this with a Typesense-backed suggestions source instead of
+   * shipping questions directly in frontend config.
+   */
+  suggestedQuestions?: string[];
   /**
    * Collection to query for conversational retrieval.
    * Defaults to `typesenseCollectionName`.

packages/docsearch-react/src/DocSearchModal.tsx

@@ -468,6 +468,14 @@ export function DocSearchModal({
 
   const askAiConfig = askAi ?? null;
   const [askAiState, setAskAiState] = React.useState<AskAiState>('initial');
+  const suggestedQuestions = React.useMemo<SuggestedQuestionHit[]>(() => {
+    const staticQuestions = askAiConfig?.suggestedQuestions ?? [];
+
+    return staticQuestions.map((question, index) => ({
+      objectID: `suggested-question-${index}`,
+      question,
+    })) as SuggestedQuestionHit[];
+  }, [askAiConfig?.suggestedQuestions]);
 
   // Format the `indexes` to be used until `indexName` and `searchParameters` props are fully removed.
   const indexes: DocSearchIndex[] = [];
@@ -1010,7 +1018,7 @@ export function DocSearchModal({
               hasCollections={hasCollections}
               askAiState={askAiState}
               selectAskAiQuestion={handleSelectAskAiQuestion}
-              suggestedQuestions={[]}
+              suggestedQuestions={suggestedQuestions}
               selectSuggestedQuestion={selectSuggestedQuestion}
               onAskAiToggle={onAskAiToggle}
               onNewConversation={handleNewConversation}

packages/docsearch-react/src/Sidepanel/Sidepanel.tsx

@@ -101,9 +101,11 @@ export type SidepanelProps = {
   portalContainer?: DocumentFragment | Element | null;
   /**
    * Enables displaying suggested questions on new conversation screen.
-   * Reserved for a future Typesense-native suggestions source.
+   *
+   * TODO: Replace this with a Typesense-backed suggestions source instead of
+   * shipping questions directly in frontend config.
    */
-  suggestedQuestions?: boolean;
+  suggestedQuestions?: string[];
   /**
    * Translations specific to the Sidepanel panel.
    **/
@@ -181,7 +183,14 @@ function SidepanelInner(
     excludeFields: askAi.excludeFields || 'embedding',
     searchParameters: askAi.searchParameters,
   });
-  const suggestedQuestions: SuggestedQuestionHit[] = [];
+  const suggestedQuestions: SuggestedQuestionHit[] = React.useMemo(() => {
+    const staticQuestions = askAi.suggestedQuestions ?? [];
+
+    return staticQuestions.map((question, index) => ({
+      objectID: `suggested-question-${index}`,
+      question,
+    })) as SuggestedQuestionHit[];
+  }, [askAi.suggestedQuestions]);
 
   const prevStatus = React.useRef(status);