@juun-roh/cesium-utils 0.3.8 → 0.3.9

package/dist/chunk-B3AVU53O.js

@@ -0,0 +1 @@
+import{a as f}from"./chunk-6ABRDFE5.js";var _;(l=>{let o=new Set,r=typeof process<"u"?process.env.CESIUM_UTILS_DISABLE_DEPRECATION_WARNINGS!=="true":!0;function e(s,y={}){if(!r)return;let{once:h=!0,prefix:v="[DEPRECATED]",includeStack:u=!0,removeInVersion:b}=y;if(h&&o.has(s))return;let m=`${v} ${s}`;b&&(m+=` This feature will be removed in ${b}.`),typeof console<"u"&&console.warn&&(u?(console.warn(m),console.trace("Deprecation stack trace:")):console.warn(m)),h&&o.add(s)}l.warn=e;function i(s,y,h={}){let v=((...u)=>(e(y,h),s(...u)));return Object.defineProperty(v,"name",{value:s.name,configurable:!0}),v}l.deprecate=i;function t(){o.clear()}l.clear=t;function n(){return o.size}l.getWarningCount=n;function a(s){return o.has(s)}l.hasShown=a})(_||={});var C=_;import{Color as c,TileCoordinatesImageryProvider as P}from"cesium";import{Color as p,GridImageryProvider as w}from"cesium";var d=class extends w{_terrainProvider;_colors;constructor(r){let{terrainProvider:e,colors:i,...t}=r;super(t),this._terrainProvider=e,this._colors=i}requestImage(r,e,i){for(let t of this._terrainProvider.regions)if(this._isInRegion(t,r,e,i))return this._createCanvasElement(this._colors.get("custom")||p.RED);return this._defaultProviderCoversArea(r,e,i)?this._createCanvasElement(this._colors.get("default")||p.BLUE):this._createCanvasElement(this._colors.get("fallback")||p.GRAY)}_isInRegion(r,e,i,t){if(f.TerrainRegion.contains(r,e,i,t))return!0;if(r.tiles){let n=e,a=i,l=t;for(;l>0;)if(l--,n=Math.floor(n/2),a=Math.floor(a/2),f.TerrainRegion.contains(r,n,a,l))return!0}return!1}_defaultProviderCoversArea(r,e,i){let t=r,n=e,a=i;for(;a>=0;){if(this._terrainProvider.defaultProvider.getTileDataAvailable(t,n,a))return!0;if(a===0)break;a--,t=Math.floor(t/2),n=Math.floor(n/2)}return!1}_createCanvasElement(r){let e=document.createElement("canvas");e.width=256,e.height=256;let i=e.getContext("2d"),t=r.withAlpha(.3).toCssColorString();if(!i)throw new Error("canvas context undefined");return i.fillStyle=t,i.fillRect(0,0,256,256),Promise.resolve(e)}};var g=class{_viewer;_terrainProvider;_visible=!1;_tileCoordinatesLayer;_hybridImageryLayer;_colors=new Map([["custom",c.RED],["default",c.BLUE],["fallback",c.GRAY],["grid",c.YELLOW]]);constructor(r,e){this._viewer=r,this._terrainProvider=e.terrainProvider,e.colors&&Object.entries(e.colors).forEach(([i,t])=>{this._colors.set(i,t)}),e.tile!==void 0&&e.tile&&this.show()}setTerrainProvider(r){this._terrainProvider=r,this.update()}update(){let r=this._visible,e=!!this._tileCoordinatesLayer,i=this._hybridImageryLayer?.alpha??.5;this.clear(),r&&this.show({showTileCoordinates:e,alpha:i})}clear(){this.hide()}show(r){if(!this._terrainProvider)return;let e=r?.showTileCoordinates??!0,i=r?.alpha??.5;e&&this._ensureTileCoordinatesLayer(),this.showImageryOverlay(i),this._visible=!0}_ensureTileCoordinatesLayer(){this._tileCoordinatesLayer||(this._tileCoordinatesLayer=this._viewer.imageryLayers.addImageryProvider(new P({tilingScheme:this._terrainProvider.tilingScheme,color:c.YELLOW})))}hide(){this._tileCoordinatesLayer&&(this._viewer.imageryLayers.remove(this._tileCoordinatesLayer),this._tileCoordinatesLayer=void 0),this.hideImageryOverlay(),this._visible=!1}setColors(r){Object.entries(r).forEach(([e,i])=>{this._colors.set(e,i)}),this.update()}showImageryOverlay(r=.5){this._hybridImageryLayer&&this._viewer.imageryLayers.remove(this._hybridImageryLayer);let e=new d({terrainProvider:this._terrainProvider,colors:this._colors,tilingScheme:this._terrainProvider.tilingScheme});this._hybridImageryLayer=this._viewer.imageryLayers.addImageryProvider(e),this._hybridImageryLayer.alpha=r,console.log("HybridImageryProvider overlay enabled")}hideImageryOverlay(){this._hybridImageryLayer&&(this._viewer.imageryLayers.remove(this._hybridImageryLayer),this._hybridImageryLayer=void 0,console.log("HybridImageryProvider overlay disabled"))}showTileCoordinates(){this._ensureTileCoordinatesLayer()}hideTileCoordinates(){this._tileCoordinatesLayer&&(this._viewer.imageryLayers.remove(this._tileCoordinatesLayer),this._tileCoordinatesLayer=void 0)}setAlpha(r){this._hybridImageryLayer&&(this._hybridImageryLayer.alpha=r)}flyTo(r,e){this._viewer.camera.flyTo({destination:r,...e,complete:()=>{this._visible&&this.update()}})}get tileCoordinatesVisible(){return!!this._tileCoordinatesLayer}get visible(){return this._visible}get viewer(){return this._viewer}get colors(){return this._colors}get terrainProvider(){return this._terrainProvider}};function L(o,r){let e=!1,i=Object.getOwnPropertyDescriptor(o,r);if(!i){let t=Object.getPrototypeOf(o);for(;t&&!i;)i=Object.getOwnPropertyDescriptor(t,r),t=Object.getPrototypeOf(t)}return i&&i.get&&!i.set&&(e=!0),e}var G=C.deprecate;export{C as a,g as b,L as c,G as d};

package/dist/chunk-WCOPDVHL.js

@@ -0,0 +1 @@
+import{c as l}from"./chunk-B3AVU53O.js";import{DataSourceCollection as d,defined as o,EntityCollection as h,ImageryLayerCollection as v,PrimitiveCollection as c}from"cesium";var r=class s{static symbol=Symbol("cesium-item-tag");tag;collection;_valuesCache=null;_tagMap=new Map;_eventListeners=new Map;_eventCleanupFunctions=[];constructor({collection:e,tag:t}){this.tag=t||"default",this.collection=e,this._setupCacheInvalidator(e)}[Symbol.iterator](){return this.values[Symbol.iterator]()}get values(){if(this._valuesCache!==null)return this._valuesCache;let e;if(this.collection instanceof h)e=this.collection.values;else{e=[];for(let t=0;t<this.collection.length;t++)e.push(this.collection.get(t))}return this._valuesCache=e,e}get length(){return this.values?.length||0}get tags(){return Array.from(this._tagMap.keys())}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(a=>{this.add(a,t)}):(Object.defineProperty(e,s.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})),this}contains(e){if(typeof e=="object")return this.collection.contains(e);let t=this._tagMap.get(e);return!!t&&t.size>0}remove(e){if(typeof e=="object"&&!Array.isArray(e)&&this.collection.remove(e)&&(this._removeFromTagMap(e),this._invalidateCache(),this._emit("remove",{items:[e]})),Array.isArray(e)){if(e.length===0)return this;for(let i of e)this.remove(i)}let t=this.get(e);if(t.length===0)return this;for(let i of t)this.remove(i);return this}removeAll(){this._tagMap.clear(),this.collection.removeAll(),this._invalidateCache(),this._emit("clear")}destroy(){this._eventCleanupFunctions.forEach(e=>e()),this._eventCleanupFunctions=[],this._tagMap.clear(),this._eventListeners.clear(),this._valuesCache=null}get(e){let t=this._tagMap.get(e);return t?Array.from(t):[]}first(e){let t=this._tagMap.get(e);if(t&&t.size>0)return t.values().next().value}update(e,t){let i=this.get(e);for(let a of i)this._removeFromTagMap(a),Object.defineProperty(a,s.symbol,{value:t,enumerable:!1,writable:!0,configurable:!0}),this._addToTagMap(a,t);return i.length>0&&this._emit("update",{items:i,tag:t}),i.length}show(e){let t=this.get(e);for(let i of t)o(i.show)&&(i.show=!0);return this}hide(e){let t=this.get(e);for(let i of t)o(i.show)&&(i.show=!1);return this}toggle(e){let t=this.get(e);for(let i of t)o(i.show)&&(i.show=!i.show);return this}setProperty(e,t,i=this.tag){let a=this.get(i);for(let n of a)if(e in n&&typeof n[e]!="function"){if(l(n,e))throw Error(`Cannot set read-only property '${String(e)}' on ${n.constructor.name}`);n[e]=t}return this}filter(e,t){return(t?this.get(t):this.values).filter(e)}forEach(e,t){(t?this.get(t):this.values).forEach((a,n)=>e(a,n))}map(e,t){return(t?this.get(t):this.values).map(e)}find(e,t){return(t?this.get(t):this.values).find(e)}_emit(e,t){let i=this._eventListeners.get(e);if(i){let a={type:e,...t};i.forEach(n=>n(a))}}_addToTagMap(e,t){this._tagMap.has(t)||this._tagMap.set(t,new Set),this._tagMap.get(t)?.add(e)}_removeFromTagMap(e){let t=e[s.symbol],i=this._tagMap.get(t);i&&(i.delete(e),i.size===0&&this._tagMap.delete(t))}_invalidateCache=()=>{this._valuesCache=null};_setupCacheInvalidator(e){e instanceof h?(e.collectionChanged.addEventListener(this._invalidateCache),this._eventCleanupFunctions.push(()=>e.collectionChanged.removeEventListener(this._invalidateCache))):e instanceof c?(e.primitiveAdded.addEventListener(this._invalidateCache),e.primitiveRemoved.addEventListener(this._invalidateCache),this._eventCleanupFunctions.push(()=>e.primitiveAdded.removeEventListener(this._invalidateCache),()=>e.primitiveRemoved.removeEventListener(this._invalidateCache))):e instanceof d?(e.dataSourceAdded.addEventListener(this._invalidateCache),e.dataSourceMoved.addEventListener(this._invalidateCache),e.dataSourceRemoved.addEventListener(this._invalidateCache),this._eventCleanupFunctions.push(()=>e.dataSourceAdded.removeEventListener(this._invalidateCache),()=>e.dataSourceMoved.removeEventListener(this._invalidateCache),()=>e.dataSourceRemoved.removeEventListener(this._invalidateCache))):e instanceof v&&(e.layerAdded.addEventListener(this._invalidateCache),e.layerMoved.addEventListener(this._invalidateCache),e.layerRemoved.addEventListener(this._invalidateCache),e.layerShownOrHidden.addEventListener(this._invalidateCache),this._eventCleanupFunctions.push(()=>e.layerAdded.removeEventListener(this._invalidateCache),()=>e.layerMoved.removeEventListener(this._invalidateCache),()=>e.layerRemoved.removeEventListener(this._invalidateCache),()=>e.layerShownOrHidden.removeEventListener(this._invalidateCache)))}},m=r;export{m as a};

package/dist/collection/index.cjs

@@ -1 +1 @@
-"use strict";var P=Object.defineProperty;var D=Object.getOwnPropertyDescriptor;var F=Object.getOwnPropertyNames;var k=Object.prototype.hasOwnProperty;var G=(a,e)=>{for(var t in e)P(a,t,{get:e[t],enumerable:!0})},V=(a,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of F(e))!k.call(a,r)&&r!==t&&P(a,r,{get:()=>e[r],enumerable:!(i=D(e,r))||i.enumerable});return a};var H=a=>V(P({},"__esModule",{value:!0}),a);var N={};G(N,{Collection:()=>b});module.exports=H(N);var u=require("cesium");var I;(d=>{let a=new Set,e=typeof process<"u"?process.env.CESIUM_UTILS_DISABLE_DEPRECATION_WARNINGS!=="true":!0;function t(l,o={}){if(!e)return;let{once:h=!0,prefix:v="[DEPRECATED]",includeStack:m=!0,removeInVersion:p}=o;if(h&&a.has(l))return;let f=`${v} ${l}`;p&&(f+=` This feature will be removed in ${p}.`),typeof console<"u"&&console.warn&&(m?(console.warn(f),console.trace("Deprecation stack trace:")):console.warn(f)),h&&a.add(l)}d.warn=t;function i(l,o,h={}){let v=((...m)=>(t(o,h),l(...m)));return Object.defineProperty(v,"name",{value:l.name,configurable:!0}),v}d.deprecate=i;function r(){a.clear()}d.clear=r;function n(){return a.size}d.getWarningCount=n;function c(l){return a.has(l)}d.hasShown=c})(I||={});var R=I;var s=require("cesium");var S=require("cesium"),y=class a{_regions;_defaultProvider;_fallbackProvider;_tilingScheme;_ready=!1;_availability;constructor(e){this._defaultProvider=e.defaultProvider,this._fallbackProvider=e.fallbackProvider||new S.EllipsoidTerrainProvider,this._tilingScheme=e.defaultProvider.tilingScheme,this._regions=e.regions||[],this._availability=e.defaultProvider.availability,this._ready=!0}get ready(){return this._ready}get tilingScheme(){return this._tilingScheme}get availability(){return this._availability}get regions(){return[...this._regions]}get defaultProvider(){return this._defaultProvider}get fallbackProvider(){return this._fallbackProvider}get credit(){return this._defaultProvider?.credit}get errorEvent(){return this._defaultProvider.errorEvent}get hasWaterMask(){return this._defaultProvider.hasWaterMask}get hasVertexNormals(){return this._defaultProvider.hasVertexNormals}loadTileDataAvailability(e,t,i){return this._defaultProvider.loadTileDataAvailability(e,t,i)}getLevelMaximumGeometricError(e){return this._defaultProvider.getLevelMaximumGeometricError(e)}requestTileGeometry(e,t,i,r){if(this._ready){for(let n of this._regions)if(a.TerrainRegion.contains(n,e,t,i))return n.provider.requestTileGeometry(e,t,i,r);return this._defaultProvider.getTileDataAvailable(e,t,i)?this._defaultProvider.requestTileGeometry(e,t,i,r):this._fallbackProvider.requestTileGeometry(e,t,i,r)}}getTileDataAvailable(e,t,i){for(let r of this._regions)if(a.TerrainRegion.contains(r,e,t,i)&&r.provider.getTileDataAvailable(e,t,i))return!0;return this._defaultProvider.getTileDataAvailable(e,t,i)}};(t=>{function a(i,r,n){return new t({regions:i.map(c=>({...c})),defaultProvider:r,fallbackProvider:n})}t.fromTileRanges=a;let e;(r=>{function i(n,c,d,l){if(n.levels&&!n.levels.includes(l))return!1;if(n.tiles){let o=n.tiles.get(l);if(!o)return!1;let[h,v]=Array.isArray(o.x)?o.x:[o.x,o.x],[m,p]=Array.isArray(o.y)?o.y:[o.y,o.y];return c>=h&&c<=v&&d>=m&&d<=p}return!1}r.contains=i})(e=t.TerrainRegion||={})})(y||={});var A=y;var _=class a{_viewer;_collection;_terrainProvider;_visible=!1;_level=15;_tileCoordinatesLayer;_colors=new Map([["custom",s.Color.RED],["default",s.Color.BLUE],["fallback",s.Color.GRAY],["grid",s.Color.YELLOW]]);constructor(e,t){this._viewer=e,this._collection=new b({collection:e.entities,tag:a.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._terrainProvider=e,this.update()}update(){this.clear(),this._visible&&this.show(this._level)}clear(){this._collection.remove(this._collection.tags)}show(e=15){if(!this._terrainProvider)return;this._collection.remove(a.tag.grid),this._level=e,this._ensureTileCoordinatesLayer();let t=this._getVisibleRectangle();if(!t||!this._isValidRectangle(t)){console.warn("Invalid visible rectangle detected, skipping grid display");return}this._displayTileGrid(t,e),this._visible=!0}_ensureTileCoordinatesLayer(){this._tileCoordinatesLayer||(this._tileCoordinatesLayer=this._viewer.imageryLayers.addImageryProvider(new s.TileCoordinatesImageryProvider({tilingScheme:this._terrainProvider.tilingScheme,color:s.Color.YELLOW})))}_isValidRectangle(e){return e&&Number.isFinite(e.west)&&Number.isFinite(e.south)&&Number.isFinite(e.east)&&Number.isFinite(e.north)&&e.west<=e.east&&e.south<=e.north}_displayTileGrid(e,t){let i=this._terrainProvider.tilingScheme;try{let r=this._calculateTileBounds(e,t,i);this._generateVisibleTiles(r,t,i).forEach(c=>{this._collection.add(c.entity,a.tag.grid)})}catch(r){console.error("Error displaying tile grid:",r)}}_calculateTileBounds(e,t,i){let r=i.positionToTileXY(s.Rectangle.northwest(e),t),n=i.positionToTileXY(s.Rectangle.southeast(e),t);if(!r||!n)throw new Error("Failed to calculate tile bounds");return{start:r,end:n}}_generateVisibleTiles(e,t,i){let r=[],c=Math.min(e.end.x-e.start.x+1,100),d=Math.min(e.end.y-e.start.y+1,100);for(let l=e.start.x;l<e.start.x+c;l++)for(let o=e.start.y;o<e.start.y+d;o++)try{let h=this._createTileEntity(l,o,t,i);h&&r.push({entity:h})}catch(h){console.warn(`Error creating tile (${l}, ${o}, ${t}):`,h)}return r}_createTileEntity(e,t,i,r){let n=r.tileXYToRectangle(e,t,i);if(!this._isValidRectangle(n))return null;let c=this._getTileColor(e,t,i),d=a.createRectangle(n,c.withAlpha(.3));return d.properties?.addProperty("tileX",e),d.properties?.addProperty("tileY",t),d.properties?.addProperty("tileLevel",i),d}_getTileColor(e,t,i){if(!this._terrainProvider)return this._colors.get("fallback")||s.Color.TRANSPARENT;for(let r of this._terrainProvider.regions)if(A.TerrainRegion.contains(r,e,t,i))return this._colors.get("custom")||s.Color.RED;return this._terrainProvider.getTileDataAvailable(e,t,i)?this._colors.get("default")||s.Color.BLUE:this._colors.get("fallback")||s.Color.GRAY}hide(){this._collection.remove(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,i])=>{this._colors.set(t,i)}),this.update()}flyTo(e,t){this._viewer.camera.flyTo({destination:e,...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}get colors(){return this._colors}get terrainProvider(){return this._terrainProvider}};(i=>{i.tag={default:"Terrain Visualizer",grid:"Terrain Visualizer Tile Grid"};function e(r,n){return new s.Entity({rectangle:{coordinates:r,material:n,heightReference:s.HeightReference.CLAMP_TO_GROUND}})}i.createRectangle=e;function t(r,n,c){let d=c?.tag||"terrain_region_visualization",l=c?.color||s.Color.RED,o=c?.maxTilesToShow||100,h=c?.show??!0,v=c?.tileAlpha||.2,m=new b({collection:n.entities,tag:d});if(h&&r.tiles&&r.tiles.size>0){let p=r.provider.tilingScheme,f=0;r.tiles.forEach((g,M)=>{let w=Array.isArray(g.x)?g.x:[g.x,g.x],L=Array.isArray(g.y)?g.y:[g.y,g.y];for(let T=w[0];T<=w[1]&&f<o;T++)for(let C=L[0];C<=L[1]&&f<o;C++){let O=p.tileXYToRectangle(T,C,M);m.add(e(O,l.withAlpha(v)),`${d}_tile`),f++}})}return m}i.visualize=t})(_||={});function E(a,e){let t=!1,i=Object.getOwnPropertyDescriptor(a,e);if(!i){let r=Object.getPrototypeOf(a);for(;r&&!i;)i=Object.getOwnPropertyDescriptor(r,e),r=Object.getPrototypeOf(r)}return i&&i.get&&!i.set&&(t=!0),t}var te=R.deprecate;var x=class a{static symbol=Symbol("cesium-item-tag");tag;collection;_valuesCache=null;_tagMap=new Map;_eventListeners=new Map;_eventCleanupFunctions=[];constructor({collection:e,tag:t}){this.tag=t||"default",this.collection=e,this._setupCacheInvalidator(e)}[Symbol.iterator](){return this.values[Symbol.iterator]()}get values(){if(this._valuesCache!==null)return this._valuesCache;let e;if(this.collection instanceof u.EntityCollection)e=this.collection.values;else{e=[];for(let t=0;t<this.collection.length;t++)e.push(this.collection.get(t))}return this._valuesCache=e,e}get length(){return this.values?.length||0}get tags(){return Array.from(this._tagMap.keys())}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,a.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})),this}contains(e){if(typeof e=="object")return this.collection.contains(e);let t=this._tagMap.get(e);return!!t&&t.size>0}remove(e){if(typeof e=="object"&&!Array.isArray(e)&&this.collection.remove(e)&&(this._removeFromTagMap(e),this._invalidateCache(),this._emit("remove",{items:[e]})),Array.isArray(e)){if(e.length===0)return this;for(let i of e)this.remove(i)}let t=this.get(e);if(t.length===0)return this;for(let i of t)this.remove(i);return this}removeAll(){this._tagMap.clear(),this.collection.removeAll(),this._invalidateCache(),this._emit("clear")}destroy(){this._eventCleanupFunctions.forEach(e=>e()),this._eventCleanupFunctions=[],this._tagMap.clear(),this._eventListeners.clear(),this._valuesCache=null}get(e){let t=this._tagMap.get(e);return t?Array.from(t):[]}first(e){let t=this._tagMap.get(e);if(t&&t.size>0)return t.values().next().value}update(e,t){let i=this.get(e);for(let r of i)this._removeFromTagMap(r),Object.defineProperty(r,a.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}show(e){let t=this.get(e);for(let i of t)(0,u.defined)(i.show)&&(i.show=!0);return this}hide(e){let t=this.get(e);for(let i of t)(0,u.defined)(i.show)&&(i.show=!1);return this}toggle(e){let t=this.get(e);for(let i of t)(0,u.defined)(i.show)&&(i.show=!i.show);return this}setProperty(e,t,i=this.tag){let r=this.get(i);for(let n of r)if(e in n&&typeof n[e]!="function"){if(E(n,e))throw Error(`Cannot set read-only property '${String(e)}' on ${n.constructor.name}`);n[e]=t}return this}filter(e,t){return(t?this.get(t):this.values).filter(e)}forEach(e,t){(t?this.get(t):this.values).forEach((r,n)=>e(r,n))}map(e,t){return(t?this.get(t):this.values).map(e)}find(e,t){return(t?this.get(t):this.values).find(e)}_emit(e,t){let i=this._eventListeners.get(e);if(i){let r={type:e,...t};i.forEach(n=>n(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[a.symbol],i=this._tagMap.get(t);i&&(i.delete(e),i.size===0&&this._tagMap.delete(t))}_invalidateCache=()=>{this._valuesCache=null};_setupCacheInvalidator(e){e instanceof u.EntityCollection?(e.collectionChanged.addEventListener(this._invalidateCache),this._eventCleanupFunctions.push(()=>e.collectionChanged.removeEventListener(this._invalidateCache))):e instanceof u.PrimitiveCollection?(e.primitiveAdded.addEventListener(this._invalidateCache),e.primitiveRemoved.addEventListener(this._invalidateCache),this._eventCleanupFunctions.push(()=>e.primitiveAdded.removeEventListener(this._invalidateCache),()=>e.primitiveRemoved.removeEventListener(this._invalidateCache))):e instanceof u.DataSourceCollection?(e.dataSourceAdded.addEventListener(this._invalidateCache),e.dataSourceMoved.addEventListener(this._invalidateCache),e.dataSourceRemoved.addEventListener(this._invalidateCache),this._eventCleanupFunctions.push(()=>e.dataSourceAdded.removeEventListener(this._invalidateCache),()=>e.dataSourceMoved.removeEventListener(this._invalidateCache),()=>e.dataSourceRemoved.removeEventListener(this._invalidateCache))):e instanceof u.ImageryLayerCollection&&(e.layerAdded.addEventListener(this._invalidateCache),e.layerMoved.addEventListener(this._invalidateCache),e.layerRemoved.addEventListener(this._invalidateCache),e.layerShownOrHidden.addEventListener(this._invalidateCache),this._eventCleanupFunctions.push(()=>e.layerAdded.removeEventListener(this._invalidateCache),()=>e.layerMoved.removeEventListener(this._invalidateCache),()=>e.layerRemoved.removeEventListener(this._invalidateCache),()=>e.layerShownOrHidden.removeEventListener(this._invalidateCache)))}},b=x;
+"use strict";var y=Object.defineProperty;var E=Object.getOwnPropertyDescriptor;var w=Object.getOwnPropertyNames;var x=Object.prototype.hasOwnProperty;var M=(a,e)=>{for(var r in e)y(a,r,{get:e[r],enumerable:!0})},S=(a,e,r,t)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of w(e))!x.call(a,i)&&i!==r&&y(a,i,{get:()=>e[i],enumerable:!(t=E(e,i))||t.enumerable});return a};var A=a=>S(y({},"__esModule",{value:!0}),a);var R={};M(R,{Collection:()=>I});module.exports=A(R);var s=require("cesium");var _;(g=>{let a=new Set,e=typeof process<"u"?process.env.CESIUM_UTILS_DISABLE_DEPRECATION_WARNINGS!=="true":!0;function r(l,o={}){if(!e)return;let{once:d=!0,prefix:h="[DEPRECATED]",includeStack:c=!0,removeInVersion:u}=o;if(d&&a.has(l))return;let f=`${h} ${l}`;u&&(f+=` This feature will be removed in ${u}.`),typeof console<"u"&&console.warn&&(c?(console.warn(f),console.trace("Deprecation stack trace:")):console.warn(f)),d&&a.add(l)}g.warn=r;function t(l,o,d={}){let h=((...c)=>(r(o,d),l(...c)));return Object.defineProperty(h,"name",{value:l.name,configurable:!0}),h}g.deprecate=t;function i(){a.clear()}g.clear=i;function n(){return a.size}g.getWarningCount=n;function v(l){return a.has(l)}g.hasShown=v})(_||={});var C=_;var L=require("cesium");var P=require("cesium");var T=require("cesium"),m=class a{_regions;_defaultProvider;_fallbackProvider;_tilingScheme;_ready=!1;_availability;constructor(e){this._defaultProvider=e.defaultProvider,this._fallbackProvider=e.fallbackProvider||new T.EllipsoidTerrainProvider,this._tilingScheme=e.defaultProvider.tilingScheme,this._regions=e.regions||[],this._availability=e.defaultProvider.availability,this._ready=!0}get ready(){return this._ready}get tilingScheme(){return this._tilingScheme}get availability(){return this._availability}get regions(){return[...this._regions]}get defaultProvider(){return this._defaultProvider}get fallbackProvider(){return this._fallbackProvider}get credit(){return this._defaultProvider?.credit}get errorEvent(){return this._defaultProvider.errorEvent}get hasWaterMask(){return this._defaultProvider.hasWaterMask}get hasVertexNormals(){return this._defaultProvider.hasVertexNormals}loadTileDataAvailability(e,r,t){return this._defaultProvider.loadTileDataAvailability(e,r,t)}getLevelMaximumGeometricError(e){return this._defaultProvider.getLevelMaximumGeometricError(e)}requestTileGeometry(e,r,t,i){if(this._ready){for(let n of this._regions)if(a.TerrainRegion.contains(n,e,r,t))return n.provider.requestTileGeometry(e,r,t,i);return this._defaultProvider.getTileDataAvailable(e,r,t)?this._defaultProvider.requestTileGeometry(e,r,t,i):this._fallbackProvider.requestTileGeometry(e,r,t,i)}}getTileDataAvailable(e,r,t){for(let i of this._regions)if(a.TerrainRegion.contains(i,e,r,t)&&i.provider.getTileDataAvailable(e,r,t))return!0;return this._defaultProvider.getTileDataAvailable(e,r,t)}};(r=>{function a(t,i,n){return new r({regions:t.map(v=>({...v})),defaultProvider:i,fallbackProvider:n})}r.fromTileRanges=a;let e;(i=>{function t(n,v,g,l){if(n.levels&&!n.levels.includes(l))return!1;if(n.tiles){let o=n.tiles.get(l);if(!o)return!1;let[d,h]=Array.isArray(o.x)?o.x:[o.x,o.x],[c,u]=Array.isArray(o.y)?o.y:[o.y,o.y];return v>=d&&v<=h&&g>=c&&g<=u}return!1}i.contains=t})(e=r.TerrainRegion||={})})(m||={});function p(a,e){let r=!1,t=Object.getOwnPropertyDescriptor(a,e);if(!t){let i=Object.getPrototypeOf(a);for(;i&&!t;)t=Object.getOwnPropertyDescriptor(i,e),i=Object.getPrototypeOf(i)}return t&&t.get&&!t.set&&(r=!0),r}var X=C.deprecate;var b=class a{static symbol=Symbol("cesium-item-tag");tag;collection;_valuesCache=null;_tagMap=new Map;_eventListeners=new Map;_eventCleanupFunctions=[];constructor({collection:e,tag:r}){this.tag=r||"default",this.collection=e,this._setupCacheInvalidator(e)}[Symbol.iterator](){return this.values[Symbol.iterator]()}get values(){if(this._valuesCache!==null)return this._valuesCache;let e;if(this.collection instanceof s.EntityCollection)e=this.collection.values;else{e=[];for(let r=0;r<this.collection.length;r++)e.push(this.collection.get(r))}return this._valuesCache=e,e}get length(){return this.values?.length||0}get tags(){return Array.from(this._tagMap.keys())}addEventListener(e,r){return this._eventListeners.has(e)||this._eventListeners.set(e,new Set),this._eventListeners.get(e)?.add(r),this}removeEventListener(e,r){return this._eventListeners.get(e)?.delete(r),this}add(e,r=this.tag,t){return Array.isArray(e)?e.forEach(i=>{this.add(i,r)}):(Object.defineProperty(e,a.symbol,{value:r,enumerable:!1,writable:!0,configurable:!0}),this.collection.add(e,t),this._addToTagMap(e,r),this._invalidateCache(),this._emit("add",{items:[e],tag:r})),this}contains(e){if(typeof e=="object")return this.collection.contains(e);let r=this._tagMap.get(e);return!!r&&r.size>0}remove(e){if(typeof e=="object"&&!Array.isArray(e)&&this.collection.remove(e)&&(this._removeFromTagMap(e),this._invalidateCache(),this._emit("remove",{items:[e]})),Array.isArray(e)){if(e.length===0)return this;for(let t of e)this.remove(t)}let r=this.get(e);if(r.length===0)return this;for(let t of r)this.remove(t);return this}removeAll(){this._tagMap.clear(),this.collection.removeAll(),this._invalidateCache(),this._emit("clear")}destroy(){this._eventCleanupFunctions.forEach(e=>e()),this._eventCleanupFunctions=[],this._tagMap.clear(),this._eventListeners.clear(),this._valuesCache=null}get(e){let r=this._tagMap.get(e);return r?Array.from(r):[]}first(e){let r=this._tagMap.get(e);if(r&&r.size>0)return r.values().next().value}update(e,r){let t=this.get(e);for(let i of t)this._removeFromTagMap(i),Object.defineProperty(i,a.symbol,{value:r,enumerable:!1,writable:!0,configurable:!0}),this._addToTagMap(i,r);return t.length>0&&this._emit("update",{items:t,tag:r}),t.length}show(e){let r=this.get(e);for(let t of r)(0,s.defined)(t.show)&&(t.show=!0);return this}hide(e){let r=this.get(e);for(let t of r)(0,s.defined)(t.show)&&(t.show=!1);return this}toggle(e){let r=this.get(e);for(let t of r)(0,s.defined)(t.show)&&(t.show=!t.show);return this}setProperty(e,r,t=this.tag){let i=this.get(t);for(let n of i)if(e in n&&typeof n[e]!="function"){if(p(n,e))throw Error(`Cannot set read-only property '${String(e)}' on ${n.constructor.name}`);n[e]=r}return this}filter(e,r){return(r?this.get(r):this.values).filter(e)}forEach(e,r){(r?this.get(r):this.values).forEach((i,n)=>e(i,n))}map(e,r){return(r?this.get(r):this.values).map(e)}find(e,r){return(r?this.get(r):this.values).find(e)}_emit(e,r){let t=this._eventListeners.get(e);if(t){let i={type:e,...r};t.forEach(n=>n(i))}}_addToTagMap(e,r){this._tagMap.has(r)||this._tagMap.set(r,new Set),this._tagMap.get(r)?.add(e)}_removeFromTagMap(e){let r=e[a.symbol],t=this._tagMap.get(r);t&&(t.delete(e),t.size===0&&this._tagMap.delete(r))}_invalidateCache=()=>{this._valuesCache=null};_setupCacheInvalidator(e){e instanceof s.EntityCollection?(e.collectionChanged.addEventListener(this._invalidateCache),this._eventCleanupFunctions.push(()=>e.collectionChanged.removeEventListener(this._invalidateCache))):e instanceof s.PrimitiveCollection?(e.primitiveAdded.addEventListener(this._invalidateCache),e.primitiveRemoved.addEventListener(this._invalidateCache),this._eventCleanupFunctions.push(()=>e.primitiveAdded.removeEventListener(this._invalidateCache),()=>e.primitiveRemoved.removeEventListener(this._invalidateCache))):e instanceof s.DataSourceCollection?(e.dataSourceAdded.addEventListener(this._invalidateCache),e.dataSourceMoved.addEventListener(this._invalidateCache),e.dataSourceRemoved.addEventListener(this._invalidateCache),this._eventCleanupFunctions.push(()=>e.dataSourceAdded.removeEventListener(this._invalidateCache),()=>e.dataSourceMoved.removeEventListener(this._invalidateCache),()=>e.dataSourceRemoved.removeEventListener(this._invalidateCache))):e instanceof s.ImageryLayerCollection&&(e.layerAdded.addEventListener(this._invalidateCache),e.layerMoved.addEventListener(this._invalidateCache),e.layerRemoved.addEventListener(this._invalidateCache),e.layerShownOrHidden.addEventListener(this._invalidateCache),this._eventCleanupFunctions.push(()=>e.layerAdded.removeEventListener(this._invalidateCache),()=>e.layerMoved.removeEventListener(this._invalidateCache),()=>e.layerRemoved.removeEventListener(this._invalidateCache),()=>e.layerShownOrHidden.removeEventListener(this._invalidateCache)))}},I=b;

package/dist/collection/index.d.cts

@@ -1,2 +1,514 @@
-export { C as Collection } from '../index-iIlou-Sq.cjs';
-import 'cesium';
+import { DataSourceCollection, EntityCollection, ImageryLayerCollection, PrimitiveCollection, Billboard, Cesium3DTileset, GroundPrimitive, Label, PointPrimitive, Polyline, Primitive, DataSource, Entity, ImageryLayer } from 'cesium';
+import { N as NonFunction } from '../type-check-B-zGL1Ne.cjs';
+
+/**
+ * @class
+ * A wrapper class that enhances Cesium collection objects with tagging functionality.
+ * This class provides a consistent API for working with different types of Cesium collections
+ * and allows grouping and manipulating collection items by custom tags.
+ *
+ * @template C - The type of Cesium collection (e.g., EntityCollection, PrimitiveCollection)
+ * @template I - The type of items in the collection (e.g., Entity, Primitive)
+ *
+ * @example
+ * // Example 1: Managing Complex Scene with Multiple Object Types
+ * class SceneOrganizer {
+ *   private entities: Collection<EntityCollection, Entity>;
+ *   private billboards: Collection<BillboardCollection, Billboard>;
+ *   private primitives: Collection<PrimitiveCollection, Primitive>;
+ *
+ *   constructor(viewer: Viewer) {
+ *     this.entities = new Collection({ collection: viewer.entities });
+ *     this.billboards = new Collection({
+ *       collection: viewer.scene.primitives.add(new BillboardCollection())
+ *     });
+ *     this.primitives = new Collection({
+ *       collection: viewer.scene.primitives
+ *     });
+ *   }
+ *
+ *   // Unified API across different collection types!
+ *   showLayer(layerName: string) {
+ *     this.entities.show(layerName);
+ *     this.billboards.show(layerName);
+ *     this.primitives.show(layerName);
+ *   }
+ *
+ *   hideLayer(layerName: string) {
+ *     this.entities.hide(layerName);
+ *     this.billboards.hide(layerName);
+ *     this.primitives.hide(layerName);
+ *   }
+ *
+ *   removeLayer(layerName: string) {
+ *     this.entities.remove(layerName);
+ *     this.billboards.remove(layerName);
+ *     this.primitives.remove(layerName);
+ *   }
+ * }
+ *
+ * // Example 2: Extend the class for Domain-Specific Needs
+ * class BuildingCollection extends Collection<EntityCollection, Entity> {
+ *   constructor(viewer: Viewer) {
+ *     super({ collection: viewer.entities, tag: 'buildings' });
+ *   }
+ *
+ *   addBuilding(options: {
+ *     position: Cartesian3;
+ *     height: number;
+ *     floors: number;
+ *     type: 'residential' | 'commercial' | 'industrial';
+ *   }): Entity {
+ *     const building = new Entity({
+ *       position: options.position,
+ *       box: {
+ *         dimensions: new Cartesian3(50, 50, options.height),
+ *         material: this.getMaterialForType(options.type)
+ *       }
+ *     });
+ *
+ *     // Tag by type AND by floor count
+ *     this.add(building, options.type);
+ *     this.add(building, `floors-${options.floors}`);
+ *
+ *     return building;
+ *   }
+ *
+ *   getByFloorRange(min: number, max: number): Entity[] {
+ *     const results: Entity[] = [];
+ *     for (let i = min; i <= max; i++) {
+ *       results.push(...this.get(`floors-${i}`));
+ *     }
+ *     return results;
+ *   }
+ *
+ *   private getMaterialForType(type: string): Material {
+ *     const colors = {
+ *       residential: Color.GREEN,
+ *       commercial: Color.BLUE,
+ *       industrial: Color.YELLOW
+ *     };
+ *     return new ColorMaterialProperty(colors[type] || Color.WHITE);
+ *   }
+ * }
+ */
+declare class Collection<C extends Collection.Base, I extends Collection.ItemFor<C>> {
+    /**
+     * Symbol used as a property key to store tags on collection items.
+     * Using a Symbol ensures no property naming conflicts with the item's own properties.
+     * @readonly
+     */
+    static readonly symbol: unique symbol;
+    /**
+     * Default tag used when adding items without specifying a tag.
+     * @protected
+     */
+    protected tag: Collection.Tag;
+    /**
+     * The underlying Cesium collection being wrapped.
+     * @protected
+     */
+    protected collection: C;
+    /**
+     * Cache for values array to improve performance
+     * @private
+     */
+    private _valuesCache;
+    /**
+     * Tag to items map for faster lookups
+     * @private
+     */
+    private _tagMap;
+    /**
+     * Event listeners
+     * @private
+     */
+    private _eventListeners;
+    /**
+     * For cleaning up the instances
+     * @private
+     */
+    private _eventCleanupFunctions;
+    /**
+     * Creates a new Collection instance.
+     *
+     * @param options - Configuration options
+     * @param options.collection - The Cesium collection to wrap
+     * @param options.tag - The default tag to use for items (defaults to 'default')
+     */
+    constructor({ collection, tag }: {
+        collection: C;
+        tag?: Collection.Tag;
+    });
+    /**
+     * Makes the collection directly iterable, allowing it to be used in `for...of` loops
+     * and with spread operators.
+     *
+     * @returns An iterator for the items in the collection
+     *
+     * @example
+     * // Iterate through all items in the collection
+     * for (const entity of collection) {
+     *   console.log(entity.id);
+     * }
+     *
+     * // Convert collection to array using spread syntax
+     * const entitiesArray = [...collection];
+     */
+    [Symbol.iterator](): Iterator<I>;
+    /**
+     * Gets all item instances in the collection.
+     * This array should not be modified directly.
+     *
+     * @returns An array of all items in the collection
+     */
+    get values(): I[];
+    /**
+     * Gets the number of items in the collection.
+     *
+     * @returns The item count
+     */
+    get length(): number;
+    /**
+     * Gets all unique tags currently in use in the collection.
+     *
+     * @returns An array of all unique tags
+     *
+     * @example
+     * // Get all tags
+     * const tags = collection.tags;
+     * console.log(`Collection has these tags: ${tags.join(', ')}`);
+     */
+    get tags(): Collection.Tag[];
+    /**
+     * Registers an event listener for collection events.
+     *
+     * @param type - The event type to listen for
+     * @param handler - The callback function
+     * @returns The collection instance for method chaining
+     */
+    addEventListener(type: Collection.Event, handler: Collection.EventHandler<I>): this;
+    /**
+     * Removes an event listener.
+     *
+     * @param type - The event type
+     * @param handler - The callback function to remove
+     * @returns The collection instance for method chaining
+     */
+    removeEventListener(type: Collection.Event, handler: Collection.EventHandler<I>): this;
+    /**
+     * Adds a single item with a tag to the collection.
+     *
+     * @param item - The item to add to the collection
+     * @param tag - Tag to associate with this item (defaults to the collection's default tag)
+     * @param index - The index to add the item at (if supported by the collection)
+     * @returns The collection instance for method chaining
+     *
+     * @example
+     * const entity = collection.add(new Entity({ ... }), 'landmarks');
+     */
+    add(item: I, tag?: Collection.Tag, index?: number): this;
+    /**
+     * Adds multiple items with the same tag to the collection.
+     *
+     * @param items - The array of items to add to the collection
+     * @param tag - Tag to associate with this item (defaults to the collection's default tag)
+     * @returns The collection instance for method chaining
+     *
+     * @example
+     * // Add multiple entities with the same tag
+     * const entities = [new Entity({ ... }), new Entity({ ... })];
+     * const addedEntities = collection.add(entities, 'buildings');
+     */
+    add(items: I[], tag?: Collection.Tag): this;
+    /**
+     * Returns true if the provided item is in this collection, false otherwise.
+     *
+     * @param item - The item instance to check for
+     * @returns True if the item is in the collection, false otherwise
+     */
+    contains(item: I): boolean;
+    /**
+     * Checks if the collection has any items with the specified tag.
+     *
+     * @param tag - The tag to check for
+     * @returns True if items with the tag exist, false otherwise
+     *
+     * @example
+     * if (collection.contains('temporary')) {
+     *   console.log('Temporary items exist');
+     * }
+     */
+    contains(tag: Collection.Tag): boolean;
+    /**
+     * Removes an item from the collection.
+     *
+     * @param item - The item to remove
+     * @returns The collection instance for method chaining
+     */
+    remove(item: I): this;
+    /**
+     * Removes all items with the specified tag from the collection.
+     *
+     * @param by - The tag identifying which items to remove
+     * @returns The collection instance for method chaining
+     */
+    remove(by: Collection.Tag): this;
+    /**
+     * Removes all items with the array of tags from the collection.
+     *
+     * @param by - The tags identifying which items to remove
+     * @returns The collection instance for method chaining
+     */
+    remove(by: Collection.Tag[]): this;
+    /**
+     * Removes all items from the collection.
+     */
+    removeAll(): void;
+    /**
+     * Permanently destroys this Collection instance.
+     * Removes all event listeners and clears internal state.
+     * The Collection instance should not be used after calling this method.
+     */
+    destroy(): void;
+    /**
+     * Gets all items with the specified tag from the collection.
+     * Uses an optimized internal map for faster lookups.
+     *
+     * @param by - The tag to filter by
+     * @returns An array of items with the specified tag, or an empty array if none found
+     *
+     * @example
+     * // Get all buildings
+     * const buildings = collection.get('buildings');
+     */
+    get(by: Collection.Tag): I[];
+    /**
+     * Gets the first item matching the tag. More efficient than `get` when
+     * you only need one item, especially for large collections.
+     *
+     * @param by - The tag to search for
+     * @returns The first matching item or undefined if none found
+     *
+     * @example
+     * // Get the first building
+     * const firstBuilding = collection.first('buildings');
+     */
+    first(by: Collection.Tag): I | undefined;
+    /**
+     * Updates the tag for all items with the specified tag.
+     *
+     * @param from - The tag to replace
+     * @param to - The new tag to assign
+     * @returns The number of items updated
+     *
+     * @example
+     * // Rename a tag
+     * const count = collection.update('temp', 'temporary');
+     * console.log(`Updated ${count} items`);
+     */
+    update(from: Collection.Tag, to: Collection.Tag): number;
+    /**
+     * Makes all items with the specified tag visible.
+     * Only affects items that have a 'show' property.
+     *
+     * @param by - The tag identifying which items to show
+     * @returns The collection itself.
+     *
+     * @example
+     * // Show all buildings
+     * collection.show('buildings');
+     */
+    show(by: Collection.Tag): this;
+    /**
+     * Hides all items with the specified tag.
+     * Only affects items that have a 'show' property.
+     *
+     * @param by - The tag identifying which items to hide
+     * @returns The collection itself.
+     *
+     * @example
+     * // Hide all buildings
+     * collection.hide('buildings');
+     */
+    hide(by: Collection.Tag): this;
+    /**
+     * Toggles visibility of all items with the specified tag.
+     * Only affects items that have a 'show' property.
+     *
+     * @param by - The tag identifying which items to toggle
+     * @returns The collection itself.
+     *
+     * @example
+     * // Toggle visibility of all buildings
+     * collection.toggle('buildings');
+     */
+    toggle(by: Collection.Tag): this;
+    /**
+     * Sets a property value on all items with the specified tag.
+     *
+     * @template K - A type
+     *
+     * @param property - The property name to set
+     * @param value - The value to set
+     * @param by - The tag identifying which items to update
+     * @returns The collection itself.
+     *
+     * @example
+     * // Change color of all buildings to red
+     * collection.setProperty('color', Color.RED, 'buildings');
+     */
+    setProperty<K extends NonFunction<I>>(property: K, value: I[K], by?: Collection.Tag): this;
+    /**
+     * Filters items in the collection based on a predicate function.
+     * Optionally only filters items with a specific tag.
+     *
+     * @param predicate - Function that tests each item
+     * @param by - Optional tag to filter by before applying the predicate
+     * @returns Array of items that pass the test
+     *
+     * @example
+     * // Get all buildings taller than 100 meters
+     * const tallBuildings = collection.filter(
+     *   entity => entity.properties?.height?.getValue() > 100,
+     *   'buildings'
+     * );
+     */
+    filter(predicate: (item: I) => boolean, by?: Collection.Tag): I[];
+    /**
+     * Executes a callback function for each item in the collection.
+     * Optionally filters items by tag before execution.
+     *
+     * @param callback - Function to execute for each item
+     * @param by - Optional tag to filter items (if not provided, processes all items)
+     *
+     * @example
+     * // Highlight all buildings
+     * collection.forEach((entity) => {
+     *   if (entity.polygon) {
+     *     entity.polygon.material = new ColorMaterialProperty(Color.YELLOW);
+     *   }
+     * }, 'buildings');
+     */
+    forEach(callback: (value: I, index: number) => void, by?: Collection.Tag): void;
+    /**
+     * Creates a new array with the results of calling a provided function on every element
+     * in the collection. Optionally filters by tag before mapping.
+     *
+     * @param callbackfn - Function that produces an element of the new array
+     * @param by - Optional tag to filter items by before mapping
+     * @returns A new array with each element being the result of the callback function
+     *
+     * @example
+     * // Get all entity IDs
+     * const entityIds = collection.map(entity => entity.id);
+     *
+     * // Get positions of all buildings
+     * const buildingPositions = collection.map(
+     *   entity => entity.position.getValue(Cesium.JulianDate.now()),
+     *   'buildings'
+     * );
+     */
+    map<R>(callbackfn: (value: I, index: number) => R, by?: Collection.Tag): R[];
+    /**
+     * Returns the first element in the collection that satisfies the provided testing function.
+     * Optionally filters by tag before searching.
+     *
+     * @param predicate - Function to test each element
+     * @param by - Optional tag to filter items by before searching
+     * @returns The first element that passes the test, or undefined if no elements pass
+     *
+     * @example
+     * // Find the first entity with a specific name
+     * const namedEntity = collection.find(entity => entity.name === 'Target');
+     *
+     * // Find the first building taller than 100 meters
+     * const tallBuilding = collection.find(
+     *   entity => entity.properties?.height?.getValue() > 100,
+     *   'buildings'
+     * );
+     */
+    find(predicate: (value: I) => boolean, by?: Collection.Tag): I | undefined;
+    /**
+     * Emits an event to all registered listeners.
+     *
+     * @private
+     * @param type - The event type
+     * @param data - Additional event data
+     */
+    private _emit;
+    /**
+     * Adds an item to the internal tag map for quick lookups.
+     *
+     * @private
+     * @param item - The item to add
+     * @param tag - The tag to associate with the item
+     */
+    private _addToTagMap;
+    /**
+     * Removes an item from the internal tag map.
+     *
+     * @private
+     * @param item - The item to remove
+     */
+    private _removeFromTagMap;
+    /**
+     * Invalidates the values cache when collection changes.
+     *
+     * @private
+     */
+    private _invalidateCache;
+    /**
+     * Sets up automatic cache invalidation by registering event listeners on the underlying Cesium collection.
+     *
+     * @private
+     * @param collection - The Cesium collection to monitor for changes
+     *
+     * @see {@link destroy} For cleanup of event listeners
+     * @see {@link _invalidateCache} For the actual cache invalidation logic
+     */
+    private _setupCacheInvalidator;
+}
+/**
+ * @namespace
+ */
+declare namespace Collection {
+    /**
+     * The underlying Cesium collection type being wrapped.
+     */
+    export type Base = DataSourceCollection | EntityCollection | ImageryLayerCollection | PrimitiveCollection;
+    /**
+     * The item types that can be added to the `PrimitiveCollection` instance.
+     */
+    type Primitives = Billboard | Cesium3DTileset | GroundPrimitive | Label | PointPrimitive | Polyline | Primitive;
+    /**
+     * Cesium item type that can be added to the {@link Collection.Base} instance.
+     */
+    export type Item = DataSource | Entity | ImageryLayer | Primitives;
+    /**
+     * Gets the item type for a given collection type
+     */
+    export type ItemFor<C extends Base> = C extends DataSourceCollection ? DataSource : C extends EntityCollection ? Entity : C extends ImageryLayerCollection ? ImageryLayer : C extends PrimitiveCollection ? Primitives : never;
+    /**
+     * Collection tag type.
+     */
+    export type Tag = string | number;
+    export interface WithTag {
+        [key: symbol]: Tag;
+    }
+    /**
+     * Collection event types
+     */
+    export type Event = "add" | "remove" | "update" | "clear";
+    /**
+     * Event handler function type
+     */
+    export type EventHandler<I> = (event: {
+        type: Event;
+        items?: I[];
+        tag?: Collection.Tag;
+    }) => void;
+    export {  };
+}
+
+export { Collection };