@glandais/vcyclist-elevation 1.0.0 → 1.1.1

package/README.md

@@ -112,16 +112,42 @@ suspend fun virtualize(xml: String): String {
 `generateTypeScriptDefinitions()` is enabled on both `js(IR)` and `wasmJs`, so you get a
 `.d.ts` next to the bundle in `build/dist/{js,wasmJs}/productionExecutable/vcyclist-engine.d.{ts,mts}`.
 
+The Kotlin/JS variant (`@glandais/vcyclist-engine`, `@glandais/vcyclist-elevation`) runs
+**in both browser and Node.js / Bun**. The Wasm variants (`*-wasm`) are browser-only.
+
+#### Browser
+
 ```js
-import { parseGpx, enhance, writeGpx, pathSize, pathTotalDistance } from './vcyclist-engine.mjs';
+import { parseGpx, enhance, writeGpx, pathSize, pathTotalDistance } from '@glandais/vcyclist-engine';
 
 const handle = parseGpx(gpxXml);
 console.log('input points:', pathSize(handle));
-const out = await enhance(handle, null);
+const out = await enhance(handle, null);                    // physics only, no HTTP
 console.log('output:', pathSize(out), pathTotalDistance(out), 'm');
 const xml = writeGpx(out);
 ```
 
+#### Node.js / Bun (with elevation correction)
+
+```js
+import { parseGpx, enhance, writeGpx } from '@glandais/vcyclist-engine';
+
+const handle = parseGpx(gpxXml);
+const out = await enhance(handle, { fixElevation: true });  // fetches DEM tiles, decodes WebP
+const xml = writeGpx(out);
+```
+
+`enhance(..., { fixElevation: true })` auto-instantiates a default `ElevationProvider`
+(mapterhorn Terrarium tiles) and runs the full pipeline (densify → fix elevation → smooth →
+max speeds → virtualize → resample → simplify).
+
+On Node.js / Bun, tile decoding uses [`@jsquash/webp`](https://www.npmjs.com/package/@jsquash/webp)
+(a pure-WASM WebP decoder, ~50 KB, listed as a runtime `dependency` of
+`@glandais/vcyclist-engine` and `@glandais/vcyclist-elevation`). It is loaded lazily via
+`eval('require')`, so browser bundlers do not pull it into the browser build. Requires
+Node ≥ 18 (`globalThis.fetch` is built-in since Node 18 / Bun) ; Node 22+ recommended for
+ESM `require()` support.
+
 ## Build & test
 
 ```bash
@@ -158,6 +184,12 @@ vcyclist/
   GPX I/O, full physics, simulation, post-processing, `Enhancer`, CLI, `@JsExport` façades.
 - ✅ **Phase 2bis** — pipeline fidelity fixes (tasks 29-31) : `VirtualizeService` last-point
   timestamp, `PointPerDistance` port, integration into `Enhancer`.
+- ✅ **Phase 3** — Node.js / Bun support (tasks 32-33) : runtime-detection in
+  `TileFetcher.js.kt` (browser path unchanged, Node path uses `globalThis.fetch` +
+  `@jsquash/webp` WASM decoder loaded via lazy `eval('require')`), webpack externals to keep
+  the browser bundle free of `@jsquash/webp`, `ElevationProvider` auto-instantiation in
+  `EngineJsApi.enhance` when `opts.fixElevation` is true (JS + Wasm façades), 6 jsTest classes
+  gated by `INTEGRATION=1`.
 
 Total `:engine` test coverage : 32 test classes / ~326 commonTest cases / 4 targets =
 ~1300 green executions, plus JVM-only smoke tests for the CLI and the full pipeline.
@@ -173,8 +205,20 @@ output points covering ~128.6 km / ~5.3 h of simulated ride.
 - [`docs/parity.md`](docs/parity.md) — TS↔Kotlin parity approach and tolerances.
 - [`docs/kotlin-wasm-jvm-webp.md`](docs/kotlin-wasm-jvm-webp.md) — Kotlin/Wasm ↔ JS interop
   guide that underpins the `@JsExport` façades and the WebP tile decoding.
+- [`docs/publishing.md`](docs/publishing.md) — release flow (Maven Central + npm via
+  semantic-release on push to `develop`).
 - [`elevation/README.md`](elevation/README.md) — `:elevation` module details + browser demos.
 
+## Contributing
+
+`develop` is the **default and only long-lived branch** — there is no `main`. Open PRs
+against `develop` using [Conventional Commits](https://www.conventionalcommits.org/) :
+`feat:` triggers a minor release, `fix:` a patch, anything else is a no-op release-wise.
+Every push to `develop` runs the full multi-target test suite via
+`.github/workflows/release.yml` and, if green, lets semantic-release tag a new version,
+publish to Maven Central + npm, and commit the version bump back to `develop` with
+`[skip ci]`. See [`docs/publishing.md`](docs/publishing.md) for the full flow.
+
 ## License
 
 Apache License 2.0, aligned with the upstream `gpx2web` project. See the Maven Central POM

package/kotlin-kotlin-stdlib.js

@@ -110,16 +110,16 @@ if (typeof Math.hypot === 'undefined') {
   initMetadataForClass(AbstractCollection, 'AbstractCollection', VOID, VOID, [Collection]);
   initMetadataForClass(AbstractMutableCollection, 'AbstractMutableCollection', VOID, AbstractCollection, [Collection]);
   initMetadataForClass(IteratorImpl, 'IteratorImpl');
-  initMetadataForClass(AbstractMutableList, 'AbstractMutableList', VOID, AbstractMutableCollection, [KtList, Collection]);
+  initMetadataForClass(AbstractMutableList, 'AbstractMutableList', VOID, AbstractMutableCollection, [Collection, KtList]);
   initMetadataForClass(AbstractMap, 'AbstractMap', VOID, VOID, [KtMap]);
   initMetadataForClass(AbstractMutableMap, 'AbstractMutableMap', VOID, AbstractMap, [KtMap]);
-  initMetadataForClass(AbstractMutableSet, 'AbstractMutableSet', VOID, AbstractMutableCollection, [KtSet, Collection]);
+  initMetadataForClass(AbstractMutableSet, 'AbstractMutableSet', VOID, AbstractMutableCollection, [Collection, KtSet]);
   initMetadataForCompanion(Companion_1);
-  initMetadataForClass(ArrayList, 'ArrayList', ArrayList_init_$Create$, AbstractMutableList, [KtList, Collection]);
+  initMetadataForClass(ArrayList, 'ArrayList', ArrayList_init_$Create$, AbstractMutableList, [Collection, KtList]);
   initMetadataForClass(HashMap, 'HashMap', HashMap_init_$Create$, AbstractMutableMap, [KtMap]);
-  initMetadataForClass(HashMapEntrySetBase, 'HashMapEntrySetBase', VOID, AbstractMutableSet, [KtSet, Collection]);
+  initMetadataForClass(HashMapEntrySetBase, 'HashMapEntrySetBase', VOID, AbstractMutableSet, [Collection, KtSet]);
   initMetadataForClass(HashMapEntrySet, 'HashMapEntrySet', VOID, HashMapEntrySetBase);
-  initMetadataForClass(HashSet, 'HashSet', HashSet_init_$Create$, AbstractMutableSet, [KtSet, Collection]);
+  initMetadataForClass(HashSet, 'HashSet', HashSet_init_$Create$, AbstractMutableSet, [Collection, KtSet]);
   initMetadataForCompanion(Companion_2);
   initMetadataForClass(Itr, 'Itr');
   initMetadataForClass(KeysItr, 'KeysItr', VOID, Itr);
@@ -163,7 +163,7 @@ if (typeof Math.hypot === 'undefined') {
   initMetadataForInterface(InternalMap, 'InternalMap');
   initMetadataForClass(InternalHashMap, 'InternalHashMap', InternalHashMap_init_$Create$, VOID, [InternalMap]);
   initMetadataForClass(LinkedHashMap, 'LinkedHashMap', LinkedHashMap_init_$Create$, HashMap, [KtMap]);
-  initMetadataForClass(LinkedHashSet, 'LinkedHashSet', LinkedHashSet_init_$Create$, HashSet, [KtSet, Collection]);
+  initMetadataForClass(LinkedHashSet, 'LinkedHashSet', LinkedHashSet_init_$Create$, HashSet, [Collection, KtSet]);
   initMetadataForInterface(Continuation, 'Continuation');
   initMetadataForClass(InterceptedCoroutine, 'InterceptedCoroutine', VOID, VOID, [Continuation]);
   initMetadataForClass(CoroutineImpl, 'CoroutineImpl', VOID, InterceptedCoroutine, [Continuation]);
@@ -186,6 +186,7 @@ if (typeof Math.hypot === 'undefined') {
   initMetadataForClass(PrimitiveKClassImpl, 'PrimitiveKClassImpl', VOID, KClassImpl);
   initMetadataForObject(NothingKClassImpl, 'NothingKClassImpl', VOID, KClassImpl);
   initMetadataForClass(SimpleKClassImpl, 'SimpleKClassImpl', VOID, KClassImpl);
+  initMetadataForInterface(KProperty0, 'KProperty0');
   initMetadataForObject(PrimitiveClasses, 'PrimitiveClasses');
   initMetadataForClass(StringBuilder, 'StringBuilder', StringBuilder_init_$Create$_0, VOID, [CharSequence]);
   initMetadataForCompanion(Companion_3);
@@ -267,6 +268,8 @@ if (typeof Math.hypot === 'undefined') {
   initMetadataForObject(State, 'State');
   initMetadataForClass(LinesIterator, 'LinesIterator');
   initMetadataForClass(lineSequence$$inlined$Sequence$1);
+  initMetadataForClass(UnsafeLazyImpl, 'UnsafeLazyImpl');
+  initMetadataForObject(UNINITIALIZED_VALUE, 'UNINITIALIZED_VALUE');
   initMetadataForCompanion(Companion_10);
   initMetadataForClass(Failure, 'Failure');
   initMetadataForClass(NotImplementedError, 'NotImplementedError', NotImplementedError, Error_0);
@@ -1559,6 +1562,60 @@ if (typeof Math.hypot === 'undefined') {
   function numberRangeToNumber(start, endInclusive) {
     return new IntRange(start, endInclusive);
   }
+  function get_propertyRefClassMetadataCache() {
+    _init_properties_reflectRuntime_kt__5r4uu3();
+    return propertyRefClassMetadataCache;
+  }
+  var propertyRefClassMetadataCache;
+  function metadataObject() {
+    _init_properties_reflectRuntime_kt__5r4uu3();
+    return createMetadata('class', VOID, VOID, VOID, VOID, VOID);
+  }
+  function getPropertyCallableRef(name, paramCount, superType, getter, setter, linkageError) {
+    _init_properties_reflectRuntime_kt__5r4uu3();
+    getter.get = getter;
+    getter.set = setter;
+    getter.callableName = name;
+    // Inline function 'kotlin.js.unsafeCast' call
+    return getPropertyRefClass(getter, getKPropMetadata(paramCount, setter), superType);
+  }
+  function getPropertyRefClass(obj, metadata, superType) {
+    _init_properties_reflectRuntime_kt__5r4uu3();
+    obj.$metadata$ = metadata;
+    obj.constructor = obj;
+    var symbol = superType.Symbol;
+    if (symbol != null) {
+      // Inline function 'kotlin.js.asDynamic' call
+      obj[symbol] = true;
+    }
+    Object.assign(obj, superType.prototype);
+    return obj;
+  }
+  function getKPropMetadata(paramCount, setter) {
+    _init_properties_reflectRuntime_kt__5r4uu3();
+    return get_propertyRefClassMetadataCache()[paramCount][setter == null ? 0 : 1];
+  }
+  var properties_initialized_reflectRuntime_kt_inkhwd;
+  function _init_properties_reflectRuntime_kt__5r4uu3() {
+    if (!properties_initialized_reflectRuntime_kt_inkhwd) {
+      properties_initialized_reflectRuntime_kt_inkhwd = true;
+      // Inline function 'kotlin.arrayOf' call
+      // Inline function 'kotlin.js.unsafeCast' call
+      // Inline function 'kotlin.js.asDynamic' call
+      var tmp = [metadataObject(), metadataObject()];
+      // Inline function 'kotlin.arrayOf' call
+      // Inline function 'kotlin.js.unsafeCast' call
+      // Inline function 'kotlin.js.asDynamic' call
+      var tmp_0 = [metadataObject(), metadataObject()];
+      // Inline function 'kotlin.arrayOf' call
+      // Inline function 'kotlin.js.unsafeCast' call
+      // Inline function 'kotlin.js.asDynamic' call
+      // Inline function 'kotlin.arrayOf' call
+      // Inline function 'kotlin.js.unsafeCast' call
+      // Inline function 'kotlin.js.asDynamic' call
+      propertyRefClassMetadataCache = [tmp, tmp_0, [metadataObject(), metadataObject()]];
+    }
+  }
   function isArrayish(o) {
     return isJsArray(o) || isView(o);
   }
@@ -3173,6 +3230,9 @@ if (typeof Math.hypot === 'undefined') {
   function ClassCastException() {
     captureStack(this, ClassCastException);
   }
+  function lazy(initializer) {
+    return new UnsafeLazyImpl(initializer);
+  }
   function fillFrom(src, dst) {
     var srcLen = src.length;
     var dstLen = dst.length;
@@ -3301,6 +3361,8 @@ if (typeof Math.hypot === 'undefined') {
   protoOf(SimpleKClassImpl).k6 = function () {
     return this.r6_1;
   };
+  function KProperty0() {
+  }
   function get_functionClasses() {
     _init_properties_primitives_kt__3fums4();
     return functionClasses;
@@ -5348,6 +5410,29 @@ if (typeof Math.hypot === 'undefined') {
   protoOf(lineSequence$$inlined$Sequence$1).g = function () {
     return new LinesIterator(this.r9_1);
   };
+  function UnsafeLazyImpl(initializer) {
+    this.s9_1 = initializer;
+    this.t9_1 = UNINITIALIZED_VALUE_instance;
+  }
+  protoOf(UnsafeLazyImpl).r = function () {
+    if (this.t9_1 === UNINITIALIZED_VALUE_instance) {
+      this.t9_1 = ensureNotNull(this.s9_1)();
+      this.s9_1 = null;
+    }
+    return this.t9_1;
+  };
+  protoOf(UnsafeLazyImpl).u9 = function () {
+    return !(this.t9_1 === UNINITIALIZED_VALUE_instance);
+  };
+  protoOf(UnsafeLazyImpl).toString = function () {
+    return this.u9() ? toString_0(this.r()) : 'Lazy value not initialized yet.';
+  };
+  function UNINITIALIZED_VALUE() {
+  }
+  var UNINITIALIZED_VALUE_instance;
+  function UNINITIALIZED_VALUE_getInstance() {
+    return UNINITIALIZED_VALUE_instance;
+  }
   function _Result___init__impl__xyqfz8(value) {
     return value;
   }
@@ -5361,7 +5446,7 @@ if (typeof Math.hypot === 'undefined') {
   function Result__exceptionOrNull_impl_p6xea9($this) {
     var tmp;
     if (_Result___get_value__impl__bjfvqg($this) instanceof Failure) {
-      tmp = _Result___get_value__impl__bjfvqg($this).s9_1;
+      tmp = _Result___get_value__impl__bjfvqg($this).v9_1;
     } else {
       tmp = null;
     }
@@ -5374,22 +5459,22 @@ if (typeof Math.hypot === 'undefined') {
     return Companion_instance_10;
   }
   function Failure(exception) {
-    this.s9_1 = exception;
+    this.v9_1 = exception;
   }
   protoOf(Failure).equals = function (other) {
     var tmp;
     if (other instanceof Failure) {
-      tmp = equals(this.s9_1, other.s9_1);
+      tmp = equals(this.v9_1, other.v9_1);
     } else {
       tmp = false;
     }
     return tmp;
   };
   protoOf(Failure).hashCode = function () {
-    return hashCode_0(this.s9_1);
+    return hashCode_0(this.v9_1);
   };
   protoOf(Failure).toString = function () {
-    return 'Failure(' + this.s9_1.toString() + ')';
+    return 'Failure(' + this.v9_1.toString() + ')';
   };
   function createFailure(exception) {
     return new Failure(exception);
@@ -5419,6 +5504,7 @@ if (typeof Math.hypot === 'undefined') {
   Key_instance = new Key();
   Companion_instance_9 = new Companion_9();
   State_instance = new State();
+  UNINITIALIZED_VALUE_instance = new UNINITIALIZED_VALUE();
   Companion_instance_10 = new Companion_10();
   //endregion
   //region block: exports
@@ -5502,41 +5588,45 @@ if (typeof Math.hypot === 'undefined') {
   _.$_$.y2 = equals;
   _.$_$.z2 = getBooleanHashCode;
   _.$_$.a3 = getNumberHashCode;
-  _.$_$.b3 = getStringHashCode;
-  _.$_$.c3 = hashCode_0;
-  _.$_$.d3 = initMetadataForClass;
-  _.$_$.e3 = initMetadataForCompanion;
-  _.$_$.f3 = initMetadataForCoroutine;
-  _.$_$.g3 = initMetadataForFunctionReference;
-  _.$_$.h3 = initMetadataForInterface;
-  _.$_$.i3 = initMetadataForLambda;
-  _.$_$.j3 = initMetadataForObject;
-  _.$_$.k3 = isInterface;
-  _.$_$.l3 = numberToInt;
-  _.$_$.m3 = objectCreate;
-  _.$_$.n3 = protoOf;
-  _.$_$.o3 = toString_1;
-  _.$_$.p3 = round;
-  _.$_$.q3 = coerceIn;
-  _.$_$.r3 = coerceIn_0;
-  _.$_$.s3 = getKClassFromExpression;
-  _.$_$.t3 = replace;
-  _.$_$.u3 = toLongOrNull;
-  _.$_$.v3 = Enum;
-  _.$_$.w3 = Error_0;
-  _.$_$.x3 = Exception;
-  _.$_$.y3 = Long;
-  _.$_$.z3 = RuntimeException;
-  _.$_$.a4 = THROW_CCE;
-  _.$_$.b4 = Unit;
-  _.$_$.c4 = UnsupportedOperationException;
-  _.$_$.d4 = addSuppressed;
-  _.$_$.e4 = createFailure;
-  _.$_$.f4 = ensureNotNull;
-  _.$_$.g4 = isNaN_0;
-  _.$_$.h4 = noWhenBranchMatchedException;
-  _.$_$.i4 = stackTraceToString;
-  _.$_$.j4 = toString_0;
+  _.$_$.b3 = getPropertyCallableRef;
+  _.$_$.c3 = getStringHashCode;
+  _.$_$.d3 = hashCode_0;
+  _.$_$.e3 = initMetadataForClass;
+  _.$_$.f3 = initMetadataForCompanion;
+  _.$_$.g3 = initMetadataForCoroutine;
+  _.$_$.h3 = initMetadataForFunctionReference;
+  _.$_$.i3 = initMetadataForInterface;
+  _.$_$.j3 = initMetadataForLambda;
+  _.$_$.k3 = initMetadataForObject;
+  _.$_$.l3 = isInterface;
+  _.$_$.m3 = isNumber;
+  _.$_$.n3 = numberToInt;
+  _.$_$.o3 = objectCreate;
+  _.$_$.p3 = protoOf;
+  _.$_$.q3 = toString_1;
+  _.$_$.r3 = round;
+  _.$_$.s3 = coerceIn;
+  _.$_$.t3 = coerceIn_0;
+  _.$_$.u3 = getKClassFromExpression;
+  _.$_$.v3 = KProperty0;
+  _.$_$.w3 = replace;
+  _.$_$.x3 = toLongOrNull;
+  _.$_$.y3 = Enum;
+  _.$_$.z3 = Error_0;
+  _.$_$.a4 = Exception;
+  _.$_$.b4 = Long;
+  _.$_$.c4 = RuntimeException;
+  _.$_$.d4 = THROW_CCE;
+  _.$_$.e4 = Unit;
+  _.$_$.f4 = UnsupportedOperationException;
+  _.$_$.g4 = addSuppressed;
+  _.$_$.h4 = createFailure;
+  _.$_$.i4 = ensureNotNull;
+  _.$_$.j4 = isNaN_0;
+  _.$_$.k4 = lazy;
+  _.$_$.l4 = noWhenBranchMatchedException;
+  _.$_$.m4 = stackTraceToString;
+  _.$_$.n4 = toString_0;
   //endregion
   return _;
 }));