@inventure71/paddockjs 4.0.0 → 4.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inventure71/paddockjs",
-  "version": "4.0.0",
+  "version": "4.2.0",
   "type": "module",
   "description": "A data-driven browser F1 simulator component for host websites.",
   "license": "Apache-2.0",
@@ -24,7 +24,8 @@
     "ui-component"
   ],
   "sideEffects": [
-    "./src/styles.css"
+    "./src/styles.css",
+    "./src/placeholder.css"
   ],
   "publishConfig": {
     "access": "public"
@@ -50,7 +51,13 @@
       "import": "./src/data/index.js",
       "default": "./src/data/index.js"
     },
-    "./styles.css": "./src/styles.css"
+    "./placeholder": {
+      "types": "./src/placeholder/index.d.ts",
+      "import": "./src/placeholder/index.js",
+      "default": "./src/placeholder/index.js"
+    },
+    "./styles.css": "./src/styles.css",
+    "./placeholder.css": "./src/placeholder.css"
   },
   "files": [
     "CHANGELOG.md",
@@ -61,19 +68,19 @@
     "examples/python/README.md",
     "examples/python/base_policy_server.py",
     "examples/python/requirements.txt",
-    "examples/train-basic-policy.mjs",
-    "examples/trainingData.mjs",
     "src/api",
     "src/app",
     "src/config",
     "src/data",
     "src/environment",
+    "src/placeholder",
     "src/rendering",
     "src/simulation",
     "src/ui",
     "src/index.d.ts",
     "src/index.js",
     "src/styles.css",
+    "src/placeholder.css",
     "README.md"
   ],
   "scripts": {
@@ -81,10 +88,11 @@
     "test:fast": "node scripts/run-vitest.mjs",
     "types:check": "tsc -p tsconfig.types.json --noEmit",
     "docs:check": "node scripts/docs-check.mjs",
-    "check": "npm run docs:check && npm run test:fast && npm run types:check && npm run pack:dry && npm run consumer:smoke && npm run showcase:ci && npm run browser:smoke:quick -- --skip-build",
-    "check:release": "npm run docs:check && npm test && npm run types:check && npm run pack:dry && npm run consumer:smoke && npm run showcase:ci && npm run browser:smoke:full -- --skip-build",
+    "check": "npm run docs:check && npm run test:fast && npm run types:check && npm run pack:dry && npm run consumer:smoke && npm run consumer:bundle-boundaries && npm run showcase:ci && npm run browser:smoke:quick -- --skip-build",
+    "check:release": "npm run docs:check && npm test && npm run types:check && npm run pack:dry && npm run consumer:smoke && npm run consumer:bundle-boundaries && npm run showcase:ci && npm run browser:smoke:full -- --skip-build",
     "pack:dry": "npm pack --dry-run",
     "consumer:smoke": "node scripts/consumer-package-smoke.mjs",
+    "consumer:bundle-boundaries": "node scripts/consumer-bundle-boundaries.mjs",
     "browser:smoke": "node smoke/browser-smoke.mjs",
     "browser:smoke:quick": "node smoke/browser-smoke.mjs --quick",
     "browser:smoke:full": "node smoke/browser-smoke.mjs --full",
@@ -95,8 +103,7 @@
     "showcase:ci": "npm --prefix local-preview ci && npm --prefix local-preview run build",
     "changeset": "changeset",
     "version-packages": "changeset version",
-    "release": "npm publish --provenance",
-    "example:train": "node examples/train-basic-policy.mjs"
+    "release": "npm publish --provenance"
   },
   "dependencies": {
     "pixi.js": "8.18.1"

package/src/data/index.d.ts

@@ -38,6 +38,69 @@ export interface PaddockProceduralTrackOptions {
   };
 }
 
+export interface PaddockTrackPoint {
+  x: number;
+  y: number;
+}
+
+export interface PaddockDrsZone {
+  id: string;
+  startRatio: number;
+  endRatio: number;
+}
+
+export interface PaddockResolvedProceduralTrackOptions {
+  profile: PaddockProceduralTrackProfile;
+  length: {
+    min: number;
+    max: number;
+  };
+  startStraight: {
+    grid: number;
+    exit: number;
+    blend: number;
+    lockExtra: number;
+  };
+  pitLane: {
+    enabled: boolean;
+  };
+  shape: {
+    scale: number;
+    cornerDensity: number;
+    variation: number;
+  };
+  validation: {
+    minClearanceMultiplier: number;
+    minShapeVariation: number;
+    minNonAdjacentArcDistance: number;
+    maxLocalTurnRadians: number;
+    maxSampleHeadingDeltaRadians: number;
+  };
+  attempts: {
+    primary: number;
+    fallback: number;
+  };
+  cacheKey: string;
+  [key: string]: unknown;
+}
+
+export interface PaddockProceduralTrack {
+  name: string;
+  width: number;
+  kerbWidth: number;
+  gravelWidth: number;
+  runoffWidth: number;
+  barrierWidth: number;
+  sampleCount: number;
+  seed?: number;
+  curveInterpolation?: string;
+  centerlineControls?: readonly PaddockTrackPoint[];
+  drsZones?: readonly PaddockDrsZone[] | null;
+  pitLane?: { enabled?: boolean } | null;
+  generationOptions?: PaddockResolvedProceduralTrackOptions;
+  [key: string]: unknown;
+}
+
 export interface CustomField {
   label: string;
   value: string;
@@ -207,6 +270,6 @@ export function normalizeSimulatorDrivers(
   drivers: SimulatorDriver[],
   options?: { entries?: ChampionshipEntryBlueprint[]; caller?: string },
 ): NormalizedSimulatorDriver[];
-export function createProceduralTrack(seed?: number | string, options?: PaddockProceduralTrackOptions): unknown;
+export function createProceduralTrack(seed?: number | string, options?: PaddockProceduralTrackOptions): PaddockProceduralTrack;
 export function kphToSimSpeed(kph: number): number;
 export function simSpeedToKph(simSpeed: number): number;

package/src/environment/index.d.ts

@@ -39,6 +39,69 @@ export interface PaddockProceduralTrackOptions {
   };
 }
 
+export interface PaddockTrackPoint {
+  x: number;
+  y: number;
+}
+
+export interface PaddockDrsZone {
+  id: string;
+  startRatio: number;
+  endRatio: number;
+}
+
+export interface PaddockResolvedProceduralTrackOptions {
+  profile: PaddockProceduralTrackProfile;
+  length: {
+    min: number;
+    max: number;
+  };
+  startStraight: {
+    grid: number;
+    exit: number;
+    blend: number;
+    lockExtra: number;
+  };
+  pitLane: {
+    enabled: boolean;
+  };
+  shape: {
+    scale: number;
+    cornerDensity: number;
+    variation: number;
+  };
+  validation: {
+    minClearanceMultiplier: number;
+    minShapeVariation: number;
+    minNonAdjacentArcDistance: number;
+    maxLocalTurnRadians: number;
+    maxSampleHeadingDeltaRadians: number;
+  };
+  attempts: {
+    primary: number;
+    fallback: number;
+  };
+  cacheKey: string;
+  [key: string]: unknown;
+}
+
+export interface PaddockProceduralTrack {
+  name: string;
+  width: number;
+  kerbWidth: number;
+  gravelWidth: number;
+  runoffWidth: number;
+  barrierWidth: number;
+  sampleCount: number;
+  seed?: number;
+  curveInterpolation?: string;
+  centerlineControls?: readonly PaddockTrackPoint[];
+  drsZones?: readonly PaddockDrsZone[] | null;
+  pitLane?: { enabled?: boolean } | null;
+  generationOptions?: PaddockResolvedProceduralTrackOptions;
+  [key: string]: unknown;
+}
+
 export type PaddockStabilityState = 'stable' | 'understeer' | 'oversteer' | 'spin-risk' | 'destroyed';
 export type PaddockPitIntent = 0 | 1 | 2;
 export type PaddockScenarioPreset = 'cornering' | 'off-track-recovery' | 'overtaking-pack' | 'pit-entry';
@@ -674,8 +737,8 @@ export interface PaddockDriverControllerContext {
   controlledDrivers: string[];
   actionSpec: PaddockActionSpec;
   observationSpec: PaddockObservationSpec;
-  result: PaddockEnvironmentResult | unknown;
-  previousResult: PaddockEnvironmentResult | unknown | null;
+  result: PaddockEnvironmentResult;
+  previousResult: PaddockEnvironmentResult | null;
   observation: Record<string, PaddockDriverObservation>;
   orderedObservations: Array<{
     driverId: string;
@@ -685,7 +748,7 @@ export interface PaddockDriverControllerContext {
   }>;
   metrics: Record<string, PaddockEnvironmentDriverMetrics>;
   events: RaceEvent[];
-  info: PaddockEnvironmentResult['info'] | unknown | null;
+  info: PaddockEnvironmentResult['info'] | null;
   previousActions: PaddockActionMap;
   orderedPreviousActions: Array<PaddockAction | null>;
   actions: PaddockActionMap | null;
@@ -721,14 +784,14 @@ export interface PaddockDriverController {
 }
 
 export interface PaddockControllerRuntime {
-  reset(options?: unknown): PaddockEnvironmentResult | unknown;
-  step(actions: PaddockActionMap): PaddockEnvironmentResult | unknown;
+  reset(options?: unknown): PaddockEnvironmentResult;
+  step(actions: PaddockActionMap): PaddockEnvironmentResult;
   resetDrivers?(
     placements: Record<string, PaddockScenarioPlacement>,
     resultOptions?: PaddockEnvironmentResultOptions
-  ): PaddockEnvironmentResult | unknown;
+  ): PaddockEnvironmentResult;
   getObservation(): Record<string, PaddockDriverObservation>;
-  getState?(options?: { output?: 'full' | 'minimal' | 'none' }): PaddockEnvironmentResult['state'] | unknown;
+  getState?(options?: { output?: 'full' | 'minimal' | 'none' }): PaddockEnvironmentResult['state'];
   getActionSpec(): PaddockActionSpec;
   getObservationSpec(): PaddockObservationSpec;
   destroy?(): void;
@@ -743,7 +806,7 @@ export interface PaddockDriverControllerLoopOptions {
 }
 
 export interface PaddockDriverControllerLoop {
-  readonly result: PaddockEnvironmentResult | unknown | null;
+  readonly result: PaddockEnvironmentResult | null;
   readonly actionSpec: PaddockActionSpec | null;
   readonly observationSpec: PaddockObservationSpec | null;
   readonly stats: {
@@ -756,13 +819,13 @@ export interface PaddockDriverControllerLoop {
     running: boolean;
     lastError: unknown | null;
   };
-  reset(options?: unknown): Promise<PaddockEnvironmentResult | unknown>;
+  reset(options?: unknown): Promise<PaddockEnvironmentResult>;
   resetDrivers(
     placements: Record<string, PaddockScenarioPlacement>,
     resultOptions?: PaddockEnvironmentResultOptions
-  ): Promise<PaddockEnvironmentResult | unknown>;
-  step(): Promise<PaddockEnvironmentResult | unknown>;
-  stepFrame(): Promise<PaddockEnvironmentResult | unknown>;
+  ): Promise<PaddockEnvironmentResult>;
+  step(): Promise<PaddockEnvironmentResult>;
+  stepFrame(): Promise<PaddockEnvironmentResult>;
   start(): void;
   stop(): void;
 }

package/src/index.d.ts

@@ -2,6 +2,7 @@ import type {
   PaddockActionSpec,
   PaddockDriverControllerLoop,
   PaddockDriverControllerLoopOptions,
+  PaddockEnvironmentResult,
   PaddockEnvironmentOptions,
   PaddockObservationSpec,
   PaddockParticipantInteraction as EnvPaddockParticipantInteraction,
@@ -20,6 +21,8 @@ export type {
   PaddockDriverControllerContext,
   PaddockDriverControllerLoop,
   PaddockDriverControllerLoopOptions,
+  PaddockEnvironmentResult,
+  PaddockEnvironmentSnapshotResult,
   PaddockObservationSpec,
 } from './environment/index.js';
 
@@ -71,6 +74,69 @@ export interface PaddockProceduralTrackOptions {
   };
 }
 
+export interface PaddockTrackPoint {
+  x: number;
+  y: number;
+}
+
+export interface PaddockDrsZone {
+  id: string;
+  startRatio: number;
+  endRatio: number;
+}
+
+export interface PaddockResolvedProceduralTrackOptions {
+  profile: PaddockProceduralTrackProfile;
+  length: {
+    min: number;
+    max: number;
+  };
+  startStraight: {
+    grid: number;
+    exit: number;
+    blend: number;
+    lockExtra: number;
+  };
+  pitLane: {
+    enabled: boolean;
+  };
+  shape: {
+    scale: number;
+    cornerDensity: number;
+    variation: number;
+  };
+  validation: {
+    minClearanceMultiplier: number;
+    minShapeVariation: number;
+    minNonAdjacentArcDistance: number;
+    maxLocalTurnRadians: number;
+    maxSampleHeadingDeltaRadians: number;
+  };
+  attempts: {
+    primary: number;
+    fallback: number;
+  };
+  cacheKey: string;
+  [key: string]: unknown;
+}
+
+export interface PaddockProceduralTrack {
+  name: string;
+  width: number;
+  kerbWidth: number;
+  gravelWidth: number;
+  runoffWidth: number;
+  barrierWidth: number;
+  sampleCount: number;
+  seed?: number;
+  curveInterpolation?: string;
+  centerlineControls?: readonly PaddockTrackPoint[];
+  drsZones?: readonly PaddockDrsZone[] | null;
+  pitLane?: { enabled?: boolean } | null;
+  generationOptions?: PaddockResolvedProceduralTrackOptions;
+  [key: string]: unknown;
+}
+
 export type PaddockStabilityState = 'stable' | 'understeer' | 'oversteer' | 'spin-risk' | 'destroyed';
 export type PaddockPitIntent = 0 | 1 | 2;
 export type PaddockPitIntentRequest = PaddockPitIntent | {
@@ -959,14 +1025,14 @@ export interface PaddockEnvironmentResultOptions {
 }
 
 export interface F1SimulatorExpertApi {
-  reset(options?: unknown): unknown;
-  step(actions: Record<string, F1SimulatorExpertAction>): unknown;
+  reset(options?: unknown): PaddockEnvironmentResult;
+  step(actions: Record<string, F1SimulatorExpertAction>): PaddockEnvironmentResult;
   resetDrivers?(
     placements: Record<string, PaddockScenarioPlacement>,
     resultOptions?: PaddockEnvironmentResultOptions
-  ): unknown;
-  getObservation(): unknown;
-  getState(): unknown;
+  ): PaddockEnvironmentResult;
+  getObservation(): PaddockEnvironmentResult['observation'];
+  getState(): PaddockEnvironmentResult['state'];
   getActionSpec(): PaddockActionSpec;
   getObservationSpec(): PaddockObservationSpec;
   attachExternalRenderer(source: PaddockExternalRendererSource): void;
@@ -1133,7 +1199,7 @@ export function simSpeedToMetersPerSecond(simSpeed: number): number;
 
 export function createPaddockSimulator(options: F1SimulatorOptions): PaddockSimulatorController;
 export function mountF1Simulator(root: Element, options: F1SimulatorOptions): Promise<F1MountedSimulator>;
-export function createProceduralTrack(seed?: number | string, options?: PaddockProceduralTrackOptions): unknown;
+export function createProceduralTrack(seed?: number | string, options?: PaddockProceduralTrackOptions): PaddockProceduralTrack;
 export function createPaddockDriverControllerLoop(options: PaddockDriverControllerLoopOptions): PaddockDriverControllerLoop;
 
 export function mountRaceControls<T extends Element>(root: T, simulator: PaddockSimulatorController): T;

package/src/placeholder/index.d.ts

@@ -0,0 +1,11 @@
+export type PaddockLoadingPlaceholderVariant = 'lights' | 'custom';
+
+export interface PaddockLoadingPlaceholderOptions {
+  label?: string;
+  detail?: string;
+  className?: string;
+  variant?: PaddockLoadingPlaceholderVariant;
+  attributes?: Record<string, string | number | boolean | null | undefined>;
+}
+
+export function createPaddockLoadingPlaceholder(options?: PaddockLoadingPlaceholderOptions): string;

package/src/placeholder/index.js

@@ -0,0 +1,61 @@
+function escapeHtml(value) {
+  return String(value ?? '')
+    .replaceAll('&', '&')
+    .replaceAll('<', '&lt;')
+    .replaceAll('>', '&gt;')
+    .replaceAll('"', '&quot;')
+    .replaceAll("'", '&#39;');
+}
+
+function normalizeVariant(value) {
+  return value === 'custom' ? 'custom' : 'lights';
+}
+
+function renderAttributes(attributes = {}) {
+  if (!attributes || typeof attributes !== 'object') return '';
+  return Object.entries(attributes)
+    .filter(([name, value]) => (
+      value != null &&
+      value !== false &&
+      /^[a-zA-Z_][\w:.-]*$/.test(name) &&
+      !/^on/i.test(name)
+    ))
+    .map(([name, value]) => (value === true
+      ? ` ${escapeHtml(name)}`
+      : ` ${escapeHtml(name)}="${escapeHtml(value)}"`))
+    .join('');
+}
+
+export function createPaddockLoadingPlaceholder({
+  label = 'Loading simulator',
+  detail = '',
+  className = '',
+  variant = 'lights',
+  attributes,
+} = {}) {
+  const normalizedVariant = normalizeVariant(variant);
+  const extraClassName = className ? ` ${escapeHtml(className)}` : '';
+  const detailMarkup = detail
+    ? `<span class="paddock-placeholder__detail">${escapeHtml(detail)}</span>`
+    : '';
+  const lightsMarkup = normalizedVariant === 'lights'
+    ? `
+      <div class="paddock-placeholder__lights" aria-hidden="true">
+        <span></span>
+        <span></span>
+        <span></span>
+        <span></span>
+        <span></span>
+      </div>`
+    : '';
+
+  return `
+    <div class="paddock-placeholder${extraClassName}" data-paddock-placeholder data-paddock-placeholder-variant="${normalizedVariant}" role="status" aria-live="polite" aria-busy="true"${renderAttributes(attributes)}>
+      <div class="paddock-placeholder__content">
+        ${lightsMarkup}
+        <span class="paddock-placeholder__label">${escapeHtml(label)}</span>
+        ${detailMarkup}
+      </div>
+    </div>
+  `;
+}

package/src/placeholder.css

@@ -0,0 +1,72 @@
+.paddock-placeholder {
+  --paddock-placeholder-background: #000;
+  --paddock-placeholder-color: rgba(244, 241, 234, 0.78);
+  --paddock-placeholder-light: #ff1f18;
+  --paddock-placeholder-light-dim: #8f0804;
+  --paddock-placeholder-min-height: 420px;
+  position: relative;
+  display: grid;
+  min-height: var(--paddock-placeholder-min-height);
+  place-items: center;
+  overflow: hidden;
+  color: var(--paddock-placeholder-color);
+  background: var(--paddock-placeholder-background);
+}
+
+.paddock-placeholder__content {
+  display: grid;
+  justify-items: center;
+  gap: 0.8rem;
+  padding: 1.25rem;
+  text-align: center;
+}
+
+.paddock-placeholder__label {
+  font: 800 0.72rem/1.2 system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  letter-spacing: 0.14em;
+  text-transform: uppercase;
+}
+
+.paddock-placeholder__detail {
+  max-width: 32rem;
+  font: 500 0.82rem/1.4 system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  opacity: 0.72;
+}
+
+.paddock-placeholder__lights {
+  display: grid;
+  grid-template-columns: repeat(5, 0.78rem);
+  gap: 0.42rem;
+  padding: 0.32rem 0.46rem;
+  border-radius: 999px;
+  background: rgba(255, 255, 255, 0.08);
+}
+
+.paddock-placeholder__lights span {
+  width: 0.78rem;
+  height: 0.78rem;
+  border-radius: 50%;
+  background: var(--paddock-placeholder-light-dim);
+  box-shadow: 0 0 0 1px rgba(255, 255, 255, 0.08);
+  animation: paddock-placeholder-lights 1200ms cubic-bezier(0.45, 0, 0.2, 1) infinite;
+}
+
+.paddock-placeholder__lights span:nth-child(2) { animation-delay: 120ms; }
+.paddock-placeholder__lights span:nth-child(3) { animation-delay: 240ms; }
+.paddock-placeholder__lights span:nth-child(4) { animation-delay: 360ms; }
+.paddock-placeholder__lights span:nth-child(5) { animation-delay: 480ms; }
+
+.paddock-placeholder[data-paddock-placeholder-variant="custom"] .paddock-placeholder__content {
+  min-height: inherit;
+}
+
+@keyframes paddock-placeholder-lights {
+  0%, 100% {
+    background: var(--paddock-placeholder-light-dim);
+    box-shadow: 0 0 0 1px rgba(255, 255, 255, 0.08);
+  }
+  45%, 70% {
+    background: var(--paddock-placeholder-light);
+    box-shadow: 0 0 14px rgba(225, 6, 0, 0.56);
+  }
+}

package/src/simulation/collisionGeometry.js

@@ -1,7 +1,4 @@
-import {
-  getVehicleGeometryState,
-  vehicleAxes,
-} from './vehicle/vehicleGeometry.js';
+import { getVehicleGeometryState } from './vehicle/vehicleGeometry.js';
 import { normalizeAngle } from './simMath.js';
 
 const DEFAULT_SWEEP_STEPS = 16;
@@ -340,17 +337,18 @@ function writeInterpolatedBodyShape(target, geometryState, amount) {
   const x = pose.previousX + (pose.x - pose.previousX) * amount;
   const y = pose.previousY + (pose.y - pose.previousY) * amount;
   const heading = normalizeAngle(pose.previousHeading + headingDelta * amount);
-  const axes = vehicleAxes(heading);
+  const cos = Math.cos(heading);
+  const sin = Math.sin(heading);
   const halfLength = target.halfLength;
   const halfWidth = target.halfWidth;
 
   target.center.x = x;
   target.center.y = y;
   target.heading = heading;
-  target.forward.x = axes.forward.x;
-  target.forward.y = axes.forward.y;
-  target.right.x = axes.right.x;
-  target.right.y = axes.right.y;
+  target.forward.x = cos;
+  target.forward.y = sin;
+  target.right.x = -sin;
+  target.right.y = cos;
 
   writeOffsetCorner(target.corners[0], target.center, target.forward, target.right, halfLength, halfWidth);
   writeOffsetCorner(target.corners[1], target.center, target.forward, target.right, halfLength, -halfWidth);

package/src/simulation/driver/driverController.js

@@ -4,7 +4,7 @@ import { decideRacingControls } from './racingControls.js';
 import { decideRejoinControls } from './rejoinControls.js';
 import { shouldContinueRejoinRecovery } from './edgeRecovery.js';
 import { decideSafetyCarControls } from './safetyCarControls.js';
-import { VEHICLE_LIMITS } from '../vehicle/vehiclePhysics.js';
+import { VEHICLE_LIMITS, isSimulatorPhysicsMode } from '../vehicle/vehiclePhysics.js';
 
 export function decideDriverControls({ car, orderIndex, race }) {
   if (car.manualControls) return car.manualControls;
@@ -37,7 +37,7 @@ export function decideDriverControls({ car, orderIndex, race }) {
 }
 
 function shouldStabilizeSimulatorCar(car, race) {
-  if (race.physicsMode !== 'advanced') return false;
+  if (!isSimulatorPhysicsMode(race.physicsMode)) return false;
   const gripUsage = car.gripUsage ?? 0;
   const slipAngle = Math.abs(car.slipAngleRadians ?? 0);
   const edgeDistance = race.track.width / 2 - VEHICLE_LIMITS.carWidth * 2.25;

package/src/simulation/driver/edgeRecovery.js

@@ -1,11 +1,11 @@
 import { clamp, normalizeAngle } from '../simMath.js';
 import { metersToSimUnits } from '../units.js';
 import { pointAt } from '../track/trackModel.js';
-import { VEHICLE_LIMITS } from '../vehicle/vehiclePhysics.js';
+import { VEHICLE_LIMITS, isSimulatorPhysicsMode } from '../vehicle/vehiclePhysics.js';
 import { REJOIN_LOOKAHEAD_BASE, REJOIN_LOOKAHEAD_MAX } from './driverControlConstants.js';
 
 export function calculateTrackEdgeGuard(car, race) {
-  const simulatorMode = race.physicsMode === 'advanced';
+  const simulatorMode = isSimulatorPhysicsMode(race.physicsMode);
   const trackLimit = race.track.width / 2;
   const halfCarWidth = VEHICLE_LIMITS.carWidth / 2;
   const wholeCarOutsideLimit = trackLimit + halfCarWidth;