matchRoute method

RouteDecoder matchRoute(String name, { PageSettings? arguments, })

Implementation

RouteDecoder matchRoute(String name, {PageSettings? arguments}) {
  final uri = Uri.parse(name);
  arguments?.pathParams.clear();
  final split = uri.path.split('/').where((element) => element.isNotEmpty);
  var curPath = '/';
  final cumulativePaths = <String>[
    '/',
  ];
  for (var item in split) {
    if (curPath.endsWith('/')) {
      curPath += item;
    } else {
      curPath += '/$item';
    }
    cumulativePaths.add(curPath);
  }

  final treeBranch = <MapEntry<String, SintPage>>[];
  for (final path in cumulativePaths) {
    final matched = _findRoute(path);
    if (matched != null) {
      treeBranch.add(MapEntry(path, matched));
    }
  }

  // ── Slug / vanity-URL fix ──────────────────────────────────────────
  // When the URL has segments beyond "/" (e.g. "/serzenmontoya") but
  // only a parent segment like "/" matched, the full URL is NOT a
  // registered route.  Return an empty tree so unknownRoute triggers
  // (which resolves vanity slugs via SlugResolverPage).
  if (treeBranch.isNotEmpty && cumulativePaths.length > 1) {
    final lastMatchedPath = treeBranch.last.key;
    final lastCumulativePath = cumulativePaths.last;
    if (lastMatchedPath != lastCumulativePath) {
      // Only a parent matched — the full URL is unknown.
      final params = Map<String, String>.from(uri.queryParameters);
      arguments?.params.clear();
      arguments?.params.addAll(params);
      return RouteDecoder([], arguments);
    }
  }

  final params = Map<String, String>.from(uri.queryParameters);
  if (treeBranch.isNotEmpty) {
    //route is found, do further parsing to get nested query params
    final lastRoute = treeBranch.last;
    final parsedParams = _parseParams(uri, lastRoute.value.path);
    if (parsedParams.isNotEmpty) {
      params.addAll(parsedParams);
    }
    // Path params are also exposed SEPARATELY from query params (1.5.0);
    // `params` keeps the legacy merged behavior (query + path).
    arguments?.pathParams.addAll(parsedParams);
    // Copy parameters, unique ValueKey, and matched name to all pages in
    // a single allocation while reusing the pre-compiled PathDecoded.
    final mappedTreeBranch = treeBranch
        .map(
          (e) => e.value.copyWith(
            key: ValueKey(e.key),
            name: e.key,
            path: e.value.path,
            parameters: {
              if (e.value.parameters != null) ...e.value.parameters!,
              ...params,
            },
          ),
        )
        .toList();
    arguments?.params.clear();
    arguments?.params.addAll(params);
    return RouteDecoder(
      mappedTreeBranch,
      arguments,
    );
  }

  arguments?.params.clear();
  arguments?.params.addAll(params);

  //route not found
  return RouteDecoder(
    const <SintPage>[],
    arguments,
  );
}