import type { UiState } from './ui-state';
/**
 * The router is the part that saves and reads the object from the storage.
 * Usually this is the URL.
 */
export type Router<TRouteState = UiState> = {
    /**
     * onUpdate Sets an event listener that is triggered when the storage is updated.
     * The function should accept a callback to trigger when the update happens.
     * In the case of the history / URL in a browser, the callback will be called
     * by `onPopState`.
     */
    onUpdate: (callback: (route: TRouteState) => void) => void;
    /**
     * Reads the storage and gets a route object. It does not take parameters,
     * and should return an object
     */
    read: () => TRouteState;
    /**
     * Pushes a route object into a storage. Takes the UI state mapped by the state
     * mapping configured in the mapping
     */
    write: (route: TRouteState) => void;
    /**
     * Transforms a route object into a URL. It receives an object and should
     * return a string. It may return an empty string.
     */
    createURL: (state: TRouteState) => string;
    /**
     * Called when InstantSearch is disposed. Used to remove subscriptions.
     */
    dispose: () => void;
    /**
     * Called when InstantSearch is started.
     */
    start?: () => void;
    /**
     * Identifier for this router. Used to differentiate between routers.
     */
    $$type?: string;
};
/**
 * The state mapping is a way to customize the structure before sending it to the router.
 * It can transform and filter out the properties. To work correctly, the following
 * should be valid for any UiState:
 * `UiState = routeToState(stateToRoute(UiState))`.
 */
export type StateMapping<TUiState = UiState, TRouteState = TUiState> = {
    /**
     * Transforms a UI state representation into a route object.
     * It receives an object that contains the UI state of all the widgets in the page.
     * It should return an object of any form as long as this form can be read by
     * the `routeToState` function.
     */
    stateToRoute: (uiState: TUiState) => TRouteState;
    /**
     * Transforms route object into a UI state representation.
     * It receives an object that contains the UI state stored by the router.
     * The format is the output of `stateToRoute`.
     */
    routeToState: (routeState: TRouteState) => TUiState;
    /**
     * Identifier for this stateMapping. Used to differentiate between stateMappings.
     */
    $$type?: string;
};