@coveo/atomic 3.34.0-pre.616c4e348b → 3.34.0-pre.64accaaf5d

package/dist/types/utils/compare-utils.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Performs a deep equality comparison between two values.
+ * Handles primitives, null/undefined, arrays, and objects.
+ *
+ * @param a - First value to compare
+ * @param b - Second value to compare
+ * @returns true if values are deeply equal, false otherwise
+ */
+export declare function deepEqual(a: unknown, b: unknown): boolean;

package/docs/atomic-docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2025-10-06T14:57:04",
+  "timestamp": "2025-10-07T10:42:32",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.20.0",
@@ -3346,6 +3346,14 @@
           "atomic-result",
           "atomic-result-placeholder",
           "atomic-result-table-placeholder"
+        ],
+        "atomic-result-placeholder": [
+          "atomic-result-section-visual",
+          "atomic-result-section-badges",
+          "atomic-result-section-actions",
+          "atomic-result-section-title",
+          "atomic-result-section-excerpt",
+          "atomic-result-section-bottom-metadata"
         ]
       }
     },
@@ -8298,6 +8306,14 @@
           "atomic-recs-result",
           "atomic-result-placeholder",
           "atomic-result-table-placeholder"
+        ],
+        "atomic-result-placeholder": [
+          "atomic-result-section-visual",
+          "atomic-result-section-badges",
+          "atomic-result-section-actions",
+          "atomic-result-section-title",
+          "atomic-result-section-excerpt",
+          "atomic-result-section-bottom-metadata"
         ]
       }
     },
@@ -9159,88 +9175,6 @@
         ]
       }
     },
-    {
-      "filePath": "src/components/search/atomic-relevance-inspector/atomic-relevance-inspector.tsx",
-      "encapsulation": "shadow",
-      "tag": "atomic-relevance-inspector",
-      "docs": "The `atomic-relevance-inspector` component is used internally to offer insight on search page relevance, as well as information to help troubleshoot issues during development.",
-      "docsTags": [],
-      "usage": {},
-      "props": [
-        {
-          "name": "bindings",
-          "type": "CommonBindings<SearchEngine<{}>, SearchStore, AtomicSearchInterface> & NonceBindings",
-          "complexType": {
-            "original": "Bindings",
-            "resolved": "CommonBindings<SearchEngine<{}>, SearchStore, AtomicSearchInterface> & NonceBindings",
-            "references": {
-              "Bindings": {
-                "location": "import",
-                "path": "../atomic-search-interface/atomic-search-interface",
-                "id": "src/components/search/atomic-search-interface/atomic-search-interface.ts::Bindings"
-              }
-            }
-          },
-          "mutable": false,
-          "reflectToAttr": false,
-          "docs": "The Atomic interface bindings, namely the headless search engine and i18n instances.",
-          "docsTags": [],
-          "values": [
-            {
-              "type": "CommonBindings<SearchEngine<{}>, SearchStore, AtomicSearchInterface> & NonceBindings"
-            }
-          ],
-          "optional": false,
-          "required": true
-        },
-        {
-          "name": "open",
-          "type": "boolean",
-          "complexType": {
-            "original": "boolean",
-            "resolved": "boolean",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "open",
-          "reflectToAttr": true,
-          "docs": "",
-          "docsTags": [],
-          "default": "false",
-          "values": [
-            {
-              "type": "boolean"
-            }
-          ],
-          "optional": false,
-          "required": false
-        }
-      ],
-      "methods": [],
-      "events": [
-        {
-          "event": "atomic/relevanceInspector/close",
-          "detail": "any",
-          "bubbles": true,
-          "complexType": {
-            "original": "any",
-            "resolved": "any",
-            "references": {}
-          },
-          "cancelable": true,
-          "composed": true,
-          "docs": "",
-          "docsTags": []
-        }
-      ],
-      "listeners": [],
-      "styles": [],
-      "slots": [],
-      "parts": [],
-      "dependents": [],
-      "dependencies": [],
-      "dependencyGraph": {}
-    },
     {
       "filePath": "src/components/search/atomic-result/atomic-result.tsx",
       "encapsulation": "shadow",
@@ -9857,6 +9791,14 @@
           "atomic-result",
           "atomic-result-placeholder",
           "atomic-result-table-placeholder"
+        ],
+        "atomic-result-placeholder": [
+          "atomic-result-section-visual",
+          "atomic-result-section-badges",
+          "atomic-result-section-actions",
+          "atomic-result-section-title",
+          "atomic-result-section-excerpt",
+          "atomic-result-section-bottom-metadata"
         ]
       }
     },
@@ -10721,6 +10663,14 @@
           "atomic-result-placeholder",
           "atomic-result-table-placeholder",
           "atomic-text"
+        ],
+        "atomic-result-placeholder": [
+          "atomic-result-section-visual",
+          "atomic-result-section-badges",
+          "atomic-result-section-actions",
+          "atomic-result-section-title",
+          "atomic-result-section-excerpt",
+          "atomic-result-section-bottom-metadata"
         ]
       }
     },
@@ -11167,6 +11117,248 @@
       "dependencies": [],
       "dependencyGraph": {}
     },
+    {
+      "filePath": "src/components/search/result-template-components/atomic-result-sections/atomic-result-section-actions.tsx",
+      "encapsulation": "none",
+      "tag": "atomic-result-section-actions",
+      "docs": "This section allows the information seeker to perform an action on an item without having to view its details.\nFor example, in Commerce you can add an item to the cart directly or add it to a wish list to view at a later time.\n\nBehavior:\n* Exposes the `--line-height` CSS variable so child elements can adjust to the current line height.\n** You should ensure that elements inside of it have `height: var(--line-height)`.\n* Is a wrapping flexbox with a gap.\n* May appear over, next to, or beneath the visual section.",
+      "docsTags": [],
+      "usage": {},
+      "props": [],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [
+        "atomic-result-placeholder"
+      ],
+      "dependencies": [],
+      "dependencyGraph": {
+        "atomic-result-placeholder": [
+          "atomic-result-section-actions"
+        ]
+      }
+    },
+    {
+      "filePath": "src/components/search/result-template-components/atomic-result-sections/atomic-result-section-badges.tsx",
+      "encapsulation": "none",
+      "tag": "atomic-result-section-badges",
+      "docs": "This section provides badges that highlight special features of the item.\n\nBehavior:\n* Exposes the `--line-height` CSS variable so child elements can adjust to the current line height.\n** You should ensure that elements inside of it have `height: var(--line-height)`.\n* Is a wrapping flexbox with a gap.\n* May appear over, next to, or beneath the visual section.",
+      "docsTags": [],
+      "usage": {},
+      "props": [],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [
+        "atomic-result-placeholder"
+      ],
+      "dependencies": [],
+      "dependencyGraph": {
+        "atomic-result-placeholder": [
+          "atomic-result-section-badges"
+        ]
+      }
+    },
+    {
+      "filePath": "src/components/search/result-template-components/atomic-result-sections/atomic-result-section-bottom-metadata.tsx",
+      "encapsulation": "none",
+      "tag": "atomic-result-section-bottom-metadata",
+      "docs": "This section displays additional descriptive information about the item.\n\nBehavior:\n* Has a maximum height of two lines.\n** We recommend that you use `atomic-result-fields-list` to ensure that the fields in this section don’t overflow.\n* Exposes the `--line-height` variable so child elements can adjust to the current line height.\n* Has a defined CSS `color` property for text.\n* Has a font weight.",
+      "docsTags": [],
+      "usage": {},
+      "props": [],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [
+        "atomic-result-placeholder"
+      ],
+      "dependencies": [],
+      "dependencyGraph": {
+        "atomic-result-placeholder": [
+          "atomic-result-section-bottom-metadata"
+        ]
+      }
+    },
+    {
+      "filePath": "src/components/search/result-template-components/atomic-result-sections/atomic-result-section-children.tsx",
+      "encapsulation": "none",
+      "tag": "atomic-result-section-children",
+      "docs": "This section displays the folded results, available when using the <atomic-result-children> component.\n\nBehavior:\n* Shows children at the bottom of the result, indented and wrapped in a border.",
+      "docsTags": [],
+      "usage": {},
+      "props": [],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [],
+      "dependencies": [],
+      "dependencyGraph": {}
+    },
+    {
+      "filePath": "src/components/search/result-template-components/atomic-result-sections/atomic-result-section-emphasized.tsx",
+      "encapsulation": "none",
+      "tag": "atomic-result-section-emphasized",
+      "docs": "This section displays the field that's important for its search criteria.\nFor example, in Commerce, a product's cost is often more important than the title itself.\n\nBehavior:\n* Has a very large font size.\n* Is the second closest element beneath the title section.",
+      "docsTags": [],
+      "usage": {},
+      "props": [],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [],
+      "dependencies": [],
+      "dependencyGraph": {}
+    },
+    {
+      "filePath": "src/components/search/result-template-components/atomic-result-sections/atomic-result-section-excerpt.tsx",
+      "encapsulation": "none",
+      "tag": "atomic-result-section-excerpt",
+      "docs": "This section contains an informative summary of the item's content.\n\nBehavior:\n* Has a fixed height of one to three lines, depending on the layout and density.\n* Ellipses overflowing text.\n* Exposes the `--line-height` CSS variable so child elements can adjust to the current line height.\n* Has a defined CSS `color` property for text.",
+      "docsTags": [],
+      "usage": {},
+      "props": [],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [
+        "atomic-result-placeholder"
+      ],
+      "dependencies": [],
+      "dependencyGraph": {
+        "atomic-result-placeholder": [
+          "atomic-result-section-excerpt"
+        ]
+      }
+    },
+    {
+      "filePath": "src/components/search/result-template-components/atomic-result-sections/atomic-result-section-title.tsx",
+      "encapsulation": "none",
+      "tag": "atomic-result-section-title",
+      "docs": "This section identifies the item by its name, and its main use is to make the result list scannable.\nThis is usually the page title.\n\nBehavior:\n* Has a fixed height of two lines on grid layouts.\n* Exposes the `--line-height` CSS variable so child elements can adjust to the current line height.\n* Has a defined CSS `color` property for text.",
+      "docsTags": [],
+      "usage": {},
+      "props": [],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [
+        "atomic-result-placeholder"
+      ],
+      "dependencies": [],
+      "dependencyGraph": {
+        "atomic-result-placeholder": [
+          "atomic-result-section-title"
+        ]
+      }
+    },
+    {
+      "filePath": "src/components/search/result-template-components/atomic-result-sections/atomic-result-section-title-metadata.tsx",
+      "encapsulation": "none",
+      "tag": "atomic-result-section-title-metadata",
+      "docs": "This section surfaces some fields that are directly related to the title of the item.\nFor example, in Commerce, this could be the item's rating, which is tied to the nature of the product itself,\nrather than to the product's description.\n\nBehavior:\n* Has a very small font size.\n* Is the closest element beneath the title section.",
+      "docsTags": [],
+      "usage": {},
+      "props": [],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [],
+      "dependencies": [],
+      "dependencyGraph": {}
+    },
+    {
+      "filePath": "src/components/search/result-template-components/atomic-result-sections/atomic-result-section-visual.tsx",
+      "encapsulation": "none",
+      "tag": "atomic-result-section-visual",
+      "docs": "This section provides visual information about the item.\nFor example, in Commerce, an image is a great shorthand for a product category.\nAn icon can quickly show the item type, or an avatar can help identify to whom it is related.\n\nBehavior:\n* Has a fixed size that depends on the specified image size, the layout, the density, and the screen size.\n** When the image size is set to `icon`, this section stays very small.\n** You should ensure that elements inside of it take the available space.\n* Always has a 1:1 aspect ratio.",
+      "docsTags": [],
+      "usage": {},
+      "props": [
+        {
+          "name": "imageSize",
+          "type": "\"icon\" | \"large\" | \"none\" | \"small\" | undefined",
+          "complexType": {
+            "original": "ItemDisplayImageSize",
+            "resolved": "\"icon\" | \"large\" | \"none\" | \"small\" | undefined",
+            "references": {
+              "ItemDisplayImageSize": {
+                "location": "import",
+                "path": "../../../common/layout/display-options",
+                "id": "src/components/common/layout/display-options.ts::ItemDisplayImageSize"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "image-size",
+          "reflectToAttr": true,
+          "docs": "How large or small the visual section of results using this template should be.",
+          "docsTags": [],
+          "values": [
+            {
+              "value": "icon",
+              "type": "string"
+            },
+            {
+              "value": "large",
+              "type": "string"
+            },
+            {
+              "value": "none",
+              "type": "string"
+            },
+            {
+              "value": "small",
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": true,
+          "required": false
+        }
+      ],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [
+        "atomic-result-placeholder"
+      ],
+      "dependencies": [],
+      "dependencyGraph": {
+        "atomic-result-placeholder": [
+          "atomic-result-section-visual"
+        ]
+      }
+    },
     {
       "filePath": "src/components/search/result-templates/atomic-result-template/atomic-result-template.tsx",
       "encapsulation": "shadow",
@@ -12034,13 +12226,11 @@
       "dependents": [],
       "dependencies": [
         "atomic-suggestion-renderer",
-        "atomic-search-box-recent-queries",
         "atomic-search-box-query-suggestions"
       ],
       "dependencyGraph": {
         "atomic-search-box": [
           "atomic-suggestion-renderer",
-          "atomic-search-box-recent-queries",
           "atomic-search-box-query-suggestions"
         ]
       }
@@ -12359,101 +12549,6 @@
         ]
       }
     },
-    {
-      "filePath": "src/components/search/search-box-suggestions/atomic-search-box-recent-queries/atomic-search-box-recent-queries.tsx",
-      "encapsulation": "shadow",
-      "tag": "atomic-search-box-recent-queries",
-      "docs": "The `atomic-search-box-recent-queries` component can be added as a child of an `atomic-search-box` component, allowing for the configuration of recent query suggestions.",
-      "docsTags": [],
-      "usage": {},
-      "props": [
-        {
-          "name": "icon",
-          "type": "string | undefined",
-          "complexType": {
-            "original": "string",
-            "resolved": "string | undefined",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "icon",
-          "reflectToAttr": false,
-          "docs": "The SVG icon to display.\n\n- Use a value that starts with `http://`, `https://`, `./`, or `../`, to fetch and display an icon from a given location.\n- Use a value that starts with `assets://`, to display an icon from the Atomic package.\n- Use a stringified SVG to display it directly.",
-          "docsTags": [],
-          "values": [
-            {
-              "type": "string"
-            },
-            {
-              "type": "undefined"
-            }
-          ],
-          "optional": true,
-          "required": false
-        },
-        {
-          "name": "maxWithQuery",
-          "type": "number",
-          "complexType": {
-            "original": "number",
-            "resolved": "number",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "max-with-query",
-          "reflectToAttr": true,
-          "docs": "The maximum number of suggestions that will be displayed if the user has typed something into the input field.",
-          "docsTags": [],
-          "default": "3",
-          "values": [
-            {
-              "type": "number"
-            }
-          ],
-          "optional": false,
-          "required": false
-        },
-        {
-          "name": "maxWithoutQuery",
-          "type": "number | undefined",
-          "complexType": {
-            "original": "number",
-            "resolved": "number | undefined",
-            "references": {}
-          },
-          "mutable": false,
-          "attr": "max-without-query",
-          "reflectToAttr": true,
-          "docs": "The maximum number of suggestions that will be displayed initially when the input field is empty.",
-          "docsTags": [],
-          "values": [
-            {
-              "type": "number"
-            },
-            {
-              "type": "undefined"
-            }
-          ],
-          "optional": true,
-          "required": false
-        }
-      ],
-      "methods": [],
-      "events": [],
-      "listeners": [],
-      "styles": [],
-      "slots": [],
-      "parts": [],
-      "dependents": [
-        "atomic-search-box"
-      ],
-      "dependencies": [],
-      "dependencyGraph": {
-        "atomic-search-box": [
-          "atomic-search-box-recent-queries"
-        ]
-      }
-    },
     {
       "filePath": "src/components/search/facets/atomic-segmented-facet/atomic-segmented-facet.tsx",
       "encapsulation": "shadow",
@@ -15251,11 +15346,6 @@
       "docstring": "",
       "path": "src/utils/initialization-utils.tsx"
     },
-    "src/components/search/atomic-search-interface/atomic-search-interface.ts::Bindings": {
-      "declaration": "export type Bindings = CommonBindings<\n  SearchEngine,\n  SearchStore,\n  AtomicSearchInterface\n> &\n  //TODO: KIT-4893 - Remove once atomic-quickview-modal migration is complete.\n  NonceBindings;",
-      "docstring": "",
-      "path": "src/components/search/atomic-search-interface/atomic-search-interface.ts"
-    },
     "../headless/dist/definitions/index.d.ts::FoldedResult": {
       "declaration": "any",
       "docstring": "",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@coveo/atomic",
   "type": "module",
-  "version": "3.34.0-pre.616c4e348b",
+  "version": "3.34.0-pre.64accaaf5d",
   "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-relevance-inspector.d.ts

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