@juun-roh/cesium-utils 0.0.0

package/dist/index.js

@@ -0,0 +1 @@
+import{defined as E,EntityCollection as H}from"cesium";var S=class a{static symbol=Symbol("cesium-item-tag");tag;collection;_valuesCache=null;_tagMap=new Map;_eventListeners=new Map;constructor({collection:e,tag:t}){this.tag=t||"default",this.collection=e}_emit(e,t){let r=this._eventListeners.get(e);if(r){let i={type:e,...t};r.forEach(o=>o(i))}}_addToTagMap(e,t){this._tagMap.has(t)||this._tagMap.set(t,new Set),this._tagMap.get(t)?.add(e)}_removeFromTagMap(e){let t=e[a.symbol],r=this._tagMap.get(t);r&&(r.delete(e),r.size===0&&this._tagMap.delete(t))}_invalidateCache(){this._valuesCache=null}addEventListener(e,t){return this._eventListeners.has(e)||this._eventListeners.set(e,new Set),this._eventListeners.get(e)?.add(t),this}removeEventListener(e,t){return this._eventListeners.get(e)?.delete(t),this}add(e,t=this.tag,r){return Array.isArray(e)?e.forEach(i=>{this.add(i)}):(Object.defineProperty(e,a.symbol,{value:t,enumerable:!1,writable:!0,configurable:!0}),this.collection.add(e,r),this._addToTagMap(e,t),this._invalidateCache(),this._emit("add",{items:[e],tag:t})),e}contains(e){return this.collection.contains(e)}remove(e){let t=this.collection.remove(e);return t&&(this._removeFromTagMap(e),this._invalidateCache(),this._emit("remove",{items:[e]})),t}removeAll(){this._tagMap.clear(),this.collection.removeAll(),this._invalidateCache(),this._emit("clear")}get values(){if(this._valuesCache)return this._valuesCache;if(this.collection instanceof H)this._valuesCache=this.collection.values||[];else{let e=[];for(let t=0;t<this.collection.length;t++)e.push(this.collection.get(t));this._valuesCache=e}return this._valuesCache}get length(){return this.values?.length||0}getByTag(e){let t=this._tagMap.get(e);return t?Array.from(t):[]}getFirstByTag(e){let t=this._tagMap.get(e);if(t&&t.size>0)return t.values().next().value}getTags(){return Array.from(this._tagMap.keys())}hasTag(e){let t=this._tagMap.get(e);return!!t&&t.size>0}updateTag(e,t){let r=this.getByTag(e);for(let i of r)this._removeFromTagMap(i),Object.defineProperty(i,a.symbol,t),this._addToTagMap(i,t);return r.length>0&&this._emit("update",{items:r,tag:t}),r.length}removeByTag(e){let t=0;return Array.isArray(e)?e.forEach(r=>{this.removeByTag(r)}):this.getByTag(e).forEach(r=>{this.remove(r)&&t++}),t}show(e){let t=this.getByTag(e),r=0;for(let i of t)E(i.show)&&(i.show=!0,r++);return r}hide(e){let t=this.getByTag(e),r=0;for(let i of t)E(i.show)&&(i.show=!1,r++);return r}toggle(e){let t=this.getByTag(e),r=0;for(let i of t)E(i.show)&&(i.show=!i.show,r++);return r}setProperty(e,t,r){let i=this.getByTag(e),o=0;for(let n of i)t in n?(n[t]=r,o++):console.warn(`${t} does not exists in ${n}`);return o}filter(e,t){return(t?this.getByTag(t):this.values).filter(e)}forEach(e,t){(t?this.getByTag(t):this.values).forEach((i,o)=>e(i,o))}},x=S;import{CesiumTerrainProvider as M,EllipsoidTerrainProvider as B,GeographicTilingScheme as q}from"cesium";import{CesiumTerrainProvider as Y}from"cesium";import{GeographicTilingScheme as L,Rectangle as b}from"cesium";var h=class{_rectangle;_tilingScheme;_tileRanges;_levels;constructor(e,t){if(this._tilingScheme=t||new L,this._rectangle=new b,this._tileRanges=new Map,this._levels=new Set,e.type==="rectangle"&&e.rectangle)this._rectangle=b.clone(e.rectangle);else if(e.type==="tileRange"&&e.tileRanges)e.tileRanges instanceof Map?this._tileRanges=new Map(e.tileRanges):this._tileRanges=new Map(Object.entries(e.tileRanges).map(([r,i])=>[parseInt(r),i])),this._calculateRectangleFromTileRanges();else throw new Error("Either rectangle or tileRanges must be provided.");this._levels=new Set(Array.from(this._tileRanges.keys()))}contains(e,t,r){if(this._tileRanges.has(r)){let o=this._tileRanges.get(r);return e>=o.start.x&&e<=o.end.x&&t>=o.start.y&&t<=o.end.y}let i=this._tilingScheme.tileXYToRectangle(e,t,r);return b.intersection(i,this._rectangle)!==void 0}configureAvailability(e){if(e.availability){e.availability._tilingScheme&&(e.availability._tilingScheme=this._tilingScheme);for(let[t,r]of this._tileRanges.entries())e.availability.addAvailableTileRange(t,r.start.x,r.start.y,r.end.x,r.end.y)}}get rectangle(){return this._rectangle}get tilingScheme(){return this._tilingScheme}get tileRanges(){return this._tileRanges}get levels(){return this._levels}_calculateRectangleFromTileRanges(){let e=Number.POSITIVE_INFINITY,t=Number.POSITIVE_INFINITY,r=Number.NEGATIVE_INFINITY,i=Number.NEGATIVE_INFINITY,o=Array.from(this._tileRanges.keys());if(o.length===0){this._rectangle=b.MAX_VALUE;return}let n=Math.min(...o),s=this._tileRanges.get(n);if(s){let{start:l,end:c}=s,T=this._tilingScheme.tileXYToRectangle(l.x,l.y,n),d=this._tilingScheme.tileXYToRectangle(c.x,c.y,n);e=Math.min(T.west,e),t=Math.min(d.south,t),r=Math.max(d.east,r),i=Math.max(T.north,i)}this._rectangle=new b(e,t,r,i)}};(t=>{function a(r,i,o,n=new L){let s=new Map;return s.set(o,{start:{x:r,y:i},end:{x:r,y:i}}),new t({type:"tileRange",tileRanges:s},n)}t.fromTile=a;function e(r,i=new L){return new t({type:"rectangle",rectangle:b.clone(r)},i)}t.fromRectangle=e})(h||={});var v=class a{_provider;_bounds;_levels;_ready=!1;_credit;_isCustom;constructor(e,t){this._bounds=e.bounds instanceof h?e.bounds:new h(e.bounds),this._levels=new Set(e.levels||[]),this._credit=e.credit||"custom",this._isCustom=e.isCustom!==void 0?e.isCustom:!0,this._provider=t,this._ready=!0,this._bounds.configureAvailability(this._provider)}static async create(e){let t;return typeof e.provider=="string"?t=await Y.fromUrl(e.provider,{requestVertexNormals:!0,credit:e.credit||"custom"}):t=e.provider,new a(e,t)}contains(e,t,r){return this._levels.size>0&&!this._levels.has(r)?!1:this._bounds.contains(e,t,r)}requestTileGeometry(e,t,r,i){if(!(!this._ready||!this.contains(e,t,r)||!this._provider?.getTileDataAvailable(e,t,r)))return this._provider.requestTileGeometry(e,t,r,i)}getTileDataAvailable(e,t,r){return!this.contains(e,t,r)||!this._ready?!1:this._provider?.getTileDataAvailable(e,t,r)??!1}get isCustom(){return this._isCustom}get credit(){return this._credit}get provider(){return this._provider}get bounds(){return this._bounds}get levels(){return this._levels}get ready(){return this._ready}};(e=>{async function a(t,r,i,o="custom"){let n=new h({type:"tileRange",tileRanges:r});return await e.create({provider:t,bounds:n,levels:i||Object.keys(r).map(l=>parseInt(l)),credit:o})}e.fromUrl=a})(v||={});var P=class extends Array{async add(e){let t;return e instanceof v?t=e:t=await v.create(e),this.push(t)}remove(e){let t=this.indexOf(e);return t>=0?(this.splice(t,1),!0):!1}clear(){this.length=0}},y=class a{_terrainAreas=new P;_terrainProvider;_fallbackProvider;_tilingScheme;_ready=!1;_availability;constructor(e,t,r){this._terrainProvider=e,this._fallbackProvider=t,this._tilingScheme=e.tilingScheme||new q,this._terrainAreas=new P(...r),this._availability=e.availability,this._ready=!0}static async create(e){try{let t;typeof e.terrainProvider=="string"?t=await M.fromUrl(e.terrainProvider,{requestVertexNormals:!0}):t=e.terrainProvider;let r;e.fallbackProvider?typeof e.fallbackProvider=="string"?r=await M.fromUrl(e.fallbackProvider,{requestVertexNormals:!0}):r=e.fallbackProvider:r=new B;let i=[];for(let o of e.terrainAreas){let n=await v.create(o);i.push(n)}return new a(t,r,i)}catch(t){throw console.error("Failed to initialize HybridTerrainProvider:",t),t}}get ready(){return this._ready}get tilingScheme(){return this._tilingScheme}get availability(){return this._availability}get terrainAreas(){return[...this._terrainAreas]}get defaultProvider(){return this._terrainProvider}get fallbackProvider(){return this._fallbackProvider}get credit(){return this._terrainProvider?.credit}get errorEvent(){return this._terrainProvider.errorEvent}get hasWaterMask(){return this._terrainProvider.hasWaterMask}get hasVertexNormals(){return this._terrainProvider.hasVertexNormals}loadTileDataAvailability(e,t,r){return this._terrainProvider.loadTileDataAvailability(e,t,r)}getLevelMaximumGeometricError(e){return this._terrainProvider.getLevelMaximumGeometricError(e)}requestTileGeometry(e,t,r,i){if(this._ready){for(let o of this._terrainAreas)if(o.contains(e,t,r))return o.requestTileGeometry(e,t,r,i);return this._terrainProvider.getTileDataAvailable(e,t,r)?this._terrainProvider.requestTileGeometry(e,t,r,i):this._fallbackProvider.requestTileGeometry(e,t,r,i)}}getTileDataAvailable(e,t,r){return this._terrainAreas.forEach(i=>{if(i.contains(e,t,r)&&i.getTileDataAvailable(e,t,r))return!0}),this._terrainProvider.getTileDataAvailable(e,t,r)||!0}};(e=>{async function a(t,r,i,o){return e.create({terrainAreas:[{provider:t,bounds:{type:"tileRange",tileRanges:i},levels:o||Object.keys(i).map(n=>parseInt(n)),credit:"custom"}],terrainProvider:r,fallbackProvider:new B})}e.createOverlay=a})(y||={});import{Color as m,Entity as W,HeightReference as $,Rectangle as V,TileCoordinatesImageryProvider as U}from"cesium";var w=class extends x{},_=class a{_viewer;_collection;_hybridTerrain;_visible=!1;_level=15;_tileCoordinatesLayer;_colors=new Map([["custom",m.RED],["default",m.BLUE],["fallback",m.GRAY],["grid",m.YELLOW]]);constructor(e,t){this._viewer=e,this._collection=new w({collection:e.entities,tag:a.tag.default}),t&&(t.colors&&Object.entries(t.colors).forEach(([r,i])=>{this._colors.set(r,i)}),t.tile!==void 0&&(this._visible=t.tile),t.activeLevel!==void 0&&(this._level=t.activeLevel),t.terrainProvider&&this.setTerrainProvider(t.terrainProvider))}setTerrainProvider(e){this._hybridTerrain=e,this.update()}update(){this.clear(),this._visible&&this.show(this._level)}clear(){this._collection.removeByTag(this._collection.getTags())}show(e=15){if(!this._hybridTerrain)return;this._collection.removeByTag(a.tag.grid),this._level=e;let t=this._hybridTerrain.tilingScheme;this._tileCoordinatesLayer||(this._tileCoordinatesLayer=this._viewer.imageryLayers.addImageryProvider(new U({tilingScheme:t,color:m.YELLOW})));let r=(n,s,l)=>{if(this._hybridTerrain){for(let c of this._hybridTerrain.terrainAreas)if(c.contains(n,s,l))return c.isCustom?this._colors.get("custom")||m.RED:this._colors.get("default")||m.BLUE;if(this._hybridTerrain.getTileDataAvailable(n,s,l))return this._colors.get("default")||m.BLUE}return this._colors.get("fallback")||m.TRANSPARENT},i=this._getVisibleRectangle();if(!i)return;function o(n){return n&&Number.isFinite(n.west)&&Number.isFinite(n.south)&&Number.isFinite(n.east)&&Number.isFinite(n.north)&&n.west<=n.east&&n.south<=n.north}if(!o(i)){console.warn("Invalid visible rectangle detected, skipping grid display");return}try{let n=t.positionToTileXY(V.northwest(i),e),s=t.positionToTileXY(V.southeast(i),e);if(!n||!s)return;let l=100,c=Math.min(s.x-n.x+1,l),T=Math.min(s.y-n.y+1,l);for(let d=n.x;d<=n.x+c-1;d++)for(let g=n.y;g<=n.y+T-1;g++)try{let u=t.tileXYToRectangle(d,g,e);if(!o(u)){console.warn(`Invalid rectangle for tile (${d}, ${g}, ${e}), skipping`);continue}let p=r(d,g,e),f=a.createRectangle(u,p.withAlpha(.3));f.properties?.addProperty("tileX",d),f.properties?.addProperty("tileY",g),f.properties?.addProperty("tileLevel",e),this._collection.add(f,a.tag.grid)}catch(u){console.warn(`Error creating tile (${d}, ${g}, ${e}): ${u.message}`);continue}console.log("\u{1F680} ~ TerrainVisualizer ~ showGrid ~ collection:",this._collection),this._visible=!0}catch(n){console.error("Error displaying tile grid:",n)}}hide(){this._collection.removeByTag(a.tag.grid),this._tileCoordinatesLayer&&(this._viewer.imageryLayers.remove(this._tileCoordinatesLayer),this._tileCoordinatesLayer=void 0),this._visible=!1}setColors(e){Object.entries(e).forEach(([t,r])=>{this._colors.set(t,r)}),this.update()}flyTo(e,t){let{rectangle:r}=e.bounds;this._viewer.camera.flyTo({destination:r,...t,complete:()=>{this._visible&&this.update()}})}_getVisibleRectangle(){return this._viewer.camera.computeViewRectangle()}get level(){return this._level}set level(e){this._level=e,this._visible&&this.update()}get visible(){return this._visible}get collection(){return this._collection}get viewer(){return this._viewer}};(r=>{r.tag={default:"Terrain Visualizer",boundary:"Terrain Visualizer Boundary",grid:"Terrain Visualizer Tile Grid"};function e(i,o){return new W({rectangle:{coordinates:i,material:o,heightReference:$.CLAMP_TO_GROUND}})}r.createRectangle=e;function t(i,o,n){let s=n?.tag||"terrain_area_visualization",l=n?.color||m.RED,c=n?.maxTilesToShow||100,T=n?.show!==void 0?n.show:!0,d=n?.alpha||.7,g=n?.tileAlpha||.2,u="provider"in i?i.bounds:i,p=new w({collection:o.entities,tag:s}),{rectangle:f}=u;if(p.add(r.createRectangle(f,l.withAlpha(d)),s),T&&u.levels.size>0){let{tilingScheme:N}=u;u.levels.forEach(k=>{let A=0,{tileRanges:G}=u;for(let[z,C]of G.entries())if(z===k)for(let R=C.start.x;R<=C.end.x&&A<c;R++)for(let I=C.start.y;I<=C.end.y&&A<c;I++){let F=N.tileXYToRectangle(R,I,k);p.add(e(F,l.withAlpha(g)),`${s}_tile`),A++}})}return p}r.visualize=t})(_||={});import{defined as O,Viewer as X}from"cesium";function j(a,e,t){let r={baseLayerPicker:a.baseLayerPicker!==void 0,geocoder:a.geocoder!==void 0,homeButton:a.homeButton!==void 0,sceneModePicker:a.sceneModePicker!==void 0,timeline:a.timeline!==void 0,navigationHelpButton:a.navigationHelpButton!==void 0,animation:a.animation!==void 0,fullscreenButton:a.fullscreenButton!==void 0,shouldAnimate:a.clock.shouldAnimate,terrainProvider:a.terrainProvider,requestRenderMode:a.scene.requestRenderMode,infoBox:a.infoBox!==void 0},i=new X(e,{...r,...t});D(a,i);let o=a.imageryLayers;i.imageryLayers.removeAll();for(let l=0;l<o.length;l++){let c=o.get(l);i.imageryLayers.addImageryProvider(c.imageryProvider,l)}i.clock.startTime=a.clock.startTime.clone(),i.clock.stopTime=a.clock.stopTime.clone(),i.clock.currentTime=a.clock.currentTime.clone(),i.clock.multiplier=a.clock.multiplier,i.clock.clockStep=a.clock.clockStep,i.clock.clockRange=a.clock.clockRange,i.clock.shouldAnimate=a.clock.shouldAnimate,i.scene.globe.enableLighting=a.scene.globe.enableLighting,i.scene.globe.depthTestAgainstTerrain=a.scene.globe.depthTestAgainstTerrain,i.scene.screenSpaceCameraController.enableCollisionDetection=a.scene.screenSpaceCameraController.enableCollisionDetection;let n=a.scene.screenSpaceCameraController.tiltEventTypes;n&&(i.scene.screenSpaceCameraController.tiltEventTypes=Array.isArray(n)?[...n]:n);let s=a.scene.screenSpaceCameraController.zoomEventTypes;return s&&(i.scene.screenSpaceCameraController.zoomEventTypes=Array.isArray(s)?[...s]:s),i}function D(a,e){if(O(a)&&O(e)){let{camera:t}=a;e.camera.position=t.positionWC.clone(),e.camera.direction=t.directionWC.clone(),e.camera.up=t.upWC.clone()}}export{x as Collection,y as HybridTerrainProvider,v as TerrainArea,h as TerrainBounds,_ as TerrainVisualizer,j as cloneViewer,D as syncCameraState};

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@juun-roh/cesium-utils",
+  "version": "0.0.0",
+  "description": "Utilities to handle Cesium classes easier.",
+  "keywords": [
+    "Cesium",
+    "Utility",
+    "Collection",
+    "Terrain",
+    "Tagged",
+    "GIS",
+    "3D",
+    "Mapping"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/juunie-roh/cesium-utils.git"
+  },
+  "homepage": "https://github.com/juunie-roh/cesium-utils#readme",
+  "bugs": {
+    "url": "https://github.com/juunie-roh/cesium-utils/issues"
+  },
+  "license": "MIT",
+  "author": "Juun",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "peerDependencies": {
+    "cesium": "^1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "config": {
+    "commitizen": {
+      "path": "@commitlint/cz-commitlint"
+    }
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.28.1",
+    "@commitlint/cli": "^19",
+    "@commitlint/config-conventional": "^19",
+    "@commitlint/cz-commitlint": "^19",
+    "@commitlint/format": "^19",
+    "@commitlint/types": "^19",
+    "@eslint/js": "^9.23.0",
+    "@typescript-eslint/eslint-plugin": "^8.29.0",
+    "@typescript-eslint/parser": "^8.29.0",
+    "cesium": "^1.128.0",
+    "eslint": "^9.23.0",
+    "eslint-plugin-jsdoc": "^50.6.9",
+    "eslint-plugin-prettier": "^5.2.6",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "eslint-plugin-unused-imports": "^4.1.4",
+    "husky": "^9.1.7",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.4.0",
+    "typedoc": "^0.28.1",
+    "typescript": "^5.8.2",
+    "vite": "^6.2.5"
+  },
+  "scripts": {
+    "build": "tsup",
+    "build:dev": "tsup --watch",
+    "clean": "rimraf dist docs",
+    "lint": "eslint .",
+    "ci:publish": "pnpm build && pnpm publish --no-git-checks",
+    "prebuild": "pnpm clean",
+    "test": "node tests/cjs-require.cjs && node tests/cjs-with-cesium.cjs && node tests/esm-import.mjs && node tests/esm-with-cesium.mjs",
+    "dev": "pnpm build && vite"
+  }
+}