@coveo/quantic 3.28.2-pre.e4e7bfb159 → 3.28.2-pre.eb011b8318

package/docs/out/quantic-docs.json

@@ -1001,7 +1001,7 @@
                         "access": "@api",
                         "description": "<p>A list of fields to fetch with the citations used to generate the answer.</p>",
                         "required": false,
-                        "defaultValue": "`'sfid,sfkbid,sfkavid'`",
+                        "defaultValue": "`'sfid,sfkbid,sfkavid,filetype'`",
                         "type": "string"
                     },
                     {
@@ -1039,6 +1039,15 @@
                         "required": false,
                         "defaultValue": "{250}",
                         "type": "number"
+                    },
+                    {
+                        "name": "disableCitationAnchoring",
+                        "attribute": "disable-citation-anchoring",
+                        "access": "@api",
+                        "description": "<p>Whether to disable citation anchoring.</p>",
+                        "required": false,
+                        "defaultValue": "false",
+                        "type": "boolean"
                     }
                 ]
             },

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

@@ -7,6 +7,7 @@
       aria-label={citationTitle}
       href={hrefValue}
       target="_blank"
+      rel="noopener"
       onmouseenter={handleMouseEnter}
       onmouseleave={handleMouseLeave}
       onclick={handleClick} 

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

@@ -1,4 +1,4 @@
-import {LinkUtils} from 'c/quanticUtils';
+import {LinkUtils, generateTextFragmentUrl} from 'c/quanticUtils';
 import {NavigationMixin} from 'lightning/navigation';
 import {LightningElement, api} from 'lwc';
 
@@ -18,7 +18,7 @@ export default class QuanticCitation extends NavigationMixin(LightningElement) {
   /**
    * The citation item information.
    * @api
-   * @type {{title: string, index: number, text: string, clickUri: string, fields: object}}
+   * @type {{title: string, index: number, text: string, uri: string, clickUri: string, fields: object}}
    */
   @api citation;
   /**
@@ -27,6 +27,13 @@ export default class QuanticCitation extends NavigationMixin(LightningElement) {
    * @type {InteractiveCitation}
    */
   @api interactiveCitation;
+  /**
+   * Whether to disable citation anchoring.
+   * @api
+   * @type {boolean}
+   * @default false
+   */
+  @api disableCitationAnchoring = false;
 
   /** @type {Object} */
   timeout;
@@ -42,6 +49,14 @@ export default class QuanticCitation extends NavigationMixin(LightningElement) {
   isInitialRender = true;
   /** @type {string} */
   salesforceRecordUrl;
+  /** @type {boolean} */
+  isWithTextFragment = false;
+
+  connectedCallback() {
+    const fileType = this.citation?.fields?.filetype;
+    this.isWithTextFragment =
+      !this.disableCitationAnchoring || fileType !== 'html' || !this.text;
+  }
 
   renderedCallback() {
     if (this.isInitialRender) {
@@ -111,7 +126,9 @@ export default class QuanticCitation extends NavigationMixin(LightningElement) {
   }
 
   handleClick(event) {
-    if (this.isSalesforceLink) {
+    // Only apply the Salesforce navigation using the mixin for Salesforce documents and when citation anchoring is disabled.
+    // Otherwise we rely on the default behavior of the browser with a `hrefValue`.
+    if (this.isSalesforceLink && this.disableCitationAnchoring) {
       event.preventDefault();
       this.navigateToSalesforceRecord(event);
     }
@@ -145,10 +162,9 @@ export default class QuanticCitation extends NavigationMixin(LightningElement) {
   }
 
   get hrefValue() {
-    if (this.isSalesforceLink) {
-      return this.salesforceRecordUrl;
-    }
-    return this.clickUri;
+    return this.isWithTextFragment
+      ? generateTextFragmentUrl(this.sourceUri, this.text)
+      : this.sourceUri;
   }
 
   /**
@@ -180,4 +196,10 @@ export default class QuanticCitation extends NavigationMixin(LightningElement) {
   get index() {
     return this.citation?.index;
   }
+
+  get sourceUri() {
+    return this.isSalesforceLink
+      ? this.salesforceRecordUrl
+      : (this.clickUri ?? this.citation?.uri);
+  }
 }

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

@@ -49,6 +49,7 @@ const MAX_VALID_COLLAPSED_HEIGHT = 500;
 const MIN_VALID_COLLAPSED_HEIGHT = 150;
 
 const GENERATED_ANSWER_DATA_KEY = 'coveo-generated-answer-data';
+const DEFAULT_CITATION_FIELDS = ['sfid', 'sfkbid', 'sfkavid', 'filetype'];
 
 /**
  * The `QuanticGeneratedAnswer` component automatically generates an answer using Coveo machine learning models to answer the query executed by the user.
@@ -71,9 +72,9 @@ export default class QuanticGeneratedAnswer extends LightningElement {
    * A list of fields to fetch with the citations used to generate the answer.
    * @api
    * @type {string}
-   * @defaultValue `'sfid,sfkbid,sfkavid'`
+   * @defaultValue `'sfid,sfkbid,sfkavid,filetype'`
    */
-  @api fieldsToIncludeInCitations = 'sfid,sfkbid,sfkavid';
+  @api fieldsToIncludeInCitations = 'sfid,sfkbid,sfkavid,filetype';
   /**
    * Whether the generated answer should be collapsible when it exceeds the maximum height of 250px.
    * @api
@@ -118,6 +119,13 @@ export default class QuanticGeneratedAnswer extends LightningElement {
       this._maxCollapsedHeight = DEFAULT_COLLAPSED_HEIGHT;
     }
   }
+  /**
+   * Whether to disable citation anchoring.
+   * @api
+   * @type {boolean}
+   * @default false
+   */
+  @api disableCitationAnchoring = false;
 
   labels = {
     generatedAnswerForYou,
@@ -530,10 +538,17 @@ export default class QuanticGeneratedAnswer extends LightningElement {
   }
 
   get citationFields() {
-    return this.fieldsToIncludeInCitations
-      ?.split(',')
-      .map((field) => field.trim())
-      .filter((field) => field.length > 0);
+    const userCitationFields =
+      this.fieldsToIncludeInCitations
+        ?.split(',')
+        .map((field) => field.trim())
+        .filter((field) => field.length > 0) || [];
+
+    const combinedCitationFields = [
+      ...DEFAULT_CITATION_FIELDS,
+      ...userCitationFields,
+    ];
+    return [...new Set(combinedCitationFields)];
   }
 
   get shouldShowDisclaimer() {

package/force-app/main/default/lwc/quanticGeneratedAnswer/templates/generatedAnswer.html

@@ -65,6 +65,7 @@
                     data-testid="generated-answer__citations"
                     citations={citations}
                     citation-hover-handler={handleCitationHover}
+                    disable-citation-anchoring={disableCitationAnchoring}
                   ></c-quantic-source-citations>
                 </div>
               </template>

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

@@ -10,6 +10,7 @@
           citation={citation.data}
           interactive-citation={citation.interactiveCitation}
           onquantic__citationhover={citation.handleCitationHover}
+          disable-citation-anchoring={disableCitationAnchoring}
         ></c-quantic-citation>
       </template>
     </ol>

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

@@ -37,6 +37,13 @@ export default class QuanticSourceCitations extends LightningElement {
    * @type {function}
    */
   @api citationHoverHandler;
+  /**
+   * Whether to disable citation anchoring.
+   * @api
+   * @type {boolean}
+   * @default false
+   */
+  @api disableCitationAnchoring = false;
 
   /** @type {AnyHeadless} */
   headless;

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

@@ -0,0 +1,43 @@
+/**
+ * Extracts a text to highlight from a given text.
+ * It tries to extract the first sentence, and if it fails, it returns the first few words.
+ * @param {string} text The text from which to extract the text to highlight.
+ * @returns {string} The extracted text to highlight.
+ */
+export function extractTextToHighlight(text) {
+  const fallbackWordCount = 5;
+
+  const trimmedText = text.trim();
+  if (!trimmedText || typeof trimmedText !== 'string') {
+    return '';
+  }
+
+  const sentenceRegex =
+    /(?<=^|\p{P}\s)\p{P}?\p{Lu}.*?[.!?]+(?=\s+(?:\p{Lu}|\d)|$)/gu;
+  const sentences = trimmedText.match(sentenceRegex);
+
+  if (Array.isArray(sentences) && sentences?.length > 0) {
+    return sentences[0].trim();
+  }
+
+  return trimmedText.split(/\s+/).slice(0, fallbackWordCount).join(' ');
+}
+
+/**
+ * Generates an encoded text fragment URL for the citation.
+ * This URL will highlight the text in the citation if it is an HTML file.
+ * @param {string} uri
+ * @param {string} text
+ * @returns {string}
+ * @example
+ * generateTextFragmentUrl('https://example.com', 'This is a sample text.');
+ * // Returns: 'https://example.com#:~:text=This%20is%20a%20sample%20text.'
+ */
+export function generateTextFragmentUrl(uri, text) {
+  const highlight = extractTextToHighlight(text);
+  const encodedTextFragment = encodeURIComponent(highlight).replace(
+    /-/g,
+    '%2D'
+  );
+  return `${uri}#:~:text=${encodedTextFragment}`;
+}

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

@@ -35,6 +35,7 @@ import pastYear_plural from '@salesforce/label/c.quantic_PastYear_plural';
 export * from './recentQueriesUtils';
 export * from './markdownUtils';
 export * from './facetDependenciesUtils';
+export * from './citationAnchoringUtils';
 
 export class Debouncer {
   _timeout;