@retor/react-native 0.5.1 → 0.5.2

package/dist/index.d.mts

@@ -36,6 +36,13 @@ interface RetorTag {
      *  tag's position. Positive = uphill, negative = downhill. Same calculation as
      *  `LineProgressPayload.pitchDeg`. Null if not georeferenced. */
     pitchDeg?: number | null;
+    /** Monotonic HORIZONTAL distance (meters, ENU east/north plane) from the line start to
+     *  this tag. Use this — not `distanceFromStart` — when feeding into Naismith / Tobler
+     *  walking-time models so vertical travel isn't double-counted. */
+    cumulativeHorizontalM?: number | null;
+    /** Monotonic sum of POSITIVE elevation deltas (meters) from the line start to this tag.
+     *  Descents are ignored, so this is the "elevation gain" used by walking-time models. */
+    cumulativeElevationGainM?: number | null;
 }
 interface RetorLine {
     _id: string;
@@ -92,6 +99,10 @@ interface LineProgressPayload {
     sectionIndex?: number | null;
     /** 0..1 progress of the cursor within the current section. */
     sectionProgress?: number | null;
+    /** Monotonic HORIZONTAL distance (meters) from line start to the cursor. */
+    cumulativeHorizontalM?: number | null;
+    /** Monotonic sum of positive elevation deltas (meters) from line start to the cursor. */
+    cumulativeElevationGainM?: number | null;
 }
 interface ViewerHandle {
     openLine: (lineId: string) => void;
@@ -180,6 +191,8 @@ declare function useLineProgress(): {
     sectionLengthM: number | null;
     sectionIndex: number | null;
     sectionProgress: number | null;
+    cumulativeHorizontalM: number | null;
+    cumulativeElevationGainM: number | null;
 };
 /**
  * Returns the autoplay state and controls.

package/dist/index.d.ts

@@ -36,6 +36,13 @@ interface RetorTag {
      *  tag's position. Positive = uphill, negative = downhill. Same calculation as
      *  `LineProgressPayload.pitchDeg`. Null if not georeferenced. */
     pitchDeg?: number | null;
+    /** Monotonic HORIZONTAL distance (meters, ENU east/north plane) from the line start to
+     *  this tag. Use this — not `distanceFromStart` — when feeding into Naismith / Tobler
+     *  walking-time models so vertical travel isn't double-counted. */
+    cumulativeHorizontalM?: number | null;
+    /** Monotonic sum of POSITIVE elevation deltas (meters) from the line start to this tag.
+     *  Descents are ignored, so this is the "elevation gain" used by walking-time models. */
+    cumulativeElevationGainM?: number | null;
 }
 interface RetorLine {
     _id: string;
@@ -92,6 +99,10 @@ interface LineProgressPayload {
     sectionIndex?: number | null;
     /** 0..1 progress of the cursor within the current section. */
     sectionProgress?: number | null;
+    /** Monotonic HORIZONTAL distance (meters) from line start to the cursor. */
+    cumulativeHorizontalM?: number | null;
+    /** Monotonic sum of positive elevation deltas (meters) from line start to the cursor. */
+    cumulativeElevationGainM?: number | null;
 }
 interface ViewerHandle {
     openLine: (lineId: string) => void;
@@ -180,6 +191,8 @@ declare function useLineProgress(): {
     sectionLengthM: number | null;
     sectionIndex: number | null;
     sectionProgress: number | null;
+    cumulativeHorizontalM: number | null;
+    cumulativeElevationGainM: number | null;
 };
 /**
  * Returns the autoplay state and controls.

package/dist/index.js

@@ -67,6 +67,8 @@ var RetorProgressContext = (0, import_react.createContext)({
   sectionLengthM: null,
   sectionIndex: null,
   sectionProgress: null,
+  cumulativeHorizontalM: null,
+  cumulativeElevationGainM: null,
   isPlaying: false
 });
 function noop() {
@@ -123,7 +125,9 @@ function useLineProgress() {
     elevationGainM,
     sectionLengthM,
     sectionIndex,
-    sectionProgress
+    sectionProgress,
+    cumulativeHorizontalM,
+    cumulativeElevationGainM
   } = useRetorProgress();
   return (0, import_react.useMemo)(
     () => ({
@@ -138,7 +142,9 @@ function useLineProgress() {
       elevationGainM,
       sectionLengthM,
       sectionIndex,
-      sectionProgress
+      sectionProgress,
+      cumulativeHorizontalM,
+      cumulativeElevationGainM
     }),
     [
       progress,
@@ -152,7 +158,9 @@ function useLineProgress() {
       elevationGainM,
       sectionLengthM,
       sectionIndex,
-      sectionProgress
+      sectionProgress,
+      cumulativeHorizontalM,
+      cumulativeElevationGainM
     ]
   );
 }
@@ -273,6 +281,8 @@ var Viewer = (0, import_react2.forwardRef)(function Viewer2({ projectId, id = "d
   const [sectionLengthM, setSectionLengthM] = (0, import_react2.useState)(null);
   const [sectionIndex, setSectionIndex] = (0, import_react2.useState)(null);
   const [sectionProgress, setSectionProgress] = (0, import_react2.useState)(null);
+  const [cumulativeHorizontalM, setCumulativeHorizontalM] = (0, import_react2.useState)(null);
+  const [cumulativeElevationGainM, setCumulativeElevationGainM] = (0, import_react2.useState)(null);
   const [isPlaying, setIsPlaying] = (0, import_react2.useState)(false);
   const [isAddNoteOpen, setIsAddNoteOpen] = (0, import_react2.useState)(false);
   const [addNoteTagId, setAddNoteTagId] = (0, import_react2.useState)(null);
@@ -429,6 +439,8 @@ var Viewer = (0, import_react2.forwardRef)(function Viewer2({ projectId, id = "d
           setSectionLengthM(payload.sectionLengthM ?? null);
           setSectionIndex(payload.sectionIndex ?? null);
           setSectionProgress(payload.sectionProgress ?? null);
+          setCumulativeHorizontalM(payload.cumulativeHorizontalM ?? null);
+          setCumulativeElevationGainM(payload.cumulativeElevationGainM ?? null);
           onLineProgress?.(payload);
           break;
         }
@@ -489,6 +501,8 @@ var Viewer = (0, import_react2.forwardRef)(function Viewer2({ projectId, id = "d
       sectionLengthM,
       sectionIndex,
       sectionProgress,
+      cumulativeHorizontalM,
+      cumulativeElevationGainM,
       isPlaying
     }),
     [
@@ -504,6 +518,8 @@ var Viewer = (0, import_react2.forwardRef)(function Viewer2({ projectId, id = "d
       sectionLengthM,
       sectionIndex,
       sectionProgress,
+      cumulativeHorizontalM,
+      cumulativeElevationGainM,
       isPlaying
     ]
   );

package/dist/index.mjs

@@ -14,6 +14,8 @@ var RetorProgressContext = createContext({
   sectionLengthM: null,
   sectionIndex: null,
   sectionProgress: null,
+  cumulativeHorizontalM: null,
+  cumulativeElevationGainM: null,
   isPlaying: false
 });
 function noop() {
@@ -70,7 +72,9 @@ function useLineProgress() {
     elevationGainM,
     sectionLengthM,
     sectionIndex,
-    sectionProgress
+    sectionProgress,
+    cumulativeHorizontalM,
+    cumulativeElevationGainM
   } = useRetorProgress();
   return useMemo(
     () => ({
@@ -85,7 +89,9 @@ function useLineProgress() {
       elevationGainM,
       sectionLengthM,
       sectionIndex,
-      sectionProgress
+      sectionProgress,
+      cumulativeHorizontalM,
+      cumulativeElevationGainM
     }),
     [
       progress,
@@ -99,7 +105,9 @@ function useLineProgress() {
       elevationGainM,
       sectionLengthM,
       sectionIndex,
-      sectionProgress
+      sectionProgress,
+      cumulativeHorizontalM,
+      cumulativeElevationGainM
     ]
   );
 }
@@ -229,6 +237,8 @@ var Viewer = forwardRef(function Viewer2({ projectId, id = "default", baseUrl =
   const [sectionLengthM, setSectionLengthM] = useState(null);
   const [sectionIndex, setSectionIndex] = useState(null);
   const [sectionProgress, setSectionProgress] = useState(null);
+  const [cumulativeHorizontalM, setCumulativeHorizontalM] = useState(null);
+  const [cumulativeElevationGainM, setCumulativeElevationGainM] = useState(null);
   const [isPlaying, setIsPlaying] = useState(false);
   const [isAddNoteOpen, setIsAddNoteOpen] = useState(false);
   const [addNoteTagId, setAddNoteTagId] = useState(null);
@@ -385,6 +395,8 @@ var Viewer = forwardRef(function Viewer2({ projectId, id = "default", baseUrl =
           setSectionLengthM(payload.sectionLengthM ?? null);
           setSectionIndex(payload.sectionIndex ?? null);
           setSectionProgress(payload.sectionProgress ?? null);
+          setCumulativeHorizontalM(payload.cumulativeHorizontalM ?? null);
+          setCumulativeElevationGainM(payload.cumulativeElevationGainM ?? null);
           onLineProgress?.(payload);
           break;
         }
@@ -445,6 +457,8 @@ var Viewer = forwardRef(function Viewer2({ projectId, id = "default", baseUrl =
       sectionLengthM,
       sectionIndex,
       sectionProgress,
+      cumulativeHorizontalM,
+      cumulativeElevationGainM,
       isPlaying
     }),
     [
@@ -460,6 +474,8 @@ var Viewer = forwardRef(function Viewer2({ projectId, id = "default", baseUrl =
       sectionLengthM,
       sectionIndex,
       sectionProgress,
+      cumulativeHorizontalM,
+      cumulativeElevationGainM,
       isPlaying
     ]
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retor/react-native",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "description": "React Native SDK for embedding Retor 3D experiences",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",