@furystack/shades/esm/components/nested-replace.js

A lightweight UI framework for FuryStack with JSX support

import { LocationService } from '../services/location-service.js';
import { buildNestedNavigateUrl } from './nested-navigate.js';
/**
 * Replaces the current history entry with a route using the LocationService
 * resolved from the given injector. Has the same URL-composition semantics as
 * `nestedNavigate`, but calls `history.replaceState` under the hood so the
 * intermediate URL does not appear in the browser's back / forward stack.
 *
 * Use this for SPA redirects (e.g. canonicalization, auth guards) where the
 * caller's URL should not be recoverable with the Back button.
 *
 * @param injector - The injector instance to resolve LocationService from
 * @param args - The navigation arguments
 */
export const nestedReplace = (injector, args) => {
    injector.get(LocationService).replace(buildNestedNavigateUrl(args));
};
/**
 * Creates a type-safe replace function constrained to a specific route tree.
 * The returned function has the same runtime behavior as {@link nestedReplace}
 * but narrows `path` to valid route paths, requires `params` when the route has
 * parameters, and enforces the route's declared `query` and `hash` schemas.
 *
 * @typeParam TRoutes - The route tree type (use `typeof yourRoutes`)
 * @returns A type-safe replace function
 *
 * @example
 * ```typescript
 * const appReplace = createNestedReplace<typeof appRoutes>()
 *
 * // Redirect an unauthenticated visitor without polluting history
 * appReplace(injector, { path: '/login' })
 * ```
 */
export const createNestedReplace = () => {
    return nestedReplace;
};
//# sourceMappingURL=nested-replace.js.map