import type { EvaluationContext } from "../gate_engine_types.js";
/** 路由 path 归一化:去尾斜杠;:id 与 {id} 统一为 {param} 占位(react :param vs openapi {param} 两种形态)。 */
export declare function normalizeRoutePath(raw: string): string;
/** 定位前端根下的路由注册文件(有限遍历深度≤4):router/routes 目录内源码文件,或顶层 router/routes 命名单文件。
 *  index 文件只在 router/routes 目录内收(collectDirSources)——顶层全收 index 会在大仓先触发文件上限
 *  且无关 index 的 path 字面量污染注册集。react/vue 项目惯例目录名;多端全部纳入。 */
export declare function findRouterFiles(frontendRoots: string[]): string[];
/** 前端源码根集合：intent.projects(kind=frontend-end) ∪ 目录探测（frontend+shared role）。
 *  路由覆盖与 UI 结构对照共用同一前端根口径。 */
export declare function collectFrontendRoots(ctx: EvaluationContext): Promise<string[]>;
/** 注册前端路由覆盖执行器。 */
export declare function registerFrontendRouteExecutors(): void;