@tonybfox/threejs-tools 1.0.5 → 1.0.7

package/dist/terrain/index.cjs

@@ -1,422 +1 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// packages/terrain/src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  TerrainTool: () => TerrainTool
-});
-module.exports = __toCommonJS(src_exports);
-
-// packages/terrain/src/TerrainTool.ts
-var THREE = __toESM(require("three"));
-var TerrainTool = class extends THREE.EventDispatcher {
-  /**
-   * Creates a new TerrainTool instance
-   * @param scene - The Three.js scene to add terrain to
-   * @param options - Configuration options
-   */
-  constructor(scene, options = {}) {
-    super();
-    this.mesh = null;
-    this.currentData = null;
-    this.isLoading = false;
-    this.generatedTextureUrls = /* @__PURE__ */ new Set();
-    this.scene = scene;
-    this.widthSegments = options.widthSegments ?? 50;
-    this.depthSegments = options.depthSegments ?? 50;
-    this.elevationScale = options.elevationScale ?? 1;
-    this.baseColor = options.baseColor ?? 9139029;
-    this.wireframe = options.wireframe ?? false;
-    this.textureUrl = options.textureUrl;
-    this.mapboxOptions = options.mapbox;
-    this.receiveShadow = options.receiveShadow ?? true;
-    this.castShadow = options.castShadow ?? true;
-    this.useDemoData = options.useDemoData ?? false;
-  }
-  /**
-   * Update Mapbox imagery configuration at runtime
-   */
-  setMapboxOptions(options) {
-    this.mapboxOptions = options;
-  }
-  /**
-   * Loads terrain data and creates a mesh
-   * @param center - Center coordinates (latitude, longitude)
-   * @param dimensions - Terrain dimensions in meters
-   */
-  async loadTerrain(center, dimensions) {
-    if (this.isLoading) {
-      console.warn("Terrain is already loading");
-      return;
-    }
-    this.isLoading = true;
-    this.dispatchEvent({
-      type: "updateStarted",
-      center,
-      dimensions
-    });
-    try {
-      const terrainData = await this.fetchElevationData(center, dimensions);
-      this.currentData = terrainData;
-      this.dispatchEvent({
-        type: "dataLoaded",
-        data: terrainData
-      });
-      const textureSource = await this.resolveTexture(center, dimensions);
-      await this.createMesh(terrainData, textureSource);
-    } catch (error) {
-      console.error("Error loading terrain:", error);
-      this.dispatchEvent({
-        type: "error",
-        message: "Failed to load terrain",
-        error
-      });
-    } finally {
-      this.isLoading = false;
-    }
-  }
-  /**
-   * Updates the terrain with new coordinates and/or dimensions
-   * @param center - New center coordinates (optional, keeps current if not provided)
-   * @param dimensions - New dimensions (optional, keeps current if not provided)
-   */
-  async updateTerrain(center, dimensions) {
-    if (!this.currentData && !center) {
-      console.warn("No current terrain data and no center provided");
-      return;
-    }
-    const newCenter = center || this.currentData.center;
-    const newDimensions = dimensions || this.currentData.dimensions;
-    await this.loadTerrain(newCenter, newDimensions);
-  }
-  /**
-   * Fetches elevation data from Open-Elevation API or generates demo data
-   * @private
-   */
-  async fetchElevationData(center, dimensions) {
-    if (this.useDemoData) {
-      return this.generateDemoData(center, dimensions);
-    }
-    const points = [];
-    const metersPerDegreeLat = 111320;
-    const metersPerDegreeLon = 111320 * Math.max(Math.abs(Math.cos(center.latitude * Math.PI / 180)), 1e-6);
-    const latRange = dimensions.depth / metersPerDegreeLat;
-    const lonRange = dimensions.width / metersPerDegreeLon;
-    const latStep = latRange / this.depthSegments;
-    const lonStep = lonRange / this.widthSegments;
-    const startLat = center.latitude + latRange / 2;
-    const startLon = center.longitude - lonRange / 2;
-    for (let z = 0; z <= this.depthSegments; z++) {
-      for (let x = 0; x <= this.widthSegments; x++) {
-        points.push({
-          latitude: startLat - z * latStep,
-          longitude: startLon + x * lonStep
-        });
-      }
-    }
-    const response = await fetch(
-      "https://api.open-elevation.com/api/v1/lookup",
-      {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify({
-          locations: points
-        })
-      }
-    );
-    if (!response.ok) {
-      throw new Error(`Elevation API error: ${response.statusText}`);
-    }
-    const data = await response.json();
-    const results = data.results;
-    const elevations = [];
-    let minElevation = Infinity;
-    let maxElevation = -Infinity;
-    for (let z = 0; z <= this.depthSegments; z++) {
-      const row = [];
-      for (let x = 0; x <= this.widthSegments; x++) {
-        const index = z * (this.widthSegments + 1) + x;
-        const elevation = results[index].elevation;
-        row.push(elevation);
-        minElevation = Math.min(minElevation, elevation);
-        maxElevation = Math.max(maxElevation, elevation);
-      }
-      elevations.push(row);
-    }
-    return {
-      center,
-      dimensions,
-      elevations,
-      minElevation,
-      maxElevation
-    };
-  }
-  /**
-   * Generates demo terrain data using perlin-like noise
-   * @private
-   */
-  generateDemoData(center, dimensions) {
-    const elevations = [];
-    let minElevation = Infinity;
-    let maxElevation = -Infinity;
-    const seed = center.latitude + center.longitude;
-    for (let z = 0; z <= this.depthSegments; z++) {
-      const row = [];
-      for (let x = 0; x <= this.widthSegments; x++) {
-        const nx = x / this.widthSegments * 4;
-        const nz = z / this.depthSegments * 4;
-        let elevation = 0;
-        elevation += Math.sin(nx + seed) * 500;
-        elevation += Math.cos(nz + seed) * 500;
-        elevation += Math.sin(nx * 2 + seed) * 200;
-        elevation += Math.cos(nz * 2 + seed) * 200;
-        elevation += Math.sin(nx * 4 + seed) * 50;
-        elevation += Math.cos(nz * 4 + seed) * 50;
-        elevation += (Math.random() - 0.5) * 30;
-        row.push(elevation);
-        minElevation = Math.min(minElevation, elevation);
-        maxElevation = Math.max(maxElevation, elevation);
-      }
-      elevations.push(row);
-    }
-    return {
-      center,
-      dimensions,
-      elevations,
-      minElevation,
-      maxElevation
-    };
-  }
-  /**
-   * Creates a terrain mesh from elevation data
-   * @private
-   */
-  async createMesh(data, textureSource) {
-    if (this.mesh) {
-      this.scene.remove(this.mesh);
-      this.mesh.geometry.dispose();
-      if (Array.isArray(this.mesh.material)) {
-        this.mesh.material.forEach((mat) => mat.dispose());
-      } else {
-        this.mesh.material.dispose();
-      }
-    }
-    const geometry = new THREE.PlaneGeometry(
-      data.dimensions.width,
-      data.dimensions.depth,
-      this.widthSegments,
-      this.depthSegments
-    );
-    const positions = geometry.attributes.position;
-    let vertexIndex = 0;
-    for (let z = 0; z <= this.depthSegments; z++) {
-      for (let x = 0; x <= this.widthSegments; x++) {
-        const elevation = data.elevations[z][x];
-        const height = (elevation - data.minElevation) * this.elevationScale;
-        positions.setZ(vertexIndex, height);
-        vertexIndex++;
-      }
-    }
-    geometry.computeVertexNormals();
-    let material;
-    if (textureSource?.url) {
-      try {
-        const texture = await new THREE.TextureLoader().loadAsync(
-          textureSource.url
-        );
-        material = new THREE.MeshStandardMaterial({
-          map: texture,
-          wireframe: this.wireframe
-        });
-      } catch (error) {
-        console.warn("Failed to load terrain texture, using base color.", error);
-        material = new THREE.MeshStandardMaterial({
-          color: this.baseColor,
-          wireframe: this.wireframe
-        });
-      } finally {
-        if (textureSource.revokeOnUse) {
-          this.releaseGeneratedTexture(textureSource.url);
-        }
-      }
-    } else {
-      material = new THREE.MeshStandardMaterial({
-        color: this.baseColor,
-        wireframe: this.wireframe
-      });
-    }
-    this.mesh = new THREE.Mesh(geometry, material);
-    this.mesh.rotation.x = -Math.PI / 2;
-    this.mesh.receiveShadow = this.receiveShadow;
-    this.mesh.castShadow = this.castShadow;
-    this.scene.add(this.mesh);
-    this.dispatchEvent({
-      type: "meshLoaded",
-      mesh: this.mesh
-    });
-  }
-  async resolveTexture(center, dimensions) {
-    if (this.textureUrl) {
-      return {
-        url: this.textureUrl,
-        revokeOnUse: false
-      };
-    }
-    if (!this.mapboxOptions) {
-      return void 0;
-    }
-    try {
-      const url = await this.fetchMapboxTexture(
-        center,
-        dimensions,
-        this.mapboxOptions
-      );
-      this.generatedTextureUrls.add(url);
-      return {
-        url,
-        revokeOnUse: true
-      };
-    } catch (error) {
-      console.warn(
-        "Failed to fetch Mapbox imagery, falling back to base material.",
-        error
-      );
-      return void 0;
-    }
-  }
-  computeBoundingBox(center, dimensions, paddingRatio) {
-    const metersPerDegreeLat = 111320;
-    const latRadians = center.latitude * Math.PI / 180;
-    const cosLat = Math.cos(latRadians);
-    const metersPerDegreeLon = 111320 * Math.max(Math.abs(cosLat), 1e-6);
-    const appliedPadding = Math.max(0, paddingRatio);
-    const widthWithPadding = dimensions.width * (1 + appliedPadding);
-    const depthWithPadding = dimensions.depth * (1 + appliedPadding);
-    const halfDepthDegrees = depthWithPadding / 2 / metersPerDegreeLat;
-    const halfWidthDegrees = widthWithPadding / 2 / metersPerDegreeLon;
-    const clamp = (value, min, max) => Math.min(Math.max(value, min), max);
-    const minLat = clamp(center.latitude - halfDepthDegrees, -90, 90);
-    const maxLat = clamp(center.latitude + halfDepthDegrees, -90, 90);
-    const minLon = clamp(center.longitude - halfWidthDegrees, -180, 180);
-    const maxLon = clamp(center.longitude + halfWidthDegrees, -180, 180);
-    return { minLat, maxLat, minLon, maxLon };
-  }
-  async fetchMapboxTexture(center, dimensions, options) {
-    const styleId = options.styleId ?? "mapbox/satellite-v9";
-    const normalizedStyleId = styleId.replace("mapbox://styles/", "").replace(/^\/+/, "");
-    const width = Math.min(
-      1280,
-      Math.max(1, Math.floor(options.imageWidth ?? 1024))
-    );
-    const height = Math.min(
-      1280,
-      Math.max(1, Math.floor(options.imageHeight ?? 1024))
-    );
-    const highResSuffix = options.highResolution ? "@2x" : "";
-    const format = options.imageFormat ?? "png";
-    const paddingRatio = options.paddingRatio ?? 0.1;
-    const bounds = this.computeBoundingBox(center, dimensions, paddingRatio);
-    const bbox = `${bounds.minLon.toFixed(6)},${bounds.minLat.toFixed(
-      6
-    )},${bounds.maxLon.toFixed(6)},${bounds.maxLat.toFixed(6)}`;
-    const params = new URLSearchParams({
-      access_token: options.accessToken,
-      format
-    });
-    const requestUrl = `https://api.mapbox.com/styles/v1/${normalizedStyleId}/static/[${bbox}]/${width}x${height}${highResSuffix}?${params.toString()}`;
-    const response = await fetch(requestUrl);
-    if (!response.ok) {
-      throw new Error(
-        `Mapbox imagery request failed: ${response.status} ${response.statusText}`
-      );
-    }
-    const blob = await response.blob();
-    if (typeof URL === "undefined" || typeof URL.createObjectURL !== "function") {
-      throw new Error(
-        "URL.createObjectURL is not available in this environment"
-      );
-    }
-    return URL.createObjectURL(blob);
-  }
-  releaseGeneratedTexture(url) {
-    if (!this.generatedTextureUrls.has(url)) {
-      return;
-    }
-    if (typeof URL !== "undefined" && typeof URL.revokeObjectURL === "function") {
-      URL.revokeObjectURL(url);
-    }
-    this.generatedTextureUrls.delete(url);
-  }
-  /**
-   * Gets the current terrain mesh
-   */
-  getMesh() {
-    return this.mesh;
-  }
-  /**
-   * Gets the current terrain data
-   */
-  getData() {
-    return this.currentData;
-  }
-  /**
-   * Checks if terrain is currently loading
-   */
-  isTerrainLoading() {
-    return this.isLoading;
-  }
-  /**
-   * Disposes of all resources
-   */
-  dispose() {
-    if (this.mesh) {
-      this.scene.remove(this.mesh);
-      this.mesh.geometry.dispose();
-      if (Array.isArray(this.mesh.material)) {
-        this.mesh.material.forEach((mat) => mat.dispose());
-      } else {
-        this.mesh.material.dispose();
-      }
-      this.mesh = null;
-    }
-    this.currentData = null;
-    if (this.generatedTextureUrls.size > 0) {
-      for (const url of Array.from(this.generatedTextureUrls)) {
-        this.releaseGeneratedTexture(url);
-      }
-    }
-  }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  TerrainTool
-});
+"use strict";var R=Object.create;var S=Object.defineProperty;var U=Object.getOwnPropertyDescriptor;var P=Object.getOwnPropertyNames;var O=Object.getPrototypeOf,C=Object.prototype.hasOwnProperty;var H=(n,d)=>{for(var e in d)S(n,e,{get:d[e],enumerable:!0})},y=(n,d,e,a)=>{if(d&&typeof d=="object"||typeof d=="function")for(let t of P(d))!C.call(n,t)&&t!==e&&S(n,t,{get:()=>d[t],enumerable:!(a=U(d,t))||a.enumerable});return n};var G=(n,d,e)=>(e=n!=null?R(O(n)):{},y(d||!n||!n.__esModule?S(e,"default",{value:n,enumerable:!0}):e,n)),I=n=>y(S({},"__esModule",{value:!0}),n);var $={};H($,{TerrainTool:()=>M});module.exports=I($);var c=G(require("three")),M=class extends c.EventDispatcher{constructor(e,a={}){super();this.mesh=null;this.currentData=null;this.isLoading=!1;this.generatedTextureUrls=new Set;this.scene=e,this.widthSegments=a.widthSegments??50,this.depthSegments=a.depthSegments??50,this.elevationScale=a.elevationScale??1,this.baseColor=a.baseColor??9139029,this.wireframe=a.wireframe??!1,this.textureUrl=a.textureUrl,this.mapboxOptions=a.mapbox,this.receiveShadow=a.receiveShadow??!0,this.castShadow=a.castShadow??!0,this.useDemoData=a.useDemoData??!1}setMapboxOptions(e){this.mapboxOptions=e}async loadTerrain(e,a){if(this.isLoading){console.warn("Terrain is already loading");return}this.isLoading=!0,this.dispatchEvent({type:"updateStarted",center:e,dimensions:a});try{let t=await this.fetchElevationData(e,a);this.currentData=t,this.dispatchEvent({type:"dataLoaded",data:t});let o=await this.resolveTexture(e,a);await this.createMesh(t,o)}catch(t){console.error("Error loading terrain:",t),this.dispatchEvent({type:"error",message:"Failed to load terrain",error:t})}finally{this.isLoading=!1}}async updateTerrain(e,a){if(!this.currentData&&!e){console.warn("No current terrain data and no center provided");return}let t=e||this.currentData.center,o=a||this.currentData.dimensions;await this.loadTerrain(t,o)}async fetchElevationData(e,a){if(this.useDemoData)return this.generateDemoData(e,a);let t=[],o=111320,m=111320*Math.max(Math.abs(Math.cos(e.latitude*Math.PI/180)),1e-6),s=a.depth/o,i=a.width/m,h=s/this.depthSegments,u=i/this.widthSegments,p=e.latitude+s/2,l=e.longitude-i/2;for(let g=0;g<=this.depthSegments;g++)for(let f=0;f<=this.widthSegments;f++)t.push({latitude:p-g*h,longitude:l+f*u});let r=await fetch("https://api.open-elevation.com/api/v1/lookup",{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({locations:t})});if(!r.ok)throw new Error(`Elevation API error: ${r.statusText}`);let v=(await r.json()).results,x=[],T=1/0,w=-1/0;for(let g=0;g<=this.depthSegments;g++){let f=[];for(let E=0;E<=this.widthSegments;E++){let L=g*(this.widthSegments+1)+E,D=v[L].elevation;f.push(D),T=Math.min(T,D),w=Math.max(w,D)}x.push(f)}return{center:e,dimensions:a,elevations:x,minElevation:T,maxElevation:w}}generateDemoData(e,a){let t=[],o=1/0,m=-1/0,s=e.latitude+e.longitude;for(let i=0;i<=this.depthSegments;i++){let h=[];for(let u=0;u<=this.widthSegments;u++){let p=u/this.widthSegments*4,l=i/this.depthSegments*4,r=0;r+=Math.sin(p+s)*500,r+=Math.cos(l+s)*500,r+=Math.sin(p*2+s)*200,r+=Math.cos(l*2+s)*200,r+=Math.sin(p*4+s)*50,r+=Math.cos(l*4+s)*50,r+=(Math.random()-.5)*30,h.push(r),o=Math.min(o,r),m=Math.max(m,r)}t.push(h)}return{center:e,dimensions:a,elevations:t,minElevation:o,maxElevation:m}}async createMesh(e,a){this.mesh&&(this.scene.remove(this.mesh),this.mesh.geometry.dispose(),Array.isArray(this.mesh.material)?this.mesh.material.forEach(i=>i.dispose()):this.mesh.material.dispose());let t=new c.PlaneGeometry(e.dimensions.width,e.dimensions.depth,this.widthSegments,this.depthSegments),o=t.attributes.position,m=0;for(let i=0;i<=this.depthSegments;i++)for(let h=0;h<=this.widthSegments;h++){let p=(e.elevations[i][h]-e.minElevation)*this.elevationScale;o.setZ(m,p),m++}t.computeVertexNormals();let s;if(a?.url)try{let i=await new c.TextureLoader().loadAsync(a.url);s=new c.MeshStandardMaterial({map:i,wireframe:this.wireframe})}catch(i){console.warn("Failed to load terrain texture, using base color.",i),s=new c.MeshStandardMaterial({color:this.baseColor,wireframe:this.wireframe})}finally{a.revokeOnUse&&this.releaseGeneratedTexture(a.url)}else s=new c.MeshStandardMaterial({color:this.baseColor,wireframe:this.wireframe});this.mesh=new c.Mesh(t,s),this.mesh.rotation.x=-Math.PI/2,this.mesh.receiveShadow=this.receiveShadow,this.mesh.castShadow=this.castShadow,this.scene.add(this.mesh),this.dispatchEvent({type:"meshLoaded",mesh:this.mesh})}async resolveTexture(e,a){if(this.textureUrl)return{url:this.textureUrl,revokeOnUse:!1};if(this.mapboxOptions)try{let t=await this.fetchMapboxTexture(e,a,this.mapboxOptions);return this.generatedTextureUrls.add(t),{url:t,revokeOnUse:!0}}catch(t){console.warn("Failed to fetch Mapbox imagery, falling back to base material.",t);return}}computeBoundingBox(e,a,t){let m=e.latitude*Math.PI/180,s=Math.cos(m),i=111320*Math.max(Math.abs(s),1e-6),h=Math.max(0,t),u=a.width*(1+h),l=a.depth*(1+h)/2/111320,r=u/2/i,b=(g,f,E)=>Math.min(Math.max(g,f),E),v=b(e.latitude-l,-90,90),x=b(e.latitude+l,-90,90),T=b(e.longitude-r,-180,180),w=b(e.longitude+r,-180,180);return{minLat:v,maxLat:x,minLon:T,maxLon:w}}async fetchMapboxTexture(e,a,t){let m=(t.styleId??"mapbox/satellite-v9").replace("mapbox://styles/","").replace(/^\/+/,""),s=Math.min(1280,Math.max(1,Math.floor(t.imageWidth??1024))),i=Math.min(1280,Math.max(1,Math.floor(t.imageHeight??1024))),h=t.highResolution?"@2x":"",u=t.imageFormat??"png",p=t.paddingRatio??.1,l=this.computeBoundingBox(e,a,p),r=`${l.minLon.toFixed(6)},${l.minLat.toFixed(6)},${l.maxLon.toFixed(6)},${l.maxLat.toFixed(6)}`,b=new URLSearchParams({access_token:t.accessToken,format:u}),v=`https://api.mapbox.com/styles/v1/${m}/static/[${r}]/${s}x${i}${h}?${b.toString()}`,x=await fetch(v);if(!x.ok)throw new Error(`Mapbox imagery request failed: ${x.status} ${x.statusText}`);let T=await x.blob();if(typeof URL>"u"||typeof URL.createObjectURL!="function")throw new Error("URL.createObjectURL is not available in this environment");return URL.createObjectURL(T)}releaseGeneratedTexture(e){this.generatedTextureUrls.has(e)&&(typeof URL<"u"&&typeof URL.revokeObjectURL=="function"&&URL.revokeObjectURL(e),this.generatedTextureUrls.delete(e))}getMesh(){return this.mesh}getData(){return this.currentData}isTerrainLoading(){return this.isLoading}dispose(){if(this.mesh&&(this.scene.remove(this.mesh),this.mesh.geometry.dispose(),Array.isArray(this.mesh.material)?this.mesh.material.forEach(e=>e.dispose()):this.mesh.material.dispose(),this.mesh=null),this.currentData=null,this.generatedTextureUrls.size>0)for(let e of Array.from(this.generatedTextureUrls))this.releaseGeneratedTexture(e)}};0&&(module.exports={TerrainTool});

package/dist/terrain/index.mjs

@@ -1,6 +1 @@
-import {
-  TerrainTool
-} from "../chunk-FBTT6MU6.mjs";
-export {
-  TerrainTool
-};
+import{a}from"../chunk-55YVGK52.mjs";export{a as TerrainTool};