import type { RouteAuth } from '../types';
export type RouteFilterable = {
    name: string;
    summary: string;
    description: string;
    tags: string[];
    auth: RouteAuth;
    mcp: boolean;
};
export type AuthFilter = 'all' | RouteAuth;
export type RouteFilters = {
    text: string;
    auth: AuthFilter;
    tag: string | null;
    mcpOnly: boolean;
};
export type RouteNeighbors = {
    prev: string | null;
    next: string | null;
};
/** @deprecated Use {@link routeNeighbors}. Kept for older call sites/tests. */
export type TagNeighbors = RouteNeighbors & {
    tag: string | null;
};
/** Prev/next route names in sidebar order — tag groups alphabetically, routes deduped. */
export declare function routeNeighbors<T extends RouteFilterable>(routes: readonly T[], routeName: string): RouteNeighbors;
/** Prev/next within the primary tag only — prefer {@link routeNeighbors} for footer nav. */
export declare function neighborsInTagGroup<T extends RouteFilterable>(routes: readonly T[], routeName: string): TagNeighbors;
export declare function applyRouteFilters<T extends RouteFilterable>(routes: readonly T[], filters: RouteFilters): T[];
export declare function groupRoutesByTag<T extends RouteFilterable>(routes: readonly T[]): Map<string, T[]>;