@ingissa/navcore-core 1.0.0

package/dist/pro.d.ts

@@ -0,0 +1,519 @@
+import { C as Coordinate, i as NavInstruction, g as NavCoreState } from './NavCore-Bjl5fTea.js';
+export { d as LifecycleContext, e as LifecycleEvent, j as NavLifecycleState, k as NavigationFSM, O as OffRouteContext, l as OffRouteEvent, m as OffRouteFSM, n as OffRouteState, R as RejoinTarget, T as TempRoute, r as resolveNextInstruction } from './NavCore-Bjl5fTea.js';
+
+/**
+ * ParallelRoadResolver
+ *
+ * First-class feature: resolve GPS ambiguity on parallel roads (e.g. dual carriageways,
+ * motorway + service road) and prevent U-turn snap.
+ *
+ * Extracts and extends the bearing penalty + inertia logic from RouteSnapper
+ * into a standalone, composable API that can be used independently.
+ *
+ * FEATURE: PARALLEL_ROAD_RESOLUTION + U_TURN_PROTECTION
+ *
+ * @example
+ * ```typescript
+ * const resolver = new ParallelRoadResolver({ bearingPenalty: 80, inertiaPenalty: 40 });
+ * const best = resolver.resolve(candidates, vehicleBearing, prevSegmentIndex);
+ * ```
+ */
+
+interface SnapCandidate {
+    /** Route segment index */
+    segmentIndex: number;
+    /** Projected point on segment */
+    projectedCoord: Coordinate;
+    /** Raw distance to route in metres */
+    distanceMetres: number;
+    /** Start of segment */
+    segA: Coordinate;
+    /** End of segment */
+    segB: Coordinate;
+}
+interface ResolvedCandidate extends SnapCandidate {
+    /** Final score (lower is better) */
+    score: number;
+    /** Bearing delta that triggered U-turn protection (null if not triggered) */
+    bearingDeltaDeg: number | null;
+    /** Whether inertia penalty was applied */
+    inertiaPenaltyApplied: boolean;
+}
+interface ParallelRoadResolverOptions {
+    /**
+     * Penalty added to score when vehicle bearing mismatches segment bearing
+     * beyond `bearingMismatchThresholdDeg`. Default: 80m equivalent.
+     */
+    bearingPenalty?: number;
+    /**
+     * Bearing mismatch threshold in degrees that activates the penalty.
+     * Default: 60°. Higher = more tolerant of U-turns.
+     */
+    bearingMismatchThresholdDeg?: number;
+    /**
+     * Penalty added when the candidate segment is far from the previously
+     * snapped segment, preventing oscillation. Default: 40m equivalent.
+     */
+    inertiaPenalty?: number;
+    /**
+     * Minimum segment jump (in index units) to trigger inertia penalty.
+     * Default: 3.
+     */
+    inertiaSegmentDist?: number;
+}
+declare class ParallelRoadResolver {
+    private readonly options;
+    constructor(options?: ParallelRoadResolverOptions);
+    /**
+     * Score and sort snap candidates — lowest score wins.
+     *
+     * @param candidates   Raw snap candidates (distance-sorted or unsorted)
+     * @param vehicleBearing  Current vehicle heading in degrees (null disables bearing check)
+     * @param prevSegmentIdx  Previously snapped segment index (null disables inertia)
+     * @returns Candidates sorted by score ascending, with debug metadata attached
+     */
+    resolve(candidates: SnapCandidate[], vehicleBearing?: number | null, prevSegmentIdx?: number | null): ResolvedCandidate[];
+    /**
+     * Resolve and return only the best candidate.
+     */
+    resolveBest(candidates: SnapCandidate[], vehicleBearing?: number | null, prevSegmentIdx?: number | null): ResolvedCandidate | null;
+    private score;
+    /**
+     * Quick utility: detect if the vehicle is likely performing a U-turn
+     * based on the difference between current bearing and route segment bearing.
+     *
+     * @returns true if the bearing difference exceeds the configured threshold
+     */
+    isLikelyUTurn(vehicleBearing: number, segA: Coordinate, segB: Coordinate): boolean;
+}
+
+/**
+ * Module 3: DeadReckoning
+ * Predicts vehicle position during GPS outages or stale fixes.
+ */
+
+interface DRAnchor {
+    coord: Coordinate;
+    idx: number;
+    ts: number;
+}
+interface DRPrediction {
+    predictedCoord: Coordinate;
+    isActive: boolean;
+    ageMs: number;
+}
+/**
+ * Given a snapped anchor on the route, extrapolate forward using speed and bearing.
+ */
+declare function computeDeadReckoningOnRoute(anchor: DRAnchor | null, speed: number, bearing: number, now: number, maxAgeMs?: number): DRPrediction;
+/**
+ * Stateful dead reckoning engine.
+ */
+declare class DeadReckoningEngine {
+    private anchor;
+    private readonly maxAgeMs;
+    constructor(maxAgeMs?: number);
+    /** Set the anchor point (called when GPS is available and snapping succeeds) */
+    setAnchor(coord: Coordinate, idx: number, timestamp: number): void;
+    /** Predict position given current speed and bearing */
+    predict(speed: number, bearing: number, now: number): DRPrediction;
+    /** Clear the anchor (GPS restored) */
+    clearAnchor(): void;
+    getAnchor(): DRAnchor | null;
+}
+
+/**
+ * Module 4b: DeviationDetector
+ * Compound deviation detection using distance, bearing, and movement signals.
+ */
+
+interface DeviationSignals {
+    /** Distance from GPS to nearest route segment (metres) */
+    distanceToRoute: number;
+    /** Whether the distance exceeds the dynamic corridor */
+    outsideCorridor: boolean;
+    /** Whether the vehicle bearing diverges from the route bearing */
+    bearingMismatch: boolean;
+    /** Whether the vehicle is moving away from the next segment */
+    movingAway: boolean;
+    /** Compound confirmed: outsideCorridor AND (bearingMismatch OR movingAway) */
+    confirmed: boolean;
+}
+interface ClosestSegment {
+    segmentIndex: number;
+    distance: number;
+    projection: Coordinate;
+}
+declare class DeviationDetector {
+    /**
+     * Evaluate deviation signals for the current GPS position.
+     */
+    evaluate(gps: Coordinate, gpsBearing: number | null, speedMps: number, closest: ClosestSegment, route: Coordinate[], corridor: number, prevDistToNextSegment: number | null): DeviationSignals;
+}
+
+/**
+ * Module 4a: DynamicCorridor
+ * Speed-adaptive corridor width calculation.
+ */
+/**
+ * Compute speed-adaptive corridor width in metres.
+ *
+ * Corridor widens with speed: BASE + speed * FACTOR, capped at MAX.
+ * GPS accuracy optionally widens the corridor further.
+ */
+declare function calculateDynamicCorridor(speedMps: number, gpsAccuracy?: number | null, baseMeters?: number, maxMeters?: number, speedFactor?: number, accuracyFactor?: number): number;
+
+/**
+ * Module 5: BearingEngine
+ * Speed-adaptive IIR bearing smoothing.
+ */
+
+/**
+ * Calculate speed-adaptive smoothing factor.
+ * Higher speed → less smoothing (alpha closer to 1).
+ * Lower speed → more smoothing (alpha closer to base value).
+ */
+declare function getSpeedAdaptiveAlpha(speedMps: number, baseAlpha?: number): number;
+/**
+ * Compute bearing from the route geometry at the current segment.
+ */
+declare function calculateRobustBearing(route: Coordinate[], currentIdx: number, lookAhead?: number): number;
+/**
+ * Blend two bearings using the shortest angular path.
+ */
+declare function blendBearing(current: number, target: number, alpha: number): number;
+/**
+ * Full bearing smoothing pipeline: route bearing → IIR blend → output.
+ */
+declare function applyBearingSmoothing(currentBearing: number, route: Coordinate[], routeIdx: number, speedMps: number, gpsBearing: number | null, baseAlpha?: number): number;
+
+/**
+ * Module 6: ProgressTracker
+ * Monotonic route progress tracking with anti-jitter.
+ */
+
+/**
+ * Validate a progress update: ensures monotonic forward progress with jitter tolerance.
+ *
+ * @returns The new progress index (may be the same as current if update is rejected)
+ */
+declare function validateProgressUpdate(currentIdx: number, candidateIdx: number, route: Coordinate[], distToRoute: number, maxSnapDistance: number): number;
+
+/**
+ * InstructionEditor — Fluent builder for NavInstruction arrays.
+ *
+ * Create, edit, and annotate navigation instructions for custom routes.
+ * Supports standard turn instructions and exam-specific annotations.
+ *
+ * @example
+ * ```typescript
+ * const editor = new InstructionEditor();
+ * editor
+ *   .addTurn([2.347, 48.859], 'Turn left onto Rue de Rivoli', 42)
+ *   .addExamPoint([2.350, 48.860], 'Check mirrors before changing lane', 50)
+ *   .addCheckpoint([2.355, 48.861], 65);
+ *
+ * editor.attachToCumulative(routeGeometry);
+ * engine.setRoute(routeGeometry, editor.toArray());
+ * ```
+ */
+
+type InstructionType = 'turn' | 'exam_point' | 'checkpoint' | 'depart' | 'arrive' | 'custom';
+interface RichInstruction extends NavInstruction {
+    /** Instruction category */
+    type: InstructionType;
+    /** Unique id for referencing in edit operations */
+    id: string;
+    /** Display text (same as NavInstruction.text) */
+    text: string;
+    /** Whether to suppress voice read-out */
+    silent?: boolean;
+    /** Exam-specific severity level */
+    severity?: 'info' | 'warning' | 'critical';
+    /** Custom metadata for integrators */
+    meta?: Record<string, unknown>;
+}
+declare class InstructionEditor {
+    private instructions;
+    /** Add a turn instruction at the given route geometry index */
+    addTurn(location: Coordinate, text: string, geometryIndex: number, opts?: {
+        silent?: boolean;
+        meta?: Record<string, unknown>;
+    }): this;
+    /** Add an exam-specific point (e.g. "Check mirrors", "Yield here") */
+    addExamPoint(location: Coordinate, text: string, geometryIndex: number, opts?: {
+        severity?: RichInstruction['severity'];
+        silent?: boolean;
+        meta?: Record<string, unknown>;
+    }): this;
+    /** Add a silent progress checkpoint (does not trigger voice) */
+    addCheckpoint(location: Coordinate, geometryIndex: number, meta?: Record<string, unknown>): this;
+    /** Add a departure instruction (auto-inserted at index 0) */
+    addDepart(location: Coordinate, text?: string): this;
+    /** Add an arrival instruction */
+    addArrive(location: Coordinate, text?: string): this;
+    /** Update any field of an instruction by id */
+    update(id: string, patch: Partial<Omit<RichInstruction, 'id'>>): this;
+    /** Remove an instruction by id */
+    remove(id: string): this;
+    /** Move an instruction to a new position in the list */
+    reorder(id: string, newIndex: number): this;
+    /** Sort instructions by geometryIndex ascending */
+    sort(): this;
+    /** Remove all instructions */
+    clear(): this;
+    /**
+     * Compute and attach `cumulativeOffset` and `bearingBefore`/`bearingAfter`
+     * from the route geometry. Call this after loading the route but before
+     * passing instructions to the engine.
+     */
+    attachToCumulative(route: Coordinate[]): this;
+    /** Export as plain NavInstruction[] for use with engine.setRoute() */
+    toArray(): NavInstruction[];
+    /** Export rich instructions with all metadata */
+    toRichArray(): ReadonlyArray<RichInstruction>;
+    get size(): number;
+}
+
+/**
+ * Module 8: RouteOffsetPredictor
+ * Linear distance-based position predictor for smooth rendering between GPS fixes.
+ */
+
+/**
+ * Advance the predictor's offset by speed * dt.
+ */
+declare function advancePredictor(currentOffset: number, speedMps: number, dtSec: number): number;
+/**
+ * Correct the predictor when a new GPS fix arrives.
+ * Blend towards the actual measured offset using betaCorrection.
+ */
+declare function applyGpsCorrection(predictedOffset: number, measuredOffset: number, betaCorrection?: number): number;
+/**
+ * Given a linear offset (metres from route start), find the [lng, lat] on the route.
+ *
+ * @param offset           Linear distance from route start in metres
+ * @param cumulativeDistances Forward cumulative distance array
+ * @param route             Route coordinates
+ * @returns Interpolated coordinate on the route
+ */
+declare function pointAtOffset(offset: number, cumulativeDistances: Float64Array, route: Coordinate[]): Coordinate;
+
+/**
+ * VoiceTriggerEngine
+ *
+ * Converts NavCore instruction events into timed voice cues.
+ * Handles deduplication, look-ahead windows, and priority levels.
+ * Consumer calls TTS — this engine only computes WHEN to speak.
+ *
+ * FEATURE: VOICE_TRIGGERS
+ *
+ * @example
+ * ```typescript
+ * const voice = new VoiceTriggerEngine({ earlyTriggerMeters: 150 });
+ * voice.setInstructions(instructions);
+ *
+ * engine.on('instruction', (instr) => {
+ *   const cue = voice.onInstruction(instr, state);
+ *   if (cue) speakText(cue.text);
+ * });
+ *
+ * // Or poll each GPS tick:
+ * const cue = voice.update(state);
+ * if (cue) speakText(cue.text);
+ * ```
+ */
+
+type VoicePriority = 'low' | 'normal' | 'high' | 'urgent';
+interface VoiceCue {
+    /** The instruction that triggered this cue */
+    instruction: NavInstruction;
+    /** Text to pass to TTS */
+    text: string;
+    /** Distance to the instruction point in metres */
+    distanceMetres: number;
+    /** Priority hint for TTS queue management */
+    priority: VoicePriority;
+    /** Monotonic trigger ID — use this to deduplicate */
+    triggerId: string;
+}
+interface VoiceTriggerOptions {
+    /**
+     * Trigger voice this many metres before the instruction point.
+     * Default: 120m (comfortable at 50 km/h).
+     */
+    earlyTriggerMeters?: number;
+    /**
+     * Stop trying to trigger if vehicle is already past this many metres.
+     * Default: 20m.
+     */
+    lateTriggerMeters?: number;
+    /**
+     * Re-announce if user is still approaching after this distance.
+     * Set to 0 to disable re-announcement.  Default: 300m.
+     */
+    reannounceMeters?: number;
+}
+declare class VoiceTriggerEngine {
+    private instructions;
+    private triggeredIds;
+    private reannouncedIds;
+    private readonly options;
+    constructor(options?: VoiceTriggerOptions);
+    /** Load the instruction set (call after engine.setRoute) */
+    setInstructions(instructions: NavInstruction[]): void;
+    /**
+     * Poll on every GPS state update.
+     * Returns a `VoiceCue` when an instruction should be spoken, or null.
+     */
+    update(state: NavCoreState): VoiceCue | null;
+    /**
+     * Called directly from engine's 'instruction' event.
+     * Always fires immediately regardless of distance window.
+     */
+    onInstruction(instr: NavInstruction, state: NavCoreState): VoiceCue;
+    /** Reset triggered state (call on setRoute / new journey) */
+    reset(): void;
+    private instrId;
+    private makeCue;
+}
+
+/**
+ * ETAEngine — Local ETA computation. Zero API calls.
+ *
+ * Computes Estimated Time of Arrival from current NavCore state using
+ * a rolling speed average. No server required — entirely offline.
+ *
+ * FEATURE: ETA
+ *
+ * @example
+ * ```typescript
+ * const eta = new ETAEngine({ speedWindowSize: 8 });
+ * engine.on('update', (state) => {
+ *   const result = eta.update(state);
+ *   console.log(`ETA: ${result.etaSeconds}s, ${result.distanceRemainingM.toFixed(0)}m`);
+ * });
+ * ```
+ */
+
+interface ETAResult {
+    /** ETA in seconds from now */
+    etaSeconds: number;
+    /** ETA as absolute timestamp (Date.now() + etaSeconds * 1000) */
+    etaMs: number;
+    /** Remaining distance in metres */
+    distanceRemainingM: number;
+    /** Rolling average speed in m/s */
+    averageSpeedMs: number;
+    /** Whether the estimate is reliable (enough speed samples + non-zero speed) */
+    isReliable: boolean;
+}
+interface ETAOptions {
+    /**
+     * Number of speed samples in the rolling average window.
+     * More samples = smoother but slower to react. Default: 6.
+     */
+    speedWindowSize?: number;
+    /**
+     * Minimum speed (m/s) below which we use the last reliable speed
+     * rather than 0 (avoids Infinity ETA while stopped). Default: 0.5 m/s (~2 km/h).
+     */
+    minimumSpeedMs?: number;
+    /**
+     * Speed to assume if no reliable samples yet. Default: 8.3 m/s (30 km/h).
+     */
+    fallbackSpeedMs?: number;
+}
+declare class ETAEngine {
+    private readonly options;
+    private speedSamples;
+    private lastReliableSpeed;
+    constructor(options?: ETAOptions);
+    /**
+     * Feed a NavCore state snapshot and receive an ETA estimate.
+     * Call this on every GPS update tick.
+     */
+    update(state: NavCoreState): ETAResult;
+    /** Reset the speed window (call on new route or significant GPS gap) */
+    reset(): void;
+    private rollingAverage;
+}
+
+/**
+ * GeofencingEngine
+ *
+ * Circular and polygon geofences — zero server dependency.
+ * Uses haversine distance for circles and ray-casting for polygons.
+ *
+ * FEATURE: GEOFENCING
+ *
+ * @example
+ * ```typescript
+ * const geo = new GeofencingEngine();
+ * geo.addCircle('school-zone', [2.347, 48.859], 50);
+ * geo.addPolygon('exam-area', [[2.34, 48.85], [2.36, 48.85], [2.36, 48.87], [2.34, 48.87]]);
+ *
+ * engine.on('update', ({ snappedCoord }) => {
+ *   const events = geo.update(snappedCoord);
+ *   for (const evt of events) {
+ *     console.log(`${evt.type}: ${evt.id}`);
+ *   }
+ * });
+ * ```
+ */
+
+type GeofenceType = 'circle' | 'polygon';
+type GeofenceEventType = 'enter' | 'exit' | 'dwell';
+interface GeofenceEvent {
+    /** Geofence ID that triggered the event */
+    id: string;
+    type: GeofenceEventType;
+    /** Coordinate that triggered the event */
+    coord: Coordinate;
+    /** Milliseconds spent inside (for dwell events) */
+    dwellMs?: number;
+    /** Custom metadata passed at creation */
+    meta?: unknown;
+}
+interface GeofencingOptions {
+    /**
+     * Milliseconds a vehicle must remain inside a geofence before a 'dwell' event fires.
+     * Default: 10000ms (10 seconds).
+     */
+    dwellThresholdMs?: number;
+}
+declare class GeofencingEngine {
+    private fences;
+    private states;
+    private readonly options;
+    constructor(options?: GeofencingOptions);
+    /** Add a circular geofence. Returns the ID. */
+    addCircle(id: string, center: Coordinate, radiusM: number, meta?: unknown): string;
+    /**
+     * Add a polygon geofence. Coords are [lng, lat] pairs.
+     * The polygon is auto-closed (first == last not required).
+     */
+    addPolygon(id: string, coords: Coordinate[], meta?: unknown): string;
+    /** Remove a geofence by ID */
+    remove(id: string): void;
+    /** Remove all geofences */
+    clear(): void;
+    /** List all registered geofence IDs */
+    listIds(): string[];
+    /**
+     * Feed the current coordinate and receive a (possibly empty) list of events.
+     * Call this on every NavCore state update.
+     */
+    update(coord: Coordinate): GeofenceEvent[];
+    /** Check if a coordinate is currently inside a named geofence */
+    isInside(id: string, coord: Coordinate): boolean;
+    private contains;
+    /**
+     * Ray-casting point-in-polygon algorithm.
+     * Works in [lng, lat] space (sufficient for small areas; use projected
+     * coords for very large polygons spanning many degrees).
+     */
+    private pointInPolygon;
+}
+
+export { DeadReckoningEngine, DeviationDetector, ETAEngine, type ETAOptions, type ETAResult, type GeofenceEvent, type GeofenceEventType, type GeofenceType, GeofencingEngine, type GeofencingOptions, InstructionEditor, type InstructionType, NavInstruction, ParallelRoadResolver, type ParallelRoadResolverOptions, type ResolvedCandidate, type RichInstruction, type SnapCandidate, type VoiceCue, type VoicePriority, VoiceTriggerEngine, type VoiceTriggerOptions, advancePredictor, applyBearingSmoothing, applyGpsCorrection, blendBearing, calculateDynamicCorridor, calculateRobustBearing, computeDeadReckoningOnRoute, getSpeedAdaptiveAlpha, pointAtOffset, validateProgressUpdate };

package/dist/pro.js

@@ -0,0 +1 @@
+'use strict';function h(o,e,t,n){let i=(t-o)*(Math.PI/180),r=(n-e)*(Math.PI/180),s=Math.sin(i/2)*Math.sin(i/2)+Math.cos(o*(Math.PI/180))*Math.cos(t*(Math.PI/180))*Math.sin(r/2)*Math.sin(r/2);return 6371e3*(2*Math.atan2(Math.sqrt(s),Math.sqrt(1-s)))}function P(o,e,t,n){let i=n/6371e3,r=t*(Math.PI/180),s=o*(Math.PI/180),c=e*(Math.PI/180),a=Math.asin(Math.sin(s)*Math.cos(i)+Math.cos(s)*Math.sin(i)*Math.cos(r));return [((c+Math.atan2(Math.sin(r)*Math.sin(i)*Math.cos(s),Math.cos(i)-Math.sin(s)*Math.sin(a)))*180/Math.PI+540)%360-180,a*180/Math.PI]}function w(o,e,t,n,i=5e3){if(!o||e<.5)return {predictedCoord:o?.coord??[0,0],isActive:false,ageMs:0};let r=n-o.ts;if(r>i||r<0)return {predictedCoord:o.coord,isActive:false,ageMs:r};let s=e*(r/1e3);return {predictedCoord:P(o.coord[1],o.coord[0],t,s),isActive:true,ageMs:r}}var M=class{constructor(e=5e3){this.anchor=null;this.maxAgeMs=e;}setAnchor(e,t,n){this.anchor={coord:e,idx:t,ts:n};}predict(e,t,n){return w(this.anchor,e,t,n,this.maxAgeMs)}clearAnchor(){this.anchor=null;}getAnchor(){return this.anchor}};function p(o){let e=o%360;return e>180?e-360:e<-180?e+360:e}function l(o,e){let t=o[1]*(Math.PI/180),n=o[0]*(Math.PI/180),i=e[1]*(Math.PI/180),r=e[0]*(Math.PI/180),s=Math.sin(r-n)*Math.cos(i),c=Math.cos(t)*Math.sin(i)-Math.sin(t)*Math.cos(i)*Math.cos(r-n);return (Math.atan2(s,c)*180/Math.PI+360)%360}function G(o,e,t){let n=(i,r,s)=>i+(r-i)*s;return [n(o[0],e[0],t),n(o[1],e[1],t)]}var T=class{evaluate(e,t,n,i,r,s,c){let a=i.distance>s,u=false;if(t!==null&&i.segmentIndex<r.length-1){let m=l(r[i.segmentIndex],r[i.segmentIndex+1]);u=Math.abs(p(t-m))>90;}let d=false;if(c!==null&&n>1.5){let m=r[Math.min(i.segmentIndex+2,r.length-1)];d=h(e[1],e[0],m[1],m[0])>c+5;}let R=a&&(u||d);return {distanceToRoute:i.distance,outsideCorridor:a,bearingMismatch:u,movingAway:d,confirmed:R}}};function B(o,e=null,t=25,n=60,i=1.2,r=.5){let s=t+o*i;return e!==null&&e>0&&(s+=e*r),Math.min(s,n)}function U(o,e=.3){return o<1.5?e*.5:o>20?Math.min(.9,e*2):e}function L(o,e,t=3){let n=Math.min(e+t,o.length-1);return e>=o.length-1||e===n?e>0?l(o[e-1],o[e]):0:l(o[e],o[n])}function E(o,e,t){let n=p(e-o);return (o+t*n+360)%360}function J(o,e,t,n,i,r=.3){let s=U(n,r),c=L(e,t);if(i!==null&&n>1.5){let a=E(o,i,s*.3);return E(a,c,s)}return E(o,c,s)}function q(o,e,t,n,i){return e<o||e>o+30||n>i?o:e}var z=20,W=60,$=3;function X(o,e,t,n,i,r,s,c=0){if(!e||e.length===0||t>=e.length)return {nextIdx:t,instruction:null,wasTriggered:false};let a=t;for(;a<e.length;){let g=e[a],b=o>g.geometryIndex+30,I=g.cumulativeOffset!==void 0&&s>g.cumulativeOffset+15;if(!b&&!I)break;a++;}if(a>=e.length)return {nextIdx:a,instruction:null,wasTriggered:false};let u=e[a],d=u.cumulativeOffset!==void 0?Math.max(0,u.cumulativeOffset-s):h(i[1],i[0],u.location[1],u.location[0]),R=Math.min(W,Math.max(z,c*$)),m=o<=u.geometryIndex+2,V=d<=R&&m,D=false;if(V){let g=true,b=u.bearingAfter??(u.geometryIndex<n.length-1?l(n[u.geometryIndex],n[u.geometryIndex+1]):null),I=u.bearingBefore??(u.geometryIndex>0?l(n[u.geometryIndex-1],n[u.geometryIndex]):null);I!==null&&b!==null&&r!==null&&Math.abs(p(b-I))>30&&Math.abs(p(r-b))>55&&(g=false),g&&(D=true);}return {nextIdx:a,instruction:u,wasTriggered:D}}var Y=0;function x(){return `instr_${Date.now()}_${++Y}`}var _=class{constructor(){this.instructions=[];}addTurn(e,t,n,i){return this.instructions.push({id:x(),type:"turn",location:e,text:t,instruction:t,geometryIndex:n,silent:i?.silent,meta:i?.meta}),this}addExamPoint(e,t,n,i){return this.instructions.push({id:x(),type:"exam_point",location:e,text:t,instruction:t,geometryIndex:n,severity:i?.severity??"info",silent:i?.silent,meta:i?.meta}),this}addCheckpoint(e,t,n){return this.instructions.push({id:x(),type:"checkpoint",location:e,text:"",instruction:"",geometryIndex:t,silent:true,meta:n}),this}addDepart(e,t="Start navigation"){let n={id:x(),type:"depart",location:e,text:t,instruction:t,geometryIndex:0};return this.instructions.unshift(n),this}addArrive(e,t="You have arrived"){return this.instructions.push({id:x(),type:"arrive",location:e,text:t,instruction:t,geometryIndex:Number.MAX_SAFE_INTEGER}),this}update(e,t){let n=this.instructions.findIndex(i=>i.id===e);if(n===-1)throw new Error(`[InstructionEditor] Instruction ${e} not found`);return this.instructions[n]={...this.instructions[n],...t},this}remove(e){let t=this.instructions.findIndex(n=>n.id===e);if(t===-1)throw new Error(`[InstructionEditor] Instruction ${e} not found`);return this.instructions.splice(t,1),this}reorder(e,t){let n=this.instructions.findIndex(r=>r.id===e);if(n===-1)throw new Error(`[InstructionEditor] Instruction ${e} not found`);let[i]=this.instructions.splice(n,1);return this.instructions.splice(Math.max(0,t),0,i),this}sort(){return this.instructions.sort((e,t)=>e.geometryIndex-t.geometryIndex),this}clear(){return this.instructions=[],this}attachToCumulative(e){if(e.length<2)return this;let t=[0];for(let n=1;n<e.length;n++){let i=e[n-1],r=e[n];t.push(t[n-1]+h(i[1],i[0],r[1],r[0]));}for(let n of this.instructions){let i=Math.min(n.geometryIndex,e.length-1);n.cumulativeOffset=t[i]??0,i>0&&i<e.length-1&&(n.bearingBefore=l(e[i-1],e[i]),n.bearingAfter=l(e[i],e[i+1]));}return this}toArray(){return this.instructions.map(({id:e,type:t,severity:n,meta:i,...r})=>r)}toRichArray(){return [...this.instructions]}get size(){return this.instructions.length}};function K(o,e,t){return o+e*t}function Q(o,e,t=.15){let n=e-o;return o+t*n}function Z(o,e,t){if(t.length===0)return [0,0];if(o<=0)return t[0];let n=e[e.length-1]??0;if(o>=n)return t[t.length-1];let i=0,r=e.length-1;for(;i<r-1;){let d=i+r>>1;e[d]<=o?i=d:r=d;}let s=e[i],a=e[r]-s;if(a===0)return t[i];let u=(o-s)/a;return G(t[i],t[r],u)}var O=class{constructor(){this._state="IDLE";this._context={resumeIndex:null};}get state(){return this._state}get context(){return {...this._context}}dispatch(e){switch(this._state){case "IDLE":e.type==="ROUTE_LOADED"&&(this._state="OVERVIEW"),e.type==="USER_START_NAVIGATION"&&(this._state="APPROACHING_ROUTE");break;case "OVERVIEW":e.type==="USER_START_NAVIGATION"&&(this._state="APPROACHING_ROUTE");break;case "APPROACHING_ROUTE":e.type==="ROUTE_JOINED"&&(this._state="ON_ROUTE",this._context.resumeIndex=e.data.index),e.type==="NAVIGATION_FINISHED"&&(this._state="IDLE");break;case "ON_ROUTE":e.type==="NAVIGATION_FINISHED"&&(this._state="IDLE"),e.type==="ROUTE_JOINED"&&(this._context.resumeIndex=e.data.index);break}return (e.type==="RESET"||e.type==="CANCEL_NAVIGATION")&&(this._state="IDLE",this._context={resumeIndex:null}),{state:this._state,context:{...this._context}}}reset(){this._state="IDLE",this._context={resumeIndex:null};}};var f={deviationSegmentIdx:null,deviationStartMs:null,tempRoute:null,rejoinTarget:null,lastRerouteMs:null,rejoinedAtMs:null,rejoinDwellFrames:0,failureReason:null},k=2e3,ee=3,C=class{constructor(){this._state="ON_ROUTE";this._context={...f};}get state(){return this._state}get context(){return {...this._context}}dispatch(e,t){let n=t??Date.now();switch(this._state){case "ON_ROUTE":e.type==="DEVIATION_SUSPECTED"&&(this._state="DEVIATING",this._context.deviationSegmentIdx=e.deviationSegmentIdx,this._context.deviationStartMs=n);break;case "DEVIATING":e.type==="DEVIATION_CONFIRMED"&&(this._context.deviationStartMs!==null?n-this._context.deviationStartMs:0)>=k&&(this._state="OFF_ROUTE",this._context.deviationSegmentIdx=e.deviationSegmentIdx),(e.type==="RESUME"||e.type==="RESET")&&(this._state="ON_ROUTE",e.type==="RESET"?this._context={...f}:(this._context.deviationSegmentIdx=null,this._context.deviationStartMs=null));break;case "OFF_ROUTE":e.type==="REROUTE_STARTED"&&(this._state="REROUTING",this._context.lastRerouteMs=n),e.type==="RESET"&&(this._state="ON_ROUTE",this._context={...f});break;case "REROUTING":e.type==="REROUTE_SUCCESS"&&(this._state="REJOINING",this._context.tempRoute=e.tempRoute,this._context.rejoinTarget=e.rejoinTarget),e.type==="REROUTE_FAILED"&&(this._state="FAILED",this._context.failureReason=e.reason);break;case "REJOINING":e.type==="REJOIN_DETECTED"&&this._context.rejoinDwellFrames++,(e.type==="REJOIN_CONFIRMED"||this._context.rejoinDwellFrames>=ee)&&(this._state="REJOINED",this._context.rejoinedAtMs=n,this._context.rejoinDwellFrames=0),e.type==="RESET"&&(this._state="ON_ROUTE",this._context={...f});break;case "REJOINED":e.type==="RESUME"&&(this._state="ON_ROUTE",this._context.tempRoute=null,this._context.rejoinTarget=null,this._context.rejoinedAtMs=null,this._context.deviationSegmentIdx=null,this._context.deviationStartMs=null),e.type==="RESET"&&(this._state="ON_ROUTE",this._context={...f});break;case "FAILED":e.type==="RESET"&&(this._state="ON_ROUTE",this._context={...f});break}return {state:this._state,context:{...this._context}}}reset(){this._state="ON_ROUTE",this._context={...f};}isDeviationConfirmed(e=Date.now()){return this._context.deviationStartMs?e-this._context.deviationStartMs>=k:false}};var te={bearingPenalty:80,bearingMismatchThresholdDeg:60,inertiaPenalty:40,inertiaSegmentDist:3},S=class{constructor(e){this.options={...te,...e};}resolve(e,t=null,n=null){return e.map(i=>this.score(i,t,n)).sort((i,r)=>i.score-r.score)}resolveBest(e,t=null,n=null){return e.length===0?null:this.resolve(e,t,n)[0]??null}score(e,t,n){let i=e.distanceMetres,r=null,s=false;if(t!==null){let c=l(e.segA,e.segB),a=Math.abs(p(t-c));r=a,a>this.options.bearingMismatchThresholdDeg&&(i+=this.options.bearingPenalty);}return n!==null&&Math.abs(e.segmentIndex-n)>=this.options.inertiaSegmentDist&&(i+=this.options.inertiaPenalty,s=true),{...e,score:i,bearingDeltaDeg:r,inertiaPenaltyApplied:s}}isLikelyUTurn(e,t,n){let i=l(t,n);return Math.abs(p(e-i))>this.options.bearingMismatchThresholdDeg}};var ne={earlyTriggerMeters:120,lateTriggerMeters:20,reannounceMeters:300},A=class{constructor(e){this.instructions=[];this.triggeredIds=new Set;this.reannouncedIds=new Set;this.options={...ne,...e};}setInstructions(e){this.instructions=[...e],this.triggeredIds.clear(),this.reannouncedIds.clear();}update(e){let{distanceToNextInstruction:t,nextInstructionIndex:n}=e;if(n===null||t===null||n>=this.instructions.length)return null;let i=this.instructions[n],r=this.instrId(n),s=t;if(this.triggeredIds.has(r))return this.options.reannounceMeters>0&&!this.reannouncedIds.has(r)&&s<=this.options.reannounceMeters&&s>this.options.earlyTriggerMeters?(this.reannouncedIds.add(r),this.makeCue(i,s,"low")):null;if(s>this.options.earlyTriggerMeters)return null;if(s<-this.options.lateTriggerMeters)return this.triggeredIds.add(r),null;this.triggeredIds.add(r);let c=s<30?"urgent":s<60?"high":"normal";return this.makeCue(i,s,c)}onInstruction(e,t){let n=t.distanceToNextInstruction??0;return this.makeCue(e,n,"high")}reset(){this.triggeredIds.clear(),this.reannouncedIds.clear();}instrId(e){let t=this.instructions[e];return `${e}_${t?.geometryIndex??0}`}makeCue(e,t,n){return {instruction:e,text:e.text??e.instruction??"",distanceMetres:Math.max(0,t),priority:n,triggerId:`${e.geometryIndex}_${t.toFixed(0)}`}}};var ie={speedWindowSize:6,minimumSpeedMs:.5,fallbackSpeedMs:8.33},v=class{constructor(e){this.speedSamples=[];this.options={...ie,...e},this.lastReliableSpeed=this.options.fallbackSpeedMs;}update(e){let t=e.distanceToDestination??0,n=e.currentSpeed??0;this.speedSamples.push(n),this.speedSamples.length>this.options.speedWindowSize&&this.speedSamples.shift();let i=this.rollingAverage();i>=this.options.minimumSpeedMs&&(this.lastReliableSpeed=i);let r=i>=this.options.minimumSpeedMs?i:this.lastReliableSpeed,s=this.speedSamples.length>=Math.ceil(this.options.speedWindowSize/2)&&r>0&&t>0,c=r>0?t/r:0;return {etaSeconds:Math.round(c),etaMs:Date.now()+c*1e3,distanceRemainingM:t,averageSpeedMs:i,isReliable:s}}reset(){this.speedSamples=[],this.lastReliableSpeed=this.options.fallbackSpeedMs;}rollingAverage(){return this.speedSamples.length===0?0:this.speedSamples.reduce((t,n)=>t+n,0)/this.speedSamples.length}};var re={dwellThresholdMs:1e4},N=class{constructor(e){this.fences=new Map;this.states=new Map;this.options={...re,...e};}addCircle(e,t,n,i){return this.fences.set(e,{kind:"circle",id:e,center:t,radiusM:n,meta:i}),this.states.set(e,{inside:false,enteredAtMs:null}),e}addPolygon(e,t,n){if(t.length<3)throw new Error("[Geofencing] Polygon requires at least 3 coordinates");return this.fences.set(e,{kind:"polygon",id:e,coords:t,meta:n}),this.states.set(e,{inside:false,enteredAtMs:null}),e}remove(e){this.fences.delete(e),this.states.delete(e);}clear(){this.fences.clear(),this.states.clear();}listIds(){return Array.from(this.fences.keys())}update(e){if(!e)return [];let t=[],n=Date.now();for(let[i,r]of this.fences){let s=this.states.get(i),c=this.contains(r,e);if(!s.inside&&c)s.inside=true,s.enteredAtMs=n,t.push({id:i,type:"enter",coord:e,meta:r.meta});else if(s.inside&&!c){s.inside=false;let a=s.enteredAtMs?n-s.enteredAtMs:0;s.enteredAtMs=null,t.push({id:i,type:"exit",coord:e,dwellMs:a,meta:r.meta});}else if(s.inside&&s.enteredAtMs!==null){let a=n-s.enteredAtMs;a>=this.options.dwellThresholdMs&&(t.push({id:i,type:"dwell",coord:e,dwellMs:a,meta:r.meta}),s.enteredAtMs=n);}}return t}isInside(e,t){let n=this.fences.get(e);return n?this.contains(n,t):false}contains(e,t){return e.kind==="circle"?h(t[1],t[0],e.center[1],e.center[0])<=e.radiusM:this.pointInPolygon(t,e.coords)}pointInPolygon(e,t){let[n,i]=e,r=false,s=t.length;for(let c=0,a=s-1;c<s;a=c++){let[u,d]=t[c],[R,m]=t[a];d>i!=m>i&&n<(R-u)*(i-d)/(m-d)+u&&(r=!r);}return r}};exports.DeadReckoningEngine=M;exports.DeviationDetector=T;exports.ETAEngine=v;exports.GeofencingEngine=N;exports.InstructionEditor=_;exports.NavigationFSM=O;exports.OffRouteFSM=C;exports.ParallelRoadResolver=S;exports.VoiceTriggerEngine=A;exports.advancePredictor=K;exports.applyBearingSmoothing=J;exports.applyGpsCorrection=Q;exports.blendBearing=E;exports.calculateDynamicCorridor=B;exports.calculateRobustBearing=L;exports.computeDeadReckoningOnRoute=w;exports.getSpeedAdaptiveAlpha=U;exports.pointAtOffset=Z;exports.resolveNextInstruction=X;exports.validateProgressUpdate=q;

package/dist/pro.mjs

@@ -0,0 +1 @@
+function h(o,e,t,n){let i=(t-o)*(Math.PI/180),r=(n-e)*(Math.PI/180),s=Math.sin(i/2)*Math.sin(i/2)+Math.cos(o*(Math.PI/180))*Math.cos(t*(Math.PI/180))*Math.sin(r/2)*Math.sin(r/2);return 6371e3*(2*Math.atan2(Math.sqrt(s),Math.sqrt(1-s)))}function P(o,e,t,n){let i=n/6371e3,r=t*(Math.PI/180),s=o*(Math.PI/180),c=e*(Math.PI/180),a=Math.asin(Math.sin(s)*Math.cos(i)+Math.cos(s)*Math.sin(i)*Math.cos(r));return [((c+Math.atan2(Math.sin(r)*Math.sin(i)*Math.cos(s),Math.cos(i)-Math.sin(s)*Math.sin(a)))*180/Math.PI+540)%360-180,a*180/Math.PI]}function w(o,e,t,n,i=5e3){if(!o||e<.5)return {predictedCoord:o?.coord??[0,0],isActive:false,ageMs:0};let r=n-o.ts;if(r>i||r<0)return {predictedCoord:o.coord,isActive:false,ageMs:r};let s=e*(r/1e3);return {predictedCoord:P(o.coord[1],o.coord[0],t,s),isActive:true,ageMs:r}}var M=class{constructor(e=5e3){this.anchor=null;this.maxAgeMs=e;}setAnchor(e,t,n){this.anchor={coord:e,idx:t,ts:n};}predict(e,t,n){return w(this.anchor,e,t,n,this.maxAgeMs)}clearAnchor(){this.anchor=null;}getAnchor(){return this.anchor}};function p(o){let e=o%360;return e>180?e-360:e<-180?e+360:e}function l(o,e){let t=o[1]*(Math.PI/180),n=o[0]*(Math.PI/180),i=e[1]*(Math.PI/180),r=e[0]*(Math.PI/180),s=Math.sin(r-n)*Math.cos(i),c=Math.cos(t)*Math.sin(i)-Math.sin(t)*Math.cos(i)*Math.cos(r-n);return (Math.atan2(s,c)*180/Math.PI+360)%360}function G(o,e,t){let n=(i,r,s)=>i+(r-i)*s;return [n(o[0],e[0],t),n(o[1],e[1],t)]}var T=class{evaluate(e,t,n,i,r,s,c){let a=i.distance>s,u=false;if(t!==null&&i.segmentIndex<r.length-1){let m=l(r[i.segmentIndex],r[i.segmentIndex+1]);u=Math.abs(p(t-m))>90;}let d=false;if(c!==null&&n>1.5){let m=r[Math.min(i.segmentIndex+2,r.length-1)];d=h(e[1],e[0],m[1],m[0])>c+5;}let R=a&&(u||d);return {distanceToRoute:i.distance,outsideCorridor:a,bearingMismatch:u,movingAway:d,confirmed:R}}};function B(o,e=null,t=25,n=60,i=1.2,r=.5){let s=t+o*i;return e!==null&&e>0&&(s+=e*r),Math.min(s,n)}function U(o,e=.3){return o<1.5?e*.5:o>20?Math.min(.9,e*2):e}function L(o,e,t=3){let n=Math.min(e+t,o.length-1);return e>=o.length-1||e===n?e>0?l(o[e-1],o[e]):0:l(o[e],o[n])}function E(o,e,t){let n=p(e-o);return (o+t*n+360)%360}function J(o,e,t,n,i,r=.3){let s=U(n,r),c=L(e,t);if(i!==null&&n>1.5){let a=E(o,i,s*.3);return E(a,c,s)}return E(o,c,s)}function q(o,e,t,n,i){return e<o||e>o+30||n>i?o:e}var z=20,W=60,$=3;function X(o,e,t,n,i,r,s,c=0){if(!e||e.length===0||t>=e.length)return {nextIdx:t,instruction:null,wasTriggered:false};let a=t;for(;a<e.length;){let g=e[a],b=o>g.geometryIndex+30,I=g.cumulativeOffset!==void 0&&s>g.cumulativeOffset+15;if(!b&&!I)break;a++;}if(a>=e.length)return {nextIdx:a,instruction:null,wasTriggered:false};let u=e[a],d=u.cumulativeOffset!==void 0?Math.max(0,u.cumulativeOffset-s):h(i[1],i[0],u.location[1],u.location[0]),R=Math.min(W,Math.max(z,c*$)),m=o<=u.geometryIndex+2,V=d<=R&&m,D=false;if(V){let g=true,b=u.bearingAfter??(u.geometryIndex<n.length-1?l(n[u.geometryIndex],n[u.geometryIndex+1]):null),I=u.bearingBefore??(u.geometryIndex>0?l(n[u.geometryIndex-1],n[u.geometryIndex]):null);I!==null&&b!==null&&r!==null&&Math.abs(p(b-I))>30&&Math.abs(p(r-b))>55&&(g=false),g&&(D=true);}return {nextIdx:a,instruction:u,wasTriggered:D}}var Y=0;function x(){return `instr_${Date.now()}_${++Y}`}var _=class{constructor(){this.instructions=[];}addTurn(e,t,n,i){return this.instructions.push({id:x(),type:"turn",location:e,text:t,instruction:t,geometryIndex:n,silent:i?.silent,meta:i?.meta}),this}addExamPoint(e,t,n,i){return this.instructions.push({id:x(),type:"exam_point",location:e,text:t,instruction:t,geometryIndex:n,severity:i?.severity??"info",silent:i?.silent,meta:i?.meta}),this}addCheckpoint(e,t,n){return this.instructions.push({id:x(),type:"checkpoint",location:e,text:"",instruction:"",geometryIndex:t,silent:true,meta:n}),this}addDepart(e,t="Start navigation"){let n={id:x(),type:"depart",location:e,text:t,instruction:t,geometryIndex:0};return this.instructions.unshift(n),this}addArrive(e,t="You have arrived"){return this.instructions.push({id:x(),type:"arrive",location:e,text:t,instruction:t,geometryIndex:Number.MAX_SAFE_INTEGER}),this}update(e,t){let n=this.instructions.findIndex(i=>i.id===e);if(n===-1)throw new Error(`[InstructionEditor] Instruction ${e} not found`);return this.instructions[n]={...this.instructions[n],...t},this}remove(e){let t=this.instructions.findIndex(n=>n.id===e);if(t===-1)throw new Error(`[InstructionEditor] Instruction ${e} not found`);return this.instructions.splice(t,1),this}reorder(e,t){let n=this.instructions.findIndex(r=>r.id===e);if(n===-1)throw new Error(`[InstructionEditor] Instruction ${e} not found`);let[i]=this.instructions.splice(n,1);return this.instructions.splice(Math.max(0,t),0,i),this}sort(){return this.instructions.sort((e,t)=>e.geometryIndex-t.geometryIndex),this}clear(){return this.instructions=[],this}attachToCumulative(e){if(e.length<2)return this;let t=[0];for(let n=1;n<e.length;n++){let i=e[n-1],r=e[n];t.push(t[n-1]+h(i[1],i[0],r[1],r[0]));}for(let n of this.instructions){let i=Math.min(n.geometryIndex,e.length-1);n.cumulativeOffset=t[i]??0,i>0&&i<e.length-1&&(n.bearingBefore=l(e[i-1],e[i]),n.bearingAfter=l(e[i],e[i+1]));}return this}toArray(){return this.instructions.map(({id:e,type:t,severity:n,meta:i,...r})=>r)}toRichArray(){return [...this.instructions]}get size(){return this.instructions.length}};function K(o,e,t){return o+e*t}function Q(o,e,t=.15){let n=e-o;return o+t*n}function Z(o,e,t){if(t.length===0)return [0,0];if(o<=0)return t[0];let n=e[e.length-1]??0;if(o>=n)return t[t.length-1];let i=0,r=e.length-1;for(;i<r-1;){let d=i+r>>1;e[d]<=o?i=d:r=d;}let s=e[i],a=e[r]-s;if(a===0)return t[i];let u=(o-s)/a;return G(t[i],t[r],u)}var O=class{constructor(){this._state="IDLE";this._context={resumeIndex:null};}get state(){return this._state}get context(){return {...this._context}}dispatch(e){switch(this._state){case "IDLE":e.type==="ROUTE_LOADED"&&(this._state="OVERVIEW"),e.type==="USER_START_NAVIGATION"&&(this._state="APPROACHING_ROUTE");break;case "OVERVIEW":e.type==="USER_START_NAVIGATION"&&(this._state="APPROACHING_ROUTE");break;case "APPROACHING_ROUTE":e.type==="ROUTE_JOINED"&&(this._state="ON_ROUTE",this._context.resumeIndex=e.data.index),e.type==="NAVIGATION_FINISHED"&&(this._state="IDLE");break;case "ON_ROUTE":e.type==="NAVIGATION_FINISHED"&&(this._state="IDLE"),e.type==="ROUTE_JOINED"&&(this._context.resumeIndex=e.data.index);break}return (e.type==="RESET"||e.type==="CANCEL_NAVIGATION")&&(this._state="IDLE",this._context={resumeIndex:null}),{state:this._state,context:{...this._context}}}reset(){this._state="IDLE",this._context={resumeIndex:null};}};var f={deviationSegmentIdx:null,deviationStartMs:null,tempRoute:null,rejoinTarget:null,lastRerouteMs:null,rejoinedAtMs:null,rejoinDwellFrames:0,failureReason:null},k=2e3,ee=3,C=class{constructor(){this._state="ON_ROUTE";this._context={...f};}get state(){return this._state}get context(){return {...this._context}}dispatch(e,t){let n=t??Date.now();switch(this._state){case "ON_ROUTE":e.type==="DEVIATION_SUSPECTED"&&(this._state="DEVIATING",this._context.deviationSegmentIdx=e.deviationSegmentIdx,this._context.deviationStartMs=n);break;case "DEVIATING":e.type==="DEVIATION_CONFIRMED"&&(this._context.deviationStartMs!==null?n-this._context.deviationStartMs:0)>=k&&(this._state="OFF_ROUTE",this._context.deviationSegmentIdx=e.deviationSegmentIdx),(e.type==="RESUME"||e.type==="RESET")&&(this._state="ON_ROUTE",e.type==="RESET"?this._context={...f}:(this._context.deviationSegmentIdx=null,this._context.deviationStartMs=null));break;case "OFF_ROUTE":e.type==="REROUTE_STARTED"&&(this._state="REROUTING",this._context.lastRerouteMs=n),e.type==="RESET"&&(this._state="ON_ROUTE",this._context={...f});break;case "REROUTING":e.type==="REROUTE_SUCCESS"&&(this._state="REJOINING",this._context.tempRoute=e.tempRoute,this._context.rejoinTarget=e.rejoinTarget),e.type==="REROUTE_FAILED"&&(this._state="FAILED",this._context.failureReason=e.reason);break;case "REJOINING":e.type==="REJOIN_DETECTED"&&this._context.rejoinDwellFrames++,(e.type==="REJOIN_CONFIRMED"||this._context.rejoinDwellFrames>=ee)&&(this._state="REJOINED",this._context.rejoinedAtMs=n,this._context.rejoinDwellFrames=0),e.type==="RESET"&&(this._state="ON_ROUTE",this._context={...f});break;case "REJOINED":e.type==="RESUME"&&(this._state="ON_ROUTE",this._context.tempRoute=null,this._context.rejoinTarget=null,this._context.rejoinedAtMs=null,this._context.deviationSegmentIdx=null,this._context.deviationStartMs=null),e.type==="RESET"&&(this._state="ON_ROUTE",this._context={...f});break;case "FAILED":e.type==="RESET"&&(this._state="ON_ROUTE",this._context={...f});break}return {state:this._state,context:{...this._context}}}reset(){this._state="ON_ROUTE",this._context={...f};}isDeviationConfirmed(e=Date.now()){return this._context.deviationStartMs?e-this._context.deviationStartMs>=k:false}};var te={bearingPenalty:80,bearingMismatchThresholdDeg:60,inertiaPenalty:40,inertiaSegmentDist:3},S=class{constructor(e){this.options={...te,...e};}resolve(e,t=null,n=null){return e.map(i=>this.score(i,t,n)).sort((i,r)=>i.score-r.score)}resolveBest(e,t=null,n=null){return e.length===0?null:this.resolve(e,t,n)[0]??null}score(e,t,n){let i=e.distanceMetres,r=null,s=false;if(t!==null){let c=l(e.segA,e.segB),a=Math.abs(p(t-c));r=a,a>this.options.bearingMismatchThresholdDeg&&(i+=this.options.bearingPenalty);}return n!==null&&Math.abs(e.segmentIndex-n)>=this.options.inertiaSegmentDist&&(i+=this.options.inertiaPenalty,s=true),{...e,score:i,bearingDeltaDeg:r,inertiaPenaltyApplied:s}}isLikelyUTurn(e,t,n){let i=l(t,n);return Math.abs(p(e-i))>this.options.bearingMismatchThresholdDeg}};var ne={earlyTriggerMeters:120,lateTriggerMeters:20,reannounceMeters:300},A=class{constructor(e){this.instructions=[];this.triggeredIds=new Set;this.reannouncedIds=new Set;this.options={...ne,...e};}setInstructions(e){this.instructions=[...e],this.triggeredIds.clear(),this.reannouncedIds.clear();}update(e){let{distanceToNextInstruction:t,nextInstructionIndex:n}=e;if(n===null||t===null||n>=this.instructions.length)return null;let i=this.instructions[n],r=this.instrId(n),s=t;if(this.triggeredIds.has(r))return this.options.reannounceMeters>0&&!this.reannouncedIds.has(r)&&s<=this.options.reannounceMeters&&s>this.options.earlyTriggerMeters?(this.reannouncedIds.add(r),this.makeCue(i,s,"low")):null;if(s>this.options.earlyTriggerMeters)return null;if(s<-this.options.lateTriggerMeters)return this.triggeredIds.add(r),null;this.triggeredIds.add(r);let c=s<30?"urgent":s<60?"high":"normal";return this.makeCue(i,s,c)}onInstruction(e,t){let n=t.distanceToNextInstruction??0;return this.makeCue(e,n,"high")}reset(){this.triggeredIds.clear(),this.reannouncedIds.clear();}instrId(e){let t=this.instructions[e];return `${e}_${t?.geometryIndex??0}`}makeCue(e,t,n){return {instruction:e,text:e.text??e.instruction??"",distanceMetres:Math.max(0,t),priority:n,triggerId:`${e.geometryIndex}_${t.toFixed(0)}`}}};var ie={speedWindowSize:6,minimumSpeedMs:.5,fallbackSpeedMs:8.33},v=class{constructor(e){this.speedSamples=[];this.options={...ie,...e},this.lastReliableSpeed=this.options.fallbackSpeedMs;}update(e){let t=e.distanceToDestination??0,n=e.currentSpeed??0;this.speedSamples.push(n),this.speedSamples.length>this.options.speedWindowSize&&this.speedSamples.shift();let i=this.rollingAverage();i>=this.options.minimumSpeedMs&&(this.lastReliableSpeed=i);let r=i>=this.options.minimumSpeedMs?i:this.lastReliableSpeed,s=this.speedSamples.length>=Math.ceil(this.options.speedWindowSize/2)&&r>0&&t>0,c=r>0?t/r:0;return {etaSeconds:Math.round(c),etaMs:Date.now()+c*1e3,distanceRemainingM:t,averageSpeedMs:i,isReliable:s}}reset(){this.speedSamples=[],this.lastReliableSpeed=this.options.fallbackSpeedMs;}rollingAverage(){return this.speedSamples.length===0?0:this.speedSamples.reduce((t,n)=>t+n,0)/this.speedSamples.length}};var re={dwellThresholdMs:1e4},N=class{constructor(e){this.fences=new Map;this.states=new Map;this.options={...re,...e};}addCircle(e,t,n,i){return this.fences.set(e,{kind:"circle",id:e,center:t,radiusM:n,meta:i}),this.states.set(e,{inside:false,enteredAtMs:null}),e}addPolygon(e,t,n){if(t.length<3)throw new Error("[Geofencing] Polygon requires at least 3 coordinates");return this.fences.set(e,{kind:"polygon",id:e,coords:t,meta:n}),this.states.set(e,{inside:false,enteredAtMs:null}),e}remove(e){this.fences.delete(e),this.states.delete(e);}clear(){this.fences.clear(),this.states.clear();}listIds(){return Array.from(this.fences.keys())}update(e){if(!e)return [];let t=[],n=Date.now();for(let[i,r]of this.fences){let s=this.states.get(i),c=this.contains(r,e);if(!s.inside&&c)s.inside=true,s.enteredAtMs=n,t.push({id:i,type:"enter",coord:e,meta:r.meta});else if(s.inside&&!c){s.inside=false;let a=s.enteredAtMs?n-s.enteredAtMs:0;s.enteredAtMs=null,t.push({id:i,type:"exit",coord:e,dwellMs:a,meta:r.meta});}else if(s.inside&&s.enteredAtMs!==null){let a=n-s.enteredAtMs;a>=this.options.dwellThresholdMs&&(t.push({id:i,type:"dwell",coord:e,dwellMs:a,meta:r.meta}),s.enteredAtMs=n);}}return t}isInside(e,t){let n=this.fences.get(e);return n?this.contains(n,t):false}contains(e,t){return e.kind==="circle"?h(t[1],t[0],e.center[1],e.center[0])<=e.radiusM:this.pointInPolygon(t,e.coords)}pointInPolygon(e,t){let[n,i]=e,r=false,s=t.length;for(let c=0,a=s-1;c<s;a=c++){let[u,d]=t[c],[R,m]=t[a];d>i!=m>i&&n<(R-u)*(i-d)/(m-d)+u&&(r=!r);}return r}};export{M as DeadReckoningEngine,T as DeviationDetector,v as ETAEngine,N as GeofencingEngine,_ as InstructionEditor,O as NavigationFSM,C as OffRouteFSM,S as ParallelRoadResolver,A as VoiceTriggerEngine,K as advancePredictor,J as applyBearingSmoothing,Q as applyGpsCorrection,E as blendBearing,B as calculateDynamicCorridor,L as calculateRobustBearing,w as computeDeadReckoningOnRoute,U as getSpeedAdaptiveAlpha,Z as pointAtOffset,X as resolveNextInstruction,q as validateProgressUpdate};

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@ingissa/navcore-core",
+  "version": "1.0.0",
+  "description": "NavCore navigation engine — zero runtime dependencies. Framework-agnostic. Works in browsers, React Native, Node.js, and CI/CD.",
+  "author": "Ingissa <contact@navcore.dev>",
+  "license": "MIT",
+  "homepage": "https://navcore.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ingissa/navcore-sdk"
+  },
+  "bugs": {
+    "url": "https://github.com/ingissa/navcore-sdk/issues"
+  },
+  "keywords": [
+    "navigation",
+    "gps",
+    "routing",
+    "kalman",
+    "dead-reckoning",
+    "mapbox",
+    "maplibre",
+    "react-native",
+    "geofencing",
+    "eta",
+    "off-route",
+    "turn-by-turn"
+  ],
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "import": "./dist/core.mjs",
+      "require": "./dist/core.cjs"
+    },
+    "./pro": {
+      "types": "./dist/pro.d.ts",
+      "import": "./dist/pro.mjs",
+      "require": "./dist/pro.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "scripts": {
+    "build": "tsup",
+    "build:types": "tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.1",
+    "typescript": "^5.4.0",
+    "vitest": "^3.1.0"
+  }
+}