@ingissa/navcore-core 1.0.3 → 1.0.5

package/dist/{NavCore.d-BuXR5DO7.d.mts → NavCore-qf5_0qsR.d.mts}

@@ -34,7 +34,7 @@ interface InstructionResult {
 /**
  * Resolve which instruction is next and whether it should trigger now.
  */
-declare function resolveNextInstruction(currentGeometryIdx: number, instructions: NavInstruction[], currentInstrIdx: number, route: Coordinate[], currentCoord: Coordinate, vehicleBearing: number | null, vehicleDistance: number, speed?: number): InstructionResult;
+declare function resolveNextInstruction(currentGeometryIdx: number, instructions: NavInstruction[], currentInstrIdx: number, route: Coordinate[], currentCoord: Coordinate, vehicleBearing: number | null, vehicleDistance: number, speed?: number, isCircuit?: boolean): InstructionResult;
 
 /**
  * Module 9a: NavigationFSM
@@ -151,12 +151,8 @@ declare class OffRouteFSM {
 /**
  * Feature flag constants for SDK consumers.
  *
- * CORE features: available to all users without a license key.
- *   - GPS smoothing, basic snapping, route building, directions providers,
- *     progress tracking, and route offset prediction are all free.
- *
- * PRO features: require a valid commercial license key.
- *   Each PRO engine checks the license at runtime and gracefully degrades.
+ * CORE features: available to all users (MIT license).
+ * PRO  features: require a valid commercial license key.
  */
 declare const FEATURES: {
     /**
@@ -165,45 +161,43 @@ declare const FEATURES: {
      */
     readonly GPS_SMOOTHING: "gps_smoothing";
     /**
-     * Basic route snapping (nearest-point projection) with bearing and inertia
-     * penalties to prevent U-turn snaps and oscillation.
-     * Both basic and advanced snapping quality are available in the free tier.
+     * Basic route snapping (nearest-point projection).
+     * Snaps GPS position to the closest route segment.
      */
     readonly BASIC_SNAPPING: "basic_snapping";
     /**
-     * Progress anti-regression: prevents route index from jumping backward.
-     * Essential for circuit routes and motorway slip roads.
-     * Used unconditionally inside NavCore — available in the free tier.
+     * Advanced route snapping with bearing penalty + inertia.
+     * Prevents incorrect snaps on parallel roads and U-turns.
      */
-    readonly PROGRESS_TRACKING: "progress_tracking";
+    readonly ADVANCED_SNAPPING: "advanced_snapping";
+    /**
+     * Dead reckoning: continues navigation during GPS signal loss.
+     * Predicts position based on last known speed and bearing.
+     */
+    readonly DEAD_RECKONING: "dead_reckoning";
     /**
      * Smooth route offset predictor for jitter-free map rendering.
      * Advances render position at frame rate between GPS fixes.
-     * Used unconditionally inside NavCore — available in the free tier.
      */
     readonly ROUTE_OFFSET: "route_offset";
     /**
-     * Dead reckoning: continues navigation during GPS signal loss.
-     * Predicts position based on last known speed and bearing.
-     * DeadReckoningEngine.predict() is a no-op without a Pro license.
+     * Progress anti-regression: prevents route index from jumping backward.
+     * Essential for circuit routes and motorway slip roads.
      */
-    readonly DEAD_RECKONING: "dead_reckoning";
+    readonly PROGRESS_TRACKING: "progress_tracking";
     /**
      * Advanced bearing engine with look-ahead and speed-adaptive alpha.
      * Produces stable heading for smooth map camera rotation.
-     * Gated inside NavCore.update() via this.has(FEATURES.ADVANCED_BEARING).
      */
     readonly ADVANCED_BEARING: "advanced_bearing";
     /**
      * Compound deviation detection: combines distance, bearing, and speed signals.
      * Eliminates false off-route triggers in tunnels and urban canyons.
-     * DeviationDetector.evaluate() returns a neutral signal without a Pro license.
      */
     readonly COMPOUND_DEVIATION: "compound_deviation";
     /**
      * Parallel road disambiguation + U-turn snap protection.
      * Prevents snapping to the wrong carriageway when bearing mismatches route direction.
-     * ParallelRoadResolver falls back to pure distance sorting without a Pro license.
      */
     readonly PARALLEL_ROAD_RESOLUTION: "parallel_road_resolution";
     /**
@@ -213,17 +207,14 @@ declare const FEATURES: {
     readonly U_TURN_PROTECTION: "u_turn_protection";
     /**
      * Timed voice instruction cues with deduplication and priority levels.
-     * VoiceTriggerEngine.update() returns null without a Pro license.
      */
     readonly VOICE_TRIGGERS: "voice_triggers";
     /**
      * Local ETA computation using rolling speed average — zero API calls.
-     * ETAEngine.update() returns isReliable=false without a Pro license.
      */
     readonly ETA: "eta";
     /**
      * Circular and polygon geofencing with enter/exit/dwell events.
-     * GeofencingEngine.update() returns [] without a Pro license.
      */
     readonly GEOFENCING: "geofencing";
     /**
@@ -256,25 +247,9 @@ declare class LicenseManager {
     private payload;
     private enabledFeatures;
     private warnedFeatures;
-    private static activeManager;
-    static getActive(): LicenseManager | null;
-    /**
-     * Clear the active manager reference.
-     * Intended for test teardown only — not for production use.
-     */
-    static clearActive(): void;
-    /**
-     * Promote this instance to the global active manager.
-     *
-     * Security rule: A VALID license context cannot be overwritten by an
-     * INVALID / MISSING / EXPIRED one. Once a valid license is registered,
-     * it holds the slot until explicitly cleared or replaced by another
-     * valid license.
-     */
-    private promoteToActive;
+    private isDev;
     private static PUBLIC_KEY_SPKI;
-    constructor(licenseKey?: string);
-    private tryValidateSync;
+    constructor(licenseKey?: string, isDev?: boolean);
     validate(key: string): Promise<LicenseStatus>;
     private extractFeatures;
     hasFeature(feature: FeatureKey): boolean;
@@ -311,6 +286,7 @@ interface NavGpsUpdate {
 }
 interface NavCoreOptions {
     licenseKey?: string;
+    isDev?: boolean;
     isCircuit?: boolean;
     kalmanQ?: number;
     kalmanRBase?: number;
@@ -321,24 +297,47 @@ interface NavCoreOptions {
 }
 interface NavCoreState {
     snappedCoord: Coordinate | null;
+    ghostCoord: Coordinate | null;
     rawGpsCoord: Coordinate | null;
     bearing: number;
     rawGpsBearing: number | null;
     routeIndex: number;
+    anchorRouteIndex: number | null;
     distanceToRoute: number;
     corridor: number;
+    confidence: number;
     isOffRoute: boolean;
+    navFsmState: string;
     progressIndex: number;
     hasArrived: boolean;
-    offRouteState: string;
-    lifecycleState: string;
+    rejoinCandidate: {
+        coord: Coordinate;
+        index: number;
+    } | null;
+    confidenceCone: {
+        center: Coordinate;
+        bearing: number;
+        angle: number;
+        length: number;
+    } | null;
+    alertState: 'NONE' | 'DEVIATING' | 'RECALCULATING' | 'REJOINING' | 'REJOINED';
+    detourMode: 'NONE' | 'FREE' | 'COMMITTED';
+    detourCommitProgress: number;
     distanceToDestination: number | null;
     distanceToNextInstruction: number | null;
+    nextInstrIdx: number | null;
     nextInstructionIndex: number | null;
     currentSpeed: number;
     isGpsStale: boolean;
     gpsAgeMs: number;
     licenseStatus: string;
+    offRouteState: string;
+    lifecycleState: string;
+    stability?: {
+        oscillation: number;
+        drift: number;
+        jump: number;
+    };
 }
 type EventHandler = (...args: unknown[]) => void;
 declare class NavCore {
@@ -354,6 +353,7 @@ declare class NavCore {
     private forwardCum;
     private reverseCum;
     private snappedCoord;
+    private ghostCoord;
     private rawGpsCoord;
     private bearing;
     private rawGpsBearing;

package/dist/{NavCore.d-BuXR5DO7.d.ts → NavCore-qf5_0qsR.d.ts}

@@ -34,7 +34,7 @@ interface InstructionResult {
 /**
  * Resolve which instruction is next and whether it should trigger now.
  */
-declare function resolveNextInstruction(currentGeometryIdx: number, instructions: NavInstruction[], currentInstrIdx: number, route: Coordinate[], currentCoord: Coordinate, vehicleBearing: number | null, vehicleDistance: number, speed?: number): InstructionResult;
+declare function resolveNextInstruction(currentGeometryIdx: number, instructions: NavInstruction[], currentInstrIdx: number, route: Coordinate[], currentCoord: Coordinate, vehicleBearing: number | null, vehicleDistance: number, speed?: number, isCircuit?: boolean): InstructionResult;
 
 /**
  * Module 9a: NavigationFSM
@@ -151,12 +151,8 @@ declare class OffRouteFSM {
 /**
  * Feature flag constants for SDK consumers.
  *
- * CORE features: available to all users without a license key.
- *   - GPS smoothing, basic snapping, route building, directions providers,
- *     progress tracking, and route offset prediction are all free.
- *
- * PRO features: require a valid commercial license key.
- *   Each PRO engine checks the license at runtime and gracefully degrades.
+ * CORE features: available to all users (MIT license).
+ * PRO  features: require a valid commercial license key.
  */
 declare const FEATURES: {
     /**
@@ -165,45 +161,43 @@ declare const FEATURES: {
      */
     readonly GPS_SMOOTHING: "gps_smoothing";
     /**
-     * Basic route snapping (nearest-point projection) with bearing and inertia
-     * penalties to prevent U-turn snaps and oscillation.
-     * Both basic and advanced snapping quality are available in the free tier.
+     * Basic route snapping (nearest-point projection).
+     * Snaps GPS position to the closest route segment.
      */
     readonly BASIC_SNAPPING: "basic_snapping";
     /**
-     * Progress anti-regression: prevents route index from jumping backward.
-     * Essential for circuit routes and motorway slip roads.
-     * Used unconditionally inside NavCore — available in the free tier.
+     * Advanced route snapping with bearing penalty + inertia.
+     * Prevents incorrect snaps on parallel roads and U-turns.
      */
-    readonly PROGRESS_TRACKING: "progress_tracking";
+    readonly ADVANCED_SNAPPING: "advanced_snapping";
+    /**
+     * Dead reckoning: continues navigation during GPS signal loss.
+     * Predicts position based on last known speed and bearing.
+     */
+    readonly DEAD_RECKONING: "dead_reckoning";
     /**
      * Smooth route offset predictor for jitter-free map rendering.
      * Advances render position at frame rate between GPS fixes.
-     * Used unconditionally inside NavCore — available in the free tier.
      */
     readonly ROUTE_OFFSET: "route_offset";
     /**
-     * Dead reckoning: continues navigation during GPS signal loss.
-     * Predicts position based on last known speed and bearing.
-     * DeadReckoningEngine.predict() is a no-op without a Pro license.
+     * Progress anti-regression: prevents route index from jumping backward.
+     * Essential for circuit routes and motorway slip roads.
      */
-    readonly DEAD_RECKONING: "dead_reckoning";
+    readonly PROGRESS_TRACKING: "progress_tracking";
     /**
      * Advanced bearing engine with look-ahead and speed-adaptive alpha.
      * Produces stable heading for smooth map camera rotation.
-     * Gated inside NavCore.update() via this.has(FEATURES.ADVANCED_BEARING).
      */
     readonly ADVANCED_BEARING: "advanced_bearing";
     /**
      * Compound deviation detection: combines distance, bearing, and speed signals.
      * Eliminates false off-route triggers in tunnels and urban canyons.
-     * DeviationDetector.evaluate() returns a neutral signal without a Pro license.
      */
     readonly COMPOUND_DEVIATION: "compound_deviation";
     /**
      * Parallel road disambiguation + U-turn snap protection.
      * Prevents snapping to the wrong carriageway when bearing mismatches route direction.
-     * ParallelRoadResolver falls back to pure distance sorting without a Pro license.
      */
     readonly PARALLEL_ROAD_RESOLUTION: "parallel_road_resolution";
     /**
@@ -213,17 +207,14 @@ declare const FEATURES: {
     readonly U_TURN_PROTECTION: "u_turn_protection";
     /**
      * Timed voice instruction cues with deduplication and priority levels.
-     * VoiceTriggerEngine.update() returns null without a Pro license.
      */
     readonly VOICE_TRIGGERS: "voice_triggers";
     /**
      * Local ETA computation using rolling speed average — zero API calls.
-     * ETAEngine.update() returns isReliable=false without a Pro license.
      */
     readonly ETA: "eta";
     /**
      * Circular and polygon geofencing with enter/exit/dwell events.
-     * GeofencingEngine.update() returns [] without a Pro license.
      */
     readonly GEOFENCING: "geofencing";
     /**
@@ -256,25 +247,9 @@ declare class LicenseManager {
     private payload;
     private enabledFeatures;
     private warnedFeatures;
-    private static activeManager;
-    static getActive(): LicenseManager | null;
-    /**
-     * Clear the active manager reference.
-     * Intended for test teardown only — not for production use.
-     */
-    static clearActive(): void;
-    /**
-     * Promote this instance to the global active manager.
-     *
-     * Security rule: A VALID license context cannot be overwritten by an
-     * INVALID / MISSING / EXPIRED one. Once a valid license is registered,
-     * it holds the slot until explicitly cleared or replaced by another
-     * valid license.
-     */
-    private promoteToActive;
+    private isDev;
     private static PUBLIC_KEY_SPKI;
-    constructor(licenseKey?: string);
-    private tryValidateSync;
+    constructor(licenseKey?: string, isDev?: boolean);
     validate(key: string): Promise<LicenseStatus>;
     private extractFeatures;
     hasFeature(feature: FeatureKey): boolean;
@@ -311,6 +286,7 @@ interface NavGpsUpdate {
 }
 interface NavCoreOptions {
     licenseKey?: string;
+    isDev?: boolean;
     isCircuit?: boolean;
     kalmanQ?: number;
     kalmanRBase?: number;
@@ -321,24 +297,47 @@ interface NavCoreOptions {
 }
 interface NavCoreState {
     snappedCoord: Coordinate | null;
+    ghostCoord: Coordinate | null;
     rawGpsCoord: Coordinate | null;
     bearing: number;
     rawGpsBearing: number | null;
     routeIndex: number;
+    anchorRouteIndex: number | null;
     distanceToRoute: number;
     corridor: number;
+    confidence: number;
     isOffRoute: boolean;
+    navFsmState: string;
     progressIndex: number;
     hasArrived: boolean;
-    offRouteState: string;
-    lifecycleState: string;
+    rejoinCandidate: {
+        coord: Coordinate;
+        index: number;
+    } | null;
+    confidenceCone: {
+        center: Coordinate;
+        bearing: number;
+        angle: number;
+        length: number;
+    } | null;
+    alertState: 'NONE' | 'DEVIATING' | 'RECALCULATING' | 'REJOINING' | 'REJOINED';
+    detourMode: 'NONE' | 'FREE' | 'COMMITTED';
+    detourCommitProgress: number;
     distanceToDestination: number | null;
     distanceToNextInstruction: number | null;
+    nextInstrIdx: number | null;
     nextInstructionIndex: number | null;
     currentSpeed: number;
     isGpsStale: boolean;
     gpsAgeMs: number;
     licenseStatus: string;
+    offRouteState: string;
+    lifecycleState: string;
+    stability?: {
+        oscillation: number;
+        drift: number;
+        jump: number;
+    };
 }
 type EventHandler = (...args: unknown[]) => void;
 declare class NavCore {
@@ -354,6 +353,7 @@ declare class NavCore {
     private forwardCum;
     private reverseCum;
     private snappedCoord;
+    private ghostCoord;
     private rawGpsCoord;
     private bearing;
     private rawGpsBearing;

package/dist/core.d.mts

@@ -1,5 +1,5 @@
-import { C as Coordinate, g as NavCoreState } from './NavCore.d-BuXR5DO7.mjs';
-export { F as FEATURES, a as FeatureKey, L as LicenseManager, b as LicensePayload, c as LicenseStatus, o as destinationPoint, p as geoGetBearing, q as haversineDistance } from './NavCore.d-BuXR5DO7.mjs';
+import { C as Coordinate, g as NavCoreState } from './NavCore-qf5_0qsR.mjs';
+export { F as FEATURES, a as FeatureKey, L as LicenseManager, b as LicensePayload, c as LicenseStatus, o as destinationPoint, p as geoGetBearing, q as haversineDistance } from './NavCore-qf5_0qsR.mjs';
 
 /**
  * Bearing and angular math utilities.
@@ -430,6 +430,8 @@ declare const BASE_CORRIDOR_METERS = 25;
 declare const MAX_CORRIDOR_METERS = 60;
 declare const SPEED_CORRIDOR_FACTOR = 1.2;
 declare const GPS_ACCURACY_FACTOR = 0.5;
+declare const TURN_LOOKAHEAD_DISTANCE_METERS = 40;
+declare const TURN_CORRIDOR_MULTIPLIER = 1.4;
 declare const MAX_SNAP_DISTANCE = 80;
 declare const BEARING_MISMATCH_THRESHOLD = 90;
 declare const BEARING_MISMATCH_PENALTY = 500;
@@ -454,35 +456,37 @@ declare const MIN_LOOK_AHEAD_METERS = 20;
 declare const MAX_LOOK_AHEAD_METERS = 100;
 declare const ARRIVAL_THRESHOLD_METERS = 30;
 
-declare const constants_d_ARRIVAL_THRESHOLD_METERS: typeof ARRIVAL_THRESHOLD_METERS;
-declare const constants_d_BASE_CORRIDOR_METERS: typeof BASE_CORRIDOR_METERS;
-declare const constants_d_BEARING_ALIGNMENT_THRESHOLD: typeof BEARING_ALIGNMENT_THRESHOLD;
-declare const constants_d_BEARING_MIN_SPEED_MPS: typeof BEARING_MIN_SPEED_MPS;
-declare const constants_d_BEARING_MISMATCH_PENALTY: typeof BEARING_MISMATCH_PENALTY;
-declare const constants_d_BEARING_MISMATCH_THRESHOLD: typeof BEARING_MISMATCH_THRESHOLD;
-declare const constants_d_BEARING_SMOOTHING_ALPHA: typeof BEARING_SMOOTHING_ALPHA;
-declare const constants_d_BETA_CORRECTION: typeof BETA_CORRECTION;
-declare const constants_d_DETOUR_COMMIT_MS: typeof DETOUR_COMMIT_MS;
-declare const constants_d_DR_MAX_AGE_MS: typeof DR_MAX_AGE_MS;
-declare const constants_d_GPS_ACCURACY_FACTOR: typeof GPS_ACCURACY_FACTOR;
-declare const constants_d_GPS_AGE_CAP_SECONDS: typeof GPS_AGE_CAP_SECONDS;
-declare const constants_d_GPS_STALE_MS: typeof GPS_STALE_MS;
-declare const constants_d_INERTIA_PENALTY: typeof INERTIA_PENALTY;
-declare const constants_d_INERTIA_SEGMENT_DIST: typeof INERTIA_SEGMENT_DIST;
-declare const constants_d_LOOK_AHEAD_SECONDS: typeof LOOK_AHEAD_SECONDS;
-declare const constants_d_MANEUVER_TRIGGER_DIST: typeof MANEUVER_TRIGGER_DIST;
-declare const constants_d_MAX_CORRIDOR_METERS: typeof MAX_CORRIDOR_METERS;
-declare const constants_d_MAX_LOOK_AHEAD_METERS: typeof MAX_LOOK_AHEAD_METERS;
-declare const constants_d_MAX_SNAP_DISTANCE: typeof MAX_SNAP_DISTANCE;
-declare const constants_d_MIN_LOOK_AHEAD_METERS: typeof MIN_LOOK_AHEAD_METERS;
-declare const constants_d_OFF_ROUTE_CONFIRM_MS: typeof OFF_ROUTE_CONFIRM_MS;
-declare const constants_d_REJOIN_CONFIRM_MS: typeof REJOIN_CONFIRM_MS;
-declare const constants_d_REJOIN_COOLDOWN_MS: typeof REJOIN_COOLDOWN_MS;
-declare const constants_d_SNAP_WINDOW_SIZE: typeof SNAP_WINDOW_SIZE;
-declare const constants_d_SPEED_CORRIDOR_FACTOR: typeof SPEED_CORRIDOR_FACTOR;
-declare const constants_d_STARTUP_GRACE_MS: typeof STARTUP_GRACE_MS;
-declare namespace constants_d {
-  export { constants_d_ARRIVAL_THRESHOLD_METERS as ARRIVAL_THRESHOLD_METERS, constants_d_BASE_CORRIDOR_METERS as BASE_CORRIDOR_METERS, constants_d_BEARING_ALIGNMENT_THRESHOLD as BEARING_ALIGNMENT_THRESHOLD, constants_d_BEARING_MIN_SPEED_MPS as BEARING_MIN_SPEED_MPS, constants_d_BEARING_MISMATCH_PENALTY as BEARING_MISMATCH_PENALTY, constants_d_BEARING_MISMATCH_THRESHOLD as BEARING_MISMATCH_THRESHOLD, constants_d_BEARING_SMOOTHING_ALPHA as BEARING_SMOOTHING_ALPHA, constants_d_BETA_CORRECTION as BETA_CORRECTION, constants_d_DETOUR_COMMIT_MS as DETOUR_COMMIT_MS, constants_d_DR_MAX_AGE_MS as DR_MAX_AGE_MS, constants_d_GPS_ACCURACY_FACTOR as GPS_ACCURACY_FACTOR, constants_d_GPS_AGE_CAP_SECONDS as GPS_AGE_CAP_SECONDS, constants_d_GPS_STALE_MS as GPS_STALE_MS, constants_d_INERTIA_PENALTY as INERTIA_PENALTY, constants_d_INERTIA_SEGMENT_DIST as INERTIA_SEGMENT_DIST, constants_d_LOOK_AHEAD_SECONDS as LOOK_AHEAD_SECONDS, constants_d_MANEUVER_TRIGGER_DIST as MANEUVER_TRIGGER_DIST, constants_d_MAX_CORRIDOR_METERS as MAX_CORRIDOR_METERS, constants_d_MAX_LOOK_AHEAD_METERS as MAX_LOOK_AHEAD_METERS, constants_d_MAX_SNAP_DISTANCE as MAX_SNAP_DISTANCE, constants_d_MIN_LOOK_AHEAD_METERS as MIN_LOOK_AHEAD_METERS, constants_d_OFF_ROUTE_CONFIRM_MS as OFF_ROUTE_CONFIRM_MS, constants_d_REJOIN_CONFIRM_MS as REJOIN_CONFIRM_MS, constants_d_REJOIN_COOLDOWN_MS as REJOIN_COOLDOWN_MS, constants_d_SNAP_WINDOW_SIZE as SNAP_WINDOW_SIZE, constants_d_SPEED_CORRIDOR_FACTOR as SPEED_CORRIDOR_FACTOR, constants_d_STARTUP_GRACE_MS as STARTUP_GRACE_MS };
+declare const constants_ARRIVAL_THRESHOLD_METERS: typeof ARRIVAL_THRESHOLD_METERS;
+declare const constants_BASE_CORRIDOR_METERS: typeof BASE_CORRIDOR_METERS;
+declare const constants_BEARING_ALIGNMENT_THRESHOLD: typeof BEARING_ALIGNMENT_THRESHOLD;
+declare const constants_BEARING_MIN_SPEED_MPS: typeof BEARING_MIN_SPEED_MPS;
+declare const constants_BEARING_MISMATCH_PENALTY: typeof BEARING_MISMATCH_PENALTY;
+declare const constants_BEARING_MISMATCH_THRESHOLD: typeof BEARING_MISMATCH_THRESHOLD;
+declare const constants_BEARING_SMOOTHING_ALPHA: typeof BEARING_SMOOTHING_ALPHA;
+declare const constants_BETA_CORRECTION: typeof BETA_CORRECTION;
+declare const constants_DETOUR_COMMIT_MS: typeof DETOUR_COMMIT_MS;
+declare const constants_DR_MAX_AGE_MS: typeof DR_MAX_AGE_MS;
+declare const constants_GPS_ACCURACY_FACTOR: typeof GPS_ACCURACY_FACTOR;
+declare const constants_GPS_AGE_CAP_SECONDS: typeof GPS_AGE_CAP_SECONDS;
+declare const constants_GPS_STALE_MS: typeof GPS_STALE_MS;
+declare const constants_INERTIA_PENALTY: typeof INERTIA_PENALTY;
+declare const constants_INERTIA_SEGMENT_DIST: typeof INERTIA_SEGMENT_DIST;
+declare const constants_LOOK_AHEAD_SECONDS: typeof LOOK_AHEAD_SECONDS;
+declare const constants_MANEUVER_TRIGGER_DIST: typeof MANEUVER_TRIGGER_DIST;
+declare const constants_MAX_CORRIDOR_METERS: typeof MAX_CORRIDOR_METERS;
+declare const constants_MAX_LOOK_AHEAD_METERS: typeof MAX_LOOK_AHEAD_METERS;
+declare const constants_MAX_SNAP_DISTANCE: typeof MAX_SNAP_DISTANCE;
+declare const constants_MIN_LOOK_AHEAD_METERS: typeof MIN_LOOK_AHEAD_METERS;
+declare const constants_OFF_ROUTE_CONFIRM_MS: typeof OFF_ROUTE_CONFIRM_MS;
+declare const constants_REJOIN_CONFIRM_MS: typeof REJOIN_CONFIRM_MS;
+declare const constants_REJOIN_COOLDOWN_MS: typeof REJOIN_COOLDOWN_MS;
+declare const constants_SNAP_WINDOW_SIZE: typeof SNAP_WINDOW_SIZE;
+declare const constants_SPEED_CORRIDOR_FACTOR: typeof SPEED_CORRIDOR_FACTOR;
+declare const constants_STARTUP_GRACE_MS: typeof STARTUP_GRACE_MS;
+declare const constants_TURN_CORRIDOR_MULTIPLIER: typeof TURN_CORRIDOR_MULTIPLIER;
+declare const constants_TURN_LOOKAHEAD_DISTANCE_METERS: typeof TURN_LOOKAHEAD_DISTANCE_METERS;
+declare namespace constants {
+  export { constants_ARRIVAL_THRESHOLD_METERS as ARRIVAL_THRESHOLD_METERS, constants_BASE_CORRIDOR_METERS as BASE_CORRIDOR_METERS, constants_BEARING_ALIGNMENT_THRESHOLD as BEARING_ALIGNMENT_THRESHOLD, constants_BEARING_MIN_SPEED_MPS as BEARING_MIN_SPEED_MPS, constants_BEARING_MISMATCH_PENALTY as BEARING_MISMATCH_PENALTY, constants_BEARING_MISMATCH_THRESHOLD as BEARING_MISMATCH_THRESHOLD, constants_BEARING_SMOOTHING_ALPHA as BEARING_SMOOTHING_ALPHA, constants_BETA_CORRECTION as BETA_CORRECTION, constants_DETOUR_COMMIT_MS as DETOUR_COMMIT_MS, constants_DR_MAX_AGE_MS as DR_MAX_AGE_MS, constants_GPS_ACCURACY_FACTOR as GPS_ACCURACY_FACTOR, constants_GPS_AGE_CAP_SECONDS as GPS_AGE_CAP_SECONDS, constants_GPS_STALE_MS as GPS_STALE_MS, constants_INERTIA_PENALTY as INERTIA_PENALTY, constants_INERTIA_SEGMENT_DIST as INERTIA_SEGMENT_DIST, constants_LOOK_AHEAD_SECONDS as LOOK_AHEAD_SECONDS, constants_MANEUVER_TRIGGER_DIST as MANEUVER_TRIGGER_DIST, constants_MAX_CORRIDOR_METERS as MAX_CORRIDOR_METERS, constants_MAX_LOOK_AHEAD_METERS as MAX_LOOK_AHEAD_METERS, constants_MAX_SNAP_DISTANCE as MAX_SNAP_DISTANCE, constants_MIN_LOOK_AHEAD_METERS as MIN_LOOK_AHEAD_METERS, constants_OFF_ROUTE_CONFIRM_MS as OFF_ROUTE_CONFIRM_MS, constants_REJOIN_CONFIRM_MS as REJOIN_CONFIRM_MS, constants_REJOIN_COOLDOWN_MS as REJOIN_COOLDOWN_MS, constants_SNAP_WINDOW_SIZE as SNAP_WINDOW_SIZE, constants_SPEED_CORRIDOR_FACTOR as SPEED_CORRIDOR_FACTOR, constants_STARTUP_GRACE_MS as STARTUP_GRACE_MS, constants_TURN_CORRIDOR_MULTIPLIER as TURN_CORRIDOR_MULTIPLIER, constants_TURN_LOOKAHEAD_DISTANCE_METERS as TURN_LOOKAHEAD_DISTANCE_METERS };
 }
 
-export { type BuildOptions, type CameraOptions, constants_d as Constants, Coordinate, CustomRouteBuilder, type CustomWaypoint, type DirectionsLeg, type DirectionsManeuver, type DirectionsOptions, type DirectionsProvider, type DirectionsResult, type DirectionsStep, type Kalman2DState, KalmanFilter2D, type MapRendererAdapter, type ORSConfig, type ORSProfile, type OSRMConfig, OSRMDirectionsProvider, OpenRouteServiceProvider, RouteSnapper, type RouteStyle, type SnapResult, type SnapperOptions, type ValhallaConfig, type ValhallaCostingModel, ValhallaDirectionsProvider, type VehicleStyle, type WaypointOptions, buildForwardCumulativeDistances, buildReverseCumulativeDistances, getBearingBetweenPoints, interpolatePoint, kalmanUpdate2D, normalizeAngle, projectPointOnSegment };
+export { type BuildOptions, type CameraOptions, constants as Constants, Coordinate, CustomRouteBuilder, type CustomWaypoint, type DirectionsLeg, type DirectionsManeuver, type DirectionsOptions, type DirectionsProvider, type DirectionsResult, type DirectionsStep, type Kalman2DState, KalmanFilter2D, type MapRendererAdapter, type ORSConfig, type ORSProfile, type OSRMConfig, OSRMDirectionsProvider, OpenRouteServiceProvider, RouteSnapper, type RouteStyle, type SnapResult, type SnapperOptions, type ValhallaConfig, type ValhallaCostingModel, ValhallaDirectionsProvider, type VehicleStyle, type WaypointOptions, buildForwardCumulativeDistances, buildReverseCumulativeDistances, getBearingBetweenPoints, interpolatePoint, kalmanUpdate2D, normalizeAngle, projectPointOnSegment };

package/dist/core.d.ts

@@ -1,5 +1,5 @@
-import { C as Coordinate, g as NavCoreState } from './NavCore.d-BuXR5DO7.js';
-export { F as FEATURES, a as FeatureKey, L as LicenseManager, b as LicensePayload, c as LicenseStatus, o as destinationPoint, p as geoGetBearing, q as haversineDistance } from './NavCore.d-BuXR5DO7.js';
+import { C as Coordinate, g as NavCoreState } from './NavCore-qf5_0qsR.js';
+export { F as FEATURES, a as FeatureKey, L as LicenseManager, b as LicensePayload, c as LicenseStatus, o as destinationPoint, p as geoGetBearing, q as haversineDistance } from './NavCore-qf5_0qsR.js';
 
 /**
  * Bearing and angular math utilities.
@@ -430,6 +430,8 @@ declare const BASE_CORRIDOR_METERS = 25;
 declare const MAX_CORRIDOR_METERS = 60;
 declare const SPEED_CORRIDOR_FACTOR = 1.2;
 declare const GPS_ACCURACY_FACTOR = 0.5;
+declare const TURN_LOOKAHEAD_DISTANCE_METERS = 40;
+declare const TURN_CORRIDOR_MULTIPLIER = 1.4;
 declare const MAX_SNAP_DISTANCE = 80;
 declare const BEARING_MISMATCH_THRESHOLD = 90;
 declare const BEARING_MISMATCH_PENALTY = 500;
@@ -454,35 +456,37 @@ declare const MIN_LOOK_AHEAD_METERS = 20;
 declare const MAX_LOOK_AHEAD_METERS = 100;
 declare const ARRIVAL_THRESHOLD_METERS = 30;
 
-declare const constants_d_ARRIVAL_THRESHOLD_METERS: typeof ARRIVAL_THRESHOLD_METERS;
-declare const constants_d_BASE_CORRIDOR_METERS: typeof BASE_CORRIDOR_METERS;
-declare const constants_d_BEARING_ALIGNMENT_THRESHOLD: typeof BEARING_ALIGNMENT_THRESHOLD;
-declare const constants_d_BEARING_MIN_SPEED_MPS: typeof BEARING_MIN_SPEED_MPS;
-declare const constants_d_BEARING_MISMATCH_PENALTY: typeof BEARING_MISMATCH_PENALTY;
-declare const constants_d_BEARING_MISMATCH_THRESHOLD: typeof BEARING_MISMATCH_THRESHOLD;
-declare const constants_d_BEARING_SMOOTHING_ALPHA: typeof BEARING_SMOOTHING_ALPHA;
-declare const constants_d_BETA_CORRECTION: typeof BETA_CORRECTION;
-declare const constants_d_DETOUR_COMMIT_MS: typeof DETOUR_COMMIT_MS;
-declare const constants_d_DR_MAX_AGE_MS: typeof DR_MAX_AGE_MS;
-declare const constants_d_GPS_ACCURACY_FACTOR: typeof GPS_ACCURACY_FACTOR;
-declare const constants_d_GPS_AGE_CAP_SECONDS: typeof GPS_AGE_CAP_SECONDS;
-declare const constants_d_GPS_STALE_MS: typeof GPS_STALE_MS;
-declare const constants_d_INERTIA_PENALTY: typeof INERTIA_PENALTY;
-declare const constants_d_INERTIA_SEGMENT_DIST: typeof INERTIA_SEGMENT_DIST;
-declare const constants_d_LOOK_AHEAD_SECONDS: typeof LOOK_AHEAD_SECONDS;
-declare const constants_d_MANEUVER_TRIGGER_DIST: typeof MANEUVER_TRIGGER_DIST;
-declare const constants_d_MAX_CORRIDOR_METERS: typeof MAX_CORRIDOR_METERS;
-declare const constants_d_MAX_LOOK_AHEAD_METERS: typeof MAX_LOOK_AHEAD_METERS;
-declare const constants_d_MAX_SNAP_DISTANCE: typeof MAX_SNAP_DISTANCE;
-declare const constants_d_MIN_LOOK_AHEAD_METERS: typeof MIN_LOOK_AHEAD_METERS;
-declare const constants_d_OFF_ROUTE_CONFIRM_MS: typeof OFF_ROUTE_CONFIRM_MS;
-declare const constants_d_REJOIN_CONFIRM_MS: typeof REJOIN_CONFIRM_MS;
-declare const constants_d_REJOIN_COOLDOWN_MS: typeof REJOIN_COOLDOWN_MS;
-declare const constants_d_SNAP_WINDOW_SIZE: typeof SNAP_WINDOW_SIZE;
-declare const constants_d_SPEED_CORRIDOR_FACTOR: typeof SPEED_CORRIDOR_FACTOR;
-declare const constants_d_STARTUP_GRACE_MS: typeof STARTUP_GRACE_MS;
-declare namespace constants_d {
-  export { constants_d_ARRIVAL_THRESHOLD_METERS as ARRIVAL_THRESHOLD_METERS, constants_d_BASE_CORRIDOR_METERS as BASE_CORRIDOR_METERS, constants_d_BEARING_ALIGNMENT_THRESHOLD as BEARING_ALIGNMENT_THRESHOLD, constants_d_BEARING_MIN_SPEED_MPS as BEARING_MIN_SPEED_MPS, constants_d_BEARING_MISMATCH_PENALTY as BEARING_MISMATCH_PENALTY, constants_d_BEARING_MISMATCH_THRESHOLD as BEARING_MISMATCH_THRESHOLD, constants_d_BEARING_SMOOTHING_ALPHA as BEARING_SMOOTHING_ALPHA, constants_d_BETA_CORRECTION as BETA_CORRECTION, constants_d_DETOUR_COMMIT_MS as DETOUR_COMMIT_MS, constants_d_DR_MAX_AGE_MS as DR_MAX_AGE_MS, constants_d_GPS_ACCURACY_FACTOR as GPS_ACCURACY_FACTOR, constants_d_GPS_AGE_CAP_SECONDS as GPS_AGE_CAP_SECONDS, constants_d_GPS_STALE_MS as GPS_STALE_MS, constants_d_INERTIA_PENALTY as INERTIA_PENALTY, constants_d_INERTIA_SEGMENT_DIST as INERTIA_SEGMENT_DIST, constants_d_LOOK_AHEAD_SECONDS as LOOK_AHEAD_SECONDS, constants_d_MANEUVER_TRIGGER_DIST as MANEUVER_TRIGGER_DIST, constants_d_MAX_CORRIDOR_METERS as MAX_CORRIDOR_METERS, constants_d_MAX_LOOK_AHEAD_METERS as MAX_LOOK_AHEAD_METERS, constants_d_MAX_SNAP_DISTANCE as MAX_SNAP_DISTANCE, constants_d_MIN_LOOK_AHEAD_METERS as MIN_LOOK_AHEAD_METERS, constants_d_OFF_ROUTE_CONFIRM_MS as OFF_ROUTE_CONFIRM_MS, constants_d_REJOIN_CONFIRM_MS as REJOIN_CONFIRM_MS, constants_d_REJOIN_COOLDOWN_MS as REJOIN_COOLDOWN_MS, constants_d_SNAP_WINDOW_SIZE as SNAP_WINDOW_SIZE, constants_d_SPEED_CORRIDOR_FACTOR as SPEED_CORRIDOR_FACTOR, constants_d_STARTUP_GRACE_MS as STARTUP_GRACE_MS };
+declare const constants_ARRIVAL_THRESHOLD_METERS: typeof ARRIVAL_THRESHOLD_METERS;
+declare const constants_BASE_CORRIDOR_METERS: typeof BASE_CORRIDOR_METERS;
+declare const constants_BEARING_ALIGNMENT_THRESHOLD: typeof BEARING_ALIGNMENT_THRESHOLD;
+declare const constants_BEARING_MIN_SPEED_MPS: typeof BEARING_MIN_SPEED_MPS;
+declare const constants_BEARING_MISMATCH_PENALTY: typeof BEARING_MISMATCH_PENALTY;
+declare const constants_BEARING_MISMATCH_THRESHOLD: typeof BEARING_MISMATCH_THRESHOLD;
+declare const constants_BEARING_SMOOTHING_ALPHA: typeof BEARING_SMOOTHING_ALPHA;
+declare const constants_BETA_CORRECTION: typeof BETA_CORRECTION;
+declare const constants_DETOUR_COMMIT_MS: typeof DETOUR_COMMIT_MS;
+declare const constants_DR_MAX_AGE_MS: typeof DR_MAX_AGE_MS;
+declare const constants_GPS_ACCURACY_FACTOR: typeof GPS_ACCURACY_FACTOR;
+declare const constants_GPS_AGE_CAP_SECONDS: typeof GPS_AGE_CAP_SECONDS;
+declare const constants_GPS_STALE_MS: typeof GPS_STALE_MS;
+declare const constants_INERTIA_PENALTY: typeof INERTIA_PENALTY;
+declare const constants_INERTIA_SEGMENT_DIST: typeof INERTIA_SEGMENT_DIST;
+declare const constants_LOOK_AHEAD_SECONDS: typeof LOOK_AHEAD_SECONDS;
+declare const constants_MANEUVER_TRIGGER_DIST: typeof MANEUVER_TRIGGER_DIST;
+declare const constants_MAX_CORRIDOR_METERS: typeof MAX_CORRIDOR_METERS;
+declare const constants_MAX_LOOK_AHEAD_METERS: typeof MAX_LOOK_AHEAD_METERS;
+declare const constants_MAX_SNAP_DISTANCE: typeof MAX_SNAP_DISTANCE;
+declare const constants_MIN_LOOK_AHEAD_METERS: typeof MIN_LOOK_AHEAD_METERS;
+declare const constants_OFF_ROUTE_CONFIRM_MS: typeof OFF_ROUTE_CONFIRM_MS;
+declare const constants_REJOIN_CONFIRM_MS: typeof REJOIN_CONFIRM_MS;
+declare const constants_REJOIN_COOLDOWN_MS: typeof REJOIN_COOLDOWN_MS;
+declare const constants_SNAP_WINDOW_SIZE: typeof SNAP_WINDOW_SIZE;
+declare const constants_SPEED_CORRIDOR_FACTOR: typeof SPEED_CORRIDOR_FACTOR;
+declare const constants_STARTUP_GRACE_MS: typeof STARTUP_GRACE_MS;
+declare const constants_TURN_CORRIDOR_MULTIPLIER: typeof TURN_CORRIDOR_MULTIPLIER;
+declare const constants_TURN_LOOKAHEAD_DISTANCE_METERS: typeof TURN_LOOKAHEAD_DISTANCE_METERS;
+declare namespace constants {
+  export { constants_ARRIVAL_THRESHOLD_METERS as ARRIVAL_THRESHOLD_METERS, constants_BASE_CORRIDOR_METERS as BASE_CORRIDOR_METERS, constants_BEARING_ALIGNMENT_THRESHOLD as BEARING_ALIGNMENT_THRESHOLD, constants_BEARING_MIN_SPEED_MPS as BEARING_MIN_SPEED_MPS, constants_BEARING_MISMATCH_PENALTY as BEARING_MISMATCH_PENALTY, constants_BEARING_MISMATCH_THRESHOLD as BEARING_MISMATCH_THRESHOLD, constants_BEARING_SMOOTHING_ALPHA as BEARING_SMOOTHING_ALPHA, constants_BETA_CORRECTION as BETA_CORRECTION, constants_DETOUR_COMMIT_MS as DETOUR_COMMIT_MS, constants_DR_MAX_AGE_MS as DR_MAX_AGE_MS, constants_GPS_ACCURACY_FACTOR as GPS_ACCURACY_FACTOR, constants_GPS_AGE_CAP_SECONDS as GPS_AGE_CAP_SECONDS, constants_GPS_STALE_MS as GPS_STALE_MS, constants_INERTIA_PENALTY as INERTIA_PENALTY, constants_INERTIA_SEGMENT_DIST as INERTIA_SEGMENT_DIST, constants_LOOK_AHEAD_SECONDS as LOOK_AHEAD_SECONDS, constants_MANEUVER_TRIGGER_DIST as MANEUVER_TRIGGER_DIST, constants_MAX_CORRIDOR_METERS as MAX_CORRIDOR_METERS, constants_MAX_LOOK_AHEAD_METERS as MAX_LOOK_AHEAD_METERS, constants_MAX_SNAP_DISTANCE as MAX_SNAP_DISTANCE, constants_MIN_LOOK_AHEAD_METERS as MIN_LOOK_AHEAD_METERS, constants_OFF_ROUTE_CONFIRM_MS as OFF_ROUTE_CONFIRM_MS, constants_REJOIN_CONFIRM_MS as REJOIN_CONFIRM_MS, constants_REJOIN_COOLDOWN_MS as REJOIN_COOLDOWN_MS, constants_SNAP_WINDOW_SIZE as SNAP_WINDOW_SIZE, constants_SPEED_CORRIDOR_FACTOR as SPEED_CORRIDOR_FACTOR, constants_STARTUP_GRACE_MS as STARTUP_GRACE_MS, constants_TURN_CORRIDOR_MULTIPLIER as TURN_CORRIDOR_MULTIPLIER, constants_TURN_LOOKAHEAD_DISTANCE_METERS as TURN_LOOKAHEAD_DISTANCE_METERS };
 }
 
-export { type BuildOptions, type CameraOptions, constants_d as Constants, Coordinate, CustomRouteBuilder, type CustomWaypoint, type DirectionsLeg, type DirectionsManeuver, type DirectionsOptions, type DirectionsProvider, type DirectionsResult, type DirectionsStep, type Kalman2DState, KalmanFilter2D, type MapRendererAdapter, type ORSConfig, type ORSProfile, type OSRMConfig, OSRMDirectionsProvider, OpenRouteServiceProvider, RouteSnapper, type RouteStyle, type SnapResult, type SnapperOptions, type ValhallaConfig, type ValhallaCostingModel, ValhallaDirectionsProvider, type VehicleStyle, type WaypointOptions, buildForwardCumulativeDistances, buildReverseCumulativeDistances, getBearingBetweenPoints, interpolatePoint, kalmanUpdate2D, normalizeAngle, projectPointOnSegment };
+export { type BuildOptions, type CameraOptions, constants as Constants, Coordinate, CustomRouteBuilder, type CustomWaypoint, type DirectionsLeg, type DirectionsManeuver, type DirectionsOptions, type DirectionsProvider, type DirectionsResult, type DirectionsStep, type Kalman2DState, KalmanFilter2D, type MapRendererAdapter, type ORSConfig, type ORSProfile, type OSRMConfig, OSRMDirectionsProvider, OpenRouteServiceProvider, RouteSnapper, type RouteStyle, type SnapResult, type SnapperOptions, type ValhallaConfig, type ValhallaCostingModel, ValhallaDirectionsProvider, type VehicleStyle, type WaypointOptions, buildForwardCumulativeDistances, buildReverseCumulativeDistances, getBearingBetweenPoints, interpolatePoint, kalmanUpdate2D, normalizeAngle, projectPointOnSegment };