locar 0.2.3 → 0.2.4

package/dist/locar.es.js

@@ -344,9 +344,10 @@ var x = .5 * Math.PI, S = class extends n {
 	}
 }, w = class extends o {
 	#e;
+	#t;
 	constructor(t = { video: { facingMode: "environment" } }, n) {
-		super(), this.sceneWebcam = new e.Scene(), n ? this.#e = document.querySelector(n) : (this.#e = document.createElement("video"), this.#e.setAttribute("autoplay", "true"), this.#e.setAttribute("playsinline", "true"), this.#e.style.cssText += "\n        width: 100%;\n        height: 100%;\n        object-fit: cover;\n        background: black;\n        position: absolute;\n        top: 0px;\n        left: 0px;\n	      z-index: -100;  \n      ", document.body.appendChild(this.#e)), navigator.mediaDevices && navigator.mediaDevices.getUserMedia ? navigator.mediaDevices.getUserMedia(t).then((e) => {
-			this.#e?.addEventListener("loadedmetadata", () => {
+		super(), this.sceneWebcam = new e.Scene(), n ? this.#e = document.querySelector(n) : (this.#e = document.createElement("video"), this.#e.setAttribute("autoplay", "true"), this.#e.setAttribute("playsinline", "true"), this.#e.style.cssText += "\n        width: 100%;\n        height: 100%;\n        object-fit: cover;\n        background: black;\n        position: absolute;\n        top: 0px;\n        left: 0px;\n	      z-index: -100;  \n      ", document.body.appendChild(this.#e)), this.#t = null, navigator.mediaDevices && navigator.mediaDevices.getUserMedia ? navigator.mediaDevices.getUserMedia(t).then((e) => {
+			this.#t = e, this.#e?.addEventListener("loadedmetadata", () => {
 				this.#e.play(), this.emit("webcamstarted", {
 					videoWidth: this.#e.videoWidth,
 					videoHeight: this.#e.videoHeight
@@ -365,6 +366,11 @@ var x = .5 * Math.PI, S = class extends n {
 	getVideoDimensions() {
 		return `w ${this.#e.videoWidth}, h ${this.#e.videoHeight}`;
 	}
+	dispose() {
+		(this.#t?.getTracks() ?? []).forEach((e) => {
+			e.stop();
+		}), this.#t = null, this.#e?.remove(), this.#e = null;
+	}
 };
 //#endregion
 export { s as App, C as ClickHandler, S as DeviceOrientationControls, o as EventEmitter, l as LocAR, c as SphMercProjection, w as Webcam };

package/dist/locar.umd.js

@@ -1,4 +1,4 @@
-(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports,require("three")):typeof define==`function`&&define.amd?define([`exports`,`three`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.locar={},e.THREE))})(this,function(e,t){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var n=Object.create,r=Object.defineProperty,i=Object.getOwnPropertyDescriptor,a=Object.getOwnPropertyNames,o=Object.getPrototypeOf,s=Object.prototype.hasOwnProperty,c=(e,t,n,o)=>{if(t&&typeof t==`object`||typeof t==`function`)for(var c=a(t),l=0,u=c.length,d;l<u;l++)d=c[l],!s.call(e,d)&&d!==n&&r(e,d,{get:(e=>t[e]).bind(null,d),enumerable:!(o=i(t,d))||o.enumerable});return e};t=((e,t,i)=>(i=e==null?{}:n(o(e)),c(t||!e||!e.__esModule?r(i,`default`,{value:e,enumerable:!0}):i,e)))(t);var l=class{constructor(){this.on=(e,t)=>{this.eventHandlers[e]===void 0&&(this.eventHandlers[e]=[]),this.eventHandlers[e].push(t)},this.emit=(e,...t)=>{this.eventHandlers[e]?.forEach(e=>{e(...t)})},this.off=(e,t)=>{if(this.eventHandlers[e]){let n=this.eventHandlers[e].indexOf(t);n>-1&&this.eventHandlers[e].splice(n,1)}},this.eventHandlers={}}},u=class extends l{constructor({cameraOptions:e,canvas:n,gpsOptions:r,videoConstraints:i,deviceOrientationOptions:a,serverLogger:o,projection:s}){super(),this.origHfov=e?.hFov||80,this.cameraFeedDimensions=null;let c=window.innerWidth/window.innerHeight;this.camera=new t.PerspectiveCamera(this.origHfov/c,c,e?.near||.001,e?.far||1e3),n?(this.renderer=new t.WebGLRenderer({canvas:n,alpha:!0}),this.renderer.setClearColor(65280,0)):(this.renderer=new t.WebGLRenderer({alpha:!0}),this.renderer.setClearColor(65280,0),document.body.appendChild(this.renderer.domElement)),this.renderer.setSize(window.innerWidth,window.innerHeight),this.scene=new t.Scene;let l=a||{enabled:!0};window.addEventListener(`resize`,()=>{this.renderer.setSize(window.innerWidth,window.innerHeight);let e=window.innerWidth/window.innerHeight;if(this.camera.aspect=e,this.cameraFeedDimensions!==null){let t=e>1?this.cameraFeedDimensions.landWidth:this.cameraFeedDimensions.landHeight,n=e>1?this.cameraFeedDimensions.landHeight:this.cameraFeedDimensions.landWidth;this.#e(t,n,e)}this.camera.updateProjectionMatrix()}),this.locar=new f(this.scene,this.camera,r,o,s),this.webcam=new D(i),this.deviceOrientationControls=l.enabled===!0?new T(this.camera,l):null,this.renderer.setAnimationLoop(()=>{this.deviceOrientationControls?.update(),this.renderer.render(this.scene,this.camera)})}start(){return new Promise((e,t)=>{this.webcam.on(`webcamstarted`,e=>{let t=e.videoWidth>e.videoHeight;this.cameraFeedDimensions={landWidth:t?e.videoWidth:e.videoHeight,landHeight:t?e.videoHeight:e.videoWidth},this.#e(e.videoWidth,e.videoHeight,window.innerWidth/window.innerHeight),this.camera.updateProjectionMatrix()}),this.webcam.on(`webcamerror`,e=>{t({code:e.code,message:e.message})}),this.deviceOrientationControls===null?e(this.locar):(this.deviceOrientationControls?.on(`deviceorientationgranted`,t=>{t.target.connect(),e(this.locar)}),this.deviceOrientationControls.on(`deviceorientationerror`,e=>{t({code:e.code,message:e.message})}),this.deviceOrientationControls.init())})}#e(e,t,n){if(n<e/t){let r=e*(window.innerHeight/t),i=this.origHfov*(window.innerWidth/r);this.camera.fov=i/n}else this.camera.fov=this.origHfov/n}},d=class{constructor(){this.project=(e,t)=>[this.#e(e),this.#t(t)],this.unproject=e=>[this.#n(e[0]),this.#r(e[1])],this.#e=e=>e/180*this.HALF_EARTH,this.#t=e=>Math.log(Math.tan((90+e)*Math.PI/360))/(Math.PI/180)*this.HALF_EARTH/180,this.#n=e=>e/this.HALF_EARTH*180,this.#r=e=>{var t=e/this.HALF_EARTH*180;return t=180/Math.PI*(2*Math.atan(Math.exp(t*Math.PI/180))-Math.PI/2),t},this.getID=()=>`epsg:3857`,this.EARTH=40075016.68,this.HALF_EARTH=20037508.34}#e;#t;#n;#r},f=class e extends l{#e;#t;#n;#r;#i;#a;#o;#s;#c;constructor(e,t,n={},r=null,i=new d){super(),this.scene=e,this.camera=t,this.#e=i,this.#t=null,this.#n=0,this.#r=100,this.#i=null,this.setGpsOptions(n),this.#a=null,this.#o=0,this.#s=0,this.#c=r}setProjection(e){this.#e=e}setGpsOptions(e={}){e.gpsMinDistance!==void 0&&(this.#n=e.gpsMinDistance),e.gpsMinAccuracy!==void 0&&(this.#r=e.gpsMinAccuracy)}async startGps(){if(this.#c){let e=await(await this.#c.sendData(`/gps/start`,{gpsMinDistance:this.#n,gpsMinAccuracy:this.#r})).json();this.#s=e.session}return this.#i===null?(this.#i=navigator.geolocation.watchPosition(e=>{this.#f(e)},e=>{this.emit(`gpserror`,e)},{enableHighAccuracy:!0}),!0):!1}stopGps(){return this.#i===null?!1:(navigator.geolocation.clearWatch(this.#i),this.#i=null,!0)}fakeGps(e,t,n=null,r=0){n!==null&&this.setElevation(n),this.#f({coords:{longitude:e,latitude:t,accuracy:r}})}lonLatToWorldCoords(e,t){let n=this.#e.project(e,t);return this.eastNorthToWorldCoords(n)}eastNorthToWorldCoords(e){if(this.#a)e[0]-=this.#a[0],e[1]-=this.#a[1];else throw`No initial position determined`;return[e[0],-e[1]]}add(e,t,n,r,i={}){e.properties=i,this.#u(e,t,n,r||0),this.scene.add(e),this.#c?.sendData(`/object/new`,{position:e.position,x:e.position.x,z:e.position.z,session:this.#s,properties:i})}addGeoLine(e,n,r=1){let i=e.map((e=>{let[n,r]=this.lonLatToWorldCoords(e[0],e[1]);return new t.Vector3(n,e[2]||0,r)})),a=this.#l(i,r);n.setValues({side:t.DoubleSide});let o=new t.Mesh(a,n);return this.scene.add(o),o}#l(e,n){let r,i,a,o,s=0,c=0,l=[],u,d=e.length-1,f=[];for(let t=0;t<d;t++)r=e[t+1].x-e[t].x,i=e[t+1].z-e[t].z,a=e[t+1].y-e[t].y,o=Math.sqrt(r*r+a*a+i*i),s=-(n/2*i)/o,c=n/2*r/o,u=[e[t].x-s,e[t].y,e[t].z-c,e[t].x+s,e[t].y,e[t].z+c],t>0&&u.forEach((e,t)=>{e=(e+l[t])/2}),f.push(...u),l=[e[t+1].x-s,e[t+1].y,e[t+1].z-c,e[t+1].x+s,e[t+1].y,e[t+1].z+c];f.push(e[d].x-s),f.push(e[d].y),f.push(e[d].z-c),f.push(e[d].x+s),f.push(e[d].y),f.push(e[d].z+c);let p=[];for(let e=0;e<d;e++)p.push(e*2,e*2+1,e*2+2),p.push(e*2+1,e*2+3,e*2+2);let m=new t.BufferGeometry,h=new Float32Array(f);return m.setIndex(p),m.setAttribute(`position`,new t.BufferAttribute(h,3)),m.computeBoundingBox(),m}#u(e,t,n,r){let i=this.lonLatToWorldCoords(t,n);r!==void 0&&(e.position.y=r),[e.position.x,e.position.z]=i}setElevation(e){this.camera.position.y=e}#d(e,t){this.#a=this.#e.project(e,t)}#f(t){let n=Number.MAX_VALUE;this.#o++,this.#c?.sendData(`/gps/new`,{gpsCount:this.#o,lat:t.coords.latitude,lon:t.coords.longitude,acc:t.coords.accuracy,session:this.#s}),t.coords.accuracy<=this.#r&&(this.#t===null?this.#t={latitude:t.coords.latitude,longitude:t.coords.longitude}:n=e.haversineDist(this.#t,t.coords),n>=this.#n&&(this.#t.longitude=t.coords.longitude,this.#t.latitude=t.coords.latitude,this.#a||(this.#d(t.coords.longitude,t.coords.latitude),this.#c?.sendData(`/worldorigin/new`,{gpsCount:this.#o,lat:t.coords.latitude,lon:t.coords.longitude,session:this.#s,initialPosition:this.#a})),this.#u(this.camera,t.coords.longitude,t.coords.latitude),this.#c?.sendData(`/gps/accepted`,{gpsCount:this.#o,cameraX:this.camera.position.x,cameraZ:this.camera.position.z,session:this.#s,distMoved:n}),this.emit(`gpsupdate`,{position:t,distMoved:n})))}static haversineDist(e,n){let r=t.MathUtils.degToRad(n.longitude-e.longitude),i=t.MathUtils.degToRad(n.latitude-e.latitude),a=Math.sin(i/2)*Math.sin(i/2)+Math.cos(t.MathUtils.degToRad(e.latitude))*Math.cos(t.MathUtils.degToRad(n.latitude))*(Math.sin(r/2)*Math.sin(r/2));return 2*Math.atan2(Math.sqrt(a),Math.sqrt(1-a))*6371e3}getLastKnownLocation(){return this.#t}},p=`locar-device-orientation-permission-modal`,m=`locar-device-orientation-permission-button`,h=`locar-device-orientation-permission-message`,g=`locar-device-orientation-permission-inner`,_=`locar-device-orientation-permission-button-inner`,v=`This immersive website requires access to your device motion sensors.`,y=navigator.userAgent.match(/iPhone|iPad|iPod/i)||/Macintosh/i.test(navigator.userAgent)&&navigator.maxTouchPoints!=null&&navigator.maxTouchPoints>1,b=new t.Vector3(0,0,1),x=new t.Euler,S=new t.Quaternion,C=new t.Quaternion(-Math.sqrt(.5),0,0,Math.sqrt(.5));2*Math.PI;var w=.5*Math.PI,T=class extends t.EventDispatcher{constructor(e,n={}){super(),this.init=()=>{window.DeviceOrientationEvent===void 0?this.eventEmitter.emit(`deviceorientationerror`,{code:`LOCAR_DEVICE_ORIENTATION_NOT_SUPPORTED`,message:`Device orientation API not supported`}):window.isSecureContext===!1?this.eventEmitter.emit(`deviceorientationerror`,{code:`LOCAR_DEVICE_ORIENTATION_NO_HTTPS`,message:`DeviceOrientationEvent is only available in secure contexts (https)`}):typeof window.DeviceOrientationEvent.requestPermission==`function`&&this.enablePermissionDialog?this.obtainPermissionGesture():this.eventEmitter.emit(`deviceorientationgranted`,{target:this})},this.eventEmitter=new l;let r=this;this.object=e,this.object.rotation.reorder(`YXZ`),this.enabled=!0,this.deviceOrientation=null,this.screenOrientation=0,this.alphaOffset=0,this.orientationOffset=0,this.initialOffset=null,this.lastQuaternion=null,this.orientationChangeEventName=`ondeviceorientationabsolute`in window?`deviceorientationabsolute`:`deviceorientation`,this.smoothingFactor=n.smoothingFactor||.2,this.enablePermissionDialog=n.enablePermissionDialog??!0,this.enableInlineStyling=n.enableStyling??!0,this.preferConfirmDialog=n.preferConfirmDialog??!1,this.orientationChangeThreshold=n.orientationChangeThreshold??0;let i=n=>{let{alpha:i,beta:a,gamma:o,webkitCompassHeading:s}=n;if(i??=0,a??=0,o??=0,s??=0,y){let e=360-s;r.alphaOffset=t.MathUtils.degToRad(e-i),r.deviceOrientation={alpha:i,beta:a,gamma:o,webkitCompassHeading:s}}else i<0&&(i+=360),r.deviceOrientation={alpha:i,beta:a,gamma:o};window.dispatchEvent(new CustomEvent(`camera-rotation-change`,{detail:{cameraRotation:e.rotation}}))},a=()=>{r.screenOrientation=window.screen.orientation?.angle??0,y&&(r.screenOrientation===90?r.orientationOffset=-w:r.screenOrientation===-90?r.orientationOffset=w:r.orientationOffset=0)},o=(e,t,n,r,i)=>{x.set(n,t,-r,`YXZ`),e.setFromEuler(x),e.multiply(C),e.multiply(S.setFromAxisAngle(b,-i))};this.connect=()=>{a(),window.addEventListener(`orientationchange`,a),window.addEventListener(r.orientationChangeEventName,i),r.enabled=!0},this.disconnect=()=>{window.removeEventListener(`orientationchange`,a),window.removeEventListener(r.orientationChangeEventName,i),r.enabled=!1,r.initialOffset=!1,r.deviceOrientation=null,r.lastQuaternion=null},this.requestOrientationPermissions=()=>{window.DeviceOrientationEvent!==void 0&&typeof window.DeviceOrientationEvent.requestPermission==`function`?window.DeviceOrientationEvent.requestPermission().then(e=>{e===`granted`?this.eventEmitter.emit(`deviceorientationgranted`,{target:this}):this.eventEmitter.emit(`deviceorientationerror`,{code:`LOCAR_DEVICE_ORIENTATION_PERMISSION_DENIED`,message:`Permission for device orientation denied - AR will not work correctly`})}).catch(e=>{this.eventEmitter.emit(`deviceorientationerror`,{code:`LOCAR_DEVICE_ORIENTATION_PERMISSION_FAILED`,message:`Permission request for device orientation failed - AR will not work correctly`,error:JSON.stringify(e,null,2)})}):this.eventEmitter.emit(`deviceorientationerror`,{code:`LOCAR_DEVICE_ORIENTATION_INTERNAL_ERROR`,message:`Internal error: no requestPermission() found although requestOrientationPermissions() was called - please raise an issue on GitHub`})},this.update=()=>{if(r.enabled===!1)return;let e=r.deviceOrientation;if(e){let n=e.alpha?t.MathUtils.degToRad(e.alpha)+r.alphaOffset:0,i=e.beta?t.MathUtils.degToRad(e.beta):0,a=e.gamma?t.MathUtils.degToRad(e.gamma):0,s=r.screenOrientation?t.MathUtils.degToRad(r.screenOrientation):0,c=new t.Quaternion;if(y){o(c,n,i,a,s);let l=new t.Euler().setFromQuaternion(c,`YXZ`);l.y=t.MathUtils.degToRad(360-(e.webkitCompassHeading??0))+(r.orientationOffset||0),c.setFromEuler(l)}else o(c,n,i,a,s);if(r.lastQuaternion&&r.orientationChangeThreshold>0&&c.angleTo(r.lastQuaternion)<r.orientationChangeThreshold)return;if(r.smoothingFactor<1&&r.lastQuaternion){let e=1-r.smoothingFactor;r.object.quaternion.slerp(c,e)}else r.object.quaternion.copy(c);r.lastQuaternion=r.object.quaternion.clone(),window.dispatchEvent(new CustomEvent(`camera-rotation-change`,{detail:{cameraRotation:r.object.rotation}}))}},this.getCorrectedHeading=()=>{let{deviceOrientation:e}=r;if(!e)return 0;let t=0;return y?(t=360-(e.webkitCompassHeading??0),r.orientationOffset&&(t+=r.orientationOffset*(180/Math.PI),t=(t+360)%360)):(e.absolute===!0||r.orientationChangeEventName,t=e.alpha?e.alpha:0,t=(360-t)%360,t<0&&(t+=360)),t},this.updateAlphaOffset=()=>{r.initialOffset=!1},this.dispose=()=>{r.disconnect()},this.getAlpha=()=>{let{deviceOrientation:e}=r;return e&&e.alpha?t.MathUtils.degToRad(e.alpha)+r.alphaOffset:0},this.getBeta=()=>{let{deviceOrientation:e}=r;return e&&e.beta?t.MathUtils.degToRad(e.beta):0},this.getGamma=()=>{let{deviceOrientation:e}=r;return e&&e.gamma?t.MathUtils.degToRad(e.gamma):0},this.createObtainPermissionGestureDialog=()=>{let e=document.createElement(`div`);e.classList.add(p);let t=document.createElement(`div`);t.classList.add(g);let n=document.createElement(`div`);n.classList.add(h);let r=document.createElement(`div`);r.classList.add(_);let i=document.createElement(`button`);i.classList.add(m),document.body.appendChild(e),this.enableInlineStyling===!0&&(e.style.fontFamily=`-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'`,e.style.display=`flex`,e.style.position=`fixed`,e.style.zIndex=`100000`,e.style.justifyContent=`center`,e.style.alignItems=`center`,e.style.backgroundColor=`rgba(0,0,0,0.2)`,e.style.inset=`0`,e.style.padding=`20px`,t.style.backgroundColor=`rgba(220, 220, 220, 0.85)`,t.style.padding=`6px 0`,t.style.borderRadius=`10px`,t.style.width=`100%`,t.style.maxWidth=`400px`,n.style.padding=`10px 12px`,n.style.textAlign=`center`,n.style.fontWeight=`400`,n.style.fontSize=`13px`,n.style.display=`flex`,n.style.justifyContent=`center`,n.style.alignItems=`center`,r.style.display=`block`,r.style.textAlign=`center`,r.style.textDecoration=`none`,r.style.borderTop=`rgb(180,180,180) solid 1px`,i.style.display=`block`,i.style.width=`100%`,i.style.textAlign=`center`,i.style.appearance=`none`,i.style.background=`none`,i.style.border=`none`,i.style.outline=`none`,i.style.padding=`10px`,i.style.fontWeight=`400`,i.style.fontSize=`16px`,i.style.color=`#2e7cf1`,i.style.cursor=`pointer`),e.appendChild(t),t.appendChild(n),t.appendChild(r),n.appendChild(document.createTextNode(v)),i.addEventListener(`click`,()=>{this.requestOrientationPermissions(),e.style.display=`none`}),i.appendChild(document.createTextNode(`OK`)),r.appendChild(i),document.body.appendChild(e)},this.obtainPermissionGesture=()=>{this.preferConfirmDialog===!0?window.confirm(v)&&this.requestOrientationPermissions():this.createObtainPermissionGestureDialog()}}on(e,t){this.eventEmitter.on(e,t)}},E=class{constructor(e){this.raycaster=new t.Raycaster,this.normalisedMousePosition=null,e.domElement.addEventListener(`click`,n=>{this.normalisedMousePosition=new t.Vector2(n.clientX/e.domElement.clientWidth*2-1,-(n.clientY/e.domElement.clientHeight*2)+1)})}raycast(e,t){if(this.normalisedMousePosition!==null){this.raycaster.setFromCamera(this.normalisedMousePosition,e);let n=this.raycaster.intersectObjects(t.children,!1);return this.normalisedMousePosition=null,n}return[]}},D=class extends l{#e;constructor(e={video:{facingMode:`environment`}},n){super(),this.sceneWebcam=new t.Scene,n?this.#e=document.querySelector(n):(this.#e=document.createElement(`video`),this.#e.setAttribute(`autoplay`,`true`),this.#e.setAttribute(`playsinline`,`true`),this.#e.style.cssText+=`
+(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports,require("three")):typeof define==`function`&&define.amd?define([`exports`,`three`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.locar={},e.THREE))})(this,function(e,t){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var n=Object.create,r=Object.defineProperty,i=Object.getOwnPropertyDescriptor,a=Object.getOwnPropertyNames,o=Object.getPrototypeOf,s=Object.prototype.hasOwnProperty,c=(e,t,n,o)=>{if(t&&typeof t==`object`||typeof t==`function`)for(var c=a(t),l=0,u=c.length,d;l<u;l++)d=c[l],!s.call(e,d)&&d!==n&&r(e,d,{get:(e=>t[e]).bind(null,d),enumerable:!(o=i(t,d))||o.enumerable});return e};t=((e,t,i)=>(i=e==null?{}:n(o(e)),c(t||!e||!e.__esModule?r(i,`default`,{value:e,enumerable:!0}):i,e)))(t);var l=class{constructor(){this.on=(e,t)=>{this.eventHandlers[e]===void 0&&(this.eventHandlers[e]=[]),this.eventHandlers[e].push(t)},this.emit=(e,...t)=>{this.eventHandlers[e]?.forEach(e=>{e(...t)})},this.off=(e,t)=>{if(this.eventHandlers[e]){let n=this.eventHandlers[e].indexOf(t);n>-1&&this.eventHandlers[e].splice(n,1)}},this.eventHandlers={}}},u=class extends l{constructor({cameraOptions:e,canvas:n,gpsOptions:r,videoConstraints:i,deviceOrientationOptions:a,serverLogger:o,projection:s}){super(),this.origHfov=e?.hFov||80,this.cameraFeedDimensions=null;let c=window.innerWidth/window.innerHeight;this.camera=new t.PerspectiveCamera(this.origHfov/c,c,e?.near||.001,e?.far||1e3),n?(this.renderer=new t.WebGLRenderer({canvas:n,alpha:!0}),this.renderer.setClearColor(65280,0)):(this.renderer=new t.WebGLRenderer({alpha:!0}),this.renderer.setClearColor(65280,0),document.body.appendChild(this.renderer.domElement)),this.renderer.setSize(window.innerWidth,window.innerHeight),this.scene=new t.Scene;let l=a||{enabled:!0};window.addEventListener(`resize`,()=>{this.renderer.setSize(window.innerWidth,window.innerHeight);let e=window.innerWidth/window.innerHeight;if(this.camera.aspect=e,this.cameraFeedDimensions!==null){let t=e>1?this.cameraFeedDimensions.landWidth:this.cameraFeedDimensions.landHeight,n=e>1?this.cameraFeedDimensions.landHeight:this.cameraFeedDimensions.landWidth;this.#e(t,n,e)}this.camera.updateProjectionMatrix()}),this.locar=new f(this.scene,this.camera,r,o,s),this.webcam=new D(i),this.deviceOrientationControls=l.enabled===!0?new T(this.camera,l):null,this.renderer.setAnimationLoop(()=>{this.deviceOrientationControls?.update(),this.renderer.render(this.scene,this.camera)})}start(){return new Promise((e,t)=>{this.webcam.on(`webcamstarted`,e=>{let t=e.videoWidth>e.videoHeight;this.cameraFeedDimensions={landWidth:t?e.videoWidth:e.videoHeight,landHeight:t?e.videoHeight:e.videoWidth},this.#e(e.videoWidth,e.videoHeight,window.innerWidth/window.innerHeight),this.camera.updateProjectionMatrix()}),this.webcam.on(`webcamerror`,e=>{t({code:e.code,message:e.message})}),this.deviceOrientationControls===null?e(this.locar):(this.deviceOrientationControls?.on(`deviceorientationgranted`,t=>{t.target.connect(),e(this.locar)}),this.deviceOrientationControls.on(`deviceorientationerror`,e=>{t({code:e.code,message:e.message})}),this.deviceOrientationControls.init())})}#e(e,t,n){if(n<e/t){let r=e*(window.innerHeight/t),i=this.origHfov*(window.innerWidth/r);this.camera.fov=i/n}else this.camera.fov=this.origHfov/n}},d=class{constructor(){this.project=(e,t)=>[this.#e(e),this.#t(t)],this.unproject=e=>[this.#n(e[0]),this.#r(e[1])],this.#e=e=>e/180*this.HALF_EARTH,this.#t=e=>Math.log(Math.tan((90+e)*Math.PI/360))/(Math.PI/180)*this.HALF_EARTH/180,this.#n=e=>e/this.HALF_EARTH*180,this.#r=e=>{var t=e/this.HALF_EARTH*180;return t=180/Math.PI*(2*Math.atan(Math.exp(t*Math.PI/180))-Math.PI/2),t},this.getID=()=>`epsg:3857`,this.EARTH=40075016.68,this.HALF_EARTH=20037508.34}#e;#t;#n;#r},f=class e extends l{#e;#t;#n;#r;#i;#a;#o;#s;#c;constructor(e,t,n={},r=null,i=new d){super(),this.scene=e,this.camera=t,this.#e=i,this.#t=null,this.#n=0,this.#r=100,this.#i=null,this.setGpsOptions(n),this.#a=null,this.#o=0,this.#s=0,this.#c=r}setProjection(e){this.#e=e}setGpsOptions(e={}){e.gpsMinDistance!==void 0&&(this.#n=e.gpsMinDistance),e.gpsMinAccuracy!==void 0&&(this.#r=e.gpsMinAccuracy)}async startGps(){if(this.#c){let e=await(await this.#c.sendData(`/gps/start`,{gpsMinDistance:this.#n,gpsMinAccuracy:this.#r})).json();this.#s=e.session}return this.#i===null?(this.#i=navigator.geolocation.watchPosition(e=>{this.#f(e)},e=>{this.emit(`gpserror`,e)},{enableHighAccuracy:!0}),!0):!1}stopGps(){return this.#i===null?!1:(navigator.geolocation.clearWatch(this.#i),this.#i=null,!0)}fakeGps(e,t,n=null,r=0){n!==null&&this.setElevation(n),this.#f({coords:{longitude:e,latitude:t,accuracy:r}})}lonLatToWorldCoords(e,t){let n=this.#e.project(e,t);return this.eastNorthToWorldCoords(n)}eastNorthToWorldCoords(e){if(this.#a)e[0]-=this.#a[0],e[1]-=this.#a[1];else throw`No initial position determined`;return[e[0],-e[1]]}add(e,t,n,r,i={}){e.properties=i,this.#u(e,t,n,r||0),this.scene.add(e),this.#c?.sendData(`/object/new`,{position:e.position,x:e.position.x,z:e.position.z,session:this.#s,properties:i})}addGeoLine(e,n,r=1){let i=e.map((e=>{let[n,r]=this.lonLatToWorldCoords(e[0],e[1]);return new t.Vector3(n,e[2]||0,r)})),a=this.#l(i,r);n.setValues({side:t.DoubleSide});let o=new t.Mesh(a,n);return this.scene.add(o),o}#l(e,n){let r,i,a,o,s=0,c=0,l=[],u,d=e.length-1,f=[];for(let t=0;t<d;t++)r=e[t+1].x-e[t].x,i=e[t+1].z-e[t].z,a=e[t+1].y-e[t].y,o=Math.sqrt(r*r+a*a+i*i),s=-(n/2*i)/o,c=n/2*r/o,u=[e[t].x-s,e[t].y,e[t].z-c,e[t].x+s,e[t].y,e[t].z+c],t>0&&u.forEach((e,t)=>{e=(e+l[t])/2}),f.push(...u),l=[e[t+1].x-s,e[t+1].y,e[t+1].z-c,e[t+1].x+s,e[t+1].y,e[t+1].z+c];f.push(e[d].x-s),f.push(e[d].y),f.push(e[d].z-c),f.push(e[d].x+s),f.push(e[d].y),f.push(e[d].z+c);let p=[];for(let e=0;e<d;e++)p.push(e*2,e*2+1,e*2+2),p.push(e*2+1,e*2+3,e*2+2);let m=new t.BufferGeometry,h=new Float32Array(f);return m.setIndex(p),m.setAttribute(`position`,new t.BufferAttribute(h,3)),m.computeBoundingBox(),m}#u(e,t,n,r){let i=this.lonLatToWorldCoords(t,n);r!==void 0&&(e.position.y=r),[e.position.x,e.position.z]=i}setElevation(e){this.camera.position.y=e}#d(e,t){this.#a=this.#e.project(e,t)}#f(t){let n=Number.MAX_VALUE;this.#o++,this.#c?.sendData(`/gps/new`,{gpsCount:this.#o,lat:t.coords.latitude,lon:t.coords.longitude,acc:t.coords.accuracy,session:this.#s}),t.coords.accuracy<=this.#r&&(this.#t===null?this.#t={latitude:t.coords.latitude,longitude:t.coords.longitude}:n=e.haversineDist(this.#t,t.coords),n>=this.#n&&(this.#t.longitude=t.coords.longitude,this.#t.latitude=t.coords.latitude,this.#a||(this.#d(t.coords.longitude,t.coords.latitude),this.#c?.sendData(`/worldorigin/new`,{gpsCount:this.#o,lat:t.coords.latitude,lon:t.coords.longitude,session:this.#s,initialPosition:this.#a})),this.#u(this.camera,t.coords.longitude,t.coords.latitude),this.#c?.sendData(`/gps/accepted`,{gpsCount:this.#o,cameraX:this.camera.position.x,cameraZ:this.camera.position.z,session:this.#s,distMoved:n}),this.emit(`gpsupdate`,{position:t,distMoved:n})))}static haversineDist(e,n){let r=t.MathUtils.degToRad(n.longitude-e.longitude),i=t.MathUtils.degToRad(n.latitude-e.latitude),a=Math.sin(i/2)*Math.sin(i/2)+Math.cos(t.MathUtils.degToRad(e.latitude))*Math.cos(t.MathUtils.degToRad(n.latitude))*(Math.sin(r/2)*Math.sin(r/2));return 2*Math.atan2(Math.sqrt(a),Math.sqrt(1-a))*6371e3}getLastKnownLocation(){return this.#t}},p=`locar-device-orientation-permission-modal`,m=`locar-device-orientation-permission-button`,h=`locar-device-orientation-permission-message`,g=`locar-device-orientation-permission-inner`,_=`locar-device-orientation-permission-button-inner`,v=`This immersive website requires access to your device motion sensors.`,y=navigator.userAgent.match(/iPhone|iPad|iPod/i)||/Macintosh/i.test(navigator.userAgent)&&navigator.maxTouchPoints!=null&&navigator.maxTouchPoints>1,b=new t.Vector3(0,0,1),x=new t.Euler,S=new t.Quaternion,C=new t.Quaternion(-Math.sqrt(.5),0,0,Math.sqrt(.5));2*Math.PI;var w=.5*Math.PI,T=class extends t.EventDispatcher{constructor(e,n={}){super(),this.init=()=>{window.DeviceOrientationEvent===void 0?this.eventEmitter.emit(`deviceorientationerror`,{code:`LOCAR_DEVICE_ORIENTATION_NOT_SUPPORTED`,message:`Device orientation API not supported`}):window.isSecureContext===!1?this.eventEmitter.emit(`deviceorientationerror`,{code:`LOCAR_DEVICE_ORIENTATION_NO_HTTPS`,message:`DeviceOrientationEvent is only available in secure contexts (https)`}):typeof window.DeviceOrientationEvent.requestPermission==`function`&&this.enablePermissionDialog?this.obtainPermissionGesture():this.eventEmitter.emit(`deviceorientationgranted`,{target:this})},this.eventEmitter=new l;let r=this;this.object=e,this.object.rotation.reorder(`YXZ`),this.enabled=!0,this.deviceOrientation=null,this.screenOrientation=0,this.alphaOffset=0,this.orientationOffset=0,this.initialOffset=null,this.lastQuaternion=null,this.orientationChangeEventName=`ondeviceorientationabsolute`in window?`deviceorientationabsolute`:`deviceorientation`,this.smoothingFactor=n.smoothingFactor||.2,this.enablePermissionDialog=n.enablePermissionDialog??!0,this.enableInlineStyling=n.enableStyling??!0,this.preferConfirmDialog=n.preferConfirmDialog??!1,this.orientationChangeThreshold=n.orientationChangeThreshold??0;let i=n=>{let{alpha:i,beta:a,gamma:o,webkitCompassHeading:s}=n;if(i??=0,a??=0,o??=0,s??=0,y){let e=360-s;r.alphaOffset=t.MathUtils.degToRad(e-i),r.deviceOrientation={alpha:i,beta:a,gamma:o,webkitCompassHeading:s}}else i<0&&(i+=360),r.deviceOrientation={alpha:i,beta:a,gamma:o};window.dispatchEvent(new CustomEvent(`camera-rotation-change`,{detail:{cameraRotation:e.rotation}}))},a=()=>{r.screenOrientation=window.screen.orientation?.angle??0,y&&(r.screenOrientation===90?r.orientationOffset=-w:r.screenOrientation===-90?r.orientationOffset=w:r.orientationOffset=0)},o=(e,t,n,r,i)=>{x.set(n,t,-r,`YXZ`),e.setFromEuler(x),e.multiply(C),e.multiply(S.setFromAxisAngle(b,-i))};this.connect=()=>{a(),window.addEventListener(`orientationchange`,a),window.addEventListener(r.orientationChangeEventName,i),r.enabled=!0},this.disconnect=()=>{window.removeEventListener(`orientationchange`,a),window.removeEventListener(r.orientationChangeEventName,i),r.enabled=!1,r.initialOffset=!1,r.deviceOrientation=null,r.lastQuaternion=null},this.requestOrientationPermissions=()=>{window.DeviceOrientationEvent!==void 0&&typeof window.DeviceOrientationEvent.requestPermission==`function`?window.DeviceOrientationEvent.requestPermission().then(e=>{e===`granted`?this.eventEmitter.emit(`deviceorientationgranted`,{target:this}):this.eventEmitter.emit(`deviceorientationerror`,{code:`LOCAR_DEVICE_ORIENTATION_PERMISSION_DENIED`,message:`Permission for device orientation denied - AR will not work correctly`})}).catch(e=>{this.eventEmitter.emit(`deviceorientationerror`,{code:`LOCAR_DEVICE_ORIENTATION_PERMISSION_FAILED`,message:`Permission request for device orientation failed - AR will not work correctly`,error:JSON.stringify(e,null,2)})}):this.eventEmitter.emit(`deviceorientationerror`,{code:`LOCAR_DEVICE_ORIENTATION_INTERNAL_ERROR`,message:`Internal error: no requestPermission() found although requestOrientationPermissions() was called - please raise an issue on GitHub`})},this.update=()=>{if(r.enabled===!1)return;let e=r.deviceOrientation;if(e){let n=e.alpha?t.MathUtils.degToRad(e.alpha)+r.alphaOffset:0,i=e.beta?t.MathUtils.degToRad(e.beta):0,a=e.gamma?t.MathUtils.degToRad(e.gamma):0,s=r.screenOrientation?t.MathUtils.degToRad(r.screenOrientation):0,c=new t.Quaternion;if(y){o(c,n,i,a,s);let l=new t.Euler().setFromQuaternion(c,`YXZ`);l.y=t.MathUtils.degToRad(360-(e.webkitCompassHeading??0))+(r.orientationOffset||0),c.setFromEuler(l)}else o(c,n,i,a,s);if(r.lastQuaternion&&r.orientationChangeThreshold>0&&c.angleTo(r.lastQuaternion)<r.orientationChangeThreshold)return;if(r.smoothingFactor<1&&r.lastQuaternion){let e=1-r.smoothingFactor;r.object.quaternion.slerp(c,e)}else r.object.quaternion.copy(c);r.lastQuaternion=r.object.quaternion.clone(),window.dispatchEvent(new CustomEvent(`camera-rotation-change`,{detail:{cameraRotation:r.object.rotation}}))}},this.getCorrectedHeading=()=>{let{deviceOrientation:e}=r;if(!e)return 0;let t=0;return y?(t=360-(e.webkitCompassHeading??0),r.orientationOffset&&(t+=r.orientationOffset*(180/Math.PI),t=(t+360)%360)):(e.absolute===!0||r.orientationChangeEventName,t=e.alpha?e.alpha:0,t=(360-t)%360,t<0&&(t+=360)),t},this.updateAlphaOffset=()=>{r.initialOffset=!1},this.dispose=()=>{r.disconnect()},this.getAlpha=()=>{let{deviceOrientation:e}=r;return e&&e.alpha?t.MathUtils.degToRad(e.alpha)+r.alphaOffset:0},this.getBeta=()=>{let{deviceOrientation:e}=r;return e&&e.beta?t.MathUtils.degToRad(e.beta):0},this.getGamma=()=>{let{deviceOrientation:e}=r;return e&&e.gamma?t.MathUtils.degToRad(e.gamma):0},this.createObtainPermissionGestureDialog=()=>{let e=document.createElement(`div`);e.classList.add(p);let t=document.createElement(`div`);t.classList.add(g);let n=document.createElement(`div`);n.classList.add(h);let r=document.createElement(`div`);r.classList.add(_);let i=document.createElement(`button`);i.classList.add(m),document.body.appendChild(e),this.enableInlineStyling===!0&&(e.style.fontFamily=`-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'`,e.style.display=`flex`,e.style.position=`fixed`,e.style.zIndex=`100000`,e.style.justifyContent=`center`,e.style.alignItems=`center`,e.style.backgroundColor=`rgba(0,0,0,0.2)`,e.style.inset=`0`,e.style.padding=`20px`,t.style.backgroundColor=`rgba(220, 220, 220, 0.85)`,t.style.padding=`6px 0`,t.style.borderRadius=`10px`,t.style.width=`100%`,t.style.maxWidth=`400px`,n.style.padding=`10px 12px`,n.style.textAlign=`center`,n.style.fontWeight=`400`,n.style.fontSize=`13px`,n.style.display=`flex`,n.style.justifyContent=`center`,n.style.alignItems=`center`,r.style.display=`block`,r.style.textAlign=`center`,r.style.textDecoration=`none`,r.style.borderTop=`rgb(180,180,180) solid 1px`,i.style.display=`block`,i.style.width=`100%`,i.style.textAlign=`center`,i.style.appearance=`none`,i.style.background=`none`,i.style.border=`none`,i.style.outline=`none`,i.style.padding=`10px`,i.style.fontWeight=`400`,i.style.fontSize=`16px`,i.style.color=`#2e7cf1`,i.style.cursor=`pointer`),e.appendChild(t),t.appendChild(n),t.appendChild(r),n.appendChild(document.createTextNode(v)),i.addEventListener(`click`,()=>{this.requestOrientationPermissions(),e.style.display=`none`}),i.appendChild(document.createTextNode(`OK`)),r.appendChild(i),document.body.appendChild(e)},this.obtainPermissionGesture=()=>{this.preferConfirmDialog===!0?window.confirm(v)&&this.requestOrientationPermissions():this.createObtainPermissionGestureDialog()}}on(e,t){this.eventEmitter.on(e,t)}},E=class{constructor(e){this.raycaster=new t.Raycaster,this.normalisedMousePosition=null,e.domElement.addEventListener(`click`,n=>{this.normalisedMousePosition=new t.Vector2(n.clientX/e.domElement.clientWidth*2-1,-(n.clientY/e.domElement.clientHeight*2)+1)})}raycast(e,t){if(this.normalisedMousePosition!==null){this.raycaster.setFromCamera(this.normalisedMousePosition,e);let n=this.raycaster.intersectObjects(t.children,!1);return this.normalisedMousePosition=null,n}return[]}},D=class extends l{#e;#t;constructor(e={video:{facingMode:`environment`}},n){super(),this.sceneWebcam=new t.Scene,n?this.#e=document.querySelector(n):(this.#e=document.createElement(`video`),this.#e.setAttribute(`autoplay`,`true`),this.#e.setAttribute(`playsinline`,`true`),this.#e.style.cssText+=`
         width: 100%;
         height: 100%;
         object-fit: cover;
@@ -7,4 +7,4 @@
         top: 0px;
         left: 0px;
 	      z-index: -100;  
-      `,document.body.appendChild(this.#e)),navigator.mediaDevices&&navigator.mediaDevices.getUserMedia?navigator.mediaDevices.getUserMedia(e).then(e=>{this.#e?.addEventListener(`loadedmetadata`,()=>{this.#e.play(),this.emit(`webcamstarted`,{videoWidth:this.#e.videoWidth,videoHeight:this.#e.videoHeight})}),this.#e&&(this.#e.srcObject=e)}).catch(e=>{this.emit(`webcamerror`,{code:e.name,message:e.message})}):this.emit(`webcamerror`,{code:`LOCAR_NO_MEDIA_DEVICES_API`,message:`Media devices API not supported`})}getVideoDimensions(){return`w ${this.#e.videoWidth}, h ${this.#e.videoHeight}`}};e.App=u,e.ClickHandler=E,e.DeviceOrientationControls=T,e.EventEmitter=l,e.LocAR=f,e.SphMercProjection=d,e.Webcam=D});
+      `,document.body.appendChild(this.#e)),this.#t=null,navigator.mediaDevices&&navigator.mediaDevices.getUserMedia?navigator.mediaDevices.getUserMedia(e).then(e=>{this.#t=e,this.#e?.addEventListener(`loadedmetadata`,()=>{this.#e.play(),this.emit(`webcamstarted`,{videoWidth:this.#e.videoWidth,videoHeight:this.#e.videoHeight})}),this.#e&&(this.#e.srcObject=e)}).catch(e=>{this.emit(`webcamerror`,{code:e.name,message:e.message})}):this.emit(`webcamerror`,{code:`LOCAR_NO_MEDIA_DEVICES_API`,message:`Media devices API not supported`})}getVideoDimensions(){return`w ${this.#e.videoWidth}, h ${this.#e.videoHeight}`}dispose(){(this.#t?.getTracks()??[]).forEach(e=>{e.stop()}),this.#t=null,this.#e?.remove(),this.#e=null}};e.App=u,e.ClickHandler=E,e.DeviceOrientationControls=T,e.EventEmitter=l,e.LocAR=f,e.SphMercProjection=d,e.Webcam=D});

package/dist/three/app.d.ts

@@ -0,0 +1,32 @@
+import { LocAR, Webcam, DeviceOrientationControls } from './main';
+import { default as EventEmitter } from './event-emitter';
+import { AppOptions } from '../types/locar';
+import * as THREE from 'three';
+/** Application class to orchestrate the interaction between the individual LocAR classes and the Three.js camera, renderer and scene. */
+declare class App extends EventEmitter {
+    #private;
+    locar: LocAR;
+    camera: THREE.PerspectiveCamera;
+    renderer: THREE.WebGLRenderer;
+    scene: THREE.Scene;
+    webcam: Webcam;
+    deviceOrientationControls: DeviceOrientationControls | null;
+    cameraFeedDimensions: {
+        landWidth: number;
+        landHeight: number;
+    } | null; /** camera feed dimensions in LANDSCAPE  */
+    origHfov: number;
+    /**
+      * Create an App object.
+      * @param {AppOptions} - Startup options.
+      */
+    constructor({ cameraOptions, canvas, gpsOptions, videoConstraints, deviceOrientationOptions, serverLogger, projection }: AppOptions);
+    /**
+     * Start the app.
+     * Must be called after construction.
+     * @returns {Promise<LocAR>}
+     * Promise resolving with LocAR object. Rejects with object containing code and message.
+     */
+    start(): Promise<LocAR>;
+}
+export default App;

package/dist/three/click-handler.d.ts

@@ -0,0 +1,25 @@
+import * as THREE from "three";
+/**
+ * Class to handle object detection via mouse clicks/touch events
+ * and raycasting.
+ */
+declare class ClickHandler {
+    raycaster: THREE.Raycaster;
+    normalisedMousePosition: THREE.Vector2 | null;
+    /**
+     * Create a ClickHandler.
+     * @param {THREE.WebGLRenderer} - The Three.js renderer on which the click
+     * events will be handled.
+     */
+    constructor(renderer: THREE.WebGLRenderer);
+    /**
+     * Cast a ray into the scene to detect objects.
+     * @param {THREE.Camera} - The active Three.js camera, from which the ray
+     * will be cast.
+     * @param {THREE.Scene} - The active Three.js scene, which the ray will be
+     * cast into.
+     * @return {Array} - array of all intersected objects.
+     */
+    raycast(camera: THREE.Camera, scene: THREE.Scene): THREE.Intersection[];
+}
+export default ClickHandler;

package/dist/three/device-orientation-controls.d.ts

@@ -0,0 +1,55 @@
+import { EventDispatcher, Object3D, Quaternion } from 'three';
+import { default as EventEmitter } from './event-emitter';
+import { DeviceOrientationControlsOptions } from '../types/locar';
+declare class DeviceOrientationControls extends EventDispatcher {
+    eventEmitter: EventEmitter;
+    object: Object3D;
+    enabled: boolean;
+    deviceOrientation: {
+        alpha?: number;
+        beta?: number;
+        gamma?: number;
+        webkitCompassHeading?: number;
+        absolute?: boolean;
+    } | null;
+    screenOrientation: number;
+    alphaOffset: number;
+    orientationOffset: number;
+    initialOffset: boolean | null;
+    lastQuaternion: Quaternion | null;
+    orientationChangeEventName: "deviceorientation" | "deviceorientationabsolute";
+    smoothingFactor: number;
+    enablePermissionDialog: boolean;
+    enableInlineStyling: boolean;
+    preferConfirmDialog: boolean;
+    orientationChangeThreshold: number;
+    connect: () => void;
+    disconnect: () => void;
+    requestOrientationPermissions: () => void;
+    update: () => void;
+    getCorrectedHeading: () => number;
+    updateAlphaOffset: () => void;
+    dispose: () => void;
+    getAlpha: () => number;
+    getBeta: () => number;
+    getGamma: () => number;
+    createObtainPermissionGestureDialog: () => void;
+    obtainPermissionGesture: () => void;
+    /**
+     * Create an instance of DeviceOrientationControls.
+     * @param {Object} object - the object to attach the controls to
+     * (usually your Three.js camera)
+     * @param {Object} options - options for DeviceOrientationControls:
+     * currently accepts smoothingFactor (< 1), enablePermissionDialog, orientationChangeThreshold (radians)
+     */
+    constructor(object: Object3D, options?: DeviceOrientationControlsOptions);
+    on(eventName: string, eventHandler: (event: any) => void): void;
+    /**
+     * Initialise device orientation controls.
+     * Should be called after you have created the DeviceOrientationControls
+     * object and set up the deviceorientationgranted and deviceorientationerror
+     * event handlers.
+     */
+    init: () => void;
+}
+export default DeviceOrientationControls;

package/dist/three/event-emitter.d.ts

@@ -0,0 +1,24 @@
+/** Event emitter class to handle events. */
+declare class EventEmitter {
+    eventHandlers: Record<string, ((...args: any[]) => void)[]>;
+    constructor();
+    /**
+     * Add an event handler.
+     * @param {string} eventName - the event to handle.
+     * @param {Function} eventHandler - the event handler function.
+     */
+    on: (eventName: string, eventHandler: (...args: any[]) => void) => void;
+    /**
+     * Emit an event.
+     * @param {string} eventName - the event to emit.
+     * @param ...params - parameters to pass to the event handlers.
+     */
+    emit: (eventName: string, ...params: any[]) => void;
+    /**
+     * Remove an event handler.
+     * @param {string} eventName - the event to remove a handler from.
+     * @param {Function} eventHandler - the event handler function to remove.
+     */
+    off: (eventName: string, eventHandler: (...args: any[]) => void) => void;
+}
+export default EventEmitter;

package/dist/three/locar.d.ts

@@ -0,0 +1,112 @@
+import { default as EventEmitter } from './event-emitter';
+import { LonLat, Projection, ServerLogger, GpsOptions } from '../types/locar';
+import * as THREE from "three";
+/** The main engine class for the LocAR.js system.
+ * Can be obtained either via App.start() - which resolves with a LocAR object - or on its own.
+ * If you use this class without App, you must set up the three.js scene yourself, as you did with locar.js 0.1.x.
+ */
+declare class LocAR extends EventEmitter {
+    #private;
+    scene: THREE.Scene;
+    camera: THREE.Camera;
+    /**
+     * @param {THREE.Scene} scene - The Three.js scene to use.
+     * @param {THREE.Camera} camera - The Three.js camera to use. Should usually
+     * be a THREE.PerspectiveCamera.
+     * @param {Object} options - Initialisation options for the GPS; see
+     * setGpsOptions() below.
+     * @param {Object} serverLogger - an object which can optionally log GPS position to a server for debugging. null by default, so no logging will be done. This object should implement a sendData() method to send data (2nd arg) to a given endpoint (1st arg). Please see source code for details. Ensure you comply with privacy laws (GDPR or equivalent) if implementing this.
+     */
+    constructor(scene: THREE.Scene, camera: THREE.Camera, options?: GpsOptions, serverLogger?: ServerLogger | null, projection?: Projection);
+    /**
+     * Set the projection to use.
+     * @param {Object} any object which includes a project() method
+     * taking longitude and latitude as arguments and returning an array
+     * containing easting and northing.
+     */
+    setProjection(proj: Projection): void;
+    /**
+     * Set the GPS options.
+     * @param {Object} object containing gpsMinDistance and/or gpsMinAccuracy
+     * properties. The former specifies the number of metres which the device
+     * must move to process a new GPS reading, and the latter specifies the
+     * minimum accuracy, in metres, for a GPS reading to be counted.
+     */
+    setGpsOptions(options?: GpsOptions): void;
+    /**
+     * Start the GPS on a real device
+     * @return {boolean} code indicating whether the GPS was started successfully.
+     * GPS errors can be handled by handling the gpserror event.
+     */
+    startGps(): Promise<boolean>;
+    /**
+     * Stop the GPS on a real device
+     * @return {boolean} true if the GPS was stopped, false if it could not be
+     * stopped (i.e. it was never started).
+     */
+    stopGps(): boolean;
+    /**
+     * Send a fake GPS signal. Useful for testing on a desktop or laptop.
+     * @param {number} lon - The longitude.
+     * @param {number} lat - The latitude.
+     * @param {number} elev - The elevation in metres. (optional, set to null
+     * for no elevation).
+     * @param {number} acc - The accuracy of the GPS reading in metres. May be
+     * ignored if lower than the specified minimum accuracy.
+     */
+    fakeGps(lon: number, lat: number, elev?: number | null, acc?: number): void;
+    /**
+     * Convert longitude and latitude to three.js/WebGL world coordinates.
+     * Uses the specified projection, and negates the northing (in typical
+     * projections, northings increase northwards, but in the WebGL coordinate
+     * system, we face negative z if the camera is at the origin with default
+     * rotation).
+     * Must not be called until an initial position is determined.
+     * @param {number} lon - The longitude.
+     * @param {number} lat - The latitude.
+     * @return {Array} a two member array containing the WebGL x and z coordinates
+     */
+    lonLatToWorldCoords(lon: number, lat: number): [number, number];
+    /**
+    * Convert projected east/north coordinates to three.js/WebGL world coordinates.
+    * Negates the northing (in typical projections, northings increase northwards,
+    * but in the WebGL coordinate system, we face negative z if the camera is at
+    * the origin with default rotation).
+    * Must not be called until an initial position is determined.
+    * It is assumed that the projected position is in the correct projection - no check
+    * for this is made.
+    * @param {Array} projectedPos - the projected position.
+    * @return {Array} a two member array containing the WebGL x and z coordinates
+    */
+    eastNorthToWorldCoords(projectedPos: [number, number]): [number, number];
+    /**
+     * Add a new AR object at a given latitude, longitude and elevation.
+     * @param {THREE.Mesh} object the object
+     * @param {number} lon - the longitude.
+     * @param {number} lat - the latitude.
+     * @param {number} elev - the elevation in metres
+     * (if not specified, 0 is assigned)
+     * @param {Object} properties - properties describing the object (for example,
+     * the contents of the GeoJSON properties field).
+     */
+    add(object: THREE.Object3D, lon: number, lat: number, elev?: number | undefined, properties?: Record<string, any>): void;
+    addGeoLine(points: Array<[number, number, number?]>, material: THREE.Material, lineWidth?: number): THREE.Mesh;
+    /**
+     * Set the elevation (y coordinate) of the camera.
+     * @param {number} elev - the elevation in metres.
+     */
+    setElevation(elev: number): void;
+    /**
+     * Calculate haversine distance between two lat/lon pairs.
+     *
+     * Taken from original A-Frame AR.js location-based components
+     */
+    static haversineDist(src: LonLat, dest: LonLat): number;
+    /**
+     * Obtain the last known GPS location.
+     *
+     * @return {Object} object containing latitude and longitude fields, or null if no previous GPS location.
+     */
+    getLastKnownLocation(): LonLat | null;
+}
+export default LocAR;

package/dist/three/main.d.ts

@@ -0,0 +1,9 @@
+import { default as App } from './app';
+import { default as LocAR } from './locar';
+import { default as SphMercProjection } from './sphmerc-projection';
+import { default as DeviceOrientationControls } from './device-orientation-controls';
+import { default as ClickHandler } from './click-handler';
+import { default as EventEmitter } from './event-emitter';
+import { default as Webcam } from './webcam';
+export type { LonLat, ServerLogger, WebcamStartedEvent, WebcamErrorEvent, DeviceOrientationErrorEvent, DeviceOrientationGrantedEvent, GpsReceivedEvent, Projection, AppOptions, GpsOptions, DeviceOrientationControlsOptions } from '../types/locar';
+export { App, LocAR, Webcam, SphMercProjection, DeviceOrientationControls, ClickHandler, EventEmitter };

package/dist/three/sphmerc-projection.d.ts

@@ -0,0 +1,29 @@
+import { Projection } from '../types/locar';
+declare class SphMercProjection implements Projection {
+    #private;
+    EARTH: number;
+    HALF_EARTH: number;
+    /**
+     * Create a SphMercProjection.
+     */
+    constructor();
+    /**
+     * Project a longitude and latitude into Spherical Mercator.
+     * @param {number} lon - the longitude.
+     * @param {number} lat - the latitude.
+     * @return {Array} Two-member array containing easting and northing.
+     */
+    project: (lon: number, lat: number) => [number, number];
+    /**
+     * Unproject a Spherical Mercator easting and northing.
+     * @param {Array} projected - Two-member array containing easting and northing
+     * @return {Array} Two-member array containing longitude and latitude
+     */
+    unproject: (projected: [number, number]) => [number, number];
+    /**
+     * Return the projection's ID.
+     * @return {string} The value "epsg:3857".
+     */
+    getID: () => string;
+}
+export default SphMercProjection;

package/dist/three/webcam.d.ts

@@ -0,0 +1,27 @@
+import { default as EventEmitter } from './event-emitter';
+import * as THREE from "three";
+export type { WebcamStartedEvent, WebcamErrorEvent } from '../types/locar';
+/** Class to setup the webcam. */
+declare class Webcam extends EventEmitter {
+    #private;
+    sceneWebcam: THREE.Scene;
+    /**
+     * Create a Webcam.
+     * @param constraints {Object} - options to use for initialising the camera.
+     * This is the same constraints object as used by standard MediaDevices API.
+     * @param {string} videoElementSelector - selector to obtain the HTML video
+     * element to render the webcam feed. If a falsy value (e.g. null or
+     * undefined), a video element will be created.
+     */
+    constructor(constraints?: {
+        video: {
+            facingMode: string;
+        };
+    }, videoElementSelector?: string);
+    getVideoDimensions(): string;
+    /**
+     * Free up the resources associated with the Webcam.
+     */
+    dispose(): void;
+}
+export default Webcam;

package/dist/types/locar.d.ts

@@ -0,0 +1,89 @@
+import { default as DeviceOrientationControls } from '../three/device-orientation-controls';
+/** Longitude and latitude. */
+export interface LonLat {
+    longitude: number;
+    latitude: number;
+}
+/** Projection interface, you can create your own custom projection by implementing project() and unproject(). */
+export interface Projection {
+    project: (lon: number, lat: number) => [number, number];
+    unproject: (projected: [number, number]) => [number, number];
+}
+/** Server logger interface. */
+export interface ServerLogger {
+    sendData(endpoint: string, data: any): Promise<Response> | Response;
+}
+/** Generic event. */
+export interface Event {
+}
+/** Event emitted when the webcam starts. */
+export interface WebcamStartedEvent {
+    videoWidth: number;
+    videoHeight: number;
+}
+/** Event emitted when the webcam encounters an error. */
+export interface WebcamErrorEvent {
+    code: string;
+    message: string;
+}
+/** Event emitted when device orientation permission has been granted. */
+export interface DeviceOrientationGrantedEvent {
+    target: DeviceOrientationControls;
+}
+/** Event emitted when there is an error with device orientation. */
+export interface DeviceOrientationErrorEvent {
+    code: string;
+    message: string;
+}
+/** Event emitted when a GPS position is received. */
+export interface GpsReceivedEvent {
+    /** The new GPS position */
+    position: GeolocationPosition;
+    /** distance moved in metres since last GpsReceivedEvent */
+    distMoved: number;
+}
+/** GPS intialisation options. */
+export interface GpsOptions {
+    gpsMinDistance?: number;
+    gpsMinAccuracy?: number;
+}
+/** Options to pass into DeviceOrientationControls. */
+export type DeviceOrientationControlsOptions = {
+    /** smoothingFactor - default 0.2. If too high, AR content movement will lag behind the sensors. If too low, the scene will be jittery. */
+    smoothingFactor?: number;
+    /** Movement threshold to detect an orientation change (radians). */
+    orientationChangeThreshold?: number;
+    /** On iOS, enable permission dialog to seek permission to use device orientation through a user gesture. Recommended to set to true */
+    enablePermissionDialog?: boolean;
+    /** Set iOS-look and feel styling for the permission dialog for device orientation */
+    enableStyling?: boolean;
+    /** Use a standard confirm dialog rather than a custom element to grant device orientation permissions */
+    preferConfirmDialog?: boolean;
+};
+/** Options to pass into the App object. */
+export interface AppOptions {
+    /** the three.js camera options to use - note however we specify horizontal, not vertical, field of view */
+    cameraOptions?: {
+        hFov: number;
+        near: number;
+        far: number;
+    };
+    /** the canvas to render the AR scene into (one will be created if omitted) */
+    canvas?: HTMLCanvasElement;
+    /** GPS options, see GpsOptions documentation for details */
+    gpsOptions?: GpsOptions;
+    /** Video constraints for Media Devices API */
+    videoConstraints?: {
+        video: {
+            facingMode: string;
+        };
+    };
+    /** Device orientation options for DeviceOrientationControls */
+    deviceOrientationOptions?: DeviceOrientationControlsOptions & {
+        enabled: boolean;
+    };
+    /** Projection to use (default: SphMercProjection) */
+    projection?: Projection;
+    /** Server logger to use - ensure you gain consent from the user if you are doing this, it's usually a Data Protection legal requirement */
+    serverLogger?: ServerLogger;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "locar",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Location-based AR from AR.js.",
   "files": [
     "dist"
@@ -23,30 +23,20 @@
     "makedocs": "typedoc --out docs/api lib/three/main.ts"
   },
   "devDependencies": {
-    "@eslint/css": "^0.11.0",
-    "@eslint/js": "^9.35.0",
-    "@eslint/json": "^0.13.2",
+    "@eslint/css": "^1.4.0",
+    "@eslint/js": "^10.0.1",
+    "@eslint/json": "^2.0.1",
     "@types/three": "^0.181.0",
     "esbuild":"^0.28.1",
-    "eslint": "^9.38.0",
+    "eslint": "^10.8.0",
     "globals": "^16.4.0",
-    "typedoc": "^0.28.19",
-    "minimatch": "^9.0.7",
-    "prettier-eslint": "^16.4.2",
+    "typedoc": "^0.28.20",
+    "prettier-eslint": "^17.1.1",
     "typescript": "^5.9.3",
-    "vite": "^8.0.16",
-    "vite-plugin-dts": "^4.5.4"
+    "vite": "^8.1.5",
+    "vite-plugin-dts": "^5.0.3"
   },
   "dependencies": {
-    "minimatch": "^9.0.7",
-    "three": "^0.180.0"
-  },
-  "overrides" : {
-    "prettier-eslint": {
-      "minimatch": "$minimatch"
-    },
-    "vite": {
-      "esbuild": "$esbuild"
-    }
+    "three": "^0.181.0"
   }
 }

package/dist/locar.d.ts

@@ -1,387 +0,0 @@
-import { EventDispatcher } from 'three';
-import { Object3D } from 'three';
-import { Quaternion } from 'three';
-import * as THREE from 'three';
-
-/** Application class to orchestrate the interaction between the individual LocAR classes and the Three.js camera, renderer and scene. */
-export declare class App extends EventEmitter {
-    #private;
-    locar: LocAR;
-    camera: THREE.PerspectiveCamera;
-    renderer: THREE.WebGLRenderer;
-    scene: THREE.Scene;
-    webcam: Webcam;
-    deviceOrientationControls: DeviceOrientationControls | null;
-    cameraFeedDimensions: {
-        landWidth: number;
-        landHeight: number;
-    } | null; /** camera feed dimensions in LANDSCAPE  */
-    origHfov: number;
-    /**
-     * Create an App object.
-     * @param {AppOptions} - Startup options.
-     */
-    constructor({ cameraOptions, canvas, gpsOptions, videoConstraints, deviceOrientationOptions, serverLogger, projection }: AppOptions);
-    /**
-     * Start the app.
-     * Must be called after construction.
-     * @returns {Promise<LocAR>}
-     * Promise resolving with LocAR object. Rejects with object containing code and message.
-     */
-    start(): Promise<LocAR>;
-}
-
-/** Options to pass into the App object. */
-export declare interface AppOptions {
-    /** the three.js camera options to use - note however we specify horizontal, not vertical, field of view */
-    cameraOptions?: {
-        hFov: number;
-        near: number;
-        far: number;
-    };
-    /** the canvas to render the AR scene into (one will be created if omitted) */
-    canvas?: HTMLCanvasElement;
-    /** GPS options, see GpsOptions documentation for details */
-    gpsOptions?: GpsOptions;
-    /** Video constraints for Media Devices API */
-    videoConstraints?: {
-        video: {
-            facingMode: string;
-        };
-    };
-    /** Device orientation options for DeviceOrientationControls */
-    deviceOrientationOptions?: DeviceOrientationControlsOptions & {
-        enabled: boolean;
-    };
-    /** Projection to use (default: SphMercProjection) */
-    projection?: Projection;
-    /** Server logger to use - ensure you gain consent from the user if you are doing this, it's usually a Data Protection legal requirement */
-    serverLogger?: ServerLogger;
-}
-
-/**
- * Class to handle object detection via mouse clicks/touch events
- * and raycasting.
- */
-export declare class ClickHandler {
-    raycaster: THREE.Raycaster;
-    normalisedMousePosition: THREE.Vector2 | null;
-    /**
-     * Create a ClickHandler.
-     * @param {THREE.WebGLRenderer} - The Three.js renderer on which the click
-     * events will be handled.
-     */
-    constructor(renderer: THREE.WebGLRenderer);
-    /**
-     * Cast a ray into the scene to detect objects.
-     * @param {THREE.Camera} - The active Three.js camera, from which the ray
-     * will be cast.
-     * @param {THREE.Scene} - The active Three.js scene, which the ray will be
-     * cast into.
-     * @return {Array} - array of all intersected objects.
-     */
-    raycast(camera: THREE.Camera, scene: THREE.Scene): THREE.Intersection[];
-}
-
-export declare class DeviceOrientationControls extends EventDispatcher {
-    eventEmitter: EventEmitter;
-    object: Object3D;
-    enabled: boolean;
-    deviceOrientation: {
-        alpha?: number;
-        beta?: number;
-        gamma?: number;
-        webkitCompassHeading?: number;
-        absolute?: boolean;
-    } | null;
-    screenOrientation: number;
-    alphaOffset: number;
-    orientationOffset: number;
-    initialOffset: boolean | null;
-    lastQuaternion: Quaternion | null;
-    orientationChangeEventName: "deviceorientation" | "deviceorientationabsolute";
-    smoothingFactor: number;
-    enablePermissionDialog: boolean;
-    enableInlineStyling: boolean;
-    preferConfirmDialog: boolean;
-    orientationChangeThreshold: number;
-    connect: () => void;
-    disconnect: () => void;
-    requestOrientationPermissions: () => void;
-    update: () => void;
-    getCorrectedHeading: () => number;
-    updateAlphaOffset: () => void;
-    dispose: () => void;
-    getAlpha: () => number;
-    getBeta: () => number;
-    getGamma: () => number;
-    createObtainPermissionGestureDialog: () => void;
-    obtainPermissionGesture: () => void;
-    /**
-     * Create an instance of DeviceOrientationControls.
-     * @param {Object} object - the object to attach the controls to
-     * (usually your Three.js camera)
-     * @param {Object} options - options for DeviceOrientationControls:
-     * currently accepts smoothingFactor (< 1), enablePermissionDialog, orientationChangeThreshold (radians)
-     */
-    constructor(object: Object3D, options?: DeviceOrientationControlsOptions);
-    on(eventName: string, eventHandler: (event: any) => void): void;
-    /**
-     * Initialise device orientation controls.
-     * Should be called after you have created the DeviceOrientationControls
-     * object and set up the deviceorientationgranted and deviceorientationerror
-     * event handlers.
-     */
-    init: () => void;
-}
-
-/** Options to pass into DeviceOrientationControls. */
-export declare type DeviceOrientationControlsOptions = {
-    /** smoothingFactor - default 0.2. If too high, AR content movement will lag behind the sensors. If too low, the scene will be jittery. */
-    smoothingFactor?: number;
-    /** Movement threshold to detect an orientation change (radians). */
-    orientationChangeThreshold?: number;
-    /** On iOS, enable permission dialog to seek permission to use device orientation through a user gesture. Recommended to set to true */
-    enablePermissionDialog?: boolean;
-    /** Set iOS-look and feel styling for the permission dialog for device orientation */
-    enableStyling?: boolean;
-    /** Use a standard confirm dialog rather than a custom element to grant device orientation permissions */
-    preferConfirmDialog?: boolean;
-};
-
-/** Event emitted when there is an error with device orientation. */
-export declare interface DeviceOrientationErrorEvent {
-    code: string;
-    message: string;
-}
-
-/** Event emitted when device orientation permission has been granted. */
-export declare interface DeviceOrientationGrantedEvent {
-    target: DeviceOrientationControls;
-}
-
-/** Event emitter class to handle events. */
-export declare class EventEmitter {
-    eventHandlers: Record<string, ((...args: any[]) => void)[]>;
-    constructor();
-    /**
-     * Add an event handler.
-     * @param {string} eventName - the event to handle.
-     * @param {Function} eventHandler - the event handler function.
-     */
-    on: (eventName: string, eventHandler: (...args: any[]) => void) => void;
-    /**
-     * Emit an event.
-     * @param {string} eventName - the event to emit.
-     * @param ...params - parameters to pass to the event handlers.
-     */
-    emit: (eventName: string, ...params: any[]) => void;
-    /**
-     * Remove an event handler.
-     * @param {string} eventName - the event to remove a handler from.
-     * @param {Function} eventHandler - the event handler function to remove.
-     */
-    off: (eventName: string, eventHandler: (...args: any[]) => void) => void;
-}
-
-/** GPS intialisation options. */
-export declare interface GpsOptions {
-    gpsMinDistance?: number;
-    gpsMinAccuracy?: number;
-}
-
-/** Event emitted when a GPS position is received. */
-export declare interface GpsReceivedEvent {
-    /** The new GPS position */
-    position: GeolocationPosition;
-    /** distance moved in metres since last GpsReceivedEvent */
-    distMoved: number;
-}
-
-/** The main engine class for the LocAR.js system.
- * Can be obtained either via App.start() - which resolves with a LocAR object - or on its own.
- * If you use this class without App, you must set up the three.js scene yourself, as you did with locar.js 0.1.x.
- */
-export declare class LocAR extends EventEmitter {
-    #private;
-    scene: THREE.Scene;
-    camera: THREE.Camera;
-    /**
-     * @param {THREE.Scene} scene - The Three.js scene to use.
-     * @param {THREE.Camera} camera - The Three.js camera to use. Should usually
-     * be a THREE.PerspectiveCamera.
-     * @param {Object} options - Initialisation options for the GPS; see
-     * setGpsOptions() below.
-     * @param {Object} serverLogger - an object which can optionally log GPS position to a server for debugging. null by default, so no logging will be done. This object should implement a sendData() method to send data (2nd arg) to a given endpoint (1st arg). Please see source code for details. Ensure you comply with privacy laws (GDPR or equivalent) if implementing this.
-     */
-    constructor(scene: THREE.Scene, camera: THREE.Camera, options?: GpsOptions, serverLogger?: ServerLogger | null, projection?: Projection);
-    /**
-     * Set the projection to use.
-     * @param {Object} any object which includes a project() method
-     * taking longitude and latitude as arguments and returning an array
-     * containing easting and northing.
-     */
-    setProjection(proj: Projection): void;
-    /**
-     * Set the GPS options.
-     * @param {Object} object containing gpsMinDistance and/or gpsMinAccuracy
-     * properties. The former specifies the number of metres which the device
-     * must move to process a new GPS reading, and the latter specifies the
-     * minimum accuracy, in metres, for a GPS reading to be counted.
-     */
-    setGpsOptions(options?: GpsOptions): void;
-    /**
-     * Start the GPS on a real device
-     * @return {boolean} code indicating whether the GPS was started successfully.
-     * GPS errors can be handled by handling the gpserror event.
-     */
-    startGps(): Promise<boolean>;
-    /**
-     * Stop the GPS on a real device
-     * @return {boolean} true if the GPS was stopped, false if it could not be
-     * stopped (i.e. it was never started).
-     */
-    stopGps(): boolean;
-    /**
-     * Send a fake GPS signal. Useful for testing on a desktop or laptop.
-     * @param {number} lon - The longitude.
-     * @param {number} lat - The latitude.
-     * @param {number} elev - The elevation in metres. (optional, set to null
-     * for no elevation).
-     * @param {number} acc - The accuracy of the GPS reading in metres. May be
-     * ignored if lower than the specified minimum accuracy.
-     */
-    fakeGps(lon: number, lat: number, elev?: number | null, acc?: number): void;
-    /**
-     * Convert longitude and latitude to three.js/WebGL world coordinates.
-     * Uses the specified projection, and negates the northing (in typical
-     * projections, northings increase northwards, but in the WebGL coordinate
-     * system, we face negative z if the camera is at the origin with default
-     * rotation).
-     * Must not be called until an initial position is determined.
-     * @param {number} lon - The longitude.
-     * @param {number} lat - The latitude.
-     * @return {Array} a two member array containing the WebGL x and z coordinates
-     */
-    lonLatToWorldCoords(lon: number, lat: number): [number, number];
-    /**
-     * Convert projected east/north coordinates to three.js/WebGL world coordinates.
-     * Negates the northing (in typical projections, northings increase northwards,
-     * but in the WebGL coordinate system, we face negative z if the camera is at
-     * the origin with default rotation).
-     * Must not be called until an initial position is determined.
-     * It is assumed that the projected position is in the correct projection - no check
-     * for this is made.
-     * @param {Array} projectedPos - the projected position.
-     * @return {Array} a two member array containing the WebGL x and z coordinates
-     */
-    eastNorthToWorldCoords(projectedPos: [number, number]): [number, number];
-    /**
-     * Add a new AR object at a given latitude, longitude and elevation.
-     * @param {THREE.Mesh} object the object
-     * @param {number} lon - the longitude.
-     * @param {number} lat - the latitude.
-     * @param {number} elev - the elevation in metres
-     * (if not specified, 0 is assigned)
-     * @param {Object} properties - properties describing the object (for example,
-     * the contents of the GeoJSON properties field).
-     */
-    add(object: THREE.Object3D, lon: number, lat: number, elev?: number | undefined, properties?: Record<string, any>): void;
-    addGeoLine(points: Array<[number, number, number?]>, material: THREE.Material, lineWidth?: number): THREE.Mesh;
-    /**
-     * Set the elevation (y coordinate) of the camera.
-     * @param {number} elev - the elevation in metres.
-     */
-    setElevation(elev: number): void;
-    /**
-     * Calculate haversine distance between two lat/lon pairs.
-     *
-     * Taken from original A-Frame AR.js location-based components
-     */
-    static haversineDist(src: LonLat, dest: LonLat): number;
-    /**
-     * Obtain the last known GPS location.
-     *
-     * @return {Object} object containing latitude and longitude fields, or null if no previous GPS location.
-     */
-    getLastKnownLocation(): LonLat | null;
-}
-
-/** Longitude and latitude. */
-export declare interface LonLat {
-    longitude: number;
-    latitude: number;
-}
-
-/** Projection interface, you can create your own custom projection by implementing project() and unproject(). */
-export declare interface Projection {
-    project: (lon: number, lat: number) => [number, number];
-    unproject: (projected: [number, number]) => [number, number];
-}
-
-/** Server logger interface. */
-export declare interface ServerLogger {
-    sendData(endpoint: string, data: any): Promise<Response> | Response;
-}
-
-export declare class SphMercProjection implements Projection {
-    #private;
-    EARTH: number;
-    HALF_EARTH: number;
-    /**
-     * Create a SphMercProjection.
-     */
-    constructor();
-    /**
-     * Project a longitude and latitude into Spherical Mercator.
-     * @param {number} lon - the longitude.
-     * @param {number} lat - the latitude.
-     * @return {Array} Two-member array containing easting and northing.
-     */
-    project: (lon: number, lat: number) => [number, number];
-    /**
-     * Unproject a Spherical Mercator easting and northing.
-     * @param {Array} projected - Two-member array containing easting and northing
-     * @return {Array} Two-member array containing longitude and latitude
-     */
-    unproject: (projected: [number, number]) => [number, number];
-    /**
-     * Return the projection's ID.
-     * @return {string} The value "epsg:3857".
-     */
-    getID: () => string;
-}
-
-/** Class to setup the webcam. */
-export declare class Webcam extends EventEmitter {
-    #private;
-    sceneWebcam: THREE.Scene;
-    /**
-     * Create a Webcam.
-     * @param constraints {Object} - options to use for initialising the camera.
-     * This is the same constraints object as used by standard MediaDevices API.
-     * @param {string} videoElementSelector - selector to obtain the HTML video
-     * element to render the webcam feed. If a falsy value (e.g. null or
-     * undefined), a video element will be created.
-     */
-    constructor(constraints?: {
-        video: {
-            facingMode: string;
-        };
-    }, videoElementSelector?: string);
-    getVideoDimensions(): string;
-}
-
-/** Event emitted when the webcam encounters an error. */
-export declare interface WebcamErrorEvent {
-    code: string;
-    message: string;
-}
-
-/** Event emitted when the webcam starts. */
-export declare interface WebcamStartedEvent {
-    videoWidth: number;
-    videoHeight: number;
-}
-
-export { }