@empathyco/x-components 8.4.0 → 8.6.0

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [8.6.0](https://github.com/empathyco/x/compare/@empathyco/x-components@8.5.0...@empathyco/x-components@8.6.0) (2026-07-17)
+
+### Features
+
+* **vendor:** vendor banner events (#2140)
+
+
+## [8.5.0](https://github.com/empathyco/x/compare/@empathyco/x-components@8.4.0...@empathyco/x-components@8.5.0) (2026-07-16)
+
+### Features
+
+* **vendor:** banners (#2136)
+
+
 ## [8.4.0](https://github.com/empathyco/x/compare/@empathyco/x-components@8.3.0...@empathyco/x-components@8.4.0) (2026-07-16)
 
 ### Features

package/core/index.js.map

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

package/docs/API-reference/api/x-components.banner.md

@@ -17,6 +17,10 @@ _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
         required: true;
     };
     titleClass: StringConstructor;
+    clickEvent: {
+        type: PropType<XEvent>;
+        default: string;
+    };
 }>, {
     imageFailed: import("vue").Ref<boolean, boolean>;
     anchorEvents: () => Partial<{ [key in keyof GlobalEventHandlersEventMap]: () => void; }>;
@@ -26,5 +30,11 @@ _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
         required: true;
     };
     titleClass: StringConstructor;
-}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>
+    clickEvent: {
+        type: PropType<XEvent>;
+        default: string;
+    };
+}>> & Readonly<{}>, {
+    clickEvent: keyof import("../../../wiring").XEventsTypes;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>
 ```

package/docs/API-reference/api/x-components.hierarchicalfilter.md

@@ -213,6 +213,9 @@ _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
         UserViewedAVendorResult?: import("../../../vendor").VendorResult | undefined;
         UserClickedAVendorResult?: import("../../../vendor").VendorResult | undefined;
         UserClickedVendorResultAddToCart?: import("../../../vendor").VendorResult | undefined;
+        VendorBannersChanged?: Omit<import("../../../vendor").VendorBanner, "modelName">[] | undefined;
+        UserViewedAVendorBanner?: import("../../../vendor").VendorBanner | undefined;
+        UserClickedAVendorBanner?: import("../../../vendor").VendorBanner | undefined;
     }>;
     innerCssClasses: import("vue").ComputedRef<(string | Dictionary<boolean>)[]>;
     renderedChildrenFilters: import("vue").ComputedRef<HierarchicalFilterModel[]>;

package/docs/API-reference/api/x-components.md

@@ -3384,6 +3384,28 @@ Alias to facilitate retrieving the modules with status.
 </td><td>
 
 
+</td></tr>
+<tr><td>
+
+[VendorBanner](./x-components.vendorbanner.md)
+
+
+</td><td>
+
+The interface for a vendor banner, extending the base Banner interface. The optional position means: - If the position is defined, the banner will be displayed in that position inside the grid. - If the position is undefined, the banner will be displayed on top of the grid and full width.
+
+
+</td></tr>
+<tr><td>
+
+[VendorBannerTagging](./x-components.vendorbannertagging.md)
+
+
+</td><td>
+
+The tagging info for a vendor banner.
+
+
 </td></tr>
 <tr><td>
 
@@ -6734,6 +6756,17 @@ Default implementation for the [HistoryQueriesGetters.sessionHistoryQueries](./x
 Default implementation setUrlParams.
 
 
+</td></tr>
+<tr><td>
+
+[setBanners](./x-components.setbanners.md)
+
+
+</td><td>
+
+Sets the vendor banners of the [VendorXModule](./x-components.vendorxmodule.md)<!-- -->.
+
+
 </td></tr>
 <tr><td>
 
@@ -8111,6 +8144,21 @@ URL [XModule](./x-components.xmodule.md) implementation. This module is auto-reg
 Function which returns the requested getter's properties as a dictionary.
 
 
+</td></tr>
+<tr><td>
+
+[VendorBannersList](./x-components.vendorbannerslist.md)
+
+
+</td><td>
+
+It renders a [ItemsList](./x-components.itemslist.md) list of vendor banners from [VendorState.banners](./x-components.vendorstate.banners.md)<!-- -->.
+
+The component provides a default slot which wraps the whole component with the `vendorBanners` plus the `injectedListItems` which also contains the injected list items from the ancestor.
+
+It also provides the parent slots to customize the items.
+
+
 </td></tr>
 <tr><td>
 

package/docs/API-reference/api/x-components.setbanners.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [setBanners](./x-components.setbanners.md)
+
+## setBanners variable
+
+Sets the vendor banners of the [VendorXModule](./x-components.vendorxmodule.md)<!-- -->.
+
+**Signature:**
+
+```typescript
+setBanners: import("../../wiring").AnyWire
+```

package/docs/API-reference/api/x-components.simplefilter.md

@@ -210,6 +210,9 @@ _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
         UserViewedAVendorResult?: import("../../../vendor").VendorResult | undefined;
         UserClickedAVendorResult?: import("../../../vendor").VendorResult | undefined;
         UserClickedVendorResultAddToCart?: import("../../../vendor").VendorResult | undefined;
+        VendorBannersChanged?: Omit<import("../../../vendor").VendorBanner, "modelName">[] | undefined;
+        UserViewedAVendorBanner?: import("../../../vendor").VendorBanner | undefined;
+        UserClickedAVendorBanner?: import("../../../vendor").VendorBanner | undefined;
     }>;
     innerCssClasses: import("vue").ComputedRef<(string | Dictionary<boolean>)[]>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{

package/docs/API-reference/api/x-components.snippetcallbacks.md

@@ -200,6 +200,9 @@ _default: import("vue").DefineComponent<{}, {
         UserViewedAVendorResult: (payload: import("..").VendorResult, metadata: WireMetadata) => unknown;
         UserClickedAVendorResult: (payload: import("..").VendorResult, metadata: WireMetadata) => unknown;
         UserClickedVendorResultAddToCart: (payload: import("..").VendorResult, metadata: WireMetadata) => unknown;
+        VendorBannersChanged: (payload: Omit<import("..").VendorBanner, "modelName">[], metadata: WireMetadata) => unknown;
+        UserViewedAVendorBanner: (payload: import("..").VendorBanner, metadata: WireMetadata) => unknown;
+        UserClickedAVendorBanner: (payload: import("..").VendorBanner, metadata: WireMetadata) => unknown;
     }>>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {
     GlobalXBus: import("vue").DefineComponent<{}, {}, any>;

package/docs/API-reference/api/x-components.vendorbanner.md

@@ -0,0 +1,78 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [VendorBanner](./x-components.vendorbanner.md)
+
+## VendorBanner interface
+
+The interface for a vendor banner, extending the base Banner interface. The optional position means: - If the position is defined, the banner will be displayed in that position inside the grid. - If the position is undefined, the banner will be displayed on top of the grid and full width.
+
+**Signature:**
+
+```typescript
+export interface VendorBanner extends Omit<Banner, 'modelName' | 'tagging'>, NamedModel<'VendorBanner'> 
+```
+**Extends:** Omit&lt;Banner, 'modelName' \| 'tagging'&gt;, NamedModel&lt;'VendorBanner'&gt;
+
+## Properties
+
+<table><thead><tr><th>
+
+Property
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[position?](./x-components.vendorbanner.position.md)
+
+
+</td><td>
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+_(Optional)_
+
+
+</td></tr>
+<tr><td>
+
+[tagging?](./x-components.vendorbanner.tagging.md)
+
+
+</td><td>
+
+
+</td><td>
+
+[VendorBannerTagging](./x-components.vendorbannertagging.md)
+
+
+</td><td>
+
+_(Optional)_
+
+
+</td></tr>
+</tbody></table>
+

package/docs/API-reference/api/x-components.vendorbanner.position.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [VendorBanner](./x-components.vendorbanner.md) &gt; [position](./x-components.vendorbanner.position.md)
+
+## VendorBanner.position property
+
+**Signature:**
+
+```typescript
+position?: number;
+```

package/docs/API-reference/api/x-components.vendorbanner.tagging.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [VendorBanner](./x-components.vendorbanner.md) &gt; [tagging](./x-components.vendorbanner.tagging.md)
+
+## VendorBanner.tagging property
+
+**Signature:**
+
+```typescript
+tagging?: VendorBannerTagging;
+```

package/docs/API-reference/api/x-components.vendorbannerslist.md

@@ -0,0 +1,31 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [VendorBannersList](./x-components.vendorbannerslist.md)
+
+## VendorBannersList variable
+
+It renders a [ItemsList](./x-components.itemslist.md) list of vendor banners from [VendorState.banners](./x-components.vendorstate.banners.md)<!-- -->.
+
+The component provides a default slot which wraps the whole component with the `vendorBanners` plus the `injectedListItems` which also contains the injected list items from the ancestor.
+
+It also provides the parent slots to customize the items.
+
+**Signature:**
+
+```typescript
+_default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    animation: {
+        type: (StringConstructor | ObjectConstructor | FunctionConstructor)[];
+        default: string;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    animation: {
+        type: (StringConstructor | ObjectConstructor | FunctionConstructor)[];
+        default: string;
+    };
+}>> & Readonly<{}>, {
+    animation: string | Function | Record<string, any>;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>
+```

package/docs/API-reference/api/x-components.vendorbannertagging.clickurl.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [VendorBannerTagging](./x-components.vendorbannertagging.md) &gt; [clickUrl](./x-components.vendorbannertagging.clickurl.md)
+
+## VendorBannerTagging.clickUrl property
+
+**Signature:**
+
+```typescript
+clickUrl: string;
+```

package/docs/API-reference/api/x-components.vendorbannertagging.md

@@ -0,0 +1,73 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [VendorBannerTagging](./x-components.vendorbannertagging.md)
+
+## VendorBannerTagging interface
+
+The tagging info for a vendor banner.
+
+**Signature:**
+
+```typescript
+export interface VendorBannerTagging 
+```
+
+## Properties
+
+<table><thead><tr><th>
+
+Property
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[clickUrl](./x-components.vendorbannertagging.clickurl.md)
+
+
+</td><td>
+
+
+</td><td>
+
+string
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+[viewUrl](./x-components.vendorbannertagging.viewurl.md)
+
+
+</td><td>
+
+
+</td><td>
+
+string
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>
+

package/docs/API-reference/api/x-components.vendorbannertagging.viewurl.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [VendorBannerTagging](./x-components.vendorbannertagging.md) &gt; [viewUrl](./x-components.vendorbannertagging.viewurl.md)
+
+## VendorBannerTagging.viewUrl property
+
+**Signature:**
+
+```typescript
+viewUrl: string;
+```

package/docs/API-reference/api/x-components.vendormutations.md

@@ -35,6 +35,23 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
+[setBanners](./x-components.vendormutations.setbanners.md)
+
+
+</td><td>
+
+
+</td><td>
+
+(banners: [VendorBanner](./x-components.vendorbanner.md)<!-- -->\[\]) =&gt; void
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
 [setResults](./x-components.vendormutations.setresults.md)
 
 

package/docs/API-reference/api/x-components.vendormutations.setbanners.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [VendorMutations](./x-components.vendormutations.md) &gt; [setBanners](./x-components.vendormutations.setbanners.md)
+
+## VendorMutations.setBanners property
+
+**Signature:**
+
+```typescript
+setBanners: (banners: VendorBanner[]) => void;
+```

package/docs/API-reference/api/x-components.vendorstate.banners.md

@@ -0,0 +1,11 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [VendorState](./x-components.vendorstate.md) &gt; [banners](./x-components.vendorstate.banners.md)
+
+## VendorState.banners property
+
+**Signature:**
+
+```typescript
+banners: VendorBanner[];
+```

package/docs/API-reference/api/x-components.vendorstate.md

@@ -35,6 +35,23 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
+[banners](./x-components.vendorstate.banners.md)
+
+
+</td><td>
+
+
+</td><td>
+
+[VendorBanner](./x-components.vendorbanner.md)<!-- -->\[\]
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
 [results](./x-components.vendorstate.results.md)
 
 

package/docs/API-reference/api/x-components.vendorxevents.md

@@ -37,6 +37,25 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
+[UserClickedAVendorBanner](./x-components.vendorxevents.userclickedavendorbanner.md)
+
+
+</td><td>
+
+
+</td><td>
+
+[VendorBanner](./x-components.vendorbanner.md)
+
+
+</td><td>
+
+The user clicked on a vendor banner. Payload: The [vendor banner](./x-components.vendorbanner.md) that was clicked.
+
+
+</td></tr>
+<tr><td>
+
 [UserClickedAVendorResult](./x-components.vendorxevents.userclickedavendorresult.md)
 
 
@@ -72,6 +91,25 @@ The user clicked on a vendor result. Payload: The [vendor result](./x-components
 The user clicked on the add to cart button of a vendor result. Payload: The [vendor result](./x-components.vendorresult.md) that was clicked.
 
 
+</td></tr>
+<tr><td>
+
+[UserViewedAVendorBanner](./x-components.vendorxevents.userviewedavendorbanner.md)
+
+
+</td><td>
+
+
+</td><td>
+
+[VendorBanner](./x-components.vendorbanner.md)
+
+
+</td><td>
+
+The user viewed a vendor banner. Payload: The [vendor banner](./x-components.vendorbanner.md) that was viewed.
+
+
 </td></tr>
 <tr><td>
 
@@ -91,6 +129,25 @@ The user clicked on the add to cart button of a vendor result. Payload: The [ven
 The user viewed a vendor result. Payload: The [vendor result](./x-components.vendorresult.md) that was viewed.
 
 
+</td></tr>
+<tr><td>
+
+[VendorBannersChanged](./x-components.vendorxevents.vendorbannerschanged.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Omit&lt;[VendorBanner](./x-components.vendorbanner.md)<!-- -->, 'modelName'&gt;\[\]
+
+
+</td><td>
+
+The x consumer has provided vendor banners to be inserted in the result grid. Payload: The array of vendor banner inputs with their items and positions. modelName is excluded since it is an internal field, and we will assign it under the hood.
+
+
 </td></tr>
 <tr><td>
 

package/docs/API-reference/api/x-components.vendorxevents.userclickedavendorbanner.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [VendorXEvents](./x-components.vendorxevents.md) &gt; [UserClickedAVendorBanner](./x-components.vendorxevents.userclickedavendorbanner.md)
+
+## VendorXEvents.UserClickedAVendorBanner property
+
+The user clicked on a vendor banner. Payload: The [vendor banner](./x-components.vendorbanner.md) that was clicked.
+
+**Signature:**
+
+```typescript
+UserClickedAVendorBanner: VendorBanner;
+```

package/docs/API-reference/api/x-components.vendorxevents.userviewedavendorbanner.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [VendorXEvents](./x-components.vendorxevents.md) &gt; [UserViewedAVendorBanner](./x-components.vendorxevents.userviewedavendorbanner.md)
+
+## VendorXEvents.UserViewedAVendorBanner property
+
+The user viewed a vendor banner. Payload: The [vendor banner](./x-components.vendorbanner.md) that was viewed.
+
+**Signature:**
+
+```typescript
+UserViewedAVendorBanner: VendorBanner;
+```

package/docs/API-reference/api/x-components.vendorxevents.vendorbannerschanged.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [VendorXEvents](./x-components.vendorxevents.md) &gt; [VendorBannersChanged](./x-components.vendorxevents.vendorbannerschanged.md)
+
+## VendorXEvents.VendorBannersChanged property
+
+The x consumer has provided vendor banners to be inserted in the result grid. Payload: The array of vendor banner inputs with their items and positions. modelName is excluded since it is an internal field, and we will assign it under the hood.
+
+**Signature:**
+
+```typescript
+VendorBannersChanged: Omit<VendorBanner, 'modelName'>[];
+```

package/docs/API-reference/api/x-types.banner.md

@@ -9,9 +9,9 @@ A banner is an image with a title, that when clicked redirect the user to an URL
 **Signature:**
 
 ```typescript
-export interface Banner extends NamedModel<'Banner'>, Identifiable, Taggable 
+export interface Banner extends NamedModel<'Banner' | 'VendorBanner'>, Identifiable, Taggable 
 ```
-**Extends:** [NamedModel](./x-types.namedmodel.md)<!-- -->&lt;'Banner'&gt;, [Identifiable](./x-types.identifiable.md)<!-- -->, [Taggable](./x-types.taggable.md)
+**Extends:** [NamedModel](./x-types.namedmodel.md)<!-- -->&lt;'Banner' \| 'VendorBanner'&gt;, [Identifiable](./x-types.identifiable.md)<!-- -->, [Taggable](./x-types.taggable.md)
 
 ## Properties
 

package/docs/API-reference/components/search/x-components.banner.md

@@ -8,17 +8,19 @@ title: Banner
 
 ## Props
 
-| Name                    | Description      | Type                     | Default       |
-| ----------------------- | ---------------- | ------------------------ | ------------- |
-| <code>banner</code>     | The banner data. | <code>BannerModel</code> | <code></code> |
-| <code>titleClass</code> |                  | <code>string</code>      | <code></code> |
+| Name                    | Description                               | Type                     | Default                           |
+| ----------------------- | ----------------------------------------- | ------------------------ | --------------------------------- |
+| <code>banner</code>     | The banner data.                          | <code>BannerModel</code> | <code></code>                     |
+| <code>titleClass</code> |                                           | <code>string</code>      | <code></code>                     |
+| <code>clickEvent</code> | Event to emit when the banner is clicked. | <code>XEvent</code>      | <code>'UserClickedABanner'</code> |
 
 ## Events
 
 This component emits the following event:
 
-- [`UserClickedABanner`](https://github.com/empathyco/x/blob/main/packages/x-components/src/wiring/events.types.ts):
-  emitted when the user clicks the banner (if it has a URL).
+- `clickEvent` (default `UserClickedABanner`):
+  emitted when the user clicks the banner (if it has a URL). The event name can be customized
+  via the `clickEvent` prop.
 
 ## See it in action
 

package/docs/API-reference/components/vendor/x-components.vendor-banners-list.md

@@ -0,0 +1,21 @@
+---
+
+title: VendorBannersList
+
+---
+
+# VendorBannersList
+
+It renders a ItemsList list of vendor banners from VendorState.banners.
+
+The component provides a default slot which wraps the whole component with the `vendorBanners`
+plus the `injectedListItems` which also contains the injected list items from
+the ancestor.
+
+It also provides the parent slots to customize the items.
+
+## Props
+
+| Name                   | Description                                                          | Type                       | Default           |
+| ---------------------- | -------------------------------------------------------------------- | -------------------------- | ----------------- |
+| <code>animation</code> | Animation component that will be used to animate the vendor banners. | <code>AnimationProp</code> | <code>'ul'</code> |