/**
 * @module ui/router/router-types
 *
 * Fundamental types and interfaces for the isomorphic/browser ibgib SPA router.
 */

/**
 * Options configuring an individual navigation operation.
 */
export interface RouterNavigateOptions {
    /**
     * If true, replaces the current history entry in window.history
     * rather than pushing a new one.
     */
    replace?: boolean;

    /**
     * If true, updates the browser URL without notifying route listeners.
     * Useful for updating contextual query parameters without triggering full view re-renders.
     */
    silent?: boolean;
}

/**
 * Callback signature for route change listeners.
 */
export type RouteListener<TRouteInfo> = (route: TRouteInfo) => Promise<void> | void;