@ingissa/navcore-simulator 1.0.3 → 1.0.4

package/dist/react-native.d.mts

@@ -0,0 +1,82 @@
+import { h as SimSession, C as Coordinate, i as SimulatorConfig, S as Scenario, g as SimPosition } from './index-i9TY71RY.mjs';
+export { E as EngineState, a as ExportFormat, F as FleetReport, b as FleetSimulator, G as GpxParseResult, c as GpxParser, N as NoiseEngine, d as NoiseProfile, R as RouteWalker, e as ScenarioInjector, f as SessionRecorder, j as SimulatorEngine, V as VehicleProfile, W as WalkerPosition } from './index-i9TY71RY.mjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * useSimulator — React Native hook wrapping SimulatorEngine.
+ *
+ * Drop-in replacement for useGpsSimulator.
+ * All engine logic lives in SimulatorEngine — this hook is purely a thin
+ * React adapter with no business logic of its own.
+ *
+ * BEFORE (current Go4Exams code):
+ *   const simGps = useGpsSimulator(route, isNavigating, speedMultiplier)
+ *
+ * AFTER:
+ *   const { position, controls, session, isRecording } = useSimulator({
+ *     routeGeometry: route,
+ *     active: isNavigating,
+ *     config: { speedKmh: 50, noiseProfile: NoiseEngine.STANDARD },
+ *   })
+ */
+
+interface UseSimulatorOptions {
+    /** Route geometry to simulate along */
+    routeGeometry: Coordinate[] | null;
+    /** Whether the simulation should be active */
+    active: boolean;
+    /** Engine configuration (all fields optional) */
+    config?: Partial<Omit<SimulatorConfig, 'routeGeometry' | 'onPositionUpdate' | 'onRouteComplete'>>;
+    /** Pre-registered scenarios */
+    scenarios?: Scenario[];
+    /** Called when a scenario fires */
+    onScenarioFired?: (scenario: Scenario) => void;
+    /** Called when the route simulation finishes */
+    onRouteComplete?: () => void;
+}
+interface SimulatorControls$1 {
+    pause: () => void;
+    resume: () => void;
+    seek: (geometryIndex: number) => void;
+    setSpeed: (multiplier: 1 | 2 | 4 | 8) => void;
+}
+interface SessionControls {
+    start: (sessionId?: string) => void;
+    stop: () => SimSession | null;
+}
+interface UseSimulatorResult {
+    /** Current simulated position — null when inactive */
+    position: SimPosition | null;
+    /** Playback controls */
+    controls: SimulatorControls$1;
+    /** Recording controls */
+    session: SessionControls;
+    /** Whether a recording is in progress */
+    isRecording: boolean;
+}
+declare function useSimulator(options: UseSimulatorOptions): UseSimulatorResult;
+
+interface ScenarioLogEntry {
+    ts: number;
+    name: string;
+    type: string;
+}
+interface SimulatorControlsProps {
+    simulator: SimulatorControls$1;
+    session?: SessionControls;
+    style?: 'minimal' | 'full' | 'floating';
+    showScenarioLog?: boolean;
+    showSessionRecorder?: boolean;
+    scenarioLog?: ScenarioLogEntry[];
+    /** Current speed multiplier (controlled externally) */
+    currentSpeed?: 1 | 2 | 4 | 8;
+    /** Current engine state */
+    engineState?: 'idle' | 'running' | 'paused' | 'complete';
+    isRecording?: boolean;
+    onExportSession?: (session: SimSession) => void;
+    /** Additional style for the root container */
+    containerStyle?: object;
+}
+declare function SimulatorControls({ simulator, session, style, showScenarioLog, showSessionRecorder, scenarioLog, currentSpeed, engineState, isRecording, onExportSession, containerStyle, }: SimulatorControlsProps): react_jsx_runtime.JSX.Element;
+
+export { Scenario, type ScenarioLogEntry, SimPosition, SimSession, SimulatorConfig, SimulatorControls, useSimulator };

package/dist/react-native.d.ts

@@ -0,0 +1,82 @@
+import { h as SimSession, C as Coordinate, i as SimulatorConfig, S as Scenario, g as SimPosition } from './index-i9TY71RY.js';
+export { E as EngineState, a as ExportFormat, F as FleetReport, b as FleetSimulator, G as GpxParseResult, c as GpxParser, N as NoiseEngine, d as NoiseProfile, R as RouteWalker, e as ScenarioInjector, f as SessionRecorder, j as SimulatorEngine, V as VehicleProfile, W as WalkerPosition } from './index-i9TY71RY.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * useSimulator — React Native hook wrapping SimulatorEngine.
+ *
+ * Drop-in replacement for useGpsSimulator.
+ * All engine logic lives in SimulatorEngine — this hook is purely a thin
+ * React adapter with no business logic of its own.
+ *
+ * BEFORE (current Go4Exams code):
+ *   const simGps = useGpsSimulator(route, isNavigating, speedMultiplier)
+ *
+ * AFTER:
+ *   const { position, controls, session, isRecording } = useSimulator({
+ *     routeGeometry: route,
+ *     active: isNavigating,
+ *     config: { speedKmh: 50, noiseProfile: NoiseEngine.STANDARD },
+ *   })
+ */
+
+interface UseSimulatorOptions {
+    /** Route geometry to simulate along */
+    routeGeometry: Coordinate[] | null;
+    /** Whether the simulation should be active */
+    active: boolean;
+    /** Engine configuration (all fields optional) */
+    config?: Partial<Omit<SimulatorConfig, 'routeGeometry' | 'onPositionUpdate' | 'onRouteComplete'>>;
+    /** Pre-registered scenarios */
+    scenarios?: Scenario[];
+    /** Called when a scenario fires */
+    onScenarioFired?: (scenario: Scenario) => void;
+    /** Called when the route simulation finishes */
+    onRouteComplete?: () => void;
+}
+interface SimulatorControls$1 {
+    pause: () => void;
+    resume: () => void;
+    seek: (geometryIndex: number) => void;
+    setSpeed: (multiplier: 1 | 2 | 4 | 8) => void;
+}
+interface SessionControls {
+    start: (sessionId?: string) => void;
+    stop: () => SimSession | null;
+}
+interface UseSimulatorResult {
+    /** Current simulated position — null when inactive */
+    position: SimPosition | null;
+    /** Playback controls */
+    controls: SimulatorControls$1;
+    /** Recording controls */
+    session: SessionControls;
+    /** Whether a recording is in progress */
+    isRecording: boolean;
+}
+declare function useSimulator(options: UseSimulatorOptions): UseSimulatorResult;
+
+interface ScenarioLogEntry {
+    ts: number;
+    name: string;
+    type: string;
+}
+interface SimulatorControlsProps {
+    simulator: SimulatorControls$1;
+    session?: SessionControls;
+    style?: 'minimal' | 'full' | 'floating';
+    showScenarioLog?: boolean;
+    showSessionRecorder?: boolean;
+    scenarioLog?: ScenarioLogEntry[];
+    /** Current speed multiplier (controlled externally) */
+    currentSpeed?: 1 | 2 | 4 | 8;
+    /** Current engine state */
+    engineState?: 'idle' | 'running' | 'paused' | 'complete';
+    isRecording?: boolean;
+    onExportSession?: (session: SimSession) => void;
+    /** Additional style for the root container */
+    containerStyle?: object;
+}
+declare function SimulatorControls({ simulator, session, style, showScenarioLog, showSessionRecorder, scenarioLog, currentSpeed, engineState, isRecording, onExportSession, containerStyle, }: SimulatorControlsProps): react_jsx_runtime.JSX.Element;
+
+export { Scenario, type ScenarioLogEntry, SimPosition, SimSession, SimulatorConfig, SimulatorControls, useSimulator };