@juun-roh/cesium-utils 0.1.3 → 0.2.1

package/dist/collection/index.d.ts

@@ -1,493 +1,2 @@
-import { DataSourceCollection, EntityCollection, ImageryLayerCollection, PrimitiveCollection, DataSource, Entity, ImageryLayer, Billboard, Cesium3DTileset, GroundPrimitive, Label, PointPrimitive, Polyline, Primitive } from 'cesium';
-
-type CesiumCollection = DataSourceCollection | EntityCollection | ImageryLayerCollection | PrimitiveCollection;
-type Primitives = Billboard | Cesium3DTileset | GroundPrimitive | Label | PointPrimitive | Polyline | Primitive;
-type CesiumCollectionItem = DataSource | Entity | ImageryLayer | Primitives;
-type Tag = string | number;
-interface WithTag {
-    [key: symbol]: Tag;
-}
-/**
- * Collection event types
- */
-type CollectionEventType = "add" | "remove" | "update" | "clear";
-/**
- * Event handler function type
- */
-type EventHandler<I> = (event: {
-    type: CollectionEventType;
-    items?: I[];
-    tag?: Tag;
-}) => void;
-type NonFunction<T> = {
-    [K in keyof T]: T[K] extends Function ? never : K;
-}[keyof T];
-
-/**
- * @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 CesiumCollection, I extends CesiumCollectionItem> {
-    /**
-     * 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: 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?: 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>;
-    /**
-     * 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;
-    /**
-     * 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: CollectionEventType, handler: 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: CollectionEventType, handler: 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?: 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?: 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: 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: 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: 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 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 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: 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: Tag): I | undefined;
-    /**
-     * 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(): Tag[];
-    /**
-     * 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: Tag, to: 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: 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: 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: Tag): this;
-    /**
-     * Sets a property value on all items with the specified tag.
-     *
-     * @param by - The tag identifying which items to update
-     * @param property - The property name to set
-     * @param value - The value to set
-     * @returns The collection itself.
-     *
-     * @example
-     * // Change color of all buildings to red
-     * collection.setProperty('buildings', 'color', Color.RED);
-     */
-    setProperty<K extends NonFunction<I>>(property: K, value: I[K], by?: 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?: 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?: 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?: 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?: Tag): I | undefined;
-}
-
-export { type CesiumCollection, type CesiumCollectionItem, Collection, type CollectionEventType, type EventHandler, type NonFunction, type Tag, type WithTag };
+export { C as Collection } from '../index-Bd_-DTWl.js';
+import 'cesium';

package/dist/collection/index.js

@@ -1 +1 @@
-import"../chunk-RXMNSDKR.js";import{c as a}from"../chunk-ZV7FKRP6.js";export{a as Collection};
+import"../chunk-RXMNSDKR.js";import{c as a}from"../chunk-NO7SO2WH.js";export{a as Collection};

package/dist/highlight/index.cjs

@@ -1 +1 @@
-"use strict";var f=Object.defineProperty;var _=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var y=Object.prototype.hasOwnProperty;var m=(n,t)=>{for(var i in t)f(n,i,{get:t[i],enumerable:!0})},O=(n,t,i,e)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of p(t))!y.call(n,s)&&s!==i&&f(n,s,{get:()=>t[s],enumerable:!(e=_(t,s))||e.enumerable});return n};var w=n=>O(f({},"__esModule",{value:!0}),n);var v={};m(v,{Highlight:()=>a,SilhouetteHighlight:()=>l,SurfaceHighlight:()=>c});module.exports=w(v);var h=require("cesium");var o=require("cesium"),l=class{_color=o.Color.RED;_silhouette;_composite;_stages;_entity;_currentObject;_currentOptions;constructor(t){this._stages=t.scene.postProcessStages,this._silhouette=o.PostProcessStageLibrary.createEdgeDetectionStage(),this._silhouette.uniforms.color=this._color,this._silhouette.uniforms.length=.01,this._silhouette.selected=[],this._composite=o.PostProcessStageLibrary.createSilhouetteStage([this._silhouette]),this._stages.add(this._composite)}show(t,i){if((0,o.defined)(t)&&!(this._currentObject===t&&this._optionsEqual(this._currentOptions,i))){this._clearHighlights();try{if(t instanceof o.Cesium3DTileFeature)this._silhouette.uniforms.color=i?.color||this._color,this._silhouette.selected.push(t);else{if(!t.model)return;this._entity=t,t.model.silhouetteSize=new o.ConstantProperty(i?.width||2),t.model.silhouetteColor=new o.ConstantProperty(i?.color||this._color)}this._currentObject=t,this._currentOptions=i?{...i}:void 0}catch(e){console.error("Failed to highlight object:",e),this._currentObject=void 0,this._currentOptions=void 0}}}_optionsEqual(t,i){return!t&&!i?!0:!t||!i?!1:t.outline===i.outline&&t.width===i.width&&o.Color.equals(t.color||this._color,i.color||this._color)}_clearHighlights(){this._silhouette.selected.length>0&&(this._silhouette.selected=[]),this._entity?.model&&(this._entity.model.silhouetteColor=new o.ConstantProperty(o.Color.TRANSPARENT),this._entity.model.silhouetteSize=new o.ConstantProperty(0),this._entity=void 0)}hide(){this._clearHighlights(),this._currentObject=void 0,this._currentOptions=void 0}destroy(){this.hide(),this._composite&&this._stages.remove(this._composite),this._currentObject=void 0,this._currentOptions=void 0}get color(){return this._color}set color(t){this._color=t}get currentObject(){return this._currentObject}};var r=require("cesium"),c=class{_color=r.Color.RED;_entity;_entities;_currentObject;_currentOptions;constructor(t){this._entities=t.entities,this._entity=this._entities.add(new r.Entity({id:`highlight-entity-${Math.random().toString(36).substring(2)}`,show:!1}))}show(t,i){if(!(!(0,r.defined)(t)||!this._entity)){if(this._currentObject===t&&this._optionsEqual(this._currentOptions,i))return this._entity;this._clearGeometries();try{if(t instanceof r.Entity&&(t.polygon||t.polyline||t.rectangle))this._update(t,i);else if(t instanceof r.GroundPrimitive)this._update(t,i);else{this._currentObject=void 0,this._currentOptions=void 0;return}return this._currentObject=t,this._currentOptions=i?{...i}:void 0,this._entity.show=!0,this._entity}catch(e){console.error("Failed to highlight object:",e),this._currentObject=void 0,this._currentOptions=void 0;return}}}_optionsEqual(t,i){return!t&&!i?!0:!t||!i?!1:t.outline===i.outline&&t.width===i.width&&r.Color.equals(t.color||this._color,i.color||this._color)}_clearGeometries(){this._entity.polygon=void 0,this._entity.polyline=void 0,this._entity.rectangle=void 0}_update(t,i={color:this._color,outline:!1,width:2}){if(t instanceof r.Entity){if(t.polygon)if(i.outline){let e=t.polygon.hierarchy?.getValue();if(e&&e.positions){let s;e.positions.length>0&&!r.Cartesian3.equals(e.positions[0],e.positions[e.positions.length-1])?s=[...e.positions,e.positions[0]]:s=e.positions,this._entity.polyline=new r.PolylineGraphics({positions:s,material:i.color,width:i.width||2,clampToGround:!0})}}else{let e=t.polygon.hierarchy?.getValue();e&&(this._entity.polygon=new r.PolygonGraphics({hierarchy:e,material:i.color,heightReference:r.HeightReference.CLAMP_TO_GROUND,classificationType:t.polygon.classificationType?.getValue()||r.ClassificationType.BOTH}))}else if(t.polyline){let e=t.polyline.positions?.getValue();if(e){let s=t.polyline.width?.getValue();this._entity.polyline=new r.PolylineGraphics({positions:e,material:i.color,width:s+(i.width||2),clampToGround:!0})}}else if(t.rectangle)if(i.outline){let e=t.rectangle.coordinates?.getValue();if(e){let s=[r.Cartesian3.fromRadians(e.west,e.north),r.Cartesian3.fromRadians(e.east,e.north),r.Cartesian3.fromRadians(e.east,e.south),r.Cartesian3.fromRadians(e.west,e.south),r.Cartesian3.fromRadians(e.west,e.north)];this._entity.polyline=new r.PolylineGraphics({positions:s,material:i.color,width:i.width||2,clampToGround:!0})}}else{let e=t.rectangle.coordinates?.getValue();e&&(this._entity.rectangle=new r.RectangleGraphics({coordinates:e,material:i.color,heightReference:r.HeightReference.CLAMP_TO_GROUND}))}}else if(t instanceof r.GroundPrimitive){let e=t.geometryInstances,s=Array.isArray(e)?e[0]:e;if(!s.geometry.attributes.position)return;let d=s.geometry.attributes.position.values,g=[];for(let u=0;u<d.length;u+=3)g.push(new r.Cartesian3(d[u],d[u+1],d[u+2]));i.outline?this._entity.polyline=new r.PolylineGraphics({positions:g,material:i.color,width:i.width||2,clampToGround:!0}):this._entity.polygon=new r.PolygonGraphics({hierarchy:new r.PolygonHierarchy(g),material:i.color,heightReference:r.HeightReference.CLAMP_TO_GROUND,classificationType:r.ClassificationType.BOTH})}}hide(){this._entity&&(this._entity.show=!1),this._currentObject=void 0,this._currentOptions=void 0}destroy(){this._entities.contains(this._entity)&&this._entities.remove(this._entity),this._currentObject=void 0,this._currentOptions=void 0}get color(){return this._color}set color(t){this._color=t}get entity(){return this._entity}get currentObject(){return this._currentObject}};var a=class n{static instances=new WeakMap;_surface;_silhouette;_color=h.Color.RED;constructor(t){this._surface=new c(t),this._silhouette=new l(t),this._surface.color=this._color,this._silhouette.color=this._color}static getInstance(t){let i=t.container;return n.instances.has(i)||n.instances.set(i,new n(t)),n.instances.get(i)}static releaseInstance(t){let i=t.container,e=n.instances.get(i);e&&(e.hide(),e._surface&&e._surface.destroy(),e._silhouette&&e._silhouette.destroy(),n.instances.delete(i))}show(t,i={color:this._color}){let e=this._getObject(t);if((0,h.defined)(e))return e instanceof h.Cesium3DTileFeature?this._silhouette.show(e,i):e instanceof h.Entity&&e.model?this._silhouette.show(e,i):this._surface.show(e,i)}_getObject(t){if((0,h.defined)(t)){if(t instanceof h.Entity||t instanceof h.Cesium3DTileFeature||t instanceof h.GroundPrimitive)return t;if(t.id instanceof h.Entity)return t.id;if(t.primitive instanceof h.GroundPrimitive)return t.primitive}}hide(){this._surface.hide(),this._silhouette.hide()}get color(){return this._color}set color(t){this._color=t,this._surface.color=t,this._silhouette.color=t}};
+"use strict";var f=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var v=(n,t)=>{for(var i in t)f(n,i,{get:t[i],enumerable:!0})},O=(n,t,i,e)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of y(t))!m.call(n,o)&&o!==i&&f(n,o,{get:()=>t[o],enumerable:!(e=p(t,o))||e.enumerable});return n};var w=n=>O(f({},"__esModule",{value:!0}),n);var C={};v(C,{Highlight:()=>_,SilhouetteHighlight:()=>h,SurfaceHighlight:()=>c});module.exports=w(C);var l=require("cesium");var s=require("cesium"),h=class{_color=s.Color.RED;_silhouette;_composite;_stages;_entity;_currentObject;_currentOptions;constructor(t){this._stages=t.scene.postProcessStages,this._silhouette=s.PostProcessStageLibrary.createEdgeDetectionStage(),this._silhouette.uniforms.color=this._color,this._silhouette.uniforms.length=.01,this._silhouette.selected=[],this._composite=s.PostProcessStageLibrary.createSilhouetteStage([this._silhouette]),this._stages.add(this._composite)}show(t,i){if((0,s.defined)(t)&&!(this._currentObject===t&&this._optionsEqual(this._currentOptions,i))){this._clearHighlights();try{if(t instanceof s.Cesium3DTileFeature)this._silhouette.uniforms.color=i?.color||this._color,this._silhouette.selected.push(t);else{if(!t.model)return;this._entity=t,t.model.silhouetteSize=new s.ConstantProperty(i?.width||2),t.model.silhouetteColor=new s.ConstantProperty(i?.color||this._color)}this._currentObject=t,this._currentOptions=i?{...i}:void 0}catch(e){console.error("Failed to highlight object:",e),this._currentObject=void 0,this._currentOptions=void 0}}}_optionsEqual(t,i){return!t&&!i?!0:!t||!i?!1:t.outline===i.outline&&t.width===i.width&&s.Color.equals(t.color||this._color,i.color||this._color)}_clearHighlights(){this._silhouette.selected.length>0&&(this._silhouette.selected=[]),this._entity?.model&&(this._entity.model.silhouetteColor=new s.ConstantProperty(s.Color.TRANSPARENT),this._entity.model.silhouetteSize=new s.ConstantProperty(0),this._entity=void 0)}hide(){this._clearHighlights(),this._currentObject=void 0,this._currentOptions=void 0}destroy(){this.hide(),this._composite&&this._stages.remove(this._composite),this._currentObject=void 0,this._currentOptions=void 0}get color(){return this._color}set color(t){this._color=t}get currentObject(){return this._currentObject}};var r=require("cesium"),c=class{_color=r.Color.RED;_entity;_entities;_currentObject;_currentOptions;constructor(t){this._entities=t.entities,this._entity=this._entities.add(new r.Entity({id:`highlight-entity-${Math.random().toString(36).substring(2)}`,show:!1}))}show(t,i){if(!(!(0,r.defined)(t)||!this._entity)){if(this._currentObject===t&&this._optionsEqual(this._currentOptions,i))return this._entity;this._clearGeometries();try{if(t instanceof r.Entity&&(t.polygon||t.polyline||t.rectangle))this._update(t,i);else if(t instanceof r.GroundPrimitive)this._update(t,i);else{this._currentObject=void 0,this._currentOptions=void 0;return}return this._currentObject=t,this._currentOptions=i?{...i}:void 0,this._entity.show=!0,this._entity}catch(e){console.error("Failed to highlight object:",e),this._currentObject=void 0,this._currentOptions=void 0;return}}}_optionsEqual(t,i){return!t&&!i?!0:!t||!i?!1:t.outline===i.outline&&t.width===i.width&&r.Color.equals(t.color||this._color,i.color||this._color)}_clearGeometries(){this._entity.polygon=void 0,this._entity.polyline=void 0,this._entity.rectangle=void 0}_update(t,i={color:this._color,outline:!1,width:2}){if(t instanceof r.Entity){if(t.polygon)if(i.outline){let e=t.polygon.hierarchy?.getValue();if(e&&e.positions){let o;e.positions.length>0&&!r.Cartesian3.equals(e.positions[0],e.positions[e.positions.length-1])?o=[...e.positions,e.positions[0]]:o=e.positions,this._entity.polyline=new r.PolylineGraphics({positions:o,material:i.color,width:i.width||2,clampToGround:!0})}}else{let e=t.polygon.hierarchy?.getValue();e&&(this._entity.polygon=new r.PolygonGraphics({hierarchy:e,material:i.color,heightReference:r.HeightReference.CLAMP_TO_GROUND,classificationType:t.polygon.classificationType?.getValue()||r.ClassificationType.BOTH}))}else if(t.polyline){let e=t.polyline.positions?.getValue();if(e){let o=t.polyline.width?.getValue();this._entity.polyline=new r.PolylineGraphics({positions:e,material:i.color,width:o+(i.width||2),clampToGround:!0})}}else if(t.rectangle)if(i.outline){let e=t.rectangle.coordinates?.getValue();if(e){let o=[r.Cartesian3.fromRadians(e.west,e.north),r.Cartesian3.fromRadians(e.east,e.north),r.Cartesian3.fromRadians(e.east,e.south),r.Cartesian3.fromRadians(e.west,e.south),r.Cartesian3.fromRadians(e.west,e.north)];this._entity.polyline=new r.PolylineGraphics({positions:o,material:i.color,width:i.width||2,clampToGround:!0})}}else{let e=t.rectangle.coordinates?.getValue();e&&(this._entity.rectangle=new r.RectangleGraphics({coordinates:e,material:i.color,heightReference:r.HeightReference.CLAMP_TO_GROUND}))}}else if(t instanceof r.GroundPrimitive){let e=t.geometryInstances,o=Array.isArray(e)?e[0]:e;if(!o.geometry.attributes.position)return;let a=o.geometry.attributes.position.values,d=[];for(let u=0;u<a.length;u+=3)d.push(new r.Cartesian3(a[u],a[u+1],a[u+2]));i.outline?this._entity.polyline=new r.PolylineGraphics({positions:d,material:i.color,width:i.width||2,clampToGround:!0}):this._entity.polygon=new r.PolygonGraphics({hierarchy:new r.PolygonHierarchy(d),material:i.color,heightReference:r.HeightReference.CLAMP_TO_GROUND,classificationType:r.ClassificationType.BOTH})}}hide(){this._entity&&(this._entity.show=!1),this._currentObject=void 0,this._currentOptions=void 0}destroy(){this._entities.contains(this._entity)&&this._entities.remove(this._entity),this._currentObject=void 0,this._currentOptions=void 0}get color(){return this._color}set color(t){this._color=t}get entity(){return this._entity}get currentObject(){return this._currentObject}};var g=class n{static instances=new WeakMap;_surface;_silhouette;_color=l.Color.RED;constructor(t){this._surface=new c(t),this._silhouette=new h(t),this._surface.color=this._color,this._silhouette.color=this._color}static getInstance(t){let i=t.container;return n.instances.has(i)||n.instances.set(i,new n(t)),n.instances.get(i)}static releaseInstance(t){let i=t.container,e=n.instances.get(i);e&&(e.hide(),e._surface&&e._surface.destroy(),e._silhouette&&e._silhouette.destroy(),n.instances.delete(i))}show(t,i={color:this._color}){let e=this._getObject(t);if((0,l.defined)(e))return e instanceof l.Cesium3DTileFeature?this._silhouette.show(e,i):e instanceof l.Entity&&e.model?this._silhouette.show(e,i):this._surface.show(e,i)}_getObject(t){if((0,l.defined)(t)){if(t instanceof l.Entity||t instanceof l.Cesium3DTileFeature||t instanceof l.GroundPrimitive)return t;if(t.id instanceof l.Entity)return t.id;if(t.primitive instanceof l.GroundPrimitive)return t.primitive}}hide(){this._surface.hide(),this._silhouette.hide()}get color(){return this._color}set color(t){this._color=t,this._surface.color=t,this._silhouette.color=t}},_=g;

package/dist/highlight/index.d.cts

@@ -1,28 +1,4 @@
-import { Entity, Cesium3DTileFeature, GroundPrimitive, Primitive, Model, Cesium3DTileset, Color, Viewer } from 'cesium';
-
-interface IHighlight {
-    show(object: any, options?: HighlightOptions): void;
-    hide(): void;
-    destroy(): void;
-    color: Color;
-}
-interface HighlightOptions {
-    /** Color of the highlight */
-    color?: Color;
-    /** To apply outline style for the highlight */
-    outline?: boolean;
-    /** Outline width */
-    width?: number;
-}
-type PickedObject = {
-    id?: Entity;
-    primitive?: Primitive | GroundPrimitive | Model | Cesium3DTileset;
-    tileset?: Cesium3DTileset;
-    detail?: {
-        model?: Model;
-    };
-};
-type Picked = Entity | Cesium3DTileFeature | GroundPrimitive | PickedObject;
+import { Viewer, Entity, Color, Primitive, GroundPrimitive, Model, Cesium3DTileset, Cesium3DTileFeature } from 'cesium';
 
 /**
  * @class
@@ -75,9 +51,9 @@ declare class Highlight {
      * Highlights a picked object or a direct instance.
      * @param picked The result of `Scene.pick()` or direct instance to be highlighted.
      * @param options Optional style for the highlight.
-     * @see {@link HighlightOptions}
+     * @see {@link Highlight.Options}
      */
-    show(picked: Picked, options?: HighlightOptions): void | Entity;
+    show(picked: Highlight.Picked, options?: Highlight.Options): void | Entity;
     private _getObject;
     /**
      * Clears the current highlight effects.
@@ -91,6 +67,32 @@ declare class Highlight {
      */
     set color(color: Color);
 }
+declare namespace Highlight {
+    export interface Base {
+        show(object: any, options?: Highlight.Options): void;
+        hide(): void;
+        destroy(): void;
+        color: Color;
+    }
+    export interface Options {
+        /** Color of the highlight */
+        color?: Color;
+        /** To apply outline style for the highlight */
+        outline?: boolean;
+        /** Outline width */
+        width?: number;
+    }
+    type PickedObject = {
+        id?: Entity;
+        primitive?: Primitive | GroundPrimitive | Model | Cesium3DTileset;
+        tileset?: Cesium3DTileset;
+        detail?: {
+            model?: Model;
+        };
+    };
+    export type Picked = Entity | Cesium3DTileFeature | GroundPrimitive | PickedObject;
+    export {  };
+}
 
 /**
  * @class
@@ -114,7 +116,7 @@ declare class Highlight {
  * silhouetteHighlight.show(entity);
  * ```
  */
-declare class SilhouetteHighlight implements IHighlight {
+declare class SilhouetteHighlight implements Highlight.Base {
     private _color;
     private _silhouette;
     private _composite;
@@ -132,15 +134,15 @@ declare class SilhouetteHighlight implements IHighlight {
      * @param object The object to be highlighted.
      * @param options Optional style for the highlight.
      */
-    show(object: Cesium3DTileFeature, options?: HighlightOptions): void;
+    show(object: Cesium3DTileFeature, options?: Highlight.Options): void;
     /**
      * Highlights a picked `Entity` by updating the model properties.
      * @param object The object to be highlighted.
      * @param options Optional style for the highlight.
      */
-    show(object: Entity, options?: HighlightOptions): void;
+    show(object: Entity, options?: Highlight.Options): void;
     /**
-     * Compares two HighlightOptions objects for equality
+     * Compares two Highlight.Options objects for equality
      * @private
      */
     private _optionsEqual;
@@ -191,7 +193,7 @@ declare class SilhouetteHighlight implements IHighlight {
  * surfaceHighlight.show(entity);
  * ```
  */
-declare class SurfaceHighlight implements IHighlight {
+declare class SurfaceHighlight implements Highlight.Base {
     private _color;
     private _entity;
     private _entities;
@@ -206,11 +208,11 @@ declare class SurfaceHighlight implements IHighlight {
      * Highlights a picked object by updating the reusable entity
      * @param object The object to be highlighted.
      * @param options Optional style for the highlight.
-     * @see {@link HighlightOptions}
+     * @see {@link Highlight.Options}
      */
-    show(object: Entity | GroundPrimitive, options?: HighlightOptions): Entity | undefined;
+    show(object: Entity | GroundPrimitive, options?: Highlight.Options): Entity | undefined;
     /**
-     * Compares two HighlightOptions objects for equality
+     * Compares two Highlight.Options objects for equality
      * @private
      */
     private _optionsEqual;
@@ -240,4 +242,4 @@ declare class SurfaceHighlight implements IHighlight {
     get currentObject(): Entity | GroundPrimitive | undefined;
 }
 
-export { Highlight, type HighlightOptions, type IHighlight, type Picked, type PickedObject, SilhouetteHighlight, SurfaceHighlight };
+export { Highlight, SilhouetteHighlight, SurfaceHighlight };