Function createRouterIntegration

packages/core/src/router/integration.ts:98–390

(
  opts: RouterIntegrationOptions<S>,
)

 * Create an app-bound router integration.
 */
export function createRouterIntegration<S>(
  opts: RouterIntegrationOptions<S>,
): RouterIntegration<S> {
  let routeRegistry = createRouteRegistry(opts.routes);
  let routeMap = routeRegistry.routeMap;
  let recordById = routeRegistry.recordById;
  if (!routeMap.has(opts.initialRoute)) {
    throw new ZrUiError(
      "ZRUI_INVALID_PROPS",
      `initialRoute \"${opts.initialRoute}\" was not found in routes`,
    );
  }

  let state = createRouterState(opts.initialRoute, {
    ...(opts.maxHistoryDepth === undefined ? {} : { maxDepth: opts.maxHistoryDepth }),
  });

  const focusSnapshotsByVisitId = new Map<number, WidgetFocusSnapshot>();

  function normalizeKnownRouteId(routeId: string): string {
    const normalized = routeId.trim();
    if (!normalized) {
      throw new ZrUiError("ZRUI_INVALID_PROPS", "route id must be a non-empty string");
    }
    if (!routeMap.has(normalized)) {
      throw new ZrUiError("ZRUI_INVALID_PROPS", `unknown route id: ${normalized}`);
    }
    return normalized;
  }

  function resolveGuardedNavigation(
    routeId: string,
    params: RouteParams | undefined,
    action: "navigate" | "replace" | "back",
  ): Readonly<{ routeId: string; params: RouteParams }> | null {
    const from = currentRouteFromState(state);
    let resolvedRouteId = normalizeKnownRouteId(routeId);
    let resolvedParams = normalizeRouteParams(params);
    const seen = new Set<string>();

    for (let depth = 0; depth <= GUARD_MAX_REDIRECT_DEPTH; depth += 1) {
      const record = recordById.get(resolvedRouteId);
      if (!record) {
        throw new ZrUiError(
          "ZRUI_INVALID_STATE",
          `route id "${resolvedRouteId}" is not registered`,
        );
      }
      const to = Object.freeze({ id: resolvedRouteId, params: resolvedParams });
      let redirected = false;
      for (const ancestryRouteId of record.ancestry) {
        const ancestryRoute = routeMap.get(ancestryRouteId);
        if (!ancestryRoute) {
          throw new ZrUiError(
            "ZRUI_INVALID_STATE",
            `route id "${ancestryRouteId}" is not registered`,
          );
        }