@real-router/core 0.56.0 → 0.57.0

package/src/namespaces/RoutesNamespace/helpers.ts

@@ -1,204 +0,0 @@
-// packages/core/src/namespaces/RoutesNamespace/helpers.ts
-
-import type { RouteConfig } from "./types";
-import type { Route } from "../../types";
-import type {
-  DefaultDependencies,
-  ForwardToCallback,
-  Params,
-} from "@real-router/types";
-import type { RouteDefinition } from "route-tree";
-
-/**
- * Creates an empty RouteConfig.
- */
-export function createEmptyConfig(): RouteConfig {
-  return {
-    decoders: Object.create(null) as Record<string, (params: Params) => Params>,
-    encoders: Object.create(null) as Record<string, (params: Params) => Params>,
-    defaultParams: Object.create(null) as Record<string, Params>,
-    forwardMap: Object.create(null) as Record<string, string>,
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    forwardFnMap: Object.create(null) as Record<string, ForwardToCallback<any>>,
-  };
-}
-
-// ============================================================================
-// Route Tree Helpers
-// ============================================================================
-
-/**
- * Checks if all params from source exist with same values in target.
- * Small function body allows V8 inlining.
- */
-export function paramsMatch(source: Params, target: Params): boolean {
-  for (const key in source) {
-    if (source[key] !== target[key]) {
-      return false;
-    }
-  }
-
-  return true;
-}
-
-/**
- * Checks params match, skipping keys present in skipKeys.
- */
-export function paramsMatchExcluding(
-  source: Params,
-  target: Params,
-  skipKeys: Params,
-): boolean {
-  for (const key in source) {
-    if (key in skipKeys) {
-      continue;
-    }
-    if (source[key] !== target[key]) {
-      return false;
-    }
-  }
-
-  return true;
-}
-
-/**
- * Returns a copy of `defaultParams` with query-typed keys removed, based on
- * `ownMeta` (the per-route paramTypeMap from the matcher). When no query keys
- * are present, returns the input by reference (zero-allocation fast path).
- *
- * `ownMeta` may be `undefined` for non-registered route names — this is the
- * caller's escape hatch (e.g. `getMetaByName(name)?.[name]`); a missing meta
- * means no query type information is available, so defaults pass through
- * unchanged.
- */
-export function stripQueryDefaults(
-  defaultParams: Params,
-  ownMeta: Record<string, "url" | "query"> | undefined,
-): Params {
-  if (!ownMeta || !hasQueryDefault(defaultParams, ownMeta)) {
-    return defaultParams;
-  }
-
-  const filtered: Params = {};
-
-  for (const key in defaultParams) {
-    if (ownMeta[key] !== "query") {
-      filtered[key] = defaultParams[key];
-    }
-  }
-
-  return filtered;
-}
-
-function hasQueryDefault(
-  defaultParams: Params,
-  ownMeta: Record<string, "url" | "query">,
-): boolean {
-  for (const key in defaultParams) {
-    if (ownMeta[key] === "query") {
-      return true;
-    }
-  }
-
-  return false;
-}
-
-/**
- * Sanitizes a route by keeping only essential properties.
- */
-export function sanitizeRoute<Dependencies extends DefaultDependencies>(
-  route: Route<Dependencies>,
-): RouteDefinition {
-  const sanitized: RouteDefinition = {
-    name: route.name,
-    path: route.path,
-  };
-
-  if (route.children) {
-    sanitized.children = route.children.map((child) => sanitizeRoute(child));
-  }
-
-  return sanitized;
-}
-
-/**
- * Recursively removes a route from definitions array.
- */
-export function removeFromDefinitions(
-  definitions: RouteDefinition[],
-  routeName: string,
-  parentPrefix = "",
-): boolean {
-  for (let i = 0; i < definitions.length; i++) {
-    const route = definitions[i];
-    const fullName = parentPrefix
-      ? `${parentPrefix}.${route.name}`
-      : route.name;
-
-    if (fullName === routeName) {
-      definitions.splice(i, 1);
-
-      return true;
-    }
-
-    if (
-      route.children &&
-      routeName.startsWith(`${fullName}.`) &&
-      removeFromDefinitions(route.children, routeName, fullName)
-    ) {
-      return true;
-    }
-  }
-
-  return false;
-}
-
-/**
- * Clears configuration entries that match the predicate.
- */
-export function clearConfigEntries<T>(
-  config: Record<string, T>,
-  matcher: (key: string) => boolean,
-): void {
-  for (const key of Object.keys(config)) {
-    if (matcher(key)) {
-      delete config[key];
-    }
-  }
-}
-
-/**
- * Used by matchPath() when trailingSlash is "preserve": the matcher's
- * buildPath() with an unset trailingSlash mode strips trailing slashes,
- * but "preserve" means the source path's trailing-slash choice wins.
- * If the source had a trailing slash, re-attach it to the rewritten path.
- * The reverse case (rewritten has trailing, source does not) is not
- * reachable with the current matcher — it never adds a trailing slash
- * with undefined mode.
- */
-export function matchSourceTrailingSlash(
-  sourcePath: string,
-  rewrittenPath: string,
-): string {
-  const queryIndex = rewrittenPath.search(/[?#]/);
-  const pathPart =
-    queryIndex === -1 ? rewrittenPath : rewrittenPath.slice(0, queryIndex);
-
-  if (pathPart === "/" || pathPart.endsWith("/")) {
-    return rewrittenPath;
-  }
-
-  const sourceQueryIndex = sourcePath.search(/[?#]/);
-  const sourcePathPart =
-    sourceQueryIndex === -1
-      ? sourcePath
-      : sourcePath.slice(0, sourceQueryIndex);
-
-  if (!(sourcePathPart.length > 1 && sourcePathPart.endsWith("/"))) {
-    return rewrittenPath;
-  }
-
-  const querySuffix = queryIndex === -1 ? "" : rewrittenPath.slice(queryIndex);
-
-  return `${pathPart}/${querySuffix}`;
-}

package/src/namespaces/RoutesNamespace/index.ts

@@ -1,11 +0,0 @@
-// packages/core/src/namespaces/RoutesNamespace/index.ts
-
-export { RoutesNamespace } from "./RoutesNamespace";
-
-export { DEFAULT_ROUTE_NAME } from "./constants";
-
-export { createEmptyConfig } from "./helpers";
-
-export type { RouteConfig, RoutesDependencies } from "./types";
-
-export type { RoutesStore } from "./routesStore";

package/src/namespaces/RoutesNamespace/routeGuards.ts

@@ -1,62 +0,0 @@
-import { logger } from "@real-router/logger";
-
-/**
- * Validates removeRoute constraints.
- * Returns false if removal should be blocked (route is active).
- * Logs warnings for edge cases.
- *
- * @param name - Route name to remove
- * @param currentStateName - Current active route name (or undefined)
- * @param isNavigating - Whether navigation is in progress
- * @returns true if removal can proceed, false if blocked
- */
-export function validateRemoveRoute(
-  name: string,
-  currentStateName: string | undefined,
-  isNavigating: boolean,
-): boolean {
-  if (currentStateName) {
-    const isExactMatch = currentStateName === name;
-    const isParentOfCurrent = currentStateName.startsWith(`${name}.`);
-
-    if (isExactMatch || isParentOfCurrent) {
-      const suffix = isExactMatch ? "" : ` (current: "${currentStateName}")`;
-
-      logger.warn(
-        "router.removeRoute",
-        `Cannot remove route "${name}" — it is currently active${suffix}. Navigate away first.`,
-      );
-
-      return false;
-    }
-  }
-
-  if (isNavigating) {
-    logger.warn(
-      "router.removeRoute",
-      `Route "${name}" removed while navigation is in progress. This may cause unexpected behavior.`,
-    );
-  }
-
-  return true;
-}
-
-/**
- * Validates clearRoutes operation.
- * Returns false if operation should be blocked (navigation in progress).
- *
- * @param isNavigating - Whether navigation is in progress
- * @returns true if clearRoutes can proceed, false if blocked
- */
-export function validateClearRoutes(isNavigating: boolean): boolean {
-  if (isNavigating) {
-    logger.error(
-      "router.clearRoutes",
-      "Cannot clear routes while navigation is in progress. Wait for navigation to complete.",
-    );
-
-    return false;
-  }
-
-  return true;
-}