vehicle-path2 1.0.14 → 2.0.0

package/package.json

@@ -1,103 +1,83 @@
-{
-  "name": "vehicle-path2",
-  "version": "1.0.14",
-  "description": "Vehicle motion simulator library for dual-axle vehicle movement along paths composed of lines and Bezier curves",
-  "type": "module",
-  "main": "./dist/vehicle-path.cjs",
-  "module": "./dist/vehicle-path.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/vehicle-path.js"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/vehicle-path.cjs"
-      }
-    },
-    "./core": {
-      "import": {
-        "types": "./dist/core/index.d.ts",
-        "default": "./dist/core.js"
-      },
-      "require": {
-        "types": "./dist/core/index.d.cts",
-        "default": "./dist/core.cjs"
-      }
-    },
-    "./utils": {
-      "import": {
-        "types": "./dist/utils/index.d.ts",
-        "default": "./dist/utils.js"
-      },
-      "require": {
-        "types": "./dist/utils/index.d.cts",
-        "default": "./dist/utils.cjs"
-      }
-    },
-    "./react": {
-      "import": {
-        "types": "./dist/react/index.d.ts",
-        "default": "./dist/react.js"
-      },
-      "require": {
-        "types": "./dist/react/index.d.cts",
-        "default": "./dist/react.cjs"
-      }
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "dev": "vite build --watch",
-    "build": "vite build && tsc -p tsconfig.build.json",
-    "prepublishOnly": "npm run build",
-    "lint": "eslint .",
-    "test": "vitest",
-    "test:ui": "vitest --ui",
-    "test:coverage": "vitest --coverage"
-  },
-  "peerDependencies": {
-    "react": "^18.0.0 || ^19.0.0",
-    "react-dom": "^18.0.0 || ^19.0.0"
-  },
-  "devDependencies": {
-    "@eslint/js": "^9.39.1",
-    "@testing-library/react": "^16.3.1",
-    "@types/node": "^24.10.1",
-    "@types/react": "^19.2.5",
-    "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^5.1.1",
-    "@vitest/coverage-v8": "^4.0.16",
-    "@vitest/ui": "^4.0.16",
-    "eslint": "^9.39.1",
-    "eslint-plugin-react-hooks": "^7.0.1",
-    "eslint-plugin-react-refresh": "^0.4.24",
-    "globals": "^16.5.0",
-    "happy-dom": "^20.0.11",
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
-    "typescript": "~5.9.3",
-    "typescript-eslint": "^8.46.4",
-    "vite": "^7.2.4",
-    "vitest": "^4.0.16"
-  },
-  "keywords": [
-    "vehicle",
-    "path",
-    "bezier",
-    "simulation",
-    "animation",
-    "dual-axle",
-    "react"
-  ],
-  "author": "",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": ""
-  }
-}
+{
+  "name": "vehicle-path2",
+  "version": "2.0.0",
+  "description": "Vehicle motion simulator library for dual-axle vehicle movement along paths composed of lines and Bezier curves",
+  "type": "module",
+  "main": "./dist/vehicle-path.cjs",
+  "module": "./dist/vehicle-path.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/vehicle-path.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/vehicle-path.cjs"
+      }
+    },
+    "./core": {
+      "import": {
+        "types": "./dist/core/index.d.ts",
+        "default": "./dist/core.js"
+      },
+      "require": {
+        "types": "./dist/core/index.d.cts",
+        "default": "./dist/core.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "dev": "vite build --watch",
+    "build": "vite build && tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build",
+    "lint": "eslint .",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest --coverage"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@testing-library/react": "^16.3.1",
+    "@types/node": "^24.10.1",
+    "@types/react": "^19.2.5",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^5.1.1",
+    "@vitest/coverage-v8": "^4.0.16",
+    "@vitest/ui": "^4.0.16",
+    "eslint": "^9.39.1",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.4.24",
+    "globals": "^16.5.0",
+    "happy-dom": "^20.0.11",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "typescript": "~5.9.3",
+    "typescript-eslint": "^8.46.4",
+    "vite": "^7.2.4",
+    "vitest": "^4.0.16"
+  },
+  "keywords": [
+    "vehicle",
+    "path",
+    "bezier",
+    "simulation",
+    "animation",
+    "dual-axle",
+    "react"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  }
+}

package/dist/animation-loop-bZEm2pMN.js

@@ -1,37 +0,0 @@
-import { useRef as p, useEffect as d } from "react";
-function A(o) {
-  const { onTick: t, onComplete: a, onStart: i, onPause: c, onStop: f } = o;
-  let n = null, u = null, e = !1, l = !1;
-  const s = (r) => {
-    if (!e) return;
-    const m = u !== null ? r - u : 0;
-    if (u = r, t(m) === !1) {
-      e = !1, n = null, u = null, a?.();
-      return;
-    }
-    n = requestAnimationFrame(s);
-  };
-  return {
-    start: () => {
-      e || (e = !0, l = !1, u = null, i?.(), n = requestAnimationFrame(s));
-    },
-    pause: () => {
-      !e || l || (e = !1, l = !0, n !== null && (cancelAnimationFrame(n), n = null), c?.());
-    },
-    stop: () => {
-      e = !1, l = !1, u = null, n !== null && (cancelAnimationFrame(n), n = null), f?.();
-    },
-    isRunning: () => e,
-    isPaused: () => l
-  };
-}
-function q(o) {
-  const t = p(null);
-  return t.current || (t.current = A(o)), d(() => () => {
-    t.current?.stop();
-  }, []), t.current;
-}
-export {
-  A as c,
-  q as u
-};

package/dist/animation-loop-fC2LjxCd.cjs

@@ -1 +0,0 @@
-"use strict";const i=require("react");function a(s){const{onTick:t,onComplete:c,onStart:f,onPause:m,onStop:p}=s;let n=null,o=null,e=!1,u=!1;const l=r=>{if(!e)return;const A=o!==null?r-o:0;if(o=r,t(A)===!1){e=!1,n=null,o=null,c?.();return}n=requestAnimationFrame(l)};return{start:()=>{e||(e=!0,u=!1,o=null,f?.(),n=requestAnimationFrame(l))},pause:()=>{!e||u||(e=!1,u=!0,n!==null&&(cancelAnimationFrame(n),n=null),m?.())},stop:()=>{e=!1,u=!1,o=null,n!==null&&(cancelAnimationFrame(n),n=null),p?.()},isRunning:()=>e,isPaused:()=>u}}function d(s){const t=i.useRef(null);return t.current||(t.current=a(s)),i.useEffect(()=>()=>{t.current?.stop()},[]),t.current}exports.createAnimationLoop=a;exports.useAnimationLoop=d;

package/dist/react/dsl-hooks/useInitialMovement.d.ts

@@ -1,24 +0,0 @@
-import type { Line } from '../../core/types/geometry';
-interface UseInitialMovementProps {
-    lines: Line[];
-    wheelbase: number;
-}
-/**
- * DSL wrapper for useVehicles hook.
- *
- * This hook provides text-based vehicle initialization that internally uses
- * the programmatic useVehicles API as the single source of truth.
- *
- * @deprecated Use `useVehicleSimulation.loadFromDSL()` instead. This hook will be removed in a future version.
- * The new unified hook provides a simpler API for loading DSL definitions that includes
- * scene, vehicles, and movements in a single call.
- */
-export declare function useInitialMovement({ lines, wheelbase }: UseInitialMovementProps): {
-    vehicles: import("../..").Vehicle[];
-    initialMovementText: string;
-    movementError: string | null;
-    isDebouncing: boolean;
-    debounceKey: number;
-    setInitialMovementText: (text: string) => void;
-};
-export {};

package/dist/react/dsl-hooks/useMovementSequence.d.ts

@@ -1,27 +0,0 @@
-import type { Line } from '../../core/types/geometry';
-import type { Vehicle } from '../../core/types/vehicle';
-import { type MovementCommand } from '../../utils/dsl-parser';
-interface UseMovementSequenceProps {
-    lines: Line[];
-    vehicles: Vehicle[];
-}
-/**
- * DSL wrapper for useMovementQueue hook.
- *
- * This hook provides text-based movement commands that internally uses
- * the programmatic useMovementQueue API as the single source of truth.
- *
- * @deprecated Use `useVehicleSimulation.loadFromDSL()` instead. This hook will be removed in a future version.
- * The new unified hook provides a simpler API for loading DSL definitions that includes
- * scene, vehicles, and movements in a single call.
- */
-export declare function useMovementSequence({ lines, vehicles }: UseMovementSequenceProps): {
-    movementSequenceText: string;
-    gotoCommands: MovementCommand[];
-    vehicleQueues: Map<string, import("../..").GotoCommand[]>;
-    sequenceError: string | null;
-    isDebouncing: boolean;
-    debounceKey: number;
-    setMovementSequenceText: (text: string) => void;
-};
-export {};

package/dist/react/dsl-hooks/useSceneDefinition.d.ts

@@ -1,22 +0,0 @@
-import type { Line, Curve } from '../../core/types/geometry';
-/**
- * DSL wrapper for useScene hook.
- *
- * This hook provides text-based scene definition that internally uses
- * the programmatic useScene API as the single source of truth.
- *
- * @deprecated Use `useVehicleSimulation.loadFromDSL()` instead. This hook will be removed in a future version.
- * The new unified hook provides a simpler API for loading DSL definitions that includes
- * scene, vehicles, and movements in a single call.
- */
-export declare function useSceneDefinition(): {
-    lines: Line[];
-    curves: Curve[];
-    sceneDefinitionText: string;
-    sceneError: string | null;
-    isDebouncing: boolean;
-    debounceKey: number;
-    setLines: (newLines: Line[] | ((prev: Line[]) => Line[])) => void;
-    setCurves: (newCurves: Curve[] | ((prev: Curve[]) => Curve[])) => void;
-    setSceneDefinitionText: (text: string) => void;
-};

package/dist/react/hooks/useAnimation.d.ts

@@ -1,47 +0,0 @@
-import type { Line } from '../../core/types/geometry';
-import type { Vehicle, GotoCommand } from '../../core/types/vehicle';
-import type { TangentMode } from '../../core/types/config';
-import type { VehicleEventEmitter } from '../../utils/event-emitter';
-export interface UseAnimationProps {
-    vehicles: Vehicle[];
-    lines: Line[];
-    vehicleQueues: Map<string, GotoCommand[]>;
-    /** Get current queues immediately (bypasses React state timing) */
-    getVehicleQueues?: () => Map<string, GotoCommand[]>;
-    wheelbase: number;
-    tangentMode: TangentMode;
-    curves: import('../../core/types/geometry').Curve[];
-    eventEmitter?: VehicleEventEmitter;
-}
-/**
- * Hook for running vehicle animation/simulation.
- *
- * This hook handles the actual movement of vehicles along paths.
- * Call prepare() before starting, then tick() in your animation loop.
- *
- * @example
- * ```typescript
- * const { movingVehicles, prepare, tick, reset, isMoving } = useAnimation({
- *   vehicles, lines, vehicleQueues, wheelbase: 30, tangentMode: 'proportional-40', curves
- * })
- *
- * // Start animation
- * prepare()
- *
- * // In animation loop
- * const animate = () => {
- *   if (tick(5)) requestAnimationFrame(animate)
- * }
- * ```
- */
-export declare function useAnimation({ vehicles, lines, vehicleQueues, getVehicleQueues, wheelbase, tangentMode, curves, eventEmitter }: UseAnimationProps): {
-    movingVehicles: Vehicle[];
-    getMovingVehicles: () => Vehicle[];
-    prepare: () => boolean;
-    tick: (distance: number) => boolean;
-    reset: () => void;
-    resetVehicle: (vehicleId: string) => void;
-    continueVehicle: (vehicleId: string) => boolean;
-    isMoving: () => boolean;
-    isPrepared: boolean;
-};

package/dist/react/hooks/useMovementQueue.d.ts

@@ -1,53 +0,0 @@
-import type { Line, Curve } from '../../core/types/geometry';
-import type { Vehicle, GotoCommand } from '../../core/types/vehicle';
-import type { GotoCommandInput } from '../../core/types/api';
-export interface UseMovementQueueProps {
-    vehicles: Vehicle[];
-    lines: Line[];
-    curves: Curve[];
-}
-export interface UseMovementQueueResult {
-    /** Queue of commands per vehicle */
-    vehicleQueues: Map<string, GotoCommand[]>;
-    /** Get current queues immediately (bypasses React state timing) */
-    getVehicleQueues: () => Map<string, GotoCommand[]>;
-    /** Queue a movement command for a vehicle */
-    queueMovement: (vehicleId: string, input: GotoCommandInput) => {
-        success: boolean;
-        error?: string;
-    };
-    /** Clear the queue for a specific vehicle or all vehicles */
-    clearQueue: (vehicleId?: string) => {
-        success: boolean;
-        error?: string;
-    };
-    /** Any error from the last operation */
-    error: string | null;
-    /** @internal Load pre-computed queues directly (for bulk loading) */
-    _loadQueues: (queues: Map<string, GotoCommand[]>) => void;
-}
-/**
- * Hook for managing the queue of movement commands.
- *
- * This hook provides a simple API for queuing goto commands at runtime.
- *
- * @example
- * ```typescript
- * const { vehicleQueues, queueMovement, clearQueue } = useMovementQueue({ vehicles, lines, curves })
- *
- * // Queue movements
- * queueMovement('v1', { targetLineId: 'line002', targetPosition: 0.5 })
- * queueMovement('v1', {
- *   targetLineId: 'line003',
- *   targetPosition: 1.0,
- *   payload: { orderId: '123' }
- * })
- *
- * // Clear queue for a specific vehicle
- * clearQueue('v1')
- *
- * // Clear all queues
- * clearQueue()
- * ```
- */
-export declare function useMovementQueue({ vehicles, lines }: UseMovementQueueProps): UseMovementQueueResult;

package/dist/react/hooks/useScene.d.ts

@@ -1,78 +0,0 @@
-import type { Line, Curve } from '../../core/types/geometry';
-import type { SceneConfig, SceneLineInput, SceneConnectionInput, CoordinateInput, ConnectionUpdateInput } from '../../core/types/api';
-export interface UseSceneResult {
-    /** Current lines in the scene */
-    lines: Line[];
-    /** Current curves (connections) in the scene */
-    curves: Curve[];
-    /** Set the entire scene configuration */
-    setScene: (config: SceneConfig) => {
-        success: boolean;
-        errors?: string[];
-    };
-    /** Add a single line to the scene */
-    addLine: (line: SceneLineInput) => {
-        success: boolean;
-        error?: string;
-    };
-    /** Update a line's start and/or end coordinates */
-    updateLine: (lineId: string, updates: {
-        start?: CoordinateInput;
-        end?: CoordinateInput;
-    }) => {
-        success: boolean;
-        error?: string;
-    };
-    /** Remove a line from the scene */
-    removeLine: (lineId: string) => {
-        success: boolean;
-        error?: string;
-    };
-    /** Add a connection between two lines */
-    addConnection: (connection: SceneConnectionInput) => {
-        success: boolean;
-        error?: string;
-    };
-    /** Update a connection's offset values */
-    updateConnection: (fromLineId: string, toLineId: string, updates: ConnectionUpdateInput) => {
-        success: boolean;
-        error?: string;
-    };
-    /** Remove a connection */
-    removeConnection: (fromLineId: string, toLineId: string) => {
-        success: boolean;
-        error?: string;
-    };
-    /** Clear all lines and curves */
-    clear: () => void;
-    /** Any validation errors from the last operation */
-    error: string | null;
-    /** @internal Load pre-computed scene data directly (for bulk loading) */
-    _loadScene: (lines: Line[], curves: Curve[]) => void;
-}
-/**
- * Hook for managing scene configuration programmatically.
- *
- * This hook provides a simple API for creating and managing scenes without DSL.
- * It's designed to be the backbone of the vehicle-path library.
- *
- * @example
- * ```typescript
- * const { lines, curves, setScene, addLine } = useScene()
- *
- * // Set entire scene at once
- * setScene({
- *   lines: [
- *     { id: 'line001', start: [100, 100], end: [500, 100] },
- *     { id: 'line002', start: [500, 100], end: [500, 400] }
- *   ],
- *   connections: [
- *     { from: 'line001', to: 'line002' }
- *   ]
- * })
- *
- * // Or add lines incrementally
- * addLine({ id: 'line003', start: [500, 400], end: [100, 400] })
- * ```
- */
-export declare function useScene(): UseSceneResult;

package/dist/react/hooks/useVehicleSimulation.d.ts

@@ -1,128 +0,0 @@
-import type { SceneLineInput, CoordinateInput, VehicleInput, VehicleUpdateInput, GotoInput, SimulationConfig, ConnectionUpdateInput } from '../../core/types/api';
-import type { Line, Curve } from '../../core/types/geometry';
-import type { Vehicle, GotoCommand } from '../../core/types/vehicle';
-import type { TangentMode } from '../../core/types/config';
-import type { VehicleEventEmitter } from '../../utils/event-emitter';
-/**
- * Warning types for edge case detection
- */
-export interface SimulationWarning {
-    type: 'vehicle_on_removed_line' | 'movement_queue_cleared' | 'orphaned_connection' | 'dsl_parse_error';
-    message: string;
-    details?: {
-        lineId?: string;
-        vehicleId?: string;
-        vehicleIds?: string[];
-        connectionCount?: number;
-        errors?: string[];
-    };
-}
-/**
- * Result type with warnings for operations that may have side effects
- */
-export interface SimulationResult {
-    success: boolean;
-    error?: string;
-    warnings?: SimulationWarning[];
-}
-export interface UseVehicleSimulationProps {
-    wheelbase: number;
-    tangentMode?: TangentMode;
-    eventEmitter?: VehicleEventEmitter;
-}
-export interface UseVehicleSimulationResult {
-    lines: Line[];
-    curves: Curve[];
-    vehicles: Vehicle[];
-    movingVehicles: Vehicle[];
-    getMovingVehicles: () => Vehicle[];
-    vehicleQueues: Map<string, GotoCommand[]>;
-    error: string | null;
-    addLine: (line: SceneLineInput) => SimulationResult;
-    updateLine: (lineId: string, updates: {
-        start?: CoordinateInput;
-        end?: CoordinateInput;
-    }) => SimulationResult;
-    removeLine: (lineId: string) => SimulationResult;
-    clearScene: () => void;
-    connect: (fromLineId: string, toLineId: string, options?: {
-        fromOffset?: number;
-        fromIsPercentage?: boolean;
-        toOffset?: number;
-        toIsPercentage?: boolean;
-    }) => SimulationResult;
-    updateConnection: (fromLineId: string, toLineId: string, updates: ConnectionUpdateInput) => SimulationResult;
-    disconnect: (fromLineId: string, toLineId: string) => SimulationResult;
-    addVehicles: (input: VehicleInput | VehicleInput[]) => SimulationResult;
-    updateVehicle: (vehicleId: string, updates: VehicleUpdateInput) => SimulationResult;
-    removeVehicle: (vehicleId: string) => SimulationResult;
-    clearVehicles: () => void;
-    goto: (input: GotoInput) => SimulationResult;
-    clearQueue: (vehicleId?: string) => SimulationResult;
-    prepare: () => boolean;
-    tick: (distance: number) => boolean;
-    reset: () => void;
-    resetVehicle: (vehicleId: string) => void;
-    continueVehicle: (vehicleId: string) => boolean;
-    isMoving: () => boolean;
-    loadFromDSL: (dsl: string) => SimulationResult;
-    loadFromJSON: (config: SimulationConfig) => SimulationResult;
-    getVehiclesOnLine: (lineId: string) => Vehicle[];
-    hasVehiclesOnLine: (lineId: string) => boolean;
-}
-/**
- * Single entrypoint hook for vehicle path simulation.
- *
- * This hook provides a clean, DSL-like API that combines all functionality:
- * scene management, vehicles, movement commands, and animation.
- *
- * @example
- * ```typescript
- * const sim = useVehicleSimulation({ wheelbase: 30, tangentMode: 'proportional-40' })
- *
- * // Scene (mirrors DSL: "line001 : (141, 513) -> (362, 121)")
- * sim.addLine({ id: 'line001', start: [141, 513], end: [362, 121] })
- * sim.updateLine('line001', { end: [400, 150] })  // for drag
- * sim.removeLine('line001')
- *
- * // Connection (mirrors DSL: "line001 80% -> line002 20%")
- * sim.connect('line001', 'line002', { fromOffset: 0.8, toOffset: 0.2 })
- * sim.connect('line001', 'line002', { fromOffset: 150, fromIsPercentage: false, toOffset: 50, toIsPercentage: false })
- * sim.disconnect('line001', 'line002')
- *
- * // Vehicle (mirrors DSL: "v1 start line001 0")
- * sim.addVehicles({ id: 'v1', lineId: 'line001', position: 0 })
- * sim.removeVehicle('v1')
- *
- * // Movement (mirrors DSL: "v1 goto line001 100%")
- * sim.goto({ id: 'v1', lineId: 'line001', position: 1.0 })
- * sim.goto({ id: 'v1', lineId: 'line001', position: 150, isPercentage: false })
- *
- * // Animation
- * sim.prepare()
- * sim.tick(5)
- * sim.reset()
- *
- * // DSL Loading
- * sim.loadFromDSL(\`
- *   line001 : (0, 0) -> (400, 0)
- *   v1 start line001 0%
- *   v1 goto line001 100%
- * \`)
- *
- * // JSON Loading
- * sim.loadFromJSON({
- *   lines: [
- *     { id: 'line001', start: [0, 0], end: [400, 0] },
- *     { id: 'line002', start: [400, 0], end: [400, 300] }
- *   ],
- *   connections: [{ from: 'line001', to: 'line002' }],
- *   vehicles: [{ id: 'v1', lineId: 'line001', position: 0 }],
- *   movements: [
- *     { vehicleId: 'v1', targetLineId: 'line001', targetPosition: 1.0 },
- *     { vehicleId: 'v1', targetLineId: 'line002', targetPosition: 1.0 }
- *   ]
- * })
- * ```
- */
-export declare function useVehicleSimulation({ wheelbase, tangentMode, eventEmitter }: UseVehicleSimulationProps): UseVehicleSimulationResult;

package/dist/react/hooks/useVehicles.d.ts

@@ -1,55 +0,0 @@
-import type { Line } from '../../core/types/geometry';
-import type { Vehicle } from '../../core/types/vehicle';
-import type { VehicleInput, VehicleUpdateInput } from '../../core/types/api';
-export interface UseVehiclesProps {
-    lines: Line[];
-    wheelbase: number;
-}
-export interface UseVehiclesResult {
-    /** Current vehicles in the scene */
-    vehicles: Vehicle[];
-    /** Add one or more vehicles to the scene */
-    addVehicles: (input: VehicleInput | VehicleInput[]) => {
-        success: boolean;
-        errors?: string[];
-    };
-    /** Update a vehicle's position or line (only when idle) */
-    updateVehicle: (vehicleId: string, updates: VehicleUpdateInput) => {
-        success: boolean;
-        error?: string;
-    };
-    /** Remove a vehicle from the scene */
-    removeVehicle: (vehicleId: string) => {
-        success: boolean;
-        error?: string;
-    };
-    /** Clear all vehicles */
-    clear: () => void;
-    /** Any error from the last operation */
-    error: string | null;
-    /** @internal Load pre-computed vehicles directly (for bulk loading) */
-    _loadVehicles: (vehicles: Vehicle[]) => void;
-}
-/**
- * Hook for managing vehicles programmatically.
- *
- * This hook provides a simple API for adding and removing vehicles at runtime.
- *
- * @example
- * ```typescript
- * const { vehicles, addVehicles, removeVehicle } = useVehicles({ lines, wheelbase: 30 })
- *
- * // Add single vehicle
- * addVehicles({ id: 'v1', lineId: 'line001', position: 0.5 })
- *
- * // Add multiple vehicles
- * addVehicles([
- *   { id: 'v1', lineId: 'line001', position: 0 },
- *   { id: 'v2', lineId: 'line002', position: 0.5 }
- * ])
- *
- * // Remove a vehicle
- * removeVehicle('v1')
- * ```
- */
-export declare function useVehicles({ lines, wheelbase }: UseVehiclesProps): UseVehiclesResult;