feat(studio): trail teleport threshold + bump 0.2.6

- New Trails control: `Teleport threshold` (slider, normalised XYZ
  units, default 0.5, range 0.05–2.0). Persisted alongside the existing
  trail prefs in localStorage; loaded back into the UI on startup.
- 3D view: when the displacement between two consecutive trail points
  exceeds the threshold, the connecting segment is dropped. Buffer is
  kept so the trail resumes from the new position. Implemented at
  rebuild time off the raw consecutive XYZ — moving the slider takes
  effect on already-buffered points without invalidating history.
- Line mode now uses `THREE.LineSegments` rather than `THREE.Line`, so
  breaks can be honoured cleanly (one vertex pair per visible edge)
  without hacks like NaN positions or two-Line objects.
- Diffuse mode skips the interpolated dots across a broken segment but
  keeps the endpoint dots themselves, so the trail visibly gaps without
  swallowing the new position.
- mpv overlay relay: extend `pushMpvOverlayTrailPrefs` /
  `mpv_overlay_set_trail_prefs` Tauri command / `TrailPrefs` Rust
  struct / `trail-config` IPC wire format with a 4th field carrying the
  threshold. Lua side honours it identically; the older 3-field shape
  is still accepted for back-compat.
- i18n: add `trail.teleport` label in en / fr / es / pt-BR.
- Bump Studio to 0.2.6 (package.json, tauri.conf.json, Cargo.toml,
  Cargo.lock).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: mgth

omniphony-studio/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omniphony-studio",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Visualisation 3D d'objets audio spatialisés via OSC",
   "scripts": {
     "dev": "vite",

omniphony-studio/src-tauri/Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "omniphony-studio"
-version = "0.2.5"
+version = "0.2.6"
 edition = "2021"
 
 [[bin]]

omniphony-studio/src-tauri/Cargo.toml

@@ -2363,11 +2363,13 @@ fn mpv_overlay_set_trail_prefs(
     enabled: bool,
     ttl_ms: u32,
     mode: String,
+    teleport_threshold: f32,
 ) -> Result<(), String> {
     state.mpv_overlay.set_trail_prefs(TrailPrefs {
         enabled,
         ttl_ms,
         mode,
+        teleport_threshold,
     })
 }
 

omniphony-studio/src-tauri/src/main.rs

@@ -79,6 +79,10 @@ pub struct TrailPrefs {
     pub ttl_ms: u32,
     /// "diffuse" or "line"; anything else falls back to "line" lua-side.
     pub mode: String,
+    /// Max XYZ displacement (normalised units) between two consecutive
+    /// trail points before the connecting segment is treated as a
+    /// teleport and skipped lua-side.
+    pub teleport_threshold: f32,
 }
 
 impl MpvOverlayState {
@@ -109,11 +113,16 @@ impl MpvOverlayState {
             "diffuse" => "diffuse",
             _ => "line",
         };
+        // Clamp the threshold to the same range Studio uses, then format
+        // with a few decimals — the lua parser is strict about the wire
+        // format and won't accept scientific notation.
+        let threshold = prefs.teleport_threshold.clamp(0.0, 4.0);
         let line = format!(
-            r#"{{"command":["set_property","user-data/omniphony/overlay/trail-config","{}|{}|{}"]}}"#,
+            r#"{{"command":["set_property","user-data/omniphony/overlay/trail-config","{}|{}|{}|{:.3}"]}}"#,
             if prefs.enabled { 1 } else { 0 },
             prefs.ttl_ms,
-            mode
+            mode,
+            threshold
         );
         self.send_line(line)
     }

omniphony-studio/src-tauri/src/mpv_overlay.rs

@@ -1,7 +1,7 @@
 {
   "identifier": "fr.omniphony.studio",
   "productName": "Omniphony Studio",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "build": {
     "frontendDist": "../dist",
     "devUrl": "http://localhost:5173",

omniphony-studio/src-tauri/tauri.conf.json

@@ -56,6 +56,8 @@ function getTrailToggleEl() { return inDisplayPanel('trailToggle'); }
 function getTrailModeSelectEl() { return inDisplayPanel('trailModeSelect'); }
 function getTrailTtlSliderEl() { return inDisplayPanel('trailTtlSlider'); }
 function getTrailTtlValEl() { return inDisplayPanel('trailTtlVal'); }
+function getTrailTeleportSliderEl() { return inDisplayPanel('trailTeleportSlider'); }
+function getTrailTeleportValEl() { return inDisplayPanel('trailTeleportVal'); }
 function getEffectiveRenderToggleEl() { return inDisplayPanel('effectiveRenderToggle'); }
 function getObjectColorsToggleEl() { return inDisplayPanel('objectColorsToggle'); }
 function getObjectDisplayModeSelectEl() { return inDisplayPanel('objectDisplayModeSelect'); }
@@ -122,7 +124,8 @@ export function persistTrailPrefs() {
     const payload = {
       enabled: app.trailsEnabled,
       mode: app.trailRenderMode === 'line' ? 'line' : 'diffuse',
-      duration_ms: app.trailPointTtlMs
+      duration_ms: app.trailPointTtlMs,
+      teleport_threshold: app.trailTeleportThreshold
     };
     localStorage.setItem(TRAIL_PREFS_STORAGE_KEY, JSON.stringify(payload));
   } catch (_e) {
@@ -157,6 +160,8 @@ export function applyTrailPrefsToUi() {
   const trailModeSelectEl = getTrailModeSelectEl();
   const trailTtlSliderEl = getTrailTtlSliderEl();
   const trailTtlValEl = getTrailTtlValEl();
+  const trailTeleportSliderEl = getTrailTeleportSliderEl();
+  const trailTeleportValEl = getTrailTeleportValEl();
   if (trailToggleEl) {
     trailToggleEl.checked = app.trailsEnabled;
   }
@@ -169,6 +174,12 @@ export function applyTrailPrefsToUi() {
   if (trailTtlValEl) {
     trailTtlValEl.textContent = `${(app.trailPointTtlMs / 1000).toFixed(1)}s`;
   }
+  if (trailTeleportSliderEl) {
+    trailTeleportSliderEl.value = app.trailTeleportThreshold.toFixed(2);
+  }
+  if (trailTeleportValEl) {
+    trailTeleportValEl.textContent = app.trailTeleportThreshold.toFixed(2);
+  }
 }
 
 export function applyEffectiveRenderPrefsToUi() {
@@ -254,6 +265,10 @@ export function loadTrailPrefs() {
     if (Number.isFinite(durationMs)) {
       app.trailPointTtlMs = Math.max(500, durationMs);
     }
+    const teleport = Number(parsed?.teleport_threshold);
+    if (Number.isFinite(teleport)) {
+      app.trailTeleportThreshold = Math.max(0.05, Math.min(2.0, teleport));
+    }
   } catch (_e) {
     // Ignore malformed payloads.
   }

omniphony-studio/src/controls/room-geometry.js

@@ -211,6 +211,7 @@
   "trail.show": "Show",
   "trail.mode": "Mode",
   "trail.duration": "Duration",
+  "trail.teleport": "Teleport threshold",
   "trail.mode.diffuse": "Diffuse",
   "trail.mode.line": "Line",
   "effectiveRender.title": "Effective render",

omniphony-studio/src/i18n/en.json

@@ -186,6 +186,7 @@
   "trail.show": "Mostrar",
   "trail.mode": "Modo",
   "trail.duration": "Duración",
+  "trail.teleport": "Umbral de teletransporte",
   "trail.mode.diffuse": "Difuso",
   "trail.mode.line": "Línea",
   "effectiveRender.title": "Render efectivo",

omniphony-studio/src/i18n/es.json

@@ -211,6 +211,7 @@
   "trail.show": "Afficher",
   "trail.mode": "Mode",
   "trail.duration": "Durée",
+  "trail.teleport": "Seuil de téléportation",
   "trail.mode.diffuse": "Diffuse",
   "trail.mode.line": "Ligne",
   "effectiveRender.title": "Rendu effectif",