@navaramap/three-api 0.2.1 → 0.3.0

package/dist/featureGeometry.d.ts

@@ -33,10 +33,12 @@ export type PolylineGeometryData = {
     startLow: Float32Array;
     endHigh: Float32Array;
     endLow: Float32Array;
-    startNormal: Float32Array;
-    endNormalAndTextureCoordinateNormalizationX: Float32Array;
-    rightNormalAndTextureCoordinateNormalizationY: Float32Array;
+    startNormalAndLengthHigh: Float32Array;
+    endNormalAndSegmentLength: Float32Array;
+    rightNormalAndLineLength: Float32Array;
     indices: Uint32Array;
+    /** One entry of three RGBA texels per segment, for a dash pattern. */
+    lineSegments: Float32Array;
     extent: GeographicExtent;
 };
 /** Flat `[lng, lat, height, ...]`, or ECEF `[x, y, z, ...]` when geocentric. */

package/dist/index.js

@@ -1,20 +1,19 @@
-import e, { CameraFrustum as t, EllipsoidGeodesic as n, LLE as r, Ray as i, Transform as a, Vec2 as o, Vec3 as s, Window as c, angleToDegree as l, angleToRadian as u, buildPolygonGeometry as d, buildPolylineGeometry as f, eastNorthUpToFixedFrame as p, encodePosition as m, geodeticSurfaceNormal as h, geodeticToXyz as g, getHeightFromEllipsoid as _, getPickRay as v, getPlaneFromPointNormal as y, getRayPlaneIntersection as b, getWGS84Eccentricity as ee, getWGS84EccentricitySquared as te, getWGS84Flattening as ne, getWGS84SemiMajorAxis as re, getWGS84SemiMinorAxis as ie, northEastDownToFixedFrame as ae, northUpEastToFixedFrame as oe, northWestUpToFixedFrame as x, polygonGroundVolume as S, polylineGroundVolume as C, scaleToGeodeticSurface as w, screenToWorld as T, worldToScreen as E, xyzToGeodetic as D } from "@navaramap/engine-api";
-import { Euler as O, MathUtils as k, Matrix4 as A, Plane as j, Ray as M, Vector2 as N, Vector3 as P } from "three";
-//#region src/frames.ts
-function F() {
-	return new A().makeRotationY(Math.PI / 2);
-}
-function I(e, t) {
-	let n = new A().multiplyMatrices(e, new A().makeRotationFromEuler(new O(-k.degToRad(t.pitch ?? 0), -k.degToRad(t.heading ?? 0), k.degToRad(t.roll ?? 0), "YXZ")));
+import e, { CameraFrustum as t, EllipsoidGeodesic as n, LLE as r, Ray as i, Transform as a, Vec2 as o, Vec3 as s, Window as c, angleToDegree as l, angleToRadian as u, buildPolygonGeometry as d, buildPolylineGeometry as f, eastNorthUpToFixedFrame as p, encodePosition as m, geodeticSurfaceNormal as h, geodeticToXyz as g, getHeightFromEllipsoid as _, getPickRay as v, getPlaneFromPointNormal as y, getRayPlaneIntersection as b, getWGS84Eccentricity as ee, getWGS84EccentricitySquared as te, getWGS84Flattening as ne, getWGS84SemiMajorAxis as re, getWGS84SemiMinorAxis as ie, northEastDownToFixedFrame as ae, northUpEastToFixedFrame as oe, northWestUpToFixedFrame as se, polygonGroundVolume as x, polylineGroundVolume as S, scaleToGeodeticSurface as C, screenToWorld as w, worldToScreen as T, xyzToGeodetic as E } from "@navaramap/engine-api";
+import { Euler as D, MathUtils as O, Matrix4 as k, Plane as A, Ray as j, Vector2 as M, Vector3 as N } from "three";
+// src/frames.ts
+function P() {
+	return new k().makeRotationY(Math.PI / 2);
+}
+function F(e, t) {
+	let n = new k().multiplyMatrices(e, new k().makeRotationFromEuler(new D(-O.degToRad(t.pitch ?? 0), -O.degToRad(t.heading ?? 0), O.degToRad(t.roll ?? 0), "YXZ")));
 	if (t.scale !== void 0) {
 		let e = t.scale;
-		n.scale(typeof e == "number" ? new P(e, e, e) : new P(e.x, e.y, e.z));
+		n.scale(typeof e == "number" ? new N(e, e, e) : new N(e.x, e.y, e.z));
 	}
 	return n;
 }
-//#endregion
-//#region src/featureGeometry.ts
-function L(e) {
+// src/featureGeometry.ts
+function I(e) {
 	return {
 		west: l(e.west),
 		south: l(e.south),
@@ -22,20 +21,20 @@ function L(e) {
 		north: l(e.north)
 	};
 }
-function R(e) {
+function L(e) {
 	let t = 0;
 	for (let n of e) t += n.length;
 	let n = new Float64Array(t), r = 0;
 	for (let t of e) n.set(t, r), r += t.length;
 	return n;
 }
-function z(e) {
+function R(e) {
 	let t = new Uint32Array(e.length);
 	for (let n = 0; n < e.length; n++) t[n] = e[n].length / 3;
 	return t;
 }
-function B(e, t, n) {
-	let r = d(R(e), z(e), t, n);
+function z(e, t, n) {
+	let r = d(L(e), R(e), t, n);
 	if (r) try {
 		let e = r.position_3d_high(), t = r.position_3d_low(), n = r.extent;
 		if (!e || !t || !n) throw Error("buildPolygonGeometry: incomplete RTE geometry");
@@ -47,17 +46,17 @@ function B(e, t, n) {
 			normal: r.normal(),
 			scaleNormalAndCap: i,
 			indices: r.indices(),
-			extent: L(n)
+			extent: I(n)
 		};
 	} finally {
 		r.free();
 	}
 }
-function V(e, t, n, r) {
+function B(e, t, n, r) {
 	let i = f(e, t, n, r);
 	if (i) try {
-		let e = i.position_high(), t = i.position_low(), n = i.start_high(), r = i.start_low(), a = i.end_high(), o = i.end_low(), s = i.start_normals(), c = i.end_normal_and_texture_coordinate_normalization_x(), l = i.extent;
-		if (!e || !t || !n || !r || !a || !o || !s || !c || !l) throw Error("buildPolylineGeometry: incomplete RTE geometry");
+		let e = i.position_high(), t = i.position_low(), n = i.start_high(), r = i.start_low(), a = i.end_high(), o = i.end_low(), s = i.start_normal_and_length_high(), c = i.end_normal_and_segment_length(), l = i.line_segments(), u = i.extent;
+		if (!e || !t || !n || !r || !a || !o || !s || !c || !l || !u) throw Error("buildPolylineGeometry: incomplete RTE geometry");
 		return {
 			position: i.position(),
 			positionHigh: e,
@@ -66,65 +65,64 @@ function V(e, t, n, r) {
 			startLow: r,
 			endHigh: a,
 			endLow: o,
-			startNormal: s,
-			endNormalAndTextureCoordinateNormalizationX: c,
-			rightNormalAndTextureCoordinateNormalizationY: i.right_normal_and_texture_coordinate_normalization_y(),
+			startNormalAndLengthHigh: s,
+			endNormalAndSegmentLength: c,
+			rightNormalAndLineLength: i.right_normal_and_line_length(),
 			indices: i.indices(),
-			extent: L(l)
+			lineSegments: l,
+			extent: I(u)
 		};
 	} finally {
 		i.free();
 	}
 }
-function H(e, t, n) {
+function V(e, t, n) {
 	let r = e(t.min, t.max, u(n.west), u(n.south), u(n.east), u(n.north));
 	return [r[0], r[1]];
 }
+function H(e, t) {
+	return V(x, e, t);
+}
 function U(e, t) {
-	return H(S, e, t);
+	return V(S, e, t);
 }
+// src/intersection.ts
 function W(e, t) {
-	return H(C, e, t);
-}
-//#endregion
-//#region src/intersection.ts
-function G(e, t) {
-	let n = new s(e.x, e.y, e.z), r = new s(t.x, t.y, t.z), i = y(n, r), a = new P(i.normal.x, i.normal.y, i.normal.z), o = new j(a, -i.distance);
+	let n = new s(e.x, e.y, e.z), r = new s(t.x, t.y, t.z), i = y(n, r), a = new N(i.normal.x, i.normal.y, i.normal.z), o = new A(a, -i.distance);
 	return i.free(), o;
 }
-function K(e, n, r) {
+function G(e, n, r) {
 	let i = new c(e.width, e.height, e.pixelRatio);
 	i.width *= i.pixelRatio, i.height *= i.pixelRatio;
-	let s = new a(n.position.x, n.position.y, n.position.z, n.quaternion.x, n.quaternion.y, n.quaternion.z, n.quaternion.w, n.scale.x, n.scale.y, n.scale.z), l = new t(n.near, n.far, u(n.fov), n.aspect), d = v(i, s, l, new o(r.x, r.y)), f = new P(d.origin.x, d.origin.y, d.origin.z), p = new P(d.direction.x, d.direction.y, d.direction.z), m = new M(f, p);
+	let s = new a(n.position.x, n.position.y, n.position.z, n.quaternion.x, n.quaternion.y, n.quaternion.z, n.quaternion.w, n.scale.x, n.scale.y, n.scale.z), l = new t(n.near, n.far, u(n.fov), n.aspect), d = v(i, s, l, new o(r.x, r.y)), f = new N(d.origin.x, d.origin.y, d.origin.z), p = new N(d.direction.x, d.direction.y, d.direction.z), m = new j(f, p);
 	return d.free(), m;
 }
-function q(e, t) {
+function K(e, t) {
 	let n = new i(new s(e.origin.x, e.origin.y, e.origin.z), new s(e.direction.x, e.direction.y, e.direction.z)), r = y(new s(t.normal.x * -t.constant, t.normal.y * -t.constant, t.normal.z * -t.constant), new s(t.normal.x, t.normal.y, t.normal.z)), a = b(n, r);
 	if (a) {
-		let e = new P(a.x, a.y, a.z);
+		let e = new N(a.x, a.y, a.z);
 		return a.free(), e;
 	}
 }
-function se(e) {
+function ce(e) {
 	let t = new s(e.x, e.y, e.z);
 	return _(t);
 }
-//#endregion
-//#region src/rte.ts
-var ce = Object.freeze({ value: 1 });
-function le(e, t = new P(), n = new P()) {
+// src/rte.ts
+var le = Object.freeze({ value: 1 });
+function ue(e, t = new N(), n = new N()) {
 	let r = m(e.x, e.y, e.z);
 	return t.set(r.high.x, r.high.y, r.high.z), n.set(r.low.x, r.low.y, r.low.z), r.free(), {
 		high: t,
 		low: n
 	};
 }
-var ue = (e, t, n = new A()) => {
+var de = (e, t, n = new k()) => {
 	n.multiplyMatrices(t, e);
 	let r = n.elements;
 	return r[12] = 0, r[13] = 0, r[14] = 0, n;
 };
-function de(e, t, n = new P(), r = new A()) {
+function fe(e, t, n = new N(), r = new k()) {
 	r.multiplyMatrices(e, t), n.setFromMatrixPosition(r);
 	let i = r.elements;
 	return i[12] = 0, i[13] = 0, i[14] = 0, {
@@ -132,14 +130,14 @@ function de(e, t, n = new P(), r = new A()) {
 		rotationScale: r
 	};
 }
-var J = new A(), Y = new P(), fe = (e, t) => {
-	J.copy(t).invert(), Y.copy(e).applyMatrix4(J);
-	let n = m(Y.x, Y.y, Y.z), r = n.high, i = n.low, a = {
-		high: new P(r.x, r.y, r.z),
-		low: new P(i.x, i.y, i.z)
+var q = new k(), J = new N(), pe = (e, t) => {
+	q.copy(t).invert(), J.copy(e).applyMatrix4(q);
+	let n = m(J.x, J.y, J.z), r = n.high, i = n.low, a = {
+		high: new N(r.x, r.y, r.z),
+		low: new N(i.x, i.y, i.z)
 	};
 	return n.free(), a;
-}, pe = class {
+}, me = class {
 	_raw;
 	constructor(e, t) {
 		this._raw = new n(new r(u(e.lat), u(e.lng), e.height), new r(u(t.lat), u(t.lng), t.height));
@@ -192,96 +190,96 @@ var J = new A(), Y = new P(), fe = (e, t) => {
 	dispose() {
 		this._raw.free();
 	}
-};
-//#endregion
-//#region src/index.ts
-async function me() {
-	await e();
+}, Y = Symbol.for("@navaramap/engine-api/init");
+async function he() {
+	let t = globalThis;
+	t[Y] ??= e().catch((e) => {
+		throw t[Y] = void 0, e;
+	}), await t[Y];
 }
 function X(e) {
-	let t = g(new r(u(e.lat), u(e.lng), e.height)), n = new P(t.x, t.y, t.z);
+	let t = g(new r(u(e.lat), u(e.lng), e.height)), n = new N(t.x, t.y, t.z);
 	return t.free(), n;
 }
-function he(e) {
-	let t = new s(e.x, e.y, e.z), n = D(t), r = {
+function ge(e) {
+	let t = new s(e.x, e.y, e.z), n = E(t), r = {
 		lat: l(n.lat),
 		lng: l(n.lng),
 		height: n.height
 	};
 	return n.free(), r;
 }
-function ge(e) {
+function _e(e) {
 	return u(e);
 }
-function _e(e) {
+function ve(e) {
 	return l(e);
 }
-function ve(e, n, r) {
+function ye(e, n, r) {
 	let i = new c(e.width, e.height, e.pixelRatio);
 	i.width *= i.pixelRatio, i.height *= i.pixelRatio;
-	let s = new a(n.position.x, n.position.y, n.position.z, n.quaternion.x, n.quaternion.y, n.quaternion.z, n.quaternion.w, n.scale.x, n.scale.y, n.scale.z), l = new t(n.near, n.far, u(n.fov), n.aspect), d = T(i, s, l, new o(r.x, r.y));
+	let s = new a(n.position.x, n.position.y, n.position.z, n.quaternion.x, n.quaternion.y, n.quaternion.z, n.quaternion.w, n.scale.x, n.scale.y, n.scale.z), l = new t(n.near, n.far, u(n.fov), n.aspect), d = w(i, s, l, new o(r.x, r.y));
 	if (!d) return;
-	let f = new P(d.x, d.y, d.z);
+	let f = new N(d.x, d.y, d.z);
 	return d.free(), f;
 }
-function ye(e) {
-	let t = h(new r(u(e.lat), u(e.lng), e.height)), n = new P(t.x, t.y, t.z);
+function be(e) {
+	let t = h(new r(u(e.lat), u(e.lng), e.height)), n = new N(t.x, t.y, t.z);
 	return t.free(), n;
 }
-function be(e) {
-	let t = w(new s(e.x, e.y, e.z));
+function xe(e) {
+	let t = C(new s(e.x, e.y, e.z));
 	if (!t) return;
-	let n = new P(t.x, t.y, t.z);
+	let n = new N(t.x, t.y, t.z);
 	return t.free(), n;
 }
-function xe(e) {
+function Se(e) {
 	let t = new s(e.x, e.y, e.z), n = p(t);
-	return new A().fromArray(n);
+	return new k().fromArray(n);
 }
-function Se(e) {
+function Z(e) {
 	let t = new s(e.x, e.y, e.z), n = ae(t);
-	return new A().fromArray(n);
+	return new k().fromArray(n);
 }
-function Z(e) {
+function Q(e) {
 	let t = new s(e.x, e.y, e.z), n = oe(t);
-	return new A().fromArray(n);
+	return new k().fromArray(n);
 }
 function Ce(e) {
-	let t = new s(e.x, e.y, e.z), n = x(t);
-	return new A().fromArray(n);
-}
-function Q(e) {
-	return Z(e).multiply(F());
+	let t = new s(e.x, e.y, e.z), n = se(t);
+	return new k().fromArray(n);
 }
 function $(e) {
-	return I(Q(X({
+	return Q(e).multiply(P());
+}
+function we(e) {
+	return F($(X({
 		lng: e.lng,
 		lat: e.lat,
 		height: e.height ?? 0
 	})), e);
 }
-function we(e, n, r) {
+function Te(e, n, r) {
 	let i = new c(e.width, e.height, e.pixelRatio);
 	i.width *= i.pixelRatio, i.height *= i.pixelRatio;
-	let o = new a(n.position.x, n.position.y, n.position.z, n.quaternion.x, n.quaternion.y, n.quaternion.z, n.quaternion.w, n.scale.x, n.scale.y, n.scale.z), l = new t(n.near, n.far, u(n.fov), n.aspect), d = E(i, o, l, new s(r.x, r.y, r.z));
+	let o = new a(n.position.x, n.position.y, n.position.z, n.quaternion.x, n.quaternion.y, n.quaternion.z, n.quaternion.w, n.scale.x, n.scale.y, n.scale.z), l = new t(n.near, n.far, u(n.fov), n.aspect), d = T(i, o, l, new s(r.x, r.y, r.z));
 	if (!d) return;
-	let f = new N(d.x, d.y);
+	let f = new M(d.x, d.y);
 	return d.free(), f;
 }
-function Te() {
+function Ee() {
 	return re();
 }
-function Ee() {
+function De() {
 	return ie();
 }
-function De() {
+function Oe() {
 	return te();
 }
-function Oe() {
+function ke() {
 	return ne();
 }
-function ke() {
+function Ae() {
 	return ee();
 }
-//#endregion
-export { pe as EllipsoidGeodesic, ce as RTE_ONE_UNIFORM, B as buildPolygonGeometry, V as buildPolylineGeometry, fe as calcCameraPosition, ue as calcModelMatrixRTE, de as composeWorldMatrixForRTE, ve as convertScreenToWorld, we as convertWorldToScreen, ge as degreeToRadian, xe as eastNorthUpToFixedFrame, le as encodePositionRTE, ye as geodeticSurfaceNormal, X as geodeticToVector3, se as getHeightFromEllipsoid, K as getPickRay, G as getPlaneFromPointNormal, q as getRayPlaneIntersection, ke as getWGS84Eccentricity, De as getWGS84EccentricitySquared, Oe as getWGS84Flattening, Te as getWGS84SemiMajorAxis, Ee as getWGS84SemiMinorAxis, $ as headingPitchRollToFixedFrame, me as initNavaraApi, Se as northEastDownToFixedFrame, Z as northUpEastToFixedFrame, Ce as northWestUpToFixedFrame, U as polygonGroundVolume, W as polylineGroundVolume, _e as radianToDegree, be as scaleToGeodeticSurface, he as vector3ToGeodetic, Q as westUpNorthToFixedFrame };
+export { me as EllipsoidGeodesic, le as RTE_ONE_UNIFORM, z as buildPolygonGeometry, B as buildPolylineGeometry, pe as calcCameraPosition, de as calcModelMatrixRTE, fe as composeWorldMatrixForRTE, ye as convertScreenToWorld, Te as convertWorldToScreen, _e as degreeToRadian, Se as eastNorthUpToFixedFrame, ue as encodePositionRTE, be as geodeticSurfaceNormal, X as geodeticToVector3, ce as getHeightFromEllipsoid, G as getPickRay, W as getPlaneFromPointNormal, K as getRayPlaneIntersection, Ae as getWGS84Eccentricity, Oe as getWGS84EccentricitySquared, ke as getWGS84Flattening, Ee as getWGS84SemiMajorAxis, De as getWGS84SemiMinorAxis, we as headingPitchRollToFixedFrame, he as initNavaraApi, Z as northEastDownToFixedFrame, Q as northUpEastToFixedFrame, Ce as northWestUpToFixedFrame, H as polygonGroundVolume, U as polylineGroundVolume, ve as radianToDegree, xe as scaleToGeodeticSurface, ge as vector3ToGeodetic, $ as westUpNorthToFixedFrame };

package/dist/index.umd.cjs

@@ -1 +1 @@
-(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports,require("@navaramap/engine-api"),require("three")):typeof define==`function`&&define.amd?define([`exports`,`@navaramap/engine-api`,`three`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.NavaraThreeApi={},e._navaramap_engine_api,e.three))})(this,function(e,t,n){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var r=Object.create,i=Object.defineProperty,a=Object.getOwnPropertyDescriptor,o=Object.getOwnPropertyNames,s=Object.getPrototypeOf,c=Object.prototype.hasOwnProperty,l=(e,t,n,r)=>{if(t&&typeof t==`object`||typeof t==`function`)for(var s=o(t),l=0,u=s.length,d;l<u;l++)d=s[l],!c.call(e,d)&&d!==n&&i(e,d,{get:(e=>t[e]).bind(null,d),enumerable:!(r=a(t,d))||r.enumerable});return e};t=((e,t,n)=>(n=e==null?{}:r(s(e)),l(t||!e||!e.__esModule||!c.call(e,`default`)?i(n,`default`,{value:e,enumerable:!0}):n,e)))(t,1);function u(){return new n.Matrix4().makeRotationY(Math.PI/2)}function d(e,t){let r=new n.Matrix4().multiplyMatrices(e,new n.Matrix4().makeRotationFromEuler(new n.Euler(-n.MathUtils.degToRad(t.pitch??0),-n.MathUtils.degToRad(t.heading??0),n.MathUtils.degToRad(t.roll??0),`YXZ`)));if(t.scale!==void 0){let e=t.scale;r.scale(typeof e==`number`?new n.Vector3(e,e,e):new n.Vector3(e.x,e.y,e.z))}return r}function f(e){return{west:(0,t.angleToDegree)(e.west),south:(0,t.angleToDegree)(e.south),east:(0,t.angleToDegree)(e.east),north:(0,t.angleToDegree)(e.north)}}function p(e){let t=0;for(let n of e)t+=n.length;let n=new Float64Array(t),r=0;for(let t of e)n.set(t,r),r+=t.length;return n}function m(e){let t=new Uint32Array(e.length);for(let n=0;n<e.length;n++)t[n]=e[n].length/3;return t}function h(e,n,r){let i=(0,t.buildPolygonGeometry)(p(e),m(e),n,r);if(i)try{let e=i.position_3d_high(),t=i.position_3d_low(),n=i.extent;if(!e||!t||!n)throw Error(`buildPolygonGeometry: incomplete RTE geometry`);let r=i.scale_normal_and_cap();if(!r)throw Error(`buildPolygonGeometry: missing extrusion attribute`);return{positionHigh:e,positionLow:t,normal:i.normal(),scaleNormalAndCap:r,indices:i.indices(),extent:f(n)}}finally{i.free()}}function g(e,n,r,i){let a=(0,t.buildPolylineGeometry)(e,n,r,i);if(a)try{let e=a.position_high(),t=a.position_low(),n=a.start_high(),r=a.start_low(),i=a.end_high(),o=a.end_low(),s=a.start_normals(),c=a.end_normal_and_texture_coordinate_normalization_x(),l=a.extent;if(!e||!t||!n||!r||!i||!o||!s||!c||!l)throw Error(`buildPolylineGeometry: incomplete RTE geometry`);return{position:a.position(),positionHigh:e,positionLow:t,startHigh:n,startLow:r,endHigh:i,endLow:o,startNormal:s,endNormalAndTextureCoordinateNormalizationX:c,rightNormalAndTextureCoordinateNormalizationY:a.right_normal_and_texture_coordinate_normalization_y(),indices:a.indices(),extent:f(l)}}finally{a.free()}}function _(e,n,r){let i=e(n.min,n.max,(0,t.angleToRadian)(r.west),(0,t.angleToRadian)(r.south),(0,t.angleToRadian)(r.east),(0,t.angleToRadian)(r.north));return[i[0],i[1]]}function v(e,n){return _(t.polygonGroundVolume,e,n)}function y(e,n){return _(t.polylineGroundVolume,e,n)}function b(e,r){let i=new t.Vec3(e.x,e.y,e.z),a=new t.Vec3(r.x,r.y,r.z),o=(0,t.getPlaneFromPointNormal)(i,a),s=new n.Vector3(o.normal.x,o.normal.y,o.normal.z),c=new n.Plane(s,-o.distance);return o.free(),c}function x(e,r,i){let a=new t.Window(e.width,e.height,e.pixelRatio);a.width*=a.pixelRatio,a.height*=a.pixelRatio;let o=new t.Transform(r.position.x,r.position.y,r.position.z,r.quaternion.x,r.quaternion.y,r.quaternion.z,r.quaternion.w,r.scale.x,r.scale.y,r.scale.z),s=new t.CameraFrustum(r.near,r.far,(0,t.angleToRadian)(r.fov),r.aspect),c=(0,t.getPickRay)(a,o,s,new t.Vec2(i.x,i.y)),l=new n.Vector3(c.origin.x,c.origin.y,c.origin.z),u=new n.Vector3(c.direction.x,c.direction.y,c.direction.z),d=new n.Ray(l,u);return c.free(),d}function S(e,r){let i=new t.Ray(new t.Vec3(e.origin.x,e.origin.y,e.origin.z),new t.Vec3(e.direction.x,e.direction.y,e.direction.z)),a=(0,t.getPlaneFromPointNormal)(new t.Vec3(r.normal.x*-r.constant,r.normal.y*-r.constant,r.normal.z*-r.constant),new t.Vec3(r.normal.x,r.normal.y,r.normal.z)),o=(0,t.getRayPlaneIntersection)(i,a);if(o){let e=new n.Vector3(o.x,o.y,o.z);return o.free(),e}}function C(e){let n=new t.Vec3(e.x,e.y,e.z);return(0,t.getHeightFromEllipsoid)(n)}var w=Object.freeze({value:1});function T(e,r=new n.Vector3,i=new n.Vector3){let a=(0,t.encodePosition)(e.x,e.y,e.z);return r.set(a.high.x,a.high.y,a.high.z),i.set(a.low.x,a.low.y,a.low.z),a.free(),{high:r,low:i}}var E=(e,t,r=new n.Matrix4)=>{r.multiplyMatrices(t,e);let i=r.elements;return i[12]=0,i[13]=0,i[14]=0,r};function D(e,t,r=new n.Vector3,i=new n.Matrix4){i.multiplyMatrices(e,t),r.setFromMatrixPosition(i);let a=i.elements;return a[12]=0,a[13]=0,a[14]=0,{position:r,rotationScale:i}}var O=new n.Matrix4,k=new n.Vector3,A=(e,r)=>{O.copy(r).invert(),k.copy(e).applyMatrix4(O);let i=(0,t.encodePosition)(k.x,k.y,k.z),a=i.high,o=i.low,s={high:new n.Vector3(a.x,a.y,a.z),low:new n.Vector3(o.x,o.y,o.z)};return i.free(),s},j=class{_raw;constructor(e,n){this._raw=new t.EllipsoidGeodesic(new t.LLE((0,t.angleToRadian)(e.lat),(0,t.angleToRadian)(e.lng),e.height),new t.LLE((0,t.angleToRadian)(n.lat),(0,t.angleToRadian)(n.lng),n.height))}get distance(){return this._raw.distance}get converged(){return this._raw.converged}get startHeading(){return(0,t.angleToDegree)(this._raw.start_heading)}get endHeading(){return(0,t.angleToDegree)(this._raw.end_heading)}get start(){let e=this._raw.start;return{lat:(0,t.angleToDegree)(e.lat),lng:(0,t.angleToDegree)(e.lng),height:e.height}}get end(){let e=this._raw.end;return{lat:(0,t.angleToDegree)(e.lat),lng:(0,t.angleToDegree)(e.lng),height:e.height}}interpolatePoints(e){let n=this._raw.interpolateGeodeticPoints(e??null),r=[];for(let e of n)r.push({lat:(0,t.angleToDegree)(e.lat),lng:(0,t.angleToDegree)(e.lng),height:e.height}),e.free();return r}interpolateDistance(e){let n=this._raw.interpolateDistance(e),r={lat:(0,t.angleToDegree)(n.lat),lng:(0,t.angleToDegree)(n.lng),height:n.height};return n.free(),r}dispose(){this._raw.free()}};async function M(){await(0,t.default)()}function N(e){let r=(0,t.geodeticToXyz)(new t.LLE((0,t.angleToRadian)(e.lat),(0,t.angleToRadian)(e.lng),e.height)),i=new n.Vector3(r.x,r.y,r.z);return r.free(),i}function P(e){let n=new t.Vec3(e.x,e.y,e.z),r=(0,t.xyzToGeodetic)(n),i={lat:(0,t.angleToDegree)(r.lat),lng:(0,t.angleToDegree)(r.lng),height:r.height};return r.free(),i}function F(e){return(0,t.angleToRadian)(e)}function I(e){return(0,t.angleToDegree)(e)}function L(e,r,i){let a=new t.Window(e.width,e.height,e.pixelRatio);a.width*=a.pixelRatio,a.height*=a.pixelRatio;let o=new t.Transform(r.position.x,r.position.y,r.position.z,r.quaternion.x,r.quaternion.y,r.quaternion.z,r.quaternion.w,r.scale.x,r.scale.y,r.scale.z),s=new t.CameraFrustum(r.near,r.far,(0,t.angleToRadian)(r.fov),r.aspect),c=(0,t.screenToWorld)(a,o,s,new t.Vec2(i.x,i.y));if(!c)return;let l=new n.Vector3(c.x,c.y,c.z);return c.free(),l}function R(e){let r=(0,t.geodeticSurfaceNormal)(new t.LLE((0,t.angleToRadian)(e.lat),(0,t.angleToRadian)(e.lng),e.height)),i=new n.Vector3(r.x,r.y,r.z);return r.free(),i}function z(e){let r=(0,t.scaleToGeodeticSurface)(new t.Vec3(e.x,e.y,e.z));if(!r)return;let i=new n.Vector3(r.x,r.y,r.z);return r.free(),i}function B(e){let r=new t.Vec3(e.x,e.y,e.z),i=(0,t.eastNorthUpToFixedFrame)(r);return new n.Matrix4().fromArray(i)}function V(e){let r=new t.Vec3(e.x,e.y,e.z),i=(0,t.northEastDownToFixedFrame)(r);return new n.Matrix4().fromArray(i)}function H(e){let r=new t.Vec3(e.x,e.y,e.z),i=(0,t.northUpEastToFixedFrame)(r);return new n.Matrix4().fromArray(i)}function U(e){let r=new t.Vec3(e.x,e.y,e.z),i=(0,t.northWestUpToFixedFrame)(r);return new n.Matrix4().fromArray(i)}function W(e){return H(e).multiply(u())}function G(e){return d(W(N({lng:e.lng,lat:e.lat,height:e.height??0})),e)}function K(e,r,i){let a=new t.Window(e.width,e.height,e.pixelRatio);a.width*=a.pixelRatio,a.height*=a.pixelRatio;let o=new t.Transform(r.position.x,r.position.y,r.position.z,r.quaternion.x,r.quaternion.y,r.quaternion.z,r.quaternion.w,r.scale.x,r.scale.y,r.scale.z),s=new t.CameraFrustum(r.near,r.far,(0,t.angleToRadian)(r.fov),r.aspect),c=(0,t.worldToScreen)(a,o,s,new t.Vec3(i.x,i.y,i.z));if(!c)return;let l=new n.Vector2(c.x,c.y);return c.free(),l}function q(){return(0,t.getWGS84SemiMajorAxis)()}function J(){return(0,t.getWGS84SemiMinorAxis)()}function Y(){return(0,t.getWGS84EccentricitySquared)()}function X(){return(0,t.getWGS84Flattening)()}function Z(){return(0,t.getWGS84Eccentricity)()}e.EllipsoidGeodesic=j,e.RTE_ONE_UNIFORM=w,e.buildPolygonGeometry=h,e.buildPolylineGeometry=g,e.calcCameraPosition=A,e.calcModelMatrixRTE=E,e.composeWorldMatrixForRTE=D,e.convertScreenToWorld=L,e.convertWorldToScreen=K,e.degreeToRadian=F,e.eastNorthUpToFixedFrame=B,e.encodePositionRTE=T,e.geodeticSurfaceNormal=R,e.geodeticToVector3=N,e.getHeightFromEllipsoid=C,e.getPickRay=x,e.getPlaneFromPointNormal=b,e.getRayPlaneIntersection=S,e.getWGS84Eccentricity=Z,e.getWGS84EccentricitySquared=Y,e.getWGS84Flattening=X,e.getWGS84SemiMajorAxis=q,e.getWGS84SemiMinorAxis=J,e.headingPitchRollToFixedFrame=G,e.initNavaraApi=M,e.northEastDownToFixedFrame=V,e.northUpEastToFixedFrame=H,e.northWestUpToFixedFrame=U,e.polygonGroundVolume=v,e.polylineGroundVolume=y,e.radianToDegree=I,e.scaleToGeodeticSurface=z,e.vector3ToGeodetic=P,e.westUpNorthToFixedFrame=W});
+(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports,require("@navaramap/engine-api"),require("three")):typeof define==`function`&&define.amd?define([`exports`,`@navaramap/engine-api`,`three`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.NavaraThreeApi={},e._navaramap_engine_api,e.three))})(this,function(e,t,n){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var r=Object.create,i=Object.defineProperty,a=Object.getOwnPropertyDescriptor,o=Object.getOwnPropertyNames,s=Object.getPrototypeOf,c=Object.prototype.hasOwnProperty,l=(e,t,n,r)=>{if(t&&typeof t==`object`||typeof t==`function`)for(var s=o(t),l=0,u=s.length,d;l<u;l++)d=s[l],!c.call(e,d)&&d!==n&&i(e,d,{get:(e=>t[e]).bind(null,d),enumerable:!(r=a(t,d))||r.enumerable});return e};t=((e,t,n)=>(n=e==null?{}:r(s(e)),l(i(n,`default`,{value:e,enumerable:!0}),e)))(t,1);function u(){return new n.Matrix4().makeRotationY(Math.PI/2)}function d(e,t){let r=new n.Matrix4().multiplyMatrices(e,new n.Matrix4().makeRotationFromEuler(new n.Euler(-n.MathUtils.degToRad(t.pitch??0),-n.MathUtils.degToRad(t.heading??0),n.MathUtils.degToRad(t.roll??0),`YXZ`)));if(t.scale!==void 0){let e=t.scale;r.scale(typeof e==`number`?new n.Vector3(e,e,e):new n.Vector3(e.x,e.y,e.z))}return r}function f(e){return{west:(0,t.angleToDegree)(e.west),south:(0,t.angleToDegree)(e.south),east:(0,t.angleToDegree)(e.east),north:(0,t.angleToDegree)(e.north)}}function p(e){let t=0;for(let n of e)t+=n.length;let n=new Float64Array(t),r=0;for(let t of e)n.set(t,r),r+=t.length;return n}function m(e){let t=new Uint32Array(e.length);for(let n=0;n<e.length;n++)t[n]=e[n].length/3;return t}function h(e,n,r){let i=(0,t.buildPolygonGeometry)(p(e),m(e),n,r);if(i)try{let e=i.position_3d_high(),t=i.position_3d_low(),n=i.extent;if(!e||!t||!n)throw Error(`buildPolygonGeometry: incomplete RTE geometry`);let r=i.scale_normal_and_cap();if(!r)throw Error(`buildPolygonGeometry: missing extrusion attribute`);return{positionHigh:e,positionLow:t,normal:i.normal(),scaleNormalAndCap:r,indices:i.indices(),extent:f(n)}}finally{i.free()}}function g(e,n,r,i){let a=(0,t.buildPolylineGeometry)(e,n,r,i);if(a)try{let e=a.position_high(),t=a.position_low(),n=a.start_high(),r=a.start_low(),i=a.end_high(),o=a.end_low(),s=a.start_normal_and_length_high(),c=a.end_normal_and_segment_length(),l=a.line_segments(),u=a.extent;if(!e||!t||!n||!r||!i||!o||!s||!c||!l||!u)throw Error(`buildPolylineGeometry: incomplete RTE geometry`);return{position:a.position(),positionHigh:e,positionLow:t,startHigh:n,startLow:r,endHigh:i,endLow:o,startNormalAndLengthHigh:s,endNormalAndSegmentLength:c,rightNormalAndLineLength:a.right_normal_and_line_length(),indices:a.indices(),lineSegments:l,extent:f(u)}}finally{a.free()}}function _(e,n,r){let i=e(n.min,n.max,(0,t.angleToRadian)(r.west),(0,t.angleToRadian)(r.south),(0,t.angleToRadian)(r.east),(0,t.angleToRadian)(r.north));return[i[0],i[1]]}function v(e,n){return _(t.polygonGroundVolume,e,n)}function y(e,n){return _(t.polylineGroundVolume,e,n)}function b(e,r){let i=new t.Vec3(e.x,e.y,e.z),a=new t.Vec3(r.x,r.y,r.z),o=(0,t.getPlaneFromPointNormal)(i,a),s=new n.Vector3(o.normal.x,o.normal.y,o.normal.z),c=new n.Plane(s,-o.distance);return o.free(),c}function x(e,r,i){let a=new t.Window(e.width,e.height,e.pixelRatio);a.width*=a.pixelRatio,a.height*=a.pixelRatio;let o=new t.Transform(r.position.x,r.position.y,r.position.z,r.quaternion.x,r.quaternion.y,r.quaternion.z,r.quaternion.w,r.scale.x,r.scale.y,r.scale.z),s=new t.CameraFrustum(r.near,r.far,(0,t.angleToRadian)(r.fov),r.aspect),c=(0,t.getPickRay)(a,o,s,new t.Vec2(i.x,i.y)),l=new n.Vector3(c.origin.x,c.origin.y,c.origin.z),u=new n.Vector3(c.direction.x,c.direction.y,c.direction.z),d=new n.Ray(l,u);return c.free(),d}function S(e,r){let i=new t.Ray(new t.Vec3(e.origin.x,e.origin.y,e.origin.z),new t.Vec3(e.direction.x,e.direction.y,e.direction.z)),a=(0,t.getPlaneFromPointNormal)(new t.Vec3(r.normal.x*-r.constant,r.normal.y*-r.constant,r.normal.z*-r.constant),new t.Vec3(r.normal.x,r.normal.y,r.normal.z)),o=(0,t.getRayPlaneIntersection)(i,a);if(o){let e=new n.Vector3(o.x,o.y,o.z);return o.free(),e}}function C(e){let n=new t.Vec3(e.x,e.y,e.z);return(0,t.getHeightFromEllipsoid)(n)}var w=Object.freeze({value:1});function T(e,r=new n.Vector3,i=new n.Vector3){let a=(0,t.encodePosition)(e.x,e.y,e.z);return r.set(a.high.x,a.high.y,a.high.z),i.set(a.low.x,a.low.y,a.low.z),a.free(),{high:r,low:i}}var E=(e,t,r=new n.Matrix4)=>{r.multiplyMatrices(t,e);let i=r.elements;return i[12]=0,i[13]=0,i[14]=0,r};function D(e,t,r=new n.Vector3,i=new n.Matrix4){i.multiplyMatrices(e,t),r.setFromMatrixPosition(i);let a=i.elements;return a[12]=0,a[13]=0,a[14]=0,{position:r,rotationScale:i}}var O=new n.Matrix4,k=new n.Vector3,A=(e,r)=>{O.copy(r).invert(),k.copy(e).applyMatrix4(O);let i=(0,t.encodePosition)(k.x,k.y,k.z),a=i.high,o=i.low,s={high:new n.Vector3(a.x,a.y,a.z),low:new n.Vector3(o.x,o.y,o.z)};return i.free(),s},j=class{_raw;constructor(e,n){this._raw=new t.EllipsoidGeodesic(new t.LLE((0,t.angleToRadian)(e.lat),(0,t.angleToRadian)(e.lng),e.height),new t.LLE((0,t.angleToRadian)(n.lat),(0,t.angleToRadian)(n.lng),n.height))}get distance(){return this._raw.distance}get converged(){return this._raw.converged}get startHeading(){return(0,t.angleToDegree)(this._raw.start_heading)}get endHeading(){return(0,t.angleToDegree)(this._raw.end_heading)}get start(){let e=this._raw.start;return{lat:(0,t.angleToDegree)(e.lat),lng:(0,t.angleToDegree)(e.lng),height:e.height}}get end(){let e=this._raw.end;return{lat:(0,t.angleToDegree)(e.lat),lng:(0,t.angleToDegree)(e.lng),height:e.height}}interpolatePoints(e){let n=this._raw.interpolateGeodeticPoints(e??null),r=[];for(let e of n)r.push({lat:(0,t.angleToDegree)(e.lat),lng:(0,t.angleToDegree)(e.lng),height:e.height}),e.free();return r}interpolateDistance(e){let n=this._raw.interpolateDistance(e),r={lat:(0,t.angleToDegree)(n.lat),lng:(0,t.angleToDegree)(n.lng),height:n.height};return n.free(),r}dispose(){this._raw.free()}},M=Symbol.for(`@navaramap/engine-api/init`);async function N(){let e=globalThis;e[M]??=(0,t.default)().catch(t=>{throw e[M]=void 0,t}),await e[M]}function P(e){let r=(0,t.geodeticToXyz)(new t.LLE((0,t.angleToRadian)(e.lat),(0,t.angleToRadian)(e.lng),e.height)),i=new n.Vector3(r.x,r.y,r.z);return r.free(),i}function F(e){let n=new t.Vec3(e.x,e.y,e.z),r=(0,t.xyzToGeodetic)(n),i={lat:(0,t.angleToDegree)(r.lat),lng:(0,t.angleToDegree)(r.lng),height:r.height};return r.free(),i}function I(e){return(0,t.angleToRadian)(e)}function L(e){return(0,t.angleToDegree)(e)}function R(e,r,i){let a=new t.Window(e.width,e.height,e.pixelRatio);a.width*=a.pixelRatio,a.height*=a.pixelRatio;let o=new t.Transform(r.position.x,r.position.y,r.position.z,r.quaternion.x,r.quaternion.y,r.quaternion.z,r.quaternion.w,r.scale.x,r.scale.y,r.scale.z),s=new t.CameraFrustum(r.near,r.far,(0,t.angleToRadian)(r.fov),r.aspect),c=(0,t.screenToWorld)(a,o,s,new t.Vec2(i.x,i.y));if(!c)return;let l=new n.Vector3(c.x,c.y,c.z);return c.free(),l}function z(e){let r=(0,t.geodeticSurfaceNormal)(new t.LLE((0,t.angleToRadian)(e.lat),(0,t.angleToRadian)(e.lng),e.height)),i=new n.Vector3(r.x,r.y,r.z);return r.free(),i}function B(e){let r=(0,t.scaleToGeodeticSurface)(new t.Vec3(e.x,e.y,e.z));if(!r)return;let i=new n.Vector3(r.x,r.y,r.z);return r.free(),i}function V(e){let r=new t.Vec3(e.x,e.y,e.z),i=(0,t.eastNorthUpToFixedFrame)(r);return new n.Matrix4().fromArray(i)}function H(e){let r=new t.Vec3(e.x,e.y,e.z),i=(0,t.northEastDownToFixedFrame)(r);return new n.Matrix4().fromArray(i)}function U(e){let r=new t.Vec3(e.x,e.y,e.z),i=(0,t.northUpEastToFixedFrame)(r);return new n.Matrix4().fromArray(i)}function W(e){let r=new t.Vec3(e.x,e.y,e.z),i=(0,t.northWestUpToFixedFrame)(r);return new n.Matrix4().fromArray(i)}function G(e){return U(e).multiply(u())}function K(e){return d(G(P({lng:e.lng,lat:e.lat,height:e.height??0})),e)}function q(e,r,i){let a=new t.Window(e.width,e.height,e.pixelRatio);a.width*=a.pixelRatio,a.height*=a.pixelRatio;let o=new t.Transform(r.position.x,r.position.y,r.position.z,r.quaternion.x,r.quaternion.y,r.quaternion.z,r.quaternion.w,r.scale.x,r.scale.y,r.scale.z),s=new t.CameraFrustum(r.near,r.far,(0,t.angleToRadian)(r.fov),r.aspect),c=(0,t.worldToScreen)(a,o,s,new t.Vec3(i.x,i.y,i.z));if(!c)return;let l=new n.Vector2(c.x,c.y);return c.free(),l}function J(){return(0,t.getWGS84SemiMajorAxis)()}function Y(){return(0,t.getWGS84SemiMinorAxis)()}function X(){return(0,t.getWGS84EccentricitySquared)()}function Z(){return(0,t.getWGS84Flattening)()}function Q(){return(0,t.getWGS84Eccentricity)()}e.EllipsoidGeodesic=j,e.RTE_ONE_UNIFORM=w,e.buildPolygonGeometry=h,e.buildPolylineGeometry=g,e.calcCameraPosition=A,e.calcModelMatrixRTE=E,e.composeWorldMatrixForRTE=D,e.convertScreenToWorld=R,e.convertWorldToScreen=q,e.degreeToRadian=I,e.eastNorthUpToFixedFrame=V,e.encodePositionRTE=T,e.geodeticSurfaceNormal=z,e.geodeticToVector3=P,e.getHeightFromEllipsoid=C,e.getPickRay=x,e.getPlaneFromPointNormal=b,e.getRayPlaneIntersection=S,e.getWGS84Eccentricity=Q,e.getWGS84EccentricitySquared=X,e.getWGS84Flattening=Z,e.getWGS84SemiMajorAxis=J,e.getWGS84SemiMinorAxis=Y,e.headingPitchRollToFixedFrame=K,e.initNavaraApi=N,e.northEastDownToFixedFrame=H,e.northUpEastToFixedFrame=U,e.northWestUpToFixedFrame=W,e.polygonGroundVolume=v,e.polylineGroundVolume=y,e.radianToDegree=L,e.scaleToGeodeticSurface=B,e.vector3ToGeodetic=F,e.westUpNorthToFixedFrame=G});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@navaramap/three-api",
   "type": "module",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "main": "dist/index.umd.cjs",
   "module": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -22,12 +22,12 @@
     "three": ">=0.183.0"
   },
   "dependencies": {
-    "@navaramap/core": "0.2.1",
-    "@navaramap/engine-api": "0.2.1"
+    "@navaramap/core": "0.3.0",
+    "@navaramap/engine-api": "0.3.0"
   },
   "devDependencies": {
-    "@types/three": "0.185.4",
-    "three": "0.185.1"
+    "@types/three": "0.186.0",
+    "three": "0.186.1"
   },
   "scripts": {
     "type-check": "tsc && tsc -p tsconfig.node.json",

package/src/featureGeometry.ts

@@ -48,10 +48,12 @@ export type PolylineGeometryData = {
   startLow: Float32Array;
   endHigh: Float32Array;
   endLow: Float32Array;
-  startNormal: Float32Array;
-  endNormalAndTextureCoordinateNormalizationX: Float32Array;
-  rightNormalAndTextureCoordinateNormalizationY: Float32Array;
+  startNormalAndLengthHigh: Float32Array;
+  endNormalAndSegmentLength: Float32Array;
+  rightNormalAndLineLength: Float32Array;
   indices: Uint32Array;
+  /** One entry of three RGBA texels per segment, for a dash pattern. */
+  lineSegments: Float32Array;
   extent: GeographicExtent;
 };
 
@@ -174,8 +176,9 @@ export function buildPolylineGeometry(
     const startLow = built.start_low();
     const endHigh = built.end_high();
     const endLow = built.end_low();
-    const startNormal = built.start_normals();
-    const endNormal = built.end_normal_and_texture_coordinate_normalization_x();
+    const startNormalAndLengthHigh = built.start_normal_and_length_high();
+    const endNormal = built.end_normal_and_segment_length();
+    const lineSegments = built.line_segments();
     const extent = built.extent;
     if (
       !positionHigh ||
@@ -184,8 +187,9 @@ export function buildPolylineGeometry(
       !startLow ||
       !endHigh ||
       !endLow ||
-      !startNormal ||
+      !startNormalAndLengthHigh ||
       !endNormal ||
+      !lineSegments ||
       !extent
     ) {
       throw new Error("buildPolylineGeometry: incomplete RTE geometry");
@@ -199,11 +203,11 @@ export function buildPolylineGeometry(
       startLow,
       endHigh,
       endLow,
-      startNormal,
-      endNormalAndTextureCoordinateNormalizationX: endNormal,
-      rightNormalAndTextureCoordinateNormalizationY:
-        built.right_normal_and_texture_coordinate_normalization_y(),
+      startNormalAndLengthHigh,
+      endNormalAndSegmentLength: endNormal,
+      rightNormalAndLineLength: built.right_normal_and_line_length(),
       indices: built.indices(),
+      lineSegments,
       extent: toDegrees(extent),
     };
   } finally {

package/src/index.ts

@@ -49,11 +49,24 @@ export * from "./intersection";
 export * from "./rte";
 export * from "./ellipsoidGeodesic";
 
+// wasm-bindgen's init only short-circuits once a call has finished, so
+// concurrent callers must share one promise or the later instantiation
+// replaces the module the earlier caller's objects live in. @navaramap/font
+// initializes the same module, so the promise lives under a global key both
+// packages use.
+const API_READY = Symbol.for("@navaramap/engine-api/init");
+type ApiReadyHolder = { [API_READY]?: Promise<unknown> };
+
 /**
  * Initializes the Navara API WASM module. Must be called before using other API functions.
  */
 export async function initNavaraApi() {
-  await initApi();
+  const holder = globalThis as ApiReadyHolder;
+  holder[API_READY] ??= initApi().catch((e: unknown) => {
+    holder[API_READY] = undefined;
+    throw e;
+  });
+  await holder[API_READY];
 }
 
 /**