@juun-roh/cesium-utils 0.2.0 → 0.2.2

package/dist/terrain/index.d.cts

@@ -1,276 +1,7 @@
-import { Request, TerrainData, Credit, TerrainProvider, Rectangle, CesiumTerrainProvider, TilingScheme, TileAvailability } from 'cesium';
+import { H as HybridTerrainProvider } from '../hybrid-terrain-provider-C2V-igd9.cjs';
+import 'cesium';
 
-/**
- * @class
- * Represents a geographic area with a specific terrain provider.
- * `TerrainArea` pairs a provider with geographic bounds and level constraints.
- */
-declare class TerrainArea {
-    private _terrainProvider;
-    private _rectangle;
-    private _tileRanges;
-    private _ready;
-    private _credit;
-    private _isCustom;
-    /**
-     * Creates a new instance of `TerrainArea`.
-     * @param options Object describing initialization options
-     */
-    constructor(options: TerrainArea.ConstructorOptions);
-    /**
-     * Checks if the specified tile coordinates are within the bounds.
-     * @param x The tile X coordinate.
-     * @param y The tile Y coordinate.
-     * @param level The tile level.
-     * @returns `true` if the tile is within bounds, `false` otherwise.
-     */
-    contains(x: number, y: number, level: number): boolean;
-    /**
-     * Requests the geometry for a given tile. The result must include terrain data and
-     * may optionally include a water mask and an indication of which child tiles are available.
-     * @param x - The X coordinate of the tile for which to request geometry.
-     * @param y - The Y coordinate of the tile for which to request geometry.
-     * @param level - The level of the tile for which to request geometry.
-     * @param [request] - The request object. Intended for internal use only.
-     * @returns A promise for the requested geometry.  If this method
-     *          returns undefined instead of a promise, it is an indication that too many requests are already
-     *          pending and the request will be retried later.
-     */
-    requestTileGeometry(x: number, y: number, level: number, request?: Request): Promise<Awaited<TerrainData>> | undefined;
-    /**
-     * Determines whether data for a tile is available to be loaded.
-     * @param x - The X coordinate of the tile for which to request geometry.
-     * @param y - The Y coordinate of the tile for which to request geometry.
-     * @param level - The level of the tile for which to request geometry.
-     * @returns Undefined if not supported by the terrain provider, otherwise true or false.
-     * @see {@link TerrainProvider.getTileDataAvailable} */
-    getTileDataAvailable(x: number, y: number, level: number): boolean;
-    /** Checks if this terrain provider is marked as a custom provider. */
-    get isCustom(): boolean;
-    /** Gets the credit associated with this terrain area. */
-    get credit(): string | Credit;
-    /** Gets the terrain provider for this terrain area. */
-    get terrainProvider(): TerrainProvider;
-    /** Gets available tile ranges with zoom levels set with this terrain area. */
-    get tileRanges(): Map<number, TerrainArea.TileRange>;
-    /** Gets the rectangle representing this terrain area. */
-    get rectangle(): Rectangle;
-    /** Gets if this terrain area is ready. */
-    get ready(): boolean;
-}
-/**
- * @namespace
- * Contains types and factory methods for creating `TerrainArea` instances.
- */
-declare namespace TerrainArea {
-    /** Initialization options for `TerrainArea` constructor. */
-    interface ConstructorOptions {
-        /** The terrain provider for this area or a URL to create one from. */
-        terrainProvider: TerrainProvider;
-        /**
-         * Tile ranges by level when using tileRange type.
-         * Keys are zoom levels, values define the range of tiles at that level.
-         */
-        tileRanges: Map<number, TileRange>;
-        /**
-         * Credit to associate with this terrain provider.
-         * Used to identify custom terrain providers.
-         * @default custom
-         */
-        credit?: string | Credit;
-        /**
-         * Whether this is a custom terrain provider.
-         * @default true
-         */
-        isCustom?: boolean;
-    }
-    /** A range of tiles from `start` to `end` */
-    type TileRange = {
-        /** Top Left tile coordinates */
-        start: {
-            x: number;
-            y: number;
-        };
-        /** Bottom Right tile coordinates */
-        end: {
-            x: number;
-            y: number;
-        };
-    };
-    /**
-     * Creates a `TerrainArea` from a URL and tile ranges.
-     * @param url The URL to create the terrain provider from.
-     * @param tileRanges Tile ranges by level.
-     * @param options: Constructor options for CesiumTerrainProvider.
-     * @returns A promise resolving to a new `TerrainArea`
-     */
-    function fromUrl(url: string, tileRanges: Map<number, TileRange>, options?: CesiumTerrainProvider.ConstructorOptions): Promise<Awaited<TerrainArea>>;
-    /**
-     * @extends Array
-     * @class
-     * Collection-like Extended Array Class of `TerrainArea`.
-     */
-    class Collection extends Array<TerrainArea> {
-        /**
-         * Adds a new terrain area to the collection.
-         * @param area A TerrainArea instance or constructor options
-         * @returns The index of the added item
-         */
-        add(area: TerrainArea | TerrainArea.ConstructorOptions): this;
-        /**
-         * Adds terrain areas to the collection.
-         * @param areas An array of TerrainArea instance or constructor options
-         * @returns The index of the added item
-         */
-        add(areas: (TerrainArea | TerrainArea.ConstructorOptions)[]): this;
-        /**
-         * Removes a terrain area from the collection.
-         * @param area The terrain area to remove.
-         */
-        remove(area: TerrainArea): this;
-        /**
-         * Removes multiple terrain areas from the collection.
-         * @param areas The terrain areas to remove.
-         */
-        remove(areas: TerrainArea[]): this;
-        /**
-         * Clears all terrain areas.
-         */
-        removeAll(): void;
-    }
-}
+type TerrainRegion = HybridTerrainProvider.TerrainRegion;
+type TerrainOptions = HybridTerrainProvider.ConstructorOptions;
 
-/**
- * @class
- * Provides terrain by delegating requests to different terrain providers
- * based on geographic regions and zoom levels. This allows combining
- * multiple terrain sources into a single seamless terrain.
- *
- * @example
- * ``` typescript
- * // Set up tile ranges
- * const tileRanges = new Map<number, TerrainArea.TileRange>;
- * tileRanges.set(15, { start: { x: 55852, y: 9556 }, end: { x: 55871, y: 9575 } });
- * // Set up tile areas
- * const area = new TerrainArea({ terrainProvider: provider, tileRanges });
- *
- * const hybridTerrain = new HybridTerrainProvider({
- *   terrainAreas: [area],
- *   terrainProvider: new EllipsoidTerrainProvider(),
- * });
- *
- * viewer.terrainProvider = hybridTerrain;
- * ```
- */
-declare class HybridTerrainProvider implements TerrainProvider {
-    private _terrainAreas;
-    private _terrainProvider;
-    private _fallbackProvider;
-    private _tilingScheme;
-    private _ready;
-    private _availability?;
-    /**
-     * Creates a new `HybridTerrainProvider` instance.
-     * @param options {@link HybridTerrainProvider.ConstructorOptions}
-     * @returns A new `HybridTerrainProvider` instance.
-     */
-    constructor(options: HybridTerrainProvider.ConstructorOptions);
-    /**
-     * Gets a value indicating whether or not the provider is ready for use,
-     * or a promise that resolves when the provider becomes ready.
-     */
-    get ready(): boolean;
-    /**
-     * Gets the tiling scheme used by this provider.
-     */
-    get tilingScheme(): TilingScheme;
-    /**
-     * Gets an object that can be used to determine availability of terrain from this provider.
-     */
-    get availability(): TileAvailability | undefined;
-    /**
-     * Gets the list of terrain areas managed by this provider.
-     */
-    get terrainAreas(): readonly TerrainArea[];
-    /**
-     * Gets the default terrain provider.
-     */
-    get defaultProvider(): TerrainProvider;
-    /**
-     * Gets the fallback terrain provider.
-     */
-    get fallbackProvider(): TerrainProvider;
-    /**
-     * Gets the credit to display when this terrain provider is active.  Typically this is used to credit
-     * the source of the terrain.
-     */
-    get credit(): Credit;
-    /**
-     * Gets an event that is raised when the terrain provider encounters an asynchronous error.  By subscribing
-     * to the event, you will be notified of the error and can potentially recover from it.  Event listeners
-     * are passed an instance of `TileProviderError`.
-     */
-    get errorEvent(): any;
-    /**
-     * Gets a value indicating whether or not the provider includes a water mask.  The water mask
-     * indicates which areas of the globe are water rather than land, so they can be rendered
-     * as a reflective surface with animated waves.
-     */
-    get hasWaterMask(): boolean;
-    /** Gets a value indicating whether or not the requested tiles include vertex normals. */
-    get hasVertexNormals(): boolean;
-    /**
-     * Makes sure we load availability data for a tile
-     * @param x - The X coordinate of the tile for which to request geometry.
-     * @param y - The Y coordinate of the tile for which to request geometry.
-     * @param level - The level of the tile for which to request geometry.
-     * @returns Undefined if nothing need to be loaded or a Promise that resolves when all required tiles are loaded
-     */
-    loadTileDataAvailability(x: number, y: number, level: number): Promise<void> | undefined;
-    /**
-     * Gets the maximum geometric error allowed in a tile at a given level.
-     * @param level - The tile level for which to get the maximum geometric error.
-     * @returns The maximum geometric error.
-     */
-    getLevelMaximumGeometricError(level: number): number;
-    /**
-     * Requests the terrain for a given tile coordinate.
-     * @param x The X coordinate of the tile.
-     * @param y The Y coordinate of the tile.
-     * @param level The zoom level of the tile.
-     * @param request The request.
-     * @returns A promise for the requested terrain.
-     */
-    requestTileGeometry(x: number, y: number, level: number, request?: Request): Promise<Awaited<TerrainData>> | undefined;
-    /**
-     * Determines whether data for a tile is available to be loaded. Checks the specified terrain areas first.
-     * @param x - The X coordinate of the tile for which to request geometry.
-     * @param y - The Y coordinate of the tile for which to request geometry.
-     * @param level - The level of the tile for which to request geometry.
-     * @returns Undefined if not supported by the terrain provider, otherwise true or false.
-     */
-    getTileDataAvailable(x: number, y: number, level: number): boolean | undefined;
-}
-/**
- * @namespace
- * Contains types and factory methods for `HybridTerrainProvider` instance.
- */
-declare namespace HybridTerrainProvider {
-    /** Initialization options for `HybridTerrainProvider` constructor. */
-    interface ConstructorOptions {
-        /** An array of terrain areas to include in the hybrid terrain. */
-        terrainAreas: TerrainArea[];
-        /** Default provider to use outside of specified terrain areas.  */
-        terrainProvider: TerrainProvider;
-        /** Optional fallback provider when data is not available from default provider. @default EllipsoidTerrainProvider */
-        fallbackProvider?: TerrainProvider;
-    }
-    /**
-     * Calculates a bounding rectangle that encompasses all the specified tile ranges.
-     * @param tilingScheme The tiling scheme to use for calculation.
-     * @param from Tile ranges to calculate from.
-     */
-    function computeRectangle(tilingScheme: TilingScheme, from: Map<number, TerrainArea.TileRange>): Rectangle;
-}
-
-export { HybridTerrainProvider, TerrainArea };
+export { HybridTerrainProvider, type TerrainOptions, type TerrainRegion };

package/dist/terrain/index.d.ts

@@ -1,276 +1,7 @@
-import { Request, TerrainData, Credit, TerrainProvider, Rectangle, CesiumTerrainProvider, TilingScheme, TileAvailability } from 'cesium';
+import { H as HybridTerrainProvider } from '../hybrid-terrain-provider-C2V-igd9.js';
+import 'cesium';
 
-/**
- * @class
- * Represents a geographic area with a specific terrain provider.
- * `TerrainArea` pairs a provider with geographic bounds and level constraints.
- */
-declare class TerrainArea {
-    private _terrainProvider;
-    private _rectangle;
-    private _tileRanges;
-    private _ready;
-    private _credit;
-    private _isCustom;
-    /**
-     * Creates a new instance of `TerrainArea`.
-     * @param options Object describing initialization options
-     */
-    constructor(options: TerrainArea.ConstructorOptions);
-    /**
-     * Checks if the specified tile coordinates are within the bounds.
-     * @param x The tile X coordinate.
-     * @param y The tile Y coordinate.
-     * @param level The tile level.
-     * @returns `true` if the tile is within bounds, `false` otherwise.
-     */
-    contains(x: number, y: number, level: number): boolean;
-    /**
-     * Requests the geometry for a given tile. The result must include terrain data and
-     * may optionally include a water mask and an indication of which child tiles are available.
-     * @param x - The X coordinate of the tile for which to request geometry.
-     * @param y - The Y coordinate of the tile for which to request geometry.
-     * @param level - The level of the tile for which to request geometry.
-     * @param [request] - The request object. Intended for internal use only.
-     * @returns A promise for the requested geometry.  If this method
-     *          returns undefined instead of a promise, it is an indication that too many requests are already
-     *          pending and the request will be retried later.
-     */
-    requestTileGeometry(x: number, y: number, level: number, request?: Request): Promise<Awaited<TerrainData>> | undefined;
-    /**
-     * Determines whether data for a tile is available to be loaded.
-     * @param x - The X coordinate of the tile for which to request geometry.
-     * @param y - The Y coordinate of the tile for which to request geometry.
-     * @param level - The level of the tile for which to request geometry.
-     * @returns Undefined if not supported by the terrain provider, otherwise true or false.
-     * @see {@link TerrainProvider.getTileDataAvailable} */
-    getTileDataAvailable(x: number, y: number, level: number): boolean;
-    /** Checks if this terrain provider is marked as a custom provider. */
-    get isCustom(): boolean;
-    /** Gets the credit associated with this terrain area. */
-    get credit(): string | Credit;
-    /** Gets the terrain provider for this terrain area. */
-    get terrainProvider(): TerrainProvider;
-    /** Gets available tile ranges with zoom levels set with this terrain area. */
-    get tileRanges(): Map<number, TerrainArea.TileRange>;
-    /** Gets the rectangle representing this terrain area. */
-    get rectangle(): Rectangle;
-    /** Gets if this terrain area is ready. */
-    get ready(): boolean;
-}
-/**
- * @namespace
- * Contains types and factory methods for creating `TerrainArea` instances.
- */
-declare namespace TerrainArea {
-    /** Initialization options for `TerrainArea` constructor. */
-    interface ConstructorOptions {
-        /** The terrain provider for this area or a URL to create one from. */
-        terrainProvider: TerrainProvider;
-        /**
-         * Tile ranges by level when using tileRange type.
-         * Keys are zoom levels, values define the range of tiles at that level.
-         */
-        tileRanges: Map<number, TileRange>;
-        /**
-         * Credit to associate with this terrain provider.
-         * Used to identify custom terrain providers.
-         * @default custom
-         */
-        credit?: string | Credit;
-        /**
-         * Whether this is a custom terrain provider.
-         * @default true
-         */
-        isCustom?: boolean;
-    }
-    /** A range of tiles from `start` to `end` */
-    type TileRange = {
-        /** Top Left tile coordinates */
-        start: {
-            x: number;
-            y: number;
-        };
-        /** Bottom Right tile coordinates */
-        end: {
-            x: number;
-            y: number;
-        };
-    };
-    /**
-     * Creates a `TerrainArea` from a URL and tile ranges.
-     * @param url The URL to create the terrain provider from.
-     * @param tileRanges Tile ranges by level.
-     * @param options: Constructor options for CesiumTerrainProvider.
-     * @returns A promise resolving to a new `TerrainArea`
-     */
-    function fromUrl(url: string, tileRanges: Map<number, TileRange>, options?: CesiumTerrainProvider.ConstructorOptions): Promise<Awaited<TerrainArea>>;
-    /**
-     * @extends Array
-     * @class
-     * Collection-like Extended Array Class of `TerrainArea`.
-     */
-    class Collection extends Array<TerrainArea> {
-        /**
-         * Adds a new terrain area to the collection.
-         * @param area A TerrainArea instance or constructor options
-         * @returns The index of the added item
-         */
-        add(area: TerrainArea | TerrainArea.ConstructorOptions): this;
-        /**
-         * Adds terrain areas to the collection.
-         * @param areas An array of TerrainArea instance or constructor options
-         * @returns The index of the added item
-         */
-        add(areas: (TerrainArea | TerrainArea.ConstructorOptions)[]): this;
-        /**
-         * Removes a terrain area from the collection.
-         * @param area The terrain area to remove.
-         */
-        remove(area: TerrainArea): this;
-        /**
-         * Removes multiple terrain areas from the collection.
-         * @param areas The terrain areas to remove.
-         */
-        remove(areas: TerrainArea[]): this;
-        /**
-         * Clears all terrain areas.
-         */
-        removeAll(): void;
-    }
-}
+type TerrainRegion = HybridTerrainProvider.TerrainRegion;
+type TerrainOptions = HybridTerrainProvider.ConstructorOptions;
 
-/**
- * @class
- * Provides terrain by delegating requests to different terrain providers
- * based on geographic regions and zoom levels. This allows combining
- * multiple terrain sources into a single seamless terrain.
- *
- * @example
- * ``` typescript
- * // Set up tile ranges
- * const tileRanges = new Map<number, TerrainArea.TileRange>;
- * tileRanges.set(15, { start: { x: 55852, y: 9556 }, end: { x: 55871, y: 9575 } });
- * // Set up tile areas
- * const area = new TerrainArea({ terrainProvider: provider, tileRanges });
- *
- * const hybridTerrain = new HybridTerrainProvider({
- *   terrainAreas: [area],
- *   terrainProvider: new EllipsoidTerrainProvider(),
- * });
- *
- * viewer.terrainProvider = hybridTerrain;
- * ```
- */
-declare class HybridTerrainProvider implements TerrainProvider {
-    private _terrainAreas;
-    private _terrainProvider;
-    private _fallbackProvider;
-    private _tilingScheme;
-    private _ready;
-    private _availability?;
-    /**
-     * Creates a new `HybridTerrainProvider` instance.
-     * @param options {@link HybridTerrainProvider.ConstructorOptions}
-     * @returns A new `HybridTerrainProvider` instance.
-     */
-    constructor(options: HybridTerrainProvider.ConstructorOptions);
-    /**
-     * Gets a value indicating whether or not the provider is ready for use,
-     * or a promise that resolves when the provider becomes ready.
-     */
-    get ready(): boolean;
-    /**
-     * Gets the tiling scheme used by this provider.
-     */
-    get tilingScheme(): TilingScheme;
-    /**
-     * Gets an object that can be used to determine availability of terrain from this provider.
-     */
-    get availability(): TileAvailability | undefined;
-    /**
-     * Gets the list of terrain areas managed by this provider.
-     */
-    get terrainAreas(): readonly TerrainArea[];
-    /**
-     * Gets the default terrain provider.
-     */
-    get defaultProvider(): TerrainProvider;
-    /**
-     * Gets the fallback terrain provider.
-     */
-    get fallbackProvider(): TerrainProvider;
-    /**
-     * Gets the credit to display when this terrain provider is active.  Typically this is used to credit
-     * the source of the terrain.
-     */
-    get credit(): Credit;
-    /**
-     * Gets an event that is raised when the terrain provider encounters an asynchronous error.  By subscribing
-     * to the event, you will be notified of the error and can potentially recover from it.  Event listeners
-     * are passed an instance of `TileProviderError`.
-     */
-    get errorEvent(): any;
-    /**
-     * Gets a value indicating whether or not the provider includes a water mask.  The water mask
-     * indicates which areas of the globe are water rather than land, so they can be rendered
-     * as a reflective surface with animated waves.
-     */
-    get hasWaterMask(): boolean;
-    /** Gets a value indicating whether or not the requested tiles include vertex normals. */
-    get hasVertexNormals(): boolean;
-    /**
-     * Makes sure we load availability data for a tile
-     * @param x - The X coordinate of the tile for which to request geometry.
-     * @param y - The Y coordinate of the tile for which to request geometry.
-     * @param level - The level of the tile for which to request geometry.
-     * @returns Undefined if nothing need to be loaded or a Promise that resolves when all required tiles are loaded
-     */
-    loadTileDataAvailability(x: number, y: number, level: number): Promise<void> | undefined;
-    /**
-     * Gets the maximum geometric error allowed in a tile at a given level.
-     * @param level - The tile level for which to get the maximum geometric error.
-     * @returns The maximum geometric error.
-     */
-    getLevelMaximumGeometricError(level: number): number;
-    /**
-     * Requests the terrain for a given tile coordinate.
-     * @param x The X coordinate of the tile.
-     * @param y The Y coordinate of the tile.
-     * @param level The zoom level of the tile.
-     * @param request The request.
-     * @returns A promise for the requested terrain.
-     */
-    requestTileGeometry(x: number, y: number, level: number, request?: Request): Promise<Awaited<TerrainData>> | undefined;
-    /**
-     * Determines whether data for a tile is available to be loaded. Checks the specified terrain areas first.
-     * @param x - The X coordinate of the tile for which to request geometry.
-     * @param y - The Y coordinate of the tile for which to request geometry.
-     * @param level - The level of the tile for which to request geometry.
-     * @returns Undefined if not supported by the terrain provider, otherwise true or false.
-     */
-    getTileDataAvailable(x: number, y: number, level: number): boolean | undefined;
-}
-/**
- * @namespace
- * Contains types and factory methods for `HybridTerrainProvider` instance.
- */
-declare namespace HybridTerrainProvider {
-    /** Initialization options for `HybridTerrainProvider` constructor. */
-    interface ConstructorOptions {
-        /** An array of terrain areas to include in the hybrid terrain. */
-        terrainAreas: TerrainArea[];
-        /** Default provider to use outside of specified terrain areas.  */
-        terrainProvider: TerrainProvider;
-        /** Optional fallback provider when data is not available from default provider. @default EllipsoidTerrainProvider */
-        fallbackProvider?: TerrainProvider;
-    }
-    /**
-     * Calculates a bounding rectangle that encompasses all the specified tile ranges.
-     * @param tilingScheme The tiling scheme to use for calculation.
-     * @param from Tile ranges to calculate from.
-     */
-    function computeRectangle(tilingScheme: TilingScheme, from: Map<number, TerrainArea.TileRange>): Rectangle;
-}
-
-export { HybridTerrainProvider, TerrainArea };
+export { HybridTerrainProvider, type TerrainOptions, type TerrainRegion };

package/dist/terrain/index.js

@@ -1 +1 @@
-import{a,b}from"../chunk-BXU5HNPI.js";export{b as HybridTerrainProvider,a as TerrainArea};
+import{a}from"../chunk-DGHCIGKJ.js";import"../chunk-TUJQL7MC.js";export{a as HybridTerrainProvider};

package/dist/viewer/index.cjs

@@ -1 +1 @@
-"use strict";var m=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var k=Object.getOwnPropertyNames;var C=Object.prototype.hasOwnProperty;var T=(e,i)=>{for(var o in i)m(e,o,{get:i[o],enumerable:!0})},v=(e,i,o,t)=>{if(i&&typeof i=="object"||typeof i=="function")for(let n of k(i))!C.call(e,n)&&n!==o&&m(e,n,{get:()=>i[n],enumerable:!(t=g(i,n))||t.enumerable});return e};var b=e=>v(m({},"__esModule",{value:!0}),e);var h={};T(h,{cloneViewer:()=>y,syncCamera:()=>l});module.exports=b(h);var p=require("cesium");var d=require("cesium");function l(e,i){if((0,d.defined)(e)&&(0,d.defined)(i)){let{camera:o}=e;i.camera.position=o.positionWC.clone(),i.camera.direction=o.directionWC.clone(),i.camera.up=o.upWC.clone()}}function y(e,i,o){let t={baseLayerPicker:e.baseLayerPicker!==void 0,geocoder:e.geocoder!==void 0,homeButton:e.homeButton!==void 0,sceneModePicker:e.sceneModePicker!==void 0,timeline:e.timeline!==void 0,navigationHelpButton:e.navigationHelpButton!==void 0,animation:e.animation!==void 0,fullscreenButton:e.fullscreenButton!==void 0,shouldAnimate:e.clock.shouldAnimate,terrainProvider:e.terrainProvider,requestRenderMode:e.scene.requestRenderMode,infoBox:e.infoBox!==void 0},n=new p.Viewer(i,{...t,...o});l(e,n);let s=e.imageryLayers;n.imageryLayers.removeAll();for(let c=0;c<s.length;c++){let f=s.get(c);n.imageryLayers.addImageryProvider(f.imageryProvider,c)}n.clock.startTime=e.clock.startTime.clone(),n.clock.stopTime=e.clock.stopTime.clone(),n.clock.currentTime=e.clock.currentTime.clone(),n.clock.multiplier=e.clock.multiplier,n.clock.clockStep=e.clock.clockStep,n.clock.clockRange=e.clock.clockRange,n.clock.shouldAnimate=e.clock.shouldAnimate,n.scene.globe.enableLighting=e.scene.globe.enableLighting,n.scene.globe.depthTestAgainstTerrain=e.scene.globe.depthTestAgainstTerrain,n.scene.screenSpaceCameraController.enableCollisionDetection=e.scene.screenSpaceCameraController.enableCollisionDetection;let r=e.scene.screenSpaceCameraController.tiltEventTypes;r&&(n.scene.screenSpaceCameraController.tiltEventTypes=Array.isArray(r)?[...r]:r);let a=e.scene.screenSpaceCameraController.zoomEventTypes;return a&&(n.scene.screenSpaceCameraController.zoomEventTypes=Array.isArray(a)?[...a]:a),n}
+"use strict";var m=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var k=Object.getOwnPropertyNames;var C=Object.prototype.hasOwnProperty;var T=(e,i)=>{for(var t in i)m(e,t,{get:i[t],enumerable:!0})},v=(e,i,t,o)=>{if(i&&typeof i=="object"||typeof i=="function")for(let n of k(i))!C.call(e,n)&&n!==t&&m(e,n,{get:()=>i[n],enumerable:!(o=g(i,n))||o.enumerable});return e};var b=e=>v(m({},"__esModule",{value:!0}),e);var h={};T(h,{cloneViewer:()=>y,syncCamera:()=>l});module.exports=b(h);var p=require("cesium");var d=require("cesium");function l(e,i){if((0,d.defined)(e)&&(0,d.defined)(i)){let{camera:t}=e;i.camera.position=t.positionWC.clone(),i.camera.direction=t.directionWC.clone(),i.camera.up=t.upWC.clone()}}function y(e,i,t){let o={baseLayerPicker:e.baseLayerPicker!==void 0,geocoder:e.geocoder!==void 0,homeButton:e.homeButton!==void 0,sceneModePicker:e.sceneModePicker!==void 0,timeline:e.timeline!==void 0,navigationHelpButton:e.navigationHelpButton!==void 0,animation:e.animation!==void 0,fullscreenButton:e.fullscreenButton!==void 0,shouldAnimate:e.clock.shouldAnimate,terrainProvider:e.terrainProvider,requestRenderMode:e.scene.requestRenderMode,infoBox:e.infoBox!==void 0},n=new p.Viewer(i,{...o,...t});l(e,n);let s=e.imageryLayers;n.imageryLayers.removeAll();for(let c=0;c<s.length;c++){let f=s.get(c);n.imageryLayers.addImageryProvider(f.imageryProvider,c)}n.clock.startTime=e.clock.startTime.clone(),n.clock.stopTime=e.clock.stopTime.clone(),n.clock.currentTime=e.clock.currentTime.clone(),n.clock.multiplier=e.clock.multiplier,n.clock.clockStep=e.clock.clockStep,n.clock.clockRange=e.clock.clockRange,n.clock.shouldAnimate=e.clock.shouldAnimate,n.scene.globe.enableLighting=e.scene.globe.enableLighting,n.scene.globe.depthTestAgainstTerrain=e.scene.globe.depthTestAgainstTerrain,n.scene.screenSpaceCameraController.enableCollisionDetection=e.scene.screenSpaceCameraController.enableCollisionDetection;let r=e.scene.screenSpaceCameraController.tiltEventTypes;r&&(n.scene.screenSpaceCameraController.tiltEventTypes=Array.isArray(r)?[...r]:r);let a=e.scene.screenSpaceCameraController.zoomEventTypes;return a&&(n.scene.screenSpaceCameraController.zoomEventTypes=Array.isArray(a)?[...a]:a),n}

package/dist/viewer/index.js

@@ -1 +1 @@
-import{a,b}from"../chunk-2JNRK7SN.js";export{b as cloneViewer,a as syncCamera};
+import{a,b}from"../chunk-Z2COOTT4.js";export{b as cloneViewer,a as syncCamera};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juun-roh/cesium-utils",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Utilities to handle Cesium classes easier.",
   "keywords": [
     "3d",
@@ -56,10 +56,10 @@
       "import": "./dist/terrain/index.js",
       "require": "./dist/terrain/index.cjs"
     },
-    "./utils": {
-      "types": "./dist/utils/index.d.ts",
-      "import": "./dist/utils/index.js",
-      "require": "./dist/utils/index.cjs"
+    "./dev": {
+      "types": "./dist/dev/index.d.ts",
+      "import": "./dist/dev/index.js",
+      "require": "./dist/dev/index.cjs"
     },
     "./viewer": {
       "types": "./dist/viewer/index.d.ts",
@@ -71,7 +71,7 @@
     "node": ">=20.0.0"
   },
   "peerDependencies": {
-    "cesium": "^1"
+    "cesium": "^1.131.0"
   },
   "publishConfig": {
     "access": "public"
@@ -88,23 +88,24 @@
     "@commitlint/cz-commitlint": "^19.8.1",
     "@commitlint/format": "^19.8.1",
     "@commitlint/types": "^19.8.1",
-    "@eslint/js": "^9.31.0",
-    "@typescript-eslint/eslint-plugin": "^8.37.0",
-    "@typescript-eslint/parser": "^8.37.0",
+    "@eslint/js": "^9.32.0",
+    "@types/node": "^24.1.0",
+    "@typescript-eslint/eslint-plugin": "^8.38.0",
+    "@typescript-eslint/parser": "^8.38.0",
     "@vitest/coverage-v8": "^3.2.4",
     "cesium": "^1.131.0",
-    "eslint": "^9.31.0",
-    "eslint-plugin-jsdoc": "^51.4.0",
-    "eslint-plugin-prettier": "^5.5.1",
+    "eslint": "^9.32.0",
+    "eslint-plugin-jsdoc": "^52.0.0",
+    "eslint-plugin-prettier": "^5.5.3",
     "eslint-plugin-simple-import-sort": "^12.1.1",
     "eslint-plugin-unused-imports": "^4.1.4",
     "husky": "^9.1.7",
     "jsdom": "^26.1.0",
     "rimraf": "^6.0.1",
     "tsup": "^8.5.0",
-    "typedoc": "^0.28.7",
+    "typedoc": "^0.28.8",
     "typescript": "^5.8.3",
-    "vite": "^7.0.4",
+    "vite": "^7.0.6",
     "vitest": "^3.2.4"
   },
   "scripts": {

package/dist/chunk-4HY6RL6I.js

@@ -1 +0,0 @@
-import{Color as s,Entity as O,HeightReference as F,Rectangle as E,TileCoordinatesImageryProvider as V}from"cesium";import{DataSourceCollection as A,defined as _,EntityCollection as b,ImageryLayerCollection as S,PrimitiveCollection as M}from"cesium";var y=class o{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]()}_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[o.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 b?(e.collectionChanged.addEventListener(this._invalidateCache),this._eventCleanupFunctions.push(()=>e.collectionChanged.removeEventListener(this._invalidateCache))):e instanceof M?(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 A?(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&&(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)))}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,o.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 values(){if(this._valuesCache!==null)return this._valuesCache;let e;if(this.collection instanceof b)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(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}get tags(){return Array.from(this._tagMap.keys())}update(e,t){let i=this.get(e);for(let r of i)this._removeFromTagMap(r),Object.defineProperty(r,o.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)_(i.show)&&(i.show=!0);return this}hide(e){let t=this.get(e);for(let i of t)_(i.show)&&(i.show=!1);return this}toggle(e){let t=this.get(e);for(let i of t)_(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(C(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)}},T=y;var v=class o{_viewer;_collection;_terrainProvider;_visible=!1;_level=15;_tileCoordinatesLayer;_colors=new Map([["custom",s.RED],["default",s.BLUE],["fallback",s.GRAY],["grid",s.YELLOW]]);constructor(e,t){this._viewer=e,this._collection=new T({collection:e.entities,tag:o.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(o.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 V({tilingScheme:this._terrainProvider.tilingScheme,color:s.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(a=>{this._collection.add(a.entity,o.tag.grid)})}catch(r){console.error("Error displaying tile grid:",r)}}_calculateTileBounds(e,t,i){let r=i.positionToTileXY(E.northwest(e),t),n=i.positionToTileXY(E.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=[],a=Math.min(e.end.x-e.start.x+1,100),l=Math.min(e.end.y-e.start.y+1,100);for(let c=e.start.x;c<e.start.x+a;c++)for(let h=e.start.y;h<e.start.y+l;h++)try{let d=this._createTileEntity(c,h,t,i);d&&r.push({entity:d})}catch(d){console.warn(`Error creating tile (${c}, ${h}, ${t}):`,d)}return r}_createTileEntity(e,t,i,r){let n=r.tileXYToRectangle(e,t,i);if(!this._isValidRectangle(n))return null;let a=this._getTileColor(e,t,i),l=o.createRectangle(n,a.withAlpha(.3));return l.properties?.addProperty("tileX",e),l.properties?.addProperty("tileY",t),l.properties?.addProperty("tileLevel",i),l}_getTileColor(e,t,i){if(!this._terrainProvider)return this._colors.get("fallback")||s.TRANSPARENT;for(let r of this._terrainProvider.terrainAreas)if(r.contains(e,t,i))return r.isCustom?this._colors.get("custom")||s.RED:this._colors.get("default")||s.BLUE;return this._terrainProvider.getTileDataAvailable(e,t,i)?this._colors.get("default")||s.BLUE:this._colors.get("fallback")||s.GRAY}hide(){this._collection.remove(o.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;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}get colors(){return this._colors}get terrainProvider(){return this._terrainProvider}};(i=>{i.tag={default:"Terrain Visualizer",boundary:"Terrain Visualizer Boundary",grid:"Terrain Visualizer Tile Grid"};function e(r,n){return new O({rectangle:{coordinates:r,material:n,heightReference:F.CLAMP_TO_GROUND}})}i.createRectangle=e;function t(r,n,a){let l=a?.tag||"terrain_area_visualization",c=a?.color||s.RED,h=a?.maxTilesToShow||100,d=a?.show??!0,w=a?.alpha||.7,L=a?.tileAlpha||.2,m=new T({collection:n.entities,tag:l}),{rectangle:I}=r;if(m.add(i.createRectangle(I,c.withAlpha(w)),l),d&&r.tileRanges.size>0){let{tilingScheme:P}=r.terrainProvider,g=0;r.tileRanges.forEach((u,R)=>{for(let f=u.start.x;f<=u.end.x&&g<h;f++)for(let p=u.start.y;p<=u.end.y&&g<h;p++){let x=P.tileXYToRectangle(f,p,R);m.add(e(x,c.withAlpha(L)),`${l}_tile`),g++}})}return m}i.visualize=t})(v||={});function C(o,e){let t=!1,i=Object.getOwnPropertyDescriptor(o,e);if(!i){let r=Object.getPrototypeOf(o);for(;r&&!i;)i=Object.getOwnPropertyDescriptor(r,e),r=Object.getPrototypeOf(r)}return i&&i.get&&!i.set&&(t=!0),t}export{v as a,C as b,T as c};