locar 0.2.2 → 0.2.4

package/dist/locar.umd.js

@@ -1,4 +1,4 @@
-(function(p,u){typeof exports=="object"&&typeof module<"u"?u(exports,require("three")):typeof define=="function"&&define.amd?define(["exports","three"],u):(p=typeof globalThis<"u"?globalThis:p||self,u(p.locar={},p.THREE))})(this,(function(p,u){"use strict";function _(f){const e=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(f){for(const i in f)if(i!=="default"){const t=Object.getOwnPropertyDescriptor(f,i);Object.defineProperty(e,i,t.get?t:{enumerable:!0,get:()=>f[i]})}}return e.default=f,Object.freeze(e)}const m=_(u);class w{constructor(){this.on=(e,i)=>{this.eventHandlers[e]===void 0&&(this.eventHandlers[e]=[]),this.eventHandlers[e].push(i)},this.emit=(e,...i)=>{this.eventHandlers[e]?.forEach(t=>{t(...i)})},this.off=(e,i)=>{if(this.eventHandlers[e]){const t=this.eventHandlers[e].indexOf(i);t>-1&&this.eventHandlers[e].splice(t,1)}},this.eventHandlers={}}}class T extends w{constructor({cameraOptions:e,canvas:i,gpsOptions:t,videoConstraints:o,deviceOrientationOptions:l,serverLogger:g,projection:n}){super(),this.origHfov=e?.hFov||80;const s=0;this.cameraFeedDimensions=null;const d=window.innerWidth/window.innerHeight;this.camera=new m.PerspectiveCamera(this.origHfov/d,d,e?.near||.001,e?.far||1e3),i?(this.renderer=new m.WebGLRenderer({canvas:i,alpha:!0}),this.renderer.setClearColor(65280,s)):(this.renderer=new m.WebGLRenderer({alpha:!0}),this.renderer.setClearColor(65280,s),document.body.appendChild(this.renderer.domElement)),this.renderer.setSize(window.innerWidth,window.innerHeight),this.scene=new m.Scene;const c=l||{enabled:!0};window.addEventListener("resize",()=>{this.renderer.setSize(window.innerWidth,window.innerHeight);const a=window.innerWidth/window.innerHeight;if(this.camera.aspect=a,this.cameraFeedDimensions!==null){const h=a>1?this.cameraFeedDimensions.landWidth:this.cameraFeedDimensions.landHeight,v=a>1?this.cameraFeedDimensions.landHeight:this.cameraFeedDimensions.landWidth;this.#e(h,v,a)}this.camera.updateProjectionMatrix()}),this.locar=new y(this.scene,this.camera,t,g,n),this.webcam=new D(o),this.deviceOrientationControls=c.enabled===!0?new A(this.camera,c):null,this.renderer.setAnimationLoop(()=>{this.deviceOrientationControls?.update(),this.renderer.render(this.scene,this.camera)})}start(){return new Promise((i,t)=>{this.webcam.on("webcamstarted",o=>{const l=o.videoWidth>o.videoHeight;this.cameraFeedDimensions={landWidth:l?o.videoWidth:o.videoHeight,landHeight:l?o.videoHeight:o.videoWidth},this.#e(o.videoWidth,o.videoHeight,window.innerWidth/window.innerHeight),this.camera.updateProjectionMatrix()}),this.webcam.on("webcamerror",o=>{t({code:o.code,message:o.message})}),this.deviceOrientationControls===null?i(this.locar):(this.deviceOrientationControls?.on("deviceorientationgranted",o=>{o.target.connect(),i(this.locar)}),this.deviceOrientationControls.on("deviceorientationerror",o=>{t({code:o.code,message:o.message})}),this.deviceOrientationControls.init())})}#e(e,i,t){const o=e/i;if(t<o){const l=e*(window.innerHeight/i),g=this.origHfov*(window.innerWidth/l);this.camera.fov=g/t}else this.camera.fov=this.origHfov/t}}class b{constructor(){this.project=(e,i)=>[this.#e(e),this.#t(i)],this.unproject=e=>[this.#i(e[0]),this.#n(e[1])],this.#e=e=>e/180*this.HALF_EARTH,this.#t=e=>{var i=Math.log(Math.tan((90+e)*Math.PI/360))/(Math.PI/180);return i*this.HALF_EARTH/180},this.#i=e=>e/this.HALF_EARTH*180,this.#n=e=>{var i=e/this.HALF_EARTH*180;return i=180/Math.PI*(2*Math.atan(Math.exp(i*Math.PI/180))-Math.PI/2),i},this.getID=()=>"epsg:3857",this.EARTH=4007501668e-2,this.HALF_EARTH=2003750834e-2}#e;#t;#i;#n}class y extends w{#e;#t;#i;#n;#a;#s;#d;#r;#o;constructor(e,i,t={},o=null,l=new b){super(),this.scene=e,this.camera=i,this.#e=l,this.#t=null,this.#i=0,this.#n=100,this.#a=null,this.setGpsOptions(t),this.#s=null,this.#d=0,this.#r=0,this.#o=o}setProjection(e){this.#e=e}setGpsOptions(e={}){e.gpsMinDistance!==void 0&&(this.#i=e.gpsMinDistance),e.gpsMinAccuracy!==void 0&&(this.#n=e.gpsMinAccuracy)}async startGps(){if(this.#o){const i=await(await this.#o.sendData("/gps/start",{gpsMinDistance:this.#i,gpsMinAccuracy:this.#n})).json();this.#r=i.session}return this.#a===null?(this.#a=navigator.geolocation.watchPosition(e=>{this.#c(e)},e=>{this.emit("gpserror",e)},{enableHighAccuracy:!0}),!0):!1}stopGps(){return this.#a!==null?(navigator.geolocation.clearWatch(this.#a),this.#a=null,!0):!1}fakeGps(e,i,t=null,o=0){t!==null&&this.setElevation(t),this.#c({coords:{longitude:e,latitude:i,accuracy:o}})}lonLatToWorldCoords(e,i){const t=this.#e.project(e,i);if(this.#s)t[0]-=this.#s[0],t[1]-=this.#s[1];else throw"No initial position determined";return[t[0],-t[1]]}add(e,i,t,o,l={}){e.properties=l,this.#l(e,i,t,o||0),this.scene.add(e),this.#o?.sendData("/object/new",{position:e.position,x:e.position.x,z:e.position.z,session:this.#r,properties:l})}addGeoLine(e,i,t=1){const o=e.map((n=>{const[s,d]=this.lonLatToWorldCoords(n[0],n[1]);return new m.Vector3(s,n[2]||0,d)})),l=this.#h(o,t);i.setValues({side:m.DoubleSide});const g=new m.Mesh(l,i);return this.scene.add(g),g}#h(e,i){let t,o,l,g,n=0,s=0,d=[],c;const a=e.length-1,h=[];for(let r=0;r<a;r++)t=e[r+1].x-e[r].x,o=e[r+1].z-e[r].z,l=e[r+1].y-e[r].y,g=Math.sqrt(t*t+l*l+o*o),n=-(o*(i/2))/g,s=t*(i/2)/g,c=[e[r].x-n,e[r].y,e[r].z-s,e[r].x+n,e[r].y,e[r].z+s],r>0&&c.forEach((P,V)=>{P=(P+d[V])/2}),h.push(...c),d=[e[r+1].x-n,e[r+1].y,e[r+1].z-s,e[r+1].x+n,e[r+1].y,e[r+1].z+s];h.push(e[a].x-n),h.push(e[a].y),h.push(e[a].z-s),h.push(e[a].x+n),h.push(e[a].y),h.push(e[a].z+s);let v=[];for(let r=0;r<a;r++)v.push(r*2,r*2+1,r*2+2),v.push(r*2+1,r*2+3,r*2+2);let O=new m.BufferGeometry,z=new Float32Array(h);return O.setIndex(v),O.setAttribute("position",new m.BufferAttribute(z,3)),O.computeBoundingBox(),O}#l(e,i,t,o){const l=this.lonLatToWorldCoords(i,t);o!==void 0&&(e.position.y=o),[e.position.x,e.position.z]=l}setElevation(e){this.camera.position.y=e}#u(e,i){this.#s=this.#e.project(e,i)}#c(e){let i=Number.MAX_VALUE;this.#d++,this.#o?.sendData("/gps/new",{gpsCount:this.#d,lat:e.coords.latitude,lon:e.coords.longitude,acc:e.coords.accuracy,session:this.#r}),e.coords.accuracy<=this.#n&&(this.#t===null?this.#t={latitude:e.coords.latitude,longitude:e.coords.longitude}:i=y.haversineDist(this.#t,e.coords),i>=this.#i&&(this.#t.longitude=e.coords.longitude,this.#t.latitude=e.coords.latitude,this.#s||(this.#u(e.coords.longitude,e.coords.latitude),this.#o?.sendData("/worldorigin/new",{gpsCount:this.#d,lat:e.coords.latitude,lon:e.coords.longitude,session:this.#r,initialPosition:this.#s})),this.#l(this.camera,e.coords.longitude,e.coords.latitude),this.#o?.sendData("/gps/accepted",{gpsCount:this.#d,cameraX:this.camera.position.x,cameraZ:this.camera.position.z,session:this.#r,distMoved:i}),this.emit("gpsupdate",{position:e,distMoved:i})))}static haversineDist(e,i){const t=m.MathUtils.degToRad(i.longitude-e.longitude),o=m.MathUtils.degToRad(i.latitude-e.latitude),l=Math.sin(o/2)*Math.sin(o/2)+Math.cos(m.MathUtils.degToRad(e.latitude))*Math.cos(m.MathUtils.degToRad(i.latitude))*(Math.sin(t/2)*Math.sin(t/2));return 2*Math.atan2(Math.sqrt(l),Math.sqrt(1-l))*6371e3}getLastKnownLocation(){return this.#t}}const R="locar-device-orientation-permission-modal",x="locar-device-orientation-permission-button",L="locar-device-orientation-permission-message",S="locar-device-orientation-permission-inner",N="locar-device-orientation-permission-button-inner",C="This immersive website requires access to your device motion sensors.",E=navigator.userAgent.match(/iPhone|iPad|iPod/i)||/Macintosh/i.test(navigator.userAgent)&&navigator.maxTouchPoints!=null&&navigator.maxTouchPoints>1,H=new u.Vector3(0,0,1),M=new u.Euler,W=new u.Quaternion,F=new u.Quaternion(-Math.sqrt(.5),0,0,Math.sqrt(.5)),I=.5*Math.PI;class A extends u.EventDispatcher{constructor(e,i={}){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 w;const t=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=i.smoothingFactor||.2,this.enablePermissionDialog=i.enablePermissionDialog??!0,this.enableInlineStyling=i.enableStyling??!0,this.preferConfirmDialog=i.preferConfirmDialog??!1,this.orientationChangeThreshold=i.orientationChangeThreshold??0;const o=n=>{let{alpha:s,beta:d,gamma:c,webkitCompassHeading:a}=n;if(s=s??0,d=d??0,c=c??0,a=a??0,E){const h=360-a;t.alphaOffset=u.MathUtils.degToRad(h-s),t.deviceOrientation={alpha:s,beta:d,gamma:c,webkitCompassHeading:a}}else s<0&&(s+=360),t.deviceOrientation={alpha:s,beta:d,gamma:c};window.dispatchEvent(new CustomEvent("camera-rotation-change",{detail:{cameraRotation:e.rotation}}))},l=()=>{t.screenOrientation=window.screen.orientation?.angle??0,E&&(t.screenOrientation===90?t.orientationOffset=-I:t.screenOrientation===-90?t.orientationOffset=I:t.orientationOffset=0)},g=(n,s,d,c,a)=>{M.set(d,s,-c,"YXZ"),n.setFromEuler(M),n.multiply(F),n.multiply(W.setFromAxisAngle(H,-a))};this.connect=()=>{l(),window.addEventListener("orientationchange",l),window.addEventListener(t.orientationChangeEventName,o),t.enabled=!0},this.disconnect=()=>{window.removeEventListener("orientationchange",l),window.removeEventListener(t.orientationChangeEventName,o),t.enabled=!1,t.initialOffset=!1,t.deviceOrientation=null,t.lastQuaternion=null},this.requestOrientationPermissions=()=>{window.DeviceOrientationEvent!==void 0&&typeof window.DeviceOrientationEvent.requestPermission=="function"?window.DeviceOrientationEvent.requestPermission().then(n=>{n==="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(n=>{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(n,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(t.enabled===!1)return;const n=t.deviceOrientation;if(n){let s=n.alpha?u.MathUtils.degToRad(n.alpha)+t.alphaOffset:0,d=n.beta?u.MathUtils.degToRad(n.beta):0,c=n.gamma?u.MathUtils.degToRad(n.gamma):0;const a=t.screenOrientation?u.MathUtils.degToRad(t.screenOrientation):0,h=new u.Quaternion;if(E){g(h,s,d,c,a);const v=new u.Euler().setFromQuaternion(h,"YXZ"),O=u.MathUtils.degToRad(360-(n.webkitCompassHeading??0));v.y=O+(t.orientationOffset||0),h.setFromEuler(v)}else g(h,s,d,c,a);if(t.lastQuaternion&&t.orientationChangeThreshold>0&&h.angleTo(t.lastQuaternion)<t.orientationChangeThreshold)return;if(t.smoothingFactor<1&&t.lastQuaternion){const v=1-t.smoothingFactor;t.object.quaternion.slerp(h,v)}else t.object.quaternion.copy(h);t.lastQuaternion=t.object.quaternion.clone(),window.dispatchEvent(new CustomEvent("camera-rotation-change",{detail:{cameraRotation:t.object.rotation}}))}},this.getCorrectedHeading=()=>{const{deviceOrientation:n}=t;if(!n)return 0;let s=0;return E?(s=360-(n.webkitCompassHeading??0),t.orientationOffset&&(s+=t.orientationOffset*(180/Math.PI),s=(s+360)%360)):(n.absolute===!0||t.orientationChangeEventName,s=n.alpha?n.alpha:0,s=(360-s)%360,s<0&&(s+=360)),s},this.updateAlphaOffset=()=>{t.initialOffset=!1},this.dispose=()=>{t.disconnect()},this.getAlpha=()=>{const{deviceOrientation:n}=t;return n&&n.alpha?u.MathUtils.degToRad(n.alpha)+t.alphaOffset:0},this.getBeta=()=>{const{deviceOrientation:n}=t;return n&&n.beta?u.MathUtils.degToRad(n.beta):0},this.getGamma=()=>{const{deviceOrientation:n}=t;return n&&n.gamma?u.MathUtils.degToRad(n.gamma):0},this.createObtainPermissionGestureDialog=()=>{const n=document.createElement("div");n.classList.add(R);const s=document.createElement("div");s.classList.add(S);const d=document.createElement("div");d.classList.add(L);const c=document.createElement("div");c.classList.add(N);const a=document.createElement("button");a.classList.add(x),document.body.appendChild(n),this.enableInlineStyling===!0&&(n.style.fontFamily="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol'",n.style.display="flex",n.style.position="fixed",n.style.zIndex="100000",n.style.justifyContent="center",n.style.alignItems="center",n.style.backgroundColor="rgba(0,0,0,0.2)",n.style.inset="0",n.style.padding="20px",s.style.backgroundColor="rgba(220, 220, 220, 0.85)",s.style.padding="6px 0",s.style.borderRadius="10px",s.style.width="100%",s.style.maxWidth="400px",d.style.padding="10px 12px",d.style.textAlign="center",d.style.fontWeight="400",d.style.fontSize="13px",d.style.display="flex",d.style.justifyContent="center",d.style.alignItems="center",c.style.display="block",c.style.textAlign="center",c.style.textDecoration="none",c.style.borderTop="rgb(180,180,180) solid 1px",a.style.display="block",a.style.width="100%",a.style.textAlign="center",a.style.appearance="none",a.style.background="none",a.style.border="none",a.style.outline="none",a.style.padding="10px",a.style.fontWeight="400",a.style.fontSize="16px",a.style.color="#2e7cf1",a.style.cursor="pointer"),n.appendChild(s),s.appendChild(d),s.appendChild(c),d.appendChild(document.createTextNode(C));const h=()=>{this.requestOrientationPermissions(),n.style.display="none"};a.addEventListener("click",h),a.appendChild(document.createTextNode("OK")),c.appendChild(a),document.body.appendChild(n)},this.obtainPermissionGesture=()=>{this.preferConfirmDialog===!0?window.confirm(C)&&this.requestOrientationPermissions():this.createObtainPermissionGestureDialog()}}on(e,i){this.eventEmitter.on(e,i)}}class j{constructor(e){this.raycaster=new m.Raycaster,this.normalisedMousePosition=null,e.domElement.addEventListener("click",i=>{this.normalisedMousePosition=new m.Vector2(i.clientX/e.domElement.clientWidth*2-1,-(i.clientY/e.domElement.clientHeight*2)+1)})}raycast(e,i){if(this.normalisedMousePosition!==null){this.raycaster.setFromCamera(this.normalisedMousePosition,e);const t=this.raycaster.intersectObjects(i.children,!1);return this.normalisedMousePosition=null,t}return[]}}class D extends w{#e;constructor(e={video:{facingMode:"environment"}},i){super(),this.sceneWebcam=new m.Scene,i?this.#e=document.querySelector(i):(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(t=>{this.#e?.addEventListener("loadedmetadata",()=>{this.#e.play(),this.emit("webcamstarted",{videoWidth:this.#e.videoWidth,videoHeight:this.#e.videoHeight})}),this.#e&&(this.#e.srcObject=t)}).catch(t=>{this.emit("webcamerror",{code:t.name,message:t.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}`}}p.App=T,p.ClickHandler=j,p.DeviceOrientationControls=A,p.EventEmitter=w,p.LocAR=y,p.SphMercProjection=b,p.Webcam=D,Object.defineProperty(p,Symbol.toStringTag,{value:"Module"})}));
+      `,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.2",
+  "version": "0.2.4",
   "description": "Location-based AR from AR.js.",
   "files": [
     "dist"
@@ -23,26 +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",
-    "eslint": "^9.38.0",
+    "esbuild":"^0.28.1",
+    "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": "^7.3.2",
-    "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"
-    }
+    "three": "^0.181.0"
   }
 }