@empathyco/x-components 8.11.0 → 8.12.1

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.12.1](https://github.com/empathyco/x/compare/@empathyco/x-components@8.12.0...@empathyco/x-components@8.12.1) (2026-08-21)
+
+### Bug Fixes
+
+* **x-installer:** update uiLang values to BCP 47 format in tests and API types (#2155)
+
+
+## [8.12.0](https://github.com/empathyco/x/compare/@empathyco/x-components@8.11.0...@empathyco/x-components@8.12.0) (2026-08-04)
+
+### Features
+
+* **vendor:** integrate vendor results and banners into query previews (#2149)
+
+
 ## [8.11.0](https://github.com/empathyco/x/compare/@empathyco/x-components@8.10.0...@empathyco/x-components@8.11.0) (2026-08-04)
 
 ### Features

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

@@ -216,6 +216,14 @@ _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
         UserClickedAVendorResult?: import("../../../vendor").VendorResult | undefined;
         UserClickedVendorResultAddToCart?: import("../../../vendor").VendorResult | undefined;
         VendorBannersChanged?: Omit<import("../../../vendor").VendorBanner, "modelName">[] | undefined;
+        QueryPreviewVendorResultsChanged?: {
+            queryPreviewHash: string;
+            results: Omit<import("../../../vendor").VendorResult, "modelName">[];
+        } | undefined;
+        QueryPreviewVendorBannersChanged?: {
+            queryPreviewHash: string;
+            banners: Omit<import("../../../vendor").VendorBanner, "modelName">[];
+        } | undefined;
         VendorBannerMounted?: import("../../../vendor").VendorBanner | undefined;
         UserViewedAVendorBanner?: import("../../../vendor").VendorBanner | undefined;
         UserClickedAVendorBanner?: import("../../../vendor").VendorBanner | undefined;

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

@@ -3424,6 +3424,17 @@ The tagging info for a vendor banner.
 </td><td>
 
 
+</td></tr>
+<tr><td>
+
+[VendorQueryPreview](./x-components.vendorquerypreview.md)
+
+
+</td><td>
+
+The vendor results and banners of a query preview, indexed by its query preview hash.
+
+
 </td></tr>
 <tr><td>
 
@@ -7152,6 +7163,28 @@ Sets the query of the facets module from a queryPreview.
 Sets the query taking the [SearchXEvents.SearchResponseChanged](./x-components.searchxevents.searchresponsechanged.md) payload.
 
 
+</td></tr>
+<tr><td>
+
+[setQueryPreviewVendorBanners](./x-components.setquerypreviewvendorbanners.md)
+
+
+</td><td>
+
+Sets the vendor banners of a query preview in the [VendorXModule](./x-components.vendorxmodule.md)<!-- -->.
+
+
+</td></tr>
+<tr><td>
+
+[setQueryPreviewVendorResults](./x-components.setquerypreviewvendorresults.md)
+
+
+</td><td>
+
+Sets the vendor results of a query preview in the [VendorXModule](./x-components.vendorxmodule.md)<!-- -->.
+
+
 </td></tr>
 <tr><td>
 
@@ -8178,6 +8211,8 @@ It renders a [ItemsList](./x-components.itemslist.md) list of vendor banners fro
 
 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.
 
+If the `queryPreviewHash` prop is provided, the vendor banners are retrieved from [VendorState.queryPreviews](./x-components.vendorstate.querypreviews.md)<!-- -->, scoped to the query preview.
+
 It also provides the parent slots to customize the items.
 
 
@@ -8193,6 +8228,8 @@ It renders a [ItemsList](./x-components.itemslist.md) of vendor results from [Ve
 
 The component provides a default slot which wraps the whole component with the `vendorResults` plus the `injectedListItems` which also contains the injected list items from the ancestor.
 
+If the `queryPreviewHash` prop is provided, the vendor results are retrieved from [VendorState.queryPreviews](./x-components.vendorstate.querypreviews.md)<!-- -->, scoped to the query preview.
+
 It also provides the parent slots to customize the items.
 
 

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

@@ -34,9 +34,11 @@ _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
         default: string;
     };
 }>, {
+    params: import("vue").ComputedRef<import("@empathyco/x-utils").Dictionary<unknown>>;
     renderedQueryPreviews: import("vue").ComputedRef<QueryPreviewInfo[]>;
     flagAsFailed: (failedQuery: string) => void;
     flagAsLoaded: (loadedQuery: string) => void;
+    getHashFromQueryPreviewInfo: (queryPreviewInfo: QueryPreviewInfo, extraParams: import("@empathyco/x-utils").Dictionary<unknown>) => string;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     queriesPreviewInfo: {
         type: PropType<QueryPreviewInfo[]>;

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

@@ -0,0 +1,16 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [setQueryPreviewVendorBanners](./x-components.setquerypreviewvendorbanners.md)
+
+## setQueryPreviewVendorBanners variable
+
+Sets the vendor banners of a query preview in the [VendorXModule](./x-components.vendorxmodule.md)<!-- -->.
+
+**Signature:**
+
+```typescript
+setQueryPreviewVendorBanners: import("../../wiring").Wire<{
+    queryPreviewHash: string;
+    banners: Omit<import("./types").VendorBanner, "modelName">[];
+}>
+```

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

@@ -0,0 +1,16 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [setQueryPreviewVendorResults](./x-components.setquerypreviewvendorresults.md)
+
+## setQueryPreviewVendorResults variable
+
+Sets the vendor results of a query preview in the [VendorXModule](./x-components.vendorxmodule.md)<!-- -->.
+
+**Signature:**
+
+```typescript
+setQueryPreviewVendorResults: import("../../wiring").Wire<{
+    queryPreviewHash: string;
+    results: Omit<import("./types").VendorResult, "modelName">[];
+}>
+```

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

@@ -213,6 +213,14 @@ _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
         UserClickedAVendorResult?: import("../../../vendor").VendorResult | undefined;
         UserClickedVendorResultAddToCart?: import("../../../vendor").VendorResult | undefined;
         VendorBannersChanged?: Omit<import("../../../vendor").VendorBanner, "modelName">[] | undefined;
+        QueryPreviewVendorResultsChanged?: {
+            queryPreviewHash: string;
+            results: Omit<import("../../../vendor").VendorResult, "modelName">[];
+        } | undefined;
+        QueryPreviewVendorBannersChanged?: {
+            queryPreviewHash: string;
+            banners: Omit<import("../../../vendor").VendorBanner, "modelName">[];
+        } | undefined;
         VendorBannerMounted?: import("../../../vendor").VendorBanner | undefined;
         UserViewedAVendorBanner?: import("../../../vendor").VendorBanner | undefined;
         UserClickedAVendorBanner?: import("../../../vendor").VendorBanner | undefined;

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

@@ -203,6 +203,14 @@ _default: import("vue").DefineComponent<{}, {
         UserClickedAVendorResult: (payload: import("..").VendorResult, metadata: WireMetadata) => unknown;
         UserClickedVendorResultAddToCart: (payload: import("..").VendorResult, metadata: WireMetadata) => unknown;
         VendorBannersChanged: (payload: Omit<import("..").VendorBanner, "modelName">[], metadata: WireMetadata) => unknown;
+        QueryPreviewVendorResultsChanged: (payload: {
+            queryPreviewHash: string;
+            results: Omit<import("..").VendorResult, "modelName">[];
+        }, metadata: WireMetadata) => unknown;
+        QueryPreviewVendorBannersChanged: (payload: {
+            queryPreviewHash: string;
+            banners: Omit<import("..").VendorBanner, "modelName">[];
+        }, metadata: WireMetadata) => unknown;
         VendorBannerMounted: (payload: import("..").VendorBanner, metadata: WireMetadata) => unknown;
         UserViewedAVendorBanner: (payload: import("..").VendorBanner, metadata: WireMetadata) => unknown;
         UserClickedAVendorBanner: (payload: import("..").VendorBanner, metadata: WireMetadata) => unknown;

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

@@ -4,7 +4,7 @@
 
 ## SnippetConfig.lang property
 
-Language for the API request, and default value for [SnippetConfig.uiLang](./x-components.snippetconfig.uilang.md)<!-- -->.
+Language for the API request. ISO 639-1 format. Ex: 'es', 'en', 'fr', etc.
 
 **Signature:**
 

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

@@ -202,7 +202,7 @@ string
 
 </td><td>
 
-Language for the API request, and default value for [SnippetConfig.uiLang](./x-components.snippetconfig.uilang.md)<!-- -->.
+Language for the API request. ISO 639-1 format. Ex: 'es', 'en', 'fr', etc.
 
 
 </td></tr>
@@ -278,7 +278,7 @@ string
 
 </td><td>
 
-_(Optional)_ Language to use for the messages. Defaults to [SnippetConfig.lang](./x-components.snippetconfig.lang.md)<!-- -->.
+_(Optional)_ Language to use for the messages. BCP 47 format. Ex: 'es-ES', 'es-MX', 'en-US', 'fr-FR', etc.
 
 
 </td></tr>

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

@@ -4,7 +4,7 @@
 
 ## SnippetConfig.uiLang property
 
-Language to use for the messages. Defaults to [SnippetConfig.lang](./x-components.snippetconfig.lang.md)<!-- -->.
+Language to use for the messages. BCP 47 format. Ex: 'es-ES', 'es-MX', 'en-US', 'fr-FR', etc.
 
 **Signature:**
 

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

@@ -8,6 +8,8 @@ It renders a [ItemsList](./x-components.itemslist.md) list of vendor banners fro
 
 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.
 
+If the `queryPreviewHash` prop is provided, the vendor banners are retrieved from [VendorState.queryPreviews](./x-components.vendorstate.querypreviews.md)<!-- -->, scoped to the query preview.
+
 It also provides the parent slots to customize the items.
 
 **Signature:**
@@ -18,6 +20,10 @@ _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
         type: (StringConstructor | ObjectConstructor | FunctionConstructor)[];
         default: string;
     };
+    queryPreviewHash: {
+        type: StringConstructor;
+        default: undefined;
+    };
 }>, () => 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<{
@@ -25,7 +31,12 @@ _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
         type: (StringConstructor | ObjectConstructor | FunctionConstructor)[];
         default: string;
     };
+    queryPreviewHash: {
+        type: StringConstructor;
+        default: undefined;
+    };
 }>> & Readonly<{}>, {
     animation: string | Function | Record<string, any>;
+    queryPreviewHash: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>
 ```

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

@@ -36,6 +36,25 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
+[removeQueryPreviewVendorData](./x-components.vendormutations.removequerypreviewvendordata.md)
+
+
+</td><td>
+
+
+</td><td>
+
+(queryPreviewHash: string) =&gt; void
+
+
+</td><td>
+
+Removes the vendor results and banners of a query preview.
+
+
+</td></tr>
+<tr><td>
+
 [resetState](./x-components.vendormutations.resetstate.md)
 
 
@@ -67,6 +86,44 @@ Description
 </td><td>
 
 
+</td></tr>
+<tr><td>
+
+[setQueryPreviewVendorBanners](./x-components.vendormutations.setquerypreviewvendorbanners.md)
+
+
+</td><td>
+
+
+</td><td>
+
+(payload: { queryPreviewHash: string; banners: Omit&lt;[VendorBanner](./x-components.vendorbanner.md)<!-- -->, 'modelName'&gt;\[\]; }) =&gt; void
+
+
+</td><td>
+
+Sets the vendor banners of a query preview.
+
+
+</td></tr>
+<tr><td>
+
+[setQueryPreviewVendorResults](./x-components.vendormutations.setquerypreviewvendorresults.md)
+
+
+</td><td>
+
+
+</td><td>
+
+(payload: { queryPreviewHash: string; results: Omit&lt;[VendorResult](./x-components.vendorresult.md)<!-- -->, 'modelName'&gt;\[\]; }) =&gt; void
+
+
+</td><td>
+
+Sets the vendor results of a query preview.
+
+
 </td></tr>
 <tr><td>
 

package/docs/API-reference/api/x-components.vendormutations.removequerypreviewvendordata.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; [VendorMutations](./x-components.vendormutations.md) &gt; [removeQueryPreviewVendorData](./x-components.vendormutations.removequerypreviewvendordata.md)
+
+## VendorMutations.removeQueryPreviewVendorData property
+
+Removes the vendor results and banners of a query preview.
+
+**Signature:**
+
+```typescript
+removeQueryPreviewVendorData: (queryPreviewHash: string) => void;
+```

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

@@ -0,0 +1,16 @@
+<!-- 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; [setQueryPreviewVendorBanners](./x-components.vendormutations.setquerypreviewvendorbanners.md)
+
+## VendorMutations.setQueryPreviewVendorBanners property
+
+Sets the vendor banners of a query preview.
+
+**Signature:**
+
+```typescript
+setQueryPreviewVendorBanners: (payload: {
+        queryPreviewHash: string;
+        banners: Omit<VendorBanner, 'modelName'>[];
+    }) => void;
+```

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

@@ -0,0 +1,16 @@
+<!-- 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; [setQueryPreviewVendorResults](./x-components.vendormutations.setquerypreviewvendorresults.md)
+
+## VendorMutations.setQueryPreviewVendorResults property
+
+Sets the vendor results of a query preview.
+
+**Signature:**
+
+```typescript
+setQueryPreviewVendorResults: (payload: {
+        queryPreviewHash: string;
+        results: Omit<VendorResult, 'modelName'>[];
+    }) => void;
+```

package/docs/API-reference/api/x-components.vendorquerypreview.banners.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; [VendorQueryPreview](./x-components.vendorquerypreview.md) &gt; [banners](./x-components.vendorquerypreview.banners.md)
+
+## VendorQueryPreview.banners property
+
+The vendor banners of the query preview.
+
+**Signature:**
+
+```typescript
+banners: VendorBanner[];
+```

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

@@ -0,0 +1,77 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [VendorQueryPreview](./x-components.vendorquerypreview.md)
+
+## VendorQueryPreview interface
+
+The vendor results and banners of a query preview, indexed by its query preview hash.
+
+**Signature:**
+
+```typescript
+export interface VendorQueryPreview 
+```
+
+## Properties
+
+<table><thead><tr><th>
+
+Property
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[banners](./x-components.vendorquerypreview.banners.md)
+
+
+</td><td>
+
+
+</td><td>
+
+[VendorBanner](./x-components.vendorbanner.md)<!-- -->\[\]
+
+
+</td><td>
+
+The vendor banners of the query preview.
+
+
+</td></tr>
+<tr><td>
+
+[results](./x-components.vendorquerypreview.results.md)
+
+
+</td><td>
+
+
+</td><td>
+
+[VendorResult](./x-components.vendorresult.md)<!-- -->\[\]
+
+
+</td><td>
+
+The vendor results of the query preview.
+
+
+</td></tr>
+</tbody></table>
+

package/docs/API-reference/api/x-components.vendorquerypreview.results.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; [VendorQueryPreview](./x-components.vendorquerypreview.md) &gt; [results](./x-components.vendorquerypreview.results.md)
+
+## VendorQueryPreview.results property
+
+The vendor results of the query preview.
+
+**Signature:**
+
+```typescript
+results: VendorResult[];
+```

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

@@ -8,6 +8,8 @@ It renders a [ItemsList](./x-components.itemslist.md) of vendor results from [Ve
 
 The component provides a default slot which wraps the whole component with the `vendorResults` plus the `injectedListItems` which also contains the injected list items from the ancestor.
 
+If the `queryPreviewHash` prop is provided, the vendor results are retrieved from [VendorState.queryPreviews](./x-components.vendorstate.querypreviews.md)<!-- -->, scoped to the query preview.
+
 It also provides the parent slots to customize the items.
 
 **Signature:**
@@ -18,6 +20,10 @@ _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
         type: (StringConstructor | ObjectConstructor | FunctionConstructor)[];
         default: string;
     };
+    queryPreviewHash: {
+        type: StringConstructor;
+        default: undefined;
+    };
 }>, () => 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<{
@@ -25,7 +31,12 @@ _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
         type: (StringConstructor | ObjectConstructor | FunctionConstructor)[];
         default: string;
     };
+    queryPreviewHash: {
+        type: StringConstructor;
+        default: undefined;
+    };
 }>> & Readonly<{}>, {
     animation: string | Function | Record<string, any>;
+    queryPreviewHash: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>
 ```

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

@@ -50,6 +50,25 @@ Description
 </td><td>
 
 
+</td></tr>
+<tr><td>
+
+[queryPreviews](./x-components.vendorstate.querypreviews.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Dictionary&lt;[VendorQueryPreview](./x-components.vendorquerypreview.md)<!-- -->&gt;
+
+
+</td><td>
+
+The vendor results and banners of the query previews, indexed by their query preview hash.
+
+
 </td></tr>
 <tr><td>
 

package/docs/API-reference/api/x-components.vendorstate.querypreviews.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; [VendorState](./x-components.vendorstate.md) &gt; [queryPreviews](./x-components.vendorstate.querypreviews.md)
+
+## VendorState.queryPreviews property
+
+The vendor results and banners of the query previews, indexed by their query preview hash.
+
+**Signature:**
+
+```typescript
+queryPreviews: Dictionary<VendorQueryPreview>;
+```

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

@@ -37,6 +37,44 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
+[QueryPreviewVendorBannersChanged](./x-components.vendorxevents.querypreviewvendorbannerschanged.md)
+
+
+</td><td>
+
+
+</td><td>
+
+{ queryPreviewHash: string; banners: 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 of a query preview. Payload: The query preview hash and the vendor banners to be inserted, without the `modelName` field, since it is assigned under the hood.
+
+
+</td></tr>
+<tr><td>
+
+[QueryPreviewVendorResultsChanged](./x-components.vendorxevents.querypreviewvendorresultschanged.md)
+
+
+</td><td>
+
+
+</td><td>
+
+{ queryPreviewHash: string; results: Omit&lt;[VendorResult](./x-components.vendorresult.md)<!-- -->, 'modelName'&gt;\[\]; }
+
+
+</td><td>
+
+The x consumer has provided vendor results to be inserted in the result grid of a query preview. Payload: The query preview hash and the vendor results to be inserted, without the `modelName` field, since it is assigned under the hood.
+
+
+</td></tr>
+<tr><td>
+
 [UserClickedAVendorBanner](./x-components.vendorxevents.userclickedavendorbanner.md)
 
 

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

@@ -0,0 +1,16 @@
+<!-- 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; [QueryPreviewVendorBannersChanged](./x-components.vendorxevents.querypreviewvendorbannerschanged.md)
+
+## VendorXEvents.QueryPreviewVendorBannersChanged property
+
+The x consumer has provided vendor banners to be inserted in the result grid of a query preview. Payload: The query preview hash and the vendor banners to be inserted, without the `modelName` field, since it is assigned under the hood.
+
+**Signature:**
+
+```typescript
+QueryPreviewVendorBannersChanged: {
+        queryPreviewHash: string;
+        banners: Omit<VendorBanner, 'modelName'>[];
+    };
+```

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

@@ -0,0 +1,16 @@
+<!-- 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; [QueryPreviewVendorResultsChanged](./x-components.vendorxevents.querypreviewvendorresultschanged.md)
+
+## VendorXEvents.QueryPreviewVendorResultsChanged property
+
+The x consumer has provided vendor results to be inserted in the result grid of a query preview. Payload: The query preview hash and the vendor results to be inserted, without the `modelName` field, since it is assigned under the hood.
+
+**Signature:**
+
+```typescript
+QueryPreviewVendorResultsChanged: {
+        queryPreviewHash: string;
+        results: Omit<VendorResult, 'modelName'>[];
+    };
+```

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

@@ -11,3 +11,8 @@ The vendor module query has changed. Payload: The new vendor query string.
 ```typescript
 VendorQueryChanged: string;
 ```
+
+## Remarks
+
+This event is also emitted when the module is registered, with the current query (which can be empty), to allow consumers to fetch the vendor results and banners even when there is no query yet.
+