@juun-roh/cesium-utils 0.0.2 → 0.0.4

package/dist/hybrid-terrain-provider-C6aXdtyo.d.cts

@@ -0,0 +1,345 @@
+import { TilingScheme, TerrainProvider, Rectangle, Request, TerrainData, Credit, TileAvailability } from 'cesium';
+
+/** 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;
+    };
+};
+/** A `TileRange` map with specific levels as their keys. */
+type TileRanges = Map<number, TileRange>;
+
+/**
+ * @class
+ * Defines the geographic boundaries for a terrain area and handles tile availability checks.
+ */
+declare class TerrainBounds {
+    private _rectangle;
+    private _tilingScheme;
+    private _tileRanges;
+    private _levels;
+    /**
+     * Creates a new instance of TerrainBounds.
+     * @param options {@link TerrainBounds.ConstructorOptions}
+     * @param tilingScheme (optional) The tiling scheme to use for coordinate calculations.
+     */
+    constructor(options: TerrainBounds.ConstructorOptions, tilingScheme?: TilingScheme);
+    /**
+     * 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;
+    /**
+     *
+     * Configures a terrain provider's availability based on these bounds.
+     * @see WARNING This method is accessing private property of {@link https://cesium.com/learn/csiumjs/ref-doc/TileAvailability.html `TileAvailability`}.
+     * @param provider The terrain provider to configure.
+     */
+    configureAvailability(provider: TerrainProvider): void;
+    /**
+     * Gets the rectangle representing these bounds.
+     */
+    get rectangle(): Rectangle;
+    /** Gets the tiling scheme used by these bounds. */
+    get tilingScheme(): TilingScheme;
+    /** Gets the tile ranges defined for these bounds. */
+    get tileRanges(): TileRanges;
+    /** Gets the levels for which tile ranges are defined. */
+    get levels(): Set<number>;
+    /**
+     * Calculates a bounding rectangle that encompasses all the specified tile ranges.
+     * @private
+     */
+    private _calculateRectangleFromTileRanges;
+}
+/**
+ * @namespace
+ * Contains types and factory methods for creating `TerrainBounds` instances.
+ */
+declare namespace TerrainBounds {
+    /** Initialization options for Terrain Bounds constructor */
+    interface ConstructorOptions {
+        /** Type of bounds definition. */
+        type: 'tileRange' | 'rectangle';
+        /**
+         * Tile ranges by level when using tileRange type.
+         * Keys are zoom levels, values define the range of tiles at that level.
+         * Can be provided either as a Map or as a plain object with numeric keys.
+         */
+        tileRanges?: Map<number, TileRange> | Record<string | number, TileRange>;
+        /** Rectangle bounds when using rectangle type. */
+        rectangle?: Rectangle;
+    }
+    /**
+     * Creates `TerrainBounds` from tile coordinates at a specific level.
+     * @param x The tile X coordinate.
+     * @param y The tile Y coordinate.
+     * @param level The tile level.
+     * @param tilingScheme The tiling scheme to use.
+     * @returns A new `TerrainBounds` instance for the specified tile.
+     */
+    function fromTile(x: number, y: number, level: number, tilingScheme?: TilingScheme): TerrainBounds;
+    /**
+     * Creates `TerrainBounds` from a rectangle.
+     * @param rectangle The rectangle defining the bounds.
+     * @param tilingScheme The tiling scheme to use.
+     * @returns A new `TerrainBounds` instance for the specified rectangle.
+     */
+    function fromRectangle(rectangle: Rectangle, tilingScheme?: TilingScheme): TerrainBounds;
+}
+
+/**
+ * @class
+ * Represents a geographic area with a specific terrain provider.
+ * `TerrainArea` pairs a provider with geographic bounds and level constraints.
+ */
+declare class TerrainArea {
+    private _provider;
+    private _bounds;
+    private _levels;
+    private _ready;
+    private _credit;
+    private _isCustom;
+    /**
+     * Creates a new instance of `TerrainArea`.
+     * @param options Object describing initialization options
+     * @private Use {@link TerrainArea.create} instead.
+     */
+    private constructor();
+    /**
+     * Asynchronously creates a new instance of `TerrainArea`.
+     * @param options {@link TerrainArea.ConstructorOptions}
+     * @returns A promise that resolves to a new `TerrainArea` instance.
+     */
+    static create(options: TerrainArea.ConstructorOptions): Promise<TerrainArea>;
+    /**
+     * @see {@link TerrainBounds.contains}
+     */
+    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 provider(): TerrainProvider | undefined;
+    /** Gets the terrain bounds for this terrain area. */
+    get bounds(): TerrainBounds;
+    /** Gets available zoom levels set with this terrain area. */
+    get levels(): Set<number>;
+    /** 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. */
+        provider: TerrainProvider | string;
+        /** The geographic bounds of this terrain area. */
+        bounds: TerrainBounds | TerrainBounds.ConstructorOptions;
+        /**
+         * The zoom levels this terrain area applies to.
+         * If empty, the area applies to all levels.
+         */
+        levels?: number[];
+        /**
+         * 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;
+    }
+    /**
+     * 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 levels The zoom levels this area applies to.
+     * @param credit Credit to associate with this terrain provider.
+     * @returns A promise resolving to a new `TerrainArea`
+     */
+    function fromUrl(url: string, tileRanges: TileRanges, levels?: number[], credit?: string | Credit): Promise<Awaited<TerrainArea>>;
+}
+
+/**
+ * @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
+ * const hybridTerrain = await HybridTerrainProvider.create({
+ *   terrainAreas: [
+ *     provider: 'custom-terrain-url',
+ *     bounds: {
+ *       type: 'tileRange',
+ *       tileRanges: {
+ *         15: {
+ *           start: { x: 55852, y: 9556 },
+ *           end: { x: 55871, y: 9575 },
+ *         },
+ *       },
+ *       levels: [15],
+ *     }
+ *   ],
+ *   terrainProvider: 'default-terrain-url',
+ *   fallbackProvider: 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`. Use the {@link HybridTerrainProvider.create}
+     * instead of the constructor for async initialization.
+     * @param terrainProvider The initialized default terrain provider
+     * @param fallbackProvider The initialized fallback terrain provider
+     * @param terrainAreas The array of initialized terrain areas
+     * @private - Use {@link HybridTerrainProvider.create} instead.
+     */
+    private constructor();
+    /**
+     * Asynchronously creates a new `HybridTerrainProvider`.
+     * @param options {@link HybridTerrainProvider.ConstructorOptions}
+     * @returns A promise that resolves to a new `HybridTerrainProvider` instance.
+     */
+    static create(options: HybridTerrainProvider.ConstructorOptions): Promise<HybridTerrainProvider>;
+    /**
+     * 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;
+    /**
+     * @see {@link TerrainProvider.credit}
+     */
+    get credit(): any;
+    /**
+     * @see {@link TerrainProvider.errorEvent}
+     */
+    get errorEvent(): any;
+    /**
+     * @see {@link TerrainProvider.hasWaterMask}
+     */
+    get hasWaterMask(): boolean;
+    /**
+     * @see {@link TerrainProvider.hasVertexNormals}
+     */
+    get hasVertexNormals(): boolean;
+    /**
+     * @see {@link TerrainProvider.loadTileDataAvailability}
+     */
+    loadTileDataAvailability(x: number, y: number, level: number): Promise<void> | undefined;
+    /**
+     * @see {@link TerrainProvider.getLevelMaximumGeometricError}
+     */
+    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;
+    /**
+     * @see {@link TerrainProvider.getTileDataAvailable}
+     * @param x
+     * @param y
+     * @param level
+     */
+    getTileDataAvailable(x: number, y: number, level: number): boolean | undefined;
+}
+/**
+ * @namespace
+ * Contains types and factory methods for creating `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.ConstructorOptions[];
+        /** Default provider to use outside of specified terrain areas.  */
+        terrainProvider: TerrainProvider | string;
+        /** Optional fallback provider when data is not available from default provider. @default EllipsoidTerrainProvider */
+        fallbackProvider?: TerrainProvider | string;
+    }
+    /**
+     * Creates a `HybridTerrainProvider` with a custom terrain area overlaid on a base terrain.
+     * @param customTerrainUrl URL to the custom terrain.
+     * @param baseTerrainUrl URL to the base terrain.
+     * @param tileRanges Tile ranges defining the custom terrain area.
+     * @param levels Levels to apply the custom terrain.
+     * @returns A promise resolving to a new `HybridTerrainProvider`.
+     */
+    function createOverlay(customTerrainUrl: string, baseTerrainUrl: string, tileRanges: TileRanges, levels?: number[]): Promise<Awaited<HybridTerrainProvider>>;
+}
+
+export { HybridTerrainProvider as H, TerrainArea as T, TerrainBounds as a, type TileRange as b, type TileRanges as c };

package/dist/hybrid-terrain-provider-C6aXdtyo.d.ts

@@ -0,0 +1,345 @@
+import { TilingScheme, TerrainProvider, Rectangle, Request, TerrainData, Credit, TileAvailability } from 'cesium';
+
+/** 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;
+    };
+};
+/** A `TileRange` map with specific levels as their keys. */
+type TileRanges = Map<number, TileRange>;
+
+/**
+ * @class
+ * Defines the geographic boundaries for a terrain area and handles tile availability checks.
+ */
+declare class TerrainBounds {
+    private _rectangle;
+    private _tilingScheme;
+    private _tileRanges;
+    private _levels;
+    /**
+     * Creates a new instance of TerrainBounds.
+     * @param options {@link TerrainBounds.ConstructorOptions}
+     * @param tilingScheme (optional) The tiling scheme to use for coordinate calculations.
+     */
+    constructor(options: TerrainBounds.ConstructorOptions, tilingScheme?: TilingScheme);
+    /**
+     * 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;
+    /**
+     *
+     * Configures a terrain provider's availability based on these bounds.
+     * @see WARNING This method is accessing private property of {@link https://cesium.com/learn/csiumjs/ref-doc/TileAvailability.html `TileAvailability`}.
+     * @param provider The terrain provider to configure.
+     */
+    configureAvailability(provider: TerrainProvider): void;
+    /**
+     * Gets the rectangle representing these bounds.
+     */
+    get rectangle(): Rectangle;
+    /** Gets the tiling scheme used by these bounds. */
+    get tilingScheme(): TilingScheme;
+    /** Gets the tile ranges defined for these bounds. */
+    get tileRanges(): TileRanges;
+    /** Gets the levels for which tile ranges are defined. */
+    get levels(): Set<number>;
+    /**
+     * Calculates a bounding rectangle that encompasses all the specified tile ranges.
+     * @private
+     */
+    private _calculateRectangleFromTileRanges;
+}
+/**
+ * @namespace
+ * Contains types and factory methods for creating `TerrainBounds` instances.
+ */
+declare namespace TerrainBounds {
+    /** Initialization options for Terrain Bounds constructor */
+    interface ConstructorOptions {
+        /** Type of bounds definition. */
+        type: 'tileRange' | 'rectangle';
+        /**
+         * Tile ranges by level when using tileRange type.
+         * Keys are zoom levels, values define the range of tiles at that level.
+         * Can be provided either as a Map or as a plain object with numeric keys.
+         */
+        tileRanges?: Map<number, TileRange> | Record<string | number, TileRange>;
+        /** Rectangle bounds when using rectangle type. */
+        rectangle?: Rectangle;
+    }
+    /**
+     * Creates `TerrainBounds` from tile coordinates at a specific level.
+     * @param x The tile X coordinate.
+     * @param y The tile Y coordinate.
+     * @param level The tile level.
+     * @param tilingScheme The tiling scheme to use.
+     * @returns A new `TerrainBounds` instance for the specified tile.
+     */
+    function fromTile(x: number, y: number, level: number, tilingScheme?: TilingScheme): TerrainBounds;
+    /**
+     * Creates `TerrainBounds` from a rectangle.
+     * @param rectangle The rectangle defining the bounds.
+     * @param tilingScheme The tiling scheme to use.
+     * @returns A new `TerrainBounds` instance for the specified rectangle.
+     */
+    function fromRectangle(rectangle: Rectangle, tilingScheme?: TilingScheme): TerrainBounds;
+}
+
+/**
+ * @class
+ * Represents a geographic area with a specific terrain provider.
+ * `TerrainArea` pairs a provider with geographic bounds and level constraints.
+ */
+declare class TerrainArea {
+    private _provider;
+    private _bounds;
+    private _levels;
+    private _ready;
+    private _credit;
+    private _isCustom;
+    /**
+     * Creates a new instance of `TerrainArea`.
+     * @param options Object describing initialization options
+     * @private Use {@link TerrainArea.create} instead.
+     */
+    private constructor();
+    /**
+     * Asynchronously creates a new instance of `TerrainArea`.
+     * @param options {@link TerrainArea.ConstructorOptions}
+     * @returns A promise that resolves to a new `TerrainArea` instance.
+     */
+    static create(options: TerrainArea.ConstructorOptions): Promise<TerrainArea>;
+    /**
+     * @see {@link TerrainBounds.contains}
+     */
+    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 provider(): TerrainProvider | undefined;
+    /** Gets the terrain bounds for this terrain area. */
+    get bounds(): TerrainBounds;
+    /** Gets available zoom levels set with this terrain area. */
+    get levels(): Set<number>;
+    /** 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. */
+        provider: TerrainProvider | string;
+        /** The geographic bounds of this terrain area. */
+        bounds: TerrainBounds | TerrainBounds.ConstructorOptions;
+        /**
+         * The zoom levels this terrain area applies to.
+         * If empty, the area applies to all levels.
+         */
+        levels?: number[];
+        /**
+         * 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;
+    }
+    /**
+     * 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 levels The zoom levels this area applies to.
+     * @param credit Credit to associate with this terrain provider.
+     * @returns A promise resolving to a new `TerrainArea`
+     */
+    function fromUrl(url: string, tileRanges: TileRanges, levels?: number[], credit?: string | Credit): Promise<Awaited<TerrainArea>>;
+}
+
+/**
+ * @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
+ * const hybridTerrain = await HybridTerrainProvider.create({
+ *   terrainAreas: [
+ *     provider: 'custom-terrain-url',
+ *     bounds: {
+ *       type: 'tileRange',
+ *       tileRanges: {
+ *         15: {
+ *           start: { x: 55852, y: 9556 },
+ *           end: { x: 55871, y: 9575 },
+ *         },
+ *       },
+ *       levels: [15],
+ *     }
+ *   ],
+ *   terrainProvider: 'default-terrain-url',
+ *   fallbackProvider: 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`. Use the {@link HybridTerrainProvider.create}
+     * instead of the constructor for async initialization.
+     * @param terrainProvider The initialized default terrain provider
+     * @param fallbackProvider The initialized fallback terrain provider
+     * @param terrainAreas The array of initialized terrain areas
+     * @private - Use {@link HybridTerrainProvider.create} instead.
+     */
+    private constructor();
+    /**
+     * Asynchronously creates a new `HybridTerrainProvider`.
+     * @param options {@link HybridTerrainProvider.ConstructorOptions}
+     * @returns A promise that resolves to a new `HybridTerrainProvider` instance.
+     */
+    static create(options: HybridTerrainProvider.ConstructorOptions): Promise<HybridTerrainProvider>;
+    /**
+     * 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;
+    /**
+     * @see {@link TerrainProvider.credit}
+     */
+    get credit(): any;
+    /**
+     * @see {@link TerrainProvider.errorEvent}
+     */
+    get errorEvent(): any;
+    /**
+     * @see {@link TerrainProvider.hasWaterMask}
+     */
+    get hasWaterMask(): boolean;
+    /**
+     * @see {@link TerrainProvider.hasVertexNormals}
+     */
+    get hasVertexNormals(): boolean;
+    /**
+     * @see {@link TerrainProvider.loadTileDataAvailability}
+     */
+    loadTileDataAvailability(x: number, y: number, level: number): Promise<void> | undefined;
+    /**
+     * @see {@link TerrainProvider.getLevelMaximumGeometricError}
+     */
+    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;
+    /**
+     * @see {@link TerrainProvider.getTileDataAvailable}
+     * @param x
+     * @param y
+     * @param level
+     */
+    getTileDataAvailable(x: number, y: number, level: number): boolean | undefined;
+}
+/**
+ * @namespace
+ * Contains types and factory methods for creating `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.ConstructorOptions[];
+        /** Default provider to use outside of specified terrain areas.  */
+        terrainProvider: TerrainProvider | string;
+        /** Optional fallback provider when data is not available from default provider. @default EllipsoidTerrainProvider */
+        fallbackProvider?: TerrainProvider | string;
+    }
+    /**
+     * Creates a `HybridTerrainProvider` with a custom terrain area overlaid on a base terrain.
+     * @param customTerrainUrl URL to the custom terrain.
+     * @param baseTerrainUrl URL to the base terrain.
+     * @param tileRanges Tile ranges defining the custom terrain area.
+     * @param levels Levels to apply the custom terrain.
+     * @returns A promise resolving to a new `HybridTerrainProvider`.
+     */
+    function createOverlay(customTerrainUrl: string, baseTerrainUrl: string, tileRanges: TileRanges, levels?: number[]): Promise<Awaited<HybridTerrainProvider>>;
+}
+
+export { HybridTerrainProvider as H, TerrainArea as T, TerrainBounds as a, type TileRange as b, type TileRanges as c };