@empathyco/x-components 7.4.1 → 8.0.0

package/CHANGELOG.md

@@ -3,6 +3,24 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [8.0.0](https://github.com/empathyco/x/compare/@empathyco/x-components@7.5.0...@empathyco/x-components@8.0.0) (2026-07-13)
+
+### ⚠ BREAKING CHANGES
+
+* Sorting components moved to x-components/src/components/sort. Now, sorting components can be used by the search and browse module by managing them through props.
+
+### Features
+
+* create sort components that could be shared between search and … (#2134)
+
+
+## [7.5.0](https://github.com/empathyco/x/compare/@empathyco/x-components@7.4.1...@empathyco/x-components@7.5.0) (2026-07-13)
+
+### Features
+
+* **vendor:** add support for vendor results (#2126)
+
+
 ## [7.4.1](https://github.com/empathyco/x/compare/@empathyco/x-components@7.4.0...@empathyco/x-components@7.4.1) (2026-07-08)
 
 **Note:** Version bump only for package @empathyco/x-components

package/browse/index.js

@@ -1,5 +1,4 @@
 export { default as BrowseResultsList } from '../js/x-modules/browse/components/browse-results-list.vue.js';
-export { default as BrowseSortPickerList } from '../js/x-modules/browse/components/browse-sort-picker-list.vue.js';
 export { cancelFetchAndSaveBrowseResponse, fetchAndSaveBrowseResponse } from '../js/x-modules/browse/store/actions/fetch-and-save-browse-response.action.js';
 export { fetchAndSaveResultsEnrichment as fetchAndSaveBrowseResultsEnrichment } from '../js/x-modules/browse/store/actions/fetch-and-save-results-enrichment.action.js';
 export { fetchBrowseResponse } from '../js/x-modules/browse/store/actions/fetch-browse-response.action.js';

package/core/index.js

@@ -145,6 +145,9 @@ export { default as BaseScroll } from '../js/components/scroll/base-scroll.vue.j
 export { useScroll } from '../js/components/scroll/use-scroll.js';
 export { default as SlidingPanel } from '../js/components/sliding-panel.vue.js';
 export { default as SnippetCallbacks } from '../js/components/snippet-callbacks.vue.js';
+export { default as SortDropdown } from '../js/components/sort/sort-dropdown.vue.js';
+export { default as SortList } from '../js/components/sort/sort-list.vue.js';
+export { default as SortPickerList } from '../js/components/sort/sort-picker-list.vue.js';
 export { default as BaseSuggestion } from '../js/components/suggestions/base-suggestion.vue.js';
 export { default as BaseSuggestions } from '../js/components/suggestions/base-suggestions.vue.js';
 export { getRootXComponent, getXComponentXModuleName, isXComponent } from '../js/components/x-component.utils.js';

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.baseaddtocart.md

@@ -15,7 +15,7 @@ _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
         required: true;
     };
 }>, {
-    events: import("vue").ComputedRef<Partial<XEventsTypes>>;
+    events: {};
     metadata: Omit<WireMetadata, "moduleName" | "origin" | "location">;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
     result: {

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

@@ -209,6 +209,7 @@ _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
         UserClickedAnAiCarouselResult?: import("@empathyco/x-types").Result | undefined;
         UserClickedAnAiCarouselAdd2Cart?: import("@empathyco/x-types").Result | undefined;
         AiComponentMounted?: void | undefined;
+        VendorResultsChanged?: Omit<import("../../../vendor").VendorResult, "modelName">[] | undefined;
     }>;
     innerCssClasses: import("vue").ComputedRef<(string | Dictionary<boolean>)[]>;
     renderedChildrenFilters: import("vue").ComputedRef<HierarchicalFilterModel[]>;

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

@@ -3375,6 +3375,64 @@ Alias to facilitate retrieving the modules with query.
 Alias to facilitate retrieving the modules with status.
 
 
+</td></tr>
+<tr><td>
+
+[VendorActions](./x-components.vendoractions.md)
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+[VendorGetters](./x-components.vendorgetters.md)
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+[VendorMutations](./x-components.vendormutations.md)
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+[VendorResult](./x-components.vendorresult.md)
+
+
+</td><td>
+
+The interface for a vendor result, extending the base Result interface.
+
+
+</td></tr>
+<tr><td>
+
+[VendorState](./x-components.vendorstate.md)
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+[VendorXEvents](./x-components.vendorxevents.md)
+
+
+</td><td>
+
+Directory of events for the vendor module.
+
+
 </td></tr>
 <tr><td>
 
@@ -4271,17 +4329,6 @@ The component provides a default slot which wraps the whole component with the `
 It also provides the slot result to customize the item, which is within the default slot, with the result bound.
 
 
-</td></tr>
-<tr><td>
-
-[BrowseSortPickerList](./x-components.browsesortpickerlist.md)
-
-
-</td><td>
-
-The `SortPickerList` component allows user to select the browse results order. This component also allows to change the selected sort programmatically.
-
-
 </td></tr>
 <tr><td>
 
@@ -7184,6 +7231,17 @@ Sets the related tags state `query`<!-- -->.
 Sets the related tags state `query` from a selectedQueryPreview's query.
 
 
+</td></tr>
+<tr><td>
+
+[setResults](./x-components.setresults.md)
+
+
+</td><td>
+
+Sets the vendor results of the [VendorXModule](./x-components.vendorxmodule.md)<!-- -->.
+
+
 </td></tr>
 <tr><td>
 
@@ -8033,6 +8091,41 @@ 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>
+
+[VendorResultsList](./x-components.vendorresultslist.md)
+
+
+</td><td>
+
+It renders a [ItemsList](./x-components.itemslist.md) of vendor results from [VendorState.results](./x-components.vendorstate.results.md)<!-- -->.
+
+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.
+
+It also provides the parent slots to customize the items.
+
+
+</td></tr>
+<tr><td>
+
+[vendorXModule](./x-components.vendorxmodule.md)
+
+
+</td><td>
+
+Vendor [XModule](./x-components.xmodule.md) implementation. This module is auto-registered as soon as you import any component from the `vendor` entry point.
+
+
+</td></tr>
+<tr><td>
+
+[vendorXStoreModule](./x-components.vendorxstoremodule.md)
+
+
+</td><td>
+
+
 </td></tr>
 <tr><td>
 
@@ -9533,6 +9626,26 @@ The device flags type of the Return type of the composable returned by `createUs
 The Return type of the composable returned by `createUseDevice`<!-- -->.
 
 
+</td></tr>
+<tr><td>
+
+[VendorXModule](./x-components.vendorxmodule.md)
+
+
+</td><td>
+
+Vendor [XModule](./x-components.xmodule.md) alias.
+
+
+</td></tr>
+<tr><td>
+
+[VendorXStoreModule](./x-components.vendorxstoremodule.md)
+
+
+</td><td>
+
+
 </td></tr>
 <tr><td>
 

package/docs/API-reference/api/x-components.setresults.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; [setResults](./x-components.setresults.md)
+
+## setResults variable
+
+Sets the vendor results of the [VendorXModule](./x-components.vendorxmodule.md)<!-- -->.
+
+**Signature:**
+
+```typescript
+setResults: import("../../wiring").AnyWire
+```

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

@@ -206,6 +206,7 @@ _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
         UserClickedAnAiCarouselResult?: import("@empathyco/x-types").Result | undefined;
         UserClickedAnAiCarouselAdd2Cart?: import("@empathyco/x-types").Result | undefined;
         AiComponentMounted?: void | undefined;
+        VendorResultsChanged?: Omit<import("../../../vendor").VendorResult, "modelName">[] | 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

@@ -196,6 +196,7 @@ _default: import("vue").DefineComponent<{}, {
         UserClickedAnAiCarouselResult: (payload: import("@empathyco/x-types").Result, metadata: WireMetadata) => unknown;
         UserClickedAnAiCarouselAdd2Cart: (payload: import("@empathyco/x-types").Result, metadata: WireMetadata) => unknown;
         AiComponentMounted: (payload: undefined, metadata: WireMetadata) => unknown;
+        VendorResultsChanged: (payload: Omit<import("..").VendorResult, "modelName">[], 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.sortdropdown.md

@@ -10,24 +10,50 @@ The `SortDropdown` component allows user to select the search results order. Thi
 
 ```typescript
 _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    animation: PropType<string | Component>;
     items: {
         type: PropType<Sort[]>;
         required: true;
     };
-    animation: PropType<string | Component>;
+    selectedSort: {
+        type: PropType<Sort>;
+        required: true;
+    };
+    selectedSortProvidedEvent: {
+        type: PropType<XEvent>;
+        default: string;
+    };
+    clickedSortEvent: {
+        type: PropType<XEvent>;
+        default: string;
+    };
 }>, {
     emitUserClickedASort: (sort: Sort) => void;
     rootRef: import("vue").Ref<import("vue").DefineComponent<{}, {}, any> | undefined, import("vue").DefineComponent<{}, {}, any> | undefined>;
-    selectedSort: import("vue").ComputedRef<string>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, "change"[], "change", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    animation: PropType<string | Component>;
     items: {
         type: PropType<Sort[]>;
         required: true;
     };
-    animation: PropType<string | Component>;
+    selectedSort: {
+        type: PropType<Sort>;
+        required: true;
+    };
+    selectedSortProvidedEvent: {
+        type: PropType<XEvent>;
+        default: string;
+    };
+    clickedSortEvent: {
+        type: PropType<XEvent>;
+        default: string;
+    };
 }>> & Readonly<{
     onChange?: ((...args: any[]) => any) | undefined;
-}>, {}, {}, {
+}>, {
+    selectedSortProvidedEvent: keyof import("../../wiring/events.types").XEventsTypes;
+    clickedSortEvent: keyof import("../../wiring/events.types").XEventsTypes;
+}, {}, {
     BaseDropdown: import("vue").DefineComponent<{}, {}, any>;
 }, {}, string, import("vue").ComponentProvideOptions, true, {}, any>
 ```

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

@@ -10,28 +10,53 @@ The `SortList` component allows user to select the search results order. This co
 
 ```typescript
 _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    animation: {
+        type: PropType<string | Component>;
+        default: () => string;
+    };
     items: {
         type: PropType<Sort[]>;
         required: true;
     };
-    animation: {
-        type: PropType<string | Component>;
-        default: () => string;
+    selectedSort: {
+        type: PropType<Sort>;
+        required: true;
+    };
+    selectedSortProvidedEvent: {
+        type: PropType<XEvent>;
+        default: string;
+    };
+    clickedSortEvent: {
+        type: PropType<XEvent>;
+        default: string;
     };
 }>, {
     listItems: import("vue").ComputedRef<SortListItem[]>;
-    selectedSort: import("vue").ComputedRef<string>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    animation: {
+        type: PropType<string | Component>;
+        default: () => string;
+    };
     items: {
         type: PropType<Sort[]>;
         required: true;
     };
-    animation: {
-        type: PropType<string | Component>;
-        default: () => string;
+    selectedSort: {
+        type: PropType<Sort>;
+        required: true;
+    };
+    selectedSortProvidedEvent: {
+        type: PropType<XEvent>;
+        default: string;
+    };
+    clickedSortEvent: {
+        type: PropType<XEvent>;
+        default: string;
     };
 }>> & Readonly<{}>, {
     animation: string | Component;
+    selectedSortProvidedEvent: keyof XEventsTypes;
+    clickedSortEvent: keyof XEventsTypes;
 }, {}, {
     BaseEventButton: import("vue").DefineComponent<{}, {}, any>;
 }, {}, string, import("vue").ComponentProvideOptions, true, {}, any>

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

@@ -10,30 +10,55 @@ The `SortPickerList` component allows user to select the search results order. T
 
 ```typescript
 _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    animation: {
+        type: PropType<string | Component>;
+        default: () => string;
+    };
     items: {
         type: PropType<Sort[]>;
         required: true;
     };
-    animation: {
-        type: PropType<string | Component>;
-        default: () => string;
+    selectedSort: {
+        type: PropType<Sort>;
+        required: true;
+    };
+    selectedSortProvidedEvent: {
+        type: PropType<XEvent>;
+        default: string;
+    };
+    clickedSortEvent: {
+        type: PropType<XEvent>;
+        default: string;
     };
     buttonClass: StringConstructor;
 }>, {
     listItems: import("vue").ComputedRef<SortPickerItem[]>;
-    selectedSort: import("vue").ComputedRef<string>;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    animation: {
+        type: PropType<string | Component>;
+        default: () => string;
+    };
     items: {
         type: PropType<Sort[]>;
         required: true;
     };
-    animation: {
-        type: PropType<string | Component>;
-        default: () => string;
+    selectedSort: {
+        type: PropType<Sort>;
+        required: true;
+    };
+    selectedSortProvidedEvent: {
+        type: PropType<XEvent>;
+        default: string;
+    };
+    clickedSortEvent: {
+        type: PropType<XEvent>;
+        default: string;
     };
     buttonClass: StringConstructor;
 }>> & Readonly<{}>, {
     animation: string | Component;
+    selectedSortProvidedEvent: keyof XEventsTypes;
+    clickedSortEvent: keyof XEventsTypes;
 }, {}, {
     BaseEventButton: import("vue").DefineComponent<{}, {}, any>;
 }, {}, string, import("vue").ComponentProvideOptions, true, {}, any>

package/docs/API-reference/api/x-components.usealiasapi.browseselectedsort.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; [UseAliasAPI](./x-components.usealiasapi.md) &gt; [browseSelectedSort](./x-components.usealiasapi.browseselectedsort.md)
+
+## UseAliasAPI.browseSelectedSort property
+
+The [BrowseXModule](./x-components.browsexmodule.md) selected sort.
+
+**Signature:**
+
+```typescript
+readonly browseSelectedSort: string;
+```

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

@@ -37,6 +37,27 @@ Description
 </th></tr></thead>
 <tbody><tr><td>
 
+[browseSelectedSort](./x-components.usealiasapi.browseselectedsort.md)
+
+
+</td><td>
+
+`readonly`
+
+
+</td><td>
+
+string
+
+
+</td><td>
+
+The [BrowseXModule](./x-components.browsexmodule.md) selected sort.
+
+
+</td></tr>
+<tr><td>
+
 [browseTotalResults](./x-components.usealiasapi.browsetotalresults.md)
 
 

package/docs/API-reference/api/x-components.vendoractions.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; [VendorActions](./x-components.vendoractions.md)
+
+## VendorActions interface
+
+**Signature:**
+
+```typescript
+export interface VendorActions 
+```

package/docs/API-reference/api/x-components.vendorgetters.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; [VendorGetters](./x-components.vendorgetters.md)
+
+## VendorGetters interface
+
+**Signature:**
+
+```typescript
+export interface VendorGetters 
+```

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

@@ -0,0 +1,54 @@
+<!-- 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)
+
+## VendorMutations interface
+
+**Signature:**
+
+```typescript
+export interface VendorMutations 
+```
+
+## Properties
+
+<table><thead><tr><th>
+
+Property
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[setResults](./x-components.vendormutations.setresults.md)
+
+
+</td><td>
+
+
+</td><td>
+
+(results: [VendorResult](./x-components.vendorresult.md)<!-- -->\[\]) =&gt; void
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>
+

package/docs/API-reference/api/x-components.vendormutations.setresults.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; [setResults](./x-components.vendormutations.setresults.md)
+
+## VendorMutations.setResults property
+
+**Signature:**
+
+```typescript
+setResults: (results: VendorResult[]) => void;
+```

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

@@ -0,0 +1,57 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [VendorResult](./x-components.vendorresult.md)
+
+## VendorResult interface
+
+The interface for a vendor result, extending the base Result interface.
+
+**Signature:**
+
+```typescript
+export interface VendorResult extends Omit<Result, 'modelName'>, NamedModel<'VendorResult'> 
+```
+**Extends:** Omit&lt;Result, 'modelName'&gt;, NamedModel&lt;'VendorResult'&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.vendorresult.position.md)
+
+
+</td><td>
+
+
+</td><td>
+
+number
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>
+

package/docs/API-reference/api/x-components.vendorresult.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; [VendorResult](./x-components.vendorresult.md) &gt; [position](./x-components.vendorresult.position.md)
+
+## VendorResult.position property
+
+**Signature:**
+
+```typescript
+position: number;
+```