Function resolvePath

frontend/src/react/router/navigation.ts:65–99

(
  name: string,
  options: { params?: NavParams; query?: NavQuery } = {}
)

// Fill `:param` placeholders and append a query string.
export function resolvePath(
  name: string,
  options: { params?: NavParams; query?: NavQuery } = {}
): string {
  const pattern = nameIndex.get(name);
  if (!pattern) {
    // Unknown name → root, so a misconfigured redirect can't throw mid-guard.
    console.warn(`resolvePath: no route registered for name "${name}"`);
    return "/";
  }
  let path = pattern;
  if (options.params) {
    for (const [key, value] of Object.entries(options.params)) {
      if (value === undefined) continue;
      const single = Array.isArray(value) ? (value[0] ?? "") : value;
      // Match `:key` only when NOT followed by another identifier char,
      // so `:project` doesn't substring-match inside `:projectId` and
      // turn `/projects/:projectId/...` into `/projects/<v>Id/...`. The
      // collision shows up when callers merge in inherited route params
      // (e.g. the SQL editor's `:project` clobbers the issue route's
      // `:projectId`). React-router param names are restricted to
      // `[A-Za-z0-9_]+`, so the negative lookahead is safe — no regex
      // escape needed.
      path = path.replace(
        new RegExp(`:${key}(?![A-Za-z0-9_])`),
        encodeURIComponent(single)
      );
    }
  }
  if (options.query) {
    const qs = buildSearchString(options.query);
    if (qs) path = `${path}?${qs}`;
  }
  return path;
}

// The createBrowserRouter instance, registered by the app root in Phase 4 so
// non-component code (the auth slice) can navigate without importing the root