import type { TreeNode } from '../Tree/types';
import type { BuildNavTreeOptions, NavTreeItem } from './types';
/** Group ids are namespaced so a group can never collide with a route id. */
export declare const GROUP_ID_PREFIX = "navgroup:";
export declare const groupNodeId: (path: string[]) => string;
/** True for an id `buildNavTree` minted for a group rather than an item. */
export declare const isGroupNodeId: (id: string) => boolean;
/**
 * Nests a flat list of routes into the tree `Tree` renders.
 *
 * Grouping is by each item's `group` path, so the same list can be regrouped —
 * by category, by package, by anything already on the record — without
 * restructuring it. Ordering is curated-then-alphabetical at every level, which
 * keeps a hand-picked section order while new entries still land somewhere
 * predictable on their own.
 */
export declare function buildNavTree(items: NavTreeItem[], options?: BuildNavTreeOptions): TreeNode<NavTreeItem>[];