@real-router/core 0.56.0 → 0.57.1

package/src/internals.ts

@@ -1,228 +0,0 @@
-import type { DependenciesStore } from "./namespaces";
-import type { RoutesStore } from "./namespaces/RoutesNamespace";
-import type { Router as RouterClass } from "./Router";
-import type { EventMethodMap, GuardFnFactory, PluginFactory } from "./types";
-import type { RouterValidator } from "./types/RouterValidator";
-import type { SerializedRouterState } from "./utils";
-import type {
-  DefaultDependencies,
-  EventName,
-  NavigationOptions,
-  Options,
-  Params,
-  Plugin,
-  Router as RouterInterface,
-  RouteTreeState,
-  SimpleState,
-  State,
-  TreeChangedEvent,
-  Unsubscribe,
-} from "@real-router/types";
-import type { RouteTree } from "route-tree";
-
-export interface RouterInternals<
-  D extends DefaultDependencies = DefaultDependencies,
-> {
-  readonly makeState: <P extends Params = Params>(
-    name: string,
-    params?: P,
-    path?: string,
-    meta?: Record<string, Record<string, "url" | "query">>,
-  ) => State<P>;
-
-  readonly forwardState: <P extends Params = Params>(
-    routeName: string,
-    routeParams: P,
-  ) => SimpleState<P>;
-
-  readonly buildStateResolved: (
-    resolvedName: string,
-    resolvedParams: Params,
-  ) => RouteTreeState | undefined;
-
-  readonly matchPath: <P extends Params = Params>(
-    path: string,
-    options?: Options,
-  ) => State<P> | undefined;
-
-  readonly getOptions: () => Options;
-
-  readonly addEventListener: <E extends EventName>(
-    eventName: E,
-    cb: Plugin[EventMethodMap[E]],
-  ) => Unsubscribe;
-
-  /**
-   * Route-tree mutation channel — internal access for the `getRoutesApi`
-   * wrapper. A dedicated bridge is required because the public
-   * `addEventListener<E extends EventName>` structurally rejects
-   * `"TREE_CHANGED"` (it is not in the public `EventName` union), is strict on
-   * duplicates, and exposes neither `emit` nor `listenerCount`.
-   */
-  readonly treeChanged: {
-    readonly emit: (event: TreeChangedEvent) => void;
-    readonly subscribe: (
-      handler: (event: TreeChangedEvent) => void,
-    ) => Unsubscribe;
-    readonly listenerCount: () => number;
-  };
-
-  readonly buildPath: (route: string, params?: Params) => string;
-
-  readonly emitTransitionError: (error: Error) => void;
-
-  readonly start: (path: string) => Promise<State>;
-
-  /**
-   * Plugin-only navigation entry point — delegates to
-   * `NavigationNamespace.navigateToState` (`getPluginApi(router).navigateToState`).
-   * Hidden from `Router`/`Navigator` to keep the userland surface minimal;
-   * see `core-types/src/api.ts` for usage docs.
-   */
-  readonly navigateToState: (
-    state: State,
-    options?: NavigationOptions,
-  ) => Promise<State>;
-
-  /* eslint-disable @typescript-eslint/no-explicit-any -- heterogeneous map: stores different InterceptorFn<M> types under different keys */
-  readonly interceptors: Map<
-    string,
-    ((next: (...args: any[]) => any, ...args: any[]) => any)[]
-  >;
-  /* eslint-enable @typescript-eslint/no-explicit-any */
-
-  readonly setRootPath: (rootPath: string) => void;
-  readonly getRootPath: () => string;
-
-  readonly getTree: () => RouteTree;
-
-  readonly isDisposed: () => boolean;
-
-  validator: RouterValidator | null;
-
-  // Dependencies (issue #172)
-  readonly dependenciesGetStore: () => DependenciesStore<D>;
-
-  // Clone support (issue #173)
-  readonly cloneOptions: () => Options;
-  readonly cloneDependencies: () => Record<string, unknown>;
-  readonly getLifecycleFactories: () => [
-    Record<string, GuardFnFactory<D>>,
-    Record<string, GuardFnFactory<D>>,
-  ];
-  readonly getPluginFactories: () => PluginFactory<D>[];
-
-  // Consolidated route data store (issue #174 Phase 2)
-  readonly routeGetStore: () => RoutesStore<D>;
-
-  // Cross-namespace state (issue #174)
-  readonly getStateName: () => string | undefined;
-  readonly isTransitioning: () => boolean;
-  readonly clearState: () => void;
-  readonly setState: (state: State) => void;
-  readonly routerExtensions: { keys: string[] }[];
-  readonly contextClaimRecords: Set<string>;
-
-  /**
-   * One-shot hydration scratchpad populated by `hydrateRouter` immediately
-   * before delegating to `router.start(parsed.path)` and cleared in the
-   * matching `finally`. SSR loader plugins read this slot directly via
-   * `getInternals(router).hydrationState` to short-circuit their own loader
-   * call when the server-resolved namespace value is already present in the
-   * parsed state (#596). `null` outside of an active `hydrateRouter`
-   * invocation.
-   */
-  hydrationState: SerializedRouterState | null;
-}
-
-// eslint-disable-next-line @typescript-eslint/no-explicit-any -- existential type: stores RouterInternals for all Dependencies types
-const internals = new WeakMap<object, RouterInternals<any>>();
-
-export function getInternals<D extends DefaultDependencies>(
-  router: RouterInterface<D>,
-): RouterInternals<D> {
-  const ctx = internals.get(router);
-
-  if (!ctx) {
-    throw new TypeError(
-      "[real-router] Invalid router instance — not found in internals registry",
-    );
-  }
-
-  return ctx as RouterInternals<D>;
-}
-
-export function registerInternals<D extends DefaultDependencies>(
-  router: RouterClass<D>,
-  ctx: RouterInternals<D>,
-): void {
-  internals.set(router, ctx);
-}
-
-/* eslint-disable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-argument -- internal chain execution: type safety enforced at public API boundary (PluginApi.addInterceptor) */
-function executeInterceptorChain<T>(
-  interceptors: ((next: (...args: any[]) => any, ...args: any[]) => any)[],
-  original: (...args: any[]) => T,
-  args: any[],
-): T {
-  let chain = original as (...args: any[]) => any;
-
-  for (const interceptor of interceptors) {
-    const prev = chain;
-
-    chain = (...chainArgs: any[]) => interceptor(prev, ...chainArgs);
-  }
-
-  return chain(...args) as T;
-}
-
-/**
- * Variadic interceptor wrapper — wraps a function of any arity, returning the
- * same callable type `T`. Use {@link createBinaryInterceptable} instead when the
- * wrapped method takes exactly two args and the caller needs the precise
- * `(a, b) => r` signature preserved (the variadic form widens args to `any[]`).
- */
-export function createInterceptable<T extends (...args: any[]) => any>(
-  name: string,
-  original: T,
-  interceptors: Map<
-    string,
-    ((next: (...args: any[]) => any, ...args: any[]) => any)[]
-  >,
-): T {
-  return ((...args: any[]) => {
-    const chain = interceptors.get(name);
-
-    if (!chain || chain.length === 0) {
-      return original(...args);
-    }
-
-    return executeInterceptorChain(chain, original, args);
-  }) as T;
-}
-
-/**
- * Two-argument interceptor wrapper — preserves the exact `(a: A, b: B) => R`
- * signature, which the variadic {@link createInterceptable} cannot express
- * (it widens args to `any[]`). Used for the binary interceptable methods
- * `forwardState(routeName, routeParams)` and `buildPath(route, params)`.
- */
-export function createBinaryInterceptable<A, B, R>(
-  name: string,
-  original: (a: A, b: B) => R,
-  interceptors: Map<
-    string,
-    ((next: (...args: any[]) => any, ...args: any[]) => any)[]
-  >,
-): (a: A, b: B) => R {
-  return (arg1: A, arg2: B) => {
-    const chain = interceptors.get(name);
-
-    if (!chain || chain.length === 0) {
-      return original(arg1, arg2);
-    }
-
-    return executeInterceptorChain(chain, original, [arg1, arg2]);
-  };
-}
-/* eslint-enable @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-return, @typescript-eslint/no-unsafe-argument */

package/src/namespaces/DependenciesNamespace/dependenciesStore.ts

@@ -1,30 +0,0 @@
-import { DEFAULT_LIMITS } from "../../constants";
-
-import type { Limits } from "../../types";
-import type { DefaultDependencies } from "@real-router/types";
-
-export interface DependenciesStore<
-  Dependencies extends DefaultDependencies = DefaultDependencies,
-> {
-  dependencies: Partial<Dependencies>;
-  limits: Limits;
-}
-
-export function createDependenciesStore<
-  Dependencies extends DefaultDependencies = DefaultDependencies,
->(
-  initialDependencies: Partial<Dependencies> = {},
-): DependenciesStore<Dependencies> {
-  const dependencies = Object.create(null) as Partial<Dependencies>;
-
-  for (const key in initialDependencies) {
-    if (initialDependencies[key] !== undefined) {
-      dependencies[key] = initialDependencies[key];
-    }
-  }
-
-  return {
-    dependencies,
-    limits: DEFAULT_LIMITS,
-  };
-}

package/src/namespaces/DependenciesNamespace/index.ts

@@ -1,5 +0,0 @@
-// packages/core/src/namespaces/DependenciesNamespace/index.ts
-
-export { createDependenciesStore } from "./dependenciesStore";
-
-export type { DependenciesStore } from "./dependenciesStore";