vehicle-path2 1.0.0

package/dist/vehicle-helpers-_72KxCqO.js

@@ -0,0 +1,276 @@
+import { distance as g, getPointOnLineByOffset as $, calculateInitialFrontPosition as I } from "./core.js";
+class S {
+  listeners = /* @__PURE__ */ new Map();
+  /**
+   * Subscribe to an event
+   * @param event - The event type to listen for
+   * @param callback - Function to call when event is emitted
+   * @returns Unsubscribe function
+   */
+  on(t, e) {
+    return this.listeners.has(t) || this.listeners.set(t, /* @__PURE__ */ new Set()), this.listeners.get(t).add(e), () => {
+      this.listeners.get(t)?.delete(e);
+    };
+  }
+  /**
+   * Emit an event to all subscribers
+   * @param event - The event type to emit
+   * @param data - The event data
+   */
+  emit(t, e) {
+    this.listeners.get(t)?.forEach((s) => {
+      try {
+        s(e);
+      } catch (o) {
+        console.error(`Error in event listener for "${t}":`, o);
+      }
+    });
+  }
+  /**
+   * Remove all listeners for a specific event, or all events if no event specified
+   * @param event - Optional event type to clear listeners for
+   */
+  off(t) {
+    t ? this.listeners.delete(t) : this.listeners.clear();
+  }
+  /**
+   * Get the number of listeners for a specific event
+   * @param event - The event type
+   * @returns Number of listeners
+   */
+  listenerCount(t) {
+    return this.listeners.get(t)?.size ?? 0;
+  }
+}
+function P(i) {
+  const t = [], e = [], s = [], o = i.trim().split(`
+`);
+  let h = 0;
+  for (const n of o) {
+    h++;
+    const r = n.trim();
+    if (!r || r.startsWith("#")) continue;
+    const a = r.match(/^(\w+)\s*:\s*\((-?\d+(?:\.\d+)?),\s*(-?\d+(?:\.\d+)?)\)\s*->\s*\((-?\d+(?:\.\d+)?),\s*(-?\d+(?:\.\d+)?)\)/);
+    if (a) {
+      t.push({
+        id: a[1],
+        start: [parseFloat(a[2]), parseFloat(a[3])],
+        end: [parseFloat(a[4]), parseFloat(a[5])]
+      });
+      continue;
+    }
+    const c = r.match(/^(\w+)(?:\s+(\d+(?:\.\d+)?)(%?))??\s*->\s*(\w+)(?:\s+(\d+(?:\.\d+)?)(%?))?/);
+    if (c) {
+      const l = {
+        from: c[1],
+        to: c[4]
+      };
+      if (c[2]) {
+        const f = parseFloat(c[2]);
+        l.fromPosition = (c[3] === "%", f / 100);
+      }
+      if (c[5]) {
+        const f = parseFloat(c[5]);
+        l.toPosition = (c[6] === "%", f / 100);
+      }
+      e.push(l);
+      continue;
+    }
+    r.match(/^\w+\s+start\s+/) || r.match(/^\w+\s+goto\s+/) || s.push(`Line ${h}: Unable to parse "${r}"`);
+  }
+  return {
+    data: {
+      lines: t,
+      connections: e.length > 0 ? e : void 0
+    },
+    errors: s
+  };
+}
+function v(i) {
+  const t = [], e = [], s = i.trim().split(`
+`);
+  let o = 0;
+  for (const h of s) {
+    o++;
+    const n = h.trim();
+    if (!n || n.startsWith("#")) continue;
+    const r = n.match(/^(\w+)\s+start\s+(\w+)\s+(\d+(?:\.\d+)?)(%?)/);
+    if (r) {
+      const a = parseFloat(r[3]), c = r[4] === "%";
+      t.push({
+        id: r[1],
+        lineId: r[2],
+        // API uses 0-1 for percentage, DSL uses 0-100
+        position: c ? a / 100 : a,
+        isPercentage: c
+      });
+      continue;
+    }
+    n.match(/^\w+\s*:\s*\(/) || n.match(/^\w+.*->\s*\w+/) || n.match(/^\w+\s+goto\s+/) || n.match(/^\w+\s+start/) && e.push(`Line ${o}: Invalid vehicle start format "${n}"`);
+  }
+  return {
+    data: t,
+    errors: e
+  };
+}
+function w(i) {
+  const t = [], e = [], s = i.trim().split(`
+`);
+  let o = 0;
+  for (const h of s) {
+    o++;
+    const n = h.trim();
+    if (!n || n.startsWith("#")) continue;
+    const r = n.match(/^(\w+)\s+goto\s+(\w+)\s+(\d+(?:\.\d+)?)(%?)/);
+    if (r) {
+      const a = n.slice(r[0].length), c = a.includes("--wait");
+      let l;
+      const f = a.match(/--payload\s+(\{.*\})/);
+      if (f)
+        try {
+          l = JSON.parse(f[1]);
+        } catch {
+          e.push(`Line ${o}: Invalid JSON payload "${f[1]}"`);
+        }
+      const d = parseFloat(r[3]), u = r[4] === "%";
+      t.push({
+        vehicleId: r[1],
+        targetLineId: r[2],
+        // API uses 0-1 for percentage, DSL uses 0-100
+        // For absolute offsets, keep the raw value
+        targetPosition: u ? d / 100 : d,
+        isPercentage: u,
+        wait: c || void 0,
+        payload: l
+      });
+      continue;
+    }
+    n.match(/^\w+\s*:\s*\(/) || n.match(/^\w+.*->\s*\w+/) || n.match(/^\w+\s+start\s+/) || n.match(/^\w+\s+goto/) && e.push(`Line ${o}: Invalid goto command format "${n}"`);
+  }
+  return {
+    data: t,
+    errors: e
+  };
+}
+function y(i) {
+  return {
+    scene: P(i),
+    vehicles: v(i),
+    movements: w(i)
+  };
+}
+function m(i) {
+  return Array.isArray(i) ? { x: i[0], y: i[1] } : i;
+}
+function M(i) {
+  const t = [];
+  for (const e of i.lines) {
+    const s = m(e.start), o = m(e.end);
+    t.push(`${e.id} : (${Math.round(s.x)}, ${Math.round(s.y)}) -> (${Math.round(o.x)}, ${Math.round(o.y)})`);
+  }
+  if (i.lines.length > 0 && i.connections && i.connections.length > 0 && t.push(""), i.connections)
+    for (const e of i.connections) {
+      let s = e.from;
+      e.fromPosition !== void 0 && (e.fromIsPercentage !== !1 ? s += ` ${e.fromPosition * 100}%` : s += ` ${e.fromPosition}`), s += " -> ", s += e.to, e.toPosition !== void 0 && (e.toIsPercentage !== !1 ? s += ` ${e.toPosition * 100}%` : s += ` ${e.toPosition}`), t.push(s);
+    }
+  return t.join(`
+`);
+}
+function x(i) {
+  return i.map((t) => {
+    const e = t.position ?? 0;
+    return t.isPercentage !== !1 ? `${t.id} start ${t.lineId} ${e * 100}%` : `${t.id} start ${t.lineId} ${e}`;
+  }).join(`
+`);
+}
+function V(i) {
+  return i.map((t) => {
+    const e = t.targetPosition ?? 1, s = t.isPercentage !== !1;
+    let o = t.vehicleId;
+    return o += ` goto ${t.targetLineId}`, s ? o += ` ${e * 100}%` : o += ` ${e}`, t.wait && (o += " --wait"), t.payload !== void 0 && (o += ` --payload ${JSON.stringify(t.payload)}`), o;
+  }).join(`
+`);
+}
+function N(i, t, e = 0) {
+  const s = [], o = [], h = /* @__PURE__ */ new Set();
+  for (const n of i) {
+    if (h.has(n.vehicleId)) {
+      o.push(`Duplicate vehicle ID: ${n.vehicleId}`);
+      continue;
+    }
+    h.add(n.vehicleId);
+    const r = t.find((p) => p.id === n.lineId);
+    if (!r) {
+      o.push(`Vehicle ${n.vehicleId}: Line "${n.lineId}" not found`);
+      continue;
+    }
+    const a = g(r.start, r.end), c = Math.max(0, a - e);
+    let l;
+    if (n.isPercentage) {
+      if (n.offset < 0 || n.offset > 100) {
+        o.push(`Vehicle ${n.vehicleId}: Offset ${n.offset}% must be between 0% and 100%`);
+        continue;
+      }
+      l = n.offset / 100 * c;
+    } else {
+      if (n.offset < 0 || n.offset > a) {
+        o.push(`Vehicle ${n.vehicleId}: Offset ${n.offset} exceeds line length ${a.toFixed(2)}`);
+        continue;
+      }
+      l = Math.min(n.offset, c);
+    }
+    const f = $(r, l, !1), d = {
+      lineId: n.lineId,
+      position: f,
+      absoluteOffset: l
+    }, u = I(
+      n.lineId,
+      l,
+      e,
+      r
+    );
+    s.push({
+      id: n.vehicleId,
+      lineId: n.lineId,
+      offset: n.offset,
+      isPercentage: n.isPercentage,
+      state: "idle",
+      rear: d,
+      front: u
+    });
+  }
+  return { vehicles: s, errors: o };
+}
+function b(i) {
+  const t = i.map((s) => {
+    const o = s.vehicleId.match(/^v(\d+)$/);
+    return o ? parseInt(o[1]) : 0;
+  }).filter((s) => s > 0);
+  return `v${(t.length > 0 ? Math.max(...t) : 0) + 1}`;
+}
+function F(i, t) {
+  if (t.length === 0) return null;
+  if (i.length === 0)
+    return t[0].id;
+  const e = /* @__PURE__ */ new Map();
+  for (const s of t)
+    e.set(s.id, 0);
+  for (const s of i) {
+    const o = e.get(s.vehicleId) || 0;
+    e.set(s.vehicleId, o + 1);
+  }
+  return t[0].id;
+}
+export {
+  S as V,
+  M as a,
+  x as b,
+  F as c,
+  b as d,
+  w as e,
+  P as f,
+  V as g,
+  v as h,
+  y as p,
+  N as v
+};

package/dist/vehicle-path.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./core.cjs"),i=require("./vehicle-helpers-DIcksrtO.cjs"),n=require("./animation-loop-fC2LjxCd.cjs"),t=require("./useVehicleEvents-CBymulau.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.normalize=e.normalize;exports.prepareCommandPath=e.prepareCommandPath;exports.resolveFromLineOffset=e.resolveFromLineOffset;exports.resolveToLineOffset=e.resolveToLineOffset;exports.updateAxlePosition=e.updateAxlePosition;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;

package/dist/vehicle-path.js

@@ -0,0 +1,62 @@
+import { arcLengthToSegmentPosition as i, buildArcLengthTable as a, buildGraph as n, calculateBezierArcLength as s, calculateFrontAxlePosition as o, calculateInitialFrontPosition as l, calculatePositionOnCurve as r, calculatePositionOnLine as c, createBezierCurve as u, createInitialMovementState as h, distance as m, distanceToT as v, findPath as g, getArcLength as L, getCumulativeArcLength as V, getLineLength as d, getPointOnBezier as f, getPointOnLine as S, getPointOnLineByOffset as p, getPositionFromOffset as A, handleArrival as P, initializeAllVehicles as x, initializeMovingVehicle as E, normalize as M, prepareCommandPath as O, resolveFromLineOffset as D, resolveToLineOffset as C, updateAxlePosition as z } from "./core.js";
+import { V as I, g as T, a as B, b as F, c as G, d as N, p as j, e as k, f as q, h as y, v as Q } from "./vehicle-helpers-_72KxCqO.js";
+import { c as H, u as J } from "./animation-loop-bZEm2pMN.js";
+import { V as R, a as U, u as W, b as X, c as Y, d as Z, d as _, e as $, f as ee, g as te, h as ie, i as ae, u as ne, j as se, k as oe } from "./useVehicleEvents-B2JQFNjc.js";
+export {
+  R as VehicleEventContext,
+  I as VehicleEventEmitter,
+  U as VehicleEventProvider,
+  i as arcLengthToSegmentPosition,
+  a as buildArcLengthTable,
+  n as buildGraph,
+  s as calculateBezierArcLength,
+  o as calculateFrontAxlePosition,
+  l as calculateInitialFrontPosition,
+  r as calculatePositionOnCurve,
+  c as calculatePositionOnLine,
+  H as createAnimationLoop,
+  u as createBezierCurve,
+  h as createInitialMovementState,
+  m as distance,
+  v as distanceToT,
+  g as findPath,
+  T as generateMovementDSL,
+  B as generateSceneDSL,
+  F as generateVehiclesDSL,
+  L as getArcLength,
+  V as getCumulativeArcLength,
+  d as getLineLength,
+  G as getNextGotoVehicleId,
+  N as getNextStartVehicleId,
+  f as getPointOnBezier,
+  S as getPointOnLine,
+  p as getPointOnLineByOffset,
+  A as getPositionFromOffset,
+  P as handleArrival,
+  x as initializeAllVehicles,
+  E as initializeMovingVehicle,
+  M as normalize,
+  j as parseAllDSL,
+  k as parseMovementDSL,
+  q as parseSceneDSL,
+  y as parseVehiclesDSL,
+  O as prepareCommandPath,
+  D as resolveFromLineOffset,
+  C as resolveToLineOffset,
+  z as updateAxlePosition,
+  W as useAnimation,
+  J as useAnimationLoop,
+  X as useCreateVehicleEventEmitter,
+  Y as useInitialMovement,
+  Z as useMovement,
+  _ as useMovementQueue,
+  $ as useMovementSequence,
+  ee as useScene,
+  te as useSceneDefinition,
+  ie as useVehicleEvent,
+  ae as useVehicleEventEmitter,
+  ne as useVehicleMovement,
+  se as useVehicleSimulation,
+  oe as useVehicles,
+  Q as validateAndCreateVehicles
+};

package/package.json

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