onroute-policy-engine 2.12.1 → 2.14.0

package/dist/helper/policy-check.helper.d.ts

@@ -58,9 +58,9 @@ export declare function CheckBridgeFormula(policy: Policy, _vehicleConfiguration
  * Validates the number of tires per axle unit against regulatory requirements.
  *
  * This function checks that each axle unit has a valid number of tires based on
- * the number of axles in that unit. The validation allows for 2, 4, or 8 tires
- * per axle (2, 4, or 8 * number of axles). This ensures compliance with tire
- * count regulations for commercial vehicles.
+ * the number of axles in that unit and the axle unit position. Axle unit 1 is
+ * the steer axle unit, axle unit 2 is the drive axle unit, and axle units 3+
+ * use the generic axle unit allowance.
  *
  * @param _policy - The policy instance (unused in this check, but required by PolicyCheck type)
  * @param _vehicleConfiguration - Vehicle configuration (unused in this check, but required by PolicyCheck type)
@@ -70,15 +70,15 @@ export declare function CheckBridgeFormula(policy: Policy, _vehicleConfiguration
  * @example
  * // For a vehicle with 2 axle units
  * const results = CheckNumTiresPerAxle(policy, ['TRKTRAC'], [
- *   { numberOfAxles: 2, numberOfTires: 4 },  // 2 axles × 2 tires = 4 (valid)
- *   { numberOfAxles: 3, numberOfTires: 12 }  // 3 axles × 4 tires = 12 (valid)
+ *   { numberOfAxles: 2, numberOfTires: 4 },  // tandem steer: 4 (valid)
+ *   { numberOfAxles: 3, numberOfTires: 12 }  // tridem drive: 12 (valid)
  * ]);
  * // Returns pass results for both axle units
  *
  * @example
  * // Invalid tire count example
  * const results = CheckNumTiresPerAxle(policy, ['TRKTRAC'], [
- *   { numberOfAxles: 2, numberOfTires: 6 }  // 2 axles × 3 tires = 6 (invalid - not 2, 4, or 8 per axle)
+ *   { numberOfAxles: 1, numberOfTires: 8 }  // single drive: 8 (invalid)
  * ]);
  * // Returns fail result for the axle unit
  *
@@ -235,7 +235,7 @@ export declare function CheckMinDriveAxleWeight(_policy: Policy, _vehicleConfigu
  * @see AxleGroupPolicyCheckResult
  * @see AxleConfiguration
  */
-export declare function CheckMaxTireLoad(_policy: Policy, _vehicleConfiguration: Array<string>, axleConfiguration: Array<AxleConfiguration>): Array<PolicyCheckResult>;
+export declare function CheckMaxTireLoad(_policy: Policy, _vehicleConfiguration: string[], axleConfiguration: AxleConfiguration[]): PolicyCheckResult[];
 /**
  * Validates that each booster has no more axles than the trailer it follows.
  *

package/dist/helper/policy-check.helper.js

@@ -100,9 +100,9 @@ function CheckBridgeFormula(policy, _vehicleConfiguration, axleConfiguration) {
  * Validates the number of tires per axle unit against regulatory requirements.
  *
  * This function checks that each axle unit has a valid number of tires based on
- * the number of axles in that unit. The validation allows for 2, 4, or 8 tires
- * per axle (2, 4, or 8 * number of axles). This ensures compliance with tire
- * count regulations for commercial vehicles.
+ * the number of axles in that unit and the axle unit position. Axle unit 1 is
+ * the steer axle unit, axle unit 2 is the drive axle unit, and axle units 3+
+ * use the generic axle unit allowance.
  *
  * @param _policy - The policy instance (unused in this check, but required by PolicyCheck type)
  * @param _vehicleConfiguration - Vehicle configuration (unused in this check, but required by PolicyCheck type)
@@ -112,15 +112,15 @@ function CheckBridgeFormula(policy, _vehicleConfiguration, axleConfiguration) {
  * @example
  * // For a vehicle with 2 axle units
  * const results = CheckNumTiresPerAxle(policy, ['TRKTRAC'], [
- *   { numberOfAxles: 2, numberOfTires: 4 },  // 2 axles × 2 tires = 4 (valid)
- *   { numberOfAxles: 3, numberOfTires: 12 }  // 3 axles × 4 tires = 12 (valid)
+ *   { numberOfAxles: 2, numberOfTires: 4 },  // tandem steer: 4 (valid)
+ *   { numberOfAxles: 3, numberOfTires: 12 }  // tridem drive: 12 (valid)
  * ]);
  * // Returns pass results for both axle units
  *
  * @example
  * // Invalid tire count example
  * const results = CheckNumTiresPerAxle(policy, ['TRKTRAC'], [
- *   { numberOfAxles: 2, numberOfTires: 6 }  // 2 axles × 3 tires = 6 (invalid - not 2, 4, or 8 per axle)
+ *   { numberOfAxles: 1, numberOfTires: 8 }  // single drive: 8 (invalid)
  * ]);
  * // Returns fail result for the axle unit
  *
@@ -143,7 +143,10 @@ function CheckNumTiresPerAxle(_policy, _vehicleConfiguration, axleConfiguration)
             message = `Number of axles for axle unit ${axleNum} is not permittable.`;
         }
         else {
-            const checkResult = [numAxles * 2, numAxles * 4, numAxles * 8].includes(numTires);
+            const multipliers = axleNum === 1 ? [2] : axleNum === 2 ? [2, 4] : [2, 4, 8];
+            const checkResult = multipliers
+                .map((multiplier) => numAxles * multiplier)
+                .includes(numTires);
             message = checkResult
                 ? `No. of Wheels for Axle Unit ${axleNum} is permittable.`
                 : `No. of Wheels for Axle Unit ${axleNum} is not permittable.`;
@@ -449,85 +452,137 @@ function CheckMinDriveAxleWeight(_policy, _vehicleConfiguration, axleConfigurati
 function CheckMaxTireLoad(_policy, _vehicleConfiguration, axleConfiguration) {
     const policyCheckResults = new Array();
     const policyId = enum_1.PolicyCheckId.MaxTireLoad;
-    // Steer axle tire load check
-    const steerTireSize = axleConfiguration[0].tireSize;
-    if (!steerTireSize) {
+    const powerUnitType = _vehicleConfiguration[0];
+    const isRubberTiredLoader = powerUnitType === 'RBTRLDR';
+    const isAllTerrainCrane = powerUnitType === 'CRANEAT';
+    const isMobileCrane = powerUnitType === 'CRANEMB';
+    const addFailResult = (axleUnit) => {
         policyCheckResults.push({
             id: policyId,
             result: enum_1.PolicyCheckResultType.Fail,
-            message: `Steer axle tire size is invalid`,
-            axleUnit: 1,
+            message: `Tire Size for Axle Unit ${axleUnit} exceeds its load capacity.`,
+            axleUnit,
         });
-    }
-    else if (steerTireSize > 455) {
-        policyCheckResults.push({
-            id: policyId,
-            result: enum_1.PolicyCheckResultType.Fail,
-            message: `Steer axle tire size must not exceed 455mm`,
-            axleUnit: 1,
-        });
-    }
-    else if (steerTireSize >= 445) {
-        if (axleConfiguration[0].axleUnitWeight > 9100) {
-            policyCheckResults.push({
-                id: policyId,
-                result: enum_1.PolicyCheckResultType.Fail,
-                message: `Steer axle weight exceeds maximum of 9100kg for ${steerTireSize}mm tire size`,
-                axleUnit: 1,
-            });
-        }
-    }
-    else {
-        const maxWeightOnSteerAxle = (axleConfiguration[0].numberOfTires || 0) * (steerTireSize * 10);
-        if (axleConfiguration[0].axleUnitWeight > maxWeightOnSteerAxle) {
-            policyCheckResults.push({
-                id: policyId,
-                result: enum_1.PolicyCheckResultType.Fail,
-                message: `Steer axle weight exceeds maximum of ${maxWeightOnSteerAxle}kg for ${steerTireSize}mm tire size`,
-                axleUnit: 1,
-            });
-        }
-    }
-    // Non-steer axle tire load checks
-    axleConfiguration.slice(1).forEach((a, i) => {
-        const tireSize = a.tireSize;
-        const numberOfTires = a.numberOfTires;
-        const axleUnitNum = i + 2;
-        let maxWeight = 0;
+    };
+    /**
+     * Both the kg/cm rate and the explicit axle cap apply for all axle types.
+     * The lower of the two is the binding limit:
+     *   maxAllowedWeight = min((tireSize / 10) * rateKgPerCm * numberOfTires, capWeight)
+     *
+     * When capWeight is omitted, only the rate applies.
+     */
+    const exceedsRateOrCapLimit = (axleWeight, tireSize, numberOfTires, rateKgPerCm, capWeight) => {
+        const rateLimitWeight = (tireSize / 10) * rateKgPerCm * numberOfTires;
+        const maxAllowedWeight = capWeight !== undefined
+            ? Math.min(rateLimitWeight, capWeight)
+            : rateLimitWeight;
+        return axleWeight > maxAllowedWeight;
+    };
+    axleConfiguration.forEach((ac, index) => {
+        var _a, _b;
+        const axleUnit = index + 1;
+        const tireSize = ac.tireSize;
+        const numberOfTires = (_a = ac.numberOfTires) !== null && _a !== void 0 ? _a : 0;
+        const axleWeight = (_b = ac.axleUnitWeight) !== null && _b !== void 0 ? _b : 0;
         if (!tireSize) {
-            policyCheckResults.push({
-                id: policyId,
-                result: enum_1.PolicyCheckResultType.Fail,
-                message: `Axle unit ${axleUnitNum} tire size is invalid`,
-                axleUnit: axleUnitNum,
-            });
+            addFailResult(axleUnit);
+            return;
         }
-        else if (!numberOfTires) {
-            policyCheckResults.push({
-                id: policyId,
-                result: enum_1.PolicyCheckResultType.Fail,
-                message: `Axle unit ${axleUnitNum} number of wheels is invalid`,
-                axleUnit: axleUnitNum,
-            });
+        if (!numberOfTires) {
+            addFailResult(axleUnit);
+            return;
         }
-        else {
-            if (tireSize >= 445) {
-                maxWeight = numberOfTires * 3850;
+        const isSteeringAxle = index === 0;
+        /**
+         * Rubber Tired Loader
+         *
+         * All axle units — rate 110 kg/cm; lower of rate or cap is binding:
+         *   >=600 mm => min(110 kg/cm rate, 12,000 kg/axle)
+         *   >=520 mm => min(110 kg/cm rate, 11,000 kg/axle)
+         *
+         * For RTL the 110 kg/cm rate always yields more than the cap at these
+         * tire sizes (e.g. 520mm * 110 * 2 = 11,440 > 11,000), so the cap
+         * will always be the binding constraint in practice.
+         */
+        if (isRubberTiredLoader) {
+            if (tireSize >= 600) {
+                if (exceedsRateOrCapLimit(axleWeight, tireSize, numberOfTires, 110, 12000)) {
+                    addFailResult(axleUnit);
+                }
             }
-            else if (tireSize > 300) {
-                maxWeight = numberOfTires * 3000;
+            else if (tireSize >= 520) {
+                if (exceedsRateOrCapLimit(axleWeight, tireSize, numberOfTires, 110, 11000)) {
+                    addFailResult(axleUnit);
+                }
             }
-            else {
-                maxWeight = numberOfTires * tireSize * 10;
+            return;
+        }
+        /**
+         * Crane - All Terrain
+         *
+         * All axle units — rate 100 kg/cm; lower of rate or cap is binding:
+         *   >=520 mm => min(100 kg/cm rate, 11,000 kg/axle)
+         *
+         * For tires where the rate yields less than the cap
+         * (e.g. 520mm * 100 * 2 = 10,400 < 11,000), the rate is binding.
+         * For tires where the rate yields more than the cap
+         * (e.g. 609mm * 100 * 2 = 12,180 > 11,000), the cap is binding.
+         */
+        if (isAllTerrainCrane) {
+            if (tireSize >= 520) {
+                if (exceedsRateOrCapLimit(axleWeight, tireSize, numberOfTires, 100, 11000)) {
+                    addFailResult(axleUnit);
+                }
             }
-            if (a.axleUnitWeight > maxWeight) {
-                policyCheckResults.push({
-                    id: policyId,
-                    result: enum_1.PolicyCheckResultType.Fail,
-                    message: `Axle unit ${axleUnitNum} weight exceeds maximum of ${maxWeight}kg for ${numberOfTires} ${tireSize}mm tires`,
-                    axleUnit: axleUnitNum,
-                });
+            return;
+        }
+        /**
+         * Mobile Crane
+         *
+         * Non-steering axle units only — rate 100 kg/cm; lower of rate or cap is binding:
+         *   >=520 mm => min(100 kg/cm rate, 11,000 kg/axle)
+         *
+         * Same rate/cap interaction as Crane - All Terrain above.
+         * Steering axle falls through to the standard steer axle rules below.
+         */
+        if (isMobileCrane && !isSteeringAxle) {
+            if (tireSize >= 520) {
+                if (exceedsRateOrCapLimit(axleWeight, tireSize, numberOfTires, 100, 11000)) {
+                    addFailResult(axleUnit);
+                }
             }
+            return;
+        }
+        /**
+         * Steer axle — all vehicles except Crane - All Terrain, Mobile Crane
+         * (steering), Rubber Tired Loader
+         *
+         * Rate 100 kg/cm; lower of rate or cap is binding:
+         *   <445 mm  => rate only (no cap)
+         *   >=445 mm => min(100 kg/cm rate, 9,100 kg/axle)
+         *
+         * e.g. 445mm * 2 tires => min(8,900, 9,100) = 8,900 kg  <- rate binding
+         * e.g. 457mm * 2 tires => min(9,140, 9,100) = 9,100 kg  <- cap  binding
+         */
+        if (isSteeringAxle) {
+            const capWeight = tireSize >= 445 ? 9100 : undefined;
+            if (exceedsRateOrCapLimit(axleWeight, tireSize, numberOfTires, 100, capWeight)) {
+                addFailResult(axleUnit);
+            }
+            return;
+        }
+        /**
+         * Standard non-steering axle — all vehicles except Crane - All Terrain,
+         * Mobile Crane (non-steering), Rubber Tired Loader
+         *
+         * Rate 100 kg/cm; lower of rate or per-tire cap is binding:
+         *   >=445 mm => min(100 kg/cm rate, 4,550 kg/tire * numberOfTires)
+         *   <=444 mm => min(100 kg/cm rate, 3,000 kg/tire * numberOfTires)
+         */
+        const perTireCap = tireSize >= 445 ? 4550 : 3000;
+        const axleCap = perTireCap * numberOfTires;
+        if (exceedsRateOrCapLimit(axleWeight, tireSize, numberOfTires, 100, axleCap)) {
+            addFailResult(axleUnit);
         }
     });
     if (policyCheckResults.length === 0) {

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const version = "v2.12.1";
+export declare const version = "v2.14.0";

package/dist/version.js

@@ -2,4 +2,4 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.version = void 0;
 // Generated by genversion.
-exports.version = 'v2.12.1';
+exports.version = 'v2.14.0';

package/package.json

@@ -91,5 +91,5 @@
     ],
     "testEnvironment": "node"
   },
-  "version": "v2.12.1"
+  "version": "v2.14.0"
 }