@ingissa/navcore-core 1.0.3 → 1.0.4

package/README.md

@@ -1,279 +1,136 @@
-# @ingissa/navcore-core
-
-> **The navigation layer you own.** A framework-agnostic, zero-dependency navigation engine that runs everywhere — browsers, React Native, Node.js, and CI/CD.
-
-[![npm version](https://img.shields.io/npm/v/@ingissa/navcore-core)](https://www.npmjs.com/package/@ingissa/navcore-core)
-[![License](https://img.shields.io/badge/license-MIT%20%2F%20Commercial-purple)]()
-[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue)](https://www.typescriptlang.org/)
-[![Zero deps](https://img.shields.io/badge/runtime_deps-0-brightgreen)](https://www.npmjs.com/package/@ingissa/navcore-core)
-
----
-
-## Why NavCore?
-
-| Feature | NavCore | Mapbox Nav SDK | Google Maps |
-|---|---|---|---|
-| **Framework** | Any (pure TS) | React Native only | Platform-locked |
-| **Runtime deps** | 0 | 50+ | N/A |
-| **Map renderer** | BYO (adapter) | Mapbox GL only | Google Maps only |
-| **Directions** | BYO (adapter) | Mapbox API only | Google API only |
-| **Off-route detection** | Built-in FSM | Basic | Basic |
-| **U-turn protection** | ✅ Bearing penalty | ❌ | ❌ |
-| **Parallel road resolver** | ✅ Built-in | ❌ | ❌ |
-| **Dead reckoning** | ✅ Built-in | ❌ | ❌ |
-| **Geofencing** | ✅ Built-in | ❌ | Paid API |
-| **ETA** | ✅ Offline | API only | API only |
-| **Voice triggers** | ✅ Built-in | SDK only | ❌ |
-| **Headless testing** | ✅ Full pipeline | ❌ | ❌ |
-| **Custom routes** | ✅ GPX/GeoJSON/Builder | ❌ | ❌ |
-| **License** | Core MIT / Pro commercial | Commercial | Commercial |
-
----
-
-## Tier Model
-
-NavCore uses a two-tier model controlled by a signed license key:
-
-| Tier | Import | License | Includes |
-|---|---|---|---|
-| **Core** | `@ingissa/navcore-core/core` | MIT — free forever | Geo utils, Kalman filter, route snapping, directions adapters, route builder |
-| **Pro** | `@ingissa/navcore-core/pro` | Commercial key required | Dead reckoning, advanced bearing, deviation detection, FSMs, voice, ETA, geofencing |
-| **Engine** | `@ingissa/navcore-core` | Gated internally at runtime | Full `NavCore` orchestrator (license key unlocks Pro features) |
-
----
-
-## Installation
-
-```bash
-npm install @ingissa/navcore-core
-```
-
----
-
-## Quick Start
-
-### Core tier (no license needed)
-
-```typescript
-import { NavCore } from '@ingissa/navcore-core';
-import { OSRMDirectionsProvider } from '@ingissa/navcore-core/core';
-
-// 1. Get a route from your self-hosted OSRM (free)
-const provider = new OSRMDirectionsProvider({ baseUrl: 'http://router.project-osrm.org' });
-const route = await provider.getRoute([[2.3522, 48.8566], [2.3400, 48.8700]]);
-
-// 2. Create engine (Core features work without a key)
-const engine = new NavCore();
-engine.setRoute(route.geometry);
-engine.startNavigation();
-
-// 3. Feed GPS updates
-engine.on('arrival', () => console.log('Arrived!'));
-
-navigator.geolocation.watchPosition(({ coords }) => {
-  const state = engine.update({
-    coord: [coords.longitude, coords.latitude],
-    accuracy: coords.accuracy,
-    bearing: coords.heading,
-    speed: coords.speed ?? 0,
-    timestamp: Date.now(),
-  });
-
-  console.log('Distance remaining:', state.distanceToDestination, 'm');
-});
-```
-
-### Pro tier (with license key)
-
-```typescript
-import { NavCore } from '@ingissa/navcore-core';
-
-// Pro features unlock automatically with a valid key
-const engine = new NavCore({ licenseKey: 'your-signed-license-key' });
-engine.setRoute(routeCoords, instructions);
-engine.startNavigation();
-
-engine.on('instruction', (instr) => speak(instr.text));  // voice cues (PRO)
-engine.on('deviation', ({ anchorIndex }) => recalculate(anchorIndex));
-engine.on('arrival', () => console.log('Arrived!'));
-```
-
-### Using subpath imports directly
-
-```typescript
-// Free MIT tier
-import { KalmanFilter2D } from '@ingissa/navcore-core/core';
-import { OSRMDirectionsProvider } from '@ingissa/navcore-core/core';
-import { CustomRouteBuilder } from '@ingissa/navcore-core/core';
-
-// Commercial Pro tier
-import { DeadReckoningEngine } from '@ingissa/navcore-core/pro';
-import { VoiceTriggerEngine } from '@ingissa/navcore-core/pro';
-import { ETAEngine } from '@ingissa/navcore-core/pro';
-import { GeofencingEngine } from '@ingissa/navcore-core/pro';
-```
-
----
-
-## Directions Providers (built-in, no extra install)
-
-```typescript
-import {
-  OSRMDirectionsProvider,        // Self-hosted OSRM (recommended, free)
-  ValhallaDirectionsProvider,    // Self-hosted Valhalla (free)
-  OpenRouteServiceProvider,      // openrouteservice.org (free tier)
-} from '@ingissa/navcore-core/core';
-
-// OSRM
-const osrm = new OSRMDirectionsProvider({ baseUrl: 'http://router.project-osrm.org' });
-const route = await osrm.getRoute([[lng1, lat1], [lng2, lat2]]);
-
-// Valhalla
-const valhalla = new ValhallaDirectionsProvider({ baseUrl: 'https://valhalla1.openstreetmap.de' });
-const route = await valhalla.getRoute([[lng1, lat1], [lng2, lat2]], { costing: 'auto' });
-```
-
----
-
-## Renderer Adapters (separate packages)
-
-```bash
-npm install @ingissa/navcore-maplibre      # Web + MapLibre GL
-npm install @ingissa/navcore-leaflet       # Web + Leaflet.js
-npm install @ingissa/navcore-google-maps   # Google Maps JS API
-npm install @ingissa/navcore-mapbox        # React Native + @rnmapbox/maps
-npm install @ingissa/navcore-react-native  # React Native bindings
-npm install @ingissa/navcore-headless      # Node.js / CI testing
-```
-
-> ⚠️ Renderer adapter packages require a commercial license. [Get yours at Not yet available]()
-
----
-
-## Feature Reference
-
-### CORE — free, MIT
-
-| Feature | API |
-|---|---|
-| GPS smoothing | `KalmanFilter2D` |
-| Route snapping | `RouteSnapper` |
-| Haversine & bearing | `haversineDistance`, `getBearingBetweenPoints` |
-| Cumulative distances | `buildForwardCumulativeDistances` |
-| Route builder | `CustomRouteBuilder` |
-| Directions — OSRM | `OSRMDirectionsProvider` |
-| Directions — Valhalla | `ValhallaDirectionsProvider` |
-| Directions — ORS | `OpenRouteServiceProvider` |
-| Renderer interface | `MapRendererAdapter` |
-| License verification | `LicenseManager` |
-
-### PRO — commercial license required
-
-| Feature | API | FEATURES key |
-|---|---|---|
-| Advanced snapping (bearing + inertia) | `RouteSnapper` options | `ADVANCED_SNAPPING` |
-| Parallel road resolver | `ParallelRoadResolver` | `PARALLEL_ROAD_RESOLUTION` |
-| Dead reckoning | `DeadReckoningEngine` | `DEAD_RECKONING` |
-| Compound deviation detection | `DeviationDetector` | `COMPOUND_DEVIATION` |
-| Advanced bearing engine | `BearingEngine` | `ADVANCED_BEARING` |
-| Progress anti-regression | `ProgressTracker` | `PROGRESS_TRACKING` |
-| Route offset predictor | `RouteOffsetPredictor` | `ROUTE_OFFSET` |
-| Navigation lifecycle FSM | `NavigationFSM` | — |
-| Off-route FSM | `OffRouteFSM` | — |
-| Instruction editor | `InstructionEditor` | — |
-| Voice trigger engine | `VoiceTriggerEngine` | `VOICE_TRIGGERS` |
-| ETA engine (offline) | `ETAEngine` | `ETA` |
-| Geofencing engine | `GeofencingEngine` | `GEOFENCING` |
-
----
-
-## License Gate Behaviour
-
-| Condition | Result |
-|---|---|
-| No `licenseKey` | Core features work; Pro features blocked with `console.warn` |
-| Valid Pro key | All features unlocked; `🔑 [NavCore] License validation complete. Plan: pro` logged |
-| `isDev: true` | All features bypassed (development mode) |
-| Expired / tampered key | Pro features blocked; status: `EXPIRED` / `INVALID` |
-
-License keys are verified **offline** using ECDSA P-256 — no network calls, no tracking.
-
----
-
-## NavCore Engine API
-
-```typescript
-const engine = new NavCore(options?: NavCoreOptions);
-
-// Setup
-engine.setRoute(coords: Coordinate[], instructions?: NavInstruction[]);
-engine.startNavigation();
-
-// GPS update (returns state snapshot)
-const state: NavCoreState = engine.update(gpsUpdate: NavGpsUpdate);
-
-// Render tick (call at ~60fps between GPS updates)
-engine.tick(nowMs: number);
-
-// Events
-engine.on('instruction', (instr: NavInstruction) => void);
-engine.on('deviation',   ({ anchorIndex, ghostCoord }) => void);
-engine.on('arrival',     () => void);
-engine.on('routeLoaded', ({ routeLength }) => void);
-engine.off(event, handler);
-
-// State & introspection
-engine.getState(): NavCoreState;
-engine.getLicenseManager(): LicenseManager;
-engine.getRoute(): ReadonlyArray<Coordinate>;
-engine.destroy();
-```
-
-### NavCoreState
-
-```typescript
-interface NavCoreState {
-  snappedCoord: Coordinate | null;    // GPS-snapped position on route
-  rawGpsCoord: Coordinate | null;     // Raw GPS position
-  bearing: number;                    // Smoothed heading (degrees)
-  routeIndex: number;                 // Current segment index
-  distanceToRoute: number;            // Distance from route (metres)
-  corridor: number;                   // Dynamic off-route threshold (metres)
-  isOffRoute: boolean;                // True when deviation confirmed
-  hasArrived: boolean;
-  distanceToDestination: number | null;         // Remaining distance (metres)
-  distanceToNextInstruction: number | null;     // Distance to next turn
-  nextInstructionIndex: number | null;
-  currentSpeed: number;               // m/s
-  isGpsStale: boolean;
-  gpsAgeMs: number;
-  licenseStatus: string;              // 'VALID' | 'INVALID' | 'EXPIRED' | 'MISSING'
-}
-```
-
----
-
-## Documentation
-
-| Guide | Link |
-|---|---|
-| Architecture | [docs/architecture.md](./docs/architecture.md) |
-| Getting Started | [docs/getting-started.md](./docs/getting-started.md) |
-| Directions Providers | [docs/directions-providers.md](./docs/directions-providers.md) |
-| Renderer Adapters | [docs/renderer-adapters.md](./docs/renderer-adapters.md) |
-| API Reference | [docs/api-reference.md](./docs/api-reference.md) |
-| Custom Routes | [docs/custom-routes.md](./docs/custom-routes.md) |
-| Instructions & Voice | [docs/instructions.md](./docs/instructions.md) |
-| Pro Features | [docs/p3-features.md](./docs/p3-features.md) |
-| Testing Guide | [docs/testing.md](./docs/testing.md) |
-
----
-
-## License
-
-- **Core engine** (`@ingissa/navcore-core`): [MIT](./LICENSE) for open-source projects
-- **Pro features & adapters**: Commercial license required — [Not yet available]()
-
----
-
-© Ingissa · [8abnav@gmail.com](mailto:8abnav@gmail.com)
+# @ingissa/navcore-core
+
+Framework-agnostic TypeScript navigation engine for browser, React Native,
+Node.js, and CI environments.
+
+[![npm version](https://img.shields.io/npm/v/@ingissa/navcore-core)](https://www.npmjs.com/package/@ingissa/navcore-core)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue)](https://www.typescriptlang.org/)
+[![Pricing](https://img.shields.io/badge/licence_key-pricing-green)](https://navcore-web.vercel.app/pricing)
+
+## Install
+
+```bash
+npm install @ingissa/navcore-core
+```
+
+## Quick Start
+
+```typescript
+import { NavCore, OSRMDirectionsProvider } from '@ingissa/navcore-core';
+
+const provider = new OSRMDirectionsProvider({
+  baseUrl: 'http://router.project-osrm.org',
+});
+
+const route = await provider.getRoute([
+  [2.3522, 48.8566],
+  [2.3400, 48.8700],
+]);
+
+const engine = new NavCore({
+  licenseKey: process.env.NAVCORE_LICENSE_KEY,
+});
+
+engine.setRoute(route.geometry);
+engine.startNavigation();
+
+const state = engine.update({
+  coord: [2.3522, 48.8566],
+  accuracy: 8,
+  bearing: 90,
+  speed: 9,
+  timestamp: Date.now(),
+});
+
+console.log(state.snappedCoord, state.distanceToDestination);
+```
+
+## What Is Included
+
+Core runtime behavior works without a licence key:
+
+| Area | APIs |
+|---|---|
+| Geo utilities | `haversineDistance`, `getBearingBetweenPoints`, cumulative distance helpers |
+| GPS smoothing | `KalmanFilter2D` |
+| Route snapping | `RouteSnapper` |
+| Route building | `CustomRouteBuilder` |
+| Directions | `OSRMDirectionsProvider`, `ValhallaDirectionsProvider`, `OpenRouteServiceProvider` |
+| Renderer contract | `MapRendererAdapter` types |
+| Licence status | `LicenseManager` |
+
+Pro behavior unlocks with a signed licence key:
+
+| Area | APIs |
+|---|---|
+| Advanced route matching | `ParallelRoadResolver`, bearing and inertia scoring |
+| Deviation handling | `DeviationDetector`, `OffRouteFSM`, `NavigationFSM` |
+| Dead reckoning | `DeadReckoningEngine` |
+| Turn guidance | `InstructionEditor`, voice trigger helpers |
+| Driver UX | `ETAEngine`, `GeofencingEngine` |
+
+Get a licence key:
+
+https://navcore-web.vercel.app/pricing
+
+## Direction Providers
+
+```typescript
+import {
+  OSRMDirectionsProvider,
+  ValhallaDirectionsProvider,
+  OpenRouteServiceProvider,
+} from '@ingissa/navcore-core';
+```
+
+All providers implement:
+
+```typescript
+interface DirectionsProvider {
+  getRoute(
+    waypoints: Coordinate[],
+    options?: DirectionsOptions
+  ): Promise<DirectionsResult>;
+}
+```
+
+Provider options include:
+
+| Option | Purpose |
+|---|---|
+| `profile` | Driving, cycling, or walking route mode |
+| `steps` | Include maneuver data |
+| `language` | Instruction language when supported |
+| `fetchFn` | Custom fetch implementation for tests or runtimes |
+| `timeoutMs` | Abort slow requests |
+
+## Public Subpaths
+
+```typescript
+// Full engine and all public APIs
+import { NavCore } from '@ingissa/navcore-core';
+
+// Core-oriented subpath
+import { RouteSnapper } from '@ingissa/navcore-core/core';
+
+// Pro-oriented subpath
+import { DeadReckoningEngine } from '@ingissa/navcore-core/pro';
+```
+
+## Licence Model
+
+`@ingissa/navcore-core` is published publicly on npm and uses a commercial
+licence model.
+
+| Condition | Result |
+|---|---|
+| No licence key | Core behavior works with Core fallbacks. |
+| Valid licence key | Pro features unlock according to the signed key. |
+| Expired or invalid key | Pro features are blocked and status is reported. |
+| Development key | Accepted only in local development/test environments. |
+
+Pricing and licence keys:
+
+https://navcore-web.vercel.app/pricing
+
+Copyright Ingissa. All rights reserved.

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

@@ -371,11 +371,8 @@ declare class NavCore {
     private readonly options;
     private listeners;
     constructor(options?: NavCoreOptions);
-    /**
-     * Returns true if the feature is unlocked (dev mode OR valid license).
-     * Emits a one-time console warning when a Pro feature is blocked.
-     */
-    private has;
+    /** Internal license check for automatic fallbacks that should not warn Core users every tick. */
+    private canUse;
     /** Load route geometry and instructions */
     setRoute(route: Coordinate[], instructions?: NavInstruction[]): void;
     /** Start navigation */

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

@@ -371,11 +371,8 @@ declare class NavCore {
     private readonly options;
     private listeners;
     constructor(options?: NavCoreOptions);
-    /**
-     * Returns true if the feature is unlocked (dev mode OR valid license).
-     * Emits a one-time console warning when a Pro feature is blocked.
-     */
-    private has;
+    /** Internal license check for automatic fallbacks that should not warn Core users every tick. */
+    private canUse;
     /** Load route geometry and instructions */
     setRoute(route: Coordinate[], instructions?: NavInstruction[]): void;
     /** Start navigation */

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-DzTPBxIc.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-DzTPBxIc.mjs';
 
 /**
  * Bearing and angular math utilities.
@@ -281,6 +281,10 @@ interface OSRMConfig {
     profile?: 'driving' | 'cycling' | 'walking';
     /** Max waypoints per API request (OSRM supports unlimited, but chunking keeps requests fast) */
     maxWaypointsPerChunk?: number;
+    /** Optional fetch implementation for tests, React Native, or custom runtimes */
+    fetchFn?: typeof fetch;
+    /** Request timeout in milliseconds. Set to 0 to disable. */
+    timeoutMs?: number;
 }
 declare class OSRMDirectionsProvider implements DirectionsProvider {
     private readonly config;
@@ -288,6 +292,7 @@ declare class OSRMDirectionsProvider implements DirectionsProvider {
     getRoute(waypoints: Coordinate[], options?: DirectionsOptions): Promise<DirectionsResult>;
     private fetchRoute;
     private fetchChunked;
+    private fetchWithTimeout;
 }
 
 /**
@@ -310,6 +315,10 @@ interface ValhallaConfig {
     apiKey?: string;
     /** Max waypoints per chunk (default: 50) */
     maxWaypointsPerChunk?: number;
+    /** Optional fetch implementation for tests, React Native, or custom runtimes */
+    fetchFn?: typeof fetch;
+    /** Request timeout in milliseconds. Set to 0 to disable. */
+    timeoutMs?: number;
 }
 declare class ValhallaDirectionsProvider implements DirectionsProvider {
     private readonly config;
@@ -319,7 +328,11 @@ declare class ValhallaDirectionsProvider implements DirectionsProvider {
     private fetchRoute;
     /** Decode Valhalla's encoded polyline6 format */
     private decodePolyline;
+    private stitchGeometry;
+    private sameCoordinate;
+    private shapeIndex;
     private fetchChunked;
+    private fetchWithTimeout;
 }
 
 /**
@@ -341,6 +354,10 @@ interface ORSConfig {
     baseUrl?: string;
     /** Max waypoints per request (ORS limit: 50) */
     maxWaypointsPerChunk?: number;
+    /** Optional fetch implementation for tests, React Native, or custom runtimes */
+    fetchFn?: typeof fetch;
+    /** Request timeout in milliseconds. Set to 0 to disable. */
+    timeoutMs?: number;
 }
 declare class OpenRouteServiceProvider implements DirectionsProvider {
     private readonly config;
@@ -349,6 +366,9 @@ declare class OpenRouteServiceProvider implements DirectionsProvider {
     private profileFromOptions;
     private fetchRoute;
     private fetchChunked;
+    private stepRange;
+    private bearingFromGeometry;
+    private fetchWithTimeout;
 }
 
 /**
@@ -454,35 +474,35 @@ 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 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 };
 }
 
-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 };