react-routes-forge 1.3.0 → 1.4.1

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/core/utils.ts","../src/core/defineRoutes.ts"],"sourcesContent":["// Core\nexport { defineRoutes } from \"./core/defineRoutes\";\nexport { appendQuery, buildPath, extractParamNames, extractQueryFromPath, isDynamic } from \"./core/utils\";\n\n// Types\nexport type {\n  RoutePath,\n  RouteBuilder,\n  RouteParam,\n  RouteParams,\n  QueryParams,\n  RouteLeaf,\n  RouteMap,\n  RouteTree,\n  ExtractParams,\n  PathParams,\n  BuildPathOptions,\n  FlatRoute,\n  BreadcrumbItem,\n  BreadcrumbOptions,\n  MatchPathOptions,\n} from \"./types\";\nexport type { StaticRoute, DynamicRoute } from \"./core/defineRoutes\";\n\n// Utilities\nexport {\n  isActivePath,\n  extractParamsFromPath,\n  matchPath,\n  joinPaths,\n  build,\n  getParamNames,\n  flattenRoutes,\n  getBreadcrumbs,\n  devWarn,\n  clearPathCache,\n} from \"./core/utils\";\n","import type {\n  BreadcrumbItem,\n  BreadcrumbOptions,\n  BuildPathOptions,\n  FlatRoute,\n  QueryParams,\n  RouteParams,\n} from \"../types\";\n\n/** Returns a fresh RegExp each call — avoids shared `lastIndex` state on /g patterns. */\nconst ESCAPE_RE = () => /[.*+?^${}()|[\\]\\\\]/g;\n\n/**\n * Matches a `:param` token that starts a URL segment.\n *\n * A param is only recognized when its `:` sits at the very start of the\n * template or is immediately preceded by `/`, so a literal colon inside a\n * segment (e.g. `/users/foo:bar`) is not treated as a param. Param names are\n * restricted to `[A-Za-z0-9_]` (matching React Router), so any static suffix\n * (e.g. `.json` in `/files/:name.json`) stays a literal. The optional `?`\n * marker (`:param?`) is captured separately so it can be handled as a\n * whole-segment modifier.\n */\nconst PARAM_SEGMENT_RE = () => /(^|\\/):([A-Za-z0-9_]+)(\\?)?/g;\n\n/** Returns `true` when running in a production bundle (suppresses dev warnings). */\nfunction isProduction(): boolean {\n  const runtimeProcess = (\n    globalThis as typeof globalThis & {\n      process?: { env?: Record<string, string | undefined> };\n    }\n  ).process;\n  return runtimeProcess?.env?.NODE_ENV === \"production\";\n}\n\n/**\n * Emits a `console.warn` in non-production environments.\n * Shared by the core utilities and `defineRoutes()` so the production check\n * lives in one place.\n */\nexport function devWarn(message: string): void {\n  if (!isProduction()) {\n    console.warn(message);\n  }\n}\n\n/**\n * Clears internal regex cache maps (PREFIX_CACHE and PATH_CACHE).\n * Useful in test suites to prevent cached patterns from leaking across test cases.\n */\nexport function clearPathCache(): void {\n  PREFIX_CACHE.clear();\n  PATH_CACHE.clear();\n}\n\nfunction escapeRegex(value: string): string {\n  return value.replace(ESCAPE_RE(), \"\\\\$&\");\n}\n\n/**\n * Convert a route template into an unanchored `RegExp` source string.\n *\n * - Required `:name` segments become a capturing group `([^/]+)`.\n * - Optional `:name?` segments become `(?:([^/]+))?` — the whole segment is\n *   optional, matching React Router semantics.\n * - A trailing splat (`/*`) becomes `(?:/(.*))?`, capturing the remainder of\n *   the path (including slashes) or nothing at all.\n * - Everything else is regex-escaped literally.\n */\nfunction createTemplatePattern(template: string): string {\n  const splat = template.endsWith(\"/*\");\n  const base = splat ? template.slice(0, -2) : template;\n  let pattern = \"\";\n  let cursor = 0;\n\n  for (const match of base.matchAll(PARAM_SEGMENT_RE())) {\n    const start = match.index ?? 0;\n    const token = match[0];\n\n    pattern += escapeRegex(base.slice(cursor, start));\n\n    const [, boundary = \"\", , optional] = match;\n    pattern += optional\n      ? `(?:${escapeRegex(boundary)}([^/]+))?`\n      : `${escapeRegex(boundary)}([^/]+)`;\n\n    cursor = start + (token?.length ?? 0);\n  }\n\n  return pattern + escapeRegex(base.slice(cursor)) + (splat ? \"(?:/(.*))?\" : \"\");\n}\n\n/** Returns `true` when `name` is an optional (`:name?`) param in `template`. */\nfunction isOptionalParam(template: string, name: string): boolean {\n  return new RegExp(`:${escapeRegex(name)}\\\\?(?![A-Za-z0-9_])`).test(template);\n}\n\n/**\n * Returns a `RegExp` that matches `template` as a path prefix, honoring\n * segment boundaries (`/users` matches `/users/42` but not `/usersettings`).\n *\n * The root template `/` is a prefix of every path.\n *\n * Compiled patterns are cached per template: the resulting `RegExp` has no\n * `/g` flag, so repeated `.test()`/`.exec()` calls are side-effect free and\n * sharing instances across callers is safe.\n */\nconst PREFIX_CACHE = new Map<string, RegExp>();\nconst ROOT_PREFIX_RE = /^/;\n\nfunction matchPrefix(template: string): RegExp {\n  if (template === \"/\") return ROOT_PREFIX_RE;\n  const cached = PREFIX_CACHE.get(template);\n  if (cached !== undefined) return cached;\n  const re = new RegExp(`^${createTemplatePattern(template)}(?=/|$)`);\n  PREFIX_CACHE.set(template, re);\n  return re;\n}\n\n/** Decode a URL-encoded param value, falling back to the raw value on error. */\nfunction safeDecode(value: string): string {\n  try {\n    return decodeURIComponent(value);\n  } catch {\n    return value;\n  }\n}\n\n/**\n * Append a query string and/or hash fragment to a path that may already\n * contain a query or hash.\n *\n * - Existing query pairs are preserved; new ones are joined with `&`.\n * - The query string is always inserted before any hash fragment, so an\n *   existing `#section` on `path` is kept unless a new `hash` is given.\n *\n * @example\n * ```ts\n * appendQuery(\"/users?tab=list\", { page: 2 }); // → \"/users?tab=list&page=2\"\n * appendQuery(\"/users#top\", { tab: \"list\" });  // → \"/users?tab=list#top\"\n * ```\n */\nexport function appendQuery(path: string, query?: QueryParams, hash?: string): string {\n  const hashIdx = path.indexOf(\"#\");\n  const base = hashIdx === -1 ? path : path.slice(0, hashIdx);\n  const existingHash = hashIdx === -1 ? \"\" : path.slice(hashIdx + 1);\n\n  const searchParams = new URLSearchParams();\n  if (query) {\n    for (const [key, value] of Object.entries(query)) {\n      if (value === undefined || value === null) continue;\n      if (Array.isArray(value)) {\n        value.forEach((v) => {\n          if (v !== undefined && v !== null) searchParams.append(key, String(v));\n        });\n      } else {\n        searchParams.append(key, String(value));\n      }\n    }\n  }\n\n  let result = base;\n  const queryString = searchParams.toString();\n  if (queryString) {\n    result += (result.includes(\"?\") ? \"&\" : \"?\") + queryString;\n  }\n\n  if (hash) {\n    result += \"#\" + hash;\n  } else if (existingHash) {\n    result += \"#\" + existingHash;\n  }\n\n  return result;\n}\n\n/**\n * Parse the query string out of a path (or bare query string) into a plain\n * object. Repeated keys become arrays; a single key is a scalar string.\n *\n * With `{ coerceBooleans: true }`, the strings `\"true\"`/`\"false\"` are\n * converted to actual booleans.\n *\n * @example\n * ```ts\n * extractQueryFromPath(\"/users/42?tab=profile&tag=a&tag=b\");\n * // → { tab: \"profile\", tag: [\"a\", \"b\"] }\n * extractQueryFromPath(\"/search?active=true\", { coerceBooleans: true });\n * // → { active: true }\n * ```\n */\nexport function extractQueryFromPath(\n  path: string,\n  options?: { coerceBooleans?: boolean; coerceNumbers?: boolean },\n): QueryParams {\n  const hashIdx = path.indexOf(\"#\");\n  const noHash = hashIdx === -1 ? path : path.slice(0, hashIdx);\n  const queryIdx = noHash.indexOf(\"?\");\n  if (queryIdx === -1) return {};\n\n  const params = new URLSearchParams(noHash.slice(queryIdx + 1));\n  const result: QueryParams = {};\n\n  for (const key of new Set(params.keys())) {\n    const values = params.getAll(key);\n    const parsed = values.map((v) => {\n      if (options?.coerceBooleans && (v === \"true\" || v === \"false\")) {\n        return v === \"true\";\n      }\n      if (options?.coerceNumbers && v.trim() !== \"\" && !isNaN(Number(v))) {\n        return Number(v);\n      }\n      return v;\n    });\n    result[key] = parsed.length > 1 ? parsed : (parsed[0] ?? \"\");\n  }\n\n  return result;\n}\n\nexport function buildPath(\n  template: string,\n  params: RouteParams,\n  query?: QueryParams,\n  options?: BuildPathOptions,\n): string {\n  const paramNames = extractParamNames(template);\n  const unresolved = paramNames.filter(\n    (name) =>\n      (params[name] === undefined || params[name] === null) &&\n      !isOptionalParam(template, name) &&\n      // A missing splat simply drops the `/*` suffix (matching React Router,\n      // where `/files/*` also matches `/files`).\n      name !== \"*\",\n  );\n\n  const resolved = paramNames.reduce((path, name) => {\n    const value = params[name];\n    const missing = value === undefined || value === null;\n\n    if (name === \"*\") {\n      if (missing) return path.replace(/\\/\\*$/, \"\") || \"/\";\n      // Splat values are path-like: preserve `/` separators but still\n      // encode characters that could break the URL (`?`, `#`, spaces, …).\n      const encoded =\n        options?.encode === false\n          ? String(value)\n          : String(value)\n              .split(\"/\")\n              .map((segment) => encodeURIComponent(segment))\n              .join(\"/\");\n      return path.replace(/\\/\\*$/, `/${encoded}`);\n    }\n\n    const re = new RegExp(\n      `(^|/):${escapeRegex(name)}\\\\??(?![A-Za-z0-9_])`,\n      \"g\",\n    );\n\n    return path.replace(re, (match, boundary) => {\n      if (missing) {\n        // Optional segment: drop the whole `/segment`. Required: keep the\n        // `:name` placeholder so strict mode can report it.\n        return match.endsWith(\"?\") ? \"\" : `${boundary}:${name}`;\n      }\n\n      const encoded =\n        options?.encode === false\n          ? String(value)\n          : encodeURIComponent(String(value));\n      return `${boundary}${encoded}`;\n    });\n  }, template);\n\n  if (unresolved.length > 0) {\n    if (options?.strict) {\n      throw new RangeError(\n        `[route-forge] Missing required param(s) ${unresolved.map((p) => `\":${p}\"`).join(\", \")} in template \"${template}\".`,\n      );\n    }\n\n    devWarn(\n      `[route-forge] Unresolved params in path \"${resolved}\". ` +\n        `Check that all :param segments have matching keys.`,\n    );\n  }\n\n  return appendQuery(resolved, query, options?.hash);\n}\n\nexport function extractParamNames(template: string): string[] {\n  const names = [...template.matchAll(PARAM_SEGMENT_RE())].map(\n    (match) => match[2] as string,\n  );\n  if (template.endsWith(\"/*\")) names.push(\"*\");\n  return names;\n}\n\nexport function isDynamic(path: string): boolean {\n  return PARAM_SEGMENT_RE().test(path) || path.endsWith(\"/*\");\n}\n\n/**\n * Test whether `currentPath` matches `template`, mirroring React Router's\n * `NavLink` matching semantics:\n *\n * - Case-insensitive by default (pass `caseSensitive: true` to opt out).\n * - Trailing slashes are tolerated (`/users/` matches `/users`).\n * - `exact: true` (the default) requires a full match; `exact: false`\n *   matches any path that starts with the template.\n */\nexport function isActivePath(\n  currentPath: string,\n  template: string,\n  options: { exact?: boolean; caseSensitive?: boolean } = {\n    exact: true,\n    caseSensitive: false,\n  },\n): boolean {\n  const pathname = (currentPath.split(\"?\")[0] ?? \"\").replace(/\\/+$/, \"\") || \"/\";\n  const normalizedTemplate = template.replace(/\\/+$/, \"\") || \"/\";\n  const target = options.caseSensitive\n    ? normalizedTemplate\n    : normalizedTemplate.toLowerCase();\n  const candidate = options.caseSensitive ? pathname : pathname.toLowerCase();\n  const regex = options.exact ? matchPath(target) : matchPrefix(target);\n\n  return regex.test(candidate);\n}\n\nexport function extractParamsFromPath(\n  template: string,\n  resolvedPath: string,\n): Record<string, string> {\n  const pathWithoutSearch = resolvedPath.split(\"?\")[0] ?? \"\";\n  const paramNames = extractParamNames(template);\n  const match = pathWithoutSearch.match(matchPath(template));\n\n  if (!match) return {};\n\n  const result: Record<string, string> = {};\n  paramNames.forEach((name, index) => {\n    const raw = match[index + 1];\n    if (raw !== undefined) result[name] = safeDecode(raw);\n  });\n  return result;\n}\n\nexport function joinPaths(...segments: string[]): string {\n  const processed = segments.map((segment) =>\n    segment.replace(/^\\/+/, \"\").replace(/\\/+$/, \"\"),\n  );\n  const filtered = processed.filter(Boolean);\n  return \"/\" + filtered.join(\"/\");\n}\n\nexport function build(\n  template: string,\n  params: RouteParams,\n  query?: QueryParams,\n  options?: BuildPathOptions,\n): string {\n  return buildPath(template, params, query, options);\n}\n\nexport function getParamNames(template: string): string[] {\n  return extractParamNames(template);\n}\n\n/**\n * Convert a route template string into an anchored `RegExp` for matching paths.\n *\n * Each `:param` segment becomes a capturing group so the returned regex\n * can be used with `.test()` or `.exec()`.\n *\n * Query strings are **not** stripped — callers should split on `\"?\"` first\n * (see {@link isActivePath} or {@link extractParamsFromPath} for higher-level\n * helpers that handle this automatically).\n *\n * @param template - A route template, e.g. `\"/users/:id\"` or `\"/users/:id/posts/:postId\"`.\n * @returns A `RegExp` anchored with `^` and `$` that captures param values.\n *\n * @example\n * ```ts\n * const re = matchPath(\"/users/:id\");\n * re.test(\"/users/42\");          // true\n * re.exec(\"/users/42\");          // [\"/users/42\", \"42\"]\n * re.test(\"/users/42/posts\");    // false (exact match)\n * re.test(\"/users/42?page=1\");   // true (query is part of captured value)\n * ```\n *\n * Compiled patterns are cached per template (the regex has no `/g` flag, so\n * sharing instances across callers is safe).\n */\nconst PATH_CACHE = new Map<string, RegExp>();\n\nexport function matchPath(\n  template: string,\n  options?: { end?: boolean; caseSensitive?: boolean },\n): RegExp {\n  const end = options?.end ?? true;\n  const flags = options?.caseSensitive ? \"\" : \"i\";\n  const cacheKey = `${template}:${end}:${flags}`;\n\n  const cached = PATH_CACHE.get(cacheKey);\n  if (cached !== undefined) return cached;\n\n  const basePattern = createTemplatePattern(template);\n  const pattern = end ? `^${basePattern}$` : `^${basePattern}(?=/|$)`;\n  const re = new RegExp(pattern, flags);\n  PATH_CACHE.set(cacheKey, re);\n  return re;\n}\n\n/**\n * Walk a `defineRoutes` output tree and return a flat array of\n * `{ key, path }` entries where `key` is the dot-joined key path from\n * the root (e.g. `\"SERVICES.BCC.EDIT\"`) and `path` is the raw template\n * string (e.g. `\"/services/bcc/edit/:id\"`).\n *\n * Useful for:\n * - Generating sitemaps from a single source of truth.\n * - Detecting duplicate path strings across branches at startup:\n *\n * @example\n * const flat = flattenRoutes(PATHS);\n * const paths = flat.map((r) => r.path);\n * const dupes = paths.filter((p, i) => paths.indexOf(p) !== i);\n * if (dupes.length) console.warn('Duplicate paths:', dupes);\n */\nexport function flattenRoutes(\n  routes: Record<string, unknown>,\n  prefix = \"\",\n): FlatRoute[] {\n  const entries: FlatRoute[] = [];\n\n  for (const key of Object.keys(routes)) {\n    const fullKey = prefix ? `${prefix}.${key}` : key;\n    const value = routes[key];\n\n    if (typeof value === \"string\") {\n      // Plain static string leaf.\n      entries.push({ key: fullKey, path: value });\n    } else if (value instanceof String) {\n      // String-object leaf (wrapped dynamic path from defineRoutes).\n      entries.push({ key: fullKey, path: value.valueOf() });\n    } else if (typeof value === \"object\" && value !== null) {\n      // Nested route group — recurse.\n      entries.push(\n        ...flattenRoutes(value as Record<string, unknown>, fullKey),\n      );\n    }\n    // Anything else (functions, numbers, …) is silently skipped.\n  }\n\n  return entries;\n}\n\nfunction deriveBreadcrumbLabel(key: string): string {\n  const parts = key.split(\".\");\n  const last = parts[parts.length - 1] ?? key;\n  // Use the parent segment when the leaf is the conventional \"ROOT\" key,\n  // so USERS.ROOT → \"Users\" rather than \"Root\".\n  const raw = last === \"ROOT\" && parts.length > 1 ? parts[parts.length - 2]! : last;\n  return raw\n    .replace(/_/g, \" \")\n    .toLowerCase()\n    .replace(/^\\w/, (c) => c.toUpperCase());\n}\n\n/**\n * Build a breadcrumb trail from a route tree or a flat route list.\n *\n * For a given `currentPath`, it walks the route tree and returns every route\n * that is an ancestor of (or an exact match to) the current page.  Ancestors\n * are matched by prefix (e.g. `/users` matches `/users/edit/42/posts`).\n *\n * Dynamic params in ancestor paths are automatically resolved from the\n * matched portion of the URL.\n *\n * @param routes - A route tree (output of `defineRoutes`) or a pre-flattened\n *                 array from `flattenRoutes()`.\n * @param currentPath - The current URL (with or without query string).\n * @param options - Optional label resolver.\n * @returns An array of {@link BreadcrumbItem} ordered by depth\n *          (most general first), where the last item is the current page.\n *\n * @example\n * ```ts\n * const PATHS = defineRoutes({\n *   HOME: \"/\",\n *   USERS: { ROOT: \"/users\", EDIT: \"/users/edit/:id\" },\n * } as const);\n *\n * getBreadcrumbs(PATHS, \"/users/edit/42\");\n * // → [\n * //     { key: \"HOME\",       label: \"Home\",  path: \"/\",             isCurrent: false },\n * //     { key: \"USERS.ROOT\", label: \"Users\", path: \"/users\",        isCurrent: false },\n * //     { key: \"USERS.EDIT\", label: \"Edit\",  path: \"/users/edit/42\", isCurrent: true  },\n * //   ]\n * ```\n */\nexport function getBreadcrumbs(\n  routes: Record<string, unknown> | FlatRoute[],\n  currentPath: string,\n  options?: BreadcrumbOptions,\n): BreadcrumbItem[] {\n  const flat = Array.isArray(routes)\n    ? routes\n    : flattenRoutes(routes);\n  const pathname = currentPath.split(\"?\")[0] ?? \"\";\n  const labelFn = options?.labelResolver ?? deriveBreadcrumbLabel;\n  const labels = options?.labels ?? {};\n\n  const items: Array<{\n    key: string;\n    resolvedPath: string;\n    template: string;\n    isCurrent: boolean;\n  }> = [];\n\n  for (const route of flat) {\n    const exactRe = matchPath(route.path);\n    const exactMatch = pathname.match(exactRe);\n\n    if (exactMatch) {\n      const params = extractParamsFromPath(route.path, exactMatch[0]);\n      const resolved = isDynamic(route.path)\n        ? buildPath(route.path, params)\n        : route.path;\n      items.push({\n        key: route.key,\n        resolvedPath: resolved,\n        template: route.path,\n        isCurrent: true,\n      });\n      continue;\n    }\n\n    const prefixRe = matchPrefix(route.path);\n    const prefixMatch = pathname.match(prefixRe);\n\n    if (prefixMatch) {\n      const matchedPortion = prefixMatch[0];\n      const params = extractParamsFromPath(route.path, matchedPortion);\n      const resolved = isDynamic(route.path)\n        ? buildPath(route.path, params)\n        : route.path;\n      items.push({\n        key: route.key,\n        resolvedPath: resolved,\n        template: route.path,\n        isCurrent: false,\n      });\n    }\n  }\n\n  items.sort((a, b) => a.template.length - b.template.length);\n\n  return items.map((item) => ({\n    key: item.key,\n    label: labels[item.key] ?? labelFn(item.key),\n    path: item.resolvedPath,\n    isCurrent: item.isCurrent,\n  }));\n}\n\n","import {\n  buildPath,\n  devWarn,\n  extractParamNames,\n  flattenRoutes,\n  isActivePath,\n  isDynamic,\n} from \"./utils\";\nimport type {\n  BuildPathOptions,\n  ExtractParams,\n  PathParams,\n  QueryParams,\n  RoutePath,\n  RouteTree,\n} from \"../types\";\n\n// Re-export so consumers that import from 'core/defineRoutes' get the full surface\nexport { buildPath, extractParamNames, isDynamic } from \"./utils\";\n\n/**\n * A dynamic route is a template string with a `:param` or trailing `/*` splat,\n * augmented with a `.build()` helper and a `.paramNames` array.\n *\n * Exported so consumers (e.g. the hooks entry) can type against it.\n */\nexport type StaticRoute<T extends string> = T & {\n  build(query?: QueryParams, options?: BuildPathOptions): RoutePath;\n};\n\nexport type DynamicRoute<T extends string> =\n  T extends `${string}:${string}` | `${string}/*`\n    ? T & {\n        build(params: PathParams<T>, query?: QueryParams, options?: BuildPathOptions): RoutePath;\n        paramNames: Array<ExtractParams<T>>;\n      }\n    : StaticRoute<T>;\n\ntype ResolvedRoutes<T extends RouteTree> = {\n  [K in keyof T]: T[K] extends RouteTree\n    ? ResolvedRoutes<T[K]>\n    : T[K] extends string\n      ? DynamicRoute<T[K]>\n      : never;\n};\n\nconst isRouteGroup = (value: unknown): value is RouteTree =>\n  typeof value === \"object\" &&\n  value !== null &&\n  !Array.isArray(value) &&\n  Object.getPrototypeOf(value) === Object.prototype;\n\n/**\n * Validate a single route template and warn (dev-only) about common mistakes:\n * missing leading `/` and non-trailing `*` splats.\n */\nfunction validateTemplate(template: string, key: string): void {\n  if (!template.startsWith(\"/\")) {\n    devWarn(\n      `[route-forge] Route \"${key}\" does not start with \"/\": \"${template}\".`,\n    );\n  }\n\n  if (template.includes(\"*\") && !template.endsWith(\"/*\")) {\n    devWarn(\n      `[route-forge] Route \"${key}\" uses \"*\" outside a trailing \"/*\" splat; only a trailing splat is supported: \"${template}\".`,\n    );\n  }\n}\n\n/**\n * Warn (dev-only) when two routes resolve to the same path template or shadow each other.\n */\nfunction detectDuplicatePaths(routes: Record<string, unknown>): void {\n  const seen = new Map<string, string>();\n  const warned = new Set<string>();\n  const flat = flattenRoutes(routes);\n\n  for (const route of flat) {\n    const existing = seen.get(route.path);\n    if (existing === undefined) {\n      seen.set(route.path, route.key);\n    } else if (!warned.has(route.path)) {\n      warned.add(route.path);\n      devWarn(\n        `[route-forge] Duplicate route path \"${route.path}\" for \"${existing}\" and \"${route.key}\". ` +\n          `Only one of them will be reachable.`,\n      );\n    }\n  }\n\n  // Shadowing check: warn when a static path matches a dynamic path defined before it\n  for (let i = 0; i < flat.length; i++) {\n    const r1 = flat[i]!;\n    if (!isDynamic(r1.path)) continue;\n\n    for (let j = i + 1; j < flat.length; j++) {\n      const r2 = flat[j]!;\n      if (isDynamic(r2.path)) continue;\n\n      if (isActivePath(r2.path, r1.path, { exact: true })) {\n        const pairKey = `${r1.key}->${r2.key}`;\n        if (!warned.has(pairKey)) {\n          warned.add(pairKey);\n          devWarn(\n            `[route-forge] Route \"${r2.key}\" (\"${r2.path}\") is shadowed by dynamic route \"${r1.key}\" (\"${r1.path}\"). Place static routes before dynamic parameters in route trees.`,\n          );\n        }\n      }\n    }\n  }\n}\n\nfunction wrapStaticPath<T extends string>(template: T): StaticRoute<T> {\n  const wrapped = new String(template) as unknown as StaticRoute<T> & {\n    build: (query?: QueryParams, options?: BuildPathOptions) => RoutePath;\n  };\n  wrapped.build = (query?: QueryParams, options?: BuildPathOptions) =>\n    buildPath(template, {}, query, options) as RoutePath;\n\n  return wrapped as unknown as StaticRoute<T>;\n}\n\nfunction wrapDynamicPath<T extends string>(template: T): DynamicRoute<T> {\n  const paramNames = extractParamNames(template);\n  const wrapped = new String(template) as unknown as DynamicRoute<T> & {\n    build: (params: PathParams<T>, query?: QueryParams, options?: BuildPathOptions) => RoutePath;\n    paramNames: Array<ExtractParams<T>>;\n  };\n\n  wrapped.build = (params: PathParams<T>, query?: QueryParams, options?: BuildPathOptions) =>\n    buildPath(template, params, query, options) as RoutePath;\n  wrapped.paramNames = paramNames as Array<ExtractParams<T>>;\n\n  return wrapped as unknown as DynamicRoute<T>;\n}\n\nfunction processRouteMap<T extends RouteTree>(routes: T): ResolvedRoutes<T> {\n  const result = {} as ResolvedRoutes<T>;\n\n  for (const key in routes) {\n    if (!Object.prototype.hasOwnProperty.call(routes, key)) continue;\n\n    const value = routes[key];\n\n    if (typeof value === \"string\") {\n      validateTemplate(value, key);\n      result[key] = (\n        isDynamic(value) ? wrapDynamicPath(value) : wrapStaticPath(value)\n      ) as ResolvedRoutes<T>[typeof key];\n    } else if (isRouteGroup(value)) {\n      result[key] = processRouteMap(\n        value as RouteTree,\n      ) as unknown as ResolvedRoutes<T>[typeof key];\n    }\n  }\n\n  return result;\n}\n\nexport function defineRoutes<T extends RouteTree>(\n  routes: T,\n): ResolvedRoutes<T> {\n  const result = processRouteMap(routes);\n  detectDuplicatePaths(result as unknown as Record<string, unknown>);\n  return result;\n}\n"],"mappings":"yaAAA,IAAAA,GAAA,GAAAC,EAAAD,GAAA,iBAAAE,EAAA,UAAAC,EAAA,cAAAC,EAAA,mBAAAC,EAAA,iBAAAC,EAAA,YAAAC,EAAA,sBAAAC,EAAA,0BAAAC,EAAA,yBAAAC,EAAA,kBAAAC,EAAA,mBAAAC,EAAA,kBAAAC,EAAA,iBAAAC,EAAA,cAAAC,EAAA,cAAAC,EAAA,cAAAC,IAAA,eAAAC,EAAAlB,ICUA,IAAMmB,EAAY,IAAM,sBAalBC,EAAmB,IAAM,+BAG/B,SAASC,GAAwB,CAM/B,OAJE,WAGA,SACqB,KAAK,WAAa,YAC3C,CAOO,SAASC,EAAQC,EAAuB,CACxCF,EAAa,GAChB,QAAQ,KAAKE,CAAO,CAExB,CAMO,SAASC,GAAuB,CACrCC,EAAa,MAAM,EACnBC,EAAW,MAAM,CACnB,CAEA,SAASC,EAAYC,EAAuB,CAC1C,OAAOA,EAAM,QAAQT,EAAU,EAAG,MAAM,CAC1C,CAYA,SAASU,EAAsBC,EAA0B,CACvD,IAAMC,EAAQD,EAAS,SAAS,IAAI,EAC9BE,EAAOD,EAAQD,EAAS,MAAM,EAAG,EAAE,EAAIA,EACzCG,EAAU,GACVC,EAAS,EAEb,QAAWC,KAASH,EAAK,SAASZ,EAAiB,CAAC,EAAG,CACrD,IAAMgB,EAAQD,EAAM,OAAS,EACvBE,EAAQF,EAAM,CAAC,EAErBF,GAAWN,EAAYK,EAAK,MAAME,EAAQE,CAAK,CAAC,EAEhD,GAAM,CAAC,CAAEE,EAAW,GAAI,CAAEC,CAAQ,EAAIJ,EACtCF,GAAWM,EACP,MAAMZ,EAAYW,CAAQ,CAAC,YAC3B,GAAGX,EAAYW,CAAQ,CAAC,UAE5BJ,EAASE,GAASC,GAAO,QAAU,EACrC,CAEA,OAAOJ,EAAUN,EAAYK,EAAK,MAAME,CAAM,CAAC,GAAKH,EAAQ,aAAe,GAC7E,CAGA,SAASS,EAAgBV,EAAkBW,EAAuB,CAChE,OAAO,IAAI,OAAO,IAAId,EAAYc,CAAI,CAAC,qBAAqB,EAAE,KAAKX,CAAQ,CAC7E,CAYA,IAAML,EAAe,IAAI,IACnBiB,EAAiB,IAEvB,SAASC,EAAYb,EAA0B,CAC7C,GAAIA,IAAa,IAAK,OAAOY,EAC7B,IAAME,EAASnB,EAAa,IAAIK,CAAQ,EACxC,GAAIc,IAAW,OAAW,OAAOA,EACjC,IAAMC,EAAK,IAAI,OAAO,IAAIhB,EAAsBC,CAAQ,CAAC,SAAS,EAClE,OAAAL,EAAa,IAAIK,EAAUe,CAAE,EACtBA,CACT,CAGA,SAASC,EAAWlB,EAAuB,CACzC,GAAI,CACF,OAAO,mBAAmBA,CAAK,CACjC,MAAQ,CACN,OAAOA,CACT,CACF,CAgBO,SAASmB,EAAYC,EAAcC,EAAqBC,EAAuB,CACpF,IAAMC,EAAUH,EAAK,QAAQ,GAAG,EAC1BhB,EAAOmB,IAAY,GAAKH,EAAOA,EAAK,MAAM,EAAGG,CAAO,EACpDC,EAAeD,IAAY,GAAK,GAAKH,EAAK,MAAMG,EAAU,CAAC,EAE3DE,EAAe,IAAI,gBACzB,GAAIJ,EACF,OAAW,CAACK,EAAK1B,CAAK,IAAK,OAAO,QAAQqB,CAAK,EAClBrB,GAAU,OACjC,MAAM,QAAQA,CAAK,EACrBA,EAAM,QAAS2B,GAAM,CACIA,GAAM,MAAMF,EAAa,OAAOC,EAAK,OAAOC,CAAC,CAAC,CACvE,CAAC,EAEDF,EAAa,OAAOC,EAAK,OAAO1B,CAAK,CAAC,GAK5C,IAAI4B,EAASxB,EACPyB,EAAcJ,EAAa,SAAS,EAC1C,OAAII,IACFD,IAAWA,EAAO,SAAS,GAAG,EAAI,IAAM,KAAOC,GAG7CP,EACFM,GAAU,IAAMN,EACPE,IACTI,GAAU,IAAMJ,GAGXI,CACT,CAiBO,SAASE,EACdV,EACAW,EACa,CACb,IAAMR,EAAUH,EAAK,QAAQ,GAAG,EAC1BY,EAAST,IAAY,GAAKH,EAAOA,EAAK,MAAM,EAAGG,CAAO,EACtDU,EAAWD,EAAO,QAAQ,GAAG,EACnC,GAAIC,IAAa,GAAI,MAAO,CAAC,EAE7B,IAAMC,EAAS,IAAI,gBAAgBF,EAAO,MAAMC,EAAW,CAAC,CAAC,EACvDL,EAAsB,CAAC,EAE7B,QAAWF,KAAO,IAAI,IAAIQ,EAAO,KAAK,CAAC,EAAG,CAExC,IAAMC,EADSD,EAAO,OAAOR,CAAG,EACV,IAAKC,GACrBI,GAAS,iBAAmBJ,IAAM,QAAUA,IAAM,SAC7CA,IAAM,OAEXI,GAAS,eAAiBJ,EAAE,KAAK,IAAM,IAAM,CAAC,MAAM,OAAOA,CAAC,CAAC,EACxD,OAAOA,CAAC,EAEVA,CACR,EACDC,EAAOF,CAAG,EAAIS,EAAO,OAAS,EAAIA,EAAUA,EAAO,CAAC,GAAK,EAC3D,CAEA,OAAOP,CACT,CAEO,SAASQ,EACdlC,EACAgC,EACAb,EACAU,EACQ,CACR,IAAMM,EAAaC,EAAkBpC,CAAQ,EACvCqC,EAAaF,EAAW,OAC3BxB,IACEqB,EAAOrB,CAAI,IAAM,QAAaqB,EAAOrB,CAAI,IAAM,OAChD,CAACD,EAAgBV,EAAUW,CAAI,GAG/BA,IAAS,GACb,EAEM2B,EAAWH,EAAW,OAAO,CAACjB,EAAMP,IAAS,CACjD,IAAMb,EAAQkC,EAAOrB,CAAI,EACnB4B,EAAiCzC,GAAU,KAEjD,GAAIa,IAAS,IAAK,CAChB,GAAI4B,EAAS,OAAOrB,EAAK,QAAQ,QAAS,EAAE,GAAK,IAGjD,IAAMsB,EACJX,GAAS,SAAW,GAChB,OAAO/B,CAAK,EACZ,OAAOA,CAAK,EACT,MAAM,GAAG,EACT,IAAK2C,GAAY,mBAAmBA,CAAO,CAAC,EAC5C,KAAK,GAAG,EACjB,OAAOvB,EAAK,QAAQ,QAAS,IAAIsB,CAAO,EAAE,CAC5C,CAEA,IAAMzB,EAAK,IAAI,OACb,SAASlB,EAAYc,CAAI,CAAC,uBAC1B,GACF,EAEA,OAAOO,EAAK,QAAQH,EAAI,CAACV,EAAOG,IAAa,CAC3C,GAAI+B,EAGF,OAAOlC,EAAM,SAAS,GAAG,EAAI,GAAK,GAAGG,CAAQ,IAAIG,CAAI,GAGvD,IAAM6B,EACJX,GAAS,SAAW,GAChB,OAAO/B,CAAK,EACZ,mBAAmB,OAAOA,CAAK,CAAC,EACtC,MAAO,GAAGU,CAAQ,GAAGgC,CAAO,EAC9B,CAAC,CACH,EAAGxC,CAAQ,EAEX,GAAIqC,EAAW,OAAS,EAAG,CACzB,GAAIR,GAAS,OACX,MAAM,IAAI,WACR,2CAA2CQ,EAAW,IAAKK,GAAM,KAAKA,CAAC,GAAG,EAAE,KAAK,IAAI,CAAC,iBAAiB1C,CAAQ,IACjH,EAGFR,EACE,4CAA4C8C,CAAQ,uDAEtD,CACF,CAEA,OAAOrB,EAAYqB,EAAUnB,EAAOU,GAAS,IAAI,CACnD,CAEO,SAASO,EAAkBpC,EAA4B,CAC5D,IAAM2C,EAAQ,CAAC,GAAG3C,EAAS,SAASV,EAAiB,CAAC,CAAC,EAAE,IACtDe,GAAUA,EAAM,CAAC,CACpB,EACA,OAAIL,EAAS,SAAS,IAAI,GAAG2C,EAAM,KAAK,GAAG,EACpCA,CACT,CAEO,SAASC,EAAU1B,EAAuB,CAC/C,OAAO5B,EAAiB,EAAE,KAAK4B,CAAI,GAAKA,EAAK,SAAS,IAAI,CAC5D,CAWO,SAAS2B,EACdC,EACA9C,EACA6B,EAAwD,CACtD,MAAO,GACP,cAAe,EACjB,EACS,CACT,IAAMkB,GAAYD,EAAY,MAAM,GAAG,EAAE,CAAC,GAAK,IAAI,QAAQ,OAAQ,EAAE,GAAK,IACpEE,EAAqBhD,EAAS,QAAQ,OAAQ,EAAE,GAAK,IACrDiD,EAASpB,EAAQ,cACnBmB,EACAA,EAAmB,YAAY,EAC7BE,EAAYrB,EAAQ,cAAgBkB,EAAWA,EAAS,YAAY,EAG1E,OAFclB,EAAQ,MAAQsB,EAAUF,CAAM,EAAIpC,EAAYoC,CAAM,GAEvD,KAAKC,CAAS,CAC7B,CAEO,SAASE,EACdpD,EACAqD,EACwB,CACxB,IAAMC,EAAoBD,EAAa,MAAM,GAAG,EAAE,CAAC,GAAK,GAClDlB,EAAaC,EAAkBpC,CAAQ,EACvCK,EAAQiD,EAAkB,MAAMH,EAAUnD,CAAQ,CAAC,EAEzD,GAAI,CAACK,EAAO,MAAO,CAAC,EAEpB,IAAMqB,EAAiC,CAAC,EACxC,OAAAS,EAAW,QAAQ,CAACxB,EAAM4C,IAAU,CAClC,IAAMC,EAAMnD,EAAMkD,EAAQ,CAAC,EACvBC,IAAQ,SAAW9B,EAAOf,CAAI,EAAIK,EAAWwC,CAAG,EACtD,CAAC,EACM9B,CACT,CAEO,SAAS+B,KAAaC,EAA4B,CAKvD,MAAO,IAJWA,EAAS,IAAKjB,GAC9BA,EAAQ,QAAQ,OAAQ,EAAE,EAAE,QAAQ,OAAQ,EAAE,CAChD,EAC2B,OAAO,OAAO,EACnB,KAAK,GAAG,CAChC,CAEO,SAASkB,EACd3D,EACAgC,EACAb,EACAU,EACQ,CACR,OAAOK,EAAUlC,EAAUgC,EAAQb,EAAOU,CAAO,CACnD,CAEO,SAAS+B,EAAc5D,EAA4B,CACxD,OAAOoC,EAAkBpC,CAAQ,CACnC,CA2BA,IAAMJ,EAAa,IAAI,IAEhB,SAASuD,EACdnD,EACA6B,EACQ,CACR,IAAMgC,EAAMhC,GAAS,KAAO,GACtBiC,EAAQjC,GAAS,cAAgB,GAAK,IACtCkC,EAAW,GAAG/D,CAAQ,IAAI6D,CAAG,IAAIC,CAAK,GAEtChD,EAASlB,EAAW,IAAImE,CAAQ,EACtC,GAAIjD,IAAW,OAAW,OAAOA,EAEjC,IAAMkD,EAAcjE,EAAsBC,CAAQ,EAC5CG,EAAU0D,EAAM,IAAIG,CAAW,IAAM,IAAIA,CAAW,UACpDjD,EAAK,IAAI,OAAOZ,EAAS2D,CAAK,EACpC,OAAAlE,EAAW,IAAImE,EAAUhD,CAAE,EACpBA,CACT,CAkBO,SAASkD,EACdC,EACAC,EAAS,GACI,CACb,IAAMC,EAAuB,CAAC,EAE9B,QAAW5C,KAAO,OAAO,KAAK0C,CAAM,EAAG,CACrC,IAAMG,EAAUF,EAAS,GAAGA,CAAM,IAAI3C,CAAG,GAAKA,EACxC1B,EAAQoE,EAAO1C,CAAG,EAEpB,OAAO1B,GAAU,SAEnBsE,EAAQ,KAAK,CAAE,IAAKC,EAAS,KAAMvE,CAAM,CAAC,EACjCA,aAAiB,OAE1BsE,EAAQ,KAAK,CAAE,IAAKC,EAAS,KAAMvE,EAAM,QAAQ,CAAE,CAAC,EAC3C,OAAOA,GAAU,UAAYA,IAAU,MAEhDsE,EAAQ,KACN,GAAGH,EAAcnE,EAAkCuE,CAAO,CAC5D,CAGJ,CAEA,OAAOD,CACT,CAEA,SAASE,EAAsB9C,EAAqB,CAClD,IAAM+C,EAAQ/C,EAAI,MAAM,GAAG,EACrBgD,EAAOD,EAAMA,EAAM,OAAS,CAAC,GAAK/C,EAIxC,OADYgD,IAAS,QAAUD,EAAM,OAAS,EAAIA,EAAMA,EAAM,OAAS,CAAC,EAAKC,GAE1E,QAAQ,KAAM,GAAG,EACjB,YAAY,EACZ,QAAQ,MAAQC,GAAMA,EAAE,YAAY,CAAC,CAC1C,CAkCO,SAASC,EACdR,EACApB,EACAjB,EACkB,CAClB,IAAM8C,EAAO,MAAM,QAAQT,CAAM,EAC7BA,EACAD,EAAcC,CAAM,EAClBnB,EAAWD,EAAY,MAAM,GAAG,EAAE,CAAC,GAAK,GACxC8B,EAAU/C,GAAS,eAAiByC,EACpCO,EAAShD,GAAS,QAAU,CAAC,EAE7BiD,EAKD,CAAC,EAEN,QAAWC,KAASJ,EAAM,CACxB,IAAMK,EAAU7B,EAAU4B,EAAM,IAAI,EAC9BE,EAAalC,EAAS,MAAMiC,CAAO,EAEzC,GAAIC,EAAY,CACd,IAAMjD,EAASoB,EAAsB2B,EAAM,KAAME,EAAW,CAAC,CAAC,EACxD3C,EAAWM,EAAUmC,EAAM,IAAI,EACjC7C,EAAU6C,EAAM,KAAM/C,CAAM,EAC5B+C,EAAM,KACVD,EAAM,KAAK,CACT,IAAKC,EAAM,IACX,aAAczC,EACd,SAAUyC,EAAM,KAChB,UAAW,EACb,CAAC,EACD,QACF,CAEA,IAAMG,EAAWrE,EAAYkE,EAAM,IAAI,EACjCI,EAAcpC,EAAS,MAAMmC,CAAQ,EAE3C,GAAIC,EAAa,CACf,IAAMC,EAAiBD,EAAY,CAAC,EAC9BnD,EAASoB,EAAsB2B,EAAM,KAAMK,CAAc,EACzD9C,EAAWM,EAAUmC,EAAM,IAAI,EACjC7C,EAAU6C,EAAM,KAAM/C,CAAM,EAC5B+C,EAAM,KACVD,EAAM,KAAK,CACT,IAAKC,EAAM,IACX,aAAczC,EACd,SAAUyC,EAAM,KAChB,UAAW,EACb,CAAC,CACH,CACF,CAEA,OAAAD,EAAM,KAAK,CAAC,EAAGO,IAAM,EAAE,SAAS,OAASA,EAAE,SAAS,MAAM,EAEnDP,EAAM,IAAKQ,IAAU,CAC1B,IAAKA,EAAK,IACV,MAAOT,EAAOS,EAAK,GAAG,GAAKV,EAAQU,EAAK,GAAG,EAC3C,KAAMA,EAAK,aACX,UAAWA,EAAK,SAClB,EAAE,CACJ,CCvgBA,IAAMC,EAAgBC,GACpB,OAAOA,GAAU,UACjBA,IAAU,MACV,CAAC,MAAM,QAAQA,CAAK,GACpB,OAAO,eAAeA,CAAK,IAAM,OAAO,UAM1C,SAASC,EAAiBC,EAAkBC,EAAmB,CACxDD,EAAS,WAAW,GAAG,GAC1BE,EACE,wBAAwBD,CAAG,+BAA+BD,CAAQ,IACpE,EAGEA,EAAS,SAAS,GAAG,GAAK,CAACA,EAAS,SAAS,IAAI,GACnDE,EACE,wBAAwBD,CAAG,kFAAkFD,CAAQ,IACvH,CAEJ,CAKA,SAASG,GAAqBC,EAAuC,CACnE,IAAMC,EAAO,IAAI,IACXC,EAAS,IAAI,IACbC,EAAOC,EAAcJ,CAAM,EAEjC,QAAWK,KAASF,EAAM,CACxB,IAAMG,EAAWL,EAAK,IAAII,EAAM,IAAI,EAChCC,IAAa,OACfL,EAAK,IAAII,EAAM,KAAMA,EAAM,GAAG,EACpBH,EAAO,IAAIG,EAAM,IAAI,IAC/BH,EAAO,IAAIG,EAAM,IAAI,EACrBP,EACE,uCAAuCO,EAAM,IAAI,UAAUC,CAAQ,UAAUD,EAAM,GAAG,wCAExF,EAEJ,CAGA,QAASE,EAAI,EAAGA,EAAIJ,EAAK,OAAQI,IAAK,CACpC,IAAMC,EAAKL,EAAKI,CAAC,EACjB,GAAKE,EAAUD,EAAG,IAAI,EAEtB,QAASE,EAAIH,EAAI,EAAGG,EAAIP,EAAK,OAAQO,IAAK,CACxC,IAAMC,EAAKR,EAAKO,CAAC,EACjB,GAAI,CAAAD,EAAUE,EAAG,IAAI,GAEjBC,EAAaD,EAAG,KAAMH,EAAG,KAAM,CAAE,MAAO,EAAK,CAAC,EAAG,CACnD,IAAMK,EAAU,GAAGL,EAAG,GAAG,KAAKG,EAAG,GAAG,GAC/BT,EAAO,IAAIW,CAAO,IACrBX,EAAO,IAAIW,CAAO,EAClBf,EACE,wBAAwBa,EAAG,GAAG,OAAOA,EAAG,IAAI,oCAAoCH,EAAG,GAAG,OAAOA,EAAG,IAAI,mEACtG,EAEJ,CACF,CACF,CACF,CAEA,SAASM,GAAiClB,EAA6B,CACrE,IAAMmB,EAAU,IAAI,OAAOnB,CAAQ,EAGnC,OAAAmB,EAAQ,MAAQ,CAACC,EAAqBC,IACpCC,EAAUtB,EAAU,CAAC,EAAGoB,EAAOC,CAAO,EAEjCF,CACT,CAEA,SAASI,GAAkCvB,EAA8B,CACvE,IAAMwB,EAAaC,EAAkBzB,CAAQ,EACvCmB,EAAU,IAAI,OAAOnB,CAAQ,EAKnC,OAAAmB,EAAQ,MAAQ,CAACO,EAAuBN,EAAqBC,IAC3DC,EAAUtB,EAAU0B,EAAQN,EAAOC,CAAO,EAC5CF,EAAQ,WAAaK,EAEdL,CACT,CAEA,SAASQ,EAAqCvB,EAA8B,CAC1E,IAAMwB,EAAS,CAAC,EAEhB,QAAW3B,KAAOG,EAAQ,CACxB,GAAI,CAAC,OAAO,UAAU,eAAe,KAAKA,EAAQH,CAAG,EAAG,SAExD,IAAMH,EAAQM,EAAOH,CAAG,EAEpB,OAAOH,GAAU,UACnBC,EAAiBD,EAAOG,CAAG,EAC3B2B,EAAO3B,CAAG,EACRY,EAAUf,CAAK,EAAIyB,GAAgBzB,CAAK,EAAIoB,GAAepB,CAAK,GAEzDD,EAAaC,CAAK,IAC3B8B,EAAO3B,CAAG,EAAI0B,EACZ7B,CACF,EAEJ,CAEA,OAAO8B,CACT,CAEO,SAASC,EACdzB,EACmB,CACnB,IAAMwB,EAASD,EAAgBvB,CAAM,EACrC,OAAAD,GAAqByB,CAA4C,EAC1DA,CACT","names":["index_exports","__export","appendQuery","build","buildPath","clearPathCache","defineRoutes","devWarn","extractParamNames","extractParamsFromPath","extractQueryFromPath","flattenRoutes","getBreadcrumbs","getParamNames","isActivePath","isDynamic","joinPaths","matchPath","__toCommonJS","ESCAPE_RE","PARAM_SEGMENT_RE","isProduction","devWarn","message","clearPathCache","PREFIX_CACHE","PATH_CACHE","escapeRegex","value","createTemplatePattern","template","splat","base","pattern","cursor","match","start","token","boundary","optional","isOptionalParam","name","ROOT_PREFIX_RE","matchPrefix","cached","re","safeDecode","appendQuery","path","query","hash","hashIdx","existingHash","searchParams","key","v","result","queryString","extractQueryFromPath","options","noHash","queryIdx","params","parsed","buildPath","paramNames","extractParamNames","unresolved","resolved","missing","encoded","segment","p","names","isDynamic","isActivePath","currentPath","pathname","normalizedTemplate","target","candidate","matchPath","extractParamsFromPath","resolvedPath","pathWithoutSearch","index","raw","joinPaths","segments","build","getParamNames","end","flags","cacheKey","basePattern","flattenRoutes","routes","prefix","entries","fullKey","deriveBreadcrumbLabel","parts","last","c","getBreadcrumbs","flat","labelFn","labels","items","route","exactRe","exactMatch","prefixRe","prefixMatch","matchedPortion","b","item","isRouteGroup","value","validateTemplate","template","key","devWarn","detectDuplicatePaths","routes","seen","warned","flat","flattenRoutes","route","existing","i","r1","isDynamic","j","r2","isActivePath","pairKey","wrapStaticPath","wrapped","query","options","buildPath","wrapDynamicPath","paramNames","extractParamNames","params","processRouteMap","result","defineRoutes"]}
+{"version":3,"sources":["../src/index.ts","../src/core/environment.ts","../src/core/pattern.ts","../src/core/params.ts","../src/core/query.ts","../src/core/build.ts","../src/core/match.ts","../src/core/routes.ts","../src/core/defineRoutes.ts"],"sourcesContent":["// Core\nexport { defineRoutes } from \"./core/defineRoutes\";\nexport type { StaticRoute, DynamicRoute } from \"./core/defineRoutes\";\n\n// Path building\nexport { buildPath, build, joinPaths } from \"./core/build\";\nexport {\n  extractParamNames,\n  extractParamsFromPath,\n  getParamNames,\n  isDynamic,\n} from \"./core/params\";\n\n// Matching\nexport { isActivePath } from \"./core/match\";\nexport { matchPath } from \"./core/pattern\";\n\n// Query strings & hashes\nexport { appendQuery, extractQueryFromPath } from \"./core/query\";\n\n// Route trees\nexport { flattenRoutes, getBreadcrumbs } from \"./core/routes\";\n\n// Environment\nexport { devWarn } from \"./core/environment\";\nexport { clearPathCache } from \"./core/pattern\";\n\n// Types\nexport type {\n  RoutePath,\n  RouteBuilder,\n  RouteParam,\n  RouteParams,\n  QueryParams,\n  RouteLeaf,\n  RouteMap,\n  RouteTree,\n  ExtractParams,\n  PathParams,\n  BuildPathOptions,\n  FlatRoute,\n  BreadcrumbItem,\n  BreadcrumbOptions,\n  MatchPathOptions,\n} from \"./types\";\n","/**\n * Returns `true` when running in a production bundle (suppresses dev warnings).\n */\nexport function isProduction(): boolean {\n  const runtimeProcess = (\n    globalThis as typeof globalThis & {\n      process?: { env?: Record<string, string | undefined> };\n    }\n  ).process;\n  return runtimeProcess?.env?.NODE_ENV === \"production\";\n}\n\n/**\n * Emits a `console.warn` in non-production environments.\n * Shared by the core utilities and `defineRoutes()` so the production check\n * lives in one place.\n */\nexport function devWarn(message: string): void {\n  if (!isProduction()) {\n    console.warn(message);\n  }\n}\n","/** Returns a fresh RegExp each call — avoids shared `lastIndex` state on /g patterns. */\nconst ESCAPE_RE = () => /[.*+?^${}()|[\\]\\\\]/g;\n\n/**\n * Matches a `:param` token that starts a URL segment.\n *\n * A param is only recognized when its `:` sits at the very start of the\n * template or is immediately preceded by `/`, so a literal colon inside a\n * segment (e.g. `/users/foo:bar`) is not treated as a param. Param names are\n * restricted to `[A-Za-z0-9_]` (matching React Router), so any static suffix\n * (e.g. `.json` in `/files/:name.json`) stays a literal. The optional `?`\n * marker (`:param?`) is captured separately so it can be handled as a\n * whole-segment modifier.\n */\nexport const PARAM_SEGMENT_RE = () => /(^|\\/):([A-Za-z0-9_]+)(\\?)?/g;\n\nexport function escapeRegex(value: string): string {\n  return value.replace(ESCAPE_RE(), \"\\\\$&\");\n}\n\n/**\n * Convert a route template into an unanchored `RegExp` source string.\n *\n * - Required `:name` segments become a capturing group `([^/]+)`.\n * - Optional `:name?` segments become `(?:([^/]+))?` — the whole segment is\n *   optional, matching React Router semantics.\n * - A trailing splat (`/*`) becomes `(?:/(.*))?`, capturing the remainder of\n *   the path (including slashes) or nothing at all.\n * - Everything else is regex-escaped literally.\n */\nfunction createTemplatePattern(template: string): string {\n  const splat = template.endsWith(\"/*\");\n  const base = splat ? template.slice(0, -2) : template;\n  let pattern = \"\";\n  let cursor = 0;\n\n  for (const match of base.matchAll(PARAM_SEGMENT_RE())) {\n    const start = match.index ?? 0;\n    const token = match[0];\n\n    pattern += escapeRegex(base.slice(cursor, start));\n\n    const [, boundary = \"\", , optional] = match;\n    pattern += optional\n      ? `(?:${escapeRegex(boundary)}([^/]+))?`\n      : `${escapeRegex(boundary)}([^/]+)`;\n\n    cursor = start + (token?.length ?? 0);\n  }\n\n  return (\n    pattern + escapeRegex(base.slice(cursor)) + (splat ? \"(?:/(.*))?\" : \"\")\n  );\n}\n\n/** Returns `true` when `name` is an optional (`:name?`) param in `template`. */\nexport function isOptionalParam(template: string, name: string): boolean {\n  return new RegExp(`:${escapeRegex(name)}\\\\?(?![A-Za-z0-9_])`).test(template);\n}\n\n/**\n * Returns a `RegExp` that matches `template` as a path prefix, honoring\n * segment boundaries (`/users` matches `/users/42` but not `/usersettings`).\n *\n * The root template `/` is a prefix of every path.\n *\n * Compiled patterns are cached per template: the resulting `RegExp` has no\n * `/g` flag, so repeated `.test()`/`.exec()` calls are side-effect free and\n * sharing instances across callers is safe.\n */\nconst PREFIX_CACHE = new Map<string, RegExp>();\nconst ROOT_PREFIX_RE = /^/;\n\nexport function matchPrefix(template: string): RegExp {\n  if (template === \"/\") return ROOT_PREFIX_RE;\n  const cached = PREFIX_CACHE.get(template);\n  if (cached !== undefined) return cached;\n  const re = new RegExp(`^${createTemplatePattern(template)}(?=/|$)`);\n  PREFIX_CACHE.set(template, re);\n  return re;\n}\n\n/** Decode a URL-encoded param value, falling back to the raw value on error. */\nexport function safeDecode(value: string): string {\n  try {\n    return decodeURIComponent(value);\n  } catch {\n    return value;\n  }\n}\n\n/**\n * Convert a route template string into an anchored `RegExp` for matching paths.\n *\n * Each `:param` segment becomes a capturing group so the returned regex\n * can be used with `.test()` or `.exec()`.\n *\n * Query strings are **not** stripped — callers should split on `\"?\"` first\n * (see {@link isActivePath} or {@link extractParamsFromPath} for higher-level\n * helpers that handle this automatically).\n *\n * @param template - A route template, e.g. `\"/users/:id\"` or `\"/users/:id/posts/:postId\"`.\n * @returns A `RegExp` anchored with `^` and `$` that captures param values.\n *\n * @example\n * ```ts\n * const re = matchPath(\"/users/:id\");\n * re.test(\"/users/42\");          // true\n * re.exec(\"/users/42\");          // [\"/users/42\", \"42\"]\n * re.test(\"/users/42/posts\");    // false (exact match)\n * re.test(\"/users/42?page=1\");   // true (query is part of captured value)\n * ```\n *\n * Compiled patterns are cached per template (the regex has no `/g` flag, so\n * sharing instances across callers is safe).\n */\nconst PATH_CACHE = new Map<string, RegExp>();\n\nexport function matchPath(\n  template: string,\n  options?: { end?: boolean; caseSensitive?: boolean },\n): RegExp {\n  const end = options?.end ?? true;\n  const flags = options?.caseSensitive ? \"\" : \"i\";\n  const cacheKey = `${template}:${end}:${flags}`;\n\n  const cached = PATH_CACHE.get(cacheKey);\n  if (cached !== undefined) return cached;\n\n  const basePattern = createTemplatePattern(template);\n  const pattern = end ? `^${basePattern}$` : `^${basePattern}(?=/|$)`;\n  const re = new RegExp(pattern, flags);\n  PATH_CACHE.set(cacheKey, re);\n  return re;\n}\n\n/**\n * Clears internal regex cache maps (PREFIX_CACHE and PATH_CACHE).\n * Useful in test suites to prevent cached patterns from leaking across test cases.\n */\nexport function clearPathCache(): void {\n  PREFIX_CACHE.clear();\n  PATH_CACHE.clear();\n}\n","import { PARAM_SEGMENT_RE, matchPath, safeDecode } from \"./pattern\";\n\n/**\n * Extract the `:param` names from a route template.\n *\n * A param is only recognized at the start of a segment (see\n * {@link PARAM_SEGMENT_RE}), so literal colons (`/users/foo:bar`) and static\n * suffixes after a param (`/files/:name.json`) are not treated as params.\n * A trailing splat (`/*`) is reported as the `\"*\"` name.\n */\nexport function extractParamNames(template: string): string[] {\n  const names = [...template.matchAll(PARAM_SEGMENT_RE())].map(\n    (match) => match[2] as string,\n  );\n  if (template.endsWith(\"/*\")) names.push(\"*\");\n  return names;\n}\n\n/** Returns `true` when the template contains a `:param` or trailing `/*` splat. */\nexport function isDynamic(path: string): boolean {\n  return PARAM_SEGMENT_RE().test(path) || path.endsWith(\"/*\");\n}\n\n/**\n * Alias of {@link extractParamNames} — kept for backwards compatibility.\n */\nexport function getParamNames(template: string): string[] {\n  return extractParamNames(template);\n}\n\n/**\n * Extract the param values matched by `template` from a resolved path.\n *\n * The query string is stripped before matching, so `/users/42?tab=profile`\n * still yields `{ id: \"42\" }`. Values are URL-decoded back to their original\n * form; a non-matching path yields an empty object.\n */\nexport function extractParamsFromPath(\n  template: string,\n  resolvedPath: string,\n): Record<string, string> {\n  const pathWithoutSearch = resolvedPath.split(\"?\")[0] ?? \"\";\n  const paramNames = extractParamNames(template);\n  const match = pathWithoutSearch.match(matchPath(template));\n\n  if (!match) return {};\n\n  const result: Record<string, string> = {};\n  paramNames.forEach((name, index) => {\n    const raw = match[index + 1];\n    if (raw !== undefined) result[name] = safeDecode(raw);\n  });\n  return result;\n}\n","import type { QueryParams } from \"../types\";\n\n/**\n * Append a query string and/or hash fragment to a path that may already\n * contain a query or hash.\n *\n * - Existing query pairs are preserved; new ones are joined with `&`.\n * - The query string is always inserted before any hash fragment, so an\n *   existing `#section` on `path` is kept unless a new `hash` is given.\n *\n * @example\n * ```ts\n * appendQuery(\"/users?tab=list\", { page: 2 }); // → \"/users?tab=list&page=2\"\n * appendQuery(\"/users#top\", { tab: \"list\" });  // → \"/users?tab=list#top\"\n * ```\n */\nexport function appendQuery(\n  path: string,\n  query?: QueryParams,\n  hash?: string,\n): string {\n  const hashIdx = path.indexOf(\"#\");\n  const base = hashIdx === -1 ? path : path.slice(0, hashIdx);\n  const existingHash = hashIdx === -1 ? \"\" : path.slice(hashIdx + 1);\n\n  const searchParams = new URLSearchParams();\n  if (query) {\n    for (const [key, value] of Object.entries(query)) {\n      if (value === undefined || value === null) continue;\n      if (Array.isArray(value)) {\n        value.forEach((v) => {\n          if (v !== undefined && v !== null)\n            searchParams.append(key, String(v));\n        });\n      } else {\n        searchParams.append(key, String(value));\n      }\n    }\n  }\n\n  let result = base;\n  const queryString = searchParams.toString();\n  if (queryString) {\n    result += (result.includes(\"?\") ? \"&\" : \"?\") + queryString;\n  }\n\n  if (hash) {\n    result += \"#\" + hash;\n  } else if (existingHash) {\n    result += \"#\" + existingHash;\n  }\n\n  return result;\n}\n\n/**\n * Parse the query string out of a path (or bare query string) into a plain\n * object. Repeated keys become arrays; a single key is a scalar string.\n *\n * With `{ coerceBooleans: true }`, the strings `\"true\"`/`\"false\"` are\n * converted to actual booleans.\n *\n * @example\n * ```ts\n * extractQueryFromPath(\"/users/42?tab=profile&tag=a&tag=b\");\n * // → { tab: \"profile\", tag: [\"a\", \"b\"] }\n * extractQueryFromPath(\"/search?active=true\", { coerceBooleans: true });\n * // → { active: true }\n * ```\n */\nexport function extractQueryFromPath(\n  path: string,\n  options?: { coerceBooleans?: boolean; coerceNumbers?: boolean },\n): QueryParams {\n  const hashIdx = path.indexOf(\"#\");\n  const noHash = hashIdx === -1 ? path : path.slice(0, hashIdx);\n  const queryIdx = noHash.indexOf(\"?\");\n  if (queryIdx === -1) return {};\n\n  const params = new URLSearchParams(noHash.slice(queryIdx + 1));\n  const result: QueryParams = {};\n\n  for (const key of new Set(params.keys())) {\n    const values = params.getAll(key);\n    const parsed = values.map((v) => {\n      if (options?.coerceBooleans && (v === \"true\" || v === \"false\")) {\n        return v === \"true\";\n      }\n      if (options?.coerceNumbers && v.trim() !== \"\" && !isNaN(Number(v))) {\n        return Number(v);\n      }\n      return v;\n    });\n    result[key] = parsed.length > 1 ? parsed : (parsed[0] ?? \"\");\n  }\n\n  return result;\n}\n","import { escapeRegex, isOptionalParam } from \"./pattern\";\nimport { extractParamNames } from \"./params\";\nimport { appendQuery } from \"./query\";\nimport { devWarn } from \"./environment\";\nimport type { BuildPathOptions, QueryParams, RouteParams } from \"../types\";\n\n/**\n * Resolve a route template against a params object, appending an optional\n * query string and hash fragment.\n *\n * Missing required params are left as their `:name` placeholder and a\n * `console.warn` is emitted — pass `{ strict: true }` to throw a `RangeError`\n * instead. Optional (`:param?`) segments are dropped entirely when missing;\n * a missing splat just drops the trailing `/*`. Values are URL-encoded by\n * default (`{ encode: false }` opts out).\n */\nexport function buildPath(\n  template: string,\n  params: RouteParams,\n  query?: QueryParams,\n  options?: BuildPathOptions,\n): string {\n  const paramNames = extractParamNames(template);\n  const unresolved = paramNames.filter(\n    (name) =>\n      (params[name] === undefined || params[name] === null) &&\n      !isOptionalParam(template, name) &&\n      // A missing splat simply drops the `/*` suffix (matching React Router,\n      // where `/files/*` also matches `/files`).\n      name !== \"*\",\n  );\n\n  const resolved = paramNames.reduce((path, name) => {\n    const value = params[name];\n    const missing = value === undefined || value === null;\n\n    if (name === \"*\") {\n      if (missing) return path.replace(/\\/\\*$/, \"\") || \"/\";\n      // Splat values are path-like: preserve `/` separators but still\n      // encode characters that could break the URL (`?`, `#`, spaces, …).\n      const encoded =\n        options?.encode === false\n          ? String(value)\n          : String(value)\n              .split(\"/\")\n              .map((segment) => encodeURIComponent(segment))\n              .join(\"/\");\n      return path.replace(/\\/\\*$/, `/${encoded}`);\n    }\n\n    const re = new RegExp(\n      `(^|/):${escapeRegex(name)}\\\\??(?![A-Za-z0-9_])`,\n      \"g\",\n    );\n\n    return path.replace(re, (match, boundary) => {\n      if (missing) {\n        // Optional segment: drop the whole `/segment`. Required: keep the\n        // `:name` placeholder so strict mode can report it.\n        return match.endsWith(\"?\") ? \"\" : `${boundary}:${name}`;\n      }\n\n      const encoded =\n        options?.encode === false\n          ? String(value)\n          : encodeURIComponent(String(value));\n      return `${boundary}${encoded}`;\n    });\n  }, template);\n\n  if (unresolved.length > 0) {\n    if (options?.strict) {\n      throw new RangeError(\n        `[route-forge] Missing required param(s) ${unresolved.map((p) => `\":${p}\"`).join(\", \")} in template \"${template}\".`,\n      );\n    }\n\n    devWarn(\n      `[route-forge] Unresolved params in path \"${resolved}\". ` +\n        `Check that all :param segments have matching keys.`,\n    );\n  }\n\n  return appendQuery(resolved, query, options?.hash);\n}\n\n/**\n * Standalone alias of {@link buildPath} — resolves a template against params.\n */\nexport function build(\n  template: string,\n  params: RouteParams,\n  query?: QueryParams,\n  options?: BuildPathOptions,\n): string {\n  return buildPath(template, params, query, options);\n}\n\n/**\n * Join URL path segments into a single slash-prefixed path, normalising\n * duplicate slashes.\n *\n * @example\n * joinPaths(\"/api/\", \"/v1/\", \"users\"); // → \"/api/v1/users\"\n */\nexport function joinPaths(...segments: string[]): string {\n  const processed = segments.map((segment) =>\n    segment.replace(/^\\/+/, \"\").replace(/\\/+$/, \"\"),\n  );\n  const filtered = processed.filter(Boolean);\n  return \"/\" + filtered.join(\"/\");\n}\n","import { matchPath, matchPrefix } from \"./pattern\";\n\n/**\n * Test whether `currentPath` matches `template`, mirroring React Router's\n * `NavLink` matching semantics:\n *\n * - Case-insensitive by default (pass `caseSensitive: true` to opt out).\n * - Trailing slashes are tolerated (`/users/` matches `/users`).\n * - `exact: true` (the default) requires a full match; `exact: false`\n *   matches any path that starts with the template.\n */\nexport function isActivePath(\n  currentPath: string,\n  template: string,\n  options: { exact?: boolean; caseSensitive?: boolean } = {},\n): boolean {\n  // NOTE: default each property individually rather than relying on a\n  // default *object* for `options` — JS default parameters only apply when\n  // the whole argument is omitted, so `isActivePath(a, b, { caseSensitive: true })`\n  // would otherwise silently lose the documented `exact: true` default.\n  const exact = options.exact ?? true;\n  const caseSensitive = options.caseSensitive ?? false;\n\n  const pathname = (currentPath.split(\"?\")[0] ?? \"\").replace(/\\/+$/, \"\") || \"/\";\n  const normalizedTemplate = template.replace(/\\/+$/, \"\") || \"/\";\n  const target = caseSensitive\n    ? normalizedTemplate\n    : normalizedTemplate.toLowerCase();\n  const candidate = caseSensitive ? pathname : pathname.toLowerCase();\n  const regex = exact\n    ? matchPath(target, { caseSensitive })\n    : matchPrefix(target);\n\n  return regex.test(candidate);\n}\n","import { matchPath, matchPrefix } from \"./pattern\";\nimport { extractParamsFromPath, isDynamic } from \"./params\";\nimport { buildPath } from \"./build\";\nimport type {\n  BreadcrumbItem,\n  BreadcrumbOptions,\n  FlatRoute,\n} from \"../types\";\n\n/**\n * Walk a `defineRoutes` output tree and return a flat array of\n * `{ key, path }` entries where `key` is the dot-joined key path from\n * the root (e.g. `\"SERVICES.BCC.EDIT\"`) and `path` is the raw template\n * string (e.g. `\"/services/bcc/edit/:id\"`).\n *\n * Useful for:\n * - Generating sitemaps from a single source of truth.\n * - Detecting duplicate path strings across branches at startup:\n *\n * @example\n * const flat = flattenRoutes(PATHS);\n * const paths = flat.map((r) => r.path);\n * const dupes = paths.filter((p, i) => paths.indexOf(p) !== i);\n * if (dupes.length) console.warn('Duplicate paths:', dupes);\n */\nexport function flattenRoutes(\n  routes: Record<string, unknown>,\n  prefix = \"\",\n): FlatRoute[] {\n  const entries: FlatRoute[] = [];\n\n  for (const key of Object.keys(routes)) {\n    const fullKey = prefix ? `${prefix}.${key}` : key;\n    const value = routes[key];\n\n    if (typeof value === \"string\") {\n      // Plain static string leaf.\n      entries.push({ key: fullKey, path: value });\n    } else if (value instanceof String) {\n      // String-object leaf (wrapped dynamic path from defineRoutes).\n      entries.push({ key: fullKey, path: value.valueOf() });\n    } else if (typeof value === \"object\" && value !== null) {\n      // Nested route group — recurse.\n      entries.push(...flattenRoutes(value as Record<string, unknown>, fullKey));\n    }\n    // Anything else (functions, numbers, …) is silently skipped.\n  }\n\n  return entries;\n}\n\nfunction deriveBreadcrumbLabel(key: string): string {\n  const parts = key.split(\".\");\n  const last = parts[parts.length - 1] ?? key;\n  // Use the parent segment when the leaf is the conventional \"ROOT\" key,\n  // so USERS.ROOT → \"Users\" rather than \"Root\".\n  const raw =\n    last === \"ROOT\" && parts.length > 1 ? parts[parts.length - 2]! : last;\n  return raw\n    .replace(/_/g, \" \")\n    .toLowerCase()\n    .replace(/^\\w/, (c) => c.toUpperCase());\n}\n\n/**\n * Build a breadcrumb trail from a route tree or a flat route list.\n *\n * For a given `currentPath`, it walks the route tree and returns every route\n * that is an ancestor of (or an exact match to) the current page.  Ancestors\n * are matched by prefix (e.g. `/users` matches `/users/edit/42/posts`).\n *\n * Dynamic params in ancestor paths are automatically resolved from the\n * matched portion of the URL.\n *\n * @param routes - A route tree (output of `defineRoutes`) or a pre-flattened\n *                 array from `flattenRoutes()`.\n * @param currentPath - The current URL (with or without query string).\n * @param options - Optional label resolver.\n * @returns An array of {@link BreadcrumbItem} ordered by depth\n *          (most general first), where the last item is the current page.\n *\n * @example\n * ```ts\n * const PATHS = defineRoutes({\n *   HOME: \"/\",\n *   USERS: { ROOT: \"/users\", EDIT: \"/users/edit/:id\" },\n * } as const);\n *\n * getBreadcrumbs(PATHS, \"/users/edit/42\");\n * // → [\n * //     { key: \"HOME\",       label: \"Home\",  path: \"/\",             isCurrent: false },\n * //     { key: \"USERS.ROOT\", label: \"Users\", path: \"/users\",        isCurrent: false },\n * //     { key: \"USERS.EDIT\", label: \"Edit\",  path: \"/users/edit/42\", isCurrent: true  },\n * //   ]\n * ```\n */\nexport function getBreadcrumbs(\n  routes: Record<string, unknown> | FlatRoute[],\n  currentPath: string,\n  options?: BreadcrumbOptions,\n): BreadcrumbItem[] {\n  const flat = Array.isArray(routes) ? routes : flattenRoutes(routes);\n  const pathname = currentPath.split(\"?\")[0] ?? \"\";\n  const labelFn = options?.labelResolver ?? deriveBreadcrumbLabel;\n  const labels = options?.labels ?? {};\n\n  const items: Array<{\n    key: string;\n    resolvedPath: string;\n    template: string;\n    isCurrent: boolean;\n  }> = [];\n\n  for (const route of flat) {\n    const exactRe = matchPath(route.path);\n    const exactMatch = pathname.match(exactRe);\n\n    if (exactMatch) {\n      const params = extractParamsFromPath(route.path, exactMatch[0]);\n      const resolved = isDynamic(route.path)\n        ? buildPath(route.path, params)\n        : route.path;\n      items.push({\n        key: route.key,\n        resolvedPath: resolved,\n        template: route.path,\n        isCurrent: true,\n      });\n      continue;\n    }\n\n    const prefixRe = matchPrefix(route.path);\n    const prefixMatch = pathname.match(prefixRe);\n\n    if (prefixMatch) {\n      const matchedPortion = prefixMatch[0];\n      const params = extractParamsFromPath(route.path, matchedPortion);\n      const resolved = isDynamic(route.path)\n        ? buildPath(route.path, params)\n        : route.path;\n      items.push({\n        key: route.key,\n        resolvedPath: resolved,\n        template: route.path,\n        isCurrent: false,\n      });\n    }\n  }\n\n  // Sort by path depth (segment count), not raw string length — a shallow\n  // route with a long param name (e.g. \"/shop/:reallyLongSlugName\") must\n  // still sort before a deeper route with short segments (e.g.\n  // \"/shop/widgets/details\"), even though the latter has fewer characters.\n  const segmentCount = (t: string) => t.split(\"/\").filter(Boolean).length;\n  items.sort((a, b) => segmentCount(a.template) - segmentCount(b.template));\n\n  return items.map((item) => ({\n    key: item.key,\n    label: labels[item.key] ?? labelFn(item.key),\n    path: item.resolvedPath,\n    isCurrent: item.isCurrent,\n  }));\n}\n","import { devWarn, isProduction } from \"./environment\";\nimport { buildPath } from \"./build\";\nimport { extractParamNames, isDynamic } from \"./params\";\nimport { isActivePath } from \"./match\";\nimport { flattenRoutes } from \"./routes\";\nimport type {\n  BuildPathOptions,\n  ExtractParams,\n  PathParams,\n  QueryParams,\n  RoutePath,\n  RouteTree,\n} from \"../types\";\n\n// Re-export so consumers that import from 'core/defineRoutes' get the full surface\nexport { buildPath } from \"./build\";\nexport { extractParamNames, isDynamic } from \"./params\";\n\n/**\n * A dynamic route is a template string with a `:param` or trailing `/*` splat,\n * augmented with a `.build()` helper and a `.paramNames` array.\n *\n * Exported so consumers (e.g. the hooks entry) can type against it.\n */\nexport type StaticRoute<T extends string> = T & {\n  build(query?: QueryParams, options?: BuildPathOptions): RoutePath;\n};\n\nexport type DynamicRoute<T extends string> = T extends\n  | `${string}:${string}`\n  | `${string}/*`\n  ? T & {\n      build(\n        params: PathParams<T>,\n        query?: QueryParams,\n        options?: BuildPathOptions,\n      ): RoutePath;\n      paramNames: Array<ExtractParams<T>>;\n    }\n  : StaticRoute<T>;\n\ntype ResolvedRoutes<T extends RouteTree> = {\n  [K in keyof T]: T[K] extends RouteTree\n    ? ResolvedRoutes<T[K]>\n    : T[K] extends string\n      ? DynamicRoute<T[K]>\n      : never;\n};\n\nconst isRouteGroup = (value: unknown): value is RouteTree =>\n  typeof value === \"object\" &&\n  value !== null &&\n  !Array.isArray(value) &&\n  Object.getPrototypeOf(value) === Object.prototype;\n\n/**\n * Validate a single route template and warn (dev-only) about common mistakes:\n * missing leading `/` and non-trailing `*` splats.\n */\nfunction validateTemplate(template: string, key: string): void {\n  if (!template.startsWith(\"/\")) {\n    devWarn(\n      `[route-forge] Route \"${key}\" does not start with \"/\": \"${template}\".`,\n    );\n  }\n\n  if (template.includes(\"*\") && !template.endsWith(\"/*\")) {\n    devWarn(\n      `[route-forge] Route \"${key}\" uses \"*\" outside a trailing \"/*\" splat; only a trailing splat is supported: \"${template}\".`,\n    );\n  }\n}\n\n/**\n * Warn (dev-only) when two routes resolve to the same path template or shadow each other.\n */\nfunction detectDuplicatePaths(routes: Record<string, unknown>): void {\n  const seen = new Map<string, string>();\n  const warned = new Set<string>();\n  const flat = flattenRoutes(routes);\n\n  for (const route of flat) {\n    const existing = seen.get(route.path);\n    if (existing === undefined) {\n      seen.set(route.path, route.key);\n    } else if (!warned.has(route.path)) {\n      warned.add(route.path);\n      devWarn(\n        `[route-forge] Duplicate route path \"${route.path}\" for \"${existing}\" and \"${route.key}\". ` +\n          `Only one of them will be reachable.`,\n      );\n    }\n  }\n\n  // Shadowing check: warn when a static path matches a dynamic path defined before it\n  for (let i = 0; i < flat.length; i++) {\n    const r1 = flat[i]!;\n    if (!isDynamic(r1.path)) continue;\n\n    for (let j = i + 1; j < flat.length; j++) {\n      const r2 = flat[j]!;\n      if (isDynamic(r2.path)) continue;\n\n      if (isActivePath(r2.path, r1.path, { exact: true })) {\n        const pairKey = `${r1.key}->${r2.key}`;\n        if (!warned.has(pairKey)) {\n          warned.add(pairKey);\n          devWarn(\n            `[route-forge] Route \"${r2.key}\" (\"${r2.path}\") is shadowed by dynamic route \"${r1.key}\" (\"${r1.path}\"). Place static routes before dynamic parameters in route trees.`,\n          );\n        }\n      }\n    }\n  }\n}\n\n/**\n * Attach `.build()` (and, for dynamic templates, `.paramNames`) to\n * `String.prototype` exactly once, so route values can stay **genuine\n * primitive strings** instead of `new String(template)` objects.\n *\n * Route values used to be wrapped in `new String(template)` so `.build()`\n * could be attached as an own property. That silently broke direct use with\n * React Router's `<Link to={...}>` (and anything else that branches on\n * `typeof to === \"string\"`, e.g. React Router's internal `resolveTo()`):\n * `typeof` on a `String` object is `\"object\"`, not `\"string\"`, so React\n * Router treated the route value as a `Partial<Path>` and spread it\n * (`{ ...routeValue }`) instead of parsing it as a path — producing a\n * `pathname`-less destination and a broken/no-op navigation. `.build()`\n * happened to \"fix\" it only because it returns a plain string.\n *\n * Putting `.build()`/`.paramNames` on the prototype instead means every\n * primitive string route value can still call `.build()` / read\n * `.paramNames` (resolved lazily from `this`, the template text itself),\n * while `typeof route === \"string\"` stays true — so route values now work\n * directly anywhere a plain path string is expected, `<Link to={route}>`\n * included, with no `.build()` call required.\n */\nfunction installBuildProtocol(): void {\n  if (Object.prototype.hasOwnProperty.call(String.prototype, \"build\")) {\n    return;\n  }\n\n  Object.defineProperty(String.prototype, \"build\", {\n    value: function build(\n      this: string,\n      paramsOrQuery?: PathParams<string> | QueryParams,\n      query?: QueryParams,\n      options?: BuildPathOptions,\n    ): RoutePath {\n      const template = this.valueOf();\n\n      // Dynamic templates take (params, query?, options?); static templates\n      // take (query?, options?) — disambiguated from the template itself,\n      // since that's all the prototype method has to go on.\n      return (\n        isDynamic(template)\n          ? buildPath(\n              template,\n              (paramsOrQuery ?? {}) as PathParams<string>,\n              query,\n              options,\n            )\n          : buildPath(\n              template,\n              {},\n              paramsOrQuery as QueryParams,\n              query as unknown as BuildPathOptions,\n            )\n      ) as RoutePath;\n    },\n    writable: false,\n    enumerable: false,\n    configurable: true,\n  });\n\n  Object.defineProperty(String.prototype, \"paramNames\", {\n    get(this: string): string[] {\n      return extractParamNames(this.valueOf());\n    },\n    enumerable: false,\n    configurable: true,\n  });\n}\n\ninstallBuildProtocol();\n\nfunction wrapStaticPath<T extends string>(template: T): StaticRoute<T> {\n  // A genuine primitive string — `.build()` comes from String.prototype\n  // (see installBuildProtocol above), so `typeof` stays \"string\".\n  return template as StaticRoute<T>;\n}\n\nfunction wrapDynamicPath<T extends string>(template: T): DynamicRoute<T> {\n  // Same here: primitive string, `.build()` and `.paramNames` are resolved\n  // lazily from String.prototype based on the template text itself.\n  return template as unknown as DynamicRoute<T>;\n}\n\nfunction processRouteMap<T extends RouteTree>(routes: T): ResolvedRoutes<T> {\n  const result = {} as ResolvedRoutes<T>;\n\n  for (const key in routes) {\n    if (!Object.prototype.hasOwnProperty.call(routes, key)) continue;\n\n    const value = routes[key];\n\n    if (typeof value === \"string\") {\n      validateTemplate(value, key);\n      result[key] = (\n        isDynamic(value) ? wrapDynamicPath(value) : wrapStaticPath(value)\n      ) as ResolvedRoutes<T>[typeof key];\n    } else if (isRouteGroup(value)) {\n      result[key] = processRouteMap(\n        value as RouteTree,\n      ) as unknown as ResolvedRoutes<T>[typeof key];\n    }\n  }\n\n  return result;\n}\n\nexport function defineRoutes<T extends RouteTree>(\n  routes: T,\n): ResolvedRoutes<T> {\n  const result = processRouteMap(routes);\n  // detectDuplicatePaths only ever produces console.warn output (suppressed\n  // in production by devWarn), so skip the O(n^2) walk entirely in\n  // production rather than computing it and discarding the result.\n  if (!isProduction()) {\n    detectDuplicatePaths(result as unknown as Record<string, unknown>);\n  }\n  return result;\n}\n"],"mappings":"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","names":["index_exports","__export","appendQuery","build","buildPath","clearPathCache","defineRoutes","devWarn","extractParamNames","extractParamsFromPath","extractQueryFromPath","flattenRoutes","getBreadcrumbs","getParamNames","isActivePath","isDynamic","joinPaths","matchPath","__toCommonJS","isProduction","devWarn","message","ESCAPE_RE","PARAM_SEGMENT_RE","escapeRegex","value","createTemplatePattern","template","splat","base","pattern","cursor","match","start","token","boundary","optional","isOptionalParam","name","PREFIX_CACHE","ROOT_PREFIX_RE","matchPrefix","cached","re","safeDecode","PATH_CACHE","matchPath","options","end","flags","cacheKey","basePattern","clearPathCache","extractParamNames","template","names","PARAM_SEGMENT_RE","match","isDynamic","path","getParamNames","extractParamsFromPath","resolvedPath","pathWithoutSearch","paramNames","matchPath","result","name","index","raw","safeDecode","appendQuery","path","query","hash","hashIdx","base","existingHash","searchParams","key","value","v","result","queryString","extractQueryFromPath","options","noHash","queryIdx","params","parsed","buildPath","template","params","query","options","paramNames","extractParamNames","unresolved","name","isOptionalParam","resolved","path","value","missing","encoded","segment","re","escapeRegex","match","boundary","p","devWarn","appendQuery","build","joinPaths","segments","isActivePath","currentPath","template","options","exact","caseSensitive","pathname","normalizedTemplate","target","candidate","matchPath","matchPrefix","flattenRoutes","routes","prefix","entries","key","fullKey","value","deriveBreadcrumbLabel","parts","last","c","getBreadcrumbs","currentPath","options","flat","pathname","labelFn","labels","items","route","exactRe","matchPath","exactMatch","params","extractParamsFromPath","resolved","isDynamic","buildPath","prefixRe","matchPrefix","prefixMatch","matchedPortion","segmentCount","t","a","b","item","isRouteGroup","value","validateTemplate","template","key","devWarn","detectDuplicatePaths","routes","seen","warned","flat","flattenRoutes","route","existing","i","r1","isDynamic","j","r2","isActivePath","pairKey","installBuildProtocol","paramsOrQuery","query","options","buildPath","extractParamNames","processRouteMap","routes","result","key","value","validateTemplate","isDynamic","isRouteGroup","defineRoutes","isProduction","detectDuplicatePaths"]}

package/dist/index.d.cts

@@ -1,17 +1,96 @@
-import { Q as QueryParams, R as RouteParams, B as BuildPathOptions, F as FlatRoute, a as BreadcrumbOptions, b as BreadcrumbItem, P as PathParams, c as RoutePath, E as ExtractParams, d as RouteTree } from './index-Beg7xp8k.cjs';
-export { M as MatchPathOptions, e as RouteBuilder, f as RouteLeaf, g as RouteMap, h as RouteParam } from './index-Beg7xp8k.cjs';
+import { R as RouteParams, Q as QueryParams, B as BuildPathOptions, P as PathParams, a as RoutePath, E as ExtractParams, b as RouteTree, F as FlatRoute, c as BreadcrumbOptions, d as BreadcrumbItem } from './index-CRAdjXCI.cjs';
+export { M as MatchPathOptions, e as RouteBuilder, f as RouteLeaf, g as RouteMap, h as RouteParam } from './index-CRAdjXCI.cjs';
 
 /**
- * Emits a `console.warn` in non-production environments.
- * Shared by the core utilities and `defineRoutes()` so the production check
- * lives in one place.
+ * Resolve a route template against a params object, appending an optional
+ * query string and hash fragment.
+ *
+ * Missing required params are left as their `:name` placeholder and a
+ * `console.warn` is emitted — pass `{ strict: true }` to throw a `RangeError`
+ * instead. Optional (`:param?`) segments are dropped entirely when missing;
+ * a missing splat just drops the trailing `/*`. Values are URL-encoded by
+ * default (`{ encode: false }` opts out).
  */
-declare function devWarn(message: string): void;
+declare function buildPath(template: string, params: RouteParams, query?: QueryParams, options?: BuildPathOptions): string;
+/**
+ * Standalone alias of {@link buildPath} — resolves a template against params.
+ */
+declare function build(template: string, params: RouteParams, query?: QueryParams, options?: BuildPathOptions): string;
+/**
+ * Join URL path segments into a single slash-prefixed path, normalising
+ * duplicate slashes.
+ *
+ * @example
+ * joinPaths("/api/", "/v1/", "users"); // → "/api/v1/users"
+ */
+declare function joinPaths(...segments: string[]): string;
+
+/**
+ * Extract the `:param` names from a route template.
+ *
+ * A param is only recognized at the start of a segment (see
+ * {@link PARAM_SEGMENT_RE}), so literal colons (`/users/foo:bar`) and static
+ * suffixes after a param (`/files/:name.json`) are not treated as params.
+ * A trailing splat (`/*`) is reported as the `"*"` name.
+ */
+declare function extractParamNames(template: string): string[];
+/** Returns `true` when the template contains a `:param` or trailing `/*` splat. */
+declare function isDynamic(path: string): boolean;
+/**
+ * Alias of {@link extractParamNames} — kept for backwards compatibility.
+ */
+declare function getParamNames(template: string): string[];
+/**
+ * Extract the param values matched by `template` from a resolved path.
+ *
+ * The query string is stripped before matching, so `/users/42?tab=profile`
+ * still yields `{ id: "42" }`. Values are URL-decoded back to their original
+ * form; a non-matching path yields an empty object.
+ */
+declare function extractParamsFromPath(template: string, resolvedPath: string): Record<string, string>;
+
+/**
+ * A dynamic route is a template string with a `:param` or trailing `/*` splat,
+ * augmented with a `.build()` helper and a `.paramNames` array.
+ *
+ * Exported so consumers (e.g. the hooks entry) can type against it.
+ */
+type StaticRoute<T extends string> = T & {
+    build(query?: QueryParams, options?: BuildPathOptions): RoutePath;
+};
+type DynamicRoute<T extends string> = T extends `${string}:${string}` | `${string}/*` ? T & {
+    build(params: PathParams<T>, query?: QueryParams, options?: BuildPathOptions): RoutePath;
+    paramNames: Array<ExtractParams<T>>;
+} : StaticRoute<T>;
+type ResolvedRoutes<T extends RouteTree> = {
+    [K in keyof T]: T[K] extends RouteTree ? ResolvedRoutes<T[K]> : T[K] extends string ? DynamicRoute<T[K]> : never;
+};
+declare function defineRoutes<T extends RouteTree>(routes: T): ResolvedRoutes<T>;
+
+/**
+ * Test whether `currentPath` matches `template`, mirroring React Router's
+ * `NavLink` matching semantics:
+ *
+ * - Case-insensitive by default (pass `caseSensitive: true` to opt out).
+ * - Trailing slashes are tolerated (`/users/` matches `/users`).
+ * - `exact: true` (the default) requires a full match; `exact: false`
+ *   matches any path that starts with the template.
+ */
+declare function isActivePath(currentPath: string, template: string, options?: {
+    exact?: boolean;
+    caseSensitive?: boolean;
+}): boolean;
+
+declare function matchPath(template: string, options?: {
+    end?: boolean;
+    caseSensitive?: boolean;
+}): RegExp;
 /**
  * Clears internal regex cache maps (PREFIX_CACHE and PATH_CACHE).
  * Useful in test suites to prevent cached patterns from leaking across test cases.
  */
 declare function clearPathCache(): void;
+
 /**
  * Append a query string and/or hash fragment to a path that may already
  * contain a query or hash.
@@ -46,30 +125,7 @@ declare function extractQueryFromPath(path: string, options?: {
     coerceBooleans?: boolean;
     coerceNumbers?: boolean;
 }): QueryParams;
-declare function buildPath(template: string, params: RouteParams, query?: QueryParams, options?: BuildPathOptions): string;
-declare function extractParamNames(template: string): string[];
-declare function isDynamic(path: string): boolean;
-/**
- * Test whether `currentPath` matches `template`, mirroring React Router's
- * `NavLink` matching semantics:
- *
- * - Case-insensitive by default (pass `caseSensitive: true` to opt out).
- * - Trailing slashes are tolerated (`/users/` matches `/users`).
- * - `exact: true` (the default) requires a full match; `exact: false`
- *   matches any path that starts with the template.
- */
-declare function isActivePath(currentPath: string, template: string, options?: {
-    exact?: boolean;
-    caseSensitive?: boolean;
-}): boolean;
-declare function extractParamsFromPath(template: string, resolvedPath: string): Record<string, string>;
-declare function joinPaths(...segments: string[]): string;
-declare function build(template: string, params: RouteParams, query?: QueryParams, options?: BuildPathOptions): string;
-declare function getParamNames(template: string): string[];
-declare function matchPath(template: string, options?: {
-    end?: boolean;
-    caseSensitive?: boolean;
-}): RegExp;
+
 /**
  * Walk a `defineRoutes` output tree and return a flat array of
  * `{ key, path }` entries where `key` is the dot-joined key path from
@@ -122,21 +178,10 @@ declare function flattenRoutes(routes: Record<string, unknown>, prefix?: string)
 declare function getBreadcrumbs(routes: Record<string, unknown> | FlatRoute[], currentPath: string, options?: BreadcrumbOptions): BreadcrumbItem[];
 
 /**
- * A dynamic route is a template string with a `:param` or trailing `/*` splat,
- * augmented with a `.build()` helper and a `.paramNames` array.
- *
- * Exported so consumers (e.g. the hooks entry) can type against it.
+ * Emits a `console.warn` in non-production environments.
+ * Shared by the core utilities and `defineRoutes()` so the production check
+ * lives in one place.
  */
-type StaticRoute<T extends string> = T & {
-    build(query?: QueryParams, options?: BuildPathOptions): RoutePath;
-};
-type DynamicRoute<T extends string> = T extends `${string}:${string}` | `${string}/*` ? T & {
-    build(params: PathParams<T>, query?: QueryParams, options?: BuildPathOptions): RoutePath;
-    paramNames: Array<ExtractParams<T>>;
-} : StaticRoute<T>;
-type ResolvedRoutes<T extends RouteTree> = {
-    [K in keyof T]: T[K] extends RouteTree ? ResolvedRoutes<T[K]> : T[K] extends string ? DynamicRoute<T[K]> : never;
-};
-declare function defineRoutes<T extends RouteTree>(routes: T): ResolvedRoutes<T>;
+declare function devWarn(message: string): void;
 
 export { BreadcrumbItem, BreadcrumbOptions, BuildPathOptions, type DynamicRoute, ExtractParams, FlatRoute, PathParams, QueryParams, RouteParams, RoutePath, RouteTree, type StaticRoute, appendQuery, build, buildPath, clearPathCache, defineRoutes, devWarn, extractParamNames, extractParamsFromPath, extractQueryFromPath, flattenRoutes, getBreadcrumbs, getParamNames, isActivePath, isDynamic, joinPaths, matchPath };

package/dist/index.d.ts

@@ -1,17 +1,96 @@
-import { Q as QueryParams, R as RouteParams, B as BuildPathOptions, F as FlatRoute, a as BreadcrumbOptions, b as BreadcrumbItem, P as PathParams, c as RoutePath, E as ExtractParams, d as RouteTree } from './index-Beg7xp8k.js';
-export { M as MatchPathOptions, e as RouteBuilder, f as RouteLeaf, g as RouteMap, h as RouteParam } from './index-Beg7xp8k.js';
+import { R as RouteParams, Q as QueryParams, B as BuildPathOptions, P as PathParams, a as RoutePath, E as ExtractParams, b as RouteTree, F as FlatRoute, c as BreadcrumbOptions, d as BreadcrumbItem } from './index-CRAdjXCI.js';
+export { M as MatchPathOptions, e as RouteBuilder, f as RouteLeaf, g as RouteMap, h as RouteParam } from './index-CRAdjXCI.js';
 
 /**
- * Emits a `console.warn` in non-production environments.
- * Shared by the core utilities and `defineRoutes()` so the production check
- * lives in one place.
+ * Resolve a route template against a params object, appending an optional
+ * query string and hash fragment.
+ *
+ * Missing required params are left as their `:name` placeholder and a
+ * `console.warn` is emitted — pass `{ strict: true }` to throw a `RangeError`
+ * instead. Optional (`:param?`) segments are dropped entirely when missing;
+ * a missing splat just drops the trailing `/*`. Values are URL-encoded by
+ * default (`{ encode: false }` opts out).
  */
-declare function devWarn(message: string): void;
+declare function buildPath(template: string, params: RouteParams, query?: QueryParams, options?: BuildPathOptions): string;
+/**
+ * Standalone alias of {@link buildPath} — resolves a template against params.
+ */
+declare function build(template: string, params: RouteParams, query?: QueryParams, options?: BuildPathOptions): string;
+/**
+ * Join URL path segments into a single slash-prefixed path, normalising
+ * duplicate slashes.
+ *
+ * @example
+ * joinPaths("/api/", "/v1/", "users"); // → "/api/v1/users"
+ */
+declare function joinPaths(...segments: string[]): string;
+
+/**
+ * Extract the `:param` names from a route template.
+ *
+ * A param is only recognized at the start of a segment (see
+ * {@link PARAM_SEGMENT_RE}), so literal colons (`/users/foo:bar`) and static
+ * suffixes after a param (`/files/:name.json`) are not treated as params.
+ * A trailing splat (`/*`) is reported as the `"*"` name.
+ */
+declare function extractParamNames(template: string): string[];
+/** Returns `true` when the template contains a `:param` or trailing `/*` splat. */
+declare function isDynamic(path: string): boolean;
+/**
+ * Alias of {@link extractParamNames} — kept for backwards compatibility.
+ */
+declare function getParamNames(template: string): string[];
+/**
+ * Extract the param values matched by `template` from a resolved path.
+ *
+ * The query string is stripped before matching, so `/users/42?tab=profile`
+ * still yields `{ id: "42" }`. Values are URL-decoded back to their original
+ * form; a non-matching path yields an empty object.
+ */
+declare function extractParamsFromPath(template: string, resolvedPath: string): Record<string, string>;
+
+/**
+ * A dynamic route is a template string with a `:param` or trailing `/*` splat,
+ * augmented with a `.build()` helper and a `.paramNames` array.
+ *
+ * Exported so consumers (e.g. the hooks entry) can type against it.
+ */
+type StaticRoute<T extends string> = T & {
+    build(query?: QueryParams, options?: BuildPathOptions): RoutePath;
+};
+type DynamicRoute<T extends string> = T extends `${string}:${string}` | `${string}/*` ? T & {
+    build(params: PathParams<T>, query?: QueryParams, options?: BuildPathOptions): RoutePath;
+    paramNames: Array<ExtractParams<T>>;
+} : StaticRoute<T>;
+type ResolvedRoutes<T extends RouteTree> = {
+    [K in keyof T]: T[K] extends RouteTree ? ResolvedRoutes<T[K]> : T[K] extends string ? DynamicRoute<T[K]> : never;
+};
+declare function defineRoutes<T extends RouteTree>(routes: T): ResolvedRoutes<T>;
+
+/**
+ * Test whether `currentPath` matches `template`, mirroring React Router's
+ * `NavLink` matching semantics:
+ *
+ * - Case-insensitive by default (pass `caseSensitive: true` to opt out).
+ * - Trailing slashes are tolerated (`/users/` matches `/users`).
+ * - `exact: true` (the default) requires a full match; `exact: false`
+ *   matches any path that starts with the template.
+ */
+declare function isActivePath(currentPath: string, template: string, options?: {
+    exact?: boolean;
+    caseSensitive?: boolean;
+}): boolean;
+
+declare function matchPath(template: string, options?: {
+    end?: boolean;
+    caseSensitive?: boolean;
+}): RegExp;
 /**
  * Clears internal regex cache maps (PREFIX_CACHE and PATH_CACHE).
  * Useful in test suites to prevent cached patterns from leaking across test cases.
  */
 declare function clearPathCache(): void;
+
 /**
  * Append a query string and/or hash fragment to a path that may already
  * contain a query or hash.
@@ -46,30 +125,7 @@ declare function extractQueryFromPath(path: string, options?: {
     coerceBooleans?: boolean;
     coerceNumbers?: boolean;
 }): QueryParams;
-declare function buildPath(template: string, params: RouteParams, query?: QueryParams, options?: BuildPathOptions): string;
-declare function extractParamNames(template: string): string[];
-declare function isDynamic(path: string): boolean;
-/**
- * Test whether `currentPath` matches `template`, mirroring React Router's
- * `NavLink` matching semantics:
- *
- * - Case-insensitive by default (pass `caseSensitive: true` to opt out).
- * - Trailing slashes are tolerated (`/users/` matches `/users`).
- * - `exact: true` (the default) requires a full match; `exact: false`
- *   matches any path that starts with the template.
- */
-declare function isActivePath(currentPath: string, template: string, options?: {
-    exact?: boolean;
-    caseSensitive?: boolean;
-}): boolean;
-declare function extractParamsFromPath(template: string, resolvedPath: string): Record<string, string>;
-declare function joinPaths(...segments: string[]): string;
-declare function build(template: string, params: RouteParams, query?: QueryParams, options?: BuildPathOptions): string;
-declare function getParamNames(template: string): string[];
-declare function matchPath(template: string, options?: {
-    end?: boolean;
-    caseSensitive?: boolean;
-}): RegExp;
+
 /**
  * Walk a `defineRoutes` output tree and return a flat array of
  * `{ key, path }` entries where `key` is the dot-joined key path from
@@ -122,21 +178,10 @@ declare function flattenRoutes(routes: Record<string, unknown>, prefix?: string)
 declare function getBreadcrumbs(routes: Record<string, unknown> | FlatRoute[], currentPath: string, options?: BreadcrumbOptions): BreadcrumbItem[];
 
 /**
- * A dynamic route is a template string with a `:param` or trailing `/*` splat,
- * augmented with a `.build()` helper and a `.paramNames` array.
- *
- * Exported so consumers (e.g. the hooks entry) can type against it.
+ * Emits a `console.warn` in non-production environments.
+ * Shared by the core utilities and `defineRoutes()` so the production check
+ * lives in one place.
  */
-type StaticRoute<T extends string> = T & {
-    build(query?: QueryParams, options?: BuildPathOptions): RoutePath;
-};
-type DynamicRoute<T extends string> = T extends `${string}:${string}` | `${string}/*` ? T & {
-    build(params: PathParams<T>, query?: QueryParams, options?: BuildPathOptions): RoutePath;
-    paramNames: Array<ExtractParams<T>>;
-} : StaticRoute<T>;
-type ResolvedRoutes<T extends RouteTree> = {
-    [K in keyof T]: T[K] extends RouteTree ? ResolvedRoutes<T[K]> : T[K] extends string ? DynamicRoute<T[K]> : never;
-};
-declare function defineRoutes<T extends RouteTree>(routes: T): ResolvedRoutes<T>;
+declare function devWarn(message: string): void;
 
 export { BreadcrumbItem, BreadcrumbOptions, BuildPathOptions, type DynamicRoute, ExtractParams, FlatRoute, PathParams, QueryParams, RouteParams, RoutePath, RouteTree, type StaticRoute, appendQuery, build, buildPath, clearPathCache, defineRoutes, devWarn, extractParamNames, extractParamsFromPath, extractQueryFromPath, flattenRoutes, getBreadcrumbs, getParamNames, isActivePath, isDynamic, joinPaths, matchPath };

package/dist/index.js

@@ -1,2 +1,2 @@
-import{a as n,b as R,c as f,d as l,e as c,f as d,g as u,h as m,i as T,j as g,k as x,l as w,m as b,n as P,o as k}from"./chunk-EFHUAXKE.js";var O=t=>typeof t=="object"&&t!==null&&!Array.isArray(t)&&Object.getPrototypeOf(t)===Object.prototype;function $(t,e){t.startsWith("/")||n(`[route-forge] Route "${e}" does not start with "/": "${t}".`),t.includes("*")&&!t.endsWith("/*")&&n(`[route-forge] Route "${e}" uses "*" outside a trailing "/*" splat; only a trailing splat is supported: "${t}".`)}function v(t){let e=new Map,o=new Set,a=P(t);for(let r of a){let s=e.get(r.path);s===void 0?e.set(r.path,r.key):o.has(r.path)||(o.add(r.path),n(`[route-forge] Duplicate route path "${r.path}" for "${s}" and "${r.key}". Only one of them will be reachable.`))}for(let r=0;r<a.length;r++){let s=a[r];if(u(s.path))for(let p=r+1;p<a.length;p++){let i=a[p];if(!u(i.path)&&m(i.path,s.path,{exact:!0})){let h=`${s.key}->${i.key}`;o.has(h)||(o.add(h),n(`[route-forge] Route "${i.key}" ("${i.path}") is shadowed by dynamic route "${s.key}" ("${s.path}"). Place static routes before dynamic parameters in route trees.`))}}}}function B(t){let e=new String(t);return e.build=(o,a)=>c(t,{},o,a),e}function D(t){let e=d(t),o=new String(t);return o.build=(a,r,s)=>c(t,a,r,s),o.paramNames=e,o}function y(t){let e={};for(let o in t){if(!Object.prototype.hasOwnProperty.call(t,o))continue;let a=t[o];typeof a=="string"?($(a,o),e[o]=u(a)?D(a):B(a)):O(a)&&(e[o]=y(a))}return e}function Q(t){let e=y(t);return v(e),e}export{f as appendQuery,x as build,c as buildPath,R as clearPathCache,Q as defineRoutes,n as devWarn,d as extractParamNames,T as extractParamsFromPath,l as extractQueryFromPath,P as flattenRoutes,k as getBreadcrumbs,w as getParamNames,m as isActivePath,u as isDynamic,g as joinPaths,b as matchPath};
+import{a as k,b as c,c as v,d as R,e as $,f as g,g as u,h as D,i as h,j,k as S,l as p,m as C,n as F,o as b}from"./chunk-IP4ZU25B.js";function f(t,e=""){let a=[];for(let s of Object.keys(t)){let r=e?`${e}.${s}`:s,n=t[s];typeof n=="string"?a.push({key:r,path:n}):n instanceof String?a.push({key:r,path:n.valueOf()}):typeof n=="object"&&n!==null&&a.push(...f(n,r))}return a}function A(t){let e=t.split("."),a=e[e.length-1]??t;return(a==="ROOT"&&e.length>1?e[e.length-2]:a).replace(/_/g," ").toLowerCase().replace(/^\w/,r=>r.toUpperCase())}function Q(t,e,a){let s=Array.isArray(t)?t:f(t),r=e.split("?")[0]??"",n=a?.labelResolver??A,l=a?.labels??{},i=[];for(let o of s){let d=R(o.path),x=r.match(d);if(x){let y=h(o.path,x[0]),P=u(o.path)?p(o.path,y):o.path;i.push({key:o.key,resolvedPath:P,template:o.path,isCurrent:!0});continue}let O=v(o.path),T=r.match(O);if(T){let y=T[0],P=h(o.path,y),B=u(o.path)?p(o.path,P):o.path;i.push({key:o.key,resolvedPath:B,template:o.path,isCurrent:!1})}}let m=o=>o.split("/").filter(Boolean).length;return i.sort((o,d)=>m(o.template)-m(d.template)),i.map(o=>({key:o.key,label:l[o.key]??n(o.key),path:o.resolvedPath,isCurrent:o.isCurrent}))}var K=t=>typeof t=="object"&&t!==null&&!Array.isArray(t)&&Object.getPrototypeOf(t)===Object.prototype;function M(t,e){t.startsWith("/")||c(`[route-forge] Route "${e}" does not start with "/": "${t}".`),t.includes("*")&&!t.endsWith("/*")&&c(`[route-forge] Route "${e}" uses "*" outside a trailing "/*" splat; only a trailing splat is supported: "${t}".`)}function N(t){let e=new Map,a=new Set,s=f(t);for(let r of s){let n=e.get(r.path);n===void 0?e.set(r.path,r.key):a.has(r.path)||(a.add(r.path),c(`[route-forge] Duplicate route path "${r.path}" for "${n}" and "${r.key}". Only one of them will be reachable.`))}for(let r=0;r<s.length;r++){let n=s[r];if(u(n.path))for(let l=r+1;l<s.length;l++){let i=s[l];if(!u(i.path)&&b(i.path,n.path,{exact:!0})){let m=`${n.key}->${i.key}`;a.has(m)||(a.add(m),c(`[route-forge] Route "${i.key}" ("${i.path}") is shadowed by dynamic route "${n.key}" ("${n.path}"). Place static routes before dynamic parameters in route trees.`))}}}}function W(){Object.prototype.hasOwnProperty.call(String.prototype,"build")||(Object.defineProperty(String.prototype,"build",{value:function(e,a,s){let r=this.valueOf();return u(r)?p(r,e??{},a,s):p(r,{},e,a)},writable:!1,enumerable:!1,configurable:!0}),Object.defineProperty(String.prototype,"paramNames",{get(){return g(this.valueOf())},enumerable:!1,configurable:!0}))}W();function w(t){let e={};for(let a in t){if(!Object.prototype.hasOwnProperty.call(t,a))continue;let s=t[a];typeof s=="string"?(M(s,a),e[a]=u(s)?s:s):K(s)&&(e[a]=w(s))}return e}function E(t){let e=w(t);return k()||N(e),e}export{j as appendQuery,C as build,p as buildPath,$ as clearPathCache,E as defineRoutes,c as devWarn,g as extractParamNames,h as extractParamsFromPath,S as extractQueryFromPath,f as flattenRoutes,Q as getBreadcrumbs,D as getParamNames,b as isActivePath,u as isDynamic,F as joinPaths,R as matchPath};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/defineRoutes.ts"],"sourcesContent":["import {\n  buildPath,\n  devWarn,\n  extractParamNames,\n  flattenRoutes,\n  isActivePath,\n  isDynamic,\n} from \"./utils\";\nimport type {\n  BuildPathOptions,\n  ExtractParams,\n  PathParams,\n  QueryParams,\n  RoutePath,\n  RouteTree,\n} from \"../types\";\n\n// Re-export so consumers that import from 'core/defineRoutes' get the full surface\nexport { buildPath, extractParamNames, isDynamic } from \"./utils\";\n\n/**\n * A dynamic route is a template string with a `:param` or trailing `/*` splat,\n * augmented with a `.build()` helper and a `.paramNames` array.\n *\n * Exported so consumers (e.g. the hooks entry) can type against it.\n */\nexport type StaticRoute<T extends string> = T & {\n  build(query?: QueryParams, options?: BuildPathOptions): RoutePath;\n};\n\nexport type DynamicRoute<T extends string> =\n  T extends `${string}:${string}` | `${string}/*`\n    ? T & {\n        build(params: PathParams<T>, query?: QueryParams, options?: BuildPathOptions): RoutePath;\n        paramNames: Array<ExtractParams<T>>;\n      }\n    : StaticRoute<T>;\n\ntype ResolvedRoutes<T extends RouteTree> = {\n  [K in keyof T]: T[K] extends RouteTree\n    ? ResolvedRoutes<T[K]>\n    : T[K] extends string\n      ? DynamicRoute<T[K]>\n      : never;\n};\n\nconst isRouteGroup = (value: unknown): value is RouteTree =>\n  typeof value === \"object\" &&\n  value !== null &&\n  !Array.isArray(value) &&\n  Object.getPrototypeOf(value) === Object.prototype;\n\n/**\n * Validate a single route template and warn (dev-only) about common mistakes:\n * missing leading `/` and non-trailing `*` splats.\n */\nfunction validateTemplate(template: string, key: string): void {\n  if (!template.startsWith(\"/\")) {\n    devWarn(\n      `[route-forge] Route \"${key}\" does not start with \"/\": \"${template}\".`,\n    );\n  }\n\n  if (template.includes(\"*\") && !template.endsWith(\"/*\")) {\n    devWarn(\n      `[route-forge] Route \"${key}\" uses \"*\" outside a trailing \"/*\" splat; only a trailing splat is supported: \"${template}\".`,\n    );\n  }\n}\n\n/**\n * Warn (dev-only) when two routes resolve to the same path template or shadow each other.\n */\nfunction detectDuplicatePaths(routes: Record<string, unknown>): void {\n  const seen = new Map<string, string>();\n  const warned = new Set<string>();\n  const flat = flattenRoutes(routes);\n\n  for (const route of flat) {\n    const existing = seen.get(route.path);\n    if (existing === undefined) {\n      seen.set(route.path, route.key);\n    } else if (!warned.has(route.path)) {\n      warned.add(route.path);\n      devWarn(\n        `[route-forge] Duplicate route path \"${route.path}\" for \"${existing}\" and \"${route.key}\". ` +\n          `Only one of them will be reachable.`,\n      );\n    }\n  }\n\n  // Shadowing check: warn when a static path matches a dynamic path defined before it\n  for (let i = 0; i < flat.length; i++) {\n    const r1 = flat[i]!;\n    if (!isDynamic(r1.path)) continue;\n\n    for (let j = i + 1; j < flat.length; j++) {\n      const r2 = flat[j]!;\n      if (isDynamic(r2.path)) continue;\n\n      if (isActivePath(r2.path, r1.path, { exact: true })) {\n        const pairKey = `${r1.key}->${r2.key}`;\n        if (!warned.has(pairKey)) {\n          warned.add(pairKey);\n          devWarn(\n            `[route-forge] Route \"${r2.key}\" (\"${r2.path}\") is shadowed by dynamic route \"${r1.key}\" (\"${r1.path}\"). Place static routes before dynamic parameters in route trees.`,\n          );\n        }\n      }\n    }\n  }\n}\n\nfunction wrapStaticPath<T extends string>(template: T): StaticRoute<T> {\n  const wrapped = new String(template) as unknown as StaticRoute<T> & {\n    build: (query?: QueryParams, options?: BuildPathOptions) => RoutePath;\n  };\n  wrapped.build = (query?: QueryParams, options?: BuildPathOptions) =>\n    buildPath(template, {}, query, options) as RoutePath;\n\n  return wrapped as unknown as StaticRoute<T>;\n}\n\nfunction wrapDynamicPath<T extends string>(template: T): DynamicRoute<T> {\n  const paramNames = extractParamNames(template);\n  const wrapped = new String(template) as unknown as DynamicRoute<T> & {\n    build: (params: PathParams<T>, query?: QueryParams, options?: BuildPathOptions) => RoutePath;\n    paramNames: Array<ExtractParams<T>>;\n  };\n\n  wrapped.build = (params: PathParams<T>, query?: QueryParams, options?: BuildPathOptions) =>\n    buildPath(template, params, query, options) as RoutePath;\n  wrapped.paramNames = paramNames as Array<ExtractParams<T>>;\n\n  return wrapped as unknown as DynamicRoute<T>;\n}\n\nfunction processRouteMap<T extends RouteTree>(routes: T): ResolvedRoutes<T> {\n  const result = {} as ResolvedRoutes<T>;\n\n  for (const key in routes) {\n    if (!Object.prototype.hasOwnProperty.call(routes, key)) continue;\n\n    const value = routes[key];\n\n    if (typeof value === \"string\") {\n      validateTemplate(value, key);\n      result[key] = (\n        isDynamic(value) ? wrapDynamicPath(value) : wrapStaticPath(value)\n      ) as ResolvedRoutes<T>[typeof key];\n    } else if (isRouteGroup(value)) {\n      result[key] = processRouteMap(\n        value as RouteTree,\n      ) as unknown as ResolvedRoutes<T>[typeof key];\n    }\n  }\n\n  return result;\n}\n\nexport function defineRoutes<T extends RouteTree>(\n  routes: T,\n): ResolvedRoutes<T> {\n  const result = processRouteMap(routes);\n  detectDuplicatePaths(result as unknown as Record<string, unknown>);\n  return result;\n}\n"],"mappings":"0IA8CA,IAAMA,EAAgBC,GACpB,OAAOA,GAAU,UACjBA,IAAU,MACV,CAAC,MAAM,QAAQA,CAAK,GACpB,OAAO,eAAeA,CAAK,IAAM,OAAO,UAM1C,SAASC,EAAiBC,EAAkBC,EAAmB,CACxDD,EAAS,WAAW,GAAG,GAC1BE,EACE,wBAAwBD,CAAG,+BAA+BD,CAAQ,IACpE,EAGEA,EAAS,SAAS,GAAG,GAAK,CAACA,EAAS,SAAS,IAAI,GACnDE,EACE,wBAAwBD,CAAG,kFAAkFD,CAAQ,IACvH,CAEJ,CAKA,SAASG,EAAqBC,EAAuC,CACnE,IAAMC,EAAO,IAAI,IACXC,EAAS,IAAI,IACbC,EAAOC,EAAcJ,CAAM,EAEjC,QAAWK,KAASF,EAAM,CACxB,IAAMG,EAAWL,EAAK,IAAII,EAAM,IAAI,EAChCC,IAAa,OACfL,EAAK,IAAII,EAAM,KAAMA,EAAM,GAAG,EACpBH,EAAO,IAAIG,EAAM,IAAI,IAC/BH,EAAO,IAAIG,EAAM,IAAI,EACrBP,EACE,uCAAuCO,EAAM,IAAI,UAAUC,CAAQ,UAAUD,EAAM,GAAG,wCAExF,EAEJ,CAGA,QAASE,EAAI,EAAGA,EAAIJ,EAAK,OAAQI,IAAK,CACpC,IAAMC,EAAKL,EAAKI,CAAC,EACjB,GAAKE,EAAUD,EAAG,IAAI,EAEtB,QAASE,EAAIH,EAAI,EAAGG,EAAIP,EAAK,OAAQO,IAAK,CACxC,IAAMC,EAAKR,EAAKO,CAAC,EACjB,GAAI,CAAAD,EAAUE,EAAG,IAAI,GAEjBC,EAAaD,EAAG,KAAMH,EAAG,KAAM,CAAE,MAAO,EAAK,CAAC,EAAG,CACnD,IAAMK,EAAU,GAAGL,EAAG,GAAG,KAAKG,EAAG,GAAG,GAC/BT,EAAO,IAAIW,CAAO,IACrBX,EAAO,IAAIW,CAAO,EAClBf,EACE,wBAAwBa,EAAG,GAAG,OAAOA,EAAG,IAAI,oCAAoCH,EAAG,GAAG,OAAOA,EAAG,IAAI,mEACtG,EAEJ,CACF,CACF,CACF,CAEA,SAASM,EAAiClB,EAA6B,CACrE,IAAMmB,EAAU,IAAI,OAAOnB,CAAQ,EAGnC,OAAAmB,EAAQ,MAAQ,CAACC,EAAqBC,IACpCC,EAAUtB,EAAU,CAAC,EAAGoB,EAAOC,CAAO,EAEjCF,CACT,CAEA,SAASI,EAAkCvB,EAA8B,CACvE,IAAMwB,EAAaC,EAAkBzB,CAAQ,EACvCmB,EAAU,IAAI,OAAOnB,CAAQ,EAKnC,OAAAmB,EAAQ,MAAQ,CAACO,EAAuBN,EAAqBC,IAC3DC,EAAUtB,EAAU0B,EAAQN,EAAOC,CAAO,EAC5CF,EAAQ,WAAaK,EAEdL,CACT,CAEA,SAASQ,EAAqCvB,EAA8B,CAC1E,IAAMwB,EAAS,CAAC,EAEhB,QAAW3B,KAAOG,EAAQ,CACxB,GAAI,CAAC,OAAO,UAAU,eAAe,KAAKA,EAAQH,CAAG,EAAG,SAExD,IAAMH,EAAQM,EAAOH,CAAG,EAEpB,OAAOH,GAAU,UACnBC,EAAiBD,EAAOG,CAAG,EAC3B2B,EAAO3B,CAAG,EACRY,EAAUf,CAAK,EAAIyB,EAAgBzB,CAAK,EAAIoB,EAAepB,CAAK,GAEzDD,EAAaC,CAAK,IAC3B8B,EAAO3B,CAAG,EAAI0B,EACZ7B,CACF,EAEJ,CAEA,OAAO8B,CACT,CAEO,SAASC,EACdzB,EACmB,CACnB,IAAMwB,EAASD,EAAgBvB,CAAM,EACrC,OAAAD,EAAqByB,CAA4C,EAC1DA,CACT","names":["isRouteGroup","value","validateTemplate","template","key","devWarn","detectDuplicatePaths","routes","seen","warned","flat","flattenRoutes","route","existing","i","r1","isDynamic","j","r2","isActivePath","pairKey","wrapStaticPath","wrapped","query","options","buildPath","wrapDynamicPath","paramNames","extractParamNames","params","processRouteMap","result","defineRoutes"]}
+{"version":3,"sources":["../src/core/routes.ts","../src/core/defineRoutes.ts"],"sourcesContent":["import { matchPath, matchPrefix } from \"./pattern\";\nimport { extractParamsFromPath, isDynamic } from \"./params\";\nimport { buildPath } from \"./build\";\nimport type {\n  BreadcrumbItem,\n  BreadcrumbOptions,\n  FlatRoute,\n} from \"../types\";\n\n/**\n * Walk a `defineRoutes` output tree and return a flat array of\n * `{ key, path }` entries where `key` is the dot-joined key path from\n * the root (e.g. `\"SERVICES.BCC.EDIT\"`) and `path` is the raw template\n * string (e.g. `\"/services/bcc/edit/:id\"`).\n *\n * Useful for:\n * - Generating sitemaps from a single source of truth.\n * - Detecting duplicate path strings across branches at startup:\n *\n * @example\n * const flat = flattenRoutes(PATHS);\n * const paths = flat.map((r) => r.path);\n * const dupes = paths.filter((p, i) => paths.indexOf(p) !== i);\n * if (dupes.length) console.warn('Duplicate paths:', dupes);\n */\nexport function flattenRoutes(\n  routes: Record<string, unknown>,\n  prefix = \"\",\n): FlatRoute[] {\n  const entries: FlatRoute[] = [];\n\n  for (const key of Object.keys(routes)) {\n    const fullKey = prefix ? `${prefix}.${key}` : key;\n    const value = routes[key];\n\n    if (typeof value === \"string\") {\n      // Plain static string leaf.\n      entries.push({ key: fullKey, path: value });\n    } else if (value instanceof String) {\n      // String-object leaf (wrapped dynamic path from defineRoutes).\n      entries.push({ key: fullKey, path: value.valueOf() });\n    } else if (typeof value === \"object\" && value !== null) {\n      // Nested route group — recurse.\n      entries.push(...flattenRoutes(value as Record<string, unknown>, fullKey));\n    }\n    // Anything else (functions, numbers, …) is silently skipped.\n  }\n\n  return entries;\n}\n\nfunction deriveBreadcrumbLabel(key: string): string {\n  const parts = key.split(\".\");\n  const last = parts[parts.length - 1] ?? key;\n  // Use the parent segment when the leaf is the conventional \"ROOT\" key,\n  // so USERS.ROOT → \"Users\" rather than \"Root\".\n  const raw =\n    last === \"ROOT\" && parts.length > 1 ? parts[parts.length - 2]! : last;\n  return raw\n    .replace(/_/g, \" \")\n    .toLowerCase()\n    .replace(/^\\w/, (c) => c.toUpperCase());\n}\n\n/**\n * Build a breadcrumb trail from a route tree or a flat route list.\n *\n * For a given `currentPath`, it walks the route tree and returns every route\n * that is an ancestor of (or an exact match to) the current page.  Ancestors\n * are matched by prefix (e.g. `/users` matches `/users/edit/42/posts`).\n *\n * Dynamic params in ancestor paths are automatically resolved from the\n * matched portion of the URL.\n *\n * @param routes - A route tree (output of `defineRoutes`) or a pre-flattened\n *                 array from `flattenRoutes()`.\n * @param currentPath - The current URL (with or without query string).\n * @param options - Optional label resolver.\n * @returns An array of {@link BreadcrumbItem} ordered by depth\n *          (most general first), where the last item is the current page.\n *\n * @example\n * ```ts\n * const PATHS = defineRoutes({\n *   HOME: \"/\",\n *   USERS: { ROOT: \"/users\", EDIT: \"/users/edit/:id\" },\n * } as const);\n *\n * getBreadcrumbs(PATHS, \"/users/edit/42\");\n * // → [\n * //     { key: \"HOME\",       label: \"Home\",  path: \"/\",             isCurrent: false },\n * //     { key: \"USERS.ROOT\", label: \"Users\", path: \"/users\",        isCurrent: false },\n * //     { key: \"USERS.EDIT\", label: \"Edit\",  path: \"/users/edit/42\", isCurrent: true  },\n * //   ]\n * ```\n */\nexport function getBreadcrumbs(\n  routes: Record<string, unknown> | FlatRoute[],\n  currentPath: string,\n  options?: BreadcrumbOptions,\n): BreadcrumbItem[] {\n  const flat = Array.isArray(routes) ? routes : flattenRoutes(routes);\n  const pathname = currentPath.split(\"?\")[0] ?? \"\";\n  const labelFn = options?.labelResolver ?? deriveBreadcrumbLabel;\n  const labels = options?.labels ?? {};\n\n  const items: Array<{\n    key: string;\n    resolvedPath: string;\n    template: string;\n    isCurrent: boolean;\n  }> = [];\n\n  for (const route of flat) {\n    const exactRe = matchPath(route.path);\n    const exactMatch = pathname.match(exactRe);\n\n    if (exactMatch) {\n      const params = extractParamsFromPath(route.path, exactMatch[0]);\n      const resolved = isDynamic(route.path)\n        ? buildPath(route.path, params)\n        : route.path;\n      items.push({\n        key: route.key,\n        resolvedPath: resolved,\n        template: route.path,\n        isCurrent: true,\n      });\n      continue;\n    }\n\n    const prefixRe = matchPrefix(route.path);\n    const prefixMatch = pathname.match(prefixRe);\n\n    if (prefixMatch) {\n      const matchedPortion = prefixMatch[0];\n      const params = extractParamsFromPath(route.path, matchedPortion);\n      const resolved = isDynamic(route.path)\n        ? buildPath(route.path, params)\n        : route.path;\n      items.push({\n        key: route.key,\n        resolvedPath: resolved,\n        template: route.path,\n        isCurrent: false,\n      });\n    }\n  }\n\n  // Sort by path depth (segment count), not raw string length — a shallow\n  // route with a long param name (e.g. \"/shop/:reallyLongSlugName\") must\n  // still sort before a deeper route with short segments (e.g.\n  // \"/shop/widgets/details\"), even though the latter has fewer characters.\n  const segmentCount = (t: string) => t.split(\"/\").filter(Boolean).length;\n  items.sort((a, b) => segmentCount(a.template) - segmentCount(b.template));\n\n  return items.map((item) => ({\n    key: item.key,\n    label: labels[item.key] ?? labelFn(item.key),\n    path: item.resolvedPath,\n    isCurrent: item.isCurrent,\n  }));\n}\n","import { devWarn, isProduction } from \"./environment\";\nimport { buildPath } from \"./build\";\nimport { extractParamNames, isDynamic } from \"./params\";\nimport { isActivePath } from \"./match\";\nimport { flattenRoutes } from \"./routes\";\nimport type {\n  BuildPathOptions,\n  ExtractParams,\n  PathParams,\n  QueryParams,\n  RoutePath,\n  RouteTree,\n} from \"../types\";\n\n// Re-export so consumers that import from 'core/defineRoutes' get the full surface\nexport { buildPath } from \"./build\";\nexport { extractParamNames, isDynamic } from \"./params\";\n\n/**\n * A dynamic route is a template string with a `:param` or trailing `/*` splat,\n * augmented with a `.build()` helper and a `.paramNames` array.\n *\n * Exported so consumers (e.g. the hooks entry) can type against it.\n */\nexport type StaticRoute<T extends string> = T & {\n  build(query?: QueryParams, options?: BuildPathOptions): RoutePath;\n};\n\nexport type DynamicRoute<T extends string> = T extends\n  | `${string}:${string}`\n  | `${string}/*`\n  ? T & {\n      build(\n        params: PathParams<T>,\n        query?: QueryParams,\n        options?: BuildPathOptions,\n      ): RoutePath;\n      paramNames: Array<ExtractParams<T>>;\n    }\n  : StaticRoute<T>;\n\ntype ResolvedRoutes<T extends RouteTree> = {\n  [K in keyof T]: T[K] extends RouteTree\n    ? ResolvedRoutes<T[K]>\n    : T[K] extends string\n      ? DynamicRoute<T[K]>\n      : never;\n};\n\nconst isRouteGroup = (value: unknown): value is RouteTree =>\n  typeof value === \"object\" &&\n  value !== null &&\n  !Array.isArray(value) &&\n  Object.getPrototypeOf(value) === Object.prototype;\n\n/**\n * Validate a single route template and warn (dev-only) about common mistakes:\n * missing leading `/` and non-trailing `*` splats.\n */\nfunction validateTemplate(template: string, key: string): void {\n  if (!template.startsWith(\"/\")) {\n    devWarn(\n      `[route-forge] Route \"${key}\" does not start with \"/\": \"${template}\".`,\n    );\n  }\n\n  if (template.includes(\"*\") && !template.endsWith(\"/*\")) {\n    devWarn(\n      `[route-forge] Route \"${key}\" uses \"*\" outside a trailing \"/*\" splat; only a trailing splat is supported: \"${template}\".`,\n    );\n  }\n}\n\n/**\n * Warn (dev-only) when two routes resolve to the same path template or shadow each other.\n */\nfunction detectDuplicatePaths(routes: Record<string, unknown>): void {\n  const seen = new Map<string, string>();\n  const warned = new Set<string>();\n  const flat = flattenRoutes(routes);\n\n  for (const route of flat) {\n    const existing = seen.get(route.path);\n    if (existing === undefined) {\n      seen.set(route.path, route.key);\n    } else if (!warned.has(route.path)) {\n      warned.add(route.path);\n      devWarn(\n        `[route-forge] Duplicate route path \"${route.path}\" for \"${existing}\" and \"${route.key}\". ` +\n          `Only one of them will be reachable.`,\n      );\n    }\n  }\n\n  // Shadowing check: warn when a static path matches a dynamic path defined before it\n  for (let i = 0; i < flat.length; i++) {\n    const r1 = flat[i]!;\n    if (!isDynamic(r1.path)) continue;\n\n    for (let j = i + 1; j < flat.length; j++) {\n      const r2 = flat[j]!;\n      if (isDynamic(r2.path)) continue;\n\n      if (isActivePath(r2.path, r1.path, { exact: true })) {\n        const pairKey = `${r1.key}->${r2.key}`;\n        if (!warned.has(pairKey)) {\n          warned.add(pairKey);\n          devWarn(\n            `[route-forge] Route \"${r2.key}\" (\"${r2.path}\") is shadowed by dynamic route \"${r1.key}\" (\"${r1.path}\"). Place static routes before dynamic parameters in route trees.`,\n          );\n        }\n      }\n    }\n  }\n}\n\n/**\n * Attach `.build()` (and, for dynamic templates, `.paramNames`) to\n * `String.prototype` exactly once, so route values can stay **genuine\n * primitive strings** instead of `new String(template)` objects.\n *\n * Route values used to be wrapped in `new String(template)` so `.build()`\n * could be attached as an own property. That silently broke direct use with\n * React Router's `<Link to={...}>` (and anything else that branches on\n * `typeof to === \"string\"`, e.g. React Router's internal `resolveTo()`):\n * `typeof` on a `String` object is `\"object\"`, not `\"string\"`, so React\n * Router treated the route value as a `Partial<Path>` and spread it\n * (`{ ...routeValue }`) instead of parsing it as a path — producing a\n * `pathname`-less destination and a broken/no-op navigation. `.build()`\n * happened to \"fix\" it only because it returns a plain string.\n *\n * Putting `.build()`/`.paramNames` on the prototype instead means every\n * primitive string route value can still call `.build()` / read\n * `.paramNames` (resolved lazily from `this`, the template text itself),\n * while `typeof route === \"string\"` stays true — so route values now work\n * directly anywhere a plain path string is expected, `<Link to={route}>`\n * included, with no `.build()` call required.\n */\nfunction installBuildProtocol(): void {\n  if (Object.prototype.hasOwnProperty.call(String.prototype, \"build\")) {\n    return;\n  }\n\n  Object.defineProperty(String.prototype, \"build\", {\n    value: function build(\n      this: string,\n      paramsOrQuery?: PathParams<string> | QueryParams,\n      query?: QueryParams,\n      options?: BuildPathOptions,\n    ): RoutePath {\n      const template = this.valueOf();\n\n      // Dynamic templates take (params, query?, options?); static templates\n      // take (query?, options?) — disambiguated from the template itself,\n      // since that's all the prototype method has to go on.\n      return (\n        isDynamic(template)\n          ? buildPath(\n              template,\n              (paramsOrQuery ?? {}) as PathParams<string>,\n              query,\n              options,\n            )\n          : buildPath(\n              template,\n              {},\n              paramsOrQuery as QueryParams,\n              query as unknown as BuildPathOptions,\n            )\n      ) as RoutePath;\n    },\n    writable: false,\n    enumerable: false,\n    configurable: true,\n  });\n\n  Object.defineProperty(String.prototype, \"paramNames\", {\n    get(this: string): string[] {\n      return extractParamNames(this.valueOf());\n    },\n    enumerable: false,\n    configurable: true,\n  });\n}\n\ninstallBuildProtocol();\n\nfunction wrapStaticPath<T extends string>(template: T): StaticRoute<T> {\n  // A genuine primitive string — `.build()` comes from String.prototype\n  // (see installBuildProtocol above), so `typeof` stays \"string\".\n  return template as StaticRoute<T>;\n}\n\nfunction wrapDynamicPath<T extends string>(template: T): DynamicRoute<T> {\n  // Same here: primitive string, `.build()` and `.paramNames` are resolved\n  // lazily from String.prototype based on the template text itself.\n  return template as unknown as DynamicRoute<T>;\n}\n\nfunction processRouteMap<T extends RouteTree>(routes: T): ResolvedRoutes<T> {\n  const result = {} as ResolvedRoutes<T>;\n\n  for (const key in routes) {\n    if (!Object.prototype.hasOwnProperty.call(routes, key)) continue;\n\n    const value = routes[key];\n\n    if (typeof value === \"string\") {\n      validateTemplate(value, key);\n      result[key] = (\n        isDynamic(value) ? wrapDynamicPath(value) : wrapStaticPath(value)\n      ) as ResolvedRoutes<T>[typeof key];\n    } else if (isRouteGroup(value)) {\n      result[key] = processRouteMap(\n        value as RouteTree,\n      ) as unknown as ResolvedRoutes<T>[typeof key];\n    }\n  }\n\n  return result;\n}\n\nexport function defineRoutes<T extends RouteTree>(\n  routes: T,\n): ResolvedRoutes<T> {\n  const result = processRouteMap(routes);\n  // detectDuplicatePaths only ever produces console.warn output (suppressed\n  // in production by devWarn), so skip the O(n^2) walk entirely in\n  // production rather than computing it and discarding the result.\n  if (!isProduction()) {\n    detectDuplicatePaths(result as unknown as Record<string, unknown>);\n  }\n  return result;\n}\n"],"mappings":"qIAyBO,SAASA,EACdC,EACAC,EAAS,GACI,CACb,IAAMC,EAAuB,CAAC,EAE9B,QAAWC,KAAO,OAAO,KAAKH,CAAM,EAAG,CACrC,IAAMI,EAAUH,EAAS,GAAGA,CAAM,IAAIE,CAAG,GAAKA,EACxCE,EAAQL,EAAOG,CAAG,EAEpB,OAAOE,GAAU,SAEnBH,EAAQ,KAAK,CAAE,IAAKE,EAAS,KAAMC,CAAM,CAAC,EACjCA,aAAiB,OAE1BH,EAAQ,KAAK,CAAE,IAAKE,EAAS,KAAMC,EAAM,QAAQ,CAAE,CAAC,EAC3C,OAAOA,GAAU,UAAYA,IAAU,MAEhDH,EAAQ,KAAK,GAAGH,EAAcM,EAAkCD,CAAO,CAAC,CAG5E,CAEA,OAAOF,CACT,CAEA,SAASI,EAAsBH,EAAqB,CAClD,IAAMI,EAAQJ,EAAI,MAAM,GAAG,EACrBK,EAAOD,EAAMA,EAAM,OAAS,CAAC,GAAKJ,EAKxC,OADEK,IAAS,QAAUD,EAAM,OAAS,EAAIA,EAAMA,EAAM,OAAS,CAAC,EAAKC,GAEhE,QAAQ,KAAM,GAAG,EACjB,YAAY,EACZ,QAAQ,MAAQC,GAAMA,EAAE,YAAY,CAAC,CAC1C,CAkCO,SAASC,EACdV,EACAW,EACAC,EACkB,CAClB,IAAMC,EAAO,MAAM,QAAQb,CAAM,EAAIA,EAASD,EAAcC,CAAM,EAC5Dc,EAAWH,EAAY,MAAM,GAAG,EAAE,CAAC,GAAK,GACxCI,EAAUH,GAAS,eAAiBN,EACpCU,EAASJ,GAAS,QAAU,CAAC,EAE7BK,EAKD,CAAC,EAEN,QAAWC,KAASL,EAAM,CACxB,IAAMM,EAAUC,EAAUF,EAAM,IAAI,EAC9BG,EAAaP,EAAS,MAAMK,CAAO,EAEzC,GAAIE,EAAY,CACd,IAAMC,EAASC,EAAsBL,EAAM,KAAMG,EAAW,CAAC,CAAC,EACxDG,EAAWC,EAAUP,EAAM,IAAI,EACjCQ,EAAUR,EAAM,KAAMI,CAAM,EAC5BJ,EAAM,KACVD,EAAM,KAAK,CACT,IAAKC,EAAM,IACX,aAAcM,EACd,SAAUN,EAAM,KAChB,UAAW,EACb,CAAC,EACD,QACF,CAEA,IAAMS,EAAWC,EAAYV,EAAM,IAAI,EACjCW,EAAcf,EAAS,MAAMa,CAAQ,EAE3C,GAAIE,EAAa,CACf,IAAMC,EAAiBD,EAAY,CAAC,EAC9BP,EAASC,EAAsBL,EAAM,KAAMY,CAAc,EACzDN,EAAWC,EAAUP,EAAM,IAAI,EACjCQ,EAAUR,EAAM,KAAMI,CAAM,EAC5BJ,EAAM,KACVD,EAAM,KAAK,CACT,IAAKC,EAAM,IACX,aAAcM,EACd,SAAUN,EAAM,KAChB,UAAW,EACb,CAAC,CACH,CACF,CAMA,IAAMa,EAAgBC,GAAcA,EAAE,MAAM,GAAG,EAAE,OAAO,OAAO,EAAE,OACjE,OAAAf,EAAM,KAAK,CAACgB,EAAGC,IAAMH,EAAaE,EAAE,QAAQ,EAAIF,EAAaG,EAAE,QAAQ,CAAC,EAEjEjB,EAAM,IAAKkB,IAAU,CAC1B,IAAKA,EAAK,IACV,MAAOnB,EAAOmB,EAAK,GAAG,GAAKpB,EAAQoB,EAAK,GAAG,EAC3C,KAAMA,EAAK,aACX,UAAWA,EAAK,SAClB,EAAE,CACJ,CCjHA,IAAMC,EAAgBC,GACpB,OAAOA,GAAU,UACjBA,IAAU,MACV,CAAC,MAAM,QAAQA,CAAK,GACpB,OAAO,eAAeA,CAAK,IAAM,OAAO,UAM1C,SAASC,EAAiBC,EAAkBC,EAAmB,CACxDD,EAAS,WAAW,GAAG,GAC1BE,EACE,wBAAwBD,CAAG,+BAA+BD,CAAQ,IACpE,EAGEA,EAAS,SAAS,GAAG,GAAK,CAACA,EAAS,SAAS,IAAI,GACnDE,EACE,wBAAwBD,CAAG,kFAAkFD,CAAQ,IACvH,CAEJ,CAKA,SAASG,EAAqBC,EAAuC,CACnE,IAAMC,EAAO,IAAI,IACXC,EAAS,IAAI,IACbC,EAAOC,EAAcJ,CAAM,EAEjC,QAAWK,KAASF,EAAM,CACxB,IAAMG,EAAWL,EAAK,IAAII,EAAM,IAAI,EAChCC,IAAa,OACfL,EAAK,IAAII,EAAM,KAAMA,EAAM,GAAG,EACpBH,EAAO,IAAIG,EAAM,IAAI,IAC/BH,EAAO,IAAIG,EAAM,IAAI,EACrBP,EACE,uCAAuCO,EAAM,IAAI,UAAUC,CAAQ,UAAUD,EAAM,GAAG,wCAExF,EAEJ,CAGA,QAASE,EAAI,EAAGA,EAAIJ,EAAK,OAAQI,IAAK,CACpC,IAAMC,EAAKL,EAAKI,CAAC,EACjB,GAAKE,EAAUD,EAAG,IAAI,EAEtB,QAASE,EAAIH,EAAI,EAAGG,EAAIP,EAAK,OAAQO,IAAK,CACxC,IAAMC,EAAKR,EAAKO,CAAC,EACjB,GAAI,CAAAD,EAAUE,EAAG,IAAI,GAEjBC,EAAaD,EAAG,KAAMH,EAAG,KAAM,CAAE,MAAO,EAAK,CAAC,EAAG,CACnD,IAAMK,EAAU,GAAGL,EAAG,GAAG,KAAKG,EAAG,GAAG,GAC/BT,EAAO,IAAIW,CAAO,IACrBX,EAAO,IAAIW,CAAO,EAClBf,EACE,wBAAwBa,EAAG,GAAG,OAAOA,EAAG,IAAI,oCAAoCH,EAAG,GAAG,OAAOA,EAAG,IAAI,mEACtG,EAEJ,CACF,CACF,CACF,CAwBA,SAASM,GAA6B,CAChC,OAAO,UAAU,eAAe,KAAK,OAAO,UAAW,OAAO,IAIlE,OAAO,eAAe,OAAO,UAAW,QAAS,CAC/C,MAAO,SAELC,EACAC,EACAC,EACW,CACX,IAAMrB,EAAW,KAAK,QAAQ,EAK9B,OACEa,EAAUb,CAAQ,EACdsB,EACEtB,EACCmB,GAAiB,CAAC,EACnBC,EACAC,CACF,EACAC,EACEtB,EACA,CAAC,EACDmB,EACAC,CACF,CAER,EACA,SAAU,GACV,WAAY,GACZ,aAAc,EAChB,CAAC,EAED,OAAO,eAAe,OAAO,UAAW,aAAc,CACpD,KAA4B,CAC1B,OAAOG,EAAkB,KAAK,QAAQ,CAAC,CACzC,EACA,WAAY,GACZ,aAAc,EAChB,CAAC,EACH,CAEAL,EAAqB,EAcrB,SAASM,EAAqCC,EAA8B,CAC1E,IAAMC,EAAS,CAAC,EAEhB,QAAWC,KAAOF,EAAQ,CACxB,GAAI,CAAC,OAAO,UAAU,eAAe,KAAKA,EAAQE,CAAG,EAAG,SAExD,IAAMC,EAAQH,EAAOE,CAAG,EAEpB,OAAOC,GAAU,UACnBC,EAAiBD,EAAOD,CAAG,EAC3BD,EAAOC,CAAG,EACRG,EAAUF,CAAK,EAAoBA,EAAwBA,GAEpDG,EAAaH,CAAK,IAC3BF,EAAOC,CAAG,EAAIH,EACZI,CACF,EAEJ,CAEA,OAAOF,CACT,CAEO,SAASM,EACdP,EACmB,CACnB,IAAMC,EAASF,EAAgBC,CAAM,EAIrC,OAAKQ,EAAa,GAChBC,EAAqBR,CAA4C,EAE5DA,CACT","names":["flattenRoutes","routes","prefix","entries","key","fullKey","value","deriveBreadcrumbLabel","parts","last","c","getBreadcrumbs","currentPath","options","flat","pathname","labelFn","labels","items","route","exactRe","matchPath","exactMatch","params","extractParamsFromPath","resolved","isDynamic","buildPath","prefixRe","matchPrefix","prefixMatch","matchedPortion","segmentCount","t","a","b","item","isRouteGroup","value","validateTemplate","template","key","devWarn","detectDuplicatePaths","routes","seen","warned","flat","flattenRoutes","route","existing","i","r1","isDynamic","j","r2","isActivePath","pairKey","installBuildProtocol","paramsOrQuery","query","options","buildPath","extractParamNames","processRouteMap","routes","result","key","value","validateTemplate","isDynamic","isRouteGroup","defineRoutes","isProduction","detectDuplicatePaths"]}