@juun-roh/cesium-utils 0.0.6 → 0.0.7

package/dist/utils/index.d.ts

@@ -1,7 +1,127 @@
-export { T as TerrainVisualizer, s as syncCamera } from '../sync-camera-DHUVJ-Fl.js';
-import 'cesium';
-import '../hybrid-terrain-provider-C6aXdtyo.js';
-import '../collection/index.js';
+import { Viewer, Color, EntityCollection, Entity, Rectangle } from 'cesium';
+import { H as HybridTerrainProvider, T as TerrainArea, a as TerrainBounds } from '../hybrid-terrain-provider-C6aXdtyo.js';
+import { Collection } from '../collection/index.js';
+
+/**
+ * @class
+ * Utility class for visualizing terrain provider boundaries and debugging terrain loading.
+ */
+declare class TerrainVisualizer {
+    private _viewer;
+    private _collection;
+    private _hybridTerrain?;
+    private _visible;
+    private _level;
+    private _tileCoordinatesLayer;
+    private _colors;
+    /**
+     * Creates a new `TerrainVisualizer`.
+     * @param viewer The Cesium viewer instance
+     * @param options {@link TerrainVisualizer.ConstructorOptions}
+     */
+    constructor(viewer: Viewer, options?: TerrainVisualizer.ConstructorOptions);
+    /**
+     * Sets the terrain provider to visualize.
+     * @param terrainProvider The terrain provider to visualize.
+     */
+    setTerrainProvider(terrainProvider: HybridTerrainProvider): void;
+    /**
+     * Updates all active visualizations.
+     */
+    update(): void;
+    /**
+     * Clears all visualizations.
+     */
+    clear(): void;
+    /**
+     * Shows a grid of tiles at the specified level.
+     * @param level The zoom level to visualize
+     */
+    show(level?: number): void;
+    /**
+     * Hides the tile grid.
+     */
+    hide(): void;
+    /**
+     * Sets the colors used for visualization.
+     * @param colors Map of role names to colors
+     */
+    setColors(colors: Record<string, Color>): void;
+    /**
+     * Flies the camera to focus on a terrain area.
+     * @param area The terrain area to focus on.
+     * @param options {@link Viewer.flyTo}
+     */
+    flyTo(area: TerrainArea, options?: {
+        duration?: number;
+    }): void;
+    /**
+     * Gets the rectangle representing the current view.
+     * @returns The current view rectangle or undefined.
+     * @private
+     */
+    private _getVisibleRectangle;
+    /** The current zoom level set on the visualizer. */
+    get level(): number;
+    /** Set zoom level on the visualizer. */
+    set level(level: number);
+    /** Whether the grid is currently visible. */
+    get visible(): boolean;
+    /** The collection used in the visualizer. */
+    get collection(): Collection<EntityCollection, Entity>;
+    /** The viewer used in the visualizer */
+    get viewer(): Viewer;
+}
+/**
+ * @namespace
+ * Contains types, utility functions, and constants for terrain visualization.
+ */
+declare namespace TerrainVisualizer {
+    /** Initialization options for `TerrainVisualizer` constructor. */
+    interface ConstructorOptions {
+        /** Colors to use for different visualization elements */
+        colors?: Record<string, Color>;
+        /** Whether to show boundaries initially. */
+        boundaries?: boolean;
+        /** Whether to show tile grid initially. */
+        tile?: boolean;
+        /** Initial zoom level to use for visualizations. */
+        activeLevel?: number;
+        /** Terrain provider to visualize. */
+        terrainProvider?: HybridTerrainProvider;
+    }
+    /** Tag constants for entity collection management. */
+    const tag: {
+        default: string;
+        boundary: string;
+        grid: string;
+    };
+    /**
+     * Creates a ground-clamped rectangle entity for visualization.
+     * @param rectangle The rectangle to visualize
+     * @param color The color to use
+     * @returns A new entity
+     */
+    function createRectangle(rectangle: Rectangle, color: Color): Entity;
+    /** Options for {@link TerrainVisualizer.visualize} */
+    interface Options {
+        color?: Color;
+        show?: boolean;
+        maxTilesToShow?: number;
+        levels?: number[];
+        tag?: string;
+        alpha?: number;
+        tileAlpha?: number;
+    }
+    /**
+     * Visualizes a specific terrain area in a viewer.
+     * @param terrain The terrain area to visualize.
+     * @param viewer The Cesium viewer.
+     * @param options Visualization options.
+     * @returns Collection of created entities.
+     */
+    function visualize(terrain: TerrainArea | TerrainBounds, viewer: Viewer, options?: Options): Collection<EntityCollection, Entity>;
+}
 
 /**
  * Examine the property descriptors at runtime
@@ -12,4 +132,11 @@ import '../collection/index.js';
  */
 declare function isGetterOnly(o: object, k: string | number | symbol): boolean;
 
-export { isGetterOnly };
+/**
+ * Copies camera state from source viewer to destination viewer.
+ * @param source The source viewer to copy camera states from.
+ * @param dest The destination viewer to apply camera properties from the source.
+ */
+declare function syncCamera(source: Viewer, dest: Viewer): void;
+
+export { TerrainVisualizer, isGetterOnly, syncCamera };

package/dist/utils/index.js

@@ -1 +1 @@
-import{a,b}from"../chunk-HC6YX7RQ.js";import{a as c}from"../chunk-YZ7AUGIO.js";export{a as TerrainVisualizer,b as isGetterOnly,c as syncCamera};
+import{a,b}from"../chunk-MIDZHLUZ.js";import{a as c}from"../chunk-YZ7AUGIO.js";export{a as TerrainVisualizer,b as isGetterOnly,c as syncCamera};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juun-roh/cesium-utils",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "Utilities to handle Cesium classes easier.",
   "keywords": [
     "Cesium",

package/dist/chunk-HC6YX7RQ.js

@@ -1 +0,0 @@
-import{Color as c,Entity as B,HeightReference as V,Rectangle as L,TileCoordinatesImageryProvider as S}from"cesium";import{defined as C,EntityCollection as P}from"cesium";var w=class n{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 i=this._eventListeners.get(e);if(i){let r={type:e,...t};i.forEach(a=>a(r))}}_addToTagMap(e,t){this._tagMap.has(t)||this._tagMap.set(t,new Set),this._tagMap.get(t)?.add(e)}_removeFromTagMap(e){let t=e[n.symbol],i=this._tagMap.get(t);i&&(i.delete(e),i.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,i){return Array.isArray(e)?e.forEach(r=>{this.add(r,t)}):(Object.defineProperty(e,n.symbol,{value:t,enumerable:!1,writable:!0,configurable:!0}),this.collection.add(e,i),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.collection instanceof P)return this.collection.values;{let e=[];for(let t=0;t<this.collection.length;t++)e.push(this.collection.get(t));return e}}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 i=this.getByTag(e);for(let r of i)this._removeFromTagMap(r),Object.defineProperty(r,n.symbol,{value:t,enumerable:!1,writable:!0,configurable:!0}),this._addToTagMap(r,t);return i.length>0&&this._emit("update",{items:i,tag:t}),i.length}removeByTag(e){let t=0;return Array.isArray(e)?e.forEach(i=>{t+=this.removeByTag(i)}):this.getByTag(e).forEach(i=>{this.remove(i)&&t++}),t}show(e){let t=this.getByTag(e),i=0;for(let r of t)C(r.show)&&(r.show=!0,i++);return i}hide(e){let t=this.getByTag(e),i=0;for(let r of t)C(r.show)&&(r.show=!1,i++);return i}toggle(e){let t=this.getByTag(e),i=0;for(let r of t)C(r.show)&&(r.show=!r.show,i++);return i}setProperty(e,t,i=this.tag){let r=this.getByTag(i),a=0;for(let o of r)if(e in o&&typeof o[e]!="function"){if(E(o,e))throw Error(`setProperty(${o}, ${e}) failed; The property is readonly.`);o[e]=t,a++}return a}filter(e,t){return(t?this.getByTag(t):this.values).filter(e)}forEach(e,t){(t?this.getByTag(t):this.values).forEach((r,a)=>e(r,a))}},I=w;var f=class n{_viewer;_collection;_hybridTerrain;_visible=!1;_level=15;_tileCoordinatesLayer;_colors=new Map([["custom",c.RED],["default",c.BLUE],["fallback",c.GRAY],["grid",c.YELLOW]]);constructor(e,t){this._viewer=e,this._collection=new I({collection:e.entities,tag:n.tag.default}),t&&(t.colors&&Object.entries(t.colors).forEach(([i,r])=>{this._colors.set(i,r)}),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(n.tag.grid),this._level=e;let t=this._hybridTerrain.tilingScheme;this._tileCoordinatesLayer||(this._tileCoordinatesLayer=this._viewer.imageryLayers.addImageryProvider(new S({tilingScheme:t,color:c.YELLOW})));let i=(o,s,d)=>{if(this._hybridTerrain){for(let u of this._hybridTerrain.terrainAreas)if(u.contains(o,s,d))return u.isCustom?this._colors.get("custom")||c.RED:this._colors.get("default")||c.BLUE;if(this._hybridTerrain.getTileDataAvailable(o,s,d))return this._colors.get("default")||c.BLUE}return this._colors.get("fallback")||c.TRANSPARENT},r=this._getVisibleRectangle();if(!r)return;function a(o){return o&&Number.isFinite(o.west)&&Number.isFinite(o.south)&&Number.isFinite(o.east)&&Number.isFinite(o.north)&&o.west<=o.east&&o.south<=o.north}if(!a(r)){console.warn("Invalid visible rectangle detected, skipping grid display");return}try{let o=t.positionToTileXY(L.northwest(r),e),s=t.positionToTileXY(L.southeast(r),e);if(!o||!s)return;let d=100,u=Math.min(s.x-o.x+1,d),T=Math.min(s.y-o.y+1,d);for(let h=o.x;h<=o.x+u-1;h++)for(let g=o.y;g<=o.y+T-1;g++)try{let l=t.tileXYToRectangle(h,g,e);if(!a(l)){console.warn(`Invalid rectangle for tile (${h}, ${g}, ${e}), skipping`);continue}let v=i(h,g,e),m=n.createRectangle(l,v.withAlpha(.3));m.properties?.addProperty("tileX",h),m.properties?.addProperty("tileY",g),m.properties?.addProperty("tileLevel",e),this._collection.add(m,n.tag.grid)}catch(l){console.warn(`Error creating tile (${h}, ${g}, ${e}): ${l.message}`);continue}console.log("\u{1F680} ~ TerrainVisualizer ~ showGrid ~ collection:",this._collection),this._visible=!0}catch(o){console.error("Error displaying tile grid:",o)}}hide(){this._collection.removeByTag(n.tag.grid),this._tileCoordinatesLayer&&(this._viewer.imageryLayers.remove(this._tileCoordinatesLayer),this._tileCoordinatesLayer=void 0),this._visible=!1}setColors(e){Object.entries(e).forEach(([t,i])=>{this._colors.set(t,i)}),this.update()}flyTo(e,t){let{rectangle:i}=e.bounds;this._viewer.camera.flyTo({destination:i,...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}};(i=>{i.tag={default:"Terrain Visualizer",boundary:"Terrain Visualizer Boundary",grid:"Terrain Visualizer Tile Grid"};function e(r,a){return new B({rectangle:{coordinates:r,material:a,heightReference:V.CLAMP_TO_GROUND}})}i.createRectangle=e;function t(r,a,o){let s=o?.tag||"terrain_area_visualization",d=o?.color||c.RED,u=o?.maxTilesToShow||100,T=o?.show??!0,h=o?.alpha||.7,g=o?.tileAlpha||.2,l="provider"in r?r.bounds:r,v=new I({collection:a.entities,tag:s}),{rectangle:m}=l;if(v.add(i.createRectangle(m,d.withAlpha(h)),s),T&&l.levels.size>0){let{tilingScheme:A}=l;l.levels.forEach(x=>{let p=0,{tileRanges:R}=l;for(let[M,y]of R.entries())if(M===x)for(let b=y.start.x;b<=y.end.x&&p<u;b++)for(let _=y.start.y;_<=y.end.y&&p<u;_++){let O=A.tileXYToRectangle(b,_,x);v.add(e(O,d.withAlpha(g)),`${s}_tile`),p++}})}return v}i.visualize=t})(f||={});function E(n,e){let t=!1,i=Object.getOwnPropertyDescriptor(n,e);if(!i){let r=Object.getPrototypeOf(n);for(;r&&!i;)i=Object.getOwnPropertyDescriptor(r,e),r=Object.getPrototypeOf(r)}return i&&i.get&&!i.set&&(t=!0),t}export{f as a,E as b,I as c};

package/dist/sync-camera-CFIMO7Ut.d.cts

@@ -1,133 +0,0 @@
-import { Viewer, Color, EntityCollection, Entity, Rectangle } from 'cesium';
-import { H as HybridTerrainProvider, T as TerrainArea, a as TerrainBounds } from './hybrid-terrain-provider-C6aXdtyo.cjs';
-import { Collection } from './collection/index.cjs';
-
-/**
- * @class
- * Utility class for visualizing terrain provider boundaries and debugging terrain loading.
- */
-declare class TerrainVisualizer {
-    private _viewer;
-    private _collection;
-    private _hybridTerrain?;
-    private _visible;
-    private _level;
-    private _tileCoordinatesLayer;
-    private _colors;
-    /**
-     * Creates a new `TerrainVisualizer`.
-     * @param viewer The Cesium viewer instance
-     * @param options {@link TerrainVisualizer.ConstructorOptions}
-     */
-    constructor(viewer: Viewer, options?: TerrainVisualizer.ConstructorOptions);
-    /**
-     * Sets the terrain provider to visualize.
-     * @param terrainProvider The terrain provider to visualize.
-     */
-    setTerrainProvider(terrainProvider: HybridTerrainProvider): void;
-    /**
-     * Updates all active visualizations.
-     */
-    update(): void;
-    /**
-     * Clears all visualizations.
-     */
-    clear(): void;
-    /**
-     * Shows a grid of tiles at the specified level.
-     * @param level The zoom level to visualize
-     */
-    show(level?: number): void;
-    /**
-     * Hides the tile grid.
-     */
-    hide(): void;
-    /**
-     * Sets the colors used for visualization.
-     * @param colors Map of role names to colors
-     */
-    setColors(colors: Record<string, Color>): void;
-    /**
-     * Flies the camera to focus on a terrain area.
-     * @param area The terrain area to focus on.
-     * @param options {@link Viewer.flyTo}
-     */
-    flyTo(area: TerrainArea, options?: {
-        duration?: number;
-    }): void;
-    /**
-     * Gets the rectangle representing the current view.
-     * @returns The current view rectangle or undefined.
-     * @private
-     */
-    private _getVisibleRectangle;
-    /** The current zoom level set on the visualizer. */
-    get level(): number;
-    /** Set zoom level on the visualizer. */
-    set level(level: number);
-    /** Whether the grid is currently visible. */
-    get visible(): boolean;
-    /** The collection used in the visualizer. */
-    get collection(): Collection<EntityCollection, Entity>;
-    /** The viewer used in the visualizer */
-    get viewer(): Viewer;
-}
-/**
- * @namespace
- * Contains types, utility functions, and constants for terrain visualization.
- */
-declare namespace TerrainVisualizer {
-    /** Initialization options for `TerrainVisualizer` constructor. */
-    interface ConstructorOptions {
-        /** Colors to use for different visualization elements */
-        colors?: Record<string, Color>;
-        /** Whether to show boundaries initially. */
-        boundaries?: boolean;
-        /** Whether to show tile grid initially. */
-        tile?: boolean;
-        /** Initial zoom level to use for visualizations. */
-        activeLevel?: number;
-        /** Terrain provider to visualize. */
-        terrainProvider?: HybridTerrainProvider;
-    }
-    /** Tag constants for entity collection management. */
-    const tag: {
-        default: string;
-        boundary: string;
-        grid: string;
-    };
-    /**
-     * Creates a ground-clamped rectangle entity for visualization.
-     * @param rectangle The rectangle to visualize
-     * @param color The color to use
-     * @returns A new entity
-     */
-    function createRectangle(rectangle: Rectangle, color: Color): Entity;
-    /** Options for {@link TerrainVisualizer.visualize} */
-    interface Options {
-        color?: Color;
-        show?: boolean;
-        maxTilesToShow?: number;
-        levels?: number[];
-        tag?: string;
-        alpha?: number;
-        tileAlpha?: number;
-    }
-    /**
-     * Visualizes a specific terrain area in a viewer.
-     * @param terrain The terrain area to visualize.
-     * @param viewer The Cesium viewer.
-     * @param options Visualization options.
-     * @returns Collection of created entities.
-     */
-    function visualize(terrain: TerrainArea | TerrainBounds, viewer: Viewer, options?: Options): Collection<EntityCollection, Entity>;
-}
-
-/**
- * Copies camera state from source viewer to destination viewer.
- * @param source The source viewer to copy camera states from.
- * @param dest The destination viewer to apply camera properties from the source.
- */
-declare function syncCamera(source: Viewer, dest: Viewer): void;
-
-export { TerrainVisualizer as T, syncCamera as s };

package/dist/sync-camera-DHUVJ-Fl.d.ts

@@ -1,133 +0,0 @@
-import { Viewer, Color, EntityCollection, Entity, Rectangle } from 'cesium';
-import { H as HybridTerrainProvider, T as TerrainArea, a as TerrainBounds } from './hybrid-terrain-provider-C6aXdtyo.js';
-import { Collection } from './collection/index.js';
-
-/**
- * @class
- * Utility class for visualizing terrain provider boundaries and debugging terrain loading.
- */
-declare class TerrainVisualizer {
-    private _viewer;
-    private _collection;
-    private _hybridTerrain?;
-    private _visible;
-    private _level;
-    private _tileCoordinatesLayer;
-    private _colors;
-    /**
-     * Creates a new `TerrainVisualizer`.
-     * @param viewer The Cesium viewer instance
-     * @param options {@link TerrainVisualizer.ConstructorOptions}
-     */
-    constructor(viewer: Viewer, options?: TerrainVisualizer.ConstructorOptions);
-    /**
-     * Sets the terrain provider to visualize.
-     * @param terrainProvider The terrain provider to visualize.
-     */
-    setTerrainProvider(terrainProvider: HybridTerrainProvider): void;
-    /**
-     * Updates all active visualizations.
-     */
-    update(): void;
-    /**
-     * Clears all visualizations.
-     */
-    clear(): void;
-    /**
-     * Shows a grid of tiles at the specified level.
-     * @param level The zoom level to visualize
-     */
-    show(level?: number): void;
-    /**
-     * Hides the tile grid.
-     */
-    hide(): void;
-    /**
-     * Sets the colors used for visualization.
-     * @param colors Map of role names to colors
-     */
-    setColors(colors: Record<string, Color>): void;
-    /**
-     * Flies the camera to focus on a terrain area.
-     * @param area The terrain area to focus on.
-     * @param options {@link Viewer.flyTo}
-     */
-    flyTo(area: TerrainArea, options?: {
-        duration?: number;
-    }): void;
-    /**
-     * Gets the rectangle representing the current view.
-     * @returns The current view rectangle or undefined.
-     * @private
-     */
-    private _getVisibleRectangle;
-    /** The current zoom level set on the visualizer. */
-    get level(): number;
-    /** Set zoom level on the visualizer. */
-    set level(level: number);
-    /** Whether the grid is currently visible. */
-    get visible(): boolean;
-    /** The collection used in the visualizer. */
-    get collection(): Collection<EntityCollection, Entity>;
-    /** The viewer used in the visualizer */
-    get viewer(): Viewer;
-}
-/**
- * @namespace
- * Contains types, utility functions, and constants for terrain visualization.
- */
-declare namespace TerrainVisualizer {
-    /** Initialization options for `TerrainVisualizer` constructor. */
-    interface ConstructorOptions {
-        /** Colors to use for different visualization elements */
-        colors?: Record<string, Color>;
-        /** Whether to show boundaries initially. */
-        boundaries?: boolean;
-        /** Whether to show tile grid initially. */
-        tile?: boolean;
-        /** Initial zoom level to use for visualizations. */
-        activeLevel?: number;
-        /** Terrain provider to visualize. */
-        terrainProvider?: HybridTerrainProvider;
-    }
-    /** Tag constants for entity collection management. */
-    const tag: {
-        default: string;
-        boundary: string;
-        grid: string;
-    };
-    /**
-     * Creates a ground-clamped rectangle entity for visualization.
-     * @param rectangle The rectangle to visualize
-     * @param color The color to use
-     * @returns A new entity
-     */
-    function createRectangle(rectangle: Rectangle, color: Color): Entity;
-    /** Options for {@link TerrainVisualizer.visualize} */
-    interface Options {
-        color?: Color;
-        show?: boolean;
-        maxTilesToShow?: number;
-        levels?: number[];
-        tag?: string;
-        alpha?: number;
-        tileAlpha?: number;
-    }
-    /**
-     * Visualizes a specific terrain area in a viewer.
-     * @param terrain The terrain area to visualize.
-     * @param viewer The Cesium viewer.
-     * @param options Visualization options.
-     * @returns Collection of created entities.
-     */
-    function visualize(terrain: TerrainArea | TerrainBounds, viewer: Viewer, options?: Options): Collection<EntityCollection, Entity>;
-}
-
-/**
- * Copies camera state from source viewer to destination viewer.
- * @param source The source viewer to copy camera states from.
- * @param dest The destination viewer to apply camera properties from the source.
- */
-declare function syncCamera(source: Viewer, dest: Viewer): void;
-
-export { TerrainVisualizer as T, syncCamera as s };