@terra.gl/core 0.0.1-alpha.6

package/dist/index.d.ts

@@ -0,0 +1,1811 @@
+import { AmbientLight } from 'three';
+import { BaseEvent } from 'three';
+import { BufferGeometry } from 'three';
+import { Camera } from 'three';
+import { Clouds } from '@pmndrs/vanilla';
+import { Color } from 'three';
+import { DirectionalLight } from 'three';
+import { EventClass as EventClass_2 } from '..';
+import { EventDispatcher } from 'three';
+import { Group } from 'three';
+import { Intersection } from 'three';
+import { Line2 } from 'three-stdlib';
+import { LineString as LineString_2 } from 'geojson';
+import { LoadingManager } from 'three';
+import { LocationInfo } from './util';
+import { MapControls } from 'three-stdlib';
+import { Material } from 'three';
+import { Matrix4 } from 'three';
+import { Mesh } from 'three';
+import { MultiLineString as MultiLineString_2 } from 'geojson';
+import { MultiPoint } from 'geojson';
+import { MultiPolygon } from 'geojson';
+import { NormalBufferAttributes } from 'three';
+import { Object3D } from 'three';
+import { Object3DEventMap } from 'three';
+import { PerspectiveCamera } from 'three';
+import { Point } from 'geojson';
+import { Points } from 'three';
+import { PointsMaterial } from 'three';
+import { Polygon as Polygon_2 } from 'geojson';
+import { Raycaster } from 'three';
+import { Scene } from 'three';
+import { Texture } from 'three';
+import { TileLoadingManager as TileLoadingManager_2 } from './LoaderFactory';
+import { Vector2 } from 'three';
+import { Vector3 } from 'three';
+import { WebGLRenderer } from 'three';
+
+declare interface AnimationPauseParams {
+    paused: boolean;
+}
+
+declare interface AnimationPlayParams {
+    name: string | number;
+    loop?: boolean;
+    speed?: number;
+    fadeInDuration?: number;
+    fadeOutDuration?: number;
+    startAt?: number;
+    weight?: number;
+}
+
+declare interface AnimationSpeedParams {
+    speed: number;
+}
+
+declare interface AnimationUpdateParams {
+    deltaTime: number;
+}
+
+/**
+ * ArcGis terrain datasource
+ */
+export declare class ArcGisDemSource extends TileSource {
+    dataType: string;
+    attribution: string;
+    minLevel: number;
+    maxLevel: number;
+    url: string;
+    constructor(options?: SourceOptions);
+}
+
+/**
+ *  ArcGis datasource
+ */
+export declare class ArcGisSource extends TileSource {
+    dataType: string;
+    attribution: string;
+    style: string;
+    url: string;
+    constructor(options?: ArcGisSourceOptions);
+}
+
+export declare type ArcGisSourceOptions = SourceOptions & {
+    style?: string;
+};
+
+declare interface BaseLineStyle extends BaseStyle {
+    type: 'basic-line';
+    color?: string | number | Color;
+    width?: number;
+    dashArray?: [number, number];
+    opacity?: number;
+    zIndex?: number;
+    resolution?: Vector2;
+}
+
+declare interface BasePolygonStyle extends BaseStyle {
+    type: 'basic-polygon';
+    color?: string | number | Color;
+    opacity?: number;
+    wireframe?: boolean;
+    wireframeColor?: string | number | Color;
+    side?: 'front' | 'back' | 'double';
+    vertexColors?: boolean;
+    flatShading?: boolean;
+}
+
+declare interface BaseStyle {
+    visible?: boolean;
+    opacity?: number;
+    zIndex?: number;
+}
+
+declare interface BaseWaterStyle extends BaseStyle {
+    type: 'base-water';
+    color?: number | string;
+    opacity?: number;
+    sunDirection?: Vector3;
+    sunColor?: number | string;
+    distortionScale?: number;
+    size?: number;
+    normalMap: string;
+    fog?: boolean;
+}
+
+declare interface BasicPointStyle extends BaseStyle {
+    type: 'basic-point';
+    color?: string | number | Color;
+    size: number;
+    glow?: boolean;
+}
+
+declare type CloudProps = {
+    /** 使用种子随机数可以确保云朵形态一致，默认: Math.random()  */
+    seed?: number;
+    /** 云朵的分段或粒子数量，默认: 20  */
+    segments?: number;
+    /** 云朵的3D边界范围，默认: [5, 1, 1] */
+    bounds?: Vector3;
+    /** 分段体积在边界内的分布方式，默认: inside (边缘的云朵较小) */
+    concentrate?: 'random' | 'inside' | 'outside';
+    /**​ 分段的基础缩放比例   */
+    scale?: Vector3;
+    /** 分段体积/厚度，默认: 6  */
+    volume?: number;
+    /** 分布云朵时的最小体积，默认: 0.25 */
+    smallestVolume?: number;
+    /** 可选的自定义分布函数（会覆盖其他设置），默认: null
+     *  point和volume都是比例值，point的x/y/z范围在-1到1之间，volume范围在0到1之间 */
+    distribute?: ((cloud: CloudState, index: number) => {
+        point: Vector3;
+        volume?: number;
+    }) | null;
+    /** 动态云朵的生长系数（当speed > 0时生效），默认: 4 */
+    growth?: number;
+    /** 动画速度系数，默认: 0 */
+    speed?: number;
+    /** 相机距离达到该值时云朵会渐隐，默认: 10 */
+    fade?: number;
+    /** 不透明度，默认: 1 */
+    opacity?: number;
+    /** ​ 颜色，默认: 白色 */
+    color?: Color;
+    hexcolor?: string;
+    boundstext?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+};
+
+export declare class CloudsLayer extends OverlayLayer<ICloud> {
+    _clouds: Clouds | null;
+    constructor(id: string, options: ICloudLayerOptions);
+    private _createClouds;
+    protected validateFeature(feature: ICloud): boolean;
+    protected animate(delta: number, elapsedtime: number): void;
+}
+
+declare type CloudState = {
+    ref: Group;
+    uuid: string;
+    index: number;
+    segments: number;
+    dist: number;
+    matrix: Matrix4;
+    bounds: Vector3;
+    position: Vector3;
+    volume: number;
+    length: number;
+    speed: number;
+    growth: number;
+    opacity: number;
+    fade: number;
+    density: number;
+    rotation: number;
+    rotationFactor: number;
+    color: Color;
+};
+
+declare type CloudStyle = BaseStyle & CloudProps & {
+    type: 'cloud';
+};
+
+declare type Coordinate = [number, number] | [number, number, number];
+
+declare interface CustomStyle extends BaseStyle {
+    type: 'custom';
+    build: () => Object3D | Promise<Object3D>;
+}
+
+declare class EmptyClass {
+}
+
+export declare class EventClass {
+    private _dispatcher;
+    private _listenerMap;
+    on(type: string, listener: (data?: any) => void): this;
+    once(type: string, listener: (data?: any) => void): this;
+    off(type: string, listener: (...args: any[]) => void): this;
+    trigger(type: string, data?: any): this;
+    get threeEventDispatcher(): EventDispatcher;
+}
+
+declare interface ExtrudeStyle extends BaseStyle {
+    type: 'extrude-polygon';
+    color?: number | string;
+    opacity?: number;
+    wireframe?: boolean;
+    side?: 'front' | 'back' | 'double';
+    extrude?: {
+        height: number;
+        bevelEnabled?: boolean;
+    };
+}
+
+declare abstract class Feature extends Feature_base {
+    _position: Vector3 | Vector3[];
+    _threeGeometry: Object3D | Line2;
+    _geometry: GeoJSONGeometry;
+    _layer?: OverlayLayer;
+    _style?: Style_2;
+    private _styleQueue;
+    private _isApplyingStyle;
+    private _isGeometryInitializing;
+    constructor(options: FeatureOptions);
+    initializeGeometry(): Promise<void>;
+    abstract _toThreeJSGeometry(): Promise<void> | void;
+    setStyle(input: StyleInput): this;
+    getStyle(): Style_2 | undefined;
+    private _applyStyleWithRetry;
+    private _processStyleQueue;
+    _tryProcessQueue(): void;
+    addTo(layer: OverlayLayer): this;
+    getLayer(): OverlayLayer | null;
+    getMap(): Map_2 | null;
+    _bindLayer(layer: OverlayLayer): void;
+    _updateGeometry(): void;
+    /**
+     * 将其自身从图层中移除（如果有的话）。
+     * @english
+     * remove itself from the layer if any.
+     * @returns {Feature} this
+     */
+    _remove(): this;
+    _unbind(): void;
+    _disposeGeometry(): void;
+}
+
+declare const Feature_base: {
+    new (...args: any[]): {
+        eventClass: EventClass_2;
+        on: (type: string, listener: (data?: any) => void) => EventClass_2;
+        trigger: (type: string, data?: any) => EventClass_2;
+        off: (type: string, listener: (...args: any[]) => void) => EventClass_2;
+    };
+} & {
+    new (...args: any[]): {
+        [x: string]: any;
+        options: any;
+    };
+    mergeOptions(options: {
+        [x: string]: any;
+    }): any & typeof Object3D;
+} & typeof Object3D;
+
+declare type FeatureOptions = {
+    id?: string;
+    geometry?: GeoJSON.Geometry;
+    visible?: boolean;
+    defaultProjection?: string;
+    style?: StyleInput;
+    userData?: {
+        [key: string]: any;
+    };
+    rotateAngle?: number;
+};
+
+declare type GeoJSONGeometry = Point | MultiPoint | LineString_2 | MultiLineString_2 | Polygon_2 | MultiPolygon;
+
+export declare class ICloud extends Point_2 {
+    _type: string;
+    constructor(options: PointOptions);
+    _toThreeJSGeometry(): Promise<void>;
+    _updateGeometry(): void;
+    _createObject(style: Style_2): Promise<any>;
+}
+
+declare type ICloudLayerOptions = OverlayLayerOptions<ICloud> & {
+    texture: string | Texture;
+};
+
+declare interface IconLabelStyle extends BaseStyle {
+    type: 'icon-label-point';
+    text: string;
+    iconUrl?: string;
+    iconSize?: number;
+    iconScale?: number;
+    fontSize?: number;
+    fontFamily?: string;
+    textColor?: string;
+    strokeColor?: string;
+    strokeWidth?: number;
+    renderbg?: boolean;
+    bgColor?: string;
+    padding?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    canvasScale?: number;
+}
+
+declare interface IconPointStyle extends BaseStyle {
+    type: 'icon-point';
+    color?: string | number | Color;
+    url: string;
+    size: [number, number];
+    rotation?: number;
+    anchor?: [number, number];
+    sizeAttenuation?: boolean;
+}
+
+/**
+ * Porjection interface
+ */
+declare interface IProjection {
+    readonly ID: ProjectionType_2;
+    readonly mapWidth: number;
+    readonly mapHeight: number;
+    readonly mapDepth: number;
+    readonly lon0: number;
+    project(lon: number, lat: number): {
+        x: number;
+        y: number;
+    };
+    unProject(x: number, y: number): {
+        lon: number;
+        lat: number;
+    };
+    getTileXWithCenterLon(x: number, z: number): number;
+    getProjBoundsFromLonLat(bounds: [number, number, number, number]): [number, number, number, number];
+    getProjBoundsFromXYZ(x: number, y: number, z: number): [number, number, number, number];
+    getLonLatBoundsFromXYZ(x: number, y: number, z: number): [number, number, number, number];
+}
+
+/**
+ * Source interface
+ * all source implements ISource get url from x/y/z coordinate to url
+ */
+declare interface ISource {
+    /** A string identifies the source data type, it requires the support of the loader. */
+    dataType: string;
+    /** Source attribution info, it allows you to display attribution*/
+    attribution: string;
+    /** Data max level */
+    minLevel: number;
+    /** Data min level */
+    maxLevel: number;
+    /** Data projection */
+    projectionID: ProjectionType;
+    /** Display opacity */
+    opacity: number;
+    /** is TMS scheme */
+    isTMS?: boolean;
+    bounds: [number, number, number, number];
+    /** Data bounds in Proejction, internal use */
+    _projectionBounds: [number, number, number, number];
+    /** Get url from xyz, internal use */
+    _getUrl(x: number, y: number, z: number): string | undefined;
+    /** Any data */
+    [key: string]: unknown;
+}
+
+/** Tile Loader Interface */
+declare interface ITileLoader<TMeshData extends MeshDateType = MeshDateType> {
+    /** Load Tile Data */
+    manager: TileLoadingManager;
+    /** Image Loader */
+    imgSource: ISource[];
+    /** Terrain Loader */
+    demSource: ISource | undefined;
+    /** Load Tile Data */
+    load(params: TileLoadParamsType): Promise<TMeshData>;
+    /** Unload Tile Data */
+    unload?(tileMesh: Mesh): void;
+}
+
+export declare class Label extends Point_2 {
+    _type: string;
+    constructor(options: MakerOptions_2);
+    _toThreeJSGeometry(): Promise<void>;
+    _createObject(style: Style_2): Promise<Object3D>;
+}
+
+declare interface LabelStyle extends BaseStyle {
+    type: 'canvas-label' | 'canvas-label-fixed';
+    text: string;
+    fontSize?: number;
+    fontFamily?: string;
+    fontWeight?: 'normal' | 'bold' | 'bolder' | 'lighter' | number;
+    fontStyle?: 'normal' | 'italic' | 'oblique';
+    textColor?: string;
+    strokeColor?: string;
+    strokeWidth?: number;
+    showBackground?: boolean;
+    bgStyle?: 1 | 2;
+    bgColor?: string;
+    bgOpacity?: number;
+    shadowColor?: string;
+    shadowBlur?: number;
+    shadowOffsetX?: number;
+    shadowOffsetY?: number;
+    roundRectRadius?: number;
+    bubblePointerHeight?: number;
+    bubblePointerWidth?: number;
+    bubbleBorderColor?: string;
+    bubbleBorderWidth?: number;
+    fixedSize?: number;
+    screenSpaceSize?: number;
+}
+
+/**
+ * 抽象类，不参与实例化
+ * Layer is the base class of all layers.
+ * @class Layer
+ * @param {String} id - layer id.
+ * @param {LayerOptions} [options=null] - options of layer.
+ */
+declare abstract class Layer extends Layer_base {
+    private _id;
+    opacity: number;
+    private _animationCallbacks;
+    constructor(id: string, options?: LayerOptions);
+    getId(): string;
+    addTo(map: Map_2): this;
+    getZIndex(): number;
+    getOpacity(): number;
+    setOpacity(opacity: number): void;
+    getMap(): any;
+    /**
+     * 显示图层
+     * @returns
+     */
+    show(): this;
+    /**
+     * 隐藏图层
+     * @returns this
+     */
+    hide(): this;
+    _bindMap(map: Map_2): void;
+    /**
+     * 子类可实现的动画逻辑（可选）
+     *  @param delta 帧间隔时间
+     */
+    protected animate?(delta: number, elapsedtime: number): void;
+    /**
+     * 注册动画回调到 Viewer
+     */
+    private _registerAnimate;
+    /**
+     * 移除动画回调
+     */
+    protected _clearAnimationCallbacks(): void;
+}
+
+declare const Layer_base: {
+    new (...args: any[]): {
+        eventClass: EventClass_2;
+        on: (type: string, listener: (data?: any) => void) => EventClass_2;
+        trigger: (type: string, data?: any) => EventClass_2;
+        off: (type: string, listener: (...args: any[]) => void) => EventClass_2;
+    };
+} & {
+    new (...args: any[]): {
+        [x: string]: any;
+        options: any;
+    };
+    mergeOptions(options: {
+        [x: string]: any;
+    }): any & typeof Group;
+} & typeof Group;
+
+/**
+ * 图层容器类，用于管理多个图层
+ */
+declare class LayerContainer extends Group {
+    private _layers;
+    _layerids: Set<string>;
+    add(...layers: Layer[]): this;
+    remove(...layers: Layer[]): this;
+    getLayers(): Layer[];
+    /**
+     * 根据 ID 查找 Layer
+     * @param id 要查找的 Layer ID
+     * @returns 找到的 Layer，如果不存在则返回 undefined
+     */
+    getLayerById(id: string): Layer | undefined;
+    /**
+     * 清空所有图层
+     * @returns this，用于链式调用
+     */
+    clearLayers(): this;
+}
+
+declare type LayerOptions = {
+    attribution?: string;
+    visible?: boolean;
+    opacity?: number;
+    zIndex?: number;
+};
+
+declare interface LightWaterStyle extends BaseStyle {
+    type: 'water';
+    color?: number | string;
+    opacity?: number;
+    sunDirection?: Vector3;
+    sunColor?: number | string;
+    distortionScale?: number;
+    size?: number;
+    normalMap: string;
+    fog?: boolean;
+}
+
+declare abstract class Line extends Feature {
+    readonly _baseType = "Line";
+    abstract _type: string;
+    _vertexPoints: number[];
+    constructor(options: LineOptions);
+    _coordsTransform(): any;
+    _toThreeJSGeometry(): void;
+    protected _createThreeGeometry(): Line2;
+}
+
+export declare class LineLayer extends OverlayLayer<Line> {
+    constructor(id: string, options?: LineLayerOptions);
+    protected validateFeature(feature: Line): boolean;
+}
+
+declare type LineLayerOptions = OverlayLayerOptions<Line> & {};
+
+declare type LineOptions = FeatureOptions & {
+    geometry?: LineString_2 | MultiLineString_2;
+};
+
+export declare class LineString extends Line {
+    _type: string;
+    constructor(options: LineStringOptions);
+    _toThreeJSGeometry(): Promise<void>;
+    _createObject(style: Style_2): Promise<Object3D>;
+    _updateGeometry(): void;
+}
+
+declare type LineStringOptions = LineOptions & {};
+
+declare enum LODAction {
+    none = 0,
+    create = 1,
+    remove = 2
+}
+
+export declare class Maker extends Point_2 {
+    _type: string;
+    constructor(options: MakerOptions);
+    _toThreeJSGeometry(): Promise<void>;
+    _createObject(style: Style_2): Promise<Object3D>;
+}
+
+declare type MakerOptions = PointOptions & {};
+
+declare type MakerOptions_2 = PointOptions & {};
+
+declare class Map extends Map_base {
+    viewer: Viewer;
+    tilemap: TileMap;
+    readonly center: Coordinate;
+    options: Required<MapOptions>;
+    private _layerContainer;
+    private _EventMap;
+    private _canvasManager;
+    _onLoadHooks: Array<(...args: any[]) => void>;
+    constructor(container: HTMLElement | string, options: MapOptions);
+    static addOnLoadHook(fn: string | ((this: Map, ...args: any[]) => void), ...args: any[]): typeof Map;
+    _callOnLoadHooks(): void;
+    /**
+     * 初始化tilemap 地图
+     * @param options 地图配置项
+     * @returns tilemap地图对象
+     * */
+    private initTileMap;
+    /**
+     * 添加图层
+     * @param layers 图层对象或图层对象数组
+     * @param otherLayers 其他图层对象
+     * @returns 当前地图对象
+     */
+    addLayer(layers: Layer | Array<Layer>, ...otherLayers: Array<Layer>): this;
+    /**
+     * 移除图层
+     * @param layers 要移除的图层对象或图层对象数组
+     * @returns 当前地图对象
+     */
+    clearLayers(): LayerContainer;
+    /**
+     * 根据 ID 获取图层
+     * @param id 图层 ID
+     * @returns 找到的图层对象，如果未找到则返回 undefined
+     */
+    getLayers(): Layer[];
+    /**
+     * 根据 ID 获取图层
+     * @param id 图层 ID
+     * @returns 找到的图层对象，如果未找到则返回 undefined
+     */
+    getLayerById(id: string): Layer | undefined;
+    geo2world(coords: Vector3): Vector3;
+    world2geo(coords: Vector3): Vector3;
+    _getCanvas(width?: number, height?: number, keySuffix?: string): HTMLCanvasElement;
+}
+export { Map_2 as Map }
+
+declare const Map_base: {
+    new (...args: any[]): {
+        eventClass: EventClass_2;
+        on: (type: string, listener: (data?: any) => void) => EventClass_2;
+        trigger: (type: string, data?: any) => EventClass_2;
+        off: (type: string, listener: (...args: any[]) => void) => EventClass_2;
+    };
+} & {
+    new (...args: any[]): {
+        [x: string]: any;
+        options: any;
+    };
+    mergeOptions(options: {
+        [x: string]: any;
+    }): any & typeof EmptyClass;
+} & typeof EmptyClass;
+
+/**
+ * MapBox datasource
+ */
+export declare class MapBoxSource extends TileSource {
+    token: string;
+    format: string;
+    style: string;
+    attribution: string;
+    maxLevel: number;
+    url: string;
+    constructor(options?: MapBoxSourceOptions);
+}
+
+export declare type MapBoxSourceOptions = SourceOptions & {
+    style?: string;
+    token: string;
+};
+
+declare type MapOptions = {
+    viewer?: ViewerOptions;
+    meshmap: TileMapParams;
+    center: Coordinate;
+};
+
+/** Tile Mesh Data Type */
+declare type MeshDateType = {
+    /** Tile materials */
+    materials: Material[];
+    /** Tile geometry */
+    geometry: BufferGeometry;
+};
+
+export declare class Model extends Point_2 {
+    _type: string;
+    private _emissive;
+    private _emissiveIntensity;
+    private _emissiveColor;
+    private _mixer;
+    private _currentAction;
+    private _animations;
+    private _clock;
+    private _autoUpdate;
+    private _animationRequestId;
+    private _iscity;
+    constructor(options: ModelOptions);
+    _toThreeJSGeometry(): Promise<void>;
+    _createObject(style: Style_2): Promise<any>;
+    private _applyEmissionProperties;
+    get emissive(): boolean;
+    set emissive(value: boolean);
+    get emissiveIntensity(): number;
+    set emissiveIntensity(value: number);
+    get emissiveColor(): string;
+    set emissiveColor(value: string);
+    setEmission(enabled: boolean, intensity?: number, color?: string): void;
+    setShadows(options: {
+        cast: boolean;
+        receive: boolean;
+    }): Promise<void>;
+    playAnimation(params: AnimationPlayParams): void;
+    stopAnimation(params?: {
+        fadeDuration?: number;
+    }): void;
+    setAnimationPaused(params: AnimationPauseParams): void;
+    setAnimationSpeed(params: AnimationSpeedParams): void;
+    updateAnimation(params: AnimationUpdateParams): void;
+    getAnimationNames(): string[];
+    getCurrentAnimationName(): string | null;
+    getAnimationDuration(params: {
+        name: string | number;
+    }): number | null;
+    dispose(): void;
+    private _startAnimationLoop;
+    private _stopAnimationLoop;
+    setAutoUpdate(enabled: boolean): void;
+    private _rendercity;
+}
+
+declare type ModelOptions = PointOptions & {
+    emissive?: boolean;
+    emissiveIntensity?: number;
+    emissiveColor?: string;
+    castShadow?: boolean;
+    receiveShadow?: boolean;
+    iscity?: boolean;
+};
+
+declare interface ModelStyle extends BaseStyle {
+    url: string;
+    type: 'gltf' | 'fbx';
+    position?: Vector3;
+    scale?: number | Vector3 | {
+        x?: number;
+        y?: number;
+        z?: number;
+    };
+    rotation?: Vector3;
+    materialOverrides?: Record<string, Material>;
+    manager?: LoadingManager;
+    dracoOptions?: {
+        enable: boolean;
+        decoderPath?: string;
+    };
+    shadows?: {
+        cast?: boolean;
+        receive?: boolean;
+        quality?: 'low' | 'medium' | 'high';
+    };
+}
+
+export declare class MultiLineString extends Line {
+    _type: string;
+    private _lineObjects;
+    private _linesContainer;
+    constructor(options: MultiLineStringOptions);
+    _toThreeJSGeometry(): Promise<void>;
+    private _createLineObject;
+    _coordsTransform(): any;
+    private _updateContainer;
+    private clearLines;
+    _updateGeometry(): void;
+    _disposeObject(): void;
+}
+
+declare type MultiLineStringOptions = LineOptions & {};
+
+/**
+ * Layer的基类， 管理features
+ * 抽象类，不能直接实例化
+ */
+declare abstract class OverlayLayer<T extends Feature = Feature> extends Layer {
+    private _feaList;
+    constructor(id: string, options?: OverlayLayerOptions<T>);
+    /**
+     *  子类必须实现的校验逻辑（抽象方法）
+     *  @param feature 待校验的 Feature
+     *  @returns 是否合法
+     **/
+    protected abstract validateFeature(feature: T): boolean;
+    /**
+     * 添加Feature到图层
+     * @param feature 要添加的Feature实例或实例数组
+     * @param fitView 是否自动调整地图视野
+     */
+    addFeature(features: T | T[]): this;
+    /**
+     * 获取所有的Features
+     * @param filter
+     * @param context
+     * @returns
+     */
+    getFeatures(filter?: (feature: Feature) => boolean, context?: any): Array<Feature>;
+    /**
+     * 获取 features 个数
+     *
+     * Get count of the features
+     * @return count
+     */
+    getCount(): number;
+    /**
+     * layer 是否为空
+     *
+     * @english
+     * Whether the layer is empty.
+     * @return {Boolean}
+     */
+    isEmpty(): boolean;
+    /**
+     * 移除一个或多个features
+     *
+     * @english
+     * Removes one or more features from the layer
+     * @param  features - feature ids or features to remove
+     * @returns this
+     */
+    removeFeature(features: Feature | Feature[]): any;
+    onRemoveFeature(feature: Feature): void;
+    _findInList(feature: Feature): number;
+    private _disposeFeatureResources;
+}
+
+declare type OverlayLayerOptions<T extends Feature> = LayerOptions & {
+    features?: T[];
+};
+
+declare interface PipelineStyle extends BaseStyle {
+    type: 'tube-line';
+    color?: string | number | Color;
+    radius: number;
+    segments?: number;
+    caps?: boolean;
+    flowTexture?: string;
+    pressure?: number;
+}
+
+declare abstract class Point_2 extends Feature {
+    readonly _baseType = "Point";
+    abstract _type: string;
+    constructor(options: PointOptions);
+    _coordsTransform(): Vector3;
+    _toThreeJSGeometry(): void;
+    protected _createThreeGeometry(): Points<BufferGeometry<NormalBufferAttributes>, PointsMaterial, Object3DEventMap>;
+}
+
+export declare class PointLayer extends OverlayLayer<Point_2> {
+    constructor(id: string, options?: PointLayerOptions);
+    protected validateFeature(feature: Point_2): boolean;
+}
+
+declare type PointLayerOptions = OverlayLayerOptions<Point_2> & {};
+
+declare type PointOptions = FeatureOptions & {
+    geometry?: Point | MultiPoint;
+};
+
+declare type PointStyle = BasicPointStyle | IconPointStyle | IconLabelStyle;
+
+export declare class Polygon extends Surface {
+    _type: string;
+    constructor(options: PolygonOptions);
+    _toThreeJSGeometry(): Promise<void>;
+    _createObject(style: Style_2): Promise<Object3D>;
+}
+
+export declare class PolygonLayer extends OverlayLayer<Polygon> {
+    constructor(id: string, options?: PolygonLayerOptions);
+    protected validateFeature(feature: Polygon): boolean;
+}
+
+declare type PolygonLayerOptions = OverlayLayerOptions<Polygon> & {};
+
+declare type PolygonOptions = SurfaceOptions & {
+    geometry?: Polygon_2 | MultiPolygon;
+};
+
+/**
+ * Map projection center longitude type
+ * 地图投影中心经度类型
+ */
+declare type ProjectCenterLongitude = 0 | 90 | -90;
+
+/** Project ID */
+declare type ProjectionType = "3857" | "4326";
+
+declare type ProjectionType_2 = "3857" | "4326";
+
+/**
+ * source construtor params type
+ */
+declare interface SourceOptions {
+    /** A string identifies the source data type, it requires the support of the loader. */
+    dataType?: string;
+    /** Source attribution info, it allows you to display attribution*/
+    attribution?: string;
+    /** Data max level */
+    minLevel?: number;
+    /** Data min level */
+    maxLevel?: number;
+    /** Data projection */
+    projectionID?: ProjectionType;
+    /** Display opacity */
+    opacity?: number;
+    bounds?: [number, number, number, number];
+    /** Data Url template */
+    url?: string;
+    /** Url subdomains array or string */
+    subdomains?: string[] | string;
+    /** Is TMS scheme */
+    isTMS?: boolean;
+    /** Any data */
+    [key: string]: unknown;
+}
+
+declare type Style = "img_w" | "cia_w" | "cva_w" | "ibo_w" | "ter_w" | "vec_w" | "cta_w" | "img_c" | "cia_c";
+
+declare class Style_2 {
+    config: StyleConfig;
+    private static _textureCache;
+    private static _textureLoader;
+    constructor(config: StyleConfig);
+    applyTo(object: Object3D): Promise<boolean>;
+    private _applyPointStyle;
+    private _applyIconPoint;
+    private _applyBasicPoint;
+    private _applyIconLabelPoint;
+    private _applyLineStyle;
+    private _applyPolygonStyle;
+    private _applyExtrudeStyle;
+    private _applyWaterStyle;
+    private _applyCloudStyle;
+    private _applyTextSpriteStyle;
+    private _applyModelStyle;
+    private _applyCustomStyle;
+    static _loadTexture(url: string): Promise<Texture>;
+    static create(input: StyleInput): Style_2;
+}
+
+declare type StyleConfig = PointStyle | BaseLineStyle | PipelineStyle | ModelStyle | CustomStyle | BasePolygonStyle | ExtrudeStyle | WaterStyle | CloudStyle | BaseWaterStyle | LabelStyle | IconLabelStyle;
+
+declare type StyleInput = StyleConfig | Style_2;
+
+declare abstract class Surface extends Feature {
+    readonly _baseType = "Surface";
+    abstract _type: string;
+    _vertexPoints: number[];
+    constructor(options: SurfaceOptions);
+    _coordsTransform(): any;
+    _updateGeometry(): void;
+    protected _createThreeGeometry(): Line2;
+}
+
+declare type SurfaceOptions = FeatureOptions & {
+    geometry?: Polygon_2 | MultiPolygon;
+};
+
+export declare class TDTQMSource extends TileSource {
+    dataType: string;
+    attribution: string;
+    token: string;
+    subdomains: string;
+    url: string;
+    constructor(options?: TDTSourceOptins);
+}
+
+/**
+ * TianDiTu datasource
+ */
+export declare class TDTSource extends TileSource {
+    dataType: string;
+    attribution: string;
+    token: string;
+    style: Style;
+    subdomains: string;
+    url: string;
+    constructor(options?: TDTSourceOptins);
+}
+
+export declare type TDTSourceOptins = SourceOptions & {
+    style?: Style;
+    token: string;
+};
+
+/**
+ * Class Tile, inherit of Mesh
+ */
+/**
+ * Represents a tile in a 3D scene.
+ * Extends the Mesh class with BufferGeometry and Material.
+ */
+declare class Tile extends Mesh<BufferGeometry, Material[], TTileEventMap> {
+    private static _downloadThreads;
+    /**
+     * Number of download threads.
+     */
+    static get downloadThreads(): number;
+    /** Coordinate of tile */
+    readonly x: number;
+    readonly y: number;
+    readonly z: number;
+    /** Is a tile? */
+    readonly isTile = true;
+    /** Tile parent */
+    readonly parent: this | null;
+    /** Children of tile */
+    readonly children: this[];
+    private _ready;
+    /** return this.minLevel < map.minLevel, True mean do not needs load tile data */
+    private _isDummy;
+    get isDummy(): boolean;
+    private _showing;
+    /**
+     * Gets the showing state of the tile.
+     */
+    get showing(): boolean;
+    /**
+     * Sets the showing state of the tile.
+     * @param value - The new showing state.
+     */
+    set showing(value: boolean);
+    /** Max height of tile */
+    private _maxZ;
+    /**
+     * Gets the maximum height of the tile.
+     */
+    get maxZ(): number;
+    /**
+     * Sets the maximum height of the tile.
+     * @param value - The new maximum height.
+     */
+    protected set maxZ(value: number);
+    /** Distance to camera */
+    distToCamera: number;
+    sizeInWorld: number;
+    /**
+     * Gets the index of the tile in its parent's children array.
+     * @returns The index of the tile.
+     */
+    get index(): number;
+    private _loaded;
+    /**
+     * Gets the load state of the tile.
+     */
+    get loaded(): boolean;
+    private _inFrustum;
+    /** Is tile in frustum ?*/
+    get inFrustum(): boolean;
+    /**
+     * Sets whether the tile is in the frustum.
+     * @param value - The new frustum state.
+     */
+    protected set inFrustum(value: boolean);
+    /** Tile is a leaf ?  */
+    get isLeaf(): boolean;
+    /**
+     * Constructor for the Tile class.
+     * @param x - Tile X-coordinate, default: 0.
+     * @param y - Tile Y-coordinate, default: 0.
+     * @param z - Tile level, default: 0.
+     */
+    constructor(x?: number, y?: number, z?: number);
+    /**
+     * Override Object3D.traverse, change the callback param type to "this".
+     * @param callback - The callback function.
+     */
+    traverse(callback: (object: this) => void): void;
+    /**
+     * Override Object3D.traverseVisible, change the callback param type to "this".
+     * @param callback - The callback function.
+     */
+    traverseVisible(callback: (object: this) => void): void;
+    /**
+     * Override Object3D.raycast, only test the tile has loaded.
+     * @param raycaster - The raycaster.
+     * @param intersects - The array of intersections.
+     */
+    raycast(raycaster: Raycaster, intersects: Intersection[]): void;
+    /**
+     * LOD (Level of Detail).
+     * @param loader - The tile loader.
+     * @param minLevel - The minimum level.
+     * @param maxLevel - The maximum level.
+     * @param threshold - The threshold.
+     * @returns this
+     */
+    protected LOD(params: TileUpdateParames): {
+        action: LODAction;
+        newTiles?: undefined;
+    } | {
+        action: LODAction;
+        newTiles: Tile[];
+    };
+    /**
+     * Checks the visibility of the tile.
+     */
+    private _checkVisible;
+    /**
+     * Asynchronously load tile data
+     *
+     * @param loader Tile loader
+     * @returns this
+     */
+    private _load;
+    /** New tile init */
+    private _init;
+    /**
+     * Updates the tile.
+     * @param params - The update parameters.
+     * @returns this
+     */
+    update(params: TileUpdateParames): this;
+    private _doAction;
+    /**
+     * Reloads the tile data.
+     * @returns this
+     */
+    reload(loader: ITileLoader): this;
+    /**
+     * Checks if the tile is ready to render.
+     * @returns this
+     */
+    private _checkReady;
+    /**
+     * UnLoads the tile data.
+     * @param unLoadSelf - Whether to unload tile itself.
+     * @returns this.
+     */
+    private _unLoad;
+}
+
+/**
+ * Tile loader
+ */
+declare class TileLoader implements ITileLoader {
+    private _imgSource;
+    /** Get image source */
+    get imgSource(): ISource[];
+    /** Set image source */
+    set imgSource(value: ISource[]);
+    private _demSource;
+    /** Get DEM source */
+    get demSource(): ISource | undefined;
+    /** Set DEM source */
+    set demSource(value: ISource | undefined);
+    /** Loader manager */
+    manager: TileLoadingManager_2;
+    /**
+     * Load getmetry and materail of tile from x, y and z coordinate.
+     *
+     * @returns Promise<MeshDateType> tile data
+     */
+    load(params: TileLoadParamsType): Promise<MeshDateType>;
+    /**
+     * Unload tile mesh data
+     * @param tileMesh tile mesh
+     */
+    unload(tileMesh: Mesh): void;
+    /**
+     * Load geometry
+     * @returns BufferGeometry
+     */
+    protected loadGeometry(params: TileLoadParamsType): Promise<BufferGeometry>;
+    /**
+     * Load material
+     * @param x x coordinate of tile
+     * @param y y coordinate of tile
+     * @param z z coordinate of tile
+     * @returns Material[]
+     */
+    protected loadMaterial(params: TileLoadParamsType): Promise<Material[]>;
+    /**
+     * Check the tile is in the source bounds. (projection coordinate)
+     * @returns true in the bounds,else false
+     */
+    private _isBoundsInSourceBounds;
+}
+
+declare class TileLoadingManager extends LoadingManager {
+    onParseEnd?: (url: string) => void;
+    parseEnd(url: string): void;
+}
+
+/**
+ * Tile Load Params Type
+ */
+declare type TileLoadParamsType = {
+    /** Tile X Coordinate */
+    x: number;
+    /** Tile Y Coordinate */
+    y: number;
+    /** Tile Z Coordinate */
+    z: number;
+    /** Tile projection Bounds */
+    bounds: [number, number, number, number];
+    /** Tile lonlat Bounds */
+    lonLatBounds?: [number, number, number, number];
+};
+
+/**
+ * Map Mesh
+ * 地图模型
+ */
+declare class TileMap extends Mesh<BufferGeometry, Material, TileMapEventMap> {
+    readonly name = "map";
+    private readonly _clock;
+    readonly isLOD = true;
+    /**
+     * Whether the LOD object is updated automatically by the renderer per frame or not.
+     * If set to false, you have to call LOD.update() in the render loop by yourself. Default is true.
+     * 瓦片是否在每帧渲染时自动更新，默认为真
+     */
+    autoUpdate: boolean;
+    /**
+     * Tile tree update interval, unit: ms (default 100ms)
+     * 瓦片树更新间隔，单位毫秒（默认100ms）
+     */
+    updateInterval: number;
+    /**
+     * Root tile, it is the root node of tile tree.
+     * 根瓦片
+     */
+    readonly rootTile: Tile;
+    /**
+     * Map data loader, it used for load tile data and create tile geometry/Material
+     * 地图数据加载器
+     */
+    readonly loader: ITileLoader;
+    readonly _loader: TileMapLoader;
+    private _minLevel;
+    /**
+     * Get min level of map
+     * 地图最小缩放级别，小于这个级别瓦片树不再更新
+     */
+    get minLevel(): number;
+    /**
+     * Set max level of map
+     * 设置地图最小缩放级别，小于这个级别瓦片树不再更新
+     */
+    set minLevel(value: number);
+    private _maxLevel;
+    /**
+     * Get max level of map
+     * 地图最大缩放级别，大于这个级别瓦片树不再更新
+     */
+    get maxLevel(): number;
+    /**
+     * Set max level of map
+     * 设置地图最大缩放级别，大于这个级别瓦片树不再更新
+     */
+    set maxLevel(value: number);
+    /**
+     * Get central Meridian latidute
+     * 取得中央子午线经度
+     */
+    get lon0(): number;
+    /**
+     * Set central Meridian latidute, default:0
+     * 设置中央子午线经度，中央子午线决定了地图的投影中心经度，可设置为-90，0，90
+     */
+    set lon0(value: number);
+    private _projection;
+    /**
+     * Set the map projection object
+     * 取得地图投影对象
+     */
+    get projection(): IProjection;
+    /**
+     * Get the map projection object
+     * 设置地图投影对象
+     */
+    private set projection(value);
+    private _imgSource;
+    /**
+     * Get the image data source object
+     * 取得影像数据源
+     */
+    get imgSource(): ISource[];
+    /**
+     * Set the image data source object
+     * 设置影像数据源
+     */
+    set imgSource(value: ISource | ISource[]);
+    private _demSource;
+    /**
+     * Get the terrain data source
+     * 设置地形数据源
+     */
+    get demSource(): ISource | undefined;
+    /**
+     * Set the terrain data source
+     * 取得地形数据源
+     */
+    set demSource(value: ISource | undefined);
+    private _LODThreshold;
+    /**
+     * Get LOD threshold
+     * 取得LOD阈值
+     */
+    get LODThreshold(): number;
+    /**
+     * Set LOD threshold
+     * 设置LOD阈值，LOD阈值越大，瓦片细化，但耗费资源越高，建议取1-2之间
+     */
+    set LODThreshold(value: number);
+    /**
+     * Create a map using factory function
+     * 地图创建工厂函数
+     @param params 地图参数 {@link TileMapParams}
+     @returns map mesh 地图模型
+     @example
+     ``` typescript
+     TileMap.create({
+     // 影像数据源
+     imgSource: [Source.mapBoxImgSource, new TestSource()],
+     // 高程数据源
+     demSource: source.mapBoxDemSource,
+     // 地图投影中心经度
+     lon0: 90,
+     // 最小缩放级别
+     minLevel: 1,
+     // 最大缩放级别
+     maxLevel: 18,
+     });
+     ```
+     */
+    static create(params: TileMapParams): TileMap;
+    /**
+     * Map mesh constructor
+     *
+     * 地图模型构造函数
+     * @param params 地图参数 {@link TileMapParams}
+     * @example
+     * ``` typescript
+
+     const map = new TileMap({
+     // 加载器
+     loader: new TileLoader(),
+     // 影像数据源
+     imgSource: [Source.mapBoxImgSource, new TestSource()],
+     // 高程数据源
+     demSource: source.mapBoxDemSource,
+     // 地图投影中心经度
+     lon0: 90,
+     // 最小缩放级别
+     minLevel: 1,
+     // 最大缩放级别
+     maxLevel: 18,
+     });;
+     * ```
+     */
+    constructor(params: TileMapParams);
+    /**
+     * Update the map, It is automatically called after mesh adding a scene
+     * 模型更新回调函数，地图加入场景后会在每帧更新时被调用，该函数调用根瓦片实现瓦片树更新和数据加载
+     * @param camera
+     */
+    update(camera: Camera): void;
+    /**
+     * reload the map data，muse called after the source has changed
+     * 重新加载地图，在改变地图数据源后调用它才能生效
+     */
+    reload(): void;
+    /**
+     * dispose map.
+     * todo: remve event.
+     * 释放地图资源，并移出场景
+     */
+    dispose(): void;
+    /**
+     * Geo coordinates converted to map model coordinates
+     * 地理坐标转换为地图模型坐标(与geo2map同功能)
+     * @param geo 地理坐标（经纬度）
+     * @returns 模型坐标
+     * @deprecated This method is not recommended. Use geo2map() instead.
+     */
+    geo2pos(geo: Vector3): Vector3;
+    /**
+     * Geo coordinates converted to map model coordinates
+     * 地理坐标转换为地图模型坐标(与geo2pos同功能)
+     * @param geo 地理坐标（经纬度）
+     * @returns 模型坐标
+     */
+    geo2map(geo: Vector3): Vector3;
+    /**
+     * Geo coordinates converted to world coordinates
+     * 地理坐标转换为世界坐标
+     *
+     * @param geo 地理坐标（经纬度）
+     * @returns 世界坐标
+     */
+    geo2world(geo: Vector3): Vector3;
+    /**
+     * Map model coordinates converted to geo coordinates
+     * 地图模型坐标转换为地理坐标(与map2geo同功能)
+     * @param pos 模型坐标
+     * @returns 地理坐标（经纬度）
+     *  @deprecated This method is not recommended. Use map2geo() instead.
+     */
+    pos2geo(pos: Vector3): Vector3;
+    /**
+     * Map model coordinates converted to geo coordinates
+     * 地图模型坐标转换为地理坐标(与pos2geo同功能)
+     * @param map 模型坐标
+     * @returns 地理坐标（经纬度）
+     */
+    map2geo(pos: Vector3): Vector3;
+    /**
+     * World coordinates converted to geo coordinates
+     * 世界坐标转换为地理坐标
+     *
+     * @param world 世界坐标
+     * @returns 地理坐标（经纬度）
+     */
+    world2geo(world: Vector3): Vector3;
+    /**
+     * Get the ground infomation from latitude and longitude
+     * 获取指定经纬度的地面信息（法向量、高度等）
+     * @param geo 地理坐标
+     * @returns 地面信息
+     */
+    getLocalInfoFromGeo(geo: Vector3): LocationInfo | undefined;
+    /**
+     * Get loacation infomation from world position
+     * 获取指定世界坐标的地面信息
+     * @param pos 世界坐标
+     * @returns 地面信息
+     */
+    getLocalInfoFromWorld(pos: Vector3): LocationInfo | undefined;
+    /**
+     * Get loacation infomation from screen pointer
+     * 获取指定屏幕坐标的地面信息
+     * @param camera 摄像机
+     * @param pointer 点的屏幕坐标（-0.5~0.5）
+     * @returns 位置信息（经纬度、高度等）
+     */
+    getLocalInfoFromScreen(camera: Camera, pointer: Vector2): LocationInfo | undefined;
+    /**
+     * Get the number of currently downloading tiles
+     * 取得当前正在下载的瓦片数量
+     */
+    get downloading(): number;
+    getTileCount(): {
+        total: number;
+        visible: number;
+        leaf: number;
+        maxLevel: number;
+        downloading: number;
+    };
+}
+
+/**
+ * TileMap Event Map
+ * 地图事件
+ */
+/**
+ * Interface representing the event map for a TileMap.
+ * Extends the Object3DEventMap interface.
+ *
+ * @interface TileMapEventMap
+ *
+ * @property {BaseEvent} ready - Event triggered when the TileMap is ready.
+ * @property {BaseEvent & { delta: number }} update - Event triggered when the TileMap is updated.
+ *
+ * @property {BaseEvent & { tile: Tile }} "tile-created" - Event triggered when a tile is created.
+ * @property {BaseEvent & { tile: Tile }} "tile-loaded" - Event triggered when a tile is loaded.
+ *
+ * @property {BaseEvent & { projection: IProjection }} "projection-changed" -
+ *   Event triggered when the projection changes, with the new projection.
+ * @property {BaseEvent & { source: ISource | ISource[] | undefined }} "source-changed" -
+ *   Event triggered when the source changes, with the new source(s).
+ *
+ * @property {BaseEvent & { itemsLoaded: number; itemsTotal: number }} "loading-start" -
+ *   Event triggered when loading starts, with the number of items loaded and total items.
+ * @property {BaseEvent & { url: string }} "loading-error" -
+ *   Event triggered when there is a loading error, with the URL of the failed resource.
+ * @property {BaseEvent} "loading-complete" -
+ *   Event triggered when loading is complete.
+ * @property {BaseEvent & { url: string; itemsLoaded: number; itemsTotal: number }} "loading-progress" -
+ *   Event triggered during loading progress, with the URL, items loaded, and total items.
+ *
+ * @property {BaseEvent & { url: string }} "parsing-end" -
+ *   Event triggered when parsing ends, with the URL of the parsed resource.
+ */
+declare interface TileMapEventMap extends Object3DEventMap {
+    ready: BaseEvent;
+    update: BaseEvent & {
+        delta: number;
+    };
+    "tile-created": BaseEvent & {
+        tile: Tile;
+    };
+    "tile-loaded": BaseEvent & {
+        tile: Tile;
+    };
+    "tile-unload": BaseEvent & {
+        tile: Tile;
+    };
+    "projection-changed": BaseEvent & {
+        projection: IProjection;
+    };
+    "source-changed": BaseEvent & {
+        source: ISource | ISource[] | undefined;
+    };
+    "loading-start": BaseEvent & {
+        itemsLoaded: number;
+        itemsTotal: number;
+    };
+    "loading-error": BaseEvent & {
+        url: string;
+    };
+    "loading-complete": BaseEvent;
+    "loading-progress": BaseEvent & {
+        url: string;
+        itemsLoaded: number;
+        itemsTotal: number;
+    };
+    "parsing-end": BaseEvent & {
+        url: string;
+    };
+}
+
+/** 地图瓦片加载器 */
+declare class TileMapLoader extends TileLoader {
+    private _projection;
+    attcth(loader: ITileLoader, projection: IProjection): void;
+    load(params: TileLoadParamsType): Promise<MeshDateType>;
+}
+
+/**
+ * Type of map create parameters
+ * 地图创建参数
+ */
+declare type TileMapParams = {
+    loader?: ITileLoader;
+    rootTile?: Tile;
+    imgSource: ISource[] | ISource;
+    demSource?: ISource;
+    minLevel?: number;
+    maxLevel?: number;
+    lon0?: ProjectCenterLongitude;
+};
+
+/**
+ *  Base class for data sources, users can customize data sources by inheriting this class
+ */
+declare class TileSource implements ISource {
+    /** Data type that determines which loader to use for loading and processing data. Default is "image" type */
+    dataType: string;
+    /** Copyright attribution information for the data source, used for displaying map copyright notices */
+    attribution: string;
+    /** Minimum zoom level supported by the data source. Default is 0 */
+    minLevel: number;
+    /** Maximum zoom level supported by the data source. Default is 18 */
+    maxLevel: number;
+    /** Data projection type. Default is "3857" Mercator projection */
+    projectionID: ProjectionType;
+    /** URL template for tile data. Uses variables like {x},{y},{z} to construct tile request URLs */
+    url: string;
+    /** List of URL subdomains for load balancing. Can be an array of strings or a single string */
+    subdomains: string[] | string;
+    /** Currently used subdomain. Randomly selected from subdomains when requesting tiles */
+    s: string;
+    /** Layer opacity. Range 0-1, default is 1.0 (completely opaque) */
+    opacity: number;
+    /** Whether to use TMS tile coordinate system. Default false uses XYZ system, true uses TMS system */
+    isTMS: boolean;
+    /** Data bounds in format [minLon, minLat, maxLon, maxLat]. Default covers global range excluding polar regions */
+    bounds: [number, number, number, number];
+    /** Projected data bounds */
+    _projectionBounds: [number, number, number, number];
+    /** Any data */
+    [key: string]: unknown;
+    /**
+     * constructor
+     * @param options SourceOptions
+     */
+    constructor(options?: SourceOptions);
+    /**
+     * Get url from tile coordinate, public, overwrite to custom generation tile url from xyz
+     * @param x tile x coordinate
+     * @param y tile y coordinate
+     * @param z tile z coordinate
+     * @returns url tile url
+     */
+    getUrl(x: number, y: number, z: number): string | undefined;
+    /**
+     * Get url from tile coordinate, public，called by TileLoader
+     * @param x tile x coordinate
+     * @param y tile y coordinate
+     * @param z tile z coordinate
+     * @returns url tile url
+     */
+    _getUrl(x: number, y: number, z: number): string | undefined;
+    /**
+     * Create source directly through factoy functions.
+     * @param options source options
+     * @returns ISource data source instance
+     */
+    static create(options: SourceOptions): TileSource;
+}
+
+/**
+ * Tile update parameters
+ */
+declare type TileUpdateParames = {
+    camera: Camera;
+    loader: ITileLoader;
+    minLevel: number;
+    maxLevel: number;
+    LODThreshold: number;
+};
+
+/**
+ * Tile event map
+ */
+declare interface TTileEventMap extends Object3DEventMap {
+    unload: BaseEvent;
+    ready: BaseEvent;
+    "tile-created": BaseEvent & {
+        tile: Tile;
+    };
+    "tile-loaded": BaseEvent & {
+        tile: Tile;
+    };
+    "tile-unload": BaseEvent & {
+        tile: Tile;
+    };
+}
+
+/**
+ * Threejs scene initialize class
+ */
+export declare class Viewer extends EventDispatcher<ViewerEventMap> {
+    readonly scene: Scene;
+    readonly renderer: WebGLRenderer;
+    readonly camera: PerspectiveCamera;
+    readonly controls: MapControls;
+    readonly ambLight: AmbientLight;
+    readonly dirLight: DirectionalLight;
+    clouds: Clouds | null;
+    container?: HTMLElement;
+    private readonly _clock;
+    private stats;
+    private _animationCallbacks;
+    private _fogFactor;
+    /** Get fog factor */
+    get fogFactor(): number;
+    /** Set fog factor, default 1 */
+    set fogFactor(value: number);
+    /** Container width */
+    get width(): number;
+    /** Container height */
+    get height(): number;
+    /**
+     * Constructor
+     * @param container container element or selector string
+     * @param options GLViewer options
+     */
+    constructor(container?: HTMLElement | string, options?: ViewerOptions);
+    /**
+     * Add the renderer to a container
+     * @param container container element or selector string
+     * @returns this
+     */
+    addTo(container: HTMLElement | string): this;
+    /**
+     * Create scene
+     * @param skyboxConfig Skybox configuration
+     * @returns scene
+     */
+    private _createScene;
+    private _loadHDRWithPMREM;
+    /**
+     * Create WebGL renderer
+     * @param antialias
+     * @param stencil
+     * @param logarithmicDepthBuffer
+     * @returns renderer
+     */
+    private _createRenderer;
+    /**
+     * Create camera
+     * @returns camera
+     */
+    private _createCamera;
+    /**
+     * Create map controls
+     * @returns MapControls
+     */
+    private _createControls;
+    /**
+     * Create ambient light
+     * @returns AmbientLight
+     */
+    private _createAmbLight;
+    /**
+     * Create directional light
+     * @returns DirectionalLight
+     */
+    private _createDirLight;
+    /**
+     * Container resize
+     * @returns this
+     */
+    resize(): this;
+    /**
+     * 添加动画循环回调
+     * @param callback 回调函数，接收deltaTime参数
+     * @returns 用于移除回调的函数
+     */
+    addAnimationCallback(callback: (delta: number, elapsedtime: number) => void): () => void;
+    /**
+     * Threejs animation loop
+     */
+    private animate;
+    /**
+     * Fly to a position
+     * @param centerPostion Map center target position (world coordinate)
+     * @param cameraPostion Camera target position (world coordinate)
+     * @param animate animate or not
+     */
+    flyTo(centerPostion: Vector3, cameraPostion: Vector3, animate?: boolean, onComplete?: (obj: Vector3) => void): void;
+    /**
+     * Get current scens state
+     * @returns center position and camera position
+     */
+    getState(): {
+        centerPosition: Vector3;
+        cameraPosition: Vector3;
+    };
+}
+
+/**
+ * Viewer event map
+ */
+export declare interface ViewerEventMap extends Object3DEventMap {
+    update: BaseEvent & {
+        delta: number;
+    };
+}
+
+/**
+ * Viewer options
+ */
+export declare type ViewerOptions = {
+    /** Whether to use antialiasing. Default is false. */
+    antialias?: boolean;
+    /** Whether to use stencil buffer. Default is true. */
+    stencil?: boolean;
+    /** Whether to use logarithmic depth buffer. Default is true. */
+    logarithmicDepthBuffer?: boolean;
+    /** Skybox configuration */
+    skybox?: {
+        /** ​ Path to skybox images */
+        path?: string;
+        hdr?: string;
+        /**
+         * Skybox image file names in order: [px, nx, py, ny, pz, nz]
+         */
+        files?: string[];
+        /** Default skybox color (used if skybox loading fails)  */
+        defaultColor?: number;
+        hdrEquirectangular?: boolean;
+        hdrExposure?: number;
+        hdrEncoding?: number;
+    };
+    debug?: boolean;
+};
+
+declare type WaterStyle = BaseWaterStyle | LightWaterStyle;
+
+export declare class WMTSSource extends TileSource {
+    minLevel: number;
+    maxLevel: number;
+    constructor(options: WMTSSourceOptions);
+    /**
+     * 直接使用用户提供的URL模板
+     * 支持以下变量替换（自动转换坐标系）：
+     * - {x}, {y}, {z}
+     * - {tileMatrix}, {tileRow}, {tileCol}
+     */
+    getUrl(x: number, y: number, z: number): string;
+}
+
+export declare type WMTSSourceOptions = SourceOptions & {
+    /** 完整的WMTS请求URL模板（必须包含{x}{y}{z}或等效参数） */
+    urlTemplate: string;
+    /** 是否使用TMS坐标轴朝向（Y轴反向） */
+    isTMS?: boolean;
+};
+
+export { }