vehicle-path2 1.0.15 → 2.0.0

package/dist/core/algorithms/pathFinding.d.ts

@@ -41,7 +41,7 @@ export declare function calculateBezierArcLength(bezier: BezierCurve, segments?:
  *
  * Effective range: [wheelbase, lineLength]
  */
-export declare function resolveFromLineOffset(line: Line, offset: number | undefined, isPercentage: boolean | undefined, defaultPercentage: number, wheelbase: number): number;
+export declare function resolveFromLineOffset(line: Line, offset: number | undefined, isPercentage: boolean | undefined, defaultPercentage: number, maxWheelbase: number): number;
 /**
  * Resolve offset untuk TO line (garis tujuan kurva)
  * - 0% → 0 (awal garis)
@@ -49,7 +49,7 @@ export declare function resolveFromLineOffset(line: Line, offset: number | undef
  *
  * Effective range: [0, lineLength - wheelbase]
  */
-export declare function resolveToLineOffset(line: Line, offset: number | undefined, isPercentage: boolean | undefined, defaultPercentage: number, wheelbase: number): number;
+export declare function resolveToLineOffset(line: Line, offset: number | undefined, isPercentage: boolean | undefined, defaultPercentage: number, maxWheelbase: number): number;
 /**
  * Membangun graph dari lines dan curves
  */

package/dist/core/algorithms/vehicleMovement.d.ts

@@ -55,6 +55,16 @@ export declare function calculateFrontAxlePosition(path: PathResult, rearSegment
     segmentIndex: number;
     segmentDistance: number;
 } | null;
+/**
+ * Hitung posisi awal semua axle dari posisi rearmost axle.
+ *
+ * @param lineId - Line ID tempat vehicle diinisialisasi
+ * @param rearOffset - Absolute offset axle paling belakang (axles[N-1])
+ * @param axleSpacings - Jarak antar axle berurutan (N-1 nilai untuk N axle)
+ * @param line - Line object untuk kalkulasi posisi
+ * @returns Array AxleState, axles[0] = terdepan, axles[N-1] = paling belakang
+ */
+export declare function calculateInitialAxlePositions(lineId: string, rearOffset: number, axleSpacings: number[], line: Line): AxleState[];
 /**
  * Calculate initial front axle position from rear position
  *
@@ -173,26 +183,21 @@ export interface SegmentCompletionResult {
 export declare function handleArrival(state: VehicleMovementState, ctx: SegmentCompletionContext): SegmentCompletionResult;
 export type { VehicleMovementState as SegmentVehicleState };
 /**
- * Advance both axles of a vehicle by `distance` along a prepared path.
+ * Advance semua axle vehicle oleh `distance` sepanjang path.
  *
- * This is the low-level tick primitive. It updates both rear and front axles
- * using arc-length parameterization and returns whether the rear axle has
- * reached the end of the path (arrived).
+ * Ini adalah low-level tick primitive. Update semua axle menggunakan
+ * arc-length parameterization. Arrival = axles[0] (terdepan) mencapai ujung path.
  *
- * @param rear - Current rear axle state
- * @param front - Current front axle state
- * @param rearExecution - Current rear axle execution position in path
- * @param frontExecution - Current front axle execution position in path
- * @param path - The path to follow
- * @param distance - Distance to advance this tick
- * @param linesMap - Scene lines map for position calculation
- * @param curveDataMap - Pre-built bezier curve data for the path's curve segments
- * @returns Updated axle states, execution states, and arrival flag
- */
-export declare function moveVehicle(rear: AxleState, front: AxleState, rearExecution: AxleExecutionState, frontExecution: AxleExecutionState, path: PathResult, distance: number, linesMap: Map<string, Line>, curveDataMap: Map<number, CurveData>): {
-    rear: AxleState;
-    front: AxleState;
-    rearExecution: AxleExecutionState;
-    frontExecution: AxleExecutionState;
+ * @param axleStates - Array AxleState saat ini, axles[0] = terdepan
+ * @param axleExecutions - Array AxleExecutionState sesuai urutan axleStates
+ * @param path - Path yang diikuti
+ * @param distance - Jarak yang dimaju per tick
+ * @param linesMap - Map line ID ke Line object
+ * @param curveDataMap - Pre-built bezier curve data
+ * @returns Updated axles, axleExecutions, dan arrival flag
+ */
+export declare function moveVehicle(axleStates: AxleState[], axleExecutions: AxleExecutionState[], path: PathResult, distance: number, linesMap: Map<string, Line>, curveDataMap: Map<number, CurveData>): {
+    axles: AxleState[];
+    axleExecutions: AxleExecutionState[];
     arrived: boolean;
 };

package/dist/core/engine.d.ts

@@ -30,24 +30,21 @@ import type { MovementConfig, CurveData } from './types/movement';
 import type { PathResult } from './algorithms/pathFinding';
 import type { TangentMode } from './types/config';
 export interface PathEngineConfig {
-    wheelbase: number;
+    maxWheelbase: number;
     tangentMode: TangentMode;
 }
 /**
- * Simplified dual-axle position state for use with PathEngine.
- * A flatter alternative to the internal Vehicle type.
+ * Multi-axle position state for use with PathEngine.
+ * axles[0] = terdepan, axles[N-1] = paling belakang.
  */
 export interface VehiclePathState {
-    rear: {
+    axles: Array<{
         lineId: string;
         offset: number;
         position: Point;
-    };
-    front: {
-        lineId: string;
-        offset: number;
-        position: Point;
-    };
+    }>;
+    /** N-1 jarak arc-length antar axle berurutan */
+    axleSpacings: number[];
 }
 /**
  * Active path execution state for a vehicle in motion.
@@ -56,11 +53,11 @@ export interface VehiclePathState {
 export interface PathExecution {
     path: PathResult;
     curveDataMap: Map<number, CurveData>;
-    rearSegmentIndex: number;
-    rearSegmentDistance: number;
-    frontSegmentIndex: number;
-    frontSegmentDistance: number;
-    /** Resolved absolute target offset for rear axle arrival detection */
+    /** Execution state per axle, sesuai urutan VehiclePathState.axles */
+    axleExecutions: Array<{
+        segmentIndex: number;
+        segmentDistance: number;
+    }>;
     targetLineId: string;
     targetOffset: number;
 }
@@ -126,13 +123,14 @@ export declare class PathEngine {
      */
     removeCurve(index: number): boolean;
     /**
-     * Initialize a vehicle's dual-axle position on a line.
+     * Initialize a vehicle's N-axle position on a line.
      *
      * @param lineId - The line to place the vehicle on
-     * @param offset - Absolute distance offset along the line
+     * @param rearOffset - Absolute distance offset untuk axle paling belakang
+     * @param axleSpacings - Jarak antar axle berurutan (N-1 nilai untuk N axle)
      * @returns Initial VehiclePathState, or null if lineId does not exist
      */
-    initializeVehicle(lineId: string, offset: number): VehiclePathState | null;
+    initializeVehicle(lineId: string, rearOffset: number, axleSpacings: number[]): VehiclePathState | null;
     /**
      * Prepare a path from the vehicle's current position to a target.
      *

package/dist/core/index.d.ts

@@ -16,6 +16,6 @@ export type { CurveData, AxleExecutionState, PathExecutionState, VehicleMovement
 export type { TangentMode } from './types/config';
 export type { CoordinateInput, SceneLineInput, SceneConnectionInput, SceneConfig, VehicleInput, VehicleUpdateInput, ConnectionUpdateInput, GotoCommandInput } from './types/api';
 export { buildGraph, findPath, calculateBezierArcLength, resolveFromLineOffset, resolveToLineOffset, type Graph, type GraphEdge, type PathSegment, type PathResult, type VehiclePosition } from './algorithms/pathFinding';
-export { initializeMovingVehicle, createInitialMovementState, initializeAllVehicles, calculateInitialFrontPosition, type InitializationResult, updateAxlePosition, calculatePositionOnLine, calculatePositionOnCurve, calculateFrontAxlePosition, getCumulativeArcLength, arcLengthToSegmentPosition, prepareCommandPath, type PreparedPath, handleArrival, type SegmentCompletionContext, type SegmentCompletionResult, type SegmentVehicleState, moveVehicle, getPositionFromOffset, getLineLength } from './algorithms/vehicleMovement';
+export { initializeMovingVehicle, createInitialMovementState, initializeAllVehicles, calculateInitialAxlePositions, type InitializationResult, updateAxlePosition, calculatePositionOnLine, calculatePositionOnCurve, calculateFrontAxlePosition, getCumulativeArcLength, arcLengthToSegmentPosition, prepareCommandPath, type PreparedPath, handleArrival, type SegmentCompletionContext, type SegmentCompletionResult, type SegmentVehicleState, moveVehicle, getPositionFromOffset, getLineLength } from './algorithms/vehicleMovement';
 export { PathEngine, type PathEngineConfig, type VehiclePathState, type PathExecution } from './engine';
 export { distance, normalize, getPointOnLine, getPointOnLineByOffset, getPointOnBezier, createBezierCurve, buildArcLengthTable, distanceToT, getArcLength, calculateTangentLength, isPointNearPoint, type ArcLengthEntry, type CurveOffsetOptions } from './algorithms/math';

package/dist/core/types/api.d.ts

@@ -70,6 +70,15 @@ export interface VehicleInput {
     lineId: string;
     position?: number;
     isPercentage?: boolean;
+    /**
+     * Jarak arc-length antar axle berurutan.
+     * axleSpacings[i] = jarak antara axles[i] dan axles[i+1].
+     * axles[0] = terdepan, axles[N-1] = paling belakang.
+     * Contoh truk biasa: [30]  →  2 axle, jarak 30px
+     * Contoh truck+trailer: [20, 45]  →  3 axle
+     * Total panjang vehicle = sum(axleSpacings) harus ≤ maxWheelbase
+     */
+    axleSpacings: number[];
 }
 /**
  * Vehicle update input for updateVehicle()

package/dist/core/types/movement.d.ts

@@ -27,8 +27,7 @@ export interface PathExecutionState {
     path: import('../algorithms/pathFinding').PathResult;
     curveDataMap: Map<number, CurveData>;
     currentCommandIndex: number;
-    rear: AxleExecutionState;
-    front: AxleExecutionState;
+    axles: AxleExecutionState[];
 }
 /**
  * Movement state container for a vehicle
@@ -41,7 +40,7 @@ export interface VehicleMovementState {
  * Configuration for vehicle movement
  */
 export interface MovementConfig {
-    wheelbase: number;
+    maxWheelbase: number;
     tangentMode: TangentMode;
 }
 /**

package/dist/core/types/vehicle.d.ts

@@ -14,6 +14,8 @@ export interface VehicleStart {
     lineId: string;
     offset: number;
     isPercentage: boolean;
+    /** Optional: defaults to [maxWheelbase] jika tidak disediakan */
+    axleSpacings?: number[];
 }
 /**
  * State for a single axle (Front or Rear)
@@ -32,8 +34,8 @@ export interface Vehicle {
     offset: number;
     isPercentage: boolean;
     state: VehicleState;
-    rear: AxleState;
-    front: AxleState;
+    axles: AxleState[];
+    axleSpacings: number[];
 }
 /**
  * Command to move a vehicle to a target position

package/dist/core.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("./vehicleMovement-BiYBE_2a.cjs");class g{graph=null;linesMap=new Map;curves=[];config;constructor(e){this.config={wheelbase:e.wheelbase,tangentMode:e.tangentMode}}get movementConfig(){return this.config}get lines(){return Array.from(this.linesMap.values())}getCurves(){return this.curves}setScene(e,i){this.linesMap.clear();for(const n of e)this.linesMap.set(n.id,n);this.curves=i,this.graph=t.buildGraph(e,i,this.config)}addLine(e){return this.linesMap.has(e.id)?!1:(this.linesMap.set(e.id,e),this.graph=t.buildGraph(Array.from(this.linesMap.values()),this.curves,this.config),!0)}updateLine(e,i){const n=this.linesMap.get(e);return n?(i.start&&(n.start=i.start),i.end&&(n.end=i.end),this.graph=t.buildGraph(Array.from(this.linesMap.values()),this.curves,this.config),!0):!1}updateLineEndpoint(e,i,n){return this.updateLine(e,{[i]:n})}renameLine(e,i){const n=i.trim();if(!n)return{success:!1,error:"Name cannot be empty"};if(n===e)return{success:!0};if(this.linesMap.has(n))return{success:!1,error:`"${n}" already exists`};const a=this.linesMap.get(e);if(!a)return{success:!1,error:`Line "${e}" not found`};a.id=n,this.linesMap.delete(e),this.linesMap.set(n,a);for(const s of this.curves)s.fromLineId===e&&(s.fromLineId=n),s.toLineId===e&&(s.toLineId=n);return this.graph=t.buildGraph(Array.from(this.linesMap.values()),this.curves,this.config),{success:!0}}removeLine(e){return this.linesMap.has(e)?(this.linesMap.delete(e),this.curves=this.curves.filter(i=>i.fromLineId!==e&&i.toLineId!==e),this.graph=t.buildGraph(Array.from(this.linesMap.values()),this.curves,this.config),!0):!1}addCurve(e){this.curves.push(e),this.graph=t.buildGraph(Array.from(this.linesMap.values()),this.curves,this.config)}updateCurve(e,i){return e<0||e>=this.curves.length?!1:(this.curves[e]={...this.curves[e],...i},this.graph=t.buildGraph(Array.from(this.linesMap.values()),this.curves,this.config),!0)}removeCurve(e){return e<0||e>=this.curves.length?!1:(this.curves.splice(e,1),this.graph=t.buildGraph(Array.from(this.linesMap.values()),this.curves,this.config),!0)}initializeVehicle(e,i){const n=this.linesMap.get(e);if(!n)return null;const a=t.getLineLength(n),s=Math.min(i,a-this.config.wheelbase),l=t.getPositionFromOffset(n,s),o=t.calculateInitialFrontPosition(e,s,this.config.wheelbase,n);return{rear:{lineId:e,offset:s,position:l},front:{lineId:o.lineId,offset:o.absoluteOffset,position:o.position}}}preparePath(e,i,n,a=!1){if(!this.graph)return null;const s={lineId:e.rear.lineId,offset:e.rear.offset,rear:{lineId:e.rear.lineId,position:e.rear.position,absoluteOffset:e.rear.offset},front:{lineId:e.front.lineId,position:e.front.position,absoluteOffset:e.front.offset}},l={targetLineId:i,targetOffset:n,isPercentage:a},o={graph:this.graph,linesMap:this.linesMap,curves:this.curves,config:this.config},r=t.prepareCommandPath(s,l,o);if(!r)return null;let c=n;const f=this.linesMap.get(i);if(f){const u=t.getLineLength(f),h=Math.max(0,u-this.config.wheelbase);c=a?n*h:Math.min(n,h)}return{path:r.path,curveDataMap:r.curveDataMap,rearSegmentIndex:0,rearSegmentDistance:0,frontSegmentIndex:0,frontSegmentDistance:this.config.wheelbase,targetLineId:i,targetOffset:c}}moveVehicle(e,i,n){const a={lineId:e.rear.lineId,position:e.rear.position,absoluteOffset:e.rear.offset},s={lineId:e.front.lineId,position:e.front.position,absoluteOffset:e.front.offset},l={currentSegmentIndex:i.rearSegmentIndex,segmentDistance:i.rearSegmentDistance},o={currentSegmentIndex:i.frontSegmentIndex,segmentDistance:i.frontSegmentDistance},r=t.moveVehicle(a,s,l,o,i.path,n,this.linesMap,i.curveDataMap);return{state:{rear:{lineId:r.rear.lineId,offset:r.rear.absoluteOffset,position:r.rear.position},front:{lineId:r.front.lineId,offset:r.front.absoluteOffset,position:r.front.position}},execution:{...i,rearSegmentIndex:r.rearExecution.currentSegmentIndex,rearSegmentDistance:r.rearExecution.segmentDistance,frontSegmentIndex:r.frontExecution.currentSegmentIndex,frontSegmentDistance:r.frontExecution.segmentDistance},arrived:r.arrived}}}exports.arcLengthToSegmentPosition=t.arcLengthToSegmentPosition;exports.buildArcLengthTable=t.buildArcLengthTable;exports.buildGraph=t.buildGraph;exports.calculateBezierArcLength=t.calculateBezierArcLength;exports.calculateFrontAxlePosition=t.calculateFrontAxlePosition;exports.calculateInitialFrontPosition=t.calculateInitialFrontPosition;exports.calculatePositionOnCurve=t.calculatePositionOnCurve;exports.calculatePositionOnLine=t.calculatePositionOnLine;exports.calculateTangentLength=t.calculateTangentLength;exports.createBezierCurve=t.createBezierCurve;exports.createInitialMovementState=t.createInitialMovementState;exports.distance=t.distance;exports.distanceToT=t.distanceToT;exports.findPath=t.findPath;exports.getArcLength=t.getArcLength;exports.getCumulativeArcLength=t.getCumulativeArcLength;exports.getLineLength=t.getLineLength;exports.getPointOnBezier=t.getPointOnBezier;exports.getPointOnLine=t.getPointOnLine;exports.getPointOnLineByOffset=t.getPointOnLineByOffset;exports.getPositionFromOffset=t.getPositionFromOffset;exports.handleArrival=t.handleArrival;exports.initializeAllVehicles=t.initializeAllVehicles;exports.initializeMovingVehicle=t.initializeMovingVehicle;exports.isPointNearPoint=t.isPointNearPoint;exports.moveVehicle=t.moveVehicle;exports.normalize=t.normalize;exports.prepareCommandPath=t.prepareCommandPath;exports.resolveFromLineOffset=t.resolveFromLineOffset;exports.resolveToLineOffset=t.resolveToLineOffset;exports.updateAxlePosition=t.updateAxlePosition;exports.PathEngine=g;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./vehicle-path.cjs");exports.PathEngine=e.PathEngine;exports.arcLengthToSegmentPosition=e.arcLengthToSegmentPosition;exports.buildArcLengthTable=e.buildArcLengthTable;exports.buildGraph=e.buildGraph;exports.calculateBezierArcLength=e.calculateBezierArcLength;exports.calculateFrontAxlePosition=e.calculateFrontAxlePosition;exports.calculateInitialAxlePositions=e.calculateInitialAxlePositions;exports.calculatePositionOnCurve=e.calculatePositionOnCurve;exports.calculatePositionOnLine=e.calculatePositionOnLine;exports.calculateTangentLength=e.calculateTangentLength;exports.createBezierCurve=e.createBezierCurve;exports.createInitialMovementState=e.createInitialMovementState;exports.distance=e.distance;exports.distanceToT=e.distanceToT;exports.findPath=e.findPath;exports.getArcLength=e.getArcLength;exports.getCumulativeArcLength=e.getCumulativeArcLength;exports.getLineLength=e.getLineLength;exports.getPointOnBezier=e.getPointOnBezier;exports.getPointOnLine=e.getPointOnLine;exports.getPointOnLineByOffset=e.getPointOnLineByOffset;exports.getPositionFromOffset=e.getPositionFromOffset;exports.handleArrival=e.handleArrival;exports.initializeAllVehicles=e.initializeAllVehicles;exports.initializeMovingVehicle=e.initializeMovingVehicle;exports.isPointNearPoint=e.isPointNearPoint;exports.moveVehicle=e.moveVehicle;exports.normalize=e.normalize;exports.prepareCommandPath=e.prepareCommandPath;exports.resolveFromLineOffset=e.resolveFromLineOffset;exports.resolveToLineOffset=e.resolveToLineOffset;exports.updateAxlePosition=e.updateAxlePosition;

package/dist/core.js

@@ -1,243 +1,35 @@
-import { c as a, p as u, t as p, f as m, z as v, x as d } from "./vehicleMovement-TkCt4q_a.js";
-import { a as O, b as P, d as x, e as D, g as y, h as S, D as C, i as E, j as w, k as z, l as T, m as B, n as V, o as F, q as N, r as $, s as j, u as k, v as q, w as G, E as H, y as J, A as K, B as Q, C as R } from "./vehicleMovement-TkCt4q_a.js";
-class I {
-  graph = null;
-  linesMap = /* @__PURE__ */ new Map();
-  curves = [];
-  config;
-  constructor(e) {
-    this.config = {
-      wheelbase: e.wheelbase,
-      tangentMode: e.tangentMode
-    };
-  }
-  // ---------------------------------------------------------------------------
-  // Accessors
-  // ---------------------------------------------------------------------------
-  get movementConfig() {
-    return this.config;
-  }
-  get lines() {
-    return Array.from(this.linesMap.values());
-  }
-  getCurves() {
-    return this.curves;
-  }
-  // ---------------------------------------------------------------------------
-  // Scene management
-  // ---------------------------------------------------------------------------
-  /**
-   * Replace the entire scene and rebuild the graph.
-   */
-  setScene(e, t) {
-    this.linesMap.clear();
-    for (const s of e)
-      this.linesMap.set(s.id, s);
-    this.curves = t, this.graph = a(e, t, this.config);
-  }
-  /**
-   * Add a single line. Returns false if a line with the same ID already exists.
-   */
-  addLine(e) {
-    return this.linesMap.has(e.id) ? !1 : (this.linesMap.set(e.id, e), this.graph = a(Array.from(this.linesMap.values()), this.curves, this.config), !0);
-  }
-  /**
-   * Update start and/or end coordinates of an existing line.
-   */
-  updateLine(e, t) {
-    const s = this.linesMap.get(e);
-    return s ? (t.start && (s.start = t.start), t.end && (s.end = t.end), this.graph = a(Array.from(this.linesMap.values()), this.curves, this.config), !0) : !1;
-  }
-  /**
-   * Update a single endpoint ('start' or 'end') of a line.
-   */
-  updateLineEndpoint(e, t, s) {
-    return this.updateLine(e, { [t]: s });
-  }
-  /**
-   * Rename a line ID and cascade the change to all connected curves.
-   */
-  renameLine(e, t) {
-    const s = t.trim();
-    if (!s) return { success: !1, error: "Name cannot be empty" };
-    if (s === e) return { success: !0 };
-    if (this.linesMap.has(s)) return { success: !1, error: `"${s}" already exists` };
-    const i = this.linesMap.get(e);
-    if (!i) return { success: !1, error: `Line "${e}" not found` };
-    i.id = s, this.linesMap.delete(e), this.linesMap.set(s, i);
-    for (const r of this.curves)
-      r.fromLineId === e && (r.fromLineId = s), r.toLineId === e && (r.toLineId = s);
-    return this.graph = a(Array.from(this.linesMap.values()), this.curves, this.config), { success: !0 };
-  }
-  /**
-   * Remove a line and all curves connected to it.
-   */
-  removeLine(e) {
-    return this.linesMap.has(e) ? (this.linesMap.delete(e), this.curves = this.curves.filter((t) => t.fromLineId !== e && t.toLineId !== e), this.graph = a(Array.from(this.linesMap.values()), this.curves, this.config), !0) : !1;
-  }
-  /**
-   * Add a directional curve (connection) from one line to another.
-   */
-  addCurve(e) {
-    this.curves.push(e), this.graph = a(Array.from(this.linesMap.values()), this.curves, this.config);
-  }
-  /**
-   * Update a curve by index. Returns false if index is out of bounds.
-   */
-  updateCurve(e, t) {
-    return e < 0 || e >= this.curves.length ? !1 : (this.curves[e] = { ...this.curves[e], ...t }, this.graph = a(Array.from(this.linesMap.values()), this.curves, this.config), !0);
-  }
-  /**
-   * Remove a curve by index. Returns false if index is out of bounds.
-   */
-  removeCurve(e) {
-    return e < 0 || e >= this.curves.length ? !1 : (this.curves.splice(e, 1), this.graph = a(Array.from(this.linesMap.values()), this.curves, this.config), !0);
-  }
-  // ---------------------------------------------------------------------------
-  // Vehicle operations
-  // ---------------------------------------------------------------------------
-  /**
-   * Initialize a vehicle's dual-axle position on a line.
-   *
-   * @param lineId - The line to place the vehicle on
-   * @param offset - Absolute distance offset along the line
-   * @returns Initial VehiclePathState, or null if lineId does not exist
-   */
-  initializeVehicle(e, t) {
-    const s = this.linesMap.get(e);
-    if (!s) return null;
-    const i = u(s), r = Math.min(t, i - this.config.wheelbase), f = p(s, r), o = m(e, r, this.config.wheelbase, s);
-    return {
-      rear: { lineId: e, offset: r, position: f },
-      front: { lineId: o.lineId, offset: o.absoluteOffset, position: o.position }
-    };
-  }
-  /**
-   * Prepare a path from the vehicle's current position to a target.
-   *
-   * Must be called before moveVehicle(). Returns null if no path exists.
-   *
-   * @param vehicleState - Current vehicle state (from initializeVehicle or previous tick)
-   * @param targetLineId - ID of the target line
-   * @param targetOffset - Position on the target line
-   * @param isPercentage - If true, targetOffset is 0-1 fraction; if false, absolute distance
-   */
-  preparePath(e, t, s, i = !1) {
-    if (!this.graph) return null;
-    const r = {
-      lineId: e.rear.lineId,
-      offset: e.rear.offset,
-      rear: {
-        lineId: e.rear.lineId,
-        position: e.rear.position,
-        absoluteOffset: e.rear.offset
-      },
-      front: {
-        lineId: e.front.lineId,
-        position: e.front.position,
-        absoluteOffset: e.front.offset
-      }
-    }, f = {
-      targetLineId: t,
-      targetOffset: s,
-      isPercentage: i
-    }, o = {
-      graph: this.graph,
-      linesMap: this.linesMap,
-      curves: this.curves,
-      config: this.config
-    }, n = v(r, f, o);
-    if (!n) return null;
-    let c = s;
-    const l = this.linesMap.get(t);
-    if (l) {
-      const g = u(l), h = Math.max(0, g - this.config.wheelbase);
-      c = i ? s * h : Math.min(s, h);
-    }
-    return {
-      path: n.path,
-      curveDataMap: n.curveDataMap,
-      rearSegmentIndex: 0,
-      rearSegmentDistance: 0,
-      frontSegmentIndex: 0,
-      frontSegmentDistance: this.config.wheelbase,
-      targetLineId: t,
-      targetOffset: c
-    };
-  }
-  /**
-   * Advance a vehicle by `distance` along its prepared path.
-   *
-   * Call this every tick. The returned `state` and `execution` replace the
-   * previous values. When `arrived` is true, the vehicle has reached the target.
-   *
-   * @param state - Current vehicle state
-   * @param execution - Current path execution (from preparePath or previous tick)
-   * @param distance - Distance to advance this tick (speed × deltaTime)
-   */
-  moveVehicle(e, t, s) {
-    const i = {
-      lineId: e.rear.lineId,
-      position: e.rear.position,
-      absoluteOffset: e.rear.offset
-    }, r = {
-      lineId: e.front.lineId,
-      position: e.front.position,
-      absoluteOffset: e.front.offset
-    }, f = {
-      currentSegmentIndex: t.rearSegmentIndex,
-      segmentDistance: t.rearSegmentDistance
-    }, o = {
-      currentSegmentIndex: t.frontSegmentIndex,
-      segmentDistance: t.frontSegmentDistance
-    }, n = d(i, r, f, o, t.path, s, this.linesMap, t.curveDataMap);
-    return {
-      state: {
-        rear: { lineId: n.rear.lineId, offset: n.rear.absoluteOffset, position: n.rear.position },
-        front: { lineId: n.front.lineId, offset: n.front.absoluteOffset, position: n.front.position }
-      },
-      execution: {
-        ...t,
-        rearSegmentIndex: n.rearExecution.currentSegmentIndex,
-        rearSegmentDistance: n.rearExecution.segmentDistance,
-        frontSegmentIndex: n.frontExecution.currentSegmentIndex,
-        frontSegmentDistance: n.frontExecution.segmentDistance
-      },
-      arrived: n.arrived
-    };
-  }
-}
+import { PathEngine as i, arcLengthToSegmentPosition as n, buildArcLengthTable as a, buildGraph as o, calculateBezierArcLength as l, calculateFrontAxlePosition as r, calculateInitialAxlePositions as c, calculatePositionOnCurve as s, calculatePositionOnLine as g, c as h, createBezierCurve as P, createInitialMovementState as u, distance as L, distanceToT as f, findPath as m, getArcLength as v, getCumulativeArcLength as A, getLineLength as O, getPointOnBezier as d, getPointOnLine as z, getPointOnLineByOffset as T, getPositionFromOffset as p, handleArrival as x, initializeAllVehicles as B, initializeMovingVehicle as C, i as b, moveVehicle as F, normalize as V, prepareCommandPath as I, resolveFromLineOffset as M, resolveToLineOffset as S, updateAxlePosition as y } from "./vehicle-path.js";
 export {
-  I as PathEngine,
-  O as arcLengthToSegmentPosition,
-  P as buildArcLengthTable,
-  a as buildGraph,
-  x as calculateBezierArcLength,
-  D as calculateFrontAxlePosition,
-  m as calculateInitialFrontPosition,
-  y as calculatePositionOnCurve,
-  S as calculatePositionOnLine,
-  C as calculateTangentLength,
-  E as createBezierCurve,
-  w as createInitialMovementState,
-  z as distance,
-  T as distanceToT,
-  B as findPath,
-  V as getArcLength,
-  F as getCumulativeArcLength,
-  u as getLineLength,
-  N as getPointOnBezier,
-  $ as getPointOnLine,
-  j as getPointOnLineByOffset,
+  i as PathEngine,
+  n as arcLengthToSegmentPosition,
+  a as buildArcLengthTable,
+  o as buildGraph,
+  l as calculateBezierArcLength,
+  r as calculateFrontAxlePosition,
+  c as calculateInitialAxlePositions,
+  s as calculatePositionOnCurve,
+  g as calculatePositionOnLine,
+  h as calculateTangentLength,
+  P as createBezierCurve,
+  u as createInitialMovementState,
+  L as distance,
+  f as distanceToT,
+  m as findPath,
+  v as getArcLength,
+  A as getCumulativeArcLength,
+  O as getLineLength,
+  d as getPointOnBezier,
+  z as getPointOnLine,
+  T as getPointOnLineByOffset,
   p as getPositionFromOffset,
-  k as handleArrival,
-  q as initializeAllVehicles,
-  G as initializeMovingVehicle,
-  H as isPointNearPoint,
-  d as moveVehicle,
-  J as normalize,
-  v as prepareCommandPath,
-  K as resolveFromLineOffset,
-  Q as resolveToLineOffset,
-  R as updateAxlePosition
+  x as handleArrival,
+  B as initializeAllVehicles,
+  C as initializeMovingVehicle,
+  b as isPointNearPoint,
+  F as moveVehicle,
+  V as normalize,
+  I as prepareCommandPath,
+  M as resolveFromLineOffset,
+  S as resolveToLineOffset,
+  y as updateAxlePosition
 };

package/dist/index.d.ts

@@ -1,20 +1,8 @@
 /**
  * VehiclePath - Vehicle motion simulator library
  *
- * A library for simulating dual-axle vehicle movement along paths
+ * Core library for simulating multi-axle vehicle movement along paths
  * composed of lines and Bezier curves.
- *
- * @example
- * ```typescript
- * import { useVehicleSimulation } from 'vehicle-path'
- *
- * const sim = useVehicleSimulation({ wheelbase: 30 })
- * sim.addLine({ id: 'line1', start: [0, 0], end: [400, 0] })
- * sim.addVehicles({ id: 'v1', lineId: 'line1', position: 0 })
- * sim.goto('v1', 'line1', 1.0)
- * sim.prepare()
- * sim.tick(5)
- * ```
  */
 export type { Point, Line, BezierCurve, Curve } from './core/types/geometry';
 export type { VehicleState, VehicleStart, Vehicle, AxleState, GotoCommand, GotoCompletionInfo, GotoCompletionCallback } from './core/types/vehicle';
@@ -22,25 +10,6 @@ export type { CurveData, AxleExecutionState, PathExecutionState, VehicleMovement
 export type { TangentMode } from './core/types/config';
 export type { CoordinateInput, SceneLineInput, SceneConnectionInput, SceneConfig, VehicleInput, VehicleUpdateInput, ConnectionUpdateInput, GotoInput, GotoCommandInput, MovementCommandInput, SimulationConfig } from './core/types/api';
 export { buildGraph, findPath, calculateBezierArcLength, resolveFromLineOffset, resolveToLineOffset, type Graph, type GraphEdge, type PathSegment, type PathResult, type VehiclePosition } from './core/algorithms/pathFinding';
-export { initializeMovingVehicle, createInitialMovementState, initializeAllVehicles, calculateInitialFrontPosition, type InitializationResult, updateAxlePosition, calculatePositionOnLine, calculatePositionOnCurve, calculateFrontAxlePosition, getCumulativeArcLength, arcLengthToSegmentPosition, prepareCommandPath, type PreparedPath, handleArrival, type SegmentCompletionContext, type SegmentCompletionResult, type SegmentVehicleState, moveVehicle, getPositionFromOffset, getLineLength } from './core/algorithms/vehicleMovement';
+export { initializeMovingVehicle, createInitialMovementState, initializeAllVehicles, calculateInitialAxlePositions, type InitializationResult, updateAxlePosition, calculatePositionOnLine, calculatePositionOnCurve, calculateFrontAxlePosition, getCumulativeArcLength, arcLengthToSegmentPosition, prepareCommandPath, type PreparedPath, handleArrival, type SegmentCompletionContext, type SegmentCompletionResult, type SegmentVehicleState, moveVehicle, getPositionFromOffset, getLineLength } from './core/algorithms/vehicleMovement';
 export { PathEngine, type PathEngineConfig, type VehiclePathState, type PathExecution } from './core/engine';
 export { distance, normalize, getPointOnLine, getPointOnLineByOffset, getPointOnBezier, createBezierCurve, buildArcLengthTable, distanceToT, getArcLength, type ArcLengthEntry, type CurveOffsetOptions } from './core/algorithms/math';
-export { VehicleEventEmitter, type VehicleEventMap, type VehicleEventType, type VehicleEventCallback, type VehiclePositionUpdate, type Unsubscribe, type CommandStartInfo } from './utils/event-emitter';
-export { parseSceneDSL, parseVehiclesDSL, parseMovementDSL, parseAllDSL, generateSceneDSL, generateVehiclesDSL, generateMovementDSL, type ParseResult, type MovementCommand } from './utils/dsl-parser';
-export { createAnimationLoop, useAnimationLoop, type AnimationLoopOptions, type AnimationLoopControls } from './utils/animation-loop';
-export { validateAndCreateVehicles, getNextStartVehicleId, getNextGotoVehicleId } from './utils/vehicle-helpers';
-export { useVehicleSimulation, type UseVehicleSimulationProps, type UseVehicleSimulationResult, type SimulationWarning, type SimulationResult } from './react/hooks/useVehicleSimulation';
-export { useScene, type UseSceneResult } from './react/hooks/useScene';
-export { useVehicles, type UseVehiclesResult, type UseVehiclesProps } from './react/hooks/useVehicles';
-export { useMovementQueue, type UseMovementQueueResult, type UseMovementQueueProps } from './react/hooks/useMovementQueue';
-export { useAnimation, type UseAnimationProps } from './react/hooks/useAnimation';
-/** @deprecated Use useMovementQueue instead */
-export { useMovementQueue as useMovement } from './react/hooks/useMovementQueue';
-export type { UseMovementQueueResult as UseMovementResult } from './react/hooks/useMovementQueue';
-export type { UseMovementQueueProps as UseMovementProps } from './react/hooks/useMovementQueue';
-/** @deprecated Use useAnimation instead */
-export { useAnimation as useVehicleMovement } from './react/hooks/useAnimation';
-export { useSceneDefinition } from './react/dsl-hooks/useSceneDefinition';
-export { useInitialMovement } from './react/dsl-hooks/useInitialMovement';
-export { useMovementSequence } from './react/dsl-hooks/useMovementSequence';
-export { useVehicleEventEmitter, useCreateVehicleEventEmitter, useVehicleEvent, VehicleEventContext, VehicleEventProvider, type VehicleEventProviderProps } from './react/providers/useVehicleEvents';

package/dist/utils/event-emitter.d.ts

@@ -18,13 +18,11 @@ export interface CommandStartInfo {
  */
 export interface VehiclePositionUpdate {
     vehicleId: string;
-    /** Rear axle position */
-    rear: Point;
-    /** Front axle position */
-    front: Point;
-    /** Center point between rear and front axles */
+    /** Posisi semua axle, axles[0] = terdepan */
+    axles: Point[];
+    /** Center vehicle (rata-rata semua axle) */
     center: Point;
-    /** Angle in radians from rear to front (heading direction) */
+    /** Angle dari axle paling belakang ke terdepan */
     angle: number;
 }
 /**

package/dist/vehicle-path.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./vehicleMovement-BiYBE_2a.cjs"),o=require("./core.cjs"),i=require("./vehicle-helpers-DrCYMVs4.cjs"),n=require("./animation-loop-fC2LjxCd.cjs"),t=require("./useVehicleEvents-Bp4v5sln.cjs");exports.arcLengthToSegmentPosition=e.arcLengthToSegmentPosition;exports.buildArcLengthTable=e.buildArcLengthTable;exports.buildGraph=e.buildGraph;exports.calculateBezierArcLength=e.calculateBezierArcLength;exports.calculateFrontAxlePosition=e.calculateFrontAxlePosition;exports.calculateInitialFrontPosition=e.calculateInitialFrontPosition;exports.calculatePositionOnCurve=e.calculatePositionOnCurve;exports.calculatePositionOnLine=e.calculatePositionOnLine;exports.createBezierCurve=e.createBezierCurve;exports.createInitialMovementState=e.createInitialMovementState;exports.distance=e.distance;exports.distanceToT=e.distanceToT;exports.findPath=e.findPath;exports.getArcLength=e.getArcLength;exports.getCumulativeArcLength=e.getCumulativeArcLength;exports.getLineLength=e.getLineLength;exports.getPointOnBezier=e.getPointOnBezier;exports.getPointOnLine=e.getPointOnLine;exports.getPointOnLineByOffset=e.getPointOnLineByOffset;exports.getPositionFromOffset=e.getPositionFromOffset;exports.handleArrival=e.handleArrival;exports.initializeAllVehicles=e.initializeAllVehicles;exports.initializeMovingVehicle=e.initializeMovingVehicle;exports.moveVehicle=e.moveVehicle;exports.normalize=e.normalize;exports.prepareCommandPath=e.prepareCommandPath;exports.resolveFromLineOffset=e.resolveFromLineOffset;exports.resolveToLineOffset=e.resolveToLineOffset;exports.updateAxlePosition=e.updateAxlePosition;exports.PathEngine=o.PathEngine;exports.VehicleEventEmitter=i.VehicleEventEmitter;exports.generateMovementDSL=i.generateMovementDSL;exports.generateSceneDSL=i.generateSceneDSL;exports.generateVehiclesDSL=i.generateVehiclesDSL;exports.getNextGotoVehicleId=i.getNextGotoVehicleId;exports.getNextStartVehicleId=i.getNextStartVehicleId;exports.parseAllDSL=i.parseAllDSL;exports.parseMovementDSL=i.parseMovementDSL;exports.parseSceneDSL=i.parseSceneDSL;exports.parseVehiclesDSL=i.parseVehiclesDSL;exports.validateAndCreateVehicles=i.validateAndCreateVehicles;exports.createAnimationLoop=n.createAnimationLoop;exports.useAnimationLoop=n.useAnimationLoop;exports.VehicleEventContext=t.VehicleEventContext;exports.VehicleEventProvider=t.VehicleEventProvider;exports.useAnimation=t.useAnimation;exports.useCreateVehicleEventEmitter=t.useCreateVehicleEventEmitter;exports.useInitialMovement=t.useInitialMovement;exports.useMovement=t.useMovementQueue;exports.useMovementQueue=t.useMovementQueue;exports.useMovementSequence=t.useMovementSequence;exports.useScene=t.useScene;exports.useSceneDefinition=t.useSceneDefinition;exports.useVehicleEvent=t.useVehicleEvent;exports.useVehicleEventEmitter=t.useVehicleEventEmitter;exports.useVehicleMovement=t.useAnimation;exports.useVehicleSimulation=t.useVehicleSimulation;exports.useVehicles=t.useVehicles;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function L(t,e){const s=e.x-t.x,n=e.y-t.y;return Math.sqrt(s*s+n*n)}function D(t,e){const s=e.x-t.x,n=e.y-t.y,i=Math.sqrt(s*s+n*n);return i===0?{x:0,y:0}:{x:s/i,y:n/i}}function W(t,e){return e*(t==="proportional-40"?.4:.5522)}function V(t,e,s,n=!1,i){const{maxWheelbase:c,tangentMode:o}=s;let r;i?.fromOffset!==void 0?r=b(t,i.fromOffset,i.fromIsPercentage??!1):r=t.end;let a;i?.toOffset!==void 0?a=b(e,i.toOffset,i.toIsPercentage??!1):a=e.start;const l=D(t.start,t.end),f=n?{x:r.x-l.x*c,y:r.y-l.y*c}:r,g=D(t.start,t.end),d=D(e.start,e.end),h=L(f,a),p=W(o,h),u=n?{x:f.x-g.x*p,y:f.y-g.y*p}:{x:f.x+g.x*p,y:f.y+g.y*p},v={x:a.x-d.x*p,y:a.y-d.y*p};return{p0:f,p1:u,p2:v,p3:a}}function F(t,e){return{x:t.start.x+(t.end.x-t.start.x)*e,y:t.start.y+(t.end.y-t.start.y)*e}}function b(t,e,s){const n=L(t.start,t.end);let i;return s?i=e:i=n>0?e/n:0,i=Math.max(0,Math.min(1,i)),F(t,i)}function T(t,e){const{p0:s,p1:n,p2:i,p3:c}=t,o=1-e,r=o*o,a=r*o,l=e*e,f=l*e;return{x:a*s.x+3*r*e*n.x+3*o*l*i.x+f*c.x,y:a*s.y+3*r*e*n.y+3*o*l*i.y+f*c.y}}function ee(t,e,s=10){return L(t,e)<=s}function j(t,e=100){const s=[{t:0,distance:0}];let n=t.p0,i=0;for(let c=1;c<=e;c++){const o=c/e,r=T(t,o);i+=L(n,r),s.push({t:o,distance:i}),n=r}return s}function N(t,e){if(e<=0)return 0;const s=t[t.length-1].distance;if(e>=s)return 1;let n=0,i=t.length-1;for(;n<i-1;){const f=Math.floor((n+i)/2);t[f].distance<e?n=f:i=f}const c=t[n].distance,o=t[i].distance,r=t[n].t,a=t[i].t;if(o===c)return r;const l=(e-c)/(o-c);return r+l*(a-r)}function te(t){return t[t.length-1].distance}function $(t,e=100){let s=0,n=t.p0;for(let i=1;i<=e;i++){const c=i/e,o=T(t,c);s+=L(n,o),n=o}return s}function z(t,e,s,n,i){const c=L(t.start,t.end),o=c-i;if(o<=0)return c;let r;if(e===void 0)r=n;else if(s)r=e;else{const a=Math.max(0,Math.min(e,o));return i+a}return i+r*o}function B(t,e,s,n,i){const o=L(t.start,t.end)-i;if(o<=0)return 0;let r;if(e===void 0)r=n;else if(s)r=e;else return Math.max(0,Math.min(e,o));return r*o}function x(t,e,s){const n=new Map,i=new Map,c=new Map;for(const o of t)i.set(o.id,o),c.set(o.id,L(o.start,o.end)),n.set(o.id,[]);for(let o=0;o<e.length;o++){const r=e[o],a=i.get(r.fromLineId),l=i.get(r.toLineId);if(!a||!l)continue;const f=z(a,r.fromOffset,r.fromIsPercentage,1,s.maxWheelbase),g=B(l,r.toOffset,r.toIsPercentage,0,s.maxWheelbase),d=V(a,l,s,!1,{fromOffset:f,fromIsPercentage:!1,toOffset:g,toIsPercentage:!1}),h=$(d),p={curveIndex:o,fromLineId:r.fromLineId,toLineId:r.toLineId,fromOffset:f,toOffset:g,curveLength:h};n.get(r.fromLineId).push(p)}return{adjacency:n,lines:i,lineLengths:c}}function E(t,e){return t.curveCount!==e.curveCount?t.curveCount-e.curveCount:t.totalDistance-e.totalDistance}function K(t,e,s,n,i=!1){const{adjacency:c,lines:o,lineLengths:r}=t;if(!o.get(s))return null;const l=r.get(s),f=i?n/100*l:n,g=[],d=new Map,h=(u,v)=>`${u}:${Math.round(v)}`;if(e.lineId===s&&f>=e.offset){const u=f-e.offset;return{segments:[{type:"line",lineId:e.lineId,startOffset:e.offset,endOffset:f,length:u}],totalDistance:u,curveCount:0}}const p=c.get(e.lineId)||[];for(const u of p){if(u.fromOffset<e.offset)continue;const v=u.fromOffset-e.offset,I=v+u.curveLength,M={type:"line",lineId:e.lineId,startOffset:e.offset,endOffset:u.fromOffset,length:v},m={type:"curve",curveIndex:u.curveIndex,startOffset:0,endOffset:u.curveLength,length:u.curveLength};g.push({lineId:u.toLineId,entryOffset:u.toOffset,totalDistance:I,curveCount:1,path:[M,m]})}for(g.sort(E);g.length>0;){const u=g.shift(),v=h(u.lineId,u.entryOffset),I=d.get(v);if(I!==void 0&&(I.curveCount<u.curveCount||I.curveCount===u.curveCount&&I.distance<=u.totalDistance))continue;if(d.set(v,{curveCount:u.curveCount,distance:u.totalDistance}),u.lineId===s){const m=Math.abs(f-u.entryOffset);if(f>=u.entryOffset){const P={type:"line",lineId:s,startOffset:u.entryOffset,endOffset:f,length:m};return{segments:[...u.path,P],totalDistance:u.totalDistance+m,curveCount:u.curveCount}}}const M=c.get(u.lineId)||[];for(const m of M){if(m.fromOffset<u.entryOffset)continue;const P=m.fromOffset-u.entryOffset,q=u.totalDistance+P+m.curveLength,w=u.curveCount+1,X=h(m.toLineId,m.toOffset),C=d.get(X);if(C!==void 0&&(C.curveCount<w||C.curveCount===w&&C.distance<=q))continue;const Y={type:"line",lineId:u.lineId,startOffset:u.entryOffset,endOffset:m.fromOffset,length:P},Z={type:"curve",curveIndex:m.curveIndex,startOffset:0,endOffset:m.curveLength,length:m.curveLength};g.push({lineId:m.toLineId,entryOffset:m.toOffset,totalDistance:q,curveCount:w,path:[...u.path,Y,Z]})}g.sort(E)}return null}function S(t,e){const s=Math.sqrt(Math.pow(t.end.x-t.start.x,2)+Math.pow(t.end.y-t.start.y,2)),n=s>0?e/s:0;return{x:t.start.x+(t.end.x-t.start.x)*Math.min(1,Math.max(0,n)),y:t.start.y+(t.end.y-t.start.y)*Math.min(1,Math.max(0,n))}}function O(t){return Math.sqrt(Math.pow(t.end.x-t.start.x,2)+Math.pow(t.end.y-t.start.y,2))}function k(t,e,s){let n=0;for(let i=0;i<e;i++)n+=t.segments[i].length;return n+=s,n}function G(t,e){let s=0;for(let n=0;n<t.segments.length;n++){const i=t.segments[n],c=s+i.length;if(e<c)return{segmentIndex:n,segmentDistance:e-s};if(e===c)return n+1<t.segments.length?{segmentIndex:n+1,segmentDistance:0}:{segmentIndex:n,segmentDistance:i.length};s+=i.length}return null}function ne(t,e,s,n){const c=k(t,e,s)+n;return G(t,c)}function Q(t,e,s,n){const i=O(n),c=s.length+1,o=new Array(c);o[c-1]={lineId:t,absoluteOffset:e,position:S(n,e)};let r=e;for(let a=c-2;a>=0;a--)r=Math.min(r+s[a],i),o[a]={lineId:t,absoluteOffset:r,position:S(n,r)};return o}function R(t,e){return{...t,state:"idle"}}function _(t){return{vehicle:t,execution:null}}function se(t,e){const s=[],n=new Map;for(const i of t){if(!e.get(i.lineId))continue;const o=R(i);s.push(o);const r=_(o);n.set(i.id,r)}return{movingVehicles:s,stateMap:n}}function y(t,e){return{position:S(t,e),lineId:t.id,absoluteOffset:e}}function A(t,e){const s=N(t.arcLengthTable,e);return{position:T(t.bezier,s)}}function H(t,e,s,n,i,c,o){const r=s.segments[e.currentSegmentIndex],a=e.segmentDistance+n;if(a>=r.length){const f=a-r.length,g=e.currentSegmentIndex+1;if(g>=s.segments.length){if(o!==void 0&&r.type==="line"){const u=i.get(r.lineId),v=r.startOffset+a;if(v<=o){const M=y(u,v);return{axleState:{...t,...M},execution:{...e,segmentDistance:a},completed:!1}}const I=y(u,o);return{axleState:{...t,...I},execution:{...e,segmentDistance:o-r.startOffset},completed:!0}}const p=r.type==="line"?y(i.get(r.lineId),r.endOffset):A(c.get(r.curveIndex),r.length);return{axleState:{...t,...p},execution:{...e,segmentDistance:r.length},completed:!0}}const d=s.segments[g],h=d.type==="line"?y(i.get(d.lineId),d.startOffset+f):A(c.get(d.curveIndex),f);return{axleState:{...t,...h},execution:{currentSegmentIndex:g,segmentDistance:f},completed:!1}}const l=r.type==="line"?y(i.get(r.lineId),r.startOffset+a):A(c.get(r.curveIndex),a);return{axleState:{...t,...l},execution:{...e,segmentDistance:a},completed:!1}}function ie(t,e,s,n){const i=new Map;for(const c of t.segments)if(c.type==="curve"&&c.curveIndex!==void 0){const o=e[c.curveIndex];if(o){const r=s.get(o.fromLineId),a=s.get(o.toLineId);if(r&&a){const l=z(r,o.fromOffset,o.fromIsPercentage,1,n.maxWheelbase),f=B(a,o.toOffset,o.toIsPercentage,0,n.maxWheelbase),g=V(r,a,n,!1,{fromOffset:l,fromIsPercentage:!1,toOffset:f,toIsPercentage:!1}),d=j(g);i.set(c.curveIndex,{bezier:g,arcLengthTable:d})}}}return i}function J(t,e,s){const{graph:n,linesMap:i,curves:c,config:o}=s,r=i.get(e.targetLineId);if(!r)return null;const a=t.axleSpacings.reduce((u,v)=>u+v,0),f=O(r)-a;if(f<=0)return null;const g=e.isPercentage?e.targetOffset*f:Math.min(e.targetOffset,f),d=t.axles[t.axles.length-1],h=K(n,{lineId:d.lineId,offset:d.absoluteOffset},e.targetLineId,g,!1);if(!h)return null;const p=ie(h,c,i,o);return{path:h,curveDataMap:p}}function re(t,e){const s=t.execution,i=e.vehicleQueues.get(t.vehicle.id)?.[s.currentCommandIndex];return i&&e.onCommandComplete&&e.onCommandComplete({vehicleId:t.vehicle.id,command:i,finalPosition:{lineId:t.vehicle.axles[t.vehicle.axles.length-1].lineId,absoluteOffset:t.vehicle.axles[t.vehicle.axles.length-1].absoluteOffset,position:t.vehicle.axles[t.vehicle.axles.length-1].position},payload:i.payload}),{handled:!0,vehicle:{...t.vehicle,state:"waiting"},newExecution:s,isWaiting:!0}}function U(t,e,s,n,i,c){let o;const r=e[0];if(r.currentSegmentIndex<s.segments.length){const l=s.segments[r.currentSegmentIndex];if(l.type==="line"){const f=i.get(l.lineId);f&&(o=O(f))}}const a=t.map((l,f)=>{const g=f===0?o:void 0;return H(l,e[f],s,n,i,c,g)});return{axles:a.map(l=>l.axleState),axleExecutions:a.map(l=>l.execution),arrived:a[0].completed}}class oe{graph=null;linesMap=new Map;curves=[];config;constructor(e){this.config={maxWheelbase:e.maxWheelbase,tangentMode:e.tangentMode}}get movementConfig(){return this.config}get lines(){return Array.from(this.linesMap.values())}getCurves(){return this.curves}setScene(e,s){this.linesMap.clear();for(const n of e)this.linesMap.set(n.id,n);this.curves=s,this.graph=x(e,s,this.config)}addLine(e){return this.linesMap.has(e.id)?!1:(this.linesMap.set(e.id,e),this.graph=x(Array.from(this.linesMap.values()),this.curves,this.config),!0)}updateLine(e,s){const n=this.linesMap.get(e);return n?(s.start&&(n.start=s.start),s.end&&(n.end=s.end),this.graph=x(Array.from(this.linesMap.values()),this.curves,this.config),!0):!1}updateLineEndpoint(e,s,n){return this.updateLine(e,{[s]:n})}renameLine(e,s){const n=s.trim();if(!n)return{success:!1,error:"Name cannot be empty"};if(n===e)return{success:!0};if(this.linesMap.has(n))return{success:!1,error:`"${n}" already exists`};const i=this.linesMap.get(e);if(!i)return{success:!1,error:`Line "${e}" not found`};i.id=n,this.linesMap.delete(e),this.linesMap.set(n,i);for(const c of this.curves)c.fromLineId===e&&(c.fromLineId=n),c.toLineId===e&&(c.toLineId=n);return this.graph=x(Array.from(this.linesMap.values()),this.curves,this.config),{success:!0}}removeLine(e){return this.linesMap.has(e)?(this.linesMap.delete(e),this.curves=this.curves.filter(s=>s.fromLineId!==e&&s.toLineId!==e),this.graph=x(Array.from(this.linesMap.values()),this.curves,this.config),!0):!1}addCurve(e){this.curves.push(e),this.graph=x(Array.from(this.linesMap.values()),this.curves,this.config)}updateCurve(e,s){return e<0||e>=this.curves.length?!1:(this.curves[e]={...this.curves[e],...s},this.graph=x(Array.from(this.linesMap.values()),this.curves,this.config),!0)}removeCurve(e){return e<0||e>=this.curves.length?!1:(this.curves.splice(e,1),this.graph=x(Array.from(this.linesMap.values()),this.curves,this.config),!0)}initializeVehicle(e,s,n){const i=this.linesMap.get(e);if(!i)return null;const c=n.reduce((l,f)=>l+f,0),o=O(i),r=Math.min(s,o-c);return{axles:Q(e,r,n,i).map(l=>({lineId:l.lineId,offset:l.absoluteOffset,position:l.position})),axleSpacings:n}}preparePath(e,s,n,i=!1){if(!this.graph)return null;const c=e.axleSpacings.reduce((h,p)=>h+p,0),o=e.axles[e.axles.length-1],r={lineId:o.lineId,offset:o.offset,axles:e.axles.map(h=>({lineId:h.lineId,position:h.position,absoluteOffset:h.offset})),axleSpacings:e.axleSpacings},a=J(r,{targetLineId:s,targetOffset:n,isPercentage:i},{graph:this.graph,linesMap:this.linesMap,curves:this.curves,config:this.config});if(!a)return null;let l=n;const f=this.linesMap.get(s);if(f){const h=Math.max(0,O(f)-c);l=i?n*h:Math.min(n,h)}let g=0;const d=[{segmentIndex:0,segmentDistance:c}];for(let h=0;h<e.axleSpacings.length;h++)g+=e.axleSpacings[h],d.push({segmentIndex:0,segmentDistance:c-g});return{path:a.path,curveDataMap:a.curveDataMap,axleExecutions:d,targetLineId:s,targetOffset:l}}moveVehicle(e,s,n){const i=e.axles.map(r=>({lineId:r.lineId,position:r.position,absoluteOffset:r.offset})),c=s.axleExecutions.map(r=>({currentSegmentIndex:r.segmentIndex,segmentDistance:r.segmentDistance})),o=U(i,c,s.path,n,this.linesMap,s.curveDataMap);return{state:{axles:o.axles.map(r=>({lineId:r.lineId,offset:r.absoluteOffset,position:r.position})),axleSpacings:e.axleSpacings},execution:{...s,axleExecutions:o.axleExecutions.map(r=>({segmentIndex:r.currentSegmentIndex,segmentDistance:r.segmentDistance}))},arrived:o.arrived}}}exports.PathEngine=oe;exports.arcLengthToSegmentPosition=G;exports.buildArcLengthTable=j;exports.buildGraph=x;exports.calculateBezierArcLength=$;exports.calculateFrontAxlePosition=ne;exports.calculateInitialAxlePositions=Q;exports.calculatePositionOnCurve=A;exports.calculatePositionOnLine=y;exports.calculateTangentLength=W;exports.createBezierCurve=V;exports.createInitialMovementState=_;exports.distance=L;exports.distanceToT=N;exports.findPath=K;exports.getArcLength=te;exports.getCumulativeArcLength=k;exports.getLineLength=O;exports.getPointOnBezier=T;exports.getPointOnLine=F;exports.getPointOnLineByOffset=b;exports.getPositionFromOffset=S;exports.handleArrival=re;exports.initializeAllVehicles=se;exports.initializeMovingVehicle=R;exports.isPointNearPoint=ee;exports.moveVehicle=U;exports.normalize=D;exports.prepareCommandPath=J;exports.resolveFromLineOffset=z;exports.resolveToLineOffset=B;exports.updateAxlePosition=H;