@coveo/headless 3.29.3-pre.8a67bd16aa → 3.29.3-pre.8b47cb07e6

package/dist/definitions/ssr/commerce/types/controller-definitions.d.ts

@@ -170,9 +170,6 @@ type DefaultControllerProps<TControllers extends ControllerDefinitionsMap<Contro
     [I in keyof TControllersPropsMap as I extends K ? I : never]: TControllersPropsMap[I];
 };
 type ConditionalControllerProps<TControllers extends ControllerDefinitionsMap<Controller>, TControllersPropsMap extends ControllersPropsMap, TSolutionType extends SolutionType, K extends keyof TControllers> = TSolutionType extends SolutionType.recommendation ? RecommendationControllerProps<TControllers, TControllersPropsMap, K> : DefaultControllerProps<TControllers, TControllersPropsMap, K>;
-/**
- * @deprecated This interface is no longer used and will be removed in next major version.
- */
 export interface ControllerDefinitionOption {
     /**
      * Whether the controller will be used in a product listing context.

package/dist/definitions/ssr-commerce-next.index.d.ts

@@ -76,27 +76,27 @@ export type { LoggerOptions, LogLevel } from './app/logger.js';
 export type { BrowserNavigatorContextProvider, NavigatorContext, NavigatorContextProvider, } from './app/navigator-context-provider.js';
 export type { InteractiveProduct, InteractiveProductOptions, InteractiveProductProps, } from './controllers/commerce/core/interactive-product/headless-core-interactive-product.js';
 export type { Controller, Subscribable, } from './controllers/controller/headless-controller.js';
-export type { BreadcrumbManager, BreadcrumbManagerDefinition, BreadcrumbManagerState, } from './ssr-next/commerce/controllers/breadcrumb-manager/headless-core-breadcrumb-manager.ssr.js';
+export type { BreadcrumbManager, BreadcrumbManagerState, } from './ssr-next/commerce/controllers/breadcrumb-manager/headless-core-breadcrumb-manager.ssr.js';
 export { defineBreadcrumbManager } from './ssr-next/commerce/controllers/breadcrumb-manager/headless-core-breadcrumb-manager.ssr.js';
 export type { Cart, CartBuildProps, CartDefinition, CartInitialState, CartItem, CartProps, CartState, } from './ssr-next/commerce/controllers/cart/headless-cart.ssr.js';
 export { defineCart } from './ssr-next/commerce/controllers/cart/headless-cart.ssr.js';
 export type { Context, ContextDefinition, ContextOptions, ContextProps, ContextState, UserLocation, View, } from './ssr-next/commerce/controllers/context/headless-context.ssr.js';
 export { defineContext } from './ssr-next/commerce/controllers/context/headless-context.ssr.js';
-export type { DidYouMean, DidYouMeanDefinition, DidYouMeanState, } from './ssr-next/commerce/controllers/did-you-mean/headless-did-you-mean.ssr.js';
+export type { DidYouMean, DidYouMeanState, } from './ssr-next/commerce/controllers/did-you-mean/headless-did-you-mean.ssr.js';
 export { defineDidYouMean } from './ssr-next/commerce/controllers/did-you-mean/headless-did-you-mean.ssr.js';
 export type { CategoryFilterSuggestions, CategoryFilterSuggestionsState, FieldSuggestionsFacet, FilterSuggestions, FilterSuggestionsGenerator, FilterSuggestionsGeneratorDefinition, FilterSuggestionsState, GeneratedFilterSuggestionsControllers, } from './ssr-next/commerce/controllers/filter-suggestions/headless-filter-suggestions-generator.ssr.js';
 export { defineFilterSuggestionsGenerator } from './ssr-next/commerce/controllers/filter-suggestions/headless-filter-suggestions-generator.ssr.js';
-export type { BaseFacetSearchResult, CategoryFacet, CategoryFacetSearchResult, CategoryFacetState, CategoryFacetValue, CoreCommerceFacet, DateFacet, DateFacetState, DateFacetValue, FacetGenerator, FacetGeneratorDefinition, FacetGeneratorState, FacetType, LocationFacet, LocationFacetState, LocationFacetValue, MappedFacetState, MappedFacetStates, MappedGeneratedFacetController, NumericFacet, NumericFacetState, NumericFacetValue, RegularFacet, RegularFacetState, RegularFacetValue, } from './ssr-next/commerce/controllers/generator/headless-commerce-facet-generator.ssr.js';
+export type { BaseFacetSearchResult, CategoryFacet, CategoryFacetSearchResult, CategoryFacetState, CategoryFacetValue, CoreCommerceFacet, DateFacet, DateFacetState, DateFacetValue, FacetGenerator, FacetGeneratorState, FacetType, LocationFacet, LocationFacetState, LocationFacetValue, MappedFacetState, MappedFacetStates, MappedGeneratedFacetController, NumericFacet, NumericFacetState, NumericFacetValue, RegularFacet, RegularFacetState, RegularFacetValue, } from './ssr-next/commerce/controllers/generator/headless-commerce-facet-generator.ssr.js';
 export { defineFacetGenerator } from './ssr-next/commerce/controllers/generator/headless-commerce-facet-generator.ssr.js';
 export type { InstantProducts, InstantProductsDefinition, InstantProductsOptions, InstantProductsProps, InstantProductsState, } from './ssr-next/commerce/controllers/instant-products/headless-instant-products.ssr.js';
 export { defineInstantProducts } from './ssr-next/commerce/controllers/instant-products/headless-instant-products.ssr.js';
-export type { CorePaginationOptions, Pagination, PaginationDefinition, PaginationOptions, PaginationProps, PaginationState, } from './ssr-next/commerce/controllers/pagination/headless-core-commerce-pagination.ssr.js';
+export type { CorePaginationOptions, Pagination, PaginationOptions, PaginationProps, PaginationState, } from './ssr-next/commerce/controllers/pagination/headless-core-commerce-pagination.ssr.js';
 export { definePagination } from './ssr-next/commerce/controllers/pagination/headless-core-commerce-pagination.ssr.js';
 export type { CommerceSearchParameters, ParameterManager, ParameterManagerDefinition, ParameterManagerProps, ParameterManagerState, Parameters, ProductListingParameters, SSRParameterManagerProps, } from './ssr-next/commerce/controllers/parameter-manager/headless-core-parameter-manager.ssr.js';
 export { defineParameterManager } from './ssr-next/commerce/controllers/parameter-manager/headless-core-parameter-manager.ssr.js';
-export type { ProductList, ProductListDefinition, ProductListing, ProductListState, Search, } from './ssr-next/commerce/controllers/product-list/headless-product-list.ssr.js';
+export type { ProductList, ProductListing, ProductListState, Search, } from './ssr-next/commerce/controllers/product-list/headless-product-list.ssr.js';
 export { defineProductList } from './ssr-next/commerce/controllers/product-list/headless-product-list.ssr.js';
-export type { ProductView, ProductViewDefinition, } from './ssr-next/commerce/controllers/product-view/headless-product-view.ssr.js';
+export type { ProductView } from './ssr-next/commerce/controllers/product-view/headless-product-view.ssr.js';
 export { defineProductView } from './ssr-next/commerce/controllers/product-view/headless-product-view.ssr.js';
 export type { RecentQueriesList, RecentQueriesListDefinition, RecentQueriesListInitialState, RecentQueriesListOptions, RecentQueriesListProps, RecentQueriesState, } from './ssr-next/commerce/controllers/recent-queries-list/headless-recent-queries-list.ssr.js';
 export { defineRecentQueriesList } from './ssr-next/commerce/controllers/recent-queries-list/headless-recent-queries-list.ssr.js';
@@ -104,11 +104,11 @@ export type { Recommendations, RecommendationsDefinition, RecommendationsState,
 export { defineRecommendations } from './ssr-next/commerce/controllers/recommendations/headless-recommendations.ssr.js';
 export type { CoreSearchBox, SearchBox, SearchBoxDefinition, SearchBoxOptions, SearchBoxProps, SearchBoxState, Suggestion, } from './ssr-next/commerce/controllers/search-box/headless-search-box.ssr.js';
 export { defineSearchBox } from './ssr-next/commerce/controllers/search-box/headless-search-box.ssr.js';
-export type { Sort, SortDefinition, SortProps, SortState, } from './ssr-next/commerce/controllers/sort/headless-core-commerce-sort.ssr.js';
+export type { Sort, SortProps, SortState, } from './ssr-next/commerce/controllers/sort/headless-core-commerce-sort.ssr.js';
 export { defineSort } from './ssr-next/commerce/controllers/sort/headless-core-commerce-sort.ssr.js';
 export type { StandaloneSearchBox, StandaloneSearchBoxDefinition, StandaloneSearchBoxProps, StandaloneSearchBoxState, } from './ssr-next/commerce/controllers/standalone-search-box/headless-standalone-search-box.ssr.js';
 export { defineStandaloneSearchBox } from './ssr-next/commerce/controllers/standalone-search-box/headless-standalone-search-box.ssr.js';
-export type { ProductListingSummaryState, RecommendationsSummaryState, SearchSummaryState, Summary, SummaryDefinition, SummaryState, } from './ssr-next/commerce/controllers/summary/headless-core-summary.ssr.js';
+export type { ProductListingSummaryState, RecommendationsSummaryState, SearchSummaryState, Summary, SummaryState, } from './ssr-next/commerce/controllers/summary/headless-core-summary.ssr.js';
 export { defineSummary } from './ssr-next/commerce/controllers/summary/headless-core-summary.ssr.js';
 export type { NotifyTrigger, NotifyTriggerDefinition, NotifyTriggerState, } from './ssr-next/commerce/controllers/triggers/headless-notify-trigger.ssr.js';
 export { defineNotifyTrigger } from './ssr-next/commerce/controllers/triggers/headless-notify-trigger.ssr.js';

package/dist/definitions/ssr-next/commerce/controller-utils.d.ts

@@ -2,7 +2,7 @@ import type { UnknownAction } from '@reduxjs/toolkit';
 import type { Controller } from '../../controllers/controller/headless-controller.js';
 import type { SSRCommerceEngine } from './factories/build-factory.js';
 import type { SolutionType } from './types/controller-constants.js';
-import type { ControllerDefinitionsMap, FilteredBakedInControllers } from './types/controller-definitions.js';
+import type { ControllerDefinitionOption, ControllerDefinitionsMap, FilteredBakedInControllers } from './types/controller-definitions.js';
 import type { InferControllerPropsMapFromDefinitions, InferControllerStaticStateMapFromDefinitionsWithSolutionType, InferControllersMapFromDefinition } from './types/controller-inference.js';
 export declare function createStaticState<TSearchAction extends UnknownAction, TControllerDefinitions extends ControllerDefinitionsMap<Controller>, TSolutionType extends SolutionType>({ searchActions, controllers, }: {
     searchActions: TSearchAction[];
@@ -17,3 +17,4 @@ export declare function buildControllerDefinitions<TControllerDefinitionsMap ext
     solutionType: TSolutionType;
     propsMap?: InferControllerPropsMapFromDefinitions<TControllerDefinitionsMap>;
 }): InferControllersMapFromDefinition<TControllerDefinitionsMap, TSolutionType>;
+export declare function ensureAtLeastOneSolutionType(options?: ControllerDefinitionOption): void;

package/dist/definitions/ssr-next/commerce/controllers/breadcrumb-manager/headless-core-breadcrumb-manager.ssr.d.ts

@@ -1,11 +1,10 @@
 import type { BreadcrumbManager, BreadcrumbManagerState } from '../../../../controllers/commerce/core/breadcrumb-manager/headless-core-breadcrumb-manager.js';
-import type { SearchAndListingControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
+import type { ControllerDefinitionOption, SubControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
 export type { BreadcrumbManager, BreadcrumbManagerState };
-export type BreadcrumbManagerDefinition = SearchAndListingControllerDefinitionWithoutProps<BreadcrumbManager>;
 /**
  * Defines a `BreadcrumbManager` controller instance.
  * @group Definers
  *
  * @returns The `BreadcrumbManager` controller definition.
  */
-export declare function defineBreadcrumbManager(): BreadcrumbManagerDefinition;
+export declare function defineBreadcrumbManager<TOptions extends ControllerDefinitionOption | undefined>(options?: TOptions): SubControllerDefinitionWithoutProps<BreadcrumbManager, TOptions>;

package/dist/definitions/ssr-next/commerce/controllers/cart/headless-cart.ssr.d.ts

@@ -4,7 +4,8 @@ export type { Cart, CartInitialState, CartItem, CartProps, CartState };
 export interface CartBuildProps {
     initialState: CartInitialState;
 }
-export type CartDefinition = UniversalControllerDefinitionWithProps<Cart, CartBuildProps>;
+export interface CartDefinition extends UniversalControllerDefinitionWithProps<Cart, CartBuildProps> {
+}
 /**
  * Defines a `Cart` controller instance.
  * @group Definers

package/dist/definitions/ssr-next/commerce/controllers/context/headless-context.ssr.d.ts

@@ -1,9 +1,10 @@
 import { type Context, type ContextOptions, type ContextProps, type ContextState, type UserLocation, type View } from '../../../../controllers/commerce/context/headless-context.js';
 import type { UniversalControllerDefinitionWithProps } from '../../types/controller-definitions.js';
 export type { Context, ContextProps, ContextState, View, UserLocation, ContextOptions, };
-export type ContextDefinition = UniversalControllerDefinitionWithProps<Context, {
+export interface ContextDefinition extends UniversalControllerDefinitionWithProps<Context, {
     initialState: ContextOptions;
-}>;
+}> {
+}
 /**
  * Defines a `Context` controller instance.
  * @group Definers

package/dist/definitions/ssr-next/commerce/controllers/did-you-mean/headless-did-you-mean.ssr.d.ts

@@ -1,11 +1,10 @@
 import type { DidYouMean, DidYouMeanState } from '../../../../controllers/commerce/search/did-you-mean/headless-did-you-mean.js';
 import type { SearchOnlyControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
 export type { DidYouMean, DidYouMeanState };
-export type DidYouMeanDefinition = SearchOnlyControllerDefinitionWithoutProps<DidYouMean>;
 /**
  * Defines a `DidYouMean` controller instance.
  * @group Definers
  *
  * @returns The `DidYouMean` controller definition.
  */
-export declare function defineDidYouMean(): DidYouMeanDefinition;
+export declare function defineDidYouMean(): SearchOnlyControllerDefinitionWithoutProps<DidYouMean>;

package/dist/definitions/ssr-next/commerce/controllers/filter-suggestions/headless-filter-suggestions-generator.ssr.d.ts

@@ -4,7 +4,8 @@ import type { FilterSuggestions, FilterSuggestionsState } from '../../../../cont
 import { type FilterSuggestionsGenerator, type GeneratedFilterSuggestionsControllers } from '../../../../controllers/commerce/filter-suggestions/headless-filter-suggestions-generator.js';
 import type { NonRecommendationControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
 export type { FilterSuggestionsGenerator, GeneratedFilterSuggestionsControllers, FieldSuggestionsFacet, CategoryFilterSuggestions, CategoryFilterSuggestionsState, FilterSuggestions, FilterSuggestionsState, };
-export type FilterSuggestionsGeneratorDefinition = NonRecommendationControllerDefinitionWithoutProps<FilterSuggestionsGenerator>;
+export interface FilterSuggestionsGeneratorDefinition extends NonRecommendationControllerDefinitionWithoutProps<FilterSuggestionsGenerator> {
+}
 /**
  * Defines the `FilterSuggestionsGenerator` controller for the purpose of server-side rendering.
  * @group Definers

package/dist/definitions/ssr-next/commerce/controllers/generator/headless-commerce-facet-generator.ssr.d.ts

@@ -10,7 +10,7 @@ import type { NumericFacet, NumericFacetState, NumericFacetValue } from '../../.
 import type { RegularFacet, RegularFacetState } from '../../../../controllers/commerce/core/facets/regular/headless-commerce-regular-facet.js';
 import type { LocationFacetValue, RegularFacetValue } from '../../../../features/commerce/facets/facet-set/interfaces/response.js';
 import { SolutionType } from '../../types/controller-constants.js';
-import type { SearchAndListingControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
+import type { ControllerDefinitionOption, SubControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
 export type { BaseFacetSearchResult, CategoryFacet, CategoryFacetState, CategoryFacetValue, CategoryFacetSearchResult, CoreCommerceFacet, DateFacet, DateFacetValue, DateFacetState, NumericFacet, NumericFacetValue, NumericFacetState, RegularFacet, RegularFacetState, RegularFacetValue, LocationFacet, LocationFacetState, LocationFacetValue, MappedGeneratedFacetController, };
 export type FacetGeneratorState = MappedFacetStates;
 export type MappedFacetStates = Array<MappedFacetState[FacetType]>;
@@ -18,11 +18,10 @@ export type { FacetType };
 export type MappedFacetState = {
     [T in FacetType]: T extends 'numericalRange' ? NumericFacetState : T extends 'regular' ? RegularFacetState : T extends 'dateRange' ? DateFacetState : T extends 'hierarchical' ? CategoryFacetState : T extends 'location' ? LocationFacetState : never;
 };
-export type FacetGeneratorDefinition = SearchAndListingControllerDefinitionWithoutProps<FacetGenerator>;
 /**
  * @group Definers
  */
-export declare function defineFacetGenerator(): FacetGeneratorDefinition;
+export declare function defineFacetGenerator<TOptions extends ControllerDefinitionOption | undefined>(options?: TOptions): SubControllerDefinitionWithoutProps<FacetGenerator, TOptions>;
 /**
  * The `FacetGenerator` headless sub-controller creates commerce facet sub-controllers from the Commerce API search or
  * product listing response.

package/dist/definitions/ssr-next/commerce/controllers/instant-products/headless-instant-products.ssr.d.ts

@@ -1,7 +1,8 @@
 import { type InstantProducts, type InstantProductsOptions, type InstantProductsProps, type InstantProductsState } from '../../../../controllers/commerce/instant-products/headless-instant-products.js';
 import type { NonRecommendationControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
 export type { InstantProductsOptions, InstantProductsState, InstantProducts, InstantProductsProps, };
-export type InstantProductsDefinition = NonRecommendationControllerDefinitionWithoutProps<InstantProducts>;
+export interface InstantProductsDefinition extends NonRecommendationControllerDefinitionWithoutProps<InstantProducts> {
+}
 /**
  * Defines the `InstantProducts` controller for the purpose of server-side rendering.
  * @group Definers

package/dist/definitions/ssr-next/commerce/controllers/pagination/headless-core-commerce-pagination.ssr.d.ts

@@ -1,7 +1,6 @@
 import type { CorePaginationOptions, Pagination, PaginationOptions, PaginationProps, PaginationState } from '../../../../controllers/commerce/core/pagination/headless-core-commerce-pagination.js';
-import type { SearchAndListingControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
+import type { ControllerDefinitionOption, SubControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
 export type { Pagination, PaginationProps, PaginationState, PaginationOptions, CorePaginationOptions, };
-export type PaginationDefinition = SearchAndListingControllerDefinitionWithoutProps<Pagination>;
 /**
  * Defines a `Pagination` controller instance.
  * @group Definers
@@ -9,4 +8,4 @@ export type PaginationDefinition = SearchAndListingControllerDefinitionWithoutPr
  * @param props - The configurable `Pagination` properties.
  * @returns The `Pagination` controller definition.
  */
-export declare function definePagination(props?: PaginationProps): PaginationDefinition;
+export declare function definePagination<TOptions extends ControllerDefinitionOption | undefined>(props?: PaginationProps & TOptions): SubControllerDefinitionWithoutProps<Pagination, TOptions>;

package/dist/definitions/ssr-next/commerce/controllers/parameter-manager/headless-core-parameter-manager.ssr.d.ts

@@ -2,15 +2,25 @@ import type { ParameterManager, ParameterManagerProps, ParameterManagerState } f
 import type { Parameters } from '../../../../features/commerce/parameters/parameters-actions.js';
 import type { ProductListingParameters } from '../../../../features/commerce/product-listing-parameters/product-listing-parameters-actions.js';
 import type { CommerceSearchParameters } from '../../../../features/commerce/search-parameters/search-parameters-actions.js';
-import type { SearchAndListingControllerDefinitionWithProps } from '../../types/controller-definitions.js';
+import type { ControllerDefinitionOption, SubControllerDefinitionWithProps } from '../../types/controller-definitions.js';
 export type { ParameterManager, ParameterManagerProps, ParameterManagerState, Parameters, ProductListingParameters, CommerceSearchParameters, };
-export type ParameterManagerDefinition = SearchAndListingControllerDefinitionWithProps<ParameterManager<ProductListingParameters | CommerceSearchParameters>, SSRParameterManagerProps<ProductListingParameters | CommerceSearchParameters>>;
+export type ParameterManagerDefinition<TOptions extends ControllerDefinitionOption | undefined> = SubControllerDefinitionWithProps<ParameterManager<MappedParameterTypes<TOptions>>, TOptions, SSRParameterManagerProps<MappedParameterTypes<TOptions>>>;
 /**
  * Defines a `ParameterManager` controller instance.
  * @group Definers
  *
  * @returns The `ParameterManager` controller definition.
  */
-export declare function defineParameterManager(): ParameterManagerDefinition;
+export declare function defineParameterManager<TOptions extends ControllerDefinitionOption | undefined>(options?: TOptions): ParameterManagerDefinition<TOptions>;
 export interface SSRParameterManagerProps<T extends Parameters> extends Omit<ParameterManagerProps<T>, 'excludeDefaultParameters'> {
 }
+type MappedParameterTypes<TOptions extends ControllerDefinitionOption | undefined> = TOptions extends {
+    listing: true;
+    search: true;
+} | undefined ? ProductListingParameters | CommerceSearchParameters : TOptions extends {
+    listing: true;
+    search: false;
+} ? ProductListingParameters : TOptions extends {
+    listing: false;
+    search: true;
+} ? CommerceSearchParameters : never;

package/dist/definitions/ssr-next/commerce/controllers/product-list/headless-product-list.ssr.d.ts

@@ -1,13 +1,12 @@
 import { type ProductListing, type ProductListingState } from '../../../../controllers/commerce/product-listing/headless-product-listing.js';
 import { type Search } from '../../../../controllers/commerce/search/headless-search.js';
-import type { SearchAndListingControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
+import type { ControllerDefinitionOption, SubControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
 export type { Search, ProductListing, ProductListingState as ProductListState };
 export type ProductList = Pick<ProductListing | Search, 'state' | 'subscribe' | 'interactiveProduct' | 'promoteChildToParent'>;
-export type ProductListDefinition = SearchAndListingControllerDefinitionWithoutProps<ProductList>;
 /**
  * Defines a `ProductList` controller instance.
  * @group Definers
  *
  * @returns The `ProductList` controller definition.
  */
-export declare function defineProductList(): ProductListDefinition;
+export declare function defineProductList<TOptions extends ControllerDefinitionOption | undefined>(options?: TOptions): SubControllerDefinitionWithoutProps<ProductList, TOptions>;

package/dist/definitions/ssr-next/commerce/controllers/product-view/headless-product-view.ssr.d.ts

@@ -1,7 +1,8 @@
 import { type ProductView as BaseProductView } from '../../../../controllers/commerce/product-view/headless-product-view.js';
 import { type Controller } from '../../../../controllers/controller/headless-controller.js';
 import type { NonRecommendationControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
-export type ProductViewDefinition = NonRecommendationControllerDefinitionWithoutProps<ProductView>;
+interface ProductViewDefinition extends NonRecommendationControllerDefinitionWithoutProps<ProductView> {
+}
 /**
  * Defines a `ProductView` controller instance.
  *
@@ -16,3 +17,4 @@ export type ProductViewDefinition = NonRecommendationControllerDefinitionWithout
 export declare function defineProductView(): ProductViewDefinition;
 export interface ProductView extends BaseProductView, Controller {
 }
+export {};

package/dist/definitions/ssr-next/commerce/controllers/recent-queries-list/headless-recent-queries-list.ssr.d.ts

@@ -1,7 +1,8 @@
 import { type RecentQueriesList, type RecentQueriesListInitialState, type RecentQueriesListOptions, type RecentQueriesListProps, type RecentQueriesState } from '../../../../controllers/commerce/recent-queries-list/headless-recent-queries-list.js';
 import type { NonRecommendationControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
 export type { RecentQueriesListInitialState, RecentQueriesListOptions, RecentQueriesState, RecentQueriesList, RecentQueriesListProps, };
-export type RecentQueriesListDefinition = NonRecommendationControllerDefinitionWithoutProps<RecentQueriesList>;
+export interface RecentQueriesListDefinition extends NonRecommendationControllerDefinitionWithoutProps<RecentQueriesList> {
+}
 /**
  * Defines the `RecentQueriesList` controller for the purpose of server-side rendering.
  * @group Definers

package/dist/definitions/ssr-next/commerce/controllers/search-box/headless-search-box.ssr.d.ts

@@ -1,7 +1,8 @@
 import { type CoreSearchBox, type SearchBox, type SearchBoxOptions, type SearchBoxProps, type SearchBoxState, type Suggestion } from '../../../../controllers/commerce/search-box/headless-search-box.js';
 import type { SearchOnlyControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
 export type { CoreSearchBox, SearchBox, SearchBoxProps, SearchBoxState, SearchBoxOptions, Suggestion, };
-export type SearchBoxDefinition = SearchOnlyControllerDefinitionWithoutProps<SearchBox>;
+export interface SearchBoxDefinition extends SearchOnlyControllerDefinitionWithoutProps<SearchBox> {
+}
 /**
  * Defines a `SearchBox` controller instance.
  * @group Definers

package/dist/definitions/ssr-next/commerce/controllers/sort/headless-core-commerce-sort.ssr.d.ts

@@ -1,7 +1,6 @@
 import type { Sort, SortProps, SortState } from '../../../../controllers/commerce/core/sort/headless-core-commerce-sort.js';
-import type { SearchAndListingControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
+import type { ControllerDefinitionOption, SubControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
 export type { Sort, SortProps, SortState };
-export type SortDefinition = SearchAndListingControllerDefinitionWithoutProps<Sort>;
 /**
  * Defines a `Sort` controller instance.
  * @group Definers
@@ -9,4 +8,4 @@ export type SortDefinition = SearchAndListingControllerDefinitionWithoutProps<So
  * @param props - The configurable `Sort` properties.
  * @returns The `Sort` controller definition.
  */
-export declare function defineSort(props?: SortProps): SortDefinition;
+export declare function defineSort<TOptions extends ControllerDefinitionOption | undefined>(props?: SortProps & TOptions): SubControllerDefinitionWithoutProps<Sort, TOptions>;

package/dist/definitions/ssr-next/commerce/controllers/standalone-search-box/headless-standalone-search-box.ssr.d.ts

@@ -2,7 +2,8 @@ import { type StandaloneSearchBox, type StandaloneSearchBoxState } from '../../.
 import type { StandaloneSearchBoxProps } from '../../../../controllers/standalone-search-box/headless-standalone-search-box.js';
 import type { ListingAndStandaloneControllerWithoutProps } from '../../types/controller-definitions.js';
 export type { StandaloneSearchBoxState, StandaloneSearchBox, StandaloneSearchBoxProps, };
-export type StandaloneSearchBoxDefinition = ListingAndStandaloneControllerWithoutProps<StandaloneSearchBox>;
+export interface StandaloneSearchBoxDefinition extends ListingAndStandaloneControllerWithoutProps<StandaloneSearchBox> {
+}
 /**
  * Defines the `StandaloneSearchBox` controller for the purpose of server-side rendering.
  * @group Definers

package/dist/definitions/ssr-next/commerce/controllers/summary/headless-core-summary.ssr.d.ts

@@ -2,13 +2,12 @@ import type { Summary, SummaryState } from '../../../../controllers/commerce/cor
 import type { ProductListingSummaryState } from '../../../../controllers/commerce/product-listing/summary/headless-product-listing-summary.js';
 import type { RecommendationsSummaryState } from '../../../../controllers/commerce/recommendations/summary/headless-recommendations-summary.js';
 import type { SearchSummaryState } from '../../../../controllers/commerce/search/summary/headless-search-summary.js';
-import type { SearchAndListingControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
+import type { ControllerDefinitionOption, SubControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
 export type { Summary, ProductListingSummaryState, RecommendationsSummaryState, SearchSummaryState, SummaryState, };
-export type SummaryDefinition = SearchAndListingControllerDefinitionWithoutProps<Summary<ProductListingSummaryState | SearchSummaryState | RecommendationsSummaryState>>;
 /**
  * Defines a `Summary` controller instance.
  * @group Definers
  *
  * @returns The `Summary` controller definition.
  */
-export declare function defineSummary(): SummaryDefinition;
+export declare function defineSummary<TOptions extends ControllerDefinitionOption | undefined>(options?: TOptions): SubControllerDefinitionWithoutProps<Summary<ProductListingSummaryState | SearchSummaryState | RecommendationsSummaryState>, TOptions>;

package/dist/definitions/ssr-next/commerce/controllers/triggers/headless-notify-trigger.ssr.d.ts

@@ -1,7 +1,8 @@
 import type { NotifyTrigger, NotifyTriggerState } from '../../../../controllers/core/triggers/headless-core-notify-trigger.js';
 import type { SearchAndListingControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
 export type { NotifyTrigger, NotifyTriggerState };
-export type NotifyTriggerDefinition = SearchAndListingControllerDefinitionWithoutProps<NotifyTrigger>;
+export interface NotifyTriggerDefinition extends SearchAndListingControllerDefinitionWithoutProps<NotifyTrigger> {
+}
 /**
  * Defines the `NotifyTrigger` controller for the purpose of server-side rendering.
  * @group Definers

package/dist/definitions/ssr-next/commerce/controllers/triggers/headless-query-trigger.ssr.d.ts

@@ -2,7 +2,8 @@ import type { QueryTrigger } from '../../../../controllers/core/triggers/headles
 import type { SearchOnlyControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
 export type { QueryTriggerState } from '../../../../controllers/core/triggers/headless-core-query-trigger.js';
 export type { QueryTrigger };
-export type QueryTriggerDefinition = SearchOnlyControllerDefinitionWithoutProps<QueryTrigger>;
+export interface QueryTriggerDefinition extends SearchOnlyControllerDefinitionWithoutProps<QueryTrigger> {
+}
 /**
  * Defines the `QueryTrigger` controller for the purpose of server-side rendering.
  * @group Definers

package/dist/definitions/ssr-next/commerce/controllers/triggers/headless-redirection-trigger.ssr.d.ts

@@ -1,7 +1,8 @@
 import type { RedirectionTrigger, RedirectionTriggerState } from '../../../../controllers/core/triggers/headless-core-redirection-trigger.js';
 import type { SearchOnlyControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
 export type { RedirectionTrigger, RedirectionTriggerState };
-export type RedirectionTriggerDefinition = SearchOnlyControllerDefinitionWithoutProps<RedirectionTrigger>;
+export interface RedirectionTriggerDefinition extends SearchOnlyControllerDefinitionWithoutProps<RedirectionTrigger> {
+}
 /**
  * Defines the `RedirectionTrigger` controller for the purpose of server-side rendering.
  * @group Definers

package/dist/definitions/ssr-next/commerce/types/controller-definitions.d.ts

@@ -1,4 +1,5 @@
 import type { Controller } from '../../../controllers/controller/headless-controller.js';
+import type { InvalidControllerDefinition } from '../../common/errors.js';
 import type { InferControllerStaticStateFromController, InferControllerStaticStateMapFromControllers } from '../../common/types/controller-inference.js';
 import type { ControllersPropsMap } from '../../common/types/controllers.js';
 import type { HasKey, HasRequiredKeys, OptionsTuple } from '../../common/types/utilities.js';
@@ -7,7 +8,7 @@ import type { ContextDefinition } from '../controllers/context/headless-context.
 import type { ParameterManagerDefinition } from '../controllers/parameter-manager/headless-core-parameter-manager.ssr.js';
 import type { SSRCommerceEngine } from '../factories/build-factory.js';
 import { type recommendationInternalOptionKey, SolutionType } from './controller-constants.js';
-import type { ListingAndStandaloneController, NonRecommendationController, RecommendationOnlyController, SearchAndListingController, SearchOnlyController, UniversalController } from './controller-scopes.js';
+import type { ListingAndStandaloneController, ListingOnlyController, NonRecommendationController, RecommendationOnlyController, SearchAndListingController, SearchOnlyController, UniversalController } from './controller-scopes.js';
 import type { HydratedState } from './hydrate-static-state.js';
 import type { HasSolutionType } from './utilities.js';
 export type { HydratedState, OptionsTuple, InferControllerStaticStateFromController, InferControllerStaticStateMapFromControllers, };
@@ -43,7 +44,10 @@ export interface ControllerDefinitionsMap<TController extends Controller> {
     [customName: string]: ControllerDefinition<TController>;
 }
 type BakedInControllerDefinitions = {
-    parameterManager: ParameterManagerDefinition;
+    parameterManager: ParameterManagerDefinition<{
+        listing: true;
+        search: true;
+    }>;
     context: ContextDefinition;
     cart: CartDefinition;
 };
@@ -85,10 +89,51 @@ export type IsRecommendationController<TController extends ControllerDefinition<
 type DefaultControllerProps<TControllers extends ControllerDefinitionsMap<Controller>, TControllersPropsMap extends ControllersPropsMap, K extends keyof TControllers> = {
     [I in keyof TControllersPropsMap as I extends K ? I : never]: TControllersPropsMap[I];
 };
+export interface ControllerDefinitionOption {
+    /**
+     * Whether the controller will be used in a product listing context.
+     * @defaultValue true
+     */
+    listing?: boolean;
+    /**
+     * Whether the controller will be used in a search page context.
+     * @defaultValue true
+     */
+    search?: boolean;
+}
 export type SearchOnlyControllerDefinitionWithoutProps<TController extends Controller> = ControllerDefinitionWithoutProps<TController> & SearchOnlyController;
+type SearchOnlyControllerDefinitionWithProps<TController extends Controller, TProps> = ControllerDefinitionWithProps<TController, TProps> & SearchOnlyController;
 export type ListingAndStandaloneControllerWithoutProps<TController extends Controller> = ControllerDefinitionWithoutProps<TController> & ListingAndStandaloneController;
+type ListingOnlyControllerDefinitionWithoutProps<TController extends Controller> = ControllerDefinitionWithoutProps<TController> & ListingOnlyController;
+type ListingOnlyControllerDefinitionWithProps<TController extends Controller, TProps> = ControllerDefinitionWithProps<TController, TProps> & ListingOnlyController;
 export type RecommendationOnlyControllerDefinitionWithProps<TController extends Controller, TProps> = ControllerDefinitionWithProps<TController, TProps> & RecommendationOnlyController;
 export type NonRecommendationControllerDefinitionWithoutProps<TController extends Controller> = ControllerDefinitionWithoutProps<TController> & NonRecommendationController;
 export type UniversalControllerDefinitionWithProps<TController extends Controller, TProps> = ControllerDefinitionWithProps<TController, TProps> & UniversalController;
 export type SearchAndListingControllerDefinitionWithoutProps<TController extends Controller> = ControllerDefinitionWithoutProps<TController> & SearchAndListingController;
-export type SearchAndListingControllerDefinitionWithProps<TController extends Controller, TProps> = ControllerDefinitionWithProps<TController, TProps> & SearchAndListingController;
+type SearchAndListingControllerDefinitionWithProps<TController extends Controller, TProps> = ControllerDefinitionWithProps<TController, TProps> & SearchAndListingController;
+export type SubControllerDefinitionWithoutProps<TController extends Controller, TDefinition extends ControllerDefinitionOption | undefined> = TDefinition extends {
+    listing?: true;
+    search?: true;
+} | undefined ? SearchAndListingControllerDefinitionWithoutProps<TController> : TDefinition extends {
+    listing?: true;
+    search?: false;
+} ? ListingOnlyControllerDefinitionWithoutProps<TController> : TDefinition extends {
+    listing?: false;
+    search?: true;
+} ? SearchOnlyControllerDefinitionWithoutProps<TController> : TDefinition extends {
+    listing: false;
+    search: false;
+} ? InvalidControllerDefinition : never;
+export type SubControllerDefinitionWithProps<TController extends Controller, TDefinition extends ControllerDefinitionOption | undefined, TProps> = TDefinition extends {
+    listing?: true;
+    search?: true;
+} | undefined ? SearchAndListingControllerDefinitionWithProps<TController, TProps> : TDefinition extends {
+    listing?: true;
+    search?: false;
+} ? ListingOnlyControllerDefinitionWithProps<TController, TProps> : TDefinition extends {
+    listing?: false;
+    search?: true;
+} ? SearchOnlyControllerDefinitionWithProps<TController, TProps> : TDefinition extends {
+    listing: false;
+    search: false;
+} ? InvalidControllerDefinition : never;

package/dist/definitions/ssr-next/commerce/types/controller-scopes.d.ts

@@ -37,6 +37,12 @@ export interface SearchOnlyController {
      */
     [SolutionType.search]: true;
 }
+export interface ListingOnlyController {
+    /**
+     * @internal
+     */
+    [SolutionType.listing]: true;
+}
 export interface RecommendationOnlyController {
     /**
      * @internal

package/dist/definitions/ssr-next/common/errors.d.ts

@@ -1,3 +1,6 @@
+export declare class InvalidControllerDefinition extends Error {
+    constructor();
+}
 export declare class MissingControllerProps extends Error {
     constructor(controller: string);
 }

package/dist/esm/controllers/relevance-inspector/headless-relevance-inspector.js

@@ -82,7 +82,7 @@ export function buildRelevanceInspector(engine, props = {}) {
             warnProductionEnvironment('fieldsDescription');
             engine.logger.warn(`For production environment, please specify the necessary fields either when instantiating a ResultList controller, or by dispatching a registerFieldsToInclude action.
         
-        https://docs.coveo.com/en/headless/latest/reference/interfaces/Search.ResultListOptions.html
+        hhttps://docs.coveo.com/en/headless/latest/reference/interfaces/Search.ResultListOptions.html
         https://docs.coveo.com/en/headless/latest/reference/interfaces/Search.FieldActionCreators.html#registerfieldstoinclude`);
         },
     };

package/dist/esm/ssr-next/commerce/controller-utils.js

@@ -1,6 +1,7 @@
 import { clone, filterObject, mapObject } from '../../utils/utils.js';
 import { ControllerBuilder } from '../common/builders/controller-builder.js';
 import { createStaticControllerBuilder } from '../common/builders/static-controller-builder.js';
+import { InvalidControllerDefinition } from '../common/errors.js';
 export function createStaticState({ searchActions, controllers, }) {
     return {
         controllers: mapObject(controllers, (controller) => createStaticControllerBuilder(controller).build()),
@@ -22,3 +23,8 @@ export function buildControllerDefinitions({ definitionsMap, engine, solutionTyp
     });
     return filterObject(controllerMap, (value) => value !== null);
 }
+export function ensureAtLeastOneSolutionType(options) {
+    if (options?.listing === false && options?.search === false) {
+        throw new InvalidControllerDefinition();
+    }
+}

package/dist/esm/ssr-next/commerce/controllers/breadcrumb-manager/headless-core-breadcrumb-manager.ssr.js

@@ -1,5 +1,6 @@
 import { buildProductListing } from '../../../../controllers/commerce/product-listing/headless-product-listing.js';
 import { buildSearch } from '../../../../controllers/commerce/search/headless-search.js';
+import { ensureAtLeastOneSolutionType } from '../../controller-utils.js';
 import { SolutionType } from '../../types/controller-constants.js';
 /**
  * Defines a `BreadcrumbManager` controller instance.
@@ -7,10 +8,12 @@ import { SolutionType } from '../../types/controller-constants.js';
  *
  * @returns The `BreadcrumbManager` controller definition.
  */
-export function defineBreadcrumbManager() {
+export function defineBreadcrumbManager(options) {
+    ensureAtLeastOneSolutionType(options);
     return {
         listing: true,
         search: true,
+        ...options,
         build: (engine, solutionType) => solutionType === SolutionType.listing
             ? buildProductListing(engine).breadcrumbManager()
             : buildSearch(engine).breadcrumbManager(),

package/dist/esm/ssr-next/commerce/controllers/generator/headless-commerce-facet-generator.ssr.js

@@ -15,14 +15,17 @@ import { manualNumericFacetReducer as manualNumericFacetSet } from '../../../../
 import { categoryFacetSearchStateSelector } from '../../../../features/facets/facet-search-set/category/category-facet-search-state-selector.js';
 import { specificFacetSearchStateSelector } from '../../../../features/facets/facet-search-set/specific/specific-facet-search-state-selector.js';
 import { loadReducerError } from '../../../../utils/errors.js';
+import { ensureAtLeastOneSolutionType } from '../../controller-utils.js';
 import { SolutionType } from '../../types/controller-constants.js';
 /**
  * @group Definers
  */
-export function defineFacetGenerator() {
+export function defineFacetGenerator(options) {
+    ensureAtLeastOneSolutionType(options);
     return {
         listing: true,
         search: true,
+        ...options,
         build: (engine, solutionType) => buildFacetGenerator(engine, { props: { solutionType: solutionType } }),
     };
 }

package/dist/esm/ssr-next/commerce/controllers/pagination/headless-core-commerce-pagination.ssr.js

@@ -1,5 +1,6 @@
 import { buildProductListing } from '../../../../controllers/commerce/product-listing/headless-product-listing.js';
 import { buildSearch } from '../../../../controllers/commerce/search/headless-search.js';
+import { ensureAtLeastOneSolutionType } from '../../controller-utils.js';
 import { SolutionType } from '../../types/controller-constants.js';
 /**
  * Defines a `Pagination` controller instance.
@@ -9,6 +10,7 @@ import { SolutionType } from '../../types/controller-constants.js';
  * @returns The `Pagination` controller definition.
  */
 export function definePagination(props) {
+    ensureAtLeastOneSolutionType(props);
     return {
         listing: true,
         search: true,

package/dist/esm/ssr-next/commerce/controllers/parameter-manager/headless-core-parameter-manager.ssr.js

@@ -9,6 +9,7 @@ import { sortReducer as commerceSort } from '../../../../features/commerce/sort/
 import { facetOrderReducer as facetOrder } from '../../../../features/facets/facet-order/facet-order-slice.js';
 import { querySetReducer as querySet } from '../../../../features/query-set/query-set-slice.js';
 import { loadReducerError } from '../../../../utils/errors.js';
+import { ensureAtLeastOneSolutionType } from '../../controller-utils.js';
 import { SolutionType } from '../../types/controller-constants.js';
 /**
  * Defines a `ParameterManager` controller instance.
@@ -16,10 +17,12 @@ import { SolutionType } from '../../types/controller-constants.js';
  *
  * @returns The `ParameterManager` controller definition.
  */
-export function defineParameterManager() {
+export function defineParameterManager(options) {
+    ensureAtLeastOneSolutionType(options);
     return {
         listing: true,
         search: true,
+        ...options,
         buildWithProps: (engine, props, solutionType) => {
             if (solutionType === SolutionType.listing) {
                 if (!loadCommerceProductListingParameterReducers(engine)) {

package/dist/esm/ssr-next/commerce/controllers/product-list/headless-product-list.ssr.js

@@ -1,5 +1,6 @@
 import { buildProductListing, } from '../../../../controllers/commerce/product-listing/headless-product-listing.js';
 import { buildSearch, } from '../../../../controllers/commerce/search/headless-search.js';
+import { ensureAtLeastOneSolutionType } from '../../controller-utils.js';
 import { SolutionType } from '../../types/controller-constants.js';
 /**
  * Defines a `ProductList` controller instance.
@@ -7,10 +8,12 @@ import { SolutionType } from '../../types/controller-constants.js';
  *
  * @returns The `ProductList` controller definition.
  */
-export function defineProductList() {
+export function defineProductList(options) {
+    ensureAtLeastOneSolutionType(options);
     return {
         listing: true,
         search: true,
+        ...options,
         build: (engine, solutionType) => solutionType === SolutionType.listing
             ? buildProductListing(engine)
             : buildSearch(engine),