@aibee/owlly 1.0.26 → 1.0.29

package/lib/prod/src/owlly/utils/bvh-tree.d.ts

@@ -0,0 +1,105 @@
+/**
+ * bvh-tree
+ * A Bounding Volume Hierarchy data structure implementation.
+ * https://github.com/benraziel/bvh-tree
+ *
+ * 该文件是外部引入的类, 用于创建 FloorModel 的 BVH 树
+ *
+ * @author Ben Raziel
+  * @ignore
+ */
+import { NS_THREE } from '../stage/externals';
+interface IntersectResult {
+    triangle?: NS_THREE.Vector3[];
+    triangleIndex?: number;
+    intersectionPoint: NS_THREE.Vector3;
+}
+/**
+ * A node in the [[BVHTree]] structure
+ *
+ */
+declare class BVHNode {
+    extentsMin: NS_THREE.Vector3;
+    extentsMax: NS_THREE.Vector3;
+    startIndex: number;
+    endIndex: number;
+    level: number;
+    node0: BVHNode | null;
+    node1: BVHNode | null;
+    /**
+      * Constructor of BVHNode
+      * @param {Point} extentsMin the min coords of this node's bounding box ({x,y,z})
+      * @param {Point} extentsMax the max coords of this node's bounding box ({x,y,z})
+      * @param {number} startIndex an index in the bbox array, where the first element of this node is located
+      * @param {number} endIndex an index in the bbox array, where the last of this node is located,
+      * plus 1 (meaning that its non-inclusive).
+      * @param {number} the distance of this node from the root for the bvh tree. root node has level=0,
+      * its children have level=1 etc.
+      */
+    constructor(extentsMin: NS_THREE.Vector3, extentsMax: NS_THREE.Vector3, startIndex: number, endIndex: number, level: number);
+    elementCount(): number;
+    centerX(): number;
+    centerY(): number;
+    centerZ(): number;
+    clearShapes(): void;
+    calcBoundingSphereRadius(extentsMin: NS_THREE.Vector3, extentsMax: NS_THREE.Vector3): number;
+}
+/**
+ * BVH树
+ */
+declare class BVHTree {
+    private static EPSILON;
+    private trianglesArray;
+    private maxTrianglesPerNode;
+    private bboxArray;
+    private bboxHelper;
+    private rootNode;
+    private nodesToSplit;
+    /**
+     * 创建BVH树对象
+     * @param {Vector3[][]} triangles 三角形数组，BVH树基于此构建
+     * @param {number} maxTrianglesPerNode 每个树结点包含的最多三角形数量
+     */
+    constructor(triangles: NS_THREE.Vector3[][], maxTrianglesPerNode: number);
+    private vector3SetFromArray;
+    /**
+     * Returns a list of all the triangles in the BVH which interected a specific node.
+     * We use the BVH node structure to first cull out nodes which do not intereset the ray.
+     * For rays that did intersect, we test intersection of the ray with each triangle
+     * @param {Vector3} rayOrigin the origin position of the ray.
+     * @param {Vector3} rayDirection the direction vector of the ray.
+     * @param {boolean} backfaceCulling if 'true', only intersections with front-faces of the mesh will be performed.
+     * @return {{}[]} IntersectionResult an array of intersection result, one for each triangle which intersected the BVH，
+     * each item in the form of:
+     * {
+     *  triangle: Vector3[];
+     *  triangleIndex: number;
+     *  intersectionPoint: Vector3;
+     * }
+    */
+    intersectRay(rayOrigin: NS_THREE.Vector3, rayDirection: NS_THREE.Vector3, backfaceCulling?: boolean): IntersectResult[];
+    /**
+     * 获得与指定射线方向相交的最接近射线起点的相交结果
+     * @param rayOrigin 射线起点
+     * @param rayDirection 射线方向
+     * @param backfaceCulling 可选，是否忽略背面
+     */
+    nearestIntersection(rayOrigin: NS_THREE.Vector3, rayDirection: NS_THREE.Vector3, backfaceCulling?: boolean): IntersectResult | null;
+    private calcBoundingBoxes;
+    private setBox;
+    private copyBox;
+    private calcExtents;
+    private splitNode;
+    private calcTValues;
+    private intersectNodeBox;
+    private intersectRayTriangle;
+    private static addTriangles;
+    /**
+    * 构建bvhtree
+    * @ignore
+    * @param {Object3D} threeObj 需要创建BVH树的Object3D根对象
+    * @returns {BVHTree}
+    */
+    static createBVHTree(threeObj: NS_THREE.Object3D): BVHTree;
+}
+export { BVHTree, BVHNode, IntersectResult };

package/lib/prod/src/owlly/utils/camera.d.ts

@@ -0,0 +1,37 @@
+import { NS_THREE } from '../stage/externals';
+import { Camera as CameraElement } from '../element/camera';
+/**
+ * 相机相关的工具, 提供各类相机的工具函数
+ */
+declare class Camera {
+    /**
+     * 根据 Spherical Coordinate 确定 lookAt 坐标
+     * @param param0 相机坐标
+     * @param yaw 相机当前 yaw
+     * @param pitch 相机当前 pitch
+     * @returns 看向的方向与俯瞰时与 X 轴的夹角
+     */
+    static getCameraLookAtPositionByYawPitch({ x, y, z }: {
+        x: number;
+        y: number;
+        z: number;
+    }, yaw: number, pitch: number): {
+        position: NS_THREE.Vector3;
+        degree: number;
+    };
+    /**
+     * 根据 yaw pitch 设置相机的朝向
+     * @param camera 相机元素
+     */
+    static setCameraLookAtByYawPitch(camera: CameraElement): void;
+    /**
+     * 根据相机朝向获取 yaw pitch
+     * @param v 方向向量
+     * @returns yaw 与 pitch
+     */
+    static getYawPitchFromCameraLookVector(v: NS_THREE.Vector3): {
+        yaw: number;
+        pitch: number;
+    };
+}
+export { Camera };

package/lib/prod/src/owlly/utils/cube-texture-cache.d.ts

@@ -0,0 +1,25 @@
+import { NS_THREE } from '../stage/externals';
+declare class CubeTextureCache {
+    private cubeTextureCache;
+    private workingTasks;
+    static sharedInstance: CubeTextureCache;
+    static disposeAll(): void;
+    dispose(): void;
+    constructor(capacity: number);
+    /**
+     * @ignore
+     * 获取立方体贴图，先从缓存中获取，若未命中则异步加载立方体贴图
+     * @param cubeTextureURLs 立方体贴图六个面的图像URL数组
+     */
+    loadCubeTexture(cubeTextureURLs: string[], cacheAnyway?: boolean, recycleIntermediateTextures?: boolean): Promise<NS_THREE.CubeTexture>;
+    /**
+     * 获取一组立方体贴图，若没命中则异步加载
+     * @param textureURLsArray 需要获取的立方体贴图URL数组，其每个元素是一个6元素的数组，表示一个立方体贴图的六个面
+     * @param waitForReadyCount 指定函数必须在textureURLsArray中的前多少个立方体贴图获取到以后才能返回
+     * 比如在即将显示一个全景点时，指定必须等指定全景点的立方体贴图获取到后才能返回，而其周围全景点可以同时预加载但不用等
+     */
+    preloadCubeTextures(textureURLsArray: (string[] | undefined)[], waitForReadyCount: number, recycleIntermediateTextures?: boolean[]): Promise<NS_THREE.CubeTexture[]>;
+    recycleCubeTexture(cubeTextureURLs: string[]): void;
+    getCapacity(): number;
+}
+export { CubeTextureCache };

package/lib/prod/src/owlly/utils/device-utils.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 设备信息工具类
+ */
+declare class DeviceUtils {
+    static GetVersion(match: RegExp, token: string): {
+        major: number;
+        minor: number;
+        patch: number;
+    };
+    static DetectWeChat(): boolean;
+    static DetectIOS(): boolean;
+    static DetectIPad(): boolean;
+    static DetectIPod(): boolean;
+    static DetectIPhone(): boolean;
+    static DetectAndroid(): boolean;
+    static DetectAndroidMobile(): boolean;
+}
+export { DeviceUtils };

package/lib/prod/src/owlly/utils/environment-utils.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 环境值
+ */
+declare enum Env {
+    /** 浏览器 */
+    Web = 0,
+    /** 小程序 */
+    Miniapp = 1
+}
+/**
+ * 环境信息工具类
+ */
+declare class EnvironmentUtils {
+    private static ENV;
+    private static DPR;
+    /**
+     * 设置运行环境(浏览器或小程序)
+     * @param env 环境值
+     */
+    static SetEnv(env: Env): void;
+    /**
+     * 获得运行环境
+     * @returns 环境值
+     */
+    static GetEnv(): Env;
+    /**
+     * 设置全局 dpr
+     * @param dpr 设备像素密度倍数
+     */
+    static SetGlobalDPR(dpr: number): void;
+    /**
+     * 获取全局 dpr
+     * @returns 设备像素密度倍数
+     */
+    static GetGlobalDPR(): number;
+}
+export { Env, EnvironmentUtils };

package/lib/prod/src/owlly/utils/event-hub.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 事件管理器
+ */
+declare class EventHub {
+    private static hub;
+    private eventMap;
+    constructor();
+    private on;
+    private emit;
+    private off;
+    /**
+     * 注册事件监听
+     * @param event 事件名
+     * @param callback 回调函数
+     */
+    static on(event: string, callback: Function): void;
+    /** @ignore */
+    static emit(event: string, ...args: unknown[]): void;
+    /**
+     * 注销事件监听
+     * @param event 事件名
+     * @param callback 回调函数
+     */
+    static off(event: string, callback: Function): void;
+    /**
+     * @deprecated
+     * 注销事件监听, 请使用EventHub.off代替
+     * @param event 事件名
+     * @param callback 回调函数
+     */
+    static remove(event: string, callback: Function): void;
+}
+declare class EventHubClassic {
+    protected eventMap: Map<string, Set<Function>>;
+    constructor();
+    /**
+     * 注册事件监听
+     * @param event 事件名
+     * @param callback 回调函数
+     */
+    on(event: string, callback: Function): void;
+    protected emit(event: string, ...args: unknown[]): void;
+    /**
+     * 注销事件监听
+     * @param event 事件名
+     * @param callback 回调函数
+     */
+    off(event: string, callback: Function): void;
+}
+export { EventHub, EventHubClassic };

package/lib/prod/src/owlly/utils/events.d.ts

@@ -0,0 +1,219 @@
+declare class Events {
+    /**
+     * @event element-selected 元素选中事件, 由 TransformController 抛出
+     * @eventParam element 被选中的元素对象
+     * @eventParam intersection 碰撞信息
+     * @eventParam button 鼠标按键
+     */
+    static ELEMENT_SELECTED: string;
+    /**
+     * @event element-position-updated 元素位置更新, 由 TransformController 抛出
+     * @eventParam position 元素的位置
+     * @eventParam element 元素对象
+     * @eventParam uuid 若元素为相机, 相机的UUID, 否则为空
+     */
+    static ELEMENT_POSITION_UPDATED: string;
+    /**
+     * @event element-pose-updated 元素姿态更新, 由 TransformController 抛出
+     * @eventParam quaternion 元素的姿态四元数(x, y, z, w)
+     * @eventParam element 元素对象
+     * @eventParam uuid 若元素为相机, 相机的UUID, 否则为空
+     */
+    static ELEMENT_POSE_UPDATED: string;
+    /**
+     * @event camera-changed 相机位移/朝向发生变化, 由 PanoramaController 抛出
+     * @eventParam position 相机位置
+     * @eventParam quaternion 相机的姿态四元数（x, y, z, w）
+     * @eventParam controller 产生事件的controller
+     */
+    static CAMERA_CHANGED: string;
+    /**
+     * @event camera-zoom 相机位移/朝向发生变化, 由 PanoramaController 抛出
+     * @eventParam typeMode 缩放模式
+     * @eventParam value 缩放值
+     * @eventParam controller 产生事件的controller
+     */
+    static CAMERA_ZOOM: string;
+    /**
+     * @event panorama-camera-changed 全景图相机位移/朝向发生变化, 由 PanoramaController 抛出
+     * @eventParam position 相机位置
+     * @eventParam quaternion 相机的姿态四元数（x, y, z, w）
+     * @eventParam controller 产生事件的controller
+     */
+    static PANORAMA_CAMERA_CHANGED: string;
+    /**
+     * @event orbit-camera-changed ORBIT相机位移/朝向发生变化, 由 OrbitControl 抛出
+     * @eventParam position 相机位置
+     * @eventParam quaternion 相机的姿态四元数（x, y, z, w）
+     * @eventParam controller 产生事件的controller
+     */
+    static ORBIT_CAMERA_CHANGED: string;
+    /**
+     * @event panorama-presented 全景图被显示出来, 由 PanoramaGroup、TilePanoramaGroup 抛出
+     * @eventParam pid 全景点ID
+     */
+    static PANORAMA_PRESENTED: string;
+    /**
+     * @event panorama-selected 全景图被选中, 由 PanoramaGroup、TilePanoramaGroup 抛出
+     * @eventParam pid 全景点ID
+     */
+    static PANORAMA_SELECTED: string;
+    /**
+     * @event panorama-hover 全景目标点hover, 由 PanoramaGroup、TilePanoramaGroup 抛出
+     * @eventParam pid 全景点ID
+     * @eventParam indicatorPosition 点位位置
+     */
+    static PANORAMA_HOVER: string;
+    /**
+     * @event element-loaded Element读取完成, 由 FloorModel、BlockSet 抛出
+     * @eventParam element{Element} 读取完成的Element
+     */
+    static ELEMENT_LOADED: string;
+    /**
+     * @event element-loaded-error Element读取错误
+     * @eventParam element{Element} 读取错误的Element
+     */
+    static ELEMENT_LOADED_ERROR: string;
+    /**
+     * @event click-panorama 点击到全景图
+     * @eventParam pid 全景点ID
+     */
+    static CLICK_PANORAMA: string;
+    /**
+     * @event move-to-panorama 漫游到全景图, 由 PanoramaController、TilePanoramaController 抛出
+     * @eventParam pid 全景点ID
+     */
+    static MOVE_TO_PANORAMA: string;
+    /**
+     * @event will-move-to-panorama 漫游到全景图, 由 PanoramaController、TilePanoramaController 抛出
+     * @eventParam pid 全景点ID
+     */
+    static WILL_MOVE_TO_PANORAMA: string;
+    /**
+     * @event path-movement-start 走完一条路径, 由 PanoramaController、TilePanoramaController 抛出
+     * @eventParam PIDs []number 路径的全景点ID数组
+     */
+    static PATH_MOVEMENT_START: string;
+    /**
+     * @event path-movement-completed 走完一条路径, 由 PanoramaController、TilePanoramaController 抛出
+     * @eventParam PIDs []number 路径的全景点ID数组
+     */
+    static PATH_MOVEMENT_COMPLETED: string;
+    /**
+     * @event will-load-panorama 即将加载全景图资源, 由 Panorama、TilePanoramaController 抛出
+     * @eventParam pid 全景点ID
+     */
+    static WILL_LOAD_PANORAMA: string;
+    /**
+     * @event did-load-panorama 完成加载全景图资源, 由 Panorama、TilePanorama、TilePanoramaController 抛出
+     * @eventParam pid 全景点ID
+     */
+    static DID_LOAD_PANORAMA: string;
+    /**
+     * @event transform-activated 开始移动元素, 由 TransformController 抛出
+     */
+    static TRANSFORM_ACTIVATED: string;
+    /**
+     * @event transform-deactivated 结束移动元素, 由 TransformController 抛出
+     */
+    static TRANSFORM_DEACTIVATED: string;
+    /**
+     * @event fps-updated 计算得到当前帧率, 暂无
+     */
+    static FPS_UPDATED: string;
+    /**
+     * @event get-plane-intersect 元素姿态更新, 由 PlaneController 抛出
+     * @eventParam event touch事件 event
+     * @eventParam position 与平面相交的点(x, y, z)
+     */
+    static GET_PLANE_INTERSECT: string;
+    /**
+     * @event poi-clicked poi点击事件, 由 PoiOverlay 抛出
+     * @eventParam poi 点击的poi对象
+     */
+    static POI_CLICKED: string;
+    /**
+     * @event poi-down poi鼠标按下, 由 PoiOverlay 抛出
+     * @eventParam poi 点击的poi对象
+     */
+    static POI_DOWN: string;
+    /**
+     * @event poi-up poi鼠标抬起, 由 PoiOverlay 抛出
+     * @eventParam poi 点击的poi对象
+     */
+    static POI_UP: string;
+    /**
+     * @event canvas-vertex-clicked canvas-vertex点击事件, 由 CanvasOverlay 抛出
+     * @eventParam canvas-vertex 点击的canvas-vertex对象
+     */
+    static CANVAS_VERTEX_CLICKED: string;
+    /**
+     * @event canvas-vertex-down canvas-vertex鼠标按下, 由 CanvasOverlay 抛出
+     * @eventParam canvas-vertex 点击的canvas-vertex对象
+     */
+    static CANVAS_VERTEX_DOWN: string;
+    /**
+     * @event canvas-vertex-up canvas-vertex鼠标抬起, 由 CanvasOverlay 抛出
+     * @eventParam canvas-vertex 点击的canvas-vertex对象
+     */
+    static CANVAS_VERTEX_UP: string;
+    /**
+     * @event label-icons-position-updated LabelOverlay - Icon位置更新, 由 LabelOverlay 抛出
+     * @eventParam elements Icon元素数组
+     */
+    static LABEL_ICONS_POSITION_UPDATED: string;
+    /**
+     * @event label-down 标签鼠标按下, 由 DomLabel2D 抛出
+     * @eventParam label 点击的label
+     */
+    static LABEL_DOWN: string;
+    /**
+     * @event tick 帧渲染, 由 EventHub 抛出
+     */
+    static TICK: string;
+    /**
+     * @event view-rendered 视图渲染完毕, 暂无
+     * @eventParam view 对应的视图
+     */
+    static VIEW_RENDERED: string;
+}
+/** @ignore */
+declare class OwllyEvents {
+    /**
+     * @event o/element-selected 元素被选中
+     * @eventParam element 被选中的元素
+     */
+    static ELEMENT_SELECTED: string;
+    /**
+     * @event o/rendering-view-changed 当前渲染目标View改变
+     * @eventParam view 正在渲染的View
+     */
+    static RENDERING_VIEW_CHANGED: string;
+    /**
+     * @event o/dispose-element 有Element销毁时发生
+     * @eventParam element{Element|Element[]} 销毁的Element
+     */
+    static DISPOSE_ELEMENT: string;
+    /**
+     * @event o/element-loaded Element读取完成
+     * @eventParam element{Element} 读取完成的Element
+     */
+    static ELEMENT_LOADED: string;
+    /**
+     * @event element-position-updated 元素位置更新
+     * @eventParam position 元素的位置
+     * @eventParam element 元素对象
+     * @eventParam view 变动位置所在View
+     */
+    static ELEMENT_POSITION_UPDATED: string;
+    static MOUSE_DOWN: string;
+    static MOUSE_UP: string;
+    static MOUSE_MOVE: string;
+    static MOUSE_WHEEL: string;
+    static TOUCH_START: string;
+    static TOUCH_MOVE: string;
+    static TOUCH_END: string;
+    static CONTEXT_MENU: string;
+    static DBLCLICK: string;
+}
+export { Events, OwllyEvents };

package/lib/prod/src/owlly/utils/geometry-utils.d.ts

@@ -0,0 +1,119 @@
+import { NS_THREE } from '../stage/externals';
+interface Cell {
+    x: number;
+    y: number;
+    h: number;
+    d: number;
+    max: number;
+}
+declare type Pair = [number, number];
+declare type Ring = Pair[];
+declare type Polygon = Ring[];
+declare type MultiPolygon = Polygon[];
+declare type Geom = Polygon | MultiPolygon;
+/**
+ * 图形相关的工具函数
+ * @ignore
+ */
+declare class GeometryUtils {
+    static Epsilon: number;
+    /**
+     * 计算环多边形面积
+     * @param polygon 二维顶点数组
+     * 借鉴area-polygon的实现
+     */
+    static RingPolygonArea(points: [number, number][], signed: boolean): number;
+    /**
+       * 求多边形质心
+       * https://jingsam.github.io/2016/10/05/centroid.html
+       * @param polygon 按逆时针排列的二维顶点数组
+       */
+    static Centroid(polygon: [number, number][]): [number, number];
+    /**
+       * 求点到线段的距离
+       * https://jingsam.github.io/2016/09/26/polydist.html
+       * @param p 求到线段距离的点
+       * @param a 线段端点1
+       * @param b 线段端点2
+       */
+    static PointToSegmentDistance(p: [number, number], a: [number, number], b: [number, number]): number;
+    /**
+       * 判断点是否在多边形内部
+       * @param p 二维点
+       * @param polygonLoops 二维多边形顶点环数组，至少有一个环，第二个及以后的环代表内部孔
+       */
+    static PointInPolygon(p: [number, number], polygonLoops: [number, number][][]): boolean;
+    /**
+       * 不考虑点是否在多边形内部，求最小距离
+       * https://jingsam.github.io/2016/09/26/polydist.html
+       * @param p 二维点
+       * @param polygonLoops 二维多边形顶点环数组，至少有一个环，第二个及以后的环代表内部孔
+       */
+    static MinDistanceFromPointToPolygon(p: [number, number], polygonLoops: [number, number][][]): number;
+    /**
+       * 考虑点是否在多边形内部，求最小距离。若在多边形外部，距离为负值
+       * https://jingsam.github.io/2016/09/26/polydist.html
+       * @param p 二维点
+       * @param polygonLoops 二维多边形顶点环数组，至少有一个环，第二个及以后的环代表内部孔
+       */
+    static PointDistanceToPolygon(p: [number, number], polygonLoops: [number, number][][]): number;
+    static CellOfPolygon(x: number, y: number, h: number, polygon: [number, number][][]): Cell;
+    /**
+       * 得到多边形标注中心
+       * https://jingsam.github.io/2016/09/26/polylabel2.html
+       * @param polygonLoops 多边形
+       */
+    static CentroidForPOI(polygonLoops: [number, number][][]): [number, number];
+    static LinePlaneIntersection(lineP0: NS_THREE.Vector3, lineP1: NS_THREE.Vector3, planeP: NS_THREE.Vector3, planeNormal: NS_THREE.Vector3): NS_THREE.Vector3;
+    static SegmentPlaneIntersection(lineP0: NS_THREE.Vector3, lineP1: NS_THREE.Vector3, planeP: NS_THREE.Vector3, planeNormal: NS_THREE.Vector3): NS_THREE.Vector3 | undefined;
+    static MapPointOnPlane(v: NS_THREE.Vector3, planeP: NS_THREE.Vector3, planeNormal: NS_THREE.Vector3): NS_THREE.Vector3;
+    static ParameterToPlane(a: number, b: number, c: number, d: number): {
+        normal: NS_THREE.Vector3;
+        constant: number;
+    };
+    static PlaneCutMeshPolygon(p: NS_THREE.Vector3, n: NS_THREE.Vector3, meshVertices: NS_THREE.Vector3[], meshTriangles: number[]): {
+        vertices: NS_THREE.Vector3[];
+        holeIndices: number[];
+        vertices2D: [number, number][];
+    };
+    static TriangulatePolygon2D(vertices: [number, number][], holeIndices: number[]): number[];
+    static TriangulatePolygonLoops2D(polygonLoops: [number, number][][]): {
+        vertices: [number, number][];
+        triangles: number[];
+    };
+    static LookAtMatrix(eye: NS_THREE.Vector3, target: NS_THREE.Vector3, up: NS_THREE.Vector3): NS_THREE.Matrix4;
+    static FrustumMesh(eye: NS_THREE.Vector3, target: NS_THREE.Vector3, up: NS_THREE.Vector3, fovYDegrees: number, aspectRatio: number, near: number, far: number): {
+        vertices: NS_THREE.Vector3[];
+        triangles: number[];
+    };
+    static PolygonIntersection(geom: Geom, ...geoms: Geom[]): MultiPolygon;
+    static PolygonDiff(geom: Geom, ...geoms: Geom[]): MultiPolygon;
+    static PolygonUnion(geom: Geom, ...geoms: Geom[]): MultiPolygon;
+    static PolygonXOR(geom: Geom, ...geoms: Geom[]): MultiPolygon;
+    /**
+     * 计算路径每个路径点与初始点在路径上的距离
+     * @param pathPoints 路径点数组
+     * @returns 距离数组
+     */
+    static GetPathDistances(pathPoints: [number, number][] | [number, number, number][]): number[];
+    /**
+     * 获取路径上某个距离上的点
+     * @param path 路径
+     * @param distances 距离数组
+     * @param targetDistance 目标距离
+     */
+    static GetPointOnDistance(path: [number, number][] | [number, number, number][], distances: number[], targetDistance: number): [number, number] | [number, number, number];
+    /**
+     * 获取路径上距离某位置最近的点
+     * @param position 目标点
+     * @param path 路径
+     * @param distances 距离数组
+     * @param targetPrecision 计算精度, 默认为0.1
+     * @param stepLength 搜索步长距离, 默认为8
+     */
+    static GetNearestPoint(position: [number, number] | [number, number, number], path: [number, number][] | [number, number, number][], distances: number[], targetPrecision?: number, stepLength?: number): {
+        point: [number, number] | [number, number, number];
+        distance: number;
+    };
+}
+export { GeometryUtils, };

package/lib/prod/src/owlly/utils/helper.d.ts

@@ -0,0 +1,6 @@
+import { Line, AxesHelper } from 'three';
+declare class Helper {
+    static createLine(points: [number, number, number][], color?: string, order?: number): Line;
+    static createAxes(position: [number, number, number], size?: number, order?: number): AxesHelper;
+}
+export { Helper };

package/lib/prod/src/owlly/utils/index.d.ts

@@ -0,0 +1,13 @@
+export * from './map-utils';
+export * from './event-hub';
+export * from './events';
+export * from './bvh-tree';
+export * from './alignment-utils';
+export * from './geometry-utils';
+export * from './device-utils';
+export * from './environment-utils';
+export * from './basic-tools';
+export * from './path-utils';
+export * from './basic-calc';
+export * from './helper';
+export * from './tile-util';

package/lib/prod/src/owlly/utils/lru-cache.d.ts

@@ -0,0 +1,26 @@
+declare class LruCache<T> {
+    private values;
+    private capacity;
+    private totalCost;
+    private costCallback?;
+    constructor(capacity: number, costCallback?: (value: T) => number);
+    get(key: string, missedCallback?: {
+        (key: string): T | undefined;
+    }): T | undefined;
+    /**
+     *
+     * @param key
+     * @param value
+     * @param evictCallback
+     * @param abortIfFull
+     * @returns If some other item is evicted
+     */
+    put(key: string, value: T, evictCallback?: {
+        (key: string, value: T): void;
+    }, abortIfFull?: boolean | undefined): boolean;
+    recycle(key: string, disposeCallback?: (key: string, value: T) => void): boolean;
+    clear(disposeCallback: (key: string, value: T) => void): void;
+    getCapacity(): number;
+    getTotalCost(): number;
+}
+export { LruCache };

package/lib/prod/src/owlly/utils/map-utils.d.ts

@@ -0,0 +1,7 @@
+import { NS_THREE } from '../stage/externals';
+import { PathStep } from '../element/map-kit/shape';
+/** Block 专用类, 仅用于通过 Shape 生成 THREE 可用的路径格式 @ignore */
+declare class MapUtils {
+    static GenerateShapeFromSteps(steps: PathStep[]): NS_THREE.Shape;
+}
+export { MapUtils };

package/lib/prod/src/owlly/utils/number-utils.d.ts

@@ -0,0 +1,8 @@
+declare class NumberUtils {
+    static mergeRange(ranges: [number, number][], tolerance?: number): [number, number][];
+    static rangeSub(range: [number, number], subRanges: [number, number][], tolerance?: number): [number, number][];
+    static nearlyEquals(a: number, b: number, tolerance?: number): boolean;
+    static nearlyLess(a: number, b: number, include: boolean, tolerance?: number): boolean;
+    static nearlyThan(a: number, b: number, include: boolean, tolerance?: number): boolean;
+}
+export { NumberUtils };