@coveo/atomic 3.27.5-pre.fc44b4ed1e → 3.28.0-pre.05db57fb0d

package/dist/esm/{stencil-link-637c1ac5.js → stencil-link-32a27dfb.js}

@@ -891,4 +891,4 @@ const QueryErrorLink = ({ errorType, i18n, }) => {
 
 export { QueryErrorContainer as Q, QueryErrorIcon as a, QueryErrorTitle as b, QueryErrorDescription as c, QueryErrorShowMore as d, QueryErrorLink as e, QueryErrorDetails as f, getAriaMessageFromErrorType as g, QueryErrorGuard as h };
 
-//# sourceMappingURL=stencil-link-637c1ac5.js.map
+//# sourceMappingURL=stencil-link-32a27dfb.js.map

package/dist/esm/stencil-link-32a27dfb.js.map

@@ -0,0 +1 @@
+{"file":"stencil-link-32a27dfb.js","mappings":"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","names":[],"sources":["src/components/common/query-error/stencil-details.tsx","src/components/common/query-error/stencil-icon.tsx","src/components/common/query-error/stencil-show-more.tsx","src/components/common/query-error/stencil-container.tsx","src/components/common/query-error/utils.ts","src/components/common/query-error/stencil-description.tsx","src/components/common/query-error/stencil-guard.tsx","src/components/common/query-error/stencil-title.tsx","src/components/common/query-error/stencil-link.tsx"],"sourcesContent":["import {FunctionalComponent, h} from '@stencil/core';\n\ninterface QueryErrorDetailsProps {\n  error: unknown;\n  show: boolean;\n}\nexport const QueryErrorDetails: FunctionalComponent<QueryErrorDetailsProps> = ({\n  error,\n  show,\n}) => {\n  if (!show) {\n    return;\n  }\n  return (\n    <pre\n      part=\"error-info\"\n      class=\"border-neutral bg-neutral-light mt-8 rounded border p-3 text-left whitespace-pre-wrap\"\n    >\n      <code>{JSON.stringify(error, null, 2)}</code>\n    </pre>\n  );\n};\n","import {FunctionalComponent, h} from '@stencil/core';\nimport CannotAccess from '../../../images/cannot-access.svg';\nimport Indexing from '../../../images/indexing.svg';\nimport NoConnection from '../../../images/no-connection.svg';\nimport SearchInactive from '../../../images/search-inactive.svg';\nimport SomethingWrong from '../../../images/something-wrong.svg';\nimport {KnownErrorType} from './known-error-types';\n\ninterface QueryErrorIconProps {\n  errorType?: string;\n}\n\nexport const QueryErrorIcon: FunctionalComponent<QueryErrorIconProps> = ({\n  errorType,\n}) => {\n  const getIconFromErrorType = () => {\n    switch (errorType as KnownErrorType) {\n      case 'Disconnected':\n        return NoConnection;\n\n      case 'NoEndpointsException':\n        return Indexing;\n\n      case 'InvalidTokenException':\n        return CannotAccess;\n      case 'OrganizationIsPausedException':\n        return SearchInactive;\n      default:\n        return SomethingWrong;\n    }\n  };\n\n  return (\n    <atomic-icon\n      part=\"icon\"\n      icon={getIconFromErrorType()}\n      class=\"w-1/2 max-w-lg\"\n    ></atomic-icon>\n  );\n};\n","import {FunctionalComponent, h} from '@stencil/core';\nimport {i18n} from 'i18next';\nimport {Button} from '../stencil-button';\nimport {QueryErrorLink} from './stencil-link';\n\ninterface QueryErrorShowMoreProps {\n  onShowMore: () => void;\n  i18n: i18n;\n  link?: typeof QueryErrorLink;\n}\n\nexport const QueryErrorShowMore: FunctionalComponent<\n  QueryErrorShowMoreProps\n> = ({i18n, onShowMore, link}) => {\n  if (link) {\n    return link;\n  }\n  return (\n    <Button\n      part=\"more-info-btn\"\n      style=\"primary\"\n      class=\"mt-8 p-3\"\n      onClick={() => {\n        onShowMore();\n      }}\n      text={i18n.t('more-info')}\n    ></Button>\n  );\n};\n","import {FunctionalComponent, h} from '@stencil/core';\n\nexport const QueryErrorContainer: FunctionalComponent = (_, children) => {\n  return <div class=\"p-8 text-center\">{children}</div>;\n};\n","import {i18n} from 'i18next';\nimport {KnownErrorType} from './known-error-types';\n\nexport const getErrorTitleFromErrorType = (\n  i18n: i18n,\n  organizationId: string,\n  errorType?: string\n) => {\n  switch (errorType as KnownErrorType) {\n    case 'Disconnected':\n      return i18n.t('disconnected');\n    case 'NoEndpointsException':\n      return i18n.t('no-endpoints', {org: organizationId});\n    case 'InvalidTokenException':\n      return i18n.t('cannot-access', {org: organizationId});\n    case 'OrganizationIsPausedException':\n      return i18n.t('organization-is-paused', {org: organizationId});\n    default:\n      return i18n.t('something-went-wrong');\n  }\n};\n\nexport const getErrorDescriptionFromErrorType = (\n  i18n: i18n,\n  organizationId: string,\n  url: string,\n  errorType?: string\n) => {\n  switch (errorType as KnownErrorType) {\n    case 'Disconnected':\n      return i18n.t('check-your-connection', {url});\n    case 'NoEndpointsException':\n      return i18n.t('add-sources');\n    case 'InvalidTokenException':\n      return i18n.t('invalid-token');\n    case 'OrganizationIsPausedException':\n      return i18n.t('organization-will-resume', {\n        org: organizationId,\n      });\n    default:\n      return i18n.t('if-problem-persists');\n  }\n};\n\nexport const getAriaMessageFromErrorType = (\n  i18n: i18n,\n  organizationId: string,\n  platformUrl: string,\n  errorType?: string\n) => {\n  return `${getErrorTitleFromErrorType(i18n, organizationId, errorType)} ${getErrorDescriptionFromErrorType(i18n, organizationId, platformUrl, errorType)}`;\n};\n","import {FunctionalComponent, h} from '@stencil/core';\nimport {i18n} from 'i18next';\nimport {getErrorDescriptionFromErrorType} from './utils';\n\ninterface QueryErrorDescriptionProps {\n  errorType?: string;\n  i18n: i18n;\n  url: string;\n  organizationId: string;\n}\n\nexport const QueryErrorDescription: FunctionalComponent<\n  QueryErrorDescriptionProps\n> = ({errorType, i18n, url, organizationId}) => {\n  return (\n    <p part=\"description\" class=\"text-neutral-dark mt-2.5 text-lg\">\n      {getErrorDescriptionFromErrorType(i18n, organizationId, url, errorType)}\n    </p>\n  );\n};\n","import {Fragment, FunctionalComponent, h} from '@stencil/core';\n\ninterface QueryErrorGuardProps {\n  hasError: boolean;\n}\n\n// Replace with the when directive\nexport const QueryErrorGuard: FunctionalComponent<QueryErrorGuardProps> = (\n  {hasError},\n  children\n) => {\n  if (!hasError) {\n    return;\n  }\n\n  return <Fragment>{children}</Fragment>;\n};\n","import {FunctionalComponent, h} from '@stencil/core';\nimport {i18n} from 'i18next';\nimport {getErrorTitleFromErrorType} from './utils';\n\ninterface QueryErrorTitleProps {\n  errorType?: string;\n  i18n: i18n;\n  organizationId: string;\n}\n\nexport const QueryErrorTitle: FunctionalComponent<QueryErrorTitleProps> = ({\n  errorType,\n  i18n,\n  organizationId,\n}) => {\n  return (\n    <p part=\"title\" class=\"text-on-background mt-8 text-2xl\">\n      {getErrorTitleFromErrorType(i18n, organizationId, errorType)}\n    </p>\n  );\n};\n","import {FunctionalComponent, h} from '@stencil/core';\nimport {i18n} from 'i18next';\nimport {KnownErrorType} from './known-error-types';\n\ninterface QueryErrorLinkProps {\n  errorType?: string;\n  i18n: i18n;\n}\n\nexport const QueryErrorLink: FunctionalComponent<QueryErrorLinkProps> = ({\n  errorType,\n  i18n,\n}) => {\n  const getErrorLink = () => {\n    switch (errorType as KnownErrorType) {\n      case 'NoEndpointsException':\n        return 'https://docs.coveo.com/en/mcc80216';\n      case 'InvalidTokenException':\n        return 'https://docs.coveo.com/en/102';\n      case 'OrganizationIsPausedException':\n        return 'https://docs.coveo.com/l6af0467';\n      default:\n        return null;\n    }\n  };\n\n  const link = getErrorLink();\n\n  return link ? (\n    <a href={link} part=\"doc-link\" class=\"btn-primary mt-10 inline-block p-3\">\n      {i18n.t('coveo-online-help')}\n    </a>\n  ) : null;\n};\n"],"version":3}

package/dist/esm/version.js

@@ -1,2 +1,2 @@
 export const headlessVersion = '3.27.1';
-export const atomicVersion = '3.27.5-pre.fc44b4ed1e';
+export const atomicVersion = '3.28.0-pre.05db57fb0d';

package/dist/types/components/commerce/atomic-commerce-products-per-page/atomic-commerce-products-per-page.d.ts

@@ -1,8 +1,9 @@
+import type { CommerceBindings } from "../atomic-commerce-interface/atomic-commerce-interface";
+import { InitializableComponent } from "../../../decorators/types";
 import { Pagination, Summary } from '@coveo/headless/commerce';
-import { InitializableComponent } from '../../../utils/initialization-utils';
-import type { CommerceBindings as Bindings } from '../atomic-commerce-interface/atomic-commerce-interface';
+import { LitElement } from 'lit';
 /**
- * The `atomic-commerce-products-per-page` component determines how many products to display per page.
+ * The `atomic-commerce-products-per-page` component lets the end user select how many products to display per page.
  *
  * @part label - The "Products per page" label.
  * @part buttons - The list of buttons.
@@ -11,8 +12,8 @@ import type { CommerceBindings as Bindings } from '../atomic-commerce-interface/
  *
  * @alpha
  */
-export declare class AtomicCommerceProductsPerPage implements InitializableComponent<Bindings> {
-    bindings: Bindings;
+export declare class AtomicCommerceProductsPerPage extends LitElement implements InitializableComponent<CommerceBindings> {
+    bindings: CommerceBindings;
     pagination: Pagination;
     private paginationState;
     summary: Summary;
@@ -30,8 +31,13 @@ export declare class AtomicCommerceProductsPerPage implements InitializableCompo
      * @type {number}
      */
     initialChoice?: number;
-    private scrollToTopEvent;
     initialize(): void;
+    private scrollToTopEvent;
     private get label();
-    render(): any;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'atomic-commerce-products-per-page': AtomicCommerceProductsPerPage;
+    }
 }

package/dist/types/components/commerce/index.d.ts

@@ -4,6 +4,7 @@ export { AtomicCommerceInterface } from './atomic-commerce-interface/atomic-comm
 export { AtomicCommerceLayout } from './atomic-commerce-layout/atomic-commerce-layout.js';
 export { AtomicCommercePager } from './atomic-commerce-pager/atomic-commerce-pager.js';
 export { AtomicCommerceProductList } from './atomic-commerce-product-list/atomic-commerce-product-list.js';
+export { AtomicCommerceProductsPerPage } from './atomic-commerce-products-per-page/atomic-commerce-products-per-page.js';
 export { AtomicCommerceQuerySummary } from './atomic-commerce-query-summary/atomic-commerce-query-summary.js';
 export { AtomicCommerceRecommendationList } from './atomic-commerce-recommendation-list/atomic-commerce-recommendation-list.js';
 export { AtomicCommerceSearchBox } from './atomic-commerce-search-box/atomic-commerce-search-box.js';

package/dist/types/components/common/items-per-page/choices.d.ts

@@ -5,7 +5,7 @@ interface ChoicesProps {
     pageSize: number;
     choices: number[];
     lang: string;
-    scrollToTopEvent: () => {};
+    scrollToTopEvent: () => void;
     setItemSize: (size: number) => void;
     focusOnFirstResultAfterNextSearch: () => Promise<void> | undefined;
     focusOnNextNewResult: () => void | undefined;

package/dist/types/components/common/items-per-page/error.d.ts

@@ -4,3 +4,6 @@ export declare class ChoiceIsNaNError extends Error {
 export declare class InitialChoiceNotInChoicesError extends Error {
     constructor(initialChoice: number, choices: number[]);
 }
+export declare class ChoiceIsNonPositiveError extends Error {
+    constructor(choice: number);
+}

package/dist/types/components/common/query-error/show-more.d.ts

@@ -1,10 +1,10 @@
-import { FunctionalComponent } from '../../../stencil-public-runtime';
+import { FunctionalComponent } from "../../../utils/functional-component-utils";
 import { i18n } from 'i18next';
-import { QueryErrorLink } from './stencil-link';
+import { TemplateResult } from 'lit';
 interface QueryErrorShowMoreProps {
     onShowMore: () => void;
     i18n: i18n;
-    link?: typeof QueryErrorLink;
+    link?: TemplateResult;
 }
-export declare const QueryErrorShowMore: FunctionalComponent<QueryErrorShowMoreProps>;
+export declare const renderQueryErrorShowMore: FunctionalComponent<QueryErrorShowMoreProps>;
 export {};

package/dist/types/components/common/query-error/stencil-show-more.d.ts

@@ -0,0 +1,10 @@
+import { FunctionalComponent } from '../../../stencil-public-runtime';
+import { i18n } from 'i18next';
+import { QueryErrorLink } from './stencil-link';
+interface QueryErrorShowMoreProps {
+    onShowMore: () => void;
+    i18n: i18n;
+    link?: typeof QueryErrorLink;
+}
+export declare const QueryErrorShowMore: FunctionalComponent<QueryErrorShowMoreProps>;
+export {};

package/dist/types/components/insight/atomic-insight-generated-answer/atomic-insight-generated-answer.d.ts

@@ -48,6 +48,7 @@ export declare class AtomicInsightGeneratedAnswer implements InitializableCompon
     private readonly DEFAULT_COLLAPSED_HEIGHT;
     private readonly MAX_COLLAPSED_HEIGHT;
     private readonly MIN_COLLAPSED_HEIGHT;
+    private readonly DEFAULT_FIELDS_TO_INCLUDE_IN_CITATIONS;
     private generatedAnswerState;
     private searchStatusState;
     error: Error;
@@ -74,6 +75,10 @@ export declare class AtomicInsightGeneratedAnswer implements InitializableCompon
      * The unique identifier of the answer configuration to use to generate the answer.
      */
     answerConfigurationId?: string;
+    /**
+     * A list of fields to include with the citations used to generate the answer.
+     */
+    fieldsToIncludeInCitations: string;
     protected ariaMessage: string;
     private generatedAnswerCommon;
     private fullAnswerHeight?;
@@ -88,6 +93,7 @@ export declare class AtomicInsightGeneratedAnswer implements InitializableCompon
     private adaptAnswerHeight;
     private getAnswerContainer;
     private getAnswerFooter;
+    private getCitationFields;
     private validateMaxCollapsedHeight;
     private setCSSVariable;
     private updateAnswerHeight;

package/dist/types/components/search/atomic-generated-answer/atomic-generated-answer.d.ts

@@ -47,6 +47,7 @@ export declare class AtomicGeneratedAnswer implements InitializableComponent {
     private readonly DEFAULT_COLLAPSED_HEIGHT;
     private readonly MAX_COLLAPSED_HEIGHT;
     private readonly MIN_COLLAPSED_HEIGHT;
+    private readonly DEFAULT_FIELDS_TO_INCLUDE_IN_CITATIONS;
     private generatedAnswerState;
     private searchStatusState;
     tabManager: TabManager;
@@ -74,6 +75,10 @@ export declare class AtomicGeneratedAnswer implements InitializableComponent {
      * The unique identifier of the answer configuration to use to generate the answer.
      */
     answerConfigurationId?: string;
+    /**
+     * A list of fields to include with the citations used to generate the answer.
+     */
+    fieldsToIncludeInCitations: string;
     /**
      * The tabs on which the generated answer can be displayed. This property should not be used at the same time as `tabs-excluded`.
      *
@@ -108,6 +113,7 @@ export declare class AtomicGeneratedAnswer implements InitializableComponent {
     private adaptAnswerHeight;
     private getAnswerContainer;
     private getAnswerFooter;
+    private getCitationFields;
     private validateMaxCollapsedHeight;
     private setCSSVariable;
     private updateAnswerHeight;

package/dist/types/components.d.ts

@@ -378,21 +378,6 @@ export namespace Components {
          */
         "summary": Summary<SearchSummaryState | ProductListingSummaryState>;
     }
-    /**
-     * The `atomic-commerce-products-per-page` component determines how many products to display per page.
-     * @alpha 
-     */
-    interface AtomicCommerceProductsPerPage {
-        /**
-          * A list of choices for the number of products to display per page, separated by commas.
-         */
-        "choicesDisplayed": string;
-        /**
-          * The initial selection for the number of product per page. This should be part of the `choicesDisplayed` option. By default, this is set to the first value in `choicesDisplayed`.
-          * @type {number}
-         */
-        "initialChoice"?: number;
-    }
     /**
      * The `atomic-commerce-query-error` component handles fatal errors when performing a query on the Commerce API. When the error is known, it displays a link to relevant documentation for debugging purposes. When the error is unknown, it displays a small text area with the JSON content of the error.
      * @alpha 
@@ -788,6 +773,10 @@ export namespace Components {
           * @default false
          */
         "collapsible"?: boolean;
+        /**
+          * A list of fields to include with the citations used to generate the answer.
+         */
+        "fieldsToIncludeInCitations": string;
         /**
           * The maximum height (in rem units) of the answer when collapsed.
          */
@@ -928,6 +917,10 @@ export namespace Components {
           * @default false
          */
         "collapsible"?: boolean;
+        /**
+          * A list of fields to include with the citations used to generate the answer.
+         */
+        "fieldsToIncludeInCitations": string;
         /**
           * The maximum height (in rem units) of the answer when collapsed.
          */
@@ -3448,10 +3441,6 @@ export interface AtomicCommerceFacetNumberInputCustomEvent<T> extends CustomEven
     detail: T;
     target: HTMLAtomicCommerceFacetNumberInputElement;
 }
-export interface AtomicCommerceProductsPerPageCustomEvent<T> extends CustomEvent<T> {
-    detail: T;
-    target: HTMLAtomicCommerceProductsPerPageElement;
-}
 export interface AtomicFacetDateInputCustomEvent<T> extends CustomEvent<T> {
     detail: T;
     target: HTMLAtomicFacetDateInputElement;
@@ -3691,27 +3680,6 @@ declare global {
         prototype: HTMLAtomicCommerceNumericFacetElement;
         new (): HTMLAtomicCommerceNumericFacetElement;
     };
-    interface HTMLAtomicCommerceProductsPerPageElementEventMap {
-        "atomic/scrollToTop": any;
-    }
-    /**
-     * The `atomic-commerce-products-per-page` component determines how many products to display per page.
-     * @alpha 
-     */
-    interface HTMLAtomicCommerceProductsPerPageElement extends Components.AtomicCommerceProductsPerPage, HTMLStencilElement {
-        addEventListener<K extends keyof HTMLAtomicCommerceProductsPerPageElementEventMap>(type: K, listener: (this: HTMLAtomicCommerceProductsPerPageElement, ev: AtomicCommerceProductsPerPageCustomEvent<HTMLAtomicCommerceProductsPerPageElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
-        addEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
-        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
-        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
-        removeEventListener<K extends keyof HTMLAtomicCommerceProductsPerPageElementEventMap>(type: K, listener: (this: HTMLAtomicCommerceProductsPerPageElement, ev: AtomicCommerceProductsPerPageCustomEvent<HTMLAtomicCommerceProductsPerPageElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
-        removeEventListener<K extends keyof DocumentEventMap>(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
-        removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
-        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
-    }
-    var HTMLAtomicCommerceProductsPerPageElement: {
-        prototype: HTMLAtomicCommerceProductsPerPageElement;
-        new (): HTMLAtomicCommerceProductsPerPageElement;
-    };
     /**
      * The `atomic-commerce-query-error` component handles fatal errors when performing a query on the Commerce API. When the error is known, it displays a link to relevant documentation for debugging purposes. When the error is unknown, it displays a small text area with the JSON content of the error.
      * @alpha 
@@ -5535,7 +5503,6 @@ declare global {
         "atomic-commerce-load-more-products": HTMLAtomicCommerceLoadMoreProductsElement;
         "atomic-commerce-no-products": HTMLAtomicCommerceNoProductsElement;
         "atomic-commerce-numeric-facet": HTMLAtomicCommerceNumericFacetElement;
-        "atomic-commerce-products-per-page": HTMLAtomicCommerceProductsPerPageElement;
         "atomic-commerce-query-error": HTMLAtomicCommerceQueryErrorElement;
         "atomic-commerce-recommendation-interface": HTMLAtomicCommerceRecommendationInterfaceElement;
         "atomic-commerce-refine-modal": HTMLAtomicCommerceRefineModalElement;
@@ -6014,22 +5981,6 @@ declare namespace LocalJSX {
          */
         "summary": Summary<SearchSummaryState | ProductListingSummaryState>;
     }
-    /**
-     * The `atomic-commerce-products-per-page` component determines how many products to display per page.
-     * @alpha 
-     */
-    interface AtomicCommerceProductsPerPage {
-        /**
-          * A list of choices for the number of products to display per page, separated by commas.
-         */
-        "choicesDisplayed"?: string;
-        /**
-          * The initial selection for the number of product per page. This should be part of the `choicesDisplayed` option. By default, this is set to the first value in `choicesDisplayed`.
-          * @type {number}
-         */
-        "initialChoice"?: number;
-        "onAtomic/scrollToTop"?: (event: AtomicCommerceProductsPerPageCustomEvent<any>) => void;
-    }
     /**
      * The `atomic-commerce-query-error` component handles fatal errors when performing a query on the Commerce API. When the error is known, it displays a link to relevant documentation for debugging purposes. When the error is unknown, it displays a small text area with the JSON content of the error.
      * @alpha 
@@ -6419,6 +6370,10 @@ declare namespace LocalJSX {
           * @default false
          */
         "collapsible"?: boolean;
+        /**
+          * A list of fields to include with the citations used to generate the answer.
+         */
+        "fieldsToIncludeInCitations"?: string;
         /**
           * The maximum height (in rem units) of the answer when collapsed.
          */
@@ -6555,6 +6510,10 @@ declare namespace LocalJSX {
           * @default false
          */
         "collapsible"?: boolean;
+        /**
+          * A list of fields to include with the citations used to generate the answer.
+         */
+        "fieldsToIncludeInCitations"?: string;
         /**
           * The maximum height (in rem units) of the answer when collapsed.
          */
@@ -8960,7 +8919,6 @@ declare namespace LocalJSX {
         "atomic-commerce-load-more-products": AtomicCommerceLoadMoreProducts;
         "atomic-commerce-no-products": AtomicCommerceNoProducts;
         "atomic-commerce-numeric-facet": AtomicCommerceNumericFacet;
-        "atomic-commerce-products-per-page": AtomicCommerceProductsPerPage;
         "atomic-commerce-query-error": AtomicCommerceQueryError;
         "atomic-commerce-recommendation-interface": AtomicCommerceRecommendationInterface;
         "atomic-commerce-refine-modal": AtomicCommerceRefineModal;
@@ -9208,11 +9166,6 @@ declare module "@stencil/core" {
              * @alpha 
              */
             "atomic-commerce-numeric-facet": LocalJSX.AtomicCommerceNumericFacet & JSXBase.HTMLAttributes<HTMLAtomicCommerceNumericFacetElement>;
-            /**
-             * The `atomic-commerce-products-per-page` component determines how many products to display per page.
-             * @alpha 
-             */
-            "atomic-commerce-products-per-page": LocalJSX.AtomicCommerceProductsPerPage & JSXBase.HTMLAttributes<HTMLAtomicCommerceProductsPerPageElement>;
             /**
              * The `atomic-commerce-query-error` component handles fatal errors when performing a query on the Commerce API. When the error is known, it displays a link to relevant documentation for debugging purposes. When the error is unknown, it displays a small text area with the JSON content of the error.
              * @alpha 

package/docs/atomic-docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2025-07-02T13:48:25",
+  "timestamp": "2025-07-02T22:17:28",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.20.0",
@@ -3057,128 +3057,6 @@
         ]
       }
     },
-    {
-      "filePath": "src/components/commerce/atomic-commerce-products-per-page/atomic-commerce-products-per-page.tsx",
-      "encapsulation": "shadow",
-      "tag": "atomic-commerce-products-per-page",
-      "docs": "The `atomic-commerce-products-per-page` component determines how many products to display per page.",
-      "docsTags": [
-        {
-          "name": "part",
-          "text": "label - The \"Products per page\" label."
-        },
-        {
-          "name": "part",
-          "text": "buttons - The list of buttons."
-        },
-        {
-          "name": "part",
-          "text": "button - The individual products per page buttons."
-        },
-        {
-          "name": "part",
-          "text": "active-button - The active products per page button."
-        },
-        {
-          "name": "alpha"
-        }
-      ],
-      "usage": {},
-      "props": [
-        {
-          "name": "choicesDisplayed",
-          "type": "string",
-          "complexType": {
-            "original": "string",
-            "resolved": "string",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "choices-displayed",
-          "reflectToAttr": true,
-          "docs": "A list of choices for the number of products to display per page, separated by commas.",
-          "docsTags": [],
-          "default": "'10,25,50,100'",
-          "values": [
-            {
-              "type": "string"
-            }
-          ],
-          "optional": false,
-          "required": false
-        },
-        {
-          "name": "initialChoice",
-          "type": "number | undefined",
-          "complexType": {
-            "original": "number",
-            "resolved": "number | undefined",
-            "references": {}
-          },
-          "mutable": true,
-          "attr": "initial-choice",
-          "reflectToAttr": true,
-          "docs": "The initial selection for the number of product per page. This should be part of the `choicesDisplayed` option. By default, this is set to the first value in `choicesDisplayed`.",
-          "docsTags": [
-            {
-              "name": "type",
-              "text": "{number}"
-            }
-          ],
-          "values": [
-            {
-              "type": "number"
-            },
-            {
-              "type": "undefined"
-            }
-          ],
-          "optional": true,
-          "required": false
-        }
-      ],
-      "methods": [],
-      "events": [
-        {
-          "event": "atomic/scrollToTop",
-          "detail": "any",
-          "bubbles": true,
-          "complexType": {
-            "original": "any",
-            "resolved": "any",
-            "references": {}
-          },
-          "cancelable": true,
-          "composed": true,
-          "docs": "",
-          "docsTags": []
-        }
-      ],
-      "listeners": [],
-      "styles": [],
-      "slots": [],
-      "parts": [
-        {
-          "name": "active-button",
-          "docs": "The active products per page button."
-        },
-        {
-          "name": "button",
-          "docs": "The individual products per page buttons."
-        },
-        {
-          "name": "buttons",
-          "docs": "The list of buttons."
-        },
-        {
-          "name": "label",
-          "docs": "The \"Products per page\" label."
-        }
-      ],
-      "dependents": [],
-      "dependencies": [],
-      "dependencyGraph": {}
-    },
     {
       "filePath": "src/components/commerce/atomic-commerce-query-error/atomic-commerce-query-error.tsx",
       "encapsulation": "shadow",
@@ -6093,6 +5971,28 @@
           "optional": true,
           "required": false
         },
+        {
+          "name": "fieldsToIncludeInCitations",
+          "type": "string",
+          "complexType": {
+            "original": "string",
+            "resolved": "string",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "fields-to-include-in-citations",
+          "reflectToAttr": false,
+          "docs": "A list of fields to include with the citations used to generate the answer.",
+          "docsTags": [],
+          "default": "this.DEFAULT_FIELDS_TO_INCLUDE_IN_CITATIONS",
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
         {
           "name": "maxCollapsedHeight",
           "type": "number",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@coveo/atomic",
   "type": "module",
-  "version": "3.27.5-pre.fc44b4ed1e",
+  "version": "3.28.0-pre.05db57fb0d",
   "description": "A web-component library for building modern UIs interfacing with the Coveo platform",
   "homepage": "https://docs.coveo.com/en/atomic/latest/",
   "repository": {

package/dist/atomic/components/atomic-commerce-products-per-page.d.ts

@@ -1,11 +0,0 @@
-import type { Components, JSX } from "../../types/components";
-
-interface AtomicCommerceProductsPerPage extends Components.AtomicCommerceProductsPerPage, HTMLElement {}
-export const AtomicCommerceProductsPerPage: {
-    prototype: AtomicCommerceProductsPerPage;
-    new (): AtomicCommerceProductsPerPage;
-};
-/**
- * Used to define this component and all nested components recursively.
- */
-export const defineCustomElement: () => void;