@coveo/atomic 3.31.2-pre.bd810aa426 → 3.31.2-pre.e1fe65e6c6

package/docs/atomic-docs.json

@@ -1,42 +1,11 @@
 {
-  "timestamp": "2025-07-30T18:23:28",
+  "timestamp": "2025-07-30T17:27:48",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.20.0",
     "typescriptVersion": "5.5.3"
   },
   "components": [
-    {
-      "filePath": "src/components/search/atomic-search-interface/atomic-aria-live.tsx",
-      "encapsulation": "none",
-      "tag": "atomic-aria-live",
-      "docs": "The `atomic-aria-live` component notifies screen readers of changes in the search interface.",
-      "docsTags": [],
-      "usage": {},
-      "props": [],
-      "methods": [],
-      "events": [],
-      "listeners": [
-        {
-          "event": "atomic/accessibility/findAriaLive",
-          "target": "document",
-          "capture": false,
-          "passive": false
-        }
-      ],
-      "styles": [],
-      "slots": [],
-      "parts": [],
-      "dependents": [
-        "atomic-search-interface"
-      ],
-      "dependencies": [],
-      "dependencyGraph": {
-        "atomic-search-interface": [
-          "atomic-aria-live"
-        ]
-      }
-    },
     {
       "filePath": "src/components/search/facets/atomic-automatic-facet/atomic-automatic-facet.tsx",
       "encapsulation": "shadow",
@@ -6593,6 +6562,124 @@
         ]
       }
     },
+    {
+      "filePath": "src/components/commerce/atomic-product-description/atomic-product-description.tsx",
+      "encapsulation": "none",
+      "tag": "atomic-product-description",
+      "docs": "",
+      "docsTags": [
+        {
+          "name": "alpha",
+          "text": "The `atomic-product-description` component renders the description of a product."
+        }
+      ],
+      "usage": {},
+      "props": [
+        {
+          "name": "field",
+          "type": "\"ec_description\" | \"ec_shortdesc\"",
+          "complexType": {
+            "original": "'ec_description' | 'ec_shortdesc'",
+            "resolved": "\"ec_description\" | \"ec_shortdesc\"",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "field",
+          "reflectToAttr": false,
+          "docs": "The name of the description field to use.",
+          "docsTags": [],
+          "default": "'ec_shortdesc'",
+          "values": [
+            {
+              "value": "ec_description",
+              "type": "string"
+            },
+            {
+              "value": "ec_shortdesc",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "isCollapsible",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": false,
+          "attr": "is-collapsible",
+          "reflectToAttr": false,
+          "docs": "Whether the description should be collapsible after being expanded.",
+          "docsTags": [],
+          "default": "true",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": false,
+          "required": false
+        },
+        {
+          "name": "truncateAfter",
+          "type": "\"1\" | \"2\" | \"3\" | \"4\" | \"none\"",
+          "complexType": {
+            "original": "TruncateAfter",
+            "resolved": "\"1\" | \"2\" | \"3\" | \"4\" | \"none\"",
+            "references": {
+              "TruncateAfter": {
+                "location": "import",
+                "path": "../../common/expandable-text/stencil-expandable-text",
+                "id": "src/components/common/expandable-text/stencil-expandable-text.tsx::TruncateAfter"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "truncate-after",
+          "reflectToAttr": false,
+          "docs": "The number of lines after which the product description should be truncated. A value of \"none\" will disable truncation.",
+          "docsTags": [],
+          "default": "'2'",
+          "values": [
+            {
+              "value": "1",
+              "type": "string"
+            },
+            {
+              "value": "2",
+              "type": "string"
+            },
+            {
+              "value": "3",
+              "type": "string"
+            },
+            {
+              "value": "4",
+              "type": "string"
+            },
+            {
+              "value": "none",
+              "type": "string"
+            }
+          ],
+          "optional": false,
+          "required": false
+        }
+      ],
+      "methods": [],
+      "events": [],
+      "listeners": [],
+      "styles": [],
+      "slots": [],
+      "parts": [],
+      "dependents": [],
+      "dependencies": [],
+      "dependencyGraph": {}
+    },
     {
       "filePath": "src/components/commerce/atomic-product-field-condition/atomic-product-field-condition.tsx",
       "encapsulation": "none",
@@ -14942,12 +15029,10 @@
       "parts": [],
       "dependents": [],
       "dependencies": [
-        "atomic-aria-live",
         "atomic-relevance-inspector"
       ],
       "dependencyGraph": {
         "atomic-search-interface": [
-          "atomic-aria-live",
           "atomic-relevance-inspector"
         ],
         "atomic-relevance-inspector": [
@@ -17691,6 +17776,11 @@
       "docstring": "",
       "path": "src/components/common/item-list/stencil-item-list-common.tsx"
     },
+    "src/components/common/expandable-text/stencil-expandable-text.tsx::TruncateAfter": {
+      "declaration": "export type TruncateAfter = 'none' | '1' | '2' | '3' | '4';",
+      "docstring": "",
+      "path": "src/components/common/expandable-text/stencil-expandable-text.tsx"
+    },
     "src/components.d.ts::ItemDisplayImageSize": {
       "declaration": "any",
       "docstring": "",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@coveo/atomic",
   "type": "module",
-  "version": "3.31.2-pre.bd810aa426",
+  "version": "3.31.2-pre.e1fe65e6c6",
   "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-aria-live.d.ts

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

package/dist/atomic/components/atomic-aria-live.js

@@ -1,8 +0,0 @@
-import { A as AtomicAriaLive$1, d as defineCustomElement$1 } from './atomic-aria-live2.js';
-
-const AtomicAriaLive = AtomicAriaLive$1;
-const defineCustomElement = defineCustomElement$1;
-
-export { AtomicAriaLive, defineCustomElement };
-
-//# sourceMappingURL=atomic-aria-live.js.map

package/dist/atomic/components/atomic-aria-live.js.map

@@ -1 +0,0 @@
-{"file":"atomic-aria-live.js","mappings":";;;;;;;","names":[],"sources":[],"sourcesContent":[],"version":3}

package/dist/atomic/components/atomic-aria-live2.js

@@ -1,87 +0,0 @@
-import { proxyCustomElement, HTMLElement, h, Host } from '@stencil/core/internal/client';
-import { b as buildDebouncedQueue } from './debounce-utils.js';
-import { r as randomID } from './utils.js';
-
-const AtomicAriaLive = /*@__PURE__*/ proxyCustomElement(class AtomicAriaLive extends HTMLElement {
-    constructor() {
-        super();
-        this.__registerHost();
-        this.regions = {};
-        this.messagesQueue = buildDebouncedQueue({ delay: 500 });
-        this.regions = {};
-    }
-    onFindAriaLive({ detail: args }) {
-        if (!args.element || !this.isInSearchInterface) {
-            args.element = this.host;
-        }
-    }
-    get isInSearchInterface() {
-        let element = this.host;
-        while (element) {
-            if (element.tagName === 'ATOMIC-SEARCH-INTERFACE') {
-                return true;
-            }
-            element = element.parentElement;
-        }
-        return false;
-    }
-    connectedCallback() {
-        this.id = randomID('atomic-aria-live-');
-    }
-    /**
-     * @internal
-     */
-    async updateMessage(region, message, assertive) {
-        const updateRegion = () => (this.regions = { ...this.regions, [region]: { assertive, message } });
-        if (message) {
-            this.messagesQueue.enqueue(updateRegion, region);
-        }
-        else {
-            this.messagesQueue.cancelActionIfQueued(region);
-            updateRegion();
-        }
-    }
-    /**
-     * @internal
-     */
-    async registerRegion(region, assertive) {
-        if (region in this.regions) {
-            return;
-        }
-        this.regions = { ...this.regions, [region]: { assertive, message: '' } };
-    }
-    disconnectedCallback() {
-        this.messagesQueue.clear();
-    }
-    render() {
-        return (h(Host, { key: '5351e58c1abf430a4c9086b313690cdc7b5fc848', style: {
-                position: 'absolute',
-                display: 'block',
-                height: '0',
-                overflow: 'hidden',
-                margin: '0',
-            } }, Object.entries(this.regions).map(([regionName, { assertive, message }]) => (h("div", { key: regionName, id: `${this.id}-${regionName}`, "aria-live": assertive ? 'assertive' : 'polite', role: "status" }, message)))));
-    }
-    get host() { return this; }
-}, [0, "atomic-aria-live", {
-        "regions": [32],
-        "updateMessage": [64],
-        "registerRegion": [64]
-    }, [[4, "atomic/accessibility/findAriaLive", "onFindAriaLive"]]]);
-function defineCustomElement() {
-    if (typeof customElements === "undefined") {
-        return;
-    }
-    const components = ["atomic-aria-live"];
-    components.forEach(tagName => { switch (tagName) {
-        case "atomic-aria-live":
-            if (!customElements.get(tagName)) {
-                customElements.define(tagName, AtomicAriaLive);
-            }
-            break;
-    } });
-}
-
-export { AtomicAriaLive as A, defineCustomElement as d };
-
-//# sourceMappingURL=atomic-aria-live2.js.map

package/dist/atomic/components/atomic-aria-live2.js.map

@@ -1 +0,0 @@
-{"file":"atomic-aria-live2.js","mappings":";;;;MAsBa,cAAc;;;;QAER,YAAO,GAAsB,EAAE,CAAC;QAEzC,kBAAa,GAAG,mBAAmB,CAAC,EAAC,KAAK,EAAE,GAAG,EAAC,CAAC,CAAC;uBAFZ,EAAE;;IAMtC,cAAc,CAAC,EAAC,MAAM,EAAE,IAAI,EAAqC;QACzE,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE;YAC9C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC;SAC1B;KACF;IAED,IAAY,mBAAmB;QAC7B,IAAI,OAAO,GAAmB,IAAI,CAAC,IAAI,CAAC;QACxC,OAAO,OAAO,EAAE;YACd,IAAI,OAAO,CAAC,OAAO,KAAK,yBAAyB,EAAE;gBACjD,OAAO,IAAI,CAAC;aACb;YACD,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;SACjC;QACD,OAAO,KAAK,CAAC;KACd;IAED,iBAAiB;QACf,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,mBAAmB,CAAC,CAAC;KACzC;;;;IAMM,MAAM,aAAa,CACxB,MAAc,EACd,OAAe,EACf,SAAkB;QAElB,MAAM,YAAY,GAAG,OAClB,IAAI,CAAC,OAAO,GAAG,EAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,GAAG,EAAC,SAAS,EAAE,OAAO,EAAC,EAAC,CAAC,CAAC;QAErE,IAAI,OAAO,EAAE;YACX,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;SAClD;aAAM;YACL,IAAI,CAAC,aAAa,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;YAChD,YAAY,EAAE,CAAC;SAChB;KACF;;;;IAMM,MAAM,cAAc,CAAC,MAAc,EAAE,SAAkB;QAC5D,IAAI,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE;YAC1B,OAAO;SACR;QACD,IAAI,CAAC,OAAO,GAAG,EAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,GAAG,EAAC,SAAS,EAAE,OAAO,EAAE,EAAE,EAAC,EAAC,CAAC;KACtE;IAEM,oBAAoB;QACzB,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;KAC5B;IAEM,MAAM;QACX,QACE,EAAC,IAAI,qDACH,KAAK,EAAE;gBACL,QAAQ,EAAE,UAAU;gBACpB,OAAO,EAAE,OAAO;gBAChB,MAAM,EAAE,GAAG;gBACX,QAAQ,EAAE,QAAQ;gBAClB,MAAM,EAAE,GAAG;aACZ,IAEA,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAC/B,CAAC,CAAC,UAAU,EAAE,EAAC,SAAS,EAAE,OAAO,EAAC,CAAC,MACjC,WACE,GAAG,EAAE,UAAU,EACf,EAAE,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,UAAU,EAAE,eACnB,SAAS,GAAG,WAAW,GAAG,QAAQ,EAC7C,IAAI,EAAC,QAAQ,IAEZ,OAAO,CACJ,CACP,CACF,CACI,EACP;KACH;;;;;;;;;;;;;;;;;;;;;;;","names":[],"sources":["src/components/search/atomic-search-interface/atomic-aria-live.tsx"],"sourcesContent":["import {\n  Component,\n  h,\n  State,\n  Element,\n  Method,\n  Listen,\n  Host,\n} from '@stencil/core';\nimport {buildDebouncedQueue} from '../../../utils/debounce-utils';\nimport {FindAriaLiveEventArgs} from '../../../utils/stencil-accessibility-utils';\nimport {randomID} from '../../../utils/utils';\n\ntype Regions = {[regionName: string]: {assertive: boolean; message: string}};\n\n/**\n * The `atomic-aria-live` component notifies screen readers of changes in the search interface.\n */\n@Component({\n  tag: 'atomic-aria-live',\n  shadow: false,\n})\nexport class AtomicAriaLive {\n  @Element() private host!: HTMLAtomicAriaLiveElement;\n  @State() private regions: Readonly<Regions> = {};\n\n  private messagesQueue = buildDebouncedQueue({delay: 500});\n  private id!: string;\n\n  @Listen('atomic/accessibility/findAriaLive', {target: 'document'})\n  protected onFindAriaLive({detail: args}: CustomEvent<FindAriaLiveEventArgs>) {\n    if (!args.element || !this.isInSearchInterface) {\n      args.element = this.host;\n    }\n  }\n\n  private get isInSearchInterface() {\n    let element: Element | null = this.host;\n    while (element) {\n      if (element.tagName === 'ATOMIC-SEARCH-INTERFACE') {\n        return true;\n      }\n      element = element.parentElement;\n    }\n    return false;\n  }\n\n  connectedCallback() {\n    this.id = randomID('atomic-aria-live-');\n  }\n\n  /**\n   * @internal\n   */\n  @Method()\n  public async updateMessage(\n    region: string,\n    message: string,\n    assertive: boolean\n  ) {\n    const updateRegion = () =>\n      (this.regions = {...this.regions, [region]: {assertive, message}});\n\n    if (message) {\n      this.messagesQueue.enqueue(updateRegion, region);\n    } else {\n      this.messagesQueue.cancelActionIfQueued(region);\n      updateRegion();\n    }\n  }\n\n  /**\n   * @internal\n   */\n  @Method()\n  public async registerRegion(region: string, assertive: boolean) {\n    if (region in this.regions) {\n      return;\n    }\n    this.regions = {...this.regions, [region]: {assertive, message: ''}};\n  }\n\n  public disconnectedCallback() {\n    this.messagesQueue.clear();\n  }\n\n  public render() {\n    return (\n      <Host\n        style={{\n          position: 'absolute',\n          display: 'block',\n          height: '0',\n          overflow: 'hidden',\n          margin: '0',\n        }}\n      >\n        {Object.entries(this.regions).map(\n          ([regionName, {assertive, message}]) => (\n            <div\n              key={regionName}\n              id={`${this.id}-${regionName}`}\n              aria-live={assertive ? 'assertive' : 'polite'}\n              role=\"status\"\n            >\n              {message}\n            </div>\n          )\n        )}\n      </Host>\n    );\n  }\n}\n"],"version":3}

package/dist/atomic/components/components/commerce/atomic-product-description/atomic-product-description.js

@@ -1,149 +0,0 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-import { Schema, StringValue } from '@coveo/bueno';
-import { html, LitElement, nothing, unsafeCSS } from 'lit';
-import { customElement, property, state } from 'lit/decorators.js';
-import { createRef } from 'lit/directives/ref.js';
-import { booleanConverter } from "../../../converters/boolean-converter.js";
-import { bindingGuard } from "../../../decorators/binding-guard.js";
-import { bindings } from "../../../decorators/bindings.js";
-import { createProductContextController } from "../../../decorators/commerce/product-template-decorators.js";
-import { errorGuard } from "../../../decorators/error-guard.js";
-import { injectStylesForNoShadowDOM } from "../../../decorators/inject-styles-for-no-shadow-dom.js";
-import { withTailwindStyles } from "../../../decorators/with-tailwind-styles.js";
-import { renderExpandableText, } from '../../common/expandable-text/expandable-text.js';
-import styles from './atomic-product-description.tw.css';
-import '../atomic-product-text/atomic-product-text.js';
-/**
- * The `atomic-product-description` component renders the description of a product.
- *
- * @part expandable-text - The part that contains the product description text.
- */
-let AtomicProductDescription = class AtomicProductDescription extends LitElement {
-    initialize() { }
-    constructor() {
-        super();
-        this.productController = createProductContextController(this);
-        this.isExpanded = false;
-        this.isTruncated = false;
-        this.descriptionRef = createRef();
-        /**
-         * The number of lines after which the product description should be truncated. A value of "none" will disable truncation.
-         */
-        this.truncateAfter = '2';
-        /**
-         * The name of the description field to use.
-         */
-        this.field = 'ec_shortdesc';
-        /**
-         * Whether the description should be collapsible after being expanded.
-         */
-        this.isCollapsible = true;
-        this.onToggleExpand = (e) => {
-            if (e) {
-                e.stopPropagation();
-            }
-            this.isExpanded = !this.isExpanded;
-        };
-        this.resizeObserver = new ResizeObserver(() => {
-            if (this.descriptionRef.value) {
-                this.isTruncated =
-                    this.descriptionRef.value.scrollHeight >
-                        this.descriptionRef.value.clientHeight;
-            }
-        });
-    }
-    validateProps() {
-        new Schema({
-            truncateAfter: new StringValue({
-                constrainTo: ['none', '1', '2', '3', '4'],
-            }),
-            field: new StringValue({
-                constrainTo: ['ec_shortdesc', 'ec_description'],
-            }),
-        }).validate({
-            truncateAfter: this.truncateAfter,
-            field: this.field,
-        });
-    }
-    updated(changedProperties) {
-        super.updated(changedProperties);
-        if (changedProperties.has('truncateAfter') ||
-            changedProperties.has('field')) {
-            this.validateProps();
-        }
-    }
-    firstUpdated() {
-        if (this.descriptionRef.value) {
-            this.resizeObserver.observe(this.descriptionRef.value);
-        }
-    }
-    disconnectedCallback() {
-        super.disconnectedCallback();
-        this.resizeObserver.disconnect();
-    }
-    get product() {
-        return this.productController.item;
-    }
-    render() {
-        const productDescription = this.product?.[this.field] ?? null;
-        if (!productDescription) {
-            return html `${nothing}`;
-        }
-        return html `${renderExpandableText({
-            props: {
-                isExpanded: this.isExpanded,
-                isTruncated: this.isTruncated,
-                truncateAfter: this.truncateAfter,
-                onToggleExpand: this.onToggleExpand,
-                showMoreLabel: this.bindings.i18n.t('show-more'),
-                showLessLabel: this.bindings.i18n.t('show-less'),
-                isCollapsible: this.isCollapsible,
-                textRef: this.descriptionRef,
-            },
-        })(html `
-      <atomic-product-text field=${this.field}></atomic-product-text>
-    `)}`;
-    }
-};
-AtomicProductDescription.styles = unsafeCSS(styles);
-__decorate([
-    state()
-], AtomicProductDescription.prototype, "bindings", void 0);
-__decorate([
-    state()
-], AtomicProductDescription.prototype, "isExpanded", void 0);
-__decorate([
-    state()
-], AtomicProductDescription.prototype, "isTruncated", void 0);
-__decorate([
-    property({
-        type: String,
-        attribute: 'truncate-after',
-    })
-], AtomicProductDescription.prototype, "truncateAfter", void 0);
-__decorate([
-    property()
-], AtomicProductDescription.prototype, "field", void 0);
-__decorate([
-    property({
-        type: Boolean,
-        converter: booleanConverter,
-        attribute: 'is-collapsible',
-    })
-], AtomicProductDescription.prototype, "isCollapsible", void 0);
-__decorate([
-    errorGuard(),
-    bindingGuard()
-], AtomicProductDescription.prototype, "render", null);
-AtomicProductDescription = __decorate([
-    customElement('atomic-product-description'),
-    withTailwindStyles,
-    injectStylesForNoShadowDOM,
-    bindings()
-], AtomicProductDescription);
-export { AtomicProductDescription };

package/dist/atomic/components/components/commerce/atomic-product-description/atomic-product-description.tw.css.js

@@ -1,3 +0,0 @@
-const css = `/*! tailwindcss v4.1.11 | MIT License | https://tailwindcss.com */
-.expandable-text{line-height:var(--line-height)}.min-lines-1{min-height:calc(var(--line-height)*1)}.min-lines-2{min-height:calc(var(--line-height)*2)}.min-lines-3{min-height:calc(var(--line-height)*3)}.min-lines-4{min-height:calc(var(--line-height)*4)}`;
-export default [css];