vehicle-path2 2.3.0 → 2.4.0

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

@@ -0,0 +1,31 @@
+import type { Point, Line, Curve } from '../types/geometry';
+/**
+ * Project a point onto a line segment.
+ *
+ * Returns:
+ * - offset: absolute distance from line.start along the line (clamped to [0, lineLength])
+ * - distance: perpendicular distance from point to the nearest point on the line
+ */
+export declare function projectPointOnLine(point: Point, line: Line): {
+    offset: number;
+    distance: number;
+};
+/**
+ * Compute the valid [min, max] offset range for placing the rear axle of a
+ * multi-axle vehicle on a line.
+ *
+ * - min is always 0 (rear axle at line start)
+ * - max is lineLength - totalAxleSpacing (so all axles fit on the line)
+ * - If the vehicle is too long for the line, returns [0, 0]
+ */
+export declare function getValidRearOffsetRange(line: Line, axleSpacings: number[]): [number, number];
+/**
+ * Compute the minimum length a line must have so that all attached curve
+ * offsets (fromOffset / toOffset) remain within valid bounds.
+ *
+ * Only absolute offsets contribute to the minimum — percentage-based offsets
+ * scale with the line and therefore impose no hard minimum.
+ *
+ * Returns 0 if no curves are attached or all offsets are percentage-based.
+ */
+export declare function computeMinLineLength(lineId: string, curves: Curve[]): number;

package/dist/core/index.d.ts

@@ -20,3 +20,4 @@ export { initializeMovingVehicle, createInitialMovementState, initializeAllVehic
 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';
 export { serializeScene, deserializeScene, type SceneSnapshot } from './snapshot';
+export { projectPointOnLine, getValidRearOffsetRange, computeMinLineLength } from './algorithms/geometry';

package/dist/core.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-BUYdltrL.cjs");function o(r,n,t){const a={lines:r,curves:n.map(i=>({id:i.id,fromLineId:i.fromLineId,toLineId:i.toLineId,fromOffset:i.fromOffset,fromIsPercentage:i.fromIsPercentage??!1,toOffset:i.toOffset,toIsPercentage:i.toIsPercentage??!1})),vehicles:t.map(i=>({id:i.id,lineId:i.axles[0].lineId,axles:i.axles.map(l=>({offset:l.offset})),axleSpacings:i.axleSpacings,isPercentage:i.isPercentage??!1}))};return JSON.stringify(a,null,2)}function s(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 t=n;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"');return{lines:t.lines,curves:t.curves,vehicles:t.vehicles}}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.deserializeScene=s;exports.serializeScene=o;
+"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;

package/dist/core.js

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

package/dist/{index-D-HctiIv.js → index-wjEuFiRl.js}

@@ -689,17 +689,17 @@ export {
   F as d,
   re as e,
   H as f,
-  S as g,
-  M as h,
-  k as i,
-  z as j,
-  U as k,
-  y as l,
-  _ as m,
-  G as n,
-  se as o,
-  Q as p,
-  O as q,
+  O as g,
+  S as h,
+  M as i,
+  k as j,
+  z as k,
+  U as l,
+  y as m,
+  _ as n,
+  G as o,
+  se as p,
+  Q as q,
   b as r,
   K as s,
   V as t,

package/dist/vehicle-path.js

@@ -1,7 +1,7 @@
-import { P as t, a as i, b as s, c as n, d as o, e as l, f as r, g as c, h as g, j as h, k as P, l as u, m as L, n as f, o as m, p as v, q 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-D-HctiIv.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-wjEuFiRl.js";
 export {
-  t as PathEngine,
-  i as arcLengthToSegmentPosition,
+  i as PathEngine,
+  t as arcLengthToSegmentPosition,
   s as buildArcLengthTable,
   n as buildGraph,
   o as calculateBezierArcLength,

package/package.json

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