openskidata-format 11.1.0 → 12.1.0

package/dist/Lift.d.ts

@@ -5,6 +5,7 @@ import { SkiAreaSummaryFeature } from './SkiArea';
 import { Source } from './Source';
 import { LiftStationSpotFeature } from './Spot';
 import { Status } from './Status';
+import { ViewportHint } from './ViewportHint';
 export type LiftFeature = GeoJSON.Feature<LiftGeometry, LiftProperties>;
 export type LiftGeometry = GeoJSON.LineString | GeoJSON.MultiLineString;
 /**
@@ -72,6 +73,7 @@ export type LiftProperties = {
     websites: string[];
     wikidataID: string | null;
     places: Place[];
+    viewportHint: ViewportHint;
 };
 export declare enum LiftType {
     CableCar = "cable_car",

package/dist/Lift.js

@@ -96,17 +96,17 @@ function getFormattedLiftType(liftType) {
     }
 }
 function getLiftColor(status) {
-    const BRIGHT_RED_COLOR = 'hsl(0, 82%, 42%)';
-    const DIM_RED_COLOR = 'hsl(0, 53%, 42%)';
+    const brightRedColor = 'hsl(0, 82%, 42%)';
+    const dimRedColor = 'hsl(0, 53%, 42%)';
     switch (status) {
         case Status_1.Status.Disused:
         case Status_1.Status.Abandoned:
-            return DIM_RED_COLOR;
+            return dimRedColor;
         case Status_1.Status.Proposed:
         case Status_1.Status.Planned:
         case Status_1.Status.Construction:
         case Status_1.Status.Operating:
-            return BRIGHT_RED_COLOR;
+            return brightRedColor;
         default:
             return (0, exhaustiveMatchingGuard_1.exhaustiveMatchingGuard)(status);
     }

package/dist/Lift.js.map

@@ -1 +1 @@
-{"version":3,"file":"Lift.js","sourceRoot":"","sources":["../src/Lift.ts"],"names":[],"mappings":";;;AAsGA,oDA8BC;AAqCD,oDA6BC;AAED,oCAgBC;;AAxND,sEAAqC;AACrC,yDAAoE;AAKpE,iCAAoE;AACpE,qCAAiC;AACjC,4EAAwE;AA0ExE,IAAY,QAaX;AAbD,WAAY,QAAQ;IAClB,kCAAsB,CAAA;IACtB,+BAAmB,CAAA;IACnB,oCAAwB,CAAA;IACxB,oCAAwB,CAAA;IACxB,kCAAsB,CAAA;IACtB,0BAAc,CAAA;IACd,0BAAc,CAAA;IACd,+BAAmB,CAAA;IACnB,gCAAoB,CAAA;IACpB,wCAA4B,CAAA;IAC5B,mCAAuB,CAAA;IACvB,+BAAmB,CAAA;AACrB,CAAC,EAbW,QAAQ,wBAAR,QAAQ,QAanB;AAOD,SAAgB,oBAAoB,CAClC,OAAoB;IAEpB,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;IACjC,IACE,CAAC,QAAQ;QACT,QAAQ,CAAC,IAAI,KAAK,YAAY;QAC9B,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,EAClC,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,aAAa,GAAG,IAAA,mCAAgB,EAAC,QAAQ,CAAC,CAAA;IAChD,MAAM,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAA;IACrD,MAAM,iBAAiB,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAA;IAC9D,MAAM,cAAc,GAClB,iBAAiB,EAAE,sBAAsB;QACzC,aAAa,CAAC,sBAAsB,CAAA;IACtC,MAAM,cAAc,GAClB,iBAAiB,EAAE,gBAAgB,IAAI,aAAa,CAAC,gBAAgB,CAAA;IAEvE,OAAO;QACL,GAAG,aAAa;QAChB,sBAAsB,EAAE,iBAAiB;YACvC,CAAC,CAAC,cAAc,GAAG,iBAAiB;YACpC,CAAC,CAAC,IAAI;QACR,8BAA8B,EAAE,iBAAiB;YAC/C,CAAC,CAAC,cAAc,GAAG,iBAAiB;YACpC,CAAC,CAAC,IAAI;KACT,CAAA;AACH,CAAC;AAED,SAAS,2BAA2B,CAClC,OAAoB;IAEpB,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAA;IAC5C,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,KAAK,0BAAmB,CAAC,GAAG,CACzD,CAAA;IACD,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CACjC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,KAAK,0BAAmB,CAAC,MAAM,CAC5D,CAAA;IAED,IAAI,CAAC,UAAU,IAAI,CAAC,aAAa,EAAE,CAAC;QAClC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAA;IACjD,MAAM,YAAY,GAAG,aAAa,CAAC,QAAQ,CAAC,WAAW,CAAA;IAEvD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,MAAM,0BAA0B,GAAG,IAAA,kBAAQ,EACzC,UAAU,CAAC,QAAQ,EACnB,aAAa,CAAC,QAAQ,EACtB,EAAE,KAAK,EAAE,QAAQ,EAAE,CACpB,CAAA;IACD,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;IACjE,MAAM,sBAAsB,GAAG,IAAI,CAAC,IAAI,CACtC,IAAI,CAAC,GAAG,CAAC,0BAA0B,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC,CAAC,CACxE,CAAA;IAED,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,CAAA;AACrD,CAAC;AAED,SAAgB,oBAAoB,CAAC,QAAkB;IACrD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ,CAAC,QAAQ;YACpB,OAAO,WAAW,CAAA;QACpB,KAAK,QAAQ,CAAC,OAAO;YACnB,OAAO,SAAS,CAAA;QAClB,KAAK,QAAQ,CAAC,SAAS;YACrB,OAAO,WAAW,CAAA;QACpB,KAAK,QAAQ,CAAC,SAAS;YACrB,OAAO,QAAQ,CAAA;QACjB,KAAK,QAAQ,CAAC,QAAQ;YACpB,OAAO,WAAW,CAAA;QACpB,KAAK,QAAQ,CAAC,IAAI;YAChB,OAAO,OAAO,CAAA;QAChB,KAAK,QAAQ,CAAC,IAAI;YAChB,OAAO,OAAO,CAAA;QAChB,KAAK,QAAQ,CAAC,OAAO;YACnB,OAAO,SAAS,CAAA;QAClB,KAAK,QAAQ,CAAC,OAAO;YACnB,OAAO,SAAS,CAAA;QAClB,KAAK,QAAQ,CAAC,WAAW;YACvB,OAAO,cAAc,CAAA;QACvB,KAAK,QAAQ,CAAC,SAAS;YACrB,OAAO,WAAW,CAAA;QACpB,KAAK,QAAQ,CAAC,OAAO;YACnB,OAAO,SAAS,CAAA;QAClB;YACE,OAAO,IAAA,iDAAuB,EAAC,QAAQ,CAAC,CAAA;IAC5C,CAAC;AACH,CAAC;AAED,SAAgB,YAAY,CAAC,MAAc;IACzC,MAAM,gBAAgB,GAAG,kBAAkB,CAAA;IAC3C,MAAM,aAAa,GAAG,kBAAkB,CAAA;IAExC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,eAAM,CAAC,OAAO,CAAC;QACpB,KAAK,eAAM,CAAC,SAAS;YACnB,OAAO,aAAa,CAAA;QACtB,KAAK,eAAM,CAAC,QAAQ,CAAC;QACrB,KAAK,eAAM,CAAC,OAAO,CAAC;QACpB,KAAK,eAAM,CAAC,YAAY,CAAC;QACzB,KAAK,eAAM,CAAC,SAAS;YACnB,OAAO,gBAAgB,CAAA;QACzB;YACE,OAAO,IAAA,iDAAuB,EAAC,MAAM,CAAC,CAAA;IAC1C,CAAC;AACH,CAAC"}
+{"version":3,"file":"Lift.js","sourceRoot":"","sources":["../src/Lift.ts"],"names":[],"mappings":"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"}

package/dist/Run.d.ts

@@ -7,6 +7,7 @@ import { SkiAreaSummaryFeature } from './SkiArea';
 import { SnowCoverHistory } from './SnowCoverHistory';
 import { Source } from './Source';
 import { Status } from './Status';
+import { ViewportHint } from './ViewportHint';
 export type RunGeometry = GeoJSON.LineString | GeoJSON.Polygon;
 /**
  * Represents a segment of a ski run/trail.
@@ -79,6 +80,7 @@ export type RunProperties = {
     wikidataID: string | null;
     places: Place[];
     snowCoverHistory?: SnowCoverHistory;
+    viewportHint: ViewportHint;
 };
 export declare enum RunUse {
     Downhill = "downhill",

package/dist/Run.js.map

@@ -1 +1 @@
-{"version":3,"file":"Run.js","sourceRoot":"","sources":["../src/Run.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Run.js","sourceRoot":"","sources":["../src/Run.ts"],"names":[],"mappings":"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"}

package/dist/SkiArea.d.ts

@@ -6,6 +6,7 @@ import { RunDifficultyConvention } from './RunDifficultyConvention';
 import { SnowCoverHistory } from './SnowCoverHistory';
 import { Source } from './Source';
 import { Status } from './Status';
+import { ViewportHint } from './ViewportHint';
 /**
  * A ski area feature is derived from several sources:
  * - OpenStreetMap site=piste relations (must contain at least one lift or run of any kind)
@@ -48,6 +49,7 @@ export type SkiAreaProperties = SkiAreaSummaryProperties & {
     websites: string[];
     wikidataID: string | null;
     places: Place[];
+    viewportHint: ViewportHint;
 };
 export type SkiAreaSummaryProperties = {
     type: FeatureType.SkiArea;

package/dist/SkiArea.js.map

@@ -1 +1 @@
-{"version":3,"file":"SkiArea.js","sourceRoot":"","sources":["../src/SkiArea.ts"],"names":[],"mappings":";;;AAsEA,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,wCAAqB,CAAA;IACrB,oCAAiB,CAAA;AACnB,CAAC,EAHW,eAAe,+BAAf,eAAe,QAG1B"}
+{"version":3,"file":"SkiArea.js","sourceRoot":"","sources":["../src/SkiArea.ts"],"names":[],"mappings":";;;AAwEA,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,wCAAqB,CAAA;IACrB,oCAAiB,CAAA;AACnB,CAAC,EAHW,eAAe,+BAAf,eAAe,QAG1B"}

package/dist/Spot.d.ts

@@ -3,6 +3,7 @@ import { FeatureType } from './FeatureType';
 import { Place } from './Place';
 import { SkiAreaSummaryFeature } from './SkiArea';
 import { Source } from './Source';
+import { ViewportHint } from './ViewportHint';
 /**
  * A GeoJSON feature representing a spot (point of interest) in or around a ski area.
  *
@@ -30,6 +31,7 @@ export type SpotBaseProperties = {
     skiAreas: SkiAreaSummaryFeature[];
     sources: Source[];
     places: Place[];
+    viewportHint: ViewportHint;
 };
 /**
  * Types of spots that can be found in or around ski areas.

package/dist/Spot.js.map

@@ -1 +1 @@
-{"version":3,"file":"Spot.js","sourceRoot":"","sources":["../src/Spot.ts"],"names":[],"mappings":";;;AA+CA;;GAEG;AACH,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,iCAAqB,CAAA;IACrB,wCAA4B,CAAA;IAC5B,2EAA+D,CAAA;IAC/D,+EAAmE,CAAA;IACnE,iCAAqB,CAAA;AACvB,CAAC,EANW,QAAQ,wBAAR,QAAQ,QAMnB;AAaD;;GAEG;AACH,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,kCAAW,CAAA;IACX,gCAAS,CAAA;IACT,8CAAuB,CAAA;AACzB,CAAC,EAJW,mBAAmB,mCAAnB,mBAAmB,QAI9B;AAuBD;;GAEG;AACH,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,kCAAW,CAAA;IACX,kCAAW,CAAA;IACX,wCAAiB,CAAA;AACnB,CAAC,EAJW,mBAAmB,mCAAnB,mBAAmB,QAI9B"}
+{"version":3,"file":"Spot.js","sourceRoot":"","sources":["../src/Spot.ts"],"names":[],"mappings":";;;AAiDA;;GAEG;AACH,IAAY,QAMX;AAND,WAAY,QAAQ;IAClB,iCAAqB,CAAA;IACrB,wCAA4B,CAAA;IAC5B,2EAA+D,CAAA;IAC/D,+EAAmE,CAAA;IACnE,iCAAqB,CAAA;AACvB,CAAC,EANW,QAAQ,wBAAR,QAAQ,QAMnB;AAaD;;GAEG;AACH,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,kCAAW,CAAA;IACX,gCAAS,CAAA;IACT,8CAAuB,CAAA;AACzB,CAAC,EAJW,mBAAmB,mCAAnB,mBAAmB,QAI9B;AAuBD;;GAEG;AACH,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,kCAAW,CAAA;IACX,kCAAW,CAAA;IACX,wCAAiB,CAAA;AACnB,CAAC,EAJW,mBAAmB,mCAAnB,mBAAmB,QAI9B"}

package/dist/ViewportHint.d.ts

@@ -0,0 +1,33 @@
+import * as GeoJSON from 'geojson';
+/**
+ * Pre-computed viewport positioning data stored on every feature's properties.
+ * Camera space: Y axis points uphill (along bearing), X axis points screen-right.
+ * Metric values are in that rotated frame with elevation-adjusted Y positions
+ * (at 45° pitch, Δe metres above mean elevation shifts Y by Δe metres).
+ */
+export type ViewportHint = {
+    /** Geographic centre of the rotated bounding box as [lng, lat]. */
+    center: [number, number];
+    /**
+     * Uphill bearing in degrees clockwise from north. null when elevation variation is
+     * insufficient to determine orientation — client should use top-down view (pitch 0, bearing 0).
+     */
+    bearing: number | null;
+    /** Bounding box width along the camera X axis, in metres. */
+    rotatedWidthMeters: number;
+    /** Bounding box height along the camera Y axis, in metres (elevation-adjusted). */
+    rotatedHeightMeters: number;
+    /**
+     * Most-downhill edge of the elevation-adjusted bounding box in camera-Y metres, relative
+     * to mean feature elevation. Used to compute the perspective centre shift at 45° pitch:
+     * look-at point = minCameraY + nearFraction * rotatedHeightMeters, where
+     * nearFraction = nearGround / (nearGround + farGround) from camera pitch and vFOV.
+     */
+    minCameraY: number;
+};
+/**
+ * Computes a ViewportHint from one or more GeoJSON geometries.
+ * All geometry types are accepted; elevation is read from the Z coordinate (defaults to 0).
+ * Throws if no coordinates are found.
+ */
+export declare function computeViewportHint(geometries: GeoJSON.Geometry[]): ViewportHint;

package/dist/ViewportHint.js

@@ -0,0 +1,153 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeViewportHint = computeViewportHint;
+const tslib_1 = require("tslib");
+const distance_1 = tslib_1.__importDefault(require("@turf/distance"));
+/**
+ * Computes a ViewportHint from one or more GeoJSON geometries.
+ * All geometry types are accepted; elevation is read from the Z coordinate (defaults to 0).
+ * Throws if no coordinates are found.
+ */
+function computeViewportHint(geometries) {
+    // Collect all coordinates (for bbox + elevation stats) and consecutive segment pairs
+    // (for the downhill bearing calculation).
+    const allCoords = [];
+    const bearingSegments = [];
+    for (const geom of geometries) {
+        collectGeometry(geom, allCoords, bearingSegments);
+    }
+    if (allCoords.length === 0)
+        throw new Error('computeViewportHint: no coordinates found in provided geometries');
+    let minLng = Infinity, maxLng = -Infinity;
+    let minLat = Infinity, maxLat = -Infinity;
+    for (const [lng, lat] of allCoords) {
+        if (lng < minLng)
+            minLng = lng;
+        if (lng > maxLng)
+            maxLng = lng;
+        if (lat < minLat)
+            minLat = lat;
+        if (lat > maxLat)
+            maxLat = lat;
+    }
+    const centerLng = (minLng + maxLng) / 2;
+    const centerLat = (minLat + maxLat) / 2;
+    // Weight each segment's downhill direction by length to find dominant bearing.
+    let sumSin = 0, sumCos = 0;
+    for (const [[lng0, lat0, elev0], [lng1, lat1, elev1]] of bearingSegments) {
+        if (elev0 === elev1)
+            continue;
+        const [fromLng, fromLat, toLng, toLat] = elev0 > elev1
+            ? [lng0, lat0, lng1, lat1]
+            : [lng1, lat1, lng0, lat0];
+        const bear = greatCircleBearing(fromLat, fromLng, toLat, toLng);
+        const len = (0, distance_1.default)([lng0, lat0], [lng1, lat1], { units: 'meters' });
+        const bearingRad = (bear * Math.PI) / 180;
+        sumSin += Math.sin(bearingRad) * len;
+        sumCos += Math.cos(bearingRad) * len;
+    }
+    // Uphill bearing = downhill + 180°; null if no elevation variation found.
+    // A small offset is added so the camera is angled slightly to the side of the fall line,
+    // giving a better 3-D profile of the terrain rather than pointing straight uphill.
+    const bearingSideOffsetDeg = 30;
+    let mapBearing = null;
+    if (sumSin !== 0 || sumCos !== 0) {
+        const dominantDownhill = (Math.atan2(sumSin, sumCos) * 180) / Math.PI;
+        const normalizedDownhill = ((dominantDownhill % 360) + 360) % 360;
+        mapBearing = (normalizedDownhill + 180 + bearingSideOffsetDeg) % 360;
+    }
+    const metersPerDeg = 111320;
+    const cosLat = Math.cos(centerLat * (Math.PI / 180));
+    const bearingRad = ((mapBearing ?? 0) * Math.PI) / 180;
+    let elevationSum = 0;
+    for (const [, , elev] of allCoords)
+        elevationSum += elev;
+    const meanElevation = elevationSum / allCoords.length;
+    let minCameraX = Infinity, maxCameraX = -Infinity;
+    let minCameraY = Infinity, maxCameraY = -Infinity;
+    for (const [lng, lat, elev] of allCoords) {
+        const dx = (lng - centerLng) * cosLat * metersPerDeg;
+        const dy = (lat - centerLat) * metersPerDeg;
+        const cx = dx * Math.cos(bearingRad) - dy * Math.sin(bearingRad);
+        const cy = dx * Math.sin(bearingRad) + dy * Math.cos(bearingRad);
+        // At 45° pitch, elevation above mean shifts apparent Y by the same amount (tan 45° = 1).
+        const cyEffective = cy + (elev - meanElevation);
+        if (cx < minCameraX)
+            minCameraX = cx;
+        if (cx > maxCameraX)
+            maxCameraX = cx;
+        if (cyEffective < minCameraY)
+            minCameraY = cyEffective;
+        if (cyEffective > maxCameraY)
+            maxCameraY = cyEffective;
+    }
+    return {
+        center: [centerLng, centerLat],
+        bearing: mapBearing,
+        rotatedWidthMeters: maxCameraX - minCameraX,
+        rotatedHeightMeters: maxCameraY - minCameraY,
+        minCameraY,
+    };
+}
+/** Recursively extracts coordinates and segment pairs from a geometry. */
+function collectGeometry(geom, allCoords, bearingSegments) {
+    switch (geom.type) {
+        case 'Point': {
+            const [lng, lat, elev = 0] = geom.coordinates;
+            allCoords.push([lng, lat, elev]);
+            break;
+        }
+        case 'MultiPoint': {
+            for (const pos of geom.coordinates) {
+                const [lng, lat, elev = 0] = pos;
+                allCoords.push([lng, lat, elev]);
+            }
+            break;
+        }
+        case 'LineString':
+            collectPositions(geom.coordinates, allCoords, bearingSegments);
+            break;
+        case 'MultiLineString':
+            for (const line of geom.coordinates) {
+                collectPositions(line, allCoords, bearingSegments);
+            }
+            break;
+        case 'Polygon':
+            for (const ring of geom.coordinates) {
+                collectPositions(ring, allCoords, bearingSegments);
+            }
+            break;
+        case 'MultiPolygon':
+            for (const polygon of geom.coordinates) {
+                for (const ring of polygon) {
+                    collectPositions(ring, allCoords, bearingSegments);
+                }
+            }
+            break;
+        case 'GeometryCollection':
+            for (const g of geom.geometries) {
+                collectGeometry(g, allCoords, bearingSegments);
+            }
+            break;
+    }
+}
+/** Adds positions to allCoords and consecutive pairs to bearingSegments. Z defaults to 0. */
+function collectPositions(positions, allCoords, bearingSegments) {
+    const elevated = positions.map(([lng, lat, elev = 0]) => [lng, lat, elev]);
+    for (const coord of elevated)
+        allCoords.push(coord);
+    for (let i = 0; i < elevated.length - 1; i++) {
+        bearingSegments.push([elevated[i], elevated[i + 1]]);
+    }
+}
+/** Great-circle bearing from (lat1, lng1) to (lat2, lng2), in degrees 0–360. */
+function greatCircleBearing(lat1, lng1, lat2, lng2) {
+    const toRad = (d) => (d * Math.PI) / 180;
+    const φ1 = toRad(lat1);
+    const φ2 = toRad(lat2);
+    const Δλ = toRad(lng2 - lng1);
+    const y = Math.sin(Δλ) * Math.cos(φ2);
+    const x = Math.cos(φ1) * Math.sin(φ2) - Math.sin(φ1) * Math.cos(φ2) * Math.cos(Δλ);
+    return ((Math.atan2(y, x) * 180) / Math.PI + 360) % 360;
+}
+//# sourceMappingURL=ViewportHint.js.map

package/dist/ViewportHint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ViewportHint.js","sourceRoot":"","sources":["../src/ViewportHint.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -11,3 +11,4 @@ export * from './SnowCoverHistory';
 export * from './Source';
 export * from './Spot';
 export * from './Status';
+export * from './ViewportHint';

package/dist/index.js

@@ -14,4 +14,5 @@ tslib_1.__exportStar(require("./SnowCoverHistory"), exports);
 tslib_1.__exportStar(require("./Source"), exports);
 tslib_1.__exportStar(require("./Spot"), exports);
 tslib_1.__exportStar(require("./Status"), exports);
+tslib_1.__exportStar(require("./ViewportHint"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6DAAkC;AAClC,wDAA6B;AAC7B,iDAAsB;AACtB,8DAAmC;AACnC,kDAAuB;AACvB,gDAAqB;AACrB,oEAAyC;AACzC,8DAAmC;AACnC,oDAAyB;AACzB,6DAAkC;AAClC,mDAAwB;AACxB,iDAAsB;AACtB,mDAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,6DAAkC;AAClC,wDAA6B;AAC7B,iDAAsB;AACtB,8DAAmC;AACnC,kDAAuB;AACvB,gDAAqB;AACrB,oEAAyC;AACzC,8DAAmC;AACnC,oDAAyB;AACzB,6DAAkC;AAClC,mDAAwB;AACxB,iDAAsB;AACtB,mDAAwB;AACxB,yDAA8B"}

package/dist/testUtils.d.ts

@@ -0,0 +1,2 @@
+import { ViewportHint } from './ViewportHint';
+export declare function mockViewportHint(): ViewportHint;

package/dist/testUtils.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mockViewportHint = mockViewportHint;
+function mockViewportHint() {
+    return { center: [0, 0], bearing: null, rotatedWidthMeters: 0, rotatedHeightMeters: 0, minCameraY: 0 };
+}
+//# sourceMappingURL=testUtils.js.map

package/dist/testUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testUtils.js","sourceRoot":"","sources":["../src/testUtils.ts"],"names":[],"mappings":";;AAEA,4CAEC;AAFD,SAAgB,gBAAgB;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAA;AACxG,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openskidata-format",
-  "version": "11.1.0",
+  "version": "12.1.0",
   "description": "Data format for OpenSkiMap.org",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/ElevationProfile.test.ts

@@ -10,6 +10,7 @@ import { getLiftElevationData, LiftFeature, LiftType } from './Lift'
 import { getRunElevationData, RunDifficulty, RunFeature, RunUse } from './Run'
 import { RunDifficultyConvention } from './RunDifficultyConvention'
 import { Status } from './Status'
+import { mockViewportHint } from './testUtils'
 
 describe('ElevationProfile', () => {
   describe('getAscentAndDescent', () => {
@@ -277,6 +278,7 @@ describe('ElevationProfile', () => {
           wikidataID: null,
           tunnel: null,
           places: [],
+          viewportHint: mockViewportHint(),
         },
       }
 
@@ -317,6 +319,7 @@ describe('ElevationProfile', () => {
           wikidataID: null,
           tunnel: null,
           places: [],
+          viewportHint: mockViewportHint(),
         },
       }
 
@@ -361,6 +364,7 @@ describe('ElevationProfile', () => {
           wikidataID: null,
           tunnel: null,
           places: [],
+          viewportHint: mockViewportHint(),
         },
       }
 
@@ -408,6 +412,7 @@ describe('ElevationProfile', () => {
           wikidataID: null,
           tunnel: null,
           places: [],
+          viewportHint: mockViewportHint(),
         },
         geometry: {
           type: 'LineString',

package/src/Lift.test.ts

@@ -1,5 +1,6 @@
 import { FeatureType } from './FeatureType';
 import { getLiftElevationData, LiftFeature, LiftType, getFormattedLiftType, getLiftColor } from './Lift';
+import { mockViewportHint } from './testUtils';
 import { LiftStationPosition, LiftStationSpotFeature, SpotType } from './Spot';
 import { Status } from './Status';
 
@@ -41,6 +42,7 @@ function makeLiftFeature(overrides: {
       websites: [],
       wikidataID: null,
       places: [],
+      viewportHint: mockViewportHint(),
     },
   }
 }
@@ -64,6 +66,7 @@ function makeStation(
       skiAreas: [],
       sources: [],
       places: [],
+      viewportHint: mockViewportHint(),
     },
   }
 }

package/src/Lift.ts

@@ -7,6 +7,7 @@ import { Source } from './Source'
 import { LiftStationPosition, LiftStationSpotFeature } from './Spot'
 import { Status } from './Status'
 import { exhaustiveMatchingGuard } from './util/exhaustiveMatchingGuard'
+import { ViewportHint } from './ViewportHint'
 
 export type LiftFeature = GeoJSON.Feature<LiftGeometry, LiftProperties>
 
@@ -78,6 +79,7 @@ export type LiftProperties = {
   websites: string[]
   wikidataID: string | null
   places: Place[]
+  viewportHint: ViewportHint
 }
 
 export enum LiftType {
@@ -199,18 +201,18 @@ export function getFormattedLiftType(liftType: LiftType): string {
 }
 
 export function getLiftColor(status: Status): string {
-  const BRIGHT_RED_COLOR = 'hsl(0, 82%, 42%)'
-  const DIM_RED_COLOR = 'hsl(0, 53%, 42%)'
+  const brightRedColor = 'hsl(0, 82%, 42%)'
+  const dimRedColor = 'hsl(0, 53%, 42%)'
 
   switch (status) {
     case Status.Disused:
     case Status.Abandoned:
-      return DIM_RED_COLOR
+      return dimRedColor
     case Status.Proposed:
     case Status.Planned:
     case Status.Construction:
     case Status.Operating:
-      return BRIGHT_RED_COLOR
+      return brightRedColor
     default:
       return exhaustiveMatchingGuard(status)
   }

package/src/Run.ts

@@ -13,6 +13,7 @@ import { SnowCoverHistory } from './SnowCoverHistory'
 import { Source } from './Source'
 import { Status } from './Status'
 import { exhaustiveMatchingGuard } from './util/exhaustiveMatchingGuard'
+import { ViewportHint } from './ViewportHint'
 
 export type RunGeometry = GeoJSON.LineString | GeoJSON.Polygon
 
@@ -88,6 +89,7 @@ export type RunProperties = {
   wikidataID: string | null
   places: Place[]
   snowCoverHistory?: SnowCoverHistory
+  viewportHint: ViewportHint
 }
 
 export enum RunUse {

package/src/SkiArea.ts

@@ -6,6 +6,7 @@ import { RunDifficultyConvention } from './RunDifficultyConvention'
 import { SnowCoverHistory } from './SnowCoverHistory'
 import { Source } from './Source'
 import { Status } from './Status'
+import { ViewportHint } from './ViewportHint'
 
 /**
  * A ski area feature is derived from several sources:
@@ -58,6 +59,7 @@ export type SkiAreaProperties = SkiAreaSummaryProperties & {
   websites: string[]
   wikidataID: string | null
   places: Place[]
+  viewportHint: ViewportHint
 }
 
 export type SkiAreaSummaryProperties = {

package/src/SlopeGradingScale.test.ts

@@ -1,5 +1,6 @@
 import { RunDifficulty, RunUse } from "./Run";
 import { getEstimatedRunDifficulty, getSlopeGradingScale } from "./SlopeGradingScale";
+import { mockViewportHint } from "./testUtils";
 
 describe("getEstimatedRunDifficulty", () => {
   it("should return null for steepness below minimum threshold", () => {
@@ -30,6 +31,7 @@ describe("getEstimatedRunDifficulty", () => {
         wikidataID: null,
         tunnel: null,
         places: [],
+        viewportHint: mockViewportHint(),
       },
     });
 
@@ -64,6 +66,7 @@ describe("getEstimatedRunDifficulty", () => {
         wikidataID: null,
         tunnel: null,
         places: [],
+        viewportHint: mockViewportHint(),
       },
     });
 
@@ -102,6 +105,7 @@ describe("getEstimatedRunDifficulty", () => {
         wikidataID: null,
         tunnel: null,
         places: [],
+        viewportHint: mockViewportHint(),
       },
     });
 
@@ -138,6 +142,7 @@ describe("getEstimatedRunDifficulty", () => {
         wikidataID: null,
         tunnel: null,
         places: [],
+        viewportHint: mockViewportHint(),
       },
     });
 

package/src/Spot.ts

@@ -3,6 +3,7 @@ import { FeatureType } from './FeatureType'
 import { Place } from './Place'
 import { SkiAreaSummaryFeature } from './SkiArea'
 import { Source } from './Source'
+import { ViewportHint } from './ViewportHint'
 
 /**
  * A GeoJSON feature representing a spot (point of interest) in or around a ski area.
@@ -43,6 +44,7 @@ export type SpotBaseProperties = {
   skiAreas: SkiAreaSummaryFeature[]
   sources: Source[]
   places: Place[]
+  viewportHint: ViewportHint
 }
 
 /**

package/src/ViewportHint.ts

@@ -0,0 +1,208 @@
+import * as GeoJSON from 'geojson'
+import distance from '@turf/distance'
+
+/**
+ * Pre-computed viewport positioning data stored on every feature's properties.
+ * Camera space: Y axis points uphill (along bearing), X axis points screen-right.
+ * Metric values are in that rotated frame with elevation-adjusted Y positions
+ * (at 45° pitch, Δe metres above mean elevation shifts Y by Δe metres).
+ */
+export type ViewportHint = {
+  /** Geographic centre of the rotated bounding box as [lng, lat]. */
+  center: [number, number]
+
+  /**
+   * Uphill bearing in degrees clockwise from north. null when elevation variation is
+   * insufficient to determine orientation — client should use top-down view (pitch 0, bearing 0).
+   */
+  bearing: number | null
+
+  /** Bounding box width along the camera X axis, in metres. */
+  rotatedWidthMeters: number
+
+  /** Bounding box height along the camera Y axis, in metres (elevation-adjusted). */
+  rotatedHeightMeters: number
+
+  /**
+   * Most-downhill edge of the elevation-adjusted bounding box in camera-Y metres, relative
+   * to mean feature elevation. Used to compute the perspective centre shift at 45° pitch:
+   * look-at point = minCameraY + nearFraction * rotatedHeightMeters, where
+   * nearFraction = nearGround / (nearGround + farGround) from camera pitch and vFOV.
+   */
+  minCameraY: number
+}
+
+/**
+ * Computes a ViewportHint from one or more GeoJSON geometries.
+ * All geometry types are accepted; elevation is read from the Z coordinate (defaults to 0).
+ * Throws if no coordinates are found.
+ */
+export function computeViewportHint(
+  geometries: GeoJSON.Geometry[],
+): ViewportHint {
+  // Collect all coordinates (for bbox + elevation stats) and consecutive segment pairs
+  // (for the downhill bearing calculation).
+  const allCoords: [number, number, number][] = []
+  const bearingSegments: [[number, number, number], [number, number, number]][] =
+    []
+
+  for (const geom of geometries) {
+    collectGeometry(geom, allCoords, bearingSegments)
+  }
+
+  if (allCoords.length === 0) throw new Error('computeViewportHint: no coordinates found in provided geometries')
+
+  let minLng = Infinity,
+    maxLng = -Infinity
+  let minLat = Infinity,
+    maxLat = -Infinity
+  for (const [lng, lat] of allCoords) {
+    if (lng < minLng) minLng = lng
+    if (lng > maxLng) maxLng = lng
+    if (lat < minLat) minLat = lat
+    if (lat > maxLat) maxLat = lat
+  }
+
+  const centerLng = (minLng + maxLng) / 2
+  const centerLat = (minLat + maxLat) / 2
+
+  // Weight each segment's downhill direction by length to find dominant bearing.
+  let sumSin = 0,
+    sumCos = 0
+  for (const [[lng0, lat0, elev0], [lng1, lat1, elev1]] of bearingSegments) {
+    if (elev0 === elev1) continue
+    const [fromLng, fromLat, toLng, toLat] =
+      elev0 > elev1
+        ? [lng0, lat0, lng1, lat1]
+        : [lng1, lat1, lng0, lat0]
+    const bear = greatCircleBearing(fromLat, fromLng, toLat, toLng)
+    const len = distance([lng0, lat0], [lng1, lat1], { units: 'meters' })
+    const bearingRad = (bear * Math.PI) / 180
+    sumSin += Math.sin(bearingRad) * len
+    sumCos += Math.cos(bearingRad) * len
+  }
+
+  // Uphill bearing = downhill + 180°; null if no elevation variation found.
+  // A small offset is added so the camera is angled slightly to the side of the fall line,
+  // giving a better 3-D profile of the terrain rather than pointing straight uphill.
+  const bearingSideOffsetDeg = 30
+  let mapBearing: number | null = null
+  if (sumSin !== 0 || sumCos !== 0) {
+    const dominantDownhill = (Math.atan2(sumSin, sumCos) * 180) / Math.PI
+    const normalizedDownhill = ((dominantDownhill % 360) + 360) % 360
+    mapBearing = (normalizedDownhill + 180 + bearingSideOffsetDeg) % 360
+  }
+
+  const metersPerDeg = 111320
+  const cosLat = Math.cos(centerLat * (Math.PI / 180))
+  const bearingRad = ((mapBearing ?? 0) * Math.PI) / 180
+
+  let elevationSum = 0
+  for (const [, , elev] of allCoords) elevationSum += elev
+  const meanElevation = elevationSum / allCoords.length
+
+  let minCameraX = Infinity,
+    maxCameraX = -Infinity
+  let minCameraY = Infinity,
+    maxCameraY = -Infinity
+
+  for (const [lng, lat, elev] of allCoords) {
+    const dx = (lng - centerLng) * cosLat * metersPerDeg
+    const dy = (lat - centerLat) * metersPerDeg
+    const cx = dx * Math.cos(bearingRad) - dy * Math.sin(bearingRad)
+    const cy = dx * Math.sin(bearingRad) + dy * Math.cos(bearingRad)
+    // At 45° pitch, elevation above mean shifts apparent Y by the same amount (tan 45° = 1).
+    const cyEffective = cy + (elev - meanElevation)
+    if (cx < minCameraX) minCameraX = cx
+    if (cx > maxCameraX) maxCameraX = cx
+    if (cyEffective < minCameraY) minCameraY = cyEffective
+    if (cyEffective > maxCameraY) maxCameraY = cyEffective
+  }
+
+  return {
+    center: [centerLng, centerLat],
+    bearing: mapBearing,
+    rotatedWidthMeters: maxCameraX - minCameraX,
+    rotatedHeightMeters: maxCameraY - minCameraY,
+    minCameraY,
+  }
+}
+
+/** Recursively extracts coordinates and segment pairs from a geometry. */
+function collectGeometry(
+  geom: GeoJSON.Geometry,
+  allCoords: [number, number, number][],
+  bearingSegments: [[number, number, number], [number, number, number]][],
+): void {
+  switch (geom.type) {
+    case 'Point': {
+      const [lng, lat, elev = 0] = geom.coordinates
+      allCoords.push([lng, lat, elev])
+      break
+    }
+    case 'MultiPoint': {
+      for (const pos of geom.coordinates) {
+        const [lng, lat, elev = 0] = pos
+        allCoords.push([lng, lat, elev])
+      }
+      break
+    }
+    case 'LineString':
+      collectPositions(geom.coordinates, allCoords, bearingSegments)
+      break
+    case 'MultiLineString':
+      for (const line of geom.coordinates) {
+        collectPositions(line, allCoords, bearingSegments)
+      }
+      break
+    case 'Polygon':
+      for (const ring of geom.coordinates) {
+        collectPositions(ring, allCoords, bearingSegments)
+      }
+      break
+    case 'MultiPolygon':
+      for (const polygon of geom.coordinates) {
+        for (const ring of polygon) {
+          collectPositions(ring, allCoords, bearingSegments)
+        }
+      }
+      break
+    case 'GeometryCollection':
+      for (const g of geom.geometries) {
+        collectGeometry(g, allCoords, bearingSegments)
+      }
+      break
+  }
+}
+
+/** Adds positions to allCoords and consecutive pairs to bearingSegments. Z defaults to 0. */
+function collectPositions(
+  positions: GeoJSON.Position[],
+  allCoords: [number, number, number][],
+  bearingSegments: [[number, number, number], [number, number, number]][],
+): void {
+  const elevated: [number, number, number][] = positions.map(
+    ([lng, lat, elev = 0]) => [lng, lat, elev],
+  )
+  for (const coord of elevated) allCoords.push(coord)
+  for (let i = 0; i < elevated.length - 1; i++) {
+    bearingSegments.push([elevated[i], elevated[i + 1]])
+  }
+}
+
+/** Great-circle bearing from (lat1, lng1) to (lat2, lng2), in degrees 0–360. */
+function greatCircleBearing(
+  lat1: number,
+  lng1: number,
+  lat2: number,
+  lng2: number,
+): number {
+  const toRad = (d: number) => (d * Math.PI) / 180
+  const φ1 = toRad(lat1)
+  const φ2 = toRad(lat2)
+  const Δλ = toRad(lng2 - lng1)
+  const y = Math.sin(Δλ) * Math.cos(φ2)
+  const x =
+    Math.cos(φ1) * Math.sin(φ2) - Math.sin(φ1) * Math.cos(φ2) * Math.cos(Δλ)
+  return ((Math.atan2(y, x) * 180) / Math.PI + 360) % 360
+}

package/src/index.ts

@@ -11,3 +11,4 @@ export * from './SnowCoverHistory'
 export * from './Source'
 export * from './Spot'
 export * from './Status'
+export * from './ViewportHint'

package/src/testUtils.ts

@@ -0,0 +1,5 @@
+import { ViewportHint } from './ViewportHint'
+
+export function mockViewportHint(): ViewportHint {
+  return { center: [0, 0], bearing: null, rotatedWidthMeters: 0, rotatedHeightMeters: 0, minCameraY: 0 }
+}