import type { WorldXZ } from "./minimap.js";
/** A world-space segment defining a linear "track" minimap — points are projected onto the `from`→`to` axis. */
export interface TrackAxis {
    from: WorldXZ;
    to: WorldXZ;
}
/**
 * Project a world point onto the `from`→`to` segment of `axis` and return the
 * clamped 0..1 fraction of how far along the track it lies (0 at `from`, 1 at
 * `to`). The linear analogue of `projectToMinimap` — feeds a horizontal
 * corridor/route progress rail. Accepts XZ (`[x, z]`) or XYZ (`[x, y, z]`)
 * points (index 0 = x, index 2 when length 3 else index 1 = z). A zero-length
 * axis returns 0.
 *
 * @capability minimap-track project a world point to a 0..1 fraction along a linear track axis
 */
export declare function trackFraction(point: WorldXZ | readonly [number, number, number], axis: TrackAxis): number;