openskidata-format 5.3.0 → 5.5.0

package/dist/SlopeGradingScale.d.ts

@@ -1,4 +1,5 @@
-import { RunDifficulty, RunFeature } from "./Run";
+import { RunDifficulty, RunFeature, RunUse } from "./Run";
+import { RunDifficultyConvention } from "./RunDifficultyConvention";
 /**
  * Represents a slope grading scale with steepness thresholds for different run types.
  * Used to estimate run difficulty based on slope steepness. Each scale defines
@@ -30,3 +31,14 @@ export declare function getSlopeGradingScale(feature: RunFeature): SlopeGradingS
  * @returns The estimated difficulty based on steepness, or null if no match or below minimum threshold
  */
 export declare function getEstimatedRunDifficulty(steepness: number, scale: SlopeGradingScale): RunDifficulty | null;
+/**
+ * Gets the appropriate slope grading scale for a specific run use and region.
+ * Different run uses (downhill, nordic, etc.) have different steepness thresholds
+ * for difficulty classification. This function allows for regional variations
+ * in the future if different conventions use different slope scales.
+ *
+ * @param runUse - The type of run use to get the grading scale for
+ * @param convention - The regional difficulty convention (currently not used but available for future regional variations)
+ * @returns The appropriate slope grading scale with steepness thresholds
+ */
+export declare function getSlopeGradingScaleForUse(runUse: RunUse, convention: RunDifficultyConvention): SlopeGradingScale;

package/dist/SlopeGradingScale.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getSlopeGradingScale = getSlopeGradingScale;
 exports.getEstimatedRunDifficulty = getEstimatedRunDifficulty;
+exports.getSlopeGradingScaleForUse = getSlopeGradingScaleForUse;
 const Run_1 = require("./Run");
 /**
  * Gets the appropriate slope grading scale for a run based on its use types.
@@ -12,26 +13,13 @@ const Run_1 = require("./Run");
  * @returns The appropriate slope grading scale with steepness thresholds
  */
 function getSlopeGradingScale(feature) {
+    // Check for downhill or skitour uses first (they have the same scale)
     if (feature.properties.uses.includes(Run_1.RunUse.Downhill) ||
         feature.properties.uses.includes(Run_1.RunUse.Skitour)) {
-        return {
-            stops: [
-                { maxSteepness: 0.05, difficulty: null }, // No difficulty below 5%
-                { maxSteepness: 0.25, difficulty: Run_1.RunDifficulty.EASY },
-                { maxSteepness: 0.4, difficulty: Run_1.RunDifficulty.INTERMEDIATE },
-                { maxSteepness: 0.8, difficulty: Run_1.RunDifficulty.ADVANCED }, // Advanced up to 80%
-                { maxSteepness: 1.2, difficulty: Run_1.RunDifficulty.EXPERT }, // Expert up to 120%
-            ],
-        };
+        return getSlopeGradingScaleForUse(Run_1.RunUse.Downhill, feature.properties.difficultyConvention);
     }
     else if (feature.properties.uses.includes(Run_1.RunUse.Nordic)) {
-        return {
-            stops: [
-                { maxSteepness: 0.1, difficulty: Run_1.RunDifficulty.EASY },
-                { maxSteepness: 0.15, difficulty: Run_1.RunDifficulty.INTERMEDIATE },
-                { maxSteepness: 0.3, difficulty: Run_1.RunDifficulty.ADVANCED },
-            ],
-        };
+        return getSlopeGradingScaleForUse(Run_1.RunUse.Nordic, feature.properties.difficultyConvention);
     }
     else {
         return { stops: [] };
@@ -51,4 +39,42 @@ function getEstimatedRunDifficulty(steepness, scale) {
     return (scale.stops.find((stop) => stop.maxSteepness > absoluteSteepness)
         ?.difficulty || null);
 }
+/**
+ * Gets the appropriate slope grading scale for a specific run use and region.
+ * Different run uses (downhill, nordic, etc.) have different steepness thresholds
+ * for difficulty classification. This function allows for regional variations
+ * in the future if different conventions use different slope scales.
+ *
+ * @param runUse - The type of run use to get the grading scale for
+ * @param convention - The regional difficulty convention (currently not used but available for future regional variations)
+ * @returns The appropriate slope grading scale with steepness thresholds
+ */
+function getSlopeGradingScaleForUse(runUse, convention) {
+    // Currently convention is not used, but is available for future regional variations
+    switch (runUse) {
+        case Run_1.RunUse.Downhill:
+        case Run_1.RunUse.Skitour:
+            return {
+                stops: [
+                    { maxSteepness: 0.05, difficulty: null }, // No difficulty below 5%
+                    { maxSteepness: 0.25, difficulty: Run_1.RunDifficulty.EASY },
+                    { maxSteepness: 0.4, difficulty: Run_1.RunDifficulty.INTERMEDIATE },
+                    { maxSteepness: 0.8, difficulty: Run_1.RunDifficulty.ADVANCED }, // Advanced up to 80%
+                    { maxSteepness: 1.0, difficulty: Run_1.RunDifficulty.EXPERT }, // Expert up to 100%
+                    { maxSteepness: 1.2, difficulty: Run_1.RunDifficulty.FREERIDE }, // Freeride up to 120%
+                    { maxSteepness: Infinity, difficulty: Run_1.RunDifficulty.EXTREME }, // Extreme above 120%
+                ],
+            };
+        case Run_1.RunUse.Nordic:
+            return {
+                stops: [
+                    { maxSteepness: 0.1, difficulty: Run_1.RunDifficulty.EASY },
+                    { maxSteepness: 0.15, difficulty: Run_1.RunDifficulty.INTERMEDIATE },
+                    { maxSteepness: 0.3, difficulty: Run_1.RunDifficulty.ADVANCED },
+                ],
+            };
+        default:
+            return { stops: [] };
+    }
+}
 //# sourceMappingURL=SlopeGradingScale.js.map

package/dist/SlopeGradingScale.js.map

@@ -1 +1 @@
-{"version":3,"file":"SlopeGradingScale.js","sourceRoot":"","sources":["../src/SlopeGradingScale.ts"],"names":[],"mappings":";;AAoBA,oDAyBC;AAWD,8DASC;AAjED,+BAA0D;AAY1D;;;;;;;GAOG;AACH,SAAgB,oBAAoB,CAAC,OAAmB;IACtD,IACE,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAM,CAAC,QAAQ,CAAC;QACjD,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAM,CAAC,OAAO,CAAC,EAChD,CAAC;QACD,OAAO;YACL,KAAK,EAAE;gBACL,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,yBAAyB;gBACnE,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,mBAAa,CAAC,IAAI,EAAE;gBACtD,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,mBAAa,CAAC,YAAY,EAAE;gBAC7D,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,mBAAa,CAAC,QAAQ,EAAE,EAAE,qBAAqB;gBAChF,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,mBAAa,CAAC,MAAM,EAAE,EAAE,oBAAoB;aAC9E;SACF,CAAC;IACJ,CAAC;SAAM,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3D,OAAO;YACL,KAAK,EAAE;gBACL,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,mBAAa,CAAC,IAAI,EAAE;gBACrD,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,mBAAa,CAAC,YAAY,EAAE;gBAC9D,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,mBAAa,CAAC,QAAQ,EAAE;aAC1D;SACF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,yBAAyB,CACvC,SAAiB,EACjB,KAAwB;IAExB,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC9C,OAAO,CACL,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,GAAG,iBAAiB,CAAC;QAC/D,EAAE,UAAU,IAAI,IAAI,CACvB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"SlopeGradingScale.js","sourceRoot":"","sources":["../src/SlopeGradingScale.ts"],"names":[],"mappings":";;AAqBA,oDAYC;AAWD,8DASC;AAYD,gEA8BC;AA/FD,+BAA0D;AAa1D;;;;;;;GAOG;AACH,SAAgB,oBAAoB,CAAC,OAAmB;IACtD,sEAAsE;IACtE,IACE,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAM,CAAC,QAAQ,CAAC;QACjD,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAM,CAAC,OAAO,CAAC,EAChD,CAAC;QACD,OAAO,0BAA0B,CAAC,YAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC9F,CAAC;SAAM,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3D,OAAO,0BAA0B,CAAC,YAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC5F,CAAC;SAAM,CAAC;QACN,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,yBAAyB,CACvC,SAAiB,EACjB,KAAwB;IAExB,MAAM,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC9C,OAAO,CACL,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,GAAG,iBAAiB,CAAC;QAC/D,EAAE,UAAU,IAAI,IAAI,CACvB,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,0BAA0B,CACxC,MAAc,EACd,UAAmC;IAEnC,oFAAoF;IACpF,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,YAAM,CAAC,QAAQ,CAAC;QACrB,KAAK,YAAM,CAAC,OAAO;YACjB,OAAO;gBACL,KAAK,EAAE;oBACL,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,yBAAyB;oBACnE,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,mBAAa,CAAC,IAAI,EAAE;oBACtD,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,mBAAa,CAAC,YAAY,EAAE;oBAC7D,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,mBAAa,CAAC,QAAQ,EAAE,EAAE,qBAAqB;oBAChF,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,mBAAa,CAAC,MAAM,EAAE,EAAE,oBAAoB;oBAC7E,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,mBAAa,CAAC,QAAQ,EAAE,EAAE,sBAAsB;oBACjF,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,mBAAa,CAAC,OAAO,EAAE,EAAE,qBAAqB;iBACrF;aACF,CAAC;QACJ,KAAK,YAAM,CAAC,MAAM;YAClB,OAAO;gBACH,KAAK,EAAE;oBACL,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,mBAAa,CAAC,IAAI,EAAE;oBACrD,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,mBAAa,CAAC,YAAY,EAAE;oBAC9D,EAAE,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,mBAAa,CAAC,QAAQ,EAAE;iBAC1D;aACF,CAAC;QACJ;YACE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACzB,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openskidata-format",
-  "version": "5.3.0",
+  "version": "5.5.0",
   "description": "Data format for OpenSkiMap.org",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -39,7 +39,6 @@
     "@turf/helpers": "^7.2.0",
     "@turf/length": "^7.2.0",
     "@turf/line-chunk": "^7.2.0",
-    "@turf/meta": "^7.2.0",
     "tslib": "^2"
   }
 }

package/src/SlopeGradingScale.ts

@@ -1,4 +1,5 @@
 import { RunDifficulty, RunFeature, RunUse } from "./Run";
+import { RunDifficultyConvention } from "./RunDifficultyConvention";
 
 /**
  * Represents a slope grading scale with steepness thresholds for different run types.
@@ -19,27 +20,14 @@ export type SlopeGradingScale = {
  * @returns The appropriate slope grading scale with steepness thresholds
  */
 export function getSlopeGradingScale(feature: RunFeature): SlopeGradingScale {
+  // Check for downhill or skitour uses first (they have the same scale)
   if (
     feature.properties.uses.includes(RunUse.Downhill) ||
     feature.properties.uses.includes(RunUse.Skitour)
   ) {
-    return {
-      stops: [
-        { maxSteepness: 0.05, difficulty: null }, // No difficulty below 5%
-        { maxSteepness: 0.25, difficulty: RunDifficulty.EASY },
-        { maxSteepness: 0.4, difficulty: RunDifficulty.INTERMEDIATE },
-        { maxSteepness: 0.8, difficulty: RunDifficulty.ADVANCED }, // Advanced up to 80%
-        { maxSteepness: 1.2, difficulty: RunDifficulty.EXPERT }, // Expert up to 120%
-      ],
-    };
+    return getSlopeGradingScaleForUse(RunUse.Downhill, feature.properties.difficultyConvention);
   } else if (feature.properties.uses.includes(RunUse.Nordic)) {
-    return {
-      stops: [
-        { maxSteepness: 0.1, difficulty: RunDifficulty.EASY },
-        { maxSteepness: 0.15, difficulty: RunDifficulty.INTERMEDIATE },
-        { maxSteepness: 0.3, difficulty: RunDifficulty.ADVANCED },
-      ],
-    };
+    return getSlopeGradingScaleForUse(RunUse.Nordic, feature.properties.difficultyConvention);
   } else {
     return { stops: [] };
   }
@@ -63,4 +51,46 @@ export function getEstimatedRunDifficulty(
     scale.stops.find((stop) => stop.maxSteepness > absoluteSteepness)
       ?.difficulty || null
   );
+}
+
+/**
+ * Gets the appropriate slope grading scale for a specific run use and region.
+ * Different run uses (downhill, nordic, etc.) have different steepness thresholds
+ * for difficulty classification. This function allows for regional variations
+ * in the future if different conventions use different slope scales.
+ * 
+ * @param runUse - The type of run use to get the grading scale for
+ * @param convention - The regional difficulty convention (currently not used but available for future regional variations)
+ * @returns The appropriate slope grading scale with steepness thresholds
+ */
+export function getSlopeGradingScaleForUse(
+  runUse: RunUse,
+  convention: RunDifficultyConvention
+): SlopeGradingScale {
+  // Currently convention is not used, but is available for future regional variations
+  switch (runUse) {
+    case RunUse.Downhill:
+    case RunUse.Skitour:
+      return {
+        stops: [
+          { maxSteepness: 0.05, difficulty: null }, // No difficulty below 5%
+          { maxSteepness: 0.25, difficulty: RunDifficulty.EASY },
+          { maxSteepness: 0.4, difficulty: RunDifficulty.INTERMEDIATE },
+          { maxSteepness: 0.8, difficulty: RunDifficulty.ADVANCED }, // Advanced up to 80%
+          { maxSteepness: 1.0, difficulty: RunDifficulty.EXPERT }, // Expert up to 100%
+          { maxSteepness: 1.2, difficulty: RunDifficulty.FREERIDE }, // Freeride up to 120%
+          { maxSteepness: Infinity, difficulty: RunDifficulty.EXTREME }, // Extreme above 120%
+        ],
+      };
+    case RunUse.Nordic:
+    return {
+        stops: [
+          { maxSteepness: 0.1, difficulty: RunDifficulty.EASY },
+          { maxSteepness: 0.15, difficulty: RunDifficulty.INTERMEDIATE },
+          { maxSteepness: 0.3, difficulty: RunDifficulty.ADVANCED },
+        ],
+      };
+    default:
+      return { stops: [] };
+  }
 }