@coveo/quantic 3.39.1 → 3.41.0

package/force-app/main/default/lwc/quanticGeneratedAnswerThread/quanticGeneratedAnswerThread.js

@@ -0,0 +1,93 @@
+import {LightningElement, api} from 'lwc';
+import showPreviousQuestions_plural from '@salesforce/label/c.quantic_ShowPreviousQuestions_plural';
+import {I18nUtils} from 'c/quanticUtils';
+
+/** @typedef {import("coveo").GeneratedAnswerBase} GeneratedAnswer */
+
+const MIN_ANSWERS_TO_COLLAPSE = 2;
+
+/**
+ * The `QuanticGeneratedAnswerThread` component renders a thread of generated answers, including the initial answer and follow-up answers.
+ * @category Internal
+ * @example
+ * <c-quantic-generated-answer-thread engine-id={engineId} generated-answers={generatedAnswers}></c-quantic-generated-answer-thread>
+ */
+export default class QuanticGeneratedAnswerThread extends LightningElement {
+  /**
+   * The ID of the engine instance the component registers to.
+   * @api
+   * @type {string}
+   */
+  @api engineId;
+
+  /**
+   * The list of generated answers to render in the thread.
+   * @api
+   * @type {GeneratedAnswer[]}
+   */
+  @api
+  get generatedAnswers() {
+    return this._generatedAnswers;
+  }
+  set generatedAnswers(value) {
+    const previous = this._generatedAnswers;
+    this._generatedAnswers = value ?? [];
+    if (previous?.length !== this._generatedAnswers.length) {
+      this._allAnswersDisplayed = false;
+    }
+  }
+
+  /**
+   * Whether to disable citation anchoring.
+   * @api
+   * @type {boolean}
+   * @defaultValue `false`
+   */
+  @api disableCitationAnchoring = false;
+
+  /** @type {boolean} */
+  _allAnswersDisplayed = false;
+  /** @type {GeneratedAnswer[]} */
+  _generatedAnswers = [];
+
+  labels = {
+    showPreviousQuestions_plural,
+  };
+
+  get isSingleAnswer() {
+    return this.generatedAnswers.length === 1;
+  }
+
+  get shouldCollapseOlderAnswers() {
+    return (
+      this.generatedAnswers.length > MIN_ANSWERS_TO_COLLAPSE &&
+      !this._allAnswersDisplayed
+    );
+  }
+
+  get showPreviousQuestionsLabel() {
+    return I18nUtils.format(
+      this.labels.showPreviousQuestions_plural,
+      this.generatedAnswers.length - 1
+    );
+  }
+
+  get previousAnswers() {
+    if (this.shouldCollapseOlderAnswers) {
+      return [];
+    }
+    return this.generatedAnswers.slice(0, -1);
+  }
+
+  get headAnswer() {
+    return this.generatedAnswers[0];
+  }
+
+  get lastAnswer() {
+    return this.generatedAnswers[this.generatedAnswers.length - 1];
+  }
+
+  handleShowAllClick() {
+    this._allAnswersDisplayed = true;
+  }
+}

package/force-app/main/default/lwc/quanticGeneratedAnswerThread/quanticGeneratedAnswerThread.js-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<LightningComponentBundle xmlns="http://soap.sforce.com/2006/04/metadata">
+    <apiVersion>66.0</apiVersion>
+    <isExposed>false</isExposed>
+</LightningComponentBundle>

package/force-app/main/default/lwc/quanticThreadItem/quanticThreadItem.css

@@ -7,10 +7,6 @@
   width: 10px;
 }
 
-.thread-item__line-column {
-  align-items: stretch;
-}
-
 .thread-item__dot {
   height: 8px;
   width: 8px;

package/force-app/main/default/lwc/quanticThreadItem/quanticThreadItem.html

@@ -6,7 +6,7 @@
       >
         <span class={dotClass} data-testid="thread-item-dot"></span>
       </div>
-      <div class="slds-col slds-has-flexi-truncate">
+      <div class="slds-has-flexi-truncate">
         <template lwc:if={disableCollapse}>
           <span class={titleClass} data-testid="thread-item-title-static"
             >{title}</span

package/force-app/main/default/lwc/quanticUtils/__tests__/markdownUtils.test.js

@@ -67,5 +67,43 @@ describe('c/markdownUtils', () => {
       const resultCode = transformMarkdownToHtml(textCode, marked);
       expect(removeLineBreaks(resultCode)).toEqual('<p><code>code</code></p>');
     });
+
+    it('should transform markdown link to HTML <a> with data-answer-inline-link attribute', () => {
+      const text = '[Google](https://google.com)';
+      const result = transformMarkdownToHtml(text, marked);
+      expect(removeLineBreaks(result)).toEqual(
+        '<p><a href="https://google.com" data-answer-inline-link="true">Google</a></p>'
+      );
+    });
+
+    it('should transform markdown link with title to HTML <a> with title attribute', () => {
+      const text = '[Google](https://google.com "Search Engine")';
+      const result = transformMarkdownToHtml(text, marked);
+      expect(removeLineBreaks(result)).toEqual(
+        '<p><a href="https://google.com" title="Search Engine" data-answer-inline-link="true">Google</a></p>'
+      );
+    });
+
+    it('should escape special characters in link href', () => {
+      const text = '[Link](https://example.com?param="value"&other=test)';
+      const result = transformMarkdownToHtml(text, marked);
+      expect(removeLineBreaks(result)).toEqual(
+        '<p><a href="https://example.com?param=&quot;value&quot;&amp;other=test" data-answer-inline-link="true">Link</a></p>'
+      );
+    });
+
+    it('should escape special characters in link title', () => {
+      const text = '[Link](https://example.com "Title with <script> & quotes")';
+      const result = transformMarkdownToHtml(text, marked);
+      expect(removeLineBreaks(result)).toEqual(
+        '<p><a href="https://example.com" title="Title with &amp;lt;script&amp;gt; &amp;amp; quotes" data-answer-inline-link="true">Link</a></p>'
+      );
+    });
+
+    it('should render link text as span when href is missing', () => {
+      const text = '[Link]()';
+      const result = transformMarkdownToHtml(text, marked);
+      expect(removeLineBreaks(result)).toEqual('<p><span>Link</span></p>');
+    });
   });
 });

package/force-app/main/default/lwc/quanticUtils/markdownUtils.js

@@ -117,6 +117,24 @@ const customRenderer = {
   text(text) {
     return completeUnclosedElement(text);
   },
+
+  /**
+   * Custom Marked renderer for links.
+   * @param {string} href The link href.
+   * @param {string} title The link title.
+   * @param {string} text The link text.
+   * @returns {string} The link element to render.
+   */
+  link(href, title, text) {
+    const titleAttribute = title ? ` title="${escapeHtml(title)}"` : '';
+    const safeHref = href ? escapeHtml(href) : '';
+
+    if (!safeHref) {
+      return `<span>${text}</span>`;
+    }
+
+    return `<a href="${safeHref}"${titleAttribute} data-answer-inline-link="true">${text}</a>`;
+  },
 };
 
 /**