vehicle-path2 2.4.0 → 3.0.0

package/dist/core/engine.d.ts

@@ -9,11 +9,11 @@
  * ```typescript
  * import { PathEngine } from 'vehicle-path/core'
  *
- * const engine = new PathEngine({ wheelbase: 30, tangentMode: 'proportional-40' })
+ * const engine = new PathEngine({ maxWheelbase: 100, tangentMode: 'proportional-40' })
  *
  * engine.setScene(lines, curves)
  *
- * const state = engine.initializeVehicle('line-1', 0)
+ * const state = engine.initializeVehicle('line-1', 0, { axleSpacings: [40] })
  * const execution = engine.preparePath(state, 'line-3', 1.0, true)
  *
  * // In your animation/game loop:
@@ -26,6 +26,7 @@
  * ```
  */
 import type { Line, Curve, Point } from './types/geometry';
+import type { VehicleDefinition } from './types/vehicle';
 import type { MovementConfig, CurveData } from './types/movement';
 import type { PathResult } from './algorithms/pathFinding';
 import type { TangentMode } from './types/config';
@@ -37,14 +38,12 @@ export interface PathEngineConfig {
  * Multi-axle position state for use with PathEngine.
  * axles[0] = terdepan, axles[N-1] = paling belakang.
  */
-export interface VehiclePathState {
+export interface VehiclePathState extends VehicleDefinition {
     axles: Array<{
         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.
@@ -127,10 +126,11 @@ export declare class PathEngine {
      *
      * @param lineId - The line to place the vehicle on
      * @param rearOffset - Absolute distance offset untuk axle paling belakang
-     * @param axleSpacings - Jarak antar axle berurutan (N-1 nilai untuk N axle)
+     * @param vehicle - VehicleDefinition (or any object extending it with axleSpacings)
      * @returns Initial VehiclePathState, or null if lineId does not exist
+     * @throws if axleSpacings is empty
      */
-    initializeVehicle(lineId: string, rearOffset: number, axleSpacings: number[]): VehiclePathState | null;
+    initializeVehicle(lineId: string, rearOffset: number, vehicle: VehicleDefinition): VehiclePathState | null;
     /**
      * Prepare a path from the vehicle's current position to a target.
      *

package/dist/core/index.d.ts

@@ -11,7 +11,7 @@
  * ```
  */
 export type { Point, Line, BezierCurve, Curve } from './types/geometry';
-export type { VehicleState, VehicleStart, Vehicle, AxleState, GotoCommand, GotoCompletionInfo, GotoCompletionCallback } from './types/vehicle';
+export type { VehicleDefinition, VehicleState, VehicleStart, Vehicle, AxleState, GotoCommand, GotoCompletionInfo, GotoCompletionCallback } from './types/vehicle';
 export type { CurveData, AxleExecutionState, PathExecutionState, VehicleMovementState, MovementConfig, SceneContext } from './types/movement';
 export type { TangentMode } from './types/config';
 export type { CoordinateInput, SceneLineInput, SceneConnectionInput, SceneConfig, VehicleInput, VehicleUpdateInput, ConnectionUpdateInput, GotoCommandInput } from './types/api';

package/dist/core/snapshot.d.ts

@@ -10,24 +10,10 @@ export interface SceneSnapshot {
         toOffset: number;
         toIsPercentage: boolean;
     }>;
-    vehicles: Array<{
-        id: string;
-        lineId: string;
-        axles: Array<{
-            offset: number;
-        }>;
-        axleSpacings: number[];
-        isPercentage: boolean;
-    }>;
 }
 /**
- * Serialize scene state to a JSON string suitable for clipboard or storage.
- * Strips derived fields (bezier curves, axle positions) — only source-of-truth
- * data is included.
- *
- * Note: lineId is per-vehicle (not per-axle) because this snapshot captures
- * static placement where all axles share the same line. For mid-movement state,
- * use AxleState directly.
+ * Serialize scene state (lines + curves) to a JSON string.
+ * Vehicles are NOT included — vehicle persistence is the client's responsibility.
  */
 export declare function serializeScene(lines: Line[], curves: Array<{
     id: string;
@@ -37,18 +23,10 @@ export declare function serializeScene(lines: Line[], curves: Array<{
     fromIsPercentage?: boolean;
     toOffset: number;
     toIsPercentage?: boolean;
-}>, vehicles: Array<{
-    id: string;
-    axles: Array<{
-        lineId: string;
-        offset: number;
-        [key: string]: unknown;
-    }>;
-    axleSpacings: number[];
-    isPercentage?: boolean;
 }>): string;
 /**
  * Deserialize a JSON string back into a SceneSnapshot.
- * Throws if the string is not valid JSON or missing required fields.
+ * Throws if the string is not valid JSON or missing required fields (lines, curves).
+ * Extra fields in the JSON (e.g. legacy "vehicles") are silently ignored.
  */
 export declare function deserializeScene(json: string): SceneSnapshot;

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

@@ -2,6 +2,17 @@
  * Vehicle-related types
  */
 import type { Point } from './geometry';
+/**
+ * Base definition of a vehicle's physical structure.
+ * Client code is free to extend this with additional fields (id, name, color, etc).
+ *
+ * @example
+ * interface MyVehicle extends VehicleDefinition { id: string; name: string }
+ */
+export interface VehicleDefinition {
+    /** N-1 arc-length spacings between consecutive axles. axleSpacings[i] = distance from axles[i] to axles[i+1]. */
+    axleSpacings: number[];
+}
 /**
  * Animation state for a vehicle
  */
@@ -28,14 +39,13 @@ export interface AxleState {
 /**
  * Vehicle with runtime state (used during animation)
  */
-export interface Vehicle {
+export interface Vehicle extends VehicleDefinition {
     id: string;
     lineId: string;
     offset: number;
     isPercentage: boolean;
     state: VehicleState;
     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 e=require("./index-BUYdltrL.cjs");function f(a,t,i){const r={lines:a,curves:t.map(n=>({id:n.id,fromLineId:n.fromLineId,toLineId:n.toLineId,fromOffset:n.fromOffset,fromIsPercentage:n.fromIsPercentage??!1,toOffset:n.toOffset,toIsPercentage:n.toIsPercentage??!1})),vehicles:i.map(n=>({id:n.id,lineId:n.axles[0].lineId,axles:n.axles.map(o=>({offset:o.offset})),axleSpacings:n.axleSpacings,isPercentage:n.isPercentage??!1}))};return JSON.stringify(r,null,2)}function g(a){let t;try{t=JSON.parse(a)}catch{throw new Error("deserializeScene: invalid JSON")}if(!t||typeof t!="object"||Array.isArray(t))throw new Error("deserializeScene: expected a JSON object");const i=t;if(!Array.isArray(i.lines))throw new Error('deserializeScene: missing "lines"');if(!Array.isArray(i.curves))throw new Error('deserializeScene: missing "curves"');if(!Array.isArray(i.vehicles))throw new Error('deserializeScene: missing "vehicles"');return{lines:i.lines,curves:i.curves,vehicles:i.vehicles}}function h(a,t){const i=t.end.x-t.start.x,r=t.end.y-t.start.y,n=i*i+r*r;if(n===0)return{offset:0,distance:Math.sqrt((a.x-t.start.x)**2+(a.y-t.start.y)**2)};const o=Math.max(0,Math.min(1,((a.x-t.start.x)*i+(a.y-t.start.y)*r)/n)),s=t.start.x+o*i,c=t.start.y+o*r,l=Math.sqrt((a.x-s)**2+(a.y-c)**2);return{offset:o*Math.sqrt(n),distance:l}}function d(a,t){const i=e.getLineLength(a),r=t.reduce((o,s)=>o+s,0);return[0,Math.max(0,i-r)]}function u(a,t){let i=0;for(const r of t)r.fromLineId===a&&!r.fromIsPercentage&&r.fromOffset!==void 0&&(i=Math.max(i,r.fromOffset)),r.toLineId===a&&!r.toIsPercentage&&r.toOffset!==void 0&&(i=Math.max(i,r.toOffset));return i}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;exports.computeMinLineLength=u;exports.deserializeScene=g;exports.getValidRearOffsetRange=d;exports.projectPointOnLine=h;exports.serializeScene=f;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-C4FckUel.cjs");function f(r,n){const i={lines:r,curves:n.map(t=>({id:t.id,fromLineId:t.fromLineId,toLineId:t.toLineId,fromOffset:t.fromOffset,fromIsPercentage:t.fromIsPercentage??!1,toOffset:t.toOffset,toIsPercentage:t.toIsPercentage??!1}))};return JSON.stringify(i,null,2)}function g(r){let n;try{n=JSON.parse(r)}catch{throw new Error("deserializeScene: invalid JSON")}if(!n||typeof n!="object"||Array.isArray(n))throw new Error("deserializeScene: expected a JSON object");const i=n;if(!Array.isArray(i.lines))throw new Error('deserializeScene: missing "lines"');if(!Array.isArray(i.curves))throw new Error('deserializeScene: missing "curves"');return{lines:i.lines,curves:i.curves}}function u(r,n){const i=n.end.x-n.start.x,t=n.end.y-n.start.y,o=i*i+t*t;if(o===0)return{offset:0,distance:Math.sqrt((r.x-n.start.x)**2+(r.y-n.start.y)**2)};const a=Math.max(0,Math.min(1,((r.x-n.start.x)*i+(r.y-n.start.y)*t)/o)),s=n.start.x+a*i,c=n.start.y+a*t,l=Math.sqrt((r.x-s)**2+(r.y-c)**2);return{offset:a*Math.sqrt(o),distance:l}}function h(r,n){const i=e.getLineLength(r),t=n.reduce((a,s)=>a+s,0);return[0,Math.max(0,i-t)]}function d(r,n){let i=0;for(const t of n)t.fromLineId===r&&!t.fromIsPercentage&&t.fromOffset!==void 0&&(i=Math.max(i,t.fromOffset)),t.toLineId===r&&!t.toIsPercentage&&t.toOffset!==void 0&&(i=Math.max(i,t.toOffset));return i}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;exports.computeMinLineLength=d;exports.deserializeScene=g;exports.getValidRearOffsetRange=h;exports.projectPointOnLine=u;exports.serializeScene=f;

package/dist/core.js

@@ -1,86 +1,77 @@
-import { g as f } from "./index-wjEuFiRl.js";
-import { P as y, a as v, b as A, c as p, d as S, e as I, f as z, h as w, i as M, j as b, k as j, l as E, m as T, n as q, o as B, p as C, q as N, r as J, s as V, t as F, u as R, v as k, w as D, x as G, y as X, z as Y, A as H, B as K, C as Q, D as U, E as W } from "./index-wjEuFiRl.js";
-function h(r, e, t) {
-  const a = {
-    lines: r,
-    curves: e.map((s) => ({
-      id: s.id,
-      fromLineId: s.fromLineId,
-      toLineId: s.toLineId,
-      fromOffset: s.fromOffset,
-      fromIsPercentage: s.fromIsPercentage ?? !1,
-      toOffset: s.toOffset,
-      toIsPercentage: s.toIsPercentage ?? !1
-    })),
-    vehicles: t.map((s) => ({
-      id: s.id,
-      lineId: s.axles[0].lineId,
-      axles: s.axles.map((n) => ({ offset: n.offset })),
-      axleSpacings: s.axleSpacings,
-      isPercentage: s.isPercentage ?? !1
+import { g as f } from "./index-BV93143R.js";
+import { P as y, a as v, b as A, c as S, d as p, e as z, f as I, h as M, i as w, j as b, k as j, l as E, m as T, n as q, o as B, p as C, q as N, r as J, s as V, t as F, u as R, v as k, w as D, x as G, y as X, z as Y, A as H, B as K, C as Q, D as U, E as W } from "./index-BV93143R.js";
+function u(a, t) {
+  const s = {
+    lines: a,
+    curves: t.map((e) => ({
+      id: e.id,
+      fromLineId: e.fromLineId,
+      toLineId: e.toLineId,
+      fromOffset: e.fromOffset,
+      fromIsPercentage: e.fromIsPercentage ?? !1,
+      toOffset: e.toOffset,
+      toIsPercentage: e.toIsPercentage ?? !1
     }))
   };
-  return JSON.stringify(a, null, 2);
+  return JSON.stringify(s, null, 2);
 }
-function m(r) {
-  let e;
+function g(a) {
+  let t;
   try {
-    e = JSON.parse(r);
+    t = JSON.parse(a);
   } catch {
     throw new Error("deserializeScene: invalid JSON");
   }
-  if (!e || typeof e != "object" || Array.isArray(e))
+  if (!t || typeof t != "object" || Array.isArray(t))
     throw new Error("deserializeScene: expected a JSON object");
-  const t = e;
-  if (!Array.isArray(t.lines)) throw new Error('deserializeScene: missing "lines"');
-  if (!Array.isArray(t.curves)) throw new Error('deserializeScene: missing "curves"');
-  if (!Array.isArray(t.vehicles)) throw new Error('deserializeScene: missing "vehicles"');
+  const s = t;
+  if (!Array.isArray(s.lines)) throw new Error('deserializeScene: missing "lines"');
+  if (!Array.isArray(s.curves)) throw new Error('deserializeScene: missing "curves"');
   return {
-    lines: t.lines,
-    curves: t.curves,
-    vehicles: t.vehicles
+    lines: s.lines,
+    curves: s.curves
   };
 }
-function u(r, e) {
-  const t = e.end.x - e.start.x, a = e.end.y - e.start.y, s = t * t + a * a;
-  if (s === 0)
+function h(a, t) {
+  const s = t.end.x - t.start.x, e = t.end.y - t.start.y, n = s * s + e * e;
+  if (n === 0)
     return { offset: 0, distance: Math.sqrt(
-      (r.x - e.start.x) ** 2 + (r.y - e.start.y) ** 2
+      (a.x - t.start.x) ** 2 + (a.y - t.start.y) ** 2
     ) };
-  const n = Math.max(
+  const r = Math.max(
     0,
     Math.min(
       1,
-      ((r.x - e.start.x) * t + (r.y - e.start.y) * a) / s
+      ((a.x - t.start.x) * s + (a.y - t.start.y) * e) / n
     )
-  ), i = e.start.x + n * t, o = e.start.y + n * a, c = Math.sqrt((r.x - i) ** 2 + (r.y - o) ** 2);
-  return { offset: n * Math.sqrt(s), distance: c };
+  ), i = t.start.x + r * s, o = t.start.y + r * e, c = Math.sqrt((a.x - i) ** 2 + (a.y - o) ** 2);
+  return { offset: r * Math.sqrt(n), distance: c };
 }
-function x(r, e) {
-  const t = f(r), a = e.reduce((n, i) => n + i, 0);
-  return [0, Math.max(0, t - a)];
+function L(a, t) {
+  const s = f(a), e = t.reduce((r, i) => r + i, 0);
+  return [0, Math.max(0, s - e)];
 }
-function P(r, e) {
-  let t = 0;
-  for (const a of e)
-    a.fromLineId === r && !a.fromIsPercentage && a.fromOffset !== void 0 && (t = Math.max(t, a.fromOffset)), a.toLineId === r && !a.toIsPercentage && a.toOffset !== void 0 && (t = Math.max(t, a.toOffset));
-  return t;
+function O(a, t) {
+  let s = 0;
+  for (const e of t)
+    e.fromLineId === a && !e.fromIsPercentage && e.fromOffset !== void 0 && (s = Math.max(s, e.fromOffset)), e.toLineId === a && !e.toIsPercentage && e.toOffset !== void 0 && (s = Math.max(s, e.toOffset));
+  return s;
 }
 export {
   y as PathEngine,
   v as arcLengthToSegmentPosition,
   A as buildArcLengthTable,
-  p as buildGraph,
-  S as calculateBezierArcLength,
-  I as calculateFrontAxlePosition,
-  z as calculateInitialAxlePositions,
-  w as calculatePositionOnCurve,
-  M as calculatePositionOnLine,
+  S as buildGraph,
+  p as calculateBezierArcLength,
+  z as calculateFrontAxlePosition,
+  I as calculateInitialAxlePositions,
+  M as calculatePositionOnCurve,
+  w as calculatePositionOnLine,
   b as calculateTangentLength,
-  P as computeMinLineLength,
+  O as computeMinLineLength,
   j as createBezierCurve,
   E as createInitialMovementState,
-  m as deserializeScene,
+  g as deserializeScene,
   T as distance,
   q as distanceToT,
   B as findPath,
@@ -91,7 +82,7 @@ export {
   V as getPointOnLine,
   F as getPointOnLineByOffset,
   R as getPositionFromOffset,
-  x as getValidRearOffsetRange,
+  L as getValidRearOffsetRange,
   k as handleArrival,
   D as initializeAllVehicles,
   G as initializeMovingVehicle,
@@ -99,9 +90,9 @@ export {
   Y as moveVehicle,
   H as normalize,
   K as prepareCommandPath,
-  u as projectPointOnLine,
+  h as projectPointOnLine,
   Q as resolveFromLineOffset,
   U as resolveToLineOffset,
-  h as serializeScene,
+  u as serializeScene,
   W as updateAxlePosition
 };

package/dist/{index-wjEuFiRl.js → index-BV93143R.js}

@@ -1,29 +1,29 @@
 function y(t, e) {
-  const s = e.x - t.x, n = e.y - t.y;
-  return Math.sqrt(s * s + n * n);
+  const n = e.x - t.x, s = e.y - t.y;
+  return Math.sqrt(n * n + s * s);
 }
-function w(t, e) {
-  const s = e.x - t.x, n = e.y - t.y, r = Math.sqrt(s * s + n * n);
-  return r === 0 ? { x: 0, y: 0 } : { x: s / r, y: n / r };
+function S(t, e) {
+  const n = e.x - t.x, s = e.y - t.y, i = Math.sqrt(n * n + s * s);
+  return i === 0 ? { x: 0, y: 0 } : { x: n / i, y: s / i };
 }
 function k(t, e) {
   return e * (t === "proportional-40" ? 0.4 : 0.5522);
 }
-function z(t, e, s, n = !1, r) {
-  const { maxWheelbase: o, tangentMode: a } = s;
-  let i;
-  r?.fromOffset !== void 0 ? i = V(t, r.fromOffset, r.fromIsPercentage ?? !1) : i = t.end;
-  let c;
-  r?.toOffset !== void 0 ? c = V(e, r.toOffset, r.toIsPercentage ?? !1) : c = e.start;
-  const l = w(t.start, t.end), f = n ? {
+function W(t, e, n, s = !1, i) {
+  const { maxWheelbase: o, tangentMode: a } = n;
+  let r;
+  i?.fromOffset !== void 0 ? r = V(t, i.fromOffset, i.fromIsPercentage ?? !1) : r = t.end;
+  let f;
+  i?.toOffset !== void 0 ? f = V(e, i.toOffset, i.toIsPercentage ?? !1) : f = e.start;
+  const l = S(t.start, t.end), c = s ? {
     // Transition with flip: kurva dimulai dari P (baseP0 - wheelbase in line direction)
-    x: i.x - l.x * o,
-    y: i.y - l.y * o
-  } : i, g = w(t.start, t.end), d = w(e.start, e.end), h = y(f, c), p = k(a, 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: c.x - d.x * p,
-    y: c.y - d.y * p
+    x: r.x - l.x * o,
+    y: r.y - l.y * o
+  } : r, g = S(t.start, t.end), d = S(e.start, e.end), h = y(c, f), p = k(a, h), u = s ? { x: c.x - g.x * p, y: c.y - g.y * p } : { x: c.x + g.x * p, y: c.y + g.y * p }, v = {
+    x: f.x - d.x * p,
+    y: f.y - d.y * p
   };
-  return { p0: f, p1: u, p2: v, p3: c };
+  return { p0: c, p1: u, p2: v, p3: f };
 }
 function K(t, e) {
   return {
@@ -31,78 +31,78 @@ function K(t, e) {
     y: t.start.y + (t.end.y - t.start.y) * e
   };
 }
-function V(t, e, s) {
-  const n = y(t.start, t.end);
-  let r;
-  return s ? r = e : r = n > 0 ? e / n : 0, r = Math.max(0, Math.min(1, r)), K(t, r);
+function V(t, e, n) {
+  const s = y(t.start, t.end);
+  let i;
+  return n ? i = e : i = s > 0 ? e / s : 0, i = Math.max(0, Math.min(1, i)), K(t, i);
 }
 function b(t, e) {
-  const { p0: s, p1: n, p2: r, p3: o } = t, a = 1 - e, i = a * a, c = i * a, l = e * e, f = l * e;
+  const { p0: n, p1: s, p2: i, p3: o } = t, a = 1 - e, r = a * a, f = r * a, l = e * e, c = l * e;
   return {
-    x: c * s.x + 3 * i * e * n.x + 3 * a * l * r.x + f * o.x,
-    y: c * s.y + 3 * i * e * n.y + 3 * a * l * r.y + f * o.y
+    x: f * n.x + 3 * r * e * s.x + 3 * a * l * i.x + c * o.x,
+    y: f * n.y + 3 * r * e * s.y + 3 * a * l * i.y + c * o.y
   };
 }
-function ne(t, e, s = 10) {
-  return y(t, e) <= s;
+function ne(t, e, n = 10) {
+  return y(t, e) <= n;
 }
 function N(t, e = 100) {
-  const s = [{ t: 0, distance: 0 }];
-  let n = t.p0, r = 0;
+  const n = [{ t: 0, distance: 0 }];
+  let s = t.p0, i = 0;
   for (let o = 1; o <= e; o++) {
-    const a = o / e, i = b(t, a);
-    r += y(n, i), s.push({ t: a, distance: r }), n = i;
+    const a = o / e, r = b(t, a);
+    i += y(s, r), n.push({ t: a, distance: i }), s = r;
   }
-  return s;
+  return n;
 }
 function _(t, e) {
   if (e <= 0) return 0;
-  const s = t[t.length - 1].distance;
-  if (e >= s) return 1;
-  let n = 0, r = t.length - 1;
-  for (; n < r - 1; ) {
-    const f = Math.floor((n + r) / 2);
-    t[f].distance < e ? n = f : r = f;
+  const n = t[t.length - 1].distance;
+  if (e >= n) return 1;
+  let s = 0, i = t.length - 1;
+  for (; s < i - 1; ) {
+    const c = Math.floor((s + i) / 2);
+    t[c].distance < e ? s = c : i = c;
   }
-  const o = t[n].distance, a = t[r].distance, i = t[n].t, c = t[r].t;
-  if (a === o) return i;
+  const o = t[s].distance, a = t[i].distance, r = t[s].t, f = t[i].t;
+  if (a === o) return r;
   const l = (e - o) / (a - o);
-  return i + l * (c - i);
+  return r + l * (f - r);
 }
 function se(t) {
   return t[t.length - 1].distance;
 }
 function F(t, e = 100) {
-  let s = 0, n = t.p0;
-  for (let r = 1; r <= e; r++) {
-    const o = r / e, a = b(t, o);
-    s += y(n, a), n = a;
+  let n = 0, s = t.p0;
+  for (let i = 1; i <= e; i++) {
+    const o = i / e, a = b(t, o);
+    n += y(s, a), s = a;
   }
-  return s;
+  return n;
 }
-function q(t, e, s, n, r) {
+function q(t, e, n, s, i) {
   const o = y(t.start, t.end);
-  return e === void 0 ? n * o : s ? Math.max(0, Math.min(e, 1)) * o : Math.max(0, Math.min(e, o));
+  return e === void 0 ? s * o : n ? Math.max(0, Math.min(e, 1)) * o : Math.max(0, Math.min(e, o));
 }
-function E(t, e, s, n, r) {
+function E(t, e, n, s, i) {
   const o = y(t.start, t.end);
-  return e === void 0 ? n * o : s ? Math.max(0, Math.min(e, 1)) * o : Math.max(0, Math.min(e, o));
+  return e === void 0 ? s * o : n ? Math.max(0, Math.min(e, 1)) * o : Math.max(0, Math.min(e, o));
 }
-function I(t, e, s) {
-  const n = /* @__PURE__ */ new Map(), r = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Map();
+function I(t, e, n) {
+  const s = /* @__PURE__ */ new Map(), i = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Map();
   for (const a of t)
-    r.set(a.id, a), o.set(a.id, y(a.start, a.end)), n.set(a.id, []);
+    i.set(a.id, a), o.set(a.id, y(a.start, a.end)), s.set(a.id, []);
   for (let a = 0; a < e.length; a++) {
-    const i = e[a], c = r.get(i.fromLineId), l = r.get(i.toLineId);
-    if (!c || !l) continue;
-    const f = q(c, i.fromOffset, i.fromIsPercentage, 1, s.maxWheelbase), g = E(l, i.toOffset, i.toIsPercentage, 0, s.maxWheelbase), d = z(
-      c,
+    const r = e[a], f = i.get(r.fromLineId), l = i.get(r.toLineId);
+    if (!f || !l) continue;
+    const c = q(f, r.fromOffset, r.fromIsPercentage, 1, n.maxWheelbase), g = E(l, r.toOffset, r.toIsPercentage, 0, n.maxWheelbase), d = W(
+      f,
       l,
-      s,
+      n,
       !1,
       // willFlip is always false now
       {
-        fromOffset: f,
+        fromOffset: c,
         fromIsPercentage: !1,
         // Already resolved to absolute
         toOffset: g,
@@ -111,31 +111,31 @@ function I(t, e, s) {
       }
     ), h = F(d), p = {
       curveIndex: a,
-      fromLineId: i.fromLineId,
-      toLineId: i.toLineId,
-      fromOffset: f,
+      fromLineId: r.fromLineId,
+      toLineId: r.toLineId,
+      fromOffset: c,
       toOffset: g,
       curveLength: h
     };
-    n.get(i.fromLineId).push(p);
+    s.get(r.fromLineId).push(p);
   }
-  return { adjacency: n, lines: r, lineLengths: o };
+  return { adjacency: s, lines: i, lineLengths: o };
 }
-function W(t, e) {
+function z(t, e) {
   return t.curveCount !== e.curveCount ? t.curveCount - e.curveCount : t.totalDistance - e.totalDistance;
 }
-function G(t, e, s, n, r = !1) {
-  const { adjacency: o, lines: a, lineLengths: i } = t;
-  if (!a.get(s)) return null;
-  const l = i.get(s), f = r ? n / 100 * l : n, g = [], d = /* @__PURE__ */ new Map(), h = (u, v) => `${u}:${Math.round(v)}`;
-  if (e.lineId === s && f >= e.offset) {
-    const u = f - e.offset;
+function G(t, e, n, s, i = !1) {
+  const { adjacency: o, lines: a, lineLengths: r } = t;
+  if (!a.get(n)) return null;
+  const l = r.get(n), c = i ? s / 100 * l : s, g = [], d = /* @__PURE__ */ new Map(), h = (u, v) => `${u}:${Math.round(v)}`;
+  if (e.lineId === n && c >= e.offset) {
+    const u = c - e.offset;
     return {
       segments: [{
         type: "line",
         lineId: e.lineId,
         startOffset: e.offset,
-        endOffset: f,
+        endOffset: c,
         length: u
       }],
       totalDistance: u,
@@ -166,18 +166,18 @@ function G(t, e, s, n, r = !1) {
       path: [L, m]
     });
   }
-  for (g.sort(W); g.length > 0; ) {
+  for (g.sort(z); g.length > 0; ) {
     const u = g.shift(), v = h(u.lineId, u.entryOffset), x = d.get(v);
     if (x !== void 0 && (x.curveCount < u.curveCount || x.curveCount === u.curveCount && x.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) {
+    if (d.set(v, { curveCount: u.curveCount, distance: u.totalDistance }), u.lineId === n) {
+      const m = Math.abs(c - u.entryOffset);
+      if (c >= u.entryOffset) {
         const C = {
           type: "line",
-          lineId: s,
+          lineId: n,
           startOffset: u.entryOffset,
-          endOffset: f,
+          endOffset: c,
           length: m
         };
         return {
@@ -214,17 +214,17 @@ function G(t, e, s, n, r = !1) {
         path: [...u.path, j, $]
       });
     }
-    g.sort(W);
+    g.sort(z);
   }
   return null;
 }
 function A(t, e) {
-  const s = Math.sqrt(
+  const n = 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;
+  ), s = n > 0 ? e / n : 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))
+    x: t.start.x + (t.end.x - t.start.x) * Math.min(1, Math.max(0, s)),
+    y: t.start.y + (t.end.y - t.start.y) * Math.min(1, Math.max(0, s))
   };
 }
 function O(t) {
@@ -232,54 +232,54 @@ function O(t) {
     Math.pow(t.end.x - t.start.x, 2) + Math.pow(t.end.y - t.start.y, 2)
   );
 }
-function Q(t, e, s) {
-  let n = 0;
-  for (let r = 0; r < e; r++)
-    n += t.segments[r].length;
-  return n += s, n;
+function Q(t, e, n) {
+  let s = 0;
+  for (let i = 0; i < e; i++)
+    s += t.segments[i].length;
+  return s += n, s;
 }
 function R(t, e) {
-  let s = 0;
-  for (let n = 0; n < t.segments.length; n++) {
-    const r = t.segments[n], o = s + r.length;
+  let n = 0;
+  for (let s = 0; s < t.segments.length; s++) {
+    const i = t.segments[s], o = n + i.length;
     if (e < o)
       return {
-        segmentIndex: n,
-        segmentDistance: e - s
+        segmentIndex: s,
+        segmentDistance: e - n
       };
     if (e === o)
-      return n + 1 < t.segments.length ? {
-        segmentIndex: n + 1,
+      return s + 1 < t.segments.length ? {
+        segmentIndex: s + 1,
         segmentDistance: 0
       } : {
-        segmentIndex: n,
-        segmentDistance: r.length
+        segmentIndex: s,
+        segmentDistance: i.length
       };
-    s += r.length;
+    n += i.length;
   }
   return null;
 }
-function re(t, e, s, n) {
+function ie(t, e, n, s) {
   const o = Q(
     t,
     e,
-    s
-  ) + n;
+    n
+  ) + s;
   return R(t, o);
 }
-function H(t, e, s, n) {
-  const r = O(n), o = s.length + 1, a = new Array(o);
+function H(t, e, n, s) {
+  const i = O(s), o = n.length + 1, a = new Array(o);
   a[o - 1] = {
     lineId: t,
     absoluteOffset: e,
-    position: A(n, e)
+    position: A(s, e)
   };
-  let i = e;
-  for (let c = o - 2; c >= 0; c--)
-    i = Math.min(i + s[c], r), a[c] = {
+  let r = e;
+  for (let f = o - 2; f >= 0; f--)
+    r = Math.min(r + n[f], i), a[f] = {
       lineId: t,
-      absoluteOffset: i,
-      position: A(n, i)
+      absoluteOffset: r,
+      position: A(s, r)
     };
   return a;
 }
@@ -295,183 +295,183 @@ function U(t) {
     execution: null
   };
 }
-function ie(t, e) {
-  const s = [], n = /* @__PURE__ */ new Map();
-  for (const r of t) {
-    if (!e.get(r.lineId)) continue;
-    const a = J(r);
-    s.push(a);
-    const i = U(a);
-    n.set(r.id, i);
+function re(t, e) {
+  const n = [], s = /* @__PURE__ */ new Map();
+  for (const i of t) {
+    if (!e.get(i.lineId)) continue;
+    const a = J(i);
+    n.push(a);
+    const r = U(a);
+    s.set(i.id, r);
   }
-  return { movingVehicles: s, stateMap: n };
+  return { movingVehicles: n, stateMap: s };
 }
 function M(t, e) {
   return { position: A(t, e), lineId: t.id, absoluteOffset: e };
 }
-function S(t, e) {
-  const s = _(t.arcLengthTable, e);
-  return { position: b(t.bezier, s) };
-}
-function X(t, e, s, n, r, o, a) {
-  const i = s.segments[e.currentSegmentIndex], c = e.segmentDistance + n;
-  if (c >= i.length) {
-    const f = c - i.length, g = e.currentSegmentIndex + 1;
-    if (g >= s.segments.length) {
-      if (a !== void 0 && i.type === "line") {
-        const u = r.get(i.lineId), v = i.startOffset + c;
+function w(t, e) {
+  const n = _(t.arcLengthTable, e);
+  return { position: b(t.bezier, n) };
+}
+function X(t, e, n, s, i, o, a) {
+  const r = n.segments[e.currentSegmentIndex], f = e.segmentDistance + s;
+  if (f >= r.length) {
+    const c = f - r.length, g = e.currentSegmentIndex + 1;
+    if (g >= n.segments.length) {
+      if (a !== void 0 && r.type === "line") {
+        const u = i.get(r.lineId), v = r.startOffset + f;
         if (v <= a) {
           const L = M(u, v);
           return {
             axleState: { ...t, ...L },
-            execution: { ...e, segmentDistance: c },
+            execution: { ...e, segmentDistance: f },
             completed: !1
           };
         }
         const x = M(u, a);
         return {
           axleState: { ...t, ...x },
-          execution: { ...e, segmentDistance: a - i.startOffset },
+          execution: { ...e, segmentDistance: a - r.startOffset },
           completed: !0
         };
       }
-      const p = i.type === "line" ? M(
-        r.get(i.lineId),
-        i.endOffset
-      ) : S(
-        o.get(i.curveIndex),
-        i.length
+      const p = r.type === "line" ? M(
+        i.get(r.lineId),
+        r.endOffset
+      ) : w(
+        o.get(r.curveIndex),
+        r.length
       );
       return {
         axleState: { ...t, ...p },
-        execution: { ...e, segmentDistance: i.length },
+        execution: { ...e, segmentDistance: r.length },
         completed: !0
       };
     }
-    const d = s.segments[g], h = d.type === "line" ? M(
-      r.get(d.lineId),
-      d.startOffset + f
-    ) : S(
+    const d = n.segments[g], h = d.type === "line" ? M(
+      i.get(d.lineId),
+      d.startOffset + c
+    ) : w(
       o.get(d.curveIndex),
-      f
+      c
     );
     return {
       axleState: { ...t, ...h },
       execution: {
         currentSegmentIndex: g,
-        segmentDistance: f
+        segmentDistance: c
       },
       completed: !1
     };
   }
-  const l = i.type === "line" ? M(
-    r.get(i.lineId),
-    i.startOffset + c
-  ) : S(
-    o.get(i.curveIndex),
-    c
+  const l = r.type === "line" ? M(
+    i.get(r.lineId),
+    r.startOffset + f
+  ) : w(
+    o.get(r.curveIndex),
+    f
   );
   return {
     axleState: { ...t, ...l },
-    execution: { ...e, segmentDistance: c },
+    execution: { ...e, segmentDistance: f },
     completed: !1
   };
 }
-function Y(t, e, s, n) {
-  const r = /* @__PURE__ */ new Map();
+function Y(t, e, n, s) {
+  const i = /* @__PURE__ */ new Map();
   for (const o of t.segments)
     if (o.type === "curve" && o.curveIndex !== void 0) {
       const a = e[o.curveIndex];
       if (a) {
-        const i = s.get(a.fromLineId), c = s.get(a.toLineId);
-        if (i && c) {
+        const r = n.get(a.fromLineId), f = n.get(a.toLineId);
+        if (r && f) {
           const l = q(
-            i,
+            r,
             a.fromOffset,
             a.fromIsPercentage,
             1,
             // Default: 100% = 1.0
-            n.maxWheelbase
-          ), f = E(
-            c,
+            s.maxWheelbase
+          ), c = E(
+            f,
             a.toOffset,
             a.toIsPercentage,
             0,
-            n.maxWheelbase
-          ), g = z(
-            i,
-            c,
-            n,
+            s.maxWheelbase
+          ), g = W(
+            r,
+            f,
+            s,
             !1,
             // willFlip is always false now
             {
               fromOffset: l,
               fromIsPercentage: !1,
               // Already resolved to absolute
-              toOffset: f,
+              toOffset: c,
               toIsPercentage: !1
               // Already resolved to absolute
             }
           ), d = N(g);
-          r.set(o.curveIndex, { bezier: g, arcLengthTable: d });
+          i.set(o.curveIndex, { bezier: g, arcLengthTable: d });
         }
       }
     }
-  return r;
-}
-function Z(t, e, s) {
-  const { graph: n, linesMap: r, curves: o, config: a } = s, i = r.get(e.targetLineId);
-  if (!i) return null;
-  const c = t.axleSpacings.reduce((u, v) => u + v, 0), f = O(i) - c;
-  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 = G(
-    n,
+  return i;
+}
+function Z(t, e, n) {
+  const { graph: s, linesMap: i, curves: o, config: a } = n, r = i.get(e.targetLineId);
+  if (!r) return null;
+  const f = t.axleSpacings.reduce((u, v) => u + v, 0), c = O(r) - f;
+  if (c <= 0) return null;
+  const g = e.isPercentage ? e.targetOffset * c : Math.min(e.targetOffset, c), d = t.axles[t.axles.length - 1], h = G(
+    s,
     { lineId: d.lineId, offset: d.absoluteOffset },
     e.targetLineId,
     g,
     !1
   );
   if (!h) return null;
-  const p = Y(h, o, r, a);
+  const p = Y(h, o, i, a);
   return { path: h, curveDataMap: p };
 }
 function oe(t, e) {
-  const s = t.execution, r = e.vehicleQueues.get(t.vehicle.id)?.[s.currentCommandIndex];
-  return r && e.onCommandComplete && e.onCommandComplete({
+  const n = t.execution, i = e.vehicleQueues.get(t.vehicle.id)?.[n.currentCommandIndex];
+  return i && e.onCommandComplete && e.onCommandComplete({
     vehicleId: t.vehicle.id,
-    command: r,
+    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: r.payload
+    payload: i.payload
   }), {
     handled: !0,
     vehicle: { ...t.vehicle, state: "waiting" },
-    newExecution: s,
+    newExecution: n,
     // Keep execution state for resume
     isWaiting: !0
   };
 }
-function ee(t, e, s, n, r, o) {
+function ee(t, e, n, s, i, o) {
   let a;
-  const i = e[0];
-  if (i.currentSegmentIndex < s.segments.length) {
-    const l = s.segments[i.currentSegmentIndex];
+  const r = e[0];
+  if (r.currentSegmentIndex < n.segments.length) {
+    const l = n.segments[r.currentSegmentIndex];
     if (l.type === "line") {
-      const f = r.get(l.lineId);
-      f && (a = O(f));
+      const c = i.get(l.lineId);
+      c && (a = O(c));
     }
   }
-  const c = t.map((l, f) => {
-    const g = f === 0 ? a : void 0;
-    return X(l, e[f], s, n, r, o, g);
+  const f = t.map((l, c) => {
+    const g = c === 0 ? a : void 0;
+    return X(l, e[c], n, s, i, o, g);
   });
   return {
-    axles: c.map((l) => l.axleState),
-    axleExecutions: c.map((l) => l.execution),
-    arrived: c[c.length - 1].completed
+    axles: f.map((l) => l.axleState),
+    axleExecutions: f.map((l) => l.execution),
+    arrived: f[f.length - 1].completed
     // axles[N-1] = rearmost menentukan arrived
   };
 }
@@ -504,11 +504,11 @@ class ae {
   /**
    * Replace the entire scene and rebuild the graph.
    */
-  setScene(e, s) {
+  setScene(e, n) {
     this.linesMap.clear();
-    for (const n of e)
-      this.linesMap.set(n.id, n);
-    this.curves = s, this.graph = I(e, s, this.config);
+    for (const s of e)
+      this.linesMap.set(s.id, s);
+    this.curves = n, this.graph = I(e, n, this.config);
   }
   /**
    * Add a single line. Returns false if a line with the same ID already exists.
@@ -519,36 +519,36 @@ class ae {
   /**
    * Update start and/or end coordinates of an existing line.
    */
-  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 = I(Array.from(this.linesMap.values()), this.curves, this.config), !0) : !1;
+  updateLine(e, n) {
+    const s = this.linesMap.get(e);
+    return s ? (n.start && (s.start = n.start), n.end && (s.end = n.end), this.graph = I(Array.from(this.linesMap.values()), this.curves, this.config), !0) : !1;
   }
   /**
    * Update a single endpoint ('start' or 'end') of a line.
    */
-  updateLineEndpoint(e, s, n) {
-    return this.updateLine(e, { [s]: n });
+  updateLineEndpoint(e, n, s) {
+    return this.updateLine(e, { [n]: s });
   }
   /**
    * Rename a line ID and cascade the change to all connected curves.
    */
-  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 r = this.linesMap.get(e);
-    if (!r) return { success: !1, error: `Line "${e}" not found` };
-    r.id = n, this.linesMap.delete(e), this.linesMap.set(n, r);
+  renameLine(e, n) {
+    const s = n.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 o of this.curves)
-      o.fromLineId === e && (o.fromLineId = n), o.toLineId === e && (o.toLineId = n);
+      o.fromLineId === e && (o.fromLineId = s), o.toLineId === e && (o.toLineId = s);
     return this.graph = I(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((s) => s.fromLineId !== e && s.toLineId !== e), this.graph = I(Array.from(this.linesMap.values()), this.curves, this.config), !0) : !1;
+    return this.linesMap.has(e) ? (this.linesMap.delete(e), this.curves = this.curves.filter((n) => n.fromLineId !== e && n.toLineId !== e), this.graph = I(Array.from(this.linesMap.values()), this.curves, this.config), !0) : !1;
   }
   /**
    * Add a directional curve (connection) from one line to another.
@@ -559,8 +559,8 @@ class ae {
   /**
    * Update a curve by index. Returns false if index is out of bounds.
    */
-  updateCurve(e, s) {
-    return e < 0 || e >= this.curves.length ? !1 : (this.curves[e] = { ...this.curves[e], ...s }, this.graph = I(Array.from(this.linesMap.values()), this.curves, this.config), !0);
+  updateCurve(e, n) {
+    return e < 0 || e >= this.curves.length ? !1 : (this.curves[e] = { ...this.curves[e], ...n }, this.graph = I(Array.from(this.linesMap.values()), this.curves, this.config), !0);
   }
   /**
    * Remove a curve by index. Returns false if index is out of bounds.
@@ -576,16 +576,20 @@ class ae {
    *
    * @param lineId - The line to place the vehicle on
    * @param rearOffset - Absolute distance offset untuk axle paling belakang
-   * @param axleSpacings - Jarak antar axle berurutan (N-1 nilai untuk N axle)
+   * @param vehicle - VehicleDefinition (or any object extending it with axleSpacings)
    * @returns Initial VehiclePathState, or null if lineId does not exist
+   * @throws if axleSpacings is empty
    */
-  initializeVehicle(e, s, n) {
-    const r = this.linesMap.get(e);
-    if (!r) return null;
-    const o = n.reduce((l, f) => l + f, 0), a = O(r), i = Math.min(s, a - o);
+  initializeVehicle(e, n, s) {
+    const i = this.linesMap.get(e);
+    if (!i) return null;
+    const { axleSpacings: o } = s;
+    if (o.length === 0)
+      throw new Error("initializeVehicle: axleSpacings must have at least one entry (vehicle needs ≥2 axles)");
+    const a = o.reduce((c, g) => c + g, 0), r = O(i), f = Math.min(n, r - a);
     return {
-      axles: H(e, i, n, r).map((l) => ({ lineId: l.lineId, offset: l.absoluteOffset, position: l.position })),
-      axleSpacings: n
+      axles: H(e, f, o, i).map((c) => ({ lineId: c.lineId, offset: c.absoluteOffset, position: c.position })),
+      axleSpacings: o
     };
   }
   /**
@@ -598,9 +602,9 @@ class ae {
    * @param targetOffset - Position on the target line
    * @param isPercentage - If true, targetOffset is 0-1 fraction; if false, absolute distance
    */
-  preparePath(e, s, n, r = !1) {
+  preparePath(e, n, s, i = !1) {
     if (!this.graph) return null;
-    const o = e.axleSpacings.reduce((h, p) => h + p, 0), a = e.axles[e.axles.length - 1], i = {
+    const o = e.axleSpacings.reduce((h, p) => h + p, 0), a = e.axles[e.axles.length - 1], r = {
       lineId: a.lineId,
       offset: a.offset,
       axles: e.axles.map((h) => ({
@@ -609,22 +613,22 @@ class ae {
         absoluteOffset: h.offset
       })),
       axleSpacings: e.axleSpacings
-    }, c = Z(i, {
-      targetLineId: s,
-      targetOffset: n,
-      isPercentage: r
+    }, f = Z(r, {
+      targetLineId: n,
+      targetOffset: s,
+      isPercentage: i
     }, {
       graph: this.graph,
       linesMap: this.linesMap,
       curves: this.curves,
       config: this.config
     });
-    if (!c) return null;
-    let l = n;
-    const f = this.linesMap.get(s);
-    if (f) {
-      const h = Math.max(0, O(f) - o);
-      l = r ? n * h : Math.min(n, h);
+    if (!f) return null;
+    let l = s;
+    const c = this.linesMap.get(n);
+    if (c) {
+      const h = Math.max(0, O(c) - o);
+      l = i ? s * h : Math.min(s, h);
     }
     let g = 0;
     const d = [
@@ -634,10 +638,10 @@ class ae {
     for (let h = 0; h < e.axleSpacings.length; h++)
       g += e.axleSpacings[h], d.push({ segmentIndex: 0, segmentDistance: o - g });
     return {
-      path: c.path,
-      curveDataMap: c.curveDataMap,
+      path: f.path,
+      curveDataMap: f.curveDataMap,
       axleExecutions: d,
-      targetLineId: s,
+      targetLineId: n,
       targetOffset: l
     };
   }
@@ -651,25 +655,25 @@ class ae {
    * @param execution - Current path execution (from preparePath or previous tick)
    * @param distance - Distance to advance this tick (speed × deltaTime)
    */
-  moveVehicle(e, s, n) {
-    const r = e.axles.map((i) => ({
-      lineId: i.lineId,
-      position: i.position,
-      absoluteOffset: i.offset
-    })), o = s.axleExecutions.map((i) => ({
-      currentSegmentIndex: i.segmentIndex,
-      segmentDistance: i.segmentDistance
-    })), a = ee(r, o, s.path, n, this.linesMap, s.curveDataMap);
+  moveVehicle(e, n, s) {
+    const i = e.axles.map((r) => ({
+      lineId: r.lineId,
+      position: r.position,
+      absoluteOffset: r.offset
+    })), o = n.axleExecutions.map((r) => ({
+      currentSegmentIndex: r.segmentIndex,
+      segmentDistance: r.segmentDistance
+    })), a = ee(i, o, n.path, s, this.linesMap, n.curveDataMap);
     return {
       state: {
-        axles: a.axles.map((i) => ({ lineId: i.lineId, offset: i.absoluteOffset, position: i.position })),
+        axles: a.axles.map((r) => ({ lineId: r.lineId, offset: r.absoluteOffset, position: r.position })),
         axleSpacings: e.axleSpacings
       },
       execution: {
-        ...s,
-        axleExecutions: a.axleExecutions.map((i) => ({
-          segmentIndex: i.currentSegmentIndex,
-          segmentDistance: i.segmentDistance
+        ...n,
+        axleExecutions: a.axleExecutions.map((r) => ({
+          segmentIndex: r.currentSegmentIndex,
+          segmentDistance: r.segmentDistance
         }))
       },
       arrived: a.arrived
@@ -677,7 +681,7 @@ class ae {
   }
 }
 export {
-  w as A,
+  S as A,
   Z as B,
   q as C,
   E as D,
@@ -687,13 +691,13 @@ export {
   N as b,
   I as c,
   F as d,
-  re as e,
+  ie as e,
   H as f,
   O as g,
-  S as h,
+  w as h,
   M as i,
   k as j,
-  z as k,
+  W as k,
   U as l,
   y as m,
   _ as n,
@@ -705,7 +709,7 @@ export {
   V as t,
   A as u,
   oe as v,
-  ie as w,
+  re as w,
   J as x,
   ne as y,
   ee as z

package/dist/index-C4FckUel.cjs

@@ -0,0 +1 @@
+"use strict";function L(t,e){const n=e.x-t.x,s=e.y-t.y;return Math.sqrt(n*n+s*s)}function D(t,e){const n=e.x-t.x,s=e.y-t.y,i=Math.sqrt(n*n+s*s);return i===0?{x:0,y:0}:{x:n/i,y:s/i}}function q(t,e){return e*(t==="proportional-40"?.4:.5522)}function V(t,e,n,s=!1,i){const{maxWheelbase:o,tangentMode:c}=n;let r;i?.fromOffset!==void 0?r=b(t,i.fromOffset,i.fromIsPercentage??!1):r=t.end;let u;i?.toOffset!==void 0?u=b(e,i.toOffset,i.toIsPercentage??!1):u=e.start;const l=D(t.start,t.end),a=s?{x:r.x-l.x*o,y:r.y-l.y*o}:r,g=D(t.start,t.end),d=D(e.start,e.end),h=L(a,u),p=q(c,h),f=s?{x:a.x-g.x*p,y:a.y-g.y*p}:{x:a.x+g.x*p,y:a.y+g.y*p},v={x:u.x-d.x*p,y:u.y-d.y*p};return{p0:a,p1:f,p2:v,p3:u}}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,n){const s=L(t.start,t.end);let i;return n?i=e:i=s>0?e/s:0,i=Math.max(0,Math.min(1,i)),F(t,i)}function w(t,e){const{p0:n,p1:s,p2:i,p3:o}=t,c=1-e,r=c*c,u=r*c,l=e*e,a=l*e;return{x:u*n.x+3*r*e*s.x+3*c*l*i.x+a*o.x,y:u*n.y+3*r*e*s.y+3*c*l*i.y+a*o.y}}function ee(t,e,n=10){return L(t,e)<=n}function N(t,e=100){const n=[{t:0,distance:0}];let s=t.p0,i=0;for(let o=1;o<=e;o++){const c=o/e,r=w(t,c);i+=L(s,r),n.push({t:c,distance:i}),s=r}return n}function $(t,e){if(e<=0)return 0;const n=t[t.length-1].distance;if(e>=n)return 1;let s=0,i=t.length-1;for(;s<i-1;){const a=Math.floor((s+i)/2);t[a].distance<e?s=a:i=a}const o=t[s].distance,c=t[i].distance,r=t[s].t,u=t[i].t;if(c===o)return r;const l=(e-o)/(c-o);return r+l*(u-r)}function te(t){return t[t.length-1].distance}function j(t,e=100){let n=0,s=t.p0;for(let i=1;i<=e;i++){const o=i/e,c=w(t,o);n+=L(s,c),s=c}return n}function z(t,e,n,s,i){const o=L(t.start,t.end);return e===void 0?s*o:n?Math.max(0,Math.min(e,1))*o:Math.max(0,Math.min(e,o))}function W(t,e,n,s,i){const o=L(t.start,t.end);return e===void 0?s*o:n?Math.max(0,Math.min(e,1))*o:Math.max(0,Math.min(e,o))}function x(t,e,n){const s=new Map,i=new Map,o=new Map;for(const c of t)i.set(c.id,c),o.set(c.id,L(c.start,c.end)),s.set(c.id,[]);for(let c=0;c<e.length;c++){const r=e[c],u=i.get(r.fromLineId),l=i.get(r.toLineId);if(!u||!l)continue;const a=z(u,r.fromOffset,r.fromIsPercentage,1,n.maxWheelbase),g=W(l,r.toOffset,r.toIsPercentage,0,n.maxWheelbase),d=V(u,l,n,!1,{fromOffset:a,fromIsPercentage:!1,toOffset:g,toIsPercentage:!1}),h=j(d),p={curveIndex:c,fromLineId:r.fromLineId,toLineId:r.toLineId,fromOffset:a,toOffset:g,curveLength:h};s.get(r.fromLineId).push(p)}return{adjacency:s,lines:i,lineLengths:o}}function E(t,e){return t.curveCount!==e.curveCount?t.curveCount-e.curveCount:t.totalDistance-e.totalDistance}function K(t,e,n,s,i=!1){const{adjacency:o,lines:c,lineLengths:r}=t;if(!c.get(n))return null;const l=r.get(n),a=i?s/100*l:s,g=[],d=new Map,h=(f,v)=>`${f}:${Math.round(v)}`;if(e.lineId===n&&a>=e.offset){const f=a-e.offset;return{segments:[{type:"line",lineId:e.lineId,startOffset:e.offset,endOffset:a,length:f}],totalDistance:f,curveCount:0}}const p=o.get(e.lineId)||[];for(const f of p){if(f.fromOffset<e.offset)continue;const v=f.fromOffset-e.offset,I=v+f.curveLength,O={type:"line",lineId:e.lineId,startOffset:e.offset,endOffset:f.fromOffset,length:v},m={type:"curve",curveIndex:f.curveIndex,startOffset:0,endOffset:f.curveLength,length:f.curveLength};g.push({lineId:f.toLineId,entryOffset:f.toOffset,totalDistance:I,curveCount:1,path:[O,m]})}for(g.sort(E);g.length>0;){const f=g.shift(),v=h(f.lineId,f.entryOffset),I=d.get(v);if(I!==void 0&&(I.curveCount<f.curveCount||I.curveCount===f.curveCount&&I.distance<=f.totalDistance))continue;if(d.set(v,{curveCount:f.curveCount,distance:f.totalDistance}),f.lineId===n){const m=Math.abs(a-f.entryOffset);if(a>=f.entryOffset){const P={type:"line",lineId:n,startOffset:f.entryOffset,endOffset:a,length:m};return{segments:[...f.path,P],totalDistance:f.totalDistance+m,curveCount:f.curveCount}}}const O=o.get(f.lineId)||[];for(const m of O){if(m.fromOffset<f.entryOffset)continue;const P=m.fromOffset-f.entryOffset,B=f.totalDistance+P+m.curveLength,T=f.curveCount+1,X=h(m.toLineId,m.toOffset),C=d.get(X);if(C!==void 0&&(C.curveCount<T||C.curveCount===T&&C.distance<=B))continue;const Y={type:"line",lineId:f.lineId,startOffset:f.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:B,curveCount:T,path:[...f.path,Y,Z]})}g.sort(E)}return null}function A(t,e){const n=Math.sqrt(Math.pow(t.end.x-t.start.x,2)+Math.pow(t.end.y-t.start.y,2)),s=n>0?e/n:0;return{x:t.start.x+(t.end.x-t.start.x)*Math.min(1,Math.max(0,s)),y:t.start.y+(t.end.y-t.start.y)*Math.min(1,Math.max(0,s))}}function M(t){return Math.sqrt(Math.pow(t.end.x-t.start.x,2)+Math.pow(t.end.y-t.start.y,2))}function _(t,e,n){let s=0;for(let i=0;i<e;i++)s+=t.segments[i].length;return s+=n,s}function k(t,e){let n=0;for(let s=0;s<t.segments.length;s++){const i=t.segments[s],o=n+i.length;if(e<o)return{segmentIndex:s,segmentDistance:e-n};if(e===o)return s+1<t.segments.length?{segmentIndex:s+1,segmentDistance:0}:{segmentIndex:s,segmentDistance:i.length};n+=i.length}return null}function ne(t,e,n,s){const o=_(t,e,n)+s;return k(t,o)}function G(t,e,n,s){const i=M(s),o=n.length+1,c=new Array(o);c[o-1]={lineId:t,absoluteOffset:e,position:A(s,e)};let r=e;for(let u=o-2;u>=0;u--)r=Math.min(r+n[u],i),c[u]={lineId:t,absoluteOffset:r,position:A(s,r)};return c}function Q(t,e){return{...t,state:"idle"}}function R(t){return{vehicle:t,execution:null}}function se(t,e){const n=[],s=new Map;for(const i of t){if(!e.get(i.lineId))continue;const c=Q(i);n.push(c);const r=R(c);s.set(i.id,r)}return{movingVehicles:n,stateMap:s}}function y(t,e){return{position:A(t,e),lineId:t.id,absoluteOffset:e}}function S(t,e){const n=$(t.arcLengthTable,e);return{position:w(t.bezier,n)}}function H(t,e,n,s,i,o,c){const r=n.segments[e.currentSegmentIndex],u=e.segmentDistance+s;if(u>=r.length){const a=u-r.length,g=e.currentSegmentIndex+1;if(g>=n.segments.length){if(c!==void 0&&r.type==="line"){const f=i.get(r.lineId),v=r.startOffset+u;if(v<=c){const O=y(f,v);return{axleState:{...t,...O},execution:{...e,segmentDistance:u},completed:!1}}const I=y(f,c);return{axleState:{...t,...I},execution:{...e,segmentDistance:c-r.startOffset},completed:!0}}const p=r.type==="line"?y(i.get(r.lineId),r.endOffset):S(o.get(r.curveIndex),r.length);return{axleState:{...t,...p},execution:{...e,segmentDistance:r.length},completed:!0}}const d=n.segments[g],h=d.type==="line"?y(i.get(d.lineId),d.startOffset+a):S(o.get(d.curveIndex),a);return{axleState:{...t,...h},execution:{currentSegmentIndex:g,segmentDistance:a},completed:!1}}const l=r.type==="line"?y(i.get(r.lineId),r.startOffset+u):S(o.get(r.curveIndex),u);return{axleState:{...t,...l},execution:{...e,segmentDistance:u},completed:!1}}function ie(t,e,n,s){const i=new Map;for(const o of t.segments)if(o.type==="curve"&&o.curveIndex!==void 0){const c=e[o.curveIndex];if(c){const r=n.get(c.fromLineId),u=n.get(c.toLineId);if(r&&u){const l=z(r,c.fromOffset,c.fromIsPercentage,1,s.maxWheelbase),a=W(u,c.toOffset,c.toIsPercentage,0,s.maxWheelbase),g=V(r,u,s,!1,{fromOffset:l,fromIsPercentage:!1,toOffset:a,toIsPercentage:!1}),d=N(g);i.set(o.curveIndex,{bezier:g,arcLengthTable:d})}}}return i}function J(t,e,n){const{graph:s,linesMap:i,curves:o,config:c}=n,r=i.get(e.targetLineId);if(!r)return null;const u=t.axleSpacings.reduce((f,v)=>f+v,0),a=M(r)-u;if(a<=0)return null;const g=e.isPercentage?e.targetOffset*a:Math.min(e.targetOffset,a),d=t.axles[t.axles.length-1],h=K(s,{lineId:d.lineId,offset:d.absoluteOffset},e.targetLineId,g,!1);if(!h)return null;const p=ie(h,o,i,c);return{path:h,curveDataMap:p}}function re(t,e){const n=t.execution,i=e.vehicleQueues.get(t.vehicle.id)?.[n.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:n,isWaiting:!0}}function U(t,e,n,s,i,o){let c;const r=e[0];if(r.currentSegmentIndex<n.segments.length){const l=n.segments[r.currentSegmentIndex];if(l.type==="line"){const a=i.get(l.lineId);a&&(c=M(a))}}const u=t.map((l,a)=>{const g=a===0?c:void 0;return H(l,e[a],n,s,i,o,g)});return{axles:u.map(l=>l.axleState),axleExecutions:u.map(l=>l.execution),arrived:u[u.length-1].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,n){this.linesMap.clear();for(const s of e)this.linesMap.set(s.id,s);this.curves=n,this.graph=x(e,n,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,n){const s=this.linesMap.get(e);return s?(n.start&&(s.start=n.start),n.end&&(s.end=n.end),this.graph=x(Array.from(this.linesMap.values()),this.curves,this.config),!0):!1}updateLineEndpoint(e,n,s){return this.updateLine(e,{[n]:s})}renameLine(e,n){const s=n.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 o of this.curves)o.fromLineId===e&&(o.fromLineId=s),o.toLineId===e&&(o.toLineId=s);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(n=>n.fromLineId!==e&&n.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,n){return e<0||e>=this.curves.length?!1:(this.curves[e]={...this.curves[e],...n},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,n,s){const i=this.linesMap.get(e);if(!i)return null;const{axleSpacings:o}=s;if(o.length===0)throw new Error("initializeVehicle: axleSpacings must have at least one entry (vehicle needs ≥2 axles)");const c=o.reduce((a,g)=>a+g,0),r=M(i),u=Math.min(n,r-c);return{axles:G(e,u,o,i).map(a=>({lineId:a.lineId,offset:a.absoluteOffset,position:a.position})),axleSpacings:o}}preparePath(e,n,s,i=!1){if(!this.graph)return null;const o=e.axleSpacings.reduce((h,p)=>h+p,0),c=e.axles[e.axles.length-1],r={lineId:c.lineId,offset:c.offset,axles:e.axles.map(h=>({lineId:h.lineId,position:h.position,absoluteOffset:h.offset})),axleSpacings:e.axleSpacings},u=J(r,{targetLineId:n,targetOffset:s,isPercentage:i},{graph:this.graph,linesMap:this.linesMap,curves:this.curves,config:this.config});if(!u)return null;let l=s;const a=this.linesMap.get(n);if(a){const h=Math.max(0,M(a)-o);l=i?s*h:Math.min(s,h)}let g=0;const d=[{segmentIndex:0,segmentDistance:o}];for(let h=0;h<e.axleSpacings.length;h++)g+=e.axleSpacings[h],d.push({segmentIndex:0,segmentDistance:o-g});return{path:u.path,curveDataMap:u.curveDataMap,axleExecutions:d,targetLineId:n,targetOffset:l}}moveVehicle(e,n,s){const i=e.axles.map(r=>({lineId:r.lineId,position:r.position,absoluteOffset:r.offset})),o=n.axleExecutions.map(r=>({currentSegmentIndex:r.segmentIndex,segmentDistance:r.segmentDistance})),c=U(i,o,n.path,s,this.linesMap,n.curveDataMap);return{state:{axles:c.axles.map(r=>({lineId:r.lineId,offset:r.absoluteOffset,position:r.position})),axleSpacings:e.axleSpacings},execution:{...n,axleExecutions:c.axleExecutions.map(r=>({segmentIndex:r.currentSegmentIndex,segmentDistance:r.segmentDistance}))},arrived:c.arrived}}}exports.PathEngine=oe;exports.arcLengthToSegmentPosition=k;exports.buildArcLengthTable=N;exports.buildGraph=x;exports.calculateBezierArcLength=j;exports.calculateFrontAxlePosition=ne;exports.calculateInitialAxlePositions=G;exports.calculatePositionOnCurve=S;exports.calculatePositionOnLine=y;exports.calculateTangentLength=q;exports.createBezierCurve=V;exports.createInitialMovementState=R;exports.distance=L;exports.distanceToT=$;exports.findPath=K;exports.getArcLength=te;exports.getCumulativeArcLength=_;exports.getLineLength=M;exports.getPointOnBezier=w;exports.getPointOnLine=F;exports.getPointOnLineByOffset=b;exports.getPositionFromOffset=A;exports.handleArrival=re;exports.initializeAllVehicles=se;exports.initializeMovingVehicle=Q;exports.isPointNearPoint=ee;exports.moveVehicle=U;exports.normalize=D;exports.prepareCommandPath=J;exports.resolveFromLineOffset=z;exports.resolveToLineOffset=W;exports.updateAxlePosition=H;

package/dist/vehicle-path.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-BUYdltrL.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.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;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-C4FckUel.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.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;

package/dist/vehicle-path.js

@@ -1,4 +1,4 @@
-import { P as i, a as t, b as s, c as n, d as o, e as l, f as r, h as c, i as g, k as h, l as P, m as u, n as L, o as f, p as m, q as v, g as A, r as d, s as O, t as z, u as p, v as x, w as B, x as C, z as T, A as b, B as F, C as V, D as E, E as I } from "./index-wjEuFiRl.js";
+import { P as i, a as t, b as s, c as n, d as o, e as l, f as r, h as c, i as g, k as h, l as P, m as u, n as L, o as f, p as m, q as v, g as A, r as d, s as O, t as z, u as p, v as x, w as B, x as C, z as T, A as b, B as F, C as V, D as E, E as I } from "./index-BV93143R.js";
 export {
   i as PathEngine,
   t as arcLengthToSegmentPosition,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vehicle-path2",
-  "version": "2.4.0",
+  "version": "3.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",

package/dist/index-BUYdltrL.cjs

@@ -1 +0,0 @@
-"use strict";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 E(t,e){return e*(t==="proportional-40"?.4:.5522)}function V(t,e,s,n=!1,i){const{maxWheelbase:o,tangentMode:c}=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),u=n?{x:r.x-l.x*o,y:r.y-l.y*o}:r,g=D(t.start,t.end),d=D(e.start,e.end),h=L(u,a),p=E(c,h),f=n?{x:u.x-g.x*p,y:u.y-g.y*p}:{x:u.x+g.x*p,y:u.y+g.y*p},v={x:a.x-d.x*p,y:a.y-d.y*p};return{p0:u,p1:f,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:o}=t,c=1-e,r=c*c,a=r*c,l=e*e,u=l*e;return{x:a*s.x+3*r*e*n.x+3*c*l*i.x+u*o.x,y:a*s.y+3*r*e*n.y+3*c*l*i.y+u*o.y}}function ee(t,e,s=10){return L(t,e)<=s}function N(t,e=100){const s=[{t:0,distance:0}];let n=t.p0,i=0;for(let o=1;o<=e;o++){const c=o/e,r=T(t,c);i+=L(n,r),s.push({t:c,distance:i}),n=r}return s}function $(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 u=Math.floor((n+i)/2);t[u].distance<e?n=u:i=u}const o=t[n].distance,c=t[i].distance,r=t[n].t,a=t[i].t;if(c===o)return r;const l=(e-o)/(c-o);return r+l*(a-r)}function te(t){return t[t.length-1].distance}function j(t,e=100){let s=0,n=t.p0;for(let i=1;i<=e;i++){const o=i/e,c=T(t,o);s+=L(n,c),n=c}return s}function z(t,e,s,n,i){const o=L(t.start,t.end);return e===void 0?n*o:s?Math.max(0,Math.min(e,1))*o:Math.max(0,Math.min(e,o))}function W(t,e,s,n,i){const o=L(t.start,t.end);return e===void 0?n*o:s?Math.max(0,Math.min(e,1))*o:Math.max(0,Math.min(e,o))}function x(t,e,s){const n=new Map,i=new Map,o=new Map;for(const c of t)i.set(c.id,c),o.set(c.id,L(c.start,c.end)),n.set(c.id,[]);for(let c=0;c<e.length;c++){const r=e[c],a=i.get(r.fromLineId),l=i.get(r.toLineId);if(!a||!l)continue;const u=z(a,r.fromOffset,r.fromIsPercentage,1,s.maxWheelbase),g=W(l,r.toOffset,r.toIsPercentage,0,s.maxWheelbase),d=V(a,l,s,!1,{fromOffset:u,fromIsPercentage:!1,toOffset:g,toIsPercentage:!1}),h=j(d),p={curveIndex:c,fromLineId:r.fromLineId,toLineId:r.toLineId,fromOffset:u,toOffset:g,curveLength:h};n.get(r.fromLineId).push(p)}return{adjacency:n,lines:i,lineLengths:o}}function q(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:o,lines:c,lineLengths:r}=t;if(!c.get(s))return null;const l=r.get(s),u=i?n/100*l:n,g=[],d=new Map,h=(f,v)=>`${f}:${Math.round(v)}`;if(e.lineId===s&&u>=e.offset){const f=u-e.offset;return{segments:[{type:"line",lineId:e.lineId,startOffset:e.offset,endOffset:u,length:f}],totalDistance:f,curveCount:0}}const p=o.get(e.lineId)||[];for(const f of p){if(f.fromOffset<e.offset)continue;const v=f.fromOffset-e.offset,I=v+f.curveLength,O={type:"line",lineId:e.lineId,startOffset:e.offset,endOffset:f.fromOffset,length:v},m={type:"curve",curveIndex:f.curveIndex,startOffset:0,endOffset:f.curveLength,length:f.curveLength};g.push({lineId:f.toLineId,entryOffset:f.toOffset,totalDistance:I,curveCount:1,path:[O,m]})}for(g.sort(q);g.length>0;){const f=g.shift(),v=h(f.lineId,f.entryOffset),I=d.get(v);if(I!==void 0&&(I.curveCount<f.curveCount||I.curveCount===f.curveCount&&I.distance<=f.totalDistance))continue;if(d.set(v,{curveCount:f.curveCount,distance:f.totalDistance}),f.lineId===s){const m=Math.abs(u-f.entryOffset);if(u>=f.entryOffset){const P={type:"line",lineId:s,startOffset:f.entryOffset,endOffset:u,length:m};return{segments:[...f.path,P],totalDistance:f.totalDistance+m,curveCount:f.curveCount}}}const O=o.get(f.lineId)||[];for(const m of O){if(m.fromOffset<f.entryOffset)continue;const P=m.fromOffset-f.entryOffset,B=f.totalDistance+P+m.curveLength,w=f.curveCount+1,X=h(m.toLineId,m.toOffset),C=d.get(X);if(C!==void 0&&(C.curveCount<w||C.curveCount===w&&C.distance<=B))continue;const Y={type:"line",lineId:f.lineId,startOffset:f.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:B,curveCount:w,path:[...f.path,Y,Z]})}g.sort(q)}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 M(t){return Math.sqrt(Math.pow(t.end.x-t.start.x,2)+Math.pow(t.end.y-t.start.y,2))}function _(t,e,s){let n=0;for(let i=0;i<e;i++)n+=t.segments[i].length;return n+=s,n}function k(t,e){let s=0;for(let n=0;n<t.segments.length;n++){const i=t.segments[n],o=s+i.length;if(e<o)return{segmentIndex:n,segmentDistance:e-s};if(e===o)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 o=_(t,e,s)+n;return k(t,o)}function G(t,e,s,n){const i=M(n),o=s.length+1,c=new Array(o);c[o-1]={lineId:t,absoluteOffset:e,position:S(n,e)};let r=e;for(let a=o-2;a>=0;a--)r=Math.min(r+s[a],i),c[a]={lineId:t,absoluteOffset:r,position:S(n,r)};return c}function Q(t,e){return{...t,state:"idle"}}function R(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 c=Q(i);s.push(c);const r=R(c);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=$(t.arcLengthTable,e);return{position:T(t.bezier,s)}}function H(t,e,s,n,i,o,c){const r=s.segments[e.currentSegmentIndex],a=e.segmentDistance+n;if(a>=r.length){const u=a-r.length,g=e.currentSegmentIndex+1;if(g>=s.segments.length){if(c!==void 0&&r.type==="line"){const f=i.get(r.lineId),v=r.startOffset+a;if(v<=c){const O=y(f,v);return{axleState:{...t,...O},execution:{...e,segmentDistance:a},completed:!1}}const I=y(f,c);return{axleState:{...t,...I},execution:{...e,segmentDistance:c-r.startOffset},completed:!0}}const p=r.type==="line"?y(i.get(r.lineId),r.endOffset):A(o.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+u):A(o.get(d.curveIndex),u);return{axleState:{...t,...h},execution:{currentSegmentIndex:g,segmentDistance:u},completed:!1}}const l=r.type==="line"?y(i.get(r.lineId),r.startOffset+a):A(o.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 o of t.segments)if(o.type==="curve"&&o.curveIndex!==void 0){const c=e[o.curveIndex];if(c){const r=s.get(c.fromLineId),a=s.get(c.toLineId);if(r&&a){const l=z(r,c.fromOffset,c.fromIsPercentage,1,n.maxWheelbase),u=W(a,c.toOffset,c.toIsPercentage,0,n.maxWheelbase),g=V(r,a,n,!1,{fromOffset:l,fromIsPercentage:!1,toOffset:u,toIsPercentage:!1}),d=N(g);i.set(o.curveIndex,{bezier:g,arcLengthTable:d})}}}return i}function J(t,e,s){const{graph:n,linesMap:i,curves:o,config:c}=s,r=i.get(e.targetLineId);if(!r)return null;const a=t.axleSpacings.reduce((f,v)=>f+v,0),u=M(r)-a;if(u<=0)return null;const g=e.isPercentage?e.targetOffset*u:Math.min(e.targetOffset,u),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,o,i,c);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,o){let c;const r=e[0];if(r.currentSegmentIndex<s.segments.length){const l=s.segments[r.currentSegmentIndex];if(l.type==="line"){const u=i.get(l.lineId);u&&(c=M(u))}}const a=t.map((l,u)=>{const g=u===0?c:void 0;return H(l,e[u],s,n,i,o,g)});return{axles:a.map(l=>l.axleState),axleExecutions:a.map(l=>l.execution),arrived:a[a.length-1].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 o of this.curves)o.fromLineId===e&&(o.fromLineId=n),o.toLineId===e&&(o.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 o=n.reduce((l,u)=>l+u,0),c=M(i),r=Math.min(s,c-o);return{axles:G(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 o=e.axleSpacings.reduce((h,p)=>h+p,0),c=e.axles[e.axles.length-1],r={lineId:c.lineId,offset:c.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 u=this.linesMap.get(s);if(u){const h=Math.max(0,M(u)-o);l=i?n*h:Math.min(n,h)}let g=0;const d=[{segmentIndex:0,segmentDistance:o}];for(let h=0;h<e.axleSpacings.length;h++)g+=e.axleSpacings[h],d.push({segmentIndex:0,segmentDistance:o-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})),o=s.axleExecutions.map(r=>({currentSegmentIndex:r.segmentIndex,segmentDistance:r.segmentDistance})),c=U(i,o,s.path,n,this.linesMap,s.curveDataMap);return{state:{axles:c.axles.map(r=>({lineId:r.lineId,offset:r.absoluteOffset,position:r.position})),axleSpacings:e.axleSpacings},execution:{...s,axleExecutions:c.axleExecutions.map(r=>({segmentIndex:r.currentSegmentIndex,segmentDistance:r.segmentDistance}))},arrived:c.arrived}}}exports.PathEngine=oe;exports.arcLengthToSegmentPosition=k;exports.buildArcLengthTable=N;exports.buildGraph=x;exports.calculateBezierArcLength=j;exports.calculateFrontAxlePosition=ne;exports.calculateInitialAxlePositions=G;exports.calculatePositionOnCurve=A;exports.calculatePositionOnLine=y;exports.calculateTangentLength=E;exports.createBezierCurve=V;exports.createInitialMovementState=R;exports.distance=L;exports.distanceToT=$;exports.findPath=K;exports.getArcLength=te;exports.getCumulativeArcLength=_;exports.getLineLength=M;exports.getPointOnBezier=T;exports.getPointOnLine=F;exports.getPointOnLineByOffset=b;exports.getPositionFromOffset=S;exports.handleArrival=re;exports.initializeAllVehicles=se;exports.initializeMovingVehicle=Q;exports.isPointNearPoint=ee;exports.moveVehicle=U;exports.normalize=D;exports.prepareCommandPath=J;exports.resolveFromLineOffset=z;exports.resolveToLineOffset=W;exports.updateAxlePosition=H;