@empathyco/x-components 6.0.0-alpha.232 → 6.0.0-alpha.234

package/CHANGELOG.md

@@ -3,6 +3,27 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [6.0.0-alpha.234](https://github.com/empathyco/x/compare/@empathyco/x-components@6.0.0-alpha.233...@empathyco/x-components@6.0.0-alpha.234) (2026-04-06)
+
+### ⚠ BREAKING CHANGES
+
+* **ai:** The AI module now uses RequestStatus type instead of boolean loading states. Users should:
+* Update from `suggestionsLoading: boolean` to `suggestionsStatus: RequestStatus`.
+* Update from `setSuggestionsSearchLoading: boolean` to `setSuggestionsSearchStatus: RequestStatus`.
+* Adjust computed properties accordingly.
+
+### Code Refactoring
+
+* **ai:** replace boolean loading states with RequestStatus type (#2068)
+
+
+## [6.0.0-alpha.233](https://github.com/empathyco/x/compare/@empathyco/x-components@6.0.0-alpha.232...@empathyco/x-components@6.0.0-alpha.233) (2026-04-02)
+
+### Features
+
+* define result enrichment for Results, PartialResults and Recommendations (#2065)
+
+
 ## [6.0.0-alpha.232](https://github.com/empathyco/x/compare/@empathyco/x-components@6.0.0-alpha.231...@empathyco/x-components@6.0.0-alpha.232) (2026-04-01)
 
 ### Bug Fixes

package/core/index.js

@@ -165,6 +165,7 @@ export { isSimpleSelector, registerStoreEmitters } from '../js/plugins/x-emitter
 export { XPlugin, xPlugin } from '../js/plugins/x-plugin.js';
 export { assertXPluginOptionsAreValid, getGetterPath } from '../js/plugins/x-plugin.utils.js';
 export { DirectionalFocusNavigationService } from '../js/services/directional-focus-navigation.service.js';
+export { DefaultResultsEnrichmentService } from '../js/services/results-enrichment.service.js';
 export { mergeConfig, setConfig } from '../js/store/utils/config-store.utils.js';
 export { createFetchAndSaveActions } from '../js/store/utils/fetch-and-save-action.utils.js';
 export { cleanGettersProxyCache, getGettersProxy, getGettersProxyFromModule } from '../js/store/utils/getters-proxy.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.aimutations.md

@@ -209,7 +209,7 @@ Sets the selected filters of the module.
 </td></tr>
 <tr><td>
 
-[setSuggestionsLoading](./x-components.aimutations.setsuggestionsloading.md)
+[setSuggestionsSearch](./x-components.aimutations.setsuggestionssearch.md)
 
 
 </td><td>
@@ -217,18 +217,18 @@ Sets the selected filters of the module.
 
 </td><td>
 
-(value: boolean) =&gt; void
+(suggestionsSearch: AiSuggestionSearch\[\]) =&gt; void
 
 
 </td><td>
 
-Sets the loading for the suggestions response.
+Sets the suggestions search from the suggestions search response.
 
 
 </td></tr>
 <tr><td>
 
-[setSuggestionsSearch](./x-components.aimutations.setsuggestionssearch.md)
+[setSuggestionsSearchStatus](./x-components.aimutations.setsuggestionssearchstatus.md)
 
 
 </td><td>
@@ -236,18 +236,18 @@ Sets the loading for the suggestions response.
 
 </td><td>
 
-(suggestionsSearch: AiSuggestionSearch\[\]) =&gt; void
+(status: [RequestStatus](./x-components.requeststatus.md)<!-- -->) =&gt; void
 
 
 </td><td>
 
-Sets the suggestions search from the suggestions search response.
+Sets the status for the suggestions search response.
 
 
 </td></tr>
 <tr><td>
 
-[setSuggestionsSearchLoading](./x-components.aimutations.setsuggestionssearchloading.md)
+[setSuggestionsStatus](./x-components.aimutations.setsuggestionsstatus.md)
 
 
 </td><td>
@@ -255,12 +255,12 @@ Sets the suggestions search from the suggestions search response.
 
 </td><td>
 
-(value: boolean) =&gt; void
+(status: [RequestStatus](./x-components.requeststatus.md)<!-- -->) =&gt; void
 
 
 </td><td>
 
-Sets the loading fot the suggestions search response.
+Sets the status for the suggestions response.
 
 
 </td></tr>

package/docs/API-reference/api/x-components.aimutations.setsuggestionssearchstatus.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; [AiMutations](./x-components.aimutations.md) &gt; [setSuggestionsSearchStatus](./x-components.aimutations.setsuggestionssearchstatus.md)
+
+## AiMutations.setSuggestionsSearchStatus property
+
+Sets the status for the suggestions search response.
+
+**Signature:**
+
+```typescript
+setSuggestionsSearchStatus: (status: RequestStatus) => void;
+```

package/docs/API-reference/api/{x-components.aimutations.setsuggestionsloading.md → x-components.aimutations.setsuggestionsstatus.md}

@@ -1,13 +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; [AiMutations](./x-components.aimutations.md) &gt; [setSuggestionsLoading](./x-components.aimutations.setsuggestionsloading.md)
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [AiMutations](./x-components.aimutations.md) &gt; [setSuggestionsStatus](./x-components.aimutations.setsuggestionsstatus.md)
 
-## AiMutations.setSuggestionsLoading property
+## AiMutations.setSuggestionsStatus property
 
-Sets the loading for the suggestions response.
+Sets the status for the suggestions response.
 
 **Signature:**
 
 ```typescript
-setSuggestionsLoading: (value: boolean) => void;
+setSuggestionsStatus: (status: RequestStatus) => void;
 ```

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

@@ -205,7 +205,7 @@ The dictionary of selected filters, used to perform the AI requests. The key is
 </td></tr>
 <tr><td>
 
-[suggestionsLoading](./x-components.aistate.suggestionsloading.md)
+[suggestionsSearch](./x-components.aistate.suggestionssearch.md)
 
 
 </td><td>
@@ -213,18 +213,18 @@ The dictionary of selected filters, used to perform the AI requests. The key is
 
 </td><td>
 
-boolean
+AiSuggestionSearch\[\]
 
 
 </td><td>
 
-Loading state for the suggestions response
+The results per query retrieved by the suggestion search endpoint
 
 
 </td></tr>
 <tr><td>
 
-[suggestionsSearch](./x-components.aistate.suggestionssearch.md)
+[suggestionsSearchStatus](./x-components.aistate.suggestionssearchstatus.md)
 
 
 </td><td>
@@ -232,18 +232,18 @@ Loading state for the suggestions response
 
 </td><td>
 
-AiSuggestionSearch\[\]
+[RequestStatus](./x-components.requeststatus.md)
 
 
 </td><td>
 
-The results per query retrieved by the suggestion search endpoint
+Status for the suggestions search response
 
 
 </td></tr>
 <tr><td>
 
-[suggestionsSearchLoading](./x-components.aistate.suggestionssearchloading.md)
+[suggestionsStatus](./x-components.aistate.suggestionsstatus.md)
 
 
 </td><td>
@@ -251,12 +251,12 @@ The results per query retrieved by the suggestion search endpoint
 
 </td><td>
 
-boolean
+[RequestStatus](./x-components.requeststatus.md)
 
 
 </td><td>
 
-Loading state for the suggestions search response
+Status for the suggestions response
 
 
 </td></tr>

package/docs/API-reference/api/{x-components.aistate.suggestionssearchloading.md → x-components.aistate.suggestionssearchstatus.md}

@@ -1,13 +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; [AiState](./x-components.aistate.md) &gt; [suggestionsSearchLoading](./x-components.aistate.suggestionssearchloading.md)
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [AiState](./x-components.aistate.md) &gt; [suggestionsSearchStatus](./x-components.aistate.suggestionssearchstatus.md)
 
-## AiState.suggestionsSearchLoading property
+## AiState.suggestionsSearchStatus property
 
-Loading state for the suggestions search response
+Status for the suggestions search response
 
 **Signature:**
 
 ```typescript
-suggestionsSearchLoading: boolean;
+suggestionsSearchStatus: RequestStatus;
 ```

package/docs/API-reference/api/{x-components.aistate.suggestionsloading.md → x-components.aistate.suggestionsstatus.md}

@@ -1,13 +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; [AiState](./x-components.aistate.md) &gt; [suggestionsLoading](./x-components.aistate.suggestionsloading.md)
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [AiState](./x-components.aistate.md) &gt; [suggestionsStatus](./x-components.aistate.suggestionsstatus.md)
 
-## AiState.suggestionsLoading property
+## AiState.suggestionsStatus property
 
-Loading state for the suggestions response
+Status for the suggestions response
 
 **Signature:**
 
 ```typescript
-suggestionsLoading: boolean;
+suggestionsStatus: RequestStatus;
 ```

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

@@ -0,0 +1,17 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [cancelFetchAndSavePartialResultsEnrichment](./x-components.cancelfetchandsavepartialresultsenrichment.md)
+
+## cancelFetchAndSavePartialResultsEnrichment() function
+
+Default implementation for  action.
+
+**Signature:**
+
+```typescript
+cancelFetchAndSavePartialResultsEnrichment: () => void
+```
+**Returns:**
+
+void
+

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

@@ -0,0 +1,17 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [cancelFetchAndSaveResultsEnrichment](./x-components.cancelfetchandsaveresultsenrichment.md)
+
+## cancelFetchAndSaveResultsEnrichment() function
+
+Default implementation for  action.
+
+**Signature:**
+
+```typescript
+cancelFetchAndSaveResultsEnrichment: () => void
+```
+**Returns:**
+
+void
+

package/docs/API-reference/api/x-components.defaultresultsenrichmentservice._constructor_.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; [DefaultResultsEnrichmentService](./x-components.defaultresultsenrichmentservice.md) &gt; [(constructor)](./x-components.defaultresultsenrichmentservice._constructor_.md)
+
+## DefaultResultsEnrichmentService.(constructor)
+
+Constructs a new instance of the `DefaultResultsEnrichmentService` class
+
+**Signature:**
+
+```typescript
+constructor();
+```

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

@@ -0,0 +1,52 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [DefaultResultsEnrichmentService](./x-components.defaultresultsenrichmentservice.md) &gt; [fetchResults](./x-components.defaultresultsenrichmentservice.fetchresults.md)
+
+## DefaultResultsEnrichmentService.fetchResults() method
+
+Fetches the enrichment results.
+
+**Signature:**
+
+```typescript
+fetchResults(_: Result[]): Promise<any[]>;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+\_
+
+
+</td><td>
+
+Result\[\]
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>
+
+**Returns:**
+
+Promise&lt;any\[\]&gt;
+

package/docs/API-reference/api/x-components.defaultresultsenrichmentservice.instance.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; [DefaultResultsEnrichmentService](./x-components.defaultresultsenrichmentservice.md) &gt; [instance](./x-components.defaultresultsenrichmentservice.instance.md)
+
+## DefaultResultsEnrichmentService.instance property
+
+Global instance of the [ResultsEnrichmentService](./x-components.resultsenrichmentservice.md)<!-- -->.
+
+**Signature:**
+
+```typescript
+static instance: ResultsEnrichmentService;
+```

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

@@ -0,0 +1,164 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [DefaultResultsEnrichmentService](./x-components.defaultresultsenrichmentservice.md)
+
+## DefaultResultsEnrichmentService class
+
+Default implementation for the [ResultsEnrichmentService](./x-components.resultsenrichmentservice.md)<!-- -->.
+
+**Signature:**
+
+```typescript
+export declare class DefaultResultsEnrichmentService implements ResultsEnrichmentService 
+```
+**Implements:** [ResultsEnrichmentService](./x-components.resultsenrichmentservice.md)
+
+## Constructors
+
+<table><thead><tr><th>
+
+Constructor
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[(constructor)()](./x-components.defaultresultsenrichmentservice._constructor_.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Constructs a new instance of the `DefaultResultsEnrichmentService` class
+
+
+</td></tr>
+</tbody></table>
+
+## Properties
+
+<table><thead><tr><th>
+
+Property
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[instance](./x-components.defaultresultsenrichmentservice.instance.md)
+
+
+</td><td>
+
+`static`
+
+
+</td><td>
+
+[ResultsEnrichmentService](./x-components.resultsenrichmentservice.md)
+
+
+</td><td>
+
+Global instance of the [ResultsEnrichmentService](./x-components.resultsenrichmentservice.md)<!-- -->.
+
+
+</td></tr>
+<tr><td>
+
+[store](./x-components.defaultresultsenrichmentservice.store.md)
+
+
+</td><td>
+
+`protected`
+
+`readonly`
+
+
+</td><td>
+
+Store&lt;[RootXStoreState](./x-components.rootxstorestate.md)<!-- -->&gt;
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>
+
+## Methods
+
+<table><thead><tr><th>
+
+Method
+
+
+</th><th>
+
+Modifiers
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+[fetchResults(\_)](./x-components.defaultresultsenrichmentservice.fetchresults.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Fetches the enrichment results.
+
+
+</td></tr>
+<tr><td>
+
+[updateResults(\_, \_\_)](./x-components.defaultresultsenrichmentservice.updateresults.md)
+
+
+</td><td>
+
+
+</td><td>
+
+Updates the results with the enrichment results. Updates via mutation.
+
+
+</td></tr>
+</tbody></table>
+

package/docs/API-reference/api/x-components.defaultresultsenrichmentservice.store.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; [DefaultResultsEnrichmentService](./x-components.defaultresultsenrichmentservice.md) &gt; [store](./x-components.defaultresultsenrichmentservice.store.md)
+
+## DefaultResultsEnrichmentService.store property
+
+**Signature:**
+
+```typescript
+protected get store(): Store<RootXStoreState>;
+```

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

@@ -0,0 +1,66 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [DefaultResultsEnrichmentService](./x-components.defaultresultsenrichmentservice.md) &gt; [updateResults](./x-components.defaultresultsenrichmentservice.updateresults.md)
+
+## DefaultResultsEnrichmentService.updateResults() method
+
+Updates the results with the enrichment results. Updates via mutation.
+
+**Signature:**
+
+```typescript
+updateResults(_: Result[], __: any[]): void;
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+\_
+
+
+</td><td>
+
+Result\[\]
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+\_\_
+
+
+</td><td>
+
+any\[\]
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>
+
+**Returns:**
+
+void
+

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

@@ -0,0 +1,66 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [@empathyco/x-components](./x-components.md) &gt; [fetchAndSavePartialResultsEnrichment](./x-components.fetchandsavepartialresultsenrichment.md)
+
+## fetchAndSavePartialResultsEnrichment() function
+
+Default implementation for [SearchActions.fetchAndSavePartialResultsEnrichment](./x-components.searchactions.fetchandsavepartialresultsenrichment.md) action.
+
+**Signature:**
+
+```typescript
+fetchAndSavePartialResultsEnrichment: (context: SearchActionContext, request: PartialResult[]) => void | Promise<void>
+```
+
+## Parameters
+
+<table><thead><tr><th>
+
+Parameter
+
+
+</th><th>
+
+Type
+
+
+</th><th>
+
+Description
+
+
+</th></tr></thead>
+<tbody><tr><td>
+
+context
+
+
+</td><td>
+
+[SearchActionContext](./x-components.searchactioncontext.md)
+
+
+</td><td>
+
+
+</td></tr>
+<tr><td>
+
+request
+
+
+</td><td>
+
+PartialResult\[\]
+
+
+</td><td>
+
+
+</td></tr>
+</tbody></table>
+
+**Returns:**
+
+void \| Promise&lt;void&gt;
+