@coveo/headless 3.29.2-pre.fbfa5ff328 → 3.29.2

package/dist/definitions/ssr-next/search/controllers/history-manager/headless-history-manager.ssr.d.ts

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type HistoryManager } from '../../../../controllers/history-manager/headless-history-manager.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/history-manager/headless-history-manager.js';
 export interface HistoryManagerDefinition extends ControllerDefinitionWithoutProps<SearchEngine, HistoryManager> {
 }

package/dist/definitions/ssr-next/search/controllers/instant-results/instant-results.ssr.d.ts

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type InstantResultProps, type InstantResults } from '../../../../controllers/instant-results/instant-results.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/instant-results/instant-results.js';
 export interface InstantResultsDefinition extends ControllerDefinitionWithoutProps<SearchEngine, InstantResults> {
 }

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

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type Pager, type PagerProps } from '../../../../controllers/pager/headless-pager.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/pager/headless-pager.js';
 export interface PagerDefinition extends ControllerDefinitionWithoutProps<SearchEngine, Pager> {
 }

package/dist/definitions/ssr-next/search/controllers/query-error/headless-query-error.ssr.d.ts

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type QueryError } from '../../../../controllers/query-error/headless-query-error.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/query-error/headless-query-error.js';
 export interface QueryErrorDefinition extends ControllerDefinitionWithoutProps<SearchEngine, QueryError> {
 }

package/dist/definitions/ssr-next/search/controllers/query-summary/headless-query-summary.ssr.d.ts

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type QuerySummary } from '../../../../controllers/query-summary/headless-query-summary.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/query-summary/headless-query-summary.js';
 export interface QuerySummaryDefinition extends ControllerDefinitionWithoutProps<SearchEngine, QuerySummary> {
 }

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

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type Quickview, type QuickviewProps } from '../../../../controllers/quickview/headless-quickview.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/quickview/headless-quickview.js';
 export interface QuickviewDefinition extends ControllerDefinitionWithoutProps<SearchEngine, Quickview> {
 }

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

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type RecentQueriesList, type RecentQueriesListProps } from '../../../../controllers/recent-queries-list/headless-recent-queries-list.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/recent-queries-list/headless-recent-queries-list.js';
 export interface RecentQueriesListDefinition extends ControllerDefinitionWithoutProps<SearchEngine, RecentQueriesList> {
 }

package/dist/definitions/ssr-next/search/controllers/recent-results-list/headless-recent-results-list.ssr.d.ts

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type RecentResultsList, type RecentResultsListProps } from '../../../../controllers/recent-results-list/headless-recent-results-list.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/recent-results-list/headless-recent-results-list.js';
 export interface RecentResultsListDefinition extends ControllerDefinitionWithoutProps<SearchEngine, RecentResultsList> {
 }

package/dist/definitions/ssr-next/search/controllers/relevance-inspector/headless-relevance-inspector.ssr.d.ts

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type RelevanceInspector, type RelevanceInspectorProps } from '../../../../controllers/relevance-inspector/headless-relevance-inspector.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/relevance-inspector/headless-relevance-inspector.js';
 export interface RelevanceInspectorDefinition extends ControllerDefinitionWithoutProps<SearchEngine, RelevanceInspector> {
 }

package/dist/definitions/ssr-next/search/controllers/result-list/headless-result-list.ssr.d.ts

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type ResultList, type ResultListProps } from '../../../../controllers/result-list/headless-result-list.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/result-list/headless-result-list.js';
 export interface ResultListDefinition extends ControllerDefinitionWithoutProps<SearchEngine, ResultList> {
 }

package/dist/definitions/ssr-next/search/controllers/results-per-page/headless-results-per-page.ssr.d.ts

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type ResultsPerPage, type ResultsPerPageProps } from '../../../../controllers/results-per-page/headless-results-per-page.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/results-per-page/headless-results-per-page.js';
 export interface ResultsPerPageDefinition extends ControllerDefinitionWithoutProps<SearchEngine, ResultsPerPage> {
 }

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

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type SearchBox, type SearchBoxProps } from '../../../../controllers/search-box/headless-search-box.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/search-box/headless-search-box.js';
 export interface SearchBoxDefinition extends ControllerDefinitionWithoutProps<SearchEngine, SearchBox> {
 }

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

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type SearchParameterManager, type SearchParameterManagerInitialState } from '../../../../controllers/search-parameter-manager/headless-search-parameter-manager.js';
-import type { ControllerDefinitionWithProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/search-parameter-manager/headless-search-parameter-manager.js';
 export interface SearchParameterManagerBuildProps {
     initialState: SearchParameterManagerInitialState;

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

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type SearchStatus } from '../../../../controllers/search-status/headless-search-status.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/search-status/headless-search-status.js';
 export interface SearchStatusDefinition extends ControllerDefinitionWithoutProps<SearchEngine, SearchStatus> {
 }

package/dist/definitions/ssr-next/search/controllers/smart-snippet/headless-smart-snippet.ssr.d.ts

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type SmartSnippet, type SmartSnippetProps } from '../../../../controllers/smart-snippet/headless-smart-snippet.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/smart-snippet/headless-smart-snippet.js';
 export interface SmartSnippetDefinition extends ControllerDefinitionWithoutProps<SearchEngine, SmartSnippet> {
 }

package/dist/definitions/ssr-next/search/controllers/smart-snippet-questions-list/headless-smart-snippet-questions-list.ssr.d.ts

@@ -1,7 +1,7 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import type { SmartSnippetQuestionsListProps } from '../../../../controllers/core/smart-snippet-questions-list/headless-core-smart-snippet-questions-list.js';
 import { type SmartSnippetQuestionsList } from '../../../../controllers/smart-snippet-questions-list/headless-smart-snippet-questions-list.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/smart-snippet-questions-list/headless-smart-snippet-questions-list.js';
 export interface SmartSnippetQuestionsListDefinition extends ControllerDefinitionWithoutProps<SearchEngine, SmartSnippetQuestionsList> {
 }

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

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type Sort, type SortProps } from '../../../../controllers/sort/headless-sort.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/sort/headless-sort.js';
 export interface SortDefinition extends ControllerDefinitionWithoutProps<SearchEngine, Sort> {
 }

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

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type StandaloneSearchBox, type StandaloneSearchBoxProps } from '../../../../controllers/standalone-search-box/headless-standalone-search-box.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/standalone-search-box/headless-standalone-search-box.js';
 export interface StandaloneSearchBoxDefinition extends ControllerDefinitionWithoutProps<SearchEngine, StandaloneSearchBox> {
 }

package/dist/definitions/ssr-next/search/controllers/static-filter/headless-static-filter.ssr.d.ts

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type StaticFilter, type StaticFilterProps } from '../../../../controllers/static-filter/headless-static-filter.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/static-filter/headless-static-filter.js';
 export { buildStaticFilterValue } from '../../../../controllers/static-filter/headless-static-filter.js';
 export interface StaticFilterDefinition extends ControllerDefinitionWithoutProps<SearchEngine, StaticFilter> {

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

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type Tab, type TabProps } from '../../../../controllers/tab/headless-tab.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/tab/headless-tab.js';
 export interface TabDefinition extends ControllerDefinitionWithoutProps<SearchEngine, Tab> {
 }

package/dist/definitions/ssr-next/search/controllers/tab-manager/headless-tab-manager.ssr.d.ts

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type TabManager } from '../../../../controllers/tab-manager/headless-tab-manager.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/tab-manager/headless-tab-manager.js';
 interface TabManagerDefinition extends ControllerDefinitionWithoutProps<SearchEngine, TabManager> {
 }

package/dist/definitions/ssr-next/search/controllers/triggers/headless-execute-trigger.ssr.d.ts

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type ExecuteTrigger } from '../../../../controllers/triggers/headless-execute-trigger.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/triggers/headless-execute-trigger.js';
 export interface ExecuteTriggerDefinition extends ControllerDefinitionWithoutProps<SearchEngine, ExecuteTrigger> {
 }

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

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import type { NotifyTrigger } from '../../../../controllers/core/triggers/headless-core-notify-trigger.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export type { NotifyTrigger, NotifyTriggerState, } from '../../../../controllers/core/triggers/headless-core-notify-trigger.js';
 export interface NotifyTriggerDefinition extends ControllerDefinitionWithoutProps<SearchEngine, NotifyTrigger> {
 }

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

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import type { QueryTrigger } from '../../../../controllers/core/triggers/headless-core-query-trigger.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export type { QueryTrigger, QueryTriggerState, } from '../../../../controllers/core/triggers/headless-core-query-trigger.js';
 export * from '../../../../controllers/triggers/headless-query-trigger.js';
 export interface QueryTriggerDefinition extends ControllerDefinitionWithoutProps<SearchEngine, QueryTrigger> {

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

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import type { RedirectionTrigger } from '../../../../controllers/core/triggers/headless-core-redirection-trigger.js';
-import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export type { RedirectionTrigger, RedirectionTriggerState, } from '../../../../controllers/core/triggers/headless-core-redirection-trigger.js';
 export interface RedirectionTriggerDefinition extends ControllerDefinitionWithoutProps<SearchEngine, RedirectionTrigger> {
 }

package/dist/definitions/ssr-next/search/controllers/url-manager/headless-url-manager.ssr.d.ts

@@ -1,6 +1,6 @@
 import type { SearchEngine } from '../../../../app/search-engine/search-engine.js';
 import { type UrlManager, type UrlManagerInitialState } from '../../../../controllers/url-manager/headless-url-manager.js';
-import type { ControllerDefinitionWithProps } from '../../../common/types/controllers.js';
+import type { ControllerDefinitionWithProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/url-manager/headless-url-manager.js';
 /**
  * @internal

package/dist/definitions/ssr-next/search/engine/search-engine.ssr.d.ts

@@ -1,10 +1,10 @@
 import type { NavigatorContextProvider } from '../../../app/navigator-context-provider.js';
-import { type SearchEngine, type SearchEngineOptions } from '../../../app/search-engine/search-engine.js';
+import { type SearchEngine } from '../../../app/search-engine/search-engine.js';
 import type { Controller } from '../../../controllers/controller/headless-controller.js';
 import type { LegacySearchAction } from '../../../features/analytics/analytics-utils.js';
-import type { ControllerDefinitionsMap } from '../../common/types/controllers.js';
-import type { EngineDefinition, EngineDefinitionOptions } from '../../common/types/engine.js';
-import type { InferControllerPropsMapFromDefinitions, InferControllerStaticStateMapFromDefinitions } from '../../common/types/inference.js';
+import type { ControllerDefinitionsMap } from '../types/controller-definition.js';
+import type { InferControllerPropsMapFromDefinitions, InferControllerStaticStateMapFromDefinitions } from '../types/controller-inference.js';
+import type { SearchEngineDefinitionOptions } from '../types/engine.js';
 /**
  * The SSR search engine.
  *
@@ -16,14 +16,7 @@ export interface SSRSearchEngine extends SearchEngine {
      */
     waitForSearchCompletedAction(): Promise<SearchCompletedAction>;
 }
-/**
- * The options to create a search engine definition in SSR.
- *
- * @group Engine
- */
-export type SearchEngineDefinitionOptions<TControllers extends ControllerDefinitionsMap<SSRSearchEngine, Controller>> = EngineDefinitionOptions<SearchEngineOptions, TControllers>;
 export type SearchCompletedAction = ReturnType<LegacySearchAction['fulfilled' | 'rejected']>;
-export type SearchEngineDefinition<TControllers extends ControllerDefinitionsMap<SSRSearchEngine, Controller>> = EngineDefinition<SSRSearchEngine, TControllers>;
 /**
  * Initializes a Search engine definition in SSR with given controllers definitions and search engine config.
  *
@@ -34,7 +27,7 @@ export type SearchEngineDefinition<TControllers extends ControllerDefinitionsMap
  * @group Engine
  */
 export declare function defineSearchEngine<TControllerDefinitions extends ControllerDefinitionsMap<SearchEngine, Controller>>(options: SearchEngineDefinitionOptions<TControllerDefinitions>): {
-    fetchStaticState: import("../../common/types/fetch-static-state.js").FetchStaticState<import("redux").AnyAction, InferControllerStaticStateMapFromDefinitions<TControllerDefinitions>, InferControllerPropsMapFromDefinitions<TControllerDefinitions>>;
-    hydrateStaticState: import("../../common/types/hydrate-static-state.js").HydrateStaticState<SSRSearchEngine, import("../../common/types/inference.js").InferControllersMapFromDefinition<TControllerDefinitions>, import("redux").AnyAction, InferControllerPropsMapFromDefinitions<TControllerDefinitions>>;
+    fetchStaticState: import("../types/fetch-static-state.js").FetchStaticState<import("redux").AnyAction, InferControllerStaticStateMapFromDefinitions<TControllerDefinitions>, InferControllerPropsMapFromDefinitions<TControllerDefinitions>>;
+    hydrateStaticState: import("../types/hydrate-static-state.js").HydrateStaticState<SSRSearchEngine, import("../types/controller-inference.js").InferControllersMapFromDefinition<TControllerDefinitions>, import("redux").AnyAction, InferControllerPropsMapFromDefinitions<TControllerDefinitions>>;
     setNavigatorContextProvider: (navigatorContextProvider: NavigatorContextProvider) => void;
 };

package/dist/definitions/ssr-next/search/types/build.d.ts

@@ -0,0 +1,12 @@
+import type { CoreEngine, CoreEngineNext } from '../../../app/engine.js';
+import type { ControllersMap, ControllersPropsMap } from '../../common/types/controllers.js';
+import type { OptionsExtender, OptionsTuple } from '../../common/types/utilities.js';
+import type { SearchEngineDefinitionBuildResult, SearchEngineDefinitionControllersPropsOption } from './engine.js';
+interface BuildOptions<TEngineOptions> {
+    extend?: OptionsExtender<TEngineOptions>;
+}
+/**
+ * @internal
+ */
+export type Build<TEngine extends CoreEngine | CoreEngineNext, TEngineOptions, TControllersMap extends ControllersMap, TControllersProps extends ControllersPropsMap> = (...params: OptionsTuple<BuildOptions<TEngineOptions> & SearchEngineDefinitionControllersPropsOption<TControllersProps>>) => Promise<SearchEngineDefinitionBuildResult<TEngine, TControllersMap>>;
+export {};

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

@@ -0,0 +1,28 @@
+import type { CoreEngine, CoreEngineNext } from '../../../app/engine.js';
+import type { Controller } from '../../../controllers/controller/headless-controller.js';
+import type { InferControllerStaticStateFromController, InferControllerStaticStateMapFromControllers } from '../../common/types/controller-inference.js';
+import type { InferHydratedState, InferStaticState } from '../../common/types/engine.js';
+export type { InferStaticState, InferHydratedState, InferControllerStaticStateFromController, InferControllerStaticStateMapFromControllers, };
+export interface ControllerDefinitionWithoutProps<TEngine extends CoreEngine | CoreEngineNext, TController extends Controller> {
+    /**
+     * Creates an instance of the given controller.
+     *
+     * @param engine - The search engine.
+     * @returns The controller.
+     */
+    build(engine: TEngine): TController;
+}
+export interface ControllerDefinitionWithProps<TEngine extends CoreEngine | CoreEngineNext, TController extends Controller, TProps> {
+    /**
+     * Creates an instance of the given controller.
+     *
+     * @param engine - The search engine.
+     * @param props - The controller properties.
+     * @returns The controller.
+     */
+    buildWithProps(engine: TEngine, props?: TProps): TController;
+}
+export type ControllerDefinition<TEngine extends CoreEngine | CoreEngineNext, TController extends Controller> = ControllerDefinitionWithoutProps<TEngine, TController> | ControllerDefinitionWithProps<TEngine, TController, unknown>;
+export interface ControllerDefinitionsMap<TEngine extends CoreEngine | CoreEngineNext, TController extends Controller> {
+    [customName: string]: ControllerDefinition<TEngine, TController>;
+}

package/dist/definitions/ssr-next/{common/types/inference.d.ts → search/types/controller-inference.d.ts}

@@ -1,7 +1,8 @@
 import type { CoreEngine, CoreEngineNext } from '../../../app/engine.js';
 import type { Controller } from '../../../controllers/controller/headless-controller.js';
-import type { ControllerDefinition, ControllerDefinitionsMap, ControllerDefinitionWithoutProps, ControllerDefinitionWithProps, ControllerStaticState, ControllersMap } from './controllers.js';
-import type { HasKeys } from './utilities.js';
+import type { InferControllerStaticStateFromController } from '../../common/types/controller-inference.js';
+import type { HasKeys } from '../../common/types/utilities.js';
+import type { ControllerDefinition, ControllerDefinitionsMap, ControllerDefinitionWithoutProps, ControllerDefinitionWithProps } from './controller-definition.js';
 type InferControllerPropsFromDefinition<TController extends ControllerDefinition<CoreEngine | CoreEngineNext, Controller>> = TController extends ControllerDefinitionWithProps<CoreEngine | CoreEngineNext, Controller, infer Props> ? Props : TController extends ControllerDefinitionWithoutProps<CoreEngine | CoreEngineNext, Controller> ? {} : unknown;
 export type InferControllerPropsMapFromDefinitions<TControllers extends ControllerDefinitionsMap<CoreEngine | CoreEngineNext, Controller>> = {
     [K in keyof TControllers as HasKeys<InferControllerPropsFromDefinition<TControllers[K]>> extends false ? never : K]: InferControllerPropsFromDefinition<TControllers[K]>;
@@ -10,11 +11,7 @@ export type InferControllerFromDefinition<TDefinition extends ControllerDefiniti
 export type InferControllersMapFromDefinition<TControllers extends ControllerDefinitionsMap<CoreEngine | CoreEngineNext, Controller>> = {
     [K in keyof TControllers]: InferControllerFromDefinition<TControllers[K]>;
 };
-export type InferControllerStaticStateFromController<TController extends Controller> = ControllerStaticState<TController['state']>;
 export type InferControllerStaticStateMapFromDefinitions<TControllers extends ControllerDefinitionsMap<CoreEngine | CoreEngineNext, Controller>> = {
     [K in keyof TControllers]: InferControllerStaticStateFromController<InferControllerFromDefinition<TControllers[K]>> & InferControllerPropsFromDefinition<TControllers[K]>;
 };
-export type InferControllerStaticStateMapFromControllers<TControllers extends ControllersMap> = {
-    [K in keyof TControllers]: InferControllerStaticStateFromController<TControllers[K]>;
-};
 export {};

package/dist/definitions/ssr-next/search/types/engine.d.ts

@@ -0,0 +1,52 @@
+import type { AnyAction } from '@reduxjs/toolkit';
+import type { CoreEngine, CoreEngineNext } from '../../../app/engine.js';
+import type { NavigatorContextProvider } from '../../../app/navigator-context-provider.js';
+import type { SearchEngineOptions } from '../../../app/search-engine/search-engine.js';
+import type { Controller } from '../../../controllers/controller/headless-controller.js';
+import type { ControllersMap, ControllersPropsMap } from '../../common/types/controllers.js';
+import type { HasKeys } from '../../common/types/utilities.js';
+import type { SSRSearchEngine } from '../engine/search-engine.ssr.js';
+import type { Build } from './build.js';
+import type { ControllerDefinitionsMap } from './controller-definition.js';
+import type { InferControllerPropsMapFromDefinitions, InferControllerStaticStateMapFromDefinitions, InferControllersMapFromDefinition } from './controller-inference.js';
+import type { FetchStaticState } from './fetch-static-state.js';
+import type { HydrateStaticState } from './hydrate-static-state.js';
+export type EngineBuildResult<TEngine extends CoreEngine | CoreEngineNext, TControllers extends ControllerDefinitionsMap<TEngine, Controller>, TEngineOptions> = Build<TEngine, TEngineOptions, InferControllersMapFromDefinition<TControllers>, InferControllerPropsMapFromDefinitions<TControllers>>;
+/**
+ * The options to create a search engine definition in SSR.
+ *
+ * @group Engine
+ */
+export type SearchEngineDefinitionOptions<TControllers extends ControllerDefinitionsMap<SSRSearchEngine, Controller>> = SearchEngineOptions & {
+    /**
+     * The controllers to initialize with the search engine.
+     */
+    controllers?: TControllers;
+};
+export interface SearchEngineDefinition<TEngine extends CoreEngine | CoreEngineNext, TControllers extends ControllerDefinitionsMap<TEngine, Controller>> {
+    /**
+     * Fetches the static state on the server side using your engine definition.
+     */
+    fetchStaticState: FetchStaticState<AnyAction, InferControllerStaticStateMapFromDefinitions<TControllers>, InferControllerPropsMapFromDefinitions<TControllers>>;
+    /**
+     * Fetches the hydrated state on the client side using your engine definition and the static state.
+     */
+    hydrateStaticState: HydrateStaticState<TEngine, InferControllersMapFromDefinition<TControllers>, AnyAction, InferControllerPropsMapFromDefinitions<TControllers>>;
+    /**
+     * Sets the navigator context provider.
+     * This provider is essential for retrieving navigation-related data such as referrer, userAgent, location, and clientId, which are crucial for handling both server-side and client-side API requests effectively.
+     *
+     * Note: The implementation specifics of the navigator context provider depend on the Node.js framework being utilized. It is the developer's responsibility to appropriately define and implement the navigator context provider to ensure accurate navigation context is available throughout the application. If the user fails to provide a navigator context provider, a warning will be logged either on the server or the browser console.
+     */
+    setNavigatorContextProvider: (navigatorContextProvider: NavigatorContextProvider) => void;
+}
+/**
+ * This type defines the required and optional controller props for the search engine definition.
+ */
+export type SearchEngineDefinitionControllersPropsOption<TControllersPropsMap extends ControllersPropsMap> = HasKeys<TControllersPropsMap> extends false ? {} : {
+    controllers: TControllersPropsMap;
+};
+export interface SearchEngineDefinitionBuildResult<TEngine extends CoreEngine | CoreEngineNext, TControllers extends ControllersMap> {
+    engine: TEngine;
+    controllers: TControllers;
+}

package/dist/definitions/ssr-next/{common → search}/types/fetch-static-state.d.ts

@@ -1,10 +1,11 @@
 import type { UnknownAction } from '@reduxjs/toolkit';
-import type { ControllerStaticStateMap, ControllersPropsMap } from './controllers.js';
-import type { EngineDefinitionControllersPropsOption, EngineStaticState } from './engine.js';
-import type { OptionsTuple } from './utilities.js';
+import type { ControllerStaticStateMap, ControllersPropsMap } from '../../common/types/controllers.js';
+import type { EngineStaticState } from '../../common/types/engine.js';
+import type { OptionsTuple } from '../../common/types/utilities.js';
+import type { SearchEngineDefinitionControllersPropsOption } from './engine.js';
 /**
  * Executes only the initial search for a given configuration, then returns a resumable snapshot of engine state along with the state of the controllers.
  *
  * Useful for static generation and server-side rendering.
  */
-export type FetchStaticState<TSearchAction extends UnknownAction, TControllersStaticState extends ControllerStaticStateMap, TControllersProps extends ControllersPropsMap> = (...params: OptionsTuple<EngineDefinitionControllersPropsOption<TControllersProps>>) => Promise<EngineStaticState<TSearchAction, TControllersStaticState>>;
+export type FetchStaticState<TSearchAction extends UnknownAction, TControllersStaticState extends ControllerStaticStateMap, TControllersProps extends ControllersPropsMap> = (...params: OptionsTuple<SearchEngineDefinitionControllersPropsOption<TControllersProps>>) => Promise<EngineStaticState<TSearchAction, TControllersStaticState>>;

package/dist/definitions/ssr-next/{common → search}/types/hydrate-static-state.d.ts

@@ -1,17 +1,16 @@
 import type { UnknownAction } from '@reduxjs/toolkit';
 import type { CoreEngine, CoreEngineNext } from '../../../app/engine.js';
-import type { ControllersMap, ControllersPropsMap } from './controllers.js';
-import type { EngineDefinitionBuildResult, EngineDefinitionControllersPropsOption } from './engine.js';
-import type { OptionsTuple } from './utilities.js';
+import type { ControllersMap, ControllersPropsMap } from '../../common/types/controllers.js';
+import type { OptionsTuple } from '../../common/types/utilities.js';
+import type { SearchEngineDefinitionBuildResult, SearchEngineDefinitionControllersPropsOption } from './engine.js';
+export type HydratedState<TEngine extends CoreEngine | CoreEngineNext, TControllers extends ControllersMap> = SearchEngineDefinitionBuildResult<TEngine, TControllers>;
 interface HydrateStaticStateOptions<TSearchAction> {
     searchAction: TSearchAction;
 }
-export interface HydratedState<TEngine extends CoreEngine | CoreEngineNext, TControllers extends ControllersMap> extends EngineDefinitionBuildResult<TEngine, TControllers> {
-}
 /**
  * Creates a new engine from the snapshot of the engine created in SSR with fetchStaticState.
  *
  * Useful when hydrating a server-side-rendered engine.
  */
-export type HydrateStaticState<TEngine extends CoreEngine | CoreEngineNext, TControllers extends ControllersMap, TSearchAction extends UnknownAction, TControllersProps extends ControllersPropsMap> = (...params: OptionsTuple<HydrateStaticStateOptions<TSearchAction> & EngineDefinitionControllersPropsOption<TControllersProps>>) => Promise<HydratedState<TEngine, TControllers>>;
+export type HydrateStaticState<TEngine extends CoreEngine | CoreEngineNext, TControllers extends ControllersMap, TSearchAction extends UnknownAction, TControllersProps extends ControllersPropsMap> = (...params: OptionsTuple<HydrateStaticStateOptions<TSearchAction> & SearchEngineDefinitionControllersPropsOption<TControllersProps>>) => Promise<HydratedState<TEngine, TControllers>>;
 export {};

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

@@ -58,9 +58,6 @@ export { getSampleSearchEngineConfiguration } from './app/search-engine/search-e
 export type { ErrorPayload } from './controllers/controller/error-payload.js';
 export type { Controller, Subscribable, } from './controllers/controller/headless-controller.js';
 export type { InlineLink } from './controllers/smart-snippet/headless-smart-snippet-interactive-inline-links.js';
-export type { ControllerDefinitionsMap, ControllerDefinitionWithoutProps, ControllerDefinitionWithProps, } from './ssr-next/common/types/controllers.js';
-export type { EngineDefinition, InferHydratedState, InferStaticState, } from './ssr-next/common/types/engine.js';
-export type { InferControllerFromDefinition, InferControllerStaticStateFromController, InferControllerStaticStateMapFromControllers, InferControllerStaticStateMapFromDefinitions, InferControllersMapFromDefinition, } from './ssr-next/common/types/inference.js';
 export type { AutomaticFacetBreadcrumb, Breadcrumb, BreadcrumbManager, BreadcrumbManagerDefinition, BreadcrumbManagerState, BreadcrumbValue, CategoryFacetBreadcrumb, CoreBreadcrumbManager, CoreBreadcrumbManagerState, DateFacetBreadcrumb, DeselectableValue, FacetBreadcrumb, NumericFacetBreadcrumb, StaticFilterBreadcrumb, } from './ssr-next/search/controllers/breadcrumb-manager/headless-breadcrumb-manager.ssr.js';
 export { defineBreadcrumbManager } from './ssr-next/search/controllers/breadcrumb-manager/headless-breadcrumb-manager.ssr.js';
 export type { Context, ContextDefinition, ContextInitialState, ContextPayload, ContextProps, ContextState, ContextValue, } from './ssr-next/search/controllers/context/headless-context.ssr.js';
@@ -143,8 +140,13 @@ export type { RedirectionTrigger, RedirectionTriggerDefinition, RedirectionTrigg
 export { defineRedirectionTrigger } from './ssr-next/search/controllers/triggers/headless-redirection-trigger.ssr.js';
 export type { UrlManager, UrlManagerBuildProps, UrlManagerInitialState, UrlManagerProps, UrlManagerState, } from './ssr-next/search/controllers/url-manager/headless-url-manager.ssr.js';
 export { defineUrlManager } from './ssr-next/search/controllers/url-manager/headless-url-manager.ssr.js';
-export type { SearchCompletedAction, SearchEngineDefinition, SearchEngineDefinitionOptions, SSRSearchEngine as SearchEngine, } from './ssr-next/search/engine/search-engine.ssr.js';
+export type { SearchCompletedAction, SSRSearchEngine as SearchEngine, } from './ssr-next/search/engine/search-engine.ssr.js';
 export { defineSearchEngine } from './ssr-next/search/engine/search-engine.ssr.js';
+export type { ControllerDefinitionsMap, InferControllerStaticStateFromController, InferControllerStaticStateMapFromControllers, InferHydratedState, InferStaticState, } from './ssr-next/search/types/controller-definition.js';
+export type { InferControllerFromDefinition, InferControllerStaticStateMapFromDefinitions, InferControllersMapFromDefinition, } from './ssr-next/search/types/controller-inference.js';
+export type { SearchEngineDefinition, SearchEngineDefinitionOptions, } from './ssr-next/search/types/engine.js';
+export type { FetchStaticState } from './ssr-next/search/types/fetch-static-state.js';
+export type { HydratedState, HydrateStaticState, } from './ssr-next/search/types/hydrate-static-state.js';
 export type { SearchAppState, SearchParametersState, } from './state/search-app-state.js';
 export { getAnalyticsNextApiBaseUrl, getOrganizationEndpoint, } from './api/platform-client.js';
 export type { RelativeDate, RelativeDatePeriod, RelativeDateUnit, } from './api/search/date/relative-date.js';

package/dist/definitions/test/mock-ssr-controller-definitions.d.ts

@@ -1,8 +1,7 @@
 import type { SearchEngine } from '../app/search-engine/search-engine.js';
 import type { Controller } from '../controllers/controller/headless-controller.js';
-import type { Kind } from '../ssr/commerce/types/kind.js';
+import type { ControllerDefinitionWithoutProps, ControllerDefinitionWithProps } from '../ssr/common/types/controllers.js';
 import { recommendationInternalOptionKey } from '../ssr-next/commerce/types/controller-constants.js';
-import type { ControllerDefinitionWithoutProps, ControllerDefinitionWithProps } from '../ssr-next/common/types/controllers.js';
 interface MockController {
     initialState?: Record<string, unknown>;
 }
@@ -29,7 +28,6 @@ export declare function defineMockCommerceControllerWithProps(options?: Solution
     buildWithProps: import("vitest").Mock<(engine: any, props: any) => {
         state: {};
         subscribe(listener: () => void): import("redux").Unsubscribe;
-        _kind: Kind;
     }>;
     listing: boolean;
     search: boolean;
@@ -44,7 +42,6 @@ export declare function defineMockRecommendationDefinition(slotId: string): {
     buildWithProps: import("vitest").Mock<(engine: any, props: any) => {
         state: {};
         subscribe(listener: () => void): import("redux").Unsubscribe;
-        _kind: Kind;
     }>;
 };
 export {};

package/dist/esm/ssr/commerce/types/kind.js

@@ -1,3 +1,6 @@
+/**
+ * @deprecated This type will be removed in the next major version.
+ */
 export var Kind;
 (function (Kind) {
     Kind["Cart"] = "CART";
@@ -5,7 +8,6 @@ export var Kind;
     Kind["ParameterManager"] = "PARAMETER_MANAGER";
     Kind["Recommendations"] = "RECOMMENDATIONS";
 })(Kind || (Kind = {}));
-// TODO: KIT-4742: There is no point for this now that the wiring is happening in headless
 export function createControllerWithKind(controller, kind) {
     const copy = Object.defineProperties({}, Object.getOwnPropertyDescriptors(controller));
     Object.defineProperty(copy, '_kind', {

package/dist/esm/ssr-commerce-next.index.js

@@ -89,7 +89,6 @@ export { defineQueryTrigger } from './ssr-next/commerce/controllers/triggers/hea
 export { defineRedirectionTrigger } from './ssr-next/commerce/controllers/triggers/headless-redirection-trigger.ssr.js';
 export { defineCommerceEngine } from './ssr-next/commerce/engine/commerce-engine.ssr.js';
 export { SolutionType } from './ssr-next/commerce/types/controller-constants.js';
-export { Kind } from './ssr-next/commerce/types/kind.js';
 // TODO: KIT-3391 - export other SSR commerce controllers
 //#endregion
 export * from './features/commerce/configuration/configuration-actions-loader.js';

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

@@ -1,6 +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 '../../../../ssr/commerce/controller-utils.js';
+import { ensureAtLeastOneSolutionType } from '../../controller-utils.js';
 import { SolutionType } from '../../types/controller-constants.js';
 /**
  * Defines a `BreadcrumbManager` controller instance.

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

@@ -1,5 +1,4 @@
 import { buildCart, } from '../../../../controllers/commerce/context/cart/headless-cart.js';
-import { createControllerWithKind, Kind } from '../../types/kind.js';
 /**
  * Defines a `Cart` controller instance.
  * @group Definers
@@ -13,10 +12,9 @@ export function defineCart() {
         standalone: true,
         recommendation: true,
         buildWithProps: (engine, props) => {
-            const controller = buildCart(engine, {
+            return buildCart(engine, {
                 initialState: props ? props.initialState : {},
             });
-            return createControllerWithKind(controller, Kind.Cart);
         },
     };
 }

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

@@ -1,6 +1,5 @@
 import { buildContext, } from '../../../../controllers/commerce/context/headless-context.js';
 import { MissingControllerProps } from '../../../common/errors.js';
-import { createControllerWithKind, Kind } from '../../types/kind.js';
 /**
  * Defines a `Context` controller instance.
  * @group Definers
@@ -15,10 +14,9 @@ export function defineContext() {
         recommendation: true,
         buildWithProps: (engine, props) => {
             if (props === undefined) {
-                throw new MissingControllerProps(Kind.Context);
+                throw new MissingControllerProps('Context');
             }
-            const controller = buildContext(engine, { options: props.initialState });
-            return createControllerWithKind(controller, Kind.Context);
+            return buildContext(engine, { options: props.initialState });
         },
     };
 }