WorldWind Kotlin v2.0.1

[EMaksymenko]

WorldWind Kotlin 2.0.1

23 commits since 2.0.0.

Maintenance and platform release. Headline items: a new Kotlin/Wasm (wasmJs) browser target across every module, a reworked stale-while-revalidate caching layer with capacity eviction on all platforms, a flat, interoperable GeoPackage feature cache, and low-memory streaming COLLADA/KMZ loading for large photogrammetry.

implementation 'earth.worldwind:worldwind:2.0.1'

---

🌐 Kotlin/Wasm (wasmJs) browser target

• New wasmJs target across all modules (library, Compose, tutorials, samples). Browser code is shared between js and wasmJs in a webMain source set (~53 files) behind expect/actual seams: WebKgl / createWebKgl for the WebGL backend and MilStd2525Renderer for the mil-sym-ts / canvg bindings; only the generated externs, the per-target renderer adapter, and WeakRef stay per-target.
• kotlinx-browser replaces the kotlin-wrappers BOM; GeoJSON swapped to the wasm-capable spatialk library; pngj moved to jvmCommon.
• Source sets modernized via applyDefaultHierarchyTemplate (nonIos → web {js, wasmJs} + jvmCommon {jvm, android}).
• Web tutorials / compose-samples dev-server ports pinned (js + wasmJs) so the browser origin — and the origin-scoped IndexedDB cache — stays stable across runs.

💾 Cache: stale-while-revalidate + capacity eviction

• Tile freshness moved to a side table; effective SWR for image, elevation, and vector tiles.
• Conditional-GET (ETag / Last-Modified) revalidation for the elevation cache on all platforms.
• SWR for feature tiles with age-safe eviction; JS/iOS feature-store SWR freshness.
• Capacity eviction (maxBytes) for the JS/iOS tile stores and the GeoPackage tile store.
• Strict local/remote separation for image + elevation retrieval.
• CacheEvictionPolicy renamed to CachePolicy (type + attributes). (API change)

🗺️ GeoPackage / features

• Flat, two-way-interoperable GeoPackage feature cache.
• gpkg_web_service renamed to ww_web_service with automatic migration. (schema change)
• Drop upstream-vanished features on re-fetch; render a boundary-straddling feature in exactly one tile.

🧊 COLLADA / KMZ (large photogrammetry)

• Low-memory streaming .dae parse (custom pull tokenizer — never materializes the document or numeric bodies as strings), a configurable texture-size cap (default 2048; an 8192² atlas → 16 MB instead of 256 MB decoded), and zip-direct KMZ loading (no extraction to disk; textures decoded lazily and LRU-evicted).
• KMZ models are anchored from the doc.kml <Model> placement — position, scale, orientation, and <altitudeMode> (including the gx: sea-floor extensions).
• Terrain-relative altitude modes (CLAMP_TO_GROUND / RELATIVE_TO_GROUND) place the model on the resolved terrain and follow it as elevation streams in (rebuild keyed on vertical exaggeration / elevation timestamp / globe state).
• Y_UP models follow the KML model-facing convention (heading 0 → North-aligned) so geo-referenced KMZ tiles (e.g. OpenDroneMap) align out of the box; the COLLADA up-axis alone gives no geographic facing. Cosmetic for bare, manually-placed .dae (override with zRotation).

🛠️ Fixes & internals

• Reuse a single HTTP client per feature source (+ per-client tutorial SSL).
• WCS tutorial loads terrain once across all platforms.
• Gesture: skip pan frames with a non-finite meters-per-pixel.
• WGS coordinate parsing fix.
• e2e reopen tests for tile/coverage caches + NGA reference-validator pass.
• Remove dead getFeatureList code and the dormant JS WebTileCache; extract inlined FQN type references to imports.

---

Commits

• Add Kotlin/Wasm (wasmJs) browser target across all modules
• Deps: swap GeoJSON to wasm-capable spatialk; move pngj to jvmCommon
• Cleanup: extract inlined FQN type references to imports
• COLLADA: streaming parse, texture cap, and zip-direct KMZ loading
• Networking: reuse one HTTP client per feature source; per-client tutorial SSL
• WCS tutorial: load terrain once across all platforms
• Gesture: skip pan frames with a non-finite meters-per-pixel
• Cache: strict local/remote separation for image + elevation retrieval
• Cache: capacity eviction for the JS/iOS tile stores
• Coverage: conditional-GET revalidation for the elevation cache (all platforms)
• Cache: JS/iOS feature-store SWR freshness + capacity eviction
• Cache: rename CacheEvictionPolicy -> CachePolicy (type + attributes)
• Tests: e2e reopen for tile/coverage caches + NGA reference-validator pass
• GeoPackage: rename gpkg_web_service -> ww_web_service with migration
• Features: drop upstream-vanished features on re-fetch (GeoPackage)
• Features: render a boundary-straddling feature in exactly one tile
• JS: remove the dormant WebTileCache
• Cache: implement maxBytes for the GPKG tile store
• Features: flat, two-way-interoperable GeoPackage feature cache
• Cache: move tile freshness to side table + effective SWR for image/elevation/vector
• Fix WGS coordinates parsing
• Remove dead getFeatureList code
• Cache: stale-while-revalidate for feature tiles + age-safe eviction

Full changelog: v2.0.0...v2.0.1

---

This discussion was created from the release WorldWind Kotlin v2.0.1.